diff --git a/doc/LectureNotes/Clustering.ipynb b/doc/LectureNotes/Clustering.ipynb deleted file mode 100644 index 54e5f1cf2..000000000 --- a/doc/LectureNotes/Clustering.ipynb +++ /dev/null @@ -1,908 +0,0 @@ -{ - "cells": [ - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "# Clustering Analysis\n", - "In this chapter we will concern ourselves with the study of **cluster analysis**.\n", - "In general terms cluster analysis, or clustering, is the task of grouping a\n", - "data-set into different distinct categories based on some measure of equality of\n", - "the data. This measure is often referred to as a **metric** or **similarity\n", - "measure** in the literature (note: sometimes we deal with a **dissimilarity\n", - "measure** instead). Usually, these metrics are formulated as some kind of\n", - "distance function between points in a high-dimensional space.\n", - "\n", - "There exists a lot of such distance measures. The simplest, and also the most\n", - "common is the **Euclidean distance** (i.e. Pythagoras). A good source for those of\n", - "you wanting a thorough overview is the article (DOI:10.5120/ijca2016907841\n", - "Irani, Pise, Phatak). A few other metrics mentioned there are: *cosine\n", - "similarity*, *Manhattan distance*, *Chebychev distance* and the *Minkowski\n", - "distance*. The Minkowski distance is a general formulation which encapsulates a\n", - "range of metrics. All of these, and many more, can be used in clustering. There\n", - "exists different categories of clustering algorithms. A few of the most\n", - "common are: *centroid-*, *distribution-*, *density-* and *hierarchical-\n", - "clustering*. We will concern ourselves primarily with the first one." - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Basic Idea of the K-means Clustering Algorithm\n", - "The simplest of all clustering algorithms is the aptly named **k-means algorithm**\n", - ", sometimes also referred to as *Lloyds algorithm*. It is the simplest and also\n", - "the most common. From its simplicity it obtains both strengths and weaknesses.\n", - "These will be discussed in more detail later. The k-means algorithm is a\n", - "**centroid based** clustering algorithm.\n", - "\n", - "Assume, we are given $n$ data points and we wish to split the data into $K < n$\n", - "different categories, or clusters. We label each cluster by an integer $k\\in\\{\n", - "1, \\cdots, K \\}$. In the basic k-means algorithm each point is assigned to only\n", - "one cluster $k$, and these assignments are *non-injective* i.e. many-to-one. We\n", - "can think of these mappings as an encoder $k = C(i)$, which assigns the $i$-th\n", - "data-point $\\bf x_i$ to the $k$-th cluster. Before we jump into the mathematics\n", - "let us describe the k-means algorithm in words:\n", - "1. We start with guesses / random initializations of our $k$ cluster centers / centroids\n", - "\n", - "2. For each centroid the points that are most similar are identified\n", - "\n", - "3. Then we move / replace each centroid with a coordinate average of all the points that were assigned to that centroid.\n", - "\n", - "4. Iterate this points 2, 3) until the centroids no longer move (to some tolerance)\n", - "\n", - "Now we consider the method formally. Again, we assume we have $n$ data-points\n", - "(vectors)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\\label{eq:kmeanspoints} \\tag{1}\n", - " \\boldsymbol{x_i} = \\{x_{i, 1}, \\cdots, x_{i, p}\\}\\in\\mathbb{R}^p.\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which we wish to group into $K < n$ clusters. For our dissimilarity measure we\n", - "will use the *squared Euclidean distance*" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\\label{eq:squaredeuclidean} \\tag{2}\n", - " d(\\boldsymbol{x_i}, \\boldsymbol{x_i'}) = \\sum_{j=1}^p(x_{ij} - x_{i'j})^2\n", - " = ||\\boldsymbol{x_i} - \\boldsymbol{x_{i'}}||^2\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Next we define the so called *within-cluster point scatter* which gives us a\n", - "measure of how close each data point assigned to the same cluster tends to be to\n", - "the all the others." - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\\label{eq:withincluster} \\tag{3}\n", - " W(C) = \\frac{1}{2}\\sum_{k=1}^K\\sum_{C(i)=k}\n", - " \\sum_{C(i')=k}d(\\boldsymbol{x_i}, \\boldsymbol{x_{i'}}) =\n", - " \\sum_{k=1}^KN_k\\sum_{C(i)=k}||\\boldsymbol{x_i} - \\boldsymbol{\\overline{x_k}}||^2\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $\\boldsymbol{\\overline{x_k}}$ is the mean vector associated with the $k$-th\n", - "cluster, and $N_k = \\sum_{i=1}^nI(C(i) = k)$, where the $I()$ notation is\n", - "similar to the Kronecker delta (*Commonly used in statistics, it just means that\n", - "when $i = k$ we have the encoder $C(i)$*). In other words, the within-cluster\n", - "scatter measures the compactness of each cluster with respect to the data points\n", - "assigned to each cluster. This is the quantity that the $k$-means algorithm aims\n", - "to minimize. We refer to this quantity $W(C)$ as the within cluster scatter\n", - "because of its relation to the *total scatter*." - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\\label{eq:totalscatter} \\tag{4}\n", - " T = W(C) + B(C) = \\frac{1}{2}\\sum_{i=1}^n\n", - " \\sum_{i'=1}^nd(\\boldsymbol{x_i}, \\boldsymbol{x_{i'}})\n", - " = \\frac{1}{2}\\sum_{k=1}^K\\sum_{C(i)=k}\n", - " \\Big(\\sum_{C(i') = k}d(\\boldsymbol{x_i}, \\boldsymbol{x_{i'}})\n", - " + \\sum_{C(i')\\neq k}d(\\boldsymbol{x_i}, \\boldsymbol{x_{i'}})\\Big)\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Which is a quantity that is conserved throughout the $k$-means algorithm. It can\n", - "be thought of as the total amount of information in the data, and it is composed\n", - "of the aforementioned within-cluster scatter and the *between-cluster scatter*\n", - "$B(C)$. In methods such as principle component analysis the total scatter is not\n", - "conserved.\n", - "\n", - "Given a cluster mean $\\boldsymbol{m_k}$ we define the **total cluster variance**" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\\label{eq:totalclustervariance} \\tag{5}\n", - " \\min_{C, \\{\\boldsymbol{m_k}\\}_1^K}\\sum_{k=1}^KN_k\\sum||\\boldsymbol{x_i} - \\boldsymbol{m_k}||^2\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Now we have all the pieces necessary to formally revisit the k-means algorithm.\n", - "If you at this point feel like some of the above definitions came a bit out of\n", - "no-where, don't fret, the method does get a whole lot simpler once we start\n", - "programming." - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## The K-means Clustering Algorithm\n", - "The k-means clustering algorithm goes as follows (note in my opinion this\n", - "description is a bit complicated and is lifted directly out of ESL HASTIE for\n", - "deeper understanding purposes)\n", - "\n", - "1. For a given cluster assignment $C$, and $k$ cluster means $\\{m_1, \\cdots, m_k\\}$. We minimize the total cluster variance with respect to the cluster means $\\{m_k\\}$ yielding the means of the currently assigned clusters.\n", - "\n", - "2. Given a current set of $k$ means $\\{m_k\\}$ the total cluster variance is minimized by assigning each observation to the closest (current) cluster mean. That is $$C(i) = \\underset{1\\leq k\\leq K}{\\mathrm{argmin}} ||\\boldsymbol{x_i} - \\boldsymbol{m_k}||^2$$\n", - "\n", - "3. Steps 1 and 2 are repeated until the assignments do not change.\n", - "\n", - "As previously stated the above formulation can be a bit difficult to understand,\n", - "*at least the first time*, due to the dense notation used. But all in all the\n", - "concept is fairly simple when explained in words. The math needs to be\n", - "understood but to help you along the way we summarize the algorithm as follows\n", - "(try to look at the terms above to match with the summary).\n", - "\n", - "1. Before we start we specify a number $k$ which is the number of clusters we want to try to separate our data into.\n", - "\n", - "2. We initially choose $k$ random data points in our data as our initial centroids, *or means* (this is where the name comes from).\n", - "\n", - "3. Assign each data point to their closest centroid, based on the squared Euclidean distance.\n", - "\n", - "4. For each of the $k$ cluster we update the centroid by calculating new mean values for all the data points in the cluster.\n", - "\n", - "5. Iteratively minimize the within cluster scatter by performing steps (3, 4) until the new assignments stop changing (can be to some tolerance) or until a maximum number of iterations have passed.\n", - "\n", - "That's it, nothing magical happening." - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Writing Our Own Code\n", - "In the following section we will work to develop a deeper understanding of the\n", - "previously discussed mathematics through developing codes to do k-means cluster\n", - "analysis." - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "### Basic Python\n", - "\n", - "Let us now program the most basic version of the algorithm using nothing but\n", - "Python with numpy arrays. This code is kept intentionally simple to gradually\n", - "progress our understanding. There is no vectorization of any kind, and even most\n", - "helper functions are not utilized. Throughout our implementation process it will\n", - "be helpful to keep in mind both the mathematical description of the algorithm\n", - "*and* our summary from above. In addition, try to think of ways to optimize this\n", - "while reading the next section. We will get to it, take it as a challenge to see\n", - "if your optimizations are better.\n", - "\n", - "First of all we need a dataset to do our cluster analysis on, for clarity (and\n", - "lack of googling beforehand) we generate it ourselves using Gaussians. First we\n", - "import" - ] - }, - { - "cell_type": "code", - "execution_count": 1, - "metadata": {}, - "outputs": [], - "source": [ - "%matplotlib inline\n", - "\n", - "%matplotlib inline\n", - "import matplotlib.pyplot as plt\n", - "import numpy as np\n", - "import time\n", - "from IPython.display import display\n", - "\n", - "np.random.seed(2021)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Next we define functions, for ease of use later, to generate Gaussians and to\n", - "set up our toy data set." - ] - }, - { - "cell_type": "code", - "execution_count": 2, - "metadata": {}, - "outputs": [ - { - "data": { - "image/png": "iVBORw0KGgoAAAANSUhEUgAAAXIAAAEICAYAAABCnX+uAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjMuMywgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/Il7ecAAAACXBIWXMAAAsTAAALEwEAmpwYAAEAAElEQVR4nOz9ebBlV5beh/323me8831Tvnw5IRNjoSbU0AN7YJNNdlCiOFmig7TUsi1L6vAflBm2aIVlSqJli//ZCraCEQ532FaYbJkmRVKkxLlFNqururuqq1BAYU4kkInMfPN05zPvvf3HPu8iM4GcgKwCsnC/iAQy373v3HPPuXfttdf61vcJay0LLLDAAgs8vpCf9AkssMACCyzw8bAI5AsssMACjzkWgXyBBRZY4DHHIpAvsMACCzzmWATyBRZYYIHHHItAvsACCyzwmGMRyBf4zEAI8X8SQvz6Az73Xwoh/r0f9jktsMCjwCKQL/DQEEJMb/ljhBDpLf/+tx7B8f+AEMIKIf67O37+5frn//LjvsbHQb0glEKISf3nbSHEXxVCnH6IY/xIForFgvTZwCKQL/DQsNa2Tv4AN4A/fsvP/ptH9DIHwO8TQizf8rP/BfD2Izr+x8XftNa2gSXgfwKsAy8+TDBfYIFHhUUgX+CRQQgRCiH+ihBiu/7zV4QQYf3Ya0KIP37Lc30hxKEQ4it3OVwB/D3gz9bPV8CfAW5bKIQQPyOE+K4QYlT//2dueeyiEOIbddb8G8DKHb/700KI3xFCDIUQPxBC/IGHfc/W2tJa+3p9bgfAf1gfuy+E+AdCiAMhxKD++9n6sb8M/DzwV+tdzF+tf/6rQoibQoixEOJFIcTP33KuPymE+F792J4Q4r+83/u42+ss8OOHRSBf4FHiLwI/DbwAfBn4SeA/qR/7a8Av3/LcPwrsWGtfusfx/hrwP6///keA14DtkweFEEvAPwT+K2AZ+C+Bf3hLFv//BV7EBfD/Cy6jP/ndM/Xv/he4rPovAH9HCLH6MG/4BNZaDfx9XOAE9936r4ELwHkgBf5q/dy/CHwT+HP1LubP1b/zXdy1W6rP/b8VQkT1Y78K/Kq1tgM8Cfyt+72Pe7zOAj9mWATyBR4l/i3g/2yt3bfWHgD/OfBv14/9OvBHhRCd+t//NvDX73Uwa+3vAEtCiGdxAf2v3fGUfw24Yq3969baylr7N4C3gD8uhDgP/ATwn1prc2vtbwH/wy2/+8vAP7LW/iNrrbHW/gbwPdwC81GxjQumWGuPrLV/x1qbWGsnwF8GfuE+7/fX69+rrLX/NyAEnq0fLoGnhBAr1tqptfbbP8T3scBjhkUgX+BRYgO4fsu/r9c/w1q7Dfw28G8IIXrAv8odZZK74K8Dfw74g8B/d8djd77eyWueqR8bWGtndzx2ggvA/7QuRwyFEEPg54CPU+M+AxwDCCEaQoj/hxDiuhBiDPwW0KtLRB8KIcRfEEK8WZeJhkCX98tB/y7wDPBWXUL6Yz/E97HAYwbvkz6BBX6ssI0LLK/X/z7PLaUQ4P8D/Hu4z93vWmu3HuCYfx14B/hr1tpECPFhr3crzgP/BNgB+kKI5i3B/DxwIvd5E/jr1tp//0He2P0ghJDAHwf+x/pH/yEum/4pa+2uEOIF4CXg5A3YO37/54H/CPhDwOvWWiOEGJw831p7Bfif1a/zrwN/uy4h3e99LORNPwNYZOQLPEr8DeA/EUKsCiFWgP8MV1I5wd8Dvgr8eT5YJvlQWGuv4UoSf/FDHv5HwDNCiH9TCOEJIf4M8DzwD6y113Elhv9cCBEIIX4OF2hP8Ou4EswfEUIoIUQkHO3x7MO84fp1P1e/93VcnR6gjauLD+ta/l+641f3gEu3/LsNVLiGqSeE+M+AkzIUQohfruveBhjWPzYP8D7ufJ0FfgyxCOQLPEr8F7jg+QrwKvD9+mcAWGtT4O8AF4G/+6AHtdZ+qy7N3PnzI+CP4bLfI1xG+8estYf1U/5N4Kdw5Y6/xC2Lh7X2JvAngf8jLnjeBP73PPh34s8IIabACPjv69f/2i3n+VeAGDgEvo3bJdyKXwX+dM1o+a+Af1o/521cCSirz+kE/wrwev2avwr8WWtt+gDv487XWeDHEGJhLLHAjxJ1pvmMtfaX7/vkBRZY4IGwqJEv8CNDXWL4d3mfybLAAgs8AixKKwv8SCCE+Pdx2/5/XFMBF1hggUeERWllgQUWWOAxxyIjX2CBBRZ4zPGJ1MhXVlbsE0888Um89AILLLDAY4sXX3zx0Fr7ARmJTySQP/HEE3zve9/7JF56gQUWWOCxhRDizklmYFFaWWCBBRZ47LEI5AsssMACjzkWgXyBBRZY4DHHIpAvsMACCzzmWATyBRZYYIHHHIsR/QUW+BRhmBRcO5wxTks6sc/FlSa9RvBJn9YCn3IsMvIFFviUYJgUvHRjQFEZ+o2AojK8dGPAMCk+6VNb4FOORSBfYIFPCa4dzmgEHo3AQwgx//u1w9n9f3mBzzQWgXyBBT4lGKclsX+7E1zsK8Zp+Qmd0QKPCxaBfIEFPiXoxD5pqW/7WVpqOrH/CZ3RAo8LFoF8gQU+Jbi40iQpKpKiwlo7//vFleYnfWoLfMqxCOQLLPApQa8R8JXzfQJPMkgKAk/ylfP9BWtlgfvikdAPhRD/W5w7usV5Nf471trsURx7gQU+S3DBfBG4F3g4fOyMXAhxBvjfAF+31n4BUMCf/bjHXWCBBRZY4MHwqAaCPCAWQpRAA/iA4/kCCyzww8NikOizjY+dkVtrt4D/K3AD2AFG1tp/9nGPu8ACCzwYFoNEC3zsjFwI0Qf+JHARGAL/rRDil621v37H834F+BWA8+fPf9yXXWCBBWrcOkgEzP9/7XD2kertn5bs/tNyHo8DHgVr5Q8D16y1B9baEvi7wM/c+SRr7a9Za79urf366uoHnIoWWGCBj4hHOUj0o87uT17vG5f3b3udxS7j4fAoauQ3gJ8WQjSAFPhDwMLHbYEFfkQ4GSQ6ycTh/oNEd8t278zutbFsDVOuHs746vn+R8qK7/ZaJ8G6EXj0GwFpqXnpxoCvnO8/8l3GjzseRY38O8DfBr6Pox5K4Nc+7nEXWGCBB8PDDhLdmu16UvD61oi/9jvv8Vtv77M9TOfZ/SQrubw7QSKQ8JGy4ntl1vfSllnIFTwcHglrxVr7l4C/9CiOtcACn3U8bG34ZJDo2uGMQVLQiX2eXb/7INFJANXG8vbehMhXrLRCbhwnZKUm8hRrnYjtYUrkK8DSjvz7ZsUfdt73yqzHaUn/jnOMfTV/Dw+7y/gsY6FHvsACnyLcq9xw/2D+YMH1JICeBPHI97DWMs4qLi63uHY0oxV5TLOKwBPkleHCssvuTwLtg553UmjO9Ru3PfdBgvXFlSYv3RjMn5+WmqSoeHa9f9/r91lskC5G9BdY4FOERylle7eyhhAuYE7zitBz5Yu8MrRCxWo75HQ3IvAkBoOx8Ox6h3bkMuG7ZcV3O+9pVt1VCOziSpP9ScYPNge8+N4xP9gcsD/J5sH3YeUKPssN0kVG/pjhs5px/LjgfvfvXuWGh8Xdyhp55bLbotJc2UtJK4sS8FMXl0lLzUYv5it1Y/OlGwOUFFhr75kV33rek6xke5gyyUpmRUUjVKy1ow/NrAWABYsFK9y/a3zYLuNe1++z3CBdZOSPET7NGcfdaGQLvI8HuX+PUsr2bg1Da+HSaou8MhzNciJfsNGNePdwOs+I4f4iXrfe891RxsEkrxukY0ptCD1FrxEgcIvHnce4djhjtR3x5XN9vv7EMl8+12e1Hd1193G/6/dZbpAuMvLHCJ9UxnG/LPKj1nU/a3iQ+3drbbjShmtHM46nOS+c7zNMioe6nveqQR/PCn7y4jJfu7DE9jBlmle0fUG3XjBeujG4567vznteactrW0PiUNEKPJJCsz1MWW6F83P5hWfXbjvGw+4+7nf9PssN0kVG/hjhk8g4HiSL/CxZlH2cnceD3L+TLDivNC9eH4CFr11YIvTUXV/vbud0L1rih51L6En2xtkD7fruvOdrnYgvnOmxO0oZpq60stGLWe9ESAQv3xh+4BgPu/u43/X7LOu5LwL5Y4JhUrA7yvjdq4dc3h0zydyH94edcTxIkH7ctrQfNRh/3NLWgwauXiOgHfn81CVXbujEwV0Xx3ud071KI53Y52CSc3l3zCgtGcwKXt4c8o23Dhin1X0X5Q+756vtkDP9Jp3Y56m1NkvNECEEQsBSM/jAMR428N7v+n2W9dwXpZXHACdf1pVWyKyomGYlb+0UXFhuISX3pWR9HDzI9vdx2tJ+nDLQxy1tPQyl7kHLDvc7p7vREi+uNHnx+oCi0hxPc6SQxL5HHhp+7+oBo7TAWEErVJzuRmR3BNC73fOn11q8XH9WrXUBdXuUstwM+P6NwW1lmoflvz/I9fus6rkvMvLHACdf1rVOxHPrHVqRT2ngcJr/0DOOB8kiH6ct7ccpA33cncfDZIwPmr1vD1NuHM148fpgvlN7kHPqNQJOdyOSQlNZiAOPJ5abLDd8tkcZu6OMTuRRassrWyOEuP3373bPv3S2xwvn+xgLe5OM7VHKRjemFweEnvzADubkmvzCs2sPyJX/bGbc98MiI38McGt21o58nl33sdYyeMjm10fBxZUm37xywCgtqSqL57mG2M8//b7w2cNmVj8K3K1B+3HofQ+787jbOTyq7H2YFOyMMjwBnTggrwyXdyecX2qw1Lr/a2z0YjYHCZdWWog6UhfaEgeKZL6IWAT2A797r3v+pbM9p9EySOlGHkJIslLz7HobJcVDTYbe+Rn6rGbc98MikD8G+KRLF/fi+p7g0/QFu1f55ONcy/sF11sDkRBuAV5tRx+JyfMgi+O1wxkXl5vcOJ6RV5rQU+RlxbWjKV974twDvZ8Xrw8Yp8V8ISgqw+fWuxTaMs5KWqHHxZUWV/anWMttAfZu9/z9c58ikbQiwYXlNu3IZ5wWvLY9eigBrUXGfX8sAvljgI86rvwocML1vbDcmv8sKapP9ZDFverGH+da3iu43hmIXtkaMs3KecPvo1BFbw2U7y8Sw9tG7VfbIXGg2B6mjLOSZujRCL0HXix+6flT/MYbuxxMc5YaPheWmxhr+NoTS7Qjn51RyjevHCCATuhRacswKR6wDLJEUZn5e59kJa9uDWlF/n3VDk8y+muHU75yfmkx+HYfLAL5Y4BPsnTxKCcNf1S41zl/3Gt5tyz0zkBUaehEPtvDlGfX/dvO4V74sPIC8KHZqpKCtNTzchu4RTbwHrz1dWG5yZ/+2rn5a57qRozTEiUF47Tgm1cOMNrw3EaXysCN44TzS416UeSepZA7F82rB1MsYl7KuTVYWwTPnWoDzIeKQk8ikXMmziI7vzsWgfwxwSdVujihqQ2Sgmle0QpdMLmzBvuopQM+zvHuVz75KNfyYUfrW6GiqAzTvJr/7GCSczjN+cbl/YcarFJS8GE7jJNRe/h4O7U7r8fJe31te4QAntvo0grfLz0dz3KOZjkvXh+gjWGpHggaJgWXVlscz4r5dTr59yApKLTmS2e6tCP/A8Ha8wSvbg350tn+LaqLglb00XYznzUsAvljjJMv3PYwZZpVtCKPjV78SLehS82A37q8Tzf251/ArUHCn/rq2dvO46PWNx8mA33QjOxRl6Ie5P3duXhs9GJ+sDmkHTplwYNJzmtbQ75wpveBY4ALUi/dOCZQikurLaZ5xfYw5WiWszfK+UOfu30qMvYVWal/KDu1k8C+PUwZzArePZjSjQJW2yGNQHHjeMYwLVhrR+SlYWc0QckJT622ePdgyhdveY9XD6a3cdePpwXvHBzz4vVjtIa1TsjFlSaXVlr8YHPI1YPpfLw/rzQXltvz9/tp3gV+0lgE8scUJ8FlklW8fHNAXllCJajO9R+ohvmgOJ4VfOFMj0FSMMk1rcjn3FKT41kxlzZ9GH71nQ3BUVqydkdD8G4Z6INmZI+6FHXvmjvzxXRnlHJxuUXkS64dzRhnJaEnuDlImGYVXzjTY60T3XaMVzaHaGNpBB4SSVZW/N2XbnI0K2h6Hhu9iFlRzbPVW1UIhbh3aePjLPQnjJhGoMiKirSoeO+oYqnhM0xLsIK3dsZzrnngSb71zgFPr7Xvet+WmgH/9LUdxlmF1hZPCW4cz2iFHk+ttfnSmS6X98ZYBAbLs+vt+6ouLuCwCOSfctzLkssY+MHmEE8Iuu2AWaZ5ZXPIzzy58si2oScNtZMABMypj7c+50Hq6B9oCG4OmeQVy3c0BF/bHvETF5bue7x74VGWou72/m4OEoZJQSPwONdvEHmKN3bGJEXFmV7Mzz25gqfkvPwR+ZLLu+N5iep0N+LK/pQvbHRdIJfwzu6MzeOUwBPEDcWN44TQV7y1M+F77x0RBR7N0GOlGbHc8gk8xTipGGUFhTac68ec6sS0I49RWtLwPd47nHE8K0iLilPdmG9dOeBUJ8JaaEUe7chd91tZKdcOZ6y2Ql7ZdJriaVEwSkvek4InVhrcPErxPUUndg3QcVY6iqqxH7hOJ/fteFaw1AooKstmpjFYluJgvvs4t9SYNzYfVHVxAYdFIP8UY5gUH+Bwbw4Sfv7pVcZpyfEsRxtLpxEgEDRDxSA1HM9yPPVhJMGHx4PQ9R6U0veBhqCxdD+kISiwn6pJ0bu9v2lWsdIK5z+PA8U0L0kLTeSr+eI0zSpevH7ENNMst0LO9GJKbXh1a0hluG3I6HBSMExKSq0ZJRpPWkLfw5OCpKhYUYpJUjJOK24OJM+stRmmJUVp2BrOKCsDFraGFm0cdXR/nNGOfARweXdMHCh2hylPn2pzOM0ZZyVJXnG6F+NJybeuHDJMCqy1LLUClCw5mOREvuKptRZFZZnlFW0pqLStz81gLXjy9s/drfdtnJZUFUgp6tfOEEJw/XBGUrhg/sL5HsCnbi7h045FIP8U45XNIZuDlF4c0IgleWXYHKS8sukoaG/tjulGPmVlCDxFqS3dyOM4KXmqZgB8XFxcafKtKwd1cDH4StJr+PzcLQNBD1qT/mBD0KOoNNP8/QnGtNQ8tdYmKSqmWcXxLOc4KVBS8kvPn3ok7+lhcbf314q8D/hb5qUhUIJSGy7vjjnTb7B5PCPJNXGg0Nry3uGU070GFkEzkPNFYpprCq3JS40QgkBBUhrGWUY39rmw3OLCcpOi0nz/xoDV2p5trR1xlORUxvLu/tT1MvKK59c7fPvqEef6MYGnOJzmSCnAwiit8JTizZ0he+OUM90YIVIEgkq7Jm2/ETBKSqQUPLfeoagsWanJSkNWGaqkIAoUaWGQQvL0qTatyCcpqg/9HHRin1FWIBG0Yo/Ak2wOZgyykk7D52sX+nhKznsHJ/2DBe6PRSD/EeGjsDDe2Z/Qjfy6gw+Rr+han3f2J/zrXz3Ht64ccDTL59lSJ/Y53YlQkgcaj3/Qc7IAAoT7zwfm/B60Jv1hDcFXNge0Iv+2LfRXzvcZpSW/8cYu2sBSI2CpGXL1YEo39n/kmdnd3t+1w9n8/ZwwLRrByb1yUq7/7I09Qk+SFIaLqy2S3DDKCoZJwU9fWmaYlvNF6+rBxN3LQNGJXHM5G2cUlSEtDKttJwlbWcs4LSi1xlOSZqDYPEqoKjduvz/JOJ4VPLHUYJpX7I4zjIXtYULse2xnBUVlSSrN4TgjChS+L7myN+XzG108JXlrd8okryg1pGXJE0tO18dYwVo74NlTLd7enzJOS55abdJtBASe4peeP8XxrOCt3TFv7Y4YpZpvXtnn608s8/mNLlIKZkWFXwmksKSFYanh4yvFzihjoxfPJRMWDJUHxyKQ/wjwUVkdSWE4GM9ICkNauu16M5A06wbQajtkf5yz1AjItGacFqy1Q37p+fUHambdeU7fvHJAN/Y/UCtda0c8cZeBoDsXgy+f6z2w6JGSgrP9Bp3YZ5AUCAFKCn5wc8juKOPicuu22vydg0h3Y7w8ageluy14F1eYv58Tf8tW6IFwFL3tYcLRJOXJ1TZhK2B7mPH0WpsLyw3GWYmnJBu9mKVmwH//8hb745yi0vi+pNKWrKqotEZJQ+j7bA5SAiXZn6RM6gAdKMn+OEcK8KVkrRthjEAJwavbIxCWaVailGSUliSFJskrSm2Y5AVJbmhFHpGv2J/kDN49xJcCgcWTAVlRsj/OAYGwgmdONdnoN0iKiqfX2qSV5p2DGeeWDP/GV8/RjX3e2B7zjcv7VNpwph+jhOJfvLXPOC350pkeNwcz9sc5WanR1nCu16Df9Cm15fLuhGdOtT4g0rXAvbEI5D8CfBTVvJMa5f7EfeB9T5HkJUmgaIQer2wOubjS4vxSszYG0HgKzi815mySk+PcrVl65yTd5iBllJRcXGny+vaIb769j5SSr5zr3XZuJw2sh12gPiyz/bmnV2+bjDTGBcHv3zimGXh88UwPbS3TXNMMJI3Q4yu1ycLJa3tS8PrWiH/2+i6NwOP50x1W2+HHpkE+yOj4yftx/paKF873mWYVv/HGDoezAqQk9BWVsdzYnzDJSp4/3a4zdld2eGVziK8EXzjTnZs+DJOCwPd5fqPH5jCh4SusNVw/nHFjkOJ7gsCTSATbw4R25HO6zmaNNZzuxtwczPjKuSVuDmYcTgtOd2N2RimltWjAR2Bw4mtH04JTnYiirEApKmMYZSWzXNMIFHlpwFoOZzl5qWlHgbuHkcdyI+D3PbnCe0czrh/NeHVzjJKCwPMZzCrWez5Lcci1wxk/+1TM02ttvny2z42jGaHnrs1qJ57vPK8dzfj8RvdBvloL1FgE8h8BHoTVcWcgcV/4LnvjrGYCWJSSRL7i+dNd3tmf8PULywgh5o3CO9kkdwbHt3bHvHh9wC89f+oD57Q9TOlGjlr29t6UyFestEKuH6W8sjXiy2d7H6CCfZQF6l6TkcbAjeMZka9Y78TcHCT8je/e4Km1FqutgKRQBFk1v1aNwEMbO3eDx8IoyblxPCMO1Px8HySLv1uwflCZ2JNewmvbQ947mDHOHHOlGwe8tjXkwnKTJ1ebXD9K+P6NIZ/f6NCvNbpf2Ryx1PBphQGTvMICq+2AUhsakeKFc46XvTlIeH17jK8Eoac43Y3RxpJXhlJbelFAK/SQAqZFSaktG72Iz53u8HvvHSERZKVGJIUb4MkcBVS4ohlZpTEW/Lo2f7g7phMHnOqESCGoKs3OKOMHN4d0Yx9jDYOJRknL1jAhKw2NQDErSqRwzd+TQaFTnZDDSY617zcy98YZ55ZiDqcFW8MEXVmkAiEEf+xLG/f/Yi0wxyKQfwQ8bL37fqyOD8v6Xr4x4GsXljjTb5AVmrTUxL4kCjxW2yHvHc/uesyT83vpxjGVsVTa0m8ErLYixmnBb7yxyzOn2rf9/jTXVFpz7WBKM/ToNXxWWiG9po/AcvVwypfO9G5rYP3g5vCBx/cfZDLyeOZq/ZHv0Qo9to5naAvGWNJCczDJ+emaWnmyEJ0E8cj3qIxFCrfYnTBhbj2fB52cvHN0/Gwv5uZxchtt8MO2/hY4mhYEnqIZukWmMpYLy03yyiCl4OxSg2bo0W0EnOs3SEvN1iAh8lostyKePdXh5nHC5iCh0pZT7YiNbsS1wwSAZqCIlPscdOKAUmu6sc9xUlBaw1NrTbaGGUrC86fbzPKKg0mOAApjEFLSCDwKbWhhiesmqNYGJQWRFAgp5kJpnchDSslKMyDLNeO84GiW8d1rR2SVphV5XFhq8VtvH5CVmvVejLCQV5bAc4yWtDQkuaEZeXTqHsfJwno8LUgKzSSrsFjKCvqNhw9Lj3qy+HHDIpA/JD5Kvft+rI4Py/qWWuGcy1tqQ+R7rsSiRP3FtHzn6hFLTZcNnvCV17ut+flJJMezlKzQdOIAIQSdOOBgmgPcNt7tHNXHeDUrZZpVXNmb0G8FPL3aYpiUH2hk3j6+r2mFaj6+f7fBH0+KednmhfN9vnS2Nz/WW7tjVluuJj4rKlpx4Lbz0xwLSAFv705QUtCOXHnprd0xy82Q1U6ErwTgstXxhzgo3S27vpW3PslKfvfdIzaPE4ZpQex7fM8e8fWLy4Se5N2DKb937YjnTrd5YqU5H0ffHWWstEJOdxt0ItfovLI/Zus44cm1JqOs4sJSAykFvhQUmjk9cb0b873rA9Y7Ed3YY63jFtDPb3SY5Zp/8uo2hbYkuWZSaI5mKWc7DQrtczx19e/lpk9eaP7JaztobVGe5Fy/wTAtMQbakZswDZXgIC1ACOK65FMaiyclSoAUktBT6MDirqYgzSpGQtAIJNrA5nGKxiKEoCyd7njkKUZZSV5pnjnV5ejIKTK2Iw+s4DjN+fqF/m1N+BP1xUa9A8srQ1bquZbLgzY7F8qJC2OJh8ZHMSY4qaXeTRD/wwwLLi67INFvBKRFxSjJScsKX0m3VV9q8bULfRDw4vVj8kpzabXFt9894u29CTePE6SErLA0Q4/DSQZAXjmWwMkW9+ScfCXY6DeIfMW7+1N+sDniMClRCGaF5miS36Yb4ib/Uv7BD7Z4c2eMqptqr20N8aS4zX7sxlEyr7+/vTdFCclKK+TGUTI3Gri40kRJyTh1vYFhUtIMPFbaEc3QY7UVcaoTMUgLrh1M2R66hl879Enykiu7E5SUtEKPcVrQDNQHDC7uZgxxwlsHeGVzxJs7Q0qjWeuEYC2bg4Q3d0a8dzhF13rdk6zi731/k+Opu0fDtOD68QwpXKkDIPIUB9OMy7sTPCl4dr2DrSlArfB92qKSzBe717fHfPe9YyJP8qWzPa4dTDmYFQzSEouhGSqsge1xzvZxgrGWpq+4tNKm2/RJS4MG1jsRlTbsTwpGacGs0Fxaa/NTl5bpNkLyyu1yrIVWoNDGMkhKCu2aoYfTHF+peudh0cbtKAptWO3GdKKAhq/wPME0L9kaJSRZyc4o4zjJWW0HSAGDtKQVSX7xuTV+35MrvLI55P/1rav8v7/1Lq9sDvEkHM4Kvn/jmO1hwplezGo7fCibwM+SZ+zd8EgyciFED/h/Al/A7TD/V9ba330Ux/604aOqAd5r0vDDSi+ekrxw3tWlsyqej1jfOer95bMBSVGRV07XYpiWrDRDCm3Yn+TsjBKEhTCQtCMfKQTnlxof2OICZKXmm28fcHOQgIVISF7ZHHJ21uBzGx2SvKKoDN+6coDFBZ4vnOlymDi62TPrHb5wpscb22OeWGneNvjjS8FvvLFDMwzoNTxWWiFVPZp+Ii97phfzjbf3CZQk8CQXlhtc3p2w3o2orOHmYUpWajwhCTzFl8/2eGd/4oZcfEUjkCgpeGtvwtl+g1PdaM5FfunGgHcOpoSe5NKKY+C8cnPED7YGZKXmyt6En760yutbQ0JP4kvFUjOiqDLO9mPe3pvy1Qt9uqHHuXaD60cJZ3sRg6RgrROx3AyZ1ruAwaxgb5IRKMHnTneYFRXNWnPFk4JRVvLlsz3ATea+ujliZ5yx1HD16Hbozbn17x5OERamWck0r1BC0ot8BmnJ3jTn0orHc+tdEJZASYyxFJW7rsdJweEkp9/wCT1JM/CY5ZrlVsDuOGOalbSjgH4joBEYtgYJx8biS0kn9BECTnXfv09l5QSyIl8xmpXEgUepNYNpBdbV9YWQXD+cISSstSP+zNfPz5k5r24O2RwkdCIfELx4fcD1o4Rn1lpcOr9EXmm2hglKigcyxjjB46jQ+ajxqEorvwr8E2vtnxZCBEDjER33U4cfhsnD3UovtzIjTvCNy/t4UtSj3nruqXgy6r3cDCi0RVvmzaXjWY5MJa1gwk9eWkF+CM+8E/vcHCRcXG1x/TghKSomWUVeWcZ5hScFP9gacnlvwtbQDaGsd2NaoUcgFb6nOJzkPLXa4mCS8bnTnfmxpYCbg4RBUnGm36DScGV/yqXV5m2j7kvNgD/+pQ2uHc7YGqYEnuTSahNjLO/sTQg8xdcu9NkaZrx3OOULZ7p85fwST621ubI35gc3h3z1whJ//Esb81LTKC25ejClEXg8d6rNq1tDvn31iKRwpaPIl1xcbjLKSn7z8j7744wzSw1OdWJiXxH5EmM9AuWoc0KIeZZ6MngzyUpmRcXbe2N8T3G6E+MpN4n5zHqH052Y/WnGSzcHNAJnw+bOSfE77xwwSiqEsOyOUg4mGb//6TUCT/DK5pBxUlJog7VuDL4oLYEnWG5ENCNFI/B4dr3FNNcMZjkCwfEsY3OQYowhN6amG1rWOxF7EzfJmRYVseeRl4bdIiNQigvLTQ6mOXGg8KTAGMt7BwmtyMOT4EvFLHPURSlhlmlsna17SlAZWGn5dGOP/VHG8bTgcOLOZWeU0G+ErLVDIt99d8rK0AoVR7OCfjOsjTE0145mfO2JBx8G+qSNVz4N+NiBXAjRBX4/8L8EsNYWwI/tUvjDMHl4kIGak5rzq1sjJzQUeCgp8ZXgyv6EaVagEEgJ00xzOM04muVMMk079ogDj2nhGmv9Zpcf3BzewYlu8s2399kdpgyTAm0h9BRxKBgnJb/9ziGt0OOJlSbSCrYGKUmuUVLQjHzSvGJrkDBMS7qxzytbQyrt5FyT3FBpQ7vhPCAFUJQVm8eO6TBKS752vo82lp2RY+mc6cUst9wW+/XtEU+vtznTa9AMPIZJSSGZNzTbkY9Skq9eWOLL526/D99+9+i23cGXzvb5xuV9XtseuUZiv0HsKRqBT1aWaB0RexIlnM5HM/DYGSasdUKysprblp1fajDJSkS9qEa+4snVNvuTnFe3RvSbHkIK3tmfcGVvQl5p9iY5Xzvfpxv5XNmf8MbWCOkJpkVFO1R4QjDNK/7hqzv8yRc2eGVzxHI75O39CUfTAiXBV5JKGwgsG70YIQRSCFZbAduDxMnFVpaqMpTWkBUVk7RkmJV1zV8xKzRSCkprUPXCVGmLks7qzRaaaeaGiJqRxxOtmFB5NEJHgd0fZUxLt9BX2mIM7ncrTehLRmnFMKsQacU/e32Pz5/pMs00W4Mhv/DM+yqOpTbEvmKpFVJqzbsHE7DQbz5cAP4kjVc+LXgUGflF4AD4r4UQXwZeBP68tfa2ApUQ4leAXwE4f/78I3jZTwYPOsV4L9zZYV9qBrdpON/acR8mBa9sDnn5xpClZkBZafZHKePA54llN7l39WDK2aWYyhiOJwV7k5z3DqeUlWW5HfDMegdPSA5nGVcOpnztiaX5B/7WptBTp9r81tsHhL6kKC2VgYNZiq4M+xPJ184vYaxAKkFeuBH0cVahpGumrbcjkqLieJqjpOBUO6SoDG/ujsmKksNpySs3hiy3Ak53YqTS+BICJXhrd+Tqu9bOaWhbo5Q/+xPn2Ru7RmJUS7e2Ig9rPY5mOeO04NrRjBffO+aFcz0mWTmnHca++sDuoB35nO7GvL035uJKEylcm8hXgrwSnOpG+FKQlSV5JQDLxZUmnz/TZXuYstQK64EVw2tbQ+JQ0Qo8QCCl5GsXlhiku+yPc84tNbh57KRoLW5R+ObbBzRDj+fW24SB4qAeAtorNZFyC8g0L/kXbx2w0vL5+gV3b44mOVlpafiSyPdoRz6FNlxcaTo1Qiybo5S80kzzEoubmhQCPCmxxrA9SGnHHu3QRwiBMYYokJSVITOGvNIoIUi1Gy4y1pXE3j2YcX65RRx4+J5HaXOSUuNLia8sFou1AmPh+uEMY01d3lFcP5qxN86JfEkz9tkapTyz5tfXXFJUmmag0AaeXG1jrcFYHrkt3o87HkUg94CvAv+BtfY7QohfBf4PwH9665Ostb8G/BrA17/+9Q+6uT5G+LB694PSn+7ssB9Mcn7r8j5fONP7wBALuA/01jBlpRVyPCv4jTf38RR4mabUlpWWy6bzyvKDm0MOpznDrGRnmNFteHzxTBeB4HCac2XfZYa//c4h1roGW14aXrw+4Fy/wY1BggX6cUDqaSZpidaGSVGiK3h585i39id0Qg8pLdvDDGMNIBgkJYfTgksrbhpzqelGtm8cJ7x3OGWUlpxfarDaanFzmPL2/pSfeKLPc6ddgHz55oDjpGSjGzHNKoZJCRJe3x7xwvkeN44TxllFK1S8cK5PWmhuHDv3+KVmwJfP9bAWLu9O5vKnaalZbUcf7D94gk4jJMkrWpG7R6W2WGt5+lSHn35ymW+/e8TBJGO1HfHTTy5zYbl52z0+TnI2B65ZG3iKL5zp8Ic/d5pxVtLwFUfA/rjgaOYGuo6nBRYIPEmca+LAJysMe5OM2JMYC5mxFFrTiQKKskLJgLd2J2hjWe/GHM0KZL1ohp5iZ5Ryrh+DtfzExWWK0vIvxlntvelkbmPPNQADzzV1LTAr3PWYpCVZZQiVohSasrJ4gUBaKK3BGJjlGmst0zSnGyle2x6Rl67UhhR0osA1Tsuylllwr+15kqRw/9dUJIXlYJZhKk2Saxq+wmDxlXQ0xsAHXKP42fXOPU2aH/Q7+VnCowjkm8CmtfY79b//Ni6Qf2bwMPSnOylwg6SgW4+or3Wi2wZOwFHkKg15VfLq1ghrDT6KKFBsHk+pdIOVVsD+pKAyhkmm8YXAk4KsMLy0OaAbB1TasDfK6DV8Lu+M6TUdRbAb++zXutPDacGFlSavb41oBIqk0OSlIcvB81wAyCpLlldoYymNQRtnAhAGHr3Y573jmRsKyTVPr7V5c2dEHKg5jzrTjnmhjWGYFry9N0EK2BqkSOGolVIIpABj4G/93k3+zE+epxv7rLWj+U5CSljvxvjKiUUJ4UoUTV+xNUg4v9wkKSp++sllrh5MAai0mdffl5s+e+MMay2+pxjVmdxJ0L51OvYEJ8Hi1c0hf/P3blBozdl+g0wbLu9N6cbH9JsB1sLZrmuQpqXBk4JZqcFCr+FTGsO7B45GaY0lLW19vSuUEEShRzNwVBZtLIEUNFoBVkCSueeU2rDUCDG4EoU2lrSsaIYBZ/uwPc7wEFgBWekeb/iKaVG5EohyE8IAjVAyLS1CWLLSIIBcg6qPLYB3DmbcHGQUlbv2FldKmeQus1fCKSEWWqMNUBqkrxDWHUNaQRQoJnmFNppZYVltR/yBZ1f5xtv7vHE4ZJxpOg0PJQVPrt59TP+zzhn/MHzsQG6t3RVC3BRCPGutvQz8IeCNj39qjw8eZsLxzg77NK/qptn7H9qTBuDeOEUiOZrl9WsoTnVjdgYpuYXQ95ikBZ6EnVFC5Cs8JfGlZKMbkRSa3aFTtIt8SSN0ComTomR/6sarZ0XKSsOVQLoNn7BUtGOfw3HOcZKTlYbAh8Bz9e2qqpgal4Uv1YuWxTJLS/KywhiYZE77enuYoq0bsFnvhISeZFa4bbexlp1hynY7xVOCtNJI666d8gAhiDyBNpqXbwyREg7bOWudiI1ezHq3xd9/aZOVVkgn8skr7YZYBOyNM5461Z5vr7uxX5enBiy1Qn7uqRWy0vDijWOGSYEoNE+davOLnzv1oQH8Tvzj13YpjcEiqKxjiQRS8vbehOfW2xjAk04UrJEqNgepm0LVhiTXNCN3LadZxVIz5HCWkxQWK5xkbagkS42Apu+x3oupjOVgnOEDvifBOhnZpWbAwbSg6St+sDnk3YMpx9OUXFt0qalwNW8lIQ4DZkWJ0YbQE1TGkFQlq80YrQ0WhfAFw6SgqMB3L8OJvLjWUOmTLF8ghEQqSOtZhFbk0Qx9pmlBrl2JzBoocAuBtbDSCek3fPqNiOVWgCcFm4MUa93j55YaYJ2C49GscPTaW3BnmXG1HXLzOOGbbx/wwvnefCbhzt+5W9D/cVoQHhVr5T8A/puasXIV+Hce0XEfCzwM/enODnsr9JhkJa3o/QbPwSRnZ+SGLKRwmeD14wMuLjfohh77UoA2tBo+aeFcyitjSbKKpVZAqS1R4JFrg1Kyns4TNEOPrUFKmhuyyk1ybg8zLq0acm144XyP/b0JOElrlJRI3DCSAMrKUhmDNRAFzvi3Mm5QRSkw9TDOO/sJ610nrHQwdouBmxSNaFeal4czBklJJwrYGiRYLJO0QgCf2wiZFRXWwix3wy651jyz3MbgMtelZsC33z3icFqQlYaNvmuChp4T1VJC8tKNYyZZOf9ytyOfn7q0Mr/unRh+4Zm1Oaf/QXDyxf/ee0fM0pKVTkQrdFovg1lOMtW04z6XVt2gSzdWTDIYzgqkcAF1kJZU1hJ5glJrGqHPV8/12RmnjFKnQ96O3KDOOC+wY1ip7+n2MCErKrwwoB16nOqE7IwyvnnlgLyWMl5q+kxzwyQra40ed09muUZKyXIzQEjJIM0JpGCWlzRDj/VmAymcMqG2rraeV07P/KQOaoBQCcrKEvgWTwgm2gV9JQWnOxF7wrFRxlmJwCKlROAWBIlBa8PhNEMKGKUF//LyPk+vtfGUQiDwfUmoDcezDzclOSkzpqXmG5f3eXKt7WYSjhO0sbftgu+1U4aPZyf4acMjCeTW2peBrz+KYz2OeBj6050d9n7DBbNzS825lOu1oykXl1toa/nOtSO0gXbkZD6XWwEbvQadSHE4K9C24uZxQlKWlFrQin1W2yFaW45nllOdiKVWgK8ku8MMYyxbw1md8Xr0YqcJPs5Krh3MiH1FJ/IYJgWxp9CVIS0qjAVP1KYBAhq+R64r8tIgRZ29GcFKK8JTgtd3Rnz5XI9O5NGJPN7dm9XZnmGQlHQjn6W2z5X9Gb2mx5MrTd7YHfP9GwOkEJzuhiglWW25TH5vnHI0K0iKite2RgSe4um1Fu8cTLmyO2ajH3PtYMbmIOGnLi5zMC54a2ebH9wc8Sde2PjAYnviPbo3zub35V5f4FuDQjP0mOTVXNNbSYmuo91qy9XUZ0XFe4cJvWZAP/bItSUpKpZin07DfV4qXbHaCjnVjVnphOwMM3bGKZOs4ivnexgN2+OUq/vOGMJXEitglBdUeHz3vQH9RoA2rnyRa0NSaCJP8fSpNnvjjHFWUlaWvNK4nqyiqCragc8kL6ikZakZsFYHx9D3MKZyRhFA7EmkgEK7+6yNRQoIPEVVWQLldlGdMKATeRgTsTNOXPO4NChhWW4EeJ5knDmZ3Td2xhxPC1qRR1ZWfOfaIUs1bbYV+qy23MDaKzeHtKP3VThPyoydSLE/yeZJUL8RMM6q+UzCyS74Xjvlk39/VDvBTxsWI/qPAA9Df7qzw77UCvhTXz3L8ayYezvujjJ2RynDxA1shApOtSPe3JlwcaXJOK24duiC0Fo7xJOwFAZsT3IOJhm+dFtwbZxWRyNwI+P7kwxtDXlp8DxJaTQrLZc5L3uS944TAiWJPFjvRgzTiqysSEuXUSnfIi1IJaisoRMHpEUGwpUSTnfdNCEIQiVZ78QcjDOeXG3SChSX96fklaEXhzy93nRThaHBGMvRrOBcr0EcKo6mOcZYGoELeAfTHGstndpNaJYbvnimg6cUZ3oN3tod8y/e2sOX7jWdV6ZitR0xSvIPaMucmEAI3EJXVOa+2ditQeGp1TZH04KsqDiYuKZzURnOL7UYZQX/v9+7Tit0AT/2PX7x+XV+990jfE8RKjGvV7eWYrSBvXGKNpZu7HO6EzLMKma54er+mFlpSPOK7VFC5PtYK8gLTV7mnCg/SikwVuArp2Y4LUryY0c7VJ4gUJLKQFq62YLKup0gForScO0w4WhasN6N3LCOtaSVwTP1mxfUw0YGbSAKJb4QaGFYbgYgBKUxrqErcEbdoYenJAf1hGgnkkyEYDzL6TUDNgcpkS/JKkOaa9qBz6lexDipuHaUcH6pcdu9SQrNuX6DVuh2uu8dzdxWYZrTjny6sf+BXfD9dso/TkNEi0D+gLhXPe1h6U8f1mHv1mJXkae4vDdmd+S2n73Y0bqeXG25L2mmGSQ5u6MUC+TacJRUtEKfp1ZbDJKSUVbRDBTPn+7Qa/i1MXCGtk5TY7UdkZSupqytYb0bUWhDqASd2CPyFHmZsdoKGCeObTEtNMZA6DtVQWsNKy2nijfJCwLluQzOV0S+IvQE33r7gE7sow34Hqw0A5qhj8GVZ2alwZdwYzCjrCwbXZfNZ6Vma5QRyALfAyHcxGKgXL15qeHz6uaIceZYFyvNgMhzk5Obw4RJ7tNvhPQaPlI4fRB4X1tma5DMGRxn+o3bsrETM+UPqiMeI5G0Io9zSzGBt8KrmyOuHkzpNwPOr9Za6AcJo3qB7jZ83t6bkJUuW+43nABVqARR4BEox8xQ0qfUhsNJTmkM/aZrTi+3IpLjGYfTnLy0lKGjSap62KnQpeOCIxHCLbaBklgrGSQ52oJfQWYqCu1KI7V6AFXiroXvuSx7f1K4Zmngoa1FWEBAUbmaehwqjJHYvCIKPHwl8JSPMSeaK5p3jqZ4QrDWCWjHAbHv8aWzPaZZRb8Z8sbOkFle4SsP3xNUlaXUBqRhP8nRAmZ5hbUGaNx2b/bHudvlRj7fvz7AWoGrAQre3Z/wB5499dAWhD9OQ0SLQP4AeBBWysehPw2Tgn/62i7DtGSalSw1QraHGYHnPCA7UcDlvQlfPtvjvaMZq52Q0lhGs4JJWqGUMwLoN31n2hs4v0gpJcO0ZJJpksIJbnXiwNViK7d1nqQljUBSVtAK3fj64bTg/HKTceasvGZ1SQAJTd8Da5nmhqK0PH/aDRdlVYXCGRpUxoBVTHOnzNdvemwep0gpCH3B0cyp3RXaMWBmhabfCLBY3jtK6DU8nllr8/LmiNGo4HQ3IvAkV/bH7I9zVtqhyyhxgQbjJFjdFKajsB1MM64eTVlrhZzpRx+QTz3ViTjTb9zGOb/VTPlWsw0BBMr1K0ptmeYu4P3ic2s8farF6W7M7107phEq3tlzE7dX9iesdSKsdQ1bISwGWG0GCOlUEiNf0o19Ql85Kz1jSDI3zr8/yYk8ibbC6bOIutmIojTOj1MJ0NoyzUuMZS4sFipX35aAUM6R3tzxmTtpresKfGf8RJobyqpgqR0ReoppViKEIPQEae5ecKMXs9oJGeUVk6R0x64Ms8JNj/pKMM40S03Xm7m40uS9wxnPnGry3mDKRi+k4fuEvmRrkIIFgWS5GaIQZEVV90GcG9Ll3fF8crYRKkZpyaXVJlvDhGsHCRdXm5zpRexPMnxP3LYLvt9O+cdpiGgRyB8AD8JKuV8H/F7GBd+6csDr2yMCJZzmRjNkvRMyySpGWUU39pkVFZuDhPcOE55db7PcDLG19+Jyw9VgdeWysllW0fA9jO+y2EbgpF0neYW1JWlZkWlDUWpGScneJKMZeKy2I64eTNnoxexPcsZZxXPrHd47nFJUhihUCCO4MXIj/OODMVcPJ87KrNSkhaZVeWwsNTia5YSBYm+SM6oDQjtyAcrigtL+OKfQhn4cstQMmBUaYw1podkeZzRChScdM8PUxPduFLAzTDndjVlph273UFWcW3JKf2mp68cjFxhKzXFSclHcvtgeT4vakGM6V22800y5ETgneixcWm3VE5yCXu38XlnoN0MOprnznzxOGSYVpa4YpBVHScmZXkiSOQ9OH81rWyM8JelEiiR3O4LDaU479mkHip1xxtEkJw499kdlzcO2WOuCc6m1m/CUUBjXWKTOxi0gLMxuaVJmpalt+j5o0XeC0rrHfQUnFJNu5GHqZrm10G8o2nHAaidke5iyN8koS42vFKUxSCEIlCvzlJXhaOrkAv7Ht/Yx2k2SrrZCwk7M1cMZe5OMSerkB3ylOL/UwFqLto7xMkiK+cRs6Cl8zzVNnZia4vMbPX7fpVXGWck0qyi0/kBp7H475R+nIaJFIH8A3K/Wdr+M/W6PX1pt8c/f3OWtnQmltSzFAXHgcTDOWO86RkQ3FmSVphm8L7r05s6E0BPMco3Whrym83kerDcjitJw/TjhtBLEzZB+M+Ld/RmjNOdAQ6Dc97XSzL04tXEGAFcPLQfTjG7k0/AdQ+SNbactEnoBWVFRltqZFFQWXSsHRj70mwGRp9geJoSeR1E46mJRSVqhYJKVBJ5yVEEraAYeLSEotXMn0tq5zCslmeaaWaYZzgoKrWlEHnmpSYxjQkS+JC00vdjH9zwqbZ1fKZJxVlEaV+ePfEnsvy/yOUwKdkcZ//T1HVaaAavtiM3jKYezgjP9Br2GX2uPOx2bE8XEduTz7HrHqS5mJUoJ/vDnTnH9aMbf/L0bvLkzpqgcJTEpKxRut7AzzGkGisCXHKfO3m256ZOXGoRA4sol5/tNKmOxOArgJCuZlZoG4EuBFk4/R1t33wLpmn66HrM3xjFN4rruXJ6k4PXv3G8Cz/J+Fn88dYyXRuBxph9z/XBG4LtyyPE0d0827rg+YKzFGIuSjtHSCBQHk5yDac5Gp8EXzrQZpQVCSCrr1B7BWRXujJx2+hvbIza6zuEoqyreO5pyYakBCPJK8+x6GyXdZ/5WyYXTxCRFReDJe7hSPZzJyeOIRSC/Ax+WOd+v1na/jP3DHnd2YLvcOEpYaQXkGjaPE1bbAYkQ7IwyvnS2x/44Iy01n9/oMssrPC9z/5eStbbP9siwPU5ZaQRcWm2yNy7oNVzWejjJ2Z8WRMplzNq4IRuhBKVxNWJfUgsfuXr5zijjYCr42SdXWW2HHE5dbdJXrsm2M0qRysmZGtz2XlgoSpctCVGiK4OOLQ3f53w3ptSOBz3JCqLA43Q3ZnU5YpQWHM8Kd6zKYD1VB1DwA49RVjItSgIlwLrFpqycwUYceLTDgKSsKHTF0TSfqz7+5BNLNAJFVhnaoc8Xz/So6oXqpRsDbg5m9Bo+148Tvn9jwHPrHb6w0eXmccpvvLnH59Y79BsBeWXYGWacW44B6mDusz/OuH485e+/tEkUqPlrZWWF1u877SgBU+149vnMmSo/1++w3A7ZGqbkpcvQQ9+N5rdCn/VehKfc8FXkKZJaB6W6IxJboBEo8kqgfKiModTM2SYnGfjDOF/W8dkxYEonKZAVhrQ0zMoCUcsia2sIfOXq3Aaqwr2eq5MIplmJtoJ2pFhq+Sy3Yuw0Ayx7owprBef6MZ04YLkVMMwq0kIzzTWfO92hHXm8fHPAKzdHrHVDVpoR7+y7CVenJOka2Sclkf1JRjf2+cbl/U+ED/5p4KMvAvktuFfmfDId+GH1tPtl7Lc+PslKtocpb+6MnOAQrpnXjRQsNZjWdem9cUpSaJSU/KHPrbDRa/D9G8ecyxsYM2MwK5C13OeFpZjn1rtc2Z8AdQZnYW+So40bmbYWpBA0AqfXPMtLtHZ6KkJYWoHCGkc1bEWeK7ukJVuDlPV2xKx0DavLe2OwbvJPwrz2WuEyUCVBKkmWa7qRM6jIK402hlYQYIHBNGcwK4gDRVHWI+CF408XpWFWQDu2xJ4klRKlHCOj1wiYZiUNvy55AO3QQ+P0y2dFxdl+g9Bz9+hUO+KF833nABTKuZ3c9cOZ45aHPkmhefdwhq8kN4cpRmteN5av1r+31PTJS0NSVLV2S+40VgJnhbc5yFBSEnmSvHC9Cilc1mxqWmbDdw3FNNe8czhlkBS0I4+yFskCj6R0AmRL1k2wXt2fMEhyRqnBw31RT9TgT/TLI09RVrW6oXE/U8I1NB13qC6ZyPd/di8I3O+D6wXM8opCGwLP/X5RWSeXKyWFdp+pSjttFAMYDc3Q7bCMMfjKpzKgsSy3nOjYpTWf/UlGWTsSfelsnze2R6im4Ey/wRMrTQYzZw2HEKy1Ql7ePCbXlvO9Bqf7Ub170M62ri4bhZ76UP2gHzY+LaYWi0B+C+6WWR/PinvW0+6WsQtxuw72Witia+gmMLV2GdUk1xzNclaaEe1QkeSSylQ8tdpmpRWwO8p4Y2dMO3JBxxjDcFayNcpZavicaoeMkopvvXuIEK62+d3rUyZZUXO7DUlh5xla7LtzK0pnwIsFoSHwBNoqpHAc76NZzv4kY5xrF4grww09Q0lBWlgUuAbcLZliYdxWu+FJ8rJib1wwTSuUJ3l+vUvgC97emzJISyJfUmpDszaC8KWkGwcopclqZT03Pu94zHmlOdWJajcjx2tfbvl0ooBprvlXvtgn9j12RylJURH5imaoUFLcZk13PMvpNAJGWcnbBxMkoI1zCRJC8PnTHY6mBW/ujHlmvc1PXlxmmJZzA47Dac4XzvS4OUjQ1ikwlsZQWRDSce21FVSyVgUUuEzdQBS593xjkLDeiTHWzq9Dkrkm3+4oZ5g4it4o00Sq4GToV+GCuJTQCF3PoxE6k4uToRtbB9V6wn+OoC5n5Ob9Movi9ow9VG6wx+nOQKYNSalphz6Bet/ZaJy5ec1+7Ne1cHcsT0FauGvhS7fQRL7TJ5fCcjxzA0/aWOLA0R/HmXOeOpoW3BymDJKcjZ5jrGwPM17edDMDgRLsjXNWOyGNWjTsK+f7vHRj4ByNau/WaS25rKTg99+itPjDwkfxrf1hYBHIb8FHFaj/sO74/iSbZwonOtiXdydcWIoBD6UEK+2IlTZcO5yiMUxnmlHiHHJk0w2IlNawc5ghheDm8Ywr+1MqbVlqOJrYW3tjlpohrVCxOcy4eZQCTsa0qNkNJ1ttJZ2XIrjx7fn228LuKCP0Be3IJw48hrkGY6m0+6pr3G5CG7cASN4f374Vxrix7civ9VQSl7ofTFN+5qlVZpnmPa2xxh0kKzVx6HGmG6OUQCYFp9o+OyMXcOPQOEf31A3gKAHPn+mipOTzpzu0I5+Dac6ptjPaUFLwzKn2fNgn8ORt1nRv7Y7pxwEvXR+gBCghyUrXdLu00nKTpkKQTQxFZejFAeeXG/OhlFc3h0jhFsPdkZMX8JQkkBIv8tHWMh1XBEpQOUoGUgpagaSsXKZqrOV46hqaWEHkO2bQs80O7x1MaYSK1XbM0bRkkhbzYHvibWQtxL5HN3KGEUmhGafVXAgtcIO/VEDDd01Ix3V//4YJbg/ivnTWc5WxyPpzUVYGa90wUNNzNXJjndJhoNzfBYLAc7TUrDT4nsUzbo7hOCk4oxuMkoxR3diMfXcdBon7LDlFSydTcarWKn/xxoAvn+1ytt9gMCsQOLZTtxHSb4Qcz3K8euuwPUw5nGS8vTehGwec7sVIAS/fGHzoyP6jxqfF1GJh9XYLhIBXtoa8eH0wpz3dmlmfWJedDCkM65t10h3PK813rx/z+vaQg0lG7LuVuhMHfOlsHwHsjnJ8Jfipi8vI2jex3wgwdaYzzkuSeghmnJUoIYh9ycubA64fzkjSal43HSSF42NnmpvHKZNMM84qhqlmWlpy7TLmk1rpiXaGG5eGyHNfeomjrTUDD1XrXbd8ySwrmZVOS3xcM0IagYcv775NlwJCT5JXmqS0FHVzbm+c891rxygFnzvdqXU3Ajcxihv3NxZGSclbu1Py0mlVr7cjrKHO0ktOdyJ8JVlrh5xfavLseofVVkheORnWVuiytaVmyGo7YpyWXDuc3WYntzfO6EQ+7dgnKQxSSk61Q2Z5wWs74/q6avYnKb/51h5pUc3v/6lOxCyvuLo/ZXvoJid3hjmhLwl9p2WjhERKiaeEC6yewgLN0CMMFYEn54urkK6mLqVknJWYmoGi6nRaCclJYq2p75+BaVqyP87q1xMo6XZVnnTHVKrOyrHMCkOpLaW9PRs/Oa6oP/uVcaU+W+usgJMYFlDLCDsjCiEsjdBzzdXAvc+s0HQij1bg6JS+lCzHIdePp063vd4telK6ngCOVrk7SikNXFppoaTg+tGMstK18bXlqbUWZ3oxK62YXhwQepLjpJybjF89mPG994aMkor9Sc7bexPS0sw9b3/YONmN34pPgo++COQ1honTA59mJYFy9d4fbA7Zr70uG4E33769uTNma5DyyubwtmNoY/nCRpevX1im1HD9yH2IwTXKvnimy2on4tn1Dqd7MWd6MZd3x7yyOQJh+bmnV8kKJ/MJlu1RyrevHnF5d8KNwwTfk6x0QgLltuNVzVYZpjmTrELWjUfLXVgK9v2GVhy4r7HvSzzlvvxSShqeorKw0g7ptwICKZnmFcbWqniVqbm/7+Pk7x4uACSFcep5wgUTW1/frUHC9cMZu8MUgNWO20kczuqmZ6VZbkcY63wxlXTOQsPU+Xe2AsVyO0TVqoBv7IxJiorT3Yhh6rwpT3cj9scZr20NWWmFc7Pnv/Y713hlc8hPXVwiKZz36alWxNcv9Flthfie4L2jlF7kYw1sjTIOpyXWwt/+/ibG1HXuUvP9m0NeuTnkcJI69x4sceDYJtY6lxxrcYM11HVk4/S3m7WwWVZW7I4zDqcZw6TEGMPuMEUJQVEa3juakmtDVhm895URqKwL0kiJJwX7k5TjWUlaubp2oR37BOHs/ZyImit7nUDWB5Pi/X/LeuHQ2tW6VT16H/qK0JNM0pLrhzMOJzlFqZlmFYNZSVo66mGpHdXR8yRLrZD1fsxGP8KTkudOtXlqrY2UYq6cOC40gZIIIcC6HddhvUt54VyPaabZHqZ4UnA4y7l6NGEwy3l9Z0RRaS6uNHllc0hlDGlZEQUKIeBgnHPtYMrF5eZD+X5+VFxcac69Ya21H/CJ/VFhUVqpce1wxmo7YqkZ1vziinbo0Y39eVPn7b0Jka/oRD5ZWd22fbuzVrbcdI25ExcbgKVmyChzmdTmYMbr22PGWcnXn+iz0op4fXtM6Ev2xjlXj5wxhJAWaQXtOOA4KejFAWf7DY6mOdpakkJTVgZRj2nfk2Ym3PCHNhAqxbSqUNLVoU+aZpEnGCUVZzoRa+0IbMZglmMMlMbQjDysNdiqDipA6AmEgjy380VEApGjxGCFY1IMkoJjZwdKO1RMs4qDaQ7W0gjiejEStAKPQeKoirrePfjSBaWdcY4UEE9yOg2ftXZIK/L4/IYzj6iMndex40Bxedfds0bg8dtXjmiGinP9BmXHsj/J6MQ+P/f0Ct9+9xBtDKudBgJBPtXEgZuYPJxkvLU7rrf4zgwh8J2S47kln17f53hWECrJ3qQgq1zj1lM+aeF8Tq21VEZjrWCcVpT1jdIGQl+TFa6o7QalHJc6LXSdKbvrLOtsXQD9yGdSlHOxMV+4EtktU/VkudNH8ZT7optb/thbsnNZSyxUmvnz45ruCoJcG8qspLLO2FlXUJqSyHNUR2Mg9CAKJEU9MRxIwe44w5OCOPI4XcslH6UlnnTj/uPMfXZLT3IwdbsLYzOEgF4zZLUV8t7RDKVc09Nal2Cttd2w0Dv7E061I7I1zdGsoNLQDN0wnKckjfCHn6c+7FT3DwuLQF7jpNYlhJgHXlsPJnRin9e3RkS+mvsNCiHn27evnA+4sjfhxnHCMCnpN3wurbiR+rmLzeGM41nBRi/mjZ0Rm4OEUluywnBlb0roK5LcUbCOp86iLfAEHtJJplrLOKncsIjvpvtmuRvswUKv1nq+VyA/Kako4cbVZT0ZKAREvqId+IzSEm1hZ5zRiQOOZgW9elGyBrJaZa/QGh+3nQeotHP1qepdZh3D547yEjd4IqFmQVh2Ril5ZTjVjZASxmlFVrop1LTQLDV9Yk8wMIbJtORMv0noCQ6mOTuZ5qtP9HmizohurYd+4/I+/UYwX3i1teyOnYXchZZzVSp1xec3umyPUq4ezDicORGnw2nhAmUjIA4UO5Occ/0Gx0lBqBSFFnhKcbbfYHPghLx8JdzYv4Snas/TqDZyOBSCUBlOdUKOZgX7k+y2e2SArAQltFu0JHQCj1RbBqUbRvLUSRPVad1YC9PSDVlp466nkyIwVI6eTlG54CylYxhV3I5bzyH0XA2dumEb+hIpoSgtwoOlOMRYy+FE0w7d9XSlLOOs54ShHbtxfcdGgXp95nQ/ZpiULDcDksrp2+fCoK2ptXac8cUsr+YSCqttyzOnWzQCyele7My3a9vAjV48N504aeGfW3K+rqGnMNZRFO82pfnDoAp+Gvjoi9JKjXvVui6uNDmeFbVusiUrHfXpZPt2/cg51UzT0nHCS8t33zsm8hS+Erx4/RgEfO1Cn6x0IkvaugEaTwl2Jxm/+eY+V/bHHExyCm0JPOcUL4TA8xSl1swKN7ExSEsmqctYV1shnnJZm68UzVuyEHXLe5FQ61JLug0P33OWYS54WDwJx2nGrND0Gj6+EuyMEipjKSpNVdPFepE/n7JDuOap84h0EqftyIlulabmNNs626uzRSXB85y1V2nc6+alxhhBUbkdxiyvWOu4uvcgKTHWEvqKceLq3dNaCvZolnPzOOHtvamTOKh7Fp3Y52CS89bumKsHU17dHNaNS5/IVwSe4omVFlf2JrQjj8+dbtOLA061I5qBq/068+mSotD87JPLpHlJUpTM8gphLYeznDO9GE8I8sowzSuywtCOfNY7kTtGaehHPl+90GepHTLOq3nGe3JP4P0JzKTQZIXG96RzEvJdeUlaVzYBF5iFqCWF60WyrNzPZF0fNzVrpOFLd5PuaGjc+qV3dXq3GAe+a9R5StHwfJqBhzGCWeWYJkZAYdznQJ1Mk9ZDas3Q0SaVgrSWO750qsW5pQZSwLsHs7rh7HatCqeUeaobsdwMyLWhqr9bn9/ocqb/vqzul870+NqFPs+uu+Z27LtBrafXWnUfCS4sN9HW7cYuLDc+lP53QhW8W6/rccYiI69xL12GXiP4gN3YheX2nJ/87XePuLDsOuyVtjQjR5F7e3/MLz53ak6P2h6mvLU7Zpa7YDVJS4rKMElLZllJaU62uRKL+8Kc1DHTUuNLRSAkfujcZBqhIvIk/dhNzikpOZhkrlaNG7nWJ9S1euqvHfpEvsQvTE1dE4zSClsPDHlKUtWTlo3AY6MTsj8tUMrVSkvtsuXAcxngSWYXex6n2gFSCopKM0oqSq3J6qbryfMKA2Wm8RV40g2UHM9KhrMBUjrRJykFfq1tkuJ6AZ6yTCtDUrrG3mo7ZGuQ8cb2qHYYSmiGip97ehVPCn7jjR32JjnWGIapJvQEP/vUKnnt3F5UmvVexM88ucrl3TFPrTXZGWa0QjhMYJJWVAZ+8bk1nlprczDNOJoUzjDBwlIjJA4UvaZPp6ZQjtKKtHSiV1k9udkOJSutWmbVV8h6EjaQ1OPsjgV00nD0lWJzmICQc/5/ecILr6+jL0AIA8ISei77NsbSCH3Hy8exSASghcGXruF5kqYYwBPv18qNdtz3vIQEjZdr8lDXAlyuTJIWZu5mlKHn5+zV1nOqrmVbI4iUdCqTaUXsSSprOdtrcLYfo40l9CTfuXZMpQ3rnZi80jRCj1lW1nTUkuNZjhBOaO1uw3hOCbR0OjXacKYX8/mNDj/39OqHZtmfFqrgDwOLQF7jfrWuL53tOfnRwPtAoP/tKwec7rpJtcOJm7zsxL4bjb6jvr7cDDmcjNgbZ0ghnSuPpyg8zWhWOEqZLx1N0Fq6jYCjaY6SkmaoagMBOeeiy0BythfjeYLIc+JL3YYL9Gmh8XBB3PcE3UaAr4TjBsduTNwCgZRoo1HCqTDm2vHYlBRMC4PyJKu+ZFpqWn5AVuUESjDJnJTtNC/QWrM/y3l2pY1o+JRVxuGswlMgjQvgJ/Vzi9vu5/r9DX5UMyVybWkFHsMkB1wJCwmz3BAGjh7pBJ0MobK8eGPg9EaA946mvHxzgNbQiQKGSclBUqCNq/m+tTvGU4IXzvV5dWtE6Eku7455+eZgbp82zjQrrYBe7Xjzk3VzdKMbc7ob0/A9/vmbOyjpBJwEAg18+Zzbbe2OMyaZphEodFZy/SilqCxfvbDEk2struxNmeR63jw9Ca4Ct4gLCVlmkUJTam6jHooT3r5wu59pbvGUoBm5BcHgmsS9RjDve+SVriduXSNcCbfAx6FCV86TUws7V0c8oaROcoMvDL4S7I4q6p7kh4hvWaSQSGCSVa5RHTptlEGSkxUVaW2wHAc+o8SVF7+40eXq0ZTD2tEoKZxFYT+OqKzLnl8418f3xLzk8mEJ1s89vfrApZJPC1Xwh4FFIL8F99dl+PBAv9qOmGQl3UZIc7kFwCjJiQPvA/X11U7Elb0pRWVZaXu1foSTBm2VFq0t653ISZdWbqLQWEHsSXqxz6wwjpnigdZOZ+Pa8YyVZsjTp1rkZcUs16y2nMZLqS2z0gVpYyyHSUEYeDxzqk3kK7577YijievuKwmDWU5l3La81IbSGBq+otCGQhumWeqybAGBL+eWZ8JaPCsYZiVSwKluiMWQVoaicE5CdxsXP8lGg3rnUlmLMM6mTGAIpMQoS8PzWG4GaOBwWlB4gmlZESuFkIKbRynDtOKZtRZFZTi71ODiapvNQcLBOCP0oBmoWhNEkxSurtoMPK4fzbAWzvQies2QJC+5sNygMpZGKPm5p1cBl71t9BtM0orTvZi1dshGL3aTvwL+4HOneOXmiG9fPWS1FfHcepsbxxmvbg5RgtrQ+n32ELhBnLDWoHG1cFcqu7WOrQF1S4N0mps6uFry0pXivnSmx/mlmK1Bys1Byt44o9IGIYRr3MItjCCJ8qQL5NYtIidTndhbRLhwg00nzdmTQA8uo499hRKQ1l6fgZJ1n8PtGCbWKSReO0zoxD5nerHbKVlD01cMZiWdyKffCJhkmlxXnK6nOqV0CdTJdb/1eweOEnwSwL987v6c8YcxgHncsKiRPwROgvkvPLt2Ww3up59cZpSWjJIcYwyjJGeUlpxbinnpxjH/6NVtfu/aMfsTRy97cq1JHDhN6W7k0W8GiDqItCKP0JP0ms7TUAjJ+aWY5053kEJirGE/ccpx06wizata4sLyzsGMC8stVtohvlIsN6PaasviqzoYVwZrDFd2p87MGQh8gV9P9RnjgsiscLQu50BjGcxKkqwiUAq/rslLnMlzqCSeUoS+Ypo7loY2lk4c4EvpZFfvcV0t1INL1k0HZhXT3FmONWqDhkaoyLVhb5zT8pUrtWRuSz0uKsZZyTir2B9mNR3OMM3cWP1Tqy0urjZ5eq3F/iTnvcMZWeWMEJLC7UqwzuG+E/tzka04UDyx0mSSlfyd72/yd79/k51RyqXVFs1Q0Yk9p7IoBb2GjycFVw+nvLE9ohlKltshz5zu8cRyq3Z+SljrRvSbLnCcTET6dYMx8ATTQtMI5FzY7FbcWhqZKxb6AimkmwGQjt1kwKkXWkNWWseVx5WyWpHTaM9LzfE0w1Mu0/bq+x94Tv8+kK5sYgCp3u+3yPqPhzNtrowl14ZQSdqx201W9VBYVTr6JEBZl9te3XTTtbPMFWdOtQNHkVSS8/0GzVDx8s0hvdjn0mqLa4czfnBzCMCXz/Vus2l72Fr3p4Uq+MPAIpA/AlxYbvKnvnqWOPDYGaXEgcdPXFziu9eOkQi+sNGhqCp+990jRmnB73tyhV945hSr7YhppvHrLGZWVFxYarLcCgmV4BefW+PzG22eOV1T66yhMk5fRCnBUivECjdFt9aJOb/UwFj4qYvLtCKP4zRH1Y0obazz4JSucRb5kqDWxdbaIiX0Y/elOmlkhcrDGMtxWpAUhqJiPkGolMvuikq7L7YSLLdck7QRKFqRRyNwzd67mKHPIe741/tDMZJCW/LS1JmzotsI3E6h7p46GQJb/zFzxovvSYZZicWxexqBsz/rN0OeWGmy3Ax4YrnB9jBlkBRcWHGONDeOExDwxTNdxqnmb3znOi9eHxB7EmvgN9/a462dCc+ud0iKiv/hlW2+994RUrrBmaNpztu7I64dJry5PeL1zRH709SVtAon+HUixhgoZ2RcaPc+PCUJlKDhu0XxftooutY/EdKSaSfA9Ztv7RH7HtNCs9Ft0Gl4+Mrd86VmWEsCaDwlWavNkJVyfRkXxN3dMDhuuakXbFmf80lt3OAmP8vSLfjGGlqB78p9uN6Otk4RsRn4FJUgLSqmWUVWe7weJXltVO0Git7aG/Hq5oj3jmacW3K7nA8L1rfWuoUQ87+fDACdNDW/cXn/Qwf3TuQWTvxaH1fp2luxKK3cAw9KVRombqBlvRvxzHqbiytN/ulru3Rjn24jxPMUFqfTPM0rlBRcWmvSiT2+deWAXqyAiLzUZFpjK+HG5FOnKbLSDJjlJcezgmbg1Xz0iuVmSFG5BeB0N6YyhveOZiRFxXrHie0PZyXW2tqEwCBw2erhtEApRxsUgLCCcV5igMgXtX9oydH+7SPilQVTc9l0ZRASerHPM+ttvnJuic1BQl5W3Bgkjq5XWXzPMSvuFpgsUFgoclPLGtQ6HZ6iwjF8qsKVEry8xFrPTUcaW4+luwEhay2BL7l6OOPJ1RaTpODm8czp3HQivn31kIurTbSxtCPnyvPUWpurBxOUlBxNM5aaAWd6DZQQzPKE3XGGNTUvu9T045BKW/bGGX497NIMPY6nBVf2J9w4SlCeG04ZZxUvbw4422sQKklWVOwM3dUMPUfVzIXzvexGnitLSTdyX1TmNqEsuL2sIerHjHbMkVJrCmHIS81wlmOsm7hUQhCHkqqEtNZ7D5Wjt1QGtHFywnktgmWMJajvlxUWIetavrn9fp3solzT2k2unuqEzuTCWIrKeTCFyj2GNGhtnV5+rvGU233EgWKWVhwnuVtMlMIYy9/63iZ/8Nk1VlpOeuGkHPLK5pAr+1MkbshuoxfPmSyDpLiviNWngSr4w8AikN8FD6pqdrfn3TiecWnF1cubgceFlRb7o5StYUrgSX7+6VVe2RyyO8rJtebcknQ2bbOCg2leb4sd3/ZoWjgPTguV0WwNde0E47KrUsPmIOHagQvipbG8sz8h9BXWuixV1/oYzdCjrAyj1KkPhr5wTJvQJ6knOKvqJGA4euDJl3juKnPLdfLq8fnLO2P2xintwDV5A08R+7VK3v1Sy1vgmnGSMHBfaF051xkt3Lj7qV4MuIGPg4mrAVe1IbA2IIxld5hSak235sGf7oQst0J8JZEI/vlbezQDj1lR0Yt8BonL3PfGKf1mwO+8c8CZXoNBUmG0xQrYHKS8sz+lEznq5ubA48vnevQbAXuTjO1BynevHxFIxbl+zFt7TokyRrqMXDophlHh3Jl0XXcW1i2ck7wizTWd2Ck7mrqpKW8Z8rm1Nn3yb1VPaGoLfr0DOk5KQuVq4EWhySpbl8NMvfBZmrX87rSoMFqQz6qawipZagRuUa957dNUz6eGT+69J6AZeVxYihmljlZ5MM3dbk66spRzJrIMZi77hZoTrwWTzM0SXNuf1YtAhBDOsHmtE5AWzmXp0mpr/tmotOHlG0OWWgGyTkgu7455dr2DkoJO7D80M+XTIEH7KLAordwFH7Z9Mwb+6Wu7t23Z7rbNs4i5RdX1oyk3jhJmpebzZzrzxcBa+P3PrHBhqcGF5SahJxmkJdujlKSwzoCgME6FMC1p+ophVlEZSxRIlJKM6kGKb76zzzSvjRtKzdE0p9JOHlbU3OVZUTFISgqtKbRrpGrjMt5pWpCUBl2ngLLmI5f3CMInJZGkcIMgk6Rkd5IhpWW9EzIr9Dybu1csF0DsuaafV9eG08Jt4qO6DtEKPM72Yy4st/ClYKMTstx0+h+eEISedHRNKQh8yXIrchOA1lIZwaWVFhLJ928csz1wmXbkKX776iFbw5Rppuk3A6eLYgSvbA4ZpwVHScnhNKc6EbuaOW/LtKjYGaVsDxMOJzmzwulsC2GZ5E5LvKgso7wEnBdqaUwtAVxbteG+gLPcMkpKKmMZpyWekMShnE9q3lp6OpnwPIG2UNTR1fG5PSRuArIoNCcEUWMhKTSdho+QkihwzjutQFFoS+x7rHVi/sjn1/nCuS4rLWenJ2t+euhL/PoeBd7JJKhmf5LjK8nTp1rMssI5QYVOx2a5EbqSl3WUQwtkdePbl4J27NFrBCRF5ZyMsLQjhdZ27oh123fyaMZSM+DSSqseNHP3/erBdF7rPjECuRUnvPM78ePEK19k5HfBnVSlSVZy/XhGqQ2fO92ZZ94n7t63IvYVF1cavLs/ZZxV9GJnVjxOC55ZazFMirkaX1EZzvQb/N61I16+OUAIyXPrbfIKtkcZUrovaFlp+s2QaVERewKso2V1QvdFUFpirBPe0tYSBR6H0xyw5JWdC2YJYFbWDSsBYSixhcUIg3TfJRC15sZ9rpGlHkQR4HmSWanpeR7TTFO2rNNbN8YJOVk+YI5wUjoIFYSBIlKuWVppg5SCZhBQaIuxuqY7at7cGTnzYj/g6VMt3twe0Yt9As+JfJXWccyLyjDK3JTsrKj4x6/usD/OqbSh3woYTguOJzlKCFaaIac6EanW5EVFkrsBqMATZKXzFr12MKMsNdN64rQRelSV4fLehBfO9d2uQDpWyihzmXwn9ubOOePUyavGnkIKVy8X1s77B5VxkgbaGrQ2UGvVKMltrBFTX/iTpuPJPYprXr4xrryUFgYPgdauVHLCQpmmlXO8nxWcarvMt9SG88uu1Of6EdJJ3BqD1qIuvVl85cpZ7r268ps2lnFeMskqQt8n8lw5RwvB7jBFSjeR2Qo8jC2JwtAxXZTAaNdgXm1FdBseSroBpl7T7Q4nWVXXyTXHddL0B59dqw0+2k5KI7MYzLwx+u7BhEApLq225n6sd2Om/DjxyheB/C64k6q0PUyRwHIznGfe8L67952UpqfWXO30BzeGHEwzsNBvhFw9nPHr377Ozz61wlIz4NXNIZuDBE8JLi632BymxIFPK4Srh1Oy0rkBrXcifE8RKBcwW1Ky0vB5fqPHt97Zpyt9R/HTJ/6OTsfiZOpTSadKiHWa4UVhyCqL8py5bmEgip3HpTCQ3uf63Dkd6MoyMMoL0lISjTwq4wKVMa45Ku37Lu7iluN4dbCSnqAT+SSlU31qhh6BsRyOK7aHKb4vHfc+9hASzvYbXFptM8lLxmlJhUAJy9E0J/IVceAWBq0NhzOn4RH6iqK0ZJVmqRHSjH2S3Fm3pUnF1tAxOfw6g7y40mJrMGN/VtIJFRuNgIbvUVSGw1nB0TRnlBROWz1QTNLKqUNay/44JfQUvYZHWhhakc84q2hKUZsm67rZd3JNLIGSGGHIKld/llKihcWrFc9OAv9JWeVWzZSicuyUZhAQKo2QAlVnuko4HZ7KGgQWbQyz3JVdzi01+Or5Xq1XYslKw9GsZJyV86GhylpiKTFS0PQUuhb0EjilxmuHKZEvGaUV4yxHSWdDFypFv+HjK8WS57RrrHVBMwoUS42AwcwF6Y1uxHI7JC8Nndjn+Y0OL9085nS3wVIjQKwIrh1OaUf+3K0pKZxxydWDKY3A49lTHV7ZGvHK5oAvnunhKXnXcf0fJ175orRyF9xJVTqaOQPgjV48f06lDQfTnO9cPeIHNweM04L9ccarWyO2hym7o5Rn19t0IscG2R1lJLlme5BwPC14ZXPI9aMZ28OMy3sTSu2+ZLujhLd2xsS1LKnBsjVMmWXOWSb0vLrZ5IKWYzzANC/JKkPoy3nJpNCudmw084ZgN/bxPPc7xji97zQ3JLkzyQ0jdfcLU8NSB+C6blrUxs9J5lgMe9OMrUFC6AkasayplI6pIRW0I0UjlLRCJ/laac1xkjNJS3wl6MY+03pMvnTUCSdXIB0z5L1DZyDxwrkuT6222ejGBEowTp3OdewpdoYpoa9oxQHjpKLXCOYj7hdXWzyx2qDhK5QQXN6dcDR1gVlry3LTTW4OkgIpBJ1Qsd5p8NULS6x1narf86c7nOnHHCUlx9Occ/0mT59q0Y6cGXYzCDjbj7E4nZQnVlq0Isc4ktLpeMeey3ixIJXzBvU8xzTRtbqVkxxWICWBB+3YNRBL63ZVCkhKN5CTaJfpa2PpxgFPLLnrYq3T1JG4xcEXAk8Jnlx1bJ2qHqI6u9TgxtGMvKrcc+v8xDVa3fLrS0Gr4dNtBCgpscb1XNwWzaKN0zUP6uZl7PtklZtlCJSk3/A51Qm5tNIk8hV/8itn+eoTTsYgrwznlmL+yOdP04l8TncbfPFMd66VvjXMeG17eBt9EJhn1p044Mtne7Qin7f2JvdkpnxaJGgfBR5ZRi6EUMD3gC1r7R97VMf9pHDnAFAv9llphfPt2iQreXVrSK/hc3G5ybWjGd9695Cmr/jc6W49Qp7wD36wzdnaIVwpwSApWGuHbA0TZoVzkn96reUCiLE8s97mW+8eMU0LTndi4tCj1JajacbeOKPfCunFHrPSMEwK4lDx+Y1u3bEvEVCXJ1yDKyvd9ltbMKXb/ud1JuWMyRw1Tdbqd54EjMAD7qwqenU25Su3QHi1jIepWR1zCV0LRVG5EX7rtuWelBjrasMCJ7blS8cN13W9wAUAQ5pDK3Db7uNpwSw3xKGbNC0qV6roxR7HSYE9Ejyx1GCcuQWgsk7FcVRTOtc6EU+uthhnBaKuoTcCRS/2Gc4Kt1MJPN7ZHuJLRcNXtEO/NlgOCJRkat34e6ldqWZr6CiKR7OAn31ylWFaApam7zLOSVpxabXJ2V7saJTSaYZMspKNbkwn8nj3cOr0xI1lllVEgcSXgspaQk+gpCIrnINSUWmyely/GfkYa2+TLD6xeFMSAuWonzpzC56q/U6lxJlYhB6R59x+Rnnl7r0QlMaw3grRymn5BJ6iEdTerNKZOysBpzpOtKrQlkBapnmFsBJPGpKywhhLO3Zm2HFt2Fwa1ytphh6B55GVFUopAqU41YnpxB5/8oUzhJ66bWd77WhKVE/fRr5ivRMRKHj3YMqZXmMuDfCdq0cI4XZwqy03oPWlMz0GSTHnnX8Y7iXL8bjhUZZW/jzwJtB5hMf8RHErVemkMXLi3fja9pCtYcbprjNKPmGoYGGt4yhTkf++GpsxjmtdaIunJDeOEwJP8tLNAb9z9YjYd8MorcojVhIvDhBScHG5yf4kZ5Y5ZcNLy008JdgepmSloRMG/MQTSwyTks3jhElWEkqFDJxV10kedesXfpqXtQqh6/wb6+Q/T5zdLU7JMBbvb9t96dgtFY6R0BTOwDkKHD/YuKl+Yglx4FNpNz6ujcGTgmnuIrhzeld04xAENAy0Yo9JLYR1YmIxLSoaVlFWThbVaCiFq9OGnmCYlOj9hIurTsAp8hWnuw2y0mWHuqYlVtrQDBWXVvuEnqy/rK4BPMrcVOHBOKUfBWTaEIcelbUU2rAzSDi35LLotXbIweT9IH66E7PRa7AzTslLw/XDGdO84otnemz0Go5pYw2elDQCZ3k2SUtWmj6VhSR3PQ9fCEZBOTeASAvtpmqNoN8ICJRgZJ3rTq/hY3G9kdCra+d1X+OE7dMOPed12Q5qLe+SYVHg1dOjvhIEniLJ3WvFvsdS0wdjeWV7wkY3QgKNwCc3BmkdO6qqnClz5At2Rjmt0KdV9wkO84KGr9yiLZ0FnGPICFQ9VyCF4HQv5oVzfZK84p3DGXvjlLVOyKXVFt3Y/0BQVVKSV06I7ER1tBkGfP5Mj3bk/AGcI5XGGEtWa5xPsorzSw2WWveuc39aJGgfBR5JIBdCnAX+NeAvA/+7R3HMTxtuvek3BwnXDqY8udpiqRkxSHLe3Bkxytyk5kmjxVjBM6dabA1zfE849/ClJllpGE5zrh1NiQMPY5yy4s4gnUfOE/fwZ051yKsho8jVnEPfI/Il3Vhzqi25tNqiMpb1bsTPPrXK23sTRmnJ7ihF17Zdop7Ss0I4kwLphI00FiEkvnKlFBU615bQc2JJZeVmySvjZFQDX7IUerQiD2Fhf5LTjX1akarLI071Liud2YKQzv1HWyd05SlXIjBAWrqmZqAUDePq2XnpTOTi0OnIFBp8Tzm1KOHqzlprKiHR1qIxbA8TZkWF1o7dvNwMqLQh8iVGMFcnrIxhoxWzP8m5sNxkoxfzzv6EV246E+xWrDgTNRyTxxqwTrSs2/CZpAWr7cgZIUjXR/CU4GCSsT/JyUrNpZUWB9MMXWfUCMvRuOTiWpMnV1q1N2XJUiuiNKZukBrSXM+bk5UpWG0HRL7HzjBxxtlC0Yp8wobk0mqTysDrO6N6AXaSsXV/ei56llWaae6cjza6EbEn2R6nzPKcng2YFSWzTCOFW4TTUHGmFyOVAms51Q3ZHCROf11JrLVOPbIZ8Ln1Luf6Fa9tjzmY5gRK0ot8kE7+IC3cDivyPTqRGxBrRT5VZfn8Rpf3DmfsTVL6jYA/8eWzZKXhN97Y5XQ3diWp2lS5E/v80vOn+PsvbdEKHVc+rwxZqXnmVIvLe2M+v9Hj5nHCmX6D3VGK4KTu7XPtaMrXnjj3gN/rxy9w34lHlZH/FeA/Atp3e4IQ4leAXwE4f/78I3rZHy7u5JguNd0N3xundKIAIdzwxu44Rwnp2AaIObe1FSp6zRCNYKMbszNKyfIKqQR7kwxPSc4tNTmaOi3xrDAcTnOeO93hxvEMbdyXNa+cqt5Sw0NJp543SgtEw2el7WiMs6LieFYwnOUcpaVrbNXlv5avCHxJUTnPRGOpx9BPsiWn3eF8QN37toDveUS+IC2cdkYkJO3I52w/ohV6dBoewkrS2mLNGR+7ycpW6CMFBIHkaFYQ+AKJJA48ZrnTpU6risizdK0PdcC1OCVFLxC1o4xlnDr2S6k1QgkqI+jGAetdZ+VWlJpZoZ3XqXTCWoESzKxFCzjfbyKky9z+9NfOzjOul24c87nTHRqBx+bQ7ZBGmQuuSy1nRdeNPbJK8+buhCQvkULw3OkOw6RgZ5Q5S7/aSeer55c4TgoGSU7k+/z819bcKHxSEHiK//UvPMl3rh3jCWrzDNdUe6bdZlYYOpHicJrz7uGMUjujhmaoiH2PcVZwc5ByuhPy9GqTK/szpllZO+4ItDa0axXGonK7oE7kjJmzyrn4KCEYpoVjt9QlH4vAaMfwWW357E1y2nHAhnWMnaNpwTTXgGOzTAvXa2hFHiuepBN5HE4KdicpcTPkbDcgN26b4EnBMK04nBY8tdp0HPWm78pAyum8bA1TPCFI8oqVVkhSVLfVtO+mOmpxNonTXNNvBIS+4mCccTTLOduPaYTepy6z/mFy1j92IBdC/DFg31r7ohDiD9ztedbaXwN+DeDrX/+6vdvzPi24c9DnYJLzW5f3+cKZHhLJajvg3Xro5qSup6RguRUgcLKqS01XJ//y2R55qZnkPqNZwXPrHS7vTVhrhEicc1CSVyjlygH9ps/WAA4mOYGagRV87nSb9W7smkrAmVqw39b0tpc3h7yxM3bCSwgqIWgELtMrK0ffC6SoZUSdhsj2IGWcVu7LGfustCJsPVq90YsxCKZ5yc4gJfBgKfaojOHlm0M6cVBvY10gO5xmdBshjVpnRQpLI/AZ5wVe7cCupKQROueZtNC0Q49IOVkDY53qoSclnieJal54WS8+UniklSH2nFnxc+ttokBRGYMnnOfnrDSc7kVY6+QGzgZO93ylHfDMqbbrddzyxXnfmKBBUjra4TQrUUpypt9kZ5QyLWZgXDaYlpovne1xpteg1wjmwmZRYLmw0qQZeCy3QkZpyFonYqMXM05LnjrVnn9pbxwnJHlFUhqMsSzVmjr7kynnl7pkpcZo52+ZasPeKCMOnFOSJwWnejGXdyc0fYlSPlldjrGuGUGpDdoKytIgpUanhTP0EMKZJ5eOkeOmLK3T0xGuTJFXltWWo3yGSnDj2EkddIS7fxbL1iBhf5TTChRZZYh8n0unAp461cJXko1+zCAp2TxKOJjkSOWGgrbGGfl7xzQCxVIz4HQ35tWtIRu9BqHn/Eo/jP53N9XRp9ecfk2rVgRtBh6qG3FuqcG5pcZ8AOnTggcdMPyoeBQZ+c8Cf0II8UeBCOgIIX7dWvvLj+DYnxju5JgOkoJu7DsWg4TjiatZX9mbcHGlRSv2+OLZHk+vve/g/tSpNn/qq2c5nhUf+EK/d5QwmOVY69xZ4sAjLzWFsQgheH6jy944Z1ZWPLPeptfwXWaW+oyykoNJxsXVFlIK/uXbB2yNUsZ5iS+gHQWUSY5Ugrw2dXAsCUllodvwafgeZ/sN9mcFQS5pRx5FXc/OS4MxFVnpsrlGqOh5AWmusaWhrNkyrUBhhWCSFnhK0goUgQgJPMn+NKcyBRZHb5zlFctNpzVtMXWt3Q2vrHcjJrlG4jjKvVCRlIayqAg9yXK7STv0wVpWOiHvHsxqJ3nFc+sdSm1pzzLeO0j44kaPWV6SV5ZSW872Iqa5/lA2wuluxO++c4hSkoavMNpirHAOPUWFL91iMi6cbvw011zeHdNrBPQbARvdmKI0dOOAZv05ySunnbPRi7m40pxnYNcOZ1xcgY1eTFG539keJs4T1rhy1v4kczs9BNOiZJprhDwxlbCM0gpPCJ5cafKOsZSzAl9ZwthDSsE4c9LFjcCdtzWWWems4Dzl4UmFF4CQjqKqtSXXmnFS0o4CkkLw1FqLzeOErWFG6EnO9RsczkqSvCT2PZRSbr5BuHPeG6dUxvL86TZfPt/nl55f56UbA660p7x7MGGUlBibE9aTuL6UXFpp0W8EvLU7RgrBKCtphx6TrKQVerfR/+5WxwYnnNVvBFw/npGXTkJ3bbn1qWxY/rA56x87kFtr/2PgPwaoM/K/8LgHcfggx3SaV7Qjt/WkFmLqNwJGaYExhnbg8fRam3bkc365yVOn2vOO+YXlD6qr/atfWOf//pvvOAU7T8yHWX7m0gpCQDMKWGqGHE4yKmNYboa8czBFG+hGvlP+qzQHk4JRWnKqGTCaFVTGzJkgSklWW5JRWpKVhshTrHcCXjjb5+rBjHbk80TodEtmeeUWoWFKVmq0cbzoYVJihCXQBl86pyJPuOnEwjj5VFUbCZzuRuyMUvzKBYCictliVjnVxMo4Jo0UzvoiKwyr7YCn1tqMU83+OHELGbU8a2VptRTnlpp85VyP9U7M1jAlVIqjpKAdBhhruLgSM84iOmHguNie4nCagnD3EZGw3PL5+VqKFlyGZIxlqRWSl5pRWrI3zvjCmQ5r7YhXbg7xlKDfDJnkFWd7DTaHCXujjJdvDLi40mK9G6GNIakMaVEBlnFWcrbfYKkZfGgGdmm1xaubQ75z9cg1fZdb9WfL4+YgwRMlnnK6Lr4SeJ7jnPdjnyBQTGqLu2muOZhltdiVpN8IKE1C6Ek6kV9LDhRY4+iGgSfwZO3NmmmakU8QSI6TjGFaslZpnlrrMZiVTu/ek3ieIpQCTzjWUVoajqYzskqjtWuWtyOPtVbI1jBFW7fRzivD928MyEtNpxHQb7ifb3RjhqkrPeWVM1ceznLiQLHS7HB5d/KhTcq71bFPAnxWOTPoVuSx1Ao+lWP2P2zO+mIg6C64cyCoVWcMaVGx0WvgKcmbu2PSymKSkrWOpRV6c27rs+v9e9bEzi01+MLZLr979ZDR0IkldUI3jamNpRU5q61G6DNOC/75W3tcWGry5GoTr3a2zyvN1sBJ484qg7ACq6FShkA5dkNibW3Y7JpZS01HX1tq+ZzpNfCkpBN7bI9SlpoB//LtAzoNn8E0J/Q8orouOi01F5Ydc2OW69ruS9S6IU6NcHuYuYk/YKkZUFYa2wo5mmRIIKk0wjqKXSOQJLmbmtyb5JR1fVwbw1Gi6UU+S62QRm2cAbA9SlHSDWW9vT9hkBTEnqLUhuc3Ovzhz53iO9eOmGaO+lhUxvHsgeuHM55Yfj9D3h1lrLRCfuri8ty56eJqiwtLDZ5aa3N5d0KhNdujlI1OXCsoStL/P3t/9mvZled3Yp+1533me8+db8xkcCaTOagyS6rKVlsqlFqCBNmQXzy89rMBv/lfMGCgAT8J6Ac3bNgNuBsCZKlVlapSVWVNmVk5cQ4GY77zcMY9D2v54bfPYUQwgoxMMlPJFBfAJPMO55x7zt6/9Vvf33fwbAnWzku+dnHAaltSkY6mKQY5Sb1xYfDUDmwUS1dpWUIAdW3F9c2ueHoXFffOE1qeTVpJcLJvxB7WshS7/YCkLGl7DrsrLfKy4iwuyCqBzzqewyQtSPKata7HWgdmWQnGLKl5t06jJg5O0/Zd2r5cy5O04KPjiPWuj0Hx6k6fW6cx50nJLJNNZW8UYzebgrJkMx/HJWUNG12PuoZ/+/MDvnt9ncC2pBuPc3qhy1lU0A2MuD/aNu8dzhi2fVByfU7SEstSzzykhI8L/KdRDH9T1q/aC/0LLeTGmD8D/uyLfMz/XOtxjulKy2N/nGBbiqqu2R8n9DyHb1xcoShrbp5GPBgn7AzCR45+T8PE3tqbYCn4p6/t4Ds2t04j/sM7h5zMc66uiR3t8TylH3hs9QIRWNiKDw6nXFzpsN71+cHtc7kBlORDdlsuswTGDX+47cuR228CiB2E3vfW3oStbsB5lHN9s4Ol4LWdPj+5PybLKwYtB78fSsG2LXTjjdHxHWZJwbzhho+TAkcpbEdRVBXvHZYM2z7rXdms1nshnm0ROoo4q9kObO6PU/KipqUksSgua8K8ktQiz1m6Lw7aYlc7jkve3htzdb3L67sDxknOnVHM9iBkux+Q5ZpaGQxys7yw2eXPPjil0kK3+/ZzfVZaHnfPYv67//ghr+322R2EHM4y4qLipa0eL271pCv2HeZ5TTdw+eaVFW6fzNmfZpRaWDOWsnhpu08/dDmapZxFOX/42tYTu79ZOvnUDuy1nX4jyxfGUJyXjJKCe6MEZQwbXZ+slDAPjGGjJxa0vtN4mSuYF1K8LwxcbpzMqbSYYdnKYpJWtD0by4JB4NEKbKpasGbHkqH1Vj/kwkrI6TxlmslkvBM65FGxFGMZY/AtJS6QBrq+hVaKeVrhucLV7wQejmUxL0pCxxb5fz/kNBa7iLioGuxdqISWpXh9t8+l1TZJWXM2l1NBktdcHv7mddNfxPpVc9a/6sifsh7H5lY7Hv/yGxf421vnvHswpeM77Ky0aHsOmaV4bafPziB8xPj+0zCxmycRvYYfe/885i9vnlJrzSyv6Mxt+qEU7rwSHvRZBJO0bDxfTtjoBmhtmKUVri0Ebde2cF05jnu2zWY/5NKwha0sjucpeVmz5QeEzYD23ijGKHh5SzIpV1oeV9baSxhpEGrunidcXGlRahgnwtpwbeGUg3RlupLsSFtBnMsR99Iw4MIg5HCW0g0cQk8Gahsdn7SoOItKkrLEsRVbHa9h/Igicdj1sJRFkheM4hLX8tgfpby+O+A8KsmKmt3VkBc3+4DAELOs4HvvHfP6bp+LqyEns5ykrPEdm6SsuTuSBJ+0qMWT4yyS4GpL8fVLq8sTV6cRfF3f6DKKJYfzPJL5yGrbW3bPF1ZCNnrBU4vOwx3YPCs5mKScxyIs2x4EeI7NB3sTai2WtmdxQVpIWHNa1ijLwrGlUFuN940xivWuz3mUsTcWJodvW7R9h0HgcjTLKLRh4CuGoYsGTG7Y6HpcXmtzFouVwVSXdEOba+tt5lmFZdm8eaFDbWC9EzCJS/YmKbsrIeO44KQ5UbUCB8t2UIifva0UrmOz2fPxXZuTecYr25Ife229w04S8OA8IUoLLl1q02+5XN/ooBqWymJI2R52uGQMp1H2iHL609aXzbXwV81Z/6qQf8p6EjbXD12OZylrHZ/AtWUgWNa8sNl9xGHtszAx1bB/749i/vi9I+ZZScu1cSxFWmr6oeDyvjb83b0Rw7Yv9L68ZhTnIi23Ff3QZpqUrLY9uoFLVtSstX22+iG7K60m7V6BNry4Jcf+aVKyN4kJXJv9UYIykNeaFze6fOPKCj+5NxZetpIjeOh5/Ks3dtmfSGRZWs6ZVzW2JfJ8S4Ft2Qy7Lj3fx3fkRhvHBbdOxfp1ZxByFolzYNYIclZCD2MMh9O84X7bWNAwRMTXuuVZDDs+53Ephaqu2ez5uOpjVkKlNe88mBH6EodnWYq00nR8h9N5jlKGstJ0PId7o4Tn17uyyUxT3tk3PLfeWZ64Lq62RYVrKXb6AZ5j8cPbI4pK8+JWC1vJxnFptf2JY/HDxUUpmKYlLVc2TAtJAlrr+BxOMu6eRQybkOYPj2cUteH5jS5FVWM7irwUD3nhhNdsdOF/9fJFwPB398ZkZc3fuzSg1vD24RRlYKsfSv5rXTNJBev+3efWmCQFqvGo+ccvb/GT+yOySvPWgwm2rbi61mGjF+LainvnCa6tKMqaKaBRbPVDTFd/TE01IrVPyppuU9TLusZzZKZwcVUamKtrHVquMIsuDltc3+jwxoUBb+1N2B8n3DtP6Icu24OQutYUlWGelfz5jZPP9P//6f0xWsMozvngaM6P7434g1e2lvOo38RC/6vkrH9VyH/BNWh5vHlphfvnCbNmyn552Ma2FC3/4+LyWZjY8xtdfnxvzA9vj8REyHckLNlSdALxpK6NqEBf2OoxS0tc22aSZdRGMitbgc3RVAQpo7TkyrDNes+jatRww7bPvSZYoRM4DEJXoImziHkiwRTzVMyRoqzk79KS37myyqXVDrdPI9KyZrsXsNoNyCvNB4cTsWtFrE1RTbCALdL0sjJYIcyzmrvjlI2Oj20MWVnzwcEM15Gbv9aGtmuz0vYYxQVGC92x7TsU2vDgPKbf8uj5No7joQ28utNjo+uz0fV5/3CG7YjvR1xUfHQcUdQVV7o9yloT5xVVXVOUhlJZFFoUoYsO0HMsXMdjklTM84r/4a/usLva5pWdLq4jNgpKQdt3uLLW4fn1Dn/50Rkfncx5ZafHpdU2lsUjEWFPopcpSu43jpnDtr/sNm+fRkzTEscWXv2F1TZbvUAKf5M+b9lgSknu6fpKYKSyZpwU/MHLW4ybPNbAtUlqoSyud33unkUMWgHbfckT/RdvXuBklvFXt86oasM4zRm2ha9tW0LbrGoJaX55e4XTeSEeNY5I4gdtnxuHM+K8ZBIV2JZFrTVZIe5n/UBUvOtdn+vtHmWl2d1ssd71ubja4nQe0gtdgWUCVyIR05LayPt3HuW8vTdhvetzabWN79hL6OFp9Lw7ZzFaw/1RQuDarHd8ZqmcyP7VNy8Anw5r/jaurwr5L7Gexm19GO/6LEzsjQsDfv5gQlFVeI10v9aGru/gKJgXmq2ex6DtEToWYy1FPW1sc7Oi5u5JTF5KcUrrmigt2ex1OJpm3B8l7A5CXt3ucTLPsC3FStsjcEXE1A09Sl2T1ZpV38MKFQ/GCX9965QLK202uh6TVNEOXLqezbv7E/nDmo7UApFtA6rWhA5MU+gEFaM4B2VxNpf8zCwt0bVBlY1NQanp+Danc+Fh90MHx1ZkVc319S5RWmJbsrlt90PysmZnEBJllXCEbYVnW6RFyf4opapr1joB/ZaoIldawpu+fRYxX9jHujbnUcrOIMAg9MnzOGezFxA6Ps9vtDlrXBMXyewL74+W5/DfvLbN7bOIvNJPZEY8abi53pWUpt+9toZS4k9/42hOVgqHfmfQarp7GToXtSH0LLTWhK5DaSuSUhN6Nps9yQZ9MEroBQ7XN4XlAeAqxe1xRJwL9XGjF2Ap+bxB7HEncc6rO31uHM/Ja5l9bHR9pmlJnNfcP4+XBXHQFhjgZJ7jOzbDjsvts4iu71DUFVqL4dabFwbsDkIur7XJiprnNzsoFHdHMfdGkXTy8Ehx/t57R1wddvjahQEHkxTHttldbVFUNVfW2s9Ez5ulJaM4bwLNZcbQCz1Oo2wZ9/bbYk/7rOurQv5LrGfBux7/GaVEMPTzB5PlUW+zF9BreYyiglIbNrseKBksYRQXVweNig2ySnM0TfFcm2lWcR5nKIQ9kJQlg5aP7Vh8dBzxzSurRLlAEWlV81+9sMErOz1un0Z8eBzhKDEyGiciZ7aU4mSek2QVcVayP8l5cavDpWGbvKiYZKWYJDkO4zihQV1wbLFVNUBSQcupmSSFBAg7hsqAUdByHRItgpt+6OA4FpOkAsvQ81wc2yIuNKEjmaJvXhowigpevzhgveNjW4oPDudEmaQa/dM3dhgnBTdPIvF43+qy3W8tqZOLJPdhy+P5jQ5VbTicZqx3fXSD9Y+Sgt1+SNt3afkWoeeilHi4LI7kjiUq3SgX4cnVYZtKmyeyJBZQ2gIPj3IZNiZFvTyZHUxSAtem5TugPh50lnXd+L44XB12cZTi9nlMnGu2+h7XN3u4tkXgOqy2PW6fxVzf7GFb8N7hhBvHc9CGqCiYJjVn85zfubZGx7f56f0Rf3PrnLMoY5ZV2Eqx2vHISs3BJGWrF/DGbpuDacooKZjnFdt9CQEPPZv9adowtUJarohveoHLoO2glIQv9wOPP3x1uLSS3R2EpGXN2/tTrg4fLc51A4e81Ovz4pacTo0x/MWHJ08MhHgSPa8XunxwNGe94y+/lle1JBs18OZviz3ts66vCvkvuZ4F71r8zMPH7kVn8v2bp8Jb3unz4dGckygnq2qyQoKGL622GEUFea1Z72nOZxmHk5SWa1MgxlKdQPwsZmlB4IiZ1KwWT+/XdvvUGl7e7uI5FpeHbfqhy8ksJ/RtZmlN6AqT4YOTKdOkEPWeEh+UvbHMAS6vtfmLm6f0A5fQawaqjZ92aQT3RX/slBi6DlmpyWtDN5SAAKVEjGTEgYWWaxMVBR3XZZZXeI5NP5CMyff2Z3z3xQ02eyHfuLRCVWtxmWy7fPeFNRzb4izK+fqlFb77wsYy4aXliQfMwSTlLC4oasO3rgyXBmbzrOSdgwl3TmNe3emz0fU4mUmk3lpXgkF8x2aaFkuM+639KYPQoxc45JXmrf0pr+482ROuF7qcznNuHM+YZ+Ijow3LIeBGNyDKqiX32iAReVWt+egkoh04+I7CoIUGOezyZzeOMSjOo5zVtjBvpknJ4TThB3fO6TVZoUlRNfBGwMZGwL3zhL+7d84buwNRkRYiCrp7FuM1m2XHd5mkJRdXW7R8h5e3+7y41aPdUGgFiqp4bq2D79hUteTNroQeqjFWGyclr2532egFjOLiE11wrTWjhicum1stFN6y5qXt/vK9S8ua9W7wzPS8q2ttfnxvxCwt6IXe0p/l4bnFr5Lq95u4frN0rL+l60lxcIdToa+N4pxhx6MTSFqQ61q8sjvg6noHxxHDor+7M0ZjGLQ8fN+irBVd38GzbYYdj52VFr5ncxqVDFoul9faDYc6472DKT9p4qsGLY8/fG2L33t+neubHWzgw+M5UVERuDbKFndAz1aMk5IPjufcPY/pBy6nUc7JLMMYQ9u38TxhS/iOTSuw6fkWw27AZjegF7hUDW3OArJK7FI922K14/Ha7oB+4GGQPFPHUeKRbYth9geHU8ZxznsHU376YEwncPnahQG90Fu+j4sj9MO+8R3f4eJqixc2O1xdazGKc358b8SNoxkA37m6xu9dX+fV3T6+a+O7FtuD8BOqzMUNr5YxwyCC/qc7S1xda/Pe4ZT9cdI4S8qQz7VYinY0UtzfvLjC1y+uUNaat/enhK7DmxcGeI7NeVTy8wcTbp7OWOt4FGXN3bOYW6cR41iyW7cGYhL1/tGcSVKy2fPZ7IWcJwXawKXVFnVt2BvLCS70HCzbZmcQYtkWd04ToqJkrS3D5qyBrgCuDtuM45KsrJffs5WweBasJIMhzgT+8hybo2nGX9085f55zDz7eOC/2vLYn6TcOJpT1oZe4NByxSd+cS0tPrvvPDd8xP9/8d8PzyEWa9Dy+INXtqgMnEYZjqUemVs8niXwaY/127K+6sh/DeuJsXGnkgr00nafw0lKoQ2OEj+NC4MAhcVq22eWlCKaaLm8fmGFSVywP0vRtcN5JEk6F1dCjuc5tqX4nSur5GXNrZM5z21IN6Uxjwx7fu/6Or3QZX+SYrRBGYlqsy2YpYCj8CxRhL6zP+PiagujoRfaaKMZJxK2u9lxmTYd90ZHsOeoEJViVrkYDa5rkZcaZYHBYrcfcnE1ZKvn8fbBjNC1Gpy2YpxouoHDoO3z/EZXwnszw3rHbzq6OR3fWQ7+FsyEpPF17zTsmK1+h1unAiEtOrYbRzMurbaXFNGra22+f/OUvXH6CVXm1bU2P38w4fXdAR+dRtw6jQChHM6z6omf8aAlnWovcCm1mJJd3+hhKcPBNOW/eX17OTexG8zeshTX1ttcWxNFbeDaeI4MIEdJgUKRVJqi1FRRQa+V88p2T2TtifirV1pzNi/ohzZJIRuGgibaT+PaiguN58s8r8BoOqGN1mJHPElKNvsCs+wMICs1LU+CU5X8D+tdH9uCNy6s8PMHYx6MY7JCPqt/+/M9nt/oNW6QOVFe8+KWKJxX2z7vHkoUn+9Y5FVN6Nn8/efWOItyHFstIce7ZzG2pR5xP/w0et7lYZt/9c0LT2Wm/LbY0z7r+qqQ/xrWgsFSa7NUEc6ykrWeT8d3ub7pcnG15oPDKadRRlkZWj68sNXlcJpyZa3dDPE8AtdmnpeczGv+3tUV8rJmltdsdH2+frFPWtb8+Y0TlBJcfXfQ4nefG2JbajnsGbQ83rgw4Gf3x3Q8hx/fHzOJZfDY8iTswbNr2rbcwFVZc2G1xQdHM1ZbPsrALBe1Zz90RWrecvFtxTgVJ8SVtkelDaN5TqsrRSstpZtbFIabZ+LgV2vDZs8jboy0+qFDbQwfHs84mKT88bvH9FvyPL3QZb3j8eal1SVcdXGltRwmL/xNrg473B8l5JVAVXlZc+c85ptXBN8etDx+//o6b+1N+Ohk/ogqc9DkqY4ikfE/ty4b4iwtOJymy9PN46vlWay22oQPH+mLatnJPz43ySvN67sDDqfZcnAX5xXTtGCzJ8Pdy8M2984ifFtRVZqdXsjts4iPTiI6nsOgLZBO3DCeHowShi2PrX4oA9/TmIurYugldgWiUq5qTVkLnDVNCzxLcdoEdr+y3V9CUsAyTq0buORVzfsHM9Y6NnujhPVuQFVrOr7L3jjhwkqL/XHCpaF0yK9s98Ve9iGG18JP5cpam++9d0ytNastsaSwLJ6ZXfJp8OZviz3ts66vCvmvYV1da/OXN0/ZGycN7GBoeTazRKbvKy0PY8Sc6uVun67vNJ2k+Gq7lk1aau6dx9RaIrsGLZc/fHWb9a6/LGJrHZ9//9YBoStBBrU2HEwToqzPVj94ZNhz5yxmtePT9l0ejBNmaYHVmER1bBvHslBK3AELbTBFKZ2V69BrsO95UYnjX9fDMkJDfG13QNt32OwHfHA4W4qLLq226PouP3kwZm+c8Ppunzd2+9w4nmGj6IUuniPUxvujlPcPpxS1ZE2eRimztKTl2/RTl71JiucIu+RJzIRZWrLe9ZfY7CyraPvOJ6xNBy2P776wwXdf2HjiZ/bje2MJqHbsxmJXgj6exn54fqPLuwczlFJNB6qZZuUjuPrDc5Nbp3P++N0jjmYZV4YtLg47Mij2HIE2UKyEHnHHxxjD7iDknYMpKy2PKK84nmWYU8F/y1rT9W1Wuj6Djsdax0cBN47m3DyesdYk51iWwmk64EFHM2x53DqNuXMa88pOH9tSBK71yJB3uy+Okg97Bz0YJWRFzUrbo6zE7Oy5DXGYXBjGvbglm9ZihrFYSVGhFHzvvSMcpVjtBORVzf1RzKXVp7+/X62nr68K+a9hLTq8TupS1NANBMsFmCQldnNz/e5za1wetvnee0ecRjmrLZffvbbGX948xbFlwJSVgl9eXm3z/tGUeyOb5zfEoOuP3jlisxfgN0PMGjgYJ/z/3jrgd66ustoRI6dZWnLrdM7uoMXBJGOr6zOOcg6mKUlhuLDSIsqEix26FudxziguWO+Igq8fulwattjuhfzw7ojNbkBS1LQ8m5bv8s/f3OHysM2f3zhhpYEcFmuj5/OzB2Pmeck0LXh9e8AoyblzHjNNKozRGKVoezbrnYCf701wbUfCJrRE1vVdm3f2JvzBK1sAHzNFsgqN5vmNLmlZLwN6QYrHL2JtOmh5bPcDkrx6xAv7cXe+h9cbFwZLnvQsrXEcxWpLnn9xSpLXK+nw8yb1KXBs7p4nkjdaG7b7IbdOInotl6LWeI7QTrNSjKaiom6eo6Tr2QSezVbP58E447lNj5e3e1zfkGiAlmfz798+lPzOtTa9wOWtBxNW24K/W817HTg27+1PmKYV33v3GN9VDNs+2/2Q+6OEbzUnmQVMGDUMpLLSuI54i19alVPY71xdXRb9q2t8goZ7Mhcf95vHEVs9H8exl3OKUSyQyy+6PksA9JsoEPoi11eF/BdYn+diMAbe2B08wif2HQurDS9v90iKanms/1ffvPjI83iO4uZxTFyIl0ng2QxbLm3f4dKwvQygPZ1nbPdDHMfmw6MZo7jAdxTTtOJknrM3TvBtm/Wuj2fb3D6LeW6tw/4kkQFk6PFgnDCKhGlQ1YYM8TGxLcFAPcdhsxvw+u6AH909Z5pWtOOClZYnjoe15k/eP+K59S5H00yyGz2bj07m3DyZczDJqGvN339+nWHb5/2jGVFeNukvFXFR0/ZcQkeCCYpK4JbVtk9RaTqBQyd0OJxkS7jqZ/cnRHlFUpT4TVFo+Q4b3eBz+VosLGcf7iZPZhlnUf5U9WE/dDmdZxgUm+2ASusl6+Ot/SkKQ+gKNl1pw8WVFi0v56OTmKjQbPYEYpimJdoYyrrmwkqLXiCnmdNZxkbPp6wFrvIshesId7zbnPYWRbEbuHzj8iq+a8nwtYbzKGPY9bg/islqwziRnM20FOpmVtaAoqiEYlpUNZ3A4eJqyE/vj7l1OsezbSxl6IUeR9OUoqoJPQm1sB8TSg1aHtfWO/ztrXN5zrLGGMH2+4FDWhjuncVcXmvTcm1OI+nmf5H1WV7fv2ov8N+E9VUhf8b1eS+GBT1tnBREeYVtiQTftoWa9/Aw5nF8b5aWvLDZQynhNZe1eaIZ/3o3YJ6V9FsCKwSlTZRWrLRc1joeWovR1UYv4Np6h7f2xtw9j1EYHkwSpg0dLW660GlWstH1KWvxDp8lBVFeMElsbhzN+Nvb52x0fTAQ5zU/uT+mH7pMEpcXN3tMs4I///AE1xbzpiQrmSQFYPizG8dERY2n4CQqJRBBi6zetiQAdJaVDDsSulFUejkYy8qaS2viO33zZM79UUxa1WSNM+XBNOPFLaFdfp5h1+OirtN5zjv7E17bHXziGoCP1YTfujz8BI/6xtGMQegBhlunEVaDVcdFxYtbfXZXWtw7ExWu59j8szd2loIqDZI96jp4Ky02uwGTdCa0yFI3KseUnX7AKM6JspIPjkouN0yOf/Ty1pLj/f6ByOCnqbB8HAXjsuRkmtENXJSy2OoHpEXjRe9JmtFP7o25tNrmxc0eP7w74rCJEgxdG2MMrUCySP/gla1PdMK3TyPWOj5xUYndbS15nLOsxHVsQseR3NSWh21ZvzC75LO8vn/VXuC/CeurQv6M6/NeDKttj7+4cUI/dOkG7tIS919+48IT/cofXg/L/aO8bnjNMlSEj8UO33luyL/5yR4Ada1ZCT08y+IfvrjBwTSjGzjCXEC6tatrHf7o3SNqbUiLirWuxzgpqeuaohbFZVGLj3le1by2MyCramZ5xcGDMRtdj41uIEET04ykrDifF7yw0+XD4zld32Wz63PzJCavaoaN5WvbdcSGt6gY5bUEWihJ/qkBzxFrXQvF9iDg3llCWlS0fBvPsfAsxT96aYOvX1rhP753xNk8Y9D22VnvYivFOC64fRrzT1/f+WU/buCTw8mzKOe13cFyEPjwNbD4/4uv1dpw/zzmaJLy0naP0yhns/vxANG1LcCQFDIIdSyLK+ttXt3pLwe2tqWWPtvHs5QXNrvcPYtJy5rAUSR5zTwXj57tgagoO427YF7WS3dGkA3w3YMJD8bSeW/1A3zbpqw0cV5jWarxRRGaaKvtk1UyzJ6ksqEuDMB8WyyXs1IvHTa/cWmwPFE+vBb3zYNRIsEUyiIIREiktd1g8oqjWU43dD+xETzL+ixfo1+1F/hvwvqqkD/j+rwXwygueG13wDgpmOc1ncDl4mqbUVx8ZiF/uDNsexZHM3HSW+v4cDRjpeWx2vG4PGwvHRrjsqYXSBEHeHd/zFlUMOxKBNl2P+R0nrPe8bmy1uaDozl5WZOUNeOyxndtAkcxTUsC28axLXzPYncYMksrbhzOGbbFR7rWMpSsak1ZauaJyL4nScXhLKfUNSuhR6VFFYgR10RjFIXWBLZNJ3BoBw6nswwbsFHsrITMsxJno41jKVqe+MdcW2/zu88NhVfvOFxda9MNZeh7FhVMkkzyS5/CLvlF1sOnowXm//B6+BpYfG8BnbU9h6SsKWvD2VyCilueiL2iXHDy2hiKBwIRvbrbW0I1j/ts//T+mHcPptTG8NbehLzUnEUZLd/FsiwCV+Cb13f7tDyH59Y7fHA8568+OuNwmnF12OZbl4dcXs35t2/t88Jml1unEbNCHC3X2z61kdjBk1mGUeDZQpPM65pr63KNHkxSfNem7TtkVcn1jS4rLTFse9J7/TCm3gscWp5FWRuMMTy/2eXeeUw7cPjGSuuplsCftT7L1+hX7QX+m7C+KuTPuD7vxbBgUjxM6zKNp/dnrYc7QwPcO0+4PGyx0fGZZyW3Tua8fnHA7IZg6n/42hZ/+NpWM9is+NvbZziW2M+6Fvyn94/43efXGcViz+o7Nistl6p2GLQ9fnR7RK/lEGclVWXIa83FFSngiyT5jZ54UJ/Mc4FObEOpYaPj4do2P7hzTtuzOZllxEVNkmksC57f7HI8k8Dd0laohpznOBZlZWgHDrZlUdaaf/TyJm9cGAA8dTax2vGk8GQFZ5Fwry1L0Q6cz42DPj4TUerTFYOPS/HXuj4H0xQwbPcD7o5idvsyXziLCj46nuO5wt/fWQmXJ6wnratrbW4czTieZ1wZthnFOeO0IC+qJtNU8fXLKww7PsfzjLMooxMIu8hRcH8UE3o2G72AV7b77I0TuoFL23W4vKo4meXMsoJZVpBWNXkzHHZti1d3elxckUJ+GuWcRzkWFsO2R1kb7o0kpedJ1gVKwd/ePuOd/Rm10ay3Q2Z5AUZODYFrszsI+b3r68/0OT1pTvVZvka/ai/w34T1VSF/xvV5L4bPuxE83BkO2/6ys19kcY7ign7g8u7+lO9/eMqblwZcW+/wP/7oAZalWO8EXN3oEmc151HKB0dzvnNtlfvnCXlVs9YNuHcWoVBs930sJayFK2sdTuc5xkA/tHluo8N5VLDZDfjoZE7o2dgKlKXo+zbDjs/Nkxm1gWHLxbYsQg+K2jBNSubpx3a9VSQBCrU2+LbVuAR6tHyXf/G1nUdogU+Dr9640OfH9zQPRokENXsWvcDjle3eUgH6y+CgT5qJTNMSRbnkTt85jxlFOW9eWuHysM3tRjh0MsuZZwWzrOTiaoey1tiWYrMb8MpOn0qLYvKfvbH7Cb72017voOWxMwi5OMt5/3DGySzn4qC1TIzPS7kWsrJmEovx1bW1Dh8eR/RCj3GS8ze3zhh2AnxHEeUVb+z2lzTXcVxw82TOndNY/HfaLt3QY7Xl8vJ2T2YcRUWcVVSVxnUV692AwLUZxznvHszo+M4jG+0kKTiYpHx4EtEPXUZxzu3zGfOkYqXtMk4Ul4ZyOvllP5PFZv1pAqBn8Ub6sq+vCvkzrs97MXxRXcHjnf2NoxlOTzHNKj48nksn2PG5P0qEcw584+IKliXUu5YnFL/9SQoIVnswldCJKK8YJyXDlsvWoMUr2z3WuxLvduc8YhyXrHd8nl/vsj9JCN0BP7k/4iwu2O74XLzQQmvD6SznLM6IcsWV9Q5Gw1mU0fbkpn9uo8PL2z1c2+ZHd0dkZUXgCI3OcSxe3e7x959be6b3Y0H5G8cFw7Z0kB3f4fmN7ufCQZ80E9noCt85r2p+dl8ofN+8vIpjW9w+jbi23uHeecyDsfzuS9t9HMta+oCsdj6GSxYwzeMmWy3feSS0eUFZNAbe3p9gWxIa3fFs5nnF3bOYC6ttXt7ucjLLafs2vdDhjd0+3cCl48t7sPB8v7om7JK80uxPEj5qCvfruwMOpjFrPTlRxVmFY1mEns3RLOMfv7K1PBFaFmz1fFqezf444ed7Y9q+y8lMWEqTpFjeK5U2vLzVY56VYkqWlmS1RqO4tNqi7bkcTDLe2ps8kc//WZ/J4utSzJ9+L/62C4S+KuS/wPo8F8MX1RU83tlHucAdSV7h2S5H05y0qNDAdk8GYAsmS1xU3DuLKCvN9kBCCMBQ1pq0rJuu0aflOzy30V56c692PL555SJv7U24f55wME2xLEU3dHjj4gqTJGenL9DAhycxu4OQfuiABeO4IHRtbMvi4iCgH7q8sNlbyun/wfU17p3H3DyJUEi4wpOGZp/2vv7+9XWSvGaSFkvf727gkhTVIyeeZ6WPTpKCn9wfYyFD4cXjha69lI9/+9rwkdMVyBykG7j845e3uD+KcaxGGFRWn8ii7IUud89jfr5ICbIhLjRxUXL7NOKV7T6Bay0pi6/vDpinFWdRzjgVGmoncDmb5/z43phxkrPdD/nffecSo7igqMQvfGcQ8v7hjLrW+K7QQPfGiYSUFBVv7A7ohS5vH0z56YMpeV7TDmw6gcs8LcmKkmljS7DYhEZRIcKfecaN4zlrHZ+NrsQRPizqmaUCza00qs3LQzibZ+RlTceXeUdZG6ZpwdvPUMj/Sxha/rLrq0L+a1wPq/runMWPWNr+sp29YymmWQkoDqc5gWPj2uI0eG8Us9H1mCZiZDSKC8pKU9SGN3YHtDyHspZQh2trHW4czZYy8Z8/mND2bN5sfElAEm/meUU/cFl4kzy/3ub1C7v8yftHFJWh69ustbvcPJlT1pokr7GVotZa3BWNpOQsDI4GLRnSftZN/Ph6vCh/5zmxUdUa9scJo0RCEP7glc3lzz8LfXTxc75jYaEoa82NoxkvbvWwLVGgPqmgVLXmnYMpaV6x2QvYHbSYZRLa8SRV6Wrb4//zw/uEjoXv2dw7iylriWWbJBJIYVtqSVk8nGb0W55ASHVNUVUczQrSUrPW9eh6wh55e2/C6xcGS5in4zt0A4fTeUaU1PR8YSKttX1Oo4xxXDBKCvZGCVVZYzsWSokAqeXbpKXhkv8xRHV1rc0kKcR/xxj6gU3gOnR8h+OZZG+eRwUv7/TYGYQ4jmoUymJRO81KPMem4zuNK6bCqyzO4s8uxv8lDC1/2fVVIf81r8/LR3+8s780bIm51d506elR1JrLa22qqiZ0Hf7rb2zyt7fO2d+fsj0IeWN3wHbjdlfWGoXiYJKiDdw7j7lzluDY8PWLkoRUa4k+2+gGDNv+0pK0E7j0QpfLwzZfv7RKUWlqbbhxNOf6Rpe//OiUShvisuLKWptOE/g7bgrBF4lfL7jKP7hzTq1ZenfcPhV89lnpo4ufk41NoCrfEehkdyVcys4fLijzrOTt/QmdwMVRwhlPS82LW11e2OxiN3OMh9coLlhpuYzighvHEYFnsdtvEeUlnUC8ym+dRo0cPub+KMGzbeJCTmDH85yy0Ky0G0MqrbkybDNJSkZx8cg1st0PaXkO3UBiCg+mGaWpcR3xG7eUYOubg5Akr1EYSm1I85pey2WzGy59vh++/u6ex2SVJi0LYUB1fQahy2kknjSv7fYpqpof3j2T1KpQ7IBD16YT2Bgkgq+oatYfmhUsPuOHN+rVtsBQP7s/ZrXjc3XYxrGt37qh5S+7virkv+b1tILy1t6EbuB+4tj/JDjg4dUNpJDeO485GCc4jsXloWRLFsbQCcSo6PKwzQtb3U8oFV3bAiWxWXfPYkZJgaUUA8fjaJYt+cPvHkz41uUhSqlHAgEWx9qFm+DhNOX+Wcp5kqON4aWtDnkFW72A9V5Ay7WZZdUXjl8DvHcw4/XmpLFYiwHisx7LFz8nf2e3kf4bNHq52T4uO799GmEQB8iPTsWyteVaHE6EsXNhJeT3r68/8jwHk5Si0gxCj6IndLz7o5h5JkPLS0NDXmrePZhyMsvQBrSGw6koOy+vttkfp2SV5J8Grphi+Y71SHZslFfERcmP7o7o+DbncckoynFtyfCcxAVZWWFZFkPXF7jDaIpKvMStXPHjeyPOYsHxdwbhkimy0vZp+w4fHM7QBs6inKIyBI7F1WGHdw+mPDhPMNowiXMOJilVbVgZShB3lEnc3aDtL9lJ8MmN+nSe8xc3Tnhtd8A3L69y5yzmx/fGvHlp8Fulzvw866tC/mteTzuW/+z+mG9fW3ukS7+23lkq8hZf//7NUxSw3g0e6UbfuDDg5a0+46TgNMoF0rAV7axa8qlX294n3OYGLZcol0GprQwYqI2m0pqirElyCaAwqKemwk+aYpjkFQ9GKbYFl1dbdAOHYSdgte3hNQk3WSlGTJ/nSPy0onw6z3h5u/eJry9mEs9yLH/45xZeLQuflqexIIq65o3dPofTjJWWL7Fjs4yDqRTgWhv64QSQoWWvCfBu+w73zxOOZxlJKeHFli0d/p++f4Tv2ERFRVLUXBy08ByLrZ7PJK0InIx+6OAVipYvjpD3zmJmhThMzrMSbeBnD8bMsorzeUZZu5zPcxwbJllJ1LBQaq2xFGz1QtJSLIonSSEDSpRs/r7N3bOIwLGZJAW2JQZi90cxbd/BGLg7Snh7f8paN2CaFkRZxbDtcXGlTejaTQJTTl6LydZ615e0oZb7SCF/fKPenyTM8oq/uX3GS1s9rq13uL6pHvlM/ktfXxXyX/N6UkFZOBE+3mH+7a3zT+QYTtMSDFwedh752byqsSwRpczSgrDtohE8+uFN4WrDQR4lJdOs5A9e2eLeeUy/5TKNC1xH0Q08bKWYpBXbjUXs9Q2RxEdZ9YlU+IXHdqlNM6QTPHQUZ9w9T2j7NnWtycsaDWx0xR9mq99Zmng9y6xgcTpZ+H1cW+/QDT7mcH9ayszDs4Wq1tw5ixnFBW9eGjwiHHoau+hJr3Ux/OuFEgoS5TW2BedRzkmUM08L2r7F+XnO8Sxjte3xO1cEgnowTjmdZ9S1IcoFS3dsi9W2h2NbTOKCk6ogyyv5bNKSla7Hq7sDGVTmNadRzjyv6JUVt04jsqpCGSNWth0fx5ITW5rXuK7NPKsYdj3OoxJlDOdRQce3CRyXyhiKuubCIOT9oymTuGCl7eFYCseyOZ6JzfE4kZDvSVry3evr1Mbw7uGc++cRh+OUlY7P1WHIJC756d6Y339+HY2kQLm2uGuO4pwXt7rklebV3f4nPveHN+qFuKofupS1ZpqWvH80Y9j28F37CzO/+rKban1VyH/N60mFYn+SstXz+fG9ER1f2Bwd33lih1lVprGx+niFrs1ZlNMNHL5/85i6huc2Oryw0V2yN/7k/aOlcdIif/IkyviP7x8D8PJWl1qL8dbd84S2Z+N7Nt0m+mtRtP7onaNHUuEXj//uwQQLi1b4MRa80vLJS01RGQrkqL7aDnAdteRdP+usYHHc1hpspXhrb8qN4zm/9/wag5a3TJlZDPkep3guuui/vnXG9z88wXNsrq21KatHQzeexC7a6j/5ZNQPXeZZxfEs5XQukWtZVdP3XcZxTqk1RxPxGg9Dl0lccOs04uuXVtHaEGUVa52AbugyaHscT3NGcUk3dOm3POaTFGMa6mMvIMpL7pzGQuX0HZSBstK8vz/DsiD0XdqeTVpUnM0087xi2JZcS9e2iPOKuKg4mxc4toWtFBu9EKUU4yjn1qmYWlUaLq21sZWirA2hpzibl0RZyVYvwFKwN06azTDn5a0uH+xPMEo2sXcOJA2o47l8eDznuY0eoSvXRVULY+WNRuW8uK4eLqQLs7WNXsDBJKUfelS1xrIUR9MUG5inwkj6IsyvfhtMtT53IVdKXQT+B2ATycX618aY/+7zPu5v63q8UCglVqOLI/fDaTZP6jCLWnMeFY8U/bSoOZymrHUGXFrp4DVMgcWqas3bezP+3pVVeoFADT+5N+a59TZW4553Os/xm2zPCyst7pzHJHnJpWHrETrgVj/g5e3eI9a0C+jlcYZCXomVq6UUr+8OHimu7x5MGcUF86wiyStCz6EXONiWeoTBsrjBf3J/TK21YKwtn9cv9Ll3FvGfbpzwT1/fXt50i8Hm0yieB5OMFzd7SyHM/VHCpccGrw/TTCdJwR+9cyR+I21vGYm2N045nIpC1VJK7G3jnP1JRnujcR/0XSotYqh24OKWNfdHCV+/tEqtNbZSbPUCnCYZ52Sa4SjFejvgcJLgWopZpbl9FtMNPCZJzjSrWW05zLOKKK8IPZt24JKXNXmlUUY+z1lWUWmhltrKYlIUJGVNFWlKrVGVottsOHll6IcOriMOl5O0oJ0ItFFps0x6shTklSYt5dr6f/7NHVY7Pps9n7O0oCg0rqOYpaIL6AYOZ1HONS1MqVoborzitd0Bb+1NKGo5LTmW4gd3RkvIL/RsMSdjQJRVrLYdbp/G+K5Ny7WhCcn+/bXOI4Epv+z6bTDV+iI68gr4PxtjfqKU6gI/Vkp9zxjz3hfw2L+V6+FC8dP7Y17Z7nPjaM7JPGpCe+WY/i/e3Hmkwzyd54zjnMCz8WyLoqp5a29M2aS6LAKIj6YZt84ifnDnnOsbXRxb0Qsc9sYJlZbiFLgWZ0nBdi9Aa8PhJCNwxQskrzTb/ZA/eOXKJ3xgnoY17/RDPjqJeDCKGbZ9hh3xVnn4tYHcJFFW8f0PT3l+vcP5PMNSFmlZ4Nnws/vj5cbxcKdkAWdRSVLU9EKPju/yys6A0yh7xOfjca7/4jEWnV6UV1xaaaEaky54ugf24ncnacFa26eohZFjW9APXG6fRTy33iFwHWqTkxSaCwPxh4nyqmFoOER5yTyt8N2PTyuWsri42sKxFb5rM81KsroGrYSlMhY3wNC1OI1zfnT3TOx5Q5eO71LqknXP52iaYbQmLSVyr7Y1W2HA8UzMrZK8AqXIipq0qKhBQrHTksSqmGUynPQsRVLVaC3/X7xqKnzPRhlNy9gEnkOcl7x3OMW1oOW5dHyHt/amZEXdJBZ5FE3QBMBGP6Df8rg3iuj6HleGbdE2NMrSUVTwvfcOuTRss9ULyauaKMq5ut7hLMrRaALX4R++uMn3b56yH6cNZTZY3hefl0f+28BP/9yF3BhzCBw2/z1XSr0P7AK/dYX8V4GjzdKSwLVASdCvAVzbJikq+qG79HI+nWckpeblnT5rnUcpgJNE1J4gsMOP7p7TCRwUiltnEe8fztjo+gSOxVqT5h7niklS0PUd6XB3e9w8iZilJW9eWnmkmD5OA3scvhD/bQn9naYFH57MUafwT17dIvSc5WtbrFEsBlJncUHgOniO3bAkKnZWgifaj3YDl3ujhI7vcDbPaA875FXNast7hKXx8Gf11t5kqcC8uia47iwtGDf+5gC+Y3Ea5U/0wL5zFqM1RFnN4VSyJ7uBy/4o5VrDHvId4d0fTjNqo1ltB4yTCteS7EzPtugHDnfOIlFQXuiL/0xecRrldIOctXaApRR1ZaiN4e55gsIwSyXQw1YK17JIi4o4r+Tca8TnvKw1SVmDAaUU2hiOZzkWCpTCdizirMQ0drieLXms2nMotcEYOTGcxTlZoRl2fDzXgkSGplkh720v9NjqhkzSmj6KRBscR+CzTiD4f5LXZLnG80Q3EBcV/9tvXeQ719aWwR+nUSYe5Wsy3ziczuREUtbN5trMfBqHxq9d3FpCaq6jGIQuNTJA/ndv7XN52OGl7V/Mv/zx9dvAT/9CMXKl1BXg68APnvC9/xb4bwEuXbr0RT7tr2U93B06lnrE0+QXUSI+vnqhy7sHU1ZaPtt9SQ3Kyopai8tdrY0IaBT83b0xP3tQ8Z1ra7y4Jdi5MYa/uHnKW3sTKm14d3/KVj8kKSrOE+H2uspintUMhz5lZZikJb3AIbQcfMfmeJYySUv6ocerO4Nlh/s0vva19Q6juFjCF73QpawM90cJz613eWW7zywtmKQVG71PwkOjpODaepsPjyMGLQ+D0O+macE/eH64LMwPd0qiUJxS1DVlrcjKail9f/yGW7zu/UkqkWcKfr43YRwXzLKKkwdjvn5xZTkYfjwMYbEOJinH05RByyUtBQJadNvio9Iir2pO51I4L660SAqR8F9caXEwTUV80/Hpt0BrTct3eO9wSidwmCYlZ/OcD48iXFtxZa3TODhmjXukhDy4rsU0E5fCbuByOkvRgGUUoWfjOhaWBUWp0drCQmMwFGVNVtgYI0Is37HpBi4rHY/jaUKcCx5uKWgHYi+blBV5DbUxaG2oDbRcC4yhHdhM04q60vie+Oo8GCcSPuE7tD2XrCipaovAt3lpu893rq0tvVAA/t1bByR5xYfHER3f5mSeN0Ea9fJ9952PAyYWUOQfvXNEL3A5mxfiotnxsRU8GCfsDILP5XT522Cq9YUVcqVUB/ifgP+TMWb2+PeNMf8a+NcA3/rWt8zj3/9NWk/qvBfdYa3N0tOk7dn81c0zfnZ/8sSC/iwd/Grb4539Kb5jM2iKoqXghc0uP30wxnMs7p3FeK4ECJ9HOafzA/75GztsD8LG0MosFZeCuxvGaYUN7I2yJulFOjjftXgx7HA4y5ow6ARbSdTcoOVy7zwiq8Iljv8k7HAhOFmsP79xwijOlwHCIB3caZQBLBOMFjeJbVlcWGmDUhzNpGg5Fry41cWxLVq+1TzGo1TAb19d4/sfCf3SsRSXmuCEx4vw4nVXNfQCm6SsOZllKEsxCFwmxrA/SZjnEq7wNA/sKKuwlKLfkoi7s3nG3jghqzTTtMKyFKezjJunEWjYWQ1xG5FKnJc4tuKNC/3ltdJqZhoH44yzeY5lWXQDh1FcAIqLqy1hoqQluSUMn9CxqI1GG/BdC200cV7Rch1KrTGlYTX0GCcFlmdhNBR1Lc6FlkXgWcyTmrQQfnqUV9S6Zp5KBFDggmPZy+COopKgCscSD3NlDMpSVLXhcJzSbTlklcTxtTzNRtdnnheYQtMJbH7nyiqBZzOJc/ptgX7+7396k1GcEXoOh9MMG0VRyyZS1ZpLqy1sC7KybnjwxSMBE4OWt5zN/OzBmKNpJlx932XVs1nvBk/Fs5/lHvyi7DP+c64vpJArpVykiP+/jDH/8xfxmP+51tMm2EkhXdaiiNcGDqcplYENz+ZP3jvmf3n7kN2VkDcuDJ6JlbFIT7m21mEcF0wbbu+3rw7JSs3+OKEfegSuzfGsoKhqXNsiLWv+/MYxl9c63D6T378ybDcUNsXxTJz3VkKXaSpDrrbvoDBM04oXNjq0ApeTeUZWGdY7LmvdgLbnME1yosZb42mc93cPJo/cGL3Q5YOjOesdXyCDec40K+j4MpR7bbe/hIfWuwHfvrrKWZRzYdCirvUyBWd30OJknuFYFv/9X94mLWqMYWne1W+5/M7VVfqhuxwOP+nGXLzuji94/9lcWB5lDZs9SU+yLYui0mxvBEs738cfpxNIgk9W1rRc6WZdy2JtENALHH54e8TeJKXj2VxqZgmjuGB7EOIoC9cWr5WFuvM8zvn//t0DfnD7jMB1GLQkkac2Bs8yHEwy2oFAHq5t4zsyJE3LirqWBKSseW2rLRfbVkSFllg+7eJ7NvOklKmVMaz1AmylKEpNVtW0fIeiqhglhqqWThxb4bsWSSKF1SARb5UGZQyuLcZZlgWlNvRDl7QwjGOxva0qTakN3UAgutN5TuhbDDs+6x2PDw6nTNISreGtB+dMkhKNRNzZluJkXrA/TvmXX9/FscQm17Y+mTS02NS1UTy/0UUpOZW5tvVUPPsXYaM8Plt5+DG+DLTEL4K1ooD/HnjfGPN/+/wv6T/veloXejLLSRuHwF7gcn8UU9TiN3LvPGKe1byy1SPKK947mPLWgwkvPzTkq7Vhf5Jy+yzmG41/yeK5rgzbHM8yMOBairvnEZayuLre4WCcyU3o2bQ8m6ys8FybB+OUTuBxabVFx3fYn6S8uNXlxc0eN472GUUFaVahLIVChChpWfPCZk+8xw1cW2tzOs+J84p7ZzGurWj7zlIu/Th2OM9K3tqfNrj6o8Il24KjacooKSkqMbCK8orRXDaGK2ttXt7uNdBBvoRnsipcpuC4jiKJasZJQi9wCR2b43nGe4dTrlUduoHzmUX84de9Mwi5cTRnkpS0PBvHYsmg2ZsklLXmYsOTf9INvjMIqWrDRydzxklBXupGQFWSFjX90MN3LfJSowCMFNjaQFxUPLfRWcr7HVuJYCeVeL9ZVnLeyPSl281wLZthx5WBtzasN3bFudaNUAsWM9njuOTSashrax1O5hkd3ybONdOsRBlJWaqqmgrB6JWSYnUeKbQuMcY0A15FWmoagS9ayz5QA54C21ZM44LYUdQGPjqNaTkO53FOVJTYymKz6/OtK0OivGwG0Q47g4BRVFDWBteyOZyljJOSpKjwHYu75wnbvYD1jjB79scp24OQ5ze7T/xcF/CHY0vnrpT8+/Kw/VQ8+/OyUb5MtMQvoiP/B8D/EXhbKfWz5mv/F2PMv/8CHvvXvp42we4Ewqd2LOkETuY5h5OUUmsmSYlriV+J59pkPd1kIAr/93CSNh4gBtuCK6tiPJQUNYPQ5aPTOdoYxnFBqTUnUc53rg7ZHYQcT3OmSckglOJb1LDdcdnpBWz2A1SDE6ZFzcEk4WiWU9ca11YkpYQ5hK6FMoZbpyKscG3FP39zl3vnMXvjFJbxDkIf7AZyWTyOHd4+E4fCa+sdorxq1J05J7Ocb18d8j/9ZI9RXDShzwKPWLbNOwdTLq4KU+RxeObxFJz79eIUIj+31QupjbymWhtanrOEaJ52Uy1ed8tzeGGzw9E05TQqeH23x/MbIru3EF/3h1/T4zf4Ip5v2Ba2xU8ejLl7FrPRDem2XWaZbOpzZDB9FhVs9sTL/R++uMYsKzmZZ+yPE87mOaDIas08rZk1mHelJUoPFHFRU9SG3UHA6bzEdRUtz6bKNZmRLhpLYI+8qjieZvQCh7SqsZRFUWscS4acpdaMk4r1nk9WaAaNaGmt4xE1ea8GwcLzUmiiCqEaKkB8MQFjZKiqDQfjDMuGQShOkC3HZp7XPJjE/PWtU7a6oisIHIu/+vCUoAnwnmUVs1z+XoVw32sUSSkNSsez2RpIctWTwingY/jDttRygL046TwNz/40NsqzdNpfJlriF8Fa+Uvks/+tWE+l1zUeE3IhjZnEJWCoNGAMgeewN8lY67q8sNnhZJby7sGM7X6LH9w5l6xCT26OBXc5yir2Jwkns4yO7zLY8IizirSsiPKSrPRZ7wS8sz9mnJastz22Bz5FWbM7CFGKJj2+pu3Z3DuPOZxmlBp2V1u4lsUkKWSjcWC7J1SwuKy5dx4T5RUtzxLBhTYcTlKOphkfnYg/yyiWzeZkltMJxPDo9d0BwNIpca3tcxZLnuWVYZuzmSTTDAKhQu6NEgaWDA4XHi1POwrPUglhbnkf3ySCmdZ8dDLn1Z3BM91UD2OeWVnzD66vMU1LNroBoWtzHhe4FktO+NNe073zmNBz2JukZGVMlJakleb+KKbbcvAda2k54FgWGz2f3UFIJ3DZHoR0Mof7owTLsqgNhK7iznkqcnxLURtDWtS4lsWg5TJoOewOWlwYtDieptw6S3AdjVMpnNrCGE1thODkWLL13jmLsJXF7iAkcSrcymKeVxgjG3Nda8q65vpGm1FcYVkL7F94/rWGQkNdGDxHMWgLXVI3MgSlED8XA7Ytat4ol8LsIJuH7wqGvjdJeOdgwqs7faZZiWtbZKUWdlHo0Qkc5nlJUQrMk+Y1qSehG8FjHjGL9XjBfeOCzKIWX2v51lPx7Kfdy0rxTJ32l4mW+JWy87H1aRPsQcvjuy9s8MaFAf/X//ABxazCscCxLY5nOWgoKulCNnshlTb8+P6IujYEgQySLq91sJXIlJWCv/ronLyo8VwZdgaehQ386QcnWOqUS6ttfvfaOu8dzhgnBa/s9LAti0prXCxWWx790ONgnJCUmqSssJXcrP3QwbEVgS8KzcvDDhvdgNN5xn9875ii1vzOlVWivFrKoF/f7XOelPybn+zx2u6AQegyjgtunUR0AimCN48j5nnFIJQh5LDt0fIcTuY5/bYEMqtmbw+cgrw2j6TAPO0o3AtdXNuSAmPEu3qSiBFUN5RO/OH1aTfVk/jkb+1NePdgwvE0Y6v/qNve469pkhT87P6EtY5P6LX56Dgi9BzaZc0oLmWDarlMkopuEGBb0PZc3j+as90PG0OxknGcc2VNUpVuHM+ZpBVlVdEOXDyllkNG17UJbbkdA9fGsRW2JUKaqoZKy8+FjvDO86LGGINBMUlzeR8MtAKHlZZLlFWkRc15XNL2bSZpxXrHY1aUeI5FqG00UBU1EgMNShlcW8npM6+ptKGqNEaD7YA2EJfgKOEqVGiMgbo2zcnO4CiLD0/mDAKXwzijNIZ5WhJ3hM8uUXyWPKcyjR+PR16Zp7KPnpYI9Fnrafeybaln6rS/TLTErwr5Y2vRzS1ueoPi+kbnEz9zbaPDVi/g3aMZSV6hMbRdi3lWcRbnXFpt8dx6hz/78ISWa6MNrPcCTmcS/DDNSoYdD200nm2htWZ/HBMVmroW06rnNjocTTOysubrl1ewlcK25fUcTqTj9x0L15bh3e4gIC0q2q5DVkkh0bWhHwpFbbsfcDRN8RxLfMsdi5/eH3N9s8truwMCVzD4qDl2/9mNE9KyIq00eSH0MINhpe2z2w9Ics3JLOIfvrghpkhIZFucVVi24myeMc1L6lpT1FJ4Po3adXWtzf444eZJxCTO8RyxOvVdUb6ezvNHotF+0Zuq1oZXdwa8uKl5e3/Cz/cmvLHbf6Id6p2zmNW2h1JwPs/pBi5dhFGEksCNeVqy1vU5mecM2y4t3+HvP7dGUdWMmk5yoxNQac0ozhjHObURY7JJXNIJHC4MQrSBkyhju+vT8ixGcc4P7o3JigKtFZWWjrjUQjdF1WgEPgmUK4O/QtKg6qxcWuZaCuq6ZqMjc4CDWUreZLCihMFjK/nbtZbXNc9KfMcm9GwwCqVglpUUlRTyRdGv5cfxLena87qmKkXZGU0q/DWbVuAwTQqKqmJ/VrPWCXAthaUsklLjOTL32emHZGX1VPbRp82ZPg2rfhob5ecPJs/UFHyZaIlfFfKnrMVN/zQ89vpGh++9d8ylQciVYZt39iaczgv6oZjsv3lR8Lw3L6yw1vG5cTRjf5zQ8YWFcG+UiMTbUsRljaUUo7hknpV0AvHMyEpNx7fwbEXS+GZEhUiz754nTLOK0FGsti3GScFWL+BomhOZkgurMig7mclAzXMcbh7PcRuaY8d3GHZ83tqbcusk4vmNDh+OYk7nOedxzk4v4MbxnHFSEro2l4ctzuICW4Frl0x9h37gsdn3mWUl/ZbLpdU22hj+7MYJx7OclZbLelfer6LUDec3fOpReNDy+L3r65zMMyZJgUHx3HqH5ze6pEXNnfOYTuD8UjfV40XhjQsr3D6NuHE84/kNwVofDvqYpSVX19p8eDzneJZhjKgRK635/evrvH8442iWMWi5SwOoV7b71HoxHC3JypqTecr4sCDKa1qey6yJPJPO16XX8phnBVfXOg07KWOclMRpQV7V+K6DNgrLAqMl4DpQwobJak1a1WgNGsE3LQNJLsNX31XU2nA4E65L27PIS1FdurZayuZtS4REdcNaETAetDGUNcvH10ghf9hZXVlgUFSVbrB5g63EsXCjK/DfStunrMWHvLI006Sg7UsnblmKkyjnd58bAjxiTHYwSbm4ItqKhXmWBH7I6fazBo9Pw8GftdP+MtESv5SF/FdNCXqWIcflYZs4rxhFNY5tcXm1xWY/4JWtHpallkOYV3Z6/ODOiHvjhKLUxLmE+O72Q+aZiGqqGgwis660wXMs1gchaGE/TJIClGKelzw4T/jp/REbHclMPJvnXFhpkxQ1UVHx0naXo1lOlleiRPQ9jDGstiWAVymLvVHKKzs9Dicpvm1xNM2YZCU7g5Bh2yUuKt4+mHE6a2h7WnPrNMJ1bNquOPO9cWHASstbKjSHHY9Xdnr86fvH9EKxq51lJXFjNXB9s4vnWJ95JB60PJ5b7y69zxer4ztklfCjf5mb6nG8sxsI3vpgnDxxiGpbCse22F1p8eP7YyptaLs2vdDnzpmETHz90spSmPXXt065eTzn/ijBsRVlVTNPS94difBmrSu2wdoYYkuxFrrM8pIHo4SsrLk2tOm3PEoNx7NUiqpRDZ/bIivEWREQuMMyKBRJJiyYpbNOLQVdWaL0LGpNnJVooxnHojRdaXuErs0oLcQ6t7ZQisb/xZAWUrRtQNnCYgEp4LaSzlw2dPl66NnYQF5rktzgeUrcM+OCuBBIxxihzRYNXVFnFUcm48E4ZbUt4rN392f0Ww6uJdmr46QgcOyleZZoFAzdwP3MweOnwTK/SKf9NFrib9r60hXyXwcl6LOGHAv+90tbXcZxQVpJF/KtnT5xKR4bnmOx1e/w1t4EbTTTWDycaw1fuzCg0pqfPchwbYfdFY+75wmh52BbEvzQ9Vz2RgmjOCf0HU7mGZ5js9LxeevBhP1JxitbXYZtjw+OZwxClyQ3/N71VdanKQ9GCUWlcWz42oVVpmnBX32U4xjDsOPxwdGM9W7AlbUQ21KM04JZUi67yUlakpcVtm1hSrP0U/Fci7TUGGCaVhxMJE3o5e0u46TgylqH9w5mdAOX7X6IZ9t8cDSj1pp5w0//rI330wbOz4KNPutjns4l/b0fOgSuTVKI4KqsNJv9kIurIdOk5M0LAx6MUlBwbb3DjcMpZ1HOmxc/fi2rLY8/vXHCesdnlkmKz2rHZ5ZWTNKYotT4nmK142HFBWeJhDBcXm0TeGIx+6O7I17Z7tHzXfotl8NJxiiW96wy4BgZNmoDRWmwlEEbKOuP9XU1DePEQJoLrTAuZEhqIQPLogbHhrqGsq6XuLXWhrI2WA1+YsyyOQearr8Z2lq2hW8LB76qDHWTgtT2HOaZGHg5lgxQzxMRIQWOjWNbKANRUzy1AW0kWWoUFVwctnhtp49tKSpteL9RwUZZtTSDW/j/fNqM5HEBX5TXODZLU7ZFp/1gnCzpr3fOYq6u8SvpuH/VzeeXrpD/KihBj7/JSvHEm/4syvnzGyccTTPWOj6v7Q6W7A1jRMxgWbDdFzbEuwdT9sYpg9Djxa0eaaG5fTZnnhVcHHbQBlCNFLo2y+l9UpTcG8XkhYQiW7YFRuHbFnvjBICsqLk/Ttno+vRDt/E5EbvaeVrJAM22qLRpjrkB/+S1bd7Zn3A0zVBGsd7xOZyJ2900yTmcJHiOTVbUOECuLPKqarIVLSpjiLOKrUGIrg0/fnAGSrHT9/ngcM44ydnqBTy30cFSCs+xGSc57x/MOZ0XXN/sMIqKZcr60y7kXwU2+fhjns5z3tmf4NmKlmvzk/uTpeFXO7CZHIvb4TQtaHsuz21I8ag1DNo+jm0tvdABVts+SV4RuTKzAInRW+/65GWNZStc20IbQ8sTafpaN+DCsE1VG05mOY6leP9wimNZ1BoWbsVKNSIdwFHgOha61BQfG1ziNJ3yAgJp5pEY5OsGwcwdpUjykqvDFusdj/eP5hgMgQ2lckjLmsCCpNB8PJ5uXgdgWWBZirquieuatufSCR2GbY95UdIPPNIqxlYWjiWUxqwocRxhuBggLiXo27IsvIY2OYpzVkKHqjacRTmXhx02uz6jpMBzLDQabWxe3Oo94kH/tBnJLC1xLMWHxxGBa9ML5JT4s/uTpQL76prc+2sd/zMprZ9n/Tqazy9dIf+iKUFPepOnaYmiZL2hqy1u+td2BU744GhOnJe8tN3nxa0eB5OUk3nG/VHCH7y8xXrXF8/qD094fr1L4IqM+N4opu053DqNsC3xg7YtoSMGrsV6t808KzmcCLfbVrA7CAk9m62+zzv7M86jnMARg/44r7mVRlgKbp3EKDRJqWl5NhhDXMrJoOvbrLQ85lnNt6+t8Vc3T6mMYZwWrIQeN49n3GuyOV/d7qMsKcKu2xyHS42lDGdzjdUNOI8L/s1P90DBd55box947I9T0rJmHBe8ujvg/nlMVtV8eDzDUzI0W2l5T7SNfXw9CZvc6neazfYXD6x+0mOeRTmvNZ7Y7x1MOZlnBJ4tflTGoqxqplnBWid4JNwD4GSWic1vUS2vjzvnMetd8R5Zawf0QoftbouDccJWP2BvlnE8TShqodtZCjzLcDTN2Or5OLZCl1oEQxbEeUXg29SVpjQGFxkwai0bdFk3wHWzqodML8R4TTrvRbFXgGlsaG0FH51GXFptcWk1xLEllk5XFb4tPHRtHnrw5vctRPGZ1xoLGgtaCw2cpQWuZVFpeGGjyyQRC4IoL3FtG88WnrzRQn1URjB/z1cN1VERFcKUSZY7lPDoH4ZD0qJuwrXLpQL0SWvhYfSwbYRSog14kikb/Op44r+O5/nSFfIvmhL0pDd5oxuQP4THLm76BWNi2PaImrizBRf5aJrRD11CzybKKz46mXPzOObuecqLGz0CTzFLSx6ME/bGCfO05Mpam5O5yMP/wXNr2LbFD2+PyCtNP3R5ZafPsO3xw7vn3Dyek+TiqlcZ6d5nqagoHdsir3UTuSbYrmcrur5DWht+/GDM7kqbwFX8+O6IvNb4jsVK6HE8y4hS4RMbbfjweEZR1RgjOH8v8IiVGEZVWlNWInZKioqW63I8y+kFHt3AxVJCQ5unJUWl+fGDCaMo58JKyGbPZ7Xtk5X1U21j4ZOno69dHADPxvv9rPUw3vnnN05YaXnU2vDuwYxpVtLzbarK0PIdtvsBx9OM3UHrE14xlgV/8Momo7jgwViG1leHHS6uhPyPP7pPXtX0wpC6MmhjsCwlql3HwrYtaq0JPLGu7RcVxgTS5TbGVr674FTXWK5F3xJBTlbKYLOo9GcKN7JaIJbFsgGjIdcG34Gyqjmc5rQ9i9CVf9LSgBHcfSHVV8jG4Nhgaggd2RBankPoSU5onFe0fZuW53Beata6PsOuT9f3+PB4Sj90KbTBsWuSXARNNQbPlo2z36hhi0pjjCF0JQx6mpW8utNbfnbX1jufiCpchGs/SRT2/Q9PWOv4GCOU1qyseWGz+0RTtsX6VfDEfx3P86Ur5F/0sftpb3JW1ks8dnHTL9bOIOSDo5K9ScoslbDiqtasd1r87MGYtNDMspKtfsD984S390f0Qg8QTu1618dxbG4cR2htuLTa4p2DGRs9n42+x+VhSFEbLq62OJtnovpMSgyK9Z7LJK0Yx5mYQoUORWWIspo4k4JsW4KVpkHNetdHGcV/+uCQXuiz2ff5r1/c5E/eP+a9gym1FuZDlFXYtnR8fuNJ3gs8Alex0nLZn6RLtZ/WkFeGbgB3T2PSoubiSggYBm2PP37viEkT4rzZ8ahrTVrUxEVFy7WXtrFPs8h9vGBnpeY8yqm0WYZptDznc3U0vdDldJ6zP0npBxIjFhca14aVtkfQUEkXKtcFFXWnH9L2bd7Znza2rLkoHT2bbhDwz9/Y5Y/ePeSDgznrPU84yy2X9DgiL0W5uYBK4qLm1omcqKxG2Xtx2MZWMIpsorKm71j0fI/a1OyNBLBOCv0pf5ksg1wDi7WAXFqO6B58x8axDJZtERc1dhMAUmrByFX90MDTEjzdAHkF3cCi6ztkpSYr5ARR1oY4r+iGHi3fFggtLrEbNWtalIBC2Ya6EqxeTj/yXvQDl9C18F0L37WpjeZC41u0WKO44PXd/iNN3CJc+0misDcvrXD/PGGWlXR8EbnZlnqiKdti/Sp44r+O5/nSFfLPSwl6uHgoBbdO55Q1y/SXbuB+4k1WCt7anyxj0nYGIZdX2/z4/pjStRm2XV7a7uHaFqNRwtEsY6cvhlB3jSGtDJNRQujZBL5D27UIXHmcvVHM0Szj+maPV7b7fHQScTxPsZTi5tGMThPp1Q8cYSA0Ks6iFM8PWykKXVNWgj8u/kHDOKlICpGRTxLoZQK1KKV4dbfPn31wzINRSlGJ61ypNaUyeMZgjPRi2kBlDIOWR1ZU1I2daaklazJwbNJcNoKzOMeyFOtdn9WWy2lUMs9LWp7D/VEMSnFlKCHCq23vE13299474uqw88jpKMoq/vzDE97Y7dMLPk5QemGzS1bWT/iEn21dXWvz43sjHKW4ut6mMjKM3ej6zNKCorQYtPylIvRbl4dLiO3KWoe9ccI4znlrfypYsFK8vN3jd64O+V9/4wL/6cYJV9c6nM4yDIZxUlBrLUwcDRpDx7fJKsO9ccqw5bK9EqKNZtL4sYRa0fU9amPwbQdNjkGKq2WxVF8ur9OH/v0QxL5crhK2iWUpPNcWx8G8ZJrVXB62aK3aHE5yQtcIs6TWVBqySoamntiUE2UaVEle1RS1fD2rNO3AIXQsHKVY63i8ezAFBRaKsnE6tBQUQNg4PxptSIqafujy2oUBKy0XrQ2uZX3CTfRgkpLkFXFRPxKJ+LTO9o0Lg08wkh5u+n5dPPFfx/N86Qo5/PKUoMc9xd/an5KVNa6tiLKSD45KLjfWqIs3eZIUzFLJK+wF4lfx870JF1ZCXt3pcbFJmxE/lTPeP5pzMEn5wJ2RljWeLarEvBRYYtjx8BybWiPhA8oiqwoOpykfHM4ojaTqhI3PxtFc0tjXugFbgc3d80RuIC22tJ3QZZRKco6lpHuCpnNGcFWUTPtnWc7xzOb//cN7fPvqEM+2mt9R9EIZdFVNiLDvSgpRPxQHwH7gUBtDz3No+w5ZmZKXoLA4T9KGDaHp+fJ9SSuq+PBohjbg2TansxQF/B++c5lRXHwC0qq1hE48LPpZhFAoZT0SPHDnLObV3f7nuoa2+yFJXtFveWwPQraaHM1JUvLiVo+2Z3MwychLzc4gZJwIDPbO/mTJwZ6lEprcDz32Jyl/9sGxRM4FLr5jkVeav7t7jmMp0lzL52PAd21s2+ZrW2I4NknFr0X8d+SEt9r2yEpxh3Qci15gM89qOTnVH8Mei7Uo5I8XcEsuAbSBtIRAGbJCNu9pWlABB5OEtudSaWFNlXmB61hQG4JGjGQ7FgNX0oYmjX+4BeRN9260XDv5OGG1JWHik6RooCWZ3WhtcG0j/HMDtqP4xsVVXtruopRw0t/Y7ZOVmu+9d8R2P2RnELLa9pbReo5tces04qf3x1xea/HSVo/H16Jhe9hi4nENw6+LJ/7reJ4vZSF/lrWQZH90Mn9EnbkoHjeOZgxCD0JDUWvanji6nUU5f/iaDFB+en/MT+6P8R2La2tdZk2oQNcXF75usDieJ9w4mjNPxUUwK4VDvNLyKesajAh8Wk22YpxXKGVhYYiLEs+y8GyLrIE4jDGczHM2uyFFZXhpq8fRNOXmacrhJKMXuGitCR25UdwGg7WUwrYMNaB0cyw20gk5SqiPaaEpqox39qacJyWz5vksTzaOzFKUqcazLGxHkZaGo2mOb1nkWuNbFp6r6QaWHKm1YRgE7A5CPjqNOI9ykZ/bhryq2ej5nEcF3dDl2lqbNy+uUDUF8HFIK3AUb+9PH+m4RolAVB+dzKm1aWwHLPYnKStt+f1flsq1MwgpKs1L233mzczjPC5wbVjvCnd5re0tI97Ssmaz63N/dM7zG10+PJ4x7ATM0hLXgjgTE7S/vHnGNy4PuH0a8c7+hINZjkJTarCaIIfK1BSVFKU0ryV707M5meW0XJt+4BJ4NistsW29cSR/v2tB6DoUVi2YdrM8Sxg1D59RHPUx40XSgWjYMJpZWkiXbAT3LiqFUrXEsGWSSmSMoahqdOM2KZmymij7+FkMLLv1qtacxxkd32GrFzAI5Z6qa3AtG9+xiYqq2VikiegELkfTDCzDd66ukRQ1f3bjhKSoCV0L11KsdXy+994R652A/UnC8VlMp2kWHoxTtvvhI8ESDzdsC3fLpKg+xYv8V88T/1U/z29lIZ8kBd+/ecreWPBPMLx3MGWaVvze82sARHlNr8E/80rz4lav8ceQY9rDWZF5UfPH7x8RpRUow4WVEK8JKv6LGyfMcrHm/OlpjO9atD2bcVqSlhUtz+bBKKHlOczzirSsWev4DAKbaVqQFYbrm20urITUGrQPd88jzuY5aanp+w61Jb1WlmvKWjNOctq+I1imsXBtg2OJd4WtBM+saYZUSgZoaVmRFcI+GbZ9Dmcp2hjWu36jxMto4+AohVGGQmsC12KWlPi2YJYSsiydaF4bQs9m3XcIHJtKS4xYYeDuWUTLs6mNInAU/ZbLq9s93ry0sjwKP8kidxQXGMUjeaSzTE5MO4OAWVpxMs84nkmAcpJX/PDOiB/fG/EHr2x9Il/0s9bDR96O73BxtcWwI7i279jkpaao9fIUMIpz5pklzo5G+NmOEsvYUSJy+rZnLQd5p1FOWmmUkdBoz266VwO6gF5HotrSsmboOXR8j61e3QQrSFF/aavHzeM5986Fi64VpIWEWriWsEhcCwLfYpp+jLUoGkm9EdqiBZQGwsAizfUj3uNZBbqu6QYOZSmfrbEEBmj7FmleMUlLilovC/tiEKoQd02tNVnZnBI8UY8WtaHtCQSYVTVZo0K1LXBNTWYptlyHaVZy/CBnuxdyMMk4mmVLRedff3ROUmqOGhV0x3eIfIdSS2j5iivePg/j5F8m18Ivav1WFvI7ZzHTtGTQhDIApKXmYBrxR+8e8caFAZYyTdK8DNDkZwQbf/hCsCzpEu+ex3R8l42ux92zmFFU0Gkc/v70xgnnUU5W1GwPQtKyxrVEVl/WYl27uxpwNMloew5lWZN7FhvdkNAT3+6i0uSV5sOTCEcpdgchZ3HB/iim7bsYYzhPclzLQiuwlUVeG9qehbJstgYhJ9OURnODhTANLAVJWckN39AJD6YZq22fK8OQ43lObcSatKg1s6zCtW06nkNeGdY6AZFXMk9rtgcBLU+8rd+8uMIHRzNmmTjleY5Qz07mOR3PZSX0mozMmu9eX6cTOHx4HOHYku35CYvc04jAc/j9nUFz8pE8Uq0F+ml5bnPC0RSVZp6VVBoR4KQF33vvmH/1zQu/8KzkSUfvhReH+JlL2JVnC+VzmpbsDlrcOZszinLiomKnH+LYLq6l+PAkYrXlklaSZdr2bGzbkkGvZ4OqyRvfkmmaE+cB612Pja5PXIpHjUbRC23A4ecPxiRlLScwT05IRcMwAjl1eZ5I5BcslcUGXvMxLbHZeyhyqeBO4z9ujBT40oCuG2xcG1qBC8aQFiWxhAmRl/WySXAaXMeyISvFPMtxZOPACJ6tkE3GNLRJx2qGrhrqhuieVZrQFVbJn7x/LHz8ouRkLhmfw7bHndM5cS4WD6/tDB4KlpBN/nEGyJfJtfCLWr+VhXyWlkIjCwUwjouKw2lK6FpUtSbKSuKiJq8KWp7F67sDkqJaDiB+/mDyyIVwOMsIXenOLWURuA4t3+E/vH3ENCno+jYYn+M65VbDuuiHrnhQ1JqNbsh6J2CeVQSO4jQqyQpNEQjLpDI1o7jgznlMpQ3Dtke/JZvQ0TQjbcKNS60bPq/iPMlRwMRWOJbFWsfHdixsLYbStgWDVkBR1+Rlja41ukb44Y4EAx9OU0otRSora0qtwYK2a1MZwzQuMbVQ6FxbfE9un0Zs9AO2+gEHU1HFGQxHM6FfWkbgkP2pBAWs2x7H85y1rr8MKX5vf8rxLGOzFyxpYUVdy0Az9NhGKJ3GGP7iwxO+vjvgcJoxyyqKWjNsexQ1n4iV+2UCAxZH79N5xjwr+fkDEUxVtWGjF/DiVo+PTua8fzjDsSxe2ely+yzBdWx6vkNaVYySgpZn0++GSwYGsJyD6EZqXzfTSQsapgecRzm90CGpDHvnMRdX21y93OGjk4iTqKRuim5tOdS6bnDkj5dtgWNZzHOJhrObAlssxER8TENcDEhrA74tNroAbvO9USqpTrYtsFlaGVAK3zZCe2yYKzYs23mtP5bsdzw5mRXaUBUlm52QeV7S7Dl4roXX+GIqJQ3OJM7pt2SeMIpKqtrQCR0Zwjcw5LzQDEKbSVzywzsjgVu6QRMs0f0EOeEXYYl8WRKAPmv9VhbyXujiNHLeoMlatBAZ9VZfuspJVhHlBZ7jL42TFrzkhy8EY6DlOuhabhRLKS6stqiqmh8dThl0fZSG87ggLUVqnJc1upnIayP49DQrQBvBNbV4N++PBed1bMXpTGxtd3oB2kiXow20PcXhtBK5tF440BlcR+IgklyIZtpkWFh0AoU2iqKuKOsKW1nUTYhu2YDnEntWM8s0hTZ4SkyZWp5DUpQczzNqI256cdunF7g8v95BoZYnnV7g0vZdbCvDwtD2HbFcNYphx8exwXMUcVYxTUuitOTSWote6GID7x/OWG35WBZ8/dIKvSb44OGVljXr3QDHtpaeJh3f5mf3Rww7/vLn8qpmteU90c/6SetJrnp744RO6vLG7oCqNryzP+Fq0WEci4zfd22+fW2V03lON3D4Z6/v8MO750RZxYfHcwBW2i7fbK9yNM04n+fM8lLsZrXBUuC7Dk6tsS2D0RqnkbiP44LTeQ7A3iQl8Bzavs1mz+f+aUwNtFzFJDXUtdy0C7jEtkUYtiiWtiWQwzytqWBpnqVQaK0f2QQCRyAztJHQkgoSI3az8UIeakwTviEznEUxtyzoBjaTpG5ojYqWL2Zsx7MMrQ3zomrgFRttjCQ7tVyMltNn13NwHRttFFFe4rmKwLNxm5NPrWvBt0vNLHV4ZavHKMn50b0Rv/f8OpeHLW6fRYyinDcvrSxx8mdliXyZEoA+a/1WFvKra232xolg5MYVJ7qqwrEsOoEryjcLNnstfvfacPlBP/z7iwuh7dm4CiaVbhJlhNlwNssYZaUYZNlW03GJ4ZUcgx0spQgcD9+3SYsa33G4P46ZpGIG5DniS+65FoPQIy00p3HO8+tdtIGbxzNOo4KiAs9pbEkbzNNUYFsy/a+aIWboSVq6No2wI6+xVI1jKVylMEY8rZNCIJ9ai4VuquVoPE0lEq1uCk9RSReZNaeVn+2NsRSkZckP7pxz/zym1nCaFGz3A+paBlRRUaELw2lcSsGyJMMxLWp2BwGV0eyNEv7m9hlXGm7vGxcGT7z5vvPckNun0fLrKy0JwRBrW7Ps6C+ttp+Zl/v40ftgkgojqRajqY1ewJW8w0/uj9FaZgprXZ+DSUpWafqBuBi+tNWjrDW95pp6ZafP/jhhf5xwHlf4lkVpy6zBGBnc5aW870UFgRKYKMpLxnHFhdUAozU3jyL2pwmerbBdi7qqySsZdFYPQRu2JRBb0TQZClF9tv2FnzgfKzBtizivyIqqoQIaHFvjWoq4Mni2wrUMtuPg25AVmlrr5rkMcVEvYRqLhVzfwrdriYXzBLvp+C6nKifXNTRwUtuTxqisDJdXQpKiYm+cMUpLOr7h0rBFnIt/fjdwifOKldDjJJaufKXt0QscjmYZr+32CD0H11bcOJqz2vb45uVVHNtaFmEQT5WHbagfL86TpOCP3jlikpaPUI/hy4mlf+kK+bOmYv/+9fUla6WsJcT32lqblZbPzdM5s6TgxSZjc8FWOJkJY+VhuhAKkU9rwywvOJqljKOC1Y7H1dUW47RkGheklfhHKAxrXTH+WW27fP/mGVlRE2UllTaczwtKRFk3oyZwhNc7z0pWWx6TpOKDozn90GaSliijGHYaauBDHZWtPh40pYVuvKclQssoTVULZUwpGvMi8b4AGfTqhuGQNl3wgpscZaJcDDwHZdUoo8ThMMrZXQmxULx/NOOFDdjuB9w5jYjyiqrWkv5eGbK6xrMsQtehshAxUF4xyyo2+yF75wmBa0sxUPCz+2PeuDB4KkWr38wtxom87//771zhB3dGnEYZqy2PYcfnTmMJACx9rZ92nTx+9I7yqqFiam4czYjyirMoZ9DymtOHQ1KKNHxvkrA7COmHHl+7IF472mhcW7zcx2nB5WGbKK8EV641WVHz/tGMNK+bTVY+P9koS/JKXC/vj1Khe2bCla5raIU23cBjlhRLm1kHYaDYTUdv0ZhlKWkmziLxk194h5eVJnRsLDkMstbxiPOCvDQU2tCyJXHItW0sx2Kt5UnKUG04i3Oy6lE4p2YxJNVYtqLl2LiW1SiaZ3JtacNq2218YwyWUvgOjBPhn19ZazGJSwZtFwtFLxBF9HovIM6FVOBZNkGgGHZ98T/XQs19fiCQzbevDR8Zlt88jvjee0cYY7i63uHV7Y+95h+vId+/ecq7B1OhYCYlJ7OcNy8NPpWX/pu8vlSF/BdNxf7uCxt894UN/uLDE949mNHyGrOdXDcfcM2No3kTWeZxFuePPN5iV/Zsm7/86IT9SUZe1Ay7gl8/t97hf3nnEGNEmVcZTVoY+qFmHBfcO5tjKcVq2+feuQTvLg7/C553VkFZVWB9rHI7iUrS0sFvbpCyqhsTKqBAHsMSbFgBaVFQ1osuyyxNkmwFgacoKoOFotCavPok/xjk5qwbZKNtKcpa0w1coqLiWqdFK3C5ut7hZ/fHXBm2ySvDPM+Z59Lx3z2P2egG2LZhOi1ITI3vOQxbPiOVE+diw3o4SSlqyRI9jTRuozL8o3eO2OoHS1n+w5/nk6hbFxu/loNJupTILz1ubp6iEArhk66Tx4/ejqU4nmf4ttin9gKXj45neK7Nasvl9mnEz/cm5JVw9dEQtwTTv7TaJsrl9FA3842TKhdnyWGbj05m3DyZ0/YcdG3wsJjEJVaTLOU073VVSQgERj4/1Qwry6rG8SU5CQXK1ihU49OjUNpgu4qqNDL4tBWVMVSVfP62Eh/1aVbJUNqWE5uyLZTWy03AUXKya2nDKC7ExsGyaAcOaeOBYhq+uCe0cLK8xlZgXANNExOXNaaW0wLGoBrhk+8InfEsylnrCHzZD13GsQjJjIGNnuDe/dBFG+iGLlH6Mdvq4mqbvNKstn1mebUMh5hnJT97MOb+KOHeWUw/dJmlU+Zpze8+N/yECvitvQl741TEdsgp7Hie8dHJnBe3er+RCUCftb5UhfyXpRUZA2/s9pcDs25g0w8DjmYZzzWmVlkpwQ2Pf+gLP5NvXBrytYuGv7s7AsSt7iwquLDS4mCcMis0vq3Y6EnK+0/ujdgaBLyx22eUlBhE+mzVD6kv+Vg6jRZHw8C1qSrNtC7o+i5RJnxfu2mvlAWukSxLhWGalsvBWY0cvbuuwnVsPNeiqDRVLQNJZQmP+bME3kVt8JRg8F3PldQiSrxm86vrxpJWKfK6JnQVtRbY452DCZU2tFzxFFnAKXvjlM1uKIpaxPZ0rRswiguirOJgmvLyVg/HUeyNE37/+vozpL/I99c6/kN2pRWHk5Rh1+Py8GPtwMPXyeMCjUvDFuNEYCXfEXsC35Xgg/Oo4K8+OsV3HTq+TVHKYFcD/4+/vsPuaou/d2WVV3f6jGL52UlaELo2e2OxSS0rQ+BYOB2PoqyZ5SVo8F0ZOtdGLTfgotKNgEoRBqKInKQFW72QV3f7jOKM87hgf5JhGjylVoauLza0caFRpinOgFZSpBciWKOgqGTDQH5daK8GlNJkWvjdvqUa7rkC18a1hfGktWDdIvzVdAOPvK6bsAdDaNu4vtUkD9UYauyi4lK/RTu0ubhqcW29zZ+8f4xqaJ4YQ1Fp2r2ACjlhTPMST1lcXA3ldKMs1joCgViWBLssTlUHk5Szec4kLrBtxUojpLp1GrHe9Xjz4sojXfZHJ3P6gehA7p1F+I6i7dl8dBJxcbX1G5kA9FnrS1XIf1la0WKQthiYzbOSn+9NKCuNZyuysmom4O1P+I4fTTN+cn/MIHRIS4PT0AotZfj5g4mo1TAMOz790MGzxLp10HLpBS4PxsKLLSuzhBIq83HSysMCjmlWkxTCTMhqKOuCauGdUgv04dqKti+ez5OyXLIHbAtCi0bkYeh5NpaCcXPELyrxpF4EA8CTlYALL+u6NlS1ZqsfkFUV2/0Of3vrjDSv2E9KqlqqyGrbJS2FX/zB0QxHWWilqY0MrHq+gzYWr11Y4WsXetw6mTNLNW3fJs5LzqOCSVqwqYKl4GRvnPLW3oTvvrDxTNeE2JXOG7tSl7tVxN3TiNd2Bkvc8/Hr5PEuf56JMdgsq+j4Nt++OmRvkvD2/oSVtgsoskKz2vGZpjnnkXC8d/shf3PrnLf3prx+oU/Ls/Eci9MoZ2+cch7nBK5NURuyqqYXuGy0DbPmc1FIfmRWyWBPLbrxpi3vNsEegWsx7Hji521ZTfOhxYPHGC6utNgfJ4zTkrz8mIroNbxD19Liw6NkjhJ6LklUCKvFagy1ao3nys9sr7Q4TwraroMdKBGrFTW2MvieiLJcx2Kz67M/zmh5tpheAW3fwXMsokLR8W1macUsrzAK3tjtcH+UUBuI45KWb/CaGUrRHAmNgufXxAl0kpb4tmJnJWSallwatri23qEfuvz0/pgoq/jgcMZb+xMxgmsF1Fo+77LW3B+ln+iyTXMmbXsul9c6nM0llcmxrC/loBO+ZIX802hFn4adP36Uti3FhZUQ31GcxTnDts/lYZtu4HIyyziLcv7dWwccTlPWOwFtz+LBJMVCEXoSx9ULPdq+TVHKBL7tSifebdn4boDC8GCckpXVcnhYGbEX9flYGPLw0ojt6IJvm9fgO8KUWbBVVts+tmWx0vJ4MIpFLajkd1qeQ8t1GGclcVFiYeHaiqoyy0GV74CuWAYNPO5W4jTD07IW8yzHVmyEAeMkZ5J87BpnCw+SSWooSoPvWqSVxkbERCttyYNMq5qu0vz9a0P+8LUt/uqjM+6eRZzORdS0N0pxLIusNCRlTdtz6BuXj07mj6SlP20e0gtd3t1f2JUuTmoutm1xMEl5ceuzvavhY5Xnw9eWbSm+f/OUqpZueWsQUFSaNNdM0oJJv6TWIpTCwA9unROXNVdWW6y0XH50Z8w0LWh5LV7c6nE8TYmKitB1ME16j6413cDBKRV5WWOa2UdlEAtbx2DbYjzlOzZQNjx6cSjcHQSUtWZeVJRaYzdSzsCRKDejBTpYZGwWpcGyDeTlEt5bCVziTE52xhi6bZ9OKIKzWVqCsnEsi5YrFgGaCk87DFpywrAsESn1Q4HiqsaJ03EUU63p+y6v7vTohi73xwkns6JhwzSBzkWFmyt0ahiEHv/VixuUtWGSFpxHOdOsZKMb8t0X1nBsi9unEV+/tNK4IR5R1DKjEEhGzLs8x8JzLMr6k4yV6xsd3juYChvHtdnsBQSuxSs7/S9lEYdH4/d+49fVtfaS722MWf73woCpqDQrLW+Z5zdpOrDFUXphS+s5Fr9/fZ3/zTcu8sJml4urLTq+w+3TiD9+74g7ZzH/4Z0D/urmKf/+7QNcu8EJK815nPP8lnBXW66D5Vj0AofAk+5Eaxle3jlPGcU5AmzK8XVh9q+N/LfdHHsfXsIX/xh+qSrISoOjBC7R2pCW8nc7jkOTs0tdy9BukktWZF7IE1q2Ra3A92SgZFnWsgV/vIgrpINb6dgM2w5bXZ+u73JpJSQpNbatiPKa0LMIG+/uWVoT+rY4+1U1ugmUiHLNStuj4zpc3+gsh8g7gxDXsQh9h7KWGLPVlsdKy+Nsni3fhaTQn/qZPnxNjOJCjvtGrF47vsNqy+M8zh+5Th4P9/3Ma6us2O4FXBiErHc88lJz82QuYRO+jdbSEdu2DPo+OJoRpSUPxikXhx2ub3V4dWfQBCzAxWGLbuBIULdn0/VsAs/BUhZpUbPV85dB3QCeK3h3L3CZ5xX/80/3eXtvyjguJLtSwYWVFrU2HE0ystJQmxpHCTxmKwm3KJphv+uIgKfSEJcGAwRKYDrbsVnvh2z1Q17fGfD8eqdh64jUfpJIhqiuoe05bPd92q7AJ0GjS3BdG1cpCi3S/iSrlurYW6cxUVZyFhXUGGaNck3cJQyTRE5vIAV8vefz5sUVnltv89xah+1BQC/0ltDqnbO4cUMc8E9e2+a59bbMIGzhqOdVTa0Nl4etT3TZl5swjw8OZ7x7MGGelVxYaT3itPhlW1+qjvxp5jPPgp0/aWA2SYolTSkpag7HKZvdgFGaczDOm4IlDonSJRmmScl646tdaUNgW7Rdj8NpTuDZdDybs6ggLsrlgCctNJ6j2GjJ8THKKlzHLCljuno6bl0jF3tRa9JKbszNfoA2ikEI51HdyOahrCS6q+NZGISL3gtcPMtikpQUql52+48vBwhcOXImuRYaWZSz2jbcG2tCx6KsFG3PLB30Au0winKirKQUyJyqEpw/LytmWc2VYchLW/1HTkff//CUi4MWgWtT1jUPzmO2BwFJLl7ld89jtDYMQpdr652Gx/zkecig5fH8ZoefP5gQ5zUrLZfXdwfYluIsyp/ZpOhJ11Y/dPn2tTV+cPuMXuCyP02Wc4FX1vtMk5JKayZ7JaEnAQt5WXO38dtZhCz3QofQU8zSmq1ewOW1DpdXWvzd3TOO5wVlw3gqa8OFlTYPRjGurQhcW8zLnCbp3hjyuiYvjGwkxnB/lKCUoh+4ZFXFNLVwHYWrNFluKIy4Hirk+nBs8O2P5zKWDVlV4yjFeZQzbPmcxymdoENlDB3PZpaJd/5pnGO3PEZpyTSrCHyHF7Z6jJOCru/w/tF8OeC0LAtlDP3AwbKkgfroVHE+y8CS92UR+tzxZHOzbKF+WsDZPKM97DBNhdKqFEtGUduzafkScr7S8lBK8d3rG3zv/UP2xxl5UfHahQGv7PT4w9e2P0E7vH0a8fJ2n81ezigpsCyL1x9zWvyyrS9VIYcnF+RZOnkqdv40yOVhBsyLmz3+4uYp98dy9NXAoO1Ra01c1qR5zbAToIxmre1x4zgiKWo8RzHsBOS15vlNZ5mUk+QVXd9FK6graHsiBrEtaDkuu/2Qbmhz6zQRwyVbNwrPT/69hiaqS4gBWLZCaQVK/DJc26IqheNrml9YHMO7vsNKy+U0KpbwS9kwsWwAJSwG17bIGnzTtS1ats1K22WcSlpRr+WJn0gsQ7zQd6gqTa5rlCWOer4lwQkoUfZ5luCqnm1xPMsfMTXqBDY3jme4tmDag47P3igFpZlmBVv9cNlx/uzBmLYvwqzFDbzgCi+M0d7em5IUNVeGLVqew62ziAsr4fIU8MteW39+44SrazI3eXt/woMJvLQpLBUJNBY20PE8Y7XjE7oOcSn5jwsmxFrL4/KwzUrbl0LZ8TiPcg4mCVFes90PSIv6/9/em/5Icub5fZ8n7oiMvCvr7uquPtgkh8cMh7OzMzurtbS71q4kS4K8ECRbNiS9EARYtmwYECzrHzAgw7AACQYEWX4jwTKwXq8F6xiN1qvdtaSZ3eFwyCE5bDbZd1XXmXfGHfH4xROZXdXsJvsostnN/ALETDeLWRGREb94nt/ve2AYKYMgxncNlUhkqx64LFSkW5pLKo5avXu2mvNEWcHuKGS56tLyTQ4mBW1NDR+DpEDoYBalPF5X7TJZgDA1DCGRomSwILB1SHKB0GAS51zZG1FxDGUfkast5DjKqbs65zsVBEpg1wsSoiRnremyuVChKCSX90fUy/vfNnU0IXBNg71hoGyPM/VddScp3UlKrOcsVR00oawYBnFKnEsWqxk5BQW6apeUjKJhmDCIUp5bqs5arb5jsLngK99/Kdlc8KnYHy9vRxd9U5fNIMnoTpKH9ur5IuFECrkQ4leAv4OqD/9ASvk/nMTnPiju1zufJBm//satWaJIlisFX901ubw3xjY0Fn2HrX5InEo6VYvtMs+yXbUYhQXdccJC1VZFVNORsmB3GOKaakUwKlsZVdtE1wS+a1J3lUHWIEwZpCmWJpjEKYYQuLaBRHLtIMDUS8/tOFUPy30wbbOYgMwlu5MQ1zAYRumUfIDGkZW2pPTIRnmpFEr2nOdF6S9zx9a0KJThUlEonw0bQZLn2IZDw1Ey/jCLcXVBmBZkuRrYGYaGlgksTSPXCuqesqGdJBm6ENR9i8Wqhe8YbPUm/J3f+oB2xUZKqR4YqXjINw8DVmqO4mrHyjvjKyt1hlHKIEzZG0a4tsGFTnX2AE/bK2/e6LHVD2cy++1ByIJvz9wpH3eFddSH/nS7Qqdqz1ooUVKQZpkaYLoGLU9R5kxNyfK744hJlGNpKd86t4CpC5KsYG8UYWgal3ZHLFVdskJ5feukuJbqVbc9m2GSUrV1XNOmFyQcotwVqxZMskJFwZk6jmkxTlQmaMM1GYUZFdsiy8E2JHEpJnAtjTgpyKSKmvNMZU9M6RNeq1g0DR3f1svwEKkyYoMEWSi/dSEkoyinYheYQsO1lFe+8lQRKlmp5qiVuyjFS4VUrSRTrcwvLFXZH8f4loVtmuT5RHnW2wYrDYfTLY8bvQlpnhNlGd862+ajvTGeeYdRJBFslkV3yhG/vDssIxdjlmo2uZS45sfDR55VH5bHLuRCCB34e8AvA7eAPxBC/FMp5XuP+9kPintJcvdGEdcPJmilF/ftwZBJlJIUkrpjKke9ussPrh6y2nBpeAZZnjMK1bCmGyg70XGcqZQdVLiDYeicDmP6oWI4VCydpmsxjlM+2InJpJJI26XCLsoKBpOEOJPUXJ2qozynw0S1PaqOYpTEaTbrWQtU/1zKO0IPszSVLgrV24yyfNZ3l4Ijyj41yIyyHF3X1KCuKKiYBoeRUnYi1c9YutriDssIOYEkTjMkgq3+RKn5MvBtgVUOEpOiwCr7u0GsDLZavk2QKk8XUR7HIMjIZcw4VgZiL6zWmOgpe+OY3aEy7doeRDMa3C+9sMwHu2MsHYZRymrD5ae3h2rHkcljD/DVgwmgXoJZrhSuw1ANlYM445W1Otndk+QHxHQHt90PubI/JiskS1WbJCvY6ofcPAzwHIPNdoUwkRwGEV7piePZOi+sNPlob4wQguWag2cbvHWrz0rDZa3h8PJanfduDzB1wSRK2Z/EJLnysun4NrquFhHJsGCp5rI7jAnSTFE1xxFBmpEUBZqmYejKDmHKvfbKfrvv6Ir9pKlWWJgW6nqURi1CSqSmZPta2U/uTpLy3sxmrpiHEyVICzM1hNUQaAjGYYZtqXtLCkHLd3h+pc6VgzG3egEt12IcZwR5NvMG6k4SbENRA9eaXrmSL3BtHV0XLFVt2hWb/VHMSt3l66ebM9bSP3t7+xij6HS7OhPunO34/NZPd/gXP9lB1wTnOz41x+LK/oRRlLK54M92cPD5pQJ93jiJFfnPAB9KKa8ACCH+CfCngM+tkN+vv5kVzFJsHFPn/dtDJJK6bWKZOjd7gQpcCBN82+SNbh9TF3THCZM0x7cMmhWL7WGk/LirNqahjLeiNKfumDQrJoaumCxV18DRdXZHMf00wTY1glipHS1DCYM0DYbjDENXvVZyqDvKZlbmd5zrOEITVHJsNfhCU25vlq7hGAX9QPmw6CjpflxmNea5GvxVLJ0gU0HMUKa5lMIOTSgJfpqB5Qgc3SAvVOjA4URxg01DDc56E3U+SNgdRASOia1rrNRtNE1jux9RdQT9IEeWxVmTkv1RhGUa7I2U6CNKciVcEhrbvaDM8Eyo2AYHY+XuWHVNVhsucZbTmyg2xamWy8Xl6jHlXdOz0ITkw70JVduk4Zr0g5S3twazrMeHwVTxNwhTru1PkKKksRVSnZMUXFyukRUFgyij7li8WK9j6gI0gcwlt3oTklwlMW20fQZhgq5pjKMUUQZp54XEtQyCRJmFgUDXNJJc8upyFd3Q2B2qot2p2Xi2ck9My4KrBpcC37KQSGxDw7d01XYT4Bo63zrX5o1rfQZpQsUxmEQ5Qi+IUonn6mhFodwMpWq7BLFKmbItHdvQmMQ5UZqUL/0CzzAIC4ljKFqfnmtlzCH0w5gfXFG73k7N4cyCzr95f08ponNl0eCYBusNj+1+yM+eXeD8orJAMHWNsws+661KaS+hVMBv3+xTdVQr9F6MoiDJEAKu7I+xDJ31pkeaK4pk1YOqraw5OtFxVefnlQr0eeMkCvkacPPIn28B37z7h4QQfwX4KwAbGxsn8GuPQyn27siyP9wfM4kTNNSw6HAQYZQr1DjPOeV6vHkQsD8My7g3ySBUtCXXMvBK69hx6RJkuwLH1LiyHzCK1aolSDKGYUKO8kmuOyqWq+Ya9GQ5mRfg2QJNaOwMAnRNxzYFRS5m3imurWMaAssQ2IZWSt5L17uiZLwIxWGvlFtfQxOcXvB5++aAJJPHBpi6WnjhWwadqsWVw3TGGY/zO14ZU1dDS1c9bd816AcZlgl5UnqaZ6CJgkwqnrEoeetZVlB1LfqTFDSBjqAXxKSZekFYomAcZ+QShMjoBQlprlR54yjlVjfEdwzyomBnGPEH17q8vFZnbxRzGCi2iW3otH3B6XZlpjo9unoKZyoX9T9pXuBaOuJjutUHw1Tx13AtNCEwdZXb2anafP10ix/KQwSC55arXNoZ4pQv1INJwmbb451bA3pBSt01SLKcf3/1ECElzy356EJnEKb8dGfIrW6AkHCmpdgTvUnEMJK4ZsH+JEEWBWGaUS9MPFPndNPjpztDxk5eKhstsmIaYqxe3LeHMec6Pn/+Zza4PYjJi4KqOyJINfJM7UINw8LWU0xDMIoybFMrKYkFiYQ0k8RFRqdiqUKJahN5jhJcVXUdTSgWja4p7r0KzBBcDkYs+jbnFn2CJOdnz7XpT1IGUYquCRqeScuz0DSPUaTCmn3b4JX1Omc7Pq2KwyTJuLY/IkoylpaqdMcJb1zvqr54lLFZtremxVfXxGxX5ts6o0gxxHvjiLbvEMU5vnO8xH0eaT1PAp/bsFNK+feBvw/w+uuvP9qT9gm4W75vG1rpVGdiGUqVpiMohJI4741iWhWTG90JYZyRFpLFqs3eOMY1dS4u1RgnGTuDkIZjcnsU8dHhhCwvqJThxHFekGUFjmny/JJPnBVcO5yw2nQxdcFWpnofcUkBEyXVKorVltQxDZqOzs4wRkOAUH3UUt1MAbi22gIL1GoLIfB0A9dR+YrIO+yXMlNWeW4ASaG211NFpSygyFXcmDHN/0JgGMyogXkxYW+YzUqhRA1hBarnSfm7pC7pTxIcSydIVK8+zZQlgJQQJ4qvXC8DMHrjhN5E+c0Mg5i259CoWHy4G+PZyizpRjfg3KLP3lCFR5xb9BnHynhJSrhyMGat9AwH1SMP04LzixW2hxHDIOG55RrnO/4jtVamij/H1HEttTvxbYOb3YDXNlozmXzVMbm4XFOKwklMw7XK/q7Pv79ywLWDgIZnoWspgyBjux+xXHfZGUTolP1nUycpCgwdmp5NlheEecFHe2MWazaGrpMUkv1RzChKOdWsKK8bIbh+OGGrHxIkOaahzyiXizWbX3pRpVtdPZgwijKuHIxndEVZttOGUabsCEr15iS+swzQUAPvSZwhNFhsOYpdguRMu8LeMGIYZriWwUGQoAEd3yLJVZDGSsPFMXXOLlSQC4KaYyLKtKFhlHFhscKl3SFnOyqb1TF1upOYKM3YHyr7YNs0qLsWN7oBSVZw4zDA0AW/9+E+X1mtcX6xesw33rdVy3KaQDQIM1oVON3xWG24H/ueP69UoM8TJ1HIt4BTR/68Xv7d54q7KYhnF3wu3R4hUb7HWSYxDUHbddXWV9fYG2VUHZOvrjd5e6unhn26WmXFacEwSDgcqu1jxdYJ44I0z6k5Gos1FcxrOGoFvdWPcAydZsVGFjCKcsJMydnjcjlZFCjVna62daYuiKaKP9fEEIJeqAITTEMVTsvQSBLlTZKVjoW5LhlnKcmRqK8CtXLXdcVDN3WwdR1dlDanqBt4oudICpJU0vQsnlv2uXE4YRhltNMcz1TcZpJsNgydpg1Nf5uGomIamiAvJGkOji7wK0rxN45SbFNxxdWMIkfTpJKnBymHk5R2xcEzdRZrNrrQkLIgSAu+dqrJBzvqe3ttozWLYBtFKQUc4wR/baPJ3jCmHyacW/BnDnZBks2S0h8GU8UfQKdqc707ASlnvPKGp1wOgySbJQrZpkbdNXn7Zp+lmkPbV0XZt01u9jJ0Q9EgD4OEjaaHayo631rToztOcE2Des3EMTXeuTXEs5SJk2PpDMOEumtx9XCCZahgiwVfeaRrwOX9CQuuyeJilVbFZBRlM0XstFB1xwlb/YAbXSVOm8Q5P90dEqbFLORYE3dM01zTwDA0KkInSAtaVZuKZRDEGTuDmDMLFYRQQ8OFqsX1w7B081SCoWGodiTv3R6xWLUV0aDiEGcFvq1j6Bpf22jxtdJ29s0bPXzboDuJ2RmGVCyDb262VWCJVL4vWSF5Za1BI0wYhOmMeTbtd682XJUcNYioljOrqmuwUnc/UTvwLOEkCvkfABeEEJuoAv7ngP/kBD73oXD3NLrqmHznwgL/5tIenq3z+maTXqlMPBzFTJKUKMnZaLl0ajbnE1/Z3tYtDkYh3SBifxRj26ov3PQcxuGkdH2TrJQrt/1hqIQXRQ6ZZBymFJpGP0yomDqpXir4johw9EL1dy1T0HBsHEPQHWdolo5r5tiOQYHimxfF1CZX4NnKOyXNc1zdIEO1PKZhAgUgczUYVfa6gu1+RFA6ZclCEmYZnYqNdAQrdWUqhYSf7gzZHUcqKCAvZlmP98qpL4AgBZ0CQ1OsCzTBcsNlEqYMUS+nimOW7AedSZSpAuHoWJoyR6rYOjXXpOPbaGjYpqDqKC95ZeYxXf2q4myV6qc3b/RmdNKpze00Kf1oQMjD4pjiz9JZrtlcO5iwVHewDI3vXOgAzLbl02tkG0odOIkzbnUDTrc9giRnEKYcTFI6FYvtfsjVfMwwyjnVdJX3u5khZcGFRZ9LO2M0HSaJmk0YmskgSAhTFTjsmTqGodHwTLYHIVGe8+qpOqdbyk8mydTi5AdXu9zuR+yP1PAVVJjIesMlKXK2eyFfXa9zaWfM9YMxaOBaGkmZ8qMJNVcyhaBi6tQdg07NYbXm8M62WkknqeSjvT11jwnFZmp5NllRcDBWPXnHUKKxD3fHnGrdobZu94Nj3uHTNoehC17baLHg2yzWHLavR6oHj0qvEkKUASLxjIky7Xd7lsGr6w3e1YZcORiz3rT5ymqNV55ybvjD4LELuZQyE0L8NeC7qBf7P5RSvvvYR3YXPs2+9l7T6IZn8asvr1B1TIZhytmyUfzh3ghL19ns+DMflKbvEKYqXWcY6cSpxLV1PFNXk/mKwf5IJ0gKao7O+UWf92+PsAwdz1K0woPxlM2i6FSGIYgyiaHrpcWsxNFVPmSS57imhWVqrLoeWR6o1baU9MOYJCvl8nmGa+nUXGXnGmc5ozhVx1yx0cKkHJqpc1MrcY0cJZO2TeU8N2U3OqbOKM5plkEMHyQTfFvnhZUqN3shO+MQTWhoQq22DXFvfjuUhl8S7PJnR6XvScU0SYui5L1T7gZM1pouG60K1w8nXD8M4NaAi0tV+kFCkkteXK7x7z46IMlyFqs2QZIdG0gt1/2PuV9e2R9ztuPTnSSznudy3S/vlf5Dpb68st5gGKb0g5RBmKi+cNmPf/NGl1GUzux21d/1sA0dzzJYa3qzvnlvkrBQdZS3eUWttnVd0J2o65MWyofc0DXSQmXGvrhWIytyPtyfULWVQRcYXNsP2Fjw0HWNlbpL07OIs5w3rqUqjLgXqOIvlD3th7eHdCoWK3WXa4cTfnitS9O30UE5IMqCV9ebvLSq+v/9IKYo1C7R1NXANM0kmiFYrDp4ls7Nw4B3bg1ouCaOoRMlKRVbZxRlRGlKmGSM4wxNU2yXqm2wXPdY8FVw9eEkxjJ01houX1mtHfMOP9rmmK7QgySjYmlc3ktxTY2KZXD9cEw/yPAdne1+eOS/VS+CKM35xmaLP/uNU1+a4n0UJ9Ijl1L+c+Cfn8Rn3QsPYl97v2n0vUxwpiEGRUG5dY8wdcGLKzX2xjErZQQZQq1mZC7pRykNT/V7VxouWV6QFDn9MMUqpfPDIEUIJb92yi20JgTIsqghaPsWaa4EQHYp74/SgvWmxzvbfZJSn2+WBTDLgSTHsTLCRA2oTKER5ClCaFi6TlDKsqeRW46j0/ErfLSnkmtUNKlUYh5DL6lgGmEiSQvFM19veqSZ+plRlGFoAs0QaMCwzA2bNiumHVWJMlzKpMQrTYqqjgVIGp7LesvjRjdgEmW0qzbNisXhJMHQBM8vVbEsxdwppGTBt4gypZY1NMH+KEbTVD9XIDm/WOX64b0VvN1Jckwk9KipLw3P4jsXOsfoh6auLARA8O72kEGoinl3kvBvL++zVHNYa3qzvrkQ8NbNPgWwVHWo2Drv3h5hCA3JdPgmGIaK7vfCQg1DF7Q85dhXsXUqthLiBHGurBVsa9ZuGEYZHd/mpbU6W4MQRzeouTq2bvDjW32arsVvX1KWy0GcUrENhlHGRsvjcByxWLW51Qt4abXOzW5ImKRYuo1nl/L6PCfNlfHV+Y5q/2S5ZLXhsNrweOtWn9Ol4+PvX+1yMElYqDhomihFZQLL0JBILi7XeG6pyh9c7/LSav3YIgvurdKdFmbPNiiKgkGYcbOr/OtrrolnWtweRFw/VBL96cLubuvjLxueCmXng0vwH2wa3fAsznZ8vv/RoUrWMTUcy8BzDL61pCLNfv/aIf0g5WAU06o4nG5V2GhWuNmb8MJKnawoZu6AaS7Z6k4QmkbVsRgESnadS0AqS9esUENP09Q4v1QlKwo0NOUVrqn09YppkOYSKQWFVEVNE6rnPQxTXFO9IIIsI8sUXQxUb1MW4FlqJZ2VDoJJhkoFAqW4zCVhosyMKrZOkhekiZKS3+gFdEp14jBUw19NU74pdqYoXEIILFNjHJWxdyj2TCYluVSWunGWU7MNznYq+I7B7lAjM3UqpaFXfxySFDlLbYevn25xcbmmAoaTHFNXrn62obEzDPnhtR7/4YvLM6bCD64c8PXTrWPf5d1ijsdNUD+6QuxNlIXD1IxLCMHtfsTucJeX1+qzdsqlnSEXl2uqMK8oFsblvTFZqbBteianGi7745iDSYIhlIOlEALTENweRKS5Es5cXKyS5AW3ehGebdDxLYSQbPVDLi5XATX0LaSk49tUbANTaOiGGpR/dDDGtQwVXJEXdLsBlqnRqarV8c1uQN1NcUwdz9ZZa3gEac5STZlv9YOEXMIvv7DEtcOAfqR2f5O0oJACTZN0g5j1ZoWff67DmW5Ab5JwsxfQ9iyiNOej/THuIOJc6VIokDPv8Pt9b3df/83S/fDfvL+PEAJDF2Tl4mqxavO993Z4ea1xz5f1s5LD+TB4Kgr5g6qx7jeNvvuLbVUsruyPObNQYb3pcvVwQnccs1J3GIUZvSCm5VrcOJgQpAX9yYibvQmOofPHX16hFyb88FqfOJW0Koay9jR1dE1jECQYusYgjEkyRe8rpA5C0PEdPFNN6s+0a4zijDhTA8ZrhwGmpaMlGWmufJ8NTQ0B9dJWtlAfg2+ZUKi0lbyUXwtUYIZrK9lGUmrxs0L1zF3boMgVh9wUSkCjCYEmBLqAOFGh1Mq9rowR05Ujn2PrpFkx6x2nqUpqqbqqrTB14zMNFavlWTpX9gNeP9PkG6db7I5irh+MZwZJjqHjWfqMUZDmBXvDiHOL1Vmgcpyq1kMvSFisqZzVlm9z9WDCq6fufMd3izk+6V55mAd8GKakuXpdXdoZsDOMZtFyzy/XZ+2UH9/scThOuNUL2FzwaXjmrJee55LrhxMGQYqpCSqWQZRknF/yKQrJtW7A2cLjl55fmiXZHIyVQGij5dKsKGGNUYY2XN4dEqQFAjkzy/pgd4xjChquzTjOGUUpnqmTFVJlvBaQpgXbvYgoy5WvixB8sDtkEKQYukanaiuVqKFRdyzqpXAtSnPaFYtBoAzE4jRToQ5hxnPPV6k6Jit1l//9B9cVvVHXOBgrZ0PfNviNp5CX7wAANBhJREFUH91kc8FnsaqEPlNJ/L2+t7tx9WDC5oJPbyMlSjLCVKLraqcQp0oMd/RlPY4yvvvODr5jfCxo5GnN4XwYPBWF/HFSsadF++hW+3vv7bLZrhx5EHQWfJu3bvQJ0pwz7QpRmrLScLlyMEYTSgW6VHP43cv7bLQrrDRcqo5yhRvFKRKhRD2owjEM1cOHFPiO8ptolmnhFUvn3a0BF5ar5EVBzTXxHYMLHZ+KpXP9YEKmqYchiJV4SNOUTNrQNGWelBUlLU8SZcUsoCLJCvJcmWhN7VBlDmmQlTalqJT1vMA09JnyUxdq0CalkmIXEsXiKZ37ypQ4JrGKJZNCORdObVPVoNJis1Pl6sGEQZjwu5f3WWu46JrG6Y6PLKOLhCb45ubCzCvc1DWSvMA27jBNBlFK2zMZx3fGrZvtCm9c732sd350sHm/e0UIHqrlUnNVn//SjgqrcC2DNMvZG8S0KxGjqMx6Kil9o0itFiUq+3QYphSyYHOhQj9MuHYwYbHm8K1zC8RZwaX9IaeaHq+sN2fX4esbLd67PeBgFGPqise+0fI4v1hlECS8ebPHi7MV/4ir++NZG3CrHzAKE7JcCX2GsXIenMay9cMUXZOkmaK+Ukw9dnKqtoGlaxQSRnGi6Jz9EEfXGQQJWSl3X6w5anht6Lyzrdo4P9kaKIFTuZA51XKZRDm7g5i6Z7Jcs1lvVnhnq8+Z2CfJcrqBEkn98otL9312P9ofcXGpRse3SXOVyKUojCndICnbXQqjKOV6d0KaqxamIQQ3ugGupT/VOZwPg6eikD9OKvb33tths+0fe3vnRUF3EiMCUfpV6Eip1HO6JhiGqcrIzNX2tT9JGcUZDEMGQUpSL2h6SuYfZQW1XFKzDd7aHpbxWbL00BDUKhZpVtD0TTUYddTgcrPj0/Ft4lwVi+eXa+wNI6I0Z0sPsMt2jGkoKXbHtzkYJ2gaCCmUwrRQftOuqRNn+SyAohCqkFuGEvQIlPCoyJV9ALIogyGUz0ZeSDzbIM0KHF1TFruaktWYpgoMrjrKbx0BSZZglXTIRCvoBymOqbjCe4OIm90AmRdouoZoKJ+Z3iRC03Q22xUuLPnUPSW4CtOchmfSqdoMw4Saa5XnohLVffvOltzQNb660ZjZEd+rfXa/e2UqHnnQlsvmQoX/7/I+3UlS/qxa4bZ8NcTc7ocANCsWzYqNqSvVZ5BkfP+jQ84sVJQNQT/kpTWVBekYOnXXwjDUtf3O+Tsvs1GUlnxqxfaRUu3IhFD3o106IaZ5wXY/JExyorTgYBxzeXdEx3fwXVOZmeWUIQ8FnqVRyEK1AkvPnaWai2UIanlOP8zwHZNTLY8kzdkaSHRNsYd0AVe7YyqWwfllH9vQ2R1FrNQc/u3lQ860PQopOdfxudkLON+u4FkG24MAocHFpSoS5Wi4mfj86EaXlbpHy7NoVWyu7I9nnjh3P7uWrvP21oBzCz5b5bWWslCtPE2jVbFn39V2P0QD2hXlhaPuoWLmR/8seKl8Gp6KQv6g/e+3b/XZ6oXqhrWNUuAC3cnxbV3Ls+gGKbahUyuVX3GmmBxZLhlEGQ3X4Ho3YBKn6EJxhQdByiRO6U4Smp7JrV6EqSnbzsMgoeWaOIZge5gor+cy8DbKVbZhdxLz3FKb84tVbENTniJ1l9/u73LzcEKc5eyPklLNWSiv7jKdZjqA3BtG+LZJ3TGJ84LDcQJS0RtdSyfXCoJEiYSm1rICoHRHnAqBikJQFAVxpkIhTA2EoRLZ665JWqgQiyjNMbWcOC/U8M5SNgS9IFEycdsgSlWoQSHh8v4YUxNouvI+L1BtGyngVMPhF19YUtv0LCcqd1XfudDh5fUG33tvdxao/Op6g6v7Y5qeNSv49xteP8i9MhWPHMUnPeDTOcruMCptejXWmw6tis21gzGHkwRLF6WRU87ptupfZ3nBW7fUrqHqKKuBi8s1Xlmr8/7uiM1OhZprstHyMHS1AxlFKZd2RohSdGMZOr/9/i7PLVdZ9G12RxEf7IzYXFDFNM0LPtwbo2uCQZQiyrSetYbDrW6EZ2qECeiWQZZLHFO5VU5psOcXlff6R3sT6o4yz5qULZyvnWqwUHUYRxm3h0p9GqY5/SBRL/ryJdqqWAhNMBinbLQ8LF3j9iDkbMdnUHr+11wTv3QgjNOclbrHt88tzK5xkGSzF+nHdCAdn7dv9dgbRzy35M/an1/daHK6XeHK/ni2MzucJJiaCgfZ7ofEWY5t6DPP82fBS+XT8FQUcvh0NVY/SPjxjR4Lvk3NUTS9H9/o0QtiruyPCEo5t5SoyXymGAJRue2O0pyzHaXMOxzF0PbojiKKQrJUd/EtkzDJcS2dG92AqlPDNTVudifsjRLWWi6nWga7g5iOD0VhEqaZ8lPRBP0gnRXlrCi4uTdhf5zwO5f3uLo3YX8U4ZoGnqWz1nQZRSlSCjzTRDME272ANJdKjm9JbEMwigtMXSClwNEVh7oo7gh3clCtDO7EuqVFTt21ccoCJESG0CSFFBilJe0gSqnaBkkZFuEYKs4uzSS3wxBDV62ZJM+RKC/sIJe0Smm3usaS9ZpFkedqkGzpnO1UWaw5M074UTMjgOeWfD7cGzGMMy7UHf70a+vHaIUPKqW+173yKGZJqw2X51dq6EKb9e6jNONMp0K9DKYukFxcVv3iUaR8Xqq2OSu400GooWu8ttH8GLsGYKsXECYZh5OYhapDEGecanmESc7eOObq/gTD0BS/2xA0PZswzuiWebJLvk2ttBXwTDWz2B7GCCGZRhG6rql88DXBD691ObdYLSmH6iW+VFM2sutNj5Zv0apY/OaPbnFxuapEOXnBrX7I2QWfD/ZGKm6t1Alc3htxvuPz0d6YvVGErmmcaftogtkc5O52CBx/kd5LB/LyWoP3d0dkheQrq/VjM426a85e1g3XVK6XjslqQ/mWx2lOxTYeS1fwNOGpKeSfhqsHE1q+jRBqO5oXsDuKyHNFZ/tgZ6h6tS1PDUps5X3x4e6YxarNxeUqu8OQ5ZrL2bbP7WEIAmqepVR2UVK2XdQy93Y/nBXMmmPgGhptz+bmYYBlaCU/V1J1DCxdZxBlZXLQmL1hiOeYHA4jbvVDBqEyQoryHJlIap5Ju2Jxux+R5DqioORVq+10lOYYVZumB8MQekFOxRLkuk5KQVEmsesoGqNEsVosQ1EgVWiDwThREXIVx6A3jpGApWuqjzlJqXuSqqNaVA3HUuG+pVlLxTZUKICt064ov/JxlFHkEt3QWGu6LNVcbg9CNE2y2qiwWFXb4buHj9v9kNuDiM12hddPt2er75PEo5glbS5UuNULlFBMmoDq0a43vdlA880bvfK+UDOB3kQ58vXDhKZnYxsqmmyt6R77XUd3DtcOJyqkuulhGRrvbPXJsoJaxWTT8qk4BnXHYBDlIAWDIKUfp2RZxmrdI5eS7X5Iw1W70OW6o0zXioKdQUJRSHRDUPcsJnFGkhV0RzGnGpWSAQM7g4CfPdtB09R5Xz2Y8NJaQxVaIQiTDGscc3l/pBwzy3ZP27fJCkleSF45VWfBd5TyM8rYaFXUnCdRv7MXJrxxvYdvq0G3ronZi/ReL9q7X35HcT/+uW8bbLQqXD1UFEbL0J4JL5VPwzNTyIdhyma7wge7YwDluqfrBHnGeqvCKEwVAyVMeXmtwUcHY+qOya+8tMyPrvf5zbe22GxX+LlzHVYaakXsGMrJMM0ktq2z0rTI8oLdQUiaF0RZwWrTo8gLbg8jmp7NZqfCwUT1O3VNwzVNNA3avsVi1VGeJ6bBKErZHaniiVAMEV1XYpH+JOVnzrYYRhkSyZLvkklJksU0PI1cKu/r1YaL0JRHyzQF3bN0jLwgStXgR0qVpF6xDVxLw9Q0gjRlHOekhXppDIMEy9QpsoJCSAxDR2Y5aemgiFTMkrzkoqcyp8jVbsC3VAbqc0tVRpEyx7J0jWbFol2xyPOCKMlY8O3Z6mx/FHO9O+atmz1avk2eFxgCbnQnswHVOMo+kWL2sHgUs6SGZ/HzFzq8favPh3sjJIIXV+vHFINf22jy9q0+P77RJ0xyXl6rY+hKFKTYR1BQ3PO4p8Xog50RYZJhGDrXD8a4pkFIzv4woWJG2KZOmBSloVrKrV5Iy7WotipUHYPrhxMWqhY6qpW2N4r41ZdWeON6j95E6RyEANtSdMaDUcyNfsBCzeYXLnRUQMUwxDTE7NyGYR/HVK0fz1ICpe44IkwLznZ8tnohN0vVa81RO67/9GfPzM5x+pKeKmAXq8pXPSPno72Q37/a5VTL5U9+dQ14PFfCu7/blm/x9TPPfvE+imemkNdckyQruLhcZbsfcjhJ8B2d55arSKnEGaBWCsMope6YDCJFMTuz4BGlGZ5pzAYrW/2QxarN1YMRbV/xhfdGihmy3PA40/YI04KKbfDR3lj1SnMl7BlFI+quhS6g6pmM45SGZ7Jcd2l4Jq+sN/n+R4cMgoSaZ1GxTLoTdcPnmSTUFeNgsWax04tZqFlIlHpyqzfBcwxMTXCuU2V/nCiRUSbZSTKitEAIZW06Ex7ZGhstxR7JC0mlMFiuOQzDhNvDmEGQUnMN5V9tGkzSHF3TQSpu8jSJPc4KxaDJNbCUt7SUECY5W33lk1F3Lb652SLOcq7sT9B1wbnlGheXa/i2wd4w4p2tPghBL0i4tDNhZxDw0mqDjQVvNqDqTuKPUczg3sPJB6UVPopZUsOz+EPPLc68se/176uOyTfPtrnZDUjzAsfUaVYsTF1wqqVW2Z9UVHzHYBKnbPWC8mdNRocplN72YVowjFRASbNsX7UrFnGac67jc6rpcasXsDuM+cUXlhhFGaeaHoMwLXvJOVXHwNY1pVNAstmusFp3GScZy3WXtabyqZkepwrVGNBwLWqOwYd7I6JMJd7LQrDe8tjpB9zsKZrp88u1Y+d49Fq/eaOHvaDTDFN+cPWQvJC0Kxa2oR8beD6OK+GzaIT1MHhmCvlR34XnlqpEWc44SrmwWJ0NQEDg2zrjOMcqPZgbroljGjQ8U+UQlrFeqw0P0GiU9ppJXuAUGs8v1XjrZpetfshaw1NhFXnB5oJHVigflrpn4lvKDS7LcoJYRZ4FScZqXXkrV2wDXdNUoG0hKWRBkiner4xz3tsZ8NX1hmrLhKmyHTU0Njs+k0Sp/n54rUu7YuEYGu/fHpIWEqGp+LG6a9KPMnRd0nQtRe/TBIs1Sw1CywQlS9ewdME4UnFxFUtRAQ1No+oYajVeSBaqlgqW1gVRUmCbGp5lcDiK2RlFRFnBLzzX4eyCOr6Vusurp5oz06LpA3owjtns+PzuB3tEaYFn61Rsk/f3hhRCquEgn95TneJxlJxHP+NxBCTT/u5qw+XHN3uMooA0yxnH+WwAOL1H7yVYqToGjuGzPThAKy2RX16vc/1wQm+SMklybFMnKgp6k4ymZ/Lccq089pS2b7He9Pj2+QX+0HOLvHmjx/4oppCS0wsVbh4G6Lqm5jCWwTiWLFbhYBJjaYLtQcgfubjIMEyPnZc4YpUWlD3n9aan4t8S2GhV0HSNC4vVTwwunl6fm92A8x0fxzRmbohFAd99Z4fluvOlEe98Fnh4i7gvKKZv9Ck1baPlsd700DVlDjUIE/phwkrdwShTaDxbxUcB1MoVtJQFvUmClKoXXXMMlqsOLyzXaXg2a02P51fqhGmBKFWNC76Frmk8t1TldMvlhZUapzsV0rxgue5xdsHDMnQ+uD2m6hh8tDciL5R3dncS0w1iTF0jzylDAzSVBTmMeHWtyf44UvmNUiXFNxyTV0/VaXrKXXB7GKFpgrMLHgsVB0PTiHOJqQmqlo6hC8ZxzlLVxtA1ruyV6T859MKEDJBC8cmTPKcoV23N0mGu4Vp0qjY1T5kXgURDpRD1woTlmsNKzaEo4N3tAUUBVceYFdPpd/MLFxfxHYMPdkZs9xUXWyLoVC0KCYeTmINRxFs3e6rwh8kdvjb3Hk4eZTtMQ5qnKesPgmmYxLvbA67uT3h3e8DvXd6fxck9CKb9XWDWKpskJdMjVyHSSVbw5o0e1w8nvHmjR5IVND2LJCsYhClhmnGmXeHMgsdSzaVim3z7XIe0TOupOzoLno0Q8O1znTIHU6dVMXlhpcZa050V082Fskds6ry20eS5JV9lf+aSMM5YbzpIJL1xQj/MqFjKtfLotZUSXl5rYOqKXVW1FdOmWbH55mabqqPajkmmWi1HWypv3ujxO5f2ePNGj365ug7TnHGczZ63OCvQhFQeKmWhn16jh7n2cyg8Myty+Pj2arryidKcF1frAGSFZKPlzcyRojRDlCZR39xc4FpX3Vjv74w4t6j450HJKBiGqWKPZAWnFlxe22gwijL2hoo7vTeMqXsGgyDj8v6Q55ZrCARJljOJExCSf/nubRZ9ZbtZcwzCxKQfpkxi5SI4NQlSAiKLbpiwUvOwdMHNnurNn1+sEiQ5dpmZWHMMhkFKL0iJs4Kqp2hfk0jlhi6Wgo9JnGOXdqi7wxhDV8OmIMpUAk5pG5AjlXdMlOKZBqtNm0IK4ryg7VnspHkZH1YaP+WS/XFMIZVT3U+TIb0g+Zj7XD9IuD0I2RmGQMH+KKUfZqw2XFaqNqMkY2eoVux/+OIiVw/GvHWrzytr9Zny8e6e6eNmMB4Nk/Bcjbi0N5jawT4IprvBrV5I0zVpeTZJWnB+0cezTG4PIi6WK+gpx1yJ0UYz5WbLt9hoe/z4hpobTCl3aw2XVkWtZg1DcK7uk0vFlLlyMKZAWR3fbRRWcwwEMEkKXjvd4j+4uMQ/fWuLOM1Ya1X4cHdEkCS0hMUgTI5d236QsDOI6IcJ7YrNc0tVWIK3b/UoJNzqB7QrFk3P5HTbn7VH4N6iq7Md9TOGJmbPW5Qq3YMmBO2KOXsJw7Mv3vks8EwV8rvxSX2z64cTfuunO/zk1oDFmsNrG010TRDGOb/84jKHkxhZSMYlj/xmNyjNnRyaFZM4U0wBNcBz1GrD1LA0HcPX+NH1jDMtDctU4coLvkUQZ+yOIjzTVDFlpVyyH6VoKBMthFrpupZigXRqDpsLissb54rHK4DuJKMXqOFTrXTLG0ZKvp2mBaMiVSvBvKAfpehCCSZqZTh0L0iw0ZE51Eo5tmMas/DdYZShSSXV1xAs1mycSAUGdIMYkUsG4wzPUi+MaVSbocF4mBOmOf/uowP+2Murs2t+9WBCx3f4/bCLEDrtqsYwzLi6P+K1000aFYvnlqu8uq4KStUxubI/5tLukK9ttI4FSkzbEkLwWBmMR8MkQLlD1qXJh3ujBy7kd/q7YzQ0fEdlaTY9xdKZ8pldU2d/FLHedPlgd6SMoByTKM34cHfEf/7tTU63K3z/o0PevNGjO0n55tkWqw2PC4sqlcgu2UG6JlhruMecGI8W0GmizvMrajZ0aWeIY+nKanYU0/Yt+pOM/bEK9piuqqcr6gXfZpJkjKOU928nnG77rDc99kcxSV7QrtjH/N+P5qjez9QsSgt+54M9LF3jXKdCd6K+w6PhD18G8c5ngWe6kN8P/SDhyv6Yr6w2uLhU4+rBhEs7I6qOwUtrDRZrDp2qUuXVHJPLe4o+VnctBEo8VHct3r09VIkmhkbVNpBlDFjVMdnqB+yPEnQ9nRlBVSwd3zGxdI1+oCKwRpGyIFXGVwUIDVEaUEFIs2Jh1RyuHU6o2yaFlGwNQlqeSZQZZJlyxKu6Kp7ONg2GYYIudOJC9ZyDJCfOVKF2Sj6ia+oIIJA5Wi7RygDcVsXG1DX2h0omjlAiou1ewPmlGofjmMWqy1Y/QGgaYZJRCBVoEaeS7kQNdju+ze99sMe3zy3MVuXDkvf8ynqDd7cHHI4TWp6JECa6psKqp+nooAr5K+uKAnc0iOBYwQpTJCmLVeeRMhiPhkkc/Vs5Y94/GFQxbx3Jlhwem8uAesF0qg5XDyalonhqxqXR8m3evtUnLyRnFiq8sFLj7a0+Vw/GM/Wnpgne3xlh6HB2sTJrXU2vydECutmucPVwjO8YpWgmpuaonVmSF+Q5rDQMNM3lzILH9z865NrBhJ1BNPMEdy19Rhw4GMf80ZeWeetmn6ZnlS02haPF95N2R46p8csvLJftxIRBoMKRp+c3vUbPunjns8Az0yN/GBztq9Zci1dPNfnm2TYS1Y+EO3Fe3zjTwjHVoOhWNyArCk4v+CqAVgqyQnIwSegFKdcPA/79RweMopRvn1soMzZN1hoOk0TR+V5db2BqKt/ycBJzexgSp3KW31kAjmUgJWRFQdu3VMiChLpnsj2IcUzBZsenahlIUZAXBZoUvLbRYNG3Wag6VG3lHX2q6bLWUGyZzbZLL0jQNDELjXYNxU7J8gJDCIIkZ6Fq8/MXO3RqDr5j8NxSjYpjMQwTorQoV5ESVxdkucQSgjDJ0Q0VHXZ+sUrNUZYEVw8mswL84f6Yn2wNqHsmP3e+w9c2mni2ScU2Wao5fOtce6Z2nOLog32vfnin6lB3zdlsZCo0etCB2YVFn2GkWmxSSqJUsZouLPoPfV9tLlRmApS75zLTv//Zc+1ZgLL6fUrhutmucHlvfOz8zi74SATvbPd5//YAWRb5nzu3SH4kym7qjHkUnarNSt2dXZeGa/HqehOBYnCdaXvUHAsNldWpeO9W2VYc8KMbXT7YVTbIL63WWK47x1J57vUd1VyT/VHMpZ0hb1zvcWlnyP4oplaKdzxL+bU8v1Ln2+c6fOdCh/1xVIrI5OwafVlSfU4SX8oV+f36qsr46s42farUW6g4dHxbxZ6Vg/xBlOHYGkLAwThGBxqeQT/MuLQzYqPl8csvLfPO1pCdYUzVNjjdrrDW9IjznB/f7DOK1RZZ1yDNwdQFrqER56r3fKY09srIWanZ7AwjpaaMBT+8dsggSGn7Du2KRXei+ppSSFbrDmlWkEsIM4llaKw1XHZHMTvDCKtMW3csjbZp0g0SpBQYhjqfG2XeY8MzOVupsFRzkAi6QYxtCPphim9rxClYvk5vEiMLqDkWq2X6zShKOdtR5kv9QPmVPL9U5drBhPe3Bzy/WufMgsdy3WajVaHlW5/KJb7f9xal+T1FIw+Cu8MkTF1jvel9jIXxIMyWoxS6u+cynn1HmPLVjQY3ugHDKMO3dU63q+ilw+HRglx1TF5Zq/Nb7++wVPNoV8yPtTO+tmHdU0wzjUC7W0l6uu3RmyT0EmUbsd6s4JgCv8zWdE2NS4djal7OhU6VOMv5yVZ/di6f9B0NwpTfvbRH3TVnStetXsCffm2daweTj313napNlOWf6J0zx4PhS1nIj97400zIw4lqJeyNotk2/crBGIHk62eafLg3Ym8YYeoaW72APC+wXXXDrdZddgYhQZxTdwwEkquHY37t66f49rmFWYjF9cMxgyAmjHM6Zc9ZFij1o6lCITIpEQW0fAPX0lmue0gk720PuNULcAydUZQSZ8rnfFrIVHo8eKaOb+lcGyc0XZPVmqJPpkXB88s+aaEGmXFWYJvK3a7hWTQ9i2bFpGIZbPdD3t8Z4hoaL6zWsAyNl9frfP/KAdu9gHOLNTpVmysHY5Cw0nA4HMVIAUGSEyQpS3Xlencwjlnw7VmR+fkLHX7v8j7vbPXpVB2MUu16fmn5U7nEjyKz/zQ0joRJ3K9IPwzF8UH4zK+sN5RRWRlPNy2G5xer91Q3rjUrfON0i3Gcsd0PGccjKpaOZytm0IOIaabXVtcEP77RY61ls9mu8M72kELKY31qQ9cIZ4HM4lib6ZO+o6Nq0FE8NeOq0J0kD/SymePR8aUs5NMbfxxlXD9UNrWmrnG6VVH+KKWhU5wVvLzWoOZa+LbB5b0RNw4nDKKE71zoUBTK8H+hdGLbLmX7N3sB/TDjN350k/OL1VkUWZS5jKNpdJvJYtUmyaFZUQnygzABdFbqNit1m2+caatgXE2ZdnV8h/1RxKD0yi5yE9FUmZFRmuNYGkFaEGaSTtUiTgu6UcJixSZOcyZpxstrDYIkR0PgWoJBqFgTUaYsV/dHEQWKutiqqNQaiYqn++qpJjcOA8ZxRsM1Wa459IO09LexsAz1OcNIFcSrh2NqjnlslblSd/nO+QV++9IeVce4pxPe/Qrh46j/PgmfVnwfN6zi3r/v48UQuOf5XVj02R/F3OhOZgPSYZgwiNKPZV9+0sp2Km56Zb0xe3Ed9SkBlTI1FRNNdwyvrNXJjrRy7ne9hmE6U4NO4ZgawzDl1VONz+S7m0PhmSrkD6fwa/Ldd3ZICz62ZZ32Wadq0SkqZY+v4VozF7fvvrPDwSShXbE41fT4cH/E4Thn0bdwDGMWD/bzFzrHGAZZIekHCZd3x8Sp4pRbukPdMznTrtAtg6JtQ+PSzohbvQBKD5mao9gFwzjjxkHAn339FJf3J3imwHNM8kxiGsoPQwrUZ0kJaYFnGjRckzQvOCxdHF1T5/YwZBgm7AwjarbBxmkPQ1d+5U3XnPmF/Jmvr6v4r0IySTJeXKmjaxqmLqg5Jt+/csCkTJxP8ju84DMLPsMwZRxn3O6HnO1U+NbZzuzaHm0V3A+Pq/57VDwuxfFeuF8xvF+B//U3bqn81EJyc2/EIMw4veDOaJIPo2y8n0+Ja+oYmiBMJd86d8diN0gyPPvTx2lCwE+2+tRda2ZcN23LPKnv7suCZ6aQP6zCr+FZLNcdXlip3XcCf7+V+4Jvzz77j760PPu9Nw4nHI6T2XbYLYdWgzA9VqQ2Fyos1Wze2R7imjp5UWAXGjEFF5aqKg80z/nt9/c4s+Cq/rUG/TBjXJpJuZaOluUkecHtQaiUhFLgWgZ74whD0/AslfoiZU4vSLE0jXGSst1PWS0HoLomuLw3Is4KhkHG7WGIqQts0+CUr0ILkkzO/ELgDtWtYulM4ow0l5xuKwXtRstDaMqYq2qbnO/4XNobcXl3xMXlGp5l0A1Sqq5qa02LxYMUxicV4fVZtHTuh/sV5JW6w83DgDevHGLoOusNBw3Bj2/0Hyst/u4Cu9FWq3FdE8fsgx+OBTR9nu7VlpkX7s8Czwxr5VEUfkIoQcgb17tc2hkyilL2RzE7g4jfubTH1YMJZzs+B+OYtADfMXl+uTaLHrt6MDmmKN0dRlAGBVdKH2bb0MgyeUz+3PAszi9W+ZkzLaquyTguWKjabLZdrh9MuD1Q5v0qfEGxVXRNUcFMXSX4pLlEFxp2yQxpV21kISkKZUk6LgdNuyMVVhCnBS3fxjNULNbvXd7nVi8ky5XV6fXDCT/Z7tMdJyRZwcEo4np3Qqeqwi8qljk79un5erZBJpXAyrcNDicJhVRb8Cm9rllRDoB111SDVkPj5bUaftmLn+LTCuP0RX1UEfl5qQCPslGeFLui6hhsDUNOt3yeW/QxdZ2bvQDH1B5YxXo/HFXevrLeoO6avLvd5w+ud4mz/IFZQFLCK2t15Y4YZZi64JW1OvJuduccJ45nZkX+sNvffpAoD5M4o+6YJFnOD64eEqc53zjTnq3qr+wrLu4nrdyPrjTe3Rqga3d+Ls4KDEN8rEhJCX/44iJ/5PklfnSjy84w4tr+mMkw4dyCj20YSCSGrtPwTBZ8E9fSQUpsXcexBFLCQsXi9c02Hd/m0LOIM7WKOt32mcQJH+xNeHGlim+ZdMdqCLXVm2AZytLXNDTefH9AWvLMTU25E3YnKbeHEXVH7XAWfP/YDmcakPv2rT6X98Zc744xdTjdUmkxR6XYtmHwwnKVUZxxcbnGKEp5f2eoRFcPuOo76T71w+Bx2wIntZOIk4xa1TiWFGIb2sc8Uh4Wx+2EVd7lo9gJ3zGuq83+7kHbMnM8Hp6ZQv6w29+rBxMWqw7tMo5rHOdESU67as3ShKaftTeMH+izNxcqbPUCbvUCJXlHJbisN92Prd6OHu+FxaqSxJcPpGPqjOKU5aqLbcD1gwlxJnlppc7uKMLQBZauYeiKtfLKep1RlDFJMpoVA9tQUvMwtRlEORJFZfMsne0bPcZxjlsUvLXVpz9J2RuFeJaBpkk0ISikSg+yCqEsUDWBW9rVTgvn0VbWN063CNOcvVFEmGYfk2JvtJQtsF+2UaqOyemWYrQ8aGH8LPrUD4NHbQuchKkXqBf/i6t1docxkzjDs3TOLymrhsdp8Rw9viDOHivv8rMaRj8KnlQb7knhmSnkD3sTTQuDEIKLy+qG/aEsEHcp+lxTx3eM2crkkz674Vm8vN5gbxTxk+0Brqnx+pn2MXXjvY53aoZ/4zCg5pq0KzZNr8reKEJKNdwspFTBD6ZGkOQYGlQdi6WaPWMhOIYqbMMoQxMqNzRJc273c8y2xuEkYRilaEjyXImM+kEMoOK5qhqG1LE0QT/KuLBY5cJSjSjN2e6HrNQd3tkeMAzTmQLw6Ap5sap66jXX5Mc3ejimgW0IupOUnUHIt851ZitwTYM/+tLyAz9cn2ef+iRxUjuJmmtyqllBSkqlsK4UvGUQxEkc3yTJHyvv8osy0Dypl+fThGemkD/MTTQ1BXp/Z0S7Ys0YK6aucbcye8p1naamfNJnH5X+f9rW9O7jbfkWf/E7mzMTp+4kASkZJSqIuFWx2RmG6ELQ9AwOxymTJOP84kJpc5vy7naflq+oi1cOJggkF5dr7I5CtvsRu6NQDT9tVfwMTcPUNQqpQp6FLpQrnVb2uMv2iG1o7I4iDsYRvqN8Yt7fGTGJ02Mrtymn/RcuLnK6XeF77+0SZQVrDZezHZ+9kTLqUjmWD/dQfZFWew+Dk9pJbC5U6AcJG60K3UnM/jgqk+gf/GX4acfn28Yj5V1+0Va/T7IN96TwWIVcCPG3gf8ISICPgL8kpeyfwHE9Ej5p+3t3rNhi1WYSp8oUaCfldKtCwzORMKNiHS0WD7K1ftgb6F6fWXdN3r7V57s/uY3QQBeCzQUVyLs7jLg1CFjyHVZLV7wkK/jNH93ipbUGXz/d4urBhO++u0PVNlhuuEgkp5oekzTncBKxWlMBtZ6toaGKOWis1h00TSUNpbnkbN3FtfRSug79SUKjYnF2wUcIQbtiMS7FVNMdzdGHvjtJeHmtfmwFvVRz7pnV+aDQNcG7230kgguL/lOxwjqpncTRF7+hC84vVWmVit5rBxNqrjn788MU1KPHt9pwHzrv8ou4+n3SbbgngcedQnwPeElK+QrwAfA3H/+QTh5HGQ+qDwiH45j1VgXfUZzqg3HMdy50+PkLnYf27Zh+/r+9vM+Nw8kxD23X1B9qGDUVbfzaNzZ4frnOV9bqtCoOB6OEumOx6Dss1hxeWmvQqtjKvc81y52CSn43NMXaWaoqf4ztfsSCZ3Gh41NzDJoVi7prY1k6ay2XF1drtHyVVq8LZaX7/HKNl9Zq5IXkYBxTcw1eWavPVt+rDZcCZgPLu5kc9/L/eNhrcff1tQ2d10+3eWm1fsxr5IuMk2S8HGWXbC6oJPkpi6c7TvjNH92iO04eitVz9PimLb5MMsu7/LT7/1H94O/lW35S+CQ/mGcVj7Uil1L+qyN//D7wa493OJ8NjvcBi7IPqJzzLi7XkFIqYyFvmsP44CuJoyuSpZqKhLu0M5olqz/qDbS5UOH3PthnwbeRUjKIUgyhtr9ZrkRKdvnCOdOuMIrVjbvdD2lXbMKsQAjVkmFR5TguN1ykhMWay94wwrF1mp6Pa+r8zqV9LizVWK07gGB3FHHe8rmwVJ21lY6Koz5tYHmSPe23b/XZ6odkObPg3mmx+KJvlT+rvvHdu79ekMxe6FN67PTnHkZk9bB5l4+y+v2sV/FPaxvucXCSPfK/DPwf9/uXQoi/AvwVgI2NjRP8tZ8MddN0S59oA02UPiOGzrBcOT/O2/roA7XW9Li0M0Qgubw7RNc1uuOYr5YWrA9zkzbuMleq2joNz+JgEs9cV+NyNXaUEbI3ignTjNvDCM/UWGm4ZViFzl/42TOzY97uh4yjDN9RvPJffXmF7X5EN4hpejY/d36BUy1v1gbZXPi4fPzowPJOn7Q/2+Zf2R8f+/lHeZj6QcKPb/RLGwCdOCu4tDPiuSVfBUPf9bNfpF7tFJ+FEObuAjqOM2VUFd+5Jg/aTnic43uUF/b9WpBv3+pTdczH/v6+KEPXzxNCfgpbXwjxr4Hle/yrvyWl/L/Ln/lbwOvAn5Gf9oHA66+/Ln/4wx8+wuE+HKZv/q1eiAqb1+gFMUiBZyn/64222lo+6Grg7mKx3Q851fRmHPNRlHJ5d8hbN/u8drrF5kJllm7zsCuOoyuXLC94e2tAlOZYuqBiGRSosIhrB2NeWmvgmBr/8r0dirzgdLtSOvqlnG57PL9Su29Qwj97e5vdQYhrGSpEOssJk4ylussff2X12PFMz31KqZdSCauGYUrnLk/wqcfM4zyYb97ozbj5U//uKM3JZcFXVusfc/e724jqaeijPwqmrcJpEby0M2RcvtCnPO6jdhOfFR7luv/Opb2PeZoPw4Q3rnf55tmFL8X396gQQrwhpXz97r//1BW5lPKXPuWD/yLwJ4BffJAi/nli+uY/2/FVQoopaLgW4zgjk3LWB3zQt/W9toS3ByGOoc+451XHRNc1Xjvd4tVTxx+gh20FHF1ZRGnOV1bVAzqKstlqerXh8tWNBt2J2nmcarpkuaTqmCz4DsNQiYBAPUB3F9R+kMz8YDq+xULVoWIZxGnOOMrucTzWxx7et7f6jKOUVsU+Ftk1TYZ5HAzDlM2Fyswb2zZ0pCzojuNjfeYvG1Ph7vZB07PY6gWcalUeSVr/qHiU1e+9VvFXDyZKefwl+f5OGo/LWvkV4G8AvyClDE7mkE4Ox7niNbb7IaMoRdcF//Fr6w/9pr9Xsdhsq2zFaRJLmOZ0xzFfP9069t8+6tT8Qbe9p9uV2flO7U6HUQplFFqaSbqTmPd3Rrxxvcsvv7hM3TV580YPq/RBD+KCa9GYlYaLEOA797497r4OWRkXd5TBclIsgaNqwek5GZrgq3et1L5sTIV79bb/9GvrdCfJ595OeNjWzL162N1JwtdPH3/pPMvf30njcXvkfxewge+V26TvSyn/6mMf1Qnh6JtfJf7ccTd8lBv8XsXibnP8aQF8Z3twLNfw85iaT893eq4Ab93s0fCUTa5j6nR8m2GY8L33dnluSYVLrzc9BmHCMMwZRAX9IOGrp5q0/Htfo7uvg2/rJFnBOL6zgj+p850+9J5l8NxSdbbSvDv44WkVDD0O7lVAT7e/+Ok691rFf3Wj8YnpUHN8Mh6LfiilPC+lPCWl/Gr5zxemiMPJmx3dj9Y0Ncd/9ZQKDDjd8jF1rQyuHbA3jD4Xk6V7nW93kmDrWmlipSOEoOZa5EXBh3sjXFOxQDQhWK7bvLxaw3dMtE9QDN59HVYbrmLVlI55J2kqNX3oP40S+kUwtprjwXGUSvm1jSavrDfm399j4Jl2s3nQIvCg+LRicSyXcFkVxLRQUXCfx9DmXuf71Y0GUaYCoqeIs5yWZ82i7ab5pKaucTCJabjmJx7v3ddB1wTrTZeNtnci1/l+5zV96O/1uSf9Xc/x+WL+/T0ePpW18lng82KtfBb4JIrb/abxl3aHnOtUH4q5cT+GyMMq+PpBwq+/cROjXIlP0482WhVMQ9wzcuxBRVBfRKrfHHM8y7gfa2VeyE8Qd1PCRlHKW7f6VG2DV9YbD1wo+0HC713eV3FbYcrtfkizYvPNzRZRWvDOVp+X1hp0qvYDfeb1wwnfe2+XvChm0WqaxoxRMi/Ic8zxdOCR6YdzPDjunsZPw5vPdvxjtLxPo1RNjbMarkWc5rimwSBM+Wh/jGcZD63gO92u8GtfX79vwX5QxsF8FT7HHF9MzAv5CeLuafw0vHnqTwIPRqn6cG9E3TFxTJ0wLag4BmZWcKMbst70SgXfHYbIg3zm46oLv4jmSHPMMYfCvJCfMI4WzLvDm+HBKFUq51C1vDxLJ82K8o8S39aPSfIf9DMfF182wc0cczxNeKZZK08ad7M79oYRP9kasN0PP9Hx7cKizzBKidKMBd9mHKf0woRTTZemZzEoedyfJ03rJN0M55hjjpPFvJB/hjhKqbrZC7h6OGazXeFU0/tEm9FX1husNz3yQpLmBatNl5W6w0LVmSn4Wr71udK0vozWoHPM8bRg3lr5jHG01XJ3NBrcuzXR8Cy+c6HziYPFz1vB92W0Bp1jjqcF80L+OeFhvUA+C+vTx8GX0Rp0jjmeFswL+eeEZ8EL5Iv2cpljjjkU5j3yzwn3kvfvjSJGUfqZxF3NMcccXx7MC/nnhLu9JOIsR6D8tR8mY3GOOeaY427MWyufI462JqZhwnNe9hxzzPG4mK/InxDmvOw55pjjpDAv5E8Ic172HHPMcVKYF/InhHkQwhxzzHFSmBfyJ4S5kf4cc8xxUpgPO58g5rzsOeaY4yQwX5HPMcccczzlmBfyOeaYY46nHPNCPsccc8zxlGNeyOeYY445nnLMC/kcc8wxx1MOIaX8/H+pEPvA9c/9Fx/HAnDwhI/hs8D8vJ4uzM/r6cEX4ZxOSyk7d//lEynkXwQIIX4opXz9SR/HSWN+Xk8X5uf19OCLfE7z1socc8wxx1OOeSGfY4455njK8WUu5H//SR/AZ4T5eT1dmJ/X04Mv7Dl9aXvkc8wxxxzPCr7MK/I55phjjmcC80I+xxxzzPGU40tdyIUQf1sI8b4Q4m0hxP8lhGg86WN6HAghfkUIcUkI8aEQ4r970sfzuBBCnBJC/LYQ4j0hxLtCiL/+pI/pJCGE0IUQbwoh/p8nfSwnBSFEQwjx6+Vz9VMhxLee9DGdBIQQ/015D74jhPjfhRDOkz6mo/hSF3Lge8BLUspXgA+Av/mEj+eRIYTQgb8H/CrwIvDnhRAvPtmjemxkwH8rpXwR+Fngv3gGzuko/jrw0yd9ECeMvwP8Synl88CrPAPnJ4RYA/4r4HUp5UuADvy5J3tUx/GlLuRSyn8lpczKP34fWH+Sx/OY+BngQynlFSllAvwT4E894WN6LEgpb0spf1T+/xGqKKw92aM6GQgh1oE/DvyDJ30sJwUhRB34Q8D/CiClTKSU/Sd6UCcHA3CFEAbgAdtP+HiO4UtdyO/CXwb+xZM+iMfAGnDzyJ9v8YwUPQAhxBnga8APnvChnBT+Z+BvAMUTPo6TxCawD/xvZcvoHwghnvrsQinlFvA/AjeA28BASvmvnuxRHcczX8iFEP+67Gvd/c+fOvIzfwu1jf/HT+5I57gfhBA+8H8C/7WUcvikj+dxIYT4E8CelPKNJ30sJwwDeA34X6SUXwMmwLMwq2midrebwCpQEUL8hSd7VMfxzEe9SSl/6ZP+vRDiLwJ/AvhF+XST6reAU0f+vF7+3VMNIYSJKuL/WEr5G0/6eE4IPwf8SSHEHwMcoCaE+EdSyi9UcXgE3AJuSSmnu6Zf5xko5MAvAVellPsAQojfAL4N/KMnelRH8MyvyD8JQohfQW1v/6SUMnjSx/OY+APgghBiUwhhoYYx//QJH9NjQQghUP3Wn0op/6cnfTwnBSnl35RSrkspz6C+p//3GSjiSCl3gJtCiIvlX/0i8N4TPKSTwg3gZ4UQXnlP/iJfsCHuM78i/xT8XcAGvqe+H74vpfyrT/aQHg1SykwI8deA76Km6v9QSvnuEz6sx8XPAf8Z8BMhxI/Lv/vvpZT//Mkd0hyfgv8S+MflYuIK8Jee8PE8NqSUPxBC/DrwI1QL9k2+YHL9uUR/jjnmmOMpx5e6tTLHHHPM8SxgXsjnmGOOOZ5yzAv5HHPMMcdTjnkhn2OOOeZ4yjEv5HPMMcccTznmhXyOOeaY4ynHvJDPMcccczzl+P8BzHB3Nfqet+IAAAAASUVORK5CYII=\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "needs_background": "light" - }, - "output_type": "display_data" - } - ], - "source": [ - "def gaussian_points(dim=2, n_points=1000, mean_vector=np.array([0, 0]),\n", - " sample_variance=1):\n", - " \"\"\"\n", - " Very simple custom function to generate gaussian distributed point clusters\n", - " with variable dimension, number of points, means in each direction\n", - " (must match dim) and sample variance.\n", - "\n", - " Inputs:\n", - " dim (int)\n", - " n_points (int)\n", - " mean_vector (np.array) (where index 0 is x, index 1 is y etc.)\n", - " sample_variance (float)\n", - "\n", - " Returns:\n", - " data (np.array): with dimensions (dim x n_points)\n", - " \"\"\"\n", - "\n", - " mean_matrix = np.zeros(dim) + mean_vector\n", - " covariance_matrix = np.eye(dim) * sample_variance\n", - " data = np.random.multivariate_normal(mean_matrix, covariance_matrix,\n", - " n_points)\n", - " return data\n", - "\n", - "\n", - "\n", - "def generate_simple_clustering_dataset(dim=2, n_points=1000, plotting=True,\n", - " return_data=True):\n", - " \"\"\"\n", - " Toy model to illustrate k-means clustering\n", - " \"\"\"\n", - "\n", - " data1 = gaussian_points(mean_vector=np.array([5, 5]))\n", - " data2 = gaussian_points()\n", - " data3 = gaussian_points(mean_vector=np.array([1, 4.5]))\n", - " data4 = gaussian_points(mean_vector=np.array([5, 1]))\n", - " data = np.concatenate((data1, data2, data3, data4), axis=0)\n", - "\n", - " if plotting:\n", - " fig, ax = plt.subplots()\n", - " ax.scatter(data[:, 0], data[:, 1], alpha=0.2)\n", - " ax.set_title('Toy Model Dataset')\n", - " plt.show()\n", - "\n", - "\n", - " if return_data:\n", - " return data\n", - "\n", - "\n", - "data = generate_simple_clustering_dataset()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Now that we are our, albeit very simple, dataset we are ready to start\n", - "implementing the k-means algorithm." - ] - }, - { - "cell_type": "code", - "execution_count": 3, - "metadata": {}, - "outputs": [], - "source": [ - "n_samples, dimensions = data.shape\n", - "n_clusters = 4\n", - "\n", - "# we randomly initialize our centroids\n", - "np.random.seed(2021)\n", - "centroids = data[np.random.choice(n_samples, n_clusters, replace=False), :]\n", - "distances = np.zeros((n_samples, n_clusters))\n", - "\n", - "# first we need to calculate the distance to each centroid from our data\n", - "for k in range(n_clusters):\n", - " for n in range(n_samples):\n", - " dist = 0\n", - " for d in range(dimensions):\n", - " dist += np.abs(data[n, d] - centroids[k, d])**2\n", - " distances[n, k] = dist\n", - "\n", - "# we initialize an array to keep track of to which cluster each point belongs\n", - "# the way we set it up here the index tracks which point and the value which\n", - "# cluster the point belongs to\n", - "cluster_labels = np.zeros(n_samples, dtype='int')\n", - "\n", - "# next we loop through our samples and for every point assign it to the cluster\n", - "# to which it has the smallest distance to\n", - "for n in range(n_samples):\n", - " # tracking variables (all of this is basically just an argmin)\n", - " smallest = 1e10\n", - " smallest_row_index = 1e10\n", - " for k in range(n_clusters):\n", - " if distances[n, k] < smallest:\n", - " smallest = distances[n, k]\n", - " smallest_row_index = k\n", - "\n", - " cluster_labels[n] = smallest_row_index" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Let's plot and see" - ] - }, - { - "cell_type": "code", - "execution_count": 4, - "metadata": {}, - "outputs": [ - { - "data": { - "image/png": "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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "needs_background": "light" - }, - "output_type": "display_data" - } - ], - "source": [ - "fig = plt.figure()\n", - "ax = fig.add_subplot()\n", - "unique_cluster_labels = np.unique(cluster_labels)\n", - "for i in unique_cluster_labels:\n", - " ax.scatter(data[cluster_labels == i, 0],\n", - " data[cluster_labels == i, 1],\n", - " label = i,\n", - " alpha = 0.2)\n", - " ax.scatter(centroids[:, 0], centroids[:, 1], c='black')\n", - "\n", - "ax.set_title(\"First Grouping of Points to Centroids\")\n", - "\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "So what do we have so far? We have 'picked' $k$ centroids at random from our\n", - "data points. There are other ways of more intelligently choosing their\n", - "initializations, however for our purposes randomly is fine. Then we have\n", - "initialized an array 'distances' which holds the information of the distance,\n", - "*or dissimilarity*, of every point to of our centroids. Finally, we have\n", - "initialized an array 'cluster_labels' which according to our distances array\n", - "holds the information of to which centroid every point is assigned. This was the\n", - "first pass of our algorithm. Essentially, all we need to do now is repeat the\n", - "distance and assignment steps above until we have reached a desired convergence\n", - "or a maximum amount of iterations." - ] - }, - { - "cell_type": "code", - "execution_count": 5, - "metadata": {}, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Converged at iteration 5\n", - "Runtime: 0.5119049549102783 seconds\n" - ] - } - ], - "source": [ - "\n", - "max_iterations = 100\n", - "tolerance = 1e-8\n", - "start_time = time.time()\n", - "\n", - "for iteration in range(max_iterations):\n", - " prev_centroids = centroids.copy()\n", - " for k in range(n_clusters):\n", - " # this array will be used to update our centroid positions\n", - " vector_mean = np.zeros(dimensions)\n", - " mean_divisor = 0\n", - " for n in range(n_samples):\n", - " if cluster_labels[n] == k:\n", - " vector_mean += data[n, :]\n", - " mean_divisor += 1\n", - "\n", - " # update according to the k means\n", - " centroids[k, :] = vector_mean / mean_divisor\n", - "\n", - " # we find the dissimilarity\n", - " for k in range(n_clusters):\n", - " for n in range(n_samples):\n", - " dist = 0\n", - " for d in range(dimensions):\n", - " dist += np.abs(data[n, d] - centroids[k, d])**2\n", - " distances[n, k] = dist\n", - "\n", - " # assign each point\n", - " for n in range(n_samples):\n", - " smallest = 1e10\n", - " smallest_row_index = 1e10\n", - " for k in range(n_clusters):\n", - " if distances[n, k] < smallest:\n", - " smallest = distances[n, k]\n", - " smallest_row_index = k\n", - "\n", - " cluster_labels[n] = smallest_row_index\n", - "\n", - " # convergence criteria\n", - " centroid_difference = np.sum(np.abs(centroids - prev_centroids))\n", - " if centroid_difference < tolerance:\n", - " print(f'Converged at iteration {iteration}')\n", - " print(f'Runtime: {time.time() - start_time} seconds')\n", - " break\n", - "\n", - " elif iteration == max_iterations:\n", - " print(f'Did not converge in {max_iterations} iterations')\n", - " print(f'Runtime: {time.time() - start_time} seconds')" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "And thats it! We now have an extremely barebones, un-optimized k-means\n", - "clustering implementation. Lets plot the final result" - ] - }, - { - "cell_type": "code", - "execution_count": 6, - "metadata": {}, - "outputs": [ - { - "data": { - "image/png": "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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "needs_background": "light" - }, - "output_type": "display_data" - } - ], - "source": [ - "fig = plt.figure()\n", - "ax = fig.add_subplot()\n", - "unique_cluster_labels = np.unique(cluster_labels)\n", - "for i in unique_cluster_labels:\n", - " ax.scatter(data[cluster_labels == i, 0],\n", - " data[cluster_labels == i, 1],\n", - " label = i,\n", - " alpha = 0.2)\n", - " ax.scatter(centroids[:, 0], centroids[:, 1], c='black')\n", - "\n", - "ax.set_title(\"Final Result of K-means Clustering\")\n", - "\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Now there are a few glaring improvements to be done here. First of all is\n", - "organizing things into functions for better readability. Second is getting rid\n", - "of the small inefficiencies like manually calculating distances and argmin. And\n", - "finally, we need to optimize for better run-time. It's like we always say: the\n", - "best way of looping in Python is to not loop in Python. Let us tackle the first\n", - "two improvements." - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Towards a More Numpythonic Code" - ] - }, - { - "cell_type": "code", - "execution_count": 7, - "metadata": {}, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Converged at iteration: 5\n", - "Runtime: 0.42575693130493164 seconds\n" - ] - } - ], - "source": [ - "\n", - "def get_distances_to_clusters(data, centroids):\n", - " \"\"\"\n", - " Function that for each cluster finds the squared Euclidean distance\n", - " from every data point to the cluster centroid and returns a numpy array\n", - " containing the distances such that distance[i, j] means the distance between\n", - " the i-th point and the j-th centroid.\n", - " Inputs:\n", - " data (np.array): with dimensions (n_samples x dim)\n", - " centroids (np.array): with dimensions (n_clusters x dim)\n", - "\n", - " Returns:\n", - " distances (np.array): with dimensions (n_samples x n_clusters)\n", - " \"\"\"\n", - "\n", - " n_samples, dimensions = data.shape\n", - " n_clusters = centroids.shape[0]\n", - " distances = np.zeros((n_samples, n_clusters))\n", - " for k in range(n_clusters):\n", - " for i in range(n_samples):\n", - " dist = 0\n", - " for j in range(dimensions):\n", - " dist += np.abs(data[i, j] - centroids[k, j])**2\n", - " distances[i, k] = dist\n", - "\n", - " return distances\n", - "\n", - "\n", - "\n", - "def assign_points_to_clusters(distances):\n", - " \"\"\"\n", - " Function to assign each data point to the cluster to which it is the closest\n", - " based on the squared Euclidean distance from the get_distances_to_clusters\n", - " method.\n", - " Inputs:\n", - " distances (np.array): with dimensions (n_samples x n_clusters)\n", - "\n", - " Returns:\n", - " cluster_labels (np.array): with dimensions (n_samples)\n", - " \"\"\"\n", - " cluster_labels = np.argmin(distances, axis=1)\n", - "\n", - " return cluster_labels\n", - "\n", - "\n", - "\n", - "def k_means(data, n_clusters=4, max_iterations=100, tolerance=1e-8):\n", - " \"\"\"\n", - " Naive implementation of the k-means clustering algorithm. A short summary of\n", - " the algorithm is as follows: we randomly initialize k centroids / means.\n", - " Then we assign, using the squared Euclidean distance, every data-point to a\n", - " cluster. We then update the position of the k centroids / means, and repeat\n", - " until convergence or we reach our desired maximum iterations. The method\n", - " returns the cluster assignments of our data-points and a sequence of\n", - " centroids.\n", - " Inputs:\n", - " data (np.array): with dimesions (n_samples x dim)\n", - " n_clusters (int): hyperparameter which depends on dataset\n", - " max_iterations (int): hyperparameter which depends on dataset\n", - " tolerance (float): convergence measure\n", - "\n", - " Returns:\n", - " cluster_labels (np.array): with dimension (n_samples)\n", - " centroid_list (list): list of centroids (np.array)\n", - " with dimensions (n_clusters x dim)\n", - " \"\"\"\n", - "\n", - " samples, dimensions = data.shape\n", - " np.random.seed(2021)\n", - " centroids = data[np.random.choice(len(data), n_clusters, replace=False), :]\n", - " distances = get_distances_to_clusters(data, centroids)\n", - " cluster_labels = assign_points_to_clusters(distances)\n", - "\n", - " start_time = time.time()\n", - "\n", - " for iteration in range(max_iterations):\n", - " prev_centroids = centroids.copy()\n", - " for k in range(n_clusters):\n", - " vector_mean = np.zeros(dimensions)\n", - " mean_divisor = 0\n", - " for n in range(n_samples):\n", - " if cluster_labels[n] == k:\n", - " vector_mean += data[n, :]\n", - " mean_divisor += 1\n", - " # And update according to the new means\n", - " centroids[k, :] = vector_mean / mean_divisor\n", - "\n", - " distances = get_distances_to_clusters(data, centroids)\n", - " cluster_labels = assign_points_to_clusters(distances)\n", - "\n", - " centroid_difference = np.sum(np.abs(centroids - prev_centroids))\n", - " if centroid_difference < tolerance:\n", - " print(f'Converged at iteration: {iteration}')\n", - " print(f'Runtime: {time.time() - start_time} seconds')\n", - "\n", - " return cluster_labels, centroids\n", - "\n", - " print(f'Did not converge in {max_iterations} iterations')\n", - " print(f'Runtime: {time.time() - start_time} seconds')\n", - "\n", - " return cluster_labels, centroids\n", - "\n", - "\n", - "# quirk of numpy / Jupyter need to set seed again\n", - "cluster_labels, centroids = k_means(data)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "**Note**: the start of the timing is after the random initialization, and first\n", - "'cycle' of our algorithm. This is technically not the correct way to time it but\n", - "due to this being in a Jupyter notebook and the way it is structured this way of\n", - "comparing our algorithms will produce a more equal result. When timing code we\n", - "should always encapsulate our whole computation block.\n", - "\n", - "So we see an improvement from just switching to numpy's argmin function. There\n", - "is a very nice tool (or category of tools) called profilers. These can be\n", - "utilized to make clearer which improvements to our code we should care most\n", - "about here is an [excellent source](https://ipython-books.github.io/42-profiling-your-code-easily-with-cprofile-and-ipython/)\n", - "on the topic. Even before optimizing we can understand which parts of our code\n", - "will be taking the most of the run-time. It will be the longest Python loop,\n", - "i.e. the loop over all the samples. Nonetheless, let us do some profiling!" - ] - }, - { - "cell_type": "code", - "execution_count": 8, - "metadata": {}, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Converged at iteration: 11\n", - "Runtime: 0.8621249198913574 seconds\n", - " " - ] - } - ], - "source": [ - "test_data = generate_simple_clustering_dataset(n_points=10000, plotting=False)\n", - "%prun -l 10 cluster_labels, centroids = k_means(test_data)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Here we can see the reason for profiling. We now know for certain a lot can be\n", - "gained just by vectorizing our distance function. Ideally we wish to perform\n", - "most of our loops in numpy, i.e. C. To do this we need our array shapes to match\n", - "and clever reshaping will let us do so." - ] - }, - { - "cell_type": "code", - "execution_count": 9, - "metadata": {}, - "outputs": [], - "source": [ - "\n", - "def np_get_distances_to_clusters(data, centroids):\n", - " \"\"\"\n", - " Squared Euclidean distance between all data-points and every centroid. For\n", - " the function to work properly it needs data and centroids to be numpy\n", - " broadcastable. We sum along the dimension axis.\n", - " Inputs:\n", - " data (np.array): with dimensions (samples x 1 x dim)\n", - " centroids (np.array): with dimensions (1 x n_clusters x dim)\n", - "\n", - " Returns:\n", - " distances (np.array): with dimensions (samples x n_clusters)\n", - " \"\"\"\n", - "\n", - " distances = np.sum(np.abs((data - centroids))**2, axis=2)\n", - " return distances\n", - "\n", - "def np_assign_points_to_clusters(distances):\n", - " \"\"\"\n", - " Assigning each data-point to a cluster given an array distances containing\n", - " the squared Euclidean distance from every point to each centroid. We do\n", - " np.argmin along the cluster axis to find the closest cluster. Returns a\n", - " numpy array with corresponding labels.\n", - " Inputs:\n", - " distances (np.array): with dimensions (samples x n_clusters)\n", - "\n", - " Returns:\n", - " cluster_labels (np.array): with dimensions (samples x None)\n", - " \"\"\"\n", - " cluster_labels = np.argmin(distances, axis=1)\n", - " return cluster_labels\n", - "\n", - "\n", - "def np_k_means(data, n_clusters=4, max_iterations=100, tolerance=1e-8):\n", - " \"\"\"\n", - " Numpythonic implementation of the k-means clusting algorithm.\n", - " Inputs:\n", - " data (np.array): with dimesions (samples x dim)\n", - " n_clusters (int): hyperparameter which depends on dataset\n", - " max_iterations (int): hyperparameter which depends on dataset\n", - " tolerance (float): convergence measure\n", - " progression_plot (bool): activation flag for plotting\n", - " Returns:\n", - " cluster_labels (np.array): with dimension (samples)\n", - " centroid_list (list): list of centroids (np.array)\n", - " with dimensions (n_clusters x dim)\n", - " \"\"\"\n", - " n_samples, dimensions = data.shape\n", - " np.random.seed(2021)\n", - " centroids = data[np.random.choice(len(data), n_clusters, replace=False), :]\n", - "\n", - " distances = np_get_distances_to_clusters(np.reshape(data,\n", - " (n_samples, 1, dimensions)),\n", - " np.reshape(centroids,\n", - " (1, n_clusters, dimensions)))\n", - " cluster_labels = np_assign_points_to_clusters(distances)\n", - "\n", - " start_time = time.time()\n", - "\n", - " for iteration in range(max_iterations):\n", - " prev_centroids = centroids.copy()\n", - " for k in range(n_clusters):\n", - " points_in_cluster = data[cluster_labels == k]\n", - " mean_vector = np.mean(points_in_cluster, axis=0)\n", - " centroids[k] = mean_vector\n", - "\n", - " distances = np_get_distances_to_clusters(np.reshape(data,\n", - " (n_samples, 1, dimensions)),\n", - " np.reshape(centroids,\n", - " (1, n_clusters, dimensions)))\n", - " cluster_labels = np_assign_points_to_clusters(distances)\n", - "\n", - " centroid_difference = np.sum(np.abs(centroids - prev_centroids))\n", - " if centroid_difference < tolerance:\n", - " print(f'Converged at iteration: {iteration}')\n", - " print(f'Runtime: {time.time() - start_time} seconds')\n", - "\n", - " return cluster_labels, centroids\n", - "\n", - " print(f'Did not converge in {max_iterations} iterations')\n", - " print(f'Runtime: {time.time() - start_time} seconds')\n", - "\n", - " return cluster_labels, centroids" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "When working towards becoming a data scientist using Python this last step is\n", - "arguably one of the most important. Thinking of ways to avoid explicitly looping\n", - "by adding dimensions to our arrays in such a way that they become broadcastable\n", - "using numpy (also tensorflow and many others). Let us take a look at our the\n", - "fruits of our labor." - ] - }, - { - "cell_type": "code", - "execution_count": 9, - "metadata": {}, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Converged at iteration: 5\n", - "Runtime: 0.008977890014648438 seconds\n" - ] - } - ], - "source": [ - "cluster_labels, centroids = np_k_means(data)" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": {}, - "outputs": [], - "source": [] - } - ], - "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.8.5" - } - }, - "nbformat": 4, - "nbformat_minor": 5 -} diff --git a/doc/LectureNotes/Results/FigureFiles/EoSfitting.png b/doc/LectureNotes/Results/FigureFiles/EoSfitting.png index ad6242d0a..87a452de4 100644 Binary files a/doc/LectureNotes/Results/FigureFiles/EoSfitting.png and b/doc/LectureNotes/Results/FigureFiles/EoSfitting.png differ diff --git a/doc/LectureNotes/Results/FigureFiles/Masses2016.png b/doc/LectureNotes/Results/FigureFiles/Masses2016.png index b8976c975..bbaa79e2f 100644 Binary files a/doc/LectureNotes/Results/FigureFiles/Masses2016.png and b/doc/LectureNotes/Results/FigureFiles/Masses2016.png differ diff --git a/doc/LectureNotes/Results/FigureFiles/Masses2016OLS.png b/doc/LectureNotes/Results/FigureFiles/Masses2016OLS.png index 5b66081f7..4742ba83a 100644 Binary files a/doc/LectureNotes/Results/FigureFiles/Masses2016OLS.png and b/doc/LectureNotes/Results/FigureFiles/Masses2016OLS.png differ diff --git a/doc/LectureNotes/Results/FigureFiles/Masses2016Trees.png b/doc/LectureNotes/Results/FigureFiles/Masses2016Trees.png index 1c5a1b4b1..54fd767fc 100644 Binary files a/doc/LectureNotes/Results/FigureFiles/Masses2016Trees.png and b/doc/LectureNotes/Results/FigureFiles/Masses2016Trees.png differ diff --git a/doc/LectureNotes/_build/.doctrees/Clustering.doctree b/doc/LectureNotes/_build/.doctrees/Clustering.doctree deleted file mode 100644 index 507ff284b..000000000 Binary files a/doc/LectureNotes/_build/.doctrees/Clustering.doctree and /dev/null differ diff --git a/doc/LectureNotes/_build/.doctrees/chapter1.doctree b/doc/LectureNotes/_build/.doctrees/chapter1.doctree deleted file mode 100644 index b86fe862b..000000000 Binary files a/doc/LectureNotes/_build/.doctrees/chapter1.doctree and /dev/null differ diff --git a/doc/LectureNotes/_build/.doctrees/chapter10.doctree b/doc/LectureNotes/_build/.doctrees/chapter10.doctree deleted file mode 100644 index 51ed9de1d..000000000 Binary files a/doc/LectureNotes/_build/.doctrees/chapter10.doctree and /dev/null differ diff --git a/doc/LectureNotes/_build/.doctrees/chapter11.doctree b/doc/LectureNotes/_build/.doctrees/chapter11.doctree deleted file mode 100644 index df4f51c9c..000000000 Binary files a/doc/LectureNotes/_build/.doctrees/chapter11.doctree and /dev/null differ diff --git a/doc/LectureNotes/_build/.doctrees/chapter2.doctree b/doc/LectureNotes/_build/.doctrees/chapter2.doctree deleted file mode 100644 index abcb9ac45..000000000 Binary files a/doc/LectureNotes/_build/.doctrees/chapter2.doctree and /dev/null differ diff --git a/doc/LectureNotes/_build/.doctrees/chapter3.doctree b/doc/LectureNotes/_build/.doctrees/chapter3.doctree deleted file mode 100644 index a0dbaecdc..000000000 Binary files a/doc/LectureNotes/_build/.doctrees/chapter3.doctree and /dev/null differ diff --git a/doc/LectureNotes/_build/.doctrees/chapter4.doctree b/doc/LectureNotes/_build/.doctrees/chapter4.doctree deleted file mode 100644 index 236adb34f..000000000 Binary files a/doc/LectureNotes/_build/.doctrees/chapter4.doctree and /dev/null differ diff --git a/doc/LectureNotes/_build/.doctrees/chapter5.doctree b/doc/LectureNotes/_build/.doctrees/chapter5.doctree deleted file mode 100644 index b4c11af2b..000000000 Binary files a/doc/LectureNotes/_build/.doctrees/chapter5.doctree and /dev/null differ diff --git a/doc/LectureNotes/_build/.doctrees/chapter6.doctree b/doc/LectureNotes/_build/.doctrees/chapter6.doctree deleted file mode 100644 index 54b31a893..000000000 Binary files a/doc/LectureNotes/_build/.doctrees/chapter6.doctree and /dev/null differ diff --git a/doc/LectureNotes/_build/.doctrees/chapter7.doctree b/doc/LectureNotes/_build/.doctrees/chapter7.doctree deleted file mode 100644 index 53fc19c5f..000000000 Binary files a/doc/LectureNotes/_build/.doctrees/chapter7.doctree and /dev/null differ diff --git a/doc/LectureNotes/_build/.doctrees/chapter8.doctree b/doc/LectureNotes/_build/.doctrees/chapter8.doctree deleted file mode 100644 index de0c1bfe1..000000000 Binary files a/doc/LectureNotes/_build/.doctrees/chapter8.doctree and /dev/null differ diff --git a/doc/LectureNotes/_build/.doctrees/chapter9.doctree b/doc/LectureNotes/_build/.doctrees/chapter9.doctree deleted file mode 100644 index aa3026c34..000000000 Binary files a/doc/LectureNotes/_build/.doctrees/chapter9.doctree and /dev/null differ diff --git a/doc/LectureNotes/_build/.doctrees/chapteroptimization.doctree b/doc/LectureNotes/_build/.doctrees/chapteroptimization.doctree deleted file mode 100644 index 5d3a5d62f..000000000 Binary files a/doc/LectureNotes/_build/.doctrees/chapteroptimization.doctree and /dev/null differ diff --git a/doc/LectureNotes/_build/.doctrees/content.doctree b/doc/LectureNotes/_build/.doctrees/content.doctree deleted file mode 100644 index 2b30710d9..000000000 Binary files a/doc/LectureNotes/_build/.doctrees/content.doctree and /dev/null differ diff --git a/doc/LectureNotes/_build/.doctrees/glue_cache.json b/doc/LectureNotes/_build/.doctrees/glue_cache.json deleted file mode 100644 index 9e26dfeeb..000000000 --- a/doc/LectureNotes/_build/.doctrees/glue_cache.json +++ /dev/null @@ -1 +0,0 @@ -{} \ No newline at end of file diff --git a/doc/LectureNotes/_build/.doctrees/intro.doctree b/doc/LectureNotes/_build/.doctrees/intro.doctree deleted file mode 100644 index 127ed5900..000000000 Binary files a/doc/LectureNotes/_build/.doctrees/intro.doctree and /dev/null differ diff --git a/doc/LectureNotes/_build/.doctrees/linalg.doctree b/doc/LectureNotes/_build/.doctrees/linalg.doctree deleted file mode 100644 index 86334603d..000000000 Binary files a/doc/LectureNotes/_build/.doctrees/linalg.doctree and /dev/null differ diff --git a/doc/LectureNotes/_build/.doctrees/schedule.doctree b/doc/LectureNotes/_build/.doctrees/schedule.doctree deleted file mode 100644 index acda3c778..000000000 Binary files a/doc/LectureNotes/_build/.doctrees/schedule.doctree and /dev/null differ diff --git a/doc/LectureNotes/_build/.doctrees/statistics.doctree b/doc/LectureNotes/_build/.doctrees/statistics.doctree deleted file mode 100644 index 139dc37dc..000000000 Binary files a/doc/LectureNotes/_build/.doctrees/statistics.doctree and /dev/null differ diff --git a/doc/LectureNotes/_build/.doctrees/teachers.doctree b/doc/LectureNotes/_build/.doctrees/teachers.doctree deleted file mode 100644 index 0d61f51ac..000000000 Binary files a/doc/LectureNotes/_build/.doctrees/teachers.doctree and /dev/null differ diff --git a/doc/LectureNotes/_build/.doctrees/textbooks.doctree b/doc/LectureNotes/_build/.doctrees/textbooks.doctree deleted file mode 100644 index e18ae9303..000000000 Binary files a/doc/LectureNotes/_build/.doctrees/textbooks.doctree and /dev/null differ diff --git a/doc/LectureNotes/_build/html/.buildinfo b/doc/LectureNotes/_build/html/.buildinfo deleted file mode 100644 index 0b15ba7fa..000000000 --- a/doc/LectureNotes/_build/html/.buildinfo +++ /dev/null @@ -1,4 +0,0 @@ -# Sphinx build info version 1 -# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done. -config: 46c0db554a92905e06f29e822a7bfe1c -tags: 645f666f9bcd5a90fca523b33c5a78b7 diff --git a/doc/LectureNotes/_build/html/Clustering.html b/doc/LectureNotes/_build/html/Clustering.html deleted file mode 100644 index 0cb46c316..000000000 --- a/doc/LectureNotes/_build/html/Clustering.html +++ /dev/null @@ -1,1040 +0,0 @@ - - - - - - - - 12. Clustering Analysis — Applied Data Analysis and Machine Learning - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
- - - - - - - - -
- -
- -
-
-
- -
- -
-

12. Clustering Analysis

-

In this chapter we will concern ourselves with the study of cluster analysis. -In general terms cluster analysis, or clustering, is the task of grouping a -data-set into different distinct categories based on some measure of equality of -the data. This measure is often referred to as a metric or similarity -measure in the literature (note: sometimes we deal with a dissimilarity -measure instead). Usually, these metrics are formulated as some kind of -distance function between points in a high-dimensional space.

-

There exists a lot of such distance measures. The simplest, and also the most -common is the Euclidean distance (i.e. Pythagoras). A good source for those of -you wanting a thorough overview is the article (DOI:10.5120/ijca2016907841 -Irani, Pise, Phatak). A few other metrics mentioned there are: cosine -similarity, Manhattan distance, Chebychev distance and the Minkowski -distance. The Minkowski distance is a general formulation which encapsulates a -range of metrics. All of these, and many more, can be used in clustering. There -exists different categories of clustering algorithms. A few of the most -common are: centroid-, distribution-, density- and hierarchical- -clustering. We will concern ourselves primarily with the first one.

-
-

12.1. Basic Idea of the K-means Clustering Algorithm

-

The simplest of all clustering algorithms is the aptly named k-means algorithm -, sometimes also referred to as Lloyds algorithm. It is the simplest and also -the most common. From its simplicity it obtains both strengths and weaknesses. -These will be discussed in more detail later. The k-means algorithm is a -centroid based clustering algorithm.

-

Assume, we are given \(n\) data points and we wish to split the data into \(K < n\) -different categories, or clusters. We label each cluster by an integer \(k\in\{ -1, \cdots, K \}\). In the basic k-means algorithm each point is assigned to only -one cluster \(k\), and these assignments are non-injective i.e. many-to-one. We -can think of these mappings as an encoder \(k = C(i)\), which assigns the \(i\)-th -data-point \(\bf x_i\) to the \(k\)-th cluster. Before we jump into the mathematics -let us describe the k-means algorithm in words:

-
    -
  1. We start with guesses / random initializations of our \(k\) cluster centers / centroids

  2. -
  3. For each centroid the points that are most similar are identified

  4. -
  5. Then we move / replace each centroid with a coordinate average of all the points that were assigned to that centroid.

  6. -
  7. Iterate this points 2, 3) until the centroids no longer move (to some tolerance)

  8. -
-

Now we consider the method formally. Again, we assume we have \(n\) data-points -(vectors)

- -
-
-\[ -\begin{equation}\label{eq:kmeanspoints} \tag{1} - \boldsymbol{x_i} = \{x_{i, 1}, \cdots, x_{i, p}\}\in\mathbb{R}^p. -\end{equation} -\]
-

which we wish to group into \(K < n\) clusters. For our dissimilarity measure we -will use the squared Euclidean distance

- -
-
-\[ -\begin{equation}\label{eq:squaredeuclidean} \tag{2} - d(\boldsymbol{x_i}, \boldsymbol{x_i'}) = \sum_{j=1}^p(x_{ij} - x_{i'j})^2 - = ||\boldsymbol{x_i} - \boldsymbol{x_{i'}}||^2 -\end{equation} -\]
-

Next we define the so called within-cluster point scatter which gives us a -measure of how close each data point assigned to the same cluster tends to be to -the all the others.

- -
-
-\[ -\begin{equation}\label{eq:withincluster} \tag{3} - W(C) = \frac{1}{2}\sum_{k=1}^K\sum_{C(i)=k} - \sum_{C(i')=k}d(\boldsymbol{x_i}, \boldsymbol{x_{i'}}) = - \sum_{k=1}^KN_k\sum_{C(i)=k}||\boldsymbol{x_i} - \boldsymbol{\overline{x_k}}||^2 -\end{equation} -\]
-

where \(\boldsymbol{\overline{x_k}}\) is the mean vector associated with the \(k\)-th -cluster, and \(N_k = \sum_{i=1}^nI(C(i) = k)\), where the \(I()\) notation is -similar to the Kronecker delta (Commonly used in statistics, it just means that -when \(i = k\) we have the encoder \(C(i)\)). In other words, the within-cluster -scatter measures the compactness of each cluster with respect to the data points -assigned to each cluster. This is the quantity that the \(k\)-means algorithm aims -to minimize. We refer to this quantity \(W(C)\) as the within cluster scatter -because of its relation to the total scatter.

- -
-
-\[ -\begin{equation}\label{eq:totalscatter} \tag{4} - T = W(C) + B(C) = \frac{1}{2}\sum_{i=1}^n - \sum_{i'=1}^nd(\boldsymbol{x_i}, \boldsymbol{x_{i'}}) - = \frac{1}{2}\sum_{k=1}^K\sum_{C(i)=k} - \Big(\sum_{C(i') = k}d(\boldsymbol{x_i}, \boldsymbol{x_{i'}}) - + \sum_{C(i')\neq k}d(\boldsymbol{x_i}, \boldsymbol{x_{i'}})\Big) -\end{equation} -\]
-

Which is a quantity that is conserved throughout the \(k\)-means algorithm. It can -be thought of as the total amount of information in the data, and it is composed -of the aforementioned within-cluster scatter and the between-cluster scatter -\(B(C)\). In methods such as principle component analysis the total scatter is not -conserved.

-

Given a cluster mean \(\boldsymbol{m_k}\) we define the total cluster variance

- -
-
-\[ -\begin{equation}\label{eq:totalclustervariance} \tag{5} - \min_{C, \{\boldsymbol{m_k}\}_1^K}\sum_{k=1}^KN_k\sum||\boldsymbol{x_i} - \boldsymbol{m_k}||^2 -\end{equation} -\]
-

Now we have all the pieces necessary to formally revisit the k-means algorithm. -If you at this point feel like some of the above definitions came a bit out of -no-where, don’t fret, the method does get a whole lot simpler once we start -programming.

-
-
-

12.2. The K-means Clustering Algorithm

-

The k-means clustering algorithm goes as follows (note in my opinion this -description is a bit complicated and is lifted directly out of ESL HASTIE for -deeper understanding purposes)

-
    -
  1. For a given cluster assignment \(C\), and \(k\) cluster means \(\{m_1, \cdots, m_k\}\). We minimize the total cluster variance with respect to the cluster means \(\{m_k\}\) yielding the means of the currently assigned clusters.

  2. -
  3. Given a current set of \(k\) means \(\{m_k\}\) the total cluster variance is minimized by assigning each observation to the closest (current) cluster mean. That is $\(C(i) = \underset{1\leq k\leq K}{\mathrm{argmin}} ||\boldsymbol{x_i} - \boldsymbol{m_k}||^2\)$

  4. -
  5. Steps 1 and 2 are repeated until the assignments do not change.

  6. -
-

As previously stated the above formulation can be a bit difficult to understand, -at least the first time, due to the dense notation used. But all in all the -concept is fairly simple when explained in words. The math needs to be -understood but to help you along the way we summarize the algorithm as follows -(try to look at the terms above to match with the summary).

-
    -
  1. Before we start we specify a number \(k\) which is the number of clusters we want to try to separate our data into.

  2. -
  3. We initially choose \(k\) random data points in our data as our initial centroids, or means (this is where the name comes from).

  4. -
  5. Assign each data point to their closest centroid, based on the squared Euclidean distance.

  6. -
  7. For each of the \(k\) cluster we update the centroid by calculating new mean values for all the data points in the cluster.

  8. -
  9. Iteratively minimize the within cluster scatter by performing steps (3, 4) until the new assignments stop changing (can be to some tolerance) or until a maximum number of iterations have passed.

  10. -
-

That’s it, nothing magical happening.

-
-
-

12.3. Writing Our Own Code

-

In the following section we will work to develop a deeper understanding of the -previously discussed mathematics through developing codes to do k-means cluster -analysis.

-
-

12.3.1. Basic Python

-

Let us now program the most basic version of the algorithm using nothing but -Python with numpy arrays. This code is kept intentionally simple to gradually -progress our understanding. There is no vectorization of any kind, and even most -helper functions are not utilized. Throughout our implementation process it will -be helpful to keep in mind both the mathematical description of the algorithm -and our summary from above. In addition, try to think of ways to optimize this -while reading the next section. We will get to it, take it as a challenge to see -if your optimizations are better.

-

First of all we need a dataset to do our cluster analysis on, for clarity (and -lack of googling beforehand) we generate it ourselves using Gaussians. First we -import

-
-
-
%matplotlib inline
-
-%matplotlib inline
-import matplotlib.pyplot as plt
-import numpy as np
-import time
-from IPython.display import display
-
-np.random.seed(2021)
-
-
-
-
-

Next we define functions, for ease of use later, to generate Gaussians and to -set up our toy data set.

-
-
-
def gaussian_points(dim=2, n_points=1000, mean_vector=np.array([0, 0]),
-                    sample_variance=1):
-    """
-    Very simple custom function to generate gaussian distributed point clusters
-    with variable dimension, number of points, means in each direction
-    (must match dim) and sample variance.
-
-    Inputs:
-        dim (int)
-        n_points (int)
-        mean_vector (np.array) (where index 0 is x, index 1 is y etc.)
-        sample_variance (float)
-
-    Returns:
-        data (np.array): with dimensions (dim x n_points)
-    """
-
-    mean_matrix = np.zeros(dim) + mean_vector
-    covariance_matrix = np.eye(dim) * sample_variance
-    data = np.random.multivariate_normal(mean_matrix, covariance_matrix,
-                                    n_points)
-    return data
-
-
-
-def generate_simple_clustering_dataset(dim=2, n_points=1000, plotting=True,
-                                    return_data=True):
-    """
-    Toy model to illustrate k-means clustering
-    """
-
-    data1 = gaussian_points(mean_vector=np.array([5, 5]))
-    data2 = gaussian_points()
-    data3 = gaussian_points(mean_vector=np.array([1, 4.5]))
-    data4 = gaussian_points(mean_vector=np.array([5, 1]))
-    data = np.concatenate((data1, data2, data3, data4), axis=0)
-
-    if plotting:
-        fig, ax = plt.subplots()
-        ax.scatter(data[:, 0], data[:, 1], alpha=0.2)
-        ax.set_title('Toy Model Dataset')
-        plt.show()
-
-
-    if return_data:
-        return data
-
-
-data = generate_simple_clustering_dataset()
-
-
-
-
-_images/Clustering_18_0.png -
-
-

Now that we are our, albeit very simple, dataset we are ready to start -implementing the k-means algorithm.

-
-
-
n_samples, dimensions = data.shape
-n_clusters = 4
-
-# we randomly initialize our centroids
-np.random.seed(2021)
-centroids = data[np.random.choice(n_samples, n_clusters, replace=False), :]
-distances = np.zeros((n_samples, n_clusters))
-
-# first we need to calculate the distance to each centroid from our data
-for k in range(n_clusters):
-    for n in range(n_samples):
-        dist = 0
-        for d in range(dimensions):
-            dist += np.abs(data[n, d] - centroids[k, d])**2
-            distances[n, k] = dist
-
-# we initialize an array to keep track of to which cluster each point belongs
-# the way we set it up here the index tracks which point and the value which
-# cluster the point belongs to
-cluster_labels = np.zeros(n_samples, dtype='int')
-
-# next we loop through our samples and for every point assign it to the cluster
-# to which it has the smallest distance to
-for n in range(n_samples):
-    # tracking variables (all of this is basically just an argmin)
-    smallest = 1e10
-    smallest_row_index = 1e10
-    for k in range(n_clusters):
-        if distances[n, k] < smallest:
-            smallest = distances[n, k]
-            smallest_row_index = k
-
-    cluster_labels[n] = smallest_row_index
-
-
-
-
-

Let’s plot and see

-
-
-
fig = plt.figure()
-ax = fig.add_subplot()
-unique_cluster_labels = np.unique(cluster_labels)
-for i in unique_cluster_labels:
-    ax.scatter(data[cluster_labels == i, 0],
-               data[cluster_labels == i, 1],
-               label = i,
-               alpha = 0.2)
-    ax.scatter(centroids[:, 0], centroids[:, 1], c='black')
-
-ax.set_title("First Grouping of Points to Centroids")
-
-plt.show()
-
-
-
-
-_images/Clustering_22_0.png -
-
-

So what do we have so far? We have ‘picked’ \(k\) centroids at random from our -data points. There are other ways of more intelligently choosing their -initializations, however for our purposes randomly is fine. Then we have -initialized an array ‘distances’ which holds the information of the distance, -or dissimilarity, of every point to of our centroids. Finally, we have -initialized an array ‘cluster_labels’ which according to our distances array -holds the information of to which centroid every point is assigned. This was the -first pass of our algorithm. Essentially, all we need to do now is repeat the -distance and assignment steps above until we have reached a desired convergence -or a maximum amount of iterations.

-
-
-
max_iterations = 100
-tolerance = 1e-8
-start_time = time.time()
-
-for iteration in range(max_iterations):
-    prev_centroids = centroids.copy()
-    for k in range(n_clusters):
-        # this array will be used to update our centroid positions
-        vector_mean = np.zeros(dimensions)
-        mean_divisor = 0
-        for n in range(n_samples):
-            if cluster_labels[n] == k:
-                vector_mean += data[n, :]
-                mean_divisor += 1
-
-        # update according to the k means
-        centroids[k, :] = vector_mean / mean_divisor
-
-    # we find the dissimilarity
-    for k in range(n_clusters):
-        for n in range(n_samples):
-            dist = 0
-            for d in range(dimensions):
-                dist += np.abs(data[n, d] - centroids[k, d])**2
-                distances[n, k] = dist
-
-    # assign each point
-    for n in range(n_samples):
-        smallest = 1e10
-        smallest_row_index = 1e10
-        for k in range(n_clusters):
-            if distances[n, k] < smallest:
-                smallest = distances[n, k]
-                smallest_row_index = k
-
-        cluster_labels[n] = smallest_row_index
-
-    # convergence criteria
-    centroid_difference = np.sum(np.abs(centroids - prev_centroids))
-    if centroid_difference < tolerance:
-        print(f'Converged at iteration {iteration}')
-        print(f'Runtime: {time.time() - start_time} seconds')
-        break
-
-    elif iteration == max_iterations:
-        print(f'Did not converge in {max_iterations} iterations')
-        print(f'Runtime: {time.time() - start_time} seconds')
-
-
-
-
-
Converged at iteration 5
-Runtime: 0.4887218475341797 seconds
-
-
-
-
-

And thats it! We now have an extremely barebones, un-optimized k-means -clustering implementation. Lets plot the final result

-
-
-
fig = plt.figure()
-ax = fig.add_subplot()
-unique_cluster_labels = np.unique(cluster_labels)
-for i in unique_cluster_labels:
-    ax.scatter(data[cluster_labels == i, 0],
-               data[cluster_labels == i, 1],
-               label = i,
-               alpha = 0.2)
-    ax.scatter(centroids[:, 0], centroids[:, 1], c='black')
-
-ax.set_title("Final Result of K-means Clustering")
-
-plt.show()
-
-
-
-
-_images/Clustering_26_0.png -
-
-

Now there are a few glaring improvements to be done here. First of all is -organizing things into functions for better readability. Second is getting rid -of the small inefficiencies like manually calculating distances and argmin. And -finally, we need to optimize for better run-time. It’s like we always say: the -best way of looping in Python is to not loop in Python. Let us tackle the first -two improvements.

-
-
-
-

12.4. Towards a More Numpythonic Code

-
-
-
def get_distances_to_clusters(data, centroids):
-    """
-    Function that for each cluster finds the squared Euclidean distance
-    from every data point to the cluster centroid and returns a numpy array
-    containing the distances such that distance[i, j] means the distance between
-    the i-th point and the j-th centroid.
-    Inputs:
-        data (np.array): with dimensions (n_samples x dim)
-        centroids (np.array): with dimensions (n_clusters x dim)
-
-    Returns:
-        distances (np.array): with dimensions (n_samples x n_clusters)
-    """
-
-    n_samples, dimensions = data.shape
-    n_clusters = centroids.shape[0]
-    distances = np.zeros((n_samples, n_clusters))
-    for k in range(n_clusters):
-        for i in range(n_samples):
-            dist = 0
-            for j in range(dimensions):
-                dist += np.abs(data[i, j] - centroids[k, j])**2
-                distances[i, k] = dist
-
-    return distances
-
-
-
-def assign_points_to_clusters(distances):
-    """
-    Function to assign each data point to the cluster to which it is the closest
-    based on the squared Euclidean distance from the get_distances_to_clusters
-    method.
-    Inputs:
-        distances (np.array): with dimensions (n_samples x n_clusters)
-
-    Returns:
-        cluster_labels (np.array): with dimensions (n_samples)
-    """
-    cluster_labels = np.argmin(distances, axis=1)
-
-    return cluster_labels
-
-
-
-def k_means(data, n_clusters=4, max_iterations=100, tolerance=1e-8):
-    """
-    Naive implementation of the k-means clustering algorithm. A short summary of
-    the algorithm is as follows: we randomly initialize k centroids / means.
-    Then we assign, using the squared Euclidean distance, every data-point to a
-    cluster. We then update the position of the k centroids / means, and repeat
-    until convergence or we reach our desired maximum iterations. The method
-    returns the cluster assignments of our data-points and a sequence of
-    centroids.
-    Inputs:
-        data (np.array): with dimesions (n_samples x dim)
-        n_clusters (int): hyperparameter which depends on dataset
-        max_iterations (int): hyperparameter which depends on dataset
-        tolerance (float): convergence measure
-
-    Returns:
-        cluster_labels (np.array): with dimension (n_samples)
-        centroid_list (list): list of centroids (np.array)
-                              with dimensions (n_clusters x dim)
-    """
-
-    samples, dimensions = data.shape
-    np.random.seed(2021)
-    centroids = data[np.random.choice(len(data), n_clusters, replace=False), :]
-    distances = get_distances_to_clusters(data, centroids)
-    cluster_labels = assign_points_to_clusters(distances)
-
-    start_time = time.time()
-
-    for iteration in range(max_iterations):
-        prev_centroids = centroids.copy()
-        for k in range(n_clusters):
-            vector_mean = np.zeros(dimensions)
-            mean_divisor = 0
-            for n in range(n_samples):
-                if cluster_labels[n] == k:
-                    vector_mean += data[n, :]
-                    mean_divisor += 1
-            # And update according to the new means
-            centroids[k, :] = vector_mean / mean_divisor
-
-        distances = get_distances_to_clusters(data, centroids)
-        cluster_labels = assign_points_to_clusters(distances)
-
-        centroid_difference = np.sum(np.abs(centroids - prev_centroids))
-        if centroid_difference < tolerance:
-            print(f'Converged at iteration: {iteration}')
-            print(f'Runtime: {time.time() - start_time} seconds')
-
-            return cluster_labels, centroids
-
-    print(f'Did not converge in {max_iterations} iterations')
-    print(f'Runtime: {time.time() - start_time} seconds')
-
-    return cluster_labels, centroids
-
-
-# quirk of numpy / Jupyter need to set seed again
-cluster_labels, centroids = k_means(data)
-
-
-
-
-
Converged at iteration: 5
-Runtime: 0.432811975479126 seconds
-
-
-
-
-

Note: the start of the timing is after the random initialization, and first -‘cycle’ of our algorithm. This is technically not the correct way to time it but -due to this being in a Jupyter notebook and the way it is structured this way of -comparing our algorithms will produce a more equal result. When timing code we -should always encapsulate our whole computation block.

-

So we see an improvement from just switching to numpy’s argmin function. There -is a very nice tool (or category of tools) called profilers. These can be -utilized to make clearer which improvements to our code we should care most -about here is an excellent source -on the topic. Even before optimizing we can understand which parts of our code -will be taking the most of the run-time. It will be the longest Python loop, -i.e. the loop over all the samples. Nonetheless, let us do some profiling!

-
-
-
test_data = generate_simple_clustering_dataset(n_points=10000, plotting=False)
-%prun -l 10 cluster_labels, centroids = k_means(test_data)
-
-
-
-
-
Converged at iteration: 11
-Runtime: 0.8653810024261475 seconds
- 
-
-
-
-
-

Here we can see the reason for profiling. We now know for certain a lot can be -gained just by vectorizing our distance function. Ideally we wish to perform -most of our loops in numpy, i.e. C. To do this we need our array shapes to match -and clever reshaping will let us do so.

-
-
-
def np_get_distances_to_clusters(data, centroids):
-    """
-    Squared Euclidean distance between all data-points and every centroid. For
-    the function to work properly it needs data and centroids to be numpy
-    broadcastable. We sum along the dimension axis.
-    Inputs:
-        data (np.array): with dimensions (samples x 1 x dim)
-        centroids (np.array): with dimensions (1 x n_clusters x dim)
-
-    Returns:
-        distances (np.array): with dimensions (samples x n_clusters)
-    """
-
-    distances = np.sum(np.abs((data - centroids))**2, axis=2)
-    return distances
-
-def np_assign_points_to_clusters(distances):
-    """
-    Assigning each data-point to a cluster given an array distances containing
-    the squared Euclidean distance from every point to each centroid. We do
-    np.argmin along the cluster axis to find the closest cluster. Returns a
-    numpy array with corresponding labels.
-    Inputs:
-        distances (np.array): with dimensions (samples x n_clusters)
-
-    Returns:
-        cluster_labels (np.array): with dimensions (samples x None)
-    """
-    cluster_labels = np.argmin(distances, axis=1)
-    return cluster_labels
-
-
-def np_k_means(data, n_clusters=4, max_iterations=100, tolerance=1e-8):
-    """
-    Numpythonic implementation of the k-means clusting algorithm.
-    Inputs:
-        data (np.array): with dimesions (samples x dim)
-        n_clusters (int): hyperparameter which depends on dataset
-        max_iterations (int): hyperparameter which depends on dataset
-        tolerance (float): convergence measure
-        progression_plot (bool): activation flag for plotting
-    Returns:
-        cluster_labels (np.array): with dimension (samples)
-        centroid_list (list): list of centroids (np.array)
-                              with dimensions (n_clusters x dim)
-    """
-    n_samples, dimensions = data.shape
-    np.random.seed(2021)
-    centroids = data[np.random.choice(len(data), n_clusters, replace=False), :]
-
-    distances = np_get_distances_to_clusters(np.reshape(data,
-                                            (n_samples, 1, dimensions)),
-                                          np.reshape(centroids,
-                                            (1, n_clusters, dimensions)))
-    cluster_labels = np_assign_points_to_clusters(distances)
-
-    start_time = time.time()
-
-    for iteration in range(max_iterations):
-        prev_centroids = centroids.copy()
-        for k in range(n_clusters):
-            points_in_cluster = data[cluster_labels == k]
-            mean_vector = np.mean(points_in_cluster, axis=0)
-            centroids[k] = mean_vector
-
-        distances = np_get_distances_to_clusters(np.reshape(data,
-                                                (n_samples, 1, dimensions)),
-                                              np.reshape(centroids,
-                                                (1, n_clusters, dimensions)))
-        cluster_labels = np_assign_points_to_clusters(distances)
-
-        centroid_difference = np.sum(np.abs(centroids - prev_centroids))
-        if centroid_difference < tolerance:
-            print(f'Converged at iteration: {iteration}')
-            print(f'Runtime: {time.time() - start_time} seconds')
-
-            return cluster_labels, centroids
-
-    print(f'Did not converge in {max_iterations} iterations')
-    print(f'Runtime: {time.time() - start_time} seconds')
-
-    return cluster_labels, centroids
-
-
-
-
-

When working towards becoming a data scientist using Python this last step is -arguably one of the most important. Thinking of ways to avoid explicitly looping -by adding dimensions to our arrays in such a way that they become broadcastable -using numpy (also tensorflow and many others). Let us take a look at our the -fruits of our labor.

-
-
-
cluster_labels, centroids = np_k_means(data)
-
-
-
-
-
Converged at iteration: 5
-Runtime: 0.0036406517028808594 seconds
-
-
-
-
-
-
- - - - -
- - - - -
-
-
-
-

- - By Morten Hjorth-Jensen
- - © Copyright 2021.
-

-
-
-
- - -
-
- - - - - - \ No newline at end of file diff --git a/doc/LectureNotes/_build/html/_images/Clustering_18_0.png b/doc/LectureNotes/_build/html/_images/Clustering_18_0.png deleted file mode 100644 index 6a2c18c39..000000000 Binary files a/doc/LectureNotes/_build/html/_images/Clustering_18_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/Clustering_22_0.png b/doc/LectureNotes/_build/html/_images/Clustering_22_0.png deleted file mode 100644 index 66d71dd38..000000000 Binary files a/doc/LectureNotes/_build/html/_images/Clustering_22_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/Clustering_26_0.png b/doc/LectureNotes/_build/html/_images/Clustering_26_0.png deleted file mode 100644 index 605826ab5..000000000 Binary files a/doc/LectureNotes/_build/html/_images/Clustering_26_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter10_33_1.png b/doc/LectureNotes/_build/html/_images/chapter10_33_1.png deleted file mode 100644 index 03e01a89d..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter10_33_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter10_49_1.png b/doc/LectureNotes/_build/html/_images/chapter10_49_1.png deleted file mode 100644 index 27ee23cc1..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter10_49_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter10_49_2.png b/doc/LectureNotes/_build/html/_images/chapter10_49_2.png deleted file mode 100644 index e4d211026..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter10_49_2.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter10_53_0.png b/doc/LectureNotes/_build/html/_images/chapter10_53_0.png deleted file mode 100644 index 8d17ae6f7..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter10_53_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter10_53_1.png b/doc/LectureNotes/_build/html/_images/chapter10_53_1.png deleted file mode 100644 index fd2da8862..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter10_53_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter11_47_2.png b/doc/LectureNotes/_build/html/_images/chapter11_47_2.png deleted file mode 100644 index 5667f3351..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter11_47_2.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter11_49_3.png b/doc/LectureNotes/_build/html/_images/chapter11_49_3.png deleted file mode 100644 index d8fe671bb..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter11_49_3.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter11_55_3.png b/doc/LectureNotes/_build/html/_images/chapter11_55_3.png deleted file mode 100644 index 25118b436..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter11_55_3.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter11_63_3.png b/doc/LectureNotes/_build/html/_images/chapter11_63_3.png deleted file mode 100644 index 25118b436..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter11_63_3.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter11_63_4.png b/doc/LectureNotes/_build/html/_images/chapter11_63_4.png deleted file mode 100644 index 7b1474c1b..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter11_63_4.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter11_76_3.png b/doc/LectureNotes/_build/html/_images/chapter11_76_3.png deleted file mode 100644 index 40d7e8815..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter11_76_3.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter11_88_3.png b/doc/LectureNotes/_build/html/_images/chapter11_88_3.png deleted file mode 100644 index 40d7e8815..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter11_88_3.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter11_88_4.png b/doc/LectureNotes/_build/html/_images/chapter11_88_4.png deleted file mode 100644 index 0af57c0aa..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter11_88_4.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter1_11_0.png b/doc/LectureNotes/_build/html/_images/chapter1_11_0.png deleted file mode 100644 index e28b79ded..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter1_11_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter1_132_0.png b/doc/LectureNotes/_build/html/_images/chapter1_132_0.png deleted file mode 100644 index 29a1bd652..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter1_132_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter1_136_0.png b/doc/LectureNotes/_build/html/_images/chapter1_136_0.png deleted file mode 100644 index 29a1bd652..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter1_136_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter1_13_1.png b/doc/LectureNotes/_build/html/_images/chapter1_13_1.png deleted file mode 100644 index cd3adcd7f..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter1_13_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter1_179_1.png b/doc/LectureNotes/_build/html/_images/chapter1_179_1.png deleted file mode 100644 index 25ef92e54..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter1_179_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter1_183_1.png b/doc/LectureNotes/_build/html/_images/chapter1_183_1.png deleted file mode 100644 index 0821feaf6..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter1_183_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter1_191_1.png b/doc/LectureNotes/_build/html/_images/chapter1_191_1.png deleted file mode 100644 index f19e88b16..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter1_191_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter1_193_1.png b/doc/LectureNotes/_build/html/_images/chapter1_193_1.png deleted file mode 100644 index 13fd31349..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter1_193_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter1_195_0.png b/doc/LectureNotes/_build/html/_images/chapter1_195_0.png deleted file mode 100644 index dfe1e253c..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter1_195_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter1_199_1.png b/doc/LectureNotes/_build/html/_images/chapter1_199_1.png deleted file mode 100644 index f19e88b16..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter1_199_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter1_201_1.png b/doc/LectureNotes/_build/html/_images/chapter1_201_1.png deleted file mode 100644 index 13fd31349..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter1_201_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter1_202_0.png b/doc/LectureNotes/_build/html/_images/chapter1_202_0.png deleted file mode 100644 index a3eac788b..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter1_202_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter1_203_0.png b/doc/LectureNotes/_build/html/_images/chapter1_203_0.png deleted file mode 100644 index dfe1e253c..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter1_203_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter1_210_0.png b/doc/LectureNotes/_build/html/_images/chapter1_210_0.png deleted file mode 100644 index a3eac788b..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter1_210_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter1_214_0.png b/doc/LectureNotes/_build/html/_images/chapter1_214_0.png deleted file mode 100644 index cbac4fd70..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter1_214_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter1_218_0.png b/doc/LectureNotes/_build/html/_images/chapter1_218_0.png deleted file mode 100644 index cbac4fd70..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter1_218_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter1_27_0.png b/doc/LectureNotes/_build/html/_images/chapter1_27_0.png deleted file mode 100644 index 36f8fe801..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter1_27_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter1_3_0.png b/doc/LectureNotes/_build/html/_images/chapter1_3_0.png deleted file mode 100644 index fd690ccaa..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter1_3_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter1_57_1.png b/doc/LectureNotes/_build/html/_images/chapter1_57_1.png deleted file mode 100644 index df30b2f1e..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter1_57_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter1_59_0.png b/doc/LectureNotes/_build/html/_images/chapter1_59_0.png deleted file mode 100644 index 82b1758af..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter1_59_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter1_61_10.png b/doc/LectureNotes/_build/html/_images/chapter1_61_10.png deleted file mode 100644 index 4ac0823bc..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter1_61_10.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter1_61_11.png b/doc/LectureNotes/_build/html/_images/chapter1_61_11.png deleted file mode 100644 index 916bfd378..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter1_61_11.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter1_61_12.png b/doc/LectureNotes/_build/html/_images/chapter1_61_12.png deleted file mode 100644 index 4665b32d3..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter1_61_12.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter1_61_13.png b/doc/LectureNotes/_build/html/_images/chapter1_61_13.png deleted file mode 100644 index cb4a7d351..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter1_61_13.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter1_61_9.png b/doc/LectureNotes/_build/html/_images/chapter1_61_9.png deleted file mode 100644 index b07e234e6..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter1_61_9.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter2_245_1.png b/doc/LectureNotes/_build/html/_images/chapter2_245_1.png deleted file mode 100644 index dc3a3ce3e..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter2_245_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter2_245_2.png b/doc/LectureNotes/_build/html/_images/chapter2_245_2.png deleted file mode 100644 index dc3a3ce3e..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter2_245_2.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter2_247_1.png b/doc/LectureNotes/_build/html/_images/chapter2_247_1.png deleted file mode 100644 index ac2df9e69..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter2_247_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter2_249_1.png b/doc/LectureNotes/_build/html/_images/chapter2_249_1.png deleted file mode 100644 index 9666ad291..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter2_249_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter2_249_2.png b/doc/LectureNotes/_build/html/_images/chapter2_249_2.png deleted file mode 100644 index 9666ad291..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter2_249_2.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter2_25_2.png b/doc/LectureNotes/_build/html/_images/chapter2_25_2.png deleted file mode 100644 index 3c8dab8ed..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter2_25_2.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter2_287_1.png b/doc/LectureNotes/_build/html/_images/chapter2_287_1.png deleted file mode 100644 index dc3a3ce3e..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter2_287_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter2_289_1.png b/doc/LectureNotes/_build/html/_images/chapter2_289_1.png deleted file mode 100644 index ac2df9e69..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter2_289_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter2_291_1.png b/doc/LectureNotes/_build/html/_images/chapter2_291_1.png deleted file mode 100644 index 9666ad291..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter2_291_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter2_313_2.png b/doc/LectureNotes/_build/html/_images/chapter2_313_2.png deleted file mode 100644 index 07584f6bb..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter2_313_2.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter2_316_1.png b/doc/LectureNotes/_build/html/_images/chapter2_316_1.png deleted file mode 100644 index 07584f6bb..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter2_316_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter2_351_1.png b/doc/LectureNotes/_build/html/_images/chapter2_351_1.png deleted file mode 100644 index 07584f6bb..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter2_351_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_103_1.png b/doc/LectureNotes/_build/html/_images/chapter3_103_1.png deleted file mode 100644 index 0d08a7f4f..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_103_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_107_1.png b/doc/LectureNotes/_build/html/_images/chapter3_107_1.png deleted file mode 100644 index 0d08a7f4f..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_107_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_109_1.png b/doc/LectureNotes/_build/html/_images/chapter3_109_1.png deleted file mode 100644 index 0d08a7f4f..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_109_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_110_1.png b/doc/LectureNotes/_build/html/_images/chapter3_110_1.png deleted file mode 100644 index 0d08a7f4f..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_110_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_111_1.png b/doc/LectureNotes/_build/html/_images/chapter3_111_1.png deleted file mode 100644 index 78fb94a30..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_111_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_113_1.png b/doc/LectureNotes/_build/html/_images/chapter3_113_1.png deleted file mode 100644 index 92f4ae772..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_113_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_115_1.png b/doc/LectureNotes/_build/html/_images/chapter3_115_1.png deleted file mode 100644 index 78fb94a30..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_115_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_117_1.png b/doc/LectureNotes/_build/html/_images/chapter3_117_1.png deleted file mode 100644 index 92f4ae772..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_117_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_118_1.png b/doc/LectureNotes/_build/html/_images/chapter3_118_1.png deleted file mode 100644 index 78fb94a30..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_118_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_119_1.png b/doc/LectureNotes/_build/html/_images/chapter3_119_1.png deleted file mode 100644 index 92f4ae772..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_119_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_120_1.png b/doc/LectureNotes/_build/html/_images/chapter3_120_1.png deleted file mode 100644 index 92f4ae772..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_120_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_144_1.png b/doc/LectureNotes/_build/html/_images/chapter3_144_1.png deleted file mode 100644 index a518cb04b..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_144_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_148_1.png b/doc/LectureNotes/_build/html/_images/chapter3_148_1.png deleted file mode 100644 index a518cb04b..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_148_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_150_1.png b/doc/LectureNotes/_build/html/_images/chapter3_150_1.png deleted file mode 100644 index a518cb04b..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_150_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_151_1.png b/doc/LectureNotes/_build/html/_images/chapter3_151_1.png deleted file mode 100644 index a518cb04b..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_151_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_162_1.png b/doc/LectureNotes/_build/html/_images/chapter3_162_1.png deleted file mode 100644 index 8098b2e40..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_162_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_165_1.png b/doc/LectureNotes/_build/html/_images/chapter3_165_1.png deleted file mode 100644 index 32745c831..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_165_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_166_1.png b/doc/LectureNotes/_build/html/_images/chapter3_166_1.png deleted file mode 100644 index 8098b2e40..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_166_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_168_1.png b/doc/LectureNotes/_build/html/_images/chapter3_168_1.png deleted file mode 100644 index 8098b2e40..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_168_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_169_1.png b/doc/LectureNotes/_build/html/_images/chapter3_169_1.png deleted file mode 100644 index 32745c831..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_169_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_171_1.png b/doc/LectureNotes/_build/html/_images/chapter3_171_1.png deleted file mode 100644 index 32745c831..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_171_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_171_13.png b/doc/LectureNotes/_build/html/_images/chapter3_171_13.png deleted file mode 100644 index 118120ef6..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_171_13.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_172_1.png b/doc/LectureNotes/_build/html/_images/chapter3_172_1.png deleted file mode 100644 index 32745c831..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_172_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_173_0.png b/doc/LectureNotes/_build/html/_images/chapter3_173_0.png deleted file mode 100644 index e6bb9a232..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_173_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_173_1.png b/doc/LectureNotes/_build/html/_images/chapter3_173_1.png deleted file mode 100644 index f629a218c..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_173_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_175_1.png b/doc/LectureNotes/_build/html/_images/chapter3_175_1.png deleted file mode 100644 index f629a218c..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_175_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_175_13.png b/doc/LectureNotes/_build/html/_images/chapter3_175_13.png deleted file mode 100644 index 118120ef6..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_175_13.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_176_1.png b/doc/LectureNotes/_build/html/_images/chapter3_176_1.png deleted file mode 100644 index f629a218c..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_176_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_177_0.png b/doc/LectureNotes/_build/html/_images/chapter3_177_0.png deleted file mode 100644 index e6bb9a232..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_177_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_177_13.png b/doc/LectureNotes/_build/html/_images/chapter3_177_13.png deleted file mode 100644 index 118120ef6..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_177_13.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_178_13.png b/doc/LectureNotes/_build/html/_images/chapter3_178_13.png deleted file mode 100644 index 118120ef6..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_178_13.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_179_0.png b/doc/LectureNotes/_build/html/_images/chapter3_179_0.png deleted file mode 100644 index e6bb9a232..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_179_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_180_0.png b/doc/LectureNotes/_build/html/_images/chapter3_180_0.png deleted file mode 100644 index e6bb9a232..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_180_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_181_0.png b/doc/LectureNotes/_build/html/_images/chapter3_181_0.png deleted file mode 100644 index ef5da849b..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_181_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_183_0.png b/doc/LectureNotes/_build/html/_images/chapter3_183_0.png deleted file mode 100644 index ef5da849b..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_183_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_184_0.png b/doc/LectureNotes/_build/html/_images/chapter3_184_0.png deleted file mode 100644 index ef5da849b..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_184_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_25_2.png b/doc/LectureNotes/_build/html/_images/chapter3_25_2.png deleted file mode 100644 index dada82b44..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_25_2.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_37_1.png b/doc/LectureNotes/_build/html/_images/chapter3_37_1.png deleted file mode 100644 index 2d1866571..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_37_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_38_4.png b/doc/LectureNotes/_build/html/_images/chapter3_38_4.png deleted file mode 100644 index 2116c169f..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_38_4.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_38_6.png b/doc/LectureNotes/_build/html/_images/chapter3_38_6.png deleted file mode 100644 index 2116c169f..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_38_6.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_40_1.png b/doc/LectureNotes/_build/html/_images/chapter3_40_1.png deleted file mode 100644 index f66188c6f..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_40_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_41_10.png b/doc/LectureNotes/_build/html/_images/chapter3_41_10.png deleted file mode 100644 index df911b5f7..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_41_10.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_41_11.png b/doc/LectureNotes/_build/html/_images/chapter3_41_11.png deleted file mode 100644 index df911b5f7..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_41_11.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_47_0.png b/doc/LectureNotes/_build/html/_images/chapter3_47_0.png deleted file mode 100644 index 8130fefb0..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_47_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_49_1.png b/doc/LectureNotes/_build/html/_images/chapter3_49_1.png deleted file mode 100644 index 6dff76ded..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_49_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_50_0.png b/doc/LectureNotes/_build/html/_images/chapter3_50_0.png deleted file mode 100644 index 021694b4c..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_50_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_54_0.png b/doc/LectureNotes/_build/html/_images/chapter3_54_0.png deleted file mode 100644 index cf4b6a42e..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_54_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_57_1.png b/doc/LectureNotes/_build/html/_images/chapter3_57_1.png deleted file mode 100644 index 2d1866571..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_57_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_58_5.png b/doc/LectureNotes/_build/html/_images/chapter3_58_5.png deleted file mode 100644 index 2116c169f..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_58_5.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_60_1.png b/doc/LectureNotes/_build/html/_images/chapter3_60_1.png deleted file mode 100644 index f66188c6f..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_60_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_61_1.png b/doc/LectureNotes/_build/html/_images/chapter3_61_1.png deleted file mode 100644 index 2d1866571..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_61_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_61_11.png b/doc/LectureNotes/_build/html/_images/chapter3_61_11.png deleted file mode 100644 index df911b5f7..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_61_11.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_62_4.png b/doc/LectureNotes/_build/html/_images/chapter3_62_4.png deleted file mode 100644 index 2116c169f..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_62_4.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_62_5.png b/doc/LectureNotes/_build/html/_images/chapter3_62_5.png deleted file mode 100644 index 2116c169f..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_62_5.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_62_6.png b/doc/LectureNotes/_build/html/_images/chapter3_62_6.png deleted file mode 100644 index 2116c169f..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_62_6.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_64_1.png b/doc/LectureNotes/_build/html/_images/chapter3_64_1.png deleted file mode 100644 index f66188c6f..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_64_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_65_10.png b/doc/LectureNotes/_build/html/_images/chapter3_65_10.png deleted file mode 100644 index d1b31b1aa..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_65_10.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_65_11.png b/doc/LectureNotes/_build/html/_images/chapter3_65_11.png deleted file mode 100644 index df911b5f7..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_65_11.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_65_9.png b/doc/LectureNotes/_build/html/_images/chapter3_65_9.png deleted file mode 100644 index d1b31b1aa..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_65_9.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_67_0.png b/doc/LectureNotes/_build/html/_images/chapter3_67_0.png deleted file mode 100644 index 392e93eb1..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_67_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_69_1.png b/doc/LectureNotes/_build/html/_images/chapter3_69_1.png deleted file mode 100644 index 6dff76ded..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_69_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_70_0.png b/doc/LectureNotes/_build/html/_images/chapter3_70_0.png deleted file mode 100644 index 021694b4c..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_70_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_71_0.png b/doc/LectureNotes/_build/html/_images/chapter3_71_0.png deleted file mode 100644 index 392e93eb1..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_71_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_73_1.png b/doc/LectureNotes/_build/html/_images/chapter3_73_1.png deleted file mode 100644 index 30a446da4..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_73_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_74_0.png b/doc/LectureNotes/_build/html/_images/chapter3_74_0.png deleted file mode 100644 index 021694b4c..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_74_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter3_78_0.png b/doc/LectureNotes/_build/html/_images/chapter3_78_0.png deleted file mode 100644 index cf4b6a42e..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter3_78_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter4_114_1.png b/doc/LectureNotes/_build/html/_images/chapter4_114_1.png deleted file mode 100644 index 6c642a6a1..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter4_114_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter4_116_0.png b/doc/LectureNotes/_build/html/_images/chapter4_116_0.png deleted file mode 100644 index dfd44cb86..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter4_116_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter4_122_1.png b/doc/LectureNotes/_build/html/_images/chapter4_122_1.png deleted file mode 100644 index 59590fe49..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter4_122_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter4_13_0.png b/doc/LectureNotes/_build/html/_images/chapter4_13_0.png deleted file mode 100644 index cde80495d..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter4_13_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter4_13_1.png b/doc/LectureNotes/_build/html/_images/chapter4_13_1.png deleted file mode 100644 index aee9096ee..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter4_13_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter4_13_2.png b/doc/LectureNotes/_build/html/_images/chapter4_13_2.png deleted file mode 100644 index 0a17d7002..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter4_13_2.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter4_176_1.png b/doc/LectureNotes/_build/html/_images/chapter4_176_1.png deleted file mode 100644 index 409346c45..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter4_176_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter4_185_1.png b/doc/LectureNotes/_build/html/_images/chapter4_185_1.png deleted file mode 100644 index ae819dcfd..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter4_185_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter4_199_2.png b/doc/LectureNotes/_build/html/_images/chapter4_199_2.png deleted file mode 100644 index b619d6183..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter4_199_2.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter4_235_0.png b/doc/LectureNotes/_build/html/_images/chapter4_235_0.png deleted file mode 100644 index d4f6ff104..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter4_235_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter4_51_0.png b/doc/LectureNotes/_build/html/_images/chapter4_51_0.png deleted file mode 100644 index 903d98702..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter4_51_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter4_51_1.png b/doc/LectureNotes/_build/html/_images/chapter4_51_1.png deleted file mode 100644 index 42ba3f001..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter4_51_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter4_57_2.png b/doc/LectureNotes/_build/html/_images/chapter4_57_2.png deleted file mode 100644 index fa199fba3..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter4_57_2.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter4_57_3.png b/doc/LectureNotes/_build/html/_images/chapter4_57_3.png deleted file mode 100644 index 88bffd58a..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter4_57_3.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter4_57_4.png b/doc/LectureNotes/_build/html/_images/chapter4_57_4.png deleted file mode 100644 index e242a4058..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter4_57_4.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter4_5_1.png b/doc/LectureNotes/_build/html/_images/chapter4_5_1.png deleted file mode 100644 index 89d6b14ac..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter4_5_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter4_7_0.png b/doc/LectureNotes/_build/html/_images/chapter4_7_0.png deleted file mode 100644 index de0c567ed..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter4_7_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter5_109_0.png b/doc/LectureNotes/_build/html/_images/chapter5_109_0.png deleted file mode 100644 index 7bcfb46bd..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter5_109_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter5_129_0.png b/doc/LectureNotes/_build/html/_images/chapter5_129_0.png deleted file mode 100644 index 562496744..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter5_129_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter5_129_2.png b/doc/LectureNotes/_build/html/_images/chapter5_129_2.png deleted file mode 100644 index b02ae1d94..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter5_129_2.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter5_129_3.png b/doc/LectureNotes/_build/html/_images/chapter5_129_3.png deleted file mode 100644 index b319b08d2..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter5_129_3.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter5_129_4.png b/doc/LectureNotes/_build/html/_images/chapter5_129_4.png deleted file mode 100644 index 696d0ceca..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter5_129_4.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter5_129_6.png b/doc/LectureNotes/_build/html/_images/chapter5_129_6.png deleted file mode 100644 index abc25e8e9..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter5_129_6.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter5_1_1.png b/doc/LectureNotes/_build/html/_images/chapter5_1_1.png deleted file mode 100644 index 3478cb5ff..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter5_1_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter6_1_1.png b/doc/LectureNotes/_build/html/_images/chapter6_1_1.png deleted file mode 100644 index 968e34cb6..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter6_1_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter6_1_2.png b/doc/LectureNotes/_build/html/_images/chapter6_1_2.png deleted file mode 100644 index 3fff4c0a7..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter6_1_2.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter8_65_1.png b/doc/LectureNotes/_build/html/_images/chapter8_65_1.png deleted file mode 100644 index 6b5a8cdd0..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter8_65_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter9_29_0.png b/doc/LectureNotes/_build/html/_images/chapter9_29_0.png deleted file mode 100644 index fbb1365d2..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter9_29_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter9_29_1.png b/doc/LectureNotes/_build/html/_images/chapter9_29_1.png deleted file mode 100644 index 52b754f2a..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter9_29_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter9_29_2.png b/doc/LectureNotes/_build/html/_images/chapter9_29_2.png deleted file mode 100644 index def243ae9..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter9_29_2.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapter9_29_3.png b/doc/LectureNotes/_build/html/_images/chapter9_29_3.png deleted file mode 100644 index 164dcef76..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapter9_29_3.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapteroptimization_118_1.png b/doc/LectureNotes/_build/html/_images/chapteroptimization_118_1.png deleted file mode 100644 index 6e794e28f..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapteroptimization_118_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapteroptimization_127_1.png b/doc/LectureNotes/_build/html/_images/chapteroptimization_127_1.png deleted file mode 100644 index 2999003a5..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapteroptimization_127_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapteroptimization_141_1.png b/doc/LectureNotes/_build/html/_images/chapteroptimization_141_1.png deleted file mode 100644 index 739adbf6e..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapteroptimization_141_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapteroptimization_141_2.png b/doc/LectureNotes/_build/html/_images/chapteroptimization_141_2.png deleted file mode 100644 index 375f84294..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapteroptimization_141_2.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapteroptimization_177_0.png b/doc/LectureNotes/_build/html/_images/chapteroptimization_177_0.png deleted file mode 100644 index f1f99208f..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapteroptimization_177_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapteroptimization_56_1.png b/doc/LectureNotes/_build/html/_images/chapteroptimization_56_1.png deleted file mode 100644 index 17454c6f4..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapteroptimization_56_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapteroptimization_58_0.png b/doc/LectureNotes/_build/html/_images/chapteroptimization_58_0.png deleted file mode 100644 index d2d459719..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapteroptimization_58_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/chapteroptimization_64_1.png b/doc/LectureNotes/_build/html/_images/chapteroptimization_64_1.png deleted file mode 100644 index 62ce53a7f..000000000 Binary files a/doc/LectureNotes/_build/html/_images/chapteroptimization_64_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/statistics_178_0.png b/doc/LectureNotes/_build/html/_images/statistics_178_0.png deleted file mode 100644 index d43c704b2..000000000 Binary files a/doc/LectureNotes/_build/html/_images/statistics_178_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/statistics_184_1.png b/doc/LectureNotes/_build/html/_images/statistics_184_1.png deleted file mode 100644 index 9f993f3ab..000000000 Binary files a/doc/LectureNotes/_build/html/_images/statistics_184_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_images/statistics_29_0.png b/doc/LectureNotes/_build/html/_images/statistics_29_0.png deleted file mode 100644 index fba899a40..000000000 Binary files a/doc/LectureNotes/_build/html/_images/statistics_29_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_sources/Clustering.ipynb b/doc/LectureNotes/_build/html/_sources/Clustering.ipynb deleted file mode 100644 index 54e5f1cf2..000000000 --- a/doc/LectureNotes/_build/html/_sources/Clustering.ipynb +++ /dev/null @@ -1,908 +0,0 @@ -{ - "cells": [ - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "# Clustering Analysis\n", - "In this chapter we will concern ourselves with the study of **cluster analysis**.\n", - "In general terms cluster analysis, or clustering, is the task of grouping a\n", - "data-set into different distinct categories based on some measure of equality of\n", - "the data. This measure is often referred to as a **metric** or **similarity\n", - "measure** in the literature (note: sometimes we deal with a **dissimilarity\n", - "measure** instead). Usually, these metrics are formulated as some kind of\n", - "distance function between points in a high-dimensional space.\n", - "\n", - "There exists a lot of such distance measures. The simplest, and also the most\n", - "common is the **Euclidean distance** (i.e. Pythagoras). A good source for those of\n", - "you wanting a thorough overview is the article (DOI:10.5120/ijca2016907841\n", - "Irani, Pise, Phatak). A few other metrics mentioned there are: *cosine\n", - "similarity*, *Manhattan distance*, *Chebychev distance* and the *Minkowski\n", - "distance*. The Minkowski distance is a general formulation which encapsulates a\n", - "range of metrics. All of these, and many more, can be used in clustering. There\n", - "exists different categories of clustering algorithms. A few of the most\n", - "common are: *centroid-*, *distribution-*, *density-* and *hierarchical-\n", - "clustering*. We will concern ourselves primarily with the first one." - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Basic Idea of the K-means Clustering Algorithm\n", - "The simplest of all clustering algorithms is the aptly named **k-means algorithm**\n", - ", sometimes also referred to as *Lloyds algorithm*. It is the simplest and also\n", - "the most common. From its simplicity it obtains both strengths and weaknesses.\n", - "These will be discussed in more detail later. The k-means algorithm is a\n", - "**centroid based** clustering algorithm.\n", - "\n", - "Assume, we are given $n$ data points and we wish to split the data into $K < n$\n", - "different categories, or clusters. We label each cluster by an integer $k\\in\\{\n", - "1, \\cdots, K \\}$. In the basic k-means algorithm each point is assigned to only\n", - "one cluster $k$, and these assignments are *non-injective* i.e. many-to-one. We\n", - "can think of these mappings as an encoder $k = C(i)$, which assigns the $i$-th\n", - "data-point $\\bf x_i$ to the $k$-th cluster. Before we jump into the mathematics\n", - "let us describe the k-means algorithm in words:\n", - "1. We start with guesses / random initializations of our $k$ cluster centers / centroids\n", - "\n", - "2. For each centroid the points that are most similar are identified\n", - "\n", - "3. Then we move / replace each centroid with a coordinate average of all the points that were assigned to that centroid.\n", - "\n", - "4. Iterate this points 2, 3) until the centroids no longer move (to some tolerance)\n", - "\n", - "Now we consider the method formally. Again, we assume we have $n$ data-points\n", - "(vectors)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\\label{eq:kmeanspoints} \\tag{1}\n", - " \\boldsymbol{x_i} = \\{x_{i, 1}, \\cdots, x_{i, p}\\}\\in\\mathbb{R}^p.\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which we wish to group into $K < n$ clusters. For our dissimilarity measure we\n", - "will use the *squared Euclidean distance*" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\\label{eq:squaredeuclidean} \\tag{2}\n", - " d(\\boldsymbol{x_i}, \\boldsymbol{x_i'}) = \\sum_{j=1}^p(x_{ij} - x_{i'j})^2\n", - " = ||\\boldsymbol{x_i} - \\boldsymbol{x_{i'}}||^2\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Next we define the so called *within-cluster point scatter* which gives us a\n", - "measure of how close each data point assigned to the same cluster tends to be to\n", - "the all the others." - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\\label{eq:withincluster} \\tag{3}\n", - " W(C) = \\frac{1}{2}\\sum_{k=1}^K\\sum_{C(i)=k}\n", - " \\sum_{C(i')=k}d(\\boldsymbol{x_i}, \\boldsymbol{x_{i'}}) =\n", - " \\sum_{k=1}^KN_k\\sum_{C(i)=k}||\\boldsymbol{x_i} - \\boldsymbol{\\overline{x_k}}||^2\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $\\boldsymbol{\\overline{x_k}}$ is the mean vector associated with the $k$-th\n", - "cluster, and $N_k = \\sum_{i=1}^nI(C(i) = k)$, where the $I()$ notation is\n", - "similar to the Kronecker delta (*Commonly used in statistics, it just means that\n", - "when $i = k$ we have the encoder $C(i)$*). In other words, the within-cluster\n", - "scatter measures the compactness of each cluster with respect to the data points\n", - "assigned to each cluster. This is the quantity that the $k$-means algorithm aims\n", - "to minimize. We refer to this quantity $W(C)$ as the within cluster scatter\n", - "because of its relation to the *total scatter*." - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\\label{eq:totalscatter} \\tag{4}\n", - " T = W(C) + B(C) = \\frac{1}{2}\\sum_{i=1}^n\n", - " \\sum_{i'=1}^nd(\\boldsymbol{x_i}, \\boldsymbol{x_{i'}})\n", - " = \\frac{1}{2}\\sum_{k=1}^K\\sum_{C(i)=k}\n", - " \\Big(\\sum_{C(i') = k}d(\\boldsymbol{x_i}, \\boldsymbol{x_{i'}})\n", - " + \\sum_{C(i')\\neq k}d(\\boldsymbol{x_i}, \\boldsymbol{x_{i'}})\\Big)\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Which is a quantity that is conserved throughout the $k$-means algorithm. It can\n", - "be thought of as the total amount of information in the data, and it is composed\n", - "of the aforementioned within-cluster scatter and the *between-cluster scatter*\n", - "$B(C)$. In methods such as principle component analysis the total scatter is not\n", - "conserved.\n", - "\n", - "Given a cluster mean $\\boldsymbol{m_k}$ we define the **total cluster variance**" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\\label{eq:totalclustervariance} \\tag{5}\n", - " \\min_{C, \\{\\boldsymbol{m_k}\\}_1^K}\\sum_{k=1}^KN_k\\sum||\\boldsymbol{x_i} - \\boldsymbol{m_k}||^2\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Now we have all the pieces necessary to formally revisit the k-means algorithm.\n", - "If you at this point feel like some of the above definitions came a bit out of\n", - "no-where, don't fret, the method does get a whole lot simpler once we start\n", - "programming." - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## The K-means Clustering Algorithm\n", - "The k-means clustering algorithm goes as follows (note in my opinion this\n", - "description is a bit complicated and is lifted directly out of ESL HASTIE for\n", - "deeper understanding purposes)\n", - "\n", - "1. For a given cluster assignment $C$, and $k$ cluster means $\\{m_1, \\cdots, m_k\\}$. We minimize the total cluster variance with respect to the cluster means $\\{m_k\\}$ yielding the means of the currently assigned clusters.\n", - "\n", - "2. Given a current set of $k$ means $\\{m_k\\}$ the total cluster variance is minimized by assigning each observation to the closest (current) cluster mean. That is $$C(i) = \\underset{1\\leq k\\leq K}{\\mathrm{argmin}} ||\\boldsymbol{x_i} - \\boldsymbol{m_k}||^2$$\n", - "\n", - "3. Steps 1 and 2 are repeated until the assignments do not change.\n", - "\n", - "As previously stated the above formulation can be a bit difficult to understand,\n", - "*at least the first time*, due to the dense notation used. But all in all the\n", - "concept is fairly simple when explained in words. The math needs to be\n", - "understood but to help you along the way we summarize the algorithm as follows\n", - "(try to look at the terms above to match with the summary).\n", - "\n", - "1. Before we start we specify a number $k$ which is the number of clusters we want to try to separate our data into.\n", - "\n", - "2. We initially choose $k$ random data points in our data as our initial centroids, *or means* (this is where the name comes from).\n", - "\n", - "3. Assign each data point to their closest centroid, based on the squared Euclidean distance.\n", - "\n", - "4. For each of the $k$ cluster we update the centroid by calculating new mean values for all the data points in the cluster.\n", - "\n", - "5. Iteratively minimize the within cluster scatter by performing steps (3, 4) until the new assignments stop changing (can be to some tolerance) or until a maximum number of iterations have passed.\n", - "\n", - "That's it, nothing magical happening." - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Writing Our Own Code\n", - "In the following section we will work to develop a deeper understanding of the\n", - "previously discussed mathematics through developing codes to do k-means cluster\n", - "analysis." - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "### Basic Python\n", - "\n", - "Let us now program the most basic version of the algorithm using nothing but\n", - "Python with numpy arrays. This code is kept intentionally simple to gradually\n", - "progress our understanding. There is no vectorization of any kind, and even most\n", - "helper functions are not utilized. Throughout our implementation process it will\n", - "be helpful to keep in mind both the mathematical description of the algorithm\n", - "*and* our summary from above. In addition, try to think of ways to optimize this\n", - "while reading the next section. We will get to it, take it as a challenge to see\n", - "if your optimizations are better.\n", - "\n", - "First of all we need a dataset to do our cluster analysis on, for clarity (and\n", - "lack of googling beforehand) we generate it ourselves using Gaussians. First we\n", - "import" - ] - }, - { - "cell_type": "code", - "execution_count": 1, - "metadata": {}, - "outputs": [], - "source": [ - "%matplotlib inline\n", - "\n", - "%matplotlib inline\n", - "import matplotlib.pyplot as plt\n", - "import numpy as np\n", - "import time\n", - "from IPython.display import display\n", - "\n", - "np.random.seed(2021)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Next we define functions, for ease of use later, to generate Gaussians and to\n", - "set up our toy data set." - ] - }, - { - "cell_type": "code", - "execution_count": 2, - "metadata": {}, - "outputs": [ - { - "data": { - "image/png": "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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "needs_background": "light" - }, - "output_type": "display_data" - } - ], - "source": [ - "def gaussian_points(dim=2, n_points=1000, mean_vector=np.array([0, 0]),\n", - " sample_variance=1):\n", - " \"\"\"\n", - " Very simple custom function to generate gaussian distributed point clusters\n", - " with variable dimension, number of points, means in each direction\n", - " (must match dim) and sample variance.\n", - "\n", - " Inputs:\n", - " dim (int)\n", - " n_points (int)\n", - " mean_vector (np.array) (where index 0 is x, index 1 is y etc.)\n", - " sample_variance (float)\n", - "\n", - " Returns:\n", - " data (np.array): with dimensions (dim x n_points)\n", - " \"\"\"\n", - "\n", - " mean_matrix = np.zeros(dim) + mean_vector\n", - " covariance_matrix = np.eye(dim) * sample_variance\n", - " data = np.random.multivariate_normal(mean_matrix, covariance_matrix,\n", - " n_points)\n", - " return data\n", - "\n", - "\n", - "\n", - "def generate_simple_clustering_dataset(dim=2, n_points=1000, plotting=True,\n", - " return_data=True):\n", - " \"\"\"\n", - " Toy model to illustrate k-means clustering\n", - " \"\"\"\n", - "\n", - " data1 = gaussian_points(mean_vector=np.array([5, 5]))\n", - " data2 = gaussian_points()\n", - " data3 = gaussian_points(mean_vector=np.array([1, 4.5]))\n", - " data4 = gaussian_points(mean_vector=np.array([5, 1]))\n", - " data = np.concatenate((data1, data2, data3, data4), axis=0)\n", - "\n", - " if plotting:\n", - " fig, ax = plt.subplots()\n", - " ax.scatter(data[:, 0], data[:, 1], alpha=0.2)\n", - " ax.set_title('Toy Model Dataset')\n", - " plt.show()\n", - "\n", - "\n", - " if return_data:\n", - " return data\n", - "\n", - "\n", - "data = generate_simple_clustering_dataset()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Now that we are our, albeit very simple, dataset we are ready to start\n", - "implementing the k-means algorithm." - ] - }, - { - "cell_type": "code", - "execution_count": 3, - "metadata": {}, - "outputs": [], - "source": [ - "n_samples, dimensions = data.shape\n", - "n_clusters = 4\n", - "\n", - "# we randomly initialize our centroids\n", - "np.random.seed(2021)\n", - "centroids = data[np.random.choice(n_samples, n_clusters, replace=False), :]\n", - "distances = np.zeros((n_samples, n_clusters))\n", - "\n", - "# first we need to calculate the distance to each centroid from our data\n", - "for k in range(n_clusters):\n", - " for n in range(n_samples):\n", - " dist = 0\n", - " for d in range(dimensions):\n", - " dist += np.abs(data[n, d] - centroids[k, d])**2\n", - " distances[n, k] = dist\n", - "\n", - "# we initialize an array to keep track of to which cluster each point belongs\n", - "# the way we set it up here the index tracks which point and the value which\n", - "# cluster the point belongs to\n", - "cluster_labels = np.zeros(n_samples, dtype='int')\n", - "\n", - "# next we loop through our samples and for every point assign it to the cluster\n", - "# to which it has the smallest distance to\n", - "for n in range(n_samples):\n", - " # tracking variables (all of this is basically just an argmin)\n", - " smallest = 1e10\n", - " smallest_row_index = 1e10\n", - " for k in range(n_clusters):\n", - " if distances[n, k] < smallest:\n", - " smallest = distances[n, k]\n", - " smallest_row_index = k\n", - "\n", - " cluster_labels[n] = smallest_row_index" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Let's plot and see" - ] - }, - { - "cell_type": "code", - "execution_count": 4, - "metadata": {}, - "outputs": [ - { - "data": { - "image/png": "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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "needs_background": "light" - }, - "output_type": "display_data" - } - ], - "source": [ - "fig = plt.figure()\n", - "ax = fig.add_subplot()\n", - "unique_cluster_labels = np.unique(cluster_labels)\n", - "for i in unique_cluster_labels:\n", - " ax.scatter(data[cluster_labels == i, 0],\n", - " data[cluster_labels == i, 1],\n", - " label = i,\n", - " alpha = 0.2)\n", - " ax.scatter(centroids[:, 0], centroids[:, 1], c='black')\n", - "\n", - "ax.set_title(\"First Grouping of Points to Centroids\")\n", - "\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "So what do we have so far? We have 'picked' $k$ centroids at random from our\n", - "data points. There are other ways of more intelligently choosing their\n", - "initializations, however for our purposes randomly is fine. Then we have\n", - "initialized an array 'distances' which holds the information of the distance,\n", - "*or dissimilarity*, of every point to of our centroids. Finally, we have\n", - "initialized an array 'cluster_labels' which according to our distances array\n", - "holds the information of to which centroid every point is assigned. This was the\n", - "first pass of our algorithm. Essentially, all we need to do now is repeat the\n", - "distance and assignment steps above until we have reached a desired convergence\n", - "or a maximum amount of iterations." - ] - }, - { - "cell_type": "code", - "execution_count": 5, - "metadata": {}, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Converged at iteration 5\n", - "Runtime: 0.5119049549102783 seconds\n" - ] - } - ], - "source": [ - "\n", - "max_iterations = 100\n", - "tolerance = 1e-8\n", - "start_time = time.time()\n", - "\n", - "for iteration in range(max_iterations):\n", - " prev_centroids = centroids.copy()\n", - " for k in range(n_clusters):\n", - " # this array will be used to update our centroid positions\n", - " vector_mean = np.zeros(dimensions)\n", - " mean_divisor = 0\n", - " for n in range(n_samples):\n", - " if cluster_labels[n] == k:\n", - " vector_mean += data[n, :]\n", - " mean_divisor += 1\n", - "\n", - " # update according to the k means\n", - " centroids[k, :] = vector_mean / mean_divisor\n", - "\n", - " # we find the dissimilarity\n", - " for k in range(n_clusters):\n", - " for n in range(n_samples):\n", - " dist = 0\n", - " for d in range(dimensions):\n", - " dist += np.abs(data[n, d] - centroids[k, d])**2\n", - " distances[n, k] = dist\n", - "\n", - " # assign each point\n", - " for n in range(n_samples):\n", - " smallest = 1e10\n", - " smallest_row_index = 1e10\n", - " for k in range(n_clusters):\n", - " if distances[n, k] < smallest:\n", - " smallest = distances[n, k]\n", - " smallest_row_index = k\n", - "\n", - " cluster_labels[n] = smallest_row_index\n", - "\n", - " # convergence criteria\n", - " centroid_difference = np.sum(np.abs(centroids - prev_centroids))\n", - " if centroid_difference < tolerance:\n", - " print(f'Converged at iteration {iteration}')\n", - " print(f'Runtime: {time.time() - start_time} seconds')\n", - " break\n", - "\n", - " elif iteration == max_iterations:\n", - " print(f'Did not converge in {max_iterations} iterations')\n", - " print(f'Runtime: {time.time() - start_time} seconds')" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "And thats it! We now have an extremely barebones, un-optimized k-means\n", - "clustering implementation. Lets plot the final result" - ] - }, - { - "cell_type": "code", - "execution_count": 6, - "metadata": {}, - "outputs": [ - { - "data": { - "image/png": "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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "needs_background": "light" - }, - "output_type": "display_data" - } - ], - "source": [ - "fig = plt.figure()\n", - "ax = fig.add_subplot()\n", - "unique_cluster_labels = np.unique(cluster_labels)\n", - "for i in unique_cluster_labels:\n", - " ax.scatter(data[cluster_labels == i, 0],\n", - " data[cluster_labels == i, 1],\n", - " label = i,\n", - " alpha = 0.2)\n", - " ax.scatter(centroids[:, 0], centroids[:, 1], c='black')\n", - "\n", - "ax.set_title(\"Final Result of K-means Clustering\")\n", - "\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Now there are a few glaring improvements to be done here. First of all is\n", - "organizing things into functions for better readability. Second is getting rid\n", - "of the small inefficiencies like manually calculating distances and argmin. And\n", - "finally, we need to optimize for better run-time. It's like we always say: the\n", - "best way of looping in Python is to not loop in Python. Let us tackle the first\n", - "two improvements." - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Towards a More Numpythonic Code" - ] - }, - { - "cell_type": "code", - "execution_count": 7, - "metadata": {}, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Converged at iteration: 5\n", - "Runtime: 0.42575693130493164 seconds\n" - ] - } - ], - "source": [ - "\n", - "def get_distances_to_clusters(data, centroids):\n", - " \"\"\"\n", - " Function that for each cluster finds the squared Euclidean distance\n", - " from every data point to the cluster centroid and returns a numpy array\n", - " containing the distances such that distance[i, j] means the distance between\n", - " the i-th point and the j-th centroid.\n", - " Inputs:\n", - " data (np.array): with dimensions (n_samples x dim)\n", - " centroids (np.array): with dimensions (n_clusters x dim)\n", - "\n", - " Returns:\n", - " distances (np.array): with dimensions (n_samples x n_clusters)\n", - " \"\"\"\n", - "\n", - " n_samples, dimensions = data.shape\n", - " n_clusters = centroids.shape[0]\n", - " distances = np.zeros((n_samples, n_clusters))\n", - " for k in range(n_clusters):\n", - " for i in range(n_samples):\n", - " dist = 0\n", - " for j in range(dimensions):\n", - " dist += np.abs(data[i, j] - centroids[k, j])**2\n", - " distances[i, k] = dist\n", - "\n", - " return distances\n", - "\n", - "\n", - "\n", - "def assign_points_to_clusters(distances):\n", - " \"\"\"\n", - " Function to assign each data point to the cluster to which it is the closest\n", - " based on the squared Euclidean distance from the get_distances_to_clusters\n", - " method.\n", - " Inputs:\n", - " distances (np.array): with dimensions (n_samples x n_clusters)\n", - "\n", - " Returns:\n", - " cluster_labels (np.array): with dimensions (n_samples)\n", - " \"\"\"\n", - " cluster_labels = np.argmin(distances, axis=1)\n", - "\n", - " return cluster_labels\n", - "\n", - "\n", - "\n", - "def k_means(data, n_clusters=4, max_iterations=100, tolerance=1e-8):\n", - " \"\"\"\n", - " Naive implementation of the k-means clustering algorithm. A short summary of\n", - " the algorithm is as follows: we randomly initialize k centroids / means.\n", - " Then we assign, using the squared Euclidean distance, every data-point to a\n", - " cluster. We then update the position of the k centroids / means, and repeat\n", - " until convergence or we reach our desired maximum iterations. The method\n", - " returns the cluster assignments of our data-points and a sequence of\n", - " centroids.\n", - " Inputs:\n", - " data (np.array): with dimesions (n_samples x dim)\n", - " n_clusters (int): hyperparameter which depends on dataset\n", - " max_iterations (int): hyperparameter which depends on dataset\n", - " tolerance (float): convergence measure\n", - "\n", - " Returns:\n", - " cluster_labels (np.array): with dimension (n_samples)\n", - " centroid_list (list): list of centroids (np.array)\n", - " with dimensions (n_clusters x dim)\n", - " \"\"\"\n", - "\n", - " samples, dimensions = data.shape\n", - " np.random.seed(2021)\n", - " centroids = data[np.random.choice(len(data), n_clusters, replace=False), :]\n", - " distances = get_distances_to_clusters(data, centroids)\n", - " cluster_labels = assign_points_to_clusters(distances)\n", - "\n", - " start_time = time.time()\n", - "\n", - " for iteration in range(max_iterations):\n", - " prev_centroids = centroids.copy()\n", - " for k in range(n_clusters):\n", - " vector_mean = np.zeros(dimensions)\n", - " mean_divisor = 0\n", - " for n in range(n_samples):\n", - " if cluster_labels[n] == k:\n", - " vector_mean += data[n, :]\n", - " mean_divisor += 1\n", - " # And update according to the new means\n", - " centroids[k, :] = vector_mean / mean_divisor\n", - "\n", - " distances = get_distances_to_clusters(data, centroids)\n", - " cluster_labels = assign_points_to_clusters(distances)\n", - "\n", - " centroid_difference = np.sum(np.abs(centroids - prev_centroids))\n", - " if centroid_difference < tolerance:\n", - " print(f'Converged at iteration: {iteration}')\n", - " print(f'Runtime: {time.time() - start_time} seconds')\n", - "\n", - " return cluster_labels, centroids\n", - "\n", - " print(f'Did not converge in {max_iterations} iterations')\n", - " print(f'Runtime: {time.time() - start_time} seconds')\n", - "\n", - " return cluster_labels, centroids\n", - "\n", - "\n", - "# quirk of numpy / Jupyter need to set seed again\n", - "cluster_labels, centroids = k_means(data)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "**Note**: the start of the timing is after the random initialization, and first\n", - "'cycle' of our algorithm. This is technically not the correct way to time it but\n", - "due to this being in a Jupyter notebook and the way it is structured this way of\n", - "comparing our algorithms will produce a more equal result. When timing code we\n", - "should always encapsulate our whole computation block.\n", - "\n", - "So we see an improvement from just switching to numpy's argmin function. There\n", - "is a very nice tool (or category of tools) called profilers. These can be\n", - "utilized to make clearer which improvements to our code we should care most\n", - "about here is an [excellent source](https://ipython-books.github.io/42-profiling-your-code-easily-with-cprofile-and-ipython/)\n", - "on the topic. Even before optimizing we can understand which parts of our code\n", - "will be taking the most of the run-time. It will be the longest Python loop,\n", - "i.e. the loop over all the samples. Nonetheless, let us do some profiling!" - ] - }, - { - "cell_type": "code", - "execution_count": 8, - "metadata": {}, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Converged at iteration: 11\n", - "Runtime: 0.8621249198913574 seconds\n", - " " - ] - } - ], - "source": [ - "test_data = generate_simple_clustering_dataset(n_points=10000, plotting=False)\n", - "%prun -l 10 cluster_labels, centroids = k_means(test_data)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Here we can see the reason for profiling. We now know for certain a lot can be\n", - "gained just by vectorizing our distance function. Ideally we wish to perform\n", - "most of our loops in numpy, i.e. C. To do this we need our array shapes to match\n", - "and clever reshaping will let us do so." - ] - }, - { - "cell_type": "code", - "execution_count": 9, - "metadata": {}, - "outputs": [], - "source": [ - "\n", - "def np_get_distances_to_clusters(data, centroids):\n", - " \"\"\"\n", - " Squared Euclidean distance between all data-points and every centroid. For\n", - " the function to work properly it needs data and centroids to be numpy\n", - " broadcastable. We sum along the dimension axis.\n", - " Inputs:\n", - " data (np.array): with dimensions (samples x 1 x dim)\n", - " centroids (np.array): with dimensions (1 x n_clusters x dim)\n", - "\n", - " Returns:\n", - " distances (np.array): with dimensions (samples x n_clusters)\n", - " \"\"\"\n", - "\n", - " distances = np.sum(np.abs((data - centroids))**2, axis=2)\n", - " return distances\n", - "\n", - "def np_assign_points_to_clusters(distances):\n", - " \"\"\"\n", - " Assigning each data-point to a cluster given an array distances containing\n", - " the squared Euclidean distance from every point to each centroid. We do\n", - " np.argmin along the cluster axis to find the closest cluster. Returns a\n", - " numpy array with corresponding labels.\n", - " Inputs:\n", - " distances (np.array): with dimensions (samples x n_clusters)\n", - "\n", - " Returns:\n", - " cluster_labels (np.array): with dimensions (samples x None)\n", - " \"\"\"\n", - " cluster_labels = np.argmin(distances, axis=1)\n", - " return cluster_labels\n", - "\n", - "\n", - "def np_k_means(data, n_clusters=4, max_iterations=100, tolerance=1e-8):\n", - " \"\"\"\n", - " Numpythonic implementation of the k-means clusting algorithm.\n", - " Inputs:\n", - " data (np.array): with dimesions (samples x dim)\n", - " n_clusters (int): hyperparameter which depends on dataset\n", - " max_iterations (int): hyperparameter which depends on dataset\n", - " tolerance (float): convergence measure\n", - " progression_plot (bool): activation flag for plotting\n", - " Returns:\n", - " cluster_labels (np.array): with dimension (samples)\n", - " centroid_list (list): list of centroids (np.array)\n", - " with dimensions (n_clusters x dim)\n", - " \"\"\"\n", - " n_samples, dimensions = data.shape\n", - " np.random.seed(2021)\n", - " centroids = data[np.random.choice(len(data), n_clusters, replace=False), :]\n", - "\n", - " distances = np_get_distances_to_clusters(np.reshape(data,\n", - " (n_samples, 1, dimensions)),\n", - " np.reshape(centroids,\n", - " (1, n_clusters, dimensions)))\n", - " cluster_labels = np_assign_points_to_clusters(distances)\n", - "\n", - " start_time = time.time()\n", - "\n", - " for iteration in range(max_iterations):\n", - " prev_centroids = centroids.copy()\n", - " for k in range(n_clusters):\n", - " points_in_cluster = data[cluster_labels == k]\n", - " mean_vector = np.mean(points_in_cluster, axis=0)\n", - " centroids[k] = mean_vector\n", - "\n", - " distances = np_get_distances_to_clusters(np.reshape(data,\n", - " (n_samples, 1, dimensions)),\n", - " np.reshape(centroids,\n", - " (1, n_clusters, dimensions)))\n", - " cluster_labels = np_assign_points_to_clusters(distances)\n", - "\n", - " centroid_difference = np.sum(np.abs(centroids - prev_centroids))\n", - " if centroid_difference < tolerance:\n", - " print(f'Converged at iteration: {iteration}')\n", - " print(f'Runtime: {time.time() - start_time} seconds')\n", - "\n", - " return cluster_labels, centroids\n", - "\n", - " print(f'Did not converge in {max_iterations} iterations')\n", - " print(f'Runtime: {time.time() - start_time} seconds')\n", - "\n", - " return cluster_labels, centroids" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "When working towards becoming a data scientist using Python this last step is\n", - "arguably one of the most important. Thinking of ways to avoid explicitly looping\n", - "by adding dimensions to our arrays in such a way that they become broadcastable\n", - "using numpy (also tensorflow and many others). Let us take a look at our the\n", - "fruits of our labor." - ] - }, - { - "cell_type": "code", - "execution_count": 9, - "metadata": {}, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Converged at iteration: 5\n", - "Runtime: 0.008977890014648438 seconds\n" - ] - } - ], - "source": [ - "cluster_labels, centroids = np_k_means(data)" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": {}, - "outputs": [], - "source": [] - } - ], - "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.8.5" - } - }, - "nbformat": 4, - "nbformat_minor": 5 -} diff --git a/doc/LectureNotes/_build/html/_sources/chapter1.ipynb b/doc/LectureNotes/_build/html/_sources/chapter1.ipynb deleted file mode 100644 index d2273f8f7..000000000 --- a/doc/LectureNotes/_build/html/_sources/chapter1.ipynb +++ /dev/null @@ -1,3724 +0,0 @@ -{ - "cells": [ - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "# Linear Regression\n", - "\n", - "\n", - "## Introduction\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "Our emphasis throughout this series of lectures is on understanding\n", - "the mathematical aspects of different algorithms used in the fields of\n", - "data analysis and machine learning.\n", - "\n", - "However, where possible we will emphasize the importance of using\n", - "available software. We start thus with a hands-on and top-down\n", - "approach to machine learning. The aim is thus to start with relevant\n", - "data or data we have produced and use these to introduce statistical\n", - "data analysis concepts and machine learning algorithms before we delve\n", - "into the algorithms themselves. The examples we will use in the\n", - "beginning, start with simple polynomials with random noise added. We\n", - "will use the Python software package\n", - "[Scikit-Learn](http://scikit-learn.org/stable/) and introduce various\n", - "machine learning algorithms to make fits of the data and\n", - "predictions. We move thereafter to more interesting cases such as data\n", - "from say experiments (below we will look at experimental nuclear\n", - "binding energies as an example). These are examples where we can\n", - "easily set up the data and then use machine learning algorithms\n", - "included in for example **Scikit-Learn**.\n", - "\n", - "These examples will serve us the purpose of getting\n", - "started. Furthermore, they allow us to catch more than two birds with\n", - "a stone. They will allow us to bring in some programming specific\n", - "topics and tools as well as showing the power of various Python\n", - "libraries for machine learning and statistical data analysis.\n", - "\n", - "Here, we will mainly focus on two specific Python packages for Machine\n", - "Learning, Scikit-Learn and Tensorflow (see below for links etc).\n", - "Moreover, the examples we introduce will serve as inputs to many of\n", - "our discussions later, as well as allowing you to set up models and\n", - "produce your own data and get started with programming.\n", - "\n", - "\n", - "\n", - "## What is Machine Learning?\n", - "\n", - "Statistics, data science and machine learning form important fields of\n", - "research in modern science. They describe how to learn and make\n", - "predictions from data, as well as allowing us to extract important\n", - "correlations about physical process and the underlying laws of motion\n", - "in large data sets. The latter, big data sets, appear frequently in\n", - "essentially all disciplines, from the traditional Science, Technology,\n", - "Mathematics and Engineering fields to Life Science, Law, education\n", - "research, the Humanities and the Social Sciences. \n", - "\n", - "It has become more\n", - "and more common to see research projects on big data in for example\n", - "the Social Sciences where extracting patterns from complicated survey\n", - "data is one of many research directions. Having a solid grasp of data\n", - "analysis and machine learning is thus becoming central to scientific\n", - "computing in many fields, and competences and skills within the fields\n", - "of machine learning and scientific computing are nowadays strongly\n", - "requested by many potential employers. The latter cannot be\n", - "overstated, familiarity with machine learning has almost become a\n", - "prerequisite for many of the most exciting employment opportunities,\n", - "whether they are in bioinformatics, life science, physics or finance,\n", - "in the private or the public sector. This author has had several\n", - "students or met students who have been hired recently based on their\n", - "skills and competences in scientific computing and data science, often\n", - "with marginal knowledge of machine learning.\n", - "\n", - "Machine learning is a subfield of computer science, and is closely\n", - "related to computational statistics. It evolved from the study of\n", - "pattern recognition in artificial intelligence (AI) research, and has\n", - "made contributions to AI tasks like computer vision, natural language\n", - "processing and speech recognition. Many of the methods we will study are also \n", - "strongly rooted in basic mathematics and physics research. \n", - "\n", - "Ideally, machine learning represents the science of giving computers\n", - "the ability to learn without being explicitly programmed. The idea is\n", - "that there exist generic algorithms which can be used to find patterns\n", - "in a broad class of data sets without having to write code\n", - "specifically for each problem. The algorithm will build its own logic\n", - "based on the data. You should however always keep in mind that\n", - "machines and algorithms are to a large extent developed by humans. The\n", - "insights and knowledge we have about a specific system, play a central\n", - "role when we develop a specific machine learning algorithm. \n", - "\n", - "Machine learning is an extremely rich field, in spite of its young\n", - "age. The increases we have seen during the last three decades in\n", - "computational capabilities have been followed by developments of\n", - "methods and techniques for analyzing and handling large date sets,\n", - "relying heavily on statistics, computer science and mathematics. The\n", - "field is rather new and developing rapidly. Popular software packages\n", - "written in Python for machine learning like\n", - "[Scikit-learn](http://scikit-learn.org/stable/),\n", - "[Tensorflow](https://www.tensorflow.org/),\n", - "[PyTorch](http://pytorch.org/) and [Keras](https://keras.io/), all\n", - "freely available at their respective GitHub sites, encompass\n", - "communities of developers in the thousands or more. And the number of\n", - "code developers and contributors keeps increasing. Not all the\n", - "algorithms and methods can be given a rigorous mathematical\n", - "justification, opening up thereby large rooms for experimenting and\n", - "trial and error and thereby exciting new developments. However, a\n", - "solid command of linear algebra, multivariate theory, probability\n", - "theory, statistical data analysis, understanding errors and Monte\n", - "Carlo methods are central elements in a proper understanding of many\n", - "of algorithms and methods we will discuss.\n", - "\n", - "\n", - "\n", - "The approaches to machine learning are many, but are often split into\n", - "two main categories. In *supervised learning* we know the answer to a\n", - "problem, and let the computer deduce the logic behind it. On the other\n", - "hand, *unsupervised learning* is a method for finding patterns and\n", - "relationship in data sets without any prior knowledge of the system.\n", - "Some authours also operate with a third category, namely\n", - "*reinforcement learning*. This is a paradigm of learning inspired by\n", - "behavioral psychology, where learning is achieved by trial-and-error,\n", - "solely from rewards and punishment.\n", - "\n", - "Another way to categorize machine learning tasks is to consider the\n", - "desired output of a system. Some of the most common tasks are:\n", - "\n", - " * Classification: Outputs are divided into two or more classes. The goal is to produce a model that assigns inputs into one of these classes. An example is to identify digits based on pictures of hand-written ones. Classification is typically supervised learning.\n", - "\n", - " * Regression: Finding a functional relationship between an input data set and a reference data set. The goal is to construct a function that maps input data to continuous output values.\n", - "\n", - " * Clustering: Data are divided into groups with certain common traits, without knowing the different groups beforehand. It is thus a form of unsupervised learning.\n", - "\n", - "The methods we cover have three main topics in common, irrespective of\n", - "whether we deal with supervised or unsupervised learning.\n", - "* The first ingredient is normally our data set (which can be subdivided into training, validation and test data). Many find the most difficult part of using Machine Learning to be the set up of your data in a meaningful way. \n", - "\n", - "* The second item is a model which is normally a function of some parameters. The model reflects our knowledge of the system (or lack thereof). As an example, if we know that our data show a behavior similar to what would be predicted by a polynomial, fitting our data to a polynomial of some degree would then determin our model. \n", - "\n", - "* The last ingredient is a so-called **cost/loss** function (or error or risk function) which allows us to present an estimate on how good our model is in reproducing the data it is supposed to train. \n", - "\n", - "\n", - "\n", - "At the heart of basically all Machine Learning algorithms we will encounter so-called minimization or optimization algorithms. A large family of such methods are so-called **gradient methods**.\n", - "\n", - "\n", - "### A Frequentist approach to data analysis\n", - "\n", - "When you hear phrases like **predictions and estimations** and\n", - "**correlations and causations**, what do you think of? May be you think\n", - "of the difference between classifying new data points and generating\n", - "new data points.\n", - "Or perhaps you consider that correlations represent some kind of symmetric statements like\n", - "if $A$ is correlated with $B$, then $B$ is correlated with\n", - "$A$. Causation on the other hand is directional, that is if $A$ causes $B$, $B$ does not\n", - "necessarily cause $A$.\n", - "\n", - "These concepts are in some sense the difference between machine\n", - "learning and statistics. In machine learning and prediction based\n", - "tasks, we are often interested in developing algorithms that are\n", - "capable of learning patterns from given data in an automated fashion,\n", - "and then using these learned patterns to make predictions or\n", - "assessments of newly given data. In many cases, our primary concern\n", - "is the quality of the predictions or assessments, and we are less\n", - "concerned about the underlying patterns that were learned in order\n", - "to make these predictions.\n", - "\n", - "In machine learning we normally use [a so-called frequentist approach](https://en.wikipedia.org/wiki/Frequentist_inference),\n", - "where the aim is to make predictions and find correlations. We focus\n", - "less on for example extracting a probability distribution function (PDF). The PDF can be\n", - "used in turn to make estimations and find causations such as given $A$\n", - "what is the likelihood of finding $B$.\n", - "\n", - "\n", - "### What is a good model?\n", - "\n", - "In science and engineering we often end up in situations where we want to infer (or learn) a\n", - "quantitative model $M$ for a given set of sample points $\\boldsymbol{X} \\in [x_1, x_2,\\dots x_N]$.\n", - "\n", - "As we will see repeatedely in these lectures, we could try to fit these data points to a model given by a\n", - "straight line, or if we wish to be more sophisticated to a more complex\n", - "function.\n", - "\n", - "The reason for inferring such a model is that it\n", - "serves many useful purposes. On the one hand, the model can reveal information\n", - "encoded in the data or underlying mechanisms from which the data were generated. For instance, we could discover important\n", - "corelations that relate interesting physics interpretations.\n", - "\n", - "In addition, it can simplify the representation of the given data set and help\n", - "us in making predictions about future data samples.\n", - "\n", - "A first important consideration to keep in mind is that inferring the *correct* model\n", - "for a given data set is an elusive, if not impossible, task. The fundamental difficulty\n", - "is that if we are not specific about what we mean by a *correct* model, there\n", - "could easily be many different models that fit the given data set *equally well*.\n", - "\n", - "\n", - "\n", - "\n", - "The central question is this: what leads us to say that a model is correct or\n", - "optimal for a given data set? To make the model inference problem well posed, i.e.,\n", - "to guarantee that there is a unique optimal model for the given data, we need to\n", - "impose additional assumptions or restrictions on the class of models considered. To\n", - "this end, we should not be looking for just any model that can describe the data.\n", - "Instead, we should look for a **model** $M$ that is the best among a restricted class\n", - "of models. In addition, to make the model inference problem computationally\n", - "tractable, we need to specify how restricted the class of models needs to be. A\n", - "common strategy is to start \n", - "with the simplest possible class of models that is just necessary to describe the data\n", - "or solve the problem at hand. More precisely, the model class should be rich enough\n", - "to contain at least one model that can fit the data to a desired accuracy and yet be\n", - "restricted enough that it is relatively simple to find the best model for the given data.\n", - "\n", - "Thus, the most popular strategy is to start from the\n", - "simplest class of models and increase the complexity of the models only when the\n", - "simpler models become inadequate. For instance, if we work with a regression problem to fit a set of sample points, one\n", - "may first try the simplest class of models, namely linear models, followed obviously by more complex models.\n", - "\n", - "How to evaluate which model fits best the data is something we will come back to over and over again in these sets of lectures.\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "## Simple linear regression model using **scikit-learn**\n", - "\n", - "We start with perhaps our simplest possible example, using\n", - "**Scikit-Learn** to perform linear regression analysis on a data set\n", - "produced by us.\n", - "\n", - "What follows is a simple Python code where we have defined a function\n", - "$y$ in terms of the variable $x$. Both are defined as vectors with $100$ entries. \n", - "The numbers in the vector $\\boldsymbol{x}$ are given\n", - "by random numbers generated with a uniform distribution with entries\n", - "$x_i \\in [0,1]$ (more about probability distribution functions\n", - "later). These values are then used to define a function $y(x)$\n", - "(tabulated again as a vector) with a linear dependence on $x$ plus a\n", - "random noise added via the normal distribution.\n", - "\n", - "\n", - "The Numpy functions are imported used the **import numpy as np**\n", - "statement and the random number generator for the uniform distribution\n", - "is called using the function **np.random.rand()**, where we specificy\n", - "that we want $100$ random variables. Using Numpy we define\n", - "automatically an array with the specified number of elements, $100$ in\n", - "our case. With the Numpy function **randn()** we can compute random\n", - "numbers with the normal distribution (mean value $\\mu$ equal to zero and\n", - "variance $\\sigma^2$ set to one) and produce the values of $y$ assuming a linear\n", - "dependence as function of $x$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "y = 2x+N(0,1),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $N(0,1)$ represents random numbers generated by the normal\n", - "distribution. From **Scikit-Learn** we import then the\n", - "**LinearRegression** functionality and make a prediction $\\tilde{y} =\n", - "\\alpha + \\beta x$ using the function **fit(x,y)**. We call the set of\n", - "data $(\\boldsymbol{x},\\boldsymbol{y})$ for our training data. The Python package\n", - "**scikit-learn** has also a functionality which extracts the above\n", - "fitting parameters $\\alpha$ and $\\beta$ (see below). Later we will\n", - "distinguish between training data and test data.\n", - "\n", - "For plotting we use the Python package\n", - "[matplotlib](https://matplotlib.org/) which produces publication\n", - "quality figures. Feel free to explore the extensive\n", - "[gallery](https://matplotlib.org/gallery/index.html) of examples. In\n", - "this example we plot our original values of $x$ and $y$ as well as the\n", - "prediction **ypredict** ($\\tilde{y}$), which attempts at fitting our\n", - "data with a straight line. Note also that **Scikit-Learn** requires a\n", - "matrix as input for the input values $x$ and $y$. In the above code we\n", - "have solved this by declaring $x$ and $y$ as arrays of dimension\n", - "$n\\times 1$.\n", - "\n", - "In the code here we have also made a new array for $x\\in [0,1]$. Our\n", - "prediction is computed for these values, meaning that they were not\n", - "included in the data set used to *train* (or fit) the model.\n", - "This is a recurrring theme in machine learning and data analysis. We would like to train a model on a specific given data set.\n", - "Thereafter we wish to apply it to data which were not included in the training. Below we will encounter this again in the so-called *train-validate-test* spliting. We will typically split our data into different sets, oen for training, one for validation and finally, our data from the untouched test vault!\n", - "\n", - "\n", - "The Python code follows here." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "%matplotlib inline\n", - "\n", - "# Importing various packages\n", - "import numpy as np\n", - "import matplotlib.pyplot as plt\n", - "from sklearn.linear_model import LinearRegression\n", - "\n", - "x = np.random.rand(100,1)\n", - "y = 2*x+np.random.randn(100,1)\n", - "linreg = LinearRegression()\n", - "linreg.fit(x,y)\n", - "# This is our new x-array to which we test our model\n", - "xnew = np.array([[0],[1]])\n", - "ypredict = linreg.predict(xnew)\n", - "\n", - "plt.plot(xnew, ypredict, \"r-\")\n", - "plt.plot(x, y ,'ro')\n", - "plt.axis([0,1.0,0, 5.0])\n", - "plt.xlabel(r'$x$')\n", - "plt.ylabel(r'$y$')\n", - "plt.title(r'Simple Linear Regression')\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "This example serves several aims. It allows us to demonstrate several\n", - "aspects of data analysis and later machine learning algorithms. The\n", - "immediate visualization shows that our linear fit is not\n", - "impressive. It goes through the data points, but there are many\n", - "outliers which are not reproduced by our linear regression. We could\n", - "now play around with this small program and change for example the\n", - "factor in front of $x$ and the normal distribution. Try to change the\n", - "function $y$ to" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "y = 10x+0.01 \\times N(0,1),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $x$ is defined as before. Does the fit look better? Indeed, by\n", - "reducing the role of the noise given by the normal distribution we see immediately that\n", - "our linear prediction seemingly reproduces better the training\n", - "set. However, this testing 'by the eye' is obviouly not satisfactory in the\n", - "long run. Here we have only defined the training data and our model, and \n", - "have not discussed a more rigorous approach to the **cost** function.\n", - "\n", - "We need more rigorous criteria in defining whether we have succeeded or\n", - "not in modeling our training data. You will be surprised to see that\n", - "many scientists seldomly venture beyond this 'by the eye' approach. A\n", - "standard approach for the *cost* function is the so-called $\\chi^2$\n", - "function (a variant of the mean-squared error (MSE))" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\chi^2 = \\frac{1}{n}\n", - "\\sum_{i=0}^{n-1}\\frac{(y_i-\\tilde{y}_i)^2}{\\sigma_i^2},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $\\sigma_i^2$ is the variance (to be defined later) of the entry\n", - "$y_i$. We may not know the explicit value of $\\sigma_i^2$, it serves\n", - "however the aim of scaling the equations and make the cost function\n", - "dimensionless. \n", - "\n", - "Minimizing the cost function is a central aspect of\n", - "our discussions to come. Finding its minima as function of the model\n", - "parameters ($\\alpha$ and $\\beta$ in our case) will be a recurring\n", - "theme in these series of lectures. Essentially all machine learning\n", - "algorithms we will discuss center around the minimization of the\n", - "chosen cost function. This depends in turn on our specific\n", - "model for describing the data, a typical situation in supervised\n", - "learning. Automatizing the search for the minima of the cost function is a\n", - "central ingredient in all algorithms. Typical methods which are\n", - "employed are various variants of **gradient** methods. These will be\n", - "discussed in more detail later. Again, you'll be surprised to hear that\n", - "many practitioners minimize the above function ''by the eye', popularly dubbed as \n", - "'chi by the eye'. That is, change a parameter and see (visually and numerically) that \n", - "the $\\chi^2$ function becomes smaller. \n", - "\n", - "There are many ways to define the cost function. A simpler approach is to look at the relative difference between the training data and the predicted data, that is we define \n", - "the relative error (why would we prefer the MSE instead of the relative error?) as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\epsilon_{\\mathrm{relative}}= \\frac{\\vert \\boldsymbol{y} -\\boldsymbol{\\tilde{y}}\\vert}{\\vert \\boldsymbol{y}\\vert}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The squared cost function results in an arithmetic mean-unbiased\n", - "estimator, and the absolute-value cost function results in a\n", - "median-unbiased estimator (in the one-dimensional case, and a\n", - "geometric median-unbiased estimator for the multi-dimensional\n", - "case). The squared cost function has the disadvantage that it has the tendency\n", - "to be dominated by outliers.\n", - "\n", - "We can modify easily the above Python code and plot the relative error instead" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import numpy as np\n", - "import matplotlib.pyplot as plt\n", - "from sklearn.linear_model import LinearRegression\n", - "# Number of data points\n", - "n = 100\n", - "x = np.random.rand(100,1)\n", - "y = 5*x+0.01*np.random.randn(100,1)\n", - "linreg = LinearRegression()\n", - "linreg.fit(x,y)\n", - "ypredict = linreg.predict(x)\n", - "\n", - "plt.plot(x, np.abs(ypredict-y)/abs(y), \"ro\")\n", - "plt.axis([0,1.0,0.0, 0.5])\n", - "plt.xlabel(r'$x$')\n", - "plt.ylabel(r'$\\epsilon_{\\mathrm{relative}}$')\n", - "plt.title(r'Relative error')\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Depending on the parameter in front of the normal distribution, we may\n", - "have a small or larger relative error. Try to play around with\n", - "different training data sets and study (graphically) the value of the\n", - "relative error.\n", - "\n", - "As mentioned above, **Scikit-Learn** has an impressive functionality.\n", - "We can for example extract the values of $\\alpha$ and $\\beta$ and\n", - "their error estimates, or the variance and standard deviation and many\n", - "other properties from the statistical data analysis. \n", - "\n", - "Here we show an\n", - "example of the functionality of **Scikit-Learn**." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import numpy as np \n", - "import matplotlib.pyplot as plt \n", - "from sklearn.linear_model import LinearRegression \n", - "from sklearn.metrics import mean_squared_error, r2_score, mean_squared_log_error, mean_absolute_error\n", - "\n", - "x = np.random.rand(100,1)\n", - "y = 2.0+ 5*x+0.5*np.random.randn(100,1)\n", - "linreg = LinearRegression()\n", - "linreg.fit(x,y)\n", - "ypredict = linreg.predict(x)\n", - "print('The intercept alpha: \\n', linreg.intercept_)\n", - "print('Coefficient beta : \\n', linreg.coef_)\n", - "# The mean squared error \n", - "print(\"Mean squared error: %.2f\" % mean_squared_error(y, ypredict))\n", - "# Explained variance score: 1 is perfect prediction \n", - "print('Variance score: %.2f' % r2_score(y, ypredict))\n", - "# Mean squared log error \n", - "print('Mean squared log error: %.2f' % mean_squared_log_error(y, ypredict) )\n", - "# Mean absolute error \n", - "print('Mean absolute error: %.2f' % mean_absolute_error(y, ypredict))\n", - "plt.plot(x, ypredict, \"r-\")\n", - "plt.plot(x, y ,'ro')\n", - "plt.axis([0.0,1.0,1.5, 7.0])\n", - "plt.xlabel(r'$x$')\n", - "plt.ylabel(r'$y$')\n", - "plt.title(r'Linear Regression fit ')\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The function **coef** gives us the parameter $\\beta$ of our fit while **intercept** yields \n", - "$\\alpha$. Depending on the constant in front of the normal distribution, we get values near or far from $alpha =2$ and $\\beta =5$. Try to play around with different parameters in front of the normal distribution. The function **meansquarederror** gives us the mean square error, a risk metric corresponding to the expected value of the squared (quadratic) error or loss defined as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "MSE(\\boldsymbol{y},\\boldsymbol{\\tilde{y}}) = \\frac{1}{n}\n", - "\\sum_{i=0}^{n-1}(y_i-\\tilde{y}_i)^2,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The smaller the value, the better the fit. Ideally we would like to\n", - "have an MSE equal zero. The attentive reader has probably recognized\n", - "this function as being similar to the $\\chi^2$ function defined above.\n", - "\n", - "The **r2score** function computes $R^2$, the coefficient of\n", - "determination. It provides a measure of how well future samples are\n", - "likely to be predicted by the model. Best possible score is 1.0 and it\n", - "can be negative (because the model can be arbitrarily worse). A\n", - "constant model that always predicts the expected value of $\\boldsymbol{y}$,\n", - "disregarding the input features, would get a $R^2$ score of $0.0$.\n", - "\n", - "If $\\tilde{\\boldsymbol{y}}_i$ is the predicted value of the $i-th$ sample and $y_i$ is the corresponding true value, then the score $R^2$ is defined as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "R^2(\\boldsymbol{y}, \\tilde{\\boldsymbol{y}}) = 1 - \\frac{\\sum_{i=0}^{n - 1} (y_i - \\tilde{y}_i)^2}{\\sum_{i=0}^{n - 1} (y_i - \\bar{y})^2},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where we have defined the mean value of $\\boldsymbol{y}$ as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\bar{y} = \\frac{1}{n} \\sum_{i=0}^{n - 1} y_i.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Another quantity taht we will meet again in our discussions of regression analysis is \n", - " the mean absolute error (MAE), a risk metric corresponding to the expected value of the absolute error loss or what we call the $l1$-norm loss. In our discussion above we presented the relative error.\n", - "The MAE is defined as follows" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\text{MAE}(\\boldsymbol{y}, \\boldsymbol{\\tilde{y}}) = \\frac{1}{n} \\sum_{i=0}^{n-1} \\left| y_i - \\tilde{y}_i \\right|.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We present the \n", - "squared logarithmic (quadratic) error" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\text{MSLE}(\\boldsymbol{y}, \\boldsymbol{\\tilde{y}}) = \\frac{1}{n} \\sum_{i=0}^{n - 1} (\\log_e (1 + y_i) - \\log_e (1 + \\tilde{y}_i) )^2,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $\\log_e (x)$ stands for the natural logarithm of $x$. This error\n", - "estimate is best to use when targets having exponential growth, such\n", - "as population counts, average sales of a commodity over a span of\n", - "years etc. \n", - "\n", - "\n", - "Finally, another cost function is the Huber cost function used in robust regression.\n", - "\n", - "The rationale behind this possible cost function is its reduced\n", - "sensitivity to outliers in the data set. In our discussions on\n", - "dimensionality reduction and normalization of data we will meet other\n", - "ways of dealing with outliers.\n", - "\n", - "The Huber cost function is defined as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "H_{\\delta}(\\boldsymbol{a})=\\left\\{\\begin{array}{cc}\\frac{1}{2} \\boldsymbol{a}^{2}& \\text{for }|\\boldsymbol{a}|\\leq \\delta\\\\ \\delta (|\\boldsymbol{a}|-\\frac{1}{2}\\delta ),&\\text{otherwise}.\\end{array}\\right.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Here $\\boldsymbol{a}=\\boldsymbol{y} - \\boldsymbol{\\tilde{y}}$.\n", - "\n", - "\n", - "\n", - "\n", - "We will discuss in more\n", - "detail these and other functions in the various lectures. We conclude this part with another example. Instead of \n", - "a linear $x$-dependence we study now a cubic polynomial and use the polynomial regression analysis tools of scikit-learn." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import matplotlib.pyplot as plt\n", - "import numpy as np\n", - "import random\n", - "from sklearn.linear_model import Ridge\n", - "from sklearn.preprocessing import PolynomialFeatures\n", - "from sklearn.pipeline import make_pipeline\n", - "from sklearn.linear_model import LinearRegression\n", - "\n", - "x=np.linspace(0.02,0.98,200)\n", - "noise = np.asarray(random.sample((range(200)),200))\n", - "y=x**3*noise\n", - "yn=x**3*100\n", - "poly3 = PolynomialFeatures(degree=3)\n", - "X = poly3.fit_transform(x[:,np.newaxis])\n", - "clf3 = LinearRegression()\n", - "clf3.fit(X,y)\n", - "\n", - "Xplot=poly3.fit_transform(x[:,np.newaxis])\n", - "poly3_plot=plt.plot(x, clf3.predict(Xplot), label='Cubic Fit')\n", - "plt.plot(x,yn, color='red', label=\"True Cubic\")\n", - "plt.scatter(x, y, label='Data', color='orange', s=15)\n", - "plt.legend()\n", - "plt.show()\n", - "\n", - "def error(a):\n", - " for i in y:\n", - " err=(y-yn)/yn\n", - " return abs(np.sum(err))/len(err)\n", - "\n", - "print (error(y))" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Let us now dive into nuclear physics and remind ourselves briefly about some basic features about binding\n", - "energies. A basic quantity which can be measured for the ground\n", - "states of nuclei is the atomic mass $M(N, Z)$ of the neutral atom with\n", - "atomic mass number $A$ and charge $Z$. The number of neutrons is $N$. There are indeed several sophisticated experiments worldwide which allow us to measure this quantity to high precision (parts per million even). \n", - "\n", - "Atomic masses are usually tabulated in terms of the mass excess defined by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\Delta M(N, Z) = M(N, Z) - uA,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $u$ is the Atomic Mass Unit" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "u = M(^{12}\\mathrm{C})/12 = 931.4940954(57) \\hspace{0.1cm} \\mathrm{MeV}/c^2.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The nucleon masses are" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "m_p = 1.00727646693(9)u,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "m_n = 939.56536(8)\\hspace{0.1cm} \\mathrm{MeV}/c^2 = 1.0086649156(6)u.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In the [2016 mass evaluation of by W.J.Huang, G.Audi, M.Wang, F.G.Kondev, S.Naimi and X.Xu](http://nuclearmasses.org/resources_folder/Wang_2017_Chinese_Phys_C_41_030003.pdf)\n", - "there are data on masses and decays of 3437 nuclei.\n", - "\n", - "The nuclear binding energy is defined as the energy required to break\n", - "up a given nucleus into its constituent parts of $N$ neutrons and $Z$\n", - "protons. In terms of the atomic masses $M(N, Z)$ the binding energy is\n", - "defined by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "BE(N, Z) = ZM_H c^2 + Nm_n c^2 - M(N, Z)c^2 ,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $M_H$ is the mass of the hydrogen atom and $m_n$ is the mass of the neutron.\n", - "In terms of the mass excess the binding energy is given by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "BE(N, Z) = Z\\Delta_H c^2 + N\\Delta_n c^2 -\\Delta(N, Z)c^2 ,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $\\Delta_H c^2 = 7.2890$ MeV and $\\Delta_n c^2 = 8.0713$ MeV.\n", - "\n", - "\n", - "A popular and physically intuitive model which can be used to parametrize \n", - "the experimental binding energies as function of $A$, is the so-called \n", - "**liquid drop model**. The ansatz is based on the following expression" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "BE(N,Z) = a_1A-a_2A^{2/3}-a_3\\frac{Z^2}{A^{1/3}}-a_4\\frac{(N-Z)^2}{A},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $A$ stands for the number of nucleons and the $a_i$s are parameters which are determined by a fit \n", - "to the experimental data. \n", - "\n", - "\n", - "\n", - "\n", - "To arrive at the above expression we have assumed that we can make the following assumptions:\n", - "\n", - " * There is a volume term $a_1A$ proportional with the number of nucleons (the energy is also an extensive quantity). When an assembly of nucleons of the same size is packed together into the smallest volume, each interior nucleon has a certain number of other nucleons in contact with it. This contribution is proportional to the volume.\n", - "\n", - " * There is a surface energy term $a_2A^{2/3}$. The assumption here is that a nucleon at the surface of a nucleus interacts with fewer other nucleons than one in the interior of the nucleus and hence its binding energy is less. This surface energy term takes that into account and is therefore negative and is proportional to the surface area.\n", - "\n", - " * There is a Coulomb energy term $a_3\\frac{Z^2}{A^{1/3}}$. The electric repulsion between each pair of protons in a nucleus yields less binding. \n", - "\n", - " * There is an asymmetry term $a_4\\frac{(N-Z)^2}{A}$. This term is associated with the Pauli exclusion principle and reflects the fact that the proton-neutron interaction is more attractive on the average than the neutron-neutron and proton-proton interactions.\n", - "\n", - "We could also add a so-called pairing term, which is a correction term that\n", - "arises from the tendency of proton pairs and neutron pairs to\n", - "occur. An even number of particles is more stable than an odd number. \n", - "\n", - "\n", - "### Organizing our data\n", - "\n", - "Let us start with reading and organizing our data. \n", - "We start with the compilation of masses and binding energies from 2016.\n", - "After having downloaded this file to our own computer, we are now ready to read the file and start structuring our data.\n", - "\n", - "\n", - "We start with preparing folders for storing our calculations and the data file over masses and binding energies. We import also various modules that we will find useful in order to present various Machine Learning methods. Here we focus mainly on the functionality of **scikit-learn**." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "# Common imports\n", - "import numpy as np\n", - "import pandas as pd\n", - "import matplotlib.pyplot as plt\n", - "import sklearn.linear_model as skl\n", - "from sklearn.model_selection import train_test_split\n", - "from sklearn.metrics import mean_squared_error, r2_score, mean_absolute_error\n", - "import os\n", - "\n", - "# Where to save the figures and data files\n", - "PROJECT_ROOT_DIR = \"Results\"\n", - "FIGURE_ID = \"Results/FigureFiles\"\n", - "DATA_ID = \"DataFiles/\"\n", - "\n", - "if not os.path.exists(PROJECT_ROOT_DIR):\n", - " os.mkdir(PROJECT_ROOT_DIR)\n", - "\n", - "if not os.path.exists(FIGURE_ID):\n", - " os.makedirs(FIGURE_ID)\n", - "\n", - "if not os.path.exists(DATA_ID):\n", - " os.makedirs(DATA_ID)\n", - "\n", - "def image_path(fig_id):\n", - " return os.path.join(FIGURE_ID, fig_id)\n", - "\n", - "def data_path(dat_id):\n", - " return os.path.join(DATA_ID, dat_id)\n", - "\n", - "def save_fig(fig_id):\n", - " plt.savefig(image_path(fig_id) + \".png\", format='png')\n", - "\n", - "infile = open(data_path(\"MassEval2016.dat\"),'r')" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Before we proceed, we define also a function for making our plots. You can obviously avoid this and simply set up various **matplotlib** commands every time you need them. You may however find it convenient to collect all such commands in one function and simply call this function." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "from pylab import plt, mpl\n", - "plt.style.use('seaborn')\n", - "mpl.rcParams['font.family'] = 'serif'\n", - "\n", - "def MakePlot(x,y, styles, labels, axlabels):\n", - " plt.figure(figsize=(10,6))\n", - " for i in range(len(x)):\n", - " plt.plot(x[i], y[i], styles[i], label = labels[i])\n", - " plt.xlabel(axlabels[0])\n", - " plt.ylabel(axlabels[1])\n", - " plt.legend(loc=0)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Our next step is to read the data on experimental binding energies and\n", - "reorganize them as functions of the mass number $A$, the number of\n", - "protons $Z$ and neutrons $N$ using **pandas**. Before we do this it is\n", - "always useful (unless you have a binary file or other types of compressed\n", - "data) to actually open the file and simply take a look at it!\n", - "\n", - "\n", - "In particular, the program that outputs the final nuclear masses is written in Fortran with a specific format. It means that we need to figure out the format and which columns contain the data we are interested in. Pandas comes with a function that reads formatted output. After having admired the file, we are now ready to start massaging it with **pandas**. The file begins with some basic format information." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "\"\"\" \n", - "This is taken from the data file of the mass 2016 evaluation. \n", - "All files are 3436 lines long with 124 character per line. \n", - " Headers are 39 lines long. \n", - " col 1 : Fortran character control: 1 = page feed 0 = line feed \n", - " format : a1,i3,i5,i5,i5,1x,a3,a4,1x,f13.5,f11.5,f11.3,f9.3,1x,a2,f11.3,f9.3,1x,i3,1x,f12.5,f11.5 \n", - " These formats are reflected in the pandas widths variable below, see the statement \n", - " widths=(1,3,5,5,5,1,3,4,1,13,11,11,9,1,2,11,9,1,3,1,12,11,1), \n", - " Pandas has also a variable header, with length 39 in this case. \n", - "\"\"\"" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The data we are interested in are in columns 2, 3, 4 and 11, giving us\n", - "the number of neutrons, protons, mass numbers and binding energies,\n", - "respectively. We add also for the sake of completeness the element name. The data are in fixed-width formatted lines and we will\n", - "covert them into the **pandas** DataFrame structure." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "# Read the experimental data with Pandas\n", - "Masses = pd.read_fwf(infile, usecols=(2,3,4,6,11),\n", - " names=('N', 'Z', 'A', 'Element', 'Ebinding'),\n", - " widths=(1,3,5,5,5,1,3,4,1,13,11,11,9,1,2,11,9,1,3,1,12,11,1),\n", - " header=39,\n", - " index_col=False)\n", - "\n", - "# Extrapolated values are indicated by '#' in place of the decimal place, so\n", - "# the Ebinding column won't be numeric. Coerce to float and drop these entries.\n", - "Masses['Ebinding'] = pd.to_numeric(Masses['Ebinding'], errors='coerce')\n", - "Masses = Masses.dropna()\n", - "# Convert from keV to MeV.\n", - "Masses['Ebinding'] /= 1000\n", - "\n", - "# Group the DataFrame by nucleon number, A.\n", - "Masses = Masses.groupby('A')\n", - "# Find the rows of the grouped DataFrame with the maximum binding energy.\n", - "Masses = Masses.apply(lambda t: t[t.Ebinding==t.Ebinding.max()])" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We have now read in the data, grouped them according to the variables we are interested in. \n", - "We see how easy it is to reorganize the data using **pandas**. If we\n", - "were to do these operations in C/C++ or Fortran, we would have had to\n", - "write various functions/subroutines which perform the above\n", - "reorganizations for us. Having reorganized the data, we can now start\n", - "to make some simple fits using both the functionalities in **numpy** and\n", - "**Scikit-Learn** afterwards. \n", - "\n", - "Now we define five variables which contain\n", - "the number of nucleons $A$, the number of protons $Z$ and the number of neutrons $N$, the element name and finally the energies themselves." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "A = Masses['A']\n", - "Z = Masses['Z']\n", - "N = Masses['N']\n", - "Element = Masses['Element']\n", - "Energies = Masses['Ebinding']\n", - "print(Masses)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The next step, and we will define this mathematically later, is to set up the so-called **design matrix**. We will throughout call this matrix $\\boldsymbol{X}$.\n", - "It has dimensionality $n\\times p$, where $n$ is the number of data points and $p$ are the so-called predictors. In our case here they are given by the number of polynomials in $A$ we wish to include in the fit." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "# Now we set up the design matrix X\n", - "X = np.zeros((len(A),5))\n", - "X[:,0] = 1\n", - "X[:,1] = A\n", - "X[:,2] = A**(2.0/3.0)\n", - "X[:,3] = A**(-1.0/3.0)\n", - "X[:,4] = A**(-1.0)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Note well that we have made life simple here. We perform a fit in\n", - "terms of the number of nucleons only. A more sophisticated fit can be\n", - "done by including an explicit dependence on the number of protons and\n", - "neutrons in the asymmetry and Coulomb terms. We leave this as an exercise to you the reader.\n", - "\n", - "With **Scikit-Learn** we are now ready to use linear regression and fit our data." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "clf = skl.LinearRegression().fit(X, Energies)\n", - "fity = clf.predict(X)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Pretty simple! \n", - "Now we can print measures of how our fit is doing, the coefficients from the fits and plot the final fit together with our data." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "# The mean squared error \n", - "print(\"Mean squared error: %.2f\" % mean_squared_error(Energies, fity))\n", - "# Explained variance score: 1 is perfect prediction \n", - "print('Variance score: %.2f' % r2_score(Energies, fity))\n", - "# Mean absolute error \n", - "print('Mean absolute error: %.2f' % mean_absolute_error(Energies, fity))\n", - "\n", - "Masses['Eapprox'] = fity\n", - "# Generate a plot comparing the experimental with the fitted values values.\n", - "fig, ax = plt.subplots()\n", - "ax.set_xlabel(r'$A = N + Z$')\n", - "ax.set_ylabel(r'$E_\\mathrm{bind}\\,/\\mathrm{MeV}$')\n", - "ax.plot(Masses['A'], Masses['Ebinding'], alpha=0.7, lw=2,\n", - " label='Ame2016')\n", - "ax.plot(Masses['A'], Masses['Eapprox'], alpha=0.7, lw=2, c='m',\n", - " label='Fit')\n", - "ax.legend()\n", - "save_fig(\"Masses2016\")\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "As a teaser, let us now see how we can do this with decision trees using **Scikit-Learn**. Later we will switch to so-called **random forests**!" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "\n", - "#Decision Tree Regression\n", - "from sklearn.tree import DecisionTreeRegressor\n", - "regr_1=DecisionTreeRegressor(max_depth=5)\n", - "regr_2=DecisionTreeRegressor(max_depth=7)\n", - "regr_3=DecisionTreeRegressor(max_depth=9)\n", - "regr_1.fit(X, Energies)\n", - "regr_2.fit(X, Energies)\n", - "regr_3.fit(X, Energies)\n", - "\n", - "\n", - "y_1 = regr_1.predict(X)\n", - "y_2 = regr_2.predict(X)\n", - "y_3=regr_3.predict(X)\n", - "Masses['Eapprox'] = y_3\n", - "# Plot the results\n", - "plt.figure()\n", - "plt.plot(A, Energies, color=\"blue\", label=\"Data\", linewidth=2)\n", - "plt.plot(A, y_1, color=\"red\", label=\"max_depth=5\", linewidth=2)\n", - "plt.plot(A, y_2, color=\"green\", label=\"max_depth=7\", linewidth=2)\n", - "plt.plot(A, y_3, color=\"m\", label=\"max_depth=9\", linewidth=2)\n", - "\n", - "plt.xlabel(\"$A$\")\n", - "plt.ylabel(\"$E$[MeV]\")\n", - "plt.title(\"Decision Tree Regression\")\n", - "plt.legend()\n", - "save_fig(\"Masses2016Trees\")\n", - "plt.show()\n", - "print(Masses)\n", - "print(np.mean( (Energies-y_1)**2))" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "With a deeper and deeper tree level, we can almost reproduce every\n", - "single data point by increasing the max depth of the tree.\n", - "We can actually decide to make a decision tree which fits every single point.\n", - "As we will\n", - "see later, this has the benefit that we can really train a model which\n", - "traverses every single data point. However, the price we pay is that\n", - "we will easily overfit. That is, if we apply our model to unseen data,\n", - "we will most likely fail miserably in our attempt at making\n", - "predictions. As an exercise, try to make the tree level larger by adjusting the maximum depth variable. When printing out the predicition, you will note that the binding energy of every nucleus is accurately reproduced.\n", - "\n", - "\n", - "The **seaborn** package allows us to visualize data in an efficient way. Note that we use **scikit-learn**'s multi-layer perceptron (or feed forward neural network) \n", - "functionality." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "from sklearn.neural_network import MLPRegressor\n", - "from sklearn.metrics import accuracy_score\n", - "import seaborn as sns\n", - "\n", - "X_train = X\n", - "Y_train = Energies\n", - "n_hidden_neurons = 100\n", - "epochs = 100\n", - "# store models for later use\n", - "eta_vals = np.logspace(-5, 1, 7)\n", - "lmbd_vals = np.logspace(-5, 1, 7)\n", - "# store the models for later use\n", - "DNN_scikit = np.zeros((len(eta_vals), len(lmbd_vals)), dtype=object)\n", - "train_accuracy = np.zeros((len(eta_vals), len(lmbd_vals)))\n", - "sns.set()\n", - "for i, eta in enumerate(eta_vals):\n", - " for j, lmbd in enumerate(lmbd_vals):\n", - " dnn = MLPRegressor(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", - " DNN_scikit[i][j] = dnn\n", - " train_accuracy[i][j] = dnn.score(X_train, Y_train)\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()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Linear Regression, basic elements\n", - "\n", - "\n", - "[Video of Lecture](https://www.uio.no/studier/emner/matnat/fys/FYS-STK4155/h20/forelesningsvideoer/LectureAug27.mp4?vrtx=view-as-webpage).\n", - "\n", - "\n", - "Fitting a continuous function with linear parameterization in terms of the parameters $\\boldsymbol{\\beta}$.\n", - "* Method of choice for fitting a continuous function!\n", - "\n", - "* Gives an excellent introduction to central Machine Learning features with **understandable pedagogical** links to other methods like **Neural Networks**, **Support Vector Machines** etc\n", - "\n", - "* Analytical expression for the fitting parameters $\\boldsymbol{\\beta}$\n", - "\n", - "* Analytical expressions for statistical propertiers like mean values, variances, confidence intervals and more\n", - "\n", - "* Analytical relation with probabilistic interpretations \n", - "\n", - "* Easy to introduce basic concepts like bias-variance tradeoff, cross-validation, resampling and regularization techniques and many other ML topics\n", - "\n", - "* Easy to code! And links well with classification problems and logistic regression and neural networks\n", - "\n", - "* Allows for **easy** hands-on understanding of gradient descent methods\n", - "\n", - "* and many more features\n", - "\n", - "For more discussions of Ridge and Lasso regression, [Wessel van Wieringen's](https://arxiv.org/abs/1509.09169) article is highly recommended.\n", - "Similarly, [Mehta et al's article](https://arxiv.org/abs/1803.08823) is also recommended.\n", - "\n", - "\n", - "\n", - "Regression modeling deals with the description of the sampling distribution of a given random variable $y$ and how it varies as function of another variable or a set of such variables $\\boldsymbol{x} =[x_0, x_1,\\dots, x_{n-1}]^T$. \n", - "The first variable is called the **dependent**, the **outcome** or the **response** variable while the set of variables $\\boldsymbol{x}$ is called the independent variable, or the predictor variable or the explanatory variable. \n", - "\n", - "A regression model aims at finding a likelihood function $p(\\boldsymbol{y}\\vert \\boldsymbol{x})$, that is the conditional distribution for $\\boldsymbol{y}$ with a given $\\boldsymbol{x}$. The estimation of $p(\\boldsymbol{y}\\vert \\boldsymbol{x})$ is made using a data set with \n", - "* $n$ cases $i = 0, 1, 2, \\dots, n-1$ \n", - "\n", - "* Response (target, dependent or outcome) variable $y_i$ with $i = 0, 1, 2, \\dots, n-1$ \n", - "\n", - "* $p$ so-called explanatory (independent or predictor) variables $\\boldsymbol{x}_i=[x_{i0}, x_{i1}, \\dots, x_{ip-1}]$ with $i = 0, 1, 2, \\dots, n-1$ and explanatory variables running from $0$ to $p-1$. See below for more explicit examples. \n", - "\n", - " The goal of the regression analysis is to extract/exploit relationship between $\\boldsymbol{y}$ and $\\boldsymbol{x}$ in or to infer causal dependencies, approximations to the likelihood functions, functional relationships and to make predictions, making fits and many other things.\n", - "\n", - "\n", - "Consider an experiment in which $p$ characteristics of $n$ samples are\n", - "measured. The data from this experiment, for various explanatory variables $p$ are normally represented by a matrix \n", - "$\\mathbf{X}$.\n", - "\n", - "The matrix $\\mathbf{X}$ is called the *design\n", - "matrix*. Additional information of the samples is available in the\n", - "form of $\\boldsymbol{y}$ (also as above). The variable $\\boldsymbol{y}$ is\n", - "generally referred to as the *response variable*. The aim of\n", - "regression analysis is to explain $\\boldsymbol{y}$ in terms of\n", - "$\\boldsymbol{X}$ through a functional relationship like $y_i =\n", - "f(\\mathbf{X}_{i,\\ast})$. When no prior knowledge on the form of\n", - "$f(\\cdot)$ is available, it is common to assume a linear relationship\n", - "between $\\boldsymbol{X}$ and $\\boldsymbol{y}$. This assumption gives rise to\n", - "the *linear regression model* where $\\boldsymbol{\\beta} = [\\beta_0, \\ldots,\n", - "\\beta_{p-1}]^{T}$ are the *regression parameters*. \n", - "\n", - "Linear regression gives us a set of analytical equations for the parameters $\\beta_j$.\n", - "\n", - "\n", - "In order to understand the relation among the predictors $p$, the set of data $n$ and the target (outcome, output etc) $\\boldsymbol{y}$,\n", - "consider the model we discussed for describing nuclear binding energies. \n", - "\n", - "There we assumed that we could parametrize the data using a polynomial approximation based on the liquid drop model.\n", - "Assuming" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "BE(A) = a_0+a_1A+a_2A^{2/3}+a_3A^{-1/3}+a_4A^{-1},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "we have five predictors, that is the intercept, the $A$ dependent term, the $A^{2/3}$ term and the $A^{-1/3}$ and $A^{-1}$ terms.\n", - "This gives $p=0,1,2,3,4$. Furthermore we have $n$ entries for each predictor. It means that our design matrix is a \n", - "$p\\times n$ matrix $\\boldsymbol{X}$.\n", - "\n", - "Here the predictors are based on a model we have made. A popular data set which is widely encountered in ML applications is the\n", - "so-called [credit card default data from Taiwan](https://www.sciencedirect.com/science/article/pii/S0957417407006719?via%3Dihub). The data set contains data on $n=30000$ credit card holders with predictors like gender, marital status, age, profession, education, etc. In total there are $24$ such predictors or attributes leading to a design matrix of dimensionality $24 \\times 30000$. This is however a classification problem and we will come back to it when we discuss Logistic Regression. \n", - "\n", - "\n", - "Before we proceed let us study a case from linear algebra where we aim at fitting a set of data $\\boldsymbol{y}=[y_0,y_1,\\dots,y_{n-1}]$. We could think of these data as a result of an experiment or a complicated numerical experiment. These data are functions of a series of variables $\\boldsymbol{x}=[x_0,x_1,\\dots,x_{n-1}]$, that is $y_i = y(x_i)$ with $i=0,1,2,\\dots,n-1$. The variables $x_i$ could represent physical quantities like time, temperature, position etc. We assume that $y(x)$ is a smooth function. \n", - "\n", - "Since obtaining these data points may not be trivial, we want to use these data to fit a function which can allow us to make predictions for values of $y$ which are not in the present set. The perhaps simplest approach is to assume we can parametrize our function in terms of a polynomial of degree $n-1$ with $n$ points, that is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "y=y(x) \\rightarrow y(x_i)=\\tilde{y}_i+\\epsilon_i=\\sum_{j=0}^{n-1} \\beta_j x_i^j+\\epsilon_i,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $\\epsilon_i$ is the error in our approximation. \n", - "\n", - "\n", - "For every set of values $y_i,x_i$ we have thus the corresponding set of equations" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{align*}\n", - "y_0&=\\beta_0+\\beta_1x_0^1+\\beta_2x_0^2+\\dots+\\beta_{n-1}x_0^{n-1}+\\epsilon_0\\\\\n", - "y_1&=\\beta_0+\\beta_1x_1^1+\\beta_2x_1^2+\\dots+\\beta_{n-1}x_1^{n-1}+\\epsilon_1\\\\\n", - "y_2&=\\beta_0+\\beta_1x_2^1+\\beta_2x_2^2+\\dots+\\beta_{n-1}x_2^{n-1}+\\epsilon_2\\\\\n", - "\\dots & \\dots \\\\\n", - "y_{n-1}&=\\beta_0+\\beta_1x_{n-1}^1+\\beta_2x_{n-1}^2+\\dots+\\beta_{n-1}x_{n-1}^{n-1}+\\epsilon_{n-1}.\\\\\n", - "\\end{align*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Defining the vectors" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{y} = [y_0,y_1, y_2,\\dots, y_{n-1}]^T,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{\\beta} = [\\beta_0,\\beta_1, \\beta_2,\\dots, \\beta_{n-1}]^T,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{\\epsilon} = [\\epsilon_0,\\epsilon_1, \\epsilon_2,\\dots, \\epsilon_{n-1}]^T,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and the design matrix" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}=\n", - "\\begin{bmatrix} \n", - "1& x_{0}^1 &x_{0}^2& \\dots & \\dots &x_{0}^{n-1}\\\\\n", - "1& x_{1}^1 &x_{1}^2& \\dots & \\dots &x_{1}^{n-1}\\\\\n", - "1& x_{2}^1 &x_{2}^2& \\dots & \\dots &x_{2}^{n-1}\\\\ \n", - "\\dots& \\dots &\\dots& \\dots & \\dots &\\dots\\\\\n", - "1& x_{n-1}^1 &x_{n-1}^2& \\dots & \\dots &x_{n-1}^{n-1}\\\\\n", - "\\end{bmatrix}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "we can rewrite our equations as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{y} = \\boldsymbol{X}\\boldsymbol{\\beta}+\\boldsymbol{\\epsilon}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The above design matrix is called a [Vandermonde matrix](https://en.wikipedia.org/wiki/Vandermonde_matrix).\n", - "\n", - "We are obviously not limited to the above polynomial expansions. We\n", - "could replace the various powers of $x$ with elements of Fourier\n", - "series or instead of $x_i^j$ we could have $\\cos{(j x_i)}$ or $\\sin{(j\n", - "x_i)}$, or time series or other orthogonal functions. For every set\n", - "of values $y_i,x_i$ we can then generalize the equations to" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{align*}\n", - "y_0&=\\beta_0x_{00}+\\beta_1x_{01}+\\beta_2x_{02}+\\dots+\\beta_{n-1}x_{0n-1}+\\epsilon_0\\\\\n", - "y_1&=\\beta_0x_{10}+\\beta_1x_{11}+\\beta_2x_{12}+\\dots+\\beta_{n-1}x_{1n-1}+\\epsilon_1\\\\\n", - "y_2&=\\beta_0x_{20}+\\beta_1x_{21}+\\beta_2x_{22}+\\dots+\\beta_{n-1}x_{2n-1}+\\epsilon_2\\\\\n", - "\\dots & \\dots \\\\\n", - "y_{i}&=\\beta_0x_{i0}+\\beta_1x_{i1}+\\beta_2x_{i2}+\\dots+\\beta_{n-1}x_{in-1}+\\epsilon_i\\\\\n", - "\\dots & \\dots \\\\\n", - "y_{n-1}&=\\beta_0x_{n-1,0}+\\beta_1x_{n-1,2}+\\beta_2x_{n-1,2}+\\dots+\\beta_{n-1}x_{n-1,n-1}+\\epsilon_{n-1}.\\\\\n", - "\\end{align*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "**Note that we have $p=n$ here. The matrix is symmetric. This is generally not the case!**\n", - "\n", - "We redefine in turn the matrix $\\boldsymbol{X}$ as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}=\n", - "\\begin{bmatrix} \n", - "x_{00}& x_{01} &x_{02}& \\dots & \\dots &x_{0,n-1}\\\\\n", - "x_{10}& x_{11} &x_{12}& \\dots & \\dots &x_{1,n-1}\\\\\n", - "x_{20}& x_{21} &x_{22}& \\dots & \\dots &x_{2,n-1}\\\\ \n", - "\\dots& \\dots &\\dots& \\dots & \\dots &\\dots\\\\\n", - "x_{n-1,0}& x_{n-1,1} &x_{n-1,2}& \\dots & \\dots &x_{n-1,n-1}\\\\\n", - "\\end{bmatrix}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and without loss of generality we rewrite again our equations as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{y} = \\boldsymbol{X}\\boldsymbol{\\beta}+\\boldsymbol{\\epsilon}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The left-hand side of this equation is kwown. Our error vector $\\boldsymbol{\\epsilon}$ and the parameter vector $\\boldsymbol{\\beta}$ are our unknow quantities. How can we obtain the optimal set of $\\beta_i$ values? \n", - "\n", - "We have defined the matrix $\\boldsymbol{X}$ via the equations" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{align*}\n", - "y_0&=\\beta_0x_{00}+\\beta_1x_{01}+\\beta_2x_{02}+\\dots+\\beta_{n-1}x_{0n-1}+\\epsilon_0\\\\\n", - "y_1&=\\beta_0x_{10}+\\beta_1x_{11}+\\beta_2x_{12}+\\dots+\\beta_{n-1}x_{1n-1}+\\epsilon_1\\\\\n", - "y_2&=\\beta_0x_{20}+\\beta_1x_{21}+\\beta_2x_{22}+\\dots+\\beta_{n-1}x_{2n-1}+\\epsilon_1\\\\\n", - "\\dots & \\dots \\\\\n", - "y_{i}&=\\beta_0x_{i0}+\\beta_1x_{i1}+\\beta_2x_{i2}+\\dots+\\beta_{n-1}x_{in-1}+\\epsilon_1\\\\\n", - "\\dots & \\dots \\\\\n", - "y_{n-1}&=\\beta_0x_{n-1,0}+\\beta_1x_{n-1,2}+\\beta_2x_{n-1,2}+\\dots+\\beta_{n-1}x_{n-1,n-1}+\\epsilon_{n-1}.\\\\\n", - "\\end{align*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "As we noted above, we stayed with a system with the design matrix \n", - " $\\boldsymbol{X}\\in {\\mathbb{R}}^{n\\times n}$, that is we have $p=n$. For reasons to come later (algorithmic arguments) we will hereafter define \n", - "our matrix as $\\boldsymbol{X}\\in {\\mathbb{R}}^{n\\times p}$, with the predictors refering to the column numbers and the entries $n$ being the row elements.\n", - "\n", - "In our [introductory notes](https://compphysics.github.io/MachineLearning/doc/pub/How2ReadData/html/How2ReadData.html) we looked at the so-called [liquid drop model](https://en.wikipedia.org/wiki/Semi-empirical_mass_formula). Let us remind ourselves about what we did by looking at the code.\n", - "\n", - "We restate the parts of the code we are most interested in." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "# Common imports\n", - "import numpy as np\n", - "import pandas as pd\n", - "import matplotlib.pyplot as plt\n", - "from IPython.display import display\n", - "import os\n", - "\n", - "# Where to save the figures and data files\n", - "PROJECT_ROOT_DIR = \"Results\"\n", - "FIGURE_ID = \"Results/FigureFiles\"\n", - "DATA_ID = \"DataFiles/\"\n", - "\n", - "if not os.path.exists(PROJECT_ROOT_DIR):\n", - " os.mkdir(PROJECT_ROOT_DIR)\n", - "\n", - "if not os.path.exists(FIGURE_ID):\n", - " os.makedirs(FIGURE_ID)\n", - "\n", - "if not os.path.exists(DATA_ID):\n", - " os.makedirs(DATA_ID)\n", - "\n", - "def image_path(fig_id):\n", - " return os.path.join(FIGURE_ID, fig_id)\n", - "\n", - "def data_path(dat_id):\n", - " return os.path.join(DATA_ID, dat_id)\n", - "\n", - "def save_fig(fig_id):\n", - " plt.savefig(image_path(fig_id) + \".png\", format='png')\n", - "\n", - "infile = open(data_path(\"MassEval2016.dat\"),'r')\n", - "\n", - "\n", - "# Read the experimental data with Pandas\n", - "Masses = pd.read_fwf(infile, usecols=(2,3,4,6,11),\n", - " names=('N', 'Z', 'A', 'Element', 'Ebinding'),\n", - " widths=(1,3,5,5,5,1,3,4,1,13,11,11,9,1,2,11,9,1,3,1,12,11,1),\n", - " header=39,\n", - " index_col=False)\n", - "\n", - "# Extrapolated values are indicated by '#' in place of the decimal place, so\n", - "# the Ebinding column won't be numeric. Coerce to float and drop these entries.\n", - "Masses['Ebinding'] = pd.to_numeric(Masses['Ebinding'], errors='coerce')\n", - "Masses = Masses.dropna()\n", - "# Convert from keV to MeV.\n", - "Masses['Ebinding'] /= 1000\n", - "\n", - "# Group the DataFrame by nucleon number, A.\n", - "Masses = Masses.groupby('A')\n", - "# Find the rows of the grouped DataFrame with the maximum binding energy.\n", - "Masses = Masses.apply(lambda t: t[t.Ebinding==t.Ebinding.max()])\n", - "A = Masses['A']\n", - "Z = Masses['Z']\n", - "N = Masses['N']\n", - "Element = Masses['Element']\n", - "Energies = Masses['Ebinding']\n", - "\n", - "# Now we set up the design matrix X\n", - "X = np.zeros((len(A),5))\n", - "X[:,0] = 1\n", - "X[:,1] = A\n", - "X[:,2] = A**(2.0/3.0)\n", - "X[:,3] = A**(-1.0/3.0)\n", - "X[:,4] = A**(-1.0)\n", - "# Then nice printout using pandas\n", - "DesignMatrix = pd.DataFrame(X)\n", - "DesignMatrix.index = A\n", - "DesignMatrix.columns = ['1', 'A', 'A^(2/3)', 'A^(-1/3)', '1/A']\n", - "display(DesignMatrix)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "With $\\boldsymbol{\\beta}\\in {\\mathbb{R}}^{p\\times 1}$, it means that we will hereafter write our equations for the approximation as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{\\tilde{y}}= \\boldsymbol{X}\\boldsymbol{\\beta},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "throughout these lectures. \n", - "\n", - "With the above we use the design matrix to define the approximation $\\boldsymbol{\\tilde{y}}$ via the unknown quantity $\\boldsymbol{\\beta}$ as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{\\tilde{y}}= \\boldsymbol{X}\\boldsymbol{\\beta},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and in order to find the optimal parameters $\\beta_i$ instead of solving the above linear algebra problem, we define a function which gives a measure of the spread between the values $y_i$ (which represent hopefully the exact values) and the parameterized values $\\tilde{y}_i$, namely" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(\\boldsymbol{\\beta})=\\frac{1}{n}\\sum_{i=0}^{n-1}\\left(y_i-\\tilde{y}_i\\right)^2=\\frac{1}{n}\\left\\{\\left(\\boldsymbol{y}-\\boldsymbol{\\tilde{y}}\\right)^T\\left(\\boldsymbol{y}-\\boldsymbol{\\tilde{y}}\\right)\\right\\},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "or using the matrix $\\boldsymbol{X}$ and in a more compact matrix-vector notation as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(\\boldsymbol{\\beta})=\\frac{1}{n}\\left\\{\\left(\\boldsymbol{y}-\\boldsymbol{X}\\boldsymbol{\\beta}\\right)^T\\left(\\boldsymbol{y}-\\boldsymbol{X}\\boldsymbol{\\beta}\\right)\\right\\}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "This function is one possible way to define the so-called cost function.\n", - "\n", - "\n", - "\n", - "It is also common to define\n", - "the function $C$ as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(\\boldsymbol{\\beta})=\\frac{1}{2n}\\sum_{i=0}^{n-1}\\left(y_i-\\tilde{y}_i\\right)^2,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "since when taking the first derivative with respect to the unknown parameters $\\beta$, the factor of $2$ cancels out. \n", - "\n", - "The function" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(\\boldsymbol{\\beta})=\\frac{1}{n}\\left\\{\\left(\\boldsymbol{y}-\\boldsymbol{X}\\boldsymbol{\\beta}\\right)^T\\left(\\boldsymbol{y}-\\boldsymbol{X}\\boldsymbol{\\beta}\\right)\\right\\},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "can be linked to the variance of the quantity $y_i$ if we interpret the latter as the mean value. \n", - "When linking (see the discussion below) with the maximum likelihood approach below, we will indeed interpret $y_i$ as a mean value" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "y_{i}=\\langle y_i \\rangle = \\beta_0x_{i,0}+\\beta_1x_{i,1}+\\beta_2x_{i,2}+\\dots+\\beta_{n-1}x_{i,n-1}+\\epsilon_i,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $\\langle y_i \\rangle$ is the mean value. Keep in mind also that\n", - "till now we have treated $y_i$ as the exact value. Normally, the\n", - "response (dependent or outcome) variable $y_i$ the outcome of a\n", - "numerical experiment or another type of experiment and is thus only an\n", - "approximation to the true value. It is then always accompanied by an\n", - "error estimate, often limited to a statistical error estimate given by\n", - "the standard deviation discussed earlier. In the discussion here we\n", - "will treat $y_i$ as our exact value for the response variable.\n", - "\n", - "In order to find the parameters $\\beta_i$ we will then minimize the spread of $C(\\boldsymbol{\\beta})$, that is we are going to solve the problem" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "{\\displaystyle \\min_{\\boldsymbol{\\beta}\\in\n", - "{\\mathbb{R}}^{p}}}\\frac{1}{n}\\left\\{\\left(\\boldsymbol{y}-\\boldsymbol{X}\\boldsymbol{\\beta}\\right)^T\\left(\\boldsymbol{y}-\\boldsymbol{X}\\boldsymbol{\\beta}\\right)\\right\\}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In practical terms it means we will require" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial C(\\boldsymbol{\\beta})}{\\partial \\beta_j} = \\frac{\\partial }{\\partial \\beta_j}\\left[ \\frac{1}{n}\\sum_{i=0}^{n-1}\\left(y_i-\\beta_0x_{i,0}-\\beta_1x_{i,1}-\\beta_2x_{i,2}-\\dots-\\beta_{n-1}x_{i,n-1}\\right)^2\\right]=0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which results in" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial C(\\boldsymbol{\\beta})}{\\partial \\beta_j} = -\\frac{2}{n}\\left[ \\sum_{i=0}^{n-1}x_{ij}\\left(y_i-\\beta_0x_{i,0}-\\beta_1x_{i,1}-\\beta_2x_{i,2}-\\dots-\\beta_{n-1}x_{i,n-1}\\right)\\right]=0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "or in a matrix-vector form as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial C(\\boldsymbol{\\beta})}{\\partial \\boldsymbol{\\beta}} = 0 = \\boldsymbol{X}^T\\left( \\boldsymbol{y}-\\boldsymbol{X}\\boldsymbol{\\beta}\\right).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We can rewrite" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial C(\\boldsymbol{\\beta})}{\\partial \\boldsymbol{\\beta}} = 0 = \\boldsymbol{X}^T\\left( \\boldsymbol{y}-\\boldsymbol{X}\\boldsymbol{\\beta}\\right),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}^T\\boldsymbol{y} = \\boldsymbol{X}^T\\boldsymbol{X}\\boldsymbol{\\beta},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and if the matrix $\\boldsymbol{X}^T\\boldsymbol{X}$ is invertible we have the solution" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{\\beta} =\\left(\\boldsymbol{X}^T\\boldsymbol{X}\\right)^{-1}\\boldsymbol{X}^T\\boldsymbol{y}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We note also that since our design matrix is defined as $\\boldsymbol{X}\\in\n", - "{\\mathbb{R}}^{n\\times p}$, the product $\\boldsymbol{X}^T\\boldsymbol{X} \\in\n", - "{\\mathbb{R}}^{p\\times p}$. In the above case we have that $p \\ll n$,\n", - "in our case $p=5$ meaning that we end up with inverting a small\n", - "$5\\times 5$ matrix. This is a rather common situation, in many cases we end up with low-dimensional\n", - "matrices to invert. The methods discussed here and for many other\n", - "supervised learning algorithms like classification with logistic\n", - "regression or support vector machines, exhibit dimensionalities which\n", - "allow for the usage of direct linear algebra methods such as **LU** decomposition or **Singular Value Decomposition** (SVD) for finding the inverse of the matrix\n", - "$\\boldsymbol{X}^T\\boldsymbol{X}$. \n", - "\n", - "**Small question**: Do you think the example we have at hand here (the nuclear binding energies) can lead to problems in inverting the matrix $\\boldsymbol{X}^T\\boldsymbol{X}$? What kind of problems can we expect? \n", - "\n", - "\n", - "The following matrix and vector relation will be useful here and for the rest of the course. Vectors are always written as boldfaced lower case letters and \n", - "matrices as upper case boldfaced letters." - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "4\n", - "3\n", - " \n", - "<\n", - "<\n", - "<\n", - "!\n", - "!\n", - "M\n", - "A\n", - "T\n", - "H\n", - "_\n", - "B\n", - "L\n", - "O\n", - "C\n", - "K" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "4\n", - "4\n", - " \n", - "<\n", - "<\n", - "<\n", - "!\n", - "!\n", - "M\n", - "A\n", - "T\n", - "H\n", - "_\n", - "B\n", - "L\n", - "O\n", - "C\n", - "K" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "4\n", - "5\n", - " \n", - "<\n", - "<\n", - "<\n", - "!\n", - "!\n", - "M\n", - "A\n", - "T\n", - "H\n", - "_\n", - "B\n", - "L\n", - "O\n", - "C\n", - "K" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial\\log{\\vert\\boldsymbol{A}\\vert}}{\\partial \\boldsymbol{A}}=(\\boldsymbol{A}^{-1})^T.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We can then compute the second derivative of the cost function, which in our case is the second derivative\n", - "of the means squared error. This leads to" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial^2 C(\\boldsymbol{\\beta})}{\\partial \\boldsymbol{\\beta}^T\\partial \\boldsymbol{\\beta}} =\\frac{2}{n}\\boldsymbol{X}^T\\boldsymbol{X}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "This quantity defines was what is called the Hessian matrix (the second derivative of a function we want to optimize).\n", - "\n", - "The Hessian matrix plays an important role and is defined for the mean squared error as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{H}=\\boldsymbol{X}^T\\boldsymbol{X}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The Hessian matrix for ordinary least squares is also proportional to\n", - "the covariance matrix. As we will see in the chapter on Ridge and Lasso regression, This means that we can use the Singular Value Decomposition of a matrix to find\n", - "the eigenvalues of the covariance matrix and the Hessian matrix in\n", - "terms of the singular values.\n", - "\n", - "\n", - "The residuals $\\boldsymbol{\\epsilon}$ are in turn given by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{\\epsilon} = \\boldsymbol{y}-\\boldsymbol{\\tilde{y}} = \\boldsymbol{y}-\\boldsymbol{X}\\boldsymbol{\\beta},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and with" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}^T\\left( \\boldsymbol{y}-\\boldsymbol{X}\\boldsymbol{\\beta}\\right)= 0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}^T\\boldsymbol{\\epsilon}=\\boldsymbol{X}^T\\left( \\boldsymbol{y}-\\boldsymbol{X}\\boldsymbol{\\beta}\\right)= 0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "meaning that the solution for $\\boldsymbol{\\beta}$ is the one which minimizes the residuals. Later we will link this with the maximum likelihood approach.\n", - "\n", - "\n", - "Let us now return to our nuclear binding energies and simply code the above equations. \n", - "\n", - "\n", - "It is rather straightforward to implement the matrix inversion and obtain the parameters $\\boldsymbol{\\beta}$. After having defined the matrix $\\boldsymbol{X}$ we simply need to \n", - "write" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "# matrix inversion to find beta\n", - "beta = np.linalg.inv(X.T.dot(X)).dot(X.T).dot(Energies)\n", - "# and then make the prediction\n", - "ytilde = X @ beta" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Alternatively, you can use the least squares functionality in **Numpy** as" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "fit = np.linalg.lstsq(X, Energies, rcond =None)[0]\n", - "ytildenp = np.dot(fit,X.T)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "And finally we plot our fit with and compare with data" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "Masses['Eapprox'] = ytilde\n", - "# Generate a plot comparing the experimental with the fitted values values.\n", - "fig, ax = plt.subplots()\n", - "ax.set_xlabel(r'$A = N + Z$')\n", - "ax.set_ylabel(r'$E_\\mathrm{bind}\\,/\\mathrm{MeV}$')\n", - "ax.plot(Masses['A'], Masses['Ebinding'], alpha=0.7, lw=2,\n", - " label='Ame2016')\n", - "ax.plot(Masses['A'], Masses['Eapprox'], alpha=0.7, lw=2, c='m',\n", - " label='Fit')\n", - "ax.legend()\n", - "save_fig(\"Masses2016OLS\")\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We can easily test our fit by computing the $R2$ score that we discussed in connection with the functionality of **Scikit-Learn** in the introductory slides.\n", - "Since we are not using **Scikit-Learn** here we can define our own $R2$ function as" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "def R2(y_data, y_model):\n", - " return 1 - np.sum((y_data - y_model) ** 2) / np.sum((y_data - np.mean(y_data)) ** 2)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and we would be using it as" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "print(R2(Energies,ytilde))" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We can easily add our **MSE** score as" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "def MSE(y_data,y_model):\n", - " n = np.size(y_model)\n", - " return np.sum((y_data-y_model)**2)/n\n", - "\n", - "print(MSE(Energies,ytilde))" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and finally the relative error as" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "def RelativeError(y_data,y_model):\n", - " return abs((y_data-y_model)/y_data)\n", - "print(RelativeError(Energies, ytilde))" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "### The $\\chi^2$ function\n", - "\n", - "Normally, the response (dependent or outcome) variable $y_i$ is the\n", - "outcome of a numerical experiment or another type of experiment and is\n", - "thus only an approximation to the true value. It is then always\n", - "accompanied by an error estimate, often limited to a statistical error\n", - "estimate given by the standard deviation discussed earlier. In the\n", - "discussion here we will treat $y_i$ as our exact value for the\n", - "response variable.\n", - "\n", - "Introducing the standard deviation $\\sigma_i$ for each measurement\n", - "$y_i$, we define now the $\\chi^2$ function (omitting the $1/n$ term)\n", - "as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\chi^2(\\boldsymbol{\\beta})=\\frac{1}{n}\\sum_{i=0}^{n-1}\\frac{\\left(y_i-\\tilde{y}_i\\right)^2}{\\sigma_i^2}=\\frac{1}{n}\\left\\{\\left(\\boldsymbol{y}-\\boldsymbol{\\tilde{y}}\\right)^T\\frac{1}{\\boldsymbol{\\Sigma^2}}\\left(\\boldsymbol{y}-\\boldsymbol{\\tilde{y}}\\right)\\right\\},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where the matrix $\\boldsymbol{\\Sigma}$ is a diagonal matrix with $\\sigma_i$ as matrix elements. \n", - "\n", - "\n", - "In order to find the parameters $\\beta_i$ we will then minimize the spread of $\\chi^2(\\boldsymbol{\\beta})$ by requiring" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial \\chi^2(\\boldsymbol{\\beta})}{\\partial \\beta_j} = \\frac{\\partial }{\\partial \\beta_j}\\left[ \\frac{1}{n}\\sum_{i=0}^{n-1}\\left(\\frac{y_i-\\beta_0x_{i,0}-\\beta_1x_{i,1}-\\beta_2x_{i,2}-\\dots-\\beta_{n-1}x_{i,n-1}}{\\sigma_i}\\right)^2\\right]=0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which results in" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial \\chi^2(\\boldsymbol{\\beta})}{\\partial \\beta_j} = -\\frac{2}{n}\\left[ \\sum_{i=0}^{n-1}\\frac{x_{ij}}{\\sigma_i}\\left(\\frac{y_i-\\beta_0x_{i,0}-\\beta_1x_{i,1}-\\beta_2x_{i,2}-\\dots-\\beta_{n-1}x_{i,n-1}}{\\sigma_i}\\right)\\right]=0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "or in a matrix-vector form as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial \\chi^2(\\boldsymbol{\\beta})}{\\partial \\boldsymbol{\\beta}} = 0 = \\boldsymbol{A}^T\\left( \\boldsymbol{b}-\\boldsymbol{A}\\boldsymbol{\\beta}\\right).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where we have defined the matrix $\\boldsymbol{A} =\\boldsymbol{X}/\\boldsymbol{\\Sigma}$ with matrix elements $a_{ij} = x_{ij}/\\sigma_i$ and the vector $\\boldsymbol{b}$ with elements $b_i = y_i/\\sigma_i$. \n", - "\n", - "We can rewrite" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial \\chi^2(\\boldsymbol{\\beta})}{\\partial \\boldsymbol{\\beta}} = 0 = \\boldsymbol{A}^T\\left( \\boldsymbol{b}-\\boldsymbol{A}\\boldsymbol{\\beta}\\right),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{A}^T\\boldsymbol{b} = \\boldsymbol{A}^T\\boldsymbol{A}\\boldsymbol{\\beta},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and if the matrix $\\boldsymbol{A}^T\\boldsymbol{A}$ is invertible we have the solution" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{\\beta} =\\left(\\boldsymbol{A}^T\\boldsymbol{A}\\right)^{-1}\\boldsymbol{A}^T\\boldsymbol{b}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "If we then introduce the matrix" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{H} = \\left(\\boldsymbol{A}^T\\boldsymbol{A}\\right)^{-1},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "we have then the following expression for the parameters $\\beta_j$ (the matrix elements of $\\boldsymbol{H}$ are $h_{ij}$)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\beta_j = \\sum_{k=0}^{p-1}h_{jk}\\sum_{i=0}^{n-1}\\frac{y_i}{\\sigma_i}\\frac{x_{ik}}{\\sigma_i} = \\sum_{k=0}^{p-1}h_{jk}\\sum_{i=0}^{n-1}b_ia_{ik}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We state without proof the expression for the uncertainty in the parameters $\\beta_j$ as (we leave this as an exercise)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\sigma^2(\\beta_j) = \\sum_{i=0}^{n-1}\\sigma_i^2\\left( \\frac{\\partial \\beta_j}{\\partial y_i}\\right)^2,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "resulting in" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\sigma^2(\\beta_j) = \\left(\\sum_{k=0}^{p-1}h_{jk}\\sum_{i=0}^{n-1}a_{ik}\\right)\\left(\\sum_{l=0}^{p-1}h_{jl}\\sum_{m=0}^{n-1}a_{ml}\\right) = h_{jj}!\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The first step here is to approximate the function $y$ with a first-order polynomial, that is we write" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "y=y(x) \\rightarrow y(x_i) \\approx \\beta_0+\\beta_1 x_i.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "By computing the derivatives of $\\chi^2$ with respect to $\\beta_0$ and $\\beta_1$ show that these are given by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial \\chi^2(\\boldsymbol{\\beta})}{\\partial \\beta_0} = -2\\left[ \\frac{1}{n}\\sum_{i=0}^{n-1}\\left(\\frac{y_i-\\beta_0-\\beta_1x_{i}}{\\sigma_i^2}\\right)\\right]=0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial \\chi^2(\\boldsymbol{\\beta})}{\\partial \\beta_1} = -\\frac{2}{n}\\left[ \\sum_{i=0}^{n-1}x_i\\left(\\frac{y_i-\\beta_0-\\beta_1x_{i}}{\\sigma_i^2}\\right)\\right]=0.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "For a linear fit (a first-order polynomial) we don't need to invert a matrix!! \n", - "Defining" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\gamma = \\sum_{i=0}^{n-1}\\frac{1}{\\sigma_i^2},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\gamma_x = \\sum_{i=0}^{n-1}\\frac{x_{i}}{\\sigma_i^2},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\gamma_y = \\sum_{i=0}^{n-1}\\left(\\frac{y_i}{\\sigma_i^2}\\right),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\gamma_{xx} = \\sum_{i=0}^{n-1}\\frac{x_ix_{i}}{\\sigma_i^2},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\gamma_{xy} = \\sum_{i=0}^{n-1}\\frac{y_ix_{i}}{\\sigma_i^2},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "we obtain" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\beta_0 = \\frac{\\gamma_{xx}\\gamma_y-\\gamma_x\\gamma_y}{\\gamma\\gamma_{xx}-\\gamma_x^2},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\beta_1 = \\frac{\\gamma_{xy}\\gamma-\\gamma_x\\gamma_y}{\\gamma\\gamma_{xx}-\\gamma_x^2}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "This approach (different linear and non-linear regression) suffers\n", - "often from both being underdetermined and overdetermined in the\n", - "unknown coefficients $\\beta_i$. A better approach is to use the\n", - "Singular Value Decomposition (SVD) method discussed below. Or using\n", - "Lasso and Ridge regression. See below.\n", - "\n", - "\n", - "### Fitting an Equation of State for Dense Nuclear Matter\n", - "\n", - "Before we continue, let us introduce yet another example. We are going to fit the\n", - "nuclear equation of state using results from many-body calculations.\n", - "The equation of state we have made available here, as function of\n", - "density, has been derived using modern nucleon-nucleon potentials with\n", - "[the addition of three-body\n", - "forces](https://www.sciencedirect.com/science/article/pii/S0370157399001106). This\n", - "time the file is presented as a standard **csv** file.\n", - "\n", - "The beginning of the Python code here is similar to what you have seen\n", - "before, with the same initializations and declarations. We use also\n", - "**pandas** again, rather extensively in order to organize our data.\n", - "\n", - "The difference now is that we use **Scikit-Learn's** regression tools\n", - "instead of our own matrix inversion implementation." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "# Common imports\n", - "import os\n", - "import numpy as np\n", - "import pandas as pd\n", - "import matplotlib.pyplot as plt\n", - "import matplotlib.pyplot as plt\n", - "import sklearn.linear_model as skl\n", - "from sklearn.metrics import mean_squared_error, r2_score, mean_absolute_error\n", - "\n", - "# Where to save the figures and data files\n", - "PROJECT_ROOT_DIR = \"Results\"\n", - "FIGURE_ID = \"Results/FigureFiles\"\n", - "DATA_ID = \"DataFiles/\"\n", - "\n", - "if not os.path.exists(PROJECT_ROOT_DIR):\n", - " os.mkdir(PROJECT_ROOT_DIR)\n", - "\n", - "if not os.path.exists(FIGURE_ID):\n", - " os.makedirs(FIGURE_ID)\n", - "\n", - "if not os.path.exists(DATA_ID):\n", - " os.makedirs(DATA_ID)\n", - "\n", - "def image_path(fig_id):\n", - " return os.path.join(FIGURE_ID, fig_id)\n", - "\n", - "def data_path(dat_id):\n", - " return os.path.join(DATA_ID, dat_id)\n", - "\n", - "def save_fig(fig_id):\n", - " plt.savefig(image_path(fig_id) + \".png\", format='png')\n", - "\n", - "infile = open(data_path(\"EoS.csv\"),'r')\n", - "\n", - "# Read the EoS data as csv file and organize the data into two arrays with density and energies\n", - "EoS = pd.read_csv(infile, names=('Density', 'Energy'))\n", - "EoS['Energy'] = pd.to_numeric(EoS['Energy'], errors='coerce')\n", - "EoS = EoS.dropna()\n", - "Energies = EoS['Energy']\n", - "Density = EoS['Density']\n", - "# The design matrix now as function of various polytrops\n", - "X = np.zeros((len(Density),4))\n", - "X[:,3] = Density**(4.0/3.0)\n", - "X[:,2] = Density\n", - "X[:,1] = Density**(2.0/3.0)\n", - "X[:,0] = 1\n", - "\n", - "# We use now Scikit-Learn's linear regressor and ridge regressor\n", - "# OLS part\n", - "clf = skl.LinearRegression().fit(X, Energies)\n", - "ytilde = clf.predict(X)\n", - "EoS['Eols'] = ytilde\n", - "# The mean squared error \n", - "print(\"Mean squared error: %.2f\" % mean_squared_error(Energies, ytilde))\n", - "# Explained variance score: 1 is perfect prediction \n", - "print('Variance score: %.2f' % r2_score(Energies, ytilde))\n", - "# Mean absolute error \n", - "print('Mean absolute error: %.2f' % mean_absolute_error(Energies, ytilde))\n", - "print(clf.coef_, clf.intercept_)\n", - "\n", - "\n", - "fig, ax = plt.subplots()\n", - "ax.set_xlabel(r'$\\rho[\\mathrm{fm}^{-3}]$')\n", - "ax.set_ylabel(r'Energy per particle')\n", - "ax.plot(EoS['Density'], EoS['Energy'], alpha=0.7, lw=2,\n", - " label='Theoretical data')\n", - "ax.plot(EoS['Density'], EoS['Eols'], alpha=0.7, lw=2, c='m',\n", - " label='OLS')\n", - "ax.legend()\n", - "save_fig(\"EoSfitting\")\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The above simple polynomial in density $\\rho$ gives an excellent fit\n", - "to the data. \n", - "\n", - "\n", - "\n", - "## Splitting our Data in Training and Test data\n", - "\n", - "\n", - "It is normal in essentially all Machine Learning studies to split the\n", - "data in a training set and a test set (sometimes also an additional\n", - "validation set). **Scikit-Learn** has an own function for this. There\n", - "is no explicit recipe for how much data should be included as training\n", - "data and say test data. An accepted rule of thumb is to use\n", - "approximately $2/3$ to $4/5$ of the data as training data. We will\n", - "postpone a discussion of this splitting to the end of these notes and\n", - "our discussion of the so-called **bias-variance** tradeoff. Here we\n", - "limit ourselves to repeat the above equation of state fitting example\n", - "but now splitting the data into a training set and a test set.\n", - "\n", - "Let us study some examples. The first code here takes a simple\n", - "one-dimensional second-order polynomial and we fit it to a\n", - "second-order polynomial. Depending on the strength of the added noise,\n", - "the various measures like the $R2$ score or the mean-squared error,\n", - "the fit becomes better or worse." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import os\n", - "import numpy as np\n", - "import pandas as pd\n", - "import matplotlib.pyplot as plt\n", - "from sklearn.model_selection import train_test_split\n", - "\n", - "\n", - "def R2(y_data, y_model):\n", - " return 1 - np.sum((y_data - y_model) ** 2) / np.sum((y_data - np.mean(y_data)) ** 2)\n", - "def MSE(y_data,y_model):\n", - " n = np.size(y_model)\n", - " return np.sum((y_data-y_model)**2)/n\n", - "\n", - "x = np.random.rand(100)\n", - "y = 2.0+5*x*x+0.1*np.random.randn(100)\n", - "\n", - "\n", - "# The design matrix now as function of a given polynomial\n", - "X = np.zeros((len(x),3))\n", - "X[:,0] = 1.0\n", - "X[:,1] = x\n", - "X[:,2] = x**2\n", - "# We split the data in test and training data\n", - "X_train, X_test, y_train, y_test = train_test_split(X, y, test_size=0.2)\n", - "# matrix inversion to find beta\n", - "beta = np.linalg.inv(X_train.T @ X_train) @ X_train.T @ y_train\n", - "print(beta)\n", - "# and then make the prediction\n", - "ytilde = X_train @ beta\n", - "print(\"Training R2\")\n", - "print(R2(y_train,ytilde))\n", - "print(\"Training MSE\")\n", - "print(MSE(y_train,ytilde))\n", - "ypredict = X_test @ beta\n", - "print(\"Test R2\")\n", - "print(R2(y_test,ypredict))\n", - "print(\"Test MSE\")\n", - "print(MSE(y_test,ypredict))" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Alternatively, you could write your own test-train splitting function as shown here." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "# 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" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "But since **scikit-learn** has its own function for doing this and since\n", - "it interfaces easily with **tensorflow** and other libraries, we\n", - "normally recommend using the latter functionality.\n", - "\n", - "\n", - "As another example, we apply the training and testing split to \n", - "to the above equation of state fitting example\n", - "but now splitting the data into a training set and a test set." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import os\n", - "import numpy as np\n", - "import pandas as pd\n", - "import matplotlib.pyplot as plt\n", - "from sklearn.model_selection import train_test_split\n", - "# Where to save the figures and data files\n", - "PROJECT_ROOT_DIR = \"Results\"\n", - "FIGURE_ID = \"Results/FigureFiles\"\n", - "DATA_ID = \"DataFiles/\"\n", - "\n", - "if not os.path.exists(PROJECT_ROOT_DIR):\n", - " os.mkdir(PROJECT_ROOT_DIR)\n", - "\n", - "if not os.path.exists(FIGURE_ID):\n", - " os.makedirs(FIGURE_ID)\n", - "\n", - "if not os.path.exists(DATA_ID):\n", - " os.makedirs(DATA_ID)\n", - "\n", - "def image_path(fig_id):\n", - " return os.path.join(FIGURE_ID, fig_id)\n", - "\n", - "def data_path(dat_id):\n", - " return os.path.join(DATA_ID, dat_id)\n", - "\n", - "def save_fig(fig_id):\n", - " plt.savefig(image_path(fig_id) + \".png\", format='png')\n", - "\n", - "def R2(y_data, y_model):\n", - " return 1 - np.sum((y_data - y_model) ** 2) / np.sum((y_data - np.mean(y_data)) ** 2)\n", - "def MSE(y_data,y_model):\n", - " n = np.size(y_model)\n", - " return np.sum((y_data-y_model)**2)/n\n", - "\n", - "infile = open(data_path(\"EoS.csv\"),'r')\n", - "\n", - "# Read the EoS data as csv file and organized into two arrays with density and energies\n", - "EoS = pd.read_csv(infile, names=('Density', 'Energy'))\n", - "EoS['Energy'] = pd.to_numeric(EoS['Energy'], errors='coerce')\n", - "EoS = EoS.dropna()\n", - "Energies = EoS['Energy']\n", - "Density = EoS['Density']\n", - "# The design matrix now as function of various polytrops\n", - "X = np.zeros((len(Density),5))\n", - "X[:,0] = 1\n", - "X[:,1] = Density**(2.0/3.0)\n", - "X[:,2] = Density\n", - "X[:,3] = Density**(4.0/3.0)\n", - "X[:,4] = Density**(5.0/3.0)\n", - "# We split the data in test and training data\n", - "X_train, X_test, y_train, y_test = train_test_split(X, Energies, test_size=0.2)\n", - "# matrix inversion to find beta\n", - "beta = np.linalg.inv(X_train.T.dot(X_train)).dot(X_train.T).dot(y_train)\n", - "# and then make the prediction\n", - "ytilde = X_train @ beta\n", - "print(\"Training R2\")\n", - "print(R2(y_train,ytilde))\n", - "print(\"Training MSE\")\n", - "print(MSE(y_train,ytilde))\n", - "ypredict = X_test @ beta\n", - "print(\"Test R2\")\n", - "print(R2(y_test,ypredict))\n", - "print(\"Test MSE\")\n", - "print(MSE(y_test,ypredict))" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## The Boston housing data example\n", - "\n", - "The Boston housing \n", - "data set was originally a part of UCI Machine Learning Repository\n", - "and has been removed now. The data set is now included in **Scikit-Learn**'s \n", - "library. There are 506 samples and 13 feature (predictor) variables\n", - "in this data set. The objective is to predict the value of prices of\n", - "the house using the features (predictors) listed here.\n", - "\n", - "The features/predictors are\n", - "1. CRIM: Per capita crime rate by town\n", - "\n", - "2. ZN: Proportion of residential land zoned for lots over 25000 square feet\n", - "\n", - "3. INDUS: Proportion of non-retail business acres per town\n", - "\n", - "4. CHAS: Charles River dummy variable (= 1 if tract bounds river; 0 otherwise)\n", - "\n", - "5. NOX: Nitric oxide concentration (parts per 10 million)\n", - "\n", - "6. RM: Average number of rooms per dwelling\n", - "\n", - "7. AGE: Proportion of owner-occupied units built prior to 1940\n", - "\n", - "8. DIS: Weighted distances to five Boston employment centers\n", - "\n", - "9. RAD: Index of accessibility to radial highways\n", - "\n", - "10. TAX: Full-value property tax rate per USD10000\n", - "\n", - "11. B: $1000(Bk - 0.63)^2$, where $Bk$ is the proportion of [people of African American descent] by town\n", - "\n", - "12. LSTAT: Percentage of lower status of the population\n", - "\n", - "13. MEDV: Median value of owner-occupied homes in USD 1000s\n", - "\n", - "## Housing data, the code\n", - "We start by importing the libraries" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import numpy as np\n", - "import matplotlib.pyplot as plt \n", - "\n", - "import pandas as pd \n", - "import seaborn as sns" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and load the Boston Housing DataSet from **Scikit-Learn**" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "from sklearn.datasets import load_boston\n", - "\n", - "boston_dataset = load_boston()\n", - "\n", - "# boston_dataset is a dictionary\n", - "# let's check what it contains\n", - "boston_dataset.keys()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Then we invoke Pandas" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "boston = pd.DataFrame(boston_dataset.data, columns=boston_dataset.feature_names)\n", - "boston.head()\n", - "boston['MEDV'] = boston_dataset.target" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and preprocess the data" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "# check for missing values in all the columns\n", - "boston.isnull().sum()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We can then visualize the data" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "# set the size of the figure\n", - "sns.set(rc={'figure.figsize':(11.7,8.27)})\n", - "\n", - "# plot a histogram showing the distribution of the target values\n", - "sns.distplot(boston['MEDV'], bins=30)\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "It is now useful to look at the correlation matrix" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "# compute the pair wise correlation for all columns \n", - "correlation_matrix = boston.corr().round(2)\n", - "# use the heatmap function from seaborn to plot the correlation matrix\n", - "# annot = True to print the values inside the square\n", - "sns.heatmap(data=correlation_matrix, annot=True)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "From the above coorelation plot we can see that **MEDV** is strongly correlated to **LSTAT** and **RM**. We see also that **RAD** and **TAX** are stronly correlated, but we don't include this in our features together to avoid multi-colinearity" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "plt.figure(figsize=(20, 5))\n", - "\n", - "features = ['LSTAT', 'RM']\n", - "target = boston['MEDV']\n", - "\n", - "for i, col in enumerate(features):\n", - " plt.subplot(1, len(features) , i+1)\n", - " x = boston[col]\n", - " y = target\n", - " plt.scatter(x, y, marker='o')\n", - " plt.title(col)\n", - " plt.xlabel(col)\n", - " plt.ylabel('MEDV')" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Now we start training our model" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "X = pd.DataFrame(np.c_[boston['LSTAT'], boston['RM']], columns = ['LSTAT','RM'])\n", - "Y = boston['MEDV']" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We split the data into training and test sets" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "from sklearn.model_selection import train_test_split\n", - "\n", - "# splits the training and test data set in 80% : 20%\n", - "# assign random_state to any value.This ensures consistency.\n", - "X_train, X_test, Y_train, Y_test = train_test_split(X, Y, test_size = 0.2, random_state=5)\n", - "print(X_train.shape)\n", - "print(X_test.shape)\n", - "print(Y_train.shape)\n", - "print(Y_test.shape)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Then we use the linear regression functionality from **Scikit-Learn**" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "from sklearn.linear_model import LinearRegression\n", - "from sklearn.metrics import mean_squared_error, r2_score\n", - "\n", - "lin_model = LinearRegression()\n", - "lin_model.fit(X_train, Y_train)\n", - "\n", - "# model evaluation for training set\n", - "\n", - "y_train_predict = lin_model.predict(X_train)\n", - "rmse = (np.sqrt(mean_squared_error(Y_train, y_train_predict)))\n", - "r2 = r2_score(Y_train, y_train_predict)\n", - "\n", - "print(\"The model performance for training set\")\n", - "print(\"--------------------------------------\")\n", - "print('RMSE is {}'.format(rmse))\n", - "print('R2 score is {}'.format(r2))\n", - "print(\"\\n\")\n", - "\n", - "# model evaluation for testing set\n", - "\n", - "y_test_predict = lin_model.predict(X_test)\n", - "# root mean square error of the model\n", - "rmse = (np.sqrt(mean_squared_error(Y_test, y_test_predict)))\n", - "\n", - "# r-squared score of the model\n", - "r2 = r2_score(Y_test, y_test_predict)\n", - "\n", - "print(\"The model performance for testing set\")\n", - "print(\"--------------------------------------\")\n", - "print('RMSE is {}'.format(rmse))\n", - "print('R2 score is {}'.format(r2))" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "# plotting the y_test vs y_pred\n", - "# ideally should have been a straight line\n", - "plt.scatter(Y_test, y_test_predict)\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Reducing the number of degrees of freedom, overarching view\n", - "\n", - "Many Machine Learning problems involve thousands or even millions of\n", - "features for each training instance. Not only does this make training\n", - "extremely slow, it can also make it much harder to find a good\n", - "solution, as we will see. This problem is often referred to as the\n", - "curse of dimensionality. Fortunately, in real-world problems, it is\n", - "often possible to reduce the number of features considerably, turning\n", - "an intractable problem into a tractable one.\n", - "\n", - "Later we will discuss some of the most popular dimensionality reduction\n", - "techniques: the principal component analysis (PCA), Kernel PCA, and\n", - "Locally Linear Embedding (LLE). \n", - "\n", - "\n", - "Principal component analysis and its various variants deal with the\n", - "problem of fitting a low-dimensional [affine\n", - "subspace](https://en.wikipedia.org/wiki/Affine_space) to a set of of\n", - "data points in a high-dimensional space. With its family of methods it\n", - "is one of the most used tools in data modeling, compression and\n", - "visualization.\n", - "\n", - "\n", - "\n", - "Before we proceed however, we will discuss how to preprocess our\n", - "data. Till now and in connection with our previous examples we have\n", - "not met so many cases where we are too sensitive to the scaling of our\n", - "data. Normally the data may need a rescaling and/or may be sensitive\n", - "to extreme values. Scaling the data renders our inputs much more\n", - "suitable for the algorithms we want to employ.\n", - "\n", - "For data sets gathered for real world applications, it is rather normal that\n", - "different features have very different units and\n", - "numerical scales. For example, a data set detailing health habits may include\n", - "features such as **age** in the range $0-80$, and **caloric intake** of order $2000$.\n", - "Many machine learning methods sensitive to the scales of the features and may perform poorly if they\n", - "are very different scales. Therefore, it is typical to scale\n", - "the features in a way to avoid such outlier values.\n", - "\n", - "\n", - "**Scikit-Learn** has several functions which allow us to rescale the\n", - "data, normally resulting in much better results in terms of various\n", - "accuracy scores. The **StandardScaler** function in **Scikit-Learn**\n", - "ensures that for each feature/predictor we study the mean value is\n", - "zero and the variance is one (every column in the design/feature\n", - "matrix). This scaling has the drawback that it does not ensure that\n", - "we have a particular maximum or minimum in our data set. Another\n", - "function included in **Scikit-Learn** is the **MinMaxScaler** which\n", - "ensures that all features are exactly between $0$ and $1$. The\n", - "\n", - "\n", - "The **Normalizer** scales each data\n", - "point such that the feature vector has a euclidean length of one. In other words, it\n", - "projects a data point on the circle (or sphere in the case of higher dimensions) with a\n", - "radius of 1. This means every data point is scaled by a different number (by the\n", - "inverse of it’s length).\n", - "This normalization is often used when only the direction (or angle) of the data matters,\n", - "not the length of the feature vector.\n", - "\n", - "The **RobustScaler** works similarly to the StandardScaler in that it\n", - "ensures statistical properties for each feature that guarantee that\n", - "they are on the same scale. However, the RobustScaler uses the median\n", - "and quartiles, instead of mean and variance. This makes the\n", - "RobustScaler ignore data points that are very different from the rest\n", - "(like measurement errors). These odd data points are also called\n", - "outliers, and might often lead to trouble for other scaling\n", - "techniques.\n", - "\n", - "\n", - "Many features are often scaled using standardization to improve\n", - "performance. In **Scikit-Learn** this is given by the **StandardScaler**\n", - "function as discussed above. It is easy however to write your own.\n", - "Mathematically, this involves subtracting the mean and divide by the\n", - "standard deviation over the data set, for each feature:" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "x_j^{(i)} \\rightarrow \\frac{x_j^{(i)} - \\overline{x}_j}{\\sigma(x_j)},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $\\overline{x}_j$ and $\\sigma(x_j)$ are the mean and standard\n", - "deviation, respectively, of the feature $x_j$. This ensures that each\n", - "feature has zero mean and unit standard deviation. For data sets\n", - "where we do not have the standard deviation or don't wish to calculate\n", - "it, it is then common to simply set it to one.\n", - "\n", - "\n", - "\n", - "Let us consider the following vanilla example where we use both\n", - "**Scikit-Learn** and write our own function as well. We produce a\n", - "simple test design matrix with random numbers. Each column could then\n", - "represent a specific feature whose mean value is subracted." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import sklearn.linear_model as skl\n", - "from sklearn.metrics import mean_squared_error\n", - "from sklearn.model_selection import train_test_split\n", - "from sklearn.preprocessing import MinMaxScaler, StandardScaler, Normalizer\n", - "import numpy as np\n", - "import pandas as pd\n", - "from IPython.display import display\n", - "np.random.seed(100)\n", - "# setting up a 10 x 5 matrix\n", - "rows = 10\n", - "cols = 5\n", - "X = np.random.randn(rows,cols)\n", - "XPandas = pd.DataFrame(X)\n", - "display(XPandas)\n", - "print(XPandas.mean())\n", - "print(XPandas.std())\n", - "XPandas = (XPandas -XPandas.mean())\n", - "display(XPandas)\n", - "# This option does not include the standard deviation\n", - "scaler = StandardScaler(with_std=False)\n", - "scaler.fit(X)\n", - "Xscaled = scaler.transform(X)\n", - "display(XPandas-Xscaled)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Small exercise: perform the standard scaling by including the standard deviation and compare with what Scikit-Learn gives.\n", - "\n", - "\n", - "\n", - "Another commonly used scaling method is min-max scaling. This is very\n", - "useful for when we want the features to lie in a certain interval. To\n", - "scale the feature $x_j$ to the interval $[a, b]$, we can apply the\n", - "transformation" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "x_j^{(i)} \\rightarrow (b-a)\\frac{x_j^{(i)} - \\min(x_j)}{\\max(x_j) - \\min(x_j)} - a\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $\\min(x_j)$ and $\\max(x_j)$ return the minimum and maximum value of $x_j$ over the data set, respectively.\n", - "\n", - "\n", - "\n", - "\n", - "## Testing the Means Squared Error as function of Complexity\n", - "\n", - "\n", - "Before we proceed with a more detailed analysis of the so-called\n", - "Bias-Variance tradeoff, we present here an example of the relation\n", - "between model complexity and the mean squared error for the triaining\n", - "data and the test data.\n", - "\n", - "The results here tell us clearly that for the data not included in the\n", - "training, there is an optimal model as function of the complexity of\n", - "ourmodel (here in terms of the polynomial degree of the model).\n", - "\n", - "The results here will vary as function of model complexity and the amount od data used for training. \n", - "\n", - "\n", - "Our data is defined by $x\\in [-3,3]$ with a total of for example $100$ data points." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import matplotlib.pyplot as plt\n", - "import numpy as np\n", - "from sklearn.linear_model import LinearRegression, Ridge, Lasso\n", - "from sklearn.preprocessing import PolynomialFeatures\n", - "from sklearn.model_selection import train_test_split\n", - "from sklearn.pipeline import make_pipeline\n", - "\n", - "\n", - "np.random.seed(2018)\n", - "n = 100\n", - "maxdegree = 14\n", - "# Make data set.\n", - "x = np.linspace(-3, 3, n).reshape(-1, 1)\n", - "y = np.exp(-x**2) + 1.5 * np.exp(-(x-2)**2)+ np.random.normal(0, 0.1, x.shape)\n", - "TestError = np.zeros(maxdegree)\n", - "TrainError = np.zeros(maxdegree)\n", - "polydegree = np.zeros(maxdegree)\n", - "x_train, x_test, y_train, y_test = train_test_split(x, y, test_size=0.2)\n", - "\n", - "\n", - "for degree in range(maxdegree):\n", - " model = make_pipeline(PolynomialFeatures(degree=degree), LinearRegression(fit_intercept=False))\n", - " clf = model.fit(x_train,y_train)\n", - " y_fit = clf.predict(x_train)\n", - " y_pred = clf.predict(x_test) \n", - " polydegree[degree] = degree\n", - " TestError[degree] = np.mean( np.mean((y_test - y_pred)**2) )\n", - " TrainError[degree] = np.mean( np.mean((y_train - y_fit)**2) )\n", - "\n", - "plt.plot(polydegree, TestError, label='Test Error')\n", - "plt.plot(polydegree, TrainError, label='Train Error')\n", - "plt.legend()\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Exercises\n", - "\n", - "### Exercise: Setting up various Python environments\n", - "\n", - "The first exercise here is of a mere technical art. We want you to have \n", - "* git as a version control software and to establish a user account on a provider like GitHub. Other providers like GitLab etc are equally fine. You can also use the University of Oslo [GitHub facilities](https://www.uio.no/tjenester/it/maskin/filer/versjonskontroll/github.html). \n", - "\n", - "* Install various Python packages\n", - "\n", - "We will make extensive use of Python as programming language and its\n", - "myriad of available libraries. You will find\n", - "IPython/Jupyter notebooks invaluable in your work. You can run **R**\n", - "codes in the Jupyter/IPython notebooks, with the immediate benefit of\n", - "visualizing your data. You can also use compiled languages like C++,\n", - "Rust, Fortran etc if you prefer. The focus in these lectures will be\n", - "on Python.\n", - "\n", - "If you have Python installed (we recommend Python3) and you feel\n", - "pretty familiar with installing different packages, we recommend that\n", - "you install the following Python packages via **pip** as \n", - "\n", - "1. pip install numpy scipy matplotlib ipython scikit-learn sympy pandas pillow \n", - "\n", - "For **Tensorflow**, we recommend following the instructions in the text of \n", - "[Aurelien Geron, Hands‑On Machine Learning with Scikit‑Learn and TensorFlow, O'Reilly](http://shop.oreilly.com/product/0636920052289.do)\n", - "\n", - "We will come back to **tensorflow** later. \n", - "\n", - "For Python3, replace **pip** with **pip3**.\n", - "\n", - "For OSX users we recommend, after having installed Xcode, to\n", - "install **brew**. Brew allows for a seamless installation of additional\n", - "software via for example \n", - "\n", - "1. brew install python3\n", - "\n", - "For Linux users, with its variety of distributions like for example the widely popular Ubuntu distribution,\n", - "you can use **pip** as well and simply install Python as \n", - "\n", - "1. sudo apt-get install python3 (or python for Python2.7)\n", - "\n", - "If you don't want to perform these operations separately and venture\n", - "into the hassle of exploring how to set up dependencies and paths, we\n", - "recommend two widely used distrubutions which set up all relevant\n", - "dependencies for Python, namely \n", - "\n", - "* [Anaconda](https://docs.anaconda.com/), \n", - "\n", - "which is an open source\n", - "distribution of the Python and R programming languages for large-scale\n", - "data processing, predictive analytics, and scientific computing, that\n", - "aims to simplify package management and deployment. Package versions\n", - "are managed by the package management system **conda**. \n", - "\n", - "* [Enthought canopy](https://www.enthought.com/product/canopy/) \n", - "\n", - "is a Python\n", - "distribution for scientific and analytic computing distribution and\n", - "analysis environment, available for free and under a commercial\n", - "license.\n", - "\n", - "We recommend using **Anaconda** if you are not too familiar with setting paths in a terminal environment.\n", - "\n", - "\n", - "\n", - "\n", - "### Exercise: making your own data and exploring scikit-learn\n", - "\n", - "We will generate our own dataset for a function $y(x)$ where $x \\in [0,1]$ and defined by random numbers computed with the uniform distribution. The function $y$ is a quadratic polynomial in $x$ with added stochastic noise according to the normal distribution $\\cal {N}(0,1)$.\n", - "The following simple Python instructions define our $x$ and $y$ values (with 100 data points)." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "x = np.random.rand(100,1)\n", - "y = 2.0+5*x*x+0.1*np.random.randn(100,1)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "1. Write your own code (following the examples under the [regression notes](https://compphysics.github.io/MachineLearning/doc/LectureNotes/_build/html/chapter1.html)) for computing the parametrization of the data set fitting a second-order polynomial. \n", - "\n", - "2. Use thereafter **scikit-learn** (see again the examples in the regression slides) and compare with your own code. \n", - "\n", - "3. Using scikit-learn, compute also the mean square error, a risk metric corresponding to the expected value of the squared (quadratic) error defined as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "MSE(\\boldsymbol{y},\\boldsymbol{\\tilde{y}}) = \\frac{1}{n}\n", - "\\sum_{i=0}^{n-1}(y_i-\\tilde{y}_i)^2,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and the $R^2$ score function.\n", - "If $\\tilde{\\boldsymbol{y}}_i$ is the predicted value of the $i-th$ sample and $y_i$ is the corresponding true value, then the score $R^2$ is defined as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "R^2(\\boldsymbol{y}, \\tilde{\\boldsymbol{y}}) = 1 - \\frac{\\sum_{i=0}^{n - 1} (y_i - \\tilde{y}_i)^2}{\\sum_{i=0}^{n - 1} (y_i - \\bar{y})^2},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where we have defined the mean value of $\\boldsymbol{y}$ as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\bar{y} = \\frac{1}{n} \\sum_{i=0}^{n - 1} y_i.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "You can use the functionality included in scikit-learn. If you feel for it, you can use your own program and define functions which compute the above two functions. \n", - "Discuss the meaning of these results. Try also to vary the coefficient in front of the added stochastic noise term and discuss the quality of the fits.\n", - "\n", - "\n", - "\n", - "\n", - "### Exercise: Normalizing our data\n", - "\n", - "A much used approach before starting to train the data is to preprocess our\n", - "data. Normally the data may need a rescaling and/or may be sensitive\n", - "to extreme values. Scaling the data renders our inputs much more\n", - "suitable for the algorithms we want to employ.\n", - "\n", - "**Scikit-Learn** has several functions which allow us to rescale the\n", - "data, normally resulting in much better results in terms of various\n", - "accuracy scores. The **StandardScaler** function in **Scikit-Learn**\n", - "ensures that for each feature/predictor we study the mean value is\n", - "zero and the variance is one (every column in the design/feature\n", - "matrix). This scaling has the drawback that it does not ensure that\n", - "we have a particular maximum or minimum in our data set. Another\n", - "function included in **Scikit-Learn** is the **MinMaxScaler** which\n", - "ensures that all features are exactly between $0$ and $1$. The\n", - "\n", - "\n", - "The **Normalizer** scales each data\n", - "point such that the feature vector has a euclidean length of one. In other words, it\n", - "projects a data point on the circle (or sphere in the case of higher dimensions) with a\n", - "radius of 1. This means every data point is scaled by a different number (by the\n", - "inverse of it’s length).\n", - "This normalization is often used when only the direction (or angle) of the data matters,\n", - "not the length of the feature vector.\n", - "\n", - "The **RobustScaler** works similarly to the StandardScaler in that it\n", - "ensures statistical properties for each feature that guarantee that\n", - "they are on the same scale. However, the RobustScaler uses the median\n", - "and quartiles, instead of mean and variance. This makes the\n", - "RobustScaler ignore data points that are very different from the rest\n", - "(like measurement errors). These odd data points are also called\n", - "outliers, and might often lead to trouble for other scaling\n", - "techniques.\n", - "\n", - "\n", - "It also common to split the data in a **training** set and a **testing** set. A typical split is to use $80\\%$ of the data for training and the rest\n", - "for testing. This can be done as follows with our design matrix $\\boldsymbol{X}$ and data $\\boldsymbol{y}$ (remember to import **scikit-learn**)" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "# split in training and test data\n", - "# X_train, X_test, y_train, y_test = train_test_split(X,y,test_size=0.2)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Then we can use the standard scaler to scale our data as" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "scaler = StandardScaler()\n", - "scaler.fit(X_train)\n", - "X_train_scaled = scaler.transform(X_train)\n", - "X_test_scaled = scaler.transform(X_test)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In this exercise we want you to to compute the MSE for the training\n", - "data and the test data as function of the complexity of a polynomial,\n", - "that is the degree of a given polynomial. We want you also to compute the $R2$ score as function of the complexity of the model for both training data and test data. You should also run the calculation with and without scaling. \n", - "\n", - "One of \n", - "the aims is to reproduce Figure 2.11 of [Hastie et al](https://github.com/CompPhysics/MLErasmus/blob/master/doc/Textbooks/elementsstat.pdf).\n", - "\n", - "\n", - "\n", - "Our data is defined by $x\\in [-3,3]$ with a total of for example $100$ data points." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "np.random.seed()\n", - "n = 100\n", - "maxdegree = 14\n", - "# Make data set.\n", - "x = np.linspace(-3, 3, n).reshape(-1, 1)\n", - "y = np.exp(-x**2) + 1.5 * np.exp(-(x-2)**2)+ np.random.normal(0, 0.1, x.shape)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $y$ is the function we want to fit with a given polynomial.\n", - "\n", - "\n", - "Write a first code which sets up a design matrix $X$ defined by a\n", - "fifth-order polynomial. Scale your data and split it in training and\n", - "test data.\n", - "\n", - "\n", - "\n", - "Perform an ordinary least squares and compute the means squared error\n", - "and the $R2$ factor for the training data and the test data, with and\n", - "without scaling.\n", - "\n", - "\n", - "\n", - "Add now a model which allows you to make polynomials up to degree\n", - "$15$. Perform a standard OLS fitting of the training data and compute\n", - "the MSE and $R2$ for the training and test data and plot both test and\n", - "training data MSE and $R2$ as functions of the polynomial\n", - "degree. Compare what you see with Figure 2.11 of Hastie et al. Comment\n", - "your results. For which polynomial degree do you find an optimal MSE\n", - "(smallest value)?" - ] - } - ], - "metadata": {}, - "nbformat": 4, - "nbformat_minor": 4 -} diff --git a/doc/LectureNotes/_build/html/_sources/chapter10.ipynb b/doc/LectureNotes/_build/html/_sources/chapter10.ipynb deleted file mode 100644 index cc65cfe33..000000000 --- a/doc/LectureNotes/_build/html/_sources/chapter10.ipynb +++ /dev/null @@ -1,2047 +0,0 @@ -{ - "cells": [ - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "# Building a Feed Forward Neural Network\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", - "\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", - "\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", - "\n", - "### The Softmax function\n", - "\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", - "\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": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "%matplotlib inline\n", - "\n", - "# 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": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "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", - "### 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", - "\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": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "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", - "\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": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "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", - "\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", - "\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": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "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", - "\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": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "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": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "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": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "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": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "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": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "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": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "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", - "\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": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "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)\n", - "(current release of CPU-only TensorFlow)" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "conda create -n tf tensorflow\n", - "conda activate tf" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "To install the current release of GPU TensorFlow" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "conda create -n tf-gpu tensorflow-gpu\n", - "conda activate tf-gpu" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "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 Anaconda installed you may run the following command" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "conda install keras" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "You can look up the [instructions here](https://keras.io/) for more information.\n", - "\n", - "We will to a large extent use **keras** in this course. \n", - "\n", - "\n", - "Let us look again at the MINST data set." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "# import necessary packages\n", - "import numpy as np\n", - "import matplotlib.pyplot as plt\n", - "import tensorflow as tf\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": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "from tensorflow.keras.layers import Input\n", - "from tensorflow.keras.models import Sequential #This allows appending layers to existing models\n", - "from tensorflow.keras.layers import Dense #This allows defining the characteristics of a particular layer\n", - "from tensorflow.keras import optimizers #This allows using whichever optimiser we want (sgd,adam,RMSprop)\n", - "from tensorflow.keras import regularizers #This allows using whichever regularizer we want (l1,l2,l1_l2)\n", - "from tensorflow.keras.utils import to_categorical #This allows using categorical cross entropy as the cost function\n", - "\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": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "\n", - "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)\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=regularizers.l2(lmbd)))\n", - " model.add(Dense(n_neurons_layer2, activation='sigmoid', kernel_regularizer=regularizers.l2(lmbd)))\n", - " model.add(Dense(n_categories, activation='softmax'))\n", - " \n", - " sgd = optimizers.SGD(lr=eta)\n", - " model.compile(loss='categorical_crossentropy', optimizer=sgd, metrics=['accuracy'])\n", - " \n", - " return model" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "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,\n", - " 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": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "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": [ - "## The Breast Cancer Data, now with Keras" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "\n", - "import tensorflow as tf\n", - "from tensorflow.keras.layers import Input\n", - "from tensorflow.keras.models import Sequential #This allows appending layers to existing models\n", - "from tensorflow.keras.layers import Dense #This allows defining the characteristics of a particular layer\n", - "from tensorflow.keras import optimizers #This allows using whichever optimiser we want (sgd,adam,RMSprop)\n", - "from tensorflow.keras import regularizers #This allows using whichever regularizer we want (l1,l2,l1_l2)\n", - "from tensorflow.keras.utils import to_categorical #This allows using categorical cross entropy as the cost function\n", - "import numpy as np\n", - "import matplotlib.pyplot as plt\n", - "import seaborn as sns\n", - "from sklearn.model_selection import train_test_split as splitter\n", - "from sklearn.datasets import load_breast_cancer\n", - "import pickle\n", - "import os \n", - "\n", - "\n", - "\"\"\"Load breast cancer dataset\"\"\"\n", - "\n", - "np.random.seed(0) #create same seed for random number every time\n", - "\n", - "cancer=load_breast_cancer() #Download breast cancer dataset\n", - "\n", - "inputs=cancer.data #Feature matrix of 569 rows (samples) and 30 columns (parameters)\n", - "outputs=cancer.target #Label array of 569 rows (0 for benign and 1 for malignant)\n", - "labels=cancer.feature_names[0:30]\n", - "\n", - "print('The content of the breast cancer dataset is:') #Print information about the datasets\n", - "print(labels)\n", - "print('-------------------------')\n", - "print(\"inputs = \" + str(inputs.shape))\n", - "print(\"outputs = \" + str(outputs.shape))\n", - "print(\"labels = \"+ str(labels.shape))\n", - "\n", - "x=inputs #Reassign the Feature and Label matrices to other variables\n", - "y=outputs\n", - "\n", - "#%% \n", - "\n", - "# Visualisation of dataset (for correlation analysis)\n", - "\n", - "plt.figure()\n", - "plt.scatter(x[:,0],x[:,2],s=40,c=y,cmap=plt.cm.Spectral)\n", - "plt.xlabel('Mean radius',fontweight='bold')\n", - "plt.ylabel('Mean perimeter',fontweight='bold')\n", - "plt.show()\n", - "\n", - "plt.figure()\n", - "plt.scatter(x[:,5],x[:,6],s=40,c=y, cmap=plt.cm.Spectral)\n", - "plt.xlabel('Mean compactness',fontweight='bold')\n", - "plt.ylabel('Mean concavity',fontweight='bold')\n", - "plt.show()\n", - "\n", - "\n", - "plt.figure()\n", - "plt.scatter(x[:,0],x[:,1],s=40,c=y,cmap=plt.cm.Spectral)\n", - "plt.xlabel('Mean radius',fontweight='bold')\n", - "plt.ylabel('Mean texture',fontweight='bold')\n", - "plt.show()\n", - "\n", - "plt.figure()\n", - "plt.scatter(x[:,2],x[:,1],s=40,c=y,cmap=plt.cm.Spectral)\n", - "plt.xlabel('Mean perimeter',fontweight='bold')\n", - "plt.ylabel('Mean compactness',fontweight='bold')\n", - "plt.show()\n", - "\n", - "\n", - "# Generate training and testing datasets\n", - "\n", - "#Select features relevant to classification (texture,perimeter,compactness and symmetery) \n", - "#and add to input matrix\n", - "\n", - "temp1=np.reshape(x[:,1],(len(x[:,1]),1))\n", - "temp2=np.reshape(x[:,2],(len(x[:,2]),1))\n", - "X=np.hstack((temp1,temp2)) \n", - "temp=np.reshape(x[:,5],(len(x[:,5]),1))\n", - "X=np.hstack((X,temp)) \n", - "temp=np.reshape(x[:,8],(len(x[:,8]),1))\n", - "X=np.hstack((X,temp)) \n", - "\n", - "X_train,X_test,y_train,y_test=splitter(X,y,test_size=0.1) #Split datasets into training and testing\n", - "\n", - "y_train=to_categorical(y_train) #Convert labels to categorical when using categorical cross entropy\n", - "y_test=to_categorical(y_test)\n", - "\n", - "del temp1,temp2,temp\n", - "\n", - "# %%\n", - "\n", - "# Define tunable parameters\"\n", - "\n", - "eta=np.logspace(-3,-1,3) #Define vector of learning rates (parameter to SGD optimiser)\n", - "lamda=0.01 #Define hyperparameter\n", - "n_layers=2 #Define number of hidden layers in the model\n", - "n_neuron=np.logspace(0,3,4,dtype=int) #Define number of neurons per layer\n", - "epochs=100 #Number of reiterations over the input data\n", - "batch_size=100 #Number of samples per gradient update\n", - "\n", - "# %%\n", - "\n", - "\"\"\"Define function to return Deep Neural Network model\"\"\"\n", - "\n", - "def NN_model(inputsize,n_layers,n_neuron,eta,lamda):\n", - " model=Sequential() \n", - " for i in range(n_layers): #Run loop to add hidden layers to the model\n", - " if (i==0): #First layer requires input dimensions\n", - " model.add(Dense(n_neuron,activation='relu',kernel_regularizer=regularizers.l2(lamda),input_dim=inputsize))\n", - " else: #Subsequent layers are capable of automatic shape inferencing\n", - " model.add(Dense(n_neuron,activation='relu',kernel_regularizer=regularizers.l2(lamda)))\n", - " model.add(Dense(2,activation='softmax')) #2 outputs - ordered and disordered (softmax for prob)\n", - " sgd=optimizers.SGD(lr=eta)\n", - " model.compile(loss='categorical_crossentropy',optimizer=sgd,metrics=['accuracy'])\n", - " return model\n", - "\n", - " \n", - "Train_accuracy=np.zeros((len(n_neuron),len(eta))) #Define matrices to store accuracy scores as a function\n", - "Test_accuracy=np.zeros((len(n_neuron),len(eta))) #of learning rate and number of hidden neurons for \n", - "\n", - "for i in range(len(n_neuron)): #run loops over hidden neurons and learning rates to calculate \n", - " for j in range(len(eta)): #accuracy scores \n", - " DNN_model=NN_model(X_train.shape[1],n_layers,n_neuron[i],eta[j],lamda)\n", - " DNN_model.fit(X_train,y_train,epochs=epochs,batch_size=batch_size,verbose=1)\n", - " Train_accuracy[i,j]=DNN_model.evaluate(X_train,y_train)[1]\n", - " Test_accuracy[i,j]=DNN_model.evaluate(X_test,y_test)[1]\n", - " \n", - "\n", - "def plot_data(x,y,data,title=None):\n", - "\n", - " # plot results\n", - " fontsize=16\n", - "\n", - "\n", - " fig = plt.figure()\n", - " ax = fig.add_subplot(111)\n", - " cax = ax.matshow(data, interpolation='nearest', vmin=0, vmax=1)\n", - " \n", - " cbar=fig.colorbar(cax)\n", - " cbar.ax.set_ylabel('accuracy (%)',rotation=90,fontsize=fontsize)\n", - " cbar.set_ticks([0,.2,.4,0.6,0.8,1.0])\n", - " cbar.set_ticklabels(['0%','20%','40%','60%','80%','100%'])\n", - "\n", - " # put text on matrix elements\n", - " for i, x_val in enumerate(np.arange(len(x))):\n", - " for j, y_val in enumerate(np.arange(len(y))):\n", - " c = \"${0:.1f}\\\\%$\".format( 100*data[j,i]) \n", - " ax.text(x_val, y_val, c, va='center', ha='center')\n", - "\n", - " # convert axis vaues to to string labels\n", - " x=[str(i) for i in x]\n", - " y=[str(i) for i in y]\n", - "\n", - "\n", - " ax.set_xticklabels(['']+x)\n", - " ax.set_yticklabels(['']+y)\n", - "\n", - " ax.set_xlabel('$\\\\mathrm{learning\\\\ rate}$',fontsize=fontsize)\n", - " ax.set_ylabel('$\\\\mathrm{hidden\\\\ neurons}$',fontsize=fontsize)\n", - " if title is not None:\n", - " ax.set_title(title)\n", - "\n", - " plt.tight_layout()\n", - "\n", - " plt.show()\n", - " \n", - "plot_data(eta,n_neuron,Train_accuracy, 'training')\n", - "plot_data(eta,n_neuron,Test_accuracy, 'testing')" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Fine-tuning neural network hyperparameters\n", - "\n", - "The flexibility of neural networks is also one of their main\n", - "drawbacks: there are many hyperparameters to tweak. Not only can you\n", - "use any imaginable network topology (how neurons/nodes are interconnected),\n", - "but even in a simple FFNN you can change the number of layers, the\n", - "number of neurons per layer, the type of activation function to use in\n", - "each layer, the weight initialization logic, the stochastic gradient optmized and much more. How do you\n", - "know what combination of hyperparameters is the best for your task?\n", - "\n", - "* You can use grid search with cross-validation to find the right hyperparameters.\n", - "\n", - "However,since there are many hyperparameters to tune, and since\n", - "training a neural network on a large dataset takes a lot of time, you\n", - "will only be able to explore a tiny part of the hyperparameter space.\n", - "\n", - "\n", - "* You can use randomized search.\n", - "\n", - "* Or use tools like [Oscar](http://oscar.calldesk.ai/), which implements more complex algorithms to help you find a good set of hyperparameters quickly. \n", - "\n", - "For many problems you can start with just one or two hidden layers and it will work just fine.\n", - "For the MNIST data set you ca easily get a high accuracy using just one hidden layer with a\n", - "few hundred neurons.\n", - "You can reach for this data set above 98% accuracy using two hidden layers with the same total amount of\n", - "neurons, in roughly the same amount of training time. \n", - "\n", - "For more complex problems, you can gradually\n", - "ramp up the number of hidden layers, until you start overfitting the training set. Very complex tasks, such\n", - "as large image classification or speech recognition, typically require networks with dozens of layers\n", - "and they need a huge amount\n", - "of training data. However, you will rarely have to train such networks from scratch: it is much more\n", - "common to reuse parts of a pretrained state-of-the-art network that performs a similar task.\n", - "\n", - "\n", - "\n", - "\n", - "\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", - "\n", - "\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", - "\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": [ - "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", - "\n", - "In most cases you can use the ReLU activation function in the hidden layers (or one of its variants).\n", - "\n", - "It is a bit faster to compute than other activation functions, and the gradient descent optimization does in general not get stuck.\n", - "\n", - "**For the output layer:**\n", - "\n", - "* For classification the softmax activation function is generally a good choice for classification tasks (when the classes are mutually exclusive).\n", - "\n", - "* For regression tasks, you can simply use no activation function at all.\n", - "\n", - "## Batch Normalization\n", - "\n", - "Batch Normalization\n", - "aims to address the vanishing/exploding gradients problems, and more generally the problem that the\n", - "distribution of each layer’s inputs changes during training, as the parameters of the previous layers change.\n", - "\n", - "The technique consists of adding an operation in the model just before the activation function of each\n", - "layer, simply zero-centering and normalizing the inputs, then scaling and shifting the result using two new\n", - "parameters per layer (one for scaling, the other for shifting). In other words, this operation lets the model\n", - "learn the optimal scale and mean of the inputs for each layer.\n", - "In order to zero-center and normalize the inputs, the algorithm needs to estimate the inputs’ mean and\n", - "standard deviation. It does so by evaluating the mean and standard deviation of the inputs over the current\n", - "mini-batch, from this the name batch normalization.\n", - "\n", - "## Dropout\n", - "\n", - "It is a fairly simple algorithm: at every training step, every neuron (including the input neurons but\n", - "excluding the output neurons) has a probability $p$ of being temporarily dropped out, meaning it will be\n", - "entirely ignored during this training step, but it may be active during the next step.\n", - "\n", - "The\n", - "hyperparameter $p$ is called the dropout rate, and it is typically set to 50%. After training, the neurons are not dropped anymore.\n", - " It is viewed as one of the most popular regularization techniques.\n", - "\n", - "## Gradient Clipping\n", - "\n", - "A popular technique to lessen the exploding gradients problem is to simply clip the gradients during\n", - "backpropagation so that they never exceed some threshold (this is mostly useful for recurrent neural\n", - "networks).\n", - "\n", - "This technique is called Gradient Clipping.\n", - "\n", - "In general however, Batch\n", - "Normalization is preferred.\n", - "\n", - "\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", - "\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": {}, - "nbformat": 4, - "nbformat_minor": 4 -} diff --git a/doc/LectureNotes/_build/html/_sources/chapter11.ipynb b/doc/LectureNotes/_build/html/_sources/chapter11.ipynb deleted file mode 100644 index c03e4a368..000000000 --- a/doc/LectureNotes/_build/html/_sources/chapter11.ipynb +++ /dev/null @@ -1,3023 +0,0 @@ -{ - "cells": [ - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "# Solving Differential Equations with Deep Learning\n", - "\n", - "The Universal Approximation Theorem states that a neural network can\n", - "approximate any function at a single hidden layer along with one input\n", - "and output layer to any given precision. \n", - "\n", - "\n", - "An ordinary differential equation (ODE) is an equation involving functions having one variable.\n", - "\n", - "In general, an ordinary differential equation looks like" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation} \\label{ode} \\tag{1}\n", - "f\\left(x, \\, g(x), \\, g'(x), \\, g''(x), \\, \\dots \\, , \\, g^{(n)}(x)\\right) = 0\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $g(x)$ is the function to find, and $g^{(n)}(x)$ is the $n$-th derivative of $g(x)$.\n", - "\n", - "The $f\\left(x, g(x), g'(x), g''(x), \\, \\dots \\, , g^{(n)}(x)\\right)$ is just a way to write that there is an expression involving $x$ and $g(x), \\ g'(x), \\ g''(x), \\, \\dots \\, , \\text{ and } g^{(n)}(x)$ on the left side of the equality sign in ([1](#ode)).\n", - "The highest order of derivative, that is the value of $n$, determines to the order of the equation.\n", - "The equation is referred to as a $n$-th order ODE.\n", - "Along with ([1](#ode)), some additional conditions of the function $g(x)$ are typically given\n", - "for the solution to be unique.\n", - "\n", - "\n", - "\n", - "Let the trial solution $g_t(x)$ be" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - "\tg_t(x) = h_1(x) + h_2(x,N(x,P))\n", - "\\label{_auto1} \\tag{2}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $h_1(x)$ is a function that makes $g_t(x)$ satisfy a given set\n", - "of conditions, $N(x,P)$ a neural network with weights and biases\n", - "described by $P$ and $h_2(x, N(x,P))$ some expression involving the\n", - "neural network. The role of the function $h_2(x, N(x,P))$, is to\n", - "ensure that the output from $N(x,P)$ is zero when $g_t(x)$ is\n", - "evaluated at the values of $x$ where the given conditions must be\n", - "satisfied. The function $h_1(x)$ should alone make $g_t(x)$ satisfy\n", - "the conditions.\n", - "\n", - "But what about the network $N(x,P)$?\n", - "\n", - "\n", - "As described previously, an optimization method could be used to minimize the parameters of a neural network, that being its weights and biases, through backward propagation.\n", - "\n", - "\n", - "\n", - "For the minimization to be defined, we need to have a cost function at hand to minimize.\n", - "\n", - "It is given that $f\\left(x, \\, g(x), \\, g'(x), \\, g''(x), \\, \\dots \\, , \\, g^{(n)}(x)\\right)$ should be equal to zero in ([1](#ode)).\n", - "We can choose to consider the mean squared error as the cost function for an input $x$.\n", - "Since we are looking at one input, the cost function is just $f$ squared.\n", - "The cost function $c\\left(x, P \\right)$ can therefore be expressed as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C\\left(x, P\\right) = \\big(f\\left(x, \\, g(x), \\, g'(x), \\, g''(x), \\, \\dots \\, , \\, g^{(n)}(x)\\right)\\big)^2\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "If $N$ inputs are given as a vector $\\boldsymbol{x}$ with elements $x_i$ for $i = 1,\\dots,N$,\n", - "the cost function becomes" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation} \\label{cost} \\tag{3}\n", - "\tC\\left(\\boldsymbol{x}, P\\right) = \\frac{1}{N} \\sum_{i=1}^N \\big(f\\left(x_i, \\, g(x_i), \\, g'(x_i), \\, g''(x_i), \\, \\dots \\, , \\, g^{(n)}(x_i)\\right)\\big)^2\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The neural net should then find the parameters $P$ that minimizes the cost function in\n", - "([3](#cost)) for a set of $N$ training samples $x_i$.\n", - "\n", - "\n", - "\n", - "To perform the minimization using gradient descent, the gradient of $C\\left(\\boldsymbol{x}, P\\right)$ is needed.\n", - "It might happen so that finding an analytical expression of the gradient of $C(\\boldsymbol{x}, P)$ from ([3](#cost)) gets too messy, depending on which cost function one desires to use.\n", - "\n", - "Luckily, there exists libraries that makes the job for us through automatic differentiation.\n", - "Automatic differentiation is a method of finding the derivatives numerically with very high precision.\n", - "\n", - "\n", - "### Example: Exponential decay\n", - "\n", - "An exponential decay of a quantity $g(x)$ is described by the equation" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation} \\label{solve_expdec} \\tag{4}\n", - " g'(x) = -\\gamma g(x)\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with $g(0) = g_0$ for some chosen initial value $g_0$.\n", - "\n", - "The analytical solution of ([4](#solve_expdec)) is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - " g(x) = g_0 \\exp\\left(-\\gamma x\\right)\n", - "\\label{_auto2} \\tag{5}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Having an analytical solution at hand, it is possible to use it to compare how well a neural network finds a solution of ([4](#solve_expdec)).\n", - "\n", - "\n", - "\n", - "The program will use a neural network to solve" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation} \\label{solveode} \\tag{6}\n", - "g'(x) = -\\gamma g(x)\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $g(0) = g_0$ with $\\gamma$ and $g_0$ being some chosen values.\n", - "\n", - "In this example, $\\gamma = 2$ and $g_0 = 10$.\n", - "\n", - "\n", - "To begin with, a trial solution $g_t(t)$ must be chosen. A general trial solution for ordinary differential equations could be" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "g_t(x, P) = h_1(x) + h_2(x, N(x, P))\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with $h_1(x)$ ensuring that $g_t(x)$ satisfies some conditions and $h_2(x,N(x, P))$ an expression involving $x$ and the output from the neural network $N(x,P)$ with $P $ being the collection of the weights and biases for each layer. For now, it is assumed that the network consists of one input layer, one hidden layer, and one output layer.\n", - "\n", - "\n", - "\n", - "In this network, there are no weights and bias at the input layer, so $P = \\{ P_{\\text{hidden}}, P_{\\text{output}} \\}$.\n", - "If there are $N_{\\text{hidden} }$ neurons in the hidden layer, then $P_{\\text{hidden}}$ is a $N_{\\text{hidden} } \\times (1 + N_{\\text{input}})$ matrix, given that there are $N_{\\text{input}}$ neurons in the input layer.\n", - "\n", - "The first column in $P_{\\text{hidden} }$ represents the bias for each neuron in the hidden layer and the second column represents the weights for each neuron in the hidden layer from the input layer.\n", - "If there are $N_{\\text{output} }$ neurons in the output layer, then $P_{\\text{output}} $ is a $N_{\\text{output} } \\times (1 + N_{\\text{hidden} })$ matrix.\n", - "\n", - "Its first column represents the bias of each neuron and the remaining columns represents the weights to each neuron.\n", - "\n", - "It is given that $g(0) = g_0$. The trial solution must fulfill this condition to be a proper solution of ([6](#solveode)). A possible way to ensure that $g_t(0, P) = g_0$, is to let $F(N(x,P)) = x \\cdot N(x,P)$ and $A(x) = g_0$. This gives the following trial solution:" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation} \\label{trial} \\tag{7}\n", - "g_t(x, P) = g_0 + x \\cdot N(x, P)\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "### Reformulating the problem\n", - "\n", - "We wish that our neural network manages to minimize a given cost function.\n", - "\n", - "A reformulation of out equation, ([6](#solveode)), must therefore be done,\n", - "such that it describes the problem a neural network can solve for.\n", - "\n", - "The neural network must find the set of weights and biases $P$ such that the trial solution in ([7](#trial)) satisfies ([6](#solveode)).\n", - "\n", - "The trial solution" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "g_t(x, P) = g_0 + x \\cdot N(x, P)\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "has been chosen such that it already solves the condition $g(0) = g_0$. What remains, is to find $P$ such that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation} \\label{nnmin} \\tag{8}\n", - "g_t'(x, P) = - \\gamma g_t(x, P)\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "is fulfilled as *best as possible*.\n", - "\n", - "\n", - "The left hand side and right hand side of ([8](#nnmin)) must be computed separately, and then the neural network must choose weights and biases, contained in $P$, such that the sides are equal as best as possible.\n", - "This means that the absolute or squared difference between the sides must be as close to zero, ideally equal to zero.\n", - "In this case, the difference squared shows to be an appropriate measurement of how erroneous the trial solution is with respect to $P$ of the neural network.\n", - "\n", - "This gives the following cost function our neural network must solve for:" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\min_{P}\\Big\\{ \\big(g_t'(x, P) - ( -\\gamma g_t(x, P) \\big)^2 \\Big\\}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "(the notation $\\min_{P}\\{ f(x, P) \\}$ means that we desire to find $P$ that yields the minimum of $f(x, P)$)\n", - "\n", - "or, in terms of weights and biases for the hidden and output layer in our network:" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\min_{P_{\\text{hidden} }, \\ P_{\\text{output} }}\\Big\\{ \\big(g_t'(x, \\{ P_{\\text{hidden} }, P_{\\text{output} }\\}) - ( -\\gamma g_t(x, \\{ P_{\\text{hidden} }, P_{\\text{output} }\\}) \\big)^2 \\Big\\}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "for an input value $x$.\n", - "\n", - "\n", - "\n", - "If the neural network evaluates $g_t(x, P)$ at more values for $x$, say $N$ values $x_i$ for $i = 1, \\dots, N$, then the *total* error to minimize becomes" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation} \\label{min} \\tag{9}\n", - "\\min_{P}\\Big\\{\\frac{1}{N} \\sum_{i=1}^N \\big(g_t'(x_i, P) - ( -\\gamma g_t(x_i, P) \\big)^2 \\Big\\}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Letting $\\boldsymbol{x}$ be a vector with elements $x_i$ and $C(\\boldsymbol{x}, P) = \\frac{1}{N} \\sum_i \\big(g_t'(x_i, P) - ( -\\gamma g_t(x_i, P) \\big)^2$ denote the cost function, the minimization problem that our network must solve, becomes" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\min_{P} C(\\boldsymbol{x}, P)\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In terms of $P_{\\text{hidden} }$ and $P_{\\text{output} }$, this could also be expressed as\n", - "\n", - "$$\n", - "\\min_{P_{\\text{hidden} }, \\ P_{\\text{output} }} C(\\boldsymbol{x}, \\{P_{\\text{hidden} }, P_{\\text{output} }\\})\n", - "$$\n", - "\n", - "\n", - "For simplicity, it is assumed that the input is an array $\\boldsymbol{x} = (x_1, \\dots, x_N)$ with $N$ elements. It is at these points the neural network should find $P$ such that it fulfills ([9](#min)).\n", - "\n", - "First, the neural network must feed forward the inputs.\n", - "This means that $\\boldsymbol{x}s$ must be passed through an input layer, a hidden layer and a output layer. The input layer in this case, does not need to process the data any further.\n", - "The input layer will consist of $N_{\\text{input} }$ neurons, passing its element to each neuron in the hidden layer. The number of neurons in the hidden layer will be $N_{\\text{hidden} }$.\n", - "\n", - "\n", - "For the $i$-th in the hidden layer with weight $w_i^{\\text{hidden} }$ and bias $b_i^{\\text{hidden} }$, the weighting from the $j$-th neuron at the input layer is:" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{aligned}\n", - "z_{i,j}^{\\text{hidden}} &= b_i^{\\text{hidden}} + w_i^{\\text{hidden}}x_j \\\\\n", - "&=\n", - "\\begin{pmatrix}\n", - "b_i^{\\text{hidden}} & w_i^{\\text{hidden}}\n", - "\\end{pmatrix}\n", - "\\begin{pmatrix}\n", - "1 \\\\\n", - "x_j\n", - "\\end{pmatrix}\n", - "\\end{aligned}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The result after weighting the inputs at the $i$-th hidden neuron can be written as a vector:" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{aligned}\n", - "\\boldsymbol{z}_{i}^{\\text{hidden}} &= \\Big( b_i^{\\text{hidden}} + w_i^{\\text{hidden}}x_1 , \\ b_i^{\\text{hidden}} + w_i^{\\text{hidden}} x_2, \\ \\dots \\, , \\ b_i^{\\text{hidden}} + w_i^{\\text{hidden}} x_N\\Big) \\\\\n", - "&=\n", - "\\begin{pmatrix}\n", - " b_i^{\\text{hidden}} & w_i^{\\text{hidden}}\n", - "\\end{pmatrix}\n", - "\\begin{pmatrix}\n", - "1 & 1 & \\dots & 1 \\\\\n", - "x_1 & x_2 & \\dots & x_N\n", - "\\end{pmatrix} \\\\\n", - "&= \\boldsymbol{p}_{i, \\text{hidden}}^T X\n", - "\\end{aligned}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The vector $\\boldsymbol{p}_{i, \\text{hidden}}^T$ constitutes each row in $P_{\\text{hidden} }$, which contains the weights for the neural network to minimize according to ([9](#min)).\n", - "\n", - "After having found $\\boldsymbol{z}_{i}^{\\text{hidden}} $ for every $i$-th neuron within the hidden layer, the vector will be sent to an activation function $a_i(\\boldsymbol{z})$.\n", - "\n", - "In this example, the sigmoid function has been chosen to be the activation function for each hidden neuron:" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "f(z) = \\frac{1}{1 + \\exp{(-z)}}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "It is possible to use other activations functions for the hidden layer also.\n", - "\n", - "The output $\\boldsymbol{x}_i^{\\text{hidden}}$ from each $i$-th hidden neuron is:\n", - "\n", - "$$\n", - "\\boldsymbol{x}_i^{\\text{hidden} } = f\\big( \\boldsymbol{z}_{i}^{\\text{hidden}} \\big)\n", - "$$\n", - "\n", - "The outputs $\\boldsymbol{x}_i^{\\text{hidden} } $ are then sent to the output layer.\n", - "\n", - "The output layer consists of one neuron in this case, and combines the\n", - "output from each of the neurons in the hidden layers. The output layer\n", - "combines the results from the hidden layer using some weights $w_i^{\\text{output}}$\n", - "and biases $b_i^{\\text{output}}$. In this case,\n", - "it is assumes that the number of neurons in the output layer is one.\n", - "\n", - "\n", - "\n", - "The procedure of weighting the output neuron $j$ in the hidden layer to the $i$-th neuron in the output layer is similar as for the hidden layer described previously." - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{aligned}\n", - "z_{1,j}^{\\text{output}} & =\n", - "\\begin{pmatrix}\n", - "b_1^{\\text{output}} & \\boldsymbol{w}_1^{\\text{output}}\n", - "\\end{pmatrix}\n", - "\\begin{pmatrix}\n", - "1 \\\\\n", - "\\boldsymbol{x}_j^{\\text{hidden}}\n", - "\\end{pmatrix}\n", - "\\end{aligned}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Expressing $z_{1,j}^{\\text{output}}$ as a vector gives the following way of weighting the inputs from the hidden layer:" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{z}_{1}^{\\text{output}} =\n", - "\\begin{pmatrix}\n", - "b_1^{\\text{output}} & \\boldsymbol{w}_1^{\\text{output}}\n", - "\\end{pmatrix}\n", - "\\begin{pmatrix}\n", - "1 & 1 & \\dots & 1 \\\\\n", - "\\boldsymbol{x}_1^{\\text{hidden}} & \\boldsymbol{x}_2^{\\text{hidden}} & \\dots & \\boldsymbol{x}_N^{\\text{hidden}}\n", - "\\end{pmatrix}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In this case we seek a continuous range of values since we are approximating a function. This means that after computing $\\boldsymbol{z}_{1}^{\\text{output}}$ the neural network has finished its feed forward step, and $\\boldsymbol{z}_{1}^{\\text{output}}$ is the final output of the network.\n", - "\n", - "\n", - "The next step is to decide how the parameters should be changed such that they minimize the cost function.\n", - "\n", - "The chosen cost function for this problem is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(\\boldsymbol{x}, P) = \\frac{1}{N} \\sum_i \\big(g_t'(x_i, P) - ( -\\gamma g_t(x_i, P) \\big)^2\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In order to minimize the cost function, an optimization method must be chosen.\n", - "\n", - "Here, gradient descent with a constant step size has been chosen.\n", - "\n", - "### Gradient descent\n", - "\n", - "The idea of the gradient descent algorithm is to update parameters in\n", - "a direction where the cost function decreases goes to a minimum.\n", - "\n", - "In general, the update of some parameters $\\boldsymbol{\\omega}$ given a cost\n", - "function defined by some weights $\\boldsymbol{\\omega}$, $C(\\boldsymbol{x},\n", - "\\boldsymbol{\\omega})$, goes as follows:" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{\\omega}_{\\text{new} } = \\boldsymbol{\\omega} - \\lambda \\nabla_{\\boldsymbol{\\omega}} C(\\boldsymbol{x}, \\boldsymbol{\\omega})\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "for a number of iterations or until $ \\big|\\big| \\boldsymbol{\\omega}_{\\text{new} } - \\boldsymbol{\\omega} \\big|\\big|$ becomes smaller than some given tolerance.\n", - "\n", - "The value of $\\lambda$ decides how large steps the algorithm must take\n", - "in the direction of $ \\nabla_{\\boldsymbol{\\omega}} C(\\boldsymbol{x}, \\boldsymbol{\\omega})$.\n", - "The notation $\\nabla_{\\boldsymbol{\\omega}}$ express the gradient with respect\n", - "to the elements in $\\boldsymbol{\\omega}$.\n", - "\n", - "In our case, we have to minimize the cost function $C(\\boldsymbol{x}, P)$ with\n", - "respect to the two sets of weights and biases, that is for the hidden\n", - "layer $P_{\\text{hidden} }$ and for the output layer $P_{\\text{output}\n", - "}$ .\n", - "\n", - "This means that $P_{\\text{hidden} }$ and $P_{\\text{output} }$ is updated by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{aligned}\n", - "P_{\\text{hidden},\\text{new}} &= P_{\\text{hidden}} - \\lambda \\nabla_{P_{\\text{hidden}}} C(\\boldsymbol{x}, P) \\\\\n", - "P_{\\text{output},\\text{new}} &= P_{\\text{output}} - \\lambda \\nabla_{P_{\\text{output}}} C(\\boldsymbol{x}, P)\n", - "\\end{aligned}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "### The code for solving the ODE" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "%matplotlib inline\n", - "\n", - "import autograd.numpy as np\n", - "from autograd import grad, elementwise_grad\n", - "import autograd.numpy.random as npr\n", - "from matplotlib import pyplot as plt\n", - "\n", - "def sigmoid(z):\n", - " return 1/(1 + np.exp(-z))\n", - "\n", - "# Assuming one input, hidden, and output layer\n", - "def neural_network(params, x):\n", - "\n", - " # Find the weights (including and biases) for the hidden and output layer.\n", - " # Assume that params is a list of parameters for each layer.\n", - " # The biases are the first element for each array in params,\n", - " # and the weights are the remaning elements in each array in params.\n", - "\n", - " w_hidden = params[0]\n", - " w_output = params[1]\n", - "\n", - " # Assumes input x being an one-dimensional array\n", - " num_values = np.size(x)\n", - " x = x.reshape(-1, num_values)\n", - "\n", - " # Assume that the input layer does nothing to the input x\n", - " x_input = x\n", - "\n", - " ## Hidden layer:\n", - "\n", - " # Add a row of ones to include bias\n", - " x_input = np.concatenate((np.ones((1,num_values)), x_input ), axis = 0)\n", - "\n", - " z_hidden = np.matmul(w_hidden, x_input)\n", - " x_hidden = sigmoid(z_hidden)\n", - "\n", - " ## Output layer:\n", - "\n", - " # Include bias:\n", - " x_hidden = np.concatenate((np.ones((1,num_values)), x_hidden ), axis = 0)\n", - "\n", - " z_output = np.matmul(w_output, x_hidden)\n", - " x_output = z_output\n", - "\n", - " return x_output\n", - "\n", - "# The trial solution using the deep neural network:\n", - "def g_trial(x,params, g0 = 10):\n", - " return g0 + x*neural_network(params,x)\n", - "\n", - "# The right side of the ODE:\n", - "def g(x, g_trial, gamma = 2):\n", - " return -gamma*g_trial\n", - "\n", - "# The cost function:\n", - "def cost_function(P, x):\n", - "\n", - " # Evaluate the trial function with the current parameters P\n", - " g_t = g_trial(x,P)\n", - "\n", - " # Find the derivative w.r.t x of the neural network\n", - " d_net_out = elementwise_grad(neural_network,1)(P,x)\n", - "\n", - " # Find the derivative w.r.t x of the trial function\n", - " d_g_t = elementwise_grad(g_trial,0)(x,P)\n", - "\n", - " # The right side of the ODE\n", - " func = g(x, g_t)\n", - "\n", - " err_sqr = (d_g_t - func)**2\n", - " cost_sum = np.sum(err_sqr)\n", - "\n", - " return cost_sum / np.size(err_sqr)\n", - "\n", - "# Solve the exponential decay ODE using neural network with one input, hidden, and output layer\n", - "def solve_ode_neural_network(x, num_neurons_hidden, num_iter, lmb):\n", - " ## Set up initial weights and biases\n", - "\n", - " # For the hidden layer\n", - " p0 = npr.randn(num_neurons_hidden, 2 )\n", - "\n", - " # For the output layer\n", - " p1 = npr.randn(1, num_neurons_hidden + 1 ) # +1 since bias is included\n", - "\n", - " P = [p0, p1]\n", - "\n", - " print('Initial cost: %g'%cost_function(P, x))\n", - "\n", - " ## Start finding the optimal weights using gradient descent\n", - "\n", - " # Find the Python function that represents the gradient of the cost function\n", - " # w.r.t the 0-th input argument -- that is the weights and biases in the hidden and output layer\n", - " cost_function_grad = grad(cost_function,0)\n", - "\n", - " # Let the update be done num_iter times\n", - " for i in range(num_iter):\n", - " # Evaluate the gradient at the current weights and biases in P.\n", - " # The cost_grad consist now of two arrays;\n", - " # one for the gradient w.r.t P_hidden and\n", - " # one for the gradient w.r.t P_output\n", - " cost_grad = cost_function_grad(P, x)\n", - "\n", - " P[0] = P[0] - lmb * cost_grad[0]\n", - " P[1] = P[1] - lmb * cost_grad[1]\n", - "\n", - " print('Final cost: %g'%cost_function(P, x))\n", - "\n", - " return P\n", - "\n", - "def g_analytic(x, gamma = 2, g0 = 10):\n", - " return g0*np.exp(-gamma*x)\n", - "\n", - "# Solve the given problem\n", - "if __name__ == '__main__':\n", - " # Set seed such that the weight are initialized\n", - " # with same weights and biases for every run.\n", - " npr.seed(15)\n", - "\n", - " ## Decide the vales of arguments to the function to solve\n", - " N = 10\n", - " x = np.linspace(0, 1, N)\n", - "\n", - " ## Set up the initial parameters\n", - " num_hidden_neurons = 10\n", - " num_iter = 10000\n", - " lmb = 0.001\n", - "\n", - " # Use the network\n", - " P = solve_ode_neural_network(x, num_hidden_neurons, num_iter, lmb)\n", - "\n", - " # Print the deviation from the trial solution and true solution\n", - " res = g_trial(x,P)\n", - " res_analytical = g_analytic(x)\n", - "\n", - " print('Max absolute difference: %g'%np.max(np.abs(res - res_analytical)))\n", - "\n", - " # Plot the results\n", - " plt.figure(figsize=(10,10))\n", - "\n", - " plt.title('Performance of neural network solving an ODE compared to the analytical solution')\n", - " plt.plot(x, res_analytical)\n", - " plt.plot(x, res[0,:])\n", - " plt.legend(['analytical','nn'])\n", - " plt.xlabel('x')\n", - " plt.ylabel('g(x)')\n", - " plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## The network with one input layer, specified number of hidden layers, and one output layer\n", - "\n", - "It is also possible to extend the construction of our network into a more general one, allowing the network to contain more than one hidden layers.\n", - "\n", - "The number of neurons within each hidden layer are given as a list of integers in the program below." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import autograd.numpy as np\n", - "from autograd import grad, elementwise_grad\n", - "import autograd.numpy.random as npr\n", - "from matplotlib import pyplot as plt\n", - "\n", - "def sigmoid(z):\n", - " return 1/(1 + np.exp(-z))\n", - "\n", - "# The neural network with one input layer and one output layer,\n", - "# but with number of hidden layers specified by the user.\n", - "def deep_neural_network(deep_params, x):\n", - " # N_hidden is the number of hidden layers\n", - "\n", - " N_hidden = np.size(deep_params) - 1 # -1 since params consists of\n", - " # parameters to all the hidden\n", - " # layers AND the output layer.\n", - "\n", - " # Assumes input x being an one-dimensional array\n", - " num_values = np.size(x)\n", - " x = x.reshape(-1, num_values)\n", - "\n", - " # Assume that the input layer does nothing to the input x\n", - " x_input = x\n", - "\n", - " # Due to multiple hidden layers, define a variable referencing to the\n", - " # output of the previous layer:\n", - " x_prev = x_input\n", - "\n", - " ## Hidden layers:\n", - "\n", - " for l in range(N_hidden):\n", - " # From the list of parameters P; find the correct weigths and bias for this layer\n", - " w_hidden = deep_params[l]\n", - "\n", - " # Add a row of ones to include bias\n", - " x_prev = np.concatenate((np.ones((1,num_values)), x_prev ), axis = 0)\n", - "\n", - " z_hidden = np.matmul(w_hidden, x_prev)\n", - " x_hidden = sigmoid(z_hidden)\n", - "\n", - " # Update x_prev such that next layer can use the output from this layer\n", - " x_prev = x_hidden\n", - "\n", - " ## Output layer:\n", - "\n", - " # Get the weights and bias for this layer\n", - " w_output = deep_params[-1]\n", - "\n", - " # Include bias:\n", - " x_prev = np.concatenate((np.ones((1,num_values)), x_prev), axis = 0)\n", - "\n", - " z_output = np.matmul(w_output, x_prev)\n", - " x_output = z_output\n", - "\n", - " return x_output\n", - "\n", - "# The trial solution using the deep neural network:\n", - "def g_trial_deep(x,params, g0 = 10):\n", - " return g0 + x*deep_neural_network(params, x)\n", - "\n", - "# The right side of the ODE:\n", - "def g(x, g_trial, gamma = 2):\n", - " return -gamma*g_trial\n", - "\n", - "# The same cost function as before, but calls deep_neural_network instead.\n", - "def cost_function_deep(P, x):\n", - "\n", - " # Evaluate the trial function with the current parameters P\n", - " g_t = g_trial_deep(x,P)\n", - "\n", - " # Find the derivative w.r.t x of the neural network\n", - " d_net_out = elementwise_grad(deep_neural_network,1)(P,x)\n", - "\n", - " # Find the derivative w.r.t x of the trial function\n", - " d_g_t = elementwise_grad(g_trial_deep,0)(x,P)\n", - "\n", - " # The right side of the ODE\n", - " func = g(x, g_t)\n", - "\n", - " err_sqr = (d_g_t - func)**2\n", - " cost_sum = np.sum(err_sqr)\n", - "\n", - " return cost_sum / np.size(err_sqr)\n", - "\n", - "# Solve the exponential decay ODE using neural network with one input and one output layer,\n", - "# but with specified number of hidden layers from the user.\n", - "def solve_ode_deep_neural_network(x, num_neurons, num_iter, lmb):\n", - " # num_hidden_neurons is now a list of number of neurons within each hidden layer\n", - "\n", - " # The number of elements in the list num_hidden_neurons thus represents\n", - " # the number of hidden layers.\n", - "\n", - " # Find the number of hidden layers:\n", - " N_hidden = np.size(num_neurons)\n", - "\n", - " ## Set up initial weights and biases\n", - "\n", - " # Initialize the list of parameters:\n", - " P = [None]*(N_hidden + 1) # + 1 to include the output layer\n", - "\n", - " P[0] = npr.randn(num_neurons[0], 2 )\n", - " for l in range(1,N_hidden):\n", - " P[l] = npr.randn(num_neurons[l], num_neurons[l-1] + 1) # +1 to include bias\n", - "\n", - " # For the output layer\n", - " P[-1] = npr.randn(1, num_neurons[-1] + 1 ) # +1 since bias is included\n", - "\n", - " print('Initial cost: %g'%cost_function_deep(P, x))\n", - "\n", - " ## Start finding the optimal weights using gradient descent\n", - "\n", - " # Find the Python function that represents the gradient of the cost function\n", - " # w.r.t the 0-th input argument -- that is the weights and biases in the hidden and output layer\n", - " cost_function_deep_grad = grad(cost_function_deep,0)\n", - "\n", - " # Let the update be done num_iter times\n", - " for i in range(num_iter):\n", - " # Evaluate the gradient at the current weights and biases in P.\n", - " # The cost_grad consist now of N_hidden + 1 arrays; the gradient w.r.t the weights and biases\n", - " # in the hidden layers and output layers evaluated at x.\n", - " cost_deep_grad = cost_function_deep_grad(P, x)\n", - "\n", - " for l in range(N_hidden+1):\n", - " P[l] = P[l] - lmb * cost_deep_grad[l]\n", - "\n", - " print('Final cost: %g'%cost_function_deep(P, x))\n", - "\n", - " return P\n", - "\n", - "def g_analytic(x, gamma = 2, g0 = 10):\n", - " return g0*np.exp(-gamma*x)\n", - "\n", - "# Solve the given problem\n", - "if __name__ == '__main__':\n", - " npr.seed(15)\n", - "\n", - " ## Decide the vales of arguments to the function to solve\n", - " N = 10\n", - " x = np.linspace(0, 1, N)\n", - "\n", - " ## Set up the initial parameters\n", - " num_hidden_neurons = np.array([10,10])\n", - " num_iter = 10000\n", - " lmb = 0.001\n", - "\n", - " P = solve_ode_deep_neural_network(x, num_hidden_neurons, num_iter, lmb)\n", - "\n", - " res = g_trial_deep(x,P)\n", - " res_analytical = g_analytic(x)\n", - "\n", - " plt.figure(figsize=(10,10))\n", - "\n", - " plt.title('Performance of a deep neural network solving an ODE compared to the analytical solution')\n", - " plt.plot(x, res_analytical)\n", - " plt.plot(x, res[0,:])\n", - " plt.legend(['analytical','dnn'])\n", - " plt.ylabel('g(x)')\n", - " plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "### Example: Population growth\n", - "\n", - "A logistic model of population growth assumes that a population converges toward an equilibrium.\n", - "The population growth can be modeled by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation} \\label{log} \\tag{10}\n", - "\tg'(t) = \\alpha g(t)(A - g(t))\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $g(t)$ is the population density at time $t$, $\\alpha > 0$ the growth rate and $A > 0$ is the maximum population number in the environment.\n", - "Also, at $t = 0$ the population has the size $g(0) = g_0$, where $g_0$ is some chosen constant.\n", - "\n", - "In this example, similar network as for the exponential decay using Autograd has been used to solve the equation. However, as the implementation might suffer from e.g numerical instability\n", - "and high execution time (this might be more apparent in the examples solving PDEs),\n", - "using a library like TensorFlow is recommended.\n", - "Here, we stay with a more simple approach and implement for comparison, the simple forward Euler method.\n", - "\n", - "\n", - "\n", - "Here, we will model a population $g(t)$ in an environment having carrying capacity $A$.\n", - "The population follows the model" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation} \\label{solveode_population} \\tag{11}\n", - "g'(t) = \\alpha g(t)(A - g(t))\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $g(0) = g_0$.\n", - "\n", - "In this example, we let $\\alpha = 2$, $A = 1$, and $g_0 = 1.2$.\n", - "\n", - "\n", - "We will get a slightly different trial solution, as the boundary conditions are different\n", - "compared to the case for exponential decay.\n", - "\n", - "A possible trial solution satisfying the condition $g(0) = g_0$ could be\n", - "\n", - "$$\n", - "h_1(t) = g_0 + t \\cdot N(t,P)\n", - "$$\n", - "\n", - "with $N(t,P)$ being the output from the neural network with weights and biases for each layer collected in the set $P$.\n", - "\n", - "The analytical solution is\n", - "\n", - "$$\n", - "g(t) = \\frac{Ag_0}{g_0 + (A - g_0)\\exp(-\\alpha A t)}\n", - "$$\n", - "\n", - "\n", - "\n", - "The network will be the similar as for the exponential decay example, but with some small modifications for our problem." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import autograd.numpy as np\n", - "from autograd import grad, elementwise_grad\n", - "import autograd.numpy.random as npr\n", - "from matplotlib import pyplot as plt\n", - "\n", - "def sigmoid(z):\n", - " return 1/(1 + np.exp(-z))\n", - "\n", - "# Function to get the parameters.\n", - "# Done such that one can easily change the paramaters after one's liking.\n", - "def get_parameters():\n", - " alpha = 2\n", - " A = 1\n", - " g0 = 1.2\n", - " return alpha, A, g0\n", - "\n", - "def deep_neural_network(P, x):\n", - " # N_hidden is the number of hidden layers\n", - " N_hidden = np.size(P) - 1 # -1 since params consist of parameters to all the hidden layers AND the output layer\n", - "\n", - " # Assumes input x being an one-dimensional array\n", - " num_values = np.size(x)\n", - " x = x.reshape(-1, num_values)\n", - "\n", - " # Assume that the input layer does nothing to the input x\n", - " x_input = x\n", - "\n", - " # Due to multiple hidden layers, define a variable referencing to the\n", - " # output of the previous layer:\n", - " x_prev = x_input\n", - "\n", - " ## Hidden layers:\n", - "\n", - " for l in range(N_hidden):\n", - " # From the list of parameters P; find the correct weigths and bias for this layer\n", - " w_hidden = P[l]\n", - "\n", - " # Add a row of ones to include bias\n", - " x_prev = np.concatenate((np.ones((1,num_values)), x_prev ), axis = 0)\n", - "\n", - " z_hidden = np.matmul(w_hidden, x_prev)\n", - " x_hidden = sigmoid(z_hidden)\n", - "\n", - " # Update x_prev such that next layer can use the output from this layer\n", - " x_prev = x_hidden\n", - "\n", - " ## Output layer:\n", - "\n", - " # Get the weights and bias for this layer\n", - " w_output = P[-1]\n", - "\n", - " # Include bias:\n", - " x_prev = np.concatenate((np.ones((1,num_values)), x_prev), axis = 0)\n", - "\n", - " z_output = np.matmul(w_output, x_prev)\n", - " x_output = z_output\n", - "\n", - " return x_output\n", - "\n", - "\n", - "def cost_function_deep(P, x):\n", - "\n", - " # Evaluate the trial function with the current parameters P\n", - " g_t = g_trial_deep(x,P)\n", - "\n", - " # Find the derivative w.r.t x of the trial function\n", - " d_g_t = elementwise_grad(g_trial_deep,0)(x,P)\n", - "\n", - " # The right side of the ODE\n", - " func = f(x, g_t)\n", - "\n", - " err_sqr = (d_g_t - func)**2\n", - " cost_sum = np.sum(err_sqr)\n", - "\n", - " return cost_sum / np.size(err_sqr)\n", - "\n", - "# The right side of the ODE:\n", - "def f(x, g_trial):\n", - " alpha,A, g0 = get_parameters()\n", - " return alpha*g_trial*(A - g_trial)\n", - "\n", - "# The trial solution using the deep neural network:\n", - "def g_trial_deep(x, params):\n", - " alpha,A, g0 = get_parameters()\n", - " return g0 + x*deep_neural_network(params,x)\n", - "\n", - "# The analytical solution:\n", - "def g_analytic(t):\n", - " alpha,A, g0 = get_parameters()\n", - " return A*g0/(g0 + (A - g0)*np.exp(-alpha*A*t))\n", - "\n", - "def solve_ode_deep_neural_network(x, num_neurons, num_iter, lmb):\n", - " # num_hidden_neurons is now a list of number of neurons within each hidden layer\n", - "\n", - " # Find the number of hidden layers:\n", - " N_hidden = np.size(num_neurons)\n", - "\n", - " ## Set up initial weigths and biases\n", - "\n", - " # Initialize the list of parameters:\n", - " P = [None]*(N_hidden + 1) # + 1 to include the output layer\n", - "\n", - " P[0] = npr.randn(num_neurons[0], 2 )\n", - " for l in range(1,N_hidden):\n", - " P[l] = npr.randn(num_neurons[l], num_neurons[l-1] + 1) # +1 to include bias\n", - "\n", - " # For the output layer\n", - " P[-1] = npr.randn(1, num_neurons[-1] + 1 ) # +1 since bias is included\n", - "\n", - " print('Initial cost: %g'%cost_function_deep(P, x))\n", - "\n", - " ## Start finding the optimal weigths using gradient descent\n", - "\n", - " # Find the Python function that represents the gradient of the cost function\n", - " # w.r.t the 0-th input argument -- that is the weights and biases in the hidden and output layer\n", - " cost_function_deep_grad = grad(cost_function_deep,0)\n", - "\n", - " # Let the update be done num_iter times\n", - " for i in range(num_iter):\n", - " # Evaluate the gradient at the current weights and biases in P.\n", - " # The cost_grad consist now of N_hidden + 1 arrays; the gradient w.r.t the weights and biases\n", - " # in the hidden layers and output layers evaluated at x.\n", - " cost_deep_grad = cost_function_deep_grad(P, x)\n", - "\n", - " for l in range(N_hidden+1):\n", - " P[l] = P[l] - lmb * cost_deep_grad[l]\n", - "\n", - " print('Final cost: %g'%cost_function_deep(P, x))\n", - "\n", - " return P\n", - "\n", - "if __name__ == '__main__':\n", - " npr.seed(4155)\n", - "\n", - " ## Decide the vales of arguments to the function to solve\n", - " Nt = 10\n", - " T = 1\n", - " t = np.linspace(0,T, Nt)\n", - "\n", - " ## Set up the initial parameters\n", - " num_hidden_neurons = [100, 50, 25]\n", - " num_iter = 1000\n", - " lmb = 1e-3\n", - "\n", - " P = solve_ode_deep_neural_network(t, num_hidden_neurons, num_iter, lmb)\n", - "\n", - " g_dnn_ag = g_trial_deep(t,P)\n", - " g_analytical = g_analytic(t)\n", - "\n", - " # Find the maximum absolute difference between the solutons:\n", - " diff_ag = np.max(np.abs(g_dnn_ag - g_analytical))\n", - " print(\"The max absolute difference between the solutions is: %g\"%diff_ag)\n", - "\n", - " plt.figure(figsize=(10,10))\n", - "\n", - " plt.title('Performance of neural network solving an ODE compared to the analytical solution')\n", - " plt.plot(t, g_analytical)\n", - " plt.plot(t, g_dnn_ag[0,:])\n", - " plt.legend(['analytical','nn'])\n", - " plt.xlabel('t')\n", - " plt.ylabel('g(t)')\n", - "\n", - " plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Using forward Euler to solve the ODE\n", - "\n", - "A straightforward way of solving an ODE numerically, is to use Euler's method.\n", - "\n", - "Euler's method uses Taylor series to approximate the value at a function $f$ at a step $\\Delta x$ from $x$:\n", - "\n", - "$$\n", - "f(x + \\Delta x) \\approx f(x) + \\Delta x f'(x)\n", - "$$\n", - "\n", - "In our case, using Euler's method to approximate the value of $g$ at a step $\\Delta t$ from $t$ yields" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{aligned}\n", - " g(t + \\Delta t) &\\approx g(t) + \\Delta t g'(t) \\\\\n", - " &= g(t) + \\Delta t \\big(\\alpha g(t)(A - g(t))\\big)\n", - "\\end{aligned}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "along with the condition that $g(0) = g_0$.\n", - "\n", - "Let $t_i = i \\cdot \\Delta t$ where $\\Delta t = \\frac{T}{N_t-1}$ where $T$ is the final time our solver must solve for and $N_t$ the number of values for $t \\in [0, T]$ for $i = 0, \\dots, N_t-1$.\n", - "\n", - "For $i \\geq 1$, we have that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{aligned}\n", - "t_i &= i\\Delta t \\\\\n", - "&= (i - 1)\\Delta t + \\Delta t \\\\\n", - "&= t_{i-1} + \\Delta t\n", - "\\end{aligned}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Now, if $g_i = g(t_i)$ then" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - " \\begin{aligned}\n", - " g_i &= g(t_i) \\\\\n", - " &= g(t_{i-1} + \\Delta t) \\\\\n", - " &\\approx g(t_{i-1}) + \\Delta t \\big(\\alpha g(t_{i-1})(A - g(t_{i-1}))\\big) \\\\\n", - " &= g_{i-1} + \\Delta t \\big(\\alpha g_{i-1}(A - g_{i-1})\\big)\n", - " \\end{aligned}\n", - "\\end{equation} \\label{odenum} \\tag{12}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "for $i \\geq 1$ and $g_0 = g(t_0) = g(0) = g_0$.\n", - "\n", - "Equation ([12](#odenum)) could be implemented in the following way,\n", - "extending the program that uses the network using Autograd:" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "# Assume that all function definitions from the example program using Autograd\n", - "# are located here.\n", - "\n", - "if __name__ == '__main__':\n", - " npr.seed(4155)\n", - "\n", - " ## Decide the vales of arguments to the function to solve\n", - " Nt = 10\n", - " T = 1\n", - " t = np.linspace(0,T, Nt)\n", - "\n", - " ## Set up the initial parameters\n", - " num_hidden_neurons = [100,50,25]\n", - " num_iter = 1000\n", - " lmb = 1e-3\n", - "\n", - " P = solve_ode_deep_neural_network(t, num_hidden_neurons, num_iter, lmb)\n", - "\n", - " g_dnn_ag = g_trial_deep(t,P)\n", - " g_analytical = g_analytic(t)\n", - "\n", - " # Find the maximum absolute difference between the solutons:\n", - " diff_ag = np.max(np.abs(g_dnn_ag - g_analytical))\n", - " print(\"The max absolute difference between the solutions is: %g\"%diff_ag)\n", - "\n", - " plt.figure(figsize=(10,10))\n", - "\n", - " plt.title('Performance of neural network solving an ODE compared to the analytical solution')\n", - " plt.plot(t, g_analytical)\n", - " plt.plot(t, g_dnn_ag[0,:])\n", - " plt.legend(['analytical','nn'])\n", - " plt.xlabel('t')\n", - " plt.ylabel('g(t)')\n", - "\n", - " ## Find an approximation to the funtion using forward Euler\n", - "\n", - " alpha, A, g0 = get_parameters()\n", - " dt = T/(Nt - 1)\n", - "\n", - " # Perform forward Euler to solve the ODE\n", - " g_euler = np.zeros(Nt)\n", - " g_euler[0] = g0\n", - "\n", - " for i in range(1,Nt):\n", - " g_euler[i] = g_euler[i-1] + dt*(alpha*g_euler[i-1]*(A - g_euler[i-1]))\n", - "\n", - " # Print the errors done by each method\n", - " diff1 = np.max(np.abs(g_euler - g_analytical))\n", - " diff2 = np.max(np.abs(g_dnn_ag[0,:] - g_analytical))\n", - "\n", - " print('Max absolute difference between Euler method and analytical: %g'%diff1)\n", - " print('Max absolute difference between deep neural network and analytical: %g'%diff2)\n", - "\n", - " # Plot results\n", - " plt.figure(figsize=(10,10))\n", - "\n", - " plt.plot(t,g_euler)\n", - " plt.plot(t,g_analytical)\n", - " plt.plot(t,g_dnn_ag[0,:])\n", - "\n", - " plt.legend(['euler','analytical','dnn'])\n", - " plt.xlabel('Time t')\n", - " plt.ylabel('g(t)')\n", - "\n", - " plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Solving the one dimensional Poisson equation\n", - "\n", - "The Poisson equation for $g(x)$ in one dimension is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation} \\label{poisson} \\tag{13}\n", - " -g''(x) = f(x)\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $f(x)$ is a given function for $x \\in (0,1)$.\n", - "\n", - "The conditions that $g(x)$ is chosen to fulfill, are" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{align*}\n", - " g(0) &= 0 \\\\\n", - " g(1) &= 0\n", - "\\end{align*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "This equation can be solved numerically using programs where e.g Autograd and TensorFlow are used.\n", - "The results from the networks can then be compared to the analytical solution.\n", - "In addition, it could be interesting to see how a typical method for numerically solving second order ODEs compares to the neural networks.\n", - "\n", - "\n", - "Here, the function $g(x)$ to solve for follows the equation" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "-g''(x) = f(x),\\qquad x \\in (0,1)\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $f(x)$ is a given function, along with the chosen conditions" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{aligned}\n", - "g(0) = g(1) = 0\n", - "\\end{aligned}\\label{cond} \\tag{14}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In this example, we consider the case when $f(x) = (3x + x^2)\\exp(x)$.\n", - "\n", - "For this case, a possible trial solution satisfying the conditions could be" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "g_t(x) = x \\cdot (1-x) \\cdot N(P,x)\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The analytical solution for this problem is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "g(x) = x(1 - x)\\exp(x)\n", - "$$" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import autograd.numpy as np\n", - "from autograd import grad, elementwise_grad\n", - "import autograd.numpy.random as npr\n", - "from matplotlib import pyplot as plt\n", - "\n", - "def sigmoid(z):\n", - " return 1/(1 + np.exp(-z))\n", - "\n", - "def deep_neural_network(deep_params, x):\n", - " # N_hidden is the number of hidden layers\n", - " N_hidden = np.size(deep_params) - 1 # -1 since params consist of parameters to all the hidden layers AND the output layer\n", - "\n", - " # Assumes input x being an one-dimensional array\n", - " num_values = np.size(x)\n", - " x = x.reshape(-1, num_values)\n", - "\n", - " # Assume that the input layer does nothing to the input x\n", - " x_input = x\n", - "\n", - " # Due to multiple hidden layers, define a variable referencing to the\n", - " # output of the previous layer:\n", - " x_prev = x_input\n", - "\n", - " ## Hidden layers:\n", - "\n", - " for l in range(N_hidden):\n", - " # From the list of parameters P; find the correct weigths and bias for this layer\n", - " w_hidden = deep_params[l]\n", - "\n", - " # Add a row of ones to include bias\n", - " x_prev = np.concatenate((np.ones((1,num_values)), x_prev ), axis = 0)\n", - "\n", - " z_hidden = np.matmul(w_hidden, x_prev)\n", - " x_hidden = sigmoid(z_hidden)\n", - "\n", - " # Update x_prev such that next layer can use the output from this layer\n", - " x_prev = x_hidden\n", - "\n", - " ## Output layer:\n", - "\n", - " # Get the weights and bias for this layer\n", - " w_output = deep_params[-1]\n", - "\n", - " # Include bias:\n", - " x_prev = np.concatenate((np.ones((1,num_values)), x_prev), axis = 0)\n", - "\n", - " z_output = np.matmul(w_output, x_prev)\n", - " x_output = z_output\n", - "\n", - " return x_output\n", - "\n", - "def solve_ode_deep_neural_network(x, num_neurons, num_iter, lmb):\n", - " # num_hidden_neurons is now a list of number of neurons within each hidden layer\n", - "\n", - " # Find the number of hidden layers:\n", - " N_hidden = np.size(num_neurons)\n", - "\n", - " ## Set up initial weigths and biases\n", - "\n", - " # Initialize the list of parameters:\n", - " P = [None]*(N_hidden + 1) # + 1 to include the output layer\n", - "\n", - " P[0] = npr.randn(num_neurons[0], 2 )\n", - " for l in range(1,N_hidden):\n", - " P[l] = npr.randn(num_neurons[l], num_neurons[l-1] + 1) # +1 to include bias\n", - "\n", - " # For the output layer\n", - " P[-1] = npr.randn(1, num_neurons[-1] + 1 ) # +1 since bias is included\n", - "\n", - " print('Initial cost: %g'%cost_function_deep(P, x))\n", - "\n", - " ## Start finding the optimal weigths using gradient descent\n", - "\n", - " # Find the Python function that represents the gradient of the cost function\n", - " # w.r.t the 0-th input argument -- that is the weights and biases in the hidden and output layer\n", - " cost_function_deep_grad = grad(cost_function_deep,0)\n", - "\n", - " # Let the update be done num_iter times\n", - " for i in range(num_iter):\n", - " # Evaluate the gradient at the current weights and biases in P.\n", - " # The cost_grad consist now of N_hidden + 1 arrays; the gradient w.r.t the weights and biases\n", - " # in the hidden layers and output layers evaluated at x.\n", - " cost_deep_grad = cost_function_deep_grad(P, x)\n", - "\n", - " for l in range(N_hidden+1):\n", - " P[l] = P[l] - lmb * cost_deep_grad[l]\n", - "\n", - " print('Final cost: %g'%cost_function_deep(P, x))\n", - "\n", - " return P\n", - "\n", - "## Set up the cost function specified for this Poisson equation:\n", - "\n", - "# The right side of the ODE\n", - "def f(x):\n", - " return (3*x + x**2)*np.exp(x)\n", - "\n", - "def cost_function_deep(P, x):\n", - "\n", - " # Evaluate the trial function with the current parameters P\n", - " g_t = g_trial_deep(x,P)\n", - "\n", - " # Find the derivative w.r.t x of the trial function\n", - " d2_g_t = elementwise_grad(elementwise_grad(g_trial_deep,0))(x,P)\n", - "\n", - " right_side = f(x)\n", - "\n", - " err_sqr = (-d2_g_t - right_side)**2\n", - " cost_sum = np.sum(err_sqr)\n", - "\n", - " return cost_sum/np.size(err_sqr)\n", - "\n", - "# The trial solution:\n", - "def g_trial_deep(x,P):\n", - " return x*(1-x)*deep_neural_network(P,x)\n", - "\n", - "# The analytic solution;\n", - "def g_analytic(x):\n", - " return x*(1-x)*np.exp(x)\n", - "\n", - "if __name__ == '__main__':\n", - " npr.seed(4155)\n", - "\n", - " ## Decide the vales of arguments to the function to solve\n", - " Nx = 10\n", - " x = np.linspace(0,1, Nx)\n", - "\n", - " ## Set up the initial parameters\n", - " num_hidden_neurons = [200,100]\n", - " num_iter = 1000\n", - " lmb = 1e-3\n", - "\n", - " P = solve_ode_deep_neural_network(x, num_hidden_neurons, num_iter, lmb)\n", - "\n", - " g_dnn_ag = g_trial_deep(x,P)\n", - " g_analytical = g_analytic(x)\n", - "\n", - " # Find the maximum absolute difference between the solutons:\n", - " max_diff = np.max(np.abs(g_dnn_ag - g_analytical))\n", - " print(\"The max absolute difference between the solutions is: %g\"%max_diff)\n", - "\n", - " plt.figure(figsize=(10,10))\n", - "\n", - " plt.title('Performance of neural network solving an ODE compared to the analytical solution')\n", - " plt.plot(x, g_analytical)\n", - " plt.plot(x, g_dnn_ag[0,:])\n", - " plt.legend(['analytical','nn'])\n", - " plt.xlabel('x')\n", - " plt.ylabel('g(x)')\n", - " plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "### Comparing with a numerical scheme\n", - "\n", - "The Poisson equation is possible to solve using Taylor series to approximate the second derivative.\n", - "\n", - "Using Taylor series, the second derivative can be expressed as\n", - "\n", - "$$\n", - "g''(x) = \\frac{g(x + \\Delta x) - 2g(x) + g(x-\\Delta x)}{\\Delta x^2} + E_{\\Delta x}(x)\n", - "$$\n", - "\n", - "where $\\Delta x$ is a small step size and $E_{\\Delta x}(x)$ being the error term.\n", - "\n", - "Looking away from the error terms gives an approximation to the second derivative:" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation} \\label{approx} \\tag{15}\n", - "g''(x) \\approx \\frac{g(x + \\Delta x) - 2g(x) + g(x-\\Delta x)}{\\Delta x^2}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "If $x_i = i \\Delta x = x_{i-1} + \\Delta x$ and $g_i = g(x_i)$ for $i = 1,\\dots N_x - 2$ with $N_x$ being the number of values for $x$, ([15](#approx)) becomes" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{aligned}\n", - "g''(x_i) &\\approx \\frac{g(x_i + \\Delta x) - 2g(x_i) + g(x_i -\\Delta x)}{\\Delta x^2} \\\\\n", - "&= \\frac{g_{i+1} - 2g_i + g_{i-1}}{\\Delta x^2}\n", - "\\end{aligned}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Since we know from our problem that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{aligned}\n", - "-g''(x) &= f(x) \\\\\n", - "&= (3x + x^2)\\exp(x)\n", - "\\end{aligned}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "along with the conditions $g(0) = g(1) = 0$,\n", - "the following scheme can be used to find an approximate solution for $g(x)$ numerically:" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - " \\begin{aligned}\n", - " -\\Big( \\frac{g_{i+1} - 2g_i + g_{i-1}}{\\Delta x^2} \\Big) &= f(x_i) \\\\\n", - " -g_{i+1} + 2g_i - g_{i-1} &= \\Delta x^2 f(x_i)\n", - " \\end{aligned}\n", - "\\end{equation} \\label{odesys} \\tag{16}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "for $i = 1, \\dots, N_x - 2$ where $g_0 = g_{N_x - 1} = 0$ and $f(x_i) = (3x_i + x_i^2)\\exp(x_i)$, which is given for our specific problem.\n", - "\n", - "The equation can be rewritten into a matrix equation:" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{aligned}\n", - "\\begin{pmatrix}\n", - "2 & -1 & 0 & \\dots & 0 \\\\\n", - "-1 & 2 & -1 & \\dots & 0 \\\\\n", - "\\vdots & & \\ddots & & \\vdots \\\\\n", - "0 & \\dots & -1 & 2 & -1 \\\\\n", - "0 & \\dots & 0 & -1 & 2\\\\\n", - "\\end{pmatrix}\n", - "\\begin{pmatrix}\n", - "g_1 \\\\\n", - "g_2 \\\\\n", - "\\vdots \\\\\n", - "g_{N_x - 3} \\\\\n", - "g_{N_x - 2}\n", - "\\end{pmatrix}\n", - "&=\n", - "\\Delta x^2\n", - "\\begin{pmatrix}\n", - "f(x_1) \\\\\n", - "f(x_2) \\\\\n", - "\\vdots \\\\\n", - "f(x_{N_x - 3}) \\\\\n", - "f(x_{N_x - 2})\n", - "\\end{pmatrix} \\\\\n", - "\\boldsymbol{A}\\boldsymbol{g} &= \\boldsymbol{f},\n", - "\\end{aligned}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which makes it possible to solve for the vector $\\boldsymbol{g}$.\n", - "\n", - "\n", - "We can then compare the result from this numerical scheme with the output from our network using Autograd:" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import autograd.numpy as np\n", - "from autograd import grad, elementwise_grad\n", - "import autograd.numpy.random as npr\n", - "from matplotlib import pyplot as plt\n", - "\n", - "def sigmoid(z):\n", - " return 1/(1 + np.exp(-z))\n", - "\n", - "def deep_neural_network(deep_params, x):\n", - " # N_hidden is the number of hidden layers\n", - " N_hidden = np.size(deep_params) - 1 # -1 since params consist of parameters to all the hidden layers AND the output layer\n", - "\n", - " # Assumes input x being an one-dimensional array\n", - " num_values = np.size(x)\n", - " x = x.reshape(-1, num_values)\n", - "\n", - " # Assume that the input layer does nothing to the input x\n", - " x_input = x\n", - "\n", - " # Due to multiple hidden layers, define a variable referencing to the\n", - " # output of the previous layer:\n", - " x_prev = x_input\n", - "\n", - " ## Hidden layers:\n", - "\n", - " for l in range(N_hidden):\n", - " # From the list of parameters P; find the correct weigths and bias for this layer\n", - " w_hidden = deep_params[l]\n", - "\n", - " # Add a row of ones to include bias\n", - " x_prev = np.concatenate((np.ones((1,num_values)), x_prev ), axis = 0)\n", - "\n", - " z_hidden = np.matmul(w_hidden, x_prev)\n", - " x_hidden = sigmoid(z_hidden)\n", - "\n", - " # Update x_prev such that next layer can use the output from this layer\n", - " x_prev = x_hidden\n", - "\n", - " ## Output layer:\n", - "\n", - " # Get the weights and bias for this layer\n", - " w_output = deep_params[-1]\n", - "\n", - " # Include bias:\n", - " x_prev = np.concatenate((np.ones((1,num_values)), x_prev), axis = 0)\n", - "\n", - " z_output = np.matmul(w_output, x_prev)\n", - " x_output = z_output\n", - "\n", - " return x_output\n", - "\n", - "def solve_ode_deep_neural_network(x, num_neurons, num_iter, lmb):\n", - " # num_hidden_neurons is now a list of number of neurons within each hidden layer\n", - "\n", - " # Find the number of hidden layers:\n", - " N_hidden = np.size(num_neurons)\n", - "\n", - " ## Set up initial weigths and biases\n", - "\n", - " # Initialize the list of parameters:\n", - " P = [None]*(N_hidden + 1) # + 1 to include the output layer\n", - "\n", - " P[0] = npr.randn(num_neurons[0], 2 )\n", - " for l in range(1,N_hidden):\n", - " P[l] = npr.randn(num_neurons[l], num_neurons[l-1] + 1) # +1 to include bias\n", - "\n", - " # For the output layer\n", - " P[-1] = npr.randn(1, num_neurons[-1] + 1 ) # +1 since bias is included\n", - "\n", - " print('Initial cost: %g'%cost_function_deep(P, x))\n", - "\n", - " ## Start finding the optimal weigths using gradient descent\n", - "\n", - " # Find the Python function that represents the gradient of the cost function\n", - " # w.r.t the 0-th input argument -- that is the weights and biases in the hidden and output layer\n", - " cost_function_deep_grad = grad(cost_function_deep,0)\n", - "\n", - " # Let the update be done num_iter times\n", - " for i in range(num_iter):\n", - " # Evaluate the gradient at the current weights and biases in P.\n", - " # The cost_grad consist now of N_hidden + 1 arrays; the gradient w.r.t the weights and biases\n", - " # in the hidden layers and output layers evaluated at x.\n", - " cost_deep_grad = cost_function_deep_grad(P, x)\n", - "\n", - " for l in range(N_hidden+1):\n", - " P[l] = P[l] - lmb * cost_deep_grad[l]\n", - "\n", - " print('Final cost: %g'%cost_function_deep(P, x))\n", - "\n", - " return P\n", - "\n", - "## Set up the cost function specified for this Poisson equation:\n", - "\n", - "# The right side of the ODE\n", - "def f(x):\n", - " return (3*x + x**2)*np.exp(x)\n", - "\n", - "def cost_function_deep(P, x):\n", - "\n", - " # Evaluate the trial function with the current parameters P\n", - " g_t = g_trial_deep(x,P)\n", - "\n", - " # Find the derivative w.r.t x of the trial function\n", - " d2_g_t = elementwise_grad(elementwise_grad(g_trial_deep,0))(x,P)\n", - "\n", - " right_side = f(x)\n", - "\n", - " err_sqr = (-d2_g_t - right_side)**2\n", - " cost_sum = np.sum(err_sqr)\n", - "\n", - " return cost_sum/np.size(err_sqr)\n", - "\n", - "# The trial solution:\n", - "def g_trial_deep(x,P):\n", - " return x*(1-x)*deep_neural_network(P,x)\n", - "\n", - "# The analytic solution;\n", - "def g_analytic(x):\n", - " return x*(1-x)*np.exp(x)\n", - "\n", - "if __name__ == '__main__':\n", - " npr.seed(4155)\n", - "\n", - " ## Decide the vales of arguments to the function to solve\n", - " Nx = 10\n", - " x = np.linspace(0,1, Nx)\n", - "\n", - " ## Set up the initial parameters\n", - " num_hidden_neurons = [200,100]\n", - " num_iter = 1000\n", - " lmb = 1e-3\n", - "\n", - " P = solve_ode_deep_neural_network(x, num_hidden_neurons, num_iter, lmb)\n", - "\n", - " g_dnn_ag = g_trial_deep(x,P)\n", - " g_analytical = g_analytic(x)\n", - "\n", - " # Find the maximum absolute difference between the solutons:\n", - "\n", - " plt.figure(figsize=(10,10))\n", - "\n", - " plt.title('Performance of neural network solving an ODE compared to the analytical solution')\n", - " plt.plot(x, g_analytical)\n", - " plt.plot(x, g_dnn_ag[0,:])\n", - " plt.legend(['analytical','nn'])\n", - " plt.xlabel('x')\n", - " plt.ylabel('g(x)')\n", - "\n", - " ## Perform the computation using the numerical scheme\n", - "\n", - " dx = 1/(Nx - 1)\n", - "\n", - " # Set up the matrix A\n", - " A = np.zeros((Nx-2,Nx-2))\n", - "\n", - " A[0,0] = 2\n", - " A[0,1] = -1\n", - "\n", - " for i in range(1,Nx-3):\n", - " A[i,i-1] = -1\n", - " A[i,i] = 2\n", - " A[i,i+1] = -1\n", - "\n", - " A[Nx - 3, Nx - 4] = -1\n", - " A[Nx - 3, Nx - 3] = 2\n", - "\n", - " # Set up the vector f\n", - " f_vec = dx**2 * f(x[1:-1])\n", - "\n", - " # Solve the equation\n", - " g_res = np.linalg.solve(A,f_vec)\n", - "\n", - " g_vec = np.zeros(Nx)\n", - " g_vec[1:-1] = g_res\n", - "\n", - " # Print the differences between each method\n", - " max_diff1 = np.max(np.abs(g_dnn_ag - g_analytical))\n", - " max_diff2 = np.max(np.abs(g_vec - g_analytical))\n", - " print(\"The max absolute difference between the analytical solution and DNN Autograd: %g\"%max_diff1)\n", - " print(\"The max absolute difference between the analytical solution and numerical scheme: %g\"%max_diff2)\n", - "\n", - " # Plot the results\n", - " plt.figure(figsize=(10,10))\n", - "\n", - " plt.plot(x,g_vec)\n", - " plt.plot(x,g_analytical)\n", - " plt.plot(x,g_dnn_ag[0,:])\n", - "\n", - " plt.legend(['numerical scheme','analytical','dnn'])\n", - " plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Partial Differential Equations\n", - "\n", - "A partial differential equation (PDE) has a solution here the function\n", - "is defined by multiple variables. The equation may involve all kinds\n", - "of combinations of which variables the function is differentiated with\n", - "respect to.\n", - "\n", - "In general, a partial differential equation for a function $g(x_1,\\dots,x_N)$ with $N$ variables may be expressed as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation} \\label{PDE} \\tag{17}\n", - " f\\left(x_1, \\, \\dots \\, , x_N, \\frac{\\partial g(x_1,\\dots,x_N) }{\\partial x_1}, \\dots , \\frac{\\partial g(x_1,\\dots,x_N) }{\\partial x_N}, \\frac{\\partial g(x_1,\\dots,x_N) }{\\partial x_1\\partial x_2}, \\, \\dots \\, , \\frac{\\partial^n g(x_1,\\dots,x_N) }{\\partial x_N^n} \\right) = 0\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $f$ is an expression involving all kinds of possible mixed derivatives of $g(x_1,\\dots,x_N)$ up to an order $n$. In order for the solution to be unique, some additional conditions must also be given.\n", - "\n", - "### Type of problem\n", - "\n", - "The problem our network must solve for, is similar to the ODE case.\n", - "We must have a trial solution $g_t$ at hand.\n", - "\n", - "For instance, the trial solution could be expressed as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{align*}\n", - " g_t(x_1,\\dots,x_N) = h_1(x_1,\\dots,x_N) + h_2(x_1,\\dots,x_N,N(x_1,\\dots,x_N,P))\n", - "\\end{align*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $h_1(x_1,\\dots,x_N)$ is a function that ensures $g_t(x_1,\\dots,x_N)$ satisfies some given conditions.\n", - "The neural network $N(x_1,\\dots,x_N,P)$ has weights and biases described by $P$ and $h_2(x_1,\\dots,x_N,N(x_1,\\dots,x_N,P))$ is an expression using the output from the neural network in some way.\n", - "\n", - "The role of the function $h_2(x_1,\\dots,x_N,N(x_1,\\dots,x_N,P))$, is to ensure that the output of $N(x_1,\\dots,x_N,P)$ is zero when $g_t(x_1,\\dots,x_N)$ is evaluated at the values of $x_1,\\dots,x_N$ where the given conditions must be satisfied. The function $h_1(x_1,\\dots,x_N)$ should alone make $g_t(x_1,\\dots,x_N)$ satisfy the conditions.\n", - "\n", - "\n", - "\n", - "### Network requirements\n", - "\n", - "The network tries then the minimize the cost function following the\n", - "same ideas as described for the ODE case, but now with more than one\n", - "variables to consider. The concept still remains the same; find a set\n", - "of parameters $P$ such that the expression $f$ in ([17](#PDE)) is as\n", - "close to zero as possible.\n", - "\n", - "As for the ODE case, the cost function is the mean squared error that\n", - "the network must try to minimize. The cost function for the network to\n", - "minimize is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C\\left(x_1, \\dots, x_N, P\\right) = \\left( f\\left(x_1, \\, \\dots \\, , x_N, \\frac{\\partial g(x_1,\\dots,x_N) }{\\partial x_1}, \\dots , \\frac{\\partial g(x_1,\\dots,x_N) }{\\partial x_N}, \\frac{\\partial g(x_1,\\dots,x_N) }{\\partial x_1\\partial x_2}, \\, \\dots \\, , \\frac{\\partial^n g(x_1,\\dots,x_N) }{\\partial x_N^n} \\right) \\right)^2\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "If we let $\\boldsymbol{x} = \\big( x_1, \\dots, x_N \\big)$ be an array containing the values for $x_1, \\dots, x_N$ respectively, the cost function can be reformulated into the following:" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C\\left(\\boldsymbol{x}, P\\right) = f\\left( \\left( \\boldsymbol{x}, \\frac{\\partial g(\\boldsymbol{x}) }{\\partial x_1}, \\dots , \\frac{\\partial g(\\boldsymbol{x}) }{\\partial x_N}, \\frac{\\partial g(\\boldsymbol{x}) }{\\partial x_1\\partial x_2}, \\, \\dots \\, , \\frac{\\partial^n g(\\boldsymbol{x}) }{\\partial x_N^n} \\right) \\right)^2\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "If we also have $M$ different sets of values for $x_1, \\dots, x_N$, that is $\\boldsymbol{x}_i = \\big(x_1^{(i)}, \\dots, x_N^{(i)}\\big)$ for $i = 1,\\dots,M$ being the rows in matrix $X$, the cost function can be generalized into" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C\\left(X, P \\right) = \\sum_{i=1}^M f\\left( \\left( \\boldsymbol{x}_i, \\frac{\\partial g(\\boldsymbol{x}_i) }{\\partial x_1}, \\dots , \\frac{\\partial g(\\boldsymbol{x}_i) }{\\partial x_N}, \\frac{\\partial g(\\boldsymbol{x}_i) }{\\partial x_1\\partial x_2}, \\, \\dots \\, , \\frac{\\partial^n g(\\boldsymbol{x}_i) }{\\partial x_N^n} \\right) \\right)^2.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Example: The diffusion equation\n", - "\n", - "In one spatial dimension, the equation reads" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial g(x,t)}{\\partial t} = \\frac{\\partial^2 g(x,t)}{\\partial x^2}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where a possible choice of conditions are" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{align*}\n", - "g(0,t) &= 0 ,\\qquad t \\geq 0 \\\\\n", - "g(1,t) &= 0, \\qquad t \\geq 0 \\\\\n", - "g(x,0) &= u(x),\\qquad x\\in [0,1]\n", - "\\end{align*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with $u(x)$ being some given function.\n", - "\n", - "\n", - "\n", - "For this case, we want to find $g(x,t)$ such that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - " \\frac{\\partial g(x,t)}{\\partial t} = \\frac{\\partial^2 g(x,t)}{\\partial x^2}\n", - "\\end{equation} \\label{diffonedim} \\tag{18}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{align*}\n", - "g(0,t) &= 0 ,\\qquad t \\geq 0 \\\\\n", - "g(1,t) &= 0, \\qquad t \\geq 0 \\\\\n", - "g(x,0) &= u(x),\\qquad x\\in [0,1]\n", - "\\end{align*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with $u(x) = \\sin(\\pi x)$.\n", - "\n", - "First, let us set up the deep neural network.\n", - "The deep neural network will follow the same structure as discussed in the examples solving the ODEs.\n", - "First, we will look into how Autograd could be used in a network tailored to solve for bivariate functions.\n", - "\n", - "\n", - "\n", - "\n", - "The only change to do here, is to extend our network such that\n", - "functions of multiple parameters are correctly handled. In this case\n", - "we have two variables in our function to solve for, that is time $t$\n", - "and position $x$. The variables will be represented by a\n", - "one-dimensional array in the program. The program will evaluate the\n", - "network at each possible pair $(x,t)$, given an array for the desired\n", - "$x$-values and $t$-values to approximate the solution at." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "def sigmoid(z):\n", - " return 1/(1 + np.exp(-z))\n", - "\n", - "def deep_neural_network(deep_params, x):\n", - " # x is now a point and a 1D numpy array; make it a column vector\n", - " num_coordinates = np.size(x,0)\n", - " x = x.reshape(num_coordinates,-1)\n", - "\n", - " num_points = np.size(x,1)\n", - "\n", - " # N_hidden is the number of hidden layers\n", - " N_hidden = np.size(deep_params) - 1 # -1 since params consist of parameters to all the hidden layers AND the output layer\n", - "\n", - " # Assume that the input layer does nothing to the input x\n", - " x_input = x\n", - " x_prev = x_input\n", - "\n", - " ## Hidden layers:\n", - "\n", - " for l in range(N_hidden):\n", - " # From the list of parameters P; find the correct weigths and bias for this layer\n", - " w_hidden = deep_params[l]\n", - "\n", - " # Add a row of ones to include bias\n", - " x_prev = np.concatenate((np.ones((1,num_points)), x_prev ), axis = 0)\n", - "\n", - " z_hidden = np.matmul(w_hidden, x_prev)\n", - " x_hidden = sigmoid(z_hidden)\n", - "\n", - " # Update x_prev such that next layer can use the output from this layer\n", - " x_prev = x_hidden\n", - "\n", - " ## Output layer:\n", - "\n", - " # Get the weights and bias for this layer\n", - " w_output = deep_params[-1]\n", - "\n", - " # Include bias:\n", - " x_prev = np.concatenate((np.ones((1,num_points)), x_prev), axis = 0)\n", - "\n", - " z_output = np.matmul(w_output, x_prev)\n", - " x_output = z_output\n", - "\n", - " return x_output[0][0]" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The cost function must then iterate through the given arrays\n", - "containing values for $x$ and $t$, defines a point $(x,t)$ the deep\n", - "neural network and the trial solution is evaluated at, and then finds\n", - "the Jacobian of the trial solution.\n", - "\n", - "A possible trial solution for this PDE is\n", - "\n", - "$$\n", - "g_t(x,t) = h_1(x,t) + x(1-x)tN(x,t,P)\n", - "$$\n", - "\n", - "with $A(x,t)$ being a function ensuring that $g_t(x,t)$ satisfies our given conditions, and $N(x,t,P)$ being the output from the deep neural network using weights and biases for each layer from $P$.\n", - "\n", - "To fulfill the conditions, $A(x,t)$ could be:\n", - "\n", - "$$\n", - "h_1(x,t) = (1-t)\\Big(u(x) - \\big((1-x)u(0) + x u(1)\\big)\\Big) = (1-t)u(x) = (1-t)\\sin(\\pi x)\n", - "$$\n", - "since $(0) = u(1) = 0$ and $u(x) = \\sin(\\pi x)$.\n", - "\n", - "\n", - "\n", - "The Jacobian is used because the program must find the derivative of\n", - "the trial solution with respect to $x$ and $t$.\n", - "\n", - "This gives the necessity of computing the Jacobian matrix, as we want\n", - "to evaluate the gradient with respect to $x$ and $t$ (note that the\n", - "Jacobian of a scalar-valued multivariate function is simply its\n", - "gradient).\n", - "\n", - "In Autograd, the differentiation is by default done with respect to\n", - "the first input argument of your Python function. Since the points is\n", - "an array representing $x$ and $t$, the Jacobian is calculated using\n", - "the values of $x$ and $t$.\n", - "\n", - "To find the second derivative with respect to $x$ and $t$, the\n", - "Jacobian can be found for the second time. The result is a Hessian\n", - "matrix, which is the matrix containing all the possible second order\n", - "mixed derivatives of $g(x,t)$." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "# Set up the trial function:\n", - "def u(x):\n", - " return np.sin(np.pi*x)\n", - "\n", - "def g_trial(point,P):\n", - " x,t = point\n", - " return (1-t)*u(x) + x*(1-x)*t*deep_neural_network(P,point)\n", - "\n", - "# The right side of the ODE:\n", - "def f(point):\n", - " return 0.\n", - "\n", - "# The cost function:\n", - "def cost_function(P, x, t):\n", - " cost_sum = 0\n", - "\n", - " g_t_jacobian_func = jacobian(g_trial)\n", - " g_t_hessian_func = hessian(g_trial)\n", - "\n", - " for x_ in x:\n", - " for t_ in t:\n", - " point = np.array([x_,t_])\n", - "\n", - " g_t = g_trial(point,P)\n", - " g_t_jacobian = g_t_jacobian_func(point,P)\n", - " g_t_hessian = g_t_hessian_func(point,P)\n", - "\n", - " g_t_dt = g_t_jacobian[1]\n", - " g_t_d2x = g_t_hessian[0][0]\n", - "\n", - " func = f(point)\n", - "\n", - " err_sqr = ( (g_t_dt - g_t_d2x) - func)**2\n", - " cost_sum += err_sqr\n", - "\n", - " return cost_sum" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "### Setting up the network using Autograd; The full program\n", - "\n", - "Having set up the network, along with the trial solution and cost function, we can now see how the deep neural network performs by comparing the results to the analytical solution.\n", - "\n", - "The analytical solution of our problem is\n", - "\n", - "$$\n", - "g(x,t) = \\exp(-\\pi^2 t)\\sin(\\pi x)\n", - "$$\n", - "\n", - "A possible way to implement a neural network solving the PDE, is given below.\n", - "Be aware, though, that it is fairly slow for the parameters used.\n", - "A better result is possible, but requires more iterations, and thus longer time to complete.\n", - "\n", - "\n", - "Indeed, the program below is not optimal in its implementation, but rather serves as an example on how to implement and use a neural network to solve a PDE.\n", - "Using TensorFlow results in a much better execution time. Try it!" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import autograd.numpy as np\n", - "from autograd import jacobian,hessian,grad\n", - "import autograd.numpy.random as npr\n", - "from matplotlib import cm\n", - "from matplotlib import pyplot as plt\n", - "from mpl_toolkits.mplot3d import axes3d\n", - "\n", - "## Set up the network\n", - "\n", - "def sigmoid(z):\n", - " return 1/(1 + np.exp(-z))\n", - "\n", - "def deep_neural_network(deep_params, x):\n", - " # x is now a point and a 1D numpy array; make it a column vector\n", - " num_coordinates = np.size(x,0)\n", - " x = x.reshape(num_coordinates,-1)\n", - "\n", - " num_points = np.size(x,1)\n", - "\n", - " # N_hidden is the number of hidden layers\n", - " N_hidden = np.size(deep_params) - 1 # -1 since params consist of parameters to all the hidden layers AND the output layer\n", - "\n", - " # Assume that the input layer does nothing to the input x\n", - " x_input = x\n", - " x_prev = x_input\n", - "\n", - " ## Hidden layers:\n", - "\n", - " for l in range(N_hidden):\n", - " # From the list of parameters P; find the correct weigths and bias for this layer\n", - " w_hidden = deep_params[l]\n", - "\n", - " # Add a row of ones to include bias\n", - " x_prev = np.concatenate((np.ones((1,num_points)), x_prev ), axis = 0)\n", - "\n", - " z_hidden = np.matmul(w_hidden, x_prev)\n", - " x_hidden = sigmoid(z_hidden)\n", - "\n", - " # Update x_prev such that next layer can use the output from this layer\n", - " x_prev = x_hidden\n", - "\n", - " ## Output layer:\n", - "\n", - " # Get the weights and bias for this layer\n", - " w_output = deep_params[-1]\n", - "\n", - " # Include bias:\n", - " x_prev = np.concatenate((np.ones((1,num_points)), x_prev), axis = 0)\n", - "\n", - " z_output = np.matmul(w_output, x_prev)\n", - " x_output = z_output\n", - "\n", - " return x_output[0][0]\n", - "\n", - "## Define the trial solution and cost function\n", - "def u(x):\n", - " return np.sin(np.pi*x)\n", - "\n", - "def g_trial(point,P):\n", - " x,t = point\n", - " return (1-t)*u(x) + x*(1-x)*t*deep_neural_network(P,point)\n", - "\n", - "# The right side of the ODE:\n", - "def f(point):\n", - " return 0.\n", - "\n", - "# The cost function:\n", - "def cost_function(P, x, t):\n", - " cost_sum = 0\n", - "\n", - " g_t_jacobian_func = jacobian(g_trial)\n", - " g_t_hessian_func = hessian(g_trial)\n", - "\n", - " for x_ in x:\n", - " for t_ in t:\n", - " point = np.array([x_,t_])\n", - "\n", - " g_t = g_trial(point,P)\n", - " g_t_jacobian = g_t_jacobian_func(point,P)\n", - " g_t_hessian = g_t_hessian_func(point,P)\n", - "\n", - " g_t_dt = g_t_jacobian[1]\n", - " g_t_d2x = g_t_hessian[0][0]\n", - "\n", - " func = f(point)\n", - "\n", - " err_sqr = ( (g_t_dt - g_t_d2x) - func)**2\n", - " cost_sum += err_sqr\n", - "\n", - " return cost_sum /( np.size(x)*np.size(t) )\n", - "\n", - "## For comparison, define the analytical solution\n", - "def g_analytic(point):\n", - " x,t = point\n", - " return np.exp(-np.pi**2*t)*np.sin(np.pi*x)\n", - "\n", - "## Set up a function for training the network to solve for the equation\n", - "def solve_pde_deep_neural_network(x,t, num_neurons, num_iter, lmb):\n", - " ## Set up initial weigths and biases\n", - " N_hidden = np.size(num_neurons)\n", - "\n", - " ## Set up initial weigths and biases\n", - "\n", - " # Initialize the list of parameters:\n", - " P = [None]*(N_hidden + 1) # + 1 to include the output layer\n", - "\n", - " P[0] = npr.randn(num_neurons[0], 2 + 1 ) # 2 since we have two points, +1 to include bias\n", - " for l in range(1,N_hidden):\n", - " P[l] = npr.randn(num_neurons[l], num_neurons[l-1] + 1) # +1 to include bias\n", - "\n", - " # For the output layer\n", - " P[-1] = npr.randn(1, num_neurons[-1] + 1 ) # +1 since bias is included\n", - "\n", - " print('Initial cost: ',cost_function(P, x, t))\n", - "\n", - " cost_function_grad = grad(cost_function,0)\n", - "\n", - " # Let the update be done num_iter times\n", - " for i in range(num_iter):\n", - " cost_grad = cost_function_grad(P, x , t)\n", - "\n", - " for l in range(N_hidden+1):\n", - " P[l] = P[l] - lmb * cost_grad[l]\n", - "\n", - " print('Final cost: ',cost_function(P, x, t))\n", - "\n", - " return P\n", - "\n", - "if __name__ == '__main__':\n", - " ### Use the neural network:\n", - " npr.seed(15)\n", - "\n", - " ## Decide the vales of arguments to the function to solve\n", - " Nx = 10; Nt = 10\n", - " x = np.linspace(0, 1, Nx)\n", - " t = np.linspace(0,1,Nt)\n", - "\n", - " ## Set up the parameters for the network\n", - " num_hidden_neurons = [100, 25]\n", - " num_iter = 250\n", - " lmb = 0.01\n", - "\n", - " P = solve_pde_deep_neural_network(x,t, num_hidden_neurons, num_iter, lmb)\n", - "\n", - " ## Store the results\n", - " g_dnn_ag = np.zeros((Nx, Nt))\n", - " G_analytical = np.zeros((Nx, Nt))\n", - " for i,x_ in enumerate(x):\n", - " for j, t_ in enumerate(t):\n", - " point = np.array([x_, t_])\n", - " g_dnn_ag[i,j] = g_trial(point,P)\n", - "\n", - " G_analytical[i,j] = g_analytic(point)\n", - "\n", - " # Find the map difference between the analytical and the computed solution\n", - " diff_ag = np.abs(g_dnn_ag - G_analytical)\n", - " print('Max absolute difference between the analytical solution and the network: %g'%np.max(diff_ag))\n", - "\n", - " ## Plot the solutions in two dimensions, that being in position and time\n", - "\n", - " T,X = np.meshgrid(t,x)\n", - "\n", - " fig = plt.figure(figsize=(10,10))\n", - " ax = fig.gca(projection='3d')\n", - " ax.set_title('Solution from the deep neural network w/ %d layer'%len(num_hidden_neurons))\n", - " s = ax.plot_surface(T,X,g_dnn_ag,linewidth=0,antialiased=False,cmap=cm.viridis)\n", - " ax.set_xlabel('Time $t$')\n", - " ax.set_ylabel('Position $x$');\n", - "\n", - "\n", - " fig = plt.figure(figsize=(10,10))\n", - " ax = fig.gca(projection='3d')\n", - " ax.set_title('Analytical solution')\n", - " s = ax.plot_surface(T,X,G_analytical,linewidth=0,antialiased=False,cmap=cm.viridis)\n", - " ax.set_xlabel('Time $t$')\n", - " ax.set_ylabel('Position $x$');\n", - "\n", - " fig = plt.figure(figsize=(10,10))\n", - " ax = fig.gca(projection='3d')\n", - " ax.set_title('Difference')\n", - " s = ax.plot_surface(T,X,diff_ag,linewidth=0,antialiased=False,cmap=cm.viridis)\n", - " ax.set_xlabel('Time $t$')\n", - " ax.set_ylabel('Position $x$');\n", - "\n", - " ## Take some slices of the 3D plots just to see the solutions at particular times\n", - " indx1 = 0\n", - " indx2 = int(Nt/2)\n", - " indx3 = Nt-1\n", - "\n", - " t1 = t[indx1]\n", - " t2 = t[indx2]\n", - " t3 = t[indx3]\n", - "\n", - " # Slice the results from the DNN\n", - " res1 = g_dnn_ag[:,indx1]\n", - " res2 = g_dnn_ag[:,indx2]\n", - " res3 = g_dnn_ag[:,indx3]\n", - "\n", - " # Slice the analytical results\n", - " res_analytical1 = G_analytical[:,indx1]\n", - " res_analytical2 = G_analytical[:,indx2]\n", - " res_analytical3 = G_analytical[:,indx3]\n", - "\n", - " # Plot the slices\n", - " plt.figure(figsize=(10,10))\n", - " plt.title(\"Computed solutions at time = %g\"%t1)\n", - " plt.plot(x, res1)\n", - " plt.plot(x,res_analytical1)\n", - " plt.legend(['dnn','analytical'])\n", - "\n", - " plt.figure(figsize=(10,10))\n", - " plt.title(\"Computed solutions at time = %g\"%t2)\n", - " plt.plot(x, res2)\n", - " plt.plot(x,res_analytical2)\n", - " plt.legend(['dnn','analytical'])\n", - "\n", - " plt.figure(figsize=(10,10))\n", - " plt.title(\"Computed solutions at time = %g\"%t3)\n", - " plt.plot(x, res3)\n", - " plt.plot(x,res_analytical3)\n", - " plt.legend(['dnn','analytical'])\n", - "\n", - " plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Solving the wave equation with Neural Networks\n", - "\n", - "The wave equation is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial^2 g(x,t)}{\\partial t^2} = c^2\\frac{\\partial^2 g(x,t)}{\\partial x^2}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with $c$ being the specified wave speed.\n", - "\n", - "Here, the chosen conditions are" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{align*}\n", - "\tg(0,t) &= 0 \\\\\n", - "\tg(1,t) &= 0 \\\\\n", - "\tg(x,0) &= u(x) \\\\\n", - "\t\\frac{\\partial g(x,t)}{\\partial t} \\Big |_{t = 0} &= v(x)\n", - "\\end{align*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $\\frac{\\partial g(x,t)}{\\partial t} \\Big |_{t = 0}$ means the derivative of $g(x,t)$ with respect to $t$ is evaluated at $t = 0$, and $u(x)$ and $v(x)$ being given functions.\n", - "\n", - "\n", - "The wave equation to solve for, is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation} \\label{wave} \\tag{19}\n", - "\\frac{\\partial^2 g(x,t)}{\\partial t^2} = c^2 \\frac{\\partial^2 g(x,t)}{\\partial x^2}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $c$ is the given wave speed.\n", - "The chosen conditions for this equation are" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{aligned}\n", - "g(0,t) &= 0, &t \\geq 0 \\\\\n", - "g(1,t) &= 0, &t \\geq 0 \\\\\n", - "g(x,0) &= u(x), &x\\in[0,1] \\\\\n", - "\\frac{\\partial g(x,t)}{\\partial t}\\Big |_{t = 0} &= v(x), &x \\in [0,1]\n", - "\\end{aligned} \\label{condwave} \\tag{20}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In this example, let $c = 1$ and $u(x) = \\sin(\\pi x)$ and $v(x) = -\\pi\\sin(\\pi x)$.\n", - "\n", - "\n", - "\n", - "Setting up the network is done in similar matter as for the example of solving the diffusion equation.\n", - "The only things we have to change, is the trial solution such that it satisfies the conditions from ([20](#condwave)) and the cost function.\n", - "\n", - "The trial solution becomes slightly different since we have other conditions than in the example of solving the diffusion equation. Here, a possible trial solution $g_t(x,t)$ is\n", - "\n", - "$$\n", - "g_t(x,t) = h_1(x,t) + x(1-x)t^2N(x,t,P)\n", - "$$\n", - "\n", - "where\n", - "\n", - "$$\n", - "h_1(x,t) = (1-t^2)u(x) + tv(x)\n", - "$$\n", - "\n", - "Note that this trial solution satisfies the conditions only if $u(0) = v(0) = u(1) = v(1) = 0$, which is the case in this example.\n", - "\n", - "\n", - "The analytical solution for our specific problem, is\n", - "\n", - "$$\n", - "g(x,t) = \\sin(\\pi x)\\cos(\\pi t) - \\sin(\\pi x)\\sin(\\pi t)\n", - "$$" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import autograd.numpy as np\n", - "from autograd import hessian,grad\n", - "import autograd.numpy.random as npr\n", - "from matplotlib import cm\n", - "from matplotlib import pyplot as plt\n", - "from mpl_toolkits.mplot3d import axes3d\n", - "\n", - "## Set up the trial function:\n", - "def u(x):\n", - " return np.sin(np.pi*x)\n", - "\n", - "def v(x):\n", - " return -np.pi*np.sin(np.pi*x)\n", - "\n", - "def h1(point):\n", - " x,t = point\n", - " return (1 - t**2)*u(x) + t*v(x)\n", - "\n", - "def g_trial(point,P):\n", - " x,t = point\n", - " return h1(point) + x*(1-x)*t**2*deep_neural_network(P,point)\n", - "\n", - "## Define the cost function\n", - "def cost_function(P, x, t):\n", - " cost_sum = 0\n", - "\n", - " g_t_hessian_func = hessian(g_trial)\n", - "\n", - " for x_ in x:\n", - " for t_ in t:\n", - " point = np.array([x_,t_])\n", - "\n", - " g_t_hessian = g_t_hessian_func(point,P)\n", - "\n", - " g_t_d2x = g_t_hessian[0][0]\n", - " g_t_d2t = g_t_hessian[1][1]\n", - "\n", - " err_sqr = ( (g_t_d2t - g_t_d2x) )**2\n", - " cost_sum += err_sqr\n", - "\n", - " return cost_sum / (np.size(t) * np.size(x))\n", - "\n", - "## The neural network\n", - "def sigmoid(z):\n", - " return 1/(1 + np.exp(-z))\n", - "\n", - "def deep_neural_network(deep_params, x):\n", - " # x is now a point and a 1D numpy array; make it a column vector\n", - " num_coordinates = np.size(x,0)\n", - " x = x.reshape(num_coordinates,-1)\n", - "\n", - " num_points = np.size(x,1)\n", - "\n", - " # N_hidden is the number of hidden layers\n", - " N_hidden = np.size(deep_params) - 1 # -1 since params consist of parameters to all the hidden layers AND the output layer\n", - "\n", - " # Assume that the input layer does nothing to the input x\n", - " x_input = x\n", - " x_prev = x_input\n", - "\n", - " ## Hidden layers:\n", - "\n", - " for l in range(N_hidden):\n", - " # From the list of parameters P; find the correct weigths and bias for this layer\n", - " w_hidden = deep_params[l]\n", - "\n", - " # Add a row of ones to include bias\n", - " x_prev = np.concatenate((np.ones((1,num_points)), x_prev ), axis = 0)\n", - "\n", - " z_hidden = np.matmul(w_hidden, x_prev)\n", - " x_hidden = sigmoid(z_hidden)\n", - "\n", - " # Update x_prev such that next layer can use the output from this layer\n", - " x_prev = x_hidden\n", - "\n", - " ## Output layer:\n", - "\n", - " # Get the weights and bias for this layer\n", - " w_output = deep_params[-1]\n", - "\n", - " # Include bias:\n", - " x_prev = np.concatenate((np.ones((1,num_points)), x_prev), axis = 0)\n", - "\n", - " z_output = np.matmul(w_output, x_prev)\n", - " x_output = z_output\n", - "\n", - " return x_output[0][0]\n", - "\n", - "## The analytical solution\n", - "def g_analytic(point):\n", - " x,t = point\n", - " return np.sin(np.pi*x)*np.cos(np.pi*t) - np.sin(np.pi*x)*np.sin(np.pi*t)\n", - "\n", - "def solve_pde_deep_neural_network(x,t, num_neurons, num_iter, lmb):\n", - " ## Set up initial weigths and biases\n", - " N_hidden = np.size(num_neurons)\n", - "\n", - " ## Set up initial weigths and biases\n", - "\n", - " # Initialize the list of parameters:\n", - " P = [None]*(N_hidden + 1) # + 1 to include the output layer\n", - "\n", - " P[0] = npr.randn(num_neurons[0], 2 + 1 ) # 2 since we have two points, +1 to include bias\n", - " for l in range(1,N_hidden):\n", - " P[l] = npr.randn(num_neurons[l], num_neurons[l-1] + 1) # +1 to include bias\n", - "\n", - " # For the output layer\n", - " P[-1] = npr.randn(1, num_neurons[-1] + 1 ) # +1 since bias is included\n", - "\n", - " print('Initial cost: ',cost_function(P, x, t))\n", - "\n", - " cost_function_grad = grad(cost_function,0)\n", - "\n", - " # Let the update be done num_iter times\n", - " for i in range(num_iter):\n", - " cost_grad = cost_function_grad(P, x , t)\n", - "\n", - " for l in range(N_hidden+1):\n", - " P[l] = P[l] - lmb * cost_grad[l]\n", - "\n", - "\n", - " print('Final cost: ',cost_function(P, x, t))\n", - "\n", - " return P\n", - "\n", - "if __name__ == '__main__':\n", - " ### Use the neural network:\n", - " npr.seed(15)\n", - "\n", - " ## Decide the vales of arguments to the function to solve\n", - " Nx = 10; Nt = 10\n", - " x = np.linspace(0, 1, Nx)\n", - " t = np.linspace(0,1,Nt)\n", - "\n", - " ## Set up the parameters for the network\n", - " num_hidden_neurons = [50,20]\n", - " num_iter = 1000\n", - " lmb = 0.01\n", - "\n", - " P = solve_pde_deep_neural_network(x,t, num_hidden_neurons, num_iter, lmb)\n", - "\n", - " ## Store the results\n", - " res = np.zeros((Nx, Nt))\n", - " res_analytical = np.zeros((Nx, Nt))\n", - " for i,x_ in enumerate(x):\n", - " for j, t_ in enumerate(t):\n", - " point = np.array([x_, t_])\n", - " res[i,j] = g_trial(point,P)\n", - "\n", - " res_analytical[i,j] = g_analytic(point)\n", - "\n", - " diff = np.abs(res - res_analytical)\n", - " print(\"Max difference between analytical and solution from nn: %g\"%np.max(diff))\n", - "\n", - " ## Plot the solutions in two dimensions, that being in position and time\n", - "\n", - " T,X = np.meshgrid(t,x)\n", - "\n", - " fig = plt.figure(figsize=(10,10))\n", - " ax = fig.gca(projection='3d')\n", - " ax.set_title('Solution from the deep neural network w/ %d layer'%len(num_hidden_neurons))\n", - " s = ax.plot_surface(T,X,res,linewidth=0,antialiased=False,cmap=cm.viridis)\n", - " ax.set_xlabel('Time $t$')\n", - " ax.set_ylabel('Position $x$');\n", - "\n", - "\n", - " fig = plt.figure(figsize=(10,10))\n", - " ax = fig.gca(projection='3d')\n", - " ax.set_title('Analytical solution')\n", - " s = ax.plot_surface(T,X,res_analytical,linewidth=0,antialiased=False,cmap=cm.viridis)\n", - " ax.set_xlabel('Time $t$')\n", - " ax.set_ylabel('Position $x$');\n", - "\n", - "\n", - " fig = plt.figure(figsize=(10,10))\n", - " ax = fig.gca(projection='3d')\n", - " ax.set_title('Difference')\n", - " s = ax.plot_surface(T,X,diff,linewidth=0,antialiased=False,cmap=cm.viridis)\n", - " ax.set_xlabel('Time $t$')\n", - " ax.set_ylabel('Position $x$');\n", - "\n", - " ## Take some slices of the 3D plots just to see the solutions at particular times\n", - " indx1 = 0\n", - " indx2 = int(Nt/2)\n", - " indx3 = Nt-1\n", - "\n", - " t1 = t[indx1]\n", - " t2 = t[indx2]\n", - " t3 = t[indx3]\n", - "\n", - " # Slice the results from the DNN\n", - " res1 = res[:,indx1]\n", - " res2 = res[:,indx2]\n", - " res3 = res[:,indx3]\n", - "\n", - " # Slice the analytical results\n", - " res_analytical1 = res_analytical[:,indx1]\n", - " res_analytical2 = res_analytical[:,indx2]\n", - " res_analytical3 = res_analytical[:,indx3]\n", - "\n", - " # Plot the slices\n", - " plt.figure(figsize=(10,10))\n", - " plt.title(\"Computed solutions at time = %g\"%t1)\n", - " plt.plot(x, res1)\n", - " plt.plot(x,res_analytical1)\n", - " plt.legend(['dnn','analytical'])\n", - "\n", - " plt.figure(figsize=(10,10))\n", - " plt.title(\"Computed solutions at time = %g\"%t2)\n", - " plt.plot(x, res2)\n", - " plt.plot(x,res_analytical2)\n", - " plt.legend(['dnn','analytical'])\n", - "\n", - " plt.figure(figsize=(10,10))\n", - " plt.title(\"Computed solutions at time = %g\"%t3)\n", - " plt.plot(x, res3)\n", - " plt.plot(x,res_analytical3)\n", - " plt.legend(['dnn','analytical'])\n", - "\n", - " plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Resources on differential equations and deep learning\n", - "\n", - "1. [Artificial neural networks for solving ordinary and partial differential equations by I.E. Lagaris et al](https://pdfs.semanticscholar.org/d061/df393e0e8fbfd0ea24976458b7d42419040d.pdf)\n", - "\n", - "2. [Neural networks for solving differential equations by A. Honchar](https://becominghuman.ai/neural-networks-for-solving-differential-equations-fa230ac5e04c)\n", - "\n", - "3. [Solving differential equations using neural networks by M.M Chiaramonte and M. Kiener](http://cs229.stanford.edu/proj2013/ChiaramonteKiener-SolvingDifferentialEquationsUsingNeuralNetworks.pdf)\n", - "\n", - "4. [Introduction to Partial Differential Equations by A. Tveito, R. Winther](https://www.springer.com/us/book/9783540225515)" - ] - } - ], - "metadata": {}, - "nbformat": 4, - "nbformat_minor": 4 -} diff --git a/doc/LectureNotes/_build/html/_sources/chapter2.ipynb b/doc/LectureNotes/_build/html/_sources/chapter2.ipynb deleted file mode 100644 index fc1dc3fa0..000000000 --- a/doc/LectureNotes/_build/html/_sources/chapter2.ipynb +++ /dev/null @@ -1,4403 +0,0 @@ -{ - "cells": [ - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "# Ridge and Lasso Regression\n", - "\n", - "\n", - "\n", - "## Mathematical Interpretation of Ordinary Least Squares\n", - "\n", - "What is presented here is a mathematical analysis of various regression algorithms (ordinary least squares, Ridge and Lasso Regression). The analysis is based on an important algorithm in linear algebra, the so-called Singular Value Decomposition (SVD). \n", - "\n", - "\n", - "We have shown that in ordinary least squares (OLS) the optimal parameters $\\beta$ are given by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\hat{\\boldsymbol{\\beta}}_{\\mathrm{OLS}} = \\left(\\boldsymbol{X}^T\\boldsymbol{X}\\right)^{-1}\\boldsymbol{X}^T\\boldsymbol{y}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The **hat** over $\\boldsymbol{\\beta}$ means we have the optimal parameters after minimization of the cost function.\n", - "\n", - "This means that our best model is defined as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\tilde{\\boldsymbol{y}}=\\boldsymbol{X}\\hat{\\boldsymbol{\\beta}} = \\boldsymbol{X}\\left(\\boldsymbol{X}^T\\boldsymbol{X}\\right)^{-1}\\boldsymbol{X}^T\\boldsymbol{y}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We now define a matrix" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{A}=\\boldsymbol{X}\\left(\\boldsymbol{X}^T\\boldsymbol{X}\\right)^{-1}\\boldsymbol{X}^T.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We can rewrite" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\tilde{\\boldsymbol{y}}=\\boldsymbol{X}\\hat{\\boldsymbol{\\beta}} = \\boldsymbol{A}\\boldsymbol{y}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The matrix $\\boldsymbol{A}$ has the important property that $\\boldsymbol{A}^2=\\boldsymbol{A}$. This is the definition of a [projection matrix](https://en.wikipedia.org/wiki/Projection_matrix).\n", - "We can then interpret our optimal model $\\tilde{\\boldsymbol{y}}$ as being represented by an orthogonal projection of $\\boldsymbol{y}$ onto a space defined by the column vectors of $\\boldsymbol{X}$. In our case here the matrix $\\boldsymbol{A}$ is a square matrix. If it is a general rectangular matrix we have an oblique projection matrix.\n", - "\n", - "\n", - "\n", - "\n", - "We have defined the residual error as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{\\epsilon}=\\boldsymbol{y}-\\tilde{\\boldsymbol{y}}=\\left[\\boldsymbol{I}-\\boldsymbol{X}\\left(\\boldsymbol{X}^T\\boldsymbol{X}\\right)^{-1}\\boldsymbol{X}^T\\right]\\boldsymbol{y}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The residual errors are then the projections of $\\boldsymbol{y}$ onto the orthogonal component of the space defined by the column vectors of $\\boldsymbol{X}$.\n", - "\n", - "\n", - "If the matrix $\\boldsymbol{X}$ is an orthogonal (or unitary in case of complex values) matrix, we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}^T\\boldsymbol{X}=\\boldsymbol{X}\\boldsymbol{X}^T = \\boldsymbol{I}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In this case the matrix $\\boldsymbol{A}$ becomes" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{A}=\\boldsymbol{X}\\left(\\boldsymbol{X}^T\\boldsymbol{X}\\right)^{-1}\\boldsymbol{X}^T)=\\boldsymbol{I},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and we have the obvious case" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{\\epsilon}=\\boldsymbol{y}-\\tilde{\\boldsymbol{y}}=0.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "This serves also as a useful test of our codes. \n", - "\n", - "\n", - "\n", - "\n", - "## The singular value decomposition\n", - "\n", - "\n", - "The examples we have looked at so far are cases where we normally can\n", - "invert the matrix $\\boldsymbol{X}^T\\boldsymbol{X}$. Using a polynomial expansion where we fit of various functions leads to\n", - "row vectors of the design matrix which are essentially orthogonal due\n", - "to the polynomial character of our model. Obtaining the inverse of the\n", - "design matrix is then often done via a so-called LU, QR or Cholesky\n", - "decomposition.\n", - "\n", - "\n", - "As we will also see in the first project, \n", - "this may\n", - "however not the be case in general and a standard matrix inversion\n", - "algorithm based on say LU, QR or Cholesky decomposition may lead to singularities. We will see examples of this below.\n", - "\n", - "There is however a way to circumvent this problem and also\n", - "gain some insights about the ordinary least squares approach, and\n", - "later shrinkage methods like Ridge and Lasso regressions.\n", - "\n", - "This is given by the **Singular Value Decomposition** (SVD) algorithm,\n", - "perhaps the most powerful linear algebra algorithm. The SVD provides\n", - "a numerically stable matrix decomposition that is used in a large\n", - "swath oc applications and the decomposition is always stable\n", - "numerically.\n", - "\n", - "In machine learning it plays a central role in dealing with for\n", - "example design matrices that may be near singular or singular.\n", - "Furthermore, as we will see here, the singular values can be related\n", - "to the covariance matrix (and thereby the correlation matrix) and in\n", - "turn the variance of a given quantity. It plays also an important role\n", - "in the principal component analysis where high-dimensional data can be\n", - "reduced to the statistically relevant features.\n", - "\n", - "\n", - "\n", - "\n", - "One of the typical problems we encounter with linear regression, in particular \n", - "when the matrix $\\boldsymbol{X}$ (our so-called design matrix) is high-dimensional, \n", - "are problems with near singular or singular matrices. The column vectors of $\\boldsymbol{X}$ \n", - "may be linearly dependent, normally referred to as super-collinearity. \n", - "This means that the matrix may be rank deficient and it is basically impossible to \n", - "to model the data using linear regression. As an example, consider the matrix" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{align*}\n", - "\\mathbf{X} & = \\left[\n", - "\\begin{array}{rrr}\n", - "1 & -1 & 2\n", - "\\\\\n", - "1 & 0 & 1\n", - "\\\\\n", - "1 & 2 & -1\n", - "\\\\\n", - "1 & 1 & 0\n", - "\\end{array} \\right]\n", - "\\end{align*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The columns of $\\boldsymbol{X}$ are linearly dependent. We see this easily since the \n", - "the first column is the row-wise sum of the other two columns. The rank (more correct,\n", - "the column rank) of a matrix is the dimension of the space spanned by the\n", - "column vectors. Hence, the rank of $\\mathbf{X}$ is equal to the number\n", - "of linearly independent columns. In this particular case the matrix has rank 2.\n", - "\n", - "Super-collinearity of an $(n \\times p)$-dimensional design matrix $\\mathbf{X}$ implies\n", - "that the inverse of the matrix $\\boldsymbol{X}^T\\boldsymbol{X}$ (the matrix we need to invert to solve the linear regression equations) is non-invertible. If we have a square matrix that does not have an inverse, we say this matrix singular. The example here demonstrates this" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{align*}\n", - "\\boldsymbol{X} & = \\left[\n", - "\\begin{array}{rr}\n", - "1 & -1\n", - "\\\\\n", - "1 & -1\n", - "\\end{array} \\right].\n", - "\\end{align*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We see easily that $\\mbox{det}(\\boldsymbol{X}) = x_{11} x_{22} - x_{12} x_{21} = 1 \\times (-1) - 1 \\times (-1) = 0$. Hence, $\\mathbf{X}$ is singular and its inverse is undefined.\n", - "This is equivalent to saying that the matrix $\\boldsymbol{X}$ has at least an eigenvalue which is zero.\n", - "\n", - "\n", - "\n", - "If our design matrix $\\boldsymbol{X}$ which enters the linear regression problem" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - "\\boldsymbol{\\beta} = (\\boldsymbol{X}^{T} \\boldsymbol{X})^{-1} \\boldsymbol{X}^{T} \\boldsymbol{y},\n", - "\\label{_auto1} \\tag{1}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "has linearly dependent column vectors, we will not be able to compute the inverse\n", - "of $\\boldsymbol{X}^T\\boldsymbol{X}$ and we cannot find the parameters (estimators) $\\beta_i$. \n", - "The estimators are only well-defined if $(\\boldsymbol{X}^{T}\\boldsymbol{X})^{-1}$ exits. \n", - "This is more likely to happen when the matrix $\\boldsymbol{X}$ is high-dimensional. In this case it is likely to encounter a situation where \n", - "the regression parameters $\\beta_i$ cannot be estimated.\n", - "\n", - "A cheap *ad hoc* approach is simply to add a small diagonal component to the matrix to invert, that is we change" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}^{T} \\boldsymbol{X} \\rightarrow \\boldsymbol{X}^{T} \\boldsymbol{X}+\\lambda \\boldsymbol{I},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $\\boldsymbol{I}$ is the identity matrix. When we discuss **Ridge** regression this is actually what we end up evaluating. The parameter $\\lambda$ is called a hyperparameter. More about this later. \n", - "\n", - "\n", - "\n", - "\n", - "## Basic math of the SVD\n", - "\n", - "\n", - "From standard linear algebra we know that a square matrix $\\boldsymbol{X}$ can be diagonalized if and only it is \n", - "a so-called [normal matrix](https://en.wikipedia.org/wiki/Normal_matrix), that is if $\\boldsymbol{X}\\in {\\mathbb{R}}^{n\\times n}$\n", - "we have $\\boldsymbol{X}\\boldsymbol{X}^T=\\boldsymbol{X}^T\\boldsymbol{X}$ or if $\\boldsymbol{X}\\in {\\mathbb{C}}^{n\\times n}$ we have $\\boldsymbol{X}\\boldsymbol{X}^{\\dagger}=\\boldsymbol{X}^{\\dagger}\\boldsymbol{X}$.\n", - "The matrix has then a set of eigenpairs" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "(\\lambda_1,\\boldsymbol{u}_1),\\dots, (\\lambda_n,\\boldsymbol{u}_n),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and the eigenvalues are given by the diagonal matrix" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{\\Sigma}=\\mathrm{Diag}(\\lambda_1, \\dots,\\lambda_n).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The matrix $\\boldsymbol{X}$ can be written in terms of an orthogonal/unitary transformation $\\boldsymbol{U}$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X} = \\boldsymbol{U}\\boldsymbol{\\Sigma}\\boldsymbol{V}^T,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with $\\boldsymbol{U}\\boldsymbol{U}^T=\\boldsymbol{I}$ or $\\boldsymbol{U}\\boldsymbol{U}^{\\dagger}=\\boldsymbol{I}$.\n", - "\n", - "Not all square matrices are diagonalizable. A matrix like the one discussed above" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X} = \\begin{bmatrix} \n", - "1& -1 \\\\\n", - "1& -1\\\\\n", - "\\end{bmatrix}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "is not diagonalizable, it is a so-called [defective matrix](https://en.wikipedia.org/wiki/Defective_matrix). It is easy to see that the condition\n", - "$\\boldsymbol{X}\\boldsymbol{X}^T=\\boldsymbol{X}^T\\boldsymbol{X}$ is not fulfilled. \n", - "\n", - "\n", - "\n", - "\n", - "\n", - "However, and this is the strength of the SVD algorithm, any general\n", - "matrix $\\boldsymbol{X}$ can be decomposed in terms of a diagonal matrix and\n", - "two orthogonal/unitary matrices. The [Singular Value Decompostion\n", - "(SVD) theorem](https://en.wikipedia.org/wiki/Singular_value_decomposition)\n", - "states that a general $m\\times n$ matrix $\\boldsymbol{X}$ can be written in\n", - "terms of a diagonal matrix $\\boldsymbol{\\Sigma}$ of dimensionality $m\\times n$\n", - "and two orthognal matrices $\\boldsymbol{U}$ and $\\boldsymbol{V}$, where the first has\n", - "dimensionality $m \\times m$ and the last dimensionality $n\\times n$.\n", - "We have then" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X} = \\boldsymbol{U}\\boldsymbol{\\Sigma}\\boldsymbol{V}^T\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "As an example, the above defective matrix can be decomposed as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X} = \\frac{1}{\\sqrt{2}}\\begin{bmatrix} 1& 1 \\\\ 1& -1\\\\ \\end{bmatrix} \\begin{bmatrix} 2& 0 \\\\ 0& 0\\\\ \\end{bmatrix} \\frac{1}{\\sqrt{2}}\\begin{bmatrix} 1& -1 \\\\ 1& 1\\\\ \\end{bmatrix}=\\boldsymbol{U}\\boldsymbol{\\Sigma}\\boldsymbol{V}^T,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with eigenvalues $\\sigma_1=2$ and $\\sigma_2=0$. \n", - "The SVD exits always! \n", - "\n", - "The SVD\n", - "decomposition (singular values) gives eigenvalues \n", - "$\\sigma_i\\geq\\sigma_{i+1}$ for all $i$ and for dimensions larger than $i=p$, the\n", - "eigenvalues (singular values) are zero.\n", - "\n", - "In the general case, where our design matrix $\\boldsymbol{X}$ has dimension\n", - "$n\\times p$, the matrix is thus decomposed into an $n\\times n$\n", - "orthogonal matrix $\\boldsymbol{U}$, a $p\\times p$ orthogonal matrix $\\boldsymbol{V}$\n", - "and a diagonal matrix $\\boldsymbol{\\Sigma}$ with $r=\\mathrm{min}(n,p)$\n", - "singular values $\\sigma_i\\geq 0$ on the main diagonal and zeros filling\n", - "the rest of the matrix. There are at most $p$ singular values\n", - "assuming that $n > p$. In our regression examples for the nuclear\n", - "masses and the equation of state this is indeed the case, while for\n", - "the Ising model we have $p > n$. These are often cases that lead to\n", - "near singular or singular matrices.\n", - "\n", - "The columns of $\\boldsymbol{U}$ are called the left singular vectors while the columns of $\\boldsymbol{V}$ are the right singular vectors.\n", - "\n", - "\n", - "If we assume that $n > p$, then our matrix $\\boldsymbol{U}$ has dimension $n\n", - "\\times n$. The last $n-p$ columns of $\\boldsymbol{U}$ become however\n", - "irrelevant in our calculations since they are multiplied with the\n", - "zeros in $\\boldsymbol{\\Sigma}$.\n", - "\n", - "The economy-size decomposition removes extra rows or columns of zeros\n", - "from the diagonal matrix of singular values, $\\boldsymbol{\\Sigma}$, along with the columns\n", - "in either $\\boldsymbol{U}$ or $\\boldsymbol{V}$ that multiply those zeros in the expression. \n", - "Removing these zeros and columns can improve execution time\n", - "and reduce storage requirements without compromising the accuracy of\n", - "the decomposition.\n", - "\n", - "If $n > p$, we keep only the first $p$ columns of $\\boldsymbol{U}$ and $\\boldsymbol{\\Sigma}$ has dimension $p\\times p$. \n", - "If $p > n$, then only the first $n$ columns of $\\boldsymbol{V}$ are computed and $\\boldsymbol{\\Sigma}$ has dimension $n\\times n$.\n", - "The $n=p$ case is obvious, we retain the full SVD. \n", - "In general the economy-size SVD leads to less FLOPS and still conserving the desired accuracy.\n", - "\n", - "## Codes for the SVD" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import numpy as np\n", - "# SVD inversion\n", - "def SVD(A):\n", - " ''' Takes as input a numpy matrix A and returns inv(A) based on singular value decomposition (SVD).\n", - " SVD is numerically more stable than the inversion algorithms provided by\n", - " numpy and scipy.linalg at the cost of being slower.\n", - " '''\n", - " U, S, VT = np.linalg.svd(A,full_matrices=True)\n", - " print('test U')\n", - " print( (np.transpose(U) @ U - U @np.transpose(U)))\n", - " print('test VT')\n", - " print( (np.transpose(VT) @ VT - VT @np.transpose(VT)))\n", - " print(U)\n", - " print(S)\n", - " print(VT)\n", - "\n", - " D = np.zeros((len(U),len(VT)))\n", - " for i in range(0,len(VT)):\n", - " D[i,i]=S[i]\n", - " return U @ D @ VT\n", - "\n", - "\n", - "X = np.array([ [1.0,-1.0], [1.0,-1.0]])\n", - "#X = np.array([[1, 2], [3, 4], [5, 6]])\n", - "\n", - "print(X)\n", - "C = SVD(X)\n", - "# Print the difference between the original matrix and the SVD one\n", - "print(C-X)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The matrix $\\boldsymbol{X}$ has columns that are linearly dependent. The first\n", - "column is the row-wise sum of the other two columns. The rank of a\n", - "matrix (the column rank) is the dimension of space spanned by the\n", - "column vectors. The rank of the matrix is the number of linearly\n", - "independent columns, in this case just $2$. We see this from the\n", - "singular values when running the above code. Running the standard\n", - "inversion algorithm for matrix inversion with $\\boldsymbol{X}^T\\boldsymbol{X}$ results\n", - "in the program terminating due to a singular matrix.\n", - "\n", - "\n", - "\n", - "The $U$, $S$, and $V$ matrices returned from the **svd()** function\n", - "cannot be multiplied directly.\n", - "\n", - "As you can see from the code, the $S$ vector must be converted into a\n", - "diagonal matrix. This may cause a problem as the size of the matrices\n", - "do not fit the rules of matrix multiplication, where the number of\n", - "columns in a matrix must match the number of rows in the subsequent\n", - "matrix.\n", - "\n", - "If you wish to include the zero singular values, you will need to\n", - "resize the matrices and set up a diagonal matrix as done in the above\n", - "example\n", - "\n", - "\n", - "## Code for SVD and Inversion of Matrices\n", - "\n", - "How do we use the SVD to invert a matrix $\\boldsymbol{X}^T\\boldsymbol{X}$ which is singular or near singular?\n", - "The simple answer is to use the linear algebra function for the pseudoinverse, that is" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "#Ainv = np.linlag.pinv(A)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Let us first look at a matrix which does not causes problems and write our own function where we just use the SVD." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import numpy as np\n", - "# SVD inversion\n", - "def SVDinv(A):\n", - " ''' Takes as input a numpy matrix A and returns inv(A) based on singular value decomposition (SVD).\n", - " SVD is numerically more stable than the inversion algorithms provided by\n", - " numpy and scipy.linalg at the cost of being slower.\n", - " '''\n", - " U, s, VT = np.linalg.svd(A)\n", - " print('test U')\n", - " print( (np.transpose(U) @ U - U @np.transpose(U)))\n", - " print('test VT')\n", - " print( (np.transpose(VT) @ VT - VT @np.transpose(VT)))\n", - "\n", - "\n", - " D = np.zeros((len(U),len(VT)))\n", - " D = np.diag(s)\n", - " UT = np.transpose(U); V = np.transpose(VT); invD = np.linalg.inv(D)\n", - " return np.matmul(V,np.matmul(invD,UT))\n", - "\n", - "\n", - "#X = np.array([ [1.0, -1.0, 2.0], [1.0, 0.0, 1.0], [1.0, 2.0, -1.0], [1.0, 1.0, 0.0] ])\n", - "# Non-singular square matrix\n", - "X = np.array( [ [1,2,3],[2,4,5],[3,5,6]])\n", - "print(X)\n", - "A = np.transpose(X) @ X\n", - "# Brute force inversion\n", - "B = np.linalg.pinv(A) # here we could use np.linalg.inv(A), try it!\n", - "C = SVDinv(A)\n", - "print(np.abs(B-C))" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Although our matrix to invert $\\boldsymbol{X}^T\\boldsymbol{X}$ is a square matrix, our matrix may be singular. \n", - "\n", - "The pseudoinverse is the generalization of the matrix inverse for square matrices to\n", - "rectangular matrices where the number of rows and columns are not equal.\n", - "\n", - "It is also called the the Moore-Penrose Inverse after two independent discoverers of the method or the Generalized Inverse.\n", - "It is used for the calculation of the inverse for singular or near singular matrices and for rectangular matrices.\n", - "\n", - "Using the SVD we can obtain the pseudoinverse of a matrix $\\boldsymbol{A}$ (labeled here as $\\boldsymbol{A}_{\\mathrm{PI}}$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{A}_{\\mathrm{PI}}= \\boldsymbol{V}\\boldsymbol{D}_{\\mathrm{PI}}\\boldsymbol{U}^T,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $\\boldsymbol{D}_{\\mathrm{PI}}$ can be calculated by creating a diagonal matrix from $\\boldsymbol{Sigma}$ where we only keep the singular values (the non-zero values). The following code computes the pseudoinvers of the matrix based on the SVD." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import numpy as np\n", - "# SVD inversion\n", - "def SVDinv(A):\n", - " U, s, VT = np.linalg.svd(A)\n", - " # reciprocals of singular values of s\n", - " d = 1.0 / s\n", - " # create m x n D matrix\n", - " D = np.zeros(A.shape)\n", - " # populate D with n x n diagonal matrix\n", - " D[:A.shape[1], :A.shape[1]] = np.diag(d)\n", - " UT = np.transpose(U)\n", - " V = np.transpose(VT)\n", - " return np.matmul(V,np.matmul(D.T,UT))\n", - "\n", - "\n", - "A = np.array([ [0.3, 0.4], [0.5, 0.6], [0.7, 0.8],[0.9, 1.0]])\n", - "print(A)\n", - "# Brute force inversion of super-collinear matrix\n", - "B = np.linalg.pinv(A)\n", - "print(B)\n", - "# Compare our own algorithm with pinv\n", - "C = SVDinv(A)\n", - "print(np.abs(C-B))" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "As you can see from these examples, our own decomposition based on the SVD agrees the pseudoinverse algorithm provided by **Numpy**.\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "## Mathematics of the SVD and implications\n", - "\n", - "Let us take a closer look at the mathematics of the SVD and the various implications for machine learning studies.\n", - "\n", - "Our starting point is our design matrix $\\boldsymbol{X}$ of dimension $n\\times p$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}=\\begin{bmatrix}\n", - "x_{0,0} & x_{0,1} & x_{0,2}& \\dots & \\dots x_{0,p-1}\\\\\n", - "x_{1,0} & x_{1,1} & x_{1,2}& \\dots & \\dots x_{1,p-1}\\\\\n", - "x_{2,0} & x_{2,1} & x_{2,2}& \\dots & \\dots x_{2,p-1}\\\\\n", - "\\dots & \\dots & \\dots & \\dots \\dots & \\dots \\\\\n", - "x_{n-2,0} & x_{n-2,1} & x_{n-2,2}& \\dots & \\dots x_{n-2,p-1}\\\\\n", - "x_{n-1,0} & x_{n-1,1} & x_{n-1,2}& \\dots & \\dots x_{n-1,p-1}\\\\\n", - "\\end{bmatrix}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We can SVD decompose our matrix as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}=\\boldsymbol{U}\\boldsymbol{\\Sigma}\\boldsymbol{V}^T,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $\\boldsymbol{U}$ is an orthogonal matrix of dimension $n\\times n$, meaning that $\\boldsymbol{U}\\boldsymbol{U}^T=\\boldsymbol{U}^T\\boldsymbol{U}=\\boldsymbol{I}_n$. Here $\\boldsymbol{I}_n$ is the unit matrix of dimension $n \\times n$.\n", - "\n", - "Similarly, $\\boldsymbol{V}$ is an orthogonal matrix of dimension $p\\times p$, meaning that $\\boldsymbol{V}\\boldsymbol{V}^T=\\boldsymbol{V}^T\\boldsymbol{V}=\\boldsymbol{I}_p$. Here $\\boldsymbol{I}_n$ is the unit matrix of dimension $p \\times p$.\n", - "\n", - "Finally $\\boldsymbol{\\Sigma}$ contains the singular values $\\sigma_i$. This matrix has dimension $n\\times p$ and the singular values $\\sigma_i$ are all positive. The non-zero values are ordered in descending order, that is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\sigma_0 > \\sigma_1 > \\sigma_2 > \\dots > \\sigma_{p-1} > 0.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "All values beyond $p-1$ are all zero.\n", - "\n", - "\n", - "As an example, consider the following $3\\times 2$ example for the matrix $\\boldsymbol{\\Sigma}$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{\\Sigma}=\n", - "\\begin{bmatrix}\n", - "2& 0 \\\\\n", - "0 & 1 \\\\\n", - "0 & 0 \\\\\n", - "\\end{bmatrix}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The singular values are $\\sigma_0=2$ and $\\sigma_1=1$. It is common to rewrite the matrix $\\boldsymbol{\\Sigma}$ as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{\\Sigma}=\n", - "\\begin{bmatrix}\n", - "\\boldsymbol{\\tilde{\\Sigma}}\\\\\n", - "\\boldsymbol{0}\\\\\n", - "\\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{\\tilde{\\Sigma}}=\n", - "\\begin{bmatrix}\n", - "2& 0 \\\\\n", - "0 & 1 \\\\\n", - "\\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "contains only the singular values. Note also (and we will use this below) that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{\\Sigma}^T\\boldsymbol{\\Sigma}=\n", - "\\begin{bmatrix}\n", - "4& 0 \\\\\n", - "0 & 1 \\\\\n", - "\\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which is a $2\\times 2 $ matrix while" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{\\Sigma}\\boldsymbol{\\Sigma}^T=\n", - "\\begin{bmatrix}\n", - "4& 0 & 0\\\\\n", - "0 & 1 & 0\\\\\n", - "0 & 0 & 0\\\\\n", - "\\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "is a $3\\times 3 $ matrix. The last row and column of this last matrix\n", - "contain only zeros. This will have important consequences for our SVD\n", - "decomposition of the design matrix.\n", - "\n", - "\n", - "\n", - "The matrix that may cause problems for us is $\\boldsymbol{X}^T\\boldsymbol{X}$. Using the SVD we can rewrite this matrix as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}^T\\boldsymbol{X}=\\boldsymbol{V}\\boldsymbol{\\Sigma}^T\\boldsymbol{U}^T\\boldsymbol{U}\\boldsymbol{\\Sigma}\\boldsymbol{V}^T,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and using the orthogonality of the matrix $\\boldsymbol{U}$ we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}^T\\boldsymbol{X}=\\boldsymbol{V}\\boldsymbol{\\Sigma}^T\\boldsymbol{\\Sigma}\\boldsymbol{V}^T.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We define $\\boldsymbol{\\Sigma}^T\\boldsymbol{\\Sigma}=\\tilde{\\boldsymbol{\\Sigma}}^2$ which is a diagonal matrix containing only the singular values squared. It has dimensionality $p \\times p$.\n", - "\n", - "This means, using the orthogonality of $\\boldsymbol{V}$, that we get" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}^T\\boldsymbol{X}=\\tilde{\\boldsymbol{\\Sigma}}^2.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We can now insert the result for the matrix $\\boldsymbol{X}^T\\boldsymbol{X}$ into our equation for ordinary least squares where" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\tilde{y}_{\\mathrm{OLS}}=\\boldsymbol{X}\\left(\\boldsymbol{X}^T\\boldsymbol{X}\\right)^{-1}\\boldsymbol{X}^T\\boldsymbol{y},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and using our SVD decomposition of $\\boldsymbol{X}$ we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\tilde{y}_{\\mathrm{OLS}}=\\boldsymbol{U}\\boldsymbol{\\Sigma}\\boldsymbol{V}^T\\tilde{\\boldsymbol{\\Sigma}}^{-2}\\boldsymbol{V}\\boldsymbol{\\Sigma}^T\\boldsymbol{U}^T\\boldsymbol{y},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which gives us, using the orthogonality of the matrices $\\boldsymbol{U}$ and $\\boldsymbol{V}$," - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\tilde{y}_{\\mathrm{OLS}}=\\boldsymbol{U}\\boldsymbol{U}^T\\boldsymbol{y}=\\sum_{i=0}^{p-1}\\boldsymbol{u}_i\\boldsymbol{u}^T_j\\boldsymbol{y},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Note here that when we perform the multiplication of the various matrices, the orthogonal vectors of the matrix $\\boldsymbol{U}$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{U}=[\\boldsymbol{u}_0,\\boldsymbol{u}_1,\\dots,\\boldsymbol{u}_{n-1}],\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "that belong to $i>p-1$, result in only zeros when we perform the multiplications. This means that the sum above has non-zero elements only up to $i=p-1$. This corresponds also to the number of singular values (these are all non-zero).\n", - "\n", - "It means that the ordinary least square model (with the optimal parameters) $\\boldsymbol{\\tilde{y}}$, corresponds to an orthogonal transformation of the output (or target) vector $\\boldsymbol{y}$ by the vectors of the matrix $\\boldsymbol{U}$.\n", - "\n", - "\n", - "## Further properties (important for our analyses later)\n", - "\n", - "Let us study again $\\boldsymbol{X}^T\\boldsymbol{X}$ in terms of our SVD," - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}^T\\boldsymbol{X}=\\boldsymbol{V}\\boldsymbol{\\Sigma}^T\\boldsymbol{U}^T\\boldsymbol{U}\\boldsymbol{\\Sigma}\\boldsymbol{V}^T=\\boldsymbol{V}\\boldsymbol{\\Sigma}^T\\boldsymbol{\\Sigma}\\boldsymbol{V}^T.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "If we now multiply from the right with $\\boldsymbol{V}$ (using the orthogonality of $\\boldsymbol{V}$) we get" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\left(\\boldsymbol{X}^T\\boldsymbol{X}\\right)\\boldsymbol{V}=\\boldsymbol{V}\\boldsymbol{\\Sigma}^T\\boldsymbol{\\Sigma}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "This means the vectors $\\boldsymbol{v}_i$ of the orthogonal matrix $\\boldsymbol{V}$ are the eigenvectors of the matrix $\\boldsymbol{X}^T\\boldsymbol{X}$\n", - "with eigenvalues given by the singular values squared, that is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\left(\\boldsymbol{X}^T\\boldsymbol{X}\\right)\\boldsymbol{v}_i=\\boldsymbol{v}_i\\sigma_i^2.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Similarly, if we use the SVD decomposition for the matrix $\\boldsymbol{X}\\boldsymbol{X}^T$, we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}\\boldsymbol{X}^T=\\boldsymbol{U}\\boldsymbol{\\Sigma}\\boldsymbol{V}^T\\boldsymbol{V}\\boldsymbol{\\Sigma}^T\\boldsymbol{U}^T=\\boldsymbol{U}\\boldsymbol{\\Sigma}\\boldsymbol{\\Sigma}^T\\boldsymbol{U}^T.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "If we now multiply from the right with $\\boldsymbol{U}$ (using the orthogonality of $\\boldsymbol{U}$) we get" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\left(\\boldsymbol{X}\\boldsymbol{X}^T\\right)\\boldsymbol{U}=\\boldsymbol{U}\\boldsymbol{\\Sigma}\\boldsymbol{\\Sigma}^T.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "This means the vectors $\\boldsymbol{u}_i$ of the orthogonal matrix $\\boldsymbol{U}$ are the eigenvectors of the matrix $\\boldsymbol{X}\\boldsymbol{X}^T$\n", - "with eigenvalues given by the singular values squared, that is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\left(\\boldsymbol{X}\\boldsymbol{X}^T\\right)\\boldsymbol{u}_i=\\boldsymbol{u}_i\\sigma_i^2.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "**Important note**: we have defined our design matrix $\\boldsymbol{X}$ to be an\n", - "$n\\times p$ matrix. In most supervised learning cases we have that $n\n", - "\\ge p$, and quite often we have $n >> p$. For linear algebra based methods like ordinary least squares or Ridge regression, this leads to a matrix $\\boldsymbol{X}^T\\boldsymbol{X}$ which is small and thereby easier to handle from a computational point of view (in terms of number of floating point operations).\n", - "\n", - "In our lectures, the number of columns will\n", - "always refer to the number of features in our data set, while the\n", - "number of rows represents the number of data inputs. Note that in\n", - "other texts you may find the opposite notation. This has consequences\n", - "for the definition of for example the covariance matrix and its relation to the SVD.\n", - "\n", - "\n", - "## Meet the Covariance Matrix\n", - "\n", - "\n", - "Before we move on to a discussion of Ridge and Lasso regression, we want to show an important example of the above.\n", - "\n", - "We have already noted that the matrix $\\boldsymbol{X}^T\\boldsymbol{X}$ in ordinary\n", - "least squares is proportional to the second derivative of the cost\n", - "function, that is we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial^2 C(\\boldsymbol{\\beta})}{\\partial \\boldsymbol{\\beta}^T\\partial \\boldsymbol{\\beta}} =\\frac{2}{n}\\boldsymbol{X}^T\\boldsymbol{X}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "This quantity defines was what is called the Hessian matrix (the second derivative of a function we want to optimize).\n", - "\n", - "The Hessian matrix plays an important role and is defined in this course as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{H}=\\boldsymbol{X}^T\\boldsymbol{X}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The Hessian matrix for ordinary least squares is also proportional to\n", - "the covariance matrix. This means also that we can use the SVD to find\n", - "the eigenvalues of the covariance matrix and the Hessian matrix in\n", - "terms of the singular values. Let us develop these arguments, as they will play an important role in our machine learning studies.\n", - "\n", - "\n", - "\n", - "Before we discuss the link between for example Ridge regression and the singular value decomposition, we need to remind ourselves about\n", - "the definition of the covariance and the correlation function. These are quantities that play a central role in machine learning methods.\n", - "\n", - "Suppose we have defined two vectors\n", - "$\\hat{x}$ and $\\hat{y}$ with $n$ elements each. The covariance matrix $\\boldsymbol{C}$ is defined as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{C}[\\boldsymbol{x},\\boldsymbol{y}] = \\begin{bmatrix} \\mathrm{cov}[\\boldsymbol{x},\\boldsymbol{x}] & \\mathrm{cov}[\\boldsymbol{x},\\boldsymbol{y}] \\\\\n", - " \\mathrm{cov}[\\boldsymbol{y},\\boldsymbol{x}] & \\mathrm{cov}[\\boldsymbol{y},\\boldsymbol{y}] \\\\\n", - " \\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where for example" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathrm{cov}[\\boldsymbol{x},\\boldsymbol{y}] =\\frac{1}{n} \\sum_{i=0}^{n-1}(x_i- \\overline{x})(y_i- \\overline{y}).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "With this definition and recalling that the variance is defined as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathrm{var}[\\boldsymbol{x}]=\\frac{1}{n} \\sum_{i=0}^{n-1}(x_i- \\overline{x})^2,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "we can rewrite the covariance matrix as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{C}[\\boldsymbol{x},\\boldsymbol{y}] = \\begin{bmatrix} \\mathrm{var}[\\boldsymbol{x}] & \\mathrm{cov}[\\boldsymbol{x},\\boldsymbol{y}] \\\\\n", - " \\mathrm{cov}[\\boldsymbol{x},\\boldsymbol{y}] & \\mathrm{var}[\\boldsymbol{y}] \\\\\n", - " \\end{bmatrix}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "**Note:** we have used $1/n$ in the above definitions of the *sample* variance and covariance. We assume then that we can calculate the exact mean value. \n", - "What you will find in essentially all statistics texts are equations\n", - "with a factor $1/(n-1)$. This is called [Bessel's correction](https://mathworld.wolfram.com/BesselsCorrection.html). This\n", - "method corrects the bias in the estimation of the population variance\n", - "and covariance. It also partially corrects the bias in the estimation\n", - "of the population standard deviation. If you use a library like\n", - "**Scikit-Learn** or **nunmpy's** function calculate the covariance, this\n", - "quantity will be computed with a factor $1/(n-1)$.\n", - "\n", - "\n", - "The covariance takes values between zero and infinity and may thus\n", - "lead to problems with loss of numerical precision for particularly\n", - "large values. It is common to scale the covariance matrix by\n", - "introducing instead the correlation matrix defined via the so-called\n", - "correlation function" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathrm{corr}[\\boldsymbol{x},\\boldsymbol{y}]=\\frac{\\mathrm{cov}[\\boldsymbol{x},\\boldsymbol{y}]}{\\sqrt{\\mathrm{var}[\\boldsymbol{x}] \\mathrm{var}[\\boldsymbol{y}]}}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The correlation function is then given by values $\\mathrm{corr}[\\boldsymbol{x},\\boldsymbol{y}]\n", - "\\in [-1,1]$. This avoids eventual problems with too large values. We\n", - "can then define the correlation matrix for the two vectors $\\boldsymbol{x}$\n", - "and $\\boldsymbol{y}$ as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{K}[\\boldsymbol{x},\\boldsymbol{y}] = \\begin{bmatrix} 1 & \\mathrm{corr}[\\boldsymbol{x},\\boldsymbol{y}] \\\\\n", - " \\mathrm{corr}[\\boldsymbol{y},\\boldsymbol{x}] & 1 \\\\\n", - " \\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In the above example this is the function we constructed using **pandas**.\n", - "\n", - "\n", - "\n", - "In our derivation of the various regression algorithms like **Ordinary Least Squares** or **Ridge regression**\n", - "we defined the design/feature matrix $\\boldsymbol{X}$ as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}=\\begin{bmatrix}\n", - "x_{0,0} & x_{0,1} & x_{0,2}& \\dots & \\dots x_{0,p-1}\\\\\n", - "x_{1,0} & x_{1,1} & x_{1,2}& \\dots & \\dots x_{1,p-1}\\\\\n", - "x_{2,0} & x_{2,1} & x_{2,2}& \\dots & \\dots x_{2,p-1}\\\\\n", - "\\dots & \\dots & \\dots & \\dots \\dots & \\dots \\\\\n", - "x_{n-2,0} & x_{n-2,1} & x_{n-2,2}& \\dots & \\dots x_{n-2,p-1}\\\\\n", - "x_{n-1,0} & x_{n-1,1} & x_{n-1,2}& \\dots & \\dots x_{n-1,p-1}\\\\\n", - "\\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with $\\boldsymbol{X}\\in {\\mathbb{R}}^{n\\times p}$, with the predictors/features $p$ refering to the column numbers and the\n", - "entries $n$ being the row elements.\n", - "We can rewrite the design/feature matrix in terms of its column vectors as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}=\\begin{bmatrix} \\boldsymbol{x}_0 & \\boldsymbol{x}_1 & \\boldsymbol{x}_2 & \\dots & \\dots & \\boldsymbol{x}_{p-1}\\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with a given vector" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{x}_i^T = \\begin{bmatrix}x_{0,i} & x_{1,i} & x_{2,i}& \\dots & \\dots x_{n-1,i}\\end{bmatrix}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "With these definitions, we can now rewrite our $2\\times 2$\n", - "correlation/covariance matrix in terms of a moe general design/feature\n", - "matrix $\\boldsymbol{X}\\in {\\mathbb{R}}^{n\\times p}$. This leads to a $p\\times p$\n", - "covariance matrix for the vectors $\\boldsymbol{x}_i$ with $i=0,1,\\dots,p-1$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{C}[\\boldsymbol{x}] = \\begin{bmatrix}\n", - "\\mathrm{var}[\\boldsymbol{x}_0] & \\mathrm{cov}[\\boldsymbol{x}_0,\\boldsymbol{x}_1] & \\mathrm{cov}[\\boldsymbol{x}_0,\\boldsymbol{x}_2] & \\dots & \\dots & \\mathrm{cov}[\\boldsymbol{x}_0,\\boldsymbol{x}_{p-1}]\\\\\n", - "\\mathrm{cov}[\\boldsymbol{x}_1,\\boldsymbol{x}_0] & \\mathrm{var}[\\boldsymbol{x}_1] & \\mathrm{cov}[\\boldsymbol{x}_1,\\boldsymbol{x}_2] & \\dots & \\dots & \\mathrm{cov}[\\boldsymbol{x}_1,\\boldsymbol{x}_{p-1}]\\\\\n", - "\\mathrm{cov}[\\boldsymbol{x}_2,\\boldsymbol{x}_0] & \\mathrm{cov}[\\boldsymbol{x}_2,\\boldsymbol{x}_1] & \\mathrm{var}[\\boldsymbol{x}_2] & \\dots & \\dots & \\mathrm{cov}[\\boldsymbol{x}_2,\\boldsymbol{x}_{p-1}]\\\\\n", - "\\dots & \\dots & \\dots & \\dots & \\dots & \\dots \\\\\n", - "\\dots & \\dots & \\dots & \\dots & \\dots & \\dots \\\\\n", - "\\mathrm{cov}[\\boldsymbol{x}_{p-1},\\boldsymbol{x}_0] & \\mathrm{cov}[\\boldsymbol{x}_{p-1},\\boldsymbol{x}_1] & \\mathrm{cov}[\\boldsymbol{x}_{p-1},\\boldsymbol{x}_{2}] & \\dots & \\dots & \\mathrm{var}[\\boldsymbol{x}_{p-1}]\\\\\n", - "\\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and the correlation matrix" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{K}[\\boldsymbol{x}] = \\begin{bmatrix}\n", - "1 & \\mathrm{corr}[\\boldsymbol{x}_0,\\boldsymbol{x}_1] & \\mathrm{corr}[\\boldsymbol{x}_0,\\boldsymbol{x}_2] & \\dots & \\dots & \\mathrm{corr}[\\boldsymbol{x}_0,\\boldsymbol{x}_{p-1}]\\\\\n", - "\\mathrm{corr}[\\boldsymbol{x}_1,\\boldsymbol{x}_0] & 1 & \\mathrm{corr}[\\boldsymbol{x}_1,\\boldsymbol{x}_2] & \\dots & \\dots & \\mathrm{corr}[\\boldsymbol{x}_1,\\boldsymbol{x}_{p-1}]\\\\\n", - "\\mathrm{corr}[\\boldsymbol{x}_2,\\boldsymbol{x}_0] & \\mathrm{corr}[\\boldsymbol{x}_2,\\boldsymbol{x}_1] & 1 & \\dots & \\dots & \\mathrm{corr}[\\boldsymbol{x}_2,\\boldsymbol{x}_{p-1}]\\\\\n", - "\\dots & \\dots & \\dots & \\dots & \\dots & \\dots \\\\\n", - "\\dots & \\dots & \\dots & \\dots & \\dots & \\dots \\\\\n", - "\\mathrm{corr}[\\boldsymbol{x}_{p-1},\\boldsymbol{x}_0] & \\mathrm{corr}[\\boldsymbol{x}_{p-1},\\boldsymbol{x}_1] & \\mathrm{corr}[\\boldsymbol{x}_{p-1},\\boldsymbol{x}_{2}] & \\dots & \\dots & 1\\\\\n", - "\\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The Numpy function **np.cov** calculates the covariance elements using\n", - "the factor $1/(n-1)$ instead of $1/n$ since it assumes we do not have\n", - "the exact mean values. The following simple function uses the\n", - "**np.vstack** function which takes each vector of dimension $1\\times n$\n", - "and produces a $2\\times n$ matrix $\\boldsymbol{W}$\n", - "\n", - "Note that this assumes you have the features as the rows, and the inputs as columns, that is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{W} = \\begin{bmatrix} x_0 & x_1 & x_2 & \\dots & x_{n-2} & x_{n-1} \\\\\n", - " y_0 & y_1 & y_2 & \\dots & y_{n-2} & y_{n-1} \\\\\n", - " \\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which in turn is converted into into the $2\\times 2$ covariance matrix\n", - "$\\boldsymbol{C}$ via the Numpy function **np.cov()**. We note that we can also calculate\n", - "the mean value of each set of samples $\\boldsymbol{x}$ etc using the Numpy\n", - "function **np.mean(x)**. We can also extract the eigenvalues of the\n", - "covariance matrix through the **np.linalg.eig()** function." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "# Importing various packages\n", - "import numpy as np\n", - "n = 100\n", - "x = np.random.normal(size=n)\n", - "print(np.mean(x))\n", - "y = 4+3*x+np.random.normal(size=n)\n", - "print(np.mean(y))\n", - "W = np.vstack((x, y))\n", - "C = np.cov(W)\n", - "print(C)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The previous example can be converted into the correlation matrix by\n", - "simply scaling the matrix elements with the variances. We should also\n", - "subtract the mean values for each column. This leads to the following\n", - "code which sets up the correlations matrix for the previous example in\n", - "a more brute force way. Here we scale the mean values for each column of the design matrix, calculate the relevant mean values and variances and then finally set up the $2\\times 2$ correlation matrix (since we have only two vectors)." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import numpy as np\n", - "n = 100\n", - "# define two vectors \n", - "x = np.random.random(size=n)\n", - "y = 4+3*x+np.random.normal(size=n)\n", - "#scaling the x and y vectors \n", - "x = x - np.mean(x)\n", - "y = y - np.mean(y)\n", - "variance_x = np.sum(x@x)/n\n", - "variance_y = np.sum(y@y)/n\n", - "print(variance_x)\n", - "print(variance_y)\n", - "cov_xy = np.sum(x@y)/n\n", - "cov_xx = np.sum(x@x)/n\n", - "cov_yy = np.sum(y@y)/n\n", - "C = np.zeros((2,2))\n", - "C[0,0]= cov_xx/variance_x\n", - "C[1,1]= cov_yy/variance_y\n", - "C[0,1]= cov_xy/np.sqrt(variance_y*variance_x)\n", - "C[1,0]= C[0,1]\n", - "print(C)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We see that the matrix elements along the diagonal are one as they\n", - "should be and that the matrix is symmetric. Furthermore, diagonalizing\n", - "this matrix we easily see that it is a positive definite matrix.\n", - "\n", - "The above procedure with **numpy** can be made more compact if we use **pandas**.\n", - "\n", - "\n", - "\n", - "We whow here how we can set up the correlation matrix using **pandas**, as done in this simple code" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import numpy as np\n", - "import pandas as pd\n", - "n = 10\n", - "x = np.random.normal(size=n)\n", - "x = x - np.mean(x)\n", - "y = 4+3*x+np.random.normal(size=n)\n", - "y = y - np.mean(y)\n", - "# Note that we transpose the matrix in order to stay with our ordering n x p\n", - "X = (np.vstack((x, y))).T\n", - "print(X)\n", - "Xpd = pd.DataFrame(X)\n", - "print(Xpd)\n", - "correlation_matrix = Xpd.corr()\n", - "print(correlation_matrix)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We expand this model to the Franke function discussed earlier." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "# Common imports\n", - "import numpy as np\n", - "import pandas as pd\n", - "\n", - "\n", - "def FrankeFunction(x,y):\n", - "\tterm1 = 0.75*np.exp(-(0.25*(9*x-2)**2) - 0.25*((9*y-2)**2))\n", - "\tterm2 = 0.75*np.exp(-((9*x+1)**2)/49.0 - 0.1*(9*y+1))\n", - "\tterm3 = 0.5*np.exp(-(9*x-7)**2/4.0 - 0.25*((9*y-3)**2))\n", - "\tterm4 = -0.2*np.exp(-(9*x-4)**2 - (9*y-7)**2)\n", - "\treturn term1 + term2 + term3 + term4\n", - "\n", - "\n", - "def create_X(x, y, n ):\n", - "\tif len(x.shape) > 1:\n", - "\t\tx = np.ravel(x)\n", - "\t\ty = np.ravel(y)\n", - "\n", - "\tN = len(x)\n", - "\tl = int((n+1)*(n+2)/2)\t\t# Number of elements in beta\n", - "\tX = np.ones((N,l))\n", - "\n", - "\tfor i in range(1,n+1):\n", - "\t\tq = int((i)*(i+1)/2)\n", - "\t\tfor k in range(i+1):\n", - "\t\t\tX[:,q+k] = (x**(i-k))*(y**k)\n", - "\n", - "\treturn X\n", - "\n", - "\n", - "# Making meshgrid of datapoints and compute Franke's function\n", - "n = 4\n", - "N = 100\n", - "x = np.sort(np.random.uniform(0, 1, N))\n", - "y = np.sort(np.random.uniform(0, 1, N))\n", - "z = FrankeFunction(x, y)\n", - "X = create_X(x, y, n=n) \n", - "\n", - "Xpd = pd.DataFrame(X)\n", - "# subtract the mean values and set up the covariance matrix\n", - "Xpd = Xpd - Xpd.mean()\n", - "covariance_matrix = Xpd.cov()\n", - "print(covariance_matrix)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We note here that the covariance is zero for the first rows and\n", - "columns since all matrix elements in the design matrix were set to one\n", - "(we are fitting the function in terms of a polynomial of degree $n$).\n", - "\n", - "This means that the variance for these elements will be zero and will\n", - "cause problems when we set up the correlation matrix. We can simply\n", - "drop these elements and construct a correlation\n", - "matrix without these elements. \n", - "\n", - "\n", - "\n", - "We can rewrite the covariance matrix in a more compact form in terms of the design/feature matrix $\\boldsymbol{X}$ as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{C}[\\boldsymbol{x}] = \\frac{1}{n}\\boldsymbol{X}^T\\boldsymbol{X}= \\mathbb{E}[\\boldsymbol{X}^T\\boldsymbol{X}].\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "To see this let us simply look at a design matrix $\\boldsymbol{X}\\in {\\mathbb{R}}^{2\\times 2}$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}=\\begin{bmatrix}\n", - "x_{00} & x_{01}\\\\\n", - "x_{10} & x_{11}\\\\\n", - "\\end{bmatrix}=\\begin{bmatrix}\n", - "\\boldsymbol{x}_{0} & \\boldsymbol{x}_{1}\\\\\n", - "\\end{bmatrix}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "If we then compute the expectation value (note the $1/n$ factor instead of $1/(n-1)$)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbb{E}[\\boldsymbol{X}^T\\boldsymbol{X}] = \\frac{1}{n}\\boldsymbol{X}^T\\boldsymbol{X}=\\frac{1}{n}\\begin{bmatrix}\n", - "x_{00}^2+x_{10}^2 & x_{00}x_{01}+x_{10}x_{11}\\\\\n", - "x_{01}x_{00}+x_{11}x_{10} & x_{01}^2+x_{11}^2\\\\\n", - "\\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which is just" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{C}[\\boldsymbol{x}_0,\\boldsymbol{x}_1] = \\boldsymbol{C}[\\boldsymbol{x}]=\\begin{bmatrix} \\mathrm{var}[\\boldsymbol{x}_0] & \\mathrm{cov}[\\boldsymbol{x}_0,\\boldsymbol{x}_1] \\\\\n", - " \\mathrm{cov}[\\boldsymbol{x}_1,\\boldsymbol{x}_0] & \\mathrm{var}[\\boldsymbol{x}_1] \\\\\n", - " \\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where we wrote $$\\boldsymbol{C}[\\boldsymbol{x}_0,\\boldsymbol{x}_1] = \\boldsymbol{C}[\\boldsymbol{x}]$$ to indicate that this is the covariance of the vectors $\\boldsymbol{x}$ of the design/feature matrix $\\boldsymbol{X}$.\n", - "\n", - "It is easy to generalize this to a matrix $\\boldsymbol{X}\\in {\\mathbb{R}}^{n\\times p}$.\n", - "\n", - "\n", - "\n", - "## Linking with the SVD\n", - "\n", - "We saw earlier that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}^T\\boldsymbol{X}=\\boldsymbol{V}\\boldsymbol{\\Sigma}^T\\boldsymbol{U}^T\\boldsymbol{U}\\boldsymbol{\\Sigma}\\boldsymbol{V}^T=\\boldsymbol{V}\\boldsymbol{\\Sigma}^T\\boldsymbol{\\Sigma}\\boldsymbol{V}^T.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Since the matrices here have dimension $p\\times p$, with $p$ corresponding to the singular values, we defined earlier the matrix" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{\\Sigma}^T\\boldsymbol{\\Sigma} = \\begin{bmatrix} \\tilde{\\boldsymbol{\\Sigma}} & \\boldsymbol{0}\\\\ \\end{bmatrix}\\begin{bmatrix} \\tilde{\\boldsymbol{\\Sigma}} \\\\ \\boldsymbol{0}\\\\ \\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where the tilde-matrix $\\tilde{\\boldsymbol{\\Sigma}}$ is a matrix of dimension $p\\times p$ containing only the singular values $\\sigma_i$, that is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\tilde{\\boldsymbol{\\Sigma}}=\\begin{bmatrix} \\sigma_0 & 0 & 0 & \\dots & 0 & 0 \\\\\n", - " 0 & \\sigma_1 & 0 & \\dots & 0 & 0 \\\\\n", - "\t\t\t\t 0 & 0 & \\sigma_2 & \\dots & 0 & 0 \\\\\n", - "\t\t\t\t 0 & 0 & 0 & \\dots & \\sigma_{p-2} & 0 \\\\\n", - "\t\t\t\t 0 & 0 & 0 & \\dots & 0 & \\sigma_{p-1} \\\\\n", - "\\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "meaning we can write" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}^T\\boldsymbol{X}=\\boldsymbol{V}\\tilde{\\boldsymbol{\\Sigma}}^2\\boldsymbol{V}^T.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Multiplying from the right with $\\boldsymbol{V}$ (using the orthogonality of $\\boldsymbol{V}$) we get" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\left(\\boldsymbol{X}^T\\boldsymbol{X}\\right)\\boldsymbol{V}=\\boldsymbol{V}\\tilde{\\boldsymbol{\\Sigma}}^2.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "This means the vectors $\\boldsymbol{v}_i$ of the orthogonal matrix $\\boldsymbol{V}$\n", - "are the eigenvectors of the matrix $\\boldsymbol{X}^T\\boldsymbol{X}$ with eigenvalues\n", - "given by the singular values squared, that is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\left(\\boldsymbol{X}^T\\boldsymbol{X}\\right)\\boldsymbol{v}_i=\\boldsymbol{v}_i\\sigma_i^2.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In other words, each non-zero singular value of $\\boldsymbol{X}$ is a positive\n", - "square root of an eigenvalue of $\\boldsymbol{X}^T\\boldsymbol{X}$. It means also that\n", - "the columns of $\\boldsymbol{V}$ are the eigenvectors of\n", - "$\\boldsymbol{X}^T\\boldsymbol{X}$. Since we have ordered the singular values of\n", - "$\\boldsymbol{X}$ in a descending order, it means that the column vectors\n", - "$\\boldsymbol{v}_i$ are hierarchically ordered by how much correlation they\n", - "encode from the columns of $\\boldsymbol{X}$. \n", - "\n", - "\n", - "Note that these are also the eigenvectors and eigenvalues of the\n", - "Hessian matrix.\n", - "\n", - "If we now recall the definition of the covariance matrix (not using\n", - "Bessel's correction) we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{C}[\\boldsymbol{X}]=\\frac{1}{n}\\boldsymbol{X}^T\\boldsymbol{X},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "meaning that every squared non-singular value of $\\boldsymbol{X}$ divided by $n$ (\n", - "the number of samples) are the eigenvalues of the covariance\n", - "matrix. Every singular value of $\\boldsymbol{X}$ is thus a positive square\n", - "root of an eigenvalue of $\\boldsymbol{X}^T\\boldsymbol{X}$. If the matrix $\\boldsymbol{X}$ is\n", - "self-adjoint, the singular values of $\\boldsymbol{X}$ are equal to the\n", - "absolute value of the eigenvalues of $\\boldsymbol{X}$.\n", - "\n", - "\n", - "For $\\boldsymbol{X}\\boldsymbol{X}^T$ we found" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}\\boldsymbol{X}^T=\\boldsymbol{U}\\boldsymbol{\\Sigma}\\boldsymbol{V}^T\\boldsymbol{V}\\boldsymbol{\\Sigma}^T\\boldsymbol{U}^T=\\boldsymbol{U}\\boldsymbol{\\Sigma}^T\\boldsymbol{\\Sigma}\\boldsymbol{U}^T.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Since the matrices here have dimension $n\\times n$, we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{\\Sigma}\\boldsymbol{\\Sigma}^T = \\begin{bmatrix} \\tilde{\\boldsymbol{\\Sigma}} \\\\ \\boldsymbol{0}\\\\ \\end{bmatrix}\\begin{bmatrix} \\tilde{\\boldsymbol{\\Sigma}} \\boldsymbol{0}\\\\ \\end{bmatrix}=\\begin{bmatrix} \\tilde{\\boldsymbol{\\Sigma}} & \\boldsymbol{0} \\\\ \\boldsymbol{0} & \\boldsymbol{0}\\\\ \\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "leading to" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}\\boldsymbol{X}^T=\\boldsymbol{U}\\begin{bmatrix} \\tilde{\\boldsymbol{\\Sigma}} & \\boldsymbol{0} \\\\ \\boldsymbol{0} & \\boldsymbol{0}\\\\ \\end{bmatrix}\\boldsymbol{U}^T.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Multiplying with $\\boldsymbol{U}$ from the right gives us the eigenvalue problem" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "(\\boldsymbol{X}\\boldsymbol{X}^T)\\boldsymbol{U}=\\boldsymbol{U}\\begin{bmatrix} \\tilde{\\boldsymbol{\\Sigma}} & \\boldsymbol{0} \\\\ \\boldsymbol{0} & \\boldsymbol{0}\\\\ \\end{bmatrix}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "It means that the eigenvalues of $\\boldsymbol{X}\\boldsymbol{X}^T$ are again given by\n", - "the non-zero singular values plus now a series of zeros. The column\n", - "vectors of $\\boldsymbol{U}$ are the eigenvectors of $\\boldsymbol{X}\\boldsymbol{X}^T$ and\n", - "measure how much correlations are contained in the rows of $\\boldsymbol{X}$.\n", - "\n", - "Since we will mainly be interested in the correlations among the features\n", - "of our data (the columns of $\\boldsymbol{X}$, the quantity of interest for us are the non-zero singular\n", - "values and the column vectors of $\\boldsymbol{V}$.\n", - "\n", - "\n", - "\n", - "\n", - "## Ridge and Lasso Regression\n", - "\n", - "Let us remind ourselves about the expression for the standard Mean Squared Error (MSE) which we used to define our cost function and the equations for the ordinary least squares (OLS) method, that is \n", - "our optimization problem is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "{\\displaystyle \\min_{\\boldsymbol{\\beta}\\in {\\mathbb{R}}^{p}}}\\frac{1}{n}\\left\\{\\left(\\boldsymbol{y}-\\boldsymbol{X}\\boldsymbol{\\beta}\\right)^T\\left(\\boldsymbol{y}-\\boldsymbol{X}\\boldsymbol{\\beta}\\right)\\right\\}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "or we can state it as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "{\\displaystyle \\min_{\\boldsymbol{\\beta}\\in\n", - "{\\mathbb{R}}^{p}}}\\frac{1}{n}\\sum_{i=0}^{n-1}\\left(y_i-\\tilde{y}_i\\right)^2=\\frac{1}{n}\\vert\\vert \\boldsymbol{y}-\\boldsymbol{X}\\boldsymbol{\\beta}\\vert\\vert_2^2,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where we have used the definition of a norm-2 vector, that is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\vert\\vert \\boldsymbol{x}\\vert\\vert_2 = \\sqrt{\\sum_i x_i^2}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "By minimizing the above equation with respect to the parameters\n", - "$\\boldsymbol{\\beta}$ we could then obtain an analytical expression for the\n", - "parameters $\\boldsymbol{\\beta}$. We can add a regularization parameter $\\lambda$ by\n", - "defining a new cost function to be optimized, that is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "{\\displaystyle \\min_{\\boldsymbol{\\beta}\\in\n", - "{\\mathbb{R}}^{p}}}\\frac{1}{n}\\vert\\vert \\boldsymbol{y}-\\boldsymbol{X}\\boldsymbol{\\beta}\\vert\\vert_2^2+\\lambda\\vert\\vert \\boldsymbol{\\beta}\\vert\\vert_2^2\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which leads to the Ridge regression minimization problem where we\n", - "require that $\\vert\\vert \\boldsymbol{\\beta}\\vert\\vert_2^2\\le t$, where $t$ is\n", - "a finite number larger than zero. By defining" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(\\boldsymbol{X},\\boldsymbol{\\beta})=\\frac{1}{n}\\vert\\vert \\boldsymbol{y}-\\boldsymbol{X}\\boldsymbol{\\beta}\\vert\\vert_2^2+\\lambda\\vert\\vert \\boldsymbol{\\beta}\\vert\\vert_1,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "we have a new optimization equation" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "{\\displaystyle \\min_{\\boldsymbol{\\beta}\\in\n", - "{\\mathbb{R}}^{p}}}\\frac{1}{n}\\vert\\vert \\boldsymbol{y}-\\boldsymbol{X}\\boldsymbol{\\beta}\\vert\\vert_2^2+\\lambda\\vert\\vert \\boldsymbol{\\beta}\\vert\\vert_1\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which leads to Lasso regression. Lasso stands for least absolute shrinkage and selection operator. \n", - "\n", - "Here we have defined the norm-1 as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\vert\\vert \\boldsymbol{x}\\vert\\vert_1 = \\sum_i \\vert x_i\\vert.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Using the matrix-vector expression for Ridge regression and dropping the parameter $1/n$ in front of the standard means squared error equation, we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(\\boldsymbol{X},\\boldsymbol{\\beta})=\\left\\{(\\boldsymbol{y}-\\boldsymbol{X}\\boldsymbol{\\beta})^T(\\boldsymbol{y}-\\boldsymbol{X}\\boldsymbol{\\beta})\\right\\}+\\lambda\\boldsymbol{\\beta}^T\\boldsymbol{\\beta},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and \n", - "taking the derivatives with respect to $\\boldsymbol{\\beta}$ we obtain then\n", - "a slightly modified matrix inversion problem which for finite values\n", - "of $\\lambda$ does not suffer from singularity problems. We obtain\n", - "the optimal parameters" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\hat{\\boldsymbol{\\beta}}_{\\mathrm{Ridge}} = \\left(\\boldsymbol{X}^T\\boldsymbol{X}+\\lambda\\boldsymbol{I}\\right)^{-1}\\boldsymbol{X}^T\\boldsymbol{y},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with $\\boldsymbol{I}$ being a $p\\times p$ identity matrix with the constraint that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\sum_{i=0}^{p-1} \\beta_i^2 \\leq t,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with $t$ a finite positive number. \n", - "\n", - "When we compare this with the ordinary least squares result we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\hat{\\boldsymbol{\\beta}}_{\\mathrm{OLS}} = \\left(\\boldsymbol{X}^T\\boldsymbol{X}\\right)^{-1}\\boldsymbol{X}^T\\boldsymbol{y},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which can lead to singular matrices. However, with the SVD, we can always compute the inverse of the matrix $\\boldsymbol{X}^T\\boldsymbol{X}$.\n", - "\n", - "\n", - "We see that Ridge regression is nothing but the standard OLS with a\n", - "modified diagonal term added to $\\boldsymbol{X}^T\\boldsymbol{X}$. The consequences, in\n", - "particular for our discussion of the bias-variance tradeoff are rather\n", - "interesting. We will see that for specific values of $\\lambda$, we may\n", - "even reduce the variance of the optimal parameters $\\boldsymbol{\\beta}$. These topics and other related ones, will be discussed after the more linear algebra oriented analysis here.\n", - "\n", - "\n", - "\n", - "Using our insights about the SVD of the design matrix $\\boldsymbol{X}$ \n", - "We have already analyzed the OLS solutions in terms of the eigenvectors (the columns) of the right singular value matrix $\\boldsymbol{U}$ as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\tilde{\\boldsymbol{y}}_{\\mathrm{OLS}}=\\boldsymbol{X}\\boldsymbol{\\beta} =\\boldsymbol{U}\\boldsymbol{U}^T\\boldsymbol{y}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "For Ridge regression this becomes" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\tilde{\\boldsymbol{y}}_{\\mathrm{Ridge}}=\\boldsymbol{X}\\boldsymbol{\\beta}_{\\mathrm{Ridge}} = \\boldsymbol{U\\Sigma V^T}\\left(\\boldsymbol{V}\\boldsymbol{\\Sigma}^2\\boldsymbol{V}^T+\\lambda\\boldsymbol{I} \\right)^{-1}(\\boldsymbol{U\\Sigma V^T})^T\\boldsymbol{y}=\\sum_{j=0}^{p-1}\\boldsymbol{u}_j\\boldsymbol{u}_j^T\\frac{\\sigma_j^2}{\\sigma_j^2+\\lambda}\\boldsymbol{y},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with the vectors $\\boldsymbol{u}_j$ being the columns of $\\boldsymbol{U}$ from the SVD of the matrix $\\boldsymbol{X}$. \n", - "\n", - "\n", - "\n", - "Since $\\lambda \\geq 0$, it means that compared to OLS, we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\sigma_j^2}{\\sigma_j^2+\\lambda} \\leq 1.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Ridge regression finds the coordinates of $\\boldsymbol{y}$ with respect to the\n", - "orthonormal basis $\\boldsymbol{U}$, it then shrinks the coordinates by\n", - "$\\frac{\\sigma_j^2}{\\sigma_j^2+\\lambda}$. Recall that the SVD has\n", - "eigenvalues ordered in a descending way, that is $\\sigma_i \\geq\n", - "\\sigma_{i+1}$.\n", - "\n", - "For small eigenvalues $\\sigma_i$ it means that their contributions become less important, a fact which can be used to reduce the number of degrees of freedom. More about this when we have covered the material on a statistical interpretation of various linear regression methods.\n", - "\n", - "\n", - "\n", - "For the sake of simplicity, let us assume that the design matrix is orthonormal, that is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}^T\\boldsymbol{X}=(\\boldsymbol{X}^T\\boldsymbol{X})^{-1} =\\boldsymbol{I}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In this case the standard OLS results in" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{\\beta}^{\\mathrm{OLS}} = \\boldsymbol{X}^T\\boldsymbol{y}=\\sum_{i=0}^{p-1}\\boldsymbol{u}_j\\boldsymbol{u}_j^T\\boldsymbol{y},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{\\beta}^{\\mathrm{Ridge}} = \\left(\\boldsymbol{I}+\\lambda\\boldsymbol{I}\\right)^{-1}\\boldsymbol{X}^T\\boldsymbol{y}=\\left(1+\\lambda\\right)^{-1}\\boldsymbol{\\beta}^{\\mathrm{OLS}},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "that is the Ridge estimator scales the OLS estimator by the inverse of a factor $1+\\lambda$, and\n", - "the Ridge estimator converges to zero when the hyperparameter goes to\n", - "infinity.\n", - "\n", - "We will come back to more interpreations after we have gone through some of the statistical analysis part. \n", - "\n", - "\n", - "\n", - "Using the matrix-vector expression for Lasso regression and dropping the parameter $1/n$ in front of the standard mean squared error equation, we have the following **cost** function" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(\\boldsymbol{X},\\boldsymbol{\\beta})=\\left\\{(\\boldsymbol{y}-\\boldsymbol{X}\\boldsymbol{\\beta})^T(\\boldsymbol{y}-\\boldsymbol{X}\\boldsymbol{\\beta})\\right\\}+\\lambda\\vert\\vert\\boldsymbol{\\beta}\\vert\\vert_1,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Taking the derivative with respect to $\\boldsymbol{\\beta}$ and recalling that the derivative of the absolute value is (we drop the boldfaced vector symbol for simplicty)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{d \\vert \\beta\\vert}{d \\boldsymbol{\\beta}}=\\mathrm{sgn}(\\boldsymbol{\\beta})=\\left\\{\\begin{array}{cc} 1 & \\beta > 0 \\\\ 0 & \\beta =0\\\\-1 & \\beta < 0, \\end{array}\\right.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "we have that the derivative of the cost function is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial C(\\boldsymbol{X},\\boldsymbol{\\beta})}{\\partial \\boldsymbol{\\beta}}=-2\\boldsymbol{X}^T(\\boldsymbol{y}-\\boldsymbol{X}\\boldsymbol{\\beta})+\\lambda sgn(\\boldsymbol{\\beta})=0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and reordering we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}^T\\boldsymbol{X}\\boldsymbol{\\beta}+\\lambda sgn(\\boldsymbol{\\beta})=2\\boldsymbol{X}^T\\boldsymbol{y}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "This equation does not lead to a nice analytical equation as in Ridge regression or ordinary least squares. This equation can however be solved by using standard convex optimization algorithms using for example the Python package [CVXOPT](https://cvxopt.org/). We will discuss this later. \n", - "\n", - "\n", - "\n", - "\n", - "\n", - "Let us assume that our design matrix is given by unit (identity) matrix, that is a square diagonal matrix with ones only along the\n", - "diagonal. In this case we have an equal number of rows and columns $n=p$.\n", - "\n", - "Our model approximation is just $\\tilde{\\boldsymbol{y}}=\\boldsymbol{\\beta}$ and the mean squared error and thereby the cost function for ordinary least sqquares (OLS) is then (we drop the term $1/n$)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(\\boldsymbol{\\beta})=\\sum_{i=0}^{p-1}(y_i-\\beta_i)^2,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and minimizing we have that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\hat{\\beta}_i^{\\mathrm{OLS}} = y_i.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "For Ridge regression our cost function is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(\\boldsymbol{\\beta})=\\sum_{i=0}^{p-1}(y_i-\\beta_i)^2+\\lambda\\sum_{i=0}^{p-1}\\beta_i^2,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and minimizing we have that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\hat{\\beta}_i^{\\mathrm{Ridge}} = \\frac{y_i}{1+\\lambda}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "For Lasso regression our cost function is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(\\boldsymbol{\\beta})=\\sum_{i=0}^{p-1}(y_i-\\beta_i)^2+\\lambda\\sum_{i=0}^{p-1}\\vert\\beta_i\\vert=\\sum_{i=0}^{p-1}(y_i-\\beta_i)^2+\\lambda\\sum_{i=0}^{p-1}\\sqrt{\\beta_i^2},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and minimizing we have that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "-2\\sum_{i=0}^{p-1}(y_i-\\beta_i)+\\lambda \\sum_{i=0}^{p-1}\\frac{(\\beta_i)}{\\vert\\beta_i\\vert}=0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which leads to" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\hat{\\boldsymbol{\\beta}}_i^{\\mathrm{Lasso}} = \\left\\{\\begin{array}{ccc}y_i-\\frac{\\lambda}{2} &\\mathrm{if} & y_i> \\frac{\\lambda}{2}\\\\\n", - " y_i+\\frac{\\lambda}{2} &\\mathrm{if} & y_i< -\\frac{\\lambda}{2}\\\\\n", - "\t\t\t\t\t\t\t 0 &\\mathrm{if} & \\vert y_i\\vert\\le \\frac{\\lambda}{2}\\end{array}\\right.\\\\.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Plotting these results ([figure in handwritten notes for week 36](https://github.com/CompPhysics/MachineLearning/blob/master/doc/HandWrittenNotes/2021/NotesSeptember9.pdf)) shows clearly that Lasso regression suppresses (sets to zero) values of $\\beta_i$ for specific values of $\\lambda$. Ridge regression reduces on the other hand the values of $\\beta_i$ as function of $\\lambda$.\n", - "\n", - "\n", - "As another examples, \n", - "let us assume we have a data set with outputs/targets given by the vector" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{y}=\\begin{bmatrix}4 \\\\ 2 \\\\3\\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and our inputs as a $3\\times 2$ design matrix" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}=\\begin{bmatrix}2 & 0\\\\ 0 & 1 \\\\ 0 & 0\\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "meaning that we have two features and two unknown parameters $\\beta_0$ and $\\beta_1$ to be determined either by ordinary least squares, Ridge or Lasso regression.\n", - "\n", - "\n", - "For ordinary least squares (OLS) we know that the optimal solution is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\hat{\\boldsymbol{\\beta}}^{\\mathrm{OLS}}=\\left( \\boldsymbol{X}^T\\boldsymbol{X}\\right)^{-1}\\boldsymbol{X}^T\\boldsymbol{y}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Inserting the above values we obtain that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\hat{\\boldsymbol{\\beta}}^{\\mathrm{OLS}}=\\begin{bmatrix}2 \\\\ 2\\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The code which implements this simpler case is presented after the discussion of Ridge and Lasso.\n", - "\n", - "\n", - "For Ridge regression we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\hat{\\boldsymbol{\\beta}}^{\\mathrm{Ridge}}=\\left( \\boldsymbol{X}^T\\boldsymbol{X}+\\lambda\\boldsymbol{I}\\right)^{-1}\\boldsymbol{X}^T\\boldsymbol{y}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Inserting the above values we obtain that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\hat{\\boldsymbol{\\beta}}^{\\mathrm{Ridge}}=\\begin{bmatrix}\\frac{8}{4+\\lambda} \\\\ \\frac{2}{1+\\lambda}\\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "There is normally a constraint on the value of $\\vert\\vert \\boldsymbol{\\beta}\\vert\\vert_2$ via the parameter $\\lambda$.\n", - "Let us for simplicity assume that $\\beta_0^2+\\beta_1^2=1$ as constraint. This will allow us to find an expression for the optimal values of $\\beta$ and $\\lambda$.\n", - "\n", - "To see this, let us write the cost function for Ridge regression. \n", - "\n", - "\n", - "\n", - "We define the MSE without the $1/n$ factor and have then, using that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}\\boldsymbol{\\beta}=\\begin{bmatrix} 2\\beta_0 \\\\ \\beta_1 \\\\0 \\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(\\boldsymbol{\\beta})=(4-2\\beta_0)^2+(2-\\beta_1)^2+\\lambda(\\beta_0^2+\\beta_1^2),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and taking the derivative with respect to $\\beta_0$ we get" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\beta_0=\\frac{8}{4+\\lambda},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and for $\\beta_1$ we obtain" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\beta_1=\\frac{2}{1+\\lambda},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Using the constraint for $\\beta_0^2+\\beta_1^2=1$ we can constrain $\\lambda$ by solving" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\left(\\frac{8}{4+\\lambda}\\right)^2+\\left(\\frac{2}{1+\\lambda}\\right)^2=1,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which gives $\\lambda=4.571$ and $\\beta_0=0.933$ and $\\beta_1=0.359$.\n", - "\n", - "\n", - "For Lasso we need now, keeping a constraint on $\\vert\\beta_0\\vert+\\vert\\beta_1\\vert=1$, to take the derivative of the absolute values of $\\beta_0$\n", - "and $\\beta_1$. This gives us the following derivatives of the cost function" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(\\boldsymbol{\\beta})=(4-2\\beta_0)^2+(2-\\beta_1)^2+\\lambda(\\vert\\beta_0\\vert+\\vert\\beta_1\\vert),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial C(\\boldsymbol{\\beta})}{\\partial \\beta_0}=-4(4-2\\beta_0)+\\lambda\\mathrm{sgn}(\\beta_0)=0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial C(\\boldsymbol{\\beta})}{\\partial \\beta_1}=-2(2-\\beta_1)+\\lambda\\mathrm{sgn}(\\beta_1)=0.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We have now four cases to solve besides the trivial cases $\\beta_0$ and/or $\\beta_1$ are zero, namely\n", - "1. $\\beta_0 > 0$ and $\\beta_1 > 0$,\n", - "\n", - "2. $\\beta_0 > 0$ and $\\beta_1 < 0$,\n", - "\n", - "3. $\\beta_0 < 0$ and $\\beta_1 > 0$,\n", - "\n", - "4. $\\beta_0 < 0$ and $\\beta_1 < 0$.\n", - "\n", - "If we consider the first case, we have then" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "-4(4-2\\beta_0)+\\lambda=0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "-2(2-\\beta_1)+\\lambda=0.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which yields" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\beta_0=\\frac{16+\\lambda}{8},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\beta_1=\\frac{4+\\lambda}{2}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Using the constraint on $\\beta_0$ and $\\beta_1$ we can then find the optimal value of $\\lambda$ for the different cases. We leave this as an exercise to you.\n", - "\n", - "\n", - "Here we set up the OLS, Ridge and Lasso functionality in order to study the above example. Note that here we have opted for a set of values of $\\lambda$, meaning that we need to perform a search in order to find the optimal values.\n", - "\n", - "First we study and compare the OLS and Ridge results. The next code compares all three methods.\n", - "We select values of the hyperparameter $\\lambda\\in [10^{-4},10^4]$ and compute the predicted values for ordinary least squares and Ridge regression." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "%matplotlib inline\n", - "\n", - "import os\n", - "import numpy as np\n", - "import pandas as pd\n", - "import matplotlib.pyplot as plt\n", - "\n", - "def R2(y_data, y_model):\n", - " return 1 - np.sum((y_data - y_model) ** 2) / np.sum((y_data - np.mean(y_data)) ** 2)\n", - "def MSE(y_data,y_model):\n", - " n = np.size(y_model)\n", - " return np.sum((y_data-y_model)**2)/n\n", - "\n", - "\n", - "# A seed just to ensure that the random numbers are the same for every run.\n", - "# Useful for eventual debugging.\n", - "\n", - "X = np.array( [ [ 2, 0], [0, 1], [0,0]])\n", - "y = np.array( [4, 2, 3])\n", - "\n", - "\n", - "# matrix inversion to find beta\n", - "OLSbeta = np.linalg.inv(X.T @ X) @ X.T @ y\n", - "print(OLSbeta)\n", - "# and then make the prediction\n", - "ytildeOLS = X @ OLSbeta\n", - "print(\"Training MSE for OLS\")\n", - "print(MSE(y,ytildeOLS))\n", - "ypredictOLS = X @ OLSbeta\n", - "\n", - "# Repeat now for Ridge regression and various values of the regularization parameter\n", - "I = np.eye(2,2)\n", - "# Decide which values of lambda to use\n", - "nlambdas = 100\n", - "MSEPredict = np.zeros(nlambdas)\n", - "lambdas = np.logspace(-4, 4, nlambdas)\n", - "for i in range(nlambdas):\n", - " lmb = lambdas[i]\n", - " Ridgebeta = np.linalg.inv(X.T @ X+lmb*I) @ X.T @ y\n", - "# print(Ridgebeta)\n", - " # and then make the prediction\n", - " ypredictRidge = X @ Ridgebeta\n", - " MSEPredict[i] = MSE(y,ypredictRidge)\n", - "# print(MSEPredict[i])\n", - " # Now plot the results\n", - "plt.figure()\n", - "plt.plot(np.log10(lambdas), MSEPredict, 'r--', label = 'MSE Ridge Train')\n", - "plt.xlabel('log10(lambda)')\n", - "plt.ylabel('MSE')\n", - "plt.legend()\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We see here that we reach a plateau for the Ridge results. Writing out the coefficients $\\boldsymbol{\\beta}$, we that they are getting smaller and smaller and our error stabilizes since the predicted values of $\\tilde{\\boldsymbol{y}}$ approach zero.\n", - "\n", - "This happens also for Lasso regression, as seen from the next code\n", - "output. The difference is that Lasso shrinks the values of $\\beta$ to\n", - "zero at a much earlier stage and the results flatten out. We see that\n", - "Lasso gives also an excellent fit for small values of $\\lambda$ and\n", - "shows rthe best performance of the three regression methods." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import os\n", - "import numpy as np\n", - "import pandas as pd\n", - "import matplotlib.pyplot as plt\n", - "from sklearn import linear_model\n", - "\n", - "def R2(y_data, y_model):\n", - " return 1 - np.sum((y_data - y_model) ** 2) / np.sum((y_data - np.mean(y_data)) ** 2)\n", - "def MSE(y_data,y_model):\n", - " n = np.size(y_model)\n", - " return np.sum((y_data-y_model)**2)/n\n", - "\n", - "\n", - "# A seed just to ensure that the random numbers are the same for every run.\n", - "# Useful for eventual debugging.\n", - "\n", - "X = np.array( [ [ 2, 0], [0, 1], [0,0]])\n", - "y = np.array( [4, 2, 3])\n", - "\n", - "\n", - "# matrix inversion to find beta\n", - "OLSbeta = np.linalg.inv(X.T @ X) @ X.T @ y\n", - "print(OLSbeta)\n", - "# and then make the prediction\n", - "ytildeOLS = X @ OLSbeta\n", - "print(\"Training MSE for OLS\")\n", - "print(MSE(y,ytildeOLS))\n", - "ypredictOLS = X @ OLSbeta\n", - "\n", - "# Repeat now for Ridge regression and various values of the regularization parameter\n", - "I = np.eye(2,2)\n", - "# Decide which values of lambda to use\n", - "nlambdas = 100\n", - "MSERidgePredict = np.zeros(nlambdas)\n", - "MSELassoPredict = np.zeros(nlambdas)\n", - "lambdas = np.logspace(-4, 4, nlambdas)\n", - "for i in range(nlambdas):\n", - " lmb = lambdas[i]\n", - " Ridgebeta = np.linalg.inv(X.T @ X+lmb*I) @ X.T @ y\n", - " print(Ridgebeta)\n", - " # and then make the prediction\n", - " ypredictRidge = X @ Ridgebeta\n", - " MSERidgePredict[i] = MSE(y,ypredictRidge)\n", - " RegLasso = linear_model.Lasso(lmb)\n", - " RegLasso.fit(X,y)\n", - " ypredictLasso = RegLasso.predict(X)\n", - " print(RegLasso.coef_)\n", - " MSELassoPredict[i] = MSE(y,ypredictLasso)\n", - "# Now plot the results\n", - "plt.figure()\n", - "plt.plot(np.log10(lambdas), MSERidgePredict, 'r--', label = 'MSE Ridge Train')\n", - "plt.plot(np.log10(lambdas), MSELassoPredict, 'r--', label = 'MSE Lasso Train')\n", - "plt.xlabel('log10(lambda)')\n", - "plt.ylabel('MSE')\n", - "plt.legend()\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We bring then back our exponential function example and study all\n", - "three regression methods. Depending on the level of noise, we note\n", - "that for small values of the hyperparameter $\\lambda$ all three\n", - "methods produce the same mean squared error. Again, Lasso shrinks the\n", - "parameter values to zero much earlier than Ridge regression and the\n", - "Lasso results flatten out much earlier since all $\\beta_j=0$ (check\n", - "this by printing the values). This case is an example of where OLS\n", - "performs best. Lasso and Ridge reproduce the OLS results for a limited\n", - "set of $\\lambda$ values." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import os\n", - "import numpy as np\n", - "import pandas as pd\n", - "import matplotlib.pyplot as plt\n", - "from sklearn.model_selection import train_test_split\n", - "from sklearn import linear_model\n", - "\n", - "def R2(y_data, y_model):\n", - " return 1 - np.sum((y_data - y_model) ** 2) / np.sum((y_data - np.mean(y_data)) ** 2)\n", - "def MSE(y_data,y_model):\n", - " n = np.size(y_model)\n", - " return np.sum((y_data-y_model)**2)/n\n", - "\n", - "\n", - "# A seed just to ensure that the random numbers are the same for every run.\n", - "# Useful for eventual debugging.\n", - "np.random.seed(3155)\n", - "\n", - "x = np.random.rand(100)\n", - "y = 2.0+5*x*x+0.1*np.random.randn(100)\n", - "\n", - "# number of features p (here degree of polynomial\n", - "p = 3\n", - "# The design matrix now as function of a given polynomial\n", - "X = np.zeros((len(x),p))\n", - "X[:,0] = 1.0\n", - "X[:,1] = x\n", - "X[:,2] = x*x\n", - "# We split the data in test and training data\n", - "X_train, X_test, y_train, y_test = train_test_split(X, y, test_size=0.2)\n", - "\n", - "# matrix inversion to find beta\n", - "OLSbeta = np.linalg.inv(X_train.T @ X_train) @ X_train.T @ y_train\n", - "print(OLSbeta)\n", - "# and then make the prediction\n", - "ytildeOLS = X_train @ OLSbeta\n", - "print(\"Training MSE for OLS\")\n", - "print(MSE(y_train,ytildeOLS))\n", - "ypredictOLS = X_test @ OLSbeta\n", - "print(\"Test MSE OLS\")\n", - "print(MSE(y_test,ypredictOLS))\n", - "\n", - "# Repeat now for Lasso and Ridge regression and various values of the regularization parameter\n", - "I = np.eye(p,p)\n", - "# Decide which values of lambda to use\n", - "nlambdas = 100\n", - "MSEPredict = np.zeros(nlambdas)\n", - "MSETrain = np.zeros(nlambdas)\n", - "MSELassoPredict = np.zeros(nlambdas)\n", - "MSELassoTrain = np.zeros(nlambdas)\n", - "lambdas = np.logspace(-4, 4, nlambdas)\n", - "for i in range(nlambdas):\n", - " lmb = lambdas[i]\n", - " Ridgebeta = np.linalg.inv(X_train.T @ X_train+lmb*I) @ X_train.T @ y_train\n", - " # include lasso using Scikit-Learn\n", - " RegLasso = linear_model.Lasso(lmb)\n", - " RegLasso.fit(X_train,y_train)\n", - " # and then make the prediction\n", - " ytildeRidge = X_train @ Ridgebeta\n", - " ypredictRidge = X_test @ Ridgebeta\n", - " ytildeLasso = RegLasso.predict(X_train)\n", - " ypredictLasso = RegLasso.predict(X_test)\n", - " MSEPredict[i] = MSE(y_test,ypredictRidge)\n", - " MSETrain[i] = MSE(y_train,ytildeRidge)\n", - " MSELassoPredict[i] = MSE(y_test,ypredictLasso)\n", - " MSELassoTrain[i] = MSE(y_train,ytildeLasso)\n", - "\n", - "# Now plot the results\n", - "plt.figure()\n", - "plt.plot(np.log10(lambdas), MSETrain, label = 'MSE Ridge train')\n", - "plt.plot(np.log10(lambdas), MSEPredict, 'r--', label = 'MSE Ridge Test')\n", - "plt.plot(np.log10(lambdas), MSELassoTrain, label = 'MSE Lasso train')\n", - "plt.plot(np.log10(lambdas), MSELassoPredict, 'r--', label = 'MSE Lasso Test')\n", - "\n", - "plt.xlabel('log10(lambda)')\n", - "plt.ylabel('MSE')\n", - "plt.legend()\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Both these example send a clear message. The addition of a\n", - "shrinkage/regularization term implies that we need to perform a search\n", - "for the optimal values of $\\lambda$. We will see this throughout these\n", - "series of lectures.\n", - "\n", - "\n", - "As a small addendum, we note that you can also solve this problem using the convex optimization package [CVXOPT](https://cvxopt.org/examples/mlbook/l1regls.html). This requires, in addition to having installed **CVXOPT**, you need to download the file *l1regl.py*.\n", - "The following code example solves the simpler problem we discussed above, where we have added the latter python file." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "from cvxopt import matrix, spdiag, mul, div, sqrt, normal, setseed\n", - "from cvxopt import blas, lapack, solvers, sparse, spmatrix\n", - "import math\n", - "\n", - "try:\n", - " import mosek\n", - " import sys\n", - " __MOSEK = True\n", - "except: __MOSEK = False\n", - "\n", - "if __MOSEK:\n", - "\n", - " def l1regls_mosek(A, b):\n", - " \"\"\"\n", - "\n", - " Returns the solution of l1-norm regularized least-squares problem\n", - "\n", - " minimize || A*x - b ||_2^2 + e'*u\n", - "\n", - " subject to -u <= x <= u\n", - "\n", - " \"\"\"\n", - "\n", - " m, n = A.size\n", - "\n", - " env = mosek.Env()\n", - " task = env.Task(0,0)\n", - " task.set_Stream(mosek.streamtype.log, lambda x: sys.stdout.write(x))\n", - "\n", - " task.appendvars( 2*n) # number of variables\n", - " task.appendcons( 2*n) # number of constraints\n", - "\n", - " # input quadratic objective\n", - " Q = matrix(0.0, (n,n)) \n", - " blas.syrk(A, Q, alpha = 2.0, trans='T')\n", - "\n", - " I = []\n", - " for i in range(n):\n", - " I.extend(range(i,n))\n", - "\n", - " J = []\n", - " for i in range(n):\n", - " J.extend((n-i)*[i])\n", - "\n", - " task.putqobj(I, J, list(Q[matrix(I) + matrix(J)*n]))\n", - " task.putclist(range(2*n), list(-2*A.T*b) + n*[1.0]) # setup linear objective\n", - "\n", - " # input constraint matrix row by row\n", - " for i in range(n):\n", - " task.putarow( i, [i, n+i], [1.0, -1.0])\n", - " task.putarow( n+i, [i, n+i], [1.0, 1.0])\n", - "\n", - " # setup bounds on constraints\n", - " task.putboundslice(mosek.accmode.con,\n", - " 0, n, n*[mosek.boundkey.up], n*[0.0], n*[0.0])\n", - " task.putboundslice(mosek.accmode.con,\n", - " n, 2*n, n*[mosek.boundkey.lo], n*[0.0], n*[0.0])\n", - "\n", - " # setup variable bounds\n", - " task.putboundslice(mosek.accmode.var,\n", - " 0, 2*n, 2*n*[mosek.boundkey.fr], 2*n*[0.0], 2*n*[0.0])\n", - "\n", - " # optimize the task\n", - " task.putobjsense(mosek.objsense.minimize)\n", - " task.optimize()\n", - " task.solutionsummary(mosek.streamtype.log)\n", - " x = n*[0.0]\n", - " task.getsolutionslice(mosek.soltype.itr, mosek.solitem.xx, 0, n, x)\n", - "\n", - " return matrix(x)\n", - "\n", - " def l1regls_mosek2(A, b):\n", - " \"\"\"\n", - "\n", - " Returns the solution of l1-norm regularized least-squares problem\n", - "\n", - " minimize w'*w + e'*u\n", - "\n", - " subject to -u <= x <= u\n", - "\n", - " A*x - w = b\n", - "\n", - " \"\"\"\n", - "\n", - " m, n = A.size\n", - "\n", - " env = mosek.Env()\n", - " task = env.Task(0,0)\n", - " task.set_Stream(mosek.streamtype.log, lambda x: sys.stdout.write(x))\n", - "\n", - " task.appendvars(2*n + m) # number of variables\n", - " task.appendcons(2*n + m) # number of constraints\n", - "\n", - " # input quadratic objective\n", - " task.putqobj(range(2*n,2*n+m), range(2*n,2*n+m), m*[2.0])\n", - "\n", - " task.putclist(range(2*n+m), n*[0.0] + n*[1.0] + m*[0.0]) # setup linear objective\n", - "\n", - " # input constraint matrix row by row\n", - " for i in range(n):\n", - " task.putarow( i, [i, n+i], [1.0, -1.0])\n", - " task.putarow( n+i, [i, n+i], [1.0, 1.0])\n", - "\n", - " for i in range(m):\n", - " task.putarow( 2*n+i, range(n) + [2*n+i], list(A[i,:]) + [-1.0])\n", - "\n", - " # setup bounds on constraints\n", - " task.putboundslice(mosek.accmode.con,\n", - " 0, n, n*[mosek.boundkey.up], n*[0.0], n*[0.0])\n", - " task.putboundslice(mosek.accmode.con,\n", - " n, 2*n, n*[mosek.boundkey.lo], n*[0.0], n*[0.0])\n", - " task.putboundslice(mosek.accmode.con,\n", - " 2*n, 2*n+m, m*[mosek.boundkey.fx], list(b), list(b))\n", - "\n", - " # setup variable bounds\n", - " task.putboundslice(mosek.accmode.var, 0, 2*n+m, (2*n+m)*[mosek.boundkey.fr], \n", - " (2*n+m)*[0.0], (2*n+m)*[0.0])\n", - "\n", - " # optimize the task\n", - " task.putobjsense(mosek.objsense.minimize)\n", - " task.optimize()\n", - " task.solutionsummary(mosek.streamtype.log)\n", - " x = n*[0.0]\n", - " task.getsolutionslice(mosek.soltype.itr, mosek.solitem.xx, 0, n, x)\n", - "\n", - " return matrix(x)\n", - "\n", - "def l1regls(A, b):\n", - " \"\"\"\n", - " \n", - " Returns the solution of l1-norm regularized least-squares problem\n", - " \n", - " minimize || A*x - b ||_2^2 + || x ||_1.\n", - "\n", - " \"\"\"\n", - "\n", - " m, n = A.size\n", - " q = matrix(1.0, (2*n,1))\n", - " q[:n] = -2.0 * A.T * b\n", - "\n", - " def P(u, v, alpha = 1.0, beta = 0.0 ):\n", - " \"\"\"\n", - " v := alpha * 2.0 * [ A'*A, 0; 0, 0 ] * u + beta * v \n", - " \"\"\"\n", - " v *= beta\n", - " v[:n] += alpha * 2.0 * A.T * (A * u[:n])\n", - "\n", - "\n", - " def G(u, v, alpha=1.0, beta=0.0, trans='N'):\n", - " \"\"\"\n", - " v := alpha*[I, -I; -I, -I] * u + beta * v (trans = 'N' or 'T')\n", - " \"\"\"\n", - "\n", - " v *= beta\n", - " v[:n] += alpha*(u[:n] - u[n:])\n", - " v[n:] += alpha*(-u[:n] - u[n:])\n", - "\n", - " h = matrix(0.0, (2*n,1))\n", - "\n", - "\n", - " # Customized solver for the KKT system \n", - " #\n", - " # [ 2.0*A'*A 0 I -I ] [x[:n] ] [bx[:n] ]\n", - " # [ 0 0 -I -I ] [x[n:] ] = [bx[n:] ].\n", - " # [ I -I -D1^-1 0 ] [zl[:n]] [bzl[:n]]\n", - " # [ -I -I 0 -D2^-1 ] [zl[n:]] [bzl[n:]]\n", - " #\n", - " # where D1 = W['di'][:n]**2, D2 = W['di'][:n]**2.\n", - " # \n", - " # We first eliminate zl and x[n:]:\n", - " #\n", - " # ( 2*A'*A + 4*D1*D2*(D1+D2)^-1 ) * x[:n] = \n", - " # bx[:n] - (D2-D1)*(D1+D2)^-1 * bx[n:] + \n", - " # D1 * ( I + (D2-D1)*(D1+D2)^-1 ) * bzl[:n] - \n", - " # D2 * ( I - (D2-D1)*(D1+D2)^-1 ) * bzl[n:] \n", - " #\n", - " # x[n:] = (D1+D2)^-1 * ( bx[n:] - D1*bzl[:n] - D2*bzl[n:] ) \n", - " # - (D2-D1)*(D1+D2)^-1 * x[:n] \n", - " #\n", - " # zl[:n] = D1 * ( x[:n] - x[n:] - bzl[:n] )\n", - " # zl[n:] = D2 * (-x[:n] - x[n:] - bzl[n:] ).\n", - " #\n", - " # The first equation has the form\n", - " #\n", - " # (A'*A + D)*x[:n] = rhs\n", - " #\n", - " # and is equivalent to\n", - " #\n", - " # [ D A' ] [ x:n] ] = [ rhs ]\n", - " # [ A -I ] [ v ] [ 0 ].\n", - " #\n", - " # It can be solved as \n", - " #\n", - " # ( A*D^-1*A' + I ) * v = A * D^-1 * rhs\n", - " # x[:n] = D^-1 * ( rhs - A'*v ).\n", - "\n", - " S = matrix(0.0, (m,m))\n", - " Asc = matrix(0.0, (m,n))\n", - " v = matrix(0.0, (m,1))\n", - "\n", - " def Fkkt(W):\n", - "\n", - " # Factor \n", - " #\n", - " # S = A*D^-1*A' + I \n", - " #\n", - " # where D = 2*D1*D2*(D1+D2)^-1, D1 = d[:n]**-2, D2 = d[n:]**-2.\n", - "\n", - " d1, d2 = W['di'][:n]**2, W['di'][n:]**2\n", - "\n", - " # ds is square root of diagonal of D\n", - " ds = math.sqrt(2.0) * div( mul( W['di'][:n], W['di'][n:]), \n", - " sqrt(d1+d2) )\n", - " d3 = div(d2 - d1, d1 + d2)\n", - " \n", - " # Asc = A*diag(d)^-1/2\n", - " Asc = A * spdiag(ds**-1)\n", - "\n", - " # S = I + A * D^-1 * A'\n", - " blas.syrk(Asc, S)\n", - " S[::m+1] += 1.0 \n", - " lapack.potrf(S)\n", - "\n", - " def g(x, y, z):\n", - "\n", - " x[:n] = 0.5 * ( x[:n] - mul(d3, x[n:]) + \n", - " mul(d1, z[:n] + mul(d3, z[:n])) - mul(d2, z[n:] - \n", - " mul(d3, z[n:])) )\n", - " x[:n] = div( x[:n], ds) \n", - "\n", - " # Solve\n", - " #\n", - " # S * v = 0.5 * A * D^-1 * ( bx[:n] - \n", - " # (D2-D1)*(D1+D2)^-1 * bx[n:] + \n", - " # D1 * ( I + (D2-D1)*(D1+D2)^-1 ) * bzl[:n] - \n", - " # D2 * ( I - (D2-D1)*(D1+D2)^-1 ) * bzl[n:] )\n", - " \n", - " blas.gemv(Asc, x, v)\n", - " lapack.potrs(S, v)\n", - " \n", - " # x[:n] = D^-1 * ( rhs - A'*v ).\n", - " blas.gemv(Asc, v, x, alpha=-1.0, beta=1.0, trans='T')\n", - " x[:n] = div(x[:n], ds)\n", - "\n", - " # x[n:] = (D1+D2)^-1 * ( bx[n:] - D1*bzl[:n] - D2*bzl[n:] ) \n", - " # - (D2-D1)*(D1+D2)^-1 * x[:n] \n", - " x[n:] = div( x[n:] - mul(d1, z[:n]) - mul(d2, z[n:]), d1+d2 )\\\n", - " - mul( d3, x[:n] )\n", - " \n", - " # zl[:n] = D1^1/2 * ( x[:n] - x[n:] - bzl[:n] )\n", - " # zl[n:] = D2^1/2 * ( -x[:n] - x[n:] - bzl[n:] ).\n", - " z[:n] = mul( W['di'][:n], x[:n] - x[n:] - z[:n] ) \n", - " z[n:] = mul( W['di'][n:], -x[:n] - x[n:] - z[n:] ) \n", - "\n", - " return g\n", - "\n", - " return solvers.coneqp(P, q, G, h, kktsolver = Fkkt)['x'][:n]" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Then we call the above functions and solve the problem, as done here" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "from cvxopt import matrix, normal\n", - "\n", - "X = matrix( [ [ 2, 0, 1], [0, 1, 3]])\n", - "y = matrix( [4, 2, 3])\n", - "x = l1regls(X,y)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "**More text will be added to this example.**\n", - "\n", - "## Linking the regression analysis with a statistical interpretation\n", - "\n", - "We will now couple the discussions of ordinary least squares, Ridge\n", - "and Lasso regression with a statistical interpretation, that is we\n", - "move from a linear algebra analysis to a statistical analysis. In\n", - "particular, we will focus on what the regularization terms can result\n", - "in. We will amongst other things show that the regularization\n", - "parameter can reduce considerably the variance of the parameters\n", - "$\\beta$.\n", - "\n", - "\n", - "The\n", - "advantage of doing linear regression is that we actually end up with\n", - "analytical expressions for several statistical quantities. \n", - "Standard least squares and Ridge regression allow us to\n", - "derive quantities like the variance and other expectation values in a\n", - "rather straightforward way.\n", - "\n", - "\n", - "It is assumed that $\\varepsilon_i\n", - "\\sim \\mathcal{N}(0, \\sigma^2)$ and the $\\varepsilon_{i}$ are\n", - "independent, i.e.:" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{align*} \n", - "\\mbox{Cov}(\\varepsilon_{i_1},\n", - "\\varepsilon_{i_2}) & = \\left\\{ \\begin{array}{lcc} \\sigma^2 & \\mbox{if}\n", - "& i_1 = i_2, \\\\ 0 & \\mbox{if} & i_1 \\not= i_2. \\end{array} \\right.\n", - "\\end{align*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The randomness of $\\varepsilon_i$ implies that\n", - "$\\mathbf{y}_i$ is also a random variable. In particular,\n", - "$\\mathbf{y}_i$ is normally distributed, because $\\varepsilon_i \\sim\n", - "\\mathcal{N}(0, \\sigma^2)$ and $\\mathbf{X}_{i,\\ast} \\, \\boldsymbol{\\beta}$ is a\n", - "non-random scalar. To specify the parameters of the distribution of\n", - "$\\mathbf{y}_i$ we need to calculate its first two moments. \n", - "\n", - "Recall that $\\boldsymbol{X}$ is a matrix of dimensionality $n\\times p$. The\n", - "notation above $\\mathbf{X}_{i,\\ast}$ means that we are looking at the\n", - "row number $i$ and perform a sum over all values $p$.\n", - "\n", - "\n", - "\n", - "The assumption we have made here can be summarized as (and this is going to be useful when we discuss the bias-variance trade off)\n", - "that there exists a function $f(\\boldsymbol{x})$ and a normal distributed error $\\boldsymbol{\\varepsilon}\\sim \\mathcal{N}(0, \\sigma^2)$\n", - "which describe our data" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{y} = f(\\boldsymbol{x})+\\boldsymbol{\\varepsilon}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We approximate this function with our model from the solution of the linear regression equations, that is our\n", - "function $f$ is approximated by $\\boldsymbol{\\tilde{y}}$ where we want to minimize $(\\boldsymbol{y}-\\boldsymbol{\\tilde{y}})^2$, our MSE, with" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{\\tilde{y}} = \\boldsymbol{X}\\boldsymbol{\\beta}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We can calculate the expectation value of $\\boldsymbol{y}$ for a given element $i$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{align*} \n", - "\\mathbb{E}(y_i) & =\n", - "\\mathbb{E}(\\mathbf{X}_{i, \\ast} \\, \\boldsymbol{\\beta}) + \\mathbb{E}(\\varepsilon_i)\n", - "\\, \\, \\, = \\, \\, \\, \\mathbf{X}_{i, \\ast} \\, \\beta, \n", - "\\end{align*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "while\n", - "its variance is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{align*} \\mbox{Var}(y_i) & = \\mathbb{E} \\{ [y_i\n", - "- \\mathbb{E}(y_i)]^2 \\} \\, \\, \\, = \\, \\, \\, \\mathbb{E} ( y_i^2 ) -\n", - "[\\mathbb{E}(y_i)]^2 \\\\ & = \\mathbb{E} [ ( \\mathbf{X}_{i, \\ast} \\,\n", - "\\beta + \\varepsilon_i )^2] - ( \\mathbf{X}_{i, \\ast} \\, \\boldsymbol{\\beta})^2 \\\\ &\n", - "= \\mathbb{E} [ ( \\mathbf{X}_{i, \\ast} \\, \\boldsymbol{\\beta})^2 + 2 \\varepsilon_i\n", - "\\mathbf{X}_{i, \\ast} \\, \\boldsymbol{\\beta} + \\varepsilon_i^2 ] - ( \\mathbf{X}_{i,\n", - "\\ast} \\, \\beta)^2 \\\\ & = ( \\mathbf{X}_{i, \\ast} \\, \\boldsymbol{\\beta})^2 + 2\n", - "\\mathbb{E}(\\varepsilon_i) \\mathbf{X}_{i, \\ast} \\, \\boldsymbol{\\beta} +\n", - "\\mathbb{E}(\\varepsilon_i^2 ) - ( \\mathbf{X}_{i, \\ast} \\, \\boldsymbol{\\beta})^2 \n", - "\\\\ & = \\mathbb{E}(\\varepsilon_i^2 ) \\, \\, \\, = \\, \\, \\,\n", - "\\mbox{Var}(\\varepsilon_i) \\, \\, \\, = \\, \\, \\, \\sigma^2. \n", - "\\end{align*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Hence, $y_i \\sim \\mathcal{N}( \\mathbf{X}_{i, \\ast} \\, \\boldsymbol{\\beta}, \\sigma^2)$, that is $\\boldsymbol{y}$ follows a normal distribution with \n", - "mean value $\\boldsymbol{X}\\boldsymbol{\\beta}$ and variance $\\sigma^2$ (not be confused with the singular values of the SVD). \n", - "\n", - "\n", - "With the OLS expressions for the parameters $\\boldsymbol{\\beta}$ we can evaluate the expectation value" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbb{E}(\\boldsymbol{\\beta}) = \\mathbb{E}[ (\\mathbf{X}^{\\top} \\mathbf{X})^{-1}\\mathbf{X}^{T} \\mathbf{Y}]=(\\mathbf{X}^{T} \\mathbf{X})^{-1}\\mathbf{X}^{T} \\mathbb{E}[ \\mathbf{Y}]=(\\mathbf{X}^{T} \\mathbf{X})^{-1} \\mathbf{X}^{T}\\mathbf{X}\\boldsymbol{\\beta}=\\boldsymbol{\\beta}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "This means that the estimator of the regression parameters is unbiased.\n", - "\n", - "We can also calculate the variance\n", - "\n", - "The variance of $\\boldsymbol{\\beta}$ is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{eqnarray*}\n", - "\\mbox{Var}(\\boldsymbol{\\beta}) & = & \\mathbb{E} \\{ [\\boldsymbol{\\beta} - \\mathbb{E}(\\boldsymbol{\\beta})] [\\boldsymbol{\\beta} - \\mathbb{E}(\\boldsymbol{\\beta})]^{T} \\}\n", - "\\\\\n", - "& = & \\mathbb{E} \\{ [(\\mathbf{X}^{T} \\mathbf{X})^{-1} \\, \\mathbf{X}^{T} \\mathbf{Y} - \\boldsymbol{\\beta}] \\, [(\\mathbf{X}^{T} \\mathbf{X})^{-1} \\, \\mathbf{X}^{T} \\mathbf{Y} - \\boldsymbol{\\beta}]^{T} \\}\n", - "\\\\\n", - "% & = & \\mathbb{E} \\{ [(\\mathbf{X}^{T} \\mathbf{X})^{-1} \\, \\mathbf{X}^{T} \\mathbf{Y}] \\, [(\\mathbf{X}^{T} \\mathbf{X})^{-1} \\, \\mathbf{X}^{T} \\mathbf{Y}]^{T} \\} - \\boldsymbol{\\beta} \\, \\boldsymbol{\\beta}^{T}\n", - "% \\\\\n", - "% & = & \\mathbb{E} \\{ (\\mathbf{X}^{T} \\mathbf{X})^{-1} \\, \\mathbf{X}^{T} \\mathbf{Y} \\, \\mathbf{Y}^{T} \\, \\mathbf{X} \\, (\\mathbf{X}^{T} \\mathbf{X})^{-1} \\} - \\boldsymbol{\\beta} \\, \\boldsymbol{\\beta}^{T}\n", - "% \\\\\n", - "& = & (\\mathbf{X}^{T} \\mathbf{X})^{-1} \\, \\mathbf{X}^{T} \\, \\mathbb{E} \\{ \\mathbf{Y} \\, \\mathbf{Y}^{T} \\} \\, \\mathbf{X} \\, (\\mathbf{X}^{T} \\mathbf{X})^{-1} - \\boldsymbol{\\beta} \\, \\boldsymbol{\\beta}^{T}\n", - "\\\\\n", - "& = & (\\mathbf{X}^{T} \\mathbf{X})^{-1} \\, \\mathbf{X}^{T} \\, \\{ \\mathbf{X} \\, \\boldsymbol{\\beta} \\, \\boldsymbol{\\beta}^{T} \\, \\mathbf{X}^{T} + \\sigma^2 \\} \\, \\mathbf{X} \\, (\\mathbf{X}^{T} \\mathbf{X})^{-1} - \\boldsymbol{\\beta} \\, \\boldsymbol{\\beta}^{T}\n", - "% \\\\\n", - "% & = & (\\mathbf{X}^T \\mathbf{X})^{-1} \\, \\mathbf{X}^T \\, \\mathbf{X} \\, \\boldsymbol{\\beta} \\, \\boldsymbol{\\beta}^T \\, \\mathbf{X}^T \\, \\mathbf{X} \\, (\\mathbf{X}^T % \\mathbf{X})^{-1}\n", - "% \\\\\n", - "% & & + \\, \\, \\sigma^2 \\, (\\mathbf{X}^T \\mathbf{X})^{-1} \\, \\mathbf{X}^T \\, \\mathbf{X} \\, (\\mathbf{X}^T \\mathbf{X})^{-1} - \\boldsymbol{\\beta} \\boldsymbol{\\beta}^T\n", - "\\\\\n", - "& = & \\boldsymbol{\\beta} \\, \\boldsymbol{\\beta}^{T} + \\sigma^2 \\, (\\mathbf{X}^{T} \\mathbf{X})^{-1} - \\boldsymbol{\\beta} \\, \\boldsymbol{\\beta}^{T}\n", - "\\, \\, \\, = \\, \\, \\, \\sigma^2 \\, (\\mathbf{X}^{T} \\mathbf{X})^{-1},\n", - "\\end{eqnarray*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where we have used that $\\mathbb{E} (\\mathbf{Y} \\mathbf{Y}^{T}) =\n", - "\\mathbf{X} \\, \\boldsymbol{\\beta} \\, \\boldsymbol{\\beta}^{T} \\, \\mathbf{X}^{T} +\n", - "\\sigma^2 \\, \\mathbf{I}_{nn}$. From $\\mbox{Var}(\\boldsymbol{\\beta}) = \\sigma^2\n", - "\\, (\\mathbf{X}^{T} \\mathbf{X})^{-1}$, one obtains an estimate of the\n", - "variance of the estimate of the $j$-th regression coefficient:\n", - "$\\boldsymbol{\\sigma}^2 (\\boldsymbol{\\beta}_j ) = \\boldsymbol{\\sigma}^2 [(\\mathbf{X}^{T} \\mathbf{X})^{-1}]_{jj} $. This may be used to\n", - "construct a confidence interval for the estimates.\n", - "\n", - "\n", - "In a similar way, we can obtain analytical expressions for say the\n", - "expectation values of the parameters $\\boldsymbol{\\beta}$ and their variance\n", - "when we employ Ridge regression, allowing us again to define a confidence interval. \n", - "\n", - "It is rather straightforward to show that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbb{E} \\big[ \\boldsymbol{\\beta}^{\\mathrm{Ridge}} \\big]=(\\mathbf{X}^{T} \\mathbf{X} + \\lambda \\mathbf{I}_{pp})^{-1} (\\mathbf{X}^{\\top} \\mathbf{X})\\boldsymbol{\\beta}^{\\mathrm{OLS}}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We see clearly that \n", - "$\\mathbb{E} \\big[ \\boldsymbol{\\beta}^{\\mathrm{Ridge}} \\big] \\not= \\boldsymbol{\\beta}^{\\mathrm{OLS}}$ for any $\\lambda > 0$. We say then that the ridge estimator is biased.\n", - "\n", - "We can also compute the variance as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mbox{Var}[\\boldsymbol{\\beta}^{\\mathrm{Ridge}}]=\\sigma^2[ \\mathbf{X}^{T} \\mathbf{X} + \\lambda \\mathbf{I} ]^{-1} \\mathbf{X}^{T} \\mathbf{X} \\{ [ \\mathbf{X}^{\\top} \\mathbf{X} + \\lambda \\mathbf{I} ]^{-1}\\}^{T},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and it is easy to see that if the parameter $\\lambda$ goes to infinity then the variance of Ridge parameters $\\boldsymbol{\\beta}$ goes to zero. \n", - "\n", - "With this, we can compute the difference" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mbox{Var}[\\boldsymbol{\\beta}^{\\mathrm{OLS}}]-\\mbox{Var}(\\boldsymbol{\\beta}^{\\mathrm{Ridge}})=\\sigma^2 [ \\mathbf{X}^{T} \\mathbf{X} + \\lambda \\mathbf{I} ]^{-1}[ 2\\lambda\\mathbf{I} + \\lambda^2 (\\mathbf{X}^{T} \\mathbf{X})^{-1} ] \\{ [ \\mathbf{X}^{T} \\mathbf{X} + \\lambda \\mathbf{I} ]^{-1}\\}^{T}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The difference is non-negative definite since each component of the\n", - "matrix product is non-negative definite. \n", - "This means the variance we obtain with the standard OLS will always for $\\lambda > 0$ be larger than the variance of $\\boldsymbol{\\beta}$ obtained with the Ridge estimator. This has interesting consequences when we discuss the so-called bias-variance trade-off below. \n", - "\n", - "\n", - "\n", - "## Deriving OLS from a probability distribution\n", - "\n", - "Our basic assumption when we derived the OLS equations was to assume\n", - "that our output is determined by a given continuous function\n", - "$f(\\boldsymbol{x})$ and a random noise $\\boldsymbol{\\epsilon}$ given by the normal\n", - "distribution with zero mean value and an undetermined variance\n", - "$\\sigma^2$.\n", - "\n", - "We found above that the outputs $\\boldsymbol{y}$ have a mean value given by\n", - "$\\boldsymbol{X}\\hat{\\boldsymbol{\\beta}}$ and variance $\\sigma^2$. Since the entries to\n", - "the design matrix are not stochastic variables, we can assume that the\n", - "probability distribution of our targets is also a normal distribution\n", - "but now with mean value $\\boldsymbol{X}\\hat{\\boldsymbol{\\beta}}$. This means that a\n", - "single output $y_i$ is given by the Gaussian distribution" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "y_i\\sim \\mathcal{N}(\\boldsymbol{X}_{i,*}\\boldsymbol{\\beta}, \\sigma^2)=\\frac{1}{\\sqrt{2\\pi\\sigma^2}}\\exp{\\left[-\\frac{(y_i-\\boldsymbol{X}_{i,*}\\boldsymbol{\\beta})^2}{2\\sigma^2}\\right]}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We assume now that the various $y_i$ values are stochastically distributed according to the above Gaussian distribution. \n", - "We define this distribution as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(y_i, \\boldsymbol{X}\\vert\\boldsymbol{\\beta})=\\frac{1}{\\sqrt{2\\pi\\sigma^2}}\\exp{\\left[-\\frac{(y_i-\\boldsymbol{X}_{i,*}\\boldsymbol{\\beta})^2}{2\\sigma^2}\\right]},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which reads as finding the likelihood of an event $y_i$ with the input variables $\\boldsymbol{X}$ given the parameters (to be determined) $\\boldsymbol{\\beta}$.\n", - "\n", - "Since these events are assumed to be independent and identicall distributed we can build the probability distribution function (PDF) for all possible event $\\boldsymbol{y}$ as the product of the single events, that is we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(\\boldsymbol{y},\\boldsymbol{X}\\vert\\boldsymbol{\\beta})=\\prod_{i=0}^{n-1}\\frac{1}{\\sqrt{2\\pi\\sigma^2}}\\exp{\\left[-\\frac{(y_i-\\boldsymbol{X}_{i,*}\\boldsymbol{\\beta})^2}{2\\sigma^2}\\right]}=\\prod_{i=0}^{n-1}p(y_i,\\boldsymbol{X}\\vert\\boldsymbol{\\beta}).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We will write this in a more compact form reserving $\\boldsymbol{D}$ for the domain of events, including the ouputs (targets) and the inputs. That is\n", - "in case we have a simple one-dimensional input and output case" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{D}=[(x_0,y_0), (x_1,y_1),\\dots, (x_{n-1},y_{n-1})].\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In the more general case the various inputs should be replaced by the possible features represented by the input data set $\\boldsymbol{X}$. \n", - "We can now rewrite the above probability as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(\\boldsymbol{D}\\vert\\boldsymbol{\\beta})=\\prod_{i=0}^{n-1}\\frac{1}{\\sqrt{2\\pi\\sigma^2}}\\exp{\\left[-\\frac{(y_i-\\boldsymbol{X}_{i,*}\\boldsymbol{\\beta})^2}{2\\sigma^2}\\right]}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "It is a conditional probability (see below) and reads as the\n", - "likelihood of a domain of events $\\boldsymbol{D}$ given a set of parameters\n", - "$\\boldsymbol{\\beta}$.\n", - "\n", - "\n", - "In statistics, maximum likelihood estimation (MLE) is a method of\n", - "estimating the parameters of an assumed probability distribution,\n", - "given some observed data. This is achieved by maximizing a likelihood\n", - "function so that, under the assumed statistical model, the observed\n", - "data is the most probable. \n", - "\n", - "\n", - "We will assume here that our events are given by the above Gaussian\n", - "distribution and we will determine the optimal parameters $\\beta$ by\n", - "maximizing the above PDF. However, computing the derivatives of a\n", - "product function is cumbersome and can easily lead to overflow and/or\n", - "underflowproblems, with potentials for loss of numerical precision.\n", - "\n", - "\n", - "In practice, it is more convenient to maximize the logarithm of the\n", - "PDF because it is a monotonically increasing function of the argument.\n", - "Alternatively, and this will be our option, we will minimize the\n", - "negative of the logarithm since this is a monotonically decreasing\n", - "function.\n", - "\n", - "Note also that maximization/minimization of the logarithm of the PDF\n", - "is equivalent to the maximization/minimization of the function itself.\n", - "\n", - "\n", - "\n", - "\n", - "We could now define a new cost function to minimize, namely the negative logarithm of the above PDF" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(\\boldsymbol{\\beta}=-\\log{\\prod_{i=0}^{n-1}p(y_i,\\boldsymbol{X}\\vert\\boldsymbol{\\beta})}=-\\sum_{i=0}^{n-1}\\log{p(y_i,\\boldsymbol{X}\\vert\\boldsymbol{\\beta})},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which becomes" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(\\boldsymbol{\\beta}=\\frac{n}{2}\\log{2\\pi\\sigma^2}+\\frac{\\vert\\vert (\\boldsymbol{y}-\\boldsymbol{X}\\boldsymbol{\\beta})\\vert\\vert_2^2}{2\\sigma^2}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Taking the derivative of the *new* cost function with respect to the parameters $\\beta$ we recognize our familiar OLS equation, namely" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}^T\\left(\\boldsymbol{y}-\\boldsymbol{X}\\boldsymbol{\\beta}\\right) =0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which leads to the well-known OLS equation for the optimal paramters $\\beta$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\hat{\\boldsymbol{\\beta}}^{\\mathrm{OLS}}=\\left(\\boldsymbol{X}^T\\boldsymbol{X}\\right)^{-1}\\boldsymbol{X}^T\\boldsymbol{y}!\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Before we make a similar analysis for Ridge and Lasso regression, we need a short reminder on statistics. \n", - "\n", - "\n", - "A central theorem in statistics is Bayes' theorem. This theorem plays a similar role as the good old Pythagoras' theorem in geometry.\n", - "Bayes' theorem is extremely simple to derive. But to do so we need some basic axioms from statistics.\n", - "\n", - "Assume we have two domains of events $X=[x_0,x_1,\\dots,x_{n-1}]$ and $Y=[y_0,y_1,\\dots,y_{n-1}]$.\n", - "\n", - "We define also the likelihood for $X$ and $Y$ as $p(X)$ and $p(Y)$ respectively.\n", - "The likelihood of a specific event $x_i$ (or $y_i$) is then written as $p(X=x_i)$ or just $p(x_i)=p_i$. \n", - "\n", - "The union of events is given by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(X \\cup Y)= p(X)+p(Y)-p(X \\cap Y).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The product rule (aka joint probability) is given by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(X \\cup Y)= p(X,Y)= p(X\\vert Y)p(Y)=p(Y\\vert X)p(X),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where we read $p(X\\vert Y)$ as the likelihood of obtaining $X$ given $Y$.\n", - "\n", - "If we have independent events then $p(X,Y)=p(X)p(Y)$.\n", - "\n", - "\n", - "\n", - "The marginal probability is defined in terms of only one of the set of variables $X,Y$. For a discrete probability we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(X)=\\sum_{i=0}^{n-1}p(X,Y=y_i)=\\sum_{i=0}^{n-1}p(X\\vert Y=y_i)p(Y=y_i)=\\sum_{i=0}^{n-1}p(X\\vert y_i)p(y_i).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The conditional probability, if $p(Y) > 0$, is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(X\\vert Y)= \\frac{p(X,Y)}{p(Y)}=\\frac{p(X,Y)}{\\sum_{i=0}^{n-1}p(Y\\vert X=x_i)p(x_i)}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "If we combine the conditional probability with the marginal probability and the standard product rule, we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(X\\vert Y)= \\frac{p(X,Y)}{p(Y)},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which we can rewrite as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(X\\vert Y)= \\frac{p(X,Y)}{\\sum_{i=0}^{n-1}p(Y\\vert X=x_i)p(x_i)}=\\frac{p(Y\\vert X)p(X)}{\\sum_{i=0}^{n-1}p(Y\\vert X=x_i)p(x_i)},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which is Bayes' theorem. It allows us to evaluate the uncertainty in in $X$ after we have observed $Y$. We can easily interchange $X$ with $Y$. \n", - "\n", - "\n", - "The quantity $p(Y\\vert X)$ on the right-hand side of the theorem is\n", - "evaluated for the observed data $Y$ and can be viewed as a function of\n", - "the parameter space represented by $X$. This function is not\n", - "necesseraly normalized and is normally called the likelihood function.\n", - "\n", - "The function $p(X)$ on the right hand side is called the prior while\n", - "the function on the left hand side is the called the posterior\n", - "probability. The denominator on the right hand side serves as a\n", - "normalization factor for the posterior distribution.\n", - "\n", - "Let us try to illustrate Bayes' theorem through an example.\n", - "\n", - "\n", - "Let us suppose that you are undergoing a series of mammography scans\n", - "in order to rule out possible breast cancer cases. We define the\n", - "sensitivity for a positive event by the variable $X$. It takes binary\n", - "values with $X=1$ representing a positive event and $X=0$ being a\n", - "negative event. We reserve $Y$ as a classification parameter for\n", - "either a negative or a positive breast cancer confirmation. (Short\n", - "note on wordings: positive here means having breast cancer, although\n", - "none of us would consider this being a positive thing).\n", - "\n", - "We let $Y=1$ represent the the case of having breast cancer and $Y=0$ as not.\n", - "\n", - "Let us assume that if you have breast cancer, the test will be positive with a probability of $0.8$ (the numbers here are all made up),\n", - "that is we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(X=1\\vert Y=1) =0.8.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "This obviously sounds scary since many would conclude that if the test\n", - "is positive, there is a likelihood of $80\\%$ for having cancer. It is\n", - "however not correct, as the following Bayesian analysis shows. The correct question to pose is *what is the probability of having breast cancer in case of a positive test?*\n", - "We are thus interested in" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(Y=1\\vert X=1),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "instead of $p(X=1\\vert Y=1)$.\n", - "\n", - "\n", - "\n", - "If we look at various national surveys on breast cancer, the general\n", - "likelihood of developing breast cancer is a very small number. Let us\n", - "assume that the prior probability in the population as a whole is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(Y=1) =0.004.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We need also to account for the fact that the test may produce a false\n", - "positive result (false alarm). Let us here assume that we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(X=1\\vert Y=0) =0.1.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Using Bayes' theorem we can then find the posterior probability that\n", - "the person has breast cancer in case of a positive test, that is we\n", - "can compute" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - "p(Y=1\\vert X=1)=\\frac{p(X=1\\vert Y=1)p(Y=1)}{p(X=1\\vert Y=1)p(Y=1)+p(X=1\\vert Y=0)p(Y=0)}= \n", - "\\label{_auto2} \\tag{2}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation} \n", - " \\frac{0.8\\times 0.004}{0.8\\times 0.004+0.1\\times 0.996}=0.031.\n", - "\\label{_auto3} \\tag{3}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "That is, in case of a positive test, there is only a $3\\%$ chance of having breast cancer!\n", - "\n", - "\n", - "\n", - "## Bayes' Theorem and Ridge and Lasso Regression\n", - "\n", - "Hitherto we have discussed Ridge and Lasso regression in terms of a\n", - "linear analysis. This may to many of you feel rather technical and\n", - "perhaps not that intuitive. The question is whether we can develop a\n", - "more intuitive way of understanding what Ridge and Lasso express.\n", - "\n", - "Before we proceed let us perform a Ridge, Lasso and OLS analysis of a polynomial fit. \n", - "\n", - "\n", - "We will play around with a study of the values for the optimal\n", - "parameters $\\boldsymbol{\\beta}$ using OLS, Ridge and Lasso regression. For\n", - "OLS, you will notice as function of the noise and polynomial degree,\n", - "that the parameters $\\beta$ will fluctuate from order to order in the\n", - "polynomial fit and that for larger and larger polynomial degrees of\n", - "freedom, the parameters will tend to increase in value for OLS.\n", - "\n", - "For Ridge and Lasso regression, the higher order parameters will\n", - "typically be reduced, providing thereby less fluctuations from one\n", - "order to another one." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import numpy as np\n", - "import matplotlib.pyplot as plt\n", - "from sklearn.model_selection import train_test_split\n", - "from sklearn import linear_model\n", - "\n", - "def R2(y_data, y_model):\n", - " return 1 - np.sum((y_data - y_model) ** 2) / np.sum((y_data - np.mean(y_data)) ** 2)\n", - "def MSE(y_data,y_model):\n", - " n = np.size(y_model)\n", - " return np.sum((y_data-y_model)**2)/n\n", - "\n", - "# Make data set.\n", - "n = 10000\n", - "x = np.random.rand(n)\n", - "y = np.exp(-x**2) + 1.5 * np.exp(-(x-2)**2)+ np.random.randn(n)\n", - "\n", - "Maxpolydegree = 5\n", - "X = np.zeros((len(x),Maxpolydegree))\n", - "X[:,0] = 1.0\n", - "\n", - "for polydegree in range(1, Maxpolydegree):\n", - " for degree in range(polydegree):\n", - " X[:,degree] = x**(degree)\n", - "\n", - "\n", - "# We split the data in test and training data\n", - "X_train, X_test, y_train, y_test = train_test_split(X, y, test_size=0.2)\n", - "\n", - "# matrix inversion to find beta\n", - "OLSbeta = np.linalg.pinv(X_train.T @ X_train) @ X_train.T @ y_train\n", - "print(OLSbeta)\n", - "ypredictOLS = X_test @ OLSbeta\n", - "print(\"Test MSE OLS\")\n", - "print(MSE(y_test,ypredictOLS))\n", - "# Repeat now for Lasso and Ridge regression and various values of the regularization parameter using Scikit-Learn\n", - "# Decide which values of lambda to use\n", - "nlambdas = 4\n", - "MSERidgePredict = np.zeros(nlambdas)\n", - "MSELassoPredict = np.zeros(nlambdas)\n", - "lambdas = np.logspace(-3, 1, nlambdas)\n", - "for i in range(nlambdas):\n", - " lmb = lambdas[i]\n", - " # Make the fit using Ridge and Lasso\n", - " RegRidge = linear_model.Ridge(lmb,fit_intercept=False)\n", - " RegRidge.fit(X_train,y_train)\n", - " RegLasso = linear_model.Lasso(lmb,fit_intercept=False)\n", - " RegLasso.fit(X_train,y_train)\n", - " # and then make the prediction\n", - " ypredictRidge = RegRidge.predict(X_test)\n", - " ypredictLasso = RegLasso.predict(X_test)\n", - " # Compute the MSE and print it\n", - " MSERidgePredict[i] = MSE(y_test,ypredictRidge)\n", - " MSELassoPredict[i] = MSE(y_test,ypredictLasso)\n", - "# print(lmb,RegRidge.coef_)\n", - "# print(lmb,RegLasso.coef_)\n", - "# Now plot the results\n", - "plt.figure()\n", - "plt.plot(np.log10(lambdas), MSERidgePredict, 'b', label = 'MSE Ridge Test')\n", - "plt.plot(np.log10(lambdas), MSELassoPredict, 'r', label = 'MSE Lasso Test')\n", - "plt.xlabel('log10(lambda)')\n", - "plt.ylabel('MSE')\n", - "plt.legend()\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "How can we understand this?\n", - "\n", - "Let us write out the values of the coefficients $\\beta_i$ as functions\n", - "of the polynomial degree and noise. We will focus only on the Ridge\n", - "results and some few selected values of the hyperparameter $\\lambda$.\n", - "\n", - "If we don't include any noise and run this code for different values\n", - "of the polynomial degree, we notice that the results for $\\beta_i$ do\n", - "not show great changes from one order to the next. This is an\n", - "indication that for higher polynomial orders, our parameters become\n", - "less important.\n", - "\n", - "If we however add noise, what happens is that the polynomial fit is\n", - "trying to adjust the fit to traverse in the best possible way all data\n", - "points. This can lead to large fluctuations in the parameters\n", - "$\\beta_i$ as functions of polynomial order. It will also be reflected\n", - "in a larger value of the variance of each parameter $\\beta_i$. What\n", - "Ridge regression (and Lasso as well) are doing then is to try to\n", - "quench the fluctuations in the parameters of $\\beta_i$ which have a\n", - "large variance (normally for higher orders in the polynomial)." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import numpy as np\n", - "import pandas as pd\n", - "from IPython.display import display\n", - "import matplotlib.pyplot as plt\n", - "from sklearn.model_selection import train_test_split\n", - "from sklearn import linear_model\n", - "\n", - "# Make data set.\n", - "n = 1000\n", - "x = np.random.rand(n)\n", - "y = np.exp(-x**2) + 1.5 * np.exp(-(x-2)**2)+ np.random.randn(n)\n", - "\n", - "Maxpolydegree = 5\n", - "X = np.zeros((len(x),Maxpolydegree))\n", - "X[:,0] = 1.0\n", - "\n", - "for polydegree in range(1, Maxpolydegree):\n", - " for degree in range(polydegree):\n", - " X[:,degree] = x**(degree)\n", - "\n", - "\n", - "# We split the data in test and training data\n", - "X_train, X_test, y_train, y_test = train_test_split(X, y, test_size=0.2)\n", - "\n", - "# Decide which values of lambda to use\n", - "nlambdas = 5\n", - "lambdas = np.logspace(-3, 2, nlambdas)\n", - "for i in range(nlambdas):\n", - " lmb = lambdas[i]\n", - " # Make the fit using Ridge only\n", - " RegRidge = linear_model.Ridge(lmb,fit_intercept=False)\n", - " RegRidge.fit(X_train,y_train)\n", - " # and then make the prediction\n", - " ypredictRidge = RegRidge.predict(X_test)\n", - " Coeffs = np.array(RegRidge.coef_)\n", - " BetaValues = pd.DataFrame(Coeffs)\n", - " BetaValues.columns = ['beta']\n", - " display(BetaValues)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "As an exercise, repeat these calculations with ordinary least squares\n", - "only with and without noise. Calculate thereafter the variance of the\n", - "parameters $\\beta_j$ as function of polynomial order and of the added\n", - "noise. Here we recommend to use $\\sigma^2=1$ as variance for the\n", - "added noise (which follows a normal distribution with mean value zero).\n", - "Comment your results. If you have a large noise term, do the parameters $\\beta_j$ vary more as function\n", - "model complexity? And what about their variance? \n", - "\n", - "\n", - "\n", - "\n", - "## Linking Bayes' Theorem with Ridge and Lasso Regression\n", - "\n", - "We have seen that Ridge regression suppresses those features which\n", - "have a small singular value. This corresponds to a feature which exhibits\n", - "a large variance in the parameters $\\beta_j$.\n", - "Our analysis hitherto has been based on linear algebra. To add to our intuition, we will use\n", - "Bayes' theorem in order to deepen our understanding of Ridge and Lasso regression. \n", - "\n", - "For ordinary least squares we postulated that the maximum likelihood for the domain of events $\\boldsymbol{D}$ (one-dimensional case)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{D}=[(x_0,y_0), (x_1,y_1),\\dots, (x_{n-1},y_{n-1})],\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "is given by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(\\boldsymbol{D}\\vert\\boldsymbol{\\beta})=\\prod_{i=0}^{n-1}\\frac{1}{\\sqrt{2\\pi\\sigma^2}}\\exp{\\left[-\\frac{(y_i-\\boldsymbol{X}_{i,*}\\boldsymbol{\\beta})^2}{2\\sigma^2}\\right]}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In Bayes' theorem this function plays the role of the so-called likelihood. We could now ask the question what is the posterior probability of a parameter set $\\boldsymbol{\\beta}$ given a domain of events $\\boldsymbol{D}$? That is, how can we define the posterior probability" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(\\boldsymbol{\\beta}\\vert\\boldsymbol{D}).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Bayes' theorem comes to our rescue here since (omitting the normalization constant)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(\\boldsymbol{\\beta}\\vert\\boldsymbol{D})\\propto p(\\boldsymbol{D}\\vert\\boldsymbol{\\beta})p(\\boldsymbol{\\beta}).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We have a model for $p(\\boldsymbol{D}\\vert\\boldsymbol{\\beta})$ but need one for the **prior** $p(\\boldsymbol{\\beta}$! \n", - "\n", - "\n", - "\n", - "With the posterior probability defined by a likelihood which we have\n", - "already modeled and an unknown prior, we are now ready to make\n", - "additional models for the prior.\n", - "\n", - "We can, based on our discussions of the variance of $\\boldsymbol{\\beta}$ and\n", - "the mean value, assume that the prior for the values $\\boldsymbol{\\beta}$ is\n", - "given by a Gaussian with mean value zero and variance $\\tau^2$, that\n", - "is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(\\boldsymbol{\\beta})=\\prod_{j=0}^{p-1}\\exp{\\left(-\\frac{\\beta_j^2}{2\\tau^2}\\right)}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Our posterior probability becomes then (omitting the normalization factor which is just a constant)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(\\boldsymbol{\\beta\\vert\\boldsymbol{D})}=\\prod_{i=0}^{n-1}\\frac{1}{\\sqrt{2\\pi\\sigma^2}}\\exp{\\left[-\\frac{(y_i-\\boldsymbol{X}_{i,*}\\boldsymbol{\\beta})^2}{2\\sigma^2}\\right]}\\prod_{j=0}^{p-1}\\exp{\\left(-\\frac{\\beta_j^2}{2\\tau^2}\\right)}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We can now optimize this quantity with respect to $\\boldsymbol{\\beta}$. As we\n", - "did for OLS, this is most conveniently done by taking the negative\n", - "logarithm of the posterior probability. Doing so and leaving out the\n", - "terms that do not depend on $\\beta$, we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(\\boldsymbol{\\beta})=\\frac{\\vert\\vert (\\boldsymbol{y}-\\boldsymbol{X}\\boldsymbol{\\beta})\\vert\\vert_2^2}{2\\sigma^2}+\\frac{1}{2\\tau^2}\\vert\\vert\\boldsymbol{\\beta}\\vert\\vert_2^2,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and replacing $1/2\\tau^2$ with $\\lambda$ we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(\\boldsymbol{\\beta})=\\frac{\\vert\\vert (\\boldsymbol{y}-\\boldsymbol{X}\\boldsymbol{\\beta})\\vert\\vert_2^2}{2\\sigma^2}+\\lambda\\vert\\vert\\boldsymbol{\\beta}\\vert\\vert_2^2,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which is our Ridge cost function! Nice, isn't it?\n", - "\n", - "\n", - "To derive the Lasso cost function, we simply replace the Gaussian prior with an exponential distribution ([Laplace in this case](https://en.wikipedia.org/wiki/Laplace_distribution)) with zero mean value, that is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(\\boldsymbol{\\beta})=\\prod_{j=0}^{p-1}\\exp{\\left(-\\frac{\\vert\\beta_j\\vert}{\\tau}\\right)}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Our posterior probability becomes then (omitting the normalization factor which is just a constant)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(\\boldsymbol{\\beta}\\vert\\boldsymbol{D})=\\prod_{i=0}^{n-1}\\frac{1}{\\sqrt{2\\pi\\sigma^2}}\\exp{\\left[-\\frac{(y_i-\\boldsymbol{X}_{i,*}\\boldsymbol{\\beta})^2}{2\\sigma^2}\\right]}\\prod_{j=0}^{p-1}\\exp{\\left(-\\frac{\\vert\\beta_j\\vert}{\\tau}\\right)}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Taking the negative\n", - "logarithm of the posterior probability and leaving out the\n", - "constants terms that do not depend on $\\beta$, we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(\\boldsymbol{\\beta}=\\frac{\\vert\\vert (\\boldsymbol{y}-\\boldsymbol{X}\\boldsymbol{\\beta})\\vert\\vert_2^2}{2\\sigma^2}+\\frac{1}{\\tau}\\vert\\vert\\boldsymbol{\\beta}\\vert\\vert_1,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and replacing $1/\\tau$ with $\\lambda$ we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(\\boldsymbol{\\beta}=\\frac{\\vert\\vert (\\boldsymbol{y}-\\boldsymbol{X}\\boldsymbol{\\beta})\\vert\\vert_2^2}{2\\sigma^2}+\\lambda\\vert\\vert\\boldsymbol{\\beta}\\vert\\vert_1,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which is our Lasso cost function! \n", - "\n", - "\n", - "Plotting these prior functions shows us that we can use the parameter\n", - "$\\lambda$ to shrink or increase the role of a given parameter\n", - "$\\beta_j$. The variance for the Laplace distribution is\n", - "$2\\tau^2=1/\\lambda$ while for the Gaussian distribution it is\n", - "$\\sigma^2=1/(2\\lambda)$. Thus, increasing the variance means\n", - "decreasing $\\lambda$ and shrinking the variance means increasing\n", - "$\\lamdbda$. When we increase $\\lambda$, this corresponds to shrinking the role of less important features (small singular values)." - ] - } - ], - "metadata": {}, - "nbformat": 4, - "nbformat_minor": 4 -} diff --git a/doc/LectureNotes/_build/html/_sources/chapter3.ipynb b/doc/LectureNotes/_build/html/_sources/chapter3.ipynb deleted file mode 100644 index 7cb02906e..000000000 --- a/doc/LectureNotes/_build/html/_sources/chapter3.ipynb +++ /dev/null @@ -1,3565 +0,0 @@ -{ - "cells": [ - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "# Resampling Methods\n", - "\n", - "## Introduction\n", - "\n", - "Resampling methods are an indispensable tool in modern\n", - "statistics. They involve repeatedly drawing samples from a training\n", - "set and refitting a model of interest on each sample in order to\n", - "obtain additional information about the fitted model. For example, in\n", - "order to estimate the variability of a linear regression fit, we can\n", - "repeatedly draw different samples from the training data, fit a linear\n", - "regression to each new sample, and then examine the extent to which\n", - "the resulting fits differ. Such an approach may allow us to obtain\n", - "information that would not be available from fitting the model only\n", - "once using the original training sample.\n", - "\n", - "Two resampling methods are often used in Machine Learning analyses,\n", - "1. The **bootstrap method**\n", - "\n", - "2. and **Cross-Validation**\n", - "\n", - "In addition there are several other methods such as the Jackknife and the Blocking methods. We will discuss in particular\n", - "cross-validation and the bootstrap method. \n", - "\n", - "\n", - "Resampling approaches can be computationally expensive, because they\n", - "involve fitting the same statistical method multiple times using\n", - "different subsets of the training data. However, due to recent\n", - "advances in computing power, the computational requirements of\n", - "resampling methods generally are not prohibitive. In this chapter, we\n", - "discuss two of the most commonly used resampling methods,\n", - "cross-validation and the bootstrap. Both methods are important tools\n", - "in the practical application of many statistical learning\n", - "procedures. For example, cross-validation can be used to estimate the\n", - "test error associated with a given statistical learning method in\n", - "order to evaluate its performance, or to select the appropriate level\n", - "of flexibility. The process of evaluating a model’s performance is\n", - "known as model assessment, whereas the process of selecting the proper\n", - "level of flexibility for a model is known as model selection. The\n", - "bootstrap is widely used.\n", - "\n", - "\n", - "* Our simulations can be treated as *computer experiments*. This is particularly the case for Monte Carlo methods\n", - "\n", - "* The results can be analysed with the same statistical tools as we would use analysing experimental data.\n", - "\n", - "* As in all experiments, we are looking for expectation values and an estimate of how accurate they are, i.e., possible sources for errors.\n", - "\n", - "## Reminder on Statistics\n", - "\n", - "\n", - "* As in other experiments, many numerical experiments have two classes of errors:\n", - "\n", - " * Statistical errors\n", - "\n", - " * Systematical errors\n", - "\n", - "\n", - "* Statistical errors can be estimated using standard tools from statistics\n", - "\n", - "* Systematical errors are method specific and must be treated differently from case to case. \n", - "\n", - "The\n", - "advantage of doing linear regression is that we actually end up with\n", - "analytical expressions for several statistical quantities. \n", - "Standard least squares and Ridge regression allow us to\n", - "derive quantities like the variance and other expectation values in a\n", - "rather straightforward way.\n", - "\n", - "\n", - "It is assumed that $\\varepsilon_i\n", - "\\sim \\mathcal{N}(0, \\sigma^2)$ and the $\\varepsilon_{i}$ are\n", - "independent, i.e.:" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{align*} \n", - "\\mbox{Cov}(\\varepsilon_{i_1},\n", - "\\varepsilon_{i_2}) & = \\left\\{ \\begin{array}{lcc} \\sigma^2 & \\mbox{if}\n", - "& i_1 = i_2, \\\\ 0 & \\mbox{if} & i_1 \\not= i_2. \\end{array} \\right.\n", - "\\end{align*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The randomness of $\\varepsilon_i$ implies that\n", - "$\\mathbf{y}_i$ is also a random variable. In particular,\n", - "$\\mathbf{y}_i$ is normally distributed, because $\\varepsilon_i \\sim\n", - "\\mathcal{N}(0, \\sigma^2)$ and $\\mathbf{X}_{i,\\ast} \\, \\boldsymbol{\\beta}$ is a\n", - "non-random scalar. To specify the parameters of the distribution of\n", - "$\\mathbf{y}_i$ we need to calculate its first two moments. \n", - "\n", - "Recall that $\\boldsymbol{X}$ is a matrix of dimensionality $n\\times p$. The\n", - "notation above $\\mathbf{X}_{i,\\ast}$ means that we are looking at the\n", - "row number $i$ and perform a sum over all values $p$.\n", - "\n", - "\n", - "The assumption we have made here can be summarized as (and this is going to be useful when we discuss the bias-variance trade off)\n", - "that there exists a function $f(\\boldsymbol{x})$ and a normal distributed error $\\boldsymbol{\\varepsilon}\\sim \\mathcal{N}(0, \\sigma^2)$\n", - "which describe our data" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{y} = f(\\boldsymbol{x})+\\boldsymbol{\\varepsilon}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We approximate this function with our model from the solution of the linear regression equations, that is our\n", - "function $f$ is approximated by $\\boldsymbol{\\tilde{y}}$ where we want to minimize $(\\boldsymbol{y}-\\boldsymbol{\\tilde{y}})^2$, our MSE, with" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{\\tilde{y}} = \\boldsymbol{X}\\boldsymbol{\\beta}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We can calculate the expectation value of $\\boldsymbol{y}$ for a given element $i$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{align*} \n", - "\\mathbb{E}(y_i) & =\n", - "\\mathbb{E}(\\mathbf{X}_{i, \\ast} \\, \\boldsymbol{\\beta}) + \\mathbb{E}(\\varepsilon_i)\n", - "\\, \\, \\, = \\, \\, \\, \\mathbf{X}_{i, \\ast} \\, \\beta, \n", - "\\end{align*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "while\n", - "its variance is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{align*} \\mbox{Var}(y_i) & = \\mathbb{E} \\{ [y_i\n", - "- \\mathbb{E}(y_i)]^2 \\} \\, \\, \\, = \\, \\, \\, \\mathbb{E} ( y_i^2 ) -\n", - "[\\mathbb{E}(y_i)]^2 \\\\ & = \\mathbb{E} [ ( \\mathbf{X}_{i, \\ast} \\,\n", - "\\beta + \\varepsilon_i )^2] - ( \\mathbf{X}_{i, \\ast} \\, \\boldsymbol{\\beta})^2 \\\\ &\n", - "= \\mathbb{E} [ ( \\mathbf{X}_{i, \\ast} \\, \\boldsymbol{\\beta})^2 + 2 \\varepsilon_i\n", - "\\mathbf{X}_{i, \\ast} \\, \\boldsymbol{\\beta} + \\varepsilon_i^2 ] - ( \\mathbf{X}_{i,\n", - "\\ast} \\, \\beta)^2 \\\\ & = ( \\mathbf{X}_{i, \\ast} \\, \\boldsymbol{\\beta})^2 + 2\n", - "\\mathbb{E}(\\varepsilon_i) \\mathbf{X}_{i, \\ast} \\, \\boldsymbol{\\beta} +\n", - "\\mathbb{E}(\\varepsilon_i^2 ) - ( \\mathbf{X}_{i, \\ast} \\, \\boldsymbol{\\beta})^2 \n", - "\\\\ & = \\mathbb{E}(\\varepsilon_i^2 ) \\, \\, \\, = \\, \\, \\,\n", - "\\mbox{Var}(\\varepsilon_i) \\, \\, \\, = \\, \\, \\, \\sigma^2. \n", - "\\end{align*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Hence, $y_i \\sim \\mathcal{N}( \\mathbf{X}_{i, \\ast} \\, \\boldsymbol{\\beta}, \\sigma^2)$, that is $\\boldsymbol{y}$ follows a normal distribution with \n", - "mean value $\\boldsymbol{X}\\boldsymbol{\\beta}$ and variance $\\sigma^2$ (not be confused with the singular values of the SVD). \n", - "\n", - "\n", - "With the OLS expressions for the parameters $\\boldsymbol{\\beta}$ we can evaluate the expectation value" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbb{E}(\\boldsymbol{\\beta}) = \\mathbb{E}[ (\\mathbf{X}^{\\top} \\mathbf{X})^{-1}\\mathbf{X}^{T} \\mathbf{Y}]=(\\mathbf{X}^{T} \\mathbf{X})^{-1}\\mathbf{X}^{T} \\mathbb{E}[ \\mathbf{Y}]=(\\mathbf{X}^{T} \\mathbf{X})^{-1} \\mathbf{X}^{T}\\mathbf{X}\\boldsymbol{\\beta}=\\boldsymbol{\\beta}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "This means that the estimator of the regression parameters is unbiased.\n", - "v\n", - "We can also calculate the variance\n", - "\n", - "The variance of $\\boldsymbol{\\beta}$ is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{eqnarray*}\n", - "\\mbox{Var}(\\boldsymbol{\\beta}) & = & \\mathbb{E} \\{ [\\boldsymbol{\\beta} - \\mathbb{E}(\\boldsymbol{\\beta})] [\\boldsymbol{\\beta} - \\mathbb{E}(\\boldsymbol{\\beta})]^{T} \\}\n", - "\\\\\n", - "& = & \\mathbb{E} \\{ [(\\mathbf{X}^{T} \\mathbf{X})^{-1} \\, \\mathbf{X}^{T} \\mathbf{Y} - \\boldsymbol{\\beta}] \\, [(\\mathbf{X}^{T} \\mathbf{X})^{-1} \\, \\mathbf{X}^{T} \\mathbf{Y} - \\boldsymbol{\\beta}]^{T} \\}\n", - "\\\\\n", - "% & = & \\mathbb{E} \\{ [(\\mathbf{X}^{T} \\mathbf{X})^{-1} \\, \\mathbf{X}^{T} \\mathbf{Y}] \\, [(\\mathbf{X}^{T} \\mathbf{X})^{-1} \\, \\mathbf{X}^{T} \\mathbf{Y}]^{T} \\} - \\boldsymbol{\\beta} \\, \\boldsymbol{\\beta}^{T}\n", - "% \\\\\n", - "% & = & \\mathbb{E} \\{ (\\mathbf{X}^{T} \\mathbf{X})^{-1} \\, \\mathbf{X}^{T} \\mathbf{Y} \\, \\mathbf{Y}^{T} \\, \\mathbf{X} \\, (\\mathbf{X}^{T} \\mathbf{X})^{-1} \\} - \\boldsymbol{\\beta} \\, \\boldsymbol{\\beta}^{T}\n", - "% \\\\\n", - "& = & (\\mathbf{X}^{T} \\mathbf{X})^{-1} \\, \\mathbf{X}^{T} \\, \\mathbb{E} \\{ \\mathbf{Y} \\, \\mathbf{Y}^{T} \\} \\, \\mathbf{X} \\, (\\mathbf{X}^{T} \\mathbf{X})^{-1} - \\boldsymbol{\\beta} \\, \\boldsymbol{\\beta}^{T}\n", - "\\\\\n", - "& = & (\\mathbf{X}^{T} \\mathbf{X})^{-1} \\, \\mathbf{X}^{T} \\, \\{ \\mathbf{X} \\, \\boldsymbol{\\beta} \\, \\boldsymbol{\\beta}^{T} \\, \\mathbf{X}^{T} + \\sigma^2 \\} \\, \\mathbf{X} \\, (\\mathbf{X}^{T} \\mathbf{X})^{-1} - \\boldsymbol{\\beta} \\, \\boldsymbol{\\beta}^{T}\n", - "% \\\\\n", - "% & = & (\\mathbf{X}^T \\mathbf{X})^{-1} \\, \\mathbf{X}^T \\, \\mathbf{X} \\, \\boldsymbol{\\beta} \\, \\boldsymbol{\\beta}^T \\, \\mathbf{X}^T \\, \\mathbf{X} \\, (\\mathbf{X}^T % \\mathbf{X})^{-1}\n", - "% \\\\\n", - "% & & + \\, \\, \\sigma^2 \\, (\\mathbf{X}^T \\mathbf{X})^{-1} \\, \\mathbf{X}^T \\, \\mathbf{X} \\, (\\mathbf{X}^T \\mathbf{X})^{-1} - \\boldsymbol{\\beta} \\boldsymbol{\\beta}^T\n", - "\\\\\n", - "& = & \\boldsymbol{\\beta} \\, \\boldsymbol{\\beta}^{T} + \\sigma^2 \\, (\\mathbf{X}^{T} \\mathbf{X})^{-1} - \\boldsymbol{\\beta} \\, \\boldsymbol{\\beta}^{T}\n", - "\\, \\, \\, = \\, \\, \\, \\sigma^2 \\, (\\mathbf{X}^{T} \\mathbf{X})^{-1},\n", - "\\end{eqnarray*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where we have used that $\\mathbb{E} (\\mathbf{Y} \\mathbf{Y}^{T}) =\n", - "\\mathbf{X} \\, \\boldsymbol{\\beta} \\, \\boldsymbol{\\beta}^{T} \\, \\mathbf{X}^{T} +\n", - "\\sigma^2 \\, \\mathbf{I}_{nn}$. From $\\mbox{Var}(\\boldsymbol{\\beta}) = \\sigma^2\n", - "\\, (\\mathbf{X}^{T} \\mathbf{X})^{-1}$, one obtains an estimate of the\n", - "variance of the estimate of the $j$-th regression coefficient:\n", - "$\\boldsymbol{\\sigma}^2 (\\boldsymbol{\\beta}_j ) = \\boldsymbol{\\sigma}^2 \\sqrt{\n", - "[(\\mathbf{X}^{T} \\mathbf{X})^{-1}]_{jj} }$. This may be used to\n", - "construct a confidence interval for the estimates.\n", - "\n", - "\n", - "In a similar way, we can obtain analytical expressions for say the\n", - "expectation values of the parameters $\\boldsymbol{\\beta}$ and their variance\n", - "when we employ Ridge regression, allowing us again to define a confidence interval. \n", - "\n", - "It is rather straightforward to show that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbb{E} \\big[ \\boldsymbol{\\beta}^{\\mathrm{Ridge}} \\big]=(\\mathbf{X}^{T} \\mathbf{X} + \\lambda \\mathbf{I}_{pp})^{-1} (\\mathbf{X}^{\\top} \\mathbf{X})\\boldsymbol{\\beta}^{\\mathrm{OLS}}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We see clearly that \n", - "$\\mathbb{E} \\big[ \\boldsymbol{\\beta}^{\\mathrm{Ridge}} \\big] \\not= \\boldsymbol{\\beta}^{\\mathrm{OLS}}$ for any $\\lambda > 0$. We say then that the ridge estimator is biased.\n", - "\n", - "We can also compute the variance as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mbox{Var}[\\boldsymbol{\\beta}^{\\mathrm{Ridge}}]=\\sigma^2[ \\mathbf{X}^{T} \\mathbf{X} + \\lambda \\mathbf{I} ]^{-1} \\mathbf{X}^{T} \\mathbf{X} \\{ [ \\mathbf{X}^{\\top} \\mathbf{X} + \\lambda \\mathbf{I} ]^{-1}\\}^{T},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and it is easy to see that if the parameter $\\lambda$ goes to infinity then the variance of Ridge parameters $\\boldsymbol{\\beta}$ goes to zero. \n", - "\n", - "With this, we can compute the difference" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mbox{Var}[\\boldsymbol{\\beta}^{\\mathrm{OLS}}]-\\mbox{Var}(\\boldsymbol{\\beta}^{\\mathrm{Ridge}})=\\sigma^2 [ \\mathbf{X}^{T} \\mathbf{X} + \\lambda \\mathbf{I} ]^{-1}[ 2\\lambda\\mathbf{I} + \\lambda^2 (\\mathbf{X}^{T} \\mathbf{X})^{-1} ] \\{ [ \\mathbf{X}^{T} \\mathbf{X} + \\lambda \\mathbf{I} ]^{-1}\\}^{T}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The difference is non-negative definite since each component of the\n", - "matrix product is non-negative definite. \n", - "This means the variance we obtain with the standard OLS will always for $\\lambda > 0$ be larger than the variance of $\\boldsymbol{\\beta}$ obtained with the Ridge estimator. This has interesting consequences when we discuss the so-called bias-variance trade-off below. \n", - "\n", - "\n", - "\n", - "## Resampling methods\n", - "\n", - "With all these analytical equations for both the OLS and Ridge\n", - "regression, we will now outline how to assess a given model. This will\n", - "lead us to a discussion of the so-called bias-variance tradeoff (see\n", - "below) and so-called resampling methods.\n", - "\n", - "One of the quantities we have discussed as a way to measure errors is\n", - "the mean-squared error (MSE), mainly used for fitting of continuous\n", - "functions. Another choice is the absolute error.\n", - "\n", - "In the discussions below we will focus on the MSE and in particular since we will split the data into test and training data,\n", - "we discuss the\n", - "1. prediction error or simply the **test error** $\\mathrm{Err_{Test}}$, where we have a fixed training set and the test error is the MSE arising from the data reserved for testing. We discuss also the \n", - "\n", - "2. training error $\\mathrm{Err_{Train}}$, which is the average loss over the training data.\n", - "\n", - "As our model becomes more and more complex, more of the training data tends to used. The training may thence adapt to more complicated structures in the data. This may lead to a decrease in the bias (see below for code example) and a slight increase of the variance for the test error.\n", - "For a certain level of complexity the test error will reach minimum, before starting to increase again. The\n", - "training error reaches a saturation.\n", - "\n", - "\n", - "\n", - "Two famous\n", - "resampling methods are the **independent bootstrap** and **the jackknife**. \n", - "\n", - "The jackknife is a special case of the independent bootstrap. Still, the jackknife was made\n", - "popular prior to the independent bootstrap. And as the popularity of\n", - "the independent bootstrap soared, new variants, such as **the dependent bootstrap**.\n", - "\n", - "The Jackknife and independent bootstrap work for\n", - "independent, identically distributed random variables.\n", - "If these conditions are not\n", - "satisfied, the methods will fail. Yet, it should be said that if the data are\n", - "independent, identically distributed, and we only want to estimate the\n", - "variance of $\\overline{X}$ (which often is the case), then there is no\n", - "need for bootstrapping. \n", - "\n", - "\n", - "The Jackknife works by making many replicas of the estimator $\\widehat{\\beta}$. \n", - "The jackknife is a resampling method where we systematically leave out one observation from the vector of observed values $\\boldsymbol{x} = (x_1,x_2,\\cdots,X_n)$. \n", - "Let $\\boldsymbol{x}_i$ denote the vector" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{x}_i = (x_1,x_2,\\cdots,x_{i-1},x_{i+1},\\cdots,x_n),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which equals the vector $\\boldsymbol{x}$ with the exception that observation\n", - "number $i$ is left out. Using this notation, define\n", - "$\\widehat{\\beta}_i$ to be the estimator\n", - "$\\widehat{\\beta}$ computed using $\\vec{X}_i$." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "from numpy import *\n", - "from numpy.random import randint, randn\n", - "from time import time\n", - "\n", - "def jackknife(data, stat):\n", - " n = len(data);t = zeros(n); inds = arange(n); t0 = time()\n", - " ## 'jackknifing' by leaving out an observation for each i \n", - " for i in range(n):\n", - " t[i] = stat(delete(data,i) )\n", - "\n", - " # analysis \n", - " print(\"Runtime: %g sec\" % (time()-t0)); print(\"Jackknife Statistics :\")\n", - " print(\"original bias std. error\")\n", - " print(\"%8g %14g %15g\" % (stat(data),(n-1)*mean(t)/n, (n*var(t))**.5))\n", - "\n", - " return t\n", - "\n", - "\n", - "# Returns mean of data samples \n", - "def stat(data):\n", - " return mean(data)\n", - "\n", - "\n", - "mu, sigma = 100, 15\n", - "datapoints = 10000\n", - "x = mu + sigma*random.randn(datapoints)\n", - "# jackknife returns the data sample \n", - "t = jackknife(x, stat)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "### Bootstrap\n", - "\n", - "Bootstrapping is a nonparametric approach to statistical inference\n", - "that substitutes computation for more traditional distributional\n", - "assumptions and asymptotic results. Bootstrapping offers a number of\n", - "advantages: \n", - "1. The bootstrap is quite general, although there are some cases in which it fails. \n", - "\n", - "2. Because it does not require distributional assumptions (such as normally distributed errors), the bootstrap can provide more accurate inferences when the data are not well behaved or when the sample size is small. \n", - "\n", - "3. It is possible to apply the bootstrap to statistics with sampling distributions that are difficult to derive, even asymptotically. \n", - "\n", - "4. It is relatively simple to apply the bootstrap to complex data-collection plans (such as stratified and clustered samples).\n", - "\n", - "Since $\\widehat{\\beta} = \\widehat{\\beta}(\\boldsymbol{X})$ is a function of random variables,\n", - "$\\widehat{\\beta}$ itself must be a random variable. Thus it has\n", - "a pdf, call this function $p(\\boldsymbol{t})$. The aim of the bootstrap is to\n", - "estimate $p(\\boldsymbol{t})$ by the relative frequency of\n", - "$\\widehat{\\beta}$. You can think of this as using a histogram\n", - "in the place of $p(\\boldsymbol{t})$. If the relative frequency closely\n", - "resembles $p(\\vec{t})$, then using numerics, it is straight forward to\n", - "estimate all the interesting parameters of $p(\\boldsymbol{t})$ using point\n", - "estimators. \n", - "\n", - "\n", - "\n", - "In the case that $\\widehat{\\beta}$ has\n", - "more than one component, and the components are independent, we use the\n", - "same estimator on each component separately. If the probability\n", - "density function of $X_i$, $p(x)$, had been known, then it would have\n", - "been straight forward to do this by: \n", - "1. Drawing lots of numbers from $p(x)$, suppose we call one such set of numbers $(X_1^*, X_2^*, \\cdots, X_n^*)$. \n", - "\n", - "2. Then using these numbers, we could compute a replica of $\\widehat{\\beta}$ called $\\widehat{\\beta}^*$. \n", - "\n", - "By repeated use of (1) and (2), many\n", - "estimates of $\\widehat{\\beta}$ could have been obtained. The\n", - "idea is to use the relative frequency of $\\widehat{\\beta}^*$\n", - "(think of a histogram) as an estimate of $p(\\boldsymbol{t})$.\n", - "\n", - "\n", - "But\n", - "unless there is enough information available about the process that\n", - "generated $X_1,X_2,\\cdots,X_n$, $p(x)$ is in general\n", - "unknown. Therefore, [Efron in 1979](https://projecteuclid.org/euclid.aos/1176344552) asked the\n", - "question: What if we replace $p(x)$ by the relative frequency\n", - "of the observation $X_i$; if we draw observations in accordance with\n", - "the relative frequency of the observations, will we obtain the same\n", - "result in some asymptotic sense? The answer is yes.\n", - "\n", - "\n", - "Instead of generating the histogram for the relative\n", - "frequency of the observation $X_i$, just draw the values\n", - "$(X_1^*,X_2^*,\\cdots,X_n^*)$ with replacement from the vector\n", - "$\\boldsymbol{X}$. \n", - "\n", - "\n", - "The independent bootstrap works like this: \n", - "\n", - "1. Draw with replacement $n$ numbers for the observed variables $\\boldsymbol{x} = (x_1,x_2,\\cdots,x_n)$. \n", - "\n", - "2. Define a vector $\\boldsymbol{x}^*$ containing the values which were drawn from $\\boldsymbol{x}$. \n", - "\n", - "3. Using the vector $\\boldsymbol{x}^*$ compute $\\widehat{\\beta}^*$ by evaluating $\\widehat \\beta$ under the observations $\\boldsymbol{x}^*$. \n", - "\n", - "4. Repeat this process $k$ times. \n", - "\n", - "When you are done, you can draw a histogram of the relative frequency\n", - "of $\\widehat \\beta^*$. This is your estimate of the probability\n", - "distribution $p(t)$. Using this probability distribution you can\n", - "estimate any statistics thereof. In principle you never draw the\n", - "histogram of the relative frequency of $\\widehat{\\beta}^*$. Instead\n", - "you use the estimators corresponding to the statistic of interest. For\n", - "example, if you are interested in estimating the variance of $\\widehat\n", - "\\beta$, apply the etsimator $\\widehat \\sigma^2$ to the values\n", - "$\\widehat \\beta^*$.\n", - "\n", - "Before we proceed however, we need to remind ourselves about a central\n", - "theorem in statistics, namely the so-called **central limit theorem**.\n", - "This theorem plays a central role in understanding why the Bootstrap\n", - "(and other resampling methods) work so well on independent and\n", - "identically distributed variables.\n", - "\n", - "\n", - "Suppose we have a PDF $p(x)$ from which we generate a series $N$\n", - "of averages $\\langle x_i \\rangle$. Each mean value $\\langle x_i \\rangle$\n", - "is viewed as the average of a specific measurement, e.g., throwing \n", - "dice 100 times and then taking the average value, or producing a certain\n", - "amount of random numbers. \n", - "For notational ease, we set $\\langle x_i \\rangle=x_i$ in the discussion\n", - "which follows. \n", - "\n", - "If we compute the mean $z$ of $m$ such mean values $x_i$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "z=\\frac{x_1+x_2+\\dots+x_m}{m},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "the question we pose is which is the PDF of the new variable $z$.\n", - "\n", - "\n", - "The probability of obtaining an average value $z$ is the product of the \n", - "probabilities of obtaining arbitrary individual mean values $x_i$,\n", - "but with the constraint that the average is $z$. We can express this through\n", - "the following expression" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\tilde{p}(z)=\\int dx_1p(x_1)\\int dx_2p(x_2)\\dots\\int dx_mp(x_m)\n", - " \\delta(z-\\frac{x_1+x_2+\\dots+x_m}{m}),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where the $\\delta$-function enbodies the constraint that the mean is $z$.\n", - "All measurements that lead to each individual $x_i$ are expected to\n", - "be independent, which in turn means that we can express $\\tilde{p}$ as the \n", - "product of individual $p(x_i)$. The independence assumption is important in the derivation of the central limit theorem.\n", - "\n", - "\n", - "\n", - "If we use the integral expression for the $\\delta$-function" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\delta(z-\\frac{x_1+x_2+\\dots+x_m}{m})=\\frac{1}{2\\pi}\\int_{-\\infty}^{\\infty}\n", - " dq\\exp{\\left(iq(z-\\frac{x_1+x_2+\\dots+x_m}{m})\\right)},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and inserting $e^{i\\mu q-i\\mu q}$ where $\\mu$ is the mean value\n", - "we arrive at" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\tilde{p}(z)=\\frac{1}{2\\pi}\\int_{-\\infty}^{\\infty}\n", - " dq\\exp{\\left(iq(z-\\mu)\\right)}\\left[\\int_{-\\infty}^{\\infty}\n", - " dxp(x)\\exp{\\left(iq(\\mu-x)/m\\right)}\\right]^m,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with the integral over $x$ resulting in" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\int_{-\\infty}^{\\infty}dxp(x)\\exp{\\left(iq(\\mu-x)/m\\right)}=\n", - " \\int_{-\\infty}^{\\infty}dxp(x)\n", - " \\left[1+\\frac{iq(\\mu-x)}{m}-\\frac{q^2(\\mu-x)^2}{2m^2}+\\dots\\right].\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The second term on the rhs disappears since this is just the mean and \n", - "employing the definition of $\\sigma^2$ we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\int_{-\\infty}^{\\infty}dxp(x)e^{\\left(iq(\\mu-x)/m\\right)}=\n", - " 1-\\frac{q^2\\sigma^2}{2m^2}+\\dots,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "resulting in" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\left[\\int_{-\\infty}^{\\infty}dxp(x)\\exp{\\left(iq(\\mu-x)/m\\right)}\\right]^m\\approx\n", - " \\left[1-\\frac{q^2\\sigma^2}{2m^2}+\\dots \\right]^m,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and in the limit $m\\rightarrow \\infty$ we obtain" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\tilde{p}(z)=\\frac{1}{\\sqrt{2\\pi}(\\sigma/\\sqrt{m})}\n", - " \\exp{\\left(-\\frac{(z-\\mu)^2}{2(\\sigma/\\sqrt{m})^2}\\right)},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which is the normal distribution with variance\n", - "$\\sigma^2_m=\\sigma^2/m$, where $\\sigma$ is the variance of the PDF $p(x)$\n", - "and $\\mu$ is also the mean of the PDF $p(x)$. \n", - "\n", - "\n", - "Thus, the central limit theorem states that the PDF $\\tilde{p}(z)$ of\n", - "the average of $m$ random values corresponding to a PDF $p(x)$ \n", - "is a normal distribution whose mean is the \n", - "mean value of the PDF $p(x)$ and whose variance is the variance\n", - "of the PDF $p(x)$ divided by $m$, the number of values used to compute $z$.\n", - "\n", - "The central limit theorem leads to the well-known expression for the\n", - "standard deviation, given by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\sigma_m=\n", - "\\frac{\\sigma}{\\sqrt{m}}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The latter is true only if the average value is known exactly. This is obtained in the limit\n", - "$m\\rightarrow \\infty$ only. Because the mean and the variance are measured quantities we obtain \n", - "the familiar expression in statistics" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\sigma_m\\approx \n", - "\\frac{\\sigma}{\\sqrt{m-1}}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In many cases however the above estimate for the standard deviation,\n", - "in particular if correlations are strong, may be too simplistic. Keep\n", - "in mind that we have assumed that the variables $x$ are independent\n", - "and identically distributed. This is obviously not always the\n", - "case. For example, the random numbers (or better pseudorandom numbers)\n", - "we generate in various calculations do always exhibit some\n", - "correlations.\n", - "\n", - "\n", - "\n", - "The theorem is satisfied by a large class of PDFs. Note however that for a\n", - "finite $m$, it is not always possible to find a closed form /analytic expression for\n", - "$\\tilde{p}(x)$.\n", - "\n", - "\n", - "The following code starts with a Gaussian distribution with mean value\n", - "$\\mu =100$ and variance $\\sigma=15$. We use this to generate the data\n", - "used in the bootstrap analysis. The bootstrap analysis returns a data\n", - "set after a given number of bootstrap operations (as many as we have\n", - "data points). This data set consists of estimated mean values for each\n", - "bootstrap operation. The histogram generated by the bootstrap method\n", - "shows that the distribution for these mean values is also a Gaussian,\n", - "centered around the mean value $\\mu=100$ but with standard deviation\n", - "$\\sigma/\\sqrt{n}$, where $n$ is the number of bootstrap samples (in\n", - "this case the same as the number of original data points). The value\n", - "of the standard deviation is what we expect from the central limit\n", - "theorem." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "%matplotlib inline\n", - "\n", - "import numpy as np\n", - "from time import time\n", - "from scipy.stats import norm\n", - "import matplotlib.pyplot as plt\n", - "\n", - "# Returns mean of bootstrap samples \n", - "# Bootstrap algorithm\n", - "def bootstrap(data, datapoints):\n", - " t = np.zeros(datapoints)\n", - " n = len(data)\n", - " # non-parametric bootstrap \n", - " for i in range(datapoints):\n", - " t[i] = np.mean(data[np.random.randint(0,n,n)])\n", - " # analysis \n", - " print(\"Bootstrap Statistics :\")\n", - " print(\"original bias std. error\")\n", - " print(\"%8g %8g %14g %15g\" % (np.mean(data), np.std(data),np.mean(t),np.std(t)))\n", - " return t\n", - "\n", - "# We set the mean value to 100 and the standard deviation to 15\n", - "mu, sigma = 100, 15\n", - "datapoints = 10000\n", - "# We generate random numbers according to the normal distribution\n", - "x = mu + sigma*np.random.randn(datapoints)\n", - "# bootstrap returns the data sample \n", - "t = bootstrap(x, datapoints)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We see that our new variance and from that the standard deviation, agrees with the central limit theorem.\n", - "\n", - "We plot then the histogram together with a best fit for the data set." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "# the histogram of the bootstrapped data (normalized data if density = True)\n", - "n, binsboot, patches = plt.hist(t, 50, density=True, facecolor='red', alpha=0.75)\n", - "# add a 'best fit' line \n", - "y = norm.pdf(binsboot, np.mean(t), np.std(t))\n", - "lt = plt.plot(binsboot, y, 'b', linewidth=1)\n", - "plt.xlabel('x')\n", - "plt.ylabel('Probability')\n", - "plt.grid(True)\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## The bias-variance tradeoff\n", - "\n", - "\n", - "We will discuss the bias-variance tradeoff in the context of\n", - "continuous predictions such as regression. However, many of the\n", - "intuitions and ideas discussed here also carry over to classification\n", - "tasks. Consider a dataset $\\mathcal{L}$ consisting of the data\n", - "$\\mathbf{X}_\\mathcal{L}=\\{(y_j, \\boldsymbol{x}_j), j=0\\ldots n-1\\}$. \n", - "\n", - "Let us assume that the true data is generated from a noisy model" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{y}=f(\\boldsymbol{x}) + \\boldsymbol{\\epsilon}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $\\epsilon$ is normally distributed with mean zero and standard deviation $\\sigma^2$.\n", - "\n", - "In our derivation of the ordinary least squares method we defined then\n", - "an approximation to the function $f$ in terms of the parameters\n", - "$\\boldsymbol{\\beta}$ and the design matrix $\\boldsymbol{X}$ which embody our model,\n", - "that is $\\boldsymbol{\\tilde{y}}=\\boldsymbol{X}\\boldsymbol{\\beta}$. \n", - "\n", - "Thereafter we found the parameters $\\boldsymbol{\\beta}$ by optimizing the means squared error via the so-called cost function" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(\\boldsymbol{X},\\boldsymbol{\\beta}) =\\frac{1}{n}\\sum_{i=0}^{n-1}(y_i-\\tilde{y}_i)^2=\\mathbb{E}\\left[(\\boldsymbol{y}-\\boldsymbol{\\tilde{y}})^2\\right].\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We can rewrite this as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbb{E}\\left[(\\boldsymbol{y}-\\boldsymbol{\\tilde{y}})^2\\right]=\\frac{1}{n}\\sum_i(f_i-\\mathbb{E}\\left[\\boldsymbol{\\tilde{y}}\\right])^2+\\frac{1}{n}\\sum_i(\\tilde{y}_i-\\mathbb{E}\\left[\\boldsymbol{\\tilde{y}}\\right])^2+\\sigma^2.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The three terms represent the square of the bias of the learning\n", - "method, which can be thought of as the error caused by the simplifying\n", - "assumptions built into the method. The second term represents the\n", - "variance of the chosen model and finally the last terms is variance of\n", - "the error $\\boldsymbol{\\epsilon}$.\n", - "\n", - "To derive this equation, we need to recall that the variance of $\\boldsymbol{y}$ and $\\boldsymbol{\\epsilon}$ are both equal to $\\sigma^2$. The mean value of $\\boldsymbol{\\epsilon}$ is by definition equal to zero. Furthermore, the function $f$ is not a stochastics variable, idem for $\\boldsymbol{\\tilde{y}}$.\n", - "We use a more compact notation in terms of the expectation value" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbb{E}\\left[(\\boldsymbol{y}-\\boldsymbol{\\tilde{y}})^2\\right]=\\mathbb{E}\\left[(\\boldsymbol{f}+\\boldsymbol{\\epsilon}-\\boldsymbol{\\tilde{y}})^2\\right],\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and adding and subtracting $\\mathbb{E}\\left[\\boldsymbol{\\tilde{y}}\\right]$ we get" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbb{E}\\left[(\\boldsymbol{y}-\\boldsymbol{\\tilde{y}})^2\\right]=\\mathbb{E}\\left[(\\boldsymbol{f}+\\boldsymbol{\\epsilon}-\\boldsymbol{\\tilde{y}}+\\mathbb{E}\\left[\\boldsymbol{\\tilde{y}}\\right]-\\mathbb{E}\\left[\\boldsymbol{\\tilde{y}}\\right])^2\\right],\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which, using the abovementioned expectation values can be rewritten as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbb{E}\\left[(\\boldsymbol{y}-\\boldsymbol{\\tilde{y}})^2\\right]=\\mathbb{E}\\left[(\\boldsymbol{y}-\\mathbb{E}\\left[\\boldsymbol{\\tilde{y}}\\right])^2\\right]+\\mathrm{Var}\\left[\\boldsymbol{\\tilde{y}}\\right]+\\sigma^2,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "that is the rewriting in terms of the so-called bias, the variance of the model $\\boldsymbol{\\tilde{y}}$ and the variance of $\\boldsymbol{\\epsilon}$." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import matplotlib.pyplot as plt\n", - "import numpy as np\n", - "from sklearn.linear_model import LinearRegression, Ridge, Lasso\n", - "from sklearn.preprocessing import PolynomialFeatures\n", - "from sklearn.model_selection import train_test_split\n", - "from sklearn.pipeline import make_pipeline\n", - "from sklearn.utils import resample\n", - "\n", - "np.random.seed(2018)\n", - "\n", - "n = 500\n", - "n_boostraps = 100\n", - "degree = 18 # A quite high value, just to show.\n", - "noise = 0.1\n", - "\n", - "# Make data set.\n", - "x = np.linspace(-1, 3, n).reshape(-1, 1)\n", - "y = np.exp(-x**2) + 1.5 * np.exp(-(x-2)**2) + np.random.normal(0, 0.1, x.shape)\n", - "\n", - "# Hold out some test data that is never used in training.\n", - "x_train, x_test, y_train, y_test = train_test_split(x, y, test_size=0.2)\n", - "\n", - "# Combine x transformation and model into one operation.\n", - "# Not neccesary, but convenient.\n", - "model = make_pipeline(PolynomialFeatures(degree=degree), LinearRegression(fit_intercept=False))\n", - "\n", - "# The following (m x n_bootstraps) matrix holds the column vectors y_pred\n", - "# for each bootstrap iteration.\n", - "y_pred = np.empty((y_test.shape[0], n_boostraps))\n", - "for i in range(n_boostraps):\n", - " x_, y_ = resample(x_train, y_train)\n", - "\n", - " # Evaluate the new model on the same test data each time.\n", - " y_pred[:, i] = model.fit(x_, y_).predict(x_test).ravel()\n", - "\n", - "# Note: Expectations and variances taken w.r.t. different training\n", - "# data sets, hence the axis=1. Subsequent means are taken across the test data\n", - "# set in order to obtain a total value, but before this we have error/bias/variance\n", - "# calculated per data point in the test set.\n", - "# Note 2: The use of keepdims=True is important in the calculation of bias as this \n", - "# maintains the column vector form. Dropping this yields very unexpected results.\n", - "error = np.mean( np.mean((y_test - y_pred)**2, axis=1, keepdims=True) )\n", - "bias = np.mean( (y_test - np.mean(y_pred, axis=1, keepdims=True))**2 )\n", - "variance = np.mean( np.var(y_pred, axis=1, keepdims=True) )\n", - "print('Error:', error)\n", - "print('Bias^2:', bias)\n", - "print('Var:', variance)\n", - "print('{} >= {} + {} = {}'.format(error, bias, variance, bias+variance))\n", - "\n", - "plt.plot(x[::5, :], y[::5, :], label='f(x)')\n", - "plt.scatter(x_test, y_test, label='Data points')\n", - "plt.scatter(x_test, np.mean(y_pred, axis=1), label='Pred')\n", - "plt.legend()\n", - "plt.show()" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import matplotlib.pyplot as plt\n", - "import numpy as np\n", - "from sklearn.linear_model import LinearRegression, Ridge, Lasso\n", - "from sklearn.preprocessing import PolynomialFeatures\n", - "from sklearn.model_selection import train_test_split\n", - "from sklearn.pipeline import make_pipeline\n", - "from sklearn.utils import resample\n", - "\n", - "np.random.seed(2018)\n", - "\n", - "n = 40\n", - "n_boostraps = 100\n", - "maxdegree = 14\n", - "\n", - "\n", - "# Make data set.\n", - "x = np.linspace(-3, 3, n).reshape(-1, 1)\n", - "y = np.exp(-x**2) + 1.5 * np.exp(-(x-2)**2)+ np.random.normal(0, 0.1, x.shape)\n", - "error = np.zeros(maxdegree)\n", - "bias = np.zeros(maxdegree)\n", - "variance = np.zeros(maxdegree)\n", - "polydegree = np.zeros(maxdegree)\n", - "x_train, x_test, y_train, y_test = train_test_split(x, y, test_size=0.2)\n", - "\n", - "for degree in range(maxdegree):\n", - " model = make_pipeline(PolynomialFeatures(degree=degree), LinearRegression(fit_intercept=False))\n", - " y_pred = np.empty((y_test.shape[0], n_boostraps))\n", - " for i in range(n_boostraps):\n", - " x_, y_ = resample(x_train, y_train)\n", - " y_pred[:, i] = model.fit(x_, y_).predict(x_test).ravel()\n", - "\n", - " polydegree[degree] = degree\n", - " error[degree] = np.mean( np.mean((y_test - y_pred)**2, axis=1, keepdims=True) )\n", - " bias[degree] = np.mean( (y_test - np.mean(y_pred, axis=1, keepdims=True))**2 )\n", - " variance[degree] = np.mean( np.var(y_pred, axis=1, keepdims=True) )\n", - " print('Polynomial degree:', degree)\n", - " print('Error:', error[degree])\n", - " print('Bias^2:', bias[degree])\n", - " print('Var:', variance[degree])\n", - " print('{} >= {} + {} = {}'.format(error[degree], bias[degree], variance[degree], bias[degree]+variance[degree]))\n", - "\n", - "plt.plot(polydegree, error, label='Error')\n", - "plt.plot(polydegree, bias, label='bias')\n", - "plt.plot(polydegree, variance, label='Variance')\n", - "plt.legend()\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The bias-variance tradeoff summarizes the fundamental tension in\n", - "machine learning, particularly supervised learning, between the\n", - "complexity of a model and the amount of training data needed to train\n", - "it. Since data is often limited, in practice it is often useful to\n", - "use a less-complex model with higher bias, that is a model whose asymptotic\n", - "performance is worse than another model because it is easier to\n", - "train and less sensitive to sampling noise arising from having a\n", - "finite-sized training dataset (smaller variance). \n", - "\n", - "\n", - "\n", - "The above equations tell us that in\n", - "order to minimize the expected test error, we need to select a\n", - "statistical learning method that simultaneously achieves low variance\n", - "and low bias. Note that variance is inherently a nonnegative quantity,\n", - "and squared bias is also nonnegative. Hence, we see that the expected\n", - "test MSE can never lie below $Var(\\epsilon)$, the irreducible error.\n", - "\n", - "\n", - "What do we mean by the variance and bias of a statistical learning\n", - "method? The variance refers to the amount by which our model would change if we\n", - "estimated it using a different training data set. Since the training\n", - "data are used to fit the statistical learning method, different\n", - "training data sets will result in a different estimate. But ideally the\n", - "estimate for our model should not vary too much between training\n", - "sets. However, if a method has high variance then small changes in\n", - "the training data can result in large changes in the model. In general, more\n", - "flexible statistical methods have higher variance.\n", - "\n", - "\n", - "You may also find this recent [article](https://www.pnas.org/content/116/32/15849) of interest." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "\"\"\"\n", - "============================\n", - "Underfitting vs. Overfitting\n", - "============================\n", - "\n", - "This example demonstrates the problems of underfitting and overfitting and\n", - "how we can use linear regression with polynomial features to approximate\n", - "nonlinear functions. The plot shows the function that we want to approximate,\n", - "which is a part of the cosine function. In addition, the samples from the\n", - "real function and the approximations of different models are displayed. The\n", - "models have polynomial features of different degrees. We can see that a\n", - "linear function (polynomial with degree 1) is not sufficient to fit the\n", - "training samples. This is called **underfitting**. A polynomial of degree 4\n", - "approximates the true function almost perfectly. However, for higher degrees\n", - "the model will **overfit** the training data, i.e. it learns the noise of the\n", - "training data.\n", - "We evaluate quantitatively **overfitting** / **underfitting** by using\n", - "cross-validation. We calculate the mean squared error (MSE) on the validation\n", - "set, the higher, the less likely the model generalizes correctly from the\n", - "training data.\n", - "\"\"\"\n", - "\n", - "print(__doc__)\n", - "\n", - "import numpy as np\n", - "import matplotlib.pyplot as plt\n", - "from sklearn.pipeline import Pipeline\n", - "from sklearn.preprocessing import PolynomialFeatures\n", - "from sklearn.linear_model import LinearRegression\n", - "from sklearn.model_selection import cross_val_score\n", - "\n", - "\n", - "def true_fun(X):\n", - " return np.cos(1.5 * np.pi * X)\n", - "\n", - "np.random.seed(0)\n", - "\n", - "n_samples = 30\n", - "degrees = [1, 4, 15]\n", - "\n", - "X = np.sort(np.random.rand(n_samples))\n", - "y = true_fun(X) + np.random.randn(n_samples) * 0.1\n", - "\n", - "plt.figure(figsize=(14, 5))\n", - "for i in range(len(degrees)):\n", - " ax = plt.subplot(1, len(degrees), i + 1)\n", - " plt.setp(ax, xticks=(), yticks=())\n", - "\n", - " polynomial_features = PolynomialFeatures(degree=degrees[i],\n", - " include_bias=False)\n", - " linear_regression = LinearRegression()\n", - " pipeline = Pipeline([(\"polynomial_features\", polynomial_features),\n", - " (\"linear_regression\", linear_regression)])\n", - " pipeline.fit(X[:, np.newaxis], y)\n", - "\n", - " # Evaluate the models using crossvalidation\n", - " scores = cross_val_score(pipeline, X[:, np.newaxis], y,\n", - " scoring=\"neg_mean_squared_error\", cv=10)\n", - "\n", - " X_test = np.linspace(0, 1, 100)\n", - " plt.plot(X_test, pipeline.predict(X_test[:, np.newaxis]), label=\"Model\")\n", - " plt.plot(X_test, true_fun(X_test), label=\"True function\")\n", - " plt.scatter(X, y, edgecolor='b', s=20, label=\"Samples\")\n", - " plt.xlabel(\"x\")\n", - " plt.ylabel(\"y\")\n", - " plt.xlim((0, 1))\n", - " plt.ylim((-2, 2))\n", - " plt.legend(loc=\"best\")\n", - " plt.title(\"Degree {}\\nMSE = {:.2e}(+/- {:.2e})\".format(\n", - " degrees[i], -scores.mean(), scores.std()))\n", - "plt.show()" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "# Common imports\n", - "import os\n", - "import numpy as np\n", - "import pandas as pd\n", - "import matplotlib.pyplot as plt\n", - "from sklearn.linear_model import LinearRegression, Ridge, Lasso\n", - "from sklearn.model_selection import train_test_split\n", - "from sklearn.utils import resample\n", - "from sklearn.metrics import mean_squared_error\n", - "# Where to save the figures and data files\n", - "PROJECT_ROOT_DIR = \"Results\"\n", - "FIGURE_ID = \"Results/FigureFiles\"\n", - "DATA_ID = \"DataFiles/\"\n", - "\n", - "if not os.path.exists(PROJECT_ROOT_DIR):\n", - " os.mkdir(PROJECT_ROOT_DIR)\n", - "\n", - "if not os.path.exists(FIGURE_ID):\n", - " os.makedirs(FIGURE_ID)\n", - "\n", - "if not os.path.exists(DATA_ID):\n", - " os.makedirs(DATA_ID)\n", - "\n", - "def image_path(fig_id):\n", - " return os.path.join(FIGURE_ID, fig_id)\n", - "\n", - "def data_path(dat_id):\n", - " return os.path.join(DATA_ID, dat_id)\n", - "\n", - "def save_fig(fig_id):\n", - " plt.savefig(image_path(fig_id) + \".png\", format='png')\n", - "\n", - "infile = open(data_path(\"EoS.csv\"),'r')\n", - "\n", - "# Read the EoS data as csv file and organize the data into two arrays with density and energies\n", - "EoS = pd.read_csv(infile, names=('Density', 'Energy'))\n", - "EoS['Energy'] = pd.to_numeric(EoS['Energy'], errors='coerce')\n", - "EoS = EoS.dropna()\n", - "Energies = EoS['Energy']\n", - "Density = EoS['Density']\n", - "# The design matrix now as function of various polytrops\n", - "\n", - "Maxpolydegree = 30\n", - "X = np.zeros((len(Density),Maxpolydegree))\n", - "X[:,0] = 1.0\n", - "testerror = np.zeros(Maxpolydegree)\n", - "trainingerror = np.zeros(Maxpolydegree)\n", - "polynomial = np.zeros(Maxpolydegree)\n", - "\n", - "trials = 100\n", - "for polydegree in range(1, Maxpolydegree):\n", - " polynomial[polydegree] = polydegree\n", - " for degree in range(polydegree):\n", - " X[:,degree] = Density**(degree/3.0)\n", - "\n", - "# loop over trials in order to estimate the expectation value of the MSE\n", - " testerror[polydegree] = 0.0\n", - " trainingerror[polydegree] = 0.0\n", - " for samples in range(trials):\n", - " x_train, x_test, y_train, y_test = train_test_split(X, Energies, test_size=0.2)\n", - " model = LinearRegression(fit_intercept=False).fit(x_train, y_train)\n", - " ypred = model.predict(x_train)\n", - " ytilde = model.predict(x_test)\n", - " testerror[polydegree] += mean_squared_error(y_test, ytilde)\n", - " trainingerror[polydegree] += mean_squared_error(y_train, ypred) \n", - "\n", - " testerror[polydegree] /= trials\n", - " trainingerror[polydegree] /= trials\n", - " print(\"Degree of polynomial: %3d\"% polynomial[polydegree])\n", - " print(\"Mean squared error on training data: %.8f\" % trainingerror[polydegree])\n", - " print(\"Mean squared error on test data: %.8f\" % testerror[polydegree])\n", - "\n", - "plt.plot(polynomial, np.log10(trainingerror), label='Training Error')\n", - "plt.plot(polynomial, np.log10(testerror), label='Test Error')\n", - "plt.xlabel('Polynomial degree')\n", - "plt.ylabel('log10[MSE]')\n", - "plt.legend()\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Cross-validation\n", - "\n", - "When the repetitive splitting of the data set is done randomly,\n", - "samples may accidently end up in a fast majority of the splits in\n", - "either training or test set. Such samples may have an unbalanced\n", - "influence on either model building or prediction evaluation. To avoid\n", - "this $k$-fold cross-validation structures the data splitting. The\n", - "samples are divided into $k$ more or less equally sized exhaustive and\n", - "mutually exclusive subsets. In turn (at each split) one of these\n", - "subsets plays the role of the test set while the union of the\n", - "remaining subsets constitutes the training set. Such a splitting\n", - "warrants a balanced representation of each sample in both training and\n", - "test set over the splits. Still the division into the $k$ subsets\n", - "involves a degree of randomness. This may be fully excluded when\n", - "choosing $k=n$. This particular case is referred to as leave-one-out\n", - "cross-validation (LOOCV). \n", - "\n", - "\n", - "* Define a range of interest for the penalty parameter.\n", - "\n", - "* Divide the data set into training and test set comprising samples $\\{1, \\ldots, n\\} \\setminus i$ and $\\{ i \\}$, respectively.\n", - "\n", - "* Fit the linear regression model by means of ridge estimation for each $\\lambda$ in the grid using the training set, and the corresponding estimate of the error variance $\\boldsymbol{\\sigma}_{-i}^2(\\lambda)$, as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{align*}\n", - "\\boldsymbol{\\beta}_{-i}(\\lambda) & = ( \\boldsymbol{X}_{-i, \\ast}^{T}\n", - "\\boldsymbol{X}_{-i, \\ast} + \\lambda \\boldsymbol{I}_{pp})^{-1}\n", - "\\boldsymbol{X}_{-i, \\ast}^{T} \\boldsymbol{y}_{-i}\n", - "\\end{align*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "* Evaluate the prediction performance of these models on the test set by $\\log\\{L[y_i, \\boldsymbol{X}_{i, \\ast}; \\boldsymbol{\\beta}_{-i}(\\lambda), \\boldsymbol{\\sigma}_{-i}^2(\\lambda)]\\}$. Or, by the prediction error $|y_i - \\boldsymbol{X}_{i, \\ast} \\boldsymbol{\\beta}_{-i}(\\lambda)|$, the relative error, the error squared or the R2 score function.\n", - "\n", - "* Repeat the first three steps such that each sample plays the role of the test set once.\n", - "\n", - "* Average the prediction performances of the test sets at each grid point of the penalty bias/parameter. It is an estimate of the prediction performance of the model corresponding to this value of the penalty parameter on novel data. It is defined as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{align*}\n", - "\\frac{1}{n} \\sum_{i = 1}^n \\log\\{L[y_i, \\mathbf{X}_{i, \\ast}; \\boldsymbol{\\beta}_{-i}(\\lambda), \\boldsymbol{\\sigma}_{-i}^2(\\lambda)]\\}.\n", - "\\end{align*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "For the various values of $k$\n", - "\n", - "1. shuffle the dataset randomly.\n", - "\n", - "2. Split the dataset into $k$ groups.\n", - "\n", - "3. For each unique group:\n", - "\n", - "a. Decide which group to use as set for test data\n", - "\n", - "b. Take the remaining groups as a training data set\n", - "\n", - "c. Fit a model on the training set and evaluate it on the test set\n", - "\n", - "d. Retain the evaluation score and discard the model\n", - "\n", - "\n", - "5. Summarize the model using the sample of model evaluation scores\n", - "\n", - "The code here uses Ridge regression with cross-validation (CV) resampling and $k$-fold CV in order to fit a specific polynomial." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import numpy as np\n", - "import matplotlib.pyplot as plt\n", - "from sklearn.model_selection import KFold\n", - "from sklearn.linear_model import Ridge\n", - "from sklearn.model_selection import cross_val_score\n", - "from sklearn.preprocessing import PolynomialFeatures\n", - "\n", - "# A seed just to ensure that the random numbers are the same for every run.\n", - "# Useful for eventual debugging.\n", - "np.random.seed(3155)\n", - "\n", - "# Generate the data.\n", - "nsamples = 100\n", - "x = np.random.randn(nsamples)\n", - "y = 3*x**2 + np.random.randn(nsamples)\n", - "\n", - "## Cross-validation on Ridge regression using KFold only\n", - "\n", - "# Decide degree on polynomial to fit\n", - "poly = PolynomialFeatures(degree = 6)\n", - "\n", - "# Decide which values of lambda to use\n", - "nlambdas = 500\n", - "lambdas = np.logspace(-3, 5, nlambdas)\n", - "\n", - "# Initialize a KFold instance\n", - "k = 5\n", - "kfold = KFold(n_splits = k)\n", - "\n", - "# Perform the cross-validation to estimate MSE\n", - "scores_KFold = np.zeros((nlambdas, k))\n", - "\n", - "i = 0\n", - "for lmb in lambdas:\n", - " ridge = Ridge(alpha = lmb)\n", - " j = 0\n", - " for train_inds, test_inds in kfold.split(x):\n", - " xtrain = x[train_inds]\n", - " ytrain = y[train_inds]\n", - "\n", - " xtest = x[test_inds]\n", - " ytest = y[test_inds]\n", - "\n", - " Xtrain = poly.fit_transform(xtrain[:, np.newaxis])\n", - " ridge.fit(Xtrain, ytrain[:, np.newaxis])\n", - "\n", - " Xtest = poly.fit_transform(xtest[:, np.newaxis])\n", - " ypred = ridge.predict(Xtest)\n", - "\n", - " scores_KFold[i,j] = np.sum((ypred - ytest[:, np.newaxis])**2)/np.size(ypred)\n", - "\n", - " j += 1\n", - " i += 1\n", - "\n", - "\n", - "estimated_mse_KFold = np.mean(scores_KFold, axis = 1)\n", - "\n", - "## Cross-validation using cross_val_score from sklearn along with KFold\n", - "\n", - "# kfold is an instance initialized above as:\n", - "# kfold = KFold(n_splits = k)\n", - "\n", - "estimated_mse_sklearn = np.zeros(nlambdas)\n", - "i = 0\n", - "for lmb in lambdas:\n", - " ridge = Ridge(alpha = lmb)\n", - "\n", - " X = poly.fit_transform(x[:, np.newaxis])\n", - " estimated_mse_folds = cross_val_score(ridge, X, y[:, np.newaxis], scoring='neg_mean_squared_error', cv=kfold)\n", - "\n", - " # cross_val_score return an array containing the estimated negative mse for every fold.\n", - " # we have to the the mean of every array in order to get an estimate of the mse of the model\n", - " estimated_mse_sklearn[i] = np.mean(-estimated_mse_folds)\n", - "\n", - " i += 1\n", - "\n", - "## Plot and compare the slightly different ways to perform cross-validation\n", - "\n", - "plt.figure()\n", - "\n", - "plt.plot(np.log10(lambdas), estimated_mse_sklearn, label = 'cross_val_score')\n", - "plt.plot(np.log10(lambdas), estimated_mse_KFold, 'r--', label = 'KFold')\n", - "\n", - "plt.xlabel('log10(lambda)')\n", - "plt.ylabel('mse')\n", - "\n", - "plt.legend()\n", - "\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "More examples of the application of cross-validation follow here." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "# Common imports\n", - "import os\n", - "import numpy as np\n", - "import pandas as pd\n", - "import matplotlib.pyplot as plt\n", - "from sklearn.linear_model import LinearRegression, Ridge, Lasso\n", - "from sklearn.metrics import mean_squared_error\n", - "from sklearn.model_selection import KFold\n", - "from sklearn.model_selection import cross_val_score\n", - "\n", - "\n", - "# Where to save the figures and data files\n", - "PROJECT_ROOT_DIR = \"Results\"\n", - "FIGURE_ID = \"Results/FigureFiles\"\n", - "DATA_ID = \"DataFiles/\"\n", - "\n", - "if not os.path.exists(PROJECT_ROOT_DIR):\n", - " os.mkdir(PROJECT_ROOT_DIR)\n", - "\n", - "if not os.path.exists(FIGURE_ID):\n", - " os.makedirs(FIGURE_ID)\n", - "\n", - "if not os.path.exists(DATA_ID):\n", - " os.makedirs(DATA_ID)\n", - "\n", - "def image_path(fig_id):\n", - " return os.path.join(FIGURE_ID, fig_id)\n", - "\n", - "def data_path(dat_id):\n", - " return os.path.join(DATA_ID, dat_id)\n", - "\n", - "def save_fig(fig_id):\n", - " plt.savefig(image_path(fig_id) + \".png\", format='png')\n", - "\n", - "infile = open(data_path(\"EoS.csv\"),'r')\n", - "\n", - "# Read the EoS data as csv file and organize the data into two arrays with density and energies\n", - "EoS = pd.read_csv(infile, names=('Density', 'Energy'))\n", - "EoS['Energy'] = pd.to_numeric(EoS['Energy'], errors='coerce')\n", - "EoS = EoS.dropna()\n", - "Energies = EoS['Energy']\n", - "Density = EoS['Density']\n", - "# The design matrix now as function of various polytrops\n", - "\n", - "Maxpolydegree = 30\n", - "X = np.zeros((len(Density),Maxpolydegree))\n", - "X[:,0] = 1.0\n", - "estimated_mse_sklearn = np.zeros(Maxpolydegree)\n", - "polynomial = np.zeros(Maxpolydegree)\n", - "k =5\n", - "kfold = KFold(n_splits = k)\n", - "\n", - "for polydegree in range(1, Maxpolydegree):\n", - " polynomial[polydegree] = polydegree\n", - " for degree in range(polydegree):\n", - " X[:,degree] = Density**(degree/3.0)\n", - " OLS = LinearRegression(fit_intercept=False)\n", - "# loop over trials in order to estimate the expectation value of the MSE\n", - " estimated_mse_folds = cross_val_score(OLS, X, Energies, scoring='neg_mean_squared_error', cv=kfold)\n", - "#[:, np.newaxis]\n", - " estimated_mse_sklearn[polydegree] = np.mean(-estimated_mse_folds)\n", - "\n", - "plt.plot(polynomial, np.log10(estimated_mse_sklearn), label='Test Error')\n", - "plt.xlabel('Polynomial degree')\n", - "plt.ylabel('log10[MSE]')\n", - "plt.legend()\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Note that we have kept the intercept in the first column of design matrix $\\boldsymbol{X}$. When we call the corresponding **Scikit-Learn** function we need thus to set the intercept to **False**. Libraries like **Scikit-Learn** normally scale the design matrix and does not fit intercept. See the discussions below.\n", - "\n", - "## More on Rescaling data\n", - "\n", - "We end this chapter by adding some words on scaling and how to deal with the intercept for regression cases.\n", - "\n", - "When you are comparing your own code with for example **Scikit-Learn**'s\n", - "library, there are some technicalities to keep in mind. The examples\n", - "here demonstrate some of these aspects with potential pitfalls.\n", - "\n", - "The discussion here focuses on the role of the intercept, how we can\n", - "set up the design matrix, what scaling we should use and other topics\n", - "which tend confuse us.\n", - "\n", - "The intercept can be interpreted as the expected value of our\n", - "target/output variables when all other predictors are set to zero.\n", - "Thus, if we cannot assume that the expected outputs/targets are zero\n", - "when all predictors are zero (the columns in the design matrix), it\n", - "may be a bad idea to implement a model which penalizes the intercept.\n", - "Furthermore, in for example Ridge and Lasso regression, the default solutions\n", - "from the library **Scikit-Learn** (when not shrinking $\\beta_0$) for the unknown parameters\n", - "$\\boldsymbol{\\beta}$, are derived under the assumption that both $\\boldsymbol{y}$ and\n", - "$\\boldsymbol{X}$ are zero centered, that is we subtract the mean values.\n", - "\n", - "\n", - "If our predictors represent different scales, then it is important to\n", - "standardize the design matrix $\\boldsymbol{X}$ by subtracting the mean of each\n", - "column from the corresponding column and dividing the column with its\n", - "standard deviation. Most machine learning libraries do this as a default. This means that if you compare your code with the results from a given library,\n", - "the results may differ. \n", - "\n", - "The\n", - "[Standardscaler](https://scikit-learn.org/stable/modules/generated/sklearn.preprocessing.StandardScaler.html)\n", - "function in **Scikit-Learn** does this for us. For the data sets we\n", - "have been studying in our various examples, the data are in many cases\n", - "already scaled and there is no need to scale them. You as a user of different machine learning algorithms, should always perform a\n", - "survey of your data, with a critical assessment of them in case you need to scale the data.\n", - "\n", - "If you need to scale the data, not doing so will give an *unfair*\n", - "penalization of the parameters since their magnitude depends on the\n", - "scale of their corresponding predictor.\n", - "\n", - "Suppose as an example that you \n", - "you have an input variable given by the heights of different persons.\n", - "Human height might be measured in inches or meters or\n", - "kilometers. If measured in kilometers, a standard linear regression\n", - "model with this predictor would probably give a much bigger\n", - "coefficient term, than if measured in millimeters.\n", - "This can clearly lead to problems in evaluating the cost/loss functions.\n", - "\n", - "\n", - "\n", - "Keep in mind that when you transform your data set before training a model, the same transformation needs to be done\n", - "on your eventual new data set before making a prediction. If we translate this into a Python code, it would could be implemented as follows" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "\"\"\"\n", - "#Model training, we compute the mean value of y and X\n", - "y_train_mean = np.mean(y_train)\n", - "X_train_mean = np.mean(X_train,axis=0)\n", - "X_train = X_train - X_train_mean\n", - "y_train = y_train - y_train_mean\n", - "\n", - "# The we fit our model with the training data\n", - "trained_model = some_model.fit(X_train,y_train)\n", - "\n", - "\n", - "#Model prediction, we need also to transform our data set used for the prediction.\n", - "X_test = X_test - X_train_mean #Use mean from training data\n", - "y_pred = trained_model(X_test)\n", - "y_pred = y_pred + y_train_mean\n", - "\"\"\"" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Let us try to understand what this may imply mathematically when we\n", - "subtract the mean values, also known as *zero centering*. For\n", - "simplicity, we will focus on ordinary regression, as done in the above example.\n", - "\n", - "The cost/loss function for regression is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(\\beta_0, \\beta_1, ... , \\beta_{p-1}) = \\frac{1}{n}\\sum_{i=0}^{n} \\left(y_i - \\beta_0 - \\sum_{j=1}^{p-1} X_{ij}\\beta_j\\right)^2,.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Recall also that we use the squared value. This expression can lead to an\n", - "increased penalty for higher differences between predicted and\n", - "output/target values.\n", - "\n", - "What we have done is to single out the $\\beta_0$ term in the\n", - "definition of the mean squared error (MSE). The design matrix $X$\n", - "does in this case not contain any intercept column. When we take the\n", - "derivative with respect to $\\beta_0$, we want the derivative to obey" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial C}{\\partial \\beta_j} = 0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "for all $j$. For $\\beta_0$ we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial C}{\\partial \\beta_0} = -\\frac{2}{n}\\sum_{i=0}^{n-1} \\left(y_i - \\beta_0 - \\sum_{j=1}^{p-1} X_{ij} \\beta_j\\right).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Multiplying away the constant $2/n$, we obtain" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\sum_{i=0}^{n-1} \\beta_0 = \\sum_{i=0}^{n-1}y_i - \\sum_{i=0}^{n-1} \\sum_{j=1}^{p-1} X_{ij} \\beta_j.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Let us specialize first to the case where we have only two parameters $\\beta_0$ and $\\beta_1$.\n", - "Our result for $\\beta_0$ simplifies then to" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "n\\beta_0 = \\sum_{i=0}^{n-1}y_i - \\sum_{i=0}^{n-1} X_{i1} \\beta_1.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We obtain then" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\beta_0 = \\frac{1}{n}\\sum_{i=0}^{n-1}y_i - \\beta_1\\frac{1}{n}\\sum_{i=0}^{n-1} X_{i1}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "If we define" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mu_{\\boldsymbol{x}_1}=\\frac{1}{n}\\sum_{i=0}^{n-1} X_{i1},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and the mean value of the outputs as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mu_y=\\frac{1}{n}\\sum_{i=0}^{n-1}y_i,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\beta_0 = \\mu_y - \\beta_1\\mu_{\\boldsymbol{x}_1}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In the general case with more parameters than $\\beta_0$ and $\\beta_1$, we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\beta_0 = \\frac{1}{n}\\sum_{i=0}^{n-1}y_i - \\frac{1}{n}\\sum_{i=0}^{n-1}\\sum_{j=1}^{p-1} X_{ij}\\beta_j.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We can rewrite the latter equation as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\beta_0 = \\frac{1}{n}\\sum_{i=0}^{n-1}y_i - \\sum_{j=1}^{p-1} \\mu_{\\boldsymbol{x}_j}\\beta_j,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where we have defined" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mu_{\\boldsymbol{x}_j}=\\frac{1}{n}\\sum_{i=0}^{n-1} X_{ij},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "the mean value for all elements of the column vector $\\boldsymbol{x}_j$.\n", - "\n", - "\n", - "\n", - "Replacing $y_i$ with $y_i - y_i - \\overline{\\boldsymbol{y}}$ and centering also our design matrix results in a cost function (in vector-matrix disguise)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(\\boldsymbol{\\beta}) = (\\boldsymbol{\\tilde{y}} - \\tilde{X}\\boldsymbol{\\beta})^T(\\boldsymbol{\\tilde{y}} - \\tilde{X}\\boldsymbol{\\beta}).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "If we minimize with respect to $\\boldsymbol{\\beta}$ we have then" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\hat{\\boldsymbol{\\beta}} = (\\tilde{X}^T\\tilde{X})^{-1}\\tilde{X}^T\\boldsymbol{\\tilde{y}},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $\\boldsymbol{\\tilde{y}} = \\boldsymbol{y} - \\overline{\\boldsymbol{y}}$\n", - "and $\\tilde{X}_{ij} = X_{ij} - \\frac{1}{n}\\sum_{k=0}^{n-1}X_{kj}$.\n", - "\n", - "For Ridge regression we need to add $\\lambda \\boldsymbol{\\beta}^T\\boldsymbol{\\beta}$ to the cost function and get then" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\hat{\\boldsymbol{\\beta}} = (\\tilde{X}^T\\tilde{X} + \\lambda I)^{-1}\\tilde{X}^T\\boldsymbol{\\tilde{y}}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "What does this mean? And why do we insist on all this? Let us look at some examples.\n", - "\n", - "\n", - "This code shows a simple first-order fit to a data set using the above transformed data, where we consider the role of the intercept first, by either excluding it or including it (*code example thanks to Øyvind Sigmundson Schøyen*). Here our scaling of the data is done by subtracting the mean values only.\n", - "Note also that we do not split the data into training and test." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import numpy as np\n", - "import matplotlib.pyplot as plt\n", - "\n", - "from sklearn.linear_model import LinearRegression\n", - "\n", - "\n", - "np.random.seed(2021)\n", - "\n", - "def MSE(y_data,y_model):\n", - " n = np.size(y_model)\n", - " return np.sum((y_data-y_model)**2)/n\n", - "\n", - "\n", - "def fit_beta(X, y):\n", - " return np.linalg.pinv(X.T @ X) @ X.T @ y\n", - "\n", - "\n", - "true_beta = [2, 0.5, 3.7]\n", - "\n", - "x = np.linspace(0, 1, 11)\n", - "y = np.sum(\n", - " np.asarray([x ** p * b for p, b in enumerate(true_beta)]), axis=0\n", - ") + 0.1 * np.random.normal(size=len(x))\n", - "\n", - "degree = 3\n", - "X = np.zeros((len(x), degree))\n", - "\n", - "# Include the intercept in the design matrix\n", - "for p in range(degree):\n", - " X[:, p] = x ** p\n", - "\n", - "beta = fit_beta(X, y)\n", - "\n", - "# Intercept is included in the design matrix\n", - "skl = LinearRegression(fit_intercept=False).fit(X, y)\n", - "\n", - "print(f\"True beta: {true_beta}\")\n", - "print(f\"Fitted beta: {beta}\")\n", - "print(f\"Sklearn fitted beta: {skl.coef_}\")\n", - "ypredictOwn = X @ beta\n", - "ypredictSKL = skl.predict(X)\n", - "print(f\"MSE with intercept column\")\n", - "print(MSE(y,ypredictOwn))\n", - "print(f\"MSE with intercept column from SKL\")\n", - "print(MSE(y,ypredictSKL))\n", - "\n", - "\n", - "plt.figure()\n", - "plt.scatter(x, y, label=\"Data\")\n", - "plt.plot(x, X @ beta, label=\"Fit\")\n", - "plt.plot(x, skl.predict(X), label=\"Sklearn (fit_intercept=False)\")\n", - "\n", - "\n", - "# Do not include the intercept in the design matrix\n", - "X = np.zeros((len(x), degree - 1))\n", - "\n", - "for p in range(degree - 1):\n", - " X[:, p] = x ** (p + 1)\n", - "\n", - "# Intercept is not included in the design matrix\n", - "skl = LinearRegression(fit_intercept=True).fit(X, y)\n", - "\n", - "# Use centered values for X and y when computing coefficients\n", - "y_offset = np.average(y, axis=0)\n", - "X_offset = np.average(X, axis=0)\n", - "\n", - "beta = fit_beta(X - X_offset, y - y_offset)\n", - "intercept = np.mean(y_offset - X_offset @ beta)\n", - "\n", - "print(f\"Manual intercept: {intercept}\")\n", - "print(f\"Fitted beta (wiothout intercept): {beta}\")\n", - "print(f\"Sklearn intercept: {skl.intercept_}\")\n", - "print(f\"Sklearn fitted beta (without intercept): {skl.coef_}\")\n", - "ypredictOwn = X @ beta\n", - "ypredictSKL = skl.predict(X)\n", - "print(f\"MSE with Manual intercept\")\n", - "print(MSE(y,ypredictOwn+intercept))\n", - "print(f\"MSE with Sklearn intercept\")\n", - "print(MSE(y,ypredictSKL))\n", - "\n", - "plt.plot(x, X @ beta + intercept, \"--\", label=\"Fit (manual intercept)\")\n", - "plt.plot(x, skl.predict(X), \"--\", label=\"Sklearn (fit_intercept=True)\")\n", - "plt.grid()\n", - "plt.legend()\n", - "\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The intercept is the value of our output/target variable\n", - "when all our features are zero and our function crosses the $y$-axis (for a one-dimensional case). \n", - "\n", - "Printing the MSE, we see first that both methods give the same MSE, as\n", - "they should. However, when we move to for example Ridge regression,\n", - "the way we treat the intercept may give a larger or smaller MSE,\n", - "meaning that the MSE can be penalized by the value of the\n", - "intercept. Not including the intercept in the fit, means that the\n", - "regularization term does not include $\\beta_0$. For different values\n", - "of $\\lambda$, this may lead to differeing MSE values. \n", - "\n", - "To remind the reader, the regularization term, with the intercept in Ridge regression, is given by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\lambda \\vert\\vert \\boldsymbol{\\beta} \\vert\\vert_2^2 = \\lambda \\sum_{j=0}^{p-1}\\beta_j^2,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "but when we take out the intercept, this equation becomes" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\lambda \\vert\\vert \\boldsymbol{\\beta} \\vert\\vert_2^2 = \\lambda \\sum_{j=1}^{p-1}\\beta_j^2.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "For Lasso regression we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\lambda \\vert\\vert \\boldsymbol{\\beta} \\vert\\vert_1 = \\lambda \\sum_{j=1}^{p-1}\\vert\\beta_j\\vert.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "It means that, when scaling the design matrix and the outputs/targets,\n", - "by subtracting the mean values, we have an optimization problem which\n", - "is not penalized by the intercept. The MSE value can then be smaller\n", - "since it focuses only on the remaining quantities. If we however bring\n", - "back the intercept, we will get a MSE which then contains the\n", - "intercept.\n", - "\n", - "\n", - "Armed with this wisdom, we attempt first to simply set the intercept equal to **False** in our implementation of Ridge regression for our well-known vanilla data set." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import numpy as np\n", - "import pandas as pd\n", - "import matplotlib.pyplot as plt\n", - "from sklearn.model_selection import train_test_split\n", - "from sklearn import linear_model\n", - "\n", - "def MSE(y_data,y_model):\n", - " n = np.size(y_model)\n", - " return np.sum((y_data-y_model)**2)/n\n", - "\n", - "\n", - "# A seed just to ensure that the random numbers are the same for every run.\n", - "# Useful for eventual debugging.\n", - "np.random.seed(3155)\n", - "\n", - "n = 100\n", - "x = np.random.rand(n)\n", - "y = np.exp(-x**2) + 1.5 * np.exp(-(x-2)**2)\n", - "\n", - "Maxpolydegree = 20\n", - "X = np.zeros((n,Maxpolydegree))\n", - "#We include explicitely the intercept column\n", - "for degree in range(Maxpolydegree):\n", - " X[:,degree] = x**degree\n", - "# We split the data in test and training data\n", - "X_train, X_test, y_train, y_test = train_test_split(X, y, test_size=0.2)\n", - "\n", - "p = Maxpolydegree\n", - "I = np.eye(p,p)\n", - "# Decide which values of lambda to use\n", - "nlambdas = 6\n", - "MSEOwnRidgePredict = np.zeros(nlambdas)\n", - "MSERidgePredict = np.zeros(nlambdas)\n", - "lambdas = np.logspace(-4, 2, nlambdas)\n", - "for i in range(nlambdas):\n", - " lmb = lambdas[i]\n", - " OwnRidgeBeta = np.linalg.pinv(X_train.T @ X_train+lmb*I) @ X_train.T @ y_train\n", - " # Note: we include the intercept column and no scaling\n", - " RegRidge = linear_model.Ridge(lmb,fit_intercept=False)\n", - " RegRidge.fit(X_train,y_train)\n", - " # and then make the prediction\n", - " ytildeOwnRidge = X_train @ OwnRidgeBeta\n", - " ypredictOwnRidge = X_test @ OwnRidgeBeta\n", - " ytildeRidge = RegRidge.predict(X_train)\n", - " ypredictRidge = RegRidge.predict(X_test)\n", - " MSEOwnRidgePredict[i] = MSE(y_test,ypredictOwnRidge)\n", - " MSERidgePredict[i] = MSE(y_test,ypredictRidge)\n", - " print(\"Beta values for own Ridge implementation\")\n", - " print(OwnRidgeBeta)\n", - " print(\"Beta values for Scikit-Learn Ridge implementation\")\n", - " print(RegRidge.coef_)\n", - " print(\"MSE values for own Ridge implementation\")\n", - " print(MSEOwnRidgePredict[i])\n", - " print(\"MSE values for Scikit-Learn Ridge implementation\")\n", - " print(MSERidgePredict[i])\n", - "\n", - "# Now plot the results\n", - "plt.figure()\n", - "plt.plot(np.log10(lambdas), MSEOwnRidgePredict, 'r', label = 'MSE own Ridge Test')\n", - "plt.plot(np.log10(lambdas), MSERidgePredict, 'g', label = 'MSE Ridge Test')\n", - "\n", - "plt.xlabel('log10(lambda)')\n", - "plt.ylabel('MSE')\n", - "plt.legend()\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The results here agree when we force **Scikit-Learn**'s Ridge function to include the first column in our design matrix.\n", - "We see that the results agree very well. Here we have thus explicitely included the intercept column in the design matrix.\n", - "What happens if we do not include the intercept in our fit?\n", - "Let us see how we can change this code by zero centering." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import numpy as np\n", - "import pandas as pd\n", - "import matplotlib.pyplot as plt\n", - "from sklearn.model_selection import train_test_split\n", - "from sklearn import linear_model\n", - "from sklearn.preprocessing import StandardScaler\n", - "\n", - "def MSE(y_data,y_model):\n", - " n = np.size(y_model)\n", - " return np.sum((y_data-y_model)**2)/n\n", - "# A seed just to ensure that the random numbers are the same for every run.\n", - "# Useful for eventual debugging.\n", - "np.random.seed(315)\n", - "\n", - "n = 100\n", - "x = np.random.rand(n)\n", - "y = np.exp(-x**2) + 1.5 * np.exp(-(x-2)**2)\n", - "\n", - "Maxpolydegree = 20\n", - "X = np.zeros((n,Maxpolydegree-1))\n", - "\n", - "for degree in range(1,Maxpolydegree): #No intercept column\n", - " X[:,degree-1] = x**(degree)\n", - "\n", - "# We split the data in test and training data\n", - "X_train, X_test, y_train, y_test = train_test_split(X, y, test_size=0.2)\n", - "\n", - "#For our own implementation, we will need to deal with the intercept by centering the design matrix and the target variable\n", - "X_train_mean = np.mean(X_train,axis=0)\n", - "#Center by removing mean from each feature\n", - "X_train_scaled = X_train - X_train_mean \n", - "X_test_scaled = X_test - X_train_mean\n", - "#The model intercept (called y_scaler) is given by the mean of the target variable (IF X is centered)\n", - "#Remove the intercept from the training data.\n", - "y_scaler = np.mean(y_train) \n", - "y_train_scaled = y_train - y_scaler \n", - "\n", - "p = Maxpolydegree-1\n", - "I = np.eye(p,p)\n", - "# Decide which values of lambda to use\n", - "nlambdas = 6\n", - "MSEOwnRidgePredict = np.zeros(nlambdas)\n", - "MSERidgePredict = np.zeros(nlambdas)\n", - "\n", - "lambdas = np.logspace(-4, 2, nlambdas)\n", - "for i in range(nlambdas):\n", - " lmb = lambdas[i]\n", - " OwnRidgeBeta = np.linalg.pinv(X_train_scaled.T @ X_train_scaled+lmb*I) @ X_train_scaled.T @ (y_train_scaled)\n", - " intercept_ = y_scaler - X_train_mean@OwnRidgeBeta #The intercept can be shifted so the model can predict on uncentered data\n", - " #Add intercept to prediction\n", - " ypredictOwnRidge = X_test_scaled @ OwnRidgeBeta + y_scaler \n", - " RegRidge = linear_model.Ridge(lmb)\n", - " RegRidge.fit(X_train,y_train)\n", - " ypredictRidge = RegRidge.predict(X_test)\n", - " MSEOwnRidgePredict[i] = MSE(y_test,ypredictOwnRidge)\n", - " MSERidgePredict[i] = MSE(y_test,ypredictRidge)\n", - " print(\"Beta values for own Ridge implementation\")\n", - " print(OwnRidgeBeta) #Intercept is given by mean of target variable\n", - " print(\"Beta values for Scikit-Learn Ridge implementation\")\n", - " print(RegRidge.coef_)\n", - " print('Intercept from own implementation:')\n", - " print(intercept_)\n", - " print('Intercept from Scikit-Learn Ridge implementation')\n", - " print(RegRidge.intercept_)\n", - " print(\"MSE values for own Ridge implementation\")\n", - " print(MSEOwnRidgePredict[i])\n", - " print(\"MSE values for Scikit-Learn Ridge implementation\")\n", - " print(MSERidgePredict[i])\n", - "\n", - "\n", - "# Now plot the results\n", - "plt.figure()\n", - "plt.plot(np.log10(lambdas), MSEOwnRidgePredict, 'b--', label = 'MSE own Ridge Test')\n", - "plt.plot(np.log10(lambdas), MSERidgePredict, 'g--', label = 'MSE SL Ridge Test')\n", - "plt.xlabel('log10(lambda)')\n", - "plt.ylabel('MSE')\n", - "plt.legend()\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We see here, when compared to the code which includes explicitely the\n", - "intercept column, that our MSE value is actually smaller. This is\n", - "because the regularization term does not include the intercept value\n", - "$\\beta_0$ in the fitting. This applies to Lasso regularization as\n", - "well. It means that our optimization is now done only with the\n", - "centered matrix and/or vector that enter the fitting procedure. Note\n", - "also that the problem with the intercept occurs mainly in these type\n", - "of polynomial fitting problem.\n", - "\n", - "The next example is indeed an example where all these discussions about the role of intercept are not present.\n", - "\n", - "## More complicated Example: The Ising model\n", - "\n", - "The one-dimensional Ising model with nearest neighbor interaction, no\n", - "external field and a constant coupling constant $J$ is given by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - " H = -J \\sum_{k}^L s_k s_{k + 1},\n", - "\\label{_auto1} \\tag{1}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $s_i \\in \\{-1, 1\\}$ and $s_{N + 1} = s_1$. The number of spins\n", - "in the system is determined by $L$. For the one-dimensional system\n", - "there is no phase transition.\n", - "\n", - "We will look at a system of $L = 40$ spins with a coupling constant of\n", - "$J = 1$. To get enough training data we will generate 10000 states\n", - "with their respective energies." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import numpy as np\n", - "import matplotlib.pyplot as plt\n", - "from mpl_toolkits.axes_grid1 import make_axes_locatable\n", - "import seaborn as sns\n", - "import scipy.linalg as scl\n", - "from sklearn.model_selection import train_test_split\n", - "import tqdm\n", - "sns.set(color_codes=True)\n", - "cmap_args=dict(vmin=-1., vmax=1., cmap='seismic')\n", - "\n", - "L = 40\n", - "n = int(1e4)\n", - "\n", - "spins = np.random.choice([-1, 1], size=(n, L))\n", - "J = 1.0\n", - "\n", - "energies = np.zeros(n)\n", - "\n", - "for i in range(n):\n", - " energies[i] = - J * np.dot(spins[i], np.roll(spins[i], 1))" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Here we use ordinary least squares\n", - "regression to predict the energy for the nearest neighbor\n", - "one-dimensional Ising model on a ring, i.e., the endpoints wrap\n", - "around. We will use linear regression to fit a value for\n", - "the coupling constant to achieve this.\n", - "\n", - "A more general form for the one-dimensional Ising model is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - " H = - \\sum_j^L \\sum_k^L s_j s_k J_{jk}.\n", - "\\label{_auto2} \\tag{2}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Here we allow for interactions beyond the nearest neighbors and a state dependent\n", - "coupling constant. This latter expression can be formulated as\n", - "a matrix-product" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - " \\boldsymbol{H} = \\boldsymbol{X} J,\n", - "\\label{_auto3} \\tag{3}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $X_{jk} = s_j s_k$ and $J$ is a matrix which consists of the\n", - "elements $-J_{jk}$. This form of writing the energy fits perfectly\n", - "with the form utilized in linear regression, that is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - " \\boldsymbol{y} = \\boldsymbol{X}\\boldsymbol{\\beta} + \\boldsymbol{\\epsilon},\n", - "\\label{_auto4} \\tag{4}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We split the data in training and test data as discussed in the previous example" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "X = np.zeros((n, L ** 2))\n", - "for i in range(n):\n", - " X[i] = np.outer(spins[i], spins[i]).ravel()\n", - "y = energies\n", - "X_train, X_test, y_train, y_test = train_test_split(X, y, test_size=0.2)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In the ordinary least squares method we choose the cost function" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - " C(\\boldsymbol{X}, \\boldsymbol{\\beta})= \\frac{1}{n}\\left\\{(\\boldsymbol{X}\\boldsymbol{\\beta} - \\boldsymbol{y})^T(\\boldsymbol{X}\\boldsymbol{\\beta} - \\boldsymbol{y})\\right\\}.\n", - "\\label{_auto5} \\tag{5}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We then find the extremal point of $C$ by taking the derivative with respect to $\\boldsymbol{\\beta}$ as discussed above.\n", - "This yields the expression for $\\boldsymbol{\\beta}$ to be" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{\\beta} = \\frac{\\boldsymbol{X}^T \\boldsymbol{y}}{\\boldsymbol{X}^T \\boldsymbol{X}},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which immediately imposes some requirements on $\\boldsymbol{X}$ as there must exist\n", - "an inverse of $\\boldsymbol{X}^T \\boldsymbol{X}$. If the expression we are modeling contains an\n", - "intercept, i.e., a constant term, we must make sure that the\n", - "first column of $\\boldsymbol{X}$ consists of $1$. We do this here" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "X_train_own = np.concatenate(\n", - " (np.ones(len(X_train))[:, np.newaxis], X_train),\n", - " axis=1\n", - ")\n", - "X_test_own = np.concatenate(\n", - " (np.ones(len(X_test))[:, np.newaxis], X_test),\n", - " axis=1\n", - ")" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Doing the inversion directly turns out to be a bad idea since the matrix\n", - "$\\boldsymbol{X}^T\\boldsymbol{X}$ is singular. An alternative approach is to use the **singular\n", - "value decomposition**. Using the definition of the Moore-Penrose\n", - "pseudoinverse we can write the equation for $\\boldsymbol{\\beta}$ as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{\\beta} = \\boldsymbol{X}^{+}\\boldsymbol{y},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where the pseudoinverse of $\\boldsymbol{X}$ is given by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}^{+} = \\frac{\\boldsymbol{X}^T}{\\boldsymbol{X}^T\\boldsymbol{X}}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Using singular value decomposition we can decompose the matrix $\\boldsymbol{X} = \\boldsymbol{U}\\boldsymbol{\\Sigma} \\boldsymbol{V}^T$,\n", - "where $\\boldsymbol{U}$ and $\\boldsymbol{V}$ are orthogonal(unitary) matrices and $\\boldsymbol{\\Sigma}$ contains the singular values (more details below).\n", - "where $X^{+} = V\\Sigma^{+} U^T$. This reduces the equation for\n", - "$\\omega$ to" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - " \\boldsymbol{\\beta} = \\boldsymbol{V}\\boldsymbol{\\Sigma}^{+} \\boldsymbol{U}^T \\boldsymbol{y}.\n", - "\\label{_auto6} \\tag{6}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Note that solving this equation by actually doing the pseudoinverse\n", - "(which is what we will do) is not a good idea as this operation scales\n", - "as $\\mathcal{O}(n^3)$, where $n$ is the number of elements in a\n", - "general matrix. Instead, doing $QR$-factorization and solving the\n", - "linear system as an equation would reduce this down to\n", - "$\\mathcal{O}(n^2)$ operations." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "def ols_svd(x: np.ndarray, y: np.ndarray) -> np.ndarray:\n", - " u, s, v = scl.svd(x)\n", - " return v.T @ scl.pinv(scl.diagsvd(s, u.shape[0], v.shape[0])) @ u.T @ y" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "beta = ols_svd(X_train_own,y_train)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "When extracting the $J$-matrix we need to make sure that we remove the intercept, as is done here" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "J = beta[1:].reshape(L, L)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "A way of looking at the coefficients in $J$ is to plot the matrices as images." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "fig = plt.figure(figsize=(20, 14))\n", - "im = plt.imshow(J, **cmap_args)\n", - "plt.title(\"OLS\", fontsize=18)\n", - "plt.xticks(fontsize=18)\n", - "plt.yticks(fontsize=18)\n", - "cb = fig.colorbar(im)\n", - "cb.ax.set_yticklabels(cb.ax.get_yticklabels(), fontsize=18)\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "It is interesting to note that OLS\n", - "considers both $J_{j, j + 1} = -0.5$ and $J_{j, j - 1} = -0.5$ as\n", - "valid matrix elements for $J$.\n", - "In our discussion below on hyperparameters and Ridge and Lasso regression we will see that\n", - "this problem can be removed, partly and only with Lasso regression. \n", - "\n", - "In this case our matrix inversion was actually possible. The obvious question now is what is the mathematics behind the SVD?\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "Let us now \n", - "focus on Ridge and Lasso regression as well. We repeat some of the\n", - "basic parts of the Ising model and the setup of the training and test\n", - "data. The one-dimensional Ising model with nearest neighbor\n", - "interaction, no external field and a constant coupling constant $J$ is\n", - "given by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - " H = -J \\sum_{k}^L s_k s_{k + 1},\n", - "\\label{_auto7} \\tag{7}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $s_i \\in \\{-1, 1\\}$ and $s_{N + 1} = s_1$. The number of spins in the system is determined by $L$. For the one-dimensional system there is no phase transition.\n", - "\n", - "We will look at a system of $L = 40$ spins with a coupling constant of $J = 1$. To get enough training data we will generate 10000 states with their respective energies." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import numpy as np\n", - "import matplotlib.pyplot as plt\n", - "from mpl_toolkits.axes_grid1 import make_axes_locatable\n", - "import seaborn as sns\n", - "import scipy.linalg as scl\n", - "from sklearn.model_selection import train_test_split\n", - "import sklearn.linear_model as skl\n", - "import tqdm\n", - "sns.set(color_codes=True)\n", - "cmap_args=dict(vmin=-1., vmax=1., cmap='seismic')\n", - "\n", - "L = 40\n", - "n = int(1e4)\n", - "\n", - "spins = np.random.choice([-1, 1], size=(n, L))\n", - "J = 1.0\n", - "\n", - "energies = np.zeros(n)\n", - "\n", - "for i in range(n):\n", - " energies[i] = - J * np.dot(spins[i], np.roll(spins[i], 1))" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "A more general form for the one-dimensional Ising model is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - " H = - \\sum_j^L \\sum_k^L s_j s_k J_{jk}.\n", - "\\label{_auto8} \\tag{8}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Here we allow for interactions beyond the nearest neighbors and a more\n", - "adaptive coupling matrix. This latter expression can be formulated as\n", - "a matrix-product on the form" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - " H = X J,\n", - "\\label{_auto9} \\tag{9}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $X_{jk} = s_j s_k$ and $J$ is the matrix consisting of the\n", - "elements $-J_{jk}$. This form of writing the energy fits perfectly\n", - "with the form utilized in linear regression, viz." - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - " \\boldsymbol{y} = \\boldsymbol{X}\\boldsymbol{\\beta} + \\boldsymbol{\\epsilon}.\n", - "\\label{_auto10} \\tag{10}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We organize the data as we did above" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "X = np.zeros((n, L ** 2))\n", - "for i in range(n):\n", - " X[i] = np.outer(spins[i], spins[i]).ravel()\n", - "y = energies\n", - "X_train, X_test, y_train, y_test = train_test_split(X, y, test_size=0.96)\n", - "\n", - "X_train_own = np.concatenate(\n", - " (np.ones(len(X_train))[:, np.newaxis], X_train),\n", - " axis=1\n", - ")\n", - "\n", - "X_test_own = np.concatenate(\n", - " (np.ones(len(X_test))[:, np.newaxis], X_test),\n", - " axis=1\n", - ")" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We will do all fitting with **Scikit-Learn**," - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "clf = skl.LinearRegression().fit(X_train, y_train)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "When extracting the $J$-matrix we make sure to remove the intercept" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "J_sk = clf.coef_.reshape(L, L)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "And then we plot the results" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "fig = plt.figure(figsize=(20, 14))\n", - "im = plt.imshow(J_sk, **cmap_args)\n", - "plt.title(\"LinearRegression from Scikit-learn\", fontsize=18)\n", - "plt.xticks(fontsize=18)\n", - "plt.yticks(fontsize=18)\n", - "cb = fig.colorbar(im)\n", - "cb.ax.set_yticklabels(cb.ax.get_yticklabels(), fontsize=18)\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The results agree perfectly with our previous discussion where we used our own code.\n", - "\n", - "\n", - "Having explored the ordinary least squares we move on to ridge\n", - "regression. In ridge regression we include a **regularizer**. This\n", - "involves a new cost function which leads to a new estimate for the\n", - "weights $\\boldsymbol{\\beta}$. This results in a penalized regression problem. The\n", - "cost function is given by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "6\n", - "0\n", - " \n", - "<\n", - "<\n", - "<\n", - "!\n", - "!\n", - "M\n", - "A\n", - "T\n", - "H\n", - "_\n", - "B\n", - "L\n", - "O\n", - "C\n", - "K" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "_lambda = 0.1\n", - "clf_ridge = skl.Ridge(alpha=_lambda).fit(X_train, y_train)\n", - "J_ridge_sk = clf_ridge.coef_.reshape(L, L)\n", - "fig = plt.figure(figsize=(20, 14))\n", - "im = plt.imshow(J_ridge_sk, **cmap_args)\n", - "plt.title(\"Ridge from Scikit-learn\", fontsize=18)\n", - "plt.xticks(fontsize=18)\n", - "plt.yticks(fontsize=18)\n", - "cb = fig.colorbar(im)\n", - "cb.ax.set_yticklabels(cb.ax.get_yticklabels(), fontsize=18)\n", - "\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In the **Least Absolute Shrinkage and Selection Operator** (LASSO)-method we get a third cost function." - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - " C(\\boldsymbol{X}, \\boldsymbol{\\beta}; \\lambda) = (\\boldsymbol{X}\\boldsymbol{\\beta} - \\boldsymbol{y})^T(\\boldsymbol{X}\\boldsymbol{\\beta} - \\boldsymbol{y}) + \\lambda \\sqrt{\\boldsymbol{\\beta}^T\\boldsymbol{\\beta}}.\n", - "\\label{_auto12} \\tag{12}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Finding the extremal point of this cost function is not so straight-forward as in least squares and ridge. We will therefore rely solely on the function ``Lasso`` from **Scikit-Learn**." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "clf_lasso = skl.Lasso(alpha=_lambda).fit(X_train, y_train)\n", - "J_lasso_sk = clf_lasso.coef_.reshape(L, L)\n", - "fig = plt.figure(figsize=(20, 14))\n", - "im = plt.imshow(J_lasso_sk, **cmap_args)\n", - "plt.title(\"Lasso from Scikit-learn\", fontsize=18)\n", - "plt.xticks(fontsize=18)\n", - "plt.yticks(fontsize=18)\n", - "cb = fig.colorbar(im)\n", - "cb.ax.set_yticklabels(cb.ax.get_yticklabels(), fontsize=18)\n", - "\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "It is quite striking how LASSO breaks the symmetry of the coupling\n", - "constant as opposed to ridge and OLS. We get a sparse solution with\n", - "$J_{j, j + 1} = -1$.\n", - "\n", - "\n", - "\n", - "\n", - "We see how the different models perform for a different set of values for $\\lambda$." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "lambdas = np.logspace(-4, 5, 10)\n", - "\n", - "train_errors = {\n", - " \"ols_sk\": np.zeros(lambdas.size),\n", - " \"ridge_sk\": np.zeros(lambdas.size),\n", - " \"lasso_sk\": np.zeros(lambdas.size)\n", - "}\n", - "\n", - "test_errors = {\n", - " \"ols_sk\": np.zeros(lambdas.size),\n", - " \"ridge_sk\": np.zeros(lambdas.size),\n", - " \"lasso_sk\": np.zeros(lambdas.size)\n", - "}\n", - "\n", - "plot_counter = 1\n", - "\n", - "fig = plt.figure(figsize=(32, 54))\n", - "\n", - "for i, _lambda in enumerate(tqdm.tqdm(lambdas)):\n", - " for key, method in zip(\n", - " [\"ols_sk\", \"ridge_sk\", \"lasso_sk\"],\n", - " [skl.LinearRegression(), skl.Ridge(alpha=_lambda), skl.Lasso(alpha=_lambda)]\n", - " ):\n", - " method = method.fit(X_train, y_train)\n", - "\n", - " train_errors[key][i] = method.score(X_train, y_train)\n", - " test_errors[key][i] = method.score(X_test, y_test)\n", - "\n", - " omega = method.coef_.reshape(L, L)\n", - "\n", - " plt.subplot(10, 5, plot_counter)\n", - " plt.imshow(omega, **cmap_args)\n", - " plt.title(r\"%s, $\\lambda = %.4f$\" % (key, _lambda))\n", - " plot_counter += 1\n", - "\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We see that LASSO reaches a good solution for low\n", - "values of $\\lambda$, but will \"wither\" when we increase $\\lambda$ too\n", - "much. Ridge is more stable over a larger range of values for\n", - "$\\lambda$, but eventually also fades away.\n", - "\n", - "\n", - "To determine which value of $\\lambda$ is best we plot the accuracy of\n", - "the models when predicting the training and the testing set. We expect\n", - "the accuracy of the training set to be quite good, but if the accuracy\n", - "of the testing set is much lower this tells us that we might be\n", - "subject to an overfit model. The ideal scenario is an accuracy on the\n", - "testing set that is close to the accuracy of the training set." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "fig = plt.figure(figsize=(20, 14))\n", - "\n", - "colors = {\n", - " \"ols_sk\": \"r\",\n", - " \"ridge_sk\": \"y\",\n", - " \"lasso_sk\": \"c\"\n", - "}\n", - "\n", - "for key in train_errors:\n", - " plt.semilogx(\n", - " lambdas,\n", - " train_errors[key],\n", - " colors[key],\n", - " label=\"Train {0}\".format(key),\n", - " linewidth=4.0\n", - " )\n", - "\n", - "for key in test_errors:\n", - " plt.semilogx(\n", - " lambdas,\n", - " test_errors[key],\n", - " colors[key] + \"--\",\n", - " label=\"Test {0}\".format(key),\n", - " linewidth=4.0\n", - " )\n", - "plt.legend(loc=\"best\", fontsize=18)\n", - "plt.xlabel(r\"$\\lambda$\", fontsize=18)\n", - "plt.ylabel(r\"$R^2$\", fontsize=18)\n", - "plt.tick_params(labelsize=18)\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "From the above figure we can see that LASSO with $\\lambda = 10^{-2}$\n", - "achieves a very good accuracy on the test set. This by far surpasses the\n", - "other models for all values of $\\lambda$.\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "## Exercises and Projects\n", - "\n", - "\n", - "\n", - "The main aim of this project is to study in more detail various\n", - "regression methods, including the Ordinary Least Squares (OLS) method,\n", - "The total score is **100** points. Each subtask has its own final score.\n", - "\n", - "\n", - "We will first study how to fit polynomials to a specific\n", - "two-dimensional function called [Franke's\n", - "function](http://www.dtic.mil/dtic/tr/fulltext/u2/a081688.pdf). This\n", - "is a function which has been widely used when testing various\n", - "interpolation and fitting algorithms. Furthermore, after having\n", - "established the model and the method, we will employ resamling\n", - "techniques such as cross-validation and/or bootstrap in order to perform a\n", - "proper assessment of our models. We will also study in detail the\n", - "so-called Bias-Variance trade off.\n", - "\n", - "\n", - "The Franke function, which is a weighted sum of four exponentials reads as follows" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{align*}\n", - "f(x,y) &= \\frac{3}{4}\\exp{\\left(-\\frac{(9x-2)^2}{4} - \\frac{(9y-2)^2}{4}\\right)}+\\frac{3}{4}\\exp{\\left(-\\frac{(9x+1)^2}{49}- \\frac{(9y+1)}{10}\\right)} \\\\\n", - "&+\\frac{1}{2}\\exp{\\left(-\\frac{(9x-7)^2}{4} - \\frac{(9y-3)^2}{4}\\right)} -\\frac{1}{5}\\exp{\\left(-(9x-4)^2 - (9y-7)^2\\right) }.\n", - "\\end{align*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The function will be defined for $x,y\\in [0,1]$. Our first step will\n", - "be to perform an OLS regression analysis of this function, trying out\n", - "a polynomial fit with an $x$ and $y$ dependence of the form $[x, y,\n", - "x^2, y^2, xy, \\dots]$. We will also include bootstrap first as\n", - "a resampling technique. After that we will include the cross-validation technique. As in homeworks 1 and 2, we can use a uniform\n", - "distribution to set up the arrays of values for $x$ and $y$, or as in\n", - "the example below just a set of fixed \n", - "values for $x$ and $y$ with a given step\n", - "size. We will fit a\n", - "function (for example a polynomial) of $x$ and $y$. Thereafter we\n", - "will repeat much of the same procedure using the Ridge and Lasso\n", - "regression methods, introducing thus a dependence on the bias\n", - "(penalty) $\\lambda$.\n", - "\n", - "Finally we are going to use (real) digital terrain data and try to\n", - "reproduce these data using the same methods. We will also try to go\n", - "beyond the second-order polynomials metioned above and explore \n", - "which polynomial fits the data best.\n", - "\n", - "\n", - "The Python code for the Franke function is included here (it performs also a three-dimensional plot of it)" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "from mpl_toolkits.mplot3d import Axes3D\n", - "import matplotlib.pyplot as plt\n", - "from matplotlib import cm\n", - "from matplotlib.ticker import LinearLocator, FormatStrFormatter\n", - "import numpy as np\n", - "from random import random, seed\n", - "\n", - "fig = plt.figure()\n", - "ax = fig.gca(projection='3d')\n", - "\n", - "# Make data.\n", - "x = np.arange(0, 1, 0.05)\n", - "y = np.arange(0, 1, 0.05)\n", - "x, y = np.meshgrid(x,y)\n", - "\n", - "\n", - "def FrankeFunction(x,y):\n", - " term1 = 0.75*np.exp(-(0.25*(9*x-2)**2) - 0.25*((9*y-2)**2))\n", - " term2 = 0.75*np.exp(-((9*x+1)**2)/49.0 - 0.1*(9*y+1))\n", - " term3 = 0.5*np.exp(-(9*x-7)**2/4.0 - 0.25*((9*y-3)**2))\n", - " term4 = -0.2*np.exp(-(9*x-4)**2 - (9*y-7)**2)\n", - " return term1 + term2 + term3 + term4\n", - "\n", - "\n", - "z = FrankeFunction(x, y)\n", - "\n", - "# Plot the surface.\n", - "surf = ax.plot_surface(x, y, z, cmap=cm.coolwarm,\n", - " linewidth=0, antialiased=False)\n", - "\n", - "# Customize the z axis.\n", - "ax.set_zlim(-0.10, 1.40)\n", - "ax.zaxis.set_major_locator(LinearLocator(10))\n", - "ax.zaxis.set_major_formatter(FormatStrFormatter('%.02f'))\n", - "\n", - "# Add a color bar which maps values to colors.\n", - "fig.colorbar(surf, shrink=0.5, aspect=5)\n", - "\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "### Exercise: Ordinary Least Square (OLS) on the Franke function\n", - "\n", - "We will generate our own dataset for a function\n", - "$\\mathrm{FrankeFunction}(x,y)$ with $x,y \\in [0,1]$. The function\n", - "$f(x,y)$ is the Franke function. You should explore also the addition\n", - "of an added stochastic noise to this function using the normal\n", - "distribution $N(0,1)$.\n", - "\n", - "*Write your own code* (using either a matrix inversion or a singular\n", - "value decomposition from e.g., **numpy** ) or use your code from\n", - "homeworks 1 and 2 and perform a standard least square regression\n", - "analysis using polynomials in $x$ and $y$ up to fifth order. Find the\n", - "[confidence intervals](https://en.wikipedia.org/wiki/Confidence_interval) of the parameters (estimators) $\\beta$ by computing their\n", - "variances, evaluate the Mean Squared error (MSE)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "MSE(\\hat{y},\\hat{\\tilde{y}}) = \\frac{1}{n}\n", - "\\sum_{i=0}^{n-1}(y_i-\\tilde{y}_i)^2,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and the $R^2$ score function. If $\\tilde{\\hat{y}}_i$ is the predicted\n", - "value of the $i-th$ sample and $y_i$ is the corresponding true value,\n", - "then the score $R^2$ is defined as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "R^2(\\hat{y}, \\tilde{\\hat{y}}) = 1 - \\frac{\\sum_{i=0}^{n - 1} (y_i - \\tilde{y}_i)^2}{\\sum_{i=0}^{n - 1} (y_i - \\bar{y})^2},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where we have defined the mean value of $\\hat{y}$ as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\bar{y} = \\frac{1}{n} \\sum_{i=0}^{n - 1} y_i.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Your code has to include a scaling of the data (for example by\n", - "subtracting the mean value), and\n", - "a split of the data in training and test data. For this exercise you can\n", - "either write your own code or use for example the function for\n", - "splitting training data provided by the library **Scikit-Learn** (make\n", - "sure you have installed it). This function is called\n", - "$train\\_test\\_split$. **You should present a critical discussion of why and how you have scaled or not scaled the data**.\n", - "\n", - "It is normal in essentially all Machine Learning studies to split the\n", - "data in a training set and a test set (eventually also an additional\n", - "validation set). There\n", - "is no explicit recipe for how much data should be included as training\n", - "data and say test data. An accepted rule of thumb is to use\n", - "approximately $2/3$ to $4/5$ of the data as training data.\n", - "\n", - "\n", - "You can easily reuse the solutions to your exercises from week 35 and week 36.\n", - "\n", - "\n", - "\n", - "### Exercise: Bias-variance trade-off and resampling techniques\n", - "\n", - "Our aim here is to study the bias-variance trade-off by implementing the **bootstrap** resampling technique.\n", - "\n", - "With a code which does OLS and includes resampling techniques, \n", - "we will now discuss the bias-variance trade-off in the context of\n", - "continuous predictions such as regression. However, many of the\n", - "intuitions and ideas discussed here also carry over to classification\n", - "tasks and basically all Machine Learning algorithms. \n", - "\n", - "Before you perform an analysis of the bias-variance trade-off on your test data, make\n", - "first a figure similar to Fig. 2.11 of Hastie, Tibshirani, and\n", - "Friedman. Figure 2.11 of this reference displays only the test and training MSEs. The test MSE can be used to \n", - "indicate possible regions of low/high bias and variance. You will most likely not get an\n", - "equally smooth curve!\n", - "\n", - "With this result we move on to the bias-variance trade-off analysis.\n", - "\n", - "Consider a\n", - "dataset $\\mathcal{L}$ consisting of the data\n", - "$\\mathbf{X}_\\mathcal{L}=\\{(y_j, \\boldsymbol{x}_j), j=0\\ldots n-1\\}$.\n", - "\n", - "Let us assume that the true data is generated from a noisy model" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{y}=f(\\boldsymbol{x}) + \\boldsymbol{\\epsilon}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Here $\\epsilon$ is normally distributed with mean zero and standard\n", - "deviation $\\sigma^2$.\n", - "\n", - "In our derivation of the ordinary least squares method we defined then\n", - "an approximation to the function $f$ in terms of the parameters\n", - "$\\boldsymbol{\\beta}$ and the design matrix $\\boldsymbol{X}$ which embody our model,\n", - "that is $\\boldsymbol{\\tilde{y}}=\\boldsymbol{X}\\boldsymbol{\\beta}$.\n", - "\n", - "The parameters $\\boldsymbol{\\beta}$ are in turn found by optimizing the means\n", - "squared error via the so-called cost function" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(\\boldsymbol{X},\\boldsymbol{\\beta}) =\\frac{1}{n}\\sum_{i=0}^{n-1}(y_i-\\tilde{y}_i)^2=\\mathbb{E}\\left[(\\boldsymbol{y}-\\boldsymbol{\\tilde{y}})^2\\right].\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Here the expected value $\\mathbb{E}$ is the sample value. \n", - "\n", - "Show that you can rewrite this as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbb{E}\\left[(\\boldsymbol{y}-\\boldsymbol{\\tilde{y}})^2\\right]=\\frac{1}{n}\\sum_i(f_i-\\mathbb{E}\\left[\\boldsymbol{\\tilde{y}}\\right])^2+\\frac{1}{n}\\sum_i(\\tilde{y}_i-\\mathbb{E}\\left[\\boldsymbol{\\tilde{y}}\\right])^2+\\sigma^2.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Explain what the terms mean, which one is the bias and which one is\n", - "the variance and discuss their interpretations.\n", - "\n", - "Perform then a bias-variance analysis of the Franke function by\n", - "studying the MSE value as function of the complexity of your model.\n", - "\n", - "Discuss the bias and variance trade-off as function\n", - "of your model complexity (the degree of the polynomial) and the number\n", - "of data points, and possibly also your training and test data using the **bootstrap** resampling method.\n", - "\n", - "Note also that when you calculate the bias, in all applications you don't know the function values $f_i$. You would hence replace them with the actual data points $y_i$.\n", - "\n", - "\n", - "### Exercise: Cross-validation as resampling techniques, adding more complexity\n", - "\n", - "The aim here is to write your own code for another widely popular\n", - "resampling technique, the so-called cross-validation method. Again,\n", - "before you start with cross-validation approach, you should scale your\n", - "data.\n", - "\n", - "Implement the $k$-fold cross-validation algorithm (write your own\n", - "code) and evaluate again the MSE function resulting\n", - "from the test folds. You can compare your own code with that from\n", - "**Scikit-Learn** if needed. \n", - "\n", - "Compare the MSE you get from your cross-validation code with the one\n", - "you got from your **bootstrap** code. Comment your results. Try $5-10$\n", - "folds. You can also compare your own cross-validation code with the\n", - "one provided by **Scikit-Learn**.\n", - "\n", - "\n", - "### Exercise: Ridge Regression on the Franke function with resampling\n", - "\n", - "Write your own code for the Ridge method, either using matrix\n", - "inversion or the singular value decomposition as done in the previous\n", - "exercise. Perform the same bootstrap analysis as in the\n", - "Exercise 2 (for the same polynomials) and the cross-validation in exercise 3 but now for different values of $\\lambda$. Compare and\n", - "analyze your results with those obtained in exercises 1-3. Study the\n", - "dependence on $\\lambda$.\n", - "\n", - "Study also the bias-variance trade-off as function of various values of\n", - "the parameter $\\lambda$. For the bias-variance trade-off, use the **bootstrap** resampling method. Comment your results. \n", - "\n", - "### Exercise: Lasso Regression on the Franke function with resampling\n", - "\n", - "This exercise is essentially a repeat of the previous two ones, but now\n", - "with Lasso regression. Write either your own code (difficult and optional) or, in this case,\n", - "you can also use the functionalities of **Scikit-Learn** (recommended). \n", - "Give a\n", - "critical discussion of the three methods and a judgement of which\n", - "model fits the data best. Perform here as well an analysis of the bias-variance trade-off using the **bootstrap** resampling technique and an analysis of the mean squared error using cross-validation. \n", - "\n", - "### Exercise: Analysis of real data\n", - "\n", - "With our codes functioning and having been tested properly on a\n", - "simpler function we are now ready to look at real data. We will\n", - "essentially repeat in this exercise what was done in exercises 1-5. However, we\n", - "need first to download the data and prepare properly the inputs to our\n", - "codes. We are going to download digital terrain data from the website\n", - ",\n", - "\n", - "Or, if you prefer, we have placed selected datafiles at \n", - "\n", - "In order to obtain data for a specific region, you need to register as\n", - "a user (free) at this website and then decide upon which area you want\n", - "to fetch the digital terrain data from. In order to be able to read\n", - "the data properly, you need to specify that the format should be **SRTM\n", - "Arc-Second Global** and download the data as a **GeoTIF** file. The\n", - "files are then stored in *tif* format which can be imported into a\n", - "Python program using" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "scipy.misc.imread" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Here is a simple part of a Python code which reads and plots the data\n", - "from such files" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "\"\"\"\n", - "import numpy as np\n", - "from imageio import imread\n", - "import matplotlib.pyplot as plt\n", - "from mpl_toolkits.mplot3d import Axes3D\n", - "from matplotlib import cm\n", - "\n", - "# Load the terrain\n", - "terrain1 = imread('SRTM_data_Norway_1.tif')\n", - "# Show the terrain\n", - "plt.figure()\n", - "plt.title('Terrain over Norway 1')\n", - "plt.imshow(terrain1, cmap='gray')\n", - "plt.xlabel('X')\n", - "plt.ylabel('Y')\n", - "plt.show()\n", - "\"\"\"" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "If you should have problems in downloading the digital terrain data,\n", - "we provide two examples under the data folder of project 1. One is\n", - "from a region close to Stavanger in Norway and the other Møsvatn\n", - "Austfjell, again in Norway.\n", - "Feel free to produce your own terrain data.\n", - "\n", - "\n", - "Alternatively, if you would like to use another data set, feel free to do so. This could be data close to your reseach area or simply a data set you found interesting. See for example [kaggle.com](https://www.kaggle.com/datasets) for examples.\n", - "\n", - "\n", - "Our final part deals with the parameterization of your digital terrain\n", - "data (or your own data). We will apply all three methods for linear regression, the same type (or higher order) of polynomial\n", - "approximation and cross-validation as resampling technique to evaluate which\n", - "model fits the data best.\n", - "\n", - "At the end, you should present a critical evaluation of your results\n", - "and discuss the applicability of these regression methods to the type\n", - "of data presented here (either the terrain data we propose or other data sets)." - ] - } - ], - "metadata": {}, - "nbformat": 4, - "nbformat_minor": 4 -} diff --git a/doc/LectureNotes/_build/html/_sources/chapter4.ipynb b/doc/LectureNotes/_build/html/_sources/chapter4.ipynb deleted file mode 100644 index faee62767..000000000 --- a/doc/LectureNotes/_build/html/_sources/chapter4.ipynb +++ /dev/null @@ -1,912 +0,0 @@ -{ - "cells": [ - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "# Logistic Regression\n", - "\n", - "\n", - "\n", - "## Logistic Regression\n", - "\n", - "In linear regression our main interest was centered on learning the\n", - "coefficients of a functional fit (say a polynomial) in order to be\n", - "able to predict the response of a continuous variable on some unseen\n", - "data. The fit to the continuous variable $y_i$ is based on some\n", - "independent variables $x_i$. Linear regression resulted in\n", - "analytical expressions for standard ordinary Least Squares or Ridge\n", - "regression (in terms of matrices to invert) for several quantities,\n", - "ranging from the variance and thereby the confidence intervals of the\n", - "optimal parameters $\\hat{\\beta}$ to the mean squared error. If we can invert\n", - "the product of the design matrices, linear regression gives then a\n", - "simple recipe for fitting our data.\n", - "\n", - "\n", - "Classification problems, however, are concerned with outcomes taking\n", - "the form of discrete variables (i.e. categories). We may for example,\n", - "on the basis of DNA sequencing for a number of patients, like to find\n", - "out which mutations are important for a certain disease; or based on\n", - "scans of various patients' brains, figure out if there is a tumor or\n", - "not; or given a specific physical system, we'd like to identify its\n", - "state, say whether it is an ordered or disordered system (typical\n", - "situation in solid state physics); or classify the status of a\n", - "patient, whether she/he has a stroke or not and many other similar\n", - "situations.\n", - "\n", - "The most common situation we encounter when we apply logistic\n", - "regression is that of two possible outcomes, normally denoted as a\n", - "binary outcome, true or false, positive or negative, success or\n", - "failure etc.\n", - "\n", - "\n", - "Logistic regression will also serve as our stepping stone towards\n", - "neural network algorithms and supervised deep learning. For logistic\n", - "learning, the minimization of the cost function leads to a non-linear\n", - "equation in the parameters $\\hat{\\beta}$. The optimization of the\n", - "problem calls therefore for minimization algorithms. This forms the\n", - "bottle neck of all machine learning algorithms, namely how to find\n", - "reliable minima of a multi-variable function. This leads us to the\n", - "family of gradient descent methods. The latter are the working horses\n", - "of basically all modern machine learning algorithms.\n", - "\n", - "We note also that many of the topics discussed here on logistic \n", - "regression are also commonly used in modern supervised Deep Learning\n", - "models, as we will see later.\n", - "\n", - "\n", - "\n", - "## Basics\n", - "\n", - "We consider the case where the dependent variables, also called the\n", - "responses or the outcomes, $y_i$ are discrete and only take values\n", - "from $k=0,\\dots,K-1$ (i.e. $K$ classes).\n", - "\n", - "The goal is to predict the\n", - "output classes from the design matrix $\\boldsymbol{X}\\in\\mathbb{R}^{n\\times p}$\n", - "made of $n$ samples, each of which carries $p$ features or predictors. The\n", - "primary goal is to identify the classes to which new unseen samples\n", - "belong.\n", - "\n", - "Let us specialize to the case of two classes only, with outputs\n", - "$y_i=0$ and $y_i=1$. Our outcomes could represent the status of a\n", - "credit card user that could default or not on her/his credit card\n", - "debt. That is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "y_i = \\begin{bmatrix} 0 & \\mathrm{no}\\\\ 1 & \\mathrm{yes} \\end{bmatrix}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Before moving to the logistic model, let us try to use our linear\n", - "regression model to classify these two outcomes. We could for example\n", - "fit a linear model to the default case if $y_i > 0.5$ and the no\n", - "default case $y_i \\leq 0.5$.\n", - "\n", - "We would then have our \n", - "weighted linear combination, namely" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - "\\boldsymbol{y} = \\boldsymbol{X}^T\\boldsymbol{\\beta} + \\boldsymbol{\\epsilon},\n", - "\\label{_auto1} \\tag{1}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $\\boldsymbol{y}$ is a vector representing the possible outcomes, $\\boldsymbol{X}$ is our\n", - "$n\\times p$ design matrix and $\\boldsymbol{\\beta}$ represents our estimators/predictors.\n", - "\n", - "\n", - "The main problem with our function is that it takes values on the\n", - "entire real axis. In the case of logistic regression, however, the\n", - "labels $y_i$ are discrete variables. A typical example is the credit\n", - "card data discussed below here, where we can set the state of\n", - "defaulting the debt to $y_i=1$ and not to $y_i=0$ for one the persons\n", - "in the data set (see the full example below).\n", - "\n", - "One simple way to get a discrete output is to have sign\n", - "functions that map the output of a linear regressor to values $\\{0,1\\}$,\n", - "$f(s_i)=sign(s_i)=1$ if $s_i\\ge 0$ and 0 if otherwise. \n", - "We will encounter this model in our first demonstration of neural networks. Historically it is called the ``perceptron\" model in the machine learning\n", - "literature. This model is extremely simple. However, in many cases it is more\n", - "favorable to use a ``soft\" classifier that outputs\n", - "the probability of a given category. This leads us to the logistic function.\n", - "\n", - "\n", - "The following example on data for coronary heart disease (CHD) as function of age may serve as an illustration. In the code here we read and plot whether a person has had CHD (output = 1) or not (output = 0). This ouput is plotted the person's against age. Clearly, the figure shows that attempting to make a standard linear regression fit may not be very meaningful." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "%matplotlib inline\n", - "\n", - "# Common imports\n", - "import os\n", - "import numpy as np\n", - "import pandas as pd\n", - "import matplotlib.pyplot as plt\n", - "from sklearn.linear_model import LinearRegression, Ridge, Lasso\n", - "from sklearn.model_selection import train_test_split\n", - "from sklearn.utils import resample\n", - "from sklearn.metrics import mean_squared_error\n", - "from IPython.display import display\n", - "from pylab import plt, mpl\n", - "plt.style.use('seaborn')\n", - "mpl.rcParams['font.family'] = 'serif'\n", - "\n", - "# Where to save the figures and data files\n", - "PROJECT_ROOT_DIR = \"Results\"\n", - "FIGURE_ID = \"Results/FigureFiles\"\n", - "DATA_ID = \"DataFiles/\"\n", - "\n", - "if not os.path.exists(PROJECT_ROOT_DIR):\n", - " os.mkdir(PROJECT_ROOT_DIR)\n", - "\n", - "if not os.path.exists(FIGURE_ID):\n", - " os.makedirs(FIGURE_ID)\n", - "\n", - "if not os.path.exists(DATA_ID):\n", - " os.makedirs(DATA_ID)\n", - "\n", - "def image_path(fig_id):\n", - " return os.path.join(FIGURE_ID, fig_id)\n", - "\n", - "def data_path(dat_id):\n", - " return os.path.join(DATA_ID, dat_id)\n", - "\n", - "def save_fig(fig_id):\n", - " plt.savefig(image_path(fig_id) + \".png\", format='png')\n", - "\n", - "infile = open(data_path(\"chddata.csv\"),'r')\n", - "\n", - "# Read the chd data as csv file and organize the data into arrays with age group, age, and chd\n", - "chd = pd.read_csv(infile, names=('ID', 'Age', 'Agegroup', 'CHD'))\n", - "chd.columns = ['ID', 'Age', 'Agegroup', 'CHD']\n", - "output = chd['CHD']\n", - "age = chd['Age']\n", - "agegroup = chd['Agegroup']\n", - "numberID = chd['ID'] \n", - "display(chd)\n", - "\n", - "plt.scatter(age, output, marker='o')\n", - "plt.axis([18,70.0,-0.1, 1.2])\n", - "plt.xlabel(r'Age')\n", - "plt.ylabel(r'CHD')\n", - "plt.title(r'Age distribution and Coronary heart disease')\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "What we could attempt however is to plot the mean value for each group." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "agegroupmean = np.array([0.1, 0.133, 0.250, 0.333, 0.462, 0.625, 0.765, 0.800])\n", - "group = np.array([1, 2, 3, 4, 5, 6, 7, 8])\n", - "plt.plot(group, agegroupmean, \"r-\")\n", - "plt.axis([0,9,0, 1.0])\n", - "plt.xlabel(r'Age group')\n", - "plt.ylabel(r'CHD mean values')\n", - "plt.title(r'Mean values for each age group')\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We are now trying to find a function $f(y\\vert x)$, that is a function which gives us an expected value for the output $y$ with a given input $x$.\n", - "In standard linear regression with a linear dependence on $x$, we would write this in terms of our model" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "f(y_i\\vert x_i)=\\beta_0+\\beta_1 x_i.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "This expression implies however that $f(y_i\\vert x_i)$ could take any\n", - "value from minus infinity to plus infinity. If we however let\n", - "$f(y\\vert y)$ be represented by the mean value, the above example\n", - "shows us that we can constrain the function to take values between\n", - "zero and one, that is we have $0 \\le f(y_i\\vert x_i) \\le 1$. Looking\n", - "at our last curve we see also that it has an S-shaped form. This leads\n", - "us to a very popular model for the function $f$, namely the so-called\n", - "Sigmoid function or logistic model. We will consider this function as\n", - "representing the probability for finding a value of $y_i$ with a given\n", - "$x_i$.\n", - "\n", - "\n", - "## The logistic function\n", - "\n", - "Another widely studied model, is the so-called \n", - "perceptron model, which is an example of a \"hard classification\" model. We\n", - "will encounter this model when we discuss neural networks as\n", - "well. Each datapoint is deterministically assigned to a category (i.e\n", - "$y_i=0$ or $y_i=1$). In many cases, and the coronary heart disease data forms one of many such examples, it is favorable to have a \"soft\"\n", - "classifier that outputs the probability of a given category rather\n", - "than a single value. For example, given $x_i$, the classifier\n", - "outputs the probability of being in a category $k$. Logistic regression\n", - "is the most common example of a so-called soft classifier. In logistic\n", - "regression, the probability that a data point $x_i$\n", - "belongs to a category $y_i=\\{0,1\\}$ is given by the so-called logit function (or Sigmoid) which is meant to represent the likelihood for a given event," - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(t) = \\frac{1}{1+\\mathrm \\exp{-t}}=\\frac{\\exp{t}}{1+\\mathrm \\exp{t}}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Note that $1-p(t)= p(-t)$.\n", - "\n", - "## Examples of likelihood functions used in logistic regression and nueral networks\n", - "\n", - "\n", - "The following code plots the logistic function, the step function and other functions we will encounter from here and on." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "\"\"\"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", - "\"\"\"tanh Function\"\"\"\n", - "z = numpy.arange(-2*mt.pi, 2*mt.pi, 0.1)\n", - "t = numpy.tanh(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('tanh function')\n", - "\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We assume now that we have two classes with $y_i$ either $0$ or $1$. Furthermore we assume also that we have only two parameters $\\beta$ in our fitting of the Sigmoid function, that is we define probabilities" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{align*}\n", - "p(y_i=1|x_i,\\boldsymbol{\\beta}) &= \\frac{\\exp{(\\beta_0+\\beta_1x_i)}}{1+\\exp{(\\beta_0+\\beta_1x_i)}},\\nonumber\\\\\n", - "p(y_i=0|x_i,\\boldsymbol{\\beta}) &= 1 - p(y_i=1|x_i,\\boldsymbol{\\beta}),\n", - "\\end{align*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $\\boldsymbol{\\beta}$ are the weights we wish to extract from data, in our case $\\beta_0$ and $\\beta_1$. \n", - "\n", - "Note that we used" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(y_i=0\\vert x_i, \\boldsymbol{\\beta}) = 1-p(y_i=1\\vert x_i, \\boldsymbol{\\beta}).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In order to define the total likelihood for all possible outcomes from a \n", - "dataset $\\mathcal{D}=\\{(y_i,x_i)\\}$, with the binary labels\n", - "$y_i\\in\\{0,1\\}$ and where the data points are drawn independently, we use the so-called [Maximum Likelihood Estimation](https://en.wikipedia.org/wiki/Maximum_likelihood_estimation) (MLE) principle. \n", - "We aim thus at maximizing \n", - "the probability of seeing the observed data. We can then approximate the \n", - "likelihood in terms of the product of the individual probabilities of a specific outcome $y_i$, that is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{align*}\n", - "P(\\mathcal{D}|\\boldsymbol{\\beta})& = \\prod_{i=1}^n \\left[p(y_i=1|x_i,\\boldsymbol{\\beta})\\right]^{y_i}\\left[1-p(y_i=1|x_i,\\boldsymbol{\\beta}))\\right]^{1-y_i}\\nonumber \\\\\n", - "\\end{align*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "from which we obtain the log-likelihood and our **cost/loss** function" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathcal{C}(\\boldsymbol{\\beta}) = \\sum_{i=1}^n \\left( y_i\\log{p(y_i=1|x_i,\\boldsymbol{\\beta})} + (1-y_i)\\log\\left[1-p(y_i=1|x_i,\\boldsymbol{\\beta}))\\right]\\right).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Reordering the logarithms, we can rewrite the **cost/loss** function as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathcal{C}(\\boldsymbol{\\beta}) = \\sum_{i=1}^n \\left(y_i(\\beta_0+\\beta_1x_i) -\\log{(1+\\exp{(\\beta_0+\\beta_1x_i)})}\\right).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The maximum likelihood estimator is defined as the set of parameters that maximize the log-likelihood where we maximize with respect to $\\beta$.\n", - "Since the cost (error) function is just the negative log-likelihood, for logistic regression we have that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathcal{C}(\\boldsymbol{\\beta})=-\\sum_{i=1}^n \\left(y_i(\\beta_0+\\beta_1x_i) -\\log{(1+\\exp{(\\beta_0+\\beta_1x_i)})}\\right).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "This equation is known in statistics as the **cross entropy**. Finally, we note that just as in linear regression, \n", - "in practice we often supplement the cross-entropy with additional regularization terms, usually $L_1$ and $L_2$ regularization as we did for Ridge and Lasso regression.\n", - "\n", - "\n", - "The cross entropy is a convex function of the weights $\\boldsymbol{\\beta}$ and,\n", - "therefore, any local minimizer is a global minimizer. \n", - "\n", - "\n", - "Minimizing this\n", - "cost function with respect to the two parameters $\\beta_0$ and $\\beta_1$ we obtain" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial \\mathcal{C}(\\boldsymbol{\\beta})}{\\partial \\beta_0} = -\\sum_{i=1}^n \\left(y_i -\\frac{\\exp{(\\beta_0+\\beta_1x_i)}}{1+\\exp{(\\beta_0+\\beta_1x_i)}}\\right),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial \\mathcal{C}(\\boldsymbol{\\beta})}{\\partial \\beta_1} = -\\sum_{i=1}^n \\left(y_ix_i -x_i\\frac{\\exp{(\\beta_0+\\beta_1x_i)}}{1+\\exp{(\\beta_0+\\beta_1x_i)}}\\right).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Let us now define a vector $\\boldsymbol{y}$ with $n$ elements $y_i$, an\n", - "$n\\times p$ matrix $\\boldsymbol{X}$ which contains the $x_i$ values and a\n", - "vector $\\boldsymbol{p}$ of fitted probabilities $p(y_i\\vert x_i,\\boldsymbol{\\beta})$. We can rewrite in a more compact form the first\n", - "derivative of cost function as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial \\mathcal{C}(\\boldsymbol{\\beta})}{\\partial \\boldsymbol{\\beta}} = -\\boldsymbol{X}^T\\left(\\boldsymbol{y}-\\boldsymbol{p}\\right).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "If we in addition define a diagonal matrix $\\boldsymbol{W}$ with elements \n", - "$p(y_i\\vert x_i,\\boldsymbol{\\beta})(1-p(y_i\\vert x_i,\\boldsymbol{\\beta})$, we can obtain a compact expression of the second derivative as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial^2 \\mathcal{C}(\\boldsymbol{\\beta})}{\\partial \\boldsymbol{\\beta}\\partial \\boldsymbol{\\beta}^T} = \\boldsymbol{X}^T\\boldsymbol{W}\\boldsymbol{X}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Within a binary classification problem, we can easily expand our model to include multiple predictors. Our ratio between likelihoods is then with $p$ predictors" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\log{ \\frac{p(\\boldsymbol{\\beta}\\boldsymbol{x})}{1-p(\\boldsymbol{\\beta}\\boldsymbol{x})}} = \\beta_0+\\beta_1x_1+\\beta_2x_2+\\dots+\\beta_px_p.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Here we defined $\\boldsymbol{x}=[1,x_1,x_2,\\dots,x_p]$ and $\\boldsymbol{\\beta}=[\\beta_0, \\beta_1, \\dots, \\beta_p]$ leading to" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(\\boldsymbol{\\beta}\\boldsymbol{x})=\\frac{ \\exp{(\\beta_0+\\beta_1x_1+\\beta_2x_2+\\dots+\\beta_px_p)}}{1+\\exp{(\\beta_0+\\beta_1x_1+\\beta_2x_2+\\dots+\\beta_px_p)}}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Till now we have mainly focused on two classes, the so-called binary\n", - "system. Suppose we wish to extend to $K$ classes. Let us for the sake\n", - "of simplicity assume we have only two predictors. We have then following model" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\log{\\frac{p(C=1\\vert x)}{p(K\\vert x)}} = \\beta_{10}+\\beta_{11}x_1,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\log{\\frac{p(C=2\\vert x)}{p(K\\vert x)}} = \\beta_{20}+\\beta_{21}x_1,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and so on till the class $C=K-1$ class" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\log{\\frac{p(C=K-1\\vert x)}{p(K\\vert x)}} = \\beta_{(K-1)0}+\\beta_{(K-1)1}x_1,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and the model is specified in term of $K-1$ so-called log-odds or\n", - "**logit** transformations.\n", - "\n", - "\n", - "\n", - "In our discussion of neural networks we will encounter the above again\n", - "in terms of a slightly modified function, the so-called **Softmax** function.\n", - "\n", - "The softmax function is used in various multiclass classification\n", - "methods, such as multinomial logistic regression (also known as\n", - "softmax regression), multiclass linear discriminant analysis, naive\n", - "Bayes classifiers, and artificial neural networks. Specifically, in\n", - "multinomial logistic regression and linear discriminant analysis, the\n", - "input to the function is the result of $K$ distinct linear functions,\n", - "and the predicted probability for the $k$-th class given a sample\n", - "vector $\\boldsymbol{x}$ and a weighting vector $\\boldsymbol{\\beta}$ is (with two\n", - "predictors):" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(C=k\\vert \\mathbf {x} )=\\frac{\\exp{(\\beta_{k0}+\\beta_{k1}x_1)}}{1+\\sum_{l=1}^{K-1}\\exp{(\\beta_{l0}+\\beta_{l1}x_1)}}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "It is easy to extend to more predictors. The final class is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(C=K\\vert \\mathbf {x} )=\\frac{1}{1+\\sum_{l=1}^{K-1}\\exp{(\\beta_{l0}+\\beta_{l1}x_1)}},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and they sum to one. Our earlier discussions were all specialized to\n", - "the case with two classes only. It is easy to see from the above that\n", - "what we derived earlier is compatible with these equations.\n", - "\n", - "To find the optimal parameters we would typically use a gradient\n", - "descent method. Newton's method and gradient descent methods are\n", - "discussed in the material on [optimization\n", - "methods](https://compphysics.github.io/MachineLearning/doc/pub/Splines/html/Splines-bs.html).\n", - "\n", - "## Wisconsin Cancer Data\n", - "\n", - "We show here how we can use a simple regression case on the breast\n", - "cancer data using Logistic regression as our algorithm for\n", - "classification." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import matplotlib.pyplot as plt\n", - "import numpy as np\n", - "from sklearn.model_selection import train_test_split \n", - "from sklearn.datasets import load_breast_cancer\n", - "from sklearn.linear_model import LogisticRegression\n", - "\n", - "# Load the data\n", - "cancer = load_breast_cancer()\n", - "\n", - "X_train, X_test, y_train, y_test = train_test_split(cancer.data,cancer.target,random_state=0)\n", - "print(X_train.shape)\n", - "print(X_test.shape)\n", - "# Logistic Regression\n", - "logreg = LogisticRegression(solver='lbfgs')\n", - "logreg.fit(X_train, y_train)\n", - "print(\"Test set accuracy with Logistic Regression: {:.2f}\".format(logreg.score(X_test,y_test)))\n", - "#now scale the data\n", - "from sklearn.preprocessing import StandardScaler\n", - "scaler = StandardScaler()\n", - "scaler.fit(X_train)\n", - "X_train_scaled = scaler.transform(X_train)\n", - "X_test_scaled = scaler.transform(X_test)\n", - "# Logistic Regression\n", - "logreg.fit(X_train_scaled, y_train)\n", - "print(\"Test set accuracy Logistic Regression with scaled data: {:.2f}\".format(logreg.score(X_test_scaled,y_test)))" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In addition to the above scores, we could also study the covariance (and the correlation matrix).\n", - "We use **Pandas** to compute the correlation matrix." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import matplotlib.pyplot as plt\n", - "import numpy as np\n", - "from sklearn.model_selection import train_test_split \n", - "from sklearn.datasets import load_breast_cancer\n", - "from sklearn.linear_model import LogisticRegression\n", - "cancer = load_breast_cancer()\n", - "import pandas as pd\n", - "# Making a data frame\n", - "cancerpd = pd.DataFrame(cancer.data, columns=cancer.feature_names)\n", - "\n", - "fig, axes = plt.subplots(15,2,figsize=(10,20))\n", - "malignant = cancer.data[cancer.target == 0]\n", - "benign = cancer.data[cancer.target == 1]\n", - "ax = axes.ravel()\n", - "\n", - "for i in range(30):\n", - " _, bins = np.histogram(cancer.data[:,i], bins =50)\n", - " ax[i].hist(malignant[:,i], bins = bins, alpha = 0.5)\n", - " ax[i].hist(benign[:,i], bins = bins, alpha = 0.5)\n", - " ax[i].set_title(cancer.feature_names[i])\n", - " ax[i].set_yticks(())\n", - "ax[0].set_xlabel(\"Feature magnitude\")\n", - "ax[0].set_ylabel(\"Frequency\")\n", - "ax[0].legend([\"Malignant\", \"Benign\"], loc =\"best\")\n", - "fig.tight_layout()\n", - "plt.show()\n", - "\n", - "import seaborn as sns\n", - "correlation_matrix = cancerpd.corr().round(1)\n", - "# use the heatmap function from seaborn to plot the correlation matrix\n", - "# annot = True to print the values inside the square\n", - "plt.figure(figsize=(15,8))\n", - "sns.heatmap(data=correlation_matrix, annot=True)\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In the above example we note two things. In the first plot we display\n", - "the overlap of benign and malignant tumors as functions of the various\n", - "features in the Wisconsing breast cancer data set. We see that for\n", - "some of the features we can distinguish clearly the benign and\n", - "malignant cases while for other features we cannot. This can point to\n", - "us which features may be of greater interest when we wish to classify\n", - "a benign or not benign tumour.\n", - "\n", - "In the second figure we have computed the so-called correlation\n", - "matrix, which in our case with thirty features becomes a $30\\times 30$\n", - "matrix.\n", - "\n", - "We constructed this matrix using **pandas** via the statements" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "cancerpd = pd.DataFrame(cancer.data, columns=cancer.feature_names)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and then" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "correlation_matrix = cancerpd.corr().round(1)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Diagonalizing this matrix we can in turn say something about which\n", - "features are of relevance and which are not. This leads us to\n", - "the classical Principal Component Analysis (PCA) theorem with\n", - "applications. This will be discussed later this semester ([week 43](https://compphysics.github.io/MachineLearning/doc/pub/week43/html/week43-bs.html))." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import matplotlib.pyplot as plt\n", - "import numpy as np\n", - "from sklearn.model_selection import train_test_split \n", - "from sklearn.datasets import load_breast_cancer\n", - "from sklearn.linear_model import LogisticRegression\n", - "\n", - "# Load the data\n", - "cancer = load_breast_cancer()\n", - "\n", - "X_train, X_test, y_train, y_test = train_test_split(cancer.data,cancer.target,random_state=0)\n", - "print(X_train.shape)\n", - "print(X_test.shape)\n", - "# Logistic Regression\n", - "logreg = LogisticRegression(solver='lbfgs')\n", - "logreg.fit(X_train, y_train)\n", - "print(\"Test set accuracy with Logistic Regression: {:.2f}\".format(logreg.score(X_test,y_test)))\n", - "#now scale the data\n", - "from sklearn.preprocessing import StandardScaler\n", - "scaler = StandardScaler()\n", - "scaler.fit(X_train)\n", - "X_train_scaled = scaler.transform(X_train)\n", - "X_test_scaled = scaler.transform(X_test)\n", - "# Logistic Regression\n", - "logreg.fit(X_train_scaled, y_train)\n", - "print(\"Test set accuracy Logistic Regression with scaled data: {:.2f}\".format(logreg.score(X_test_scaled,y_test)))\n", - "\n", - "\n", - "from sklearn.preprocessing import LabelEncoder\n", - "from sklearn.model_selection import cross_validate\n", - "#Cross validation\n", - "accuracy = cross_validate(logreg,X_test_scaled,y_test,cv=10)['test_score']\n", - "print(accuracy)\n", - "print(\"Test set accuracy with Logistic Regression and scaled data: {:.2f}\".format(logreg.score(X_test_scaled,y_test)))\n", - "\n", - "\n", - "import scikitplot as skplt\n", - "y_pred = logreg.predict(X_test_scaled)\n", - "skplt.metrics.plot_confusion_matrix(y_test, y_pred, normalize=True)\n", - "plt.show()\n", - "y_probas = logreg.predict_proba(X_test_scaled)\n", - "skplt.metrics.plot_roc(y_test, y_probas)\n", - "plt.show()\n", - "skplt.metrics.plot_cumulative_gain(y_test, y_probas)\n", - "plt.show()" - ] - } - ], - "metadata": {}, - "nbformat": 4, - "nbformat_minor": 4 -} diff --git a/doc/LectureNotes/_build/html/_sources/chapter5.ipynb b/doc/LectureNotes/_build/html/_sources/chapter5.ipynb deleted file mode 100644 index 0e24adf4e..000000000 --- a/doc/LectureNotes/_build/html/_sources/chapter5.ipynb +++ /dev/null @@ -1,1867 +0,0 @@ -{ - "cells": [ - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "# Support Vector Machines, overarching aims\n", - "\n", - "A Support Vector Machine (SVM) is a very powerful and versatile\n", - "Machine Learning method, capable of performing linear or nonlinear\n", - "classification, regression, and even outlier detection. It is one of\n", - "the most popular models in Machine Learning, and anyone interested in\n", - "Machine Learning should have it in their toolbox. SVMs are\n", - "particularly well suited for classification of complex but small-sized or\n", - "medium-sized datasets. \n", - "\n", - "The case with two well-separated classes only can be understood in an\n", - "intuitive way in terms of lines in a two-dimensional space separating\n", - "the two classes (see figure below).\n", - "\n", - "The basic mathematics behind the SVM is however less familiar to most of us. \n", - "It relies on the definition of hyperplanes and the\n", - "definition of a **margin** which separates classes (in case of\n", - "classification problems) of variables. It is also used for regression\n", - "problems.\n", - "\n", - "With SVMs we distinguish between hard margin and soft margins. The\n", - "latter introduces a so-called softening parameter to be discussed\n", - "below. We distinguish also between linear and non-linear\n", - "approaches. The latter are the most frequent ones since it is rather\n", - "unlikely that we can separate classes easily by say straight lines.\n", - "\n", - "\n", - "## Hyperplanes and all that\n", - "\n", - "The theory behind support vector machines (SVM hereafter) is based on\n", - "the mathematical description of so-called hyperplanes. Let us start\n", - "with a two-dimensional case. This will also allow us to introduce our\n", - "first SVM examples. These will be tailored to the case of two specific\n", - "classes, as displayed in the figure here based on the usage of the petal data.\n", - "\n", - "We assume here that our data set can be well separated into two\n", - "domains, where a straight line does the job in the separating the two\n", - "classes. Here the two classes are represented by either squares or\n", - "circles." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "%matplotlib inline\n", - "\n", - "from sklearn import datasets\n", - "from sklearn.svm import SVC, LinearSVC\n", - "from sklearn.linear_model import SGDClassifier\n", - "from sklearn.preprocessing import StandardScaler\n", - "import matplotlib\n", - "import matplotlib.pyplot as plt\n", - "plt.rcParams['axes.labelsize'] = 14\n", - "plt.rcParams['xtick.labelsize'] = 12\n", - "plt.rcParams['ytick.labelsize'] = 12\n", - "\n", - "\n", - "iris = datasets.load_iris()\n", - "X = iris[\"data\"][:, (2, 3)] # petal length, petal width\n", - "y = iris[\"target\"]\n", - "\n", - "setosa_or_versicolor = (y == 0) | (y == 1)\n", - "X = X[setosa_or_versicolor]\n", - "y = y[setosa_or_versicolor]\n", - "\n", - "\n", - "\n", - "C = 5\n", - "alpha = 1 / (C * len(X))\n", - "\n", - "lin_clf = LinearSVC(loss=\"hinge\", C=C, random_state=42)\n", - "svm_clf = SVC(kernel=\"linear\", C=C)\n", - "sgd_clf = SGDClassifier(loss=\"hinge\", learning_rate=\"constant\", eta0=0.001, alpha=alpha,\n", - " max_iter=100000, random_state=42)\n", - "\n", - "scaler = StandardScaler()\n", - "X_scaled = scaler.fit_transform(X)\n", - "\n", - "lin_clf.fit(X_scaled, y)\n", - "svm_clf.fit(X_scaled, y)\n", - "sgd_clf.fit(X_scaled, y)\n", - "\n", - "print(\"LinearSVC: \", lin_clf.intercept_, lin_clf.coef_)\n", - "print(\"SVC: \", svm_clf.intercept_, svm_clf.coef_)\n", - "print(\"SGDClassifier(alpha={:.5f}):\".format(sgd_clf.alpha), sgd_clf.intercept_, sgd_clf.coef_)\n", - "\n", - "# Compute the slope and bias of each decision boundary\n", - "w1 = -lin_clf.coef_[0, 0]/lin_clf.coef_[0, 1]\n", - "b1 = -lin_clf.intercept_[0]/lin_clf.coef_[0, 1]\n", - "w2 = -svm_clf.coef_[0, 0]/svm_clf.coef_[0, 1]\n", - "b2 = -svm_clf.intercept_[0]/svm_clf.coef_[0, 1]\n", - "w3 = -sgd_clf.coef_[0, 0]/sgd_clf.coef_[0, 1]\n", - "b3 = -sgd_clf.intercept_[0]/sgd_clf.coef_[0, 1]\n", - "\n", - "# Transform the decision boundary lines back to the original scale\n", - "line1 = scaler.inverse_transform([[-10, -10 * w1 + b1], [10, 10 * w1 + b1]])\n", - "line2 = scaler.inverse_transform([[-10, -10 * w2 + b2], [10, 10 * w2 + b2]])\n", - "line3 = scaler.inverse_transform([[-10, -10 * w3 + b3], [10, 10 * w3 + b3]])\n", - "\n", - "# Plot all three decision boundaries\n", - "plt.figure(figsize=(11, 4))\n", - "plt.plot(line1[:, 0], line1[:, 1], \"k:\", label=\"LinearSVC\")\n", - "plt.plot(line2[:, 0], line2[:, 1], \"b--\", linewidth=2, label=\"SVC\")\n", - "plt.plot(line3[:, 0], line3[:, 1], \"r-\", label=\"SGDClassifier\")\n", - "plt.plot(X[:, 0][y==1], X[:, 1][y==1], \"bs\") # label=\"Iris-Versicolor\"\n", - "plt.plot(X[:, 0][y==0], X[:, 1][y==0], \"yo\") # label=\"Iris-Setosa\"\n", - "plt.xlabel(\"Petal length\", fontsize=14)\n", - "plt.ylabel(\"Petal width\", fontsize=14)\n", - "plt.legend(loc=\"upper center\", fontsize=14)\n", - "plt.axis([0, 5.5, 0, 2])\n", - "\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The aim of the SVM algorithm is to find a hyperplane in a\n", - "$p$-dimensional space, where $p$ is the number of features that\n", - "distinctly classifies the data points.\n", - "\n", - "In a $p$-dimensional space, a hyperplane is what we call an affine subspace of dimension of $p-1$.\n", - "As an example, in two dimension, a hyperplane is simply as straight line while in three dimensions it is \n", - "a two-dimensional subspace, or stated simply, a plane. \n", - "\n", - "In two dimensions, with the variables $x_1$ and $x_2$, the hyperplane is defined as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "b+w_1x_1+w_2x_2=0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $b$ is the intercept and $w_1$ and $w_2$ define the elements of a vector orthogonal to the line \n", - "$b+w_1x_1+w_2x_2=0$. \n", - "In two dimensions we define the vectors $\\boldsymbol{x} =[x1,x2]$ and $\\boldsymbol{w}=[w1,w2]$. \n", - "We can then rewrite the above equation as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{x}^T\\boldsymbol{w}+b=0.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We limit ourselves to two classes of outputs $y_i$ and assign these classes the values $y_i = \\pm 1$. \n", - "In a $p$-dimensional space of say $p$ features we have a hyperplane defines as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "b+wx_1+w_2x_2+\\dots +w_px_p=0.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "If we define a \n", - "matrix $\\boldsymbol{X}=\\left[\\boldsymbol{x}_1,\\boldsymbol{x}_2,\\dots, \\boldsymbol{x}_p\\right]$\n", - "of dimension $n\\times p$, where $n$ represents the observations for each feature and each vector $x_i$ is a column vector of the matrix $\\boldsymbol{X}$," - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{x}_i = \\begin{bmatrix} x_{i1} \\\\ x_{i2} \\\\ \\dots \\\\ \\dots \\\\ x_{ip} \\end{bmatrix}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "If the above condition is not met for a given vector $\\boldsymbol{x}_i$ we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "b+w_1x_{i1}+w_2x_{i2}+\\dots +w_px_{ip} >0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "if our output $y_i=1$.\n", - "In this case we say that $\\boldsymbol{x}_i$ lies on one of the sides of the hyperplane and if" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "b+w_1x_{i1}+w_2x_{i2}+\\dots +w_px_{ip} < 0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "for the class of observations $y_i=-1$, \n", - "then $\\boldsymbol{x}_i$ lies on the other side. \n", - "\n", - "Equivalently, for the two classes of observations we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "y_i\\left(b+w_1x_{i1}+w_2x_{i2}+\\dots +w_px_{ip}\\right) > 0.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "When we try to separate hyperplanes, if it exists, we can use it to construct a natural classifier: a test observation is assigned a given class depending on which side of the hyperplane it is located.\n", - "\n", - "\n", - "### The two-dimensional case\n", - "\n", - "Let us try to develop our intuition about SVMs by limiting ourselves to a two-dimensional\n", - "plane. To separate the two classes of data points, there are many\n", - "possible lines (hyperplanes if you prefer a more strict naming) \n", - "that could be chosen. Our objective is to find a\n", - "plane that has the maximum margin, i.e the maximum distance between\n", - "data points of both classes. Maximizing the margin distance provides\n", - "some reinforcement so that future data points can be classified with\n", - "more confidence.\n", - "\n", - "What a linear classifier attempts to accomplish is to split the\n", - "feature space into two half spaces by placing a hyperplane between the\n", - "data points. This hyperplane will be our decision boundary. All\n", - "points on one side of the plane will belong to class one and all points\n", - "on the other side of the plane will belong to the second class two.\n", - "\n", - "Unfortunately there are many ways in which we can place a hyperplane\n", - "to divide the data. Below is an example of two candidate hyperplanes\n", - "for our data sample.\n", - "\n", - "\n", - "Let us define the function" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "f(x) = \\boldsymbol{w}^T\\boldsymbol{x}+b = 0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "as the function that determines the line $L$ that separates two classes (our two features), see the figure here. \n", - "\n", - "\n", - "Any point defined by $\\boldsymbol{x}_i$ and $\\boldsymbol{x}_2$ on the line $L$ will satisfy $\\boldsymbol{w}^T(\\boldsymbol{x}_1-\\boldsymbol{x}_2)=0$. \n", - "\n", - "The signed distance $\\delta$ from any point defined by a vector $\\boldsymbol{x}$ and a point $\\boldsymbol{x}_0$ on the line $L$ is then" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\delta = \\frac{1}{\\vert\\vert \\boldsymbol{w}\\vert\\vert}(\\boldsymbol{w}^T\\boldsymbol{x}+b).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "How do we find the parameter $b$ and the vector $\\boldsymbol{w}$? What we could\n", - "do is to define a cost function which now contains the set of all\n", - "misclassified points $M$ and attempt to minimize this function" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(\\boldsymbol{w},b) = -\\sum_{i\\in M} y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We could now for example define all values $y_i =1$ as misclassified in case we have $\\boldsymbol{w}^T\\boldsymbol{x}_i+b < 0$ and the opposite if we have $y_i=-1$. Taking the derivatives gives us" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial C}{\\partial b} = -\\sum_{i\\in M} y_i,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial C}{\\partial \\boldsymbol{w}} = -\\sum_{i\\in M} y_ix_i.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We can now use the Newton-Raphson method or different variants of the gradient descent family (from plain gradient descent to various stochastic gradient descent approaches) to solve the equations" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "b \\leftarrow b +\\eta \\frac{\\partial C}{\\partial b},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{w} \\leftarrow \\boldsymbol{w} +\\eta \\frac{\\partial C}{\\partial \\boldsymbol{w}},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $\\eta$ is our by now well-known learning rate. \n", - "\n", - "\n", - "\n", - "The equations we discussed above can be coded rather easily (the\n", - "framework is similar to what we developed for logistic\n", - "regression). We are going to set up a simple case with two classes only and we want to find a line which separates them the best possible way." - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "There are however problems with this approach, although it looks\n", - "pretty straightforward to implement. When running the above code, we see that we can easily end up with many diffeent lines which separate the two classes.\n", - "\n", - "\n", - "For small\n", - "gaps between the entries, we may also end up needing many iterations\n", - "before the solutions converge and if the data cannot be separated\n", - "properly into two distinct classes, we may not experience a converge\n", - "at all.\n", - "\n", - "\n", - "### A better approach\n", - "\n", - "A better approach is rather to try to define a large margin between\n", - "the two classes (if they are well separated from the beginning).\n", - "\n", - "Thus, we wish to find a margin $M$ with $\\boldsymbol{w}$ normalized to\n", - "$\\vert\\vert \\boldsymbol{w}\\vert\\vert =1$ subject to the condition" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b) \\geq M \\hspace{0.1cm}\\forall i=1,2,\\dots, p.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "All points are thus at a signed distance from the decision boundary defined by the line $L$. The parameters $b$ and $w_1$ and $w_2$ define this line. \n", - "\n", - "We seek thus the largest value $M$ defined by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{1}{\\vert \\vert \\boldsymbol{w}\\vert\\vert}y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b) \\geq M \\hspace{0.1cm}\\forall i=1,2,\\dots, n,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "or just" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b) \\geq M\\vert \\vert \\boldsymbol{w}\\vert\\vert \\hspace{0.1cm}\\forall i.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "If we scale the equation so that $\\vert \\vert \\boldsymbol{w}\\vert\\vert = 1/M$, we have to find the minimum of \n", - "$\\boldsymbol{w}^T\\boldsymbol{w}=\\vert \\vert \\boldsymbol{w}\\vert\\vert$ (the norm) subject to the condition" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b) \\geq 1 \\hspace{0.1cm}\\forall i.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We have thus defined our margin as the invers of the norm of\n", - "$\\boldsymbol{w}$. We want to minimize the norm in order to have a as large as\n", - "possible margin $M$. Before we proceed, we need to remind ourselves\n", - "about Lagrangian multipliers.\n", - "\n", - "\n", - "## A quick Reminder on Lagrangian Multipliers\n", - "\n", - "Consider a function of three independent variables $f(x,y,z)$ . For the function $f$ to be an\n", - "extreme we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "df=0.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "A necessary and sufficient condition is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial f}{\\partial x} =\\frac{\\partial f}{\\partial y}=\\frac{\\partial f}{\\partial z}=0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "due to" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "df = \\frac{\\partial f}{\\partial x}dx+\\frac{\\partial f}{\\partial y}dy+\\frac{\\partial f}{\\partial z}dz.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In many problems the variables $x,y,z$ are often subject to constraints (such as those above for the margin)\n", - "so that they are no longer all independent. It is possible at least in principle to use each \n", - "constraint to eliminate one variable\n", - "and to proceed with a new and smaller set of independent varables.\n", - "\n", - "The use of so-called Lagrangian multipliers is an alternative technique when the elimination\n", - "of variables is incovenient or undesirable. Assume that we have an equation of constraint on \n", - "the variables $x,y,z$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\phi(x,y,z) = 0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "resulting in" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "d\\phi = \\frac{\\partial \\phi}{\\partial x}dx+\\frac{\\partial \\phi}{\\partial y}dy+\\frac{\\partial \\phi}{\\partial z}dz =0.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Now we cannot set anymore" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial f}{\\partial x} =\\frac{\\partial f}{\\partial y}=\\frac{\\partial f}{\\partial z}=0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "if $df=0$ is wanted\n", - "because there are now only two independent variables! Assume $x$ and $y$ are the independent \n", - "variables.\n", - "Then $dz$ is no longer arbitrary.\n", - "\n", - "\n", - "However, we can add to" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "df = \\frac{\\partial f}{\\partial x}dx+\\frac{\\partial f}{\\partial y}dy+\\frac{\\partial f}{\\partial z}dz,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "a multiplum of $d\\phi$, viz. $\\lambda d\\phi$, resulting in" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "df+\\lambda d\\phi = (\\frac{\\partial f}{\\partial z}+\\lambda\n", - "\\frac{\\partial \\phi}{\\partial x})dx+(\\frac{\\partial f}{\\partial y}+\\lambda\\frac{\\partial \\phi}{\\partial y})dy+\n", - "(\\frac{\\partial f}{\\partial z}+\\lambda\\frac{\\partial \\phi}{\\partial z})dz =0.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Our multiplier is chosen so that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial f}{\\partial z}+\\lambda\\frac{\\partial \\phi}{\\partial z} =0.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We need to remember that we took $dx$ and $dy$ to be arbitrary and thus we must have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial f}{\\partial x}+\\lambda\\frac{\\partial \\phi}{\\partial x} =0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial f}{\\partial y}+\\lambda\\frac{\\partial \\phi}{\\partial y} =0.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "When all these equations are satisfied, $df=0$. We have four unknowns, $x,y,z$ and\n", - "$\\lambda$. Actually we want only $x,y,z$, $\\lambda$ needs not to be determined, \n", - "it is therefore often called\n", - "Lagrange's undetermined multiplier.\n", - "If we have a set of constraints $\\phi_k$ we have the equations" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial f}{\\partial x_i}+\\sum_k\\lambda_k\\frac{\\partial \\phi_k}{\\partial x_i} =0.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In order to solve the above problem, we define the following Lagrangian function to be minimized" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\cal{L}(\\lambda,b,\\boldsymbol{w})=\\frac{1}{2}\\boldsymbol{w}^T\\boldsymbol{w}-\\sum_{i=1}^n\\lambda_i\\left[y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b)-1\\right],\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $\\lambda_i$ is a so-called Lagrange multiplier subject to the condition $\\lambda_i \\geq 0$.\n", - "\n", - "Taking the derivatives with respect to $b$ and $\\boldsymbol{w}$ we obtain" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial \\cal{L}}{\\partial b} = -\\sum_{i} \\lambda_iy_i=0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial \\cal{L}}{\\partial \\boldsymbol{w}} = 0 = \\boldsymbol{w}-\\sum_{i} \\lambda_iy_i\\boldsymbol{x}_i.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Inserting these constraints into the equation for $\\cal{L}$ we obtain" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\cal{L}=\\sum_i\\lambda_i-\\frac{1}{2}\\sum_{ij}^n\\lambda_i\\lambda_jy_iy_j\\boldsymbol{x}_i^T\\boldsymbol{x}_j,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "subject to the constraints $\\lambda_i\\geq 0$ and $\\sum_i\\lambda_iy_i=0$. \n", - "We must in addition satisfy the [Karush-Kuhn-Tucker](https://en.wikipedia.org/wiki/Karush%E2%80%93Kuhn%E2%80%93Tucker_conditions) (KKT) condition" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\lambda_i\\left[y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b) -1\\right] \\hspace{0.1cm}\\forall i.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "1. If $\\lambda_i > 0$, then $y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b)=1$ and we say that $x_i$ is on the boundary.\n", - "\n", - "2. If $y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b)> 1$, we say $x_i$ is not on the boundary and we set $\\lambda_i=0$. \n", - "\n", - "When $\\lambda_i > 0$, the vectors $\\boldsymbol{x}_i$ are called support vectors. They are the vectors closest to the line (or hyperplane) and define the margin $M$. \n", - "\n", - "\n", - "We can rewrite" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\cal{L}=\\sum_i\\lambda_i-\\frac{1}{2}\\sum_{ij}^n\\lambda_i\\lambda_jy_iy_j\\boldsymbol{x}_i^T\\boldsymbol{x}_j,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and its constraints in terms of a matrix-vector problem where we minimize w.r.t. $\\lambda$ the following problem" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{1}{2} \\boldsymbol{\\lambda}^T\\begin{bmatrix} y_1y_1\\boldsymbol{x}_1^T\\boldsymbol{x}_1 & y_1y_2\\boldsymbol{x}_1^T\\boldsymbol{x}_2 & \\dots & \\dots & y_1y_n\\boldsymbol{x}_1^T\\boldsymbol{x}_n \\\\\n", - "y_2y_1\\boldsymbol{x}_2^T\\boldsymbol{x}_1 & y_2y_2\\boldsymbol{x}_2^T\\boldsymbol{x}_2 & \\dots & \\dots & y_1y_n\\boldsymbol{x}_2^T\\boldsymbol{x}_n \\\\\n", - "\\dots & \\dots & \\dots & \\dots & \\dots \\\\\n", - "\\dots & \\dots & \\dots & \\dots & \\dots \\\\\n", - "y_ny_1\\boldsymbol{x}_n^T\\boldsymbol{x}_1 & y_ny_2\\boldsymbol{x}_n^T\\boldsymbol{x}_2 & \\dots & \\dots & y_ny_n\\boldsymbol{x}_n^T\\boldsymbol{x}_n \\\\\n", - "\\end{bmatrix}\\boldsymbol{\\lambda}-\\mathbb{1}\\boldsymbol{\\lambda},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "subject to $\\boldsymbol{y}^T\\boldsymbol{\\lambda}=0$. Here we defined the vectors $\\boldsymbol{\\lambda} =[\\lambda_1,\\lambda_2,\\dots,\\lambda_n]$ and \n", - "$\\boldsymbol{y}=[y_1,y_2,\\dots,y_n]$. \n", - "\n", - "\n", - "\n", - "Solving the above problem, yields the values of $\\lambda_i$.\n", - "To find the coefficients of your hyperplane we need simply to compute" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{w}=\\sum_{i} \\lambda_iy_i\\boldsymbol{x}_i.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "With our vector $\\boldsymbol{w}$ we can in turn find the value of the intercept $b$ (here in two dimensions) via" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b)=1,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "resulting in" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "b = \\frac{1}{y_i}-\\boldsymbol{w}^T\\boldsymbol{x}_i,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "or if we write it out in terms of the support vectors only, with $N_s$ being their number, we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "b = \\frac{1}{N_s}\\sum_{j\\in N_s}\\left(y_j-\\sum_{i=1}^n\\lambda_iy_i\\boldsymbol{x}_i^T\\boldsymbol{x}_j\\right).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "With our hyperplane coefficients we can use our classifier to assign any observation by simply using" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "y_i = \\mathrm{sign}(\\boldsymbol{w}^T\\boldsymbol{x}_i+b).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Below we discuss how to find the optimal values of $\\lambda_i$. Before we proceed however, we discuss now the so-called soft classifier. \n", - "\n", - "\n", - "## A soft classifier\n", - "\n", - "Till now, the margin is strictly defined by the support vectors. This defines what is called a hard classifier, that is the margins are well defined.\n", - "\n", - "Suppose now that classes overlap in feature space, as shown in the\n", - "figure here. One way to deal with this problem before we define the\n", - "so-called **kernel approach**, is to allow a kind of slack in the sense\n", - "that we allow some points to be on the wrong side of the margin.\n", - "\n", - "We introduce thus the so-called **slack** variables $\\boldsymbol{\\xi} =[\\xi_1,x_2,\\dots,x_n]$ and \n", - "modify our previous equation" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b)=1,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "to" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b)=1-\\xi_i,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with the requirement $\\xi_i\\geq 0$. The total violation is now $\\sum_i\\xi$. \n", - "The value $\\xi_i$ in the constraint the last constraint corresponds to the amount by which the prediction\n", - "$y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b)=1$ is on the wrong side of its margin. Hence by bounding the sum $\\sum_i \\xi_i$,\n", - "we bound the total amount by which predictions fall on the wrong side of their margins.\n", - "\n", - "Misclassifications occur when $\\xi_i > 1$. Thus bounding the total sum by some value $C$ bounds in turn the total number of\n", - "misclassifications.\n", - "\n", - "\n", - "This has in turn the consequences that we change our optmization problem to finding the minimum of" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\cal{L}=\\frac{1}{2}\\boldsymbol{w}^T\\boldsymbol{w}-\\sum_{i=1}^n\\lambda_i\\left[y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b)-(1-\\xi_)\\right]+C\\sum_{i=1}^n\\xi_i-\\sum_{i=1}^n\\gamma_i\\xi_i,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "subject to" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b)=1-\\xi_i \\hspace{0.1cm}\\forall i,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with the requirement $\\xi_i\\geq 0$.\n", - "\n", - "Taking the derivatives with respect to $b$ and $\\boldsymbol{w}$ we obtain" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial \\cal{L}}{\\partial b} = -\\sum_{i} \\lambda_iy_i=0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial \\cal{L}}{\\partial \\boldsymbol{w}} = 0 = \\boldsymbol{w}-\\sum_{i} \\lambda_iy_i\\boldsymbol{x}_i,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\lambda_i = C-\\gamma_i \\hspace{0.1cm}\\forall i.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Inserting these constraints into the equation for $\\cal{L}$ we obtain the same equation as before" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\cal{L}=\\sum_i\\lambda_i-\\frac{1}{2}\\sum_{ij}^n\\lambda_i\\lambda_jy_iy_j\\boldsymbol{x}_i^T\\boldsymbol{x}_j,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "but now subject to the constraints $\\lambda_i\\geq 0$, $\\sum_i\\lambda_iy_i=0$ and $0\\leq\\lambda_i \\leq C$. \n", - "We must in addition satisfy the Karush-Kuhn-Tucker condition which now reads" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "5\n", - "0\n", - " \n", - "<\n", - "<\n", - "<\n", - "!\n", - "!\n", - "M\n", - "A\n", - "T\n", - "H\n", - "_\n", - "B\n", - "L\n", - "O\n", - "C\n", - "K" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\gamma_i\\xi_i = 0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b) -(1-\\xi_) \\geq 0 \\hspace{0.1cm}\\forall i.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Kernels and non-linearity\n", - "\n", - "The cases we have studied till now, were all characterized by two classes\n", - "with a close to linear separability. The classifiers we have described\n", - "so far find linear boundaries in our input feature space. It is\n", - "possible to make our procedure more flexible by exploring the feature\n", - "space using other basis expansions such as higher-order polynomials,\n", - "wavelets, splines etc.\n", - "\n", - "If our feature space is not easy to separate, as shown in the figure\n", - "here, we can achieve a better separation by introducing more complex\n", - "basis functions. The ideal would be, as shown in the next figure, to, via a specific transformation to \n", - "obtain a separation between the classes which is almost linear. \n", - "\n", - "The change of basis, from $x\\rightarrow z=\\phi(x)$ leads to the same type of equations to be solved, except that\n", - "we need to introduce for example a polynomial transformation to a two-dimensional training set." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import numpy as np\n", - "import os\n", - "\n", - "np.random.seed(42)\n", - "\n", - "# To plot pretty figures\n", - "import matplotlib\n", - "import matplotlib.pyplot as plt\n", - "plt.rcParams['axes.labelsize'] = 14\n", - "plt.rcParams['xtick.labelsize'] = 12\n", - "plt.rcParams['ytick.labelsize'] = 12\n", - "\n", - "\n", - "from sklearn.svm import SVC\n", - "from sklearn import datasets\n", - "\n", - "\n", - "\n", - "X1D = np.linspace(-4, 4, 9).reshape(-1, 1)\n", - "X2D = np.c_[X1D, X1D**2]\n", - "y = np.array([0, 0, 1, 1, 1, 1, 1, 0, 0])\n", - "\n", - "plt.figure(figsize=(11, 4))\n", - "\n", - "plt.subplot(121)\n", - "plt.grid(True, which='both')\n", - "plt.axhline(y=0, color='k')\n", - "plt.plot(X1D[:, 0][y==0], np.zeros(4), \"bs\")\n", - "plt.plot(X1D[:, 0][y==1], np.zeros(5), \"g^\")\n", - "plt.gca().get_yaxis().set_ticks([])\n", - "plt.xlabel(r\"$x_1$\", fontsize=20)\n", - "plt.axis([-4.5, 4.5, -0.2, 0.2])\n", - "\n", - "plt.subplot(122)\n", - "plt.grid(True, which='both')\n", - "plt.axhline(y=0, color='k')\n", - "plt.axvline(x=0, color='k')\n", - "plt.plot(X2D[:, 0][y==0], X2D[:, 1][y==0], \"bs\")\n", - "plt.plot(X2D[:, 0][y==1], X2D[:, 1][y==1], \"g^\")\n", - "plt.xlabel(r\"$x_1$\", fontsize=20)\n", - "plt.ylabel(r\"$x_2$\", fontsize=20, rotation=0)\n", - "plt.gca().get_yaxis().set_ticks([0, 4, 8, 12, 16])\n", - "plt.plot([-4.5, 4.5], [6.5, 6.5], \"r--\", linewidth=3)\n", - "plt.axis([-4.5, 4.5, -1, 17])\n", - "plt.subplots_adjust(right=1)\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Suppose we define a polynomial transformation of degree two only (we continue to live in a plane with $x_i$ and $y_i$ as variables)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "z = \\phi(x_i) =\\left(x_i^2, y_i^2, \\sqrt{2}x_iy_i\\right).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "With our new basis, the equations we solved earlier are basically the same, that is we have now (without the slack option for simplicity)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\cal{L}=\\sum_i\\lambda_i-\\frac{1}{2}\\sum_{ij}^n\\lambda_i\\lambda_jy_iy_j\\boldsymbol{z}_i^T\\boldsymbol{z}_j,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "subject to the constraints $\\lambda_i\\geq 0$, $\\sum_i\\lambda_iy_i=0$, and for the support vectors" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "y_i(\\boldsymbol{w}^T\\boldsymbol{z}_i+b)= 1 \\hspace{0.1cm}\\forall i,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "from which we also find $b$.\n", - "To compute $\\boldsymbol{z}_i^T\\boldsymbol{z}_j$ we define the kernel $K(\\boldsymbol{x}_i,\\boldsymbol{x}_j)$ as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "K(\\boldsymbol{x}_i,\\boldsymbol{x}_j)=\\boldsymbol{z}_i^T\\boldsymbol{z}_j= \\phi(\\boldsymbol{x}_i)^T\\phi(\\boldsymbol{x}_j).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "For the above example, the kernel reads" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "K(\\boldsymbol{x}_i,\\boldsymbol{x}_j)=[x_i^2, y_i^2, \\sqrt{2}x_iy_i]^T\\begin{bmatrix} x_j^2 \\\\ y_j^2 \\\\ \\sqrt{2}x_jy_j \\end{bmatrix}=x_i^2x_j^2+2x_ix_jy_iy_j+y_i^2y_j^2.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We note that this is nothing but the dot product of the two original\n", - "vectors $(\\boldsymbol{x}_i^T\\boldsymbol{x}_j)^2$. Instead of thus computing the\n", - "product in the Lagrangian of $\\boldsymbol{z}_i^T\\boldsymbol{z}_j$ we simply compute\n", - "the dot product $(\\boldsymbol{x}_i^T\\boldsymbol{x}_j)^2$.\n", - "\n", - "\n", - "This leads to the so-called\n", - "kernel trick and the result leads to the same as if we went through\n", - "the trouble of performing the transformation\n", - "$\\phi(\\boldsymbol{x}_i)^T\\phi(\\boldsymbol{x}_j)$ during the SVM calculations.\n", - "\n", - "\n", - "\n", - "Using our definition of the kernel We can rewrite again the Lagrangian" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\cal{L}=\\sum_i\\lambda_i-\\frac{1}{2}\\sum_{ij}^n\\lambda_i\\lambda_jy_iy_j\\boldsymbol{x}_i^T\\boldsymbol{z}_j,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "subject to the constraints $\\lambda_i\\geq 0$, $\\sum_i\\lambda_iy_i=0$ in terms of a convex optimization problem" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{1}{2} \\boldsymbol{\\lambda}^T\\begin{bmatrix} y_1y_1K(\\boldsymbol{x}_1,\\boldsymbol{x}_1) & y_1y_2K(\\boldsymbol{x}_1,\\boldsymbol{x}_2) & \\dots & \\dots & y_1y_nK(\\boldsymbol{x}_1,\\boldsymbol{x}_n) \\\\\n", - "y_2y_1K(\\boldsymbol{x}_2,\\boldsymbol{x}_1) & y_2y_2(\\boldsymbol{x}_2,\\boldsymbol{x}_2) & \\dots & \\dots & y_1y_nK(\\boldsymbol{x}_2,\\boldsymbol{x}_n) \\\\\n", - "\\dots & \\dots & \\dots & \\dots & \\dots \\\\\n", - "\\dots & \\dots & \\dots & \\dots & \\dots \\\\\n", - "y_ny_1K(\\boldsymbol{x}_n,\\boldsymbol{x}_1) & y_ny_2K(\\boldsymbol{x}_n\\boldsymbol{x}_2) & \\dots & \\dots & y_ny_nK(\\boldsymbol{x}_n,\\boldsymbol{x}_n) \\\\\n", - "\\end{bmatrix}\\boldsymbol{\\lambda}-\\mathbb{1}\\boldsymbol{\\lambda},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "subject to $\\boldsymbol{y}^T\\boldsymbol{\\lambda}=0$. Here we defined the vectors $\\boldsymbol{\\lambda} =[\\lambda_1,\\lambda_2,\\dots,\\lambda_n]$ and \n", - "$\\boldsymbol{y}=[y_1,y_2,\\dots,y_n]$. \n", - "If we add the slack constants this leads to the additional constraint $0\\leq \\lambda_i \\leq C$.\n", - "\n", - "We can rewrite this (see the solutions below) in terms of a convex optimization problem of the type" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{align*}\n", - " &\\mathrm{min}_{\\lambda}\\hspace{0.2cm} \\frac{1}{2}\\boldsymbol{\\lambda}^T\\boldsymbol{P}\\boldsymbol{\\lambda}+\\boldsymbol{q}^T\\boldsymbol{\\lambda},\\\\ \\nonumber\n", - " &\\mathrm{subject\\hspace{0.1cm}to} \\hspace{0.2cm} \\boldsymbol{G}\\boldsymbol{\\lambda} \\preceq \\boldsymbol{h} \\hspace{0.2cm} \\wedge \\boldsymbol{A}\\boldsymbol{\\lambda}=f.\n", - "\\end{align*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Below we discuss how to solve these equations. Here we note that the matrix $\\boldsymbol{P}$ has matrix elements $p_{ij}=y_iy_jK(\\boldsymbol{x}_i,\\boldsymbol{x}_j)$.\n", - "Given a kernel $K$ and the targets $y_i$ this matrix is easy to set up. The constraint $\\boldsymbol{y}^T\\boldsymbol{\\lambda}=0$ leads to $f=0$ and $\\boldsymbol{A}=\\boldsymbol{y}$. How to set up the matrix $\\boldsymbol{G}$ is discussed later. Here note that the inequalities $0\\leq \\lambda_i \\leq C$ can be split up into\n", - "$0\\leq \\lambda_i$ and $\\lambda_i \\leq C$. These two inequalities define then the matrix $\\boldsymbol{G}$ and the vector $\\boldsymbol{h}$.\n", - "\n", - "\n", - "\n", - "## Different kernels and Mercer's theorem\n", - "\n", - "There are several popular kernels being used. These are\n", - "1. Linear: $K(\\boldsymbol{x},\\boldsymbol{y})=\\boldsymbol{x}^T\\boldsymbol{y}$,\n", - "\n", - "2. Polynomial: $K(\\boldsymbol{x},\\boldsymbol{y})=(\\boldsymbol{x}^T\\boldsymbol{y}+\\gamma)^d$,\n", - "\n", - "3. Gaussian Radial Basis Function: $K(\\boldsymbol{x},\\boldsymbol{y})=\\exp{\\left(-\\gamma\\vert\\vert\\boldsymbol{x}-\\boldsymbol{y}\\vert\\vert^2\\right)}$,\n", - "\n", - "4. Tanh: $K(\\boldsymbol{x},\\boldsymbol{y})=\\tanh{(\\boldsymbol{x}^T\\boldsymbol{y}+\\gamma)}$,\n", - "\n", - "and many other ones.\n", - "\n", - "An important theorem for us is [Mercer's\n", - "theorem](https://en.wikipedia.org/wiki/Mercer%27s_theorem). The\n", - "theorem states that if a kernel function $K$ is symmetric, continuous\n", - "and leads to a positive semi-definite matrix $\\boldsymbol{P}$ then there\n", - "exists a function $\\phi$ that maps $\\boldsymbol{x}_i$ and $\\boldsymbol{x}_j$ into\n", - "another space (possibly with much higher dimensions) such that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "K(\\boldsymbol{x}_i,\\boldsymbol{x}_j)=\\phi(\\boldsymbol{x}_i)^T\\phi(\\boldsymbol{x}_j).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "So you can use $K$ as a kernel since you know $\\phi$ exists, even if\n", - "you don’t know what $\\phi$ is. \n", - "\n", - "Note that some frequently used kernels (such as the Sigmoid kernel)\n", - "don’t respect all of Mercer’s conditions, yet they generally work well\n", - "in practice.\n", - "\n", - "\n", - "## The moons example" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "from __future__ import division, print_function, unicode_literals\n", - "\n", - "import numpy as np\n", - "np.random.seed(42)\n", - "\n", - "import matplotlib\n", - "import matplotlib.pyplot as plt\n", - "plt.rcParams['axes.labelsize'] = 14\n", - "plt.rcParams['xtick.labelsize'] = 12\n", - "plt.rcParams['ytick.labelsize'] = 12\n", - "\n", - "\n", - "from sklearn.svm import SVC\n", - "from sklearn import datasets\n", - "\n", - "\n", - "\n", - "from sklearn.pipeline import Pipeline\n", - "from sklearn.preprocessing import StandardScaler\n", - "from sklearn.svm import LinearSVC\n", - "\n", - "\n", - "from sklearn.datasets import make_moons\n", - "X, y = make_moons(n_samples=100, noise=0.15, random_state=42)\n", - "\n", - "def plot_dataset(X, y, axes):\n", - " plt.plot(X[:, 0][y==0], X[:, 1][y==0], \"bs\")\n", - " plt.plot(X[:, 0][y==1], X[:, 1][y==1], \"g^\")\n", - " plt.axis(axes)\n", - " plt.grid(True, which='both')\n", - " plt.xlabel(r\"$x_1$\", fontsize=20)\n", - " plt.ylabel(r\"$x_2$\", fontsize=20, rotation=0)\n", - "\n", - "plot_dataset(X, y, [-1.5, 2.5, -1, 1.5])\n", - "plt.show()\n", - "\n", - "from sklearn.datasets import make_moons\n", - "from sklearn.pipeline import Pipeline\n", - "from sklearn.preprocessing import PolynomialFeatures\n", - "\n", - "polynomial_svm_clf = Pipeline([\n", - " (\"poly_features\", PolynomialFeatures(degree=3)),\n", - " (\"scaler\", StandardScaler()),\n", - " (\"svm_clf\", LinearSVC(C=10, loss=\"hinge\", random_state=42))\n", - " ])\n", - "\n", - "polynomial_svm_clf.fit(X, y)\n", - "\n", - "def plot_predictions(clf, axes):\n", - " x0s = np.linspace(axes[0], axes[1], 100)\n", - " x1s = np.linspace(axes[2], axes[3], 100)\n", - " x0, x1 = np.meshgrid(x0s, x1s)\n", - " X = np.c_[x0.ravel(), x1.ravel()]\n", - " y_pred = clf.predict(X).reshape(x0.shape)\n", - " y_decision = clf.decision_function(X).reshape(x0.shape)\n", - " plt.contourf(x0, x1, y_pred, cmap=plt.cm.brg, alpha=0.2)\n", - " plt.contourf(x0, x1, y_decision, cmap=plt.cm.brg, alpha=0.1)\n", - "\n", - "plot_predictions(polynomial_svm_clf, [-1.5, 2.5, -1, 1.5])\n", - "plot_dataset(X, y, [-1.5, 2.5, -1, 1.5])\n", - "\n", - "plt.show()\n", - "\n", - "\n", - "from sklearn.svm import SVC\n", - "\n", - "poly_kernel_svm_clf = Pipeline([\n", - " (\"scaler\", StandardScaler()),\n", - " (\"svm_clf\", SVC(kernel=\"poly\", degree=3, coef0=1, C=5))\n", - " ])\n", - "poly_kernel_svm_clf.fit(X, y)\n", - "\n", - "poly100_kernel_svm_clf = Pipeline([\n", - " (\"scaler\", StandardScaler()),\n", - " (\"svm_clf\", SVC(kernel=\"poly\", degree=10, coef0=100, C=5))\n", - " ])\n", - "poly100_kernel_svm_clf.fit(X, y)\n", - "\n", - "plt.figure(figsize=(11, 4))\n", - "\n", - "plt.subplot(121)\n", - "plot_predictions(poly_kernel_svm_clf, [-1.5, 2.5, -1, 1.5])\n", - "plot_dataset(X, y, [-1.5, 2.5, -1, 1.5])\n", - "plt.title(r\"$d=3, r=1, C=5$\", fontsize=18)\n", - "\n", - "plt.subplot(122)\n", - "plot_predictions(poly100_kernel_svm_clf, [-1.5, 2.5, -1, 1.5])\n", - "plot_dataset(X, y, [-1.5, 2.5, -1, 1.5])\n", - "plt.title(r\"$d=10, r=100, C=5$\", fontsize=18)\n", - "\n", - "plt.show()\n", - "\n", - "def gaussian_rbf(x, landmark, gamma):\n", - " return np.exp(-gamma * np.linalg.norm(x - landmark, axis=1)**2)\n", - "\n", - "gamma = 0.3\n", - "\n", - "x1s = np.linspace(-4.5, 4.5, 200).reshape(-1, 1)\n", - "x2s = gaussian_rbf(x1s, -2, gamma)\n", - "x3s = gaussian_rbf(x1s, 1, gamma)\n", - "\n", - "XK = np.c_[gaussian_rbf(X1D, -2, gamma), gaussian_rbf(X1D, 1, gamma)]\n", - "yk = np.array([0, 0, 1, 1, 1, 1, 1, 0, 0])\n", - "\n", - "plt.figure(figsize=(11, 4))\n", - "\n", - "plt.subplot(121)\n", - "plt.grid(True, which='both')\n", - "plt.axhline(y=0, color='k')\n", - "plt.scatter(x=[-2, 1], y=[0, 0], s=150, alpha=0.5, c=\"red\")\n", - "plt.plot(X1D[:, 0][yk==0], np.zeros(4), \"bs\")\n", - "plt.plot(X1D[:, 0][yk==1], np.zeros(5), \"g^\")\n", - "plt.plot(x1s, x2s, \"g--\")\n", - "plt.plot(x1s, x3s, \"b:\")\n", - "plt.gca().get_yaxis().set_ticks([0, 0.25, 0.5, 0.75, 1])\n", - "plt.xlabel(r\"$x_1$\", fontsize=20)\n", - "plt.ylabel(r\"Similarity\", fontsize=14)\n", - "plt.annotate(r'$\\mathbf{x}$',\n", - " xy=(X1D[3, 0], 0),\n", - " xytext=(-0.5, 0.20),\n", - " ha=\"center\",\n", - " arrowprops=dict(facecolor='black', shrink=0.1),\n", - " fontsize=18,\n", - " )\n", - "plt.text(-2, 0.9, \"$x_2$\", ha=\"center\", fontsize=20)\n", - "plt.text(1, 0.9, \"$x_3$\", ha=\"center\", fontsize=20)\n", - "plt.axis([-4.5, 4.5, -0.1, 1.1])\n", - "\n", - "plt.subplot(122)\n", - "plt.grid(True, which='both')\n", - "plt.axhline(y=0, color='k')\n", - "plt.axvline(x=0, color='k')\n", - "plt.plot(XK[:, 0][yk==0], XK[:, 1][yk==0], \"bs\")\n", - "plt.plot(XK[:, 0][yk==1], XK[:, 1][yk==1], \"g^\")\n", - "plt.xlabel(r\"$x_2$\", fontsize=20)\n", - "plt.ylabel(r\"$x_3$ \", fontsize=20, rotation=0)\n", - "plt.annotate(r'$\\phi\\left(\\mathbf{x}\\right)$',\n", - " xy=(XK[3, 0], XK[3, 1]),\n", - " xytext=(0.65, 0.50),\n", - " ha=\"center\",\n", - " arrowprops=dict(facecolor='black', shrink=0.1),\n", - " fontsize=18,\n", - " )\n", - "plt.plot([-0.1, 1.1], [0.57, -0.1], \"r--\", linewidth=3)\n", - "plt.axis([-0.1, 1.1, -0.1, 1.1])\n", - " \n", - "plt.subplots_adjust(right=1)\n", - "\n", - "plt.show()\n", - "\n", - "\n", - "x1_example = X1D[3, 0]\n", - "for landmark in (-2, 1):\n", - " k = gaussian_rbf(np.array([[x1_example]]), np.array([[landmark]]), gamma)\n", - " print(\"Phi({}, {}) = {}\".format(x1_example, landmark, k))\n", - "\n", - "rbf_kernel_svm_clf = Pipeline([\n", - " (\"scaler\", StandardScaler()),\n", - " (\"svm_clf\", SVC(kernel=\"rbf\", gamma=5, C=0.001))\n", - " ])\n", - "rbf_kernel_svm_clf.fit(X, y)\n", - "\n", - "\n", - "from sklearn.svm import SVC\n", - "\n", - "gamma1, gamma2 = 0.1, 5\n", - "C1, C2 = 0.001, 1000\n", - "hyperparams = (gamma1, C1), (gamma1, C2), (gamma2, C1), (gamma2, C2)\n", - "\n", - "svm_clfs = []\n", - "for gamma, C in hyperparams:\n", - " rbf_kernel_svm_clf = Pipeline([\n", - " (\"scaler\", StandardScaler()),\n", - " (\"svm_clf\", SVC(kernel=\"rbf\", gamma=gamma, C=C))\n", - " ])\n", - " rbf_kernel_svm_clf.fit(X, y)\n", - " svm_clfs.append(rbf_kernel_svm_clf)\n", - "\n", - "plt.figure(figsize=(11, 7))\n", - "\n", - "for i, svm_clf in enumerate(svm_clfs):\n", - " plt.subplot(221 + i)\n", - " plot_predictions(svm_clf, [-1.5, 2.5, -1, 1.5])\n", - " plot_dataset(X, y, [-1.5, 2.5, -1, 1.5])\n", - " gamma, C = hyperparams[i]\n", - " plt.title(r\"$\\gamma = {}, C = {}$\".format(gamma, C), fontsize=16)\n", - "\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Mathematical optimization of convex functions\n", - "\n", - "A mathematical (quadratic) optimization problem, or just optimization problem, has the form" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{align*}\n", - " &\\mathrm{min}_{\\lambda}\\hspace{0.2cm} \\frac{1}{2}\\boldsymbol{\\lambda}^T\\boldsymbol{P}\\boldsymbol{\\lambda}+\\boldsymbol{q}^T\\boldsymbol{\\lambda},\\\\ \\nonumber\n", - " &\\mathrm{subject\\hspace{0.1cm}to} \\hspace{0.2cm} \\boldsymbol{G}\\boldsymbol{\\lambda} \\preceq \\boldsymbol{h} \\wedge \\boldsymbol{A}\\boldsymbol{\\lambda}=f.\n", - "\\end{align*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "subject to some constraints for say a selected set $i=1,2,\\dots, n$.\n", - "In our case we are optimizing with respect to the Lagrangian multipliers $\\lambda_i$, and the\n", - "vector $\\boldsymbol{\\lambda}=[\\lambda_1, \\lambda_2,\\dots, \\lambda_n]$ is the optimization variable we are dealing with.\n", - "\n", - "In our case we are particularly interested in a class of optimization problems called convex optmization problems. \n", - "In our discussion on gradient descent methods we discussed at length the definition of a convex function. \n", - "\n", - "Convex optimization problems play a central role in applied mathematics and we recommend strongly [Boyd and Vandenberghe's text on the topics](http://web.stanford.edu/~boyd/cvxbook/).\n", - "\n", - "\n", - "\n", - "\n", - "If we use Python as programming language and wish to venture beyond\n", - "**scikit-learn**, **tensorflow** and similar software which makes our\n", - "lives so much easier, we need to dive into the wonderful world of\n", - "quadratic programming. We can, if we wish, solve the minimization\n", - "problem using say standard gradient methods or conjugate gradient\n", - "methods. However, these methods tend to exhibit a rather slow\n", - "converge. So, welcome to the promised land of quadratic programming.\n", - "\n", - "The functions we need are contained in the quadratic programming package **CVXOPT** and we need to import it together with **numpy** as" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import numpy\n", - "import cvxopt" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "This will make our life much easier. You don't need t write your own optimizer.\n", - "\n", - "\n", - "\n", - "We remind ourselves about the general problem we want to solve" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{align*}\n", - " &\\mathrm{min}_{x}\\hspace{0.2cm} \\frac{1}{2}\\boldsymbol{x}^T\\boldsymbol{P}\\boldsymbol{x}+\\boldsymbol{q}^T\\boldsymbol{x},\\\\ \\nonumber\n", - " &\\mathrm{subject\\hspace{0.1cm} to} \\hspace{0.2cm} \\boldsymbol{G}\\boldsymbol{x} \\preceq \\boldsymbol{h} \\wedge \\boldsymbol{A}\\boldsymbol{x}=f.\n", - "\\end{align*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Let us show how to perform the optmization using a simple case. Assume we want to optimize the following problem" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{align*}\n", - " &\\mathrm{min}_{x}\\hspace{0.2cm} \\frac{1}{2}x^2+5x+3y \\\\ \\nonumber\n", - " &\\mathrm{subject to} \\\\ \\nonumber\n", - " &x, y \\geq 0 \\\\ \\nonumber\n", - " &x+3y \\geq 15 \\\\ \\nonumber\n", - " &2x+5y \\leq 100 \\\\ \\nonumber\n", - " &3x+4y \\leq 80. \\\\ \\nonumber\n", - "\\end{align*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The minimization problem can be rewritten in terms of vectors and matrices as (with $x$ and $y$ being the unknowns)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{1}{2}\\begin{bmatrix} x\\\\ y \\end{bmatrix}^T \\begin{bmatrix} 1 & 0\\\\ 0 & 0 \\end{bmatrix} \\begin{bmatrix} x \\\\ y \\end{bmatrix} + \\begin{bmatrix}3\\\\ 4 \\end{bmatrix}^T \\begin{bmatrix}x \\\\ y \\end{bmatrix}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Similarly, we can now set up the inequalities (we need to change $\\geq$ to $\\leq$ by multiplying with $-1$ on bot sides) as the following matrix-vector equation" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{bmatrix} -1 & 0 \\\\ 0 & -1 \\\\ -1 & -3 \\\\ 2 & 5 \\\\ 3 & 4\\end{bmatrix}\\begin{bmatrix} x \\\\ y\\end{bmatrix} \\preceq \\begin{bmatrix}0 \\\\ 0\\\\ -15 \\\\ 100 \\\\ 80\\end{bmatrix}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We have collapsed all the inequalities into a single matrix $\\boldsymbol{G}$. We see also that our matrix" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{P} =\\begin{bmatrix} 1 & 0\\\\ 0 & 0 \\end{bmatrix}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "is clearly positive semi-definite (all eigenvalues larger or equal zero). \n", - "Finally, the vector $\\boldsymbol{h}$ is defined as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{h} = \\begin{bmatrix}0 \\\\ 0\\\\ -15 \\\\ 100 \\\\ 80\\end{bmatrix}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Since we don't have any equalities the matrix $\\boldsymbol{A}$ is set to zero\n", - "The following code solves the equations for us" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "# Import the necessary packages\n", - "import numpy\n", - "from cvxopt import matrix\n", - "from cvxopt import solvers\n", - "P = matrix(numpy.diag([1,0]), tc=’d’)\n", - "q = matrix(numpy.array([3,4]), tc=’d’)\n", - "G = matrix(numpy.array([[-1,0],[0,-1],[-1,-3],[2,5],[3,4]]), tc=’d’)\n", - "h = matrix(numpy.array([0,0,-15,100,80]), tc=’d’)\n", - "# Construct the QP, invoke solver\n", - "sol = solvers.qp(P,q,G,h)\n", - "# Extract optimal value and solution\n", - "sol[’x’] \n", - "sol[’primal objective’]" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We are now ready to return to our setup of the optmization problem for a more realistic case. Introducing the **slack** parameter $C$ we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{1}{2} \\boldsymbol{\\lambda}^T\\begin{bmatrix} y_1y_1K(\\boldsymbol{x}_1,\\boldsymbol{x}_1) & y_1y_2K(\\boldsymbol{x}_1,\\boldsymbol{x}_2) & \\dots & \\dots & y_1y_nK(\\boldsymbol{x}_1,\\boldsymbol{x}_n) \\\\\n", - "y_2y_1K(\\boldsymbol{x}_2,\\boldsymbol{x}_1) & y_2y_2K(\\boldsymbol{x}_2,\\boldsymbol{x}_2) & \\dots & \\dots & y_1y_nK(\\boldsymbol{x}_2,\\boldsymbol{x}_n) \\\\\n", - "\\dots & \\dots & \\dots & \\dots & \\dots \\\\\n", - "\\dots & \\dots & \\dots & \\dots & \\dots \\\\\n", - "y_ny_1K(\\boldsymbol{x}_n,\\boldsymbol{x}_1) & y_ny_2K(\\boldsymbol{x}_n\\boldsymbol{x}_2) & \\dots & \\dots & y_ny_nK(\\boldsymbol{x}_n,\\boldsymbol{x}_n) \\\\\n", - "\\end{bmatrix}\\boldsymbol{\\lambda}-\\mathbb{I}\\boldsymbol{\\lambda},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "subject to $\\boldsymbol{y}^T\\boldsymbol{\\lambda}=0$. Here we defined the vectors $\\boldsymbol{\\lambda} =[\\lambda_1,\\lambda_2,\\dots,\\lambda_n]$ and \n", - "$\\boldsymbol{y}=[y_1,y_2,\\dots,y_n]$. \n", - "With the slack constants this leads to the additional constraint $0\\leq \\lambda_i \\leq C$.\n", - "\n", - "**code will be added**" - ] - } - ], - "metadata": {}, - "nbformat": 4, - "nbformat_minor": 4 -} diff --git a/doc/LectureNotes/_build/html/_sources/chapter6.ipynb b/doc/LectureNotes/_build/html/_sources/chapter6.ipynb deleted file mode 100644 index 01884f54a..000000000 --- a/doc/LectureNotes/_build/html/_sources/chapter6.ipynb +++ /dev/null @@ -1,1301 +0,0 @@ -{ - "cells": [ - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "# Decision trees, overarching aims\n", - "\n", - "\n", - "We start here with the most basic algorithm, the so-called decision\n", - "tree. With this basic algorithm we can in turn build more complex\n", - "networks, spanning from homogeneous and heterogenous forests (bagging,\n", - "random forests and more) to one of the most popular supervised\n", - "algorithms nowadays, the extreme gradient boosting, or just\n", - "XGBoost. But let us start with the simplest possible ingredient.\n", - "\n", - "Decision trees are supervised learning algorithms used for both,\n", - "classification and regression tasks.\n", - "\n", - "\n", - "The main idea of decision trees\n", - "is to find those descriptive features which contain the most\n", - "**information** regarding the target feature and then split the dataset\n", - "along the values of these features such that the target feature values\n", - "for the resulting underlying datasets are as pure as possible.\n", - "\n", - "The descriptive features which reproduce best the target/output features are normally said\n", - "to be the most informative ones. The process of finding the **most\n", - "informative** feature is done until we accomplish a stopping criteria\n", - "where we then finally end up in so called **leaf nodes**. \n", - "\n", - "## Basics of a tree\n", - "\n", - "A decision tree is typically divided into a **root node**, the **interior nodes**,\n", - "and the final **leaf nodes** or just **leaves**. These entities are then connected by so-called **branches**.\n", - "\n", - "The leaf nodes\n", - "contain the predictions we will make for new query instances presented\n", - "to our trained model. This is possible since the model has \n", - "learned the underlying structure of the training data and hence can,\n", - "given some assumptions, make predictions about the target feature value\n", - "(class) of unseen query instances.\n", - "\n", - "\n", - "## General Features\n", - "\n", - "The overarching approach to decision trees is a top-down approach.\n", - "\n", - "* A leaf provides the classification of a given instance.\n", - "\n", - "* A node specifies a test of some attribute of the instance.\n", - "\n", - "* A branch corresponds to a possible values of an attribute.\n", - "\n", - "* An instance is classified by starting at the root node of the tree, testing the attribute specified by this node, then moving down the tree branch corresponding to the value of the attribute in the given example.\n", - "\n", - "This process is then repeated for the subtree rooted at the new\n", - "node.\n", - "\n", - "\n", - "\n", - "In simplified terms, the process of training a decision tree and\n", - "predicting the target features of query instances is as follows:\n", - "\n", - "1. Present a dataset containing of a number of training instances characterized by a number of descriptive features and a target feature\n", - "\n", - "2. Train the decision tree model by continuously splitting the target feature along the values of the descriptive features using a measure of information gain during the training process\n", - "\n", - "3. Grow the tree until we accomplish a stopping criteria create leaf nodes which represent the *predictions* we want to make for new query instances\n", - "\n", - "4. Show query instances to the tree and run down the tree until we arrive at leaf nodes\n", - "\n", - "Then we are essentially done!" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "%matplotlib inline\n", - "\n", - "import numpy as np\n", - "import matplotlib.pyplot as plt\n", - "from sklearn.preprocessing import PolynomialFeatures\n", - "from sklearn.linear_model import LinearRegression\n", - "\n", - "steps=250\n", - "\n", - "distance=0\n", - "x=0\n", - "distance_list=[]\n", - "steps_list=[]\n", - "while x\n", - "\n", - "Day Outlook Temperature Humidity Wind Ride \n", - "\n", - "\n", - " 1 Sunny Hot High Weak 0 \n", - " 2 Sunny Hot High Strong 1 \n", - " 3 Overcast Hot High Weak 1 \n", - " 4 Rain Mild High Weak 1 \n", - " 5 Rain Cool Normal Weak 1 \n", - " 6 Rain Cool Normal Strong 0 \n", - " 7 Overcast Cool Normal Strong 1 \n", - " 8 Sunny Mild High Weak 0 \n", - " 9 Sunny Cool Normal Weak 1 \n", - " 10 Rain Mild Normal Weak 1 \n", - " 11 Sunny Mild Normal Strong 1 \n", - " 12 Overcast Mild High Strong 1 \n", - " 13 Overcast Hot Normal Weak 1 \n", - " 14 Rain Mild High Strong 0 \n", - "\n", - "\n", - "\n", - "### Simple Python Code to read in Data and perform Classification" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "# Common imports\n", - "import numpy as np\n", - "import pandas as pd\n", - "import matplotlib.pyplot as plt\n", - "from sklearn.tree import DecisionTreeClassifier\n", - "from sklearn.model_selection import train_test_split\n", - "from sklearn.tree import export_graphviz\n", - "from sklearn.preprocessing import StandardScaler, OneHotEncoder\n", - "from sklearn.compose import ColumnTransformer\n", - "from IPython.display import Image \n", - "from pydot import graph_from_dot_data\n", - "import os\n", - "\n", - "# Where to save the figures and data files\n", - "PROJECT_ROOT_DIR = \"Results\"\n", - "FIGURE_ID = \"Results/FigureFiles\"\n", - "DATA_ID = \"DataFiles/\"\n", - "\n", - "if not os.path.exists(PROJECT_ROOT_DIR):\n", - " os.mkdir(PROJECT_ROOT_DIR)\n", - "\n", - "if not os.path.exists(FIGURE_ID):\n", - " os.makedirs(FIGURE_ID)\n", - "\n", - "if not os.path.exists(DATA_ID):\n", - " os.makedirs(DATA_ID)\n", - "\n", - "def image_path(fig_id):\n", - " return os.path.join(FIGURE_ID, fig_id)\n", - "\n", - "def data_path(dat_id):\n", - " return os.path.join(DATA_ID, dat_id)\n", - "\n", - "def save_fig(fig_id):\n", - " plt.savefig(image_path(fig_id) + \".png\", format='png')\n", - "\n", - "infile = open(data_path(\"rideclass.csv\"),'r')\n", - "\n", - "# Read the experimental data with Pandas\n", - "from IPython.display import display\n", - "ridedata = pd.read_csv(infile,names = ('Outlook','Temperature','Humidity','Wind','Ride'))\n", - "ridedata = pd.DataFrame(ridedata)\n", - "\n", - "# Features and targets\n", - "X = ridedata.loc[:, ridedata.columns != 'Ride'].values\n", - "y = ridedata.loc[:, ridedata.columns == 'Ride'].values\n", - "\n", - "# Create the encoder.\n", - "encoder = OneHotEncoder(handle_unknown=\"ignore\")\n", - "# Assume for simplicity all features are categorical.\n", - "encoder.fit(X) \n", - "# Apply the encoder.\n", - "X = encoder.transform(X)\n", - "print(X)\n", - "# Then do a Classification tree\n", - "tree_clf = DecisionTreeClassifier(max_depth=2)\n", - "tree_clf.fit(X, y)\n", - "print(\"Train set accuracy with Decision Tree: {:.2f}\".format(tree_clf.score(X,y)))\n", - "#transfer to a decision tree graph\n", - "export_graphviz(\n", - " tree_clf,\n", - " out_file=\"DataFiles/ride.dot\",\n", - " rounded=True,\n", - " filled=True\n", - ")\n", - "cmd = 'dot -Tpng DataFiles/cancer.dot -o DataFiles/cancer.png'\n", - "os.system(cmd)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The above functions (gini, entropy and misclassification error) are\n", - "important components of the so-called CART algorithm. We will discuss\n", - "this algorithm below after we have discussed the information gain\n", - "algorithm ID3.\n", - "\n", - "In the example here we have converted all our attributes into numerical values $0,1,2$ etc." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "# Split a dataset based on an attribute and an attribute value\n", - "def test_split(index, value, dataset):\n", - "\tleft, right = list(), list()\n", - "\tfor row in dataset:\n", - "\t\tif row[index] < value:\n", - "\t\t\tleft.append(row)\n", - "\t\telse:\n", - "\t\t\tright.append(row)\n", - "\treturn left, right\n", - " \n", - "# Calculate the Gini index for a split dataset\n", - "def gini_index(groups, classes):\n", - "\t# count all samples at split point\n", - "\tn_instances = float(sum([len(group) for group in groups]))\n", - "\t# sum weighted Gini index for each group\n", - "\tgini = 0.0\n", - "\tfor group in groups:\n", - "\t\tsize = float(len(group))\n", - "\t\t# avoid divide by zero\n", - "\t\tif size == 0:\n", - "\t\t\tcontinue\n", - "\t\tscore = 0.0\n", - "\t\t# score the group based on the score for each class\n", - "\t\tfor class_val in classes:\n", - "\t\t\tp = [row[-1] for row in group].count(class_val) / size\n", - "\t\t\tscore += p * p\n", - "\t\t# weight the group score by its relative size\n", - "\t\tgini += (1.0 - score) * (size / n_instances)\n", - "\treturn gini\n", - "\n", - "# Select the best split point for a dataset\n", - "def get_split(dataset):\n", - "\tclass_values = list(set(row[-1] for row in dataset))\n", - "\tb_index, b_value, b_score, b_groups = 999, 999, 999, None\n", - "\tfor index in range(len(dataset[0])-1):\n", - "\t\tfor row in dataset:\n", - "\t\t\tgroups = test_split(index, row[index], dataset)\n", - "\t\t\tgini = gini_index(groups, class_values)\n", - "\t\t\tprint('X%d < %.3f Gini=%.3f' % ((index+1), row[index], gini))\n", - "\t\t\tif gini < b_score:\n", - "\t\t\t\tb_index, b_value, b_score, b_groups = index, row[index], gini, groups\n", - "\treturn {'index':b_index, 'value':b_value, 'groups':b_groups}\n", - " \n", - "dataset = [[0,0,0,0,0],\n", - " [0,0,0,1,1],\n", - " [1,0,0,0,1],\n", - " [2,1,0,0,1],\n", - " [2,2,1,0,1],\n", - " [2,2,1,1,0],\n", - " [1,2,1,1,1],\n", - " [0,1,0,0,0],\n", - " [0,2,1,0,1],\n", - " [2,1,1,0,1],\n", - " [0,1,1,1,1],\n", - " [1,1,0,1,1],\n", - " [1,0,1,0,1],\n", - " [2,1,0,1,0]]\n", - "\n", - "split = get_split(dataset)\n", - "print('Split: [X%d < %.3f]' % ((split['index']+1), split['value']))" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Entropy and the ID3 algorithm\n", - "\n", - "The ID3 algorithm learns decision trees by constructing\n", - "them in a top down way, beginning with the question **which attribute should be tested at the root of the tree**?\n", - "\n", - "1. Each instance attribute is evaluated using a statistical test to determine how well it alone classifies the training examples.\n", - "\n", - "2. The best attribute is selected and used as the test at the root node of the tree.\n", - "\n", - "3. A descendant of the root node is then created for each possible value of this attribute.\n", - "\n", - "4. Training examples are sorted to the appropriate descendant node.\n", - "\n", - "5. The entire process is then repeated using the training examples associated with each descendant node to select the best attribute to test at that point in the tree.\n", - "\n", - "6. This forms a greedy search for an acceptable decision tree, in which the algorithm never backtracks to reconsider earlier choices. \n", - "\n", - "The ID3 algorithm selects which attribute to test at each node in the\n", - "tree.\n", - "\n", - "We would like to select the attribute that is most useful for classifying\n", - "examples.\n", - "\n", - "What is a good quantitative measure of the worth of an attribute?\n", - "\n", - "Information gain measures how well a given attribute separates the\n", - "training examples according to their target classification.\n", - "\n", - "The ID3 algorithm uses this information gain measure to select among the candidate\n", - "attributes at each step while growing the tree.\n", - "\n", - "\n", - "### Cancer Data again now with Decision Trees and other Methods" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import matplotlib.pyplot as plt\n", - "import numpy as np\n", - "from sklearn.model_selection import train_test_split \n", - "from sklearn.datasets import load_breast_cancer\n", - "from sklearn.svm import SVC\n", - "from sklearn.linear_model import LogisticRegression\n", - "from sklearn.tree import DecisionTreeClassifier\n", - "\n", - "# Load the data\n", - "cancer = load_breast_cancer()\n", - "\n", - "X_train, X_test, y_train, y_test = train_test_split(cancer.data,cancer.target,random_state=0)\n", - "print(X_train.shape)\n", - "print(X_test.shape)\n", - "# Logistic Regression\n", - "logreg = LogisticRegression(solver='lbfgs')\n", - "logreg.fit(X_train, y_train)\n", - "print(\"Test set accuracy with Logistic Regression: {:.2f}\".format(logreg.score(X_test,y_test)))\n", - "# Support vector machine\n", - "svm = SVC(gamma='auto', C=100)\n", - "svm.fit(X_train, y_train)\n", - "print(\"Test set accuracy with SVM: {:.2f}\".format(svm.score(X_test,y_test)))\n", - "# Decision Trees\n", - "deep_tree_clf = DecisionTreeClassifier(max_depth=None)\n", - "deep_tree_clf.fit(X_train, y_train)\n", - "print(\"Test set accuracy with Decision Trees: {:.2f}\".format(deep_tree_clf.score(X_test,y_test)))\n", - "#now scale the data\n", - "from sklearn.preprocessing import StandardScaler\n", - "scaler = StandardScaler()\n", - "scaler.fit(X_train)\n", - "X_train_scaled = scaler.transform(X_train)\n", - "X_test_scaled = scaler.transform(X_test)\n", - "# Logistic Regression\n", - "logreg.fit(X_train_scaled, y_train)\n", - "print(\"Test set accuracy Logistic Regression with scaled data: {:.2f}\".format(logreg.score(X_test_scaled,y_test)))\n", - "# Support Vector Machine\n", - "svm.fit(X_train_scaled, y_train)\n", - "print(\"Test set accuracy SVM with scaled data: {:.2f}\".format(logreg.score(X_test_scaled,y_test)))\n", - "# Decision Trees\n", - "deep_tree_clf.fit(X_train_scaled, y_train)\n", - "print(\"Test set accuracy with Decision Trees and scaled data: {:.2f}\".format(deep_tree_clf.score(X_test_scaled,y_test)))" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "### Another example, the moons again" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "from __future__ import division, print_function, unicode_literals\n", - "\n", - "# Common imports\n", - "import numpy as np\n", - "import os\n", - "\n", - "# to make this notebook's output stable across runs\n", - "np.random.seed(42)\n", - "\n", - "# To plot pretty figures\n", - "import matplotlib\n", - "import matplotlib.pyplot as plt\n", - "from matplotlib.colors import ListedColormap\n", - "plt.rcParams['axes.labelsize'] = 14\n", - "plt.rcParams['xtick.labelsize'] = 12\n", - "plt.rcParams['ytick.labelsize'] = 12\n", - "\n", - "\n", - "from sklearn.svm import SVC\n", - "from sklearn import datasets\n", - "from sklearn.tree import DecisionTreeClassifier\n", - "from sklearn.datasets import make_moons\n", - "from sklearn.tree import export_graphviz\n", - "\n", - "Xm, ym = make_moons(n_samples=100, noise=0.25, random_state=53)\n", - "\n", - "deep_tree_clf1 = DecisionTreeClassifier(random_state=42)\n", - "deep_tree_clf2 = DecisionTreeClassifier(min_samples_leaf=4, random_state=42)\n", - "deep_tree_clf1.fit(Xm, ym)\n", - "deep_tree_clf2.fit(Xm, ym)\n", - "\n", - "\n", - "def plot_decision_boundary(clf, X, y, axes=[0, 7.5, 0, 3], iris=True, legend=False, plot_training=True):\n", - " x1s = np.linspace(axes[0], axes[1], 100)\n", - " x2s = np.linspace(axes[2], axes[3], 100)\n", - " x1, x2 = np.meshgrid(x1s, x2s)\n", - " X_new = np.c_[x1.ravel(), x2.ravel()]\n", - " y_pred = clf.predict(X_new).reshape(x1.shape)\n", - " custom_cmap = ListedColormap(['#fafab0','#9898ff','#a0faa0'])\n", - " plt.contourf(x1, x2, y_pred, alpha=0.3, cmap=custom_cmap)\n", - " if not iris:\n", - " custom_cmap2 = ListedColormap(['#7d7d58','#4c4c7f','#507d50'])\n", - " plt.contour(x1, x2, y_pred, cmap=custom_cmap2, alpha=0.8)\n", - " if plot_training:\n", - " plt.plot(X[:, 0][y==0], X[:, 1][y==0], \"yo\", label=\"Iris-Setosa\")\n", - " plt.plot(X[:, 0][y==1], X[:, 1][y==1], \"bs\", label=\"Iris-Versicolor\")\n", - " plt.plot(X[:, 0][y==2], X[:, 1][y==2], \"g^\", label=\"Iris-Virginica\")\n", - " plt.axis(axes)\n", - " if iris:\n", - " plt.xlabel(\"Petal length\", fontsize=14)\n", - " plt.ylabel(\"Petal width\", fontsize=14)\n", - " else:\n", - " plt.xlabel(r\"$x_1$\", fontsize=18)\n", - " plt.ylabel(r\"$x_2$\", fontsize=18, rotation=0)\n", - " if legend:\n", - " plt.legend(loc=\"lower right\", fontsize=14)\n", - "plt.figure(figsize=(11, 4))\n", - "plt.subplot(121)\n", - "plot_decision_boundary(deep_tree_clf1, Xm, ym, axes=[-1.5, 2.5, -1, 1.5], iris=False)\n", - "plt.title(\"No restrictions\", fontsize=16)\n", - "plt.subplot(122)\n", - "plot_decision_boundary(deep_tree_clf2, Xm, ym, axes=[-1.5, 2.5, -1, 1.5], iris=False)\n", - "plt.title(\"min_samples_leaf = {}\".format(deep_tree_clf2.min_samples_leaf), fontsize=14)\n", - "plt.show()" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "np.random.seed(6)\n", - "Xs = np.random.rand(100, 2) - 0.5\n", - "ys = (Xs[:, 0] > 0).astype(np.float32) * 2\n", - "\n", - "angle = np.pi/4\n", - "rotation_matrix = np.array([[np.cos(angle), -np.sin(angle)], [np.sin(angle), np.cos(angle)]])\n", - "Xsr = Xs.dot(rotation_matrix)\n", - "\n", - "tree_clf_s = DecisionTreeClassifier(random_state=42)\n", - "tree_clf_s.fit(Xs, ys)\n", - "tree_clf_sr = DecisionTreeClassifier(random_state=42)\n", - "tree_clf_sr.fit(Xsr, ys)\n", - "\n", - "plt.figure(figsize=(11, 4))\n", - "plt.subplot(121)\n", - "plot_decision_boundary(tree_clf_s, Xs, ys, axes=[-0.7, 0.7, -0.7, 0.7], iris=False)\n", - "plt.subplot(122)\n", - "plot_decision_boundary(tree_clf_sr, Xsr, ys, axes=[-0.7, 0.7, -0.7, 0.7], iris=False)\n", - "\n", - "plt.show()" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "# Quadratic training set + noise\n", - "np.random.seed(42)\n", - "m = 200\n", - "X = np.random.rand(m, 1)\n", - "y = 4 * (X - 0.5) ** 2\n", - "y = y + np.random.randn(m, 1) / 10" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "from sklearn.tree import DecisionTreeRegressor\n", - "\n", - "tree_reg = DecisionTreeRegressor(max_depth=2, random_state=42)\n", - "tree_reg.fit(X, y)" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "from sklearn.tree import DecisionTreeRegressor\n", - "\n", - "tree_reg1 = DecisionTreeRegressor(random_state=42, max_depth=2)\n", - "tree_reg2 = DecisionTreeRegressor(random_state=42, max_depth=3)\n", - "tree_reg1.fit(X, y)\n", - "tree_reg2.fit(X, y)\n", - "\n", - "def plot_regression_predictions(tree_reg, X, y, axes=[0, 1, -0.2, 1], ylabel=\"$y$\"):\n", - " x1 = np.linspace(axes[0], axes[1], 500).reshape(-1, 1)\n", - " y_pred = tree_reg.predict(x1)\n", - " plt.axis(axes)\n", - " plt.xlabel(\"$x_1$\", fontsize=18)\n", - " if ylabel:\n", - " plt.ylabel(ylabel, fontsize=18, rotation=0)\n", - " plt.plot(X, y, \"b.\")\n", - " plt.plot(x1, y_pred, \"r.-\", linewidth=2, label=r\"$\\hat{y}$\")\n", - "\n", - "plt.figure(figsize=(11, 4))\n", - "plt.subplot(121)\n", - "plot_regression_predictions(tree_reg1, X, y)\n", - "for split, style in ((0.1973, \"k-\"), (0.0917, \"k--\"), (0.7718, \"k--\")):\n", - " plt.plot([split, split], [-0.2, 1], style, linewidth=2)\n", - "plt.text(0.21, 0.65, \"Depth=0\", fontsize=15)\n", - "plt.text(0.01, 0.2, \"Depth=1\", fontsize=13)\n", - "plt.text(0.65, 0.8, \"Depth=1\", fontsize=13)\n", - "plt.legend(loc=\"upper center\", fontsize=18)\n", - "plt.title(\"max_depth=2\", fontsize=14)\n", - "\n", - "plt.subplot(122)\n", - "plot_regression_predictions(tree_reg2, X, y, ylabel=None)\n", - "for split, style in ((0.1973, \"k-\"), (0.0917, \"k--\"), (0.7718, \"k--\")):\n", - " plt.plot([split, split], [-0.2, 1], style, linewidth=2)\n", - "for split in (0.0458, 0.1298, 0.2873, 0.9040):\n", - " plt.plot([split, split], [-0.2, 1], \"k:\", linewidth=1)\n", - "plt.text(0.3, 0.5, \"Depth=2\", fontsize=13)\n", - "plt.title(\"max_depth=3\", fontsize=14)\n", - "\n", - "plt.show()" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "tree_reg1 = DecisionTreeRegressor(random_state=42)\n", - "tree_reg2 = DecisionTreeRegressor(random_state=42, min_samples_leaf=10)\n", - "tree_reg1.fit(X, y)\n", - "tree_reg2.fit(X, y)\n", - "\n", - "x1 = np.linspace(0, 1, 500).reshape(-1, 1)\n", - "y_pred1 = tree_reg1.predict(x1)\n", - "y_pred2 = tree_reg2.predict(x1)\n", - "\n", - "plt.figure(figsize=(11, 4))\n", - "\n", - "plt.subplot(121)\n", - "plt.plot(X, y, \"b.\")\n", - "plt.plot(x1, y_pred1, \"r.-\", linewidth=2, label=r\"$\\hat{y}$\")\n", - "plt.axis([0, 1, -0.2, 1.1])\n", - "plt.xlabel(\"$x_1$\", fontsize=18)\n", - "plt.ylabel(\"$y$\", fontsize=18, rotation=0)\n", - "plt.legend(loc=\"upper center\", fontsize=18)\n", - "plt.title(\"No restrictions\", fontsize=14)\n", - "\n", - "plt.subplot(122)\n", - "plt.plot(X, y, \"b.\")\n", - "plt.plot(x1, y_pred2, \"r.-\", linewidth=2, label=r\"$\\hat{y}$\")\n", - "plt.axis([0, 1, -0.2, 1.1])\n", - "plt.xlabel(\"$x_1$\", fontsize=18)\n", - "plt.title(\"min_samples_leaf={}\".format(tree_reg2.min_samples_leaf), fontsize=14)\n", - "\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Pros and cons of trees, pros\n", - "\n", - "* White box, easy to interpret model. Some people believe that decision trees more closely mirror human decision-making than do the regression and classification approaches discussed earlier (think of support vector machines)\n", - "\n", - "* Trees are very easy to explain to people. In fact, they are even easier to explain than linear regression!\n", - "\n", - "* No feature normalization needed\n", - "\n", - "* Tree models can handle both continuous and categorical data (Classification and Regression Trees)\n", - "\n", - "* Can model nonlinear relationships\n", - "\n", - "* Can model interactions between the different descriptive features\n", - "\n", - "* Trees can be displayed graphically, and are easily interpreted even by a non-expert (especially if they are small)\n", - "\n", - "### Disadvantages\n", - "\n", - "* Unfortunately, trees generally do not have the same level of predictive accuracy as some of the other regression and classification approaches\n", - "\n", - "* If continuous features are used the tree may become quite large and hence less interpretable\n", - "\n", - "* Decision trees are prone to overfit the training data and hence do not well generalize the data if no stopping criteria or improvements like pruning, boosting or bagging are implemented\n", - "\n", - "* Small changes in the data may lead to a completely different tree. This issue can be addressed by using ensemble methods like bagging, boosting or random forests\n", - "\n", - "* Unbalanced datasets where some target feature values occur much more frequently than others may lead to biased trees since the frequently occurring feature values are preferred over the less frequently occurring ones. \n", - "\n", - "* If the number of features is relatively large (high dimensional) and the number of instances is relatively low, the tree might overfit the data\n", - "\n", - "* Features with many levels may be preferred over features with less levels since for them it is *more easy* to split the dataset such that the sub datasets only contain pure target feature values. This issue can be addressed by preferring for instance the information gain ratio as splitting criteria over information gain\n", - "\n", - "However, by aggregating many decision trees, using methods like\n", - "bagging, random forests, and boosting, the predictive performance of\n", - "trees can be substantially improved." - ] - } - ], - "metadata": {}, - "nbformat": 4, - "nbformat_minor": 4 -} diff --git a/doc/LectureNotes/_build/html/_sources/chapter7.ipynb b/doc/LectureNotes/_build/html/_sources/chapter7.ipynb deleted file mode 100644 index 49dd8591c..000000000 --- a/doc/LectureNotes/_build/html/_sources/chapter7.ipynb +++ /dev/null @@ -1,1580 +0,0 @@ -{ - "cells": [ - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "# Ensemble Methods: From a Single Tree to Many Trees and Extreme Boosting, Meet the Jungle of Methods\n", - "\n", - "As stated previously and seen in many of the examples discussed in the previous chapter about\n", - "a single decision tree, we often end up overfitting our training\n", - "data. This normally means that we have a high variance. Can we reduce\n", - "the variance of a statistical learning method?\n", - "\n", - "This leads us to a set of different methods that can combine different\n", - "machine learning algorithms or just use one of them to construct\n", - "forests and jungles of trees, homogeneous ones or heterogenous\n", - "ones. These methods are recognized by different names which we will\n", - "try to explain here. These are\n", - "\n", - "1. Voting classifiers\n", - "\n", - "2. Bagging and Pasting\n", - "\n", - "3. Random forests\n", - "\n", - "4. Boosting methods, from adaptive to Extreme Gradient Boosting (XGBoost)\n", - "\n", - "We discuss these methods here.\n", - "\n", - "### An Overview of Ensemble Methods\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "## Bagging\n", - "\n", - "The **plain** decision trees suffer from high\n", - "variance. This means that if we split the training data into two parts\n", - "at random, and fit a decision tree to both halves, the results that we\n", - "get could be quite different. In contrast, a procedure with low\n", - "variance will yield similar results if applied repeatedly to distinct\n", - "data sets; linear regression tends to have low variance, if the ratio\n", - "of $n$ to $p$ is moderately large. \n", - "\n", - "**Bootstrap aggregation**, or just **bagging**, is a\n", - "general-purpose procedure for reducing the variance of a statistical\n", - "learning method. \n", - "\n", - "\n", - "Bagging typically results in improved accuracy\n", - "over prediction using a single tree. Unfortunately, however, it can be\n", - "difficult to interpret the resulting model. Recall that one of the\n", - "advantages of decision trees is the attractive and easily interpreted\n", - "diagram that results.\n", - "\n", - "However, when we bag a large number of trees, it is no longer\n", - "possible to represent the resulting statistical learning procedure\n", - "using a single tree, and it is no longer clear which variables are\n", - "most important to the procedure. Thus, bagging improves prediction\n", - "accuracy at the expense of interpretability. Although the collection\n", - "of bagged trees is much more difficult to interpret than a single\n", - "tree, one can obtain an overall summary of the importance of each\n", - "predictor using the MSE (for bagging regression trees) or the Gini\n", - "index (for bagging classification trees). In the case of bagging\n", - "regression trees, we can record the total amount that the MSE is\n", - "decreased due to splits over a given predictor, averaged over all $B$ possible\n", - "trees. A large value indicates an important predictor. Similarly, in\n", - "the context of bagging classification trees, we can add up the total\n", - "amount that the Gini index is decreased by splits over a given\n", - "predictor, averaged over all $B$ trees." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "heads_proba = 0.51\n", - "coin_tosses = (np.random.rand(10000, 10) < heads_proba).astype(np.int32)\n", - "cumulative_heads_ratio = np.cumsum(coin_tosses, axis=0) / np.arange(1, 10001).reshape(-1, 1)\n", - "plt.figure(figsize=(8,3.5))\n", - "plt.plot(cumulative_heads_ratio)\n", - "plt.plot([0, 10000], [0.51, 0.51], \"k--\", linewidth=2, label=\"51%\")\n", - "plt.plot([0, 10000], [0.5, 0.5], \"k-\", label=\"50%\")\n", - "plt.xlabel(\"Number of coin tosses\")\n", - "plt.ylabel(\"Heads ratio\")\n", - "plt.legend(loc=\"lower right\")\n", - "plt.axis([0, 10000, 0.42, 0.58])\n", - "save_fig(\"votingsimple\")\n", - "plt.show()" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "from sklearn.model_selection import train_test_split\n", - "from sklearn.datasets import make_moons\n", - "\n", - "X, y = make_moons(n_samples=500, noise=0.30, random_state=42)\n", - "X_train, X_test, y_train, y_test = train_test_split(X, y, random_state=42)\n", - "\n", - "from sklearn.ensemble import RandomForestClassifier\n", - "from sklearn.ensemble import VotingClassifier\n", - "from sklearn.linear_model import LogisticRegression\n", - "from sklearn.svm import SVC\n", - "\n", - "log_clf = LogisticRegression(solver=\"liblinear\", random_state=42)\n", - "rnd_clf = RandomForestClassifier(n_estimators=10, random_state=42)\n", - "svm_clf = SVC(gamma=\"auto\", random_state=42)\n", - "\n", - "voting_clf = VotingClassifier(\n", - " estimators=[('lr', log_clf), ('rf', rnd_clf), ('svc', svm_clf)],\n", - " voting='hard')\n", - "\n", - "voting_clf.fit(X_train, y_train)\n", - "\n", - "from sklearn.metrics import accuracy_score\n", - "\n", - "for clf in (log_clf, rnd_clf, svm_clf, voting_clf):\n", - " clf.fit(X_train, y_train)\n", - " y_pred = clf.predict(X_test)\n", - " print(clf.__class__.__name__, accuracy_score(y_test, y_pred))\n", - "\n", - "log_clf = LogisticRegression(solver=\"liblinear\", random_state=42)\n", - "rnd_clf = RandomForestClassifier(n_estimators=10, random_state=42)\n", - "svm_clf = SVC(gamma=\"auto\", probability=True, random_state=42)\n", - "\n", - "voting_clf = VotingClassifier(\n", - " estimators=[('lr', log_clf), ('rf', rnd_clf), ('svc', svm_clf)],\n", - " voting='soft')\n", - "voting_clf.fit(X_train, y_train)\n", - "\n", - "from sklearn.metrics import accuracy_score\n", - "\n", - "for clf in (log_clf, rnd_clf, svm_clf, voting_clf):\n", - " clf.fit(X_train, y_train)\n", - " y_pred = clf.predict(X_test)\n", - " print(clf.__class__.__name__, accuracy_score(y_test, y_pred))" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "from sklearn.model_selection import train_test_split\n", - "from sklearn.datasets import make_moons\n", - "\n", - "X, y = make_moons(n_samples=500, noise=0.30, random_state=42)\n", - "X_train, X_test, y_train, y_test = train_test_split(X, y, random_state=42)\n", - "from sklearn.ensemble import RandomForestClassifier\n", - "from sklearn.ensemble import VotingClassifier\n", - "from sklearn.linear_model import LogisticRegression\n", - "from sklearn.svm import SVC\n", - "\n", - "log_clf = LogisticRegression(random_state=42)\n", - "rnd_clf = RandomForestClassifier(random_state=42)\n", - "svm_clf = SVC(random_state=42)\n", - "\n", - "voting_clf = VotingClassifier(\n", - " estimators=[('lr', log_clf), ('rf', rnd_clf), ('svc', svm_clf)],\n", - " voting='hard')\n", - "voting_clf.fit(X_train, y_train)" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "from sklearn.metrics import accuracy_score\n", - "\n", - "for clf in (log_clf, rnd_clf, svm_clf, voting_clf):\n", - " clf.fit(X_train, y_train)\n", - " y_pred = clf.predict(X_test)\n", - " print(clf.__class__.__name__, accuracy_score(y_test, y_pred))" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "log_clf = LogisticRegression(random_state=42)\n", - "rnd_clf = RandomForestClassifier(random_state=42)\n", - "svm_clf = SVC(probability=True, random_state=42)\n", - "\n", - "voting_clf = VotingClassifier(\n", - " estimators=[('lr', log_clf), ('rf', rnd_clf), ('svc', svm_clf)],\n", - " voting='soft')\n", - "voting_clf.fit(X_train, y_train)" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "from sklearn.metrics import accuracy_score\n", - "\n", - "for clf in (log_clf, rnd_clf, svm_clf, voting_clf):\n", - " clf.fit(X_train, y_train)\n", - " y_pred = clf.predict(X_test)\n", - " print(clf.__class__.__name__, accuracy_score(y_test, y_pred))" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Bagging Examples" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "from sklearn.ensemble import BaggingClassifier\n", - "from sklearn.tree import DecisionTreeClassifier\n", - "\n", - "bag_clf = BaggingClassifier(\n", - " DecisionTreeClassifier(random_state=42), n_estimators=500,\n", - " max_samples=100, bootstrap=True, n_jobs=-1, random_state=42)\n", - "bag_clf.fit(X_train, y_train)\n", - "y_pred = bag_clf.predict(X_test)" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "from sklearn.metrics import accuracy_score\n", - "print(accuracy_score(y_test, y_pred))" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "tree_clf = DecisionTreeClassifier(random_state=42)\n", - "tree_clf.fit(X_train, y_train)\n", - "y_pred_tree = tree_clf.predict(X_test)\n", - "print(accuracy_score(y_test, y_pred_tree))" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "%matplotlib inline\n", - "\n", - "from matplotlib.colors import ListedColormap\n", - "\n", - "def plot_decision_boundary(clf, X, y, axes=[-1.5, 2.5, -1, 1.5], alpha=0.5, contour=True):\n", - " x1s = np.linspace(axes[0], axes[1], 100)\n", - " x2s = np.linspace(axes[2], axes[3], 100)\n", - " x1, x2 = np.meshgrid(x1s, x2s)\n", - " X_new = np.c_[x1.ravel(), x2.ravel()]\n", - " y_pred = clf.predict(X_new).reshape(x1.shape)\n", - " custom_cmap = ListedColormap(['#fafab0','#9898ff','#a0faa0'])\n", - " plt.contourf(x1, x2, y_pred, alpha=0.3, cmap=custom_cmap)\n", - " if contour:\n", - " custom_cmap2 = ListedColormap(['#7d7d58','#4c4c7f','#507d50'])\n", - " plt.contour(x1, x2, y_pred, cmap=custom_cmap2, alpha=0.8)\n", - " plt.plot(X[:, 0][y==0], X[:, 1][y==0], \"yo\", alpha=alpha)\n", - " plt.plot(X[:, 0][y==1], X[:, 1][y==1], \"bs\", alpha=alpha)\n", - " plt.axis(axes)\n", - " plt.xlabel(r\"$x_1$\", fontsize=18)\n", - " plt.ylabel(r\"$x_2$\", fontsize=18, rotation=0)\n", - "plt.figure(figsize=(11,4))\n", - "plt.subplot(121)\n", - "plot_decision_boundary(tree_clf, X, y)\n", - "plt.title(\"Decision Tree\", fontsize=14)\n", - "plt.subplot(122)\n", - "plot_decision_boundary(bag_clf, X, y)\n", - "plt.title(\"Decision Trees with Bagging\", fontsize=14)\n", - "save_fig(\"baggingtree\")\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "### Making your own Bootstrap: Changing the Level of the Decision Tree\n", - "\n", - "Let us bring up our good old boostrap example from the linear regression lectures. We change the linerar regression algorithm with\n", - "a decision tree wth different depths and perform a bootstrap aggregate (in this case we perform as many bootstraps as data points $n$)." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "\n", - "import matplotlib.pyplot as plt\n", - "import numpy as np\n", - "from sklearn.model_selection import train_test_split\n", - "from sklearn.pipeline import make_pipeline\n", - "from sklearn.utils import resample\n", - "from sklearn.tree import DecisionTreeRegressor\n", - "\n", - "n = 100\n", - "n_boostraps = 100\n", - "maxdepth = 8\n", - "\n", - "# Make data set.\n", - "x = np.linspace(-3, 3, n).reshape(-1, 1)\n", - "y = np.exp(-x**2) + 1.5 * np.exp(-(x-2)**2)+ np.random.normal(0, 0.1, x.shape)\n", - "error = np.zeros(maxdepth)\n", - "bias = np.zeros(maxdepth)\n", - "variance = np.zeros(maxdepth)\n", - "polydegree = np.zeros(maxdepth)\n", - "X_train, X_test, y_train, y_test = train_test_split(x, y, test_size=0.2)\n", - "\n", - "from sklearn.preprocessing import StandardScaler\n", - "scaler = StandardScaler()\n", - "scaler.fit(X_train)\n", - "X_train_scaled = scaler.transform(X_train)\n", - "X_test_scaled = scaler.transform(X_test)\n", - "\n", - "# we produce a simple tree first as benchmark\n", - "simpletree = DecisionTreeRegressor(max_depth=3) \n", - "simpletree.fit(X_train_scaled, y_train)\n", - "simpleprediction = simpletree.predict(X_test_scaled)\n", - "for degree in range(1,maxdepth):\n", - " model = DecisionTreeRegressor(max_depth=degree) \n", - " y_pred = np.empty((y_test.shape[0], n_boostraps))\n", - " for i in range(n_boostraps):\n", - " x_, y_ = resample(X_train_scaled, y_train)\n", - " model.fit(x_, y_)\n", - " y_pred[:, i] = model.predict(X_test_scaled)#.ravel()\n", - "\n", - " polydegree[degree] = degree\n", - " error[degree] = np.mean( np.mean((y_test - y_pred)**2, axis=1, keepdims=True) )\n", - " bias[degree] = np.mean( (y_test - np.mean(y_pred, axis=1, keepdims=True))**2 )\n", - " variance[degree] = np.mean( np.var(y_pred, axis=1, keepdims=True) )\n", - " print('Polynomial degree:', degree)\n", - " print('Error:', error[degree])\n", - " print('Bias^2:', bias[degree])\n", - " print('Var:', variance[degree])\n", - " print('{} >= {} + {} = {}'.format(error[degree], bias[degree], variance[degree], bias[degree]+variance[degree]))\n", - " \n", - "mse_simpletree= np.mean( np.mean((y_test - simpleprediction)**2)\n", - "print(mse_simpletree)\n", - "plt.xlim(1,maxdepth)\n", - "plt.plot(polydegree, error, label='MSE')\n", - "plt.plot(polydegree, bias, label='bias')\n", - "plt.plot(polydegree, variance, label='Variance')\n", - "plt.legend()\n", - "save_fig(\"baggingboot\")\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Random forests\n", - "\n", - "Random forests provide an improvement over bagged trees by way of a\n", - "small tweak that decorrelates the trees. \n", - "\n", - "As in bagging, we build a\n", - "number of decision trees on bootstrapped training samples. But when\n", - "building these decision trees, each time a split in a tree is\n", - "considered, a random sample of $m$ predictors is chosen as split\n", - "candidates from the full set of $p$ predictors. The split is allowed to\n", - "use only one of those $m$ predictors. \n", - "\n", - "A fresh sample of $m$ predictors is\n", - "taken at each split, and typically we choose" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "m\\approx \\sqrt{p}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In building a random forest, at\n", - "each split in the tree, the algorithm is not even allowed to consider\n", - "a majority of the available predictors. \n", - "\n", - "The reason for this is rather clever. Suppose that there is one very\n", - "strong predictor in the data set, along with a number of other\n", - "moderately strong predictors. Then in the collection of bagged\n", - "variable importance random forest trees, most or all of the trees will\n", - "use this strong predictor in the top split. Consequently, all of the\n", - "bagged trees will look quite similar to each other. Hence the\n", - "predictions from the bagged trees will be highly correlated.\n", - "Unfortunately, averaging many highly correlated quantities does not\n", - "lead to as large of a reduction in variance as averaging many\n", - "uncorrelated quantities. In particular, this means that bagging will\n", - "not lead to a substantial reduction in variance over a single tree in\n", - "this setting.\n", - "\n", - "\n", - "The algorithm described here can be applied to both classification and regression problems.\n", - "\n", - "We will grow of forest of say $B$ trees.\n", - "1. For $b=1:B$\n", - "\n", - " * Draw a bootstrap sample from the training data organized in our $\\boldsymbol{X}$ matrix.\n", - "\n", - " * We grow then a random forest tree $T_b$ based on the bootstrapped data by repeating the steps outlined till we reach the maximum node size is reached\n", - "\n", - "1. we select $m \\le p$ variables at random from the $p$ predictors/features\n", - "\n", - "2. pick the best split point among the $m$ features using for example the CART algorithm and create a new node\n", - "\n", - "3. split the node into daughter nodes\n", - "\n", - "\n", - "\n", - "4. Output then the ensemble of trees $\\{T_b\\}_1^{B}$ and make predictions for either a regression type of problem or a classification type of problem." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import matplotlib.pyplot as plt\n", - "import numpy as np\n", - "from sklearn.model_selection import train_test_split \n", - "from sklearn.datasets import load_breast_cancer\n", - "from sklearn.svm import SVC\n", - "from sklearn.linear_model import LogisticRegression\n", - "from sklearn.tree import DecisionTreeClassifier\n", - "from sklearn.ensemble import BaggingClassifier\n", - "\n", - "# Load the data\n", - "cancer = load_breast_cancer()\n", - "\n", - "X_train, X_test, y_train, y_test = train_test_split(cancer.data,cancer.target,random_state=0)\n", - "print(X_train.shape)\n", - "print(X_test.shape)\n", - "# Logistic Regression\n", - "logreg = LogisticRegression(solver='lbfgs')\n", - "logreg.fit(X_train, y_train)\n", - "print(\"Test set accuracy with Logistic Regression: {:.2f}\".format(logreg.score(X_test,y_test)))\n", - "# Support vector machine\n", - "svm = SVC(gamma='auto', C=100)\n", - "svm.fit(X_train, y_train)\n", - "print(\"Test set accuracy with SVM: {:.2f}\".format(svm.score(X_test,y_test)))\n", - "# Decision Trees\n", - "deep_tree_clf = DecisionTreeClassifier(max_depth=None)\n", - "deep_tree_clf.fit(X_train, y_train)\n", - "print(\"Test set accuracy with Decision Trees: {:.2f}\".format(deep_tree_clf.score(X_test,y_test)))\n", - "#now scale the data\n", - "from sklearn.preprocessing import StandardScaler\n", - "scaler = StandardScaler()\n", - "scaler.fit(X_train)\n", - "X_train_scaled = scaler.transform(X_train)\n", - "X_test_scaled = scaler.transform(X_test)\n", - "# Logistic Regression\n", - "logreg.fit(X_train_scaled, y_train)\n", - "print(\"Test set accuracy Logistic Regression with scaled data: {:.2f}\".format(logreg.score(X_test_scaled,y_test)))\n", - "# Support Vector Machine\n", - "svm.fit(X_train_scaled, y_train)\n", - "print(\"Test set accuracy SVM with scaled data: {:.2f}\".format(logreg.score(X_test_scaled,y_test)))\n", - "# Decision Trees\n", - "deep_tree_clf.fit(X_train_scaled, y_train)\n", - "print(\"Test set accuracy with Decision Trees and scaled data: {:.2f}\".format(deep_tree_clf.score(X_test_scaled,y_test)))\n", - "\n", - "\n", - "from sklearn.ensemble import RandomForestClassifier\n", - "from sklearn.preprocessing import LabelEncoder\n", - "from sklearn.model_selection import cross_validate\n", - "# Data set not specificied\n", - "#Instantiate the model with 500 trees and entropy as splitting criteria\n", - "Random_Forest_model = RandomForestClassifier(n_estimators=500,criterion=\"entropy\")\n", - "Random_Forest_model.fit(X_train_scaled, y_train)\n", - "#Cross validation\n", - "accuracy = cross_validate(Random_Forest_model,X_test_scaled,y_test,cv=10)['test_score']\n", - "print(accuracy)\n", - "print(\"Test set accuracy with Random Forests and scaled data: {:.2f}\".format(Random_Forest_model.score(X_test_scaled,y_test)))\n", - "\n", - "\n", - "import scikitplot as skplt\n", - "y_pred = Random_Forest_model.predict(X_test_scaled)\n", - "skplt.metrics.plot_confusion_matrix(y_test, y_pred, normalize=True)\n", - "plt.show()\n", - "y_probas = Random_Forest_model.predict_proba(X_test_scaled)\n", - "skplt.metrics.plot_roc(y_test, y_probas)\n", - "plt.show()\n", - "skplt.metrics.plot_cumulative_gain(y_test, y_probas)\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Recall that the cumulative gains curve shows the percentage of the\n", - "overall number of cases in a given category *gained* by targeting a\n", - "percentage of the total number of cases.\n", - "\n", - "Similarly, the receiver operating characteristic curve, or ROC curve,\n", - "displays the diagnostic ability of a binary classifier system as its\n", - "discrimination threshold is varied. It plots the true positive rate against the false positive rate.\n", - "\n", - "\n", - "### Compare Bagging on Trees with Random Forests" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "bag_clf = BaggingClassifier(\n", - " DecisionTreeClassifier(splitter=\"random\", max_leaf_nodes=16, random_state=42),\n", - " n_estimators=500, max_samples=1.0, bootstrap=True, n_jobs=-1, random_state=42)" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "bag_clf.fit(X_train, y_train)\n", - "y_pred = bag_clf.predict(X_test)\n", - "from sklearn.ensemble import RandomForestClassifier\n", - "rnd_clf = RandomForestClassifier(n_estimators=500, max_leaf_nodes=16, n_jobs=-1, random_state=42)\n", - "rnd_clf.fit(X_train, y_train)\n", - "y_pred_rf = rnd_clf.predict(X_test)\n", - "np.sum(y_pred == y_pred_rf) / len(y_pred)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Boosting, a Bird's Eye View\n", - "\n", - "The basic idea is to combine weak classifiers in order to create a good\n", - "classifier. With a weak classifier we often intend a classifier which\n", - "produces results which are only slightly better than we would get by\n", - "random guesses.\n", - "\n", - "This is done by applying in an iterative way a weak (or a standard\n", - "classifier like decision trees) to modify the data. In each iteration\n", - "we emphasize those observations which are misclassified by weighting\n", - "them with a factor.\n", - "\n", - "\n", - "\n", - "Boosting is a way of fitting an additive expansion in a set of\n", - "elementary basis functions like for example some simple polynomials.\n", - "Assume for example that we have a function" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "f_M(x) = \\sum_{i=1}^M \\beta_m b(x;\\gamma_m),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $\\beta_m$ are the expansion parameters to be determined in a\n", - "minimization process and $b(x;\\gamma_m)$ are some simple functions of\n", - "the multivariable parameter $x$ which is characterized by the\n", - "parameters $\\gamma_m$.\n", - "\n", - "As an example, consider the Sigmoid function we used in logistic\n", - "regression. In that case, we can translate the function\n", - "$b(x;\\gamma_m)$ into the Sigmoid function" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\sigma(t) = \\frac{1}{1+\\exp{(-t)}},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $t=\\gamma_0+\\gamma_1 x$ and the parameters $\\gamma_0$ and\n", - "$\\gamma_1$ were determined by the Logistic Regression fitting\n", - "algorithm.\n", - "\n", - "As another example, consider the cost function we defined for linear regression" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(\\boldsymbol{y},\\boldsymbol{f}) = \\frac{1}{n} \\sum_{i=0}^{n-1}(y_i-f(x_i))^2.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In this case the function $f(x)$ was replaced by the design matrix\n", - "$\\boldsymbol{X}$ and the unknown linear regression parameters $\\boldsymbol{\\beta}$,\n", - "that is $\\boldsymbol{f}=\\boldsymbol{X}\\boldsymbol{\\beta}$. In linear regression we can \n", - "simply invert a matrix and obtain the parameters $\\beta$ by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{\\beta}=\\left(\\boldsymbol{X}^T\\boldsymbol{X}\\right)^{-1}\\boldsymbol{X}^T\\boldsymbol{y}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In iterative fitting or additive modeling, we minimize the cost function with respect to the parameters $\\beta_m$ and $\\gamma_m$.\n", - "\n", - "\n", - "### Iterative Fitting, Regression and Squared-error Cost Function\n", - "\n", - "The way we proceed is as follows (here we specialize to the squared-error cost function)\n", - "\n", - "1. Establish a cost function, here $\\cal{C}(\\boldsymbol{y},\\boldsymbol{f}) = \\frac{1}{n} \\sum_{i=0}^{n-1}(y_i-f_M(x_i))^2$ with $f_M(x) = \\sum_{i=1}^M \\beta_m b(x;\\gamma_m)$.\n", - "\n", - "2. Initialize with a guess $f_0(x)$. It could be one or even zero or some random numbers.\n", - "\n", - "3. For $m=1:M$\n", - "\n", - "a. minimize $\\sum_{i=0}^{n-1}(y_i-f_{m-1}(x_i)-\\beta b(x;\\gamma))^2$ wrt $\\gamma$ and $\\beta$\n", - "\n", - "b. This gives the optimal values $\\beta_m$ and $\\gamma_m$\n", - "\n", - "c. Determine then the new values $f_m(x)=f_{m-1}(x) +\\beta_m b(x;\\gamma_m)$\n", - "\n", - "\n", - "We could use any of the algorithms we have discussed till now. If we\n", - "use trees, $\\gamma$ parameterizes the split variables and split points\n", - "at the internal nodes, and the predictions at the terminal nodes.\n", - "\n", - "\n", - "\n", - "To better understand what happens, let us develop the steps for the iterative fitting using the above squared error function.\n", - "\n", - "For simplicity we assume also that our functions $b(x;\\gamma)=1+\\gamma x$. \n", - "\n", - "This means that for every iteration $m$, we need to optimize" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "(\\beta_m,\\gamma_m) = \\mathrm{argmin}_{\\beta,\\lambda}\\hspace{0.1cm} \\sum_{i=0}^{n-1}(y_i-f_{m-1}(x_i)-\\beta b(x;\\gamma))^2=\\sum_{i=0}^{n-1}(y_i-f_{m-1}(x_i)-\\beta(1+\\gamma x_i))^2.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We start our iteration by simply setting $f_0(x)=0$. \n", - "Taking the derivatives with respect to $\\beta$ and $\\gamma$ we obtain" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial \\cal{C}}{\\partial \\beta} = -2\\sum_{i}(1+\\gamma x_i)(y_i-\\beta(1+\\gamma x_i))=0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial \\cal{C}}{\\partial \\gamma} =-2\\sum_{i}\\beta x_i(y_i-\\beta(1+\\gamma x_i))=0.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We can then rewrite these equations as (defining $\\boldsymbol{w}=\\boldsymbol{e}+\\gamma \\boldsymbol{x})$ with $\\boldsymbol{e}$ being the unit vector)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\gamma \\boldsymbol{w}^T(\\boldsymbol{y}-\\beta\\gamma \\boldsymbol{w})=0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which gives us $\\beta = \\boldsymbol{w}^T\\boldsymbol{y}/(\\boldsymbol{w}^T\\boldsymbol{w})$. Similarly we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\beta\\gamma \\boldsymbol{x}^T(\\boldsymbol{y}-\\beta(1+\\gamma \\boldsymbol{x}))=0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which leads to $\\gamma =(\\boldsymbol{x}^T\\boldsymbol{y}-\\beta\\boldsymbol{x}^T\\boldsymbol{e})/(\\beta\\boldsymbol{x}^T\\boldsymbol{x})$. Inserting\n", - "for $\\beta$ gives us an equation for $\\gamma$. This is a non-linear equation in the unknown $\\gamma$ and has to be solved numerically. \n", - "\n", - "The solution to these two equations gives us in turn $\\beta_1$ and $\\gamma_1$ leading to the new expression for $f_1(x)$ as\n", - "$f_1(x) = \\beta_1(1+\\gamma_1x)$. Doing this $M$ times results in our final estimate for the function $f$. \n", - "\n", - "\n", - "\n", - "### Iterative Fitting, Classification and AdaBoost\n", - "\n", - "Let us consider a binary classification problem with two outcomes $y_i \\in \\{-1,1\\}$ and $i=0,1,2,\\dots,n-1$ as our set of\n", - "observations. We define a classification function $G(x)$ which produces a prediction taking one or the other of the two values \n", - "$\\{-1,1\\}$.\n", - "\n", - "The error rate of the training sample is then" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathrm{\\overline{err}}=\\frac{1}{n} \\sum_{i=0}^{n-1} I(y_i\\ne G(x_i)).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The iterative procedure starts with defining a weak classifier whose\n", - "error rate is barely better than random guessing. The iterative\n", - "procedure in boosting is to sequentially apply a weak\n", - "classification algorithm to repeatedly modified versions of the data\n", - "producing a sequence of weak classifiers $G_m(x)$.\n", - "\n", - "Here we will express our function $f(x)$ in terms of $G(x)$. That is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "f_M(x) = \\sum_{i=1}^M \\beta_m b(x;\\gamma_m),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "will be a function of" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "G_M(x) = \\mathrm{sign} \\sum_{i=1}^M \\alpha_m G_m(x).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In our iterative procedure we define thus" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "f_m(x) = f_{m-1}(x)+\\beta_mG_m(x).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The simplest possible cost function which leads (also simple from a computational point of view) to the AdaBoost algorithm is the\n", - "exponential cost/loss function defined as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(\\boldsymbol{y},\\boldsymbol{f}) = \\sum_{i=0}^{n-1}\\exp{(-y_i(f_{m-1}(x_i)+\\beta G(x_i))}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We optimize $\\beta$ and $G$ for each value of $m=1:M$ as we did in the regression case.\n", - "This is normally done in two steps. Let us however first rewrite the cost function as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(\\boldsymbol{y},\\boldsymbol{f}) = \\sum_{i=0}^{n-1}w_i^{m}\\exp{(-y_i\\beta G(x_i))},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where we have defined $w_i^m= \\exp{(-y_if_{m-1}(x_i))}$.\n", - "\n", - "\n", - "\n", - "First, for any $\\beta > 0$, we optimize $G$ by setting" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "G_m(x) = \\mathrm{sign} \\sum_{i=0}^{n-1} w_i^m I(y_i \\ne G_(x_i)),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which is the classifier that minimizes the weighted error rate in predicting $y$.\n", - "\n", - "We can do this by rewriting" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\exp{-(\\beta)}\\sum_{y_i=G(x_i)}w_i^m+\\exp{(\\beta)}\\sum_{y_i\\ne G(x_i)}w_i^m,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which can be rewritten as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "(\\exp{(\\beta)}-\\exp{-(\\beta)})\\sum_{i=0}^{n-1}w_i^mI(y_i\\ne G(x_i))+\\exp{(-\\beta)}\\sum_{i=0}^{n-1}w_i^m=0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which leads to" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\beta_m = \\frac{1}{2}\\log{\\frac{1-\\mathrm{\\overline{err}}}{\\mathrm{\\overline{err}}}},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where we have redefined the error as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathrm{\\overline{err}}_m=\\frac{1}{n}\\frac{\\sum_{i=0}^{n-1}w_i^mI(y_i\\ne G(x_i)}{\\sum_{i=0}^{n-1}w_i^m},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which leads to an update of" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "f_m(x) = f_{m-1}(x) +\\beta_m G_m(x).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "This leads to the new weights" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "w_i^{m+1} = w_i^m \\exp{(-y_i\\beta_m G_m(x_i))}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "### Adaptive boosting: AdaBoost, Basic Algorithm\n", - "\n", - "The algorithm here is rather straightforward. Assume that our weak\n", - "classifier is a decision tree and we consider a binary set of outputs\n", - "with $y_i \\in \\{-1,1\\}$ and $i=0,1,2,\\dots,n-1$ as our set of\n", - "observations. Our design matrix is given in terms of the\n", - "feature/predictor vectors\n", - "$\\boldsymbol{X}=[\\boldsymbol{x}_0\\boldsymbol{x}_1\\dots\\boldsymbol{x}_{p-1}]$. Finally, we define also a\n", - "classifier determined by our data via a function $G(x)$. This function tells us how well we are able to classify our outputs/targets $\\boldsymbol{y}$. \n", - "\n", - "We have already defined the misclassification error $\\mathrm{err}$ as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathrm{err}=\\frac{1}{n}\\sum_{i=0}^{n-1}I(y_i\\ne G(x_i)),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where the function $I()$ is one if we misclassify and zero if we classify correctly. \n", - "\n", - "\n", - "With the above definitions we are now ready to set up the algorithm for AdaBoost.\n", - "The basic idea is to set up weights which will be used to scale the correctly classified and the misclassified cases.\n", - "1. We start by initializing all weights to $w_i = 1/n$, with $i=0,1,2,\\dots n-1$. It is easy to see that we must have $\\sum_{i=0}^{n-1}w_i = 1$.\n", - "\n", - "2. We rewrite the misclassification error as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathrm{\\overline{err}}_m=\\frac{\\sum_{i=0}^{n-1}w_i^m I(y_i\\ne G(x_i))}{\\sum_{i=0}^{n-1}w_i},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "1. Then we start looping over all attempts at classifying, namely we start an iterative process for $m=1:M$, where $M$ is the final number of classifications. Our given classifier could for example be a plain decision tree.\n", - "\n", - "a. Fit then a given classifier to the training set using the weights $w_i$.\n", - "\n", - "b. Compute then $\\mathrm{err}$ and figure out which events are classified properly and which are classified wrongly.\n", - "\n", - "c. Define a quantity $\\alpha_{m} = \\log{(1-\\mathrm{\\overline{err}}_m)/\\mathrm{\\overline{err}}_m}$\n", - "\n", - "d. Set the new weights to $w_i = w_i\\times \\exp{(\\alpha_m I(y_i\\ne G(x_i)}$.\n", - "\n", - "\n", - "5. Compute the new classifier $G(x)= \\sum_{i=0}^{n-1}\\alpha_m I(y_i\\ne G(x_i)$.\n", - "\n", - "For the iterations with $m \\le 2$ the weights are modified\n", - "individually at each steps. The observations which were misclassified\n", - "at iteration $m-1$ have a weight which is larger than those which were\n", - "classified properly. As this proceeds, the observations which were\n", - "difficult to classifiy correctly are given a larger influence. Each\n", - "new classification step $m$ is then forced to concentrate on those\n", - "observations that are missed in the previous iterations.\n", - "\n", - "\n", - "\n", - "\n", - "Using **Scikit-Learn** it is easy to apply the adaptive boosting algorithm, as done here." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "from sklearn.ensemble import AdaBoostClassifier\n", - "\n", - "ada_clf = AdaBoostClassifier(\n", - " DecisionTreeClassifier(max_depth=1), n_estimators=200,\n", - " algorithm=\"SAMME.R\", learning_rate=0.5, random_state=42)\n", - "ada_clf.fit(X_train, y_train)\n", - "\n", - "from sklearn.ensemble import AdaBoostClassifier\n", - "\n", - "ada_clf = AdaBoostClassifier(\n", - " DecisionTreeClassifier(max_depth=1), n_estimators=200,\n", - " algorithm=\"SAMME.R\", learning_rate=0.5, random_state=42)\n", - "ada_clf.fit(X_train_scaled, y_train)\n", - "y_pred = ada_clf.predict(X_test_scaled)\n", - "skplt.metrics.plot_confusion_matrix(y_test, y_pred, normalize=True)\n", - "plt.show()\n", - "y_probas = ada_clf.predict_proba(X_test_scaled)\n", - "skplt.metrics.plot_roc(y_test, y_probas)\n", - "plt.show()\n", - "skplt.metrics.plot_cumulative_gain(y_test, y_probas)\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Gradient boosting: Basics with Steepest Descent/Functional Gradient Descent\n", - "\n", - "Gradient boosting is again a similar technique to Adaptive boosting,\n", - "it combines so-called weak classifiers or regressors into a strong\n", - "method via a series of iterations.\n", - "\n", - "In order to understand the method, let us illustrate its basics by\n", - "bringing back the essential steps in linear regression, where our cost\n", - "function was the least squares function.\n", - "\n", - "\n", - "We start again with our cost function $\\cal{C}(\\boldsymbol{y}m\\boldsymbol{f})=\\sum_{i=0}^{n-1}\\cal{L}(y_i, f(x_i))$ where we want to minimize\n", - "This means that for every iteration, we need to optimize" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "(\\hat{\\boldsymbol{f}}) = \\mathrm{argmin}_{\\boldsymbol{f}}\\hspace{0.1cm} \\sum_{i=0}^{n-1}(y_i-f(x_i))^2.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We define a real function $h_m(x)$ that defines our final function $f_M(x)$ as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "f_M(x) = \\sum_{m=0}^M h_m(x).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In the steepest decent approach we approximate $h_m(x) = -\\rho_m g_m(x)$, where $\\rho_m$ is a scalar and $g_m(x)$ the gradient defined as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "g_m(x_i) = \\left[ \\frac{\\partial \\cal{L}(y_i, f(x_i))}{\\partial f(x_i)}\\right]_{f(x_i)=f_{m-1}(x_i)}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "With the new gradient we can update $f_m(x) = f_{m-1}(x) -\\rho_m g_m(x)$. Using the above squared-error function we see that\n", - "the gradient is $g_m(x_i) = -2(y_i-f(x_i))$.\n", - "\n", - "Choosing $f_0(x)=0$ we obtain $g_m(x) = -2y_i$ and inserting this into the minimization problem for the cost function we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "(\\rho_1) = \\mathrm{argmin}_{\\rho}\\hspace{0.1cm} \\sum_{i=0}^{n-1}(y_i+2\\rho y_i)^2.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Optimizing with respect to $\\rho$ we obtain (taking the derivative) that $\\rho_1 = -1/2$. We have then that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "f_1(x) = f_{0}(x) -\\rho_1 g_1(x)=-y_i.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We can then proceed and compute" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "g_2(x_i) = \\left[ \\frac{\\partial \\cal{L}(y_i, f(x_i))}{\\partial f(x_i)}\\right]_{f(x_i)=f_{1}(x_i)=y_i}=-4y_i,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and find a new value for $\\rho_2=-1/2$ and continue till we have reached $m=M$. We can modify the steepest descent method, or steepest boosting, by introducing what is called **gradient boosting**. \n", - "\n", - "\n", - "Steepest descent is however not much used, since it only optimizes $f$ at a fixed set of $n$ points,\n", - "so we do not learn a function that can generalize. However, we can modify the algorithm by\n", - "fitting a weak learner to approximate the negative gradient signal. \n", - "\n", - "Suppose we have a cost function $C(f)=\\sum_{i=0}^{n-1}L(y_i, f(x_i))$ where $y_i$ is our target and $f(x_i)$ the function which is meant to model $y_i$. The above cost function could be our standard squared-error function" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(\\boldsymbol{y},\\boldsymbol{f})=\\sum_{i=0}^{n-1}(y_i-f(x_i))^2.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The way we proceed in an iterative fashion is to\n", - "1. Initialize our estimate $f_0(x)$.\n", - "\n", - "2. For $m=1:M$, we\n", - "\n", - "a. compute the negative gradient vector $\\boldsymbol{u}_m = -\\partial C(\\boldsymbol{y},\\boldsymbol{f})/\\partial \\boldsymbol{f}(x)$ at $f(x) = f_{m-1}(x)$;\n", - "\n", - "b. fit the so-called base-learner to the negative gradient $h_m(u_m,x)$;\n", - "\n", - "c. update the estimate $f_m(x) = f_{m-1}(x)+h_m(u_m,x)$;\n", - "\n", - "\n", - "4. The final estimate is then $f_M(x) = \\sum_{m=1}^M h_m(u_m,x)$.\n", - "\n", - "## Gradient Boosting, Examples of Regression" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import matplotlib.pyplot as plt\n", - "import numpy as np\n", - "from sklearn.model_selection import train_test_split\n", - "from sklearn.ensemble import GradientBoostingRegressor\n", - "from sklearn.preprocessing import StandardScaler\n", - "import scikitplot as skplt\n", - "from sklearn.metrics import mean_squared_error\n", - "\n", - "n = 100\n", - "maxdegree = 6\n", - "\n", - "# Make data set.\n", - "x = np.linspace(-3, 3, n).reshape(-1, 1)\n", - "y = np.exp(-x**2) + 1.5 * np.exp(-(x-2)**2)+ np.random.normal(0, 0.1, x.shape)\n", - "\n", - "error = np.zeros(maxdegree)\n", - "bias = np.zeros(maxdegree)\n", - "variance = np.zeros(maxdegree)\n", - "polydegree = np.zeros(maxdegree)\n", - "X_train, X_test, y_train, y_test = train_test_split(x, y, test_size=0.2)\n", - "scaler = StandardScaler()\n", - "scaler.fit(X_train)\n", - "X_train_scaled = scaler.transform(X_train)\n", - "X_test_scaled = scaler.transform(X_test)\n", - "\n", - "for degree in range(1,maxdegree):\n", - " model = GradientBoostingRegressor(max_depth=degree, n_estimators=100, learning_rate=1.0) \n", - " model.fit(X_train_scaled,y_train)\n", - " y_pred = model.predict(X_test_scaled)\n", - " polydegree[degree] = degree\n", - " error[degree] = np.mean( np.mean((y_test - y_pred)**2) )\n", - " bias[degree] = np.mean( (y_test - np.mean(y_pred))**2 )\n", - " variance[degree] = np.mean( np.var(y_pred) )\n", - " print('Max depth:', degree)\n", - " print('Error:', error[degree])\n", - " print('Bias^2:', bias[degree])\n", - " print('Var:', variance[degree])\n", - " print('{} >= {} + {} = {}'.format(error[degree], bias[degree], variance[degree], bias[degree]+variance[degree]))\n", - "\n", - "plt.xlim(1,maxdegree-1)\n", - "plt.plot(polydegree, error, label='Error')\n", - "plt.plot(polydegree, bias, label='bias')\n", - "plt.plot(polydegree, variance, label='Variance')\n", - "plt.legend()\n", - "save_fig(\"gdregression\")\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Gradient Boosting, Classification Example" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import matplotlib.pyplot as plt\n", - "import numpy as np\n", - "from sklearn.model_selection import train_test_split \n", - "from sklearn.datasets import load_breast_cancer\n", - "import scikitplot as skplt\n", - "from sklearn.ensemble import GradientBoostingClassifier\n", - "from sklearn.model_selection import cross_validate\n", - "\n", - "# Load the data\n", - "cancer = load_breast_cancer()\n", - "\n", - "X_train, X_test, y_train, y_test = train_test_split(cancer.data,cancer.target,random_state=0)\n", - "print(X_train.shape)\n", - "print(X_test.shape)\n", - "#now scale the data\n", - "from sklearn.preprocessing import StandardScaler\n", - "scaler = StandardScaler()\n", - "scaler.fit(X_train)\n", - "X_train_scaled = scaler.transform(X_train)\n", - "X_test_scaled = scaler.transform(X_test)\n", - "\n", - "gd_clf = GradientBoostingClassifier(max_depth=3, n_estimators=100, learning_rate=1.0) \n", - "gd_clf.fit(X_train_scaled, y_train)\n", - "#Cross validation\n", - "accuracy = cross_validate(gd_clf,X_test_scaled,y_test,cv=10)['test_score']\n", - "print(accuracy)\n", - "print(\"Test set accuracy with Random Forests and scaled data: {:.2f}\".format(gd_clf.score(X_test_scaled,y_test)))\n", - "\n", - "import scikitplot as skplt\n", - "y_pred = gd_clf.predict(X_test_scaled)\n", - "skplt.metrics.plot_confusion_matrix(y_test, y_pred, normalize=True)\n", - "save_fig(\"gdclassiffierconfusion\")\n", - "plt.show()\n", - "y_probas = gd_clf.predict_proba(X_test_scaled)\n", - "skplt.metrics.plot_roc(y_test, y_probas)\n", - "save_fig(\"gdclassiffierroc\")\n", - "plt.show()\n", - "skplt.metrics.plot_cumulative_gain(y_test, y_probas)\n", - "save_fig(\"gdclassiffiercgain\")\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## XGBoost: Extreme Gradient Boosting\n", - "\n", - "\n", - "[XGBoost](https://github.com/dmlc/xgboost) or Extreme Gradient\n", - "Boosting, is an optimized distributed gradient boosting library\n", - "designed to be highly efficient, flexible and portable. It implements\n", - "machine learning algorithms under the Gradient Boosting\n", - "framework. XGBoost provides a parallel tree boosting that solve many\n", - "data science problems in a fast and accurate way. See the [article by Chen and Guestrin](https://arxiv.org/abs/1603.02754).\n", - "\n", - "The authors design and build a highly scalable end-to-end tree\n", - "boosting system. It has a theoretically justified weighted quantile\n", - "sketch for efficient proposal calculation. It introduces a novel sparsity-aware algorithm for parallel tree learning and an effective cache-aware block structure for out-of-core tree learning.\n", - "\n", - "It is now the algorithm which wins essentially all ML competitions!!!\n", - "\n", - "## Regression Case" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import matplotlib.pyplot as plt\n", - "import numpy as np\n", - "from sklearn.model_selection import train_test_split\n", - "import xgboost as xgb\n", - "from sklearn.preprocessing import StandardScaler\n", - "import scikitplot as skplt\n", - "from sklearn.metrics import mean_squared_error\n", - "\n", - "n = 100\n", - "maxdegree = 6\n", - "\n", - "# Make data set.\n", - "x = np.linspace(-3, 3, n).reshape(-1, 1)\n", - "y = np.exp(-x**2) + 1.5 * np.exp(-(x-2)**2)+ np.random.normal(0, 0.1, x.shape)\n", - "\n", - "error = np.zeros(maxdegree)\n", - "bias = np.zeros(maxdegree)\n", - "variance = np.zeros(maxdegree)\n", - "polydegree = np.zeros(maxdegree)\n", - "X_train, X_test, y_train, y_test = train_test_split(x, y, test_size=0.2)\n", - "scaler = StandardScaler()\n", - "scaler.fit(X_train)\n", - "X_train_scaled = scaler.transform(X_train)\n", - "X_test_scaled = scaler.transform(X_test)\n", - "\n", - "for degree in range(maxdegree):\n", - " model = xgb.XGBRegressor(objective ='reg:squarederror', colsaobjective ='reg:squarederror', colsample_bytree = 0.3, learning_rate = 0.1,max_depth = degree, alpha = 10, n_estimators = 200)\n", - "\n", - " model.fit(X_train_scaled,y_train)\n", - " y_pred = model.predict(X_test_scaled)\n", - " polydegree[degree] = degree\n", - " error[degree] = np.mean( np.mean((y_test - y_pred)**2) )\n", - " bias[degree] = np.mean( (y_test - np.mean(y_pred))**2 )\n", - " variance[degree] = np.mean( np.var(y_pred) )\n", - " print('Max depth:', degree)\n", - " print('Error:', error[degree])\n", - " print('Bias^2:', bias[degree])\n", - " print('Var:', variance[degree])\n", - " print('{} >= {} + {} = {}'.format(error[degree], bias[degree], variance[degree], bias[degree]+variance[degree]))\n", - "\n", - "plt.xlim(1,maxdegree-1)\n", - "plt.plot(polydegree, error, label='Error')\n", - "plt.plot(polydegree, bias, label='bias')\n", - "plt.plot(polydegree, variance, label='Variance')\n", - "plt.legend()\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "As you will see from the confusion matrix below, XGBoots does an excellent job on the Wisconsin cancer data and outperforms essentially all agorithms we have discussed till now." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "\n", - "import matplotlib.pyplot as plt\n", - "import numpy as np\n", - "from sklearn.model_selection import train_test_split \n", - "from sklearn.datasets import load_breast_cancer\n", - "from sklearn.preprocessing import LabelEncoder\n", - "from sklearn.model_selection import cross_validate\n", - "import scikitplot as skplt\n", - "import xgboost as xgb\n", - "# Load the data\n", - "cancer = load_breast_cancer()\n", - "\n", - "X_train, X_test, y_train, y_test = train_test_split(cancer.data,cancer.target,random_state=0)\n", - "print(X_train.shape)\n", - "print(X_test.shape)\n", - "#now scale the data\n", - "from sklearn.preprocessing import StandardScaler\n", - "scaler = StandardScaler()\n", - "scaler.fit(X_train)\n", - "X_train_scaled = scaler.transform(X_train)\n", - "X_test_scaled = scaler.transform(X_test)\n", - "\n", - "xg_clf = xgb.XGBClassifier()\n", - "xg_clf.fit(X_train_scaled,y_train)\n", - "\n", - "y_test = xg_clf.predict(X_test_scaled)\n", - "\n", - "print(\"Test set accuracy with Random Forests and scaled data: {:.2f}\".format(xg_clf.score(X_test_scaled,y_test)))\n", - "\n", - "import scikitplot as skplt\n", - "y_pred = xg_clf.predict(X_test_scaled)\n", - "skplt.metrics.plot_confusion_matrix(y_test, y_pred, normalize=True)\n", - "save_fig(\"xdclassiffierconfusion\")\n", - "plt.show()\n", - "y_probas = xg_clf.predict_proba(X_test_scaled)\n", - "skplt.metrics.plot_roc(y_test, y_probas)\n", - "save_fig(\"xdclassiffierroc\")\n", - "plt.show()\n", - "skplt.metrics.plot_cumulative_gain(y_test, y_probas)\n", - "save_fig(\"gdclassiffiercgain\")\n", - "plt.show()\n", - "\n", - "\n", - "xgb.plot_tree(xg_clf,num_trees=0)\n", - "plt.rcParams['figure.figsize'] = [50, 10]\n", - "save_fig(\"xgtree\")\n", - "plt.show()\n", - "\n", - "xgb.plot_importance(xg_clf)\n", - "plt.rcParams['figure.figsize'] = [5, 5]\n", - "save_fig(\"xgparams\")\n", - "plt.show()" - ] - } - ], - "metadata": {}, - "nbformat": 4, - "nbformat_minor": 4 -} diff --git a/doc/LectureNotes/_build/html/_sources/chapter8.ipynb b/doc/LectureNotes/_build/html/_sources/chapter8.ipynb deleted file mode 100644 index 1ee4dd6cd..000000000 --- a/doc/LectureNotes/_build/html/_sources/chapter8.ipynb +++ /dev/null @@ -1,1359 +0,0 @@ -{ - "cells": [ - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "# Basic ideas of the Principal Component Analysis (PCA)\n", - "\n", - "The principal component analysis deals with the problem of fitting a\n", - "low-dimensional affine subspace $S$ of dimension $d$ much smaller than\n", - "the total dimension $D$ of the problem at hand (our data\n", - "set). Mathematically it can be formulated as a statistical problem or\n", - "a geometric problem. In our discussion of the theorem for the\n", - "classical PCA, we will stay with a statistical approach. \n", - "Historically, the PCA was first formulated in a statistical setting in order to estimate the principal component of a multivariate random variable.\n", - "\n", - "We have a data set defined by a design/feature matrix $\\boldsymbol{X}$ (see below for its definition) \n", - "* Each data point is determined by $p$ extrinsic (measurement) variables\n", - "\n", - "* We may want to ask the following question: Are there fewer intrinsic variables (say $d << p$) that still approximately describe the data?\n", - "\n", - "* If so, these intrinsic variables may tell us something important and finding these intrinsic variables is what dimension reduction methods do. \n", - "\n", - "A good read is for example [Vidal, Ma and Sastry](https://www.springer.com/gp/book/9780387878102).\n", - "\n", - "\n", - "\n", - "## Introducing the Covariance and Correlation functions\n", - "\n", - "Before we discuss the PCA theorem, we need to remind ourselves about\n", - "the definition of the covariance and the correlation function. These are quantities \n", - "\n", - "Suppose we have defined two vectors\n", - "$\\hat{x}$ and $\\hat{y}$ with $n$ elements each. The covariance matrix $\\boldsymbol{C}$ is defined as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{C}[\\boldsymbol{x},\\boldsymbol{y}] = \\begin{bmatrix} \\mathrm{cov}[\\boldsymbol{x},\\boldsymbol{x}] & \\mathrm{cov}[\\boldsymbol{x},\\boldsymbol{y}] \\\\\n", - " \\mathrm{cov}[\\boldsymbol{y},\\boldsymbol{x}] & \\mathrm{cov}[\\boldsymbol{y},\\boldsymbol{y}] \\\\\n", - " \\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where for example" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathrm{cov}[\\boldsymbol{x},\\boldsymbol{y}] =\\frac{1}{n} \\sum_{i=0}^{n-1}(x_i- \\overline{x})(y_i- \\overline{y}).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "With this definition and recalling that the variance is defined as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathrm{var}[\\boldsymbol{x}]=\\frac{1}{n} \\sum_{i=0}^{n-1}(x_i- \\overline{x})^2,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "we can rewrite the covariance matrix as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{C}[\\boldsymbol{x},\\boldsymbol{y}] = \\begin{bmatrix} \\mathrm{var}[\\boldsymbol{x}] & \\mathrm{cov}[\\boldsymbol{x},\\boldsymbol{y}] \\\\\n", - " \\mathrm{cov}[\\boldsymbol{x},\\boldsymbol{y}] & \\mathrm{var}[\\boldsymbol{y}] \\\\\n", - " \\end{bmatrix}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The covariance takes values between zero and infinity and may thus\n", - "lead to problems with loss of numerical precision for particularly\n", - "large values. It is common to scale the covariance matrix by\n", - "introducing instead the correlation matrix defined via the so-called\n", - "correlation function" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathrm{corr}[\\boldsymbol{x},\\boldsymbol{y}]=\\frac{\\mathrm{cov}[\\boldsymbol{x},\\boldsymbol{y}]}{\\sqrt{\\mathrm{var}[\\boldsymbol{x}] \\mathrm{var}[\\boldsymbol{y}]}}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The correlation function is then given by values $\\mathrm{corr}[\\boldsymbol{x},\\boldsymbol{y}]\n", - "\\in [-1,1]$. This avoids eventual problems with too large values. We\n", - "can then define the correlation matrix for the two vectors $\\boldsymbol{x}$\n", - "and $\\boldsymbol{y}$ as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{K}[\\boldsymbol{x},\\boldsymbol{y}] = \\begin{bmatrix} 1 & \\mathrm{corr}[\\boldsymbol{x},\\boldsymbol{y}] \\\\\n", - " \\mathrm{corr}[\\boldsymbol{y},\\boldsymbol{x}] & 1 \\\\\n", - " \\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In the above example this is the function we constructed using **pandas**.\n", - "\n", - "\n", - "In our derivation of the various regression algorithms like **Ordinary Least Squares** or **Ridge regression**\n", - "we defined the design/feature matrix $\\boldsymbol{X}$ as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}=\\begin{bmatrix}\n", - "x_{0,0} & x_{0,1} & x_{0,2}& \\dots & \\dots x_{0,p-1}\\\\\n", - "x_{1,0} & x_{1,1} & x_{1,2}& \\dots & \\dots x_{1,p-1}\\\\\n", - "x_{2,0} & x_{2,1} & x_{2,2}& \\dots & \\dots x_{2,p-1}\\\\\n", - "\\dots & \\dots & \\dots & \\dots \\dots & \\dots \\\\\n", - "x_{n-2,0} & x_{n-2,1} & x_{n-2,2}& \\dots & \\dots x_{n-2,p-1}\\\\\n", - "x_{n-1,0} & x_{n-1,1} & x_{n-1,2}& \\dots & \\dots x_{n-1,p-1}\\\\\n", - "\\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with $\\boldsymbol{X}\\in {\\mathbb{R}}^{n\\times p}$, with the predictors/features $p$ refering to the column numbers and the\n", - "entries $n$ being the row elements.\n", - "We can rewrite the design/feature matrix in terms of its column vectors as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}=\\begin{bmatrix} \\boldsymbol{x}_0 & \\boldsymbol{x}_1 & \\boldsymbol{x}_2 & \\dots & \\dots & \\boldsymbol{x}_{p-1}\\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with a given vector" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{x}_i^T = \\begin{bmatrix}x_{0,i} & x_{1,i} & x_{2,i}& \\dots & \\dots x_{n-1,i}\\end{bmatrix}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "With these definitions, we can now rewrite our $2\\times 2$\n", - "correaltion/covariance matrix in terms of a moe general design/feature\n", - "matrix $\\boldsymbol{X}\\in {\\mathbb{R}}^{n\\times p}$. This leads to a $p\\times p$\n", - "covariance matrix for the vectors $\\boldsymbol{x}_i$ with $i=0,1,\\dots,p-1$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{C}[\\boldsymbol{x}] = \\begin{bmatrix}\n", - "\\mathrm{var}[\\boldsymbol{x}_0] & \\mathrm{cov}[\\boldsymbol{x}_0,\\boldsymbol{x}_1] & \\mathrm{cov}[\\boldsymbol{x}_0,\\boldsymbol{x}_2] & \\dots & \\dots & \\mathrm{cov}[\\boldsymbol{x}_0,\\boldsymbol{x}_{p-1}]\\\\\n", - "\\mathrm{cov}[\\boldsymbol{x}_1,\\boldsymbol{x}_0] & \\mathrm{var}[\\boldsymbol{x}_1] & \\mathrm{cov}[\\boldsymbol{x}_1,\\boldsymbol{x}_2] & \\dots & \\dots & \\mathrm{cov}[\\boldsymbol{x}_1,\\boldsymbol{x}_{p-1}]\\\\\n", - "\\mathrm{cov}[\\boldsymbol{x}_2,\\boldsymbol{x}_0] & \\mathrm{cov}[\\boldsymbol{x}_2,\\boldsymbol{x}_1] & \\mathrm{var}[\\boldsymbol{x}_2] & \\dots & \\dots & \\mathrm{cov}[\\boldsymbol{x}_2,\\boldsymbol{x}_{p-1}]\\\\\n", - "\\dots & \\dots & \\dots & \\dots & \\dots & \\dots \\\\\n", - "\\dots & \\dots & \\dots & \\dots & \\dots & \\dots \\\\\n", - "\\mathrm{cov}[\\boldsymbol{x}_{p-1},\\boldsymbol{x}_0] & \\mathrm{cov}[\\boldsymbol{x}_{p-1},\\boldsymbol{x}_1] & \\mathrm{cov}[\\boldsymbol{x}_{p-1},\\boldsymbol{x}_{2}] & \\dots & \\dots & \\mathrm{var}[\\boldsymbol{x}_{p-1}]\\\\\n", - "\\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and the correlation matrix" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{K}[\\boldsymbol{x}] = \\begin{bmatrix}\n", - "1 & \\mathrm{corr}[\\boldsymbol{x}_0,\\boldsymbol{x}_1] & \\mathrm{corr}[\\boldsymbol{x}_0,\\boldsymbol{x}_2] & \\dots & \\dots & \\mathrm{corr}[\\boldsymbol{x}_0,\\boldsymbol{x}_{p-1}]\\\\\n", - "\\mathrm{corr}[\\boldsymbol{x}_1,\\boldsymbol{x}_0] & 1 & \\mathrm{corr}[\\boldsymbol{x}_1,\\boldsymbol{x}_2] & \\dots & \\dots & \\mathrm{corr}[\\boldsymbol{x}_1,\\boldsymbol{x}_{p-1}]\\\\\n", - "\\mathrm{corr}[\\boldsymbol{x}_2,\\boldsymbol{x}_0] & \\mathrm{corr}[\\boldsymbol{x}_2,\\boldsymbol{x}_1] & 1 & \\dots & \\dots & \\mathrm{corr}[\\boldsymbol{x}_2,\\boldsymbol{x}_{p-1}]\\\\\n", - "\\dots & \\dots & \\dots & \\dots & \\dots & \\dots \\\\\n", - "\\dots & \\dots & \\dots & \\dots & \\dots & \\dots \\\\\n", - "\\mathrm{corr}[\\boldsymbol{x}_{p-1},\\boldsymbol{x}_0] & \\mathrm{corr}[\\boldsymbol{x}_{p-1},\\boldsymbol{x}_1] & \\mathrm{corr}[\\boldsymbol{x}_{p-1},\\boldsymbol{x}_{2}] & \\dots & \\dots & 1\\\\\n", - "\\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The Numpy function **np.cov** calculates the covariance elements using\n", - "the factor $1/(n-1)$ instead of $1/n$ since it assumes we do not have\n", - "the exact mean values. The following simple function uses the\n", - "**np.vstack** function which takes each vector of dimension $1\\times n$\n", - "and produces a $2\\times n$ matrix $\\boldsymbol{W}$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{W} = \\begin{bmatrix} x_0 & y_0 \\\\\n", - " x_1 & y_1 \\\\\n", - " x_2 & y_2\\\\\n", - " \\dots & \\dots \\\\\n", - " x_{n-2} & y_{n-2}\\\\\n", - " x_{n-1} & y_{n-1} & \n", - " \\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which in turn is converted into into the $2\\times 2$ covariance matrix\n", - "$\\boldsymbol{C}$ via the Numpy function **np.cov()**. We note that we can also calculate\n", - "the mean value of each set of samples $\\boldsymbol{x}$ etc using the Numpy\n", - "function **np.mean(x)**. We can also extract the eigenvalues of the\n", - "covariance matrix through the **np.linalg.eig()** function." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "# Importing various packages\n", - "import numpy as np\n", - "n = 100\n", - "x = np.random.normal(size=n)\n", - "print(np.mean(x))\n", - "y = 4+3*x+np.random.normal(size=n)\n", - "print(np.mean(y))\n", - "W = np.vstack((x, y))\n", - "C = np.cov(W)\n", - "print(C)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Correlation Matrix\n", - "\n", - "The previous example can be converted into the correlation matrix by\n", - "simply scaling the matrix elements with the variances. We should also\n", - "subtract the mean values for each column. This leads to the following\n", - "code which sets up the correlations matrix for the previous example in\n", - "a more brute force way. Here we scale the mean values for each column of the design matrix, calculate the relevant mean values and variances and then finally set up the $2\\times 2$ correlation matrix (since we have only two vectors)." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import numpy as np\n", - "n = 100\n", - "# define two vectors \n", - "x = np.random.random(size=n)\n", - "y = 4+3*x+np.random.normal(size=n)\n", - "#scaling the x and y vectors \n", - "x = x - np.mean(x)\n", - "y = y - np.mean(y)\n", - "variance_x = np.sum(x@x)/n\n", - "variance_y = np.sum(y@y)/n\n", - "print(variance_x)\n", - "print(variance_y)\n", - "cov_xy = np.sum(x@y)/n\n", - "cov_xx = np.sum(x@x)/n\n", - "cov_yy = np.sum(y@y)/n\n", - "C = np.zeros((2,2))\n", - "C[0,0]= cov_xx/variance_x\n", - "C[1,1]= cov_yy/variance_y\n", - "C[0,1]= cov_xy/np.sqrt(variance_y*variance_x)\n", - "C[1,0]= C[0,1]\n", - "print(C)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We see that the matrix elements along the diagonal are one as they\n", - "should be and that the matrix is symmetric. Furthermore, diagonalizing\n", - "this matrix we easily see that it is a positive definite matrix.\n", - "\n", - "The above procedure with **numpy** can be made more compact if we use **pandas**.\n", - "\n", - "\n", - "We whow here how we can set up the correlation matrix using **pandas**, as done in this simple code" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import numpy as np\n", - "import pandas as pd\n", - "n = 10\n", - "x = np.random.normal(size=n)\n", - "x = x - np.mean(x)\n", - "y = 4+3*x+np.random.normal(size=n)\n", - "y = y - np.mean(y)\n", - "X = (np.vstack((x, y))).T\n", - "print(X)\n", - "Xpd = pd.DataFrame(X)\n", - "print(Xpd)\n", - "correlation_matrix = Xpd.corr()\n", - "print(correlation_matrix)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We expand this model to the Franke function discussed above." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "# Common imports\n", - "import numpy as np\n", - "import pandas as pd\n", - "\n", - "\n", - "def FrankeFunction(x,y):\n", - "\tterm1 = 0.75*np.exp(-(0.25*(9*x-2)**2) - 0.25*((9*y-2)**2))\n", - "\tterm2 = 0.75*np.exp(-((9*x+1)**2)/49.0 - 0.1*(9*y+1))\n", - "\tterm3 = 0.5*np.exp(-(9*x-7)**2/4.0 - 0.25*((9*y-3)**2))\n", - "\tterm4 = -0.2*np.exp(-(9*x-4)**2 - (9*y-7)**2)\n", - "\treturn term1 + term2 + term3 + term4\n", - "\n", - "\n", - "def create_X(x, y, n ):\n", - "\tif len(x.shape) > 1:\n", - "\t\tx = np.ravel(x)\n", - "\t\ty = np.ravel(y)\n", - "\n", - "\tN = len(x)\n", - "\tl = int((n+1)*(n+2)/2)\t\t# Number of elements in beta\n", - "\tX = np.ones((N,l))\n", - "\n", - "\tfor i in range(1,n+1):\n", - "\t\tq = int((i)*(i+1)/2)\n", - "\t\tfor k in range(i+1):\n", - "\t\t\tX[:,q+k] = (x**(i-k))*(y**k)\n", - "\n", - "\treturn X\n", - "\n", - "\n", - "# Making meshgrid of datapoints and compute Franke's function\n", - "n = 4\n", - "N = 100\n", - "x = np.sort(np.random.uniform(0, 1, N))\n", - "y = np.sort(np.random.uniform(0, 1, N))\n", - "z = FrankeFunction(x, y)\n", - "X = create_X(x, y, n=n) \n", - "\n", - "Xpd = pd.DataFrame(X)\n", - "# subtract the mean values and set up the covariance matrix\n", - "Xpd = Xpd - Xpd.mean()\n", - "covariance_matrix = Xpd.cov()\n", - "print(covariance_matrix)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We note here that the covariance is zero for the first rows and\n", - "columns since all matrix elements in the design matrix were set to one\n", - "(we are fitting the function in terms of a polynomial of degree $n$). We would however not include the intercept\n", - "and wee can simply\n", - "drop these elements and construct a correlation\n", - "matrix without them. \n", - "\n", - "\n", - "\n", - "We can rewrite the covariance matrix in a more compact form in terms of the design/feature matrix $\\boldsymbol{X}$ as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{C}[\\boldsymbol{x}] = \\frac{1}{n}\\boldsymbol{X}^T\\boldsymbol{X}= \\mathbb{E}[\\boldsymbol{X}^T\\boldsymbol{X}].\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "To see this let us simply look at a design matrix $\\boldsymbol{X}\\in {\\mathbb{R}}^{2\\times 2}$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}=\\begin{bmatrix}\n", - "x_{00} & x_{01}\\\\\n", - "x_{10} & x_{11}\\\\\n", - "\\end{bmatrix}=\\begin{bmatrix}\n", - "\\boldsymbol{x}_{0} & \\boldsymbol{x}_{1}\\\\\n", - "\\end{bmatrix}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "If we then compute the expectation value" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbb{E}[\\boldsymbol{X}^T\\boldsymbol{X}] = \\frac{1}{n}\\boldsymbol{X}^T\\boldsymbol{X}=\\begin{bmatrix}\n", - "x_{00}^2+x_{01}^2 & x_{00}x_{10}+x_{01}x_{11}\\\\\n", - "x_{10}x_{00}+x_{11}x_{01} & x_{10}^2+x_{11}^2\\\\\n", - "\\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which is just" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{C}[\\boldsymbol{x}_0,\\boldsymbol{x}_1] = \\boldsymbol{C}[\\boldsymbol{x}]=\\begin{bmatrix} \\mathrm{var}[\\boldsymbol{x}_0] & \\mathrm{cov}[\\boldsymbol{x}_0,\\boldsymbol{x}_1] \\\\\n", - " \\mathrm{cov}[\\boldsymbol{x}_1,\\boldsymbol{x}_0] & \\mathrm{var}[\\boldsymbol{x}_1] \\\\\n", - " \\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where we wrote $$\\boldsymbol{C}[\\boldsymbol{x}_0,\\boldsymbol{x}_1] = \\boldsymbol{C}[\\boldsymbol{x}]$$ to indicate that this the covariance of the vectors $\\boldsymbol{x}$ of the design/feature matrix $\\boldsymbol{X}$.\n", - "\n", - "It is easy to generalize this to a matrix $\\boldsymbol{X}\\in {\\mathbb{R}}^{n\\times p}$.\n", - "\n", - "\n", - "\n", - "## Towards the PCA theorem\n", - "\n", - "We have that the covariance matrix (the correlation matrix involves a simple rescaling) is given as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{C}[\\boldsymbol{x}] = \\frac{1}{n}\\boldsymbol{X}^T\\boldsymbol{X}= \\mathbb{E}[\\boldsymbol{X}^T\\boldsymbol{X}].\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Let us now assume that we can perform a series of orthogonal transformations where we employ some orthogonal matrices $\\boldsymbol{S}$.\n", - "These matrices are defined as $\\boldsymbol{S}\\in {\\mathbb{R}}^{p\\times p}$ and obey the orthogonality requirements $\\boldsymbol{S}\\boldsymbol{S}^T=\\boldsymbol{S}^T\\boldsymbol{S}=\\boldsymbol{I}$. The matrix can be written out in terms of the column vectors $\\boldsymbol{s}_i$ as $\\boldsymbol{S}=[\\boldsymbol{s}_0,\\boldsymbol{s}_1,\\dots,\\boldsymbol{s}_{p-1}]$ and $\\boldsymbol{s}_i \\in {\\mathbb{R}}^{p}$.\n", - "\n", - "Assume also that there is a transformation $\\boldsymbol{S}^T\\boldsymbol{C}[\\boldsymbol{x}]\\boldsymbol{S}=\\boldsymbol{C}[\\boldsymbol{y}]$ such that the new matrix $\\boldsymbol{C}[\\boldsymbol{y}]$ is diagonal with elements $[\\lambda_0,\\lambda_1,\\lambda_2,\\dots,\\lambda_{p-1}]$. \n", - "\n", - "That is we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{C}[\\boldsymbol{y}] = \\mathbb{E}[\\boldsymbol{S}^T\\boldsymbol{X}^T\\boldsymbol{X}T\\boldsymbol{S}]=\\boldsymbol{S}^T\\boldsymbol{C}[\\boldsymbol{x}]\\boldsymbol{S},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "since the matrix $\\boldsymbol{S}$ is not a data dependent matrix. Multiplying with $\\boldsymbol{S}$ from the left we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{S}\\boldsymbol{C}[\\boldsymbol{y}] = \\boldsymbol{C}[\\boldsymbol{x}]\\boldsymbol{S},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and since $\\boldsymbol{C}[\\boldsymbol{y}]$ is diagonal we have for a given eigenvalue $i$ of the covariance matrix that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{S}_i\\lambda_i = \\boldsymbol{C}[\\boldsymbol{x}]\\boldsymbol{S}_i.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In the derivation of the PCA theorem we will assume that the eigenvalues are ordered in descending order, that is\n", - "$\\lambda_0 > \\lambda_1 > \\dots > \\lambda_{p-1}$. \n", - "\n", - "\n", - "The eigenvalues tell us then how much we need to stretch the\n", - "corresponding eigenvectors. Dimensions with large eigenvalues have\n", - "thus large variations (large variance) and define therefore useful\n", - "dimensions. The data points are more spread out in the direction of\n", - "these eigenvectors. Smaller eigenvalues mean on the other hand that\n", - "the corresponding eigenvectors are shrunk accordingly and the data\n", - "points are tightly bunched together and there is not much variation in\n", - "these specific directions. Hopefully then we could leave it out\n", - "dimensions where the eigenvalues are very small. If $p$ is very large,\n", - "we could then aim at reducing $p$ to $l << p$ and handle only $l$\n", - "features/predictors.\n", - "\n", - "### The Algorithm before theorem\n", - "\n", - "Here's how we would proceed in setting up the algorithm for the PCA, see also discussion below here. \n", - "* Set up the datapoints for the design/feature matrix $\\boldsymbol{X}$ with $\\boldsymbol{X}\\in {\\mathbb{R}}^{n\\times p}$, with the predictors/features $p$ referring to the column numbers and the entries $n$ being the row elements." - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}=\\begin{bmatrix}\n", - "x_{0,0} & x_{0,1} & x_{0,2}& \\dots & \\dots x_{0,p-1}\\\\\n", - "x_{1,0} & x_{1,1} & x_{1,2}& \\dots & \\dots x_{1,p-1}\\\\\n", - "x_{2,0} & x_{2,1} & x_{2,2}& \\dots & \\dots x_{2,p-1}\\\\\n", - "\\dots & \\dots & \\dots & \\dots \\dots & \\dots \\\\\n", - "x_{n-2,0} & x_{n-2,1} & x_{n-2,2}& \\dots & \\dots x_{n-2,p-1}\\\\\n", - "x_{n-1,0} & x_{n-1,1} & x_{n-1,2}& \\dots & \\dots x_{n-1,p-1}\\\\\n", - "\\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "* Center the data by subtracting the mean value for each column. This leads to a new matrix $\\boldsymbol{X}\\rightarrow \\overline{\\boldsymbol{X}}$.\n", - "\n", - "* Compute then the covariance/correlation matrix $\\mathbb{E}[\\overline{\\boldsymbol{X}}^T\\overline{\\boldsymbol{X}}]$.\n", - "\n", - "* Find the eigenpairs of $\\boldsymbol{C}$ with eigenvalues $[\\lambda_0,\\lambda_1,\\dots,\\lambda_{p-1}]$ and eigenvectors $[\\boldsymbol{s}_0,\\boldsymbol{s}_1,\\dots,\\boldsymbol{s}_{p-1}]$.\n", - "\n", - "* Order the eigenvalue (and the eigenvectors accordingly) in order of decreasing eigenvalues.\n", - "\n", - "* Keep only those $l$ eigenvalues larger than a selected threshold value, discarding thus $p-l$ features since we expect small variations in the data here.\n", - "\n", - "### Writing our own PCA code\n", - "\n", - "We will use a simple example first with two-dimensional data\n", - "drawn from a multivariate normal distribution with the following mean and covariance matrix (we have fixed these quantities but will play around with them below):" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mu = (-1,2) \\qquad \\Sigma = \\begin{bmatrix} 4 & 2 \\\\\n", - "2 & 2\n", - "\\end{bmatrix}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Note that the mean refers to each column of data. \n", - "We will generate $n = 10000$ points $X = \\{ x_1, \\ldots, x_N \\}$ from\n", - "this distribution, and store them in the $1000 \\times 2$ matrix $\\boldsymbol{X}$. This is our design matrix where we have forced the covariance and mean values to take specific values.\n", - "\n", - "The following Python code aids in setting up the data and writing out the design matrix.\n", - "Note that the function **multivariate** returns also the covariance discussed above and that it is defined by dividing by $n-1$ instead of $n$." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "%matplotlib inline\n", - "\n", - "import numpy as np\n", - "import pandas as pd\n", - "import matplotlib.pyplot as plt\n", - "from IPython.display import display\n", - "n = 10000\n", - "mean = (-1, 2)\n", - "cov = [[4, 2], [2, 2]]\n", - "X = np.random.multivariate_normal(mean, cov, n)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Now we are going to implement the PCA algorithm. We will break it down into various substeps.\n", - "\n", - "\n", - "The first step of PCA is to compute the sample mean of the data and use it to center the data. Recall that the sample mean is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mu_n = \\frac{1}{n} \\sum_{i=1}^n x_i\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and the mean-centered data $\\bar{X} = \\{ \\bar{x}_1, \\ldots, \\bar{x}_n \\}$ takes the form" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\bar{x}_i = x_i - \\mu_n.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "When you are done with these steps, print out $\\mu_n$ to verify it is\n", - "close to $\\mu$ and plot your mean centered data to verify it is\n", - "centered at the origin! \n", - "The following code elements perform these operations using **pandas** or using our own functionality for doing so. The latter, using **numpy** is rather simple through the **mean()** function." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "df = pd.DataFrame(X)\n", - "# Pandas does the centering for us\n", - "df = df -df.mean()\n", - "# we center it ourselves\n", - "X_centered = X - X.mean(axis=0)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Alternatively, we could use the functions we discussed\n", - "earlier for scaling the data set. That is, we could have used the\n", - "**StandardScaler** function in **Scikit-Learn**, a function which ensures\n", - "that for each feature/predictor we study the mean value is zero and\n", - "the variance is one (every column in the design/feature matrix). You\n", - "would then not get the same results, since we divide by the\n", - "variance. The diagonal covariance matrix elements will then be one,\n", - "while the non-diagonal ones need to be divided by $2\\sqrt{2}$ for our\n", - "specific case.\n", - "\n", - "\n", - "Now we are going to use the mean centered data to compute the sample covariance of the data by using the following equation" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\Sigma_n = \\frac{1}{n-1} \\sum_{i=1}^n \\bar{x}_i^T \\bar{x}_i = \\frac{1}{n-1} \\sum_{i=1}^n (x_i - \\mu_n)^T (x_i - \\mu_n)\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where the data points $x_i \\in \\mathbb{R}^p$ (here in this example $p = 2$) are column vectors and $x^T$ is the transpose of $x$.\n", - "We can write our own code or simply use either the functionaly of **numpy** or that of **pandas**, as follows" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "print(df.cov())\n", - "print(np.cov(X_centered.T))" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Note that the way we define the covariance matrix here has a factor $n-1$ instead of $n$. This is included in the **cov()** function by **numpy** and **pandas**. \n", - "Our own code here is not very elegant and asks for obvious improvements. It is tailored to this specific $2\\times 2$ covariance matrix." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "# extract the relevant columns from the centered design matrix of dim n x 2\n", - "x = X_centered[:,0]\n", - "y = X_centered[:,1]\n", - "Cov = np.zeros((2,2))\n", - "Cov[0,1] = np.sum(x.T@y)/(n-1.0)\n", - "Cov[0,0] = np.sum(x.T@x)/(n-1.0)\n", - "Cov[1,1] = np.sum(y.T@y)/(n-1.0)\n", - "Cov[1,0]= Cov[0,1]\n", - "print(\"Centered covariance using own code\")\n", - "print(Cov)\n", - "plt.plot(x, y, 'x')\n", - "plt.axis('equal')\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Depending on the number of points $n$, we will get results that are close to the covariance values defined above.\n", - "The plot shows how the data are clustered around a line with slope close to one. Is this expected? Try to change the covariance and the mean values. For example, try to make the variance of the first element much larger than that of the second diagonal element. Try also to shrink the covariance (the non-diagonal elements) and see how the data points are distributed. \n", - "\n", - "### Diagonalize the sample covariance matrix to obtain the principal components\n", - "\n", - "Now we are ready to solve for the principal components! To do so we\n", - "diagonalize the sample covariance matrix $\\Sigma$. We can use the\n", - "function **np.linalg.eig** to do so. It will return the eigenvalues and\n", - "eigenvectors of $\\Sigma$. Once we have these we can perform the \n", - "following tasks:\n", - "\n", - "* We compute the percentage of the total variance captured by the first principal component\n", - "\n", - "* We plot the mean centered data and lines along the first and second principal components\n", - "\n", - "* Then we project the mean centered data onto the first and second principal components, and plot the projected data. \n", - "\n", - "* Finally, we approximate the data as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "x_i \\approx \\tilde{x}_i = \\mu_n + \\langle x_i, v_0 \\rangle v_0\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $v_0$ is the first principal component. \n", - "\n", - "Collecting all these steps we can write our own PCA function and\n", - "compare this with the functionality included in **Scikit-Learn**. \n", - "\n", - "The code here outlines some of the elements we could include in the\n", - "analysis. Feel free to extend upon this in order to address the above\n", - "questions." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "# diagonalize and obtain eigenvalues, not necessarily sorted\n", - "EigValues, EigVectors = np.linalg.eig(Cov)\n", - "# sort eigenvectors and eigenvalues\n", - "#permute = EigValues.argsort()\n", - "#EigValues = EigValues[permute]\n", - "#EigVectors = EigVectors[:,permute]\n", - "print(\"Eigenvalues of Covariance matrix\")\n", - "for i in range(2):\n", - " print(EigValues[i])\n", - "FirstEigvector = EigVectors[:,0]\n", - "SecondEigvector = EigVectors[:,1]\n", - "print(\"First eigenvector\")\n", - "print(FirstEigvector)\n", - "print(\"Second eigenvector\")\n", - "print(SecondEigvector)\n", - "#thereafter we do a PCA with Scikit-learn\n", - "from sklearn.decomposition import PCA\n", - "pca = PCA(n_components = 2)\n", - "X2Dsl = pca.fit_transform(X)\n", - "print(\"Eigenvector of largest eigenvalue\")\n", - "print(pca.components_.T[:, 0])" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "This code does not contain all the above elements, but it shows how we can use **Scikit-Learn** to extract the eigenvector which corresponds to the largest eigenvalue. Try to address the questions we pose before the above code. Try also to change the values of the covariance matrix by making one of the diagonal elements much larger than the other. What do you observe then? \n", - "\n", - "\n", - "## Classical PCA Theorem\n", - "\n", - "We assume now that we have a design matrix $\\boldsymbol{X}$ which has been\n", - "centered as discussed above. For the sake of simplicity we skip the\n", - "overline symbol. The matrix is defined in terms of the various column\n", - "vectors $[\\boldsymbol{x}_0,\\boldsymbol{x}_1,\\dots, \\boldsymbol{x}_{p-1}]$ each with dimension\n", - "$\\boldsymbol{x}\\in {\\mathbb{R}}^{n}$.\n", - "\n", - "\n", - "\n", - "The PCA theorem states that minimizing the above reconstruction error\n", - "corresponds to setting $\\boldsymbol{W}=\\boldsymbol{S}$, the orthogonal matrix which\n", - "diagonalizes the empirical covariance(correlation) matrix. The optimal\n", - "low-dimensional encoding of the data is then given by a set of vectors\n", - "$\\boldsymbol{z}_i$ with at most $l$ vectors, with $l << p$, defined by the\n", - "orthogonal projection of the data onto the columns spanned by the\n", - "eigenvectors of the covariance(correlations matrix).\n", - "\n", - "\n", - "\n", - "\n", - "To show the PCA theorem let us start with the assumption that there is one vector $\\boldsymbol{s}_0$ which corresponds to a solution which minimized the reconstruction error $J$. This is an orthogonal vector. It means that we now approximate the reconstruction error in terms of $\\boldsymbol{w}_0$ and $\\boldsymbol{z}_0$ as\n", - "\n", - "\n", - "\n", - "We are almost there, we have obtained a relation between minimizing\n", - "the reconstruction error and the variance and the covariance\n", - "matrix. Minimizing the error is equivalent to maximizing the variance\n", - "of the projected data.\n", - "\n", - "\n", - "We could trivially maximize the variance of the projection (and\n", - "thereby minimize the error in the reconstruction function) by letting\n", - "the norm-2 of $\\boldsymbol{w}_0$ go to infinity. However, this norm since we\n", - "want the matrix $\\boldsymbol{W}$ to be an orthogonal matrix, is constrained by\n", - "$\\vert\\vert \\boldsymbol{w}_0 \\vert\\vert_2^2=1$. Imposing this condition via a\n", - "Lagrange multiplier we can then in turn maximize" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "J(\\boldsymbol{w}_0)= \\boldsymbol{w}_0^T\\boldsymbol{C}[\\boldsymbol{x}]\\boldsymbol{w}_0+\\lambda_0(1-\\boldsymbol{w}_0^T\\boldsymbol{w}_0).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Taking the derivative with respect to $\\boldsymbol{w}_0$ we obtain" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial J(\\boldsymbol{w}_0)}{\\partial \\boldsymbol{w}_0}= 2\\boldsymbol{C}[\\boldsymbol{x}]\\boldsymbol{w}_0-2\\lambda_0\\boldsymbol{w}_0=0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "meaning that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{C}[\\boldsymbol{x}]\\boldsymbol{w}_0=\\lambda_0\\boldsymbol{w}_0.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "**The direction that maximizes the variance (or minimizes the construction error) is an eigenvector of the covariance matrix**! If we left multiply with $\\boldsymbol{w}_0^T$ we have the variance of the projected data is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{w}_0^T\\boldsymbol{C}[\\boldsymbol{x}]\\boldsymbol{w}_0=\\lambda_0.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "If we want to maximize the variance (minimize the construction error)\n", - "we simply pick the eigenvector of the covariance matrix with the\n", - "largest eigenvalue. This establishes the link between the minimization\n", - "of the reconstruction function $J$ in terms of an orthogonal matrix\n", - "and the maximization of the variance and thereby the covariance of our\n", - "observations encoded in the design/feature matrix $\\boldsymbol{X}$.\n", - "\n", - "The proof\n", - "for the other eigenvectors $\\boldsymbol{w}_1,\\boldsymbol{w}_2,\\dots$ can be\n", - "established by applying the above arguments and using the fact that\n", - "our basis of eigenvectors is orthogonal, see [Murphy chapter\n", - "12.2](https://mitpress.mit.edu/books/machine-learning-1). The\n", - "discussion in chapter 12.2 of Murphy's text has also a nice link with\n", - "the Singular Value Decomposition theorem. For categorical data, see\n", - "chapter 12.4 and discussion therein.\n", - "\n", - "For more details, see for example [Vidal, Ma and Sastry, chapter 2](https://www.springer.com/gp/book/9780387878102).\n", - "\n", - "\n", - "## Geometric Interpretation and link with Singular Value Decomposition\n", - "\n", - "For a detailed demonstration of the geometric interpretation, see [Vidal, Ma and Sastry, section 2.1.2](https://www.springer.com/gp/book/9780387878102).\n", - "\n", - "\n", - "Principal Component Analysis (PCA) is by far the most popular dimensionality reduction algorithm.\n", - "First it identifies the hyperplane that lies closest to the data, and then it projects the data onto it.\n", - "\n", - "The following Python code uses NumPy’s **svd()** function to obtain all the principal components of the\n", - "training set, then extracts the first two principal components. First we center the data using either **pandas** or our own code" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import numpy as np\n", - "import pandas as pd\n", - "from IPython.display import display\n", - "np.random.seed(100)\n", - "# setting up a 10 x 5 vanilla matrix \n", - "rows = 10\n", - "cols = 5\n", - "X = np.random.randn(rows,cols)\n", - "df = pd.DataFrame(X)\n", - "# Pandas does the centering for us\n", - "df = df -df.mean()\n", - "display(df)\n", - "\n", - "# we center it ourselves\n", - "X_centered = X - X.mean(axis=0)\n", - "# Then check the difference between pandas and our own set up\n", - "print(X_centered-df)\n", - "#Now we do an SVD\n", - "U, s, V = np.linalg.svd(X_centered)\n", - "c1 = V.T[:, 0]\n", - "c2 = V.T[:, 1]\n", - "W2 = V.T[:, :2]\n", - "X2D = X_centered.dot(W2)\n", - "print(X2D)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "PCA assumes that the dataset is centered around the origin. Scikit-Learn’s PCA classes take care of centering\n", - "the data for you. However, if you implement PCA yourself (as in the preceding example), or if you use other libraries, don’t\n", - "forget to center the data first.\n", - "\n", - "Once you have identified all the principal components, you can reduce the dimensionality of the dataset\n", - "down to $d$ dimensions by projecting it onto the hyperplane defined by the first $d$ principal components.\n", - "Selecting this hyperplane ensures that the projection will preserve as much variance as possible." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "W2 = V.T[:, :2]\n", - "X2D = X_centered.dot(W2)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## PCA and scikit-learn\n", - "\n", - "Scikit-Learn’s PCA class implements PCA using SVD decomposition just like we did before. The\n", - "following code applies PCA to reduce the dimensionality of the dataset down to two dimensions (note\n", - "that it automatically takes care of centering the data):" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "#thereafter we do a PCA with Scikit-learn\n", - "from sklearn.decomposition import PCA\n", - "pca = PCA(n_components = 2)\n", - "X2D = pca.fit_transform(X)\n", - "print(X2D)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "After fitting the PCA transformer to the dataset, you can access the principal components using the\n", - "components variable (note that it contains the PCs as horizontal vectors, so, for example, the first\n", - "principal component is equal to" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "pca.components_.T[:, 0]" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Another very useful piece of information is the explained variance ratio of each principal component,\n", - "available via the $explained\\_variance\\_ratio$ variable. It indicates the proportion of the dataset’s\n", - "variance that lies along the axis of each principal component. \n", - "\n", - "## Back to the Cancer Data\n", - "We can now repeat the above but applied to real data, in this case our breast cancer data.\n", - "Here we compute performance scores on the training data using logistic regression." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import matplotlib.pyplot as plt\n", - "import numpy as np\n", - "from sklearn.model_selection import train_test_split \n", - "from sklearn.datasets import load_breast_cancer\n", - "from sklearn.linear_model import LogisticRegression\n", - "cancer = load_breast_cancer()\n", - "\n", - "X_train, X_test, y_train, y_test = train_test_split(cancer.data,cancer.target,random_state=0)\n", - "\n", - "logreg = LogisticRegression()\n", - "logreg.fit(X_train, y_train)\n", - "print(\"Train set accuracy from Logistic Regression: {:.2f}\".format(logreg.score(X_train,y_train)))\n", - "# We scale the data\n", - "from sklearn.preprocessing import StandardScaler\n", - "scaler = StandardScaler()\n", - "scaler.fit(X_train)\n", - "X_train_scaled = scaler.transform(X_train)\n", - "X_test_scaled = scaler.transform(X_test)\n", - "# Then perform again a log reg fit\n", - "logreg.fit(X_train_scaled, y_train)\n", - "print(\"Train set accuracy scaled data: {:.2f}\".format(logreg.score(X_train_scaled,y_train)))\n", - "#thereafter we do a PCA with Scikit-learn\n", - "from sklearn.decomposition import PCA\n", - "pca = PCA(n_components = 2)\n", - "X2D_train = pca.fit_transform(X_train_scaled)\n", - "# and finally compute the log reg fit and the score on the training data\t\n", - "logreg.fit(X2D_train,y_train)\n", - "print(\"Train set accuracy scaled and PCA data: {:.2f}\".format(logreg.score(X2D_train,y_train)))" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We see that our training data after the PCA decomposition has a performance similar to the non-scaled data. \n", - "\n", - "\n", - "Instead of arbitrarily choosing the number of dimensions to reduce down to, it is generally preferable to\n", - "choose the number of dimensions that add up to a sufficiently large portion of the variance (e.g., 95%).\n", - "Unless, of course, you are reducing dimensionality for data visualization — in that case you will\n", - "generally want to reduce the dimensionality down to 2 or 3.\n", - "The following code computes PCA without reducing dimensionality, then computes the minimum number\n", - "of dimensions required to preserve 95% of the training set’s variance:" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "pca = PCA()\n", - "pca.fit(X)\n", - "cumsum = np.cumsum(pca.explained_variance_ratio_)\n", - "d = np.argmax(cumsum >= 0.95) + 1" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "You could then set $n\\_components=d$ and run PCA again. However, there is a much better option: instead\n", - "of specifying the number of principal components you want to preserve, you can set $n\\_components$ to be\n", - "a float between 0.0 and 1.0, indicating the ratio of variance you wish to preserve:" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "pca = PCA(n_components=0.95)\n", - "X_reduced = pca.fit_transform(X)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "### Incremental PCA\n", - "\n", - "One problem with the preceding implementation of PCA is that it requires the whole training set to fit in\n", - "memory in order for the SVD algorithm to run. Fortunately, Incremental PCA (IPCA) algorithms have\n", - "been developed: you can split the training set into mini-batches and feed an IPCA algorithm one minibatch\n", - "at a time. This is useful for large training sets, and also to apply PCA online (i.e., on the fly, as new\n", - "instances arrive).\n", - "\n", - "\n", - "### Randomized PCA\n", - "\n", - "Scikit-Learn offers yet another option to perform PCA, called Randomized PCA. This is a stochastic\n", - "algorithm that quickly finds an approximation of the first d principal components. Its computational\n", - "complexity is $O(m \\times d^2)+O(d^3)$, instead of $O(m \\times n^2) + O(n^3)$, so it is dramatically faster than the\n", - "previous algorithms when $d$ is much smaller than $n$.\n", - "\n", - "\n", - "### Kernel PCA\n", - "\n", - "The kernel trick is a mathematical technique that implicitly maps instances into a\n", - "very high-dimensional space (called the feature space), enabling nonlinear classification and regression\n", - "with Support Vector Machines. Recall that a linear decision boundary in the high-dimensional feature\n", - "space corresponds to a complex nonlinear decision boundary in the original space.\n", - "It turns out that the same trick can be applied to PCA, making it possible to perform complex nonlinear\n", - "projections for dimensionality reduction. This is called Kernel PCA (kPCA). It is often good at\n", - "preserving clusters of instances after projection, or sometimes even unrolling datasets that lie close to a\n", - "twisted manifold.\n", - "For example, the following code uses Scikit-Learn’s KernelPCA class to perform kPCA with an" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "from sklearn.decomposition import KernelPCA\n", - "rbf_pca = KernelPCA(n_components = 2, kernel=\"rbf\", gamma=0.04)\n", - "X_reduced = rbf_pca.fit_transform(X)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Other techniques\n", - "\n", - "\n", - "There are many other dimensionality reduction techniques, several of which are available in Scikit-Learn.\n", - "\n", - "Here are some of the most popular:\n", - "* **Multidimensional Scaling (MDS)** reduces dimensionality while trying to preserve the distances between the instances.\n", - "\n", - "* **Isomap** creates a graph by connecting each instance to its nearest neighbors, then reduces dimensionality while trying to preserve the geodesic distances between the instances.\n", - "\n", - "* **t-Distributed Stochastic Neighbor Embedding** (t-SNE) reduces dimensionality while trying to keep similar instances close and dissimilar instances apart. It is mostly used for visualization, in particular to visualize clusters of instances in high-dimensional space (e.g., to visualize the MNIST images in 2D).\n", - "\n", - "* Linear Discriminant Analysis (LDA) is actually a classification algorithm, but during training it learns the most discriminative axes between the classes, and these axes can then be used to define a hyperplane onto which to project the data. The benefit is that the projection will keep classes as far apart as possible, so LDA is a good technique to reduce dimensionality before running another classification algorithm such as a Support Vector Machine (SVM) classifier discussed in the SVM lectures." - ] - } - ], - "metadata": {}, - "nbformat": 4, - "nbformat_minor": 4 -} diff --git a/doc/LectureNotes/_build/html/_sources/chapter9.ipynb b/doc/LectureNotes/_build/html/_sources/chapter9.ipynb deleted file mode 100644 index 89b5cbf54..000000000 --- a/doc/LectureNotes/_build/html/_sources/chapter9.ipynb +++ /dev/null @@ -1,1283 +0,0 @@ -{ - "cells": [ - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "# 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", - "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": [ - "\n", - "
\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", - "\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", - "\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", - "\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", - "\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", - "\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": [ - "\n", - "
\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": [ - "\n", - "
\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": [ - "\n", - "
\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", - "\n", - "The output of neuron $i$ in layer 2 is thus," - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\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": [ - "\n", - "
\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": [ - "\n", - "
\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": [ - "\n", - "
\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": [ - "We can generalize this expression to an MLP with $l$ hidden\n", - "layers. The complete functional form is," - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\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", - "\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": [ - "\n", - "
\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", - "\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": [ - "\n", - "
\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": [ - "\n", - "
\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", - "\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", - "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": [ - "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": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "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", - "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", - "\n", - "## Deriving the back propagation code for a multilayer perceptron model\n", - "\n", - "\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", - "\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": [ - "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": [ - "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", - "\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": [ - "\n", - "
\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": [ - "\n", - "
\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": [ - "\n", - "
\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", - "\n", - "### Setting up the Back propagation algorithm\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." - ] - } - ], - "metadata": {}, - "nbformat": 4, - "nbformat_minor": 4 -} diff --git a/doc/LectureNotes/_build/html/_sources/chapteroptimization.ipynb b/doc/LectureNotes/_build/html/_sources/chapteroptimization.ipynb deleted file mode 100644 index e8dc9fc17..000000000 --- a/doc/LectureNotes/_build/html/_sources/chapteroptimization.ipynb +++ /dev/null @@ -1,2793 +0,0 @@ -{ - "cells": [ - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "# Optimization, the central part of any Machine Learning algortithm\n", - "\n", - "Almost every problem in machine learning and data science starts with\n", - "a dataset $X$, a model $g(\\beta)$, which is a function of the\n", - "parameters $\\beta$ and a cost function $C(X, g(\\beta))$ that allows\n", - "us to judge how well the model $g(\\beta)$ explains the observations\n", - "$X$. The model is fit by finding the values of $\\beta$ that minimize\n", - "the cost function. Ideally we would be able to solve for $\\beta$\n", - "analytically, however this is not possible in general and we must use\n", - "some approximative/numerical method to compute the minimum.\n", - "\n", - "\n", - "\n", - "\n", - "In our discussion on Logistic Regression we studied the \n", - "case of\n", - "two classes, with $y_i$ either\n", - "$0$ or $1$. Furthermore we assumed also that we have only two\n", - "parameters $\\beta$ in our fitting, that is we\n", - "defined probabilities" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{align*}\n", - "p(y_i=1|x_i,\\boldsymbol{\\beta}) &= \\frac{\\exp{(\\beta_0+\\beta_1x_i)}}{1+\\exp{(\\beta_0+\\beta_1x_i)}},\\nonumber\\\\\n", - "p(y_i=0|x_i,\\boldsymbol{\\beta}) &= 1 - p(y_i=1|x_i,\\boldsymbol{\\beta}),\n", - "\\end{align*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $\\boldsymbol{\\beta}$ are the weights we wish to extract from data, in our case $\\beta_0$ and $\\beta_1$. \n", - "\n", - "\n", - "\n", - "Our compact equations used a definition of a vector $\\boldsymbol{y}$ with $n$\n", - "elements $y_i$, an $n\\times p$ matrix $\\boldsymbol{X}$ which contains the\n", - "$x_i$ values and a vector $\\boldsymbol{p}$ of fitted probabilities\n", - "$p(y_i\\vert x_i,\\boldsymbol{\\beta})$. We rewrote in a more compact form\n", - "the first derivative of the cost function as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial \\mathcal{C}(\\boldsymbol{\\beta})}{\\partial \\boldsymbol{\\beta}} = -\\boldsymbol{X}^T\\left(\\boldsymbol{y}-\\boldsymbol{p}\\right).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "If we in addition define a diagonal matrix $\\boldsymbol{W}$ with elements \n", - "$p(y_i\\vert x_i,\\boldsymbol{\\beta})(1-p(y_i\\vert x_i,\\boldsymbol{\\beta})$, we can obtain a compact expression of the second derivative as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial^2 \\mathcal{C}(\\boldsymbol{\\beta})}{\\partial \\boldsymbol{\\beta}\\partial \\boldsymbol{\\beta}^T} = \\boldsymbol{X}^T\\boldsymbol{W}\\boldsymbol{X}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "This defines what is called the Hessian matrix.\n", - "\n", - "\n", - "\n", - "If we can set up these equations, Newton-Raphson's iterative method is normally the method of choice. It requires however that we can compute in an efficient way the matrices that define the first and second derivatives. \n", - "\n", - "Our iterative scheme is then given by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{\\beta}^{\\mathrm{new}} = \\boldsymbol{\\beta}^{\\mathrm{old}}-\\left(\\frac{\\partial^2 \\mathcal{C}(\\boldsymbol{\\beta})}{\\partial \\boldsymbol{\\beta}\\partial \\boldsymbol{\\beta}^T}\\right)^{-1}_{\\boldsymbol{\\beta}^{\\mathrm{old}}}\\times \\left(\\frac{\\partial \\mathcal{C}(\\boldsymbol{\\beta})}{\\partial \\boldsymbol{\\beta}}\\right)_{\\boldsymbol{\\beta}^{\\mathrm{old}}},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "or in matrix form as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{\\beta}^{\\mathrm{new}} = \\boldsymbol{\\beta}^{\\mathrm{old}}-\\left(\\boldsymbol{X}^T\\boldsymbol{W}\\boldsymbol{X} \\right)^{-1}\\times \\left(-\\boldsymbol{X}^T(\\boldsymbol{y}-\\boldsymbol{p}) \\right)_{\\boldsymbol{\\beta}^{\\mathrm{old}}}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The right-hand side is computed with the old values of $\\beta$. \n", - "\n", - "If we can compute these matrices, in particular the Hessian, the above is often the easiest method to implement. \n", - "\n", - "\n", - "Let us quickly remind ourselves how we derive the above method.\n", - "\n", - "Perhaps the most celebrated of all one-dimensional root-finding\n", - "routines is Newton's method, also called the Newton-Raphson\n", - "method. This method requires the evaluation of both the\n", - "function $f$ and its derivative $f'$ at arbitrary points. \n", - "If you can only calculate the derivative\n", - "numerically and/or your function is not of the smooth type, we\n", - "normally discourage the use of this method.\n", - "\n", - "\n", - "\n", - "The Newton-Raphson formula consists geometrically of extending the\n", - "tangent line at a current point until it crosses zero, then setting\n", - "the next guess to the abscissa of that zero-crossing. The mathematics\n", - "behind this method is rather simple. Employing a Taylor expansion for\n", - "$x$ sufficiently close to the solution $s$, we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "f(s)=0=f(x)+(s-x)f'(x)+\\frac{(s-x)^2}{2}f''(x) +\\dots.\n", - " \\label{eq:taylornr} \\tag{1}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "For small enough values of the function and for well-behaved\n", - "functions, the terms beyond linear are unimportant, hence we obtain" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "f(x)+(s-x)f'(x)\\approx 0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "yielding" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "s\\approx x-\\frac{f(x)}{f'(x)}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Having in mind an iterative procedure, it is natural to start iterating with" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "x_{n+1}=x_n-\\frac{f(x_n)}{f'(x_n)}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The above is Newton-Raphson's method. It has a simple geometric\n", - "interpretation, namely $x_{n+1}$ is the point where the tangent from\n", - "$(x_n,f(x_n))$ crosses the $x$-axis. Close to the solution,\n", - "Newton-Raphson converges fast to the desired result. However, if we\n", - "are far from a root, where the higher-order terms in the series are\n", - "important, the Newton-Raphson formula can give grossly inaccurate\n", - "results. For instance, the initial guess for the root might be so far\n", - "from the true root as to let the search interval include a local\n", - "maximum or minimum of the function. If an iteration places a trial\n", - "guess near such a local extremum, so that the first derivative nearly\n", - "vanishes, then Newton-Raphson may fail totally\n", - "\n", - "\n", - "\n", - "\n", - "Newton's method can be generalized to systems of several non-linear equations\n", - "and variables. Consider the case with two equations" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{array}{cc} f_1(x_1,x_2) &=0\\\\\n", - " f_2(x_1,x_2) &=0,\\end{array}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which we Taylor expand to obtain" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{array}{cc} 0=f_1(x_1+h_1,x_2+h_2)=&f_1(x_1,x_2)+h_1\n", - " \\partial f_1/\\partial x_1+h_2\n", - " \\partial f_1/\\partial x_2+\\dots\\\\\n", - " 0=f_2(x_1+h_1,x_2+h_2)=&f_2(x_1,x_2)+h_1\n", - " \\partial f_2/\\partial x_1+h_2\n", - " \\partial f_2/\\partial x_2+\\dots\n", - " \\end{array}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Defining the Jacobian matrix $\\boldsymbol{J}$ we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{J}=\\left( \\begin{array}{cc}\n", - " \\partial f_1/\\partial x_1 & \\partial f_1/\\partial x_2 \\\\\n", - " \\partial f_2/\\partial x_1 &\\partial f_2/\\partial x_2\n", - " \\end{array} \\right),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "we can rephrase Newton's method as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\left(\\begin{array}{c} x_1^{n+1} \\\\ x_2^{n+1} \\end{array} \\right)=\n", - "\\left(\\begin{array}{c} x_1^{n} \\\\ x_2^{n} \\end{array} \\right)+\n", - "\\left(\\begin{array}{c} h_1^{n} \\\\ h_2^{n} \\end{array} \\right),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where we have defined" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\left(\\begin{array}{c} h_1^{n} \\\\ h_2^{n} \\end{array} \\right)=\n", - " -\\boldsymbol{J}^{-1}\n", - " \\left(\\begin{array}{c} f_1(x_1^{n},x_2^{n}) \\\\ f_2(x_1^{n},x_2^{n}) \\end{array} \\right).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We need thus to compute the inverse of the Jacobian matrix and it\n", - "is to understand that difficulties may\n", - "arise in case $\\boldsymbol{J}$ is nearly singular.\n", - "\n", - "It is rather straightforward to extend the above scheme to systems of\n", - "more than two non-linear equations. In our case, the Jacobian matrix is given by the Hessian that represents the second derivative of cost function. \n", - "\n", - "\n", - "\n", - "\n", - "## Steepest descent\n", - "\n", - "The basic idea of gradient descent is\n", - "that a function $F(\\mathbf{x})$, \n", - "$\\mathbf{x} \\equiv (x_1,\\cdots,x_n)$, decreases fastest if one goes from $\\bf {x}$ in the\n", - "direction of the negative gradient $-\\nabla F(\\mathbf{x})$.\n", - "\n", - "It can be shown that if" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbf{x}_{k+1} = \\mathbf{x}_k - \\gamma_k \\nabla F(\\mathbf{x}_k),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with $\\gamma_k > 0$.\n", - "\n", - "For $\\gamma_k$ small enough, then $F(\\mathbf{x}_{k+1}) \\leq\n", - "F(\\mathbf{x}_k)$. This means that for a sufficiently small $\\gamma_k$\n", - "we are always moving towards smaller function values, i.e a minimum.\n", - "\n", - "\n", - "The previous observation is the basis of the method of steepest\n", - "descent, which is also referred to as just gradient descent (GD). One\n", - "starts with an initial guess $\\mathbf{x}_0$ for a minimum of $F$ and\n", - "computes new approximations according to" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbf{x}_{k+1} = \\mathbf{x}_k - \\gamma_k \\nabla F(\\mathbf{x}_k), \\ \\ k \\geq 0.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The parameter $\\gamma_k$ is often referred to as the step length or\n", - "the learning rate within the context of Machine Learning.\n", - "\n", - "\n", - "Ideally the sequence $\\{\\mathbf{x}_k \\}_{k=0}$ converges to a global\n", - "minimum of the function $F$. In general we do not know if we are in a\n", - "global or local minimum. In the special case when $F$ is a convex\n", - "function, all local minima are also global minima, so in this case\n", - "gradient descent can converge to the global solution. The advantage of\n", - "this scheme is that it is conceptually simple and straightforward to\n", - "implement. However the method in this form has some severe\n", - "limitations:\n", - "\n", - "In machine learing we are often faced with non-convex high dimensional\n", - "cost functions with many local minima. Since GD is deterministic we\n", - "will get stuck in a local minimum, if the method converges, unless we\n", - "have a very good intial guess. This also implies that the scheme is\n", - "sensitive to the chosen initial condition.\n", - "\n", - "Note that the gradient is a function of $\\mathbf{x} =\n", - "(x_1,\\cdots,x_n)$ which makes it expensive to compute numerically.\n", - "\n", - "\n", - "\n", - "\n", - "The gradient descent method \n", - "is sensitive to the choice of learning rate $\\gamma_k$. This is due\n", - "to the fact that we are only guaranteed that $F(\\mathbf{x}_{k+1}) \\leq\n", - "F(\\mathbf{x}_k)$ for sufficiently small $\\gamma_k$. The problem is to\n", - "determine an optimal learning rate. If the learning rate is chosen too\n", - "small the method will take a long time to converge and if it is too\n", - "large we can experience erratic behavior.\n", - "\n", - "Many of these shortcomings can be alleviated by introducing\n", - "randomness. One such method is that of Stochastic Gradient Descent\n", - "(SGD), see below.\n", - "\n", - "\n", - "\n", - "## Convex functions\n", - "\n", - "Ideally we want our cost/loss function to be convex(concave).\n", - "\n", - "First we give the definition of a convex set: A set $C$ in\n", - "$\\mathbb{R}^n$ is said to be convex if, for all $x$ and $y$ in $C$ and\n", - "all $t \\in (0,1)$ , the point $(1 − t)x + ty$ also belongs to\n", - "C. Geometrically this means that every point on the line segment\n", - "connecting $x$ and $y$ is in $C$ as discussed below.\n", - "\n", - "The convex subsets of $\\mathbb{R}$ are the intervals of\n", - "$\\mathbb{R}$. Examples of convex sets of $\\mathbb{R}^2$ are the\n", - "regular polygons (triangles, rectangles, pentagons, etc...).\n", - "\n", - "\n", - "\n", - "**Convex function**: Let $X \\subset \\mathbb{R}^n$ be a convex set. Assume that the function $f: X \\rightarrow \\mathbb{R}$ is continuous, then $f$ is said to be convex if $$f(tx_1 + (1-t)x_2) \\leq tf(x_1) + (1-t)f(x_2) $$ for all $x_1, x_2 \\in X$ and for all $t \\in [0,1]$. If $\\leq$ is replaced with a strict inequaltiy in the definition, we demand $x_1 \\neq x_2$ and $t\\in(0,1)$ then $f$ is said to be strictly convex. For a single variable function, convexity means that if you draw a straight line connecting $f(x_1)$ and $f(x_2)$, the value of the function on the interval $[x_1,x_2]$ is always below the line as illustrated below.\n", - "\n", - "\n", - "In the following we state first and second-order conditions which\n", - "ensures convexity of a function $f$. We write $D_f$ to denote the\n", - "domain of $f$, i.e the subset of $R^n$ where $f$ is defined. For more\n", - "details and proofs we refer to: [S. Boyd and L. Vandenberghe. Convex Optimization. Cambridge University Press](http://stanford.edu/boyd/cvxbook/, 2004).\n", - "\n", - "**First order condition.**\n", - "\n", - "Suppose $f$ is differentiable (i.e $\\nabla f(x)$ is well defined for\n", - "all $x$ in the domain of $f$). Then $f$ is convex if and only if $D_f$\n", - "is a convex set and $$f(y) \\geq f(x) + \\nabla f(x)^T (y-x) $$ holds\n", - "for all $x,y \\in D_f$. This condition means that for a convex function\n", - "the first order Taylor expansion (right hand side above) at any point\n", - "a global under estimator of the function. To convince yourself you can\n", - "make a drawing of $f(x) = x^2+1$ and draw the tangent line to $f(x)$ and\n", - "note that it is always below the graph.\n", - "\n", - "\n", - "\n", - "**Second order condition.**\n", - "\n", - "Assume that $f$ is twice\n", - "differentiable, i.e the Hessian matrix exists at each point in\n", - "$D_f$. Then $f$ is convex if and only if $D_f$ is a convex set and its\n", - "Hessian is positive semi-definite for all $x\\in D_f$. For a\n", - "single-variable function this reduces to $f''(x) \\geq 0$. Geometrically this means that $f$ has nonnegative curvature\n", - "everywhere.\n", - "\n", - "\n", - "\n", - "This condition is particularly useful since it gives us an procedure for determining if the function under consideration is convex, apart from using the definition.\n", - "\n", - "\n", - "\n", - "The next result is of great importance to us and the reason why we are\n", - "going on about convex functions. In machine learning we frequently\n", - "have to minimize a loss/cost function in order to find the best\n", - "parameters for the model we are considering. \n", - "\n", - "Ideally we want the\n", - "global minimum (for high-dimensional models it is hard to know\n", - "if we have local or global minimum). However, if the cost/loss function\n", - "is convex the following result provides invaluable information:\n", - "\n", - "**Any minimum is global for convex functions.**\n", - "\n", - "Consider the problem of finding $x \\in \\mathbb{R}^n$ such that $f(x)$\n", - "is minimal, where $f$ is convex and differentiable. Then, any point\n", - "$x^*$ that satisfies $\\nabla f(x^*) = 0$ is a global minimum.\n", - "\n", - "\n", - "\n", - "This result means that if we know that the cost/loss function is convex and we are able to find a minimum, we are guaranteed that it is a global minimum.\n", - "\n", - "\n", - "### Some simple problems\n", - "\n", - "1. Show that $f(x)=x^2$ is convex for $x \\in \\mathbb{R}$ using the definition of convexity. Hint: If you re-write the definition, $f$ is convex if the following holds for all $x,y \\in D_f$ and any $\\lambda \\in [0,1]$ $\\lambda f(x)+(1-\\lambda)f(y)-f(\\lambda x + (1-\\lambda) y ) \\geq 0$.\n", - "\n", - "2. Using the second order condition show that the following functions are convex on the specified domain.\n", - "\n", - " * $f(x) = e^x$ is convex for $x \\in \\mathbb{R}$.\n", - "\n", - " * $g(x) = -\\ln(x)$ is convex for $x \\in (0,\\infty)$.\n", - "\n", - "\n", - "3. Let $f(x) = x^2$ and $g(x) = e^x$. Show that $f(g(x))$ and $g(f(x))$ is convex for $x \\in \\mathbb{R}$. Also show that if $f(x)$ is any convex function than $h(x) = e^{f(x)}$ is convex.\n", - "\n", - "4. A norm is any function that satisfy the following properties\n", - "\n", - " * $f(\\alpha x) = |\\alpha| f(x)$ for all $\\alpha \\in \\mathbb{R}$.\n", - "\n", - " * $f(x+y) \\leq f(x) + f(y)$\n", - "\n", - " * $f(x) \\leq 0$ for all $x \\in \\mathbb{R}^n$ with equality if and only if $x = 0$\n", - "\n", - "\n", - "Using the definition of convexity, try to show that a function satisfying the properties above is convex (the third condition is not needed to show this).\n", - "\n", - "\n", - "## Standard steepest descent\n", - "\n", - "\n", - "Before we proceed, we would like to discuss the approach called the\n", - "**standard Steepest descent** (different from the above steepest descent discussion), which again leads to us having to be able\n", - "to compute a matrix. It belongs to the class of Conjugate Gradient methods (CG).\n", - "\n", - "[The success of the CG method](https://www.cs.cmu.edu/~quake-papers/painless-conjugate-gradient.pdf)\n", - "for finding solutions of non-linear problems is based on the theory\n", - "of conjugate gradients for linear systems of equations. It belongs to\n", - "the class of iterative methods for solving problems from linear\n", - "algebra of the type" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{A}\\boldsymbol{x} = \\boldsymbol{b}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In the iterative process we end up with a problem like" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{r}= \\boldsymbol{b}-\\boldsymbol{A}\\boldsymbol{x},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $\\boldsymbol{r}$ is the so-called residual or error in the iterative process.\n", - "\n", - "When we have found the exact solution, $\\boldsymbol{r}=0$.\n", - "\n", - "\n", - "\n", - "The residual is zero when we reach the minimum of the quadratic equation" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "P(\\boldsymbol{x})=\\frac{1}{2}\\boldsymbol{x}^T\\boldsymbol{A}\\boldsymbol{x} - \\boldsymbol{x}^T\\boldsymbol{b},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with the constraint that the matrix $\\boldsymbol{A}$ is positive definite and\n", - "symmetric. This defines also the Hessian and we want it to be positive definite. \n", - "\n", - "\n", - "We denote the initial guess for $\\boldsymbol{x}$ as $\\boldsymbol{x}_0$. \n", - "We can assume without loss of generality that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{x}_0=0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "or consider the system" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{A}\\boldsymbol{z} = \\boldsymbol{b}-\\boldsymbol{A}\\boldsymbol{x}_0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "instead.\n", - "\n", - "\n", - "One can show that the solution $\\boldsymbol{x}$ is also the unique minimizer of the quadratic form" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "f(\\boldsymbol{x}) = \\frac{1}{2}\\boldsymbol{x}^T\\boldsymbol{A}\\boldsymbol{x} - \\boldsymbol{x}^T \\boldsymbol{x} , \\quad \\boldsymbol{x}\\in\\mathbf{R}^n.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "This suggests taking the first basis vector $\\boldsymbol{r}_1$ (see below for definition) \n", - "to be the gradient of $f$ at $\\boldsymbol{x}=\\boldsymbol{x}_0$, \n", - "which equals" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{A}\\boldsymbol{x}_0-\\boldsymbol{b},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and \n", - "$\\boldsymbol{x}_0=0$ it is equal $-\\boldsymbol{b}$.\n", - "\n", - "\n", - "We can compute the residual iteratively as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{r}_{k+1}=\\boldsymbol{b}-\\boldsymbol{A}\\boldsymbol{x}_{k+1},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which equals" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{b}-\\boldsymbol{A}(\\boldsymbol{x}_k+\\alpha_k\\boldsymbol{r}_k),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "or" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "(\\boldsymbol{b}-\\boldsymbol{A}\\boldsymbol{x}_k)-\\alpha_k\\boldsymbol{A}\\boldsymbol{r}_k,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which gives" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\alpha_k = \\frac{\\boldsymbol{r}_k^T\\boldsymbol{r}_k}{\\boldsymbol{r}_k^T\\boldsymbol{A}\\boldsymbol{r}_k}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "leading to the iterative scheme" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{x}_{k+1}=\\boldsymbol{x}_k-\\alpha_k\\boldsymbol{r}_{k},\n", - "$$" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "%matplotlib inline\n", - "\n", - "import numpy as np\n", - "import numpy.linalg as la\n", - "\n", - "import scipy.optimize as sopt\n", - "\n", - "import matplotlib.pyplot as pt\n", - "from mpl_toolkits.mplot3d import axes3d\n", - "\n", - "def f(x):\n", - " return 0.5*x[0]**2 + 2.5*x[1]**2\n", - "\n", - "def df(x):\n", - " return np.array([x[0], 5*x[1]])\n", - "\n", - "fig = pt.figure()\n", - "ax = fig.gca(projection=\"3d\")\n", - "\n", - "xmesh, ymesh = np.mgrid[-2:2:50j,-2:2:50j]\n", - "fmesh = f(np.array([xmesh, ymesh]))\n", - "ax.plot_surface(xmesh, ymesh, fmesh)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "And then as countor plot" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "pt.axis(\"equal\")\n", - "pt.contour(xmesh, ymesh, fmesh)\n", - "guesses = [np.array([2, 2./5])]" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Find guesses" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "x = guesses[-1]\n", - "s = -df(x)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Run it!" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "def f1d(alpha):\n", - " return f(x + alpha*s)\n", - "\n", - "alpha_opt = sopt.golden(f1d)\n", - "next_guess = x + alpha_opt * s\n", - "guesses.append(next_guess)\n", - "print(next_guess)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "What happened?" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "pt.axis(\"equal\")\n", - "pt.contour(xmesh, ymesh, fmesh, 50)\n", - "it_array = np.array(guesses)\n", - "pt.plot(it_array.T[0], it_array.T[1], \"x-\")" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Conjugate gradient method\n", - "In the CG method we define so-called conjugate directions and two vectors \n", - "$\\boldsymbol{s}$ and $\\boldsymbol{t}$\n", - "are said to be\n", - "conjugate if" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{s}^T\\boldsymbol{A}\\boldsymbol{t}= 0.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The philosophy of the CG method is to perform searches in various conjugate directions\n", - "of our vectors $\\boldsymbol{x}_i$ obeying the above criterion, namely" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{x}_i^T\\boldsymbol{A}\\boldsymbol{x}_j= 0.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Two vectors are conjugate if they are orthogonal with respect to \n", - "this inner product. Being conjugate is a symmetric relation: if $\\boldsymbol{s}$ is conjugate to $\\boldsymbol{t}$, then $\\boldsymbol{t}$ is conjugate to $\\boldsymbol{s}$.\n", - "\n", - "An example is given by the eigenvectors of the matrix" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{v}_i^T\\boldsymbol{A}\\boldsymbol{v}_j= \\lambda\\boldsymbol{v}_i^T\\boldsymbol{v}_j,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which is zero unless $i=j$. \n", - "\n", - "Assume now that we have a symmetric positive-definite matrix $\\boldsymbol{A}$ of size\n", - "$n\\times n$. At each iteration $i+1$ we obtain the conjugate direction of a vector" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{x}_{i+1}=\\boldsymbol{x}_{i}+\\alpha_i\\boldsymbol{p}_{i}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We assume that $\\boldsymbol{p}_{i}$ is a sequence of $n$ mutually conjugate directions. \n", - "Then the $\\boldsymbol{p}_{i}$ form a basis of $R^n$ and we can expand the solution \n", - "$ \\boldsymbol{A}\\boldsymbol{x} = \\boldsymbol{b}$ in this basis, namely" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{x} = \\sum^{n}_{i=1} \\alpha_i \\boldsymbol{p}_i.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The coefficients are given by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbf{A}\\mathbf{x} = \\sum^{n}_{i=1} \\alpha_i \\mathbf{A} \\mathbf{p}_i = \\mathbf{b}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Multiplying with $\\boldsymbol{p}_k^T$ from the left gives" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{p}_k^T \\boldsymbol{A}\\boldsymbol{x} = \\sum^{n}_{i=1} \\alpha_i\\boldsymbol{p}_k^T \\boldsymbol{A}\\boldsymbol{p}_i= \\boldsymbol{p}_k^T \\boldsymbol{b},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and we can define the coefficients $\\alpha_k$ as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\alpha_k = \\frac{\\boldsymbol{p}_k^T \\boldsymbol{b}}{\\boldsymbol{p}_k^T \\boldsymbol{A} \\boldsymbol{p}_k}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "If we choose the conjugate vectors $\\boldsymbol{p}_k$ carefully, \n", - "then we may not need all of them to obtain a good approximation to the solution \n", - "$\\boldsymbol{x}$. \n", - "We want to regard the conjugate gradient method as an iterative method. \n", - "This will us to solve systems where $n$ is so large that the direct \n", - "method would take too much time.\n", - "\n", - "We denote the initial guess for $\\boldsymbol{x}$ as $\\boldsymbol{x}_0$. \n", - "We can assume without loss of generality that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{x}_0=0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "or consider the system" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{A}\\boldsymbol{z} = \\boldsymbol{b}-\\boldsymbol{A}\\boldsymbol{x}_0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "instead.\n", - "\n", - "One can show that the solution $\\boldsymbol{x}$ is also the unique minimizer of the quadratic form" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "f(\\boldsymbol{x}) = \\frac{1}{2}\\boldsymbol{x}^T\\boldsymbol{A}\\boldsymbol{x} - \\boldsymbol{x}^T \\boldsymbol{x} , \\quad \\boldsymbol{x}\\in\\mathbf{R}^n.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "This suggests taking the first basis vector $\\boldsymbol{p}_1$ \n", - "to be the gradient of $f$ at $\\boldsymbol{x}=\\boldsymbol{x}_0$, \n", - "which equals" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{A}\\boldsymbol{x}_0-\\boldsymbol{b},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and \n", - "$\\boldsymbol{x}_0=0$ it is equal $-\\boldsymbol{b}$.\n", - "The other vectors in the basis will be conjugate to the gradient, \n", - "hence the name conjugate gradient method.\n", - "\n", - "Let $\\boldsymbol{r}_k$ be the residual at the $k$-th step:" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{r}_k=\\boldsymbol{b}-\\boldsymbol{A}\\boldsymbol{x}_k.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Note that $\\boldsymbol{r}_k$ is the negative gradient of $f$ at \n", - "$\\boldsymbol{x}=\\boldsymbol{x}_k$, \n", - "so the gradient descent method would be to move in the direction $\\boldsymbol{r}_k$. \n", - "Here, we insist that the directions $\\boldsymbol{p}_k$ are conjugate to each other, \n", - "so we take the direction closest to the gradient $\\boldsymbol{r}_k$ \n", - "under the conjugacy constraint. \n", - "This gives the following expression" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{p}_{k+1}=\\boldsymbol{r}_k-\\frac{\\boldsymbol{p}_k^T \\boldsymbol{A}\\boldsymbol{r}_k}{\\boldsymbol{p}_k^T\\boldsymbol{A}\\boldsymbol{p}_k} \\boldsymbol{p}_k.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We can also compute the residual iteratively as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{r}_{k+1}=\\boldsymbol{b}-\\boldsymbol{A}\\boldsymbol{x}_{k+1},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which equals" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{b}-\\boldsymbol{A}(\\boldsymbol{x}_k+\\alpha_k\\boldsymbol{p}_k),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "or" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "(\\boldsymbol{b}-\\boldsymbol{A}\\boldsymbol{x}_k)-\\alpha_k\\boldsymbol{A}\\boldsymbol{p}_k,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which gives" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{r}_{k+1}=\\boldsymbol{r}_k-\\boldsymbol{A}\\boldsymbol{p}_{k},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Revisiting our Linear Regression Solvers\n", - "\n", - "We will use linear regression as a case study for the gradient descent\n", - "methods. Linear regression is a great test case for the gradient\n", - "descent methods discussed in the lectures since it has several\n", - "desirable properties such as:\n", - "\n", - "1. An analytical solution.\n", - "\n", - "2. The gradient can be computed analytically.\n", - "\n", - "3. The cost function is convex which guarantees that gradient descent converges for small enough learning rates\n", - "\n", - "We revisit an example similar to what we had in the first homework set. We had a function of the type" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "m = 100\n", - "x = 2*np.random.rand(m,1)\n", - "y = 4+3*x+np.random.randn(m,1)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with $x_i \\in [0,1] $ is chosen randomly using a uniform distribution. Additionally we have a stochastic noise chosen according to a normal distribution $\\cal {N}(0,1)$. \n", - "The linear regression model is given by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "h_\\beta(x) = \\boldsymbol{y} = \\beta_0 + \\beta_1 x,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "such that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{y}_i = \\beta_0 + \\beta_1 x_i.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Let $\\mathbf{y} = (y_1,\\cdots,y_n)^T$, $\\mathbf{\\boldsymbol{y}} = (\\boldsymbol{y}_1,\\cdots,\\boldsymbol{y}_n)^T$ and $\\beta = (\\beta_0, \\beta_1)^T$\n", - "\n", - "It is convenient to write $\\mathbf{\\boldsymbol{y}} = X\\beta$ where $X \\in \\mathbb{R}^{100 \\times 2} $ is the design matrix given by (we keep the intercept here)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "X \\equiv \\begin{bmatrix}\n", - "1 & x_1 \\\\\n", - "\\vdots & \\vdots \\\\\n", - "1 & x_{100} & \\\\\n", - "\\end{bmatrix}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The cost/loss/risk function is given by (" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(\\beta) = \\frac{1}{n}||X\\beta-\\mathbf{y}||_{2}^{2} = \\frac{1}{n}\\sum_{i=1}^{100}\\left[ (\\beta_0 + \\beta_1 x_i)^2 - 2 y_i (\\beta_0 + \\beta_1 x_i) + y_i^2\\right]\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and we want to find $\\beta$ such that $C(\\beta)$ is minimized.\n", - "\n", - "\n", - "Computing $\\partial C(\\beta) / \\partial \\beta_0$ and $\\partial C(\\beta) / \\partial \\beta_1$ we can show that the gradient can be written as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\nabla_{\\beta} C(\\beta) = \\frac{2}{n}\\begin{bmatrix} \\sum_{i=1}^{100} \\left(\\beta_0+\\beta_1x_i-y_i\\right) \\\\\n", - "\\sum_{i=1}^{100}\\left( x_i (\\beta_0+\\beta_1x_i)-y_ix_i\\right) \\\\\n", - "\\end{bmatrix} = \\frac{2}{n}X^T(X\\beta - \\mathbf{y}),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $X$ is the design matrix defined above.\n", - "\n", - "\n", - "The Hessian matrix of $C(\\beta)$ is given by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{H} \\equiv \\begin{bmatrix}\n", - "\\frac{\\partial^2 C(\\beta)}{\\partial \\beta_0^2} & \\frac{\\partial^2 C(\\beta)}{\\partial \\beta_0 \\partial \\beta_1} \\\\\n", - "\\frac{\\partial^2 C(\\beta)}{\\partial \\beta_0 \\partial \\beta_1} & \\frac{\\partial^2 C(\\beta)}{\\partial \\beta_1^2} & \\\\\n", - "\\end{bmatrix} = \\frac{2}{n}X^T X.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "This result implies that $C(\\beta)$ is a convex function since the matrix $X^T X$ always is positive semi-definite.\n", - "\n", - "\n", - "\n", - "We can now write a program that minimizes $C(\\beta)$ using the gradient descent method with a constant learning rate $\\gamma$ according to" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\beta_{k+1} = \\beta_k - \\gamma \\nabla_\\beta C(\\beta_k), \\ k=0,1,\\cdots\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We can use the expression we computed for the gradient and let use a\n", - "$\\beta_0$ be chosen randomly and let $\\gamma = 0.001$. Stop iterating\n", - "when $||\\nabla_\\beta C(\\beta_k) || \\leq \\epsilon = 10^{-8}$. **Note that the code below does not include the latter stop criterion**.\n", - "\n", - "And finally we can compare our solution for $\\beta$ with the analytic result given by \n", - "$\\beta= (X^TX)^{-1} X^T \\mathbf{y}$.\n", - "\n", - "\n", - "\n", - "Here is our simple example" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "\n", - "# Importing various packages\n", - "from random import random, seed\n", - "import numpy as np\n", - "import matplotlib.pyplot as plt\n", - "from mpl_toolkits.mplot3d import Axes3D\n", - "from matplotlib import cm\n", - "from matplotlib.ticker import LinearLocator, FormatStrFormatter\n", - "import sys\n", - "\n", - "# the number of datapoints\n", - "n = 100\n", - "x = 2*np.random.rand(n,1)\n", - "y = 4+3*x+np.random.randn(n,1)\n", - "\n", - "X = np.c_[np.ones((n,1)), x]\n", - "# Hessian matrix\n", - "H = (2.0/n)* X.T @ X\n", - "# Get the eigenvalues\n", - "EigValues, EigVectors = np.linalg.eig(H)\n", - "print(EigValues)\n", - "\n", - "beta_linreg = np.linalg.inv(X.T @ X) @ X.T @ y\n", - "print(beta_linreg)\n", - "beta = np.random.randn(2,1)\n", - "\n", - "eta = 1.0/np.max(EigValues)\n", - "Niterations = 1000\n", - "\n", - "for iter in range(Niterations):\n", - " gradient = (2.0/n)*X.T @ (X @ beta-y)\n", - " beta -= eta*gradient\n", - "\n", - "print(beta)\n", - "xnew = np.array([[0],[2]])\n", - "xbnew = np.c_[np.ones((2,1)), xnew]\n", - "ypredict = xbnew.dot(beta)\n", - "ypredict2 = xbnew.dot(beta_linreg)\n", - "plt.plot(xnew, ypredict, \"r-\")\n", - "plt.plot(xnew, ypredict2, \"b-\")\n", - "plt.plot(x, y ,'ro')\n", - "plt.axis([0,2.0,0, 15.0])\n", - "plt.xlabel(r'$x$')\n", - "plt.ylabel(r'$y$')\n", - "plt.title(r'Gradient descent example')\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Alternatively, we can use **Scikit-Learn** as done here" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "# Importing various packages\n", - "from random import random, seed\n", - "import numpy as np\n", - "import matplotlib.pyplot as plt\n", - "from sklearn.linear_model import SGDRegressor\n", - "\n", - "n = 100\n", - "x = 2*np.random.rand(n,1)\n", - "y = 4+3*x+np.random.randn(n,1)\n", - "\n", - "X = np.c_[np.ones((n,1)), x]\n", - "beta_linreg = np.linalg.inv(X.T @ X) @ (X.T @ y)\n", - "print(beta_linreg)\n", - "sgdreg = SGDRegressor(max_iter = 50, penalty=None, eta0=0.1)\n", - "sgdreg.fit(x,y.ravel())\n", - "print(sgdreg.intercept_, sgdreg.coef_)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We have also discussed Ridge regression where the loss function contains a regularized term given by the $L_2$ norm of $\\beta$," - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C_{\\text{ridge}}(\\beta) = \\frac{1}{n}||X\\beta -\\mathbf{y}||^2 + \\lambda ||\\beta||^2, \\ \\lambda \\geq 0.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In order to minimize $C_{\\text{ridge}}(\\beta)$ using GD we only have adjust the gradient as follows" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\nabla_\\beta C_{\\text{ridge}}(\\beta) = \\frac{2}{n}\\begin{bmatrix} \\sum_{i=1}^{100} \\left(\\beta_0+\\beta_1x_i-y_i\\right) \\\\\n", - "\\sum_{i=1}^{100}\\left( x_i (\\beta_0+\\beta_1x_i)-y_ix_i\\right) \\\\\n", - "\\end{bmatrix} + 2\\lambda\\begin{bmatrix} \\beta_0 \\\\ \\beta_1\\end{bmatrix} = 2 (X^T(X\\beta - \\mathbf{y})+\\lambda \\beta).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We can easily extend our program to minimize $C_{\\text{ridge}}(\\beta)$ using gradient descent and compare with the analytical solution given by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\beta_{\\text{ridge}} = \\left(X^T X + \\lambda I_{2 \\times 2} \\right)^{-1} X^T \\mathbf{y}.\n", - "$$" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "from random import random, seed\n", - "import numpy as np\n", - "import matplotlib.pyplot as plt\n", - "from mpl_toolkits.mplot3d import Axes3D\n", - "from matplotlib import cm\n", - "from matplotlib.ticker import LinearLocator, FormatStrFormatter\n", - "import sys\n", - "\n", - "# the number of datapoints\n", - "n = 100\n", - "x = 2*np.random.rand(n,1)\n", - "y = 4+3*x+np.random.randn(n,1)\n", - "\n", - "X = np.c_[np.ones((n,1)), x]\n", - "XT_X = X.T @ X\n", - "\n", - "#Ridge parameter lambda\n", - "lmbda = 0.001\n", - "Id = lmbda* np.eye(XT_X.shape[0])\n", - "\n", - "beta_linreg = np.linalg.inv(XT_X+Id) @ X.T @ y\n", - "print(beta_linreg)\n", - "# Start plain gradient descent\n", - "beta = np.random.randn(2,1)\n", - "\n", - "eta = 0.1\n", - "Niterations = 100\n", - "\n", - "for iter in range(Niterations):\n", - " gradients = 2.0/n*X.T @ (X @ (beta)-y)+2*lmbda*beta\n", - " beta -= eta*gradients\n", - "\n", - "print(beta)\n", - "ypredict = X @ beta\n", - "ypredict2 = X @ beta_linreg\n", - "plt.plot(x, ypredict, \"r-\")\n", - "plt.plot(x, ypredict2, \"b-\")\n", - "plt.plot(x, y ,'ro')\n", - "plt.axis([0,2.0,0, 15.0])\n", - "plt.xlabel(r'$x$')\n", - "plt.ylabel(r'$y$')\n", - "plt.title(r'Gradient descent example for Ridge')\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Using gradient descent methods, limitations\n", - "\n", - "* **Gradient descent (GD) finds local minima of our function**. Since the GD algorithm is deterministic, if it converges, it will converge to a local minimum of our cost/loss/risk function. Because in ML we are often dealing with extremely rugged landscapes with many local minima, this can lead to poor performance.\n", - "\n", - "* **GD is sensitive to initial conditions**. One consequence of the local nature of GD is that initial conditions matter. Depending on where one starts, one will end up at a different local minima. Therefore, it is very important to think about how one initializes the training process. This is true for GD as well as more complicated variants of GD.\n", - "\n", - "* **Gradients are computationally expensive to calculate for large datasets**. In many cases in statistics and ML, the cost/loss/risk function is a sum of terms, with one term for each data point. For example, in linear regression, $E \\propto \\sum_{i=1}^n (y_i - \\mathbf{w}^T\\cdot\\mathbf{x}_i)^2$; for logistic regression, the square error is replaced by the cross entropy. To calculate the gradient we have to sum over *all* $n$ data points. Doing this at every GD step becomes extremely computationally expensive. An ingenious solution to this, is to calculate the gradients using small subsets of the data called \"mini batches\". This has the added benefit of introducing stochasticity into our algorithm.\n", - "\n", - "* **GD is very sensitive to choices of learning rates**. GD is extremely sensitive to the choice of learning rates. If the learning rate is very small, the training process take an extremely long time. For larger learning rates, GD can diverge and give poor results. Furthermore, depending on what the local landscape looks like, we have to modify the learning rates to ensure convergence. Ideally, we would *adaptively* choose the learning rates to match the landscape.\n", - "\n", - "* **GD treats all directions in parameter space uniformly.** Another major drawback of GD is that unlike Newton's method, the learning rate for GD is the same in all directions in parameter space. For this reason, the maximum learning rate is set by the behavior of the steepest direction and this can significantly slow down training. Ideally, we would like to take large steps in flat directions and small steps in steep directions. Since we are exploring rugged landscapes where curvatures change, this requires us to keep track of not only the gradient but second derivatives. The ideal scenario would be to calculate the Hessian but this proves to be too computationally expensive. \n", - "\n", - "* GD can take exponential time to escape saddle points, even with random initialization. As we mentioned, GD is extremely sensitive to initial condition since it determines the particular local minimum GD would eventually reach. However, even with a good initialization scheme, through the introduction of randomness, GD can still take exponential time to escape saddle points.\n", - "\n", - "## Stochastic Gradient Descent\n", - "\n", - "Stochastic gradient descent (SGD) and variants thereof address some of\n", - "the shortcomings of the Gradient descent method discussed above.\n", - "\n", - "The underlying idea of SGD comes from the observation that the cost\n", - "function, which we want to minimize, can almost always be written as a\n", - "sum over $n$ data points $\\{\\mathbf{x}_i\\}_{i=1}^n$," - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(\\mathbf{\\beta}) = \\sum_{i=1}^n c_i(\\mathbf{x}_i,\n", - "\\mathbf{\\beta}).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "This in turn means that the gradient can be\n", - "computed as a sum over $i$-gradients" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\nabla_\\beta C(\\mathbf{\\beta}) = \\sum_i^n \\nabla_\\beta c_i(\\mathbf{x}_i,\n", - "\\mathbf{\\beta}).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Stochasticity/randomness is introduced by only taking the\n", - "gradient on a subset of the data called minibatches. If there are $n$\n", - "data points and the size of each minibatch is $M$, there will be $n/M$\n", - "minibatches. We denote these minibatches by $B_k$ where\n", - "$k=1,\\cdots,n/M$.\n", - "\n", - "\n", - "\n", - "As an example, suppose we have $10$ data points $(\\mathbf{x}_1,\\cdots, \\mathbf{x}_{10})$ \n", - "and we choose to have $M=5$ minibathces,\n", - "then each minibatch contains two data points. In particular we have\n", - "$B_1 = (\\mathbf{x}_1,\\mathbf{x}_2), \\cdots, B_5 =\n", - "(\\mathbf{x}_9,\\mathbf{x}_{10})$. Note that if you choose $M=1$ you\n", - "have only a single batch with all data points and on the other extreme,\n", - "you may choose $M=n$ resulting in a minibatch for each datapoint, i.e\n", - "$B_k = \\mathbf{x}_k$.\n", - "\n", - "The idea is now to approximate the gradient by replacing the sum over\n", - "all data points with a sum over the data points in one the minibatches\n", - "picked at random in each gradient descent step" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\nabla_{\\beta}\n", - "C(\\mathbf{\\beta}) = \\sum_{i=1}^n \\nabla_\\beta c_i(\\mathbf{x}_i,\n", - "\\mathbf{\\beta}) \\rightarrow \\sum_{i \\in B_k}^n \\nabla_\\beta\n", - "c_i(\\mathbf{x}_i, \\mathbf{\\beta}).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Thus a gradient descent step now looks like" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\beta_{j+1} = \\beta_j - \\gamma_j \\sum_{i \\in B_k}^n \\nabla_\\beta c_i(\\mathbf{x}_i,\n", - "\\mathbf{\\beta})\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $k$ is picked at random with equal\n", - "probability from $[1,n/M]$. An iteration over the number of\n", - "minibathces (n/M) is commonly referred to as an epoch. Thus it is\n", - "typical to choose a number of epochs and for each epoch iterate over\n", - "the number of minibatches, as exemplified in the code below." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import numpy as np \n", - "\n", - "n = 100 #100 datapoints \n", - "M = 5 #size of each minibatch\n", - "m = int(n/M) #number of minibatches\n", - "n_epochs = 10 #number of epochs\n", - "\n", - "j = 0\n", - "for epoch in range(1,n_epochs+1):\n", - " for i in range(m):\n", - " k = np.random.randint(m) #Pick the k-th minibatch at random\n", - " #Compute the gradient using the data in minibatch Bk\n", - " #Compute new suggestion for \n", - " j += 1" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Taking the gradient only on a subset of the data has two important\n", - "benefits. First, it introduces randomness which decreases the chance\n", - "that our opmization scheme gets stuck in a local minima. Second, if\n", - "the size of the minibatches are small relative to the number of\n", - "datapoints ($M < n$), the computation of the gradient is much\n", - "cheaper since we sum over the datapoints in the $k-th$ minibatch and not\n", - "all $n$ datapoints.\n", - "\n", - "\n", - "\n", - "A natural question is when do we stop the search for a new minimum?\n", - "One possibility is to compute the full gradient after a given number\n", - "of epochs and check if the norm of the gradient is smaller than some\n", - "threshold and stop if true. However, the condition that the gradient\n", - "is zero is valid also for local minima, so this would only tell us\n", - "that we are close to a local/global minimum. However, we could also\n", - "evaluate the cost function at this point, store the result and\n", - "continue the search. If the test kicks in at a later stage we can\n", - "compare the values of the cost function and keep the $\\beta$ that\n", - "gave the lowest value.\n", - "\n", - "\n", - "\n", - "Another approach is to let the step length $\\gamma_j$ depend on the\n", - "number of epochs in such a way that it becomes very small after a\n", - "reasonable time such that we do not move at all.\n", - "\n", - "As an example, let $e = 0,1,2,3,\\cdots$ denote the current epoch and let $t_0, t_1 > 0$ be two fixed numbers. Furthermore, let $t = e \\cdot m + i$ where $m$ is the number of minibatches and $i=0,\\cdots,m-1$. Then the function $$\\gamma_j(t; t_0, t_1) = \\frac{t_0}{t+t_1} $$ goes to zero as the number of epochs gets large. I.e. we start with a step length $\\gamma_j (0; t_0, t_1) = t_0/t_1$ which decays in *time* $t$.\n", - "\n", - "In this way we can fix the number of epochs, compute $\\beta$ and\n", - "evaluate the cost function at the end. Repeating the computation will\n", - "give a different result since the scheme is random by design. Then we\n", - "pick the final $\\beta$ that gives the lowest value of the cost\n", - "function." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import numpy as np \n", - "\n", - "def step_length(t,t0,t1):\n", - " return t0/(t+t1)\n", - "\n", - "n = 100 #100 datapoints \n", - "M = 5 #size of each minibatch\n", - "m = int(n/M) #number of minibatches\n", - "n_epochs = 500 #number of epochs\n", - "t0 = 1.0\n", - "t1 = 10\n", - "\n", - "gamma_j = t0/t1\n", - "j = 0\n", - "for epoch in range(1,n_epochs+1):\n", - " for i in range(m):\n", - " k = np.random.randint(m) #Pick the k-th minibatch at random\n", - " #Compute the gradient using the data in minibatch Bk\n", - " #Compute new suggestion for beta\n", - " t = epoch*m+i\n", - " gamma_j = step_length(t,t0,t1)\n", - " j += 1\n", - "\n", - "print(\"gamma_j after %d epochs: %g\" % (n_epochs,gamma_j))" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "### Program for stochastic gradient" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "# Importing various packages\n", - "from math import exp, sqrt\n", - "from random import random, seed\n", - "import numpy as np\n", - "import matplotlib.pyplot as plt\n", - "from sklearn.linear_model import SGDRegressor\n", - "\n", - "m = 100\n", - "x = 2*np.random.rand(m,1)\n", - "y = 4+3*x+np.random.randn(m,1)\n", - "\n", - "X = np.c_[np.ones((m,1)), x]\n", - "theta_linreg = np.linalg.inv(X.T @ X) @ (X.T @ y)\n", - "print(\"Own inversion\")\n", - "print(theta_linreg)\n", - "sgdreg = SGDRegressor(max_iter = 50, penalty=None, eta0=0.1)\n", - "sgdreg.fit(x,y.ravel())\n", - "print(\"sgdreg from scikit\")\n", - "print(sgdreg.intercept_, sgdreg.coef_)\n", - "\n", - "\n", - "theta = np.random.randn(2,1)\n", - "eta = 0.1\n", - "Niterations = 1000\n", - "\n", - "\n", - "for iter in range(Niterations):\n", - " gradients = 2.0/m*X.T @ ((X @ theta)-y)\n", - " theta -= eta*gradients\n", - "print(\"theta from own gd\")\n", - "print(theta)\n", - "\n", - "xnew = np.array([[0],[2]])\n", - "Xnew = np.c_[np.ones((2,1)), xnew]\n", - "ypredict = Xnew.dot(theta)\n", - "ypredict2 = Xnew.dot(theta_linreg)\n", - "\n", - "\n", - "n_epochs = 50\n", - "t0, t1 = 5, 50\n", - "def learning_schedule(t):\n", - " return t0/(t+t1)\n", - "\n", - "theta = np.random.randn(2,1)\n", - "\n", - "for epoch in range(n_epochs):\n", - " for i in range(m):\n", - " random_index = np.random.randint(m)\n", - " xi = X[random_index:random_index+1]\n", - " yi = y[random_index:random_index+1]\n", - " gradients = 2 * xi.T @ ((xi @ theta)-yi)\n", - " eta = learning_schedule(epoch*m+i)\n", - " theta = theta - eta*gradients\n", - "print(\"theta from own sdg\")\n", - "print(theta)\n", - "\n", - "plt.plot(xnew, ypredict, \"r-\")\n", - "plt.plot(xnew, ypredict2, \"b-\")\n", - "plt.plot(x, y ,'ro')\n", - "plt.axis([0,2.0,0, 15.0])\n", - "plt.xlabel(r'$x$')\n", - "plt.ylabel(r'$y$')\n", - "plt.title(r'Random numbers ')\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Momentum based GD\n", - "\n", - "The stochastic gradient descent (SGD) is almost always used with a\n", - "*momentum* or inertia term that serves as a memory of the direction we\n", - "are moving in parameter space. This is typically implemented as\n", - "follows" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbf{v}_{t}=\\gamma \\mathbf{v}_{t-1}+\\eta_{t}\\nabla_\\theta E(\\boldsymbol{\\theta}_t) \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation} \n", - "\\boldsymbol{\\theta}_{t+1}= \\boldsymbol{\\theta}_t -\\mathbf{v}_{t},\n", - "\\label{_auto1} \\tag{2}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where we have introduced a momentum parameter $\\gamma$, with\n", - "$0\\le\\gamma\\le 1$, and for brevity we dropped the explicit notation to\n", - "indicate the gradient is to be taken over a different mini-batch at\n", - "each step. We call this algorithm gradient descent with momentum\n", - "(GDM). From these equations, it is clear that $\\mathbf{v}_t$ is a\n", - "running average of recently encountered gradients and\n", - "$(1-\\gamma)^{-1}$ sets the characteristic time scale for the memory\n", - "used in the averaging procedure. Consistent with this, when\n", - "$\\gamma=0$, this just reduces down to ordinary SGD as discussed\n", - "earlier. An equivalent way of writing the updates is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\Delta \\boldsymbol{\\theta}_{t+1} = \\gamma \\Delta \\boldsymbol{\\theta}_t -\\ \\eta_{t}\\nabla_\\theta E(\\boldsymbol{\\theta}_t),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where we have defined $\\Delta \\boldsymbol{\\theta}_{t}= \\boldsymbol{\\theta}_t-\\boldsymbol{\\theta}_{t-1}$.\n", - "\n", - "\n", - "\n", - "Let us try to get more intuition from these equations. It is helpful\n", - "to consider a simple physical analogy with a particle of mass $m$\n", - "moving in a viscous medium with drag coefficient $\\mu$ and potential\n", - "$E(\\mathbf{w})$. If we denote the particle's position by $\\mathbf{w}$,\n", - "then its motion is described by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "m {d^2 \\mathbf{w} \\over dt^2} + \\mu {d \\mathbf{w} \\over dt }= -\\nabla_w E(\\mathbf{w}).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We can discretize this equation in the usual way to get" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "m { \\mathbf{w}_{t+\\Delta t}-2 \\mathbf{w}_{t} +\\mathbf{w}_{t-\\Delta t} \\over (\\Delta t)^2}+\\mu {\\mathbf{w}_{t+\\Delta t}- \\mathbf{w}_{t} \\over \\Delta t} = -\\nabla_w E(\\mathbf{w}).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Rearranging this equation, we can rewrite this as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\Delta \\mathbf{w}_{t +\\Delta t}= - { (\\Delta t)^2 \\over m +\\mu \\Delta t} \\nabla_w E(\\mathbf{w})+ {m \\over m +\\mu \\Delta t} \\Delta \\mathbf{w}_t.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Notice that this equation is identical to previous one if we identify\n", - "the position of the particle, $\\mathbf{w}$, with the parameters\n", - "$\\boldsymbol{\\theta}$. This allows us to identify the momentum\n", - "parameter and learning rate with the mass of the particle and the\n", - "viscous drag as:" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\gamma= {m \\over m +\\mu \\Delta t }, \\qquad \\eta = {(\\Delta t)^2 \\over m +\\mu \\Delta t}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Thus, as the name suggests, the momentum parameter is proportional to\n", - "the mass of the particle and effectively provides inertia.\n", - "Furthermore, in the large viscosity/small learning rate limit, our\n", - "memory time scales as $(1-\\gamma)^{-1} \\approx m/(\\mu \\Delta t)$.\n", - "\n", - "Why is momentum useful? SGD momentum helps the gradient descent\n", - "algorithm gain speed in directions with persistent but small gradients\n", - "even in the presence of stochasticity, while suppressing oscillations\n", - "in high-curvature directions. This becomes especially important in\n", - "situations where the landscape is shallow and flat in some directions\n", - "and narrow and steep in others. It has been argued that first-order\n", - "methods (with appropriate initial conditions) can perform comparable\n", - "to more expensive second order methods, especially in the context of\n", - "complex deep learning models.\n", - "\n", - "These beneficial properties of momentum can sometimes become even more\n", - "pronounced by using a slight modification of the classical momentum\n", - "algorithm called Nesterov Accelerated Gradient (NAG).\n", - "\n", - "In the NAG algorithm, rather than calculating the gradient at the\n", - "current parameters, $\\nabla_\\theta E(\\boldsymbol{\\theta}_t)$, one\n", - "calculates the gradient at the expected value of the parameters given\n", - "our current momentum, $\\nabla_\\theta E(\\boldsymbol{\\theta}_t +\\gamma\n", - "\\mathbf{v}_{t-1})$. This yields the NAG update rule" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbf{v}_{t}=\\gamma \\mathbf{v}_{t-1}+\\eta_{t}\\nabla_\\theta E(\\boldsymbol{\\theta}_t +\\gamma \\mathbf{v}_{t-1}) \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation} \n", - "\\boldsymbol{\\theta}_{t+1}= \\boldsymbol{\\theta}_t -\\mathbf{v}_{t}.\n", - "\\label{_auto2} \\tag{3}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "One of the major advantages of NAG is that it allows for the use of a larger learning rate than GDM for the same choice of $\\gamma$.\n", - "\n", - "\n", - "\n", - "In stochastic gradient descent, with and without momentum, we still\n", - "have to specify a schedule for tuning the learning rates $\\eta_t$\n", - "as a function of time. As discussed in the context of Newton's\n", - "method, this presents a number of dilemmas. The learning rate is\n", - "limited by the steepest direction which can change depending on the\n", - "current position in the landscape. To circumvent this problem, ideally\n", - "our algorithm would keep track of curvature and take large steps in\n", - "shallow, flat directions and small steps in steep, narrow directions.\n", - "Second-order methods accomplish this by calculating or approximating\n", - "the Hessian and normalizing the learning rate by the\n", - "curvature. However, this is very computationally expensive for\n", - "extremely large models. Ideally, we would like to be able to\n", - "adaptively change the step size to match the landscape without paying\n", - "the steep computational price of calculating or approximating\n", - "Hessians.\n", - "\n", - "Recently, a number of methods have been introduced that accomplish\n", - "this by tracking not only the gradient, but also the second moment of\n", - "the gradient. These methods include AdaGrad, AdaDelta, RMS-Prop, and\n", - "ADAM.\n", - "\n", - "\n", - "### RMS prop\n", - "\n", - "In RMS prop, in addition to keeping a running average of the first\n", - "moment of the gradient, we also keep track of the second moment\n", - "denoted by $\\mathbf{s}_t=\\mathbb{E}[\\mathbf{g}_t^2]$. The update rule\n", - "for RMS prop is given by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - "\\mathbf{g}_t = \\nabla_\\theta E(\\boldsymbol{\\theta}) \n", - "\\label{_auto3} \\tag{4}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbf{s}_t =\\beta \\mathbf{s}_{t-1} +(1-\\beta)\\mathbf{g}_t^2 \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{\\theta}_{t+1}=\\boldsymbol{\\theta}_t - \\eta_t { \\mathbf{g}_t \\over \\sqrt{\\mathbf{s}_t +\\epsilon}}, \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $\\beta$ controls the averaging time of the second moment and is\n", - "typically taken to be about $\\beta=0.9$, $\\eta_t$ is a learning rate\n", - "typically chosen to be $10^{-3}$, and $\\epsilon\\sim 10^{-8} $ is a\n", - "small regularization constant to prevent divergences. Multiplication\n", - "and division by vectors is understood as an element-wise operation. It\n", - "is clear from this formula that the learning rate is reduced in\n", - "directions where the norm of the gradient is consistently large. This\n", - "greatly speeds up the convergence by allowing us to use a larger\n", - "learning rate for flat directions.\n", - "\n", - "### ADAM optimizer\n", - "\n", - "A related algorithm is the ADAM optimizer. In ADAM, we keep a running\n", - "average of both the first and second moment of the gradient and use\n", - "this information to adaptively change the learning rate for different\n", - "parameters. In addition to keeping a running average of the first and\n", - "second moments of the gradient\n", - "(i.e. $\\mathbf{m}_t=\\mathbb{E}[\\mathbf{g}_t]$ and\n", - "$\\mathbf{s}_t=\\mathbb{E}[\\mathbf{g}^2_t]$, respectively), ADAM\n", - "performs an additional bias correction to account for the fact that we\n", - "are estimating the first two moments of the gradient using a running\n", - "average (denoted by the hats in the update rule below). The update\n", - "rule for ADAM is given by (where multiplication and division are once\n", - "again understood to be element-wise operations below)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - "\\mathbf{g}_t = \\nabla_\\theta E(\\boldsymbol{\\theta}) \n", - "\\label{_auto4} \\tag{5}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbf{m}_t = \\beta_1 \\mathbf{m}_{t-1} + (1-\\beta_1) \\mathbf{g}_t \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbf{s}_t =\\beta_2 \\mathbf{s}_{t-1} +(1-\\beta_2)\\mathbf{g}_t^2 \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{\\mathbf{m}}_t={\\mathbf{m}_t \\over 1-\\beta_1^t} \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{\\mathbf{s}}_t ={\\mathbf{s}_t \\over1-\\beta_2^t} \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{\\theta}_{t+1}=\\boldsymbol{\\theta}_t - \\eta_t { \\boldsymbol{\\mathbf{m}}_t \\over \\sqrt{\\boldsymbol{\\mathbf{s}}_t} +\\epsilon}, \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation} \n", - "\\label{_auto5} \\tag{6}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $\\beta_1$ and $\\beta_2$ set the memory lifetime of the first and\n", - "second moment and are typically taken to be $0.9$ and $0.99$\n", - "respectively, and $\\eta$ and $\\epsilon$ are identical to RMSprop.\n", - "\n", - "Like in RMSprop, the effective step size of a parameter depends on the\n", - "magnitude of its gradient squared. To understand this better, let us\n", - "rewrite this expression in terms of the variance\n", - "$\\boldsymbol{\\sigma}_t^2 = \\boldsymbol{\\mathbf{s}}_t -\n", - "(\\boldsymbol{\\mathbf{m}}_t)^2$. Consider a single parameter $\\theta_t$. The\n", - "update rule for this parameter is given by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\Delta \\theta_{t+1}= -\\eta_t { \\boldsymbol{m}_t \\over \\sqrt{\\sigma_t^2 + m_t^2 }+\\epsilon}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Practical tips\n", - "\n", - "* **Randomize the data when making mini-batches**. It is always important to randomly shuffle the data when forming mini-batches. Otherwise, the gradient descent method can fit spurious correlations resulting from the order in which data is presented.\n", - "\n", - "* **Transform your inputs**. Learning becomes difficult when our landscape has a mixture of steep and flat directions. One simple trick for minimizing these situations is to standardize the data by subtracting the mean and normalizing the variance of input variables. Whenever possible, also decorrelate the inputs. To understand why this is helpful, consider the case of linear regression. It is easy to show that for the squared error cost function, the Hessian of the cost function is just the correlation matrix between the inputs. Thus, by standardizing the inputs, we are ensuring that the landscape looks homogeneous in all directions in parameter space. Since most deep networks can be viewed as linear transformations followed by a non-linearity at each layer, we expect this intuition to hold beyond the linear case.\n", - "\n", - "* **Monitor the out-of-sample performance.** Always monitor the performance of your model on a validation set (a small portion of the training data that is held out of the training process to serve as a proxy for the test set. If the validation error starts increasing, then the model is beginning to overfit. Terminate the learning process. This *early stopping* significantly improves performance in many settings.\n", - "\n", - "* **Adaptive optimization methods don't always have good generalization.** Recent studies have shown that adaptive methods such as ADAM, RMSPorp, and AdaGrad tend to have poor generalization compared to SGD or SGD with momentum, particularly in the high-dimensional limit (i.e. the number of parameters exceeds the number of data points). Although it is not clear at this stage why these methods perform so well in training deep neural networks, simpler procedures like properly-tuned SGD may work as well or better in these applications.\n", - "\n", - "## Automatic differentiation\n", - "\n", - "[Automatic differentiation (AD)](https://en.wikipedia.org/wiki/Automatic_differentiation), \n", - "also called algorithmic\n", - "differentiation or computational differentiation,is a set of\n", - "techniques to numerically evaluate the derivative of a function\n", - "specified by a computer program. AD exploits the fact that every\n", - "computer program, no matter how complicated, executes a sequence of\n", - "elementary arithmetic operations (addition, subtraction,\n", - "multiplication, division, etc.) and elementary functions (exp, log,\n", - "sin, cos, etc.). By applying the chain rule repeatedly to these\n", - "operations, derivatives of arbitrary order can be computed\n", - "automatically, accurately to working precision, and using at most a\n", - "small constant factor more arithmetic operations than the original\n", - "program.\n", - "\n", - "Automatic differentiation is neither:\n", - "\n", - "* Symbolic differentiation, nor\n", - "\n", - "* Numerical differentiation (the method of finite differences).\n", - "\n", - "Symbolic differentiation can lead to inefficient code and faces the\n", - "difficulty of converting a computer program into a single expression,\n", - "while numerical differentiation can introduce round-off errors in the\n", - "discretization process and cancellation\n", - "\n", - "\n", - "\n", - "Python has tools for so-called **automatic differentiation**.\n", - "Consider the following example" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "f(x) = \\sin\\left(2\\pi x + x^2\\right)\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which has the following derivative" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "f'(x) = \\cos\\left(2\\pi x + x^2\\right)\\left(2\\pi + 2x\\right)\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Using **autograd** we have" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import autograd.numpy as np\n", - "\n", - "# To do elementwise differentiation:\n", - "from autograd import elementwise_grad as egrad \n", - "\n", - "# To plot:\n", - "import matplotlib.pyplot as plt \n", - "\n", - "\n", - "def f(x):\n", - " return np.sin(2*np.pi*x + x**2)\n", - "\n", - "def f_grad_analytic(x):\n", - " return np.cos(2*np.pi*x + x**2)*(2*np.pi + 2*x)\n", - "\n", - "# Do the comparison:\n", - "x = np.linspace(0,1,1000)\n", - "\n", - "f_grad = egrad(f)\n", - "\n", - "computed = f_grad(x)\n", - "analytic = f_grad_analytic(x)\n", - "\n", - "plt.title('Derivative computed from Autograd compared with the analytical derivative')\n", - "plt.plot(x,computed,label='autograd')\n", - "plt.plot(x,analytic,label='analytic')\n", - "\n", - "plt.xlabel('x')\n", - "plt.ylabel('y')\n", - "plt.legend()\n", - "\n", - "plt.show()\n", - "\n", - "print(\"The max absolute difference is: %g\"%(np.max(np.abs(computed - analytic))))" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Here we\n", - "experiment with what kind of functions Autograd is capable\n", - "of finding the gradient of. The following Python functions are just\n", - "meant to illustrate what Autograd can do, but please feel free to\n", - "experiment with other, possibly more complicated, functions as well." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import autograd.numpy as np\n", - "from autograd import grad\n", - "\n", - "def f1(x):\n", - " return x**3 + 1\n", - "\n", - "f1_grad = grad(f1)\n", - "\n", - "# Remember to send in float as argument to the computed gradient from Autograd!\n", - "a = 1.0\n", - "\n", - "# See the evaluated gradient at a using autograd:\n", - "print(\"The gradient of f1 evaluated at a = %g using autograd is: %g\"%(a,f1_grad(a)))\n", - "\n", - "# Compare with the analytical derivative, that is f1'(x) = 3*x**2 \n", - "grad_analytical = 3*a**2\n", - "print(\"The gradient of f1 evaluated at a = %g by finding the analytic expression is: %g\"%(a,grad_analytical))" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "To differentiate with respect to two (or more) arguments of a Python\n", - "function, Autograd need to know at which variable the function if\n", - "being differentiated with respect to." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import autograd.numpy as np\n", - "from autograd import grad\n", - "def f2(x1,x2):\n", - " return 3*x1**3 + x2*(x1 - 5) + 1\n", - "\n", - "# By sending the argument 0, Autograd will compute the derivative w.r.t the first variable, in this case x1\n", - "f2_grad_x1 = grad(f2,0)\n", - "\n", - "# ... and differentiate w.r.t x2 by sending 1 as an additional arugment to grad\n", - "f2_grad_x2 = grad(f2,1)\n", - "\n", - "x1 = 1.0\n", - "x2 = 3.0 \n", - "\n", - "print(\"Evaluating at x1 = %g, x2 = %g\"%(x1,x2))\n", - "print(\"-\"*30)\n", - "\n", - "# Compare with the analytical derivatives:\n", - "\n", - "# Derivative of f2 w.r.t x1 is: 9*x1**2 + x2:\n", - "f2_grad_x1_analytical = 9*x1**2 + x2\n", - "\n", - "# Derivative of f2 w.r.t x2 is: x1 - 5:\n", - "f2_grad_x2_analytical = x1 - 5\n", - "\n", - "# See the evaluated derivations:\n", - "print(\"The derivative of f2 w.r.t x1: %g\"%( f2_grad_x1(x1,x2) ))\n", - "print(\"The analytical derivative of f2 w.r.t x1: %g\"%( f2_grad_x1(x1,x2) ))\n", - "\n", - "print()\n", - "\n", - "print(\"The derivative of f2 w.r.t x2: %g\"%( f2_grad_x2(x1,x2) ))\n", - "print(\"The analytical derivative of f2 w.r.t x2: %g\"%( f2_grad_x2(x1,x2) ))" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Note that the grad function will not produce the true gradient of the function. The true gradient of a function with two or more variables will produce a vector, where each element is the function differentiated w.r.t a variable." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import autograd.numpy as np\n", - "from autograd import grad\n", - "def f3(x): # Assumes x is an array of length 5 or higher\n", - " return 2*x[0] + 3*x[1] + 5*x[2] + 7*x[3] + 11*x[4]**2\n", - "\n", - "f3_grad = grad(f3)\n", - "\n", - "x = np.linspace(0,4,5)\n", - "\n", - "# Print the computed gradient:\n", - "print(\"The computed gradient of f3 is: \", f3_grad(x))\n", - "\n", - "# The analytical gradient is: (2, 3, 5, 7, 22*x[4])\n", - "f3_grad_analytical = np.array([2, 3, 5, 7, 22*x[4]])\n", - "\n", - "# Print the analytical gradient:\n", - "print(\"The analytical gradient of f3 is: \", f3_grad_analytical)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Note that in this case, when sending an array as input argument, the\n", - "output from Autograd is another array. This is the true gradient of\n", - "the function, as opposed to the function in the previous example. By\n", - "using arrays to represent the variables, the output from Autograd\n", - "might be easier to work with, as the output is closer to what one\n", - "could expect form a gradient-evaluting function." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import autograd.numpy as np\n", - "from autograd import grad\n", - "def f4(x):\n", - " return np.sqrt(1+x**2) + np.exp(x) + np.sin(2*np.pi*x)\n", - "\n", - "f4_grad = grad(f4)\n", - "\n", - "x = 2.7\n", - "\n", - "# Print the computed derivative:\n", - "print(\"The computed derivative of f4 at x = %g is: %g\"%(x,f4_grad(x)))\n", - "\n", - "# The analytical derivative is: x/sqrt(1 + x**2) + exp(x) + cos(2*pi*x)*2*pi\n", - "f4_grad_analytical = x/np.sqrt(1 + x**2) + np.exp(x) + np.cos(2*np.pi*x)*2*np.pi\n", - "\n", - "# Print the analytical gradient:\n", - "print(\"The analytical gradient of f4 at x = %g is: %g\"%(x,f4_grad_analytical))" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import autograd.numpy as np\n", - "from autograd import grad\n", - "def f5(x):\n", - " if x >= 0:\n", - " return x**2\n", - " else:\n", - " return -3*x + 1\n", - "\n", - "f5_grad = grad(f5)\n", - "\n", - "x = 2.7\n", - "\n", - "# Print the computed derivative:\n", - "print(\"The computed derivative of f5 at x = %g is: %g\"%(x,f5_grad(x)))" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "1\n", - "8\n", - " \n", - "<\n", - "<\n", - "<\n", - "!\n", - "!\n", - "C\n", - "O\n", - "D\n", - "E\n", - "_\n", - "B\n", - "L\n", - "O\n", - "C\n", - "K\n", - " \n", - " \n", - "p\n", - "y\n", - "c\n", - "o\n", - "d" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import autograd.numpy as np\n", - "from autograd import grad\n", - "# Both of the functions are implementation of the sum: sum(x**i) for i = 0, ..., 9\n", - "# The analytical derivative is: sum(i*x**(i-1)) \n", - "f6_grad_analytical = 0\n", - "for i in range(10):\n", - " f6_grad_analytical += i*x**(i-1)\n", - "\n", - "print(\"The analytical derivative of f6 at x = %g is: %g\"%(x,f6_grad_analytical))" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import autograd.numpy as np\n", - "from autograd import grad\n", - "\n", - "def f7(n): # Assume that n is an integer\n", - " if n == 1 or n == 0:\n", - " return 1\n", - " else:\n", - " return n*f7(n-1)\n", - "\n", - "f7_grad = grad(f7)\n", - "\n", - "n = 2.0\n", - "\n", - "print(\"The computed derivative of f7 at n = %d is: %g\"%(n,f7_grad(n)))\n", - "\n", - "# The function f7 is an implementation of the factorial of n.\n", - "# By using the product rule, one can find that the derivative is:\n", - "\n", - "f7_grad_analytical = 0\n", - "for i in range(int(n)-1):\n", - " tmp = 1\n", - " for k in range(int(n)-1):\n", - " if k != i:\n", - " tmp *= (n - k)\n", - " f7_grad_analytical += tmp\n", - "\n", - "print(\"The analytical derivative of f7 at n = %d is: %g\"%(n,f7_grad_analytical))" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Note that if n is equal to zero or one, Autograd will give an error message. This message appears when the output is independent on input.\n", - "\n", - "\n", - "Autograd supports many features. However, there are some functions that are not supported (yet) by Autograd.\n", - "\n", - "Assigning a value to the variable being differentiated with respect to is an example thereof." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "#import autograd.numpy as np\n", - "#from autograd import grad\n", - "#def f8(x): # Assume x is an array\n", - "# x[2] = 3\n", - "# return x*2\n", - "\n", - "#f8_grad = grad(f8)\n", - "\n", - "#x = 8.4\n", - "\n", - "#print(\"The derivative of f8 is:\",f8_grad(x))" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Here, Autograd tells us that an 'ArrayBox' does not support item assignment. The item assignment is done when the program tries to assign x[2] to the value 3. However, Autograd has implemented the computation of the derivative such that this assignment is not possible." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import autograd.numpy as np\n", - "from autograd import grad\n", - "def f9(a): # Assume a is an array with 2 elements\n", - " b = np.array([1.0,2.0])\n", - " return a.dot(b)\n", - "\n", - "f9_grad = grad(f9)\n", - "\n", - "x = np.array([1.0,0.0])\n", - "\n", - "print(\"The derivative of f9 is:\",f9_grad(x))" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Here we are told that the 'dot' function does not belong to Autograd's\n", - "version of a Numpy array. To overcome this, an alternative syntax\n", - "which also computed the dot product can be used:" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import autograd.numpy as np\n", - "from autograd import grad\n", - "def f9_alternative(x): # Assume a is an array with 2 elements\n", - " b = np.array([1.0,2.0])\n", - " return np.dot(x,b) # The same as x_1*b_1 + x_2*b_2\n", - "\n", - "f9_alternative_grad = grad(f9_alternative)\n", - "\n", - "x = np.array([3.0,0.0])\n", - "\n", - "print(\"The gradient of f9 is:\",f9_alternative_grad(x))\n", - "\n", - "# The analytical gradient of the dot product of vectors x and b with two elements (x_1,x_2) and (b_1, b_2) respectively\n", - "# w.r.t x is (b_1, b_2)." - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The documentation recommends to avoid inplace operations such as" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "a += b\n", - "a -= b\n", - "a*= b\n", - "a /=b" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "More examples will be added, in particular how to compare autograd with own codes for the gradients." - ] - } - ], - "metadata": {}, - "nbformat": 4, - "nbformat_minor": 4 -} diff --git a/doc/LectureNotes/_build/html/_sources/content.md b/doc/LectureNotes/_build/html/_sources/content.md deleted file mode 100644 index 0f6aca77a..000000000 --- a/doc/LectureNotes/_build/html/_sources/content.md +++ /dev/null @@ -1,5 +0,0 @@ -Content in Jupyter Book -======================= - -There are many ways to write content in Jupyter Book. This short section -covers a few tips for how to do so. diff --git a/doc/LectureNotes/_build/html/_sources/intro.md b/doc/LectureNotes/_build/html/_sources/intro.md deleted file mode 100644 index 95698c010..000000000 --- a/doc/LectureNotes/_build/html/_sources/intro.md +++ /dev/null @@ -1,141 +0,0 @@ -# Applied Data Analysis and Machine Learning, FYS-STK3155/4155 at the University of Oslo, Norway - -## Introduction - -Probability theory and statistical methods play a central role in Science. Nowadays we are -surrounded by huge amounts of data. For example, there are more than one trillion web pages; more than one -hour of video is uploaded to YouTube every second, amounting to years of content every -day; the genomes of 1000s of people, each of which has a length of more than a billion base pairs, have -been sequenced by various labs and so on. This deluge of data calls for automated methods of data analysis, -which is exactly what machine learning aims at providing. - -## Learning outcomes - -This course aims at giving you insights and knowledge about many of the central algorithms used in Data Analysis and Machine Learning. The course is project based and through various numerical projects and weekly exercises you will be exposed to fundamental research problems in these fields, with the aim to reproduce state of the art scientific results. Both supervised and unsupervised methods will be covered. The emphasis is on a frequentist approach with an emphasis on predictions and correaltions. However, we will try, where appropriate, to link our machine learning models with a Bayesian approach as well. You will learn to develop and structure large codes for studying different cases where Machine Learning is applied to, get acquainted with computing facilities and learn to handle large scientific projects. A good scientific and ethical conduct is emphasized throughout the course. More specifically, after this course you will - -- Learn about basic data analysis, statistical analysis, Bayesian statistics, Monte Carlo sampling, data optimization and machine learning; -- Be capable of extending the acquired knowledge to other systems and cases; -- Have an understanding of central algorithms used in data analysis and machine learning; -- Understand linear methods for regression and classification, from ordinary least squares, via Lasso and Ridge to Logistic regression and Kernel regression; -- Learn about neural networks and deep learning methods for supervised and unsupervised learning. Emphasis on feed forward neural networks, convolutional and recurrent neural networks; -- Learn about about decision trees, random forests, bagging and boosting methods; -- Learn about support vector machines and kernel transformations; -- Reduction of data sets and unsupervised learning, from PCA to clustering; -- Autoencoders and Reinforcement Learning; -- Work on numerical projects to illustrate the theory. The projects play a central role and you are expected to know modern programming languages like Python or C++ and/or Fortran (Fortran2003 or later). - -## Prerequisites and background - -Basic knowledge in programming and mathematics, with an emphasis on linear algebra. Knowledge of Python or/and C++ as programming languages is strongly recommended and experience with Jupyter notebooks is recommended. Required courses are the equivalents to the University of Oslo mathematics courses MAT1100, MAT1110, MAT1120 and at least one of the corresponding computing and programming courses INF1000/INF1110 or MAT-INF1100/MAT-INF1100L/BIOS1100/KJM-INF1100. Most universities offer nowadays a basic programming course (often compulsory) where Python is the recurring programming language. -We recommend also refreshing your knowledge on Statistics and Probability theory. The lecture notes at https://compphysics.github.io/MachineLearning/doc/LectureNotes/_build/html/intro.html offer a review of Statistics and Probability theory. - -## The course has two central parts - -1. Statistical analysis and optimization of data -2. Machine learning - - -### Statistical analysis and optimization of data - -The following topics will be covered -- Basic concepts, expectation values, variance, covariance, correlation functions and errors; -- Simpler models, binomial distribution, the Poisson distribution, simple and multivariate normal distributions; -- Central elements of Bayesian statistics and modeling; -- Gradient methods for data optimization, -- Monte Carlo methods, Markov chains, Gibbs sampling and Metropolis-Hastings sampling; -- Estimation of errors and resampling techniques such as the cross-validation, blocking, bootstrapping and jackknife methods; -- Principal Component Analysis (PCA) and its mathematical foundation - -### Machine learning - -The following topics will be covered: -- Linear Regression and Logistic Regression; -- Neural networks and deep learning, including convolutional and recurrent neural networks -- Decisions trees, Random Forests, Bagging and Boosting -- Support vector machines -- Bayesian linear and logistic regression -- Boltzmann Machines -- Unsupervised learning Dimensionality reduction, PCA, k-means and clustering -- Autoenconders - -Hands-on demonstrations, exercises and projects aim at deepening your understanding of these topics. - -Computational aspects play a central role and you are -expected to work on numerical examples and projects which illustrate -the theory and various algorithms discussed during the lectures. We recommend strongly to form small project groups of 2-3 participants, if possible. - - - -## Required Technologies - -Course participants are expected to have their own laptops/PCs. We use _Git_ as version control software and the usage of providers like _GitHub_, _GitLab_ or similar are strongly recommended. If you are not familiar with Git as version control software, the following video may be of interest, see https://www.youtube.com/watch?v=RGOj5yH7evk&ab_channel=freeCodeCamp.org - -We will make extensive use of Python as programming language and its -myriad of available libraries. You will find -Jupyter notebooks invaluable in your work. You can run _R_ -codes in the Jupyter/IPython notebooks, with the immediate benefit of -visualizing your data. You can also use compiled languages like C++, -Rust, Julia, Fortran etc if you prefer. The focus in these lectures will be -on Python. - - -If you have Python installed and you feel -pretty familiar with installing different packages, we recommend that -you install the following Python packages via _pip_ as - -* pip install numpy scipy matplotlib ipython scikit-learn mglearn sympy pandas pillow - -For OSX users we recommend, after having installed Xcode, to -install _brew_. Brew allows for a seamless installation of additional -software via for example - -* brew install python3 - -For Linux users, with its variety of distributions like for example the widely popular Ubuntu distribution, -you can use _pip_ as well and simply install Python as - -* sudo apt-get install python3 - -### Python installers - -If you don't want to perform these operations separately and venture -into the hassle of exploring how to set up dependencies and paths, we -recommend two widely used distrubutions which set up all relevant -dependencies for Python, namely - -* Anaconda:https://docs.anaconda.com/, - -which is an open source -distribution of the Python and R programming languages for large-scale -data processing, predictive analytics, and scientific computing, that -aims to simplify package management and deployment. Package versions -are managed by the package management system _conda_. - -* Enthought canopy:https://www.enthought.com/product/canopy/ - -is a Python -distribution for scientific and analytic computing distribution and -analysis environment, available for free and under a commercial -license. - -Furthermore, Google's Colab:https://colab.research.google.com/notebooks/welcome.ipynb is a free Jupyter notebook environment that requires -no setup and runs entirely in the cloud. Try it out! - -### Useful Python libraries -Here we list several useful Python libraries we strongly recommend (if you use anaconda many of these are already there) - -* _NumPy_:https://www.numpy.org/ is a highly popular library for large, multi-dimensional arrays and matrices, along with a large collection of high-level mathematical functions to operate on these arrays -* _The pandas_:https://pandas.pydata.org/ library provides high-performance, easy-to-use data structures and data analysis tools -* _Xarray_:http://xarray.pydata.org/en/stable/ is a Python package that makes working with labelled multi-dimensional arrays simple, efficient, and fun! -* _Scipy_:https://www.scipy.org/ (pronounced “Sigh Pie”) is a Python-based ecosystem of open-source software for mathematics, science, and engineering. -* _Matplotlib_:https://matplotlib.org/ is a Python 2D plotting library which produces publication quality figures in a variety of hardcopy formats and interactive environments across platforms. -* _Autograd_:https://github.com/HIPS/autograd can automatically differentiate native Python and Numpy code. It can handle a large subset of Python's features, including loops, ifs, recursion and closures, and it can even take derivatives of derivatives of derivatives -* _SymPy_:https://www.sympy.org/en/index.html is a Python library for symbolic mathematics. -* _scikit-learn_:https://scikit-learn.org/stable/ has simple and efficient tools for machine learning, data mining and data analysis -* _TensorFlow_:https://www.tensorflow.org/ is a Python library for fast numerical computing created and released by Google -* _Keras_:https://keras.io/ is a high-level neural networks API, written in Python and capable of running on top of TensorFlow, CNTK, or Theano -* And many more such as _pytorch_:https://pytorch.org/, _Theano_:https://pypi.org/project/Theano/ etc - - - - diff --git a/doc/LectureNotes/_build/html/_sources/linalg.ipynb b/doc/LectureNotes/_build/html/_sources/linalg.ipynb deleted file mode 100644 index e915954aa..000000000 --- a/doc/LectureNotes/_build/html/_sources/linalg.ipynb +++ /dev/null @@ -1,1494 +0,0 @@ -{ - "cells": [ - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "# Linear Algebra, Handling of Arrays and more Python Features\n", - "\n", - "## Introduction\n", - "\n", - "The aim of this set of lectures is to review some central linear algebra algorithms that we will need in our \n", - "data analysis part and in the construction of Machine Learning algorithms (ML). \n", - "This will allow us to introduce some central programming features of high-level languages like Python and \n", - "compiled languages like C++ and/or Fortran. \n", - "\n", - "As discussed in the introductory notes, these series of lectures focuses both on using\n", - "central Python packages like **tensorflow** and **scikit-learn** as well\n", - "as writing your own codes for some central ML algorithms. The\n", - "latter can be written in a language of your choice, be it Python, Julia, R,\n", - "Rust, C++, Fortran etc. In order to avoid confusion however, in these lectures we will limit our\n", - "attention to Python, C++ and Fortran. \n", - "\n", - "\n", - "## Important Matrix and vector handling packages\n", - "\n", - "There are several central software packages for linear algebra and eigenvalue problems. Several of the more\n", - "popular ones have been wrapped into ofter software packages like those from the widely used text **Numerical Recipes**. The original source codes in many of the available packages are often taken from the widely used\n", - "software package LAPACK, which follows two other popular packages\n", - "developed in the 1970s, namely EISPACK and LINPACK. We describe them shortly here.\n", - "\n", - " * LINPACK: package for linear equations and least square problems.\n", - "\n", - " * LAPACK:package for solving symmetric, unsymmetric and generalized eigenvalue problems. From LAPACK's website it is possible to download for free all source codes from this library. Both C/C++ and Fortran versions are available.\n", - "\n", - " * BLAS (I, II and III): (Basic Linear Algebra Subprograms) are routines that provide standard building blocks for performing basic vector and matrix operations. Blas I is vector operations, II vector-matrix operations and III matrix-matrix operations. Highly parallelized and efficient codes, all available for download from .\n", - "\n", - "When dealing with matrices and vectors a central issue is memory\n", - "handling and allocation. If our code is written in Python the way we\n", - "declare these objects and the way they are handled, interpreted and\n", - "used by say a linear algebra library, requires codes that interface\n", - "our Python program with such libraries. For Python programmers,\n", - "**Numpy** is by now the standard Python package for numerical arrays in\n", - "Python as well as the source of functions which act on these\n", - "arrays. These functions span from eigenvalue solvers to functions that\n", - "compute the mean value, variance or the covariance matrix. If you are\n", - "not familiar with how arrays are handled in say Python or compiled\n", - "languages like C++ and Fortran, the sections in this chapter may be\n", - "useful. For C++ programmer, **Armadillo** is widely used library for\n", - "linear algebra and eigenvalue problems. In addition it offers a\n", - "convenient way to handle and organize arrays. We discuss this library\n", - "as well. Before we proceed we believe it may be convenient to repeat some basic features of \n", - " matrices and vectors.\n", - "\n", - "\n", - "## Basic Matrix Features\n", - "\n", - "Matrix properties reminder" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbf{A} =\n", - " \\begin{bmatrix} a_{11} & a_{12} & a_{13} & a_{14} \\\\\n", - " a_{21} & a_{22} & a_{23} & a_{24} \\\\\n", - " a_{31} & a_{32} & a_{33} & a_{34} \\\\\n", - " a_{41} & a_{42} & a_{43} & a_{44}\n", - " \\end{bmatrix}\\qquad\n", - "\\mathbf{I} =\n", - " \\begin{bmatrix} 1 & 0 & 0 & 0 \\\\\n", - " 0 & 1 & 0 & 0 \\\\\n", - " 0 & 0 & 1 & 0 \\\\\n", - " 0 & 0 & 0 & 1\n", - " \\end{bmatrix}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The inverse of a matrix is defined by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbf{A}^{-1} \\cdot \\mathbf{A} = I\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "
Relations Name matrix elements
$A = A^{T}$ symmetric $a_{ij} = a_{ji}$
$A = \\left (A^{T} \\right )^{-1}$ real orthogonal $\\sum_k a_{ik} a_{jk} = \\sum_k a_{ki} a_{kj} = \\delta_{ij}$
$A = A^{ * }$ real matrix $a_{ij} = a_{ij}^{ * }$
$A = A^{\\dagger}$ hermitian $a_{ij} = a_{ji}^{ * }$
$A = \\left (A^{\\dagger} \\right )^{-1}$ unitary $\\sum_k a_{ik} a_{jk}^{ * } = \\sum_k a_{ki}^{ * } a_{kj} = \\delta_{ij}$
\n", - "### Some famous Matrices\n", - "\n", - " * Diagonal if $a_{ij}=0$ for $i\\ne j$\n", - "\n", - " * Upper triangular if $a_{ij}=0$ for $i > j$\n", - "\n", - " * Lower triangular if $a_{ij}=0$ for $i < j$\n", - "\n", - " * Upper Hessenberg if $a_{ij}=0$ for $i > j+1$\n", - "\n", - " * Lower Hessenberg if $a_{ij}=0$ for $i < j+1$\n", - "\n", - " * Tridiagonal if $a_{ij}=0$ for $|i -j| > 1$\n", - "\n", - " * Lower banded with bandwidth $p$: $a_{ij}=0$ for $i > j+p$\n", - "\n", - " * Upper banded with bandwidth $p$: $a_{ij}=0$ for $i < j+p$\n", - "\n", - " * Banded, block upper triangular, block lower triangular....\n", - "\n", - "Some Equivalent Statements. For an $N\\times N$ matrix $\\mathbf{A}$ the following properties are all equivalent\n", - "\n", - " * If the inverse of $\\mathbf{A}$ exists, $\\mathbf{A}$ is nonsingular.\n", - "\n", - " * The equation $\\mathbf{Ax}=0$ implies $\\mathbf{x}=0$.\n", - "\n", - " * The rows of $\\mathbf{A}$ form a basis of $R^N$.\n", - "\n", - " * The columns of $\\mathbf{A}$ form a basis of $R^N$.\n", - "\n", - " * $\\mathbf{A}$ is a product of elementary matrices.\n", - "\n", - " * $0$ is not eigenvalue of $\\mathbf{A}$.\n", - "\n", - "## Numpy and arrays\n", - "[Numpy](http://www.numpy.org/) provides an easy way to handle arrays in Python. The standard way to import this library is as" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import numpy as np\n", - "n = 10\n", - "x = np.random.normal(size=n)\n", - "print(x)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Here we have defined a vector $x$ with $n=10$ elements with its values given by the Normal distribution $N(0,1)$.\n", - "Another alternative is to declare a vector as follows" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import numpy as np\n", - "x = np.array([1, 2, 3])\n", - "print(x)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Here we have defined a vector with three elements, with $x_0=1$, $x_1=2$ and $x_2=3$. Note that both Python and C++\n", - "start numbering array elements from $0$ and on. This means that a vector with $n$ elements has a sequence of entities $x_0, x_1, x_2, \\dots, x_{n-1}$. We could also let (recommended) Numpy to compute the logarithms of a specific array as" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import numpy as np\n", - "x = np.log(np.array([4, 7, 8]))\n", - "print(x)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Here we have used Numpy's unary function $np.log$. This function is\n", - "highly tuned to compute array elements since the code is vectorized\n", - "and does not require looping. We normaly recommend that you use the\n", - "Numpy intrinsic functions instead of the corresponding **log** function\n", - "from Python's **math** module. The looping is done explicitely by the\n", - "**np.log** function. The alternative, and slower way to compute the\n", - "logarithms of a vector would be to write" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import numpy as np\n", - "from math import log\n", - "x = np.array([4, 7, 8])\n", - "for i in range(0, len(x)):\n", - " x[i] = log(x[i])\n", - "print(x)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We note that our code is much longer already and we need to import the **log** function from the **math** module. \n", - "The attentive reader will also notice that the output is $[1, 1, 2]$. Python interprets automacally our numbers as integers (like the **automatic** keyword in C++). To change this we could define our array elements to be double precision numbers as" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import numpy as np\n", - "x = np.log(np.array([4, 7, 8], dtype = np.float64))\n", - "print(x)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "or simply write them as double precision numbers (Python uses 64 bits as default for floating point type variables), that is" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import numpy as np\n", - "x = np.log(np.array([4.0, 7.0, 8.0])\n", - "print(x)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "To check the number of bytes (remember that one byte contains eight bits for double precision variables), you can use simple use the **itemsize** functionality (the array $x$ is actually an object which inherits the functionalities defined in Numpy) as" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import numpy as np\n", - "x = np.log(np.array([4.0, 7.0, 8.0])\n", - "print(x.itemsize)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Having defined vectors, we are now ready to try out matrices. We can define a $3 \\times 3 $ real matrix $\\hat{A}$\n", - "as (recall that we user lowercase letters for vectors and uppercase letters for matrices)" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import numpy as np\n", - "A = np.log(np.array([ [4.0, 7.0, 8.0], [3.0, 10.0, 11.0], [4.0, 5.0, 7.0] ]))\n", - "print(A)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "If we use the **shape** function we would get $(3, 3)$ as output, that is verifying that our matrix is a $3\\times 3$ matrix. We can slice the matrix and print for example the first column (Python organized matrix elements in a row-major order, see below) as" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import numpy as np\n", - "A = np.log(np.array([ [4.0, 7.0, 8.0], [3.0, 10.0, 11.0], [4.0, 5.0, 7.0] ]))\n", - "# print the first column, row-major order and elements start with 0\n", - "print(A[:,0])" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We can continue this was by printing out other columns or rows. The example here prints out the second column" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import numpy as np\n", - "A = np.log(np.array([ [4.0, 7.0, 8.0], [3.0, 10.0, 11.0], [4.0, 5.0, 7.0] ]))\n", - "# print the first column, row-major order and elements start with 0\n", - "print(A[1,:])" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Numpy contains many other functionalities that allow us to slice, subdivide etc etc arrays. We strongly recommend that you look up the [Numpy website for more details](http://www.numpy.org/). Useful functions when defining a matrix are the **np.zeros** function which declares a matrix of a given dimension and sets all elements to zero" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import numpy as np\n", - "n = 10\n", - "# define a matrix of dimension 10 x 10 and set all elements to zero\n", - "A = np.zeros( (n, n) )\n", - "print(A)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "or initializing all elements to" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import numpy as np\n", - "n = 10\n", - "# define a matrix of dimension 10 x 10 and set all elements to one\n", - "A = np.ones( (n, n) )\n", - "print(A)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "or as unitarily distributed random numbers (see the material on random number generators in the statistics part)" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import numpy as np\n", - "n = 10\n", - "# define a matrix of dimension 10 x 10 and set all elements to random numbers with x \\in [0, 1]\n", - "A = np.random.rand(n, n)\n", - "print(A)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "As we will see throughout these lectures, there are several extremely useful functionalities in Numpy.\n", - "As an example, consider the discussion of the covariance matrix. Suppose we have defined three vectors\n", - "$\\hat{x}, \\hat{y}, \\hat{z}$ with $n$ elements each. The covariance matrix is defined as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\hat{\\Sigma} = \\begin{bmatrix} \\sigma_{xx} & \\sigma_{xy} & \\sigma_{xz} \\\\\n", - " \\sigma_{yx} & \\sigma_{yy} & \\sigma_{yz} \\\\\n", - " \\sigma_{zx} & \\sigma_{zy} & \\sigma_{zz} \n", - " \\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where for example" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\sigma_{xy} =\\frac{1}{n} \\sum_{i=0}^{n-1}(x_i- \\overline{x})(y_i- \\overline{y}).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The Numpy function **np.cov** calculates the covariance elements using the factor $1/(n-1)$ instead of $1/n$ since it assumes we do not have the exact mean values. For a more in-depth discussion of the covariance and covariance matrix and its meaning, we refer you to the lectures on statistics. \n", - "The following simple function uses the **np.vstack** function which takes each vector of dimension $1\\times n$ and produces a $ 3\\times n$ matrix $\\hat{W}$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\hat{W} = \\begin{bmatrix} x_0 & y_0 & z_0 \\\\\n", - " x_1 & y_1 & z_1 \\\\\n", - " x_2 & y_2 & z_2 \\\\\n", - " \\dots & \\dots & \\dots \\\\\n", - " x_{n-2} & y_{n-2} & z_{n-2} \\\\\n", - " x_{n-1} & y_{n-1} & z_{n-1}\n", - " \\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which in turn is converted into into the $3 times 3$ covariance matrix\n", - "$\\hat{\\Sigma}$ via the Numpy function **np.cov()**. In our review of\n", - "statistical functions and quantities we will discuss more about the\n", - "meaning of the covariance matrix. Here we note that we can calculate\n", - "the mean value of each set of samples $\\hat{x}$ etc using the Numpy\n", - "function **np.mean(x)**. We can also extract the eigenvalues of the\n", - "covariance matrix through the **np.linalg.eig()** function." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "# Importing various packages\n", - "import numpy as np\n", - "\n", - "n = 100\n", - "x = np.random.normal(size=n)\n", - "print(np.mean(x))\n", - "y = 4+3*x+np.random.normal(size=n)\n", - "print(np.mean(y))\n", - "z = x**3+np.random.normal(size=n)\n", - "print(np.mean(z))\n", - "W = np.vstack((x, y, z))\n", - "Sigma = np.cov(W)\n", - "print(Sigma)\n", - "Eigvals, Eigvecs = np.linalg.eig(Sigma)\n", - "print(Eigvals)" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "%matplotlib inline\n", - "\n", - "import numpy as np\n", - "import matplotlib.pyplot as plt\n", - "from scipy import sparse\n", - "eye = np.eye(4)\n", - "print(eye)\n", - "sparse_mtx = sparse.csr_matrix(eye)\n", - "print(sparse_mtx)\n", - "x = np.linspace(-10,10,100)\n", - "y = np.sin(x)\n", - "plt.plot(x,y,marker='x')\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Other Matrix and Vector Operations\n", - "\n", - "The following examples show how to compute various quantities like the **mean** value of a matrix or a vector and how to use functions like **reshape** and **ravel**. These are all useful quantities when scaling the data and preparing the data for various machine learning algorithms and when calculating quantities like the mean squared error or the variance." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "\"\"\"\n", - "Simple code that tests various numpy functions\n", - "\"\"\"\n", - "\n", - "import numpy as np\n", - "# Simple test-matrix of dim 3 x 4\n", - "a = np.array([ [1, 2, 3], [4, 5, 6], [7, 8, 9],[10, 11, 12]],dtype=np.float64)\n", - "print(f\"The test matrix:{a}\")\n", - "# This is the total mean summed over all elements, which here has to be 6.5\n", - "print(f\"This is the total mean summed over all elements:{np.mean(a,dtype=np.float64)}\")\n", - "# This is the mean for each column, it returns an array with the mean values for each column. It returns a row-like vector\n", - "print(f\"This is the mean for each column:{np.mean(a, axis=0, keepdims=True,dtype=np.float64)}\")\n", - "# This is the mean value for each row, it returns an array via the keepdims option which is a column-like vector if\n", - "# keepdims=True. Else it return a row-like vector\n", - "# Try setting keepdims=False\n", - "print(f\"This is the mean value for each row:{np.mean(a, axis=1, keepdims=True,dtype=np.float64)}\")\n", - "# We print then the mean value for each row by setting keepdims=False\n", - "print(f\"This is the mean value for each row with keepdims false:{np.mean(a, axis=1, keepdims=False,dtype=np.float64)}\")\n", - "\n", - "# Ravel return a contiguous flattened array.\n", - "print(f\"Flatten the matrix:{np.ravel(a)}\")\n", - "# It is the same as reshaping the matrix into a one-dimensional array\n", - "print(f\"Reshape the matrix to a one-dim array:{a.reshape(-1)}\")\n", - "# ‘C’ means to index the elements in row-major, C-style order, with the last axis index changing fastest, back to the first axis index changing slowest.\n", - "# ‘F’ means to index the elements in column-major, Fortran-style order, with the first index changing fastest, and the last index changing slowest \n", - "print(np.ravel(a, order='F'))\n", - "# When order is ‘A’, it will preserve the array’s ‘C’ or ‘F’ ordering\n", - "# ‘A’ means to read the elements in Fortran-like index order if a is Fortran contiguous in memory, C-like order otherwise.\n", - "# ‘K’ means to read the elements in the order they occur in memory, except for reversing the data when strides are negative. By default, ‘C’ index order is used.\n", - "# Transposing it\n", - "print(np.ravel(a.T))\n", - "print(np.ravel(a.T, order='A'))" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Gaussian Elimination\n", - "\n", - "We start with the linear set of equations" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbf{A}\\mathbf{x} = \\mathbf{w}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We assume also that the matrix $\\mathbf{A}$ is non-singular and that the\n", - "matrix elements along the diagonal satisfy $a_{ii} \\ne 0$. Simple $4\\times 4 $ example" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{bmatrix}\n", - " a_{11}& a_{12} &a_{13}& a_{14}\\\\\n", - " a_{21}& a_{22} &a_{23}& a_{24}\\\\\n", - " a_{31}& a_{32} &a_{33}& a_{34}\\\\\n", - " a_{41}& a_{42} &a_{43}& a_{44}\\\\\n", - " \\end{bmatrix} \\begin{bmatrix}\n", - " x_1\\\\\n", - " x_2\\\\\n", - " x_3 \\\\\n", - " x_4 \\\\\n", - " \\end{bmatrix}\n", - " =\\begin{bmatrix}\n", - " w_1\\\\\n", - " w_2\\\\\n", - " w_3 \\\\\n", - " w_4\\\\\n", - " \\end{bmatrix}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "or" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "a_{11}x_1 +a_{12}x_2 +a_{13}x_3 + a_{14}x_4=w_1 \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "a_{21}x_1 + a_{22}x_2 + a_{23}x_3 + a_{24}x_4=w_2 \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "a_{31}x_1 + a_{32}x_2 + a_{33}x_3 + a_{34}x_4=w_3 \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "a_{41}x_1 + a_{42}x_2 + a_{43}x_3 + a_{44}x_4=w_4. \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The basic idea of Gaussian elimination is to use the first equation to eliminate the first unknown $x_1$\n", - "from the remaining $n-1$ equations. Then we use the new second equation to eliminate the second unknown\n", - "$x_2$ from the remaining $n-2$ equations. With $n-1$ such eliminations\n", - "we obtain a so-called upper triangular set of equations of the form" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "b_{11}x_1 +b_{12}x_2 +b_{13}x_3 + b_{14}x_4=y_1 \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "b_{22}x_2 + b_{23}x_3 + b_{24}x_4=y_2 \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "b_{33}x_3 + b_{34}x_4=y_3 \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "b_{44}x_4=y_4. \\nonumber\n", - "\\label{eq:gaussbacksub} \\tag{1}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We can solve this system of equations recursively starting from $x_n$ (in our case $x_4$) and proceed with\n", - "what is called a backward substitution. \n", - "\n", - "\n", - "This process can be expressed mathematically as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - " x_m = \\frac{1}{b_{mm}}\\left(y_m-\\sum_{k=m+1}^nb_{mk}x_k\\right)\\quad m=n-1,n-2,\\dots,1.\n", - "\\label{_auto1} \\tag{2}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "To arrive at such an upper triangular system of equations, we start by eliminating\n", - "the unknown $x_1$ for $j=2,n$. We achieve this by multiplying the first equation by $a_{j1}/a_{11}$ and then subtract\n", - "the result from the $j$th equation. We assume obviously that $a_{11}\\ne 0$ and that\n", - "$\\mathbf{A}$ is not singular.\n", - "\n", - "\n", - "Our actual $4\\times 4$ example reads after the first operation" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{bmatrix}\n", - " a_{11}& a_{12} &a_{13}& a_{14}\\\\\n", - " 0& (a_{22}-\\frac{a_{21}a_{12}}{a_{11}}) &(a_{23}-\\frac{a_{21}a_{13}}{a_{11}}) & (a_{24}-\\frac{a_{21}a_{14}}{a_{11}})\\\\\n", - "0& (a_{32}-\\frac{a_{31}a_{12}}{a_{11}})& (a_{33}-\\frac{a_{31}a_{13}}{a_{11}})& (a_{34}-\\frac{a_{31}a_{14}}{a_{11}})\\\\\n", - "0&(a_{42}-\\frac{a_{41}a_{12}}{a_{11}}) &(a_{43}-\\frac{a_{41}a_{13}}{a_{11}}) & (a_{44}-\\frac{a_{41}a_{14}}{a_{11}}) \\\\\n", - " \\end{bmatrix} \\begin{bmatrix}\n", - " x_1\\\\\n", - " x_2\\\\\n", - " x_3 \\\\\n", - " x_4 \\\\\n", - " \\end{bmatrix} \n", - " =\\begin{bmatrix}\n", - " y_1\\\\\n", - " w_2^{(2)}\\\\\n", - " w_3^{(2)} \\\\\n", - " w_4^{(2)}\\\\\n", - " \\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "or" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "b_{11}x_1 +b_{12}x_2 +b_{13}x_3 + b_{14}x_4=y_1 \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "a^{(2)}_{22}x_2 + a^{(2)}_{23}x_3 + a^{(2)}_{24}x_4=w^{(2)}_2 \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "a^{(2)}_{32}x_2 + a^{(2)}_{33}x_3 + a^{(2)}_{34}x_4=w^{(2)}_3 \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "a^{(2)}_{42}x_2 + a^{(2)}_{43}x_3 + a^{(2)}_{44}x_4=w^{(2)}_4, \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation} \n", - "\\label{_auto2} \\tag{3}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The new coefficients are" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - " b_{1k} = a_{1k}^{(1)} \\quad k=1,\\dots,n,\n", - "\\label{_auto3} \\tag{4}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where each $a_{1k}^{(1)}$ is equal to the original $a_{1k}$ element. The other coefficients are" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - "a_{jk}^{(2)} = a_{jk}^{(1)}-\\frac{a_{j1}^{(1)}a_{1k}^{(1)}}{a_{11}^{(1)}} \\quad j,k=2,\\dots,n,\n", - "\\label{_auto4} \\tag{5}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with a new right-hand side given by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - "y_{1}=w_1^{(1)}, \\quad w_j^{(2)} =w_j^{(1)}-\\frac{a_{j1}^{(1)}w_1^{(1)}}{a_{11}^{(1)}} \\quad j=2,\\dots,n.\n", - "\\label{_auto5} \\tag{6}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We have also set $w_1^{(1)}=w_1$, the original vector element.\n", - "We see that the system of unknowns $x_1,\\dots,x_n$ is transformed into an $(n-1)\\times (n-1)$ problem.\n", - "\n", - "\n", - "\n", - "This step is called forward substitution.\n", - "Proceeding with these substitutions, we obtain the\n", - "general expressions for the new coefficients" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - " a_{jk}^{(m+1)} = a_{jk}^{(m)}-\\frac{a_{jm}^{(m)}a_{mk}^{(m)}}{a_{mm}^{(m)}} \\quad j,k=m+1,\\dots,n,\n", - "\\label{_auto6} \\tag{7}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with $m=1,\\dots,n-1$ and a\n", - "right-hand side given by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - " w_j^{(m+1)} =w_j^{(m)}-\\frac{a_{jm}^{(m)}w_m^{(m)}}{a_{mm}^{(m)}}\\quad j=m+1,\\dots,n.\n", - "\\label{_auto7} \\tag{8}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "This set of $n-1$ elimations leads us to an equations which is solved by back substitution.\n", - "If the arithmetics is exact and the matrix $\\mathbf{A}$ is not singular, then the computed answer will be exact.\n", - "\n", - "Even though the matrix elements along the diagonal are not zero,\n", - "numerically small numbers may appear and subsequent divisions may lead to large numbers, which, if added\n", - "to a small number may yield losses of precision. Suppose for example that our first division in $(a_{22}-a_{21}a_{12}/a_{11})$\n", - "results in $-10^{-7}$ and that $a_{22}$ is one.\n", - "one. We are then\n", - "adding $10^7+1$. With single precision this results in $10^7$.\n", - "\n", - "\n", - "\n", - "\n", - " * Gaussian elimination, $O(2/3n^3)$ flops, general matrix\n", - "\n", - " * LU decomposition, upper triangular and lower tridiagonal matrices, $O(2/3n^3)$ flops, general matrix. Get easily the inverse, determinant and can solve linear equations with back-substitution only, $O(n^2)$ flops\n", - "\n", - " * Cholesky decomposition. Real symmetric or hermitian positive definite matrix, $O(1/3n^3)$ flops.\n", - "\n", - " * Tridiagonal linear systems, important for differential equations. Normally positive definite and non-singular. $O(8n)$ flops for symmetric. Special case of banded matrices.\n", - "\n", - " * Singular value decomposition\n", - "\n", - " * the QR method will be discussed in chapter 7 in connection with eigenvalue systems. $O(4/3n^3)$ flops.\n", - "\n", - "The LU decomposition method means that we can rewrite\n", - "this matrix as the product of two matrices $\\mathbf{L}$ and $\\mathbf{U}$\n", - "where" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{bmatrix}\n", - " a_{11} & a_{12} & a_{13} & a_{14} \\\\\n", - " a_{21} & a_{22} & a_{23} & a_{24} \\\\\n", - " a_{31} & a_{32} & a_{33} & a_{34} \\\\\n", - " a_{41} & a_{42} & a_{43} & a_{44}\n", - " \\end{bmatrix}\n", - " = \\begin{bmatrix}\n", - " 1 & 0 & 0 & 0 \\\\\n", - " l_{21} & 1 & 0 & 0 \\\\\n", - " l_{31} & l_{32} & 1 & 0 \\\\\n", - " l_{41} & l_{42} & l_{43} & 1\n", - " \\end{bmatrix}\n", - " \\begin{bmatrix}\n", - " u_{11} & u_{12} & u_{13} & u_{14} \\\\\n", - " 0 & u_{22} & u_{23} & u_{24} \\\\\n", - " 0 & 0 & u_{33} & u_{34} \\\\\n", - " 0 & 0 & 0 & u_{44}\n", - " \\end{bmatrix}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "LU decomposition forms the backbone of other algorithms in linear algebra, such as the\n", - "solution of linear equations given by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "a_{11}x_1 +a_{12}x_2 +a_{13}x_3 + a_{14}x_4=w_1 \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "a_{21}x_1 + a_{22}x_2 + a_{23}x_3 + a_{24}x_4=w_2 \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "a_{31}x_1 + a_{32}x_2 + a_{33}x_3 + a_{34}x_4=w_3 \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "a_{41}x_1 + a_{42}x_2 + a_{43}x_3 + a_{44}x_4=w_4. \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The above set of equations is conveniently solved by using LU decomposition as an intermediate step.\n", - "\n", - "The matrix $\\mathbf{A}\\in \\mathbb{R}^{n\\times n}$ has an LU factorization if the determinant\n", - "is different from zero. If the LU factorization exists and $\\mathbf{A}$ is non-singular, then the LU factorization\n", - "is unique and the determinant is given by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "det\\{\\mathbf{A}\\}=det\\{\\mathbf{LU}\\}= det\\{\\mathbf{L}\\}det\\{\\mathbf{U}\\}=u_{11}u_{22}\\dots u_{nn}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "There are at least three main advantages with LU decomposition compared with standard Gaussian elimination:\n", - "\n", - " * It is straightforward to compute the determinant of a matrix\n", - "\n", - " * If we have to solve sets of linear equations with the same matrix but with different vectors $\\mathbf{y}$, the number of FLOPS is of the order $n^3$.\n", - "\n", - " * The inverse is such an operation \n", - "\n", - "With the LU decomposition it is rather\n", - "simple to solve a system of linear equations" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "a_{11}x_1 +a_{12}x_2 +a_{13}x_3 + a_{14}x_4=w_1 \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "a_{21}x_1 + a_{22}x_2 + a_{23}x_3 + a_{24}x_4=w_2 \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "a_{31}x_1 + a_{32}x_2 + a_{33}x_3 + a_{34}x_4=w_3 \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "a_{41}x_1 + a_{42}x_2 + a_{43}x_3 + a_{44}x_4=w_4. \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "This can be written in matrix form as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbf{Ax}=\\mathbf{w}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $\\mathbf{A}$ and $\\mathbf{w}$ are known and we have to solve for\n", - "$\\mathbf{x}$. Using the LU dcomposition we write" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbf{A} \\mathbf{x} \\equiv \\mathbf{L} \\mathbf{U} \\mathbf{x} =\\mathbf{w}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The previous equation can be calculated in two steps" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbf{L} \\mathbf{y} = \\mathbf{w};\\qquad \\mathbf{Ux}=\\mathbf{y}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "To show that this is correct we use to the LU decomposition\n", - "to rewrite our system of linear equations as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbf{LUx}=\\mathbf{w},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and since the determinant of $\\mathbf{L}$ is equal to 1 (by construction\n", - "since the diagonals of $\\mathbf{L}$ equal 1) we can use the inverse of\n", - "$\\mathbf{L}$ to obtain" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbf{Ux}=\\mathbf{L^{-1}w}=\\mathbf{y},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which yields the intermediate step" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbf{L^{-1}w}=\\mathbf{y}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and as soon as we have $\\mathbf{y}$ we can obtain $\\mathbf{x}$\n", - "through $\\mathbf{Ux}=\\mathbf{y}$.\n", - "\n", - "\n", - "For our four-dimentional example this takes the form" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "y_1=w_1 \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "l_{21}y_1 + y_2=w_2\\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "l_{31}y_1 + l_{32}y_2 + y_3 =w_3\\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "l_{41}y_1 + l_{42}y_2 + l_{43}y_3 + y_4=w_4. \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "u_{11}x_1 +u_{12}x_2 +u_{13}x_3 + u_{14}x_4=y_1 \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "u_{22}x_2 + u_{23}x_3 + u_{24}x_4=y_2\\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "u_{33}x_3 + u_{34}x_4=y_3\\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "u_{44}x_4=y_4 \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "This example shows the basis for the algorithm\n", - "needed to solve the set of $n$ linear equations.\n", - "\n", - "\n", - "\n", - "The algorithm goes as follows\n", - "\n", - " * Set up the matrix $\\bf A$ and the vector $\\bf w$ with their correct dimensions. This determines the dimensionality of the unknown vector $\\bf x$.\n", - "\n", - " * Then LU decompose the matrix $\\bf A$ through a call to the function `ludcmp(double a, int n, int indx, double &d)`. This functions returns the LU decomposed matrix $\\bf A$, its determinant and the vector indx which keeps track of the number of interchanges of rows. If the determinant is zero, the solution is malconditioned.\n", - "\n", - " * Thereafter you call the function `lubksb(double a, int n, int indx, double w)` which uses the LU decomposed matrix $\\bf A$ and the vector $\\bf w$ and returns $\\bf x$ in the same place as $\\bf w$. Upon exit the original content in $\\bf w$ is destroyed. If you wish to keep this information, you should make a backup of it in your calling function.\n", - "\n", - "### LU Decomposition, the inverse of a matrix\n", - "\n", - "If the inverse exists then" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbf{A}^{-1}\\mathbf{A}=\\mathbf{I},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "the identity matrix. With an LU decomposed matrix we can rewrite the last equation as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbf{LU}\\mathbf{A}^{-1}=\\mathbf{I}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "If we assume that the first column (that is column 1) of the inverse matrix\n", - "can be written as a vector with unknown entries" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbf{A}_1^{-1}= \\begin{bmatrix}\n", - " a_{11}^{-1} \\\\\n", - " a_{21}^{-1} \\\\\n", - " \\dots \\\\\n", - " a_{n1}^{-1} \\\\\n", - " \\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "then we have a linear set of equations" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbf{LU}\\begin{bmatrix}\n", - " a_{11}^{-1} \\\\\n", - " a_{21}^{-1} \\\\\n", - " \\dots \\\\\n", - " a_{n1}^{-1} \\\\\n", - " \\end{bmatrix} =\\begin{bmatrix}\n", - " 1 \\\\\n", - " 0 \\\\\n", - " \\dots \\\\\n", - " 0 \\\\\n", - " \\end{bmatrix}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In a similar way we can compute the unknow entries of the second column," - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbf{LU}\\begin{bmatrix}\n", - " a_{12}^{-1} \\\\\n", - " a_{22}^{-1} \\\\\n", - " \\dots \\\\\n", - " a_{n2}^{-1} \\\\\n", - " \\end{bmatrix}=\\begin{bmatrix}\n", - " 0 \\\\\n", - " 1 \\\\\n", - " \\dots \\\\\n", - " 0 \\\\\n", - " \\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and continue till we have solved all $n$ sets of linear equations." - ] - } - ], - "metadata": {}, - "nbformat": 4, - "nbformat_minor": 4 -} diff --git a/doc/LectureNotes/_build/html/_sources/schedule.md b/doc/LectureNotes/_build/html/_sources/schedule.md deleted file mode 100644 index e65587b6a..000000000 --- a/doc/LectureNotes/_build/html/_sources/schedule.md +++ /dev/null @@ -1,182 +0,0 @@ -# Teaching schedule with links to material - - -This course will be delivered in a hybrid mode, with online lectures and on site or online laboratory sessions. - -1. Four lectures per week, Fall semester, 10 ECTS. The lectures are in person but will be recorded and linked to this site and the official University of Oslo website for the course; -2. Two hours of laboratory sessions for work on computational projects and exercises for each group. There will also be fully digital laboratory sessions for those who cannot attend; -3. Three projects which are graded and count 1/3 each of the final grade. The deadlines for the projects are October 11 for project 1, November 15 for project 2 and December 13 for project 3. -4. A selected number of weekly assignments; -5. The course is part of the CS Master of Science program, but is open to other bachelor and Master of Science students at the University of Oslo; -6. The course is offered as a FYS-MAT4155 (Master of Science level) and a FYS-MAT3155 (senior undergraduate) course; -7. Videos of teaching material are available via the links at https://compphysics.github.io/MachineLearning/doc/web/course.html; -8. Weekly emails with summary of activities will be mailed to all participants; - - - -## Weekly Schedule - -For the reading assignments we use the following abbreviations: -- GBC: Goodfellow, Bengio, and Courville, Deep Learning -- CMB: Christopher M. Bishop, Pattern Recognition and Machine Learning -- HTF: Hastie, Tibshirani, and Friedman, The Elements of Statistical Learning -- AG: Aurelien Geron, Hands‑On Machine Learning with Scikit‑Learn and TensorFlow - -### Week 34 August 23-27 -- Lab Wednesday: Introduction to software and repetition of Python Programming -- Lecture Thursday: Introduction to the course, what is Machine Learning and introduction to Linear Regression. -- Video of Lecture August 26, 2021 at https://www.uio.no/studier/emner/matnat/fys/FYS-STK4155/h21/forelesningsvideoer/LectureThursdayAugust26.mp4?vrtx=view-as-webpage -- Lecture Friday: Basics of Linear Regression -- Video of Lecture August 27, 2021 at https://www.uio.no/studier/emner/matnat/fys/FYS-STK4155/h21/forelesningsvideoer/LectureThursdayAugust27.mp4?vrtx=view-as-webpage - -- Reading recommendations: - - Refresh linear algebra, GBC chapters 1 and 2. - - CMB sections 1.1 and 3.1. - - HTF chapters 2 and 3. - - See lecture notes for week 34 at https://compphysics.github.io/MachineLearning/doc/web/course.html - -### Week 35 August 30-September 3 -- Lab Wednesday: Work on exercises 1-3 for week 35 -- Thursday: Review of ordinary Least Squares with applications and discussion of Ridge Regression and Singular Value Decomposition -- Video of lecture Thursday at https://www.uio.no/studier/emner/matnat/fys/FYS-STK3155/h21/forelesningsvideoer/LectureSeptember2.mp4?vrtx=view-as-webpage. -- Friday: Analysis of Ridge and Lasso Regression and links with Singular Value Decomposition -- Video of lecture Friday at https://www.uio.no/studier/emner/matnat/fys/FYS-STK3155/h21/forelesningsvideoer/LectureSeptember3.mp4?vrtx=view-as-webpage - -- Reading recommendations: - - See lecture notes for week 35 at https://compphysics.github.io/MachineLearning/doc/web/course.html. - - HTF chapter 3. GBC chapters 1 and and sections 3.1-3.11 and 5.1 - - CMB sections 1.1 and 3.1 - - -### Week 36 September 6-10 -- Lab Wednesday: Exercises 1 and 2 from week 36 -- Lecture Thursday: Summary from last week on SVD, Statistics, probability theory and linear regression -- Video of Lecture https://www.uio.no/studier/emner/matnat/fys/FYS-STK3155/h21/forelesningsvideoer/LectureSeptember9.mp4?vrtx=view-as-webpage -- Friday: Linear Regression and links with Statistics, Resampling methods and presentation of first project. -- Video of Lecture at https://www.uio.no/studier/emner/matnat/fys/FYS-STK4155/h21/forelesningsvideoer/LectureSeptember10.mp4?vrtx=view-as-webpage - -- Reading recommendations: - - Lectures on Regression for week 36 at https://compphysics.github.io/MachineLearning/doc/web/course.html. - - Bishop 1.1, 1.2, 2.1, 2.2, 2.3 and 3.1 - - Hastie et al chapter 3 - -### Week 37 September 13-17 -- Lab Wednesday: Work on Project 1 -- Lecture Thursday: Resampling methods, cross-validation and Bootstrap - - Thursday September 16: Summary of Ridge and Lasso with examples and start resampling techniques - - Video of Lecture, first part at https://www.uio.no/studier/emner/matnat/fys/FYS-STK3155/h21/forelesningsvideoer/LectureSeptember16Firstpart.mp4?vrtx=view-as-webpage" - - Video of Lecture, second part at https://www.uio.no/studier/emner/matnat/fys/FYS-STK3155/h21/forelesningsvideoer/LectureSeptember16SecondPart.mp4?vrtx=view-as-webpage -- Lecture Friday: More on Resampling methods and summary of linear regression - - Video of Lecture at https://www.uio.no/studier/emner/matnat/fys/FYS-STK3155/h21/forelesningsvideoer/LectureSeptember17.mp4?vrtx=view-as-webpage -- Reading recommendations: - - Lectures on Resampling methods for week 37 at https://compphysics.github.io/MachineLearning/doc/web/course.html. - - Bishop 1.3 (cross-validation) and 3.2 (bias-variance tradeoff) - - Hastie et al Chapter 7, here we recommend 7.1-7.5 and 7.10 (cross-validation) and 7.11 (bootstrap) - - Goodfellow et al discuss some of these topics in sections 5.2-5.5. - - -### Week 38 September 20-24 -- Lab Wednesday: Work on Project 1 -- Lecture Thursday: Classification problems and Logistic Regression, from binary cases to several categories - - Video of Lecture at https://www.uio.no/studier/emner/matnat/fys/FYS-STK4155/h21/forelesningsvideoer/LectureSeptember23.mp4?vrtx=view-as-webpage -- Lecture Friday: Logistic Regression and gradient optimization - - Video of Lecture at https://www.uio.no/studier/emner/matnat/fys/FYS-STK3155/h21/forelesningsvideoer/LectureSeptember24.mp4?vrtx=view-as-webpage -- Reading recommendations: - - See lecture notes for week 38 at https://compphysics.github.io/MachineLearning/doc/web/course.html. - - Bishop 4.1, 4.2 and 4.3. Not all the material is relevant or will be covered. Section 4.3 is the most relevant, but 4.1 and 4.2 give interesting background readings for logistic regression - - Hastie et al 4.1, 4.2 and 4.3 on logistic regression - - For a good discussion on gradient methods, see Goodfellow et al section 4.3-4.5 and chapter 8. We will come back to the latter chapter in our discussion of Neural networks as well. - -### Week 39 September 27- October 1 -- Lab Wednesday: Work on Project 1 -- Lecture Thursday: Gradient Optimization methods - - Video of Lecture at https://www.uio.no/studier/emner/matnat/fys/FYS-STK3155/h21/forelesningsvideoer/LectureSeptember30.mp4?vrtx=view-as-webpage -- Lecture Friday: Gradient methods - - Video of Lecture at https://www.uio.no/studier/emner/matnat/fys/FYS-STK3155/h21/forelesningsvideoer/LectureOctober1.mp4?vrtx=view-as-webpage -- Reading recommendations: - - See lecture notes for week 39 at https://compphysics.github.io/MachineLearning/doc/web/course.html. - - For a good discussion on gradient methods, see Goodfellow et al section 4.3-4.5 and chapter 8. We will come back to the latter chapter in our discussion of Neural networks as well. - - - -### Week 40 October 4-8 -- Lab Wednesday: Wrap up project 1 -- Lecture Thursday: Stochastic gradient descent, automatic differentiation and start discussion of feed-forward Neural Network code for regression and classification - - Video of Lecture at https://www.uio.no/studier/emner/matnat/fys/FYS-STK3155/h21/forelesningsvideoer/LectureOctober7.mp4?vrtx=view-as-webpage -- Lecture Friday: Deep Learning and Neural Networks: the back propagation algorithm - - Video of Lecture at https://www.uio.no/studier/emner/matnat/fys/FYS-STK3155/h21/forelesningsvideoer/LectureOctober8.mp4?vrtx=view-as-webpage -- Reading recommendations: - - See lecture notes for week 40 at https://compphysics.github.io/MachineLearning/doc/web/course.html. - - For neural networks we recommend Goodfellow et al chapters 6 and 7 and Bishop 5.1-5.4 - - For stochastic gradient descent we recommend Goodfellow et al chapter 8 - -### Week 41 October 11-15 -- Lab Wednesday: Work on project 2 -- Lecture Thursday: Deep learning and Neural Networks, developing a code for Neural Networks - - Video of Lecture at https://www.uio.no/studier/emner/matnat/fys/FYS-STK3155/h21/forelesningsvideoer/LectureOctober14.mp4?vrtx=view-as-webpage -- Lecture Friday: Tensorflow and the mathematics of neural network - - Video of Lecture at https://www.uio.no/studier/emner/matnat/fys/FYS-STK4155/h21/forelesningsvideoer/LectureOctober15.mp4?vrtx=view-as-webpage -- Reading recommendations: - - See lecture notes for week 41 at https://compphysics.github.io/MachineLearning/doc/web/course.html. - - For neural networks we recommend Goodfellow et al chapters 6 and 7. For CNNs, see Goodfellow et al chapter 9. chapter 11 and 12 on practicalities and applications - - -### Week 42 October 18-22 -- Lab Wednesday: Work on project 2 -- Lecture Thursday: Solving differential equations with neural networks and start Convolutional Neural Networks and classification problems - - Video of Lecture at https://www.uio.no/studier/emner/matnat/fys/FYS-STK3155/h21/forelesningsvideoer/LectureOctober21.mp4?vrtx=view-as-webpage -- Lecture Friday: Convolutional Neural Networks and classification problems - - Video of Lecture at https://www.uio.no/studier/emner/matnat/fys/FYS-STK4155/h21/forelesningsvideoer/LectureOctober22.mp4?vrtx=view-as-webpage -- Reading recommendations: - - See lecture notes for week 42 at https://compphysics.github.io/MachineLearning/doc/web/course.html. - - For neural networks we recommend Goodfellow et al chapters 6 and 7. For CNNs, see Goodfellow et al chapter 9. See also chapter 11 and 12 on practicalities and applications - -### Week 43 October 25-29 -- Lab Wednesday: Work on project 2 -- Lecture Thursday: Recurrent Neural Networks -- Lecture Friday: Recurrent Neural Networks and principal component analysis (PCA) -- Reading recommendations: - - See lecture notes for week 43 at https://compphysics.github.io/MachineLearning/doc/web/course.html. - - For RNNs, see Goodfellow et al chapter 10 and discussions in chapter 11 and 12 on practicalities and applications - - For PCA see lecture notes (jupyter book) chapter 11 and also chapter 12 on clustering. Geron's chapter 8 is also a good read. - -### Week 44 November 1-5 -- Lab Wednesday: Work on project 2 -- Lecture Thursday: Decision trees, classification and regression -- Lecture Friday: Decision trees, basic algorithms -- Reading recommendations: - - See lecture notes for week 44 at https://compphysics.github.io/MachineLearning/doc/web/course.html. - - Hastie et al sections 9.1 and 9.2 - -### Week 45 November 8-12 -- Lab Wednesday: Work on project 2 and start project 3 -- Lecture Thursday: Ensemble methods, bagging and random forests -- Lecture Friday: Boosting and gradient boosting -- Reading recommendations: - - See lecture notes for week 45 at https://compphysics.github.io/MachineLearning/doc/web/course.html. - - Hastie et al chapter 10 - -### Week 46 November 15-19 -- Lab Wednesday: Work on project 3 -- Lecture Thursday: Support Vector machines -- Lecture Friday: Support Vector machines -- Reading recommendations: - - See lecture notes for week 46 at https://compphysics.github.io/MachineLearning/doc/web/course.html. - - Hastie et al chapter 12 - -### Week 47 November 22-26 -- Lab Wednesday: Work on project 3 -- Lecture Thursday: Unsupervised Learning, Principal Component Analysis (PCA) -- Lecture Friday: Unsupervised Learning and PCA, k-means and Clustering -- Reading recommendations: - - See lecture notes for week 47 at https://compphysics.github.io/MachineLearning/doc/web/course.html. - -### Week 48 November 29- December 2 -- Lab Wednesday: Work on project 3 -- Lecture Thursday: Unsupervised Learning and Clustering -- Lecture Friday: Summary of course -- Reading recommendations: - - See lecture notes for week 48 at https://compphysics.github.io/MachineLearning/doc/web/course.html. - - - diff --git a/doc/LectureNotes/_build/html/_sources/statistics.ipynb b/doc/LectureNotes/_build/html/_sources/statistics.ipynb deleted file mode 100644 index 8690ffe7a..000000000 --- a/doc/LectureNotes/_build/html/_sources/statistics.ipynb +++ /dev/null @@ -1,2882 +0,0 @@ -{ - "cells": [ - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "# Elements of Probability Theory and Statistical Data Analysis\n", - "\n", - "\n", - "## Domains and probabilities\n", - "Consider the following simple example, namely the tossing of two dice, resulting in the following possible values" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\{2,3,4,5,6,7,8,9,10,11,12\\}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "These values are called the *domain*. \n", - "To this domain we have the corresponding *probabilities*" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\{1/36,2/36/,3/36,4/36,5/36,6/36,5/36,4/36,3/36,2/36,1/36\\}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Tossing the dice\n", - "The numbers in the domain are the outcomes of the physical process of tossing say two dice.\n", - "We cannot tell beforehand whether the outcome is 3 or 5 or any other number in this domain.\n", - "This defines the randomness of the outcome, or unexpectedness or any other synonimous word which\n", - "encompasses the uncertitude of the final outcome. \n", - "\n", - "The only thing we can tell beforehand\n", - "is that say the outcome 2 has a certain probability. \n", - "If our favorite hobby is to spend an hour every evening throwing dice and \n", - "registering the sequence of outcomes, we will note that the numbers in the above domain" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\{2,3,4,5,6,7,8,9,10,11,12\\},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "appear in a random order. After 11 throws the results may look like" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\{10,8,6,3,6,9,11,8,12,4,5\\}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Stochastic variables\n", - "\n", - "**Random variables are characterized by a domain which contains all possible values that the random value may take. This domain has a corresponding probability distribution function(PDF)**.\n", - "\n", - "\n", - "\n", - "\n", - "## Stochastic variables and the main concepts, the discrete case\n", - "There are two main concepts associated with a stochastic variable. The\n", - "*domain* is the set $\\mathbb D = \\{x\\}$ of all accessible values\n", - "the variable can assume, so that $X \\in \\mathbb D$. An example of a\n", - "discrete domain is the set of six different numbers that we may get by\n", - "throwing of a dice, $x\\in\\{1,\\,2,\\,3,\\,4,\\,5,\\,6\\}$.\n", - "\n", - "The *probability distribution function (PDF)* is a function\n", - "$p(x)$ on the domain which, in the discrete case, gives us the\n", - "probability or relative frequency with which these values of $X$\n", - "occur" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(x) = \\mathrm{Prob}(X=x).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Stochastic variables and the main concepts, the continuous case\n", - "In the continuous case, the PDF does not directly depict the\n", - "actual probability. Instead we define the probability for the\n", - "stochastic variable to assume any value on an infinitesimal interval\n", - "around $x$ to be $p(x)dx$. The continuous function $p(x)$ then gives us\n", - "the *density* of the probability rather than the probability\n", - "itself. The probability for a stochastic variable to assume any value\n", - "on a non-infinitesimal interval $[a,\\,b]$ is then just the integral" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathrm{Prob}(a\\leq X\\leq b) = \\int_a^b p(x)dx.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Qualitatively speaking, a stochastic variable represents the values of\n", - "numbers chosen as if by chance from some specified PDF so that the\n", - "selection of a large set of these numbers reproduces this PDF.\n", - "\n", - "\n", - "\n", - "\n", - "## The cumulative probability\n", - "Of interest to us is the *cumulative probability\n", - "distribution function* (**CDF**), $P(x)$, which is just the probability\n", - "for a stochastic variable $X$ to assume any value less than $x$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "P(x)=\\mathrm{Prob(}X\\leq x\\mathrm{)} =\n", - "\\int_{-\\infty}^x p(x^{\\prime})dx^{\\prime}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The relation between a CDF and its corresponding PDF is then" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(x) = \\frac{d}{dx}P(x).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Properties of PDFs\n", - "\n", - "There are two properties that all PDFs must satisfy. The first one is\n", - "positivity (assuming that the PDF is normalized)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "0 \\leq p(x) \\leq 1.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Naturally, it would be nonsensical for any of the values of the domain\n", - "to occur with a probability greater than $1$ or less than $0$. Also,\n", - "the PDF must be normalized. That is, all the probabilities must add up\n", - "to unity. The probability of \"anything\" to happen is always unity. For\n", - "both discrete and continuous PDFs, this condition is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{align*}\n", - "\\sum_{x_i\\in\\mathbb D} p(x_i) & = 1,\\\\\n", - "\\int_{x\\in\\mathbb D} p(x)\\,dx & = 1.\n", - "\\end{align*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Important distributions, the uniform distribution\n", - "The first one\n", - "is the most basic PDF; namely the uniform distribution" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - "p(x) = \\frac{1}{b-a}\\theta(x-a)\\theta(b-x).\n", - "\\label{eq:unifromPDF} \\tag{1}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "For $a=0$ and $b=1$ we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{array}{ll}\n", - "p(x)dx = dx & \\in [0,1].\n", - "\\end{array}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The latter distribution is used to generate random numbers. For other PDFs, one needs normally a mapping from this distribution to say for example the exponential distribution.\n", - "\n", - "\n", - "\n", - "\n", - "## Gaussian distribution\n", - "The second one is the Gaussian Distribution" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(x) = \\frac{1}{\\sigma\\sqrt{2\\pi}} \\exp{(-\\frac{(x-\\mu)^2}{2\\sigma^2})},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with mean value $\\mu$ and standard deviation $\\sigma$. If $\\mu=0$ and $\\sigma=1$, it is normally called the **standard normal distribution**" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(x) = \\frac{1}{\\sqrt{2\\pi}} \\exp{(-\\frac{x^2}{2})},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The following simple Python code plots the above distribution for different values of $\\mu$ and $\\sigma$." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "%matplotlib inline\n", - "\n", - "import numpy as np\n", - "from math import acos, exp, sqrt\n", - "from matplotlib import pyplot as plt\n", - "from matplotlib import rc, rcParams\n", - "import matplotlib.units as units\n", - "import matplotlib.ticker as ticker\n", - "rc('text',usetex=True)\n", - "rc('font',**{'family':'serif','serif':['Gaussian distribution']})\n", - "font = {'family' : 'serif',\n", - " 'color' : 'darkred',\n", - " 'weight' : 'normal',\n", - " 'size' : 16,\n", - " }\n", - "pi = acos(-1.0)\n", - "mu0 = 0.0\n", - "sigma0 = 1.0\n", - "mu1= 1.0\n", - "sigma1 = 2.0\n", - "mu2 = 2.0\n", - "sigma2 = 4.0\n", - "\n", - "x = np.linspace(-20.0, 20.0)\n", - "v0 = np.exp(-(x*x-2*x*mu0+mu0*mu0)/(2*sigma0*sigma0))/sqrt(2*pi*sigma0*sigma0)\n", - "v1 = np.exp(-(x*x-2*x*mu1+mu1*mu1)/(2*sigma1*sigma1))/sqrt(2*pi*sigma1*sigma1)\n", - "v2 = np.exp(-(x*x-2*x*mu2+mu2*mu2)/(2*sigma2*sigma2))/sqrt(2*pi*sigma2*sigma2)\n", - "plt.plot(x, v0, 'b-', x, v1, 'r-', x, v2, 'g-')\n", - "plt.title(r'{\\bf Gaussian distributions}', fontsize=20)\n", - "plt.text(-19, 0.3, r'Parameters: $\\mu = 0$, $\\sigma = 1$', fontdict=font)\n", - "plt.text(-19, 0.18, r'Parameters: $\\mu = 1$, $\\sigma = 2$', fontdict=font)\n", - "plt.text(-19, 0.08, r'Parameters: $\\mu = 2$, $\\sigma = 4$', fontdict=font)\n", - "plt.xlabel(r'$x$',fontsize=20)\n", - "plt.ylabel(r'$p(x)$ [MeV]',fontsize=20)\n", - "\n", - "# Tweak spacing to prevent clipping of ylabel \n", - "plt.subplots_adjust(left=0.15)\n", - "plt.savefig('gaussian.pdf', format='pdf')\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Exponential distribution\n", - "Another important distribution in science is the exponential distribution" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(x) = \\alpha\\exp{-(\\alpha x)}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Expectation values\n", - "Let $h(x)$ be an arbitrary continuous function on the domain of the stochastic\n", - "variable $X$ whose PDF is $p(x)$. We define the *expectation value*\n", - "of $h$ with respect to $p$ as follows" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - "\\langle h \\rangle_X \\equiv \\int\\! h(x)p(x)\\,dx\n", - "\\label{eq:expectation_value_of_h_wrt_p} \\tag{2}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Whenever the PDF is known implicitly, like in this case, we will drop\n", - "the index $X$ for clarity. \n", - "A particularly useful class of special expectation values are the\n", - "*moments*. The $n$-th moment of the PDF $p$ is defined as\n", - "follows" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\langle x^n \\rangle \\equiv \\int\\! x^n p(x)\\,dx\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Stochastic variables and the main concepts, mean values\n", - "The zero-th moment $\\langle 1\\rangle$ is just the normalization condition of\n", - "$p$. The first moment, $\\langle x\\rangle$, is called the *mean* of $p$\n", - "and often denoted by the letter $\\mu$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\langle x\\rangle = \\mu \\equiv \\int x p(x)dx,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "for a continuous distribution and" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\langle x\\rangle = \\mu \\equiv \\sum_{i=1}^N x_i p(x_i),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "for a discrete distribution. \n", - "Qualitatively it represents the centroid or the average value of the\n", - "PDF and is therefore simply called the expectation value of $p(x)$.\n", - "\n", - "\n", - "\n", - "\n", - "## Stochastic variables and the main concepts, central moments, the variance\n", - "\n", - "A special version of the moments is the set of *central moments*, the n-th central moment defined as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\langle (x-\\langle x\\rangle )^n\\rangle \\equiv \\int\\! (x-\\langle x\\rangle)^n p(x)\\,dx\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The zero-th and first central moments are both trivial, equal $1$ and\n", - "$0$, respectively. But the second central moment, known as the\n", - "*variance* of $p$, is of particular interest. For the stochastic\n", - "variable $X$, the variance is denoted as $\\sigma^2_X$ or $\\mathrm{Var}(X)$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{align*}\n", - "\\sigma^2_X &=\\mathrm{Var}(X) = \\langle (x-\\langle x\\rangle)^2\\rangle =\n", - "\\int (x-\\langle x\\rangle)^2 p(x)dx\\\\\n", - "& = \\int\\left(x^2 - 2 x \\langle x\\rangle^{2} +\\langle x\\rangle^2\\right)p(x)dx\\\\\n", - "& = \\langle x^2\\rangle - 2 \\langle x\\rangle\\langle x\\rangle + \\langle x\\rangle^2\\\\\n", - "& = \\langle x^2 \\rangle - \\langle x\\rangle^2\n", - "\\end{align*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The square root of the variance, $\\sigma =\\sqrt{\\langle (x-\\langle x\\rangle)^2\\rangle}$ is called the \n", - "**standard deviation** of $p$. It is the RMS (root-mean-square)\n", - "value of the deviation of the PDF from its mean value, interpreted\n", - "qualitatively as the \"spread\" of $p$ around its mean.\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "## Probability Distribution Functions\n", - "\n", - "The following table collects properties of probability distribution functions.\n", - "In our notation we reserve the label $p(x)$ for the probability of a certain event,\n", - "while $P(x)$ is the cumulative probability. \n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "
Discrete PDF Continuous PDF
Domain $\\left\\{x_1, x_2, x_3, \\dots, x_N\\right\\}$ $[a,b]$
Probability $p(x_i)$ $p(x)dx$
Cumulative $P_i=\\sum_{l=1}^ip(x_l)$ $P(x)=\\int_a^xp(t)dt$
Positivity $0 \\le p(x_i) \\le 1$ $p(x) \\ge 0$
Positivity $0 \\le P_i \\le 1$ $0 \\le P(x) \\le 1$
Monotonic $P_i \\ge P_j$ if $x_i \\ge x_j$ $P(x_i) \\ge P(x_j)$ if $x_i \\ge x_j$
Normalization $P_N=1$ $P(b)=1$
\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "## Probability Distribution Functions\n", - "With a PDF we can compute expectation values of selected quantities such as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\langle x^k\\rangle=\\sum_{i=1}^{N}x_i^kp(x_i),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "if we have a discrete PDF or" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\langle x^k\\rangle=\\int_a^b x^kp(x)dx,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "in the case of a continuous PDF. We have already defined the mean value $\\mu$\n", - "and the variance $\\sigma^2$.\n", - "\n", - "\n", - "\n", - "\n", - "## The three famous Probability Distribution Functions\n", - "\n", - "There are at least three PDFs which one may encounter. These are the\n", - "\n", - "**Uniform distribution**" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(x)=\\frac{1}{b-a}\\Theta(x-a)\\Theta(b-x),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "yielding probabilities different from zero in the interval $[a,b]$.\n", - "\n", - "**The exponential distribution**" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(x)=\\alpha \\exp{(-\\alpha x)},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "yielding probabilities different from zero in the interval $[0,\\infty)$ and with mean value" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mu = \\int_0^{\\infty}xp(x)dx=\\int_0^{\\infty}x\\alpha \\exp{(-\\alpha x)}dx=\\frac{1}{\\alpha},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with variance" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\sigma^2=\\int_0^{\\infty}x^2p(x)dx-\\mu^2 = \\frac{1}{\\alpha^2}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Probability Distribution Functions, the normal distribution\n", - "Finally, we have the so-called univariate normal distribution, or just the **normal distribution**" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(x)=\\frac{1}{b\\sqrt{2\\pi}}\\exp{\\left(-\\frac{(x-a)^2}{2b^2}\\right)}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with probabilities different from zero in the interval $(-\\infty,\\infty)$.\n", - "The integral $\\int_{-\\infty}^{\\infty}\\exp{\\left(-(x^2\\right)}dx$ appears in many calculations, its value\n", - "is $\\sqrt{\\pi}$, a result we will need when we compute the mean value and the variance.\n", - "The mean value is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mu = \\int_0^{\\infty}xp(x)dx=\\frac{1}{b\\sqrt{2\\pi}}\\int_{-\\infty}^{\\infty}x \\exp{\\left(-\\frac{(x-a)^2}{2b^2}\\right)}dx,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which becomes with a suitable change of variables" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mu =\\frac{1}{b\\sqrt{2\\pi}}\\int_{-\\infty}^{\\infty}b\\sqrt{2}(a+b\\sqrt{2}y)\\exp{-y^2}dy=a.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Probability Distribution Functions, the normal distribution\n", - "Similarly, the variance becomes" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\sigma^2 = \\frac{1}{b\\sqrt{2\\pi}}\\int_{-\\infty}^{\\infty}(x-\\mu)^2 \\exp{\\left(-\\frac{(x-a)^2}{2b^2}\\right)}dx,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and inserting the mean value and performing a variable change we obtain" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\sigma^2 = \\frac{1}{b\\sqrt{2\\pi}}\\int_{-\\infty}^{\\infty}b\\sqrt{2}(b\\sqrt{2}y)^2\\exp{\\left(-y^2\\right)}dy=\n", - "\\frac{2b^2}{\\sqrt{\\pi}}\\int_{-\\infty}^{\\infty}y^2\\exp{\\left(-y^2\\right)}dy,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and performing a final integration by parts we obtain the well-known result $\\sigma^2=b^2$.\n", - "It is useful to introduce the standard normal distribution as well, defined by $\\mu=a=0$, viz. a distribution\n", - "centered around zero and with a variance $\\sigma^2=1$, leading to" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - " p(x)=\\frac{1}{\\sqrt{2\\pi}}\\exp{\\left(-\\frac{x^2}{2}\\right)}.\n", - "\\label{_auto1} \\tag{3}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Probability Distribution Functions, the cumulative distribution\n", - "\n", - "The exponential and uniform distributions have simple cumulative functions,\n", - "whereas the normal distribution does not, being proportional to the so-called\n", - "error function $erf(x)$, given by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "P(x) = \\frac{1}{\\sqrt{2\\pi}}\\int_{-\\infty}^x\\exp{\\left(-\\frac{t^2}{2}\\right)}dt,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which is difficult to evaluate in a quick way.\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "## Probability Distribution Functions, other important distribution\n", - "\n", - "Some other PDFs which one encounters often in the natural sciences are the binomial distribution" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(x) = \\left(\\begin{array}{c} n \\\\ x\\end{array}\\right)y^x(1-y)^{n-x} \\hspace{0.5cm}x=0,1,\\dots,n,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $y$ is the probability for a specific event, such as the tossing of a coin or moving left or right\n", - "in case of a random walker. Note that $x$ is a discrete stochastic variable. \n", - "\n", - "The sequence of binomial trials is characterized by the following definitions\n", - "\n", - " * Every experiment is thought to consist of $N$ independent trials.\n", - "\n", - " * In every independent trial one registers if a specific situation happens or not, such as the jump to the left or right of a random walker.\n", - "\n", - " * The probability for every outcome in a single trial has the same value, for example the outcome of tossing (either heads or tails) a coin is always $1/2$.\n", - "\n", - "\n", - "\n", - "\n", - "## Probability Distribution Functions, the binomial distribution\n", - "\n", - "In order to compute the mean and variance we need to recall Newton's binomial\n", - "formula" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "(a+b)^m=\\sum_{n=0}^m \\left(\\begin{array}{c} m \\\\ n\\end{array}\\right)a^nb^{m-n},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which can be used to show that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\sum_{x=0}^n\\left(\\begin{array}{c} n \\\\ x\\end{array}\\right)y^x(1-y)^{n-x} = (y+1-y)^n = 1,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "the PDF is normalized to one. \n", - "The mean value is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mu = \\sum_{x=0}^n x\\left(\\begin{array}{c} n \\\\ x\\end{array}\\right)y^x(1-y)^{n-x} =\n", - "\\sum_{x=0}^n x\\frac{n!}{x!(n-x)!}y^x(1-y)^{n-x},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "resulting in" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mu = \n", - "\\sum_{x=0}^n x\\frac{(n-1)!}{(x-1)!(n-1-(x-1))!}y^{x-1}(1-y)^{n-1-(x-1)},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which we rewrite as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mu=ny\\sum_{\\nu=0}^n\\left(\\begin{array}{c} n-1 \\\\ \\nu\\end{array}\\right)y^{\\nu}(1-y)^{n-1-\\nu} =ny(y+1-y)^{n-1}=ny.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The variance is slightly trickier to get. It reads $\\sigma^2=ny(1-y)$. \n", - "\n", - "\n", - "## Probability Distribution Functions, Poisson's distribution\n", - "\n", - "Another important distribution with discrete stochastic variables $x$ is \n", - "the Poisson model, which resembles the exponential distribution and reads" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(x) = \\frac{\\lambda^x}{x!} e^{-\\lambda} \\hspace{0.5cm}x=0,1,\\dots,;\\lambda > 0.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In this case both the mean value and the variance are easier to calculate," - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mu = \\sum_{x=0}^{\\infty} x \\frac{\\lambda^x}{x!} e^{-\\lambda} = \\lambda e^{-\\lambda}\\sum_{x=1}^{\\infty}\n", - "\\frac{\\lambda^{x-1}}{(x-1)!}=\\lambda,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and the variance is $\\sigma^2=\\lambda$.\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "## Probability Distribution Functions, Poisson's distribution\n", - "An example of applications of the Poisson distribution could be the counting\n", - "of the number of $\\alpha$-particles emitted from a radioactive source in a given time interval.\n", - "In the limit of $n\\rightarrow \\infty$ and for small probabilities $y$, the binomial distribution\n", - "approaches the Poisson distribution. Setting $\\lambda = ny$, with $y$ the probability for an event in\n", - "the binomial distribution we can show that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\lim_{n\\rightarrow \\infty}\\left(\\begin{array}{c} n \\\\ x\\end{array}\\right)y^x(1-y)^{n-x} e^{-\\lambda}=\\sum_{x=1}^{\\infty}\\frac{\\lambda^x}{x!} e^{-\\lambda}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Meet the covariance!\n", - "An important quantity in a statistical analysis is the so-called covariance. \n", - "\n", - "Consider the set $\\{X_i\\}$ of $n$\n", - "stochastic variables (not necessarily uncorrelated) with the\n", - "multivariate PDF $P(x_1,\\dots,x_n)$. The *covariance* of two\n", - "of the stochastic variables, $X_i$ and $X_j$, is defined as follows" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - "\\mathrm{Cov}(X_i,\\,X_j) = \\langle (x_i-\\langle x_i\\rangle)(x_j-\\langle x_j\\rangle)\\rangle \n", - "\\label{_auto2} \\tag{4}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation} \n", - "=\\int\\cdots\\int (x_i-\\langle x_i\\rangle)(x_j-\\langle x_j\\rangle)P(x_1,\\dots,x_n)\\,dx_1\\dots dx_n,\n", - "\\label{eq:def_covariance} \\tag{5}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\langle x_i\\rangle =\n", - "\\int\\cdots\\int x_i P(x_1,\\dots,x_n)\\,dx_1\\dots dx_n.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Meet the covariance in matrix disguise\n", - "If we consider the above covariance as a matrix" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C_{ij} =\\mathrm{Cov}(X_i,\\,X_j),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "then the diagonal elements are just the familiar\n", - "variances, $C_{ii} = \\mathrm{Cov}(X_i,\\,X_i) = \\mathrm{Var}(X_i)$. It turns out that\n", - "all the off-diagonal elements are zero if the stochastic variables are\n", - "uncorrelated.\n", - "\n", - "\n", - "\n", - "\n", - "## Covariance" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "# Importing various packages\n", - "from math import exp, sqrt\n", - "from random import random, seed\n", - "import numpy as np\n", - "import matplotlib.pyplot as plt\n", - "\n", - "def covariance(x, y, n):\n", - " sum = 0.0\n", - " mean_x = np.mean(x)\n", - " mean_y = np.mean(y)\n", - " for i in range(0, n):\n", - " sum += (x[(i)]-mean_x)*(y[i]-mean_y)\n", - " return sum/n\n", - "\n", - "n = 10\n", - "\n", - "x=np.random.normal(size=n)\n", - "y = 4+3*x+np.random.normal(size=n)\n", - "covxy = covariance(x,y,n)\n", - "print(covxy)\n", - "z = np.vstack((x, y))\n", - "c = np.cov(z.T)\n", - "\n", - "print(c)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Meet the covariance, uncorrelated events\n", - "\n", - "Consider the stochastic variables $X_i$ and $X_j$, ($i\\neq j$). We have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{align*}\n", - "Cov(X_i,\\,X_j) &= \\langle (x_i-\\langle x_i\\rangle)(x_j-\\langle x_j\\rangle)\\rangle\\\\\n", - "&=\\langle x_i x_j - x_i\\langle x_j\\rangle - \\langle x_i\\rangle x_j + \\langle x_i\\rangle\\langle x_j\\rangle\\rangle\\\\\n", - "&=\\langle x_i x_j\\rangle - \\langle x_i\\langle x_j\\rangle\\rangle - \\langle \\langle x_i\\rangle x_j \\rangle +\n", - "\\langle \\langle x_i\\rangle\\langle x_j\\rangle\\rangle \\\\\n", - "&=\\langle x_i x_j\\rangle - \\langle x_i\\rangle\\langle x_j\\rangle - \\langle x_i\\rangle\\langle x_j\\rangle +\n", - "\\langle x_i\\rangle\\langle x_j\\rangle \\\\\n", - "&=\\langle x_i x_j\\rangle - \\langle x_i\\rangle\\langle x_j\\rangle\n", - "\\end{align*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "If $X_i$ and $X_j$ are independent (assuming $i \\neq j$), we have that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\langle x_i x_j\\rangle = \\langle x_i\\rangle\\langle x_j\\rangle,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "leading to" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "Cov(X_i, X_j) = 0 \\hspace{0.1cm} (i\\neq j).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Numerical experiments and the covariance\n", - "\n", - "Now that we have constructed an idealized mathematical framework, let\n", - "us try to apply it to empirical observations. Examples of relevant\n", - "physical phenomena may be spontaneous decays of nuclei, or a purely\n", - "mathematical set of numbers produced by some deterministic\n", - "mechanism. It is the latter we will deal with, using so-called pseudo-random\n", - "number generators. In general our observations will contain only a limited set of\n", - "observables. We remind the reader that\n", - "a *stochastic process* is a process that produces sequentially a\n", - "chain of values" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\{x_1, x_2,\\dots\\,x_k,\\dots\\}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Numerical experiments and the covariance\n", - "We will call these\n", - "values our *measurements* and the entire set as our measured\n", - "*sample*. The action of measuring all the elements of a sample\n", - "we will call a stochastic *experiment* (since, operationally,\n", - "they are often associated with results of empirical observation of\n", - "some physical or mathematical phenomena; precisely an experiment). We\n", - "assume that these values are distributed according to some \n", - "PDF $p_X^{\\phantom X}(x)$, where $X$ is just the formal symbol for the\n", - "stochastic variable whose PDF is $p_X^{\\phantom X}(x)$. Instead of\n", - "trying to determine the full distribution $p$ we are often only\n", - "interested in finding the few lowest moments, like the mean\n", - "$\\mu_X^{\\phantom X}$ and the variance $\\sigma_X^{\\phantom X}$.\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "## Numerical experiments and the covariance, actual situations\n", - "In practical situations however, a sample is always of finite size. Let that\n", - "size be $n$. The expectation value of a sample $\\alpha$, the **sample mean**, is then defined as follows" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\langle x_{\\alpha} \\rangle \\equiv \\frac{1}{n}\\sum_{k=1}^n x_{\\alpha,k}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The *sample variance* is:" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathrm{Var}(x) \\equiv \\frac{1}{n}\\sum_{k=1}^n (x_{\\alpha,k} - \\langle x_{\\alpha} \\rangle)^2,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with its square root being the *standard deviation of the sample*.\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "## Numerical experiments and the covariance, our observables\n", - "You can think of the above observables as a set of quantities which define\n", - "a given experiment. This experiment is then repeated several times, say $m$ times.\n", - "The total average is then" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - "\\langle X_m \\rangle= \\frac{1}{m}\\sum_{\\alpha=1}^mx_{\\alpha}=\\frac{1}{mn}\\sum_{\\alpha, k} x_{\\alpha,k},\n", - "\\label{eq:exptmean} \\tag{6}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where the last sums end at $m$ and $n$.\n", - "The total variance is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\sigma^2_m= \\frac{1}{mn^2}\\sum_{\\alpha=1}^m(\\langle x_{\\alpha} \\rangle-\\langle X_m \\rangle)^2,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which we rewrite as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - "\\sigma^2_m=\\frac{1}{m}\\sum_{\\alpha=1}^m\\sum_{kl=1}^n (x_{\\alpha,k}-\\langle X_m \\rangle)(x_{\\alpha,l}-\\langle X_m \\rangle).\n", - "\\label{eq:exptvariance} \\tag{7}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Numerical experiments and the covariance, the sample variance\n", - "\n", - "We define also the sample variance $\\sigma^2$ of all $mn$ individual experiments as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - "\\sigma^2=\\frac{1}{mn}\\sum_{\\alpha=1}^m\\sum_{k=1}^n (x_{\\alpha,k}-\\langle X_m \\rangle)^2.\n", - "\\label{eq:sampleexptvariance} \\tag{8}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "These quantities, being known experimental values or the results from our calculations, \n", - "may differ, in some cases\n", - "significantly, from the similarly named\n", - "exact values for the mean value $\\mu_X$, the variance $\\mathrm{Var}(X)$\n", - "and the covariance $\\mathrm{Cov}(X,Y)$.\n", - "\n", - "\n", - "\n", - "\n", - "## Numerical experiments and the covariance, central limit theorem\n", - "\n", - "The central limit theorem states that the PDF $\\tilde{p}(z)$ of\n", - "the average of $m$ random values corresponding to a PDF $p(x)$ \n", - "is a normal distribution whose mean is the \n", - "mean value of the PDF $p(x)$ and whose variance is the variance\n", - "of the PDF $p(x)$ divided by $m$, the number of values used to compute $z$.\n", - "\n", - "The central limit theorem leads then to the well-known expression for the\n", - "standard deviation, given by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\sigma_m=\n", - "\\frac{\\sigma}{\\sqrt{m}}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In many cases the above estimate for the standard deviation, in particular if correlations are strong, may be too simplistic. We need therefore a more precise defintion of the error and the variance in our results.\n", - "\n", - "\n", - "\n", - "\n", - "## Definition of Correlation Functions and Standard Deviation\n", - "Our estimate of the true average $\\mu_{X}$ is the sample mean $\\langle X_m \\rangle$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mu_{X}^{\\phantom X} \\approx X_m=\\frac{1}{mn}\\sum_{\\alpha=1}^m\\sum_{k=1}^n x_{\\alpha,k}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We can then use Eq. ([7](#eq:exptvariance))" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\sigma^2_m=\\frac{1}{mn^2}\\sum_{\\alpha=1}^m\\sum_{kl=1}^n (x_{\\alpha,k}-\\langle X_m \\rangle)(x_{\\alpha,l}-\\langle X_m \\rangle),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and rewrite it as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\sigma^2_m=\\frac{\\sigma^2}{n}+\\frac{2}{mn^2}\\sum_{\\alpha=1}^m\\sum_{k\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - "\\kappa_d = \\frac{f_d}{\\sigma^2}\n", - "\\label{eq:autocorrelformal} \\tag{9}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which gives us a useful measure of the correlation pair correlation\n", - "starting always at $1$ for $d=0$.\n", - "\n", - "\n", - "\n", - "\n", - "## Definition of Correlation Functions and Standard Deviation, sample variance\n", - "\n", - "The sample variance of the $mn$ experiments can now be\n", - "written in terms of the autocorrelation function" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - "\\sigma_m^2=\\frac{\\sigma^2}{n}+\\frac{2}{n}\\cdot\\sigma^2\\sum_{d=1}^{n-1}\n", - "\\frac{f_d}{\\sigma^2}=\\left(1+2\\sum_{d=1}^{n-1}\\kappa_d\\right)\\frac{1}{n}\\sigma^2=\\frac{\\tau}{n}\\cdot\\sigma^2\n", - "\\label{eq:error_estimate_corr_time} \\tag{10}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and we see that $\\sigma_m$ can be expressed in terms of the\n", - "uncorrelated sample variance times a correction factor $\\tau$ which\n", - "accounts for the correlation between measurements. We call this\n", - "correction factor the *autocorrelation time*" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - "\\tau = 1+2\\sum_{d=1}^{n-1}\\kappa_d\n", - "\\label{eq:autocorrelation_time} \\tag{11}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "\n", - "For a correlation free experiment, $\\tau$\n", - "equals 1.\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "## Definition of Correlation Functions and Standard Deviation\n", - "From the point of view of\n", - "Eq. ([10](#eq:error_estimate_corr_time)) we can interpret a sequential\n", - "correlation as an effective reduction of the number of measurements by\n", - "a factor $\\tau$. The effective number of measurements becomes" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "n_\\mathrm{eff} = \\frac{n}{\\tau}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "To neglect the autocorrelation time $\\tau$ will always cause our\n", - "simple uncorrelated estimate of $\\sigma_m^2\\approx \\sigma^2/n$ to\n", - "be less than the true sample error. The estimate of the error will be\n", - "too \"good\". On the other hand, the calculation of the full\n", - "autocorrelation time poses an efficiency problem if the set of\n", - "measurements is very large. The solution to this problem is given by \n", - "more practically oriented methods like the blocking technique.\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "## Code to compute the Covariance matrix and the Covariance" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "# Importing various packages\n", - "from math import exp, sqrt\n", - "from random import random, seed\n", - "import numpy as np\n", - "import matplotlib.pyplot as plt\n", - "\n", - "# Sample covariance, note the factor 1/(n-1)\n", - "def covariance(x, y, n):\n", - " sum = 0.0\n", - " mean_x = np.mean(x)\n", - " mean_y = np.mean(y)\n", - " for i in range(0, n):\n", - " sum += (x[(i)]-mean_x)*(y[i]-mean_y)\n", - " return sum/(n-1.)\n", - "\n", - "n = 100\n", - "x = np.random.normal(size=n)\n", - "print(np.mean(x))\n", - "y = 4+3*x+np.random.normal(size=n)\n", - "print(np.mean(y))\n", - "z = x**3+np.random.normal(size=n)\n", - "print(np.mean(z))\n", - "covxx = covariance(x,x,n)\n", - "covyy = covariance(y,y,n)\n", - "covzz = covariance(z,z,n)\n", - "covxy = covariance(x,y,n)\n", - "covxz = covariance(x,z,n)\n", - "covyz = covariance(y,z,n)\n", - "print(covxx,covyy, covzz)\n", - "print(covxy,covxz, covyz)\n", - "w = np.vstack((x, y, z))\n", - "#print(w)\n", - "c = np.cov(w)\n", - "print(c)\n", - "#eigen = np.zeros(n)\n", - "Eigvals, Eigvecs = np.linalg.eig(c)\n", - "print(Eigvals)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Random Numbers\n", - "\n", - "Uniform deviates are just random numbers that lie within a specified range\n", - "(typically 0 to 1), with any one number in the range just as likely as any other. They\n", - "are, in other words, what you probably think random numbers are. However,\n", - "we want to distinguish uniform deviates from other sorts of random numbers, for\n", - "example numbers drawn from a normal (Gaussian) distribution of specified mean\n", - "and standard deviation. These other sorts of deviates are almost always generated by\n", - "performing appropriate operations on one or more uniform deviates, as we will see\n", - "in subsequent sections. So, a reliable source of random uniform deviates, the subject\n", - "of this section, is an essential building block for any sort of stochastic modeling\n", - "or Monte Carlo computer work.\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "## Random Numbers, better name: pseudo random numbers\n", - "\n", - "A disclaimer is however appropriate. It should be fairly obvious that \n", - "something as deterministic as a computer cannot generate purely random numbers.\n", - "\n", - "Numbers generated by any of the standard algorithms are in reality pseudo random\n", - "numbers, hopefully abiding to the following criteria:\n", - "\n", - " * they produce a uniform distribution in the interval [0,1].\n", - "\n", - " * correlations between random numbers are negligible\n", - "\n", - " * the period before the same sequence of random numbers is repeated is as large as possible and finally\n", - "\n", - " * the algorithm should be fast.\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "## Random number generator RNG\n", - " The most common random number generators are based on so-called\n", - "Linear congruential relations of the type" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "N_i=(aN_{i-1}+c) \\mathrm{MOD} (M),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which yield a number in the interval [0,1] through" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "x_i=N_i/M\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The number \n", - "$M$ is called the period and it should be as large as possible \n", - " and \n", - "$N_0$ is the starting value, or seed. The function $\\mathrm{MOD}$ means the remainder,\n", - "that is if we were to evaluate $(13)\\mathrm{MOD}(9)$, the outcome is the remainder\n", - "of the division $13/9$, namely $4$.\n", - "\n", - "\n", - "\n", - "\n", - "## Random number generator RNG and periodic outputs\n", - "\n", - "The problem with such generators is that their outputs are periodic;\n", - "they \n", - "will start to repeat themselves with a period that is at most $M$. If however\n", - "the parameters $a$ and $c$ are badly chosen, the period may be even shorter.\n", - "\n", - "Consider the following example" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "N_i=(6N_{i-1}+7) \\mathrm{MOD} (5),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with a seed $N_0=2$. This generator produces the sequence\n", - "$4,1,3,0,2,4,1,3,0,2,...\\dots$, i.e., a sequence with period $5$.\n", - "However, increasing $M$ may not guarantee a larger period as the following\n", - "example shows" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "N_i=(27N_{i-1}+11) \\mathrm{MOD} (54),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which still, with $N_0=2$, results in $11,38,11,38,11,38,\\dots$, a period of\n", - "just $2$.\n", - "\n", - "\n", - "\n", - "\n", - "## Random number generator RNG and its period\n", - "Typical periods for the random generators provided in the program library \n", - "are of the order of $\\sim 10^9$ or larger. Other random number generators which have\n", - "become increasingly popular are so-called shift-register generators.\n", - "In these generators each successive number depends on many preceding\n", - "values (rather than the last values as in the linear congruential\n", - "generator).\n", - "For example, you could make a shift register generator whose $l$th \n", - "number is the sum of the $l-i$th and $l-j$th values with modulo $M$," - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "N_l=(aN_{l-i}+cN_{l-j})\\mathrm{MOD}(M).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Random number generator RNG, other examples\n", - "Such a generator again produces a sequence of pseudorandom numbers\n", - "but this time with a period much larger than $M$.\n", - "It is also possible to construct more elaborate algorithms by including\n", - "more than two past terms in the sum of each iteration.\n", - "One example is the generator of [Marsaglia and Zaman](http://dl.acm.org/citation.cfm?id=187154)\n", - "which consists of two congruential relations" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - " N_l=(N_{l-3}-N_{l-1})\\mathrm{MOD}(2^{31}-69),\n", - "\\label{eq:mz1} \\tag{12}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "followed by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - " N_l=(69069N_{l-1}+1013904243)\\mathrm{MOD}(2^{32}),\n", - "\\label{eq:mz2} \\tag{13}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which according to the authors has a period larger than $2^{94}$.\n", - "\n", - "\n", - "\n", - "\n", - "## Random number generator RNG, other examples\n", - "Instead of using modular addition, we could use the bitwise\n", - "exclusive-OR ($\\oplus$) operation so that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "N_l=(N_{l-i})\\oplus (N_{l-j})\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where the bitwise action of $\\oplus$ means that if $N_{l-i}=N_{l-j}$ the result is\n", - "$0$ whereas if $N_{l-i}\\ne N_{l-j}$ the result is\n", - "$1$. As an example, consider the case where $N_{l-i}=6$ and $N_{l-j}=11$. The first\n", - "one has a bit representation (using 4 bits only) which reads $0110$ whereas the \n", - "second number is $1011$. Employing the $\\oplus$ operator yields \n", - "$1101$, or $2^3+2^2+2^0=13$.\n", - "\n", - "In Fortran90, the bitwise $\\oplus$ operation is coded through the intrinsic\n", - "function $\\mathrm{IEOR}(m,n)$ where $m$ and $n$ are the input numbers, while in $C$\n", - "it is given by $m\\wedge n$.\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "## Random number generator RNG, RAN0\n", - "\n", - "We show here how the linear congruential algorithm can be implemented, namely" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "N_i=(aN_{i-1}) \\mathrm{MOD} (M).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "However, since $a$ and $N_{i-1}$ are integers and their multiplication \n", - "could become greater than the standard 32 bit integer, there is a trick via \n", - "Schrage's algorithm which approximates the multiplication\n", - "of large integers through the factorization" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "M=aq+r,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where we have defined" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "q=[M/a],\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "r = M\\hspace{0.1cm}\\mathrm{MOD} \\hspace{0.1cm}a.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where the brackets denote integer division. In the code below the numbers \n", - "$q$ and $r$ are chosen so that $r < q$.\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "## Random number generator RNG, RAN0\n", - "\n", - "To see how this works we note first that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - "(aN_{i-1}) \\mathrm{MOD} (M)= (aN_{i-1}-[N_{i-1}/q]M)\\mathrm{MOD} (M),\n", - "\\label{eq:rntrick1} \\tag{14}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "since we can add or subtract any integer multiple of $M$ from $aN_{i-1}$.\n", - "The last term $[N_{i-1}/q]M\\mathrm{MOD}(M)$ is zero since the integer division \n", - "$[N_{i-1}/q]$ just yields a constant which is multiplied with $M$.\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "## Random number generator RNG, RAN0\n", - "We can now rewrite Eq. ([14](#eq:rntrick1)) as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - "(aN_{i-1}) \\mathrm{MOD} (M)= (aN_{i-1}-[N_{i-1}/q](aq+r))\\mathrm{MOD} (M),\n", - "\\label{eq:rntrick2} \\tag{15}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which results\n", - "in" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - "(aN_{i-1}) \\mathrm{MOD} (M)= \\left(a(N_{i-1}-[N_{i-1}/q]q)-[N_{i-1}/q]r)\\right)\\mathrm{MOD} (M),\n", - "\\label{eq:rntrick3} \\tag{16}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "yielding" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - "(aN_{i-1}) \\mathrm{MOD} (M)= \\left(a(N_{i-1}\\mathrm{MOD} (q)) -[N_{i-1}/q]r)\\right)\\mathrm{MOD} (M).\n", - "\\label{eq:rntrick4} \\tag{17}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Random number generator RNG, RAN0\n", - "The term $[N_{i-1}/q]r$ is always smaller or equal $N_{i-1}(r/q)$ and with $r < q$ we obtain always a \n", - "number smaller than $N_{i-1}$, which is smaller than $M$. \n", - "And since the number $N_{i-1}\\mathrm{MOD} (q)$ is between zero and $q-1$ then\n", - "$a(N_{i-1}\\mathrm{MOD} (q))< aq$. Combined with our definition of $q=[M/a]$ ensures that \n", - "this term is also smaller than $M$ meaning that both terms fit into a\n", - "32-bit signed integer. None of these two terms can be negative, but their difference could.\n", - "The algorithm below adds $M$ if their difference is negative.\n", - "Note that the program uses the bitwise $\\oplus$ operator to generate\n", - "the starting point for each generation of a random number. The period\n", - "of $ran0$ is $\\sim 2.1\\times 10^{9}$. A special feature of this\n", - "algorithm is that is should never be called with the initial seed \n", - "set to $0$.\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "## Random number generator RNG, RAN0 code" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - " /*\n", - " ** The function\n", - " ** ran0()\n", - " ** is an \"Minimal\" random number generator of Park and Miller\n", - " ** Set or reset the input value\n", - " ** idum to any integer value (except the unlikely value MASK)\n", - " ** to initialize the sequence; idum must not be altered between\n", - " ** calls for sucessive deviates in a sequence.\n", - " ** The function returns a uniform deviate between 0.0 and 1.0.\n", - " */\n", - " double ran0(long &idum)\n", - " {\n", - " const int a = 16807, m = 2147483647, q = 127773;\n", - " const int r = 2836, MASK = 123459876;\n", - " const double am = 1./m;\n", - " long k;\n", - " double ans;\n", - " idum ^= MASK;\n", - " k = (*idum)/q;\n", - " idum = a*(idum - k*q) - r*k;\n", - " // add m if negative difference\n", - " if(idum < 0) idum += m;\n", - " ans=am*(idum);\n", - " idum ^= MASK;\n", - " return ans;\n", - " } // End: function ran0() \n" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Properties of Selected Random Number Generators\n", - "\n", - "As mentioned previously, the underlying PDF for the generation of\n", - "random numbers is the uniform distribution, meaning that the \n", - "probability for finding a number $x$ in the interval [0,1] is $p(x)=1$.\n", - "\n", - "A random number generator should produce numbers which are uniformly distributed\n", - "in this interval. The table shows the distribution of $N=10000$ random\n", - "numbers generated by the functions in the program library.\n", - "We note in this table that the number of points in the various\n", - "intervals $0.0-0.1$, $0.1-0.2$ etc are fairly close to $1000$, with some minor\n", - "deviations. \n", - "\n", - "Two additional measures are the standard deviation $\\sigma$ and the mean\n", - "$\\mu=\\langle x\\rangle$.\n", - "\n", - "\n", - "\n", - "\n", - "## Properties of Selected Random Number Generators\n", - "For the uniform distribution, the mean value $\\mu$ is then" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mu=\\langle x\\rangle=\\frac{1}{2}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "while the standard deviation is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\sigma=\\sqrt{\\langle x^2\\rangle-\\mu^2}=\\frac{1}{\\sqrt{12}}=0.2886.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Properties of Selected Random Number Generators\n", - "The various random number generators produce results which agree rather well with\n", - "these limiting values. \n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "
$x$-bin ran0 ran1 ran2 ran3
0.0-0.1 1013 991 938 1047
0.1-0.2 1002 1009 1040 1030
0.2-0.3 989 999 1030 993
0.3-0.4 939 960 1023 937
0.4-0.5 1038 1001 1002 992
0.5-0.6 1037 1047 1009 1009
0.6-0.7 1005 989 1003 989
0.7-0.8 986 962 985 954
0.8-0.9 1000 1027 1009 1023
0.9-1.0 991 1015 961 1026
$\\mu$ 0.4997 0.5018 0.4992 0.4990
$\\sigma$ 0.2882 0.2892 0.2861 0.2915
\n", - "\n", - "\n", - "\n", - "\n", - "## Simple demonstration of RNGs using python\n", - "The following simple Python code plots the distribution of the produced random numbers using the linear congruential RNG employed by Python. The trend displayed in the previous table is seen rather clearly." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "#!/usr/bin/env python\n", - "import numpy as np\n", - "import matplotlib.mlab as mlab\n", - "import matplotlib.pyplot as plt\n", - "import random\n", - "\n", - "# initialize the rng with a seed\n", - "random.seed() \n", - "counts = 10000\n", - "values = np.zeros(counts) \n", - "for i in range (1, counts, 1):\n", - " values[i] = random.random()\n", - "\n", - "# the histogram of the data\n", - "n, bins, patches = plt.hist(values, 10, facecolor='green')\n", - "\n", - "plt.xlabel('$x$')\n", - "plt.ylabel('Number of counts')\n", - "plt.title(r'Test of uniform distribution')\n", - "plt.axis([0, 1, 0, 1100])\n", - "plt.grid(True)\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Properties of Selected Random Number Generators\n", - "Since our random numbers, which are typically generated via a linear congruential algorithm,\n", - "are never fully independent, we can then define \n", - "an important test which measures the degree of correlation, namely the so-called \n", - "auto-correlation function defined previously, see again Eq. ([9](#eq:autocorrelformal)).\n", - "We rewrite it here as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C_k=\\frac{f_d}\n", - " {\\sigma^2},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with $C_0=1$. Recall that \n", - "$\\sigma^2=\\langle x_i^2\\rangle-\\langle x_i\\rangle^2$ and that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "f_d = \\frac{1}{nm}\\sum_{\\alpha=1}^m\\sum_{k=1}^{n-d}(x_{\\alpha,k}-\\langle X_m \\rangle)(x_{\\alpha,k+d}-\\langle X_m \\rangle),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The non-vanishing of $C_k$ for $k\\ne 0$ means that the random\n", - "numbers are not independent. The independence of the random numbers is crucial \n", - "in the evaluation of other expectation values. If they are not independent, our\n", - "assumption for approximating $\\sigma_N$ is no longer valid.\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "## Autocorrelation function\n", - "This program computes the autocorrelation function as discussed in the equation on the previous slide for random numbers generated with the normal distribution $N(0,1)$." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "# Importing various packages\n", - "from math import exp, sqrt\n", - "from random import random, seed\n", - "import numpy as np\n", - "import matplotlib.pyplot as plt\n", - "\n", - "def autocovariance(x, n, k, mean_x):\n", - " sum = 0.0\n", - " for i in range(0, n-k):\n", - " sum += (x[(i+k)]-mean_x)*(x[i]-mean_x)\n", - " return sum/n\n", - "\n", - "n = 1000\n", - "x=np.random.normal(size=n)\n", - "autocor = np.zeros(n)\n", - "figaxis = np.zeros(n)\n", - "mean_x=np.mean(x)\n", - "var_x = np.var(x)\n", - "print(mean_x, var_x)\n", - "for i in range (0, n):\n", - " figaxis[i] = i\n", - " autocor[i]=(autocovariance(x, n, i, mean_x))/var_x \n", - "\n", - "plt.plot(figaxis, autocor, \"r-\")\n", - "plt.axis([0,n,-0.1, 1.0])\n", - "plt.xlabel(r'$i$')\n", - "plt.ylabel(r'$\\gamma_i$')\n", - "plt.title(r'Autocorrelation function')\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "As can be seen from the plot, the first point gives back the variance and a value of one. \n", - "For the remaining values we notice that there are still non-zero values for the auto-correlation function.\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "## Correlation function and which random number generators should I use\n", - "The program here computes the correlation function for one of the standard functions included with the c++ compiler." - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - " // This function computes the autocorrelation function for \n", - " // the standard c++ random number generator\n", - " \n", - " #include \n", - " #include \n", - " #include \n", - " #include \n", - " using namespace std;\n", - " // output file as global variable\n", - " ofstream ofile; \n", - " \n", - " // Main function begins here \n", - " int main(int argc, char* argv[])\n", - " {\n", - " int n;\n", - " char *outfilename;\n", - " \n", - " cin >> n;\n", - " double MCint = 0.; double MCintsqr2=0.;\n", - " double invers_period = 1./RAND_MAX; // initialise the random number generator\n", - " srand(time(NULL)); // This produces the so-called seed in MC jargon\n", - " // Compute the variance and the mean value of the uniform distribution\n", - " // Compute also the specific values x for each cycle in order to be able to\n", - " // the covariance and the correlation function \n", - " // Read in output file, abort if there are too few command-line arguments\n", - " if( argc <= 2 ){\n", - " cout << \"Bad Usage: \" << argv[0] << \n", - " \t \" read also output file and number of cycles on same line\" << endl;\n", - " exit(1);\n", - " }\n", - " else{\n", - " outfilename=argv[1];\n", - " }\n", - " ofile.open(outfilename); \n", - " // Get the number of Monte-Carlo samples\n", - " n = atoi(argv[2]);\n", - " double *X; \n", - " X = new double[n];\n", - " for (int i = 0; i < n; i++){\n", - " double x = double(rand())*invers_period; \n", - " X[i] = x;\n", - " MCint += x;\n", - " MCintsqr2 += x*x;\n", - " }\n", - " double Mean = MCint/((double) n );\n", - " MCintsqr2 = MCintsqr2/((double) n );\n", - " double STDev = sqrt(MCintsqr2-Mean*Mean);\n", - " double Variance = MCintsqr2-Mean*Mean;\n", - " // Write mean value and standard deviation \n", - " cout << \" Standard deviation= \" << STDev << \" Integral = \" << Mean << endl;\n", - " \n", - " // Now we compute the autocorrelation function\n", - " double *autocor; autocor = new double[n];\n", - " for (int j = 0; j < n; j++){\n", - " double sum = 0.0;\n", - " for (int k = 0; k < (n-j); k++){\n", - " \t sum += (X[k]-Mean)*(X[k+j]-Mean); \n", - " }\n", - " autocor[j] = sum/Variance/((double) n );\n", - " ofile << setiosflags(ios::showpoint | ios::uppercase);\n", - " ofile << setw(15) << setprecision(8) << j;\n", - " ofile << setw(15) << setprecision(8) << autocor[j] << endl;\n", - " }\n", - " ofile.close(); // close output file\n", - " return 0;\n", - " } // end of main program \n" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Which RNG should I use?\n", - "* C++ has a class called **random**. The [random class](http://www.cplusplus.com/reference/random/) contains a large selection of RNGs and is highly recommended. Some of these RNGs have very large periods making it thereby very safe to use these RNGs in case one is performing large calculations. In particular, the [Mersenne twister random number engine](http://www.cplusplus.com/reference/random/mersenne_twister_engine/) has a period of $2^{19937}$. \n", - "\n", - "* Add RNGs in Python\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "## How to use the Mersenne generator\n", - "The following part of a c++ code (from project 4) sets up the uniform distribution for $x\\in [0,1]$." - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - " /*\n", - " \n", - " // You need this \n", - " #include \n", - " \n", - " // Initialize the seed and call the Mersienne algo\n", - " std::random_device rd;\n", - " std::mt19937_64 gen(rd());\n", - " // Set up the uniform distribution for x \\in [[0, 1]\n", - " std::uniform_real_distribution RandomNumberGenerator(0.0,1.0);\n", - " \n", - " // Now use the RNG\n", - " int ix = (int) (RandomNumberGenerator(gen)*NSpins);\n" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Why blocking?\n", - "**Statistical analysis.**\n", - "\n", - " * Monte Carlo simulations can be treated as *computer experiments*\n", - "\n", - " * The results can be analysed with the same statistical tools as we would use analysing experimental data.\n", - "\n", - " * As in all experiments, we are looking for expectation values and an estimate of how accurate they are, i.e., possible sources for errors.\n", - "\n", - "A very good article which explains blocking is H. Flyvbjerg and H. G. Petersen, *Error estimates on averages of correlated data*, [Journal of Chemical Physics 91, 461-466 (1989)](http://scitation.aip.org/content/aip/journal/jcp/91/1/10.1063/1.457480).\n", - "\n", - " \n", - "\n", - "\n", - "\n", - "\n", - "## Why blocking?\n", - "**Statistical analysis.**\n", - "\n", - " * As in other experiments, Monte Carlo experiments have two classes of errors:\n", - "\n", - " * Statistical errors\n", - "\n", - " * Systematical errors\n", - "\n", - "\n", - " * Statistical errors can be estimated using standard tools from statistics\n", - "\n", - " * Systematical errors are method specific and must be treated differently from case to case. (In VMC a common source is the step length or time step in importance sampling)\n", - "\n", - " \n", - "\n", - "\n", - "\n", - "## Code to demonstrate the calculation of the autocorrelation function\n", - "The following code computes the autocorrelation function, the covariance and the standard deviation\n", - "for standard RNG. \n", - "The [following file](https://github.com/CompPhysics/ComputationalPhysics2/tree/gh-pages/doc/Programs/LecturePrograms/programs/Blocking/autocorrelation.cpp) gives the code." - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - " // This function computes the autocorrelation function for \n", - " // the Mersenne random number generator with a uniform distribution\n", - " #include \n", - " #include \n", - " #include \n", - " #include \n", - " #include \n", - " #include \n", - " #include \n", - " #include \n", - " using namespace std;\n", - " using namespace arma;\n", - " // output file\n", - " ofstream ofile;\n", - " \n", - " // Main function begins here \n", - " int main(int argc, char* argv[])\n", - " {\n", - " int MonteCarloCycles;\n", - " string filename;\n", - " if (argc > 1) {\n", - " filename=argv[1];\n", - " MonteCarloCycles = atoi(argv[2]);\n", - " string fileout = filename;\n", - " string argument = to_string(MonteCarloCycles);\n", - " fileout.append(argument);\n", - " ofile.open(fileout);\n", - " }\n", - " \n", - " // Compute the variance and the mean value of the uniform distribution\n", - " // Compute also the specific values x for each cycle in order to be able to\n", - " // compute the covariance and the correlation function \n", - " \n", - " vec X = zeros(MonteCarloCycles);\n", - " double MCint = 0.; double MCintsqr2=0.;\n", - " std::random_device rd;\n", - " std::mt19937_64 gen(rd());\n", - " // Set up the uniform distribution for x \\in [[0, 1]\n", - " std::uniform_real_distribution RandomNumberGenerator(0.0,1.0);\n", - " for (int i = 0; i < MonteCarloCycles; i++){\n", - " double x = RandomNumberGenerator(gen); \n", - " X(i) = x;\n", - " MCint += x;\n", - " MCintsqr2 += x*x;\n", - " }\n", - " double Mean = MCint/((double) MonteCarloCycles );\n", - " MCintsqr2 = MCintsqr2/((double) MonteCarloCycles );\n", - " double STDev = sqrt(MCintsqr2-Mean*Mean);\n", - " double Variance = MCintsqr2-Mean*Mean;\n", - " // Write mean value and variance\n", - " cout << \" Sample variance= \" << Variance << \" Mean value = \" << Mean << endl;\n", - " // Now we compute the autocorrelation function\n", - " vec autocorrelation = zeros(MonteCarloCycles);\n", - " for (int j = 0; j < MonteCarloCycles; j++){\n", - " double sum = 0.0;\n", - " for (int k = 0; k < (MonteCarloCycles-j); k++){\n", - " sum += (X(k)-Mean)*(X(k+j)-Mean); \n", - " }\n", - " autocorrelation(j) = sum/Variance/((double) MonteCarloCycles );\n", - " ofile << setiosflags(ios::showpoint | ios::uppercase);\n", - " ofile << setw(15) << setprecision(8) << j;\n", - " ofile << setw(15) << setprecision(8) << autocorrelation(j) << endl;\n", - " }\n", - " // Now compute the exact covariance using the autocorrelation function\n", - " double Covariance = 0.0;\n", - " for (int j = 0; j < MonteCarloCycles; j++){\n", - " Covariance += autocorrelation(j);\n", - " }\n", - " Covariance *= 2.0/((double) MonteCarloCycles);\n", - " // Compute now the total variance, including the covariance, and obtain the standard deviation\n", - " double TotalVariance = (Variance/((double) MonteCarloCycles ))+Covariance;\n", - " cout << \"Covariance =\" << Covariance << \"Totalvariance= \" << TotalVariance << \"Sample Variance/n= \" << (Variance/((double) MonteCarloCycles )) << endl;\n", - " cout << \" STD from sample variance= \" << sqrt(Variance/((double) MonteCarloCycles )) << \" STD with covariance = \" << sqrt(TotalVariance) << endl;\n", - " \n", - " ofile.close(); // close output file\n", - " return 0;\n", - " } // end of main program \n", - " \n", - " \n" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## What is blocking?\n", - "**Blocking.**\n", - "\n", - " * Say that we have a set of samples from a Monte Carlo experiment\n", - "\n", - " * Assuming (wrongly) that our samples are uncorrelated our best estimate of the standard deviation of the mean $\\langle \\mathbf{M}\\rangle$ is given by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\sigma=\\sqrt{\\frac{1}{n}\\left(\\langle \\mathbf{M}^2\\rangle-\\langle \\mathbf{M}\\rangle^2\\right)}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "* If the samples are correlated we can rewrite our results to show that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\sigma=\\sqrt{\\frac{1+2\\tau/\\Delta t}{n}\\left(\\langle \\mathbf{M}^2\\rangle-\\langle \\mathbf{M}\\rangle^2\\right)}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $\\tau$ is the correlation time (the time between a sample and the next uncorrelated sample) and $\\Delta t$ is time between each sample\n", - "\n", - " \n", - "\n", - "\n", - "## What is blocking?\n", - "**Blocking.**\n", - "\n", - " * If $\\Delta t\\gg\\tau$ our first estimate of $\\sigma$ still holds\n", - "\n", - " * Much more common that $\\Delta t<\\tau$\n", - "\n", - " * In the method of data blocking we divide the sequence of samples into blocks\n", - "\n", - " * We then take the mean $\\langle \\mathbf{M}_i\\rangle$ of block $i=1\\ldots n_{blocks}$ to calculate the total mean and variance\n", - "\n", - " * The size of each block must be so large that sample $j$ of block $i$ is not correlated with sample $j$ of block $i+1$\n", - "\n", - " * The correlation time $\\tau$ would be a good choice\n", - "\n", - "\n", - "\n", - "\n", - "## What is blocking?\n", - "**Blocking.**\n", - "\n", - " * Problem: We don't know $\\tau$ or it is too expensive to compute\n", - "\n", - " * Solution: Make a plot of std. dev. as a function of blocksize\n", - "\n", - " * The estimate of std. dev. of correlated data is too low $\\to$ the error will increase with increasing block size until the blocks are uncorrelated, where we reach a plateau\n", - "\n", - " * When the std. dev. stops increasing the blocks are uncorrelated\n", - "\n", - "\n", - "\n", - "\n", - "## Implementation\n", - " * Do a Monte Carlo simulation, storing all samples to file\n", - "\n", - " * Do the statistical analysis on this file, independently of your Monte Carlo program\n", - "\n", - " * Read the file into an array\n", - "\n", - " * Loop over various block sizes\n", - "\n", - " * For each block size $n_b$, loop over the array in steps of $n_b$ taking the mean of elements $i n_b,\\ldots,(i+1) n_b$\n", - "\n", - " * Take the mean and variance of the resulting array\n", - "\n", - " * Write the results for each block size to file for later\n", - " analysis\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "## Actual implementation with code, main function\n", - "When the file gets large, it can be useful to write your data in binary mode instead of ascii characters.\n", - "The [following python file](https://github.com/CompPhysics/MachineLearning/blob/master/doc/Programs/Sampling/analysis.py) reads data from file with the output from every Monte Carlo cycle." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "# Blocking\n", - " @timeFunction\n", - " def blocking(self, blockSizeMax = 500):\n", - " blockSizeMin = 1\n", - "\n", - " self.blockSizes = []\n", - " self.meanVec = []\n", - " self.varVec = []\n", - "\n", - " for i in range(blockSizeMin, blockSizeMax):\n", - " if(len(self.data) % i != 0):\n", - " pass#continue\n", - " blockSize = i\n", - " meanTempVec = []\n", - " varTempVec = []\n", - " startPoint = 0\n", - " endPoint = blockSize\n", - "\n", - " while endPoint <= len(self.data):\n", - " meanTempVec.append(np.average(self.data[startPoint:endPoint]))\n", - " startPoint = endPoint\n", - " endPoint += blockSize\n", - " mean, var = np.average(meanTempVec), np.var(meanTempVec)/len(meanTempVec)\n", - " self.meanVec.append(mean)\n", - " self.varVec.append(var)\n", - " self.blockSizes.append(blockSize)\n", - "\n", - " self.blockingAvg = np.average(self.meanVec[-200:])\n", - " self.blockingVar = (np.average(self.varVec[-200:]))\n", - " self.blockingStd = np.sqrt(self.blockingVar)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## The Bootstrap method\n", - "\n", - "The Bootstrap resampling method is also very popular. It is very simple:\n", - "\n", - "1. Start with your sample of measurements and compute the sample variance and the mean values\n", - "\n", - "2. Then start again but pick in a random way the numbers in the sample and recalculate the mean and the sample variance.\n", - "\n", - "3. Repeat this $K$ times.\n", - "\n", - "It can be shown, see the article by [Efron](https://projecteuclid.org/download/pdf_1/euclid.aos/1176344552)\n", - "that it produces the correct standard deviation.\n", - "\n", - "This method is very useful for small ensembles of data points. \n", - "\n", - "\n", - "## Bootstrapping\n", - "Given a set of $N$ data, assume that we are interested in some \n", - "observable $\\theta$ which may be estimated from that set. This observable can also be for example the result of a fit based on all $N$ raw data. \n", - "Let us call the value of the observable obtained from the original \n", - "data set $\\hat{\\theta}$. One recreates from the sample repeatedly \n", - "other samples by choosing randomly $N$ data out of the original set. \n", - "This costs essentially nothing, since we just recycle the original data set for the building of new sets. \n", - "\n", - "\n", - "## Bootstrapping, recipe\n", - "Let us assume we have done this $K$ times and thus have $K$ sets of $N$ \n", - "data values each. \n", - "Of course some values will enter more than once in the new sets. For each of these sets one computes the observable $\\theta$ resulting in values $\\theta_k$ with $k = 1,...,K$. Then one determines" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\tilde{\\theta} = \\frac{1}{K} \\sum_{k=1}^K \\theta_k,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "sigma^2_{\\tilde{\\theta}} = \\frac{1}{K} \\sum_{k=1}^K \\left(\\theta_k-\\tilde{\\theta}\\right)^2.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "These are estimators for $\\angle\\theta\\rangle$ and its variance. They are not unbiased and therefore \n", - "$\\tilde{\\theta}\\neq\\hat{\\theta}$ for finite K. \n", - "\n", - "The difference is called bias and gives an idea on how far away the result may be from \n", - "the true $\\angle\\theta\\rangle$. As final result for the observable one quotes $\\angle\\theta\\rangle = \\tilde{\\theta} \\pm \\sigma_{\\tilde{\\theta}}$ .\n", - "\n", - "\n", - "\n", - "## Bootstrapping, [code](https://github.com/CompPhysics/MachineLearning/blob/master/doc/Programs/Sampling/analysis.py)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - " # Bootstrap\n", - " @timeFunction\n", - " def bootstrap(self, nBoots = 1000):\n", - " bootVec = np.zeros(nBoots)\n", - " for k in range(0,nBoots):\n", - " bootVec[k] = np.average(np.random.choice(self.data, len(self.data)))\n", - " self.bootAvg = np.average(bootVec)\n", - " self.bootVar = np.var(bootVec)\n", - " self.bootStd = np.std(bootVec)\n" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Jackknife, [code](https://github.com/CompPhysics/MachineLearning/blob/master/doc/Programs/Sampling/analysis.py)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - " # Jackknife\n", - " @timeFunction\n", - " def jackknife(self):\n", - " jackknVec = np.zeros(len(self.data))\n", - " for k in range(0,len(self.data)):\n", - " jackknVec[k] = np.average(np.delete(self.data, k))\n", - " self.jackknAvg = self.avg - (len(self.data) - 1) * (np.average(jackknVec) - self.avg)\n", - " self.jackknVar = float(len(self.data) - 1) * np.var(jackknVec)\n", - " self.jackknStd = np.sqrt(self.jackknVar)\n" - ] - } - ], - "metadata": {}, - "nbformat": 4, - "nbformat_minor": 4 -} diff --git a/doc/LectureNotes/_build/html/_sources/teachers.md b/doc/LectureNotes/_build/html/_sources/teachers.md deleted file mode 100644 index a1bb4f199..000000000 --- a/doc/LectureNotes/_build/html/_sources/teachers.md +++ /dev/null @@ -1,36 +0,0 @@ -# Teachers and Grading - - -## Instructor information -* _Name_: Morten Hjorth-Jensen -* _Email_: morten.hjorth-jensen@fys.uio.no -* _Phone_: +47-48257387 -* _Office_: Department of Physics, University of Oslo, Eastern wing, room FØ470 -* _Office hours_: *Anytime*! Feel free to send an email for planning. Both in person meetings or digital meetings are possible. - -## Teaching Assistants Fall semester 2021 -* Øyvind Sigmundson Schøyen, oyvinssc@student.matnat.uio.no -* Stian Bilek, stian.bilek@fys.uio.no -* Linus Ekstrøm, linueks@gmail.com, linus.ekstrom@fys.uio.no -* Nicholas Karlsen, nicholaskarlsen1102@gmail.com, nicholas.karlsen@fys.uio.no -* Bendik Steinsvåg Dalen, b.s.dalen@fys.uio.no -* Philip Karim Sørli Niane, p.k.s.niane@fys.uio.no - - - -## Grading -Grading scale: Grades are awarded on a scale from A to F, where A is the best grade and F is a fail. There are three projects which are graded and each project counts 1/3 of the final grade. The total score is thus the average from all three projects. - -The final number of points is based on the average of all projects (including eventual additional points) and the grade follows the following table: - - * 92-100 points: A - * 77-91 points: B - * 58-76 points: C - * 46-57 points: D - * 40-45 points: E - * 0-39 points: F-failed - - - - - diff --git a/doc/LectureNotes/_build/html/_sources/textbooks.md b/doc/LectureNotes/_build/html/_sources/textbooks.md deleted file mode 100644 index cabdaf8ea..000000000 --- a/doc/LectureNotes/_build/html/_sources/textbooks.md +++ /dev/null @@ -1,44 +0,0 @@ - -## Textbooks - -_Recommended textbooks_: -The lecture notes are collected as a jupyter-book at https://compphysics.github.io/MachineLearning/doc/LectureNotes/_build/html/intro.html. In addition to the electure notes, we recommend the books of Bishop and Goodfellow et al. We will follow these texts closely and the weekly reading assignments refer to these two texts. -- Christopher M. Bishop, Pattern Recognition and Machine Learning, Springer, https://www.springer.com/gp/book/9780387310732. This is the main textbook and this course covers chapters 1-7, 11 and 12. You can download for free the textbook in PDF format at https://www.microsoft.com/en-us/research/uploads/prod/2006/01/Bishop-Pattern-Recognition-and-Machine-Learning-2006.pdf -- Ian Goodfellow, Yoshua Bengio, and Aaron Courville. The different chapters are available for free at https://www.deeplearningbook.org/. Chapters 2-14 are highly recommended. The lectures follow to a larg extent this text. -The weekly plans will include reading suggestions from these two textbooks. -_Additional textbooks_: -- Trevor Hastie, Robert Tibshirani, Jerome H. Friedman, The Elements of Statistical Learning, Springer, https://www.springer.com/gp/book/9780387848570. This is a well-known text and serves as additional literature. -- Aurelien Geron, Hands‑On Machine Learning with Scikit‑Learn and TensorFlow, O'Reilly, https://www.oreilly.com/library/view/hands-on-machine-learning/9781492032632/. This text is very useful since it contains many code examples and hands-on applications of all algorithms discussed in this course. - - - - -_General learning book on statistical analysis_: -- Christian Robert and George Casella, Monte Carlo Statistical Methods, Springer -- Peter Hoff, A first course in Bayesian statistical models, Springer - -_General Machine Learning Books_: -- Kevin Murphy, Machine Learning: A Probabilistic Perspective, MIT Press -- David J.C. MacKay, Information Theory, Inference, and Learning Algorithms, Cambridge University Press -- David Barber, Bayesian Reasoning and Machine Learning, Cambridge University Press - - - -## Links to relevant courses at the University of Oslo -The link here https://www.mn.uio.no/english/research/about/centre-focus/innovation/data-science/studies/ gives an excellent overview of courses on Machine learning at UiO. - -- _STK2100 Machine learning and statistical methods for prediction and classification_ http://www.uio.no/studier/emner/matnat/math/STK2100/index-eng.html. -- _IN3050 Introduction to Artificial Intelligence and Machine Learning_ https://www.uio.no/studier/emner/matnat/ifi/IN3050/index-eng.html. Introductory course in machine learning and AI with an algorithmic approach. -- _STK-INF3000/4000 Selected Topics in Data Science_ http://www.uio.no/studier/emner/matnat/math/STK-INF3000/index-eng.html. The course provides insight into selected contemporary relevant topics within Data Science. -- _IN4080 Natural Language Processing_ https://www.uio.no/studier/emner/matnat/ifi/IN4080/index.html. Probabilistic and machine learning techniques applied to natural language processing. -- _STK-IN4300 Statistical learning methods in Data Science_ https://www.uio.no/studier/emner/matnat/math/STK-IN4300/index-eng.html. An advanced introduction to statistical and machine learning. For students with a good mathematics and statistics background. -- _INF4490 Biologically Inspired Computing_ http://www.uio.no/studier/emner/matnat/ifi/INF4490/. An introduction to self-adapting methods also called artificial intelligence or machine learning. -- _IN-STK5000 Adaptive Methods for Data-Based Decision Making_ https://www.uio.no/studier/emner/matnat/ifi/IN-STK5000/index-eng.html. Methods for adaptive collection and processing of data based on machine learning techniques. -- _IN5400/INF5860 Machine Learning for Image Analysis_ https://www.uio.no/studier/emner/matnat/ifi/IN5400/. An introduction to deep learning with particular emphasis on applications within Image analysis, but useful for other application areas too. -- _TEK5040 Deep learning for autonomous systems_ https://www.uio.no/studier/emner/matnat/its/TEK5040/. The course addresses advanced algorithms and architectures for deep learning with neural networks. The course provides an introduction to how deep-learning techniques can be used in the construction of key parts of advanced autonomous systems that exist in physical environments and cyber environments. -- _STK4051 Computational Statistics_ https://www.uio.no/studier/emner/matnat/math/STK4051/index-eng.html -- _STK4021 Applied Bayesian Analysis and Numerical Methods_ https://www.uio.no/studier/emner/matnat/math/STK4021/ - - - - diff --git a/doc/LectureNotes/_build/html/_static/__init__.py b/doc/LectureNotes/_build/html/_static/__init__.py deleted file mode 100644 index e69de29bb..000000000 diff --git a/doc/LectureNotes/_build/html/_static/__pycache__/__init__.cpython-38.pyc b/doc/LectureNotes/_build/html/_static/__pycache__/__init__.cpython-38.pyc deleted file mode 100644 index 7db184419..000000000 Binary files a/doc/LectureNotes/_build/html/_static/__pycache__/__init__.cpython-38.pyc and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_static/basic.css b/doc/LectureNotes/_build/html/_static/basic.css deleted file mode 100644 index fb51eb711..000000000 --- a/doc/LectureNotes/_build/html/_static/basic.css +++ /dev/null @@ -1,856 +0,0 @@ -/* - * basic.css - * ~~~~~~~~~ - * - * Sphinx stylesheet -- basic theme. - * - * :copyright: Copyright 2007-2020 by the Sphinx team, see AUTHORS. - * :license: BSD, see LICENSE for details. - * - */ - -/* -- main layout ----------------------------------------------------------- */ - -div.clearer { - clear: both; -} - -div.section::after { - display: block; - content: ''; - clear: left; -} - -/* -- relbar ---------------------------------------------------------------- */ - -div.related { - width: 100%; - font-size: 90%; -} - -div.related h3 { - display: none; -} - -div.related ul { - margin: 0; - padding: 0 0 0 10px; - list-style: none; -} - -div.related li { - display: inline; -} - -div.related li.right { - float: right; - margin-right: 5px; -} - -/* -- sidebar --------------------------------------------------------------- */ - -div.sphinxsidebarwrapper { - padding: 10px 5px 0 10px; -} - -div.sphinxsidebar { - float: left; - width: 270px; - margin-left: -100%; - font-size: 90%; - word-wrap: break-word; - overflow-wrap : break-word; -} - -div.sphinxsidebar ul { - list-style: none; -} - -div.sphinxsidebar ul ul, -div.sphinxsidebar ul.want-points { - margin-left: 20px; - list-style: square; -} - -div.sphinxsidebar ul ul { - margin-top: 0; - margin-bottom: 0; -} - -div.sphinxsidebar form { - margin-top: 10px; -} - -div.sphinxsidebar input { - border: 1px solid #98dbcc; - font-family: sans-serif; - font-size: 1em; -} - -div.sphinxsidebar #searchbox form.search { - overflow: hidden; -} - -div.sphinxsidebar #searchbox input[type="text"] { - float: left; - width: 80%; - padding: 0.25em; - box-sizing: border-box; -} - -div.sphinxsidebar #searchbox input[type="submit"] { - float: left; - width: 20%; - border-left: none; - padding: 0.25em; - box-sizing: border-box; -} - - -img { - border: 0; - max-width: 100%; -} - -/* -- search page ----------------------------------------------------------- */ - -ul.search { - margin: 10px 0 0 20px; - padding: 0; -} - -ul.search li { - padding: 5px 0 5px 20px; - background-image: url(file.png); - background-repeat: no-repeat; - background-position: 0 7px; -} - -ul.search li a { - font-weight: bold; -} - -ul.search li div.context { - color: #888; - margin: 2px 0 0 30px; - text-align: left; -} - -ul.keywordmatches li.goodmatch a { - font-weight: bold; -} - -/* -- index page ------------------------------------------------------------ */ - -table.contentstable { - width: 90%; - margin-left: auto; - margin-right: auto; -} - -table.contentstable p.biglink { - line-height: 150%; -} - -a.biglink { - font-size: 1.3em; -} - -span.linkdescr { - font-style: italic; - padding-top: 5px; - font-size: 90%; -} - -/* -- general index --------------------------------------------------------- */ - -table.indextable { - width: 100%; -} - -table.indextable td { - text-align: left; - vertical-align: top; -} - -table.indextable ul { - margin-top: 0; - margin-bottom: 0; - list-style-type: none; -} - -table.indextable > tbody > tr > td > ul { - padding-left: 0em; -} - -table.indextable tr.pcap { - height: 10px; -} - -table.indextable tr.cap { - margin-top: 10px; - background-color: #f2f2f2; -} - -img.toggler { - margin-right: 3px; - margin-top: 3px; - cursor: pointer; -} - -div.modindex-jumpbox { - border-top: 1px solid #ddd; - border-bottom: 1px solid #ddd; - margin: 1em 0 1em 0; - padding: 0.4em; -} - -div.genindex-jumpbox { - border-top: 1px solid #ddd; - border-bottom: 1px solid #ddd; - margin: 1em 0 1em 0; - padding: 0.4em; -} - -/* -- domain module index --------------------------------------------------- */ - -table.modindextable td { - padding: 2px; - border-collapse: collapse; -} - -/* -- general body styles --------------------------------------------------- */ - -div.body { - min-width: 450px; - max-width: 800px; -} - -div.body p, div.body dd, div.body li, div.body blockquote { - -moz-hyphens: auto; - -ms-hyphens: auto; - -webkit-hyphens: auto; - hyphens: auto; -} - -a.headerlink { - visibility: hidden; -} - -a.brackets:before, -span.brackets > a:before{ - content: "["; -} - -a.brackets:after, -span.brackets > a:after { - content: "]"; -} - -h1:hover > a.headerlink, -h2:hover > a.headerlink, -h3:hover > a.headerlink, -h4:hover > a.headerlink, -h5:hover > a.headerlink, -h6:hover > a.headerlink, -dt:hover > a.headerlink, -caption:hover > a.headerlink, -p.caption:hover > a.headerlink, -div.code-block-caption:hover > a.headerlink { - visibility: visible; -} - -div.body p.caption { - text-align: inherit; -} - -div.body td { - text-align: left; -} - -.first { - margin-top: 0 !important; -} - -p.rubric { - margin-top: 30px; - font-weight: bold; -} - -img.align-left, .figure.align-left, object.align-left { - clear: left; - float: left; - margin-right: 1em; -} - -img.align-right, .figure.align-right, object.align-right { - clear: right; - float: right; - margin-left: 1em; -} - -img.align-center, .figure.align-center, object.align-center { - display: block; - margin-left: auto; - margin-right: auto; -} - -img.align-default, .figure.align-default { - display: block; - margin-left: auto; - margin-right: auto; -} - -.align-left { - text-align: left; -} - -.align-center { - text-align: center; -} - -.align-default { - text-align: center; -} - -.align-right { - text-align: right; -} - -/* -- sidebars -------------------------------------------------------------- */ - -div.sidebar { - margin: 0 0 0.5em 1em; - border: 1px solid #ddb; - padding: 7px; - background-color: #ffe; - width: 40%; - float: right; - clear: right; - overflow-x: auto; -} - -p.sidebar-title { - font-weight: bold; -} - -div.admonition, div.topic, blockquote { - clear: left; -} - -/* -- topics ---------------------------------------------------------------- */ - -div.topic { - border: 1px solid #ccc; - padding: 7px; - margin: 10px 0 10px 0; -} - -p.topic-title { - font-size: 1.1em; - font-weight: bold; - margin-top: 10px; -} - -/* -- admonitions ----------------------------------------------------------- */ - -div.admonition { - margin-top: 10px; - margin-bottom: 10px; - padding: 7px; -} - -div.admonition dt { - font-weight: bold; -} - -p.admonition-title { - margin: 0px 10px 5px 0px; - font-weight: bold; -} - -div.body p.centered { - text-align: center; - margin-top: 25px; -} - -/* -- content of sidebars/topics/admonitions -------------------------------- */ - -div.sidebar > :last-child, -div.topic > :last-child, -div.admonition > :last-child { - margin-bottom: 0; -} - -div.sidebar::after, -div.topic::after, -div.admonition::after, -blockquote::after { - display: block; - content: ''; - clear: both; -} - -/* -- tables ---------------------------------------------------------------- */ - -table.docutils { - margin-top: 10px; - margin-bottom: 10px; - border: 0; - border-collapse: collapse; -} - -table.align-center { - margin-left: auto; - margin-right: auto; -} - -table.align-default { - margin-left: auto; - margin-right: auto; -} - -table caption span.caption-number { - font-style: italic; -} - -table caption span.caption-text { -} - -table.docutils td, table.docutils th { - padding: 1px 8px 1px 5px; - border-top: 0; - border-left: 0; - border-right: 0; - border-bottom: 1px solid #aaa; -} - -table.footnote td, table.footnote th { - border: 0 !important; -} - -th { - text-align: left; - padding-right: 5px; -} - -table.citation { - border-left: solid 1px gray; - margin-left: 1px; -} - -table.citation td { - border-bottom: none; -} - -th > :first-child, -td > :first-child { - margin-top: 0px; -} - -th > :last-child, -td > :last-child { - margin-bottom: 0px; -} - -/* -- figures --------------------------------------------------------------- */ - -div.figure { - margin: 0.5em; - padding: 0.5em; -} - -div.figure p.caption { - padding: 0.3em; -} - -div.figure p.caption span.caption-number { - font-style: italic; -} - -div.figure p.caption span.caption-text { -} - -/* -- field list styles ----------------------------------------------------- */ - -table.field-list td, table.field-list th { - border: 0 !important; -} - -.field-list ul { - margin: 0; - padding-left: 1em; -} - -.field-list p { - margin: 0; -} - -.field-name { - -moz-hyphens: manual; - -ms-hyphens: manual; - -webkit-hyphens: manual; - hyphens: manual; -} - -/* -- hlist styles ---------------------------------------------------------- */ - -table.hlist { - margin: 1em 0; -} - -table.hlist td { - vertical-align: top; -} - - -/* -- other body styles ----------------------------------------------------- */ - -ol.arabic { - list-style: decimal; -} - -ol.loweralpha { - list-style: lower-alpha; -} - -ol.upperalpha { - list-style: upper-alpha; -} - -ol.lowerroman { - list-style: lower-roman; -} - -ol.upperroman { - list-style: upper-roman; -} - -:not(li) > ol > li:first-child > :first-child, -:not(li) > ul > li:first-child > :first-child { - margin-top: 0px; -} - -:not(li) > ol > li:last-child > :last-child, -:not(li) > ul > li:last-child > :last-child { - margin-bottom: 0px; -} - -ol.simple ol p, -ol.simple ul p, -ul.simple ol p, -ul.simple ul p { - margin-top: 0; -} - -ol.simple > li:not(:first-child) > p, -ul.simple > li:not(:first-child) > p { - margin-top: 0; -} - -ol.simple p, -ul.simple p { - margin-bottom: 0; -} - -dl.footnote > dt, -dl.citation > dt { - float: left; - margin-right: 0.5em; -} - -dl.footnote > dd, -dl.citation > dd { - margin-bottom: 0em; -} - -dl.footnote > dd:after, -dl.citation > dd:after { - content: ""; - clear: both; -} - -dl.field-list { - display: grid; - grid-template-columns: fit-content(30%) auto; -} - -dl.field-list > dt { - font-weight: bold; - word-break: break-word; - padding-left: 0.5em; - padding-right: 5px; -} - -dl.field-list > dt:after { - content: ":"; -} - -dl.field-list > dd { - padding-left: 0.5em; - margin-top: 0em; - margin-left: 0em; - margin-bottom: 0em; -} - -dl { - margin-bottom: 15px; -} - -dd > :first-child { - margin-top: 0px; -} - -dd ul, dd table { - margin-bottom: 10px; -} - -dd { - margin-top: 3px; - margin-bottom: 10px; - margin-left: 30px; -} - -dl > dd:last-child, -dl > dd:last-child > :last-child { - margin-bottom: 0; -} - -dt:target, span.highlighted { - background-color: #fbe54e; -} - -rect.highlighted { - fill: #fbe54e; -} - -dl.glossary dt { - font-weight: bold; - font-size: 1.1em; -} - -.optional { - font-size: 1.3em; -} - -.sig-paren { - font-size: larger; -} - -.versionmodified { - font-style: italic; -} - -.system-message { - background-color: #fda; - padding: 5px; - border: 3px solid red; -} - -.footnote:target { - background-color: #ffa; -} - -.line-block { - display: block; - margin-top: 1em; - margin-bottom: 1em; -} - -.line-block .line-block { - margin-top: 0; - margin-bottom: 0; - margin-left: 1.5em; -} - -.guilabel, .menuselection { - font-family: sans-serif; -} - -.accelerator { - text-decoration: underline; -} - -.classifier { - font-style: oblique; -} - -.classifier:before { - font-style: normal; - margin: 0.5em; - content: ":"; -} - -abbr, acronym { - border-bottom: dotted 1px; - cursor: help; -} - -/* -- code displays --------------------------------------------------------- */ - -pre { - overflow: auto; - overflow-y: hidden; /* fixes display issues on Chrome browsers */ -} - -pre, div[class*="highlight-"] { - clear: both; -} - -span.pre { - -moz-hyphens: none; - -ms-hyphens: none; - -webkit-hyphens: none; - hyphens: none; -} - -div[class*="highlight-"] { - margin: 1em 0; -} - -td.linenos pre { - border: 0; - background-color: transparent; - color: #aaa; -} - -table.highlighttable { - display: block; -} - -table.highlighttable tbody { - display: block; -} - -table.highlighttable tr { - display: flex; -} - -table.highlighttable td { - margin: 0; - padding: 0; -} - -table.highlighttable td.linenos { - padding-right: 0.5em; -} - -table.highlighttable td.code { - flex: 1; - overflow: hidden; -} - -.highlight .hll { - display: block; -} - -div.highlight pre, -table.highlighttable pre { - margin: 0; -} - -div.code-block-caption + div { - margin-top: 0; -} - -div.code-block-caption { - margin-top: 1em; - padding: 2px 5px; - font-size: small; -} - -div.code-block-caption code { - background-color: transparent; -} - -table.highlighttable td.linenos, -span.linenos, -div.doctest > div.highlight span.gp { /* gp: Generic.Prompt */ - user-select: none; -} - -div.code-block-caption span.caption-number { - padding: 0.1em 0.3em; - font-style: italic; -} - -div.code-block-caption span.caption-text { -} - -div.literal-block-wrapper { - margin: 1em 0; -} - -code.descname { - background-color: transparent; - font-weight: bold; - font-size: 1.2em; -} - -code.descclassname { - background-color: transparent; -} - -code.xref, a code { - background-color: transparent; - font-weight: bold; -} - -h1 code, h2 code, h3 code, h4 code, h5 code, h6 code { - background-color: transparent; -} - -.viewcode-link { - float: right; -} - -.viewcode-back { - float: right; - font-family: sans-serif; -} - -div.viewcode-block:target { - margin: -1px -10px; - padding: 0 10px; -} - -/* -- math display ---------------------------------------------------------- */ - -img.math { - vertical-align: middle; -} - -div.body div.math p { - text-align: center; -} - -span.eqno { - float: right; -} - -span.eqno a.headerlink { - position: absolute; - z-index: 1; -} - -div.math:hover a.headerlink { - visibility: visible; -} - -/* -- printout stylesheet --------------------------------------------------- */ - -@media print { - div.document, - div.documentwrapper, - div.bodywrapper { - margin: 0 !important; - width: 100%; - } - - div.sphinxsidebar, - div.related, - div.footer, - #top-link { - display: none; - } -} \ No newline at end of file diff --git a/doc/LectureNotes/_build/html/_static/clipboard.min.js b/doc/LectureNotes/_build/html/_static/clipboard.min.js deleted file mode 100644 index 02c549e35..000000000 --- a/doc/LectureNotes/_build/html/_static/clipboard.min.js +++ /dev/null @@ -1,7 +0,0 @@ -/*! - * clipboard.js v2.0.4 - * https://zenorocha.github.io/clipboard.js - * - * Licensed MIT © Zeno Rocha - */ -!function(t,e){"object"==typeof exports&&"object"==typeof module?module.exports=e():"function"==typeof define&&define.amd?define([],e):"object"==typeof exports?exports.ClipboardJS=e():t.ClipboardJS=e()}(this,function(){return function(n){var o={};function r(t){if(o[t])return o[t].exports;var e=o[t]={i:t,l:!1,exports:{}};return n[t].call(e.exports,e,e.exports,r),e.l=!0,e.exports}return r.m=n,r.c=o,r.d=function(t,e,n){r.o(t,e)||Object.defineProperty(t,e,{enumerable:!0,get:n})},r.r=function(t){"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(t,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(t,"__esModule",{value:!0})},r.t=function(e,t){if(1&t&&(e=r(e)),8&t)return e;if(4&t&&"object"==typeof e&&e&&e.__esModule)return e;var n=Object.create(null);if(r.r(n),Object.defineProperty(n,"default",{enumerable:!0,value:e}),2&t&&"string"!=typeof e)for(var o in e)r.d(n,o,function(t){return e[t]}.bind(null,o));return n},r.n=function(t){var e=t&&t.__esModule?function(){return t.default}:function(){return t};return r.d(e,"a",e),e},r.o=function(t,e){return Object.prototype.hasOwnProperty.call(t,e)},r.p="",r(r.s=0)}([function(t,e,n){"use strict";var r="function"==typeof Symbol&&"symbol"==typeof Symbol.iterator?function(t){return typeof t}:function(t){return t&&"function"==typeof Symbol&&t.constructor===Symbol&&t!==Symbol.prototype?"symbol":typeof t},i=function(){function o(t,e){for(var n=0;n - - - - diff --git a/doc/LectureNotes/_build/html/_static/copybutton.css b/doc/LectureNotes/_build/html/_static/copybutton.css deleted file mode 100644 index 75b17a83d..000000000 --- a/doc/LectureNotes/_build/html/_static/copybutton.css +++ /dev/null @@ -1,67 +0,0 @@ -/* Copy buttons */ -a.copybtn { - position: absolute; - top: .2em; - right: .2em; - width: 1em; - height: 1em; - opacity: .3; - transition: opacity 0.5s; - border: none; - user-select: none; -} - -div.highlight { - position: relative; -} - -a.copybtn > img { - vertical-align: top; - margin: 0; - top: 0; - left: 0; - position: absolute; -} - -.highlight:hover .copybtn { - opacity: 1; -} - -/** - * A minimal CSS-only tooltip copied from: - * https://codepen.io/mildrenben/pen/rVBrpK - * - * To use, write HTML like the following: - * - *

Short

- */ - .o-tooltip--left { - position: relative; - } - - .o-tooltip--left:after { - opacity: 0; - visibility: hidden; - position: absolute; - content: attr(data-tooltip); - padding: 2px; - top: 0; - left: -.2em; - background: grey; - font-size: 1rem; - color: white; - white-space: nowrap; - z-index: 2; - border-radius: 2px; - transform: translateX(-102%) translateY(0); - transition: opacity 0.2s cubic-bezier(0.64, 0.09, 0.08, 1), transform 0.2s cubic-bezier(0.64, 0.09, 0.08, 1); -} - -.o-tooltip--left:hover:after { - display: block; - opacity: 1; - visibility: visible; - transform: translateX(-100%) translateY(0); - transition: opacity 0.2s cubic-bezier(0.64, 0.09, 0.08, 1), transform 0.2s cubic-bezier(0.64, 0.09, 0.08, 1); - transition-delay: .5s; -} diff --git a/doc/LectureNotes/_build/html/_static/copybutton.js b/doc/LectureNotes/_build/html/_static/copybutton.js deleted file mode 100644 index 65a59167a..000000000 --- a/doc/LectureNotes/_build/html/_static/copybutton.js +++ /dev/null @@ -1,153 +0,0 @@ -// Localization support -const messages = { - 'en': { - 'copy': 'Copy', - 'copy_to_clipboard': 'Copy to clipboard', - 'copy_success': 'Copied!', - 'copy_failure': 'Failed to copy', - }, - 'es' : { - 'copy': 'Copiar', - 'copy_to_clipboard': 'Copiar al portapapeles', - 'copy_success': '¡Copiado!', - 'copy_failure': 'Error al copiar', - }, - 'de' : { - 'copy': 'Kopieren', - 'copy_to_clipboard': 'In die Zwischenablage kopieren', - 'copy_success': 'Kopiert!', - 'copy_failure': 'Fehler beim Kopieren', - } -} - -let locale = 'en' -if( document.documentElement.lang !== undefined - && messages[document.documentElement.lang] !== undefined ) { - locale = document.documentElement.lang -} - -/** - * Set up copy/paste for code blocks - */ - -const runWhenDOMLoaded = cb => { - if (document.readyState != 'loading') { - cb() - } else if (document.addEventListener) { - document.addEventListener('DOMContentLoaded', cb) - } else { - document.attachEvent('onreadystatechange', function() { - if (document.readyState == 'complete') cb() - }) - } -} - -const codeCellId = index => `codecell${index}` - -// Clears selected text since ClipboardJS will select the text when copying -const clearSelection = () => { - if (window.getSelection) { - window.getSelection().removeAllRanges() - } else if (document.selection) { - document.selection.empty() - } -} - -// Changes tooltip text for two seconds, then changes it back -const temporarilyChangeTooltip = (el, newText) => { - const oldText = el.getAttribute('data-tooltip') - el.setAttribute('data-tooltip', newText) - setTimeout(() => el.setAttribute('data-tooltip', oldText), 2000) -} - -const addCopyButtonToCodeCells = () => { - // If ClipboardJS hasn't loaded, wait a bit and try again. This - // happens because we load ClipboardJS asynchronously. - if (window.ClipboardJS === undefined) { - setTimeout(addCopyButtonToCodeCells, 250) - return - } - - // Add copybuttons to all of our code cells - const codeCells = document.querySelectorAll('div.highlight pre') - codeCells.forEach((codeCell, index) => { - const id = codeCellId(index) - codeCell.setAttribute('id', id) - const pre_bg = getComputedStyle(codeCell).backgroundColor; - - const clipboardButton = id => - ` - ${messages[locale]['copy_to_clipboard']} - ` - codeCell.insertAdjacentHTML('afterend', clipboardButton(id)) - }) - -function escapeRegExp(string) { - return string.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'); // $& means the whole matched string -} - -// Callback when a copy button is clicked. Will be passed the node that was clicked -// should then grab the text and replace pieces of text that shouldn't be used in output -function formatCopyText(textContent, copybuttonPromptText, isRegexp = false, onlyCopyPromptLines = true, removePrompts = true) { - - var regexp; - var match; - - // create regexp to capture prompt and remaining line - if (isRegexp) { - regexp = new RegExp('^(' + copybuttonPromptText + ')(.*)') - } else { - regexp = new RegExp('^(' + escapeRegExp(copybuttonPromptText) + ')(.*)') - } - - const outputLines = []; - var promptFound = false; - for (const line of textContent.split('\n')) { - match = line.match(regexp) - if (match) { - promptFound = true - if (removePrompts) { - outputLines.push(match[2]) - } else { - outputLines.push(line) - } - } else { - if (!onlyCopyPromptLines) { - outputLines.push(line) - } - } - } - - // If no lines with the prompt were found then just use original lines - if (promptFound) { - textContent = outputLines.join('\n'); - } - - // Remove a trailing newline to avoid auto-running when pasting - if (textContent.endsWith("\n")) { - textContent = textContent.slice(0, -1) - } - return textContent -} - - -var copyTargetText = (trigger) => { - var target = document.querySelector(trigger.attributes['data-clipboard-target'].value); - return formatCopyText(target.innerText, '', false, true, true) -} - - // Initialize with a callback so we can modify the text before copy - const clipboard = new ClipboardJS('.copybtn', {text: copyTargetText}) - - // Update UI with error/success messages - clipboard.on('success', event => { - clearSelection() - temporarilyChangeTooltip(event.trigger, messages[locale]['copy_success']) - }) - - clipboard.on('error', event => { - temporarilyChangeTooltip(event.trigger, messages[locale]['copy_failure']) - }) -} - -runWhenDOMLoaded(addCopyButtonToCodeCells) \ No newline at end of file diff --git a/doc/LectureNotes/_build/html/_static/copybutton_funcs.js b/doc/LectureNotes/_build/html/_static/copybutton_funcs.js deleted file mode 100644 index 57caa5585..000000000 --- a/doc/LectureNotes/_build/html/_static/copybutton_funcs.js +++ /dev/null @@ -1,47 +0,0 @@ -function escapeRegExp(string) { - return string.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'); // $& means the whole matched string -} - -// Callback when a copy button is clicked. Will be passed the node that was clicked -// should then grab the text and replace pieces of text that shouldn't be used in output -export function formatCopyText(textContent, copybuttonPromptText, isRegexp = false, onlyCopyPromptLines = true, removePrompts = true) { - - var regexp; - var match; - - // create regexp to capture prompt and remaining line - if (isRegexp) { - regexp = new RegExp('^(' + copybuttonPromptText + ')(.*)') - } else { - regexp = new RegExp('^(' + escapeRegExp(copybuttonPromptText) + ')(.*)') - } - - const outputLines = []; - var promptFound = false; - for (const line of textContent.split('\n')) { - match = line.match(regexp) - if (match) { - promptFound = true - if (removePrompts) { - outputLines.push(match[2]) - } else { - outputLines.push(line) - } - } else { - if (!onlyCopyPromptLines) { - outputLines.push(line) - } - } - } - - // If no lines with the prompt were found then just use original lines - if (promptFound) { - textContent = outputLines.join('\n'); - } - - // Remove a trailing newline to avoid auto-running when pasting - if (textContent.endsWith("\n")) { - textContent = textContent.slice(0, -1) - } - return textContent -} diff --git a/doc/LectureNotes/_build/html/_static/css/index.c5995385ac14fb8791e8eb36b4908be2.css b/doc/LectureNotes/_build/html/_static/css/index.c5995385ac14fb8791e8eb36b4908be2.css deleted file mode 100644 index 655656dbd..000000000 --- a/doc/LectureNotes/_build/html/_static/css/index.c5995385ac14fb8791e8eb36b4908be2.css +++ /dev/null @@ -1,6 +0,0 @@ -/*! - * Bootstrap v4.5.0 (https://getbootstrap.com/) - * Copyright 2011-2020 The Bootstrap Authors - * Copyright 2011-2020 Twitter, Inc. - * Licensed under MIT (https://github.com/twbs/bootstrap/blob/master/LICENSE) - */:root{--blue:#007bff;--indigo:#6610f2;--purple:#6f42c1;--pink:#e83e8c;--red:#dc3545;--orange:#fd7e14;--yellow:#ffc107;--green:#28a745;--teal:#20c997;--cyan:#17a2b8;--white:#fff;--gray:#6c757d;--gray-dark:#343a40;--primary:#007bff;--secondary:#6c757d;--success:#28a745;--info:#17a2b8;--warning:#ffc107;--danger:#dc3545;--light:#f8f9fa;--dark:#343a40;--breakpoint-xs:0;--breakpoint-sm:540px;--breakpoint-md:720px;--breakpoint-lg:960px;--breakpoint-xl:1200px;--font-family-sans-serif:-apple-system,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Arial,"Noto Sans",sans-serif,"Apple Color Emoji","Segoe UI Emoji","Segoe UI Symbol","Noto Color Emoji";--font-family-monospace:SFMono-Regular,Menlo,Monaco,Consolas,"Liberation Mono","Courier New",monospace}*,:after,:before{box-sizing:border-box}html{font-family:sans-serif;line-height:1.15;-webkit-text-size-adjust:100%;-webkit-tap-highlight-color:rgba(0,0,0,0)}article,aside,figcaption,figure,footer,header,hgroup,main,nav,section{display:block}body{margin:0;font-family:-apple-system,BlinkMacSystemFont,Segoe UI,Roboto,Helvetica Neue,Arial,Noto Sans,sans-serif,Apple Color Emoji,Segoe UI Emoji,Segoe UI Symbol,Noto Color Emoji;font-size:1rem;line-height:1.5;color:#212529;text-align:left}[tabindex="-1"]:focus:not(:focus-visible){outline:0!important}hr{box-sizing:content-box;height:0;overflow:visible}h1,h2,h3,h4,h5,h6{margin-top:0;margin-bottom:.5rem}p{margin-top:0;margin-bottom:1rem}abbr[data-original-title],abbr[title]{text-decoration:underline;text-decoration:underline dotted;cursor:help;border-bottom:0;text-decoration-skip-ink:none}address{font-style:normal;line-height:inherit}address,dl,ol,ul{margin-bottom:1rem}dl,ol,ul{margin-top:0}ol ol,ol ul,ul ol,ul ul{margin-bottom:0}dt{font-weight:700}dd{margin-bottom:.5rem;margin-left:0}blockquote{margin:0 0 1rem}b,strong{font-weight:bolder}small{font-size:80%}sub,sup{position:relative;font-size:75%;line-height:0;vertical-align:baseline}sub{bottom:-.25em}sup{top:-.5em}a{color:#007bff;background-color:transparent}a:hover{color:#0056b3}a:not([href]),a:not([href]):hover{color:inherit;text-decoration:none}code,kbd,pre,samp{font-family:SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace;font-size:1em}pre{margin-top:0;margin-bottom:1rem;overflow:auto;-ms-overflow-style:scrollbar}figure{margin:0 0 1rem}img{border-style:none}img,svg{vertical-align:middle}svg{overflow:hidden}table{border-collapse:collapse}caption{padding-top:.75rem;padding-bottom:.75rem;color:#6c757d;text-align:left;caption-side:bottom}th{text-align:inherit}label{display:inline-block;margin-bottom:.5rem}button{border-radius:0}button:focus{outline:1px dotted;outline:5px auto -webkit-focus-ring-color}button,input,optgroup,select,textarea{margin:0;font-family:inherit;font-size:inherit;line-height:inherit}button,input{overflow:visible}button,select{text-transform:none}[role=button]{cursor:pointer}select{word-wrap:normal}[type=button],[type=reset],[type=submit],button{-webkit-appearance:button}[type=button]:not(:disabled),[type=reset]:not(:disabled),[type=submit]:not(:disabled),button:not(:disabled){cursor:pointer}[type=button]::-moz-focus-inner,[type=reset]::-moz-focus-inner,[type=submit]::-moz-focus-inner,button::-moz-focus-inner{padding:0;border-style:none}input[type=checkbox],input[type=radio]{box-sizing:border-box;padding:0}textarea{overflow:auto;resize:vertical}fieldset{min-width:0;padding:0;margin:0;border:0}legend{display:block;width:100%;max-width:100%;padding:0;margin-bottom:.5rem;font-size:1.5rem;line-height:inherit;color:inherit;white-space:normal}progress{vertical-align:baseline}[type=number]::-webkit-inner-spin-button,[type=number]::-webkit-outer-spin-button{height:auto}[type=search]{outline-offset:-2px;-webkit-appearance:none}[type=search]::-webkit-search-decoration{-webkit-appearance:none}::-webkit-file-upload-button{font:inherit;-webkit-appearance:button}output{display:inline-block}summary{display:list-item;cursor:pointer}template{display:none}[hidden]{display:none!important}.h1,.h2,.h3,.h4,.h5,.h6,h1,h2,h3,h4,h5,h6{margin-bottom:.5rem;font-weight:500;line-height:1.2}.h1,h1{font-size:2.5rem}.h2,h2{font-size:2rem}.h3,h3{font-size:1.75rem}.h4,h4{font-size:1.5rem}.h5,h5{font-size:1.25rem}.h6,h6{font-size:1rem}.lead{font-size:1.25rem;font-weight:300}.display-1{font-size:6rem}.display-1,.display-2{font-weight:300;line-height:1.2}.display-2{font-size:5.5rem}.display-3{font-size:4.5rem}.display-3,.display-4{font-weight:300;line-height:1.2}.display-4{font-size:3.5rem}hr{margin-top:1rem;margin-bottom:1rem;border-top:1px solid rgba(0,0,0,.1)}.small,small{font-size:80%;font-weight:400}.mark,mark{padding:.2em;background-color:#fcf8e3}.list-inline,.list-unstyled{padding-left:0;list-style:none}.list-inline-item{display:inline-block}.list-inline-item:not(:last-child){margin-right:.5rem}.initialism{font-size:90%;text-transform:uppercase}.blockquote{margin-bottom:1rem;font-size:1.25rem}.blockquote-footer{display:block;font-size:80%;color:#6c757d}.blockquote-footer:before{content:"\2014\00A0"}.img-fluid,.img-thumbnail{max-width:100%;height:auto}.img-thumbnail{padding:.25rem;background-color:#fff;border:1px solid #dee2e6;border-radius:.25rem}.figure{display:inline-block}.figure-img{margin-bottom:.5rem;line-height:1}.figure-caption{font-size:90%;color:#6c757d}code{font-size:87.5%;color:#e83e8c;word-wrap:break-word}a>code{color:inherit}kbd{padding:.2rem .4rem;font-size:87.5%;color:#fff;background-color:#212529;border-radius:.2rem}kbd kbd{padding:0;font-size:100%;font-weight:700}pre{display:block;font-size:87.5%;color:#212529}pre code{font-size:inherit;color:inherit;word-break:normal}.pre-scrollable{max-height:340px;overflow-y:scroll}.container{width:100%;padding-right:15px;padding-left:15px;margin-right:auto;margin-left:auto}@media (min-width:540px){.container{max-width:540px}}@media (min-width:720px){.container{max-width:720px}}@media (min-width:960px){.container{max-width:960px}}@media (min-width:1200px){.container{max-width:1400px}}.container-fluid,.container-lg,.container-md,.container-sm,.container-xl{width:100%;padding-right:15px;padding-left:15px;margin-right:auto;margin-left:auto}@media (min-width:540px){.container,.container-sm{max-width:540px}}@media (min-width:720px){.container,.container-md,.container-sm{max-width:720px}}@media (min-width:960px){.container,.container-lg,.container-md,.container-sm{max-width:960px}}@media (min-width:1200px){.container,.container-lg,.container-md,.container-sm,.container-xl{max-width:1400px}}.row{display:flex;flex-wrap:wrap;margin-right:-15px;margin-left:-15px}.no-gutters{margin-right:0;margin-left:0}.no-gutters>.col,.no-gutters>[class*=col-]{padding-right:0;padding-left:0}.col,.col-1,.col-2,.col-3,.col-4,.col-5,.col-6,.col-7,.col-8,.col-9,.col-10,.col-11,.col-12,.col-auto,.col-lg,.col-lg-1,.col-lg-2,.col-lg-3,.col-lg-4,.col-lg-5,.col-lg-6,.col-lg-7,.col-lg-8,.col-lg-9,.col-lg-10,.col-lg-11,.col-lg-12,.col-lg-auto,.col-md,.col-md-1,.col-md-2,.col-md-3,.col-md-4,.col-md-5,.col-md-6,.col-md-7,.col-md-8,.col-md-9,.col-md-10,.col-md-11,.col-md-12,.col-md-auto,.col-sm,.col-sm-1,.col-sm-2,.col-sm-3,.col-sm-4,.col-sm-5,.col-sm-6,.col-sm-7,.col-sm-8,.col-sm-9,.col-sm-10,.col-sm-11,.col-sm-12,.col-sm-auto,.col-xl,.col-xl-1,.col-xl-2,.col-xl-3,.col-xl-4,.col-xl-5,.col-xl-6,.col-xl-7,.col-xl-8,.col-xl-9,.col-xl-10,.col-xl-11,.col-xl-12,.col-xl-auto{position:relative;width:100%;padding-right:15px;padding-left:15px}.col{flex-basis:0;flex-grow:1;min-width:0;max-width:100%}.row-cols-1>*{flex:0 0 100%;max-width:100%}.row-cols-2>*{flex:0 0 50%;max-width:50%}.row-cols-3>*{flex:0 0 33.33333%;max-width:33.33333%}.row-cols-4>*{flex:0 0 25%;max-width:25%}.row-cols-5>*{flex:0 0 20%;max-width:20%}.row-cols-6>*{flex:0 0 16.66667%;max-width:16.66667%}.col-auto{flex:0 0 auto;width:auto;max-width:100%}.col-1{flex:0 0 8.33333%;max-width:8.33333%}.col-2{flex:0 0 16.66667%;max-width:16.66667%}.col-3{flex:0 0 25%;max-width:25%}.col-4{flex:0 0 33.33333%;max-width:33.33333%}.col-5{flex:0 0 41.66667%;max-width:41.66667%}.col-6{flex:0 0 50%;max-width:50%}.col-7{flex:0 0 58.33333%;max-width:58.33333%}.col-8{flex:0 0 66.66667%;max-width:66.66667%}.col-9{flex:0 0 75%;max-width:75%}.col-10{flex:0 0 83.33333%;max-width:83.33333%}.col-11{flex:0 0 91.66667%;max-width:91.66667%}.col-12{flex:0 0 100%;max-width:100%}.order-first{order:-1}.order-last{order:13}.order-0{order:0}.order-1{order:1}.order-2{order:2}.order-3{order:3}.order-4{order:4}.order-5{order:5}.order-6{order:6}.order-7{order:7}.order-8{order:8}.order-9{order:9}.order-10{order:10}.order-11{order:11}.order-12{order:12}.offset-1{margin-left:8.33333%}.offset-2{margin-left:16.66667%}.offset-3{margin-left:25%}.offset-4{margin-left:33.33333%}.offset-5{margin-left:41.66667%}.offset-6{margin-left:50%}.offset-7{margin-left:58.33333%}.offset-8{margin-left:66.66667%}.offset-9{margin-left:75%}.offset-10{margin-left:83.33333%}.offset-11{margin-left:91.66667%}@media (min-width:540px){.col-sm{flex-basis:0;flex-grow:1;min-width:0;max-width:100%}.row-cols-sm-1>*{flex:0 0 100%;max-width:100%}.row-cols-sm-2>*{flex:0 0 50%;max-width:50%}.row-cols-sm-3>*{flex:0 0 33.33333%;max-width:33.33333%}.row-cols-sm-4>*{flex:0 0 25%;max-width:25%}.row-cols-sm-5>*{flex:0 0 20%;max-width:20%}.row-cols-sm-6>*{flex:0 0 16.66667%;max-width:16.66667%}.col-sm-auto{flex:0 0 auto;width:auto;max-width:100%}.col-sm-1{flex:0 0 8.33333%;max-width:8.33333%}.col-sm-2{flex:0 0 16.66667%;max-width:16.66667%}.col-sm-3{flex:0 0 25%;max-width:25%}.col-sm-4{flex:0 0 33.33333%;max-width:33.33333%}.col-sm-5{flex:0 0 41.66667%;max-width:41.66667%}.col-sm-6{flex:0 0 50%;max-width:50%}.col-sm-7{flex:0 0 58.33333%;max-width:58.33333%}.col-sm-8{flex:0 0 66.66667%;max-width:66.66667%}.col-sm-9{flex:0 0 75%;max-width:75%}.col-sm-10{flex:0 0 83.33333%;max-width:83.33333%}.col-sm-11{flex:0 0 91.66667%;max-width:91.66667%}.col-sm-12{flex:0 0 100%;max-width:100%}.order-sm-first{order:-1}.order-sm-last{order:13}.order-sm-0{order:0}.order-sm-1{order:1}.order-sm-2{order:2}.order-sm-3{order:3}.order-sm-4{order:4}.order-sm-5{order:5}.order-sm-6{order:6}.order-sm-7{order:7}.order-sm-8{order:8}.order-sm-9{order:9}.order-sm-10{order:10}.order-sm-11{order:11}.order-sm-12{order:12}.offset-sm-0{margin-left:0}.offset-sm-1{margin-left:8.33333%}.offset-sm-2{margin-left:16.66667%}.offset-sm-3{margin-left:25%}.offset-sm-4{margin-left:33.33333%}.offset-sm-5{margin-left:41.66667%}.offset-sm-6{margin-left:50%}.offset-sm-7{margin-left:58.33333%}.offset-sm-8{margin-left:66.66667%}.offset-sm-9{margin-left:75%}.offset-sm-10{margin-left:83.33333%}.offset-sm-11{margin-left:91.66667%}}@media (min-width:720px){.col-md{flex-basis:0;flex-grow:1;min-width:0;max-width:100%}.row-cols-md-1>*{flex:0 0 100%;max-width:100%}.row-cols-md-2>*{flex:0 0 50%;max-width:50%}.row-cols-md-3>*{flex:0 0 33.33333%;max-width:33.33333%}.row-cols-md-4>*{flex:0 0 25%;max-width:25%}.row-cols-md-5>*{flex:0 0 20%;max-width:20%}.row-cols-md-6>*{flex:0 0 16.66667%;max-width:16.66667%}.col-md-auto{flex:0 0 auto;width:auto;max-width:100%}.col-md-1{flex:0 0 8.33333%;max-width:8.33333%}.col-md-2{flex:0 0 16.66667%;max-width:16.66667%}.col-md-3{flex:0 0 25%;max-width:25%}.col-md-4{flex:0 0 33.33333%;max-width:33.33333%}.col-md-5{flex:0 0 41.66667%;max-width:41.66667%}.col-md-6{flex:0 0 50%;max-width:50%}.col-md-7{flex:0 0 58.33333%;max-width:58.33333%}.col-md-8{flex:0 0 66.66667%;max-width:66.66667%}.col-md-9{flex:0 0 75%;max-width:75%}.col-md-10{flex:0 0 83.33333%;max-width:83.33333%}.col-md-11{flex:0 0 91.66667%;max-width:91.66667%}.col-md-12{flex:0 0 100%;max-width:100%}.order-md-first{order:-1}.order-md-last{order:13}.order-md-0{order:0}.order-md-1{order:1}.order-md-2{order:2}.order-md-3{order:3}.order-md-4{order:4}.order-md-5{order:5}.order-md-6{order:6}.order-md-7{order:7}.order-md-8{order:8}.order-md-9{order:9}.order-md-10{order:10}.order-md-11{order:11}.order-md-12{order:12}.offset-md-0{margin-left:0}.offset-md-1{margin-left:8.33333%}.offset-md-2{margin-left:16.66667%}.offset-md-3{margin-left:25%}.offset-md-4{margin-left:33.33333%}.offset-md-5{margin-left:41.66667%}.offset-md-6{margin-left:50%}.offset-md-7{margin-left:58.33333%}.offset-md-8{margin-left:66.66667%}.offset-md-9{margin-left:75%}.offset-md-10{margin-left:83.33333%}.offset-md-11{margin-left:91.66667%}}@media (min-width:960px){.col-lg{flex-basis:0;flex-grow:1;min-width:0;max-width:100%}.row-cols-lg-1>*{flex:0 0 100%;max-width:100%}.row-cols-lg-2>*{flex:0 0 50%;max-width:50%}.row-cols-lg-3>*{flex:0 0 33.33333%;max-width:33.33333%}.row-cols-lg-4>*{flex:0 0 25%;max-width:25%}.row-cols-lg-5>*{flex:0 0 20%;max-width:20%}.row-cols-lg-6>*{flex:0 0 16.66667%;max-width:16.66667%}.col-lg-auto{flex:0 0 auto;width:auto;max-width:100%}.col-lg-1{flex:0 0 8.33333%;max-width:8.33333%}.col-lg-2{flex:0 0 16.66667%;max-width:16.66667%}.col-lg-3{flex:0 0 25%;max-width:25%}.col-lg-4{flex:0 0 33.33333%;max-width:33.33333%}.col-lg-5{flex:0 0 41.66667%;max-width:41.66667%}.col-lg-6{flex:0 0 50%;max-width:50%}.col-lg-7{flex:0 0 58.33333%;max-width:58.33333%}.col-lg-8{flex:0 0 66.66667%;max-width:66.66667%}.col-lg-9{flex:0 0 75%;max-width:75%}.col-lg-10{flex:0 0 83.33333%;max-width:83.33333%}.col-lg-11{flex:0 0 91.66667%;max-width:91.66667%}.col-lg-12{flex:0 0 100%;max-width:100%}.order-lg-first{order:-1}.order-lg-last{order:13}.order-lg-0{order:0}.order-lg-1{order:1}.order-lg-2{order:2}.order-lg-3{order:3}.order-lg-4{order:4}.order-lg-5{order:5}.order-lg-6{order:6}.order-lg-7{order:7}.order-lg-8{order:8}.order-lg-9{order:9}.order-lg-10{order:10}.order-lg-11{order:11}.order-lg-12{order:12}.offset-lg-0{margin-left:0}.offset-lg-1{margin-left:8.33333%}.offset-lg-2{margin-left:16.66667%}.offset-lg-3{margin-left:25%}.offset-lg-4{margin-left:33.33333%}.offset-lg-5{margin-left:41.66667%}.offset-lg-6{margin-left:50%}.offset-lg-7{margin-left:58.33333%}.offset-lg-8{margin-left:66.66667%}.offset-lg-9{margin-left:75%}.offset-lg-10{margin-left:83.33333%}.offset-lg-11{margin-left:91.66667%}}@media (min-width:1200px){.col-xl{flex-basis:0;flex-grow:1;min-width:0;max-width:100%}.row-cols-xl-1>*{flex:0 0 100%;max-width:100%}.row-cols-xl-2>*{flex:0 0 50%;max-width:50%}.row-cols-xl-3>*{flex:0 0 33.33333%;max-width:33.33333%}.row-cols-xl-4>*{flex:0 0 25%;max-width:25%}.row-cols-xl-5>*{flex:0 0 20%;max-width:20%}.row-cols-xl-6>*{flex:0 0 16.66667%;max-width:16.66667%}.col-xl-auto{flex:0 0 auto;width:auto;max-width:100%}.col-xl-1{flex:0 0 8.33333%;max-width:8.33333%}.col-xl-2{flex:0 0 16.66667%;max-width:16.66667%}.col-xl-3{flex:0 0 25%;max-width:25%}.col-xl-4{flex:0 0 33.33333%;max-width:33.33333%}.col-xl-5{flex:0 0 41.66667%;max-width:41.66667%}.col-xl-6{flex:0 0 50%;max-width:50%}.col-xl-7{flex:0 0 58.33333%;max-width:58.33333%}.col-xl-8{flex:0 0 66.66667%;max-width:66.66667%}.col-xl-9{flex:0 0 75%;max-width:75%}.col-xl-10{flex:0 0 83.33333%;max-width:83.33333%}.col-xl-11{flex:0 0 91.66667%;max-width:91.66667%}.col-xl-12{flex:0 0 100%;max-width:100%}.order-xl-first{order:-1}.order-xl-last{order:13}.order-xl-0{order:0}.order-xl-1{order:1}.order-xl-2{order:2}.order-xl-3{order:3}.order-xl-4{order:4}.order-xl-5{order:5}.order-xl-6{order:6}.order-xl-7{order:7}.order-xl-8{order:8}.order-xl-9{order:9}.order-xl-10{order:10}.order-xl-11{order:11}.order-xl-12{order:12}.offset-xl-0{margin-left:0}.offset-xl-1{margin-left:8.33333%}.offset-xl-2{margin-left:16.66667%}.offset-xl-3{margin-left:25%}.offset-xl-4{margin-left:33.33333%}.offset-xl-5{margin-left:41.66667%}.offset-xl-6{margin-left:50%}.offset-xl-7{margin-left:58.33333%}.offset-xl-8{margin-left:66.66667%}.offset-xl-9{margin-left:75%}.offset-xl-10{margin-left:83.33333%}.offset-xl-11{margin-left:91.66667%}}.table{width:100%;margin-bottom:1rem;color:#212529}.table td,.table th{padding:.75rem;vertical-align:top;border-top:1px solid #dee2e6}.table thead th{vertical-align:bottom;border-bottom:2px solid #dee2e6}.table tbody+tbody{border-top:2px solid #dee2e6}.table-sm td,.table-sm th{padding:.3rem}.table-bordered,.table-bordered td,.table-bordered th{border:1px solid #dee2e6}.table-bordered thead td,.table-bordered thead th{border-bottom-width:2px}.table-borderless tbody+tbody,.table-borderless td,.table-borderless th,.table-borderless thead th{border:0}.table-striped tbody tr:nth-of-type(odd){background-color:rgba(0,0,0,.05)}.table-hover tbody tr:hover{color:#212529;background-color:rgba(0,0,0,.075)}.table-primary,.table-primary>td,.table-primary>th{background-color:#b8daff}.table-primary tbody+tbody,.table-primary td,.table-primary th,.table-primary thead th{border-color:#7abaff}.table-hover .table-primary:hover,.table-hover .table-primary:hover>td,.table-hover .table-primary:hover>th{background-color:#9fcdff}.table-secondary,.table-secondary>td,.table-secondary>th{background-color:#d6d8db}.table-secondary tbody+tbody,.table-secondary td,.table-secondary th,.table-secondary thead th{border-color:#b3b7bb}.table-hover .table-secondary:hover,.table-hover .table-secondary:hover>td,.table-hover .table-secondary:hover>th{background-color:#c8cbcf}.table-success,.table-success>td,.table-success>th{background-color:#c3e6cb}.table-success tbody+tbody,.table-success td,.table-success th,.table-success thead th{border-color:#8fd19e}.table-hover .table-success:hover,.table-hover .table-success:hover>td,.table-hover .table-success:hover>th{background-color:#b1dfbb}.table-info,.table-info>td,.table-info>th{background-color:#bee5eb}.table-info tbody+tbody,.table-info td,.table-info th,.table-info thead th{border-color:#86cfda}.table-hover .table-info:hover,.table-hover .table-info:hover>td,.table-hover .table-info:hover>th{background-color:#abdde5}.table-warning,.table-warning>td,.table-warning>th{background-color:#ffeeba}.table-warning tbody+tbody,.table-warning td,.table-warning th,.table-warning thead th{border-color:#ffdf7e}.table-hover .table-warning:hover,.table-hover .table-warning:hover>td,.table-hover .table-warning:hover>th{background-color:#ffe8a1}.table-danger,.table-danger>td,.table-danger>th{background-color:#f5c6cb}.table-danger tbody+tbody,.table-danger td,.table-danger th,.table-danger thead th{border-color:#ed969e}.table-hover .table-danger:hover,.table-hover .table-danger:hover>td,.table-hover .table-danger:hover>th{background-color:#f1b0b7}.table-light,.table-light>td,.table-light>th{background-color:#fdfdfe}.table-light tbody+tbody,.table-light td,.table-light th,.table-light thead th{border-color:#fbfcfc}.table-hover .table-light:hover,.table-hover .table-light:hover>td,.table-hover .table-light:hover>th{background-color:#ececf6}.table-dark,.table-dark>td,.table-dark>th{background-color:#c6c8ca}.table-dark tbody+tbody,.table-dark td,.table-dark th,.table-dark thead th{border-color:#95999c}.table-hover .table-dark:hover,.table-hover .table-dark:hover>td,.table-hover .table-dark:hover>th{background-color:#b9bbbe}.table-active,.table-active>td,.table-active>th,.table-hover .table-active:hover,.table-hover .table-active:hover>td,.table-hover .table-active:hover>th{background-color:rgba(0,0,0,.075)}.table .thead-dark th{color:#fff;background-color:#343a40;border-color:#454d55}.table .thead-light th{color:#495057;background-color:#e9ecef;border-color:#dee2e6}.table-dark{color:#fff;background-color:#343a40}.table-dark td,.table-dark th,.table-dark thead th{border-color:#454d55}.table-dark.table-bordered{border:0}.table-dark.table-striped tbody tr:nth-of-type(odd){background-color:hsla(0,0%,100%,.05)}.table-dark.table-hover tbody tr:hover{color:#fff;background-color:hsla(0,0%,100%,.075)}@media (max-width:539.98px){.table-responsive-sm{display:block;width:100%;overflow-x:auto;-webkit-overflow-scrolling:touch}.table-responsive-sm>.table-bordered{border:0}}@media (max-width:719.98px){.table-responsive-md{display:block;width:100%;overflow-x:auto;-webkit-overflow-scrolling:touch}.table-responsive-md>.table-bordered{border:0}}@media (max-width:959.98px){.table-responsive-lg{display:block;width:100%;overflow-x:auto;-webkit-overflow-scrolling:touch}.table-responsive-lg>.table-bordered{border:0}}@media (max-width:1199.98px){.table-responsive-xl{display:block;width:100%;overflow-x:auto;-webkit-overflow-scrolling:touch}.table-responsive-xl>.table-bordered{border:0}}.table-responsive{display:block;width:100%;overflow-x:auto;-webkit-overflow-scrolling:touch}.table-responsive>.table-bordered{border:0}.form-control{display:block;width:100%;height:calc(1.5em + .75rem + 2px);padding:.375rem .75rem;font-size:1rem;font-weight:400;line-height:1.5;color:#495057;background-color:#fff;background-clip:padding-box;border:1px solid #ced4da;border-radius:.25rem;transition:border-color .15s ease-in-out,box-shadow .15s ease-in-out}@media (prefers-reduced-motion:reduce){.form-control{transition:none}}.form-control::-ms-expand{background-color:transparent;border:0}.form-control:-moz-focusring{color:transparent;text-shadow:0 0 0 #495057}.form-control:focus{color:#495057;background-color:#fff;border-color:#80bdff;outline:0;box-shadow:0 0 0 .2rem rgba(0,123,255,.25)}.form-control::placeholder{color:#6c757d;opacity:1}.form-control:disabled,.form-control[readonly]{background-color:#e9ecef;opacity:1}input[type=date].form-control,input[type=datetime-local].form-control,input[type=month].form-control,input[type=time].form-control{appearance:none}select.form-control:focus::-ms-value{color:#495057;background-color:#fff}.form-control-file,.form-control-range{display:block;width:100%}.col-form-label{padding-top:calc(.375rem + 1px);padding-bottom:calc(.375rem + 1px);margin-bottom:0;font-size:inherit;line-height:1.5}.col-form-label-lg{padding-top:calc(.5rem + 1px);padding-bottom:calc(.5rem + 1px);font-size:1.25rem;line-height:1.5}.col-form-label-sm{padding-top:calc(.25rem + 1px);padding-bottom:calc(.25rem + 1px);font-size:.875rem;line-height:1.5}.form-control-plaintext{display:block;width:100%;padding:.375rem 0;margin-bottom:0;font-size:1rem;line-height:1.5;color:#212529;background-color:transparent;border:solid transparent;border-width:1px 0}.form-control-plaintext.form-control-lg,.form-control-plaintext.form-control-sm{padding-right:0;padding-left:0}.form-control-sm{height:calc(1.5em + .5rem + 2px);padding:.25rem .5rem;font-size:.875rem;line-height:1.5;border-radius:.2rem}.form-control-lg{height:calc(1.5em + 1rem + 2px);padding:.5rem 1rem;font-size:1.25rem;line-height:1.5;border-radius:.3rem}select.form-control[multiple],select.form-control[size],textarea.form-control{height:auto}.form-group{margin-bottom:1rem}.form-text{display:block;margin-top:.25rem}.form-row{display:flex;flex-wrap:wrap;margin-right:-5px;margin-left:-5px}.form-row>.col,.form-row>[class*=col-]{padding-right:5px;padding-left:5px}.form-check{position:relative;display:block;padding-left:1.25rem}.form-check-input{position:absolute;margin-top:.3rem;margin-left:-1.25rem}.form-check-input:disabled~.form-check-label,.form-check-input[disabled]~.form-check-label{color:#6c757d}.form-check-label{margin-bottom:0}.form-check-inline{display:inline-flex;align-items:center;padding-left:0;margin-right:.75rem}.form-check-inline .form-check-input{position:static;margin-top:0;margin-right:.3125rem;margin-left:0}.valid-feedback{display:none;width:100%;margin-top:.25rem;font-size:80%;color:#28a745}.valid-tooltip{position:absolute;top:100%;z-index:5;display:none;max-width:100%;padding:.25rem .5rem;margin-top:.1rem;font-size:.875rem;line-height:1.5;color:#fff;background-color:rgba(40,167,69,.9);border-radius:.25rem}.is-valid~.valid-feedback,.is-valid~.valid-tooltip,.was-validated :valid~.valid-feedback,.was-validated :valid~.valid-tooltip{display:block}.form-control.is-valid,.was-validated .form-control:valid{border-color:#28a745;padding-right:calc(1.5em + .75rem);background-image:url("data:image/svg+xml;charset=utf-8,%3Csvg xmlns='http://www.w3.org/2000/svg' width='8' height='8'%3E%3Cpath fill='%2328a745' d='M2.3 6.73L.6 4.53c-.4-1.04.46-1.4 1.1-.8l1.1 1.4 3.4-3.8c.6-.63 1.6-.27 1.2.7l-4 4.6c-.43.5-.8.4-1.1.1z'/%3E%3C/svg%3E");background-repeat:no-repeat;background-position:right calc(.375em + .1875rem) center;background-size:calc(.75em + .375rem) calc(.75em + .375rem)}.form-control.is-valid:focus,.was-validated .form-control:valid:focus{border-color:#28a745;box-shadow:0 0 0 .2rem rgba(40,167,69,.25)}.was-validated textarea.form-control:valid,textarea.form-control.is-valid{padding-right:calc(1.5em + .75rem);background-position:top calc(.375em + .1875rem) right calc(.375em + .1875rem)}.custom-select.is-valid,.was-validated .custom-select:valid{border-color:#28a745;padding-right:calc(.75em + 2.3125rem);background:url("data:image/svg+xml;charset=utf-8,%3Csvg xmlns='http://www.w3.org/2000/svg' width='4' height='5'%3E%3Cpath fill='%23343a40' d='M2 0L0 2h4zm0 5L0 3h4z'/%3E%3C/svg%3E") no-repeat right .75rem center/8px 10px,url("data:image/svg+xml;charset=utf-8,%3Csvg xmlns='http://www.w3.org/2000/svg' width='8' height='8'%3E%3Cpath fill='%2328a745' d='M2.3 6.73L.6 4.53c-.4-1.04.46-1.4 1.1-.8l1.1 1.4 3.4-3.8c.6-.63 1.6-.27 1.2.7l-4 4.6c-.43.5-.8.4-1.1.1z'/%3E%3C/svg%3E") #fff no-repeat center right 1.75rem/calc(.75em + .375rem) calc(.75em + .375rem)}.custom-select.is-valid:focus,.was-validated .custom-select:valid:focus{border-color:#28a745;box-shadow:0 0 0 .2rem rgba(40,167,69,.25)}.form-check-input.is-valid~.form-check-label,.was-validated .form-check-input:valid~.form-check-label{color:#28a745}.form-check-input.is-valid~.valid-feedback,.form-check-input.is-valid~.valid-tooltip,.was-validated .form-check-input:valid~.valid-feedback,.was-validated .form-check-input:valid~.valid-tooltip{display:block}.custom-control-input.is-valid~.custom-control-label,.was-validated .custom-control-input:valid~.custom-control-label{color:#28a745}.custom-control-input.is-valid~.custom-control-label:before,.was-validated .custom-control-input:valid~.custom-control-label:before{border-color:#28a745}.custom-control-input.is-valid:checked~.custom-control-label:before,.was-validated .custom-control-input:valid:checked~.custom-control-label:before{border-color:#34ce57;background-color:#34ce57}.custom-control-input.is-valid:focus~.custom-control-label:before,.was-validated .custom-control-input:valid:focus~.custom-control-label:before{box-shadow:0 0 0 .2rem rgba(40,167,69,.25)}.custom-control-input.is-valid:focus:not(:checked)~.custom-control-label:before,.custom-file-input.is-valid~.custom-file-label,.was-validated .custom-control-input:valid:focus:not(:checked)~.custom-control-label:before,.was-validated .custom-file-input:valid~.custom-file-label{border-color:#28a745}.custom-file-input.is-valid:focus~.custom-file-label,.was-validated .custom-file-input:valid:focus~.custom-file-label{border-color:#28a745;box-shadow:0 0 0 .2rem rgba(40,167,69,.25)}.invalid-feedback{display:none;width:100%;margin-top:.25rem;font-size:80%;color:#dc3545}.invalid-tooltip{position:absolute;top:100%;z-index:5;display:none;max-width:100%;padding:.25rem .5rem;margin-top:.1rem;font-size:.875rem;line-height:1.5;color:#fff;background-color:rgba(220,53,69,.9);border-radius:.25rem}.is-invalid~.invalid-feedback,.is-invalid~.invalid-tooltip,.was-validated :invalid~.invalid-feedback,.was-validated :invalid~.invalid-tooltip{display:block}.form-control.is-invalid,.was-validated .form-control:invalid{border-color:#dc3545;padding-right:calc(1.5em + .75rem);background-image:url("data:image/svg+xml;charset=utf-8,%3Csvg xmlns='http://www.w3.org/2000/svg' width='12' height='12' fill='none' stroke='%23dc3545'%3E%3Ccircle cx='6' cy='6' r='4.5'/%3E%3Cpath stroke-linejoin='round' d='M5.8 3.6h.4L6 6.5z'/%3E%3Ccircle cx='6' cy='8.2' r='.6' fill='%23dc3545' stroke='none'/%3E%3C/svg%3E");background-repeat:no-repeat;background-position:right calc(.375em + .1875rem) center;background-size:calc(.75em + .375rem) calc(.75em + .375rem)}.form-control.is-invalid:focus,.was-validated .form-control:invalid:focus{border-color:#dc3545;box-shadow:0 0 0 .2rem rgba(220,53,69,.25)}.was-validated textarea.form-control:invalid,textarea.form-control.is-invalid{padding-right:calc(1.5em + .75rem);background-position:top calc(.375em + .1875rem) right calc(.375em + .1875rem)}.custom-select.is-invalid,.was-validated .custom-select:invalid{border-color:#dc3545;padding-right:calc(.75em + 2.3125rem);background:url("data:image/svg+xml;charset=utf-8,%3Csvg xmlns='http://www.w3.org/2000/svg' width='4' height='5'%3E%3Cpath fill='%23343a40' d='M2 0L0 2h4zm0 5L0 3h4z'/%3E%3C/svg%3E") no-repeat right .75rem center/8px 10px,url("data:image/svg+xml;charset=utf-8,%3Csvg xmlns='http://www.w3.org/2000/svg' width='12' height='12' fill='none' stroke='%23dc3545'%3E%3Ccircle cx='6' cy='6' r='4.5'/%3E%3Cpath stroke-linejoin='round' d='M5.8 3.6h.4L6 6.5z'/%3E%3Ccircle cx='6' cy='8.2' r='.6' fill='%23dc3545' stroke='none'/%3E%3C/svg%3E") #fff no-repeat center right 1.75rem/calc(.75em + .375rem) calc(.75em + .375rem)}.custom-select.is-invalid:focus,.was-validated .custom-select:invalid:focus{border-color:#dc3545;box-shadow:0 0 0 .2rem rgba(220,53,69,.25)}.form-check-input.is-invalid~.form-check-label,.was-validated .form-check-input:invalid~.form-check-label{color:#dc3545}.form-check-input.is-invalid~.invalid-feedback,.form-check-input.is-invalid~.invalid-tooltip,.was-validated .form-check-input:invalid~.invalid-feedback,.was-validated .form-check-input:invalid~.invalid-tooltip{display:block}.custom-control-input.is-invalid~.custom-control-label,.was-validated .custom-control-input:invalid~.custom-control-label{color:#dc3545}.custom-control-input.is-invalid~.custom-control-label:before,.was-validated .custom-control-input:invalid~.custom-control-label:before{border-color:#dc3545}.custom-control-input.is-invalid:checked~.custom-control-label:before,.was-validated .custom-control-input:invalid:checked~.custom-control-label:before{border-color:#e4606d;background-color:#e4606d}.custom-control-input.is-invalid:focus~.custom-control-label:before,.was-validated .custom-control-input:invalid:focus~.custom-control-label:before{box-shadow:0 0 0 .2rem rgba(220,53,69,.25)}.custom-control-input.is-invalid:focus:not(:checked)~.custom-control-label:before,.custom-file-input.is-invalid~.custom-file-label,.was-validated .custom-control-input:invalid:focus:not(:checked)~.custom-control-label:before,.was-validated .custom-file-input:invalid~.custom-file-label{border-color:#dc3545}.custom-file-input.is-invalid:focus~.custom-file-label,.was-validated .custom-file-input:invalid:focus~.custom-file-label{border-color:#dc3545;box-shadow:0 0 0 .2rem rgba(220,53,69,.25)}.form-inline{display:flex;flex-flow:row wrap;align-items:center}.form-inline .form-check{width:100%}@media (min-width:540px){.form-inline label{justify-content:center}.form-inline .form-group,.form-inline label{display:flex;align-items:center;margin-bottom:0}.form-inline .form-group{flex:0 0 auto;flex-flow:row wrap}.form-inline .form-control{display:inline-block;width:auto;vertical-align:middle}.form-inline .form-control-plaintext{display:inline-block}.form-inline .custom-select,.form-inline .input-group{width:auto}.form-inline .form-check{display:flex;align-items:center;justify-content:center;width:auto;padding-left:0}.form-inline .form-check-input{position:relative;flex-shrink:0;margin-top:0;margin-right:.25rem;margin-left:0}.form-inline .custom-control{align-items:center;justify-content:center}.form-inline .custom-control-label{margin-bottom:0}}.btn{display:inline-block;font-weight:400;color:#212529;text-align:center;vertical-align:middle;user-select:none;background-color:transparent;border:1px solid transparent;padding:.375rem .75rem;font-size:1rem;line-height:1.5;border-radius:.25rem;transition:color .15s ease-in-out,background-color .15s ease-in-out,border-color .15s ease-in-out,box-shadow .15s ease-in-out}@media (prefers-reduced-motion:reduce){.btn{transition:none}}.btn:hover{color:#212529;text-decoration:none}.btn.focus,.btn:focus{outline:0;box-shadow:0 0 0 .2rem rgba(0,123,255,.25)}.btn.disabled,.btn:disabled{opacity:.65}.btn:not(:disabled):not(.disabled){cursor:pointer}a.btn.disabled,fieldset:disabled a.btn{pointer-events:none}.btn-primary{color:#fff;background-color:#007bff;border-color:#007bff}.btn-primary.focus,.btn-primary:focus,.btn-primary:hover{color:#fff;background-color:#0069d9;border-color:#0062cc}.btn-primary.focus,.btn-primary:focus{box-shadow:0 0 0 .2rem rgba(38,143,255,.5)}.btn-primary.disabled,.btn-primary:disabled{color:#fff;background-color:#007bff;border-color:#007bff}.btn-primary:not(:disabled):not(.disabled).active,.btn-primary:not(:disabled):not(.disabled):active,.show>.btn-primary.dropdown-toggle{color:#fff;background-color:#0062cc;border-color:#005cbf}.btn-primary:not(:disabled):not(.disabled).active:focus,.btn-primary:not(:disabled):not(.disabled):active:focus,.show>.btn-primary.dropdown-toggle:focus{box-shadow:0 0 0 .2rem rgba(38,143,255,.5)}.btn-secondary{color:#fff;background-color:#6c757d;border-color:#6c757d}.btn-secondary.focus,.btn-secondary:focus,.btn-secondary:hover{color:#fff;background-color:#5a6268;border-color:#545b62}.btn-secondary.focus,.btn-secondary:focus{box-shadow:0 0 0 .2rem rgba(130,138,145,.5)}.btn-secondary.disabled,.btn-secondary:disabled{color:#fff;background-color:#6c757d;border-color:#6c757d}.btn-secondary:not(:disabled):not(.disabled).active,.btn-secondary:not(:disabled):not(.disabled):active,.show>.btn-secondary.dropdown-toggle{color:#fff;background-color:#545b62;border-color:#4e555b}.btn-secondary:not(:disabled):not(.disabled).active:focus,.btn-secondary:not(:disabled):not(.disabled):active:focus,.show>.btn-secondary.dropdown-toggle:focus{box-shadow:0 0 0 .2rem rgba(130,138,145,.5)}.btn-success{color:#fff;background-color:#28a745;border-color:#28a745}.btn-success.focus,.btn-success:focus,.btn-success:hover{color:#fff;background-color:#218838;border-color:#1e7e34}.btn-success.focus,.btn-success:focus{box-shadow:0 0 0 .2rem rgba(72,180,97,.5)}.btn-success.disabled,.btn-success:disabled{color:#fff;background-color:#28a745;border-color:#28a745}.btn-success:not(:disabled):not(.disabled).active,.btn-success:not(:disabled):not(.disabled):active,.show>.btn-success.dropdown-toggle{color:#fff;background-color:#1e7e34;border-color:#1c7430}.btn-success:not(:disabled):not(.disabled).active:focus,.btn-success:not(:disabled):not(.disabled):active:focus,.show>.btn-success.dropdown-toggle:focus{box-shadow:0 0 0 .2rem rgba(72,180,97,.5)}.btn-info{color:#fff;background-color:#17a2b8;border-color:#17a2b8}.btn-info.focus,.btn-info:focus,.btn-info:hover{color:#fff;background-color:#138496;border-color:#117a8b}.btn-info.focus,.btn-info:focus{box-shadow:0 0 0 .2rem rgba(58,176,195,.5)}.btn-info.disabled,.btn-info:disabled{color:#fff;background-color:#17a2b8;border-color:#17a2b8}.btn-info:not(:disabled):not(.disabled).active,.btn-info:not(:disabled):not(.disabled):active,.show>.btn-info.dropdown-toggle{color:#fff;background-color:#117a8b;border-color:#10707f}.btn-info:not(:disabled):not(.disabled).active:focus,.btn-info:not(:disabled):not(.disabled):active:focus,.show>.btn-info.dropdown-toggle:focus{box-shadow:0 0 0 .2rem rgba(58,176,195,.5)}.btn-warning{color:#212529;background-color:#ffc107;border-color:#ffc107}.btn-warning.focus,.btn-warning:focus,.btn-warning:hover{color:#212529;background-color:#e0a800;border-color:#d39e00}.btn-warning.focus,.btn-warning:focus{box-shadow:0 0 0 .2rem rgba(222,170,12,.5)}.btn-warning.disabled,.btn-warning:disabled{color:#212529;background-color:#ffc107;border-color:#ffc107}.btn-warning:not(:disabled):not(.disabled).active,.btn-warning:not(:disabled):not(.disabled):active,.show>.btn-warning.dropdown-toggle{color:#212529;background-color:#d39e00;border-color:#c69500}.btn-warning:not(:disabled):not(.disabled).active:focus,.btn-warning:not(:disabled):not(.disabled):active:focus,.show>.btn-warning.dropdown-toggle:focus{box-shadow:0 0 0 .2rem rgba(222,170,12,.5)}.btn-danger{color:#fff;background-color:#dc3545;border-color:#dc3545}.btn-danger.focus,.btn-danger:focus,.btn-danger:hover{color:#fff;background-color:#c82333;border-color:#bd2130}.btn-danger.focus,.btn-danger:focus{box-shadow:0 0 0 .2rem rgba(225,83,97,.5)}.btn-danger.disabled,.btn-danger:disabled{color:#fff;background-color:#dc3545;border-color:#dc3545}.btn-danger:not(:disabled):not(.disabled).active,.btn-danger:not(:disabled):not(.disabled):active,.show>.btn-danger.dropdown-toggle{color:#fff;background-color:#bd2130;border-color:#b21f2d}.btn-danger:not(:disabled):not(.disabled).active:focus,.btn-danger:not(:disabled):not(.disabled):active:focus,.show>.btn-danger.dropdown-toggle:focus{box-shadow:0 0 0 .2rem rgba(225,83,97,.5)}.btn-light{color:#212529;background-color:#f8f9fa;border-color:#f8f9fa}.btn-light.focus,.btn-light:focus,.btn-light:hover{color:#212529;background-color:#e2e6ea;border-color:#dae0e5}.btn-light.focus,.btn-light:focus{box-shadow:0 0 0 .2rem rgba(216,217,219,.5)}.btn-light.disabled,.btn-light:disabled{color:#212529;background-color:#f8f9fa;border-color:#f8f9fa}.btn-light:not(:disabled):not(.disabled).active,.btn-light:not(:disabled):not(.disabled):active,.show>.btn-light.dropdown-toggle{color:#212529;background-color:#dae0e5;border-color:#d3d9df}.btn-light:not(:disabled):not(.disabled).active:focus,.btn-light:not(:disabled):not(.disabled):active:focus,.show>.btn-light.dropdown-toggle:focus{box-shadow:0 0 0 .2rem rgba(216,217,219,.5)}.btn-dark{color:#fff;background-color:#343a40;border-color:#343a40}.btn-dark.focus,.btn-dark:focus,.btn-dark:hover{color:#fff;background-color:#23272b;border-color:#1d2124}.btn-dark.focus,.btn-dark:focus{box-shadow:0 0 0 .2rem rgba(82,88,93,.5)}.btn-dark.disabled,.btn-dark:disabled{color:#fff;background-color:#343a40;border-color:#343a40}.btn-dark:not(:disabled):not(.disabled).active,.btn-dark:not(:disabled):not(.disabled):active,.show>.btn-dark.dropdown-toggle{color:#fff;background-color:#1d2124;border-color:#171a1d}.btn-dark:not(:disabled):not(.disabled).active:focus,.btn-dark:not(:disabled):not(.disabled):active:focus,.show>.btn-dark.dropdown-toggle:focus{box-shadow:0 0 0 .2rem rgba(82,88,93,.5)}.btn-outline-primary{color:#007bff;border-color:#007bff}.btn-outline-primary:hover{color:#fff;background-color:#007bff;border-color:#007bff}.btn-outline-primary.focus,.btn-outline-primary:focus{box-shadow:0 0 0 .2rem rgba(0,123,255,.5)}.btn-outline-primary.disabled,.btn-outline-primary:disabled{color:#007bff;background-color:transparent}.btn-outline-primary:not(:disabled):not(.disabled).active,.btn-outline-primary:not(:disabled):not(.disabled):active,.show>.btn-outline-primary.dropdown-toggle{color:#fff;background-color:#007bff;border-color:#007bff}.btn-outline-primary:not(:disabled):not(.disabled).active:focus,.btn-outline-primary:not(:disabled):not(.disabled):active:focus,.show>.btn-outline-primary.dropdown-toggle:focus{box-shadow:0 0 0 .2rem rgba(0,123,255,.5)}.btn-outline-secondary{color:#6c757d;border-color:#6c757d}.btn-outline-secondary:hover{color:#fff;background-color:#6c757d;border-color:#6c757d}.btn-outline-secondary.focus,.btn-outline-secondary:focus{box-shadow:0 0 0 .2rem rgba(108,117,125,.5)}.btn-outline-secondary.disabled,.btn-outline-secondary:disabled{color:#6c757d;background-color:transparent}.btn-outline-secondary:not(:disabled):not(.disabled).active,.btn-outline-secondary:not(:disabled):not(.disabled):active,.show>.btn-outline-secondary.dropdown-toggle{color:#fff;background-color:#6c757d;border-color:#6c757d}.btn-outline-secondary:not(:disabled):not(.disabled).active:focus,.btn-outline-secondary:not(:disabled):not(.disabled):active:focus,.show>.btn-outline-secondary.dropdown-toggle:focus{box-shadow:0 0 0 .2rem rgba(108,117,125,.5)}.btn-outline-success{color:#28a745;border-color:#28a745}.btn-outline-success:hover{color:#fff;background-color:#28a745;border-color:#28a745}.btn-outline-success.focus,.btn-outline-success:focus{box-shadow:0 0 0 .2rem rgba(40,167,69,.5)}.btn-outline-success.disabled,.btn-outline-success:disabled{color:#28a745;background-color:transparent}.btn-outline-success:not(:disabled):not(.disabled).active,.btn-outline-success:not(:disabled):not(.disabled):active,.show>.btn-outline-success.dropdown-toggle{color:#fff;background-color:#28a745;border-color:#28a745}.btn-outline-success:not(:disabled):not(.disabled).active:focus,.btn-outline-success:not(:disabled):not(.disabled):active:focus,.show>.btn-outline-success.dropdown-toggle:focus{box-shadow:0 0 0 .2rem rgba(40,167,69,.5)}.btn-outline-info{color:#17a2b8;border-color:#17a2b8}.btn-outline-info:hover{color:#fff;background-color:#17a2b8;border-color:#17a2b8}.btn-outline-info.focus,.btn-outline-info:focus{box-shadow:0 0 0 .2rem rgba(23,162,184,.5)}.btn-outline-info.disabled,.btn-outline-info:disabled{color:#17a2b8;background-color:transparent}.btn-outline-info:not(:disabled):not(.disabled).active,.btn-outline-info:not(:disabled):not(.disabled):active,.show>.btn-outline-info.dropdown-toggle{color:#fff;background-color:#17a2b8;border-color:#17a2b8}.btn-outline-info:not(:disabled):not(.disabled).active:focus,.btn-outline-info:not(:disabled):not(.disabled):active:focus,.show>.btn-outline-info.dropdown-toggle:focus{box-shadow:0 0 0 .2rem rgba(23,162,184,.5)}.btn-outline-warning{color:#ffc107;border-color:#ffc107}.btn-outline-warning:hover{color:#212529;background-color:#ffc107;border-color:#ffc107}.btn-outline-warning.focus,.btn-outline-warning:focus{box-shadow:0 0 0 .2rem rgba(255,193,7,.5)}.btn-outline-warning.disabled,.btn-outline-warning:disabled{color:#ffc107;background-color:transparent}.btn-outline-warning:not(:disabled):not(.disabled).active,.btn-outline-warning:not(:disabled):not(.disabled):active,.show>.btn-outline-warning.dropdown-toggle{color:#212529;background-color:#ffc107;border-color:#ffc107}.btn-outline-warning:not(:disabled):not(.disabled).active:focus,.btn-outline-warning:not(:disabled):not(.disabled):active:focus,.show>.btn-outline-warning.dropdown-toggle:focus{box-shadow:0 0 0 .2rem rgba(255,193,7,.5)}.btn-outline-danger{color:#dc3545;border-color:#dc3545}.btn-outline-danger:hover{color:#fff;background-color:#dc3545;border-color:#dc3545}.btn-outline-danger.focus,.btn-outline-danger:focus{box-shadow:0 0 0 .2rem rgba(220,53,69,.5)}.btn-outline-danger.disabled,.btn-outline-danger:disabled{color:#dc3545;background-color:transparent}.btn-outline-danger:not(:disabled):not(.disabled).active,.btn-outline-danger:not(:disabled):not(.disabled):active,.show>.btn-outline-danger.dropdown-toggle{color:#fff;background-color:#dc3545;border-color:#dc3545}.btn-outline-danger:not(:disabled):not(.disabled).active:focus,.btn-outline-danger:not(:disabled):not(.disabled):active:focus,.show>.btn-outline-danger.dropdown-toggle:focus{box-shadow:0 0 0 .2rem rgba(220,53,69,.5)}.btn-outline-light{color:#f8f9fa;border-color:#f8f9fa}.btn-outline-light:hover{color:#212529;background-color:#f8f9fa;border-color:#f8f9fa}.btn-outline-light.focus,.btn-outline-light:focus{box-shadow:0 0 0 .2rem rgba(248,249,250,.5)}.btn-outline-light.disabled,.btn-outline-light:disabled{color:#f8f9fa;background-color:transparent}.btn-outline-light:not(:disabled):not(.disabled).active,.btn-outline-light:not(:disabled):not(.disabled):active,.show>.btn-outline-light.dropdown-toggle{color:#212529;background-color:#f8f9fa;border-color:#f8f9fa}.btn-outline-light:not(:disabled):not(.disabled).active:focus,.btn-outline-light:not(:disabled):not(.disabled):active:focus,.show>.btn-outline-light.dropdown-toggle:focus{box-shadow:0 0 0 .2rem rgba(248,249,250,.5)}.btn-outline-dark{color:#343a40;border-color:#343a40}.btn-outline-dark:hover{color:#fff;background-color:#343a40;border-color:#343a40}.btn-outline-dark.focus,.btn-outline-dark:focus{box-shadow:0 0 0 .2rem rgba(52,58,64,.5)}.btn-outline-dark.disabled,.btn-outline-dark:disabled{color:#343a40;background-color:transparent}.btn-outline-dark:not(:disabled):not(.disabled).active,.btn-outline-dark:not(:disabled):not(.disabled):active,.show>.btn-outline-dark.dropdown-toggle{color:#fff;background-color:#343a40;border-color:#343a40}.btn-outline-dark:not(:disabled):not(.disabled).active:focus,.btn-outline-dark:not(:disabled):not(.disabled):active:focus,.show>.btn-outline-dark.dropdown-toggle:focus{box-shadow:0 0 0 .2rem rgba(52,58,64,.5)}.btn-link{font-weight:400;color:#007bff;text-decoration:none}.btn-link:hover{color:#0056b3}.btn-link.focus,.btn-link:focus,.btn-link:hover{text-decoration:underline}.btn-link.disabled,.btn-link:disabled{color:#6c757d;pointer-events:none}.btn-group-lg>.btn,.btn-lg{padding:.5rem 1rem;font-size:1.25rem;line-height:1.5;border-radius:.3rem}.btn-group-sm>.btn,.btn-sm{padding:.25rem .5rem;font-size:.875rem;line-height:1.5;border-radius:.2rem}.btn-block{display:block;width:100%}.btn-block+.btn-block{margin-top:.5rem}input[type=button].btn-block,input[type=reset].btn-block,input[type=submit].btn-block{width:100%}.fade{transition:opacity .15s linear}@media (prefers-reduced-motion:reduce){.fade{transition:none}}.fade:not(.show){opacity:0}.collapse:not(.show){display:none}.collapsing{position:relative;height:0;overflow:hidden;transition:height .35s ease}@media (prefers-reduced-motion:reduce){.collapsing{transition:none}}.dropdown,.dropleft,.dropright,.dropup{position:relative}.dropdown-toggle{white-space:nowrap}.dropdown-toggle:after{display:inline-block;margin-left:.255em;vertical-align:.255em;content:"";border-top:.3em solid;border-right:.3em solid transparent;border-bottom:0;border-left:.3em solid transparent}.dropdown-toggle:empty:after{margin-left:0}.dropdown-menu{position:absolute;top:100%;left:0;z-index:1000;display:none;float:left;min-width:10rem;padding:.5rem 0;margin:.125rem 0 0;font-size:1rem;color:#212529;text-align:left;list-style:none;background-color:#fff;background-clip:padding-box;border:1px solid rgba(0,0,0,.15);border-radius:.25rem}.dropdown-menu-left{right:auto;left:0}.dropdown-menu-right{right:0;left:auto}@media (min-width:540px){.dropdown-menu-sm-left{right:auto;left:0}.dropdown-menu-sm-right{right:0;left:auto}}@media (min-width:720px){.dropdown-menu-md-left{right:auto;left:0}.dropdown-menu-md-right{right:0;left:auto}}@media (min-width:960px){.dropdown-menu-lg-left{right:auto;left:0}.dropdown-menu-lg-right{right:0;left:auto}}@media (min-width:1200px){.dropdown-menu-xl-left{right:auto;left:0}.dropdown-menu-xl-right{right:0;left:auto}}.dropup .dropdown-menu{top:auto;bottom:100%;margin-top:0;margin-bottom:.125rem}.dropup .dropdown-toggle:after{display:inline-block;margin-left:.255em;vertical-align:.255em;content:"";border-top:0;border-right:.3em solid transparent;border-bottom:.3em solid;border-left:.3em solid transparent}.dropup .dropdown-toggle:empty:after{margin-left:0}.dropright .dropdown-menu{top:0;right:auto;left:100%;margin-top:0;margin-left:.125rem}.dropright .dropdown-toggle:after{display:inline-block;margin-left:.255em;vertical-align:.255em;content:"";border-top:.3em solid transparent;border-right:0;border-bottom:.3em solid transparent;border-left:.3em solid}.dropright .dropdown-toggle:empty:after{margin-left:0}.dropright .dropdown-toggle:after{vertical-align:0}.dropleft .dropdown-menu{top:0;right:100%;left:auto;margin-top:0;margin-right:.125rem}.dropleft .dropdown-toggle:after{display:inline-block;margin-left:.255em;vertical-align:.255em;content:"";display:none}.dropleft .dropdown-toggle:before{display:inline-block;margin-right:.255em;vertical-align:.255em;content:"";border-top:.3em solid transparent;border-right:.3em solid;border-bottom:.3em solid transparent}.dropleft .dropdown-toggle:empty:after{margin-left:0}.dropleft .dropdown-toggle:before{vertical-align:0}.dropdown-menu[x-placement^=bottom],.dropdown-menu[x-placement^=left],.dropdown-menu[x-placement^=right],.dropdown-menu[x-placement^=top]{right:auto;bottom:auto}.dropdown-divider{height:0;margin:.5rem 0;overflow:hidden;border-top:1px solid #e9ecef}.dropdown-item{display:block;width:100%;padding:.25rem 1.5rem;clear:both;font-weight:400;color:#212529;text-align:inherit;white-space:nowrap;background-color:transparent;border:0}.dropdown-item:focus,.dropdown-item:hover{color:#16181b;text-decoration:none;background-color:#f8f9fa}.dropdown-item.active,.dropdown-item:active{color:#fff;text-decoration:none;background-color:#007bff}.dropdown-item.disabled,.dropdown-item:disabled{color:#6c757d;pointer-events:none;background-color:transparent}.dropdown-menu.show{display:block}.dropdown-header{display:block;padding:.5rem 1.5rem;margin-bottom:0;font-size:.875rem;color:#6c757d;white-space:nowrap}.dropdown-item-text{display:block;padding:.25rem 1.5rem;color:#212529}.btn-group,.btn-group-vertical{position:relative;display:inline-flex;vertical-align:middle}.btn-group-vertical>.btn,.btn-group>.btn{position:relative;flex:1 1 auto}.btn-group-vertical>.btn.active,.btn-group-vertical>.btn:active,.btn-group-vertical>.btn:focus,.btn-group-vertical>.btn:hover,.btn-group>.btn.active,.btn-group>.btn:active,.btn-group>.btn:focus,.btn-group>.btn:hover{z-index:1}.btn-toolbar{display:flex;flex-wrap:wrap;justify-content:flex-start}.btn-toolbar .input-group{width:auto}.btn-group>.btn-group:not(:first-child),.btn-group>.btn:not(:first-child){margin-left:-1px}.btn-group>.btn-group:not(:last-child)>.btn,.btn-group>.btn:not(:last-child):not(.dropdown-toggle){border-top-right-radius:0;border-bottom-right-radius:0}.btn-group>.btn-group:not(:first-child)>.btn,.btn-group>.btn:not(:first-child){border-top-left-radius:0;border-bottom-left-radius:0}.dropdown-toggle-split{padding-right:.5625rem;padding-left:.5625rem}.dropdown-toggle-split:after,.dropright .dropdown-toggle-split:after,.dropup .dropdown-toggle-split:after{margin-left:0}.dropleft .dropdown-toggle-split:before{margin-right:0}.btn-group-sm>.btn+.dropdown-toggle-split,.btn-sm+.dropdown-toggle-split{padding-right:.375rem;padding-left:.375rem}.btn-group-lg>.btn+.dropdown-toggle-split,.btn-lg+.dropdown-toggle-split{padding-right:.75rem;padding-left:.75rem}.btn-group-vertical{flex-direction:column;align-items:flex-start;justify-content:center}.btn-group-vertical>.btn,.btn-group-vertical>.btn-group{width:100%}.btn-group-vertical>.btn-group:not(:first-child),.btn-group-vertical>.btn:not(:first-child){margin-top:-1px}.btn-group-vertical>.btn-group:not(:last-child)>.btn,.btn-group-vertical>.btn:not(:last-child):not(.dropdown-toggle){border-bottom-right-radius:0;border-bottom-left-radius:0}.btn-group-vertical>.btn-group:not(:first-child)>.btn,.btn-group-vertical>.btn:not(:first-child){border-top-left-radius:0;border-top-right-radius:0}.btn-group-toggle>.btn,.btn-group-toggle>.btn-group>.btn{margin-bottom:0}.btn-group-toggle>.btn-group>.btn input[type=checkbox],.btn-group-toggle>.btn-group>.btn input[type=radio],.btn-group-toggle>.btn input[type=checkbox],.btn-group-toggle>.btn input[type=radio]{position:absolute;clip:rect(0,0,0,0);pointer-events:none}.input-group{position:relative;display:flex;flex-wrap:wrap;align-items:stretch;width:100%}.input-group>.custom-file,.input-group>.custom-select,.input-group>.form-control,.input-group>.form-control-plaintext{position:relative;flex:1 1 auto;width:1%;min-width:0;margin-bottom:0}.input-group>.custom-file+.custom-file,.input-group>.custom-file+.custom-select,.input-group>.custom-file+.form-control,.input-group>.custom-select+.custom-file,.input-group>.custom-select+.custom-select,.input-group>.custom-select+.form-control,.input-group>.form-control+.custom-file,.input-group>.form-control+.custom-select,.input-group>.form-control+.form-control,.input-group>.form-control-plaintext+.custom-file,.input-group>.form-control-plaintext+.custom-select,.input-group>.form-control-plaintext+.form-control{margin-left:-1px}.input-group>.custom-file .custom-file-input:focus~.custom-file-label,.input-group>.custom-select:focus,.input-group>.form-control:focus{z-index:3}.input-group>.custom-file .custom-file-input:focus{z-index:4}.input-group>.custom-select:not(:last-child),.input-group>.form-control:not(:last-child){border-top-right-radius:0;border-bottom-right-radius:0}.input-group>.custom-select:not(:first-child),.input-group>.form-control:not(:first-child){border-top-left-radius:0;border-bottom-left-radius:0}.input-group>.custom-file{display:flex;align-items:center}.input-group>.custom-file:not(:last-child) .custom-file-label,.input-group>.custom-file:not(:last-child) .custom-file-label:after{border-top-right-radius:0;border-bottom-right-radius:0}.input-group>.custom-file:not(:first-child) .custom-file-label{border-top-left-radius:0;border-bottom-left-radius:0}.input-group-append,.input-group-prepend{display:flex}.input-group-append .btn,.input-group-prepend .btn{position:relative;z-index:2}.input-group-append .btn:focus,.input-group-prepend .btn:focus{z-index:3}.input-group-append .btn+.btn,.input-group-append .btn+.input-group-text,.input-group-append .input-group-text+.btn,.input-group-append .input-group-text+.input-group-text,.input-group-prepend .btn+.btn,.input-group-prepend .btn+.input-group-text,.input-group-prepend .input-group-text+.btn,.input-group-prepend .input-group-text+.input-group-text{margin-left:-1px}.input-group-prepend{margin-right:-1px}.input-group-append{margin-left:-1px}.input-group-text{display:flex;align-items:center;padding:.375rem .75rem;margin-bottom:0;font-size:1rem;font-weight:400;line-height:1.5;color:#495057;text-align:center;white-space:nowrap;background-color:#e9ecef;border:1px solid #ced4da;border-radius:.25rem}.input-group-text input[type=checkbox],.input-group-text input[type=radio]{margin-top:0}.input-group-lg>.custom-select,.input-group-lg>.form-control:not(textarea){height:calc(1.5em + 1rem + 2px)}.input-group-lg>.custom-select,.input-group-lg>.form-control,.input-group-lg>.input-group-append>.btn,.input-group-lg>.input-group-append>.input-group-text,.input-group-lg>.input-group-prepend>.btn,.input-group-lg>.input-group-prepend>.input-group-text{padding:.5rem 1rem;font-size:1.25rem;line-height:1.5;border-radius:.3rem}.input-group-sm>.custom-select,.input-group-sm>.form-control:not(textarea){height:calc(1.5em + .5rem + 2px)}.input-group-sm>.custom-select,.input-group-sm>.form-control,.input-group-sm>.input-group-append>.btn,.input-group-sm>.input-group-append>.input-group-text,.input-group-sm>.input-group-prepend>.btn,.input-group-sm>.input-group-prepend>.input-group-text{padding:.25rem .5rem;font-size:.875rem;line-height:1.5;border-radius:.2rem}.input-group-lg>.custom-select,.input-group-sm>.custom-select{padding-right:1.75rem}.input-group>.input-group-append:last-child>.btn:not(:last-child):not(.dropdown-toggle),.input-group>.input-group-append:last-child>.input-group-text:not(:last-child),.input-group>.input-group-append:not(:last-child)>.btn,.input-group>.input-group-append:not(:last-child)>.input-group-text,.input-group>.input-group-prepend>.btn,.input-group>.input-group-prepend>.input-group-text{border-top-right-radius:0;border-bottom-right-radius:0}.input-group>.input-group-append>.btn,.input-group>.input-group-append>.input-group-text,.input-group>.input-group-prepend:first-child>.btn:not(:first-child),.input-group>.input-group-prepend:first-child>.input-group-text:not(:first-child),.input-group>.input-group-prepend:not(:first-child)>.btn,.input-group>.input-group-prepend:not(:first-child)>.input-group-text{border-top-left-radius:0;border-bottom-left-radius:0}.custom-control{position:relative;display:block;min-height:1.5rem;padding-left:1.5rem}.custom-control-inline{display:inline-flex;margin-right:1rem}.custom-control-input{position:absolute;left:0;z-index:-1;width:1rem;height:1.25rem;opacity:0}.custom-control-input:checked~.custom-control-label:before{color:#fff;border-color:#007bff;background-color:#007bff}.custom-control-input:focus~.custom-control-label:before{box-shadow:0 0 0 .2rem rgba(0,123,255,.25)}.custom-control-input:focus:not(:checked)~.custom-control-label:before{border-color:#80bdff}.custom-control-input:not(:disabled):active~.custom-control-label:before{color:#fff;background-color:#b3d7ff;border-color:#b3d7ff}.custom-control-input:disabled~.custom-control-label,.custom-control-input[disabled]~.custom-control-label{color:#6c757d}.custom-control-input:disabled~.custom-control-label:before,.custom-control-input[disabled]~.custom-control-label:before{background-color:#e9ecef}.custom-control-label{position:relative;margin-bottom:0;vertical-align:top}.custom-control-label:before{pointer-events:none;background-color:#fff;border:1px solid #adb5bd}.custom-control-label:after,.custom-control-label:before{position:absolute;top:.25rem;left:-1.5rem;display:block;width:1rem;height:1rem;content:""}.custom-control-label:after{background:no-repeat 50%/50% 50%}.custom-checkbox .custom-control-label:before{border-radius:.25rem}.custom-checkbox .custom-control-input:checked~.custom-control-label:after{background-image:url("data:image/svg+xml;charset=utf-8,%3Csvg xmlns='http://www.w3.org/2000/svg' width='8' height='8'%3E%3Cpath fill='%23fff' d='M6.564.75l-3.59 3.612-1.538-1.55L0 4.26l2.974 2.99L8 2.193z'/%3E%3C/svg%3E")}.custom-checkbox .custom-control-input:indeterminate~.custom-control-label:before{border-color:#007bff;background-color:#007bff}.custom-checkbox .custom-control-input:indeterminate~.custom-control-label:after{background-image:url("data:image/svg+xml;charset=utf-8,%3Csvg xmlns='http://www.w3.org/2000/svg' width='4' height='4'%3E%3Cpath stroke='%23fff' d='M0 2h4'/%3E%3C/svg%3E")}.custom-checkbox .custom-control-input:disabled:checked~.custom-control-label:before{background-color:rgba(0,123,255,.5)}.custom-checkbox .custom-control-input:disabled:indeterminate~.custom-control-label:before{background-color:rgba(0,123,255,.5)}.custom-radio .custom-control-label:before{border-radius:50%}.custom-radio .custom-control-input:checked~.custom-control-label:after{background-image:url("data:image/svg+xml;charset=utf-8,%3Csvg xmlns='http://www.w3.org/2000/svg' width='12' height='12' viewBox='-4 -4 8 8'%3E%3Ccircle r='3' fill='%23fff'/%3E%3C/svg%3E")}.custom-radio .custom-control-input:disabled:checked~.custom-control-label:before{background-color:rgba(0,123,255,.5)}.custom-switch{padding-left:2.25rem}.custom-switch .custom-control-label:before{left:-2.25rem;width:1.75rem;pointer-events:all;border-radius:.5rem}.custom-switch .custom-control-label:after{top:calc(.25rem + 2px);left:calc(-2.25rem + 2px);width:calc(1rem - 4px);height:calc(1rem - 4px);background-color:#adb5bd;border-radius:.5rem;transition:transform .15s ease-in-out,background-color .15s ease-in-out,border-color .15s ease-in-out,box-shadow .15s ease-in-out}@media (prefers-reduced-motion:reduce){.custom-switch .custom-control-label:after{transition:none}}.custom-switch .custom-control-input:checked~.custom-control-label:after{background-color:#fff;transform:translateX(.75rem)}.custom-switch .custom-control-input:disabled:checked~.custom-control-label:before{background-color:rgba(0,123,255,.5)}.custom-select{display:inline-block;width:100%;height:calc(1.5em + .75rem + 2px);padding:.375rem 1.75rem .375rem .75rem;font-size:1rem;font-weight:400;line-height:1.5;color:#495057;vertical-align:middle;background:#fff url("data:image/svg+xml;charset=utf-8,%3Csvg xmlns='http://www.w3.org/2000/svg' width='4' height='5'%3E%3Cpath fill='%23343a40' d='M2 0L0 2h4zm0 5L0 3h4z'/%3E%3C/svg%3E") no-repeat right .75rem center/8px 10px;border:1px solid #ced4da;border-radius:.25rem;appearance:none}.custom-select:focus{border-color:#80bdff;outline:0;box-shadow:0 0 0 .2rem rgba(0,123,255,.25)}.custom-select:focus::-ms-value{color:#495057;background-color:#fff}.custom-select[multiple],.custom-select[size]:not([size="1"]){height:auto;padding-right:.75rem;background-image:none}.custom-select:disabled{color:#6c757d;background-color:#e9ecef}.custom-select::-ms-expand{display:none}.custom-select:-moz-focusring{color:transparent;text-shadow:0 0 0 #495057}.custom-select-sm{height:calc(1.5em + .5rem + 2px);padding-top:.25rem;padding-bottom:.25rem;padding-left:.5rem;font-size:.875rem}.custom-select-lg{height:calc(1.5em + 1rem + 2px);padding-top:.5rem;padding-bottom:.5rem;padding-left:1rem;font-size:1.25rem}.custom-file{display:inline-block;margin-bottom:0}.custom-file,.custom-file-input{position:relative;width:100%;height:calc(1.5em + .75rem + 2px)}.custom-file-input{z-index:2;margin:0;opacity:0}.custom-file-input:focus~.custom-file-label{border-color:#80bdff;box-shadow:0 0 0 .2rem rgba(0,123,255,.25)}.custom-file-input:disabled~.custom-file-label,.custom-file-input[disabled]~.custom-file-label{background-color:#e9ecef}.custom-file-input:lang(en)~.custom-file-label:after{content:"Browse"}.custom-file-input~.custom-file-label[data-browse]:after{content:attr(data-browse)}.custom-file-label{left:0;z-index:1;height:calc(1.5em + .75rem + 2px);font-weight:400;background-color:#fff;border:1px solid #ced4da;border-radius:.25rem}.custom-file-label,.custom-file-label:after{position:absolute;top:0;right:0;padding:.375rem .75rem;line-height:1.5;color:#495057}.custom-file-label:after{bottom:0;z-index:3;display:block;height:calc(1.5em + .75rem);content:"Browse";background-color:#e9ecef;border-left:inherit;border-radius:0 .25rem .25rem 0}.custom-range{width:100%;height:1.4rem;padding:0;background-color:transparent;appearance:none}.custom-range:focus{outline:none}.custom-range:focus::-webkit-slider-thumb{box-shadow:0 0 0 1px #fff,0 0 0 .2rem rgba(0,123,255,.25)}.custom-range:focus::-moz-range-thumb{box-shadow:0 0 0 1px #fff,0 0 0 .2rem rgba(0,123,255,.25)}.custom-range:focus::-ms-thumb{box-shadow:0 0 0 1px #fff,0 0 0 .2rem rgba(0,123,255,.25)}.custom-range::-moz-focus-outer{border:0}.custom-range::-webkit-slider-thumb{width:1rem;height:1rem;margin-top:-.25rem;background-color:#007bff;border:0;border-radius:1rem;transition:background-color .15s ease-in-out,border-color .15s ease-in-out,box-shadow .15s ease-in-out;appearance:none}@media (prefers-reduced-motion:reduce){.custom-range::-webkit-slider-thumb{transition:none}}.custom-range::-webkit-slider-thumb:active{background-color:#b3d7ff}.custom-range::-webkit-slider-runnable-track{width:100%;height:.5rem;color:transparent;cursor:pointer;background-color:#dee2e6;border-color:transparent;border-radius:1rem}.custom-range::-moz-range-thumb{width:1rem;height:1rem;background-color:#007bff;border:0;border-radius:1rem;transition:background-color .15s ease-in-out,border-color .15s ease-in-out,box-shadow .15s ease-in-out;appearance:none}@media (prefers-reduced-motion:reduce){.custom-range::-moz-range-thumb{transition:none}}.custom-range::-moz-range-thumb:active{background-color:#b3d7ff}.custom-range::-moz-range-track{width:100%;height:.5rem;color:transparent;cursor:pointer;background-color:#dee2e6;border-color:transparent;border-radius:1rem}.custom-range::-ms-thumb{width:1rem;height:1rem;margin-top:0;margin-right:.2rem;margin-left:.2rem;background-color:#007bff;border:0;border-radius:1rem;transition:background-color .15s ease-in-out,border-color .15s ease-in-out,box-shadow .15s ease-in-out;appearance:none}@media (prefers-reduced-motion:reduce){.custom-range::-ms-thumb{transition:none}}.custom-range::-ms-thumb:active{background-color:#b3d7ff}.custom-range::-ms-track{width:100%;height:.5rem;color:transparent;cursor:pointer;background-color:transparent;border-color:transparent;border-width:.5rem}.custom-range::-ms-fill-lower,.custom-range::-ms-fill-upper{background-color:#dee2e6;border-radius:1rem}.custom-range::-ms-fill-upper{margin-right:15px}.custom-range:disabled::-webkit-slider-thumb{background-color:#adb5bd}.custom-range:disabled::-webkit-slider-runnable-track{cursor:default}.custom-range:disabled::-moz-range-thumb{background-color:#adb5bd}.custom-range:disabled::-moz-range-track{cursor:default}.custom-range:disabled::-ms-thumb{background-color:#adb5bd}.custom-control-label:before,.custom-file-label,.custom-select{transition:background-color .15s ease-in-out,border-color .15s ease-in-out,box-shadow .15s ease-in-out}@media (prefers-reduced-motion:reduce){.custom-control-label:before,.custom-file-label,.custom-select{transition:none}}.nav{display:flex;flex-wrap:wrap;padding-left:0;margin-bottom:0;list-style:none}.nav-link{display:block;padding:.5rem 1rem}.nav-link:focus,.nav-link:hover{text-decoration:none}.nav-link.disabled{color:#6c757d;pointer-events:none;cursor:default}.nav-tabs{border-bottom:1px solid #dee2e6}.nav-tabs .nav-item{margin-bottom:-1px}.nav-tabs .nav-link{border:1px solid transparent;border-top-left-radius:.25rem;border-top-right-radius:.25rem}.nav-tabs .nav-link:focus,.nav-tabs .nav-link:hover{border-color:#e9ecef #e9ecef #dee2e6}.nav-tabs .nav-link.disabled{color:#6c757d;background-color:transparent;border-color:transparent}.nav-tabs .nav-item.show .nav-link,.nav-tabs .nav-link.active{color:#495057;background-color:#fff;border-color:#dee2e6 #dee2e6 #fff}.nav-tabs .dropdown-menu{margin-top:-1px;border-top-left-radius:0;border-top-right-radius:0}.nav-pills .nav-link{border-radius:.25rem}.nav-pills .nav-link.active,.nav-pills .show>.nav-link{color:#fff;background-color:#007bff}.nav-fill .nav-item{flex:1 1 auto;text-align:center}.nav-justified .nav-item{flex-basis:0;flex-grow:1;text-align:center}.tab-content>.tab-pane{display:none}.tab-content>.active{display:block}.navbar{position:relative;padding:.5rem 1rem}.navbar,.navbar .container,.navbar .container-fluid,.navbar .container-lg,.navbar .container-md,.navbar .container-sm,.navbar .container-xl{display:flex;flex-wrap:wrap;align-items:center;justify-content:space-between}.navbar-brand{display:inline-block;padding-top:.3125rem;padding-bottom:.3125rem;margin-right:1rem;font-size:1.25rem;line-height:inherit;white-space:nowrap}.navbar-brand:focus,.navbar-brand:hover{text-decoration:none}.navbar-nav{display:flex;flex-direction:column;padding-left:0;margin-bottom:0;list-style:none}.navbar-nav .nav-link{padding-right:0;padding-left:0}.navbar-nav .dropdown-menu{position:static;float:none}.navbar-text{display:inline-block;padding-top:.5rem;padding-bottom:.5rem}.navbar-collapse{flex-basis:100%;flex-grow:1;align-items:center}.navbar-toggler{padding:.25rem .75rem;font-size:1.25rem;line-height:1;background-color:transparent;border:1px solid transparent;border-radius:.25rem}.navbar-toggler:focus,.navbar-toggler:hover{text-decoration:none}.navbar-toggler-icon{display:inline-block;width:1.5em;height:1.5em;vertical-align:middle;content:"";background:no-repeat 50%;background-size:100% 100%}@media (max-width:539.98px){.navbar-expand-sm>.container,.navbar-expand-sm>.container-fluid,.navbar-expand-sm>.container-lg,.navbar-expand-sm>.container-md,.navbar-expand-sm>.container-sm,.navbar-expand-sm>.container-xl{padding-right:0;padding-left:0}}@media (min-width:540px){.navbar-expand-sm{flex-flow:row nowrap;justify-content:flex-start}.navbar-expand-sm .navbar-nav{flex-direction:row}.navbar-expand-sm .navbar-nav .dropdown-menu{position:absolute}.navbar-expand-sm .navbar-nav .nav-link{padding-right:.5rem;padding-left:.5rem}.navbar-expand-sm>.container,.navbar-expand-sm>.container-fluid,.navbar-expand-sm>.container-lg,.navbar-expand-sm>.container-md,.navbar-expand-sm>.container-sm,.navbar-expand-sm>.container-xl{flex-wrap:nowrap}.navbar-expand-sm .navbar-collapse{display:flex!important;flex-basis:auto}.navbar-expand-sm .navbar-toggler{display:none}}@media (max-width:719.98px){.navbar-expand-md>.container,.navbar-expand-md>.container-fluid,.navbar-expand-md>.container-lg,.navbar-expand-md>.container-md,.navbar-expand-md>.container-sm,.navbar-expand-md>.container-xl{padding-right:0;padding-left:0}}@media (min-width:720px){.navbar-expand-md{flex-flow:row nowrap;justify-content:flex-start}.navbar-expand-md .navbar-nav{flex-direction:row}.navbar-expand-md .navbar-nav .dropdown-menu{position:absolute}.navbar-expand-md .navbar-nav .nav-link{padding-right:.5rem;padding-left:.5rem}.navbar-expand-md>.container,.navbar-expand-md>.container-fluid,.navbar-expand-md>.container-lg,.navbar-expand-md>.container-md,.navbar-expand-md>.container-sm,.navbar-expand-md>.container-xl{flex-wrap:nowrap}.navbar-expand-md .navbar-collapse{display:flex!important;flex-basis:auto}.navbar-expand-md .navbar-toggler{display:none}}@media (max-width:959.98px){.navbar-expand-lg>.container,.navbar-expand-lg>.container-fluid,.navbar-expand-lg>.container-lg,.navbar-expand-lg>.container-md,.navbar-expand-lg>.container-sm,.navbar-expand-lg>.container-xl{padding-right:0;padding-left:0}}@media (min-width:960px){.navbar-expand-lg{flex-flow:row nowrap;justify-content:flex-start}.navbar-expand-lg .navbar-nav{flex-direction:row}.navbar-expand-lg .navbar-nav .dropdown-menu{position:absolute}.navbar-expand-lg .navbar-nav .nav-link{padding-right:.5rem;padding-left:.5rem}.navbar-expand-lg>.container,.navbar-expand-lg>.container-fluid,.navbar-expand-lg>.container-lg,.navbar-expand-lg>.container-md,.navbar-expand-lg>.container-sm,.navbar-expand-lg>.container-xl{flex-wrap:nowrap}.navbar-expand-lg .navbar-collapse{display:flex!important;flex-basis:auto}.navbar-expand-lg .navbar-toggler{display:none}}@media (max-width:1199.98px){.navbar-expand-xl>.container,.navbar-expand-xl>.container-fluid,.navbar-expand-xl>.container-lg,.navbar-expand-xl>.container-md,.navbar-expand-xl>.container-sm,.navbar-expand-xl>.container-xl{padding-right:0;padding-left:0}}@media (min-width:1200px){.navbar-expand-xl{flex-flow:row nowrap;justify-content:flex-start}.navbar-expand-xl .navbar-nav{flex-direction:row}.navbar-expand-xl .navbar-nav .dropdown-menu{position:absolute}.navbar-expand-xl .navbar-nav .nav-link{padding-right:.5rem;padding-left:.5rem}.navbar-expand-xl>.container,.navbar-expand-xl>.container-fluid,.navbar-expand-xl>.container-lg,.navbar-expand-xl>.container-md,.navbar-expand-xl>.container-sm,.navbar-expand-xl>.container-xl{flex-wrap:nowrap}.navbar-expand-xl .navbar-collapse{display:flex!important;flex-basis:auto}.navbar-expand-xl .navbar-toggler{display:none}}.navbar-expand{flex-flow:row nowrap;justify-content:flex-start}.navbar-expand>.container,.navbar-expand>.container-fluid,.navbar-expand>.container-lg,.navbar-expand>.container-md,.navbar-expand>.container-sm,.navbar-expand>.container-xl{padding-right:0;padding-left:0}.navbar-expand .navbar-nav{flex-direction:row}.navbar-expand .navbar-nav .dropdown-menu{position:absolute}.navbar-expand .navbar-nav .nav-link{padding-right:.5rem;padding-left:.5rem}.navbar-expand>.container,.navbar-expand>.container-fluid,.navbar-expand>.container-lg,.navbar-expand>.container-md,.navbar-expand>.container-sm,.navbar-expand>.container-xl{flex-wrap:nowrap}.navbar-expand .navbar-collapse{display:flex!important;flex-basis:auto}.navbar-expand .navbar-toggler{display:none}.navbar-light .navbar-brand,.navbar-light .navbar-brand:focus,.navbar-light .navbar-brand:hover{color:rgba(0,0,0,.9)}.navbar-light .navbar-nav .nav-link{color:rgba(0,0,0,.5)}.navbar-light .navbar-nav .nav-link:focus,.navbar-light .navbar-nav .nav-link:hover{color:rgba(0,0,0,.7)}.navbar-light .navbar-nav .nav-link.disabled{color:rgba(0,0,0,.3)}.navbar-light .navbar-nav .active>.nav-link,.navbar-light .navbar-nav .nav-link.active,.navbar-light .navbar-nav .nav-link.show,.navbar-light .navbar-nav .show>.nav-link{color:rgba(0,0,0,.9)}.navbar-light .navbar-toggler{color:rgba(0,0,0,.5);border-color:rgba(0,0,0,.1)}.navbar-light .navbar-toggler-icon{background-image:url("data:image/svg+xml;charset=utf-8,%3Csvg xmlns='http://www.w3.org/2000/svg' width='30' height='30'%3E%3Cpath stroke='rgba(0,0,0,0.5)' stroke-linecap='round' stroke-miterlimit='10' stroke-width='2' d='M4 7h22M4 15h22M4 23h22'/%3E%3C/svg%3E")}.navbar-light .navbar-text{color:rgba(0,0,0,.5)}.navbar-light .navbar-text a,.navbar-light .navbar-text a:focus,.navbar-light .navbar-text a:hover{color:rgba(0,0,0,.9)}.navbar-dark .navbar-brand,.navbar-dark .navbar-brand:focus,.navbar-dark .navbar-brand:hover{color:#fff}.navbar-dark .navbar-nav .nav-link{color:hsla(0,0%,100%,.5)}.navbar-dark .navbar-nav .nav-link:focus,.navbar-dark .navbar-nav .nav-link:hover{color:hsla(0,0%,100%,.75)}.navbar-dark .navbar-nav .nav-link.disabled{color:hsla(0,0%,100%,.25)}.navbar-dark .navbar-nav .active>.nav-link,.navbar-dark .navbar-nav .nav-link.active,.navbar-dark .navbar-nav .nav-link.show,.navbar-dark .navbar-nav .show>.nav-link{color:#fff}.navbar-dark .navbar-toggler{color:hsla(0,0%,100%,.5);border-color:hsla(0,0%,100%,.1)}.navbar-dark .navbar-toggler-icon{background-image:url("data:image/svg+xml;charset=utf-8,%3Csvg xmlns='http://www.w3.org/2000/svg' width='30' height='30'%3E%3Cpath stroke='rgba(255,255,255,0.5)' stroke-linecap='round' stroke-miterlimit='10' stroke-width='2' d='M4 7h22M4 15h22M4 23h22'/%3E%3C/svg%3E")}.navbar-dark .navbar-text{color:hsla(0,0%,100%,.5)}.navbar-dark .navbar-text a,.navbar-dark .navbar-text a:focus,.navbar-dark .navbar-text a:hover{color:#fff}.card{position:relative;display:flex;flex-direction:column;min-width:0;word-wrap:break-word;background-color:#fff;background-clip:border-box;border:1px solid rgba(0,0,0,.125);border-radius:.25rem}.card>hr{margin-right:0;margin-left:0}.card>.list-group{border-top:inherit;border-bottom:inherit}.card>.list-group:first-child{border-top-width:0;border-top-left-radius:calc(.25rem - 1px);border-top-right-radius:calc(.25rem - 1px)}.card>.list-group:last-child{border-bottom-width:0;border-bottom-right-radius:calc(.25rem - 1px);border-bottom-left-radius:calc(.25rem - 1px)}.card-body{flex:1 1 auto;min-height:1px;padding:1.25rem}.card-title{margin-bottom:.75rem}.card-subtitle{margin-top:-.375rem}.card-subtitle,.card-text:last-child{margin-bottom:0}.card-link:hover{text-decoration:none}.card-link+.card-link{margin-left:1.25rem}.card-header{padding:.75rem 1.25rem;margin-bottom:0;background-color:rgba(0,0,0,.03);border-bottom:1px solid rgba(0,0,0,.125)}.card-header:first-child{border-radius:calc(.25rem - 1px) calc(.25rem - 1px) 0 0}.card-header+.list-group .list-group-item:first-child{border-top:0}.card-footer{padding:.75rem 1.25rem;background-color:rgba(0,0,0,.03);border-top:1px solid rgba(0,0,0,.125)}.card-footer:last-child{border-radius:0 0 calc(.25rem - 1px) calc(.25rem - 1px)}.card-header-tabs{margin-bottom:-.75rem;border-bottom:0}.card-header-pills,.card-header-tabs{margin-right:-.625rem;margin-left:-.625rem}.card-img-overlay{position:absolute;top:0;right:0;bottom:0;left:0;padding:1.25rem}.card-img,.card-img-bottom,.card-img-top{flex-shrink:0;width:100%}.card-img,.card-img-top{border-top-left-radius:calc(.25rem - 1px);border-top-right-radius:calc(.25rem - 1px)}.card-img,.card-img-bottom{border-bottom-right-radius:calc(.25rem - 1px);border-bottom-left-radius:calc(.25rem - 1px)}.card-deck .card{margin-bottom:15px}@media (min-width:540px){.card-deck{display:flex;flex-flow:row wrap;margin-right:-15px;margin-left:-15px}.card-deck .card{flex:1 0 0%;margin-right:15px;margin-bottom:0;margin-left:15px}}.card-group>.card{margin-bottom:15px}@media (min-width:540px){.card-group{display:flex;flex-flow:row wrap}.card-group>.card{flex:1 0 0%;margin-bottom:0}.card-group>.card+.card{margin-left:0;border-left:0}.card-group>.card:not(:last-child){border-top-right-radius:0;border-bottom-right-radius:0}.card-group>.card:not(:last-child) .card-header,.card-group>.card:not(:last-child) .card-img-top{border-top-right-radius:0}.card-group>.card:not(:last-child) .card-footer,.card-group>.card:not(:last-child) .card-img-bottom{border-bottom-right-radius:0}.card-group>.card:not(:first-child){border-top-left-radius:0;border-bottom-left-radius:0}.card-group>.card:not(:first-child) .card-header,.card-group>.card:not(:first-child) .card-img-top{border-top-left-radius:0}.card-group>.card:not(:first-child) .card-footer,.card-group>.card:not(:first-child) .card-img-bottom{border-bottom-left-radius:0}}.card-columns .card{margin-bottom:.75rem}@media (min-width:540px){.card-columns{column-count:3;column-gap:1.25rem;orphans:1;widows:1}.card-columns .card{display:inline-block;width:100%}}.accordion>.card{overflow:hidden}.accordion>.card:not(:last-of-type){border-bottom:0;border-bottom-right-radius:0;border-bottom-left-radius:0}.accordion>.card:not(:first-of-type){border-top-left-radius:0;border-top-right-radius:0}.accordion>.card>.card-header{border-radius:0;margin-bottom:-1px}.breadcrumb{flex-wrap:wrap;padding:.75rem 1rem;margin-bottom:1rem;list-style:none;background-color:#e9ecef;border-radius:.25rem}.breadcrumb,.breadcrumb-item{display:flex}.breadcrumb-item+.breadcrumb-item{padding-left:.5rem}.breadcrumb-item+.breadcrumb-item:before{display:inline-block;padding-right:.5rem;color:#6c757d;content:"/"}.breadcrumb-item+.breadcrumb-item:hover:before{text-decoration:underline;text-decoration:none}.breadcrumb-item.active{color:#6c757d}.pagination{display:flex;padding-left:0;list-style:none;border-radius:.25rem}.page-link{position:relative;display:block;padding:.5rem .75rem;margin-left:-1px;line-height:1.25;color:#007bff;background-color:#fff;border:1px solid #dee2e6}.page-link:hover{z-index:2;color:#0056b3;text-decoration:none;background-color:#e9ecef;border-color:#dee2e6}.page-link:focus{z-index:3;outline:0;box-shadow:0 0 0 .2rem rgba(0,123,255,.25)}.page-item:first-child .page-link{margin-left:0;border-top-left-radius:.25rem;border-bottom-left-radius:.25rem}.page-item:last-child .page-link{border-top-right-radius:.25rem;border-bottom-right-radius:.25rem}.page-item.active .page-link{z-index:3;color:#fff;background-color:#007bff;border-color:#007bff}.page-item.disabled .page-link{color:#6c757d;pointer-events:none;cursor:auto;background-color:#fff;border-color:#dee2e6}.pagination-lg .page-link{padding:.75rem 1.5rem;font-size:1.25rem;line-height:1.5}.pagination-lg .page-item:first-child .page-link{border-top-left-radius:.3rem;border-bottom-left-radius:.3rem}.pagination-lg .page-item:last-child .page-link{border-top-right-radius:.3rem;border-bottom-right-radius:.3rem}.pagination-sm .page-link{padding:.25rem .5rem;font-size:.875rem;line-height:1.5}.pagination-sm .page-item:first-child .page-link{border-top-left-radius:.2rem;border-bottom-left-radius:.2rem}.pagination-sm .page-item:last-child .page-link{border-top-right-radius:.2rem;border-bottom-right-radius:.2rem}.badge{display:inline-block;padding:.25em .4em;font-size:75%;font-weight:700;line-height:1;text-align:center;white-space:nowrap;vertical-align:baseline;border-radius:.25rem;transition:color .15s ease-in-out,background-color .15s ease-in-out,border-color .15s ease-in-out,box-shadow .15s ease-in-out}@media (prefers-reduced-motion:reduce){.badge{transition:none}}a.badge:focus,a.badge:hover{text-decoration:none}.badge:empty{display:none}.btn .badge{position:relative;top:-1px}.badge-pill{padding-right:.6em;padding-left:.6em;border-radius:10rem}.badge-primary{color:#fff;background-color:#007bff}a.badge-primary:focus,a.badge-primary:hover{color:#fff;background-color:#0062cc}a.badge-primary.focus,a.badge-primary:focus{outline:0;box-shadow:0 0 0 .2rem rgba(0,123,255,.5)}.badge-secondary{color:#fff;background-color:#6c757d}a.badge-secondary:focus,a.badge-secondary:hover{color:#fff;background-color:#545b62}a.badge-secondary.focus,a.badge-secondary:focus{outline:0;box-shadow:0 0 0 .2rem rgba(108,117,125,.5)}.badge-success{color:#fff;background-color:#28a745}a.badge-success:focus,a.badge-success:hover{color:#fff;background-color:#1e7e34}a.badge-success.focus,a.badge-success:focus{outline:0;box-shadow:0 0 0 .2rem rgba(40,167,69,.5)}.badge-info{color:#fff;background-color:#17a2b8}a.badge-info:focus,a.badge-info:hover{color:#fff;background-color:#117a8b}a.badge-info.focus,a.badge-info:focus{outline:0;box-shadow:0 0 0 .2rem rgba(23,162,184,.5)}.badge-warning{color:#212529;background-color:#ffc107}a.badge-warning:focus,a.badge-warning:hover{color:#212529;background-color:#d39e00}a.badge-warning.focus,a.badge-warning:focus{outline:0;box-shadow:0 0 0 .2rem rgba(255,193,7,.5)}.badge-danger{color:#fff;background-color:#dc3545}a.badge-danger:focus,a.badge-danger:hover{color:#fff;background-color:#bd2130}a.badge-danger.focus,a.badge-danger:focus{outline:0;box-shadow:0 0 0 .2rem rgba(220,53,69,.5)}.badge-light{color:#212529;background-color:#f8f9fa}a.badge-light:focus,a.badge-light:hover{color:#212529;background-color:#dae0e5}a.badge-light.focus,a.badge-light:focus{outline:0;box-shadow:0 0 0 .2rem rgba(248,249,250,.5)}.badge-dark{color:#fff;background-color:#343a40}a.badge-dark:focus,a.badge-dark:hover{color:#fff;background-color:#1d2124}a.badge-dark.focus,a.badge-dark:focus{outline:0;box-shadow:0 0 0 .2rem rgba(52,58,64,.5)}.jumbotron{padding:2rem 1rem;margin-bottom:2rem;background-color:#e9ecef;border-radius:.3rem}@media (min-width:540px){.jumbotron{padding:4rem 2rem}}.jumbotron-fluid{padding-right:0;padding-left:0;border-radius:0}.alert{position:relative;padding:.75rem 1.25rem;margin-bottom:1rem;border:1px solid transparent;border-radius:.25rem}.alert-heading{color:inherit}.alert-link{font-weight:700}.alert-dismissible{padding-right:4rem}.alert-dismissible .close{position:absolute;top:0;right:0;padding:.75rem 1.25rem;color:inherit}.alert-primary{color:#004085;background-color:#cce5ff;border-color:#b8daff}.alert-primary hr{border-top-color:#9fcdff}.alert-primary .alert-link{color:#002752}.alert-secondary{color:#383d41;background-color:#e2e3e5;border-color:#d6d8db}.alert-secondary hr{border-top-color:#c8cbcf}.alert-secondary .alert-link{color:#202326}.alert-success{color:#155724;background-color:#d4edda;border-color:#c3e6cb}.alert-success hr{border-top-color:#b1dfbb}.alert-success .alert-link{color:#0b2e13}.alert-info{color:#0c5460;background-color:#d1ecf1;border-color:#bee5eb}.alert-info hr{border-top-color:#abdde5}.alert-info .alert-link{color:#062c33}.alert-warning{color:#856404;background-color:#fff3cd;border-color:#ffeeba}.alert-warning hr{border-top-color:#ffe8a1}.alert-warning .alert-link{color:#533f03}.alert-danger{color:#721c24;background-color:#f8d7da;border-color:#f5c6cb}.alert-danger hr{border-top-color:#f1b0b7}.alert-danger .alert-link{color:#491217}.alert-light{color:#818182;background-color:#fefefe;border-color:#fdfdfe}.alert-light hr{border-top-color:#ececf6}.alert-light .alert-link{color:#686868}.alert-dark{color:#1b1e21;background-color:#d6d8d9;border-color:#c6c8ca}.alert-dark hr{border-top-color:#b9bbbe}.alert-dark .alert-link{color:#040505}@keyframes progress-bar-stripes{0%{background-position:1rem 0}to{background-position:0 0}}.progress{height:1rem;line-height:0;font-size:.75rem;background-color:#e9ecef;border-radius:.25rem}.progress,.progress-bar{display:flex;overflow:hidden}.progress-bar{flex-direction:column;justify-content:center;color:#fff;text-align:center;white-space:nowrap;background-color:#007bff;transition:width .6s ease}@media (prefers-reduced-motion:reduce){.progress-bar{transition:none}}.progress-bar-striped{background-image:linear-gradient(45deg,hsla(0,0%,100%,.15) 25%,transparent 0,transparent 50%,hsla(0,0%,100%,.15) 0,hsla(0,0%,100%,.15) 75%,transparent 0,transparent);background-size:1rem 1rem}.progress-bar-animated{animation:progress-bar-stripes 1s linear infinite}@media (prefers-reduced-motion:reduce){.progress-bar-animated{animation:none}}.media{display:flex;align-items:flex-start}.media-body{flex:1}.list-group{display:flex;flex-direction:column;padding-left:0;margin-bottom:0;border-radius:.25rem}.list-group-item-action{width:100%;color:#495057;text-align:inherit}.list-group-item-action:focus,.list-group-item-action:hover{z-index:1;color:#495057;text-decoration:none;background-color:#f8f9fa}.list-group-item-action:active{color:#212529;background-color:#e9ecef}.list-group-item{position:relative;display:block;padding:.75rem 1.25rem;background-color:#fff;border:1px solid rgba(0,0,0,.125)}.list-group-item:first-child{border-top-left-radius:inherit;border-top-right-radius:inherit}.list-group-item:last-child{border-bottom-right-radius:inherit;border-bottom-left-radius:inherit}.list-group-item.disabled,.list-group-item:disabled{color:#6c757d;pointer-events:none;background-color:#fff}.list-group-item.active{z-index:2;color:#fff;background-color:#007bff;border-color:#007bff}.list-group-item+.list-group-item{border-top-width:0}.list-group-item+.list-group-item.active{margin-top:-1px;border-top-width:1px}.list-group-horizontal{flex-direction:row}.list-group-horizontal>.list-group-item:first-child{border-bottom-left-radius:.25rem;border-top-right-radius:0}.list-group-horizontal>.list-group-item:last-child{border-top-right-radius:.25rem;border-bottom-left-radius:0}.list-group-horizontal>.list-group-item.active{margin-top:0}.list-group-horizontal>.list-group-item+.list-group-item{border-top-width:1px;border-left-width:0}.list-group-horizontal>.list-group-item+.list-group-item.active{margin-left:-1px;border-left-width:1px}@media (min-width:540px){.list-group-horizontal-sm{flex-direction:row}.list-group-horizontal-sm>.list-group-item:first-child{border-bottom-left-radius:.25rem;border-top-right-radius:0}.list-group-horizontal-sm>.list-group-item:last-child{border-top-right-radius:.25rem;border-bottom-left-radius:0}.list-group-horizontal-sm>.list-group-item.active{margin-top:0}.list-group-horizontal-sm>.list-group-item+.list-group-item{border-top-width:1px;border-left-width:0}.list-group-horizontal-sm>.list-group-item+.list-group-item.active{margin-left:-1px;border-left-width:1px}}@media (min-width:720px){.list-group-horizontal-md{flex-direction:row}.list-group-horizontal-md>.list-group-item:first-child{border-bottom-left-radius:.25rem;border-top-right-radius:0}.list-group-horizontal-md>.list-group-item:last-child{border-top-right-radius:.25rem;border-bottom-left-radius:0}.list-group-horizontal-md>.list-group-item.active{margin-top:0}.list-group-horizontal-md>.list-group-item+.list-group-item{border-top-width:1px;border-left-width:0}.list-group-horizontal-md>.list-group-item+.list-group-item.active{margin-left:-1px;border-left-width:1px}}@media (min-width:960px){.list-group-horizontal-lg{flex-direction:row}.list-group-horizontal-lg>.list-group-item:first-child{border-bottom-left-radius:.25rem;border-top-right-radius:0}.list-group-horizontal-lg>.list-group-item:last-child{border-top-right-radius:.25rem;border-bottom-left-radius:0}.list-group-horizontal-lg>.list-group-item.active{margin-top:0}.list-group-horizontal-lg>.list-group-item+.list-group-item{border-top-width:1px;border-left-width:0}.list-group-horizontal-lg>.list-group-item+.list-group-item.active{margin-left:-1px;border-left-width:1px}}@media (min-width:1200px){.list-group-horizontal-xl{flex-direction:row}.list-group-horizontal-xl>.list-group-item:first-child{border-bottom-left-radius:.25rem;border-top-right-radius:0}.list-group-horizontal-xl>.list-group-item:last-child{border-top-right-radius:.25rem;border-bottom-left-radius:0}.list-group-horizontal-xl>.list-group-item.active{margin-top:0}.list-group-horizontal-xl>.list-group-item+.list-group-item{border-top-width:1px;border-left-width:0}.list-group-horizontal-xl>.list-group-item+.list-group-item.active{margin-left:-1px;border-left-width:1px}}.list-group-flush{border-radius:0}.list-group-flush>.list-group-item{border-width:0 0 1px}.list-group-flush>.list-group-item:last-child{border-bottom-width:0}.list-group-item-primary{color:#004085;background-color:#b8daff}.list-group-item-primary.list-group-item-action:focus,.list-group-item-primary.list-group-item-action:hover{color:#004085;background-color:#9fcdff}.list-group-item-primary.list-group-item-action.active{color:#fff;background-color:#004085;border-color:#004085}.list-group-item-secondary{color:#383d41;background-color:#d6d8db}.list-group-item-secondary.list-group-item-action:focus,.list-group-item-secondary.list-group-item-action:hover{color:#383d41;background-color:#c8cbcf}.list-group-item-secondary.list-group-item-action.active{color:#fff;background-color:#383d41;border-color:#383d41}.list-group-item-success{color:#155724;background-color:#c3e6cb}.list-group-item-success.list-group-item-action:focus,.list-group-item-success.list-group-item-action:hover{color:#155724;background-color:#b1dfbb}.list-group-item-success.list-group-item-action.active{color:#fff;background-color:#155724;border-color:#155724}.list-group-item-info{color:#0c5460;background-color:#bee5eb}.list-group-item-info.list-group-item-action:focus,.list-group-item-info.list-group-item-action:hover{color:#0c5460;background-color:#abdde5}.list-group-item-info.list-group-item-action.active{color:#fff;background-color:#0c5460;border-color:#0c5460}.list-group-item-warning{color:#856404;background-color:#ffeeba}.list-group-item-warning.list-group-item-action:focus,.list-group-item-warning.list-group-item-action:hover{color:#856404;background-color:#ffe8a1}.list-group-item-warning.list-group-item-action.active{color:#fff;background-color:#856404;border-color:#856404}.list-group-item-danger{color:#721c24;background-color:#f5c6cb}.list-group-item-danger.list-group-item-action:focus,.list-group-item-danger.list-group-item-action:hover{color:#721c24;background-color:#f1b0b7}.list-group-item-danger.list-group-item-action.active{color:#fff;background-color:#721c24;border-color:#721c24}.list-group-item-light{color:#818182;background-color:#fdfdfe}.list-group-item-light.list-group-item-action:focus,.list-group-item-light.list-group-item-action:hover{color:#818182;background-color:#ececf6}.list-group-item-light.list-group-item-action.active{color:#fff;background-color:#818182;border-color:#818182}.list-group-item-dark{color:#1b1e21;background-color:#c6c8ca}.list-group-item-dark.list-group-item-action:focus,.list-group-item-dark.list-group-item-action:hover{color:#1b1e21;background-color:#b9bbbe}.list-group-item-dark.list-group-item-action.active{color:#fff;background-color:#1b1e21;border-color:#1b1e21}.close{float:right;font-size:1.5rem;font-weight:700;line-height:1;color:#000;text-shadow:0 1px 0 #fff;opacity:.5}.close:hover{color:#000;text-decoration:none}.close:not(:disabled):not(.disabled):focus,.close:not(:disabled):not(.disabled):hover{opacity:.75}button.close{padding:0;background-color:transparent;border:0}a.close.disabled{pointer-events:none}.toast{max-width:350px;overflow:hidden;font-size:.875rem;background-color:hsla(0,0%,100%,.85);background-clip:padding-box;border:1px solid rgba(0,0,0,.1);box-shadow:0 .25rem .75rem rgba(0,0,0,.1);backdrop-filter:blur(10px);opacity:0;border-radius:.25rem}.toast:not(:last-child){margin-bottom:.75rem}.toast.showing{opacity:1}.toast.show{display:block;opacity:1}.toast.hide{display:none}.toast-header{display:flex;align-items:center;padding:.25rem .75rem;color:#6c757d;background-color:hsla(0,0%,100%,.85);background-clip:padding-box;border-bottom:1px solid rgba(0,0,0,.05)}.toast-body{padding:.75rem}.modal-open{overflow:hidden}.modal-open .modal{overflow-x:hidden;overflow-y:auto}.modal{position:fixed;top:0;left:0;z-index:1050;display:none;width:100%;height:100%;overflow:hidden;outline:0}.modal-dialog{position:relative;width:auto;margin:.5rem;pointer-events:none}.modal.fade .modal-dialog{transition:transform .3s ease-out;transform:translateY(-50px)}@media (prefers-reduced-motion:reduce){.modal.fade .modal-dialog{transition:none}}.modal.show .modal-dialog{transform:none}.modal.modal-static .modal-dialog{transform:scale(1.02)}.modal-dialog-scrollable{display:flex;max-height:calc(100% - 1rem)}.modal-dialog-scrollable .modal-content{max-height:calc(100vh - 1rem);overflow:hidden}.modal-dialog-scrollable .modal-footer,.modal-dialog-scrollable .modal-header{flex-shrink:0}.modal-dialog-scrollable .modal-body{overflow-y:auto}.modal-dialog-centered{display:flex;align-items:center;min-height:calc(100% - 1rem)}.modal-dialog-centered:before{display:block;height:calc(100vh - 1rem);height:min-content;content:""}.modal-dialog-centered.modal-dialog-scrollable{flex-direction:column;justify-content:center;height:100%}.modal-dialog-centered.modal-dialog-scrollable .modal-content{max-height:none}.modal-dialog-centered.modal-dialog-scrollable:before{content:none}.modal-content{position:relative;display:flex;flex-direction:column;width:100%;pointer-events:auto;background-color:#fff;background-clip:padding-box;border:1px solid rgba(0,0,0,.2);border-radius:.3rem;outline:0}.modal-backdrop{position:fixed;top:0;left:0;z-index:1040;width:100vw;height:100vh;background-color:#000}.modal-backdrop.fade{opacity:0}.modal-backdrop.show{opacity:.5}.modal-header{display:flex;align-items:flex-start;justify-content:space-between;padding:1rem;border-bottom:1px solid #dee2e6;border-top-left-radius:calc(.3rem - 1px);border-top-right-radius:calc(.3rem - 1px)}.modal-header .close{padding:1rem;margin:-1rem -1rem -1rem auto}.modal-title{margin-bottom:0;line-height:1.5}.modal-body{position:relative;flex:1 1 auto;padding:1rem}.modal-footer{display:flex;flex-wrap:wrap;align-items:center;justify-content:flex-end;padding:.75rem;border-top:1px solid #dee2e6;border-bottom-right-radius:calc(.3rem - 1px);border-bottom-left-radius:calc(.3rem - 1px)}.modal-footer>*{margin:.25rem}.modal-scrollbar-measure{position:absolute;top:-9999px;width:50px;height:50px;overflow:scroll}@media (min-width:540px){.modal-dialog{max-width:500px;margin:1.75rem auto}.modal-dialog-scrollable{max-height:calc(100% - 3.5rem)}.modal-dialog-scrollable .modal-content{max-height:calc(100vh - 3.5rem)}.modal-dialog-centered{min-height:calc(100% - 3.5rem)}.modal-dialog-centered:before{height:calc(100vh - 3.5rem);height:min-content}.modal-sm{max-width:300px}}@media (min-width:960px){.modal-lg,.modal-xl{max-width:800px}}@media (min-width:1200px){.modal-xl{max-width:1140px}}.tooltip{position:absolute;z-index:1070;display:block;margin:0;font-family:-apple-system,BlinkMacSystemFont,Segoe UI,Roboto,Helvetica Neue,Arial,Noto Sans,sans-serif,Apple Color Emoji,Segoe UI Emoji,Segoe UI Symbol,Noto Color Emoji;font-style:normal;font-weight:400;line-height:1.5;text-align:left;text-align:start;text-decoration:none;text-shadow:none;text-transform:none;letter-spacing:normal;word-break:normal;word-spacing:normal;white-space:normal;line-break:auto;font-size:.875rem;word-wrap:break-word;opacity:0}.tooltip.show{opacity:.9}.tooltip .arrow{position:absolute;display:block;width:.8rem;height:.4rem}.tooltip .arrow:before{position:absolute;content:"";border-color:transparent;border-style:solid}.bs-tooltip-auto[x-placement^=top],.bs-tooltip-top{padding:.4rem 0}.bs-tooltip-auto[x-placement^=top] .arrow,.bs-tooltip-top .arrow{bottom:0}.bs-tooltip-auto[x-placement^=top] .arrow:before,.bs-tooltip-top .arrow:before{top:0;border-width:.4rem .4rem 0;border-top-color:#000}.bs-tooltip-auto[x-placement^=right],.bs-tooltip-right{padding:0 .4rem}.bs-tooltip-auto[x-placement^=right] .arrow,.bs-tooltip-right .arrow{left:0;width:.4rem;height:.8rem}.bs-tooltip-auto[x-placement^=right] .arrow:before,.bs-tooltip-right .arrow:before{right:0;border-width:.4rem .4rem .4rem 0;border-right-color:#000}.bs-tooltip-auto[x-placement^=bottom],.bs-tooltip-bottom{padding:.4rem 0}.bs-tooltip-auto[x-placement^=bottom] .arrow,.bs-tooltip-bottom .arrow{top:0}.bs-tooltip-auto[x-placement^=bottom] .arrow:before,.bs-tooltip-bottom .arrow:before{bottom:0;border-width:0 .4rem .4rem;border-bottom-color:#000}.bs-tooltip-auto[x-placement^=left],.bs-tooltip-left{padding:0 .4rem}.bs-tooltip-auto[x-placement^=left] .arrow,.bs-tooltip-left .arrow{right:0;width:.4rem;height:.8rem}.bs-tooltip-auto[x-placement^=left] .arrow:before,.bs-tooltip-left .arrow:before{left:0;border-width:.4rem 0 .4rem .4rem;border-left-color:#000}.tooltip-inner{max-width:200px;padding:.25rem .5rem;color:#fff;text-align:center;background-color:#000;border-radius:.25rem}.popover{top:0;left:0;z-index:1060;max-width:276px;font-family:-apple-system,BlinkMacSystemFont,Segoe UI,Roboto,Helvetica Neue,Arial,Noto Sans,sans-serif,Apple Color Emoji,Segoe UI Emoji,Segoe UI Symbol,Noto Color Emoji;font-style:normal;font-weight:400;line-height:1.5;text-align:left;text-align:start;text-decoration:none;text-shadow:none;text-transform:none;letter-spacing:normal;word-break:normal;word-spacing:normal;white-space:normal;line-break:auto;font-size:.875rem;word-wrap:break-word;background-color:#fff;background-clip:padding-box;border:1px solid rgba(0,0,0,.2);border-radius:.3rem}.popover,.popover .arrow{position:absolute;display:block}.popover .arrow{width:1rem;height:.5rem;margin:0 .3rem}.popover .arrow:after,.popover .arrow:before{position:absolute;display:block;content:"";border-color:transparent;border-style:solid}.bs-popover-auto[x-placement^=top],.bs-popover-top{margin-bottom:.5rem}.bs-popover-auto[x-placement^=top]>.arrow,.bs-popover-top>.arrow{bottom:calc(-.5rem - 1px)}.bs-popover-auto[x-placement^=top]>.arrow:before,.bs-popover-top>.arrow:before{bottom:0;border-width:.5rem .5rem 0;border-top-color:rgba(0,0,0,.25)}.bs-popover-auto[x-placement^=top]>.arrow:after,.bs-popover-top>.arrow:after{bottom:1px;border-width:.5rem .5rem 0;border-top-color:#fff}.bs-popover-auto[x-placement^=right],.bs-popover-right{margin-left:.5rem}.bs-popover-auto[x-placement^=right]>.arrow,.bs-popover-right>.arrow{left:calc(-.5rem - 1px);width:.5rem;height:1rem;margin:.3rem 0}.bs-popover-auto[x-placement^=right]>.arrow:before,.bs-popover-right>.arrow:before{left:0;border-width:.5rem .5rem .5rem 0;border-right-color:rgba(0,0,0,.25)}.bs-popover-auto[x-placement^=right]>.arrow:after,.bs-popover-right>.arrow:after{left:1px;border-width:.5rem .5rem .5rem 0;border-right-color:#fff}.bs-popover-auto[x-placement^=bottom],.bs-popover-bottom{margin-top:.5rem}.bs-popover-auto[x-placement^=bottom]>.arrow,.bs-popover-bottom>.arrow{top:calc(-.5rem - 1px)}.bs-popover-auto[x-placement^=bottom]>.arrow:before,.bs-popover-bottom>.arrow:before{top:0;border-width:0 .5rem .5rem;border-bottom-color:rgba(0,0,0,.25)}.bs-popover-auto[x-placement^=bottom]>.arrow:after,.bs-popover-bottom>.arrow:after{top:1px;border-width:0 .5rem .5rem;border-bottom-color:#fff}.bs-popover-auto[x-placement^=bottom] .popover-header:before,.bs-popover-bottom .popover-header:before{position:absolute;top:0;left:50%;display:block;width:1rem;margin-left:-.5rem;content:"";border-bottom:1px solid #f7f7f7}.bs-popover-auto[x-placement^=left],.bs-popover-left{margin-right:.5rem}.bs-popover-auto[x-placement^=left]>.arrow,.bs-popover-left>.arrow{right:calc(-.5rem - 1px);width:.5rem;height:1rem;margin:.3rem 0}.bs-popover-auto[x-placement^=left]>.arrow:before,.bs-popover-left>.arrow:before{right:0;border-width:.5rem 0 .5rem .5rem;border-left-color:rgba(0,0,0,.25)}.bs-popover-auto[x-placement^=left]>.arrow:after,.bs-popover-left>.arrow:after{right:1px;border-width:.5rem 0 .5rem .5rem;border-left-color:#fff}.popover-header{padding:.5rem .75rem;margin-bottom:0;font-size:1rem;background-color:#f7f7f7;border-bottom:1px solid #ebebeb;border-top-left-radius:calc(.3rem - 1px);border-top-right-radius:calc(.3rem - 1px)}.popover-header:empty{display:none}.popover-body{padding:.5rem .75rem;color:#212529}.carousel{position:relative}.carousel.pointer-event{touch-action:pan-y}.carousel-inner{position:relative;width:100%;overflow:hidden}.carousel-inner:after{display:block;clear:both;content:""}.carousel-item{position:relative;display:none;float:left;width:100%;margin-right:-100%;backface-visibility:hidden;transition:transform .6s ease-in-out}@media (prefers-reduced-motion:reduce){.carousel-item{transition:none}}.carousel-item-next,.carousel-item-prev,.carousel-item.active{display:block}.active.carousel-item-right,.carousel-item-next:not(.carousel-item-left){transform:translateX(100%)}.active.carousel-item-left,.carousel-item-prev:not(.carousel-item-right){transform:translateX(-100%)}.carousel-fade .carousel-item{opacity:0;transition-property:opacity;transform:none}.carousel-fade .carousel-item-next.carousel-item-left,.carousel-fade .carousel-item-prev.carousel-item-right,.carousel-fade .carousel-item.active{z-index:1;opacity:1}.carousel-fade .active.carousel-item-left,.carousel-fade .active.carousel-item-right{z-index:0;opacity:0;transition:opacity 0s .6s}@media (prefers-reduced-motion:reduce){.carousel-fade .active.carousel-item-left,.carousel-fade .active.carousel-item-right{transition:none}}.carousel-control-next,.carousel-control-prev{position:absolute;top:0;bottom:0;z-index:1;display:flex;align-items:center;justify-content:center;width:15%;color:#fff;text-align:center;opacity:.5;transition:opacity .15s ease}@media (prefers-reduced-motion:reduce){.carousel-control-next,.carousel-control-prev{transition:none}}.carousel-control-next:focus,.carousel-control-next:hover,.carousel-control-prev:focus,.carousel-control-prev:hover{color:#fff;text-decoration:none;outline:0;opacity:.9}.carousel-control-prev{left:0}.carousel-control-next{right:0}.carousel-control-next-icon,.carousel-control-prev-icon{display:inline-block;width:20px;height:20px;background:no-repeat 50%/100% 100%}.carousel-control-prev-icon{background-image:url("data:image/svg+xml;charset=utf-8,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='%23fff' width='8' height='8'%3E%3Cpath d='M5.25 0l-4 4 4 4 1.5-1.5L4.25 4l2.5-2.5L5.25 0z'/%3E%3C/svg%3E")}.carousel-control-next-icon{background-image:url("data:image/svg+xml;charset=utf-8,%3Csvg xmlns='http://www.w3.org/2000/svg' fill='%23fff' width='8' height='8'%3E%3Cpath d='M2.75 0l-1.5 1.5L3.75 4l-2.5 2.5L2.75 8l4-4-4-4z'/%3E%3C/svg%3E")}.carousel-indicators{position:absolute;right:0;bottom:0;left:0;z-index:15;display:flex;justify-content:center;padding-left:0;margin-right:15%;margin-left:15%;list-style:none}.carousel-indicators li{box-sizing:content-box;flex:0 1 auto;width:30px;height:3px;margin-right:3px;margin-left:3px;text-indent:-999px;cursor:pointer;background-color:#fff;background-clip:padding-box;border-top:10px solid transparent;border-bottom:10px solid transparent;opacity:.5;transition:opacity .6s ease}@media (prefers-reduced-motion:reduce){.carousel-indicators li{transition:none}}.carousel-indicators .active{opacity:1}.carousel-caption{position:absolute;right:15%;bottom:20px;left:15%;z-index:10;padding-top:20px;padding-bottom:20px;color:#fff;text-align:center}@keyframes spinner-border{to{transform:rotate(1turn)}}.spinner-border{display:inline-block;width:2rem;height:2rem;vertical-align:text-bottom;border:.25em solid;border-right:.25em solid transparent;border-radius:50%;animation:spinner-border .75s linear infinite}.spinner-border-sm{width:1rem;height:1rem;border-width:.2em}@keyframes spinner-grow{0%{transform:scale(0)}50%{opacity:1;transform:none}}.spinner-grow{display:inline-block;width:2rem;height:2rem;vertical-align:text-bottom;background-color:currentColor;border-radius:50%;opacity:0;animation:spinner-grow .75s linear infinite}.spinner-grow-sm{width:1rem;height:1rem}.align-baseline{vertical-align:baseline!important}.align-top{vertical-align:top!important}.align-middle{vertical-align:middle!important}.align-bottom{vertical-align:bottom!important}.align-text-bottom{vertical-align:text-bottom!important}.align-text-top{vertical-align:text-top!important}.bg-primary{background-color:#007bff!important}a.bg-primary:focus,a.bg-primary:hover,button.bg-primary:focus,button.bg-primary:hover{background-color:#0062cc!important}.bg-secondary{background-color:#6c757d!important}a.bg-secondary:focus,a.bg-secondary:hover,button.bg-secondary:focus,button.bg-secondary:hover{background-color:#545b62!important}.bg-success{background-color:#28a745!important}a.bg-success:focus,a.bg-success:hover,button.bg-success:focus,button.bg-success:hover{background-color:#1e7e34!important}.bg-info{background-color:#17a2b8!important}a.bg-info:focus,a.bg-info:hover,button.bg-info:focus,button.bg-info:hover{background-color:#117a8b!important}.bg-warning{background-color:#ffc107!important}a.bg-warning:focus,a.bg-warning:hover,button.bg-warning:focus,button.bg-warning:hover{background-color:#d39e00!important}.bg-danger{background-color:#dc3545!important}a.bg-danger:focus,a.bg-danger:hover,button.bg-danger:focus,button.bg-danger:hover{background-color:#bd2130!important}.bg-light{background-color:#f8f9fa!important}a.bg-light:focus,a.bg-light:hover,button.bg-light:focus,button.bg-light:hover{background-color:#dae0e5!important}.bg-dark{background-color:#343a40!important}a.bg-dark:focus,a.bg-dark:hover,button.bg-dark:focus,button.bg-dark:hover{background-color:#1d2124!important}.bg-white{background-color:#fff!important}.bg-transparent{background-color:transparent!important}.border{border:1px solid #dee2e6!important}.border-top{border-top:1px solid #dee2e6!important}.border-right{border-right:1px solid #dee2e6!important}.border-bottom{border-bottom:1px solid #dee2e6!important}.border-left{border-left:1px solid #dee2e6!important}.border-0{border:0!important}.border-top-0{border-top:0!important}.border-right-0{border-right:0!important}.border-bottom-0{border-bottom:0!important}.border-left-0{border-left:0!important}.border-primary{border-color:#007bff!important}.border-secondary{border-color:#6c757d!important}.border-success{border-color:#28a745!important}.border-info{border-color:#17a2b8!important}.border-warning{border-color:#ffc107!important}.border-danger{border-color:#dc3545!important}.border-light{border-color:#f8f9fa!important}.border-dark{border-color:#343a40!important}.border-white{border-color:#fff!important}.rounded-sm{border-radius:.2rem!important}.rounded{border-radius:.25rem!important}.rounded-top{border-top-left-radius:.25rem!important}.rounded-right,.rounded-top{border-top-right-radius:.25rem!important}.rounded-bottom,.rounded-right{border-bottom-right-radius:.25rem!important}.rounded-bottom,.rounded-left{border-bottom-left-radius:.25rem!important}.rounded-left{border-top-left-radius:.25rem!important}.rounded-lg{border-radius:.3rem!important}.rounded-circle{border-radius:50%!important}.rounded-pill{border-radius:50rem!important}.rounded-0{border-radius:0!important}.clearfix:after{display:block;clear:both;content:""}.d-none{display:none!important}.d-inline{display:inline!important}.d-inline-block{display:inline-block!important}.d-block{display:block!important}.d-table{display:table!important}.d-table-row{display:table-row!important}.d-table-cell{display:table-cell!important}.d-flex{display:flex!important}.d-inline-flex{display:inline-flex!important}@media (min-width:540px){.d-sm-none{display:none!important}.d-sm-inline{display:inline!important}.d-sm-inline-block{display:inline-block!important}.d-sm-block{display:block!important}.d-sm-table{display:table!important}.d-sm-table-row{display:table-row!important}.d-sm-table-cell{display:table-cell!important}.d-sm-flex{display:flex!important}.d-sm-inline-flex{display:inline-flex!important}}@media (min-width:720px){.d-md-none{display:none!important}.d-md-inline{display:inline!important}.d-md-inline-block{display:inline-block!important}.d-md-block{display:block!important}.d-md-table{display:table!important}.d-md-table-row{display:table-row!important}.d-md-table-cell{display:table-cell!important}.d-md-flex{display:flex!important}.d-md-inline-flex{display:inline-flex!important}}@media (min-width:960px){.d-lg-none{display:none!important}.d-lg-inline{display:inline!important}.d-lg-inline-block{display:inline-block!important}.d-lg-block{display:block!important}.d-lg-table{display:table!important}.d-lg-table-row{display:table-row!important}.d-lg-table-cell{display:table-cell!important}.d-lg-flex{display:flex!important}.d-lg-inline-flex{display:inline-flex!important}}@media (min-width:1200px){.d-xl-none{display:none!important}.d-xl-inline{display:inline!important}.d-xl-inline-block{display:inline-block!important}.d-xl-block{display:block!important}.d-xl-table{display:table!important}.d-xl-table-row{display:table-row!important}.d-xl-table-cell{display:table-cell!important}.d-xl-flex{display:flex!important}.d-xl-inline-flex{display:inline-flex!important}}@media print{.d-print-none{display:none!important}.d-print-inline{display:inline!important}.d-print-inline-block{display:inline-block!important}.d-print-block{display:block!important}.d-print-table{display:table!important}.d-print-table-row{display:table-row!important}.d-print-table-cell{display:table-cell!important}.d-print-flex{display:flex!important}.d-print-inline-flex{display:inline-flex!important}}.embed-responsive{position:relative;display:block;width:100%;padding:0;overflow:hidden}.embed-responsive:before{display:block;content:""}.embed-responsive .embed-responsive-item,.embed-responsive embed,.embed-responsive iframe,.embed-responsive object,.embed-responsive video{position:absolute;top:0;bottom:0;left:0;width:100%;height:100%;border:0}.embed-responsive-21by9:before{padding-top:42.85714%}.embed-responsive-16by9:before{padding-top:56.25%}.embed-responsive-4by3:before{padding-top:75%}.embed-responsive-1by1:before{padding-top:100%}.flex-row{flex-direction:row!important}.flex-column{flex-direction:column!important}.flex-row-reverse{flex-direction:row-reverse!important}.flex-column-reverse{flex-direction:column-reverse!important}.flex-wrap{flex-wrap:wrap!important}.flex-nowrap{flex-wrap:nowrap!important}.flex-wrap-reverse{flex-wrap:wrap-reverse!important}.flex-fill{flex:1 1 auto!important}.flex-grow-0{flex-grow:0!important}.flex-grow-1{flex-grow:1!important}.flex-shrink-0{flex-shrink:0!important}.flex-shrink-1{flex-shrink:1!important}.justify-content-start{justify-content:flex-start!important}.justify-content-end{justify-content:flex-end!important}.justify-content-center{justify-content:center!important}.justify-content-between{justify-content:space-between!important}.justify-content-around{justify-content:space-around!important}.align-items-start{align-items:flex-start!important}.align-items-end{align-items:flex-end!important}.align-items-center{align-items:center!important}.align-items-baseline{align-items:baseline!important}.align-items-stretch{align-items:stretch!important}.align-content-start{align-content:flex-start!important}.align-content-end{align-content:flex-end!important}.align-content-center{align-content:center!important}.align-content-between{align-content:space-between!important}.align-content-around{align-content:space-around!important}.align-content-stretch{align-content:stretch!important}.align-self-auto{align-self:auto!important}.align-self-start{align-self:flex-start!important}.align-self-end{align-self:flex-end!important}.align-self-center{align-self:center!important}.align-self-baseline{align-self:baseline!important}.align-self-stretch{align-self:stretch!important}@media (min-width:540px){.flex-sm-row{flex-direction:row!important}.flex-sm-column{flex-direction:column!important}.flex-sm-row-reverse{flex-direction:row-reverse!important}.flex-sm-column-reverse{flex-direction:column-reverse!important}.flex-sm-wrap{flex-wrap:wrap!important}.flex-sm-nowrap{flex-wrap:nowrap!important}.flex-sm-wrap-reverse{flex-wrap:wrap-reverse!important}.flex-sm-fill{flex:1 1 auto!important}.flex-sm-grow-0{flex-grow:0!important}.flex-sm-grow-1{flex-grow:1!important}.flex-sm-shrink-0{flex-shrink:0!important}.flex-sm-shrink-1{flex-shrink:1!important}.justify-content-sm-start{justify-content:flex-start!important}.justify-content-sm-end{justify-content:flex-end!important}.justify-content-sm-center{justify-content:center!important}.justify-content-sm-between{justify-content:space-between!important}.justify-content-sm-around{justify-content:space-around!important}.align-items-sm-start{align-items:flex-start!important}.align-items-sm-end{align-items:flex-end!important}.align-items-sm-center{align-items:center!important}.align-items-sm-baseline{align-items:baseline!important}.align-items-sm-stretch{align-items:stretch!important}.align-content-sm-start{align-content:flex-start!important}.align-content-sm-end{align-content:flex-end!important}.align-content-sm-center{align-content:center!important}.align-content-sm-between{align-content:space-between!important}.align-content-sm-around{align-content:space-around!important}.align-content-sm-stretch{align-content:stretch!important}.align-self-sm-auto{align-self:auto!important}.align-self-sm-start{align-self:flex-start!important}.align-self-sm-end{align-self:flex-end!important}.align-self-sm-center{align-self:center!important}.align-self-sm-baseline{align-self:baseline!important}.align-self-sm-stretch{align-self:stretch!important}}@media (min-width:720px){.flex-md-row{flex-direction:row!important}.flex-md-column{flex-direction:column!important}.flex-md-row-reverse{flex-direction:row-reverse!important}.flex-md-column-reverse{flex-direction:column-reverse!important}.flex-md-wrap{flex-wrap:wrap!important}.flex-md-nowrap{flex-wrap:nowrap!important}.flex-md-wrap-reverse{flex-wrap:wrap-reverse!important}.flex-md-fill{flex:1 1 auto!important}.flex-md-grow-0{flex-grow:0!important}.flex-md-grow-1{flex-grow:1!important}.flex-md-shrink-0{flex-shrink:0!important}.flex-md-shrink-1{flex-shrink:1!important}.justify-content-md-start{justify-content:flex-start!important}.justify-content-md-end{justify-content:flex-end!important}.justify-content-md-center{justify-content:center!important}.justify-content-md-between{justify-content:space-between!important}.justify-content-md-around{justify-content:space-around!important}.align-items-md-start{align-items:flex-start!important}.align-items-md-end{align-items:flex-end!important}.align-items-md-center{align-items:center!important}.align-items-md-baseline{align-items:baseline!important}.align-items-md-stretch{align-items:stretch!important}.align-content-md-start{align-content:flex-start!important}.align-content-md-end{align-content:flex-end!important}.align-content-md-center{align-content:center!important}.align-content-md-between{align-content:space-between!important}.align-content-md-around{align-content:space-around!important}.align-content-md-stretch{align-content:stretch!important}.align-self-md-auto{align-self:auto!important}.align-self-md-start{align-self:flex-start!important}.align-self-md-end{align-self:flex-end!important}.align-self-md-center{align-self:center!important}.align-self-md-baseline{align-self:baseline!important}.align-self-md-stretch{align-self:stretch!important}}@media (min-width:960px){.flex-lg-row{flex-direction:row!important}.flex-lg-column{flex-direction:column!important}.flex-lg-row-reverse{flex-direction:row-reverse!important}.flex-lg-column-reverse{flex-direction:column-reverse!important}.flex-lg-wrap{flex-wrap:wrap!important}.flex-lg-nowrap{flex-wrap:nowrap!important}.flex-lg-wrap-reverse{flex-wrap:wrap-reverse!important}.flex-lg-fill{flex:1 1 auto!important}.flex-lg-grow-0{flex-grow:0!important}.flex-lg-grow-1{flex-grow:1!important}.flex-lg-shrink-0{flex-shrink:0!important}.flex-lg-shrink-1{flex-shrink:1!important}.justify-content-lg-start{justify-content:flex-start!important}.justify-content-lg-end{justify-content:flex-end!important}.justify-content-lg-center{justify-content:center!important}.justify-content-lg-between{justify-content:space-between!important}.justify-content-lg-around{justify-content:space-around!important}.align-items-lg-start{align-items:flex-start!important}.align-items-lg-end{align-items:flex-end!important}.align-items-lg-center{align-items:center!important}.align-items-lg-baseline{align-items:baseline!important}.align-items-lg-stretch{align-items:stretch!important}.align-content-lg-start{align-content:flex-start!important}.align-content-lg-end{align-content:flex-end!important}.align-content-lg-center{align-content:center!important}.align-content-lg-between{align-content:space-between!important}.align-content-lg-around{align-content:space-around!important}.align-content-lg-stretch{align-content:stretch!important}.align-self-lg-auto{align-self:auto!important}.align-self-lg-start{align-self:flex-start!important}.align-self-lg-end{align-self:flex-end!important}.align-self-lg-center{align-self:center!important}.align-self-lg-baseline{align-self:baseline!important}.align-self-lg-stretch{align-self:stretch!important}}@media (min-width:1200px){.flex-xl-row{flex-direction:row!important}.flex-xl-column{flex-direction:column!important}.flex-xl-row-reverse{flex-direction:row-reverse!important}.flex-xl-column-reverse{flex-direction:column-reverse!important}.flex-xl-wrap{flex-wrap:wrap!important}.flex-xl-nowrap{flex-wrap:nowrap!important}.flex-xl-wrap-reverse{flex-wrap:wrap-reverse!important}.flex-xl-fill{flex:1 1 auto!important}.flex-xl-grow-0{flex-grow:0!important}.flex-xl-grow-1{flex-grow:1!important}.flex-xl-shrink-0{flex-shrink:0!important}.flex-xl-shrink-1{flex-shrink:1!important}.justify-content-xl-start{justify-content:flex-start!important}.justify-content-xl-end{justify-content:flex-end!important}.justify-content-xl-center{justify-content:center!important}.justify-content-xl-between{justify-content:space-between!important}.justify-content-xl-around{justify-content:space-around!important}.align-items-xl-start{align-items:flex-start!important}.align-items-xl-end{align-items:flex-end!important}.align-items-xl-center{align-items:center!important}.align-items-xl-baseline{align-items:baseline!important}.align-items-xl-stretch{align-items:stretch!important}.align-content-xl-start{align-content:flex-start!important}.align-content-xl-end{align-content:flex-end!important}.align-content-xl-center{align-content:center!important}.align-content-xl-between{align-content:space-between!important}.align-content-xl-around{align-content:space-around!important}.align-content-xl-stretch{align-content:stretch!important}.align-self-xl-auto{align-self:auto!important}.align-self-xl-start{align-self:flex-start!important}.align-self-xl-end{align-self:flex-end!important}.align-self-xl-center{align-self:center!important}.align-self-xl-baseline{align-self:baseline!important}.align-self-xl-stretch{align-self:stretch!important}}.float-left{float:left!important}.float-right{float:right!important}.float-none{float:none!important}@media (min-width:540px){.float-sm-left{float:left!important}.float-sm-right{float:right!important}.float-sm-none{float:none!important}}@media (min-width:720px){.float-md-left{float:left!important}.float-md-right{float:right!important}.float-md-none{float:none!important}}@media (min-width:960px){.float-lg-left{float:left!important}.float-lg-right{float:right!important}.float-lg-none{float:none!important}}@media (min-width:1200px){.float-xl-left{float:left!important}.float-xl-right{float:right!important}.float-xl-none{float:none!important}}.user-select-all{user-select:all!important}.user-select-auto{user-select:auto!important}.user-select-none{user-select:none!important}.overflow-auto{overflow:auto!important}.overflow-hidden{overflow:hidden!important}.position-static{position:static!important}.position-relative{position:relative!important}.position-absolute{position:absolute!important}.position-fixed{position:fixed!important}.position-sticky{position:sticky!important}.fixed-top{top:0}.fixed-bottom,.fixed-top{position:fixed;right:0;left:0;z-index:1030}.fixed-bottom{bottom:0}@supports (position:sticky){.sticky-top{position:sticky;top:0;z-index:1020}}.sr-only{position:absolute;width:1px;height:1px;padding:0;margin:-1px;overflow:hidden;clip:rect(0,0,0,0);white-space:nowrap;border:0}.sr-only-focusable:active,.sr-only-focusable:focus{position:static;width:auto;height:auto;overflow:visible;clip:auto;white-space:normal}.shadow-sm{box-shadow:0 .125rem .25rem rgba(0,0,0,.075)!important}.shadow{box-shadow:0 .5rem 1rem rgba(0,0,0,.15)!important}.shadow-lg{box-shadow:0 1rem 3rem rgba(0,0,0,.175)!important}.shadow-none{box-shadow:none!important}.w-25{width:25%!important}.w-50{width:50%!important}.w-75{width:75%!important}.w-100{width:100%!important}.w-auto{width:auto!important}.h-25{height:25%!important}.h-50{height:50%!important}.h-75{height:75%!important}.h-100{height:100%!important}.h-auto{height:auto!important}.mw-100{max-width:100%!important}.mh-100{max-height:100%!important}.min-vw-100{min-width:100vw!important}.min-vh-100{min-height:100vh!important}.vw-100{width:100vw!important}.vh-100{height:100vh!important}.m-0{margin:0!important}.mt-0,.my-0{margin-top:0!important}.mr-0,.mx-0{margin-right:0!important}.mb-0,.my-0{margin-bottom:0!important}.ml-0,.mx-0{margin-left:0!important}.m-1{margin:.25rem!important}.mt-1,.my-1{margin-top:.25rem!important}.mr-1,.mx-1{margin-right:.25rem!important}.mb-1,.my-1{margin-bottom:.25rem!important}.ml-1,.mx-1{margin-left:.25rem!important}.m-2{margin:.5rem!important}.mt-2,.my-2{margin-top:.5rem!important}.mr-2,.mx-2{margin-right:.5rem!important}.mb-2,.my-2{margin-bottom:.5rem!important}.ml-2,.mx-2{margin-left:.5rem!important}.m-3{margin:1rem!important}.mt-3,.my-3{margin-top:1rem!important}.mr-3,.mx-3{margin-right:1rem!important}.mb-3,.my-3{margin-bottom:1rem!important}.ml-3,.mx-3{margin-left:1rem!important}.m-4{margin:1.5rem!important}.mt-4,.my-4{margin-top:1.5rem!important}.mr-4,.mx-4{margin-right:1.5rem!important}.mb-4,.my-4{margin-bottom:1.5rem!important}.ml-4,.mx-4{margin-left:1.5rem!important}.m-5{margin:3rem!important}.mt-5,.my-5{margin-top:3rem!important}.mr-5,.mx-5{margin-right:3rem!important}.mb-5,.my-5{margin-bottom:3rem!important}.ml-5,.mx-5{margin-left:3rem!important}.p-0{padding:0!important}.pt-0,.py-0{padding-top:0!important}.pr-0,.px-0{padding-right:0!important}.pb-0,.py-0{padding-bottom:0!important}.pl-0,.px-0{padding-left:0!important}.p-1{padding:.25rem!important}.pt-1,.py-1{padding-top:.25rem!important}.pr-1,.px-1{padding-right:.25rem!important}.pb-1,.py-1{padding-bottom:.25rem!important}.pl-1,.px-1{padding-left:.25rem!important}.p-2{padding:.5rem!important}.pt-2,.py-2{padding-top:.5rem!important}.pr-2,.px-2{padding-right:.5rem!important}.pb-2,.py-2{padding-bottom:.5rem!important}.pl-2,.px-2{padding-left:.5rem!important}.p-3{padding:1rem!important}.pt-3,.py-3{padding-top:1rem!important}.pr-3,.px-3{padding-right:1rem!important}.pb-3,.py-3{padding-bottom:1rem!important}.pl-3,.px-3{padding-left:1rem!important}.p-4{padding:1.5rem!important}.pt-4,.py-4{padding-top:1.5rem!important}.pr-4,.px-4{padding-right:1.5rem!important}.pb-4,.py-4{padding-bottom:1.5rem!important}.pl-4,.px-4{padding-left:1.5rem!important}.p-5{padding:3rem!important}.pt-5,.py-5{padding-top:3rem!important}.pr-5,.px-5{padding-right:3rem!important}.pb-5,.py-5{padding-bottom:3rem!important}.pl-5,.px-5{padding-left:3rem!important}.m-n1{margin:-.25rem!important}.mt-n1,.my-n1{margin-top:-.25rem!important}.mr-n1,.mx-n1{margin-right:-.25rem!important}.mb-n1,.my-n1{margin-bottom:-.25rem!important}.ml-n1,.mx-n1{margin-left:-.25rem!important}.m-n2{margin:-.5rem!important}.mt-n2,.my-n2{margin-top:-.5rem!important}.mr-n2,.mx-n2{margin-right:-.5rem!important}.mb-n2,.my-n2{margin-bottom:-.5rem!important}.ml-n2,.mx-n2{margin-left:-.5rem!important}.m-n3{margin:-1rem!important}.mt-n3,.my-n3{margin-top:-1rem!important}.mr-n3,.mx-n3{margin-right:-1rem!important}.mb-n3,.my-n3{margin-bottom:-1rem!important}.ml-n3,.mx-n3{margin-left:-1rem!important}.m-n4{margin:-1.5rem!important}.mt-n4,.my-n4{margin-top:-1.5rem!important}.mr-n4,.mx-n4{margin-right:-1.5rem!important}.mb-n4,.my-n4{margin-bottom:-1.5rem!important}.ml-n4,.mx-n4{margin-left:-1.5rem!important}.m-n5{margin:-3rem!important}.mt-n5,.my-n5{margin-top:-3rem!important}.mr-n5,.mx-n5{margin-right:-3rem!important}.mb-n5,.my-n5{margin-bottom:-3rem!important}.ml-n5,.mx-n5{margin-left:-3rem!important}.m-auto{margin:auto!important}.mt-auto,.my-auto{margin-top:auto!important}.mr-auto,.mx-auto{margin-right:auto!important}.mb-auto,.my-auto{margin-bottom:auto!important}.ml-auto,.mx-auto{margin-left:auto!important}@media (min-width:540px){.m-sm-0{margin:0!important}.mt-sm-0,.my-sm-0{margin-top:0!important}.mr-sm-0,.mx-sm-0{margin-right:0!important}.mb-sm-0,.my-sm-0{margin-bottom:0!important}.ml-sm-0,.mx-sm-0{margin-left:0!important}.m-sm-1{margin:.25rem!important}.mt-sm-1,.my-sm-1{margin-top:.25rem!important}.mr-sm-1,.mx-sm-1{margin-right:.25rem!important}.mb-sm-1,.my-sm-1{margin-bottom:.25rem!important}.ml-sm-1,.mx-sm-1{margin-left:.25rem!important}.m-sm-2{margin:.5rem!important}.mt-sm-2,.my-sm-2{margin-top:.5rem!important}.mr-sm-2,.mx-sm-2{margin-right:.5rem!important}.mb-sm-2,.my-sm-2{margin-bottom:.5rem!important}.ml-sm-2,.mx-sm-2{margin-left:.5rem!important}.m-sm-3{margin:1rem!important}.mt-sm-3,.my-sm-3{margin-top:1rem!important}.mr-sm-3,.mx-sm-3{margin-right:1rem!important}.mb-sm-3,.my-sm-3{margin-bottom:1rem!important}.ml-sm-3,.mx-sm-3{margin-left:1rem!important}.m-sm-4{margin:1.5rem!important}.mt-sm-4,.my-sm-4{margin-top:1.5rem!important}.mr-sm-4,.mx-sm-4{margin-right:1.5rem!important}.mb-sm-4,.my-sm-4{margin-bottom:1.5rem!important}.ml-sm-4,.mx-sm-4{margin-left:1.5rem!important}.m-sm-5{margin:3rem!important}.mt-sm-5,.my-sm-5{margin-top:3rem!important}.mr-sm-5,.mx-sm-5{margin-right:3rem!important}.mb-sm-5,.my-sm-5{margin-bottom:3rem!important}.ml-sm-5,.mx-sm-5{margin-left:3rem!important}.p-sm-0{padding:0!important}.pt-sm-0,.py-sm-0{padding-top:0!important}.pr-sm-0,.px-sm-0{padding-right:0!important}.pb-sm-0,.py-sm-0{padding-bottom:0!important}.pl-sm-0,.px-sm-0{padding-left:0!important}.p-sm-1{padding:.25rem!important}.pt-sm-1,.py-sm-1{padding-top:.25rem!important}.pr-sm-1,.px-sm-1{padding-right:.25rem!important}.pb-sm-1,.py-sm-1{padding-bottom:.25rem!important}.pl-sm-1,.px-sm-1{padding-left:.25rem!important}.p-sm-2{padding:.5rem!important}.pt-sm-2,.py-sm-2{padding-top:.5rem!important}.pr-sm-2,.px-sm-2{padding-right:.5rem!important}.pb-sm-2,.py-sm-2{padding-bottom:.5rem!important}.pl-sm-2,.px-sm-2{padding-left:.5rem!important}.p-sm-3{padding:1rem!important}.pt-sm-3,.py-sm-3{padding-top:1rem!important}.pr-sm-3,.px-sm-3{padding-right:1rem!important}.pb-sm-3,.py-sm-3{padding-bottom:1rem!important}.pl-sm-3,.px-sm-3{padding-left:1rem!important}.p-sm-4{padding:1.5rem!important}.pt-sm-4,.py-sm-4{padding-top:1.5rem!important}.pr-sm-4,.px-sm-4{padding-right:1.5rem!important}.pb-sm-4,.py-sm-4{padding-bottom:1.5rem!important}.pl-sm-4,.px-sm-4{padding-left:1.5rem!important}.p-sm-5{padding:3rem!important}.pt-sm-5,.py-sm-5{padding-top:3rem!important}.pr-sm-5,.px-sm-5{padding-right:3rem!important}.pb-sm-5,.py-sm-5{padding-bottom:3rem!important}.pl-sm-5,.px-sm-5{padding-left:3rem!important}.m-sm-n1{margin:-.25rem!important}.mt-sm-n1,.my-sm-n1{margin-top:-.25rem!important}.mr-sm-n1,.mx-sm-n1{margin-right:-.25rem!important}.mb-sm-n1,.my-sm-n1{margin-bottom:-.25rem!important}.ml-sm-n1,.mx-sm-n1{margin-left:-.25rem!important}.m-sm-n2{margin:-.5rem!important}.mt-sm-n2,.my-sm-n2{margin-top:-.5rem!important}.mr-sm-n2,.mx-sm-n2{margin-right:-.5rem!important}.mb-sm-n2,.my-sm-n2{margin-bottom:-.5rem!important}.ml-sm-n2,.mx-sm-n2{margin-left:-.5rem!important}.m-sm-n3{margin:-1rem!important}.mt-sm-n3,.my-sm-n3{margin-top:-1rem!important}.mr-sm-n3,.mx-sm-n3{margin-right:-1rem!important}.mb-sm-n3,.my-sm-n3{margin-bottom:-1rem!important}.ml-sm-n3,.mx-sm-n3{margin-left:-1rem!important}.m-sm-n4{margin:-1.5rem!important}.mt-sm-n4,.my-sm-n4{margin-top:-1.5rem!important}.mr-sm-n4,.mx-sm-n4{margin-right:-1.5rem!important}.mb-sm-n4,.my-sm-n4{margin-bottom:-1.5rem!important}.ml-sm-n4,.mx-sm-n4{margin-left:-1.5rem!important}.m-sm-n5{margin:-3rem!important}.mt-sm-n5,.my-sm-n5{margin-top:-3rem!important}.mr-sm-n5,.mx-sm-n5{margin-right:-3rem!important}.mb-sm-n5,.my-sm-n5{margin-bottom:-3rem!important}.ml-sm-n5,.mx-sm-n5{margin-left:-3rem!important}.m-sm-auto{margin:auto!important}.mt-sm-auto,.my-sm-auto{margin-top:auto!important}.mr-sm-auto,.mx-sm-auto{margin-right:auto!important}.mb-sm-auto,.my-sm-auto{margin-bottom:auto!important}.ml-sm-auto,.mx-sm-auto{margin-left:auto!important}}@media (min-width:720px){.m-md-0{margin:0!important}.mt-md-0,.my-md-0{margin-top:0!important}.mr-md-0,.mx-md-0{margin-right:0!important}.mb-md-0,.my-md-0{margin-bottom:0!important}.ml-md-0,.mx-md-0{margin-left:0!important}.m-md-1{margin:.25rem!important}.mt-md-1,.my-md-1{margin-top:.25rem!important}.mr-md-1,.mx-md-1{margin-right:.25rem!important}.mb-md-1,.my-md-1{margin-bottom:.25rem!important}.ml-md-1,.mx-md-1{margin-left:.25rem!important}.m-md-2{margin:.5rem!important}.mt-md-2,.my-md-2{margin-top:.5rem!important}.mr-md-2,.mx-md-2{margin-right:.5rem!important}.mb-md-2,.my-md-2{margin-bottom:.5rem!important}.ml-md-2,.mx-md-2{margin-left:.5rem!important}.m-md-3{margin:1rem!important}.mt-md-3,.my-md-3{margin-top:1rem!important}.mr-md-3,.mx-md-3{margin-right:1rem!important}.mb-md-3,.my-md-3{margin-bottom:1rem!important}.ml-md-3,.mx-md-3{margin-left:1rem!important}.m-md-4{margin:1.5rem!important}.mt-md-4,.my-md-4{margin-top:1.5rem!important}.mr-md-4,.mx-md-4{margin-right:1.5rem!important}.mb-md-4,.my-md-4{margin-bottom:1.5rem!important}.ml-md-4,.mx-md-4{margin-left:1.5rem!important}.m-md-5{margin:3rem!important}.mt-md-5,.my-md-5{margin-top:3rem!important}.mr-md-5,.mx-md-5{margin-right:3rem!important}.mb-md-5,.my-md-5{margin-bottom:3rem!important}.ml-md-5,.mx-md-5{margin-left:3rem!important}.p-md-0{padding:0!important}.pt-md-0,.py-md-0{padding-top:0!important}.pr-md-0,.px-md-0{padding-right:0!important}.pb-md-0,.py-md-0{padding-bottom:0!important}.pl-md-0,.px-md-0{padding-left:0!important}.p-md-1{padding:.25rem!important}.pt-md-1,.py-md-1{padding-top:.25rem!important}.pr-md-1,.px-md-1{padding-right:.25rem!important}.pb-md-1,.py-md-1{padding-bottom:.25rem!important}.pl-md-1,.px-md-1{padding-left:.25rem!important}.p-md-2{padding:.5rem!important}.pt-md-2,.py-md-2{padding-top:.5rem!important}.pr-md-2,.px-md-2{padding-right:.5rem!important}.pb-md-2,.py-md-2{padding-bottom:.5rem!important}.pl-md-2,.px-md-2{padding-left:.5rem!important}.p-md-3{padding:1rem!important}.pt-md-3,.py-md-3{padding-top:1rem!important}.pr-md-3,.px-md-3{padding-right:1rem!important}.pb-md-3,.py-md-3{padding-bottom:1rem!important}.pl-md-3,.px-md-3{padding-left:1rem!important}.p-md-4{padding:1.5rem!important}.pt-md-4,.py-md-4{padding-top:1.5rem!important}.pr-md-4,.px-md-4{padding-right:1.5rem!important}.pb-md-4,.py-md-4{padding-bottom:1.5rem!important}.pl-md-4,.px-md-4{padding-left:1.5rem!important}.p-md-5{padding:3rem!important}.pt-md-5,.py-md-5{padding-top:3rem!important}.pr-md-5,.px-md-5{padding-right:3rem!important}.pb-md-5,.py-md-5{padding-bottom:3rem!important}.pl-md-5,.px-md-5{padding-left:3rem!important}.m-md-n1{margin:-.25rem!important}.mt-md-n1,.my-md-n1{margin-top:-.25rem!important}.mr-md-n1,.mx-md-n1{margin-right:-.25rem!important}.mb-md-n1,.my-md-n1{margin-bottom:-.25rem!important}.ml-md-n1,.mx-md-n1{margin-left:-.25rem!important}.m-md-n2{margin:-.5rem!important}.mt-md-n2,.my-md-n2{margin-top:-.5rem!important}.mr-md-n2,.mx-md-n2{margin-right:-.5rem!important}.mb-md-n2,.my-md-n2{margin-bottom:-.5rem!important}.ml-md-n2,.mx-md-n2{margin-left:-.5rem!important}.m-md-n3{margin:-1rem!important}.mt-md-n3,.my-md-n3{margin-top:-1rem!important}.mr-md-n3,.mx-md-n3{margin-right:-1rem!important}.mb-md-n3,.my-md-n3{margin-bottom:-1rem!important}.ml-md-n3,.mx-md-n3{margin-left:-1rem!important}.m-md-n4{margin:-1.5rem!important}.mt-md-n4,.my-md-n4{margin-top:-1.5rem!important}.mr-md-n4,.mx-md-n4{margin-right:-1.5rem!important}.mb-md-n4,.my-md-n4{margin-bottom:-1.5rem!important}.ml-md-n4,.mx-md-n4{margin-left:-1.5rem!important}.m-md-n5{margin:-3rem!important}.mt-md-n5,.my-md-n5{margin-top:-3rem!important}.mr-md-n5,.mx-md-n5{margin-right:-3rem!important}.mb-md-n5,.my-md-n5{margin-bottom:-3rem!important}.ml-md-n5,.mx-md-n5{margin-left:-3rem!important}.m-md-auto{margin:auto!important}.mt-md-auto,.my-md-auto{margin-top:auto!important}.mr-md-auto,.mx-md-auto{margin-right:auto!important}.mb-md-auto,.my-md-auto{margin-bottom:auto!important}.ml-md-auto,.mx-md-auto{margin-left:auto!important}}@media (min-width:960px){.m-lg-0{margin:0!important}.mt-lg-0,.my-lg-0{margin-top:0!important}.mr-lg-0,.mx-lg-0{margin-right:0!important}.mb-lg-0,.my-lg-0{margin-bottom:0!important}.ml-lg-0,.mx-lg-0{margin-left:0!important}.m-lg-1{margin:.25rem!important}.mt-lg-1,.my-lg-1{margin-top:.25rem!important}.mr-lg-1,.mx-lg-1{margin-right:.25rem!important}.mb-lg-1,.my-lg-1{margin-bottom:.25rem!important}.ml-lg-1,.mx-lg-1{margin-left:.25rem!important}.m-lg-2{margin:.5rem!important}.mt-lg-2,.my-lg-2{margin-top:.5rem!important}.mr-lg-2,.mx-lg-2{margin-right:.5rem!important}.mb-lg-2,.my-lg-2{margin-bottom:.5rem!important}.ml-lg-2,.mx-lg-2{margin-left:.5rem!important}.m-lg-3{margin:1rem!important}.mt-lg-3,.my-lg-3{margin-top:1rem!important}.mr-lg-3,.mx-lg-3{margin-right:1rem!important}.mb-lg-3,.my-lg-3{margin-bottom:1rem!important}.ml-lg-3,.mx-lg-3{margin-left:1rem!important}.m-lg-4{margin:1.5rem!important}.mt-lg-4,.my-lg-4{margin-top:1.5rem!important}.mr-lg-4,.mx-lg-4{margin-right:1.5rem!important}.mb-lg-4,.my-lg-4{margin-bottom:1.5rem!important}.ml-lg-4,.mx-lg-4{margin-left:1.5rem!important}.m-lg-5{margin:3rem!important}.mt-lg-5,.my-lg-5{margin-top:3rem!important}.mr-lg-5,.mx-lg-5{margin-right:3rem!important}.mb-lg-5,.my-lg-5{margin-bottom:3rem!important}.ml-lg-5,.mx-lg-5{margin-left:3rem!important}.p-lg-0{padding:0!important}.pt-lg-0,.py-lg-0{padding-top:0!important}.pr-lg-0,.px-lg-0{padding-right:0!important}.pb-lg-0,.py-lg-0{padding-bottom:0!important}.pl-lg-0,.px-lg-0{padding-left:0!important}.p-lg-1{padding:.25rem!important}.pt-lg-1,.py-lg-1{padding-top:.25rem!important}.pr-lg-1,.px-lg-1{padding-right:.25rem!important}.pb-lg-1,.py-lg-1{padding-bottom:.25rem!important}.pl-lg-1,.px-lg-1{padding-left:.25rem!important}.p-lg-2{padding:.5rem!important}.pt-lg-2,.py-lg-2{padding-top:.5rem!important}.pr-lg-2,.px-lg-2{padding-right:.5rem!important}.pb-lg-2,.py-lg-2{padding-bottom:.5rem!important}.pl-lg-2,.px-lg-2{padding-left:.5rem!important}.p-lg-3{padding:1rem!important}.pt-lg-3,.py-lg-3{padding-top:1rem!important}.pr-lg-3,.px-lg-3{padding-right:1rem!important}.pb-lg-3,.py-lg-3{padding-bottom:1rem!important}.pl-lg-3,.px-lg-3{padding-left:1rem!important}.p-lg-4{padding:1.5rem!important}.pt-lg-4,.py-lg-4{padding-top:1.5rem!important}.pr-lg-4,.px-lg-4{padding-right:1.5rem!important}.pb-lg-4,.py-lg-4{padding-bottom:1.5rem!important}.pl-lg-4,.px-lg-4{padding-left:1.5rem!important}.p-lg-5{padding:3rem!important}.pt-lg-5,.py-lg-5{padding-top:3rem!important}.pr-lg-5,.px-lg-5{padding-right:3rem!important}.pb-lg-5,.py-lg-5{padding-bottom:3rem!important}.pl-lg-5,.px-lg-5{padding-left:3rem!important}.m-lg-n1{margin:-.25rem!important}.mt-lg-n1,.my-lg-n1{margin-top:-.25rem!important}.mr-lg-n1,.mx-lg-n1{margin-right:-.25rem!important}.mb-lg-n1,.my-lg-n1{margin-bottom:-.25rem!important}.ml-lg-n1,.mx-lg-n1{margin-left:-.25rem!important}.m-lg-n2{margin:-.5rem!important}.mt-lg-n2,.my-lg-n2{margin-top:-.5rem!important}.mr-lg-n2,.mx-lg-n2{margin-right:-.5rem!important}.mb-lg-n2,.my-lg-n2{margin-bottom:-.5rem!important}.ml-lg-n2,.mx-lg-n2{margin-left:-.5rem!important}.m-lg-n3{margin:-1rem!important}.mt-lg-n3,.my-lg-n3{margin-top:-1rem!important}.mr-lg-n3,.mx-lg-n3{margin-right:-1rem!important}.mb-lg-n3,.my-lg-n3{margin-bottom:-1rem!important}.ml-lg-n3,.mx-lg-n3{margin-left:-1rem!important}.m-lg-n4{margin:-1.5rem!important}.mt-lg-n4,.my-lg-n4{margin-top:-1.5rem!important}.mr-lg-n4,.mx-lg-n4{margin-right:-1.5rem!important}.mb-lg-n4,.my-lg-n4{margin-bottom:-1.5rem!important}.ml-lg-n4,.mx-lg-n4{margin-left:-1.5rem!important}.m-lg-n5{margin:-3rem!important}.mt-lg-n5,.my-lg-n5{margin-top:-3rem!important}.mr-lg-n5,.mx-lg-n5{margin-right:-3rem!important}.mb-lg-n5,.my-lg-n5{margin-bottom:-3rem!important}.ml-lg-n5,.mx-lg-n5{margin-left:-3rem!important}.m-lg-auto{margin:auto!important}.mt-lg-auto,.my-lg-auto{margin-top:auto!important}.mr-lg-auto,.mx-lg-auto{margin-right:auto!important}.mb-lg-auto,.my-lg-auto{margin-bottom:auto!important}.ml-lg-auto,.mx-lg-auto{margin-left:auto!important}}@media (min-width:1200px){.m-xl-0{margin:0!important}.mt-xl-0,.my-xl-0{margin-top:0!important}.mr-xl-0,.mx-xl-0{margin-right:0!important}.mb-xl-0,.my-xl-0{margin-bottom:0!important}.ml-xl-0,.mx-xl-0{margin-left:0!important}.m-xl-1{margin:.25rem!important}.mt-xl-1,.my-xl-1{margin-top:.25rem!important}.mr-xl-1,.mx-xl-1{margin-right:.25rem!important}.mb-xl-1,.my-xl-1{margin-bottom:.25rem!important}.ml-xl-1,.mx-xl-1{margin-left:.25rem!important}.m-xl-2{margin:.5rem!important}.mt-xl-2,.my-xl-2{margin-top:.5rem!important}.mr-xl-2,.mx-xl-2{margin-right:.5rem!important}.mb-xl-2,.my-xl-2{margin-bottom:.5rem!important}.ml-xl-2,.mx-xl-2{margin-left:.5rem!important}.m-xl-3{margin:1rem!important}.mt-xl-3,.my-xl-3{margin-top:1rem!important}.mr-xl-3,.mx-xl-3{margin-right:1rem!important}.mb-xl-3,.my-xl-3{margin-bottom:1rem!important}.ml-xl-3,.mx-xl-3{margin-left:1rem!important}.m-xl-4{margin:1.5rem!important}.mt-xl-4,.my-xl-4{margin-top:1.5rem!important}.mr-xl-4,.mx-xl-4{margin-right:1.5rem!important}.mb-xl-4,.my-xl-4{margin-bottom:1.5rem!important}.ml-xl-4,.mx-xl-4{margin-left:1.5rem!important}.m-xl-5{margin:3rem!important}.mt-xl-5,.my-xl-5{margin-top:3rem!important}.mr-xl-5,.mx-xl-5{margin-right:3rem!important}.mb-xl-5,.my-xl-5{margin-bottom:3rem!important}.ml-xl-5,.mx-xl-5{margin-left:3rem!important}.p-xl-0{padding:0!important}.pt-xl-0,.py-xl-0{padding-top:0!important}.pr-xl-0,.px-xl-0{padding-right:0!important}.pb-xl-0,.py-xl-0{padding-bottom:0!important}.pl-xl-0,.px-xl-0{padding-left:0!important}.p-xl-1{padding:.25rem!important}.pt-xl-1,.py-xl-1{padding-top:.25rem!important}.pr-xl-1,.px-xl-1{padding-right:.25rem!important}.pb-xl-1,.py-xl-1{padding-bottom:.25rem!important}.pl-xl-1,.px-xl-1{padding-left:.25rem!important}.p-xl-2{padding:.5rem!important}.pt-xl-2,.py-xl-2{padding-top:.5rem!important}.pr-xl-2,.px-xl-2{padding-right:.5rem!important}.pb-xl-2,.py-xl-2{padding-bottom:.5rem!important}.pl-xl-2,.px-xl-2{padding-left:.5rem!important}.p-xl-3{padding:1rem!important}.pt-xl-3,.py-xl-3{padding-top:1rem!important}.pr-xl-3,.px-xl-3{padding-right:1rem!important}.pb-xl-3,.py-xl-3{padding-bottom:1rem!important}.pl-xl-3,.px-xl-3{padding-left:1rem!important}.p-xl-4{padding:1.5rem!important}.pt-xl-4,.py-xl-4{padding-top:1.5rem!important}.pr-xl-4,.px-xl-4{padding-right:1.5rem!important}.pb-xl-4,.py-xl-4{padding-bottom:1.5rem!important}.pl-xl-4,.px-xl-4{padding-left:1.5rem!important}.p-xl-5{padding:3rem!important}.pt-xl-5,.py-xl-5{padding-top:3rem!important}.pr-xl-5,.px-xl-5{padding-right:3rem!important}.pb-xl-5,.py-xl-5{padding-bottom:3rem!important}.pl-xl-5,.px-xl-5{padding-left:3rem!important}.m-xl-n1{margin:-.25rem!important}.mt-xl-n1,.my-xl-n1{margin-top:-.25rem!important}.mr-xl-n1,.mx-xl-n1{margin-right:-.25rem!important}.mb-xl-n1,.my-xl-n1{margin-bottom:-.25rem!important}.ml-xl-n1,.mx-xl-n1{margin-left:-.25rem!important}.m-xl-n2{margin:-.5rem!important}.mt-xl-n2,.my-xl-n2{margin-top:-.5rem!important}.mr-xl-n2,.mx-xl-n2{margin-right:-.5rem!important}.mb-xl-n2,.my-xl-n2{margin-bottom:-.5rem!important}.ml-xl-n2,.mx-xl-n2{margin-left:-.5rem!important}.m-xl-n3{margin:-1rem!important}.mt-xl-n3,.my-xl-n3{margin-top:-1rem!important}.mr-xl-n3,.mx-xl-n3{margin-right:-1rem!important}.mb-xl-n3,.my-xl-n3{margin-bottom:-1rem!important}.ml-xl-n3,.mx-xl-n3{margin-left:-1rem!important}.m-xl-n4{margin:-1.5rem!important}.mt-xl-n4,.my-xl-n4{margin-top:-1.5rem!important}.mr-xl-n4,.mx-xl-n4{margin-right:-1.5rem!important}.mb-xl-n4,.my-xl-n4{margin-bottom:-1.5rem!important}.ml-xl-n4,.mx-xl-n4{margin-left:-1.5rem!important}.m-xl-n5{margin:-3rem!important}.mt-xl-n5,.my-xl-n5{margin-top:-3rem!important}.mr-xl-n5,.mx-xl-n5{margin-right:-3rem!important}.mb-xl-n5,.my-xl-n5{margin-bottom:-3rem!important}.ml-xl-n5,.mx-xl-n5{margin-left:-3rem!important}.m-xl-auto{margin:auto!important}.mt-xl-auto,.my-xl-auto{margin-top:auto!important}.mr-xl-auto,.mx-xl-auto{margin-right:auto!important}.mb-xl-auto,.my-xl-auto{margin-bottom:auto!important}.ml-xl-auto,.mx-xl-auto{margin-left:auto!important}}.stretched-link:after{position:absolute;top:0;right:0;bottom:0;left:0;z-index:1;pointer-events:auto;content:"";background-color:transparent}.text-monospace{font-family:SFMono-Regular,Menlo,Monaco,Consolas,Liberation Mono,Courier New,monospace!important}.text-justify{text-align:justify!important}.text-wrap{white-space:normal!important}.text-nowrap{white-space:nowrap!important}.text-truncate{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.text-left{text-align:left!important}.text-right{text-align:right!important}.text-center{text-align:center!important}@media (min-width:540px){.text-sm-left{text-align:left!important}.text-sm-right{text-align:right!important}.text-sm-center{text-align:center!important}}@media (min-width:720px){.text-md-left{text-align:left!important}.text-md-right{text-align:right!important}.text-md-center{text-align:center!important}}@media (min-width:960px){.text-lg-left{text-align:left!important}.text-lg-right{text-align:right!important}.text-lg-center{text-align:center!important}}@media (min-width:1200px){.text-xl-left{text-align:left!important}.text-xl-right{text-align:right!important}.text-xl-center{text-align:center!important}}.text-lowercase{text-transform:lowercase!important}.text-uppercase{text-transform:uppercase!important}.text-capitalize{text-transform:capitalize!important}.font-weight-light{font-weight:300!important}.font-weight-lighter{font-weight:lighter!important}.font-weight-normal{font-weight:400!important}.font-weight-bold{font-weight:700!important}.font-weight-bolder{font-weight:bolder!important}.font-italic{font-style:italic!important}.text-white{color:#fff!important}.text-primary{color:#007bff!important}a.text-primary:focus,a.text-primary:hover{color:#0056b3!important}.text-secondary{color:#6c757d!important}a.text-secondary:focus,a.text-secondary:hover{color:#494f54!important}.text-success{color:#28a745!important}a.text-success:focus,a.text-success:hover{color:#19692c!important}.text-info{color:#17a2b8!important}a.text-info:focus,a.text-info:hover{color:#0f6674!important}.text-warning{color:#ffc107!important}a.text-warning:focus,a.text-warning:hover{color:#ba8b00!important}.text-danger{color:#dc3545!important}a.text-danger:focus,a.text-danger:hover{color:#a71d2a!important}.text-light{color:#f8f9fa!important}a.text-light:focus,a.text-light:hover{color:#cbd3da!important}.text-dark{color:#343a40!important}a.text-dark:focus,a.text-dark:hover{color:#121416!important}.text-body{color:#212529!important}.text-muted{color:#6c757d!important}.text-black-50{color:rgba(0,0,0,.5)!important}.text-white-50{color:hsla(0,0%,100%,.5)!important}.text-hide{font:0/0 a;color:transparent;text-shadow:none;background-color:transparent;border:0}.text-decoration-none{text-decoration:none!important}.text-break{word-wrap:break-word!important}.text-reset{color:inherit!important}.visible{visibility:visible!important}.invisible{visibility:hidden!important}@media print{*,:after,:before{text-shadow:none!important;box-shadow:none!important}a:not(.btn){text-decoration:underline}abbr[title]:after{content:" (" attr(title) ")"}pre{white-space:pre-wrap!important}blockquote,pre{border:1px solid #adb5bd;page-break-inside:avoid}thead{display:table-header-group}img,tr{page-break-inside:avoid}h2,h3,p{orphans:3;widows:3}h2,h3{page-break-after:avoid}@page{size:a3}.container,body{min-width:960px!important}.navbar{display:none}.badge{border:1px solid #000}.table{border-collapse:collapse!important}.table td,.table th{background-color:#fff!important}.table-bordered td,.table-bordered th{border:1px solid #dee2e6!important}.table-dark{color:inherit}.table-dark tbody+tbody,.table-dark td,.table-dark th,.table-dark thead th{border-color:#dee2e6}.table .thead-dark th{color:inherit;border-color:#dee2e6}}html{font-size:var(--pst-font-size-base);scroll-padding-top:calc(var(--pst-header-height) + 12px)}body{padding-top:calc(var(--pst-header-height) + 20px);background-color:#fff;font-family:var(--pst-font-family-base);font-weight:400;line-height:1.65;color:rgba(var(--pst-color-text-base),1)}p{margin-bottom:1.15rem;font-size:1em;color:rgba(var(--pst-color-paragraph),1)}p.rubric{border-bottom:1px solid #c9c9c9}a{color:rgba(var(--pst-color-link),1);text-decoration:none}a:hover{color:rgba(var(--pst-color-link-hover),1);text-decoration:underline}a.headerlink{color:rgba(var(--pst-color-headerlink),1);font-size:.8em;padding:0 4px;text-decoration:none}a.headerlink:hover{background-color:rgba(var(--pst-color-headerlink),1);color:rgba(var(--pst-color-headerlink-hover),1)}.heading-style,h1,h2,h3,h4,h5,h6{margin:2.75rem 0 1.05rem;font-family:var(--pst-font-family-heading);font-weight:400;line-height:1.15}h1{margin-top:0;font-size:var(--pst-font-size-h1);color:rgba(var(--pst-color-h1),1)}h2{font-size:var(--pst-font-size-h2);color:rgba(var(--pst-color-h2),1)}h3{font-size:var(--pst-font-size-h3);color:rgba(var(--pst-color-h3),1)}h4{font-size:var(--pst-font-size-h4);color:rgba(var(--pst-color-h4),1)}h5{font-size:var(--pst-font-size-h5);color:rgba(var(--pst-color-h5),1)}h6{font-size:var(--pst-font-size-h6);color:rgba(var(--pst-color-h6),1)}.text_small,small{font-size:var(--pst-font-size-milli)}hr{border:0;border-top:1px solid #e5e5e5}code,kbd,pre,samp{font-family:var(--pst-font-family-monospace)}code{color:rgba(var(--pst-color-inline-code),1)}pre{margin:1.5em 0;padding:10px;background-color:rgba(var(--pst-color-preformatted-background),1);color:rgba(var(--pst-color-preformatted-text),1);line-height:1.2em;border:1px solid #c9c9c9;box-shadow:1px 1px 1px #d8d8d8}.navbar{position:fixed;min-height:var(--pst-header-height);width:100%;padding:0}.navbar .container-xl{height:100%}@media (min-width:960px){.navbar #navbar-end>.navbar-end-item{display:inline-block}}.navbar-brand{position:relative;height:var(--pst-header-height);width:auto;padding:.5rem 0}.navbar-brand img{max-width:100%;height:100%;width:auto}.navbar-light{background:#fff!important;box-shadow:0 .125rem .25rem 0 rgba(0,0,0,.11)}.navbar-light .navbar-nav li a.nav-link{padding:0 .5rem;color:rgba(var(--pst-color-navbar-link),1)}.navbar-light .navbar-nav li a.nav-link:hover{color:rgba(var(--pst-color-navbar-link-hover),1)}.navbar-light .navbar-nav>.active>.nav-link{font-weight:600;color:rgba(var(--pst-color-navbar-link-active),1)}.navbar-header a{padding:0 15px}.admonition{margin:1.5625em auto;padding:0 .6rem .8rem!important;overflow:hidden;page-break-inside:avoid;border-left:.2rem solid;border-left-color:rgba(var(--pst-color-admonition-default),1);border-bottom-color:rgba(var(--pst-color-admonition-default),1);border-right-color:rgba(var(--pst-color-admonition-default),1);border-top-color:rgba(var(--pst-color-admonition-default),1);border-radius:.1rem;box-shadow:0 .2rem .5rem rgba(0,0,0,.05),0 0 .05rem rgba(0,0,0,.1);transition:color .25s,background-color .25s,border-color .25s}.admonition :last-child{margin-bottom:0}.admonition p.admonition-title~*{padding:0 1.4rem}.admonition>ol,.admonition>ul{margin-left:1em}.admonition .admonition-title{position:relative;margin:0 -.6rem!important;padding:.4rem .6rem .4rem 2rem;font-weight:700;background-color:rgba(var(--pst-color-admonition-default),.1)}.admonition .admonition-title:before{position:absolute;left:.6rem;width:1rem;height:1rem;color:rgba(var(--pst-color-admonition-default),1);font-family:Font Awesome\ 5 Free;font-weight:900;content:var(--pst-icon-admonition-default)}.admonition .admonition-title+*{margin-top:.4em}.admonition.attention{border-color:rgba(var(--pst-color-admonition-attention),1)}.admonition.attention .admonition-title{background-color:rgba(var(--pst-color-admonition-attention),.1)}.admonition.attention .admonition-title:before{color:rgba(var(--pst-color-admonition-attention),1);content:var(--pst-icon-admonition-attention)}.admonition.caution{border-color:rgba(var(--pst-color-admonition-caution),1)}.admonition.caution .admonition-title{background-color:rgba(var(--pst-color-admonition-caution),.1)}.admonition.caution .admonition-title:before{color:rgba(var(--pst-color-admonition-caution),1);content:var(--pst-icon-admonition-caution)}.admonition.warning{border-color:rgba(var(--pst-color-admonition-warning),1)}.admonition.warning .admonition-title{background-color:rgba(var(--pst-color-admonition-warning),.1)}.admonition.warning .admonition-title:before{color:rgba(var(--pst-color-admonition-warning),1);content:var(--pst-icon-admonition-warning)}.admonition.danger{border-color:rgba(var(--pst-color-admonition-danger),1)}.admonition.danger .admonition-title{background-color:rgba(var(--pst-color-admonition-danger),.1)}.admonition.danger .admonition-title:before{color:rgba(var(--pst-color-admonition-danger),1);content:var(--pst-icon-admonition-danger)}.admonition.error{border-color:rgba(var(--pst-color-admonition-error),1)}.admonition.error .admonition-title{background-color:rgba(var(--pst-color-admonition-error),.1)}.admonition.error .admonition-title:before{color:rgba(var(--pst-color-admonition-error),1);content:var(--pst-icon-admonition-error)}.admonition.hint{border-color:rgba(var(--pst-color-admonition-hint),1)}.admonition.hint .admonition-title{background-color:rgba(var(--pst-color-admonition-hint),.1)}.admonition.hint .admonition-title:before{color:rgba(var(--pst-color-admonition-hint),1);content:var(--pst-icon-admonition-hint)}.admonition.tip{border-color:rgba(var(--pst-color-admonition-tip),1)}.admonition.tip .admonition-title{background-color:rgba(var(--pst-color-admonition-tip),.1)}.admonition.tip .admonition-title:before{color:rgba(var(--pst-color-admonition-tip),1);content:var(--pst-icon-admonition-tip)}.admonition.important{border-color:rgba(var(--pst-color-admonition-important),1)}.admonition.important .admonition-title{background-color:rgba(var(--pst-color-admonition-important),.1)}.admonition.important .admonition-title:before{color:rgba(var(--pst-color-admonition-important),1);content:var(--pst-icon-admonition-important)}.admonition.note{border-color:rgba(var(--pst-color-admonition-note),1)}.admonition.note .admonition-title{background-color:rgba(var(--pst-color-admonition-note),.1)}.admonition.note .admonition-title:before{color:rgba(var(--pst-color-admonition-note),1);content:var(--pst-icon-admonition-note)}div.deprecated{margin-bottom:10px;margin-top:10px;padding:7px;background-color:#f3e5e5;border:1px solid #eed3d7;border-radius:.5rem}div.deprecated p{color:#b94a48;display:inline}.topic{background-color:#eee}.seealso dd{margin-top:0;margin-bottom:0}.viewcode-back{font-family:var(--pst-font-family-base)}.viewcode-block:target{background-color:#f4debf;border-top:1px solid #ac9;border-bottom:1px solid #ac9}span.guilabel{border:1px solid #7fbbe3;background:#e7f2fa;font-size:80%;font-weight:700;border-radius:4px;padding:2.4px 6px;margin:auto 2px}table.field-list{border-collapse:separate;border-spacing:10px;margin-left:1px}table.field-list th.field-name{padding:1px 8px 1px 5px;white-space:nowrap;background-color:#eee}table.field-list td.field-body p{font-style:italic}table.field-list td.field-body p>strong{font-style:normal}table.field-list td.field-body blockquote{border-left:none;margin:0 0 .3em;padding-left:30px}.table.autosummary td:first-child{white-space:nowrap}footer{width:100%;border-top:1px solid #ccc;padding:10px}footer .footer-item p{margin-bottom:0}.bd-search{position:relative;padding:1rem 15px;margin-right:-15px;margin-left:-15px}.bd-search .icon{position:absolute;color:#a4a6a7;left:25px;top:25px}.bd-search input{border-radius:0;border:0;border-bottom:1px solid #e5e5e5;padding-left:35px}.bd-toc{-ms-flex-order:2;order:2;height:calc(100vh - 2rem);overflow-y:auto}@supports (position:-webkit-sticky) or (position:sticky){.bd-toc{position:-webkit-sticky;position:sticky;top:calc(var(--pst-header-height) + 20px);height:calc(100vh - 5rem);overflow-y:auto}}.bd-toc .onthispage{color:#a4a6a7}.section-nav{padding-left:0;border-left:1px solid #eee;border-bottom:none}.section-nav ul{padding-left:1rem}.toc-entry,.toc-entry a{display:block}.toc-entry a{padding:.125rem 1.5rem;color:rgba(var(--pst-color-toc-link),1)}@media (min-width:1200px){.toc-entry a{padding-right:0}}.toc-entry a:hover{color:rgba(var(--pst-color-toc-link-hover),1);text-decoration:none}.bd-sidebar{padding-top:1em}@media (min-width:720px){.bd-sidebar{border-right:1px solid rgba(0,0,0,.1)}@supports (position:-webkit-sticky) or (position:sticky){.bd-sidebar{position:-webkit-sticky;position:sticky;top:calc(var(--pst-header-height) + 20px);z-index:1000;height:calc(100vh - var(--pst-header-height) - 20px)}}}.bd-sidebar.no-sidebar{border-right:0}.bd-links{padding-top:1rem;padding-bottom:1rem;margin-right:-15px;margin-left:-15px}@media (min-width:720px){.bd-links{display:block!important}@supports (position:-webkit-sticky) or (position:sticky){.bd-links{max-height:calc(100vh - 11rem);overflow-y:auto}}}.bd-sidenav{display:none}.bd-content{padding-top:20px}.bd-content .section{max-width:100%}.bd-content .section table{display:block;overflow:auto}.bd-toc-link{display:block;padding:.25rem 1.5rem;font-weight:600;color:rgba(0,0,0,.65)}.bd-toc-link:hover{color:rgba(0,0,0,.85);text-decoration:none}.bd-toc-item.active{margin-bottom:1rem}.bd-toc-item.active:not(:first-child){margin-top:1rem}.bd-toc-item.active>.bd-toc-link{color:rgba(0,0,0,.85)}.bd-toc-item.active>.bd-toc-link:hover{background-color:transparent}.bd-toc-item.active>.bd-sidenav{display:block}nav.bd-links p.caption{font-size:var(--pst-sidebar-caption-font-size);text-transform:uppercase;font-weight:700;position:relative;margin-top:1.25em;margin-bottom:.5em;padding:0 1.5rem;color:rgba(var(--pst-color-sidebar-caption),1)}nav.bd-links p.caption:first-child{margin-top:0}.bd-sidebar .nav{font-size:var(--pst-sidebar-font-size)}.bd-sidebar .nav ul{list-style:none;padding:0 0 0 1.5rem}.bd-sidebar .nav li>a{display:block;padding:.25rem 1.5rem;color:rgba(var(--pst-color-sidebar-link),1)}.bd-sidebar .nav li>a:hover{color:rgba(var(--pst-color-sidebar-link-hover),1);text-decoration:none;background-color:transparent}.bd-sidebar .nav li>a.reference.external:after{font-family:Font Awesome\ 5 Free;font-weight:900;content:"\f35d";font-size:.75em;margin-left:.3em}.bd-sidebar .nav .active:hover>a,.bd-sidebar .nav .active>a{font-weight:600;color:rgba(var(--pst-color-sidebar-link-active),1)}.toc-h2{font-size:.85rem}.toc-h3{font-size:.75rem}.toc-h4{font-size:.65rem}.toc-entry>.nav-link.active{font-weight:600;color:#130654;color:rgba(var(--pst-color-toc-link-active),1);background-color:transparent;border-left:2px solid rgba(var(--pst-color-toc-link-active),1)}.nav-link:hover{border-style:none}#navbar-main-elements li.nav-item i{font-size:.7rem;padding-left:2px;vertical-align:middle}.bd-toc .nav .nav{display:none}.bd-toc .nav .nav.visible,.bd-toc .nav>.active>ul{display:block}.prev-next-bottom{margin:20px 0}.prev-next-bottom a.left-prev,.prev-next-bottom a.right-next{padding:10px;border:1px solid rgba(0,0,0,.2);max-width:45%;overflow-x:hidden;color:rgba(0,0,0,.65)}.prev-next-bottom a.left-prev{float:left}.prev-next-bottom a.left-prev:before{content:"<< "}.prev-next-bottom a.right-next{float:right}.prev-next-bottom a.right-next:after{content:" >>"}.alert{padding-bottom:0}.alert-info a{color:#e83e8c}#navbar-icon-links i.fa,#navbar-icon-links i.fab,#navbar-icon-links i.far,#navbar-icon-links i.fas{vertical-align:middle;font-style:normal;font-size:1.5rem;line-height:1.25}#navbar-icon-links i.fa-github-square:before{color:#333}#navbar-icon-links i.fa-twitter-square:before{color:#55acee}#navbar-icon-links i.fa-gitlab:before{color:#548}#navbar-icon-links i.fa-bitbucket:before{color:#0052cc}.tocsection{border-left:1px solid #eee;padding:.3rem 1.5rem}.tocsection i{padding-right:.5rem}.editthispage{padding-top:2rem}.editthispage a{color:#130754}.xr-wrap[hidden]{display:block!important}.toctree-checkbox{position:absolute;display:none}.toctree-checkbox~ul{display:none}.toctree-checkbox~label i{transform:rotate(0deg)}.toctree-checkbox:checked~ul{display:block}.toctree-checkbox:checked~label i{transform:rotate(180deg)}.bd-sidebar li{position:relative}.bd-sidebar label{position:absolute;top:0;right:0;height:30px;width:30px;cursor:pointer;display:flex;justify-content:center;align-items:center}.bd-sidebar label:hover{background:rgba(var(--pst-color-sidebar-expander-background-hover),1)}.bd-sidebar label i{display:inline-block;font-size:.75rem;text-align:center}.bd-sidebar label i:hover{color:rgba(var(--pst-color-sidebar-link-hover),1)}.bd-sidebar li.has-children>.reference{padding-right:30px}div.doctest>div.highlight span.gp,span.linenos,table.highlighttable td.linenos{user-select:none!important;-webkit-user-select:text!important;-webkit-user-select:none!important;-moz-user-select:none!important;-ms-user-select:none!important} \ No newline at end of file diff --git a/doc/LectureNotes/_build/html/_static/css/theme.css b/doc/LectureNotes/_build/html/_static/css/theme.css deleted file mode 100644 index 3f6e79dab..000000000 --- a/doc/LectureNotes/_build/html/_static/css/theme.css +++ /dev/null @@ -1,117 +0,0 @@ -:root { - /***************************************************************************** - * Theme config - **/ - --pst-header-height: 60px; - - /***************************************************************************** - * Font size - **/ - --pst-font-size-base: 15px; /* base font size - applied at body / html level */ - - /* heading font sizes */ - --pst-font-size-h1: 36px; - --pst-font-size-h2: 32px; - --pst-font-size-h3: 26px; - --pst-font-size-h4: 21px; - --pst-font-size-h5: 18px; - --pst-font-size-h6: 16px; - - /* smaller then heading font sizes*/ - --pst-font-size-milli: 12px; - - --pst-sidebar-font-size: .9em; - --pst-sidebar-caption-font-size: .9em; - - /***************************************************************************** - * Font family - **/ - /* These are adapted from https://systemfontstack.com/ */ - --pst-font-family-base-system: -apple-system, BlinkMacSystemFont, Segoe UI, "Helvetica Neue", - Arial, sans-serif, Apple Color Emoji, Segoe UI Emoji, Segoe UI Symbol; - --pst-font-family-monospace-system: "SFMono-Regular", Menlo, Consolas, Monaco, - Liberation Mono, Lucida Console, monospace; - - --pst-font-family-base: var(--pst-font-family-base-system); - --pst-font-family-heading: var(--pst-font-family-base); - --pst-font-family-monospace: var(--pst-font-family-monospace-system); - - /***************************************************************************** - * Color - * - * Colors are defined in rgb string way, "red, green, blue" - **/ - --pst-color-primary: 19, 6, 84; - --pst-color-success: 40, 167, 69; - --pst-color-info: 0, 123, 255; /*23, 162, 184;*/ - --pst-color-warning: 255, 193, 7; - --pst-color-danger: 220, 53, 69; - --pst-color-text-base: 51, 51, 51; - - --pst-color-h1: var(--pst-color-primary); - --pst-color-h2: var(--pst-color-primary); - --pst-color-h3: var(--pst-color-text-base); - --pst-color-h4: var(--pst-color-text-base); - --pst-color-h5: var(--pst-color-text-base); - --pst-color-h6: var(--pst-color-text-base); - --pst-color-paragraph: var(--pst-color-text-base); - --pst-color-link: 0, 91, 129; - --pst-color-link-hover: 227, 46, 0; - --pst-color-headerlink: 198, 15, 15; - --pst-color-headerlink-hover: 255, 255, 255; - --pst-color-preformatted-text: 34, 34, 34; - --pst-color-preformatted-background: 250, 250, 250; - --pst-color-inline-code: 232, 62, 140; - - --pst-color-active-navigation: 19, 6, 84; - --pst-color-navbar-link: 77, 77, 77; - --pst-color-navbar-link-hover: var(--pst-color-active-navigation); - --pst-color-navbar-link-active: var(--pst-color-active-navigation); - --pst-color-sidebar-link: 77, 77, 77; - --pst-color-sidebar-link-hover: var(--pst-color-active-navigation); - --pst-color-sidebar-link-active: var(--pst-color-active-navigation); - --pst-color-sidebar-expander-background-hover: 244, 244, 244; - --pst-color-sidebar-caption: 77, 77, 77; - --pst-color-toc-link: 119, 117, 122; - --pst-color-toc-link-hover: var(--pst-color-active-navigation); - --pst-color-toc-link-active: var(--pst-color-active-navigation); - - /***************************************************************************** - * Icon - **/ - - /* font awesome icons*/ - --pst-icon-check-circle: '\f058'; - --pst-icon-info-circle: '\f05a'; - --pst-icon-exclamation-triangle: '\f071'; - --pst-icon-exclamation-circle: '\f06a'; - --pst-icon-times-circle: '\f057'; - --pst-icon-lightbulb: '\f0eb'; - - /***************************************************************************** - * Admonitions - **/ - - --pst-color-admonition-default: var(--pst-color-info); - --pst-color-admonition-note: var(--pst-color-info); - --pst-color-admonition-attention: var(--pst-color-warning); - --pst-color-admonition-caution: var(--pst-color-warning); - --pst-color-admonition-warning: var(--pst-color-warning); - --pst-color-admonition-danger: var(--pst-color-danger); - --pst-color-admonition-error: var(--pst-color-danger); - --pst-color-admonition-hint: var(--pst-color-success); - --pst-color-admonition-tip: var(--pst-color-success); - --pst-color-admonition-important: var(--pst-color-success); - - --pst-icon-admonition-default: var(--pst-icon-info-circle); - --pst-icon-admonition-note: var(--pst-icon-info-circle); - --pst-icon-admonition-attention: var(--pst-icon-exclamation-circle); - --pst-icon-admonition-caution: var(--pst-icon-exclamation-triangle); - --pst-icon-admonition-warning: var(--pst-icon-exclamation-triangle); - --pst-icon-admonition-danger: var(--pst-icon-exclamation-triangle); - --pst-icon-admonition-error: var(--pst-icon-times-circle); - --pst-icon-admonition-hint: var(--pst-icon-lightbulb); - --pst-icon-admonition-tip: var(--pst-icon-lightbulb); - --pst-icon-admonition-important: var(--pst-icon-exclamation-circle); - -} diff --git a/doc/LectureNotes/_build/html/_static/doctools.js b/doc/LectureNotes/_build/html/_static/doctools.js deleted file mode 100644 index 7d88f807d..000000000 --- a/doc/LectureNotes/_build/html/_static/doctools.js +++ /dev/null @@ -1,316 +0,0 @@ -/* - * doctools.js - * ~~~~~~~~~~~ - * - * Sphinx JavaScript utilities for all documentation. - * - * :copyright: Copyright 2007-2020 by the Sphinx team, see AUTHORS. - * :license: BSD, see LICENSE for details. - * - */ - -/** - * select a different prefix for underscore - */ -$u = _.noConflict(); - -/** - * make the code below compatible with browsers without - * an installed firebug like debugger -if (!window.console || !console.firebug) { - var names = ["log", "debug", "info", "warn", "error", "assert", "dir", - "dirxml", "group", "groupEnd", "time", "timeEnd", "count", "trace", - "profile", "profileEnd"]; - window.console = {}; - for (var i = 0; i < names.length; ++i) - window.console[names[i]] = function() {}; -} - */ - -/** - * small helper function to urldecode strings - */ -jQuery.urldecode = function(x) { - return decodeURIComponent(x).replace(/\+/g, ' '); -}; - -/** - * small helper function to urlencode strings - */ -jQuery.urlencode = encodeURIComponent; - -/** - * This function returns the parsed url parameters of the - * current request. Multiple values per key are supported, - * it will always return arrays of strings for the value parts. - */ -jQuery.getQueryParameters = function(s) { - if (typeof s === 'undefined') - s = document.location.search; - var parts = s.substr(s.indexOf('?') + 1).split('&'); - var result = {}; - for (var i = 0; i < parts.length; i++) { - var tmp = parts[i].split('=', 2); - var key = jQuery.urldecode(tmp[0]); - var value = jQuery.urldecode(tmp[1]); - if (key in result) - result[key].push(value); - else - result[key] = [value]; - } - return result; -}; - -/** - * highlight a given string on a jquery object by wrapping it in - * span elements with the given class name. - */ -jQuery.fn.highlightText = function(text, className) { - function highlight(node, addItems) { - if (node.nodeType === 3) { - var val = node.nodeValue; - var pos = val.toLowerCase().indexOf(text); - if (pos >= 0 && - !jQuery(node.parentNode).hasClass(className) && - !jQuery(node.parentNode).hasClass("nohighlight")) { - var span; - var isInSVG = jQuery(node).closest("body, svg, foreignObject").is("svg"); - if (isInSVG) { - span = document.createElementNS("http://www.w3.org/2000/svg", "tspan"); - } else { - span = document.createElement("span"); - span.className = className; - } - span.appendChild(document.createTextNode(val.substr(pos, text.length))); - node.parentNode.insertBefore(span, node.parentNode.insertBefore( - document.createTextNode(val.substr(pos + text.length)), - node.nextSibling)); - node.nodeValue = val.substr(0, pos); - if (isInSVG) { - var rect = document.createElementNS("http://www.w3.org/2000/svg", "rect"); - var bbox = node.parentElement.getBBox(); - rect.x.baseVal.value = bbox.x; - rect.y.baseVal.value = bbox.y; - rect.width.baseVal.value = bbox.width; - rect.height.baseVal.value = bbox.height; - rect.setAttribute('class', className); - addItems.push({ - "parent": node.parentNode, - "target": rect}); - } - } - } - else if (!jQuery(node).is("button, select, textarea")) { - jQuery.each(node.childNodes, function() { - highlight(this, addItems); - }); - } - } - var addItems = []; - var result = this.each(function() { - highlight(this, addItems); - }); - for (var i = 0; i < addItems.length; ++i) { - jQuery(addItems[i].parent).before(addItems[i].target); - } - return result; -}; - -/* - * backward compatibility for jQuery.browser - * This will be supported until firefox bug is fixed. - */ -if (!jQuery.browser) { - jQuery.uaMatch = function(ua) { - ua = ua.toLowerCase(); - - var match = /(chrome)[ \/]([\w.]+)/.exec(ua) || - /(webkit)[ \/]([\w.]+)/.exec(ua) || - /(opera)(?:.*version|)[ \/]([\w.]+)/.exec(ua) || - /(msie) ([\w.]+)/.exec(ua) || - ua.indexOf("compatible") < 0 && /(mozilla)(?:.*? rv:([\w.]+)|)/.exec(ua) || - []; - - return { - browser: match[ 1 ] || "", - version: match[ 2 ] || "0" - }; - }; - jQuery.browser = {}; - jQuery.browser[jQuery.uaMatch(navigator.userAgent).browser] = true; -} - -/** - * Small JavaScript module for the documentation. - */ -var Documentation = { - - init : function() { - this.fixFirefoxAnchorBug(); - this.highlightSearchWords(); - this.initIndexTable(); - if (DOCUMENTATION_OPTIONS.NAVIGATION_WITH_KEYS) { - this.initOnKeyListeners(); - } - }, - - /** - * i18n support - */ - TRANSLATIONS : {}, - PLURAL_EXPR : function(n) { return n === 1 ? 0 : 1; }, - LOCALE : 'unknown', - - // gettext and ngettext don't access this so that the functions - // can safely bound to a different name (_ = Documentation.gettext) - gettext : function(string) { - var translated = Documentation.TRANSLATIONS[string]; - if (typeof translated === 'undefined') - return string; - return (typeof translated === 'string') ? translated : translated[0]; - }, - - ngettext : function(singular, plural, n) { - var translated = Documentation.TRANSLATIONS[singular]; - if (typeof translated === 'undefined') - return (n == 1) ? singular : plural; - return translated[Documentation.PLURALEXPR(n)]; - }, - - addTranslations : function(catalog) { - for (var key in catalog.messages) - this.TRANSLATIONS[key] = catalog.messages[key]; - this.PLURAL_EXPR = new Function('n', 'return +(' + catalog.plural_expr + ')'); - this.LOCALE = catalog.locale; - }, - - /** - * add context elements like header anchor links - */ - addContextElements : function() { - $('div[id] > :header:first').each(function() { - $('\u00B6'). - attr('href', '#' + this.id). - attr('title', _('Permalink to this headline')). - appendTo(this); - }); - $('dt[id]').each(function() { - $('\u00B6'). - attr('href', '#' + this.id). - attr('title', _('Permalink to this definition')). - appendTo(this); - }); - }, - - /** - * workaround a firefox stupidity - * see: https://bugzilla.mozilla.org/show_bug.cgi?id=645075 - */ - fixFirefoxAnchorBug : function() { - if (document.location.hash && $.browser.mozilla) - window.setTimeout(function() { - document.location.href += ''; - }, 10); - }, - - /** - * highlight the search words provided in the url in the text - */ - highlightSearchWords : function() { - var params = $.getQueryParameters(); - var terms = (params.highlight) ? params.highlight[0].split(/\s+/) : []; - if (terms.length) { - var body = $('div.body'); - if (!body.length) { - body = $('body'); - } - window.setTimeout(function() { - $.each(terms, function() { - body.highlightText(this.toLowerCase(), 'highlighted'); - }); - }, 10); - $('') - .appendTo($('#searchbox')); - } - }, - - /** - * init the domain index toggle buttons - */ - initIndexTable : function() { - var togglers = $('img.toggler').click(function() { - var src = $(this).attr('src'); - var idnum = $(this).attr('id').substr(7); - $('tr.cg-' + idnum).toggle(); - if (src.substr(-9) === 'minus.png') - $(this).attr('src', src.substr(0, src.length-9) + 'plus.png'); - else - $(this).attr('src', src.substr(0, src.length-8) + 'minus.png'); - }).css('display', ''); - if (DOCUMENTATION_OPTIONS.COLLAPSE_INDEX) { - togglers.click(); - } - }, - - /** - * helper function to hide the search marks again - */ - hideSearchWords : function() { - $('#searchbox .highlight-link').fadeOut(300); - $('span.highlighted').removeClass('highlighted'); - }, - - /** - * make the url absolute - */ - makeURL : function(relativeURL) { - return DOCUMENTATION_OPTIONS.URL_ROOT + '/' + relativeURL; - }, - - /** - * get the current relative url - */ - getCurrentURL : function() { - var path = document.location.pathname; - var parts = path.split(/\//); - $.each(DOCUMENTATION_OPTIONS.URL_ROOT.split(/\//), function() { - if (this === '..') - parts.pop(); - }); - var url = parts.join('/'); - return path.substring(url.lastIndexOf('/') + 1, path.length - 1); - }, - - initOnKeyListeners: function() { - $(document).keydown(function(event) { - var activeElementType = document.activeElement.tagName; - // don't navigate when in search box, textarea, dropdown or button - if (activeElementType !== 'TEXTAREA' && activeElementType !== 'INPUT' && activeElementType !== 'SELECT' - && activeElementType !== 'BUTTON' && !event.altKey && !event.ctrlKey && !event.metaKey - && !event.shiftKey) { - switch (event.keyCode) { - case 37: // left - var prevHref = $('link[rel="prev"]').prop('href'); - if (prevHref) { - window.location.href = prevHref; - return false; - } - case 39: // right - var nextHref = $('link[rel="next"]').prop('href'); - if (nextHref) { - window.location.href = nextHref; - return false; - } - } - } - }); - } -}; - -// quick alias for translations -_ = Documentation.gettext; - -$(document).ready(function() { - Documentation.init(); -}); diff --git a/doc/LectureNotes/_build/html/_static/documentation_options.js b/doc/LectureNotes/_build/html/_static/documentation_options.js deleted file mode 100644 index 93b7c24d6..000000000 --- a/doc/LectureNotes/_build/html/_static/documentation_options.js +++ /dev/null @@ -1,12 +0,0 @@ -var DOCUMENTATION_OPTIONS = { - URL_ROOT: document.getElementById("documentation_options").getAttribute('data-url_root'), - VERSION: '', - LANGUAGE: 'None', - COLLAPSE_INDEX: false, - BUILDER: 'html', - FILE_SUFFIX: '.html', - LINK_SUFFIX: '.html', - HAS_SOURCE: true, - SOURCELINK_SUFFIX: '', - NAVIGATION_WITH_KEYS: true -}; \ No newline at end of file diff --git a/doc/LectureNotes/_build/html/_static/file.png b/doc/LectureNotes/_build/html/_static/file.png deleted file mode 100644 index a858a410e..000000000 Binary files a/doc/LectureNotes/_build/html/_static/file.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_static/images/logo_binder.svg b/doc/LectureNotes/_build/html/_static/images/logo_binder.svg deleted file mode 100644 index 45fecf751..000000000 --- a/doc/LectureNotes/_build/html/_static/images/logo_binder.svg +++ /dev/null @@ -1,19 +0,0 @@ - - - - -logo - - - - - - - - diff --git a/doc/LectureNotes/_build/html/_static/images/logo_colab.png b/doc/LectureNotes/_build/html/_static/images/logo_colab.png deleted file mode 100644 index b7560ec21..000000000 Binary files a/doc/LectureNotes/_build/html/_static/images/logo_colab.png and /dev/null differ diff --git a/doc/LectureNotes/_build/html/_static/images/logo_jupyterhub.svg b/doc/LectureNotes/_build/html/_static/images/logo_jupyterhub.svg deleted file mode 100644 index 60cfe9f22..000000000 --- a/doc/LectureNotes/_build/html/_static/images/logo_jupyterhub.svg +++ /dev/null @@ -1 +0,0 @@ -logo_jupyterhubHub diff --git a/doc/LectureNotes/_build/html/_static/jquery-3.5.1.js b/doc/LectureNotes/_build/html/_static/jquery-3.5.1.js deleted file mode 100644 index 50937333b..000000000 --- a/doc/LectureNotes/_build/html/_static/jquery-3.5.1.js +++ /dev/null @@ -1,10872 +0,0 @@ -/*! - * jQuery JavaScript Library v3.5.1 - * https://jquery.com/ - * - * Includes Sizzle.js - * https://sizzlejs.com/ - * - * Copyright JS Foundation and other contributors - * Released under the MIT license - * https://jquery.org/license - * - * Date: 2020-05-04T22:49Z - */ -( function( global, factory ) { - - "use strict"; - - if ( typeof module === "object" && typeof module.exports === "object" ) { - - // For CommonJS and CommonJS-like environments where a proper `window` - // is present, execute the factory and get jQuery. - // For environments that do not have a `window` with a `document` - // (such as Node.js), expose a factory as module.exports. - // This accentuates the need for the creation of a real `window`. - // e.g. var jQuery = require("jquery")(window); - // See ticket #14549 for more info. - module.exports = global.document ? - factory( global, true ) : - function( w ) { - if ( !w.document ) { - throw new Error( "jQuery requires a window with a document" ); - } - return factory( w ); - }; - } else { - factory( global ); - } - -// Pass this if window is not defined yet -} )( typeof window !== "undefined" ? window : this, function( window, noGlobal ) { - -// Edge <= 12 - 13+, Firefox <=18 - 45+, IE 10 - 11, Safari 5.1 - 9+, iOS 6 - 9.1 -// throw exceptions when non-strict code (e.g., ASP.NET 4.5) accesses strict mode -// arguments.callee.caller (trac-13335). But as of jQuery 3.0 (2016), strict mode should be common -// enough that all such attempts are guarded in a try block. -"use strict"; - -var arr = []; - -var getProto = Object.getPrototypeOf; - -var slice = arr.slice; - -var flat = arr.flat ? function( array ) { - return arr.flat.call( array ); -} : function( array ) { - return arr.concat.apply( [], array ); -}; - - -var push = arr.push; - -var indexOf = arr.indexOf; - -var class2type = {}; - -var toString = class2type.toString; - -var hasOwn = class2type.hasOwnProperty; - -var fnToString = hasOwn.toString; - -var ObjectFunctionString = fnToString.call( Object ); - -var support = {}; - -var isFunction = function isFunction( obj ) { - - // Support: Chrome <=57, Firefox <=52 - // In some browsers, typeof returns "function" for HTML elements - // (i.e., `typeof document.createElement( "object" ) === "function"`). - // We don't want to classify *any* DOM node as a function. - return typeof obj === "function" && typeof obj.nodeType !== "number"; - }; - - -var isWindow = function isWindow( obj ) { - return obj != null && obj === obj.window; - }; - - -var document = window.document; - - - - var preservedScriptAttributes = { - type: true, - src: true, - nonce: true, - noModule: true - }; - - function DOMEval( code, node, doc ) { - doc = doc || document; - - var i, val, - script = doc.createElement( "script" ); - - script.text = code; - if ( node ) { - for ( i in preservedScriptAttributes ) { - - // Support: Firefox 64+, Edge 18+ - // Some browsers don't support the "nonce" property on scripts. - // On the other hand, just using `getAttribute` is not enough as - // the `nonce` attribute is reset to an empty string whenever it - // becomes browsing-context connected. - // See https://github.com/whatwg/html/issues/2369 - // See https://html.spec.whatwg.org/#nonce-attributes - // The `node.getAttribute` check was added for the sake of - // `jQuery.globalEval` so that it can fake a nonce-containing node - // via an object. - val = node[ i ] || node.getAttribute && node.getAttribute( i ); - if ( val ) { - script.setAttribute( i, val ); - } - } - } - doc.head.appendChild( script ).parentNode.removeChild( script ); - } - - -function toType( obj ) { - if ( obj == null ) { - return obj + ""; - } - - // Support: Android <=2.3 only (functionish RegExp) - return typeof obj === "object" || typeof obj === "function" ? - class2type[ toString.call( obj ) ] || "object" : - typeof obj; -} -/* global Symbol */ -// Defining this global in .eslintrc.json would create a danger of using the global -// unguarded in another place, it seems safer to define global only for this module - - - -var - version = "3.5.1", - - // Define a local copy of jQuery - jQuery = function( selector, context ) { - - // The jQuery object is actually just the init constructor 'enhanced' - // Need init if jQuery is called (just allow error to be thrown if not included) - return new jQuery.fn.init( selector, context ); - }; - -jQuery.fn = jQuery.prototype = { - - // The current version of jQuery being used - jquery: version, - - constructor: jQuery, - - // The default length of a jQuery object is 0 - length: 0, - - toArray: function() { - return slice.call( this ); - }, - - // Get the Nth element in the matched element set OR - // Get the whole matched element set as a clean array - get: function( num ) { - - // Return all the elements in a clean array - if ( num == null ) { - return slice.call( this ); - } - - // Return just the one element from the set - return num < 0 ? this[ num + this.length ] : this[ num ]; - }, - - // Take an array of elements and push it onto the stack - // (returning the new matched element set) - pushStack: function( elems ) { - - // Build a new jQuery matched element set - var ret = jQuery.merge( this.constructor(), elems ); - - // Add the old object onto the stack (as a reference) - ret.prevObject = this; - - // Return the newly-formed element set - return ret; - }, - - // Execute a callback for every element in the matched set. - each: function( callback ) { - return jQuery.each( this, callback ); - }, - - map: function( callback ) { - return this.pushStack( jQuery.map( this, function( elem, i ) { - return callback.call( elem, i, elem ); - } ) ); - }, - - slice: function() { - return this.pushStack( slice.apply( this, arguments ) ); - }, - - first: function() { - return this.eq( 0 ); - }, - - last: function() { - return this.eq( -1 ); - }, - - even: function() { - return this.pushStack( jQuery.grep( this, function( _elem, i ) { - return ( i + 1 ) % 2; - } ) ); - }, - - odd: function() { - return this.pushStack( jQuery.grep( this, function( _elem, i ) { - return i % 2; - } ) ); - }, - - eq: function( i ) { - var len = this.length, - j = +i + ( i < 0 ? len : 0 ); - return this.pushStack( j >= 0 && j < len ? [ this[ j ] ] : [] ); - }, - - end: function() { - return this.prevObject || this.constructor(); - }, - - // For internal use only. - // Behaves like an Array's method, not like a jQuery method. - push: push, - sort: arr.sort, - splice: arr.splice -}; - -jQuery.extend = jQuery.fn.extend = function() { - var options, name, src, copy, copyIsArray, clone, - target = arguments[ 0 ] || {}, - i = 1, - length = arguments.length, - deep = false; - - // Handle a deep copy situation - if ( typeof target === "boolean" ) { - deep = target; - - // Skip the boolean and the target - target = arguments[ i ] || {}; - i++; - } - - // Handle case when target is a string or something (possible in deep copy) - if ( typeof target !== "object" && !isFunction( target ) ) { - target = {}; - } - - // Extend jQuery itself if only one argument is passed - if ( i === length ) { - target = this; - i--; - } - - for ( ; i < length; i++ ) { - - // Only deal with non-null/undefined values - if ( ( options = arguments[ i ] ) != null ) { - - // Extend the base object - for ( name in options ) { - copy = options[ name ]; - - // Prevent Object.prototype pollution - // Prevent never-ending loop - if ( name === "__proto__" || target === copy ) { - continue; - } - - // Recurse if we're merging plain objects or arrays - if ( deep && copy && ( jQuery.isPlainObject( copy ) || - ( copyIsArray = Array.isArray( copy ) ) ) ) { - src = target[ name ]; - - // Ensure proper type for the source value - if ( copyIsArray && !Array.isArray( src ) ) { - clone = []; - } else if ( !copyIsArray && !jQuery.isPlainObject( src ) ) { - clone = {}; - } else { - clone = src; - } - copyIsArray = false; - - // Never move original objects, clone them - target[ name ] = jQuery.extend( deep, clone, copy ); - - // Don't bring in undefined values - } else if ( copy !== undefined ) { - target[ name ] = copy; - } - } - } - } - - // Return the modified object - return target; -}; - -jQuery.extend( { - - // Unique for each copy of jQuery on the page - expando: "jQuery" + ( version + Math.random() ).replace( /\D/g, "" ), - - // Assume jQuery is ready without the ready module - isReady: true, - - error: function( msg ) { - throw new Error( msg ); - }, - - noop: function() {}, - - isPlainObject: function( obj ) { - var proto, Ctor; - - // Detect obvious negatives - // Use toString instead of jQuery.type to catch host objects - if ( !obj || toString.call( obj ) !== "[object Object]" ) { - return false; - } - - proto = getProto( obj ); - - // Objects with no prototype (e.g., `Object.create( null )`) are plain - if ( !proto ) { - return true; - } - - // Objects with prototype are plain iff they were constructed by a global Object function - Ctor = hasOwn.call( proto, "constructor" ) && proto.constructor; - return typeof Ctor === "function" && fnToString.call( Ctor ) === ObjectFunctionString; - }, - - isEmptyObject: function( obj ) { - var name; - - for ( name in obj ) { - return false; - } - return true; - }, - - // Evaluates a script in a provided context; falls back to the global one - // if not specified. - globalEval: function( code, options, doc ) { - DOMEval( code, { nonce: options && options.nonce }, doc ); - }, - - each: function( obj, callback ) { - var length, i = 0; - - if ( isArrayLike( obj ) ) { - length = obj.length; - for ( ; i < length; i++ ) { - if ( callback.call( obj[ i ], i, obj[ i ] ) === false ) { - break; - } - } - } else { - for ( i in obj ) { - if ( callback.call( obj[ i ], i, obj[ i ] ) === false ) { - break; - } - } - } - - return obj; - }, - - // results is for internal usage only - makeArray: function( arr, results ) { - var ret = results || []; - - if ( arr != null ) { - if ( isArrayLike( Object( arr ) ) ) { - jQuery.merge( ret, - typeof arr === "string" ? - [ arr ] : arr - ); - } else { - push.call( ret, arr ); - } - } - - return ret; - }, - - inArray: function( elem, arr, i ) { - return arr == null ? -1 : indexOf.call( arr, elem, i ); - }, - - // Support: Android <=4.0 only, PhantomJS 1 only - // push.apply(_, arraylike) throws on ancient WebKit - merge: function( first, second ) { - var len = +second.length, - j = 0, - i = first.length; - - for ( ; j < len; j++ ) { - first[ i++ ] = second[ j ]; - } - - first.length = i; - - return first; - }, - - grep: function( elems, callback, invert ) { - var callbackInverse, - matches = [], - i = 0, - length = elems.length, - callbackExpect = !invert; - - // Go through the array, only saving the items - // that pass the validator function - for ( ; i < length; i++ ) { - callbackInverse = !callback( elems[ i ], i ); - if ( callbackInverse !== callbackExpect ) { - matches.push( elems[ i ] ); - } - } - - return matches; - }, - - // arg is for internal usage only - map: function( elems, callback, arg ) { - var length, value, - i = 0, - ret = []; - - // Go through the array, translating each of the items to their new values - if ( isArrayLike( elems ) ) { - length = elems.length; - for ( ; i < length; i++ ) { - value = callback( elems[ i ], i, arg ); - - if ( value != null ) { - ret.push( value ); - } - } - - // Go through every key on the object, - } else { - for ( i in elems ) { - value = callback( elems[ i ], i, arg ); - - if ( value != null ) { - ret.push( value ); - } - } - } - - // Flatten any nested arrays - return flat( ret ); - }, - - // A global GUID counter for objects - guid: 1, - - // jQuery.support is not used in Core but other projects attach their - // properties to it so it needs to exist. - support: support -} ); - -if ( typeof Symbol === "function" ) { - jQuery.fn[ Symbol.iterator ] = arr[ Symbol.iterator ]; -} - -// Populate the class2type map -jQuery.each( "Boolean Number String Function Array Date RegExp Object Error Symbol".split( " " ), -function( _i, name ) { - class2type[ "[object " + name + "]" ] = name.toLowerCase(); -} ); - -function isArrayLike( obj ) { - - // Support: real iOS 8.2 only (not reproducible in simulator) - // `in` check used to prevent JIT error (gh-2145) - // hasOwn isn't used here due to false negatives - // regarding Nodelist length in IE - var length = !!obj && "length" in obj && obj.length, - type = toType( obj ); - - if ( isFunction( obj ) || isWindow( obj ) ) { - return false; - } - - return type === "array" || length === 0 || - typeof length === "number" && length > 0 && ( length - 1 ) in obj; -} -var Sizzle = -/*! - * Sizzle CSS Selector Engine v2.3.5 - * https://sizzlejs.com/ - * - * Copyright JS Foundation and other contributors - * Released under the MIT license - * https://js.foundation/ - * - * Date: 2020-03-14 - */ -( function( window ) { -var i, - support, - Expr, - getText, - isXML, - tokenize, - compile, - select, - outermostContext, - sortInput, - hasDuplicate, - - // Local document vars - setDocument, - document, - docElem, - documentIsHTML, - rbuggyQSA, - rbuggyMatches, - matches, - contains, - - // Instance-specific data - expando = "sizzle" + 1 * new Date(), - preferredDoc = window.document, - dirruns = 0, - done = 0, - classCache = createCache(), - tokenCache = createCache(), - compilerCache = createCache(), - nonnativeSelectorCache = createCache(), - sortOrder = function( a, b ) { - if ( a === b ) { - hasDuplicate = true; - } - return 0; - }, - - // Instance methods - hasOwn = ( {} ).hasOwnProperty, - arr = [], - pop = arr.pop, - pushNative = arr.push, - push = arr.push, - slice = arr.slice, - - // Use a stripped-down indexOf as it's faster than native - // https://jsperf.com/thor-indexof-vs-for/5 - indexOf = function( list, elem ) { - var i = 0, - len = list.length; - for ( ; i < len; i++ ) { - if ( list[ i ] === elem ) { - return i; - } - } - return -1; - }, - - booleans = "checked|selected|async|autofocus|autoplay|controls|defer|disabled|hidden|" + - "ismap|loop|multiple|open|readonly|required|scoped", - - // Regular expressions - - // http://www.w3.org/TR/css3-selectors/#whitespace - whitespace = "[\\x20\\t\\r\\n\\f]", - - // https://www.w3.org/TR/css-syntax-3/#ident-token-diagram - identifier = "(?:\\\\[\\da-fA-F]{1,6}" + whitespace + - "?|\\\\[^\\r\\n\\f]|[\\w-]|[^\0-\\x7f])+", - - // Attribute selectors: http://www.w3.org/TR/selectors/#attribute-selectors - attributes = "\\[" + whitespace + "*(" + identifier + ")(?:" + whitespace + - - // Operator (capture 2) - "*([*^$|!~]?=)" + whitespace + - - // "Attribute values must be CSS identifiers [capture 5] - // or strings [capture 3 or capture 4]" - "*(?:'((?:\\\\.|[^\\\\'])*)'|\"((?:\\\\.|[^\\\\\"])*)\"|(" + identifier + "))|)" + - whitespace + "*\\]", - - pseudos = ":(" + identifier + ")(?:\\((" + - - // To reduce the number of selectors needing tokenize in the preFilter, prefer arguments: - // 1. quoted (capture 3; capture 4 or capture 5) - "('((?:\\\\.|[^\\\\'])*)'|\"((?:\\\\.|[^\\\\\"])*)\")|" + - - // 2. simple (capture 6) - "((?:\\\\.|[^\\\\()[\\]]|" + attributes + ")*)|" + - - // 3. anything else (capture 2) - ".*" + - ")\\)|)", - - // Leading and non-escaped trailing whitespace, capturing some non-whitespace characters preceding the latter - rwhitespace = new RegExp( whitespace + "+", "g" ), - rtrim = new RegExp( "^" + whitespace + "+|((?:^|[^\\\\])(?:\\\\.)*)" + - whitespace + "+$", "g" ), - - rcomma = new RegExp( "^" + whitespace + "*," + whitespace + "*" ), - rcombinators = new RegExp( "^" + whitespace + "*([>+~]|" + whitespace + ")" + whitespace + - "*" ), - rdescend = new RegExp( whitespace + "|>" ), - - rpseudo = new RegExp( pseudos ), - ridentifier = new RegExp( "^" + identifier + "$" ), - - matchExpr = { - "ID": new RegExp( "^#(" + identifier + ")" ), - "CLASS": new RegExp( "^\\.(" + identifier + ")" ), - "TAG": new RegExp( "^(" + identifier + "|[*])" ), - "ATTR": new RegExp( "^" + attributes ), - "PSEUDO": new RegExp( "^" + pseudos ), - "CHILD": new RegExp( "^:(only|first|last|nth|nth-last)-(child|of-type)(?:\\(" + - whitespace + "*(even|odd|(([+-]|)(\\d*)n|)" + whitespace + "*(?:([+-]|)" + - whitespace + "*(\\d+)|))" + whitespace + "*\\)|)", "i" ), - "bool": new RegExp( "^(?:" + booleans + ")$", "i" ), - - // For use in libraries implementing .is() - // We use this for POS matching in `select` - "needsContext": new RegExp( "^" + whitespace + - "*[>+~]|:(even|odd|eq|gt|lt|nth|first|last)(?:\\(" + whitespace + - "*((?:-\\d)?\\d*)" + whitespace + "*\\)|)(?=[^-]|$)", "i" ) - }, - - rhtml = /HTML$/i, - rinputs = /^(?:input|select|textarea|button)$/i, - rheader = /^h\d$/i, - - rnative = /^[^{]+\{\s*\[native \w/, - - // Easily-parseable/retrievable ID or TAG or CLASS selectors - rquickExpr = /^(?:#([\w-]+)|(\w+)|\.([\w-]+))$/, - - rsibling = /[+~]/, - - // CSS escapes - // http://www.w3.org/TR/CSS21/syndata.html#escaped-characters - runescape = new RegExp( "\\\\[\\da-fA-F]{1,6}" + whitespace + "?|\\\\([^\\r\\n\\f])", "g" ), - funescape = function( escape, nonHex ) { - var high = "0x" + escape.slice( 1 ) - 0x10000; - - return nonHex ? - - // Strip the backslash prefix from a non-hex escape sequence - nonHex : - - // Replace a hexadecimal escape sequence with the encoded Unicode code point - // Support: IE <=11+ - // For values outside the Basic Multilingual Plane (BMP), manually construct a - // surrogate pair - high < 0 ? - String.fromCharCode( high + 0x10000 ) : - String.fromCharCode( high >> 10 | 0xD800, high & 0x3FF | 0xDC00 ); - }, - - // CSS string/identifier serialization - // https://drafts.csswg.org/cssom/#common-serializing-idioms - rcssescape = /([\0-\x1f\x7f]|^-?\d)|^-$|[^\0-\x1f\x7f-\uFFFF\w-]/g, - fcssescape = function( ch, asCodePoint ) { - if ( asCodePoint ) { - - // U+0000 NULL becomes U+FFFD REPLACEMENT CHARACTER - if ( ch === "\0" ) { - return "\uFFFD"; - } - - // Control characters and (dependent upon position) numbers get escaped as code points - return ch.slice( 0, -1 ) + "\\" + - ch.charCodeAt( ch.length - 1 ).toString( 16 ) + " "; - } - - // Other potentially-special ASCII characters get backslash-escaped - return "\\" + ch; - }, - - // Used for iframes - // See setDocument() - // Removing the function wrapper causes a "Permission Denied" - // error in IE - unloadHandler = function() { - setDocument(); - }, - - inDisabledFieldset = addCombinator( - function( elem ) { - return elem.disabled === true && elem.nodeName.toLowerCase() === "fieldset"; - }, - { dir: "parentNode", next: "legend" } - ); - -// Optimize for push.apply( _, NodeList ) -try { - push.apply( - ( arr = slice.call( preferredDoc.childNodes ) ), - preferredDoc.childNodes - ); - - // Support: Android<4.0 - // Detect silently failing push.apply - // eslint-disable-next-line no-unused-expressions - arr[ preferredDoc.childNodes.length ].nodeType; -} catch ( e ) { - push = { apply: arr.length ? - - // Leverage slice if possible - function( target, els ) { - pushNative.apply( target, slice.call( els ) ); - } : - - // Support: IE<9 - // Otherwise append directly - function( target, els ) { - var j = target.length, - i = 0; - - // Can't trust NodeList.length - while ( ( target[ j++ ] = els[ i++ ] ) ) {} - target.length = j - 1; - } - }; -} - -function Sizzle( selector, context, results, seed ) { - var m, i, elem, nid, match, groups, newSelector, - newContext = context && context.ownerDocument, - - // nodeType defaults to 9, since context defaults to document - nodeType = context ? context.nodeType : 9; - - results = results || []; - - // Return early from calls with invalid selector or context - if ( typeof selector !== "string" || !selector || - nodeType !== 1 && nodeType !== 9 && nodeType !== 11 ) { - - return results; - } - - // Try to shortcut find operations (as opposed to filters) in HTML documents - if ( !seed ) { - setDocument( context ); - context = context || document; - - if ( documentIsHTML ) { - - // If the selector is sufficiently simple, try using a "get*By*" DOM method - // (excepting DocumentFragment context, where the methods don't exist) - if ( nodeType !== 11 && ( match = rquickExpr.exec( selector ) ) ) { - - // ID selector - if ( ( m = match[ 1 ] ) ) { - - // Document context - if ( nodeType === 9 ) { - if ( ( elem = context.getElementById( m ) ) ) { - - // Support: IE, Opera, Webkit - // TODO: identify versions - // getElementById can match elements by name instead of ID - if ( elem.id === m ) { - results.push( elem ); - return results; - } - } else { - return results; - } - - // Element context - } else { - - // Support: IE, Opera, Webkit - // TODO: identify versions - // getElementById can match elements by name instead of ID - if ( newContext && ( elem = newContext.getElementById( m ) ) && - contains( context, elem ) && - elem.id === m ) { - - results.push( elem ); - return results; - } - } - - // Type selector - } else if ( match[ 2 ] ) { - push.apply( results, context.getElementsByTagName( selector ) ); - return results; - - // Class selector - } else if ( ( m = match[ 3 ] ) && support.getElementsByClassName && - context.getElementsByClassName ) { - - push.apply( results, context.getElementsByClassName( m ) ); - return results; - } - } - - // Take advantage of querySelectorAll - if ( support.qsa && - !nonnativeSelectorCache[ selector + " " ] && - ( !rbuggyQSA || !rbuggyQSA.test( selector ) ) && - - // Support: IE 8 only - // Exclude object elements - ( nodeType !== 1 || context.nodeName.toLowerCase() !== "object" ) ) { - - newSelector = selector; - newContext = context; - - // qSA considers elements outside a scoping root when evaluating child or - // descendant combinators, which is not what we want. - // In such cases, we work around the behavior by prefixing every selector in the - // list with an ID selector referencing the scope context. - // The technique has to be used as well when a leading combinator is used - // as such selectors are not recognized by querySelectorAll. - // Thanks to Andrew Dupont for this technique. - if ( nodeType === 1 && - ( rdescend.test( selector ) || rcombinators.test( selector ) ) ) { - - // Expand context for sibling selectors - newContext = rsibling.test( selector ) && testContext( context.parentNode ) || - context; - - // We can use :scope instead of the ID hack if the browser - // supports it & if we're not changing the context. - if ( newContext !== context || !support.scope ) { - - // Capture the context ID, setting it first if necessary - if ( ( nid = context.getAttribute( "id" ) ) ) { - nid = nid.replace( rcssescape, fcssescape ); - } else { - context.setAttribute( "id", ( nid = expando ) ); - } - } - - // Prefix every selector in the list - groups = tokenize( selector ); - i = groups.length; - while ( i-- ) { - groups[ i ] = ( nid ? "#" + nid : ":scope" ) + " " + - toSelector( groups[ i ] ); - } - newSelector = groups.join( "," ); - } - - try { - push.apply( results, - newContext.querySelectorAll( newSelector ) - ); - return results; - } catch ( qsaError ) { - nonnativeSelectorCache( selector, true ); - } finally { - if ( nid === expando ) { - context.removeAttribute( "id" ); - } - } - } - } - } - - // All others - return select( selector.replace( rtrim, "$1" ), context, results, seed ); -} - -/** - * Create key-value caches of limited size - * @returns {function(string, object)} Returns the Object data after storing it on itself with - * property name the (space-suffixed) string and (if the cache is larger than Expr.cacheLength) - * deleting the oldest entry - */ -function createCache() { - var keys = []; - - function cache( key, value ) { - - // Use (key + " ") to avoid collision with native prototype properties (see Issue #157) - if ( keys.push( key + " " ) > Expr.cacheLength ) { - - // Only keep the most recent entries - delete cache[ keys.shift() ]; - } - return ( cache[ key + " " ] = value ); - } - return cache; -} - -/** - * Mark a function for special use by Sizzle - * @param {Function} fn The function to mark - */ -function markFunction( fn ) { - fn[ expando ] = true; - return fn; -} - -/** - * Support testing using an element - * @param {Function} fn Passed the created element and returns a boolean result - */ -function assert( fn ) { - var el = document.createElement( "fieldset" ); - - try { - return !!fn( el ); - } catch ( e ) { - return false; - } finally { - - // Remove from its parent by default - if ( el.parentNode ) { - el.parentNode.removeChild( el ); - } - - // release memory in IE - el = null; - } -} - -/** - * Adds the same handler for all of the specified attrs - * @param {String} attrs Pipe-separated list of attributes - * @param {Function} handler The method that will be applied - */ -function addHandle( attrs, handler ) { - var arr = attrs.split( "|" ), - i = arr.length; - - while ( i-- ) { - Expr.attrHandle[ arr[ i ] ] = handler; - } -} - -/** - * Checks document order of two siblings - * @param {Element} a - * @param {Element} b - * @returns {Number} Returns less than 0 if a precedes b, greater than 0 if a follows b - */ -function siblingCheck( a, b ) { - var cur = b && a, - diff = cur && a.nodeType === 1 && b.nodeType === 1 && - a.sourceIndex - b.sourceIndex; - - // Use IE sourceIndex if available on both nodes - if ( diff ) { - return diff; - } - - // Check if b follows a - if ( cur ) { - while ( ( cur = cur.nextSibling ) ) { - if ( cur === b ) { - return -1; - } - } - } - - return a ? 1 : -1; -} - -/** - * Returns a function to use in pseudos for input types - * @param {String} type - */ -function createInputPseudo( type ) { - return function( elem ) { - var name = elem.nodeName.toLowerCase(); - return name === "input" && elem.type === type; - }; -} - -/** - * Returns a function to use in pseudos for buttons - * @param {String} type - */ -function createButtonPseudo( type ) { - return function( elem ) { - var name = elem.nodeName.toLowerCase(); - return ( name === "input" || name === "button" ) && elem.type === type; - }; -} - -/** - * Returns a function to use in pseudos for :enabled/:disabled - * @param {Boolean} disabled true for :disabled; false for :enabled - */ -function createDisabledPseudo( disabled ) { - - // Known :disabled false positives: fieldset[disabled] > legend:nth-of-type(n+2) :can-disable - return function( elem ) { - - // Only certain elements can match :enabled or :disabled - // https://html.spec.whatwg.org/multipage/scripting.html#selector-enabled - // https://html.spec.whatwg.org/multipage/scripting.html#selector-disabled - if ( "form" in elem ) { - - // Check for inherited disabledness on relevant non-disabled elements: - // * listed form-associated elements in a disabled fieldset - // https://html.spec.whatwg.org/multipage/forms.html#category-listed - // https://html.spec.whatwg.org/multipage/forms.html#concept-fe-disabled - // * option elements in a disabled optgroup - // https://html.spec.whatwg.org/multipage/forms.html#concept-option-disabled - // All such elements have a "form" property. - if ( elem.parentNode && elem.disabled === false ) { - - // Option elements defer to a parent optgroup if present - if ( "label" in elem ) { - if ( "label" in elem.parentNode ) { - return elem.parentNode.disabled === disabled; - } else { - return elem.disabled === disabled; - } - } - - // Support: IE 6 - 11 - // Use the isDisabled shortcut property to check for disabled fieldset ancestors - return elem.isDisabled === disabled || - - // Where there is no isDisabled, check manually - /* jshint -W018 */ - elem.isDisabled !== !disabled && - inDisabledFieldset( elem ) === disabled; - } - - return elem.disabled === disabled; - - // Try to winnow out elements that can't be disabled before trusting the disabled property. - // Some victims get caught in our net (label, legend, menu, track), but it shouldn't - // even exist on them, let alone have a boolean value. - } else if ( "label" in elem ) { - return elem.disabled === disabled; - } - - // Remaining elements are neither :enabled nor :disabled - return false; - }; -} - -/** - * Returns a function to use in pseudos for positionals - * @param {Function} fn - */ -function createPositionalPseudo( fn ) { - return markFunction( function( argument ) { - argument = +argument; - return markFunction( function( seed, matches ) { - var j, - matchIndexes = fn( [], seed.length, argument ), - i = matchIndexes.length; - - // Match elements found at the specified indexes - while ( i-- ) { - if ( seed[ ( j = matchIndexes[ i ] ) ] ) { - seed[ j ] = !( matches[ j ] = seed[ j ] ); - } - } - } ); - } ); -} - -/** - * Checks a node for validity as a Sizzle context - * @param {Element|Object=} context - * @returns {Element|Object|Boolean} The input node if acceptable, otherwise a falsy value - */ -function testContext( context ) { - return context && typeof context.getElementsByTagName !== "undefined" && context; -} - -// Expose support vars for convenience -support = Sizzle.support = {}; - -/** - * Detects XML nodes - * @param {Element|Object} elem An element or a document - * @returns {Boolean} True iff elem is a non-HTML XML node - */ -isXML = Sizzle.isXML = function( elem ) { - var namespace = elem.namespaceURI, - docElem = ( elem.ownerDocument || elem ).documentElement; - - // Support: IE <=8 - // Assume HTML when documentElement doesn't yet exist, such as inside loading iframes - // https://bugs.jquery.com/ticket/4833 - return !rhtml.test( namespace || docElem && docElem.nodeName || "HTML" ); -}; - -/** - * Sets document-related variables once based on the current document - * @param {Element|Object} [doc] An element or document object to use to set the document - * @returns {Object} Returns the current document - */ -setDocument = Sizzle.setDocument = function( node ) { - var hasCompare, subWindow, - doc = node ? node.ownerDocument || node : preferredDoc; - - // Return early if doc is invalid or already selected - // Support: IE 11+, Edge 17 - 18+ - // IE/Edge sometimes throw a "Permission denied" error when strict-comparing - // two documents; shallow comparisons work. - // eslint-disable-next-line eqeqeq - if ( doc == document || doc.nodeType !== 9 || !doc.documentElement ) { - return document; - } - - // Update global variables - document = doc; - docElem = document.documentElement; - documentIsHTML = !isXML( document ); - - // Support: IE 9 - 11+, Edge 12 - 18+ - // Accessing iframe documents after unload throws "permission denied" errors (jQuery #13936) - // Support: IE 11+, Edge 17 - 18+ - // IE/Edge sometimes throw a "Permission denied" error when strict-comparing - // two documents; shallow comparisons work. - // eslint-disable-next-line eqeqeq - if ( preferredDoc != document && - ( subWindow = document.defaultView ) && subWindow.top !== subWindow ) { - - // Support: IE 11, Edge - if ( subWindow.addEventListener ) { - subWindow.addEventListener( "unload", unloadHandler, false ); - - // Support: IE 9 - 10 only - } else if ( subWindow.attachEvent ) { - subWindow.attachEvent( "onunload", unloadHandler ); - } - } - - // Support: IE 8 - 11+, Edge 12 - 18+, Chrome <=16 - 25 only, Firefox <=3.6 - 31 only, - // Safari 4 - 5 only, Opera <=11.6 - 12.x only - // IE/Edge & older browsers don't support the :scope pseudo-class. - // Support: Safari 6.0 only - // Safari 6.0 supports :scope but it's an alias of :root there. - support.scope = assert( function( el ) { - docElem.appendChild( el ).appendChild( document.createElement( "div" ) ); - return typeof el.querySelectorAll !== "undefined" && - !el.querySelectorAll( ":scope fieldset div" ).length; - } ); - - /* Attributes - ---------------------------------------------------------------------- */ - - // Support: IE<8 - // Verify that getAttribute really returns attributes and not properties - // (excepting IE8 booleans) - support.attributes = assert( function( el ) { - el.className = "i"; - return !el.getAttribute( "className" ); - } ); - - /* getElement(s)By* - ---------------------------------------------------------------------- */ - - // Check if getElementsByTagName("*") returns only elements - support.getElementsByTagName = assert( function( el ) { - el.appendChild( document.createComment( "" ) ); - return !el.getElementsByTagName( "*" ).length; - } ); - - // Support: IE<9 - support.getElementsByClassName = rnative.test( document.getElementsByClassName ); - - // Support: IE<10 - // Check if getElementById returns elements by name - // The broken getElementById methods don't pick up programmatically-set names, - // so use a roundabout getElementsByName test - support.getById = assert( function( el ) { - docElem.appendChild( el ).id = expando; - return !document.getElementsByName || !document.getElementsByName( expando ).length; - } ); - - // ID filter and find - if ( support.getById ) { - Expr.filter[ "ID" ] = function( id ) { - var attrId = id.replace( runescape, funescape ); - return function( elem ) { - return elem.getAttribute( "id" ) === attrId; - }; - }; - Expr.find[ "ID" ] = function( id, context ) { - if ( typeof context.getElementById !== "undefined" && documentIsHTML ) { - var elem = context.getElementById( id ); - return elem ? [ elem ] : []; - } - }; - } else { - Expr.filter[ "ID" ] = function( id ) { - var attrId = id.replace( runescape, funescape ); - return function( elem ) { - var node = typeof elem.getAttributeNode !== "undefined" && - elem.getAttributeNode( "id" ); - return node && node.value === attrId; - }; - }; - - // Support: IE 6 - 7 only - // getElementById is not reliable as a find shortcut - Expr.find[ "ID" ] = function( id, context ) { - if ( typeof context.getElementById !== "undefined" && documentIsHTML ) { - var node, i, elems, - elem = context.getElementById( id ); - - if ( elem ) { - - // Verify the id attribute - node = elem.getAttributeNode( "id" ); - if ( node && node.value === id ) { - return [ elem ]; - } - - // Fall back on getElementsByName - elems = context.getElementsByName( id ); - i = 0; - while ( ( elem = elems[ i++ ] ) ) { - node = elem.getAttributeNode( "id" ); - if ( node && node.value === id ) { - return [ elem ]; - } - } - } - - return []; - } - }; - } - - // Tag - Expr.find[ "TAG" ] = support.getElementsByTagName ? - function( tag, context ) { - if ( typeof context.getElementsByTagName !== "undefined" ) { - return context.getElementsByTagName( tag ); - - // DocumentFragment nodes don't have gEBTN - } else if ( support.qsa ) { - return context.querySelectorAll( tag ); - } - } : - - function( tag, context ) { - var elem, - tmp = [], - i = 0, - - // By happy coincidence, a (broken) gEBTN appears on DocumentFragment nodes too - results = context.getElementsByTagName( tag ); - - // Filter out possible comments - if ( tag === "*" ) { - while ( ( elem = results[ i++ ] ) ) { - if ( elem.nodeType === 1 ) { - tmp.push( elem ); - } - } - - return tmp; - } - return results; - }; - - // Class - Expr.find[ "CLASS" ] = support.getElementsByClassName && function( className, context ) { - if ( typeof context.getElementsByClassName !== "undefined" && documentIsHTML ) { - return context.getElementsByClassName( className ); - } - }; - - /* QSA/matchesSelector - ---------------------------------------------------------------------- */ - - // QSA and matchesSelector support - - // matchesSelector(:active) reports false when true (IE9/Opera 11.5) - rbuggyMatches = []; - - // qSa(:focus) reports false when true (Chrome 21) - // We allow this because of a bug in IE8/9 that throws an error - // whenever `document.activeElement` is accessed on an iframe - // So, we allow :focus to pass through QSA all the time to avoid the IE error - // See https://bugs.jquery.com/ticket/13378 - rbuggyQSA = []; - - if ( ( support.qsa = rnative.test( document.querySelectorAll ) ) ) { - - // Build QSA regex - // Regex strategy adopted from Diego Perini - assert( function( el ) { - - var input; - - // Select is set to empty string on purpose - // This is to test IE's treatment of not explicitly - // setting a boolean content attribute, - // since its presence should be enough - // https://bugs.jquery.com/ticket/12359 - docElem.appendChild( el ).innerHTML = "" + - ""; - - // Support: IE8, Opera 11-12.16 - // Nothing should be selected when empty strings follow ^= or $= or *= - // The test attribute must be unknown in Opera but "safe" for WinRT - // https://msdn.microsoft.com/en-us/library/ie/hh465388.aspx#attribute_section - if ( el.querySelectorAll( "[msallowcapture^='']" ).length ) { - rbuggyQSA.push( "[*^$]=" + whitespace + "*(?:''|\"\")" ); - } - - // Support: IE8 - // Boolean attributes and "value" are not treated correctly - if ( !el.querySelectorAll( "[selected]" ).length ) { - rbuggyQSA.push( "\\[" + whitespace + "*(?:value|" + booleans + ")" ); - } - - // Support: Chrome<29, Android<4.4, Safari<7.0+, iOS<7.0+, PhantomJS<1.9.8+ - if ( !el.querySelectorAll( "[id~=" + expando + "-]" ).length ) { - rbuggyQSA.push( "~=" ); - } - - // Support: IE 11+, Edge 15 - 18+ - // IE 11/Edge don't find elements on a `[name='']` query in some cases. - // Adding a temporary attribute to the document before the selection works - // around the issue. - // Interestingly, IE 10 & older don't seem to have the issue. - input = document.createElement( "input" ); - input.setAttribute( "name", "" ); - el.appendChild( input ); - if ( !el.querySelectorAll( "[name='']" ).length ) { - rbuggyQSA.push( "\\[" + whitespace + "*name" + whitespace + "*=" + - whitespace + "*(?:''|\"\")" ); - } - - // Webkit/Opera - :checked should return selected option elements - // http://www.w3.org/TR/2011/REC-css3-selectors-20110929/#checked - // IE8 throws error here and will not see later tests - if ( !el.querySelectorAll( ":checked" ).length ) { - rbuggyQSA.push( ":checked" ); - } - - // Support: Safari 8+, iOS 8+ - // https://bugs.webkit.org/show_bug.cgi?id=136851 - // In-page `selector#id sibling-combinator selector` fails - if ( !el.querySelectorAll( "a#" + expando + "+*" ).length ) { - rbuggyQSA.push( ".#.+[+~]" ); - } - - // Support: Firefox <=3.6 - 5 only - // Old Firefox doesn't throw on a badly-escaped identifier. - el.querySelectorAll( "\\\f" ); - rbuggyQSA.push( "[\\r\\n\\f]" ); - } ); - - assert( function( el ) { - el.innerHTML = "" + - ""; - - // Support: Windows 8 Native Apps - // The type and name attributes are restricted during .innerHTML assignment - var input = document.createElement( "input" ); - input.setAttribute( "type", "hidden" ); - el.appendChild( input ).setAttribute( "name", "D" ); - - // Support: IE8 - // Enforce case-sensitivity of name attribute - if ( el.querySelectorAll( "[name=d]" ).length ) { - rbuggyQSA.push( "name" + whitespace + "*[*^$|!~]?=" ); - } - - // FF 3.5 - :enabled/:disabled and hidden elements (hidden elements are still enabled) - // IE8 throws error here and will not see later tests - if ( el.querySelectorAll( ":enabled" ).length !== 2 ) { - rbuggyQSA.push( ":enabled", ":disabled" ); - } - - // Support: IE9-11+ - // IE's :disabled selector does not pick up the children of disabled fieldsets - docElem.appendChild( el ).disabled = true; - if ( el.querySelectorAll( ":disabled" ).length !== 2 ) { - rbuggyQSA.push( ":enabled", ":disabled" ); - } - - // Support: Opera 10 - 11 only - // Opera 10-11 does not throw on post-comma invalid pseudos - el.querySelectorAll( "*,:x" ); - rbuggyQSA.push( ",.*:" ); - } ); - } - - if ( ( support.matchesSelector = rnative.test( ( matches = docElem.matches || - docElem.webkitMatchesSelector || - docElem.mozMatchesSelector || - docElem.oMatchesSelector || - docElem.msMatchesSelector ) ) ) ) { - - assert( function( el ) { - - // Check to see if it's possible to do matchesSelector - // on a disconnected node (IE 9) - support.disconnectedMatch = matches.call( el, "*" ); - - // This should fail with an exception - // Gecko does not error, returns false instead - matches.call( el, "[s!='']:x" ); - rbuggyMatches.push( "!=", pseudos ); - } ); - } - - rbuggyQSA = rbuggyQSA.length && new RegExp( rbuggyQSA.join( "|" ) ); - rbuggyMatches = rbuggyMatches.length && new RegExp( rbuggyMatches.join( "|" ) ); - - /* Contains - ---------------------------------------------------------------------- */ - hasCompare = rnative.test( docElem.compareDocumentPosition ); - - // Element contains another - // Purposefully self-exclusive - // As in, an element does not contain itself - contains = hasCompare || rnative.test( docElem.contains ) ? - function( a, b ) { - var adown = a.nodeType === 9 ? a.documentElement : a, - bup = b && b.parentNode; - return a === bup || !!( bup && bup.nodeType === 1 && ( - adown.contains ? - adown.contains( bup ) : - a.compareDocumentPosition && a.compareDocumentPosition( bup ) & 16 - ) ); - } : - function( a, b ) { - if ( b ) { - while ( ( b = b.parentNode ) ) { - if ( b === a ) { - return true; - } - } - } - return false; - }; - - /* Sorting - ---------------------------------------------------------------------- */ - - // Document order sorting - sortOrder = hasCompare ? - function( a, b ) { - - // Flag for duplicate removal - if ( a === b ) { - hasDuplicate = true; - return 0; - } - - // Sort on method existence if only one input has compareDocumentPosition - var compare = !a.compareDocumentPosition - !b.compareDocumentPosition; - if ( compare ) { - return compare; - } - - // Calculate position if both inputs belong to the same document - // Support: IE 11+, Edge 17 - 18+ - // IE/Edge sometimes throw a "Permission denied" error when strict-comparing - // two documents; shallow comparisons work. - // eslint-disable-next-line eqeqeq - compare = ( a.ownerDocument || a ) == ( b.ownerDocument || b ) ? - a.compareDocumentPosition( b ) : - - // Otherwise we know they are disconnected - 1; - - // Disconnected nodes - if ( compare & 1 || - ( !support.sortDetached && b.compareDocumentPosition( a ) === compare ) ) { - - // Choose the first element that is related to our preferred document - // Support: IE 11+, Edge 17 - 18+ - // IE/Edge sometimes throw a "Permission denied" error when strict-comparing - // two documents; shallow comparisons work. - // eslint-disable-next-line eqeqeq - if ( a == document || a.ownerDocument == preferredDoc && - contains( preferredDoc, a ) ) { - return -1; - } - - // Support: IE 11+, Edge 17 - 18+ - // IE/Edge sometimes throw a "Permission denied" error when strict-comparing - // two documents; shallow comparisons work. - // eslint-disable-next-line eqeqeq - if ( b == document || b.ownerDocument == preferredDoc && - contains( preferredDoc, b ) ) { - return 1; - } - - // Maintain original order - return sortInput ? - ( indexOf( sortInput, a ) - indexOf( sortInput, b ) ) : - 0; - } - - return compare & 4 ? -1 : 1; - } : - function( a, b ) { - - // Exit early if the nodes are identical - if ( a === b ) { - hasDuplicate = true; - return 0; - } - - var cur, - i = 0, - aup = a.parentNode, - bup = b.parentNode, - ap = [ a ], - bp = [ b ]; - - // Parentless nodes are either documents or disconnected - if ( !aup || !bup ) { - - // Support: IE 11+, Edge 17 - 18+ - // IE/Edge sometimes throw a "Permission denied" error when strict-comparing - // two documents; shallow comparisons work. - /* eslint-disable eqeqeq */ - return a == document ? -1 : - b == document ? 1 : - /* eslint-enable eqeqeq */ - aup ? -1 : - bup ? 1 : - sortInput ? - ( indexOf( sortInput, a ) - indexOf( sortInput, b ) ) : - 0; - - // If the nodes are siblings, we can do a quick check - } else if ( aup === bup ) { - return siblingCheck( a, b ); - } - - // Otherwise we need full lists of their ancestors for comparison - cur = a; - while ( ( cur = cur.parentNode ) ) { - ap.unshift( cur ); - } - cur = b; - while ( ( cur = cur.parentNode ) ) { - bp.unshift( cur ); - } - - // Walk down the tree looking for a discrepancy - while ( ap[ i ] === bp[ i ] ) { - i++; - } - - return i ? - - // Do a sibling check if the nodes have a common ancestor - siblingCheck( ap[ i ], bp[ i ] ) : - - // Otherwise nodes in our document sort first - // Support: IE 11+, Edge 17 - 18+ - // IE/Edge sometimes throw a "Permission denied" error when strict-comparing - // two documents; shallow comparisons work. - /* eslint-disable eqeqeq */ - ap[ i ] == preferredDoc ? -1 : - bp[ i ] == preferredDoc ? 1 : - /* eslint-enable eqeqeq */ - 0; - }; - - return document; -}; - -Sizzle.matches = function( expr, elements ) { - return Sizzle( expr, null, null, elements ); -}; - -Sizzle.matchesSelector = function( elem, expr ) { - setDocument( elem ); - - if ( support.matchesSelector && documentIsHTML && - !nonnativeSelectorCache[ expr + " " ] && - ( !rbuggyMatches || !rbuggyMatches.test( expr ) ) && - ( !rbuggyQSA || !rbuggyQSA.test( expr ) ) ) { - - try { - var ret = matches.call( elem, expr ); - - // IE 9's matchesSelector returns false on disconnected nodes - if ( ret || support.disconnectedMatch || - - // As well, disconnected nodes are said to be in a document - // fragment in IE 9 - elem.document && elem.document.nodeType !== 11 ) { - return ret; - } - } catch ( e ) { - nonnativeSelectorCache( expr, true ); - } - } - - return Sizzle( expr, document, null, [ elem ] ).length > 0; -}; - -Sizzle.contains = function( context, elem ) { - - // Set document vars if needed - // Support: IE 11+, Edge 17 - 18+ - // IE/Edge sometimes throw a "Permission denied" error when strict-comparing - // two documents; shallow comparisons work. - // eslint-disable-next-line eqeqeq - if ( ( context.ownerDocument || context ) != document ) { - setDocument( context ); - } - return contains( context, elem ); -}; - -Sizzle.attr = function( elem, name ) { - - // Set document vars if needed - // Support: IE 11+, Edge 17 - 18+ - // IE/Edge sometimes throw a "Permission denied" error when strict-comparing - // two documents; shallow comparisons work. - // eslint-disable-next-line eqeqeq - if ( ( elem.ownerDocument || elem ) != document ) { - setDocument( elem ); - } - - var fn = Expr.attrHandle[ name.toLowerCase() ], - - // Don't get fooled by Object.prototype properties (jQuery #13807) - val = fn && hasOwn.call( Expr.attrHandle, name.toLowerCase() ) ? - fn( elem, name, !documentIsHTML ) : - undefined; - - return val !== undefined ? - val : - support.attributes || !documentIsHTML ? - elem.getAttribute( name ) : - ( val = elem.getAttributeNode( name ) ) && val.specified ? - val.value : - null; -}; - -Sizzle.escape = function( sel ) { - return ( sel + "" ).replace( rcssescape, fcssescape ); -}; - -Sizzle.error = function( msg ) { - throw new Error( "Syntax error, unrecognized expression: " + msg ); -}; - -/** - * Document sorting and removing duplicates - * @param {ArrayLike} results - */ -Sizzle.uniqueSort = function( results ) { - var elem, - duplicates = [], - j = 0, - i = 0; - - // Unless we *know* we can detect duplicates, assume their presence - hasDuplicate = !support.detectDuplicates; - sortInput = !support.sortStable && results.slice( 0 ); - results.sort( sortOrder ); - - if ( hasDuplicate ) { - while ( ( elem = results[ i++ ] ) ) { - if ( elem === results[ i ] ) { - j = duplicates.push( i ); - } - } - while ( j-- ) { - results.splice( duplicates[ j ], 1 ); - } - } - - // Clear input after sorting to release objects - // See https://github.com/jquery/sizzle/pull/225 - sortInput = null; - - return results; -}; - -/** - * Utility function for retrieving the text value of an array of DOM nodes - * @param {Array|Element} elem - */ -getText = Sizzle.getText = function( elem ) { - var node, - ret = "", - i = 0, - nodeType = elem.nodeType; - - if ( !nodeType ) { - - // If no nodeType, this is expected to be an array - while ( ( node = elem[ i++ ] ) ) { - - // Do not traverse comment nodes - ret += getText( node ); - } - } else if ( nodeType === 1 || nodeType === 9 || nodeType === 11 ) { - - // Use textContent for elements - // innerText usage removed for consistency of new lines (jQuery #11153) - if ( typeof elem.textContent === "string" ) { - return elem.textContent; - } else { - - // Traverse its children - for ( elem = elem.firstChild; elem; elem = elem.nextSibling ) { - ret += getText( elem ); - } - } - } else if ( nodeType === 3 || nodeType === 4 ) { - return elem.nodeValue; - } - - // Do not include comment or processing instruction nodes - - return ret; -}; - -Expr = Sizzle.selectors = { - - // Can be adjusted by the user - cacheLength: 50, - - createPseudo: markFunction, - - match: matchExpr, - - attrHandle: {}, - - find: {}, - - relative: { - ">": { dir: "parentNode", first: true }, - " ": { dir: "parentNode" }, - "+": { dir: "previousSibling", first: true }, - "~": { dir: "previousSibling" } - }, - - preFilter: { - "ATTR": function( match ) { - match[ 1 ] = match[ 1 ].replace( runescape, funescape ); - - // Move the given value to match[3] whether quoted or unquoted - match[ 3 ] = ( match[ 3 ] || match[ 4 ] || - match[ 5 ] || "" ).replace( runescape, funescape ); - - if ( match[ 2 ] === "~=" ) { - match[ 3 ] = " " + match[ 3 ] + " "; - } - - return match.slice( 0, 4 ); - }, - - "CHILD": function( match ) { - - /* matches from matchExpr["CHILD"] - 1 type (only|nth|...) - 2 what (child|of-type) - 3 argument (even|odd|\d*|\d*n([+-]\d+)?|...) - 4 xn-component of xn+y argument ([+-]?\d*n|) - 5 sign of xn-component - 6 x of xn-component - 7 sign of y-component - 8 y of y-component - */ - match[ 1 ] = match[ 1 ].toLowerCase(); - - if ( match[ 1 ].slice( 0, 3 ) === "nth" ) { - - // nth-* requires argument - if ( !match[ 3 ] ) { - Sizzle.error( match[ 0 ] ); - } - - // numeric x and y parameters for Expr.filter.CHILD - // remember that false/true cast respectively to 0/1 - match[ 4 ] = +( match[ 4 ] ? - match[ 5 ] + ( match[ 6 ] || 1 ) : - 2 * ( match[ 3 ] === "even" || match[ 3 ] === "odd" ) ); - match[ 5 ] = +( ( match[ 7 ] + match[ 8 ] ) || match[ 3 ] === "odd" ); - - // other types prohibit arguments - } else if ( match[ 3 ] ) { - Sizzle.error( match[ 0 ] ); - } - - return match; - }, - - "PSEUDO": function( match ) { - var excess, - unquoted = !match[ 6 ] && match[ 2 ]; - - if ( matchExpr[ "CHILD" ].test( match[ 0 ] ) ) { - return null; - } - - // Accept quoted arguments as-is - if ( match[ 3 ] ) { - match[ 2 ] = match[ 4 ] || match[ 5 ] || ""; - - // Strip excess characters from unquoted arguments - } else if ( unquoted && rpseudo.test( unquoted ) && - - // Get excess from tokenize (recursively) - ( excess = tokenize( unquoted, true ) ) && - - // advance to the next closing parenthesis - ( excess = unquoted.indexOf( ")", unquoted.length - excess ) - unquoted.length ) ) { - - // excess is a negative index - match[ 0 ] = match[ 0 ].slice( 0, excess ); - match[ 2 ] = unquoted.slice( 0, excess ); - } - - // Return only captures needed by the pseudo filter method (type and argument) - return match.slice( 0, 3 ); - } - }, - - filter: { - - "TAG": function( nodeNameSelector ) { - var nodeName = nodeNameSelector.replace( runescape, funescape ).toLowerCase(); - return nodeNameSelector === "*" ? - function() { - return true; - } : - function( elem ) { - return elem.nodeName && elem.nodeName.toLowerCase() === nodeName; - }; - }, - - "CLASS": function( className ) { - var pattern = classCache[ className + " " ]; - - return pattern || - ( pattern = new RegExp( "(^|" + whitespace + - ")" + className + "(" + whitespace + "|$)" ) ) && classCache( - className, function( elem ) { - return pattern.test( - typeof elem.className === "string" && elem.className || - typeof elem.getAttribute !== "undefined" && - elem.getAttribute( "class" ) || - "" - ); - } ); - }, - - "ATTR": function( name, operator, check ) { - return function( elem ) { - var result = Sizzle.attr( elem, name ); - - if ( result == null ) { - return operator === "!="; - } - if ( !operator ) { - return true; - } - - result += ""; - - /* eslint-disable max-len */ - - return operator === "=" ? result === check : - operator === "!=" ? result !== check : - operator === "^=" ? check && result.indexOf( check ) === 0 : - operator === "*=" ? check && result.indexOf( check ) > -1 : - operator === "$=" ? check && result.slice( -check.length ) === check : - operator === "~=" ? ( " " + result.replace( rwhitespace, " " ) + " " ).indexOf( check ) > -1 : - operator === "|=" ? result === check || result.slice( 0, check.length + 1 ) === check + "-" : - false; - /* eslint-enable max-len */ - - }; - }, - - "CHILD": function( type, what, _argument, first, last ) { - var simple = type.slice( 0, 3 ) !== "nth", - forward = type.slice( -4 ) !== "last", - ofType = what === "of-type"; - - return first === 1 && last === 0 ? - - // Shortcut for :nth-*(n) - function( elem ) { - return !!elem.parentNode; - } : - - function( elem, _context, xml ) { - var cache, uniqueCache, outerCache, node, nodeIndex, start, - dir = simple !== forward ? "nextSibling" : "previousSibling", - parent = elem.parentNode, - name = ofType && elem.nodeName.toLowerCase(), - useCache = !xml && !ofType, - diff = false; - - if ( parent ) { - - // :(first|last|only)-(child|of-type) - if ( simple ) { - while ( dir ) { - node = elem; - while ( ( node = node[ dir ] ) ) { - if ( ofType ? - node.nodeName.toLowerCase() === name : - node.nodeType === 1 ) { - - return false; - } - } - - // Reverse direction for :only-* (if we haven't yet done so) - start = dir = type === "only" && !start && "nextSibling"; - } - return true; - } - - start = [ forward ? parent.firstChild : parent.lastChild ]; - - // non-xml :nth-child(...) stores cache data on `parent` - if ( forward && useCache ) { - - // Seek `elem` from a previously-cached index - - // ...in a gzip-friendly way - node = parent; - outerCache = node[ expando ] || ( node[ expando ] = {} ); - - // Support: IE <9 only - // Defend against cloned attroperties (jQuery gh-1709) - uniqueCache = outerCache[ node.uniqueID ] || - ( outerCache[ node.uniqueID ] = {} ); - - cache = uniqueCache[ type ] || []; - nodeIndex = cache[ 0 ] === dirruns && cache[ 1 ]; - diff = nodeIndex && cache[ 2 ]; - node = nodeIndex && parent.childNodes[ nodeIndex ]; - - while ( ( node = ++nodeIndex && node && node[ dir ] || - - // Fallback to seeking `elem` from the start - ( diff = nodeIndex = 0 ) || start.pop() ) ) { - - // When found, cache indexes on `parent` and break - if ( node.nodeType === 1 && ++diff && node === elem ) { - uniqueCache[ type ] = [ dirruns, nodeIndex, diff ]; - break; - } - } - - } else { - - // Use previously-cached element index if available - if ( useCache ) { - - // ...in a gzip-friendly way - node = elem; - outerCache = node[ expando ] || ( node[ expando ] = {} ); - - // Support: IE <9 only - // Defend against cloned attroperties (jQuery gh-1709) - uniqueCache = outerCache[ node.uniqueID ] || - ( outerCache[ node.uniqueID ] = {} ); - - cache = uniqueCache[ type ] || []; - nodeIndex = cache[ 0 ] === dirruns && cache[ 1 ]; - diff = nodeIndex; - } - - // xml :nth-child(...) - // or :nth-last-child(...) or :nth(-last)?-of-type(...) - if ( diff === false ) { - - // Use the same loop as above to seek `elem` from the start - while ( ( node = ++nodeIndex && node && node[ dir ] || - ( diff = nodeIndex = 0 ) || start.pop() ) ) { - - if ( ( ofType ? - node.nodeName.toLowerCase() === name : - node.nodeType === 1 ) && - ++diff ) { - - // Cache the index of each encountered element - if ( useCache ) { - outerCache = node[ expando ] || - ( node[ expando ] = {} ); - - // Support: IE <9 only - // Defend against cloned attroperties (jQuery gh-1709) - uniqueCache = outerCache[ node.uniqueID ] || - ( outerCache[ node.uniqueID ] = {} ); - - uniqueCache[ type ] = [ dirruns, diff ]; - } - - if ( node === elem ) { - break; - } - } - } - } - } - - // Incorporate the offset, then check against cycle size - diff -= last; - return diff === first || ( diff % first === 0 && diff / first >= 0 ); - } - }; - }, - - "PSEUDO": function( pseudo, argument ) { - - // pseudo-class names are case-insensitive - // http://www.w3.org/TR/selectors/#pseudo-classes - // Prioritize by case sensitivity in case custom pseudos are added with uppercase letters - // Remember that setFilters inherits from pseudos - var args, - fn = Expr.pseudos[ pseudo ] || Expr.setFilters[ pseudo.toLowerCase() ] || - Sizzle.error( "unsupported pseudo: " + pseudo ); - - // The user may use createPseudo to indicate that - // arguments are needed to create the filter function - // just as Sizzle does - if ( fn[ expando ] ) { - return fn( argument ); - } - - // But maintain support for old signatures - if ( fn.length > 1 ) { - args = [ pseudo, pseudo, "", argument ]; - return Expr.setFilters.hasOwnProperty( pseudo.toLowerCase() ) ? - markFunction( function( seed, matches ) { - var idx, - matched = fn( seed, argument ), - i = matched.length; - while ( i-- ) { - idx = indexOf( seed, matched[ i ] ); - seed[ idx ] = !( matches[ idx ] = matched[ i ] ); - } - } ) : - function( elem ) { - return fn( elem, 0, args ); - }; - } - - return fn; - } - }, - - pseudos: { - - // Potentially complex pseudos - "not": markFunction( function( selector ) { - - // Trim the selector passed to compile - // to avoid treating leading and trailing - // spaces as combinators - var input = [], - results = [], - matcher = compile( selector.replace( rtrim, "$1" ) ); - - return matcher[ expando ] ? - markFunction( function( seed, matches, _context, xml ) { - var elem, - unmatched = matcher( seed, null, xml, [] ), - i = seed.length; - - // Match elements unmatched by `matcher` - while ( i-- ) { - if ( ( elem = unmatched[ i ] ) ) { - seed[ i ] = !( matches[ i ] = elem ); - } - } - } ) : - function( elem, _context, xml ) { - input[ 0 ] = elem; - matcher( input, null, xml, results ); - - // Don't keep the element (issue #299) - input[ 0 ] = null; - return !results.pop(); - }; - } ), - - "has": markFunction( function( selector ) { - return function( elem ) { - return Sizzle( selector, elem ).length > 0; - }; - } ), - - "contains": markFunction( function( text ) { - text = text.replace( runescape, funescape ); - return function( elem ) { - return ( elem.textContent || getText( elem ) ).indexOf( text ) > -1; - }; - } ), - - // "Whether an element is represented by a :lang() selector - // is based solely on the element's language value - // being equal to the identifier C, - // or beginning with the identifier C immediately followed by "-". - // The matching of C against the element's language value is performed case-insensitively. - // The identifier C does not have to be a valid language name." - // http://www.w3.org/TR/selectors/#lang-pseudo - "lang": markFunction( function( lang ) { - - // lang value must be a valid identifier - if ( !ridentifier.test( lang || "" ) ) { - Sizzle.error( "unsupported lang: " + lang ); - } - lang = lang.replace( runescape, funescape ).toLowerCase(); - return function( elem ) { - var elemLang; - do { - if ( ( elemLang = documentIsHTML ? - elem.lang : - elem.getAttribute( "xml:lang" ) || elem.getAttribute( "lang" ) ) ) { - - elemLang = elemLang.toLowerCase(); - return elemLang === lang || elemLang.indexOf( lang + "-" ) === 0; - } - } while ( ( elem = elem.parentNode ) && elem.nodeType === 1 ); - return false; - }; - } ), - - // Miscellaneous - "target": function( elem ) { - var hash = window.location && window.location.hash; - return hash && hash.slice( 1 ) === elem.id; - }, - - "root": function( elem ) { - return elem === docElem; - }, - - "focus": function( elem ) { - return elem === document.activeElement && - ( !document.hasFocus || document.hasFocus() ) && - !!( elem.type || elem.href || ~elem.tabIndex ); - }, - - // Boolean properties - "enabled": createDisabledPseudo( false ), - "disabled": createDisabledPseudo( true ), - - "checked": function( elem ) { - - // In CSS3, :checked should return both checked and selected elements - // http://www.w3.org/TR/2011/REC-css3-selectors-20110929/#checked - var nodeName = elem.nodeName.toLowerCase(); - return ( nodeName === "input" && !!elem.checked ) || - ( nodeName === "option" && !!elem.selected ); - }, - - "selected": function( elem ) { - - // Accessing this property makes selected-by-default - // options in Safari work properly - if ( elem.parentNode ) { - // eslint-disable-next-line no-unused-expressions - elem.parentNode.selectedIndex; - } - - return elem.selected === true; - }, - - // Contents - "empty": function( elem ) { - - // http://www.w3.org/TR/selectors/#empty-pseudo - // :empty is negated by element (1) or content nodes (text: 3; cdata: 4; entity ref: 5), - // but not by others (comment: 8; processing instruction: 7; etc.) - // nodeType < 6 works because attributes (2) do not appear as children - for ( elem = elem.firstChild; elem; elem = elem.nextSibling ) { - if ( elem.nodeType < 6 ) { - return false; - } - } - return true; - }, - - "parent": function( elem ) { - return !Expr.pseudos[ "empty" ]( elem ); - }, - - // Element/input types - "header": function( elem ) { - return rheader.test( elem.nodeName ); - }, - - "input": function( elem ) { - return rinputs.test( elem.nodeName ); - }, - - "button": function( elem ) { - var name = elem.nodeName.toLowerCase(); - return name === "input" && elem.type === "button" || name === "button"; - }, - - "text": function( elem ) { - var attr; - return elem.nodeName.toLowerCase() === "input" && - elem.type === "text" && - - // Support: IE<8 - // New HTML5 attribute values (e.g., "search") appear with elem.type === "text" - ( ( attr = elem.getAttribute( "type" ) ) == null || - attr.toLowerCase() === "text" ); - }, - - // Position-in-collection - "first": createPositionalPseudo( function() { - return [ 0 ]; - } ), - - "last": createPositionalPseudo( function( _matchIndexes, length ) { - return [ length - 1 ]; - } ), - - "eq": createPositionalPseudo( function( _matchIndexes, length, argument ) { - return [ argument < 0 ? argument + length : argument ]; - } ), - - "even": createPositionalPseudo( function( matchIndexes, length ) { - var i = 0; - for ( ; i < length; i += 2 ) { - matchIndexes.push( i ); - } - return matchIndexes; - } ), - - "odd": createPositionalPseudo( function( matchIndexes, length ) { - var i = 1; - for ( ; i < length; i += 2 ) { - matchIndexes.push( i ); - } - return matchIndexes; - } ), - - "lt": createPositionalPseudo( function( matchIndexes, length, argument ) { - var i = argument < 0 ? - argument + length : - argument > length ? - length : - argument; - for ( ; --i >= 0; ) { - matchIndexes.push( i ); - } - return matchIndexes; - } ), - - "gt": createPositionalPseudo( function( matchIndexes, length, argument ) { - var i = argument < 0 ? argument + length : argument; - for ( ; ++i < length; ) { - matchIndexes.push( i ); - } - return matchIndexes; - } ) - } -}; - -Expr.pseudos[ "nth" ] = Expr.pseudos[ "eq" ]; - -// Add button/input type pseudos -for ( i in { radio: true, checkbox: true, file: true, password: true, image: true } ) { - Expr.pseudos[ i ] = createInputPseudo( i ); -} -for ( i in { submit: true, reset: true } ) { - Expr.pseudos[ i ] = createButtonPseudo( i ); -} - -// Easy API for creating new setFilters -function setFilters() {} -setFilters.prototype = Expr.filters = Expr.pseudos; -Expr.setFilters = new setFilters(); - -tokenize = Sizzle.tokenize = function( selector, parseOnly ) { - var matched, match, tokens, type, - soFar, groups, preFilters, - cached = tokenCache[ selector + " " ]; - - if ( cached ) { - return parseOnly ? 0 : cached.slice( 0 ); - } - - soFar = selector; - groups = []; - preFilters = Expr.preFilter; - - while ( soFar ) { - - // Comma and first run - if ( !matched || ( match = rcomma.exec( soFar ) ) ) { - if ( match ) { - - // Don't consume trailing commas as valid - soFar = soFar.slice( match[ 0 ].length ) || soFar; - } - groups.push( ( tokens = [] ) ); - } - - matched = false; - - // Combinators - if ( ( match = rcombinators.exec( soFar ) ) ) { - matched = match.shift(); - tokens.push( { - value: matched, - - // Cast descendant combinators to space - type: match[ 0 ].replace( rtrim, " " ) - } ); - soFar = soFar.slice( matched.length ); - } - - // Filters - for ( type in Expr.filter ) { - if ( ( match = matchExpr[ type ].exec( soFar ) ) && ( !preFilters[ type ] || - ( match = preFilters[ type ]( match ) ) ) ) { - matched = match.shift(); - tokens.push( { - value: matched, - type: type, - matches: match - } ); - soFar = soFar.slice( matched.length ); - } - } - - if ( !matched ) { - break; - } - } - - // Return the length of the invalid excess - // if we're just parsing - // Otherwise, throw an error or return tokens - return parseOnly ? - soFar.length : - soFar ? - Sizzle.error( selector ) : - - // Cache the tokens - tokenCache( selector, groups ).slice( 0 ); -}; - -function toSelector( tokens ) { - var i = 0, - len = tokens.length, - selector = ""; - for ( ; i < len; i++ ) { - selector += tokens[ i ].value; - } - return selector; -} - -function addCombinator( matcher, combinator, base ) { - var dir = combinator.dir, - skip = combinator.next, - key = skip || dir, - checkNonElements = base && key === "parentNode", - doneName = done++; - - return combinator.first ? - - // Check against closest ancestor/preceding element - function( elem, context, xml ) { - while ( ( elem = elem[ dir ] ) ) { - if ( elem.nodeType === 1 || checkNonElements ) { - return matcher( elem, context, xml ); - } - } - return false; - } : - - // Check against all ancestor/preceding elements - function( elem, context, xml ) { - var oldCache, uniqueCache, outerCache, - newCache = [ dirruns, doneName ]; - - // We can't set arbitrary data on XML nodes, so they don't benefit from combinator caching - if ( xml ) { - while ( ( elem = elem[ dir ] ) ) { - if ( elem.nodeType === 1 || checkNonElements ) { - if ( matcher( elem, context, xml ) ) { - return true; - } - } - } - } else { - while ( ( elem = elem[ dir ] ) ) { - if ( elem.nodeType === 1 || checkNonElements ) { - outerCache = elem[ expando ] || ( elem[ expando ] = {} ); - - // Support: IE <9 only - // Defend against cloned attroperties (jQuery gh-1709) - uniqueCache = outerCache[ elem.uniqueID ] || - ( outerCache[ elem.uniqueID ] = {} ); - - if ( skip && skip === elem.nodeName.toLowerCase() ) { - elem = elem[ dir ] || elem; - } else if ( ( oldCache = uniqueCache[ key ] ) && - oldCache[ 0 ] === dirruns && oldCache[ 1 ] === doneName ) { - - // Assign to newCache so results back-propagate to previous elements - return ( newCache[ 2 ] = oldCache[ 2 ] ); - } else { - - // Reuse newcache so results back-propagate to previous elements - uniqueCache[ key ] = newCache; - - // A match means we're done; a fail means we have to keep checking - if ( ( newCache[ 2 ] = matcher( elem, context, xml ) ) ) { - return true; - } - } - } - } - } - return false; - }; -} - -function elementMatcher( matchers ) { - return matchers.length > 1 ? - function( elem, context, xml ) { - var i = matchers.length; - while ( i-- ) { - if ( !matchers[ i ]( elem, context, xml ) ) { - return false; - } - } - return true; - } : - matchers[ 0 ]; -} - -function multipleContexts( selector, contexts, results ) { - var i = 0, - len = contexts.length; - for ( ; i < len; i++ ) { - Sizzle( selector, contexts[ i ], results ); - } - return results; -} - -function condense( unmatched, map, filter, context, xml ) { - var elem, - newUnmatched = [], - i = 0, - len = unmatched.length, - mapped = map != null; - - for ( ; i < len; i++ ) { - if ( ( elem = unmatched[ i ] ) ) { - if ( !filter || filter( elem, context, xml ) ) { - newUnmatched.push( elem ); - if ( mapped ) { - map.push( i ); - } - } - } - } - - return newUnmatched; -} - -function setMatcher( preFilter, selector, matcher, postFilter, postFinder, postSelector ) { - if ( postFilter && !postFilter[ expando ] ) { - postFilter = setMatcher( postFilter ); - } - if ( postFinder && !postFinder[ expando ] ) { - postFinder = setMatcher( postFinder, postSelector ); - } - return markFunction( function( seed, results, context, xml ) { - var temp, i, elem, - preMap = [], - postMap = [], - preexisting = results.length, - - // Get initial elements from seed or context - elems = seed || multipleContexts( - selector || "*", - context.nodeType ? [ context ] : context, - [] - ), - - // Prefilter to get matcher input, preserving a map for seed-results synchronization - matcherIn = preFilter && ( seed || !selector ) ? - condense( elems, preMap, preFilter, context, xml ) : - elems, - - matcherOut = matcher ? - - // If we have a postFinder, or filtered seed, or non-seed postFilter or preexisting results, - postFinder || ( seed ? preFilter : preexisting || postFilter ) ? - - // ...intermediate processing is necessary - [] : - - // ...otherwise use results directly - results : - matcherIn; - - // Find primary matches - if ( matcher ) { - matcher( matcherIn, matcherOut, context, xml ); - } - - // Apply postFilter - if ( postFilter ) { - temp = condense( matcherOut, postMap ); - postFilter( temp, [], context, xml ); - - // Un-match failing elements by moving them back to matcherIn - i = temp.length; - while ( i-- ) { - if ( ( elem = temp[ i ] ) ) { - matcherOut[ postMap[ i ] ] = !( matcherIn[ postMap[ i ] ] = elem ); - } - } - } - - if ( seed ) { - if ( postFinder || preFilter ) { - if ( postFinder ) { - - // Get the final matcherOut by condensing this intermediate into postFinder contexts - temp = []; - i = matcherOut.length; - while ( i-- ) { - if ( ( elem = matcherOut[ i ] ) ) { - - // Restore matcherIn since elem is not yet a final match - temp.push( ( matcherIn[ i ] = elem ) ); - } - } - postFinder( null, ( matcherOut = [] ), temp, xml ); - } - - // Move matched elements from seed to results to keep them synchronized - i = matcherOut.length; - while ( i-- ) { - if ( ( elem = matcherOut[ i ] ) && - ( temp = postFinder ? indexOf( seed, elem ) : preMap[ i ] ) > -1 ) { - - seed[ temp ] = !( results[ temp ] = elem ); - } - } - } - - // Add elements to results, through postFinder if defined - } else { - matcherOut = condense( - matcherOut === results ? - matcherOut.splice( preexisting, matcherOut.length ) : - matcherOut - ); - if ( postFinder ) { - postFinder( null, results, matcherOut, xml ); - } else { - push.apply( results, matcherOut ); - } - } - } ); -} - -function matcherFromTokens( tokens ) { - var checkContext, matcher, j, - len = tokens.length, - leadingRelative = Expr.relative[ tokens[ 0 ].type ], - implicitRelative = leadingRelative || Expr.relative[ " " ], - i = leadingRelative ? 1 : 0, - - // The foundational matcher ensures that elements are reachable from top-level context(s) - matchContext = addCombinator( function( elem ) { - return elem === checkContext; - }, implicitRelative, true ), - matchAnyContext = addCombinator( function( elem ) { - return indexOf( checkContext, elem ) > -1; - }, implicitRelative, true ), - matchers = [ function( elem, context, xml ) { - var ret = ( !leadingRelative && ( xml || context !== outermostContext ) ) || ( - ( checkContext = context ).nodeType ? - matchContext( elem, context, xml ) : - matchAnyContext( elem, context, xml ) ); - - // Avoid hanging onto element (issue #299) - checkContext = null; - return ret; - } ]; - - for ( ; i < len; i++ ) { - if ( ( matcher = Expr.relative[ tokens[ i ].type ] ) ) { - matchers = [ addCombinator( elementMatcher( matchers ), matcher ) ]; - } else { - matcher = Expr.filter[ tokens[ i ].type ].apply( null, tokens[ i ].matches ); - - // Return special upon seeing a positional matcher - if ( matcher[ expando ] ) { - - // Find the next relative operator (if any) for proper handling - j = ++i; - for ( ; j < len; j++ ) { - if ( Expr.relative[ tokens[ j ].type ] ) { - break; - } - } - return setMatcher( - i > 1 && elementMatcher( matchers ), - i > 1 && toSelector( - - // If the preceding token was a descendant combinator, insert an implicit any-element `*` - tokens - .slice( 0, i - 1 ) - .concat( { value: tokens[ i - 2 ].type === " " ? "*" : "" } ) - ).replace( rtrim, "$1" ), - matcher, - i < j && matcherFromTokens( tokens.slice( i, j ) ), - j < len && matcherFromTokens( ( tokens = tokens.slice( j ) ) ), - j < len && toSelector( tokens ) - ); - } - matchers.push( matcher ); - } - } - - return elementMatcher( matchers ); -} - -function matcherFromGroupMatchers( elementMatchers, setMatchers ) { - var bySet = setMatchers.length > 0, - byElement = elementMatchers.length > 0, - superMatcher = function( seed, context, xml, results, outermost ) { - var elem, j, matcher, - matchedCount = 0, - i = "0", - unmatched = seed && [], - setMatched = [], - contextBackup = outermostContext, - - // We must always have either seed elements or outermost context - elems = seed || byElement && Expr.find[ "TAG" ]( "*", outermost ), - - // Use integer dirruns iff this is the outermost matcher - dirrunsUnique = ( dirruns += contextBackup == null ? 1 : Math.random() || 0.1 ), - len = elems.length; - - if ( outermost ) { - - // Support: IE 11+, Edge 17 - 18+ - // IE/Edge sometimes throw a "Permission denied" error when strict-comparing - // two documents; shallow comparisons work. - // eslint-disable-next-line eqeqeq - outermostContext = context == document || context || outermost; - } - - // Add elements passing elementMatchers directly to results - // Support: IE<9, Safari - // Tolerate NodeList properties (IE: "length"; Safari: ) matching elements by id - for ( ; i !== len && ( elem = elems[ i ] ) != null; i++ ) { - if ( byElement && elem ) { - j = 0; - - // Support: IE 11+, Edge 17 - 18+ - // IE/Edge sometimes throw a "Permission denied" error when strict-comparing - // two documents; shallow comparisons work. - // eslint-disable-next-line eqeqeq - if ( !context && elem.ownerDocument != document ) { - setDocument( elem ); - xml = !documentIsHTML; - } - while ( ( matcher = elementMatchers[ j++ ] ) ) { - if ( matcher( elem, context || document, xml ) ) { - results.push( elem ); - break; - } - } - if ( outermost ) { - dirruns = dirrunsUnique; - } - } - - // Track unmatched elements for set filters - if ( bySet ) { - - // They will have gone through all possible matchers - if ( ( elem = !matcher && elem ) ) { - matchedCount--; - } - - // Lengthen the array for every element, matched or not - if ( seed ) { - unmatched.push( elem ); - } - } - } - - // `i` is now the count of elements visited above, and adding it to `matchedCount` - // makes the latter nonnegative. - matchedCount += i; - - // Apply set filters to unmatched elements - // NOTE: This can be skipped if there are no unmatched elements (i.e., `matchedCount` - // equals `i`), unless we didn't visit _any_ elements in the above loop because we have - // no element matchers and no seed. - // Incrementing an initially-string "0" `i` allows `i` to remain a string only in that - // case, which will result in a "00" `matchedCount` that differs from `i` but is also - // numerically zero. - if ( bySet && i !== matchedCount ) { - j = 0; - while ( ( matcher = setMatchers[ j++ ] ) ) { - matcher( unmatched, setMatched, context, xml ); - } - - if ( seed ) { - - // Reintegrate element matches to eliminate the need for sorting - if ( matchedCount > 0 ) { - while ( i-- ) { - if ( !( unmatched[ i ] || setMatched[ i ] ) ) { - setMatched[ i ] = pop.call( results ); - } - } - } - - // Discard index placeholder values to get only actual matches - setMatched = condense( setMatched ); - } - - // Add matches to results - push.apply( results, setMatched ); - - // Seedless set matches succeeding multiple successful matchers stipulate sorting - if ( outermost && !seed && setMatched.length > 0 && - ( matchedCount + setMatchers.length ) > 1 ) { - - Sizzle.uniqueSort( results ); - } - } - - // Override manipulation of globals by nested matchers - if ( outermost ) { - dirruns = dirrunsUnique; - outermostContext = contextBackup; - } - - return unmatched; - }; - - return bySet ? - markFunction( superMatcher ) : - superMatcher; -} - -compile = Sizzle.compile = function( selector, match /* Internal Use Only */ ) { - var i, - setMatchers = [], - elementMatchers = [], - cached = compilerCache[ selector + " " ]; - - if ( !cached ) { - - // Generate a function of recursive functions that can be used to check each element - if ( !match ) { - match = tokenize( selector ); - } - i = match.length; - while ( i-- ) { - cached = matcherFromTokens( match[ i ] ); - if ( cached[ expando ] ) { - setMatchers.push( cached ); - } else { - elementMatchers.push( cached ); - } - } - - // Cache the compiled function - cached = compilerCache( - selector, - matcherFromGroupMatchers( elementMatchers, setMatchers ) - ); - - // Save selector and tokenization - cached.selector = selector; - } - return cached; -}; - -/** - * A low-level selection function that works with Sizzle's compiled - * selector functions - * @param {String|Function} selector A selector or a pre-compiled - * selector function built with Sizzle.compile - * @param {Element} context - * @param {Array} [results] - * @param {Array} [seed] A set of elements to match against - */ -select = Sizzle.select = function( selector, context, results, seed ) { - var i, tokens, token, type, find, - compiled = typeof selector === "function" && selector, - match = !seed && tokenize( ( selector = compiled.selector || selector ) ); - - results = results || []; - - // Try to minimize operations if there is only one selector in the list and no seed - // (the latter of which guarantees us context) - if ( match.length === 1 ) { - - // Reduce context if the leading compound selector is an ID - tokens = match[ 0 ] = match[ 0 ].slice( 0 ); - if ( tokens.length > 2 && ( token = tokens[ 0 ] ).type === "ID" && - context.nodeType === 9 && documentIsHTML && Expr.relative[ tokens[ 1 ].type ] ) { - - context = ( Expr.find[ "ID" ]( token.matches[ 0 ] - .replace( runescape, funescape ), context ) || [] )[ 0 ]; - if ( !context ) { - return results; - - // Precompiled matchers will still verify ancestry, so step up a level - } else if ( compiled ) { - context = context.parentNode; - } - - selector = selector.slice( tokens.shift().value.length ); - } - - // Fetch a seed set for right-to-left matching - i = matchExpr[ "needsContext" ].test( selector ) ? 0 : tokens.length; - while ( i-- ) { - token = tokens[ i ]; - - // Abort if we hit a combinator - if ( Expr.relative[ ( type = token.type ) ] ) { - break; - } - if ( ( find = Expr.find[ type ] ) ) { - - // Search, expanding context for leading sibling combinators - if ( ( seed = find( - token.matches[ 0 ].replace( runescape, funescape ), - rsibling.test( tokens[ 0 ].type ) && testContext( context.parentNode ) || - context - ) ) ) { - - // If seed is empty or no tokens remain, we can return early - tokens.splice( i, 1 ); - selector = seed.length && toSelector( tokens ); - if ( !selector ) { - push.apply( results, seed ); - return results; - } - - break; - } - } - } - } - - // Compile and execute a filtering function if one is not provided - // Provide `match` to avoid retokenization if we modified the selector above - ( compiled || compile( selector, match ) )( - seed, - context, - !documentIsHTML, - results, - !context || rsibling.test( selector ) && testContext( context.parentNode ) || context - ); - return results; -}; - -// One-time assignments - -// Sort stability -support.sortStable = expando.split( "" ).sort( sortOrder ).join( "" ) === expando; - -// Support: Chrome 14-35+ -// Always assume duplicates if they aren't passed to the comparison function -support.detectDuplicates = !!hasDuplicate; - -// Initialize against the default document -setDocument(); - -// Support: Webkit<537.32 - Safari 6.0.3/Chrome 25 (fixed in Chrome 27) -// Detached nodes confoundingly follow *each other* -support.sortDetached = assert( function( el ) { - - // Should return 1, but returns 4 (following) - return el.compareDocumentPosition( document.createElement( "fieldset" ) ) & 1; -} ); - -// Support: IE<8 -// Prevent attribute/property "interpolation" -// https://msdn.microsoft.com/en-us/library/ms536429%28VS.85%29.aspx -if ( !assert( function( el ) { - el.innerHTML = ""; - return el.firstChild.getAttribute( "href" ) === "#"; -} ) ) { - addHandle( "type|href|height|width", function( elem, name, isXML ) { - if ( !isXML ) { - return elem.getAttribute( name, name.toLowerCase() === "type" ? 1 : 2 ); - } - } ); -} - -// Support: IE<9 -// Use defaultValue in place of getAttribute("value") -if ( !support.attributes || !assert( function( el ) { - el.innerHTML = ""; - el.firstChild.setAttribute( "value", "" ); - return el.firstChild.getAttribute( "value" ) === ""; -} ) ) { - addHandle( "value", function( elem, _name, isXML ) { - if ( !isXML && elem.nodeName.toLowerCase() === "input" ) { - return elem.defaultValue; - } - } ); -} - -// Support: IE<9 -// Use getAttributeNode to fetch booleans when getAttribute lies -if ( !assert( function( el ) { - return el.getAttribute( "disabled" ) == null; -} ) ) { - addHandle( booleans, function( elem, name, isXML ) { - var val; - if ( !isXML ) { - return elem[ name ] === true ? name.toLowerCase() : - ( val = elem.getAttributeNode( name ) ) && val.specified ? - val.value : - null; - } - } ); -} - -return Sizzle; - -} )( window ); - - - -jQuery.find = Sizzle; -jQuery.expr = Sizzle.selectors; - -// Deprecated -jQuery.expr[ ":" ] = jQuery.expr.pseudos; -jQuery.uniqueSort = jQuery.unique = Sizzle.uniqueSort; -jQuery.text = Sizzle.getText; -jQuery.isXMLDoc = Sizzle.isXML; -jQuery.contains = Sizzle.contains; -jQuery.escapeSelector = Sizzle.escape; - - - - -var dir = function( elem, dir, until ) { - var matched = [], - truncate = until !== undefined; - - while ( ( elem = elem[ dir ] ) && elem.nodeType !== 9 ) { - if ( elem.nodeType === 1 ) { - if ( truncate && jQuery( elem ).is( until ) ) { - break; - } - matched.push( elem ); - } - } - return matched; -}; - - -var siblings = function( n, elem ) { - var matched = []; - - for ( ; n; n = n.nextSibling ) { - if ( n.nodeType === 1 && n !== elem ) { - matched.push( n ); - } - } - - return matched; -}; - - -var rneedsContext = jQuery.expr.match.needsContext; - - - -function nodeName( elem, name ) { - - return elem.nodeName && elem.nodeName.toLowerCase() === name.toLowerCase(); - -}; -var rsingleTag = ( /^<([a-z][^\/\0>:\x20\t\r\n\f]*)[\x20\t\r\n\f]*\/?>(?:<\/\1>|)$/i ); - - - -// Implement the identical functionality for filter and not -function winnow( elements, qualifier, not ) { - if ( isFunction( qualifier ) ) { - return jQuery.grep( elements, function( elem, i ) { - return !!qualifier.call( elem, i, elem ) !== not; - } ); - } - - // Single element - if ( qualifier.nodeType ) { - return jQuery.grep( elements, function( elem ) { - return ( elem === qualifier ) !== not; - } ); - } - - // Arraylike of elements (jQuery, arguments, Array) - if ( typeof qualifier !== "string" ) { - return jQuery.grep( elements, function( elem ) { - return ( indexOf.call( qualifier, elem ) > -1 ) !== not; - } ); - } - - // Filtered directly for both simple and complex selectors - return jQuery.filter( qualifier, elements, not ); -} - -jQuery.filter = function( expr, elems, not ) { - var elem = elems[ 0 ]; - - if ( not ) { - expr = ":not(" + expr + ")"; - } - - if ( elems.length === 1 && elem.nodeType === 1 ) { - return jQuery.find.matchesSelector( elem, expr ) ? [ elem ] : []; - } - - return jQuery.find.matches( expr, jQuery.grep( elems, function( elem ) { - return elem.nodeType === 1; - } ) ); -}; - -jQuery.fn.extend( { - find: function( selector ) { - var i, ret, - len = this.length, - self = this; - - if ( typeof selector !== "string" ) { - return this.pushStack( jQuery( selector ).filter( function() { - for ( i = 0; i < len; i++ ) { - if ( jQuery.contains( self[ i ], this ) ) { - return true; - } - } - } ) ); - } - - ret = this.pushStack( [] ); - - for ( i = 0; i < len; i++ ) { - jQuery.find( selector, self[ i ], ret ); - } - - return len > 1 ? jQuery.uniqueSort( ret ) : ret; - }, - filter: function( selector ) { - return this.pushStack( winnow( this, selector || [], false ) ); - }, - not: function( selector ) { - return this.pushStack( winnow( this, selector || [], true ) ); - }, - is: function( selector ) { - return !!winnow( - this, - - // If this is a positional/relative selector, check membership in the returned set - // so $("p:first").is("p:last") won't return true for a doc with two "p". - typeof selector === "string" && rneedsContext.test( selector ) ? - jQuery( selector ) : - selector || [], - false - ).length; - } -} ); - - -// Initialize a jQuery object - - -// A central reference to the root jQuery(document) -var rootjQuery, - - // A simple way to check for HTML strings - // Prioritize #id over to avoid XSS via location.hash (#9521) - // Strict HTML recognition (#11290: must start with <) - // Shortcut simple #id case for speed - rquickExpr = /^(?:\s*(<[\w\W]+>)[^>]*|#([\w-]+))$/, - - init = jQuery.fn.init = function( selector, context, root ) { - var match, elem; - - // HANDLE: $(""), $(null), $(undefined), $(false) - if ( !selector ) { - return this; - } - - // Method init() accepts an alternate rootjQuery - // so migrate can support jQuery.sub (gh-2101) - root = root || rootjQuery; - - // Handle HTML strings - if ( typeof selector === "string" ) { - if ( selector[ 0 ] === "<" && - selector[ selector.length - 1 ] === ">" && - selector.length >= 3 ) { - - // Assume that strings that start and end with <> are HTML and skip the regex check - match = [ null, selector, null ]; - - } else { - match = rquickExpr.exec( selector ); - } - - // Match html or make sure no context is specified for #id - if ( match && ( match[ 1 ] || !context ) ) { - - // HANDLE: $(html) -> $(array) - if ( match[ 1 ] ) { - context = context instanceof jQuery ? context[ 0 ] : context; - - // Option to run scripts is true for back-compat - // Intentionally let the error be thrown if parseHTML is not present - jQuery.merge( this, jQuery.parseHTML( - match[ 1 ], - context && context.nodeType ? context.ownerDocument || context : document, - true - ) ); - - // HANDLE: $(html, props) - if ( rsingleTag.test( match[ 1 ] ) && jQuery.isPlainObject( context ) ) { - for ( match in context ) { - - // Properties of context are called as methods if possible - if ( isFunction( this[ match ] ) ) { - this[ match ]( context[ match ] ); - - // ...and otherwise set as attributes - } else { - this.attr( match, context[ match ] ); - } - } - } - - return this; - - // HANDLE: $(#id) - } else { - elem = document.getElementById( match[ 2 ] ); - - if ( elem ) { - - // Inject the element directly into the jQuery object - this[ 0 ] = elem; - this.length = 1; - } - return this; - } - - // HANDLE: $(expr, $(...)) - } else if ( !context || context.jquery ) { - return ( context || root ).find( selector ); - - // HANDLE: $(expr, context) - // (which is just equivalent to: $(context).find(expr) - } else { - return this.constructor( context ).find( selector ); - } - - // HANDLE: $(DOMElement) - } else if ( selector.nodeType ) { - this[ 0 ] = selector; - this.length = 1; - return this; - - // HANDLE: $(function) - // Shortcut for document ready - } else if ( isFunction( selector ) ) { - return root.ready !== undefined ? - root.ready( selector ) : - - // Execute immediately if ready is not present - selector( jQuery ); - } - - return jQuery.makeArray( selector, this ); - }; - -// Give the init function the jQuery prototype for later instantiation -init.prototype = jQuery.fn; - -// Initialize central reference -rootjQuery = jQuery( document ); - - -var rparentsprev = /^(?:parents|prev(?:Until|All))/, - - // Methods guaranteed to produce a unique set when starting from a unique set - guaranteedUnique = { - children: true, - contents: true, - next: true, - prev: true - }; - -jQuery.fn.extend( { - has: function( target ) { - var targets = jQuery( target, this ), - l = targets.length; - - return this.filter( function() { - var i = 0; - for ( ; i < l; i++ ) { - if ( jQuery.contains( this, targets[ i ] ) ) { - return true; - } - } - } ); - }, - - closest: function( selectors, context ) { - var cur, - i = 0, - l = this.length, - matched = [], - targets = typeof selectors !== "string" && jQuery( selectors ); - - // Positional selectors never match, since there's no _selection_ context - if ( !rneedsContext.test( selectors ) ) { - for ( ; i < l; i++ ) { - for ( cur = this[ i ]; cur && cur !== context; cur = cur.parentNode ) { - - // Always skip document fragments - if ( cur.nodeType < 11 && ( targets ? - targets.index( cur ) > -1 : - - // Don't pass non-elements to Sizzle - cur.nodeType === 1 && - jQuery.find.matchesSelector( cur, selectors ) ) ) { - - matched.push( cur ); - break; - } - } - } - } - - return this.pushStack( matched.length > 1 ? jQuery.uniqueSort( matched ) : matched ); - }, - - // Determine the position of an element within the set - index: function( elem ) { - - // No argument, return index in parent - if ( !elem ) { - return ( this[ 0 ] && this[ 0 ].parentNode ) ? this.first().prevAll().length : -1; - } - - // Index in selector - if ( typeof elem === "string" ) { - return indexOf.call( jQuery( elem ), this[ 0 ] ); - } - - // Locate the position of the desired element - return indexOf.call( this, - - // If it receives a jQuery object, the first element is used - elem.jquery ? elem[ 0 ] : elem - ); - }, - - add: function( selector, context ) { - return this.pushStack( - jQuery.uniqueSort( - jQuery.merge( this.get(), jQuery( selector, context ) ) - ) - ); - }, - - addBack: function( selector ) { - return this.add( selector == null ? - this.prevObject : this.prevObject.filter( selector ) - ); - } -} ); - -function sibling( cur, dir ) { - while ( ( cur = cur[ dir ] ) && cur.nodeType !== 1 ) {} - return cur; -} - -jQuery.each( { - parent: function( elem ) { - var parent = elem.parentNode; - return parent && parent.nodeType !== 11 ? parent : null; - }, - parents: function( elem ) { - return dir( elem, "parentNode" ); - }, - parentsUntil: function( elem, _i, until ) { - return dir( elem, "parentNode", until ); - }, - next: function( elem ) { - return sibling( elem, "nextSibling" ); - }, - prev: function( elem ) { - return sibling( elem, "previousSibling" ); - }, - nextAll: function( elem ) { - return dir( elem, "nextSibling" ); - }, - prevAll: function( elem ) { - return dir( elem, "previousSibling" ); - }, - nextUntil: function( elem, _i, until ) { - return dir( elem, "nextSibling", until ); - }, - prevUntil: function( elem, _i, until ) { - return dir( elem, "previousSibling", until ); - }, - siblings: function( elem ) { - return siblings( ( elem.parentNode || {} ).firstChild, elem ); - }, - children: function( elem ) { - return siblings( elem.firstChild ); - }, - contents: function( elem ) { - if ( elem.contentDocument != null && - - // Support: IE 11+ - // elements with no `data` attribute has an object - // `contentDocument` with a `null` prototype. - getProto( elem.contentDocument ) ) { - - return elem.contentDocument; - } - - // Support: IE 9 - 11 only, iOS 7 only, Android Browser <=4.3 only - // Treat the template element as a regular one in browsers that - // don't support it. - if ( nodeName( elem, "template" ) ) { - elem = elem.content || elem; - } - - return jQuery.merge( [], elem.childNodes ); - } -}, function( name, fn ) { - jQuery.fn[ name ] = function( until, selector ) { - var matched = jQuery.map( this, fn, until ); - - if ( name.slice( -5 ) !== "Until" ) { - selector = until; - } - - if ( selector && typeof selector === "string" ) { - matched = jQuery.filter( selector, matched ); - } - - if ( this.length > 1 ) { - - // Remove duplicates - if ( !guaranteedUnique[ name ] ) { - jQuery.uniqueSort( matched ); - } - - // Reverse order for parents* and prev-derivatives - if ( rparentsprev.test( name ) ) { - matched.reverse(); - } - } - - return this.pushStack( matched ); - }; -} ); -var rnothtmlwhite = ( /[^\x20\t\r\n\f]+/g ); - - - -// Convert String-formatted options into Object-formatted ones -function createOptions( options ) { - var object = {}; - jQuery.each( options.match( rnothtmlwhite ) || [], function( _, flag ) { - object[ flag ] = true; - } ); - return object; -} - -/* - * Create a callback list using the following parameters: - * - * options: an optional list of space-separated options that will change how - * the callback list behaves or a more traditional option object - * - * By default a callback list will act like an event callback list and can be - * "fired" multiple times. - * - * Possible options: - * - * once: will ensure the callback list can only be fired once (like a Deferred) - * - * memory: will keep track of previous values and will call any callback added - * after the list has been fired right away with the latest "memorized" - * values (like a Deferred) - * - * unique: will ensure a callback can only be added once (no duplicate in the list) - * - * stopOnFalse: interrupt callings when a callback returns false - * - */ -jQuery.Callbacks = function( options ) { - - // Convert options from String-formatted to Object-formatted if needed - // (we check in cache first) - options = typeof options === "string" ? - createOptions( options ) : - jQuery.extend( {}, options ); - - var // Flag to know if list is currently firing - firing, - - // Last fire value for non-forgettable lists - memory, - - // Flag to know if list was already fired - fired, - - // Flag to prevent firing - locked, - - // Actual callback list - list = [], - - // Queue of execution data for repeatable lists - queue = [], - - // Index of currently firing callback (modified by add/remove as needed) - firingIndex = -1, - - // Fire callbacks - fire = function() { - - // Enforce single-firing - locked = locked || options.once; - - // Execute callbacks for all pending executions, - // respecting firingIndex overrides and runtime changes - fired = firing = true; - for ( ; queue.length; firingIndex = -1 ) { - memory = queue.shift(); - while ( ++firingIndex < list.length ) { - - // Run callback and check for early termination - if ( list[ firingIndex ].apply( memory[ 0 ], memory[ 1 ] ) === false && - options.stopOnFalse ) { - - // Jump to end and forget the data so .add doesn't re-fire - firingIndex = list.length; - memory = false; - } - } - } - - // Forget the data if we're done with it - if ( !options.memory ) { - memory = false; - } - - firing = false; - - // Clean up if we're done firing for good - if ( locked ) { - - // Keep an empty list if we have data for future add calls - if ( memory ) { - list = []; - - // Otherwise, this object is spent - } else { - list = ""; - } - } - }, - - // Actual Callbacks object - self = { - - // Add a callback or a collection of callbacks to the list - add: function() { - if ( list ) { - - // If we have memory from a past run, we should fire after adding - if ( memory && !firing ) { - firingIndex = list.length - 1; - queue.push( memory ); - } - - ( function add( args ) { - jQuery.each( args, function( _, arg ) { - if ( isFunction( arg ) ) { - if ( !options.unique || !self.has( arg ) ) { - list.push( arg ); - } - } else if ( arg && arg.length && toType( arg ) !== "string" ) { - - // Inspect recursively - add( arg ); - } - } ); - } )( arguments ); - - if ( memory && !firing ) { - fire(); - } - } - return this; - }, - - // Remove a callback from the list - remove: function() { - jQuery.each( arguments, function( _, arg ) { - var index; - while ( ( index = jQuery.inArray( arg, list, index ) ) > -1 ) { - list.splice( index, 1 ); - - // Handle firing indexes - if ( index <= firingIndex ) { - firingIndex--; - } - } - } ); - return this; - }, - - // Check if a given callback is in the list. - // If no argument is given, return whether or not list has callbacks attached. - has: function( fn ) { - return fn ? - jQuery.inArray( fn, list ) > -1 : - list.length > 0; - }, - - // Remove all callbacks from the list - empty: function() { - if ( list ) { - list = []; - } - return this; - }, - - // Disable .fire and .add - // Abort any current/pending executions - // Clear all callbacks and values - disable: function() { - locked = queue = []; - list = memory = ""; - return this; - }, - disabled: function() { - return !list; - }, - - // Disable .fire - // Also disable .add unless we have memory (since it would have no effect) - // Abort any pending executions - lock: function() { - locked = queue = []; - if ( !memory && !firing ) { - list = memory = ""; - } - return this; - }, - locked: function() { - return !!locked; - }, - - // Call all callbacks with the given context and arguments - fireWith: function( context, args ) { - if ( !locked ) { - args = args || []; - args = [ context, args.slice ? args.slice() : args ]; - queue.push( args ); - if ( !firing ) { - fire(); - } - } - return this; - }, - - // Call all the callbacks with the given arguments - fire: function() { - self.fireWith( this, arguments ); - return this; - }, - - // To know if the callbacks have already been called at least once - fired: function() { - return !!fired; - } - }; - - return self; -}; - - -function Identity( v ) { - return v; -} -function Thrower( ex ) { - throw ex; -} - -function adoptValue( value, resolve, reject, noValue ) { - var method; - - try { - - // Check for promise aspect first to privilege synchronous behavior - if ( value && isFunction( ( method = value.promise ) ) ) { - method.call( value ).done( resolve ).fail( reject ); - - // Other thenables - } else if ( value && isFunction( ( method = value.then ) ) ) { - method.call( value, resolve, reject ); - - // Other non-thenables - } else { - - // Control `resolve` arguments by letting Array#slice cast boolean `noValue` to integer: - // * false: [ value ].slice( 0 ) => resolve( value ) - // * true: [ value ].slice( 1 ) => resolve() - resolve.apply( undefined, [ value ].slice( noValue ) ); - } - - // For Promises/A+, convert exceptions into rejections - // Since jQuery.when doesn't unwrap thenables, we can skip the extra checks appearing in - // Deferred#then to conditionally suppress rejection. - } catch ( value ) { - - // Support: Android 4.0 only - // Strict mode functions invoked without .call/.apply get global-object context - reject.apply( undefined, [ value ] ); - } -} - -jQuery.extend( { - - Deferred: function( func ) { - var tuples = [ - - // action, add listener, callbacks, - // ... .then handlers, argument index, [final state] - [ "notify", "progress", jQuery.Callbacks( "memory" ), - jQuery.Callbacks( "memory" ), 2 ], - [ "resolve", "done", jQuery.Callbacks( "once memory" ), - jQuery.Callbacks( "once memory" ), 0, "resolved" ], - [ "reject", "fail", jQuery.Callbacks( "once memory" ), - jQuery.Callbacks( "once memory" ), 1, "rejected" ] - ], - state = "pending", - promise = { - state: function() { - return state; - }, - always: function() { - deferred.done( arguments ).fail( arguments ); - return this; - }, - "catch": function( fn ) { - return promise.then( null, fn ); - }, - - // Keep pipe for back-compat - pipe: function( /* fnDone, fnFail, fnProgress */ ) { - var fns = arguments; - - return jQuery.Deferred( function( newDefer ) { - jQuery.each( tuples, function( _i, tuple ) { - - // Map tuples (progress, done, fail) to arguments (done, fail, progress) - var fn = isFunction( fns[ tuple[ 4 ] ] ) && fns[ tuple[ 4 ] ]; - - // deferred.progress(function() { bind to newDefer or newDefer.notify }) - // deferred.done(function() { bind to newDefer or newDefer.resolve }) - // deferred.fail(function() { bind to newDefer or newDefer.reject }) - deferred[ tuple[ 1 ] ]( function() { - var returned = fn && fn.apply( this, arguments ); - if ( returned && isFunction( returned.promise ) ) { - returned.promise() - .progress( newDefer.notify ) - .done( newDefer.resolve ) - .fail( newDefer.reject ); - } else { - newDefer[ tuple[ 0 ] + "With" ]( - this, - fn ? [ returned ] : arguments - ); - } - } ); - } ); - fns = null; - } ).promise(); - }, - then: function( onFulfilled, onRejected, onProgress ) { - var maxDepth = 0; - function resolve( depth, deferred, handler, special ) { - return function() { - var that = this, - args = arguments, - mightThrow = function() { - var returned, then; - - // Support: Promises/A+ section 2.3.3.3.3 - // https://promisesaplus.com/#point-59 - // Ignore double-resolution attempts - if ( depth < maxDepth ) { - return; - } - - returned = handler.apply( that, args ); - - // Support: Promises/A+ section 2.3.1 - // https://promisesaplus.com/#point-48 - if ( returned === deferred.promise() ) { - throw new TypeError( "Thenable self-resolution" ); - } - - // Support: Promises/A+ sections 2.3.3.1, 3.5 - // https://promisesaplus.com/#point-54 - // https://promisesaplus.com/#point-75 - // Retrieve `then` only once - then = returned && - - // Support: Promises/A+ section 2.3.4 - // https://promisesaplus.com/#point-64 - // Only check objects and functions for thenability - ( typeof returned === "object" || - typeof returned === "function" ) && - returned.then; - - // Handle a returned thenable - if ( isFunction( then ) ) { - - // Special processors (notify) just wait for resolution - if ( special ) { - then.call( - returned, - resolve( maxDepth, deferred, Identity, special ), - resolve( maxDepth, deferred, Thrower, special ) - ); - - // Normal processors (resolve) also hook into progress - } else { - - // ...and disregard older resolution values - maxDepth++; - - then.call( - returned, - resolve( maxDepth, deferred, Identity, special ), - resolve( maxDepth, deferred, Thrower, special ), - resolve( maxDepth, deferred, Identity, - deferred.notifyWith ) - ); - } - - // Handle all other returned values - } else { - - // Only substitute handlers pass on context - // and multiple values (non-spec behavior) - if ( handler !== Identity ) { - that = undefined; - args = [ returned ]; - } - - // Process the value(s) - // Default process is resolve - ( special || deferred.resolveWith )( that, args ); - } - }, - - // Only normal processors (resolve) catch and reject exceptions - process = special ? - mightThrow : - function() { - try { - mightThrow(); - } catch ( e ) { - - if ( jQuery.Deferred.exceptionHook ) { - jQuery.Deferred.exceptionHook( e, - process.stackTrace ); - } - - // Support: Promises/A+ section 2.3.3.3.4.1 - // https://promisesaplus.com/#point-61 - // Ignore post-resolution exceptions - if ( depth + 1 >= maxDepth ) { - - // Only substitute handlers pass on context - // and multiple values (non-spec behavior) - if ( handler !== Thrower ) { - that = undefined; - args = [ e ]; - } - - deferred.rejectWith( that, args ); - } - } - }; - - // Support: Promises/A+ section 2.3.3.3.1 - // https://promisesaplus.com/#point-57 - // Re-resolve promises immediately to dodge false rejection from - // subsequent errors - if ( depth ) { - process(); - } else { - - // Call an optional hook to record the stack, in case of exception - // since it's otherwise lost when execution goes async - if ( jQuery.Deferred.getStackHook ) { - process.stackTrace = jQuery.Deferred.getStackHook(); - } - window.setTimeout( process ); - } - }; - } - - return jQuery.Deferred( function( newDefer ) { - - // progress_handlers.add( ... ) - tuples[ 0 ][ 3 ].add( - resolve( - 0, - newDefer, - isFunction( onProgress ) ? - onProgress : - Identity, - newDefer.notifyWith - ) - ); - - // fulfilled_handlers.add( ... ) - tuples[ 1 ][ 3 ].add( - resolve( - 0, - newDefer, - isFunction( onFulfilled ) ? - onFulfilled : - Identity - ) - ); - - // rejected_handlers.add( ... ) - tuples[ 2 ][ 3 ].add( - resolve( - 0, - newDefer, - isFunction( onRejected ) ? - onRejected : - Thrower - ) - ); - } ).promise(); - }, - - // Get a promise for this deferred - // If obj is provided, the promise aspect is added to the object - promise: function( obj ) { - return obj != null ? jQuery.extend( obj, promise ) : promise; - } - }, - deferred = {}; - - // Add list-specific methods - jQuery.each( tuples, function( i, tuple ) { - var list = tuple[ 2 ], - stateString = tuple[ 5 ]; - - // promise.progress = list.add - // promise.done = list.add - // promise.fail = list.add - promise[ tuple[ 1 ] ] = list.add; - - // Handle state - if ( stateString ) { - list.add( - function() { - - // state = "resolved" (i.e., fulfilled) - // state = "rejected" - state = stateString; - }, - - // rejected_callbacks.disable - // fulfilled_callbacks.disable - tuples[ 3 - i ][ 2 ].disable, - - // rejected_handlers.disable - // fulfilled_handlers.disable - tuples[ 3 - i ][ 3 ].disable, - - // progress_callbacks.lock - tuples[ 0 ][ 2 ].lock, - - // progress_handlers.lock - tuples[ 0 ][ 3 ].lock - ); - } - - // progress_handlers.fire - // fulfilled_handlers.fire - // rejected_handlers.fire - list.add( tuple[ 3 ].fire ); - - // deferred.notify = function() { deferred.notifyWith(...) } - // deferred.resolve = function() { deferred.resolveWith(...) } - // deferred.reject = function() { deferred.rejectWith(...) } - deferred[ tuple[ 0 ] ] = function() { - deferred[ tuple[ 0 ] + "With" ]( this === deferred ? undefined : this, arguments ); - return this; - }; - - // deferred.notifyWith = list.fireWith - // deferred.resolveWith = list.fireWith - // deferred.rejectWith = list.fireWith - deferred[ tuple[ 0 ] + "With" ] = list.fireWith; - } ); - - // Make the deferred a promise - promise.promise( deferred ); - - // Call given func if any - if ( func ) { - func.call( deferred, deferred ); - } - - // All done! - return deferred; - }, - - // Deferred helper - when: function( singleValue ) { - var - - // count of uncompleted subordinates - remaining = arguments.length, - - // count of unprocessed arguments - i = remaining, - - // subordinate fulfillment data - resolveContexts = Array( i ), - resolveValues = slice.call( arguments ), - - // the master Deferred - master = jQuery.Deferred(), - - // subordinate callback factory - updateFunc = function( i ) { - return function( value ) { - resolveContexts[ i ] = this; - resolveValues[ i ] = arguments.length > 1 ? slice.call( arguments ) : value; - if ( !( --remaining ) ) { - master.resolveWith( resolveContexts, resolveValues ); - } - }; - }; - - // Single- and empty arguments are adopted like Promise.resolve - if ( remaining <= 1 ) { - adoptValue( singleValue, master.done( updateFunc( i ) ).resolve, master.reject, - !remaining ); - - // Use .then() to unwrap secondary thenables (cf. gh-3000) - if ( master.state() === "pending" || - isFunction( resolveValues[ i ] && resolveValues[ i ].then ) ) { - - return master.then(); - } - } - - // Multiple arguments are aggregated like Promise.all array elements - while ( i-- ) { - adoptValue( resolveValues[ i ], updateFunc( i ), master.reject ); - } - - return master.promise(); - } -} ); - - -// These usually indicate a programmer mistake during development, -// warn about them ASAP rather than swallowing them by default. -var rerrorNames = /^(Eval|Internal|Range|Reference|Syntax|Type|URI)Error$/; - -jQuery.Deferred.exceptionHook = function( error, stack ) { - - // Support: IE 8 - 9 only - // Console exists when dev tools are open, which can happen at any time - if ( window.console && window.console.warn && error && rerrorNames.test( error.name ) ) { - window.console.warn( "jQuery.Deferred exception: " + error.message, error.stack, stack ); - } -}; - - - - -jQuery.readyException = function( error ) { - window.setTimeout( function() { - throw error; - } ); -}; - - - - -// The deferred used on DOM ready -var readyList = jQuery.Deferred(); - -jQuery.fn.ready = function( fn ) { - - readyList - .then( fn ) - - // Wrap jQuery.readyException in a function so that the lookup - // happens at the time of error handling instead of callback - // registration. - .catch( function( error ) { - jQuery.readyException( error ); - } ); - - return this; -}; - -jQuery.extend( { - - // Is the DOM ready to be used? Set to true once it occurs. - isReady: false, - - // A counter to track how many items to wait for before - // the ready event fires. See #6781 - readyWait: 1, - - // Handle when the DOM is ready - ready: function( wait ) { - - // Abort if there are pending holds or we're already ready - if ( wait === true ? --jQuery.readyWait : jQuery.isReady ) { - return; - } - - // Remember that the DOM is ready - jQuery.isReady = true; - - // If a normal DOM Ready event fired, decrement, and wait if need be - if ( wait !== true && --jQuery.readyWait > 0 ) { - return; - } - - // If there are functions bound, to execute - readyList.resolveWith( document, [ jQuery ] ); - } -} ); - -jQuery.ready.then = readyList.then; - -// The ready event handler and self cleanup method -function completed() { - document.removeEventListener( "DOMContentLoaded", completed ); - window.removeEventListener( "load", completed ); - jQuery.ready(); -} - -// Catch cases where $(document).ready() is called -// after the browser event has already occurred. -// Support: IE <=9 - 10 only -// Older IE sometimes signals "interactive" too soon -if ( document.readyState === "complete" || - ( document.readyState !== "loading" && !document.documentElement.doScroll ) ) { - - // Handle it asynchronously to allow scripts the opportunity to delay ready - window.setTimeout( jQuery.ready ); - -} else { - - // Use the handy event callback - document.addEventListener( "DOMContentLoaded", completed ); - - // A fallback to window.onload, that will always work - window.addEventListener( "load", completed ); -} - - - - -// Multifunctional method to get and set values of a collection -// The value/s can optionally be executed if it's a function -var access = function( elems, fn, key, value, chainable, emptyGet, raw ) { - var i = 0, - len = elems.length, - bulk = key == null; - - // Sets many values - if ( toType( key ) === "object" ) { - chainable = true; - for ( i in key ) { - access( elems, fn, i, key[ i ], true, emptyGet, raw ); - } - - // Sets one value - } else if ( value !== undefined ) { - chainable = true; - - if ( !isFunction( value ) ) { - raw = true; - } - - if ( bulk ) { - - // Bulk operations run against the entire set - if ( raw ) { - fn.call( elems, value ); - fn = null; - - // ...except when executing function values - } else { - bulk = fn; - fn = function( elem, _key, value ) { - return bulk.call( jQuery( elem ), value ); - }; - } - } - - if ( fn ) { - for ( ; i < len; i++ ) { - fn( - elems[ i ], key, raw ? - value : - value.call( elems[ i ], i, fn( elems[ i ], key ) ) - ); - } - } - } - - if ( chainable ) { - return elems; - } - - // Gets - if ( bulk ) { - return fn.call( elems ); - } - - return len ? fn( elems[ 0 ], key ) : emptyGet; -}; - - -// Matches dashed string for camelizing -var rmsPrefix = /^-ms-/, - rdashAlpha = /-([a-z])/g; - -// Used by camelCase as callback to replace() -function fcamelCase( _all, letter ) { - return letter.toUpperCase(); -} - -// Convert dashed to camelCase; used by the css and data modules -// Support: IE <=9 - 11, Edge 12 - 15 -// Microsoft forgot to hump their vendor prefix (#9572) -function camelCase( string ) { - return string.replace( rmsPrefix, "ms-" ).replace( rdashAlpha, fcamelCase ); -} -var acceptData = function( owner ) { - - // Accepts only: - // - Node - // - Node.ELEMENT_NODE - // - Node.DOCUMENT_NODE - // - Object - // - Any - return owner.nodeType === 1 || owner.nodeType === 9 || !( +owner.nodeType ); -}; - - - - -function Data() { - this.expando = jQuery.expando + Data.uid++; -} - -Data.uid = 1; - -Data.prototype = { - - cache: function( owner ) { - - // Check if the owner object already has a cache - var value = owner[ this.expando ]; - - // If not, create one - if ( !value ) { - value = {}; - - // We can accept data for non-element nodes in modern browsers, - // but we should not, see #8335. - // Always return an empty object. - if ( acceptData( owner ) ) { - - // If it is a node unlikely to be stringify-ed or looped over - // use plain assignment - if ( owner.nodeType ) { - owner[ this.expando ] = value; - - // Otherwise secure it in a non-enumerable property - // configurable must be true to allow the property to be - // deleted when data is removed - } else { - Object.defineProperty( owner, this.expando, { - value: value, - configurable: true - } ); - } - } - } - - return value; - }, - set: function( owner, data, value ) { - var prop, - cache = this.cache( owner ); - - // Handle: [ owner, key, value ] args - // Always use camelCase key (gh-2257) - if ( typeof data === "string" ) { - cache[ camelCase( data ) ] = value; - - // Handle: [ owner, { properties } ] args - } else { - - // Copy the properties one-by-one to the cache object - for ( prop in data ) { - cache[ camelCase( prop ) ] = data[ prop ]; - } - } - return cache; - }, - get: function( owner, key ) { - return key === undefined ? - this.cache( owner ) : - - // Always use camelCase key (gh-2257) - owner[ this.expando ] && owner[ this.expando ][ camelCase( key ) ]; - }, - access: function( owner, key, value ) { - - // In cases where either: - // - // 1. No key was specified - // 2. A string key was specified, but no value provided - // - // Take the "read" path and allow the get method to determine - // which value to return, respectively either: - // - // 1. The entire cache object - // 2. The data stored at the key - // - if ( key === undefined || - ( ( key && typeof key === "string" ) && value === undefined ) ) { - - return this.get( owner, key ); - } - - // When the key is not a string, or both a key and value - // are specified, set or extend (existing objects) with either: - // - // 1. An object of properties - // 2. A key and value - // - this.set( owner, key, value ); - - // Since the "set" path can have two possible entry points - // return the expected data based on which path was taken[*] - return value !== undefined ? value : key; - }, - remove: function( owner, key ) { - var i, - cache = owner[ this.expando ]; - - if ( cache === undefined ) { - return; - } - - if ( key !== undefined ) { - - // Support array or space separated string of keys - if ( Array.isArray( key ) ) { - - // If key is an array of keys... - // We always set camelCase keys, so remove that. - key = key.map( camelCase ); - } else { - key = camelCase( key ); - - // If a key with the spaces exists, use it. - // Otherwise, create an array by matching non-whitespace - key = key in cache ? - [ key ] : - ( key.match( rnothtmlwhite ) || [] ); - } - - i = key.length; - - while ( i-- ) { - delete cache[ key[ i ] ]; - } - } - - // Remove the expando if there's no more data - if ( key === undefined || jQuery.isEmptyObject( cache ) ) { - - // Support: Chrome <=35 - 45 - // Webkit & Blink performance suffers when deleting properties - // from DOM nodes, so set to undefined instead - // https://bugs.chromium.org/p/chromium/issues/detail?id=378607 (bug restricted) - if ( owner.nodeType ) { - owner[ this.expando ] = undefined; - } else { - delete owner[ this.expando ]; - } - } - }, - hasData: function( owner ) { - var cache = owner[ this.expando ]; - return cache !== undefined && !jQuery.isEmptyObject( cache ); - } -}; -var dataPriv = new Data(); - -var dataUser = new Data(); - - - -// Implementation Summary -// -// 1. Enforce API surface and semantic compatibility with 1.9.x branch -// 2. Improve the module's maintainability by reducing the storage -// paths to a single mechanism. -// 3. Use the same single mechanism to support "private" and "user" data. -// 4. _Never_ expose "private" data to user code (TODO: Drop _data, _removeData) -// 5. Avoid exposing implementation details on user objects (eg. expando properties) -// 6. Provide a clear path for implementation upgrade to WeakMap in 2014 - -var rbrace = /^(?:\{[\w\W]*\}|\[[\w\W]*\])$/, - rmultiDash = /[A-Z]/g; - -function getData( data ) { - if ( data === "true" ) { - return true; - } - - if ( data === "false" ) { - return false; - } - - if ( data === "null" ) { - return null; - } - - // Only convert to a number if it doesn't change the string - if ( data === +data + "" ) { - return +data; - } - - if ( rbrace.test( data ) ) { - return JSON.parse( data ); - } - - return data; -} - -function dataAttr( elem, key, data ) { - var name; - - // If nothing was found internally, try to fetch any - // data from the HTML5 data-* attribute - if ( data === undefined && elem.nodeType === 1 ) { - name = "data-" + key.replace( rmultiDash, "-$&" ).toLowerCase(); - data = elem.getAttribute( name ); - - if ( typeof data === "string" ) { - try { - data = getData( data ); - } catch ( e ) {} - - // Make sure we set the data so it isn't changed later - dataUser.set( elem, key, data ); - } else { - data = undefined; - } - } - return data; -} - -jQuery.extend( { - hasData: function( elem ) { - return dataUser.hasData( elem ) || dataPriv.hasData( elem ); - }, - - data: function( elem, name, data ) { - return dataUser.access( elem, name, data ); - }, - - removeData: function( elem, name ) { - dataUser.remove( elem, name ); - }, - - // TODO: Now that all calls to _data and _removeData have been replaced - // with direct calls to dataPriv methods, these can be deprecated. - _data: function( elem, name, data ) { - return dataPriv.access( elem, name, data ); - }, - - _removeData: function( elem, name ) { - dataPriv.remove( elem, name ); - } -} ); - -jQuery.fn.extend( { - data: function( key, value ) { - var i, name, data, - elem = this[ 0 ], - attrs = elem && elem.attributes; - - // Gets all values - if ( key === undefined ) { - if ( this.length ) { - data = dataUser.get( elem ); - - if ( elem.nodeType === 1 && !dataPriv.get( elem, "hasDataAttrs" ) ) { - i = attrs.length; - while ( i-- ) { - - // Support: IE 11 only - // The attrs elements can be null (#14894) - if ( attrs[ i ] ) { - name = attrs[ i ].name; - if ( name.indexOf( "data-" ) === 0 ) { - name = camelCase( name.slice( 5 ) ); - dataAttr( elem, name, data[ name ] ); - } - } - } - dataPriv.set( elem, "hasDataAttrs", true ); - } - } - - return data; - } - - // Sets multiple values - if ( typeof key === "object" ) { - return this.each( function() { - dataUser.set( this, key ); - } ); - } - - return access( this, function( value ) { - var data; - - // The calling jQuery object (element matches) is not empty - // (and therefore has an element appears at this[ 0 ]) and the - // `value` parameter was not undefined. An empty jQuery object - // will result in `undefined` for elem = this[ 0 ] which will - // throw an exception if an attempt to read a data cache is made. - if ( elem && value === undefined ) { - - // Attempt to get data from the cache - // The key will always be camelCased in Data - data = dataUser.get( elem, key ); - if ( data !== undefined ) { - return data; - } - - // Attempt to "discover" the data in - // HTML5 custom data-* attrs - data = dataAttr( elem, key ); - if ( data !== undefined ) { - return data; - } - - // We tried really hard, but the data doesn't exist. - return; - } - - // Set the data... - this.each( function() { - - // We always store the camelCased key - dataUser.set( this, key, value ); - } ); - }, null, value, arguments.length > 1, null, true ); - }, - - removeData: function( key ) { - return this.each( function() { - dataUser.remove( this, key ); - } ); - } -} ); - - -jQuery.extend( { - queue: function( elem, type, data ) { - var queue; - - if ( elem ) { - type = ( type || "fx" ) + "queue"; - queue = dataPriv.get( elem, type ); - - // Speed up dequeue by getting out quickly if this is just a lookup - if ( data ) { - if ( !queue || Array.isArray( data ) ) { - queue = dataPriv.access( elem, type, jQuery.makeArray( data ) ); - } else { - queue.push( data ); - } - } - return queue || []; - } - }, - - dequeue: function( elem, type ) { - type = type || "fx"; - - var queue = jQuery.queue( elem, type ), - startLength = queue.length, - fn = queue.shift(), - hooks = jQuery._queueHooks( elem, type ), - next = function() { - jQuery.dequeue( elem, type ); - }; - - // If the fx queue is dequeued, always remove the progress sentinel - if ( fn === "inprogress" ) { - fn = queue.shift(); - startLength--; - } - - if ( fn ) { - - // Add a progress sentinel to prevent the fx queue from being - // automatically dequeued - if ( type === "fx" ) { - queue.unshift( "inprogress" ); - } - - // Clear up the last queue stop function - delete hooks.stop; - fn.call( elem, next, hooks ); - } - - if ( !startLength && hooks ) { - hooks.empty.fire(); - } - }, - - // Not public - generate a queueHooks object, or return the current one - _queueHooks: function( elem, type ) { - var key = type + "queueHooks"; - return dataPriv.get( elem, key ) || dataPriv.access( elem, key, { - empty: jQuery.Callbacks( "once memory" ).add( function() { - dataPriv.remove( elem, [ type + "queue", key ] ); - } ) - } ); - } -} ); - -jQuery.fn.extend( { - queue: function( type, data ) { - var setter = 2; - - if ( typeof type !== "string" ) { - data = type; - type = "fx"; - setter--; - } - - if ( arguments.length < setter ) { - return jQuery.queue( this[ 0 ], type ); - } - - return data === undefined ? - this : - this.each( function() { - var queue = jQuery.queue( this, type, data ); - - // Ensure a hooks for this queue - jQuery._queueHooks( this, type ); - - if ( type === "fx" && queue[ 0 ] !== "inprogress" ) { - jQuery.dequeue( this, type ); - } - } ); - }, - dequeue: function( type ) { - return this.each( function() { - jQuery.dequeue( this, type ); - } ); - }, - clearQueue: function( type ) { - return this.queue( type || "fx", [] ); - }, - - // Get a promise resolved when queues of a certain type - // are emptied (fx is the type by default) - promise: function( type, obj ) { - var tmp, - count = 1, - defer = jQuery.Deferred(), - elements = this, - i = this.length, - resolve = function() { - if ( !( --count ) ) { - defer.resolveWith( elements, [ elements ] ); - } - }; - - if ( typeof type !== "string" ) { - obj = type; - type = undefined; - } - type = type || "fx"; - - while ( i-- ) { - tmp = dataPriv.get( elements[ i ], type + "queueHooks" ); - if ( tmp && tmp.empty ) { - count++; - tmp.empty.add( resolve ); - } - } - resolve(); - return defer.promise( obj ); - } -} ); -var pnum = ( /[+-]?(?:\d*\.|)\d+(?:[eE][+-]?\d+|)/ ).source; - -var rcssNum = new RegExp( "^(?:([+-])=|)(" + pnum + ")([a-z%]*)$", "i" ); - - -var cssExpand = [ "Top", "Right", "Bottom", "Left" ]; - -var documentElement = document.documentElement; - - - - var isAttached = function( elem ) { - return jQuery.contains( elem.ownerDocument, elem ); - }, - composed = { composed: true }; - - // Support: IE 9 - 11+, Edge 12 - 18+, iOS 10.0 - 10.2 only - // Check attachment across shadow DOM boundaries when possible (gh-3504) - // Support: iOS 10.0-10.2 only - // Early iOS 10 versions support `attachShadow` but not `getRootNode`, - // leading to errors. We need to check for `getRootNode`. - if ( documentElement.getRootNode ) { - isAttached = function( elem ) { - return jQuery.contains( elem.ownerDocument, elem ) || - elem.getRootNode( composed ) === elem.ownerDocument; - }; - } -var isHiddenWithinTree = function( elem, el ) { - - // isHiddenWithinTree might be called from jQuery#filter function; - // in that case, element will be second argument - elem = el || elem; - - // Inline style trumps all - return elem.style.display === "none" || - elem.style.display === "" && - - // Otherwise, check computed style - // Support: Firefox <=43 - 45 - // Disconnected elements can have computed display: none, so first confirm that elem is - // in the document. - isAttached( elem ) && - - jQuery.css( elem, "display" ) === "none"; - }; - - - -function adjustCSS( elem, prop, valueParts, tween ) { - var adjusted, scale, - maxIterations = 20, - currentValue = tween ? - function() { - return tween.cur(); - } : - function() { - return jQuery.css( elem, prop, "" ); - }, - initial = currentValue(), - unit = valueParts && valueParts[ 3 ] || ( jQuery.cssNumber[ prop ] ? "" : "px" ), - - // Starting value computation is required for potential unit mismatches - initialInUnit = elem.nodeType && - ( jQuery.cssNumber[ prop ] || unit !== "px" && +initial ) && - rcssNum.exec( jQuery.css( elem, prop ) ); - - if ( initialInUnit && initialInUnit[ 3 ] !== unit ) { - - // Support: Firefox <=54 - // Halve the iteration target value to prevent interference from CSS upper bounds (gh-2144) - initial = initial / 2; - - // Trust units reported by jQuery.css - unit = unit || initialInUnit[ 3 ]; - - // Iteratively approximate from a nonzero starting point - initialInUnit = +initial || 1; - - while ( maxIterations-- ) { - - // Evaluate and update our best guess (doubling guesses that zero out). - // Finish if the scale equals or crosses 1 (making the old*new product non-positive). - jQuery.style( elem, prop, initialInUnit + unit ); - if ( ( 1 - scale ) * ( 1 - ( scale = currentValue() / initial || 0.5 ) ) <= 0 ) { - maxIterations = 0; - } - initialInUnit = initialInUnit / scale; - - } - - initialInUnit = initialInUnit * 2; - jQuery.style( elem, prop, initialInUnit + unit ); - - // Make sure we update the tween properties later on - valueParts = valueParts || []; - } - - if ( valueParts ) { - initialInUnit = +initialInUnit || +initial || 0; - - // Apply relative offset (+=/-=) if specified - adjusted = valueParts[ 1 ] ? - initialInUnit + ( valueParts[ 1 ] + 1 ) * valueParts[ 2 ] : - +valueParts[ 2 ]; - if ( tween ) { - tween.unit = unit; - tween.start = initialInUnit; - tween.end = adjusted; - } - } - return adjusted; -} - - -var defaultDisplayMap = {}; - -function getDefaultDisplay( elem ) { - var temp, - doc = elem.ownerDocument, - nodeName = elem.nodeName, - display = defaultDisplayMap[ nodeName ]; - - if ( display ) { - return display; - } - - temp = doc.body.appendChild( doc.createElement( nodeName ) ); - display = jQuery.css( temp, "display" ); - - temp.parentNode.removeChild( temp ); - - if ( display === "none" ) { - display = "block"; - } - defaultDisplayMap[ nodeName ] = display; - - return display; -} - -function showHide( elements, show ) { - var display, elem, - values = [], - index = 0, - length = elements.length; - - // Determine new display value for elements that need to change - for ( ; index < length; index++ ) { - elem = elements[ index ]; - if ( !elem.style ) { - continue; - } - - display = elem.style.display; - if ( show ) { - - // Since we force visibility upon cascade-hidden elements, an immediate (and slow) - // check is required in this first loop unless we have a nonempty display value (either - // inline or about-to-be-restored) - if ( display === "none" ) { - values[ index ] = dataPriv.get( elem, "display" ) || null; - if ( !values[ index ] ) { - elem.style.display = ""; - } - } - if ( elem.style.display === "" && isHiddenWithinTree( elem ) ) { - values[ index ] = getDefaultDisplay( elem ); - } - } else { - if ( display !== "none" ) { - values[ index ] = "none"; - - // Remember what we're overwriting - dataPriv.set( elem, "display", display ); - } - } - } - - // Set the display of the elements in a second loop to avoid constant reflow - for ( index = 0; index < length; index++ ) { - if ( values[ index ] != null ) { - elements[ index ].style.display = values[ index ]; - } - } - - return elements; -} - -jQuery.fn.extend( { - show: function() { - return showHide( this, true ); - }, - hide: function() { - return showHide( this ); - }, - toggle: function( state ) { - if ( typeof state === "boolean" ) { - return state ? this.show() : this.hide(); - } - - return this.each( function() { - if ( isHiddenWithinTree( this ) ) { - jQuery( this ).show(); - } else { - jQuery( this ).hide(); - } - } ); - } -} ); -var rcheckableType = ( /^(?:checkbox|radio)$/i ); - -var rtagName = ( /<([a-z][^\/\0>\x20\t\r\n\f]*)/i ); - -var rscriptType = ( /^$|^module$|\/(?:java|ecma)script/i ); - - - -( function() { - var fragment = document.createDocumentFragment(), - div = fragment.appendChild( document.createElement( "div" ) ), - input = document.createElement( "input" ); - - // Support: Android 4.0 - 4.3 only - // Check state lost if the name is set (#11217) - // Support: Windows Web Apps (WWA) - // `name` and `type` must use .setAttribute for WWA (#14901) - input.setAttribute( "type", "radio" ); - input.setAttribute( "checked", "checked" ); - input.setAttribute( "name", "t" ); - - div.appendChild( input ); - - // Support: Android <=4.1 only - // Older WebKit doesn't clone checked state correctly in fragments - support.checkClone = div.cloneNode( true ).cloneNode( true ).lastChild.checked; - - // Support: IE <=11 only - // Make sure textarea (and checkbox) defaultValue is properly cloned - div.innerHTML = ""; - support.noCloneChecked = !!div.cloneNode( true ).lastChild.defaultValue; - - // Support: IE <=9 only - // IE <=9 replaces "; - support.option = !!div.lastChild; -} )(); - - -// We have to close these tags to support XHTML (#13200) -var wrapMap = { - - // XHTML parsers do not magically insert elements in the - // same way that tag soup parsers do. So we cannot shorten - // this by omitting or other required elements. - thead: [ 1, "", "
" ], - col: [ 2, "", "
" ], - tr: [ 2, "", "
" ], - td: [ 3, "", "
" ], - - _default: [ 0, "", "" ] -}; - -wrapMap.tbody = wrapMap.tfoot = wrapMap.colgroup = wrapMap.caption = wrapMap.thead; -wrapMap.th = wrapMap.td; - -// Support: IE <=9 only -if ( !support.option ) { - wrapMap.optgroup = wrapMap.option = [ 1, "" ]; -} - - -function getAll( context, tag ) { - - // Support: IE <=9 - 11 only - // Use typeof to avoid zero-argument method invocation on host objects (#15151) - var ret; - - if ( typeof context.getElementsByTagName !== "undefined" ) { - ret = context.getElementsByTagName( tag || "*" ); - - } else if ( typeof context.querySelectorAll !== "undefined" ) { - ret = context.querySelectorAll( tag || "*" ); - - } else { - ret = []; - } - - if ( tag === undefined || tag && nodeName( context, tag ) ) { - return jQuery.merge( [ context ], ret ); - } - - return ret; -} - - -// Mark scripts as having already been evaluated -function setGlobalEval( elems, refElements ) { - var i = 0, - l = elems.length; - - for ( ; i < l; i++ ) { - dataPriv.set( - elems[ i ], - "globalEval", - !refElements || dataPriv.get( refElements[ i ], "globalEval" ) - ); - } -} - - -var rhtml = /<|&#?\w+;/; - -function buildFragment( elems, context, scripts, selection, ignored ) { - var elem, tmp, tag, wrap, attached, j, - fragment = context.createDocumentFragment(), - nodes = [], - i = 0, - l = elems.length; - - for ( ; i < l; i++ ) { - elem = elems[ i ]; - - if ( elem || elem === 0 ) { - - // Add nodes directly - if ( toType( elem ) === "object" ) { - - // Support: Android <=4.0 only, PhantomJS 1 only - // push.apply(_, arraylike) throws on ancient WebKit - jQuery.merge( nodes, elem.nodeType ? [ elem ] : elem ); - - // Convert non-html into a text node - } else if ( !rhtml.test( elem ) ) { - nodes.push( context.createTextNode( elem ) ); - - // Convert html into DOM nodes - } else { - tmp = tmp || fragment.appendChild( context.createElement( "div" ) ); - - // Deserialize a standard representation - tag = ( rtagName.exec( elem ) || [ "", "" ] )[ 1 ].toLowerCase(); - wrap = wrapMap[ tag ] || wrapMap._default; - tmp.innerHTML = wrap[ 1 ] + jQuery.htmlPrefilter( elem ) + wrap[ 2 ]; - - // Descend through wrappers to the right content - j = wrap[ 0 ]; - while ( j-- ) { - tmp = tmp.lastChild; - } - - // Support: Android <=4.0 only, PhantomJS 1 only - // push.apply(_, arraylike) throws on ancient WebKit - jQuery.merge( nodes, tmp.childNodes ); - - // Remember the top-level container - tmp = fragment.firstChild; - - // Ensure the created nodes are orphaned (#12392) - tmp.textContent = ""; - } - } - } - - // Remove wrapper from fragment - fragment.textContent = ""; - - i = 0; - while ( ( elem = nodes[ i++ ] ) ) { - - // Skip elements already in the context collection (trac-4087) - if ( selection && jQuery.inArray( elem, selection ) > -1 ) { - if ( ignored ) { - ignored.push( elem ); - } - continue; - } - - attached = isAttached( elem ); - - // Append to fragment - tmp = getAll( fragment.appendChild( elem ), "script" ); - - // Preserve script evaluation history - if ( attached ) { - setGlobalEval( tmp ); - } - - // Capture executables - if ( scripts ) { - j = 0; - while ( ( elem = tmp[ j++ ] ) ) { - if ( rscriptType.test( elem.type || "" ) ) { - scripts.push( elem ); - } - } - } - } - - return fragment; -} - - -var - rkeyEvent = /^key/, - rmouseEvent = /^(?:mouse|pointer|contextmenu|drag|drop)|click/, - rtypenamespace = /^([^.]*)(?:\.(.+)|)/; - -function returnTrue() { - return true; -} - -function returnFalse() { - return false; -} - -// Support: IE <=9 - 11+ -// focus() and blur() are asynchronous, except when they are no-op. -// So expect focus to be synchronous when the element is already active, -// and blur to be synchronous when the element is not already active. -// (focus and blur are always synchronous in other supported browsers, -// this just defines when we can count on it). -function expectSync( elem, type ) { - return ( elem === safeActiveElement() ) === ( type === "focus" ); -} - -// Support: IE <=9 only -// Accessing document.activeElement can throw unexpectedly -// https://bugs.jquery.com/ticket/13393 -function safeActiveElement() { - try { - return document.activeElement; - } catch ( err ) { } -} - -function on( elem, types, selector, data, fn, one ) { - var origFn, type; - - // Types can be a map of types/handlers - if ( typeof types === "object" ) { - - // ( types-Object, selector, data ) - if ( typeof selector !== "string" ) { - - // ( types-Object, data ) - data = data || selector; - selector = undefined; - } - for ( type in types ) { - on( elem, type, selector, data, types[ type ], one ); - } - return elem; - } - - if ( data == null && fn == null ) { - - // ( types, fn ) - fn = selector; - data = selector = undefined; - } else if ( fn == null ) { - if ( typeof selector === "string" ) { - - // ( types, selector, fn ) - fn = data; - data = undefined; - } else { - - // ( types, data, fn ) - fn = data; - data = selector; - selector = undefined; - } - } - if ( fn === false ) { - fn = returnFalse; - } else if ( !fn ) { - return elem; - } - - if ( one === 1 ) { - origFn = fn; - fn = function( event ) { - - // Can use an empty set, since event contains the info - jQuery().off( event ); - return origFn.apply( this, arguments ); - }; - - // Use same guid so caller can remove using origFn - fn.guid = origFn.guid || ( origFn.guid = jQuery.guid++ ); - } - return elem.each( function() { - jQuery.event.add( this, types, fn, data, selector ); - } ); -} - -/* - * Helper functions for managing events -- not part of the public interface. - * Props to Dean Edwards' addEvent library for many of the ideas. - */ -jQuery.event = { - - global: {}, - - add: function( elem, types, handler, data, selector ) { - - var handleObjIn, eventHandle, tmp, - events, t, handleObj, - special, handlers, type, namespaces, origType, - elemData = dataPriv.get( elem ); - - // Only attach events to objects that accept data - if ( !acceptData( elem ) ) { - return; - } - - // Caller can pass in an object of custom data in lieu of the handler - if ( handler.handler ) { - handleObjIn = handler; - handler = handleObjIn.handler; - selector = handleObjIn.selector; - } - - // Ensure that invalid selectors throw exceptions at attach time - // Evaluate against documentElement in case elem is a non-element node (e.g., document) - if ( selector ) { - jQuery.find.matchesSelector( documentElement, selector ); - } - - // Make sure that the handler has a unique ID, used to find/remove it later - if ( !handler.guid ) { - handler.guid = jQuery.guid++; - } - - // Init the element's event structure and main handler, if this is the first - if ( !( events = elemData.events ) ) { - events = elemData.events = Object.create( null ); - } - if ( !( eventHandle = elemData.handle ) ) { - eventHandle = elemData.handle = function( e ) { - - // Discard the second event of a jQuery.event.trigger() and - // when an event is called after a page has unloaded - return typeof jQuery !== "undefined" && jQuery.event.triggered !== e.type ? - jQuery.event.dispatch.apply( elem, arguments ) : undefined; - }; - } - - // Handle multiple events separated by a space - types = ( types || "" ).match( rnothtmlwhite ) || [ "" ]; - t = types.length; - while ( t-- ) { - tmp = rtypenamespace.exec( types[ t ] ) || []; - type = origType = tmp[ 1 ]; - namespaces = ( tmp[ 2 ] || "" ).split( "." ).sort(); - - // There *must* be a type, no attaching namespace-only handlers - if ( !type ) { - continue; - } - - // If event changes its type, use the special event handlers for the changed type - special = jQuery.event.special[ type ] || {}; - - // If selector defined, determine special event api type, otherwise given type - type = ( selector ? special.delegateType : special.bindType ) || type; - - // Update special based on newly reset type - special = jQuery.event.special[ type ] || {}; - - // handleObj is passed to all event handlers - handleObj = jQuery.extend( { - type: type, - origType: origType, - data: data, - handler: handler, - guid: handler.guid, - selector: selector, - needsContext: selector && jQuery.expr.match.needsContext.test( selector ), - namespace: namespaces.join( "." ) - }, handleObjIn ); - - // Init the event handler queue if we're the first - if ( !( handlers = events[ type ] ) ) { - handlers = events[ type ] = []; - handlers.delegateCount = 0; - - // Only use addEventListener if the special events handler returns false - if ( !special.setup || - special.setup.call( elem, data, namespaces, eventHandle ) === false ) { - - if ( elem.addEventListener ) { - elem.addEventListener( type, eventHandle ); - } - } - } - - if ( special.add ) { - special.add.call( elem, handleObj ); - - if ( !handleObj.handler.guid ) { - handleObj.handler.guid = handler.guid; - } - } - - // Add to the element's handler list, delegates in front - if ( selector ) { - handlers.splice( handlers.delegateCount++, 0, handleObj ); - } else { - handlers.push( handleObj ); - } - - // Keep track of which events have ever been used, for event optimization - jQuery.event.global[ type ] = true; - } - - }, - - // Detach an event or set of events from an element - remove: function( elem, types, handler, selector, mappedTypes ) { - - var j, origCount, tmp, - events, t, handleObj, - special, handlers, type, namespaces, origType, - elemData = dataPriv.hasData( elem ) && dataPriv.get( elem ); - - if ( !elemData || !( events = elemData.events ) ) { - return; - } - - // Once for each type.namespace in types; type may be omitted - types = ( types || "" ).match( rnothtmlwhite ) || [ "" ]; - t = types.length; - while ( t-- ) { - tmp = rtypenamespace.exec( types[ t ] ) || []; - type = origType = tmp[ 1 ]; - namespaces = ( tmp[ 2 ] || "" ).split( "." ).sort(); - - // Unbind all events (on this namespace, if provided) for the element - if ( !type ) { - for ( type in events ) { - jQuery.event.remove( elem, type + types[ t ], handler, selector, true ); - } - continue; - } - - special = jQuery.event.special[ type ] || {}; - type = ( selector ? special.delegateType : special.bindType ) || type; - handlers = events[ type ] || []; - tmp = tmp[ 2 ] && - new RegExp( "(^|\\.)" + namespaces.join( "\\.(?:.*\\.|)" ) + "(\\.|$)" ); - - // Remove matching events - origCount = j = handlers.length; - while ( j-- ) { - handleObj = handlers[ j ]; - - if ( ( mappedTypes || origType === handleObj.origType ) && - ( !handler || handler.guid === handleObj.guid ) && - ( !tmp || tmp.test( handleObj.namespace ) ) && - ( !selector || selector === handleObj.selector || - selector === "**" && handleObj.selector ) ) { - handlers.splice( j, 1 ); - - if ( handleObj.selector ) { - handlers.delegateCount--; - } - if ( special.remove ) { - special.remove.call( elem, handleObj ); - } - } - } - - // Remove generic event handler if we removed something and no more handlers exist - // (avoids potential for endless recursion during removal of special event handlers) - if ( origCount && !handlers.length ) { - if ( !special.teardown || - special.teardown.call( elem, namespaces, elemData.handle ) === false ) { - - jQuery.removeEvent( elem, type, elemData.handle ); - } - - delete events[ type ]; - } - } - - // Remove data and the expando if it's no longer used - if ( jQuery.isEmptyObject( events ) ) { - dataPriv.remove( elem, "handle events" ); - } - }, - - dispatch: function( nativeEvent ) { - - var i, j, ret, matched, handleObj, handlerQueue, - args = new Array( arguments.length ), - - // Make a writable jQuery.Event from the native event object - event = jQuery.event.fix( nativeEvent ), - - handlers = ( - dataPriv.get( this, "events" ) || Object.create( null ) - )[ event.type ] || [], - special = jQuery.event.special[ event.type ] || {}; - - // Use the fix-ed jQuery.Event rather than the (read-only) native event - args[ 0 ] = event; - - for ( i = 1; i < arguments.length; i++ ) { - args[ i ] = arguments[ i ]; - } - - event.delegateTarget = this; - - // Call the preDispatch hook for the mapped type, and let it bail if desired - if ( special.preDispatch && special.preDispatch.call( this, event ) === false ) { - return; - } - - // Determine handlers - handlerQueue = jQuery.event.handlers.call( this, event, handlers ); - - // Run delegates first; they may want to stop propagation beneath us - i = 0; - while ( ( matched = handlerQueue[ i++ ] ) && !event.isPropagationStopped() ) { - event.currentTarget = matched.elem; - - j = 0; - while ( ( handleObj = matched.handlers[ j++ ] ) && - !event.isImmediatePropagationStopped() ) { - - // If the event is namespaced, then each handler is only invoked if it is - // specially universal or its namespaces are a superset of the event's. - if ( !event.rnamespace || handleObj.namespace === false || - event.rnamespace.test( handleObj.namespace ) ) { - - event.handleObj = handleObj; - event.data = handleObj.data; - - ret = ( ( jQuery.event.special[ handleObj.origType ] || {} ).handle || - handleObj.handler ).apply( matched.elem, args ); - - if ( ret !== undefined ) { - if ( ( event.result = ret ) === false ) { - event.preventDefault(); - event.stopPropagation(); - } - } - } - } - } - - // Call the postDispatch hook for the mapped type - if ( special.postDispatch ) { - special.postDispatch.call( this, event ); - } - - return event.result; - }, - - handlers: function( event, handlers ) { - var i, handleObj, sel, matchedHandlers, matchedSelectors, - handlerQueue = [], - delegateCount = handlers.delegateCount, - cur = event.target; - - // Find delegate handlers - if ( delegateCount && - - // Support: IE <=9 - // Black-hole SVG instance trees (trac-13180) - cur.nodeType && - - // Support: Firefox <=42 - // Suppress spec-violating clicks indicating a non-primary pointer button (trac-3861) - // https://www.w3.org/TR/DOM-Level-3-Events/#event-type-click - // Support: IE 11 only - // ...but not arrow key "clicks" of radio inputs, which can have `button` -1 (gh-2343) - !( event.type === "click" && event.button >= 1 ) ) { - - for ( ; cur !== this; cur = cur.parentNode || this ) { - - // Don't check non-elements (#13208) - // Don't process clicks on disabled elements (#6911, #8165, #11382, #11764) - if ( cur.nodeType === 1 && !( event.type === "click" && cur.disabled === true ) ) { - matchedHandlers = []; - matchedSelectors = {}; - for ( i = 0; i < delegateCount; i++ ) { - handleObj = handlers[ i ]; - - // Don't conflict with Object.prototype properties (#13203) - sel = handleObj.selector + " "; - - if ( matchedSelectors[ sel ] === undefined ) { - matchedSelectors[ sel ] = handleObj.needsContext ? - jQuery( sel, this ).index( cur ) > -1 : - jQuery.find( sel, this, null, [ cur ] ).length; - } - if ( matchedSelectors[ sel ] ) { - matchedHandlers.push( handleObj ); - } - } - if ( matchedHandlers.length ) { - handlerQueue.push( { elem: cur, handlers: matchedHandlers } ); - } - } - } - } - - // Add the remaining (directly-bound) handlers - cur = this; - if ( delegateCount < handlers.length ) { - handlerQueue.push( { elem: cur, handlers: handlers.slice( delegateCount ) } ); - } - - return handlerQueue; - }, - - addProp: function( name, hook ) { - Object.defineProperty( jQuery.Event.prototype, name, { - enumerable: true, - configurable: true, - - get: isFunction( hook ) ? - function() { - if ( this.originalEvent ) { - return hook( this.originalEvent ); - } - } : - function() { - if ( this.originalEvent ) { - return this.originalEvent[ name ]; - } - }, - - set: function( value ) { - Object.defineProperty( this, name, { - enumerable: true, - configurable: true, - writable: true, - value: value - } ); - } - } ); - }, - - fix: function( originalEvent ) { - return originalEvent[ jQuery.expando ] ? - originalEvent : - new jQuery.Event( originalEvent ); - }, - - special: { - load: { - - // Prevent triggered image.load events from bubbling to window.load - noBubble: true - }, - click: { - - // Utilize native event to ensure correct state for checkable inputs - setup: function( data ) { - - // For mutual compressibility with _default, replace `this` access with a local var. - // `|| data` is dead code meant only to preserve the variable through minification. - var el = this || data; - - // Claim the first handler - if ( rcheckableType.test( el.type ) && - el.click && nodeName( el, "input" ) ) { - - // dataPriv.set( el, "click", ... ) - leverageNative( el, "click", returnTrue ); - } - - // Return false to allow normal processing in the caller - return false; - }, - trigger: function( data ) { - - // For mutual compressibility with _default, replace `this` access with a local var. - // `|| data` is dead code meant only to preserve the variable through minification. - var el = this || data; - - // Force setup before triggering a click - if ( rcheckableType.test( el.type ) && - el.click && nodeName( el, "input" ) ) { - - leverageNative( el, "click" ); - } - - // Return non-false to allow normal event-path propagation - return true; - }, - - // For cross-browser consistency, suppress native .click() on links - // Also prevent it if we're currently inside a leveraged native-event stack - _default: function( event ) { - var target = event.target; - return rcheckableType.test( target.type ) && - target.click && nodeName( target, "input" ) && - dataPriv.get( target, "click" ) || - nodeName( target, "a" ); - } - }, - - beforeunload: { - postDispatch: function( event ) { - - // Support: Firefox 20+ - // Firefox doesn't alert if the returnValue field is not set. - if ( event.result !== undefined && event.originalEvent ) { - event.originalEvent.returnValue = event.result; - } - } - } - } -}; - -// Ensure the presence of an event listener that handles manually-triggered -// synthetic events by interrupting progress until reinvoked in response to -// *native* events that it fires directly, ensuring that state changes have -// already occurred before other listeners are invoked. -function leverageNative( el, type, expectSync ) { - - // Missing expectSync indicates a trigger call, which must force setup through jQuery.event.add - if ( !expectSync ) { - if ( dataPriv.get( el, type ) === undefined ) { - jQuery.event.add( el, type, returnTrue ); - } - return; - } - - // Register the controller as a special universal handler for all event namespaces - dataPriv.set( el, type, false ); - jQuery.event.add( el, type, { - namespace: false, - handler: function( event ) { - var notAsync, result, - saved = dataPriv.get( this, type ); - - if ( ( event.isTrigger & 1 ) && this[ type ] ) { - - // Interrupt processing of the outer synthetic .trigger()ed event - // Saved data should be false in such cases, but might be a leftover capture object - // from an async native handler (gh-4350) - if ( !saved.length ) { - - // Store arguments for use when handling the inner native event - // There will always be at least one argument (an event object), so this array - // will not be confused with a leftover capture object. - saved = slice.call( arguments ); - dataPriv.set( this, type, saved ); - - // Trigger the native event and capture its result - // Support: IE <=9 - 11+ - // focus() and blur() are asynchronous - notAsync = expectSync( this, type ); - this[ type ](); - result = dataPriv.get( this, type ); - if ( saved !== result || notAsync ) { - dataPriv.set( this, type, false ); - } else { - result = {}; - } - if ( saved !== result ) { - - // Cancel the outer synthetic event - event.stopImmediatePropagation(); - event.preventDefault(); - return result.value; - } - - // If this is an inner synthetic event for an event with a bubbling surrogate - // (focus or blur), assume that the surrogate already propagated from triggering the - // native event and prevent that from happening again here. - // This technically gets the ordering wrong w.r.t. to `.trigger()` (in which the - // bubbling surrogate propagates *after* the non-bubbling base), but that seems - // less bad than duplication. - } else if ( ( jQuery.event.special[ type ] || {} ).delegateType ) { - event.stopPropagation(); - } - - // If this is a native event triggered above, everything is now in order - // Fire an inner synthetic event with the original arguments - } else if ( saved.length ) { - - // ...and capture the result - dataPriv.set( this, type, { - value: jQuery.event.trigger( - - // Support: IE <=9 - 11+ - // Extend with the prototype to reset the above stopImmediatePropagation() - jQuery.extend( saved[ 0 ], jQuery.Event.prototype ), - saved.slice( 1 ), - this - ) - } ); - - // Abort handling of the native event - event.stopImmediatePropagation(); - } - } - } ); -} - -jQuery.removeEvent = function( elem, type, handle ) { - - // This "if" is needed for plain objects - if ( elem.removeEventListener ) { - elem.removeEventListener( type, handle ); - } -}; - -jQuery.Event = function( src, props ) { - - // Allow instantiation without the 'new' keyword - if ( !( this instanceof jQuery.Event ) ) { - return new jQuery.Event( src, props ); - } - - // Event object - if ( src && src.type ) { - this.originalEvent = src; - this.type = src.type; - - // Events bubbling up the document may have been marked as prevented - // by a handler lower down the tree; reflect the correct value. - this.isDefaultPrevented = src.defaultPrevented || - src.defaultPrevented === undefined && - - // Support: Android <=2.3 only - src.returnValue === false ? - returnTrue : - returnFalse; - - // Create target properties - // Support: Safari <=6 - 7 only - // Target should not be a text node (#504, #13143) - this.target = ( src.target && src.target.nodeType === 3 ) ? - src.target.parentNode : - src.target; - - this.currentTarget = src.currentTarget; - this.relatedTarget = src.relatedTarget; - - // Event type - } else { - this.type = src; - } - - // Put explicitly provided properties onto the event object - if ( props ) { - jQuery.extend( this, props ); - } - - // Create a timestamp if incoming event doesn't have one - this.timeStamp = src && src.timeStamp || Date.now(); - - // Mark it as fixed - this[ jQuery.expando ] = true; -}; - -// jQuery.Event is based on DOM3 Events as specified by the ECMAScript Language Binding -// https://www.w3.org/TR/2003/WD-DOM-Level-3-Events-20030331/ecma-script-binding.html -jQuery.Event.prototype = { - constructor: jQuery.Event, - isDefaultPrevented: returnFalse, - isPropagationStopped: returnFalse, - isImmediatePropagationStopped: returnFalse, - isSimulated: false, - - preventDefault: function() { - var e = this.originalEvent; - - this.isDefaultPrevented = returnTrue; - - if ( e && !this.isSimulated ) { - e.preventDefault(); - } - }, - stopPropagation: function() { - var e = this.originalEvent; - - this.isPropagationStopped = returnTrue; - - if ( e && !this.isSimulated ) { - e.stopPropagation(); - } - }, - stopImmediatePropagation: function() { - var e = this.originalEvent; - - this.isImmediatePropagationStopped = returnTrue; - - if ( e && !this.isSimulated ) { - e.stopImmediatePropagation(); - } - - this.stopPropagation(); - } -}; - -// Includes all common event props including KeyEvent and MouseEvent specific props -jQuery.each( { - altKey: true, - bubbles: true, - cancelable: true, - changedTouches: true, - ctrlKey: true, - detail: true, - eventPhase: true, - metaKey: true, - pageX: true, - pageY: true, - shiftKey: true, - view: true, - "char": true, - code: true, - charCode: true, - key: true, - keyCode: true, - button: true, - buttons: true, - clientX: true, - clientY: true, - offsetX: true, - offsetY: true, - pointerId: true, - pointerType: true, - screenX: true, - screenY: true, - targetTouches: true, - toElement: true, - touches: true, - - which: function( event ) { - var button = event.button; - - // Add which for key events - if ( event.which == null && rkeyEvent.test( event.type ) ) { - return event.charCode != null ? event.charCode : event.keyCode; - } - - // Add which for click: 1 === left; 2 === middle; 3 === right - if ( !event.which && button !== undefined && rmouseEvent.test( event.type ) ) { - if ( button & 1 ) { - return 1; - } - - if ( button & 2 ) { - return 3; - } - - if ( button & 4 ) { - return 2; - } - - return 0; - } - - return event.which; - } -}, jQuery.event.addProp ); - -jQuery.each( { focus: "focusin", blur: "focusout" }, function( type, delegateType ) { - jQuery.event.special[ type ] = { - - // Utilize native event if possible so blur/focus sequence is correct - setup: function() { - - // Claim the first handler - // dataPriv.set( this, "focus", ... ) - // dataPriv.set( this, "blur", ... ) - leverageNative( this, type, expectSync ); - - // Return false to allow normal processing in the caller - return false; - }, - trigger: function() { - - // Force setup before trigger - leverageNative( this, type ); - - // Return non-false to allow normal event-path propagation - return true; - }, - - delegateType: delegateType - }; -} ); - -// Create mouseenter/leave events using mouseover/out and event-time checks -// so that event delegation works in jQuery. -// Do the same for pointerenter/pointerleave and pointerover/pointerout -// -// Support: Safari 7 only -// Safari sends mouseenter too often; see: -// https://bugs.chromium.org/p/chromium/issues/detail?id=470258 -// for the description of the bug (it existed in older Chrome versions as well). -jQuery.each( { - mouseenter: "mouseover", - mouseleave: "mouseout", - pointerenter: "pointerover", - pointerleave: "pointerout" -}, function( orig, fix ) { - jQuery.event.special[ orig ] = { - delegateType: fix, - bindType: fix, - - handle: function( event ) { - var ret, - target = this, - related = event.relatedTarget, - handleObj = event.handleObj; - - // For mouseenter/leave call the handler if related is outside the target. - // NB: No relatedTarget if the mouse left/entered the browser window - if ( !related || ( related !== target && !jQuery.contains( target, related ) ) ) { - event.type = handleObj.origType; - ret = handleObj.handler.apply( this, arguments ); - event.type = fix; - } - return ret; - } - }; -} ); - -jQuery.fn.extend( { - - on: function( types, selector, data, fn ) { - return on( this, types, selector, data, fn ); - }, - one: function( types, selector, data, fn ) { - return on( this, types, selector, data, fn, 1 ); - }, - off: function( types, selector, fn ) { - var handleObj, type; - if ( types && types.preventDefault && types.handleObj ) { - - // ( event ) dispatched jQuery.Event - handleObj = types.handleObj; - jQuery( types.delegateTarget ).off( - handleObj.namespace ? - handleObj.origType + "." + handleObj.namespace : - handleObj.origType, - handleObj.selector, - handleObj.handler - ); - return this; - } - if ( typeof types === "object" ) { - - // ( types-object [, selector] ) - for ( type in types ) { - this.off( type, selector, types[ type ] ); - } - return this; - } - if ( selector === false || typeof selector === "function" ) { - - // ( types [, fn] ) - fn = selector; - selector = undefined; - } - if ( fn === false ) { - fn = returnFalse; - } - return this.each( function() { - jQuery.event.remove( this, types, fn, selector ); - } ); - } -} ); - - -var - - // Support: IE <=10 - 11, Edge 12 - 13 only - // In IE/Edge using regex groups here causes severe slowdowns. - // See https://connect.microsoft.com/IE/feedback/details/1736512/ - rnoInnerhtml = /\s*$/g; - -// Prefer a tbody over its parent table for containing new rows -function manipulationTarget( elem, content ) { - if ( nodeName( elem, "table" ) && - nodeName( content.nodeType !== 11 ? content : content.firstChild, "tr" ) ) { - - return jQuery( elem ).children( "tbody" )[ 0 ] || elem; - } - - return elem; -} - -// Replace/restore the type attribute of script elements for safe DOM manipulation -function disableScript( elem ) { - elem.type = ( elem.getAttribute( "type" ) !== null ) + "/" + elem.type; - return elem; -} -function restoreScript( elem ) { - if ( ( elem.type || "" ).slice( 0, 5 ) === "true/" ) { - elem.type = elem.type.slice( 5 ); - } else { - elem.removeAttribute( "type" ); - } - - return elem; -} - -function cloneCopyEvent( src, dest ) { - var i, l, type, pdataOld, udataOld, udataCur, events; - - if ( dest.nodeType !== 1 ) { - return; - } - - // 1. Copy private data: events, handlers, etc. - if ( dataPriv.hasData( src ) ) { - pdataOld = dataPriv.get( src ); - events = pdataOld.events; - - if ( events ) { - dataPriv.remove( dest, "handle events" ); - - for ( type in events ) { - for ( i = 0, l = events[ type ].length; i < l; i++ ) { - jQuery.event.add( dest, type, events[ type ][ i ] ); - } - } - } - } - - // 2. Copy user data - if ( dataUser.hasData( src ) ) { - udataOld = dataUser.access( src ); - udataCur = jQuery.extend( {}, udataOld ); - - dataUser.set( dest, udataCur ); - } -} - -// Fix IE bugs, see support tests -function fixInput( src, dest ) { - var nodeName = dest.nodeName.toLowerCase(); - - // Fails to persist the checked state of a cloned checkbox or radio button. - if ( nodeName === "input" && rcheckableType.test( src.type ) ) { - dest.checked = src.checked; - - // Fails to return the selected option to the default selected state when cloning options - } else if ( nodeName === "input" || nodeName === "textarea" ) { - dest.defaultValue = src.defaultValue; - } -} - -function domManip( collection, args, callback, ignored ) { - - // Flatten any nested arrays - args = flat( args ); - - var fragment, first, scripts, hasScripts, node, doc, - i = 0, - l = collection.length, - iNoClone = l - 1, - value = args[ 0 ], - valueIsFunction = isFunction( value ); - - // We can't cloneNode fragments that contain checked, in WebKit - if ( valueIsFunction || - ( l > 1 && typeof value === "string" && - !support.checkClone && rchecked.test( value ) ) ) { - return collection.each( function( index ) { - var self = collection.eq( index ); - if ( valueIsFunction ) { - args[ 0 ] = value.call( this, index, self.html() ); - } - domManip( self, args, callback, ignored ); - } ); - } - - if ( l ) { - fragment = buildFragment( args, collection[ 0 ].ownerDocument, false, collection, ignored ); - first = fragment.firstChild; - - if ( fragment.childNodes.length === 1 ) { - fragment = first; - } - - // Require either new content or an interest in ignored elements to invoke the callback - if ( first || ignored ) { - scripts = jQuery.map( getAll( fragment, "script" ), disableScript ); - hasScripts = scripts.length; - - // Use the original fragment for the last item - // instead of the first because it can end up - // being emptied incorrectly in certain situations (#8070). - for ( ; i < l; i++ ) { - node = fragment; - - if ( i !== iNoClone ) { - node = jQuery.clone( node, true, true ); - - // Keep references to cloned scripts for later restoration - if ( hasScripts ) { - - // Support: Android <=4.0 only, PhantomJS 1 only - // push.apply(_, arraylike) throws on ancient WebKit - jQuery.merge( scripts, getAll( node, "script" ) ); - } - } - - callback.call( collection[ i ], node, i ); - } - - if ( hasScripts ) { - doc = scripts[ scripts.length - 1 ].ownerDocument; - - // Reenable scripts - jQuery.map( scripts, restoreScript ); - - // Evaluate executable scripts on first document insertion - for ( i = 0; i < hasScripts; i++ ) { - node = scripts[ i ]; - if ( rscriptType.test( node.type || "" ) && - !dataPriv.access( node, "globalEval" ) && - jQuery.contains( doc, node ) ) { - - if ( node.src && ( node.type || "" ).toLowerCase() !== "module" ) { - - // Optional AJAX dependency, but won't run scripts if not present - if ( jQuery._evalUrl && !node.noModule ) { - jQuery._evalUrl( node.src, { - nonce: node.nonce || node.getAttribute( "nonce" ) - }, doc ); - } - } else { - DOMEval( node.textContent.replace( rcleanScript, "" ), node, doc ); - } - } - } - } - } - } - - return collection; -} - -function remove( elem, selector, keepData ) { - var node, - nodes = selector ? jQuery.filter( selector, elem ) : elem, - i = 0; - - for ( ; ( node = nodes[ i ] ) != null; i++ ) { - if ( !keepData && node.nodeType === 1 ) { - jQuery.cleanData( getAll( node ) ); - } - - if ( node.parentNode ) { - if ( keepData && isAttached( node ) ) { - setGlobalEval( getAll( node, "script" ) ); - } - node.parentNode.removeChild( node ); - } - } - - return elem; -} - -jQuery.extend( { - htmlPrefilter: function( html ) { - return html; - }, - - clone: function( elem, dataAndEvents, deepDataAndEvents ) { - var i, l, srcElements, destElements, - clone = elem.cloneNode( true ), - inPage = isAttached( elem ); - - // Fix IE cloning issues - if ( !support.noCloneChecked && ( elem.nodeType === 1 || elem.nodeType === 11 ) && - !jQuery.isXMLDoc( elem ) ) { - - // We eschew Sizzle here for performance reasons: https://jsperf.com/getall-vs-sizzle/2 - destElements = getAll( clone ); - srcElements = getAll( elem ); - - for ( i = 0, l = srcElements.length; i < l; i++ ) { - fixInput( srcElements[ i ], destElements[ i ] ); - } - } - - // Copy the events from the original to the clone - if ( dataAndEvents ) { - if ( deepDataAndEvents ) { - srcElements = srcElements || getAll( elem ); - destElements = destElements || getAll( clone ); - - for ( i = 0, l = srcElements.length; i < l; i++ ) { - cloneCopyEvent( srcElements[ i ], destElements[ i ] ); - } - } else { - cloneCopyEvent( elem, clone ); - } - } - - // Preserve script evaluation history - destElements = getAll( clone, "script" ); - if ( destElements.length > 0 ) { - setGlobalEval( destElements, !inPage && getAll( elem, "script" ) ); - } - - // Return the cloned set - return clone; - }, - - cleanData: function( elems ) { - var data, elem, type, - special = jQuery.event.special, - i = 0; - - for ( ; ( elem = elems[ i ] ) !== undefined; i++ ) { - if ( acceptData( elem ) ) { - if ( ( data = elem[ dataPriv.expando ] ) ) { - if ( data.events ) { - for ( type in data.events ) { - if ( special[ type ] ) { - jQuery.event.remove( elem, type ); - - // This is a shortcut to avoid jQuery.event.remove's overhead - } else { - jQuery.removeEvent( elem, type, data.handle ); - } - } - } - - // Support: Chrome <=35 - 45+ - // Assign undefined instead of using delete, see Data#remove - elem[ dataPriv.expando ] = undefined; - } - if ( elem[ dataUser.expando ] ) { - - // Support: Chrome <=35 - 45+ - // Assign undefined instead of using delete, see Data#remove - elem[ dataUser.expando ] = undefined; - } - } - } - } -} ); - -jQuery.fn.extend( { - detach: function( selector ) { - return remove( this, selector, true ); - }, - - remove: function( selector ) { - return remove( this, selector ); - }, - - text: function( value ) { - return access( this, function( value ) { - return value === undefined ? - jQuery.text( this ) : - this.empty().each( function() { - if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) { - this.textContent = value; - } - } ); - }, null, value, arguments.length ); - }, - - append: function() { - return domManip( this, arguments, function( elem ) { - if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) { - var target = manipulationTarget( this, elem ); - target.appendChild( elem ); - } - } ); - }, - - prepend: function() { - return domManip( this, arguments, function( elem ) { - if ( this.nodeType === 1 || this.nodeType === 11 || this.nodeType === 9 ) { - var target = manipulationTarget( this, elem ); - target.insertBefore( elem, target.firstChild ); - } - } ); - }, - - before: function() { - return domManip( this, arguments, function( elem ) { - if ( this.parentNode ) { - this.parentNode.insertBefore( elem, this ); - } - } ); - }, - - after: function() { - return domManip( this, arguments, function( elem ) { - if ( this.parentNode ) { - this.parentNode.insertBefore( elem, this.nextSibling ); - } - } ); - }, - - empty: function() { - var elem, - i = 0; - - for ( ; ( elem = this[ i ] ) != null; i++ ) { - if ( elem.nodeType === 1 ) { - - // Prevent memory leaks - jQuery.cleanData( getAll( elem, false ) ); - - // Remove any remaining nodes - elem.textContent = ""; - } - } - - return this; - }, - - clone: function( dataAndEvents, deepDataAndEvents ) { - dataAndEvents = dataAndEvents == null ? false : dataAndEvents; - deepDataAndEvents = deepDataAndEvents == null ? dataAndEvents : deepDataAndEvents; - - return this.map( function() { - return jQuery.clone( this, dataAndEvents, deepDataAndEvents ); - } ); - }, - - html: function( value ) { - return access( this, function( value ) { - var elem = this[ 0 ] || {}, - i = 0, - l = this.length; - - if ( value === undefined && elem.nodeType === 1 ) { - return elem.innerHTML; - } - - // See if we can take a shortcut and just use innerHTML - if ( typeof value === "string" && !rnoInnerhtml.test( value ) && - !wrapMap[ ( rtagName.exec( value ) || [ "", "" ] )[ 1 ].toLowerCase() ] ) { - - value = jQuery.htmlPrefilter( value ); - - try { - for ( ; i < l; i++ ) { - elem = this[ i ] || {}; - - // Remove element nodes and prevent memory leaks - if ( elem.nodeType === 1 ) { - jQuery.cleanData( getAll( elem, false ) ); - elem.innerHTML = value; - } - } - - elem = 0; - - // If using innerHTML throws an exception, use the fallback method - } catch ( e ) {} - } - - if ( elem ) { - this.empty().append( value ); - } - }, null, value, arguments.length ); - }, - - replaceWith: function() { - var ignored = []; - - // Make the changes, replacing each non-ignored context element with the new content - return domManip( this, arguments, function( elem ) { - var parent = this.parentNode; - - if ( jQuery.inArray( this, ignored ) < 0 ) { - jQuery.cleanData( getAll( this ) ); - if ( parent ) { - parent.replaceChild( elem, this ); - } - } - - // Force callback invocation - }, ignored ); - } -} ); - -jQuery.each( { - appendTo: "append", - prependTo: "prepend", - insertBefore: "before", - insertAfter: "after", - replaceAll: "replaceWith" -}, function( name, original ) { - jQuery.fn[ name ] = function( selector ) { - var elems, - ret = [], - insert = jQuery( selector ), - last = insert.length - 1, - i = 0; - - for ( ; i <= last; i++ ) { - elems = i === last ? this : this.clone( true ); - jQuery( insert[ i ] )[ original ]( elems ); - - // Support: Android <=4.0 only, PhantomJS 1 only - // .get() because push.apply(_, arraylike) throws on ancient WebKit - push.apply( ret, elems.get() ); - } - - return this.pushStack( ret ); - }; -} ); -var rnumnonpx = new RegExp( "^(" + pnum + ")(?!px)[a-z%]+$", "i" ); - -var getStyles = function( elem ) { - - // Support: IE <=11 only, Firefox <=30 (#15098, #14150) - // IE throws on elements created in popups - // FF meanwhile throws on frame elements through "defaultView.getComputedStyle" - var view = elem.ownerDocument.defaultView; - - if ( !view || !view.opener ) { - view = window; - } - - return view.getComputedStyle( elem ); - }; - -var swap = function( elem, options, callback ) { - var ret, name, - old = {}; - - // Remember the old values, and insert the new ones - for ( name in options ) { - old[ name ] = elem.style[ name ]; - elem.style[ name ] = options[ name ]; - } - - ret = callback.call( elem ); - - // Revert the old values - for ( name in options ) { - elem.style[ name ] = old[ name ]; - } - - return ret; -}; - - -var rboxStyle = new RegExp( cssExpand.join( "|" ), "i" ); - - - -( function() { - - // Executing both pixelPosition & boxSizingReliable tests require only one layout - // so they're executed at the same time to save the second computation. - function computeStyleTests() { - - // This is a singleton, we need to execute it only once - if ( !div ) { - return; - } - - container.style.cssText = "position:absolute;left:-11111px;width:60px;" + - "margin-top:1px;padding:0;border:0"; - div.style.cssText = - "position:relative;display:block;box-sizing:border-box;overflow:scroll;" + - "margin:auto;border:1px;padding:1px;" + - "width:60%;top:1%"; - documentElement.appendChild( container ).appendChild( div ); - - var divStyle = window.getComputedStyle( div ); - pixelPositionVal = divStyle.top !== "1%"; - - // Support: Android 4.0 - 4.3 only, Firefox <=3 - 44 - reliableMarginLeftVal = roundPixelMeasures( divStyle.marginLeft ) === 12; - - // Support: Android 4.0 - 4.3 only, Safari <=9.1 - 10.1, iOS <=7.0 - 9.3 - // Some styles come back with percentage values, even though they shouldn't - div.style.right = "60%"; - pixelBoxStylesVal = roundPixelMeasures( divStyle.right ) === 36; - - // Support: IE 9 - 11 only - // Detect misreporting of content dimensions for box-sizing:border-box elements - boxSizingReliableVal = roundPixelMeasures( divStyle.width ) === 36; - - // Support: IE 9 only - // Detect overflow:scroll screwiness (gh-3699) - // Support: Chrome <=64 - // Don't get tricked when zoom affects offsetWidth (gh-4029) - div.style.position = "absolute"; - scrollboxSizeVal = roundPixelMeasures( div.offsetWidth / 3 ) === 12; - - documentElement.removeChild( container ); - - // Nullify the div so it wouldn't be stored in the memory and - // it will also be a sign that checks already performed - div = null; - } - - function roundPixelMeasures( measure ) { - return Math.round( parseFloat( measure ) ); - } - - var pixelPositionVal, boxSizingReliableVal, scrollboxSizeVal, pixelBoxStylesVal, - reliableTrDimensionsVal, reliableMarginLeftVal, - container = document.createElement( "div" ), - div = document.createElement( "div" ); - - // Finish early in limited (non-browser) environments - if ( !div.style ) { - return; - } - - // Support: IE <=9 - 11 only - // Style of cloned element affects source element cloned (#8908) - div.style.backgroundClip = "content-box"; - div.cloneNode( true ).style.backgroundClip = ""; - support.clearCloneStyle = div.style.backgroundClip === "content-box"; - - jQuery.extend( support, { - boxSizingReliable: function() { - computeStyleTests(); - return boxSizingReliableVal; - }, - pixelBoxStyles: function() { - computeStyleTests(); - return pixelBoxStylesVal; - }, - pixelPosition: function() { - computeStyleTests(); - return pixelPositionVal; - }, - reliableMarginLeft: function() { - computeStyleTests(); - return reliableMarginLeftVal; - }, - scrollboxSize: function() { - computeStyleTests(); - return scrollboxSizeVal; - }, - - // Support: IE 9 - 11+, Edge 15 - 18+ - // IE/Edge misreport `getComputedStyle` of table rows with width/height - // set in CSS while `offset*` properties report correct values. - // Behavior in IE 9 is more subtle than in newer versions & it passes - // some versions of this test; make sure not to make it pass there! - reliableTrDimensions: function() { - var table, tr, trChild, trStyle; - if ( reliableTrDimensionsVal == null ) { - table = document.createElement( "table" ); - tr = document.createElement( "tr" ); - trChild = document.createElement( "div" ); - - table.style.cssText = "position:absolute;left:-11111px"; - tr.style.height = "1px"; - trChild.style.height = "9px"; - - documentElement - .appendChild( table ) - .appendChild( tr ) - .appendChild( trChild ); - - trStyle = window.getComputedStyle( tr ); - reliableTrDimensionsVal = parseInt( trStyle.height ) > 3; - - documentElement.removeChild( table ); - } - return reliableTrDimensionsVal; - } - } ); -} )(); - - -function curCSS( elem, name, computed ) { - var width, minWidth, maxWidth, ret, - - // Support: Firefox 51+ - // Retrieving style before computed somehow - // fixes an issue with getting wrong values - // on detached elements - style = elem.style; - - computed = computed || getStyles( elem ); - - // getPropertyValue is needed for: - // .css('filter') (IE 9 only, #12537) - // .css('--customProperty) (#3144) - if ( computed ) { - ret = computed.getPropertyValue( name ) || computed[ name ]; - - if ( ret === "" && !isAttached( elem ) ) { - ret = jQuery.style( elem, name ); - } - - // A tribute to the "awesome hack by Dean Edwards" - // Android Browser returns percentage for some values, - // but width seems to be reliably pixels. - // This is against the CSSOM draft spec: - // https://drafts.csswg.org/cssom/#resolved-values - if ( !support.pixelBoxStyles() && rnumnonpx.test( ret ) && rboxStyle.test( name ) ) { - - // Remember the original values - width = style.width; - minWidth = style.minWidth; - maxWidth = style.maxWidth; - - // Put in the new values to get a computed value out - style.minWidth = style.maxWidth = style.width = ret; - ret = computed.width; - - // Revert the changed values - style.width = width; - style.minWidth = minWidth; - style.maxWidth = maxWidth; - } - } - - return ret !== undefined ? - - // Support: IE <=9 - 11 only - // IE returns zIndex value as an integer. - ret + "" : - ret; -} - - -function addGetHookIf( conditionFn, hookFn ) { - - // Define the hook, we'll check on the first run if it's really needed. - return { - get: function() { - if ( conditionFn() ) { - - // Hook not needed (or it's not possible to use it due - // to missing dependency), remove it. - delete this.get; - return; - } - - // Hook needed; redefine it so that the support test is not executed again. - return ( this.get = hookFn ).apply( this, arguments ); - } - }; -} - - -var cssPrefixes = [ "Webkit", "Moz", "ms" ], - emptyStyle = document.createElement( "div" ).style, - vendorProps = {}; - -// Return a vendor-prefixed property or undefined -function vendorPropName( name ) { - - // Check for vendor prefixed names - var capName = name[ 0 ].toUpperCase() + name.slice( 1 ), - i = cssPrefixes.length; - - while ( i-- ) { - name = cssPrefixes[ i ] + capName; - if ( name in emptyStyle ) { - return name; - } - } -} - -// Return a potentially-mapped jQuery.cssProps or vendor prefixed property -function finalPropName( name ) { - var final = jQuery.cssProps[ name ] || vendorProps[ name ]; - - if ( final ) { - return final; - } - if ( name in emptyStyle ) { - return name; - } - return vendorProps[ name ] = vendorPropName( name ) || name; -} - - -var - - // Swappable if display is none or starts with table - // except "table", "table-cell", or "table-caption" - // See here for display values: https://developer.mozilla.org/en-US/docs/CSS/display - rdisplayswap = /^(none|table(?!-c[ea]).+)/, - rcustomProp = /^--/, - cssShow = { position: "absolute", visibility: "hidden", display: "block" }, - cssNormalTransform = { - letterSpacing: "0", - fontWeight: "400" - }; - -function setPositiveNumber( _elem, value, subtract ) { - - // Any relative (+/-) values have already been - // normalized at this point - var matches = rcssNum.exec( value ); - return matches ? - - // Guard against undefined "subtract", e.g., when used as in cssHooks - Math.max( 0, matches[ 2 ] - ( subtract || 0 ) ) + ( matches[ 3 ] || "px" ) : - value; -} - -function boxModelAdjustment( elem, dimension, box, isBorderBox, styles, computedVal ) { - var i = dimension === "width" ? 1 : 0, - extra = 0, - delta = 0; - - // Adjustment may not be necessary - if ( box === ( isBorderBox ? "border" : "content" ) ) { - return 0; - } - - for ( ; i < 4; i += 2 ) { - - // Both box models exclude margin - if ( box === "margin" ) { - delta += jQuery.css( elem, box + cssExpand[ i ], true, styles ); - } - - // If we get here with a content-box, we're seeking "padding" or "border" or "margin" - if ( !isBorderBox ) { - - // Add padding - delta += jQuery.css( elem, "padding" + cssExpand[ i ], true, styles ); - - // For "border" or "margin", add border - if ( box !== "padding" ) { - delta += jQuery.css( elem, "border" + cssExpand[ i ] + "Width", true, styles ); - - // But still keep track of it otherwise - } else { - extra += jQuery.css( elem, "border" + cssExpand[ i ] + "Width", true, styles ); - } - - // If we get here with a border-box (content + padding + border), we're seeking "content" or - // "padding" or "margin" - } else { - - // For "content", subtract padding - if ( box === "content" ) { - delta -= jQuery.css( elem, "padding" + cssExpand[ i ], true, styles ); - } - - // For "content" or "padding", subtract border - if ( box !== "margin" ) { - delta -= jQuery.css( elem, "border" + cssExpand[ i ] + "Width", true, styles ); - } - } - } - - // Account for positive content-box scroll gutter when requested by providing computedVal - if ( !isBorderBox && computedVal >= 0 ) { - - // offsetWidth/offsetHeight is a rounded sum of content, padding, scroll gutter, and border - // Assuming integer scroll gutter, subtract the rest and round down - delta += Math.max( 0, Math.ceil( - elem[ "offset" + dimension[ 0 ].toUpperCase() + dimension.slice( 1 ) ] - - computedVal - - delta - - extra - - 0.5 - - // If offsetWidth/offsetHeight is unknown, then we can't determine content-box scroll gutter - // Use an explicit zero to avoid NaN (gh-3964) - ) ) || 0; - } - - return delta; -} - -function getWidthOrHeight( elem, dimension, extra ) { - - // Start with computed style - var styles = getStyles( elem ), - - // To avoid forcing a reflow, only fetch boxSizing if we need it (gh-4322). - // Fake content-box until we know it's needed to know the true value. - boxSizingNeeded = !support.boxSizingReliable() || extra, - isBorderBox = boxSizingNeeded && - jQuery.css( elem, "boxSizing", false, styles ) === "border-box", - valueIsBorderBox = isBorderBox, - - val = curCSS( elem, dimension, styles ), - offsetProp = "offset" + dimension[ 0 ].toUpperCase() + dimension.slice( 1 ); - - // Support: Firefox <=54 - // Return a confounding non-pixel value or feign ignorance, as appropriate. - if ( rnumnonpx.test( val ) ) { - if ( !extra ) { - return val; - } - val = "auto"; - } - - - // Support: IE 9 - 11 only - // Use offsetWidth/offsetHeight for when box sizing is unreliable. - // In those cases, the computed value can be trusted to be border-box. - if ( ( !support.boxSizingReliable() && isBorderBox || - - // Support: IE 10 - 11+, Edge 15 - 18+ - // IE/Edge misreport `getComputedStyle` of table rows with width/height - // set in CSS while `offset*` properties report correct values. - // Interestingly, in some cases IE 9 doesn't suffer from this issue. - !support.reliableTrDimensions() && nodeName( elem, "tr" ) || - - // Fall back to offsetWidth/offsetHeight when value is "auto" - // This happens for inline elements with no explicit setting (gh-3571) - val === "auto" || - - // Support: Android <=4.1 - 4.3 only - // Also use offsetWidth/offsetHeight for misreported inline dimensions (gh-3602) - !parseFloat( val ) && jQuery.css( elem, "display", false, styles ) === "inline" ) && - - // Make sure the element is visible & connected - elem.getClientRects().length ) { - - isBorderBox = jQuery.css( elem, "boxSizing", false, styles ) === "border-box"; - - // Where available, offsetWidth/offsetHeight approximate border box dimensions. - // Where not available (e.g., SVG), assume unreliable box-sizing and interpret the - // retrieved value as a content box dimension. - valueIsBorderBox = offsetProp in elem; - if ( valueIsBorderBox ) { - val = elem[ offsetProp ]; - } - } - - // Normalize "" and auto - val = parseFloat( val ) || 0; - - // Adjust for the element's box model - return ( val + - boxModelAdjustment( - elem, - dimension, - extra || ( isBorderBox ? "border" : "content" ), - valueIsBorderBox, - styles, - - // Provide the current computed size to request scroll gutter calculation (gh-3589) - val - ) - ) + "px"; -} - -jQuery.extend( { - - // Add in style property hooks for overriding the default - // behavior of getting and setting a style property - cssHooks: { - opacity: { - get: function( elem, computed ) { - if ( computed ) { - - // We should always get a number back from opacity - var ret = curCSS( elem, "opacity" ); - return ret === "" ? "1" : ret; - } - } - } - }, - - // Don't automatically add "px" to these possibly-unitless properties - cssNumber: { - "animationIterationCount": true, - "columnCount": true, - "fillOpacity": true, - "flexGrow": true, - "flexShrink": true, - "fontWeight": true, - "gridArea": true, - "gridColumn": true, - "gridColumnEnd": true, - "gridColumnStart": true, - "gridRow": true, - "gridRowEnd": true, - "gridRowStart": true, - "lineHeight": true, - "opacity": true, - "order": true, - "orphans": true, - "widows": true, - "zIndex": true, - "zoom": true - }, - - // Add in properties whose names you wish to fix before - // setting or getting the value - cssProps: {}, - - // Get and set the style property on a DOM Node - style: function( elem, name, value, extra ) { - - // Don't set styles on text and comment nodes - if ( !elem || elem.nodeType === 3 || elem.nodeType === 8 || !elem.style ) { - return; - } - - // Make sure that we're working with the right name - var ret, type, hooks, - origName = camelCase( name ), - isCustomProp = rcustomProp.test( name ), - style = elem.style; - - // Make sure that we're working with the right name. We don't - // want to query the value if it is a CSS custom property - // since they are user-defined. - if ( !isCustomProp ) { - name = finalPropName( origName ); - } - - // Gets hook for the prefixed version, then unprefixed version - hooks = jQuery.cssHooks[ name ] || jQuery.cssHooks[ origName ]; - - // Check if we're setting a value - if ( value !== undefined ) { - type = typeof value; - - // Convert "+=" or "-=" to relative numbers (#7345) - if ( type === "string" && ( ret = rcssNum.exec( value ) ) && ret[ 1 ] ) { - value = adjustCSS( elem, name, ret ); - - // Fixes bug #9237 - type = "number"; - } - - // Make sure that null and NaN values aren't set (#7116) - if ( value == null || value !== value ) { - return; - } - - // If a number was passed in, add the unit (except for certain CSS properties) - // The isCustomProp check can be removed in jQuery 4.0 when we only auto-append - // "px" to a few hardcoded values. - if ( type === "number" && !isCustomProp ) { - value += ret && ret[ 3 ] || ( jQuery.cssNumber[ origName ] ? "" : "px" ); - } - - // background-* props affect original clone's values - if ( !support.clearCloneStyle && value === "" && name.indexOf( "background" ) === 0 ) { - style[ name ] = "inherit"; - } - - // If a hook was provided, use that value, otherwise just set the specified value - if ( !hooks || !( "set" in hooks ) || - ( value = hooks.set( elem, value, extra ) ) !== undefined ) { - - if ( isCustomProp ) { - style.setProperty( name, value ); - } else { - style[ name ] = value; - } - } - - } else { - - // If a hook was provided get the non-computed value from there - if ( hooks && "get" in hooks && - ( ret = hooks.get( elem, false, extra ) ) !== undefined ) { - - return ret; - } - - // Otherwise just get the value from the style object - return style[ name ]; - } - }, - - css: function( elem, name, extra, styles ) { - var val, num, hooks, - origName = camelCase( name ), - isCustomProp = rcustomProp.test( name ); - - // Make sure that we're working with the right name. We don't - // want to modify the value if it is a CSS custom property - // since they are user-defined. - if ( !isCustomProp ) { - name = finalPropName( origName ); - } - - // Try prefixed name followed by the unprefixed name - hooks = jQuery.cssHooks[ name ] || jQuery.cssHooks[ origName ]; - - // If a hook was provided get the computed value from there - if ( hooks && "get" in hooks ) { - val = hooks.get( elem, true, extra ); - } - - // Otherwise, if a way to get the computed value exists, use that - if ( val === undefined ) { - val = curCSS( elem, name, styles ); - } - - // Convert "normal" to computed value - if ( val === "normal" && name in cssNormalTransform ) { - val = cssNormalTransform[ name ]; - } - - // Make numeric if forced or a qualifier was provided and val looks numeric - if ( extra === "" || extra ) { - num = parseFloat( val ); - return extra === true || isFinite( num ) ? num || 0 : val; - } - - return val; - } -} ); - -jQuery.each( [ "height", "width" ], function( _i, dimension ) { - jQuery.cssHooks[ dimension ] = { - get: function( elem, computed, extra ) { - if ( computed ) { - - // Certain elements can have dimension info if we invisibly show them - // but it must have a current display style that would benefit - return rdisplayswap.test( jQuery.css( elem, "display" ) ) && - - // Support: Safari 8+ - // Table columns in Safari have non-zero offsetWidth & zero - // getBoundingClientRect().width unless display is changed. - // Support: IE <=11 only - // Running getBoundingClientRect on a disconnected node - // in IE throws an error. - ( !elem.getClientRects().length || !elem.getBoundingClientRect().width ) ? - swap( elem, cssShow, function() { - return getWidthOrHeight( elem, dimension, extra ); - } ) : - getWidthOrHeight( elem, dimension, extra ); - } - }, - - set: function( elem, value, extra ) { - var matches, - styles = getStyles( elem ), - - // Only read styles.position if the test has a chance to fail - // to avoid forcing a reflow. - scrollboxSizeBuggy = !support.scrollboxSize() && - styles.position === "absolute", - - // To avoid forcing a reflow, only fetch boxSizing if we need it (gh-3991) - boxSizingNeeded = scrollboxSizeBuggy || extra, - isBorderBox = boxSizingNeeded && - jQuery.css( elem, "boxSizing", false, styles ) === "border-box", - subtract = extra ? - boxModelAdjustment( - elem, - dimension, - extra, - isBorderBox, - styles - ) : - 0; - - // Account for unreliable border-box dimensions by comparing offset* to computed and - // faking a content-box to get border and padding (gh-3699) - if ( isBorderBox && scrollboxSizeBuggy ) { - subtract -= Math.ceil( - elem[ "offset" + dimension[ 0 ].toUpperCase() + dimension.slice( 1 ) ] - - parseFloat( styles[ dimension ] ) - - boxModelAdjustment( elem, dimension, "border", false, styles ) - - 0.5 - ); - } - - // Convert to pixels if value adjustment is needed - if ( subtract && ( matches = rcssNum.exec( value ) ) && - ( matches[ 3 ] || "px" ) !== "px" ) { - - elem.style[ dimension ] = value; - value = jQuery.css( elem, dimension ); - } - - return setPositiveNumber( elem, value, subtract ); - } - }; -} ); - -jQuery.cssHooks.marginLeft = addGetHookIf( support.reliableMarginLeft, - function( elem, computed ) { - if ( computed ) { - return ( parseFloat( curCSS( elem, "marginLeft" ) ) || - elem.getBoundingClientRect().left - - swap( elem, { marginLeft: 0 }, function() { - return elem.getBoundingClientRect().left; - } ) - ) + "px"; - } - } -); - -// These hooks are used by animate to expand properties -jQuery.each( { - margin: "", - padding: "", - border: "Width" -}, function( prefix, suffix ) { - jQuery.cssHooks[ prefix + suffix ] = { - expand: function( value ) { - var i = 0, - expanded = {}, - - // Assumes a single number if not a string - parts = typeof value === "string" ? value.split( " " ) : [ value ]; - - for ( ; i < 4; i++ ) { - expanded[ prefix + cssExpand[ i ] + suffix ] = - parts[ i ] || parts[ i - 2 ] || parts[ 0 ]; - } - - return expanded; - } - }; - - if ( prefix !== "margin" ) { - jQuery.cssHooks[ prefix + suffix ].set = setPositiveNumber; - } -} ); - -jQuery.fn.extend( { - css: function( name, value ) { - return access( this, function( elem, name, value ) { - var styles, len, - map = {}, - i = 0; - - if ( Array.isArray( name ) ) { - styles = getStyles( elem ); - len = name.length; - - for ( ; i < len; i++ ) { - map[ name[ i ] ] = jQuery.css( elem, name[ i ], false, styles ); - } - - return map; - } - - return value !== undefined ? - jQuery.style( elem, name, value ) : - jQuery.css( elem, name ); - }, name, value, arguments.length > 1 ); - } -} ); - - -function Tween( elem, options, prop, end, easing ) { - return new Tween.prototype.init( elem, options, prop, end, easing ); -} -jQuery.Tween = Tween; - -Tween.prototype = { - constructor: Tween, - init: function( elem, options, prop, end, easing, unit ) { - this.elem = elem; - this.prop = prop; - this.easing = easing || jQuery.easing._default; - this.options = options; - this.start = this.now = this.cur(); - this.end = end; - this.unit = unit || ( jQuery.cssNumber[ prop ] ? "" : "px" ); - }, - cur: function() { - var hooks = Tween.propHooks[ this.prop ]; - - return hooks && hooks.get ? - hooks.get( this ) : - Tween.propHooks._default.get( this ); - }, - run: function( percent ) { - var eased, - hooks = Tween.propHooks[ this.prop ]; - - if ( this.options.duration ) { - this.pos = eased = jQuery.easing[ this.easing ]( - percent, this.options.duration * percent, 0, 1, this.options.duration - ); - } else { - this.pos = eased = percent; - } - this.now = ( this.end - this.start ) * eased + this.start; - - if ( this.options.step ) { - this.options.step.call( this.elem, this.now, this ); - } - - if ( hooks && hooks.set ) { - hooks.set( this ); - } else { - Tween.propHooks._default.set( this ); - } - return this; - } -}; - -Tween.prototype.init.prototype = Tween.prototype; - -Tween.propHooks = { - _default: { - get: function( tween ) { - var result; - - // Use a property on the element directly when it is not a DOM element, - // or when there is no matching style property that exists. - if ( tween.elem.nodeType !== 1 || - tween.elem[ tween.prop ] != null && tween.elem.style[ tween.prop ] == null ) { - return tween.elem[ tween.prop ]; - } - - // Passing an empty string as a 3rd parameter to .css will automatically - // attempt a parseFloat and fallback to a string if the parse fails. - // Simple values such as "10px" are parsed to Float; - // complex values such as "rotate(1rad)" are returned as-is. - result = jQuery.css( tween.elem, tween.prop, "" ); - - // Empty strings, null, undefined and "auto" are converted to 0. - return !result || result === "auto" ? 0 : result; - }, - set: function( tween ) { - - // Use step hook for back compat. - // Use cssHook if its there. - // Use .style if available and use plain properties where available. - if ( jQuery.fx.step[ tween.prop ] ) { - jQuery.fx.step[ tween.prop ]( tween ); - } else if ( tween.elem.nodeType === 1 && ( - jQuery.cssHooks[ tween.prop ] || - tween.elem.style[ finalPropName( tween.prop ) ] != null ) ) { - jQuery.style( tween.elem, tween.prop, tween.now + tween.unit ); - } else { - tween.elem[ tween.prop ] = tween.now; - } - } - } -}; - -// Support: IE <=9 only -// Panic based approach to setting things on disconnected nodes -Tween.propHooks.scrollTop = Tween.propHooks.scrollLeft = { - set: function( tween ) { - if ( tween.elem.nodeType && tween.elem.parentNode ) { - tween.elem[ tween.prop ] = tween.now; - } - } -}; - -jQuery.easing = { - linear: function( p ) { - return p; - }, - swing: function( p ) { - return 0.5 - Math.cos( p * Math.PI ) / 2; - }, - _default: "swing" -}; - -jQuery.fx = Tween.prototype.init; - -// Back compat <1.8 extension point -jQuery.fx.step = {}; - - - - -var - fxNow, inProgress, - rfxtypes = /^(?:toggle|show|hide)$/, - rrun = /queueHooks$/; - -function schedule() { - if ( inProgress ) { - if ( document.hidden === false && window.requestAnimationFrame ) { - window.requestAnimationFrame( schedule ); - } else { - window.setTimeout( schedule, jQuery.fx.interval ); - } - - jQuery.fx.tick(); - } -} - -// Animations created synchronously will run synchronously -function createFxNow() { - window.setTimeout( function() { - fxNow = undefined; - } ); - return ( fxNow = Date.now() ); -} - -// Generate parameters to create a standard animation -function genFx( type, includeWidth ) { - var which, - i = 0, - attrs = { height: type }; - - // If we include width, step value is 1 to do all cssExpand values, - // otherwise step value is 2 to skip over Left and Right - includeWidth = includeWidth ? 1 : 0; - for ( ; i < 4; i += 2 - includeWidth ) { - which = cssExpand[ i ]; - attrs[ "margin" + which ] = attrs[ "padding" + which ] = type; - } - - if ( includeWidth ) { - attrs.opacity = attrs.width = type; - } - - return attrs; -} - -function createTween( value, prop, animation ) { - var tween, - collection = ( Animation.tweeners[ prop ] || [] ).concat( Animation.tweeners[ "*" ] ), - index = 0, - length = collection.length; - for ( ; index < length; index++ ) { - if ( ( tween = collection[ index ].call( animation, prop, value ) ) ) { - - // We're done with this property - return tween; - } - } -} - -function defaultPrefilter( elem, props, opts ) { - var prop, value, toggle, hooks, oldfire, propTween, restoreDisplay, display, - isBox = "width" in props || "height" in props, - anim = this, - orig = {}, - style = elem.style, - hidden = elem.nodeType && isHiddenWithinTree( elem ), - dataShow = dataPriv.get( elem, "fxshow" ); - - // Queue-skipping animations hijack the fx hooks - if ( !opts.queue ) { - hooks = jQuery._queueHooks( elem, "fx" ); - if ( hooks.unqueued == null ) { - hooks.unqueued = 0; - oldfire = hooks.empty.fire; - hooks.empty.fire = function() { - if ( !hooks.unqueued ) { - oldfire(); - } - }; - } - hooks.unqueued++; - - anim.always( function() { - - // Ensure the complete handler is called before this completes - anim.always( function() { - hooks.unqueued--; - if ( !jQuery.queue( elem, "fx" ).length ) { - hooks.empty.fire(); - } - } ); - } ); - } - - // Detect show/hide animations - for ( prop in props ) { - value = props[ prop ]; - if ( rfxtypes.test( value ) ) { - delete props[ prop ]; - toggle = toggle || value === "toggle"; - if ( value === ( hidden ? "hide" : "show" ) ) { - - // Pretend to be hidden if this is a "show" and - // there is still data from a stopped show/hide - if ( value === "show" && dataShow && dataShow[ prop ] !== undefined ) { - hidden = true; - - // Ignore all other no-op show/hide data - } else { - continue; - } - } - orig[ prop ] = dataShow && dataShow[ prop ] || jQuery.style( elem, prop ); - } - } - - // Bail out if this is a no-op like .hide().hide() - propTween = !jQuery.isEmptyObject( props ); - if ( !propTween && jQuery.isEmptyObject( orig ) ) { - return; - } - - // Restrict "overflow" and "display" styles during box animations - if ( isBox && elem.nodeType === 1 ) { - - // Support: IE <=9 - 11, Edge 12 - 15 - // Record all 3 overflow attributes because IE does not infer the shorthand - // from identically-valued overflowX and overflowY and Edge just mirrors - // the overflowX value there. - opts.overflow = [ style.overflow, style.overflowX, style.overflowY ]; - - // Identify a display type, preferring old show/hide data over the CSS cascade - restoreDisplay = dataShow && dataShow.display; - if ( restoreDisplay == null ) { - restoreDisplay = dataPriv.get( elem, "display" ); - } - display = jQuery.css( elem, "display" ); - if ( display === "none" ) { - if ( restoreDisplay ) { - display = restoreDisplay; - } else { - - // Get nonempty value(s) by temporarily forcing visibility - showHide( [ elem ], true ); - restoreDisplay = elem.style.display || restoreDisplay; - display = jQuery.css( elem, "display" ); - showHide( [ elem ] ); - } - } - - // Animate inline elements as inline-block - if ( display === "inline" || display === "inline-block" && restoreDisplay != null ) { - if ( jQuery.css( elem, "float" ) === "none" ) { - - // Restore the original display value at the end of pure show/hide animations - if ( !propTween ) { - anim.done( function() { - style.display = restoreDisplay; - } ); - if ( restoreDisplay == null ) { - display = style.display; - restoreDisplay = display === "none" ? "" : display; - } - } - style.display = "inline-block"; - } - } - } - - if ( opts.overflow ) { - style.overflow = "hidden"; - anim.always( function() { - style.overflow = opts.overflow[ 0 ]; - style.overflowX = opts.overflow[ 1 ]; - style.overflowY = opts.overflow[ 2 ]; - } ); - } - - // Implement show/hide animations - propTween = false; - for ( prop in orig ) { - - // General show/hide setup for this element animation - if ( !propTween ) { - if ( dataShow ) { - if ( "hidden" in dataShow ) { - hidden = dataShow.hidden; - } - } else { - dataShow = dataPriv.access( elem, "fxshow", { display: restoreDisplay } ); - } - - // Store hidden/visible for toggle so `.stop().toggle()` "reverses" - if ( toggle ) { - dataShow.hidden = !hidden; - } - - // Show elements before animating them - if ( hidden ) { - showHide( [ elem ], true ); - } - - /* eslint-disable no-loop-func */ - - anim.done( function() { - - /* eslint-enable no-loop-func */ - - // The final step of a "hide" animation is actually hiding the element - if ( !hidden ) { - showHide( [ elem ] ); - } - dataPriv.remove( elem, "fxshow" ); - for ( prop in orig ) { - jQuery.style( elem, prop, orig[ prop ] ); - } - } ); - } - - // Per-property setup - propTween = createTween( hidden ? dataShow[ prop ] : 0, prop, anim ); - if ( !( prop in dataShow ) ) { - dataShow[ prop ] = propTween.start; - if ( hidden ) { - propTween.end = propTween.start; - propTween.start = 0; - } - } - } -} - -function propFilter( props, specialEasing ) { - var index, name, easing, value, hooks; - - // camelCase, specialEasing and expand cssHook pass - for ( index in props ) { - name = camelCase( index ); - easing = specialEasing[ name ]; - value = props[ index ]; - if ( Array.isArray( value ) ) { - easing = value[ 1 ]; - value = props[ index ] = value[ 0 ]; - } - - if ( index !== name ) { - props[ name ] = value; - delete props[ index ]; - } - - hooks = jQuery.cssHooks[ name ]; - if ( hooks && "expand" in hooks ) { - value = hooks.expand( value ); - delete props[ name ]; - - // Not quite $.extend, this won't overwrite existing keys. - // Reusing 'index' because we have the correct "name" - for ( index in value ) { - if ( !( index in props ) ) { - props[ index ] = value[ index ]; - specialEasing[ index ] = easing; - } - } - } else { - specialEasing[ name ] = easing; - } - } -} - -function Animation( elem, properties, options ) { - var result, - stopped, - index = 0, - length = Animation.prefilters.length, - deferred = jQuery.Deferred().always( function() { - - // Don't match elem in the :animated selector - delete tick.elem; - } ), - tick = function() { - if ( stopped ) { - return false; - } - var currentTime = fxNow || createFxNow(), - remaining = Math.max( 0, animation.startTime + animation.duration - currentTime ), - - // Support: Android 2.3 only - // Archaic crash bug won't allow us to use `1 - ( 0.5 || 0 )` (#12497) - temp = remaining / animation.duration || 0, - percent = 1 - temp, - index = 0, - length = animation.tweens.length; - - for ( ; index < length; index++ ) { - animation.tweens[ index ].run( percent ); - } - - deferred.notifyWith( elem, [ animation, percent, remaining ] ); - - // If there's more to do, yield - if ( percent < 1 && length ) { - return remaining; - } - - // If this was an empty animation, synthesize a final progress notification - if ( !length ) { - deferred.notifyWith( elem, [ animation, 1, 0 ] ); - } - - // Resolve the animation and report its conclusion - deferred.resolveWith( elem, [ animation ] ); - return false; - }, - animation = deferred.promise( { - elem: elem, - props: jQuery.extend( {}, properties ), - opts: jQuery.extend( true, { - specialEasing: {}, - easing: jQuery.easing._default - }, options ), - originalProperties: properties, - originalOptions: options, - startTime: fxNow || createFxNow(), - duration: options.duration, - tweens: [], - createTween: function( prop, end ) { - var tween = jQuery.Tween( elem, animation.opts, prop, end, - animation.opts.specialEasing[ prop ] || animation.opts.easing ); - animation.tweens.push( tween ); - return tween; - }, - stop: function( gotoEnd ) { - var index = 0, - - // If we are going to the end, we want to run all the tweens - // otherwise we skip this part - length = gotoEnd ? animation.tweens.length : 0; - if ( stopped ) { - return this; - } - stopped = true; - for ( ; index < length; index++ ) { - animation.tweens[ index ].run( 1 ); - } - - // Resolve when we played the last frame; otherwise, reject - if ( gotoEnd ) { - deferred.notifyWith( elem, [ animation, 1, 0 ] ); - deferred.resolveWith( elem, [ animation, gotoEnd ] ); - } else { - deferred.rejectWith( elem, [ animation, gotoEnd ] ); - } - return this; - } - } ), - props = animation.props; - - propFilter( props, animation.opts.specialEasing ); - - for ( ; index < length; index++ ) { - result = Animation.prefilters[ index ].call( animation, elem, props, animation.opts ); - if ( result ) { - if ( isFunction( result.stop ) ) { - jQuery._queueHooks( animation.elem, animation.opts.queue ).stop = - result.stop.bind( result ); - } - return result; - } - } - - jQuery.map( props, createTween, animation ); - - if ( isFunction( animation.opts.start ) ) { - animation.opts.start.call( elem, animation ); - } - - // Attach callbacks from options - animation - .progress( animation.opts.progress ) - .done( animation.opts.done, animation.opts.complete ) - .fail( animation.opts.fail ) - .always( animation.opts.always ); - - jQuery.fx.timer( - jQuery.extend( tick, { - elem: elem, - anim: animation, - queue: animation.opts.queue - } ) - ); - - return animation; -} - -jQuery.Animation = jQuery.extend( Animation, { - - tweeners: { - "*": [ function( prop, value ) { - var tween = this.createTween( prop, value ); - adjustCSS( tween.elem, prop, rcssNum.exec( value ), tween ); - return tween; - } ] - }, - - tweener: function( props, callback ) { - if ( isFunction( props ) ) { - callback = props; - props = [ "*" ]; - } else { - props = props.match( rnothtmlwhite ); - } - - var prop, - index = 0, - length = props.length; - - for ( ; index < length; index++ ) { - prop = props[ index ]; - Animation.tweeners[ prop ] = Animation.tweeners[ prop ] || []; - Animation.tweeners[ prop ].unshift( callback ); - } - }, - - prefilters: [ defaultPrefilter ], - - prefilter: function( callback, prepend ) { - if ( prepend ) { - Animation.prefilters.unshift( callback ); - } else { - Animation.prefilters.push( callback ); - } - } -} ); - -jQuery.speed = function( speed, easing, fn ) { - var opt = speed && typeof speed === "object" ? jQuery.extend( {}, speed ) : { - complete: fn || !fn && easing || - isFunction( speed ) && speed, - duration: speed, - easing: fn && easing || easing && !isFunction( easing ) && easing - }; - - // Go to the end state if fx are off - if ( jQuery.fx.off ) { - opt.duration = 0; - - } else { - if ( typeof opt.duration !== "number" ) { - if ( opt.duration in jQuery.fx.speeds ) { - opt.duration = jQuery.fx.speeds[ opt.duration ]; - - } else { - opt.duration = jQuery.fx.speeds._default; - } - } - } - - // Normalize opt.queue - true/undefined/null -> "fx" - if ( opt.queue == null || opt.queue === true ) { - opt.queue = "fx"; - } - - // Queueing - opt.old = opt.complete; - - opt.complete = function() { - if ( isFunction( opt.old ) ) { - opt.old.call( this ); - } - - if ( opt.queue ) { - jQuery.dequeue( this, opt.queue ); - } - }; - - return opt; -}; - -jQuery.fn.extend( { - fadeTo: function( speed, to, easing, callback ) { - - // Show any hidden elements after setting opacity to 0 - return this.filter( isHiddenWithinTree ).css( "opacity", 0 ).show() - - // Animate to the value specified - .end().animate( { opacity: to }, speed, easing, callback ); - }, - animate: function( prop, speed, easing, callback ) { - var empty = jQuery.isEmptyObject( prop ), - optall = jQuery.speed( speed, easing, callback ), - doAnimation = function() { - - // Operate on a copy of prop so per-property easing won't be lost - var anim = Animation( this, jQuery.extend( {}, prop ), optall ); - - // Empty animations, or finishing resolves immediately - if ( empty || dataPriv.get( this, "finish" ) ) { - anim.stop( true ); - } - }; - doAnimation.finish = doAnimation; - - return empty || optall.queue === false ? - this.each( doAnimation ) : - this.queue( optall.queue, doAnimation ); - }, - stop: function( type, clearQueue, gotoEnd ) { - var stopQueue = function( hooks ) { - var stop = hooks.stop; - delete hooks.stop; - stop( gotoEnd ); - }; - - if ( typeof type !== "string" ) { - gotoEnd = clearQueue; - clearQueue = type; - type = undefined; - } - if ( clearQueue ) { - this.queue( type || "fx", [] ); - } - - return this.each( function() { - var dequeue = true, - index = type != null && type + "queueHooks", - timers = jQuery.timers, - data = dataPriv.get( this ); - - if ( index ) { - if ( data[ index ] && data[ index ].stop ) { - stopQueue( data[ index ] ); - } - } else { - for ( index in data ) { - if ( data[ index ] && data[ index ].stop && rrun.test( index ) ) { - stopQueue( data[ index ] ); - } - } - } - - for ( index = timers.length; index--; ) { - if ( timers[ index ].elem === this && - ( type == null || timers[ index ].queue === type ) ) { - - timers[ index ].anim.stop( gotoEnd ); - dequeue = false; - timers.splice( index, 1 ); - } - } - - // Start the next in the queue if the last step wasn't forced. - // Timers currently will call their complete callbacks, which - // will dequeue but only if they were gotoEnd. - if ( dequeue || !gotoEnd ) { - jQuery.dequeue( this, type ); - } - } ); - }, - finish: function( type ) { - if ( type !== false ) { - type = type || "fx"; - } - return this.each( function() { - var index, - data = dataPriv.get( this ), - queue = data[ type + "queue" ], - hooks = data[ type + "queueHooks" ], - timers = jQuery.timers, - length = queue ? queue.length : 0; - - // Enable finishing flag on private data - data.finish = true; - - // Empty the queue first - jQuery.queue( this, type, [] ); - - if ( hooks && hooks.stop ) { - hooks.stop.call( this, true ); - } - - // Look for any active animations, and finish them - for ( index = timers.length; index--; ) { - if ( timers[ index ].elem === this && timers[ index ].queue === type ) { - timers[ index ].anim.stop( true ); - timers.splice( index, 1 ); - } - } - - // Look for any animations in the old queue and finish them - for ( index = 0; index < length; index++ ) { - if ( queue[ index ] && queue[ index ].finish ) { - queue[ index ].finish.call( this ); - } - } - - // Turn off finishing flag - delete data.finish; - } ); - } -} ); - -jQuery.each( [ "toggle", "show", "hide" ], function( _i, name ) { - var cssFn = jQuery.fn[ name ]; - jQuery.fn[ name ] = function( speed, easing, callback ) { - return speed == null || typeof speed === "boolean" ? - cssFn.apply( this, arguments ) : - this.animate( genFx( name, true ), speed, easing, callback ); - }; -} ); - -// Generate shortcuts for custom animations -jQuery.each( { - slideDown: genFx( "show" ), - slideUp: genFx( "hide" ), - slideToggle: genFx( "toggle" ), - fadeIn: { opacity: "show" }, - fadeOut: { opacity: "hide" }, - fadeToggle: { opacity: "toggle" } -}, function( name, props ) { - jQuery.fn[ name ] = function( speed, easing, callback ) { - return this.animate( props, speed, easing, callback ); - }; -} ); - -jQuery.timers = []; -jQuery.fx.tick = function() { - var timer, - i = 0, - timers = jQuery.timers; - - fxNow = Date.now(); - - for ( ; i < timers.length; i++ ) { - timer = timers[ i ]; - - // Run the timer and safely remove it when done (allowing for external removal) - if ( !timer() && timers[ i ] === timer ) { - timers.splice( i--, 1 ); - } - } - - if ( !timers.length ) { - jQuery.fx.stop(); - } - fxNow = undefined; -}; - -jQuery.fx.timer = function( timer ) { - jQuery.timers.push( timer ); - jQuery.fx.start(); -}; - -jQuery.fx.interval = 13; -jQuery.fx.start = function() { - if ( inProgress ) { - return; - } - - inProgress = true; - schedule(); -}; - -jQuery.fx.stop = function() { - inProgress = null; -}; - -jQuery.fx.speeds = { - slow: 600, - fast: 200, - - // Default speed - _default: 400 -}; - - -// Based off of the plugin by Clint Helfers, with permission. -// https://web.archive.org/web/20100324014747/http://blindsignals.com/index.php/2009/07/jquery-delay/ -jQuery.fn.delay = function( time, type ) { - time = jQuery.fx ? jQuery.fx.speeds[ time ] || time : time; - type = type || "fx"; - - return this.queue( type, function( next, hooks ) { - var timeout = window.setTimeout( next, time ); - hooks.stop = function() { - window.clearTimeout( timeout ); - }; - } ); -}; - - -( function() { - var input = document.createElement( "input" ), - select = document.createElement( "select" ), - opt = select.appendChild( document.createElement( "option" ) ); - - input.type = "checkbox"; - - // Support: Android <=4.3 only - // Default value for a checkbox should be "on" - support.checkOn = input.value !== ""; - - // Support: IE <=11 only - // Must access selectedIndex to make default options select - support.optSelected = opt.selected; - - // Support: IE <=11 only - // An input loses its value after becoming a radio - input = document.createElement( "input" ); - input.value = "t"; - input.type = "radio"; - support.radioValue = input.value === "t"; -} )(); - - -var boolHook, - attrHandle = jQuery.expr.attrHandle; - -jQuery.fn.extend( { - attr: function( name, value ) { - return access( this, jQuery.attr, name, value, arguments.length > 1 ); - }, - - removeAttr: function( name ) { - return this.each( function() { - jQuery.removeAttr( this, name ); - } ); - } -} ); - -jQuery.extend( { - attr: function( elem, name, value ) { - var ret, hooks, - nType = elem.nodeType; - - // Don't get/set attributes on text, comment and attribute nodes - if ( nType === 3 || nType === 8 || nType === 2 ) { - return; - } - - // Fallback to prop when attributes are not supported - if ( typeof elem.getAttribute === "undefined" ) { - return jQuery.prop( elem, name, value ); - } - - // Attribute hooks are determined by the lowercase version - // Grab necessary hook if one is defined - if ( nType !== 1 || !jQuery.isXMLDoc( elem ) ) { - hooks = jQuery.attrHooks[ name.toLowerCase() ] || - ( jQuery.expr.match.bool.test( name ) ? boolHook : undefined ); - } - - if ( value !== undefined ) { - if ( value === null ) { - jQuery.removeAttr( elem, name ); - return; - } - - if ( hooks && "set" in hooks && - ( ret = hooks.set( elem, value, name ) ) !== undefined ) { - return ret; - } - - elem.setAttribute( name, value + "" ); - return value; - } - - if ( hooks && "get" in hooks && ( ret = hooks.get( elem, name ) ) !== null ) { - return ret; - } - - ret = jQuery.find.attr( elem, name ); - - // Non-existent attributes return null, we normalize to undefined - return ret == null ? undefined : ret; - }, - - attrHooks: { - type: { - set: function( elem, value ) { - if ( !support.radioValue && value === "radio" && - nodeName( elem, "input" ) ) { - var val = elem.value; - elem.setAttribute( "type", value ); - if ( val ) { - elem.value = val; - } - return value; - } - } - } - }, - - removeAttr: function( elem, value ) { - var name, - i = 0, - - // Attribute names can contain non-HTML whitespace characters - // https://html.spec.whatwg.org/multipage/syntax.html#attributes-2 - attrNames = value && value.match( rnothtmlwhite ); - - if ( attrNames && elem.nodeType === 1 ) { - while ( ( name = attrNames[ i++ ] ) ) { - elem.removeAttribute( name ); - } - } - } -} ); - -// Hooks for boolean attributes -boolHook = { - set: function( elem, value, name ) { - if ( value === false ) { - - // Remove boolean attributes when set to false - jQuery.removeAttr( elem, name ); - } else { - elem.setAttribute( name, name ); - } - return name; - } -}; - -jQuery.each( jQuery.expr.match.bool.source.match( /\w+/g ), function( _i, name ) { - var getter = attrHandle[ name ] || jQuery.find.attr; - - attrHandle[ name ] = function( elem, name, isXML ) { - var ret, handle, - lowercaseName = name.toLowerCase(); - - if ( !isXML ) { - - // Avoid an infinite loop by temporarily removing this function from the getter - handle = attrHandle[ lowercaseName ]; - attrHandle[ lowercaseName ] = ret; - ret = getter( elem, name, isXML ) != null ? - lowercaseName : - null; - attrHandle[ lowercaseName ] = handle; - } - return ret; - }; -} ); - - - - -var rfocusable = /^(?:input|select|textarea|button)$/i, - rclickable = /^(?:a|area)$/i; - -jQuery.fn.extend( { - prop: function( name, value ) { - return access( this, jQuery.prop, name, value, arguments.length > 1 ); - }, - - removeProp: function( name ) { - return this.each( function() { - delete this[ jQuery.propFix[ name ] || name ]; - } ); - } -} ); - -jQuery.extend( { - prop: function( elem, name, value ) { - var ret, hooks, - nType = elem.nodeType; - - // Don't get/set properties on text, comment and attribute nodes - if ( nType === 3 || nType === 8 || nType === 2 ) { - return; - } - - if ( nType !== 1 || !jQuery.isXMLDoc( elem ) ) { - - // Fix name and attach hooks - name = jQuery.propFix[ name ] || name; - hooks = jQuery.propHooks[ name ]; - } - - if ( value !== undefined ) { - if ( hooks && "set" in hooks && - ( ret = hooks.set( elem, value, name ) ) !== undefined ) { - return ret; - } - - return ( elem[ name ] = value ); - } - - if ( hooks && "get" in hooks && ( ret = hooks.get( elem, name ) ) !== null ) { - return ret; - } - - return elem[ name ]; - }, - - propHooks: { - tabIndex: { - get: function( elem ) { - - // Support: IE <=9 - 11 only - // elem.tabIndex doesn't always return the - // correct value when it hasn't been explicitly set - // https://web.archive.org/web/20141116233347/http://fluidproject.org/blog/2008/01/09/getting-setting-and-removing-tabindex-values-with-javascript/ - // Use proper attribute retrieval(#12072) - var tabindex = jQuery.find.attr( elem, "tabindex" ); - - if ( tabindex ) { - return parseInt( tabindex, 10 ); - } - - if ( - rfocusable.test( elem.nodeName ) || - rclickable.test( elem.nodeName ) && - elem.href - ) { - return 0; - } - - return -1; - } - } - }, - - propFix: { - "for": "htmlFor", - "class": "className" - } -} ); - -// Support: IE <=11 only -// Accessing the selectedIndex property -// forces the browser to respect setting selected -// on the option -// The getter ensures a default option is selected -// when in an optgroup -// eslint rule "no-unused-expressions" is disabled for this code -// since it considers such accessions noop -if ( !support.optSelected ) { - jQuery.propHooks.selected = { - get: function( elem ) { - - /* eslint no-unused-expressions: "off" */ - - var parent = elem.parentNode; - if ( parent && parent.parentNode ) { - parent.parentNode.selectedIndex; - } - return null; - }, - set: function( elem ) { - - /* eslint no-unused-expressions: "off" */ - - var parent = elem.parentNode; - if ( parent ) { - parent.selectedIndex; - - if ( parent.parentNode ) { - parent.parentNode.selectedIndex; - } - } - } - }; -} - -jQuery.each( [ - "tabIndex", - "readOnly", - "maxLength", - "cellSpacing", - "cellPadding", - "rowSpan", - "colSpan", - "useMap", - "frameBorder", - "contentEditable" -], function() { - jQuery.propFix[ this.toLowerCase() ] = this; -} ); - - - - - // Strip and collapse whitespace according to HTML spec - // https://infra.spec.whatwg.org/#strip-and-collapse-ascii-whitespace - function stripAndCollapse( value ) { - var tokens = value.match( rnothtmlwhite ) || []; - return tokens.join( " " ); - } - - -function getClass( elem ) { - return elem.getAttribute && elem.getAttribute( "class" ) || ""; -} - -function classesToArray( value ) { - if ( Array.isArray( value ) ) { - return value; - } - if ( typeof value === "string" ) { - return value.match( rnothtmlwhite ) || []; - } - return []; -} - -jQuery.fn.extend( { - addClass: function( value ) { - var classes, elem, cur, curValue, clazz, j, finalValue, - i = 0; - - if ( isFunction( value ) ) { - return this.each( function( j ) { - jQuery( this ).addClass( value.call( this, j, getClass( this ) ) ); - } ); - } - - classes = classesToArray( value ); - - if ( classes.length ) { - while ( ( elem = this[ i++ ] ) ) { - curValue = getClass( elem ); - cur = elem.nodeType === 1 && ( " " + stripAndCollapse( curValue ) + " " ); - - if ( cur ) { - j = 0; - while ( ( clazz = classes[ j++ ] ) ) { - if ( cur.indexOf( " " + clazz + " " ) < 0 ) { - cur += clazz + " "; - } - } - - // Only assign if different to avoid unneeded rendering. - finalValue = stripAndCollapse( cur ); - if ( curValue !== finalValue ) { - elem.setAttribute( "class", finalValue ); - } - } - } - } - - return this; - }, - - removeClass: function( value ) { - var classes, elem, cur, curValue, clazz, j, finalValue, - i = 0; - - if ( isFunction( value ) ) { - return this.each( function( j ) { - jQuery( this ).removeClass( value.call( this, j, getClass( this ) ) ); - } ); - } - - if ( !arguments.length ) { - return this.attr( "class", "" ); - } - - classes = classesToArray( value ); - - if ( classes.length ) { - while ( ( elem = this[ i++ ] ) ) { - curValue = getClass( elem ); - - // This expression is here for better compressibility (see addClass) - cur = elem.nodeType === 1 && ( " " + stripAndCollapse( curValue ) + " " ); - - if ( cur ) { - j = 0; - while ( ( clazz = classes[ j++ ] ) ) { - - // Remove *all* instances - while ( cur.indexOf( " " + clazz + " " ) > -1 ) { - cur = cur.replace( " " + clazz + " ", " " ); - } - } - - // Only assign if different to avoid unneeded rendering. - finalValue = stripAndCollapse( cur ); - if ( curValue !== finalValue ) { - elem.setAttribute( "class", finalValue ); - } - } - } - } - - return this; - }, - - toggleClass: function( value, stateVal ) { - var type = typeof value, - isValidValue = type === "string" || Array.isArray( value ); - - if ( typeof stateVal === "boolean" && isValidValue ) { - return stateVal ? this.addClass( value ) : this.removeClass( value ); - } - - if ( isFunction( value ) ) { - return this.each( function( i ) { - jQuery( this ).toggleClass( - value.call( this, i, getClass( this ), stateVal ), - stateVal - ); - } ); - } - - return this.each( function() { - var className, i, self, classNames; - - if ( isValidValue ) { - - // Toggle individual class names - i = 0; - self = jQuery( this ); - classNames = classesToArray( value ); - - while ( ( className = classNames[ i++ ] ) ) { - - // Check each className given, space separated list - if ( self.hasClass( className ) ) { - self.removeClass( className ); - } else { - self.addClass( className ); - } - } - - // Toggle whole class name - } else if ( value === undefined || type === "boolean" ) { - className = getClass( this ); - if ( className ) { - - // Store className if set - dataPriv.set( this, "__className__", className ); - } - - // If the element has a class name or if we're passed `false`, - // then remove the whole classname (if there was one, the above saved it). - // Otherwise bring back whatever was previously saved (if anything), - // falling back to the empty string if nothing was stored. - if ( this.setAttribute ) { - this.setAttribute( "class", - className || value === false ? - "" : - dataPriv.get( this, "__className__" ) || "" - ); - } - } - } ); - }, - - hasClass: function( selector ) { - var className, elem, - i = 0; - - className = " " + selector + " "; - while ( ( elem = this[ i++ ] ) ) { - if ( elem.nodeType === 1 && - ( " " + stripAndCollapse( getClass( elem ) ) + " " ).indexOf( className ) > -1 ) { - return true; - } - } - - return false; - } -} ); - - - - -var rreturn = /\r/g; - -jQuery.fn.extend( { - val: function( value ) { - var hooks, ret, valueIsFunction, - elem = this[ 0 ]; - - if ( !arguments.length ) { - if ( elem ) { - hooks = jQuery.valHooks[ elem.type ] || - jQuery.valHooks[ elem.nodeName.toLowerCase() ]; - - if ( hooks && - "get" in hooks && - ( ret = hooks.get( elem, "value" ) ) !== undefined - ) { - return ret; - } - - ret = elem.value; - - // Handle most common string cases - if ( typeof ret === "string" ) { - return ret.replace( rreturn, "" ); - } - - // Handle cases where value is null/undef or number - return ret == null ? "" : ret; - } - - return; - } - - valueIsFunction = isFunction( value ); - - return this.each( function( i ) { - var val; - - if ( this.nodeType !== 1 ) { - return; - } - - if ( valueIsFunction ) { - val = value.call( this, i, jQuery( this ).val() ); - } else { - val = value; - } - - // Treat null/undefined as ""; convert numbers to string - if ( val == null ) { - val = ""; - - } else if ( typeof val === "number" ) { - val += ""; - - } else if ( Array.isArray( val ) ) { - val = jQuery.map( val, function( value ) { - return value == null ? "" : value + ""; - } ); - } - - hooks = jQuery.valHooks[ this.type ] || jQuery.valHooks[ this.nodeName.toLowerCase() ]; - - // If set returns undefined, fall back to normal setting - if ( !hooks || !( "set" in hooks ) || hooks.set( this, val, "value" ) === undefined ) { - this.value = val; - } - } ); - } -} ); - -jQuery.extend( { - valHooks: { - option: { - get: function( elem ) { - - var val = jQuery.find.attr( elem, "value" ); - return val != null ? - val : - - // Support: IE <=10 - 11 only - // option.text throws exceptions (#14686, #14858) - // Strip and collapse whitespace - // https://html.spec.whatwg.org/#strip-and-collapse-whitespace - stripAndCollapse( jQuery.text( elem ) ); - } - }, - select: { - get: function( elem ) { - var value, option, i, - options = elem.options, - index = elem.selectedIndex, - one = elem.type === "select-one", - values = one ? null : [], - max = one ? index + 1 : options.length; - - if ( index < 0 ) { - i = max; - - } else { - i = one ? index : 0; - } - - // Loop through all the selected options - for ( ; i < max; i++ ) { - option = options[ i ]; - - // Support: IE <=9 only - // IE8-9 doesn't update selected after form reset (#2551) - if ( ( option.selected || i === index ) && - - // Don't return options that are disabled or in a disabled optgroup - !option.disabled && - ( !option.parentNode.disabled || - !nodeName( option.parentNode, "optgroup" ) ) ) { - - // Get the specific value for the option - value = jQuery( option ).val(); - - // We don't need an array for one selects - if ( one ) { - return value; - } - - // Multi-Selects return an array - values.push( value ); - } - } - - return values; - }, - - set: function( elem, value ) { - var optionSet, option, - options = elem.options, - values = jQuery.makeArray( value ), - i = options.length; - - while ( i-- ) { - option = options[ i ]; - - /* eslint-disable no-cond-assign */ - - if ( option.selected = - jQuery.inArray( jQuery.valHooks.option.get( option ), values ) > -1 - ) { - optionSet = true; - } - - /* eslint-enable no-cond-assign */ - } - - // Force browsers to behave consistently when non-matching value is set - if ( !optionSet ) { - elem.selectedIndex = -1; - } - return values; - } - } - } -} ); - -// Radios and checkboxes getter/setter -jQuery.each( [ "radio", "checkbox" ], function() { - jQuery.valHooks[ this ] = { - set: function( elem, value ) { - if ( Array.isArray( value ) ) { - return ( elem.checked = jQuery.inArray( jQuery( elem ).val(), value ) > -1 ); - } - } - }; - if ( !support.checkOn ) { - jQuery.valHooks[ this ].get = function( elem ) { - return elem.getAttribute( "value" ) === null ? "on" : elem.value; - }; - } -} ); - - - - -// Return jQuery for attributes-only inclusion - - -support.focusin = "onfocusin" in window; - - -var rfocusMorph = /^(?:focusinfocus|focusoutblur)$/, - stopPropagationCallback = function( e ) { - e.stopPropagation(); - }; - -jQuery.extend( jQuery.event, { - - trigger: function( event, data, elem, onlyHandlers ) { - - var i, cur, tmp, bubbleType, ontype, handle, special, lastElement, - eventPath = [ elem || document ], - type = hasOwn.call( event, "type" ) ? event.type : event, - namespaces = hasOwn.call( event, "namespace" ) ? event.namespace.split( "." ) : []; - - cur = lastElement = tmp = elem = elem || document; - - // Don't do events on text and comment nodes - if ( elem.nodeType === 3 || elem.nodeType === 8 ) { - return; - } - - // focus/blur morphs to focusin/out; ensure we're not firing them right now - if ( rfocusMorph.test( type + jQuery.event.triggered ) ) { - return; - } - - if ( type.indexOf( "." ) > -1 ) { - - // Namespaced trigger; create a regexp to match event type in handle() - namespaces = type.split( "." ); - type = namespaces.shift(); - namespaces.sort(); - } - ontype = type.indexOf( ":" ) < 0 && "on" + type; - - // Caller can pass in a jQuery.Event object, Object, or just an event type string - event = event[ jQuery.expando ] ? - event : - new jQuery.Event( type, typeof event === "object" && event ); - - // Trigger bitmask: & 1 for native handlers; & 2 for jQuery (always true) - event.isTrigger = onlyHandlers ? 2 : 3; - event.namespace = namespaces.join( "." ); - event.rnamespace = event.namespace ? - new RegExp( "(^|\\.)" + namespaces.join( "\\.(?:.*\\.|)" ) + "(\\.|$)" ) : - null; - - // Clean up the event in case it is being reused - event.result = undefined; - if ( !event.target ) { - event.target = elem; - } - - // Clone any incoming data and prepend the event, creating the handler arg list - data = data == null ? - [ event ] : - jQuery.makeArray( data, [ event ] ); - - // Allow special events to draw outside the lines - special = jQuery.event.special[ type ] || {}; - if ( !onlyHandlers && special.trigger && special.trigger.apply( elem, data ) === false ) { - return; - } - - // Determine event propagation path in advance, per W3C events spec (#9951) - // Bubble up to document, then to window; watch for a global ownerDocument var (#9724) - if ( !onlyHandlers && !special.noBubble && !isWindow( elem ) ) { - - bubbleType = special.delegateType || type; - if ( !rfocusMorph.test( bubbleType + type ) ) { - cur = cur.parentNode; - } - for ( ; cur; cur = cur.parentNode ) { - eventPath.push( cur ); - tmp = cur; - } - - // Only add window if we got to document (e.g., not plain obj or detached DOM) - if ( tmp === ( elem.ownerDocument || document ) ) { - eventPath.push( tmp.defaultView || tmp.parentWindow || window ); - } - } - - // Fire handlers on the event path - i = 0; - while ( ( cur = eventPath[ i++ ] ) && !event.isPropagationStopped() ) { - lastElement = cur; - event.type = i > 1 ? - bubbleType : - special.bindType || type; - - // jQuery handler - handle = ( - dataPriv.get( cur, "events" ) || Object.create( null ) - )[ event.type ] && - dataPriv.get( cur, "handle" ); - if ( handle ) { - handle.apply( cur, data ); - } - - // Native handler - handle = ontype && cur[ ontype ]; - if ( handle && handle.apply && acceptData( cur ) ) { - event.result = handle.apply( cur, data ); - if ( event.result === false ) { - event.preventDefault(); - } - } - } - event.type = type; - - // If nobody prevented the default action, do it now - if ( !onlyHandlers && !event.isDefaultPrevented() ) { - - if ( ( !special._default || - special._default.apply( eventPath.pop(), data ) === false ) && - acceptData( elem ) ) { - - // Call a native DOM method on the target with the same name as the event. - // Don't do default actions on window, that's where global variables be (#6170) - if ( ontype && isFunction( elem[ type ] ) && !isWindow( elem ) ) { - - // Don't re-trigger an onFOO event when we call its FOO() method - tmp = elem[ ontype ]; - - if ( tmp ) { - elem[ ontype ] = null; - } - - // Prevent re-triggering of the same event, since we already bubbled it above - jQuery.event.triggered = type; - - if ( event.isPropagationStopped() ) { - lastElement.addEventListener( type, stopPropagationCallback ); - } - - elem[ type ](); - - if ( event.isPropagationStopped() ) { - lastElement.removeEventListener( type, stopPropagationCallback ); - } - - jQuery.event.triggered = undefined; - - if ( tmp ) { - elem[ ontype ] = tmp; - } - } - } - } - - return event.result; - }, - - // Piggyback on a donor event to simulate a different one - // Used only for `focus(in | out)` events - simulate: function( type, elem, event ) { - var e = jQuery.extend( - new jQuery.Event(), - event, - { - type: type, - isSimulated: true - } - ); - - jQuery.event.trigger( e, null, elem ); - } - -} ); - -jQuery.fn.extend( { - - trigger: function( type, data ) { - return this.each( function() { - jQuery.event.trigger( type, data, this ); - } ); - }, - triggerHandler: function( type, data ) { - var elem = this[ 0 ]; - if ( elem ) { - return jQuery.event.trigger( type, data, elem, true ); - } - } -} ); - - -// Support: Firefox <=44 -// Firefox doesn't have focus(in | out) events -// Related ticket - https://bugzilla.mozilla.org/show_bug.cgi?id=687787 -// -// Support: Chrome <=48 - 49, Safari <=9.0 - 9.1 -// focus(in | out) events fire after focus & blur events, -// which is spec violation - http://www.w3.org/TR/DOM-Level-3-Events/#events-focusevent-event-order -// Related ticket - https://bugs.chromium.org/p/chromium/issues/detail?id=449857 -if ( !support.focusin ) { - jQuery.each( { focus: "focusin", blur: "focusout" }, function( orig, fix ) { - - // Attach a single capturing handler on the document while someone wants focusin/focusout - var handler = function( event ) { - jQuery.event.simulate( fix, event.target, jQuery.event.fix( event ) ); - }; - - jQuery.event.special[ fix ] = { - setup: function() { - - // Handle: regular nodes (via `this.ownerDocument`), window - // (via `this.document`) & document (via `this`). - var doc = this.ownerDocument || this.document || this, - attaches = dataPriv.access( doc, fix ); - - if ( !attaches ) { - doc.addEventListener( orig, handler, true ); - } - dataPriv.access( doc, fix, ( attaches || 0 ) + 1 ); - }, - teardown: function() { - var doc = this.ownerDocument || this.document || this, - attaches = dataPriv.access( doc, fix ) - 1; - - if ( !attaches ) { - doc.removeEventListener( orig, handler, true ); - dataPriv.remove( doc, fix ); - - } else { - dataPriv.access( doc, fix, attaches ); - } - } - }; - } ); -} -var location = window.location; - -var nonce = { guid: Date.now() }; - -var rquery = ( /\?/ ); - - - -// Cross-browser xml parsing -jQuery.parseXML = function( data ) { - var xml; - if ( !data || typeof data !== "string" ) { - return null; - } - - // Support: IE 9 - 11 only - // IE throws on parseFromString with invalid input. - try { - xml = ( new window.DOMParser() ).parseFromString( data, "text/xml" ); - } catch ( e ) { - xml = undefined; - } - - if ( !xml || xml.getElementsByTagName( "parsererror" ).length ) { - jQuery.error( "Invalid XML: " + data ); - } - return xml; -}; - - -var - rbracket = /\[\]$/, - rCRLF = /\r?\n/g, - rsubmitterTypes = /^(?:submit|button|image|reset|file)$/i, - rsubmittable = /^(?:input|select|textarea|keygen)/i; - -function buildParams( prefix, obj, traditional, add ) { - var name; - - if ( Array.isArray( obj ) ) { - - // Serialize array item. - jQuery.each( obj, function( i, v ) { - if ( traditional || rbracket.test( prefix ) ) { - - // Treat each array item as a scalar. - add( prefix, v ); - - } else { - - // Item is non-scalar (array or object), encode its numeric index. - buildParams( - prefix + "[" + ( typeof v === "object" && v != null ? i : "" ) + "]", - v, - traditional, - add - ); - } - } ); - - } else if ( !traditional && toType( obj ) === "object" ) { - - // Serialize object item. - for ( name in obj ) { - buildParams( prefix + "[" + name + "]", obj[ name ], traditional, add ); - } - - } else { - - // Serialize scalar item. - add( prefix, obj ); - } -} - -// Serialize an array of form elements or a set of -// key/values into a query string -jQuery.param = function( a, traditional ) { - var prefix, - s = [], - add = function( key, valueOrFunction ) { - - // If value is a function, invoke it and use its return value - var value = isFunction( valueOrFunction ) ? - valueOrFunction() : - valueOrFunction; - - s[ s.length ] = encodeURIComponent( key ) + "=" + - encodeURIComponent( value == null ? "" : value ); - }; - - if ( a == null ) { - return ""; - } - - // If an array was passed in, assume that it is an array of form elements. - if ( Array.isArray( a ) || ( a.jquery && !jQuery.isPlainObject( a ) ) ) { - - // Serialize the form elements - jQuery.each( a, function() { - add( this.name, this.value ); - } ); - - } else { - - // If traditional, encode the "old" way (the way 1.3.2 or older - // did it), otherwise encode params recursively. - for ( prefix in a ) { - buildParams( prefix, a[ prefix ], traditional, add ); - } - } - - // Return the resulting serialization - return s.join( "&" ); -}; - -jQuery.fn.extend( { - serialize: function() { - return jQuery.param( this.serializeArray() ); - }, - serializeArray: function() { - return this.map( function() { - - // Can add propHook for "elements" to filter or add form elements - var elements = jQuery.prop( this, "elements" ); - return elements ? jQuery.makeArray( elements ) : this; - } ) - .filter( function() { - var type = this.type; - - // Use .is( ":disabled" ) so that fieldset[disabled] works - return this.name && !jQuery( this ).is( ":disabled" ) && - rsubmittable.test( this.nodeName ) && !rsubmitterTypes.test( type ) && - ( this.checked || !rcheckableType.test( type ) ); - } ) - .map( function( _i, elem ) { - var val = jQuery( this ).val(); - - if ( val == null ) { - return null; - } - - if ( Array.isArray( val ) ) { - return jQuery.map( val, function( val ) { - return { name: elem.name, value: val.replace( rCRLF, "\r\n" ) }; - } ); - } - - return { name: elem.name, value: val.replace( rCRLF, "\r\n" ) }; - } ).get(); - } -} ); - - -var - r20 = /%20/g, - rhash = /#.*$/, - rantiCache = /([?&])_=[^&]*/, - rheaders = /^(.*?):[ \t]*([^\r\n]*)$/mg, - - // #7653, #8125, #8152: local protocol detection - rlocalProtocol = /^(?:about|app|app-storage|.+-extension|file|res|widget):$/, - rnoContent = /^(?:GET|HEAD)$/, - rprotocol = /^\/\//, - - /* Prefilters - * 1) They are useful to introduce custom dataTypes (see ajax/jsonp.js for an example) - * 2) These are called: - * - BEFORE asking for a transport - * - AFTER param serialization (s.data is a string if s.processData is true) - * 3) key is the dataType - * 4) the catchall symbol "*" can be used - * 5) execution will start with transport dataType and THEN continue down to "*" if needed - */ - prefilters = {}, - - /* Transports bindings - * 1) key is the dataType - * 2) the catchall symbol "*" can be used - * 3) selection will start with transport dataType and THEN go to "*" if needed - */ - transports = {}, - - // Avoid comment-prolog char sequence (#10098); must appease lint and evade compression - allTypes = "*/".concat( "*" ), - - // Anchor tag for parsing the document origin - originAnchor = document.createElement( "a" ); - originAnchor.href = location.href; - -// Base "constructor" for jQuery.ajaxPrefilter and jQuery.ajaxTransport -function addToPrefiltersOrTransports( structure ) { - - // dataTypeExpression is optional and defaults to "*" - return function( dataTypeExpression, func ) { - - if ( typeof dataTypeExpression !== "string" ) { - func = dataTypeExpression; - dataTypeExpression = "*"; - } - - var dataType, - i = 0, - dataTypes = dataTypeExpression.toLowerCase().match( rnothtmlwhite ) || []; - - if ( isFunction( func ) ) { - - // For each dataType in the dataTypeExpression - while ( ( dataType = dataTypes[ i++ ] ) ) { - - // Prepend if requested - if ( dataType[ 0 ] === "+" ) { - dataType = dataType.slice( 1 ) || "*"; - ( structure[ dataType ] = structure[ dataType ] || [] ).unshift( func ); - - // Otherwise append - } else { - ( structure[ dataType ] = structure[ dataType ] || [] ).push( func ); - } - } - } - }; -} - -// Base inspection function for prefilters and transports -function inspectPrefiltersOrTransports( structure, options, originalOptions, jqXHR ) { - - var inspected = {}, - seekingTransport = ( structure === transports ); - - function inspect( dataType ) { - var selected; - inspected[ dataType ] = true; - jQuery.each( structure[ dataType ] || [], function( _, prefilterOrFactory ) { - var dataTypeOrTransport = prefilterOrFactory( options, originalOptions, jqXHR ); - if ( typeof dataTypeOrTransport === "string" && - !seekingTransport && !inspected[ dataTypeOrTransport ] ) { - - options.dataTypes.unshift( dataTypeOrTransport ); - inspect( dataTypeOrTransport ); - return false; - } else if ( seekingTransport ) { - return !( selected = dataTypeOrTransport ); - } - } ); - return selected; - } - - return inspect( options.dataTypes[ 0 ] ) || !inspected[ "*" ] && inspect( "*" ); -} - -// A special extend for ajax options -// that takes "flat" options (not to be deep extended) -// Fixes #9887 -function ajaxExtend( target, src ) { - var key, deep, - flatOptions = jQuery.ajaxSettings.flatOptions || {}; - - for ( key in src ) { - if ( src[ key ] !== undefined ) { - ( flatOptions[ key ] ? target : ( deep || ( deep = {} ) ) )[ key ] = src[ key ]; - } - } - if ( deep ) { - jQuery.extend( true, target, deep ); - } - - return target; -} - -/* Handles responses to an ajax request: - * - finds the right dataType (mediates between content-type and expected dataType) - * - returns the corresponding response - */ -function ajaxHandleResponses( s, jqXHR, responses ) { - - var ct, type, finalDataType, firstDataType, - contents = s.contents, - dataTypes = s.dataTypes; - - // Remove auto dataType and get content-type in the process - while ( dataTypes[ 0 ] === "*" ) { - dataTypes.shift(); - if ( ct === undefined ) { - ct = s.mimeType || jqXHR.getResponseHeader( "Content-Type" ); - } - } - - // Check if we're dealing with a known content-type - if ( ct ) { - for ( type in contents ) { - if ( contents[ type ] && contents[ type ].test( ct ) ) { - dataTypes.unshift( type ); - break; - } - } - } - - // Check to see if we have a response for the expected dataType - if ( dataTypes[ 0 ] in responses ) { - finalDataType = dataTypes[ 0 ]; - } else { - - // Try convertible dataTypes - for ( type in responses ) { - if ( !dataTypes[ 0 ] || s.converters[ type + " " + dataTypes[ 0 ] ] ) { - finalDataType = type; - break; - } - if ( !firstDataType ) { - firstDataType = type; - } - } - - // Or just use first one - finalDataType = finalDataType || firstDataType; - } - - // If we found a dataType - // We add the dataType to the list if needed - // and return the corresponding response - if ( finalDataType ) { - if ( finalDataType !== dataTypes[ 0 ] ) { - dataTypes.unshift( finalDataType ); - } - return responses[ finalDataType ]; - } -} - -/* Chain conversions given the request and the original response - * Also sets the responseXXX fields on the jqXHR instance - */ -function ajaxConvert( s, response, jqXHR, isSuccess ) { - var conv2, current, conv, tmp, prev, - converters = {}, - - // Work with a copy of dataTypes in case we need to modify it for conversion - dataTypes = s.dataTypes.slice(); - - // Create converters map with lowercased keys - if ( dataTypes[ 1 ] ) { - for ( conv in s.converters ) { - converters[ conv.toLowerCase() ] = s.converters[ conv ]; - } - } - - current = dataTypes.shift(); - - // Convert to each sequential dataType - while ( current ) { - - if ( s.responseFields[ current ] ) { - jqXHR[ s.responseFields[ current ] ] = response; - } - - // Apply the dataFilter if provided - if ( !prev && isSuccess && s.dataFilter ) { - response = s.dataFilter( response, s.dataType ); - } - - prev = current; - current = dataTypes.shift(); - - if ( current ) { - - // There's only work to do if current dataType is non-auto - if ( current === "*" ) { - - current = prev; - - // Convert response if prev dataType is non-auto and differs from current - } else if ( prev !== "*" && prev !== current ) { - - // Seek a direct converter - conv = converters[ prev + " " + current ] || converters[ "* " + current ]; - - // If none found, seek a pair - if ( !conv ) { - for ( conv2 in converters ) { - - // If conv2 outputs current - tmp = conv2.split( " " ); - if ( tmp[ 1 ] === current ) { - - // If prev can be converted to accepted input - conv = converters[ prev + " " + tmp[ 0 ] ] || - converters[ "* " + tmp[ 0 ] ]; - if ( conv ) { - - // Condense equivalence converters - if ( conv === true ) { - conv = converters[ conv2 ]; - - // Otherwise, insert the intermediate dataType - } else if ( converters[ conv2 ] !== true ) { - current = tmp[ 0 ]; - dataTypes.unshift( tmp[ 1 ] ); - } - break; - } - } - } - } - - // Apply converter (if not an equivalence) - if ( conv !== true ) { - - // Unless errors are allowed to bubble, catch and return them - if ( conv && s.throws ) { - response = conv( response ); - } else { - try { - response = conv( response ); - } catch ( e ) { - return { - state: "parsererror", - error: conv ? e : "No conversion from " + prev + " to " + current - }; - } - } - } - } - } - } - - return { state: "success", data: response }; -} - -jQuery.extend( { - - // Counter for holding the number of active queries - active: 0, - - // Last-Modified header cache for next request - lastModified: {}, - etag: {}, - - ajaxSettings: { - url: location.href, - type: "GET", - isLocal: rlocalProtocol.test( location.protocol ), - global: true, - processData: true, - async: true, - contentType: "application/x-www-form-urlencoded; charset=UTF-8", - - /* - timeout: 0, - data: null, - dataType: null, - username: null, - password: null, - cache: null, - throws: false, - traditional: false, - headers: {}, - */ - - accepts: { - "*": allTypes, - text: "text/plain", - html: "text/html", - xml: "application/xml, text/xml", - json: "application/json, text/javascript" - }, - - contents: { - xml: /\bxml\b/, - html: /\bhtml/, - json: /\bjson\b/ - }, - - responseFields: { - xml: "responseXML", - text: "responseText", - json: "responseJSON" - }, - - // Data converters - // Keys separate source (or catchall "*") and destination types with a single space - converters: { - - // Convert anything to text - "* text": String, - - // Text to html (true = no transformation) - "text html": true, - - // Evaluate text as a json expression - "text json": JSON.parse, - - // Parse text as xml - "text xml": jQuery.parseXML - }, - - // For options that shouldn't be deep extended: - // you can add your own custom options here if - // and when you create one that shouldn't be - // deep extended (see ajaxExtend) - flatOptions: { - url: true, - context: true - } - }, - - // Creates a full fledged settings object into target - // with both ajaxSettings and settings fields. - // If target is omitted, writes into ajaxSettings. - ajaxSetup: function( target, settings ) { - return settings ? - - // Building a settings object - ajaxExtend( ajaxExtend( target, jQuery.ajaxSettings ), settings ) : - - // Extending ajaxSettings - ajaxExtend( jQuery.ajaxSettings, target ); - }, - - ajaxPrefilter: addToPrefiltersOrTransports( prefilters ), - ajaxTransport: addToPrefiltersOrTransports( transports ), - - // Main method - ajax: function( url, options ) { - - // If url is an object, simulate pre-1.5 signature - if ( typeof url === "object" ) { - options = url; - url = undefined; - } - - // Force options to be an object - options = options || {}; - - var transport, - - // URL without anti-cache param - cacheURL, - - // Response headers - responseHeadersString, - responseHeaders, - - // timeout handle - timeoutTimer, - - // Url cleanup var - urlAnchor, - - // Request state (becomes false upon send and true upon completion) - completed, - - // To know if global events are to be dispatched - fireGlobals, - - // Loop variable - i, - - // uncached part of the url - uncached, - - // Create the final options object - s = jQuery.ajaxSetup( {}, options ), - - // Callbacks context - callbackContext = s.context || s, - - // Context for global events is callbackContext if it is a DOM node or jQuery collection - globalEventContext = s.context && - ( callbackContext.nodeType || callbackContext.jquery ) ? - jQuery( callbackContext ) : - jQuery.event, - - // Deferreds - deferred = jQuery.Deferred(), - completeDeferred = jQuery.Callbacks( "once memory" ), - - // Status-dependent callbacks - statusCode = s.statusCode || {}, - - // Headers (they are sent all at once) - requestHeaders = {}, - requestHeadersNames = {}, - - // Default abort message - strAbort = "canceled", - - // Fake xhr - jqXHR = { - readyState: 0, - - // Builds headers hashtable if needed - getResponseHeader: function( key ) { - var match; - if ( completed ) { - if ( !responseHeaders ) { - responseHeaders = {}; - while ( ( match = rheaders.exec( responseHeadersString ) ) ) { - responseHeaders[ match[ 1 ].toLowerCase() + " " ] = - ( responseHeaders[ match[ 1 ].toLowerCase() + " " ] || [] ) - .concat( match[ 2 ] ); - } - } - match = responseHeaders[ key.toLowerCase() + " " ]; - } - return match == null ? null : match.join( ", " ); - }, - - // Raw string - getAllResponseHeaders: function() { - return completed ? responseHeadersString : null; - }, - - // Caches the header - setRequestHeader: function( name, value ) { - if ( completed == null ) { - name = requestHeadersNames[ name.toLowerCase() ] = - requestHeadersNames[ name.toLowerCase() ] || name; - requestHeaders[ name ] = value; - } - return this; - }, - - // Overrides response content-type header - overrideMimeType: function( type ) { - if ( completed == null ) { - s.mimeType = type; - } - return this; - }, - - // Status-dependent callbacks - statusCode: function( map ) { - var code; - if ( map ) { - if ( completed ) { - - // Execute the appropriate callbacks - jqXHR.always( map[ jqXHR.status ] ); - } else { - - // Lazy-add the new callbacks in a way that preserves old ones - for ( code in map ) { - statusCode[ code ] = [ statusCode[ code ], map[ code ] ]; - } - } - } - return this; - }, - - // Cancel the request - abort: function( statusText ) { - var finalText = statusText || strAbort; - if ( transport ) { - transport.abort( finalText ); - } - done( 0, finalText ); - return this; - } - }; - - // Attach deferreds - deferred.promise( jqXHR ); - - // Add protocol if not provided (prefilters might expect it) - // Handle falsy url in the settings object (#10093: consistency with old signature) - // We also use the url parameter if available - s.url = ( ( url || s.url || location.href ) + "" ) - .replace( rprotocol, location.protocol + "//" ); - - // Alias method option to type as per ticket #12004 - s.type = options.method || options.type || s.method || s.type; - - // Extract dataTypes list - s.dataTypes = ( s.dataType || "*" ).toLowerCase().match( rnothtmlwhite ) || [ "" ]; - - // A cross-domain request is in order when the origin doesn't match the current origin. - if ( s.crossDomain == null ) { - urlAnchor = document.createElement( "a" ); - - // Support: IE <=8 - 11, Edge 12 - 15 - // IE throws exception on accessing the href property if url is malformed, - // e.g. http://example.com:80x/ - try { - urlAnchor.href = s.url; - - // Support: IE <=8 - 11 only - // Anchor's host property isn't correctly set when s.url is relative - urlAnchor.href = urlAnchor.href; - s.crossDomain = originAnchor.protocol + "//" + originAnchor.host !== - urlAnchor.protocol + "//" + urlAnchor.host; - } catch ( e ) { - - // If there is an error parsing the URL, assume it is crossDomain, - // it can be rejected by the transport if it is invalid - s.crossDomain = true; - } - } - - // Convert data if not already a string - if ( s.data && s.processData && typeof s.data !== "string" ) { - s.data = jQuery.param( s.data, s.traditional ); - } - - // Apply prefilters - inspectPrefiltersOrTransports( prefilters, s, options, jqXHR ); - - // If request was aborted inside a prefilter, stop there - if ( completed ) { - return jqXHR; - } - - // We can fire global events as of now if asked to - // Don't fire events if jQuery.event is undefined in an AMD-usage scenario (#15118) - fireGlobals = jQuery.event && s.global; - - // Watch for a new set of requests - if ( fireGlobals && jQuery.active++ === 0 ) { - jQuery.event.trigger( "ajaxStart" ); - } - - // Uppercase the type - s.type = s.type.toUpperCase(); - - // Determine if request has content - s.hasContent = !rnoContent.test( s.type ); - - // Save the URL in case we're toying with the If-Modified-Since - // and/or If-None-Match header later on - // Remove hash to simplify url manipulation - cacheURL = s.url.replace( rhash, "" ); - - // More options handling for requests with no content - if ( !s.hasContent ) { - - // Remember the hash so we can put it back - uncached = s.url.slice( cacheURL.length ); - - // If data is available and should be processed, append data to url - if ( s.data && ( s.processData || typeof s.data === "string" ) ) { - cacheURL += ( rquery.test( cacheURL ) ? "&" : "?" ) + s.data; - - // #9682: remove data so that it's not used in an eventual retry - delete s.data; - } - - // Add or update anti-cache param if needed - if ( s.cache === false ) { - cacheURL = cacheURL.replace( rantiCache, "$1" ); - uncached = ( rquery.test( cacheURL ) ? "&" : "?" ) + "_=" + ( nonce.guid++ ) + - uncached; - } - - // Put hash and anti-cache on the URL that will be requested (gh-1732) - s.url = cacheURL + uncached; - - // Change '%20' to '+' if this is encoded form body content (gh-2658) - } else if ( s.data && s.processData && - ( s.contentType || "" ).indexOf( "application/x-www-form-urlencoded" ) === 0 ) { - s.data = s.data.replace( r20, "+" ); - } - - // Set the If-Modified-Since and/or If-None-Match header, if in ifModified mode. - if ( s.ifModified ) { - if ( jQuery.lastModified[ cacheURL ] ) { - jqXHR.setRequestHeader( "If-Modified-Since", jQuery.lastModified[ cacheURL ] ); - } - if ( jQuery.etag[ cacheURL ] ) { - jqXHR.setRequestHeader( "If-None-Match", jQuery.etag[ cacheURL ] ); - } - } - - // Set the correct header, if data is being sent - if ( s.data && s.hasContent && s.contentType !== false || options.contentType ) { - jqXHR.setRequestHeader( "Content-Type", s.contentType ); - } - - // Set the Accepts header for the server, depending on the dataType - jqXHR.setRequestHeader( - "Accept", - s.dataTypes[ 0 ] && s.accepts[ s.dataTypes[ 0 ] ] ? - s.accepts[ s.dataTypes[ 0 ] ] + - ( s.dataTypes[ 0 ] !== "*" ? ", " + allTypes + "; q=0.01" : "" ) : - s.accepts[ "*" ] - ); - - // Check for headers option - for ( i in s.headers ) { - jqXHR.setRequestHeader( i, s.headers[ i ] ); - } - - // Allow custom headers/mimetypes and early abort - if ( s.beforeSend && - ( s.beforeSend.call( callbackContext, jqXHR, s ) === false || completed ) ) { - - // Abort if not done already and return - return jqXHR.abort(); - } - - // Aborting is no longer a cancellation - strAbort = "abort"; - - // Install callbacks on deferreds - completeDeferred.add( s.complete ); - jqXHR.done( s.success ); - jqXHR.fail( s.error ); - - // Get transport - transport = inspectPrefiltersOrTransports( transports, s, options, jqXHR ); - - // If no transport, we auto-abort - if ( !transport ) { - done( -1, "No Transport" ); - } else { - jqXHR.readyState = 1; - - // Send global event - if ( fireGlobals ) { - globalEventContext.trigger( "ajaxSend", [ jqXHR, s ] ); - } - - // If request was aborted inside ajaxSend, stop there - if ( completed ) { - return jqXHR; - } - - // Timeout - if ( s.async && s.timeout > 0 ) { - timeoutTimer = window.setTimeout( function() { - jqXHR.abort( "timeout" ); - }, s.timeout ); - } - - try { - completed = false; - transport.send( requestHeaders, done ); - } catch ( e ) { - - // Rethrow post-completion exceptions - if ( completed ) { - throw e; - } - - // Propagate others as results - done( -1, e ); - } - } - - // Callback for when everything is done - function done( status, nativeStatusText, responses, headers ) { - var isSuccess, success, error, response, modified, - statusText = nativeStatusText; - - // Ignore repeat invocations - if ( completed ) { - return; - } - - completed = true; - - // Clear timeout if it exists - if ( timeoutTimer ) { - window.clearTimeout( timeoutTimer ); - } - - // Dereference transport for early garbage collection - // (no matter how long the jqXHR object will be used) - transport = undefined; - - // Cache response headers - responseHeadersString = headers || ""; - - // Set readyState - jqXHR.readyState = status > 0 ? 4 : 0; - - // Determine if successful - isSuccess = status >= 200 && status < 300 || status === 304; - - // Get response data - if ( responses ) { - response = ajaxHandleResponses( s, jqXHR, responses ); - } - - // Use a noop converter for missing script - if ( !isSuccess && jQuery.inArray( "script", s.dataTypes ) > -1 ) { - s.converters[ "text script" ] = function() {}; - } - - // Convert no matter what (that way responseXXX fields are always set) - response = ajaxConvert( s, response, jqXHR, isSuccess ); - - // If successful, handle type chaining - if ( isSuccess ) { - - // Set the If-Modified-Since and/or If-None-Match header, if in ifModified mode. - if ( s.ifModified ) { - modified = jqXHR.getResponseHeader( "Last-Modified" ); - if ( modified ) { - jQuery.lastModified[ cacheURL ] = modified; - } - modified = jqXHR.getResponseHeader( "etag" ); - if ( modified ) { - jQuery.etag[ cacheURL ] = modified; - } - } - - // if no content - if ( status === 204 || s.type === "HEAD" ) { - statusText = "nocontent"; - - // if not modified - } else if ( status === 304 ) { - statusText = "notmodified"; - - // If we have data, let's convert it - } else { - statusText = response.state; - success = response.data; - error = response.error; - isSuccess = !error; - } - } else { - - // Extract error from statusText and normalize for non-aborts - error = statusText; - if ( status || !statusText ) { - statusText = "error"; - if ( status < 0 ) { - status = 0; - } - } - } - - // Set data for the fake xhr object - jqXHR.status = status; - jqXHR.statusText = ( nativeStatusText || statusText ) + ""; - - // Success/Error - if ( isSuccess ) { - deferred.resolveWith( callbackContext, [ success, statusText, jqXHR ] ); - } else { - deferred.rejectWith( callbackContext, [ jqXHR, statusText, error ] ); - } - - // Status-dependent callbacks - jqXHR.statusCode( statusCode ); - statusCode = undefined; - - if ( fireGlobals ) { - globalEventContext.trigger( isSuccess ? "ajaxSuccess" : "ajaxError", - [ jqXHR, s, isSuccess ? success : error ] ); - } - - // Complete - completeDeferred.fireWith( callbackContext, [ jqXHR, statusText ] ); - - if ( fireGlobals ) { - globalEventContext.trigger( "ajaxComplete", [ jqXHR, s ] ); - - // Handle the global AJAX counter - if ( !( --jQuery.active ) ) { - jQuery.event.trigger( "ajaxStop" ); - } - } - } - - return jqXHR; - }, - - getJSON: function( url, data, callback ) { - return jQuery.get( url, data, callback, "json" ); - }, - - getScript: function( url, callback ) { - return jQuery.get( url, undefined, callback, "script" ); - } -} ); - -jQuery.each( [ "get", "post" ], function( _i, method ) { - jQuery[ method ] = function( url, data, callback, type ) { - - // Shift arguments if data argument was omitted - if ( isFunction( data ) ) { - type = type || callback; - callback = data; - data = undefined; - } - - // The url can be an options object (which then must have .url) - return jQuery.ajax( jQuery.extend( { - url: url, - type: method, - dataType: type, - data: data, - success: callback - }, jQuery.isPlainObject( url ) && url ) ); - }; -} ); - -jQuery.ajaxPrefilter( function( s ) { - var i; - for ( i in s.headers ) { - if ( i.toLowerCase() === "content-type" ) { - s.contentType = s.headers[ i ] || ""; - } - } -} ); - - -jQuery._evalUrl = function( url, options, doc ) { - return jQuery.ajax( { - url: url, - - // Make this explicit, since user can override this through ajaxSetup (#11264) - type: "GET", - dataType: "script", - cache: true, - async: false, - global: false, - - // Only evaluate the response if it is successful (gh-4126) - // dataFilter is not invoked for failure responses, so using it instead - // of the default converter is kludgy but it works. - converters: { - "text script": function() {} - }, - dataFilter: function( response ) { - jQuery.globalEval( response, options, doc ); - } - } ); -}; - - -jQuery.fn.extend( { - wrapAll: function( html ) { - var wrap; - - if ( this[ 0 ] ) { - if ( isFunction( html ) ) { - html = html.call( this[ 0 ] ); - } - - // The elements to wrap the target around - wrap = jQuery( html, this[ 0 ].ownerDocument ).eq( 0 ).clone( true ); - - if ( this[ 0 ].parentNode ) { - wrap.insertBefore( this[ 0 ] ); - } - - wrap.map( function() { - var elem = this; - - while ( elem.firstElementChild ) { - elem = elem.firstElementChild; - } - - return elem; - } ).append( this ); - } - - return this; - }, - - wrapInner: function( html ) { - if ( isFunction( html ) ) { - return this.each( function( i ) { - jQuery( this ).wrapInner( html.call( this, i ) ); - } ); - } - - return this.each( function() { - var self = jQuery( this ), - contents = self.contents(); - - if ( contents.length ) { - contents.wrapAll( html ); - - } else { - self.append( html ); - } - } ); - }, - - wrap: function( html ) { - var htmlIsFunction = isFunction( html ); - - return this.each( function( i ) { - jQuery( this ).wrapAll( htmlIsFunction ? html.call( this, i ) : html ); - } ); - }, - - unwrap: function( selector ) { - this.parent( selector ).not( "body" ).each( function() { - jQuery( this ).replaceWith( this.childNodes ); - } ); - return this; - } -} ); - - -jQuery.expr.pseudos.hidden = function( elem ) { - return !jQuery.expr.pseudos.visible( elem ); -}; -jQuery.expr.pseudos.visible = function( elem ) { - return !!( elem.offsetWidth || elem.offsetHeight || elem.getClientRects().length ); -}; - - - - -jQuery.ajaxSettings.xhr = function() { - try { - return new window.XMLHttpRequest(); - } catch ( e ) {} -}; - -var xhrSuccessStatus = { - - // File protocol always yields status code 0, assume 200 - 0: 200, - - // Support: IE <=9 only - // #1450: sometimes IE returns 1223 when it should be 204 - 1223: 204 - }, - xhrSupported = jQuery.ajaxSettings.xhr(); - -support.cors = !!xhrSupported && ( "withCredentials" in xhrSupported ); -support.ajax = xhrSupported = !!xhrSupported; - -jQuery.ajaxTransport( function( options ) { - var callback, errorCallback; - - // Cross domain only allowed if supported through XMLHttpRequest - if ( support.cors || xhrSupported && !options.crossDomain ) { - return { - send: function( headers, complete ) { - var i, - xhr = options.xhr(); - - xhr.open( - options.type, - options.url, - options.async, - options.username, - options.password - ); - - // Apply custom fields if provided - if ( options.xhrFields ) { - for ( i in options.xhrFields ) { - xhr[ i ] = options.xhrFields[ i ]; - } - } - - // Override mime type if needed - if ( options.mimeType && xhr.overrideMimeType ) { - xhr.overrideMimeType( options.mimeType ); - } - - // X-Requested-With header - // For cross-domain requests, seeing as conditions for a preflight are - // akin to a jigsaw puzzle, we simply never set it to be sure. - // (it can always be set on a per-request basis or even using ajaxSetup) - // For same-domain requests, won't change header if already provided. - if ( !options.crossDomain && !headers[ "X-Requested-With" ] ) { - headers[ "X-Requested-With" ] = "XMLHttpRequest"; - } - - // Set headers - for ( i in headers ) { - xhr.setRequestHeader( i, headers[ i ] ); - } - - // Callback - callback = function( type ) { - return function() { - if ( callback ) { - callback = errorCallback = xhr.onload = - xhr.onerror = xhr.onabort = xhr.ontimeout = - xhr.onreadystatechange = null; - - if ( type === "abort" ) { - xhr.abort(); - } else if ( type === "error" ) { - - // Support: IE <=9 only - // On a manual native abort, IE9 throws - // errors on any property access that is not readyState - if ( typeof xhr.status !== "number" ) { - complete( 0, "error" ); - } else { - complete( - - // File: protocol always yields status 0; see #8605, #14207 - xhr.status, - xhr.statusText - ); - } - } else { - complete( - xhrSuccessStatus[ xhr.status ] || xhr.status, - xhr.statusText, - - // Support: IE <=9 only - // IE9 has no XHR2 but throws on binary (trac-11426) - // For XHR2 non-text, let the caller handle it (gh-2498) - ( xhr.responseType || "text" ) !== "text" || - typeof xhr.responseText !== "string" ? - { binary: xhr.response } : - { text: xhr.responseText }, - xhr.getAllResponseHeaders() - ); - } - } - }; - }; - - // Listen to events - xhr.onload = callback(); - errorCallback = xhr.onerror = xhr.ontimeout = callback( "error" ); - - // Support: IE 9 only - // Use onreadystatechange to replace onabort - // to handle uncaught aborts - if ( xhr.onabort !== undefined ) { - xhr.onabort = errorCallback; - } else { - xhr.onreadystatechange = function() { - - // Check readyState before timeout as it changes - if ( xhr.readyState === 4 ) { - - // Allow onerror to be called first, - // but that will not handle a native abort - // Also, save errorCallback to a variable - // as xhr.onerror cannot be accessed - window.setTimeout( function() { - if ( callback ) { - errorCallback(); - } - } ); - } - }; - } - - // Create the abort callback - callback = callback( "abort" ); - - try { - - // Do send the request (this may raise an exception) - xhr.send( options.hasContent && options.data || null ); - } catch ( e ) { - - // #14683: Only rethrow if this hasn't been notified as an error yet - if ( callback ) { - throw e; - } - } - }, - - abort: function() { - if ( callback ) { - callback(); - } - } - }; - } -} ); - - - - -// Prevent auto-execution of scripts when no explicit dataType was provided (See gh-2432) -jQuery.ajaxPrefilter( function( s ) { - if ( s.crossDomain ) { - s.contents.script = false; - } -} ); - -// Install script dataType -jQuery.ajaxSetup( { - accepts: { - script: "text/javascript, application/javascript, " + - "application/ecmascript, application/x-ecmascript" - }, - contents: { - script: /\b(?:java|ecma)script\b/ - }, - converters: { - "text script": function( text ) { - jQuery.globalEval( text ); - return text; - } - } -} ); - -// Handle cache's special case and crossDomain -jQuery.ajaxPrefilter( "script", function( s ) { - if ( s.cache === undefined ) { - s.cache = false; - } - if ( s.crossDomain ) { - s.type = "GET"; - } -} ); - -// Bind script tag hack transport -jQuery.ajaxTransport( "script", function( s ) { - - // This transport only deals with cross domain or forced-by-attrs requests - if ( s.crossDomain || s.scriptAttrs ) { - var script, callback; - return { - send: function( _, complete ) { - script = jQuery( " -{% endmacro %} \ No newline at end of file diff --git a/doc/LectureNotes/_build/html/chapter1.html b/doc/LectureNotes/_build/html/chapter1.html deleted file mode 100644 index 6fdc7dfdb..000000000 --- a/doc/LectureNotes/_build/html/chapter1.html +++ /dev/null @@ -1,3452 +0,0 @@ - - - - - - - - 3. Linear Regression — Applied Data Analysis and Machine Learning - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
- - - - - - - - -
- - -
-
- -
- -
-

3. Linear Regression

-
-

3.1. Introduction

-

Our emphasis throughout this series of lectures is on understanding -the mathematical aspects of different algorithms used in the fields of -data analysis and machine learning.

-

However, where possible we will emphasize the importance of using -available software. We start thus with a hands-on and top-down -approach to machine learning. The aim is thus to start with relevant -data or data we have produced and use these to introduce statistical -data analysis concepts and machine learning algorithms before we delve -into the algorithms themselves. The examples we will use in the -beginning, start with simple polynomials with random noise added. We -will use the Python software package -Scikit-Learn and introduce various -machine learning algorithms to make fits of the data and -predictions. We move thereafter to more interesting cases such as data -from say experiments (below we will look at experimental nuclear -binding energies as an example). These are examples where we can -easily set up the data and then use machine learning algorithms -included in for example Scikit-Learn.

-

These examples will serve us the purpose of getting -started. Furthermore, they allow us to catch more than two birds with -a stone. They will allow us to bring in some programming specific -topics and tools as well as showing the power of various Python -libraries for machine learning and statistical data analysis.

-

Here, we will mainly focus on two specific Python packages for Machine -Learning, Scikit-Learn and Tensorflow (see below for links etc). -Moreover, the examples we introduce will serve as inputs to many of -our discussions later, as well as allowing you to set up models and -produce your own data and get started with programming.

-
-
-

3.2. What is Machine Learning?

-

Statistics, data science and machine learning form important fields of -research in modern science. They describe how to learn and make -predictions from data, as well as allowing us to extract important -correlations about physical process and the underlying laws of motion -in large data sets. The latter, big data sets, appear frequently in -essentially all disciplines, from the traditional Science, Technology, -Mathematics and Engineering fields to Life Science, Law, education -research, the Humanities and the Social Sciences.

-

It has become more -and more common to see research projects on big data in for example -the Social Sciences where extracting patterns from complicated survey -data is one of many research directions. Having a solid grasp of data -analysis and machine learning is thus becoming central to scientific -computing in many fields, and competences and skills within the fields -of machine learning and scientific computing are nowadays strongly -requested by many potential employers. The latter cannot be -overstated, familiarity with machine learning has almost become a -prerequisite for many of the most exciting employment opportunities, -whether they are in bioinformatics, life science, physics or finance, -in the private or the public sector. This author has had several -students or met students who have been hired recently based on their -skills and competences in scientific computing and data science, often -with marginal knowledge of machine learning.

-

Machine learning is a subfield of computer science, and is closely -related to computational statistics. It evolved from the study of -pattern recognition in artificial intelligence (AI) research, and has -made contributions to AI tasks like computer vision, natural language -processing and speech recognition. Many of the methods we will study are also -strongly rooted in basic mathematics and physics research.

-

Ideally, machine learning represents the science of giving computers -the ability to learn without being explicitly programmed. The idea is -that there exist generic algorithms which can be used to find patterns -in a broad class of data sets without having to write code -specifically for each problem. The algorithm will build its own logic -based on the data. You should however always keep in mind that -machines and algorithms are to a large extent developed by humans. The -insights and knowledge we have about a specific system, play a central -role when we develop a specific machine learning algorithm.

-

Machine learning is an extremely rich field, in spite of its young -age. The increases we have seen during the last three decades in -computational capabilities have been followed by developments of -methods and techniques for analyzing and handling large date sets, -relying heavily on statistics, computer science and mathematics. The -field is rather new and developing rapidly. Popular software packages -written in Python for machine learning like -Scikit-learn, -Tensorflow, -PyTorch and Keras, all -freely available at their respective GitHub sites, encompass -communities of developers in the thousands or more. And the number of -code developers and contributors keeps increasing. Not all the -algorithms and methods can be given a rigorous mathematical -justification, opening up thereby large rooms for experimenting and -trial and error and thereby exciting new developments. However, a -solid command of linear algebra, multivariate theory, probability -theory, statistical data analysis, understanding errors and Monte -Carlo methods are central elements in a proper understanding of many -of algorithms and methods we will discuss.

-

The approaches to machine learning are many, but are often split into -two main categories. In supervised learning we know the answer to a -problem, and let the computer deduce the logic behind it. On the other -hand, unsupervised learning is a method for finding patterns and -relationship in data sets without any prior knowledge of the system. -Some authours also operate with a third category, namely -reinforcement learning. This is a paradigm of learning inspired by -behavioral psychology, where learning is achieved by trial-and-error, -solely from rewards and punishment.

-

Another way to categorize machine learning tasks is to consider the -desired output of a system. Some of the most common tasks are:

-
    -
  • Classification: Outputs are divided into two or more classes. The goal is to produce a model that assigns inputs into one of these classes. An example is to identify digits based on pictures of hand-written ones. Classification is typically supervised learning.

  • -
  • Regression: Finding a functional relationship between an input data set and a reference data set. The goal is to construct a function that maps input data to continuous output values.

  • -
  • Clustering: Data are divided into groups with certain common traits, without knowing the different groups beforehand. It is thus a form of unsupervised learning.

  • -
-

The methods we cover have three main topics in common, irrespective of -whether we deal with supervised or unsupervised learning.

-
    -
  • The first ingredient is normally our data set (which can be subdivided into training, validation and test data). Many find the most difficult part of using Machine Learning to be the set up of your data in a meaningful way.

  • -
  • The second item is a model which is normally a function of some parameters. The model reflects our knowledge of the system (or lack thereof). As an example, if we know that our data show a behavior similar to what would be predicted by a polynomial, fitting our data to a polynomial of some degree would then determin our model.

  • -
  • The last ingredient is a so-called cost/loss function (or error or risk function) which allows us to present an estimate on how good our model is in reproducing the data it is supposed to train.

  • -
-

At the heart of basically all Machine Learning algorithms we will encounter so-called minimization or optimization algorithms. A large family of such methods are so-called gradient methods.

-
-

3.2.1. A Frequentist approach to data analysis

-

When you hear phrases like predictions and estimations and -correlations and causations, what do you think of? May be you think -of the difference between classifying new data points and generating -new data points. -Or perhaps you consider that correlations represent some kind of symmetric statements like -if \(A\) is correlated with \(B\), then \(B\) is correlated with -\(A\). Causation on the other hand is directional, that is if \(A\) causes \(B\), \(B\) does not -necessarily cause \(A\).

-

These concepts are in some sense the difference between machine -learning and statistics. In machine learning and prediction based -tasks, we are often interested in developing algorithms that are -capable of learning patterns from given data in an automated fashion, -and then using these learned patterns to make predictions or -assessments of newly given data. In many cases, our primary concern -is the quality of the predictions or assessments, and we are less -concerned about the underlying patterns that were learned in order -to make these predictions.

-

In machine learning we normally use a so-called frequentist approach, -where the aim is to make predictions and find correlations. We focus -less on for example extracting a probability distribution function (PDF). The PDF can be -used in turn to make estimations and find causations such as given \(A\) -what is the likelihood of finding \(B\).

-
-
-

3.2.2. What is a good model?

-

In science and engineering we often end up in situations where we want to infer (or learn) a -quantitative model \(M\) for a given set of sample points \(\boldsymbol{X} \in [x_1, x_2,\dots x_N]\).

-

As we will see repeatedely in these lectures, we could try to fit these data points to a model given by a -straight line, or if we wish to be more sophisticated to a more complex -function.

-

The reason for inferring such a model is that it -serves many useful purposes. On the one hand, the model can reveal information -encoded in the data or underlying mechanisms from which the data were generated. For instance, we could discover important -corelations that relate interesting physics interpretations.

-

In addition, it can simplify the representation of the given data set and help -us in making predictions about future data samples.

-

A first important consideration to keep in mind is that inferring the correct model -for a given data set is an elusive, if not impossible, task. The fundamental difficulty -is that if we are not specific about what we mean by a correct model, there -could easily be many different models that fit the given data set equally well.

-

The central question is this: what leads us to say that a model is correct or -optimal for a given data set? To make the model inference problem well posed, i.e., -to guarantee that there is a unique optimal model for the given data, we need to -impose additional assumptions or restrictions on the class of models considered. To -this end, we should not be looking for just any model that can describe the data. -Instead, we should look for a model \(M\) that is the best among a restricted class -of models. In addition, to make the model inference problem computationally -tractable, we need to specify how restricted the class of models needs to be. A -common strategy is to start -with the simplest possible class of models that is just necessary to describe the data -or solve the problem at hand. More precisely, the model class should be rich enough -to contain at least one model that can fit the data to a desired accuracy and yet be -restricted enough that it is relatively simple to find the best model for the given data.

-

Thus, the most popular strategy is to start from the -simplest class of models and increase the complexity of the models only when the -simpler models become inadequate. For instance, if we work with a regression problem to fit a set of sample points, one -may first try the simplest class of models, namely linear models, followed obviously by more complex models.

-

How to evaluate which model fits best the data is something we will come back to over and over again in these sets of lectures.

-
-
-
-

3.3. Simple linear regression model using scikit-learn

-

We start with perhaps our simplest possible example, using -Scikit-Learn to perform linear regression analysis on a data set -produced by us.

-

What follows is a simple Python code where we have defined a function -\(y\) in terms of the variable \(x\). Both are defined as vectors with \(100\) entries. -The numbers in the vector \(\boldsymbol{x}\) are given -by random numbers generated with a uniform distribution with entries -\(x_i \in [0,1]\) (more about probability distribution functions -later). These values are then used to define a function \(y(x)\) -(tabulated again as a vector) with a linear dependence on \(x\) plus a -random noise added via the normal distribution.

-

The Numpy functions are imported used the import numpy as np -statement and the random number generator for the uniform distribution -is called using the function np.random.rand(), where we specificy -that we want \(100\) random variables. Using Numpy we define -automatically an array with the specified number of elements, \(100\) in -our case. With the Numpy function randn() we can compute random -numbers with the normal distribution (mean value \(\mu\) equal to zero and -variance \(\sigma^2\) set to one) and produce the values of \(y\) assuming a linear -dependence as function of \(x\)

-
-\[ -y = 2x+N(0,1), -\]
-

where \(N(0,1)\) represents random numbers generated by the normal -distribution. From Scikit-Learn we import then the -LinearRegression functionality and make a prediction \(\tilde{y} = -\alpha + \beta x\) using the function fit(x,y). We call the set of -data \((\boldsymbol{x},\boldsymbol{y})\) for our training data. The Python package -scikit-learn has also a functionality which extracts the above -fitting parameters \(\alpha\) and \(\beta\) (see below). Later we will -distinguish between training data and test data.

-

For plotting we use the Python package -matplotlib which produces publication -quality figures. Feel free to explore the extensive -gallery of examples. In -this example we plot our original values of \(x\) and \(y\) as well as the -prediction ypredict (\(\tilde{y}\)), which attempts at fitting our -data with a straight line. Note also that Scikit-Learn requires a -matrix as input for the input values \(x\) and \(y\). In the above code we -have solved this by declaring \(x\) and \(y\) as arrays of dimension -\(n\times 1\).

-

In the code here we have also made a new array for \(x\in [0,1]\). Our -prediction is computed for these values, meaning that they were not -included in the data set used to train (or fit) the model. -This is a recurrring theme in machine learning and data analysis. We would like to train a model on a specific given data set. -Thereafter we wish to apply it to data which were not included in the training. Below we will encounter this again in the so-called train-validate-test spliting. We will typically split our data into different sets, oen for training, one for validation and finally, our data from the untouched test vault!

-

The Python code follows here.

-
-
-
%matplotlib inline
-
-# Importing various packages
-import numpy as np
-import matplotlib.pyplot as plt
-from sklearn.linear_model import LinearRegression
-
-x = np.random.rand(100,1)
-y = 2*x+np.random.randn(100,1)
-linreg = LinearRegression()
-linreg.fit(x,y)
-# This is our new x-array to which we test our model
-xnew = np.array([[0],[1]])
-ypredict = linreg.predict(xnew)
-
-plt.plot(xnew, ypredict, "r-")
-plt.plot(x, y ,'ro')
-plt.axis([0,1.0,0, 5.0])
-plt.xlabel(r'$x$')
-plt.ylabel(r'$y$')
-plt.title(r'Simple Linear Regression')
-plt.show()
-
-
-
-
-_images/chapter1_3_0.png -
-
-

This example serves several aims. It allows us to demonstrate several -aspects of data analysis and later machine learning algorithms. The -immediate visualization shows that our linear fit is not -impressive. It goes through the data points, but there are many -outliers which are not reproduced by our linear regression. We could -now play around with this small program and change for example the -factor in front of \(x\) and the normal distribution. Try to change the -function \(y\) to

-
-\[ -y = 10x+0.01 \times N(0,1), -\]
-

where \(x\) is defined as before. Does the fit look better? Indeed, by -reducing the role of the noise given by the normal distribution we see immediately that -our linear prediction seemingly reproduces better the training -set. However, this testing ‘by the eye’ is obviouly not satisfactory in the -long run. Here we have only defined the training data and our model, and -have not discussed a more rigorous approach to the cost function.

-

We need more rigorous criteria in defining whether we have succeeded or -not in modeling our training data. You will be surprised to see that -many scientists seldomly venture beyond this ‘by the eye’ approach. A -standard approach for the cost function is the so-called \(\chi^2\) -function (a variant of the mean-squared error (MSE))

-
-\[ -\chi^2 = \frac{1}{n} -\sum_{i=0}^{n-1}\frac{(y_i-\tilde{y}_i)^2}{\sigma_i^2}, -\]
-

where \(\sigma_i^2\) is the variance (to be defined later) of the entry -\(y_i\). We may not know the explicit value of \(\sigma_i^2\), it serves -however the aim of scaling the equations and make the cost function -dimensionless.

-

Minimizing the cost function is a central aspect of -our discussions to come. Finding its minima as function of the model -parameters (\(\alpha\) and \(\beta\) in our case) will be a recurring -theme in these series of lectures. Essentially all machine learning -algorithms we will discuss center around the minimization of the -chosen cost function. This depends in turn on our specific -model for describing the data, a typical situation in supervised -learning. Automatizing the search for the minima of the cost function is a -central ingredient in all algorithms. Typical methods which are -employed are various variants of gradient methods. These will be -discussed in more detail later. Again, you’ll be surprised to hear that -many practitioners minimize the above function ‘’by the eye’, popularly dubbed as -‘chi by the eye’. That is, change a parameter and see (visually and numerically) that -the \(\chi^2\) function becomes smaller.

-

There are many ways to define the cost function. A simpler approach is to look at the relative difference between the training data and the predicted data, that is we define -the relative error (why would we prefer the MSE instead of the relative error?) as

-
-\[ -\epsilon_{\mathrm{relative}}= \frac{\vert \boldsymbol{y} -\boldsymbol{\tilde{y}}\vert}{\vert \boldsymbol{y}\vert}. -\]
-

The squared cost function results in an arithmetic mean-unbiased -estimator, and the absolute-value cost function results in a -median-unbiased estimator (in the one-dimensional case, and a -geometric median-unbiased estimator for the multi-dimensional -case). The squared cost function has the disadvantage that it has the tendency -to be dominated by outliers.

-

We can modify easily the above Python code and plot the relative error instead

-
-
-
import numpy as np
-import matplotlib.pyplot as plt
-from sklearn.linear_model import LinearRegression
-# Number of data points
-n = 100
-x = np.random.rand(100,1)
-y = 5*x+0.01*np.random.randn(100,1)
-linreg = LinearRegression()
-linreg.fit(x,y)
-ypredict = linreg.predict(x)
-
-plt.plot(x, np.abs(ypredict-y)/abs(y), "ro")
-plt.axis([0,1.0,0.0, 0.5])
-plt.xlabel(r'$x$')
-plt.ylabel(r'$\epsilon_{\mathrm{relative}}$')
-plt.title(r'Relative error')
-plt.show()
-
-
-
-
-_images/chapter1_11_0.png -
-
-

Depending on the parameter in front of the normal distribution, we may -have a small or larger relative error. Try to play around with -different training data sets and study (graphically) the value of the -relative error.

-

As mentioned above, Scikit-Learn has an impressive functionality. -We can for example extract the values of \(\alpha\) and \(\beta\) and -their error estimates, or the variance and standard deviation and many -other properties from the statistical data analysis.

-

Here we show an -example of the functionality of Scikit-Learn.

-
-
-
import numpy as np 
-import matplotlib.pyplot as plt 
-from sklearn.linear_model import LinearRegression 
-from sklearn.metrics import mean_squared_error, r2_score, mean_squared_log_error, mean_absolute_error
-
-x = np.random.rand(100,1)
-y = 2.0+ 5*x+0.5*np.random.randn(100,1)
-linreg = LinearRegression()
-linreg.fit(x,y)
-ypredict = linreg.predict(x)
-print('The intercept alpha: \n', linreg.intercept_)
-print('Coefficient beta : \n', linreg.coef_)
-# The mean squared error                               
-print("Mean squared error: %.2f" % mean_squared_error(y, ypredict))
-# Explained variance score: 1 is perfect prediction                                 
-print('Variance score: %.2f' % r2_score(y, ypredict))
-# Mean squared log error                                                        
-print('Mean squared log error: %.2f' % mean_squared_log_error(y, ypredict) )
-# Mean absolute error                                                           
-print('Mean absolute error: %.2f' % mean_absolute_error(y, ypredict))
-plt.plot(x, ypredict, "r-")
-plt.plot(x, y ,'ro')
-plt.axis([0.0,1.0,1.5, 7.0])
-plt.xlabel(r'$x$')
-plt.ylabel(r'$y$')
-plt.title(r'Linear Regression fit ')
-plt.show()
-
-
-
-
-
The intercept alpha: 
- [2.08534155]
-Coefficient beta : 
- [[4.76326745]]
-Mean squared error: 0.26
-Variance score: 0.88
-Mean squared log error: 0.01
-Mean absolute error: 0.42
-
-
-_images/chapter1_13_1.png -
-
-

The function coef gives us the parameter \(\beta\) of our fit while intercept yields -\(\alpha\). Depending on the constant in front of the normal distribution, we get values near or far from \(alpha =2\) and \(\beta =5\). Try to play around with different parameters in front of the normal distribution. The function meansquarederror gives us the mean square error, a risk metric corresponding to the expected value of the squared (quadratic) error or loss defined as

-
-\[ -MSE(\boldsymbol{y},\boldsymbol{\tilde{y}}) = \frac{1}{n} -\sum_{i=0}^{n-1}(y_i-\tilde{y}_i)^2, -\]
-

The smaller the value, the better the fit. Ideally we would like to -have an MSE equal zero. The attentive reader has probably recognized -this function as being similar to the \(\chi^2\) function defined above.

-

The r2score function computes \(R^2\), the coefficient of -determination. It provides a measure of how well future samples are -likely to be predicted by the model. Best possible score is 1.0 and it -can be negative (because the model can be arbitrarily worse). A -constant model that always predicts the expected value of \(\boldsymbol{y}\), -disregarding the input features, would get a \(R^2\) score of \(0.0\).

-

If \(\tilde{\boldsymbol{y}}_i\) is the predicted value of the \(i-th\) sample and \(y_i\) is the corresponding true value, then the score \(R^2\) is defined as

-
-\[ -R^2(\boldsymbol{y}, \tilde{\boldsymbol{y}}) = 1 - \frac{\sum_{i=0}^{n - 1} (y_i - \tilde{y}_i)^2}{\sum_{i=0}^{n - 1} (y_i - \bar{y})^2}, -\]
-

where we have defined the mean value of \(\boldsymbol{y}\) as

-
-\[ -\bar{y} = \frac{1}{n} \sum_{i=0}^{n - 1} y_i. -\]
-

Another quantity taht we will meet again in our discussions of regression analysis is -the mean absolute error (MAE), a risk metric corresponding to the expected value of the absolute error loss or what we call the \(l1\)-norm loss. In our discussion above we presented the relative error. -The MAE is defined as follows

-
-\[ -\text{MAE}(\boldsymbol{y}, \boldsymbol{\tilde{y}}) = \frac{1}{n} \sum_{i=0}^{n-1} \left| y_i - \tilde{y}_i \right|. -\]
-

We present the -squared logarithmic (quadratic) error

-
-\[ -\text{MSLE}(\boldsymbol{y}, \boldsymbol{\tilde{y}}) = \frac{1}{n} \sum_{i=0}^{n - 1} (\log_e (1 + y_i) - \log_e (1 + \tilde{y}_i) )^2, -\]
-

where \(\log_e (x)\) stands for the natural logarithm of \(x\). This error -estimate is best to use when targets having exponential growth, such -as population counts, average sales of a commodity over a span of -years etc.

-

Finally, another cost function is the Huber cost function used in robust regression.

-

The rationale behind this possible cost function is its reduced -sensitivity to outliers in the data set. In our discussions on -dimensionality reduction and normalization of data we will meet other -ways of dealing with outliers.

-

The Huber cost function is defined as

-
-\[\begin{split} -H_{\delta}(\boldsymbol{a})=\left\{\begin{array}{cc}\frac{1}{2} \boldsymbol{a}^{2}& \text{for }|\boldsymbol{a}|\leq \delta\\ \delta (|\boldsymbol{a}|-\frac{1}{2}\delta ),&\text{otherwise}.\end{array}\right. -\end{split}\]
-

Here \(\boldsymbol{a}=\boldsymbol{y} - \boldsymbol{\tilde{y}}\).

-

We will discuss in more -detail these and other functions in the various lectures. We conclude this part with another example. Instead of -a linear \(x\)-dependence we study now a cubic polynomial and use the polynomial regression analysis tools of scikit-learn.

-
-
-
import matplotlib.pyplot as plt
-import numpy as np
-import random
-from sklearn.linear_model import Ridge
-from sklearn.preprocessing import PolynomialFeatures
-from sklearn.pipeline import make_pipeline
-from sklearn.linear_model import LinearRegression
-
-x=np.linspace(0.02,0.98,200)
-noise = np.asarray(random.sample((range(200)),200))
-y=x**3*noise
-yn=x**3*100
-poly3 = PolynomialFeatures(degree=3)
-X = poly3.fit_transform(x[:,np.newaxis])
-clf3 = LinearRegression()
-clf3.fit(X,y)
-
-Xplot=poly3.fit_transform(x[:,np.newaxis])
-poly3_plot=plt.plot(x, clf3.predict(Xplot), label='Cubic Fit')
-plt.plot(x,yn, color='red', label="True Cubic")
-plt.scatter(x, y, label='Data', color='orange', s=15)
-plt.legend()
-plt.show()
-
-def error(a):
-    for i in y:
-        err=(y-yn)/yn
-    return abs(np.sum(err))/len(err)
-
-print (error(y))
-
-
-
-
-_images/chapter1_27_0.png -
0.0050000000000000044
-
-
-
-
-

Let us now dive into nuclear physics and remind ourselves briefly about some basic features about binding -energies. A basic quantity which can be measured for the ground -states of nuclei is the atomic mass \(M(N, Z)\) of the neutral atom with -atomic mass number \(A\) and charge \(Z\). The number of neutrons is \(N\). There are indeed several sophisticated experiments worldwide which allow us to measure this quantity to high precision (parts per million even).

-

Atomic masses are usually tabulated in terms of the mass excess defined by

-
-\[ -\Delta M(N, Z) = M(N, Z) - uA, -\]
-

where \(u\) is the Atomic Mass Unit

-
-\[ -u = M(^{12}\mathrm{C})/12 = 931.4940954(57) \hspace{0.1cm} \mathrm{MeV}/c^2. -\]
-

The nucleon masses are

-
-\[ -m_p = 1.00727646693(9)u, -\]
-

and

-
-\[ -m_n = 939.56536(8)\hspace{0.1cm} \mathrm{MeV}/c^2 = 1.0086649156(6)u. -\]
-

In the 2016 mass evaluation of by W.J.Huang, G.Audi, M.Wang, F.G.Kondev, S.Naimi and X.Xu -there are data on masses and decays of 3437 nuclei.

-

The nuclear binding energy is defined as the energy required to break -up a given nucleus into its constituent parts of \(N\) neutrons and \(Z\) -protons. In terms of the atomic masses \(M(N, Z)\) the binding energy is -defined by

-
-\[ -BE(N, Z) = ZM_H c^2 + Nm_n c^2 - M(N, Z)c^2 , -\]
-

where \(M_H\) is the mass of the hydrogen atom and \(m_n\) is the mass of the neutron. -In terms of the mass excess the binding energy is given by

-
-\[ -BE(N, Z) = Z\Delta_H c^2 + N\Delta_n c^2 -\Delta(N, Z)c^2 , -\]
-

where \(\Delta_H c^2 = 7.2890\) MeV and \(\Delta_n c^2 = 8.0713\) MeV.

-

A popular and physically intuitive model which can be used to parametrize -the experimental binding energies as function of \(A\), is the so-called -liquid drop model. The ansatz is based on the following expression

-
-\[ -BE(N,Z) = a_1A-a_2A^{2/3}-a_3\frac{Z^2}{A^{1/3}}-a_4\frac{(N-Z)^2}{A}, -\]
-

where \(A\) stands for the number of nucleons and the \(a_i\)s are parameters which are determined by a fit -to the experimental data.

-

To arrive at the above expression we have assumed that we can make the following assumptions:

-
    -
  • There is a volume term \(a_1A\) proportional with the number of nucleons (the energy is also an extensive quantity). When an assembly of nucleons of the same size is packed together into the smallest volume, each interior nucleon has a certain number of other nucleons in contact with it. This contribution is proportional to the volume.

  • -
  • There is a surface energy term \(a_2A^{2/3}\). The assumption here is that a nucleon at the surface of a nucleus interacts with fewer other nucleons than one in the interior of the nucleus and hence its binding energy is less. This surface energy term takes that into account and is therefore negative and is proportional to the surface area.

  • -
  • There is a Coulomb energy term \(a_3\frac{Z^2}{A^{1/3}}\). The electric repulsion between each pair of protons in a nucleus yields less binding.

  • -
  • There is an asymmetry term \(a_4\frac{(N-Z)^2}{A}\). This term is associated with the Pauli exclusion principle and reflects the fact that the proton-neutron interaction is more attractive on the average than the neutron-neutron and proton-proton interactions.

  • -
-

We could also add a so-called pairing term, which is a correction term that -arises from the tendency of proton pairs and neutron pairs to -occur. An even number of particles is more stable than an odd number.

-
-

3.3.1. Organizing our data

-

Let us start with reading and organizing our data. -We start with the compilation of masses and binding energies from 2016. -After having downloaded this file to our own computer, we are now ready to read the file and start structuring our data.

-

We start with preparing folders for storing our calculations and the data file over masses and binding energies. We import also various modules that we will find useful in order to present various Machine Learning methods. Here we focus mainly on the functionality of scikit-learn.

-
-
-
# Common imports
-import numpy as np
-import pandas as pd
-import matplotlib.pyplot as plt
-import sklearn.linear_model as skl
-from sklearn.model_selection import train_test_split
-from sklearn.metrics import mean_squared_error, r2_score, mean_absolute_error
-import os
-
-# Where to save the figures and data files
-PROJECT_ROOT_DIR = "Results"
-FIGURE_ID = "Results/FigureFiles"
-DATA_ID = "DataFiles/"
-
-if not os.path.exists(PROJECT_ROOT_DIR):
-    os.mkdir(PROJECT_ROOT_DIR)
-
-if not os.path.exists(FIGURE_ID):
-    os.makedirs(FIGURE_ID)
-
-if not os.path.exists(DATA_ID):
-    os.makedirs(DATA_ID)
-
-def image_path(fig_id):
-    return os.path.join(FIGURE_ID, fig_id)
-
-def data_path(dat_id):
-    return os.path.join(DATA_ID, dat_id)
-
-def save_fig(fig_id):
-    plt.savefig(image_path(fig_id) + ".png", format='png')
-
-infile = open(data_path("MassEval2016.dat"),'r')
-
-
-
-
-

Before we proceed, we define also a function for making our plots. You can obviously avoid this and simply set up various matplotlib commands every time you need them. You may however find it convenient to collect all such commands in one function and simply call this function.

-
-
-
from pylab import plt, mpl
-plt.style.use('seaborn')
-mpl.rcParams['font.family'] = 'serif'
-
-def MakePlot(x,y, styles, labels, axlabels):
-    plt.figure(figsize=(10,6))
-    for i in range(len(x)):
-        plt.plot(x[i], y[i], styles[i], label = labels[i])
-        plt.xlabel(axlabels[0])
-        plt.ylabel(axlabels[1])
-    plt.legend(loc=0)
-
-
-
-
-

Our next step is to read the data on experimental binding energies and -reorganize them as functions of the mass number \(A\), the number of -protons \(Z\) and neutrons \(N\) using pandas. Before we do this it is -always useful (unless you have a binary file or other types of compressed -data) to actually open the file and simply take a look at it!

-

In particular, the program that outputs the final nuclear masses is written in Fortran with a specific format. It means that we need to figure out the format and which columns contain the data we are interested in. Pandas comes with a function that reads formatted output. After having admired the file, we are now ready to start massaging it with pandas. The file begins with some basic format information.

-
-
-
"""                                                                                                                         
-This is taken from the data file of the mass 2016 evaluation.                                                               
-All files are 3436 lines long with 124 character per line.                                                                  
-       Headers are 39 lines long.                                                                                           
-   col 1     :  Fortran character control: 1 = page feed  0 = line feed                                                     
-   format    :  a1,i3,i5,i5,i5,1x,a3,a4,1x,f13.5,f11.5,f11.3,f9.3,1x,a2,f11.3,f9.3,1x,i3,1x,f12.5,f11.5                     
-   These formats are reflected in the pandas widths variable below, see the statement                                       
-   widths=(1,3,5,5,5,1,3,4,1,13,11,11,9,1,2,11,9,1,3,1,12,11,1),                                                            
-   Pandas has also a variable header, with length 39 in this case.                                                          
-"""
-
-
-
-
-
'                                                                                                                         \nThis is taken from the data file of the mass 2016 evaluation.                                                               \nAll files are 3436 lines long with 124 character per line.                                                                  \n       Headers are 39 lines long.                                                                                           \n   col 1     :  Fortran character control: 1 = page feed  0 = line feed                                                     \n   format    :  a1,i3,i5,i5,i5,1x,a3,a4,1x,f13.5,f11.5,f11.3,f9.3,1x,a2,f11.3,f9.3,1x,i3,1x,f12.5,f11.5                     \n   These formats are reflected in the pandas widths variable below, see the statement                                       \n   widths=(1,3,5,5,5,1,3,4,1,13,11,11,9,1,2,11,9,1,3,1,12,11,1),                                                            \n   Pandas has also a variable header, with length 39 in this case.                                                          \n'
-
-
-
-
-

The data we are interested in are in columns 2, 3, 4 and 11, giving us -the number of neutrons, protons, mass numbers and binding energies, -respectively. We add also for the sake of completeness the element name. The data are in fixed-width formatted lines and we will -covert them into the pandas DataFrame structure.

-
-
-
# Read the experimental data with Pandas
-Masses = pd.read_fwf(infile, usecols=(2,3,4,6,11),
-              names=('N', 'Z', 'A', 'Element', 'Ebinding'),
-              widths=(1,3,5,5,5,1,3,4,1,13,11,11,9,1,2,11,9,1,3,1,12,11,1),
-              header=39,
-              index_col=False)
-
-# Extrapolated values are indicated by '#' in place of the decimal place, so
-# the Ebinding column won't be numeric. Coerce to float and drop these entries.
-Masses['Ebinding'] = pd.to_numeric(Masses['Ebinding'], errors='coerce')
-Masses = Masses.dropna()
-# Convert from keV to MeV.
-Masses['Ebinding'] /= 1000
-
-# Group the DataFrame by nucleon number, A.
-Masses = Masses.groupby('A')
-# Find the rows of the grouped DataFrame with the maximum binding energy.
-Masses = Masses.apply(lambda t: t[t.Ebinding==t.Ebinding.max()])
-
-
-
-
-

We have now read in the data, grouped them according to the variables we are interested in. -We see how easy it is to reorganize the data using pandas. If we -were to do these operations in C/C++ or Fortran, we would have had to -write various functions/subroutines which perform the above -reorganizations for us. Having reorganized the data, we can now start -to make some simple fits using both the functionalities in numpy and -Scikit-Learn afterwards.

-

Now we define five variables which contain -the number of nucleons \(A\), the number of protons \(Z\) and the number of neutrons \(N\), the element name and finally the energies themselves.

-
-
-
A = Masses['A']
-Z = Masses['Z']
-N = Masses['N']
-Element = Masses['Element']
-Energies = Masses['Ebinding']
-print(Masses)
-
-
-
-
-
            N    Z    A Element  Ebinding
-A                                        
-1   0       0    1    1       H  0.000000
-2   1       1    1    2       H  1.112283
-3   2       2    1    3       H  2.827265
-4   6       2    2    4      He  7.073915
-5   9       3    2    5      He  5.512132
-...       ...  ...  ...     ...       ...
-264 3304  156  108  264      Hs  7.298375
-265 3310  157  108  265      Hs  7.296247
-266 3317  158  108  266      Hs  7.298273
-269 3338  159  110  269      Ds  7.250154
-270 3344  160  110  270      Ds  7.253775
-
-[267 rows x 5 columns]
-
-
-
-
-

The next step, and we will define this mathematically later, is to set up the so-called design matrix. We will throughout call this matrix \(\boldsymbol{X}\). -It has dimensionality \(n\times p\), where \(n\) is the number of data points and \(p\) are the so-called predictors. In our case here they are given by the number of polynomials in \(A\) we wish to include in the fit.

-
-
-
# Now we set up the design matrix X
-X = np.zeros((len(A),5))
-X[:,0] = 1
-X[:,1] = A
-X[:,2] = A**(2.0/3.0)
-X[:,3] = A**(-1.0/3.0)
-X[:,4] = A**(-1.0)
-
-
-
-
-

Note well that we have made life simple here. We perform a fit in -terms of the number of nucleons only. A more sophisticated fit can be -done by including an explicit dependence on the number of protons and -neutrons in the asymmetry and Coulomb terms. We leave this as an exercise to you the reader.

-

With Scikit-Learn we are now ready to use linear regression and fit our data.

-
-
-
clf = skl.LinearRegression().fit(X, Energies)
-fity = clf.predict(X)
-
-
-
-
-

Pretty simple!
-Now we can print measures of how our fit is doing, the coefficients from the fits and plot the final fit together with our data.

-
-
-
# The mean squared error                               
-print("Mean squared error: %.2f" % mean_squared_error(Energies, fity))
-# Explained variance score: 1 is perfect prediction                                 
-print('Variance score: %.2f' % r2_score(Energies, fity))
-# Mean absolute error                                                           
-print('Mean absolute error: %.2f' % mean_absolute_error(Energies, fity))
-
-Masses['Eapprox']  = fity
-# Generate a plot comparing the experimental with the fitted values values.
-fig, ax = plt.subplots()
-ax.set_xlabel(r'$A = N + Z$')
-ax.set_ylabel(r'$E_\mathrm{bind}\,/\mathrm{MeV}$')
-ax.plot(Masses['A'], Masses['Ebinding'], alpha=0.7, lw=2,
-            label='Ame2016')
-ax.plot(Masses['A'], Masses['Eapprox'], alpha=0.7, lw=2, c='m',
-            label='Fit')
-ax.legend()
-save_fig("Masses2016")
-plt.show()
-
-
-
-
-
Mean squared error: 0.04
-Variance score: 0.95
-Mean absolute error: 0.05
-
-
-_images/chapter1_57_1.png -
-
-

As a teaser, let us now see how we can do this with decision trees using Scikit-Learn. Later we will switch to so-called random forests!

-
-
-
#Decision Tree Regression
-from sklearn.tree import DecisionTreeRegressor
-regr_1=DecisionTreeRegressor(max_depth=5)
-regr_2=DecisionTreeRegressor(max_depth=7)
-regr_3=DecisionTreeRegressor(max_depth=9)
-regr_1.fit(X, Energies)
-regr_2.fit(X, Energies)
-regr_3.fit(X, Energies)
-
-
-y_1 = regr_1.predict(X)
-y_2 = regr_2.predict(X)
-y_3=regr_3.predict(X)
-Masses['Eapprox'] = y_3
-# Plot the results
-plt.figure()
-plt.plot(A, Energies, color="blue", label="Data", linewidth=2)
-plt.plot(A, y_1, color="red", label="max_depth=5", linewidth=2)
-plt.plot(A, y_2, color="green", label="max_depth=7", linewidth=2)
-plt.plot(A, y_3, color="m", label="max_depth=9", linewidth=2)
-
-plt.xlabel("$A$")
-plt.ylabel("$E$[MeV]")
-plt.title("Decision Tree Regression")
-plt.legend()
-save_fig("Masses2016Trees")
-plt.show()
-print(Masses)
-print(np.mean( (Energies-y_1)**2))
-
-
-
-
-_images/chapter1_59_0.png -
            N    Z    A Element  Ebinding   Eapprox
-A                                                  
-1   0       0    1    1       H  0.000000  0.000000
-2   1       1    1    2       H  1.112283  1.112283
-3   2       2    1    3       H  2.827265  2.827265
-4   6       2    2    4      He  7.073915  7.073915
-5   9       3    2    5      He  5.512132  5.512132
-...       ...  ...  ...     ...       ...       ...
-264 3304  156  108  264      Hs  7.298375  7.298375
-265 3310  157  108  265      Hs  7.296247  7.297260
-266 3317  158  108  266      Hs  7.298273  7.297260
-269 3338  159  110  269      Ds  7.250154  7.250154
-270 3344  160  110  270      Ds  7.253775  7.253775
-
-[267 rows x 6 columns]
-0.009883615646716186
-
-
-
-
-

With a deeper and deeper tree level, we can almost reproduce every -single data point by increasing the max depth of the tree. -We can actually decide to make a decision tree which fits every single point. -As we will -see later, this has the benefit that we can really train a model which -traverses every single data point. However, the price we pay is that -we will easily overfit. That is, if we apply our model to unseen data, -we will most likely fail miserably in our attempt at making -predictions. As an exercise, try to make the tree level larger by adjusting the maximum depth variable. When printing out the predicition, you will note that the binding energy of every nucleus is accurately reproduced.

-

The seaborn package allows us to visualize data in an efficient way. Note that we use scikit-learn’s multi-layer perceptron (or feed forward neural network) -functionality.

-
-
-
from sklearn.neural_network import MLPRegressor
-from sklearn.metrics import accuracy_score
-import seaborn as sns
-
-X_train = X
-Y_train = Energies
-n_hidden_neurons = 100
-epochs = 100
-# store models for later use
-eta_vals = np.logspace(-5, 1, 7)
-lmbd_vals = np.logspace(-5, 1, 7)
-# store the models for later use
-DNN_scikit = np.zeros((len(eta_vals), len(lmbd_vals)), dtype=object)
-train_accuracy = np.zeros((len(eta_vals), len(lmbd_vals)))
-sns.set()
-for i, eta in enumerate(eta_vals):
-    for j, lmbd in enumerate(lmbd_vals):
-        dnn = MLPRegressor(hidden_layer_sizes=(n_hidden_neurons), activation='logistic',
-                            alpha=lmbd, learning_rate_init=eta, max_iter=epochs)
-        dnn.fit(X_train, Y_train)
-        DNN_scikit[i][j] = dnn
-        train_accuracy[i][j] = dnn.score(X_train, Y_train)
-
-fig, ax = plt.subplots(figsize = (10, 10))
-sns.heatmap(train_accuracy, annot=True, ax=ax, cmap="viridis")
-ax.set_title("Training Accuracy")
-ax.set_ylabel("$\eta$")
-ax.set_xlabel("$\lambda$")
-plt.show()
-
-
-
-
-
/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.
-  warnings.warn(
-/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.
-  warnings.warn(
-/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.
-  warnings.warn(
-
-
-
/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.
-  warnings.warn(
-/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.
-  warnings.warn(
-/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.
-  warnings.warn(
-
-
-
/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.
-  warnings.warn(
-/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.
-  warnings.warn(
-/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.
-  warnings.warn(
-
-
-
/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.
-  warnings.warn(
-/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.
-  warnings.warn(
-/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.
-  warnings.warn(
-
-
-
/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.
-  warnings.warn(
-/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.
-  warnings.warn(
-/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.
-  warnings.warn(
-
-
-
/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.
-  warnings.warn(
-/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.
-  warnings.warn(
-/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.
-  warnings.warn(
-
-
-
/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.
-  warnings.warn(
-/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.
-  warnings.warn(
-/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.
-  warnings.warn(
-/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.
-  warnings.warn(
-
-
-
/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.
-  warnings.warn(
-/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.
-  warnings.warn(
-/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.
-  warnings.warn(
-
-
-
/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.
-  warnings.warn(
-/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.
-  warnings.warn(
-/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.
-  warnings.warn(
-
-
-
/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.
-  warnings.warn(
-
-
-
/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.
-  warnings.warn(
-/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.
-  warnings.warn(
-
-
-
/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.
-  warnings.warn(
-/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.
-  warnings.warn(
-
-
-_images/chapter1_61_12.png -
-
-
-
-
-

3.4. Linear Regression, basic elements

-

Video of Lecture.

-

Fitting a continuous function with linear parameterization in terms of the parameters \(\boldsymbol{\beta}\).

-
    -
  • Method of choice for fitting a continuous function!

  • -
  • Gives an excellent introduction to central Machine Learning features with understandable pedagogical links to other methods like Neural Networks, Support Vector Machines etc

  • -
  • Analytical expression for the fitting parameters \(\boldsymbol{\beta}\)

  • -
  • Analytical expressions for statistical propertiers like mean values, variances, confidence intervals and more

  • -
  • Analytical relation with probabilistic interpretations

  • -
  • Easy to introduce basic concepts like bias-variance tradeoff, cross-validation, resampling and regularization techniques and many other ML topics

  • -
  • Easy to code! And links well with classification problems and logistic regression and neural networks

  • -
  • Allows for easy hands-on understanding of gradient descent methods

  • -
  • and many more features

  • -
-

For more discussions of Ridge and Lasso regression, Wessel van Wieringen’s article is highly recommended. -Similarly, Mehta et al’s article is also recommended.

-

Regression modeling deals with the description of the sampling distribution of a given random variable \(y\) and how it varies as function of another variable or a set of such variables \(\boldsymbol{x} =[x_0, x_1,\dots, x_{n-1}]^T\). -The first variable is called the dependent, the outcome or the response variable while the set of variables \(\boldsymbol{x}\) is called the independent variable, or the predictor variable or the explanatory variable.

-

A regression model aims at finding a likelihood function \(p(\boldsymbol{y}\vert \boldsymbol{x})\), that is the conditional distribution for \(\boldsymbol{y}\) with a given \(\boldsymbol{x}\). The estimation of \(p(\boldsymbol{y}\vert \boldsymbol{x})\) is made using a data set with

-
    -
  • \(n\) cases \(i = 0, 1, 2, \dots, n-1\)

  • -
  • Response (target, dependent or outcome) variable \(y_i\) with \(i = 0, 1, 2, \dots, n-1\)

  • -
  • \(p\) so-called explanatory (independent or predictor) variables \(\boldsymbol{x}_i=[x_{i0}, x_{i1}, \dots, x_{ip-1}]\) with \(i = 0, 1, 2, \dots, n-1\) and explanatory variables running from \(0\) to \(p-1\). See below for more explicit examples.

  • -
-

The goal of the regression analysis is to extract/exploit relationship between \(\boldsymbol{y}\) and \(\boldsymbol{x}\) in or to infer causal dependencies, approximations to the likelihood functions, functional relationships and to make predictions, making fits and many other things.

-

Consider an experiment in which \(p\) characteristics of \(n\) samples are -measured. The data from this experiment, for various explanatory variables \(p\) are normally represented by a matrix
-\(\mathbf{X}\).

-

The matrix \(\mathbf{X}\) is called the design -matrix. Additional information of the samples is available in the -form of \(\boldsymbol{y}\) (also as above). The variable \(\boldsymbol{y}\) is -generally referred to as the response variable. The aim of -regression analysis is to explain \(\boldsymbol{y}\) in terms of -\(\boldsymbol{X}\) through a functional relationship like \(y_i = -f(\mathbf{X}_{i,\ast})\). When no prior knowledge on the form of -\(f(\cdot)\) is available, it is common to assume a linear relationship -between \(\boldsymbol{X}\) and \(\boldsymbol{y}\). This assumption gives rise to -the linear regression model where \(\boldsymbol{\beta} = [\beta_0, \ldots, -\beta_{p-1}]^{T}\) are the regression parameters.

-

Linear regression gives us a set of analytical equations for the parameters \(\beta_j\).

-

In order to understand the relation among the predictors \(p\), the set of data \(n\) and the target (outcome, output etc) \(\boldsymbol{y}\), -consider the model we discussed for describing nuclear binding energies.

-

There we assumed that we could parametrize the data using a polynomial approximation based on the liquid drop model. -Assuming

-
-\[ -BE(A) = a_0+a_1A+a_2A^{2/3}+a_3A^{-1/3}+a_4A^{-1}, -\]
-

we have five predictors, that is the intercept, the \(A\) dependent term, the \(A^{2/3}\) term and the \(A^{-1/3}\) and \(A^{-1}\) terms. -This gives \(p=0,1,2,3,4\). Furthermore we have \(n\) entries for each predictor. It means that our design matrix is a -\(p\times n\) matrix \(\boldsymbol{X}\).

-

Here the predictors are based on a model we have made. A popular data set which is widely encountered in ML applications is the -so-called credit card default data from Taiwan. The data set contains data on \(n=30000\) credit card holders with predictors like gender, marital status, age, profession, education, etc. In total there are \(24\) such predictors or attributes leading to a design matrix of dimensionality \(24 \times 30000\). This is however a classification problem and we will come back to it when we discuss Logistic Regression.

-

Before we proceed let us study a case from linear algebra where we aim at fitting a set of data \(\boldsymbol{y}=[y_0,y_1,\dots,y_{n-1}]\). We could think of these data as a result of an experiment or a complicated numerical experiment. These data are functions of a series of variables \(\boldsymbol{x}=[x_0,x_1,\dots,x_{n-1}]\), that is \(y_i = y(x_i)\) with \(i=0,1,2,\dots,n-1\). The variables \(x_i\) could represent physical quantities like time, temperature, position etc. We assume that \(y(x)\) is a smooth function.

-

Since obtaining these data points may not be trivial, we want to use these data to fit a function which can allow us to make predictions for values of \(y\) which are not in the present set. The perhaps simplest approach is to assume we can parametrize our function in terms of a polynomial of degree \(n-1\) with \(n\) points, that is

-
-\[ -y=y(x) \rightarrow y(x_i)=\tilde{y}_i+\epsilon_i=\sum_{j=0}^{n-1} \beta_j x_i^j+\epsilon_i, -\]
-

where \(\epsilon_i\) is the error in our approximation.

-

For every set of values \(y_i,x_i\) we have thus the corresponding set of equations

-
-\[\begin{split} -\begin{align*} -y_0&=\beta_0+\beta_1x_0^1+\beta_2x_0^2+\dots+\beta_{n-1}x_0^{n-1}+\epsilon_0\\ -y_1&=\beta_0+\beta_1x_1^1+\beta_2x_1^2+\dots+\beta_{n-1}x_1^{n-1}+\epsilon_1\\ -y_2&=\beta_0+\beta_1x_2^1+\beta_2x_2^2+\dots+\beta_{n-1}x_2^{n-1}+\epsilon_2\\ -\dots & \dots \\ -y_{n-1}&=\beta_0+\beta_1x_{n-1}^1+\beta_2x_{n-1}^2+\dots+\beta_{n-1}x_{n-1}^{n-1}+\epsilon_{n-1}.\\ -\end{align*} -\end{split}\]
-

Defining the vectors

-
-\[ -\boldsymbol{y} = [y_0,y_1, y_2,\dots, y_{n-1}]^T, -\]
-

and

-
-\[ -\boldsymbol{\beta} = [\beta_0,\beta_1, \beta_2,\dots, \beta_{n-1}]^T, -\]
-

and

-
-\[ -\boldsymbol{\epsilon} = [\epsilon_0,\epsilon_1, \epsilon_2,\dots, \epsilon_{n-1}]^T, -\]
-

and the design matrix

-
-\[\begin{split} -\boldsymbol{X}= -\begin{bmatrix} -1& x_{0}^1 &x_{0}^2& \dots & \dots &x_{0}^{n-1}\\ -1& x_{1}^1 &x_{1}^2& \dots & \dots &x_{1}^{n-1}\\ -1& x_{2}^1 &x_{2}^2& \dots & \dots &x_{2}^{n-1}\\ -\dots& \dots &\dots& \dots & \dots &\dots\\ -1& x_{n-1}^1 &x_{n-1}^2& \dots & \dots &x_{n-1}^{n-1}\\ -\end{bmatrix} -\end{split}\]
-

we can rewrite our equations as

-
-\[ -\boldsymbol{y} = \boldsymbol{X}\boldsymbol{\beta}+\boldsymbol{\epsilon}. -\]
-

The above design matrix is called a Vandermonde matrix.

-

We are obviously not limited to the above polynomial expansions. We -could replace the various powers of \(x\) with elements of Fourier -series or instead of \(x_i^j\) we could have \(\cos{(j x_i)}\) or \(\sin{(j -x_i)}\), or time series or other orthogonal functions. For every set -of values \(y_i,x_i\) we can then generalize the equations to

-
-\[\begin{split} -\begin{align*} -y_0&=\beta_0x_{00}+\beta_1x_{01}+\beta_2x_{02}+\dots+\beta_{n-1}x_{0n-1}+\epsilon_0\\ -y_1&=\beta_0x_{10}+\beta_1x_{11}+\beta_2x_{12}+\dots+\beta_{n-1}x_{1n-1}+\epsilon_1\\ -y_2&=\beta_0x_{20}+\beta_1x_{21}+\beta_2x_{22}+\dots+\beta_{n-1}x_{2n-1}+\epsilon_2\\ -\dots & \dots \\ -y_{i}&=\beta_0x_{i0}+\beta_1x_{i1}+\beta_2x_{i2}+\dots+\beta_{n-1}x_{in-1}+\epsilon_i\\ -\dots & \dots \\ -y_{n-1}&=\beta_0x_{n-1,0}+\beta_1x_{n-1,2}+\beta_2x_{n-1,2}+\dots+\beta_{n-1}x_{n-1,n-1}+\epsilon_{n-1}.\\ -\end{align*} -\end{split}\]
-

Note that we have \(p=n\) here. The matrix is symmetric. This is generally not the case!

-

We redefine in turn the matrix \(\boldsymbol{X}\) as

-
-\[\begin{split} -\boldsymbol{X}= -\begin{bmatrix} -x_{00}& x_{01} &x_{02}& \dots & \dots &x_{0,n-1}\\ -x_{10}& x_{11} &x_{12}& \dots & \dots &x_{1,n-1}\\ -x_{20}& x_{21} &x_{22}& \dots & \dots &x_{2,n-1}\\ -\dots& \dots &\dots& \dots & \dots &\dots\\ -x_{n-1,0}& x_{n-1,1} &x_{n-1,2}& \dots & \dots &x_{n-1,n-1}\\ -\end{bmatrix} -\end{split}\]
-

and without loss of generality we rewrite again our equations as

-
-\[ -\boldsymbol{y} = \boldsymbol{X}\boldsymbol{\beta}+\boldsymbol{\epsilon}. -\]
-

The left-hand side of this equation is kwown. Our error vector \(\boldsymbol{\epsilon}\) and the parameter vector \(\boldsymbol{\beta}\) are our unknow quantities. How can we obtain the optimal set of \(\beta_i\) values?

-

We have defined the matrix \(\boldsymbol{X}\) via the equations

-
-\[\begin{split} -\begin{align*} -y_0&=\beta_0x_{00}+\beta_1x_{01}+\beta_2x_{02}+\dots+\beta_{n-1}x_{0n-1}+\epsilon_0\\ -y_1&=\beta_0x_{10}+\beta_1x_{11}+\beta_2x_{12}+\dots+\beta_{n-1}x_{1n-1}+\epsilon_1\\ -y_2&=\beta_0x_{20}+\beta_1x_{21}+\beta_2x_{22}+\dots+\beta_{n-1}x_{2n-1}+\epsilon_1\\ -\dots & \dots \\ -y_{i}&=\beta_0x_{i0}+\beta_1x_{i1}+\beta_2x_{i2}+\dots+\beta_{n-1}x_{in-1}+\epsilon_1\\ -\dots & \dots \\ -y_{n-1}&=\beta_0x_{n-1,0}+\beta_1x_{n-1,2}+\beta_2x_{n-1,2}+\dots+\beta_{n-1}x_{n-1,n-1}+\epsilon_{n-1}.\\ -\end{align*} -\end{split}\]
-

As we noted above, we stayed with a system with the design matrix -\(\boldsymbol{X}\in {\mathbb{R}}^{n\times n}\), that is we have \(p=n\). For reasons to come later (algorithmic arguments) we will hereafter define -our matrix as \(\boldsymbol{X}\in {\mathbb{R}}^{n\times p}\), with the predictors refering to the column numbers and the entries \(n\) being the row elements.

-

In our introductory notes we looked at the so-called liquid drop model. Let us remind ourselves about what we did by looking at the code.

-

We restate the parts of the code we are most interested in.

-
-
-
# Common imports
-import numpy as np
-import pandas as pd
-import matplotlib.pyplot as plt
-from IPython.display import display
-import os
-
-# Where to save the figures and data files
-PROJECT_ROOT_DIR = "Results"
-FIGURE_ID = "Results/FigureFiles"
-DATA_ID = "DataFiles/"
-
-if not os.path.exists(PROJECT_ROOT_DIR):
-    os.mkdir(PROJECT_ROOT_DIR)
-
-if not os.path.exists(FIGURE_ID):
-    os.makedirs(FIGURE_ID)
-
-if not os.path.exists(DATA_ID):
-    os.makedirs(DATA_ID)
-
-def image_path(fig_id):
-    return os.path.join(FIGURE_ID, fig_id)
-
-def data_path(dat_id):
-    return os.path.join(DATA_ID, dat_id)
-
-def save_fig(fig_id):
-    plt.savefig(image_path(fig_id) + ".png", format='png')
-
-infile = open(data_path("MassEval2016.dat"),'r')
-
-
-# Read the experimental data with Pandas
-Masses = pd.read_fwf(infile, usecols=(2,3,4,6,11),
-              names=('N', 'Z', 'A', 'Element', 'Ebinding'),
-              widths=(1,3,5,5,5,1,3,4,1,13,11,11,9,1,2,11,9,1,3,1,12,11,1),
-              header=39,
-              index_col=False)
-
-# Extrapolated values are indicated by '#' in place of the decimal place, so
-# the Ebinding column won't be numeric. Coerce to float and drop these entries.
-Masses['Ebinding'] = pd.to_numeric(Masses['Ebinding'], errors='coerce')
-Masses = Masses.dropna()
-# Convert from keV to MeV.
-Masses['Ebinding'] /= 1000
-
-# Group the DataFrame by nucleon number, A.
-Masses = Masses.groupby('A')
-# Find the rows of the grouped DataFrame with the maximum binding energy.
-Masses = Masses.apply(lambda t: t[t.Ebinding==t.Ebinding.max()])
-A = Masses['A']
-Z = Masses['Z']
-N = Masses['N']
-Element = Masses['Element']
-Energies = Masses['Ebinding']
-
-# Now we set up the design matrix X
-X = np.zeros((len(A),5))
-X[:,0] = 1
-X[:,1] = A
-X[:,2] = A**(2.0/3.0)
-X[:,3] = A**(-1.0/3.0)
-X[:,4] = A**(-1.0)
-# Then nice printout using pandas
-DesignMatrix = pd.DataFrame(X)
-DesignMatrix.index = A
-DesignMatrix.columns = ['1', 'A', 'A^(2/3)', 'A^(-1/3)', '1/A']
-display(DesignMatrix)
-
-
-
-
-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
1AA^(2/3)A^(-1/3)1/A
A
11.01.01.0000001.0000001.000000
21.02.01.5874010.7937010.500000
31.03.02.0800840.6933610.333333
41.04.02.5198420.6299610.250000
51.05.02.9240180.5848040.200000
..................
2641.0264.041.1531060.1558830.003788
2651.0265.041.2569620.1556870.003774
2661.0266.041.3606880.1554910.003759
2691.0269.041.6710890.1549110.003717
2701.0270.041.7743000.1547200.003704
-

267 rows × 5 columns

-
-
-

With \(\boldsymbol{\beta}\in {\mathbb{R}}^{p\times 1}\), it means that we will hereafter write our equations for the approximation as

-
-\[ -\boldsymbol{\tilde{y}}= \boldsymbol{X}\boldsymbol{\beta}, -\]
-

throughout these lectures.

-

With the above we use the design matrix to define the approximation \(\boldsymbol{\tilde{y}}\) via the unknown quantity \(\boldsymbol{\beta}\) as

-
-\[ -\boldsymbol{\tilde{y}}= \boldsymbol{X}\boldsymbol{\beta}, -\]
-

and in order to find the optimal parameters \(\beta_i\) instead of solving the above linear algebra problem, we define a function which gives a measure of the spread between the values \(y_i\) (which represent hopefully the exact values) and the parameterized values \(\tilde{y}_i\), namely

-
-\[ -C(\boldsymbol{\beta})=\frac{1}{n}\sum_{i=0}^{n-1}\left(y_i-\tilde{y}_i\right)^2=\frac{1}{n}\left\{\left(\boldsymbol{y}-\boldsymbol{\tilde{y}}\right)^T\left(\boldsymbol{y}-\boldsymbol{\tilde{y}}\right)\right\}, -\]
-

or using the matrix \(\boldsymbol{X}\) and in a more compact matrix-vector notation as

-
-\[ -C(\boldsymbol{\beta})=\frac{1}{n}\left\{\left(\boldsymbol{y}-\boldsymbol{X}\boldsymbol{\beta}\right)^T\left(\boldsymbol{y}-\boldsymbol{X}\boldsymbol{\beta}\right)\right\}. -\]
-

This function is one possible way to define the so-called cost function.

-

It is also common to define -the function \(C\) as

-
-\[ -C(\boldsymbol{\beta})=\frac{1}{2n}\sum_{i=0}^{n-1}\left(y_i-\tilde{y}_i\right)^2, -\]
-

since when taking the first derivative with respect to the unknown parameters \(\beta\), the factor of \(2\) cancels out.

-

The function

-
-\[ -C(\boldsymbol{\beta})=\frac{1}{n}\left\{\left(\boldsymbol{y}-\boldsymbol{X}\boldsymbol{\beta}\right)^T\left(\boldsymbol{y}-\boldsymbol{X}\boldsymbol{\beta}\right)\right\}, -\]
-

can be linked to the variance of the quantity \(y_i\) if we interpret the latter as the mean value. -When linking (see the discussion below) with the maximum likelihood approach below, we will indeed interpret \(y_i\) as a mean value

-
-\[ -y_{i}=\langle y_i \rangle = \beta_0x_{i,0}+\beta_1x_{i,1}+\beta_2x_{i,2}+\dots+\beta_{n-1}x_{i,n-1}+\epsilon_i, -\]
-

where \(\langle y_i \rangle\) is the mean value. Keep in mind also that -till now we have treated \(y_i\) as the exact value. Normally, the -response (dependent or outcome) variable \(y_i\) the outcome of a -numerical experiment or another type of experiment and is thus only an -approximation to the true value. It is then always accompanied by an -error estimate, often limited to a statistical error estimate given by -the standard deviation discussed earlier. In the discussion here we -will treat \(y_i\) as our exact value for the response variable.

-

In order to find the parameters \(\beta_i\) we will then minimize the spread of \(C(\boldsymbol{\beta})\), that is we are going to solve the problem

-
-\[ -{\displaystyle \min_{\boldsymbol{\beta}\in -{\mathbb{R}}^{p}}}\frac{1}{n}\left\{\left(\boldsymbol{y}-\boldsymbol{X}\boldsymbol{\beta}\right)^T\left(\boldsymbol{y}-\boldsymbol{X}\boldsymbol{\beta}\right)\right\}. -\]
-

In practical terms it means we will require

-
-\[ -\frac{\partial C(\boldsymbol{\beta})}{\partial \beta_j} = \frac{\partial }{\partial \beta_j}\left[ \frac{1}{n}\sum_{i=0}^{n-1}\left(y_i-\beta_0x_{i,0}-\beta_1x_{i,1}-\beta_2x_{i,2}-\dots-\beta_{n-1}x_{i,n-1}\right)^2\right]=0, -\]
-

which results in

-
-\[ -\frac{\partial C(\boldsymbol{\beta})}{\partial \beta_j} = -\frac{2}{n}\left[ \sum_{i=0}^{n-1}x_{ij}\left(y_i-\beta_0x_{i,0}-\beta_1x_{i,1}-\beta_2x_{i,2}-\dots-\beta_{n-1}x_{i,n-1}\right)\right]=0, -\]
-

or in a matrix-vector form as

-
-\[ -\frac{\partial C(\boldsymbol{\beta})}{\partial \boldsymbol{\beta}} = 0 = \boldsymbol{X}^T\left( \boldsymbol{y}-\boldsymbol{X}\boldsymbol{\beta}\right). -\]
-

We can rewrite

-
-\[ -\frac{\partial C(\boldsymbol{\beta})}{\partial \boldsymbol{\beta}} = 0 = \boldsymbol{X}^T\left( \boldsymbol{y}-\boldsymbol{X}\boldsymbol{\beta}\right), -\]
-

as

-
-\[ -\boldsymbol{X}^T\boldsymbol{y} = \boldsymbol{X}^T\boldsymbol{X}\boldsymbol{\beta}, -\]
-

and if the matrix \(\boldsymbol{X}^T\boldsymbol{X}\) is invertible we have the solution

-
-\[ -\boldsymbol{\beta} =\left(\boldsymbol{X}^T\boldsymbol{X}\right)^{-1}\boldsymbol{X}^T\boldsymbol{y}. -\]
-

We note also that since our design matrix is defined as \(\boldsymbol{X}\in -{\mathbb{R}}^{n\times p}\), the product \(\boldsymbol{X}^T\boldsymbol{X} \in -{\mathbb{R}}^{p\times p}\). In the above case we have that \(p \ll n\), -in our case \(p=5\) meaning that we end up with inverting a small -\(5\times 5\) matrix. This is a rather common situation, in many cases we end up with low-dimensional -matrices to invert. The methods discussed here and for many other -supervised learning algorithms like classification with logistic -regression or support vector machines, exhibit dimensionalities which -allow for the usage of direct linear algebra methods such as LU decomposition or Singular Value Decomposition (SVD) for finding the inverse of the matrix -\(\boldsymbol{X}^T\boldsymbol{X}\).

-

Small question: Do you think the example we have at hand here (the nuclear binding energies) can lead to problems in inverting the matrix \(\boldsymbol{X}^T\boldsymbol{X}\)? What kind of problems can we expect?

-

The following matrix and vector relation will be useful here and for the rest of the course. Vectors are always written as boldfaced lower case letters and -matrices as upper case boldfaced letters.

-

4 -3

-

< -< -< -! -! -M -A -T -H -_ -B -L -O -C -K

-

4 -4

-

< -< -< -! -! -M -A -T -H -_ -B -L -O -C -K

-

4 -5

-

< -< -< -! -! -M -A -T -H -_ -B -L -O -C -K

-
-\[ -\frac{\partial\log{\vert\boldsymbol{A}\vert}}{\partial \boldsymbol{A}}=(\boldsymbol{A}^{-1})^T. -\]
-

We can then compute the second derivative of the cost function, which in our case is the second derivative -of the means squared error. This leads to

-
-\[ -\frac{\partial^2 C(\boldsymbol{\beta})}{\partial \boldsymbol{\beta}^T\partial \boldsymbol{\beta}} =\frac{2}{n}\boldsymbol{X}^T\boldsymbol{X}. -\]
-

This quantity defines was what is called the Hessian matrix (the second derivative of a function we want to optimize).

-

The Hessian matrix plays an important role and is defined for the mean squared error as

-
-\[ -\boldsymbol{H}=\boldsymbol{X}^T\boldsymbol{X}. -\]
-

The Hessian matrix for ordinary least squares is also proportional to -the covariance matrix. As we will see in the chapter on Ridge and Lasso regression, This means that we can use the Singular Value Decomposition of a matrix to find -the eigenvalues of the covariance matrix and the Hessian matrix in -terms of the singular values.

-

The residuals \(\boldsymbol{\epsilon}\) are in turn given by

-
-\[ -\boldsymbol{\epsilon} = \boldsymbol{y}-\boldsymbol{\tilde{y}} = \boldsymbol{y}-\boldsymbol{X}\boldsymbol{\beta}, -\]
-

and with

-
-\[ -\boldsymbol{X}^T\left( \boldsymbol{y}-\boldsymbol{X}\boldsymbol{\beta}\right)= 0, -\]
-

we have

-
-\[ -\boldsymbol{X}^T\boldsymbol{\epsilon}=\boldsymbol{X}^T\left( \boldsymbol{y}-\boldsymbol{X}\boldsymbol{\beta}\right)= 0, -\]
-

meaning that the solution for \(\boldsymbol{\beta}\) is the one which minimizes the residuals. Later we will link this with the maximum likelihood approach.

-

Let us now return to our nuclear binding energies and simply code the above equations.

-

It is rather straightforward to implement the matrix inversion and obtain the parameters \(\boldsymbol{\beta}\). After having defined the matrix \(\boldsymbol{X}\) we simply need to -write

-
-
-
# matrix inversion to find beta
-beta = np.linalg.inv(X.T.dot(X)).dot(X.T).dot(Energies)
-# and then make the prediction
-ytilde = X @ beta
-
-
-
-
-

Alternatively, you can use the least squares functionality in Numpy as

-
-
-
fit = np.linalg.lstsq(X, Energies, rcond =None)[0]
-ytildenp = np.dot(fit,X.T)
-
-
-
-
-

And finally we plot our fit with and compare with data

-
-
-
Masses['Eapprox']  = ytilde
-# Generate a plot comparing the experimental with the fitted values values.
-fig, ax = plt.subplots()
-ax.set_xlabel(r'$A = N + Z$')
-ax.set_ylabel(r'$E_\mathrm{bind}\,/\mathrm{MeV}$')
-ax.plot(Masses['A'], Masses['Ebinding'], alpha=0.7, lw=2,
-            label='Ame2016')
-ax.plot(Masses['A'], Masses['Eapprox'], alpha=0.7, lw=2, c='m',
-            label='Fit')
-ax.legend()
-save_fig("Masses2016OLS")
-plt.show()
-
-
-
-
-_images/chapter1_136_0.png -
-
-

We can easily test our fit by computing the \(R2\) score that we discussed in connection with the functionality of Scikit-Learn in the introductory slides. -Since we are not using Scikit-Learn here we can define our own \(R2\) function as

-
-
-
def R2(y_data, y_model):
-    return 1 - np.sum((y_data - y_model) ** 2) / np.sum((y_data - np.mean(y_data)) ** 2)
-
-
-
-
-

and we would be using it as

-
-
-
print(R2(Energies,ytilde))
-
-
-
-
-
0.9547578478889096
-
-
-
-
-

We can easily add our MSE score as

-
-
-
def MSE(y_data,y_model):
-    n = np.size(y_model)
-    return np.sum((y_data-y_model)**2)/n
-
-print(MSE(Energies,ytilde))
-
-
-
-
-
0.03787596148305236
-
-
-
-
-

and finally the relative error as

-
-
-
def RelativeError(y_data,y_model):
-    return abs((y_data-y_model)/y_data)
-print(RelativeError(Energies, ytilde))
-
-
-
-
-
A        
-1    0            inf
-2    1       1.123190
-3    2       0.327631
-4    6       0.344172
-5    9       0.044402
-               ...   
-264  3304    0.009911
-265  3310    0.009154
-266  3317    0.007824
-269  3338    0.011347
-270  3344    0.009790
-Name: Ebinding, Length: 267, dtype: float64
-
-
-
-
-
-

3.4.1. The \(\chi^2\) function

-

Normally, the response (dependent or outcome) variable \(y_i\) is the -outcome of a numerical experiment or another type of experiment and is -thus only an approximation to the true value. It is then always -accompanied by an error estimate, often limited to a statistical error -estimate given by the standard deviation discussed earlier. In the -discussion here we will treat \(y_i\) as our exact value for the -response variable.

-

Introducing the standard deviation \(\sigma_i\) for each measurement -\(y_i\), we define now the \(\chi^2\) function (omitting the \(1/n\) term) -as

-
-\[ -\chi^2(\boldsymbol{\beta})=\frac{1}{n}\sum_{i=0}^{n-1}\frac{\left(y_i-\tilde{y}_i\right)^2}{\sigma_i^2}=\frac{1}{n}\left\{\left(\boldsymbol{y}-\boldsymbol{\tilde{y}}\right)^T\frac{1}{\boldsymbol{\Sigma^2}}\left(\boldsymbol{y}-\boldsymbol{\tilde{y}}\right)\right\}, -\]
-

where the matrix \(\boldsymbol{\Sigma}\) is a diagonal matrix with \(\sigma_i\) as matrix elements.

-

In order to find the parameters \(\beta_i\) we will then minimize the spread of \(\chi^2(\boldsymbol{\beta})\) by requiring

-
-\[ -\frac{\partial \chi^2(\boldsymbol{\beta})}{\partial \beta_j} = \frac{\partial }{\partial \beta_j}\left[ \frac{1}{n}\sum_{i=0}^{n-1}\left(\frac{y_i-\beta_0x_{i,0}-\beta_1x_{i,1}-\beta_2x_{i,2}-\dots-\beta_{n-1}x_{i,n-1}}{\sigma_i}\right)^2\right]=0, -\]
-

which results in

-
-\[ -\frac{\partial \chi^2(\boldsymbol{\beta})}{\partial \beta_j} = -\frac{2}{n}\left[ \sum_{i=0}^{n-1}\frac{x_{ij}}{\sigma_i}\left(\frac{y_i-\beta_0x_{i,0}-\beta_1x_{i,1}-\beta_2x_{i,2}-\dots-\beta_{n-1}x_{i,n-1}}{\sigma_i}\right)\right]=0, -\]
-

or in a matrix-vector form as

-
-\[ -\frac{\partial \chi^2(\boldsymbol{\beta})}{\partial \boldsymbol{\beta}} = 0 = \boldsymbol{A}^T\left( \boldsymbol{b}-\boldsymbol{A}\boldsymbol{\beta}\right). -\]
-

where we have defined the matrix \(\boldsymbol{A} =\boldsymbol{X}/\boldsymbol{\Sigma}\) with matrix elements \(a_{ij} = x_{ij}/\sigma_i\) and the vector \(\boldsymbol{b}\) with elements \(b_i = y_i/\sigma_i\).

-

We can rewrite

-
-\[ -\frac{\partial \chi^2(\boldsymbol{\beta})}{\partial \boldsymbol{\beta}} = 0 = \boldsymbol{A}^T\left( \boldsymbol{b}-\boldsymbol{A}\boldsymbol{\beta}\right), -\]
-

as

-
-\[ -\boldsymbol{A}^T\boldsymbol{b} = \boldsymbol{A}^T\boldsymbol{A}\boldsymbol{\beta}, -\]
-

and if the matrix \(\boldsymbol{A}^T\boldsymbol{A}\) is invertible we have the solution

-
-\[ -\boldsymbol{\beta} =\left(\boldsymbol{A}^T\boldsymbol{A}\right)^{-1}\boldsymbol{A}^T\boldsymbol{b}. -\]
-

If we then introduce the matrix

-
-\[ -\boldsymbol{H} = \left(\boldsymbol{A}^T\boldsymbol{A}\right)^{-1}, -\]
-

we have then the following expression for the parameters \(\beta_j\) (the matrix elements of \(\boldsymbol{H}\) are \(h_{ij}\))

-
-\[ -\beta_j = \sum_{k=0}^{p-1}h_{jk}\sum_{i=0}^{n-1}\frac{y_i}{\sigma_i}\frac{x_{ik}}{\sigma_i} = \sum_{k=0}^{p-1}h_{jk}\sum_{i=0}^{n-1}b_ia_{ik} -\]
-

We state without proof the expression for the uncertainty in the parameters \(\beta_j\) as (we leave this as an exercise)

-
-\[ -\sigma^2(\beta_j) = \sum_{i=0}^{n-1}\sigma_i^2\left( \frac{\partial \beta_j}{\partial y_i}\right)^2, -\]
-

resulting in

-
-\[ -\sigma^2(\beta_j) = \left(\sum_{k=0}^{p-1}h_{jk}\sum_{i=0}^{n-1}a_{ik}\right)\left(\sum_{l=0}^{p-1}h_{jl}\sum_{m=0}^{n-1}a_{ml}\right) = h_{jj}! -\]
-

The first step here is to approximate the function \(y\) with a first-order polynomial, that is we write

-
-\[ -y=y(x) \rightarrow y(x_i) \approx \beta_0+\beta_1 x_i. -\]
-

By computing the derivatives of \(\chi^2\) with respect to \(\beta_0\) and \(\beta_1\) show that these are given by

-
-\[ -\frac{\partial \chi^2(\boldsymbol{\beta})}{\partial \beta_0} = -2\left[ \frac{1}{n}\sum_{i=0}^{n-1}\left(\frac{y_i-\beta_0-\beta_1x_{i}}{\sigma_i^2}\right)\right]=0, -\]
-

and

-
-\[ -\frac{\partial \chi^2(\boldsymbol{\beta})}{\partial \beta_1} = -\frac{2}{n}\left[ \sum_{i=0}^{n-1}x_i\left(\frac{y_i-\beta_0-\beta_1x_{i}}{\sigma_i^2}\right)\right]=0. -\]
-

For a linear fit (a first-order polynomial) we don’t need to invert a matrix!!
-Defining

-
-\[ -\gamma = \sum_{i=0}^{n-1}\frac{1}{\sigma_i^2}, -\]
-
-\[ -\gamma_x = \sum_{i=0}^{n-1}\frac{x_{i}}{\sigma_i^2}, -\]
-
-\[ -\gamma_y = \sum_{i=0}^{n-1}\left(\frac{y_i}{\sigma_i^2}\right), -\]
-
-\[ -\gamma_{xx} = \sum_{i=0}^{n-1}\frac{x_ix_{i}}{\sigma_i^2}, -\]
-
-\[ -\gamma_{xy} = \sum_{i=0}^{n-1}\frac{y_ix_{i}}{\sigma_i^2}, -\]
-

we obtain

-
-\[ -\beta_0 = \frac{\gamma_{xx}\gamma_y-\gamma_x\gamma_y}{\gamma\gamma_{xx}-\gamma_x^2}, -\]
-
-\[ -\beta_1 = \frac{\gamma_{xy}\gamma-\gamma_x\gamma_y}{\gamma\gamma_{xx}-\gamma_x^2}. -\]
-

This approach (different linear and non-linear regression) suffers -often from both being underdetermined and overdetermined in the -unknown coefficients \(\beta_i\). A better approach is to use the -Singular Value Decomposition (SVD) method discussed below. Or using -Lasso and Ridge regression. See below.

-
-
-

3.4.2. Fitting an Equation of State for Dense Nuclear Matter

-

Before we continue, let us introduce yet another example. We are going to fit the -nuclear equation of state using results from many-body calculations. -The equation of state we have made available here, as function of -density, has been derived using modern nucleon-nucleon potentials with -the addition of three-body -forces. This -time the file is presented as a standard csv file.

-

The beginning of the Python code here is similar to what you have seen -before, with the same initializations and declarations. We use also -pandas again, rather extensively in order to organize our data.

-

The difference now is that we use Scikit-Learn’s regression tools -instead of our own matrix inversion implementation.

-
-
-
# Common imports
-import os
-import numpy as np
-import pandas as pd
-import matplotlib.pyplot as plt
-import matplotlib.pyplot as plt
-import sklearn.linear_model as skl
-from sklearn.metrics import mean_squared_error, r2_score, mean_absolute_error
-
-# Where to save the figures and data files
-PROJECT_ROOT_DIR = "Results"
-FIGURE_ID = "Results/FigureFiles"
-DATA_ID = "DataFiles/"
-
-if not os.path.exists(PROJECT_ROOT_DIR):
-    os.mkdir(PROJECT_ROOT_DIR)
-
-if not os.path.exists(FIGURE_ID):
-    os.makedirs(FIGURE_ID)
-
-if not os.path.exists(DATA_ID):
-    os.makedirs(DATA_ID)
-
-def image_path(fig_id):
-    return os.path.join(FIGURE_ID, fig_id)
-
-def data_path(dat_id):
-    return os.path.join(DATA_ID, dat_id)
-
-def save_fig(fig_id):
-    plt.savefig(image_path(fig_id) + ".png", format='png')
-
-infile = open(data_path("EoS.csv"),'r')
-
-# Read the EoS data as  csv file and organize the data into two arrays with density and energies
-EoS = pd.read_csv(infile, names=('Density', 'Energy'))
-EoS['Energy'] = pd.to_numeric(EoS['Energy'], errors='coerce')
-EoS = EoS.dropna()
-Energies = EoS['Energy']
-Density = EoS['Density']
-#  The design matrix now as function of various polytrops
-X = np.zeros((len(Density),4))
-X[:,3] = Density**(4.0/3.0)
-X[:,2] = Density
-X[:,1] = Density**(2.0/3.0)
-X[:,0] = 1
-
-# We use now Scikit-Learn's linear regressor and ridge regressor
-# OLS part
-clf = skl.LinearRegression().fit(X, Energies)
-ytilde = clf.predict(X)
-EoS['Eols']  = ytilde
-# The mean squared error                               
-print("Mean squared error: %.2f" % mean_squared_error(Energies, ytilde))
-# Explained variance score: 1 is perfect prediction                                 
-print('Variance score: %.2f' % r2_score(Energies, ytilde))
-# Mean absolute error                                                           
-print('Mean absolute error: %.2f' % mean_absolute_error(Energies, ytilde))
-print(clf.coef_, clf.intercept_)
-
-
-fig, ax = plt.subplots()
-ax.set_xlabel(r'$\rho[\mathrm{fm}^{-3}]$')
-ax.set_ylabel(r'Energy per particle')
-ax.plot(EoS['Density'], EoS['Energy'], alpha=0.7, lw=2,
-            label='Theoretical data')
-ax.plot(EoS['Density'], EoS['Eols'], alpha=0.7, lw=2, c='m',
-            label='OLS')
-ax.legend()
-save_fig("EoSfitting")
-plt.show()
-
-
-
-
-
Mean squared error: 12.36
-Variance score: 1.00
-Mean absolute error: 2.83
-[   0.          618.32047562 -861.13519106 1404.91549644] -11.057088709963637
-
-
-_images/chapter1_183_1.png -
-
-

The above simple polynomial in density \(\rho\) gives an excellent fit -to the data.

-
-
-
-

3.5. Splitting our Data in Training and Test data

-

It is normal in essentially all Machine Learning studies to split the -data in a training set and a test set (sometimes also an additional -validation set). Scikit-Learn has an own function for this. There -is no explicit recipe for how much data should be included as training -data and say test data. An accepted rule of thumb is to use -approximately \(2/3\) to \(4/5\) of the data as training data. We will -postpone a discussion of this splitting to the end of these notes and -our discussion of the so-called bias-variance tradeoff. Here we -limit ourselves to repeat the above equation of state fitting example -but now splitting the data into a training set and a test set.

-

Let us study some examples. The first code here takes a simple -one-dimensional second-order polynomial and we fit it to a -second-order polynomial. Depending on the strength of the added noise, -the various measures like the \(R2\) score or the mean-squared error, -the fit becomes better or worse.

-
-
-
import os
-import numpy as np
-import pandas as pd
-import matplotlib.pyplot as plt
-from sklearn.model_selection import train_test_split
-
-
-def R2(y_data, y_model):
-    return 1 - np.sum((y_data - y_model) ** 2) / np.sum((y_data - np.mean(y_data)) ** 2)
-def MSE(y_data,y_model):
-    n = np.size(y_model)
-    return np.sum((y_data-y_model)**2)/n
-
-x = np.random.rand(100)
-y = 2.0+5*x*x+0.1*np.random.randn(100)
-
-
-#  The design matrix now as function of a given polynomial
-X = np.zeros((len(x),3))
-X[:,0] = 1.0
-X[:,1] = x
-X[:,2] = x**2
-# We split the data in test and training data
-X_train, X_test, y_train, y_test = train_test_split(X, y, test_size=0.2)
-# matrix inversion to find beta
-beta = np.linalg.inv(X_train.T @ X_train) @ X_train.T @ y_train
-print(beta)
-# and then make the prediction
-ytilde = X_train @ beta
-print("Training R2")
-print(R2(y_train,ytilde))
-print("Training MSE")
-print(MSE(y_train,ytilde))
-ypredict = X_test @ beta
-print("Test R2")
-print(R2(y_test,ypredict))
-print("Test MSE")
-print(MSE(y_test,ypredict))
-
-
-
-
-
[2.00240127 0.09885613 4.86421839]
-Training R2
-0.994788006691541
-Training MSE
-0.011239358265567037
-Test R2
-0.9940257354319456
-Test MSE
-0.010708859852916969
-
-
-
-
-

Alternatively, you could write your own test-train splitting function as shown here.

-
-
-
# equivalently in numpy
-def train_test_split_numpy(inputs, labels, train_size, test_size):
-    n_inputs = len(inputs)
-    inputs_shuffled = inputs.copy()
-    labels_shuffled = labels.copy()
-
-    np.random.shuffle(inputs_shuffled)
-    np.random.shuffle(labels_shuffled)
-
-    train_end = int(n_inputs*train_size)
-    X_train, X_test = inputs_shuffled[:train_end], inputs_shuffled[train_end:]
-    Y_train, Y_test = labels_shuffled[:train_end], labels_shuffled[train_end:]
-
-    return X_train, X_test, Y_train, Y_test
-
-
-
-
-

But since scikit-learn has its own function for doing this and since -it interfaces easily with tensorflow and other libraries, we -normally recommend using the latter functionality.

-

As another example, we apply the training and testing split to -to the above equation of state fitting example -but now splitting the data into a training set and a test set.

-
-
-
import os
-import numpy as np
-import pandas as pd
-import matplotlib.pyplot as plt
-from sklearn.model_selection import train_test_split
-# Where to save the figures and data files
-PROJECT_ROOT_DIR = "Results"
-FIGURE_ID = "Results/FigureFiles"
-DATA_ID = "DataFiles/"
-
-if not os.path.exists(PROJECT_ROOT_DIR):
-    os.mkdir(PROJECT_ROOT_DIR)
-
-if not os.path.exists(FIGURE_ID):
-    os.makedirs(FIGURE_ID)
-
-if not os.path.exists(DATA_ID):
-    os.makedirs(DATA_ID)
-
-def image_path(fig_id):
-    return os.path.join(FIGURE_ID, fig_id)
-
-def data_path(dat_id):
-    return os.path.join(DATA_ID, dat_id)
-
-def save_fig(fig_id):
-    plt.savefig(image_path(fig_id) + ".png", format='png')
-
-def R2(y_data, y_model):
-    return 1 - np.sum((y_data - y_model) ** 2) / np.sum((y_data - np.mean(y_data)) ** 2)
-def MSE(y_data,y_model):
-    n = np.size(y_model)
-    return np.sum((y_data-y_model)**2)/n
-
-infile = open(data_path("EoS.csv"),'r')
-
-# Read the EoS data as  csv file and organized into two arrays with density and energies
-EoS = pd.read_csv(infile, names=('Density', 'Energy'))
-EoS['Energy'] = pd.to_numeric(EoS['Energy'], errors='coerce')
-EoS = EoS.dropna()
-Energies = EoS['Energy']
-Density = EoS['Density']
-#  The design matrix now as function of various polytrops
-X = np.zeros((len(Density),5))
-X[:,0] = 1
-X[:,1] = Density**(2.0/3.0)
-X[:,2] = Density
-X[:,3] = Density**(4.0/3.0)
-X[:,4] = Density**(5.0/3.0)
-# We split the data in test and training data
-X_train, X_test, y_train, y_test = train_test_split(X, Energies, test_size=0.2)
-# matrix inversion to find beta
-beta = np.linalg.inv(X_train.T.dot(X_train)).dot(X_train.T).dot(y_train)
-# and then make the prediction
-ytilde = X_train @ beta
-print("Training R2")
-print(R2(y_train,ytilde))
-print("Training MSE")
-print(MSE(y_train,ytilde))
-ypredict = X_test @ beta
-print("Test R2")
-print(R2(y_test,ypredict))
-print("Test MSE")
-print(MSE(y_test,ypredict))
-
-
-
-
-
Training R2
-0.9999940124132914
-Training MSE
-2.1043064188572242
-Test R2
-0.9999292683946882
-Test MSE
-56.241106846210215
-
-
-
-
-
-
-

3.6. The Boston housing data example

-

The Boston housing
-data set was originally a part of UCI Machine Learning Repository -and has been removed now. The data set is now included in Scikit-Learn’s -library. There are 506 samples and 13 feature (predictor) variables -in this data set. The objective is to predict the value of prices of -the house using the features (predictors) listed here.

-

The features/predictors are

-
    -
  1. CRIM: Per capita crime rate by town

  2. -
  3. ZN: Proportion of residential land zoned for lots over 25000 square feet

  4. -
  5. INDUS: Proportion of non-retail business acres per town

  6. -
  7. CHAS: Charles River dummy variable (= 1 if tract bounds river; 0 otherwise)

  8. -
  9. NOX: Nitric oxide concentration (parts per 10 million)

  10. -
  11. RM: Average number of rooms per dwelling

  12. -
  13. AGE: Proportion of owner-occupied units built prior to 1940

  14. -
  15. DIS: Weighted distances to five Boston employment centers

  16. -
  17. RAD: Index of accessibility to radial highways

  18. -
  19. TAX: Full-value property tax rate per USD10000

  20. -
  21. B: \(1000(Bk - 0.63)^2\), where \(Bk\) is the proportion of [people of African American descent] by town

  22. -
  23. LSTAT: Percentage of lower status of the population

  24. -
  25. MEDV: Median value of owner-occupied homes in USD 1000s

  26. -
-
-
-

3.7. Housing data, the code

-

We start by importing the libraries

-
-
-
import numpy as np
-import matplotlib.pyplot as plt 
-
-import pandas as pd  
-import seaborn as sns
-
-
-
-
-

and load the Boston Housing DataSet from Scikit-Learn

-
-
-
from sklearn.datasets import load_boston
-
-boston_dataset = load_boston()
-
-# boston_dataset is a dictionary
-# let's check what it contains
-boston_dataset.keys()
-
-
-
-
-
dict_keys(['data', 'target', 'feature_names', 'DESCR', 'filename'])
-
-
-
-
-

Then we invoke Pandas

-
-
-
boston = pd.DataFrame(boston_dataset.data, columns=boston_dataset.feature_names)
-boston.head()
-boston['MEDV'] = boston_dataset.target
-
-
-
-
-

and preprocess the data

-
-
-
# check for missing values in all the columns
-boston.isnull().sum()
-
-
-
-
-
CRIM       0
-ZN         0
-INDUS      0
-CHAS       0
-NOX        0
-RM         0
-AGE        0
-DIS        0
-RAD        0
-TAX        0
-PTRATIO    0
-B          0
-LSTAT      0
-MEDV       0
-dtype: int64
-
-
-
-
-

We can then visualize the data

-
-
-
# set the size of the figure
-sns.set(rc={'figure.figsize':(11.7,8.27)})
-
-# plot a histogram showing the distribution of the target values
-sns.distplot(boston['MEDV'], bins=30)
-plt.show()
-
-
-
-
-
/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/seaborn/distributions.py:2551: FutureWarning: `distplot` is a deprecated function and will be removed in a future version. Please adapt your code to use either `displot` (a figure-level function with similar flexibility) or `histplot` (an axes-level function for histograms).
-  warnings.warn(msg, FutureWarning)
-
-
-_images/chapter1_199_1.png -
-
-

It is now useful to look at the correlation matrix

-
-
-
# compute the pair wise correlation for all columns  
-correlation_matrix = boston.corr().round(2)
-# use the heatmap function from seaborn to plot the correlation matrix
-# annot = True to print the values inside the square
-sns.heatmap(data=correlation_matrix, annot=True)
-
-
-
-
-
<AxesSubplot:>
-
-
-_images/chapter1_201_1.png -
-
-

From the above coorelation plot we can see that MEDV is strongly correlated to LSTAT and RM. We see also that RAD and TAX are stronly correlated, but we don’t include this in our features together to avoid multi-colinearity

-
-
-
plt.figure(figsize=(20, 5))
-
-features = ['LSTAT', 'RM']
-target = boston['MEDV']
-
-for i, col in enumerate(features):
-    plt.subplot(1, len(features) , i+1)
-    x = boston[col]
-    y = target
-    plt.scatter(x, y, marker='o')
-    plt.title(col)
-    plt.xlabel(col)
-    plt.ylabel('MEDV')
-
-
-
-
-_images/chapter1_203_0.png -
-
-

Now we start training our model

-
-
-
X = pd.DataFrame(np.c_[boston['LSTAT'], boston['RM']], columns = ['LSTAT','RM'])
-Y = boston['MEDV']
-
-
-
-
-

We split the data into training and test sets

-
-
-
from sklearn.model_selection import train_test_split
-
-# splits the training and test data set in 80% : 20%
-# assign random_state to any value.This ensures consistency.
-X_train, X_test, Y_train, Y_test = train_test_split(X, Y, test_size = 0.2, random_state=5)
-print(X_train.shape)
-print(X_test.shape)
-print(Y_train.shape)
-print(Y_test.shape)
-
-
-
-
-
(404, 2)
-(102, 2)
-(404,)
-(102,)
-
-
-
-
-

Then we use the linear regression functionality from Scikit-Learn

-
-
-
from sklearn.linear_model import LinearRegression
-from sklearn.metrics import mean_squared_error, r2_score
-
-lin_model = LinearRegression()
-lin_model.fit(X_train, Y_train)
-
-# model evaluation for training set
-
-y_train_predict = lin_model.predict(X_train)
-rmse = (np.sqrt(mean_squared_error(Y_train, y_train_predict)))
-r2 = r2_score(Y_train, y_train_predict)
-
-print("The model performance for training set")
-print("--------------------------------------")
-print('RMSE is {}'.format(rmse))
-print('R2 score is {}'.format(r2))
-print("\n")
-
-# model evaluation for testing set
-
-y_test_predict = lin_model.predict(X_test)
-# root mean square error of the model
-rmse = (np.sqrt(mean_squared_error(Y_test, y_test_predict)))
-
-# r-squared score of the model
-r2 = r2_score(Y_test, y_test_predict)
-
-print("The model performance for testing set")
-print("--------------------------------------")
-print('RMSE is {}'.format(rmse))
-print('R2 score is {}'.format(r2))
-
-
-
-
-
The model performance for training set
---------------------------------------
-RMSE is 5.637129335071195
-R2 score is 0.6300745149331701
-
-
-The model performance for testing set
---------------------------------------
-RMSE is 5.137400784702912
-R2 score is 0.6628996975186952
-
-
-
-
-
-
-
# plotting the y_test vs y_pred
-# ideally should have been a straight line
-plt.scatter(Y_test, y_test_predict)
-plt.show()
-
-
-
-
-_images/chapter1_210_0.png -
-
-
-
-

3.8. Reducing the number of degrees of freedom, overarching view

-

Many Machine Learning problems involve thousands or even millions of -features for each training instance. Not only does this make training -extremely slow, it can also make it much harder to find a good -solution, as we will see. This problem is often referred to as the -curse of dimensionality. Fortunately, in real-world problems, it is -often possible to reduce the number of features considerably, turning -an intractable problem into a tractable one.

-

Later we will discuss some of the most popular dimensionality reduction -techniques: the principal component analysis (PCA), Kernel PCA, and -Locally Linear Embedding (LLE).

-

Principal component analysis and its various variants deal with the -problem of fitting a low-dimensional affine -subspace to a set of of -data points in a high-dimensional space. With its family of methods it -is one of the most used tools in data modeling, compression and -visualization.

-

Before we proceed however, we will discuss how to preprocess our -data. Till now and in connection with our previous examples we have -not met so many cases where we are too sensitive to the scaling of our -data. Normally the data may need a rescaling and/or may be sensitive -to extreme values. Scaling the data renders our inputs much more -suitable for the algorithms we want to employ.

-

For data sets gathered for real world applications, it is rather normal that -different features have very different units and -numerical scales. For example, a data set detailing health habits may include -features such as age in the range \(0-80\), and caloric intake of order \(2000\). -Many machine learning methods sensitive to the scales of the features and may perform poorly if they -are very different scales. Therefore, it is typical to scale -the features in a way to avoid such outlier values.

-

Scikit-Learn has several functions which allow us to rescale the -data, normally resulting in much better results in terms of various -accuracy scores. The StandardScaler function in Scikit-Learn -ensures that for each feature/predictor we study the mean value is -zero and the variance is one (every column in the design/feature -matrix). This scaling has the drawback that it does not ensure that -we have a particular maximum or minimum in our data set. Another -function included in Scikit-Learn is the MinMaxScaler which -ensures that all features are exactly between \(0\) and \(1\). The

-

The Normalizer scales each data -point such that the feature vector has a euclidean length of one. In other words, it -projects a data point on the circle (or sphere in the case of higher dimensions) with a -radius of 1. This means every data point is scaled by a different number (by the -inverse of it’s length). -This normalization is often used when only the direction (or angle) of the data matters, -not the length of the feature vector.

-

The RobustScaler works similarly to the StandardScaler in that it -ensures statistical properties for each feature that guarantee that -they are on the same scale. However, the RobustScaler uses the median -and quartiles, instead of mean and variance. This makes the -RobustScaler ignore data points that are very different from the rest -(like measurement errors). These odd data points are also called -outliers, and might often lead to trouble for other scaling -techniques.

-

Many features are often scaled using standardization to improve -performance. In Scikit-Learn this is given by the StandardScaler -function as discussed above. It is easy however to write your own. -Mathematically, this involves subtracting the mean and divide by the -standard deviation over the data set, for each feature:

-
-\[ -x_j^{(i)} \rightarrow \frac{x_j^{(i)} - \overline{x}_j}{\sigma(x_j)}, -\]
-

where \(\overline{x}_j\) and \(\sigma(x_j)\) are the mean and standard -deviation, respectively, of the feature \(x_j\). This ensures that each -feature has zero mean and unit standard deviation. For data sets -where we do not have the standard deviation or don’t wish to calculate -it, it is then common to simply set it to one.

-

Let us consider the following vanilla example where we use both -Scikit-Learn and write our own function as well. We produce a -simple test design matrix with random numbers. Each column could then -represent a specific feature whose mean value is subracted.

-
-
-
import sklearn.linear_model as skl
-from sklearn.metrics import mean_squared_error
-from sklearn.model_selection import  train_test_split
-from sklearn.preprocessing import MinMaxScaler, StandardScaler, Normalizer
-import numpy as np
-import pandas as pd
-from IPython.display import display
-np.random.seed(100)
-# setting up a 10 x 5 matrix
-rows = 10
-cols = 5
-X = np.random.randn(rows,cols)
-XPandas = pd.DataFrame(X)
-display(XPandas)
-print(XPandas.mean())
-print(XPandas.std())
-XPandas = (XPandas -XPandas.mean())
-display(XPandas)
-#  This option does not include the standard deviation
-scaler = StandardScaler(with_std=False)
-scaler.fit(X)
-Xscaled = scaler.transform(X)
-display(XPandas-Xscaled)
-
-
-
-
-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
01234
0-1.7497650.3426801.153036-0.2524360.981321
10.5142190.221180-1.070043-0.1894960.255001
2-0.4580270.435163-0.5835950.8168470.672721
3-0.104411-0.5312801.029733-0.438136-1.118318
41.6189821.541605-0.251879-0.8424360.184519
50.9370820.7310001.361556-0.3262380.055676
60.222400-1.443217-0.7563520.8164540.750445
7-0.4559471.189622-1.690617-1.356399-1.232435
8-0.544439-0.6681720.007315-0.6129391.299748
9-1.733096-0.9833100.357508-1.6135791.470714
-
0   -0.175300
-1    0.083527
-2   -0.044334
-3   -0.399836
-4    0.331939
-dtype: float64
-0    1.069584
-1    0.965548
-2    1.018232
-3    0.793167
-4    0.918992
-dtype: float64
-
-
-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
01234
0-1.5744650.2591531.1973700.1474000.649382
10.6895190.137652-1.0257090.210340-0.076938
2-0.2827270.351636-0.5392611.2166830.340782
30.070889-0.6148081.074067-0.038300-1.450257
41.7942821.458078-0.207545-0.442600-0.147420
51.1123830.6474731.4058900.073598-0.276263
60.397700-1.526744-0.7120181.2162900.418506
7-0.2806471.106095-1.646283-0.956563-1.564374
8-0.369139-0.7516990.051649-0.2131030.967809
9-1.557795-1.0668370.401842-1.2137431.138775
-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
01234
00.00.00.00.00.0
10.00.00.00.00.0
20.00.00.00.00.0
30.00.00.00.00.0
40.00.00.00.00.0
50.00.00.00.00.0
60.00.00.00.00.0
70.00.00.00.00.0
80.00.00.00.00.0
90.00.00.00.00.0
-
-
-

Small exercise: perform the standard scaling by including the standard deviation and compare with what Scikit-Learn gives.

-

Another commonly used scaling method is min-max scaling. This is very -useful for when we want the features to lie in a certain interval. To -scale the feature \(x_j\) to the interval \([a, b]\), we can apply the -transformation

-
-\[ -x_j^{(i)} \rightarrow (b-a)\frac{x_j^{(i)} - \min(x_j)}{\max(x_j) - \min(x_j)} - a -\]
-

where \(\min(x_j)\) and \(\max(x_j)\) return the minimum and maximum value of \(x_j\) over the data set, respectively.

-
-
-

3.9. Testing the Means Squared Error as function of Complexity

-

Before we proceed with a more detailed analysis of the so-called -Bias-Variance tradeoff, we present here an example of the relation -between model complexity and the mean squared error for the triaining -data and the test data.

-

The results here tell us clearly that for the data not included in the -training, there is an optimal model as function of the complexity of -ourmodel (here in terms of the polynomial degree of the model).

-

The results here will vary as function of model complexity and the amount od data used for training.

-

Our data is defined by \(x\in [-3,3]\) with a total of for example \(100\) data points.

-
-
-
import matplotlib.pyplot as plt
-import numpy as np
-from sklearn.linear_model import LinearRegression, Ridge, Lasso
-from sklearn.preprocessing import PolynomialFeatures
-from sklearn.model_selection import train_test_split
-from sklearn.pipeline import make_pipeline
-
-
-np.random.seed(2018)
-n = 100
-maxdegree = 14
-# Make data set.
-x = np.linspace(-3, 3, n).reshape(-1, 1)
-y = np.exp(-x**2) + 1.5 * np.exp(-(x-2)**2)+ np.random.normal(0, 0.1, x.shape)
-TestError = np.zeros(maxdegree)
-TrainError = np.zeros(maxdegree)
-polydegree = np.zeros(maxdegree)
-x_train, x_test, y_train, y_test = train_test_split(x, y, test_size=0.2)
-
-
-for degree in range(maxdegree):
-    model = make_pipeline(PolynomialFeatures(degree=degree), LinearRegression(fit_intercept=False))
-    clf = model.fit(x_train,y_train)
-    y_fit = clf.predict(x_train)
-    y_pred = clf.predict(x_test) 
-    polydegree[degree] = degree
-    TestError[degree] = np.mean( np.mean((y_test - y_pred)**2) )
-    TrainError[degree] = np.mean( np.mean((y_train - y_fit)**2) )
-
-plt.plot(polydegree, TestError, label='Test Error')
-plt.plot(polydegree, TrainError, label='Train Error')
-plt.legend()
-plt.show()
-
-
-
-
-_images/chapter1_218_0.png -
-
-
-
-

3.10. Exercises

-
-

3.10.1. Exercise: Setting up various Python environments

-

The first exercise here is of a mere technical art. We want you to have

-
    -
  • git as a version control software and to establish a user account on a provider like GitHub. Other providers like GitLab etc are equally fine. You can also use the University of Oslo GitHub facilities.

  • -
  • Install various Python packages

  • -
-

We will make extensive use of Python as programming language and its -myriad of available libraries. You will find -IPython/Jupyter notebooks invaluable in your work. You can run R -codes in the Jupyter/IPython notebooks, with the immediate benefit of -visualizing your data. You can also use compiled languages like C++, -Rust, Fortran etc if you prefer. The focus in these lectures will be -on Python.

-

If you have Python installed (we recommend Python3) and you feel -pretty familiar with installing different packages, we recommend that -you install the following Python packages via pip as

-
    -
  1. pip install numpy scipy matplotlib ipython scikit-learn sympy pandas pillow

  2. -
-

For Tensorflow, we recommend following the instructions in the text of -Aurelien Geron, Hands‑On Machine Learning with Scikit‑Learn and TensorFlow, O’Reilly

-

We will come back to tensorflow later.

-

For Python3, replace pip with pip3.

-

For OSX users we recommend, after having installed Xcode, to -install brew. Brew allows for a seamless installation of additional -software via for example

-
    -
  1. brew install python3

  2. -
-

For Linux users, with its variety of distributions like for example the widely popular Ubuntu distribution, -you can use pip as well and simply install Python as

-
    -
  1. sudo apt-get install python3 (or python for Python2.7)

  2. -
-

If you don’t want to perform these operations separately and venture -into the hassle of exploring how to set up dependencies and paths, we -recommend two widely used distrubutions which set up all relevant -dependencies for Python, namely

- -

which is an open source -distribution of the Python and R programming languages for large-scale -data processing, predictive analytics, and scientific computing, that -aims to simplify package management and deployment. Package versions -are managed by the package management system conda.

- -

is a Python -distribution for scientific and analytic computing distribution and -analysis environment, available for free and under a commercial -license.

-

We recommend using Anaconda if you are not too familiar with setting paths in a terminal environment.

-
-
-

3.10.2. Exercise: making your own data and exploring scikit-learn

-

We will generate our own dataset for a function \(y(x)\) where \(x \in [0,1]\) and defined by random numbers computed with the uniform distribution. The function \(y\) is a quadratic polynomial in \(x\) with added stochastic noise according to the normal distribution \(\cal {N}(0,1)\). -The following simple Python instructions define our \(x\) and \(y\) values (with 100 data points).

-
-
-
x = np.random.rand(100,1)
-y = 2.0+5*x*x+0.1*np.random.randn(100,1)
-
-
-
-
-
    -
  1. Write your own code (following the examples under the regression notes) for computing the parametrization of the data set fitting a second-order polynomial.

  2. -
  3. Use thereafter scikit-learn (see again the examples in the regression slides) and compare with your own code.

  4. -
  5. Using scikit-learn, compute also the mean square error, a risk metric corresponding to the expected value of the squared (quadratic) error defined as

  6. -
-
-\[ -MSE(\boldsymbol{y},\boldsymbol{\tilde{y}}) = \frac{1}{n} -\sum_{i=0}^{n-1}(y_i-\tilde{y}_i)^2, -\]
-

and the \(R^2\) score function. -If \(\tilde{\boldsymbol{y}}_i\) is the predicted value of the \(i-th\) sample and \(y_i\) is the corresponding true value, then the score \(R^2\) is defined as

-
-\[ -R^2(\boldsymbol{y}, \tilde{\boldsymbol{y}}) = 1 - \frac{\sum_{i=0}^{n - 1} (y_i - \tilde{y}_i)^2}{\sum_{i=0}^{n - 1} (y_i - \bar{y})^2}, -\]
-

where we have defined the mean value of \(\boldsymbol{y}\) as

-
-\[ -\bar{y} = \frac{1}{n} \sum_{i=0}^{n - 1} y_i. -\]
-

You can use the functionality included in scikit-learn. If you feel for it, you can use your own program and define functions which compute the above two functions. -Discuss the meaning of these results. Try also to vary the coefficient in front of the added stochastic noise term and discuss the quality of the fits.

-
-
-

3.10.3. Exercise: Normalizing our data

-

A much used approach before starting to train the data is to preprocess our -data. Normally the data may need a rescaling and/or may be sensitive -to extreme values. Scaling the data renders our inputs much more -suitable for the algorithms we want to employ.

-

Scikit-Learn has several functions which allow us to rescale the -data, normally resulting in much better results in terms of various -accuracy scores. The StandardScaler function in Scikit-Learn -ensures that for each feature/predictor we study the mean value is -zero and the variance is one (every column in the design/feature -matrix). This scaling has the drawback that it does not ensure that -we have a particular maximum or minimum in our data set. Another -function included in Scikit-Learn is the MinMaxScaler which -ensures that all features are exactly between \(0\) and \(1\). The

-

The Normalizer scales each data -point such that the feature vector has a euclidean length of one. In other words, it -projects a data point on the circle (or sphere in the case of higher dimensions) with a -radius of 1. This means every data point is scaled by a different number (by the -inverse of it’s length). -This normalization is often used when only the direction (or angle) of the data matters, -not the length of the feature vector.

-

The RobustScaler works similarly to the StandardScaler in that it -ensures statistical properties for each feature that guarantee that -they are on the same scale. However, the RobustScaler uses the median -and quartiles, instead of mean and variance. This makes the -RobustScaler ignore data points that are very different from the rest -(like measurement errors). These odd data points are also called -outliers, and might often lead to trouble for other scaling -techniques.

-

It also common to split the data in a training set and a testing set. A typical split is to use \(80\%\) of the data for training and the rest -for testing. This can be done as follows with our design matrix \(\boldsymbol{X}\) and data \(\boldsymbol{y}\) (remember to import scikit-learn)

-
-
-
# split in training and test data
-# X_train, X_test, y_train, y_test = train_test_split(X,y,test_size=0.2)
-
-
-
-
-

Then we can use the standard scaler to scale our data as

-
-
-
scaler = StandardScaler()
-scaler.fit(X_train)
-X_train_scaled = scaler.transform(X_train)
-X_test_scaled = scaler.transform(X_test)
-
-
-
-
-

In this exercise we want you to to compute the MSE for the training -data and the test data as function of the complexity of a polynomial, -that is the degree of a given polynomial. We want you also to compute the \(R2\) score as function of the complexity of the model for both training data and test data. You should also run the calculation with and without scaling.

-

One of -the aims is to reproduce Figure 2.11 of Hastie et al.

-

Our data is defined by \(x\in [-3,3]\) with a total of for example \(100\) data points.

-
-
-
np.random.seed()
-n = 100
-maxdegree = 14
-# Make data set.
-x = np.linspace(-3, 3, n).reshape(-1, 1)
-y = np.exp(-x**2) + 1.5 * np.exp(-(x-2)**2)+ np.random.normal(0, 0.1, x.shape)
-
-
-
-
-

where \(y\) is the function we want to fit with a given polynomial.

-

Write a first code which sets up a design matrix \(X\) defined by a -fifth-order polynomial. Scale your data and split it in training and -test data.

-

Perform an ordinary least squares and compute the means squared error -and the \(R2\) factor for the training data and the test data, with and -without scaling.

-

Add now a model which allows you to make polynomials up to degree -\(15\). Perform a standard OLS fitting of the training data and compute -the MSE and \(R2\) for the training and test data and plot both test and -training data MSE and \(R2\) as functions of the polynomial -degree. Compare what you see with Figure 2.11 of Hastie et al. Comment -your results. For which polynomial degree do you find an optimal MSE -(smallest value)?

-
-
-
- - - - -
- - - - -
-
-
-
-

- - By Morten Hjorth-Jensen
- - © Copyright 2021.
-

-
-
-
- - -
-
- - - - - - \ No newline at end of file diff --git a/doc/LectureNotes/_build/html/chapter10.html b/doc/LectureNotes/_build/html/chapter10.html deleted file mode 100644 index bb89f5b0e..000000000 --- a/doc/LectureNotes/_build/html/chapter10.html +++ /dev/null @@ -1,2671 +0,0 @@ - - - - - - - - 14. Building a Feed Forward Neural Network — Applied Data Analysis and Machine Learning - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
- - - - - - - - -
- - -
-
- -
- -
-

14. Building a Feed Forward Neural Network

-

We are now gong to develop an example based on the MNIST data -base. This is a classification problem and we need to use our -cross-entropy function we discussed in connection with logistic -regression. The cross-entropy defines our cost function for the -classificaton problems with neural networks.

-

In binary classification with two classes \((0, 1)\) we define the -logistic/sigmoid function as the probability that a particular input -is in class \(0\) or \(1\). This is possible because the logistic -function takes any input from the real numbers and inputs a number -between 0 and 1, and can therefore be interpreted as a probability. It -also has other nice properties, such as a derivative that is simple to -calculate.

-

For an input \(\boldsymbol{a}\) from the hidden layer, the probability that the input \(\boldsymbol{x}\) -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\) -represents our activation values \(z\). We have

-
-\[ -P(y = 0 \mid \hat{x}, \hat{\theta}) = \frac{1}{1 + \exp{(- \hat{x}})} , -\]
-

and

-
-\[ -P(y = 1 \mid \hat{x}, \hat{\theta}) = 1 - P(y = 0 \mid \hat{x}, \hat{\theta}) , -\]
-

where \(y \in \{0, 1\}\) and \(\hat{\theta}\) represents the weights and biases -of our network.

-
-

14.1. Defining the cost function

-

Our cost function is given as (see the Logistic regression lectures)

-
-\[ -\mathcal{C}(\hat{\theta}) = - \ln P(\mathcal{D} \mid \hat{\theta}) = - \sum_{i=1}^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}) . -\]
-

This last equality means that we can interpret our cost function as a sum over the loss function -for each point in the dataset \(\mathcal{L}_i(\hat{\theta})\).
-The negative sign is just so that we can think about our algorithm as minimizing a positive number, rather -than maximizing a negative number.

-

In multiclass classification it is common to treat each integer label as a so called one-hot vector:

-

\(y = 5 \quad \rightarrow \quad \hat{y} = (0, 0, 0, 0, 0, 1, 0, 0, 0, 0) ,\) and

-

\(y = 1 \quad \rightarrow \quad \hat{y} = (0, 1, 0, 0, 0, 0, 0, 0, 0, 0) ,\)

-

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\))..

-

If \(\hat{x}_i\) is the \(i\)-th input (image), \(y_{ic}\) refers to the \(c\)-th component of the \(i\)-th -output vector \(\hat{y}_i\).
-The probability of \(\hat{x}_i\) being in class \(c\) will be given by the softmax function:

-
-\[ -P(y_{ic} = 1 \mid \hat{x}_i, \hat{\theta}) = \frac{\exp{((\hat{a}_i^{hidden})^T \hat{w}_c)}} -{\sum_{c'=0}^{C-1} \exp{((\hat{a}_i^{hidden})^T \hat{w}_{c'})}} , -\]
-

which reduces to the logistic function in the binary case.
-The likelihood of this \(C\)-class classifier -is now given as:

-
-\[ -P(\mathcal{D} \mid \hat{\theta}) = \prod_{i=1}^n \prod_{c=0}^{C-1} [P(y_{ic} = 1)]^{y_{ic}} . -\]
-

Again we take the negative log-likelihood to define our cost function:

-
-\[ -\mathcal{C}(\hat{\theta}) = - \log{P(\mathcal{D} \mid \hat{\theta})}. -\]
-

See the logistic regression lectures for a full definition of the cost function.

-

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!

-
-

14.1.1. Example: binary classification problem

-

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

-
-\[ -\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), -\]
-

where we had defined the logistic (sigmoid) function

-
-\[ -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)}}, -\]
-

and

-
-\[ -p(y_i =0\vert x_i,\hat{\beta})=1-p(y_i =1\vert x_i,\hat{\beta}). -\]
-

The parameters \(\hat{\beta}\) were defined using a minimization method like gradient descent or Newton-Raphson’s method.

-

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\). -We have then

-
-\[ -a_i^l = y_i = \frac{\exp{(z_i^l)}}{1+\exp{(z_i^l)}}, -\]
-

with

-
-\[ -z_i^l = \sum_{j}w_{ij}^l a_j^{l-1}+b_i^l, -\]
-

where the superscript \(l-1\) indicates that these are the outputs from layer \(l-1\). -Our cost function at the final layer \(l=L\) is now

-
-\[ -\mathcal{C}(\hat{W}) = - \sum_{i=1}^n \left(t_i\log{a_i^L}+(1-t_i)\log{(1-a_i^L)}\right), -\]
-

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

-
-\[ -\frac{\partial \mathcal{C}(\hat{W})}{\partial a_i^L} = \frac{a_i^L-t_i}{a_i^L(1-a_i^L)}. -\]
-

In case we use another activation function than the logistic one, we need to evaluate other derivatives.

-
-
-

14.1.2. The Softmax function

-

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

-
-\[ -\frac{\partial f(z_i^l)}{\partial w_{jk}^l} = -\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}. -\]
-

For the Softmax function we have

-
-\[ -f(z_i^l) = \frac{\exp{(z_i^l)}}{\sum_{m=1}^K\exp{(z_m^l)}}. -\]
-

Its derivative with respect to \(z_j^l\) gives

-
-\[ -\frac{\partial f(z_i^l)}{\partial z_j^l}= f(z_i^l)\left(\delta_{ij}-f(z_j^l)\right), -\]
-

which in case of the simply binary model reduces to having \(i=j\).

-
-
-
-

14.2. Developing a code for doing neural networks with back propagation

-

One can identify a set of key steps when using neural networks to solve supervised learning problems:

-
    -
  1. Collect and pre-process data

  2. -
  3. Define model and architecture

  4. -
  5. Choose cost function and optimizer

  6. -
  7. Train the model

  8. -
  9. Evaluate model performance on test data

  10. -
  11. Adjust hyperparameters (if necessary, network architecture)

  12. -
-
-

14.2.1. Collect and pre-process data

-

Here we will be using the MNIST dataset, which is readily available through the scikit-learn -package. You may also find it for example here.
-The MNIST (Modified National Institute of Standards and Technology) database is a large database -of handwritten digits that is commonly used for training various image processing systems.
-The MNIST dataset consists of 70 000 images of size \(28\times 28\) pixels, each labeled from 0 to 9.
-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.

-

To feed data into a feed-forward neural network we need to represent -the inputs as a design/feature matrix \(X = (n_{inputs}, n_{features})\). Each -row represents an input, in this case a handwritten digit, and -each column represents a feature, in this case a pixel. The -correct answers, also known as labels or targets are -represented as a 1D array of integers -\(Y = (n_{inputs}) = (5, 3, 1, 8,...)\).

-

As an example, say we want to build a neural network using supervised learning to predict Body-Mass Index (BMI) from -measurements of height (in m)
-and weight (in kg). If we have measurements of 5 people the design/feature matrix could be for example:

-
-\[\begin{split} X = \begin{bmatrix} -1.85 & 81\\ -1.71 & 65\\ -1.95 & 103\\ -1.55 & 42\\ -1.63 & 56 -\end{bmatrix} ,\end{split}\]
-

and the targets would be:

-
-\[ Y = (23.7, 22.2, 27.1, 17.5, 21.1) \]
-

Since each input image is a 2D matrix, we need to flatten the image -(i.e. “unravel” the 2D matrix into a 1D array) to turn the data into a -design/feature matrix. This means we lose all spatial information in the -image, such as locality and translational invariance. More complicated -architectures such as Convolutional Neural Networks can take advantage -of such information, and are most commonly applied when analyzing -images.

-
-
-
%matplotlib inline
-
-# import necessary packages
-import numpy as np
-import matplotlib.pyplot as plt
-from sklearn import datasets
-
-
-# ensure the same random numbers appear every time
-np.random.seed(0)
-
-# display images in notebook
-%matplotlib inline
-plt.rcParams['figure.figsize'] = (12,12)
-
-
-# download MNIST dataset
-digits = datasets.load_digits()
-
-# define inputs and labels
-inputs = digits.images
-labels = digits.target
-
-print("inputs = (n_inputs, pixel_width, pixel_height) = " + str(inputs.shape))
-print("labels = (n_inputs) = " + str(labels.shape))
-
-
-# flatten the image
-# the value -1 means dimension is inferred from the remaining dimensions: 8x8 = 64
-n_inputs = len(inputs)
-inputs = inputs.reshape(n_inputs, -1)
-print("X = (n_inputs, n_features) = " + str(inputs.shape))
-
-
-# choose some random images to display
-indices = np.arange(n_inputs)
-random_indices = np.random.choice(indices, size=5)
-
-for i, image in enumerate(digits.images[random_indices]):
-    plt.subplot(1, 5, i+1)
-    plt.axis('off')
-    plt.imshow(image, cmap=plt.cm.gray_r, interpolation='nearest')
-    plt.title("Label: %d" % digits.target[random_indices[i]])
-plt.show()
-
-
-
-
-
inputs = (n_inputs, pixel_width, pixel_height) = (1797, 8, 8)
-labels = (n_inputs) = (1797,)
-X = (n_inputs, n_features) = (1797, 64)
-
-
-_images/chapter10_33_1.png -
-
-
-
-

14.2.2. Train and test datasets

-

Performing analysis before partitioning the dataset is a major error, that can lead to incorrect conclusions.

-

We will reserve \(80 \%\) of our dataset for training and \(20 \%\) for testing.

-

It is important that the train and test datasets are drawn randomly from our dataset, to ensure -no bias in the sampling.
-Say you are taking measurements of weather data to predict the weather in the coming 5 days. -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 -collected from 12.00 to 24.00.

-
-
-
from sklearn.model_selection import train_test_split
-
-# one-liner from scikit-learn library
-train_size = 0.8
-test_size = 1 - train_size
-X_train, X_test, Y_train, Y_test = train_test_split(inputs, labels, train_size=train_size,
-                                                    test_size=test_size)
-
-# equivalently in numpy
-def train_test_split_numpy(inputs, labels, train_size, test_size):
-    n_inputs = len(inputs)
-    inputs_shuffled = inputs.copy()
-    labels_shuffled = labels.copy()
-    
-    np.random.shuffle(inputs_shuffled)
-    np.random.shuffle(labels_shuffled)
-    
-    train_end = int(n_inputs*train_size)
-    X_train, X_test = inputs_shuffled[:train_end], inputs_shuffled[train_end:]
-    Y_train, Y_test = labels_shuffled[:train_end], labels_shuffled[train_end:]
-    
-    return X_train, X_test, Y_train, Y_test
-
-#X_train, X_test, Y_train, Y_test = train_test_split_numpy(inputs, labels, train_size, test_size)
-
-print("Number of training images: " + str(len(X_train)))
-print("Number of test images: " + str(len(X_test)))
-
-
-
-
-
Number of training images: 1437
-Number of test images: 360
-
-
-
-
-
-
-

14.2.3. Define model and architecture

-

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

-
-\[ z = \sum_{i=1}^n w_i a_i ,\]
-
-\[ y = f(z) ,\]
-

where \(f\) is the activation function, \(a_i\) represents input from neuron \(i\) in the preceding layer -and \(w_i\) is the weight to input \(i\).
-The activation of the neurons in the input layer is just the features (e.g. a pixel value).

-

The simplest activation function for a neuron is the Heaviside function:

-
-\[\begin{split} f(z) = -\begin{cases} -1, & z > 0\\ -0, & \text{otherwise} -\end{cases} -\end{split}\]
-

A feed-forward neural network with this activation is known as a perceptron.
-For a binary classifier (i.e. two classes, 0 or 1, dog or not-dog) we can also use this in our output layer.
-This activation can be generalized to \(k\) classes (using e.g. the one-against-all strategy), -and we call these architectures multiclass perceptrons.

-

However, it is now common to use the terms Single Layer Perceptron (SLP) (1 hidden layer) and
-Multilayer Perceptron (MLP) (2 or more hidden layers) to refer to feed-forward neural networks with any activation function.

-

Typical choices for activation functions include the sigmoid function, hyperbolic tangent, and Rectified Linear Unit (ReLU).
-We will be using the sigmoid function \(\sigma(x)\):

-
-\[ f(x) = \sigma(x) = \frac{1}{1 + e^{-x}} ,\]
-

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.

-
-
-

14.2.4. Layers

-
    -
  • Input

  • -
-

Since each input image has 8x8 = 64 pixels or features, we have an input layer of 64 neurons.

-
    -
  • Hidden layer

  • -
-

We will use 50 neurons in the hidden layer receiving input from the neurons in the input layer.
-Since each neuron in the hidden layer is connected to the 64 inputs we have 64x50 = 3200 weights to the hidden layer.

-
    -
  • Output

  • -
-

If we were building a binary classifier, it would be sufficient with a single neuron in the output layer, -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.

-

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.

-

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:

-
-\[ P(\text{class $j$} \mid \text{input $\hat{a}$}) = \frac{\exp{(\hat{a}^T \hat{w}_j)}} -{\sum_{c=0}^{9} \exp{(\hat{a}^T \hat{w}_c)}} ,\]
-

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.
-The denominator is a normalization factor to ensure the outputs (probabilities) sum up to 1.
-The exponent is just the weighted sum of inputs as before:

-
-\[ z_j = \sum_{i=1}^n w_ {ij} a_i+b_j.\]
-

Since each neuron in the output layer is connected to the 50 inputs from the hidden layer we have 50x10 = 500 -weights to the output layer.

-

Typically weights are initialized with small values distributed around zero, drawn from a uniform -or normal distribution. Setting all weights to zero means all neurons give the same output, making the network useless.

-

Adding a bias value to the weighted sum of inputs allows the neural network to represent a greater range -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\):

-
-\[ z_j = \sum_{i=1}^n w_ {ij} a_i + b_j.\]
-

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.

-
-
-
# building our neural network
-
-n_inputs, n_features = X_train.shape
-n_hidden_neurons = 50
-n_categories = 10
-
-# we make the weights normally distributed using numpy.random.randn
-
-# weights and bias in the hidden layer
-hidden_weights = np.random.randn(n_features, n_hidden_neurons)
-hidden_bias = np.zeros(n_hidden_neurons) + 0.01
-
-# weights and bias in the output layer
-output_weights = np.random.randn(n_hidden_neurons, n_categories)
-output_bias = np.zeros(n_categories) + 0.01
-
-
-
-
-
-
-

14.2.5. Feed-forward pass

-

Denote \(F\) the number of features, \(H\) the number of hidden neurons and \(C\) the number of categories.
-For each input image we calculate a weighted sum of input features (pixel values) to each neuron \(j\) in the hidden layer \(l\):

-
-\[ z_{j}^{l} = \sum_{i=1}^{F} w_{ij}^{l} x_i + b_{j}^{l},\]
-

this is then passed through our activation function

-
-\[ a_{j}^{l} = f(z_{j}^{l}) .\]
-

We calculate a weighted sum of inputs (activations in the hidden layer) to each neuron \(j\) in the output layer:

-
-\[ z_{j}^{L} = \sum_{i=1}^{H} w_{ij}^{L} a_{i}^{l} + b_{j}^{L}.\]
-

Finally we calculate the output of neuron \(j\) in the output layer using the softmax function:

-
-\[ a_{j}^{L} = \frac{\exp{(z_j^{L})}} -{\sum_{c=0}^{C-1} \exp{(z_c^{L})}} .\]
-

Since our data has the dimensions \(X = (n_{inputs}, n_{features})\) and our weights to the hidden -layer have the dimensions
-\(W_{hidden} = (n_{features}, n_{hidden})\), -we can easily feed the network all our training data in one go by taking the matrix product

-
-\[ X W^{h} = (n_{inputs}, n_{hidden}),\]
-

and obtain a matrix that holds the weighted sum of inputs to the hidden layer -for each input image and each hidden neuron.
-We also add the bias to obtain a matrix of weighted sums to the hidden layer \(Z^{h}\):

-
-\[ \hat{z}^{l} = \hat{X} \hat{W}^{l} + \hat{b}^{l} ,\]
-

meaning the same bias (1D array with size equal number of hidden neurons) is added to each input image.
-This is then passed through the activation:

-
-\[ \hat{a}^{l} = f(\hat{z}^l) .\]
-

This is fed to the output layer:

-
-\[ \hat{z}^{L} = \hat{a}^{L} \hat{W}^{L} + \hat{b}^{L} .\]
-

Finally we receive our output values for each image and each category by passing it through the softmax function:

-
-\[ output = softmax (\hat{z}^{L}) = (n_{inputs}, n_{categories}) .\]
-
-
-
# setup the feed-forward pass, subscript h = hidden layer
-
-def sigmoid(x):
-    return 1/(1 + np.exp(-x))
-
-def feed_forward(X):
-    # weighted sum of inputs to the hidden layer
-    z_h = np.matmul(X, hidden_weights) + hidden_bias
-    # activation in the hidden layer
-    a_h = sigmoid(z_h)
-    
-    # weighted sum of inputs to the output layer
-    z_o = np.matmul(a_h, output_weights) + output_bias
-    # softmax output
-    # axis 0 holds each input and axis 1 the probabilities of each category
-    exp_term = np.exp(z_o)
-    probabilities = exp_term / np.sum(exp_term, axis=1, keepdims=True)
-    
-    return probabilities
-
-probabilities = feed_forward(X_train)
-print("probabilities = (n_inputs, n_categories) = " + str(probabilities.shape))
-print("probability that image 0 is in category 0,1,2,...,9 = \n" + str(probabilities[0]))
-print("probabilities sum up to: " + str(probabilities[0].sum()))
-print()
-
-# we obtain a prediction by taking the class with the highest likelihood
-def predict(X):
-    probabilities = feed_forward(X)
-    return np.argmax(probabilities, axis=1)
-
-predictions = predict(X_train)
-print("predictions = (n_inputs) = " + str(predictions.shape))
-print("prediction for image 0: " + str(predictions[0]))
-print("correct label for image 0: " + str(Y_train[0]))
-
-
-
-
-
probabilities = (n_inputs, n_categories) = (1437, 10)
-probability that image 0 is in category 0,1,2,...,9 = 
-[5.41511965e-04 2.17174962e-03 8.84355903e-03 1.44970586e-03
- 1.10378326e-04 5.08318298e-09 2.03256632e-04 1.92507116e-03
- 9.84443254e-01 3.11507992e-04]
-probabilities sum up to: 1.0
-
-predictions = (n_inputs) = (1437,)
-prediction for image 0: 8
-correct label for image 0: 6
-
-
-
-
-
-
-

14.2.6. Choose cost function and optimizer

-

To measure how well our neural network is doing we need to introduce a cost function.
-We will call the function that gives the error of a single sample output the loss function, and the function -that gives the total error of our network across all samples the cost function. -A typical choice for multiclass classification is the cross-entropy loss, also known as the negative log likelihood.

-

In multiclass classification it is common to treat each integer label as a so called one-hot vector:

-
-\[ y = 5 \quad \rightarrow \quad \hat{y} = (0, 0, 0, 0, 0, 1, 0, 0, 0, 0) ,\]
-
-\[ y = 1 \quad \rightarrow \quad \hat{y} = (0, 1, 0, 0, 0, 0, 0, 0, 0, 0) ,\]
-

i.e. a binary bit string of length \(C\), where \(C = 10\) is the number of classes in the MNIST dataset.

-

Let \(y_{ic}\) denote the \(c\)-th component of the \(i\)-th one-hot vector.
-We define the cost function \(\mathcal{C}\) as a sum over the cross-entropy loss for each point \(\hat{x}_i\) in the dataset.

-

In the one-hot representation only one of the terms in the loss function is non-zero, namely the -probability of the correct category \(c'\)
-(i.e. the category \(c'\) such that \(y_{ic'} = 1\)). This means that the cross entropy loss only punishes you for how wrong -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.

-
-
-

14.2.7. Optimizing the cost function

-

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 -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.
-Each parameter \(\theta\) is iteratively adjusted according to the rule

-
-\[ \theta_{i+1} = \theta_i - \eta \nabla \mathcal{C}(\theta_i) ,\]
-

where \(\eta\) is known as the learning rate, which controls how big a step we take towards the minimum.
-This update can be repeated for any number of iterations, or until we are satisfied with the result.

-

A simple and effective improvement is a variant called Batch Gradient Descent.
-Instead of calculating the gradient on the whole dataset, we calculate an approximation of the gradient -on a subset of the data called a minibatch.
-If there are \(N\) data points and we have a minibatch size of \(M\), the total number of batches -is \(N/M\).
-We denote each minibatch \(B_k\), with \(k = 1, 2,...,N/M\). The gradient then becomes:

-
-\[ \nabla \mathcal{C}(\theta) = \frac{1}{N} \sum_{i=1}^N \nabla \mathcal{L}_i(\theta) \quad \rightarrow \quad -\frac{1}{M} \sum_{i \in B_k} \nabla \mathcal{L}_i(\theta) ,\]
-

i.e. instead of averaging the loss over the entire dataset, we average over a minibatch.

-

This has two important benefits:

-
    -
  1. Introducing stochasticity decreases the chance that the algorithm becomes stuck in a local minima.

  2. -
  3. It significantly speeds up the calculation, since we do not have to use the entire dataset to calculate the gradient.

  4. -
-

The various optmization methods, with codes and algorithms, are discussed in our lectures on Gradient descent approaches.

-
-
-

14.2.8. Regularization

-

It is common to add an extra term to the cost function, proportional -to the size of the weights. This is equivalent to constraining the -size of the weights, so that they do not grow out of control. -Constraining the size of the weights means that the weights cannot -grow arbitrarily large to fit the training data, and in this way -reduces overfitting.

-

We will measure the size of the weights using the so called L2-norm, meaning our cost function becomes:

-
-\[ \mathcal{C}(\theta) = \frac{1}{N} \sum_{i=1}^N \mathcal{L}_i(\theta) \quad \rightarrow \quad -\frac{1}{N} \sum_{i=1}^N \mathcal{L}_i(\theta) + \lambda \lvert \lvert \hat{w} \rvert \rvert_2^2 -= \frac{1}{N} \sum_{i=1}^N \mathcal{L}(\theta) + \lambda \sum_{ij} w_{ij}^2,\]
-

i.e. we sum up all the weights squared. The factor \(\lambda\) is known as a regularization parameter.

-

In order to train the model, we need to calculate the derivative of -the cost function with respect to every bias and weight in the -network. In total our network has \((64 + 1)\times 50=3250\) weights in -the hidden layer and \((50 + 1)\times 10=510\) weights to the output -layer (\(+1\) for the bias), and the gradient must be calculated for -every parameter. We use the backpropagation algorithm discussed -above. This is a clever use of the chain rule that allows us to -calculate the gradient efficently.

-
-
-

14.2.9. Matrix multiplication

-

To more efficently train our network these equations are implemented using matrix operations.
-The error in the output layer is calculated simply as, with \(\hat{t}\) being our targets,

-
-\[ \delta_L = \hat{t} - \hat{y} = (n_{inputs}, n_{categories}) .\]
-

The gradient for the output weights is calculated as

-
-\[ \nabla W_{L} = \hat{a}^T \delta_L = (n_{hidden}, n_{categories}) ,\]
-

where \(\hat{a} = (n_{inputs}, n_{hidden})\). This simply means that we are summing up the gradients for each input.
-Since we are going backwards we have to transpose the activation matrix.

-

The gradient with respect to the output bias is then

-
-\[ \nabla \hat{b}_{L} = \sum_{i=1}^{n_{inputs}} \delta_L = (n_{categories}) .\]
-

The error in the hidden layer is

-
-\[ \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}) ,\]
-

where \(f'(a_{h})\) is the derivative of the activation in the hidden layer. The matrix products mean -that we are summing up the products for each neuron in the output layer. The symbol \(\circ\) denotes -the Hadamard product, meaning element-wise multiplication.

-

This again gives us the gradients in the hidden layer:

-
-\[ \nabla W_{h} = X^T \delta_h = (n_{features}, n_{hidden}) ,\]
-
-\[ \nabla b_{h} = \sum_{i=1}^{n_{inputs}} \delta_h = (n_{hidden}) .\]
-
-
-
# to categorical turns our integer vector into a onehot representation
-from sklearn.metrics import accuracy_score
-
-# one-hot in numpy
-def to_categorical_numpy(integer_vector):
-    n_inputs = len(integer_vector)
-    n_categories = np.max(integer_vector) + 1
-    onehot_vector = np.zeros((n_inputs, n_categories))
-    onehot_vector[range(n_inputs), integer_vector] = 1
-    
-    return onehot_vector
-
-#Y_train_onehot, Y_test_onehot = to_categorical(Y_train), to_categorical(Y_test)
-Y_train_onehot, Y_test_onehot = to_categorical_numpy(Y_train), to_categorical_numpy(Y_test)
-
-def feed_forward_train(X):
-    # weighted sum of inputs to the hidden layer
-    z_h = np.matmul(X, hidden_weights) + hidden_bias
-    # activation in the hidden layer
-    a_h = sigmoid(z_h)
-    
-    # weighted sum of inputs to the output layer
-    z_o = np.matmul(a_h, output_weights) + output_bias
-    # softmax output
-    # axis 0 holds each input and axis 1 the probabilities of each category
-    exp_term = np.exp(z_o)
-    probabilities = exp_term / np.sum(exp_term, axis=1, keepdims=True)
-    
-    # for backpropagation need activations in hidden and output layers
-    return a_h, probabilities
-
-def backpropagation(X, Y):
-    a_h, probabilities = feed_forward_train(X)
-    
-    # error in the output layer
-    error_output = probabilities - Y
-    # error in the hidden layer
-    error_hidden = np.matmul(error_output, output_weights.T) * a_h * (1 - a_h)
-    
-    # gradients for the output layer
-    output_weights_gradient = np.matmul(a_h.T, error_output)
-    output_bias_gradient = np.sum(error_output, axis=0)
-    
-    # gradient for the hidden layer
-    hidden_weights_gradient = np.matmul(X.T, error_hidden)
-    hidden_bias_gradient = np.sum(error_hidden, axis=0)
-
-    return output_weights_gradient, output_bias_gradient, hidden_weights_gradient, hidden_bias_gradient
-
-print("Old accuracy on training data: " + str(accuracy_score(predict(X_train), Y_train)))
-
-eta = 0.01
-lmbd = 0.01
-for i in range(1000):
-    # calculate gradients
-    dWo, dBo, dWh, dBh = backpropagation(X_train, Y_train_onehot)
-    
-    # regularization term gradients
-    dWo += lmbd * output_weights
-    dWh += lmbd * hidden_weights
-    
-    # update weights and biases
-    output_weights -= eta * dWo
-    output_bias -= eta * dBo
-    hidden_weights -= eta * dWh
-    hidden_bias -= eta * dBh
-
-print("New accuracy on training data: " + str(accuracy_score(predict(X_train), Y_train)))
-
-
-
-
-
Old accuracy on training data: 0.1440501043841336
-
-
-
<ipython-input-4-16b8e3cda33a>:4: RuntimeWarning: overflow encountered in exp
-  return 1/(1 + np.exp(-x))
-
-
-
New accuracy on training data: 0.1022964509394572
-
-
-
-
-
-
-
-

14.3. Improving performance

-

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.
-In order to obtain a network that does something useful, we will have to do a bit more work.

-

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}\).

-

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 -going through the entire dataset (\(n/M\) batches) an epoch.

-

If this does not improve network performance, you may want to consider altering the network architecture, adding more neurons or hidden layers.
-Andrew Ng goes through some of these considerations in this video. You can find a summary of the video here.

-

It is very natural to think of the network as an object, with specific instances of the network -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.

-
-
-
class NeuralNetwork:
-    def __init__(
-            self,
-            X_data,
-            Y_data,
-            n_hidden_neurons=50,
-            n_categories=10,
-            epochs=10,
-            batch_size=100,
-            eta=0.1,
-            lmbd=0.0):
-
-        self.X_data_full = X_data
-        self.Y_data_full = Y_data
-
-        self.n_inputs = X_data.shape[0]
-        self.n_features = X_data.shape[1]
-        self.n_hidden_neurons = n_hidden_neurons
-        self.n_categories = n_categories
-
-        self.epochs = epochs
-        self.batch_size = batch_size
-        self.iterations = self.n_inputs // self.batch_size
-        self.eta = eta
-        self.lmbd = lmbd
-
-        self.create_biases_and_weights()
-
-    def create_biases_and_weights(self):
-        self.hidden_weights = np.random.randn(self.n_features, self.n_hidden_neurons)
-        self.hidden_bias = np.zeros(self.n_hidden_neurons) + 0.01
-
-        self.output_weights = np.random.randn(self.n_hidden_neurons, self.n_categories)
-        self.output_bias = np.zeros(self.n_categories) + 0.01
-
-    def feed_forward(self):
-        # feed-forward for training
-        self.z_h = np.matmul(self.X_data, self.hidden_weights) + self.hidden_bias
-        self.a_h = sigmoid(self.z_h)
-
-        self.z_o = np.matmul(self.a_h, self.output_weights) + self.output_bias
-
-        exp_term = np.exp(self.z_o)
-        self.probabilities = exp_term / np.sum(exp_term, axis=1, keepdims=True)
-
-    def feed_forward_out(self, X):
-        # feed-forward for output
-        z_h = np.matmul(X, self.hidden_weights) + self.hidden_bias
-        a_h = sigmoid(z_h)
-
-        z_o = np.matmul(a_h, self.output_weights) + self.output_bias
-        
-        exp_term = np.exp(z_o)
-        probabilities = exp_term / np.sum(exp_term, axis=1, keepdims=True)
-        return probabilities
-
-    def backpropagation(self):
-        error_output = self.probabilities - self.Y_data
-        error_hidden = np.matmul(error_output, self.output_weights.T) * self.a_h * (1 - self.a_h)
-
-        self.output_weights_gradient = np.matmul(self.a_h.T, error_output)
-        self.output_bias_gradient = np.sum(error_output, axis=0)
-
-        self.hidden_weights_gradient = np.matmul(self.X_data.T, error_hidden)
-        self.hidden_bias_gradient = np.sum(error_hidden, axis=0)
-
-        if self.lmbd > 0.0:
-            self.output_weights_gradient += self.lmbd * self.output_weights
-            self.hidden_weights_gradient += self.lmbd * self.hidden_weights
-
-        self.output_weights -= self.eta * self.output_weights_gradient
-        self.output_bias -= self.eta * self.output_bias_gradient
-        self.hidden_weights -= self.eta * self.hidden_weights_gradient
-        self.hidden_bias -= self.eta * self.hidden_bias_gradient
-
-    def predict(self, X):
-        probabilities = self.feed_forward_out(X)
-        return np.argmax(probabilities, axis=1)
-
-    def predict_probabilities(self, X):
-        probabilities = self.feed_forward_out(X)
-        return probabilities
-
-    def train(self):
-        data_indices = np.arange(self.n_inputs)
-
-        for i in range(self.epochs):
-            for j in range(self.iterations):
-                # pick datapoints with replacement
-                chosen_datapoints = np.random.choice(
-                    data_indices, size=self.batch_size, replace=False
-                )
-
-                # minibatch training data
-                self.X_data = self.X_data_full[chosen_datapoints]
-                self.Y_data = self.Y_data_full[chosen_datapoints]
-
-                self.feed_forward()
-                self.backpropagation()
-
-
-
-
-
-
-

14.4. Evaluate model performance on test data

-

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.
-We measure the performance of the network using the accuracy score.
-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\).

-
-\[ \text{Accuracy} = \frac{\sum_{i=1}^n I(\hat{y}_i = y_i)}{n} ,\]
-

where \(I\) is the indicator function, \(1\) if \(\hat{y}_i = y_i\) and \(0\) otherwise.

-
-
-
epochs = 100
-batch_size = 100
-
-dnn = NeuralNetwork(X_train, Y_train_onehot, eta=eta, lmbd=lmbd, epochs=epochs, batch_size=batch_size,
-                    n_hidden_neurons=n_hidden_neurons, n_categories=n_categories)
-dnn.train()
-test_predict = dnn.predict(X_test)
-
-# accuracy score from scikit library
-print("Accuracy score on test set: ", accuracy_score(Y_test, test_predict))
-
-# equivalent in numpy
-def accuracy_score_numpy(Y_test, Y_pred):
-    return np.sum(Y_test == Y_pred) / len(Y_test)
-
-#print("Accuracy score on test set: ", accuracy_score_numpy(Y_test, test_predict))
-
-
-
-
-
Accuracy score on test set:  0.9361111111111111
-
-
-
-
-
-
-

14.5. Adjust hyperparameters

-

We now perform a grid search to find the optimal hyperparameters for the network.
-Note that we are only using 1 layer with 50 neurons, and human performance is estimated to be around \(98\%\) (\(2\%\) error rate).

-
-
-
eta_vals = np.logspace(-5, 1, 7)
-lmbd_vals = np.logspace(-5, 1, 7)
-# store the models for later use
-DNN_numpy = np.zeros((len(eta_vals), len(lmbd_vals)), dtype=object)
-
-# grid search
-for i, eta in enumerate(eta_vals):
-    for j, lmbd in enumerate(lmbd_vals):
-        dnn = NeuralNetwork(X_train, Y_train_onehot, eta=eta, lmbd=lmbd, epochs=epochs, batch_size=batch_size,
-                            n_hidden_neurons=n_hidden_neurons, n_categories=n_categories)
-        dnn.train()
-        
-        DNN_numpy[i][j] = dnn
-        
-        test_predict = dnn.predict(X_test)
-        
-        print("Learning rate  = ", eta)
-        print("Lambda = ", lmbd)
-        print("Accuracy score on test set: ", accuracy_score(Y_test, test_predict))
-        print()
-
-
-
-
-
Learning rate  =  1e-05
-Lambda =  1e-05
-Accuracy score on test set:  0.11666666666666667
-
-
-
Learning rate  =  1e-05
-Lambda =  0.0001
-Accuracy score on test set:  0.20833333333333334
-
-
-
Learning rate  =  1e-05
-Lambda =  0.001
-Accuracy score on test set:  0.12222222222222222
-
-
-
Learning rate  =  1e-05
-Lambda =  0.01
-Accuracy score on test set:  0.14722222222222223
-
-
-
Learning rate  =  1e-05
-Lambda =  0.1
-Accuracy score on test set:  0.17777777777777778
-
-
-
Learning rate  =  1e-05
-Lambda =  1.0
-Accuracy score on test set:  0.16111111111111112
-
-
-
Learning rate  =  1e-05
-Lambda =  10.0
-Accuracy score on test set:  0.20277777777777778
-
-
-
Learning rate  =  0.0001
-Lambda =  1e-05
-Accuracy score on test set:  0.5305555555555556
-
-
-
Learning rate  =  0.0001
-Lambda =  0.0001
-Accuracy score on test set:  0.5944444444444444
-
-
-
Learning rate  =  0.0001
-Lambda =  0.001
-Accuracy score on test set:  0.5888888888888889
-
-
-
Learning rate  =  0.0001
-Lambda =  0.01
-Accuracy score on test set:  0.6111111111111112
-
-
-
Learning rate  =  0.0001
-Lambda =  0.1
-Accuracy score on test set:  0.5222222222222223
-
-
-
Learning rate  =  0.0001
-Lambda =  1.0
-Accuracy score on test set:  0.5555555555555556
-
-
-
Learning rate  =  0.0001
-Lambda =  10.0
-Accuracy score on test set:  0.8055555555555556
-
-
-
Learning rate  =  0.001
-Lambda =  1e-05
-Accuracy score on test set:  0.85
-
-
-
Learning rate  =  0.001
-Lambda =  0.0001
-Accuracy score on test set:  0.85
-
-
-
Learning rate  =  0.001
-Lambda =  0.001
-Accuracy score on test set:  0.875
-
-
-
Learning rate  =  0.001
-Lambda =  0.01
-Accuracy score on test set:  0.8666666666666667
-
-
-
Learning rate  =  0.001
-Lambda =  0.1
-Accuracy score on test set:  0.8638888888888889
-
-
-
Learning rate  =  0.001
-Lambda =  1.0
-Accuracy score on test set:  0.9555555555555556
-
-
-
Learning rate  =  0.001
-Lambda =  10.0
-Accuracy score on test set:  0.925
-
-
-
Learning rate  =  0.01
-Lambda =  1e-05
-Accuracy score on test set:  0.9583333333333334
-
-
-
Learning rate  =  0.01
-Lambda =  0.0001
-Accuracy score on test set:  0.9277777777777778
-
-
-
Learning rate  =  0.01
-Lambda =  0.001
-Accuracy score on test set:  0.9388888888888889
-
-
-
Learning rate  =  0.01
-Lambda =  0.01
-Accuracy score on test set:  0.9166666666666666
-
-
-
Learning rate  =  0.01
-Lambda =  0.1
-Accuracy score on test set:  0.9611111111111111
-
-
-
Learning rate  =  0.01
-Lambda =  1.0
-Accuracy score on test set:  0.8777777777777778
-
-
-
Learning rate  =  0.01
-Lambda =  10.0
-Accuracy score on test set:  0.11388888888888889
-
-
-
<ipython-input-4-16b8e3cda33a>:4: RuntimeWarning: overflow encountered in exp
-  return 1/(1 + np.exp(-x))
-
-
-
Learning rate  =  0.1
-Lambda =  1e-05
-Accuracy score on test set:  0.09166666666666666
-
-
-
Learning rate  =  0.1
-Lambda =  0.0001
-Accuracy score on test set:  0.10555555555555556
-
-
-
Learning rate  =  0.1
-Lambda =  0.001
-Accuracy score on test set:  0.08888888888888889
-
-
-
Learning rate  =  0.1
-Lambda =  0.01
-Accuracy score on test set:  0.10555555555555556
-
-
-
Learning rate  =  0.1
-Lambda =  0.1
-Accuracy score on test set:  0.11666666666666667
-
-
-
Learning rate  =  0.1
-Lambda =  1.0
-Accuracy score on test set:  0.12777777777777777
-
-
-
Learning rate  =  0.1
-Lambda =  10.0
-Accuracy score on test set:  0.09166666666666666
-
-
-
<ipython-input-6-2572e3a4b38d>:43: RuntimeWarning: overflow encountered in exp
-  exp_term = np.exp(self.z_o)
-<ipython-input-6-2572e3a4b38d>:44: RuntimeWarning: invalid value encountered in true_divide
-  self.probabilities = exp_term / np.sum(exp_term, axis=1, keepdims=True)
-
-
-
Learning rate  =  1.0
-Lambda =  1e-05
-Accuracy score on test set:  0.07777777777777778
-
-
-
Learning rate  =  1.0
-Lambda =  0.0001
-Accuracy score on test set:  0.07777777777777778
-
-
-
Learning rate  =  1.0
-Lambda =  0.001
-Accuracy score on test set:  0.07777777777777778
-
-
-
Learning rate  =  1.0
-Lambda =  0.01
-Accuracy score on test set:  0.07777777777777778
-
-
-
Learning rate  =  1.0
-Lambda =  0.1
-Accuracy score on test set:  0.07777777777777778
-
-
-
Learning rate  =  1.0
-Lambda =  1.0
-Accuracy score on test set:  0.08888888888888889
-
-
-
Learning rate  =  1.0
-Lambda =  10.0
-Accuracy score on test set:  0.07777777777777778
-
-
-
Learning rate  =  10.0
-Lambda =  1e-05
-Accuracy score on test set:  0.07777777777777778
-
-
-
Learning rate  =  10.0
-Lambda =  0.0001
-Accuracy score on test set:  0.07777777777777778
-
-
-
Learning rate  =  10.0
-Lambda =  0.001
-Accuracy score on test set:  0.07777777777777778
-
-
-
Learning rate  =  10.0
-Lambda =  0.01
-Accuracy score on test set:  0.07777777777777778
-
-
-
Learning rate  =  10.0
-Lambda =  0.1
-Accuracy score on test set:  0.07777777777777778
-
-
-
Learning rate  =  10.0
-Lambda =  1.0
-Accuracy score on test set:  0.07777777777777778
-
-
-
Learning rate  =  10.0
-Lambda =  10.0
-Accuracy score on test set:  0.07777777777777778
-
-
-
-
-
-
-

14.6. Visualization

-
-
-
# visual representation of grid search
-# uses seaborn heatmap, you can also do this with matplotlib imshow
-import seaborn as sns
-
-sns.set()
-
-train_accuracy = np.zeros((len(eta_vals), len(lmbd_vals)))
-test_accuracy = np.zeros((len(eta_vals), len(lmbd_vals)))
-
-for i in range(len(eta_vals)):
-    for j in range(len(lmbd_vals)):
-        dnn = DNN_numpy[i][j]
-        
-        train_pred = dnn.predict(X_train) 
-        test_pred = dnn.predict(X_test)
-
-        train_accuracy[i][j] = accuracy_score(Y_train, train_pred)
-        test_accuracy[i][j] = accuracy_score(Y_test, test_pred)
-
-        
-fig, ax = plt.subplots(figsize = (10, 10))
-sns.heatmap(train_accuracy, annot=True, ax=ax, cmap="viridis")
-ax.set_title("Training Accuracy")
-ax.set_ylabel("$\eta$")
-ax.set_xlabel("$\lambda$")
-plt.show()
-
-fig, ax = plt.subplots(figsize = (10, 10))
-sns.heatmap(test_accuracy, annot=True, ax=ax, cmap="viridis")
-ax.set_title("Test Accuracy")
-ax.set_ylabel("$\eta$")
-ax.set_xlabel("$\lambda$")
-plt.show()
-
-
-
-
-
<ipython-input-4-16b8e3cda33a>:4: RuntimeWarning: overflow encountered in exp
-  return 1/(1 + np.exp(-x))
-
-
-_images/chapter10_49_1.png -_images/chapter10_49_2.png -
-
-
-
-

14.7. scikit-learn implementation

-

scikit-learn focuses more -on traditional machine learning methods, such as regression, -clustering, decision trees, etc. As such, it has only two types of -neural networks: Multi Layer Perceptron outputting continuous values, -MPLRegressor, and Multi Layer Perceptron outputting labels, -MLPClassifier. We will see how simple it is to use these classes.

-

scikit-learn implements a few improvements from our neural network, -such as early stopping, a varying learning rate, different -optimization methods, etc. We would therefore expect a better -performance overall.

-
-
-
from sklearn.neural_network import MLPClassifier
-# store models for later use
-DNN_scikit = np.zeros((len(eta_vals), len(lmbd_vals)), dtype=object)
-
-for i, eta in enumerate(eta_vals):
-    for j, lmbd in enumerate(lmbd_vals):
-        dnn = MLPClassifier(hidden_layer_sizes=(n_hidden_neurons), activation='logistic',
-                            alpha=lmbd, learning_rate_init=eta, max_iter=epochs)
-        dnn.fit(X_train, Y_train)
-        
-        DNN_scikit[i][j] = dnn
-        
-        print("Learning rate  = ", eta)
-        print("Lambda = ", lmbd)
-        print("Accuracy score on test set: ", dnn.score(X_test, Y_test))
-        print()
-
-
-
-
-
/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.
-  warnings.warn(
-
-
-
Learning rate  =  1e-05
-Lambda =  1e-05
-Accuracy score on test set:  0.18333333333333332
-
-
-
/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.
-  warnings.warn(
-
-
-
Learning rate  =  1e-05
-Lambda =  0.0001
-Accuracy score on test set:  0.18611111111111112
-
-
-
/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.
-  warnings.warn(
-
-
-
Learning rate  =  1e-05
-Lambda =  0.001
-Accuracy score on test set:  0.13055555555555556
-
-
-
/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.
-  warnings.warn(
-
-
-
Learning rate  =  1e-05
-Lambda =  0.01
-Accuracy score on test set:  0.24444444444444444
-
-
-
/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.
-  warnings.warn(
-
-
-
Learning rate  =  1e-05
-Lambda =  0.1
-Accuracy score on test set:  0.23333333333333334
-
-
-
/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.
-  warnings.warn(
-
-
-
Learning rate  =  1e-05
-Lambda =  1.0
-Accuracy score on test set:  0.12777777777777777
-
-
-
/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.
-  warnings.warn(
-
-
-
Learning rate  =  1e-05
-Lambda =  10.0
-Accuracy score on test set:  0.1527777777777778
-
-
-
/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.
-  warnings.warn(
-
-
-
Learning rate  =  0.0001
-Lambda =  1e-05
-Accuracy score on test set:  0.9111111111111111
-
-
-
/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.
-  warnings.warn(
-
-
-
Learning rate  =  0.0001
-Lambda =  0.0001
-Accuracy score on test set:  0.8888888888888888
-
-
-
/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.
-  warnings.warn(
-
-
-
Learning rate  =  0.0001
-Lambda =  0.001
-Accuracy score on test set:  0.8722222222222222
-
-
-
/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.
-  warnings.warn(
-
-
-
Learning rate  =  0.0001
-Lambda =  0.01
-Accuracy score on test set:  0.8305555555555556
-
-
-
/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.
-  warnings.warn(
-
-
-
Learning rate  =  0.0001
-Lambda =  0.1
-Accuracy score on test set:  0.8888888888888888
-
-
-
/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.
-  warnings.warn(
-
-
-
Learning rate  =  0.0001
-Lambda =  1.0
-Accuracy score on test set:  0.8805555555555555
-
-
-
/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.
-  warnings.warn(
-
-
-
Learning rate  =  0.0001
-Lambda =  10.0
-Accuracy score on test set:  0.8944444444444445
-
-
-
/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.
-  warnings.warn(
-
-
-
Learning rate  =  0.001
-Lambda =  1e-05
-Accuracy score on test set:  0.975
-
-
-
/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.
-  warnings.warn(
-
-
-
Learning rate  =  0.001
-Lambda =  0.0001
-Accuracy score on test set:  0.9777777777777777
-
-
-
/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.
-  warnings.warn(
-
-
-
Learning rate  =  0.001
-Lambda =  0.001
-Accuracy score on test set:  0.9805555555555555
-
-
-
/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.
-  warnings.warn(
-
-
-
Learning rate  =  0.001
-Lambda =  0.01
-Accuracy score on test set:  0.9861111111111112
-
-
-
/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.
-  warnings.warn(
-
-
-
Learning rate  =  0.001
-Lambda =  0.1
-Accuracy score on test set:  0.9805555555555555
-
-
-
/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.
-  warnings.warn(
-
-
-
Learning rate  =  0.001
-Lambda =  1.0
-Accuracy score on test set:  0.9777777777777777
-
-
-
/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.
-  warnings.warn(
-
-
-
Learning rate  =  0.001
-Lambda =  10.0
-Accuracy score on test set:  0.9444444444444444
-
-
-
/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.
-  warnings.warn(
-
-
-
Learning rate  =  0.01
-Lambda =  1e-05
-Accuracy score on test set:  0.9861111111111112
-
-
-
Learning rate  =  0.01
-Lambda =  0.0001
-Accuracy score on test set:  0.9888888888888889
-
-
-
Learning rate  =  0.01
-Lambda =  0.001
-Accuracy score on test set:  0.9888888888888889
-
-
-
Learning rate  =  0.01
-Lambda =  0.01
-Accuracy score on test set:  0.9861111111111112
-
-
-
Learning rate  =  0.01
-Lambda =  0.1
-Accuracy score on test set:  0.9888888888888889
-
-
-
Learning rate  =  0.01
-Lambda =  1.0
-Accuracy score on test set:  0.9722222222222222
-
-Learning rate  =  0.01
-Lambda =  10.0
-Accuracy score on test set:  0.9527777777777777
-
-
-
Learning rate  =  0.1
-Lambda =  1e-05
-Accuracy score on test set:  0.9111111111111111
-
-
-
Learning rate  =  0.1
-Lambda =  0.0001
-Accuracy score on test set:  0.9222222222222223
-
-Learning rate  =  0.1
-Lambda =  0.001
-Accuracy score on test set:  0.9111111111111111
-
-
-
Learning rate  =  0.1
-Lambda =  0.01
-Accuracy score on test set:  0.9305555555555556
-
-Learning rate  =  0.1
-Lambda =  0.1
-Accuracy score on test set:  0.8388888888888889
-
-
-
Learning rate  =  0.1
-Lambda =  1.0
-Accuracy score on test set:  0.9055555555555556
-
-
-
Learning rate  =  0.1
-Lambda =  10.0
-Accuracy score on test set:  0.8666666666666667
-
-Learning rate  =  1.0
-Lambda =  1e-05
-Accuracy score on test set:  0.09166666666666666
-
-
-
Learning rate  =  1.0
-Lambda =  0.0001
-Accuracy score on test set:  0.11944444444444445
-
-Learning rate  =  1.0
-Lambda =  0.001
-Accuracy score on test set:  0.1361111111111111
-
-
-
Learning rate  =  1.0
-Lambda =  0.01
-Accuracy score on test set:  0.1527777777777778
-
-Learning rate  =  1.0
-Lambda =  0.1
-Accuracy score on test set:  0.16666666666666666
-
-
-
Learning rate  =  1.0
-Lambda =  1.0
-Accuracy score on test set:  0.1111111111111111
-
-Learning rate  =  1.0
-Lambda =  10.0
-Accuracy score on test set:  0.05
-
-
-
Learning rate  =  10.0
-Lambda =  1e-05
-Accuracy score on test set:  0.08888888888888889
-
-Learning rate  =  10.0
-Lambda =  0.0001
-Accuracy score on test set:  0.08611111111111111
-
-Learning rate  =  10.0
-Lambda =  0.001
-Accuracy score on test set:  0.08888888888888889
-
-
-
Learning rate  =  10.0
-Lambda =  0.01
-Accuracy score on test set:  0.08888888888888889
-
-Learning rate  =  10.0
-Lambda =  0.1
-Accuracy score on test set:  0.10555555555555556
-
-
-
Learning rate  =  10.0
-Lambda =  1.0
-Accuracy score on test set:  0.1111111111111111
-
-Learning rate  =  10.0
-Lambda =  10.0
-Accuracy score on test set:  0.1527777777777778
-
-
-
-
-
-
-

14.8. Visualization

-
-
-
# optional
-# visual representation of grid search
-# uses seaborn heatmap, could probably do this in matplotlib
-import seaborn as sns
-
-sns.set()
-
-train_accuracy = np.zeros((len(eta_vals), len(lmbd_vals)))
-test_accuracy = np.zeros((len(eta_vals), len(lmbd_vals)))
-
-for i in range(len(eta_vals)):
-    for j in range(len(lmbd_vals)):
-        dnn = DNN_scikit[i][j]
-        
-        train_pred = dnn.predict(X_train) 
-        test_pred = dnn.predict(X_test)
-
-        train_accuracy[i][j] = accuracy_score(Y_train, train_pred)
-        test_accuracy[i][j] = accuracy_score(Y_test, test_pred)
-
-        
-fig, ax = plt.subplots(figsize = (10, 10))
-sns.heatmap(train_accuracy, annot=True, ax=ax, cmap="viridis")
-ax.set_title("Training Accuracy")
-ax.set_ylabel("$\eta$")
-ax.set_xlabel("$\lambda$")
-plt.show()
-
-fig, ax = plt.subplots(figsize = (10, 10))
-sns.heatmap(test_accuracy, annot=True, ax=ax, cmap="viridis")
-ax.set_title("Test Accuracy")
-ax.set_ylabel("$\eta$")
-ax.set_xlabel("$\lambda$")
-plt.show()
-
-
-
-
-_images/chapter10_53_0.png -_images/chapter10_53_1.png -
-
-
-
-

14.9. Building neural networks in Tensorflow and Keras

-

Now we want to build on the experience gained from our neural network implementation in NumPy and scikit-learn -and use it to construct a neural network in Tensorflow. Once we have constructed a neural network in NumPy -and Tensorflow, building one in Keras is really quite trivial, though the performance may suffer.

-

In our previous example we used only one hidden layer, and in this we will use two. From this it should be quite -clear how to build one using an arbitrary number of hidden layers, using data structures such as Python lists or -NumPy arrays.

-

Tensorflow is an open source library machine learning library -developed by the Google Brain team for internal use. It was released -under the Apache 2.0 open source license in November 9, 2015.

-

Tensorflow is a computational framework that allows you to construct -machine learning models at different levels of abstraction, from -high-level, object-oriented APIs like Keras, down to the C++ kernels -that Tensorflow is built upon. The higher levels of abstraction are -simpler to use, but less flexible, and our choice of implementation -should reflect the problems we are trying to solve.

-

Tensorflow uses so-called graphs to represent your computation -in terms of the dependencies between individual operations, such that you first build a Tensorflow graph -to represent your model, and then create a Tensorflow session to run the graph.

-

In this guide we will analyze the same data as we did in our NumPy and -scikit-learn tutorial, gathered from the MNIST database of images. We -will give an introduction to the lower level Python Application -Program Interfaces (APIs), and see how we use them to build our graph. -Then we will build (effectively) the same graph in Keras, to see just -how simple solving a machine learning problem can be.

-

To install tensorflow on Unix/Linux systems, use pip as

-
-
-
pip3 install tensorflow
-
-
-
-
-
  File "<ipython-input-12-6ea927cc6e88>", line 1
-    pip3 install tensorflow
-         ^
-SyntaxError: invalid syntax
-
-
-
-
-

and/or if you use anaconda, just write (or install from the graphical user interface) -(current release of CPU-only TensorFlow)

-
-
-
conda create -n tf tensorflow
-conda activate tf
-
-
-
-
-

To install the current release of GPU TensorFlow

-
-
-
conda create -n tf-gpu tensorflow-gpu
-conda activate tf-gpu
-
-
-
-
-

Keras is a high level neural network -that supports Tensorflow, CTNK and Theano as backends.
-If you have Anaconda installed you may run the following command

-
-
-
conda install keras
-
-
-
-
-

You can look up the instructions here for more information.

-

We will to a large extent use keras in this course.

-

Let us look again at the MINST data set.

-
-
-
# import necessary packages
-import numpy as np
-import matplotlib.pyplot as plt
-import tensorflow as tf
-from sklearn import datasets
-
-
-# ensure the same random numbers appear every time
-np.random.seed(0)
-
-# display images in notebook
-%matplotlib inline
-plt.rcParams['figure.figsize'] = (12,12)
-
-
-# download MNIST dataset
-digits = datasets.load_digits()
-
-# define inputs and labels
-inputs = digits.images
-labels = digits.target
-
-print("inputs = (n_inputs, pixel_width, pixel_height) = " + str(inputs.shape))
-print("labels = (n_inputs) = " + str(labels.shape))
-
-
-# flatten the image
-# the value -1 means dimension is inferred from the remaining dimensions: 8x8 = 64
-n_inputs = len(inputs)
-inputs = inputs.reshape(n_inputs, -1)
-print("X = (n_inputs, n_features) = " + str(inputs.shape))
-
-
-# choose some random images to display
-indices = np.arange(n_inputs)
-random_indices = np.random.choice(indices, size=5)
-
-for i, image in enumerate(digits.images[random_indices]):
-    plt.subplot(1, 5, i+1)
-    plt.axis('off')
-    plt.imshow(image, cmap=plt.cm.gray_r, interpolation='nearest')
-    plt.title("Label: %d" % digits.target[random_indices[i]])
-plt.show()
-
-
-
-
-
-
-
from tensorflow.keras.layers import Input
-from tensorflow.keras.models import Sequential      #This allows appending layers to existing models
-from tensorflow.keras.layers import Dense           #This allows defining the characteristics of a particular layer
-from tensorflow.keras import optimizers             #This allows using whichever optimiser we want (sgd,adam,RMSprop)
-from tensorflow.keras import regularizers           #This allows using whichever regularizer we want (l1,l2,l1_l2)
-from tensorflow.keras.utils import to_categorical   #This allows using categorical cross entropy as the cost function
-
-from sklearn.model_selection import train_test_split
-
-# one-hot representation of labels
-labels = to_categorical(labels)
-
-# split into train and test data
-train_size = 0.8
-test_size = 1 - train_size
-X_train, X_test, Y_train, Y_test = train_test_split(inputs, labels, train_size=train_size,
-                                                    test_size=test_size)
-
-
-
-
-
-
-
epochs = 100
-batch_size = 100
-n_neurons_layer1 = 100
-n_neurons_layer2 = 50
-n_categories = 10
-eta_vals = np.logspace(-5, 1, 7)
-lmbd_vals = np.logspace(-5, 1, 7)
-def create_neural_network_keras(n_neurons_layer1, n_neurons_layer2, n_categories, eta, lmbd):
-    model = Sequential()
-    model.add(Dense(n_neurons_layer1, activation='sigmoid', kernel_regularizer=regularizers.l2(lmbd)))
-    model.add(Dense(n_neurons_layer2, activation='sigmoid', kernel_regularizer=regularizers.l2(lmbd)))
-    model.add(Dense(n_categories, activation='softmax'))
-    
-    sgd = optimizers.SGD(lr=eta)
-    model.compile(loss='categorical_crossentropy', optimizer=sgd, metrics=['accuracy'])
-    
-    return model
-
-
-
-
-
-
-
DNN_keras = np.zeros((len(eta_vals), len(lmbd_vals)), dtype=object)
-        
-for i, eta in enumerate(eta_vals):
-    for j, lmbd in enumerate(lmbd_vals):
-        DNN = create_neural_network_keras(n_neurons_layer1, n_neurons_layer2, n_categories,
-                                         eta=eta, lmbd=lmbd)
-        DNN.fit(X_train, Y_train, epochs=epochs, batch_size=batch_size, verbose=0)
-        scores = DNN.evaluate(X_test, Y_test)
-        
-        DNN_keras[i][j] = DNN
-        
-        print("Learning rate = ", eta)
-        print("Lambda = ", lmbd)
-        print("Test accuracy: %.3f" % scores[1])
-        print()
-
-
-
-
-
-
-
# optional
-# visual representation of grid search
-# uses seaborn heatmap, could probably do this in matplotlib
-import seaborn as sns
-
-sns.set()
-
-train_accuracy = np.zeros((len(eta_vals), len(lmbd_vals)))
-test_accuracy = np.zeros((len(eta_vals), len(lmbd_vals)))
-
-for i in range(len(eta_vals)):
-    for j in range(len(lmbd_vals)):
-        DNN = DNN_keras[i][j]
-
-        train_accuracy[i][j] = DNN.evaluate(X_train, Y_train)[1]
-        test_accuracy[i][j] = DNN.evaluate(X_test, Y_test)[1]
-
-        
-fig, ax = plt.subplots(figsize = (10, 10))
-sns.heatmap(train_accuracy, annot=True, ax=ax, cmap="viridis")
-ax.set_title("Training Accuracy")
-ax.set_ylabel("$\eta$")
-ax.set_xlabel("$\lambda$")
-plt.show()
-
-fig, ax = plt.subplots(figsize = (10, 10))
-sns.heatmap(test_accuracy, annot=True, ax=ax, cmap="viridis")
-ax.set_title("Test Accuracy")
-ax.set_ylabel("$\eta$")
-ax.set_xlabel("$\lambda$")
-plt.show()
-
-
-
-
-
-
-

14.10. The Breast Cancer Data, now with Keras

-
-
-
import tensorflow as tf
-from tensorflow.keras.layers import Input
-from tensorflow.keras.models import Sequential      #This allows appending layers to existing models
-from tensorflow.keras.layers import Dense           #This allows defining the characteristics of a particular layer
-from tensorflow.keras import optimizers             #This allows using whichever optimiser we want (sgd,adam,RMSprop)
-from tensorflow.keras import regularizers           #This allows using whichever regularizer we want (l1,l2,l1_l2)
-from tensorflow.keras.utils import to_categorical   #This allows using categorical cross entropy as the cost function
-import numpy as np
-import matplotlib.pyplot as plt
-import seaborn as sns
-from sklearn.model_selection import train_test_split as splitter
-from sklearn.datasets import load_breast_cancer
-import pickle
-import os 
-
-
-"""Load breast cancer dataset"""
-
-np.random.seed(0)        #create same seed for random number every time
-
-cancer=load_breast_cancer()      #Download breast cancer dataset
-
-inputs=cancer.data                     #Feature matrix of 569 rows (samples) and 30 columns (parameters)
-outputs=cancer.target                  #Label array of 569 rows (0 for benign and 1 for malignant)
-labels=cancer.feature_names[0:30]
-
-print('The content of the breast cancer dataset is:')      #Print information about the datasets
-print(labels)
-print('-------------------------')
-print("inputs =  " + str(inputs.shape))
-print("outputs =  " + str(outputs.shape))
-print("labels =  "+ str(labels.shape))
-
-x=inputs      #Reassign the Feature and Label matrices to other variables
-y=outputs
-
-#%% 
-
-# Visualisation of dataset (for correlation analysis)
-
-plt.figure()
-plt.scatter(x[:,0],x[:,2],s=40,c=y,cmap=plt.cm.Spectral)
-plt.xlabel('Mean radius',fontweight='bold')
-plt.ylabel('Mean perimeter',fontweight='bold')
-plt.show()
-
-plt.figure()
-plt.scatter(x[:,5],x[:,6],s=40,c=y, cmap=plt.cm.Spectral)
-plt.xlabel('Mean compactness',fontweight='bold')
-plt.ylabel('Mean concavity',fontweight='bold')
-plt.show()
-
-
-plt.figure()
-plt.scatter(x[:,0],x[:,1],s=40,c=y,cmap=plt.cm.Spectral)
-plt.xlabel('Mean radius',fontweight='bold')
-plt.ylabel('Mean texture',fontweight='bold')
-plt.show()
-
-plt.figure()
-plt.scatter(x[:,2],x[:,1],s=40,c=y,cmap=plt.cm.Spectral)
-plt.xlabel('Mean perimeter',fontweight='bold')
-plt.ylabel('Mean compactness',fontweight='bold')
-plt.show()
-
-
-# Generate training and testing datasets
-
-#Select features relevant to classification (texture,perimeter,compactness and symmetery) 
-#and add to input matrix
-
-temp1=np.reshape(x[:,1],(len(x[:,1]),1))
-temp2=np.reshape(x[:,2],(len(x[:,2]),1))
-X=np.hstack((temp1,temp2))      
-temp=np.reshape(x[:,5],(len(x[:,5]),1))
-X=np.hstack((X,temp))       
-temp=np.reshape(x[:,8],(len(x[:,8]),1))
-X=np.hstack((X,temp))       
-
-X_train,X_test,y_train,y_test=splitter(X,y,test_size=0.1)   #Split datasets into training and testing
-
-y_train=to_categorical(y_train)     #Convert labels to categorical when using categorical cross entropy
-y_test=to_categorical(y_test)
-
-del temp1,temp2,temp
-
-# %%
-
-# Define tunable parameters"
-
-eta=np.logspace(-3,-1,3)                    #Define vector of learning rates (parameter to SGD optimiser)
-lamda=0.01                                  #Define hyperparameter
-n_layers=2                                  #Define number of hidden layers in the model
-n_neuron=np.logspace(0,3,4,dtype=int)       #Define number of neurons per layer
-epochs=100                                   #Number of reiterations over the input data
-batch_size=100                              #Number of samples per gradient update
-
-# %%
-
-"""Define function to return Deep Neural Network model"""
-
-def NN_model(inputsize,n_layers,n_neuron,eta,lamda):
-    model=Sequential()      
-    for i in range(n_layers):       #Run loop to add hidden layers to the model
-        if (i==0):                  #First layer requires input dimensions
-            model.add(Dense(n_neuron,activation='relu',kernel_regularizer=regularizers.l2(lamda),input_dim=inputsize))
-        else:                       #Subsequent layers are capable of automatic shape inferencing
-            model.add(Dense(n_neuron,activation='relu',kernel_regularizer=regularizers.l2(lamda)))
-    model.add(Dense(2,activation='softmax'))  #2 outputs - ordered and disordered (softmax for prob)
-    sgd=optimizers.SGD(lr=eta)
-    model.compile(loss='categorical_crossentropy',optimizer=sgd,metrics=['accuracy'])
-    return model
-
-    
-Train_accuracy=np.zeros((len(n_neuron),len(eta)))      #Define matrices to store accuracy scores as a function
-Test_accuracy=np.zeros((len(n_neuron),len(eta)))       #of learning rate and number of hidden neurons for 
-
-for i in range(len(n_neuron)):     #run loops over hidden neurons and learning rates to calculate 
-    for j in range(len(eta)):      #accuracy scores 
-        DNN_model=NN_model(X_train.shape[1],n_layers,n_neuron[i],eta[j],lamda)
-        DNN_model.fit(X_train,y_train,epochs=epochs,batch_size=batch_size,verbose=1)
-        Train_accuracy[i,j]=DNN_model.evaluate(X_train,y_train)[1]
-        Test_accuracy[i,j]=DNN_model.evaluate(X_test,y_test)[1]
-               
-
-def plot_data(x,y,data,title=None):
-
-    # plot results
-    fontsize=16
-
-
-    fig = plt.figure()
-    ax = fig.add_subplot(111)
-    cax = ax.matshow(data, interpolation='nearest', vmin=0, vmax=1)
-    
-    cbar=fig.colorbar(cax)
-    cbar.ax.set_ylabel('accuracy (%)',rotation=90,fontsize=fontsize)
-    cbar.set_ticks([0,.2,.4,0.6,0.8,1.0])
-    cbar.set_ticklabels(['0%','20%','40%','60%','80%','100%'])
-
-    # put text on matrix elements
-    for i, x_val in enumerate(np.arange(len(x))):
-        for j, y_val in enumerate(np.arange(len(y))):
-            c = "${0:.1f}\\%$".format( 100*data[j,i])  
-            ax.text(x_val, y_val, c, va='center', ha='center')
-
-    # convert axis vaues to to string labels
-    x=[str(i) for i in x]
-    y=[str(i) for i in y]
-
-
-    ax.set_xticklabels(['']+x)
-    ax.set_yticklabels(['']+y)
-
-    ax.set_xlabel('$\\mathrm{learning\\ rate}$',fontsize=fontsize)
-    ax.set_ylabel('$\\mathrm{hidden\\ neurons}$',fontsize=fontsize)
-    if title is not None:
-        ax.set_title(title)
-
-    plt.tight_layout()
-
-    plt.show()
-    
-plot_data(eta,n_neuron,Train_accuracy, 'training')
-plot_data(eta,n_neuron,Test_accuracy, 'testing')
-
-
-
-
-
-
-

14.11. Fine-tuning neural network hyperparameters

-

The flexibility of neural networks is also one of their main -drawbacks: there are many hyperparameters to tweak. Not only can you -use any imaginable network topology (how neurons/nodes are interconnected), -but even in a simple FFNN you can change the number of layers, the -number of neurons per layer, the type of activation function to use in -each layer, the weight initialization logic, the stochastic gradient optmized and much more. How do you -know what combination of hyperparameters is the best for your task?

-
    -
  • You can use grid search with cross-validation to find the right hyperparameters.

  • -
-

However,since there are many hyperparameters to tune, and since -training a neural network on a large dataset takes a lot of time, you -will only be able to explore a tiny part of the hyperparameter space.

-
    -
  • You can use randomized search.

  • -
  • Or use tools like Oscar, which implements more complex algorithms to help you find a good set of hyperparameters quickly.

  • -
-

For many problems you can start with just one or two hidden layers and it will work just fine. -For the MNIST data set you ca easily get a high accuracy using just one hidden layer with a -few hundred neurons. -You can reach for this data set above 98% accuracy using two hidden layers with the same total amount of -neurons, in roughly the same amount of training time.

-

For more complex problems, you can gradually -ramp up the number of hidden layers, until you start overfitting the training set. Very complex tasks, such -as large image classification or speech recognition, typically require networks with dozens of layers -and they need a huge amount -of training data. However, you will rarely have to train such networks from scratch: it is much more -common to reuse parts of a pretrained state-of-the-art network that performs a similar task.

-
-
-

14.12. Which activation function should I use?

-

The Back propagation algorithm we derived above works by going from -the output layer to the input layer, propagating the error gradient on -the way. Once the algorithm has computed the gradient of the cost -function with regards to each parameter in the network, it uses these -gradients to update each parameter with a Gradient Descent (GD) step.

-

Unfortunately for us, the gradients often get smaller and smaller as the -algorithm progresses down to the first hidden layers. As a result, the -GD update leaves the lower layer connection weights -virtually unchanged, and training never converges to a good -solution. This is known in the literature as -the vanishing gradients problem.

-

In other cases, the opposite can happen, namely the the gradients can grow bigger and -bigger. The result is that many of the layers get large updates of the -weights the -algorithm diverges. This is the exploding gradients problem, which is -mostly encountered in recurrent neural networks. More generally, deep -neural networks suffer from unstable gradients, different layers may -learn at widely different speeds

-

Although this unfortunate behavior has been empirically observed for -quite a while (it was one of the reasons why deep neural networks were -mostly abandoned for a long time), it is only around 2010 that -significant progress was made in understanding it.

-

A paper titled Understanding the Difficulty of Training Deep -Feedforward Neural Networks by Xavier Glorot and Yoshua Bengio found that -the problems with the popular logistic -sigmoid activation function and the weight initialization technique -that was most popular at the time, namely random initialization using -a normal distribution with a mean of 0 and a standard deviation of -1.

-

They showed that with this activation function and this -initialization scheme, the variance of the outputs of each layer is -much greater than the variance of its inputs. Going forward in the -network, the variance keeps increasing after each layer until the -activation function saturates at the top layers. This is actually made -worse by the fact that the logistic function has a mean of 0.5, not 0 -(the hyperbolic tangent function has a mean of 0 and behaves slightly -better than the logistic function in deep networks).

-

Looking at the logistic activation function, when inputs become large -(negative or positive), the function saturates at 0 or 1, with a -derivative extremely close to 0. Thus when backpropagation kicks in, -it has virtually no gradient to propagate back through the network, -and what little gradient exists keeps getting diluted as -backpropagation progresses down through the top layers, so there is -really nothing left for the lower layers.

-

In their paper, Glorot and Bengio propose a way to significantly -alleviate this problem. We need the signal to flow properly in both -directions: in the forward direction when making predictions, and in -the reverse direction when backpropagating gradients. We don’t want -the signal to die out, nor do we want it to explode and saturate. For -the signal to flow properly, the authors argue that we need the -variance of the outputs of each layer to be equal to the variance of -its inputs, and we also need the gradients to have equal variance -before and after flowing through a layer in the reverse direction.

-

One of the insights in the 2010 paper by Glorot and Bengio was that -the vanishing/exploding gradients problems were in part due to a poor -choice of activation function. Until then most people had assumed that -if Nature had chosen to use roughly sigmoid activation functions in -biological neurons, they must be an excellent choice. But it turns out -that other activation functions behave much better in deep neural -networks, in particular the ReLU activation function, mostly because -it does not saturate for positive values (and also because it is quite -fast to compute).

-
-
-

14.13. The RELU function family

-

The ReLU activation function suffers from a problem known as the dying -ReLUs: during training, some neurons effectively die, meaning they -stop outputting anything other than 0.

-

In some cases, you may find that half of your network’s neurons are -dead, especially if you used a large learning rate. During training, -if a neuron’s weights get updated such that the weighted sum of the -neuron’s inputs is negative, it will start outputting 0. When this -happen, the neuron is unlikely to come back to life since the gradient -of the ReLU function is 0 when its input is negative.

-

To solve this problem, nowadays practitioners use a variant of the ReLU -function, such as the leaky ReLU discussed above or the so-called -exponential linear unit (ELU) function

-
-\[\begin{split} -ELU(z) = \left\{\begin{array}{cc} \alpha\left( \exp{(z)}-1\right) & z < 0,\\ z & z \ge 0.\end{array}\right. -\end{split}\]
-

In general it seems that the ELU activation function is better than -the leaky ReLU function (and its variants), which is better than -ReLU. ReLU performs better than \(\tanh\) which in turn performs better -than the logistic function.

-

If runtime -performance is an issue, then you may opt for the leaky ReLU function over the -ELU function If you don’t -want to tweak yet another hyperparameter, you may just use the default -\(\alpha\) of \(0.01\) for the leaky ReLU, and \(1\) for ELU. If you have -spare time and computing power, you can use cross-validation or -bootstrap to evaluate other activation functions.

-

In most cases you can use the ReLU activation function in the hidden layers (or one of its variants).

-

It is a bit faster to compute than other activation functions, and the gradient descent optimization does in general not get stuck.

-

For the output layer:

-
    -
  • For classification the softmax activation function is generally a good choice for classification tasks (when the classes are mutually exclusive).

  • -
  • For regression tasks, you can simply use no activation function at all.

  • -
-
-
-

14.14. Batch Normalization

-

Batch Normalization -aims to address the vanishing/exploding gradients problems, and more generally the problem that the -distribution of each layer’s inputs changes during training, as the parameters of the previous layers change.

-

The technique consists of adding an operation in the model just before the activation function of each -layer, simply zero-centering and normalizing the inputs, then scaling and shifting the result using two new -parameters per layer (one for scaling, the other for shifting). In other words, this operation lets the model -learn the optimal scale and mean of the inputs for each layer. -In order to zero-center and normalize the inputs, the algorithm needs to estimate the inputs’ mean and -standard deviation. It does so by evaluating the mean and standard deviation of the inputs over the current -mini-batch, from this the name batch normalization.

-
-
-

14.15. Dropout

-

It is a fairly simple algorithm: at every training step, every neuron (including the input neurons but -excluding the output neurons) has a probability \(p\) of being temporarily dropped out, meaning it will be -entirely ignored during this training step, but it may be active during the next step.

-

The -hyperparameter \(p\) is called the dropout rate, and it is typically set to 50%. After training, the neurons are not dropped anymore. -It is viewed as one of the most popular regularization techniques.

-
-
-

14.16. Gradient Clipping

-

A popular technique to lessen the exploding gradients problem is to simply clip the gradients during -backpropagation so that they never exceed some threshold (this is mostly useful for recurrent neural -networks).

-

This technique is called Gradient Clipping.

-

In general however, Batch -Normalization is preferred.

-
-
-

14.17. A top-down perspective on Neural networks

-

The first thing we would like to do is divide the data into two or three -parts. A training set, a validation or dev (development) set, and a -test set. The test set is the data on which we want to make -predictions. The dev set is a subset of the training data we use to -check how well we are doing out-of-sample, after training the model on -the training dataset. We use the validation error as a proxy for the -test error in order to make tweaks to our model. It is crucial that we -do not use any of the test data to train the algorithm. This is a -cardinal sin in ML. Then:

-
    -
  • Estimate optimal error rate

  • -
  • Minimize underfitting (bias) on training data set.

  • -
  • Make sure you are not overfitting.

  • -
-

If the validation and test sets are drawn from the same distributions, -then a good performance on the validation set should lead to similarly -good performance on the test set.

-

However, sometimes -the training data and test data differ in subtle ways because, for -example, they are collected using slightly different methods, or -because it is cheaper to collect data in one way versus another. In -this case, there can be a mismatch between the training and test -data. This can lead to the neural network overfitting these small -differences between the test and training sets, and a poor performance -on the test set despite having a good performance on the validation -set. To rectify this, Andrew Ng suggests making two validation or dev -sets, one constructed from the training data and one constructed from -the test data. The difference between the performance of the algorithm -on these two validation sets quantifies the train-test mismatch. This -can serve as another important diagnostic when using DNNs for -supervised learning.

-
-
-

14.18. Limitations of supervised learning with deep networks

-

Like all statistical methods, supervised learning using neural -networks has important limitations. This is especially important when -one seeks to apply these methods, especially to physics problems. Like -all tools, DNNs are not a universal solution. Often, the same or -better performance on a task can be achieved by using a few -hand-engineered features (or even a collection of random -features).

-

Here we list some of the important limitations of supervised neural network based models.

-
    -
  • 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).

  • -
  • 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.

  • -
  • 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.

  • -
  • 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.

  • -
-

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.

-
-
- - - - -
- - - - -
-
-
-
-

- - By Morten Hjorth-Jensen
- - © Copyright 2021.
-

-
-
-
- - -
-
- - - - - - \ No newline at end of file diff --git a/doc/LectureNotes/_build/html/chapter11.html b/doc/LectureNotes/_build/html/chapter11.html deleted file mode 100644 index 50e199cbd..000000000 --- a/doc/LectureNotes/_build/html/chapter11.html +++ /dev/null @@ -1,2737 +0,0 @@ - - - - - - - - 15. Solving Differential Equations with Deep Learning — Applied Data Analysis and Machine Learning - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
- - - - - - - - -
- - -
-
- -
- -
-

15. Solving Differential Equations with Deep Learning

-

The Universal Approximation Theorem states that a neural network can -approximate any function at a single hidden layer along with one input -and output layer to any given precision.

-

An ordinary differential equation (ODE) is an equation involving functions having one variable.

-

In general, an ordinary differential equation looks like

- -
-
-\[ -\begin{equation} \label{ode} \tag{1} -f\left(x, \, g(x), \, g'(x), \, g''(x), \, \dots \, , \, g^{(n)}(x)\right) = 0 -\end{equation} -\]
-

where \(g(x)\) is the function to find, and \(g^{(n)}(x)\) is the \(n\)-th derivative of \(g(x)\).

-

The \(f\left(x, g(x), g'(x), g''(x), \, \dots \, , g^{(n)}(x)\right)\) is just a way to write that there is an expression involving \(x\) and \(g(x), \ g'(x), \ g''(x), \, \dots \, , \text{ and } g^{(n)}(x)\) on the left side of the equality sign in (1). -The highest order of derivative, that is the value of \(n\), determines to the order of the equation. -The equation is referred to as a \(n\)-th order ODE. -Along with (1), some additional conditions of the function \(g(x)\) are typically given -for the solution to be unique.

-

Let the trial solution \(g_t(x)\) be

- -
-
-\[ -\begin{equation} - g_t(x) = h_1(x) + h_2(x,N(x,P)) -\label{_auto1} \tag{2} -\end{equation} -\]
-

where \(h_1(x)\) is a function that makes \(g_t(x)\) satisfy a given set -of conditions, \(N(x,P)\) a neural network with weights and biases -described by \(P\) and \(h_2(x, N(x,P))\) some expression involving the -neural network. The role of the function \(h_2(x, N(x,P))\), is to -ensure that the output from \(N(x,P)\) is zero when \(g_t(x)\) is -evaluated at the values of \(x\) where the given conditions must be -satisfied. The function \(h_1(x)\) should alone make \(g_t(x)\) satisfy -the conditions.

-

But what about the network \(N(x,P)\)?

-

As described previously, an optimization method could be used to minimize the parameters of a neural network, that being its weights and biases, through backward propagation.

-

For the minimization to be defined, we need to have a cost function at hand to minimize.

-

It is given that \(f\left(x, \, g(x), \, g'(x), \, g''(x), \, \dots \, , \, g^{(n)}(x)\right)\) should be equal to zero in (1). -We can choose to consider the mean squared error as the cost function for an input \(x\). -Since we are looking at one input, the cost function is just \(f\) squared. -The cost function \(c\left(x, P \right)\) can therefore be expressed as

-
-\[ -C\left(x, P\right) = \big(f\left(x, \, g(x), \, g'(x), \, g''(x), \, \dots \, , \, g^{(n)}(x)\right)\big)^2 -\]
-

If \(N\) inputs are given as a vector \(\boldsymbol{x}\) with elements \(x_i\) for \(i = 1,\dots,N\), -the cost function becomes

- -
-
-\[ -\begin{equation} \label{cost} \tag{3} - C\left(\boldsymbol{x}, P\right) = \frac{1}{N} \sum_{i=1}^N \big(f\left(x_i, \, g(x_i), \, g'(x_i), \, g''(x_i), \, \dots \, , \, g^{(n)}(x_i)\right)\big)^2 -\end{equation} -\]
-

The neural net should then find the parameters \(P\) that minimizes the cost function in -(3) for a set of \(N\) training samples \(x_i\).

-

To perform the minimization using gradient descent, the gradient of \(C\left(\boldsymbol{x}, P\right)\) is needed. -It might happen so that finding an analytical expression of the gradient of \(C(\boldsymbol{x}, P)\) from (3) gets too messy, depending on which cost function one desires to use.

-

Luckily, there exists libraries that makes the job for us through automatic differentiation. -Automatic differentiation is a method of finding the derivatives numerically with very high precision.

-
-

15.1. Example: Exponential decay

-

An exponential decay of a quantity \(g(x)\) is described by the equation

- -
-
-\[ -\begin{equation} \label{solve_expdec} \tag{4} - g'(x) = -\gamma g(x) -\end{equation} -\]
-

with \(g(0) = g_0\) for some chosen initial value \(g_0\).

-

The analytical solution of (4) is

- -
-
-\[ -\begin{equation} - g(x) = g_0 \exp\left(-\gamma x\right) -\label{_auto2} \tag{5} -\end{equation} -\]
-

Having an analytical solution at hand, it is possible to use it to compare how well a neural network finds a solution of (4).

-

The program will use a neural network to solve

- -
-
-\[ -\begin{equation} \label{solveode} \tag{6} -g'(x) = -\gamma g(x) -\end{equation} -\]
-

where \(g(0) = g_0\) with \(\gamma\) and \(g_0\) being some chosen values.

-

In this example, \(\gamma = 2\) and \(g_0 = 10\).

-

To begin with, a trial solution \(g_t(t)\) must be chosen. A general trial solution for ordinary differential equations could be

-
-\[ -g_t(x, P) = h_1(x) + h_2(x, N(x, P)) -\]
-

with \(h_1(x)\) ensuring that \(g_t(x)\) satisfies some conditions and \(h_2(x,N(x, P))\) an expression involving \(x\) and the output from the neural network \(N(x,P)\) with \(P \) being the collection of the weights and biases for each layer. For now, it is assumed that the network consists of one input layer, one hidden layer, and one output layer.

-

In this network, there are no weights and bias at the input layer, so \(P = \{ P_{\text{hidden}}, P_{\text{output}} \}\). -If there are \(N_{\text{hidden} }\) neurons in the hidden layer, then \(P_{\text{hidden}}\) is a \(N_{\text{hidden} } \times (1 + N_{\text{input}})\) matrix, given that there are \(N_{\text{input}}\) neurons in the input layer.

-

The first column in \(P_{\text{hidden} }\) represents the bias for each neuron in the hidden layer and the second column represents the weights for each neuron in the hidden layer from the input layer. -If there are \(N_{\text{output} }\) neurons in the output layer, then \(P_{\text{output}} \) is a \(N_{\text{output} } \times (1 + N_{\text{hidden} })\) matrix.

-

Its first column represents the bias of each neuron and the remaining columns represents the weights to each neuron.

-

It is given that \(g(0) = g_0\). The trial solution must fulfill this condition to be a proper solution of (6). A possible way to ensure that \(g_t(0, P) = g_0\), is to let \(F(N(x,P)) = x \cdot N(x,P)\) and \(A(x) = g_0\). This gives the following trial solution:

- -
-
-\[ -\begin{equation} \label{trial} \tag{7} -g_t(x, P) = g_0 + x \cdot N(x, P) -\end{equation} -\]
-
-
-

15.2. Reformulating the problem

-

We wish that our neural network manages to minimize a given cost function.

-

A reformulation of out equation, (6), must therefore be done, -such that it describes the problem a neural network can solve for.

-

The neural network must find the set of weights and biases \(P\) such that the trial solution in (7) satisfies (6).

-

The trial solution

-
-\[ -g_t(x, P) = g_0 + x \cdot N(x, P) -\]
-

has been chosen such that it already solves the condition \(g(0) = g_0\). What remains, is to find \(P\) such that

- -
-
-\[ -\begin{equation} \label{nnmin} \tag{8} -g_t'(x, P) = - \gamma g_t(x, P) -\end{equation} -\]
-

is fulfilled as best as possible.

-

The left hand side and right hand side of (8) must be computed separately, and then the neural network must choose weights and biases, contained in \(P\), such that the sides are equal as best as possible. -This means that the absolute or squared difference between the sides must be as close to zero, ideally equal to zero. -In this case, the difference squared shows to be an appropriate measurement of how erroneous the trial solution is with respect to \(P\) of the neural network.

-

This gives the following cost function our neural network must solve for:

-
-\[ -\min_{P}\Big\{ \big(g_t'(x, P) - ( -\gamma g_t(x, P) \big)^2 \Big\} -\]
-

(the notation \(\min_{P}\{ f(x, P) \}\) means that we desire to find \(P\) that yields the minimum of \(f(x, P)\))

-

or, in terms of weights and biases for the hidden and output layer in our network:

-
-\[ -\min_{P_{\text{hidden} }, \ P_{\text{output} }}\Big\{ \big(g_t'(x, \{ P_{\text{hidden} }, P_{\text{output} }\}) - ( -\gamma g_t(x, \{ P_{\text{hidden} }, P_{\text{output} }\}) \big)^2 \Big\} -\]
-

for an input value \(x\).

-

If the neural network evaluates \(g_t(x, P)\) at more values for \(x\), say \(N\) values \(x_i\) for \(i = 1, \dots, N\), then the total error to minimize becomes

- -
-
-\[ -\begin{equation} \label{min} \tag{9} -\min_{P}\Big\{\frac{1}{N} \sum_{i=1}^N \big(g_t'(x_i, P) - ( -\gamma g_t(x_i, P) \big)^2 \Big\} -\end{equation} -\]
-

Letting \(\boldsymbol{x}\) be a vector with elements \(x_i\) and \(C(\boldsymbol{x}, P) = \frac{1}{N} \sum_i \big(g_t'(x_i, P) - ( -\gamma g_t(x_i, P) \big)^2\) denote the cost function, the minimization problem that our network must solve, becomes

-
-\[ -\min_{P} C(\boldsymbol{x}, P) -\]
-

In terms of \(P_{\text{hidden} }\) and \(P_{\text{output} }\), this could also be expressed as

-
-\[ -\min_{P_{\text{hidden} }, \ P_{\text{output} }} C(\boldsymbol{x}, \{P_{\text{hidden} }, P_{\text{output} }\}) -\]
-

For simplicity, it is assumed that the input is an array \(\boldsymbol{x} = (x_1, \dots, x_N)\) with \(N\) elements. It is at these points the neural network should find \(P\) such that it fulfills (9).

-

First, the neural network must feed forward the inputs. -This means that \(\boldsymbol{x}s\) must be passed through an input layer, a hidden layer and a output layer. The input layer in this case, does not need to process the data any further. -The input layer will consist of \(N_{\text{input} }\) neurons, passing its element to each neuron in the hidden layer. The number of neurons in the hidden layer will be \(N_{\text{hidden} }\).

-

For the \(i\)-th in the hidden layer with weight \(w_i^{\text{hidden} }\) and bias \(b_i^{\text{hidden} }\), the weighting from the \(j\)-th neuron at the input layer is:

-
-\[\begin{split} -\begin{aligned} -z_{i,j}^{\text{hidden}} &= b_i^{\text{hidden}} + w_i^{\text{hidden}}x_j \\ -&= -\begin{pmatrix} -b_i^{\text{hidden}} & w_i^{\text{hidden}} -\end{pmatrix} -\begin{pmatrix} -1 \\ -x_j -\end{pmatrix} -\end{aligned} -\end{split}\]
-

The result after weighting the inputs at the \(i\)-th hidden neuron can be written as a vector:

-
-\[\begin{split} -\begin{aligned} -\boldsymbol{z}_{i}^{\text{hidden}} &= \Big( b_i^{\text{hidden}} + w_i^{\text{hidden}}x_1 , \ b_i^{\text{hidden}} + w_i^{\text{hidden}} x_2, \ \dots \, , \ b_i^{\text{hidden}} + w_i^{\text{hidden}} x_N\Big) \\ -&= -\begin{pmatrix} - b_i^{\text{hidden}} & w_i^{\text{hidden}} -\end{pmatrix} -\begin{pmatrix} -1 & 1 & \dots & 1 \\ -x_1 & x_2 & \dots & x_N -\end{pmatrix} \\ -&= \boldsymbol{p}_{i, \text{hidden}}^T X -\end{aligned} -\end{split}\]
-

The vector \(\boldsymbol{p}_{i, \text{hidden}}^T\) constitutes each row in \(P_{\text{hidden} }\), which contains the weights for the neural network to minimize according to (9).

-

After having found \(\boldsymbol{z}_{i}^{\text{hidden}} \) for every \(i\)-th neuron within the hidden layer, the vector will be sent to an activation function \(a_i(\boldsymbol{z})\).

-

In this example, the sigmoid function has been chosen to be the activation function for each hidden neuron:

-
-\[ -f(z) = \frac{1}{1 + \exp{(-z)}} -\]
-

It is possible to use other activations functions for the hidden layer also.

-

The output \(\boldsymbol{x}_i^{\text{hidden}}\) from each \(i\)-th hidden neuron is:

-
-\[ -\boldsymbol{x}_i^{\text{hidden} } = f\big( \boldsymbol{z}_{i}^{\text{hidden}} \big) -\]
-

The outputs \(\boldsymbol{x}_i^{\text{hidden} } \) are then sent to the output layer.

-

The output layer consists of one neuron in this case, and combines the -output from each of the neurons in the hidden layers. The output layer -combines the results from the hidden layer using some weights \(w_i^{\text{output}}\) -and biases \(b_i^{\text{output}}\). In this case, -it is assumes that the number of neurons in the output layer is one.

-

The procedure of weighting the output neuron \(j\) in the hidden layer to the \(i\)-th neuron in the output layer is similar as for the hidden layer described previously.

-
-\[\begin{split} -\begin{aligned} -z_{1,j}^{\text{output}} & = -\begin{pmatrix} -b_1^{\text{output}} & \boldsymbol{w}_1^{\text{output}} -\end{pmatrix} -\begin{pmatrix} -1 \\ -\boldsymbol{x}_j^{\text{hidden}} -\end{pmatrix} -\end{aligned} -\end{split}\]
-

Expressing \(z_{1,j}^{\text{output}}\) as a vector gives the following way of weighting the inputs from the hidden layer:

-
-\[\begin{split} -\boldsymbol{z}_{1}^{\text{output}} = -\begin{pmatrix} -b_1^{\text{output}} & \boldsymbol{w}_1^{\text{output}} -\end{pmatrix} -\begin{pmatrix} -1 & 1 & \dots & 1 \\ -\boldsymbol{x}_1^{\text{hidden}} & \boldsymbol{x}_2^{\text{hidden}} & \dots & \boldsymbol{x}_N^{\text{hidden}} -\end{pmatrix} -\end{split}\]
-

In this case we seek a continuous range of values since we are approximating a function. This means that after computing \(\boldsymbol{z}_{1}^{\text{output}}\) the neural network has finished its feed forward step, and \(\boldsymbol{z}_{1}^{\text{output}}\) is the final output of the network.

-

The next step is to decide how the parameters should be changed such that they minimize the cost function.

-

The chosen cost function for this problem is

-
-\[ -C(\boldsymbol{x}, P) = \frac{1}{N} \sum_i \big(g_t'(x_i, P) - ( -\gamma g_t(x_i, P) \big)^2 -\]
-

In order to minimize the cost function, an optimization method must be chosen.

-

Here, gradient descent with a constant step size has been chosen.

-
-
-

15.3. Gradient descent

-

The idea of the gradient descent algorithm is to update parameters in -a direction where the cost function decreases goes to a minimum.

-

In general, the update of some parameters \(\boldsymbol{\omega}\) given a cost -function defined by some weights \(\boldsymbol{\omega}\), \(C(\boldsymbol{x}, -\boldsymbol{\omega})\), goes as follows:

-
-\[ -\boldsymbol{\omega}_{\text{new} } = \boldsymbol{\omega} - \lambda \nabla_{\boldsymbol{\omega}} C(\boldsymbol{x}, \boldsymbol{\omega}) -\]
-

for a number of iterations or until \( \big|\big| \boldsymbol{\omega}_{\text{new} } - \boldsymbol{\omega} \big|\big|\) becomes smaller than some given tolerance.

-

The value of \(\lambda\) decides how large steps the algorithm must take -in the direction of \( \nabla_{\boldsymbol{\omega}} C(\boldsymbol{x}, \boldsymbol{\omega})\). -The notation \(\nabla_{\boldsymbol{\omega}}\) express the gradient with respect -to the elements in \(\boldsymbol{\omega}\).

-

In our case, we have to minimize the cost function \(C(\boldsymbol{x}, P)\) with -respect to the two sets of weights and biases, that is for the hidden -layer \(P_{\text{hidden} }\) and for the output layer \(P_{\text{output} -}\) .

-

This means that \(P_{\text{hidden} }\) and \(P_{\text{output} }\) is updated by

-
-\[\begin{split} -\begin{aligned} -P_{\text{hidden},\text{new}} &= P_{\text{hidden}} - \lambda \nabla_{P_{\text{hidden}}} C(\boldsymbol{x}, P) \\ -P_{\text{output},\text{new}} &= P_{\text{output}} - \lambda \nabla_{P_{\text{output}}} C(\boldsymbol{x}, P) -\end{aligned} -\end{split}\]
-
-
-

15.4. The code for solving the ODE

-
-
-
%matplotlib inline
-
-import autograd.numpy as np
-from autograd import grad, elementwise_grad
-import autograd.numpy.random as npr
-from matplotlib import pyplot as plt
-
-def sigmoid(z):
-    return 1/(1 + np.exp(-z))
-
-# Assuming one input, hidden, and output layer
-def neural_network(params, x):
-
-    # Find the weights (including and biases) for the hidden and output layer.
-    # Assume that params is a list of parameters for each layer.
-    # The biases are the first element for each array in params,
-    # and the weights are the remaning elements in each array in params.
-
-    w_hidden = params[0]
-    w_output = params[1]
-
-    # Assumes input x being an one-dimensional array
-    num_values = np.size(x)
-    x = x.reshape(-1, num_values)
-
-    # Assume that the input layer does nothing to the input x
-    x_input = x
-
-    ## Hidden layer:
-
-    # Add a row of ones to include bias
-    x_input = np.concatenate((np.ones((1,num_values)), x_input ), axis = 0)
-
-    z_hidden = np.matmul(w_hidden, x_input)
-    x_hidden = sigmoid(z_hidden)
-
-    ## Output layer:
-
-    # Include bias:
-    x_hidden = np.concatenate((np.ones((1,num_values)), x_hidden ), axis = 0)
-
-    z_output = np.matmul(w_output, x_hidden)
-    x_output = z_output
-
-    return x_output
-
-# The trial solution using the deep neural network:
-def g_trial(x,params, g0 = 10):
-    return g0 + x*neural_network(params,x)
-
-# The right side of the ODE:
-def g(x, g_trial, gamma = 2):
-    return -gamma*g_trial
-
-# The cost function:
-def cost_function(P, x):
-
-    # Evaluate the trial function with the current parameters P
-    g_t = g_trial(x,P)
-
-    # Find the derivative w.r.t x of the neural network
-    d_net_out = elementwise_grad(neural_network,1)(P,x)
-
-    # Find the derivative w.r.t x of the trial function
-    d_g_t = elementwise_grad(g_trial,0)(x,P)
-
-    # The right side of the ODE
-    func = g(x, g_t)
-
-    err_sqr = (d_g_t - func)**2
-    cost_sum = np.sum(err_sqr)
-
-    return cost_sum / np.size(err_sqr)
-
-# Solve the exponential decay ODE using neural network with one input, hidden, and output layer
-def solve_ode_neural_network(x, num_neurons_hidden, num_iter, lmb):
-    ## Set up initial weights and biases
-
-    # For the hidden layer
-    p0 = npr.randn(num_neurons_hidden, 2 )
-
-    # For the output layer
-    p1 = npr.randn(1, num_neurons_hidden + 1 ) # +1 since bias is included
-
-    P = [p0, p1]
-
-    print('Initial cost: %g'%cost_function(P, x))
-
-    ## Start finding the optimal weights using gradient descent
-
-    # Find the Python function that represents the gradient of the cost function
-    # w.r.t the 0-th input argument -- that is the weights and biases in the hidden and output layer
-    cost_function_grad = grad(cost_function,0)
-
-    # Let the update be done num_iter times
-    for i in range(num_iter):
-        # Evaluate the gradient at the current weights and biases in P.
-        # The cost_grad consist now of two arrays;
-        # one for the gradient w.r.t P_hidden and
-        # one for the gradient w.r.t P_output
-        cost_grad =  cost_function_grad(P, x)
-
-        P[0] = P[0] - lmb * cost_grad[0]
-        P[1] = P[1] - lmb * cost_grad[1]
-
-    print('Final cost: %g'%cost_function(P, x))
-
-    return P
-
-def g_analytic(x, gamma = 2, g0 = 10):
-    return g0*np.exp(-gamma*x)
-
-# Solve the given problem
-if __name__ == '__main__':
-    # Set seed such that the weight are initialized
-    # with same weights and biases for every run.
-    npr.seed(15)
-
-    ## Decide the vales of arguments to the function to solve
-    N = 10
-    x = np.linspace(0, 1, N)
-
-    ## Set up the initial parameters
-    num_hidden_neurons = 10
-    num_iter = 10000
-    lmb = 0.001
-
-    # Use the network
-    P = solve_ode_neural_network(x, num_hidden_neurons, num_iter, lmb)
-
-    # Print the deviation from the trial solution and true solution
-    res = g_trial(x,P)
-    res_analytical = g_analytic(x)
-
-    print('Max absolute difference: %g'%np.max(np.abs(res - res_analytical)))
-
-    # Plot the results
-    plt.figure(figsize=(10,10))
-
-    plt.title('Performance of neural network solving an ODE compared to the analytical solution')
-    plt.plot(x, res_analytical)
-    plt.plot(x, res[0,:])
-    plt.legend(['analytical','nn'])
-    plt.xlabel('x')
-    plt.ylabel('g(x)')
-    plt.show()
-
-
-
-
-
Initial cost: 367.01
-
-
-
Final cost: 0.0666807
-Max absolute difference: 0.0437499
-
-
-_images/chapter11_47_2.png -
-
-
-
-

15.5. The network with one input layer, specified number of hidden layers, and one output layer

-

It is also possible to extend the construction of our network into a more general one, allowing the network to contain more than one hidden layers.

-

The number of neurons within each hidden layer are given as a list of integers in the program below.

-
-
-
import autograd.numpy as np
-from autograd import grad, elementwise_grad
-import autograd.numpy.random as npr
-from matplotlib import pyplot as plt
-
-def sigmoid(z):
-    return 1/(1 + np.exp(-z))
-
-# The neural network with one input layer and one output layer,
-# but with number of hidden layers specified by the user.
-def deep_neural_network(deep_params, x):
-    # N_hidden is the number of hidden layers
-
-    N_hidden = np.size(deep_params) - 1 # -1 since params consists of
-                                        # parameters to all the hidden
-                                        # layers AND the output layer.
-
-    # Assumes input x being an one-dimensional array
-    num_values = np.size(x)
-    x = x.reshape(-1, num_values)
-
-    # Assume that the input layer does nothing to the input x
-    x_input = x
-
-    # Due to multiple hidden layers, define a variable referencing to the
-    # output of the previous layer:
-    x_prev = x_input
-
-    ## Hidden layers:
-
-    for l in range(N_hidden):
-        # From the list of parameters P; find the correct weigths and bias for this layer
-        w_hidden = deep_params[l]
-
-        # Add a row of ones to include bias
-        x_prev = np.concatenate((np.ones((1,num_values)), x_prev ), axis = 0)
-
-        z_hidden = np.matmul(w_hidden, x_prev)
-        x_hidden = sigmoid(z_hidden)
-
-        # Update x_prev such that next layer can use the output from this layer
-        x_prev = x_hidden
-
-    ## Output layer:
-
-    # Get the weights and bias for this layer
-    w_output = deep_params[-1]
-
-    # Include bias:
-    x_prev = np.concatenate((np.ones((1,num_values)), x_prev), axis = 0)
-
-    z_output = np.matmul(w_output, x_prev)
-    x_output = z_output
-
-    return x_output
-
-# The trial solution using the deep neural network:
-def g_trial_deep(x,params, g0 = 10):
-    return g0 + x*deep_neural_network(params, x)
-
-# The right side of the ODE:
-def g(x, g_trial, gamma = 2):
-    return -gamma*g_trial
-
-# The same cost function as before, but calls deep_neural_network instead.
-def cost_function_deep(P, x):
-
-    # Evaluate the trial function with the current parameters P
-    g_t = g_trial_deep(x,P)
-
-    # Find the derivative w.r.t x of the neural network
-    d_net_out = elementwise_grad(deep_neural_network,1)(P,x)
-
-    # Find the derivative w.r.t x of the trial function
-    d_g_t = elementwise_grad(g_trial_deep,0)(x,P)
-
-    # The right side of the ODE
-    func = g(x, g_t)
-
-    err_sqr = (d_g_t - func)**2
-    cost_sum = np.sum(err_sqr)
-
-    return cost_sum / np.size(err_sqr)
-
-# Solve the exponential decay ODE using neural network with one input and one output layer,
-# but with specified number of hidden layers from the user.
-def solve_ode_deep_neural_network(x, num_neurons, num_iter, lmb):
-    # num_hidden_neurons is now a list of number of neurons within each hidden layer
-
-    # The number of elements in the list num_hidden_neurons thus represents
-    # the number of hidden layers.
-
-    # Find the number of hidden layers:
-    N_hidden = np.size(num_neurons)
-
-    ## Set up initial weights and biases
-
-    # Initialize the list of parameters:
-    P = [None]*(N_hidden + 1) # + 1 to include the output layer
-
-    P[0] = npr.randn(num_neurons[0], 2 )
-    for l in range(1,N_hidden):
-        P[l] = npr.randn(num_neurons[l], num_neurons[l-1] + 1) # +1 to include bias
-
-    # For the output layer
-    P[-1] = npr.randn(1, num_neurons[-1] + 1 ) # +1 since bias is included
-
-    print('Initial cost: %g'%cost_function_deep(P, x))
-
-    ## Start finding the optimal weights using gradient descent
-
-    # Find the Python function that represents the gradient of the cost function
-    # w.r.t the 0-th input argument -- that is the weights and biases in the hidden and output layer
-    cost_function_deep_grad = grad(cost_function_deep,0)
-
-    # Let the update be done num_iter times
-    for i in range(num_iter):
-        # Evaluate the gradient at the current weights and biases in P.
-        # The cost_grad consist now of N_hidden + 1 arrays; the gradient w.r.t the weights and biases
-        # in the hidden layers and output layers evaluated at x.
-        cost_deep_grad =  cost_function_deep_grad(P, x)
-
-        for l in range(N_hidden+1):
-            P[l] = P[l] - lmb * cost_deep_grad[l]
-
-    print('Final cost: %g'%cost_function_deep(P, x))
-
-    return P
-
-def g_analytic(x, gamma = 2, g0 = 10):
-    return g0*np.exp(-gamma*x)
-
-# Solve the given problem
-if __name__ == '__main__':
-    npr.seed(15)
-
-    ## Decide the vales of arguments to the function to solve
-    N = 10
-    x = np.linspace(0, 1, N)
-
-    ## Set up the initial parameters
-    num_hidden_neurons = np.array([10,10])
-    num_iter = 10000
-    lmb = 0.001
-
-    P = solve_ode_deep_neural_network(x, num_hidden_neurons, num_iter, lmb)
-
-    res = g_trial_deep(x,P)
-    res_analytical = g_analytic(x)
-
-    plt.figure(figsize=(10,10))
-
-    plt.title('Performance of a deep neural network solving an ODE compared to the analytical solution')
-    plt.plot(x, res_analytical)
-    plt.plot(x, res[0,:])
-    plt.legend(['analytical','dnn'])
-    plt.ylabel('g(x)')
-    plt.show()
-
-
-
-
-
Initial cost: 324.246
-
-
-
/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/numpy/core/_asarray.py:83: VisibleDeprecationWarning: Creating an ndarray from ragged nested sequences (which is a list-or-tuple of lists-or-tuples-or ndarrays with different lengths or shapes) is deprecated. If you meant to do this, you must specify 'dtype=object' when creating the ndarray
-  return array(a, dtype, copy=False, order=order)
-
-
-
Final cost: 0.119936
-
-
-_images/chapter11_49_3.png -
-
-
-

15.5.1. Example: Population growth

-

A logistic model of population growth assumes that a population converges toward an equilibrium. -The population growth can be modeled by

- -
-
-\[ -\begin{equation} \label{log} \tag{10} - g'(t) = \alpha g(t)(A - g(t)) -\end{equation} -\]
-

where \(g(t)\) is the population density at time \(t\), \(\alpha > 0\) the growth rate and \(A > 0\) is the maximum population number in the environment. -Also, at \(t = 0\) the population has the size \(g(0) = g_0\), where \(g_0\) is some chosen constant.

-

In this example, similar network as for the exponential decay using Autograd has been used to solve the equation. However, as the implementation might suffer from e.g numerical instability -and high execution time (this might be more apparent in the examples solving PDEs), -using a library like TensorFlow is recommended. -Here, we stay with a more simple approach and implement for comparison, the simple forward Euler method.

-

Here, we will model a population \(g(t)\) in an environment having carrying capacity \(A\). -The population follows the model

- -
-
-\[ -\begin{equation} \label{solveode_population} \tag{11} -g'(t) = \alpha g(t)(A - g(t)) -\end{equation} -\]
-

where \(g(0) = g_0\).

-

In this example, we let \(\alpha = 2\), \(A = 1\), and \(g_0 = 1.2\).

-

We will get a slightly different trial solution, as the boundary conditions are different -compared to the case for exponential decay.

-

A possible trial solution satisfying the condition \(g(0) = g_0\) could be

-
-\[ -h_1(t) = g_0 + t \cdot N(t,P) -\]
-

with \(N(t,P)\) being the output from the neural network with weights and biases for each layer collected in the set \(P\).

-

The analytical solution is

-
-\[ -g(t) = \frac{Ag_0}{g_0 + (A - g_0)\exp(-\alpha A t)} -\]
-

The network will be the similar as for the exponential decay example, but with some small modifications for our problem.

-
-
-
import autograd.numpy as np
-from autograd import grad, elementwise_grad
-import autograd.numpy.random as npr
-from matplotlib import pyplot as plt
-
-def sigmoid(z):
-    return 1/(1 + np.exp(-z))
-
-# Function to get the parameters.
-# Done such that one can easily change the paramaters after one's liking.
-def get_parameters():
-    alpha = 2
-    A = 1
-    g0 = 1.2
-    return alpha, A, g0
-
-def deep_neural_network(P, x):
-    # N_hidden is the number of hidden layers
-    N_hidden = np.size(P) - 1 # -1 since params consist of parameters to all the hidden layers AND the output layer
-
-    # Assumes input x being an one-dimensional array
-    num_values = np.size(x)
-    x = x.reshape(-1, num_values)
-
-    # Assume that the input layer does nothing to the input x
-    x_input = x
-
-    # Due to multiple hidden layers, define a variable referencing to the
-    # output of the previous layer:
-    x_prev = x_input
-
-    ## Hidden layers:
-
-    for l in range(N_hidden):
-        # From the list of parameters P; find the correct weigths and bias for this layer
-        w_hidden = P[l]
-
-        # Add a row of ones to include bias
-        x_prev = np.concatenate((np.ones((1,num_values)), x_prev ), axis = 0)
-
-        z_hidden = np.matmul(w_hidden, x_prev)
-        x_hidden = sigmoid(z_hidden)
-
-        # Update x_prev such that next layer can use the output from this layer
-        x_prev = x_hidden
-
-    ## Output layer:
-
-    # Get the weights and bias for this layer
-    w_output = P[-1]
-
-    # Include bias:
-    x_prev = np.concatenate((np.ones((1,num_values)), x_prev), axis = 0)
-
-    z_output = np.matmul(w_output, x_prev)
-    x_output = z_output
-
-    return x_output
-
-
-def cost_function_deep(P, x):
-
-    # Evaluate the trial function with the current parameters P
-    g_t = g_trial_deep(x,P)
-
-    # Find the derivative w.r.t x of the trial function
-    d_g_t = elementwise_grad(g_trial_deep,0)(x,P)
-
-    # The right side of the ODE
-    func = f(x, g_t)
-
-    err_sqr = (d_g_t - func)**2
-    cost_sum = np.sum(err_sqr)
-
-    return cost_sum / np.size(err_sqr)
-
-# The right side of the ODE:
-def f(x, g_trial):
-    alpha,A, g0 = get_parameters()
-    return alpha*g_trial*(A - g_trial)
-
-# The trial solution using the deep neural network:
-def g_trial_deep(x, params):
-    alpha,A, g0 = get_parameters()
-    return g0 + x*deep_neural_network(params,x)
-
-# The analytical solution:
-def g_analytic(t):
-    alpha,A, g0 = get_parameters()
-    return A*g0/(g0 + (A - g0)*np.exp(-alpha*A*t))
-
-def solve_ode_deep_neural_network(x, num_neurons, num_iter, lmb):
-    # num_hidden_neurons is now a list of number of neurons within each hidden layer
-
-    # Find the number of hidden layers:
-    N_hidden = np.size(num_neurons)
-
-    ## Set up initial weigths and biases
-
-    # Initialize the list of parameters:
-    P = [None]*(N_hidden + 1) # + 1 to include the output layer
-
-    P[0] = npr.randn(num_neurons[0], 2 )
-    for l in range(1,N_hidden):
-        P[l] = npr.randn(num_neurons[l], num_neurons[l-1] + 1) # +1 to include bias
-
-    # For the output layer
-    P[-1] = npr.randn(1, num_neurons[-1] + 1 ) # +1 since bias is included
-
-    print('Initial cost: %g'%cost_function_deep(P, x))
-
-    ## Start finding the optimal weigths using gradient descent
-
-    # Find the Python function that represents the gradient of the cost function
-    # w.r.t the 0-th input argument -- that is the weights and biases in the hidden and output layer
-    cost_function_deep_grad = grad(cost_function_deep,0)
-
-    # Let the update be done num_iter times
-    for i in range(num_iter):
-        # Evaluate the gradient at the current weights and biases in P.
-        # The cost_grad consist now of N_hidden + 1 arrays; the gradient w.r.t the weights and biases
-        # in the hidden layers and output layers evaluated at x.
-        cost_deep_grad =  cost_function_deep_grad(P, x)
-
-        for l in range(N_hidden+1):
-            P[l] = P[l] - lmb * cost_deep_grad[l]
-
-    print('Final cost: %g'%cost_function_deep(P, x))
-
-    return P
-
-if __name__ == '__main__':
-    npr.seed(4155)
-
-    ## Decide the vales of arguments to the function to solve
-    Nt = 10
-    T = 1
-    t = np.linspace(0,T, Nt)
-
-    ## Set up the initial parameters
-    num_hidden_neurons = [100, 50, 25]
-    num_iter = 1000
-    lmb = 1e-3
-
-    P = solve_ode_deep_neural_network(t, num_hidden_neurons, num_iter, lmb)
-
-    g_dnn_ag = g_trial_deep(t,P)
-    g_analytical = g_analytic(t)
-
-    # Find the maximum absolute difference between the solutons:
-    diff_ag = np.max(np.abs(g_dnn_ag - g_analytical))
-    print("The max absolute difference between the solutions is: %g"%diff_ag)
-
-    plt.figure(figsize=(10,10))
-
-    plt.title('Performance of neural network solving an ODE compared to the analytical solution')
-    plt.plot(t, g_analytical)
-    plt.plot(t, g_dnn_ag[0,:])
-    plt.legend(['analytical','nn'])
-    plt.xlabel('t')
-    plt.ylabel('g(t)')
-
-    plt.show()
-
-
-
-
-
Initial cost: 0.221805
-
-
-
/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/numpy/core/_asarray.py:83: VisibleDeprecationWarning: Creating an ndarray from ragged nested sequences (which is a list-or-tuple of lists-or-tuples-or ndarrays with different lengths or shapes) is deprecated. If you meant to do this, you must specify 'dtype=object' when creating the ndarray
-  return array(a, dtype, copy=False, order=order)
-
-
-
Final cost: 0.000417932
-The max absolute difference between the solutions is: 0.00424909
-
-
-_images/chapter11_55_3.png -
-
-
-
-
-

15.6. Using forward Euler to solve the ODE

-

A straightforward way of solving an ODE numerically, is to use Euler’s method.

-

Euler’s method uses Taylor series to approximate the value at a function \(f\) at a step \(\Delta x\) from \(x\):

-
-\[ -f(x + \Delta x) \approx f(x) + \Delta x f'(x) -\]
-

In our case, using Euler’s method to approximate the value of \(g\) at a step \(\Delta t\) from \(t\) yields

-
-\[\begin{split} -\begin{aligned} - g(t + \Delta t) &\approx g(t) + \Delta t g'(t) \\ - &= g(t) + \Delta t \big(\alpha g(t)(A - g(t))\big) -\end{aligned} -\end{split}\]
-

along with the condition that \(g(0) = g_0\).

-

Let \(t_i = i \cdot \Delta t\) where \(\Delta t = \frac{T}{N_t-1}\) where \(T\) is the final time our solver must solve for and \(N_t\) the number of values for \(t \in [0, T]\) for \(i = 0, \dots, N_t-1\).

-

For \(i \geq 1\), we have that

-
-\[\begin{split} -\begin{aligned} -t_i &= i\Delta t \\ -&= (i - 1)\Delta t + \Delta t \\ -&= t_{i-1} + \Delta t -\end{aligned} -\end{split}\]
-

Now, if \(g_i = g(t_i)\) then

- -
-
-\[\begin{split} -\begin{equation} - \begin{aligned} - g_i &= g(t_i) \\ - &= g(t_{i-1} + \Delta t) \\ - &\approx g(t_{i-1}) + \Delta t \big(\alpha g(t_{i-1})(A - g(t_{i-1}))\big) \\ - &= g_{i-1} + \Delta t \big(\alpha g_{i-1}(A - g_{i-1})\big) - \end{aligned} -\end{equation} \label{odenum} \tag{12} -\end{split}\]
-

for \(i \geq 1\) and \(g_0 = g(t_0) = g(0) = g_0\).

-

Equation (12) could be implemented in the following way, -extending the program that uses the network using Autograd:

-
-
-
# Assume that all function definitions from the example program using Autograd
-# are located here.
-
-if __name__ == '__main__':
-    npr.seed(4155)
-
-    ## Decide the vales of arguments to the function to solve
-    Nt = 10
-    T = 1
-    t = np.linspace(0,T, Nt)
-
-    ## Set up the initial parameters
-    num_hidden_neurons = [100,50,25]
-    num_iter = 1000
-    lmb = 1e-3
-
-    P = solve_ode_deep_neural_network(t, num_hidden_neurons, num_iter, lmb)
-
-    g_dnn_ag = g_trial_deep(t,P)
-    g_analytical = g_analytic(t)
-
-    # Find the maximum absolute difference between the solutons:
-    diff_ag = np.max(np.abs(g_dnn_ag - g_analytical))
-    print("The max absolute difference between the solutions is: %g"%diff_ag)
-
-    plt.figure(figsize=(10,10))
-
-    plt.title('Performance of neural network solving an ODE compared to the analytical solution')
-    plt.plot(t, g_analytical)
-    plt.plot(t, g_dnn_ag[0,:])
-    plt.legend(['analytical','nn'])
-    plt.xlabel('t')
-    plt.ylabel('g(t)')
-
-    ## Find an approximation to the funtion using forward Euler
-
-    alpha, A, g0 = get_parameters()
-    dt = T/(Nt - 1)
-
-    # Perform forward Euler to solve the ODE
-    g_euler = np.zeros(Nt)
-    g_euler[0] = g0
-
-    for i in range(1,Nt):
-        g_euler[i] = g_euler[i-1] + dt*(alpha*g_euler[i-1]*(A - g_euler[i-1]))
-
-    # Print the errors done by each method
-    diff1 = np.max(np.abs(g_euler - g_analytical))
-    diff2 = np.max(np.abs(g_dnn_ag[0,:] - g_analytical))
-
-    print('Max absolute difference between Euler method and analytical: %g'%diff1)
-    print('Max absolute difference between deep neural network and analytical: %g'%diff2)
-
-    # Plot results
-    plt.figure(figsize=(10,10))
-
-    plt.plot(t,g_euler)
-    plt.plot(t,g_analytical)
-    plt.plot(t,g_dnn_ag[0,:])
-
-    plt.legend(['euler','analytical','dnn'])
-    plt.xlabel('Time t')
-    plt.ylabel('g(t)')
-
-    plt.show()
-
-
-
-
-
Initial cost: 0.221805
-
-
-
/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/numpy/core/_asarray.py:83: VisibleDeprecationWarning: Creating an ndarray from ragged nested sequences (which is a list-or-tuple of lists-or-tuples-or ndarrays with different lengths or shapes) is deprecated. If you meant to do this, you must specify 'dtype=object' when creating the ndarray
-  return array(a, dtype, copy=False, order=order)
-
-
-
Final cost: 0.000417932
-The max absolute difference between the solutions is: 0.00424909
-Max absolute difference between Euler method and analytical: 0.011225
-Max absolute difference between deep neural network and analytical: 0.00424909
-
-
-_images/chapter11_63_3.png -_images/chapter11_63_4.png -
-
-
-
-

15.7. Solving the one dimensional Poisson equation

-

The Poisson equation for \(g(x)\) in one dimension is

- -
-
-\[ -\begin{equation} \label{poisson} \tag{13} - -g''(x) = f(x) -\end{equation} -\]
-

where \(f(x)\) is a given function for \(x \in (0,1)\).

-

The conditions that \(g(x)\) is chosen to fulfill, are

-
-\[\begin{split} -\begin{align*} - g(0) &= 0 \\ - g(1) &= 0 -\end{align*} -\end{split}\]
-

This equation can be solved numerically using programs where e.g Autograd and TensorFlow are used. -The results from the networks can then be compared to the analytical solution. -In addition, it could be interesting to see how a typical method for numerically solving second order ODEs compares to the neural networks.

-

Here, the function \(g(x)\) to solve for follows the equation

-
-\[ --g''(x) = f(x),\qquad x \in (0,1) -\]
-

where \(f(x)\) is a given function, along with the chosen conditions

- -
-
-\[ -\begin{aligned} -g(0) = g(1) = 0 -\end{aligned}\label{cond} \tag{14} -\]
-

In this example, we consider the case when \(f(x) = (3x + x^2)\exp(x)\).

-

For this case, a possible trial solution satisfying the conditions could be

-
-\[ -g_t(x) = x \cdot (1-x) \cdot N(P,x) -\]
-

The analytical solution for this problem is

-
-\[ -g(x) = x(1 - x)\exp(x) -\]
-
-
-
import autograd.numpy as np
-from autograd import grad, elementwise_grad
-import autograd.numpy.random as npr
-from matplotlib import pyplot as plt
-
-def sigmoid(z):
-    return 1/(1 + np.exp(-z))
-
-def deep_neural_network(deep_params, x):
-    # N_hidden is the number of hidden layers
-    N_hidden = np.size(deep_params) - 1 # -1 since params consist of parameters to all the hidden layers AND the output layer
-
-    # Assumes input x being an one-dimensional array
-    num_values = np.size(x)
-    x = x.reshape(-1, num_values)
-
-    # Assume that the input layer does nothing to the input x
-    x_input = x
-
-    # Due to multiple hidden layers, define a variable referencing to the
-    # output of the previous layer:
-    x_prev = x_input
-
-    ## Hidden layers:
-
-    for l in range(N_hidden):
-        # From the list of parameters P; find the correct weigths and bias for this layer
-        w_hidden = deep_params[l]
-
-        # Add a row of ones to include bias
-        x_prev = np.concatenate((np.ones((1,num_values)), x_prev ), axis = 0)
-
-        z_hidden = np.matmul(w_hidden, x_prev)
-        x_hidden = sigmoid(z_hidden)
-
-        # Update x_prev such that next layer can use the output from this layer
-        x_prev = x_hidden
-
-    ## Output layer:
-
-    # Get the weights and bias for this layer
-    w_output = deep_params[-1]
-
-    # Include bias:
-    x_prev = np.concatenate((np.ones((1,num_values)), x_prev), axis = 0)
-
-    z_output = np.matmul(w_output, x_prev)
-    x_output = z_output
-
-    return x_output
-
-def solve_ode_deep_neural_network(x, num_neurons, num_iter, lmb):
-    # num_hidden_neurons is now a list of number of neurons within each hidden layer
-
-    # Find the number of hidden layers:
-    N_hidden = np.size(num_neurons)
-
-    ## Set up initial weigths and biases
-
-    # Initialize the list of parameters:
-    P = [None]*(N_hidden + 1) # + 1 to include the output layer
-
-    P[0] = npr.randn(num_neurons[0], 2 )
-    for l in range(1,N_hidden):
-        P[l] = npr.randn(num_neurons[l], num_neurons[l-1] + 1) # +1 to include bias
-
-    # For the output layer
-    P[-1] = npr.randn(1, num_neurons[-1] + 1 ) # +1 since bias is included
-
-    print('Initial cost: %g'%cost_function_deep(P, x))
-
-    ## Start finding the optimal weigths using gradient descent
-
-    # Find the Python function that represents the gradient of the cost function
-    # w.r.t the 0-th input argument -- that is the weights and biases in the hidden and output layer
-    cost_function_deep_grad = grad(cost_function_deep,0)
-
-    # Let the update be done num_iter times
-    for i in range(num_iter):
-        # Evaluate the gradient at the current weights and biases in P.
-        # The cost_grad consist now of N_hidden + 1 arrays; the gradient w.r.t the weights and biases
-        # in the hidden layers and output layers evaluated at x.
-        cost_deep_grad =  cost_function_deep_grad(P, x)
-
-        for l in range(N_hidden+1):
-            P[l] = P[l] - lmb * cost_deep_grad[l]
-
-    print('Final cost: %g'%cost_function_deep(P, x))
-
-    return P
-
-## Set up the cost function specified for this Poisson equation:
-
-# The right side of the ODE
-def f(x):
-    return (3*x + x**2)*np.exp(x)
-
-def cost_function_deep(P, x):
-
-    # Evaluate the trial function with the current parameters P
-    g_t = g_trial_deep(x,P)
-
-    # Find the derivative w.r.t x of the trial function
-    d2_g_t = elementwise_grad(elementwise_grad(g_trial_deep,0))(x,P)
-
-    right_side = f(x)
-
-    err_sqr = (-d2_g_t - right_side)**2
-    cost_sum = np.sum(err_sqr)
-
-    return cost_sum/np.size(err_sqr)
-
-# The trial solution:
-def g_trial_deep(x,P):
-    return x*(1-x)*deep_neural_network(P,x)
-
-# The analytic solution;
-def g_analytic(x):
-    return x*(1-x)*np.exp(x)
-
-if __name__ == '__main__':
-    npr.seed(4155)
-
-    ## Decide the vales of arguments to the function to solve
-    Nx = 10
-    x = np.linspace(0,1, Nx)
-
-    ## Set up the initial parameters
-    num_hidden_neurons = [200,100]
-    num_iter = 1000
-    lmb = 1e-3
-
-    P = solve_ode_deep_neural_network(x, num_hidden_neurons, num_iter, lmb)
-
-    g_dnn_ag = g_trial_deep(x,P)
-    g_analytical = g_analytic(x)
-
-    # Find the maximum absolute difference between the solutons:
-    max_diff = np.max(np.abs(g_dnn_ag - g_analytical))
-    print("The max absolute difference between the solutions is: %g"%max_diff)
-
-    plt.figure(figsize=(10,10))
-
-    plt.title('Performance of neural network solving an ODE compared to the analytical solution')
-    plt.plot(x, g_analytical)
-    plt.plot(x, g_dnn_ag[0,:])
-    plt.legend(['analytical','nn'])
-    plt.xlabel('x')
-    plt.ylabel('g(x)')
-    plt.show()
-
-
-
-
-
/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/numpy/core/_asarray.py:83: VisibleDeprecationWarning: Creating an ndarray from ragged nested sequences (which is a list-or-tuple of lists-or-tuples-or ndarrays with different lengths or shapes) is deprecated. If you meant to do this, you must specify 'dtype=object' when creating the ndarray
-  return array(a, dtype, copy=False, order=order)
-
-
-
Initial cost: 457.256
-
-
-
Final cost: 0.00310113
-The max absolute difference between the solutions is: 0.000464088
-
-
-_images/chapter11_76_3.png -
-
-
-

15.7.1. Comparing with a numerical scheme

-

The Poisson equation is possible to solve using Taylor series to approximate the second derivative.

-

Using Taylor series, the second derivative can be expressed as

-
-\[ -g''(x) = \frac{g(x + \Delta x) - 2g(x) + g(x-\Delta x)}{\Delta x^2} + E_{\Delta x}(x) -\]
-

where \(\Delta x\) is a small step size and \(E_{\Delta x}(x)\) being the error term.

-

Looking away from the error terms gives an approximation to the second derivative:

- -
-
-\[ -\begin{equation} \label{approx} \tag{15} -g''(x) \approx \frac{g(x + \Delta x) - 2g(x) + g(x-\Delta x)}{\Delta x^2} -\end{equation} -\]
-

If \(x_i = i \Delta x = x_{i-1} + \Delta x\) and \(g_i = g(x_i)\) for \(i = 1,\dots N_x - 2\) with \(N_x\) being the number of values for \(x\), (15) becomes

-
-\[\begin{split} -\begin{aligned} -g''(x_i) &\approx \frac{g(x_i + \Delta x) - 2g(x_i) + g(x_i -\Delta x)}{\Delta x^2} \\ -&= \frac{g_{i+1} - 2g_i + g_{i-1}}{\Delta x^2} -\end{aligned} -\end{split}\]
-

Since we know from our problem that

-
-\[\begin{split} -\begin{aligned} --g''(x) &= f(x) \\ -&= (3x + x^2)\exp(x) -\end{aligned} -\end{split}\]
-

along with the conditions \(g(0) = g(1) = 0\), -the following scheme can be used to find an approximate solution for \(g(x)\) numerically:

- -
-
-\[\begin{split} -\begin{equation} - \begin{aligned} - -\Big( \frac{g_{i+1} - 2g_i + g_{i-1}}{\Delta x^2} \Big) &= f(x_i) \\ - -g_{i+1} + 2g_i - g_{i-1} &= \Delta x^2 f(x_i) - \end{aligned} -\end{equation} \label{odesys} \tag{16} -\end{split}\]
-

for \(i = 1, \dots, N_x - 2\) where \(g_0 = g_{N_x - 1} = 0\) and \(f(x_i) = (3x_i + x_i^2)\exp(x_i)\), which is given for our specific problem.

-

The equation can be rewritten into a matrix equation:

-
-\[\begin{split} -\begin{aligned} -\begin{pmatrix} -2 & -1 & 0 & \dots & 0 \\ --1 & 2 & -1 & \dots & 0 \\ -\vdots & & \ddots & & \vdots \\ -0 & \dots & -1 & 2 & -1 \\ -0 & \dots & 0 & -1 & 2\\ -\end{pmatrix} -\begin{pmatrix} -g_1 \\ -g_2 \\ -\vdots \\ -g_{N_x - 3} \\ -g_{N_x - 2} -\end{pmatrix} -&= -\Delta x^2 -\begin{pmatrix} -f(x_1) \\ -f(x_2) \\ -\vdots \\ -f(x_{N_x - 3}) \\ -f(x_{N_x - 2}) -\end{pmatrix} \\ -\boldsymbol{A}\boldsymbol{g} &= \boldsymbol{f}, -\end{aligned} -\end{split}\]
-

which makes it possible to solve for the vector \(\boldsymbol{g}\).

-

We can then compare the result from this numerical scheme with the output from our network using Autograd:

-
-
-
import autograd.numpy as np
-from autograd import grad, elementwise_grad
-import autograd.numpy.random as npr
-from matplotlib import pyplot as plt
-
-def sigmoid(z):
-    return 1/(1 + np.exp(-z))
-
-def deep_neural_network(deep_params, x):
-    # N_hidden is the number of hidden layers
-    N_hidden = np.size(deep_params) - 1 # -1 since params consist of parameters to all the hidden layers AND the output layer
-
-    # Assumes input x being an one-dimensional array
-    num_values = np.size(x)
-    x = x.reshape(-1, num_values)
-
-    # Assume that the input layer does nothing to the input x
-    x_input = x
-
-    # Due to multiple hidden layers, define a variable referencing to the
-    # output of the previous layer:
-    x_prev = x_input
-
-    ## Hidden layers:
-
-    for l in range(N_hidden):
-        # From the list of parameters P; find the correct weigths and bias for this layer
-        w_hidden = deep_params[l]
-
-        # Add a row of ones to include bias
-        x_prev = np.concatenate((np.ones((1,num_values)), x_prev ), axis = 0)
-
-        z_hidden = np.matmul(w_hidden, x_prev)
-        x_hidden = sigmoid(z_hidden)
-
-        # Update x_prev such that next layer can use the output from this layer
-        x_prev = x_hidden
-
-    ## Output layer:
-
-    # Get the weights and bias for this layer
-    w_output = deep_params[-1]
-
-    # Include bias:
-    x_prev = np.concatenate((np.ones((1,num_values)), x_prev), axis = 0)
-
-    z_output = np.matmul(w_output, x_prev)
-    x_output = z_output
-
-    return x_output
-
-def solve_ode_deep_neural_network(x, num_neurons, num_iter, lmb):
-    # num_hidden_neurons is now a list of number of neurons within each hidden layer
-
-    # Find the number of hidden layers:
-    N_hidden = np.size(num_neurons)
-
-    ## Set up initial weigths and biases
-
-    # Initialize the list of parameters:
-    P = [None]*(N_hidden + 1) # + 1 to include the output layer
-
-    P[0] = npr.randn(num_neurons[0], 2 )
-    for l in range(1,N_hidden):
-        P[l] = npr.randn(num_neurons[l], num_neurons[l-1] + 1) # +1 to include bias
-
-    # For the output layer
-    P[-1] = npr.randn(1, num_neurons[-1] + 1 ) # +1 since bias is included
-
-    print('Initial cost: %g'%cost_function_deep(P, x))
-
-    ## Start finding the optimal weigths using gradient descent
-
-    # Find the Python function that represents the gradient of the cost function
-    # w.r.t the 0-th input argument -- that is the weights and biases in the hidden and output layer
-    cost_function_deep_grad = grad(cost_function_deep,0)
-
-    # Let the update be done num_iter times
-    for i in range(num_iter):
-        # Evaluate the gradient at the current weights and biases in P.
-        # The cost_grad consist now of N_hidden + 1 arrays; the gradient w.r.t the weights and biases
-        # in the hidden layers and output layers evaluated at x.
-        cost_deep_grad =  cost_function_deep_grad(P, x)
-
-        for l in range(N_hidden+1):
-            P[l] = P[l] - lmb * cost_deep_grad[l]
-
-    print('Final cost: %g'%cost_function_deep(P, x))
-
-    return P
-
-## Set up the cost function specified for this Poisson equation:
-
-# The right side of the ODE
-def f(x):
-    return (3*x + x**2)*np.exp(x)
-
-def cost_function_deep(P, x):
-
-    # Evaluate the trial function with the current parameters P
-    g_t = g_trial_deep(x,P)
-
-    # Find the derivative w.r.t x of the trial function
-    d2_g_t = elementwise_grad(elementwise_grad(g_trial_deep,0))(x,P)
-
-    right_side = f(x)
-
-    err_sqr = (-d2_g_t - right_side)**2
-    cost_sum = np.sum(err_sqr)
-
-    return cost_sum/np.size(err_sqr)
-
-# The trial solution:
-def g_trial_deep(x,P):
-    return x*(1-x)*deep_neural_network(P,x)
-
-# The analytic solution;
-def g_analytic(x):
-    return x*(1-x)*np.exp(x)
-
-if __name__ == '__main__':
-    npr.seed(4155)
-
-    ## Decide the vales of arguments to the function to solve
-    Nx = 10
-    x = np.linspace(0,1, Nx)
-
-    ## Set up the initial parameters
-    num_hidden_neurons = [200,100]
-    num_iter = 1000
-    lmb = 1e-3
-
-    P = solve_ode_deep_neural_network(x, num_hidden_neurons, num_iter, lmb)
-
-    g_dnn_ag = g_trial_deep(x,P)
-    g_analytical = g_analytic(x)
-
-    # Find the maximum absolute difference between the solutons:
-
-    plt.figure(figsize=(10,10))
-
-    plt.title('Performance of neural network solving an ODE compared to the analytical solution')
-    plt.plot(x, g_analytical)
-    plt.plot(x, g_dnn_ag[0,:])
-    plt.legend(['analytical','nn'])
-    plt.xlabel('x')
-    plt.ylabel('g(x)')
-
-    ## Perform the computation using the numerical scheme
-
-    dx = 1/(Nx - 1)
-
-    # Set up the matrix A
-    A = np.zeros((Nx-2,Nx-2))
-
-    A[0,0] = 2
-    A[0,1] = -1
-
-    for i in range(1,Nx-3):
-        A[i,i-1] = -1
-        A[i,i] = 2
-        A[i,i+1] = -1
-
-    A[Nx - 3, Nx - 4] = -1
-    A[Nx - 3, Nx - 3] = 2
-
-    # Set up the vector f
-    f_vec = dx**2 * f(x[1:-1])
-
-    # Solve the equation
-    g_res = np.linalg.solve(A,f_vec)
-
-    g_vec = np.zeros(Nx)
-    g_vec[1:-1] = g_res
-
-    # Print the differences between each method
-    max_diff1 = np.max(np.abs(g_dnn_ag - g_analytical))
-    max_diff2 = np.max(np.abs(g_vec - g_analytical))
-    print("The max absolute difference between the analytical solution and DNN Autograd: %g"%max_diff1)
-    print("The max absolute difference between the analytical solution and numerical scheme: %g"%max_diff2)
-
-    # Plot the results
-    plt.figure(figsize=(10,10))
-
-    plt.plot(x,g_vec)
-    plt.plot(x,g_analytical)
-    plt.plot(x,g_dnn_ag[0,:])
-
-    plt.legend(['numerical scheme','analytical','dnn'])
-    plt.show()
-
-
-
-
-
Initial cost: 457.256
-
-
-
/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/numpy/core/_asarray.py:83: VisibleDeprecationWarning: Creating an ndarray from ragged nested sequences (which is a list-or-tuple of lists-or-tuples-or ndarrays with different lengths or shapes) is deprecated. If you meant to do this, you must specify 'dtype=object' when creating the ndarray
-  return array(a, dtype, copy=False, order=order)
-
-
-
Final cost: 0.00310113
-The max absolute difference between the analytical solution and DNN Autograd: 0.000464088
-The max absolute difference between the analytical solution and numerical scheme: 0.00266858
-
-
-_images/chapter11_88_3.png -_images/chapter11_88_4.png -
-
-
-
-
-

15.8. Partial Differential Equations

-

A partial differential equation (PDE) has a solution here the function -is defined by multiple variables. The equation may involve all kinds -of combinations of which variables the function is differentiated with -respect to.

-

In general, a partial differential equation for a function \(g(x_1,\dots,x_N)\) with \(N\) variables may be expressed as

- -
-
-\[ -\begin{equation} \label{PDE} \tag{17} - f\left(x_1, \, \dots \, , x_N, \frac{\partial g(x_1,\dots,x_N) }{\partial x_1}, \dots , \frac{\partial g(x_1,\dots,x_N) }{\partial x_N}, \frac{\partial g(x_1,\dots,x_N) }{\partial x_1\partial x_2}, \, \dots \, , \frac{\partial^n g(x_1,\dots,x_N) }{\partial x_N^n} \right) = 0 -\end{equation} -\]
-

where \(f\) is an expression involving all kinds of possible mixed derivatives of \(g(x_1,\dots,x_N)\) up to an order \(n\). In order for the solution to be unique, some additional conditions must also be given.

-
-

15.8.1. Type of problem

-

The problem our network must solve for, is similar to the ODE case. -We must have a trial solution \(g_t\) at hand.

-

For instance, the trial solution could be expressed as

-
-\[ -\begin{align*} - g_t(x_1,\dots,x_N) = h_1(x_1,\dots,x_N) + h_2(x_1,\dots,x_N,N(x_1,\dots,x_N,P)) -\end{align*} -\]
-

where \(h_1(x_1,\dots,x_N)\) is a function that ensures \(g_t(x_1,\dots,x_N)\) satisfies some given conditions. -The neural network \(N(x_1,\dots,x_N,P)\) has weights and biases described by \(P\) and \(h_2(x_1,\dots,x_N,N(x_1,\dots,x_N,P))\) is an expression using the output from the neural network in some way.

-

The role of the function \(h_2(x_1,\dots,x_N,N(x_1,\dots,x_N,P))\), is to ensure that the output of \(N(x_1,\dots,x_N,P)\) is zero when \(g_t(x_1,\dots,x_N)\) is evaluated at the values of \(x_1,\dots,x_N\) where the given conditions must be satisfied. The function \(h_1(x_1,\dots,x_N)\) should alone make \(g_t(x_1,\dots,x_N)\) satisfy the conditions.

-
-
-

15.8.2. Network requirements

-

The network tries then the minimize the cost function following the -same ideas as described for the ODE case, but now with more than one -variables to consider. The concept still remains the same; find a set -of parameters \(P\) such that the expression \(f\) in (17) is as -close to zero as possible.

-

As for the ODE case, the cost function is the mean squared error that -the network must try to minimize. The cost function for the network to -minimize is

-
-\[ -C\left(x_1, \dots, x_N, P\right) = \left( f\left(x_1, \, \dots \, , x_N, \frac{\partial g(x_1,\dots,x_N) }{\partial x_1}, \dots , \frac{\partial g(x_1,\dots,x_N) }{\partial x_N}, \frac{\partial g(x_1,\dots,x_N) }{\partial x_1\partial x_2}, \, \dots \, , \frac{\partial^n g(x_1,\dots,x_N) }{\partial x_N^n} \right) \right)^2 -\]
-

If we let \(\boldsymbol{x} = \big( x_1, \dots, x_N \big)\) be an array containing the values for \(x_1, \dots, x_N\) respectively, the cost function can be reformulated into the following:

-
-\[ -C\left(\boldsymbol{x}, P\right) = f\left( \left( \boldsymbol{x}, \frac{\partial g(\boldsymbol{x}) }{\partial x_1}, \dots , \frac{\partial g(\boldsymbol{x}) }{\partial x_N}, \frac{\partial g(\boldsymbol{x}) }{\partial x_1\partial x_2}, \, \dots \, , \frac{\partial^n g(\boldsymbol{x}) }{\partial x_N^n} \right) \right)^2 -\]
-

If we also have \(M\) different sets of values for \(x_1, \dots, x_N\), that is \(\boldsymbol{x}_i = \big(x_1^{(i)}, \dots, x_N^{(i)}\big)\) for \(i = 1,\dots,M\) being the rows in matrix \(X\), the cost function can be generalized into

-
-\[ -C\left(X, P \right) = \sum_{i=1}^M f\left( \left( \boldsymbol{x}_i, \frac{\partial g(\boldsymbol{x}_i) }{\partial x_1}, \dots , \frac{\partial g(\boldsymbol{x}_i) }{\partial x_N}, \frac{\partial g(\boldsymbol{x}_i) }{\partial x_1\partial x_2}, \, \dots \, , \frac{\partial^n g(\boldsymbol{x}_i) }{\partial x_N^n} \right) \right)^2. -\]
-
-
-
-

15.9. Example: The diffusion equation

-

In one spatial dimension, the equation reads

-
-\[ -\frac{\partial g(x,t)}{\partial t} = \frac{\partial^2 g(x,t)}{\partial x^2} -\]
-

where a possible choice of conditions are

-
-\[\begin{split} -\begin{align*} -g(0,t) &= 0 ,\qquad t \geq 0 \\ -g(1,t) &= 0, \qquad t \geq 0 \\ -g(x,0) &= u(x),\qquad x\in [0,1] -\end{align*} -\end{split}\]
-

with \(u(x)\) being some given function.

-

For this case, we want to find \(g(x,t)\) such that

- -
-
-\[ -\begin{equation} - \frac{\partial g(x,t)}{\partial t} = \frac{\partial^2 g(x,t)}{\partial x^2} -\end{equation} \label{diffonedim} \tag{18} -\]
-

and

-
-\[\begin{split} -\begin{align*} -g(0,t) &= 0 ,\qquad t \geq 0 \\ -g(1,t) &= 0, \qquad t \geq 0 \\ -g(x,0) &= u(x),\qquad x\in [0,1] -\end{align*} -\end{split}\]
-

with \(u(x) = \sin(\pi x)\).

-

First, let us set up the deep neural network. -The deep neural network will follow the same structure as discussed in the examples solving the ODEs. -First, we will look into how Autograd could be used in a network tailored to solve for bivariate functions.

-

The only change to do here, is to extend our network such that -functions of multiple parameters are correctly handled. In this case -we have two variables in our function to solve for, that is time \(t\) -and position \(x\). The variables will be represented by a -one-dimensional array in the program. The program will evaluate the -network at each possible pair \((x,t)\), given an array for the desired -\(x\)-values and \(t\)-values to approximate the solution at.

-
-
-
def sigmoid(z):
-    return 1/(1 + np.exp(-z))
-
-def deep_neural_network(deep_params, x):
-    # x is now a point and a 1D numpy array; make it a column vector
-    num_coordinates = np.size(x,0)
-    x = x.reshape(num_coordinates,-1)
-
-    num_points = np.size(x,1)
-
-    # N_hidden is the number of hidden layers
-    N_hidden = np.size(deep_params) - 1 # -1 since params consist of parameters to all the hidden layers AND the output layer
-
-    # Assume that the input layer does nothing to the input x
-    x_input = x
-    x_prev = x_input
-
-    ## Hidden layers:
-
-    for l in range(N_hidden):
-        # From the list of parameters P; find the correct weigths and bias for this layer
-        w_hidden = deep_params[l]
-
-        # Add a row of ones to include bias
-        x_prev = np.concatenate((np.ones((1,num_points)), x_prev ), axis = 0)
-
-        z_hidden = np.matmul(w_hidden, x_prev)
-        x_hidden = sigmoid(z_hidden)
-
-        # Update x_prev such that next layer can use the output from this layer
-        x_prev = x_hidden
-
-    ## Output layer:
-
-    # Get the weights and bias for this layer
-    w_output = deep_params[-1]
-
-    # Include bias:
-    x_prev = np.concatenate((np.ones((1,num_points)), x_prev), axis = 0)
-
-    z_output = np.matmul(w_output, x_prev)
-    x_output = z_output
-
-    return x_output[0][0]
-
-
-
-
-

The cost function must then iterate through the given arrays -containing values for \(x\) and \(t\), defines a point \((x,t)\) the deep -neural network and the trial solution is evaluated at, and then finds -the Jacobian of the trial solution.

-

A possible trial solution for this PDE is

-
-\[ -g_t(x,t) = h_1(x,t) + x(1-x)tN(x,t,P) -\]
-

with \(A(x,t)\) being a function ensuring that \(g_t(x,t)\) satisfies our given conditions, and \(N(x,t,P)\) being the output from the deep neural network using weights and biases for each layer from \(P\).

-

To fulfill the conditions, \(A(x,t)\) could be:

-
-\[ -h_1(x,t) = (1-t)\Big(u(x) - \big((1-x)u(0) + x u(1)\big)\Big) = (1-t)u(x) = (1-t)\sin(\pi x) -\]
-

since \((0) = u(1) = 0\) and \(u(x) = \sin(\pi x)\).

-

The Jacobian is used because the program must find the derivative of -the trial solution with respect to \(x\) and \(t\).

-

This gives the necessity of computing the Jacobian matrix, as we want -to evaluate the gradient with respect to \(x\) and \(t\) (note that the -Jacobian of a scalar-valued multivariate function is simply its -gradient).

-

In Autograd, the differentiation is by default done with respect to -the first input argument of your Python function. Since the points is -an array representing \(x\) and \(t\), the Jacobian is calculated using -the values of \(x\) and \(t\).

-

To find the second derivative with respect to \(x\) and \(t\), the -Jacobian can be found for the second time. The result is a Hessian -matrix, which is the matrix containing all the possible second order -mixed derivatives of \(g(x,t)\).

-
-
-
# Set up the trial function:
-def u(x):
-    return np.sin(np.pi*x)
-
-def g_trial(point,P):
-    x,t = point
-    return (1-t)*u(x) + x*(1-x)*t*deep_neural_network(P,point)
-
-# The right side of the ODE:
-def f(point):
-    return 0.
-
-# The cost function:
-def cost_function(P, x, t):
-    cost_sum = 0
-
-    g_t_jacobian_func = jacobian(g_trial)
-    g_t_hessian_func = hessian(g_trial)
-
-    for x_ in x:
-        for t_ in t:
-            point = np.array([x_,t_])
-
-            g_t = g_trial(point,P)
-            g_t_jacobian = g_t_jacobian_func(point,P)
-            g_t_hessian = g_t_hessian_func(point,P)
-
-            g_t_dt = g_t_jacobian[1]
-            g_t_d2x = g_t_hessian[0][0]
-
-            func = f(point)
-
-            err_sqr = ( (g_t_dt - g_t_d2x) - func)**2
-            cost_sum += err_sqr
-
-    return cost_sum
-
-
-
-
-
-

15.9.1. Setting up the network using Autograd; The full program

-

Having set up the network, along with the trial solution and cost function, we can now see how the deep neural network performs by comparing the results to the analytical solution.

-

The analytical solution of our problem is

-
-\[ -g(x,t) = \exp(-\pi^2 t)\sin(\pi x) -\]
-

A possible way to implement a neural network solving the PDE, is given below. -Be aware, though, that it is fairly slow for the parameters used. -A better result is possible, but requires more iterations, and thus longer time to complete.

-

Indeed, the program below is not optimal in its implementation, but rather serves as an example on how to implement and use a neural network to solve a PDE. -Using TensorFlow results in a much better execution time. Try it!

-
-
-
import autograd.numpy as np
-from autograd import jacobian,hessian,grad
-import autograd.numpy.random as npr
-from matplotlib import cm
-from matplotlib import pyplot as plt
-from mpl_toolkits.mplot3d import axes3d
-
-## Set up the network
-
-def sigmoid(z):
-    return 1/(1 + np.exp(-z))
-
-def deep_neural_network(deep_params, x):
-    # x is now a point and a 1D numpy array; make it a column vector
-    num_coordinates = np.size(x,0)
-    x = x.reshape(num_coordinates,-1)
-
-    num_points = np.size(x,1)
-
-    # N_hidden is the number of hidden layers
-    N_hidden = np.size(deep_params) - 1 # -1 since params consist of parameters to all the hidden layers AND the output layer
-
-    # Assume that the input layer does nothing to the input x
-    x_input = x
-    x_prev = x_input
-
-    ## Hidden layers:
-
-    for l in range(N_hidden):
-        # From the list of parameters P; find the correct weigths and bias for this layer
-        w_hidden = deep_params[l]
-
-        # Add a row of ones to include bias
-        x_prev = np.concatenate((np.ones((1,num_points)), x_prev ), axis = 0)
-
-        z_hidden = np.matmul(w_hidden, x_prev)
-        x_hidden = sigmoid(z_hidden)
-
-        # Update x_prev such that next layer can use the output from this layer
-        x_prev = x_hidden
-
-    ## Output layer:
-
-    # Get the weights and bias for this layer
-    w_output = deep_params[-1]
-
-    # Include bias:
-    x_prev = np.concatenate((np.ones((1,num_points)), x_prev), axis = 0)
-
-    z_output = np.matmul(w_output, x_prev)
-    x_output = z_output
-
-    return x_output[0][0]
-
-## Define the trial solution and cost function
-def u(x):
-    return np.sin(np.pi*x)
-
-def g_trial(point,P):
-    x,t = point
-    return (1-t)*u(x) + x*(1-x)*t*deep_neural_network(P,point)
-
-# The right side of the ODE:
-def f(point):
-    return 0.
-
-# The cost function:
-def cost_function(P, x, t):
-    cost_sum = 0
-
-    g_t_jacobian_func = jacobian(g_trial)
-    g_t_hessian_func = hessian(g_trial)
-
-    for x_ in x:
-        for t_ in t:
-            point = np.array([x_,t_])
-
-            g_t = g_trial(point,P)
-            g_t_jacobian = g_t_jacobian_func(point,P)
-            g_t_hessian = g_t_hessian_func(point,P)
-
-            g_t_dt = g_t_jacobian[1]
-            g_t_d2x = g_t_hessian[0][0]
-
-            func = f(point)
-
-            err_sqr = ( (g_t_dt - g_t_d2x) - func)**2
-            cost_sum += err_sqr
-
-    return cost_sum /( np.size(x)*np.size(t) )
-
-## For comparison, define the analytical solution
-def g_analytic(point):
-    x,t = point
-    return np.exp(-np.pi**2*t)*np.sin(np.pi*x)
-
-## Set up a function for training the network to solve for the equation
-def solve_pde_deep_neural_network(x,t, num_neurons, num_iter, lmb):
-    ## Set up initial weigths and biases
-    N_hidden = np.size(num_neurons)
-
-    ## Set up initial weigths and biases
-
-    # Initialize the list of parameters:
-    P = [None]*(N_hidden + 1) # + 1 to include the output layer
-
-    P[0] = npr.randn(num_neurons[0], 2 + 1 ) # 2 since we have two points, +1 to include bias
-    for l in range(1,N_hidden):
-        P[l] = npr.randn(num_neurons[l], num_neurons[l-1] + 1) # +1 to include bias
-
-    # For the output layer
-    P[-1] = npr.randn(1, num_neurons[-1] + 1 ) # +1 since bias is included
-
-    print('Initial cost: ',cost_function(P, x, t))
-
-    cost_function_grad = grad(cost_function,0)
-
-    # Let the update be done num_iter times
-    for i in range(num_iter):
-        cost_grad =  cost_function_grad(P, x , t)
-
-        for l in range(N_hidden+1):
-            P[l] = P[l] - lmb * cost_grad[l]
-
-    print('Final cost: ',cost_function(P, x, t))
-
-    return P
-
-if __name__ == '__main__':
-    ### Use the neural network:
-    npr.seed(15)
-
-    ## Decide the vales of arguments to the function to solve
-    Nx = 10; Nt = 10
-    x = np.linspace(0, 1, Nx)
-    t = np.linspace(0,1,Nt)
-
-    ## Set up the parameters for the network
-    num_hidden_neurons = [100, 25]
-    num_iter = 250
-    lmb = 0.01
-
-    P = solve_pde_deep_neural_network(x,t, num_hidden_neurons, num_iter, lmb)
-
-    ## Store the results
-    g_dnn_ag = np.zeros((Nx, Nt))
-    G_analytical = np.zeros((Nx, Nt))
-    for i,x_ in enumerate(x):
-        for j, t_ in enumerate(t):
-            point = np.array([x_, t_])
-            g_dnn_ag[i,j] = g_trial(point,P)
-
-            G_analytical[i,j] = g_analytic(point)
-
-    # Find the map difference between the analytical and the computed solution
-    diff_ag = np.abs(g_dnn_ag - G_analytical)
-    print('Max absolute difference between the analytical solution and the network: %g'%np.max(diff_ag))
-
-    ## Plot the solutions in two dimensions, that being in position and time
-
-    T,X = np.meshgrid(t,x)
-
-    fig = plt.figure(figsize=(10,10))
-    ax = fig.gca(projection='3d')
-    ax.set_title('Solution from the deep neural network w/ %d layer'%len(num_hidden_neurons))
-    s = ax.plot_surface(T,X,g_dnn_ag,linewidth=0,antialiased=False,cmap=cm.viridis)
-    ax.set_xlabel('Time $t$')
-    ax.set_ylabel('Position $x$');
-
-
-    fig = plt.figure(figsize=(10,10))
-    ax = fig.gca(projection='3d')
-    ax.set_title('Analytical solution')
-    s = ax.plot_surface(T,X,G_analytical,linewidth=0,antialiased=False,cmap=cm.viridis)
-    ax.set_xlabel('Time $t$')
-    ax.set_ylabel('Position $x$');
-
-    fig = plt.figure(figsize=(10,10))
-    ax = fig.gca(projection='3d')
-    ax.set_title('Difference')
-    s = ax.plot_surface(T,X,diff_ag,linewidth=0,antialiased=False,cmap=cm.viridis)
-    ax.set_xlabel('Time $t$')
-    ax.set_ylabel('Position $x$');
-
-    ## Take some slices of the 3D plots just to see the solutions at particular times
-    indx1 = 0
-    indx2 = int(Nt/2)
-    indx3 = Nt-1
-
-    t1 = t[indx1]
-    t2 = t[indx2]
-    t3 = t[indx3]
-
-    # Slice the results from the DNN
-    res1 = g_dnn_ag[:,indx1]
-    res2 = g_dnn_ag[:,indx2]
-    res3 = g_dnn_ag[:,indx3]
-
-    # Slice the analytical results
-    res_analytical1 = G_analytical[:,indx1]
-    res_analytical2 = G_analytical[:,indx2]
-    res_analytical3 = G_analytical[:,indx3]
-
-    # Plot the slices
-    plt.figure(figsize=(10,10))
-    plt.title("Computed solutions at time = %g"%t1)
-    plt.plot(x, res1)
-    plt.plot(x,res_analytical1)
-    plt.legend(['dnn','analytical'])
-
-    plt.figure(figsize=(10,10))
-    plt.title("Computed solutions at time = %g"%t2)
-    plt.plot(x, res2)
-    plt.plot(x,res_analytical2)
-    plt.legend(['dnn','analytical'])
-
-    plt.figure(figsize=(10,10))
-    plt.title("Computed solutions at time = %g"%t3)
-    plt.plot(x, res3)
-    plt.plot(x,res_analytical3)
-    plt.legend(['dnn','analytical'])
-
-    plt.show()
-
-
-
-
-
/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/numpy/core/_asarray.py:83: VisibleDeprecationWarning: Creating an ndarray from ragged nested sequences (which is a list-or-tuple of lists-or-tuples-or ndarrays with different lengths or shapes) is deprecated. If you meant to do this, you must specify 'dtype=object' when creating the ndarray
-  return array(a, dtype, copy=False, order=order)
-
-
-
Initial cost:  41.05505310046363
-
-
-
-
-
-
-
-

15.10. Solving the wave equation with Neural Networks

-

The wave equation is

-
-\[ -\frac{\partial^2 g(x,t)}{\partial t^2} = c^2\frac{\partial^2 g(x,t)}{\partial x^2} -\]
-

with \(c\) being the specified wave speed.

-

Here, the chosen conditions are

-
-\[\begin{split} -\begin{align*} - g(0,t) &= 0 \\ - g(1,t) &= 0 \\ - g(x,0) &= u(x) \\ - \frac{\partial g(x,t)}{\partial t} \Big |_{t = 0} &= v(x) -\end{align*} -\end{split}\]
-

where \(\frac{\partial g(x,t)}{\partial t} \Big |_{t = 0}\) means the derivative of \(g(x,t)\) with respect to \(t\) is evaluated at \(t = 0\), and \(u(x)\) and \(v(x)\) being given functions.

-

The wave equation to solve for, is

- -
-
-\[ -\begin{equation} \label{wave} \tag{19} -\frac{\partial^2 g(x,t)}{\partial t^2} = c^2 \frac{\partial^2 g(x,t)}{\partial x^2} -\end{equation} -\]
-

where \(c\) is the given wave speed. -The chosen conditions for this equation are

- -
-
-\[\begin{split} -\begin{aligned} -g(0,t) &= 0, &t \geq 0 \\ -g(1,t) &= 0, &t \geq 0 \\ -g(x,0) &= u(x), &x\in[0,1] \\ -\frac{\partial g(x,t)}{\partial t}\Big |_{t = 0} &= v(x), &x \in [0,1] -\end{aligned} \label{condwave} \tag{20} -\end{split}\]
-

In this example, let \(c = 1\) and \(u(x) = \sin(\pi x)\) and \(v(x) = -\pi\sin(\pi x)\).

-

Setting up the network is done in similar matter as for the example of solving the diffusion equation. -The only things we have to change, is the trial solution such that it satisfies the conditions from (20) and the cost function.

-

The trial solution becomes slightly different since we have other conditions than in the example of solving the diffusion equation. Here, a possible trial solution \(g_t(x,t)\) is

-
-\[ -g_t(x,t) = h_1(x,t) + x(1-x)t^2N(x,t,P) -\]
-

where

-
-\[ -h_1(x,t) = (1-t^2)u(x) + tv(x) -\]
-

Note that this trial solution satisfies the conditions only if \(u(0) = v(0) = u(1) = v(1) = 0\), which is the case in this example.

-

The analytical solution for our specific problem, is

-
-\[ -g(x,t) = \sin(\pi x)\cos(\pi t) - \sin(\pi x)\sin(\pi t) -\]
-
-
-
import autograd.numpy as np
-from autograd import hessian,grad
-import autograd.numpy.random as npr
-from matplotlib import cm
-from matplotlib import pyplot as plt
-from mpl_toolkits.mplot3d import axes3d
-
-## Set up the trial function:
-def u(x):
-    return np.sin(np.pi*x)
-
-def v(x):
-    return -np.pi*np.sin(np.pi*x)
-
-def h1(point):
-    x,t = point
-    return (1 - t**2)*u(x) + t*v(x)
-
-def g_trial(point,P):
-    x,t = point
-    return h1(point) + x*(1-x)*t**2*deep_neural_network(P,point)
-
-## Define the cost function
-def cost_function(P, x, t):
-    cost_sum = 0
-
-    g_t_hessian_func = hessian(g_trial)
-
-    for x_ in x:
-        for t_ in t:
-            point = np.array([x_,t_])
-
-            g_t_hessian = g_t_hessian_func(point,P)
-
-            g_t_d2x = g_t_hessian[0][0]
-            g_t_d2t = g_t_hessian[1][1]
-
-            err_sqr = ( (g_t_d2t - g_t_d2x) )**2
-            cost_sum += err_sqr
-
-    return cost_sum / (np.size(t) * np.size(x))
-
-## The neural network
-def sigmoid(z):
-    return 1/(1 + np.exp(-z))
-
-def deep_neural_network(deep_params, x):
-    # x is now a point and a 1D numpy array; make it a column vector
-    num_coordinates = np.size(x,0)
-    x = x.reshape(num_coordinates,-1)
-
-    num_points = np.size(x,1)
-
-    # N_hidden is the number of hidden layers
-    N_hidden = np.size(deep_params) - 1 # -1 since params consist of parameters to all the hidden layers AND the output layer
-
-    # Assume that the input layer does nothing to the input x
-    x_input = x
-    x_prev = x_input
-
-    ## Hidden layers:
-
-    for l in range(N_hidden):
-        # From the list of parameters P; find the correct weigths and bias for this layer
-        w_hidden = deep_params[l]
-
-        # Add a row of ones to include bias
-        x_prev = np.concatenate((np.ones((1,num_points)), x_prev ), axis = 0)
-
-        z_hidden = np.matmul(w_hidden, x_prev)
-        x_hidden = sigmoid(z_hidden)
-
-        # Update x_prev such that next layer can use the output from this layer
-        x_prev = x_hidden
-
-    ## Output layer:
-
-    # Get the weights and bias for this layer
-    w_output = deep_params[-1]
-
-    # Include bias:
-    x_prev = np.concatenate((np.ones((1,num_points)), x_prev), axis = 0)
-
-    z_output = np.matmul(w_output, x_prev)
-    x_output = z_output
-
-    return x_output[0][0]
-
-## The analytical solution
-def g_analytic(point):
-    x,t = point
-    return np.sin(np.pi*x)*np.cos(np.pi*t) - np.sin(np.pi*x)*np.sin(np.pi*t)
-
-def solve_pde_deep_neural_network(x,t, num_neurons, num_iter, lmb):
-    ## Set up initial weigths and biases
-    N_hidden = np.size(num_neurons)
-
-    ## Set up initial weigths and biases
-
-    # Initialize the list of parameters:
-    P = [None]*(N_hidden + 1) # + 1 to include the output layer
-
-    P[0] = npr.randn(num_neurons[0], 2 + 1 ) # 2 since we have two points, +1 to include bias
-    for l in range(1,N_hidden):
-        P[l] = npr.randn(num_neurons[l], num_neurons[l-1] + 1) # +1 to include bias
-
-    # For the output layer
-    P[-1] = npr.randn(1, num_neurons[-1] + 1 ) # +1 since bias is included
-
-    print('Initial cost: ',cost_function(P, x, t))
-
-    cost_function_grad = grad(cost_function,0)
-
-    # Let the update be done num_iter times
-    for i in range(num_iter):
-        cost_grad =  cost_function_grad(P, x , t)
-
-        for l in range(N_hidden+1):
-            P[l] = P[l] - lmb * cost_grad[l]
-
-
-    print('Final cost: ',cost_function(P, x, t))
-
-    return P
-
-if __name__ == '__main__':
-    ### Use the neural network:
-    npr.seed(15)
-
-    ## Decide the vales of arguments to the function to solve
-    Nx = 10; Nt = 10
-    x = np.linspace(0, 1, Nx)
-    t = np.linspace(0,1,Nt)
-
-    ## Set up the parameters for the network
-    num_hidden_neurons = [50,20]
-    num_iter = 1000
-    lmb = 0.01
-
-    P = solve_pde_deep_neural_network(x,t, num_hidden_neurons, num_iter, lmb)
-
-    ## Store the results
-    res = np.zeros((Nx, Nt))
-    res_analytical = np.zeros((Nx, Nt))
-    for i,x_ in enumerate(x):
-        for j, t_ in enumerate(t):
-            point = np.array([x_, t_])
-            res[i,j] = g_trial(point,P)
-
-            res_analytical[i,j] = g_analytic(point)
-
-    diff = np.abs(res - res_analytical)
-    print("Max difference between analytical and solution from nn: %g"%np.max(diff))
-
-    ## Plot the solutions in two dimensions, that being in position and time
-
-    T,X = np.meshgrid(t,x)
-
-    fig = plt.figure(figsize=(10,10))
-    ax = fig.gca(projection='3d')
-    ax.set_title('Solution from the deep neural network w/ %d layer'%len(num_hidden_neurons))
-    s = ax.plot_surface(T,X,res,linewidth=0,antialiased=False,cmap=cm.viridis)
-    ax.set_xlabel('Time $t$')
-    ax.set_ylabel('Position $x$');
-
-
-    fig = plt.figure(figsize=(10,10))
-    ax = fig.gca(projection='3d')
-    ax.set_title('Analytical solution')
-    s = ax.plot_surface(T,X,res_analytical,linewidth=0,antialiased=False,cmap=cm.viridis)
-    ax.set_xlabel('Time $t$')
-    ax.set_ylabel('Position $x$');
-
-
-    fig = plt.figure(figsize=(10,10))
-    ax = fig.gca(projection='3d')
-    ax.set_title('Difference')
-    s = ax.plot_surface(T,X,diff,linewidth=0,antialiased=False,cmap=cm.viridis)
-    ax.set_xlabel('Time $t$')
-    ax.set_ylabel('Position $x$');
-
-    ## Take some slices of the 3D plots just to see the solutions at particular times
-    indx1 = 0
-    indx2 = int(Nt/2)
-    indx3 = Nt-1
-
-    t1 = t[indx1]
-    t2 = t[indx2]
-    t3 = t[indx3]
-
-    # Slice the results from the DNN
-    res1 = res[:,indx1]
-    res2 = res[:,indx2]
-    res3 = res[:,indx3]
-
-    # Slice the analytical results
-    res_analytical1 = res_analytical[:,indx1]
-    res_analytical2 = res_analytical[:,indx2]
-    res_analytical3 = res_analytical[:,indx3]
-
-    # Plot the slices
-    plt.figure(figsize=(10,10))
-    plt.title("Computed solutions at time = %g"%t1)
-    plt.plot(x, res1)
-    plt.plot(x,res_analytical1)
-    plt.legend(['dnn','analytical'])
-
-    plt.figure(figsize=(10,10))
-    plt.title("Computed solutions at time = %g"%t2)
-    plt.plot(x, res2)
-    plt.plot(x,res_analytical2)
-    plt.legend(['dnn','analytical'])
-
-    plt.figure(figsize=(10,10))
-    plt.title("Computed solutions at time = %g"%t3)
-    plt.plot(x, res3)
-    plt.plot(x,res_analytical3)
-    plt.legend(['dnn','analytical'])
-
-    plt.show()
-
-
-
-
-
- -
- - - - -
- - - - -
-
-
-
-

- - By Morten Hjorth-Jensen
- - © Copyright 2021.
-

-
-
-
- - -
-
- - - - - - \ No newline at end of file diff --git a/doc/LectureNotes/_build/html/chapter2.html b/doc/LectureNotes/_build/html/chapter2.html deleted file mode 100644 index e80b9104d..000000000 --- a/doc/LectureNotes/_build/html/chapter2.html +++ /dev/null @@ -1,3311 +0,0 @@ - - - - - - - - 4. Ridge and Lasso Regression — Applied Data Analysis and Machine Learning - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
- - - - - - - - -
- - -
-
- -
- -
-

4. Ridge and Lasso Regression

-
-

4.1. Mathematical Interpretation of Ordinary Least Squares

-

What is presented here is a mathematical analysis of various regression algorithms (ordinary least squares, Ridge and Lasso Regression). The analysis is based on an important algorithm in linear algebra, the so-called Singular Value Decomposition (SVD).

-

We have shown that in ordinary least squares (OLS) the optimal parameters \(\beta\) are given by

-
-\[ -\hat{\boldsymbol{\beta}}_{\mathrm{OLS}} = \left(\boldsymbol{X}^T\boldsymbol{X}\right)^{-1}\boldsymbol{X}^T\boldsymbol{y}. -\]
-

The hat over \(\boldsymbol{\beta}\) means we have the optimal parameters after minimization of the cost function.

-

This means that our best model is defined as

-
-\[ -\tilde{\boldsymbol{y}}=\boldsymbol{X}\hat{\boldsymbol{\beta}} = \boldsymbol{X}\left(\boldsymbol{X}^T\boldsymbol{X}\right)^{-1}\boldsymbol{X}^T\boldsymbol{y}. -\]
-

We now define a matrix

-
-\[ -\boldsymbol{A}=\boldsymbol{X}\left(\boldsymbol{X}^T\boldsymbol{X}\right)^{-1}\boldsymbol{X}^T. -\]
-

We can rewrite

-
-\[ -\tilde{\boldsymbol{y}}=\boldsymbol{X}\hat{\boldsymbol{\beta}} = \boldsymbol{A}\boldsymbol{y}. -\]
-

The matrix \(\boldsymbol{A}\) has the important property that \(\boldsymbol{A}^2=\boldsymbol{A}\). This is the definition of a projection matrix. -We can then interpret our optimal model \(\tilde{\boldsymbol{y}}\) as being represented by an orthogonal projection of \(\boldsymbol{y}\) onto a space defined by the column vectors of \(\boldsymbol{X}\). In our case here the matrix \(\boldsymbol{A}\) is a square matrix. If it is a general rectangular matrix we have an oblique projection matrix.

-

We have defined the residual error as

-
-\[ -\boldsymbol{\epsilon}=\boldsymbol{y}-\tilde{\boldsymbol{y}}=\left[\boldsymbol{I}-\boldsymbol{X}\left(\boldsymbol{X}^T\boldsymbol{X}\right)^{-1}\boldsymbol{X}^T\right]\boldsymbol{y}. -\]
-

The residual errors are then the projections of \(\boldsymbol{y}\) onto the orthogonal component of the space defined by the column vectors of \(\boldsymbol{X}\).

-

If the matrix \(\boldsymbol{X}\) is an orthogonal (or unitary in case of complex values) matrix, we have

-
-\[ -\boldsymbol{X}^T\boldsymbol{X}=\boldsymbol{X}\boldsymbol{X}^T = \boldsymbol{I}. -\]
-

In this case the matrix \(\boldsymbol{A}\) becomes

-
-\[ -\boldsymbol{A}=\boldsymbol{X}\left(\boldsymbol{X}^T\boldsymbol{X}\right)^{-1}\boldsymbol{X}^T)=\boldsymbol{I}, -\]
-

and we have the obvious case

-
-\[ -\boldsymbol{\epsilon}=\boldsymbol{y}-\tilde{\boldsymbol{y}}=0. -\]
-

This serves also as a useful test of our codes.

-
-
-

4.2. The singular value decomposition

-

The examples we have looked at so far are cases where we normally can -invert the matrix \(\boldsymbol{X}^T\boldsymbol{X}\). Using a polynomial expansion where we fit of various functions leads to -row vectors of the design matrix which are essentially orthogonal due -to the polynomial character of our model. Obtaining the inverse of the -design matrix is then often done via a so-called LU, QR or Cholesky -decomposition.

-

As we will also see in the first project, -this may -however not the be case in general and a standard matrix inversion -algorithm based on say LU, QR or Cholesky decomposition may lead to singularities. We will see examples of this below.

-

There is however a way to circumvent this problem and also -gain some insights about the ordinary least squares approach, and -later shrinkage methods like Ridge and Lasso regressions.

-

This is given by the Singular Value Decomposition (SVD) algorithm, -perhaps the most powerful linear algebra algorithm. The SVD provides -a numerically stable matrix decomposition that is used in a large -swath oc applications and the decomposition is always stable -numerically.

-

In machine learning it plays a central role in dealing with for -example design matrices that may be near singular or singular. -Furthermore, as we will see here, the singular values can be related -to the covariance matrix (and thereby the correlation matrix) and in -turn the variance of a given quantity. It plays also an important role -in the principal component analysis where high-dimensional data can be -reduced to the statistically relevant features.

-

One of the typical problems we encounter with linear regression, in particular -when the matrix \(\boldsymbol{X}\) (our so-called design matrix) is high-dimensional, -are problems with near singular or singular matrices. The column vectors of \(\boldsymbol{X}\) -may be linearly dependent, normally referred to as super-collinearity.
-This means that the matrix may be rank deficient and it is basically impossible to -to model the data using linear regression. As an example, consider the matrix

-
-\[\begin{split} -\begin{align*} -\mathbf{X} & = \left[ -\begin{array}{rrr} -1 & -1 & 2 -\\ -1 & 0 & 1 -\\ -1 & 2 & -1 -\\ -1 & 1 & 0 -\end{array} \right] -\end{align*} -\end{split}\]
-

The columns of \(\boldsymbol{X}\) are linearly dependent. We see this easily since the -the first column is the row-wise sum of the other two columns. The rank (more correct, -the column rank) of a matrix is the dimension of the space spanned by the -column vectors. Hence, the rank of \(\mathbf{X}\) is equal to the number -of linearly independent columns. In this particular case the matrix has rank 2.

-

Super-collinearity of an \((n \times p)\)-dimensional design matrix \(\mathbf{X}\) implies -that the inverse of the matrix \(\boldsymbol{X}^T\boldsymbol{X}\) (the matrix we need to invert to solve the linear regression equations) is non-invertible. If we have a square matrix that does not have an inverse, we say this matrix singular. The example here demonstrates this

-
-\[\begin{split} -\begin{align*} -\boldsymbol{X} & = \left[ -\begin{array}{rr} -1 & -1 -\\ -1 & -1 -\end{array} \right]. -\end{align*} -\end{split}\]
-

We see easily that \(\mbox{det}(\boldsymbol{X}) = x_{11} x_{22} - x_{12} x_{21} = 1 \times (-1) - 1 \times (-1) = 0\). Hence, \(\mathbf{X}\) is singular and its inverse is undefined. -This is equivalent to saying that the matrix \(\boldsymbol{X}\) has at least an eigenvalue which is zero.

-

If our design matrix \(\boldsymbol{X}\) which enters the linear regression problem

- -
-
-\[ -\begin{equation} -\boldsymbol{\beta} = (\boldsymbol{X}^{T} \boldsymbol{X})^{-1} \boldsymbol{X}^{T} \boldsymbol{y}, -\label{_auto1} \tag{1} -\end{equation} -\]
-

has linearly dependent column vectors, we will not be able to compute the inverse -of \(\boldsymbol{X}^T\boldsymbol{X}\) and we cannot find the parameters (estimators) \(\beta_i\). -The estimators are only well-defined if \((\boldsymbol{X}^{T}\boldsymbol{X})^{-1}\) exits. -This is more likely to happen when the matrix \(\boldsymbol{X}\) is high-dimensional. In this case it is likely to encounter a situation where -the regression parameters \(\beta_i\) cannot be estimated.

-

A cheap ad hoc approach is simply to add a small diagonal component to the matrix to invert, that is we change

-
-\[ -\boldsymbol{X}^{T} \boldsymbol{X} \rightarrow \boldsymbol{X}^{T} \boldsymbol{X}+\lambda \boldsymbol{I}, -\]
-

where \(\boldsymbol{I}\) is the identity matrix. When we discuss Ridge regression this is actually what we end up evaluating. The parameter \(\lambda\) is called a hyperparameter. More about this later.

-
-
-

4.3. Basic math of the SVD

-

From standard linear algebra we know that a square matrix \(\boldsymbol{X}\) can be diagonalized if and only it is -a so-called normal matrix, that is if \(\boldsymbol{X}\in {\mathbb{R}}^{n\times n}\) -we have \(\boldsymbol{X}\boldsymbol{X}^T=\boldsymbol{X}^T\boldsymbol{X}\) or if \(\boldsymbol{X}\in {\mathbb{C}}^{n\times n}\) we have \(\boldsymbol{X}\boldsymbol{X}^{\dagger}=\boldsymbol{X}^{\dagger}\boldsymbol{X}\). -The matrix has then a set of eigenpairs

-
-\[ -(\lambda_1,\boldsymbol{u}_1),\dots, (\lambda_n,\boldsymbol{u}_n), -\]
-

and the eigenvalues are given by the diagonal matrix

-
-\[ -\boldsymbol{\Sigma}=\mathrm{Diag}(\lambda_1, \dots,\lambda_n). -\]
-

The matrix \(\boldsymbol{X}\) can be written in terms of an orthogonal/unitary transformation \(\boldsymbol{U}\)

-
-\[ -\boldsymbol{X} = \boldsymbol{U}\boldsymbol{\Sigma}\boldsymbol{V}^T, -\]
-

with \(\boldsymbol{U}\boldsymbol{U}^T=\boldsymbol{I}\) or \(\boldsymbol{U}\boldsymbol{U}^{\dagger}=\boldsymbol{I}\).

-

Not all square matrices are diagonalizable. A matrix like the one discussed above

-
-\[\begin{split} -\boldsymbol{X} = \begin{bmatrix} -1& -1 \\ -1& -1\\ -\end{bmatrix} -\end{split}\]
-

is not diagonalizable, it is a so-called defective matrix. It is easy to see that the condition -\(\boldsymbol{X}\boldsymbol{X}^T=\boldsymbol{X}^T\boldsymbol{X}\) is not fulfilled.

-

However, and this is the strength of the SVD algorithm, any general -matrix \(\boldsymbol{X}\) can be decomposed in terms of a diagonal matrix and -two orthogonal/unitary matrices. The Singular Value Decompostion -(SVD) theorem -states that a general \(m\times n\) matrix \(\boldsymbol{X}\) can be written in -terms of a diagonal matrix \(\boldsymbol{\Sigma}\) of dimensionality \(m\times n\) -and two orthognal matrices \(\boldsymbol{U}\) and \(\boldsymbol{V}\), where the first has -dimensionality \(m \times m\) and the last dimensionality \(n\times n\). -We have then

-
-\[ -\boldsymbol{X} = \boldsymbol{U}\boldsymbol{\Sigma}\boldsymbol{V}^T -\]
-

As an example, the above defective matrix can be decomposed as

-
-\[\begin{split} -\boldsymbol{X} = \frac{1}{\sqrt{2}}\begin{bmatrix} 1& 1 \\ 1& -1\\ \end{bmatrix} \begin{bmatrix} 2& 0 \\ 0& 0\\ \end{bmatrix} \frac{1}{\sqrt{2}}\begin{bmatrix} 1& -1 \\ 1& 1\\ \end{bmatrix}=\boldsymbol{U}\boldsymbol{\Sigma}\boldsymbol{V}^T, -\end{split}\]
-

with eigenvalues \(\sigma_1=2\) and \(\sigma_2=0\). -The SVD exits always!

-

The SVD -decomposition (singular values) gives eigenvalues -\(\sigma_i\geq\sigma_{i+1}\) for all \(i\) and for dimensions larger than \(i=p\), the -eigenvalues (singular values) are zero.

-

In the general case, where our design matrix \(\boldsymbol{X}\) has dimension -\(n\times p\), the matrix is thus decomposed into an \(n\times n\) -orthogonal matrix \(\boldsymbol{U}\), a \(p\times p\) orthogonal matrix \(\boldsymbol{V}\) -and a diagonal matrix \(\boldsymbol{\Sigma}\) with \(r=\mathrm{min}(n,p)\) -singular values \(\sigma_i\geq 0\) on the main diagonal and zeros filling -the rest of the matrix. There are at most \(p\) singular values -assuming that \(n > p\). In our regression examples for the nuclear -masses and the equation of state this is indeed the case, while for -the Ising model we have \(p > n\). These are often cases that lead to -near singular or singular matrices.

-

The columns of \(\boldsymbol{U}\) are called the left singular vectors while the columns of \(\boldsymbol{V}\) are the right singular vectors.

-

If we assume that \(n > p\), then our matrix \(\boldsymbol{U}\) has dimension \(n -\times n\). The last \(n-p\) columns of \(\boldsymbol{U}\) become however -irrelevant in our calculations since they are multiplied with the -zeros in \(\boldsymbol{\Sigma}\).

-

The economy-size decomposition removes extra rows or columns of zeros -from the diagonal matrix of singular values, \(\boldsymbol{\Sigma}\), along with the columns -in either \(\boldsymbol{U}\) or \(\boldsymbol{V}\) that multiply those zeros in the expression. -Removing these zeros and columns can improve execution time -and reduce storage requirements without compromising the accuracy of -the decomposition.

-

If \(n > p\), we keep only the first \(p\) columns of \(\boldsymbol{U}\) and \(\boldsymbol{\Sigma}\) has dimension \(p\times p\). -If \(p > n\), then only the first \(n\) columns of \(\boldsymbol{V}\) are computed and \(\boldsymbol{\Sigma}\) has dimension \(n\times n\). -The \(n=p\) case is obvious, we retain the full SVD. -In general the economy-size SVD leads to less FLOPS and still conserving the desired accuracy.

-
-
-

4.4. Codes for the SVD

-
-
-
import numpy as np
-# SVD inversion
-def SVD(A):
-    ''' Takes as input a numpy matrix A and returns inv(A) based on singular value decomposition (SVD).
-    SVD is numerically more stable than the inversion algorithms provided by
-    numpy and scipy.linalg at the cost of being slower.
-    '''
-    U, S, VT = np.linalg.svd(A,full_matrices=True)
-    print('test U')
-    print( (np.transpose(U) @ U - U @np.transpose(U)))
-    print('test VT')
-    print( (np.transpose(VT) @ VT - VT @np.transpose(VT)))
-    print(U)
-    print(S)
-    print(VT)
-
-    D = np.zeros((len(U),len(VT)))
-    for i in range(0,len(VT)):
-        D[i,i]=S[i]
-    return U @ D @ VT
-
-
-X = np.array([ [1.0,-1.0], [1.0,-1.0]])
-#X = np.array([[1, 2], [3, 4], [5, 6]])
-
-print(X)
-C = SVD(X)
-# Print the difference between the original matrix and the SVD one
-print(C-X)
-
-
-
-
-
[[ 1. -1.]
- [ 1. -1.]]
-test U
-[[0. 0.]
- [0. 0.]]
-test VT
-[[0. 0.]
- [0. 0.]]
-[[-0.70710678 -0.70710678]
- [-0.70710678  0.70710678]]
-[2. 0.]
-[[-0.70710678  0.70710678]
- [ 0.70710678  0.70710678]]
-[[-3.33066907e-16  4.44089210e-16]
- [ 0.00000000e+00  2.22044605e-16]]
-
-
-
-
-

The matrix \(\boldsymbol{X}\) has columns that are linearly dependent. The first -column is the row-wise sum of the other two columns. The rank of a -matrix (the column rank) is the dimension of space spanned by the -column vectors. The rank of the matrix is the number of linearly -independent columns, in this case just \(2\). We see this from the -singular values when running the above code. Running the standard -inversion algorithm for matrix inversion with \(\boldsymbol{X}^T\boldsymbol{X}\) results -in the program terminating due to a singular matrix.

-

The \(U\), \(S\), and \(V\) matrices returned from the svd() function -cannot be multiplied directly.

-

As you can see from the code, the \(S\) vector must be converted into a -diagonal matrix. This may cause a problem as the size of the matrices -do not fit the rules of matrix multiplication, where the number of -columns in a matrix must match the number of rows in the subsequent -matrix.

-

If you wish to include the zero singular values, you will need to -resize the matrices and set up a diagonal matrix as done in the above -example

-
-
-

4.5. Code for SVD and Inversion of Matrices

-

How do we use the SVD to invert a matrix \(\boldsymbol{X}^T\boldsymbol{X}\) which is singular or near singular? -The simple answer is to use the linear algebra function for the pseudoinverse, that is

-
-
-
#Ainv = np.linlag.pinv(A)
-
-
-
-
-

Let us first look at a matrix which does not causes problems and write our own function where we just use the SVD.

-
-
-
import numpy as np
-# SVD inversion
-def SVDinv(A):
-    ''' Takes as input a numpy matrix A and returns inv(A) based on singular value decomposition (SVD).
-    SVD is numerically more stable than the inversion algorithms provided by
-    numpy and scipy.linalg at the cost of being slower.
-    '''
-    U, s, VT = np.linalg.svd(A)
-    print('test U')
-    print( (np.transpose(U) @ U - U @np.transpose(U)))
-    print('test VT')
-    print( (np.transpose(VT) @ VT - VT @np.transpose(VT)))
-
-
-    D = np.zeros((len(U),len(VT)))
-    D = np.diag(s)
-    UT = np.transpose(U); V = np.transpose(VT); invD = np.linalg.inv(D)
-    return np.matmul(V,np.matmul(invD,UT))
-
-
-#X = np.array([ [1.0, -1.0, 2.0], [1.0, 0.0, 1.0], [1.0, 2.0, -1.0], [1.0, 1.0, 0.0] ])
-# Non-singular square matrix
-X = np.array( [ [1,2,3],[2,4,5],[3,5,6]])
-print(X)
-A = np.transpose(X) @ X
-# Brute force inversion
-B = np.linalg.pinv(A)  # here we could use np.linalg.inv(A), try it!
-C = SVDinv(A)
-print(np.abs(B-C))
-
-
-
-
-
[[1 2 3]
- [2 4 5]
- [3 5 6]]
-test U
-[[ 2.22044605e-16 -7.77156117e-16 -5.55111512e-16]
- [-7.77156117e-16  0.00000000e+00 -1.11022302e-16]
- [-5.55111512e-16 -1.11022302e-16  0.00000000e+00]]
-test VT
-[[ 1.11022302e-16 -2.22044605e-16  1.38777878e-16]
- [-2.22044605e-16 -1.11022302e-16 -1.11022302e-16]
- [ 1.38777878e-16 -1.11022302e-16  0.00000000e+00]]
-[[0. 0. 0.]
- [0. 0. 0.]
- [0. 0. 0.]]
-
-
-
-
-

Although our matrix to invert \(\boldsymbol{X}^T\boldsymbol{X}\) is a square matrix, our matrix may be singular.

-

The pseudoinverse is the generalization of the matrix inverse for square matrices to -rectangular matrices where the number of rows and columns are not equal.

-

It is also called the the Moore-Penrose Inverse after two independent discoverers of the method or the Generalized Inverse. -It is used for the calculation of the inverse for singular or near singular matrices and for rectangular matrices.

-

Using the SVD we can obtain the pseudoinverse of a matrix \(\boldsymbol{A}\) (labeled here as \(\boldsymbol{A}_{\mathrm{PI}}\)

-
-\[ -\boldsymbol{A}_{\mathrm{PI}}= \boldsymbol{V}\boldsymbol{D}_{\mathrm{PI}}\boldsymbol{U}^T, -\]
-

where \(\boldsymbol{D}_{\mathrm{PI}}\) can be calculated by creating a diagonal matrix from \(\boldsymbol{Sigma}\) where we only keep the singular values (the non-zero values). The following code computes the pseudoinvers of the matrix based on the SVD.

-
-
-
import numpy as np
-# SVD inversion
-def SVDinv(A):
-    U, s, VT = np.linalg.svd(A)
-    # reciprocals of singular values of s
-    d = 1.0 / s
-    # create m x n D matrix
-    D = np.zeros(A.shape)
-    # populate D with n x n diagonal matrix
-    D[:A.shape[1], :A.shape[1]] = np.diag(d)
-    UT = np.transpose(U)
-    V = np.transpose(VT)
-    return np.matmul(V,np.matmul(D.T,UT))
-
-
-A = np.array([ [0.3, 0.4], [0.5, 0.6], [0.7, 0.8],[0.9, 1.0]])
-print(A)
-# Brute force inversion of super-collinear matrix
-B = np.linalg.pinv(A)
-print(B)
-# Compare our own algorithm with pinv
-C = SVDinv(A)
-print(np.abs(C-B))
-
-
-
-
-
[[0.3 0.4]
- [0.5 0.6]
- [0.7 0.8]
- [0.9 1. ]]
-[[-13.   -6.    1.    8. ]
- [ 11.5   5.5  -0.5  -6.5]]
-[[0. 0. 0. 0.]
- [0. 0. 0. 0.]]
-
-
-
-
-

As you can see from these examples, our own decomposition based on the SVD agrees the pseudoinverse algorithm provided by Numpy.

-
-
-

4.6. Mathematics of the SVD and implications

-

Let us take a closer look at the mathematics of the SVD and the various implications for machine learning studies.

-

Our starting point is our design matrix \(\boldsymbol{X}\) of dimension \(n\times p\)

-
-\[\begin{split} -\boldsymbol{X}=\begin{bmatrix} -x_{0,0} & x_{0,1} & x_{0,2}& \dots & \dots x_{0,p-1}\\ -x_{1,0} & x_{1,1} & x_{1,2}& \dots & \dots x_{1,p-1}\\ -x_{2,0} & x_{2,1} & x_{2,2}& \dots & \dots x_{2,p-1}\\ -\dots & \dots & \dots & \dots \dots & \dots \\ -x_{n-2,0} & x_{n-2,1} & x_{n-2,2}& \dots & \dots x_{n-2,p-1}\\ -x_{n-1,0} & x_{n-1,1} & x_{n-1,2}& \dots & \dots x_{n-1,p-1}\\ -\end{bmatrix}. -\end{split}\]
-

We can SVD decompose our matrix as

-
-\[ -\boldsymbol{X}=\boldsymbol{U}\boldsymbol{\Sigma}\boldsymbol{V}^T, -\]
-

where \(\boldsymbol{U}\) is an orthogonal matrix of dimension \(n\times n\), meaning that \(\boldsymbol{U}\boldsymbol{U}^T=\boldsymbol{U}^T\boldsymbol{U}=\boldsymbol{I}_n\). Here \(\boldsymbol{I}_n\) is the unit matrix of dimension \(n \times n\).

-

Similarly, \(\boldsymbol{V}\) is an orthogonal matrix of dimension \(p\times p\), meaning that \(\boldsymbol{V}\boldsymbol{V}^T=\boldsymbol{V}^T\boldsymbol{V}=\boldsymbol{I}_p\). Here \(\boldsymbol{I}_n\) is the unit matrix of dimension \(p \times p\).

-

Finally \(\boldsymbol{\Sigma}\) contains the singular values \(\sigma_i\). This matrix has dimension \(n\times p\) and the singular values \(\sigma_i\) are all positive. The non-zero values are ordered in descending order, that is

-
-\[ -\sigma_0 > \sigma_1 > \sigma_2 > \dots > \sigma_{p-1} > 0. -\]
-

All values beyond \(p-1\) are all zero.

-

As an example, consider the following \(3\times 2\) example for the matrix \(\boldsymbol{\Sigma}\)

-
-\[\begin{split} -\boldsymbol{\Sigma}= -\begin{bmatrix} -2& 0 \\ -0 & 1 \\ -0 & 0 \\ -\end{bmatrix} -\end{split}\]
-

The singular values are \(\sigma_0=2\) and \(\sigma_1=1\). It is common to rewrite the matrix \(\boldsymbol{\Sigma}\) as

-
-\[\begin{split} -\boldsymbol{\Sigma}= -\begin{bmatrix} -\boldsymbol{\tilde{\Sigma}}\\ -\boldsymbol{0}\\ -\end{bmatrix}, -\end{split}\]
-

where

-
-\[\begin{split} -\boldsymbol{\tilde{\Sigma}}= -\begin{bmatrix} -2& 0 \\ -0 & 1 \\ -\end{bmatrix}, -\end{split}\]
-

contains only the singular values. Note also (and we will use this below) that

-
-\[\begin{split} -\boldsymbol{\Sigma}^T\boldsymbol{\Sigma}= -\begin{bmatrix} -4& 0 \\ -0 & 1 \\ -\end{bmatrix}, -\end{split}\]
-

which is a \(2\times 2 \) matrix while

-
-\[\begin{split} -\boldsymbol{\Sigma}\boldsymbol{\Sigma}^T= -\begin{bmatrix} -4& 0 & 0\\ -0 & 1 & 0\\ -0 & 0 & 0\\ -\end{bmatrix}, -\end{split}\]
-

is a \(3\times 3 \) matrix. The last row and column of this last matrix -contain only zeros. This will have important consequences for our SVD -decomposition of the design matrix.

-

The matrix that may cause problems for us is \(\boldsymbol{X}^T\boldsymbol{X}\). Using the SVD we can rewrite this matrix as

-
-\[ -\boldsymbol{X}^T\boldsymbol{X}=\boldsymbol{V}\boldsymbol{\Sigma}^T\boldsymbol{U}^T\boldsymbol{U}\boldsymbol{\Sigma}\boldsymbol{V}^T, -\]
-

and using the orthogonality of the matrix \(\boldsymbol{U}\) we have

-
-\[ -\boldsymbol{X}^T\boldsymbol{X}=\boldsymbol{V}\boldsymbol{\Sigma}^T\boldsymbol{\Sigma}\boldsymbol{V}^T. -\]
-

We define \(\boldsymbol{\Sigma}^T\boldsymbol{\Sigma}=\tilde{\boldsymbol{\Sigma}}^2\) which is a diagonal matrix containing only the singular values squared. It has dimensionality \(p \times p\).

-

This means, using the orthogonality of \(\boldsymbol{V}\), that we get

-
-\[ -\boldsymbol{X}^T\boldsymbol{X}=\tilde{\boldsymbol{\Sigma}}^2. -\]
-

We can now insert the result for the matrix \(\boldsymbol{X}^T\boldsymbol{X}\) into our equation for ordinary least squares where

-
-\[ -\tilde{y}_{\mathrm{OLS}}=\boldsymbol{X}\left(\boldsymbol{X}^T\boldsymbol{X}\right)^{-1}\boldsymbol{X}^T\boldsymbol{y}, -\]
-

and using our SVD decomposition of \(\boldsymbol{X}\) we have

-
-\[ -\tilde{y}_{\mathrm{OLS}}=\boldsymbol{U}\boldsymbol{\Sigma}\boldsymbol{V}^T\tilde{\boldsymbol{\Sigma}}^{-2}\boldsymbol{V}\boldsymbol{\Sigma}^T\boldsymbol{U}^T\boldsymbol{y}, -\]
-

which gives us, using the orthogonality of the matrices \(\boldsymbol{U}\) and \(\boldsymbol{V}\),

-
-\[ -\tilde{y}_{\mathrm{OLS}}=\boldsymbol{U}\boldsymbol{U}^T\boldsymbol{y}=\sum_{i=0}^{p-1}\boldsymbol{u}_i\boldsymbol{u}^T_j\boldsymbol{y}, -\]
-

Note here that when we perform the multiplication of the various matrices, the orthogonal vectors of the matrix \(\boldsymbol{U}\)

-
-\[ -\boldsymbol{U}=[\boldsymbol{u}_0,\boldsymbol{u}_1,\dots,\boldsymbol{u}_{n-1}], -\]
-

that belong to \(i>p-1\), result in only zeros when we perform the multiplications. This means that the sum above has non-zero elements only up to \(i=p-1\). This corresponds also to the number of singular values (these are all non-zero).

-

It means that the ordinary least square model (with the optimal parameters) \(\boldsymbol{\tilde{y}}\), corresponds to an orthogonal transformation of the output (or target) vector \(\boldsymbol{y}\) by the vectors of the matrix \(\boldsymbol{U}\).

-
-
-

4.7. Further properties (important for our analyses later)

-

Let us study again \(\boldsymbol{X}^T\boldsymbol{X}\) in terms of our SVD,

-
-\[ -\boldsymbol{X}^T\boldsymbol{X}=\boldsymbol{V}\boldsymbol{\Sigma}^T\boldsymbol{U}^T\boldsymbol{U}\boldsymbol{\Sigma}\boldsymbol{V}^T=\boldsymbol{V}\boldsymbol{\Sigma}^T\boldsymbol{\Sigma}\boldsymbol{V}^T. -\]
-

If we now multiply from the right with \(\boldsymbol{V}\) (using the orthogonality of \(\boldsymbol{V}\)) we get

-
-\[ -\left(\boldsymbol{X}^T\boldsymbol{X}\right)\boldsymbol{V}=\boldsymbol{V}\boldsymbol{\Sigma}^T\boldsymbol{\Sigma}. -\]
-

This means the vectors \(\boldsymbol{v}_i\) of the orthogonal matrix \(\boldsymbol{V}\) are the eigenvectors of the matrix \(\boldsymbol{X}^T\boldsymbol{X}\) -with eigenvalues given by the singular values squared, that is

-
-\[ -\left(\boldsymbol{X}^T\boldsymbol{X}\right)\boldsymbol{v}_i=\boldsymbol{v}_i\sigma_i^2. -\]
-

Similarly, if we use the SVD decomposition for the matrix \(\boldsymbol{X}\boldsymbol{X}^T\), we have

-
-\[ -\boldsymbol{X}\boldsymbol{X}^T=\boldsymbol{U}\boldsymbol{\Sigma}\boldsymbol{V}^T\boldsymbol{V}\boldsymbol{\Sigma}^T\boldsymbol{U}^T=\boldsymbol{U}\boldsymbol{\Sigma}\boldsymbol{\Sigma}^T\boldsymbol{U}^T. -\]
-

If we now multiply from the right with \(\boldsymbol{U}\) (using the orthogonality of \(\boldsymbol{U}\)) we get

-
-\[ -\left(\boldsymbol{X}\boldsymbol{X}^T\right)\boldsymbol{U}=\boldsymbol{U}\boldsymbol{\Sigma}\boldsymbol{\Sigma}^T. -\]
-

This means the vectors \(\boldsymbol{u}_i\) of the orthogonal matrix \(\boldsymbol{U}\) are the eigenvectors of the matrix \(\boldsymbol{X}\boldsymbol{X}^T\) -with eigenvalues given by the singular values squared, that is

-
-\[ -\left(\boldsymbol{X}\boldsymbol{X}^T\right)\boldsymbol{u}_i=\boldsymbol{u}_i\sigma_i^2. -\]
-

Important note: we have defined our design matrix \(\boldsymbol{X}\) to be an -\(n\times p\) matrix. In most supervised learning cases we have that \(n -\ge p\), and quite often we have \(n >> p\). For linear algebra based methods like ordinary least squares or Ridge regression, this leads to a matrix \(\boldsymbol{X}^T\boldsymbol{X}\) which is small and thereby easier to handle from a computational point of view (in terms of number of floating point operations).

-

In our lectures, the number of columns will -always refer to the number of features in our data set, while the -number of rows represents the number of data inputs. Note that in -other texts you may find the opposite notation. This has consequences -for the definition of for example the covariance matrix and its relation to the SVD.

-
-
-

4.8. Meet the Covariance Matrix

-

Before we move on to a discussion of Ridge and Lasso regression, we want to show an important example of the above.

-

We have already noted that the matrix \(\boldsymbol{X}^T\boldsymbol{X}\) in ordinary -least squares is proportional to the second derivative of the cost -function, that is we have

-
-\[ -\frac{\partial^2 C(\boldsymbol{\beta})}{\partial \boldsymbol{\beta}^T\partial \boldsymbol{\beta}} =\frac{2}{n}\boldsymbol{X}^T\boldsymbol{X}. -\]
-

This quantity defines was what is called the Hessian matrix (the second derivative of a function we want to optimize).

-

The Hessian matrix plays an important role and is defined in this course as

-
-\[ -\boldsymbol{H}=\boldsymbol{X}^T\boldsymbol{X}. -\]
-

The Hessian matrix for ordinary least squares is also proportional to -the covariance matrix. This means also that we can use the SVD to find -the eigenvalues of the covariance matrix and the Hessian matrix in -terms of the singular values. Let us develop these arguments, as they will play an important role in our machine learning studies.

-

Before we discuss the link between for example Ridge regression and the singular value decomposition, we need to remind ourselves about -the definition of the covariance and the correlation function. These are quantities that play a central role in machine learning methods.

-

Suppose we have defined two vectors -\(\hat{x}\) and \(\hat{y}\) with \(n\) elements each. The covariance matrix \(\boldsymbol{C}\) is defined as

-
-\[\begin{split} -\boldsymbol{C}[\boldsymbol{x},\boldsymbol{y}] = \begin{bmatrix} \mathrm{cov}[\boldsymbol{x},\boldsymbol{x}] & \mathrm{cov}[\boldsymbol{x},\boldsymbol{y}] \\ - \mathrm{cov}[\boldsymbol{y},\boldsymbol{x}] & \mathrm{cov}[\boldsymbol{y},\boldsymbol{y}] \\ - \end{bmatrix}, -\end{split}\]
-

where for example

-
-\[ -\mathrm{cov}[\boldsymbol{x},\boldsymbol{y}] =\frac{1}{n} \sum_{i=0}^{n-1}(x_i- \overline{x})(y_i- \overline{y}). -\]
-

With this definition and recalling that the variance is defined as

-
-\[ -\mathrm{var}[\boldsymbol{x}]=\frac{1}{n} \sum_{i=0}^{n-1}(x_i- \overline{x})^2, -\]
-

we can rewrite the covariance matrix as

-
-\[\begin{split} -\boldsymbol{C}[\boldsymbol{x},\boldsymbol{y}] = \begin{bmatrix} \mathrm{var}[\boldsymbol{x}] & \mathrm{cov}[\boldsymbol{x},\boldsymbol{y}] \\ - \mathrm{cov}[\boldsymbol{x},\boldsymbol{y}] & \mathrm{var}[\boldsymbol{y}] \\ - \end{bmatrix}. -\end{split}\]
-

Note: we have used \(1/n\) in the above definitions of the sample variance and covariance. We assume then that we can calculate the exact mean value. -What you will find in essentially all statistics texts are equations -with a factor \(1/(n-1)\). This is called Bessel’s correction. This -method corrects the bias in the estimation of the population variance -and covariance. It also partially corrects the bias in the estimation -of the population standard deviation. If you use a library like -Scikit-Learn or nunmpy’s function calculate the covariance, this -quantity will be computed with a factor \(1/(n-1)\).

-

The covariance takes values between zero and infinity and may thus -lead to problems with loss of numerical precision for particularly -large values. It is common to scale the covariance matrix by -introducing instead the correlation matrix defined via the so-called -correlation function

-
-\[ -\mathrm{corr}[\boldsymbol{x},\boldsymbol{y}]=\frac{\mathrm{cov}[\boldsymbol{x},\boldsymbol{y}]}{\sqrt{\mathrm{var}[\boldsymbol{x}] \mathrm{var}[\boldsymbol{y}]}}. -\]
-

The correlation function is then given by values \(\mathrm{corr}[\boldsymbol{x},\boldsymbol{y}] -\in [-1,1]\). This avoids eventual problems with too large values. We -can then define the correlation matrix for the two vectors \(\boldsymbol{x}\) -and \(\boldsymbol{y}\) as

-
-\[\begin{split} -\boldsymbol{K}[\boldsymbol{x},\boldsymbol{y}] = \begin{bmatrix} 1 & \mathrm{corr}[\boldsymbol{x},\boldsymbol{y}] \\ - \mathrm{corr}[\boldsymbol{y},\boldsymbol{x}] & 1 \\ - \end{bmatrix}, -\end{split}\]
-

In the above example this is the function we constructed using pandas.

-

In our derivation of the various regression algorithms like Ordinary Least Squares or Ridge regression -we defined the design/feature matrix \(\boldsymbol{X}\) as

-
-\[\begin{split} -\boldsymbol{X}=\begin{bmatrix} -x_{0,0} & x_{0,1} & x_{0,2}& \dots & \dots x_{0,p-1}\\ -x_{1,0} & x_{1,1} & x_{1,2}& \dots & \dots x_{1,p-1}\\ -x_{2,0} & x_{2,1} & x_{2,2}& \dots & \dots x_{2,p-1}\\ -\dots & \dots & \dots & \dots \dots & \dots \\ -x_{n-2,0} & x_{n-2,1} & x_{n-2,2}& \dots & \dots x_{n-2,p-1}\\ -x_{n-1,0} & x_{n-1,1} & x_{n-1,2}& \dots & \dots x_{n-1,p-1}\\ -\end{bmatrix}, -\end{split}\]
-

with \(\boldsymbol{X}\in {\mathbb{R}}^{n\times p}\), with the predictors/features \(p\) refering to the column numbers and the -entries \(n\) being the row elements. -We can rewrite the design/feature matrix in terms of its column vectors as

-
-\[ -\boldsymbol{X}=\begin{bmatrix} \boldsymbol{x}_0 & \boldsymbol{x}_1 & \boldsymbol{x}_2 & \dots & \dots & \boldsymbol{x}_{p-1}\end{bmatrix}, -\]
-

with a given vector

-
-\[ -\boldsymbol{x}_i^T = \begin{bmatrix}x_{0,i} & x_{1,i} & x_{2,i}& \dots & \dots x_{n-1,i}\end{bmatrix}. -\]
-

With these definitions, we can now rewrite our \(2\times 2\) -correlation/covariance matrix in terms of a moe general design/feature -matrix \(\boldsymbol{X}\in {\mathbb{R}}^{n\times p}\). This leads to a \(p\times p\) -covariance matrix for the vectors \(\boldsymbol{x}_i\) with \(i=0,1,\dots,p-1\)

-
-\[\begin{split} -\boldsymbol{C}[\boldsymbol{x}] = \begin{bmatrix} -\mathrm{var}[\boldsymbol{x}_0] & \mathrm{cov}[\boldsymbol{x}_0,\boldsymbol{x}_1] & \mathrm{cov}[\boldsymbol{x}_0,\boldsymbol{x}_2] & \dots & \dots & \mathrm{cov}[\boldsymbol{x}_0,\boldsymbol{x}_{p-1}]\\ -\mathrm{cov}[\boldsymbol{x}_1,\boldsymbol{x}_0] & \mathrm{var}[\boldsymbol{x}_1] & \mathrm{cov}[\boldsymbol{x}_1,\boldsymbol{x}_2] & \dots & \dots & \mathrm{cov}[\boldsymbol{x}_1,\boldsymbol{x}_{p-1}]\\ -\mathrm{cov}[\boldsymbol{x}_2,\boldsymbol{x}_0] & \mathrm{cov}[\boldsymbol{x}_2,\boldsymbol{x}_1] & \mathrm{var}[\boldsymbol{x}_2] & \dots & \dots & \mathrm{cov}[\boldsymbol{x}_2,\boldsymbol{x}_{p-1}]\\ -\dots & \dots & \dots & \dots & \dots & \dots \\ -\dots & \dots & \dots & \dots & \dots & \dots \\ -\mathrm{cov}[\boldsymbol{x}_{p-1},\boldsymbol{x}_0] & \mathrm{cov}[\boldsymbol{x}_{p-1},\boldsymbol{x}_1] & \mathrm{cov}[\boldsymbol{x}_{p-1},\boldsymbol{x}_{2}] & \dots & \dots & \mathrm{var}[\boldsymbol{x}_{p-1}]\\ -\end{bmatrix}, -\end{split}\]
-

and the correlation matrix

-
-\[\begin{split} -\boldsymbol{K}[\boldsymbol{x}] = \begin{bmatrix} -1 & \mathrm{corr}[\boldsymbol{x}_0,\boldsymbol{x}_1] & \mathrm{corr}[\boldsymbol{x}_0,\boldsymbol{x}_2] & \dots & \dots & \mathrm{corr}[\boldsymbol{x}_0,\boldsymbol{x}_{p-1}]\\ -\mathrm{corr}[\boldsymbol{x}_1,\boldsymbol{x}_0] & 1 & \mathrm{corr}[\boldsymbol{x}_1,\boldsymbol{x}_2] & \dots & \dots & \mathrm{corr}[\boldsymbol{x}_1,\boldsymbol{x}_{p-1}]\\ -\mathrm{corr}[\boldsymbol{x}_2,\boldsymbol{x}_0] & \mathrm{corr}[\boldsymbol{x}_2,\boldsymbol{x}_1] & 1 & \dots & \dots & \mathrm{corr}[\boldsymbol{x}_2,\boldsymbol{x}_{p-1}]\\ -\dots & \dots & \dots & \dots & \dots & \dots \\ -\dots & \dots & \dots & \dots & \dots & \dots \\ -\mathrm{corr}[\boldsymbol{x}_{p-1},\boldsymbol{x}_0] & \mathrm{corr}[\boldsymbol{x}_{p-1},\boldsymbol{x}_1] & \mathrm{corr}[\boldsymbol{x}_{p-1},\boldsymbol{x}_{2}] & \dots & \dots & 1\\ -\end{bmatrix}, -\end{split}\]
-

The Numpy function np.cov calculates the covariance elements using -the factor \(1/(n-1)\) instead of \(1/n\) since it assumes we do not have -the exact mean values. The following simple function uses the -np.vstack function which takes each vector of dimension \(1\times n\) -and produces a \(2\times n\) matrix \(\boldsymbol{W}\)

-

Note that this assumes you have the features as the rows, and the inputs as columns, that is

-
-\[\begin{split} -\boldsymbol{W} = \begin{bmatrix} x_0 & x_1 & x_2 & \dots & x_{n-2} & x_{n-1} \\ - y_0 & y_1 & y_2 & \dots & y_{n-2} & y_{n-1} \\ - \end{bmatrix}, -\end{split}\]
-

which in turn is converted into into the \(2\times 2\) covariance matrix -\(\boldsymbol{C}\) via the Numpy function np.cov(). We note that we can also calculate -the mean value of each set of samples \(\boldsymbol{x}\) etc using the Numpy -function np.mean(x). We can also extract the eigenvalues of the -covariance matrix through the np.linalg.eig() function.

-
-
-
# Importing various packages
-import numpy as np
-n = 100
-x = np.random.normal(size=n)
-print(np.mean(x))
-y = 4+3*x+np.random.normal(size=n)
-print(np.mean(y))
-W = np.vstack((x, y))
-C = np.cov(W)
-print(C)
-
-
-
-
-
0.0119839668275544
-3.9026821944532157
-[[ 1.21805483  3.6417002 ]
- [ 3.6417002  11.67950066]]
-
-
-
-
-

The previous example can be converted into the correlation matrix by -simply scaling the matrix elements with the variances. We should also -subtract the mean values for each column. This leads to the following -code which sets up the correlations matrix for the previous example in -a more brute force way. Here we scale the mean values for each column of the design matrix, calculate the relevant mean values and variances and then finally set up the \(2\times 2\) correlation matrix (since we have only two vectors).

-
-
-
import numpy as np
-n = 100
-# define two vectors                                                                                           
-x = np.random.random(size=n)
-y = 4+3*x+np.random.normal(size=n)
-#scaling the x and y vectors                                                                                   
-x = x - np.mean(x)
-y = y - np.mean(y)
-variance_x = np.sum(x@x)/n
-variance_y = np.sum(y@y)/n
-print(variance_x)
-print(variance_y)
-cov_xy = np.sum(x@y)/n
-cov_xx = np.sum(x@x)/n
-cov_yy = np.sum(y@y)/n
-C = np.zeros((2,2))
-C[0,0]= cov_xx/variance_x
-C[1,1]= cov_yy/variance_y
-C[0,1]= cov_xy/np.sqrt(variance_y*variance_x)
-C[1,0]= C[0,1]
-print(C)
-
-
-
-
-
0.08283349271892
-1.6319972672199556
-[[1.         0.65062105]
- [0.65062105 1.        ]]
-
-
-
-
-

We see that the matrix elements along the diagonal are one as they -should be and that the matrix is symmetric. Furthermore, diagonalizing -this matrix we easily see that it is a positive definite matrix.

-

The above procedure with numpy can be made more compact if we use pandas.

-

We whow here how we can set up the correlation matrix using pandas, as done in this simple code

-
-
-
import numpy as np
-import pandas as pd
-n = 10
-x = np.random.normal(size=n)
-x = x - np.mean(x)
-y = 4+3*x+np.random.normal(size=n)
-y = y - np.mean(y)
-# Note that we transpose the matrix in order to stay with our ordering n x p
-X = (np.vstack((x, y))).T
-print(X)
-Xpd = pd.DataFrame(X)
-print(Xpd)
-correlation_matrix = Xpd.corr()
-print(correlation_matrix)
-
-
-
-
-
[[ 0.30199745  0.72164987]
- [ 1.04858244  2.95539603]
- [ 0.46840512  1.52940309]
- [ 0.24117177  1.78848481]
- [-1.38690487 -4.17705119]
- [-0.65735283 -2.46141305]
- [ 0.94916469  2.81774574]
- [-0.52449732 -2.22140879]
- [-0.66999836 -2.66511337]
- [ 0.22943192  1.71230687]]
-          0         1
-0  0.301997  0.721650
-1  1.048582  2.955396
-2  0.468405  1.529403
-3  0.241172  1.788485
-4 -1.386905 -4.177051
-5 -0.657353 -2.461413
-6  0.949165  2.817746
-7 -0.524497 -2.221409
-8 -0.669998 -2.665113
-9  0.229432  1.712307
-          0         1
-0  1.000000  0.975127
-1  0.975127  1.000000
-
-
-
-
-

We expand this model to the Franke function discussed earlier.

-
-
-
# Common imports
-import numpy as np
-import pandas as pd
-
-
-def FrankeFunction(x,y):
-	term1 = 0.75*np.exp(-(0.25*(9*x-2)**2) - 0.25*((9*y-2)**2))
-	term2 = 0.75*np.exp(-((9*x+1)**2)/49.0 - 0.1*(9*y+1))
-	term3 = 0.5*np.exp(-(9*x-7)**2/4.0 - 0.25*((9*y-3)**2))
-	term4 = -0.2*np.exp(-(9*x-4)**2 - (9*y-7)**2)
-	return term1 + term2 + term3 + term4
-
-
-def create_X(x, y, n ):
-	if len(x.shape) > 1:
-		x = np.ravel(x)
-		y = np.ravel(y)
-
-	N = len(x)
-	l = int((n+1)*(n+2)/2)		# Number of elements in beta
-	X = np.ones((N,l))
-
-	for i in range(1,n+1):
-		q = int((i)*(i+1)/2)
-		for k in range(i+1):
-			X[:,q+k] = (x**(i-k))*(y**k)
-
-	return X
-
-
-# Making meshgrid of datapoints and compute Franke's function
-n = 4
-N = 100
-x = np.sort(np.random.uniform(0, 1, N))
-y = np.sort(np.random.uniform(0, 1, N))
-z = FrankeFunction(x, y)
-X = create_X(x, y, n=n)    
-
-Xpd = pd.DataFrame(X)
-# subtract the mean values and set up the covariance matrix
-Xpd = Xpd - Xpd.mean()
-covariance_matrix = Xpd.cov()
-print(covariance_matrix)
-
-
-
-
-
     0         1         2         3         4         5         6         7   \
-0   0.0  0.000000  0.000000  0.000000  0.000000  0.000000  0.000000  0.000000   
-1   0.0  0.096033  0.089499  0.100065  0.095636  0.091356  0.093135  0.089366   
-2   0.0  0.089499  0.084679  0.095430  0.091860  0.088348  0.090343  0.087109   
-3   0.0  0.100065  0.095430  0.109996  0.106272  0.102568  0.105983  0.102429   
-4   0.0  0.095636  0.091860  0.106272  0.103072  0.099840  0.103254  0.100074   
-5   0.0  0.091356  0.088348  0.102568  0.099840  0.097041  0.100443  0.097606   
-6   0.0  0.093135  0.090343  0.105983  0.103254  0.100443  0.104606  0.101680   
-7   0.0  0.089366  0.087109  0.102429  0.100074  0.097606  0.101680  0.099049   
-8   0.0  0.085816  0.084032  0.099028  0.097007  0.094850  0.098834  0.096471   
-9   0.0  0.082468  0.081101  0.095771  0.094052  0.092175  0.096070  0.093951   
-10  0.0  0.085269  0.083748  0.099374  0.097448  0.095375  0.099827  0.097488   
-11  0.0  0.082003  0.080845  0.096087  0.094440  0.092628  0.096955  0.094852   
-12  0.0  0.078938  0.078099  0.092968  0.091572  0.089996  0.094201  0.092313   
-13  0.0  0.076058  0.075503  0.090008  0.088838  0.087475  0.091561  0.089869   
-14  0.0  0.073350  0.073045  0.087198  0.086231  0.085061  0.089033  0.087519   
-
-          8         9         10        11        12        13        14  
-0   0.000000  0.000000  0.000000  0.000000  0.000000  0.000000  0.000000  
-1   0.085816  0.082468  0.085269  0.082003  0.078938  0.076058  0.073350  
-2   0.084032  0.081101  0.083748  0.080845  0.078099  0.075503  0.073045  
-3   0.099028  0.095771  0.099374  0.096087  0.092968  0.090008  0.087198  
-4   0.097007  0.094052  0.097448  0.094440  0.091572  0.088838  0.086231  
-5   0.094850  0.092175  0.095375  0.092628  0.089996  0.087475  0.085061  
-6   0.098834  0.096070  0.099827  0.096955  0.094201  0.091561  0.089033  
-7   0.096471  0.093951  0.097488  0.094852  0.092313  0.089869  0.087519  
-8   0.094138  0.091843  0.095173  0.092754  0.090414  0.088152  0.085968  
-9   0.091843  0.089754  0.092891  0.090673  0.088516  0.086423  0.084394  
-10  0.095173  0.092891  0.096568  0.094135  0.091779  0.089500  0.087297  
-11  0.092754  0.090673  0.094135  0.091901  0.089727  0.087616  0.085567  
-12  0.090414  0.088516  0.091779  0.089727  0.087721  0.085765  0.083859  
-13  0.088152  0.086423  0.089500  0.087616  0.085765  0.083951  0.082179  
-14  0.085968  0.084394  0.087297  0.085567  0.083859  0.082179  0.080529  
-
-
-
-
-

We note here that the covariance is zero for the first rows and -columns since all matrix elements in the design matrix were set to one -(we are fitting the function in terms of a polynomial of degree \(n\)).

-

This means that the variance for these elements will be zero and will -cause problems when we set up the correlation matrix. We can simply -drop these elements and construct a correlation -matrix without these elements.

-

We can rewrite the covariance matrix in a more compact form in terms of the design/feature matrix \(\boldsymbol{X}\) as

-
-\[ -\boldsymbol{C}[\boldsymbol{x}] = \frac{1}{n}\boldsymbol{X}^T\boldsymbol{X}= \mathbb{E}[\boldsymbol{X}^T\boldsymbol{X}]. -\]
-

To see this let us simply look at a design matrix \(\boldsymbol{X}\in {\mathbb{R}}^{2\times 2}\)

-
-\[\begin{split} -\boldsymbol{X}=\begin{bmatrix} -x_{00} & x_{01}\\ -x_{10} & x_{11}\\ -\end{bmatrix}=\begin{bmatrix} -\boldsymbol{x}_{0} & \boldsymbol{x}_{1}\\ -\end{bmatrix}. -\end{split}\]
-

If we then compute the expectation value (note the \(1/n\) factor instead of \(1/(n-1)\))

-
-\[\begin{split} -\mathbb{E}[\boldsymbol{X}^T\boldsymbol{X}] = \frac{1}{n}\boldsymbol{X}^T\boldsymbol{X}=\frac{1}{n}\begin{bmatrix} -x_{00}^2+x_{10}^2 & x_{00}x_{01}+x_{10}x_{11}\\ -x_{01}x_{00}+x_{11}x_{10} & x_{01}^2+x_{11}^2\\ -\end{bmatrix}, -\end{split}\]
-

which is just

-
-\[\begin{split} -\boldsymbol{C}[\boldsymbol{x}_0,\boldsymbol{x}_1] = \boldsymbol{C}[\boldsymbol{x}]=\begin{bmatrix} \mathrm{var}[\boldsymbol{x}_0] & \mathrm{cov}[\boldsymbol{x}_0,\boldsymbol{x}_1] \\ - \mathrm{cov}[\boldsymbol{x}_1,\boldsymbol{x}_0] & \mathrm{var}[\boldsymbol{x}_1] \\ - \end{bmatrix}, -\end{split}\]
-

where we wrote $\(\boldsymbol{C}[\boldsymbol{x}_0,\boldsymbol{x}_1] = \boldsymbol{C}[\boldsymbol{x}]\)\( to indicate that this is the covariance of the vectors \)\boldsymbol{x}\( of the design/feature matrix \)\boldsymbol{X}$.

-

It is easy to generalize this to a matrix \(\boldsymbol{X}\in {\mathbb{R}}^{n\times p}\).

-
-
-

4.9. Linking with the SVD

-

We saw earlier that

-
-\[ -\boldsymbol{X}^T\boldsymbol{X}=\boldsymbol{V}\boldsymbol{\Sigma}^T\boldsymbol{U}^T\boldsymbol{U}\boldsymbol{\Sigma}\boldsymbol{V}^T=\boldsymbol{V}\boldsymbol{\Sigma}^T\boldsymbol{\Sigma}\boldsymbol{V}^T. -\]
-

Since the matrices here have dimension \(p\times p\), with \(p\) corresponding to the singular values, we defined earlier the matrix

-
-\[\begin{split} -\boldsymbol{\Sigma}^T\boldsymbol{\Sigma} = \begin{bmatrix} \tilde{\boldsymbol{\Sigma}} & \boldsymbol{0}\\ \end{bmatrix}\begin{bmatrix} \tilde{\boldsymbol{\Sigma}} \\ \boldsymbol{0}\\ \end{bmatrix}, -\end{split}\]
-

where the tilde-matrix \(\tilde{\boldsymbol{\Sigma}}\) is a matrix of dimension \(p\times p\) containing only the singular values \(\sigma_i\), that is

-
-\[\begin{split} -\tilde{\boldsymbol{\Sigma}}=\begin{bmatrix} \sigma_0 & 0 & 0 & \dots & 0 & 0 \\ - 0 & \sigma_1 & 0 & \dots & 0 & 0 \\ - 0 & 0 & \sigma_2 & \dots & 0 & 0 \\ - 0 & 0 & 0 & \dots & \sigma_{p-2} & 0 \\ - 0 & 0 & 0 & \dots & 0 & \sigma_{p-1} \\ -\end{bmatrix}, -\end{split}\]
-

meaning we can write

-
-\[ -\boldsymbol{X}^T\boldsymbol{X}=\boldsymbol{V}\tilde{\boldsymbol{\Sigma}}^2\boldsymbol{V}^T. -\]
-

Multiplying from the right with \(\boldsymbol{V}\) (using the orthogonality of \(\boldsymbol{V}\)) we get

-
-\[ -\left(\boldsymbol{X}^T\boldsymbol{X}\right)\boldsymbol{V}=\boldsymbol{V}\tilde{\boldsymbol{\Sigma}}^2. -\]
-

This means the vectors \(\boldsymbol{v}_i\) of the orthogonal matrix \(\boldsymbol{V}\) -are the eigenvectors of the matrix \(\boldsymbol{X}^T\boldsymbol{X}\) with eigenvalues -given by the singular values squared, that is

-
-\[ -\left(\boldsymbol{X}^T\boldsymbol{X}\right)\boldsymbol{v}_i=\boldsymbol{v}_i\sigma_i^2. -\]
-

In other words, each non-zero singular value of \(\boldsymbol{X}\) is a positive -square root of an eigenvalue of \(\boldsymbol{X}^T\boldsymbol{X}\). It means also that -the columns of \(\boldsymbol{V}\) are the eigenvectors of -\(\boldsymbol{X}^T\boldsymbol{X}\). Since we have ordered the singular values of -\(\boldsymbol{X}\) in a descending order, it means that the column vectors -\(\boldsymbol{v}_i\) are hierarchically ordered by how much correlation they -encode from the columns of \(\boldsymbol{X}\).

-

Note that these are also the eigenvectors and eigenvalues of the -Hessian matrix.

-

If we now recall the definition of the covariance matrix (not using -Bessel’s correction) we have

-
-\[ -\boldsymbol{C}[\boldsymbol{X}]=\frac{1}{n}\boldsymbol{X}^T\boldsymbol{X}, -\]
-

meaning that every squared non-singular value of \(\boldsymbol{X}\) divided by \(n\) ( -the number of samples) are the eigenvalues of the covariance -matrix. Every singular value of \(\boldsymbol{X}\) is thus a positive square -root of an eigenvalue of \(\boldsymbol{X}^T\boldsymbol{X}\). If the matrix \(\boldsymbol{X}\) is -self-adjoint, the singular values of \(\boldsymbol{X}\) are equal to the -absolute value of the eigenvalues of \(\boldsymbol{X}\).

-

For \(\boldsymbol{X}\boldsymbol{X}^T\) we found

-
-\[ -\boldsymbol{X}\boldsymbol{X}^T=\boldsymbol{U}\boldsymbol{\Sigma}\boldsymbol{V}^T\boldsymbol{V}\boldsymbol{\Sigma}^T\boldsymbol{U}^T=\boldsymbol{U}\boldsymbol{\Sigma}^T\boldsymbol{\Sigma}\boldsymbol{U}^T. -\]
-

Since the matrices here have dimension \(n\times n\), we have

-
-\[\begin{split} -\boldsymbol{\Sigma}\boldsymbol{\Sigma}^T = \begin{bmatrix} \tilde{\boldsymbol{\Sigma}} \\ \boldsymbol{0}\\ \end{bmatrix}\begin{bmatrix} \tilde{\boldsymbol{\Sigma}} \boldsymbol{0}\\ \end{bmatrix}=\begin{bmatrix} \tilde{\boldsymbol{\Sigma}} & \boldsymbol{0} \\ \boldsymbol{0} & \boldsymbol{0}\\ \end{bmatrix}, -\end{split}\]
-

leading to

-
-\[\begin{split} -\boldsymbol{X}\boldsymbol{X}^T=\boldsymbol{U}\begin{bmatrix} \tilde{\boldsymbol{\Sigma}} & \boldsymbol{0} \\ \boldsymbol{0} & \boldsymbol{0}\\ \end{bmatrix}\boldsymbol{U}^T. -\end{split}\]
-

Multiplying with \(\boldsymbol{U}\) from the right gives us the eigenvalue problem

-
-\[\begin{split} -(\boldsymbol{X}\boldsymbol{X}^T)\boldsymbol{U}=\boldsymbol{U}\begin{bmatrix} \tilde{\boldsymbol{\Sigma}} & \boldsymbol{0} \\ \boldsymbol{0} & \boldsymbol{0}\\ \end{bmatrix}. -\end{split}\]
-

It means that the eigenvalues of \(\boldsymbol{X}\boldsymbol{X}^T\) are again given by -the non-zero singular values plus now a series of zeros. The column -vectors of \(\boldsymbol{U}\) are the eigenvectors of \(\boldsymbol{X}\boldsymbol{X}^T\) and -measure how much correlations are contained in the rows of \(\boldsymbol{X}\).

-

Since we will mainly be interested in the correlations among the features -of our data (the columns of \(\boldsymbol{X}\), the quantity of interest for us are the non-zero singular -values and the column vectors of \(\boldsymbol{V}\).

-
-
-

4.10. Ridge and Lasso Regression

-

Let us remind ourselves about the expression for the standard Mean Squared Error (MSE) which we used to define our cost function and the equations for the ordinary least squares (OLS) method, that is -our optimization problem is

-
-\[ -{\displaystyle \min_{\boldsymbol{\beta}\in {\mathbb{R}}^{p}}}\frac{1}{n}\left\{\left(\boldsymbol{y}-\boldsymbol{X}\boldsymbol{\beta}\right)^T\left(\boldsymbol{y}-\boldsymbol{X}\boldsymbol{\beta}\right)\right\}. -\]
-

or we can state it as

-
-\[ -{\displaystyle \min_{\boldsymbol{\beta}\in -{\mathbb{R}}^{p}}}\frac{1}{n}\sum_{i=0}^{n-1}\left(y_i-\tilde{y}_i\right)^2=\frac{1}{n}\vert\vert \boldsymbol{y}-\boldsymbol{X}\boldsymbol{\beta}\vert\vert_2^2, -\]
-

where we have used the definition of a norm-2 vector, that is

-
-\[ -\vert\vert \boldsymbol{x}\vert\vert_2 = \sqrt{\sum_i x_i^2}. -\]
-

By minimizing the above equation with respect to the parameters -\(\boldsymbol{\beta}\) we could then obtain an analytical expression for the -parameters \(\boldsymbol{\beta}\). We can add a regularization parameter \(\lambda\) by -defining a new cost function to be optimized, that is

-
-\[ -{\displaystyle \min_{\boldsymbol{\beta}\in -{\mathbb{R}}^{p}}}\frac{1}{n}\vert\vert \boldsymbol{y}-\boldsymbol{X}\boldsymbol{\beta}\vert\vert_2^2+\lambda\vert\vert \boldsymbol{\beta}\vert\vert_2^2 -\]
-

which leads to the Ridge regression minimization problem where we -require that \(\vert\vert \boldsymbol{\beta}\vert\vert_2^2\le t\), where \(t\) is -a finite number larger than zero. By defining

-
-\[ -C(\boldsymbol{X},\boldsymbol{\beta})=\frac{1}{n}\vert\vert \boldsymbol{y}-\boldsymbol{X}\boldsymbol{\beta}\vert\vert_2^2+\lambda\vert\vert \boldsymbol{\beta}\vert\vert_1, -\]
-

we have a new optimization equation

-
-\[ -{\displaystyle \min_{\boldsymbol{\beta}\in -{\mathbb{R}}^{p}}}\frac{1}{n}\vert\vert \boldsymbol{y}-\boldsymbol{X}\boldsymbol{\beta}\vert\vert_2^2+\lambda\vert\vert \boldsymbol{\beta}\vert\vert_1 -\]
-

which leads to Lasso regression. Lasso stands for least absolute shrinkage and selection operator.

-

Here we have defined the norm-1 as

-
-\[ -\vert\vert \boldsymbol{x}\vert\vert_1 = \sum_i \vert x_i\vert. -\]
-

Using the matrix-vector expression for Ridge regression and dropping the parameter \(1/n\) in front of the standard means squared error equation, we have

-
-\[ -C(\boldsymbol{X},\boldsymbol{\beta})=\left\{(\boldsymbol{y}-\boldsymbol{X}\boldsymbol{\beta})^T(\boldsymbol{y}-\boldsymbol{X}\boldsymbol{\beta})\right\}+\lambda\boldsymbol{\beta}^T\boldsymbol{\beta}, -\]
-

and -taking the derivatives with respect to \(\boldsymbol{\beta}\) we obtain then -a slightly modified matrix inversion problem which for finite values -of \(\lambda\) does not suffer from singularity problems. We obtain -the optimal parameters

-
-\[ -\hat{\boldsymbol{\beta}}_{\mathrm{Ridge}} = \left(\boldsymbol{X}^T\boldsymbol{X}+\lambda\boldsymbol{I}\right)^{-1}\boldsymbol{X}^T\boldsymbol{y}, -\]
-

with \(\boldsymbol{I}\) being a \(p\times p\) identity matrix with the constraint that

-
-\[ -\sum_{i=0}^{p-1} \beta_i^2 \leq t, -\]
-

with \(t\) a finite positive number.

-

When we compare this with the ordinary least squares result we have

-
-\[ -\hat{\boldsymbol{\beta}}_{\mathrm{OLS}} = \left(\boldsymbol{X}^T\boldsymbol{X}\right)^{-1}\boldsymbol{X}^T\boldsymbol{y}, -\]
-

which can lead to singular matrices. However, with the SVD, we can always compute the inverse of the matrix \(\boldsymbol{X}^T\boldsymbol{X}\).

-

We see that Ridge regression is nothing but the standard OLS with a -modified diagonal term added to \(\boldsymbol{X}^T\boldsymbol{X}\). The consequences, in -particular for our discussion of the bias-variance tradeoff are rather -interesting. We will see that for specific values of \(\lambda\), we may -even reduce the variance of the optimal parameters \(\boldsymbol{\beta}\). These topics and other related ones, will be discussed after the more linear algebra oriented analysis here.

-

Using our insights about the SVD of the design matrix \(\boldsymbol{X}\) -We have already analyzed the OLS solutions in terms of the eigenvectors (the columns) of the right singular value matrix \(\boldsymbol{U}\) as

-
-\[ -\tilde{\boldsymbol{y}}_{\mathrm{OLS}}=\boldsymbol{X}\boldsymbol{\beta} =\boldsymbol{U}\boldsymbol{U}^T\boldsymbol{y}. -\]
-

For Ridge regression this becomes

-
-\[ -\tilde{\boldsymbol{y}}_{\mathrm{Ridge}}=\boldsymbol{X}\boldsymbol{\beta}_{\mathrm{Ridge}} = \boldsymbol{U\Sigma V^T}\left(\boldsymbol{V}\boldsymbol{\Sigma}^2\boldsymbol{V}^T+\lambda\boldsymbol{I} \right)^{-1}(\boldsymbol{U\Sigma V^T})^T\boldsymbol{y}=\sum_{j=0}^{p-1}\boldsymbol{u}_j\boldsymbol{u}_j^T\frac{\sigma_j^2}{\sigma_j^2+\lambda}\boldsymbol{y}, -\]
-

with the vectors \(\boldsymbol{u}_j\) being the columns of \(\boldsymbol{U}\) from the SVD of the matrix \(\boldsymbol{X}\).

-

Since \(\lambda \geq 0\), it means that compared to OLS, we have

-
-\[ -\frac{\sigma_j^2}{\sigma_j^2+\lambda} \leq 1. -\]
-

Ridge regression finds the coordinates of \(\boldsymbol{y}\) with respect to the -orthonormal basis \(\boldsymbol{U}\), it then shrinks the coordinates by -\(\frac{\sigma_j^2}{\sigma_j^2+\lambda}\). Recall that the SVD has -eigenvalues ordered in a descending way, that is \(\sigma_i \geq -\sigma_{i+1}\).

-

For small eigenvalues \(\sigma_i\) it means that their contributions become less important, a fact which can be used to reduce the number of degrees of freedom. More about this when we have covered the material on a statistical interpretation of various linear regression methods.

-

For the sake of simplicity, let us assume that the design matrix is orthonormal, that is

-
-\[ -\boldsymbol{X}^T\boldsymbol{X}=(\boldsymbol{X}^T\boldsymbol{X})^{-1} =\boldsymbol{I}. -\]
-

In this case the standard OLS results in

-
-\[ -\boldsymbol{\beta}^{\mathrm{OLS}} = \boldsymbol{X}^T\boldsymbol{y}=\sum_{i=0}^{p-1}\boldsymbol{u}_j\boldsymbol{u}_j^T\boldsymbol{y}, -\]
-

and

-
-\[ -\boldsymbol{\beta}^{\mathrm{Ridge}} = \left(\boldsymbol{I}+\lambda\boldsymbol{I}\right)^{-1}\boldsymbol{X}^T\boldsymbol{y}=\left(1+\lambda\right)^{-1}\boldsymbol{\beta}^{\mathrm{OLS}}, -\]
-

that is the Ridge estimator scales the OLS estimator by the inverse of a factor \(1+\lambda\), and -the Ridge estimator converges to zero when the hyperparameter goes to -infinity.

-

We will come back to more interpreations after we have gone through some of the statistical analysis part.

-

Using the matrix-vector expression for Lasso regression and dropping the parameter \(1/n\) in front of the standard mean squared error equation, we have the following cost function

-
-\[ -C(\boldsymbol{X},\boldsymbol{\beta})=\left\{(\boldsymbol{y}-\boldsymbol{X}\boldsymbol{\beta})^T(\boldsymbol{y}-\boldsymbol{X}\boldsymbol{\beta})\right\}+\lambda\vert\vert\boldsymbol{\beta}\vert\vert_1, -\]
-

Taking the derivative with respect to \(\boldsymbol{\beta}\) and recalling that the derivative of the absolute value is (we drop the boldfaced vector symbol for simplicty)

-
-\[\begin{split} -\frac{d \vert \beta\vert}{d \boldsymbol{\beta}}=\mathrm{sgn}(\boldsymbol{\beta})=\left\{\begin{array}{cc} 1 & \beta > 0 \\ 0 & \beta =0\\-1 & \beta < 0, \end{array}\right. -\end{split}\]
-

we have that the derivative of the cost function is

-
-\[ -\frac{\partial C(\boldsymbol{X},\boldsymbol{\beta})}{\partial \boldsymbol{\beta}}=-2\boldsymbol{X}^T(\boldsymbol{y}-\boldsymbol{X}\boldsymbol{\beta})+\lambda sgn(\boldsymbol{\beta})=0, -\]
-

and reordering we have

-
-\[ -\boldsymbol{X}^T\boldsymbol{X}\boldsymbol{\beta}+\lambda sgn(\boldsymbol{\beta})=2\boldsymbol{X}^T\boldsymbol{y}. -\]
-

This equation does not lead to a nice analytical equation as in Ridge regression or ordinary least squares. This equation can however be solved by using standard convex optimization algorithms using for example the Python package CVXOPT. We will discuss this later.

-

Let us assume that our design matrix is given by unit (identity) matrix, that is a square diagonal matrix with ones only along the -diagonal. In this case we have an equal number of rows and columns \(n=p\).

-

Our model approximation is just \(\tilde{\boldsymbol{y}}=\boldsymbol{\beta}\) and the mean squared error and thereby the cost function for ordinary least sqquares (OLS) is then (we drop the term \(1/n\))

-
-\[ -C(\boldsymbol{\beta})=\sum_{i=0}^{p-1}(y_i-\beta_i)^2, -\]
-

and minimizing we have that

-
-\[ -\hat{\beta}_i^{\mathrm{OLS}} = y_i. -\]
-

For Ridge regression our cost function is

-
-\[ -C(\boldsymbol{\beta})=\sum_{i=0}^{p-1}(y_i-\beta_i)^2+\lambda\sum_{i=0}^{p-1}\beta_i^2, -\]
-

and minimizing we have that

-
-\[ -\hat{\beta}_i^{\mathrm{Ridge}} = \frac{y_i}{1+\lambda}. -\]
-

For Lasso regression our cost function is

-
-\[ -C(\boldsymbol{\beta})=\sum_{i=0}^{p-1}(y_i-\beta_i)^2+\lambda\sum_{i=0}^{p-1}\vert\beta_i\vert=\sum_{i=0}^{p-1}(y_i-\beta_i)^2+\lambda\sum_{i=0}^{p-1}\sqrt{\beta_i^2}, -\]
-

and minimizing we have that

-
-\[ --2\sum_{i=0}^{p-1}(y_i-\beta_i)+\lambda \sum_{i=0}^{p-1}\frac{(\beta_i)}{\vert\beta_i\vert}=0, -\]
-

which leads to

-
-\[\begin{split} -\hat{\boldsymbol{\beta}}_i^{\mathrm{Lasso}} = \left\{\begin{array}{ccc}y_i-\frac{\lambda}{2} &\mathrm{if} & y_i> \frac{\lambda}{2}\\ - y_i+\frac{\lambda}{2} &\mathrm{if} & y_i< -\frac{\lambda}{2}\\ - 0 &\mathrm{if} & \vert y_i\vert\le \frac{\lambda}{2}\end{array}\right.\\. -\end{split}\]
-

Plotting these results (figure in handwritten notes for week 36) shows clearly that Lasso regression suppresses (sets to zero) values of \(\beta_i\) for specific values of \(\lambda\). Ridge regression reduces on the other hand the values of \(\beta_i\) as function of \(\lambda\).

-

As another examples, -let us assume we have a data set with outputs/targets given by the vector

-
-\[\begin{split} -\boldsymbol{y}=\begin{bmatrix}4 \\ 2 \\3\end{bmatrix}, -\end{split}\]
-

and our inputs as a \(3\times 2\) design matrix

-
-\[\begin{split} -\boldsymbol{X}=\begin{bmatrix}2 & 0\\ 0 & 1 \\ 0 & 0\end{bmatrix}, -\end{split}\]
-

meaning that we have two features and two unknown parameters \(\beta_0\) and \(\beta_1\) to be determined either by ordinary least squares, Ridge or Lasso regression.

-

For ordinary least squares (OLS) we know that the optimal solution is

-
-\[ -\hat{\boldsymbol{\beta}}^{\mathrm{OLS}}=\left( \boldsymbol{X}^T\boldsymbol{X}\right)^{-1}\boldsymbol{X}^T\boldsymbol{y}. -\]
-

Inserting the above values we obtain that

-
-\[\begin{split} -\hat{\boldsymbol{\beta}}^{\mathrm{OLS}}=\begin{bmatrix}2 \\ 2\end{bmatrix}, -\end{split}\]
-

The code which implements this simpler case is presented after the discussion of Ridge and Lasso.

-

For Ridge regression we have

-
-\[ -\hat{\boldsymbol{\beta}}^{\mathrm{Ridge}}=\left( \boldsymbol{X}^T\boldsymbol{X}+\lambda\boldsymbol{I}\right)^{-1}\boldsymbol{X}^T\boldsymbol{y}. -\]
-

Inserting the above values we obtain that

-
-\[\begin{split} -\hat{\boldsymbol{\beta}}^{\mathrm{Ridge}}=\begin{bmatrix}\frac{8}{4+\lambda} \\ \frac{2}{1+\lambda}\end{bmatrix}, -\end{split}\]
-

There is normally a constraint on the value of \(\vert\vert \boldsymbol{\beta}\vert\vert_2\) via the parameter \(\lambda\). -Let us for simplicity assume that \(\beta_0^2+\beta_1^2=1\) as constraint. This will allow us to find an expression for the optimal values of \(\beta\) and \(\lambda\).

-

To see this, let us write the cost function for Ridge regression.

-

We define the MSE without the \(1/n\) factor and have then, using that

-
-\[\begin{split} -\boldsymbol{X}\boldsymbol{\beta}=\begin{bmatrix} 2\beta_0 \\ \beta_1 \\0 \end{bmatrix}, -\end{split}\]
-
-\[ -C(\boldsymbol{\beta})=(4-2\beta_0)^2+(2-\beta_1)^2+\lambda(\beta_0^2+\beta_1^2), -\]
-

and taking the derivative with respect to \(\beta_0\) we get

-
-\[ -\beta_0=\frac{8}{4+\lambda}, -\]
-

and for \(\beta_1\) we obtain

-
-\[ -\beta_1=\frac{2}{1+\lambda}, -\]
-

Using the constraint for \(\beta_0^2+\beta_1^2=1\) we can constrain \(\lambda\) by solving

-
-\[ -\left(\frac{8}{4+\lambda}\right)^2+\left(\frac{2}{1+\lambda}\right)^2=1, -\]
-

which gives \(\lambda=4.571\) and \(\beta_0=0.933\) and \(\beta_1=0.359\).

-

For Lasso we need now, keeping a constraint on \(\vert\beta_0\vert+\vert\beta_1\vert=1\), to take the derivative of the absolute values of \(\beta_0\) -and \(\beta_1\). This gives us the following derivatives of the cost function

-
-\[ -C(\boldsymbol{\beta})=(4-2\beta_0)^2+(2-\beta_1)^2+\lambda(\vert\beta_0\vert+\vert\beta_1\vert), -\]
-
-\[ -\frac{\partial C(\boldsymbol{\beta})}{\partial \beta_0}=-4(4-2\beta_0)+\lambda\mathrm{sgn}(\beta_0)=0, -\]
-

and

-
-\[ -\frac{\partial C(\boldsymbol{\beta})}{\partial \beta_1}=-2(2-\beta_1)+\lambda\mathrm{sgn}(\beta_1)=0. -\]
-

We have now four cases to solve besides the trivial cases \(\beta_0\) and/or \(\beta_1\) are zero, namely

-
    -
  1. \(\beta_0 > 0\) and \(\beta_1 > 0\),

  2. -
  3. \(\beta_0 > 0\) and \(\beta_1 < 0\),

  4. -
  5. \(\beta_0 < 0\) and \(\beta_1 > 0\),

  6. -
  7. \(\beta_0 < 0\) and \(\beta_1 < 0\).

  8. -
-

If we consider the first case, we have then

-
-\[ --4(4-2\beta_0)+\lambda=0, -\]
-

and

-
-\[ --2(2-\beta_1)+\lambda=0. -\]
-

which yields

-
-\[ -\beta_0=\frac{16+\lambda}{8}, -\]
-

and

-
-\[ -\beta_1=\frac{4+\lambda}{2}. -\]
-

Using the constraint on \(\beta_0\) and \(\beta_1\) we can then find the optimal value of \(\lambda\) for the different cases. We leave this as an exercise to you.

-

Here we set up the OLS, Ridge and Lasso functionality in order to study the above example. Note that here we have opted for a set of values of \(\lambda\), meaning that we need to perform a search in order to find the optimal values.

-

First we study and compare the OLS and Ridge results. The next code compares all three methods. -We select values of the hyperparameter \(\lambda\in [10^{-4},10^4]\) and compute the predicted values for ordinary least squares and Ridge regression.

-
-
-
%matplotlib inline
-
-import os
-import numpy as np
-import pandas as pd
-import matplotlib.pyplot as plt
-
-def R2(y_data, y_model):
-    return 1 - np.sum((y_data - y_model) ** 2) / np.sum((y_data - np.mean(y_data)) ** 2)
-def MSE(y_data,y_model):
-    n = np.size(y_model)
-    return np.sum((y_data-y_model)**2)/n
-
-
-# A seed just to ensure that the random numbers are the same for every run.
-# Useful for eventual debugging.
-
-X = np.array( [ [ 2, 0], [0, 1], [0,0]])
-y = np.array( [4, 2, 3])
-
-
-# matrix inversion to find beta
-OLSbeta = np.linalg.inv(X.T @ X) @ X.T @ y
-print(OLSbeta)
-# and then make the prediction
-ytildeOLS = X @ OLSbeta
-print("Training MSE for OLS")
-print(MSE(y,ytildeOLS))
-ypredictOLS = X @ OLSbeta
-
-# Repeat now for Ridge regression and various values of the regularization parameter
-I = np.eye(2,2)
-# Decide which values of lambda to use
-nlambdas = 100
-MSEPredict = np.zeros(nlambdas)
-lambdas = np.logspace(-4, 4, nlambdas)
-for i in range(nlambdas):
-    lmb = lambdas[i]
-    Ridgebeta = np.linalg.inv(X.T @ X+lmb*I) @ X.T @ y
-#    print(Ridgebeta)
-    # and then make the prediction
-    ypredictRidge = X @ Ridgebeta
-    MSEPredict[i] = MSE(y,ypredictRidge)
-#    print(MSEPredict[i])
-    # Now plot the results
-plt.figure()
-plt.plot(np.log10(lambdas), MSEPredict, 'r--', label = 'MSE Ridge Train')
-plt.xlabel('log10(lambda)')
-plt.ylabel('MSE')
-plt.legend()
-plt.show()
-
-
-
-
-
[2. 2.]
-Training MSE for OLS
-3.0
-
-
-_images/chapter2_245_1.png -
-
-

We see here that we reach a plateau for the Ridge results. Writing out the coefficients \(\boldsymbol{\beta}\), we that they are getting smaller and smaller and our error stabilizes since the predicted values of \(\tilde{\boldsymbol{y}}\) approach zero.

-

This happens also for Lasso regression, as seen from the next code -output. The difference is that Lasso shrinks the values of \(\beta\) to -zero at a much earlier stage and the results flatten out. We see that -Lasso gives also an excellent fit for small values of \(\lambda\) and -shows rthe best performance of the three regression methods.

-
-
-
import os
-import numpy as np
-import pandas as pd
-import matplotlib.pyplot as plt
-from sklearn import linear_model
-
-def R2(y_data, y_model):
-    return 1 - np.sum((y_data - y_model) ** 2) / np.sum((y_data - np.mean(y_data)) ** 2)
-def MSE(y_data,y_model):
-    n = np.size(y_model)
-    return np.sum((y_data-y_model)**2)/n
-
-
-# A seed just to ensure that the random numbers are the same for every run.
-# Useful for eventual debugging.
-
-X = np.array( [ [ 2, 0], [0, 1], [0,0]])
-y = np.array( [4, 2, 3])
-
-
-# matrix inversion to find beta
-OLSbeta = np.linalg.inv(X.T @ X) @ X.T @ y
-print(OLSbeta)
-# and then make the prediction
-ytildeOLS = X @ OLSbeta
-print("Training MSE for OLS")
-print(MSE(y,ytildeOLS))
-ypredictOLS = X @ OLSbeta
-
-# Repeat now for Ridge regression and various values of the regularization parameter
-I = np.eye(2,2)
-# Decide which values of lambda to use
-nlambdas = 100
-MSERidgePredict = np.zeros(nlambdas)
-MSELassoPredict = np.zeros(nlambdas)
-lambdas = np.logspace(-4, 4, nlambdas)
-for i in range(nlambdas):
-    lmb = lambdas[i]
-    Ridgebeta = np.linalg.inv(X.T @ X+lmb*I) @ X.T @ y
-    print(Ridgebeta)
-    # and then make the prediction
-    ypredictRidge = X @ Ridgebeta
-    MSERidgePredict[i] = MSE(y,ypredictRidge)
-    RegLasso = linear_model.Lasso(lmb)
-    RegLasso.fit(X,y)
-    ypredictLasso = RegLasso.predict(X)
-    print(RegLasso.coef_)
-    MSELassoPredict[i] = MSE(y,ypredictLasso)
-# Now plot the results
-plt.figure()
-plt.plot(np.log10(lambdas), MSERidgePredict, 'r--', label = 'MSE Ridge Train')
-plt.plot(np.log10(lambdas), MSELassoPredict, 'r--', label = 'MSE Lasso Train')
-plt.xlabel('log10(lambda)')
-plt.ylabel('MSE')
-plt.legend()
-plt.show()
-
-
-
-
-
[2. 2.]
-Training MSE for OLS
-3.0
-[1.99995    1.99980002]
-[ 0.50001525 -0.99953475]
-[1.99993978 1.99975913]
-[ 0.50001525 -0.99944272]
-[1.99992746 1.99970988]
-[ 0.50001525 -0.99933188]
-[1.99991263 1.99965056]
-[ 0.50001525 -0.99919837]
-[1.99989476 1.99957911]
-[ 0.50001524 -0.99903755]
-[1.99987324 1.99949306]
-[ 0.50001524 -0.99884384]
-[1.99984732 1.99938942]
-[ 0.50001524 -0.99861053]
-[1.9998161  1.99926459]
-[ 0.50001523 -0.9983295 ]
-[1.99977849 1.99911427]
-[ 0.50001523 -0.99799099]
-[1.9997332  1.99893323]
-[ 0.50001522 -0.99758326]
-[1.99967865 1.99871521]
-[ 0.50001521 -0.99709215]
-[1.99961294 1.99845267]
-[ 0.50001521 -0.99650061]
-[1.99953381 1.99813653]
-[ 0.50001519 -0.99578809]
-[1.9994385  1.99775587]
-[ 0.50001518 -0.99492986]
-[1.9993237  1.99729756]
-[ 0.50001517 -0.99389612]
-[1.99918546 1.9967458 ]
-[ 0.50001515 -0.99265097]
-[1.99901896 1.99608161]
-[ 0.50001512 -0.99115119]
-[1.99881845 1.99528218]
-[ 0.5000151 -0.9893447]
-[1.998577  1.9943201]
-[ 0.50001506 -0.98716878]
-[1.99828624 1.99316252]
-[ 0.50001502 -0.98454786]
-[1.99793613 1.99176998]
-[ 0.50001498 -0.98139097]
-[1.99751458 1.99009525]
-[ 0.50001492 -0.97758848]
-[1.99700706 1.98808176]
-[ 0.50001485 -0.97300836]
-[1.9963961  1.98566191]
-[ 0.50001476 -0.9674916 ]
-[1.99566069 1.98275501]
-[ 0.50001466 -0.96084663]
-[1.9947756  1.97926491]
-[ 0.50001454 -0.95284275]
-[1.99371056 1.97507735]
-[ 0.50001439 -0.94320205]
-[1.99242921 1.97005689]
-[ 0.50001422 -0.93158979]
-[1.99088801 1.9640435 ]
-[ 0.500014   -0.91760278]
-[1.9890348  1.95684892]
-[ 0.50001374 -0.90075537]
-[1.98680716 1.9482527 ]
-[ 0.50001343 -0.88046261]
-[1.98413059 1.93799826]
-[ 0.50001306 -0.85601992]
-[1.98091621 1.92578916]
-[ 0.50001261 -0.8265786 ]
-[1.97705827 1.91128596]
-[ 0.50001207 -0.79111643]
-[1.97243128 1.89410423]
-[ 0.50001142 -0.74840212]
-[1.96688672 1.87381451]
-[ 0.50001063 -0.69695259]
-[1.96024953 1.84994524]
-[ 0.50000969 -0.63498144]
-[1.95231424 1.82198978]
-[ 0.50000855 -0.56033697]
-[1.94284104 1.78941903]
-[ 0.50000718 -0.47042744]
-[1.93155188 1.75170092]
-[ 0.50000553 -0.3621311 ]
-[1.91812702 1.70832814]
-[ 0.50001414 -0.23167717]
-[1.90220243 1.65885453]
-[ 0.50000455 -0.07456491]
-[1.88336879 1.60293962]
-[ 0.47132891 -0.        ]
-[1.86117291 1.54039921]
-[ 0.41433969 -0.        ]
-[1.83512277 1.47125748]
-[ 0.34569596 -0.        ]
-[1.80469739 1.39579407]
-[ 0.26301436 -0.        ]
-[1.76936315 1.31457796]
-[ 0.16342407 -0.        ]
-[1.72859758 1.22847924]
-[ 0.04346721 -0.        ]
-[1.68192193 1.13865173]
-[ 0. -0.]
-[1.62894215 1.04648335]
-[ 0. -0.]
-[1.56939714 0.95351665]
-[ 0. -0.]
-[1.50321091 0.86134827]
-[ 0. -0.]
-[1.43054282 0.77152076]
-[ 0. -0.]
-[1.35182854 0.68542204]
-[ 0. -0.]
-[1.26780278 0.60420593]
-[ 0. -0.]
-[1.17949575 0.52874252]
-[ 0. -0.]
-[1.0881981  0.45960079]
-[ 0. -0.]
-[0.99539415 0.39706038]
-[ 0. -0.]
-[0.90266948 0.34114547]
-[ 0. -0.]
-[0.81160425 0.29167186]
-[ 0. -0.]
-[0.7236674  0.24829908]
-[ 0. -0.]
-[0.64012627 0.21058097]
-[ 0. -0.]
-[0.56198284 0.17801022]
-[ 0. -0.]
-[0.48994188 0.15005476]
-[ 0. -0.]
-[0.42441033 0.12618549]
-[ 0. -0.]
-[0.3655222  0.10589577]
-[ 0. -0.]
-[0.31318084 0.08871404]
-[ 0. -0.]
-[0.26710969 0.07421084]
-[ 0. -0.]
-[0.22690428 0.06200174]
-[ 0. -0.]
-[0.19207979 0.0517473 ]
-[ 0. -0.]
-[0.16211139 0.04315108]
-[ 0. -0.]
-[0.13646574 0.0359565 ]
-[ 0. -0.]
-[0.11462415 0.02994311]
-[ 0. -0.]
-[0.09609807 0.02492265]
-[ 0. -0.]
-[0.08043851 0.02073509]
-[ 0. -0.]
-[0.06724062 0.01724499]
-[ 0. -0.]
-[0.05614483 0.01433809]
-[ 0. -0.]
-[0.04683565 0.01191824]
-[ 0. -0.]
-[0.039039   0.00990475]
-[ 0. -0.]
-[0.03251863 0.00823002]
-[ 0. -0.]
-[0.02707227 0.00683748]
-[ 0. -0.]
-[0.02252765 0.0056799 ]
-[ 0. -0.]
-[0.01873869 0.00471782]
-[ 0. -0.]
-[0.01558197 0.00391839]
-[ 0. -0.]
-[0.01295356 0.0032542 ]
-[ 0. -0.]
-[0.01076611 0.00270244]
-[ 0. -0.]
-[0.00894639 0.00224413]
-[ 0. -0.]
-[0.0074331  0.00186347]
-[ 0. -0.]
-[0.00617499 0.00154733]
-[ 0. -0.]
-[0.00512927 0.00128479]
-[ 0. -0.]
-[0.00426027 0.00106677]
-[ 0. -0.]
-[0.00353823 0.00088573]
-[ 0. -0.]
-[0.00293838 0.00073541]
-[ 0. -0.]
-[0.0024401  0.00061058]
-[ 0. -0.]
-[0.00202624 0.00050694]
-[ 0. -0.]
-[0.00168251 0.00042089]
-[ 0. -0.]
-[0.00139705 0.00034944]
-[ 0. -0.]
-[0.00115999 0.00029012]
-[ 0. -0.]
-[0.00096314 0.00024087]
-[ 0. -0.]
-[0.00079968 0.00019998]
-[ 0. -0.]
-
-
-_images/chapter2_247_1.png -
-
-

We bring then back our exponential function example and study all -three regression methods. Depending on the level of noise, we note -that for small values of the hyperparameter \(\lambda\) all three -methods produce the same mean squared error. Again, Lasso shrinks the -parameter values to zero much earlier than Ridge regression and the -Lasso results flatten out much earlier since all \(\beta_j=0\) (check -this by printing the values). This case is an example of where OLS -performs best. Lasso and Ridge reproduce the OLS results for a limited -set of \(\lambda\) values.

-
-
-
import os
-import numpy as np
-import pandas as pd
-import matplotlib.pyplot as plt
-from sklearn.model_selection import train_test_split
-from sklearn import linear_model
-
-def R2(y_data, y_model):
-    return 1 - np.sum((y_data - y_model) ** 2) / np.sum((y_data - np.mean(y_data)) ** 2)
-def MSE(y_data,y_model):
-    n = np.size(y_model)
-    return np.sum((y_data-y_model)**2)/n
-
-
-# A seed just to ensure that the random numbers are the same for every run.
-# Useful for eventual debugging.
-np.random.seed(3155)
-
-x = np.random.rand(100)
-y = 2.0+5*x*x+0.1*np.random.randn(100)
-
-# number of features p (here degree of polynomial
-p = 3
-#  The design matrix now as function of a given polynomial
-X = np.zeros((len(x),p))
-X[:,0] = 1.0
-X[:,1] = x
-X[:,2] = x*x
-# We split the data in test and training data
-X_train, X_test, y_train, y_test = train_test_split(X, y, test_size=0.2)
-
-# matrix inversion to find beta
-OLSbeta = np.linalg.inv(X_train.T @ X_train) @ X_train.T @ y_train
-print(OLSbeta)
-# and then make the prediction
-ytildeOLS = X_train @ OLSbeta
-print("Training MSE for OLS")
-print(MSE(y_train,ytildeOLS))
-ypredictOLS = X_test @ OLSbeta
-print("Test MSE OLS")
-print(MSE(y_test,ypredictOLS))
-
-# Repeat now for Lasso and Ridge regression and various values of the regularization parameter
-I = np.eye(p,p)
-# Decide which values of lambda to use
-nlambdas = 100
-MSEPredict = np.zeros(nlambdas)
-MSETrain = np.zeros(nlambdas)
-MSELassoPredict = np.zeros(nlambdas)
-MSELassoTrain = np.zeros(nlambdas)
-lambdas = np.logspace(-4, 4, nlambdas)
-for i in range(nlambdas):
-    lmb = lambdas[i]
-    Ridgebeta = np.linalg.inv(X_train.T @ X_train+lmb*I) @ X_train.T @ y_train
-    # include lasso using Scikit-Learn
-    RegLasso = linear_model.Lasso(lmb)
-    RegLasso.fit(X_train,y_train)
-    # and then make the prediction
-    ytildeRidge = X_train @ Ridgebeta
-    ypredictRidge = X_test @ Ridgebeta
-    ytildeLasso = RegLasso.predict(X_train)
-    ypredictLasso = RegLasso.predict(X_test)
-    MSEPredict[i] = MSE(y_test,ypredictRidge)
-    MSETrain[i] = MSE(y_train,ytildeRidge)
-    MSELassoPredict[i] = MSE(y_test,ypredictLasso)
-    MSELassoTrain[i] = MSE(y_train,ytildeLasso)
-
-# Now plot the results
-plt.figure()
-plt.plot(np.log10(lambdas), MSETrain, label = 'MSE Ridge train')
-plt.plot(np.log10(lambdas), MSEPredict, 'r--', label = 'MSE Ridge Test')
-plt.plot(np.log10(lambdas), MSELassoTrain, label = 'MSE Lasso train')
-plt.plot(np.log10(lambdas), MSELassoPredict, 'r--', label = 'MSE Lasso Test')
-
-plt.xlabel('log10(lambda)')
-plt.ylabel('MSE')
-plt.legend()
-plt.show()
-
-
-
-
-
[ 2.03099776 -0.17917768  5.18029127]
-Training MSE for OLS
-0.009163470508352228
-Test MSE OLS
-0.008675369724976777
-
-
-_images/chapter2_249_1.png -
-
-

Both these example send a clear message. The addition of a -shrinkage/regularization term implies that we need to perform a search -for the optimal values of \(\lambda\). We will see this throughout these -series of lectures.

-

As a small addendum, we note that you can also solve this problem using the convex optimization package CVXOPT. This requires, in addition to having installed CVXOPT, you need to download the file l1regl.py. -The following code example solves the simpler problem we discussed above, where we have added the latter python file.

-
-
-
from cvxopt import matrix, spdiag, mul, div, sqrt, normal, setseed
-from cvxopt import blas, lapack, solvers, sparse, spmatrix
-import math
-
-try:
-    import mosek
-    import sys
-    __MOSEK = True
-except: __MOSEK = False
-
-if __MOSEK:
-
-    def l1regls_mosek(A, b):
-        """
-
-        Returns the solution of l1-norm regularized least-squares problem
-
-            minimize    || A*x - b ||_2^2  + e'*u
-
-            subject to  -u <= x <= u
-
-        """
-
-        m, n = A.size
-
-        env  = mosek.Env()
-        task = env.Task(0,0)
-        task.set_Stream(mosek.streamtype.log, lambda x: sys.stdout.write(x))
-
-        task.appendvars( 2*n)            # number of variables
-        task.appendcons( 2*n)            # number of constraints
-
-        # input quadratic objective
-        Q = matrix(0.0, (n,n)) 
-        blas.syrk(A, Q, alpha = 2.0, trans='T')
-
-        I = []
-        for i in range(n):
-            I.extend(range(i,n))
-
-        J = []
-        for i in range(n):
-            J.extend((n-i)*[i])
-
-        task.putqobj(I, J, list(Q[matrix(I) + matrix(J)*n]))
-        task.putclist(range(2*n), list(-2*A.T*b) + n*[1.0])  # setup linear objective
-
-        # input constraint matrix row by row
-        for i in range(n):
-            task.putarow(   i, [i, n+i], [1.0, -1.0])
-            task.putarow( n+i, [i, n+i], [1.0,  1.0])
-
-        # setup bounds on constraints
-        task.putboundslice(mosek.accmode.con,
-                           0, n, n*[mosek.boundkey.up], n*[0.0], n*[0.0])
-        task.putboundslice(mosek.accmode.con,
-                           n, 2*n, n*[mosek.boundkey.lo], n*[0.0], n*[0.0])
-
-        # setup variable bounds
-        task.putboundslice(mosek.accmode.var,
-                           0, 2*n, 2*n*[mosek.boundkey.fr], 2*n*[0.0], 2*n*[0.0])
-
-        # optimize the task
-        task.putobjsense(mosek.objsense.minimize)
-        task.optimize()
-        task.solutionsummary(mosek.streamtype.log)
-        x = n*[0.0]
-        task.getsolutionslice(mosek.soltype.itr, mosek.solitem.xx, 0, n, x)
-
-        return matrix(x)
-
-    def l1regls_mosek2(A, b):
-        """
-
-        Returns the solution of l1-norm regularized least-squares problem
-
-            minimize     w'*w + e'*u
-
-            subject to  -u <= x <= u
-
-                         A*x - w = b
-
-        """
-
-        m, n = A.size
-
-        env  = mosek.Env()
-        task = env.Task(0,0)
-        task.set_Stream(mosek.streamtype.log, lambda x: sys.stdout.write(x))
-
-        task.appendvars(2*n + m)     # number of variables
-        task.appendcons(2*n + m)     # number of constraints
-
-        # input quadratic objective
-        task.putqobj(range(2*n,2*n+m), range(2*n,2*n+m), m*[2.0])
-
-        task.putclist(range(2*n+m), n*[0.0] + n*[1.0] + m*[0.0])  # setup linear objective
-
-        # input constraint matrix row by row
-        for i in range(n):
-            task.putarow(   i, [i, n+i], [1.0, -1.0])
-            task.putarow( n+i, [i, n+i], [1.0,  1.0])
-
-        for i in range(m):
-            task.putarow( 2*n+i, range(n) + [2*n+i], list(A[i,:]) + [-1.0])
-
-        # setup bounds on constraints
-        task.putboundslice(mosek.accmode.con,
-                           0, n, n*[mosek.boundkey.up], n*[0.0], n*[0.0])
-        task.putboundslice(mosek.accmode.con,
-                           n, 2*n, n*[mosek.boundkey.lo], n*[0.0], n*[0.0])
-        task.putboundslice(mosek.accmode.con,
-                           2*n, 2*n+m, m*[mosek.boundkey.fx], list(b), list(b))
-
-        # setup variable bounds
-        task.putboundslice(mosek.accmode.var, 0, 2*n+m, (2*n+m)*[mosek.boundkey.fr], 
-                           (2*n+m)*[0.0], (2*n+m)*[0.0])
-
-        # optimize the task
-        task.putobjsense(mosek.objsense.minimize)
-        task.optimize()
-        task.solutionsummary(mosek.streamtype.log)
-        x = n*[0.0]
-        task.getsolutionslice(mosek.soltype.itr, mosek.solitem.xx, 0, n, x)
-
-        return matrix(x)
-
-def l1regls(A, b):
-    """
-    
-    Returns the solution of l1-norm regularized least-squares problem
-  
-        minimize || A*x - b ||_2^2  + || x ||_1.
-
-    """
-
-    m, n = A.size
-    q = matrix(1.0, (2*n,1))
-    q[:n] = -2.0 * A.T * b
-
-    def P(u, v, alpha = 1.0, beta = 0.0 ):
-        """
-            v := alpha * 2.0 * [ A'*A, 0; 0, 0 ] * u + beta * v 
-        """
-        v *= beta
-        v[:n] += alpha * 2.0 * A.T * (A * u[:n])
-
-
-    def G(u, v, alpha=1.0, beta=0.0, trans='N'):
-        """
-            v := alpha*[I, -I; -I, -I] * u + beta * v  (trans = 'N' or 'T')
-        """
-
-        v *= beta
-        v[:n] += alpha*(u[:n] - u[n:])
-        v[n:] += alpha*(-u[:n] - u[n:])
-
-    h = matrix(0.0, (2*n,1))
-
-
-    # Customized solver for the KKT system 
-    #
-    #     [  2.0*A'*A  0    I      -I     ] [x[:n] ]     [bx[:n] ]
-    #     [  0         0   -I      -I     ] [x[n:] ]  =  [bx[n:] ].
-    #     [  I        -I   -D1^-1   0     ] [zl[:n]]     [bzl[:n]]
-    #     [ -I        -I    0      -D2^-1 ] [zl[n:]]     [bzl[n:]]
-    #
-    # where D1 = W['di'][:n]**2, D2 = W['di'][:n]**2.
-    #    
-    # We first eliminate zl and x[n:]:
-    #
-    #     ( 2*A'*A + 4*D1*D2*(D1+D2)^-1 ) * x[:n] = 
-    #         bx[:n] - (D2-D1)*(D1+D2)^-1 * bx[n:] + 
-    #         D1 * ( I + (D2-D1)*(D1+D2)^-1 ) * bzl[:n] - 
-    #         D2 * ( I - (D2-D1)*(D1+D2)^-1 ) * bzl[n:]           
-    #
-    #     x[n:] = (D1+D2)^-1 * ( bx[n:] - D1*bzl[:n]  - D2*bzl[n:] ) 
-    #         - (D2-D1)*(D1+D2)^-1 * x[:n]         
-    #
-    #     zl[:n] = D1 * ( x[:n] - x[n:] - bzl[:n] )
-    #     zl[n:] = D2 * (-x[:n] - x[n:] - bzl[n:] ).
-    #
-    # The first equation has the form
-    #
-    #     (A'*A + D)*x[:n]  =  rhs
-    #
-    # and is equivalent to
-    #
-    #     [ D    A' ] [ x:n] ]  = [ rhs ]
-    #     [ A   -I  ] [ v    ]    [ 0   ].
-    #
-    # It can be solved as 
-    #
-    #     ( A*D^-1*A' + I ) * v = A * D^-1 * rhs
-    #     x[:n] = D^-1 * ( rhs - A'*v ).
-
-    S = matrix(0.0, (m,m))
-    Asc = matrix(0.0, (m,n))
-    v = matrix(0.0, (m,1))
-
-    def Fkkt(W):
-
-        # Factor 
-        #
-        #     S = A*D^-1*A' + I 
-        #
-        # where D = 2*D1*D2*(D1+D2)^-1, D1 = d[:n]**-2, D2 = d[n:]**-2.
-
-        d1, d2 = W['di'][:n]**2, W['di'][n:]**2
-
-        # ds is square root of diagonal of D
-        ds = math.sqrt(2.0) * div( mul( W['di'][:n], W['di'][n:]), 
-            sqrt(d1+d2) )
-        d3 =  div(d2 - d1, d1 + d2)
-     
-        # Asc = A*diag(d)^-1/2
-        Asc = A * spdiag(ds**-1)
-
-        # S = I + A * D^-1 * A'
-        blas.syrk(Asc, S)
-        S[::m+1] += 1.0 
-        lapack.potrf(S)
-
-        def g(x, y, z):
-
-            x[:n] = 0.5 * ( x[:n] - mul(d3, x[n:]) + 
-                mul(d1, z[:n] + mul(d3, z[:n])) - mul(d2, z[n:] - 
-                mul(d3, z[n:])) )
-            x[:n] = div( x[:n], ds) 
-
-            # Solve
-            #
-            #     S * v = 0.5 * A * D^-1 * ( bx[:n] - 
-            #         (D2-D1)*(D1+D2)^-1 * bx[n:] + 
-            #         D1 * ( I + (D2-D1)*(D1+D2)^-1 ) * bzl[:n] - 
-            #         D2 * ( I - (D2-D1)*(D1+D2)^-1 ) * bzl[n:] )
-                
-            blas.gemv(Asc, x, v)
-            lapack.potrs(S, v)
-            
-            # x[:n] = D^-1 * ( rhs - A'*v ).
-            blas.gemv(Asc, v, x, alpha=-1.0, beta=1.0, trans='T')
-            x[:n] = div(x[:n], ds)
-
-            # x[n:] = (D1+D2)^-1 * ( bx[n:] - D1*bzl[:n]  - D2*bzl[n:] ) 
-            #         - (D2-D1)*(D1+D2)^-1 * x[:n]         
-            x[n:] = div( x[n:] - mul(d1, z[:n]) - mul(d2, z[n:]), d1+d2 )\
-                - mul( d3, x[:n] )
-                
-            # zl[:n] = D1^1/2 * (  x[:n] - x[n:] - bzl[:n] )
-            # zl[n:] = D2^1/2 * ( -x[:n] - x[n:] - bzl[n:] ).
-            z[:n] = mul( W['di'][:n],  x[:n] - x[n:] - z[:n] ) 
-            z[n:] = mul( W['di'][n:], -x[:n] - x[n:] - z[n:] ) 
-
-        return g
-
-    return solvers.coneqp(P, q, G, h, kktsolver = Fkkt)['x'][:n]
-
-
-
-
-

Then we call the above functions and solve the problem, as done here

-
-
-
from cvxopt import matrix, normal
-
-X = matrix( [ [ 2, 0, 1], [0, 1, 3]])
-y = matrix( [4, 2, 3])
-x = l1regls(X,y)
-
-
-
-
-
     pcost       dcost       gap    pres   dres
- 0: -2.7070e+01 -1.6544e+01  2e+01  6e+00  2e-01
- 1: -2.2433e+01 -2.4632e+01  2e+00  9e-16  1e-16
- 2: -2.4140e+01 -2.4332e+01  2e-01  1e-15  3e-16
- 3: -2.4200e+01 -2.4203e+01  2e-03  5e-16  2e-15
- 4: -2.4201e+01 -2.4201e+01  2e-05  9e-16  6e-16
-Optimal solution found.
-
-
-
-
-

More text will be added to this example.

-
-
-

4.11. Linking the regression analysis with a statistical interpretation

-

We will now couple the discussions of ordinary least squares, Ridge -and Lasso regression with a statistical interpretation, that is we -move from a linear algebra analysis to a statistical analysis. In -particular, we will focus on what the regularization terms can result -in. We will amongst other things show that the regularization -parameter can reduce considerably the variance of the parameters -\(\beta\).

-

The -advantage of doing linear regression is that we actually end up with -analytical expressions for several statistical quantities.
-Standard least squares and Ridge regression allow us to -derive quantities like the variance and other expectation values in a -rather straightforward way.

-

It is assumed that \(\varepsilon_i -\sim \mathcal{N}(0, \sigma^2)\) and the \(\varepsilon_{i}\) are -independent, i.e.:

-
-\[\begin{split} -\begin{align*} -\mbox{Cov}(\varepsilon_{i_1}, -\varepsilon_{i_2}) & = \left\{ \begin{array}{lcc} \sigma^2 & \mbox{if} -& i_1 = i_2, \\ 0 & \mbox{if} & i_1 \not= i_2. \end{array} \right. -\end{align*} -\end{split}\]
-

The randomness of \(\varepsilon_i\) implies that -\(\mathbf{y}_i\) is also a random variable. In particular, -\(\mathbf{y}_i\) is normally distributed, because \(\varepsilon_i \sim -\mathcal{N}(0, \sigma^2)\) and \(\mathbf{X}_{i,\ast} \, \boldsymbol{\beta}\) is a -non-random scalar. To specify the parameters of the distribution of -\(\mathbf{y}_i\) we need to calculate its first two moments.

-

Recall that \(\boldsymbol{X}\) is a matrix of dimensionality \(n\times p\). The -notation above \(\mathbf{X}_{i,\ast}\) means that we are looking at the -row number \(i\) and perform a sum over all values \(p\).

-

The assumption we have made here can be summarized as (and this is going to be useful when we discuss the bias-variance trade off) -that there exists a function \(f(\boldsymbol{x})\) and a normal distributed error \(\boldsymbol{\varepsilon}\sim \mathcal{N}(0, \sigma^2)\) -which describe our data

-
-\[ -\boldsymbol{y} = f(\boldsymbol{x})+\boldsymbol{\varepsilon} -\]
-

We approximate this function with our model from the solution of the linear regression equations, that is our -function \(f\) is approximated by \(\boldsymbol{\tilde{y}}\) where we want to minimize \((\boldsymbol{y}-\boldsymbol{\tilde{y}})^2\), our MSE, with

-
-\[ -\boldsymbol{\tilde{y}} = \boldsymbol{X}\boldsymbol{\beta}. -\]
-

We can calculate the expectation value of \(\boldsymbol{y}\) for a given element \(i\)

-
-\[ -\begin{align*} -\mathbb{E}(y_i) & = -\mathbb{E}(\mathbf{X}_{i, \ast} \, \boldsymbol{\beta}) + \mathbb{E}(\varepsilon_i) -\, \, \, = \, \, \, \mathbf{X}_{i, \ast} \, \beta, -\end{align*} -\]
-

while -its variance is

-
-\[\begin{split} -\begin{align*} \mbox{Var}(y_i) & = \mathbb{E} \{ [y_i -- \mathbb{E}(y_i)]^2 \} \, \, \, = \, \, \, \mathbb{E} ( y_i^2 ) - -[\mathbb{E}(y_i)]^2 \\ & = \mathbb{E} [ ( \mathbf{X}_{i, \ast} \, -\beta + \varepsilon_i )^2] - ( \mathbf{X}_{i, \ast} \, \boldsymbol{\beta})^2 \\ & -= \mathbb{E} [ ( \mathbf{X}_{i, \ast} \, \boldsymbol{\beta})^2 + 2 \varepsilon_i -\mathbf{X}_{i, \ast} \, \boldsymbol{\beta} + \varepsilon_i^2 ] - ( \mathbf{X}_{i, -\ast} \, \beta)^2 \\ & = ( \mathbf{X}_{i, \ast} \, \boldsymbol{\beta})^2 + 2 -\mathbb{E}(\varepsilon_i) \mathbf{X}_{i, \ast} \, \boldsymbol{\beta} + -\mathbb{E}(\varepsilon_i^2 ) - ( \mathbf{X}_{i, \ast} \, \boldsymbol{\beta})^2 -\\ & = \mathbb{E}(\varepsilon_i^2 ) \, \, \, = \, \, \, -\mbox{Var}(\varepsilon_i) \, \, \, = \, \, \, \sigma^2. -\end{align*} -\end{split}\]
-

Hence, \(y_i \sim \mathcal{N}( \mathbf{X}_{i, \ast} \, \boldsymbol{\beta}, \sigma^2)\), that is \(\boldsymbol{y}\) follows a normal distribution with -mean value \(\boldsymbol{X}\boldsymbol{\beta}\) and variance \(\sigma^2\) (not be confused with the singular values of the SVD).

-

With the OLS expressions for the parameters \(\boldsymbol{\beta}\) we can evaluate the expectation value

-
-\[ -\mathbb{E}(\boldsymbol{\beta}) = \mathbb{E}[ (\mathbf{X}^{\top} \mathbf{X})^{-1}\mathbf{X}^{T} \mathbf{Y}]=(\mathbf{X}^{T} \mathbf{X})^{-1}\mathbf{X}^{T} \mathbb{E}[ \mathbf{Y}]=(\mathbf{X}^{T} \mathbf{X})^{-1} \mathbf{X}^{T}\mathbf{X}\boldsymbol{\beta}=\boldsymbol{\beta}. -\]
-

This means that the estimator of the regression parameters is unbiased.

-

We can also calculate the variance

-

The variance of \(\boldsymbol{\beta}\) is

-
-\[\begin{split} -\begin{eqnarray*} -\mbox{Var}(\boldsymbol{\beta}) & = & \mathbb{E} \{ [\boldsymbol{\beta} - \mathbb{E}(\boldsymbol{\beta})] [\boldsymbol{\beta} - \mathbb{E}(\boldsymbol{\beta})]^{T} \} -\\ -& = & \mathbb{E} \{ [(\mathbf{X}^{T} \mathbf{X})^{-1} \, \mathbf{X}^{T} \mathbf{Y} - \boldsymbol{\beta}] \, [(\mathbf{X}^{T} \mathbf{X})^{-1} \, \mathbf{X}^{T} \mathbf{Y} - \boldsymbol{\beta}]^{T} \} -\\ -% & = & \mathbb{E} \{ [(\mathbf{X}^{T} \mathbf{X})^{-1} \, \mathbf{X}^{T} \mathbf{Y}] \, [(\mathbf{X}^{T} \mathbf{X})^{-1} \, \mathbf{X}^{T} \mathbf{Y}]^{T} \} - \boldsymbol{\beta} \, \boldsymbol{\beta}^{T} -% \\ -% & = & \mathbb{E} \{ (\mathbf{X}^{T} \mathbf{X})^{-1} \, \mathbf{X}^{T} \mathbf{Y} \, \mathbf{Y}^{T} \, \mathbf{X} \, (\mathbf{X}^{T} \mathbf{X})^{-1} \} - \boldsymbol{\beta} \, \boldsymbol{\beta}^{T} -% \\ -& = & (\mathbf{X}^{T} \mathbf{X})^{-1} \, \mathbf{X}^{T} \, \mathbb{E} \{ \mathbf{Y} \, \mathbf{Y}^{T} \} \, \mathbf{X} \, (\mathbf{X}^{T} \mathbf{X})^{-1} - \boldsymbol{\beta} \, \boldsymbol{\beta}^{T} -\\ -& = & (\mathbf{X}^{T} \mathbf{X})^{-1} \, \mathbf{X}^{T} \, \{ \mathbf{X} \, \boldsymbol{\beta} \, \boldsymbol{\beta}^{T} \, \mathbf{X}^{T} + \sigma^2 \} \, \mathbf{X} \, (\mathbf{X}^{T} \mathbf{X})^{-1} - \boldsymbol{\beta} \, \boldsymbol{\beta}^{T} -% \\ -% & = & (\mathbf{X}^T \mathbf{X})^{-1} \, \mathbf{X}^T \, \mathbf{X} \, \boldsymbol{\beta} \, \boldsymbol{\beta}^T \, \mathbf{X}^T \, \mathbf{X} \, (\mathbf{X}^T % \mathbf{X})^{-1} -% \\ -% & & + \, \, \sigma^2 \, (\mathbf{X}^T \mathbf{X})^{-1} \, \mathbf{X}^T \, \mathbf{X} \, (\mathbf{X}^T \mathbf{X})^{-1} - \boldsymbol{\beta} \boldsymbol{\beta}^T -\\ -& = & \boldsymbol{\beta} \, \boldsymbol{\beta}^{T} + \sigma^2 \, (\mathbf{X}^{T} \mathbf{X})^{-1} - \boldsymbol{\beta} \, \boldsymbol{\beta}^{T} -\, \, \, = \, \, \, \sigma^2 \, (\mathbf{X}^{T} \mathbf{X})^{-1}, -\end{eqnarray*} -\end{split}\]
-

where we have used that \(\mathbb{E} (\mathbf{Y} \mathbf{Y}^{T}) = -\mathbf{X} \, \boldsymbol{\beta} \, \boldsymbol{\beta}^{T} \, \mathbf{X}^{T} + -\sigma^2 \, \mathbf{I}_{nn}\). From \(\mbox{Var}(\boldsymbol{\beta}) = \sigma^2 -\, (\mathbf{X}^{T} \mathbf{X})^{-1}\), one obtains an estimate of the -variance of the estimate of the \(j\)-th regression coefficient: -\(\boldsymbol{\sigma}^2 (\boldsymbol{\beta}_j ) = \boldsymbol{\sigma}^2 [(\mathbf{X}^{T} \mathbf{X})^{-1}]_{jj} \). This may be used to -construct a confidence interval for the estimates.

-

In a similar way, we can obtain analytical expressions for say the -expectation values of the parameters \(\boldsymbol{\beta}\) and their variance -when we employ Ridge regression, allowing us again to define a confidence interval.

-

It is rather straightforward to show that

-
-\[ -\mathbb{E} \big[ \boldsymbol{\beta}^{\mathrm{Ridge}} \big]=(\mathbf{X}^{T} \mathbf{X} + \lambda \mathbf{I}_{pp})^{-1} (\mathbf{X}^{\top} \mathbf{X})\boldsymbol{\beta}^{\mathrm{OLS}}. -\]
-

We see clearly that -\(\mathbb{E} \big[ \boldsymbol{\beta}^{\mathrm{Ridge}} \big] \not= \boldsymbol{\beta}^{\mathrm{OLS}}\) for any \(\lambda > 0\). We say then that the ridge estimator is biased.

-

We can also compute the variance as

-
-\[ -\mbox{Var}[\boldsymbol{\beta}^{\mathrm{Ridge}}]=\sigma^2[ \mathbf{X}^{T} \mathbf{X} + \lambda \mathbf{I} ]^{-1} \mathbf{X}^{T} \mathbf{X} \{ [ \mathbf{X}^{\top} \mathbf{X} + \lambda \mathbf{I} ]^{-1}\}^{T}, -\]
-

and it is easy to see that if the parameter \(\lambda\) goes to infinity then the variance of Ridge parameters \(\boldsymbol{\beta}\) goes to zero.

-

With this, we can compute the difference

-
-\[ -\mbox{Var}[\boldsymbol{\beta}^{\mathrm{OLS}}]-\mbox{Var}(\boldsymbol{\beta}^{\mathrm{Ridge}})=\sigma^2 [ \mathbf{X}^{T} \mathbf{X} + \lambda \mathbf{I} ]^{-1}[ 2\lambda\mathbf{I} + \lambda^2 (\mathbf{X}^{T} \mathbf{X})^{-1} ] \{ [ \mathbf{X}^{T} \mathbf{X} + \lambda \mathbf{I} ]^{-1}\}^{T}. -\]
-

The difference is non-negative definite since each component of the -matrix product is non-negative definite. -This means the variance we obtain with the standard OLS will always for \(\lambda > 0\) be larger than the variance of \(\boldsymbol{\beta}\) obtained with the Ridge estimator. This has interesting consequences when we discuss the so-called bias-variance trade-off below.

-
-
-

4.12. Deriving OLS from a probability distribution

-

Our basic assumption when we derived the OLS equations was to assume -that our output is determined by a given continuous function -\(f(\boldsymbol{x})\) and a random noise \(\boldsymbol{\epsilon}\) given by the normal -distribution with zero mean value and an undetermined variance -\(\sigma^2\).

-

We found above that the outputs \(\boldsymbol{y}\) have a mean value given by -\(\boldsymbol{X}\hat{\boldsymbol{\beta}}\) and variance \(\sigma^2\). Since the entries to -the design matrix are not stochastic variables, we can assume that the -probability distribution of our targets is also a normal distribution -but now with mean value \(\boldsymbol{X}\hat{\boldsymbol{\beta}}\). This means that a -single output \(y_i\) is given by the Gaussian distribution

-
-\[ -y_i\sim \mathcal{N}(\boldsymbol{X}_{i,*}\boldsymbol{\beta}, \sigma^2)=\frac{1}{\sqrt{2\pi\sigma^2}}\exp{\left[-\frac{(y_i-\boldsymbol{X}_{i,*}\boldsymbol{\beta})^2}{2\sigma^2}\right]}. -\]
-

We assume now that the various \(y_i\) values are stochastically distributed according to the above Gaussian distribution. -We define this distribution as

-
-\[ -p(y_i, \boldsymbol{X}\vert\boldsymbol{\beta})=\frac{1}{\sqrt{2\pi\sigma^2}}\exp{\left[-\frac{(y_i-\boldsymbol{X}_{i,*}\boldsymbol{\beta})^2}{2\sigma^2}\right]}, -\]
-

which reads as finding the likelihood of an event \(y_i\) with the input variables \(\boldsymbol{X}\) given the parameters (to be determined) \(\boldsymbol{\beta}\).

-

Since these events are assumed to be independent and identicall distributed we can build the probability distribution function (PDF) for all possible event \(\boldsymbol{y}\) as the product of the single events, that is we have

-
-\[ -p(\boldsymbol{y},\boldsymbol{X}\vert\boldsymbol{\beta})=\prod_{i=0}^{n-1}\frac{1}{\sqrt{2\pi\sigma^2}}\exp{\left[-\frac{(y_i-\boldsymbol{X}_{i,*}\boldsymbol{\beta})^2}{2\sigma^2}\right]}=\prod_{i=0}^{n-1}p(y_i,\boldsymbol{X}\vert\boldsymbol{\beta}). -\]
-

We will write this in a more compact form reserving \(\boldsymbol{D}\) for the domain of events, including the ouputs (targets) and the inputs. That is -in case we have a simple one-dimensional input and output case

-
-\[ -\boldsymbol{D}=[(x_0,y_0), (x_1,y_1),\dots, (x_{n-1},y_{n-1})]. -\]
-

In the more general case the various inputs should be replaced by the possible features represented by the input data set \(\boldsymbol{X}\). -We can now rewrite the above probability as

-
-\[ -p(\boldsymbol{D}\vert\boldsymbol{\beta})=\prod_{i=0}^{n-1}\frac{1}{\sqrt{2\pi\sigma^2}}\exp{\left[-\frac{(y_i-\boldsymbol{X}_{i,*}\boldsymbol{\beta})^2}{2\sigma^2}\right]}. -\]
-

It is a conditional probability (see below) and reads as the -likelihood of a domain of events \(\boldsymbol{D}\) given a set of parameters -\(\boldsymbol{\beta}\).

-

In statistics, maximum likelihood estimation (MLE) is a method of -estimating the parameters of an assumed probability distribution, -given some observed data. This is achieved by maximizing a likelihood -function so that, under the assumed statistical model, the observed -data is the most probable.

-

We will assume here that our events are given by the above Gaussian -distribution and we will determine the optimal parameters \(\beta\) by -maximizing the above PDF. However, computing the derivatives of a -product function is cumbersome and can easily lead to overflow and/or -underflowproblems, with potentials for loss of numerical precision.

-

In practice, it is more convenient to maximize the logarithm of the -PDF because it is a monotonically increasing function of the argument. -Alternatively, and this will be our option, we will minimize the -negative of the logarithm since this is a monotonically decreasing -function.

-

Note also that maximization/minimization of the logarithm of the PDF -is equivalent to the maximization/minimization of the function itself.

-

We could now define a new cost function to minimize, namely the negative logarithm of the above PDF

-
-\[ -C(\boldsymbol{\beta}=-\log{\prod_{i=0}^{n-1}p(y_i,\boldsymbol{X}\vert\boldsymbol{\beta})}=-\sum_{i=0}^{n-1}\log{p(y_i,\boldsymbol{X}\vert\boldsymbol{\beta})}, -\]
-

which becomes

-
-\[ -C(\boldsymbol{\beta}=\frac{n}{2}\log{2\pi\sigma^2}+\frac{\vert\vert (\boldsymbol{y}-\boldsymbol{X}\boldsymbol{\beta})\vert\vert_2^2}{2\sigma^2}. -\]
-

Taking the derivative of the new cost function with respect to the parameters \(\beta\) we recognize our familiar OLS equation, namely

-
-\[ -\boldsymbol{X}^T\left(\boldsymbol{y}-\boldsymbol{X}\boldsymbol{\beta}\right) =0, -\]
-

which leads to the well-known OLS equation for the optimal paramters \(\beta\)

-
-\[ -\hat{\boldsymbol{\beta}}^{\mathrm{OLS}}=\left(\boldsymbol{X}^T\boldsymbol{X}\right)^{-1}\boldsymbol{X}^T\boldsymbol{y}! -\]
-

Before we make a similar analysis for Ridge and Lasso regression, we need a short reminder on statistics.

-

A central theorem in statistics is Bayes’ theorem. This theorem plays a similar role as the good old Pythagoras’ theorem in geometry. -Bayes’ theorem is extremely simple to derive. But to do so we need some basic axioms from statistics.

-

Assume we have two domains of events \(X=[x_0,x_1,\dots,x_{n-1}]\) and \(Y=[y_0,y_1,\dots,y_{n-1}]\).

-

We define also the likelihood for \(X\) and \(Y\) as \(p(X)\) and \(p(Y)\) respectively. -The likelihood of a specific event \(x_i\) (or \(y_i\)) is then written as \(p(X=x_i)\) or just \(p(x_i)=p_i\).

-

The union of events is given by

-
-\[ -p(X \cup Y)= p(X)+p(Y)-p(X \cap Y). -\]
-

The product rule (aka joint probability) is given by

-
-\[ -p(X \cup Y)= p(X,Y)= p(X\vert Y)p(Y)=p(Y\vert X)p(X), -\]
-

where we read \(p(X\vert Y)\) as the likelihood of obtaining \(X\) given \(Y\).

-

If we have independent events then \(p(X,Y)=p(X)p(Y)\).

-

The marginal probability is defined in terms of only one of the set of variables \(X,Y\). For a discrete probability we have

-
-\[ -p(X)=\sum_{i=0}^{n-1}p(X,Y=y_i)=\sum_{i=0}^{n-1}p(X\vert Y=y_i)p(Y=y_i)=\sum_{i=0}^{n-1}p(X\vert y_i)p(y_i). -\]
-

The conditional probability, if \(p(Y) > 0\), is

-
-\[ -p(X\vert Y)= \frac{p(X,Y)}{p(Y)}=\frac{p(X,Y)}{\sum_{i=0}^{n-1}p(Y\vert X=x_i)p(x_i)}. -\]
-

If we combine the conditional probability with the marginal probability and the standard product rule, we have

-
-\[ -p(X\vert Y)= \frac{p(X,Y)}{p(Y)}, -\]
-

which we can rewrite as

-
-\[ -p(X\vert Y)= \frac{p(X,Y)}{\sum_{i=0}^{n-1}p(Y\vert X=x_i)p(x_i)}=\frac{p(Y\vert X)p(X)}{\sum_{i=0}^{n-1}p(Y\vert X=x_i)p(x_i)}, -\]
-

which is Bayes’ theorem. It allows us to evaluate the uncertainty in in \(X\) after we have observed \(Y\). We can easily interchange \(X\) with \(Y\).

-

The quantity \(p(Y\vert X)\) on the right-hand side of the theorem is -evaluated for the observed data \(Y\) and can be viewed as a function of -the parameter space represented by \(X\). This function is not -necesseraly normalized and is normally called the likelihood function.

-

The function \(p(X)\) on the right hand side is called the prior while -the function on the left hand side is the called the posterior -probability. The denominator on the right hand side serves as a -normalization factor for the posterior distribution.

-

Let us try to illustrate Bayes’ theorem through an example.

-

Let us suppose that you are undergoing a series of mammography scans -in order to rule out possible breast cancer cases. We define the -sensitivity for a positive event by the variable \(X\). It takes binary -values with \(X=1\) representing a positive event and \(X=0\) being a -negative event. We reserve \(Y\) as a classification parameter for -either a negative or a positive breast cancer confirmation. (Short -note on wordings: positive here means having breast cancer, although -none of us would consider this being a positive thing).

-

We let \(Y=1\) represent the the case of having breast cancer and \(Y=0\) as not.

-

Let us assume that if you have breast cancer, the test will be positive with a probability of \(0.8\) (the numbers here are all made up), -that is we have

-
-\[ -p(X=1\vert Y=1) =0.8. -\]
-

This obviously sounds scary since many would conclude that if the test -is positive, there is a likelihood of \(80\%\) for having cancer. It is -however not correct, as the following Bayesian analysis shows. The correct question to pose is what is the probability of having breast cancer in case of a positive test? -We are thus interested in

-
-\[ -p(Y=1\vert X=1), -\]
-

instead of \(p(X=1\vert Y=1)\).

-

If we look at various national surveys on breast cancer, the general -likelihood of developing breast cancer is a very small number. Let us -assume that the prior probability in the population as a whole is

-
-\[ -p(Y=1) =0.004. -\]
-

We need also to account for the fact that the test may produce a false -positive result (false alarm). Let us here assume that we have

-
-\[ -p(X=1\vert Y=0) =0.1. -\]
-

Using Bayes’ theorem we can then find the posterior probability that -the person has breast cancer in case of a positive test, that is we -can compute

- -
-
-\[ -\begin{equation} -p(Y=1\vert X=1)=\frac{p(X=1\vert Y=1)p(Y=1)}{p(X=1\vert Y=1)p(Y=1)+p(X=1\vert Y=0)p(Y=0)}= -\label{_auto2} \tag{2} -\end{equation} -\]
- -
-
-\[ -\begin{equation} - \frac{0.8\times 0.004}{0.8\times 0.004+0.1\times 0.996}=0.031. -\label{_auto3} \tag{3} -\end{equation} -\]
-

That is, in case of a positive test, there is only a \(3\%\) chance of having breast cancer!

-
-
-

4.13. Bayes’ Theorem and Ridge and Lasso Regression

-

Hitherto we have discussed Ridge and Lasso regression in terms of a -linear analysis. This may to many of you feel rather technical and -perhaps not that intuitive. The question is whether we can develop a -more intuitive way of understanding what Ridge and Lasso express.

-

Before we proceed let us perform a Ridge, Lasso and OLS analysis of a polynomial fit.

-

We will play around with a study of the values for the optimal -parameters \(\boldsymbol{\beta}\) using OLS, Ridge and Lasso regression. For -OLS, you will notice as function of the noise and polynomial degree, -that the parameters \(\beta\) will fluctuate from order to order in the -polynomial fit and that for larger and larger polynomial degrees of -freedom, the parameters will tend to increase in value for OLS.

-

For Ridge and Lasso regression, the higher order parameters will -typically be reduced, providing thereby less fluctuations from one -order to another one.

-
-
-
import numpy as np
-import matplotlib.pyplot as plt
-from sklearn.model_selection import train_test_split
-from sklearn import linear_model
-
-def R2(y_data, y_model):
-    return 1 - np.sum((y_data - y_model) ** 2) / np.sum((y_data - np.mean(y_data)) ** 2)
-def MSE(y_data,y_model):
-    n = np.size(y_model)
-    return np.sum((y_data-y_model)**2)/n
-
-# Make data set.
-n = 10000
-x = np.random.rand(n)
-y = np.exp(-x**2) + 1.5 * np.exp(-(x-2)**2)+ np.random.randn(n)
-
-Maxpolydegree = 5
-X = np.zeros((len(x),Maxpolydegree))
-X[:,0] = 1.0
-
-for polydegree in range(1, Maxpolydegree):
-    for degree in range(polydegree):
-        X[:,degree] = x**(degree)
-
-
-# We split the data in test and training data
-X_train, X_test, y_train, y_test = train_test_split(X, y, test_size=0.2)
-
-# matrix inversion to find beta
-OLSbeta = np.linalg.pinv(X_train.T @ X_train) @ X_train.T @ y_train
-print(OLSbeta)
-ypredictOLS = X_test @ OLSbeta
-print("Test MSE OLS")
-print(MSE(y_test,ypredictOLS))
-# Repeat now for Lasso and Ridge regression and various values of the regularization parameter using Scikit-Learn
-# Decide which values of lambda to use
-nlambdas = 4
-MSERidgePredict = np.zeros(nlambdas)
-MSELassoPredict = np.zeros(nlambdas)
-lambdas = np.logspace(-3, 1, nlambdas)
-for i in range(nlambdas):
-    lmb = lambdas[i]
-    # Make the fit using Ridge and Lasso
-    RegRidge = linear_model.Ridge(lmb,fit_intercept=False)
-    RegRidge.fit(X_train,y_train)
-    RegLasso = linear_model.Lasso(lmb,fit_intercept=False)
-    RegLasso.fit(X_train,y_train)
-    # and then make the prediction
-    ypredictRidge = RegRidge.predict(X_test)
-    ypredictLasso = RegLasso.predict(X_test)
-    # Compute the MSE and print it
-    MSERidgePredict[i] = MSE(y_test,ypredictRidge)
-    MSELassoPredict[i] = MSE(y_test,ypredictLasso)
-#    print(lmb,RegRidge.coef_)
-#    print(lmb,RegLasso.coef_)
-# Now plot the results
-plt.figure()
-plt.plot(np.log10(lambdas), MSERidgePredict, 'b', label = 'MSE Ridge Test')
-plt.plot(np.log10(lambdas), MSELassoPredict, 'r', label = 'MSE Lasso Test')
-plt.xlabel('log10(lambda)')
-plt.ylabel('MSE')
-plt.legend()
-plt.show()
-
-
-
-
-
[ 1.0169643   0.27924636 -1.4087793   1.03308408  0.        ]
-Test MSE OLS
-0.958228616652075
-
-
-_images/chapter2_316_1.png -
-
-

How can we understand this?

-

Let us write out the values of the coefficients \(\beta_i\) as functions -of the polynomial degree and noise. We will focus only on the Ridge -results and some few selected values of the hyperparameter \(\lambda\).

-

If we don’t include any noise and run this code for different values -of the polynomial degree, we notice that the results for \(\beta_i\) do -not show great changes from one order to the next. This is an -indication that for higher polynomial orders, our parameters become -less important.

-

If we however add noise, what happens is that the polynomial fit is -trying to adjust the fit to traverse in the best possible way all data -points. This can lead to large fluctuations in the parameters -\(\beta_i\) as functions of polynomial order. It will also be reflected -in a larger value of the variance of each parameter \(\beta_i\). What -Ridge regression (and Lasso as well) are doing then is to try to -quench the fluctuations in the parameters of \(\beta_i\) which have a -large variance (normally for higher orders in the polynomial).

-
-
-
import numpy as np
-import pandas as pd
-from IPython.display import display
-import matplotlib.pyplot as plt
-from sklearn.model_selection import train_test_split
-from sklearn import linear_model
-
-# Make data set.
-n = 1000
-x = np.random.rand(n)
-y = np.exp(-x**2) + 1.5 * np.exp(-(x-2)**2)+ np.random.randn(n)
-
-Maxpolydegree = 5
-X = np.zeros((len(x),Maxpolydegree))
-X[:,0] = 1.0
-
-for polydegree in range(1, Maxpolydegree):
-    for degree in range(polydegree):
-        X[:,degree] = x**(degree)
-
-
-# We split the data in test and training data
-X_train, X_test, y_train, y_test = train_test_split(X, y, test_size=0.2)
-
-# Decide which values of lambda to use
-nlambdas = 5
-lambdas = np.logspace(-3, 2, nlambdas)
-for i in range(nlambdas):
-    lmb = lambdas[i]
-    # Make the fit using Ridge only
-    RegRidge = linear_model.Ridge(lmb,fit_intercept=False)
-    RegRidge.fit(X_train,y_train)
-    # and then make the prediction
-    ypredictRidge = RegRidge.predict(X_test)
-    Coeffs = np.array(RegRidge.coef_)
-    BetaValues = pd.DataFrame(Coeffs)
-    BetaValues.columns = ['beta']
-    display(BetaValues)
-
-
-
-
-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
beta
00.986699
1-0.606760
21.280573
3-0.850164
40.000000
-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
beta
00.978553
1-0.511888
21.051418
3-0.701370
40.000000
-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
beta
00.946957
1-0.162246
20.221921
3-0.167787
40.000000
-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
beta
00.906747
10.017665
2-0.029483
3-0.053849
40.000000
-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
beta
00.718165
10.156956
20.040102
3-0.001880
40.000000
-
-
-

As an exercise, repeat these calculations with ordinary least squares -only with and without noise. Calculate thereafter the variance of the -parameters \(\beta_j\) as function of polynomial order and of the added -noise. Here we recommend to use \(\sigma^2=1\) as variance for the -added noise (which follows a normal distribution with mean value zero). -Comment your results. If you have a large noise term, do the parameters \(\beta_j\) vary more as function -model complexity? And what about their variance?

-
-
-

4.14. Linking Bayes’ Theorem with Ridge and Lasso Regression

-

We have seen that Ridge regression suppresses those features which -have a small singular value. This corresponds to a feature which exhibits -a large variance in the parameters \(\beta_j\). -Our analysis hitherto has been based on linear algebra. To add to our intuition, we will use -Bayes’ theorem in order to deepen our understanding of Ridge and Lasso regression.

-

For ordinary least squares we postulated that the maximum likelihood for the domain of events \(\boldsymbol{D}\) (one-dimensional case)

-
-\[ -\boldsymbol{D}=[(x_0,y_0), (x_1,y_1),\dots, (x_{n-1},y_{n-1})], -\]
-

is given by

-
-\[ -p(\boldsymbol{D}\vert\boldsymbol{\beta})=\prod_{i=0}^{n-1}\frac{1}{\sqrt{2\pi\sigma^2}}\exp{\left[-\frac{(y_i-\boldsymbol{X}_{i,*}\boldsymbol{\beta})^2}{2\sigma^2}\right]}. -\]
-

In Bayes’ theorem this function plays the role of the so-called likelihood. We could now ask the question what is the posterior probability of a parameter set \(\boldsymbol{\beta}\) given a domain of events \(\boldsymbol{D}\)? That is, how can we define the posterior probability

-
-\[ -p(\boldsymbol{\beta}\vert\boldsymbol{D}). -\]
-

Bayes’ theorem comes to our rescue here since (omitting the normalization constant)

-
-\[ -p(\boldsymbol{\beta}\vert\boldsymbol{D})\propto p(\boldsymbol{D}\vert\boldsymbol{\beta})p(\boldsymbol{\beta}). -\]
-

We have a model for \(p(\boldsymbol{D}\vert\boldsymbol{\beta})\) but need one for the prior \(p(\boldsymbol{\beta}\)!

-

With the posterior probability defined by a likelihood which we have -already modeled and an unknown prior, we are now ready to make -additional models for the prior.

-

We can, based on our discussions of the variance of \(\boldsymbol{\beta}\) and -the mean value, assume that the prior for the values \(\boldsymbol{\beta}\) is -given by a Gaussian with mean value zero and variance \(\tau^2\), that -is

-
-\[ -p(\boldsymbol{\beta})=\prod_{j=0}^{p-1}\exp{\left(-\frac{\beta_j^2}{2\tau^2}\right)}. -\]
-

Our posterior probability becomes then (omitting the normalization factor which is just a constant)

-
-\[ -p(\boldsymbol{\beta\vert\boldsymbol{D})}=\prod_{i=0}^{n-1}\frac{1}{\sqrt{2\pi\sigma^2}}\exp{\left[-\frac{(y_i-\boldsymbol{X}_{i,*}\boldsymbol{\beta})^2}{2\sigma^2}\right]}\prod_{j=0}^{p-1}\exp{\left(-\frac{\beta_j^2}{2\tau^2}\right)}. -\]
-

We can now optimize this quantity with respect to \(\boldsymbol{\beta}\). As we -did for OLS, this is most conveniently done by taking the negative -logarithm of the posterior probability. Doing so and leaving out the -terms that do not depend on \(\beta\), we have

-
-\[ -C(\boldsymbol{\beta})=\frac{\vert\vert (\boldsymbol{y}-\boldsymbol{X}\boldsymbol{\beta})\vert\vert_2^2}{2\sigma^2}+\frac{1}{2\tau^2}\vert\vert\boldsymbol{\beta}\vert\vert_2^2, -\]
-

and replacing \(1/2\tau^2\) with \(\lambda\) we have

-
-\[ -C(\boldsymbol{\beta})=\frac{\vert\vert (\boldsymbol{y}-\boldsymbol{X}\boldsymbol{\beta})\vert\vert_2^2}{2\sigma^2}+\lambda\vert\vert\boldsymbol{\beta}\vert\vert_2^2, -\]
-

which is our Ridge cost function! Nice, isn’t it?

-

To derive the Lasso cost function, we simply replace the Gaussian prior with an exponential distribution (Laplace in this case) with zero mean value, that is

-
-\[ -p(\boldsymbol{\beta})=\prod_{j=0}^{p-1}\exp{\left(-\frac{\vert\beta_j\vert}{\tau}\right)}. -\]
-

Our posterior probability becomes then (omitting the normalization factor which is just a constant)

-
-\[ -p(\boldsymbol{\beta}\vert\boldsymbol{D})=\prod_{i=0}^{n-1}\frac{1}{\sqrt{2\pi\sigma^2}}\exp{\left[-\frac{(y_i-\boldsymbol{X}_{i,*}\boldsymbol{\beta})^2}{2\sigma^2}\right]}\prod_{j=0}^{p-1}\exp{\left(-\frac{\vert\beta_j\vert}{\tau}\right)}. -\]
-

Taking the negative -logarithm of the posterior probability and leaving out the -constants terms that do not depend on \(\beta\), we have

-
-\[ -C(\boldsymbol{\beta}=\frac{\vert\vert (\boldsymbol{y}-\boldsymbol{X}\boldsymbol{\beta})\vert\vert_2^2}{2\sigma^2}+\frac{1}{\tau}\vert\vert\boldsymbol{\beta}\vert\vert_1, -\]
-

and replacing \(1/\tau\) with \(\lambda\) we have

-
-\[ -C(\boldsymbol{\beta}=\frac{\vert\vert (\boldsymbol{y}-\boldsymbol{X}\boldsymbol{\beta})\vert\vert_2^2}{2\sigma^2}+\lambda\vert\vert\boldsymbol{\beta}\vert\vert_1, -\]
-

which is our Lasso cost function!

-

Plotting these prior functions shows us that we can use the parameter -\(\lambda\) to shrink or increase the role of a given parameter -\(\beta_j\). The variance for the Laplace distribution is -\(2\tau^2=1/\lambda\) while for the Gaussian distribution it is -\(\sigma^2=1/(2\lambda)\). Thus, increasing the variance means -decreasing \(\lambda\) and shrinking the variance means increasing -\(\lamdbda\). When we increase \(\lambda\), this corresponds to shrinking the role of less important features (small singular values).

-
-
- - - - -
- - - - -
-
-
-
-

- - By Morten Hjorth-Jensen
- - © Copyright 2021.
-

-
-
-
- - -
-
- - - - - - \ No newline at end of file diff --git a/doc/LectureNotes/_build/html/chapter3.html b/doc/LectureNotes/_build/html/chapter3.html deleted file mode 100644 index b1f8bca91..000000000 --- a/doc/LectureNotes/_build/html/chapter3.html +++ /dev/null @@ -1,3311 +0,0 @@ - - - - - - - - 5. Resampling Methods — Applied Data Analysis and Machine Learning - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
- - - - - - - - -
- - -
-
- -
- -
-

5. Resampling Methods

-
-

5.1. Introduction

-

Resampling methods are an indispensable tool in modern -statistics. They involve repeatedly drawing samples from a training -set and refitting a model of interest on each sample in order to -obtain additional information about the fitted model. For example, in -order to estimate the variability of a linear regression fit, we can -repeatedly draw different samples from the training data, fit a linear -regression to each new sample, and then examine the extent to which -the resulting fits differ. Such an approach may allow us to obtain -information that would not be available from fitting the model only -once using the original training sample.

-

Two resampling methods are often used in Machine Learning analyses,

-
    -
  1. The bootstrap method

  2. -
  3. and Cross-Validation

  4. -
-

In addition there are several other methods such as the Jackknife and the Blocking methods. We will discuss in particular -cross-validation and the bootstrap method.

-

Resampling approaches can be computationally expensive, because they -involve fitting the same statistical method multiple times using -different subsets of the training data. However, due to recent -advances in computing power, the computational requirements of -resampling methods generally are not prohibitive. In this chapter, we -discuss two of the most commonly used resampling methods, -cross-validation and the bootstrap. Both methods are important tools -in the practical application of many statistical learning -procedures. For example, cross-validation can be used to estimate the -test error associated with a given statistical learning method in -order to evaluate its performance, or to select the appropriate level -of flexibility. The process of evaluating a model’s performance is -known as model assessment, whereas the process of selecting the proper -level of flexibility for a model is known as model selection. The -bootstrap is widely used.

-
    -
  • Our simulations can be treated as computer experiments. This is particularly the case for Monte Carlo methods

  • -
  • The results can be analysed with the same statistical tools as we would use analysing experimental data.

  • -
  • As in all experiments, we are looking for expectation values and an estimate of how accurate they are, i.e., possible sources for errors.

  • -
-
-
-

5.2. Reminder on Statistics

-
    -
  • As in other experiments, many numerical experiments have two classes of errors:

    -
      -
    • Statistical errors

    • -
    • Systematical errors

    • -
    -
  • -
  • Statistical errors can be estimated using standard tools from statistics

  • -
  • Systematical errors are method specific and must be treated differently from case to case.

  • -
-

The -advantage of doing linear regression is that we actually end up with -analytical expressions for several statistical quantities.
-Standard least squares and Ridge regression allow us to -derive quantities like the variance and other expectation values in a -rather straightforward way.

-

It is assumed that \(\varepsilon_i -\sim \mathcal{N}(0, \sigma^2)\) and the \(\varepsilon_{i}\) are -independent, i.e.:

-
-\[\begin{split} -\begin{align*} -\mbox{Cov}(\varepsilon_{i_1}, -\varepsilon_{i_2}) & = \left\{ \begin{array}{lcc} \sigma^2 & \mbox{if} -& i_1 = i_2, \\ 0 & \mbox{if} & i_1 \not= i_2. \end{array} \right. -\end{align*} -\end{split}\]
-

The randomness of \(\varepsilon_i\) implies that -\(\mathbf{y}_i\) is also a random variable. In particular, -\(\mathbf{y}_i\) is normally distributed, because \(\varepsilon_i \sim -\mathcal{N}(0, \sigma^2)\) and \(\mathbf{X}_{i,\ast} \, \boldsymbol{\beta}\) is a -non-random scalar. To specify the parameters of the distribution of -\(\mathbf{y}_i\) we need to calculate its first two moments.

-

Recall that \(\boldsymbol{X}\) is a matrix of dimensionality \(n\times p\). The -notation above \(\mathbf{X}_{i,\ast}\) means that we are looking at the -row number \(i\) and perform a sum over all values \(p\).

-

The assumption we have made here can be summarized as (and this is going to be useful when we discuss the bias-variance trade off) -that there exists a function \(f(\boldsymbol{x})\) and a normal distributed error \(\boldsymbol{\varepsilon}\sim \mathcal{N}(0, \sigma^2)\) -which describe our data

-
-\[ -\boldsymbol{y} = f(\boldsymbol{x})+\boldsymbol{\varepsilon} -\]
-

We approximate this function with our model from the solution of the linear regression equations, that is our -function \(f\) is approximated by \(\boldsymbol{\tilde{y}}\) where we want to minimize \((\boldsymbol{y}-\boldsymbol{\tilde{y}})^2\), our MSE, with

-
-\[ -\boldsymbol{\tilde{y}} = \boldsymbol{X}\boldsymbol{\beta}. -\]
-

We can calculate the expectation value of \(\boldsymbol{y}\) for a given element \(i\)

-
-\[ -\begin{align*} -\mathbb{E}(y_i) & = -\mathbb{E}(\mathbf{X}_{i, \ast} \, \boldsymbol{\beta}) + \mathbb{E}(\varepsilon_i) -\, \, \, = \, \, \, \mathbf{X}_{i, \ast} \, \beta, -\end{align*} -\]
-

while -its variance is

-
-\[\begin{split} -\begin{align*} \mbox{Var}(y_i) & = \mathbb{E} \{ [y_i -- \mathbb{E}(y_i)]^2 \} \, \, \, = \, \, \, \mathbb{E} ( y_i^2 ) - -[\mathbb{E}(y_i)]^2 \\ & = \mathbb{E} [ ( \mathbf{X}_{i, \ast} \, -\beta + \varepsilon_i )^2] - ( \mathbf{X}_{i, \ast} \, \boldsymbol{\beta})^2 \\ & -= \mathbb{E} [ ( \mathbf{X}_{i, \ast} \, \boldsymbol{\beta})^2 + 2 \varepsilon_i -\mathbf{X}_{i, \ast} \, \boldsymbol{\beta} + \varepsilon_i^2 ] - ( \mathbf{X}_{i, -\ast} \, \beta)^2 \\ & = ( \mathbf{X}_{i, \ast} \, \boldsymbol{\beta})^2 + 2 -\mathbb{E}(\varepsilon_i) \mathbf{X}_{i, \ast} \, \boldsymbol{\beta} + -\mathbb{E}(\varepsilon_i^2 ) - ( \mathbf{X}_{i, \ast} \, \boldsymbol{\beta})^2 -\\ & = \mathbb{E}(\varepsilon_i^2 ) \, \, \, = \, \, \, -\mbox{Var}(\varepsilon_i) \, \, \, = \, \, \, \sigma^2. -\end{align*} -\end{split}\]
-

Hence, \(y_i \sim \mathcal{N}( \mathbf{X}_{i, \ast} \, \boldsymbol{\beta}, \sigma^2)\), that is \(\boldsymbol{y}\) follows a normal distribution with -mean value \(\boldsymbol{X}\boldsymbol{\beta}\) and variance \(\sigma^2\) (not be confused with the singular values of the SVD).

-

With the OLS expressions for the parameters \(\boldsymbol{\beta}\) we can evaluate the expectation value

-
-\[ -\mathbb{E}(\boldsymbol{\beta}) = \mathbb{E}[ (\mathbf{X}^{\top} \mathbf{X})^{-1}\mathbf{X}^{T} \mathbf{Y}]=(\mathbf{X}^{T} \mathbf{X})^{-1}\mathbf{X}^{T} \mathbb{E}[ \mathbf{Y}]=(\mathbf{X}^{T} \mathbf{X})^{-1} \mathbf{X}^{T}\mathbf{X}\boldsymbol{\beta}=\boldsymbol{\beta}. -\]
-

This means that the estimator of the regression parameters is unbiased. -v -We can also calculate the variance

-

The variance of \(\boldsymbol{\beta}\) is

-
-\[\begin{split} -\begin{eqnarray*} -\mbox{Var}(\boldsymbol{\beta}) & = & \mathbb{E} \{ [\boldsymbol{\beta} - \mathbb{E}(\boldsymbol{\beta})] [\boldsymbol{\beta} - \mathbb{E}(\boldsymbol{\beta})]^{T} \} -\\ -& = & \mathbb{E} \{ [(\mathbf{X}^{T} \mathbf{X})^{-1} \, \mathbf{X}^{T} \mathbf{Y} - \boldsymbol{\beta}] \, [(\mathbf{X}^{T} \mathbf{X})^{-1} \, \mathbf{X}^{T} \mathbf{Y} - \boldsymbol{\beta}]^{T} \} -\\ -% & = & \mathbb{E} \{ [(\mathbf{X}^{T} \mathbf{X})^{-1} \, \mathbf{X}^{T} \mathbf{Y}] \, [(\mathbf{X}^{T} \mathbf{X})^{-1} \, \mathbf{X}^{T} \mathbf{Y}]^{T} \} - \boldsymbol{\beta} \, \boldsymbol{\beta}^{T} -% \\ -% & = & \mathbb{E} \{ (\mathbf{X}^{T} \mathbf{X})^{-1} \, \mathbf{X}^{T} \mathbf{Y} \, \mathbf{Y}^{T} \, \mathbf{X} \, (\mathbf{X}^{T} \mathbf{X})^{-1} \} - \boldsymbol{\beta} \, \boldsymbol{\beta}^{T} -% \\ -& = & (\mathbf{X}^{T} \mathbf{X})^{-1} \, \mathbf{X}^{T} \, \mathbb{E} \{ \mathbf{Y} \, \mathbf{Y}^{T} \} \, \mathbf{X} \, (\mathbf{X}^{T} \mathbf{X})^{-1} - \boldsymbol{\beta} \, \boldsymbol{\beta}^{T} -\\ -& = & (\mathbf{X}^{T} \mathbf{X})^{-1} \, \mathbf{X}^{T} \, \{ \mathbf{X} \, \boldsymbol{\beta} \, \boldsymbol{\beta}^{T} \, \mathbf{X}^{T} + \sigma^2 \} \, \mathbf{X} \, (\mathbf{X}^{T} \mathbf{X})^{-1} - \boldsymbol{\beta} \, \boldsymbol{\beta}^{T} -% \\ -% & = & (\mathbf{X}^T \mathbf{X})^{-1} \, \mathbf{X}^T \, \mathbf{X} \, \boldsymbol{\beta} \, \boldsymbol{\beta}^T \, \mathbf{X}^T \, \mathbf{X} \, (\mathbf{X}^T % \mathbf{X})^{-1} -% \\ -% & & + \, \, \sigma^2 \, (\mathbf{X}^T \mathbf{X})^{-1} \, \mathbf{X}^T \, \mathbf{X} \, (\mathbf{X}^T \mathbf{X})^{-1} - \boldsymbol{\beta} \boldsymbol{\beta}^T -\\ -& = & \boldsymbol{\beta} \, \boldsymbol{\beta}^{T} + \sigma^2 \, (\mathbf{X}^{T} \mathbf{X})^{-1} - \boldsymbol{\beta} \, \boldsymbol{\beta}^{T} -\, \, \, = \, \, \, \sigma^2 \, (\mathbf{X}^{T} \mathbf{X})^{-1}, -\end{eqnarray*} -\end{split}\]
-

where we have used that \(\mathbb{E} (\mathbf{Y} \mathbf{Y}^{T}) = -\mathbf{X} \, \boldsymbol{\beta} \, \boldsymbol{\beta}^{T} \, \mathbf{X}^{T} + -\sigma^2 \, \mathbf{I}_{nn}\). From \(\mbox{Var}(\boldsymbol{\beta}) = \sigma^2 -\, (\mathbf{X}^{T} \mathbf{X})^{-1}\), one obtains an estimate of the -variance of the estimate of the \(j\)-th regression coefficient: -\(\boldsymbol{\sigma}^2 (\boldsymbol{\beta}_j ) = \boldsymbol{\sigma}^2 \sqrt{ -[(\mathbf{X}^{T} \mathbf{X})^{-1}]_{jj} }\). This may be used to -construct a confidence interval for the estimates.

-

In a similar way, we can obtain analytical expressions for say the -expectation values of the parameters \(\boldsymbol{\beta}\) and their variance -when we employ Ridge regression, allowing us again to define a confidence interval.

-

It is rather straightforward to show that

-
-\[ -\mathbb{E} \big[ \boldsymbol{\beta}^{\mathrm{Ridge}} \big]=(\mathbf{X}^{T} \mathbf{X} + \lambda \mathbf{I}_{pp})^{-1} (\mathbf{X}^{\top} \mathbf{X})\boldsymbol{\beta}^{\mathrm{OLS}}. -\]
-

We see clearly that -\(\mathbb{E} \big[ \boldsymbol{\beta}^{\mathrm{Ridge}} \big] \not= \boldsymbol{\beta}^{\mathrm{OLS}}\) for any \(\lambda > 0\). We say then that the ridge estimator is biased.

-

We can also compute the variance as

-
-\[ -\mbox{Var}[\boldsymbol{\beta}^{\mathrm{Ridge}}]=\sigma^2[ \mathbf{X}^{T} \mathbf{X} + \lambda \mathbf{I} ]^{-1} \mathbf{X}^{T} \mathbf{X} \{ [ \mathbf{X}^{\top} \mathbf{X} + \lambda \mathbf{I} ]^{-1}\}^{T}, -\]
-

and it is easy to see that if the parameter \(\lambda\) goes to infinity then the variance of Ridge parameters \(\boldsymbol{\beta}\) goes to zero.

-

With this, we can compute the difference

-
-\[ -\mbox{Var}[\boldsymbol{\beta}^{\mathrm{OLS}}]-\mbox{Var}(\boldsymbol{\beta}^{\mathrm{Ridge}})=\sigma^2 [ \mathbf{X}^{T} \mathbf{X} + \lambda \mathbf{I} ]^{-1}[ 2\lambda\mathbf{I} + \lambda^2 (\mathbf{X}^{T} \mathbf{X})^{-1} ] \{ [ \mathbf{X}^{T} \mathbf{X} + \lambda \mathbf{I} ]^{-1}\}^{T}. -\]
-

The difference is non-negative definite since each component of the -matrix product is non-negative definite. -This means the variance we obtain with the standard OLS will always for \(\lambda > 0\) be larger than the variance of \(\boldsymbol{\beta}\) obtained with the Ridge estimator. This has interesting consequences when we discuss the so-called bias-variance trade-off below.

-
-
-

5.3. Resampling methods

-

With all these analytical equations for both the OLS and Ridge -regression, we will now outline how to assess a given model. This will -lead us to a discussion of the so-called bias-variance tradeoff (see -below) and so-called resampling methods.

-

One of the quantities we have discussed as a way to measure errors is -the mean-squared error (MSE), mainly used for fitting of continuous -functions. Another choice is the absolute error.

-

In the discussions below we will focus on the MSE and in particular since we will split the data into test and training data, -we discuss the

-
    -
  1. prediction error or simply the test error \(\mathrm{Err_{Test}}\), where we have a fixed training set and the test error is the MSE arising from the data reserved for testing. We discuss also the

  2. -
  3. training error \(\mathrm{Err_{Train}}\), which is the average loss over the training data.

  4. -
-

As our model becomes more and more complex, more of the training data tends to used. The training may thence adapt to more complicated structures in the data. This may lead to a decrease in the bias (see below for code example) and a slight increase of the variance for the test error. -For a certain level of complexity the test error will reach minimum, before starting to increase again. The -training error reaches a saturation.

-

Two famous -resampling methods are the independent bootstrap and the jackknife.

-

The jackknife is a special case of the independent bootstrap. Still, the jackknife was made -popular prior to the independent bootstrap. And as the popularity of -the independent bootstrap soared, new variants, such as the dependent bootstrap.

-

The Jackknife and independent bootstrap work for -independent, identically distributed random variables. -If these conditions are not -satisfied, the methods will fail. Yet, it should be said that if the data are -independent, identically distributed, and we only want to estimate the -variance of \(\overline{X}\) (which often is the case), then there is no -need for bootstrapping.

-

The Jackknife works by making many replicas of the estimator \(\widehat{\beta}\). -The jackknife is a resampling method where we systematically leave out one observation from the vector of observed values \(\boldsymbol{x} = (x_1,x_2,\cdots,X_n)\). -Let \(\boldsymbol{x}_i\) denote the vector

-
-\[ -\boldsymbol{x}_i = (x_1,x_2,\cdots,x_{i-1},x_{i+1},\cdots,x_n), -\]
-

which equals the vector \(\boldsymbol{x}\) with the exception that observation -number \(i\) is left out. Using this notation, define -\(\widehat{\beta}_i\) to be the estimator -\(\widehat{\beta}\) computed using \(\vec{X}_i\).

-
-
-
from numpy import *
-from numpy.random import randint, randn
-from time import time
-
-def jackknife(data, stat):
-    n = len(data);t = zeros(n); inds = arange(n); t0 = time()
-    ## 'jackknifing' by leaving out an observation for each i                                                                                                                      
-    for i in range(n):
-        t[i] = stat(delete(data,i) )
-
-    # analysis                                                                                                                                                                     
-    print("Runtime: %g sec" % (time()-t0)); print("Jackknife Statistics :")
-    print("original           bias      std. error")
-    print("%8g %14g %15g" % (stat(data),(n-1)*mean(t)/n, (n*var(t))**.5))
-
-    return t
-
-
-# Returns mean of data samples                                                                                                                                                     
-def stat(data):
-    return mean(data)
-
-
-mu, sigma = 100, 15
-datapoints = 10000
-x = mu + sigma*random.randn(datapoints)
-# jackknife returns the data sample                                                                                                                                                
-t = jackknife(x, stat)
-
-
-
-
-
Runtime: 0.138685 sec
-Jackknife Statistics :
-original           bias      std. error
- 99.8911        99.8811        0.149732
-
-
-
-
-
-

5.3.1. Bootstrap

-

Bootstrapping is a nonparametric approach to statistical inference -that substitutes computation for more traditional distributional -assumptions and asymptotic results. Bootstrapping offers a number of -advantages:

-
    -
  1. The bootstrap is quite general, although there are some cases in which it fails.

  2. -
  3. Because it does not require distributional assumptions (such as normally distributed errors), the bootstrap can provide more accurate inferences when the data are not well behaved or when the sample size is small.

  4. -
  5. It is possible to apply the bootstrap to statistics with sampling distributions that are difficult to derive, even asymptotically.

  6. -
  7. It is relatively simple to apply the bootstrap to complex data-collection plans (such as stratified and clustered samples).

  8. -
-

Since \(\widehat{\beta} = \widehat{\beta}(\boldsymbol{X})\) is a function of random variables, -\(\widehat{\beta}\) itself must be a random variable. Thus it has -a pdf, call this function \(p(\boldsymbol{t})\). The aim of the bootstrap is to -estimate \(p(\boldsymbol{t})\) by the relative frequency of -\(\widehat{\beta}\). You can think of this as using a histogram -in the place of \(p(\boldsymbol{t})\). If the relative frequency closely -resembles \(p(\vec{t})\), then using numerics, it is straight forward to -estimate all the interesting parameters of \(p(\boldsymbol{t})\) using point -estimators.

-

In the case that \(\widehat{\beta}\) has -more than one component, and the components are independent, we use the -same estimator on each component separately. If the probability -density function of \(X_i\), \(p(x)\), had been known, then it would have -been straight forward to do this by:

-
    -
  1. Drawing lots of numbers from \(p(x)\), suppose we call one such set of numbers \((X_1^*, X_2^*, \cdots, X_n^*)\).

  2. -
  3. Then using these numbers, we could compute a replica of \(\widehat{\beta}\) called \(\widehat{\beta}^*\).

  4. -
-

By repeated use of (1) and (2), many -estimates of \(\widehat{\beta}\) could have been obtained. The -idea is to use the relative frequency of \(\widehat{\beta}^*\) -(think of a histogram) as an estimate of \(p(\boldsymbol{t})\).

-

But -unless there is enough information available about the process that -generated \(X_1,X_2,\cdots,X_n\), \(p(x)\) is in general -unknown. Therefore, Efron in 1979 asked the -question: What if we replace \(p(x)\) by the relative frequency -of the observation \(X_i\); if we draw observations in accordance with -the relative frequency of the observations, will we obtain the same -result in some asymptotic sense? The answer is yes.

-

Instead of generating the histogram for the relative -frequency of the observation \(X_i\), just draw the values -\((X_1^*,X_2^*,\cdots,X_n^*)\) with replacement from the vector -\(\boldsymbol{X}\).

-

The independent bootstrap works like this:

-
    -
  1. Draw with replacement \(n\) numbers for the observed variables \(\boldsymbol{x} = (x_1,x_2,\cdots,x_n)\).

  2. -
  3. Define a vector \(\boldsymbol{x}^*\) containing the values which were drawn from \(\boldsymbol{x}\).

  4. -
  5. Using the vector \(\boldsymbol{x}^*\) compute \(\widehat{\beta}^*\) by evaluating \(\widehat \beta\) under the observations \(\boldsymbol{x}^*\).

  6. -
  7. Repeat this process \(k\) times.

  8. -
-

When you are done, you can draw a histogram of the relative frequency -of \(\widehat \beta^*\). This is your estimate of the probability -distribution \(p(t)\). Using this probability distribution you can -estimate any statistics thereof. In principle you never draw the -histogram of the relative frequency of \(\widehat{\beta}^*\). Instead -you use the estimators corresponding to the statistic of interest. For -example, if you are interested in estimating the variance of \(\widehat -\beta\), apply the etsimator \(\widehat \sigma^2\) to the values -\(\widehat \beta^*\).

-

Before we proceed however, we need to remind ourselves about a central -theorem in statistics, namely the so-called central limit theorem. -This theorem plays a central role in understanding why the Bootstrap -(and other resampling methods) work so well on independent and -identically distributed variables.

-

Suppose we have a PDF \(p(x)\) from which we generate a series \(N\) -of averages \(\langle x_i \rangle\). Each mean value \(\langle x_i \rangle\) -is viewed as the average of a specific measurement, e.g., throwing -dice 100 times and then taking the average value, or producing a certain -amount of random numbers. -For notational ease, we set \(\langle x_i \rangle=x_i\) in the discussion -which follows.

-

If we compute the mean \(z\) of \(m\) such mean values \(x_i\)

-
-\[ -z=\frac{x_1+x_2+\dots+x_m}{m}, -\]
-

the question we pose is which is the PDF of the new variable \(z\).

-

The probability of obtaining an average value \(z\) is the product of the -probabilities of obtaining arbitrary individual mean values \(x_i\), -but with the constraint that the average is \(z\). We can express this through -the following expression

-
-\[ -\tilde{p}(z)=\int dx_1p(x_1)\int dx_2p(x_2)\dots\int dx_mp(x_m) - \delta(z-\frac{x_1+x_2+\dots+x_m}{m}), -\]
-

where the \(\delta\)-function enbodies the constraint that the mean is \(z\). -All measurements that lead to each individual \(x_i\) are expected to -be independent, which in turn means that we can express \(\tilde{p}\) as the -product of individual \(p(x_i)\). The independence assumption is important in the derivation of the central limit theorem.

-

If we use the integral expression for the \(\delta\)-function

-
-\[ -\delta(z-\frac{x_1+x_2+\dots+x_m}{m})=\frac{1}{2\pi}\int_{-\infty}^{\infty} - dq\exp{\left(iq(z-\frac{x_1+x_2+\dots+x_m}{m})\right)}, -\]
-

and inserting \(e^{i\mu q-i\mu q}\) where \(\mu\) is the mean value -we arrive at

-
-\[ -\tilde{p}(z)=\frac{1}{2\pi}\int_{-\infty}^{\infty} - dq\exp{\left(iq(z-\mu)\right)}\left[\int_{-\infty}^{\infty} - dxp(x)\exp{\left(iq(\mu-x)/m\right)}\right]^m, -\]
-

with the integral over \(x\) resulting in

-
-\[ -\int_{-\infty}^{\infty}dxp(x)\exp{\left(iq(\mu-x)/m\right)}= - \int_{-\infty}^{\infty}dxp(x) - \left[1+\frac{iq(\mu-x)}{m}-\frac{q^2(\mu-x)^2}{2m^2}+\dots\right]. -\]
-

The second term on the rhs disappears since this is just the mean and -employing the definition of \(\sigma^2\) we have

-
-\[ -\int_{-\infty}^{\infty}dxp(x)e^{\left(iq(\mu-x)/m\right)}= - 1-\frac{q^2\sigma^2}{2m^2}+\dots, -\]
-

resulting in

-
-\[ -\left[\int_{-\infty}^{\infty}dxp(x)\exp{\left(iq(\mu-x)/m\right)}\right]^m\approx - \left[1-\frac{q^2\sigma^2}{2m^2}+\dots \right]^m, -\]
-

and in the limit \(m\rightarrow \infty\) we obtain

-
-\[ -\tilde{p}(z)=\frac{1}{\sqrt{2\pi}(\sigma/\sqrt{m})} - \exp{\left(-\frac{(z-\mu)^2}{2(\sigma/\sqrt{m})^2}\right)}, -\]
-

which is the normal distribution with variance -\(\sigma^2_m=\sigma^2/m\), where \(\sigma\) is the variance of the PDF \(p(x)\) -and \(\mu\) is also the mean of the PDF \(p(x)\).

-

Thus, the central limit theorem states that the PDF \(\tilde{p}(z)\) of -the average of \(m\) random values corresponding to a PDF \(p(x)\) -is a normal distribution whose mean is the -mean value of the PDF \(p(x)\) and whose variance is the variance -of the PDF \(p(x)\) divided by \(m\), the number of values used to compute \(z\).

-

The central limit theorem leads to the well-known expression for the -standard deviation, given by

-
-\[ -\sigma_m= -\frac{\sigma}{\sqrt{m}}. -\]
-

The latter is true only if the average value is known exactly. This is obtained in the limit -\(m\rightarrow \infty\) only. Because the mean and the variance are measured quantities we obtain -the familiar expression in statistics

-
-\[ -\sigma_m\approx -\frac{\sigma}{\sqrt{m-1}}. -\]
-

In many cases however the above estimate for the standard deviation, -in particular if correlations are strong, may be too simplistic. Keep -in mind that we have assumed that the variables \(x\) are independent -and identically distributed. This is obviously not always the -case. For example, the random numbers (or better pseudorandom numbers) -we generate in various calculations do always exhibit some -correlations.

-

The theorem is satisfied by a large class of PDFs. Note however that for a -finite \(m\), it is not always possible to find a closed form /analytic expression for -\(\tilde{p}(x)\).

-

The following code starts with a Gaussian distribution with mean value -\(\mu =100\) and variance \(\sigma=15\). We use this to generate the data -used in the bootstrap analysis. The bootstrap analysis returns a data -set after a given number of bootstrap operations (as many as we have -data points). This data set consists of estimated mean values for each -bootstrap operation. The histogram generated by the bootstrap method -shows that the distribution for these mean values is also a Gaussian, -centered around the mean value \(\mu=100\) but with standard deviation -\(\sigma/\sqrt{n}\), where \(n\) is the number of bootstrap samples (in -this case the same as the number of original data points). The value -of the standard deviation is what we expect from the central limit -theorem.

-
-
-
%matplotlib inline
-
-import numpy as np
-from time import time
-from scipy.stats import norm
-import matplotlib.pyplot as plt
-
-# Returns mean of bootstrap samples 
-# Bootstrap algorithm
-def bootstrap(data, datapoints):
-    t = np.zeros(datapoints)
-    n = len(data)
-    # non-parametric bootstrap         
-    for i in range(datapoints):
-        t[i] = np.mean(data[np.random.randint(0,n,n)])
-    # analysis    
-    print("Bootstrap Statistics :")
-    print("original           bias      std. error")
-    print("%8g %8g %14g %15g" % (np.mean(data), np.std(data),np.mean(t),np.std(t)))
-    return t
-
-# We set the mean value to 100 and the standard deviation to 15
-mu, sigma = 100, 15
-datapoints = 10000
-# We generate random numbers according to the normal distribution
-x = mu + sigma*np.random.randn(datapoints)
-# bootstrap returns the data sample                                    
-t = bootstrap(x, datapoints)
-
-
-
-
-
Bootstrap Statistics :
-original           bias      std. error
-  99.751  15.2137        99.7503        0.153129
-
-
-
-
-

We see that our new variance and from that the standard deviation, agrees with the central limit theorem.

-

We plot then the histogram together with a best fit for the data set.

-
-
-
# the histogram of the bootstrapped data (normalized data if density = True)
-n, binsboot, patches = plt.hist(t, 50, density=True, facecolor='red', alpha=0.75)
-# add a 'best fit' line  
-y = norm.pdf(binsboot, np.mean(t), np.std(t))
-lt = plt.plot(binsboot, y, 'b', linewidth=1)
-plt.xlabel('x')
-plt.ylabel('Probability')
-plt.grid(True)
-plt.show()
-
-
-
-
-_images/chapter3_47_0.png -
-
-
-
-
-

5.4. The bias-variance tradeoff

-

We will discuss the bias-variance tradeoff in the context of -continuous predictions such as regression. However, many of the -intuitions and ideas discussed here also carry over to classification -tasks. Consider a dataset \(\mathcal{L}\) consisting of the data -\(\mathbf{X}_\mathcal{L}=\{(y_j, \boldsymbol{x}_j), j=0\ldots n-1\}\).

-

Let us assume that the true data is generated from a noisy model

-
-\[ -\boldsymbol{y}=f(\boldsymbol{x}) + \boldsymbol{\epsilon} -\]
-

where \(\epsilon\) is normally distributed with mean zero and standard deviation \(\sigma^2\).

-

In our derivation of the ordinary least squares method we defined then -an approximation to the function \(f\) in terms of the parameters -\(\boldsymbol{\beta}\) and the design matrix \(\boldsymbol{X}\) which embody our model, -that is \(\boldsymbol{\tilde{y}}=\boldsymbol{X}\boldsymbol{\beta}\).

-

Thereafter we found the parameters \(\boldsymbol{\beta}\) by optimizing the means squared error via the so-called cost function

-
-\[ -C(\boldsymbol{X},\boldsymbol{\beta}) =\frac{1}{n}\sum_{i=0}^{n-1}(y_i-\tilde{y}_i)^2=\mathbb{E}\left[(\boldsymbol{y}-\boldsymbol{\tilde{y}})^2\right]. -\]
-

We can rewrite this as

-
-\[ -\mathbb{E}\left[(\boldsymbol{y}-\boldsymbol{\tilde{y}})^2\right]=\frac{1}{n}\sum_i(f_i-\mathbb{E}\left[\boldsymbol{\tilde{y}}\right])^2+\frac{1}{n}\sum_i(\tilde{y}_i-\mathbb{E}\left[\boldsymbol{\tilde{y}}\right])^2+\sigma^2. -\]
-

The three terms represent the square of the bias of the learning -method, which can be thought of as the error caused by the simplifying -assumptions built into the method. The second term represents the -variance of the chosen model and finally the last terms is variance of -the error \(\boldsymbol{\epsilon}\).

-

To derive this equation, we need to recall that the variance of \(\boldsymbol{y}\) and \(\boldsymbol{\epsilon}\) are both equal to \(\sigma^2\). The mean value of \(\boldsymbol{\epsilon}\) is by definition equal to zero. Furthermore, the function \(f\) is not a stochastics variable, idem for \(\boldsymbol{\tilde{y}}\). -We use a more compact notation in terms of the expectation value

-
-\[ -\mathbb{E}\left[(\boldsymbol{y}-\boldsymbol{\tilde{y}})^2\right]=\mathbb{E}\left[(\boldsymbol{f}+\boldsymbol{\epsilon}-\boldsymbol{\tilde{y}})^2\right], -\]
-

and adding and subtracting \(\mathbb{E}\left[\boldsymbol{\tilde{y}}\right]\) we get

-
-\[ -\mathbb{E}\left[(\boldsymbol{y}-\boldsymbol{\tilde{y}})^2\right]=\mathbb{E}\left[(\boldsymbol{f}+\boldsymbol{\epsilon}-\boldsymbol{\tilde{y}}+\mathbb{E}\left[\boldsymbol{\tilde{y}}\right]-\mathbb{E}\left[\boldsymbol{\tilde{y}}\right])^2\right], -\]
-

which, using the abovementioned expectation values can be rewritten as

-
-\[ -\mathbb{E}\left[(\boldsymbol{y}-\boldsymbol{\tilde{y}})^2\right]=\mathbb{E}\left[(\boldsymbol{y}-\mathbb{E}\left[\boldsymbol{\tilde{y}}\right])^2\right]+\mathrm{Var}\left[\boldsymbol{\tilde{y}}\right]+\sigma^2, -\]
-

that is the rewriting in terms of the so-called bias, the variance of the model \(\boldsymbol{\tilde{y}}\) and the variance of \(\boldsymbol{\epsilon}\).

-
-
-
import matplotlib.pyplot as plt
-import numpy as np
-from sklearn.linear_model import LinearRegression, Ridge, Lasso
-from sklearn.preprocessing import PolynomialFeatures
-from sklearn.model_selection import train_test_split
-from sklearn.pipeline import make_pipeline
-from sklearn.utils import resample
-
-np.random.seed(2018)
-
-n = 500
-n_boostraps = 100
-degree = 18  # A quite high value, just to show.
-noise = 0.1
-
-# Make data set.
-x = np.linspace(-1, 3, n).reshape(-1, 1)
-y = np.exp(-x**2) + 1.5 * np.exp(-(x-2)**2) + np.random.normal(0, 0.1, x.shape)
-
-# Hold out some test data that is never used in training.
-x_train, x_test, y_train, y_test = train_test_split(x, y, test_size=0.2)
-
-# Combine x transformation and model into one operation.
-# Not neccesary, but convenient.
-model = make_pipeline(PolynomialFeatures(degree=degree), LinearRegression(fit_intercept=False))
-
-# The following (m x n_bootstraps) matrix holds the column vectors y_pred
-# for each bootstrap iteration.
-y_pred = np.empty((y_test.shape[0], n_boostraps))
-for i in range(n_boostraps):
-    x_, y_ = resample(x_train, y_train)
-
-    # Evaluate the new model on the same test data each time.
-    y_pred[:, i] = model.fit(x_, y_).predict(x_test).ravel()
-
-# Note: Expectations and variances taken w.r.t. different training
-# data sets, hence the axis=1. Subsequent means are taken across the test data
-# set in order to obtain a total value, but before this we have error/bias/variance
-# calculated per data point in the test set.
-# Note 2: The use of keepdims=True is important in the calculation of bias as this 
-# maintains the column vector form. Dropping this yields very unexpected results.
-error = np.mean( np.mean((y_test - y_pred)**2, axis=1, keepdims=True) )
-bias = np.mean( (y_test - np.mean(y_pred, axis=1, keepdims=True))**2 )
-variance = np.mean( np.var(y_pred, axis=1, keepdims=True) )
-print('Error:', error)
-print('Bias^2:', bias)
-print('Var:', variance)
-print('{} >= {} + {} = {}'.format(error, bias, variance, bias+variance))
-
-plt.plot(x[::5, :], y[::5, :], label='f(x)')
-plt.scatter(x_test, y_test, label='Data points')
-plt.scatter(x_test, np.mean(y_pred, axis=1), label='Pred')
-plt.legend()
-plt.show()
-
-
-
-
-
Error: 0.01312157412031145
-Bias^2: 0.012073649480472317
-Var: 0.0010479246398391328
-0.01312157412031145 >= 0.012073649480472317 + 0.0010479246398391328 = 0.01312157412031145
-
-
-_images/chapter3_61_1.png -
-
-
-
-
import matplotlib.pyplot as plt
-import numpy as np
-from sklearn.linear_model import LinearRegression, Ridge, Lasso
-from sklearn.preprocessing import PolynomialFeatures
-from sklearn.model_selection import train_test_split
-from sklearn.pipeline import make_pipeline
-from sklearn.utils import resample
-
-np.random.seed(2018)
-
-n = 40
-n_boostraps = 100
-maxdegree = 14
-
-
-# Make data set.
-x = np.linspace(-3, 3, n).reshape(-1, 1)
-y = np.exp(-x**2) + 1.5 * np.exp(-(x-2)**2)+ np.random.normal(0, 0.1, x.shape)
-error = np.zeros(maxdegree)
-bias = np.zeros(maxdegree)
-variance = np.zeros(maxdegree)
-polydegree = np.zeros(maxdegree)
-x_train, x_test, y_train, y_test = train_test_split(x, y, test_size=0.2)
-
-for degree in range(maxdegree):
-    model = make_pipeline(PolynomialFeatures(degree=degree), LinearRegression(fit_intercept=False))
-    y_pred = np.empty((y_test.shape[0], n_boostraps))
-    for i in range(n_boostraps):
-        x_, y_ = resample(x_train, y_train)
-        y_pred[:, i] = model.fit(x_, y_).predict(x_test).ravel()
-
-    polydegree[degree] = degree
-    error[degree] = np.mean( np.mean((y_test - y_pred)**2, axis=1, keepdims=True) )
-    bias[degree] = np.mean( (y_test - np.mean(y_pred, axis=1, keepdims=True))**2 )
-    variance[degree] = np.mean( np.var(y_pred, axis=1, keepdims=True) )
-    print('Polynomial degree:', degree)
-    print('Error:', error[degree])
-    print('Bias^2:', bias[degree])
-    print('Var:', variance[degree])
-    print('{} >= {} + {} = {}'.format(error[degree], bias[degree], variance[degree], bias[degree]+variance[degree]))
-
-plt.plot(polydegree, error, label='Error')
-plt.plot(polydegree, bias, label='bias')
-plt.plot(polydegree, variance, label='Variance')
-plt.legend()
-plt.show()
-
-
-
-
-
Polynomial degree: 0
-Error: 0.32149601703519126
-Bias^2: 0.3123314713548606
-Var: 0.009164545680330616
-0.32149601703519126 >= 0.3123314713548606 + 0.009164545680330616 = 0.3214960170351912
-Polynomial degree:
-
-
-
 1
-Error: 0.08426840630693411
-Bias^2: 0.07968918676726028
-Var: 0.004579219539673833
-0.08426840630693411 >= 0.07968918676726028 + 0.004579219539673833 = 0.08426840630693411
-Polynomial degree: 2
-Error: 0.10398646080125035
-Bias^2: 0.10077114273548986
-Var: 0.0032153180657605086
-0.10398646080125035 >= 0.10077114273548986 + 0.0032153180657605086 = 0.10398646080125036
-Polynomial degree: 3
-Error: 0.06547790180152352
-Bias^2: 0.062082386342319454
-Var: 0.0033955154592040936
-0.06547790180152352 >= 0.062082386342319454 + 0.0033955154592040936 = 0.06547790180152355
-Polynomial degree: 4
-Error: 0.06844519414009442
-Bias^2: 0.06453579006728317
-Var: 0.003909404072811237
-0.06844519414009442 >= 0.06453579006728317 + 0.003909404072811237 = 0.06844519414009441
-Polynomial degree:
-
-
-
 5
-Error: 0.05227921801205707
-Bias^2: 0.048187277304303125
-Var: 0.004091940707753964
-0.05227921801205707 >= 0.048187277304303125 + 0.004091940707753964 = 0.05227921801205709
-Polynomial degree: 6
-Error: 0.03781367141738898
-Bias^2: 0.03365768507152761
-Var: 0.004155986345861379
-0.03781367141738898 >= 0.03365768507152761 + 0.004155986345861379 = 0.03781367141738899
-
-
-
Polynomial degree: 7
-Error: 0.027609773491022498
-Bias^2: 0.02299949826036597
-Var: 0.004610275230656537
-0.027609773491022498 >= 0.02299949826036597 + 0.004610275230656537 = 0.027609773491022505
-Polynomial degree: 8
-Error: 0.017355848195591973
-Bias^2: 0.010331721306655588
-Var: 0.007024126888936384
-0.017355848195591973 >= 0.010331721306655588 + 0.007024126888936384 = 0.017355848195591973
-Polynomial degree: 9
-Error: 0.026605727637189085
-Bias^2: 0.010018312644140933
-Var: 0.016587414993048166
-0.026605727637189085 >= 0.010018312644140933 + 0.016587414993048166 = 0.0266057276371891
-Polynomial degree: 10
-Error: 0.021592704588043153
-Bias^2: 0.010516485576652981
-Var: 0.011076219011390184
-0.021592704588043153 >= 0.010516485576652981 + 0.011076219011390184 = 0.021592704588043167
-
-
-
Polynomial degree: 11
-Error: 0.07160048164228314
-Bias^2: 0.01443680008897583
-Var: 0.0571636815533073
-0.07160048164228314 >= 0.01443680008897583 + 0.0571636815533073 = 0.07160048164228312
-Polynomial degree: 12
-Error: 0.1154777721897675
-Bias^2: 0.01628578269590588
-Var: 0.09919198949386163
-0.1154777721897675 >= 0.01628578269590588 + 0.09919198949386163 = 0.11547777218976751
-Polynomial degree: 13
-Error: 0.22842468702166951
-Bias^2: 0.01975416527163567
-Var: 0.20867052175003387
-0.22842468702166951 >= 0.01975416527163567 + 0.20867052175003387 = 0.22842468702166954
-
-
-_images/chapter3_62_5.png -
-
-

The bias-variance tradeoff summarizes the fundamental tension in -machine learning, particularly supervised learning, between the -complexity of a model and the amount of training data needed to train -it. Since data is often limited, in practice it is often useful to -use a less-complex model with higher bias, that is a model whose asymptotic -performance is worse than another model because it is easier to -train and less sensitive to sampling noise arising from having a -finite-sized training dataset (smaller variance).

-

The above equations tell us that in -order to minimize the expected test error, we need to select a -statistical learning method that simultaneously achieves low variance -and low bias. Note that variance is inherently a nonnegative quantity, -and squared bias is also nonnegative. Hence, we see that the expected -test MSE can never lie below \(Var(\epsilon)\), the irreducible error.

-

What do we mean by the variance and bias of a statistical learning -method? The variance refers to the amount by which our model would change if we -estimated it using a different training data set. Since the training -data are used to fit the statistical learning method, different -training data sets will result in a different estimate. But ideally the -estimate for our model should not vary too much between training -sets. However, if a method has high variance then small changes in -the training data can result in large changes in the model. In general, more -flexible statistical methods have higher variance.

-

You may also find this recent article of interest.

-
-
-
"""
-============================
-Underfitting vs. Overfitting
-============================
-
-This example demonstrates the problems of underfitting and overfitting and
-how we can use linear regression with polynomial features to approximate
-nonlinear functions. The plot shows the function that we want to approximate,
-which is a part of the cosine function. In addition, the samples from the
-real function and the approximations of different models are displayed. The
-models have polynomial features of different degrees. We can see that a
-linear function (polynomial with degree 1) is not sufficient to fit the
-training samples. This is called **underfitting**. A polynomial of degree 4
-approximates the true function almost perfectly. However, for higher degrees
-the model will **overfit** the training data, i.e. it learns the noise of the
-training data.
-We evaluate quantitatively **overfitting** / **underfitting** by using
-cross-validation. We calculate the mean squared error (MSE) on the validation
-set, the higher, the less likely the model generalizes correctly from the
-training data.
-"""
-
-print(__doc__)
-
-import numpy as np
-import matplotlib.pyplot as plt
-from sklearn.pipeline import Pipeline
-from sklearn.preprocessing import PolynomialFeatures
-from sklearn.linear_model import LinearRegression
-from sklearn.model_selection import cross_val_score
-
-
-def true_fun(X):
-    return np.cos(1.5 * np.pi * X)
-
-np.random.seed(0)
-
-n_samples = 30
-degrees = [1, 4, 15]
-
-X = np.sort(np.random.rand(n_samples))
-y = true_fun(X) + np.random.randn(n_samples) * 0.1
-
-plt.figure(figsize=(14, 5))
-for i in range(len(degrees)):
-    ax = plt.subplot(1, len(degrees), i + 1)
-    plt.setp(ax, xticks=(), yticks=())
-
-    polynomial_features = PolynomialFeatures(degree=degrees[i],
-                                             include_bias=False)
-    linear_regression = LinearRegression()
-    pipeline = Pipeline([("polynomial_features", polynomial_features),
-                         ("linear_regression", linear_regression)])
-    pipeline.fit(X[:, np.newaxis], y)
-
-    # Evaluate the models using crossvalidation
-    scores = cross_val_score(pipeline, X[:, np.newaxis], y,
-                             scoring="neg_mean_squared_error", cv=10)
-
-    X_test = np.linspace(0, 1, 100)
-    plt.plot(X_test, pipeline.predict(X_test[:, np.newaxis]), label="Model")
-    plt.plot(X_test, true_fun(X_test), label="True function")
-    plt.scatter(X, y, edgecolor='b', s=20, label="Samples")
-    plt.xlabel("x")
-    plt.ylabel("y")
-    plt.xlim((0, 1))
-    plt.ylim((-2, 2))
-    plt.legend(loc="best")
-    plt.title("Degree {}\nMSE = {:.2e}(+/- {:.2e})".format(
-        degrees[i], -scores.mean(), scores.std()))
-plt.show()
-
-
-
-
-
============================
-Underfitting vs. Overfitting
-============================
-
-This example demonstrates the problems of underfitting and overfitting and
-how we can use linear regression with polynomial features to approximate
-nonlinear functions. The plot shows the function that we want to approximate,
-which is a part of the cosine function. In addition, the samples from the
-real function and the approximations of different models are displayed. The
-models have polynomial features of different degrees. We can see that a
-linear function (polynomial with degree 1) is not sufficient to fit the
-training samples. This is called **underfitting**. A polynomial of degree 4
-approximates the true function almost perfectly. However, for higher degrees
-the model will **overfit** the training data, i.e. it learns the noise of the
-training data.
-We evaluate quantitatively **overfitting** / **underfitting** by using
-cross-validation. We calculate the mean squared error (MSE) on the validation
-set, the higher, the less likely the model generalizes correctly from the
-training data.
-
-
-_images/chapter3_64_1.png -
-
-
-
-
# Common imports
-import os
-import numpy as np
-import pandas as pd
-import matplotlib.pyplot as plt
-from sklearn.linear_model import LinearRegression, Ridge, Lasso
-from sklearn.model_selection import train_test_split
-from sklearn.utils import resample
-from sklearn.metrics import mean_squared_error
-# Where to save the figures and data files
-PROJECT_ROOT_DIR = "Results"
-FIGURE_ID = "Results/FigureFiles"
-DATA_ID = "DataFiles/"
-
-if not os.path.exists(PROJECT_ROOT_DIR):
-    os.mkdir(PROJECT_ROOT_DIR)
-
-if not os.path.exists(FIGURE_ID):
-    os.makedirs(FIGURE_ID)
-
-if not os.path.exists(DATA_ID):
-    os.makedirs(DATA_ID)
-
-def image_path(fig_id):
-    return os.path.join(FIGURE_ID, fig_id)
-
-def data_path(dat_id):
-    return os.path.join(DATA_ID, dat_id)
-
-def save_fig(fig_id):
-    plt.savefig(image_path(fig_id) + ".png", format='png')
-
-infile = open(data_path("EoS.csv"),'r')
-
-# Read the EoS data as  csv file and organize the data into two arrays with density and energies
-EoS = pd.read_csv(infile, names=('Density', 'Energy'))
-EoS['Energy'] = pd.to_numeric(EoS['Energy'], errors='coerce')
-EoS = EoS.dropna()
-Energies = EoS['Energy']
-Density = EoS['Density']
-#  The design matrix now as function of various polytrops
-
-Maxpolydegree = 30
-X = np.zeros((len(Density),Maxpolydegree))
-X[:,0] = 1.0
-testerror = np.zeros(Maxpolydegree)
-trainingerror = np.zeros(Maxpolydegree)
-polynomial = np.zeros(Maxpolydegree)
-
-trials = 100
-for polydegree in range(1, Maxpolydegree):
-    polynomial[polydegree] = polydegree
-    for degree in range(polydegree):
-        X[:,degree] = Density**(degree/3.0)
-
-# loop over trials in order to estimate the expectation value of the MSE
-    testerror[polydegree] = 0.0
-    trainingerror[polydegree] = 0.0
-    for samples in range(trials):
-        x_train, x_test, y_train, y_test = train_test_split(X, Energies, test_size=0.2)
-        model = LinearRegression(fit_intercept=False).fit(x_train, y_train)
-        ypred = model.predict(x_train)
-        ytilde = model.predict(x_test)
-        testerror[polydegree] += mean_squared_error(y_test, ytilde)
-        trainingerror[polydegree] += mean_squared_error(y_train, ypred) 
-
-    testerror[polydegree] /= trials
-    trainingerror[polydegree] /= trials
-    print("Degree of polynomial: %3d"% polynomial[polydegree])
-    print("Mean squared error on training data: %.8f" % trainingerror[polydegree])
-    print("Mean squared error on test data: %.8f" % testerror[polydegree])
-
-plt.plot(polynomial, np.log10(trainingerror), label='Training Error')
-plt.plot(polynomial, np.log10(testerror), label='Test Error')
-plt.xlabel('Polynomial degree')
-plt.ylabel('log10[MSE]')
-plt.legend()
-plt.show()
-
-
-
-
-
Degree of polynomial:   1
-Mean squared error on training data: 439230.69504801
-Mean squared error on test data: 481979.17861098
-Degree of polynomial:   2
-Mean squared error on training data: 115822.95008046
-Mean squared error on test data: 123711.53703498
-Degree of polynomial:   3
-Mean squared error on training data: 9011.85263220
-Mean squared error on test data: 10913.84780262
-Degree of polynomial:   4
-Mean squared error on training data: 303.47610036
-Mean squared error on test data: 426.30787294
-
-
-
Degree of polynomial:   5
-Mean squared error on training data: 3.80354994
-Mean squared error on test data: 5.98822371
-Degree of polynomial:   6
-Mean squared error on training data: 3.66204648
-Mean squared error on test data: 8.14812206
-Degree of polynomial:   7
-Mean squared error on training data: 0.47075725
-Mean squared error on test data: 2.00607783
-Degree of polynomial:   8
-Mean squared error on training data: 0.04912436
-Mean squared error on test data: 0.21596432
-
-
-
Degree of polynomial:   9
-Mean squared error on training data: 0.02522069
-Mean squared error on test data: 0.08576932
-Degree of polynomial:  10
-Mean squared error on training data: 0.02511518
-Mean squared error on test data: 1.20015436
-Degree of polynomial:  11
-Mean squared error on training data: 0.01640891
-Mean squared error on test data: 1.35533774
-Degree of polynomial:  12
-Mean squared error on training data: 0.00813803
-Mean squared error on test data: 0.17446471
-
-
-
Degree of polynomial:  13
-Mean squared error on training data: 0.00759119
-Mean squared error on test data: 1.08131001
-Degree of polynomial:  14
-Mean squared error on training data: 0.00472199
-Mean squared error on test data: 0.81333802
-Degree of polynomial:  15
-Mean squared error on training data: 0.00410478
-Mean squared error on test data: 92.09160813
-
-
-
Degree of polynomial:  16
-Mean squared error on training data: 0.00315593
-Mean squared error on test data: 234.40530431
-Degree of polynomial:  17
-Mean squared error on training data: 0.00242999
-Mean squared error on test data: 1270.94936405
-Degree of polynomial:  18
-Mean squared error on training data: 0.00228741
-Mean squared error on test data: 108.11945731
-Degree of polynomial:  19
-Mean squared error on training data: 0.00156372
-Mean squared error on test data: 1376.61081005
-
-
-
Degree of polynomial:  20
-Mean squared error on training data: 0.00137945
-Mean squared error on test data: 1931.97211078
-Degree of polynomial:  21
-Mean squared error on training data: 0.00118678
-Mean squared error on test data: 14496.70992192
-Degree of polynomial:  22
-Mean squared error on training data: 0.00092686
-Mean squared error on test data: 873.95463048
-
-
-
Degree of polynomial:  23
-Mean squared error on training data: 0.00085890
-Mean squared error on test data: 5535.20053452
-Degree of polynomial:  24
-Mean squared error on training data: 0.00084714
-Mean squared error on test data: 1289.22422186
-Degree of polynomial:  25
-Mean squared error on training data: 0.00079022
-Mean squared error on test data: 136582.88824397
-Degree of polynomial:  26
-Mean squared error on training data: 0.00076923
-Mean squared error on test data: 18194.23521766
-
-
-
Degree of polynomial:  27
-Mean squared error on training data: 0.00069302
-Mean squared error on test data: 2579.13493762
-Degree of polynomial:  28
-Mean squared error on training data: 0.00062728
-Mean squared error on test data: 3984.82493809
-Degree of polynomial:  29
-Mean squared error on training data: 0.00060724
-Mean squared error on test data: 3204.07047448
-
-
-
<ipython-input-7-40a38ad763f1>:73: RuntimeWarning: divide by zero encountered in log10
-  plt.plot(polynomial, np.log10(trainingerror), label='Training Error')
-<ipython-input-7-40a38ad763f1>:74: RuntimeWarning: divide by zero encountered in log10
-  plt.plot(polynomial, np.log10(testerror), label='Test Error')
-
-
-_images/chapter3_65_9.png -
-
-
-
-

5.5. Cross-validation

-

When the repetitive splitting of the data set is done randomly, -samples may accidently end up in a fast majority of the splits in -either training or test set. Such samples may have an unbalanced -influence on either model building or prediction evaluation. To avoid -this \(k\)-fold cross-validation structures the data splitting. The -samples are divided into \(k\) more or less equally sized exhaustive and -mutually exclusive subsets. In turn (at each split) one of these -subsets plays the role of the test set while the union of the -remaining subsets constitutes the training set. Such a splitting -warrants a balanced representation of each sample in both training and -test set over the splits. Still the division into the \(k\) subsets -involves a degree of randomness. This may be fully excluded when -choosing \(k=n\). This particular case is referred to as leave-one-out -cross-validation (LOOCV).

-
    -
  • Define a range of interest for the penalty parameter.

  • -
  • Divide the data set into training and test set comprising samples \(\{1, \ldots, n\} \setminus i\) and \(\{ i \}\), respectively.

  • -
  • Fit the linear regression model by means of ridge estimation for each \(\lambda\) in the grid using the training set, and the corresponding estimate of the error variance \(\boldsymbol{\sigma}_{-i}^2(\lambda)\), as

  • -
-
-\[ -\begin{align*} -\boldsymbol{\beta}_{-i}(\lambda) & = ( \boldsymbol{X}_{-i, \ast}^{T} -\boldsymbol{X}_{-i, \ast} + \lambda \boldsymbol{I}_{pp})^{-1} -\boldsymbol{X}_{-i, \ast}^{T} \boldsymbol{y}_{-i} -\end{align*} -\]
-
    -
  • Evaluate the prediction performance of these models on the test set by \(\log\{L[y_i, \boldsymbol{X}_{i, \ast}; \boldsymbol{\beta}_{-i}(\lambda), \boldsymbol{\sigma}_{-i}^2(\lambda)]\}\). Or, by the prediction error \(|y_i - \boldsymbol{X}_{i, \ast} \boldsymbol{\beta}_{-i}(\lambda)|\), the relative error, the error squared or the R2 score function.

  • -
  • Repeat the first three steps such that each sample plays the role of the test set once.

  • -
  • Average the prediction performances of the test sets at each grid point of the penalty bias/parameter. It is an estimate of the prediction performance of the model corresponding to this value of the penalty parameter on novel data. It is defined as

  • -
-
-\[ -\begin{align*} -\frac{1}{n} \sum_{i = 1}^n \log\{L[y_i, \mathbf{X}_{i, \ast}; \boldsymbol{\beta}_{-i}(\lambda), \boldsymbol{\sigma}_{-i}^2(\lambda)]\}. -\end{align*} -\]
-

For the various values of \(k\)

-
    -
  1. shuffle the dataset randomly.

  2. -
  3. Split the dataset into \(k\) groups.

  4. -
  5. For each unique group:

  6. -
-

a. Decide which group to use as set for test data

-

b. Take the remaining groups as a training data set

-

c. Fit a model on the training set and evaluate it on the test set

-

d. Retain the evaluation score and discard the model

-
    -
  1. Summarize the model using the sample of model evaluation scores

  2. -
-

The code here uses Ridge regression with cross-validation (CV) resampling and \(k\)-fold CV in order to fit a specific polynomial.

-
-
-
import numpy as np
-import matplotlib.pyplot as plt
-from sklearn.model_selection import KFold
-from sklearn.linear_model import Ridge
-from sklearn.model_selection import cross_val_score
-from sklearn.preprocessing import PolynomialFeatures
-
-# A seed just to ensure that the random numbers are the same for every run.
-# Useful for eventual debugging.
-np.random.seed(3155)
-
-# Generate the data.
-nsamples = 100
-x = np.random.randn(nsamples)
-y = 3*x**2 + np.random.randn(nsamples)
-
-## Cross-validation on Ridge regression using KFold only
-
-# Decide degree on polynomial to fit
-poly = PolynomialFeatures(degree = 6)
-
-# Decide which values of lambda to use
-nlambdas = 500
-lambdas = np.logspace(-3, 5, nlambdas)
-
-# Initialize a KFold instance
-k = 5
-kfold = KFold(n_splits = k)
-
-# Perform the cross-validation to estimate MSE
-scores_KFold = np.zeros((nlambdas, k))
-
-i = 0
-for lmb in lambdas:
-    ridge = Ridge(alpha = lmb)
-    j = 0
-    for train_inds, test_inds in kfold.split(x):
-        xtrain = x[train_inds]
-        ytrain = y[train_inds]
-
-        xtest = x[test_inds]
-        ytest = y[test_inds]
-
-        Xtrain = poly.fit_transform(xtrain[:, np.newaxis])
-        ridge.fit(Xtrain, ytrain[:, np.newaxis])
-
-        Xtest = poly.fit_transform(xtest[:, np.newaxis])
-        ypred = ridge.predict(Xtest)
-
-        scores_KFold[i,j] = np.sum((ypred - ytest[:, np.newaxis])**2)/np.size(ypred)
-
-        j += 1
-    i += 1
-
-
-estimated_mse_KFold = np.mean(scores_KFold, axis = 1)
-
-## Cross-validation using cross_val_score from sklearn along with KFold
-
-# kfold is an instance initialized above as:
-# kfold = KFold(n_splits = k)
-
-estimated_mse_sklearn = np.zeros(nlambdas)
-i = 0
-for lmb in lambdas:
-    ridge = Ridge(alpha = lmb)
-
-    X = poly.fit_transform(x[:, np.newaxis])
-    estimated_mse_folds = cross_val_score(ridge, X, y[:, np.newaxis], scoring='neg_mean_squared_error', cv=kfold)
-
-    # cross_val_score return an array containing the estimated negative mse for every fold.
-    # we have to the the mean of every array in order to get an estimate of the mse of the model
-    estimated_mse_sklearn[i] = np.mean(-estimated_mse_folds)
-
-    i += 1
-
-## Plot and compare the slightly different ways to perform cross-validation
-
-plt.figure()
-
-plt.plot(np.log10(lambdas), estimated_mse_sklearn, label = 'cross_val_score')
-plt.plot(np.log10(lambdas), estimated_mse_KFold, 'r--', label = 'KFold')
-
-plt.xlabel('log10(lambda)')
-plt.ylabel('mse')
-
-plt.legend()
-
-plt.show()
-
-
-
-
-_images/chapter3_71_0.png -
-
-

More examples of the application of cross-validation follow here.

-
-
-
# Common imports
-import os
-import numpy as np
-import pandas as pd
-import matplotlib.pyplot as plt
-from sklearn.linear_model import LinearRegression, Ridge, Lasso
-from sklearn.metrics import mean_squared_error
-from sklearn.model_selection import KFold
-from sklearn.model_selection import cross_val_score
-
-
-# Where to save the figures and data files
-PROJECT_ROOT_DIR = "Results"
-FIGURE_ID = "Results/FigureFiles"
-DATA_ID = "DataFiles/"
-
-if not os.path.exists(PROJECT_ROOT_DIR):
-    os.mkdir(PROJECT_ROOT_DIR)
-
-if not os.path.exists(FIGURE_ID):
-    os.makedirs(FIGURE_ID)
-
-if not os.path.exists(DATA_ID):
-    os.makedirs(DATA_ID)
-
-def image_path(fig_id):
-    return os.path.join(FIGURE_ID, fig_id)
-
-def data_path(dat_id):
-    return os.path.join(DATA_ID, dat_id)
-
-def save_fig(fig_id):
-    plt.savefig(image_path(fig_id) + ".png", format='png')
-
-infile = open(data_path("EoS.csv"),'r')
-
-# Read the EoS data as  csv file and organize the data into two arrays with density and energies
-EoS = pd.read_csv(infile, names=('Density', 'Energy'))
-EoS['Energy'] = pd.to_numeric(EoS['Energy'], errors='coerce')
-EoS = EoS.dropna()
-Energies = EoS['Energy']
-Density = EoS['Density']
-#  The design matrix now as function of various polytrops
-
-Maxpolydegree = 30
-X = np.zeros((len(Density),Maxpolydegree))
-X[:,0] = 1.0
-estimated_mse_sklearn = np.zeros(Maxpolydegree)
-polynomial = np.zeros(Maxpolydegree)
-k =5
-kfold = KFold(n_splits = k)
-
-for polydegree in range(1, Maxpolydegree):
-    polynomial[polydegree] = polydegree
-    for degree in range(polydegree):
-        X[:,degree] = Density**(degree/3.0)
-        OLS = LinearRegression(fit_intercept=False)
-# loop over trials in order to estimate the expectation value of the MSE
-    estimated_mse_folds = cross_val_score(OLS, X, Energies, scoring='neg_mean_squared_error', cv=kfold)
-#[:, np.newaxis]
-    estimated_mse_sklearn[polydegree] = np.mean(-estimated_mse_folds)
-
-plt.plot(polynomial, np.log10(estimated_mse_sklearn), label='Test Error')
-plt.xlabel('Polynomial degree')
-plt.ylabel('log10[MSE]')
-plt.legend()
-plt.show()
-
-
-
-
-
<ipython-input-9-6e75736fdab1>:63: RuntimeWarning: divide by zero encountered in log10
-  plt.plot(polynomial, np.log10(estimated_mse_sklearn), label='Test Error')
-
-
-_images/chapter3_73_1.png -
-
-

Note that we have kept the intercept in the first column of design matrix \(\boldsymbol{X}\). When we call the corresponding Scikit-Learn function we need thus to set the intercept to False. Libraries like Scikit-Learn normally scale the design matrix and does not fit intercept. See the discussions below.

-
-
-

5.6. More on Rescaling data

-

We end this chapter by adding some words on scaling and how to deal with the intercept for regression cases.

-

When you are comparing your own code with for example Scikit-Learn’s -library, there are some technicalities to keep in mind. The examples -here demonstrate some of these aspects with potential pitfalls.

-

The discussion here focuses on the role of the intercept, how we can -set up the design matrix, what scaling we should use and other topics -which tend confuse us.

-

The intercept can be interpreted as the expected value of our -target/output variables when all other predictors are set to zero. -Thus, if we cannot assume that the expected outputs/targets are zero -when all predictors are zero (the columns in the design matrix), it -may be a bad idea to implement a model which penalizes the intercept. -Furthermore, in for example Ridge and Lasso regression, the default solutions -from the library Scikit-Learn (when not shrinking \(\beta_0\)) for the unknown parameters -\(\boldsymbol{\beta}\), are derived under the assumption that both \(\boldsymbol{y}\) and -\(\boldsymbol{X}\) are zero centered, that is we subtract the mean values.

-

If our predictors represent different scales, then it is important to -standardize the design matrix \(\boldsymbol{X}\) by subtracting the mean of each -column from the corresponding column and dividing the column with its -standard deviation. Most machine learning libraries do this as a default. This means that if you compare your code with the results from a given library, -the results may differ.

-

The -Standardscaler -function in Scikit-Learn does this for us. For the data sets we -have been studying in our various examples, the data are in many cases -already scaled and there is no need to scale them. You as a user of different machine learning algorithms, should always perform a -survey of your data, with a critical assessment of them in case you need to scale the data.

-

If you need to scale the data, not doing so will give an unfair -penalization of the parameters since their magnitude depends on the -scale of their corresponding predictor.

-

Suppose as an example that you -you have an input variable given by the heights of different persons. -Human height might be measured in inches or meters or -kilometers. If measured in kilometers, a standard linear regression -model with this predictor would probably give a much bigger -coefficient term, than if measured in millimeters. -This can clearly lead to problems in evaluating the cost/loss functions.

-

Keep in mind that when you transform your data set before training a model, the same transformation needs to be done -on your eventual new data set before making a prediction. If we translate this into a Python code, it would could be implemented as follows

-
-
-
"""
-#Model training, we compute the mean value of y and X
-y_train_mean = np.mean(y_train)
-X_train_mean = np.mean(X_train,axis=0)
-X_train = X_train - X_train_mean
-y_train = y_train - y_train_mean
-
-# The we fit our model with the training data
-trained_model = some_model.fit(X_train,y_train)
-
-
-#Model prediction, we need also to transform our data set used for the prediction.
-X_test = X_test - X_train_mean #Use mean from training data
-y_pred = trained_model(X_test)
-y_pred = y_pred + y_train_mean
-"""
-
-
-
-
-
'\n#Model training, we compute the mean value of y and X\ny_train_mean = np.mean(y_train)\nX_train_mean = np.mean(X_train,axis=0)\nX_train = X_train - X_train_mean\ny_train = y_train - y_train_mean\n\n# The we fit our model with the training data\ntrained_model = some_model.fit(X_train,y_train)\n\n\n#Model prediction, we need also to transform our data set used for the prediction.\nX_test = X_test - X_train_mean #Use mean from training data\ny_pred = trained_model(X_test)\ny_pred = y_pred + y_train_mean\n'
-
-
-
-
-

Let us try to understand what this may imply mathematically when we -subtract the mean values, also known as zero centering. For -simplicity, we will focus on ordinary regression, as done in the above example.

-

The cost/loss function for regression is

-
-\[ -C(\beta_0, \beta_1, ... , \beta_{p-1}) = \frac{1}{n}\sum_{i=0}^{n} \left(y_i - \beta_0 - \sum_{j=1}^{p-1} X_{ij}\beta_j\right)^2,. -\]
-

Recall also that we use the squared value. This expression can lead to an -increased penalty for higher differences between predicted and -output/target values.

-

What we have done is to single out the \(\beta_0\) term in the -definition of the mean squared error (MSE). The design matrix \(X\) -does in this case not contain any intercept column. When we take the -derivative with respect to \(\beta_0\), we want the derivative to obey

-
-\[ -\frac{\partial C}{\partial \beta_j} = 0, -\]
-

for all \(j\). For \(\beta_0\) we have

-
-\[ -\frac{\partial C}{\partial \beta_0} = -\frac{2}{n}\sum_{i=0}^{n-1} \left(y_i - \beta_0 - \sum_{j=1}^{p-1} X_{ij} \beta_j\right). -\]
-

Multiplying away the constant \(2/n\), we obtain

-
-\[ -\sum_{i=0}^{n-1} \beta_0 = \sum_{i=0}^{n-1}y_i - \sum_{i=0}^{n-1} \sum_{j=1}^{p-1} X_{ij} \beta_j. -\]
-

Let us specialize first to the case where we have only two parameters \(\beta_0\) and \(\beta_1\). -Our result for \(\beta_0\) simplifies then to

-
-\[ -n\beta_0 = \sum_{i=0}^{n-1}y_i - \sum_{i=0}^{n-1} X_{i1} \beta_1. -\]
-

We obtain then

-
-\[ -\beta_0 = \frac{1}{n}\sum_{i=0}^{n-1}y_i - \beta_1\frac{1}{n}\sum_{i=0}^{n-1} X_{i1}. -\]
-

If we define

-
-\[ -\mu_{\boldsymbol{x}_1}=\frac{1}{n}\sum_{i=0}^{n-1} X_{i1}, -\]
-

and the mean value of the outputs as

-
-\[ -\mu_y=\frac{1}{n}\sum_{i=0}^{n-1}y_i, -\]
-

we have

-
-\[ -\beta_0 = \mu_y - \beta_1\mu_{\boldsymbol{x}_1}. -\]
-

In the general case with more parameters than \(\beta_0\) and \(\beta_1\), we have

-
-\[ -\beta_0 = \frac{1}{n}\sum_{i=0}^{n-1}y_i - \frac{1}{n}\sum_{i=0}^{n-1}\sum_{j=1}^{p-1} X_{ij}\beta_j. -\]
-

We can rewrite the latter equation as

-
-\[ -\beta_0 = \frac{1}{n}\sum_{i=0}^{n-1}y_i - \sum_{j=1}^{p-1} \mu_{\boldsymbol{x}_j}\beta_j, -\]
-

where we have defined

-
-\[ -\mu_{\boldsymbol{x}_j}=\frac{1}{n}\sum_{i=0}^{n-1} X_{ij}, -\]
-

the mean value for all elements of the column vector \(\boldsymbol{x}_j\).

-

Replacing \(y_i\) with \(y_i - y_i - \overline{\boldsymbol{y}}\) and centering also our design matrix results in a cost function (in vector-matrix disguise)

-
-\[ -C(\boldsymbol{\beta}) = (\boldsymbol{\tilde{y}} - \tilde{X}\boldsymbol{\beta})^T(\boldsymbol{\tilde{y}} - \tilde{X}\boldsymbol{\beta}). -\]
-

If we minimize with respect to \(\boldsymbol{\beta}\) we have then

-
-\[ -\hat{\boldsymbol{\beta}} = (\tilde{X}^T\tilde{X})^{-1}\tilde{X}^T\boldsymbol{\tilde{y}}, -\]
-

where \(\boldsymbol{\tilde{y}} = \boldsymbol{y} - \overline{\boldsymbol{y}}\) -and \(\tilde{X}_{ij} = X_{ij} - \frac{1}{n}\sum_{k=0}^{n-1}X_{kj}\).

-

For Ridge regression we need to add \(\lambda \boldsymbol{\beta}^T\boldsymbol{\beta}\) to the cost function and get then

-
-\[ -\hat{\boldsymbol{\beta}} = (\tilde{X}^T\tilde{X} + \lambda I)^{-1}\tilde{X}^T\boldsymbol{\tilde{y}}. -\]
-

What does this mean? And why do we insist on all this? Let us look at some examples.

-

This code shows a simple first-order fit to a data set using the above transformed data, where we consider the role of the intercept first, by either excluding it or including it (code example thanks to Øyvind Sigmundson Schøyen). Here our scaling of the data is done by subtracting the mean values only. -Note also that we do not split the data into training and test.

-
-
-
import numpy as np
-import matplotlib.pyplot as plt
-
-from sklearn.linear_model import LinearRegression
-
-
-np.random.seed(2021)
-
-def MSE(y_data,y_model):
-    n = np.size(y_model)
-    return np.sum((y_data-y_model)**2)/n
-
-
-def fit_beta(X, y):
-    return np.linalg.pinv(X.T @ X) @ X.T @ y
-
-
-true_beta = [2, 0.5, 3.7]
-
-x = np.linspace(0, 1, 11)
-y = np.sum(
-    np.asarray([x ** p * b for p, b in enumerate(true_beta)]), axis=0
-) + 0.1 * np.random.normal(size=len(x))
-
-degree = 3
-X = np.zeros((len(x), degree))
-
-# Include the intercept in the design matrix
-for p in range(degree):
-    X[:, p] = x ** p
-
-beta = fit_beta(X, y)
-
-# Intercept is included in the design matrix
-skl = LinearRegression(fit_intercept=False).fit(X, y)
-
-print(f"True beta: {true_beta}")
-print(f"Fitted beta: {beta}")
-print(f"Sklearn fitted beta: {skl.coef_}")
-ypredictOwn = X @ beta
-ypredictSKL = skl.predict(X)
-print(f"MSE with intercept column")
-print(MSE(y,ypredictOwn))
-print(f"MSE with intercept column from SKL")
-print(MSE(y,ypredictSKL))
-
-
-plt.figure()
-plt.scatter(x, y, label="Data")
-plt.plot(x, X @ beta, label="Fit")
-plt.plot(x, skl.predict(X), label="Sklearn (fit_intercept=False)")
-
-
-# Do not include the intercept in the design matrix
-X = np.zeros((len(x), degree - 1))
-
-for p in range(degree - 1):
-    X[:, p] = x ** (p + 1)
-
-# Intercept is not included in the design matrix
-skl = LinearRegression(fit_intercept=True).fit(X, y)
-
-# Use centered values for X and y when computing coefficients
-y_offset = np.average(y, axis=0)
-X_offset = np.average(X, axis=0)
-
-beta = fit_beta(X - X_offset, y - y_offset)
-intercept = np.mean(y_offset - X_offset @ beta)
-
-print(f"Manual intercept: {intercept}")
-print(f"Fitted beta (wiothout intercept): {beta}")
-print(f"Sklearn intercept: {skl.intercept_}")
-print(f"Sklearn fitted beta (without intercept): {skl.coef_}")
-ypredictOwn = X @ beta
-ypredictSKL = skl.predict(X)
-print(f"MSE with Manual intercept")
-print(MSE(y,ypredictOwn+intercept))
-print(f"MSE with Sklearn intercept")
-print(MSE(y,ypredictSKL))
-
-plt.plot(x, X @ beta + intercept, "--", label="Fit (manual intercept)")
-plt.plot(x, skl.predict(X), "--", label="Sklearn (fit_intercept=True)")
-plt.grid()
-plt.legend()
-
-plt.show()
-
-
-
-
-
True beta: [2, 0.5, 3.7]
-Fitted beta: [2.08376632 0.19569961 3.97898392]
-Sklearn fitted beta: [2.08376632 0.19569961 3.97898392]
-MSE with intercept column
-0.004113634617443137
-MSE with intercept column from SKL
-0.0041136346174431284
-Manual intercept: 2.083766322923905
-Fitted beta (wiothout intercept): [0.19569961 3.97898392]
-Sklearn intercept: 2.0837663229239025
-Sklearn fitted beta (without intercept): [0.19569961 3.97898392]
-MSE with Manual intercept
-0.004113634617443136
-MSE with Sklearn intercept
-0.004113634617443135
-
-
-_images/chapter3_107_1.png -
-
-

The intercept is the value of our output/target variable -when all our features are zero and our function crosses the \(y\)-axis (for a one-dimensional case).

-

Printing the MSE, we see first that both methods give the same MSE, as -they should. However, when we move to for example Ridge regression, -the way we treat the intercept may give a larger or smaller MSE, -meaning that the MSE can be penalized by the value of the -intercept. Not including the intercept in the fit, means that the -regularization term does not include \(\beta_0\). For different values -of \(\lambda\), this may lead to differeing MSE values.

-

To remind the reader, the regularization term, with the intercept in Ridge regression, is given by

-
-\[ -\lambda \vert\vert \boldsymbol{\beta} \vert\vert_2^2 = \lambda \sum_{j=0}^{p-1}\beta_j^2, -\]
-

but when we take out the intercept, this equation becomes

-
-\[ -\lambda \vert\vert \boldsymbol{\beta} \vert\vert_2^2 = \lambda \sum_{j=1}^{p-1}\beta_j^2. -\]
-

For Lasso regression we have

-
-\[ -\lambda \vert\vert \boldsymbol{\beta} \vert\vert_1 = \lambda \sum_{j=1}^{p-1}\vert\beta_j\vert. -\]
-

It means that, when scaling the design matrix and the outputs/targets, -by subtracting the mean values, we have an optimization problem which -is not penalized by the intercept. The MSE value can then be smaller -since it focuses only on the remaining quantities. If we however bring -back the intercept, we will get a MSE which then contains the -intercept.

-

Armed with this wisdom, we attempt first to simply set the intercept equal to False in our implementation of Ridge regression for our well-known vanilla data set.

-
-
-
import numpy as np
-import pandas as pd
-import matplotlib.pyplot as plt
-from sklearn.model_selection import train_test_split
-from sklearn import linear_model
-
-def MSE(y_data,y_model):
-    n = np.size(y_model)
-    return np.sum((y_data-y_model)**2)/n
-
-
-# A seed just to ensure that the random numbers are the same for every run.
-# Useful for eventual debugging.
-np.random.seed(3155)
-
-n = 100
-x = np.random.rand(n)
-y = np.exp(-x**2) + 1.5 * np.exp(-(x-2)**2)
-
-Maxpolydegree = 20
-X = np.zeros((n,Maxpolydegree))
-#We include explicitely the intercept column
-for degree in range(Maxpolydegree):
-    X[:,degree] = x**degree
-# We split the data in test and training data
-X_train, X_test, y_train, y_test = train_test_split(X, y, test_size=0.2)
-
-p = Maxpolydegree
-I = np.eye(p,p)
-# Decide which values of lambda to use
-nlambdas = 6
-MSEOwnRidgePredict = np.zeros(nlambdas)
-MSERidgePredict = np.zeros(nlambdas)
-lambdas = np.logspace(-4, 2, nlambdas)
-for i in range(nlambdas):
-    lmb = lambdas[i]
-    OwnRidgeBeta = np.linalg.pinv(X_train.T @ X_train+lmb*I) @ X_train.T @ y_train
-    # Note: we include the intercept column and no scaling
-    RegRidge = linear_model.Ridge(lmb,fit_intercept=False)
-    RegRidge.fit(X_train,y_train)
-    # and then make the prediction
-    ytildeOwnRidge = X_train @ OwnRidgeBeta
-    ypredictOwnRidge = X_test @ OwnRidgeBeta
-    ytildeRidge = RegRidge.predict(X_train)
-    ypredictRidge = RegRidge.predict(X_test)
-    MSEOwnRidgePredict[i] = MSE(y_test,ypredictOwnRidge)
-    MSERidgePredict[i] = MSE(y_test,ypredictRidge)
-    print("Beta values for own Ridge implementation")
-    print(OwnRidgeBeta)
-    print("Beta values for Scikit-Learn Ridge implementation")
-    print(RegRidge.coef_)
-    print("MSE values for own Ridge implementation")
-    print(MSEOwnRidgePredict[i])
-    print("MSE values for Scikit-Learn Ridge implementation")
-    print(MSERidgePredict[i])
-
-# Now plot the results
-plt.figure()
-plt.plot(np.log10(lambdas), MSEOwnRidgePredict, 'r', label = 'MSE own Ridge Test')
-plt.plot(np.log10(lambdas), MSERidgePredict, 'g', label = 'MSE Ridge Test')
-
-plt.xlabel('log10(lambda)')
-plt.ylabel('MSE')
-plt.legend()
-plt.show()
-
-
-
-
-
Beta values for own Ridge implementation
-[ 1.03032441e+00  6.28336218e-02 -6.24175744e-01  5.21169159e-02
-  2.80847477e-01  2.12552073e-01  8.13220609e-02 -1.69634577e-02
- -6.50846112e-02 -7.38962192e-02 -5.94226022e-02 -3.50227564e-02
- -9.80609614e-03  1.08299273e-02  2.41882037e-02  2.93492130e-02
-  2.64742912e-02  1.63249532e-02 -5.01831250e-05 -2.15098090e-02]
-Beta values for Scikit-Learn Ridge implementation
-[ 1.03032441e+00  6.28336218e-02 -6.24175744e-01  5.21169159e-02
-  2.80847477e-01  2.12552073e-01  8.13220608e-02 -1.69634577e-02
- -6.50846112e-02 -7.38962192e-02 -5.94226022e-02 -3.50227564e-02
- -9.80609615e-03  1.08299273e-02  2.41882037e-02  2.93492130e-02
-  2.64742912e-02  1.63249532e-02 -5.01831152e-05 -2.15098090e-02]
-MSE values for own Ridge implementation
-4.3632959273186007e-07
-MSE values for Scikit-Learn Ridge implementation
-4.363295916523824e-07
-Beta values for own Ridge implementation
-[ 1.03630548 -0.01963611 -0.37900111 -0.07062318  0.12182967  0.16343471
-  0.13003291  0.07490892  0.02365049 -0.01449782 -0.03814292 -0.04909093
- -0.05009826 -0.04389027 -0.03279636 -0.01866537 -0.00289724  0.01348565
-  0.02976145  0.04543942]
-Beta values for Scikit-Learn Ridge implementation
-[ 1.03630548 -0.01963611 -0.37900111 -0.07062318  0.12182967  0.16343471
-  0.13003291  0.07490892  0.02365049 -0.01449782 -0.03814292 -0.04909093
- -0.05009826 -0.04389027 -0.03279636 -0.01866537 -0.00289724  0.01348565
-  0.02976145  0.04543942]
-MSE values for own Ridge implementation
-5.194042826640948e-06
-MSE values for Scikit-Learn Ridge implementation
-5.194042826840599e-06
-Beta values for own Ridge implementation
-[ 1.04220758 -0.10931453 -0.17641709 -0.06020587  0.02208512  0.05789007
-  0.06491736  0.05785343  0.04537385  0.03196357  0.01969145  0.00934499
-  0.00107405 -0.00526348 -0.00992331 -0.01318643 -0.01531845 -0.01655318
- -0.01708852 -0.01708781]
-Beta values for Scikit-Learn Ridge implementation
-[ 1.04220758 -0.10931453 -0.17641709 -0.06020587  0.02208512  0.05789007
-  0.06491736  0.05785343  0.04537385  0.03196357  0.01969145  0.00934499
-  0.00107405 -0.00526348 -0.00992331 -0.01318643 -0.01531845 -0.01655318
- -0.01708852 -0.01708781]
-MSE values for own Ridge implementation
-2.094082198961287e-05
-MSE values for Scikit-Learn Ridge implementation
-2.0940821989631478e-05
-Beta values for own Ridge implementation
-[ 1.01219292 -0.06043581 -0.10391807 -0.05651951 -0.01898855  0.00312361
-  0.01463049  0.01975848  0.02123176  0.02068067  0.01905883  0.01691985
-  0.01458337  0.01223198  0.00996754  0.00784393  0.00588657  0.00410387
-  0.00249435  0.00105081]
-Beta values for Scikit-Learn Ridge implementation
-[ 1.01219292 -0.06043581 -0.10391807 -0.05651951 -0.01898855  0.00312361
-  0.01463049  0.01975848  0.02123176  0.02068067  0.01905883  0.01691985
-  0.01458337  0.01223198  0.00996754  0.00784393  0.00588657  0.00410387
-  0.00249435  0.00105081]
-MSE values for own Ridge implementation
-0.00031535148309579146
-MSE values for Scikit-Learn Ridge implementation
-0.00031535148309581185
-Beta values for own Ridge implementation
-[ 8.38916861e-01  1.31276579e-01  8.97497404e-03 -1.72271878e-02
- -2.11744554e-02 -1.91492986e-02 -1.57201944e-02 -1.23002365e-02
- -9.30466214e-03 -6.81048318e-03 -4.78184120e-03 -3.15130074e-03
- -1.84923989e-03 -8.13661243e-04  7.46984697e-06  6.56636616e-04
-  1.16805821e-03  1.56912044e-03  1.88168312e-03  2.12318726e-03]
-Beta values for Scikit-Learn Ridge implementation
-[ 8.38916861e-01  1.31276579e-01  8.97497404e-03 -1.72271878e-02
- -2.11744554e-02 -1.91492986e-02 -1.57201944e-02 -1.23002365e-02
- -9.30466214e-03 -6.81048318e-03 -4.78184120e-03 -3.15130074e-03
- -1.84923989e-03 -8.13661243e-04  7.46984697e-06  6.56636616e-04
-  1.16805821e-03  1.56912044e-03  1.88168312e-03  2.12318726e-03]
-MSE values for own Ridge implementation
-0.01507238889517716
-MSE values for Scikit-Learn Ridge implementation
-0.015072388895177083
-Beta values for own Ridge implementation
-[0.37396662 0.14174745 0.0764924  0.04892055 0.03447512 0.02586427
- 0.02024962 0.01633913 0.01347916 0.0113104  0.0096208  0.00827728
- 0.00719176 0.00630331 0.00556826 0.0049544  0.00443743 0.0039987
- 0.0036237  0.003301  ]
-Beta values for Scikit-Learn Ridge implementation
-[0.37396662 0.14174745 0.0764924  0.04892055 0.03447512 0.02586427
- 0.02024962 0.01633913 0.01347916 0.0113104  0.0096208  0.00827728
- 0.00719176 0.00630331 0.00556826 0.0049544  0.00443743 0.0039987
- 0.0036237  0.003301  ]
-MSE values for own Ridge implementation
-0.2640931530791003
-MSE values for Scikit-Learn Ridge implementation
-0.26409315307910036
-
-
-_images/chapter3_115_1.png -
-
-

The results here agree when we force Scikit-Learn’s Ridge function to include the first column in our design matrix. -We see that the results agree very well. Here we have thus explicitely included the intercept column in the design matrix. -What happens if we do not include the intercept in our fit? -Let us see how we can change this code by zero centering.

-
-
-
import numpy as np
-import pandas as pd
-import matplotlib.pyplot as plt
-from sklearn.model_selection import train_test_split
-from sklearn import linear_model
-from sklearn.preprocessing import StandardScaler
-
-def MSE(y_data,y_model):
-    n = np.size(y_model)
-    return np.sum((y_data-y_model)**2)/n
-# A seed just to ensure that the random numbers are the same for every run.
-# Useful for eventual debugging.
-np.random.seed(315)
-
-n = 100
-x = np.random.rand(n)
-y = np.exp(-x**2) + 1.5 * np.exp(-(x-2)**2)
-
-Maxpolydegree = 20
-X = np.zeros((n,Maxpolydegree-1))
-
-for degree in range(1,Maxpolydegree): #No intercept column
-    X[:,degree-1] = x**(degree)
-
-# We split the data in test and training data
-X_train, X_test, y_train, y_test = train_test_split(X, y, test_size=0.2)
-
-#For our own implementation, we will need to deal with the intercept by centering the design matrix and the target variable
-X_train_mean = np.mean(X_train,axis=0)
-#Center by removing mean from each feature
-X_train_scaled = X_train - X_train_mean 
-X_test_scaled = X_test - X_train_mean
-#The model intercept (called y_scaler) is given by the mean of the target variable (IF X is centered)
-#Remove the intercept from the training data.
-y_scaler = np.mean(y_train)           
-y_train_scaled = y_train - y_scaler   
-
-p = Maxpolydegree-1
-I = np.eye(p,p)
-# Decide which values of lambda to use
-nlambdas = 6
-MSEOwnRidgePredict = np.zeros(nlambdas)
-MSERidgePredict = np.zeros(nlambdas)
-
-lambdas = np.logspace(-4, 2, nlambdas)
-for i in range(nlambdas):
-    lmb = lambdas[i]
-    OwnRidgeBeta = np.linalg.pinv(X_train_scaled.T @ X_train_scaled+lmb*I) @ X_train_scaled.T @ (y_train_scaled)
-    intercept_ = y_scaler - X_train_mean@OwnRidgeBeta #The intercept can be shifted so the model can predict on uncentered data
-    #Add intercept to prediction
-    ypredictOwnRidge = X_test_scaled @ OwnRidgeBeta + y_scaler 
-    RegRidge = linear_model.Ridge(lmb)
-    RegRidge.fit(X_train,y_train)
-    ypredictRidge = RegRidge.predict(X_test)
-    MSEOwnRidgePredict[i] = MSE(y_test,ypredictOwnRidge)
-    MSERidgePredict[i] = MSE(y_test,ypredictRidge)
-    print("Beta values for own Ridge implementation")
-    print(OwnRidgeBeta) #Intercept is given by mean of target variable
-    print("Beta values for Scikit-Learn Ridge implementation")
-    print(RegRidge.coef_)
-    print('Intercept from own implementation:')
-    print(intercept_)
-    print('Intercept from Scikit-Learn Ridge implementation')
-    print(RegRidge.intercept_)
-    print("MSE values for own Ridge implementation")
-    print(MSEOwnRidgePredict[i])
-    print("MSE values for Scikit-Learn Ridge implementation")
-    print(MSERidgePredict[i])
-
-
-# Now plot the results
-plt.figure()
-plt.plot(np.log10(lambdas), MSEOwnRidgePredict, 'b--', label = 'MSE own Ridge Test')
-plt.plot(np.log10(lambdas), MSERidgePredict, 'g--', label = 'MSE SL Ridge Test')
-plt.xlabel('log10(lambda)')
-plt.ylabel('MSE')
-plt.legend()
-plt.show()
-
-
-
-
-
Beta values for own Ridge implementation
-[ 3.43579948e-02 -5.43330971e-01 -3.10141414e-03  2.47116868e-01
-  2.18613217e-01  1.02054837e-01 -4.25617662e-04 -5.90475506e-02
- -7.68534263e-02 -6.68929213e-02 -4.24906604e-02 -1.40927184e-02
-  1.11482289e-02  2.88529063e-02  3.67047975e-02  3.38135733e-02
-  2.02198702e-02 -3.46383924e-03 -3.63025821e-02]
-Beta values for Scikit-Learn Ridge implementation
-[ 3.43579948e-02 -5.43330971e-01 -3.10141413e-03  2.47116868e-01
-  2.18613217e-01  1.02054837e-01 -4.25617658e-04 -5.90475506e-02
- -7.68534263e-02 -6.68929213e-02 -4.24906604e-02 -1.40927184e-02
-  1.11482289e-02  2.88529063e-02  3.67047975e-02  3.38135733e-02
-  2.02198702e-02 -3.46383925e-03 -3.63025821e-02]
-Intercept from own implementation:
-1.0330308045181225
-Intercept from Scikit-Learn Ridge implementation
-1.033030804518383
-MSE values for own Ridge implementation
-3.139255958275475e-06
-MSE values for Scikit-Learn Ridge implementation
-3.139255958572018e-06
-Beta values for own Ridge implementation
-[-0.05807125 -0.29822833 -0.08551306  0.08156108  0.13679863  0.12333649
-  0.08251519  0.03815288  0.00111756 -0.02498832 -0.04010697 -0.04566964
- -0.04355837 -0.03562355 -0.02348765 -0.00848904  0.00831018  0.0260906
-  0.04423486]
-Beta values for Scikit-Learn Ridge implementation
-[-0.05807125 -0.29822833 -0.08551306  0.08156108  0.13679863  0.12333649
-  0.08251519  0.03815288  0.00111756 -0.02498832 -0.04010697 -0.04566964
- -0.04355837 -0.03562355 -0.02348765 -0.00848904  0.00831018  0.0260906
-  0.04423486]
-Intercept from own implementation:
-1.0411487294305548
-Intercept from Scikit-Learn Ridge implementation
-1.0411487294305266
-MSE values for own Ridge implementation
-1.9601304850163794e-05
-MSE values for Scikit-Learn Ridge implementation
-1.9601304850085328e-05
-Beta values for own Ridge implementation
-[-0.1416398  -0.14021063 -0.05383795  0.01367553  0.04784395  0.05796251
-  0.05447415  0.044613    0.03267527  0.02098261  0.01066519  0.00217499
- -0.00440346 -0.00917248 -0.01231917 -0.01405935 -0.0146081  -0.01416528
- -0.01290947]
-Beta values for Scikit-Learn Ridge implementation
-[-0.1416398  -0.14021063 -0.05383795  0.01367553  0.04784395  0.05796251
-  0.05447415  0.044613    0.03267527  0.02098261  0.01066519  0.00217499
- -0.00440346 -0.00917248 -0.01231917 -0.01405935 -0.0146081  -0.01416528
- -0.01290947]
-Intercept from own implementation:
-1.0495569966278282
-Intercept from Scikit-Learn Ridge implementation
-1.0495569966278269
-MSE values for own Ridge implementation
-5.4959161509370406e-05
-MSE values for Scikit-Learn Ridge implementation
-5.4959161509366834e-05
-Beta values for own Ridge implementation
-[-0.13535942 -0.08593216 -0.03568439 -0.0036367   0.01397146  0.02229529
-  0.02503753  0.0245528   0.02228115  0.01908936  0.01549377  0.01179792
-  0.00817631  0.00472512  0.00149311 -0.00149956 -0.00424967 -0.00676387
- -0.00905423]
-Beta values for Scikit-Learn Ridge implementation
-[-0.13535942 -0.08593216 -0.03568439 -0.0036367   0.01397146  0.02229529
-  0.02503753  0.0245528   0.02228115  0.01908936  0.01549377  0.01179792
-  0.00817631  0.00472512  0.00149311 -0.00149956 -0.00424967 -0.00676387
- -0.00905423]
-Intercept from own implementation:
-1.039967668952797
-Intercept from Scikit-Learn Ridge implementation
-1.0399676689527975
-MSE values for own Ridge implementation
-7.571105947979326e-05
-MSE values for Scikit-Learn Ridge implementation
-7.57110594797945e-05
-Beta values for own Ridge implementation
-[-0.05100875 -0.04063602 -0.02723445 -0.01713366 -0.0100706  -0.00517114
- -0.00174276  0.00068734  0.00243186  0.00369758  0.00462287  0.0053018
-  0.00579953  0.006162    0.00642221  0.00660427  0.00672607  0.0068011
-  0.00683964]
-Beta values for Scikit-Learn Ridge implementation
-[-0.05100875 -0.04063602 -0.02723445 -0.01713366 -0.0100706  -0.00517114
- -0.00174276  0.00068734  0.00243186  0.00369758  0.00462287  0.0053018
-  0.00579953  0.006162    0.00642221  0.00660427  0.00672607  0.0068011
-  0.00683964]
-Intercept from own implementation:
-0.999955585168597
-Intercept from Scikit-Learn Ridge implementation
-0.999955585168597
-MSE values for own Ridge implementation
-0.0007698473260556339
-MSE values for Scikit-Learn Ridge implementation
-0.000769847326055633
-Beta values for own Ridge implementation
-[-0.00834567 -0.00803064 -0.00673407 -0.00554552 -0.00458878 -0.0038335
- -0.00323332 -0.00274989 -0.0023548  -0.00202756 -0.00175331 -0.00152117
- -0.001323   -0.0011526  -0.00100519 -0.00087697 -0.00076495 -0.00066668
- -0.00058016]
-Beta values for Scikit-Learn Ridge implementation
-[-0.00834567 -0.00803064 -0.00673407 -0.00554552 -0.00458878 -0.0038335
- -0.00323332 -0.00274989 -0.0023548  -0.00202756 -0.00175331 -0.00152117
- -0.001323   -0.0011526  -0.00100519 -0.00087697 -0.00076495 -0.00066668
- -0.00058016]
-Intercept from own implementation:
-0.9637117593816477
-Intercept from Scikit-Learn Ridge implementation
-0.9637117593816477
-MSE values for own Ridge implementation
-0.0023813163025848865
-MSE values for Scikit-Learn Ridge implementation
-0.002381316302584886
-
-
-_images/chapter3_117_1.png -
-
-

We see here, when compared to the code which includes explicitely the -intercept column, that our MSE value is actually smaller. This is -because the regularization term does not include the intercept value -\(\beta_0\) in the fitting. This applies to Lasso regularization as -well. It means that our optimization is now done only with the -centered matrix and/or vector that enter the fitting procedure. Note -also that the problem with the intercept occurs mainly in these type -of polynomial fitting problem.

-

The next example is indeed an example where all these discussions about the role of intercept are not present.

-
-
-

5.7. More complicated Example: The Ising model

-

The one-dimensional Ising model with nearest neighbor interaction, no -external field and a constant coupling constant \(J\) is given by

- -
-
-\[ -\begin{equation} - H = -J \sum_{k}^L s_k s_{k + 1}, -\label{_auto1} \tag{1} -\end{equation} -\]
-

where \(s_i \in \{-1, 1\}\) and \(s_{N + 1} = s_1\). The number of spins -in the system is determined by \(L\). For the one-dimensional system -there is no phase transition.

-

We will look at a system of \(L = 40\) spins with a coupling constant of -\(J = 1\). To get enough training data we will generate 10000 states -with their respective energies.

-
-
-
import numpy as np
-import matplotlib.pyplot as plt
-from mpl_toolkits.axes_grid1 import make_axes_locatable
-import seaborn as sns
-import scipy.linalg as scl
-from sklearn.model_selection import train_test_split
-import tqdm
-sns.set(color_codes=True)
-cmap_args=dict(vmin=-1., vmax=1., cmap='seismic')
-
-L = 40
-n = int(1e4)
-
-spins = np.random.choice([-1, 1], size=(n, L))
-J = 1.0
-
-energies = np.zeros(n)
-
-for i in range(n):
-    energies[i] = - J * np.dot(spins[i], np.roll(spins[i], 1))
-
-
-
-
-

Here we use ordinary least squares -regression to predict the energy for the nearest neighbor -one-dimensional Ising model on a ring, i.e., the endpoints wrap -around. We will use linear regression to fit a value for -the coupling constant to achieve this.

-

A more general form for the one-dimensional Ising model is

- -
-
-\[ -\begin{equation} - H = - \sum_j^L \sum_k^L s_j s_k J_{jk}. -\label{_auto2} \tag{2} -\end{equation} -\]
-

Here we allow for interactions beyond the nearest neighbors and a state dependent -coupling constant. This latter expression can be formulated as -a matrix-product

- -
-
-\[ -\begin{equation} - \boldsymbol{H} = \boldsymbol{X} J, -\label{_auto3} \tag{3} -\end{equation} -\]
-

where \(X_{jk} = s_j s_k\) and \(J\) is a matrix which consists of the -elements \(-J_{jk}\). This form of writing the energy fits perfectly -with the form utilized in linear regression, that is

- -
-
-\[ -\begin{equation} - \boldsymbol{y} = \boldsymbol{X}\boldsymbol{\beta} + \boldsymbol{\epsilon}, -\label{_auto4} \tag{4} -\end{equation} -\]
-

We split the data in training and test data as discussed in the previous example

-
-
-
X = np.zeros((n, L ** 2))
-for i in range(n):
-    X[i] = np.outer(spins[i], spins[i]).ravel()
-y = energies
-X_train, X_test, y_train, y_test = train_test_split(X, y, test_size=0.2)
-
-
-
-
-

In the ordinary least squares method we choose the cost function

- -
-
-\[ -\begin{equation} - C(\boldsymbol{X}, \boldsymbol{\beta})= \frac{1}{n}\left\{(\boldsymbol{X}\boldsymbol{\beta} - \boldsymbol{y})^T(\boldsymbol{X}\boldsymbol{\beta} - \boldsymbol{y})\right\}. -\label{_auto5} \tag{5} -\end{equation} -\]
-

We then find the extremal point of \(C\) by taking the derivative with respect to \(\boldsymbol{\beta}\) as discussed above. -This yields the expression for \(\boldsymbol{\beta}\) to be

-
-\[ -\boldsymbol{\beta} = \frac{\boldsymbol{X}^T \boldsymbol{y}}{\boldsymbol{X}^T \boldsymbol{X}}, -\]
-

which immediately imposes some requirements on \(\boldsymbol{X}\) as there must exist -an inverse of \(\boldsymbol{X}^T \boldsymbol{X}\). If the expression we are modeling contains an -intercept, i.e., a constant term, we must make sure that the -first column of \(\boldsymbol{X}\) consists of \(1\). We do this here

-
-
-
X_train_own = np.concatenate(
-    (np.ones(len(X_train))[:, np.newaxis], X_train),
-    axis=1
-)
-X_test_own = np.concatenate(
-    (np.ones(len(X_test))[:, np.newaxis], X_test),
-    axis=1
-)
-
-
-
-
-

Doing the inversion directly turns out to be a bad idea since the matrix -\(\boldsymbol{X}^T\boldsymbol{X}\) is singular. An alternative approach is to use the singular -value decomposition. Using the definition of the Moore-Penrose -pseudoinverse we can write the equation for \(\boldsymbol{\beta}\) as

-
-\[ -\boldsymbol{\beta} = \boldsymbol{X}^{+}\boldsymbol{y}, -\]
-

where the pseudoinverse of \(\boldsymbol{X}\) is given by

-
-\[ -\boldsymbol{X}^{+} = \frac{\boldsymbol{X}^T}{\boldsymbol{X}^T\boldsymbol{X}}. -\]
-

Using singular value decomposition we can decompose the matrix \(\boldsymbol{X} = \boldsymbol{U}\boldsymbol{\Sigma} \boldsymbol{V}^T\), -where \(\boldsymbol{U}\) and \(\boldsymbol{V}\) are orthogonal(unitary) matrices and \(\boldsymbol{\Sigma}\) contains the singular values (more details below). -where \(X^{+} = V\Sigma^{+} U^T\). This reduces the equation for -\(\omega\) to

- -
-
-\[ -\begin{equation} - \boldsymbol{\beta} = \boldsymbol{V}\boldsymbol{\Sigma}^{+} \boldsymbol{U}^T \boldsymbol{y}. -\label{_auto6} \tag{6} -\end{equation} -\]
-

Note that solving this equation by actually doing the pseudoinverse -(which is what we will do) is not a good idea as this operation scales -as \(\mathcal{O}(n^3)\), where \(n\) is the number of elements in a -general matrix. Instead, doing \(QR\)-factorization and solving the -linear system as an equation would reduce this down to -\(\mathcal{O}(n^2)\) operations.

-
-
-
def ols_svd(x: np.ndarray, y: np.ndarray) -> np.ndarray:
-    u, s, v = scl.svd(x)
-    return v.T @ scl.pinv(scl.diagsvd(s, u.shape[0], v.shape[0])) @ u.T @ y
-
-
-
-
-
-
-
beta = ols_svd(X_train_own,y_train)
-
-
-
-
-

When extracting the \(J\)-matrix we need to make sure that we remove the intercept, as is done here

-
-
-
J = beta[1:].reshape(L, L)
-
-
-
-
-

A way of looking at the coefficients in \(J\) is to plot the matrices as images.

-
-
-
fig = plt.figure(figsize=(20, 14))
-im = plt.imshow(J, **cmap_args)
-plt.title("OLS", fontsize=18)
-plt.xticks(fontsize=18)
-plt.yticks(fontsize=18)
-cb = fig.colorbar(im)
-cb.ax.set_yticklabels(cb.ax.get_yticklabels(), fontsize=18)
-plt.show()
-
-
-
-
-
<ipython-input-20-6f7a6bd7d79f>:7: UserWarning: FixedFormatter should only be used together with FixedLocator
-  cb.ax.set_yticklabels(cb.ax.get_yticklabels(), fontsize=18)
-
-
-_images/chapter3_148_1.png -
-
-

It is interesting to note that OLS -considers both \(J_{j, j + 1} = -0.5\) and \(J_{j, j - 1} = -0.5\) as -valid matrix elements for \(J\). -In our discussion below on hyperparameters and Ridge and Lasso regression we will see that -this problem can be removed, partly and only with Lasso regression.

-

In this case our matrix inversion was actually possible. The obvious question now is what is the mathematics behind the SVD?

-

Let us now -focus on Ridge and Lasso regression as well. We repeat some of the -basic parts of the Ising model and the setup of the training and test -data. The one-dimensional Ising model with nearest neighbor -interaction, no external field and a constant coupling constant \(J\) is -given by

- -
-
-\[ -\begin{equation} - H = -J \sum_{k}^L s_k s_{k + 1}, -\label{_auto7} \tag{7} -\end{equation} -\]
-

where \(s_i \in \{-1, 1\}\) and \(s_{N + 1} = s_1\). The number of spins in the system is determined by \(L\). For the one-dimensional system there is no phase transition.

-

We will look at a system of \(L = 40\) spins with a coupling constant of \(J = 1\). To get enough training data we will generate 10000 states with their respective energies.

-
-
-
import numpy as np
-import matplotlib.pyplot as plt
-from mpl_toolkits.axes_grid1 import make_axes_locatable
-import seaborn as sns
-import scipy.linalg as scl
-from sklearn.model_selection import train_test_split
-import sklearn.linear_model as skl
-import tqdm
-sns.set(color_codes=True)
-cmap_args=dict(vmin=-1., vmax=1., cmap='seismic')
-
-L = 40
-n = int(1e4)
-
-spins = np.random.choice([-1, 1], size=(n, L))
-J = 1.0
-
-energies = np.zeros(n)
-
-for i in range(n):
-    energies[i] = - J * np.dot(spins[i], np.roll(spins[i], 1))
-
-
-
-
-

A more general form for the one-dimensional Ising model is

- -
-
-\[ -\begin{equation} - H = - \sum_j^L \sum_k^L s_j s_k J_{jk}. -\label{_auto8} \tag{8} -\end{equation} -\]
-

Here we allow for interactions beyond the nearest neighbors and a more -adaptive coupling matrix. This latter expression can be formulated as -a matrix-product on the form

- -
-
-\[ -\begin{equation} - H = X J, -\label{_auto9} \tag{9} -\end{equation} -\]
-

where \(X_{jk} = s_j s_k\) and \(J\) is the matrix consisting of the -elements \(-J_{jk}\). This form of writing the energy fits perfectly -with the form utilized in linear regression, viz.

- -
-
-\[ -\begin{equation} - \boldsymbol{y} = \boldsymbol{X}\boldsymbol{\beta} + \boldsymbol{\epsilon}. -\label{_auto10} \tag{10} -\end{equation} -\]
-

We organize the data as we did above

-
-
-
X = np.zeros((n, L ** 2))
-for i in range(n):
-    X[i] = np.outer(spins[i], spins[i]).ravel()
-y = energies
-X_train, X_test, y_train, y_test = train_test_split(X, y, test_size=0.96)
-
-X_train_own = np.concatenate(
-    (np.ones(len(X_train))[:, np.newaxis], X_train),
-    axis=1
-)
-
-X_test_own = np.concatenate(
-    (np.ones(len(X_test))[:, np.newaxis], X_test),
-    axis=1
-)
-
-
-
-
-

We will do all fitting with Scikit-Learn,

-
-
-
clf = skl.LinearRegression().fit(X_train, y_train)
-
-
-
-
-

When extracting the \(J\)-matrix we make sure to remove the intercept

-
-
-
J_sk = clf.coef_.reshape(L, L)
-
-
-
-
-

And then we plot the results

-
-
-
fig = plt.figure(figsize=(20, 14))
-im = plt.imshow(J_sk, **cmap_args)
-plt.title("LinearRegression from Scikit-learn", fontsize=18)
-plt.xticks(fontsize=18)
-plt.yticks(fontsize=18)
-cb = fig.colorbar(im)
-cb.ax.set_yticklabels(cb.ax.get_yticklabels(), fontsize=18)
-plt.show()
-
-
-
-
-
<ipython-input-25-5dd54edf2138>:7: UserWarning: FixedFormatter should only be used together with FixedLocator
-  cb.ax.set_yticklabels(cb.ax.get_yticklabels(), fontsize=18)
-
-
-_images/chapter3_166_1.png -
-
-

The results agree perfectly with our previous discussion where we used our own code.

-

Having explored the ordinary least squares we move on to ridge -regression. In ridge regression we include a regularizer. This -involves a new cost function which leads to a new estimate for the -weights \(\boldsymbol{\beta}\). This results in a penalized regression problem. The -cost function is given by

-

6 -0

-

< -< -< -! -! -M -A -T -H -_ -B -L -O -C -K

-
-
-
_lambda = 0.1
-clf_ridge = skl.Ridge(alpha=_lambda).fit(X_train, y_train)
-J_ridge_sk = clf_ridge.coef_.reshape(L, L)
-fig = plt.figure(figsize=(20, 14))
-im = plt.imshow(J_ridge_sk, **cmap_args)
-plt.title("Ridge from Scikit-learn", fontsize=18)
-plt.xticks(fontsize=18)
-plt.yticks(fontsize=18)
-cb = fig.colorbar(im)
-cb.ax.set_yticklabels(cb.ax.get_yticklabels(), fontsize=18)
-
-plt.show()
-
-
-
-
-
<ipython-input-26-fe5b9d300cc0>:10: UserWarning: FixedFormatter should only be used together with FixedLocator
-  cb.ax.set_yticklabels(cb.ax.get_yticklabels(), fontsize=18)
-
-
-_images/chapter3_169_1.png -
-
-

In the Least Absolute Shrinkage and Selection Operator (LASSO)-method we get a third cost function.

- -
-
-\[ -\begin{equation} - C(\boldsymbol{X}, \boldsymbol{\beta}; \lambda) = (\boldsymbol{X}\boldsymbol{\beta} - \boldsymbol{y})^T(\boldsymbol{X}\boldsymbol{\beta} - \boldsymbol{y}) + \lambda \sqrt{\boldsymbol{\beta}^T\boldsymbol{\beta}}. -\label{_auto12} \tag{12} -\end{equation} -\]
-

Finding the extremal point of this cost function is not so straight-forward as in least squares and ridge. We will therefore rely solely on the function Lasso from Scikit-Learn.

-
-
-
clf_lasso = skl.Lasso(alpha=_lambda).fit(X_train, y_train)
-J_lasso_sk = clf_lasso.coef_.reshape(L, L)
-fig = plt.figure(figsize=(20, 14))
-im = plt.imshow(J_lasso_sk, **cmap_args)
-plt.title("Lasso from Scikit-learn", fontsize=18)
-plt.xticks(fontsize=18)
-plt.yticks(fontsize=18)
-cb = fig.colorbar(im)
-cb.ax.set_yticklabels(cb.ax.get_yticklabels(), fontsize=18)
-
-plt.show()
-
-
-
-
-
<ipython-input-27-25845e8df859>:9: UserWarning: FixedFormatter should only be used together with FixedLocator
-  cb.ax.set_yticklabels(cb.ax.get_yticklabels(), fontsize=18)
-
-
-_images/chapter3_173_1.png -
-
-

It is quite striking how LASSO breaks the symmetry of the coupling -constant as opposed to ridge and OLS. We get a sparse solution with -\(J_{j, j + 1} = -1\).

-

We see how the different models perform for a different set of values for \(\lambda\).

-
-
-
lambdas = np.logspace(-4, 5, 10)
-
-train_errors = {
-    "ols_sk": np.zeros(lambdas.size),
-    "ridge_sk": np.zeros(lambdas.size),
-    "lasso_sk": np.zeros(lambdas.size)
-}
-
-test_errors = {
-    "ols_sk": np.zeros(lambdas.size),
-    "ridge_sk": np.zeros(lambdas.size),
-    "lasso_sk": np.zeros(lambdas.size)
-}
-
-plot_counter = 1
-
-fig = plt.figure(figsize=(32, 54))
-
-for i, _lambda in enumerate(tqdm.tqdm(lambdas)):
-    for key, method in zip(
-        ["ols_sk", "ridge_sk", "lasso_sk"],
-        [skl.LinearRegression(), skl.Ridge(alpha=_lambda), skl.Lasso(alpha=_lambda)]
-    ):
-        method = method.fit(X_train, y_train)
-
-        train_errors[key][i] = method.score(X_train, y_train)
-        test_errors[key][i] = method.score(X_test, y_test)
-
-        omega = method.coef_.reshape(L, L)
-
-        plt.subplot(10, 5, plot_counter)
-        plt.imshow(omega, **cmap_args)
-        plt.title(r"%s, $\lambda = %.4f$" % (key, _lambda))
-        plot_counter += 1
-
-plt.show()
-
-
-
-
-
  0%|          | 0/10 [00:00<?, ?it/s]
-
-
-
/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/linear_model/_coordinate_descent.py:529: ConvergenceWarning: Objective did not converge. You might want to increase the number of iterations. Duality gap: 3.924197515789051, tolerance: 1.796796
-  model = cd_fast.enet_coordinate_descent(
-
- 10%|█         | 1/10 [00:00<00:04,  2.02it/s]
-
-
-
 20%|██        | 2/10 [00:00<00:03,  2.36it/s]
-
-
-
 30%|███       | 3/10 [00:00<00:02,  2.91it/s]
-
-
-
 40%|████      | 4/10 [00:01<00:01,  3.60it/s]
-
-
-
 50%|█████     | 5/10 [00:01<00:01,  4.36it/s]
-
-
-
 60%|██████    | 6/10 [00:01<00:00,  4.87it/s]
-
-
-
 70%|███████   | 7/10 [00:01<00:00,  5.64it/s]
-
-
-
 80%|████████  | 8/10 [00:01<00:00,  6.31it/s]
-
-
-
 90%|█████████ | 9/10 [00:01<00:00,  6.88it/s]
-
-
-
100%|██████████| 10/10 [00:01<00:00,  7.10it/s]
-
-
-
100%|██████████| 10/10 [00:01<00:00,  5.64it/s]
-
-
-

-
-
-_images/chapter3_175_13.png -
-
-

We see that LASSO reaches a good solution for low -values of \(\lambda\), but will “wither” when we increase \(\lambda\) too -much. Ridge is more stable over a larger range of values for -\(\lambda\), but eventually also fades away.

-

To determine which value of \(\lambda\) is best we plot the accuracy of -the models when predicting the training and the testing set. We expect -the accuracy of the training set to be quite good, but if the accuracy -of the testing set is much lower this tells us that we might be -subject to an overfit model. The ideal scenario is an accuracy on the -testing set that is close to the accuracy of the training set.

-
-
-
fig = plt.figure(figsize=(20, 14))
-
-colors = {
-    "ols_sk": "r",
-    "ridge_sk": "y",
-    "lasso_sk": "c"
-}
-
-for key in train_errors:
-    plt.semilogx(
-        lambdas,
-        train_errors[key],
-        colors[key],
-        label="Train {0}".format(key),
-        linewidth=4.0
-    )
-
-for key in test_errors:
-    plt.semilogx(
-        lambdas,
-        test_errors[key],
-        colors[key] + "--",
-        label="Test {0}".format(key),
-        linewidth=4.0
-    )
-plt.legend(loc="best", fontsize=18)
-plt.xlabel(r"$\lambda$", fontsize=18)
-plt.ylabel(r"$R^2$", fontsize=18)
-plt.tick_params(labelsize=18)
-plt.show()
-
-
-
-
-_images/chapter3_177_0.png -
-
-

From the above figure we can see that LASSO with \(\lambda = 10^{-2}\) -achieves a very good accuracy on the test set. This by far surpasses the -other models for all values of \(\lambda\).

-
-
-

5.8. Exercises and Projects

-

The main aim of this project is to study in more detail various -regression methods, including the Ordinary Least Squares (OLS) method, -The total score is 100 points. Each subtask has its own final score.

-

We will first study how to fit polynomials to a specific -two-dimensional function called Franke’s -function. This -is a function which has been widely used when testing various -interpolation and fitting algorithms. Furthermore, after having -established the model and the method, we will employ resamling -techniques such as cross-validation and/or bootstrap in order to perform a -proper assessment of our models. We will also study in detail the -so-called Bias-Variance trade off.

-

The Franke function, which is a weighted sum of four exponentials reads as follows

-
-\[\begin{split} -\begin{align*} -f(x,y) &= \frac{3}{4}\exp{\left(-\frac{(9x-2)^2}{4} - \frac{(9y-2)^2}{4}\right)}+\frac{3}{4}\exp{\left(-\frac{(9x+1)^2}{49}- \frac{(9y+1)}{10}\right)} \\ -&+\frac{1}{2}\exp{\left(-\frac{(9x-7)^2}{4} - \frac{(9y-3)^2}{4}\right)} -\frac{1}{5}\exp{\left(-(9x-4)^2 - (9y-7)^2\right) }. -\end{align*} -\end{split}\]
-

The function will be defined for \(x,y\in [0,1]\). Our first step will -be to perform an OLS regression analysis of this function, trying out -a polynomial fit with an \(x\) and \(y\) dependence of the form \([x, y, -x^2, y^2, xy, \dots]\). We will also include bootstrap first as -a resampling technique. After that we will include the cross-validation technique. As in homeworks 1 and 2, we can use a uniform -distribution to set up the arrays of values for \(x\) and \(y\), or as in -the example below just a set of fixed -values for \(x\) and \(y\) with a given step -size. We will fit a -function (for example a polynomial) of \(x\) and \(y\). Thereafter we -will repeat much of the same procedure using the Ridge and Lasso -regression methods, introducing thus a dependence on the bias -(penalty) \(\lambda\).

-

Finally we are going to use (real) digital terrain data and try to -reproduce these data using the same methods. We will also try to go -beyond the second-order polynomials metioned above and explore -which polynomial fits the data best.

-

The Python code for the Franke function is included here (it performs also a three-dimensional plot of it)

-
-
-
from mpl_toolkits.mplot3d import Axes3D
-import matplotlib.pyplot as plt
-from matplotlib import cm
-from matplotlib.ticker import LinearLocator, FormatStrFormatter
-import numpy as np
-from random import random, seed
-
-fig = plt.figure()
-ax = fig.gca(projection='3d')
-
-# Make data.
-x = np.arange(0, 1, 0.05)
-y = np.arange(0, 1, 0.05)
-x, y = np.meshgrid(x,y)
-
-
-def FrankeFunction(x,y):
-    term1 = 0.75*np.exp(-(0.25*(9*x-2)**2) - 0.25*((9*y-2)**2))
-    term2 = 0.75*np.exp(-((9*x+1)**2)/49.0 - 0.1*(9*y+1))
-    term3 = 0.5*np.exp(-(9*x-7)**2/4.0 - 0.25*((9*y-3)**2))
-    term4 = -0.2*np.exp(-(9*x-4)**2 - (9*y-7)**2)
-    return term1 + term2 + term3 + term4
-
-
-z = FrankeFunction(x, y)
-
-# Plot the surface.
-surf = ax.plot_surface(x, y, z, cmap=cm.coolwarm,
-                       linewidth=0, antialiased=False)
-
-# Customize the z axis.
-ax.set_zlim(-0.10, 1.40)
-ax.zaxis.set_major_locator(LinearLocator(10))
-ax.zaxis.set_major_formatter(FormatStrFormatter('%.02f'))
-
-# Add a color bar which maps values to colors.
-fig.colorbar(surf, shrink=0.5, aspect=5)
-
-plt.show()
-
-
-
-
-_images/chapter3_181_0.png -
-
-
-

5.8.1. Exercise: Ordinary Least Square (OLS) on the Franke function

-

We will generate our own dataset for a function -\(\mathrm{FrankeFunction}(x,y)\) with \(x,y \in [0,1]\). The function -\(f(x,y)\) is the Franke function. You should explore also the addition -of an added stochastic noise to this function using the normal -distribution \(N(0,1)\).

-

Write your own code (using either a matrix inversion or a singular -value decomposition from e.g., numpy ) or use your code from -homeworks 1 and 2 and perform a standard least square regression -analysis using polynomials in \(x\) and \(y\) up to fifth order. Find the -confidence intervals of the parameters (estimators) \(\beta\) by computing their -variances, evaluate the Mean Squared error (MSE)

-
-\[ -MSE(\hat{y},\hat{\tilde{y}}) = \frac{1}{n} -\sum_{i=0}^{n-1}(y_i-\tilde{y}_i)^2, -\]
-

and the \(R^2\) score function. If \(\tilde{\hat{y}}_i\) is the predicted -value of the \(i-th\) sample and \(y_i\) is the corresponding true value, -then the score \(R^2\) is defined as

-
-\[ -R^2(\hat{y}, \tilde{\hat{y}}) = 1 - \frac{\sum_{i=0}^{n - 1} (y_i - \tilde{y}_i)^2}{\sum_{i=0}^{n - 1} (y_i - \bar{y})^2}, -\]
-

where we have defined the mean value of \(\hat{y}\) as

-
-\[ -\bar{y} = \frac{1}{n} \sum_{i=0}^{n - 1} y_i. -\]
-

Your code has to include a scaling of the data (for example by -subtracting the mean value), and -a split of the data in training and test data. For this exercise you can -either write your own code or use for example the function for -splitting training data provided by the library Scikit-Learn (make -sure you have installed it). This function is called -\(train\_test\_split\). You should present a critical discussion of why and how you have scaled or not scaled the data.

-

It is normal in essentially all Machine Learning studies to split the -data in a training set and a test set (eventually also an additional -validation set). There -is no explicit recipe for how much data should be included as training -data and say test data. An accepted rule of thumb is to use -approximately \(2/3\) to \(4/5\) of the data as training data.

-

You can easily reuse the solutions to your exercises from week 35 and week 36.

-
-
-

5.8.2. Exercise: Bias-variance trade-off and resampling techniques

-

Our aim here is to study the bias-variance trade-off by implementing the bootstrap resampling technique.

-

With a code which does OLS and includes resampling techniques, -we will now discuss the bias-variance trade-off in the context of -continuous predictions such as regression. However, many of the -intuitions and ideas discussed here also carry over to classification -tasks and basically all Machine Learning algorithms.

-

Before you perform an analysis of the bias-variance trade-off on your test data, make -first a figure similar to Fig. 2.11 of Hastie, Tibshirani, and -Friedman. Figure 2.11 of this reference displays only the test and training MSEs. The test MSE can be used to -indicate possible regions of low/high bias and variance. You will most likely not get an -equally smooth curve!

-

With this result we move on to the bias-variance trade-off analysis.

-

Consider a -dataset \(\mathcal{L}\) consisting of the data -\(\mathbf{X}_\mathcal{L}=\{(y_j, \boldsymbol{x}_j), j=0\ldots n-1\}\).

-

Let us assume that the true data is generated from a noisy model

-
-\[ -\boldsymbol{y}=f(\boldsymbol{x}) + \boldsymbol{\epsilon}. -\]
-

Here \(\epsilon\) is normally distributed with mean zero and standard -deviation \(\sigma^2\).

-

In our derivation of the ordinary least squares method we defined then -an approximation to the function \(f\) in terms of the parameters -\(\boldsymbol{\beta}\) and the design matrix \(\boldsymbol{X}\) which embody our model, -that is \(\boldsymbol{\tilde{y}}=\boldsymbol{X}\boldsymbol{\beta}\).

-

The parameters \(\boldsymbol{\beta}\) are in turn found by optimizing the means -squared error via the so-called cost function

-
-\[ -C(\boldsymbol{X},\boldsymbol{\beta}) =\frac{1}{n}\sum_{i=0}^{n-1}(y_i-\tilde{y}_i)^2=\mathbb{E}\left[(\boldsymbol{y}-\boldsymbol{\tilde{y}})^2\right]. -\]
-

Here the expected value \(\mathbb{E}\) is the sample value.

-

Show that you can rewrite this as

-
-\[ -\mathbb{E}\left[(\boldsymbol{y}-\boldsymbol{\tilde{y}})^2\right]=\frac{1}{n}\sum_i(f_i-\mathbb{E}\left[\boldsymbol{\tilde{y}}\right])^2+\frac{1}{n}\sum_i(\tilde{y}_i-\mathbb{E}\left[\boldsymbol{\tilde{y}}\right])^2+\sigma^2. -\]
-

Explain what the terms mean, which one is the bias and which one is -the variance and discuss their interpretations.

-

Perform then a bias-variance analysis of the Franke function by -studying the MSE value as function of the complexity of your model.

-

Discuss the bias and variance trade-off as function -of your model complexity (the degree of the polynomial) and the number -of data points, and possibly also your training and test data using the bootstrap resampling method.

-

Note also that when you calculate the bias, in all applications you don’t know the function values \(f_i\). You would hence replace them with the actual data points \(y_i\).

-
-
-

5.8.3. Exercise: Cross-validation as resampling techniques, adding more complexity

-

The aim here is to write your own code for another widely popular -resampling technique, the so-called cross-validation method. Again, -before you start with cross-validation approach, you should scale your -data.

-

Implement the \(k\)-fold cross-validation algorithm (write your own -code) and evaluate again the MSE function resulting -from the test folds. You can compare your own code with that from -Scikit-Learn if needed.

-

Compare the MSE you get from your cross-validation code with the one -you got from your bootstrap code. Comment your results. Try \(5-10\) -folds. You can also compare your own cross-validation code with the -one provided by Scikit-Learn.

-
-
-

5.8.4. Exercise: Ridge Regression on the Franke function with resampling

-

Write your own code for the Ridge method, either using matrix -inversion or the singular value decomposition as done in the previous -exercise. Perform the same bootstrap analysis as in the -Exercise 2 (for the same polynomials) and the cross-validation in exercise 3 but now for different values of \(\lambda\). Compare and -analyze your results with those obtained in exercises 1-3. Study the -dependence on \(\lambda\).

-

Study also the bias-variance trade-off as function of various values of -the parameter \(\lambda\). For the bias-variance trade-off, use the bootstrap resampling method. Comment your results.

-
-
-

5.8.5. Exercise: Lasso Regression on the Franke function with resampling

-

This exercise is essentially a repeat of the previous two ones, but now -with Lasso regression. Write either your own code (difficult and optional) or, in this case, -you can also use the functionalities of Scikit-Learn (recommended). -Give a -critical discussion of the three methods and a judgement of which -model fits the data best. Perform here as well an analysis of the bias-variance trade-off using the bootstrap resampling technique and an analysis of the mean squared error using cross-validation.

-
-
-

5.8.6. Exercise: Analysis of real data

-

With our codes functioning and having been tested properly on a -simpler function we are now ready to look at real data. We will -essentially repeat in this exercise what was done in exercises 1-5. However, we -need first to download the data and prepare properly the inputs to our -codes. We are going to download digital terrain data from the website -https://earthexplorer.usgs.gov/,

-

Or, if you prefer, we have placed selected datafiles at https://github.com/CompPhysics/MachineLearning/tree/master/doc/Projects/2021/Project1/DataFiles

-

In order to obtain data for a specific region, you need to register as -a user (free) at this website and then decide upon which area you want -to fetch the digital terrain data from. In order to be able to read -the data properly, you need to specify that the format should be SRTM -Arc-Second Global and download the data as a GeoTIF file. The -files are then stored in tif format which can be imported into a -Python program using

-
-
-
scipy.misc.imread
-
-
-
-
-
---------------------------------------------------------------------------
-NameError                                 Traceback (most recent call last)
-<ipython-input-31-d985fb40c43d> in <module>
-----> 1 scipy.misc.imread
-
-NameError: name 'scipy' is not defined
-
-
-
-
-

Here is a simple part of a Python code which reads and plots the data -from such files

-
-
-
"""
-import numpy as np
-from imageio import imread
-import matplotlib.pyplot as plt
-from mpl_toolkits.mplot3d import Axes3D
-from matplotlib import cm
-
-# Load the terrain
-terrain1 = imread('SRTM_data_Norway_1.tif')
-# Show the terrain
-plt.figure()
-plt.title('Terrain over Norway 1')
-plt.imshow(terrain1, cmap='gray')
-plt.xlabel('X')
-plt.ylabel('Y')
-plt.show()
-"""
-
-
-
-
-

If you should have problems in downloading the digital terrain data, -we provide two examples under the data folder of project 1. One is -from a region close to Stavanger in Norway and the other Møsvatn -Austfjell, again in Norway. -Feel free to produce your own terrain data.

-

Alternatively, if you would like to use another data set, feel free to do so. This could be data close to your reseach area or simply a data set you found interesting. See for example kaggle.com for examples.

-

Our final part deals with the parameterization of your digital terrain -data (or your own data). We will apply all three methods for linear regression, the same type (or higher order) of polynomial -approximation and cross-validation as resampling technique to evaluate which -model fits the data best.

-

At the end, you should present a critical evaluation of your results -and discuss the applicability of these regression methods to the type -of data presented here (either the terrain data we propose or other data sets).

-
-
-
- - - - -
- - - - -
-
-
-
-

- - By Morten Hjorth-Jensen
- - © Copyright 2021.
-

-
-
-
- - -
-
- - - - - - \ No newline at end of file diff --git a/doc/LectureNotes/_build/html/chapter4.html b/doc/LectureNotes/_build/html/chapter4.html deleted file mode 100644 index 9e92a9cf1..000000000 --- a/doc/LectureNotes/_build/html/chapter4.html +++ /dev/null @@ -1,1101 +0,0 @@ - - - - - - - - 6. Logistic Regression — Applied Data Analysis and Machine Learning - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
- - - - - - - - -
- - -
-
- -
- -
-

6. Logistic Regression

-
-

6.1. Logistic Regression

-

In linear regression our main interest was centered on learning the -coefficients of a functional fit (say a polynomial) in order to be -able to predict the response of a continuous variable on some unseen -data. The fit to the continuous variable \(y_i\) is based on some -independent variables \(x_i\). Linear regression resulted in -analytical expressions for standard ordinary Least Squares or Ridge -regression (in terms of matrices to invert) for several quantities, -ranging from the variance and thereby the confidence intervals of the -optimal parameters \(\hat{\beta}\) to the mean squared error. If we can invert -the product of the design matrices, linear regression gives then a -simple recipe for fitting our data.

-

Classification problems, however, are concerned with outcomes taking -the form of discrete variables (i.e. categories). We may for example, -on the basis of DNA sequencing for a number of patients, like to find -out which mutations are important for a certain disease; or based on -scans of various patients’ brains, figure out if there is a tumor or -not; or given a specific physical system, we’d like to identify its -state, say whether it is an ordered or disordered system (typical -situation in solid state physics); or classify the status of a -patient, whether she/he has a stroke or not and many other similar -situations.

-

The most common situation we encounter when we apply logistic -regression is that of two possible outcomes, normally denoted as a -binary outcome, true or false, positive or negative, success or -failure etc.

-

Logistic regression will also serve as our stepping stone towards -neural network algorithms and supervised deep learning. For logistic -learning, the minimization of the cost function leads to a non-linear -equation in the parameters \(\hat{\beta}\). The optimization of the -problem calls therefore for minimization algorithms. This forms the -bottle neck of all machine learning algorithms, namely how to find -reliable minima of a multi-variable function. This leads us to the -family of gradient descent methods. The latter are the working horses -of basically all modern machine learning algorithms.

-

We note also that many of the topics discussed here on logistic -regression are also commonly used in modern supervised Deep Learning -models, as we will see later.

-
-
-

6.2. Basics

-

We consider the case where the dependent variables, also called the -responses or the outcomes, \(y_i\) are discrete and only take values -from \(k=0,\dots,K-1\) (i.e. \(K\) classes).

-

The goal is to predict the -output classes from the design matrix \(\boldsymbol{X}\in\mathbb{R}^{n\times p}\) -made of \(n\) samples, each of which carries \(p\) features or predictors. The -primary goal is to identify the classes to which new unseen samples -belong.

-

Let us specialize to the case of two classes only, with outputs -\(y_i=0\) and \(y_i=1\). Our outcomes could represent the status of a -credit card user that could default or not on her/his credit card -debt. That is

-
-\[\begin{split} -y_i = \begin{bmatrix} 0 & \mathrm{no}\\ 1 & \mathrm{yes} \end{bmatrix}. -\end{split}\]
-

Before moving to the logistic model, let us try to use our linear -regression model to classify these two outcomes. We could for example -fit a linear model to the default case if \(y_i > 0.5\) and the no -default case \(y_i \leq 0.5\).

-

We would then have our -weighted linear combination, namely

- -
-
-\[ -\begin{equation} -\boldsymbol{y} = \boldsymbol{X}^T\boldsymbol{\beta} + \boldsymbol{\epsilon}, -\label{_auto1} \tag{1} -\end{equation} -\]
-

where \(\boldsymbol{y}\) is a vector representing the possible outcomes, \(\boldsymbol{X}\) is our -\(n\times p\) design matrix and \(\boldsymbol{\beta}\) represents our estimators/predictors.

-

The main problem with our function is that it takes values on the -entire real axis. In the case of logistic regression, however, the -labels \(y_i\) are discrete variables. A typical example is the credit -card data discussed below here, where we can set the state of -defaulting the debt to \(y_i=1\) and not to \(y_i=0\) for one the persons -in the data set (see the full example below).

-

One simple way to get a discrete output is to have sign -functions that map the output of a linear regressor to values \(\{0,1\}\), -\(f(s_i)=sign(s_i)=1\) if \(s_i\ge 0\) and 0 if otherwise. -We will encounter this model in our first demonstration of neural networks. Historically it is called the perceptron" model in the machine learning literature. This model is extremely simple. However, in many cases it is more favorable to use a soft” classifier that outputs -the probability of a given category. This leads us to the logistic function.

-

The following example on data for coronary heart disease (CHD) as function of age may serve as an illustration. In the code here we read and plot whether a person has had CHD (output = 1) or not (output = 0). This ouput is plotted the person’s against age. Clearly, the figure shows that attempting to make a standard linear regression fit may not be very meaningful.

-
-
-
%matplotlib inline
-
-# Common imports
-import os
-import numpy as np
-import pandas as pd
-import matplotlib.pyplot as plt
-from sklearn.linear_model import LinearRegression, Ridge, Lasso
-from sklearn.model_selection import train_test_split
-from sklearn.utils import resample
-from sklearn.metrics import mean_squared_error
-from IPython.display import display
-from pylab import plt, mpl
-plt.style.use('seaborn')
-mpl.rcParams['font.family'] = 'serif'
-
-# Where to save the figures and data files
-PROJECT_ROOT_DIR = "Results"
-FIGURE_ID = "Results/FigureFiles"
-DATA_ID = "DataFiles/"
-
-if not os.path.exists(PROJECT_ROOT_DIR):
-    os.mkdir(PROJECT_ROOT_DIR)
-
-if not os.path.exists(FIGURE_ID):
-    os.makedirs(FIGURE_ID)
-
-if not os.path.exists(DATA_ID):
-    os.makedirs(DATA_ID)
-
-def image_path(fig_id):
-    return os.path.join(FIGURE_ID, fig_id)
-
-def data_path(dat_id):
-    return os.path.join(DATA_ID, dat_id)
-
-def save_fig(fig_id):
-    plt.savefig(image_path(fig_id) + ".png", format='png')
-
-infile = open(data_path("chddata.csv"),'r')
-
-# Read the chd data as  csv file and organize the data into arrays with age group, age, and chd
-chd = pd.read_csv(infile, names=('ID', 'Age', 'Agegroup', 'CHD'))
-chd.columns = ['ID', 'Age', 'Agegroup', 'CHD']
-output = chd['CHD']
-age = chd['Age']
-agegroup = chd['Agegroup']
-numberID  = chd['ID'] 
-display(chd)
-
-plt.scatter(age, output, marker='o')
-plt.axis([18,70.0,-0.1, 1.2])
-plt.xlabel(r'Age')
-plt.ylabel(r'CHD')
-plt.title(r'Age distribution and Coronary heart disease')
-plt.show()
-
-
-
-
-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
IDAgeAgegroupCHD
012110
122310
232511
342910
452110
...............
95966181
96976981
97986581
98996481
991006380
-

100 rows × 4 columns

-
_images/chapter4_5_1.png -
-
-

What we could attempt however is to plot the mean value for each group.

-
-
-
agegroupmean = np.array([0.1, 0.133, 0.250, 0.333, 0.462, 0.625, 0.765, 0.800])
-group = np.array([1, 2, 3, 4, 5, 6, 7, 8])
-plt.plot(group, agegroupmean, "r-")
-plt.axis([0,9,0, 1.0])
-plt.xlabel(r'Age group')
-plt.ylabel(r'CHD mean values')
-plt.title(r'Mean values for each age group')
-plt.show()
-
-
-
-
-_images/chapter4_7_0.png -
-
-

We are now trying to find a function \(f(y\vert x)\), that is a function which gives us an expected value for the output \(y\) with a given input \(x\). -In standard linear regression with a linear dependence on \(x\), we would write this in terms of our model

-
-\[ -f(y_i\vert x_i)=\beta_0+\beta_1 x_i. -\]
-

This expression implies however that \(f(y_i\vert x_i)\) could take any -value from minus infinity to plus infinity. If we however let -\(f(y\vert y)\) be represented by the mean value, the above example -shows us that we can constrain the function to take values between -zero and one, that is we have \(0 \le f(y_i\vert x_i) \le 1\). Looking -at our last curve we see also that it has an S-shaped form. This leads -us to a very popular model for the function \(f\), namely the so-called -Sigmoid function or logistic model. We will consider this function as -representing the probability for finding a value of \(y_i\) with a given -\(x_i\).

-
-
-

6.3. The logistic function

-

Another widely studied model, is the so-called -perceptron model, which is an example of a “hard classification” model. We -will encounter this model when we discuss neural networks as -well. Each datapoint is deterministically assigned to a category (i.e -\(y_i=0\) or \(y_i=1\)). In many cases, and the coronary heart disease data forms one of many such examples, it is favorable to have a “soft” -classifier that outputs the probability of a given category rather -than a single value. For example, given \(x_i\), the classifier -outputs the probability of being in a category \(k\). Logistic regression -is the most common example of a so-called soft classifier. In logistic -regression, the probability that a data point \(x_i\) -belongs to a category \(y_i=\{0,1\}\) is given by the so-called logit function (or Sigmoid) which is meant to represent the likelihood for a given event,

-
-\[ -p(t) = \frac{1}{1+\mathrm \exp{-t}}=\frac{\exp{t}}{1+\mathrm \exp{t}}. -\]
-

Note that \(1-p(t)= p(-t)\).

-
-
-

6.4. Examples of likelihood functions used in logistic regression and nueral networks

-

The following code plots the logistic function, the step function and other functions we will encounter from here and on.

-
-
-
"""The sigmoid function (or the logistic curve) is a
-function that takes any real number, z, and outputs a number (0,1).
-It is useful in neural networks for assigning weights on a relative scale.
-The value z is the weighted sum of parameters involved in the learning algorithm."""
-
-import numpy
-import matplotlib.pyplot as plt
-import math as mt
-
-z = numpy.arange(-5, 5, .1)
-sigma_fn = numpy.vectorize(lambda z: 1/(1+numpy.exp(-z)))
-sigma = sigma_fn(z)
-
-fig = plt.figure()
-ax = fig.add_subplot(111)
-ax.plot(z, sigma)
-ax.set_ylim([-0.1, 1.1])
-ax.set_xlim([-5,5])
-ax.grid(True)
-ax.set_xlabel('z')
-ax.set_title('sigmoid function')
-
-plt.show()
-
-"""Step Function"""
-z = numpy.arange(-5, 5, .02)
-step_fn = numpy.vectorize(lambda z: 1.0 if z >= 0.0 else 0.0)
-step = step_fn(z)
-
-fig = plt.figure()
-ax = fig.add_subplot(111)
-ax.plot(z, step)
-ax.set_ylim([-0.5, 1.5])
-ax.set_xlim([-5,5])
-ax.grid(True)
-ax.set_xlabel('z')
-ax.set_title('step function')
-
-plt.show()
-
-"""tanh Function"""
-z = numpy.arange(-2*mt.pi, 2*mt.pi, 0.1)
-t = numpy.tanh(z)
-
-fig = plt.figure()
-ax = fig.add_subplot(111)
-ax.plot(z, t)
-ax.set_ylim([-1.0, 1.0])
-ax.set_xlim([-2*mt.pi,2*mt.pi])
-ax.grid(True)
-ax.set_xlabel('z')
-ax.set_title('tanh function')
-
-plt.show()
-
-
-
-
-_images/chapter4_13_0.png -_images/chapter4_13_1.png -_images/chapter4_13_2.png -
-
-

We assume now that we have two classes with \(y_i\) either \(0\) or \(1\). Furthermore we assume also that we have only two parameters \(\beta\) in our fitting of the Sigmoid function, that is we define probabilities

-
-\[\begin{split} -\begin{align*} -p(y_i=1|x_i,\boldsymbol{\beta}) &= \frac{\exp{(\beta_0+\beta_1x_i)}}{1+\exp{(\beta_0+\beta_1x_i)}},\nonumber\\ -p(y_i=0|x_i,\boldsymbol{\beta}) &= 1 - p(y_i=1|x_i,\boldsymbol{\beta}), -\end{align*} -\end{split}\]
-

where \(\boldsymbol{\beta}\) are the weights we wish to extract from data, in our case \(\beta_0\) and \(\beta_1\).

-

Note that we used

-
-\[ -p(y_i=0\vert x_i, \boldsymbol{\beta}) = 1-p(y_i=1\vert x_i, \boldsymbol{\beta}). -\]
-

In order to define the total likelihood for all possible outcomes from a
-dataset \(\mathcal{D}=\{(y_i,x_i)\}\), with the binary labels -\(y_i\in\{0,1\}\) and where the data points are drawn independently, we use the so-called Maximum Likelihood Estimation (MLE) principle. -We aim thus at maximizing -the probability of seeing the observed data. We can then approximate the -likelihood in terms of the product of the individual probabilities of a specific outcome \(y_i\), that is

-
-\[\begin{split} -\begin{align*} -P(\mathcal{D}|\boldsymbol{\beta})& = \prod_{i=1}^n \left[p(y_i=1|x_i,\boldsymbol{\beta})\right]^{y_i}\left[1-p(y_i=1|x_i,\boldsymbol{\beta}))\right]^{1-y_i}\nonumber \\ -\end{align*} -\end{split}\]
-

from which we obtain the log-likelihood and our cost/loss function

-
-\[ -\mathcal{C}(\boldsymbol{\beta}) = \sum_{i=1}^n \left( y_i\log{p(y_i=1|x_i,\boldsymbol{\beta})} + (1-y_i)\log\left[1-p(y_i=1|x_i,\boldsymbol{\beta}))\right]\right). -\]
-

Reordering the logarithms, we can rewrite the cost/loss function as

-
-\[ -\mathcal{C}(\boldsymbol{\beta}) = \sum_{i=1}^n \left(y_i(\beta_0+\beta_1x_i) -\log{(1+\exp{(\beta_0+\beta_1x_i)})}\right). -\]
-

The maximum likelihood estimator is defined as the set of parameters that maximize the log-likelihood where we maximize with respect to \(\beta\). -Since the cost (error) function is just the negative log-likelihood, for logistic regression we have that

-
-\[ -\mathcal{C}(\boldsymbol{\beta})=-\sum_{i=1}^n \left(y_i(\beta_0+\beta_1x_i) -\log{(1+\exp{(\beta_0+\beta_1x_i)})}\right). -\]
-

This equation is known in statistics as the cross entropy. Finally, we note that just as in linear regression, -in practice we often supplement the cross-entropy with additional regularization terms, usually \(L_1\) and \(L_2\) regularization as we did for Ridge and Lasso regression.

-

The cross entropy is a convex function of the weights \(\boldsymbol{\beta}\) and, -therefore, any local minimizer is a global minimizer.

-

Minimizing this -cost function with respect to the two parameters \(\beta_0\) and \(\beta_1\) we obtain

-
-\[ -\frac{\partial \mathcal{C}(\boldsymbol{\beta})}{\partial \beta_0} = -\sum_{i=1}^n \left(y_i -\frac{\exp{(\beta_0+\beta_1x_i)}}{1+\exp{(\beta_0+\beta_1x_i)}}\right), -\]
-

and

-
-\[ -\frac{\partial \mathcal{C}(\boldsymbol{\beta})}{\partial \beta_1} = -\sum_{i=1}^n \left(y_ix_i -x_i\frac{\exp{(\beta_0+\beta_1x_i)}}{1+\exp{(\beta_0+\beta_1x_i)}}\right). -\]
-

Let us now define a vector \(\boldsymbol{y}\) with \(n\) elements \(y_i\), an -\(n\times p\) matrix \(\boldsymbol{X}\) which contains the \(x_i\) values and a -vector \(\boldsymbol{p}\) of fitted probabilities \(p(y_i\vert x_i,\boldsymbol{\beta})\). We can rewrite in a more compact form the first -derivative of cost function as

-
-\[ -\frac{\partial \mathcal{C}(\boldsymbol{\beta})}{\partial \boldsymbol{\beta}} = -\boldsymbol{X}^T\left(\boldsymbol{y}-\boldsymbol{p}\right). -\]
-

If we in addition define a diagonal matrix \(\boldsymbol{W}\) with elements -\(p(y_i\vert x_i,\boldsymbol{\beta})(1-p(y_i\vert x_i,\boldsymbol{\beta})\), we can obtain a compact expression of the second derivative as

-
-\[ -\frac{\partial^2 \mathcal{C}(\boldsymbol{\beta})}{\partial \boldsymbol{\beta}\partial \boldsymbol{\beta}^T} = \boldsymbol{X}^T\boldsymbol{W}\boldsymbol{X}. -\]
-

Within a binary classification problem, we can easily expand our model to include multiple predictors. Our ratio between likelihoods is then with \(p\) predictors

-
-\[ -\log{ \frac{p(\boldsymbol{\beta}\boldsymbol{x})}{1-p(\boldsymbol{\beta}\boldsymbol{x})}} = \beta_0+\beta_1x_1+\beta_2x_2+\dots+\beta_px_p. -\]
-

Here we defined \(\boldsymbol{x}=[1,x_1,x_2,\dots,x_p]\) and \(\boldsymbol{\beta}=[\beta_0, \beta_1, \dots, \beta_p]\) leading to

-
-\[ -p(\boldsymbol{\beta}\boldsymbol{x})=\frac{ \exp{(\beta_0+\beta_1x_1+\beta_2x_2+\dots+\beta_px_p)}}{1+\exp{(\beta_0+\beta_1x_1+\beta_2x_2+\dots+\beta_px_p)}}. -\]
-

Till now we have mainly focused on two classes, the so-called binary -system. Suppose we wish to extend to \(K\) classes. Let us for the sake -of simplicity assume we have only two predictors. We have then following model

-
-\[ -\log{\frac{p(C=1\vert x)}{p(K\vert x)}} = \beta_{10}+\beta_{11}x_1, -\]
-

and

-
-\[ -\log{\frac{p(C=2\vert x)}{p(K\vert x)}} = \beta_{20}+\beta_{21}x_1, -\]
-

and so on till the class \(C=K-1\) class

-
-\[ -\log{\frac{p(C=K-1\vert x)}{p(K\vert x)}} = \beta_{(K-1)0}+\beta_{(K-1)1}x_1, -\]
-

and the model is specified in term of \(K-1\) so-called log-odds or -logit transformations.

-

In our discussion of neural networks we will encounter the above again -in terms of a slightly modified function, the so-called Softmax function.

-

The softmax function is used in various multiclass classification -methods, such as multinomial logistic regression (also known as -softmax regression), multiclass linear discriminant analysis, naive -Bayes classifiers, and artificial neural networks. Specifically, in -multinomial logistic regression and linear discriminant analysis, the -input to the function is the result of \(K\) distinct linear functions, -and the predicted probability for the \(k\)-th class given a sample -vector \(\boldsymbol{x}\) and a weighting vector \(\boldsymbol{\beta}\) is (with two -predictors):

-
-\[ -p(C=k\vert \mathbf {x} )=\frac{\exp{(\beta_{k0}+\beta_{k1}x_1)}}{1+\sum_{l=1}^{K-1}\exp{(\beta_{l0}+\beta_{l1}x_1)}}. -\]
-

It is easy to extend to more predictors. The final class is

-
-\[ -p(C=K\vert \mathbf {x} )=\frac{1}{1+\sum_{l=1}^{K-1}\exp{(\beta_{l0}+\beta_{l1}x_1)}}, -\]
-

and they sum to one. Our earlier discussions were all specialized to -the case with two classes only. It is easy to see from the above that -what we derived earlier is compatible with these equations.

-

To find the optimal parameters we would typically use a gradient -descent method. Newton’s method and gradient descent methods are -discussed in the material on optimization -methods.

-
-
-

6.5. Wisconsin Cancer Data

-

We show here how we can use a simple regression case on the breast -cancer data using Logistic regression as our algorithm for -classification.

-
-
-
import matplotlib.pyplot as plt
-import numpy as np
-from sklearn.model_selection import  train_test_split 
-from sklearn.datasets import load_breast_cancer
-from sklearn.linear_model import LogisticRegression
-
-# Load the data
-cancer = load_breast_cancer()
-
-X_train, X_test, y_train, y_test = train_test_split(cancer.data,cancer.target,random_state=0)
-print(X_train.shape)
-print(X_test.shape)
-# Logistic Regression
-logreg = LogisticRegression(solver='lbfgs')
-logreg.fit(X_train, y_train)
-print("Test set accuracy with Logistic Regression: {:.2f}".format(logreg.score(X_test,y_test)))
-#now scale the data
-from sklearn.preprocessing import StandardScaler
-scaler = StandardScaler()
-scaler.fit(X_train)
-X_train_scaled = scaler.transform(X_train)
-X_test_scaled = scaler.transform(X_test)
-# Logistic Regression
-logreg.fit(X_train_scaled, y_train)
-print("Test set accuracy Logistic Regression with scaled data: {:.2f}".format(logreg.score(X_test_scaled,y_test)))
-
-
-
-
-
(426, 30)
-(143, 30)
-Test set accuracy with Logistic Regression: 0.94
-Test set accuracy Logistic Regression with scaled data: 0.96
-
-
-
/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/linear_model/_logistic.py:762: ConvergenceWarning: lbfgs failed to converge (status=1):
-STOP: TOTAL NO. of ITERATIONS REACHED LIMIT.
-
-Increase the number of iterations (max_iter) or scale the data as shown in:
-    https://scikit-learn.org/stable/modules/preprocessing.html
-Please also refer to the documentation for alternative solver options:
-    https://scikit-learn.org/stable/modules/linear_model.html#logistic-regression
-  n_iter_i = _check_optimize_result(
-
-
-
-
-

In addition to the above scores, we could also study the covariance (and the correlation matrix). -We use Pandas to compute the correlation matrix.

-
-
-
import matplotlib.pyplot as plt
-import numpy as np
-from sklearn.model_selection import  train_test_split 
-from sklearn.datasets import load_breast_cancer
-from sklearn.linear_model import LogisticRegression
-cancer = load_breast_cancer()
-import pandas as pd
-# Making a data frame
-cancerpd = pd.DataFrame(cancer.data, columns=cancer.feature_names)
-
-fig, axes = plt.subplots(15,2,figsize=(10,20))
-malignant = cancer.data[cancer.target == 0]
-benign = cancer.data[cancer.target == 1]
-ax = axes.ravel()
-
-for i in range(30):
-    _, bins = np.histogram(cancer.data[:,i], bins =50)
-    ax[i].hist(malignant[:,i], bins = bins, alpha = 0.5)
-    ax[i].hist(benign[:,i], bins = bins, alpha = 0.5)
-    ax[i].set_title(cancer.feature_names[i])
-    ax[i].set_yticks(())
-ax[0].set_xlabel("Feature magnitude")
-ax[0].set_ylabel("Frequency")
-ax[0].legend(["Malignant", "Benign"], loc ="best")
-fig.tight_layout()
-plt.show()
-
-import seaborn as sns
-correlation_matrix = cancerpd.corr().round(1)
-# use the heatmap function from seaborn to plot the correlation matrix
-# annot = True to print the values inside the square
-plt.figure(figsize=(15,8))
-sns.heatmap(data=correlation_matrix, annot=True)
-plt.show()
-
-
-
-
-_images/chapter4_51_0.png -_images/chapter4_51_1.png -
-
-

In the above example we note two things. In the first plot we display -the overlap of benign and malignant tumors as functions of the various -features in the Wisconsing breast cancer data set. We see that for -some of the features we can distinguish clearly the benign and -malignant cases while for other features we cannot. This can point to -us which features may be of greater interest when we wish to classify -a benign or not benign tumour.

-

In the second figure we have computed the so-called correlation -matrix, which in our case with thirty features becomes a \(30\times 30\) -matrix.

-

We constructed this matrix using pandas via the statements

-
-
-
cancerpd = pd.DataFrame(cancer.data, columns=cancer.feature_names)
-
-
-
-
-

and then

-
-
-
correlation_matrix = cancerpd.corr().round(1)
-
-
-
-
-

Diagonalizing this matrix we can in turn say something about which -features are of relevance and which are not. This leads us to -the classical Principal Component Analysis (PCA) theorem with -applications. This will be discussed later this semester (week 43).

-
-
-
import matplotlib.pyplot as plt
-import numpy as np
-from sklearn.model_selection import  train_test_split 
-from sklearn.datasets import load_breast_cancer
-from sklearn.linear_model import LogisticRegression
-
-# Load the data
-cancer = load_breast_cancer()
-
-X_train, X_test, y_train, y_test = train_test_split(cancer.data,cancer.target,random_state=0)
-print(X_train.shape)
-print(X_test.shape)
-# Logistic Regression
-logreg = LogisticRegression(solver='lbfgs')
-logreg.fit(X_train, y_train)
-print("Test set accuracy with Logistic Regression: {:.2f}".format(logreg.score(X_test,y_test)))
-#now scale the data
-from sklearn.preprocessing import StandardScaler
-scaler = StandardScaler()
-scaler.fit(X_train)
-X_train_scaled = scaler.transform(X_train)
-X_test_scaled = scaler.transform(X_test)
-# Logistic Regression
-logreg.fit(X_train_scaled, y_train)
-print("Test set accuracy Logistic Regression with scaled data: {:.2f}".format(logreg.score(X_test_scaled,y_test)))
-
-
-from sklearn.preprocessing import LabelEncoder
-from sklearn.model_selection import cross_validate
-#Cross validation
-accuracy = cross_validate(logreg,X_test_scaled,y_test,cv=10)['test_score']
-print(accuracy)
-print("Test set accuracy with Logistic Regression  and scaled data: {:.2f}".format(logreg.score(X_test_scaled,y_test)))
-
-
-import scikitplot as skplt
-y_pred = logreg.predict(X_test_scaled)
-skplt.metrics.plot_confusion_matrix(y_test, y_pred, normalize=True)
-plt.show()
-y_probas = logreg.predict_proba(X_test_scaled)
-skplt.metrics.plot_roc(y_test, y_probas)
-plt.show()
-skplt.metrics.plot_cumulative_gain(y_test, y_probas)
-plt.show()
-
-
-
-
-
(426, 30)
-(143, 30)
-Test set accuracy with Logistic Regression: 0.94
-Test set accuracy Logistic Regression with scaled data: 0.96
-[1.         1.         1.         1.         1.         1.
- 1.         1.         0.92857143 0.92857143]
-Test set accuracy with Logistic Regression  and scaled data: 0.96
-
-
-
/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/linear_model/_logistic.py:762: ConvergenceWarning: lbfgs failed to converge (status=1):
-STOP: TOTAL NO. of ITERATIONS REACHED LIMIT.
-
-Increase the number of iterations (max_iter) or scale the data as shown in:
-    https://scikit-learn.org/stable/modules/preprocessing.html
-Please also refer to the documentation for alternative solver options:
-    https://scikit-learn.org/stable/modules/linear_model.html#logistic-regression
-  n_iter_i = _check_optimize_result(
-
-
-_images/chapter4_57_2.png -_images/chapter4_57_3.png -_images/chapter4_57_4.png -
-
-
-
- - - - -
- - - - -
-
-
-
-

- - By Morten Hjorth-Jensen
- - © Copyright 2021.
-

-
-
-
- - -
-
- - - - - - \ No newline at end of file diff --git a/doc/LectureNotes/_build/html/chapter5.html b/doc/LectureNotes/_build/html/chapter5.html deleted file mode 100644 index a321be1f2..000000000 --- a/doc/LectureNotes/_build/html/chapter5.html +++ /dev/null @@ -1,1406 +0,0 @@ - - - - - - - - 8. Support Vector Machines, overarching aims — Applied Data Analysis and Machine Learning - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
- - - - - - - - -
- - -
-
- -
- -
-

8. Support Vector Machines, overarching aims

-

A Support Vector Machine (SVM) is a very powerful and versatile -Machine Learning method, capable of performing linear or nonlinear -classification, regression, and even outlier detection. It is one of -the most popular models in Machine Learning, and anyone interested in -Machine Learning should have it in their toolbox. SVMs are -particularly well suited for classification of complex but small-sized or -medium-sized datasets.

-

The case with two well-separated classes only can be understood in an -intuitive way in terms of lines in a two-dimensional space separating -the two classes (see figure below).

-

The basic mathematics behind the SVM is however less familiar to most of us. -It relies on the definition of hyperplanes and the -definition of a margin which separates classes (in case of -classification problems) of variables. It is also used for regression -problems.

-

With SVMs we distinguish between hard margin and soft margins. The -latter introduces a so-called softening parameter to be discussed -below. We distinguish also between linear and non-linear -approaches. The latter are the most frequent ones since it is rather -unlikely that we can separate classes easily by say straight lines.

-
-

8.1. Hyperplanes and all that

-

The theory behind support vector machines (SVM hereafter) is based on -the mathematical description of so-called hyperplanes. Let us start -with a two-dimensional case. This will also allow us to introduce our -first SVM examples. These will be tailored to the case of two specific -classes, as displayed in the figure here based on the usage of the petal data.

-

We assume here that our data set can be well separated into two -domains, where a straight line does the job in the separating the two -classes. Here the two classes are represented by either squares or -circles.

-
-
-
%matplotlib inline
-
-from sklearn import datasets
-from sklearn.svm import SVC, LinearSVC
-from sklearn.linear_model import SGDClassifier
-from sklearn.preprocessing import StandardScaler
-import matplotlib
-import matplotlib.pyplot as plt
-plt.rcParams['axes.labelsize'] = 14
-plt.rcParams['xtick.labelsize'] = 12
-plt.rcParams['ytick.labelsize'] = 12
-
-
-iris = datasets.load_iris()
-X = iris["data"][:, (2, 3)]  # petal length, petal width
-y = iris["target"]
-
-setosa_or_versicolor = (y == 0) | (y == 1)
-X = X[setosa_or_versicolor]
-y = y[setosa_or_versicolor]
-
-
-
-C = 5
-alpha = 1 / (C * len(X))
-
-lin_clf = LinearSVC(loss="hinge", C=C, random_state=42)
-svm_clf = SVC(kernel="linear", C=C)
-sgd_clf = SGDClassifier(loss="hinge", learning_rate="constant", eta0=0.001, alpha=alpha,
-                        max_iter=100000, random_state=42)
-
-scaler = StandardScaler()
-X_scaled = scaler.fit_transform(X)
-
-lin_clf.fit(X_scaled, y)
-svm_clf.fit(X_scaled, y)
-sgd_clf.fit(X_scaled, y)
-
-print("LinearSVC:                   ", lin_clf.intercept_, lin_clf.coef_)
-print("SVC:                         ", svm_clf.intercept_, svm_clf.coef_)
-print("SGDClassifier(alpha={:.5f}):".format(sgd_clf.alpha), sgd_clf.intercept_, sgd_clf.coef_)
-
-# Compute the slope and bias of each decision boundary
-w1 = -lin_clf.coef_[0, 0]/lin_clf.coef_[0, 1]
-b1 = -lin_clf.intercept_[0]/lin_clf.coef_[0, 1]
-w2 = -svm_clf.coef_[0, 0]/svm_clf.coef_[0, 1]
-b2 = -svm_clf.intercept_[0]/svm_clf.coef_[0, 1]
-w3 = -sgd_clf.coef_[0, 0]/sgd_clf.coef_[0, 1]
-b3 = -sgd_clf.intercept_[0]/sgd_clf.coef_[0, 1]
-
-# Transform the decision boundary lines back to the original scale
-line1 = scaler.inverse_transform([[-10, -10 * w1 + b1], [10, 10 * w1 + b1]])
-line2 = scaler.inverse_transform([[-10, -10 * w2 + b2], [10, 10 * w2 + b2]])
-line3 = scaler.inverse_transform([[-10, -10 * w3 + b3], [10, 10 * w3 + b3]])
-
-# Plot all three decision boundaries
-plt.figure(figsize=(11, 4))
-plt.plot(line1[:, 0], line1[:, 1], "k:", label="LinearSVC")
-plt.plot(line2[:, 0], line2[:, 1], "b--", linewidth=2, label="SVC")
-plt.plot(line3[:, 0], line3[:, 1], "r-", label="SGDClassifier")
-plt.plot(X[:, 0][y==1], X[:, 1][y==1], "bs") # label="Iris-Versicolor"
-plt.plot(X[:, 0][y==0], X[:, 1][y==0], "yo") # label="Iris-Setosa"
-plt.xlabel("Petal length", fontsize=14)
-plt.ylabel("Petal width", fontsize=14)
-plt.legend(loc="upper center", fontsize=14)
-plt.axis([0, 5.5, 0, 2])
-
-plt.show()
-
-
-
-
-
LinearSVC:                    [0.28475098] [[1.05364854 1.09903804]]
-SVC:                          [0.31896852] [[1.1203284  1.02625193]]
-SGDClassifier(alpha=0.00200): [0.117] [[0.77714169 0.72981762]]
-
-
-_images/chapter5_1_1.png -
-
-

The aim of the SVM algorithm is to find a hyperplane in a -\(p\)-dimensional space, where \(p\) is the number of features that -distinctly classifies the data points.

-

In a \(p\)-dimensional space, a hyperplane is what we call an affine subspace of dimension of \(p-1\). -As an example, in two dimension, a hyperplane is simply as straight line while in three dimensions it is -a two-dimensional subspace, or stated simply, a plane.

-

In two dimensions, with the variables \(x_1\) and \(x_2\), the hyperplane is defined as

-
-\[ -b+w_1x_1+w_2x_2=0, -\]
-

where \(b\) is the intercept and \(w_1\) and \(w_2\) define the elements of a vector orthogonal to the line -\(b+w_1x_1+w_2x_2=0\). -In two dimensions we define the vectors \(\boldsymbol{x} =[x1,x2]\) and \(\boldsymbol{w}=[w1,w2]\). -We can then rewrite the above equation as

-
-\[ -\boldsymbol{x}^T\boldsymbol{w}+b=0. -\]
-

We limit ourselves to two classes of outputs \(y_i\) and assign these classes the values \(y_i = \pm 1\). -In a \(p\)-dimensional space of say \(p\) features we have a hyperplane defines as

-
-\[ -b+wx_1+w_2x_2+\dots +w_px_p=0. -\]
-

If we define a -matrix \(\boldsymbol{X}=\left[\boldsymbol{x}_1,\boldsymbol{x}_2,\dots, \boldsymbol{x}_p\right]\) -of dimension \(n\times p\), where \(n\) represents the observations for each feature and each vector \(x_i\) is a column vector of the matrix \(\boldsymbol{X}\),

-
-\[\begin{split} -\boldsymbol{x}_i = \begin{bmatrix} x_{i1} \\ x_{i2} \\ \dots \\ \dots \\ x_{ip} \end{bmatrix}. -\end{split}\]
-

If the above condition is not met for a given vector \(\boldsymbol{x}_i\) we have

-
-\[ -b+w_1x_{i1}+w_2x_{i2}+\dots +w_px_{ip} >0, -\]
-

if our output \(y_i=1\). -In this case we say that \(\boldsymbol{x}_i\) lies on one of the sides of the hyperplane and if

-
-\[ -b+w_1x_{i1}+w_2x_{i2}+\dots +w_px_{ip} < 0, -\]
-

for the class of observations \(y_i=-1\), -then \(\boldsymbol{x}_i\) lies on the other side.

-

Equivalently, for the two classes of observations we have

-
-\[ -y_i\left(b+w_1x_{i1}+w_2x_{i2}+\dots +w_px_{ip}\right) > 0. -\]
-

When we try to separate hyperplanes, if it exists, we can use it to construct a natural classifier: a test observation is assigned a given class depending on which side of the hyperplane it is located.

-
-

8.1.1. The two-dimensional case

-

Let us try to develop our intuition about SVMs by limiting ourselves to a two-dimensional -plane. To separate the two classes of data points, there are many -possible lines (hyperplanes if you prefer a more strict naming)
-that could be chosen. Our objective is to find a -plane that has the maximum margin, i.e the maximum distance between -data points of both classes. Maximizing the margin distance provides -some reinforcement so that future data points can be classified with -more confidence.

-

What a linear classifier attempts to accomplish is to split the -feature space into two half spaces by placing a hyperplane between the -data points. This hyperplane will be our decision boundary. All -points on one side of the plane will belong to class one and all points -on the other side of the plane will belong to the second class two.

-

Unfortunately there are many ways in which we can place a hyperplane -to divide the data. Below is an example of two candidate hyperplanes -for our data sample.

-

Let us define the function

-
-\[ -f(x) = \boldsymbol{w}^T\boldsymbol{x}+b = 0, -\]
-

as the function that determines the line \(L\) that separates two classes (our two features), see the figure here.

-

Any point defined by \(\boldsymbol{x}_i\) and \(\boldsymbol{x}_2\) on the line \(L\) will satisfy \(\boldsymbol{w}^T(\boldsymbol{x}_1-\boldsymbol{x}_2)=0\).

-

The signed distance \(\delta\) from any point defined by a vector \(\boldsymbol{x}\) and a point \(\boldsymbol{x}_0\) on the line \(L\) is then

-
-\[ -\delta = \frac{1}{\vert\vert \boldsymbol{w}\vert\vert}(\boldsymbol{w}^T\boldsymbol{x}+b). -\]
-

How do we find the parameter \(b\) and the vector \(\boldsymbol{w}\)? What we could -do is to define a cost function which now contains the set of all -misclassified points \(M\) and attempt to minimize this function

-
-\[ -C(\boldsymbol{w},b) = -\sum_{i\in M} y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b). -\]
-

We could now for example define all values \(y_i =1\) as misclassified in case we have \(\boldsymbol{w}^T\boldsymbol{x}_i+b < 0\) and the opposite if we have \(y_i=-1\). Taking the derivatives gives us

-
-\[ -\frac{\partial C}{\partial b} = -\sum_{i\in M} y_i, -\]
-

and

-
-\[ -\frac{\partial C}{\partial \boldsymbol{w}} = -\sum_{i\in M} y_ix_i. -\]
-

We can now use the Newton-Raphson method or different variants of the gradient descent family (from plain gradient descent to various stochastic gradient descent approaches) to solve the equations

-
-\[ -b \leftarrow b +\eta \frac{\partial C}{\partial b}, -\]
-

and

-
-\[ -\boldsymbol{w} \leftarrow \boldsymbol{w} +\eta \frac{\partial C}{\partial \boldsymbol{w}}, -\]
-

where \(\eta\) is our by now well-known learning rate.

-

The equations we discussed above can be coded rather easily (the -framework is similar to what we developed for logistic -regression). We are going to set up a simple case with two classes only and we want to find a line which separates them the best possible way.

-

There are however problems with this approach, although it looks -pretty straightforward to implement. When running the above code, we see that we can easily end up with many diffeent lines which separate the two classes.

-

For small -gaps between the entries, we may also end up needing many iterations -before the solutions converge and if the data cannot be separated -properly into two distinct classes, we may not experience a converge -at all.

-
-
-

8.1.2. A better approach

-

A better approach is rather to try to define a large margin between -the two classes (if they are well separated from the beginning).

-

Thus, we wish to find a margin \(M\) with \(\boldsymbol{w}\) normalized to -\(\vert\vert \boldsymbol{w}\vert\vert =1\) subject to the condition

-
-\[ -y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b) \geq M \hspace{0.1cm}\forall i=1,2,\dots, p. -\]
-

All points are thus at a signed distance from the decision boundary defined by the line \(L\). The parameters \(b\) and \(w_1\) and \(w_2\) define this line.

-

We seek thus the largest value \(M\) defined by

-
-\[ -\frac{1}{\vert \vert \boldsymbol{w}\vert\vert}y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b) \geq M \hspace{0.1cm}\forall i=1,2,\dots, n, -\]
-

or just

-
-\[ -y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b) \geq M\vert \vert \boldsymbol{w}\vert\vert \hspace{0.1cm}\forall i. -\]
-

If we scale the equation so that \(\vert \vert \boldsymbol{w}\vert\vert = 1/M\), we have to find the minimum of -\(\boldsymbol{w}^T\boldsymbol{w}=\vert \vert \boldsymbol{w}\vert\vert\) (the norm) subject to the condition

-
-\[ -y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b) \geq 1 \hspace{0.1cm}\forall i. -\]
-

We have thus defined our margin as the invers of the norm of -\(\boldsymbol{w}\). We want to minimize the norm in order to have a as large as -possible margin \(M\). Before we proceed, we need to remind ourselves -about Lagrangian multipliers.

-
-
-
-

8.2. A quick Reminder on Lagrangian Multipliers

-

Consider a function of three independent variables \(f(x,y,z)\) . For the function \(f\) to be an -extreme we have

-
-\[ -df=0. -\]
-

A necessary and sufficient condition is

-
-\[ -\frac{\partial f}{\partial x} =\frac{\partial f}{\partial y}=\frac{\partial f}{\partial z}=0, -\]
-

due to

-
-\[ -df = \frac{\partial f}{\partial x}dx+\frac{\partial f}{\partial y}dy+\frac{\partial f}{\partial z}dz. -\]
-

In many problems the variables \(x,y,z\) are often subject to constraints (such as those above for the margin) -so that they are no longer all independent. It is possible at least in principle to use each -constraint to eliminate one variable -and to proceed with a new and smaller set of independent varables.

-

The use of so-called Lagrangian multipliers is an alternative technique when the elimination -of variables is incovenient or undesirable. Assume that we have an equation of constraint on -the variables \(x,y,z\)

-
-\[ -\phi(x,y,z) = 0, -\]
-

resulting in

-
-\[ -d\phi = \frac{\partial \phi}{\partial x}dx+\frac{\partial \phi}{\partial y}dy+\frac{\partial \phi}{\partial z}dz =0. -\]
-

Now we cannot set anymore

-
-\[ -\frac{\partial f}{\partial x} =\frac{\partial f}{\partial y}=\frac{\partial f}{\partial z}=0, -\]
-

if \(df=0\) is wanted -because there are now only two independent variables! Assume \(x\) and \(y\) are the independent -variables. -Then \(dz\) is no longer arbitrary.

-

However, we can add to

-
-\[ -df = \frac{\partial f}{\partial x}dx+\frac{\partial f}{\partial y}dy+\frac{\partial f}{\partial z}dz, -\]
-

a multiplum of \(d\phi\), viz. \(\lambda d\phi\), resulting in

-
-\[ -df+\lambda d\phi = (\frac{\partial f}{\partial z}+\lambda -\frac{\partial \phi}{\partial x})dx+(\frac{\partial f}{\partial y}+\lambda\frac{\partial \phi}{\partial y})dy+ -(\frac{\partial f}{\partial z}+\lambda\frac{\partial \phi}{\partial z})dz =0. -\]
-

Our multiplier is chosen so that

-
-\[ -\frac{\partial f}{\partial z}+\lambda\frac{\partial \phi}{\partial z} =0. -\]
-

We need to remember that we took \(dx\) and \(dy\) to be arbitrary and thus we must have

-
-\[ -\frac{\partial f}{\partial x}+\lambda\frac{\partial \phi}{\partial x} =0, -\]
-

and

-
-\[ -\frac{\partial f}{\partial y}+\lambda\frac{\partial \phi}{\partial y} =0. -\]
-

When all these equations are satisfied, \(df=0\). We have four unknowns, \(x,y,z\) and -\(\lambda\). Actually we want only \(x,y,z\), \(\lambda\) needs not to be determined, -it is therefore often called -Lagrange’s undetermined multiplier. -If we have a set of constraints \(\phi_k\) we have the equations

-
-\[ -\frac{\partial f}{\partial x_i}+\sum_k\lambda_k\frac{\partial \phi_k}{\partial x_i} =0. -\]
-

In order to solve the above problem, we define the following Lagrangian function to be minimized

-
-\[ -\cal{L}(\lambda,b,\boldsymbol{w})=\frac{1}{2}\boldsymbol{w}^T\boldsymbol{w}-\sum_{i=1}^n\lambda_i\left[y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b)-1\right], -\]
-

where \(\lambda_i\) is a so-called Lagrange multiplier subject to the condition \(\lambda_i \geq 0\).

-

Taking the derivatives with respect to \(b\) and \(\boldsymbol{w}\) we obtain

-
-\[ -\frac{\partial \cal{L}}{\partial b} = -\sum_{i} \lambda_iy_i=0, -\]
-

and

-
-\[ -\frac{\partial \cal{L}}{\partial \boldsymbol{w}} = 0 = \boldsymbol{w}-\sum_{i} \lambda_iy_i\boldsymbol{x}_i. -\]
-

Inserting these constraints into the equation for \(\cal{L}\) we obtain

-
-\[ -\cal{L}=\sum_i\lambda_i-\frac{1}{2}\sum_{ij}^n\lambda_i\lambda_jy_iy_j\boldsymbol{x}_i^T\boldsymbol{x}_j, -\]
-

subject to the constraints \(\lambda_i\geq 0\) and \(\sum_i\lambda_iy_i=0\). -We must in addition satisfy the Karush-Kuhn-Tucker (KKT) condition

-
-\[ -\lambda_i\left[y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b) -1\right] \hspace{0.1cm}\forall i. -\]
-
    -
  1. If \(\lambda_i > 0\), then \(y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b)=1\) and we say that \(x_i\) is on the boundary.

  2. -
  3. If \(y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b)> 1\), we say \(x_i\) is not on the boundary and we set \(\lambda_i=0\).

  4. -
-

When \(\lambda_i > 0\), the vectors \(\boldsymbol{x}_i\) are called support vectors. They are the vectors closest to the line (or hyperplane) and define the margin \(M\).

-

We can rewrite

-
-\[ -\cal{L}=\sum_i\lambda_i-\frac{1}{2}\sum_{ij}^n\lambda_i\lambda_jy_iy_j\boldsymbol{x}_i^T\boldsymbol{x}_j, -\]
-

and its constraints in terms of a matrix-vector problem where we minimize w.r.t. \(\lambda\) the following problem

-
-\[\begin{split} -\frac{1}{2} \boldsymbol{\lambda}^T\begin{bmatrix} y_1y_1\boldsymbol{x}_1^T\boldsymbol{x}_1 & y_1y_2\boldsymbol{x}_1^T\boldsymbol{x}_2 & \dots & \dots & y_1y_n\boldsymbol{x}_1^T\boldsymbol{x}_n \\ -y_2y_1\boldsymbol{x}_2^T\boldsymbol{x}_1 & y_2y_2\boldsymbol{x}_2^T\boldsymbol{x}_2 & \dots & \dots & y_1y_n\boldsymbol{x}_2^T\boldsymbol{x}_n \\ -\dots & \dots & \dots & \dots & \dots \\ -\dots & \dots & \dots & \dots & \dots \\ -y_ny_1\boldsymbol{x}_n^T\boldsymbol{x}_1 & y_ny_2\boldsymbol{x}_n^T\boldsymbol{x}_2 & \dots & \dots & y_ny_n\boldsymbol{x}_n^T\boldsymbol{x}_n \\ -\end{bmatrix}\boldsymbol{\lambda}-\mathbb{1}\boldsymbol{\lambda}, -\end{split}\]
-

subject to \(\boldsymbol{y}^T\boldsymbol{\lambda}=0\). Here we defined the vectors \(\boldsymbol{\lambda} =[\lambda_1,\lambda_2,\dots,\lambda_n]\) and -\(\boldsymbol{y}=[y_1,y_2,\dots,y_n]\).

-

Solving the above problem, yields the values of \(\lambda_i\). -To find the coefficients of your hyperplane we need simply to compute

-
-\[ -\boldsymbol{w}=\sum_{i} \lambda_iy_i\boldsymbol{x}_i. -\]
-

With our vector \(\boldsymbol{w}\) we can in turn find the value of the intercept \(b\) (here in two dimensions) via

-
-\[ -y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b)=1, -\]
-

resulting in

-
-\[ -b = \frac{1}{y_i}-\boldsymbol{w}^T\boldsymbol{x}_i, -\]
-

or if we write it out in terms of the support vectors only, with \(N_s\) being their number, we have

-
-\[ -b = \frac{1}{N_s}\sum_{j\in N_s}\left(y_j-\sum_{i=1}^n\lambda_iy_i\boldsymbol{x}_i^T\boldsymbol{x}_j\right). -\]
-

With our hyperplane coefficients we can use our classifier to assign any observation by simply using

-
-\[ -y_i = \mathrm{sign}(\boldsymbol{w}^T\boldsymbol{x}_i+b). -\]
-

Below we discuss how to find the optimal values of \(\lambda_i\). Before we proceed however, we discuss now the so-called soft classifier.

-
-
-

8.3. A soft classifier

-

Till now, the margin is strictly defined by the support vectors. This defines what is called a hard classifier, that is the margins are well defined.

-

Suppose now that classes overlap in feature space, as shown in the -figure here. One way to deal with this problem before we define the -so-called kernel approach, is to allow a kind of slack in the sense -that we allow some points to be on the wrong side of the margin.

-

We introduce thus the so-called slack variables \(\boldsymbol{\xi} =[\xi_1,x_2,\dots,x_n]\) and -modify our previous equation

-
-\[ -y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b)=1, -\]
-

to

-
-\[ -y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b)=1-\xi_i, -\]
-

with the requirement \(\xi_i\geq 0\). The total violation is now \(\sum_i\xi\). -The value \(\xi_i\) in the constraint the last constraint corresponds to the amount by which the prediction -\(y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b)=1\) is on the wrong side of its margin. Hence by bounding the sum \(\sum_i \xi_i\), -we bound the total amount by which predictions fall on the wrong side of their margins.

-

Misclassifications occur when \(\xi_i > 1\). Thus bounding the total sum by some value \(C\) bounds in turn the total number of -misclassifications.

-

This has in turn the consequences that we change our optmization problem to finding the minimum of

-
-\[ -\cal{L}=\frac{1}{2}\boldsymbol{w}^T\boldsymbol{w}-\sum_{i=1}^n\lambda_i\left[y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b)-(1-\xi_)\right]+C\sum_{i=1}^n\xi_i-\sum_{i=1}^n\gamma_i\xi_i, -\]
-

subject to

-
-\[ -y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b)=1-\xi_i \hspace{0.1cm}\forall i, -\]
-

with the requirement \(\xi_i\geq 0\).

-

Taking the derivatives with respect to \(b\) and \(\boldsymbol{w}\) we obtain

-
-\[ -\frac{\partial \cal{L}}{\partial b} = -\sum_{i} \lambda_iy_i=0, -\]
-

and

-
-\[ -\frac{\partial \cal{L}}{\partial \boldsymbol{w}} = 0 = \boldsymbol{w}-\sum_{i} \lambda_iy_i\boldsymbol{x}_i, -\]
-

and

-
-\[ -\lambda_i = C-\gamma_i \hspace{0.1cm}\forall i. -\]
-

Inserting these constraints into the equation for \(\cal{L}\) we obtain the same equation as before

-
-\[ -\cal{L}=\sum_i\lambda_i-\frac{1}{2}\sum_{ij}^n\lambda_i\lambda_jy_iy_j\boldsymbol{x}_i^T\boldsymbol{x}_j, -\]
-

but now subject to the constraints \(\lambda_i\geq 0\), \(\sum_i\lambda_iy_i=0\) and \(0\leq\lambda_i \leq C\). -We must in addition satisfy the Karush-Kuhn-Tucker condition which now reads

-

5 -0

-

< -< -< -! -! -M -A -T -H -_ -B -L -O -C -K

-
-\[ -\gamma_i\xi_i = 0, -\]
-

and

-
-\[ -y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b) -(1-\xi_) \geq 0 \hspace{0.1cm}\forall i. -\]
-
-
-

8.4. Kernels and non-linearity

-

The cases we have studied till now, were all characterized by two classes -with a close to linear separability. The classifiers we have described -so far find linear boundaries in our input feature space. It is -possible to make our procedure more flexible by exploring the feature -space using other basis expansions such as higher-order polynomials, -wavelets, splines etc.

-

If our feature space is not easy to separate, as shown in the figure -here, we can achieve a better separation by introducing more complex -basis functions. The ideal would be, as shown in the next figure, to, via a specific transformation to -obtain a separation between the classes which is almost linear.

-

The change of basis, from \(x\rightarrow z=\phi(x)\) leads to the same type of equations to be solved, except that -we need to introduce for example a polynomial transformation to a two-dimensional training set.

-
-
-
import numpy as np
-import os
-
-np.random.seed(42)
-
-# To plot pretty figures
-import matplotlib
-import matplotlib.pyplot as plt
-plt.rcParams['axes.labelsize'] = 14
-plt.rcParams['xtick.labelsize'] = 12
-plt.rcParams['ytick.labelsize'] = 12
-
-
-from sklearn.svm import SVC
-from sklearn import datasets
-
-
-
-X1D = np.linspace(-4, 4, 9).reshape(-1, 1)
-X2D = np.c_[X1D, X1D**2]
-y = np.array([0, 0, 1, 1, 1, 1, 1, 0, 0])
-
-plt.figure(figsize=(11, 4))
-
-plt.subplot(121)
-plt.grid(True, which='both')
-plt.axhline(y=0, color='k')
-plt.plot(X1D[:, 0][y==0], np.zeros(4), "bs")
-plt.plot(X1D[:, 0][y==1], np.zeros(5), "g^")
-plt.gca().get_yaxis().set_ticks([])
-plt.xlabel(r"$x_1$", fontsize=20)
-plt.axis([-4.5, 4.5, -0.2, 0.2])
-
-plt.subplot(122)
-plt.grid(True, which='both')
-plt.axhline(y=0, color='k')
-plt.axvline(x=0, color='k')
-plt.plot(X2D[:, 0][y==0], X2D[:, 1][y==0], "bs")
-plt.plot(X2D[:, 0][y==1], X2D[:, 1][y==1], "g^")
-plt.xlabel(r"$x_1$", fontsize=20)
-plt.ylabel(r"$x_2$", fontsize=20, rotation=0)
-plt.gca().get_yaxis().set_ticks([0, 4, 8, 12, 16])
-plt.plot([-4.5, 4.5], [6.5, 6.5], "r--", linewidth=3)
-plt.axis([-4.5, 4.5, -1, 17])
-plt.subplots_adjust(right=1)
-plt.show()
-
-
-
-
-_images/chapter5_109_0.png -
-
-

Suppose we define a polynomial transformation of degree two only (we continue to live in a plane with \(x_i\) and \(y_i\) as variables)

-
-\[ -z = \phi(x_i) =\left(x_i^2, y_i^2, \sqrt{2}x_iy_i\right). -\]
-

With our new basis, the equations we solved earlier are basically the same, that is we have now (without the slack option for simplicity)

-
-\[ -\cal{L}=\sum_i\lambda_i-\frac{1}{2}\sum_{ij}^n\lambda_i\lambda_jy_iy_j\boldsymbol{z}_i^T\boldsymbol{z}_j, -\]
-

subject to the constraints \(\lambda_i\geq 0\), \(\sum_i\lambda_iy_i=0\), and for the support vectors

-
-\[ -y_i(\boldsymbol{w}^T\boldsymbol{z}_i+b)= 1 \hspace{0.1cm}\forall i, -\]
-

from which we also find \(b\). -To compute \(\boldsymbol{z}_i^T\boldsymbol{z}_j\) we define the kernel \(K(\boldsymbol{x}_i,\boldsymbol{x}_j)\) as

-
-\[ -K(\boldsymbol{x}_i,\boldsymbol{x}_j)=\boldsymbol{z}_i^T\boldsymbol{z}_j= \phi(\boldsymbol{x}_i)^T\phi(\boldsymbol{x}_j). -\]
-

For the above example, the kernel reads

-
-\[\begin{split} -K(\boldsymbol{x}_i,\boldsymbol{x}_j)=[x_i^2, y_i^2, \sqrt{2}x_iy_i]^T\begin{bmatrix} x_j^2 \\ y_j^2 \\ \sqrt{2}x_jy_j \end{bmatrix}=x_i^2x_j^2+2x_ix_jy_iy_j+y_i^2y_j^2. -\end{split}\]
-

We note that this is nothing but the dot product of the two original -vectors \((\boldsymbol{x}_i^T\boldsymbol{x}_j)^2\). Instead of thus computing the -product in the Lagrangian of \(\boldsymbol{z}_i^T\boldsymbol{z}_j\) we simply compute -the dot product \((\boldsymbol{x}_i^T\boldsymbol{x}_j)^2\).

-

This leads to the so-called -kernel trick and the result leads to the same as if we went through -the trouble of performing the transformation -\(\phi(\boldsymbol{x}_i)^T\phi(\boldsymbol{x}_j)\) during the SVM calculations.

-

Using our definition of the kernel We can rewrite again the Lagrangian

-
-\[ -\cal{L}=\sum_i\lambda_i-\frac{1}{2}\sum_{ij}^n\lambda_i\lambda_jy_iy_j\boldsymbol{x}_i^T\boldsymbol{z}_j, -\]
-

subject to the constraints \(\lambda_i\geq 0\), \(\sum_i\lambda_iy_i=0\) in terms of a convex optimization problem

-
-\[\begin{split} -\frac{1}{2} \boldsymbol{\lambda}^T\begin{bmatrix} y_1y_1K(\boldsymbol{x}_1,\boldsymbol{x}_1) & y_1y_2K(\boldsymbol{x}_1,\boldsymbol{x}_2) & \dots & \dots & y_1y_nK(\boldsymbol{x}_1,\boldsymbol{x}_n) \\ -y_2y_1K(\boldsymbol{x}_2,\boldsymbol{x}_1) & y_2y_2(\boldsymbol{x}_2,\boldsymbol{x}_2) & \dots & \dots & y_1y_nK(\boldsymbol{x}_2,\boldsymbol{x}_n) \\ -\dots & \dots & \dots & \dots & \dots \\ -\dots & \dots & \dots & \dots & \dots \\ -y_ny_1K(\boldsymbol{x}_n,\boldsymbol{x}_1) & y_ny_2K(\boldsymbol{x}_n\boldsymbol{x}_2) & \dots & \dots & y_ny_nK(\boldsymbol{x}_n,\boldsymbol{x}_n) \\ -\end{bmatrix}\boldsymbol{\lambda}-\mathbb{1}\boldsymbol{\lambda}, -\end{split}\]
-

subject to \(\boldsymbol{y}^T\boldsymbol{\lambda}=0\). Here we defined the vectors \(\boldsymbol{\lambda} =[\lambda_1,\lambda_2,\dots,\lambda_n]\) and -\(\boldsymbol{y}=[y_1,y_2,\dots,y_n]\). -If we add the slack constants this leads to the additional constraint \(0\leq \lambda_i \leq C\).

-

We can rewrite this (see the solutions below) in terms of a convex optimization problem of the type

-
-\[\begin{split} -\begin{align*} - &\mathrm{min}_{\lambda}\hspace{0.2cm} \frac{1}{2}\boldsymbol{\lambda}^T\boldsymbol{P}\boldsymbol{\lambda}+\boldsymbol{q}^T\boldsymbol{\lambda},\\ \nonumber - &\mathrm{subject\hspace{0.1cm}to} \hspace{0.2cm} \boldsymbol{G}\boldsymbol{\lambda} \preceq \boldsymbol{h} \hspace{0.2cm} \wedge \boldsymbol{A}\boldsymbol{\lambda}=f. -\end{align*} -\end{split}\]
-

Below we discuss how to solve these equations. Here we note that the matrix \(\boldsymbol{P}\) has matrix elements \(p_{ij}=y_iy_jK(\boldsymbol{x}_i,\boldsymbol{x}_j)\). -Given a kernel \(K\) and the targets \(y_i\) this matrix is easy to set up. The constraint \(\boldsymbol{y}^T\boldsymbol{\lambda}=0\) leads to \(f=0\) and \(\boldsymbol{A}=\boldsymbol{y}\). How to set up the matrix \(\boldsymbol{G}\) is discussed later. Here note that the inequalities \(0\leq \lambda_i \leq C\) can be split up into -\(0\leq \lambda_i\) and \(\lambda_i \leq C\). These two inequalities define then the matrix \(\boldsymbol{G}\) and the vector \(\boldsymbol{h}\).

-
-
-

8.5. Different kernels and Mercer’s theorem

-

There are several popular kernels being used. These are

-
    -
  1. Linear: \(K(\boldsymbol{x},\boldsymbol{y})=\boldsymbol{x}^T\boldsymbol{y}\),

  2. -
  3. Polynomial: \(K(\boldsymbol{x},\boldsymbol{y})=(\boldsymbol{x}^T\boldsymbol{y}+\gamma)^d\),

  4. -
  5. Gaussian Radial Basis Function: \(K(\boldsymbol{x},\boldsymbol{y})=\exp{\left(-\gamma\vert\vert\boldsymbol{x}-\boldsymbol{y}\vert\vert^2\right)}\),

  6. -
  7. Tanh: \(K(\boldsymbol{x},\boldsymbol{y})=\tanh{(\boldsymbol{x}^T\boldsymbol{y}+\gamma)}\),

  8. -
-

and many other ones.

-

An important theorem for us is Mercer’s -theorem. The -theorem states that if a kernel function \(K\) is symmetric, continuous -and leads to a positive semi-definite matrix \(\boldsymbol{P}\) then there -exists a function \(\phi\) that maps \(\boldsymbol{x}_i\) and \(\boldsymbol{x}_j\) into -another space (possibly with much higher dimensions) such that

-
-\[ -K(\boldsymbol{x}_i,\boldsymbol{x}_j)=\phi(\boldsymbol{x}_i)^T\phi(\boldsymbol{x}_j). -\]
-

So you can use \(K\) as a kernel since you know \(\phi\) exists, even if -you don’t know what \(\phi\) is.

-

Note that some frequently used kernels (such as the Sigmoid kernel) -don’t respect all of Mercer’s conditions, yet they generally work well -in practice.

-
-
-

8.6. The moons example

-
-
-
from __future__ import division, print_function, unicode_literals
-
-import numpy as np
-np.random.seed(42)
-
-import matplotlib
-import matplotlib.pyplot as plt
-plt.rcParams['axes.labelsize'] = 14
-plt.rcParams['xtick.labelsize'] = 12
-plt.rcParams['ytick.labelsize'] = 12
-
-
-from sklearn.svm import SVC
-from sklearn import datasets
-
-
-
-from sklearn.pipeline import Pipeline
-from sklearn.preprocessing import StandardScaler
-from sklearn.svm import LinearSVC
-
-
-from sklearn.datasets import make_moons
-X, y = make_moons(n_samples=100, noise=0.15, random_state=42)
-
-def plot_dataset(X, y, axes):
-    plt.plot(X[:, 0][y==0], X[:, 1][y==0], "bs")
-    plt.plot(X[:, 0][y==1], X[:, 1][y==1], "g^")
-    plt.axis(axes)
-    plt.grid(True, which='both')
-    plt.xlabel(r"$x_1$", fontsize=20)
-    plt.ylabel(r"$x_2$", fontsize=20, rotation=0)
-
-plot_dataset(X, y, [-1.5, 2.5, -1, 1.5])
-plt.show()
-
-from sklearn.datasets import make_moons
-from sklearn.pipeline import Pipeline
-from sklearn.preprocessing import PolynomialFeatures
-
-polynomial_svm_clf = Pipeline([
-        ("poly_features", PolynomialFeatures(degree=3)),
-        ("scaler", StandardScaler()),
-        ("svm_clf", LinearSVC(C=10, loss="hinge", random_state=42))
-    ])
-
-polynomial_svm_clf.fit(X, y)
-
-def plot_predictions(clf, axes):
-    x0s = np.linspace(axes[0], axes[1], 100)
-    x1s = np.linspace(axes[2], axes[3], 100)
-    x0, x1 = np.meshgrid(x0s, x1s)
-    X = np.c_[x0.ravel(), x1.ravel()]
-    y_pred = clf.predict(X).reshape(x0.shape)
-    y_decision = clf.decision_function(X).reshape(x0.shape)
-    plt.contourf(x0, x1, y_pred, cmap=plt.cm.brg, alpha=0.2)
-    plt.contourf(x0, x1, y_decision, cmap=plt.cm.brg, alpha=0.1)
-
-plot_predictions(polynomial_svm_clf, [-1.5, 2.5, -1, 1.5])
-plot_dataset(X, y, [-1.5, 2.5, -1, 1.5])
-
-plt.show()
-
-
-from sklearn.svm import SVC
-
-poly_kernel_svm_clf = Pipeline([
-        ("scaler", StandardScaler()),
-        ("svm_clf", SVC(kernel="poly", degree=3, coef0=1, C=5))
-    ])
-poly_kernel_svm_clf.fit(X, y)
-
-poly100_kernel_svm_clf = Pipeline([
-        ("scaler", StandardScaler()),
-        ("svm_clf", SVC(kernel="poly", degree=10, coef0=100, C=5))
-    ])
-poly100_kernel_svm_clf.fit(X, y)
-
-plt.figure(figsize=(11, 4))
-
-plt.subplot(121)
-plot_predictions(poly_kernel_svm_clf, [-1.5, 2.5, -1, 1.5])
-plot_dataset(X, y, [-1.5, 2.5, -1, 1.5])
-plt.title(r"$d=3, r=1, C=5$", fontsize=18)
-
-plt.subplot(122)
-plot_predictions(poly100_kernel_svm_clf, [-1.5, 2.5, -1, 1.5])
-plot_dataset(X, y, [-1.5, 2.5, -1, 1.5])
-plt.title(r"$d=10, r=100, C=5$", fontsize=18)
-
-plt.show()
-
-def gaussian_rbf(x, landmark, gamma):
-    return np.exp(-gamma * np.linalg.norm(x - landmark, axis=1)**2)
-
-gamma = 0.3
-
-x1s = np.linspace(-4.5, 4.5, 200).reshape(-1, 1)
-x2s = gaussian_rbf(x1s, -2, gamma)
-x3s = gaussian_rbf(x1s, 1, gamma)
-
-XK = np.c_[gaussian_rbf(X1D, -2, gamma), gaussian_rbf(X1D, 1, gamma)]
-yk = np.array([0, 0, 1, 1, 1, 1, 1, 0, 0])
-
-plt.figure(figsize=(11, 4))
-
-plt.subplot(121)
-plt.grid(True, which='both')
-plt.axhline(y=0, color='k')
-plt.scatter(x=[-2, 1], y=[0, 0], s=150, alpha=0.5, c="red")
-plt.plot(X1D[:, 0][yk==0], np.zeros(4), "bs")
-plt.plot(X1D[:, 0][yk==1], np.zeros(5), "g^")
-plt.plot(x1s, x2s, "g--")
-plt.plot(x1s, x3s, "b:")
-plt.gca().get_yaxis().set_ticks([0, 0.25, 0.5, 0.75, 1])
-plt.xlabel(r"$x_1$", fontsize=20)
-plt.ylabel(r"Similarity", fontsize=14)
-plt.annotate(r'$\mathbf{x}$',
-             xy=(X1D[3, 0], 0),
-             xytext=(-0.5, 0.20),
-             ha="center",
-             arrowprops=dict(facecolor='black', shrink=0.1),
-             fontsize=18,
-            )
-plt.text(-2, 0.9, "$x_2$", ha="center", fontsize=20)
-plt.text(1, 0.9, "$x_3$", ha="center", fontsize=20)
-plt.axis([-4.5, 4.5, -0.1, 1.1])
-
-plt.subplot(122)
-plt.grid(True, which='both')
-plt.axhline(y=0, color='k')
-plt.axvline(x=0, color='k')
-plt.plot(XK[:, 0][yk==0], XK[:, 1][yk==0], "bs")
-plt.plot(XK[:, 0][yk==1], XK[:, 1][yk==1], "g^")
-plt.xlabel(r"$x_2$", fontsize=20)
-plt.ylabel(r"$x_3$  ", fontsize=20, rotation=0)
-plt.annotate(r'$\phi\left(\mathbf{x}\right)$',
-             xy=(XK[3, 0], XK[3, 1]),
-             xytext=(0.65, 0.50),
-             ha="center",
-             arrowprops=dict(facecolor='black', shrink=0.1),
-             fontsize=18,
-            )
-plt.plot([-0.1, 1.1], [0.57, -0.1], "r--", linewidth=3)
-plt.axis([-0.1, 1.1, -0.1, 1.1])
-    
-plt.subplots_adjust(right=1)
-
-plt.show()
-
-
-x1_example = X1D[3, 0]
-for landmark in (-2, 1):
-    k = gaussian_rbf(np.array([[x1_example]]), np.array([[landmark]]), gamma)
-    print("Phi({}, {}) = {}".format(x1_example, landmark, k))
-
-rbf_kernel_svm_clf = Pipeline([
-        ("scaler", StandardScaler()),
-        ("svm_clf", SVC(kernel="rbf", gamma=5, C=0.001))
-    ])
-rbf_kernel_svm_clf.fit(X, y)
-
-
-from sklearn.svm import SVC
-
-gamma1, gamma2 = 0.1, 5
-C1, C2 = 0.001, 1000
-hyperparams = (gamma1, C1), (gamma1, C2), (gamma2, C1), (gamma2, C2)
-
-svm_clfs = []
-for gamma, C in hyperparams:
-    rbf_kernel_svm_clf = Pipeline([
-            ("scaler", StandardScaler()),
-            ("svm_clf", SVC(kernel="rbf", gamma=gamma, C=C))
-        ])
-    rbf_kernel_svm_clf.fit(X, y)
-    svm_clfs.append(rbf_kernel_svm_clf)
-
-plt.figure(figsize=(11, 7))
-
-for i, svm_clf in enumerate(svm_clfs):
-    plt.subplot(221 + i)
-    plot_predictions(svm_clf, [-1.5, 2.5, -1, 1.5])
-    plot_dataset(X, y, [-1.5, 2.5, -1, 1.5])
-    gamma, C = hyperparams[i]
-    plt.title(r"$\gamma = {}, C = {}$".format(gamma, C), fontsize=16)
-
-plt.show()
-
-
-
-
-_images/chapter5_129_0.png -
/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/svm/_base.py:976: ConvergenceWarning: Liblinear failed to converge, increase the number of iterations.
-  warnings.warn("Liblinear failed to converge, increase "
-
-
-_images/chapter5_129_2.png -_images/chapter5_129_3.png -_images/chapter5_129_4.png -
Phi(-1.0, -2) = [0.74081822]
-Phi(-1.0, 1) = [0.30119421]
-
-
-_images/chapter5_129_6.png -
-
-
-
-

8.7. Mathematical optimization of convex functions

-

A mathematical (quadratic) optimization problem, or just optimization problem, has the form

-
-\[\begin{split} -\begin{align*} - &\mathrm{min}_{\lambda}\hspace{0.2cm} \frac{1}{2}\boldsymbol{\lambda}^T\boldsymbol{P}\boldsymbol{\lambda}+\boldsymbol{q}^T\boldsymbol{\lambda},\\ \nonumber - &\mathrm{subject\hspace{0.1cm}to} \hspace{0.2cm} \boldsymbol{G}\boldsymbol{\lambda} \preceq \boldsymbol{h} \wedge \boldsymbol{A}\boldsymbol{\lambda}=f. -\end{align*} -\end{split}\]
-

subject to some constraints for say a selected set \(i=1,2,\dots, n\). -In our case we are optimizing with respect to the Lagrangian multipliers \(\lambda_i\), and the -vector \(\boldsymbol{\lambda}=[\lambda_1, \lambda_2,\dots, \lambda_n]\) is the optimization variable we are dealing with.

-

In our case we are particularly interested in a class of optimization problems called convex optmization problems. -In our discussion on gradient descent methods we discussed at length the definition of a convex function.

-

Convex optimization problems play a central role in applied mathematics and we recommend strongly Boyd and Vandenberghe’s text on the topics.

-

If we use Python as programming language and wish to venture beyond -scikit-learn, tensorflow and similar software which makes our -lives so much easier, we need to dive into the wonderful world of -quadratic programming. We can, if we wish, solve the minimization -problem using say standard gradient methods or conjugate gradient -methods. However, these methods tend to exhibit a rather slow -converge. So, welcome to the promised land of quadratic programming.

-

The functions we need are contained in the quadratic programming package CVXOPT and we need to import it together with numpy as

-
-
-
import numpy
-import cvxopt
-
-
-
-
-

This will make our life much easier. You don’t need t write your own optimizer.

-

We remind ourselves about the general problem we want to solve

-
-\[\begin{split} -\begin{align*} - &\mathrm{min}_{x}\hspace{0.2cm} \frac{1}{2}\boldsymbol{x}^T\boldsymbol{P}\boldsymbol{x}+\boldsymbol{q}^T\boldsymbol{x},\\ \nonumber - &\mathrm{subject\hspace{0.1cm} to} \hspace{0.2cm} \boldsymbol{G}\boldsymbol{x} \preceq \boldsymbol{h} \wedge \boldsymbol{A}\boldsymbol{x}=f. -\end{align*} -\end{split}\]
-

Let us show how to perform the optmization using a simple case. Assume we want to optimize the following problem

-
-\[\begin{split} -\begin{align*} - &\mathrm{min}_{x}\hspace{0.2cm} \frac{1}{2}x^2+5x+3y \\ \nonumber - &\mathrm{subject to} \\ \nonumber - &x, y \geq 0 \\ \nonumber - &x+3y \geq 15 \\ \nonumber - &2x+5y \leq 100 \\ \nonumber - &3x+4y \leq 80. \\ \nonumber -\end{align*} -\end{split}\]
-

The minimization problem can be rewritten in terms of vectors and matrices as (with \(x\) and \(y\) being the unknowns)

-
-\[\begin{split} -\frac{1}{2}\begin{bmatrix} x\\ y \end{bmatrix}^T \begin{bmatrix} 1 & 0\\ 0 & 0 \end{bmatrix} \begin{bmatrix} x \\ y \end{bmatrix} + \begin{bmatrix}3\\ 4 \end{bmatrix}^T \begin{bmatrix}x \\ y \end{bmatrix}. -\end{split}\]
-

Similarly, we can now set up the inequalities (we need to change \(\geq\) to \(\leq\) by multiplying with \(-1\) on bot sides) as the following matrix-vector equation

-
-\[\begin{split} -\begin{bmatrix} -1 & 0 \\ 0 & -1 \\ -1 & -3 \\ 2 & 5 \\ 3 & 4\end{bmatrix}\begin{bmatrix} x \\ y\end{bmatrix} \preceq \begin{bmatrix}0 \\ 0\\ -15 \\ 100 \\ 80\end{bmatrix}. -\end{split}\]
-

We have collapsed all the inequalities into a single matrix \(\boldsymbol{G}\). We see also that our matrix

-
-\[\begin{split} -\boldsymbol{P} =\begin{bmatrix} 1 & 0\\ 0 & 0 \end{bmatrix} -\end{split}\]
-

is clearly positive semi-definite (all eigenvalues larger or equal zero). -Finally, the vector \(\boldsymbol{h}\) is defined as

-
-\[\begin{split} -\boldsymbol{h} = \begin{bmatrix}0 \\ 0\\ -15 \\ 100 \\ 80\end{bmatrix}. -\end{split}\]
-

Since we don’t have any equalities the matrix \(\boldsymbol{A}\) is set to zero -The following code solves the equations for us

-
-
-
# Import the necessary packages
-import numpy
-from cvxopt import matrix
-from cvxopt import solvers
-P = matrix(numpy.diag([1,0]), tc=’d’)
-q = matrix(numpy.array([3,4]), tc=’d’)
-G = matrix(numpy.array([[-1,0],[0,-1],[-1,-3],[2,5],[3,4]]), tc=’d’)
-h = matrix(numpy.array([0,0,-15,100,80]), tc=’d’)
-# Construct the QP, invoke solver
-sol = solvers.qp(P,q,G,h)
-# Extract optimal value and solution
-sol[’x’] 
-sol[’primal objective’]
-
-
-
-
-
  File "<ipython-input-5-c46dd114b2af>", line 5
-    P = matrix(numpy.diag([1,0]), tc=’d’)
-                                       ^
-SyntaxError: invalid character in identifier
-
-
-
-
-

We are now ready to return to our setup of the optmization problem for a more realistic case. Introducing the slack parameter \(C\) we have

-
-\[\begin{split} -\frac{1}{2} \boldsymbol{\lambda}^T\begin{bmatrix} y_1y_1K(\boldsymbol{x}_1,\boldsymbol{x}_1) & y_1y_2K(\boldsymbol{x}_1,\boldsymbol{x}_2) & \dots & \dots & y_1y_nK(\boldsymbol{x}_1,\boldsymbol{x}_n) \\ -y_2y_1K(\boldsymbol{x}_2,\boldsymbol{x}_1) & y_2y_2K(\boldsymbol{x}_2,\boldsymbol{x}_2) & \dots & \dots & y_1y_nK(\boldsymbol{x}_2,\boldsymbol{x}_n) \\ -\dots & \dots & \dots & \dots & \dots \\ -\dots & \dots & \dots & \dots & \dots \\ -y_ny_1K(\boldsymbol{x}_n,\boldsymbol{x}_1) & y_ny_2K(\boldsymbol{x}_n\boldsymbol{x}_2) & \dots & \dots & y_ny_nK(\boldsymbol{x}_n,\boldsymbol{x}_n) \\ -\end{bmatrix}\boldsymbol{\lambda}-\mathbb{I}\boldsymbol{\lambda}, -\end{split}\]
-

subject to \(\boldsymbol{y}^T\boldsymbol{\lambda}=0\). Here we defined the vectors \(\boldsymbol{\lambda} =[\lambda_1,\lambda_2,\dots,\lambda_n]\) and -\(\boldsymbol{y}=[y_1,y_2,\dots,y_n]\). -With the slack constants this leads to the additional constraint \(0\leq \lambda_i \leq C\).

-

code will be added

-
-
- - - - -
- - - - -
-
-
-
-

- - By Morten Hjorth-Jensen
- - © Copyright 2021.
-

-
-
-
- - -
-
- - - - - - \ No newline at end of file diff --git a/doc/LectureNotes/_build/html/chapter6.html b/doc/LectureNotes/_build/html/chapter6.html deleted file mode 100644 index ec9001aa6..000000000 --- a/doc/LectureNotes/_build/html/chapter6.html +++ /dev/null @@ -1,1456 +0,0 @@ - - - - - - - - 9. Decision trees, overarching aims — Applied Data Analysis and Machine Learning - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
- - - - - - - - -
- - -
-
- -
- -
-

9. Decision trees, overarching aims

-

We start here with the most basic algorithm, the so-called decision -tree. With this basic algorithm we can in turn build more complex -networks, spanning from homogeneous and heterogenous forests (bagging, -random forests and more) to one of the most popular supervised -algorithms nowadays, the extreme gradient boosting, or just -XGBoost. But let us start with the simplest possible ingredient.

-

Decision trees are supervised learning algorithms used for both, -classification and regression tasks.

-

The main idea of decision trees -is to find those descriptive features which contain the most -information regarding the target feature and then split the dataset -along the values of these features such that the target feature values -for the resulting underlying datasets are as pure as possible.

-

The descriptive features which reproduce best the target/output features are normally said -to be the most informative ones. The process of finding the most -informative feature is done until we accomplish a stopping criteria -where we then finally end up in so called leaf nodes.

-
-

9.1. Basics of a tree

-

A decision tree is typically divided into a root node, the interior nodes, -and the final leaf nodes or just leaves. These entities are then connected by so-called branches.

-

The leaf nodes -contain the predictions we will make for new query instances presented -to our trained model. This is possible since the model has -learned the underlying structure of the training data and hence can, -given some assumptions, make predictions about the target feature value -(class) of unseen query instances.

-
-
-

9.2. General Features

-

The overarching approach to decision trees is a top-down approach.

-
    -
  • A leaf provides the classification of a given instance.

  • -
  • A node specifies a test of some attribute of the instance.

  • -
  • A branch corresponds to a possible values of an attribute.

  • -
  • An instance is classified by starting at the root node of the tree, testing the attribute specified by this node, then moving down the tree branch corresponding to the value of the attribute in the given example.

  • -
-

This process is then repeated for the subtree rooted at the new -node.

-

In simplified terms, the process of training a decision tree and -predicting the target features of query instances is as follows:

-
    -
  1. Present a dataset containing of a number of training instances characterized by a number of descriptive features and a target feature

  2. -
  3. Train the decision tree model by continuously splitting the target feature along the values of the descriptive features using a measure of information gain during the training process

  4. -
  5. Grow the tree until we accomplish a stopping criteria create leaf nodes which represent the predictions we want to make for new query instances

  6. -
  7. Show query instances to the tree and run down the tree until we arrive at leaf nodes

  8. -
-

Then we are essentially done!

-
-
-
%matplotlib inline
-
-import numpy as np
-import matplotlib.pyplot as plt
-from sklearn.preprocessing import PolynomialFeatures
-from sklearn.linear_model import LinearRegression
-
-steps=250
-
-distance=0
-x=0
-distance_list=[]
-steps_list=[]
-while x<steps:
-    distance+=np.random.randint(-1,2)
-    distance_list.append(distance)
-    x+=1
-    steps_list.append(x)
-plt.plot(steps_list,distance_list, color='green', label="Random Walk Data")
-
-steps_list=np.asarray(steps_list)
-distance_list=np.asarray(distance_list)
-
-X=steps_list[:,np.newaxis]
-
-#Polynomial fits
-
-#Degree 2
-poly_features=PolynomialFeatures(degree=2, include_bias=False)
-X_poly=poly_features.fit_transform(X)
-
-lin_reg=LinearRegression()
-poly_fit=lin_reg.fit(X_poly,distance_list)
-b=lin_reg.coef_
-c=lin_reg.intercept_
-print ("2nd degree coefficients:")
-print ("zero power: ",c)
-print ("first power: ", b[0])
-print ("second power: ",b[1])
-
-z = np.arange(0, steps, .01)
-z_mod=b[1]*z**2+b[0]*z+c
-
-fit_mod=b[1]*X**2+b[0]*X+c
-plt.plot(z, z_mod, color='r', label="2nd Degree Fit")
-plt.title("Polynomial Regression")
-
-plt.xlabel("Steps")
-plt.ylabel("Distance")
-
-#Degree 10
-poly_features10=PolynomialFeatures(degree=10, include_bias=False)
-X_poly10=poly_features10.fit_transform(X)
-
-poly_fit10=lin_reg.fit(X_poly10,distance_list)
-
-y_plot=poly_fit10.predict(X_poly10)
-plt.plot(X, y_plot, color='black', label="10th Degree Fit")
-
-plt.legend()
-plt.show()
-
-
-#Decision Tree Regression
-from sklearn.tree import DecisionTreeRegressor
-regr_1=DecisionTreeRegressor(max_depth=2)
-regr_2=DecisionTreeRegressor(max_depth=5)
-regr_3=DecisionTreeRegressor(max_depth=7)
-regr_1.fit(X, distance_list)
-regr_2.fit(X, distance_list)
-regr_3.fit(X, distance_list)
-
-X_test = np.arange(0.0, steps, 0.01)[:, np.newaxis]
-y_1 = regr_1.predict(X_test)
-y_2 = regr_2.predict(X_test)
-y_3=regr_3.predict(X_test)
-
-# Plot the results
-plt.figure()
-plt.scatter(X, distance_list, s=2.5, c="black", label="data")
-plt.plot(X_test, y_1, color="red",
-         label="max_depth=2", linewidth=2)
-plt.plot(X_test, y_2, color="green", label="max_depth=5", linewidth=2)
-plt.plot(X_test, y_3, color="m", label="max_depth=7", linewidth=2)
-
-plt.xlabel("Data")
-plt.ylabel("Darget")
-plt.title("Decision Tree Regression")
-plt.legend()
-plt.show()
-
-
-
-
-
2nd degree coefficients:
-zero power:  -2.575591916051299
-first power:  -0.07310737041838755
-second power:  0.0002644543695187602
-
-
-_images/chapter6_1_1.png -_images/chapter6_1_2.png -
-
-
-
-

9.3. Building a tree, regression

-

There are mainly two steps

-
    -
  1. We split the predictor space (the set of possible values \(x_1,x_2,\dots, x_p\)) into \(J\) distinct and non-non-overlapping regions, \(R_1,R_2,\dots,R_J\).

  2. -
  3. For every observation that falls into the region \(R_j\) , we make the same prediction, which is simply the mean of the response values for the training observations in \(R_j\).

  4. -
-

How do we construct the regions \(R_1,\dots,R_J\)? In theory, the -regions could have any shape. However, we choose to divide the -predictor space into high-dimensional rectangles, or boxes, for -simplicity and for ease of interpretation of the resulting predictive -model. The goal is to find boxes \(R_1,\dots,R_J\) that minimize the -MSE, given by

-
-\[ -\sum_{j=1}^J\sum_{i\in R_j}(y_i-\overline{y}_{R_j})^2, -\]
-

where \(\overline{y}_{R_j}\) is the mean response for the training observations -within box \(j\).

-

Unfortunately, it is computationally infeasible to consider every -possible partition of the feature space into \(J\) boxes. The common -strategy is to take a top-down approach

-

The approach is top-down because it begins at the top of the tree (all -observations belong to a single region) and then successively splits -the predictor space; each split is indicated via two new branches -further down on the tree. It is greedy because at each step of the -tree-building process, the best split is made at that particular step, -rather than looking ahead and picking a split that will lead to a -better tree in some future step.

-
-

9.3.1. Making a tree

-

In order to implement the recursive binary splitting we start by selecting -the predictor \(x_j\) and a cutpoint \(s\) that splits the predictor space into two regions \(R_1\) and \(R_2\)

-
-\[ -\left\{X\vert x_j < s\right\}, -\]
-

and

-
-\[ -\left\{X\vert x_j \geq s\right\}, -\]
-

so that we obtain the lowest MSE, that is

-
-\[ -\sum_{i:x_i\in R_j}(y_i-\overline{y}_{R_1})^2+\sum_{i:x_i\in R_2}(y_i-\overline{y}_{R_2})^2, -\]
-

which we want to minimize by considering all predictors -\(x_1,x_2,\dots,x_p\). We consider also all possible values of \(s\) for -each predictor. These values could be determined by randomly assigned -numbers or by starting at the midpoint and then proceed till we find -an optimal value.

-

For any \(j\) and \(s\), we define the pair of half-planes where -\(\overline{y}_{R_1}\) is the mean response for the training -observations in \(R_1(j,s)\), and \(\overline{y}_{R_2}\) is the mean -response for the training observations in \(R_2(j,s)\).

-

Finding the values of \(j\) and \(s\) that minimize the above equation can be -done quite quickly, especially when the number of features \(p\) is not -too large.

-

Next, we repeat the process, looking -for the best predictor and best cutpoint in order to split the data -further so as to minimize the MSE within each of the resulting -regions. However, this time, instead of splitting the entire predictor -space, we split one of the two previously identified regions. We now -have three regions. Again, we look to split one of these three regions -further, so as to minimize the MSE. The process continues until a -stopping criterion is reached; for instance, we may continue until no -region contains more than five observations.

-

The above procedure is rather straightforward, but leads often to -overfitting and unnecessarily large and complicated trees. The basic -idea is to grow a large tree \(T_0\) and then prune it back in order to -obtain a subtree. A smaller tree with fewer splits (fewer regions) can -lead to smaller variance and better interpretation at the cost of a -little more bias.

-

The so-called Cost complexity pruning algorithm gives us a -way to do just this. Rather than considering every possible subtree, -we consider a sequence of trees indexed by a nonnegative tuning -parameter \(\alpha\).

-

Read more at the following Scikit-Learn link on pruning.

-

For each value of \(\alpha\) there corresponds a subtree \(T \in T_0\) such that

-
-\[ -\sum_{m=1}^{\overline{T}}\sum_{i:x_i\in R_m}(y_i-\overline{y}_{R_m})^2+\alpha\overline{T}, -\]
-

is as small as possible. Here \(\overline{T}\) is -the number of terminal nodes of the tree \(T\) , \(R_m\) is the -rectangle (i.e. the subset of predictor space) corresponding to the \(m\)-th terminal node.

-

The tuning parameter \(\alpha\) controls a trade-off between the subtree’s -complexity and its fit to the training data. When \(\alpha = 0\), then the -subtree \(T\) will simply equal \(T_0\), -because then the above equation just measures the -training error. -However, as \(\alpha\) increases, there is a price to pay for -having a tree with many terminal nodes. The above equation will -tend to be minimized for a smaller subtree.

-

It turns out that as we increase \(\alpha\) from zero -branches get pruned from the tree in a nested and predictable fashion, -so obtaining the whole sequence of subtrees as a function of \(\alpha\) is -easy. We can select a value of \(\alpha\) using a validation set or using -cross-validation. We then return to the full data set and obtain the -subtree corresponding to \(\alpha\).

-
-
-

9.3.2. Schematic Regression Procedure

-

Building a Regression Tree

-
    -
  1. Use recursive binary splitting to grow a large tree on the training data, stopping only when each terminal node has fewer than some minimum number of observations.

  2. -
  3. Apply cost complexity pruning to the large tree in order to obtain a sequence of best subtrees, as a function of \(\alpha\).

  4. -
  5. Use for example \(K\)-fold cross-validation to choose \(\alpha\). Divide the training observations into \(K\) folds. For each \(k=1,2,\dots,K\) we:

  6. -
-
    -
  • repeat steps 1 and 2 on all but the \(k\)-th fold of the training data.

  • -
  • Then we valuate the mean squared prediction error on the data in the left-out \(k\)-th fold, as a function of \(\alpha\).

  • -
  • Finally we average the results for each value of \(\alpha\), and pick \(\alpha\) to minimize the average error.

  • -
-
    -
  1. Return the subtree from Step 2 that corresponds to the chosen value of \(\alpha\).

  2. -
-

!eblock

-
-
-
-

9.4. A Classification Tree

-

A classification tree is very similar to a regression tree, except -that it is used to predict a qualitative response rather than a -quantitative one. Recall that for a regression tree, the predicted -response for an observation is given by the mean response of the -training observations that belong to the same terminal node. In -contrast, for a classification tree, we predict that each observation -belongs to the most commonly occurring class of training observations -in the region to which it belongs. In interpreting the results of a -classification tree, we are often interested not only in the class -prediction corresponding to a particular terminal node region, but -also in the class proportions among the training observations that -fall into that region.

-

The task of growing a -classification tree is quite similar to the task of growing a -regression tree. Just as in the regression setting, we use recursive -binary splitting to grow a classification tree. However, in the -classification setting, the MSE cannot be used as a criterion for making -the binary splits. A natural alternative to MSE is the classification -error rate. Since we plan to assign an observation in a given region -to the most commonly occurring error rate class of training -observations in that region, the classification error rate is simply -the fraction of the training observations in that region that do not -belong to the most common class.

-

When building a classification tree, either the Gini index or the -entropy are typically used to evaluate the quality of a particular -split, since these two approaches are more sensitive to node purity -than is the classification error rate.

-

If our targets are the outcome of a classification process that takes -for example \(k=1,2,\dots,K\) values, the only thing we need to think of -is to set up the splitting criteria for each node.

-

We define a PDF \(p_{mk}\) that represents the number of observations of -a class \(k\) in a region \(R_m\) with \(N_m\) observations. We represent -this likelihood function in terms of the proportion \(I(y_i=k)\) of -observations of this class in the region \(R_m\) as

-
-\[ -p_{mk} = \frac{1}{N_m}\sum_{x_i\in R_m}I(y_i=k). -\]
-

We let \(p_{mk}\) represent the majority class of observations in region -\(m\). The three most common ways of splitting a node are given by

-
    -
  • Misclassification error

  • -
-
-\[ -p_{mk} = \frac{1}{N_m}\sum_{x_i\in R_m}I(y_i\ne k) = 1-p_{mk}. -\]
-
    -
  • Gini index \(g\)

  • -
-
-\[ -g = \sum_{k=1}^K p_{mk}(1-p_{mk}). -\]
-
    -
  • Information entropy or just entropy \(s\)

  • -
-
-\[ -s = -\sum_{k=1}^K p_{mk}\log{p_{mk}}. -\]
-
-

9.4.1. Visualizing the Tree, Classification

-
-
-
import os
-from sklearn.datasets import load_breast_cancer
-from sklearn.tree import DecisionTreeClassifier
-from sklearn.model_selection import train_test_split
-from sklearn.metrics import confusion_matrix
-from sklearn.tree import export_graphviz
-
-from IPython.display import Image 
-from pydot import graph_from_dot_data
-import pandas as pd
-import numpy as np
-
-
-cancer = load_breast_cancer()
-X = pd.DataFrame(cancer.data, columns=cancer.feature_names)
-print(X)
-y = pd.Categorical.from_codes(cancer.target, cancer.target_names)
-y = pd.get_dummies(y)
-print(y)
-X_train, X_test, y_train, y_test = train_test_split(X, y, random_state=1)
-tree_clf = DecisionTreeClassifier(max_depth=5)
-tree_clf.fit(X_train, y_train)
-
-export_graphviz(
-    tree_clf,
-    out_file="DataFiles/cancer.dot",
-    feature_names=cancer.feature_names,
-    class_names=cancer.target_names,
-    rounded=True,
-    filled=True
-)
-cmd = 'dot -Tpng DataFiles/cancer.dot -o DataFiles/cancer.png'
-os.system(cmd)
-
-
-
-
-
---------------------------------------------------------------------------
-ModuleNotFoundError                       Traceback (most recent call last)
-<ipython-input-2-7c394b1e8b71> in <module>
-      7 
-      8 from IPython.display import Image
-----> 9 from pydot import graph_from_dot_data
-     10 import pandas as pd
-     11 import numpy as np
-
-ModuleNotFoundError: No module named 'pydot'
-
-
-
-
-
-
-
# Common imports
-import numpy as np
-from sklearn.model_selection import  train_test_split 
-from sklearn.tree import DecisionTreeClassifier
-from sklearn.datasets import make_moons
-from sklearn.tree import export_graphviz
-from pydot import graph_from_dot_data
-import pandas as pd
-import os
-
-np.random.seed(42)
-X, y = make_moons(n_samples=100, noise=0.25, random_state=53)
-X_train, X_test, y_train, y_test = train_test_split(X,y,random_state=0)
-tree_clf = DecisionTreeClassifier(max_depth=5)
-tree_clf.fit(X_train, y_train)
-
-export_graphviz(
-    tree_clf,
-    out_file="DataFiles/moons.dot",
-    rounded=True,
-    filled=True
-)
-cmd = 'dot -Tpng DataFiles/moons.dot -o DataFiles/moons.png'
-os.system(cmd)
-
-
-
-
-
-
-

9.4.2. Other ways of visualizing the trees

-

Scikit-Learn has also another way to visualize the trees which is very useful, here with the Iris data.

-
-
-
from sklearn.datasets import load_iris
-from sklearn import tree
-X, y = load_iris(return_X_y=True)
-tree_clf = tree.DecisionTreeClassifier()
-tree_clf = tree_clf.fit(X, y)
-# and then plot the tree
-tree.plot_tree(tree_clf)
-
-
-
-
-

Alternatively, the tree can also be exported in textual format with the function exporttext. -This method doesn’t require the installation of external libraries and is more compact:

-
-
-
from sklearn.datasets import load_iris
-from sklearn.tree import DecisionTreeClassifier
-from sklearn.tree import export_text
-iris = load_iris()
-decision_tree = DecisionTreeClassifier(random_state=0, max_depth=2)
-decision_tree = decision_tree.fit(iris.data, iris.target)
-r = export_text(decision_tree, feature_names=iris['feature_names'])
-print(r)
-
-
-
-
-
-
-
-

9.5. Algorithms for Setting up Decision Trees

-

Two algorithms stand out in the set up of decision trees:

-
    -
  1. The CART (Classification And Regression Tree) algorithm for both classification and regression

  2. -
  3. The ID3 algorithm based on the computation of the information gain for classification

  4. -
-

We discuss both algorithms with applications here. The popular library -Scikit-Learn uses the CART algorithm. For classification problems -you can use either the gini index or the entropy to split a tree -in two branches.

-
-

9.5.1. The CART algorithm for Classification

-

For classification, the CART algorithm splits the data set in two subsets using a single feature \(k\) and a threshold \(t_k\). -This could be for example a threshold set by a number below a certain circumference of a malign tumor.

-

How do we find these two quantities? -We search for the pair \((k,t_k)\) that produces the purest subset using for example the gini factor \(G\). -The cost function it tries to minimize is then

-
-\[ -C(k,t_k) = \frac{m_{\mathrm{left}}}{m}G_{\mathrm{left}}+ \frac{m_{\mathrm{right}}}{m}G_{\mathrm{right}}, -\]
-

where \(G_{\mathrm{left/right}}\) measures the impurity of the left/right subset and \(m_{\mathrm{left/right}}\) -is the number of instances in the left/right subset

-

Once it has successfully split the training set in two, it splits the subsets using the same logic, then the subsubsets -and so on, recursively. It stops recursing once it reaches the maximum depth (defined by the -\(max\_depth\) hyperparameter), or if it cannot find a split that will reduce impurity. A few other -hyperparameters control additional stopping conditions such as the \(min\_samples\_split\), -\(min\_samples\_leaf\), \(min\_weight\_fraction\_leaf\), and \(max\_leaf\_nodes\).

-
-
-

9.5.2. The CART algorithm for Regression

-

The CART algorithm for regression works is similar to the one for classification except that instead of trying to split the -training set in a way that minimizes say the gini or entropy impurity, it now tries to split the training set in a way that minimizes our well-known mean-squared error (MSE). The cost function is now

-
-\[ -C(k,t_k) = \frac{m_{\mathrm{left}}}{m}\mathrm{MSE}_{\mathrm{left}}+ \frac{m_{\mathrm{right}}}{m}\mathrm{MSE}_{\mathrm{right}}. -\]
-

Here the MSE for a specific node is defined as

-
-\[ -\mathrm{MSE}_{\mathrm{node}}=\frac{1}{m_\mathrm{node}}\sum_{i\in \mathrm{node}}(\overline{y}_{\mathrm{node}}-y_i)^2, -\]
-

with

-
-\[ -\overline{y}_{\mathrm{node}}=\frac{1}{m_\mathrm{node}}\sum_{i\in \mathrm{node}}y_i, -\]
-

the mean value of all observations in a specific node.

-

Without any regularization, the regression task for decision trees, -just like for classification tasks, is prone to overfitting.

-
-
-

9.5.3. Computing the Gini index

-

The example we will look at is a classical one in many Machine -Learning applications. Based on various meteorological features, we -have several so-called attributes which decide whether we at the end -will do some outdoor activity like skiing, going for a bike ride etc -etc. The table here contains the feautures outlook, temperature, -humidity and wind. The target or output is whether we ride -(True=1) or whether we do something else that day (False=0). The -attributes for each feature are then sunny, overcast and rain for the -outlook, hot, cold and mild for temperature, high and normal for -humidity and weak and strong for wind.

-

The table here summarizes the various attributes and

- - - - - - - - - - - - - - - - - - - - -
Day Outlook Temperature Humidity Wind Ride
1 Sunny Hot High Weak 0
2 Sunny Hot High Strong 1
3 Overcast Hot High Weak 1
4 Rain Mild High Weak 1
5 Rain Cool Normal Weak 1
6 Rain Cool Normal Strong 0
7 Overcast Cool Normal Strong 1
8 Sunny Mild High Weak 0
9 Sunny Cool Normal Weak 1
10 Rain Mild Normal Weak 1
11 Sunny Mild Normal Strong 1
12 Overcast Mild High Strong 1
13 Overcast Hot Normal Weak 1
14 Rain Mild High Strong 0
-
-
-

9.5.4. Simple Python Code to read in Data and perform Classification

-
-
-
# Common imports
-import numpy as np
-import pandas as pd
-import matplotlib.pyplot as plt
-from sklearn.tree import DecisionTreeClassifier
-from sklearn.model_selection import train_test_split
-from sklearn.tree import export_graphviz
-from sklearn.preprocessing import StandardScaler, OneHotEncoder
-from sklearn.compose import ColumnTransformer
-from IPython.display import Image 
-from pydot import graph_from_dot_data
-import os
-
-# Where to save the figures and data files
-PROJECT_ROOT_DIR = "Results"
-FIGURE_ID = "Results/FigureFiles"
-DATA_ID = "DataFiles/"
-
-if not os.path.exists(PROJECT_ROOT_DIR):
-    os.mkdir(PROJECT_ROOT_DIR)
-
-if not os.path.exists(FIGURE_ID):
-    os.makedirs(FIGURE_ID)
-
-if not os.path.exists(DATA_ID):
-    os.makedirs(DATA_ID)
-
-def image_path(fig_id):
-    return os.path.join(FIGURE_ID, fig_id)
-
-def data_path(dat_id):
-    return os.path.join(DATA_ID, dat_id)
-
-def save_fig(fig_id):
-    plt.savefig(image_path(fig_id) + ".png", format='png')
-
-infile = open(data_path("rideclass.csv"),'r')
-
-# Read the experimental data with Pandas
-from IPython.display import display
-ridedata = pd.read_csv(infile,names = ('Outlook','Temperature','Humidity','Wind','Ride'))
-ridedata = pd.DataFrame(ridedata)
-
-# Features and targets
-X = ridedata.loc[:, ridedata.columns != 'Ride'].values
-y = ridedata.loc[:, ridedata.columns == 'Ride'].values
-
-# Create the encoder.
-encoder = OneHotEncoder(handle_unknown="ignore")
-# Assume for simplicity all features are categorical.
-encoder.fit(X)    
-# Apply the encoder.
-X = encoder.transform(X)
-print(X)
-# Then do a Classification tree
-tree_clf = DecisionTreeClassifier(max_depth=2)
-tree_clf.fit(X, y)
-print("Train set accuracy with Decision Tree: {:.2f}".format(tree_clf.score(X,y)))
-#transfer to a decision tree graph
-export_graphviz(
-    tree_clf,
-    out_file="DataFiles/ride.dot",
-    rounded=True,
-    filled=True
-)
-cmd = 'dot -Tpng DataFiles/cancer.dot -o DataFiles/cancer.png'
-os.system(cmd)
-
-
-
-
-

The above functions (gini, entropy and misclassification error) are -important components of the so-called CART algorithm. We will discuss -this algorithm below after we have discussed the information gain -algorithm ID3.

-

In the example here we have converted all our attributes into numerical values \(0,1,2\) etc.

-
-
-
# Split a dataset based on an attribute and an attribute value
-def test_split(index, value, dataset):
-	left, right = list(), list()
-	for row in dataset:
-		if row[index] < value:
-			left.append(row)
-		else:
-			right.append(row)
-	return left, right
- 
-# Calculate the Gini index for a split dataset
-def gini_index(groups, classes):
-	# count all samples at split point
-	n_instances = float(sum([len(group) for group in groups]))
-	# sum weighted Gini index for each group
-	gini = 0.0
-	for group in groups:
-		size = float(len(group))
-		# avoid divide by zero
-		if size == 0:
-			continue
-		score = 0.0
-		# score the group based on the score for each class
-		for class_val in classes:
-			p = [row[-1] for row in group].count(class_val) / size
-			score += p * p
-		# weight the group score by its relative size
-		gini += (1.0 - score) * (size / n_instances)
-	return gini
-
-# Select the best split point for a dataset
-def get_split(dataset):
-	class_values = list(set(row[-1] for row in dataset))
-	b_index, b_value, b_score, b_groups = 999, 999, 999, None
-	for index in range(len(dataset[0])-1):
-		for row in dataset:
-			groups = test_split(index, row[index], dataset)
-			gini = gini_index(groups, class_values)
-			print('X%d < %.3f Gini=%.3f' % ((index+1), row[index], gini))
-			if gini < b_score:
-				b_index, b_value, b_score, b_groups = index, row[index], gini, groups
-	return {'index':b_index, 'value':b_value, 'groups':b_groups}
- 
-dataset = [[0,0,0,0,0],
-            [0,0,0,1,1],
-            [1,0,0,0,1],
-            [2,1,0,0,1],
-            [2,2,1,0,1],
-            [2,2,1,1,0],
-            [1,2,1,1,1],
-            [0,1,0,0,0],
-            [0,2,1,0,1],
-            [2,1,1,0,1],
-            [0,1,1,1,1],
-            [1,1,0,1,1],
-            [1,0,1,0,1],
-            [2,1,0,1,0]]
-
-split = get_split(dataset)
-print('Split: [X%d < %.3f]' % ((split['index']+1), split['value']))
-
-
-
-
-
-
-
-

9.6. Entropy and the ID3 algorithm

-

The ID3 algorithm learns decision trees by constructing -them in a top down way, beginning with the question which attribute should be tested at the root of the tree?

-
    -
  1. Each instance attribute is evaluated using a statistical test to determine how well it alone classifies the training examples.

  2. -
  3. The best attribute is selected and used as the test at the root node of the tree.

  4. -
  5. A descendant of the root node is then created for each possible value of this attribute.

  6. -
  7. Training examples are sorted to the appropriate descendant node.

  8. -
  9. The entire process is then repeated using the training examples associated with each descendant node to select the best attribute to test at that point in the tree.

  10. -
  11. This forms a greedy search for an acceptable decision tree, in which the algorithm never backtracks to reconsider earlier choices.

  12. -
-

The ID3 algorithm selects which attribute to test at each node in the -tree.

-

We would like to select the attribute that is most useful for classifying -examples.

-

What is a good quantitative measure of the worth of an attribute?

-

Information gain measures how well a given attribute separates the -training examples according to their target classification.

-

The ID3 algorithm uses this information gain measure to select among the candidate -attributes at each step while growing the tree.

-
-

9.6.1. Cancer Data again now with Decision Trees and other Methods

-
-
-
import matplotlib.pyplot as plt
-import numpy as np
-from sklearn.model_selection import  train_test_split 
-from sklearn.datasets import load_breast_cancer
-from sklearn.svm import SVC
-from sklearn.linear_model import LogisticRegression
-from sklearn.tree import DecisionTreeClassifier
-
-# Load the data
-cancer = load_breast_cancer()
-
-X_train, X_test, y_train, y_test = train_test_split(cancer.data,cancer.target,random_state=0)
-print(X_train.shape)
-print(X_test.shape)
-# Logistic Regression
-logreg = LogisticRegression(solver='lbfgs')
-logreg.fit(X_train, y_train)
-print("Test set accuracy with Logistic Regression: {:.2f}".format(logreg.score(X_test,y_test)))
-# Support vector machine
-svm = SVC(gamma='auto', C=100)
-svm.fit(X_train, y_train)
-print("Test set accuracy with SVM: {:.2f}".format(svm.score(X_test,y_test)))
-# Decision Trees
-deep_tree_clf = DecisionTreeClassifier(max_depth=None)
-deep_tree_clf.fit(X_train, y_train)
-print("Test set accuracy with Decision Trees: {:.2f}".format(deep_tree_clf.score(X_test,y_test)))
-#now scale the data
-from sklearn.preprocessing import StandardScaler
-scaler = StandardScaler()
-scaler.fit(X_train)
-X_train_scaled = scaler.transform(X_train)
-X_test_scaled = scaler.transform(X_test)
-# Logistic Regression
-logreg.fit(X_train_scaled, y_train)
-print("Test set accuracy Logistic Regression with scaled data: {:.2f}".format(logreg.score(X_test_scaled,y_test)))
-# Support Vector Machine
-svm.fit(X_train_scaled, y_train)
-print("Test set accuracy SVM with scaled data: {:.2f}".format(logreg.score(X_test_scaled,y_test)))
-# Decision Trees
-deep_tree_clf.fit(X_train_scaled, y_train)
-print("Test set accuracy with Decision Trees and scaled data: {:.2f}".format(deep_tree_clf.score(X_test_scaled,y_test)))
-
-
-
-
-
-
-

9.6.2. Another example, the moons again

-
-
-
from __future__ import division, print_function, unicode_literals
-
-# Common imports
-import numpy as np
-import os
-
-# to make this notebook's output stable across runs
-np.random.seed(42)
-
-# To plot pretty figures
-import matplotlib
-import matplotlib.pyplot as plt
-from matplotlib.colors import ListedColormap
-plt.rcParams['axes.labelsize'] = 14
-plt.rcParams['xtick.labelsize'] = 12
-plt.rcParams['ytick.labelsize'] = 12
-
-
-from sklearn.svm import SVC
-from sklearn import datasets
-from sklearn.tree import DecisionTreeClassifier
-from sklearn.datasets import make_moons
-from sklearn.tree import export_graphviz
-
-Xm, ym = make_moons(n_samples=100, noise=0.25, random_state=53)
-
-deep_tree_clf1 = DecisionTreeClassifier(random_state=42)
-deep_tree_clf2 = DecisionTreeClassifier(min_samples_leaf=4, random_state=42)
-deep_tree_clf1.fit(Xm, ym)
-deep_tree_clf2.fit(Xm, ym)
-
-
-def plot_decision_boundary(clf, X, y, axes=[0, 7.5, 0, 3], iris=True, legend=False, plot_training=True):
-    x1s = np.linspace(axes[0], axes[1], 100)
-    x2s = np.linspace(axes[2], axes[3], 100)
-    x1, x2 = np.meshgrid(x1s, x2s)
-    X_new = np.c_[x1.ravel(), x2.ravel()]
-    y_pred = clf.predict(X_new).reshape(x1.shape)
-    custom_cmap = ListedColormap(['#fafab0','#9898ff','#a0faa0'])
-    plt.contourf(x1, x2, y_pred, alpha=0.3, cmap=custom_cmap)
-    if not iris:
-        custom_cmap2 = ListedColormap(['#7d7d58','#4c4c7f','#507d50'])
-        plt.contour(x1, x2, y_pred, cmap=custom_cmap2, alpha=0.8)
-    if plot_training:
-        plt.plot(X[:, 0][y==0], X[:, 1][y==0], "yo", label="Iris-Setosa")
-        plt.plot(X[:, 0][y==1], X[:, 1][y==1], "bs", label="Iris-Versicolor")
-        plt.plot(X[:, 0][y==2], X[:, 1][y==2], "g^", label="Iris-Virginica")
-        plt.axis(axes)
-    if iris:
-        plt.xlabel("Petal length", fontsize=14)
-        plt.ylabel("Petal width", fontsize=14)
-    else:
-        plt.xlabel(r"$x_1$", fontsize=18)
-        plt.ylabel(r"$x_2$", fontsize=18, rotation=0)
-    if legend:
-        plt.legend(loc="lower right", fontsize=14)
-plt.figure(figsize=(11, 4))
-plt.subplot(121)
-plot_decision_boundary(deep_tree_clf1, Xm, ym, axes=[-1.5, 2.5, -1, 1.5], iris=False)
-plt.title("No restrictions", fontsize=16)
-plt.subplot(122)
-plot_decision_boundary(deep_tree_clf2, Xm, ym, axes=[-1.5, 2.5, -1, 1.5], iris=False)
-plt.title("min_samples_leaf = {}".format(deep_tree_clf2.min_samples_leaf), fontsize=14)
-plt.show()
-
-
-
-
-
-
-
np.random.seed(6)
-Xs = np.random.rand(100, 2) - 0.5
-ys = (Xs[:, 0] > 0).astype(np.float32) * 2
-
-angle = np.pi/4
-rotation_matrix = np.array([[np.cos(angle), -np.sin(angle)], [np.sin(angle), np.cos(angle)]])
-Xsr = Xs.dot(rotation_matrix)
-
-tree_clf_s = DecisionTreeClassifier(random_state=42)
-tree_clf_s.fit(Xs, ys)
-tree_clf_sr = DecisionTreeClassifier(random_state=42)
-tree_clf_sr.fit(Xsr, ys)
-
-plt.figure(figsize=(11, 4))
-plt.subplot(121)
-plot_decision_boundary(tree_clf_s, Xs, ys, axes=[-0.7, 0.7, -0.7, 0.7], iris=False)
-plt.subplot(122)
-plot_decision_boundary(tree_clf_sr, Xsr, ys, axes=[-0.7, 0.7, -0.7, 0.7], iris=False)
-
-plt.show()
-
-
-
-
-
-
-
# Quadratic training set + noise
-np.random.seed(42)
-m = 200
-X = np.random.rand(m, 1)
-y = 4 * (X - 0.5) ** 2
-y = y + np.random.randn(m, 1) / 10
-
-
-
-
-
-
-
from sklearn.tree import DecisionTreeRegressor
-
-tree_reg = DecisionTreeRegressor(max_depth=2, random_state=42)
-tree_reg.fit(X, y)
-
-
-
-
-
-
-
from sklearn.tree import DecisionTreeRegressor
-
-tree_reg1 = DecisionTreeRegressor(random_state=42, max_depth=2)
-tree_reg2 = DecisionTreeRegressor(random_state=42, max_depth=3)
-tree_reg1.fit(X, y)
-tree_reg2.fit(X, y)
-
-def plot_regression_predictions(tree_reg, X, y, axes=[0, 1, -0.2, 1], ylabel="$y$"):
-    x1 = np.linspace(axes[0], axes[1], 500).reshape(-1, 1)
-    y_pred = tree_reg.predict(x1)
-    plt.axis(axes)
-    plt.xlabel("$x_1$", fontsize=18)
-    if ylabel:
-        plt.ylabel(ylabel, fontsize=18, rotation=0)
-    plt.plot(X, y, "b.")
-    plt.plot(x1, y_pred, "r.-", linewidth=2, label=r"$\hat{y}$")
-
-plt.figure(figsize=(11, 4))
-plt.subplot(121)
-plot_regression_predictions(tree_reg1, X, y)
-for split, style in ((0.1973, "k-"), (0.0917, "k--"), (0.7718, "k--")):
-    plt.plot([split, split], [-0.2, 1], style, linewidth=2)
-plt.text(0.21, 0.65, "Depth=0", fontsize=15)
-plt.text(0.01, 0.2, "Depth=1", fontsize=13)
-plt.text(0.65, 0.8, "Depth=1", fontsize=13)
-plt.legend(loc="upper center", fontsize=18)
-plt.title("max_depth=2", fontsize=14)
-
-plt.subplot(122)
-plot_regression_predictions(tree_reg2, X, y, ylabel=None)
-for split, style in ((0.1973, "k-"), (0.0917, "k--"), (0.7718, "k--")):
-    plt.plot([split, split], [-0.2, 1], style, linewidth=2)
-for split in (0.0458, 0.1298, 0.2873, 0.9040):
-    plt.plot([split, split], [-0.2, 1], "k:", linewidth=1)
-plt.text(0.3, 0.5, "Depth=2", fontsize=13)
-plt.title("max_depth=3", fontsize=14)
-
-plt.show()
-
-
-
-
-
-
-
tree_reg1 = DecisionTreeRegressor(random_state=42)
-tree_reg2 = DecisionTreeRegressor(random_state=42, min_samples_leaf=10)
-tree_reg1.fit(X, y)
-tree_reg2.fit(X, y)
-
-x1 = np.linspace(0, 1, 500).reshape(-1, 1)
-y_pred1 = tree_reg1.predict(x1)
-y_pred2 = tree_reg2.predict(x1)
-
-plt.figure(figsize=(11, 4))
-
-plt.subplot(121)
-plt.plot(X, y, "b.")
-plt.plot(x1, y_pred1, "r.-", linewidth=2, label=r"$\hat{y}$")
-plt.axis([0, 1, -0.2, 1.1])
-plt.xlabel("$x_1$", fontsize=18)
-plt.ylabel("$y$", fontsize=18, rotation=0)
-plt.legend(loc="upper center", fontsize=18)
-plt.title("No restrictions", fontsize=14)
-
-plt.subplot(122)
-plt.plot(X, y, "b.")
-plt.plot(x1, y_pred2, "r.-", linewidth=2, label=r"$\hat{y}$")
-plt.axis([0, 1, -0.2, 1.1])
-plt.xlabel("$x_1$", fontsize=18)
-plt.title("min_samples_leaf={}".format(tree_reg2.min_samples_leaf), fontsize=14)
-
-plt.show()
-
-
-
-
-
-
-
-

9.7. Pros and cons of trees, pros

-
    -
  • White box, easy to interpret model. Some people believe that decision trees more closely mirror human decision-making than do the regression and classification approaches discussed earlier (think of support vector machines)

  • -
  • Trees are very easy to explain to people. In fact, they are even easier to explain than linear regression!

  • -
  • No feature normalization needed

  • -
  • Tree models can handle both continuous and categorical data (Classification and Regression Trees)

  • -
  • Can model nonlinear relationships

  • -
  • Can model interactions between the different descriptive features

  • -
  • Trees can be displayed graphically, and are easily interpreted even by a non-expert (especially if they are small)

  • -
-
-

9.7.1. Disadvantages

-
    -
  • Unfortunately, trees generally do not have the same level of predictive accuracy as some of the other regression and classification approaches

  • -
  • If continuous features are used the tree may become quite large and hence less interpretable

  • -
  • Decision trees are prone to overfit the training data and hence do not well generalize the data if no stopping criteria or improvements like pruning, boosting or bagging are implemented

  • -
  • Small changes in the data may lead to a completely different tree. This issue can be addressed by using ensemble methods like bagging, boosting or random forests

  • -
  • Unbalanced datasets where some target feature values occur much more frequently than others may lead to biased trees since the frequently occurring feature values are preferred over the less frequently occurring ones.

  • -
  • If the number of features is relatively large (high dimensional) and the number of instances is relatively low, the tree might overfit the data

  • -
  • Features with many levels may be preferred over features with less levels since for them it is more easy to split the dataset such that the sub datasets only contain pure target feature values. This issue can be addressed by preferring for instance the information gain ratio as splitting criteria over information gain

  • -
-

However, by aggregating many decision trees, using methods like -bagging, random forests, and boosting, the predictive performance of -trees can be substantially improved.

-
-
-
- - - - -
- - - - -
-
-
-
-

- - By Morten Hjorth-Jensen
- - © Copyright 2021.
-

-
-
-
- - -
-
- - - - - - \ No newline at end of file diff --git a/doc/LectureNotes/_build/html/chapter7.html b/doc/LectureNotes/_build/html/chapter7.html deleted file mode 100644 index 3e60ddaf5..000000000 --- a/doc/LectureNotes/_build/html/chapter7.html +++ /dev/null @@ -1,1466 +0,0 @@ - - - - - - - - 10. Ensemble Methods: From a Single Tree to Many Trees and Extreme Boosting, Meet the Jungle of Methods — Applied Data Analysis and Machine Learning - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
- - - - - - - - -
- - -
-
- -
- -
-

10. Ensemble Methods: From a Single Tree to Many Trees and Extreme Boosting, Meet the Jungle of Methods

-

As stated previously and seen in many of the examples discussed in the previous chapter about -a single decision tree, we often end up overfitting our training -data. This normally means that we have a high variance. Can we reduce -the variance of a statistical learning method?

-

This leads us to a set of different methods that can combine different -machine learning algorithms or just use one of them to construct -forests and jungles of trees, homogeneous ones or heterogenous -ones. These methods are recognized by different names which we will -try to explain here. These are

-
    -
  1. Voting classifiers

  2. -
  3. Bagging and Pasting

  4. -
  5. Random forests

  6. -
  7. Boosting methods, from adaptive to Extreme Gradient Boosting (XGBoost)

  8. -
-

We discuss these methods here.

-
-

10.1. An Overview of Ensemble Methods

- -
-
-

10.2. Bagging

-

The plain decision trees suffer from high -variance. This means that if we split the training data into two parts -at random, and fit a decision tree to both halves, the results that we -get could be quite different. In contrast, a procedure with low -variance will yield similar results if applied repeatedly to distinct -data sets; linear regression tends to have low variance, if the ratio -of \(n\) to \(p\) is moderately large.

-

Bootstrap aggregation, or just bagging, is a -general-purpose procedure for reducing the variance of a statistical -learning method.

-

Bagging typically results in improved accuracy -over prediction using a single tree. Unfortunately, however, it can be -difficult to interpret the resulting model. Recall that one of the -advantages of decision trees is the attractive and easily interpreted -diagram that results.

-

However, when we bag a large number of trees, it is no longer -possible to represent the resulting statistical learning procedure -using a single tree, and it is no longer clear which variables are -most important to the procedure. Thus, bagging improves prediction -accuracy at the expense of interpretability. Although the collection -of bagged trees is much more difficult to interpret than a single -tree, one can obtain an overall summary of the importance of each -predictor using the MSE (for bagging regression trees) or the Gini -index (for bagging classification trees). In the case of bagging -regression trees, we can record the total amount that the MSE is -decreased due to splits over a given predictor, averaged over all \(B\) possible -trees. A large value indicates an important predictor. Similarly, in -the context of bagging classification trees, we can add up the total -amount that the Gini index is decreased by splits over a given -predictor, averaged over all \(B\) trees.

-
-
-
heads_proba = 0.51
-coin_tosses = (np.random.rand(10000, 10) < heads_proba).astype(np.int32)
-cumulative_heads_ratio = np.cumsum(coin_tosses, axis=0) / np.arange(1, 10001).reshape(-1, 1)
-plt.figure(figsize=(8,3.5))
-plt.plot(cumulative_heads_ratio)
-plt.plot([0, 10000], [0.51, 0.51], "k--", linewidth=2, label="51%")
-plt.plot([0, 10000], [0.5, 0.5], "k-", label="50%")
-plt.xlabel("Number of coin tosses")
-plt.ylabel("Heads ratio")
-plt.legend(loc="lower right")
-plt.axis([0, 10000, 0.42, 0.58])
-save_fig("votingsimple")
-plt.show()
-
-
-
-
-
---------------------------------------------------------------------------
-NameError                                 Traceback (most recent call last)
-<ipython-input-1-eface79dac2c> in <module>
-      1 heads_proba = 0.51
-----> 2 coin_tosses = (np.random.rand(10000, 10) < heads_proba).astype(np.int32)
-      3 cumulative_heads_ratio = np.cumsum(coin_tosses, axis=0) / np.arange(1, 10001).reshape(-1, 1)
-      4 plt.figure(figsize=(8,3.5))
-      5 plt.plot(cumulative_heads_ratio)
-
-NameError: name 'np' is not defined
-
-
-
-
-
-
-
from sklearn.model_selection import train_test_split
-from sklearn.datasets import make_moons
-
-X, y = make_moons(n_samples=500, noise=0.30, random_state=42)
-X_train, X_test, y_train, y_test = train_test_split(X, y, random_state=42)
-
-from sklearn.ensemble import RandomForestClassifier
-from sklearn.ensemble import VotingClassifier
-from sklearn.linear_model import LogisticRegression
-from sklearn.svm import SVC
-
-log_clf = LogisticRegression(solver="liblinear", random_state=42)
-rnd_clf = RandomForestClassifier(n_estimators=10, random_state=42)
-svm_clf = SVC(gamma="auto", random_state=42)
-
-voting_clf = VotingClassifier(
-    estimators=[('lr', log_clf), ('rf', rnd_clf), ('svc', svm_clf)],
-    voting='hard')
-
-voting_clf.fit(X_train, y_train)
-
-from sklearn.metrics import accuracy_score
-
-for clf in (log_clf, rnd_clf, svm_clf, voting_clf):
-    clf.fit(X_train, y_train)
-    y_pred = clf.predict(X_test)
-    print(clf.__class__.__name__, accuracy_score(y_test, y_pred))
-
-log_clf = LogisticRegression(solver="liblinear", random_state=42)
-rnd_clf = RandomForestClassifier(n_estimators=10, random_state=42)
-svm_clf = SVC(gamma="auto", probability=True, random_state=42)
-
-voting_clf = VotingClassifier(
-    estimators=[('lr', log_clf), ('rf', rnd_clf), ('svc', svm_clf)],
-    voting='soft')
-voting_clf.fit(X_train, y_train)
-
-from sklearn.metrics import accuracy_score
-
-for clf in (log_clf, rnd_clf, svm_clf, voting_clf):
-    clf.fit(X_train, y_train)
-    y_pred = clf.predict(X_test)
-    print(clf.__class__.__name__, accuracy_score(y_test, y_pred))
-
-
-
-
-
-
-
from sklearn.model_selection import train_test_split
-from sklearn.datasets import make_moons
-
-X, y = make_moons(n_samples=500, noise=0.30, random_state=42)
-X_train, X_test, y_train, y_test = train_test_split(X, y, random_state=42)
-from sklearn.ensemble import RandomForestClassifier
-from sklearn.ensemble import VotingClassifier
-from sklearn.linear_model import LogisticRegression
-from sklearn.svm import SVC
-
-log_clf = LogisticRegression(random_state=42)
-rnd_clf = RandomForestClassifier(random_state=42)
-svm_clf = SVC(random_state=42)
-
-voting_clf = VotingClassifier(
-    estimators=[('lr', log_clf), ('rf', rnd_clf), ('svc', svm_clf)],
-    voting='hard')
-voting_clf.fit(X_train, y_train)
-
-
-
-
-
-
-
from sklearn.metrics import accuracy_score
-
-for clf in (log_clf, rnd_clf, svm_clf, voting_clf):
-    clf.fit(X_train, y_train)
-    y_pred = clf.predict(X_test)
-    print(clf.__class__.__name__, accuracy_score(y_test, y_pred))
-
-
-
-
-
-
-
log_clf = LogisticRegression(random_state=42)
-rnd_clf = RandomForestClassifier(random_state=42)
-svm_clf = SVC(probability=True, random_state=42)
-
-voting_clf = VotingClassifier(
-    estimators=[('lr', log_clf), ('rf', rnd_clf), ('svc', svm_clf)],
-    voting='soft')
-voting_clf.fit(X_train, y_train)
-
-
-
-
-
-
-
from sklearn.metrics import accuracy_score
-
-for clf in (log_clf, rnd_clf, svm_clf, voting_clf):
-    clf.fit(X_train, y_train)
-    y_pred = clf.predict(X_test)
-    print(clf.__class__.__name__, accuracy_score(y_test, y_pred))
-
-
-
-
-
-
-

10.3. Bagging Examples

-
-
-
from sklearn.ensemble import BaggingClassifier
-from sklearn.tree import DecisionTreeClassifier
-
-bag_clf = BaggingClassifier(
-    DecisionTreeClassifier(random_state=42), n_estimators=500,
-    max_samples=100, bootstrap=True, n_jobs=-1, random_state=42)
-bag_clf.fit(X_train, y_train)
-y_pred = bag_clf.predict(X_test)
-
-
-
-
-
-
-
from sklearn.metrics import accuracy_score
-print(accuracy_score(y_test, y_pred))
-
-
-
-
-
-
-
tree_clf = DecisionTreeClassifier(random_state=42)
-tree_clf.fit(X_train, y_train)
-y_pred_tree = tree_clf.predict(X_test)
-print(accuracy_score(y_test, y_pred_tree))
-
-
-
-
-
-
-
%matplotlib inline
-
-from matplotlib.colors import ListedColormap
-
-def plot_decision_boundary(clf, X, y, axes=[-1.5, 2.5, -1, 1.5], alpha=0.5, contour=True):
-    x1s = np.linspace(axes[0], axes[1], 100)
-    x2s = np.linspace(axes[2], axes[3], 100)
-    x1, x2 = np.meshgrid(x1s, x2s)
-    X_new = np.c_[x1.ravel(), x2.ravel()]
-    y_pred = clf.predict(X_new).reshape(x1.shape)
-    custom_cmap = ListedColormap(['#fafab0','#9898ff','#a0faa0'])
-    plt.contourf(x1, x2, y_pred, alpha=0.3, cmap=custom_cmap)
-    if contour:
-        custom_cmap2 = ListedColormap(['#7d7d58','#4c4c7f','#507d50'])
-        plt.contour(x1, x2, y_pred, cmap=custom_cmap2, alpha=0.8)
-    plt.plot(X[:, 0][y==0], X[:, 1][y==0], "yo", alpha=alpha)
-    plt.plot(X[:, 0][y==1], X[:, 1][y==1], "bs", alpha=alpha)
-    plt.axis(axes)
-    plt.xlabel(r"$x_1$", fontsize=18)
-    plt.ylabel(r"$x_2$", fontsize=18, rotation=0)
-plt.figure(figsize=(11,4))
-plt.subplot(121)
-plot_decision_boundary(tree_clf, X, y)
-plt.title("Decision Tree", fontsize=14)
-plt.subplot(122)
-plot_decision_boundary(bag_clf, X, y)
-plt.title("Decision Trees with Bagging", fontsize=14)
-save_fig("baggingtree")
-plt.show()
-
-
-
-
-
-

10.3.1. Making your own Bootstrap: Changing the Level of the Decision Tree

-

Let us bring up our good old boostrap example from the linear regression lectures. We change the linerar regression algorithm with -a decision tree wth different depths and perform a bootstrap aggregate (in this case we perform as many bootstraps as data points \(n\)).

-
-
-
import matplotlib.pyplot as plt
-import numpy as np
-from sklearn.model_selection import train_test_split
-from sklearn.pipeline import make_pipeline
-from sklearn.utils import resample
-from sklearn.tree import DecisionTreeRegressor
-
-n = 100
-n_boostraps = 100
-maxdepth = 8
-
-# Make data set.
-x = np.linspace(-3, 3, n).reshape(-1, 1)
-y = np.exp(-x**2) + 1.5 * np.exp(-(x-2)**2)+ np.random.normal(0, 0.1, x.shape)
-error = np.zeros(maxdepth)
-bias = np.zeros(maxdepth)
-variance = np.zeros(maxdepth)
-polydegree = np.zeros(maxdepth)
-X_train, X_test, y_train, y_test = train_test_split(x, y, test_size=0.2)
-
-from sklearn.preprocessing import StandardScaler
-scaler = StandardScaler()
-scaler.fit(X_train)
-X_train_scaled = scaler.transform(X_train)
-X_test_scaled = scaler.transform(X_test)
-
-# we produce a simple tree first as benchmark
-simpletree = DecisionTreeRegressor(max_depth=3) 
-simpletree.fit(X_train_scaled, y_train)
-simpleprediction = simpletree.predict(X_test_scaled)
-for degree in range(1,maxdepth):
-    model = DecisionTreeRegressor(max_depth=degree) 
-    y_pred = np.empty((y_test.shape[0], n_boostraps))
-    for i in range(n_boostraps):
-        x_, y_ = resample(X_train_scaled, y_train)
-        model.fit(x_, y_)
-        y_pred[:, i] = model.predict(X_test_scaled)#.ravel()
-
-    polydegree[degree] = degree
-    error[degree] = np.mean( np.mean((y_test - y_pred)**2, axis=1, keepdims=True) )
-    bias[degree] = np.mean( (y_test - np.mean(y_pred, axis=1, keepdims=True))**2 )
-    variance[degree] = np.mean( np.var(y_pred, axis=1, keepdims=True) )
-    print('Polynomial degree:', degree)
-    print('Error:', error[degree])
-    print('Bias^2:', bias[degree])
-    print('Var:', variance[degree])
-    print('{} >= {} + {} = {}'.format(error[degree], bias[degree], variance[degree], bias[degree]+variance[degree]))
- 
-mse_simpletree= np.mean( np.mean((y_test - simpleprediction)**2)
-print(mse_simpletree)
-plt.xlim(1,maxdepth)
-plt.plot(polydegree, error, label='MSE')
-plt.plot(polydegree, bias, label='bias')
-plt.plot(polydegree, variance, label='Variance')
-plt.legend()
-save_fig("baggingboot")
-plt.show()
-
-
-
-
-
-
-
-

10.4. Random forests

-

Random forests provide an improvement over bagged trees by way of a -small tweak that decorrelates the trees.

-

As in bagging, we build a -number of decision trees on bootstrapped training samples. But when -building these decision trees, each time a split in a tree is -considered, a random sample of \(m\) predictors is chosen as split -candidates from the full set of \(p\) predictors. The split is allowed to -use only one of those \(m\) predictors.

-

A fresh sample of \(m\) predictors is -taken at each split, and typically we choose

-
-\[ -m\approx \sqrt{p}. -\]
-

In building a random forest, at -each split in the tree, the algorithm is not even allowed to consider -a majority of the available predictors.

-

The reason for this is rather clever. Suppose that there is one very -strong predictor in the data set, along with a number of other -moderately strong predictors. Then in the collection of bagged -variable importance random forest trees, most or all of the trees will -use this strong predictor in the top split. Consequently, all of the -bagged trees will look quite similar to each other. Hence the -predictions from the bagged trees will be highly correlated. -Unfortunately, averaging many highly correlated quantities does not -lead to as large of a reduction in variance as averaging many -uncorrelated quantities. In particular, this means that bagging will -not lead to a substantial reduction in variance over a single tree in -this setting.

-

The algorithm described here can be applied to both classification and regression problems.

-

We will grow of forest of say \(B\) trees.

-
    -
  1. For \(b=1:B\)

  2. -
-
    -
  • Draw a bootstrap sample from the training data organized in our \(\boldsymbol{X}\) matrix.

  • -
  • We grow then a random forest tree \(T_b\) based on the bootstrapped data by repeating the steps outlined till we reach the maximum node size is reached

  • -
-
    -
  1. we select \(m \le p\) variables at random from the \(p\) predictors/features

  2. -
  3. pick the best split point among the \(m\) features using for example the CART algorithm and create a new node

  4. -
  5. split the node into daughter nodes

  6. -
  7. Output then the ensemble of trees \(\{T_b\}_1^{B}\) and make predictions for either a regression type of problem or a classification type of problem.

  8. -
-
-
-
import matplotlib.pyplot as plt
-import numpy as np
-from sklearn.model_selection import  train_test_split 
-from sklearn.datasets import load_breast_cancer
-from sklearn.svm import SVC
-from sklearn.linear_model import LogisticRegression
-from sklearn.tree import DecisionTreeClassifier
-from sklearn.ensemble import BaggingClassifier
-
-# Load the data
-cancer = load_breast_cancer()
-
-X_train, X_test, y_train, y_test = train_test_split(cancer.data,cancer.target,random_state=0)
-print(X_train.shape)
-print(X_test.shape)
-# Logistic Regression
-logreg = LogisticRegression(solver='lbfgs')
-logreg.fit(X_train, y_train)
-print("Test set accuracy with Logistic Regression: {:.2f}".format(logreg.score(X_test,y_test)))
-# Support vector machine
-svm = SVC(gamma='auto', C=100)
-svm.fit(X_train, y_train)
-print("Test set accuracy with SVM: {:.2f}".format(svm.score(X_test,y_test)))
-# Decision Trees
-deep_tree_clf = DecisionTreeClassifier(max_depth=None)
-deep_tree_clf.fit(X_train, y_train)
-print("Test set accuracy with Decision Trees: {:.2f}".format(deep_tree_clf.score(X_test,y_test)))
-#now scale the data
-from sklearn.preprocessing import StandardScaler
-scaler = StandardScaler()
-scaler.fit(X_train)
-X_train_scaled = scaler.transform(X_train)
-X_test_scaled = scaler.transform(X_test)
-# Logistic Regression
-logreg.fit(X_train_scaled, y_train)
-print("Test set accuracy Logistic Regression with scaled data: {:.2f}".format(logreg.score(X_test_scaled,y_test)))
-# Support Vector Machine
-svm.fit(X_train_scaled, y_train)
-print("Test set accuracy SVM with scaled data: {:.2f}".format(logreg.score(X_test_scaled,y_test)))
-# Decision Trees
-deep_tree_clf.fit(X_train_scaled, y_train)
-print("Test set accuracy with Decision Trees and scaled data: {:.2f}".format(deep_tree_clf.score(X_test_scaled,y_test)))
-
-
-from sklearn.ensemble import RandomForestClassifier
-from sklearn.preprocessing import LabelEncoder
-from sklearn.model_selection import cross_validate
-# Data set not specificied
-#Instantiate the model with 500 trees and entropy as splitting criteria
-Random_Forest_model = RandomForestClassifier(n_estimators=500,criterion="entropy")
-Random_Forest_model.fit(X_train_scaled, y_train)
-#Cross validation
-accuracy = cross_validate(Random_Forest_model,X_test_scaled,y_test,cv=10)['test_score']
-print(accuracy)
-print("Test set accuracy with Random Forests and scaled data: {:.2f}".format(Random_Forest_model.score(X_test_scaled,y_test)))
-
-
-import scikitplot as skplt
-y_pred = Random_Forest_model.predict(X_test_scaled)
-skplt.metrics.plot_confusion_matrix(y_test, y_pred, normalize=True)
-plt.show()
-y_probas = Random_Forest_model.predict_proba(X_test_scaled)
-skplt.metrics.plot_roc(y_test, y_probas)
-plt.show()
-skplt.metrics.plot_cumulative_gain(y_test, y_probas)
-plt.show()
-
-
-
-
-

Recall that the cumulative gains curve shows the percentage of the -overall number of cases in a given category gained by targeting a -percentage of the total number of cases.

-

Similarly, the receiver operating characteristic curve, or ROC curve, -displays the diagnostic ability of a binary classifier system as its -discrimination threshold is varied. It plots the true positive rate against the false positive rate.

-
-

10.4.1. Compare Bagging on Trees with Random Forests

-
-
-
bag_clf = BaggingClassifier(
-    DecisionTreeClassifier(splitter="random", max_leaf_nodes=16, random_state=42),
-    n_estimators=500, max_samples=1.0, bootstrap=True, n_jobs=-1, random_state=42)
-
-
-
-
-
-
-
bag_clf.fit(X_train, y_train)
-y_pred = bag_clf.predict(X_test)
-from sklearn.ensemble import RandomForestClassifier
-rnd_clf = RandomForestClassifier(n_estimators=500, max_leaf_nodes=16, n_jobs=-1, random_state=42)
-rnd_clf.fit(X_train, y_train)
-y_pred_rf = rnd_clf.predict(X_test)
-np.sum(y_pred == y_pred_rf) / len(y_pred)
-
-
-
-
-
-
-
-

10.5. Boosting, a Bird’s Eye View

-

The basic idea is to combine weak classifiers in order to create a good -classifier. With a weak classifier we often intend a classifier which -produces results which are only slightly better than we would get by -random guesses.

-

This is done by applying in an iterative way a weak (or a standard -classifier like decision trees) to modify the data. In each iteration -we emphasize those observations which are misclassified by weighting -them with a factor.

-

Boosting is a way of fitting an additive expansion in a set of -elementary basis functions like for example some simple polynomials. -Assume for example that we have a function

-
-\[ -f_M(x) = \sum_{i=1}^M \beta_m b(x;\gamma_m), -\]
-

where \(\beta_m\) are the expansion parameters to be determined in a -minimization process and \(b(x;\gamma_m)\) are some simple functions of -the multivariable parameter \(x\) which is characterized by the -parameters \(\gamma_m\).

-

As an example, consider the Sigmoid function we used in logistic -regression. In that case, we can translate the function -\(b(x;\gamma_m)\) into the Sigmoid function

-
-\[ -\sigma(t) = \frac{1}{1+\exp{(-t)}}, -\]
-

where \(t=\gamma_0+\gamma_1 x\) and the parameters \(\gamma_0\) and -\(\gamma_1\) were determined by the Logistic Regression fitting -algorithm.

-

As another example, consider the cost function we defined for linear regression

-
-\[ -C(\boldsymbol{y},\boldsymbol{f}) = \frac{1}{n} \sum_{i=0}^{n-1}(y_i-f(x_i))^2. -\]
-

In this case the function \(f(x)\) was replaced by the design matrix -\(\boldsymbol{X}\) and the unknown linear regression parameters \(\boldsymbol{\beta}\), -that is \(\boldsymbol{f}=\boldsymbol{X}\boldsymbol{\beta}\). In linear regression we can -simply invert a matrix and obtain the parameters \(\beta\) by

-
-\[ -\boldsymbol{\beta}=\left(\boldsymbol{X}^T\boldsymbol{X}\right)^{-1}\boldsymbol{X}^T\boldsymbol{y}. -\]
-

In iterative fitting or additive modeling, we minimize the cost function with respect to the parameters \(\beta_m\) and \(\gamma_m\).

-
-

10.5.1. Iterative Fitting, Regression and Squared-error Cost Function

-

The way we proceed is as follows (here we specialize to the squared-error cost function)

-
    -
  1. Establish a cost function, here \(\cal{C}(\boldsymbol{y},\boldsymbol{f}) = \frac{1}{n} \sum_{i=0}^{n-1}(y_i-f_M(x_i))^2\) with \(f_M(x) = \sum_{i=1}^M \beta_m b(x;\gamma_m)\).

  2. -
  3. Initialize with a guess \(f_0(x)\). It could be one or even zero or some random numbers.

  4. -
  5. For \(m=1:M\)

  6. -
-

a. minimize \(\sum_{i=0}^{n-1}(y_i-f_{m-1}(x_i)-\beta b(x;\gamma))^2\) wrt \(\gamma\) and \(\beta\)

-

b. This gives the optimal values \(\beta_m\) and \(\gamma_m\)

-

c. Determine then the new values \(f_m(x)=f_{m-1}(x) +\beta_m b(x;\gamma_m)\)

-

We could use any of the algorithms we have discussed till now. If we -use trees, \(\gamma\) parameterizes the split variables and split points -at the internal nodes, and the predictions at the terminal nodes.

-

To better understand what happens, let us develop the steps for the iterative fitting using the above squared error function.

-

For simplicity we assume also that our functions \(b(x;\gamma)=1+\gamma x\).

-

This means that for every iteration \(m\), we need to optimize

-
-\[ -(\beta_m,\gamma_m) = \mathrm{argmin}_{\beta,\lambda}\hspace{0.1cm} \sum_{i=0}^{n-1}(y_i-f_{m-1}(x_i)-\beta b(x;\gamma))^2=\sum_{i=0}^{n-1}(y_i-f_{m-1}(x_i)-\beta(1+\gamma x_i))^2. -\]
-

We start our iteration by simply setting \(f_0(x)=0\). -Taking the derivatives with respect to \(\beta\) and \(\gamma\) we obtain

-
-\[ -\frac{\partial \cal{C}}{\partial \beta} = -2\sum_{i}(1+\gamma x_i)(y_i-\beta(1+\gamma x_i))=0, -\]
-

and

-
-\[ -\frac{\partial \cal{C}}{\partial \gamma} =-2\sum_{i}\beta x_i(y_i-\beta(1+\gamma x_i))=0. -\]
-

We can then rewrite these equations as (defining \(\boldsymbol{w}=\boldsymbol{e}+\gamma \boldsymbol{x})\) with \(\boldsymbol{e}\) being the unit vector)

-
-\[ -\gamma \boldsymbol{w}^T(\boldsymbol{y}-\beta\gamma \boldsymbol{w})=0, -\]
-

which gives us \(\beta = \boldsymbol{w}^T\boldsymbol{y}/(\boldsymbol{w}^T\boldsymbol{w})\). Similarly we have

-
-\[ -\beta\gamma \boldsymbol{x}^T(\boldsymbol{y}-\beta(1+\gamma \boldsymbol{x}))=0, -\]
-

which leads to \(\gamma =(\boldsymbol{x}^T\boldsymbol{y}-\beta\boldsymbol{x}^T\boldsymbol{e})/(\beta\boldsymbol{x}^T\boldsymbol{x})\). Inserting -for \(\beta\) gives us an equation for \(\gamma\). This is a non-linear equation in the unknown \(\gamma\) and has to be solved numerically.

-

The solution to these two equations gives us in turn \(\beta_1\) and \(\gamma_1\) leading to the new expression for \(f_1(x)\) as -\(f_1(x) = \beta_1(1+\gamma_1x)\). Doing this \(M\) times results in our final estimate for the function \(f\).

-
-
-

10.5.2. Iterative Fitting, Classification and AdaBoost

-

Let us consider a binary classification problem with two outcomes \(y_i \in \{-1,1\}\) and \(i=0,1,2,\dots,n-1\) as our set of -observations. We define a classification function \(G(x)\) which produces a prediction taking one or the other of the two values -\(\{-1,1\}\).

-

The error rate of the training sample is then

-
-\[ -\mathrm{\overline{err}}=\frac{1}{n} \sum_{i=0}^{n-1} I(y_i\ne G(x_i)). -\]
-

The iterative procedure starts with defining a weak classifier whose -error rate is barely better than random guessing. The iterative -procedure in boosting is to sequentially apply a weak -classification algorithm to repeatedly modified versions of the data -producing a sequence of weak classifiers \(G_m(x)\).

-

Here we will express our function \(f(x)\) in terms of \(G(x)\). That is

-
-\[ -f_M(x) = \sum_{i=1}^M \beta_m b(x;\gamma_m), -\]
-

will be a function of

-
-\[ -G_M(x) = \mathrm{sign} \sum_{i=1}^M \alpha_m G_m(x). -\]
-

In our iterative procedure we define thus

-
-\[ -f_m(x) = f_{m-1}(x)+\beta_mG_m(x). -\]
-

The simplest possible cost function which leads (also simple from a computational point of view) to the AdaBoost algorithm is the -exponential cost/loss function defined as

-
-\[ -C(\boldsymbol{y},\boldsymbol{f}) = \sum_{i=0}^{n-1}\exp{(-y_i(f_{m-1}(x_i)+\beta G(x_i))}. -\]
-

We optimize \(\beta\) and \(G\) for each value of \(m=1:M\) as we did in the regression case. -This is normally done in two steps. Let us however first rewrite the cost function as

-
-\[ -C(\boldsymbol{y},\boldsymbol{f}) = \sum_{i=0}^{n-1}w_i^{m}\exp{(-y_i\beta G(x_i))}, -\]
-

where we have defined \(w_i^m= \exp{(-y_if_{m-1}(x_i))}\).

-

First, for any \(\beta > 0\), we optimize \(G\) by setting

-
-\[ -G_m(x) = \mathrm{sign} \sum_{i=0}^{n-1} w_i^m I(y_i \ne G_(x_i)), -\]
-

which is the classifier that minimizes the weighted error rate in predicting \(y\).

-

We can do this by rewriting

-
-\[ -\exp{-(\beta)}\sum_{y_i=G(x_i)}w_i^m+\exp{(\beta)}\sum_{y_i\ne G(x_i)}w_i^m, -\]
-

which can be rewritten as

-
-\[ -(\exp{(\beta)}-\exp{-(\beta)})\sum_{i=0}^{n-1}w_i^mI(y_i\ne G(x_i))+\exp{(-\beta)}\sum_{i=0}^{n-1}w_i^m=0, -\]
-

which leads to

-
-\[ -\beta_m = \frac{1}{2}\log{\frac{1-\mathrm{\overline{err}}}{\mathrm{\overline{err}}}}, -\]
-

where we have redefined the error as

-
-\[ -\mathrm{\overline{err}}_m=\frac{1}{n}\frac{\sum_{i=0}^{n-1}w_i^mI(y_i\ne G(x_i)}{\sum_{i=0}^{n-1}w_i^m}, -\]
-

which leads to an update of

-
-\[ -f_m(x) = f_{m-1}(x) +\beta_m G_m(x). -\]
-

This leads to the new weights

-
-\[ -w_i^{m+1} = w_i^m \exp{(-y_i\beta_m G_m(x_i))} -\]
-
-
-

10.5.3. Adaptive boosting: AdaBoost, Basic Algorithm

-

The algorithm here is rather straightforward. Assume that our weak -classifier is a decision tree and we consider a binary set of outputs -with \(y_i \in \{-1,1\}\) and \(i=0,1,2,\dots,n-1\) as our set of -observations. Our design matrix is given in terms of the -feature/predictor vectors -\(\boldsymbol{X}=[\boldsymbol{x}_0\boldsymbol{x}_1\dots\boldsymbol{x}_{p-1}]\). Finally, we define also a -classifier determined by our data via a function \(G(x)\). This function tells us how well we are able to classify our outputs/targets \(\boldsymbol{y}\).

-

We have already defined the misclassification error \(\mathrm{err}\) as

-
-\[ -\mathrm{err}=\frac{1}{n}\sum_{i=0}^{n-1}I(y_i\ne G(x_i)), -\]
-

where the function \(I()\) is one if we misclassify and zero if we classify correctly.

-

With the above definitions we are now ready to set up the algorithm for AdaBoost. -The basic idea is to set up weights which will be used to scale the correctly classified and the misclassified cases.

-
    -
  1. We start by initializing all weights to \(w_i = 1/n\), with \(i=0,1,2,\dots n-1\). It is easy to see that we must have \(\sum_{i=0}^{n-1}w_i = 1\).

  2. -
  3. We rewrite the misclassification error as

  4. -
-
-\[ -\mathrm{\overline{err}}_m=\frac{\sum_{i=0}^{n-1}w_i^m I(y_i\ne G(x_i))}{\sum_{i=0}^{n-1}w_i}, -\]
-
    -
  1. Then we start looping over all attempts at classifying, namely we start an iterative process for \(m=1:M\), where \(M\) is the final number of classifications. Our given classifier could for example be a plain decision tree.

  2. -
-

a. Fit then a given classifier to the training set using the weights \(w_i\).

-

b. Compute then \(\mathrm{err}\) and figure out which events are classified properly and which are classified wrongly.

-

c. Define a quantity \(\alpha_{m} = \log{(1-\mathrm{\overline{err}}_m)/\mathrm{\overline{err}}_m}\)

-

d. Set the new weights to \(w_i = w_i\times \exp{(\alpha_m I(y_i\ne G(x_i)}\).

-
    -
  1. Compute the new classifier \(G(x)= \sum_{i=0}^{n-1}\alpha_m I(y_i\ne G(x_i)\).

  2. -
-

For the iterations with \(m \le 2\) the weights are modified -individually at each steps. The observations which were misclassified -at iteration \(m-1\) have a weight which is larger than those which were -classified properly. As this proceeds, the observations which were -difficult to classifiy correctly are given a larger influence. Each -new classification step \(m\) is then forced to concentrate on those -observations that are missed in the previous iterations.

-

Using Scikit-Learn it is easy to apply the adaptive boosting algorithm, as done here.

-
-
-
from sklearn.ensemble import AdaBoostClassifier
-
-ada_clf = AdaBoostClassifier(
-    DecisionTreeClassifier(max_depth=1), n_estimators=200,
-    algorithm="SAMME.R", learning_rate=0.5, random_state=42)
-ada_clf.fit(X_train, y_train)
-
-from sklearn.ensemble import AdaBoostClassifier
-
-ada_clf = AdaBoostClassifier(
-    DecisionTreeClassifier(max_depth=1), n_estimators=200,
-    algorithm="SAMME.R", learning_rate=0.5, random_state=42)
-ada_clf.fit(X_train_scaled, y_train)
-y_pred = ada_clf.predict(X_test_scaled)
-skplt.metrics.plot_confusion_matrix(y_test, y_pred, normalize=True)
-plt.show()
-y_probas = ada_clf.predict_proba(X_test_scaled)
-skplt.metrics.plot_roc(y_test, y_probas)
-plt.show()
-skplt.metrics.plot_cumulative_gain(y_test, y_probas)
-plt.show()
-
-
-
-
-
-
-
-

10.6. Gradient boosting: Basics with Steepest Descent/Functional Gradient Descent

-

Gradient boosting is again a similar technique to Adaptive boosting, -it combines so-called weak classifiers or regressors into a strong -method via a series of iterations.

-

In order to understand the method, let us illustrate its basics by -bringing back the essential steps in linear regression, where our cost -function was the least squares function.

-

We start again with our cost function \(\cal{C}(\boldsymbol{y}m\boldsymbol{f})=\sum_{i=0}^{n-1}\cal{L}(y_i, f(x_i))\) where we want to minimize -This means that for every iteration, we need to optimize

-
-\[ -(\hat{\boldsymbol{f}}) = \mathrm{argmin}_{\boldsymbol{f}}\hspace{0.1cm} \sum_{i=0}^{n-1}(y_i-f(x_i))^2. -\]
-

We define a real function \(h_m(x)\) that defines our final function \(f_M(x)\) as

-
-\[ -f_M(x) = \sum_{m=0}^M h_m(x). -\]
-

In the steepest decent approach we approximate \(h_m(x) = -\rho_m g_m(x)\), where \(\rho_m\) is a scalar and \(g_m(x)\) the gradient defined as

-
-\[ -g_m(x_i) = \left[ \frac{\partial \cal{L}(y_i, f(x_i))}{\partial f(x_i)}\right]_{f(x_i)=f_{m-1}(x_i)}. -\]
-

With the new gradient we can update \(f_m(x) = f_{m-1}(x) -\rho_m g_m(x)\). Using the above squared-error function we see that -the gradient is \(g_m(x_i) = -2(y_i-f(x_i))\).

-

Choosing \(f_0(x)=0\) we obtain \(g_m(x) = -2y_i\) and inserting this into the minimization problem for the cost function we have

-
-\[ -(\rho_1) = \mathrm{argmin}_{\rho}\hspace{0.1cm} \sum_{i=0}^{n-1}(y_i+2\rho y_i)^2. -\]
-

Optimizing with respect to \(\rho\) we obtain (taking the derivative) that \(\rho_1 = -1/2\). We have then that

-
-\[ -f_1(x) = f_{0}(x) -\rho_1 g_1(x)=-y_i. -\]
-

We can then proceed and compute

-
-\[ -g_2(x_i) = \left[ \frac{\partial \cal{L}(y_i, f(x_i))}{\partial f(x_i)}\right]_{f(x_i)=f_{1}(x_i)=y_i}=-4y_i, -\]
-

and find a new value for \(\rho_2=-1/2\) and continue till we have reached \(m=M\). We can modify the steepest descent method, or steepest boosting, by introducing what is called gradient boosting.

-

Steepest descent is however not much used, since it only optimizes \(f\) at a fixed set of \(n\) points, -so we do not learn a function that can generalize. However, we can modify the algorithm by -fitting a weak learner to approximate the negative gradient signal.

-

Suppose we have a cost function \(C(f)=\sum_{i=0}^{n-1}L(y_i, f(x_i))\) where \(y_i\) is our target and \(f(x_i)\) the function which is meant to model \(y_i\). The above cost function could be our standard squared-error function

-
-\[ -C(\boldsymbol{y},\boldsymbol{f})=\sum_{i=0}^{n-1}(y_i-f(x_i))^2. -\]
-

The way we proceed in an iterative fashion is to

-
    -
  1. Initialize our estimate \(f_0(x)\).

  2. -
  3. For \(m=1:M\), we

  4. -
-

a. compute the negative gradient vector \(\boldsymbol{u}_m = -\partial C(\boldsymbol{y},\boldsymbol{f})/\partial \boldsymbol{f}(x)\) at \(f(x) = f_{m-1}(x)\);

-

b. fit the so-called base-learner to the negative gradient \(h_m(u_m,x)\);

-

c. update the estimate \(f_m(x) = f_{m-1}(x)+h_m(u_m,x)\);

-
    -
  1. The final estimate is then \(f_M(x) = \sum_{m=1}^M h_m(u_m,x)\).

  2. -
-
-
-

10.7. Gradient Boosting, Examples of Regression

-
-
-
import matplotlib.pyplot as plt
-import numpy as np
-from sklearn.model_selection import train_test_split
-from sklearn.ensemble import GradientBoostingRegressor
-from sklearn.preprocessing import StandardScaler
-import scikitplot as skplt
-from sklearn.metrics import mean_squared_error
-
-n = 100
-maxdegree = 6
-
-# Make data set.
-x = np.linspace(-3, 3, n).reshape(-1, 1)
-y = np.exp(-x**2) + 1.5 * np.exp(-(x-2)**2)+ np.random.normal(0, 0.1, x.shape)
-
-error = np.zeros(maxdegree)
-bias = np.zeros(maxdegree)
-variance = np.zeros(maxdegree)
-polydegree = np.zeros(maxdegree)
-X_train, X_test, y_train, y_test = train_test_split(x, y, test_size=0.2)
-scaler = StandardScaler()
-scaler.fit(X_train)
-X_train_scaled = scaler.transform(X_train)
-X_test_scaled = scaler.transform(X_test)
-
-for degree in range(1,maxdegree):
-    model = GradientBoostingRegressor(max_depth=degree, n_estimators=100, learning_rate=1.0)  
-    model.fit(X_train_scaled,y_train)
-    y_pred = model.predict(X_test_scaled)
-    polydegree[degree] = degree
-    error[degree] = np.mean( np.mean((y_test - y_pred)**2) )
-    bias[degree] = np.mean( (y_test - np.mean(y_pred))**2 )
-    variance[degree] = np.mean( np.var(y_pred) )
-    print('Max depth:', degree)
-    print('Error:', error[degree])
-    print('Bias^2:', bias[degree])
-    print('Var:', variance[degree])
-    print('{} >= {} + {} = {}'.format(error[degree], bias[degree], variance[degree], bias[degree]+variance[degree]))
-
-plt.xlim(1,maxdegree-1)
-plt.plot(polydegree, error, label='Error')
-plt.plot(polydegree, bias, label='bias')
-plt.plot(polydegree, variance, label='Variance')
-plt.legend()
-save_fig("gdregression")
-plt.show()
-
-
-
-
-
-
-

10.8. Gradient Boosting, Classification Example

-
-
-
import matplotlib.pyplot as plt
-import numpy as np
-from sklearn.model_selection import  train_test_split 
-from sklearn.datasets import load_breast_cancer
-import scikitplot as skplt
-from sklearn.ensemble import GradientBoostingClassifier
-from sklearn.model_selection import cross_validate
-
-# Load the data
-cancer = load_breast_cancer()
-
-X_train, X_test, y_train, y_test = train_test_split(cancer.data,cancer.target,random_state=0)
-print(X_train.shape)
-print(X_test.shape)
-#now scale the data
-from sklearn.preprocessing import StandardScaler
-scaler = StandardScaler()
-scaler.fit(X_train)
-X_train_scaled = scaler.transform(X_train)
-X_test_scaled = scaler.transform(X_test)
-
-gd_clf = GradientBoostingClassifier(max_depth=3, n_estimators=100, learning_rate=1.0)  
-gd_clf.fit(X_train_scaled, y_train)
-#Cross validation
-accuracy = cross_validate(gd_clf,X_test_scaled,y_test,cv=10)['test_score']
-print(accuracy)
-print("Test set accuracy with Random Forests and scaled data: {:.2f}".format(gd_clf.score(X_test_scaled,y_test)))
-
-import scikitplot as skplt
-y_pred = gd_clf.predict(X_test_scaled)
-skplt.metrics.plot_confusion_matrix(y_test, y_pred, normalize=True)
-save_fig("gdclassiffierconfusion")
-plt.show()
-y_probas = gd_clf.predict_proba(X_test_scaled)
-skplt.metrics.plot_roc(y_test, y_probas)
-save_fig("gdclassiffierroc")
-plt.show()
-skplt.metrics.plot_cumulative_gain(y_test, y_probas)
-save_fig("gdclassiffiercgain")
-plt.show()
-
-
-
-
-
-
-

10.9. XGBoost: Extreme Gradient Boosting

-

XGBoost or Extreme Gradient -Boosting, is an optimized distributed gradient boosting library -designed to be highly efficient, flexible and portable. It implements -machine learning algorithms under the Gradient Boosting -framework. XGBoost provides a parallel tree boosting that solve many -data science problems in a fast and accurate way. See the article by Chen and Guestrin.

-

The authors design and build a highly scalable end-to-end tree -boosting system. It has a theoretically justified weighted quantile -sketch for efficient proposal calculation. It introduces a novel sparsity-aware algorithm for parallel tree learning and an effective cache-aware block structure for out-of-core tree learning.

-

It is now the algorithm which wins essentially all ML competitions!!!

-
-
-

10.10. Regression Case

-
-
-
import matplotlib.pyplot as plt
-import numpy as np
-from sklearn.model_selection import train_test_split
-import xgboost as xgb
-from sklearn.preprocessing import StandardScaler
-import scikitplot as skplt
-from sklearn.metrics import mean_squared_error
-
-n = 100
-maxdegree = 6
-
-# Make data set.
-x = np.linspace(-3, 3, n).reshape(-1, 1)
-y = np.exp(-x**2) + 1.5 * np.exp(-(x-2)**2)+ np.random.normal(0, 0.1, x.shape)
-
-error = np.zeros(maxdegree)
-bias = np.zeros(maxdegree)
-variance = np.zeros(maxdegree)
-polydegree = np.zeros(maxdegree)
-X_train, X_test, y_train, y_test = train_test_split(x, y, test_size=0.2)
-scaler = StandardScaler()
-scaler.fit(X_train)
-X_train_scaled = scaler.transform(X_train)
-X_test_scaled = scaler.transform(X_test)
-
-for degree in range(maxdegree):
-    model =  xgb.XGBRegressor(objective ='reg:squarederror', colsaobjective ='reg:squarederror', colsample_bytree = 0.3, learning_rate = 0.1,max_depth = degree, alpha = 10, n_estimators = 200)
-
-    model.fit(X_train_scaled,y_train)
-    y_pred = model.predict(X_test_scaled)
-    polydegree[degree] = degree
-    error[degree] = np.mean( np.mean((y_test - y_pred)**2) )
-    bias[degree] = np.mean( (y_test - np.mean(y_pred))**2 )
-    variance[degree] = np.mean( np.var(y_pred) )
-    print('Max depth:', degree)
-    print('Error:', error[degree])
-    print('Bias^2:', bias[degree])
-    print('Var:', variance[degree])
-    print('{} >= {} + {} = {}'.format(error[degree], bias[degree], variance[degree], bias[degree]+variance[degree]))
-
-plt.xlim(1,maxdegree-1)
-plt.plot(polydegree, error, label='Error')
-plt.plot(polydegree, bias, label='bias')
-plt.plot(polydegree, variance, label='Variance')
-plt.legend()
-plt.show()
-
-
-
-
-

As you will see from the confusion matrix below, XGBoots does an excellent job on the Wisconsin cancer data and outperforms essentially all agorithms we have discussed till now.

-
-
-
import matplotlib.pyplot as plt
-import numpy as np
-from sklearn.model_selection import  train_test_split 
-from sklearn.datasets import load_breast_cancer
-from sklearn.preprocessing import LabelEncoder
-from sklearn.model_selection import cross_validate
-import scikitplot as skplt
-import xgboost as xgb
-# Load the data
-cancer = load_breast_cancer()
-
-X_train, X_test, y_train, y_test = train_test_split(cancer.data,cancer.target,random_state=0)
-print(X_train.shape)
-print(X_test.shape)
-#now scale the data
-from sklearn.preprocessing import StandardScaler
-scaler = StandardScaler()
-scaler.fit(X_train)
-X_train_scaled = scaler.transform(X_train)
-X_test_scaled = scaler.transform(X_test)
-
-xg_clf = xgb.XGBClassifier()
-xg_clf.fit(X_train_scaled,y_train)
-
-y_test = xg_clf.predict(X_test_scaled)
-
-print("Test set accuracy with Random Forests and scaled data: {:.2f}".format(xg_clf.score(X_test_scaled,y_test)))
-
-import scikitplot as skplt
-y_pred = xg_clf.predict(X_test_scaled)
-skplt.metrics.plot_confusion_matrix(y_test, y_pred, normalize=True)
-save_fig("xdclassiffierconfusion")
-plt.show()
-y_probas = xg_clf.predict_proba(X_test_scaled)
-skplt.metrics.plot_roc(y_test, y_probas)
-save_fig("xdclassiffierroc")
-plt.show()
-skplt.metrics.plot_cumulative_gain(y_test, y_probas)
-save_fig("gdclassiffiercgain")
-plt.show()
-
-
-xgb.plot_tree(xg_clf,num_trees=0)
-plt.rcParams['figure.figsize'] = [50, 10]
-save_fig("xgtree")
-plt.show()
-
-xgb.plot_importance(xg_clf)
-plt.rcParams['figure.figsize'] = [5, 5]
-save_fig("xgparams")
-plt.show()
-
-
-
-
-
-
- - - - -
- - - - -
-
-
-
-

- - By Morten Hjorth-Jensen
- - © Copyright 2021.
-

-
-
-
- - -
-
- - - - - - \ No newline at end of file diff --git a/doc/LectureNotes/_build/html/chapter8.html b/doc/LectureNotes/_build/html/chapter8.html deleted file mode 100644 index 84f3695fb..000000000 --- a/doc/LectureNotes/_build/html/chapter8.html +++ /dev/null @@ -1,1496 +0,0 @@ - - - - - - - - 11. Basic ideas of the Principal Component Analysis (PCA) — Applied Data Analysis and Machine Learning - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
- - - - - - - - -
- - -
-
- -
- -
-

11. Basic ideas of the Principal Component Analysis (PCA)

-

The principal component analysis deals with the problem of fitting a -low-dimensional affine subspace \(S\) of dimension \(d\) much smaller than -the total dimension \(D\) of the problem at hand (our data -set). Mathematically it can be formulated as a statistical problem or -a geometric problem. In our discussion of the theorem for the -classical PCA, we will stay with a statistical approach. -Historically, the PCA was first formulated in a statistical setting in order to estimate the principal component of a multivariate random variable.

-

We have a data set defined by a design/feature matrix \(\boldsymbol{X}\) (see below for its definition)

-
    -
  • Each data point is determined by \(p\) extrinsic (measurement) variables

  • -
  • We may want to ask the following question: Are there fewer intrinsic variables (say \(d << p\)) that still approximately describe the data?

  • -
  • If so, these intrinsic variables may tell us something important and finding these intrinsic variables is what dimension reduction methods do.

  • -
-

A good read is for example Vidal, Ma and Sastry.

-
-

11.1. Introducing the Covariance and Correlation functions

-

Before we discuss the PCA theorem, we need to remind ourselves about -the definition of the covariance and the correlation function. These are quantities

-

Suppose we have defined two vectors -\(\hat{x}\) and \(\hat{y}\) with \(n\) elements each. The covariance matrix \(\boldsymbol{C}\) is defined as

-
-\[\begin{split} -\boldsymbol{C}[\boldsymbol{x},\boldsymbol{y}] = \begin{bmatrix} \mathrm{cov}[\boldsymbol{x},\boldsymbol{x}] & \mathrm{cov}[\boldsymbol{x},\boldsymbol{y}] \\ - \mathrm{cov}[\boldsymbol{y},\boldsymbol{x}] & \mathrm{cov}[\boldsymbol{y},\boldsymbol{y}] \\ - \end{bmatrix}, -\end{split}\]
-

where for example

-
-\[ -\mathrm{cov}[\boldsymbol{x},\boldsymbol{y}] =\frac{1}{n} \sum_{i=0}^{n-1}(x_i- \overline{x})(y_i- \overline{y}). -\]
-

With this definition and recalling that the variance is defined as

-
-\[ -\mathrm{var}[\boldsymbol{x}]=\frac{1}{n} \sum_{i=0}^{n-1}(x_i- \overline{x})^2, -\]
-

we can rewrite the covariance matrix as

-
-\[\begin{split} -\boldsymbol{C}[\boldsymbol{x},\boldsymbol{y}] = \begin{bmatrix} \mathrm{var}[\boldsymbol{x}] & \mathrm{cov}[\boldsymbol{x},\boldsymbol{y}] \\ - \mathrm{cov}[\boldsymbol{x},\boldsymbol{y}] & \mathrm{var}[\boldsymbol{y}] \\ - \end{bmatrix}. -\end{split}\]
-

The covariance takes values between zero and infinity and may thus -lead to problems with loss of numerical precision for particularly -large values. It is common to scale the covariance matrix by -introducing instead the correlation matrix defined via the so-called -correlation function

-
-\[ -\mathrm{corr}[\boldsymbol{x},\boldsymbol{y}]=\frac{\mathrm{cov}[\boldsymbol{x},\boldsymbol{y}]}{\sqrt{\mathrm{var}[\boldsymbol{x}] \mathrm{var}[\boldsymbol{y}]}}. -\]
-

The correlation function is then given by values \(\mathrm{corr}[\boldsymbol{x},\boldsymbol{y}] -\in [-1,1]\). This avoids eventual problems with too large values. We -can then define the correlation matrix for the two vectors \(\boldsymbol{x}\) -and \(\boldsymbol{y}\) as

-
-\[\begin{split} -\boldsymbol{K}[\boldsymbol{x},\boldsymbol{y}] = \begin{bmatrix} 1 & \mathrm{corr}[\boldsymbol{x},\boldsymbol{y}] \\ - \mathrm{corr}[\boldsymbol{y},\boldsymbol{x}] & 1 \\ - \end{bmatrix}, -\end{split}\]
-

In the above example this is the function we constructed using pandas.

-

In our derivation of the various regression algorithms like Ordinary Least Squares or Ridge regression -we defined the design/feature matrix \(\boldsymbol{X}\) as

-
-\[\begin{split} -\boldsymbol{X}=\begin{bmatrix} -x_{0,0} & x_{0,1} & x_{0,2}& \dots & \dots x_{0,p-1}\\ -x_{1,0} & x_{1,1} & x_{1,2}& \dots & \dots x_{1,p-1}\\ -x_{2,0} & x_{2,1} & x_{2,2}& \dots & \dots x_{2,p-1}\\ -\dots & \dots & \dots & \dots \dots & \dots \\ -x_{n-2,0} & x_{n-2,1} & x_{n-2,2}& \dots & \dots x_{n-2,p-1}\\ -x_{n-1,0} & x_{n-1,1} & x_{n-1,2}& \dots & \dots x_{n-1,p-1}\\ -\end{bmatrix}, -\end{split}\]
-

with \(\boldsymbol{X}\in {\mathbb{R}}^{n\times p}\), with the predictors/features \(p\) refering to the column numbers and the -entries \(n\) being the row elements. -We can rewrite the design/feature matrix in terms of its column vectors as

-
-\[ -\boldsymbol{X}=\begin{bmatrix} \boldsymbol{x}_0 & \boldsymbol{x}_1 & \boldsymbol{x}_2 & \dots & \dots & \boldsymbol{x}_{p-1}\end{bmatrix}, -\]
-

with a given vector

-
-\[ -\boldsymbol{x}_i^T = \begin{bmatrix}x_{0,i} & x_{1,i} & x_{2,i}& \dots & \dots x_{n-1,i}\end{bmatrix}. -\]
-

With these definitions, we can now rewrite our \(2\times 2\) -correaltion/covariance matrix in terms of a moe general design/feature -matrix \(\boldsymbol{X}\in {\mathbb{R}}^{n\times p}\). This leads to a \(p\times p\) -covariance matrix for the vectors \(\boldsymbol{x}_i\) with \(i=0,1,\dots,p-1\)

-
-\[\begin{split} -\boldsymbol{C}[\boldsymbol{x}] = \begin{bmatrix} -\mathrm{var}[\boldsymbol{x}_0] & \mathrm{cov}[\boldsymbol{x}_0,\boldsymbol{x}_1] & \mathrm{cov}[\boldsymbol{x}_0,\boldsymbol{x}_2] & \dots & \dots & \mathrm{cov}[\boldsymbol{x}_0,\boldsymbol{x}_{p-1}]\\ -\mathrm{cov}[\boldsymbol{x}_1,\boldsymbol{x}_0] & \mathrm{var}[\boldsymbol{x}_1] & \mathrm{cov}[\boldsymbol{x}_1,\boldsymbol{x}_2] & \dots & \dots & \mathrm{cov}[\boldsymbol{x}_1,\boldsymbol{x}_{p-1}]\\ -\mathrm{cov}[\boldsymbol{x}_2,\boldsymbol{x}_0] & \mathrm{cov}[\boldsymbol{x}_2,\boldsymbol{x}_1] & \mathrm{var}[\boldsymbol{x}_2] & \dots & \dots & \mathrm{cov}[\boldsymbol{x}_2,\boldsymbol{x}_{p-1}]\\ -\dots & \dots & \dots & \dots & \dots & \dots \\ -\dots & \dots & \dots & \dots & \dots & \dots \\ -\mathrm{cov}[\boldsymbol{x}_{p-1},\boldsymbol{x}_0] & \mathrm{cov}[\boldsymbol{x}_{p-1},\boldsymbol{x}_1] & \mathrm{cov}[\boldsymbol{x}_{p-1},\boldsymbol{x}_{2}] & \dots & \dots & \mathrm{var}[\boldsymbol{x}_{p-1}]\\ -\end{bmatrix}, -\end{split}\]
-

and the correlation matrix

-
-\[\begin{split} -\boldsymbol{K}[\boldsymbol{x}] = \begin{bmatrix} -1 & \mathrm{corr}[\boldsymbol{x}_0,\boldsymbol{x}_1] & \mathrm{corr}[\boldsymbol{x}_0,\boldsymbol{x}_2] & \dots & \dots & \mathrm{corr}[\boldsymbol{x}_0,\boldsymbol{x}_{p-1}]\\ -\mathrm{corr}[\boldsymbol{x}_1,\boldsymbol{x}_0] & 1 & \mathrm{corr}[\boldsymbol{x}_1,\boldsymbol{x}_2] & \dots & \dots & \mathrm{corr}[\boldsymbol{x}_1,\boldsymbol{x}_{p-1}]\\ -\mathrm{corr}[\boldsymbol{x}_2,\boldsymbol{x}_0] & \mathrm{corr}[\boldsymbol{x}_2,\boldsymbol{x}_1] & 1 & \dots & \dots & \mathrm{corr}[\boldsymbol{x}_2,\boldsymbol{x}_{p-1}]\\ -\dots & \dots & \dots & \dots & \dots & \dots \\ -\dots & \dots & \dots & \dots & \dots & \dots \\ -\mathrm{corr}[\boldsymbol{x}_{p-1},\boldsymbol{x}_0] & \mathrm{corr}[\boldsymbol{x}_{p-1},\boldsymbol{x}_1] & \mathrm{corr}[\boldsymbol{x}_{p-1},\boldsymbol{x}_{2}] & \dots & \dots & 1\\ -\end{bmatrix}, -\end{split}\]
-

The Numpy function np.cov calculates the covariance elements using -the factor \(1/(n-1)\) instead of \(1/n\) since it assumes we do not have -the exact mean values. The following simple function uses the -np.vstack function which takes each vector of dimension \(1\times n\) -and produces a \(2\times n\) matrix \(\boldsymbol{W}\)

-
-\[\begin{split} -\boldsymbol{W} = \begin{bmatrix} x_0 & y_0 \\ - x_1 & y_1 \\ - x_2 & y_2\\ - \dots & \dots \\ - x_{n-2} & y_{n-2}\\ - x_{n-1} & y_{n-1} & - \end{bmatrix}, -\end{split}\]
-

which in turn is converted into into the \(2\times 2\) covariance matrix -\(\boldsymbol{C}\) via the Numpy function np.cov(). We note that we can also calculate -the mean value of each set of samples \(\boldsymbol{x}\) etc using the Numpy -function np.mean(x). We can also extract the eigenvalues of the -covariance matrix through the np.linalg.eig() function.

-
-
-
# Importing various packages
-import numpy as np
-n = 100
-x = np.random.normal(size=n)
-print(np.mean(x))
-y = 4+3*x+np.random.normal(size=n)
-print(np.mean(y))
-W = np.vstack((x, y))
-C = np.cov(W)
-print(C)
-
-
-
-
-
-0.13740265686642364
-3.647867896223553
-[[0.88732076 2.58645106]
- [2.58645106 8.40379027]]
-
-
-
-
-
-
-

11.2. Correlation Matrix

-

The previous example can be converted into the correlation matrix by -simply scaling the matrix elements with the variances. We should also -subtract the mean values for each column. This leads to the following -code which sets up the correlations matrix for the previous example in -a more brute force way. Here we scale the mean values for each column of the design matrix, calculate the relevant mean values and variances and then finally set up the \(2\times 2\) correlation matrix (since we have only two vectors).

-
-
-
import numpy as np
-n = 100
-# define two vectors                                                                                           
-x = np.random.random(size=n)
-y = 4+3*x+np.random.normal(size=n)
-#scaling the x and y vectors                                                                                   
-x = x - np.mean(x)
-y = y - np.mean(y)
-variance_x = np.sum(x@x)/n
-variance_y = np.sum(y@y)/n
-print(variance_x)
-print(variance_y)
-cov_xy = np.sum(x@y)/n
-cov_xx = np.sum(x@x)/n
-cov_yy = np.sum(y@y)/n
-C = np.zeros((2,2))
-C[0,0]= cov_xx/variance_x
-C[1,1]= cov_yy/variance_y
-C[0,1]= cov_xy/np.sqrt(variance_y*variance_x)
-C[1,0]= C[0,1]
-print(C)
-
-
-
-
-
0.09282061240353208
-2.0679953259809554
-[[1.         0.65276752]
- [0.65276752 1.        ]]
-
-
-
-
-

We see that the matrix elements along the diagonal are one as they -should be and that the matrix is symmetric. Furthermore, diagonalizing -this matrix we easily see that it is a positive definite matrix.

-

The above procedure with numpy can be made more compact if we use pandas.

-

We whow here how we can set up the correlation matrix using pandas, as done in this simple code

-
-
-
import numpy as np
-import pandas as pd
-n = 10
-x = np.random.normal(size=n)
-x = x - np.mean(x)
-y = 4+3*x+np.random.normal(size=n)
-y = y - np.mean(y)
-X = (np.vstack((x, y))).T
-print(X)
-Xpd = pd.DataFrame(X)
-print(Xpd)
-correlation_matrix = Xpd.corr()
-print(correlation_matrix)
-
-
-
-
-
[[ 0.27416797  2.69235507]
- [-0.30895532 -1.36796587]
- [ 1.03285324  2.17106672]
- [-0.35304998 -2.85655181]
- [-0.79084976 -1.67951873]
- [ 0.19247017  0.868215  ]
- [-0.45745139 -2.25170803]
- [-0.63165748 -1.85258411]
- [-0.19636844  0.14649905]
- [ 1.238841    4.13019269]]
-          0         1
-0  0.274168  2.692355
-1 -0.308955 -1.367966
-2  1.032853  2.171067
-3 -0.353050 -2.856552
-4 -0.790850 -1.679519
-5  0.192470  0.868215
-6 -0.457451 -2.251708
-7 -0.631657 -1.852584
-8 -0.196368  0.146499
-9  1.238841  4.130193
-          0         1
-0  1.000000  0.899606
-1  0.899606  1.000000
-
-
-
-
-

We expand this model to the Franke function discussed above.

-
-
-
# Common imports
-import numpy as np
-import pandas as pd
-
-
-def FrankeFunction(x,y):
-	term1 = 0.75*np.exp(-(0.25*(9*x-2)**2) - 0.25*((9*y-2)**2))
-	term2 = 0.75*np.exp(-((9*x+1)**2)/49.0 - 0.1*(9*y+1))
-	term3 = 0.5*np.exp(-(9*x-7)**2/4.0 - 0.25*((9*y-3)**2))
-	term4 = -0.2*np.exp(-(9*x-4)**2 - (9*y-7)**2)
-	return term1 + term2 + term3 + term4
-
-
-def create_X(x, y, n ):
-	if len(x.shape) > 1:
-		x = np.ravel(x)
-		y = np.ravel(y)
-
-	N = len(x)
-	l = int((n+1)*(n+2)/2)		# Number of elements in beta
-	X = np.ones((N,l))
-
-	for i in range(1,n+1):
-		q = int((i)*(i+1)/2)
-		for k in range(i+1):
-			X[:,q+k] = (x**(i-k))*(y**k)
-
-	return X
-
-
-# Making meshgrid of datapoints and compute Franke's function
-n = 4
-N = 100
-x = np.sort(np.random.uniform(0, 1, N))
-y = np.sort(np.random.uniform(0, 1, N))
-z = FrankeFunction(x, y)
-X = create_X(x, y, n=n)    
-
-Xpd = pd.DataFrame(X)
-# subtract the mean values and set up the covariance matrix
-Xpd = Xpd - Xpd.mean()
-covariance_matrix = Xpd.cov()
-print(covariance_matrix)
-
-
-
-
-
     0         1         2         3         4         5         6         7   \
-0   0.0  0.000000  0.000000  0.000000  0.000000  0.000000  0.000000  0.000000   
-1   0.0  0.090368  0.089828  0.084745  0.089694  0.094385  0.072722  0.077607   
-2   0.0  0.089828  0.091016  0.082203  0.087699  0.093293  0.069684  0.074647   
-3   0.0  0.084745  0.082203  0.084433  0.088351  0.091653  0.075222  0.079774   
-4   0.0  0.089694  0.087699  0.088351  0.092763  0.096661  0.078226  0.083104   
-5   0.0  0.094385  0.093293  0.091653  0.096661  0.101332  0.080548  0.085760   
-6   0.0  0.072722  0.069684  0.075222  0.078226  0.080548  0.068780  0.072668   
-7   0.0  0.077607  0.074647  0.079774  0.083104  0.085760  0.072668  0.076854   
-8   0.0  0.082726  0.079963  0.084408  0.088121  0.091191  0.076564  0.081069   
-9   0.0  0.088020  0.085632  0.089011  0.093180  0.096774  0.080344  0.085192   
-10  0.0  0.062054  0.059107  0.065855  0.068244  0.069993  0.061366  0.064683   
-11  0.0  0.066283  0.063260  0.070074  0.072690  0.074644  0.065135  0.068701   
-12  0.0  0.070793  0.067729  0.074516  0.077390  0.079587  0.069075  0.072910   
-13  0.0  0.075587  0.072539  0.079162  0.082333  0.084822  0.073160  0.077286   
-14  0.0  0.080656  0.077711  0.083974  0.087490  0.090338  0.077343  0.081784   
-
-          8         9         10        11        12        13        14  
-0   0.000000  0.000000  0.000000  0.000000  0.000000  0.000000  0.000000  
-1   0.082726  0.088020  0.062054  0.066283  0.070793  0.075587  0.080656  
-2   0.079963  0.085632  0.059107  0.063260  0.067729  0.072539  0.077711  
-3   0.084408  0.089011  0.065855  0.070074  0.074516  0.079162  0.083974  
-4   0.088121  0.093180  0.068244  0.072690  0.077390  0.082333  0.087490  
-5   0.091191  0.096774  0.069993  0.074644  0.079587  0.084822  0.090338  
-6   0.076564  0.080344  0.061366  0.065135  0.069075  0.073160  0.077343  
-7   0.081069  0.085192  0.064683  0.068701  0.072910  0.077286  0.081784  
-8   0.085636  0.090149  0.067977  0.072252  0.076743  0.081428  0.086266  
-9   0.090149  0.095107  0.071137  0.075674  0.080455  0.085465  0.090671  
-10  0.067977  0.071137  0.055542  0.058856  0.062305  0.065864  0.069488  
-11  0.072252  0.075674  0.058856  0.062396  0.066086  0.069899  0.073789  
-12  0.076743  0.080455  0.062305  0.066086  0.070032  0.074118  0.078298  
-13  0.081428  0.085465  0.065864  0.069899  0.074118  0.078497  0.082989  
-14  0.086266  0.090671  0.069488  0.073789  0.078298  0.082989  0.087822  
-
-
-
-
-

We note here that the covariance is zero for the first rows and -columns since all matrix elements in the design matrix were set to one -(we are fitting the function in terms of a polynomial of degree \(n\)). We would however not include the intercept -and wee can simply -drop these elements and construct a correlation -matrix without them.

-

We can rewrite the covariance matrix in a more compact form in terms of the design/feature matrix \(\boldsymbol{X}\) as

-
-\[ -\boldsymbol{C}[\boldsymbol{x}] = \frac{1}{n}\boldsymbol{X}^T\boldsymbol{X}= \mathbb{E}[\boldsymbol{X}^T\boldsymbol{X}]. -\]
-

To see this let us simply look at a design matrix \(\boldsymbol{X}\in {\mathbb{R}}^{2\times 2}\)

-
-\[\begin{split} -\boldsymbol{X}=\begin{bmatrix} -x_{00} & x_{01}\\ -x_{10} & x_{11}\\ -\end{bmatrix}=\begin{bmatrix} -\boldsymbol{x}_{0} & \boldsymbol{x}_{1}\\ -\end{bmatrix}. -\end{split}\]
-

If we then compute the expectation value

-
-\[\begin{split} -\mathbb{E}[\boldsymbol{X}^T\boldsymbol{X}] = \frac{1}{n}\boldsymbol{X}^T\boldsymbol{X}=\begin{bmatrix} -x_{00}^2+x_{01}^2 & x_{00}x_{10}+x_{01}x_{11}\\ -x_{10}x_{00}+x_{11}x_{01} & x_{10}^2+x_{11}^2\\ -\end{bmatrix}, -\end{split}\]
-

which is just

-
-\[\begin{split} -\boldsymbol{C}[\boldsymbol{x}_0,\boldsymbol{x}_1] = \boldsymbol{C}[\boldsymbol{x}]=\begin{bmatrix} \mathrm{var}[\boldsymbol{x}_0] & \mathrm{cov}[\boldsymbol{x}_0,\boldsymbol{x}_1] \\ - \mathrm{cov}[\boldsymbol{x}_1,\boldsymbol{x}_0] & \mathrm{var}[\boldsymbol{x}_1] \\ - \end{bmatrix}, -\end{split}\]
-

where we wrote $\(\boldsymbol{C}[\boldsymbol{x}_0,\boldsymbol{x}_1] = \boldsymbol{C}[\boldsymbol{x}]\)\( to indicate that this the covariance of the vectors \)\boldsymbol{x}\( of the design/feature matrix \)\boldsymbol{X}$.

-

It is easy to generalize this to a matrix \(\boldsymbol{X}\in {\mathbb{R}}^{n\times p}\).

-
-
-

11.3. Towards the PCA theorem

-

We have that the covariance matrix (the correlation matrix involves a simple rescaling) is given as

-
-\[ -\boldsymbol{C}[\boldsymbol{x}] = \frac{1}{n}\boldsymbol{X}^T\boldsymbol{X}= \mathbb{E}[\boldsymbol{X}^T\boldsymbol{X}]. -\]
-

Let us now assume that we can perform a series of orthogonal transformations where we employ some orthogonal matrices \(\boldsymbol{S}\). -These matrices are defined as \(\boldsymbol{S}\in {\mathbb{R}}^{p\times p}\) and obey the orthogonality requirements \(\boldsymbol{S}\boldsymbol{S}^T=\boldsymbol{S}^T\boldsymbol{S}=\boldsymbol{I}\). The matrix can be written out in terms of the column vectors \(\boldsymbol{s}_i\) as \(\boldsymbol{S}=[\boldsymbol{s}_0,\boldsymbol{s}_1,\dots,\boldsymbol{s}_{p-1}]\) and \(\boldsymbol{s}_i \in {\mathbb{R}}^{p}\).

-

Assume also that there is a transformation \(\boldsymbol{S}^T\boldsymbol{C}[\boldsymbol{x}]\boldsymbol{S}=\boldsymbol{C}[\boldsymbol{y}]\) such that the new matrix \(\boldsymbol{C}[\boldsymbol{y}]\) is diagonal with elements \([\lambda_0,\lambda_1,\lambda_2,\dots,\lambda_{p-1}]\).

-

That is we have

-
-\[ -\boldsymbol{C}[\boldsymbol{y}] = \mathbb{E}[\boldsymbol{S}^T\boldsymbol{X}^T\boldsymbol{X}T\boldsymbol{S}]=\boldsymbol{S}^T\boldsymbol{C}[\boldsymbol{x}]\boldsymbol{S}, -\]
-

since the matrix \(\boldsymbol{S}\) is not a data dependent matrix. Multiplying with \(\boldsymbol{S}\) from the left we have

-
-\[ -\boldsymbol{S}\boldsymbol{C}[\boldsymbol{y}] = \boldsymbol{C}[\boldsymbol{x}]\boldsymbol{S}, -\]
-

and since \(\boldsymbol{C}[\boldsymbol{y}]\) is diagonal we have for a given eigenvalue \(i\) of the covariance matrix that

-
-\[ -\boldsymbol{S}_i\lambda_i = \boldsymbol{C}[\boldsymbol{x}]\boldsymbol{S}_i. -\]
-

In the derivation of the PCA theorem we will assume that the eigenvalues are ordered in descending order, that is -\(\lambda_0 > \lambda_1 > \dots > \lambda_{p-1}\).

-

The eigenvalues tell us then how much we need to stretch the -corresponding eigenvectors. Dimensions with large eigenvalues have -thus large variations (large variance) and define therefore useful -dimensions. The data points are more spread out in the direction of -these eigenvectors. Smaller eigenvalues mean on the other hand that -the corresponding eigenvectors are shrunk accordingly and the data -points are tightly bunched together and there is not much variation in -these specific directions. Hopefully then we could leave it out -dimensions where the eigenvalues are very small. If \(p\) is very large, -we could then aim at reducing \(p\) to \(l << p\) and handle only \(l\) -features/predictors.

-
-

11.3.1. The Algorithm before theorem

-

Here’s how we would proceed in setting up the algorithm for the PCA, see also discussion below here.

-
    -
  • Set up the datapoints for the design/feature matrix \(\boldsymbol{X}\) with \(\boldsymbol{X}\in {\mathbb{R}}^{n\times p}\), with the predictors/features \(p\) referring to the column numbers and the entries \(n\) being the row elements.

  • -
-
-\[\begin{split} -\boldsymbol{X}=\begin{bmatrix} -x_{0,0} & x_{0,1} & x_{0,2}& \dots & \dots x_{0,p-1}\\ -x_{1,0} & x_{1,1} & x_{1,2}& \dots & \dots x_{1,p-1}\\ -x_{2,0} & x_{2,1} & x_{2,2}& \dots & \dots x_{2,p-1}\\ -\dots & \dots & \dots & \dots \dots & \dots \\ -x_{n-2,0} & x_{n-2,1} & x_{n-2,2}& \dots & \dots x_{n-2,p-1}\\ -x_{n-1,0} & x_{n-1,1} & x_{n-1,2}& \dots & \dots x_{n-1,p-1}\\ -\end{bmatrix}, -\end{split}\]
-
    -
  • Center the data by subtracting the mean value for each column. This leads to a new matrix \(\boldsymbol{X}\rightarrow \overline{\boldsymbol{X}}\).

  • -
  • Compute then the covariance/correlation matrix \(\mathbb{E}[\overline{\boldsymbol{X}}^T\overline{\boldsymbol{X}}]\).

  • -
  • Find the eigenpairs of \(\boldsymbol{C}\) with eigenvalues \([\lambda_0,\lambda_1,\dots,\lambda_{p-1}]\) and eigenvectors \([\boldsymbol{s}_0,\boldsymbol{s}_1,\dots,\boldsymbol{s}_{p-1}]\).

  • -
  • Order the eigenvalue (and the eigenvectors accordingly) in order of decreasing eigenvalues.

  • -
  • Keep only those \(l\) eigenvalues larger than a selected threshold value, discarding thus \(p-l\) features since we expect small variations in the data here.

  • -
-
-
-

11.3.2. Writing our own PCA code

-

We will use a simple example first with two-dimensional data -drawn from a multivariate normal distribution with the following mean and covariance matrix (we have fixed these quantities but will play around with them below):

-
-\[\begin{split} -\mu = (-1,2) \qquad \Sigma = \begin{bmatrix} 4 & 2 \\ -2 & 2 -\end{bmatrix} -\end{split}\]
-

Note that the mean refers to each column of data. -We will generate \(n = 10000\) points \(X = \{ x_1, \ldots, x_N \}\) from -this distribution, and store them in the \(1000 \times 2\) matrix \(\boldsymbol{X}\). This is our design matrix where we have forced the covariance and mean values to take specific values.

-

The following Python code aids in setting up the data and writing out the design matrix. -Note that the function multivariate returns also the covariance discussed above and that it is defined by dividing by \(n-1\) instead of \(n\).

-
-
-
%matplotlib inline
-
-import numpy as np
-import pandas as pd
-import matplotlib.pyplot as plt
-from IPython.display import display
-n = 10000
-mean = (-1, 2)
-cov = [[4, 2], [2, 2]]
-X = np.random.multivariate_normal(mean, cov, n)
-
-
-
-
-

Now we are going to implement the PCA algorithm. We will break it down into various substeps.

-

The first step of PCA is to compute the sample mean of the data and use it to center the data. Recall that the sample mean is

-
-\[ -\mu_n = \frac{1}{n} \sum_{i=1}^n x_i -\]
-

and the mean-centered data \(\bar{X} = \{ \bar{x}_1, \ldots, \bar{x}_n \}\) takes the form

-
-\[ -\bar{x}_i = x_i - \mu_n. -\]
-

When you are done with these steps, print out \(\mu_n\) to verify it is -close to \(\mu\) and plot your mean centered data to verify it is -centered at the origin! -The following code elements perform these operations using pandas or using our own functionality for doing so. The latter, using numpy is rather simple through the mean() function.

-
-
-
df = pd.DataFrame(X)
-# Pandas does the centering for us
-df = df -df.mean()
-# we center it ourselves
-X_centered = X - X.mean(axis=0)
-
-
-
-
-

Alternatively, we could use the functions we discussed -earlier for scaling the data set. That is, we could have used the -StandardScaler function in Scikit-Learn, a function which ensures -that for each feature/predictor we study the mean value is zero and -the variance is one (every column in the design/feature matrix). You -would then not get the same results, since we divide by the -variance. The diagonal covariance matrix elements will then be one, -while the non-diagonal ones need to be divided by \(2\sqrt{2}\) for our -specific case.

-

Now we are going to use the mean centered data to compute the sample covariance of the data by using the following equation

-
-\[ -\Sigma_n = \frac{1}{n-1} \sum_{i=1}^n \bar{x}_i^T \bar{x}_i = \frac{1}{n-1} \sum_{i=1}^n (x_i - \mu_n)^T (x_i - \mu_n) -\]
-

where the data points \(x_i \in \mathbb{R}^p\) (here in this example \(p = 2\)) are column vectors and \(x^T\) is the transpose of \(x\). -We can write our own code or simply use either the functionaly of numpy or that of pandas, as follows

-
-
-
print(df.cov())
-print(np.cov(X_centered.T))
-
-
-
-
-
          0         1
-0  3.900266  1.942180
-1  1.942180  1.965724
-[[3.90026646 1.9421795 ]
- [1.9421795  1.96572363]]
-
-
-
-
-

Note that the way we define the covariance matrix here has a factor \(n-1\) instead of \(n\). This is included in the cov() function by numpy and pandas. -Our own code here is not very elegant and asks for obvious improvements. It is tailored to this specific \(2\times 2\) covariance matrix.

-
-
-
# extract the relevant columns from the centered design matrix of dim n x 2
-x = X_centered[:,0]
-y = X_centered[:,1]
-Cov = np.zeros((2,2))
-Cov[0,1] = np.sum(x.T@y)/(n-1.0)
-Cov[0,0] = np.sum(x.T@x)/(n-1.0)
-Cov[1,1] = np.sum(y.T@y)/(n-1.0)
-Cov[1,0]= Cov[0,1]
-print("Centered covariance using own code")
-print(Cov)
-plt.plot(x, y, 'x')
-plt.axis('equal')
-plt.show()
-
-
-
-
-
Centered covariance using own code
-[[3.90026646 1.9421795 ]
- [1.9421795  1.96572363]]
-
-
-_images/chapter8_65_1.png -
-
-

Depending on the number of points \(n\), we will get results that are close to the covariance values defined above. -The plot shows how the data are clustered around a line with slope close to one. Is this expected? Try to change the covariance and the mean values. For example, try to make the variance of the first element much larger than that of the second diagonal element. Try also to shrink the covariance (the non-diagonal elements) and see how the data points are distributed.

-
-
-

11.3.3. Diagonalize the sample covariance matrix to obtain the principal components

-

Now we are ready to solve for the principal components! To do so we -diagonalize the sample covariance matrix \(\Sigma\). We can use the -function np.linalg.eig to do so. It will return the eigenvalues and -eigenvectors of \(\Sigma\). Once we have these we can perform the -following tasks:

-
    -
  • We compute the percentage of the total variance captured by the first principal component

  • -
  • We plot the mean centered data and lines along the first and second principal components

  • -
  • Then we project the mean centered data onto the first and second principal components, and plot the projected data.

  • -
  • Finally, we approximate the data as

  • -
-
-\[ -x_i \approx \tilde{x}_i = \mu_n + \langle x_i, v_0 \rangle v_0 -\]
-

where \(v_0\) is the first principal component.

-

Collecting all these steps we can write our own PCA function and -compare this with the functionality included in Scikit-Learn.

-

The code here outlines some of the elements we could include in the -analysis. Feel free to extend upon this in order to address the above -questions.

-
-
-
# diagonalize and obtain eigenvalues, not necessarily sorted
-EigValues, EigVectors = np.linalg.eig(Cov)
-# sort eigenvectors and eigenvalues
-#permute = EigValues.argsort()
-#EigValues = EigValues[permute]
-#EigVectors = EigVectors[:,permute]
-print("Eigenvalues of Covariance matrix")
-for i in range(2):
-    print(EigValues[i])
-FirstEigvector = EigVectors[:,0]
-SecondEigvector = EigVectors[:,1]
-print("First eigenvector")
-print(FirstEigvector)
-print("Second eigenvector")
-print(SecondEigvector)
-#thereafter we do a PCA with Scikit-learn
-from sklearn.decomposition import PCA
-pca = PCA(n_components = 2)
-X2Dsl = pca.fit_transform(X)
-print("Eigenvector of largest eigenvalue")
-print(pca.components_.T[:, 0])
-
-
-
-
-
Eigenvalues of Covariance matrix
-5.102712819944882
-0.763277270613554
-First eigenvector
-[0.85023678 0.52640043]
-Second eigenvector
-[-0.52640043  0.85023678]
-
-
-
Eigenvector of largest eigenvalue
-[-0.85023678 -0.52640043]
-
-
-
-
-

This code does not contain all the above elements, but it shows how we can use Scikit-Learn to extract the eigenvector which corresponds to the largest eigenvalue. Try to address the questions we pose before the above code. Try also to change the values of the covariance matrix by making one of the diagonal elements much larger than the other. What do you observe then?

-
-
-
-

11.4. Classical PCA Theorem

-

We assume now that we have a design matrix \(\boldsymbol{X}\) which has been -centered as discussed above. For the sake of simplicity we skip the -overline symbol. The matrix is defined in terms of the various column -vectors \([\boldsymbol{x}_0,\boldsymbol{x}_1,\dots, \boldsymbol{x}_{p-1}]\) each with dimension -\(\boldsymbol{x}\in {\mathbb{R}}^{n}\).

-

The PCA theorem states that minimizing the above reconstruction error -corresponds to setting \(\boldsymbol{W}=\boldsymbol{S}\), the orthogonal matrix which -diagonalizes the empirical covariance(correlation) matrix. The optimal -low-dimensional encoding of the data is then given by a set of vectors -\(\boldsymbol{z}_i\) with at most \(l\) vectors, with \(l << p\), defined by the -orthogonal projection of the data onto the columns spanned by the -eigenvectors of the covariance(correlations matrix).

-

To show the PCA theorem let us start with the assumption that there is one vector \(\boldsymbol{s}_0\) which corresponds to a solution which minimized the reconstruction error \(J\). This is an orthogonal vector. It means that we now approximate the reconstruction error in terms of \(\boldsymbol{w}_0\) and \(\boldsymbol{z}_0\) as

-

We are almost there, we have obtained a relation between minimizing -the reconstruction error and the variance and the covariance -matrix. Minimizing the error is equivalent to maximizing the variance -of the projected data.

-

We could trivially maximize the variance of the projection (and -thereby minimize the error in the reconstruction function) by letting -the norm-2 of \(\boldsymbol{w}_0\) go to infinity. However, this norm since we -want the matrix \(\boldsymbol{W}\) to be an orthogonal matrix, is constrained by -\(\vert\vert \boldsymbol{w}_0 \vert\vert_2^2=1\). Imposing this condition via a -Lagrange multiplier we can then in turn maximize

-
-\[ -J(\boldsymbol{w}_0)= \boldsymbol{w}_0^T\boldsymbol{C}[\boldsymbol{x}]\boldsymbol{w}_0+\lambda_0(1-\boldsymbol{w}_0^T\boldsymbol{w}_0). -\]
-

Taking the derivative with respect to \(\boldsymbol{w}_0\) we obtain

-
-\[ -\frac{\partial J(\boldsymbol{w}_0)}{\partial \boldsymbol{w}_0}= 2\boldsymbol{C}[\boldsymbol{x}]\boldsymbol{w}_0-2\lambda_0\boldsymbol{w}_0=0, -\]
-

meaning that

-
-\[ -\boldsymbol{C}[\boldsymbol{x}]\boldsymbol{w}_0=\lambda_0\boldsymbol{w}_0. -\]
-

The direction that maximizes the variance (or minimizes the construction error) is an eigenvector of the covariance matrix! If we left multiply with \(\boldsymbol{w}_0^T\) we have the variance of the projected data is

-
-\[ -\boldsymbol{w}_0^T\boldsymbol{C}[\boldsymbol{x}]\boldsymbol{w}_0=\lambda_0. -\]
-

If we want to maximize the variance (minimize the construction error) -we simply pick the eigenvector of the covariance matrix with the -largest eigenvalue. This establishes the link between the minimization -of the reconstruction function \(J\) in terms of an orthogonal matrix -and the maximization of the variance and thereby the covariance of our -observations encoded in the design/feature matrix \(\boldsymbol{X}\).

-

The proof -for the other eigenvectors \(\boldsymbol{w}_1,\boldsymbol{w}_2,\dots\) can be -established by applying the above arguments and using the fact that -our basis of eigenvectors is orthogonal, see Murphy chapter -12.2. The -discussion in chapter 12.2 of Murphy’s text has also a nice link with -the Singular Value Decomposition theorem. For categorical data, see -chapter 12.4 and discussion therein.

-

For more details, see for example Vidal, Ma and Sastry, chapter 2.

-
- -
-

11.6. PCA and scikit-learn

-

Scikit-Learn’s PCA class implements PCA using SVD decomposition just like we did before. The -following code applies PCA to reduce the dimensionality of the dataset down to two dimensions (note -that it automatically takes care of centering the data):

-
-
-
#thereafter we do a PCA with Scikit-learn
-from sklearn.decomposition import PCA
-pca = PCA(n_components = 2)
-X2D = pca.fit_transform(X)
-print(X2D)
-
-
-
-
-
[[ 1.5378811  -0.94639099]
- [-0.86145244  0.89288636]
- [ 0.00445655  0.81633628]
- [-0.07145103 -1.00433417]
- [-2.03707133 -0.48476997]
- [-0.72174172 -1.4557763 ]
- [ 0.55854694  1.60673226]
- [-1.6999536   0.43766686]
- [ 1.10405456  0.31718909]
- [ 2.18673098 -0.17953942]]
-
-
-
-
-

After fitting the PCA transformer to the dataset, you can access the principal components using the -components variable (note that it contains the PCs as horizontal vectors, so, for example, the first -principal component is equal to

-
-
-
pca.components_.T[:, 0]
-
-
-
-
-
array([-0.62373464, -0.5303329 ,  0.317367  ,  0.01873344,  0.47815203])
-
-
-
-
-

Another very useful piece of information is the explained variance ratio of each principal component, -available via the \(explained\_variance\_ratio\) variable. It indicates the proportion of the dataset’s -variance that lies along the axis of each principal component.

-
-
-

11.7. Back to the Cancer Data

-

We can now repeat the above but applied to real data, in this case our breast cancer data. -Here we compute performance scores on the training data using logistic regression.

-
-
-
import matplotlib.pyplot as plt
-import numpy as np
-from sklearn.model_selection import  train_test_split 
-from sklearn.datasets import load_breast_cancer
-from sklearn.linear_model import LogisticRegression
-cancer = load_breast_cancer()
-
-X_train, X_test, y_train, y_test = train_test_split(cancer.data,cancer.target,random_state=0)
-
-logreg = LogisticRegression()
-logreg.fit(X_train, y_train)
-print("Train set accuracy from Logistic Regression: {:.2f}".format(logreg.score(X_train,y_train)))
-# We scale the data
-from sklearn.preprocessing import StandardScaler
-scaler = StandardScaler()
-scaler.fit(X_train)
-X_train_scaled = scaler.transform(X_train)
-X_test_scaled = scaler.transform(X_test)
-# Then perform again a log reg fit
-logreg.fit(X_train_scaled, y_train)
-print("Train set accuracy scaled data: {:.2f}".format(logreg.score(X_train_scaled,y_train)))
-#thereafter we do a PCA with Scikit-learn
-from sklearn.decomposition import PCA
-pca = PCA(n_components = 2)
-X2D_train = pca.fit_transform(X_train_scaled)
-# and finally compute the log reg fit and the score on the training data	
-logreg.fit(X2D_train,y_train)
-print("Train set accuracy scaled and PCA data: {:.2f}".format(logreg.score(X2D_train,y_train)))
-
-
-
-
-
Train set accuracy from Logistic Regression: 0.95
-Train set accuracy scaled data: 0.99
-Train set accuracy scaled and PCA data: 0.96
-
-
-
/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/linear_model/_logistic.py:762: ConvergenceWarning: lbfgs failed to converge (status=1):
-STOP: TOTAL NO. of ITERATIONS REACHED LIMIT.
-
-Increase the number of iterations (max_iter) or scale the data as shown in:
-    https://scikit-learn.org/stable/modules/preprocessing.html
-Please also refer to the documentation for alternative solver options:
-    https://scikit-learn.org/stable/modules/linear_model.html#logistic-regression
-  n_iter_i = _check_optimize_result(
-
-
-
-
-

We see that our training data after the PCA decomposition has a performance similar to the non-scaled data.

-

Instead of arbitrarily choosing the number of dimensions to reduce down to, it is generally preferable to -choose the number of dimensions that add up to a sufficiently large portion of the variance (e.g., 95%). -Unless, of course, you are reducing dimensionality for data visualization — in that case you will -generally want to reduce the dimensionality down to 2 or 3. -The following code computes PCA without reducing dimensionality, then computes the minimum number -of dimensions required to preserve 95% of the training set’s variance:

-
-
-
pca = PCA()
-pca.fit(X)
-cumsum = np.cumsum(pca.explained_variance_ratio_)
-d = np.argmax(cumsum >= 0.95) + 1
-
-
-
-
-

You could then set \(n\_components=d\) and run PCA again. However, there is a much better option: instead -of specifying the number of principal components you want to preserve, you can set \(n\_components\) to be -a float between 0.0 and 1.0, indicating the ratio of variance you wish to preserve:

-
-
-
pca = PCA(n_components=0.95)
-X_reduced = pca.fit_transform(X)
-
-
-
-
-
-

11.7.1. Incremental PCA

-

One problem with the preceding implementation of PCA is that it requires the whole training set to fit in -memory in order for the SVD algorithm to run. Fortunately, Incremental PCA (IPCA) algorithms have -been developed: you can split the training set into mini-batches and feed an IPCA algorithm one minibatch -at a time. This is useful for large training sets, and also to apply PCA online (i.e., on the fly, as new -instances arrive).

-
-
-

11.7.2. Randomized PCA

-

Scikit-Learn offers yet another option to perform PCA, called Randomized PCA. This is a stochastic -algorithm that quickly finds an approximation of the first d principal components. Its computational -complexity is \(O(m \times d^2)+O(d^3)\), instead of \(O(m \times n^2) + O(n^3)\), so it is dramatically faster than the -previous algorithms when \(d\) is much smaller than \(n\).

-
-
-

11.7.3. Kernel PCA

-

The kernel trick is a mathematical technique that implicitly maps instances into a -very high-dimensional space (called the feature space), enabling nonlinear classification and regression -with Support Vector Machines. Recall that a linear decision boundary in the high-dimensional feature -space corresponds to a complex nonlinear decision boundary in the original space. -It turns out that the same trick can be applied to PCA, making it possible to perform complex nonlinear -projections for dimensionality reduction. This is called Kernel PCA (kPCA). It is often good at -preserving clusters of instances after projection, or sometimes even unrolling datasets that lie close to a -twisted manifold. -For example, the following code uses Scikit-Learn’s KernelPCA class to perform kPCA with an

-
-
-
from sklearn.decomposition import KernelPCA
-rbf_pca = KernelPCA(n_components = 2, kernel="rbf", gamma=0.04)
-X_reduced = rbf_pca.fit_transform(X)
-
-
-
-
-
-
-
-

11.8. Other techniques

-

There are many other dimensionality reduction techniques, several of which are available in Scikit-Learn.

-

Here are some of the most popular:

-
    -
  • Multidimensional Scaling (MDS) reduces dimensionality while trying to preserve the distances between the instances.

  • -
  • Isomap creates a graph by connecting each instance to its nearest neighbors, then reduces dimensionality while trying to preserve the geodesic distances between the instances.

  • -
  • t-Distributed Stochastic Neighbor Embedding (t-SNE) reduces dimensionality while trying to keep similar instances close and dissimilar instances apart. It is mostly used for visualization, in particular to visualize clusters of instances in high-dimensional space (e.g., to visualize the MNIST images in 2D).

  • -
  • Linear Discriminant Analysis (LDA) is actually a classification algorithm, but during training it learns the most discriminative axes between the classes, and these axes can then be used to define a hyperplane onto which to project the data. The benefit is that the projection will keep classes as far apart as possible, so LDA is a good technique to reduce dimensionality before running another classification algorithm such as a Support Vector Machine (SVM) classifier discussed in the SVM lectures.

  • -
-
-
- - - - -
- - - - -
-
-
-
-

- - By Morten Hjorth-Jensen
- - © Copyright 2021.
-

-
-
-
- - -
-
- - - - - - \ No newline at end of file diff --git a/doc/LectureNotes/_build/html/chapter9.html b/doc/LectureNotes/_build/html/chapter9.html deleted file mode 100644 index 5c30ad76e..000000000 --- a/doc/LectureNotes/_build/html/chapter9.html +++ /dev/null @@ -1,1161 +0,0 @@ - - - - - - - - 13. Neural networks — Applied Data Analysis and Machine Learning - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
- - - - - - - - -
- - -
-
- -
- -
-

13. Neural networks

-

Artificial neural networks are computational systems that can learn to -perform tasks by considering examples, generally without being -programmed with any task-specific rules. It is supposed to mimic a -biological system, wherein neurons interact by sending signals in the -form of mathematical functions between layers. All layers can contain -an arbitrary number of neurons, and each connection is represented by -a weight variable.

-

The field of artificial neural networks has a long history of -development, and is closely connected with the advancement of computer -science and computers in general. A model of artificial neurons was -first developed by McCulloch and Pitts in 1943 to study signal -processing in the brain and has later been refined by others. The -general idea is to mimic neural networks in the human brain, which is -composed of billions of neurons that communicate with each other by -sending electrical signals. Each neuron accumulates its incoming -signals, which must exceed an activation threshold to yield an -output. If the threshold is not overcome, the neuron remains inactive, -i.e. has zero output.

-

This behaviour has inspired a simple mathematical model for an artificial neuron.

- -
-
-\[ -\begin{equation} - y = f\left(\sum_{i=1}^n w_ix_i\right) = f(u) -\label{artificialNeuron} \tag{1} -\end{equation} -\]
-

Here, the output \(y\) of the neuron is the value of its activation function, which have as input -a weighted sum of signals \(x_i, \dots ,x_n\) received by \(n\) other neurons.

-

Conceptually, it is helpful to divide neural networks into four -categories:

-
    -
  1. general purpose neural networks for supervised learning,

  2. -
  3. neural networks designed specifically for image processing, the most prominent example of this class being Convolutional Neural Networks (CNNs),

  4. -
  5. neural networks for sequential data such as Recurrent Neural Networks (RNNs), and

  6. -
  7. neural networks for unsupervised learning such as Deep Boltzmann Machines.

  8. -
-

In natural science, DNNs and CNNs have already found numerous -applications. In statistical physics, they have been applied to detect -phase transitions in 2D Ising and Potts models, lattice gauge -theories, and different phases of polymers, or solving the -Navier-Stokes equation in weather forecasting. Deep learning has also -found interesting applications in quantum physics. Various quantum -phase transitions can be detected and studied using DNNs and CNNs, -topological phases, and even non-equilibrium many-body -localization. Representing quantum states as DNNs quantum state -tomography are among some of the impressive achievements to reveal the -potential of DNNs to facilitate the study of quantum systems.

-

In quantum information theory, it has been shown that one can perform -gate decompositions with the help of neural.

-

The applications are not limited to the natural sciences. There is a -plethora of applications in essentially all disciplines, from the -humanities to life science and medicine.

-

An artificial neural network (ANN), is a computational model that -consists of layers of connected neurons, or nodes or units. We will -refer to these interchangeably as units or nodes, and sometimes as -neurons.

-

It is supposed to mimic a biological nervous system by letting each -neuron interact with other neurons by sending signals in the form of -mathematical functions between layers. A wide variety of different -ANNs have been developed, but most of them consist of an input layer, -an output layer and eventual layers in-between, called hidden -layers. All layers can contain an arbitrary number of nodes, and each -connection between two nodes is associated with a weight variable.

-

Neural networks (also called neural nets) are neural-inspired -nonlinear models for supervised learning. As we will see, neural nets -can be viewed as natural, more powerful extensions of supervised -learning methods such as linear and logistic regression and soft-max -methods we discussed earlier.

-
-

13.1. Feed-forward neural networks

-

The feed-forward neural network (FFNN) was the first and simplest type -of ANNs that were devised. In this network, the information moves in -only one direction: forward through the layers.

-

Nodes are represented by circles, while the arrows display the -connections between the nodes, including the direction of information -flow. Additionally, each arrow corresponds to a weight variable -(figure to come). We observe that each node in a layer is connected -to all nodes in the subsequent layer, making this a so-called -fully-connected FFNN.

-
-
-

13.2. Convolutional Neural Network

-

A different variant of FFNNs are convolutional neural networks -(CNNs), which have a connectivity pattern inspired by the animal -visual cortex. Individual neurons in the visual cortex only respond to -stimuli from small sub-regions of the visual field, called a receptive -field. This makes the neurons well-suited to exploit the strong -spatially local correlation present in natural images. The response of -each neuron can be approximated mathematically as a convolution -operation. (figure to come)

-

Convolutional neural networks emulate the behaviour of neurons in the -visual cortex by enforcing a local connectivity pattern between -nodes of adjacent layers: Each node in a convolutional layer is -connected only to a subset of the nodes in the previous layer, in -contrast to the fully-connected FFNN. Often, CNNs consist of several -convolutional layers that learn local features of the input, with a -fully-connected layer at the end, which gathers all the local data and -produces the outputs. They have wide applications in image and video -recognition.

-
-
-

13.3. Recurrent neural networks

-

So far we have only mentioned ANNs where information flows in one -direction: forward. Recurrent neural networks on the other hand, -have connections between nodes that form directed cycles. This -creates a form of internal memory which are able to capture -information on what has been calculated before; the output is -dependent on the previous computations. Recurrent NNs make use of -sequential information by performing the same task for every element -in a sequence, where each element depends on previous elements. An -example of such information is sentences, making recurrent NNs -especially well-suited for handwriting and speech recognition.

-
-
-

13.4. Other types of networks

-

There are many other kinds of ANNs that have been developed. One type -that is specifically designed for interpolation in multidimensional -space is the radial basis function (RBF) network. RBFs are typically -made up of three layers: an input layer, a hidden layer with -non-linear radial symmetric activation functions and a linear output -layer (‘’linear’’ here means that each node in the output layer has a -linear activation function). The layers are normally fully-connected -and there are no cycles, thus RBFs can be viewed as a type of -fully-connected FFNN. They are however usually treated as a separate -type of NN due the unusual activation functions.

-
-
-

13.5. Multilayer perceptrons

-

One uses often so-called fully-connected feed-forward neural networks -with three or more layers (an input layer, one or more hidden layers -and an output layer) consisting of neurons that have non-linear -activation functions.

-

Such networks are often called multilayer perceptrons (MLPs).

-

According to the Universal approximation theorem, a feed-forward -neural network with just a single hidden layer containing a finite -number of neurons can approximate a continuous multidimensional -function to arbitrary accuracy, assuming the activation function for -the hidden layer is a non-constant, bounded and -monotonically-increasing continuous function.

-

Note that the requirements on the activation function only applies to -the hidden layer, the output nodes are always assumed to be linear, so -as to not restrict the range of output values.

-

The output \(y\) is produced via the activation function \(f\)

-
-\[ -y = f\left(\sum_{i=1}^n w_ix_i + b_i\right) = f(z), -\]
-

This function receives \(x_i\) as inputs. -Here the activation \(z=(\sum_{i=1}^n w_ix_i+b_i)\). -In an FFNN of such neurons, the inputs \(x_i\) are the outputs of -the neurons in the preceding layer. Furthermore, an MLP is -fully-connected, which means that each neuron receives a weighted sum -of the outputs of all neurons in the previous layer.

-

First, for each node \(i\) in the first hidden layer, we calculate a weighted sum \(z_i^1\) of the input coordinates \(x_j\),

- -
-
-\[ -\begin{equation} z_i^1 = \sum_{j=1}^{M} w_{ij}^1 x_j + b_i^1 -\label{_auto1} \tag{2} -\end{equation} -\]
-

Here \(b_i\) is the so-called bias which is normally needed in -case of zero activation weights or inputs. How to fix the biases and -the weights will be discussed below. The value of \(z_i^1\) is the -argument to the activation function \(f_i\) of each node \(i\), The -variable \(M\) stands for all possible inputs to a given node \(i\) in the -first layer. We define the output \(y_i^1\) of all neurons in layer 1 as

- -
-
-\[ -\begin{equation} - y_i^1 = f(z_i^1) = f\left(\sum_{j=1}^M w_{ij}^1 x_j + b_i^1\right) -\label{outputLayer1} \tag{3} -\end{equation} -\]
-

where we assume that all nodes in the same layer have identical -activation functions, hence the notation \(f\). In general, we could assume in the more general case that different layers have different activation functions. -In this case we would identify these functions with a superscript \(l\) for the \(l\)-th layer,

- -
-
-\[ -\begin{equation} - 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) -\label{generalLayer} \tag{4} -\end{equation} -\]
-

where \(N_l\) is the number of nodes in layer \(l\). When the output of -all the nodes in the first hidden layer are computed, the values of -the subsequent layer can be calculated and so forth until the output -is obtained.

-

The output of neuron \(i\) in layer 2 is thus,

- -
-
-\[ -\begin{equation} - y_i^2 = f^2\left(\sum_{j=1}^N w_{ij}^2 y_j^1 + b_i^2\right) -\label{_auto2} \tag{5} -\end{equation} -\]
- -
-
-\[ -\begin{equation} - = 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] -\label{outputLayer2} \tag{6} -\end{equation} -\]
-

where we have substituted \(y_k^1\) with the inputs \(x_k\). Finally, the ANN output reads

- -
-
-\[ -\begin{equation} - y_i^3 = f^3\left(\sum_{j=1}^N w_{ij}^3 y_j^2 + b_i^3\right) -\label{_auto3} \tag{7} -\end{equation} -\]
- -
-
-\[ -\begin{equation} - = 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) - + b_1^3\right] -\label{_auto4} \tag{8} -\end{equation} -\]
-

We can generalize this expression to an MLP with \(l\) hidden -layers. The complete functional form is,

- -
-
-\[ -\begin{equation} -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] -\label{completeNN} \tag{9} -\end{equation} -\]
-

which illustrates a basic property of MLPs: The only independent -variables are the input values \(x_n\).

-

This confirms that an MLP, despite its quite convoluted mathematical -form, is nothing more than an analytic function, specifically a -mapping of real-valued vectors \(\hat{x} \in \mathbb{R}^n \rightarrow -\hat{y} \in \mathbb{R}^m\).

-

Furthermore, the flexibility and universality of an MLP can be -illustrated by realizing that the expression is essentially a nested -sum of scaled activation functions of the form

- -
-
-\[ -\begin{equation} - f(x) = c_1 f(c_2 x + c_3) + c_4 -\label{_auto5} \tag{10} -\end{equation} -\]
-

where the parameters \(c_i\) are weights and biases. By adjusting these -parameters, the activation functions can be shifted up and down or -left and right, change slope or be rescaled which is the key to the -flexibility of a neural network.

-

We can introduce a more convenient notation for the activations in an A NN.

-

Additionally, we can represent the biases and activations -as layer-wise column vectors \(\hat{b}_l\) and \(\hat{y}_l\), so that the \(i\)-th element of each vector -is the bias \(b_i^l\) and activation \(y_i^l\) of node \(i\) in layer \(l\) respectively.

-

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. -With this notation, the sum becomes a matrix-vector multiplication, and we can write -the equation for the activations of hidden layer 2 (assuming three nodes for simplicity) as

- -
-
-\[\begin{split} -\begin{equation} - \hat{y}_2 = f_2(\mathrm{W}_2 \hat{y}_{1} + \hat{b}_{2}) = - f_2\left(\left[\begin{array}{ccc} - w^2_{11} &w^2_{12} &w^2_{13} \\ - w^2_{21} &w^2_{22} &w^2_{23} \\ - w^2_{31} &w^2_{32} &w^2_{33} \\ - \end{array} \right] \cdot - \left[\begin{array}{c} - y^1_1 \\ - y^1_2 \\ - y^1_3 \\ - \end{array}\right] + - \left[\begin{array}{c} - b^2_1 \\ - b^2_2 \\ - b^2_3 \\ - \end{array}\right]\right). -\label{_auto6} \tag{11} -\end{equation} -\end{split}\]
-
-

13.5.1. Matrix-vector notation and activation

-

The activation of node \(i\) in layer 2 is

- -
-
-\[ -\begin{equation} - 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) = - f_2\left(\sum_{j=1}^3 w^2_{ij} y_j^1 + b^2_i\right). -\label{_auto7} \tag{12} -\end{equation} -\]
-

This is not just a convenient and compact notation, but also a useful -and intuitive way to think about MLPs: The output is calculated by a -series of matrix-vector multiplications and vector additions that are -used as input to the activation functions. For each operation -\(\mathrm{W}_l \hat{y}_{l-1}\) we move forward one layer.

-
-
-

13.5.2. Activation functions

-

A property that characterizes a neural network, other than its -connectivity, is the choice of activation function(s). As described -in, the following restrictions are imposed on an activation function -for a FFNN to fulfill the universal approximation theorem

-
    -
  • Non-constant

  • -
  • Bounded

  • -
  • Monotonically-increasing

  • -
  • Continuous

  • -
-

The second requirement excludes all linear functions. Furthermore, in -a MLP with only linear activation functions, each layer simply -performs a linear transformation of its inputs.

-

Regardless of the number of layers, the output of the NN will be -nothing but a linear function of the inputs. Thus we need to introduce -some kind of non-linearity to the NN to be able to fit non-linear -functions Typical examples are the logistic Sigmoid

-
-\[ -f(x) = \frac{1}{1 + e^{-x}}, -\]
-

and the hyperbolic tangent function

-
-\[ -f(x) = \tanh(x) -\]
-

The sigmoid function are more biologically plausible because the -output of inactive neurons are zero. Such activation function are -called one-sided. However, it has been shown that the hyperbolic -tangent performs better than the sigmoid for training MLPs. has -become the most popular for deep neural networks

-
-
-
%matplotlib inline
-
-"""The sigmoid function (or the logistic curve) is a 
-function that takes any real number, z, and outputs a number (0,1).
-It is useful in neural networks for assigning weights on a relative scale.
-The value z is the weighted sum of parameters involved in the learning algorithm."""
-
-import numpy
-import matplotlib.pyplot as plt
-import math as mt
-
-z = numpy.arange(-5, 5, .1)
-sigma_fn = numpy.vectorize(lambda z: 1/(1+numpy.exp(-z)))
-sigma = sigma_fn(z)
-
-fig = plt.figure()
-ax = fig.add_subplot(111)
-ax.plot(z, sigma)
-ax.set_ylim([-0.1, 1.1])
-ax.set_xlim([-5,5])
-ax.grid(True)
-ax.set_xlabel('z')
-ax.set_title('sigmoid function')
-
-plt.show()
-
-"""Step Function"""
-z = numpy.arange(-5, 5, .02)
-step_fn = numpy.vectorize(lambda z: 1.0 if z >= 0.0 else 0.0)
-step = step_fn(z)
-
-fig = plt.figure()
-ax = fig.add_subplot(111)
-ax.plot(z, step)
-ax.set_ylim([-0.5, 1.5])
-ax.set_xlim([-5,5])
-ax.grid(True)
-ax.set_xlabel('z')
-ax.set_title('step function')
-
-plt.show()
-
-"""Sine Function"""
-z = numpy.arange(-2*mt.pi, 2*mt.pi, 0.1)
-t = numpy.sin(z)
-
-fig = plt.figure()
-ax = fig.add_subplot(111)
-ax.plot(z, t)
-ax.set_ylim([-1.0, 1.0])
-ax.set_xlim([-2*mt.pi,2*mt.pi])
-ax.grid(True)
-ax.set_xlabel('z')
-ax.set_title('sine function')
-
-plt.show()
-
-"""Plots a graph of the squashing function used by a rectified linear
-unit"""
-z = numpy.arange(-2, 2, .1)
-zero = numpy.zeros(len(z))
-y = numpy.max([zero, z], axis=0)
-
-fig = plt.figure()
-ax = fig.add_subplot(111)
-ax.plot(z, y)
-ax.set_ylim([-2.0, 2.0])
-ax.set_xlim([-2.0, 2.0])
-ax.grid(True)
-ax.set_xlabel('z')
-ax.set_title('Rectified linear unit')
-
-plt.show()
-
-
-
-
-_images/chapter9_29_0.png -_images/chapter9_29_1.png -_images/chapter9_29_2.png -_images/chapter9_29_3.png -
-
-
-
-
-

13.6. The multilayer perceptron (MLP)

-

The multilayer perceptron is a very popular, and easy to implement approach, to deep learning. It consists of

-
    -
  1. A neural network with one or more layers of nodes between the input and the output nodes.

  2. -
  3. The multilayer network structure, or architecture, or topology, consists of an input layer, one or more hidden layers, and one output layer.

  4. -
  5. 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.

  6. -
-

As a convention it is normal to call a network with one layer of input units, one layer of hidden -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.

-

For an MLP network there is no direct connection between the output nodes/neurons/units and the input nodes/neurons/units. -Hereafter we will call the various entities of a layer for nodes. -There are also no connections within a single layer.

-

The number of input nodes does not need to equal the number of output -nodes. This applies also to the hidden layers. Each layer may have its -own number of nodes and activation functions.

-

The hidden layers have their name from the fact that they are not -linked to observables and as we will see below when we define the -so-called activation \(\hat{z}\), we can think of this as a basis -expansion of the original inputs \(\hat{x}\). The difference however -between neural networks and say linear regression is that now these -basis functions (which will correspond to the weights in the network) -are learned from data. This results in an important difference between -neural networks and deep learning approaches on one side and methods -like logistic regression or linear regression and their modifications on the other side.

-
-

13.6.1. From one to many layers, the universal approximation theorem

-

A neural network with only one layer, what we called the simple -perceptron, is best suited if we have a standard binary model with -clear (linear) boundaries between the outcomes. As such it could -equally well be replaced by standard linear regression or logistic -regression. Networks with one or more hidden layers approximate -systems with more complex boundaries.

-

As stated earlier, -an important theorem in studies of neural networks, restated without -proof here, is the universal approximation -theorem.

-

It states that a feed-forward network with a single hidden layer -containing a finite number of neurons can approximate continuous -functions on compact subsets of real functions. The theorem thus -states that simple neural networks can represent a wide variety of -interesting functions when given appropriate parameters. It is the -multilayer feedforward architecture itself which gives neural networks -the potential of being universal approximators.

-
-
-
-

13.7. Deriving the back propagation code for a multilayer perceptron model

-

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. -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. -This leads us to the famous back propagation algorithm.

-

The questions we want to ask are how do changes in the biases and the -weights in our network change the cost function and how can we use the -final output to modify the weights?

-

To derive these equations let us start with a plain regression problem -and define our cost function as

-
-\[ -{\cal C}(\hat{W}) = \frac{1}{2}\sum_{i=1}^n\left(y_i - t_i\right)^2, -\]
-

where the \(t_i\)s are our \(n\) targets (the values we want to -reproduce), while the outputs of the network after having propagated -all inputs \(\hat{x}\) are given by \(y_i\). Below we will demonstrate -how the basic equations arising from the back propagation algorithm -can be modified in order to study classification problems with \(K\) -classes.

-

With our definition of the targets \(\hat{t}\), the outputs of the -network \(\hat{y}\) and the inputs \(\hat{x}\) we -define now the activation \(z_j^l\) of node/neuron/unit \(j\) of the -\(l\)-th layer as a function of the bias, the weights which add up from -the previous layer \(l-1\) and the forward passes/outputs -\(\hat{a}^{l-1}\) from the previous layer as

-
-\[ -z_j^l = \sum_{i=1}^{M_{l-1}}w_{ij}^la_i^{l-1}+b_j^l, -\]
-

where \(b_k^l\) are the biases from layer \(l\). Here \(M_{l-1}\) -represents the total number of nodes/neurons/units of layer \(l-1\). The -figure here illustrates this equation. We can rewrite this in a more -compact form as the matrix-vector products we discussed earlier,

-
-\[ -\hat{z}^l = \left(\hat{W}^l\right)^T\hat{a}^{l-1}+\hat{b}^l. -\]
-

With the activation values \(\hat{z}^l\) we can in turn define the -output of layer \(l\) as \(\hat{a}^l = f(\hat{z}^l)\) where \(f\) is our -activation function. In the examples here we will use the sigmoid -function discussed in our logistic regression lectures. We will also use the same activation function \(f\) for all layers -and their nodes. It means we have

-
-\[ -a_j^l = f(z_j^l) = \frac{1}{1+\exp{-(z_j^l)}}. -\]
-
-

13.7.1. Derivatives and the chain rule

-

From the definition of the activation \(z_j^l\) we have

-
-\[ -\frac{\partial z_j^l}{\partial w_{ij}^l} = a_i^{l-1}, -\]
-

and

-
-\[ -\frac{\partial z_j^l}{\partial a_i^{l-1}} = w_{ji}^l. -\]
-

With our definition of the activation function we have that (note that this function depends only on \(z_j^l\))

-
-\[ -\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)). -\]
-

With these definitions we can now compute the derivative of the cost function in terms of the weights.

-

Let us specialize to the output layer \(l=L\). Our cost function is

-
-\[ -{\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, -\]
-

The derivative of this function with respect to the weights is

-
-\[ -\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}}, -\]
-

The last partial derivative can easily be computed and reads (by applying the chain rule)

-
-\[ -\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}, -\]
-
-
-

13.7.2. Bringing it together, first back propagation equation

-

We have thus

-
-\[ -\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}, -\]
-

Defining

-
-\[ -\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)}, -\]
-

and using the Hadamard product of two vectors we can write this as

-
-\[ -\hat{\delta}^L = f'(\hat{z}^L)\circ\frac{\partial {\cal C}}{\partial (\hat{a}^L)}. -\]
-

This is an important expression. The second term on the right handside -measures how fast the cost function is changing as a function of the \(j\)th -output activation. If, for example, the cost function doesn’t depend -much on a particular output node \(j\), then \(\delta_j^L\) will be small, -which is what we would expect. The first term on the right, measures -how fast the activation function \(f\) is changing at a given activation -value \(z_j^L\).

-

Notice that everything in the above equations is easily computed. In -particular, we compute \(z_j^L\) while computing the behaviour of the -network, and it is only a small additional overhead to compute -\(f'(z^L_j)\). The exact form of the derivative with respect to the -output depends on the form of the cost function. -However, provided the cost function is known there should be little -trouble in calculating

-
-\[ -\frac{\partial {\cal C}}{\partial (a_j^L)} -\]
-

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

-
-\[ -\frac{\partial{\cal C}(\hat{W^L})}{\partial w_{jk}^L} = \delta_j^La_k^{L-1}. -\]
-

It is also easy to see that our previous equation can be written as

-
-\[ -\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}, -\]
-

which can also be interpreted as the partial derivative of the cost function with respect to the biases \(b_j^L\), namely

-
-\[ -\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}, -\]
-

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.

-

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

-

The starting equations.

- -
-
-\[ -\begin{equation} -\frac{\partial{\cal C}(\hat{W^L})}{\partial w_{jk}^L} = \delta_j^La_k^{L-1}, -\label{_auto8} \tag{13} -\end{equation} -\]
-

and

- -
-
-\[ -\begin{equation} -\delta_j^L = f'(z_j^L)\frac{\partial {\cal C}}{\partial (a_j^L)}, -\label{_auto9} \tag{14} -\end{equation} -\]
-

and

- -
-
-\[ -\begin{equation} -\delta_j^L = \frac{\partial {\cal C}}{\partial b_j^L}, -\label{_auto10} \tag{15} -\end{equation} -\]
-

An interesting consequence of the above equations is that when the -activation \(a_k^{L-1}\) is small, the gradient term, that is the -derivative of the cost function with respect to the weights, will also -tend to be small. We say then that the weight learns slowly, meaning -that it changes slowly when we minimize the weights via say gradient -descent. In this case we say the system learns slowly.

-

Another interesting feature is that is when the activation function, -represented by the sigmoid function here, is rather flat when we move towards -its end values \(0\) and \(1\) (see the above Python codes). In these -cases, the derivatives of the activation function will also be close -to zero, meaning again that the gradients will be small and the -network learns slowly again.

-

We need a fourth equation and we are set. We are going to propagate -backwards in order to the determine the weights and biases. In order -to do so we need to represent the error in the layer before the final -one \(L-1\) in terms of the errors in the final output layer.

-
-
-

13.7.3. Final back propagating equation

-

We have that (replacing \(L\) with a general layer \(l\))

-
-\[ -\delta_j^l =\frac{\partial {\cal C}}{\partial z_j^l}. -\]
-

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

-
-\[ -\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}}, -\]
-

and recalling that

-
-\[ -z_j^{l+1} = \sum_{i=1}^{M_{l}}w_{ij}^{l+1}a_i^{l}+b_j^{l+1}, -\]
-

with \(M_l\) being the number of nodes in layer \(l\), we obtain

-
-\[ -\delta_j^l =\sum_k \delta_k^{l+1}w_{kj}^{l+1}f'(z_j^l), -\]
-

This is our final equation.

-

We are now ready to set up the algorithm for back propagation and learning the weights and biases.

-
-
-

13.7.4. Setting up the Back propagation algorithm

-

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.

-

First, we set up the input data \(\hat{x}\) and the activations -\(\hat{z}_1\) of the input layer and compute the activation function and -the pertinent outputs \(\hat{a}^1\).

-

Secondly, we perform then the feed forward till we reach the output -layer and compute all \(\hat{z}_l\) of the input layer and compute the -activation function and the pertinent outputs \(\hat{a}^l\) for -\(l=2,3,\dots,L\).

-

Thereafter we compute the ouput error \(\hat{\delta}^L\) by computing all

-
-\[ -\delta_j^L = f'(z_j^L)\frac{\partial {\cal C}}{\partial (a_j^L)}. -\]
-

Then we compute the back propagate error for each \(l=L-1,L-2,\dots,2\) as

-
-\[ -\delta_j^l = \sum_k \delta_k^{l+1}w_{kj}^{l+1}f'(z_j^l). -\]
-

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

-
-\[ -w_{jk}^l\leftarrow = w_{jk}^l- \eta \delta_j^la_k^{l-1}, -\]
-
-\[ -b_j^l \leftarrow b_j^l-\eta \frac{\partial {\cal C}}{\partial b_j^l}=b_j^l-\eta \delta_j^l, -\]
-

The parameter \(\eta\) is the learning parameter discussed in connection with the gradient descent methods. -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.

-
-
-
- - - - -
- - - - -
-
-
-
-

- - By Morten Hjorth-Jensen
- - © Copyright 2021.
-

-
-
-
- - -
-
- - - - - - \ No newline at end of file diff --git a/doc/LectureNotes/_build/html/chapteroptimization.html b/doc/LectureNotes/_build/html/chapteroptimization.html deleted file mode 100644 index 837f79068..000000000 --- a/doc/LectureNotes/_build/html/chapteroptimization.html +++ /dev/null @@ -1,2167 +0,0 @@ - - - - - - - - 7. Optimization, the central part of any Machine Learning algortithm — Applied Data Analysis and Machine Learning - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
- - - - - - - - -
- - -
-
- -
- -
-

7. Optimization, the central part of any Machine Learning algortithm

-

Almost every problem in machine learning and data science starts with -a dataset \(X\), a model \(g(\beta)\), which is a function of the -parameters \(\beta\) and a cost function \(C(X, g(\beta))\) that allows -us to judge how well the model \(g(\beta)\) explains the observations -\(X\). The model is fit by finding the values of \(\beta\) that minimize -the cost function. Ideally we would be able to solve for \(\beta\) -analytically, however this is not possible in general and we must use -some approximative/numerical method to compute the minimum.

-

In our discussion on Logistic Regression we studied the -case of -two classes, with \(y_i\) either -\(0\) or \(1\). Furthermore we assumed also that we have only two -parameters \(\beta\) in our fitting, that is we -defined probabilities

-
-\[\begin{split} -\begin{align*} -p(y_i=1|x_i,\boldsymbol{\beta}) &= \frac{\exp{(\beta_0+\beta_1x_i)}}{1+\exp{(\beta_0+\beta_1x_i)}},\nonumber\\ -p(y_i=0|x_i,\boldsymbol{\beta}) &= 1 - p(y_i=1|x_i,\boldsymbol{\beta}), -\end{align*} -\end{split}\]
-

where \(\boldsymbol{\beta}\) are the weights we wish to extract from data, in our case \(\beta_0\) and \(\beta_1\).

-

Our compact equations used a definition of a vector \(\boldsymbol{y}\) with \(n\) -elements \(y_i\), an \(n\times p\) matrix \(\boldsymbol{X}\) which contains the -\(x_i\) values and a vector \(\boldsymbol{p}\) of fitted probabilities -\(p(y_i\vert x_i,\boldsymbol{\beta})\). We rewrote in a more compact form -the first derivative of the cost function as

-
-\[ -\frac{\partial \mathcal{C}(\boldsymbol{\beta})}{\partial \boldsymbol{\beta}} = -\boldsymbol{X}^T\left(\boldsymbol{y}-\boldsymbol{p}\right). -\]
-

If we in addition define a diagonal matrix \(\boldsymbol{W}\) with elements -\(p(y_i\vert x_i,\boldsymbol{\beta})(1-p(y_i\vert x_i,\boldsymbol{\beta})\), we can obtain a compact expression of the second derivative as

-
-\[ -\frac{\partial^2 \mathcal{C}(\boldsymbol{\beta})}{\partial \boldsymbol{\beta}\partial \boldsymbol{\beta}^T} = \boldsymbol{X}^T\boldsymbol{W}\boldsymbol{X}. -\]
-

This defines what is called the Hessian matrix.

-

If we can set up these equations, Newton-Raphson’s iterative method is normally the method of choice. It requires however that we can compute in an efficient way the matrices that define the first and second derivatives.

-

Our iterative scheme is then given by

-
-\[ -\boldsymbol{\beta}^{\mathrm{new}} = \boldsymbol{\beta}^{\mathrm{old}}-\left(\frac{\partial^2 \mathcal{C}(\boldsymbol{\beta})}{\partial \boldsymbol{\beta}\partial \boldsymbol{\beta}^T}\right)^{-1}_{\boldsymbol{\beta}^{\mathrm{old}}}\times \left(\frac{\partial \mathcal{C}(\boldsymbol{\beta})}{\partial \boldsymbol{\beta}}\right)_{\boldsymbol{\beta}^{\mathrm{old}}}, -\]
-

or in matrix form as

-
-\[ -\boldsymbol{\beta}^{\mathrm{new}} = \boldsymbol{\beta}^{\mathrm{old}}-\left(\boldsymbol{X}^T\boldsymbol{W}\boldsymbol{X} \right)^{-1}\times \left(-\boldsymbol{X}^T(\boldsymbol{y}-\boldsymbol{p}) \right)_{\boldsymbol{\beta}^{\mathrm{old}}}. -\]
-

The right-hand side is computed with the old values of \(\beta\).

-

If we can compute these matrices, in particular the Hessian, the above is often the easiest method to implement.

-

Let us quickly remind ourselves how we derive the above method.

-

Perhaps the most celebrated of all one-dimensional root-finding -routines is Newton’s method, also called the Newton-Raphson -method. This method requires the evaluation of both the -function \(f\) and its derivative \(f'\) at arbitrary points. -If you can only calculate the derivative -numerically and/or your function is not of the smooth type, we -normally discourage the use of this method.

-

The Newton-Raphson formula consists geometrically of extending the -tangent line at a current point until it crosses zero, then setting -the next guess to the abscissa of that zero-crossing. The mathematics -behind this method is rather simple. Employing a Taylor expansion for -\(x\) sufficiently close to the solution \(s\), we have

- -
-
-\[ -f(s)=0=f(x)+(s-x)f'(x)+\frac{(s-x)^2}{2}f''(x) +\dots. - \label{eq:taylornr} \tag{1} -\]
-

For small enough values of the function and for well-behaved -functions, the terms beyond linear are unimportant, hence we obtain

-
-\[ -f(x)+(s-x)f'(x)\approx 0, -\]
-

yielding

-
-\[ -s\approx x-\frac{f(x)}{f'(x)}. -\]
-

Having in mind an iterative procedure, it is natural to start iterating with

-
-\[ -x_{n+1}=x_n-\frac{f(x_n)}{f'(x_n)}. -\]
-

The above is Newton-Raphson’s method. It has a simple geometric -interpretation, namely \(x_{n+1}\) is the point where the tangent from -\((x_n,f(x_n))\) crosses the \(x\)-axis. Close to the solution, -Newton-Raphson converges fast to the desired result. However, if we -are far from a root, where the higher-order terms in the series are -important, the Newton-Raphson formula can give grossly inaccurate -results. For instance, the initial guess for the root might be so far -from the true root as to let the search interval include a local -maximum or minimum of the function. If an iteration places a trial -guess near such a local extremum, so that the first derivative nearly -vanishes, then Newton-Raphson may fail totally

-

Newton’s method can be generalized to systems of several non-linear equations -and variables. Consider the case with two equations

-
-\[\begin{split} -\begin{array}{cc} f_1(x_1,x_2) &=0\\ - f_2(x_1,x_2) &=0,\end{array} -\end{split}\]
-

which we Taylor expand to obtain

-
-\[\begin{split} -\begin{array}{cc} 0=f_1(x_1+h_1,x_2+h_2)=&f_1(x_1,x_2)+h_1 - \partial f_1/\partial x_1+h_2 - \partial f_1/\partial x_2+\dots\\ - 0=f_2(x_1+h_1,x_2+h_2)=&f_2(x_1,x_2)+h_1 - \partial f_2/\partial x_1+h_2 - \partial f_2/\partial x_2+\dots - \end{array}. -\end{split}\]
-

Defining the Jacobian matrix \(\boldsymbol{J}\) we have

-
-\[\begin{split} -\boldsymbol{J}=\left( \begin{array}{cc} - \partial f_1/\partial x_1 & \partial f_1/\partial x_2 \\ - \partial f_2/\partial x_1 &\partial f_2/\partial x_2 - \end{array} \right), -\end{split}\]
-

we can rephrase Newton’s method as

-
-\[\begin{split} -\left(\begin{array}{c} x_1^{n+1} \\ x_2^{n+1} \end{array} \right)= -\left(\begin{array}{c} x_1^{n} \\ x_2^{n} \end{array} \right)+ -\left(\begin{array}{c} h_1^{n} \\ h_2^{n} \end{array} \right), -\end{split}\]
-

where we have defined

-
-\[\begin{split} -\left(\begin{array}{c} h_1^{n} \\ h_2^{n} \end{array} \right)= - -\boldsymbol{J}^{-1} - \left(\begin{array}{c} f_1(x_1^{n},x_2^{n}) \\ f_2(x_1^{n},x_2^{n}) \end{array} \right). -\end{split}\]
-

We need thus to compute the inverse of the Jacobian matrix and it -is to understand that difficulties may -arise in case \(\boldsymbol{J}\) is nearly singular.

-

It is rather straightforward to extend the above scheme to systems of -more than two non-linear equations. In our case, the Jacobian matrix is given by the Hessian that represents the second derivative of cost function.

-
-

7.1. Steepest descent

-

The basic idea of gradient descent is -that a function \(F(\mathbf{x})\), -\(\mathbf{x} \equiv (x_1,\cdots,x_n)\), decreases fastest if one goes from \(\bf {x}\) in the -direction of the negative gradient \(-\nabla F(\mathbf{x})\).

-

It can be shown that if

-
-\[ -\mathbf{x}_{k+1} = \mathbf{x}_k - \gamma_k \nabla F(\mathbf{x}_k), -\]
-

with \(\gamma_k > 0\).

-

For \(\gamma_k\) small enough, then \(F(\mathbf{x}_{k+1}) \leq -F(\mathbf{x}_k)\). This means that for a sufficiently small \(\gamma_k\) -we are always moving towards smaller function values, i.e a minimum.

-

The previous observation is the basis of the method of steepest -descent, which is also referred to as just gradient descent (GD). One -starts with an initial guess \(\mathbf{x}_0\) for a minimum of \(F\) and -computes new approximations according to

-
-\[ -\mathbf{x}_{k+1} = \mathbf{x}_k - \gamma_k \nabla F(\mathbf{x}_k), \ \ k \geq 0. -\]
-

The parameter \(\gamma_k\) is often referred to as the step length or -the learning rate within the context of Machine Learning.

-

Ideally the sequence \(\{\mathbf{x}_k \}_{k=0}\) converges to a global -minimum of the function \(F\). In general we do not know if we are in a -global or local minimum. In the special case when \(F\) is a convex -function, all local minima are also global minima, so in this case -gradient descent can converge to the global solution. The advantage of -this scheme is that it is conceptually simple and straightforward to -implement. However the method in this form has some severe -limitations:

-

In machine learing we are often faced with non-convex high dimensional -cost functions with many local minima. Since GD is deterministic we -will get stuck in a local minimum, if the method converges, unless we -have a very good intial guess. This also implies that the scheme is -sensitive to the chosen initial condition.

-

Note that the gradient is a function of \(\mathbf{x} = -(x_1,\cdots,x_n)\) which makes it expensive to compute numerically.

-

The gradient descent method -is sensitive to the choice of learning rate \(\gamma_k\). This is due -to the fact that we are only guaranteed that \(F(\mathbf{x}_{k+1}) \leq -F(\mathbf{x}_k)\) for sufficiently small \(\gamma_k\). The problem is to -determine an optimal learning rate. If the learning rate is chosen too -small the method will take a long time to converge and if it is too -large we can experience erratic behavior.

-

Many of these shortcomings can be alleviated by introducing -randomness. One such method is that of Stochastic Gradient Descent -(SGD), see below.

-
-
-

7.2. Convex functions

-

Ideally we want our cost/loss function to be convex(concave).

-

First we give the definition of a convex set: A set \(C\) in -\(\mathbb{R}^n\) is said to be convex if, for all \(x\) and \(y\) in \(C\) and -all \(t \in (0,1)\) , the point \((1 − t)x + ty\) also belongs to -C. Geometrically this means that every point on the line segment -connecting \(x\) and \(y\) is in \(C\) as discussed below.

-

The convex subsets of \(\mathbb{R}\) are the intervals of -\(\mathbb{R}\). Examples of convex sets of \(\mathbb{R}^2\) are the -regular polygons (triangles, rectangles, pentagons, etc…).

-

Convex function: Let \(X \subset \mathbb{R}^n\) be a convex set. Assume that the function \(f: X \rightarrow \mathbb{R}\) is continuous, then \(f\) is said to be convex if $\(f(tx_1 + (1-t)x_2) \leq tf(x_1) + (1-t)f(x_2) \)\( for all \)x_1, x_2 \in X\( and for all \)t \in [0,1]\(. If \)\leq\( is replaced with a strict inequaltiy in the definition, we demand \)x_1 \neq x_2\( and \)t\in(0,1)\( then \)f\( is said to be strictly convex. For a single variable function, convexity means that if you draw a straight line connecting \)f(x_1)\( and \)f(x_2)\(, the value of the function on the interval \)[x_1,x_2]$ is always below the line as illustrated below.

-

In the following we state first and second-order conditions which -ensures convexity of a function \(f\). We write \(D_f\) to denote the -domain of \(f\), i.e the subset of \(R^n\) where \(f\) is defined. For more -details and proofs we refer to: [S. Boyd and L. Vandenberghe. Convex Optimization. Cambridge University Press](http://stanford.edu/boyd/cvxbook/, 2004).

-

First order condition.

-

Suppose \(f\) is differentiable (i.e \(\nabla f(x)\) is well defined for -all \(x\) in the domain of \(f\)). Then \(f\) is convex if and only if \(D_f\) -is a convex set and $\(f(y) \geq f(x) + \nabla f(x)^T (y-x) \)\( holds -for all \)x,y \in D_f\(. This condition means that for a convex function -the first order Taylor expansion (right hand side above) at any point -a global under estimator of the function. To convince yourself you can -make a drawing of \)f(x) = x^2+1\( and draw the tangent line to \)f(x)$ and -note that it is always below the graph.

-

Second order condition.

-

Assume that \(f\) is twice -differentiable, i.e the Hessian matrix exists at each point in -\(D_f\). Then \(f\) is convex if and only if \(D_f\) is a convex set and its -Hessian is positive semi-definite for all \(x\in D_f\). For a -single-variable function this reduces to \(f''(x) \geq 0\). Geometrically this means that \(f\) has nonnegative curvature -everywhere.

-

This condition is particularly useful since it gives us an procedure for determining if the function under consideration is convex, apart from using the definition.

-

The next result is of great importance to us and the reason why we are -going on about convex functions. In machine learning we frequently -have to minimize a loss/cost function in order to find the best -parameters for the model we are considering.

-

Ideally we want the -global minimum (for high-dimensional models it is hard to know -if we have local or global minimum). However, if the cost/loss function -is convex the following result provides invaluable information:

-

Any minimum is global for convex functions.

-

Consider the problem of finding \(x \in \mathbb{R}^n\) such that \(f(x)\) -is minimal, where \(f\) is convex and differentiable. Then, any point -\(x^*\) that satisfies \(\nabla f(x^*) = 0\) is a global minimum.

-

This result means that if we know that the cost/loss function is convex and we are able to find a minimum, we are guaranteed that it is a global minimum.

-
-

7.2.1. Some simple problems

-
    -
  1. Show that \(f(x)=x^2\) is convex for \(x \in \mathbb{R}\) using the definition of convexity. Hint: If you re-write the definition, \(f\) is convex if the following holds for all \(x,y \in D_f\) and any \(\lambda \in [0,1]\) \(\lambda f(x)+(1-\lambda)f(y)-f(\lambda x + (1-\lambda) y ) \geq 0\).

  2. -
  3. Using the second order condition show that the following functions are convex on the specified domain.

  4. -
-
    -
  • \(f(x) = e^x\) is convex for \(x \in \mathbb{R}\).

  • -
  • \(g(x) = -\ln(x)\) is convex for \(x \in (0,\infty)\).

  • -
-
    -
  1. Let \(f(x) = x^2\) and \(g(x) = e^x\). Show that \(f(g(x))\) and \(g(f(x))\) is convex for \(x \in \mathbb{R}\). Also show that if \(f(x)\) is any convex function than \(h(x) = e^{f(x)}\) is convex.

  2. -
  3. A norm is any function that satisfy the following properties

  4. -
-
    -
  • \(f(\alpha x) = |\alpha| f(x)\) for all \(\alpha \in \mathbb{R}\).

  • -
  • \(f(x+y) \leq f(x) + f(y)\)

  • -
  • \(f(x) \leq 0\) for all \(x \in \mathbb{R}^n\) with equality if and only if \(x = 0\)

  • -
-

Using the definition of convexity, try to show that a function satisfying the properties above is convex (the third condition is not needed to show this).

-
-
-
-

7.3. Standard steepest descent

-

Before we proceed, we would like to discuss the approach called the -standard Steepest descent (different from the above steepest descent discussion), which again leads to us having to be able -to compute a matrix. It belongs to the class of Conjugate Gradient methods (CG).

-

The success of the CG method -for finding solutions of non-linear problems is based on the theory -of conjugate gradients for linear systems of equations. It belongs to -the class of iterative methods for solving problems from linear -algebra of the type

-
-\[ -\boldsymbol{A}\boldsymbol{x} = \boldsymbol{b}. -\]
-

In the iterative process we end up with a problem like

-
-\[ -\boldsymbol{r}= \boldsymbol{b}-\boldsymbol{A}\boldsymbol{x}, -\]
-

where \(\boldsymbol{r}\) is the so-called residual or error in the iterative process.

-

When we have found the exact solution, \(\boldsymbol{r}=0\).

-

The residual is zero when we reach the minimum of the quadratic equation

-
-\[ -P(\boldsymbol{x})=\frac{1}{2}\boldsymbol{x}^T\boldsymbol{A}\boldsymbol{x} - \boldsymbol{x}^T\boldsymbol{b}, -\]
-

with the constraint that the matrix \(\boldsymbol{A}\) is positive definite and -symmetric. This defines also the Hessian and we want it to be positive definite.

-

We denote the initial guess for \(\boldsymbol{x}\) as \(\boldsymbol{x}_0\). -We can assume without loss of generality that

-
-\[ -\boldsymbol{x}_0=0, -\]
-

or consider the system

-
-\[ -\boldsymbol{A}\boldsymbol{z} = \boldsymbol{b}-\boldsymbol{A}\boldsymbol{x}_0, -\]
-

instead.

-

One can show that the solution \(\boldsymbol{x}\) is also the unique minimizer of the quadratic form

-
-\[ -f(\boldsymbol{x}) = \frac{1}{2}\boldsymbol{x}^T\boldsymbol{A}\boldsymbol{x} - \boldsymbol{x}^T \boldsymbol{x} , \quad \boldsymbol{x}\in\mathbf{R}^n. -\]
-

This suggests taking the first basis vector \(\boldsymbol{r}_1\) (see below for definition) -to be the gradient of \(f\) at \(\boldsymbol{x}=\boldsymbol{x}_0\), -which equals

-
-\[ -\boldsymbol{A}\boldsymbol{x}_0-\boldsymbol{b}, -\]
-

and -\(\boldsymbol{x}_0=0\) it is equal \(-\boldsymbol{b}\).

-

We can compute the residual iteratively as

-
-\[ -\boldsymbol{r}_{k+1}=\boldsymbol{b}-\boldsymbol{A}\boldsymbol{x}_{k+1}, -\]
-

which equals

-
-\[ -\boldsymbol{b}-\boldsymbol{A}(\boldsymbol{x}_k+\alpha_k\boldsymbol{r}_k), -\]
-

or

-
-\[ -(\boldsymbol{b}-\boldsymbol{A}\boldsymbol{x}_k)-\alpha_k\boldsymbol{A}\boldsymbol{r}_k, -\]
-

which gives

-
-\[ -\alpha_k = \frac{\boldsymbol{r}_k^T\boldsymbol{r}_k}{\boldsymbol{r}_k^T\boldsymbol{A}\boldsymbol{r}_k} -\]
-

leading to the iterative scheme

-
-\[ -\boldsymbol{x}_{k+1}=\boldsymbol{x}_k-\alpha_k\boldsymbol{r}_{k}, -\]
-
-
-
%matplotlib inline
-
-import numpy as np
-import numpy.linalg as la
-
-import scipy.optimize as sopt
-
-import matplotlib.pyplot as pt
-from mpl_toolkits.mplot3d import axes3d
-
-def f(x):
-    return 0.5*x[0]**2 + 2.5*x[1]**2
-
-def df(x):
-    return np.array([x[0], 5*x[1]])
-
-fig = pt.figure()
-ax = fig.gca(projection="3d")
-
-xmesh, ymesh = np.mgrid[-2:2:50j,-2:2:50j]
-fmesh = f(np.array([xmesh, ymesh]))
-ax.plot_surface(xmesh, ymesh, fmesh)
-
-
-
-
-
<mpl_toolkits.mplot3d.art3d.Poly3DCollection at 0x7f9f087db790>
-
-
-_images/chapteroptimization_56_1.png -
-
-

And then as countor plot

-
-
-
pt.axis("equal")
-pt.contour(xmesh, ymesh, fmesh)
-guesses = [np.array([2, 2./5])]
-
-
-
-
-_images/chapteroptimization_58_0.png -
-
-

Find guesses

-
-
-
x = guesses[-1]
-s = -df(x)
-
-
-
-
-

Run it!

-
-
-
def f1d(alpha):
-    return f(x + alpha*s)
-
-alpha_opt = sopt.golden(f1d)
-next_guess = x + alpha_opt * s
-guesses.append(next_guess)
-print(next_guess)
-
-
-
-
-
[ 1.33333333 -0.26666667]
-
-
-
-
-

What happened?

-
-
-
pt.axis("equal")
-pt.contour(xmesh, ymesh, fmesh, 50)
-it_array = np.array(guesses)
-pt.plot(it_array.T[0], it_array.T[1], "x-")
-
-
-
-
-
[<matplotlib.lines.Line2D at 0x7f9f1a921340>]
-
-
-_images/chapteroptimization_64_1.png -
-
-
-
-

7.4. Conjugate gradient method

-

In the CG method we define so-called conjugate directions and two vectors -\(\boldsymbol{s}\) and \(\boldsymbol{t}\) -are said to be -conjugate if

-
-\[ -\boldsymbol{s}^T\boldsymbol{A}\boldsymbol{t}= 0. -\]
-

The philosophy of the CG method is to perform searches in various conjugate directions -of our vectors \(\boldsymbol{x}_i\) obeying the above criterion, namely

-
-\[ -\boldsymbol{x}_i^T\boldsymbol{A}\boldsymbol{x}_j= 0. -\]
-

Two vectors are conjugate if they are orthogonal with respect to -this inner product. Being conjugate is a symmetric relation: if \(\boldsymbol{s}\) is conjugate to \(\boldsymbol{t}\), then \(\boldsymbol{t}\) is conjugate to \(\boldsymbol{s}\).

-

An example is given by the eigenvectors of the matrix

-
-\[ -\boldsymbol{v}_i^T\boldsymbol{A}\boldsymbol{v}_j= \lambda\boldsymbol{v}_i^T\boldsymbol{v}_j, -\]
-

which is zero unless \(i=j\).

-

Assume now that we have a symmetric positive-definite matrix \(\boldsymbol{A}\) of size -\(n\times n\). At each iteration \(i+1\) we obtain the conjugate direction of a vector

-
-\[ -\boldsymbol{x}_{i+1}=\boldsymbol{x}_{i}+\alpha_i\boldsymbol{p}_{i}. -\]
-

We assume that \(\boldsymbol{p}_{i}\) is a sequence of \(n\) mutually conjugate directions. -Then the \(\boldsymbol{p}_{i}\) form a basis of \(R^n\) and we can expand the solution -\( \boldsymbol{A}\boldsymbol{x} = \boldsymbol{b}\) in this basis, namely

-
-\[ -\boldsymbol{x} = \sum^{n}_{i=1} \alpha_i \boldsymbol{p}_i. -\]
-

The coefficients are given by

-
-\[ -\mathbf{A}\mathbf{x} = \sum^{n}_{i=1} \alpha_i \mathbf{A} \mathbf{p}_i = \mathbf{b}. -\]
-

Multiplying with \(\boldsymbol{p}_k^T\) from the left gives

-
-\[ -\boldsymbol{p}_k^T \boldsymbol{A}\boldsymbol{x} = \sum^{n}_{i=1} \alpha_i\boldsymbol{p}_k^T \boldsymbol{A}\boldsymbol{p}_i= \boldsymbol{p}_k^T \boldsymbol{b}, -\]
-

and we can define the coefficients \(\alpha_k\) as

-
-\[ -\alpha_k = \frac{\boldsymbol{p}_k^T \boldsymbol{b}}{\boldsymbol{p}_k^T \boldsymbol{A} \boldsymbol{p}_k} -\]
-

If we choose the conjugate vectors \(\boldsymbol{p}_k\) carefully, -then we may not need all of them to obtain a good approximation to the solution -\(\boldsymbol{x}\). -We want to regard the conjugate gradient method as an iterative method. -This will us to solve systems where \(n\) is so large that the direct -method would take too much time.

-

We denote the initial guess for \(\boldsymbol{x}\) as \(\boldsymbol{x}_0\). -We can assume without loss of generality that

-
-\[ -\boldsymbol{x}_0=0, -\]
-

or consider the system

-
-\[ -\boldsymbol{A}\boldsymbol{z} = \boldsymbol{b}-\boldsymbol{A}\boldsymbol{x}_0, -\]
-

instead.

-

One can show that the solution \(\boldsymbol{x}\) is also the unique minimizer of the quadratic form

-
-\[ -f(\boldsymbol{x}) = \frac{1}{2}\boldsymbol{x}^T\boldsymbol{A}\boldsymbol{x} - \boldsymbol{x}^T \boldsymbol{x} , \quad \boldsymbol{x}\in\mathbf{R}^n. -\]
-

This suggests taking the first basis vector \(\boldsymbol{p}_1\) -to be the gradient of \(f\) at \(\boldsymbol{x}=\boldsymbol{x}_0\), -which equals

-
-\[ -\boldsymbol{A}\boldsymbol{x}_0-\boldsymbol{b}, -\]
-

and -\(\boldsymbol{x}_0=0\) it is equal \(-\boldsymbol{b}\). -The other vectors in the basis will be conjugate to the gradient, -hence the name conjugate gradient method.

-

Let \(\boldsymbol{r}_k\) be the residual at the \(k\)-th step:

-
-\[ -\boldsymbol{r}_k=\boldsymbol{b}-\boldsymbol{A}\boldsymbol{x}_k. -\]
-

Note that \(\boldsymbol{r}_k\) is the negative gradient of \(f\) at -\(\boldsymbol{x}=\boldsymbol{x}_k\), -so the gradient descent method would be to move in the direction \(\boldsymbol{r}_k\). -Here, we insist that the directions \(\boldsymbol{p}_k\) are conjugate to each other, -so we take the direction closest to the gradient \(\boldsymbol{r}_k\)
-under the conjugacy constraint. -This gives the following expression

-
-\[ -\boldsymbol{p}_{k+1}=\boldsymbol{r}_k-\frac{\boldsymbol{p}_k^T \boldsymbol{A}\boldsymbol{r}_k}{\boldsymbol{p}_k^T\boldsymbol{A}\boldsymbol{p}_k} \boldsymbol{p}_k. -\]
-

We can also compute the residual iteratively as

-
-\[ -\boldsymbol{r}_{k+1}=\boldsymbol{b}-\boldsymbol{A}\boldsymbol{x}_{k+1}, -\]
-

which equals

-
-\[ -\boldsymbol{b}-\boldsymbol{A}(\boldsymbol{x}_k+\alpha_k\boldsymbol{p}_k), -\]
-

or

-
-\[ -(\boldsymbol{b}-\boldsymbol{A}\boldsymbol{x}_k)-\alpha_k\boldsymbol{A}\boldsymbol{p}_k, -\]
-

which gives

-
-\[ -\boldsymbol{r}_{k+1}=\boldsymbol{r}_k-\boldsymbol{A}\boldsymbol{p}_{k}, -\]
-
-
-

7.5. Revisiting our Linear Regression Solvers

-

We will use linear regression as a case study for the gradient descent -methods. Linear regression is a great test case for the gradient -descent methods discussed in the lectures since it has several -desirable properties such as:

-
    -
  1. An analytical solution.

  2. -
  3. The gradient can be computed analytically.

  4. -
  5. The cost function is convex which guarantees that gradient descent converges for small enough learning rates

  6. -
-

We revisit an example similar to what we had in the first homework set. We had a function of the type

-
-
-
m = 100
-x = 2*np.random.rand(m,1)
-y = 4+3*x+np.random.randn(m,1)
-
-
-
-
-

with \(x_i \in [0,1] \) is chosen randomly using a uniform distribution. Additionally we have a stochastic noise chosen according to a normal distribution \(\cal {N}(0,1)\). -The linear regression model is given by

-
-\[ -h_\beta(x) = \boldsymbol{y} = \beta_0 + \beta_1 x, -\]
-

such that

-
-\[ -\boldsymbol{y}_i = \beta_0 + \beta_1 x_i. -\]
-

Let \(\mathbf{y} = (y_1,\cdots,y_n)^T\), \(\mathbf{\boldsymbol{y}} = (\boldsymbol{y}_1,\cdots,\boldsymbol{y}_n)^T\) and \(\beta = (\beta_0, \beta_1)^T\)

-

It is convenient to write \(\mathbf{\boldsymbol{y}} = X\beta\) where \(X \in \mathbb{R}^{100 \times 2} \) is the design matrix given by (we keep the intercept here)

-
-\[\begin{split} -X \equiv \begin{bmatrix} -1 & x_1 \\ -\vdots & \vdots \\ -1 & x_{100} & \\ -\end{bmatrix}. -\end{split}\]
-

The cost/loss/risk function is given by (

-
-\[ -C(\beta) = \frac{1}{n}||X\beta-\mathbf{y}||_{2}^{2} = \frac{1}{n}\sum_{i=1}^{100}\left[ (\beta_0 + \beta_1 x_i)^2 - 2 y_i (\beta_0 + \beta_1 x_i) + y_i^2\right] -\]
-

and we want to find \(\beta\) such that \(C(\beta)\) is minimized.

-

Computing \(\partial C(\beta) / \partial \beta_0\) and \(\partial C(\beta) / \partial \beta_1\) we can show that the gradient can be written as

-
-\[\begin{split} -\nabla_{\beta} C(\beta) = \frac{2}{n}\begin{bmatrix} \sum_{i=1}^{100} \left(\beta_0+\beta_1x_i-y_i\right) \\ -\sum_{i=1}^{100}\left( x_i (\beta_0+\beta_1x_i)-y_ix_i\right) \\ -\end{bmatrix} = \frac{2}{n}X^T(X\beta - \mathbf{y}), -\end{split}\]
-

where \(X\) is the design matrix defined above.

-

The Hessian matrix of \(C(\beta)\) is given by

-
-\[\begin{split} -\boldsymbol{H} \equiv \begin{bmatrix} -\frac{\partial^2 C(\beta)}{\partial \beta_0^2} & \frac{\partial^2 C(\beta)}{\partial \beta_0 \partial \beta_1} \\ -\frac{\partial^2 C(\beta)}{\partial \beta_0 \partial \beta_1} & \frac{\partial^2 C(\beta)}{\partial \beta_1^2} & \\ -\end{bmatrix} = \frac{2}{n}X^T X. -\end{split}\]
-

This result implies that \(C(\beta)\) is a convex function since the matrix \(X^T X\) always is positive semi-definite.

-

We can now write a program that minimizes \(C(\beta)\) using the gradient descent method with a constant learning rate \(\gamma\) according to

-
-\[ -\beta_{k+1} = \beta_k - \gamma \nabla_\beta C(\beta_k), \ k=0,1,\cdots -\]
-

We can use the expression we computed for the gradient and let use a -\(\beta_0\) be chosen randomly and let \(\gamma = 0.001\). Stop iterating -when \(||\nabla_\beta C(\beta_k) || \leq \epsilon = 10^{-8}\). Note that the code below does not include the latter stop criterion.

-

And finally we can compare our solution for \(\beta\) with the analytic result given by -\(\beta= (X^TX)^{-1} X^T \mathbf{y}\).

-

Here is our simple example

-
-
-
# Importing various packages
-from random import random, seed
-import numpy as np
-import matplotlib.pyplot as plt
-from mpl_toolkits.mplot3d import Axes3D
-from matplotlib import cm
-from matplotlib.ticker import LinearLocator, FormatStrFormatter
-import sys
-
-# the number of datapoints
-n = 100
-x = 2*np.random.rand(n,1)
-y = 4+3*x+np.random.randn(n,1)
-
-X = np.c_[np.ones((n,1)), x]
-# Hessian matrix
-H = (2.0/n)* X.T @ X
-# Get the eigenvalues
-EigValues, EigVectors = np.linalg.eig(H)
-print(EigValues)
-
-beta_linreg = np.linalg.inv(X.T @ X) @ X.T @ y
-print(beta_linreg)
-beta = np.random.randn(2,1)
-
-eta = 1.0/np.max(EigValues)
-Niterations = 1000
-
-for iter in range(Niterations):
-    gradient = (2.0/n)*X.T @ (X @ beta-y)
-    beta -= eta*gradient
-
-print(beta)
-xnew = np.array([[0],[2]])
-xbnew = np.c_[np.ones((2,1)), xnew]
-ypredict = xbnew.dot(beta)
-ypredict2 = xbnew.dot(beta_linreg)
-plt.plot(xnew, ypredict, "r-")
-plt.plot(xnew, ypredict2, "b-")
-plt.plot(x, y ,'ro')
-plt.axis([0,2.0,0, 15.0])
-plt.xlabel(r'$x$')
-plt.ylabel(r'$y$')
-plt.title(r'Gradient descent example')
-plt.show()
-
-
-
-
-
[0.30862336 4.94226154]
-[[4.09553421]
- [2.99517651]]
-[[4.09553421]
- [2.99517651]]
-
-
-_images/chapteroptimization_118_1.png -
-
-

Alternatively, we can use Scikit-Learn as done here

-
-
-
# Importing various packages
-from random import random, seed
-import numpy as np
-import matplotlib.pyplot as plt
-from sklearn.linear_model import SGDRegressor
-
-n = 100
-x = 2*np.random.rand(n,1)
-y = 4+3*x+np.random.randn(n,1)
-
-X = np.c_[np.ones((n,1)), x]
-beta_linreg = np.linalg.inv(X.T @ X) @ (X.T @ y)
-print(beta_linreg)
-sgdreg = SGDRegressor(max_iter = 50, penalty=None, eta0=0.1)
-sgdreg.fit(x,y.ravel())
-print(sgdreg.intercept_, sgdreg.coef_)
-
-
-
-
-
[[4.1224808 ]
- [2.97290346]]
-[4.09600813] [2.93854356]
-
-
-
-
-

We have also discussed Ridge regression where the loss function contains a regularized term given by the \(L_2\) norm of \(\beta\),

-
-\[ -C_{\text{ridge}}(\beta) = \frac{1}{n}||X\beta -\mathbf{y}||^2 + \lambda ||\beta||^2, \ \lambda \geq 0. -\]
-

In order to minimize \(C_{\text{ridge}}(\beta)\) using GD we only have adjust the gradient as follows

-
-\[\begin{split} -\nabla_\beta C_{\text{ridge}}(\beta) = \frac{2}{n}\begin{bmatrix} \sum_{i=1}^{100} \left(\beta_0+\beta_1x_i-y_i\right) \\ -\sum_{i=1}^{100}\left( x_i (\beta_0+\beta_1x_i)-y_ix_i\right) \\ -\end{bmatrix} + 2\lambda\begin{bmatrix} \beta_0 \\ \beta_1\end{bmatrix} = 2 (X^T(X\beta - \mathbf{y})+\lambda \beta). -\end{split}\]
-

We can easily extend our program to minimize \(C_{\text{ridge}}(\beta)\) using gradient descent and compare with the analytical solution given by

-
-\[ -\beta_{\text{ridge}} = \left(X^T X + \lambda I_{2 \times 2} \right)^{-1} X^T \mathbf{y}. -\]
-
-
-
from random import random, seed
-import numpy as np
-import matplotlib.pyplot as plt
-from mpl_toolkits.mplot3d import Axes3D
-from matplotlib import cm
-from matplotlib.ticker import LinearLocator, FormatStrFormatter
-import sys
-
-# the number of datapoints
-n = 100
-x = 2*np.random.rand(n,1)
-y = 4+3*x+np.random.randn(n,1)
-
-X = np.c_[np.ones((n,1)), x]
-XT_X = X.T @ X
-
-#Ridge parameter lambda
-lmbda  = 0.001
-Id = lmbda* np.eye(XT_X.shape[0])
-
-beta_linreg = np.linalg.inv(XT_X+Id) @ X.T @ y
-print(beta_linreg)
-# Start plain gradient descent
-beta = np.random.randn(2,1)
-
-eta = 0.1
-Niterations = 100
-
-for iter in range(Niterations):
-    gradients = 2.0/n*X.T @ (X @ (beta)-y)+2*lmbda*beta
-    beta -= eta*gradients
-
-print(beta)
-ypredict = X @ beta
-ypredict2 = X @ beta_linreg
-plt.plot(x, ypredict, "r-")
-plt.plot(x, ypredict2, "b-")
-plt.plot(x, y ,'ro')
-plt.axis([0,2.0,0, 15.0])
-plt.xlabel(r'$x$')
-plt.ylabel(r'$y$')
-plt.title(r'Gradient descent example for Ridge')
-plt.show()
-
-
-
-
-
[[3.95338481]
- [2.95611545]]
-[[3.99545147]
- [2.91812296]]
-
-
-_images/chapteroptimization_127_1.png -
-
-
-
-

7.6. Using gradient descent methods, limitations

-
    -
  • Gradient descent (GD) finds local minima of our function. Since the GD algorithm is deterministic, if it converges, it will converge to a local minimum of our cost/loss/risk function. Because in ML we are often dealing with extremely rugged landscapes with many local minima, this can lead to poor performance.

  • -
  • GD is sensitive to initial conditions. One consequence of the local nature of GD is that initial conditions matter. Depending on where one starts, one will end up at a different local minima. Therefore, it is very important to think about how one initializes the training process. This is true for GD as well as more complicated variants of GD.

  • -
  • Gradients are computationally expensive to calculate for large datasets. In many cases in statistics and ML, the cost/loss/risk function is a sum of terms, with one term for each data point. For example, in linear regression, \(E \propto \sum_{i=1}^n (y_i - \mathbf{w}^T\cdot\mathbf{x}_i)^2\); for logistic regression, the square error is replaced by the cross entropy. To calculate the gradient we have to sum over all \(n\) data points. Doing this at every GD step becomes extremely computationally expensive. An ingenious solution to this, is to calculate the gradients using small subsets of the data called “mini batches”. This has the added benefit of introducing stochasticity into our algorithm.

  • -
  • GD is very sensitive to choices of learning rates. GD is extremely sensitive to the choice of learning rates. If the learning rate is very small, the training process take an extremely long time. For larger learning rates, GD can diverge and give poor results. Furthermore, depending on what the local landscape looks like, we have to modify the learning rates to ensure convergence. Ideally, we would adaptively choose the learning rates to match the landscape.

  • -
  • GD treats all directions in parameter space uniformly. Another major drawback of GD is that unlike Newton’s method, the learning rate for GD is the same in all directions in parameter space. For this reason, the maximum learning rate is set by the behavior of the steepest direction and this can significantly slow down training. Ideally, we would like to take large steps in flat directions and small steps in steep directions. Since we are exploring rugged landscapes where curvatures change, this requires us to keep track of not only the gradient but second derivatives. The ideal scenario would be to calculate the Hessian but this proves to be too computationally expensive.

  • -
  • GD can take exponential time to escape saddle points, even with random initialization. As we mentioned, GD is extremely sensitive to initial condition since it determines the particular local minimum GD would eventually reach. However, even with a good initialization scheme, through the introduction of randomness, GD can still take exponential time to escape saddle points.

  • -
-
-
-

7.7. Stochastic Gradient Descent

-

Stochastic gradient descent (SGD) and variants thereof address some of -the shortcomings of the Gradient descent method discussed above.

-

The underlying idea of SGD comes from the observation that the cost -function, which we want to minimize, can almost always be written as a -sum over \(n\) data points \(\{\mathbf{x}_i\}_{i=1}^n\),

-
-\[ -C(\mathbf{\beta}) = \sum_{i=1}^n c_i(\mathbf{x}_i, -\mathbf{\beta}). -\]
-

This in turn means that the gradient can be -computed as a sum over \(i\)-gradients

-
-\[ -\nabla_\beta C(\mathbf{\beta}) = \sum_i^n \nabla_\beta c_i(\mathbf{x}_i, -\mathbf{\beta}). -\]
-

Stochasticity/randomness is introduced by only taking the -gradient on a subset of the data called minibatches. If there are \(n\) -data points and the size of each minibatch is \(M\), there will be \(n/M\) -minibatches. We denote these minibatches by \(B_k\) where -\(k=1,\cdots,n/M\).

-

As an example, suppose we have \(10\) data points \((\mathbf{x}_1,\cdots, \mathbf{x}_{10})\) -and we choose to have \(M=5\) minibathces, -then each minibatch contains two data points. In particular we have -\(B_1 = (\mathbf{x}_1,\mathbf{x}_2), \cdots, B_5 = -(\mathbf{x}_9,\mathbf{x}_{10})\). Note that if you choose \(M=1\) you -have only a single batch with all data points and on the other extreme, -you may choose \(M=n\) resulting in a minibatch for each datapoint, i.e -\(B_k = \mathbf{x}_k\).

-

The idea is now to approximate the gradient by replacing the sum over -all data points with a sum over the data points in one the minibatches -picked at random in each gradient descent step

-
-\[ -\nabla_{\beta} -C(\mathbf{\beta}) = \sum_{i=1}^n \nabla_\beta c_i(\mathbf{x}_i, -\mathbf{\beta}) \rightarrow \sum_{i \in B_k}^n \nabla_\beta -c_i(\mathbf{x}_i, \mathbf{\beta}). -\]
-

Thus a gradient descent step now looks like

-
-\[ -\beta_{j+1} = \beta_j - \gamma_j \sum_{i \in B_k}^n \nabla_\beta c_i(\mathbf{x}_i, -\mathbf{\beta}) -\]
-

where \(k\) is picked at random with equal -probability from \([1,n/M]\). An iteration over the number of -minibathces (n/M) is commonly referred to as an epoch. Thus it is -typical to choose a number of epochs and for each epoch iterate over -the number of minibatches, as exemplified in the code below.

-
-
-
import numpy as np 
-
-n = 100 #100 datapoints 
-M = 5   #size of each minibatch
-m = int(n/M) #number of minibatches
-n_epochs = 10 #number of epochs
-
-j = 0
-for epoch in range(1,n_epochs+1):
-    for i in range(m):
-        k = np.random.randint(m) #Pick the k-th minibatch at random
-        #Compute the gradient using the data in minibatch Bk
-        #Compute new suggestion for 
-        j += 1
-
-
-
-
-

Taking the gradient only on a subset of the data has two important -benefits. First, it introduces randomness which decreases the chance -that our opmization scheme gets stuck in a local minima. Second, if -the size of the minibatches are small relative to the number of -datapoints (\(M < n\)), the computation of the gradient is much -cheaper since we sum over the datapoints in the \(k-th\) minibatch and not -all \(n\) datapoints.

-

A natural question is when do we stop the search for a new minimum? -One possibility is to compute the full gradient after a given number -of epochs and check if the norm of the gradient is smaller than some -threshold and stop if true. However, the condition that the gradient -is zero is valid also for local minima, so this would only tell us -that we are close to a local/global minimum. However, we could also -evaluate the cost function at this point, store the result and -continue the search. If the test kicks in at a later stage we can -compare the values of the cost function and keep the \(\beta\) that -gave the lowest value.

-

Another approach is to let the step length \(\gamma_j\) depend on the -number of epochs in such a way that it becomes very small after a -reasonable time such that we do not move at all.

-

As an example, let \(e = 0,1,2,3,\cdots\) denote the current epoch and let \(t_0, t_1 > 0\) be two fixed numbers. Furthermore, let \(t = e \cdot m + i\) where \(m\) is the number of minibatches and \(i=0,\cdots,m-1\). Then the function $\(\gamma_j(t; t_0, t_1) = \frac{t_0}{t+t_1} \)\( goes to zero as the number of epochs gets large. I.e. we start with a step length \)\gamma_j (0; t_0, t_1) = t_0/t_1\( which decays in *time* \)t$.

-

In this way we can fix the number of epochs, compute \(\beta\) and -evaluate the cost function at the end. Repeating the computation will -give a different result since the scheme is random by design. Then we -pick the final \(\beta\) that gives the lowest value of the cost -function.

-
-
-
import numpy as np 
-
-def step_length(t,t0,t1):
-    return t0/(t+t1)
-
-n = 100 #100 datapoints 
-M = 5   #size of each minibatch
-m = int(n/M) #number of minibatches
-n_epochs = 500 #number of epochs
-t0 = 1.0
-t1 = 10
-
-gamma_j = t0/t1
-j = 0
-for epoch in range(1,n_epochs+1):
-    for i in range(m):
-        k = np.random.randint(m) #Pick the k-th minibatch at random
-        #Compute the gradient using the data in minibatch Bk
-        #Compute new suggestion for beta
-        t = epoch*m+i
-        gamma_j = step_length(t,t0,t1)
-        j += 1
-
-print("gamma_j after %d epochs: %g" % (n_epochs,gamma_j))
-
-
-
-
-
gamma_j after 500 epochs: 9.97108e-05
-
-
-
-
-
-

7.7.1. Program for stochastic gradient

-
-
-
# Importing various packages
-from math import exp, sqrt
-from random import random, seed
-import numpy as np
-import matplotlib.pyplot as plt
-from sklearn.linear_model import SGDRegressor
-
-m = 100
-x = 2*np.random.rand(m,1)
-y = 4+3*x+np.random.randn(m,1)
-
-X = np.c_[np.ones((m,1)), x]
-theta_linreg = np.linalg.inv(X.T @ X) @ (X.T @ y)
-print("Own inversion")
-print(theta_linreg)
-sgdreg = SGDRegressor(max_iter = 50, penalty=None, eta0=0.1)
-sgdreg.fit(x,y.ravel())
-print("sgdreg from scikit")
-print(sgdreg.intercept_, sgdreg.coef_)
-
-
-theta = np.random.randn(2,1)
-eta = 0.1
-Niterations = 1000
-
-
-for iter in range(Niterations):
-    gradients = 2.0/m*X.T @ ((X @ theta)-y)
-    theta -= eta*gradients
-print("theta from own gd")
-print(theta)
-
-xnew = np.array([[0],[2]])
-Xnew = np.c_[np.ones((2,1)), xnew]
-ypredict = Xnew.dot(theta)
-ypredict2 = Xnew.dot(theta_linreg)
-
-
-n_epochs = 50
-t0, t1 = 5, 50
-def learning_schedule(t):
-    return t0/(t+t1)
-
-theta = np.random.randn(2,1)
-
-for epoch in range(n_epochs):
-    for i in range(m):
-        random_index = np.random.randint(m)
-        xi = X[random_index:random_index+1]
-        yi = y[random_index:random_index+1]
-        gradients = 2 * xi.T @ ((xi @ theta)-yi)
-        eta = learning_schedule(epoch*m+i)
-        theta = theta - eta*gradients
-print("theta from own sdg")
-print(theta)
-
-plt.plot(xnew, ypredict, "r-")
-plt.plot(xnew, ypredict2, "b-")
-plt.plot(x, y ,'ro')
-plt.axis([0,2.0,0, 15.0])
-plt.xlabel(r'$x$')
-plt.ylabel(r'$y$')
-plt.title(r'Random numbers ')
-plt.show()
-
-
-
-
-
Own inversion
-[[3.87218485]
- [3.01403105]]
-sgdreg from scikit
-[3.9030809] [3.07154525]
-theta from own gd
-[[3.87218485]
- [3.01403105]]
-theta from own sdg
-[[3.86110774]
- [3.00070278]]
-
-
-_images/chapteroptimization_141_1.png -
-
-
-
-
-

7.8. Momentum based GD

-

The stochastic gradient descent (SGD) is almost always used with a -momentum or inertia term that serves as a memory of the direction we -are moving in parameter space. This is typically implemented as -follows

-
-\[ -\mathbf{v}_{t}=\gamma \mathbf{v}_{t-1}+\eta_{t}\nabla_\theta E(\boldsymbol{\theta}_t) \nonumber -\]
- -
-
-\[ -\begin{equation} -\boldsymbol{\theta}_{t+1}= \boldsymbol{\theta}_t -\mathbf{v}_{t}, -\label{_auto1} \tag{2} -\end{equation} -\]
-

where we have introduced a momentum parameter \(\gamma\), with -\(0\le\gamma\le 1\), and for brevity we dropped the explicit notation to -indicate the gradient is to be taken over a different mini-batch at -each step. We call this algorithm gradient descent with momentum -(GDM). From these equations, it is clear that \(\mathbf{v}_t\) is a -running average of recently encountered gradients and -\((1-\gamma)^{-1}\) sets the characteristic time scale for the memory -used in the averaging procedure. Consistent with this, when -\(\gamma=0\), this just reduces down to ordinary SGD as discussed -earlier. An equivalent way of writing the updates is

-
-\[ -\Delta \boldsymbol{\theta}_{t+1} = \gamma \Delta \boldsymbol{\theta}_t -\ \eta_{t}\nabla_\theta E(\boldsymbol{\theta}_t), -\]
-

where we have defined \(\Delta \boldsymbol{\theta}_{t}= \boldsymbol{\theta}_t-\boldsymbol{\theta}_{t-1}\).

-

Let us try to get more intuition from these equations. It is helpful -to consider a simple physical analogy with a particle of mass \(m\) -moving in a viscous medium with drag coefficient \(\mu\) and potential -\(E(\mathbf{w})\). If we denote the particle’s position by \(\mathbf{w}\), -then its motion is described by

-
-\[ -m {d^2 \mathbf{w} \over dt^2} + \mu {d \mathbf{w} \over dt }= -\nabla_w E(\mathbf{w}). -\]
-

We can discretize this equation in the usual way to get

-
-\[ -m { \mathbf{w}_{t+\Delta t}-2 \mathbf{w}_{t} +\mathbf{w}_{t-\Delta t} \over (\Delta t)^2}+\mu {\mathbf{w}_{t+\Delta t}- \mathbf{w}_{t} \over \Delta t} = -\nabla_w E(\mathbf{w}). -\]
-

Rearranging this equation, we can rewrite this as

-
-\[ -\Delta \mathbf{w}_{t +\Delta t}= - { (\Delta t)^2 \over m +\mu \Delta t} \nabla_w E(\mathbf{w})+ {m \over m +\mu \Delta t} \Delta \mathbf{w}_t. -\]
-

Notice that this equation is identical to previous one if we identify -the position of the particle, \(\mathbf{w}\), with the parameters -\(\boldsymbol{\theta}\). This allows us to identify the momentum -parameter and learning rate with the mass of the particle and the -viscous drag as:

-
-\[ -\gamma= {m \over m +\mu \Delta t }, \qquad \eta = {(\Delta t)^2 \over m +\mu \Delta t}. -\]
-

Thus, as the name suggests, the momentum parameter is proportional to -the mass of the particle and effectively provides inertia. -Furthermore, in the large viscosity/small learning rate limit, our -memory time scales as \((1-\gamma)^{-1} \approx m/(\mu \Delta t)\).

-

Why is momentum useful? SGD momentum helps the gradient descent -algorithm gain speed in directions with persistent but small gradients -even in the presence of stochasticity, while suppressing oscillations -in high-curvature directions. This becomes especially important in -situations where the landscape is shallow and flat in some directions -and narrow and steep in others. It has been argued that first-order -methods (with appropriate initial conditions) can perform comparable -to more expensive second order methods, especially in the context of -complex deep learning models.

-

These beneficial properties of momentum can sometimes become even more -pronounced by using a slight modification of the classical momentum -algorithm called Nesterov Accelerated Gradient (NAG).

-

In the NAG algorithm, rather than calculating the gradient at the -current parameters, \(\nabla_\theta E(\boldsymbol{\theta}_t)\), one -calculates the gradient at the expected value of the parameters given -our current momentum, \(\nabla_\theta E(\boldsymbol{\theta}_t +\gamma -\mathbf{v}_{t-1})\). This yields the NAG update rule

-
-\[ -\mathbf{v}_{t}=\gamma \mathbf{v}_{t-1}+\eta_{t}\nabla_\theta E(\boldsymbol{\theta}_t +\gamma \mathbf{v}_{t-1}) \nonumber -\]
- -
-
-\[ -\begin{equation} -\boldsymbol{\theta}_{t+1}= \boldsymbol{\theta}_t -\mathbf{v}_{t}. -\label{_auto2} \tag{3} -\end{equation} -\]
-

One of the major advantages of NAG is that it allows for the use of a larger learning rate than GDM for the same choice of \(\gamma\).

-

In stochastic gradient descent, with and without momentum, we still -have to specify a schedule for tuning the learning rates \(\eta_t\) -as a function of time. As discussed in the context of Newton’s -method, this presents a number of dilemmas. The learning rate is -limited by the steepest direction which can change depending on the -current position in the landscape. To circumvent this problem, ideally -our algorithm would keep track of curvature and take large steps in -shallow, flat directions and small steps in steep, narrow directions. -Second-order methods accomplish this by calculating or approximating -the Hessian and normalizing the learning rate by the -curvature. However, this is very computationally expensive for -extremely large models. Ideally, we would like to be able to -adaptively change the step size to match the landscape without paying -the steep computational price of calculating or approximating -Hessians.

-

Recently, a number of methods have been introduced that accomplish -this by tracking not only the gradient, but also the second moment of -the gradient. These methods include AdaGrad, AdaDelta, RMS-Prop, and -ADAM.

-
-

7.8.1. RMS prop

-

In RMS prop, in addition to keeping a running average of the first -moment of the gradient, we also keep track of the second moment -denoted by \(\mathbf{s}_t=\mathbb{E}[\mathbf{g}_t^2]\). The update rule -for RMS prop is given by

- -
-
-\[ -\begin{equation} -\mathbf{g}_t = \nabla_\theta E(\boldsymbol{\theta}) -\label{_auto3} \tag{4} -\end{equation} -\]
-
-\[ -\mathbf{s}_t =\beta \mathbf{s}_{t-1} +(1-\beta)\mathbf{g}_t^2 \nonumber -\]
-
-\[ -\boldsymbol{\theta}_{t+1}=\boldsymbol{\theta}_t - \eta_t { \mathbf{g}_t \over \sqrt{\mathbf{s}_t +\epsilon}}, \nonumber -\]
-

where \(\beta\) controls the averaging time of the second moment and is -typically taken to be about \(\beta=0.9\), \(\eta_t\) is a learning rate -typically chosen to be \(10^{-3}\), and \(\epsilon\sim 10^{-8} \) is a -small regularization constant to prevent divergences. Multiplication -and division by vectors is understood as an element-wise operation. It -is clear from this formula that the learning rate is reduced in -directions where the norm of the gradient is consistently large. This -greatly speeds up the convergence by allowing us to use a larger -learning rate for flat directions.

-
-
-

7.8.2. ADAM optimizer

-

A related algorithm is the ADAM optimizer. In ADAM, we keep a running -average of both the first and second moment of the gradient and use -this information to adaptively change the learning rate for different -parameters. In addition to keeping a running average of the first and -second moments of the gradient -(i.e. \(\mathbf{m}_t=\mathbb{E}[\mathbf{g}_t]\) and -\(\mathbf{s}_t=\mathbb{E}[\mathbf{g}^2_t]\), respectively), ADAM -performs an additional bias correction to account for the fact that we -are estimating the first two moments of the gradient using a running -average (denoted by the hats in the update rule below). The update -rule for ADAM is given by (where multiplication and division are once -again understood to be element-wise operations below)

- -
-
-\[ -\begin{equation} -\mathbf{g}_t = \nabla_\theta E(\boldsymbol{\theta}) -\label{_auto4} \tag{5} -\end{equation} -\]
-
-\[ -\mathbf{m}_t = \beta_1 \mathbf{m}_{t-1} + (1-\beta_1) \mathbf{g}_t \nonumber -\]
-
-\[ -\mathbf{s}_t =\beta_2 \mathbf{s}_{t-1} +(1-\beta_2)\mathbf{g}_t^2 \nonumber -\]
-
-\[ -\boldsymbol{\mathbf{m}}_t={\mathbf{m}_t \over 1-\beta_1^t} \nonumber -\]
-
-\[ -\boldsymbol{\mathbf{s}}_t ={\mathbf{s}_t \over1-\beta_2^t} \nonumber -\]
-
-\[ -\boldsymbol{\theta}_{t+1}=\boldsymbol{\theta}_t - \eta_t { \boldsymbol{\mathbf{m}}_t \over \sqrt{\boldsymbol{\mathbf{s}}_t} +\epsilon}, \nonumber -\]
- -
-
-\[ -\begin{equation} -\label{_auto5} \tag{6} -\end{equation} -\]
-

where \(\beta_1\) and \(\beta_2\) set the memory lifetime of the first and -second moment and are typically taken to be \(0.9\) and \(0.99\) -respectively, and \(\eta\) and \(\epsilon\) are identical to RMSprop.

-

Like in RMSprop, the effective step size of a parameter depends on the -magnitude of its gradient squared. To understand this better, let us -rewrite this expression in terms of the variance -\(\boldsymbol{\sigma}_t^2 = \boldsymbol{\mathbf{s}}_t - -(\boldsymbol{\mathbf{m}}_t)^2\). Consider a single parameter \(\theta_t\). The -update rule for this parameter is given by

-
-\[ -\Delta \theta_{t+1}= -\eta_t { \boldsymbol{m}_t \over \sqrt{\sigma_t^2 + m_t^2 }+\epsilon}. -\]
-
-
-
-

7.9. Practical tips

-
    -
  • Randomize the data when making mini-batches. It is always important to randomly shuffle the data when forming mini-batches. Otherwise, the gradient descent method can fit spurious correlations resulting from the order in which data is presented.

  • -
  • Transform your inputs. Learning becomes difficult when our landscape has a mixture of steep and flat directions. One simple trick for minimizing these situations is to standardize the data by subtracting the mean and normalizing the variance of input variables. Whenever possible, also decorrelate the inputs. To understand why this is helpful, consider the case of linear regression. It is easy to show that for the squared error cost function, the Hessian of the cost function is just the correlation matrix between the inputs. Thus, by standardizing the inputs, we are ensuring that the landscape looks homogeneous in all directions in parameter space. Since most deep networks can be viewed as linear transformations followed by a non-linearity at each layer, we expect this intuition to hold beyond the linear case.

  • -
  • Monitor the out-of-sample performance. Always monitor the performance of your model on a validation set (a small portion of the training data that is held out of the training process to serve as a proxy for the test set. If the validation error starts increasing, then the model is beginning to overfit. Terminate the learning process. This early stopping significantly improves performance in many settings.

  • -
  • Adaptive optimization methods don’t always have good generalization. Recent studies have shown that adaptive methods such as ADAM, RMSPorp, and AdaGrad tend to have poor generalization compared to SGD or SGD with momentum, particularly in the high-dimensional limit (i.e. the number of parameters exceeds the number of data points). Although it is not clear at this stage why these methods perform so well in training deep neural networks, simpler procedures like properly-tuned SGD may work as well or better in these applications.

  • -
-
-
-

7.10. Automatic differentiation

-

Automatic differentiation (AD), -also called algorithmic -differentiation or computational differentiation,is a set of -techniques to numerically evaluate the derivative of a function -specified by a computer program. AD exploits the fact that every -computer program, no matter how complicated, executes a sequence of -elementary arithmetic operations (addition, subtraction, -multiplication, division, etc.) and elementary functions (exp, log, -sin, cos, etc.). By applying the chain rule repeatedly to these -operations, derivatives of arbitrary order can be computed -automatically, accurately to working precision, and using at most a -small constant factor more arithmetic operations than the original -program.

-

Automatic differentiation is neither:

-
    -
  • Symbolic differentiation, nor

  • -
  • Numerical differentiation (the method of finite differences).

  • -
-

Symbolic differentiation can lead to inefficient code and faces the -difficulty of converting a computer program into a single expression, -while numerical differentiation can introduce round-off errors in the -discretization process and cancellation

-

Python has tools for so-called automatic differentiation. -Consider the following example

-
-\[ -f(x) = \sin\left(2\pi x + x^2\right) -\]
-

which has the following derivative

-
-\[ -f'(x) = \cos\left(2\pi x + x^2\right)\left(2\pi + 2x\right) -\]
-

Using autograd we have

-
-
-
import autograd.numpy as np
-
-# To do elementwise differentiation:
-from autograd import elementwise_grad as egrad 
-
-# To plot:
-import matplotlib.pyplot as plt 
-
-
-def f(x):
-    return np.sin(2*np.pi*x + x**2)
-
-def f_grad_analytic(x):
-    return np.cos(2*np.pi*x + x**2)*(2*np.pi + 2*x)
-
-# Do the comparison:
-x = np.linspace(0,1,1000)
-
-f_grad = egrad(f)
-
-computed = f_grad(x)
-analytic = f_grad_analytic(x)
-
-plt.title('Derivative computed from Autograd compared with the analytical derivative')
-plt.plot(x,computed,label='autograd')
-plt.plot(x,analytic,label='analytic')
-
-plt.xlabel('x')
-plt.ylabel('y')
-plt.legend()
-
-plt.show()
-
-print("The max absolute difference is: %g"%(np.max(np.abs(computed - analytic))))
-
-
-
-
-_images/chapteroptimization_177_0.png -
The max absolute difference is: 1.77636e-15
-
-
-
-
-

Here we -experiment with what kind of functions Autograd is capable -of finding the gradient of. The following Python functions are just -meant to illustrate what Autograd can do, but please feel free to -experiment with other, possibly more complicated, functions as well.

-
-
-
import autograd.numpy as np
-from autograd import grad
-
-def f1(x):
-    return x**3 + 1
-
-f1_grad = grad(f1)
-
-# Remember to send in float as argument to the computed gradient from Autograd!
-a = 1.0
-
-# See the evaluated gradient at a using autograd:
-print("The gradient of f1 evaluated at a = %g using autograd is: %g"%(a,f1_grad(a)))
-
-# Compare with the analytical derivative, that is f1'(x) = 3*x**2 
-grad_analytical = 3*a**2
-print("The gradient of f1 evaluated at a = %g by finding the analytic expression is: %g"%(a,grad_analytical))
-
-
-
-
-
The gradient of f1 evaluated at a = 1 using autograd is: 3
-The gradient of f1 evaluated at a = 1 by finding the analytic expression is: 3
-
-
-
-
-

To differentiate with respect to two (or more) arguments of a Python -function, Autograd need to know at which variable the function if -being differentiated with respect to.

-
-
-
import autograd.numpy as np
-from autograd import grad
-def f2(x1,x2):
-    return 3*x1**3 + x2*(x1 - 5) + 1
-
-# By sending the argument 0, Autograd will compute the derivative w.r.t the first variable, in this case x1
-f2_grad_x1 = grad(f2,0)
-
-# ... and differentiate w.r.t x2 by sending 1 as an additional arugment to grad
-f2_grad_x2 = grad(f2,1)
-
-x1 = 1.0
-x2 = 3.0 
-
-print("Evaluating at x1 = %g, x2 = %g"%(x1,x2))
-print("-"*30)
-
-# Compare with the analytical derivatives:
-
-# Derivative of f2 w.r.t x1 is: 9*x1**2 + x2:
-f2_grad_x1_analytical = 9*x1**2 + x2
-
-# Derivative of f2 w.r.t x2 is: x1 - 5:
-f2_grad_x2_analytical = x1 - 5
-
-# See the evaluated derivations:
-print("The derivative of f2 w.r.t x1: %g"%( f2_grad_x1(x1,x2) ))
-print("The analytical derivative of f2 w.r.t x1: %g"%( f2_grad_x1(x1,x2) ))
-
-print()
-
-print("The derivative of f2 w.r.t x2: %g"%( f2_grad_x2(x1,x2) ))
-print("The analytical derivative of f2 w.r.t x2: %g"%( f2_grad_x2(x1,x2) ))
-
-
-
-
-
Evaluating at x1 = 1, x2 = 3
-------------------------------
-The derivative of f2 w.r.t x1: 12
-The analytical derivative of f2 w.r.t x1: 12
-
-The derivative of f2 w.r.t x2: -4
-The analytical derivative of f2 w.r.t x2: -4
-
-
-
-
-

Note that the grad function will not produce the true gradient of the function. The true gradient of a function with two or more variables will produce a vector, where each element is the function differentiated w.r.t a variable.

-
-
-
import autograd.numpy as np
-from autograd import grad
-def f3(x): # Assumes x is an array of length 5 or higher
-    return 2*x[0] + 3*x[1] + 5*x[2] + 7*x[3] + 11*x[4]**2
-
-f3_grad = grad(f3)
-
-x = np.linspace(0,4,5)
-
-# Print the computed gradient:
-print("The computed gradient of f3 is: ", f3_grad(x))
-
-# The analytical gradient is: (2, 3, 5, 7, 22*x[4])
-f3_grad_analytical = np.array([2, 3, 5, 7, 22*x[4]])
-
-# Print the analytical gradient:
-print("The analytical gradient of f3 is: ", f3_grad_analytical)
-
-
-
-
-
The computed gradient of f3 is:  [ 2.  3.  5.  7. 88.]
-The analytical gradient of f3 is:  [ 2.  3.  5.  7. 88.]
-
-
-
-
-

Note that in this case, when sending an array as input argument, the -output from Autograd is another array. This is the true gradient of -the function, as opposed to the function in the previous example. By -using arrays to represent the variables, the output from Autograd -might be easier to work with, as the output is closer to what one -could expect form a gradient-evaluting function.

-
-
-
import autograd.numpy as np
-from autograd import grad
-def f4(x):
-    return np.sqrt(1+x**2) + np.exp(x) + np.sin(2*np.pi*x)
-
-f4_grad = grad(f4)
-
-x = 2.7
-
-# Print the computed derivative:
-print("The computed derivative of f4 at x = %g is: %g"%(x,f4_grad(x)))
-
-# The analytical derivative is: x/sqrt(1 + x**2) + exp(x) + cos(2*pi*x)*2*pi
-f4_grad_analytical = x/np.sqrt(1 + x**2) + np.exp(x) + np.cos(2*np.pi*x)*2*np.pi
-
-# Print the analytical gradient:
-print("The analytical gradient of f4 at x = %g is: %g"%(x,f4_grad_analytical))
-
-
-
-
-
The computed derivative of f4 at x = 2.7 is: 13.8759
-The analytical gradient of f4 at x = 2.7 is: 13.8759
-
-
-
-
-
-
-
import autograd.numpy as np
-from autograd import grad
-def f5(x):
-    if x >= 0:
-        return x**2
-    else:
-        return -3*x + 1
-
-f5_grad = grad(f5)
-
-x = 2.7
-
-# Print the computed derivative:
-print("The computed derivative of f5 at x = %g is: %g"%(x,f5_grad(x)))
-
-
-
-
-
The computed derivative of f5 at x = 2.7 is: 5.4
-
-
-
-
-

1 -8

-

< -< -< -! -! -C -O -D -E -_ -B -L -O -C -K

-

p -y -c -o -d

-
-
-
import autograd.numpy as np
-from autograd import grad
-# Both of the functions are implementation of the sum: sum(x**i) for i = 0, ..., 9
-# The analytical derivative is: sum(i*x**(i-1)) 
-f6_grad_analytical = 0
-for i in range(10):
-    f6_grad_analytical += i*x**(i-1)
-
-print("The analytical derivative of f6 at x = %g is: %g"%(x,f6_grad_analytical))
-
-
-
-
-
The analytical derivative of f6 at x = 2.7 is: 37732.5
-
-
-
-
-
-
-
import autograd.numpy as np
-from autograd import grad
-
-def f7(n): # Assume that n is an integer
-    if n == 1 or n == 0:
-        return 1
-    else:
-        return n*f7(n-1)
-
-f7_grad = grad(f7)
-
-n = 2.0
-
-print("The computed derivative of f7 at n = %d is: %g"%(n,f7_grad(n)))
-
-# The function f7 is an implementation of the factorial of n.
-# By using the product rule, one can find that the derivative is:
-
-f7_grad_analytical = 0
-for i in range(int(n)-1):
-    tmp = 1
-    for k in range(int(n)-1):
-        if k != i:
-            tmp *= (n - k)
-    f7_grad_analytical += tmp
-
-print("The analytical derivative of f7 at n = %d is: %g"%(n,f7_grad_analytical))
-
-
-
-
-
The computed derivative of f7 at n = 2 is: 1
-The analytical derivative of f7 at n = 2 is: 1
-
-
-
-
-

Note that if n is equal to zero or one, Autograd will give an error message. This message appears when the output is independent on input.

-

Autograd supports many features. However, there are some functions that are not supported (yet) by Autograd.

-

Assigning a value to the variable being differentiated with respect to is an example thereof.

-
-
-
#import autograd.numpy as np
-#from autograd import grad
-#def f8(x): # Assume x is an array
-#    x[2] = 3
-#    return x*2
-
-#f8_grad = grad(f8)
-
-#x = 8.4
-
-#print("The derivative of f8 is:",f8_grad(x))
-
-
-
-
-

Here, Autograd tells us that an ‘ArrayBox’ does not support item assignment. The item assignment is done when the program tries to assign x[2] to the value 3. However, Autograd has implemented the computation of the derivative such that this assignment is not possible.

-
-
-
import autograd.numpy as np
-from autograd import grad
-def f9(a): # Assume a is an array with 2 elements
-    b = np.array([1.0,2.0])
-    return a.dot(b)
-
-f9_grad = grad(f9)
-
-x = np.array([1.0,0.0])
-
-print("The derivative of f9 is:",f9_grad(x))
-
-
-
-
-
---------------------------------------------------------------------------
-AttributeError                            Traceback (most recent call last)
-<ipython-input-22-1ec254875e1a> in <module>
-      9 x = np.array([1.0,0.0])
-     10 
----> 11 print("The derivative of f9 is:",f9_grad(x))
-
-~/opt/anaconda3/lib/python3.8/site-packages/autograd/wrap_util.py in nary_f(*args, **kwargs)
-     18             else:
-     19                 x = tuple(args[i] for i in argnum)
----> 20             return unary_operator(unary_f, x, *nary_op_args, **nary_op_kwargs)
-     21         return nary_f
-     22     return nary_operator
-
-~/opt/anaconda3/lib/python3.8/site-packages/autograd/differential_operators.py in grad(fun, x)
-     23     arguments as `fun`, but returns the gradient instead. The function `fun`
-     24     should be scalar-valued. The gradient has the same type as the argument."""
----> 25     vjp, ans = _make_vjp(fun, x)
-     26     if not vspace(ans).size == 1:
-     27         raise TypeError("Grad only applies to real scalar-output functions. "
-
-~/opt/anaconda3/lib/python3.8/site-packages/autograd/core.py in make_vjp(fun, x)
-      8 def make_vjp(fun, x):
-      9     start_node = VJPNode.new_root()
----> 10     end_value, end_node =  trace(start_node, fun, x)
-     11     if end_node is None:
-     12         def vjp(g): return vspace(x).zeros()
-
-~/opt/anaconda3/lib/python3.8/site-packages/autograd/tracer.py in trace(start_node, fun, x)
-      8     with trace_stack.new_trace() as t:
-      9         start_box = new_box(x, t, start_node)
----> 10         end_box = fun(start_box)
-     11         if isbox(end_box) and end_box._trace == start_box._trace:
-     12             return end_box._value, end_box._node
-
-~/opt/anaconda3/lib/python3.8/site-packages/autograd/wrap_util.py in unary_f(x)
-     13                 else:
-     14                     subargs = subvals(args, zip(argnum, x))
----> 15                 return fun(*subargs, **kwargs)
-     16             if isinstance(argnum, int):
-     17                 x = args[argnum]
-
-<ipython-input-22-1ec254875e1a> in f9(a)
-      3 def f9(a): # Assume a is an array with 2 elements
-      4     b = np.array([1.0,2.0])
-----> 5     return a.dot(b)
-      6 
-      7 f9_grad = grad(f9)
-
-AttributeError: 'ArrayBox' object has no attribute 'dot'
-
-
-
-
-

Here we are told that the ‘dot’ function does not belong to Autograd’s -version of a Numpy array. To overcome this, an alternative syntax -which also computed the dot product can be used:

-
-
-
import autograd.numpy as np
-from autograd import grad
-def f9_alternative(x): # Assume a is an array with 2 elements
-    b = np.array([1.0,2.0])
-    return np.dot(x,b) # The same as x_1*b_1 + x_2*b_2
-
-f9_alternative_grad = grad(f9_alternative)
-
-x = np.array([3.0,0.0])
-
-print("The gradient of f9 is:",f9_alternative_grad(x))
-
-# The analytical gradient of the dot product of vectors x and b with two elements (x_1,x_2) and (b_1, b_2) respectively
-# w.r.t x is (b_1, b_2).
-
-
-
-
-

The documentation recommends to avoid inplace operations such as

-
-
-
a += b
-a -= b
-a*= b
-a /=b
-
-
-
-
-

More examples will be added, in particular how to compare autograd with own codes for the gradients.

-
-
- - - - -
- - - - -
-
-
-
-

- - By Morten Hjorth-Jensen
- - © Copyright 2021.
-

-
-
-
- - -
-
- - - - - - \ No newline at end of file diff --git a/doc/LectureNotes/_build/html/content.html b/doc/LectureNotes/_build/html/content.html deleted file mode 100644 index b104afcb7..000000000 --- a/doc/LectureNotes/_build/html/content.html +++ /dev/null @@ -1,344 +0,0 @@ - - - - - - - - Content in Jupyter Book — Applied Data Analysis and Machine Learning - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
- - - - - - - - -
- -
-
- -
- - - - - - - - - - - - - - -
- - -
- -
-
-
-
-
- -
- -
-

Content in Jupyter Book

-

There are many ways to write content in Jupyter Book. This short section -covers a few tips for how to do so.

-
- - - - -
- - -
- - -
- -
-
-
-
-

- - By Morten Hjorth-Jensen
- - © Copyright 2021.
-

-
-
-
- - -
-
- - - - - - \ No newline at end of file diff --git a/doc/LectureNotes/_build/html/genindex.html b/doc/LectureNotes/_build/html/genindex.html deleted file mode 100644 index 010cb5fb7..000000000 --- a/doc/LectureNotes/_build/html/genindex.html +++ /dev/null @@ -1,319 +0,0 @@ - - - - - - - - Index — Applied Data Analysis and Machine Learning - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
- - - - - - - - -
- -
-
- -
- - - - - - - - - - - - -
- - -
- -
-
-
-
-
- -
- - -

Index

- -
- -
- - -
- - -
- - -
- -
-
-
-
-

- - By Morten Hjorth-Jensen
- - © Copyright 2021.
-

-
-
-
- - -
-
- - - - - - \ No newline at end of file diff --git a/doc/LectureNotes/_build/html/index.html b/doc/LectureNotes/_build/html/index.html deleted file mode 100644 index 3157386d7..000000000 --- a/doc/LectureNotes/_build/html/index.html +++ /dev/null @@ -1 +0,0 @@ - diff --git a/doc/LectureNotes/_build/html/intro.html b/doc/LectureNotes/_build/html/intro.html deleted file mode 100644 index 31237e759..000000000 --- a/doc/LectureNotes/_build/html/intro.html +++ /dev/null @@ -1,560 +0,0 @@ - - - - - - - - Applied Data Analysis and Machine Learning, FYS-STK3155/4155 at the University of Oslo, Norway — Applied Data Analysis and Machine Learning - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
- - - - - - - - -
- - -
-
- -
- -
-

Applied Data Analysis and Machine Learning, FYS-STK3155/4155 at the University of Oslo, Norway

-
-

Introduction

-

Probability theory and statistical methods play a central role in Science. Nowadays we are -surrounded by huge amounts of data. For example, there are more than one trillion web pages; more than one -hour of video is uploaded to YouTube every second, amounting to years of content every -day; the genomes of 1000s of people, each of which has a length of more than a billion base pairs, have -been sequenced by various labs and so on. This deluge of data calls for automated methods of data analysis, -which is exactly what machine learning aims at providing.

-
-
-

Learning outcomes

-

This course aims at giving you insights and knowledge about many of the central algorithms used in Data Analysis and Machine Learning. The course is project based and through various numerical projects and weekly exercises you will be exposed to fundamental research problems in these fields, with the aim to reproduce state of the art scientific results. Both supervised and unsupervised methods will be covered. The emphasis is on a frequentist approach with an emphasis on predictions and correaltions. However, we will try, where appropriate, to link our machine learning models with a Bayesian approach as well. You will learn to develop and structure large codes for studying different cases where Machine Learning is applied to, get acquainted with computing facilities and learn to handle large scientific projects. A good scientific and ethical conduct is emphasized throughout the course. More specifically, after this course you will

-
    -
  • Learn about basic data analysis, statistical analysis, Bayesian statistics, Monte Carlo sampling, data optimization and machine learning;

  • -
  • Be capable of extending the acquired knowledge to other systems and cases;

  • -
  • Have an understanding of central algorithms used in data analysis and machine learning;

  • -
  • Understand linear methods for regression and classification, from ordinary least squares, via Lasso and Ridge to Logistic regression and Kernel regression;

  • -
  • Learn about neural networks and deep learning methods for supervised and unsupervised learning. Emphasis on feed forward neural networks, convolutional and recurrent neural networks;

  • -
  • Learn about about decision trees, random forests, bagging and boosting methods;

  • -
  • Learn about support vector machines and kernel transformations;

  • -
  • Reduction of data sets and unsupervised learning, from PCA to clustering;

  • -
  • Autoencoders and Reinforcement Learning;

  • -
  • Work on numerical projects to illustrate the theory. The projects play a central role and you are expected to know modern programming languages like Python or C++ and/or Fortran (Fortran2003 or later).

  • -
-
-
-

Prerequisites and background

-

Basic knowledge in programming and mathematics, with an emphasis on linear algebra. Knowledge of Python or/and C++ as programming languages is strongly recommended and experience with Jupyter notebooks is recommended. Required courses are the equivalents to the University of Oslo mathematics courses MAT1100, MAT1110, MAT1120 and at least one of the corresponding computing and programming courses INF1000/INF1110 or MAT-INF1100/MAT-INF1100L/BIOS1100/KJM-INF1100. Most universities offer nowadays a basic programming course (often compulsory) where Python is the recurring programming language. -We recommend also refreshing your knowledge on Statistics and Probability theory. The lecture notes at https://compphysics.github.io/MachineLearning/doc/LectureNotes/_build/html/intro.html offer a review of Statistics and Probability theory.

-
-
-

The course has two central parts

-
    -
  1. Statistical analysis and optimization of data

  2. -
  3. Machine learning

  4. -
-
-

Statistical analysis and optimization of data

-

The following topics will be covered

-
    -
  • Basic concepts, expectation values, variance, covariance, correlation functions and errors;

  • -
  • Simpler models, binomial distribution, the Poisson distribution, simple and multivariate normal distributions;

  • -
  • Central elements of Bayesian statistics and modeling;

  • -
  • Gradient methods for data optimization,

  • -
  • Monte Carlo methods, Markov chains, Gibbs sampling and Metropolis-Hastings sampling;

  • -
  • Estimation of errors and resampling techniques such as the cross-validation, blocking, bootstrapping and jackknife methods;

  • -
  • Principal Component Analysis (PCA) and its mathematical foundation

  • -
-
-
-

Machine learning

-

The following topics will be covered:

-
    -
  • Linear Regression and Logistic Regression;

  • -
  • Neural networks and deep learning, including convolutional and recurrent neural networks

  • -
  • Decisions trees, Random Forests, Bagging and Boosting

  • -
  • Support vector machines

  • -
  • Bayesian linear and logistic regression

  • -
  • Boltzmann Machines

  • -
  • Unsupervised learning Dimensionality reduction, PCA, k-means and clustering

  • -
  • Autoenconders

  • -
-

Hands-on demonstrations, exercises and projects aim at deepening your understanding of these topics.

-

Computational aspects play a central role and you are -expected to work on numerical examples and projects which illustrate -the theory and various algorithms discussed during the lectures. We recommend strongly to form small project groups of 2-3 participants, if possible.

-
-
-
-

Required Technologies

-

Course participants are expected to have their own laptops/PCs. We use Git as version control software and the usage of providers like GitHub, GitLab or similar are strongly recommended. If you are not familiar with Git as version control software, the following video may be of interest, see https://www.youtube.com/watch?v=RGOj5yH7evk&ab_channel=freeCodeCamp.org

-

We will make extensive use of Python as programming language and its -myriad of available libraries. You will find -Jupyter notebooks invaluable in your work. You can run R -codes in the Jupyter/IPython notebooks, with the immediate benefit of -visualizing your data. You can also use compiled languages like C++, -Rust, Julia, Fortran etc if you prefer. The focus in these lectures will be -on Python.

-

If you have Python installed and you feel -pretty familiar with installing different packages, we recommend that -you install the following Python packages via pip as

-
    -
  • pip install numpy scipy matplotlib ipython scikit-learn mglearn sympy pandas pillow

  • -
-

For OSX users we recommend, after having installed Xcode, to -install brew. Brew allows for a seamless installation of additional -software via for example

-
    -
  • brew install python3

  • -
-

For Linux users, with its variety of distributions like for example the widely popular Ubuntu distribution, -you can use pip as well and simply install Python as

-
    -
  • sudo apt-get install python3

  • -
-
-

Python installers

-

If you don’t want to perform these operations separately and venture -into the hassle of exploring how to set up dependencies and paths, we -recommend two widely used distrubutions which set up all relevant -dependencies for Python, namely

- -

which is an open source -distribution of the Python and R programming languages for large-scale -data processing, predictive analytics, and scientific computing, that -aims to simplify package management and deployment. Package versions -are managed by the package management system conda.

- -

is a Python -distribution for scientific and analytic computing distribution and -analysis environment, available for free and under a commercial -license.

-

Furthermore, Google’s Colab:https://colab.research.google.com/notebooks/welcome.ipynb is a free Jupyter notebook environment that requires -no setup and runs entirely in the cloud. Try it out!

-
-
-

Useful Python libraries

-

Here we list several useful Python libraries we strongly recommend (if you use anaconda many of these are already there)

-
    -
  • NumPy:https://www.numpy.org/ is a highly popular library for large, multi-dimensional arrays and matrices, along with a large collection of high-level mathematical functions to operate on these arrays

  • -
  • The pandas:https://pandas.pydata.org/ library provides high-performance, easy-to-use data structures and data analysis tools

  • -
  • Xarray:http://xarray.pydata.org/en/stable/ is a Python package that makes working with labelled multi-dimensional arrays simple, efficient, and fun!

  • -
  • Scipy:https://www.scipy.org/ (pronounced “Sigh Pie”) is a Python-based ecosystem of open-source software for mathematics, science, and engineering.

  • -
  • Matplotlib:https://matplotlib.org/ is a Python 2D plotting library which produces publication quality figures in a variety of hardcopy formats and interactive environments across platforms.

  • -
  • Autograd:https://github.com/HIPS/autograd can automatically differentiate native Python and Numpy code. It can handle a large subset of Python’s features, including loops, ifs, recursion and closures, and it can even take derivatives of derivatives of derivatives

  • -
  • SymPy:https://www.sympy.org/en/index.html is a Python library for symbolic mathematics.

  • -
  • scikit-learn:https://scikit-learn.org/stable/ has simple and efficient tools for machine learning, data mining and data analysis

  • -
  • TensorFlow:https://www.tensorflow.org/ is a Python library for fast numerical computing created and released by Google

  • -
  • Keras:https://keras.io/ is a high-level neural networks API, written in Python and capable of running on top of TensorFlow, CNTK, or Theano

  • -
  • And many more such as pytorch:https://pytorch.org/, Theano:https://pypi.org/project/Theano/ etc

  • -
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- - - - -
- - - - -
-
-
-
-

- - By Morten Hjorth-Jensen
- - © Copyright 2021.
-

-
-
-
- - -
-
- - - - - - \ No newline at end of file diff --git a/doc/LectureNotes/_build/html/linalg.html b/doc/LectureNotes/_build/html/linalg.html deleted file mode 100644 index 63f11e249..000000000 --- a/doc/LectureNotes/_build/html/linalg.html +++ /dev/null @@ -1,1214 +0,0 @@ - - - - - - - - 2. Linear Algebra, Handling of Arrays and more Python Features — Applied Data Analysis and Machine Learning - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
- - - - - - - - -
- - -
-
- -
- -
-

2. Linear Algebra, Handling of Arrays and more Python Features

-
-

2.1. Introduction

-

The aim of this set of lectures is to review some central linear algebra algorithms that we will need in our -data analysis part and in the construction of Machine Learning algorithms (ML). -This will allow us to introduce some central programming features of high-level languages like Python and -compiled languages like C++ and/or Fortran.

-

As discussed in the introductory notes, these series of lectures focuses both on using -central Python packages like tensorflow and scikit-learn as well -as writing your own codes for some central ML algorithms. The -latter can be written in a language of your choice, be it Python, Julia, R, -Rust, C++, Fortran etc. In order to avoid confusion however, in these lectures we will limit our -attention to Python, C++ and Fortran.

-
-
-

2.2. Important Matrix and vector handling packages

-

There are several central software packages for linear algebra and eigenvalue problems. Several of the more -popular ones have been wrapped into ofter software packages like those from the widely used text Numerical Recipes. The original source codes in many of the available packages are often taken from the widely used -software package LAPACK, which follows two other popular packages -developed in the 1970s, namely EISPACK and LINPACK. We describe them shortly here.

-
    -
  • LINPACK: package for linear equations and least square problems.

  • -
  • LAPACK:package for solving symmetric, unsymmetric and generalized eigenvalue problems. From LAPACK’s website http://www.netlib.org it is possible to download for free all source codes from this library. Both C/C++ and Fortran versions are available.

  • -
  • BLAS (I, II and III): (Basic Linear Algebra Subprograms) are routines that provide standard building blocks for performing basic vector and matrix operations. Blas I is vector operations, II vector-matrix operations and III matrix-matrix operations. Highly parallelized and efficient codes, all available for download from http://www.netlib.org.

  • -
-

When dealing with matrices and vectors a central issue is memory -handling and allocation. If our code is written in Python the way we -declare these objects and the way they are handled, interpreted and -used by say a linear algebra library, requires codes that interface -our Python program with such libraries. For Python programmers, -Numpy is by now the standard Python package for numerical arrays in -Python as well as the source of functions which act on these -arrays. These functions span from eigenvalue solvers to functions that -compute the mean value, variance or the covariance matrix. If you are -not familiar with how arrays are handled in say Python or compiled -languages like C++ and Fortran, the sections in this chapter may be -useful. For C++ programmer, Armadillo is widely used library for -linear algebra and eigenvalue problems. In addition it offers a -convenient way to handle and organize arrays. We discuss this library -as well. Before we proceed we believe it may be convenient to repeat some basic features of -matrices and vectors.

-
-
-

2.3. Basic Matrix Features

-

Matrix properties reminder

-
-\[\begin{split} -\mathbf{A} = - \begin{bmatrix} a_{11} & a_{12} & a_{13} & a_{14} \\ - a_{21} & a_{22} & a_{23} & a_{24} \\ - a_{31} & a_{32} & a_{33} & a_{34} \\ - a_{41} & a_{42} & a_{43} & a_{44} - \end{bmatrix}\qquad -\mathbf{I} = - \begin{bmatrix} 1 & 0 & 0 & 0 \\ - 0 & 1 & 0 & 0 \\ - 0 & 0 & 1 & 0 \\ - 0 & 0 & 0 & 1 - \end{bmatrix} -\end{split}\]
-

The inverse of a matrix is defined by

-
-\[ -\mathbf{A}^{-1} \cdot \mathbf{A} = I -\]
- - - - - - - - - - - -
Relations Name matrix elements
$A = A^{T}$ symmetric $a_{ij} = a_{ji}$
$A = \left (A^{T} \right )^{-1}$ real orthogonal $\sum_k a_{ik} a_{jk} = \sum_k a_{ki} a_{kj} = \delta_{ij}$
$A = A^{ * }$ real matrix $a_{ij} = a_{ij}^{ * }$
$A = A^{\dagger}$ hermitian $a_{ij} = a_{ji}^{ * }$
$A = \left (A^{\dagger} \right )^{-1}$ unitary $\sum_k a_{ik} a_{jk}^{ * } = \sum_k a_{ki}^{ * } a_{kj} = \delta_{ij}$
-### Some famous Matrices -
    -
  • Diagonal if \(a_{ij}=0\) for \(i\ne j\)

  • -
  • Upper triangular if \(a_{ij}=0\) for \(i > j\)

  • -
  • Lower triangular if \(a_{ij}=0\) for \(i < j\)

  • -
  • Upper Hessenberg if \(a_{ij}=0\) for \(i > j+1\)

  • -
  • Lower Hessenberg if \(a_{ij}=0\) for \(i < j+1\)

  • -
  • Tridiagonal if \(a_{ij}=0\) for \(|i -j| > 1\)

  • -
  • Lower banded with bandwidth \(p\): \(a_{ij}=0\) for \(i > j+p\)

  • -
  • Upper banded with bandwidth \(p\): \(a_{ij}=0\) for \(i < j+p\)

  • -
  • Banded, block upper triangular, block lower triangular….

  • -
-

Some Equivalent Statements. For an \(N\times N\) matrix \(\mathbf{A}\) the following properties are all equivalent

-
    -
  • If the inverse of \(\mathbf{A}\) exists, \(\mathbf{A}\) is nonsingular.

  • -
  • The equation \(\mathbf{Ax}=0\) implies \(\mathbf{x}=0\).

  • -
  • The rows of \(\mathbf{A}\) form a basis of \(R^N\).

  • -
  • The columns of \(\mathbf{A}\) form a basis of \(R^N\).

  • -
  • \(\mathbf{A}\) is a product of elementary matrices.

  • -
  • \(0\) is not eigenvalue of \(\mathbf{A}\).

  • -
-
-
-

2.4. Numpy and arrays

-

Numpy provides an easy way to handle arrays in Python. The standard way to import this library is as

-
-
-
import numpy as np
-n = 10
-x = np.random.normal(size=n)
-print(x)
-
-
-
-
-
[-0.62370636  0.34673123  0.80408254  2.08638654  1.16894795  1.8464107
-  0.13620973 -1.33881021 -0.05404886 -0.99995891]
-
-
-
-
-

Here we have defined a vector \(x\) with \(n=10\) elements with its values given by the Normal distribution \(N(0,1)\). -Another alternative is to declare a vector as follows

-
-
-
import numpy as np
-x = np.array([1, 2, 3])
-print(x)
-
-
-
-
-
[1 2 3]
-
-
-
-
-

Here we have defined a vector with three elements, with \(x_0=1\), \(x_1=2\) and \(x_2=3\). Note that both Python and C++ -start numbering array elements from \(0\) and on. This means that a vector with \(n\) elements has a sequence of entities \(x_0, x_1, x_2, \dots, x_{n-1}\). We could also let (recommended) Numpy to compute the logarithms of a specific array as

-
-
-
import numpy as np
-x = np.log(np.array([4, 7, 8]))
-print(x)
-
-
-
-
-
[1.38629436 1.94591015 2.07944154]
-
-
-
-
-

Here we have used Numpy’s unary function \(np.log\). This function is -highly tuned to compute array elements since the code is vectorized -and does not require looping. We normaly recommend that you use the -Numpy intrinsic functions instead of the corresponding log function -from Python’s math module. The looping is done explicitely by the -np.log function. The alternative, and slower way to compute the -logarithms of a vector would be to write

-
-
-
import numpy as np
-from math import log
-x = np.array([4, 7, 8])
-for i in range(0, len(x)):
-    x[i] = log(x[i])
-print(x)
-
-
-
-
-
[1 1 2]
-
-
-
-
-

We note that our code is much longer already and we need to import the log function from the math module. -The attentive reader will also notice that the output is \([1, 1, 2]\). Python interprets automacally our numbers as integers (like the automatic keyword in C++). To change this we could define our array elements to be double precision numbers as

-
-
-
import numpy as np
-x = np.log(np.array([4, 7, 8], dtype = np.float64))
-print(x)
-
-
-
-
-
[1.38629436 1.94591015 2.07944154]
-
-
-
-
-

or simply write them as double precision numbers (Python uses 64 bits as default for floating point type variables), that is

-
-
-
import numpy as np
-x = np.log(np.array([4.0, 7.0, 8.0])
-print(x)
-
-
-
-
-
  File "<ipython-input-6-f6d7a289d493>", line 3
-    print(x)
-    ^
-SyntaxError: invalid syntax
-
-
-
-
-

To check the number of bytes (remember that one byte contains eight bits for double precision variables), you can use simple use the itemsize functionality (the array \(x\) is actually an object which inherits the functionalities defined in Numpy) as

-
-
-
import numpy as np
-x = np.log(np.array([4.0, 7.0, 8.0])
-print(x.itemsize)
-
-
-
-
-

Having defined vectors, we are now ready to try out matrices. We can define a \(3 \times 3 \) real matrix \(\hat{A}\) -as (recall that we user lowercase letters for vectors and uppercase letters for matrices)

-
-
-
import numpy as np
-A = np.log(np.array([ [4.0, 7.0, 8.0], [3.0, 10.0, 11.0], [4.0, 5.0, 7.0] ]))
-print(A)
-
-
-
-
-

If we use the shape function we would get \((3, 3)\) as output, that is verifying that our matrix is a \(3\times 3\) matrix. We can slice the matrix and print for example the first column (Python organized matrix elements in a row-major order, see below) as

-
-
-
import numpy as np
-A = np.log(np.array([ [4.0, 7.0, 8.0], [3.0, 10.0, 11.0], [4.0, 5.0, 7.0] ]))
-# print the first column, row-major order and elements start with 0
-print(A[:,0])
-
-
-
-
-

We can continue this was by printing out other columns or rows. The example here prints out the second column

-
-
-
import numpy as np
-A = np.log(np.array([ [4.0, 7.0, 8.0], [3.0, 10.0, 11.0], [4.0, 5.0, 7.0] ]))
-# print the first column, row-major order and elements start with 0
-print(A[1,:])
-
-
-
-
-

Numpy contains many other functionalities that allow us to slice, subdivide etc etc arrays. We strongly recommend that you look up the Numpy website for more details. Useful functions when defining a matrix are the np.zeros function which declares a matrix of a given dimension and sets all elements to zero

-
-
-
import numpy as np
-n = 10
-# define a matrix of dimension 10 x 10 and set all elements to zero
-A = np.zeros( (n, n) )
-print(A)
-
-
-
-
-

or initializing all elements to

-
-
-
import numpy as np
-n = 10
-# define a matrix of dimension 10 x 10 and set all elements to one
-A = np.ones( (n, n) )
-print(A)
-
-
-
-
-

or as unitarily distributed random numbers (see the material on random number generators in the statistics part)

-
-
-
import numpy as np
-n = 10
-# define a matrix of dimension 10 x 10 and set all elements to random numbers with x \in [0, 1]
-A = np.random.rand(n, n)
-print(A)
-
-
-
-
-

As we will see throughout these lectures, there are several extremely useful functionalities in Numpy. -As an example, consider the discussion of the covariance matrix. Suppose we have defined three vectors -\(\hat{x}, \hat{y}, \hat{z}\) with \(n\) elements each. The covariance matrix is defined as

-
-\[\begin{split} -\hat{\Sigma} = \begin{bmatrix} \sigma_{xx} & \sigma_{xy} & \sigma_{xz} \\ - \sigma_{yx} & \sigma_{yy} & \sigma_{yz} \\ - \sigma_{zx} & \sigma_{zy} & \sigma_{zz} - \end{bmatrix}, -\end{split}\]
-

where for example

-
-\[ -\sigma_{xy} =\frac{1}{n} \sum_{i=0}^{n-1}(x_i- \overline{x})(y_i- \overline{y}). -\]
-

The Numpy function np.cov calculates the covariance elements using the factor \(1/(n-1)\) instead of \(1/n\) since it assumes we do not have the exact mean values. For a more in-depth discussion of the covariance and covariance matrix and its meaning, we refer you to the lectures on statistics. -The following simple function uses the np.vstack function which takes each vector of dimension \(1\times n\) and produces a \( 3\times n\) matrix \(\hat{W}\)

-
-\[\begin{split} -\hat{W} = \begin{bmatrix} x_0 & y_0 & z_0 \\ - x_1 & y_1 & z_1 \\ - x_2 & y_2 & z_2 \\ - \dots & \dots & \dots \\ - x_{n-2} & y_{n-2} & z_{n-2} \\ - x_{n-1} & y_{n-1} & z_{n-1} - \end{bmatrix}, -\end{split}\]
-

which in turn is converted into into the \(3 times 3\) covariance matrix -\(\hat{\Sigma}\) via the Numpy function np.cov(). In our review of -statistical functions and quantities we will discuss more about the -meaning of the covariance matrix. Here we note that we can calculate -the mean value of each set of samples \(\hat{x}\) etc using the Numpy -function np.mean(x). We can also extract the eigenvalues of the -covariance matrix through the np.linalg.eig() function.

-
-
-
# Importing various packages
-import numpy as np
-
-n = 100
-x = np.random.normal(size=n)
-print(np.mean(x))
-y = 4+3*x+np.random.normal(size=n)
-print(np.mean(y))
-z = x**3+np.random.normal(size=n)
-print(np.mean(z))
-W = np.vstack((x, y, z))
-Sigma = np.cov(W)
-print(Sigma)
-Eigvals, Eigvecs = np.linalg.eig(Sigma)
-print(Eigvals)
-
-
-
-
-
-
-
%matplotlib inline
-
-import numpy as np
-import matplotlib.pyplot as plt
-from scipy import sparse
-eye = np.eye(4)
-print(eye)
-sparse_mtx = sparse.csr_matrix(eye)
-print(sparse_mtx)
-x = np.linspace(-10,10,100)
-y = np.sin(x)
-plt.plot(x,y,marker='x')
-plt.show()
-
-
-
-
-
-
-

2.5. Other Matrix and Vector Operations

-

The following examples show how to compute various quantities like the mean value of a matrix or a vector and how to use functions like reshape and ravel. These are all useful quantities when scaling the data and preparing the data for various machine learning algorithms and when calculating quantities like the mean squared error or the variance.

-
-
-
"""
-Simple code that tests various numpy functions
-"""
-
-import numpy as np
-# Simple test-matrix of dim 3 x 4
-a = np.array([ [1, 2, 3], [4, 5, 6], [7, 8, 9],[10, 11, 12]],dtype=np.float64)
-print(f"The test matrix:{a}")
-# This is the total mean summed over all elements, which here has to be 6.5
-print(f"This is the total mean summed over all elements:{np.mean(a,dtype=np.float64)}")
-# This is the mean for each column, it returns an array with the mean values for each column. It returns a row-like vector
-print(f"This is the mean for each column:{np.mean(a, axis=0, keepdims=True,dtype=np.float64)}")
-# This is the mean value for each row, it returns an array via the keepdims option which is a column-like vector if
-# keepdims=True. Else it return a row-like vector
-# Try setting keepdims=False
-print(f"This is the mean value for each row:{np.mean(a, axis=1, keepdims=True,dtype=np.float64)}")
-# We print then the mean value for each row by  setting keepdims=False
-print(f"This is the mean value for each row with keepdims false:{np.mean(a, axis=1, keepdims=False,dtype=np.float64)}")
-
-# Ravel return a contiguous flattened array.
-print(f"Flatten  the matrix:{np.ravel(a)}")
-# It is the same as reshaping the matrix into a one-dimensional array
-print(f"Reshape the matrix to a one-dim array:{a.reshape(-1)}")
-#  ‘C’ means to index the elements in row-major, C-style order, with the last axis index changing fastest, back to the first axis index changing slowest.
-# ‘F’ means to index the elements in column-major, Fortran-style order, with the first index changing fastest, and the last index changing slowest 
-print(np.ravel(a, order='F'))
-# When order is ‘A’, it will preserve the array’s ‘C’ or ‘F’ ordering
-# ‘A’ means to read the elements in Fortran-like index order if a is Fortran contiguous in memory, C-like order otherwise.
-# ‘K’ means to read the elements in the order they occur in memory, except for reversing the data when strides are negative. By default, ‘C’ index order is used.
-# Transposing it
-print(np.ravel(a.T))
-print(np.ravel(a.T, order='A'))
-
-
-
-
-
-
-

2.6. Gaussian Elimination

-

We start with the linear set of equations

-
-\[ -\mathbf{A}\mathbf{x} = \mathbf{w}. -\]
-

We assume also that the matrix \(\mathbf{A}\) is non-singular and that the -matrix elements along the diagonal satisfy \(a_{ii} \ne 0\). Simple \(4\times 4 \) example

-
-\[\begin{split} -\begin{bmatrix} - a_{11}& a_{12} &a_{13}& a_{14}\\ - a_{21}& a_{22} &a_{23}& a_{24}\\ - a_{31}& a_{32} &a_{33}& a_{34}\\ - a_{41}& a_{42} &a_{43}& a_{44}\\ - \end{bmatrix} \begin{bmatrix} - x_1\\ - x_2\\ - x_3 \\ - x_4 \\ - \end{bmatrix} - =\begin{bmatrix} - w_1\\ - w_2\\ - w_3 \\ - w_4\\ - \end{bmatrix}. -\end{split}\]
-

or

-
-\[ -a_{11}x_1 +a_{12}x_2 +a_{13}x_3 + a_{14}x_4=w_1 \nonumber -\]
-
-\[ -a_{21}x_1 + a_{22}x_2 + a_{23}x_3 + a_{24}x_4=w_2 \nonumber -\]
-
-\[ -a_{31}x_1 + a_{32}x_2 + a_{33}x_3 + a_{34}x_4=w_3 \nonumber -\]
-
-\[ -a_{41}x_1 + a_{42}x_2 + a_{43}x_3 + a_{44}x_4=w_4. \nonumber -\]
-

The basic idea of Gaussian elimination is to use the first equation to eliminate the first unknown \(x_1\) -from the remaining \(n-1\) equations. Then we use the new second equation to eliminate the second unknown -\(x_2\) from the remaining \(n-2\) equations. With \(n-1\) such eliminations -we obtain a so-called upper triangular set of equations of the form

-
-\[ -b_{11}x_1 +b_{12}x_2 +b_{13}x_3 + b_{14}x_4=y_1 \nonumber -\]
-
-\[ -b_{22}x_2 + b_{23}x_3 + b_{24}x_4=y_2 \nonumber -\]
-
-\[ -b_{33}x_3 + b_{34}x_4=y_3 \nonumber -\]
- -
-
-\[ -b_{44}x_4=y_4. \nonumber -\label{eq:gaussbacksub} \tag{1} -\]
-

We can solve this system of equations recursively starting from \(x_n\) (in our case \(x_4\)) and proceed with -what is called a backward substitution.

-

This process can be expressed mathematically as

- -
-
-\[ -\begin{equation} - x_m = \frac{1}{b_{mm}}\left(y_m-\sum_{k=m+1}^nb_{mk}x_k\right)\quad m=n-1,n-2,\dots,1. -\label{_auto1} \tag{2} -\end{equation} -\]
-

To arrive at such an upper triangular system of equations, we start by eliminating -the unknown \(x_1\) for \(j=2,n\). We achieve this by multiplying the first equation by \(a_{j1}/a_{11}\) and then subtract -the result from the \(j\)th equation. We assume obviously that \(a_{11}\ne 0\) and that -\(\mathbf{A}\) is not singular.

-

Our actual \(4\times 4\) example reads after the first operation

-
-\[\begin{split} -\begin{bmatrix} - a_{11}& a_{12} &a_{13}& a_{14}\\ - 0& (a_{22}-\frac{a_{21}a_{12}}{a_{11}}) &(a_{23}-\frac{a_{21}a_{13}}{a_{11}}) & (a_{24}-\frac{a_{21}a_{14}}{a_{11}})\\ -0& (a_{32}-\frac{a_{31}a_{12}}{a_{11}})& (a_{33}-\frac{a_{31}a_{13}}{a_{11}})& (a_{34}-\frac{a_{31}a_{14}}{a_{11}})\\ -0&(a_{42}-\frac{a_{41}a_{12}}{a_{11}}) &(a_{43}-\frac{a_{41}a_{13}}{a_{11}}) & (a_{44}-\frac{a_{41}a_{14}}{a_{11}}) \\ - \end{bmatrix} \begin{bmatrix} - x_1\\ - x_2\\ - x_3 \\ - x_4 \\ - \end{bmatrix} - =\begin{bmatrix} - y_1\\ - w_2^{(2)}\\ - w_3^{(2)} \\ - w_4^{(2)}\\ - \end{bmatrix}, -\end{split}\]
-

or

-
-\[ -b_{11}x_1 +b_{12}x_2 +b_{13}x_3 + b_{14}x_4=y_1 \nonumber -\]
-
-\[ -a^{(2)}_{22}x_2 + a^{(2)}_{23}x_3 + a^{(2)}_{24}x_4=w^{(2)}_2 \nonumber -\]
-
-\[ -a^{(2)}_{32}x_2 + a^{(2)}_{33}x_3 + a^{(2)}_{34}x_4=w^{(2)}_3 \nonumber -\]
-
-\[ -a^{(2)}_{42}x_2 + a^{(2)}_{43}x_3 + a^{(2)}_{44}x_4=w^{(2)}_4, \nonumber -\]
- -
-
-\[ -\begin{equation} -\label{_auto2} \tag{3} -\end{equation} -\]
-

The new coefficients are

- -
-
-\[ -\begin{equation} - b_{1k} = a_{1k}^{(1)} \quad k=1,\dots,n, -\label{_auto3} \tag{4} -\end{equation} -\]
-

where each \(a_{1k}^{(1)}\) is equal to the original \(a_{1k}\) element. The other coefficients are

- -
-
-\[ -\begin{equation} -a_{jk}^{(2)} = a_{jk}^{(1)}-\frac{a_{j1}^{(1)}a_{1k}^{(1)}}{a_{11}^{(1)}} \quad j,k=2,\dots,n, -\label{_auto4} \tag{5} -\end{equation} -\]
-

with a new right-hand side given by

- -
-
-\[ -\begin{equation} -y_{1}=w_1^{(1)}, \quad w_j^{(2)} =w_j^{(1)}-\frac{a_{j1}^{(1)}w_1^{(1)}}{a_{11}^{(1)}} \quad j=2,\dots,n. -\label{_auto5} \tag{6} -\end{equation} -\]
-

We have also set \(w_1^{(1)}=w_1\), the original vector element. -We see that the system of unknowns \(x_1,\dots,x_n\) is transformed into an \((n-1)\times (n-1)\) problem.

-

This step is called forward substitution. -Proceeding with these substitutions, we obtain the -general expressions for the new coefficients

- -
-
-\[ -\begin{equation} - a_{jk}^{(m+1)} = a_{jk}^{(m)}-\frac{a_{jm}^{(m)}a_{mk}^{(m)}}{a_{mm}^{(m)}} \quad j,k=m+1,\dots,n, -\label{_auto6} \tag{7} -\end{equation} -\]
-

with \(m=1,\dots,n-1\) and a -right-hand side given by

- -
-
-\[ -\begin{equation} - w_j^{(m+1)} =w_j^{(m)}-\frac{a_{jm}^{(m)}w_m^{(m)}}{a_{mm}^{(m)}}\quad j=m+1,\dots,n. -\label{_auto7} \tag{8} -\end{equation} -\]
-

This set of \(n-1\) elimations leads us to an equations which is solved by back substitution. -If the arithmetics is exact and the matrix \(\mathbf{A}\) is not singular, then the computed answer will be exact.

-

Even though the matrix elements along the diagonal are not zero, -numerically small numbers may appear and subsequent divisions may lead to large numbers, which, if added -to a small number may yield losses of precision. Suppose for example that our first division in \((a_{22}-a_{21}a_{12}/a_{11})\) -results in \(-10^{-7}\) and that \(a_{22}\) is one. -one. We are then -adding \(10^7+1\). With single precision this results in \(10^7\).

-
    -
  • Gaussian elimination, \(O(2/3n^3)\) flops, general matrix

  • -
  • LU decomposition, upper triangular and lower tridiagonal matrices, \(O(2/3n^3)\) flops, general matrix. Get easily the inverse, determinant and can solve linear equations with back-substitution only, \(O(n^2)\) flops

  • -
  • Cholesky decomposition. Real symmetric or hermitian positive definite matrix, \(O(1/3n^3)\) flops.

  • -
  • Tridiagonal linear systems, important for differential equations. Normally positive definite and non-singular. \(O(8n)\) flops for symmetric. Special case of banded matrices.

  • -
  • Singular value decomposition

  • -
  • the QR method will be discussed in chapter 7 in connection with eigenvalue systems. \(O(4/3n^3)\) flops.

  • -
-

The LU decomposition method means that we can rewrite -this matrix as the product of two matrices \(\mathbf{L}\) and \(\mathbf{U}\) -where

-
-\[\begin{split} -\begin{bmatrix} - a_{11} & a_{12} & a_{13} & a_{14} \\ - a_{21} & a_{22} & a_{23} & a_{24} \\ - a_{31} & a_{32} & a_{33} & a_{34} \\ - a_{41} & a_{42} & a_{43} & a_{44} - \end{bmatrix} - = \begin{bmatrix} - 1 & 0 & 0 & 0 \\ - l_{21} & 1 & 0 & 0 \\ - l_{31} & l_{32} & 1 & 0 \\ - l_{41} & l_{42} & l_{43} & 1 - \end{bmatrix} - \begin{bmatrix} - u_{11} & u_{12} & u_{13} & u_{14} \\ - 0 & u_{22} & u_{23} & u_{24} \\ - 0 & 0 & u_{33} & u_{34} \\ - 0 & 0 & 0 & u_{44} - \end{bmatrix}. -\end{split}\]
-

LU decomposition forms the backbone of other algorithms in linear algebra, such as the -solution of linear equations given by

-
-\[ -a_{11}x_1 +a_{12}x_2 +a_{13}x_3 + a_{14}x_4=w_1 \nonumber -\]
-
-\[ -a_{21}x_1 + a_{22}x_2 + a_{23}x_3 + a_{24}x_4=w_2 \nonumber -\]
-
-\[ -a_{31}x_1 + a_{32}x_2 + a_{33}x_3 + a_{34}x_4=w_3 \nonumber -\]
-
-\[ -a_{41}x_1 + a_{42}x_2 + a_{43}x_3 + a_{44}x_4=w_4. \nonumber -\]
-

The above set of equations is conveniently solved by using LU decomposition as an intermediate step.

-

The matrix \(\mathbf{A}\in \mathbb{R}^{n\times n}\) has an LU factorization if the determinant -is different from zero. If the LU factorization exists and \(\mathbf{A}\) is non-singular, then the LU factorization -is unique and the determinant is given by

-
-\[ -det\{\mathbf{A}\}=det\{\mathbf{LU}\}= det\{\mathbf{L}\}det\{\mathbf{U}\}=u_{11}u_{22}\dots u_{nn}. -\]
-

There are at least three main advantages with LU decomposition compared with standard Gaussian elimination:

-
    -
  • It is straightforward to compute the determinant of a matrix

  • -
  • If we have to solve sets of linear equations with the same matrix but with different vectors \(\mathbf{y}\), the number of FLOPS is of the order \(n^3\).

  • -
  • The inverse is such an operation

  • -
-

With the LU decomposition it is rather -simple to solve a system of linear equations

-
-\[ -a_{11}x_1 +a_{12}x_2 +a_{13}x_3 + a_{14}x_4=w_1 \nonumber -\]
-
-\[ -a_{21}x_1 + a_{22}x_2 + a_{23}x_3 + a_{24}x_4=w_2 \nonumber -\]
-
-\[ -a_{31}x_1 + a_{32}x_2 + a_{33}x_3 + a_{34}x_4=w_3 \nonumber -\]
-
-\[ -a_{41}x_1 + a_{42}x_2 + a_{43}x_3 + a_{44}x_4=w_4. \nonumber -\]
-

This can be written in matrix form as

-
-\[ -\mathbf{Ax}=\mathbf{w}. -\]
-

where \(\mathbf{A}\) and \(\mathbf{w}\) are known and we have to solve for -\(\mathbf{x}\). Using the LU dcomposition we write

-
-\[ -\mathbf{A} \mathbf{x} \equiv \mathbf{L} \mathbf{U} \mathbf{x} =\mathbf{w}. -\]
-

The previous equation can be calculated in two steps

-
-\[ -\mathbf{L} \mathbf{y} = \mathbf{w};\qquad \mathbf{Ux}=\mathbf{y}. -\]
-

To show that this is correct we use to the LU decomposition -to rewrite our system of linear equations as

-
-\[ -\mathbf{LUx}=\mathbf{w}, -\]
-

and since the determinant of \(\mathbf{L}\) is equal to 1 (by construction -since the diagonals of \(\mathbf{L}\) equal 1) we can use the inverse of -\(\mathbf{L}\) to obtain

-
-\[ -\mathbf{Ux}=\mathbf{L^{-1}w}=\mathbf{y}, -\]
-

which yields the intermediate step

-
-\[ -\mathbf{L^{-1}w}=\mathbf{y} -\]
-

and as soon as we have \(\mathbf{y}\) we can obtain \(\mathbf{x}\) -through \(\mathbf{Ux}=\mathbf{y}\).

-

For our four-dimentional example this takes the form

-
-\[ -y_1=w_1 \nonumber -\]
-
-\[ -l_{21}y_1 + y_2=w_2\nonumber -\]
-
-\[ -l_{31}y_1 + l_{32}y_2 + y_3 =w_3\nonumber -\]
-
-\[ -l_{41}y_1 + l_{42}y_2 + l_{43}y_3 + y_4=w_4. \nonumber -\]
-

and

-
-\[ -u_{11}x_1 +u_{12}x_2 +u_{13}x_3 + u_{14}x_4=y_1 \nonumber -\]
-
-\[ -u_{22}x_2 + u_{23}x_3 + u_{24}x_4=y_2\nonumber -\]
-
-\[ -u_{33}x_3 + u_{34}x_4=y_3\nonumber -\]
-
-\[ -u_{44}x_4=y_4 \nonumber -\]
-

This example shows the basis for the algorithm -needed to solve the set of \(n\) linear equations.

-

The algorithm goes as follows

-
    -
  • Set up the matrix \(\bf A\) and the vector \(\bf w\) with their correct dimensions. This determines the dimensionality of the unknown vector \(\bf x\).

  • -
  • Then LU decompose the matrix \(\bf A\) through a call to the function ludcmp(double a, int n, int indx, double &d). This functions returns the LU decomposed matrix \(\bf A\), its determinant and the vector indx which keeps track of the number of interchanges of rows. If the determinant is zero, the solution is malconditioned.

  • -
  • Thereafter you call the function lubksb(double a, int n, int indx, double w) which uses the LU decomposed matrix \(\bf A\) and the vector \(\bf w\) and returns \(\bf x\) in the same place as \(\bf w\). Upon exit the original content in \(\bf w\) is destroyed. If you wish to keep this information, you should make a backup of it in your calling function.

  • -
-
-

2.6.1. LU Decomposition, the inverse of a matrix

-

If the inverse exists then

-
-\[ -\mathbf{A}^{-1}\mathbf{A}=\mathbf{I}, -\]
-

the identity matrix. With an LU decomposed matrix we can rewrite the last equation as

-
-\[ -\mathbf{LU}\mathbf{A}^{-1}=\mathbf{I}. -\]
-

If we assume that the first column (that is column 1) of the inverse matrix -can be written as a vector with unknown entries

-
-\[\begin{split} -\mathbf{A}_1^{-1}= \begin{bmatrix} - a_{11}^{-1} \\ - a_{21}^{-1} \\ - \dots \\ - a_{n1}^{-1} \\ - \end{bmatrix}, -\end{split}\]
-

then we have a linear set of equations

-
-\[\begin{split} -\mathbf{LU}\begin{bmatrix} - a_{11}^{-1} \\ - a_{21}^{-1} \\ - \dots \\ - a_{n1}^{-1} \\ - \end{bmatrix} =\begin{bmatrix} - 1 \\ - 0 \\ - \dots \\ - 0 \\ - \end{bmatrix}. -\end{split}\]
-

In a similar way we can compute the unknow entries of the second column,

-
-\[\begin{split} -\mathbf{LU}\begin{bmatrix} - a_{12}^{-1} \\ - a_{22}^{-1} \\ - \dots \\ - a_{n2}^{-1} \\ - \end{bmatrix}=\begin{bmatrix} - 0 \\ - 1 \\ - \dots \\ - 0 \\ - \end{bmatrix}, -\end{split}\]
-

and continue till we have solved all \(n\) sets of linear equations.

-
-
-
- - - - -
- - - - -
-
-
-
-

- - By Morten Hjorth-Jensen
- - © Copyright 2021.
-

-
-
-
- - -
-
- - - - - - \ No newline at end of file diff --git a/doc/LectureNotes/_build/html/objects.inv b/doc/LectureNotes/_build/html/objects.inv deleted file mode 100644 index 5a9f062b2..000000000 Binary files a/doc/LectureNotes/_build/html/objects.inv and /dev/null differ diff --git a/doc/LectureNotes/_build/html/reports/chapter1.log b/doc/LectureNotes/_build/html/reports/chapter1.log deleted file mode 100644 index 5d93ad2b3..000000000 --- a/doc/LectureNotes/_build/html/reports/chapter1.log +++ /dev/null @@ -1,53 +0,0 @@ -Traceback (most recent call last): - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/jupyter_cache/executors/utils.py", line 51, in single_nb_execution - executenb( - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/client.py", line 1087, in execute - return NotebookClient(nb=nb, resources=resources, km=km, **kwargs).execute() - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/util.py", line 74, in wrapped - return just_run(coro(*args, **kwargs)) - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/util.py", line 53, in just_run - return loop.run_until_complete(coro) - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/asyncio/base_events.py", line 616, in run_until_complete - return future.result() - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/client.py", line 540, in async_execute - await self.async_execute_cell( - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/client.py", line 832, in async_execute_cell - self._check_raise_for_error(cell, exec_reply) - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/client.py", line 740, in _check_raise_for_error - raise CellExecutionError.from_cell_and_msg(cell, exec_reply['content']) -nbclient.exceptions.CellExecutionError: An error occurred while executing the following cell: ------------------- -# split in training and test data -X_train, X_test, y_train, y_test = train_test_split(X,y,test_size=0.2) ------------------- - ---------------------------------------------------------------------------- -ValueError Traceback (most recent call last) - in  - 1 # split in training and test data -----> 2 X_train, X_test, y_train, y_test = train_test_split(X,y,test_size=0.2) - -~/opt/anaconda3/lib/python3.8/site-packages/sklearn/model_selection/_split.py in train_test_split(*arrays, **options) - 2125 raise TypeError("Invalid parameters passed: %s" % str(options)) - 2126  --> 2127 arrays = indexable(*arrays) - 2128  - 2129 n_samples = _num_samples(arrays[0]) - -~/opt/anaconda3/lib/python3.8/site-packages/sklearn/utils/validation.py in indexable(*iterables) - 290 """ - 291 result = [_make_indexable(X) for X in iterables] ---> 292 check_consistent_length(*result) - 293 return result - 294  - -~/opt/anaconda3/lib/python3.8/site-packages/sklearn/utils/validation.py in check_consistent_length(*arrays) - 253 uniques = np.unique(lengths) - 254 if len(uniques) > 1: ---> 255 raise ValueError("Found input variables with inconsistent numbers of" - 256 " samples: %r" % [int(l) for l in lengths]) - 257  - -ValueError: Found input variables with inconsistent numbers of samples: [1000, 100] -ValueError: Found input variables with inconsistent numbers of samples: [1000, 100] - diff --git a/doc/LectureNotes/_build/html/reports/chapter10.log b/doc/LectureNotes/_build/html/reports/chapter10.log deleted file mode 100644 index 5c0d14ab9..000000000 --- a/doc/LectureNotes/_build/html/reports/chapter10.log +++ /dev/null @@ -1,29 +0,0 @@ -Traceback (most recent call last): - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/jupyter_cache/executors/utils.py", line 51, in single_nb_execution - executenb( - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/client.py", line 1087, in execute - return NotebookClient(nb=nb, resources=resources, km=km, **kwargs).execute() - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/util.py", line 74, in wrapped - return just_run(coro(*args, **kwargs)) - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/util.py", line 53, in just_run - return loop.run_until_complete(coro) - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/asyncio/base_events.py", line 616, in run_until_complete - return future.result() - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/client.py", line 540, in async_execute - await self.async_execute_cell( - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/client.py", line 832, in async_execute_cell - self._check_raise_for_error(cell, exec_reply) - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/client.py", line 740, in _check_raise_for_error - raise CellExecutionError.from_cell_and_msg(cell, exec_reply['content']) -nbclient.exceptions.CellExecutionError: An error occurred while executing the following cell: ------------------- -pip3 install tensorflow ------------------- - - File "", line 1 - pip3 install tensorflow - ^ -SyntaxError: invalid syntax - -SyntaxError: invalid syntax (, line 1) - diff --git a/doc/LectureNotes/_build/html/reports/chapter2.log b/doc/LectureNotes/_build/html/reports/chapter2.log deleted file mode 100644 index c33dc36fd..000000000 --- a/doc/LectureNotes/_build/html/reports/chapter2.log +++ /dev/null @@ -1,37 +0,0 @@ -Traceback (most recent call last): - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/jupyter_cache/executors/utils.py", line 51, in single_nb_execution - executenb( - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/client.py", line 1087, in execute - return NotebookClient(nb=nb, resources=resources, km=km, **kwargs).execute() - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/util.py", line 74, in wrapped - return just_run(coro(*args, **kwargs)) - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/util.py", line 53, in just_run - return loop.run_until_complete(coro) - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/asyncio/base_events.py", line 616, in run_until_complete - return future.result() - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/client.py", line 540, in async_execute - await self.async_execute_cell( - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/client.py", line 832, in async_execute_cell - self._check_raise_for_error(cell, exec_reply) - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/client.py", line 740, in _check_raise_for_error - raise CellExecutionError.from_cell_and_msg(cell, exec_reply['content']) -nbclient.exceptions.CellExecutionError: An error occurred while executing the following cell: ------------------- -Ainv = np.linlag.pinv(A) ------------------- - ---------------------------------------------------------------------------- -AttributeError Traceback (most recent call last) - in  -----> 1 Ainv = np.linlag.pinv(A) - -~/opt/anaconda3/lib/python3.8/site-packages/numpy/__init__.py in __getattr__(attr) - 212 return Tester - 213 else: ---> 214 raise AttributeError("module {!r} has no attribute " - 215 "{!r}".format(__name__, attr)) - 216  - -AttributeError: module 'numpy' has no attribute 'linlag' -AttributeError: module 'numpy' has no attribute 'linlag' - diff --git a/doc/LectureNotes/_build/html/reports/chapter4.log b/doc/LectureNotes/_build/html/reports/chapter4.log deleted file mode 100644 index 2532b0d6a..000000000 --- a/doc/LectureNotes/_build/html/reports/chapter4.log +++ /dev/null @@ -1,84 +0,0 @@ -Traceback (most recent call last): - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/jupyter_cache/executors/utils.py", line 51, in single_nb_execution - executenb( - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/client.py", line 1087, in execute - return NotebookClient(nb=nb, resources=resources, km=km, **kwargs).execute() - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/util.py", line 74, in wrapped - return just_run(coro(*args, **kwargs)) - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/util.py", line 53, in just_run - return loop.run_until_complete(coro) - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/asyncio/base_events.py", line 616, in run_until_complete - return future.result() - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/client.py", line 540, in async_execute - await self.async_execute_cell( - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/client.py", line 832, in async_execute_cell - self._check_raise_for_error(cell, exec_reply) - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/client.py", line 740, in _check_raise_for_error - raise CellExecutionError.from_cell_and_msg(cell, exec_reply['content']) -nbclient.exceptions.CellExecutionError: An error occurred while executing the following cell: ------------------- -import autograd.numpy as np -from autograd import grad -def f8(x): # Assume x is an array - x[2] = 3 - return x*2 - -f8_grad = grad(f8) - -x = 8.4 - -print("The derivative of f8 is:",f8_grad(x)) ------------------- - ---------------------------------------------------------------------------- -TypeError Traceback (most recent call last) - in  - 9 x = 8.4 - 10  ----> 11 print("The derivative of f8 is:",f8_grad(x)) - -~/opt/anaconda3/lib/python3.8/site-packages/autograd/wrap_util.py in nary_f(*args, **kwargs) - 18 else: - 19 x = tuple(args[i] for i in argnum) ----> 20 return unary_operator(unary_f, x, *nary_op_args, **nary_op_kwargs) - 21 return nary_f - 22 return nary_operator - -~/opt/anaconda3/lib/python3.8/site-packages/autograd/differential_operators.py in grad(fun, x) - 23 arguments as `fun`, but returns the gradient instead. The function `fun` - 24 should be scalar-valued. The gradient has the same type as the argument.""" ----> 25 vjp, ans = _make_vjp(fun, x) - 26 if not vspace(ans).size == 1: - 27 raise TypeError("Grad only applies to real scalar-output functions. " - -~/opt/anaconda3/lib/python3.8/site-packages/autograd/core.py in make_vjp(fun, x) - 8 def make_vjp(fun, x): - 9 start_node = VJPNode.new_root() ----> 10 end_value, end_node = trace(start_node, fun, x) - 11 if end_node is None: - 12 def vjp(g): return vspace(x).zeros() - -~/opt/anaconda3/lib/python3.8/site-packages/autograd/tracer.py in trace(start_node, fun, x) - 8 with trace_stack.new_trace() as t: - 9 start_box = new_box(x, t, start_node) ----> 10 end_box = fun(start_box) - 11 if isbox(end_box) and end_box._trace == start_box._trace: - 12 return end_box._value, end_box._node - -~/opt/anaconda3/lib/python3.8/site-packages/autograd/wrap_util.py in unary_f(x) - 13 else: - 14 subargs = subvals(args, zip(argnum, x)) ----> 15 return fun(*subargs, **kwargs) - 16 if isinstance(argnum, int): - 17 x = args[argnum] - - in f8(x) - 2 from autograd import grad - 3 def f8(x): # Assume x is an array -----> 4 x[2] = 3 - 5 return x*2 - 6  - -TypeError: 'ArrayBox' object does not support item assignment -TypeError: 'ArrayBox' object does not support item assignment - diff --git a/doc/LectureNotes/_build/html/reports/chapter5.log b/doc/LectureNotes/_build/html/reports/chapter5.log deleted file mode 100644 index 828ec304d..000000000 --- a/doc/LectureNotes/_build/html/reports/chapter5.log +++ /dev/null @@ -1,41 +0,0 @@ -Traceback (most recent call last): - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/jupyter_cache/executors/utils.py", line 51, in single_nb_execution - executenb( - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/client.py", line 1087, in execute - return NotebookClient(nb=nb, resources=resources, km=km, **kwargs).execute() - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/util.py", line 74, in wrapped - return just_run(coro(*args, **kwargs)) - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/util.py", line 53, in just_run - return loop.run_until_complete(coro) - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/asyncio/base_events.py", line 616, in run_until_complete - return future.result() - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/client.py", line 540, in async_execute - await self.async_execute_cell( - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/client.py", line 832, in async_execute_cell - self._check_raise_for_error(cell, exec_reply) - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/client.py", line 740, in _check_raise_for_error - raise CellExecutionError.from_cell_and_msg(cell, exec_reply['content']) -nbclient.exceptions.CellExecutionError: An error occurred while executing the following cell: ------------------- -# Import the necessary packages -import numpy -from cvxopt import matrix -from cvxopt import solvers -P = matrix(numpy.diag([1,0]), tc=’d’) -q = matrix(numpy.array([3,4]), tc=’d’) -G = matrix(numpy.array([[-1,0],[0,-1],[-1,-3],[2,5],[3,4]]), tc=’d’) -h = matrix(numpy.array([0,0,-15,100,80]), tc=’d’) -# Construct the QP, invoke solver -sol = solvers.qp(P,q,G,h) -# Extract optimal value and solution -sol[’x’] -sol[’primal objective’] ------------------- - - File "", line 5 - P = matrix(numpy.diag([1,0]), tc=’d’) - ^ -SyntaxError: invalid character in identifier - -SyntaxError: invalid character in identifier (, line 5) - diff --git a/doc/LectureNotes/_build/html/reports/chapter6.log b/doc/LectureNotes/_build/html/reports/chapter6.log deleted file mode 100644 index b9dbedf5f..000000000 --- a/doc/LectureNotes/_build/html/reports/chapter6.log +++ /dev/null @@ -1,66 +0,0 @@ -Traceback (most recent call last): - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/jupyter_cache/executors/utils.py", line 51, in single_nb_execution - executenb( - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/client.py", line 1087, in execute - return NotebookClient(nb=nb, resources=resources, km=km, **kwargs).execute() - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/util.py", line 74, in wrapped - return just_run(coro(*args, **kwargs)) - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/util.py", line 53, in just_run - return loop.run_until_complete(coro) - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/asyncio/base_events.py", line 616, in run_until_complete - return future.result() - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/client.py", line 540, in async_execute - await self.async_execute_cell( - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/client.py", line 832, in async_execute_cell - self._check_raise_for_error(cell, exec_reply) - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/client.py", line 740, in _check_raise_for_error - raise CellExecutionError.from_cell_and_msg(cell, exec_reply['content']) -nbclient.exceptions.CellExecutionError: An error occurred while executing the following cell: ------------------- -import os -from sklearn.datasets import load_breast_cancer -from sklearn.tree import DecisionTreeClassifier -from sklearn.model_selection import train_test_split -from sklearn.metrics import confusion_matrix -from sklearn.tree import export_graphviz - -from IPython.display import Image -from pydot import graph_from_dot_data -import pandas as pd -import numpy as np - - -cancer = load_breast_cancer() -X = pd.DataFrame(cancer.data, columns=cancer.feature_names) -print(X) -y = pd.Categorical.from_codes(cancer.target, cancer.target_names) -y = pd.get_dummies(y) -print(y) -X_train, X_test, y_train, y_test = train_test_split(X, y, random_state=1) -tree_clf = DecisionTreeClassifier(max_depth=5) -tree_clf.fit(X_train, y_train) - -export_graphviz( - tree_clf, - out_file="DataFiles/cancer.dot", - feature_names=cancer.feature_names, - class_names=cancer.target_names, - rounded=True, - filled=True -) -cmd = 'dot -Tpng DataFiles/cancer.dot -o DataFiles/cancer.png' -os.system(cmd) ------------------- - ---------------------------------------------------------------------------- -ModuleNotFoundError Traceback (most recent call last) - in  - 7  - 8 from IPython.display import Image -----> 9 from pydot import graph_from_dot_data - 10 import pandas as pd - 11 import numpy as np - -ModuleNotFoundError: No module named 'pydot' -ModuleNotFoundError: No module named 'pydot' - diff --git a/doc/LectureNotes/_build/html/reports/chapter7.log b/doc/LectureNotes/_build/html/reports/chapter7.log deleted file mode 100644 index 727b82aa1..000000000 --- a/doc/LectureNotes/_build/html/reports/chapter7.log +++ /dev/null @@ -1,46 +0,0 @@ -Traceback (most recent call last): - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/jupyter_cache/executors/utils.py", line 51, in single_nb_execution - executenb( - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/client.py", line 1087, in execute - return NotebookClient(nb=nb, resources=resources, km=km, **kwargs).execute() - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/util.py", line 74, in wrapped - return just_run(coro(*args, **kwargs)) - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/util.py", line 53, in just_run - return loop.run_until_complete(coro) - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/asyncio/base_events.py", line 616, in run_until_complete - return future.result() - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/client.py", line 540, in async_execute - await self.async_execute_cell( - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/client.py", line 832, in async_execute_cell - self._check_raise_for_error(cell, exec_reply) - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/client.py", line 740, in _check_raise_for_error - raise CellExecutionError.from_cell_and_msg(cell, exec_reply['content']) -nbclient.exceptions.CellExecutionError: An error occurred while executing the following cell: ------------------- -heads_proba = 0.51 -coin_tosses = (np.random.rand(10000, 10) < heads_proba).astype(np.int32) -cumulative_heads_ratio = np.cumsum(coin_tosses, axis=0) / np.arange(1, 10001).reshape(-1, 1) -plt.figure(figsize=(8,3.5)) -plt.plot(cumulative_heads_ratio) -plt.plot([0, 10000], [0.51, 0.51], "k--", linewidth=2, label="51%") -plt.plot([0, 10000], [0.5, 0.5], "k-", label="50%") -plt.xlabel("Number of coin tosses") -plt.ylabel("Heads ratio") -plt.legend(loc="lower right") -plt.axis([0, 10000, 0.42, 0.58]) -save_fig("votingsimple") -plt.show() ------------------- - ---------------------------------------------------------------------------- -NameError Traceback (most recent call last) - in  - 1 heads_proba = 0.51 -----> 2 coin_tosses = (np.random.rand(10000, 10) < heads_proba).astype(np.int32) - 3 cumulative_heads_ratio = np.cumsum(coin_tosses, axis=0) / np.arange(1, 10001).reshape(-1, 1) - 4 plt.figure(figsize=(8,3.5)) - 5 plt.plot(cumulative_heads_ratio) - -NameError: name 'np' is not defined -NameError: name 'np' is not defined - diff --git a/doc/LectureNotes/_build/html/reports/linalg.log b/doc/LectureNotes/_build/html/reports/linalg.log deleted file mode 100644 index 4cb123d39..000000000 --- a/doc/LectureNotes/_build/html/reports/linalg.log +++ /dev/null @@ -1,31 +0,0 @@ -Traceback (most recent call last): - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/jupyter_cache/executors/utils.py", line 51, in single_nb_execution - executenb( - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/client.py", line 1087, in execute - return NotebookClient(nb=nb, resources=resources, km=km, **kwargs).execute() - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/util.py", line 74, in wrapped - return just_run(coro(*args, **kwargs)) - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/util.py", line 53, in just_run - return loop.run_until_complete(coro) - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/asyncio/base_events.py", line 616, in run_until_complete - return future.result() - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/client.py", line 540, in async_execute - await self.async_execute_cell( - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/client.py", line 832, in async_execute_cell - self._check_raise_for_error(cell, exec_reply) - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/client.py", line 740, in _check_raise_for_error - raise CellExecutionError.from_cell_and_msg(cell, exec_reply['content']) -nbclient.exceptions.CellExecutionError: An error occurred while executing the following cell: ------------------- -import numpy as np -x = np.log(np.array([4.0, 7.0, 8.0]) -print(x) ------------------- - - File "", line 3 - print(x) - ^ -SyntaxError: invalid syntax - -SyntaxError: invalid syntax (, line 3) - diff --git a/doc/LectureNotes/_build/html/reports/statistics.log b/doc/LectureNotes/_build/html/reports/statistics.log deleted file mode 100644 index 279cbb99d..000000000 --- a/doc/LectureNotes/_build/html/reports/statistics.log +++ /dev/null @@ -1,58 +0,0 @@ -Traceback (most recent call last): - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/jupyter_cache/executors/utils.py", line 51, in single_nb_execution - executenb( - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/client.py", line 1087, in execute - return NotebookClient(nb=nb, resources=resources, km=km, **kwargs).execute() - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/util.py", line 74, in wrapped - return just_run(coro(*args, **kwargs)) - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/util.py", line 53, in just_run - return loop.run_until_complete(coro) - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/asyncio/base_events.py", line 616, in run_until_complete - return future.result() - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/client.py", line 540, in async_execute - await self.async_execute_cell( - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/client.py", line 832, in async_execute_cell - self._check_raise_for_error(cell, exec_reply) - File "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/nbclient/client.py", line 740, in _check_raise_for_error - raise CellExecutionError.from_cell_and_msg(cell, exec_reply['content']) -nbclient.exceptions.CellExecutionError: An error occurred while executing the following cell: ------------------- -# Blocking - @timeFunction - def blocking(self, blockSizeMax = 500): - blockSizeMin = 1 - - self.blockSizes = [] - self.meanVec = [] - self.varVec = [] - - for i in range(blockSizeMin, blockSizeMax): - if(len(self.data) % i != 0): - pass#continue - blockSize = i - meanTempVec = [] - varTempVec = [] - startPoint = 0 - endPoint = blockSize - - while endPoint <= len(self.data): - meanTempVec.append(np.average(self.data[startPoint:endPoint])) - startPoint = endPoint - endPoint += blockSize - mean, var = np.average(meanTempVec), np.var(meanTempVec)/len(meanTempVec) - self.meanVec.append(mean) - self.varVec.append(var) - self.blockSizes.append(blockSize) - - self.blockingAvg = np.average(self.meanVec[-200:]) - self.blockingVar = (np.average(self.varVec[-200:])) - self.blockingStd = np.sqrt(self.blockingVar) ------------------- - - File "", line 2 - @timeFunction - ^ -IndentationError: unexpected indent - -IndentationError: unexpected indent (, line 2) - diff --git a/doc/LectureNotes/_build/html/schedule.html b/doc/LectureNotes/_build/html/schedule.html deleted file mode 100644 index 5f2f1a901..000000000 --- a/doc/LectureNotes/_build/html/schedule.html +++ /dev/null @@ -1,744 +0,0 @@ - - - - - - - - Teaching schedule with links to material — Applied Data Analysis and Machine Learning - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
- - - - - - - - -
- - -
-
- -
- - - - - - -
- - - - -
-
-
-
-

- - By Morten Hjorth-Jensen
- - © Copyright 2021.
-

-
-
-
- - -
-
- - - - - - \ No newline at end of file diff --git a/doc/LectureNotes/_build/html/search.html b/doc/LectureNotes/_build/html/search.html deleted file mode 100644 index 997dacadf..000000000 --- a/doc/LectureNotes/_build/html/search.html +++ /dev/null @@ -1,338 +0,0 @@ - - - - - - - - Search — Applied Data Analysis and Machine Learning - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
- - - - - - - - -
- -
-
- -
- - - - - - - - - - - - -
- - -
- -
-
-
-
-
- -
- -

Search

-
- -

- Please activate JavaScript to enable the search - functionality. -

-
-

- Searching for multiple words only shows matches that contain - all words. -

-
- - - -
- -
- -
- -
- - -
- - -
- -
-
-
-
-

- - By Morten Hjorth-Jensen
- - © Copyright 2021.
-

-
-
-
- - -
-
- - - - - - \ No newline at end of file diff --git a/doc/LectureNotes/_build/html/searchindex.js b/doc/LectureNotes/_build/html/searchindex.js deleted file mode 100644 index aef1c2509..000000000 --- a/doc/LectureNotes/_build/html/searchindex.js +++ /dev/null @@ -1 +0,0 @@ -Search.setIndex({docnames:["Clustering","chapter1","chapter10","chapter11","chapter2","chapter3","chapter4","chapter5","chapter6","chapter7","chapter8","chapter9","chapteroptimization","intro","linalg","schedule","statistics","teachers","textbooks"],envversion:{"sphinx.domains.c":2,"sphinx.domains.changeset":1,"sphinx.domains.citation":1,"sphinx.domains.cpp":3,"sphinx.domains.index":1,"sphinx.domains.javascript":2,"sphinx.domains.math":2,"sphinx.domains.python":2,"sphinx.domains.rst":2,"sphinx.domains.std":1,"sphinx.ext.intersphinx":1,sphinx:56},filenames:["Clustering.ipynb","chapter1.ipynb","chapter10.ipynb","chapter11.ipynb","chapter2.ipynb","chapter3.ipynb","chapter4.ipynb","chapter5.ipynb","chapter6.ipynb","chapter7.ipynb","chapter8.ipynb","chapter9.ipynb","chapteroptimization.ipynb","intro.md","linalg.ipynb","schedule.md","statistics.ipynb","teachers.md","textbooks.md"],objects:{},objnames:{},objtypes:{},terms:{"000":2,"000000":[1,4,10],"00000000e":4,"0001":2,"00015921913736794912":[],"000171990965637209":16,"00019348106804731915":[],"00019998":4,"00024087":4,"0002644543695187602":8,"00029012":4,"00031535148309579146":5,"00031535148309581185":5,"0003451":[],"00034944":4,"000417932":3,"00042089":4,"000464088":3,"00050694":4,"00058016":5,"00060724":5,"00060728":[],"00061058":4,"00062588":[],"00062728":5,"00064055":[],"00066668":5,"00068734":5,"00068970":[],"00069302":5,"00070278":12,"00073541":4,"00076495":5,"00076916":[],"00076923":5,"000769847326055633":5,"0007698473260556339":5,"00078806":[],"00079022":5,"00079968":4,"00084589":[],"00084714":5,"00085887":[],"00085890":5,"00087697":5,"00088573":4,"00092354":[],"00092686":5,"00096314":4,"001":[2,3,7,12],"00100519":5,"0010479246398391328":5,"00105081":5,"00106677":4,"00107405":5,"00109273":[],"00111756":5,"0011526":5,"00115999":4,"00118170":[],"00118678":5,"00128479":4,"001323":5,"00137945":5,"00137982":[],"00139705":4,"00149311":5,"00149956":5,"0015":[],"00152117":5,"00154733":4,"00156372":5,"00168251":4,"00174276":5,"00175331":5,"00186347":4,"001880":4,"00200":7,"00202624":4,"00202756":5,"00217499":5,"00224413":4,"00228740":[],"00228741":5,"0023548":5,"002381316302584886":5,"0023813163025848865":5,"00240127":1,"00242998":[],"00242999":5,"00243186":5,"0024401":4,"00247083e":[],"00249435":5,"00266858":3,"00270244":4,"00274989":5,"00289724":5,"00293838":4,"00310113":3,"00312361":5,"00315593":5,"0032153180657605086":5,"00323332":5,"0032542":4,"0032873138755776365":[],"003301":5,"0033955154592040936":5,"00353823":4,"0036237":5,"0036367":5,"0036406517028808594":0,"00369758":5,"003704":1,"003717":1,"003759":1,"003774":1,"003788":1,"0038335":5,"00384936":[],"003909404072811237":5,"00391839":4,"00396825":[],"0039987":5,"004":4,"004084":[],"004091940707753964":5,"00410387":5,"00410478":5,"0041136346174431284":5,"004113634617443135":5,"004113634617443136":5,"004113634617443137":5,"004155986345861379":5,"00424909":3,"00424967":5,"00426027":4,"00433417":10,"00440346":5,"00443743":5,"004456043243408203":[],"00445655":10,"004579219539673833":5,"00458878":5,"004610275230656537":5,"00462287":5,"00471782":4,"00472199":5,"00472512":5,"004904031753540039":[],"0049544":5,"0049999999999999845":[],"004999999999999996":[],"004999999999999997":[],"0050000000000000044":1,"005000000000000007":[],"00512927":4,"00517114":5,"00526348":5,"0053018":5,"00532744652682568":[],"005481494389472717":16,"00554552":5,"00556826":5,"0056799":4,"00579953":5,"00588657":5,"00607783":5,"006162":5,"00617499":4,"0063":[],"00630331":5,"00642221":5,"006530396683779109":[],"00660427":5,"00672607":5,"00673407":5,"00676387":5,"0068011":5,"00683748":4,"00683964":5,"006968283076248407":[],"007024126888936384":5,"00717152":[],"00719176":5,"00727646693":1,"00728323e":[],"007315":1,"0074331":4,"00745587e":[],"007456":[],"00759119":5,"007789":[],"007824":1,"00784393":5,"007931713723267314":[],"00803064":5,"00813803":5,"008171076530362356":[],"00817631":5,"00823002":4,"00827728":5,"00831018":5,"00834567":5,"00848904":5,"0086649156":1,"008675369724976777":4,"008885578722629236":[],"00890601":[],"00894639":4,"00905423":5,"009154":1,"009163470508352228":4,"009164545680330616":5,"00917248":5,"00934499":5,"0096208":5,"009735":[],"00973536":[],"009790":1,"009883615646716182":[],"009883615646716184":[],"009883615646716186":1,"009883615646716188":[],"00990475":4,"009911":1,"00992331":5,"00996754":5,"00it":[],"010018312644140933":5,"0100706":5,"010331721306655588":5,"010400010476420727":[],"010516485576652981":5,"01057384067458835":[],"01066519":5,"010679893512872646":[],"010708859852916969":1,"01076611":4,"0110":16,"011076219011390184":5,"011225":3,"011239358265567037":1,"0113104":5,"011347":1,"01179792":5,"01191824":4,"0119839668275544":4,"012073649480472317":5,"01210814993019007":[],"01219292":5,"01223198":5,"01231917":5,"01274179":[],"012742":[],"01290947":5,"01295356":4,"01312157412031145":5,"01318643":5,"01324363":[],"013244":[],"01347916":5,"01348565":5,"01367553":5,"01397146":5,"01403105":12,"01405935":5,"0140617":[],"01416528":5,"01433809":4,"01443680008897583":5,"01449782":5,"01458337":5,"0146081":5,"01463049":5,"01503674":[],"015037":[],"015072388895177083":5,"01507238889517716":5,"01514394":[],"015144":[],"01531845":5,"01533265828497683":[],"01549377":5,"01558197":4,"01628578269590588":5,"01633913":5,"0163616":[],"01640891":5,"01655318":5,"016587414993048166":5,"01691985":5,"0169643":4,"0170259":[],"01708781":5,"01708852":5,"01713366":5,"01724499":4,"017355848195591973":5,"017665":4,"018232":1,"01825571":[],"01831152e":5,"01831250e":5,"01866537":5,"01867234e":[],"01873344":10,"01873869":4,"01887348":[],"01898855":5,"019":[],"01905883":5,"01908936":5,"01963611":5,"01969145":5,"01975416527163567":5,"01975848":5,"01it":[],"02024962":5,"02054837e":5,"02068067":5,"02073509":4,"02096350e":[],"02098261":5,"02123176":5,"021544346900318832":[],"021592704588043153":5,"021592704588043167":5,"02161783e":[],"021901":[],"02190139":[],"02198702e":5,"02208512":5,"022116476923538613":[],"02228115":5,"02229529":5,"02252765":4,"02299949826036597":5,"02348765":5,"02365049":5,"0245528":5,"02492265":4,"02493044e":[],"02498832":5,"02503753":5,"02511518":5,"02522069":5,"025521898567525465":16,"02568378":[],"025709":[1,10],"02586427":5,"026":[],"0260906":5,"02625193":7,"026605727637189085":5,"0266057276371891":5,"02707227":4,"02723445":5,"02730126581656065":[],"027609773491022498":5,"027609773491022505":5,"028":[],"02881304":[],"029":[],"029117514654528":16,"029483":4,"029688":[],"02968834":[],"02972824e":[],"029733":1,"02976145":5,"02994311":4,"02f":5,"02it":5,"03005885":[],"03019554":[],"030196":[],"03032441e":5,"030670":[],"03067028":[],"03099776":4,"031":4,"03193199":[],"03196357":5,"03251863":4,"03256632e":2,"03267527":5,"03279636":5,"032853":10,"03285324":10,"032921":[],"03292103":[],"0330308045181225":5,"033030804518383":5,"03303359":[],"033037772005753835":[],"03308408":4,"033145":[],"0333934":[],"03365768507152761":5,"034026":[],"034342":[],"0344707":[],"03447512":5,"0354":[],"03562355":5,"03568439":5,"03581286":[],"0359565":4,"03607832":[],"03630548":5,"03652792":[],"036528":[],"03697069":[],"03707133":10,"03750367":[],"03781367141738898":5,"03781367141738899":5,"03787596148305236":1,"03791824e":[],"03814292":5,"03815288":5,"038300":[1,10],"03871832":[],"039039":4,"03929932":[],"03970472":[],"039967668952797":5,"0399676689527975":5,"03it":[],"040102":4,"04010697":5,"04033655":[],"04063602":5,"0411487294305266":5,"0411487294305548":5,"04205220e":[],"04220758":5,"042269":[],"04226949":[],"042552":[],"04260073e":[],"04270833":16,"04315108":4,"04330858":[],"04346721":4,"04348504":[],"04355837":5,"0437499":3,"04389027":5,"04421672e":[],"04423486":5,"044334":1,"044402":1,"04455272":[],"044553":[],"044613":5,"04497536":[],"04529095":[],"04532409":[],"04537385":5,"04543942":5,"04566964":5,"04568240116212":[],"04569689":[],"0458":8,"04621283":[],"04624055":16,"04648335":4,"04683565":4,"04751489":16,"04757618e":[],"04784395":5,"048187277304303125":5,"04829457939163212":[],"048582":4,"04858244":4,"04892055":5,"04909093":5,"04912436":5,"0495569966278269":5,"0495569966278282":5,"05009826":5,"05100875":5,"051115":[],"051418":4,"051649":[1,10],"0517473":4,"05227921801205707":5,"05227921801205709":5,"052645":[],"05295709":[],"053053":[],"0530533":[],"053069":[],"05318162":[],"053182":[],"05364854":7,"05383795":5,"053849":4,"05396545e":[],"05404886":14,"054187":[],"054276":[],"05430325e":[],"05447415":5,"0545103":[],"054674":[],"055":[],"05505310046363":3,"055065":[],"055085":[],"05531364":[],"055314":[],"0553457008138535":[],"055455110765643":[],"055529303095955385":[],"055542":10,"055676":1,"055744":[],"055774":[],"055788":[],"055831":[],"055887":[],"055916":[],"05614483":4,"056326":[],"056329":[],"05636001":[],"056441":[],"056484":[],"05651951":5,"056570":[],"057035":[],"057088709963637":1,"0571636815533073":5,"057320":[],"057332":[],"05755374":[],"057571":[],"057654":[],"05785343":5,"05789007":5,"057919":[],"05796251":5,"05802766":[],"05805002932374468":[],"05807125":5,"058141":[],"058178":[],"058247":[],"058249":[],"058282":[],"0584909962471034":[],"058719":[],"058765":[],"058805":[],"058856":10,"058892":[],"059038":[],"059107":10,"059225":[],"059245":[],"059344":[],"059406":[],"059455":[],"059531":[],"059571":[],"059604":[],"059680303635344434":[],"059765":[],"059767":[],"059806":[],"059865":[],"059908":[],"059994":[],"05it":[],"060011":[],"060064":[],"060070":[],"06020587":5,"060308":[],"060335":[],"06041458e":[],"06043581":5,"060520":[],"060591":[],"060603":[],"060678":[],"060748":[],"060919":[],"061154":[],"061164":[],"061176":[],"061255":[],"06126507e":[],"061330":[],"061366":10,"061430":[],"061601":[],"061652":[],"061660":[],"061774":[],"061783":[],"061842":[],"061846":[],"061855":[],"061857":[],"061885":[],"061896":[],"061983":[],"06200174":4,"062022":[],"062054":10,"062076":[],"062082386342319454":5,"06209126":[],"062149":[],"062188":[],"062305":10,"062327":[],"062352":[],"062376":[],"062396":10,"062486":[],"062636":[],"062639":[],"062659":[],"062660":[],"062731":[],"062733":[],"062777":[],"062803":[],"062822":[],"062829":[],"062879":[],"062885":[],"062923":[],"062979":[],"063055":[],"063097":[],"063114":[],"063122":[],"063171":[],"063178":[],"063190":[],"063260":10,"063324":[],"063380":[],"063395":[],"063415":[],"063523":[],"063526":[],"063615":[],"06365882":[],"063659":[],"063670":[],"063727":[],"063738":[],"063743":[],"063759":[],"063763":[],"063814":[],"063880":[],"063882":[],"063925":[],"063954":[],"063982":[],"063986":[],"064000":[],"064013":[],"064050":[],"064075":[],"064078":[],"064101":[],"06412177e":[],"064156":[],"064256":[],"064257":[],"064273":[],"064304":[],"064354":[],"064357":[],"064393":[],"064410":[],"064434":[],"064449":[],"064472":[],"06453579006728317":5,"064591":[],"064647":[],"064648":[],"064683":10,"064686":[],"064689":[],"064783":[],"064795":[],"064909":[],"06491736":5,"06492086e":[],"064929":[],"064945":[],"064958":[],"064964":[],"064982":[],"065":[],"065003":[],"065016":[],"065059":[],"065086":[],"065096":[],"065110":[],"065135":10,"065144":[],"065151":[],"065188":[],"065200":[],"065202":[],"065204":[],"065235":[],"065289":[],"065292":[],"065334":[],"065355":[],"065378":[],"065408":[],"06540809":[],"06547790180152352":5,"06547790180152355":5,"065492":[],"065517":[],"065534":[],"065545":[],"065582":[],"065591":[],"065618":[],"065660":[],"065680":[],"065762":[],"065794":[],"065855":10,"065860":[],"065864":10,"065991":[],"065994":[],"066002":[],"06600226":[],"066030":[],"066047":[],"066074":[],"066086":10,"066092":[],"066098":[],"066116":[],"06619182206626131":[],"066196":[],"066249":[],"066272":[],"066283":10,"066294":[],"066312":[],"066372":[],"066389":[],"066403":[],"066487":[],"066629":[],"066653":[],"0666807":3,"066683":[],"066705":[],"066761":[],"066778":[],"066788":[],"066793":[],"066835":[],"066837":[1,10],"066912":[],"066949":[],"066951":[],"066963":[],"067043":[],"067060":[],"067061":[],"067080":[],"067123":[],"067132":[],"067175":[],"067202":[],"06724062":4,"067262":[],"067326":[],"067329":[],"067355":[],"067433":[],"067440":[],"067442":[],"067492":[],"067504":[],"067531":[],"067577":[],"067601":[],"067610":[],"067667":[],"067685":[],"067711":[],"067718":[],"067729":10,"067769":[],"067777":[],"067793":[],"067794":[],"067811":[],"067844":[],"067865":[],"067889":[],"067892":[],"067904":[],"06793578e":[],"067977":10,"067985":[],"067990":[],"0679953259809554":10,"068056":[],"068071":[],"068073":[],"068165":[],"068185":[],"068203":[],"068213":[],"068244":10,"068276":[],"068293":[],"068328":[],"06834":[],"068351":[],"068363":[],"068385":[],"068427":[],"06844519414009441":5,"06844519414009442":5,"068460":[],"068491":[],"068514":[],"068515":[],"068581":[],"068593":[],"068633":[],"068640":[],"068654":[],"068667":[],"068673":[],"068686":[],"068697":[],"068700":[],"068701":10,"068717":[],"068758":[],"068780":10,"068790":[],"068800":[],"068818":[],"068821":[],"068828":[],"068834":[],"068838":[],"068840":[],"068873":[],"068888":[],"068896":[],"068920":[],"068928":[],"068941":[],"068945":[],"069005":[],"069028":[],"069055":[],"069071":[],"069075":10,"069081":[],"069098":[],"069161":[],"069185":[],"069195":[],"069243":[],"069282":[],"069362":[],"069369":[],"069371":[],"069413":[],"069488":10,"069494":[],"069496":[],"069503":[],"069510":[],"069516":[],"069519":[],"069526":[],"069528":[],"069542":[],"069584":1,"069625":[],"069635":[],"069641":[],"069684":10,"069731":[],"069775":[],"069814":[],"069848":[],"069853":[],"069859":[],"069872":[],"069890":[],"069899":10,"069902":[],"069940":[],"069956":[],"069988":[],"069993":10,"069997":[],"06it":[],"070032":10,"070043":1,"070074":10,"070103":[],"070129":[],"070131":[],"070138":[],"070166":[],"070182":[],"070188":[],"070212":[],"070254":[],"070286":[],"070337":[],"070455":[],"070456":[],"070473":[],"07047448":5,"070479":[],"070517":[],"070548":[],"07062318":5,"070653":[],"070739":[],"070753":[],"070762":[],"070764":[],"070769":[],"07076926":[],"070791":[],"070793":10,"070812":[],"070815":[],"070824":[],"070866":[],"070867":[],"070889":[1,10],"070915":[],"070949":[],"070955":[],"070967":[],"071016":[],"071049":[],"07106781e":[],"071092":[],"071096":[],"07110274":[],"071137":10,"071155":[],"071156":[],"071248":[],"071268":[],"071284":[],"0713":1,"071309":[],"071311":[],"071313":[],"071325":[],"071359":[],"071435":[],"071447":[],"071447584032141":[],"07145103":10,"071453":[],"071481":[],"071499":[],"071502":[],"071541":[],"07154525":12,"071547":[],"071549":[],"07155335":[],"071576":[],"071579":[],"07159175":[],"07160048164228312":5,"07160048164228314":5,"07160764":[],"071609":[],"071660":[],"071667":[],"071681":[],"071682":[],"071684":[],"071714":[],"071761":[],"071782":[],"071794":[],"071841":[],"071855":[],"071887":[],"071917":[],"071979":[],"072012":[],"072046":[],"072071":[],"072094":[],"072170":[],"072197":[],"072198":[],"072246":[],"072248":[],"072252":10,"072279":[],"072296":[],"072352":[],"072424":[],"072447":[],"072468":[],"072471":[],"072539":10,"072555":[],"072557":[],"072589":[],"072598":[],"072608":[],"072620":[],"072654":[],"072661":[],"072668":10,"072687":[],"072690":10,"072710":[],"072722":10,"072770":[],"072826":[],"072862":[],"072879":[],"072910":10,"072940":[],"072995":[],"073":[],"073020":[],"073035":[],"073045":4,"073052":[],"073096":[],"07310737041838755":8,"073110":[],"073160":10,"073162":[],"073178":[],"073310":[],"073333":[],"073350":4,"073352":[],"073361":[],"073371":[],"073372":[],"073483":[],"073546":[],"073557":[],"073567":[],"073591":[],"073598":[1,10],"073602":[],"073607":[],"073611":[],"073656":[],"073681":[],"073695":[],"073713":[],"073728":[],"073734":[],"073765":[],"073789":10,"073827":[],"073851":[],"073902":[],"073915":1,"073926":[],"073966":[],"074":[],"074027":[],"074036":[],"074037":[],"074044":[],"074067":[1,10],"074070":[],"074077":[],"074079":[],"074096":[],"074099":[],"074118":10,"074125":[],"074130":[],"074134":[],"074154":[],"074170":[],"074191":[],"074201":[],"074207":[],"07421084":4,"074230":[],"07423848370736122":[],"074248":[],"074285":[],"074286":[],"074331":[],"074432":[],"074434":[],"074453":[],"074488":[],"074513":[],"074516":10,"074557":[],"07456491":4,"074568":[],"074618":[],"074624":[],"074644":10,"074647":10,"074665":[],"074693":[],"074696":[],"074761":[],"074848":[],"074858":[],"074900":[],"07490892":5,"074934":[],"074961":[],"074979":[],"074996":[],"075084":[],"075086":[],"075119":[],"075151":[],"075163":[],"075194":[],"075205":[],"075212":[],"07521771":[],"075218":[],"075222":10,"075261":[],"075266":[],"075289":[],"075296":[],"075309":[],"075318":[],"075503":4,"075526":[],"075537":[],"075542":[],"075545":[],"0755452":[],"075562":[],"075567":[],"075587":10,"075615":[],"075624":[],"075631":[],"075674":10,"075754":[],"075772":[],"07581375":[],"075814":[],"075818":[],"075821":[],"075865":[],"075869":[],"075975":[],"075993":[],"075998":[],"076026":[],"076058":4,"076062":[],"076068":[],"076121":[],"076166":[],"076169":[],"076189":[],"076213":[],"076251":[],"076283":[],"076320":[],"076367":[],"076377":[],"076398":[],"076408":[],"076410":[],"076466":[],"076469":[],"076473":[],"0764924":5,"076564":10,"07670437":[],"076730":[],"076731":[],"076743":10,"076774":[],"076784":[],"076789":[],"076803":[],"076810":[],"076822":[],"076853":[],"076854":10,"076938":[1,10],"076946":[],"076954":[],"077005":[],"077010":[],"077021":[],"077026":[],"077046":[],"077076":[],"077084":[],"077115":[],"077143":[],"077160":[],"077163":[],"077212":[],"077286":10,"07729012413236423":[],"077303":[],"077305":[],"077338":[],"077339":[],"077343":10,"077386":[],"077390":10,"077395":[],"077404":[],"077407":[],"077416":[],"07744472306026946":[],"077469":[],"077527":[],"077533":[],"077560":[],"077607":10,"077623":[],"077645":[],"077662":[],"077711":10,"077771":[],"07777777777777778":2,"077891":[],"077927":[],"077968":[],"078049":[],"078076":[],"078099":4,"078103":[],"078129":[],"078197":[],"078226":10,"078244":[],"078279":[],"078298":10,"078311":[],"078342":[],"078388":[],"078390":[],"078399":[],"07839924":[],"078402":[],"078414":[],"078451":[],"078474":[],"078497":10,"07851446":16,"07851716":16,"078529":[],"078646":[],"078649":[],"078674":[],"078693":[],"078710":[],"078717":[],"078720":[],"078731":[],"078746":[],"078750":[],"078892":[],"078901":[],"078927":[],"078930":[],"078937":[],"078938":4,"078966":[],"079001":[],"079029":[],"079037":[],"079085":[],"079111":[],"079137":[],"079139":[],"079162":10,"079210":[],"079228":[],"079253":[],"079267":[],"079312":[],"079333":[],"079337":[],"079351":[],"079365":[],"07944154":14,"079460":[],"079562":[],"079587":10,"079597":[],"079598":[],"079624":[],"079643":[],"07968918676726028":5,"07972177":[],"079774":10,"079785":[],"079801":[],"079815":[],"079848":[],"079956":[],"079963":10,"07it":[],"080024":[],"080066":[],"080069":[],"080084":1,"080101":[],"080115":[],"080173":[],"080182":[],"080223":[],"080249":[],"080264":[],"080265":[],"080325":[],"080336":[],"080341":[],"080344":10,"080381":[],"080387":[],"080398":[],"08043851":4,"080455":10,"08045792":[],"080493":[],"080529":4,"080548":10,"080565":[],"080570":[],"080583":[],"080612":[],"080626":[],"080633":[],"080656":10,"080675":[],"080678":[],"080738":[],"080806":[],"080840":[],"080845":4,"080846":[],"080871":[],"081024":[],"081031":[],"081069":10,"081077":[],"081085":[],"081092":[],"081101":4,"081102":[],"081103":[],"081106":[],"081129":[],"081210":[],"081227":[],"081260":[],"081270":[],"081309":[],"08131001":5,"08131003":[],"081402":[],"081414":[],"081425":[],"081428":10,"081435":[],"081450":[],"081474":[],"081480":[],"081489":[],"081514":[],"081529":[],"08156108":5,"081616":[],"081623":[],"081632":[],"08170444":[],"081732":[],"081744":[],"081778":[],"081784":10,"081816":[],"081886":[],"082003":4,"082032":[],"082091":[],"082136":[],"082179":4,"082203":10,"082211":[],"082212":[],"082225":[],"082239":[],"082247":[],"082272":[],"082303":[],"082333":10,"082382":[],"082413":[],"082468":4,"08248290e":[],"08251519":5,"08251898":[],"082549":[],"082616":[],"082666":[],"082687":[],"08271336":[],"082726":10,"082747":[],"08283349271892":4,"082866":[],"08292574":[],"082926":[],"082982":[],"082989":10,"082990":[],"08299273e":5,"083015":[],"083104":10,"083128":[],"0831307":[],"083138":[],"083177":[],"08318298e":2,"0832":[],"08321393":[],"083214":[],"083221":[],"083228":[],"083246":[],"083295":[],"083337":[],"083368":[],"083376":[],"083384":[],"083495":[],"083527":1,"083577":[],"08359441e":[],"083618":[],"08362077210702115":[],"083622":[],"083657":[],"083658":[],"083659":[],"083672":[],"083682":[],"083711":[],"083728":[],"083748":4,"08376632":5,"0837663229239025":5,"083766322923905":5,"083775":[],"083797":[],"083808":[],"08380813":[],"083817":[],"083855":[],"083859":4,"083905":[],"083951":4,"083974":10,"084":[],"084032":4,"08406534":[],"084071":[],"084092":[],"084103":[],"08415761":[],"084167":[],"084181":[],"084221":[],"084249":[],"084251":[],"08426840630693411":5,"08429424":[],"084394":4,"084408":10,"084433":10,"084461":[],"084604":[],"084679":4,"084745":10,"08476676":[],"084813":[],"084822":10,"084826":[],"084864":[],"084873":[],"084916":[],"084931":[],"08501147":[],"085041":[],"085061":4,"085121":[],"085189":[],"085192":10,"085253":[],"085259":[],"085269":4,"085285":[],"085289":[],"08534155":1,"085465":10,"085484":[],"085510":[],"08551306":5,"085544":[],"085567":4,"085569":[],"085597":[],"085598":[],"085610":[],"085627":[],"085632":10,"085636":10,"085646":[],"085676":[],"085748":[],"085760":10,"085763":[],"085765":4,"08576932":5,"085811":[],"085816":4,"085835":[],"085928":[],"08593216":5,"085951":[],"085968":4,"086006":[],"086052":[],"086076":[],"08611111111111111":2,"086116":[],"086231":4,"086266":10,"086325":[],"08638654":14,"086423":4,"086430":[],"086465":[],"086561":[],"086592":[],"08665060086846632":[],"086652":[],"086757":[],"086920":[],"086974":[],"086985":[],"087032":[],"087096":[],"087107":[],"087109":4,"087148":[],"087198":4,"087202":[],"087205":[],"087242":[],"087297":4,"087334":[],"087475":4,"087482":[],"087490":10,"087519":4,"087526":[],"087544":[],"087563":[],"087616":4,"087699":10,"087721":4,"087738":[],"087822":10,"088020":10,"088085":[],"088121":10,"088137":[],"088152":4,"0881981":4,"088209":[],"088258":[],"088260":[],"088348":4,"088351":10,"08839750e":[],"088414":[],"088484":[],"088516":4,"088556":[],"088660":[],"08871404":4,"088838":4,"08884844":16,"088848443911507":16,"088871":[],"08888888888888889":2,"088983":[],"08899392007617646":[],"089":[],"089011":10,"089033":4,"089039":[],"089250":[],"089300":[],"089326":[],"089352":[],"089366":4,"089425":[],"089437":[],"089499":4,"089500":4,"089504":[],"089540":[],"089693":[],"089694":10,"089727":4,"089754":4,"089828":10,"089869":4,"089881":[],"089916":[],"089928":[],"089931":[],"089996":4,"090008":4,"090099":[],"090107":[],"090149":10,"090239":[],"090274":[],"090338":10,"090343":4,"090355":[],"090368":10,"090414":4,"09060397":16,"090671":10,"090673":4,"090817":[],"091016":10,"09103481e":[],"091159":[],"091191":10,"091253":[],"091318":[],"091356":4,"09145189":[],"091535":[],"091542":[],"091561":4,"091566":[],"091572":4,"091578":[],"09160813":5,"091653":10,"091659":[],"09166666666666666":2,"0917":8,"091756":[],"091779":4,"091843":4,"091855":[],"091860":4,"091901":4,"091979":[],"09198004868226574":[],"092175":4,"092276":[],"092288":[],"092313":4,"092375":[],"092378":[],"092628":4,"092659":[],"092754":4,"092763":10,"09282061240353208":10,"092891":4,"092932":[],"092936":[],"092968":4,"093135":4,"093180":10,"093236":[],"093248":[],"093293":10,"093328":[],"093573":[],"093725":[],"093755":[],"093928":[],"093951":4,"094":[],"094052":4,"094082198961287e":5,"0940821989631478e":5,"094135":4,"094138":4,"094201":4,"094385":10,"094440":4,"094513":[],"09456011349477329":[],"094708":[],"094774":[],"094850":4,"094852":4,"09487315108590391":[],"095107":10,"095173":4,"095180":[],"095275":[],"095375":4,"095430":4,"095472":[],"09553421":12,"095636":4,"095771":4,"095786152583691":[],"095941":[],"09600813":12,"096033":4,"096070":4,"096087":4,"09609807":4,"096406":[],"096471":4,"096568":4,"096639":[],"096661":10,"096726":[],"09672604":[],"096763":[],"096774":10,"09678277e":[],"096802":[],"096955":4,"097007":4,"097041":4,"097150":[],"097346":[],"09741585e":[],"097448":4,"097452":[],"097488":4,"097606":4,"098":[],"098028":[],"098187":[],"098834":4,"09885613":1,"099":[],"099028":4,"09903804":7,"099049":4,"099079":[],"09919198949386163":5,"099374":4,"099504":[],"099609":[],"099763":[],"09976319":[],"099827":4,"099840":4,"0x7f8830b3a340":[],"0x7f88524ba760":[],"0x7f9f087db790":12,"0x7f9f1a921340":12,"0x7fc6a0739340":[],"0x7fc6b1bd1790":[],"0x7fda9123e220":[],"0x7fdab4f97430":[],"0x7febdb109490":[],"0x7febdb6780d0":[],"100":[0,1,2,3,4,5,6,7,8,9,10,12,14,16,17],"1000":[0,1,2,3,4,7,10,12,13,16],"10000":[0,3,4,5,9,10,16],"100000":7,"10001":9,"100065":4,"100074":4,"1001":16,"1002":16,"1003":16,"100443":4,"1005":16,"1007125":[],"10077114273548986":5,"1009":16,"10094646e":[],"1011":16,"1013":16,"10131725":[],"101332":10,"10135749":16,"1013904243":16,"10141413e":5,"10141414e":5,"1014841451296029":[],"1015":16,"101680":4,"101781":[],"102":1,"1022964509394572":2,"1023":16,"10238075":[],"102429":4,"102568":4,"1026":16,"1027":16,"102712819944882":10,"103":2,"1030":16,"103072":4,"10307631":[],"103254":4,"10327559":[],"10357077":[],"1037":16,"10378326e":2,"1038":16,"10391807":5,"10398646080125035":5,"10398646080125036":5,"1040":16,"10405456":10,"1043064188572242":1,"104411":1,"104606":4,"1047":16,"104887":[],"105137868830763":[],"105387":[],"105430":[],"10555555555555556":2,"10589577":4,"105983":4,"106095":[1,10],"106272":4,"10636484":[],"106946":[],"108":[1,5],"10806972":[],"108070":[],"10896672e":[],"10898112e":[],"10913":5,"10926826":16,"10931453":5,"109794":[],"10979444":[],"109996":4,"10it":5,"10th":8,"10x":1,"110":1,"1100":16,"1101":16,"11022302e":4,"11082097":16,"111":[2,6,11],"11100342e":[],"1111111111111111":2,"11171059":[],"111711":[],"112283":1,"112383":[1,10],"11304709e":[],"11388888888888889":2,"11456076e":[],"11462415":4,"11482289e":5,"11507992e":2,"1154777721897675":5,"11547777218976751":5,"115822":5,"11622885":16,"11666666666666667":2,"117":7,"11744554e":5,"118318":1,"11892185":[],"11944444444444445":2,"11945731":5,"119936":3,"12002944":[],"1203284":7,"121":[7,8,9],"12113897":[],"12182967":5,"122":[7,8,9],"12222222222222222":2,"1224808":12,"12283463":[],"12318726e":5,"123190":1,"12333649":5,"123459876":16,"12366979e":[],"123711":5,"124":1,"12497018e":[],"12552073e":5,"12618549":4,"1270":5,"1271":[],"12730791":[],"127773":16,"12777777777777777":2,"1289":5,"12908963":[],"1298":8,"12adb44b1c20":[],"13003291":5,"13019269":10,"130193":10,"13055555555555556":2,"13060772":[],"131343":[],"13140162":[],"13162821e":[],"13209041":[],"13220608e":5,"13220609e":5,"13245767":16,"13266452e":[],"13282515":[],"132825151794417":[],"133":6,"13328820e":[],"133524":[],"13352411e":[],"134102":[],"13410232":[],"13457922":[],"13493762":5,"13519106":1,"13535942":5,"135707":[],"13579199e":[],"135976":[],"1361111111111111":2,"13620973":14,"13646574":4,"136582":5,"13661243e":5,"136687":[],"13679863":5,"137268":[],"137400784702912":1,"13740265686642364":10,"1375":[],"137546":[],"1376":5,"137652":[1,10],"1379":[],"138":[],"13803928":[],"138472":[],"13859":[],"13865173":4,"138685":5,"138775":[1,10],"1388":[],"13891144e":[],"139255958275475e":5,"139255958572018e":5,"139462":[],"139475":[],"13964362":[],"139992":[],"14021063":5,"1404":1,"14109":[],"1416398":5,"14168589":[],"141725":[],"14174745":5,"141955":[],"14195542":[],"143":6,"14309733":[],"1437":2,"14370264":[],"1440501043841336":2,"1445":[],"14459063":[],"1446":[],"1447":[],"1448":[],"1449":[],"14496":5,"14558387":16,"146499":10,"14649905":10,"14662074":[],"14722222222222223":2,"147400":[1,10],"147420":[1,10],"147722":[],"148":[],"14812206":5,"148127":[],"148225":[],"148455":[],"148517":[],"148675":[],"149076":[],"1492":[],"149233":[],"149328":[],"149366":[],"149667":[],"149732":5,"149739":[],"149832":[],"149894":[],"149903":[],"149917":[],"14g":5,"150":7,"15005476":4,"15024669":[],"150306":[],"150581":[],"15061":[],"150795":[],"15098090e":5,"151":[],"151076":[],"15130074e":5,"15167261":[],"152636":[],"1527777777777778":2,"153036":1,"153106":1,"153129":5,"15324631":[],"15332528e":[],"153966":[],"154720":1,"15475232":[],"154911":1,"155491":1,"155687":1,"155883":1,"156":1,"156956":4,"157":1,"15751596":[],"158":1,"159":1,"15968414":[],"15979239e":[],"15g":5,"160":1,"16111111111111112":2,"16211139":4,"162246":4,"16342407":4,"16343471":5,"16361442":16,"16496581e":[],"16538057":16,"16553696":[],"16637855e":[],"16666666666666666":2,"167787":4,"16796929":[],"16805821e":5,"16807":16,"16831012":[],"16861772":[],"168618":[],"16894795":14,"1695":[],"16b8e3cda33a":2,"16it":[],"17106672":10,"171067":10,"17117385":[],"17174962e":2,"17221967":16,"17234827e":[],"17248441e":[],"172737":[],"17273709":[],"17385778e":[],"17393096e":[],"173931":[],"17432581":16,"174325810031482":16,"17446471":5,"174497":[],"17449733":[],"175300":1,"1758506":[],"1761":[],"17617003":16,"17641709":5,"17654307":[],"17666625":[],"177051":4,"17705119":4,"17707436":[],"17709":[],"17777777777777778":2,"17801022":4,"17861098":5,"17878199":[],"17917768":4,"17949575":4,"17953942":10,"1797":2,"17it":[],"180092462880674":[],"18027777":[],"18029127":4,"18063928":[],"18123182":[],"18194":5,"18220995":[],"18224665":[],"18303503":[],"1831277634928002":[],"18314376":16,"18332591":16,"18333333333333332":2,"18404906e":[],"184519":1,"185":[],"1856411":[],"186":[],"18611111111111112":2,"18613217e":5,"18620601e":[],"18673098":10,"18880881":[],"189496":1,"18954529":[],"189622":1,"18968431e":[],"1914224774238273":[],"19207979":4,"192470":10,"19247017":10,"193":[],"1931":5,"1940":1,"194042826640948e":5,"194042826840599e":5,"1943":11,"19569961":5,"19605877":[],"196368":10,"19636844":10,"197":[],"1970":14,"1973":8,"197370":[1,10],"19742904e":[],"19782691":16,"1979":5,"19839911":[],"1989":16,"19937":16,"19955871":[],"199559":[],"19972087e":[],"1_1":11,"1_2":11,"1_3":11,"1cm":[1,7,9,16],"1e10":0,"1e4":5,"1ec254875e1a":12,"200":[1,3,7,8,9,16],"2000":1,"200000":1,"20015436":5,"2004":12,"20053452":5,"2006":18,"2010":2,"2011":2,"2015":2,"2016":1,"2018":[1,5],"201841":[],"20184113":[],"2021":[0,5,15],"20277777777777778":2,"20285522":16,"20289459":16,"202973":[],"203":[],"203757":[],"20375701":[],"205466494327873":[],"20632410e":[],"20637689":16,"20738183":[],"207545":[1,10],"20772452":[],"20819609e":[],"20833333333333334":2,"20843563e":[],"20867052175003387":5,"20873331":16,"208733310166176":16,"20898927":16,"20906175e":[],"210340":[1,10],"21058097":4,"21126669":[],"21169159e":5,"212":[],"21208310e":[],"212327334149492":[],"21244261":[],"212443":[],"2125":[],"2126":[],"2127":[],"2128":[],"2129":[],"213":[],"213103":[1,10],"21347282":[],"21357193":[],"2137":5,"213743":[1,10],"214":[],"21413561":16,"2147483647":16,"214953":[],"21495309":[],"215":[],"21596432":5,"216":[],"21623344":[],"216290":[1,10],"216683":[1,10],"21698969":[],"21805483":4,"22044605e":4,"22076362":[],"221":7,"221180":1,"22140879":4,"221409":4,"221629":[],"221805":3,"221921":4,"22209371e":[],"222400":1,"22391797":16,"22422186":5,"22443803":[],"22527008e":[],"22534931":[],"2258524":16,"22690428":4,"22717936e":[],"22842468702166951":5,"22842468702166954":5,"22847924":4,"22862364":[],"22943192":4,"229432":4,"22999784":[],"229998":[],"22it":[],"23002365e":5,"23033954":[],"23117916e":[],"23167717":4,"232435":1,"23333333333333334":2,"2335879":[],"23382086e":[],"234":5,"23438810e":[],"23494196":[],"23521766":5,"23599801":16,"23662224":[],"236913":[],"23691315":[],"23744178":[],"238841":10,"240792":[],"2407922":[],"241106846210215":1,"24117177":4,"241172":4,"241262":[],"24126232":[],"24175744e":5,"24339370e":[],"243394":[],"2433e":4,"24340751":[],"243484":[],"24348403":[],"24444444444444444":2,"244798847617261":16,"24479885":16,"246":3,"246138":[],"24613822":[],"246379112732898":[],"248":[],"24829908":4,"24906604e":5,"24984554":16,"250":[3,6,8],"25000":1,"250000":1,"250154":1,"2509618":[],"251559":[],"2515593":[],"251708":10,"25170803":10,"251879":1,"25190225e":[],"25226753e":[],"25240108":[],"252436":1,"252639":[],"25263916":[],"253":[],"25303483":[],"253775":1,"254":[],"254509":[],"25450941":[],"25457052":[],"255":[],"255001":1,"2551":1,"256":3,"25617658e":5,"25617662e":5,"256962":1,"257":[],"2571699":[],"25726439e":[],"2572e3a4b38d":2,"2579":5,"25803281":[],"25845e8df859":5,"259107":[],"25910749":[],"259125":[],"25912505":[],"259153":[1,10],"25917728":[],"259815":[],"25981533":[],"25it":[],"260227742627244":[],"2627588":[],"26301436":4,"263384":[],"26338419":[],"26381865":[],"263819":[],"264":1,"2640931530791003":5,"26409315307910036":5,"26412372":[],"265":1,"2653678":[],"266":1,"26666667":12,"267":1,"26710969":4,"26780278":4,"2683":[],"2684":[],"2685":[],"2686":[],"2687":[],"26890510e":[],"269":1,"26974938e":[],"26it":[],"270":1,"27262964":[],"27296891e":[],"27416797":10,"274168":10,"27459502":16,"27591601":16,"276263":[1,10],"27753165e":[],"27852549":[],"27924636":4,"27n_":16,"280573":4,"280647":[1,10],"28166741":[],"282":[],"28244928":[],"282727":[1,10],"28310983":[],"283110":[],"28329188":[],"28336218e":5,"2836":16,"28475098":7,"2861":16,"28712116":[],"2873":8,"2882":16,"2886":16,"2890":1,"2892":16,"28971976":[],"289720":[],"290":[],"291":[],"2915":16,"291614":[],"29167186":4,"292":[],"293":[],"2931":[],"294":[],"29424824":[],"295656121491569":[],"296247":1,"2968":[],"297219777724628":[],"297260":1,"29737229":[],"29748212":[],"2975":[],"2980":[],"29822833":5,"298273":1,"2983233":[],"298375":1,"2988":[],"2990":[],"299444":[],"29944428":[],"299748":1,"2_1":11,"2_2":11,"2_3":11,"2_i":11,"2_m":[5,16],"2_t":12,"2_x":16,"2cm":7,"2ff97f4bf03b":16,"2g_i":3,"2nd":8,"2x_ix_jy_iy_j":7,"2x_j":7,"2y_i":9,"2y_j":7,"30000":1,"300162456113691":[],"30119421":7,"301997":4,"30199745":4,"303":5,"3041320306136366":[],"3043053":[],"30466214e":5,"30509508":[],"30626706":[],"30655001":[],"306854":[],"30685416":[],"307514":[],"3078370846883027":[],"30787294":5,"30859612":[],"30862336":12,"30875823":[],"30879705":[],"308955":10,"30895532":10,"309519578637819":[],"30968181":[],"310811":[],"31081134":[],"31082669e":[],"31109204e":[],"311100":[],"31213725":16,"3123314713548606":5,"31276579e":5,"31318084":4,"31446832e":[],"31457796":4,"315":5,"315208":[],"31520842":[],"3155":[4,5],"3156929654100207":[],"31603087":[],"31608475e":[],"31718909":10,"31730641":[],"317367":10,"31853484":[],"31896852":7,"319668":[],"3196681":[],"31it":5,"3200":2,"3204":5,"32047562":1,"3214960170351912":5,"32149601703519126":5,"323291478597321":[],"324":3,"32468833":[],"3250":2,"32521615e":[],"32586565":[],"326238":1,"327631":1,"32938847":[],"32945844e":[],"32978852":[],"3304":1,"33066907e":4,"3310":1,"3317":1,"331939":1,"333":6,"333333":1,"33333333":12,"3338":1,"3344":1,"33443859e":[],"33544681":[],"33569998e":[],"33737942":[],"33861512":[],"33881021":14,"338869":[],"33886902":[],"339535706819584":[],"33953571":[],"33it":[],"340782":[1,10],"34108726":[],"34114547":4,"34114641e":[],"34172919":[],"342680":1,"3436":1,"3437":1,"344172":1,"34569596":4,"346433":[],"34643337":[],"34673123":14,"34902789e":[],"3490697":[],"3498837":[],"350387":[],"35038714":[],"35041853":[],"351636":[1,10],"35176067":[],"35182854":4,"35216172e":[],"35304998":10,"353050":10,"35367281e":[],"35386868":[],"35533773":[],"35533774":5,"356399":1,"357508":1,"358869339268145":[],"35886934":[],"359":4,"359640894899012":[],"35it":[],"360":2,"36059285":[],"360688":1,"361556":1,"3621311":4,"363295916523824e":5,"3632959273186007e":5,"36436520e":[],"36468301":[],"3655222":4,"367":3,"36796587":10,"367966":10,"369139":[1,10],"36941772":[],"369418":[],"36it":5,"37186301":[],"372889":[],"3728892":[],"37396662":5,"37416969":[],"374170":[],"37538418":16,"37732":12,"37738324":[],"37831577":[],"37900111":5,"38135733e":5,"38207279e":[],"38216436":[],"3848":[],"38561052":[],"385611":[],"38629436":14,"38690487":4,"386905":4,"38777878e":4,"38783434e":[],"38845304":[],"38892672":[],"388927":[],"38903780":[],"38916861e":5,"3893239":[],"389324":[],"38937995e":[],"38962192e":5,"38986237":[],"38it":[],"39046173":[],"39445208":[],"39579407":4,"396740":[],"39674043":[],"39706038":4,"39716546":[],"397700":[1,10],"39792608e":[],"3984":5,"399836":1,"39it":[],"3cd19a0768e1":[],"3x_i":3,"4000":18,"400523":[],"40052348":[],"401842":[1,10],"40212127":[],"40259257e":[],"40379027":10,"404":1,"40425078e":[],"40530431":5,"405890":[1,10],"40702":[],"40708470e":[],"40859":[],"4087793":4,"40902095":[],"40927184e":5,"40968888":[],"409689":[],"40977892":[],"409779":[],"40a38ad763f1":5,"40it":[],"41078073":[],"412374":[],"41237437":[],"4140e":4,"41433969":4,"41511965e":2,"4155":3,"415634483874318":[],"416694683938511":[],"4171578884124756":[],"41754964":[],"41770932":[],"418506":[1,10],"41876428e":[],"41879302":[],"41882037e":5,"4200e":4,"4201e":4,"4203e":4,"42208194":[],"423756":[],"42375621":[],"42441033":4,"426":[5,6],"42847770e":[],"42905116081237793":[],"42937310e":[],"4295021":[],"43054282":4,"431083":[],"431289":[],"43128913":[],"43222125":[],"432811975479126":0,"4332e":4,"43330971e":5,"43341615":[],"435163":1,"435490":[],"43549028":[],"43579948e":5,"43766686":10,"438136":1,"439230":5,"44089210e":4,"441097":[],"44109702e":[],"442600":[1,10],"4427165765504326":[],"44271658":[],"443217":1,"44395541":[],"44485473":16,"44625466e":[],"44655382":[],"446554":[],"44862840e":[],"44970586e":2,"45013332e":[],"45019484":[],"450257":[1,10],"45428062":[],"454281":[],"4557763":10,"455947":1,"457":3,"457451":10,"45745139":10,"458027":1,"458078":[1,10],"45937170e":[],"459553321949357":[],"45960079":4,"46016532e":[],"461":16,"461413":4,"46141305":4,"461838":[],"46183815":[],"462":6,"46323168e":[],"4632e":4,"46383924e":5,"46383925e":5,"46415888336127775":[],"46423858e":[],"465564":[],"46556436":[],"46581332":[],"466":16,"46675058":[],"4676097":16,"46807752":[],"468078":[],"468405":4,"46840512":4,"46914544e":[],"46929603e":[],"469730":[],"46973015":[],"46984697e":5,"46it":[],"47042744":4,"470714":1,"47075725":5,"47079457e":[],"47116868e":5,"47125748":4,"47132891":4,"472652":[],"47265243":[],"47441766":[],"47566390e":[],"47610036":5,"47654764e":[],"47815203":10,"47862383":[],"478624":[],"480170":[],"48017006":[],"48019541":[],"480970":[],"48097003":[],"48154187202453613":[],"481979":5,"48257387":17,"4831998348236084":[],"48471852e":[],"48476997":10,"48552604":[],"48608063e":[],"4887218475341797":0,"4890704720929593":16,"48994188":4,"49110643":[],"491837":[],"4918372":[],"493230":[],"49323032":[],"4940954":1,"4959161509366834e":5,"4959161509370406e":5,"497221":[],"49722108":[],"497355838775297":16,"49735584":16,"49751204":16,"49841285":[],"498413":[],"49865673":[],"4990":16,"4992":16,"4997":16,"49b0ef2e51e2":[],"4c4c7f":[8,9],"4y_i":9,"500":[2,5,8,9,12,16],"500000":1,"50000455":4,"50000553":4,"50000718":4,"50000855":4,"50000969":4,"50001063":4,"50001142":4,"50001207":4,"50001261":4,"50001306":4,"50001343":4,"50001374":4,"500014":4,"50001414":4,"50001422":4,"50001439":4,"50001454":4,"50001466":4,"50001476":4,"50001485":4,"50001492":4,"50001498":4,"50001502":4,"50001506":4,"5000151":4,"50001512":4,"50001515":4,"50001517":4,"50001518":4,"50001519":4,"50001521":4,"50001522":4,"50001523":4,"50001524":4,"50001525":4,"5018":16,"50227564e":5,"50321091":4,"50394742":[],"506":1,"506794":[],"507d50":[8,9],"50846112e":5,"5098779":[],"509878":[],"50j":12,"50x10":2,"510":2,"511888":4,"5120":0,"512132":1,"51257863e":[],"51345668e":[],"51363731e":[],"51385904":[],"514219":1,"51478402":16,"51523276e":[],"515768":[],"51576807":[],"51707172":[],"517072":[],"51893804e":[],"51943726":[],"519842":1,"51it":[],"52158335":[],"5222222222222223":2,"524497":4,"52449732":4,"525617578564635":[],"52561758":[],"52570079":[],"525701":[],"52640043":10,"526744":[1,10],"52687171":[],"526872":[],"52722156":[],"52805315":[],"52874252":4,"529":5,"529403":4,"52940309":4,"52d2c51caad1":[],"5303329":10,"5305555555555556":2,"531280":1,"53193095":[],"535457":[],"53545715":[],"53703498":5,"5378811":10,"539261":[1,10],"54039921":4,"54096582":[],"540966":[],"54121682":[],"541217":[],"54152940e":[],"541605":1,"54237024":[],"54280848":16,"543169":[],"54316925":[],"544439":1,"546972":[],"54697204":[],"54702088e":[],"54710530e":[],"5483":[],"55111512e":4,"55138385":[],"551384":[],"55280484":[],"5535":5,"5555555555555556":2,"55707065":[],"557071":[],"557795":[1,10],"55795935":[],"55854694":10,"55899331":16,"55it":[],"56033697":4,"56141023":[],"56198284":4,"56202678":[],"56216797e":[],"56420221":16,"564374":[1,10],"56536":1,"56636616e":5,"56831157":[],"568312":[],"569":2,"56912044e":5,"56939714":4,"57051369":[],"571":4,"571105947979326e":5,"57110594797945e":5,"57143061":[],"57201944e":5,"57395619":[],"574465":[1,10],"5755035":[],"575591916051299":8,"57781668":[],"57861771":16,"57871326":[],"579842":[],"57984245":[],"58157742":16,"581766":[],"58176612":[],"582":[1,2],"58228342e":[],"58239999":[],"582400":[],"583595":1,"583825":[],"58382502":[],"584099":[],"584804":1,"58521266":[],"585213":[],"58596975":[],"585970":[],"58645106":10,"5864689451163851":[],"58694429":16,"587401":1,"58836420e":[],"5888888888888889":2,"59007674e":[],"59142511":[],"59304755e":[],"5944444444444444":2,"59480085":[],"59it":[],"5cm":16,"5dd54edf2138":5,"60020187":16,"60122668e":[],"60239515":16,"60293962":4,"60394236e":[],"60420593":4,"60673226":10,"606760":4,"60949193":[],"609492":[],"60990408":16,"60999846":[],"60it":5,"61069091e":[],"61081005":5,"6111111111111112":2,"61124978":[],"61234223":[],"612939":1,"613579":1,"61459179":[],"614808":[1,10],"61505887e":[],"61745046e":[],"618":1,"61825186":[],"6183694":[],"61869821":[],"618982":1,"61it":[],"622539":[],"62253933":[],"622625":[],"62262506":[],"6226921":[],"62316154e":[],"62359224e":[],"62370636":14,"62373464":10,"625":6,"62783293":[],"62856593":[],"62869983":16,"62894215":4,"629961":1,"6300745149331701":1,"63025821e":5,"631657":10,"63165748":10,"6319972672199556":4,"63249532e":5,"63315151":[],"63339159":[],"63374631":[],"63437572":[],"63442451e":[],"63488525":[],"63498144":4,"63628911":[],"636323":[],"63632311":[],"63680118":[],"637129335071195":1,"638783":[],"63993205e":[],"64001211":[],"64012627":4,"640782":[],"64078247":[],"64166831e":[],"6417002":4,"64447921":[],"645":[],"64522721":[],"64580686":[],"64606848":[],"646283":[1,10],"64669382":[],"646694":[],"64742912e":5,"647473":[1,10],"647867896223553":10,"64857826e":[],"649382":[1,10],"6497097":[],"649710":[],"64it":5,"64x50":2,"650024":[],"65002433":[],"65062105":4,"6510573774179256":[],"65105738":[],"65238878":[],"65245958":[],"65276752":10,"653095390463358":[],"653702":[],"653725417896576":[],"6544e":4,"65482578":[],"655":[],"65554654":[],"6555465443226955":[],"65572035":[],"65599927":[],"65735283":4,"657353":4,"65766387":[],"65885453":4,"65933852":[],"65939208e":[],"6600855222624895":[],"66020213e":[],"66071628":16,"6614":[],"66152576":[],"661526":[],"66183486":[],"661835":[],"66204648":5,"6628996975186952":1,"66302359":[],"66383151":[],"665113":4,"66511337":4,"66677842":[],"66800261":[],"668172":1,"66880047":[],"669998":4,"66999836":4,"67006792":[],"67047975e":5,"67060602":[],"671089":1,"6713619":[],"6714":[],"67171347e":[],"672721":1,"67279536":[],"67298546":[],"67303655":[],"673037":[],"67407338e":[],"67450955":[],"67708423":[],"677149":[],"67714918":[],"67950066":4,"67951873":10,"679519":10,"6796265324852733":[],"67it":[],"68002363":[],"680024":[],"68034946e":[],"6804336":[],"6813":[],"6814":[],"6815":[],"6816":[],"6817":[],"6818813252071303":[],"68188133":[],"68192193":4,"682880":[],"68288031":[],"68316185":[],"68342382":[],"68386076":[],"68506886e":[],"685069":[],"68534263e":5,"68542204":4,"68616263":[],"68729414":[],"68887763":[],"68904673":[],"68929213e":5,"68937695":[],"689519":[1,10],"68it":[],"690617":1,"69069n_":16,"692355":10,"69235507":10,"693361":1,"69347005":[],"6936767":[],"693677":[],"693850":[],"69385025":[],"69504801":5,"69519693":[],"695197":[],"69573183":[],"69634577e":5,"69695259":4,"69843037":[],"6996584":[],"69981195e":[],"6999536":10,"6e75736fdab1":5,"6ea927cc6e88":2,"6f7a6bd7d79f":5,"6n_":16,"701370":4,"70183798":[],"7022283":[],"70234019":[],"70327816":[],"70415861":[],"70523024e":[],"70589906":[],"7070e":4,"70710678":4,"70790937":[],"70832814":4,"70885528e":[],"70886748":[],"70900891":[],"70924636":[],"70946493e":[],"70992192":5,"712018":[1,10],"712199063818309":[],"71230687":4,"712307":4,"71281409":[],"71351486":[],"71442781":[],"71546272e":[],"715463":[],"71606852":[],"7162":[],"71669651":[],"7172":[],"718165":4,"72108703":[],"72164987":4,"721650":4,"72174172":10,"72218808":[],"72271878e":5,"72312577":[],"7236674":4,"7240496":[],"725394195434945":[],"72780613e":[],"72859758":4,"72879865e":[],"72981762":7,"72it":[],"73091052e":[],"731000":1,"73153522":[],"733096":1,"73453972":[],"7371165871823337":[],"73718563":[],"737349":[],"73734906":[],"73774883":16,"73921714":[],"73it":[],"74081822":7,"74107697":[],"74143127e":[],"7432283":[],"74382593":[],"7442":[],"744674093727182":[],"74495014":[],"745136489050356":[],"7465":[],"74840212":4,"74845978":[],"74921867":[],"749765":1,"7503":5,"750445":1,"751":5,"751699":[1,10],"75170092":4,"75195757":[],"7522047280566193":[],"75240368":[],"75322913":[],"75382481":[],"75524378":[],"75582035":[],"75629493":[],"756352":1,"75841112":[],"75932862":[],"75it":[],"76172241e":[],"762":[6,10],"7621419":[],"76290332":[],"76326745":1,"763277270613554":10,"76376813":16,"763880":[],"76388013":[],"76497666":[],"765":6,"76504618":[],"76570177":[],"76648901e":[],"7689233":[],"76936315":4,"7693978131030923":[],"7701384":[],"77152076":4,"77156117e":4,"7718":8,"77253612":16,"772b904ae9cb":[],"77317984":[],"7733":[],"77350269e":[],"774300":1,"776223":[],"77622336":[],"77636e":12,"77661393e":[],"77714169":7,"7779152676639822":[],"78080633":[],"78082":[],"78184120e":5,"78195":[],"7821634":[],"78788857":16,"78848481":4,"788485":4,"78857629":[],"78941903":4,"78944806":[],"78979284":16,"7899453":[],"79084976":10,"790850":10,"79111643":4,"7925146":[],"792515":[],"79295029e":[],"793167":1,"79326583e":[],"79328828":[],"793701":1,"794282":[1,10],"79459035":[],"79648291":[],"796796":5,"79902342":[],"7c394b1e8b71":8,"7d7d58":[8,9],"800":6,"80004454e":[],"80021057":[],"800266":[],"80026635":[],"80121":[],"80354994":5,"80381774":[],"80408254":14,"80463702":[],"80469739":4,"8055555555555556":2,"80609614e":5,"80609615e":5,"80847477e":5,"80999435":[],"81048318e":5,"81160425":4,"81209057":[],"81333793":[],"81333802":5,"81441779":[],"81620806":[],"81633628":10,"816454":1,"81645929":[],"816847":1,"81712976":[],"817130":[],"81774574":4,"817746":4,"81781888":[],"819202":[],"81920231":[],"82198978":4,"82493809":5,"82544198":16,"8265786":4,"827265":1,"82889306e":[],"82it":[],"8305555555555556":2,"83074569":[],"83304817":[],"83425361":[],"834254":[],"83512277":4,"83614019":[],"8388888888888889":2,"839313":[],"8393131":[],"83935285":[],"83it":[],"84008474":[],"840085":[],"8405484":[],"84087101":[],"84099240e":[],"842":[],"842436":1,"84251485":[],"842515":[],"8429949116841184":[],"84355903e":2,"84372853":[],"844139253527833":[],"84420428":[],"84443254e":2,"844863":[],"8464107":14,"84658093e":[],"84678774":[],"847187":[],"84780262":5,"8479552268981934":[],"84860939":[],"84923989e":5,"849766":[],"84976606":[],"84994524":4,"850164":4,"85023678":10,"85058354":[],"850584":[],"8520127":[],"85218118":[],"852584":10,"85258411":10,"85263220":5,"85278450e":[],"8538670539855957":[],"853884005749657":16,"85388401":16,"85396354":[],"85450859":[],"85463934e":[],"85497163e":[],"85546305e":[],"85601992":4,"85655181":10,"856552":10,"860114":[],"86011441":[],"861":1,"86110774":12,"86117291":4,"86134827":4,"86145244":10,"861455":[],"86145508e":[],"8638888888888889":2,"86421839":1,"86436607":[],"8653810024261475":0,"86574276":[],"8666666666666667":2,"86692943":[],"868215":10,"869616":[],"86961626":[],"87030083":[],"870301":[],"8718475896381779":[],"87184759":[],"87218485":12,"8722222222222222":2,"873":5,"87353683":16,"87381451":4,"875":2,"8759":12,"87739949":[],"87761937":[],"8777777777777778":2,"878843":[],"8788431":[],"87972591":[],"87it":5,"8802":[],"88046261":4,"88046462":[],"8805555555555555":2,"8811":5,"881323":[],"88168312e":5,"88168518":[],"88297395":[],"88336879":4,"88497839":[],"884978392264447":[],"88529063e":5,"88559559":[],"8867467323038865":[],"88693966e":[],"88712946":[],"88730288":[],"88732076":10,"8876822883855056":[],"88768229":[],"88824397":5,"8888888888888888":2,"88it":5,"890":[],"8901":[],"8911":5,"8914984":[],"89156955":[],"8921171964770647":[],"8923":[],"89288636":10,"8931":[],"89383322":[],"8941":[],"89410423":4,"8944444444444445":2,"8954":[],"89704131":[],"89742056":[],"897421":[],"898500":[],"89850037":[],"89928965":[],"89942598":[],"899606":10,"89975818":[],"89992521":[],"8dc29df57a8c":[],"8x8":2,"900266":10,"90026646":10,"90075537":4,"9011":5,"90220243":4,"90233874":[],"90266948":4,"9026821944532157":4,"9030809":12,"9031":[],"90316476":[],"9040":8,"9042":[],"90475506e":5,"9054":[],"9055555555555556":2,"90618734e":[],"906747":4,"907307":[],"90730735":[],"9082084":[],"90825063":[],"9096":[],"91007256":[],"91012519e":[],"9111111111111111":2,"91128596":4,"91145266e":[],"91208933":[],"91417278":[],"9142":[],"91492986e":5,"9154537458386387":[],"91549644":1,"9166666666666666":2,"916978":[],"91697817":[],"9171356":[],"91760278":4,"91812296":12,"91812702":4,"918992":1,"9196":[],"91960881":[],"91it":5,"92115534":[],"9222222222222223":2,"922312":[],"92231203":[],"92280994":[],"924018":1,"924197515789051":5,"925":2,"92507116e":2,"92527504":[],"92555588":[],"92578916":4,"92605247":[],"92645039":[],"92646965":[],"926470":[],"92661816":[],"92732185e":[],"9277777777777778":2,"9279671770201344":[],"92814088":[],"928141":[],"92857143":6,"92919670e":[],"9305555555555556":2,"931":1,"93100040e":[],"931066":[],"93155188":4,"93158979":4,"932734":[],"93273404":[],"933":4,"93351637":[],"9341":[],"9348":[],"93492130e":5,"9354":[],"9361111111111111":2,"93679587":[],"936796":[],"937":16,"937082":1,"93799826":4,"938":16,"93854356":12,"9388888888888889":2,"939":[1,16],"94019247e":[],"94034531":[],"94047694":16,"9421795":10,"942180":10,"94226022e":5,"94226154":12,"94240779":[],"942726":[],"94284104":4,"94320205":4,"94327895":[],"9444444444444444":2,"94536341":[],"94591015":14,"94639099":10,"946893955211749":[],"946957":4,"947543":[],"9482527":4,"948729":[],"94916469":4,"949165":4,"9493620821393187":[],"94936405":5,"94it":[],"95008046":5,"95014575":[],"95231424":4,"9524796542295857":[],"9527777777777777":2,"95284275":4,"95338481":12,"95351665":4,"954":16,"95443703e":[],"95463048":5,"9547578478889096":1,"95517094":[],"955171":[],"955396":4,"95539603":4,"9555555555555556":2,"95611545":12,"95628168":[],"956282":[],"956563":[1,10],"95684892":4,"958228616652075":4,"9583333333333334":2,"958527":[],"959043":[],"959247":[],"95it":[],"960":16,"9601304850085328e":5,"9601304850163794e":5,"96024953":4,"96084663":4,"960919045835183":[],"961":16,"96104648":[],"9611111111111111":2,"962":16,"96285336":[],"963499":[],"96349948":[],"9637117593816477":5,"9640435":4,"965548":1,"96572363":10,"965724":10,"965885569080809":[],"96688672":4,"9674916":4,"967581388294481":16,"967809":[1,10],"96793117e":[],"97005689":4,"97101567e":[],"97108e":12,"97188519":[],"97211078":5,"9722222222222222":2,"97243128":4,"97290346":12,"97300836":4,"97497404e":5,"975":2,"97507735":4,"975127":4,"9756404":[],"976":7,"97622676":[],"976227":[],"9765":[],"9769":[],"97705827":4,"97723801":[],"97749299":16,"97758848":4,"9777777777777777":2,"9780387310732":18,"9780387848570":18,"9781492032632":18,"978553":4,"97898392":5,"97900797":[],"97921062":[],"97926491":4,"9804422":[],"98046438":[],"9805555555555555":2,"98091621":4,"981321":1,"98139097":4,"98202489":[],"982025":[],"98226332":[],"98275501":4,"98314755":[],"983148":[],"983310":1,"98413059":4,"98452685":[],"98454786":4,"985":16,"98526763":[],"98528992":[],"98531221":[],"98566191":4,"986":16,"9860803":[],"98609175":[],"986091753050161":[],"9861111111111112":2,"98661465":[],"986699":4,"98680716":4,"98716878":4,"9877742":[],"987902":[],"98808176":4,"98822371":5,"988663":[],"9888888888888889":2,"98892195e":[],"98893512":[],"989":16,"9890348":4,"98927731":[],"9893447":4,"9898ff":[8,9],"99009525":4,"99009739":[],"9901168":[],"99013921":[],"99016161":[],"99018401":[],"99043999":[],"99088801":4,"9909252":[],"991":16,"991072":[],"99107239":[],"99115119":4,"99126104":[],"99133007":[],"99160404":[],"99176998":4,"99190487":[],"99194716":[],"992":16,"99218987":[],"99219378":[],"9922167804917393":[],"99242605":[],"99242921":4,"99248001":[],"99265097":4,"99273355":[],"99276945":[],"993":16,"99305549":[],"99305802":[],"99311297":[],"99316252":4,"9933":[],"99346398":[],"99363129":[],"99363383":[],"99371056":4,"99384182":16,"99389612":4,"99393624":[],"99394477":[],"994":[],"99400444":[],"994015":[],"9940257354319456":1,"9941":[],"99418903":[],"99420743":[],"99420997":[],"99428016":[],"9943201":4,"9945452":[],"99462421":[],"99473581":[],"9947756":4,"99478645":[],"994788006691541":1,"99478898":[],"99492986":4,"99498985":[],"995":[],"99501236":[],"99503487":[],"99505739":[],"9950799":[],"9951332163662493":[],"99517651":12,"99527696":[],"99528218":4,"9953048353087299":[],"99536326":[],"9953658":[],"99539415":4,"99544872":[],"99545147":12,"9954538761021741":[],"99566069":4,"995774":[],"9957744":[],"99578809":4,"99579317":[],"99581841":[],"99594294":[],"996":4,"99600927":[],"99608161":4,"99620088364924":[],"99636015":[],"9963961":4,"99650061":4,"99652042":[],"99652296":[],"99655111":[],"9966744029509663":[],"9967292151090247":[],"9967458":4,"9968966158779216":[],"9969":[],"99696351":[],"997":[],"99700706":4,"99703985e":[],"99709215":4,"99709325":[],"99710078":[],"99723611":[],"99728435":[],"99729756":4,"99730848":[],"99751458":4,"99758326":4,"99763569":[],"99767893":[],"99775587":4,"99782689":[],"99793613":4,"99799099":4,"998":[],"99813653":4,"99817842":[],"99821162":16,"99825997":[],"99828624":4,"9983295":4,"99836973":[],"99845267":4,"9984806":[],"998577":4,"99861053":4,"99871521":4,"99881845":4,"99883879":[],"99884384":4,"99891285":[],"99893323":4,"999":[8,16],"99901896":4,"99903755":4,"99911427":4,"99918546":4,"99919837":4,"99926459":4,"9993237":4,"99933188":4,"99938942":4,"9994385":4,"99944272":4,"99945628":[],"99949306":4,"99953381":4,"99953475":4,"99957911":4,"99961294":4,"99965056":4,"99967865":4,"999704":[],"99970988":4,"9997332":4,"99975913":4,"99977849":4,"99980002":4,"9998161":4,"99984732":4,"99987324":4,"99988687":[],"99989476":4,"9999095":[],"99991263":4,"99992746":4,"9999292683946882":1,"99993212":[],"99993978":4,"99995":4,"99995475":[],"999955585168597":5,"99995818594196":[],"99995891":14,"999960835374545":[],"999974281880048":[],"99997737":[],"9999787681537219":[],"9999794306626945":[],"9999822527140678":[],"9999850282256434":[],"9999864543345858":[],"9999868619217517":[],"9999869956119286":[],"9999871853340275":[],"9999878260589065":[],"9999887274726137":[],"9999910208315801":[],"9999940124132914":1,"99it":[],"9b9cf4fa1a95":[],"\u00f8yvind":[5,17],"abstract":2,"break":[0,1,5,10],"byte":14,"case":[1,2,3,4,5,6,10,11,12,13,14,15],"catch":1,"char":16,"class":[1,2,5,6,7,8,10,11,12,16],"const":16,"default":[1,2,3,5,6,14],"ekstr\u00f8m":17,"export":8,"f\u00f8470":17,"final":[0,1,2,3,4,5,6,7,8,9,10,12,15,16,17],"float":[0,1,4,8,10,12,14,16],"function":[0,3,4,8,13,14],"import":[0,1,2,3,5,6,7,8,9,10,11,12],"int":[0,1,2,3,4,5,10,12,14,16],"long":[1,2,11,12,16],"m\u00f8svatn":5,"new":[0,1,2,3,4,5,6,7,8,9,10,12,14,16],"null":16,"public":[1,13],"return":[0,1,2,3,4,5,6,7,8,10,12,14,16],"s\u00f8rli":17,"sch\u00f8yen":[5,17],"short":[0,4],"steinsv\u00e5g":17,"super":4,"switch":[0,1],"throw":[5,16],"true":[0,1,2,3,4,5,6,7,8,9,11,12,14,16],"try":[0,1,2,3,4,5,6,7,8,9,10,12,13,14,16],"var":[4,5,9,10,16],"while":[0,1,2,4,5,6,7,8,10,11,12,16],AGE:1,AND:3,Adding:2,Age:6,And:[0,1,4,5,8,12,13,16],Are:10,Being:12,But:[0,1,2,3,4,5,8,9,16],CAS:[],DIS:1,Doing:[4,5,9,12],EoS:[1,5],FYS:15,For:[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,18],Going:2,Ising:[4,11],Its:[2,3,10],MDS:10,NNs:11,N_s:7,Not:[1,2,4,5,15],ODEs:3,OLS:1,One:[1,2,4,5,6,7,10,11,12,16],PCs:[10,13],RMS:16,Such:[5,11,16],That:[0,1,4,6,9,10,11,16],The:[9,12,14,15,17,18],Then:[0,1,2,4,5,7,8,9,10,11,12,14,16],There:[0,1,4,5,7,8,10,11,14,15,16,17],These:[0,1,4,7,8,9,10,11,12,14,16],Use:[1,3,5,8],Useful:[4,5,14],Using:[1,4,5,7,9,11,14],With:[1,4,5,7,8,9,10,11,14,16],__class__:9,__doc__:5,__future__:[7,8],__getattr__:[],__init__:2,__main__:3,__mosek:4,__name__:[3,9],_asarrai:3,_auto10:[5,11],_auto12:5,_auto1:[3,4,5,6,11,12,14,16],_auto2:[3,4,5,11,12,14,16],_auto3:[4,5,11,12,14],_auto4:[5,11,12,14],_auto5:[5,11,12,14],_auto6:[5,11,14],_auto7:[5,11,14],_auto8:[5,11],_auto9:[5,11],_ax:[],_base:7,_build:[13,18],_check_optimize_result:[6,10],_compon:10,_coordinate_desc:5,_datafram:[],_depth:8,_fraction:8,_lambda:5,_leaf:8,_logist:[6,10],_make_index:[],_make_vjp:12,_multilayer_perceptron:[1,2],_node:[8,12],_num_sampl:[],_ratio:10,_sampl:8,_split:[5,8],_test:5,_trace:12,_valu:12,_varianc:10,_weight:8,a0faa0:[8,9],a77d5ac269b2:[],a_0:1,a_1a:1,a_2a:1,a_3:1,a_3a:1,a_4:1,a_4a:1,a_h:2,a_i:[1,2,3,11],a_j:[2,11],a_k:[2,11],aaron:18,ab_channel:13,abandon:2,abbrevi:15,abid:16,abil:[1,9],abl:[2,4,5,6,9,11,12,16],abort:16,about:[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,18],abov:[0,1,2,4,5,6,7,8,9,10,11,12,14,16],abovement:5,abs:[0,1,3,4,12],abscissa:12,absolut:[1,3,4,5,12],acccess:[],acceler:12,accept:[1,5,8],access:[1,10,16],accid:5,accmod:4,accompani:1,accomplish:[7,8,12],accord:[0,1,2,3,4,5,8,11,12,16],accordingli:10,account:[1,4,12,16],accumul:[11,16],accur:[1,5,9,12,16],accuraci:[1,2,4,5,6,8,9,10,11],accuracy_scor:[1,2,9],accuracy_score_numpi:2,achiev:[1,2,4,5,7,11,14],aco:16,acquaint:13,acquir:[2,13],acr:1,across:[2,5,8,13],act:[2,14],action:16,activ:[0,1,3,8,15],actual:[1,2,4,5,7,10,14],ada_clf:9,adaboostclassifi:9,adadelta:12,adagrad:12,adam:2,adapt:[1,5,12,18],add:[1,2,3,4,5,7,9,10,11,16],add_subplot:[0,2,6,11],added:[1,2,4,5,7,12,14],addendum:4,adding:[0,2,14],addit:[0,1,3,4,5,6,7,8,9,11,12,13,14,16,17,18],addition:[11,12],address:[2,8,10,12,18],adjac:11,adjoint:4,adjust:[1,4,11,12],admir:1,advanc:[5,11,18],advantag:[2,4,5,9,12,14],afecionado:[],affect:[],affin:[1,7,10],aficionado:[],aforement:0,african:1,after:[0,1,2,3,4,5,8,10,11,12,13,14,16],afterward:1,ag_0:3,again:[0,1,2,4,5,6,7,9,10,11,12,16],against:[2,6,9],age:[1,6],agegroup:6,agegroupmean:6,aggreg:[8,9],agorithm:9,agre:[4,5,16],ahead:8,aid:10,aim:[0,1,2,5,6,10,13,14],ainv:4,aka:4,alarm:4,albeit:0,algebra:[1,4,12,13,15],algo:16,algorithm:[1,2,3,4,5,6,7,12,13,14,15,16,18],align:[1,3,4,5,6,7,12,16],all:[0,1,2,3,4,5,6,8,9,10,11,12,13,14,15,16,17,18],allevi:[2,12],alloc:14,allow:[1,2,3,4,5,7,9,12,13,14],almost:[1,2,5,7,10,12,16],alon:[3,8],along:[0,3,4,5,8,9,10,13,14],alpha:[0,1,2,3,4,5,6,7,8,9,12,16],alpha_:9,alpha_i:12,alpha_k:12,alpha_m:9,alpha_opt:12,alreadi:[3,4,5,9,11,13,14,16],also:[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,18],alter:[2,16],altern:[1,2,4,5,6,7,8,10,12,14],although:[2,4,5,7,9,12],alwai:[0,1,4,5,11,12,16],ame2016:1,american:1,among:[1,4,8,9,11],amongst:4,amount:[0,1,2,5,7,9,13],an_:16,anaconda3:[1,2,3,5,6,7,10,12],anaconda:[1,2,13],analog:12,analys:[5,16],analysi:[2,6,14,15,18],analyt:[1,3,4,5,6,11,12,13],analyz:[1,2,4,5,16],andrew:2,angl:[1,8,16],ani:[0,1,2,3,4,5,6,7,8,9,11,16],anim:11,ann:11,annot:[1,2,6,7],anoth:[1,2,4,5,6,7,9,10,11,12,14,16],ans:[12,16],ansatz:1,answer:[1,2,4,5,14],antialias:[3,5],anymor:[2,7],anyon:7,anyth:[2,16],anytim:17,apach:2,apart:[10,12],api:[2,13],appar:3,appear:[1,2,12,14,16],append:[2,7,8,12,16],appendcon:4,appendvar:4,appli:[1,2,5,6,7,8,9,10,11,12,16,18],applic:[1,2,4,5,6,8,11,12,15,16,18],approach:[2,3,4,5,8,9,10,11,12,13,16,18],appropri:[3,5,8,11,12,13,16],approx:[1,3,5,9,10,12,16],approxim:[1,2,3,4,5,6,9,10,12,16],apt:[1,13],aptli:0,aragorn:[],arang:[2,5,6,8,9,11],arbitrari:[2,5,7,11,12,16],arbitrarili:[1,2,10],arc:5,architectur:[11,18],area:[1,5,18],arg:12,argc:16,argmax:[2,10],argmin:[0,9],argnum:12,argsort:10,argu:[2,12],arguabl:0,argument:[1,3,4,10,11,12,16],argv:16,aris:[1,5,11,12,16],arithmet:[1,12,14],arm:5,arma:16,armadillo:[14,16],around:[1,2,4,5,10,16],arrai:[0,1,2,3,4,5,6,7,8,10,11,12,13,16],arraybox:12,arriv:[1,5,8,10,14,16],arrow:11,arrowprop:7,art3d:12,art:[1,2,13],articl:[0,1,5,9,16],artifici:[1,3,6,11,18],artificialneuron:11,artist:[],arug:12,asarrai:[1,5,8],asc:4,ascii:16,ask:[4,5,10,11],aspect:[1,5,13],assembl:1,assess:[1,5],assign:[0,1,6,7,8,11,12,15,18],assign_points_to_clust:0,associ:[0,1,5,8,11,16],assum:[0,1,2,3,4,5,6,7,8,9,10,11,12,14,16],assumpt:[1,4,5,8,10,16],ast:[1,4,5],astyp:[8,9],asymmetri:1,asymptot:5,atoi:16,atom:1,attempt:[1,5,6,7,9],attend:15,attent:[1,14],attr:[],attract:[1,9],attribut:[1,8,12],attributeerror:12,audi:1,aurelien:[1,15,18],austfjel:5,author:[1,2,9,16],authour:1,auto:[8,9,16],autocor:16,autocorrelation_tim:16,autocorrelform:16,autocovari:16,autoencod:13,autoencond:13,autograd:[12,13],autom:[1,13],automac:14,automag:[],automat:[1,2,3,10,13,14,15],autonom:18,avail:[1,2,5,9,10,13,14,15,18],averag:[0,1,2,5,8,9,12,16,17],avg:16,avoid:[0,1,4,5,8,10,12,14],awai:[3,5,16],awar:[3,9],award:17,axes3d:[3,5,12],axes:[1,6,7,8,9,10],axes_grid1:5,axessubplot:1,axhlin:7,axi:[0,1,2,3,5,6,7,8,9,10,11,12,14,16],axiom:4,axlabel:1,axvlin:7,b_1:[3,11,12],b_2:12,b_5:12,b_group:8,b_i:[1,2,3,11],b_ia_:1,b_index:8,b_j:[2,11],b_k:[2,11,12],b_m:11,b_score:8,b_valu:8,bachelor:15,back:[1,4,5,7,8,9,14,15,16],backbon:14,backend:2,background:[15,18],backpropag:2,backtrack:8,backup:14,backward:[2,3,11,14],bad:[5,16],badli:16,bag:[8,13,15],bag_clf:9,baggin:[],baggingboot:9,baggingclassifi:9,baggingtre:9,balanc:5,band:14,bandwidth:14,bar:[1,5,10],barber:18,bare:9,barebon:0,base:[0,1,2,4,6,7,8,9,13,16,17,18],basi:[4,6,7,9,10,11,12,14],basic:[5,7,11,12,13,15,16],batch:[10,11,12],batch_siz:2,bay:6,bayesian:[4,13,18],be0d226abb41:[],becaus:[0,1,2,3,4,5,7,8,11,12],becom:[0,1,2,3,4,5,6,8,11,12,16],been:[1,2,3,4,5,10,11,12,13,14],befor:[0,1,2,3,4,5,6,7,11,12,14,16],beforehand:[0,1,16],begin:[0,1,2,3,4,5,6,7,8,10,11,12,14,16],behav:[2,5,12],behavior:[1,2,12],behaviour:11,behind:[1,2,5,7,12],being:[0,1,2,3,4,6,7,9,10,11,12,16],believ:[8,14],belong:[0,4,6,7,8,12],below:[1,2,3,4,5,6,7,8,9,10,11,12,14,16],benchmark:9,bendik:17,benefici:[2,12],benefit:[1,2,10,12,13],bengio:[2,15,18],benign:[2,6],besid:4,bessel:4,best:[0,1,2,3,4,5,6,7,8,9,11,12,16,17],beta:[1,2,4,5,6,9,10,12],beta_0:[1,2,4,5,6,12],beta_0x_:1,beta_1:[1,2,4,5,6,9,12],beta_1x_0:1,beta_1x_1:[1,6],beta_1x_2:1,beta_1x_:1,beta_1x_i:[6,12],beta_2:[1,12],beta_2x_0:1,beta_2x_1:1,beta_2x_2:[1,6],beta_2x_:1,beta_:[1,5,6,12],beta_i:[1,4],beta_j:[1,4,5,12],beta_k:12,beta_linreg:12,beta_m:9,beta_mg_m:9,beta_p:6,beta_px_p:6,betavalu:4,better:[0,1,2,3,5,8,9,10,11,12],between:[0,1,2,3,4,5,6,7,8,10,11,12,16],beyond:[1,2,4,5,7,12],bia:[1,2,3,4,7,8,9,11,12,15,16],bias:[2,3,4,5,8,11],big:[0,1,2,3,4,5],bigger:[2,5],bigr:11,bike:8,bilbo:[],bilek:17,billion:[11,13],bin:[1,6,16],binari:[1,4,6,8,9,11,15,16],bind:1,binomi:13,binsboot:5,bioinformat:1,biolog:[2,11,18],bios1100:13,bird:1,birth:[],bishop:[15,18],bit:[0,2,14,16],bitwis:16,bivari:3,bla:[4,14],black:[0,7,8],block:[0,5,9,13,14],blockingavg:16,blockingstd:16,blockingvar:16,blocksiz:16,blocksizemax:16,blocksizemin:16,blue:1,bmatrix:[1,2,4,6,7,10,12,14],bmi:2,bodi:[1,2,11],bold:2,boldfac:[1,4],boldsymbol:[0,1,2,3,4,5,6,7,9,10,12],boltzmann:[11,13],book:[15,18],bool:0,boost:[2,8,13,15],boostrap:9,bootavg:16,bootstd:16,bootstrap:[2,13,15],bootvar:16,bootvec:16,borrow:[],boston_dataset:1,bot:7,both:[0,1,2,4,5,7,8,9,12,13,14,16,17],bottl:6,bottom:[],bound:[1,4,7,11],boundari:[3,7,10,11],boundkei:4,box:8,boyd:[7,12],bracket:16,brain:[2,6,11],branch:8,breast:[4,6,10],breviti:12,brew:[1,13],brg:7,briefli:1,bring:[1,4,5,9],broad:1,broadcast:0,browser:[],brute:[4,10],bsol:[],bsubex:[],build:[1,4,5,9,14,16],built:[1,2,5],bunch:10,busi:1,bzl:4,c46dd114b2af:7,c_0:16,c_1:11,c_2:11,c_3:11,c_4:11,c_i:[11,12],c_k:16,cabc613b8702:[],cach:9,cal:[1,7,9,11,12],calcul:[0,1,2,3,4,5,7,8,9,10,11,12,14],call:[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,16,18],callabl:[],calor:1,cambridg:[12,18],came:0,can:[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,16,18],cancel:[1,12],cancer:[4,9],cancerpd:6,candid:[7,8,9],cannot:[1,2,4,5,6,7,8,15,16],canopi:[1,13],cap:4,capabl:[1,2,7,12,13],capac:3,capita:1,captur:[10,11],card:[1,6],cardin:2,care:[0,10],carefulli:12,carlo:[1,5,13,16,18],carri:[3,5,6],cart:9,casella:18,cast:2,categor:[1,2,8,10],categori:[0,1,2,6,9,11,15],categorical_crossentropi:2,caus:[1,4,5,16],causal:1,causat:1,cax:2,cbar:2,ccc:[4,11],cd_fast:5,cdf:16,cdot:[0,1,3,5,11,12,14,16],celebr:12,center:[0,1,2,5,6,7,8,10,16],centr:18,central:[1,4,5,7,14],centroid:[0,16],centroid_differ:0,centroid_list:0,certain:[0,1,5,6,8,16],cha:1,chain:[2,12,13,16],challeng:0,chanc:[2,4,12,16],chang:[0,1,2,3,4,5,7,8,10,11,12,14,16],chapter:[0,1,5,9,10,14,15,18],charact:[1,4,7,16],character:[7,8,9,11,16],characterist:[1,2,9,12],charg:1,charl:1,chd:6,chddata:6,cheap:4,cheaper:[2,12],chebychev:0,check:[1,2,4,10,12,14],check_consistent_length:[],chemic:16,chen:9,chiaramont:3,choic:[0,1,2,3,5,8,11,12,14,16],choleski:[4,14],choos:[0,3,5,8,9,10,12,16],chosen:[1,2,3,5,7,8,9,12,16],chosen_datapoint:2,christian:18,christoph:[15,18],cin:16,circ:[2,11],circl:[1,7,11],circumfer:8,circumv:[2,4,12],clariti:[0,16],class_nam:8,class_val:8,class_valu:8,classic:[6,8,12],classif:[1,4,5,6,7,10,11,13,15,18],classifi:[1,2,6,8,9,10],classificaton:2,classifii:9,clean:2,clear:[2,4,9,11,12],clearer:0,clearli:[1,4,5,6,7,16],clever:[0,2,9],clf3:1,clf:[1,5,7,8,9],clf_lasso:5,clf_ridg:5,clip:16,close:[0,1,2,3,5,7,8,10,11,12,16,18],closer:[4,12],closest:[0,7,10,12],closur:13,cloud:13,clust:0,cluster:[1,2,5,10,13,15],cluster_label:0,cmap:[1,2,3,5,7,8,9],cmap_arg:5,cmath:16,cmb:15,cmd:8,cn_:16,cnn:[11,15],cntk:13,code:[5,6,7,12,13,14,15,18],coef0:7,coef:1,coef_:[1,4,5,7,8,12],coeff:4,coeffici:[1,4,5,6,7,8,12,14],coerc:[1,5],coin:[9,16],coin_toss:9,col:[1,10],colab:13,cold:8,colinear:1,collaps:7,collect:[1,3,5,9,10,13,16,18],collinear:4,color:[1,5,7,8,9,16],color_cod:5,colorbar:[2,5],colsample_bytre:9,colsaobject:9,column:[1,2,3,4,5,6,7,8,10,11,14],columntransform:8,com:[5,13,17,18],combin:[2,3,4,5,6,9,16],come:[0,1,2,4,11,12,15],comma:[],command:[1,2,16],comment:[1,4,5],commerci:[1,13],commod:1,common:[0,1,2,4,5,6,8,10,16],commonli:[0,1,2,5,6,8,12],commun:[1,11],compact:[0,1,2,4,5,6,8,10,11,12],compar:[0,1,4,5,10,12,14],comparison:[3,12],compat:6,compet:1,competit:9,compil:[1,2,13,14,16],complet:[1,3,8,11],completenn:11,complex:[2,4,7,8,10,11,12],complic:[0,1,2,8,12],compon:[0,1,2,4,5,6,8,13,15],components_:10,compos:[0,8,11],compphys:[5,13,15,18],compress:1,compris:5,compromis:4,compulsori:13,comput:[0,1,2,3,4,5,6,7,9,10,11,12,13,14,15,18],computation:[1,5,8,12,16],con:4,concaten:[0,3,5],concav:[2,12],concentr:[1,9],concept:[0,1,3,13],conceptu:[11,12],concern:[0,1,2,6],concic:[],conclud:[1,4],conclus:2,cond:3,conda:[1,2,13],condit:[1,3,4,5,7,8,10,12,16],conduct:13,condwav:3,coneqp:4,confid:[1,4,5,6,7],confirm:[4,11],confus:[4,5,9,14],confusion_matrix:8,congruenti:16,conjug:7,conjugaci:12,connect:[1,2,8,10,11,12,14],consequ:[4,5,7,9,11,12],conserv:[0,4],consid:[0,1,2,3,4,5,6,7,8,9,11,12,14,16],consider:[1,2,4,12],consist:[1,2,3,5,11,12,16],constant:[1,3,4,5,7,11,12,16],constitu:1,constitut:[3,5],constrain:[2,4,6,10],constraint:[4,5,7,12],construct:[1,2,3,4,5,6,7,8,9,10,14,16,18],contact:1,contain:[0,1,3,4,5,6,7,8,10,11,12,14,16,18],contemporari:18,content:[2,13,14],context:[5,9,12],contigu:14,continu:[1,2,3,4,5,6,7,8,9,11,12,14],contour:[8,9,12],contourf:[7,8,9],contrast:[2,8,9,11],contribut:[1,4,16],contributor:1,control:[1,2,8,12,13],conveni:[1,4,5,11,12,14],convent:11,converg:[0,1,2,3,4,5,6,7,10,12],convergencewarn:[1,2,5,6,7,10],convert:[1,2,4,8,10,12,14],convex:[4,6],convinc:12,convolut:[2,13,15],cool:8,coolwarm:5,coordin:[0,4,11],coorel:1,copi:[0,1,2,3],core:[3,9,12],corel:1,coronari:6,corr:[1,4,6,10],correalt:[10,13],correct:[0,1,2,3,4,12,14,16],correctli:[2,3,5,9],correl:[1,2,4,5,6,9,11,12,13],correlation_matrix:[1,4,6,10],correspond:[0,1,4,5,7,8,10,11,13,14,16],cortex:11,cos:[1,3,5,8,12],cosin:[0,5],cost:[1,3,4,5,6,7,8,11,12,16],cost_deep_grad:3,cost_funct:3,cost_function_deep:3,cost_function_deep_grad:3,cost_function_grad:3,cost_grad:3,cost_sum:3,could:[1,2,3,4,5,6,7,8,9,10,11,12,14,16],coulomb:1,count:[1,8,15,16,17],countor:12,coupl:[4,5],cours:[1,2,4,10,15,16],courvil:[15,18],cout:16,cov:[4,5,10,14,16],cov_xi:[4,10],cov_xx:[4,10],cov_yi:[4,10],covari:[1,6,13,14],covariance_matrix:[0,4,10],cover:[1,4,13,15,18],covert:1,covxi:16,covxx:16,covxz:16,covyi:16,covyz:16,covzz:16,cpu:2,creat:[2,3,4,8,9,10,11,13],create_biases_and_weight:2,create_neural_network_kera:2,create_x:[4,10],credit:[1,6],crim:1,crime:1,criteria:[0,1,8,9,16],criterion:[8,9,12],critic:5,cross:[1,2,6,8,9,12,13,15,16],cross_val_scor:5,cross_valid:[6,9],crossvalid:5,crucial:[2,16],csr_matrix:14,cstdlib:16,csv:[1,5,6,8],ctnk:2,cubic:1,cumbersom:4,cumsum:[9,10],cumul:9,cumulative_heads_ratio:9,cup:4,current:[0,2,3,12],curs:1,curv:[5,6,9,11],curvatur:12,custom:[0,4,5],custom_cmap2:[8,9],custom_cmap:[8,9],cutpoint:8,cvxbook:12,cvxopt:[4,7],cyber:18,cycl:[0,2,11,16],d2_g_t:3,d985fb40c43d:5,d_f:12,d_g_t:3,d_net_out:3,dagger:[4,14],dai:[2,8,13],dalen:17,darget:8,darkr:16,dat:1,dat_id:[1,5,6,8],data1:0,data2:0,data3:0,data4:0,data:[0,3,4,7,9,11,12,14,18],data_id:[1,5,6,8],data_indic:2,data_panda:[],data_path:[1,5,6,8],databas:2,datafil:[1,5,6,8],datafram:[1,4,6,8,10],datapoint:[2,4,5,6,10,12],dataset:[0,1,5,6,7,8,9,10,12],date:1,daughter:9,david:18,dbh:2,dbo:2,dcomposit:14,dcost:4,ddot:3,dead:2,deadlin:15,deal:[0,1,2,4,5,7,10,12,14,16],debt:6,debug:[4,5],decad:1,decai:[1,12,16],decent:9,decid:[1,3,4,5,8],decim:1,decis:[1,2,7,10,13,15,18],decision_funct:7,decision_tre:8,decisiontreeclassifi:[8,9],decisiontreeregressor:[1,8,9],declar:[1,14],decompos:[4,5,14],decomposit:[1,5,11,15],decompost:4,decorrel:[9,12],decreas:[2,3,4,5,9,10,12],deduc:1,deep:[6,11,12,13,15,18],deep_neural_network:3,deep_param:3,deep_tree_clf1:8,deep_tree_clf2:8,deep_tree_clf:[8,9],deepen:[4,13],deeper:[0,1],deeplearningbook:18,def:[0,1,2,3,4,5,6,7,8,9,10,12,16],def_covari:16,defect:4,defici:4,defin:[0,1,3,4,5,6,7,8,9,10,11,12,14,16],definit:[0,2,3,4,5,7,9,10,11,12,14],defint:16,degre:[4,5,7,8,9,10,16],del:2,delet:[5,16],deliv:15,delta:[0,1,3,5,7,11,12,16],delta_:[2,14],delta_h:[1,2],delta_j:11,delta_k:11,delta_l:2,delta_n:1,delug:13,delv:1,demand:12,demonstr:[1,4,5,6,10,11,13],denomin:[2,4],denot:[2,3,5,6,12,16],dens:[0,2],densiti:[0,1,3,5,16],depart:17,depend:[0,1,2,3,4,5,6,7,10,11,12,13,16],depict:16,deploy:[1,13],deprec:[1,3],depth:[1,8,9,14],deriv:[1,2,3,5,6,7,9,10,12,13],descend:[4,8,10],descent:[1,2,6,7,11,15],descr:1,describ:[0,1,3,4,5,7,9,10,11,12,14],descript:[0,1,7,8],design:[1,2,4,5,6,9,10,11,12],designmatrix:1,desir:[0,1,3,4,12],despit:[2,11],destroi:14,det:[4,14],detail:[0,1,5,10,12,14],detect:[7,11],determin:[1,3,4,5,7,8,9,10,11,12,14,16],determinist:[6,12,16],dev:[2,16],develop:[0,1,4,7,9,10,11,13,14,15],deviat:[1,2,3,4,5],devis:11,df1:[],diag:[4,7],diagnost:[2,9],diagon:[1,4,6,12,14,16],diagonaliz:4,diagram:9,diagsvd:5,dice:5,dict:[5,7],dict_kei:1,dictionari:1,did:[0,1,2,4,5,6,9,10],die:2,diff1:3,diff2:3,diff:3,diff_ag:3,diffeent:7,differ:[0,1,2,3,4,5,8,9,10,11,12,13,14,16,18],differenti:[13,14,15],differential_oper:12,difficult:[0,1,2,5,9,12,16],difficulti:[1,2,12],diffonedim:3,digit:[1,2,5,15,17],dilemma:12,dilut:2,dim:[0,10,14],dimens:[0,1,2,3,4,7,10,14],dimension:[0,1,4,5,8,10,12,13,14],dimensionless:1,diment:14,dimes:0,direct:[0,1,2,3,10,11,12],directli:[0,2,4,5,16],directori:[],disadvantag:1,disappear:5,discard:[5,10],disciplin:[1,11],disclaim:16,discourag:12,discov:1,discover:4,discret:[2,4,6,12],discrimin:[6,9,10],discuss:[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,18],diseas:6,disguis:5,disk:[],disord:[2,6],displai:[0,1,2,4,5,6,7,8,9,10,11,16],displaystyl:[1,4],displot:1,disregard:1,dissimilar:[0,10],dist:0,distanc:[0,1,7,8,10,16],distance_list:8,distinct:[0,6,7,8,9],distinctli:7,distinguish:[1,6,7,16],distplot:1,distribut:[0,1,2,5,6,9,10,12,13,14],distrubut:[1,13],div:4,dive:[1,7],diverg:[2,12],divid:[1,2,4,5,7,8,10,11,16],divis:[5,7,8,12,14,16],dna:6,dnn:[1,2,3,11],dnn_kera:2,dnn_model:2,dnn_numpi:2,dnn_scikit:[1,2],doamin:[],doc:[5,13,15,18],doconc:[],document:[6,10,12],doe:[0,1,2,3,4,5,7,9,10,11,12,14,16],doesn:[8,11],dog:2,doi:0,doing:[1,4,5,10],domain:[4,7,12],domin:1,don:[0,1,2,4,5,7,10,12,13,16],done:[0,1,3,4,5,8,9,10,12,14,16],dot:[1,3,4,5,6,7,8,9,10,11,12,14,16],doubl:[14,16],doubli:2,down:[1,5,8,10,11,12],download:[1,2,4,5,14,18],dozen:2,drag:12,dramat:10,draw:[5,9,12],drawback:[1,2,12],drawn:[2,5,6,10,16],dre:4,drop:[1,2,4,5,10,12,16],dropna:[1,5],dtype:[0,1,2,3,14],dualiti:5,dub:1,due:[0,2,3,4,5,7,9,11,12],dummi:1,dure:[1,2,7,8,10,13],dwell:1,dwh:2,dwo:2,dx_1:16,dx_1p:5,dx_2p:5,dx_mp:5,dx_n:16,dxp:5,dying:2,each:[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17],eapprox:1,earli:[2,12],earlier:[1,4,6,7,8,10,11,12],earthexplor:5,eas:[0,5,8],easi:[1,4,5,6,7,8,9,10,11,12,13,14],easier:[4,5,7,8,12,16],easiest:12,easili:[1,2,3,4,5,6,7,8,9,10,11,12,14],eastern:17,ebind:1,eblock:8,econometr:[],economi:4,ecosystem:13,ect:15,edgecolor:5,edit:[],edu:12,educ:1,eface79dac2c:9,eff:16,effect:[2,9,12,16],effic:2,effici:[1,9,12,13,14,16],efron:[5,16],egrad:12,eig:[4,10,12,14,16],eigen:16,eigenpair:[4,10],eigenvalu:[1,4,7,10,12,14],eigenvector:[4,10,12],eight:14,eigval:[14,16],eigvalu:[10,12],eigvec:[14,16],eigvector:[10,12],eispack:14,either:[1,2,4,5,6,7,8,9,10,12,16],ekstrom:17,elabor:16,electr:[1,11],electur:18,eleg:10,element:[2,3,4,5,6,7,10,11,12,13,14,15,18],elementari:[9,12,14],elementwis:12,elementwise_grad:[3,12],elessar:[],elif:0,elim:14,elimin:[4,7],els:[2,6,8,11,12,14,16],elu:2,elus:1,email:[15,17],embed:[1,10],embodi:5,emit:16,emner:[15,18],emphas:[1,9,13],emphasi:[1,13,18],empir:[2,10,16],emploi:[1,2,4,5,10,12,16],employ:1,empti:[5,9],emul:11,enabl:10,enbodi:5,encapsul:0,encod:[0,1,4,8,10],encompass:[1,16],encount:[1,2,4,5,6,12,16],end:[0,1,2,3,4,5,6,7,8,9,10,11,12,14,16],end_box:12,end_nod:12,end_valu:12,endl:16,endpoint:[5,16],energi:[1,5],enet_coordinate_desc:5,enforc:11,eng:18,engin:[1,2,13,16],english:18,enough:[1,5,12],ensembl:[2,8,15,16],ensur:[1,2,3,4,5,10,12,16],enter:[4,5,16],enthought:[1,13],entir:[2,6,8,13,16],entiti:[8,11,14],entri:[1,4,7,10,11,14],entropi:[2,6,9,12],enumer:[1,2,3,5,7],env:[4,16],environ:[3,13,18],eol:1,eosfit:1,epoch:[1,2,11,12],epsilon:[1,4,5,6,12],epsilon_0:1,epsilon_1:1,epsilon_2:1,epsilon_:1,epsilon_i:1,eqnarrai:[4,5],equal:[0,1,2,3,4,5,7,8,10,11,12,14,16],equat:[0,2,4,5,6,7,8,9,10,12,14,15,16],equilibrium:[3,11],equiv:[12,14,16],equival:[1,2,4,7,10,12,13,14],erf:16,eriador:[],eridg:[],err:[1,9],err_:5,err_sqr:3,errat:12,errno:[],erron:3,error:[2,3,4,5,6,8,10,11,12,13,14,16],error_estimate_corr_tim:16,error_hidden:2,error_output:2,escap:12,esl:0,esol:[],especi:[2,8,11,12],essenti:[0,1,4,5,8,9,11,16],establish:[1,5,9,10],estim:[1,2,4,5,6,9,10,12,13,16],estimated_mse_fold:5,estimated_mse_kfold:5,estimated_mse_sklearn:5,esubex:[],eta0:[7,12],eta:[1,2,7,11,12],eta_:12,eta_t:12,eta_v:[1,2],etc:[0,1,2,4,6,7,8,10,11,12,13,14,16],ethic:13,etsim:5,euclidean:[0,1],evalu:[1,3,4,5,8,12,16],evalut:12,even:[0,1,2,4,5,7,8,9,10,11,12,13,14,16],event:[4,6,9],eventu:[4,5,10,11,12,17],everi:[0,1,2,3,4,5,8,9,10,11,12,13,16],everyth:11,everywher:12,evolv:1,exact:[1,4,10,11,12,14,16],exactli:[1,5,11,13],examin:5,exampl:[4,10,11,12,13,14,15,18],exce:[2,11,12],excel:[0,1,2,4,9,18],except:[4,5,7,8,14,16],excess:1,excit:1,exclud:[2,5,11],exclus:[1,2,5,16],execut:[3,4,12],exemplifi:12,exercis:[4,13,15],exhaust:5,exhibit:[1,4,5,7],exist:[0,1,2,3,4,5,6,7,8,12,14,18],exit:[4,14,16],exp:[1,2,3,4,5,6,7,9,10,11,12,16],exp_term:2,expand:[4,6,10,12],expans:[1,4,7,9,11,12],expect:[1,2,4,5,6,10,11,12,13],expectation_value_of_h_wrt_p:16,expens:[5,9,12,16],experi:[1,2,5,7,12,13],experiment:[1,5,8,16],expert:[2,8],explain:[0,1,5,8,9,10,12,16],explained_variance_ratio_:10,explanatori:1,explicit:[1,5,12,14],explicitli:[0,1],explod:2,exploit:[1,11,12],explor:[2,5,7,12,13],expon:2,exponenti:[1,2,4,5,9,12],export_graphviz:8,export_text:8,exporttext:8,expos:13,express:[1,3,4,5,6,9,11,12,14,16],exptmean:16,exptvari:16,extend:[3,4,6,10,12,13],extens:[1,11,13],extent:[1,2,5,18],extern:[5,8],extra:[2,4],extract:[1,4,5,6,7,10,12,14],extrapol:1,extrem:[0,1,2,4,5,6,7,8,12,14],extremum:12,extrins:10,eye:[0,1,4,5,12,14],f11:1,f12:1,f13:1,f1_grad:12,f1d:12,f2_grad_x1:12,f2_grad_x1_analyt:12,f2_grad_x2:12,f2_grad_x2_analyt:12,f3_grad:12,f3_grad_analyt:12,f4_grad:12,f4_grad_analyt:12,f5_grad:12,f6_grad_analyt:12,f6d7a289d493:14,f7_grad:12,f7_grad_analyt:12,f8_grad:12,f9_altern:12,f9_alternative_grad:12,f9_grad:12,f_0:9,f_1:[9,12],f_2:[11,12],f_3:11,f_d:16,f_grad:12,f_grad_analyt:12,f_i:[5,11],f_m:9,f_vec:3,face:12,facecolor:[5,7,16],facil:[1,13],facilit:11,fact:[1,2,4,8,10,11,12],factor:[1,2,4,5,8,9,10,12,14,16],factori:12,fade:5,fafab0:[8,9],fail:[1,5,6,7,10,12,17],failur:6,fairli:[0,2,3,16],fall:[7,8,15],fals:[0,1,2,3,4,5,6,8,9,14],famili:[1,6,7,16],familiar:[1,4,5,7,13,14,16],famou:[5,11,14],far:[0,1,4,5,7,10,11,12,16],fashion:[1,8,9],fast:[2,5,9,11,12,13,16],faster:[2,10],fastest:[12,14],favor:6,favorit:16,fe5b9d300cc0:5,featur:[1,2,4,5,6,7,9,10,11,12,13,16],feature_nam:[1,2,6,8],feautur:8,fed:2,feed:[1,3,10,13,15],feed_forward:2,feed_forward_out:2,feed_forward_train:2,feedforward:[2,11],feel:[0,1,4,5,10,12,13,17],feet:1,fetch:5,few:[0,2,4,8,16],fewer:[1,8,10],ffnn:[2,11],field:[1,5,11,13],fifth:[1,5],fig:[0,1,2,3,5,6,11,12],fig_id:[1,5,6,8],figaxi:16,figsiz:[1,2,3,5,6,7,8,9],figur:[0,1,2,3,4,5,6,7,8,9,11,12,13],figure_id:[1,5,6,8],figurefil:[1,5,6,8],file:[1,2,4,5,6,7,8,14,16],filenam:[1,16],filenotfounderror:[],fileout:16,fill:[4,8],financ:1,find:[0,1,2,3,4,5,6,7,8,9,10,11,12,13,16],fine:[0,1],finish:3,finit:[4,5,11,12,16],first:[0,1,2,3,4,5,6,7,8,9,10,12,14,15,16,18],firsteigvector:10,fit:[2,4,5,6,7,8,10,11,12,16],fit_beta:5,fit_intercept:[1,4,5],fit_mod:8,fit_transform:[1,5,7,8,10],fiti:1,five:[1,8],fix:[1,5,9,10,11,12],fixedformatt:5,fixedloc:5,fkkt:4,flag:0,flat:[11,12],flatten:[2,4,14],flexibl:[1,2,5,7,9,11],float32:8,float64:[1,14],flop:[4,14],flow:[2,11],fluctuat:4,fly:10,flyvbjerg:16,fmesh:12,focu:[1,4,5,13,18],focus:[2,5,6,14],fold:[5,8],folder:[1,5],follow:[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,17,18],font:[1,6,16],fontdict:16,fontsiz:[2,5,7,8,9,16],fontweight:2,foral:7,forc:[1,4,5,9,10],forecast:11,forelesningsvideo:15,forest:[1,2,8,13,15],forget:10,form:[1,4,5,6,7,8,10,11,12,13,14,16],formal:[0,16],format:[1,2,5,6,7,8,9,10,13,16,18],formatstrformatt:[5,12],formul:[0,5,10],formula:[12,16],forth:11,fortran2003:13,fortran90:16,fortran:[1,13,14],fortun:[1,10],forward:[1,5,13,14,15],found:[2,3,4,5,11,12],foundat:13,four:[4,5,7,11,14,15],fourier:1,fourth:11,frac:[0,1,2,3,4,5,6,7,8,9,10,11,12,14,16],fraction:8,frame:6,framework:[2,7,9,16],frank:[4,10],frankefunct:[4,5,10],free:[1,5,10,12,13,14,16,17,18],freecodecamp:13,freedom:4,freeli:1,frequenc:[5,6,16],frequent:[1,7,8,12],frequentist:13,fresh:9,fret:0,fridai:15,friedman:[5,15,18],frodo:[],from:[0,1,2,3,5,6,7,8,10,12,13,14,15,16,17,18],from_cod:8,front:[1,4],fruit:0,fstream:16,fulfil:[3,4,11],full:[1,2,4,6,8,9,12,16],full_matric:4,fulli:[5,11,15,16],fun:[12,13],func:3,functionali:10,fundament:[1,5,13],funtion:3,further:[3,8],furthermor:[1,4,5,6,10,11,12,13],futur:[1,7,8],futurewarn:1,fys:[15,17],g_0:3,g_1:[3,9],g_2:[3,9],g_analyt:3,g_dnn_ag:3,g_euler:3,g_i:3,g_m:9,g_re:3,g_t:3,g_t_d2t:3,g_t_d2x:3,g_t_dt:3,g_t_hessian:3,g_t_hessian_func:3,g_t_jacobian:3,g_t_jacobian_func:3,g_trial:3,g_trial_deep:3,g_vec:3,gain:[0,2,4,8,9,12],galleri:1,gamge:[],gamma1:7,gamma2:7,gamma:[1,3,7,8,9,10,12],gamma_0:9,gamma_1:9,gamma_1x:9,gamma_:1,gamma_i:[1,7,16],gamma_j:12,gamma_k:12,gamma_m:9,gamma_x:1,gap:[4,5,7],gate:11,gather:[1,2,11],gaug:11,gaussbacksub:14,gaussian:[0,4,5,7],gaussian_point:0,gaussian_rbf:7,gave:12,gbc:15,gca:[3,5,7,12],gd_clf:9,gdclassiffiercgain:9,gdclassiffierconfus:9,gdclassiffierroc:9,gdm:12,gdregress:9,gemv:4,gen:16,gender:1,gener:[0,1,2,3,4,5,7,9,10,11,12,14,18],generallay:11,generate_simple_clustering_dataset:0,genom:13,geodes:10,geometr:[1,12],geometri:4,georg:18,geotif:5,geq:[3,4,7,8,12],geron:[1,15,18],get:[0,1,2,3,4,5,6,8,9,10,12,13,14,16],get_distances_to_clust:0,get_dummi:8,get_paramet:3,get_split:8,get_yaxi:7,get_yticklabel:5,getattr:[],getsolutionslic:4,gibb:13,gini:9,gini_index:8,git:[1,13],github:[1,5,13,15,18],gitlab:[1,13],give:[0,1,2,3,4,5,6,7,8,9,11,12,13,15,16,18],given:[0,1,2,3,4,5,6,7,8,9,10,11,12,14,16],glare:0,global:[5,6,12,16],glorot:2,gmail:17,goal:[1,6,8],goe:[0,1,2,3,4,5,12,14],going:[1,2,4,5,7,8,10,11,12],golden:12,gone:4,gong:2,good:[0,2,4,5,8,9,10,12,13,15,16,18],goodfellow:[15,18],googl:[0,2,13],got:[2,5],gov:5,gpu:2,grad:[3,12],grad_analyt:12,grade:15,gradient:[1,6,7,8,11,13,15],gradientboostingclassifi:9,gradientboostingregressor:9,gradual:[0,2],grai:5,graph:[2,8,10,11,12],graph_from_dot_data:8,graphic:[1,2,8],grasp:1,gray_r:2,great:[4,12],greater:[2,6,16],greatli:12,greedi:8,green:[1,8,16],grid:[2,5,6,7,11,16],grossli:12,ground:1,group:[0,1,5,6,8,13,15],groupbi:1,grow:[2,8,9],growth:1,guarante:[1,12,16],guess:[0,2,9,12],guestrin:9,guid:2,h21:15,h_1:[3,12],h_2:[3,12],h_m:9,habit:1,had:[1,2,5,6,12],hadamard:[2,11],half:[2,7,8],halv:9,hand:[1,2,3,4,10,11,12,13,14,15,16,18],handl:[1,2,3,4,8,10,13],handle_unknown:8,handsid:11,handwrit:11,handwritten:[2,4],happen:[0,2,3,4,5,9,12,16],hard:[2,6,7,9,12],hardcopi:13,harder:[1,2],has:[0,1,2,3,4,5,6,7,8,9,10,11,12,14,16],hasn:[1,2],hassl:[1,13],hast:13,hasti:[0,1,5,15,18],hat:[2,4,5,6,8,9,10,11,12,14,16],have:[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,16],haven:2,hdf5:[],head:[1,9,16],header:1,heads_proba:9,health:1,hear:1,heart:[1,6],heatmap:[1,2,6],heavili:1,heavisid:2,height:[2,5],held:12,help:[0,1,2,11,12],helper:0,henc:[1,4,5,7,8,9,11,12],her:6,here:[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,18],hereaft:[1,7,11],hermitian:14,hessenberg:14,hessian:[1,3,4,12],heterogen:[8,9],hidden:[2,11],hidden_bia:2,hidden_bias_gradi:2,hidden_layer_s:[1,2],hidden_weight:2,hidden_weights_gradi:2,hierarch:[0,4],high:[0,1,2,3,4,5,8,9,10,12,13,14],higher:[1,2,4,5,7,12],highest:[2,3],highli:[1,9,13,14,16,18],highwai:1,hing:7,hint:12,hip:13,hire:1,his:6,hist:[5,6,16],histogram:[1,5,6,16],histor:[6,10],histori:11,histplot:1,histtyp:[],hitherto:4,hjorth:17,hobbi:16,hoc:4,hoff:18,hold:[0,2,5,12,16],holder:1,home:1,homework:[5,12],homogen:[2,8,9,12],honchar:3,hopefulli:[1,10,16],horizont:10,hors:6,hot:[2,8],hour:[2,13,15,16,17],how:[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,18],howev:[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,16],hspace:[1,7,9,16],hstack:2,htf:15,html:[6,10,13,15,18],http:[5,6,10,12,13,14,15,18],huang:1,huber:1,huge:[2,13],human:[1,2,5,8,11],humid:8,hundr:2,hungri:2,hybrid:15,hydrogen:1,hyperbol:[2,11],hyperparam:7,hyperparamet:[0,4,5,8],hyperplan:10,i_1:[4,5],i_2:[4,5],ian:18,idea:[1,2,3,5,8,9,11,12,14,16],ideal:[0,1,3,5,7,12,16],idem:5,ident:[4,5,11,12,14],identical:4,identifi:[0,1,2,6,7,8,10,11,12],idum:16,ieor:16,ifi:18,ifs:13,ignor:[1,2,8],iii:14,ijca2016907841:0,illustr:[0,4,6,9,11,12,13],imag:[2,5,8,10,11,18],image_path:[1,5,6,8],imageio:5,imagin:2,immedi:[1,5,13],implement:[0,1,3,4,5,7,8,9,10,11,12],impli:[4,5,6,12,14],implicitli:[10,16],impos:[1,5,10,11],imposs:[1,4],impress:[1,11],improv:[0,1,4,8,9,10,12],impur:8,imread:5,imshow:[2,5],in3050:18,in4080:18,in4300:18,in5400:18,inaccur:12,inact:11,inadequ:1,inch:5,includ:[1,2,3,4,5,6,10,11,12,13,16,17,18],include_bia:[5,8],incom:11,inconsist:[],incorrect:2,incoveni:7,increas:[1,2,4,5,6,7,8,10,11,12,16],increasingli:16,ind:5,inde:[1,3,4,5],indent:16,indentationerror:16,independ:[1,4,5,6,7,11,12,16],index:[0,1,2,9,13,14,16,18],index_col:1,indic:[1,2,4,5,8,9,10,12],indispens:5,individu:[2,5,6,9,11,16],indu:1,indx1:3,indx2:3,indx3:3,indx:14,ineffici:[0,12],inequ:7,inequaltii:12,inertia:12,inf1000:13,inf1100:13,inf1100l:13,inf1110:13,inf3000:18,inf4490:18,inf5860:18,inf:1,infeas:8,infer:[1,2,5,18],inferenc:2,infil:[1,5,6,8],infin:[4,5,6,10],infinitesim:16,influenc:[5,9],influenti:2,info:[],inform:[0,1,2,5,8,10,11,12,14,18],infti:[5,12,16],ingeni:12,ingredi:[1,8],inher:5,inherit:14,initi:[0,1,2,3,5,9,12,14,16],initialis:16,inject:0,inlin:[0,1,2,3,4,5,6,7,8,9,10,11,12,14,16],inner:12,innov:18,inplac:12,input:[0,1,2,4,5,6,7,8,9,11,12,14,16],input_dim:2,inputs:2,inputs_shuffl:[1,2],insert:[4,5,7,9,16],insid:[1,6],insight:[1,2,4,13,18],insist:[5,12],inspir:[1,2,11,18],instabl:3,instal:[1,2,4,5,8],instanc:[1,2,3,5,8,10,12],instanti:9,instead:[0,1,2,3,4,5,7,8,10,12,14,16],institut:2,instruct:[1,2],int32:9,int64:1,int_0:16,int_:[5,16],int_a:16,intak:1,integ:[0,2,3,12,14,16],integer_vector:2,integr:[5,16],intellig:[0,1,18],intend:9,intens:2,intention:0,interact:[1,5,8,11,13],intercept:[1,5,7,10,12],intercept_:[1,5,7,8,12],interchang:[4,11,14],interconnect:2,interest:[1,2,3,4,5,6,7,8,11,13,15,16],interfac:[1,2,14],interior:[1,8],intermedi:14,intern:[2,9,11],interpol:[2,5,11],interpr:4,interpret:[1,2,5,8,9,11,12,14,16],interv:[1,4,5,6,12,16],intial:12,intimid:[],intract:1,intrins:[10,14,16],intro:[13,18],introduc:[1,2,4,5,7,9,11,12,14,16],introduct:[2,3,12,15,18],introductori:[1,14,18],intuit:[1,4,5,7,11,12],inv:[1,4,12],invalid:[2,7,14],invalu:[1,12,13],invari:2,invd:4,inver:7,invers:[1,5,12],invers_period:16,inverse_transform:7,invert:[1,4,6,9],invok:[1,7],involv:[1,3,5,6,10,11],iomanip:16,ios:16,iostream:16,ipca:10,ipynb:13,ipython:[0,1,2,4,5,6,7,8,9,10,12,13,14,16],irani:0,iri:[7,8],irreduc:5,irrelev:4,irrespect:1,isbox:12,isinst:12,isn:4,isnul:1,isomap:10,issu:[2,8,14],it_arrai:12,item:[1,12],items:14,iter:[0,1,2,3,5,6,7,10,12,16],itr:4,its:[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,18],itself:[4,5,11,16],j_lasso_sk:5,j_ridge_sk:5,j_sk:5,jackknavg:16,jackknif:[5,13],jackknstd:16,jackknvar:16,jackknvec:16,jacobian:[3,12],jargon:16,jensen:17,jerom:18,job:[3,7,9],join:[1,5,6,8],joint:4,journal:16,judg:12,judgement:5,julia:[13,14],jump:[0,16],jupyt:[0,1,13,15,18],just:[0,1,2,3,4,5,6,7,8,9,10,11,12,16],justif:1,justifi:9,k_mean:0,kaggl:5,kappa_d:16,karim:17,karlsen:17,karush:7,keep:[0,1,2,4,5,10,12,14],keepdim:[2,5,9,14],kei:[1,2,5,11,18],kept:[0,5],kera:[1,13],kernel:[1,2,13],kernel_regular:2,kernelpca:10,kev:1,kevin:18,keyword:14,kfold:5,kick:[2,12],kiener:3,kilomet:5,kind:[0,1,3,7,11,12],kjm:13,kkt:[4,7],kktsolver:4,kmeanspoint:0,kn_k:0,know:[0,1,2,3,4,5,7,12,13,16],knowledg:[1,13],known:[2,4,5,6,7,8,11,14,16,18],kondev:1,kpca:10,kroneck:0,kuhn:7,kwarg:12,kwown:1,l1_l2:2,l1regl:4,l1regls_mosek2:4,l1regls_mosek:4,l_1:6,l_2:[6,12],l_j:11,la_i:11,la_k:11,lab:[13,15],label:[0,1,2,3,4,5,6,7,8,9,11,12,13,14,16],labelencod:[6,9],labels:[5,7,8],labels_shuffl:[1,2],labor:0,laboratori:15,lack:[0,1],lagari:3,lagrang:[7,10],lambda:[1,2,3,4,5,6,7,9,11,12,16],lambda_0:10,lambda_1:[4,7,10],lambda_2:[7,10],lambda_:10,lambda_i:[7,10],lambda_iy_i:7,lambda_jy_iy_j:7,lambda_k:7,lambda_n:[4,7],lamda:2,lamdbda:4,land:[1,7],landmark:7,landscap:12,langl:[1,5,10,16],languag:[1,2,7,13,14,18],lapack:[4,14],laplac:4,laptop:13,larg:[1,2,3,4,5,7,8,9,10,12,13,14,16,18],larger:[1,4,5,7,9,10,12,16],largest:[7,10],lasso:[1,6,13,15],lasso_sk:5,last:[0,1,2,4,5,6,7,8,9,11,12,14,15,16],later:[0,1,2,6,7,11,12,13,16],latex:[],latter:[1,4,5,6,7,10,12,14,15,16],lattic:11,law:1,layer:[1,12],lbfg:[6,8,9,10],lbl:[],lcc:[4,5],lda:10,ldot:[1,5,10,16],lead:[1,2,4,5,6,7,8,9,10,11,12,14,16],leaf:8,leaki:2,lear:12,learn:[4,5,6,7,8,9,11,14,15,18],learner:9,learning_r:[7,9],learning_rate_init:[1,2],learning_schedul:12,least:[0,1,6,7,9,10,13,14,15,16],leav:[1,2,4,5,8,10],lectur:[1,2,4,9,10,11,12,13,14,15,18],lecturenot:[13,18],lectureoctober14:15,lectureoctober15:15,lectureoctober1:15,lectureoctober21:15,lectureoctober22:15,lectureoctober7:15,lectureoctober8:15,lectureseptember10:15,lectureseptember16firstpart:15,lectureseptember16secondpart:15,lectureseptember17:15,lectureseptember23:15,lectureseptember24:15,lectureseptember2:15,lectureseptember30:15,lectureseptember3:15,lectureseptember9:15,lecturethursdayaugust26:15,lecturethursdayaugust27:15,left:[1,2,3,4,5,6,7,8,9,10,11,12,14,16],leftarrow:[7,11],legend:[1,3,4,5,6,7,8,9,12],len:[0,1,2,3,4,5,7,8,9,10,11,14,16],length:[1,2,3,7,8,12,13,16],leq:[0,1,4,6,7,12,16],less:[1,2,4,5,7,8,16],lessen:2,let:[0,1,2,3,4,5,6,7,8,9,10,11,12,14,16],letter:[1,14,16],level:[1,2,4,5,8,13,14,15],lib:[1,2,3,5,6,7,10,12],liblinear:[7,9],librari:[1,2,3,4,5,8,9,10,14,16,18],licens:[1,2,13],lie:[1,5,10,16],lies:[7,10],life:[1,2,7,11],lifetim:12,lift:0,light:[],like:[0,1,2,3,4,5,6,8,9,10,11,12,13,14,16],likelihood:[1,2,4,8],lim_:16,limit:[1,4,5,6,7,10,11,14],lin_clf:7,lin_model:1,lin_reg:8,linalg:[1,3,4,5,7,10,12,14,16],line1:7,line2:7,line2d:12,line3:7,line:[1,2,5,7,10,12,14,16],linear:[2,4,5,6,8,9,10,11,13,15,16],linear_model:[1,4,5,6,7,8,9,10,12],linear_regress:5,linearli:4,linearloc:[5,12],linearregress:[1,5,6,8],linearsvc:7,liner:2,linerar:9,linewidth:[1,3,5,7,8,9],link:[1,8,11,13],linlag:4,linpack:14,linreg:1,linspac:[1,3,5,7,8,9,12,14,16],linu:17,linuek:17,linux:[1,2,13],liquid:1,list:[0,1,2,3,4,8,13],listedcolormap:[8,9],literatur:[0,2,6,18],littl:[2,8,11],live:7,lle:1,lloyd:0,lmb:[3,4,5],lmbd:[1,2],lmbd_val:[1,2],lmbda:12,load:[1,2,5,6,8,9],load_boston:1,load_breast_canc:[2,6,8,9,10],load_digit:2,load_iri:[7,8],loc:[1,5,6,7,8,9],local:[1,2,6,11,12],locat:[3,7],log10:[4,5],log:[1,2,3,4,5,6,8,9,10,12,14],log_:1,log_clf:9,logarithm:[1,4,6,14],logic:[1,2,8],logist:[1,2,3,7,8,9,10,11,12,13,15],logisticregress:[6,8,9,10],logit:6,logreg:[6,8,9,10],logspac:[1,2,4,5],longer:[0,3,7,9,14,16],longest:0,loocv:5,look:[0,1,2,3,4,5,6,7,8,9,10,12,14,16],loop:[0,2,5,9,11,13,14,16],lose:2,loss:[1,2,4,5,6,7,9,10,12,14],lot:[0,1,2,5],low:[1,5,8,9,10,16],lower:[1,2,5,8,9,14],lowercas:14,lowest:[8,12,16],lstat:1,lstsq:1,lubksb:14,luckili:3,ludcmp:14,lux:14,lvert:2,m_1:0,m_h:1,m_k:0,m_l:11,m_n:1,m_p:1,m_t:12,machin:[2,4,5,6,8,9,10,11,14,15,18],machinelearn:[5,13,15,18],mackai:18,made:[1,2,4,5,6,8,10,11],mae:1,magic:0,magnitud:[2,5,6,12],mai:[1,2,3,4,5,6,7,8,10,11,12,13,14,16],mail:15,main:[1,2,4,5,6,8,14,18],mainli:[1,4,5,6,8],maintain:5,major:[2,5,8,9,12,14],make:[0,2,3,4,5,6,7,10,11,12,13,14,16,18],make_axes_locat:5,make_moon:[7,8,9],make_pipelin:[1,5,9],make_vjp:12,makedir:[1,5,6,8],makeplot:1,malcondit:14,malign:[2,6,8],mammographi:4,manag:[1,3,13],manhattan:0,mani:[0,1,2,4,5,6,7,8,10,12,13,14,16,18],manifold:10,manual:[0,5],map:[0,1,2,3,5,6,7,10,11,16],margin:[1,4,7],marit:1,mark:[],marker:[1,6,14],markov:13,marsaglia:16,mask:16,mass:[1,2,4,12],massag:1,masses2016:1,masses2016ol:1,masses2016tre:1,masseval2016:1,master:[5,15],mat1100:13,mat1110:13,mat1120:13,mat3155:15,mat4155:15,mat:13,match:[0,2,4,12],materi:[4,6,14],math:[0,6,11,12,14,16,18],mathbb:[0,1,4,5,6,7,10,11,12,14,16],mathbf:[1,4,5,6,7,12,14,16],mathcal:[2,4,5,6,12],mathemat:[0,1,5,10,11,12,13,14,15,16,18],mathemati:[],mathemt:[],mathrm:[0,1,2,4,5,6,7,8,9,10,11,12,16],matmul:[2,3,4],matnat:[15,17,18],matplotlib:[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,16],matric:[1,2,5,6,7,10,12,13,14],matrix:[1,3,5,6,7,9,12],matshow:2,matter:[3,12],max:[1,2,3,8,9,11,12],max_depth:[1,8,9],max_diff1:3,max_diff2:3,max_diff:3,max_it:[1,2,6,7,10,12],max_iter:0,max_leaf_nod:9,max_sampl:9,maxdegre:[1,5,9],maxdepth:9,maxim:[2,4,6,7,10],maximum:[0,1,2,3,4,6,7,8,9,12],maxpolydegre:[4,5],mbox:[4,5],mcculloch:11,mcint:16,mcintsqr2:16,mean:[2,3,4,5,6,8,9,10,11,12,13,14,15],mean_absolute_error:1,mean_divisor:0,mean_i:16,mean_matrix:0,mean_squared_error:[1,5,6,9],mean_squared_log_error:1,mean_vector:0,mean_x:16,meaning:[1,6],meansquarederror:1,meant:[3,6,9,12],meantempvec:16,meanvec:16,measur:[0,1,2,3,4,5,8,10,11,16],mechan:[1,16],median:1,medicin:11,medium:[7,12],medv:1,meet:[1,17],mehta:1,memori:[10,11,12,14],mention:[0,1,11,12,16],mere:1,mersienn:16,meshgrid:[3,4,5,7,8,9,10],messag:[4,12],messi:3,met:[1,7],meteorolog:8,meter:5,method:[0,1,2,3,4,6,7,10,11,13,14,15,18],metion:5,metric:[0,1,2,5,6,8,9],metropoli:13,mev:[1,16],mglearn:13,mgrid:12,mhjensen:[1,2,3,5,6,7,10],microsoft:18,mid:2,midpoint:8,might:[1,2,3,5,8,12],mild:8,miller:16,millimet:5,million:1,mimic:11,min:[1,3,4,7,8],min_:[0,1,3,4],min_samples_leaf:8,mind:[0,1,5,12],mine:13,mini:[2,10,11,12],minibatch:[2,10,12],minibathc:12,minim:[0,1,2,3,4,5,6,7,8,9,10,11,12,16],minima:[1,2,6,12],minimum:[1,2,3,5,7,8,10,12],minkowski:0,minmaxscal:1,minor:16,minst:2,minu:6,mirror:8,misc:5,misclassif:[7,8,9],misclassifi:[7,9],miser:1,mismatch:2,miss:[1,9],mit:18,mix:[2,3],mixtur:12,mkdir:[1,5,6,8],mlab:16,mle:[4,6],mlp:2,mlpclassifi:2,mlpregressor:1,mnist:[2,10],mod:16,mode:[15,16],model:[0,3,4,6,7,8,9,10,12,13,16,18],model_select:[1,2,4,5,6,8,9,10],moder:9,modern:[1,5,6,13],modif:[3,11,12],modifi:[1,2,4,6,7,9,11,12],modul:[1,5,6,8,9,10,12,14],modular:16,modulenotfounderror:8,modulo:16,moe:[4,10],moment:[4,5,12],monitor:12,monoton:[4,11,16],mont:[1,5,13,16,18],montecarlocycl:16,moor:[4,5],more:[1,2,3,4,6,7,8,9,10,11,12,13,15,16],moreov:1,morten:17,mosek:4,most:[0,1,2,4,5,6,7,8,9,10,11,12,13,15,16],mostli:[2,10],motion:[1,12],motiv:2,move:[0,1,4,5,6,8,11,12,16],mp4:15,mpl:[1,6],mpl_toolkit:[3,5,12],mplot3d:[3,5,12],mplregressor:2,mse:[1,4,5,8,9],mse_simpletre:9,mselassopredict:4,mselassotrain:4,mseownridgepredict:5,msepredict:4,mseridgepredict:[4,5],msetrain:4,msg:1,msle:1,mt19937_64:16,mu0:16,mu1:16,mu2:16,mu_1:[],mu_:[5,16],mu_i:5,mu_j:[],mu_n:10,mu_x:16,much:[1,2,3,4,5,7,8,9,10,11,12,14,16],mul:4,multi:[1,2,6,13],multiclass:[2,6],multidimension:[10,11],multilay:2,multinomi:6,multipl:[3,4,5,6,11,12,16],multipli:[4,5,10,12,14,16],multiplum:7,multitud:[],multivari:[1,3,9,10,13,16],multivariate_norm:[0,10],murphi:[10,18],must:[0,2,3,4,5,7,9,11,12,16],mutat:6,mutual:[2,5,12],mx_:16,myriad:[1,13],mz1:16,mz2:16,n_0:[11,16],n_b:16,n_boostrap:[5,9],n_bootstrap:5,n_categori:2,n_cluster:0,n_compon:10,n_epoch:12,n_estim:9,n_featur:2,n_hidden:3,n_hidden_neuron:[1,2],n_i:16,n_input:[1,2],n_instanc:8,n_iter_i:[6,10],n_job:9,n_k:0,n_l:[11,16],n_layer:2,n_m:8,n_neuron:2,n_neurons_layer1:2,n_neurons_layer2:2,n_point:0,n_sampl:[0,5,7,8,9],n_split:5,n_t:3,n_x:3,nabla:[2,12],nabla_:[3,12],nabla_w:12,nag:12,naimi:1,naiv:[0,6],nall:1,name:[0,1,2,4,5,6,7,8,9,11,12,13,14,17],nameerror:[5,9],namespac:16,narrow:12,nary_f:12,nary_op_arg:12,nary_op_kwarg:12,nary_oper:12,nation:[2,4],nativ:13,natur:[1,2,7,8,11,12,16,18],navier:11,nb_:14,nbconvert:[],nboot:16,ndarrai:[3,5],nearest:[2,5,10],nearli:12,neat:[],neccesari:5,necess:3,necessari:[0,1,2,7],necessarili:[1,10,16],necesserali:4,neck:6,need:[0,1,2,3,4,5,7,8,9,10,11,12,14,16],neg:[1,2,4,5,6,9,12,14,16],neg_mean_squared_error:5,neglect:16,neglig:16,neighbor:[5,10],neither:12,neq:[0,12,16],nervou:11,nest:[3,8,11],nesterov:12,net:[3,11],netlib:14,network:[1,8,12,13,15,18],neural:[1,6,12,13,15,18],neural_network:[1,2,3],neuralnetwork:2,neuron:[2,3,11],neutral:1,neutron:1,never:[2,5,8,16],new_box:12,new_hobbit:[],new_root:12,new_sig:[],new_trac:12,newaxi:[1,5,8],newli:1,newton:[2,6,7,12,16],next:[0,1,2,3,4,5,7,8,12,16],next_guess:12,nian:17,nice:[0,1,2,4,10],nichola:17,nicholaskarlsen1102:17,niter:12,nitric:1,nlambda:[4,5],nm_n:1,nmse:5,nn_model:2,nnmin:3,node:[2,8,9,11],nois:[1,4,5,7,8,9,12],noisi:[2,5],non:[0,1,2,4,5,6,8,9,10,11,12,14,16],none:[0,1,2,3,4,8,9,12,16],nonetheless:0,nonlinear:[5,7,8,10,11],nonneg:[5,8,12],nonparametr:5,nonsens:16,nonsingular:14,nonumb:[6,7,12,14],nor:[2,12],norm:[1,2,4,5,7,10,12],normal:[4,5,6,7,8,9,10,11,12,13,14],normali:14,normpdf:[],norwai:5,notat:[0,1,3,4,5,12,16],note:[0,1,2,3,4,5,6,7,10,11,12,13,14,15,16,18],notebook:[0,1,2,8,13],noth:[0,2,3,4,7,11,16],notic:[4,11,12,14,16],novel:[5,9],novemb:2,now:[0,1,3,4,5,6,7,9,10,11,12,14,16],nowadai:[1,2,8,13],nox:1,np_assign_points_to_clust:0,np_get_distances_to_clust:0,np_k_mean:0,npr:3,nsampl:5,nspin:16,nthi:1,ntrained_model:5,nuclear:4,nuclei:[1,16],nucleon:1,nucleu:1,num_coordin:3,num_hidden_neuron:3,num_it:3,num_neuron:3,num_neurons_hidden:3,num_point:3,num_tre:9,num_valu:3,number:[0,2,4,5,6,7,8,9,10,11,12,14,15,17],numberid:6,numer:[1,4,5,8,9,10,11,12,13,14,18],numpi:[0,1,2,3,4,5,6,7,8,9,10,11,12,13,16],nunmpi:4,nx_test:5,nx_train:5,nx_train_mean:5,ny_pr:5,ny_train:5,ny_train_mean:5,obei:[5,10,12],object:[1,2,3,4,5,7,9,12,14],objsens:4,obliqu:4,observ:[0,2,4,5,6,7,8,9,10,11,12],obtain:[0,1,2,4,5,6,7,8,9,11,12,14,16],obviou:[4,5,10,16],obviouli:1,obvious:[1,4,5,14],occupi:1,occur:[1,5,7,8,14,16],odd:[1,6],ode:3,odenum:3,odesi:3,oen:1,off:[2,4,8,12,16],offend:[],offer:[5,10,13,14,15],offic:17,offici:15,ofil:16,ofstream:16,often:[0,1,2,4,5,6,7,8,9,10,11,12,13,14,16],ofter:14,old:[2,4,9,12],ols_sk:5,ols_svd:5,olsbeta:4,omega:[3,5],omit:[1,4],onc:[0,2,5,8,10,12,16],one:[0,1,2,4,5,6,7,8,9,10,12,13,14,16],onehot:2,onehot_vector:2,onehotencod:8,ones:[1,3,4,5,7,8,9,10,12,14],onli:[0,1,2,3,4,5,6,7,8,9,10,11,12,14,16],onlin:[10,15],onto:[4,10],open:[1,2,5,6,8,13,15,16],oper:[1,2,4,5,9,10,11,12,13,16],operation:16,opinion:0,oplu:16,opmiz:12,opportun:1,oppos:[5,12],opposit:[2,4,7],opt:[1,2,3,4,5,6,7,10,12],optim:[0,1,3,4,5,6,8,9,10,15],optimis:2,option:[1,2,4,5,6,7,10,14],optmiz:[2,7],orang:1,order:[1,2,3,4,5,6,7,8,9,10,11,12,14,16],ordinari:[1,3,6,10,12,13,15],oreilli:18,org:[6,10,13,14,18],organ:[0,5,6,9,14],orient:[2,4,16],origin:[1,4,5,7,10,11,12,14,16],orthogn:4,orthogon:[1,4,5,7,10,12,14],orthonorm:4,oscar:2,oscil:12,oslo:[1,15,17],osx:[1,13],other:[0,1,2,3,4,5,6,7,9,12,13,15,18],otherwis:[1,2,6,12,14],ouput:[4,6,11],our:[2,3,5,6,7,8,9,11,13,14,15],ourmodel:1,ourselv:[0,1,4,5,7,10,12],out:[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,16],out_fil:8,outcom:[1,6,8,9,11,16],outdoor:8,outer:[5,11],outfilenam:16,outlier:[1,7],outlin:[5,9,10],outlook:8,outperform:9,output:[1,2,4,5,6,7,8,9,11,12,14],output_bia:2,output_bias_gradi:2,output_weight:2,output_weights_gradi:2,outputlayer1:11,outputlayer2:11,over1:12,over:[0,1,2,4,5,8,9,11,12,14,16],overal:[2,9],overcast:8,overcom:[11,12],overdetermin:1,overfit:[1,2,5,8,9,12],overflow:[2,4],overhead:11,overlap:[6,7,8],overlin:[0,1,4,5,8,9,10,14],overst:1,overview:[0,18],own:[4,5,7,11,12,13,14],owner:1,ownridgebeta:5,oxid:1,oyvinssc:17,p_hidden:3,p_i:[4,16],p_j:16,p_n:16,p_output:3,p_x:16,pack:1,packag:[1,2,3,4,5,6,7,10,12,13,16],page:[1,13],pai:[1,2,8,12],painless:[],pair:[1,3,8,13,16],panda:[1,4,5,6,8,10,13],panel:[],paper:2,paradigm:1,parallel:[9,14],param:3,paramat:3,paramet:[1,2,3,4,5,6,7,8,9,11,12,16],parameter:[1,5,9],parametr:[1,5],paramt:4,park:16,part:[0,1,2,4,5,9,14,15,16,18],partial:[1,2,4,5,6,7,9,10,11,12,16],particip:[13,15],particl:[1,12,16],particular:[1,2,3,4,5,8,9,10,11,12,16,18],particularli:[4,5,7,10,12,16],partit:[2,8],partli:5,pass:[0,3,11,16],past:[9,16],patch:[5,16],path:[1,5,6,8,13],patient:6,pattern:[1,11,15,18],pauli:1,pca:[1,6,13,15],pcost:4,pde:3,pdf:[1,4,5,8,18],pedagog:1,penal:5,penalti:[5,12],penros:[4,5],pentagon:12,peopl:[1,2,8,13],per:[1,2,5,15],percentag:[1,9,10],perceptron:[1,2,6],peregrin:[],perfect:[1,2],perfectli:5,perform:[0,1,3,4,5,7,9,10,11,12,13,14,16],perhap:[1,4,12],perimet:2,period:2,permut:10,persist:12,person:[4,5,6,15,17],perspect:18,pertin:11,petal:[7,8],peter:18,petersen:16,phantom:16,phase:[5,11],phatak:0,phenomena:16,phi:7,phi_k:7,philip:17,philosophi:12,phone:17,phrase:1,physic:[1,2,6,11,12,16,17,18],pick:[0,2,8,9,10,12,16],pickl:2,pictur:1,pie:13,piec:[0,10],pillow:[1,13],pinv:[4,5],pip3:[1,2],pip:[1,2,13],pipelin:[1,5,7,9],pippin:[],pise:0,pitfal:5,pitt:11,pixel:2,pixel_height:2,pixel_width:2,place:[1,5,7,12,14],plai:[1,4,5,7,10,13],plain:[7,9,11,12],plan:[5,8,17,18],plane:[7,8],plateau:[4,16],platform:13,plausibl:11,pleas:[1,6,10,12],plenti:2,plethora:11,plot:[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,16],plot_confusion_matrix:[6,9],plot_count:5,plot_cumulative_gain:[6,9],plot_data:2,plot_dataset:7,plot_decision_boundari:[8,9],plot_import:9,plot_predict:7,plot_regression_predict:8,plot_roc:[6,9],plot_surfac:[3,5,12],plot_train:8,plot_tre:[8,9],plt:[0,1,2,3,4,5,6,7,8,9,10,11,12,14,16],plu:[1,4,6],pmatrix:3,png:[1,5,6,8],point:[0,1,2,3,4,5,6,7,8,9,10,12,14,16,17],points_in_clust:0,poisson:13,poli:[5,7],poly100_kernel_svm_clf:7,poly3:1,poly3_plot:1,poly3dcollect:12,poly_featur:[7,8],poly_features10:8,poly_fit10:8,poly_fit:8,poly_kernel_svm_clf:7,polydegre:[1,4,5,9],polygon:12,polym:11,polynomi:[1,4,5,6,7,8,9,10],polynomial_featur:5,polynomial_svm_clf:7,polynomialfeatur:[1,5,7,8],polytrop:[1,5],poor:[2,12],poorli:1,popul:[1,4],popular:[1,2,5,6,7,8,10,11,13,14,16],popularli:1,portabl:9,portion:[10,12],pose:[1,4,5,10,16],posit:[0,1,2,3,4,6,7,9,10,12,14,16],possibl:[1,2,3,4,5,6,7,8,9,10,11,12,13,14,16,17],posterior:4,postpon:1,postul:4,potenti:[1,4,5,11,12],potr:4,potrf:4,pott:11,power:[1,2,4,5,7,8,11],practic:[1,4,5,6,7,15,16],practition:[1,2],pre:4,preced:[2,10,11,16],preceq:7,precis:[1,3,4,10,12,14,16],pred:5,predicit:1,predict:[1,2,4,5,6,7,8,9,13,18],predict_prob:2,predict_proba:[6,9],predictor:[1,4,5,6,8,9,10],prefer:[1,2,5,7,8,10,13],prepar:[1,5,14],preprocess:[1,5,6,7,8,9,10],prerequisit:1,presenc:12,present:[1,4,5,8,11,12,15,16],preserv:[10,14],press:[12,18],pretrain:2,pretti:[1,7,8,13],prev_centroid:0,prevent:[12,16],previou:[1,2,3,4,5,7,9,10,11,12,14,16],previous:[0,3,8,9,16],price:[1,8,12],primal:7,primari:[1,6],primarili:0,prime:16,princip:[1,4,6,13,15],principl:[0,1,5,6,7],print:[0,1,2,3,4,5,6,7,8,9,10,12,14,16],print_funct:[7,8],printout:1,prior:[1,4,5],privat:1,prob:[2,16],probabilist:[1,18],probabl:[1,2,5,6,9,12,13,15],problem:[1,4,5,6,7,8,9,10,11,13,14,15,16],proce:[1,4,5,7,8,9,10,12,14],procedur:[3,4,5,7,9,10,12],proceed:14,process:[0,1,3,5,8,9,11,12,13,14,16,18],prod:18,prod_:[2,4,6],produc:[0,1,4,5,8,9,10,11,12,13,14,16],product:[1,2,4,5,6,7,11,12,13,14],profess:1,profil:0,program:[0,1,2,4,5,7,11,13,14,15,16],programm:14,progress:[0,2],progression_plot:0,prohibit:5,project1:5,project:[1,2,3,4,10,12,13,15,16,17],project_root_dir:[1,5,6,8],promin:11,promis:7,prone:8,pronounc:[12,13],proof:[1,10,11,12],prop:[],propag:[3,15],proper:[1,3,5],properli:[0,2,5,7,9,12],properti:[1,2,11,12,14],proport:[1,2,4,8,10,12,16],propos:[2,5,9],propto:[4,12],proton:1,prove:12,provid:[1,2,4,5,7,8,9,11,12,13,14,16,18],proxi:[2,12],prun:0,prune:8,pseudoinv:4,pseudoinvers:[4,5],pseudorandom:[5,16],psycholog:1,ptratio:1,punish:[1,2],pure:[8,16],purest:8,puriti:8,purpos:[0,1,9,11],put:2,putarow:4,putboundslic:4,putclist:4,putobjsens:4,putqobj:4,pycod:[],pydata:13,pydot:8,pyhton2:[],pylab:[1,6],pypi:13,pyplot:[0,1,2,3,4,5,6,7,8,9,10,11,12,14,16],pythagora:[0,4],python2:1,python3:[1,2,3,5,6,7,10,12,13],python:[2,3,4,5,7,10,11,12,15],pytorch:[1,13],qquad:[3,10,12,14],quad:[2,12,14],quadrat:[1,4,7,8,12],qualit:[8,16],qualiti:[1,8,13],quantifi:2,quantil:9,quantit:[1,5,8],quantiti:[0,1,3,4,5,6,8,9,10,11,14,16],quantum:11,quartil:1,quench:4,queri:8,question:[1,4,5,8,10,11,12],quick:16,quickli:[2,8,10,12],quirk:0,quit:[2,4,5,8,9,11],quot:16,r2_score:1,r2score:1,r_1:8,r_2:8,r_j:8,r_m:8,rad:1,radial:[1,7,11],radioact:16,radiu:[1,2],rag:3,rain:8,rais:12,ramp:2,ran1:16,ran2:16,ran3:16,rand:[1,4,5,8,9,12,14,16],rand_max:16,randint:[5,8,12],randn:[1,2,3,4,5,8,10,12],random:[0,1,2,3,4,5,7,8,12,13,14,15],random_devic:16,random_forest_model:9,random_index:12,random_indic:2,random_st:[1,6,7,8,9,10],randomforestclassifi:9,randomli:[0,2,5,8,12,16],randomnumbergener:16,rang:[0,1,2,3,4,5,6,8,9,10,11,12,14,16],rangl:[1,5,10,16],rangle_x:16,rank:4,raphson:[2,7,12],rapidli:1,rare:2,rate:[1,2,3,7,8,9,11,12],rather:[1,2,3,4,5,6,7,8,9,10,11,12,14,16],ratio:[6,8,9,10],rational:1,ravel:[4,5,6,7,8,9,10,12,14],raw:16,rbf:[7,10,11],rbf_kernel_svm_clf:7,rbf_pca:10,rcond:1,rcparam:[1,2,6,7,8,9,16],reach:[0,1,2,4,5,6,8,9,10,11,12,16],read:[0,1,3,4,5,6,7,10,11,14,15,16,18],read_csv:[1,5,6,8],read_fwf:1,readabl:0,reader:[1,5,14,16],readi:[0,1,2,4,5,7,9,10,11,14],readili:2,real:[1,2,6,9,10,11,12,14],realist:7,realiti:16,realiz:[2,11],realli:[1,2],rearrang:12,reason:[0,1,2,9,12,18],reassign:2,recal:[4,5,8,9,10,11,14,16],recalcul:16,receiv:[2,9,11,16],recent:[1,5,8,9,12],recept:11,recip:[1,5,6,14],reciproc:4,recogn:[1,4,9],recognit:[1,2,11,15,18],recommend:[1,3,4,5,7,12,13,14,15,16,18],reconsid:8,reconstruct:10,record:[9,15],recreat:16,rectangl:[8,12],rectangular:4,rectifi:[2,11],recur:[1,13],recurr:[1,2,13,15],recurs:[8,13,14],recycl:16,red:[1,5,7,8],redefin:[1,9],reduc:[2,4,5,8,9,10,12],reduct:[1,9,10,13,16],refer:[0,1,2,3,4,5,6,10,11,12,14,18],referenc:3,refin:11,refit:5,reflect:[1,2,4,16],refresh:[13,15],reg:[9,10],regard:[2,8,12],regardless:11,region:[5,8,11],regist:[5,16],reglasso:4,regr_1:[1,8],regr_2:[1,8],regr_3:[1,8],regress:[2,7,10,11,13,15],regressor:[1,6,9],regridg:[4,5],regular:[1,4,5,6,8,12],reilli:[1,18],reinforc:[1,7,13],reiter:2,rel:[1,5,6,8,11,12,16],relat:[0,1,2,4,10,12,14,16],relationship:[1,8],relativeerror:1,releas:[2,13],relev:[1,2,4,6,10,13,15,16],reli:[1,5,7],reliabl:[6,16],remain:[2,3,5,11,14,16],remaind:16,reman:3,remark:2,rememb:[1,7,12,14],remind:[1,4,10,12,14,16],remov:[1,4,5],render:1,reorder:[4,6],reorgan:1,repeat:[0,1,2,4,5,8,9,10,12,14,16],repeated:1,repeatedli:[5,9,12,16],repetit:[5,15],rephras:12,replac:[0,1,2,4,5,9,11,12],replica:5,repositori:1,repres:[1,2,3,4,5,6,7,8,9,11,12,16],represent:[1,2,5,16],reproduc:[1,4,5,8,11,13,16],repuls:1,request:1,requir:[1,2,4,5,7,8,10,11,12,14],res1:3,res2:3,res3:3,res:3,res_analyt:3,res_analytical1:3,res_analytical2:3,res_analytical3:3,resaml:5,resampl:[1,6,9,13,15,16],rescal:[1,10,11],rescu:4,reseach:5,research:[1,13,18],resembl:[5,16],reserv:[2,4,5,16],reset:16,reshap:[0,1,2,3,5,7,8,9,14],residenti:1,residu:[1,4,12],resiz:4,respect:[0,1,2,3,4,5,6,7,9,10,11,12,16],respond:11,respons:[1,6,8,11],rest:[1,4],restat:[1,11],restrict:[1,8,11],result:[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,16],ret:[],retail:1,retain:[4,5],return_data:0,return_x_i:8,reus:[2,5],reveal:[1,11],revers:[2,14],review:[13,14,15],revisit:0,reward:1,rewrit:[1,4,5,6,7,9,10,11,12,14,16],rewritten:[3,5,7,9,16],rewrot:12,rgoj5yh7evk:13,rho:[1,9],rho_1:9,rho_2:9,rho_m:9,rhs:[4,5],rich:1,rid:0,ride:8,rideclass:8,ridedata:8,ridg:[1,6,10,12,13,15],ridge_sk:5,ridgebeta:4,right:[1,2,3,4,5,6,7,8,9,11,12,14,16],right_sid:3,rightarrow:[1,2,4,5,7,10,11,12,16],rigor:1,ring:5,rise:1,risk:[1,12],river:1,rmse:1,rmsporp:12,rmsprop:[2,12],rnd_clf:9,rnn:[11,15],rntrick1:16,rntrick2:16,rntrick3:16,rntrick4:16,robert:18,robust:1,robustscal:1,roc:9,role:[1,3,4,5,7,13],roll:5,room:[1,17],root:[1,4,8,12,16],rot:[],rotat:[2,7,8,9],rotation_matrix:8,roughli:2,round:[1,6,8,12],routin:[12,14],row:[1,2,3,4,5,6,8,10,14],rrr:4,rthe:4,rug:12,rule:[1,2,4,5,12],run:[0,1,2,3,4,5,7,8,10,12,13],runtim:[0,2,5],runtimewarn:[2,5],rust:[1,13,14],rvert:2,rvert_2:2,rwidth:[],s_1:5,s_i:[5,6],s_j:5,s_k:5,saddl:12,safe:16,sai:[0,1,2,3,4,5,6,7,8,9,10,11,14,16],said:[5,8,12],sake:[1,4,6,10],sale:1,sam:[],same:[0,1,2,3,4,5,7,8,10,11,12,14,16],samm:9,sampl:[0,1,2,3,4,5,6,7,8,9,12,13,14],sample_vari:0,sampleexptvari:16,samwis:[],sanitize_sequ:[],sastri:10,satisfactori:1,satisfi:[2,3,5,7,12,14,16],satur:[2,5],save:[1,5,6,8],save_fig:[1,5,6,8,9],savefig:[1,5,6,8,16],saw:4,scalabl:9,scalar:[3,4,5,9,12],scale:[1,2,4,5,6,7,8,9,10,11,12,13,14,17],scaler:[1,6,7,8,9,10],scan:[4,6],scari:4,scatter:[0,1,2,5,6,7,8],scenario:[5,12],schedul:12,scheme:[2,12],schrage:16,scienc:[1,2,9,11,12,13,15,16,18],scientif:[1,13],scientist:[0,1],scikit:[4,5,6,7,8,9,12,13,14,15,18],scikitlearn:[],scikitplot:[6,9],scipi:[1,4,5,12,13,14],scl:5,score:[1,2,5,6,8,9,10,17],scores_kfold:5,scratch:2,sdg:12,seaborn:[1,2,5,6],seamless:[1,13],search:[1,2,4,8,12],sec:5,second:[0,1,3,4,5,6,7,8,10,11,12,13,14,15,16],secondeigvector:10,secondli:11,section:[0,10,14,15,16],sector:1,see:[0,1,2,3,4,5,6,7,9,10,11,12,13,14,15,16],seed:[0,1,2,3,4,5,7,8,10,12,16],seek:[2,3,7],seem:2,seemingli:1,seen:[1,2,4,9,11,16],segment:12,seismic:5,seldomli:1,select:[2,4,5,7,8,9,10,15,18],self:[2,4,16,18],semest:[6,15],semi:[7,12],semilogx:5,send:[4,11,12,17],senior:15,sens:[1,5,7],sensit:[1,4,5,8,12],sent:3,sentenc:11,separ:[0,1,2,3,5,7,8,11,13,16],sequenc:[0,3,6,8,9,11,12,13,14,16],sequenti:[2,9,11,16],seri:[1,2,3,4,5,9,10,11,12,14],serif:[1,6,16],serv:[1,2,3,4,6,12,18],session:[2,15],set:[0,2,4,5,6,7,9,10,12,13,14,16],set_:[],set_label:[],set_major_formatt:5,set_major_loc:5,set_stream:4,set_tick:[2,7],set_ticklabel:2,set_titl:[0,1,2,3,6,11],set_xlabel:[1,2,3,6,11],set_xlim:[6,11],set_xticklabel:2,set_ylabel:[1,2,3,6],set_ylim:[6,11],set_ytick:6,set_yticklabel:[2,5],set_zlim:5,setiosflag:16,setminu:5,setosa:[7,8],setosa_or_versicolor:7,setp:5,setprecis:16,setse:4,setup:[2,4,5,7,13],setw:16,sever:[1,4,5,6,7,8,10,11,12,13,14,15,16],sgd:[2,12],sgd_clf:7,sgdclassifi:7,sgdreg:12,sgdregressor:12,sgn:4,shallow:12,shape:[0,1,2,3,4,5,6,7,8,9,10,12,14],share:2,she:6,shift:[2,5,11,16],shire:[],shortcom:12,shorter:16,shorthand:[],shortli:14,should:[0,1,3,4,5,7,8,10,11,12,14],show:[0,1,2,3,4,5,6,7,8,9,10,11,12,14,16],shown:[1,4,6,7,10,11,12,16],showpoint:16,shrink:[4,5,7,10],shrinkag:[4,5],shrunk:10,shuffl:[1,2,5,12],side:[1,3,4,7,11,12,14],sigh:13,sigma0:16,sigma1:16,sigma2:16,sigma:[1,2,4,5,6,9,10,11,12,14,16],sigma_0:4,sigma_1:4,sigma_2:4,sigma_:[4,14,16],sigma_fn:[6,11],sigma_i:[1,4],sigma_j:4,sigma_m:[5,16],sigma_n:[10,16],sigma_t:12,sigma_x:16,sigmoid:[2,3,6,7,9,11],sigmundson:[5,17],sign:[2,3,6,7,9,16],signal:[2,9,11],signific:2,significantli:[2,12,16],sim:[4,5,12,16],similar:[0,1,2,3,4,5,6,7,8,9,10,12,13,14],similarli:[1,2,4,7,9,16],simpl:[0,2,3,4,5,6,7,9,10,11,13,14],simplepredict:9,simpler:[0,1,2,4,5,12,13],simplest:[0,1,2,8,9,11],simpletre:9,simpli:[1,2,3,4,5,7,8,9,10,11,13,14,16],simplic:[0,3,4,5,6,7,8,9,10,11],simplicti:4,simplifi:[1,5,8,13],simplist:[5,16],simul:[5,16],simultan:5,sin:[1,2,3,8,11,12,14],sinc:[1,2,3,4,5,6,7,8,9,10,12,14,16,18],sine:11,singl:[1,2,3,4,5,6,7,8,11,12,14,16],singular:[1,5,12,14,15],site:[1,2,3,5,6,7,10,12,15],situat:[1,4,6,12],six:16,size:[1,2,3,4,5,7,8,9,10,12,14,16],sketch:9,ski:8,skill:1,skip:10,skl:[1,5],sklearn:[1,2,4,5,6,7,8,9,10,12],skplt:[6,9],slack:7,slice:[3,14],slide:[1,16],slight:[5,12],slightli:[2,3,4,5,6,9,16],slope:[7,10,11],slow:[1,3,7,12],slower:[4,14],slowest:14,slowli:11,slp:2,small:[0,1,2,3,4,5,7,8,9,10,11,12,13,14,16],smaller:[1,2,3,4,5,7,8,10,12,16],smallest:[0,1],smallest_row_index:0,smart:[],smooth:[1,5,12],sne:10,sneak:[],sns:[1,2,5,6],soar:5,social:1,soft:[2,6,9,11],soften:7,softmax:6,softwar:[1,7,13,14,15],sol:7,sole:[1,5],solid:[1,6],solitem:4,soltyp:4,solut:[1,2,3,4,5,7,9,10,12,14,16],solutionsummari:4,soluton:3,solv:[1,2,4,5,7,9,10,11,12,14,15],solve_expdec:3,solve_ode_deep_neural_network:3,solve_ode_neural_network:3,solve_pde_deep_neural_network:3,solveod:3,solveode_popul:3,solver:[3,4,6,7,8,9,10,14],some:[0,1,2,3,4,5,6,7,8,9,10,11,14,15,16],some_model:5,someth:[1,2,6,8,10,16],sometim:[0,1,2,10,11,12],soon:14,sophist:1,sopt:12,sort:[4,5,8,10,16],sound:4,sourc:[0,1,2,5,13,14,16],space:[0,1,2,4,7,8,10,11,12,16],span:[1,4,8,10,14],spare:2,spars:[4,5,14],sparse_mtx:14,sparsiti:9,spatial:[2,3,11],spdiag:4,speak:16,special:[5,6,9,11,12,14,16],specif:[1,2,3,4,5,6,7,8,10,11,13,14,16],specifi:[0,1,4,5,6,8,10,12,16],specifici:[1,9],spectral:2,speech:[1,2,11],speed:[2,3,12],spend:16,sphere:1,spin:5,spite:1,spline:7,split:[0,2,4,5,7,8,9,10,16],splite:1,splitter:[2,9],spmatrix:4,spontan:16,spread:[1,10,16],springer:18,spuriou:12,sqquar:4,sqrt:[1,4,5,7,9,10,12,16],squar:[0,2,3,6,7,8,10,12,13,14,15,16],squarederror:9,squaredeuclidean:0,squash:11,srand:16,srtm:5,srtm_data_norway_1:5,stabil:4,stabl:[1,4,5,6,8,10,13],stack:[],stage:[4,12],stai:[1,3,4,10],stand:[1,4,8,11],standadscal:[],standard:[1,2,4,5,6,7,9,11,14],standardscal:[1,5,6,7,8,9,10],stanford:12,start:[0,1,2,3,4,5,7,8,9,10,11,12,14,15,16],start_box:12,start_nod:12,start_tim:0,startpoint:16,stat:5,state:[0,2,3,4,5,6,7,9,10,11,12,13,16],statement:[1,6,14],statis:[],statist:[0,1,2,6,8,9,10,11,12,14,15,18],statu:[1,6,10],stavang:5,std:[1,5,16],stdev:16,stdout:4,steep:12,step:[0,1,2,3,5,6,8,9,10,11,12,14,16],step_fn:[6,11],step_length:12,steps_list:8,stian:17,still:[3,4,5,10,12,16],stimuli:11,stk2100:18,stk3155:15,stk4021:18,stk4051:18,stk4155:15,stk5000:18,stk:18,stochast:[1,2,4,5,7,10,11,15],stoke:11,stone:[1,6],stop:[0,2,6,8,10,12,16],storag:4,store:[1,2,3,5,10,12,16],str:2,straight:[1,5,7,12],straightforward:[1,3,4,5,7,8,9,12,14],strategi:[1,2,8],stratifi:5,streamtyp:4,strength:[0,1,4],stretch:10,strict:[7,12],strictli:[7,12],stride:14,strike:5,string:[2,16],stroke:6,strong:[5,8,9,11,16],strongli:[1,7,13,14],stronli:1,structur:[0,1,2,3,5,8,9,11,13],stuck:[2,12],student:[1,15,17,18],studi:[0,1,4,5,6,7,10,11,12,13,18],studier:[15,18],style:[1,6,8,14],sub:[8,11],subarg:12,subdivid:[1,14],subfield:1,subject:[4,5,7,16],subplot:[0,1,2,5,6,7,8,9],subplots_adjust:[7,16],subprogram:14,subract:1,subroutin:1,subscript:2,subsequ:[2,4,5,11,14,16],subset:[2,5,8,11,12,13],subspac:[1,7,10],substanti:[8,9],substep:10,substitut:[5,11,14],subsubset:8,subtask:5,subtl:2,subtract:[1,4,5,10,12,14,16],subtre:8,subval:12,succeed:1,success:[6,8,12,16],successfulli:8,sucess:16,sudo:[1,13],suffer:[1,2,3,4,9],suffici:[2,5,7,10,12],suggest:[2,12,18],suit:[7,11],suitabl:[1,16],sum:[0,1,2,3,4,5,6,7,8,9,10,11,12,14,16],sum_:[0,1,2,3,4,5,6,7,8,9,10,11,12,14,16],sum_i:[3,4,5,7,12],sum_j:5,sum_k:[5,7,11,14],summar:[0,4,5,8],summari:[0,2,9,15],summat:[],sunni:8,superscript:[2,11],supervis:[1,4,5,6,8,11,13],supplement:6,support:[1,2,8,9,10,12,13,15],suppos:[1,4,5,6,7,9,10,11,12,14],suppress:[4,12],sure:[2,5],surf:5,surfac:[1,5],surpass:5,surpris:1,surround:13,survei:[1,4,5],svc:[7,8,9],svd:[1,5,10,15],svdinv:4,svm:[7,8,9,10],svm_clf:[7,9],swath:4,symbol:[2,4,10,12,13,16],symmeteri:2,symmetr:[1,4,7,10,11,12,14],symmetri:5,sympi:[1,13],synonim:16,syntax:[2,12,14],syntaxerror:[2,7,14],syrk:4,sys:[4,12],system:[1,2,4,5,6,8,9,11,12,13,14,18],systemat:[5,16],t_0:[3,8,12],t_1:12,t_b:9,t_i:[2,3,11],t_j:[4,11],t_k:8,tabl:[8,16,17],tabul:1,tabular:[],tackl:0,tag:[0,3,4,5,6,11,12,14,16],taht:1,tail:16,tailor:[3,7,10],taiwan:1,take:[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,16],taken:[1,2,5,9,12,14],tangent:[2,11,12],tanh:[2,6,7,11],target:[1,2,4,5,6,7,8,9,10,11],target_nam:8,task:[0,1,2,4,5,8,10,11],tau:[4,16],tax:1,taylor:[3,12],taylornr:12,team:2,teaser:1,technic:[0,1,4,5],techniqu:[1,2,7,9,12,13,15,16,18],technolog:[1,2],tek5040:18,tell:[1,5,9,10,12,16],temp1:2,temp2:2,temp:2,temperatur:[1,8],temporarili:2,ten:[],tend:[0,4,5,7,8,9,11,12],tendenc:1,tension:5,tensorflow:[0,1,3,7,13,14,15,18],term1:[4,5,10],term2:[4,5,10],term3:[4,5,10],term4:[4,5,10],term:[0,1,2,3,4,5,6,7,8,9,10,11,12,16],termin:[1,4,8,9,12],terrain1:5,terrain:5,test:[4,5,6,7,8,9,12,14,16],test_accuraci:2,test_data:0,test_error:5,test_ind:5,test_pr:2,test_predict:2,test_scor:[6,9],test_siz:[1,2,4,5,9],test_split:8,tester:[],testerror:[1,5],text:[1,2,3,4,7,8,10,12,14,16,18],textual:8,textur:2,than:[1,2,3,4,5,6,8,9,10,11,12,13,16],thank:5,thats:0,theano:[2,13],thei:[0,1,2,3,4,5,6,7,8,10,11,12,14,16],them:[1,2,5,7,8,9,10,11,12,14],theme:1,themselv:[1,16],thenc:5,theorem:[3,5,6],theoret:[1,9],theori:[1,2,7,8,11,12,13,15,18],thereaft:[1,4,5,10,11,14],therebi:[1,4,6,10,16],therefor:[1,2,3,5,6,7,10,12,16],therein:10,thereof:[1,5,12],theta:[2,12,16],theta_:[2,12],theta_i:2,theta_k:16,theta_linreg:12,theta_t:12,thi:[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,15,16,18],thing:[0,1,2,3,4,6,8,16],think:[0,1,2,5,8,11,12,16],third:[1,5,12],thirti:6,thorough:0,those:[0,4,5,7,8,9,10,14,15],though:[2,3,14,16],thought:[0,5,16],thousand:[1,2],three:[1,2,4,5,7,8,11,14,15,17],threshold:[2,8,9,10,11,12],through:[0,1,2,3,4,5,7,10,11,12,13,14,16],throughout:[0,1,4,13,14,16],thu:[1,2,3,4,5,6,7,9,10,11,12,16,17],thumb:[1,5],thursdai:15,tibshirani:[5,15,18],tick_param:5,ticker:[5,12,16],tif:5,tight_layout:[2,6],tightli:10,tild:[1,4,5,10,16],till:[1,6,7,8,9,11,14],time:[0,1,2,3,4,5,6,7,8,9,10,11,12,14,16],timefunct:16,tini:2,tip:[],titl:[1,2,3,5,6,7,8,9,12,16],tmp:12,to_categor:2,to_categorical_numpi:2,to_numer:[1,5],to_str:16,togeth:[1,5,7,10],toi:0,told:12,toler:[0,3,5],tomographi:11,too:[1,3,4,5,8,10,12,16,18],took:7,tool:[0,1,2,5,12,13,16],toolbox:7,top:[1,4,5,8,9,13],topic:[0,1,4,5,6,7,13,15,18],topolog:[2,11],toss:9,total:[0,1,2,3,5,6,7,9,10,11,12,14,16,17],totalclustervari:0,totalscatt:0,totalvari:16,toward:[2,3,6,11,12],town:1,tpng:8,tqdm:5,trace:12,trace_stack:12,traceback:[5,8,9,12],tracer:12,track:[0,12,14],tract:1,tractabl:1,trade:[4,8],tradeoff:[1,4,15],tradit:[1,2,5],train:[3,4,5,7,8,9,10,11,12],train_accuraci:[1,2],train_end:[1,2],train_error:5,train_ind:5,train_pr:2,train_siz:[1,2],train_test_split:[1,2,4,5,6,8,9,10],train_test_split_numpi:[1,2],trained_model:5,trainerror:1,trainingerror:5,trait:1,tran:4,transfer:8,transform:[1,4,5,6,7,8,9,10,11,12,13,14],transit:[5,11],translat:[2,5,9],transpos:[2,4,10,14],travers:[1,4],treat:[1,2,5,11,12,16],tree:[1,2,5,13,15],tree_clf:[8,9],tree_clf_:8,tree_clf_sr:8,tree_reg1:8,tree_reg2:8,tree_reg:8,trend:16,trevor:18,tri:[3,8,12],triain:1,trial:[1,3,5,12,16],triangl:12,triangular:14,trick:[7,10,12,16],trickier:16,tridiagon:14,trillion:13,trivial:[1,2,4,10,16],troubl:[1,7,11],true_beta:5,true_divid:2,true_fun:5,tucker:7,tumor:[6,8],tumour:6,tunabl:2,tune:[8,12,14],tupl:[3,12],turn:[1,2,4,5,6,7,8,9,10,11,12,14,16],tutori:2,tveito:3,tweak:[2,9,16],twice:12,twist:10,twister:16,two:[0,1,2,3,4,5,6,8,9,10,11,12,14,15,16,18],tx_1:12,type:[1,2,5,7,9,12,14,16],typeerror:12,typic:[1,2,3,4,6,8,9,11,12,16],u_i:11,u_m:9,ubuntu:[1,13],uci:1,uio:[15,17,18],unari:14,unary_f:12,unary_oper:12,unbalanc:[5,8],unbias:[1,4,5,16],uncent:5,uncertainti:[1,4],uncertitud:16,unchang:2,uncorrel:9,undefin:4,under:[1,2,4,5,9,12,13],underdetermin:1,underfit:[2,5],underflowproblem:4,undergo:4,undergradu:15,underli:[1,2,8,12,16],underset:0,understand:[0,1,2,4,5,9,12,13],understood:[0,7,12],undesir:7,undetermin:[4,7],unexpect:[5,16],unexpected:16,unfair:5,unfortun:[2,7,8,9],unicode_liter:[7,8],uniform:[1,2,4,5,10,12],uniform_real_distribut:16,uniformli:[12,16],unifrompdf:16,unimport:12,union:[4,5],uniqu:[0,1,3,5,12,14],unique_cluster_label:0,unit:[1,2,4,9,11,16],unitari:[4,5,14],unitarili:14,uniti:16,univari:16,univers:[1,2,3,12,15,17],unix:2,unknow:[1,14],unknown:[1,2,4,5,7,9,14],unknowwn:11,unlabel:2,unless:[1,5,10,12],unlik:[2,7,12,16],unnecessarili:8,unravel:2,unrol:10,unseen:[1,6,8],unstabl:2,unsupervis:[1,2,11,13,15],unsymmetr:14,until:[0,2,3,8,11,12,16],untouch:1,unusu:11,updat:[0,2,3,9,11,12],upload:[13,18],upon:[2,5,10,14],upper:[1,7,8,14],uppercas:[14,16],ups:[],usag:[1,7,13,16],usd10000:1,usd:1,use:[0,1,3,4,5,6,7,8,9,10,11,12,13,14,15],usecol:1,used:[0,1,2,3,4,5,7,8,9,10,11,12,13,14,16,18],useful:[1,2,4,5,6,8,10,11,12,13,14,16,18],useless:2,user:[1,2,3,5,6,7,10,13,14],userwarn:5,uses:[1,2,3,4,5,8,10,11,14,16],usetex:16,usg:5,using:[0,2,4,5,6,7,8,9,10,11,12,14],usr:16,usual:[0,1,6,11,12],util:[0,2,5,6,9],v_0:10,vale:3,valid:[1,2,6,8,9,12,13,15,16],valu:[0,1,2,3,5,6,7,8,9,11,12,13,14,15],valuat:8,valueerror:[],van:1,vandenbergh:[7,12],vandermond:1,vanilla:[1,5,10],vanish:[2,12,16],var_x:16,varabl:7,varepsilon:[4,5],varepsilon_:[4,5],varepsilon_i:[4,5],vari:[1,2,4,5,9],variabl:[0,1,2,3,4,5,6,7,9,10,11,12,14],varianc:[0,1,2,4,6,8,9,10,12,13,14,15],variance_i:[4,10],variance_x:[4,10],variant:[1,2,5,7,11,12],variat:10,varieti:[1,11,13],variou:[2,4,5,6,7,8,10,11,12,13,14,16],vartempvec:16,varvec:16,vaue:2,vault:1,vdot:[3,12],vec:[5,16],vector:[0,1,2,3,4,5,6,8,9,10,12,13,15],vector_mean:0,ventur:[1,7,13],verbos:2,veri:[0,1,2,3,4,5,6,7,8,9,10,11,12,16,18],verifi:[10,14],versatil:7,versicolor:[7,8],version:[0,1,9,12,13,14,16],versu:2,vert:[1,2,4,5,6,7,8,10,12],vert_1:[4,5],vert_2:[4,5,10],vertic:[],via:[1,4,5,6,7,8,9,10,11,13,14,15,16],vidal:10,video:[1,2,11,13,15],view:[2,4,5,11,12,15,16,18],violat:7,virginica:8,viridi:[1,2,3],virtual:2,viscos:12,viscou:12,visibledeprecationwarn:3,vision:1,visual:[1,10,11,13],visualis:2,viz:[5,7,16],vjp:12,vjpnode:12,vmax:[2,5],vmc:16,vmin:[2,5],volum:1,vote:9,voting_clf:9,votingclassifi:9,votingsimpl:9,vrtx:15,vspace:12,vstack:[4,10,14,16],w_1:[7,14],w_1x_1:7,w_1x_:7,w_2:[7,14],w_2x_2:7,w_2x_:7,w_3:14,w_4:14,w_hidden:3,w_i:[2,3,9],w_ix_i:11,w_j:14,w_m:14,w_output:3,w_px_:7,w_px_p:7,wai:[0,1,2,3,4,5,6,7,9,10,11,12,14,16],walk:8,walker:16,wang:1,want:[0,1,2,3,4,5,7,8,9,10,11,12,13,16],warn:[1,2,7],warrant:5,watch:13,wavelet:7,weak:[0,8,9],weather:[2,11],web:[13,15],webpag:15,websit:[5,14,15],wedg:[7,16],wednesdai:15,wee:10,week:[4,5,6],weekli:[13,18],weight:[1,2,3,5,6,8,9,11,12,16],weigth:3,welcom:[7,13],well:[1,2,3,4,5,6,7,8,9,11,12,13,14,15,16,18],went:7,were:[0,1,2,4,5,6,7,9,10,11,16],wessel:1,what:[0,2,3,4,5,6,7,8,9,10,11,12,13,14,15],when:[0,1,2,3,4,5,6,7,8,9,10,11,12,14,16],whenev:[12,16],where:[0,1,2,3,4,5,6,7,8,9,10,11,12,13,14,16,17],wherea:[5,16],wherein:[2,11],whether:[1,4,6,8,16],which:[0,1,3,4,5,6,7,8,9,10,11,12,13,14,15,17],whichev:2,white:8,who:[1,15],whole:[0,2,4,8,10],whose:[1,5,9,16],whow:[4,10],why:[1,2,5,12],wide:[1,2,5,6,11,13,14],widehat:5,width:[1,7,8],wieringen:1,win:9,wind:8,wing:17,winther:3,wiothout:5,wiscons:6,wisconsin:9,wisdom:5,wise:[1,2,4,11,12],wish:[0,1,3,4,6,7,10,12,14],with_std:1,wither:5,within:[0,1,3,6,8,11,12,16,18],withinclust:0,withmor:[],without:[1,2,4,5,7,8,10,11,12],won:1,wonder:7,word:[0,1,2,4,5,16],work:[0,1,2,5,6,7,8,12,13,15,16],world:[1,7],worldwid:1,wors:[1,2,5],worth:8,would:[1,2,4,5,6,7,8,9,10,11,12,14,16],wrap:[5,14,15],wrap_util:12,write:[1,2,3,4,5,6,7,11,12,14,16],written:[1,3,4,10,11,12,13,14,16],wrong:[2,7],wrongli:[9,16],wrote:[4,10],wrt:9,wth:9,www:[13,14,15,18],wx_1:7,x0s:7,x1_exampl:7,x1d:7,x1s:[7,8,9],x2d:[7,10],x2d_train:10,x2dsl:10,x2s:[7,8,9],x3s:7,x_0:[1,4,10,14],x_1:[1,3,4,5,6,7,8,9,10,12,14,16],x_2:[1,3,4,5,6,7,8,9,10,12,14,16],x_3:[7,14,16],x_4:14,x_center:10,x_data:2,x_data_ful:2,x_hidden:3,x_i:[0,1,2,3,4,5,6,7,8,9,10,11,12,14,16],x_input:3,x_ix_:1,x_iy_i:7,x_j:[1,3,7,8,11,16],x_jy_j:7,x_k:[0,11,14,16],x_l:16,x_m:[5,11,14,16],x_n:[1,3,5,7,10,11,12,14,16],x_new:[8,9],x_offset:5,x_output:3,x_p:[6,8],x_poli:8,x_poly10:8,x_prev:3,x_reduc:10,x_scale:7,x_test:[1,2,4,5,6,8,9,10],x_test_own:5,x_test_scal:[1,5,6,8,9,10],x_train:[1,2,4,5,6,8,9,10],x_train_mean:5,x_train_own:5,x_train_scal:[1,5,6,8,9,10],x_val:2,xarrai:13,xavier:2,xbnew:12,xcode:[1,13],xdclassiffierconfus:9,xdclassiffierroc:9,xg_clf:9,xgb:9,xgbclassifi:9,xgboost:8,xgboot:9,xgbregressor:9,xgparam:9,xgtree:9,xi_1:7,xi_:7,xi_i:7,xlabel:[1,2,3,4,5,6,7,8,9,12,16],xlim:[5,9],xmesh:12,xnew:[1,12],xpanda:1,xpd:[4,10],xplot:1,xscale:1,xsr:8,xt_x:12,xtest:5,xtick:[5,7,8],xtrain:5,xytext:7,y_0:[1,4,10,14],y_1:[1,4,7,8,10,12,14],y_1y_1:7,y_1y_1k:7,y_1y_2:7,y_1y_2k:7,y_1y_n:7,y_1y_nk:7,y_2:[1,4,7,8,10,14],y_2y_1:7,y_2y_1k:7,y_2y_2:7,y_2y_2k:7,y_3:[1,8,14],y_4:14,y_data:[1,2,4,5],y_data_ful:2,y_decis:7,y_fit:1,y_i:[1,2,4,5,6,7,8,9,10,11,12,14],y_if_:9,y_ix_:1,y_ix_i:[6,7,12],y_iy_jk:7,y_j:[5,7,11],y_k:11,y_m:14,y_model:[1,4,5],y_n:[7,12],y_ny_1:7,y_ny_1k:7,y_ny_2:7,y_ny_2k:7,y_ny_n:7,y_ny_nk:7,y_offset:5,y_plot:8,y_pred1:8,y_pred2:8,y_pred:[1,2,5,6,7,8,9],y_pred_rf:9,y_pred_tre:9,y_proba:[6,9],y_scaler:5,y_test:[1,2,4,5,6,8,9,10],y_test_onehot:2,y_test_predict:1,y_train:[1,2,4,5,6,8,9,10],y_train_mean:5,y_train_onehot:2,y_train_predict:1,y_train_scal:5,y_val:2,year:[1,13],yes:[5,6],yet:[1,2,5,7,10,12],yield:[0,1,3,4,5,7,9,11,12,14,16],ylabel:[1,2,3,4,5,6,7,8,9,12,16],ylim:5,ymesh:12,yoshua:[2,18],you:[0,1,2,3,4,5,7,8,9,10,12,13,14,16,18],young:1,your:[0,2,3,4,5,7,10,12,13,14,16],yourself:[10,12],youtub:13,ypred:5,ypredict2:12,ypredict:[1,12],ypredictlasso:4,ypredictol:4,ypredictown:5,ypredictownridg:5,ypredictridg:[4,5],ypredictskl:5,yridg:[],ytest:5,ytick:[5,7,8],ytild:[1,5],ytildelasso:4,ytildenp:1,ytildeol:4,ytildeownridg:5,ytilderidg:[4,5],ytrain:5,z_0:14,z_1:14,z_2:14,z_c:2,z_h:2,z_hidden:3,z_i:[2,11],z_j:[2,11],z_k:11,z_m:2,z_mod:8,z_o:2,z_output:3,zaman:16,zaxi:5,zero:[0,1,2,3,4,5,6,7,8,9,10,11,12,14,16],zip:[5,12],zm_h:1,zone:1},titles:["12. Clustering Analysis","3. Linear Regression","14. Building a Feed Forward Neural Network","15. Solving Differential Equations with Deep Learning","4. Ridge and Lasso Regression","5. Resampling Methods","6. Logistic Regression","8. Support Vector Machines, overarching aims","9. Decision trees, overarching aims","10. Ensemble Methods: From a Single Tree to Many Trees and Extreme Boosting, Meet the Jungle of Methods","11. Basic ideas of the Principal Component Analysis (PCA)","13. Neural networks","7. Optimization, the central part of any Machine Learning algortithm","Applied Data Analysis and Machine Learning, FYS-STK3155/4155 at the University of Oslo, Norway","2. Linear Algebra, Handling of Arrays and more Python Features","Teaching schedule with links to material","1. Elements of Probability Theory and Statistical Data Analysis","Teachers and Grading","Textbooks"],titleterms:{"2021":17,"4155":13,"case":[7,9,16],"final":11,"function":[1,2,5,6,7,9,10,11,12,16],"import":[4,14,16],And:[],Eye:9,FYS:13,Ising:5,ODE:3,OLS:[4,5],RMS:12,The:[0,1,2,3,4,5,6,7,8,10,11,13,16],Useful:13,Using:[3,12],activ:[2,11],actual:16,adaboost:9,adam:12,adapt:9,adding:5,adjust:2,again:8,aim:[7,8],algebra:14,algorithm:[0,8,9,10,11],algortithm:12,all:7,analys:4,analysi:[0,1,4,5,10,13,16],ani:12,anoth:8,appli:13,approach:[1,7],approxim:11,architectur:2,arrai:14,assist:17,august:15,autocorrel:16,autograd:3,automat:12,back:[2,10,11],background:13,bag:9,base:12,basic:[0,1,4,6,8,9,10,14],batch:2,bay:4,befor:10,better:[7,16],bia:5,binari:2,binomi:16,bird:9,block:16,book:[],boost:9,bootstrap:[5,9,16],boston:1,breast:2,brief:[],bring:11,build:[2,8],calcul:16,cancer:[2,6,8,10],cart:8,central:[12,13,16],chain:11,chang:9,chi:1,choos:2,classic:10,classif:[2,8,9],classifi:7,clip:2,cluster:0,code:[0,1,2,3,4,8,10,11,16],collect:2,compar:[3,9],complex:[1,5],complic:5,compon:10,comput:[8,16],con:8,concept:16,condit:[],conjug:12,content:[],continu:16,convex:[7,12],convolut:11,correl:[10,16],correspond:[],cost:[2,9],cours:[13,18],covari:[4,10,16],cross:5,cumul:16,cython:[],data:[1,2,5,6,8,10,13,16],dataset:2,decai:3,decemb:15,decis:[8,9],decomposit:[4,10,14],deep:[2,3],defin:2,definit:16,degre:1,demonstr:16,dens:1,deriv:[4,11],descent:[3,9,12],develop:2,deviat:16,diagon:10,dice:16,differ:7,differenti:[3,12],diffus:3,dimension:[3,7],disadvantag:8,discret:16,disguis:16,distribut:[4,16],doing:2,domain:16,down:2,dropout:2,economi:[],element:[1,16],elimin:14,ensembl:9,entropi:8,environ:1,equat:[1,3,11],error:[1,9],etc:[],euler:3,evalu:2,event:16,exampl:[1,2,3,5,6,7,8,9,16],exercis:[1,5],expect:16,experi:16,explor:1,exponenti:[3,16],express:[],extend:[],extrem:9,fall:17,famili:2,famou:16,fantast:[],featur:[8,14],feed:[2,11],fine:2,first:11,fit:[1,9],forest:9,forward:[2,3,11],frank:5,freedom:1,frequentist:1,fridai:[],from:[4,9,11],full:3,further:4,gaussian:[14,16],gener:[8,16],geometr:10,gini:8,good:1,grade:17,gradient:[2,3,9,12],growth:3,handl:14,has:13,hessian:[],hidden:3,homework:[],hous:1,how:16,hyperparamet:2,hyperplan:7,id3:8,idea:[0,10],ideal:[],implement:[2,16],implic:4,improv:2,increment:10,index:8,inform:17,input:3,instal:13,instructor:17,interpret:[4,10],introduc:10,introduct:[1,5,13,14],invers:[4,14],iter:9,its:16,jackknif:16,julia:[],jungl:9,jupyt:[],kera:2,kernel:[7,10],lagrangian:7,lasso:[4,5],later:4,layer:[2,3,11],learn:[1,2,3,10,12,13],least:[4,5],level:9,librari:13,likelihood:6,limit:[2,12,16],linear:[1,7,12,14],link:[4,10,15,18],logist:6,loss:[],machin:[1,7,12,13],main:16,make:[1,8,9],mani:[9,11],materi:15,math:4,mathemat:[4,7],matric:4,matrix:[2,4,10,11,14,16],matter:1,mean:[0,1,16],meet:[4,9,16],mercer:7,mersenn:16,method:[5,8,9,12,16],mlp:11,model:[1,2,5,11],moment:16,momentum:12,moon:[7,8],more:[0,5,14],multilay:11,multipl:2,multipli:7,name:16,need:[],network:[2,3,6,11],neural:[2,3,11],newton:[],non:7,normal:[1,2,16],norwai:13,notat:11,novemb:15,now:[2,8],nuclear:1,nueral:6,numba:[],number:[1,3,16],numer:[3,16],numpi:14,numpython:0,observ:16,obtain:10,octob:15,off:5,one:[3,11],oper:14,optim:[2,7,12,13],ordinari:[4,5],organ:1,oslo:[13,18],other:[8,10,11,14,16],our:[0,1,4,10,12,16],outcom:13,output:[3,16],overarch:[1,7,8],overview:9,own:[0,1,9,10],packag:14,panda:[],part:[12,13],partial:3,pass:2,pca:10,pdf:16,perceptron:11,perform:[2,8],period:16,perspect:2,poisson:[3,16],popul:3,practic:12,pre:2,preprocess:[],prerequisit:13,princip:10,pro:8,probabl:[4,16],problem:[2,3,12],procedur:8,process:2,program:[3,12],project:5,prop:12,propag:[2,11],properti:[4,16],pseudo:16,python:[0,1,8,13,14,16],quick:7,ran0:16,random:[9,10,16],raphson:[],read:8,real:5,recip:16,recurr:11,reduc:1,reformul:3,regress:[1,4,5,6,8,9,12],regular:2,relev:18,relu:2,remind:[5,7],requir:[3,13],resampl:5,rescal:5,resourc:3,revisit:12,ridg:[4,5],rng:16,rule:11,sampl:[10,16],schedul:15,schemat:8,scheme:3,scikit:[1,2,10],select:16,semest:17,sensit:[],septemb:15,set:[1,3,8,11],sgd:[],should:[2,16],simpl:[1,8,12,16],singl:9,singular:[4,10],situat:16,size:[],slightli:[],soft:7,softmax:2,softwar:[],solv:3,solver:12,some:12,specifi:3,split:1,squar:[1,4,5,9],standard:[12,16],state:1,statist:[4,5,13,16],steepest:[9,12],step:[],stk3155:13,stochast:[12,16],stop:[],supervis:2,support:7,svd:4,teach:[15,17],teacher:17,techniqu:[5,10],technolog:13,tensorflow:2,test:[1,2],textbook:18,than:[],theorem:[4,7,10,11,16],theori:16,three:16,tip:12,togeth:11,top:2,toss:16,toward:[0,10],trade:5,tradeoff:5,train:[1,2],tree:[8,9],tune:2,two:[7,13],type:[3,11],uncorrel:16,understand:[],uniform:16,univers:[11,13,18],use:[2,16],used:6,using:[1,3,16],valid:5,valu:[4,10,16],variabl:16,varianc:[5,16],variou:1,vector:[7,11,14],view:[1,9],visual:[2,8],wai:8,wave:3,week:15,weekli:15,what:[1,16],when:[],which:[2,16],why:16,wisconsin:6,write:[0,10],xgboost:9,your:[1,9]}}) \ No newline at end of file diff --git a/doc/LectureNotes/_build/html/statistics.html b/doc/LectureNotes/_build/html/statistics.html deleted file mode 100644 index 392e57d89..000000000 --- a/doc/LectureNotes/_build/html/statistics.html +++ /dev/null @@ -1,2423 +0,0 @@ - - - - - - - - 1. Elements of Probability Theory and Statistical Data Analysis — Applied Data Analysis and Machine Learning - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
- - - - - - - - -
- -
-
- -
- - - - - - - - - - - - - - -
- - -
- -
- Contents -
- -
-
-
-
-
- -
- -
-

1. Elements of Probability Theory and Statistical Data Analysis

-
-

1.1. Domains and probabilities

-

Consider the following simple example, namely the tossing of two dice, resulting in the following possible values

-
-\[ -\{2,3,4,5,6,7,8,9,10,11,12\}. -\]
-

These values are called the domain. -To this domain we have the corresponding probabilities

-
-\[ -\{1/36,2/36/,3/36,4/36,5/36,6/36,5/36,4/36,3/36,2/36,1/36\}. -\]
-
-
-

1.2. Tossing the dice

-

The numbers in the domain are the outcomes of the physical process of tossing say two dice. -We cannot tell beforehand whether the outcome is 3 or 5 or any other number in this domain. -This defines the randomness of the outcome, or unexpectedness or any other synonimous word which -encompasses the uncertitude of the final outcome.

-

The only thing we can tell beforehand -is that say the outcome 2 has a certain probability.
-If our favorite hobby is to spend an hour every evening throwing dice and -registering the sequence of outcomes, we will note that the numbers in the above domain

-
-\[ -\{2,3,4,5,6,7,8,9,10,11,12\}, -\]
-

appear in a random order. After 11 throws the results may look like

-
-\[ -\{10,8,6,3,6,9,11,8,12,4,5\}. -\]
-
-
-

1.3. Stochastic variables

-

Random variables are characterized by a domain which contains all possible values that the random value may take. This domain has a corresponding probability distribution function(PDF).

-
-
-

1.4. Stochastic variables and the main concepts, the discrete case

-

There are two main concepts associated with a stochastic variable. The -domain is the set \(\mathbb D = \{x\}\) of all accessible values -the variable can assume, so that \(X \in \mathbb D\). An example of a -discrete domain is the set of six different numbers that we may get by -throwing of a dice, \(x\in\{1,\,2,\,3,\,4,\,5,\,6\}\).

-

The probability distribution function (PDF) is a function -\(p(x)\) on the domain which, in the discrete case, gives us the -probability or relative frequency with which these values of \(X\) -occur

-
-\[ -p(x) = \mathrm{Prob}(X=x). -\]
-
-
-

1.5. Stochastic variables and the main concepts, the continuous case

-

In the continuous case, the PDF does not directly depict the -actual probability. Instead we define the probability for the -stochastic variable to assume any value on an infinitesimal interval -around \(x\) to be \(p(x)dx\). The continuous function \(p(x)\) then gives us -the density of the probability rather than the probability -itself. The probability for a stochastic variable to assume any value -on a non-infinitesimal interval \([a,\,b]\) is then just the integral

-
-\[ -\mathrm{Prob}(a\leq X\leq b) = \int_a^b p(x)dx. -\]
-

Qualitatively speaking, a stochastic variable represents the values of -numbers chosen as if by chance from some specified PDF so that the -selection of a large set of these numbers reproduces this PDF.

-
-
-

1.6. The cumulative probability

-

Of interest to us is the cumulative probability -distribution function (CDF), \(P(x)\), which is just the probability -for a stochastic variable \(X\) to assume any value less than \(x\)

-
-\[ -P(x)=\mathrm{Prob(}X\leq x\mathrm{)} = -\int_{-\infty}^x p(x^{\prime})dx^{\prime}. -\]
-

The relation between a CDF and its corresponding PDF is then

-
-\[ -p(x) = \frac{d}{dx}P(x). -\]
-
-
-

1.7. Properties of PDFs

-

There are two properties that all PDFs must satisfy. The first one is -positivity (assuming that the PDF is normalized)

-
-\[ -0 \leq p(x) \leq 1. -\]
-

Naturally, it would be nonsensical for any of the values of the domain -to occur with a probability greater than \(1\) or less than \(0\). Also, -the PDF must be normalized. That is, all the probabilities must add up -to unity. The probability of “anything” to happen is always unity. For -both discrete and continuous PDFs, this condition is

-
-\[\begin{split} -\begin{align*} -\sum_{x_i\in\mathbb D} p(x_i) & = 1,\\ -\int_{x\in\mathbb D} p(x)\,dx & = 1. -\end{align*} -\end{split}\]
-
-
-

1.8. Important distributions, the uniform distribution

-

The first one -is the most basic PDF; namely the uniform distribution

- -
-
-\[ -\begin{equation} -p(x) = \frac{1}{b-a}\theta(x-a)\theta(b-x). -\label{eq:unifromPDF} \tag{1} -\end{equation} -\]
-

For \(a=0\) and \(b=1\) we have

-
-\[ -\begin{array}{ll} -p(x)dx = dx & \in [0,1]. -\end{array} -\]
-

The latter distribution is used to generate random numbers. For other PDFs, one needs normally a mapping from this distribution to say for example the exponential distribution.

-
-
-

1.9. Gaussian distribution

-

The second one is the Gaussian Distribution

-
-\[ -p(x) = \frac{1}{\sigma\sqrt{2\pi}} \exp{(-\frac{(x-\mu)^2}{2\sigma^2})}, -\]
-

with mean value \(\mu\) and standard deviation \(\sigma\). If \(\mu=0\) and \(\sigma=1\), it is normally called the standard normal distribution

-
-\[ -p(x) = \frac{1}{\sqrt{2\pi}} \exp{(-\frac{x^2}{2})}, -\]
-

The following simple Python code plots the above distribution for different values of \(\mu\) and \(\sigma\).

-
-
-
%matplotlib inline
-
-import numpy as np
-from math import acos, exp, sqrt
-from  matplotlib import pyplot as plt
-from matplotlib import rc, rcParams
-import matplotlib.units as units
-import matplotlib.ticker as ticker
-rc('text',usetex=True)
-rc('font',**{'family':'serif','serif':['Gaussian distribution']})
-font = {'family' : 'serif',
-        'color'  : 'darkred',
-        'weight' : 'normal',
-        'size'   : 16,
-        }
-pi = acos(-1.0)
-mu0 = 0.0
-sigma0 = 1.0
-mu1= 1.0
-sigma1 = 2.0
-mu2 = 2.0
-sigma2 = 4.0
-
-x = np.linspace(-20.0, 20.0)
-v0 = np.exp(-(x*x-2*x*mu0+mu0*mu0)/(2*sigma0*sigma0))/sqrt(2*pi*sigma0*sigma0)
-v1 = np.exp(-(x*x-2*x*mu1+mu1*mu1)/(2*sigma1*sigma1))/sqrt(2*pi*sigma1*sigma1)
-v2 = np.exp(-(x*x-2*x*mu2+mu2*mu2)/(2*sigma2*sigma2))/sqrt(2*pi*sigma2*sigma2)
-plt.plot(x, v0, 'b-', x, v1, 'r-', x, v2, 'g-')
-plt.title(r'{\bf Gaussian distributions}', fontsize=20)
-plt.text(-19, 0.3, r'Parameters: $\mu = 0$, $\sigma = 1$', fontdict=font)
-plt.text(-19, 0.18, r'Parameters: $\mu = 1$, $\sigma = 2$', fontdict=font)
-plt.text(-19, 0.08, r'Parameters: $\mu = 2$, $\sigma = 4$', fontdict=font)
-plt.xlabel(r'$x$',fontsize=20)
-plt.ylabel(r'$p(x)$ [MeV]',fontsize=20)
-
-# Tweak spacing to prevent clipping of ylabel                                                                       
-plt.subplots_adjust(left=0.15)
-plt.savefig('gaussian.pdf', format='pdf')
-plt.show()
-
-
-
-
-_images/statistics_29_0.png -
-
-
-
-

1.10. Exponential distribution

-

Another important distribution in science is the exponential distribution

-
-\[ -p(x) = \alpha\exp{-(\alpha x)}. -\]
-
-
-

1.11. Expectation values

-

Let \(h(x)\) be an arbitrary continuous function on the domain of the stochastic -variable \(X\) whose PDF is \(p(x)\). We define the expectation value -of \(h\) with respect to \(p\) as follows

- -
-
-\[ -\begin{equation} -\langle h \rangle_X \equiv \int\! h(x)p(x)\,dx -\label{eq:expectation_value_of_h_wrt_p} \tag{2} -\end{equation} -\]
-

Whenever the PDF is known implicitly, like in this case, we will drop -the index \(X\) for clarity.
-A particularly useful class of special expectation values are the -moments. The \(n\)-th moment of the PDF \(p\) is defined as -follows

-
-\[ -\langle x^n \rangle \equiv \int\! x^n p(x)\,dx -\]
-
-
-

1.12. Stochastic variables and the main concepts, mean values

-

The zero-th moment \(\langle 1\rangle\) is just the normalization condition of -\(p\). The first moment, \(\langle x\rangle\), is called the mean of \(p\) -and often denoted by the letter \(\mu\)

-
-\[ -\langle x\rangle = \mu \equiv \int x p(x)dx, -\]
-

for a continuous distribution and

-
-\[ -\langle x\rangle = \mu \equiv \sum_{i=1}^N x_i p(x_i), -\]
-

for a discrete distribution. -Qualitatively it represents the centroid or the average value of the -PDF and is therefore simply called the expectation value of \(p(x)\).

-
-
-

1.13. Stochastic variables and the main concepts, central moments, the variance

-

A special version of the moments is the set of central moments, the n-th central moment defined as

-
-\[ -\langle (x-\langle x\rangle )^n\rangle \equiv \int\! (x-\langle x\rangle)^n p(x)\,dx -\]
-

The zero-th and first central moments are both trivial, equal \(1\) and -\(0\), respectively. But the second central moment, known as the -variance of \(p\), is of particular interest. For the stochastic -variable \(X\), the variance is denoted as \(\sigma^2_X\) or \(\mathrm{Var}(X)\)

-
-\[\begin{split} -\begin{align*} -\sigma^2_X &=\mathrm{Var}(X) = \langle (x-\langle x\rangle)^2\rangle = -\int (x-\langle x\rangle)^2 p(x)dx\\ -& = \int\left(x^2 - 2 x \langle x\rangle^{2} +\langle x\rangle^2\right)p(x)dx\\ -& = \langle x^2\rangle - 2 \langle x\rangle\langle x\rangle + \langle x\rangle^2\\ -& = \langle x^2 \rangle - \langle x\rangle^2 -\end{align*} -\end{split}\]
-

The square root of the variance, \(\sigma =\sqrt{\langle (x-\langle x\rangle)^2\rangle}\) is called the -standard deviation of \(p\). It is the RMS (root-mean-square) -value of the deviation of the PDF from its mean value, interpreted -qualitatively as the “spread” of \(p\) around its mean.

-
-
-

1.14. Probability Distribution Functions

-

The following table collects properties of probability distribution functions. -In our notation we reserve the label \(p(x)\) for the probability of a certain event, -while \(P(x)\) is the cumulative probability.

- - - - - - - - - - - - - -
Discrete PDF Continuous PDF
Domain $\left\{x_1, x_2, x_3, \dots, x_N\right\}$ $[a,b]$
Probability $p(x_i)$ $p(x)dx$
Cumulative $P_i=\sum_{l=1}^ip(x_l)$ $P(x)=\int_a^xp(t)dt$
Positivity $0 \le p(x_i) \le 1$ $p(x) \ge 0$
Positivity $0 \le P_i \le 1$ $0 \le P(x) \le 1$
Monotonic $P_i \ge P_j$ if $x_i \ge x_j$ $P(x_i) \ge P(x_j)$ if $x_i \ge x_j$
Normalization $P_N=1$ $P(b)=1$
-
-
-

1.15. Probability Distribution Functions

-

With a PDF we can compute expectation values of selected quantities such as

-
-\[ -\langle x^k\rangle=\sum_{i=1}^{N}x_i^kp(x_i), -\]
-

if we have a discrete PDF or

-
-\[ -\langle x^k\rangle=\int_a^b x^kp(x)dx, -\]
-

in the case of a continuous PDF. We have already defined the mean value \(\mu\) -and the variance \(\sigma^2\).

-
-
-

1.16. The three famous Probability Distribution Functions

-

There are at least three PDFs which one may encounter. These are the

-

Uniform distribution

-
-\[ -p(x)=\frac{1}{b-a}\Theta(x-a)\Theta(b-x), -\]
-

yielding probabilities different from zero in the interval \([a,b]\).

-

The exponential distribution

-
-\[ -p(x)=\alpha \exp{(-\alpha x)}, -\]
-

yielding probabilities different from zero in the interval \([0,\infty)\) and with mean value

-
-\[ -\mu = \int_0^{\infty}xp(x)dx=\int_0^{\infty}x\alpha \exp{(-\alpha x)}dx=\frac{1}{\alpha}, -\]
-

with variance

-
-\[ -\sigma^2=\int_0^{\infty}x^2p(x)dx-\mu^2 = \frac{1}{\alpha^2}. -\]
-
-
-

1.17. Probability Distribution Functions, the normal distribution

-

Finally, we have the so-called univariate normal distribution, or just the normal distribution

-
-\[ -p(x)=\frac{1}{b\sqrt{2\pi}}\exp{\left(-\frac{(x-a)^2}{2b^2}\right)} -\]
-

with probabilities different from zero in the interval \((-\infty,\infty)\). -The integral \(\int_{-\infty}^{\infty}\exp{\left(-(x^2\right)}dx\) appears in many calculations, its value -is \(\sqrt{\pi}\), a result we will need when we compute the mean value and the variance. -The mean value is

-
-\[ -\mu = \int_0^{\infty}xp(x)dx=\frac{1}{b\sqrt{2\pi}}\int_{-\infty}^{\infty}x \exp{\left(-\frac{(x-a)^2}{2b^2}\right)}dx, -\]
-

which becomes with a suitable change of variables

-
-\[ -\mu =\frac{1}{b\sqrt{2\pi}}\int_{-\infty}^{\infty}b\sqrt{2}(a+b\sqrt{2}y)\exp{-y^2}dy=a. -\]
-
-
-

1.18. Probability Distribution Functions, the normal distribution

-

Similarly, the variance becomes

-
-\[ -\sigma^2 = \frac{1}{b\sqrt{2\pi}}\int_{-\infty}^{\infty}(x-\mu)^2 \exp{\left(-\frac{(x-a)^2}{2b^2}\right)}dx, -\]
-

and inserting the mean value and performing a variable change we obtain

-
-\[ -\sigma^2 = \frac{1}{b\sqrt{2\pi}}\int_{-\infty}^{\infty}b\sqrt{2}(b\sqrt{2}y)^2\exp{\left(-y^2\right)}dy= -\frac{2b^2}{\sqrt{\pi}}\int_{-\infty}^{\infty}y^2\exp{\left(-y^2\right)}dy, -\]
-

and performing a final integration by parts we obtain the well-known result \(\sigma^2=b^2\). -It is useful to introduce the standard normal distribution as well, defined by \(\mu=a=0\), viz. a distribution -centered around zero and with a variance \(\sigma^2=1\), leading to

- -
-
-\[ -\begin{equation} - p(x)=\frac{1}{\sqrt{2\pi}}\exp{\left(-\frac{x^2}{2}\right)}. -\label{_auto1} \tag{3} -\end{equation} -\]
-
-
-

1.19. Probability Distribution Functions, the cumulative distribution

-

The exponential and uniform distributions have simple cumulative functions, -whereas the normal distribution does not, being proportional to the so-called -error function \(erf(x)\), given by

-
-\[ -P(x) = \frac{1}{\sqrt{2\pi}}\int_{-\infty}^x\exp{\left(-\frac{t^2}{2}\right)}dt, -\]
-

which is difficult to evaluate in a quick way.

-
-
-

1.20. Probability Distribution Functions, other important distribution

-

Some other PDFs which one encounters often in the natural sciences are the binomial distribution

-
-\[\begin{split} -p(x) = \left(\begin{array}{c} n \\ x\end{array}\right)y^x(1-y)^{n-x} \hspace{0.5cm}x=0,1,\dots,n, -\end{split}\]
-

where \(y\) is the probability for a specific event, such as the tossing of a coin or moving left or right -in case of a random walker. Note that \(x\) is a discrete stochastic variable.

-

The sequence of binomial trials is characterized by the following definitions

-
    -
  • Every experiment is thought to consist of \(N\) independent trials.

  • -
  • In every independent trial one registers if a specific situation happens or not, such as the jump to the left or right of a random walker.

  • -
  • The probability for every outcome in a single trial has the same value, for example the outcome of tossing (either heads or tails) a coin is always \(1/2\).

  • -
-
-
-

1.21. Probability Distribution Functions, the binomial distribution

-

In order to compute the mean and variance we need to recall Newton’s binomial -formula

-
-\[\begin{split} -(a+b)^m=\sum_{n=0}^m \left(\begin{array}{c} m \\ n\end{array}\right)a^nb^{m-n}, -\end{split}\]
-

which can be used to show that

-
-\[\begin{split} -\sum_{x=0}^n\left(\begin{array}{c} n \\ x\end{array}\right)y^x(1-y)^{n-x} = (y+1-y)^n = 1, -\end{split}\]
-

the PDF is normalized to one. -The mean value is

-
-\[\begin{split} -\mu = \sum_{x=0}^n x\left(\begin{array}{c} n \\ x\end{array}\right)y^x(1-y)^{n-x} = -\sum_{x=0}^n x\frac{n!}{x!(n-x)!}y^x(1-y)^{n-x}, -\end{split}\]
-

resulting in

-
-\[ -\mu = -\sum_{x=0}^n x\frac{(n-1)!}{(x-1)!(n-1-(x-1))!}y^{x-1}(1-y)^{n-1-(x-1)}, -\]
-

which we rewrite as

-
-\[\begin{split} -\mu=ny\sum_{\nu=0}^n\left(\begin{array}{c} n-1 \\ \nu\end{array}\right)y^{\nu}(1-y)^{n-1-\nu} =ny(y+1-y)^{n-1}=ny. -\end{split}\]
-

The variance is slightly trickier to get. It reads \(\sigma^2=ny(1-y)\).

-
-
-

1.22. Probability Distribution Functions, Poisson’s distribution

-

Another important distribution with discrete stochastic variables \(x\) is
-the Poisson model, which resembles the exponential distribution and reads

-
-\[ -p(x) = \frac{\lambda^x}{x!} e^{-\lambda} \hspace{0.5cm}x=0,1,\dots,;\lambda > 0. -\]
-

In this case both the mean value and the variance are easier to calculate,

-
-\[ -\mu = \sum_{x=0}^{\infty} x \frac{\lambda^x}{x!} e^{-\lambda} = \lambda e^{-\lambda}\sum_{x=1}^{\infty} -\frac{\lambda^{x-1}}{(x-1)!}=\lambda, -\]
-

and the variance is \(\sigma^2=\lambda\).

-
-
-

1.23. Probability Distribution Functions, Poisson’s distribution

-

An example of applications of the Poisson distribution could be the counting -of the number of \(\alpha\)-particles emitted from a radioactive source in a given time interval. -In the limit of \(n\rightarrow \infty\) and for small probabilities \(y\), the binomial distribution -approaches the Poisson distribution. Setting \(\lambda = ny\), with \(y\) the probability for an event in -the binomial distribution we can show that

-
-\[\begin{split} -\lim_{n\rightarrow \infty}\left(\begin{array}{c} n \\ x\end{array}\right)y^x(1-y)^{n-x} e^{-\lambda}=\sum_{x=1}^{\infty}\frac{\lambda^x}{x!} e^{-\lambda}. -\end{split}\]
-
-
-

1.24. Meet the covariance!

-

An important quantity in a statistical analysis is the so-called covariance.

-

Consider the set \(\{X_i\}\) of \(n\) -stochastic variables (not necessarily uncorrelated) with the -multivariate PDF \(P(x_1,\dots,x_n)\). The covariance of two -of the stochastic variables, \(X_i\) and \(X_j\), is defined as follows

- -
-
-\[ -\begin{equation} -\mathrm{Cov}(X_i,\,X_j) = \langle (x_i-\langle x_i\rangle)(x_j-\langle x_j\rangle)\rangle -\label{_auto2} \tag{4} -\end{equation} -\]
- -
-
-\[ -\begin{equation} -=\int\cdots\int (x_i-\langle x_i\rangle)(x_j-\langle x_j\rangle)P(x_1,\dots,x_n)\,dx_1\dots dx_n, -\label{eq:def_covariance} \tag{5} -\end{equation} -\]
-

with

-
-\[ -\langle x_i\rangle = -\int\cdots\int x_i P(x_1,\dots,x_n)\,dx_1\dots dx_n. -\]
-
-
-

1.25. Meet the covariance in matrix disguise

-

If we consider the above covariance as a matrix

-
-\[ -C_{ij} =\mathrm{Cov}(X_i,\,X_j), -\]
-

then the diagonal elements are just the familiar -variances, \(C_{ii} = \mathrm{Cov}(X_i,\,X_i) = \mathrm{Var}(X_i)\). It turns out that -all the off-diagonal elements are zero if the stochastic variables are -uncorrelated.

-
-
-

1.26. Covariance

-
-
-
# Importing various packages
-from math import exp, sqrt
-from random import random, seed
-import numpy as np
-import matplotlib.pyplot as plt
-
-def covariance(x, y, n):
-    sum = 0.0
-    mean_x = np.mean(x)
-    mean_y = np.mean(y)
-    for i in range(0, n):
-        sum += (x[(i)]-mean_x)*(y[i]-mean_y)
-    return  sum/n
-
-n = 10
-
-x=np.random.normal(size=n)
-y = 4+3*x+np.random.normal(size=n)
-covxy = covariance(x,y,n)
-print(covxy)
-z = np.vstack((x, y))
-c = np.cov(z.T)
-
-print(c)
-
-
-
-
-
2.4890704720929593
-[[11.60990408  7.82544198 14.11622885  1.78979284  6.76376813 14.09060397
-  14.04624055  3.77253612  5.11082097 14.99821162]
- [ 7.82544198  5.27459502  9.51478402  1.20637689  4.55899331  9.49751204
-   9.4676097   2.54280848  3.44485473 10.10926826]
- [14.11622885  9.51478402 17.16361442  2.17617003  8.22391797 17.13245767
-  17.07851716  4.58694429  6.21413561 18.23599801]
- [ 1.78979284  1.20637689  2.17617003  0.27591601  1.04270833  2.17221967
-   2.16538057  0.58157742  0.78788857  2.31213725]
- [ 6.76376813  4.55899331  8.22391797  1.04270833  3.94047694  8.20898927
-   8.18314376  2.19782691  2.97749299  8.73774883]
- [14.09060397  9.49751204 17.13245767  2.17221967  8.20898927 17.10135749
-  17.04751489  4.57861771  6.20285522 18.20289459]
- [14.04624055  9.4676097  17.07851716  2.16538057  8.18314376 17.04751489
-  16.99384182  4.56420221  6.18332591 18.14558387]
- [ 3.77253612  2.54280848  4.58694429  0.58157742  2.19782691  4.57861771
-   4.56420221  1.2258524   1.66071628  4.87353683]
- [ 5.11082097  3.44485473  6.21413561  0.78788857  2.97749299  6.20285522
-   6.18332591  1.66071628  2.24984554  6.60239515]
- [14.99821162 10.10926826 18.23599801  2.31213725  8.73774883 18.20289459
-  18.14558387  4.87353683  6.60239515 19.37538418]]
-
-
-
-
-
-
-

1.27. Meet the covariance, uncorrelated events

-

Consider the stochastic variables \(X_i\) and \(X_j\), (\(i\neq j\)). We have

-
-\[\begin{split} -\begin{align*} -Cov(X_i,\,X_j) &= \langle (x_i-\langle x_i\rangle)(x_j-\langle x_j\rangle)\rangle\\ -&=\langle x_i x_j - x_i\langle x_j\rangle - \langle x_i\rangle x_j + \langle x_i\rangle\langle x_j\rangle\rangle\\ -&=\langle x_i x_j\rangle - \langle x_i\langle x_j\rangle\rangle - \langle \langle x_i\rangle x_j \rangle + -\langle \langle x_i\rangle\langle x_j\rangle\rangle \\ -&=\langle x_i x_j\rangle - \langle x_i\rangle\langle x_j\rangle - \langle x_i\rangle\langle x_j\rangle + -\langle x_i\rangle\langle x_j\rangle \\ -&=\langle x_i x_j\rangle - \langle x_i\rangle\langle x_j\rangle -\end{align*} -\end{split}\]
-

If \(X_i\) and \(X_j\) are independent (assuming \(i \neq j\)), we have that

-
-\[ -\langle x_i x_j\rangle = \langle x_i\rangle\langle x_j\rangle, -\]
-

leading to

-
-\[ -Cov(X_i, X_j) = 0 \hspace{0.1cm} (i\neq j). -\]
-
-
-

1.28. Numerical experiments and the covariance

-

Now that we have constructed an idealized mathematical framework, let -us try to apply it to empirical observations. Examples of relevant -physical phenomena may be spontaneous decays of nuclei, or a purely -mathematical set of numbers produced by some deterministic -mechanism. It is the latter we will deal with, using so-called pseudo-random -number generators. In general our observations will contain only a limited set of -observables. We remind the reader that -a stochastic process is a process that produces sequentially a -chain of values

-
-\[ -\{x_1, x_2,\dots\,x_k,\dots\}. -\]
-
-
-

1.29. Numerical experiments and the covariance

-

We will call these -values our measurements and the entire set as our measured -sample. The action of measuring all the elements of a sample -we will call a stochastic experiment (since, operationally, -they are often associated with results of empirical observation of -some physical or mathematical phenomena; precisely an experiment). We -assume that these values are distributed according to some -PDF \(p_X^{\phantom X}(x)\), where \(X\) is just the formal symbol for the -stochastic variable whose PDF is \(p_X^{\phantom X}(x)\). Instead of -trying to determine the full distribution \(p\) we are often only -interested in finding the few lowest moments, like the mean -\(\mu_X^{\phantom X}\) and the variance \(\sigma_X^{\phantom X}\).

-
-
-

1.30. Numerical experiments and the covariance, actual situations

-

In practical situations however, a sample is always of finite size. Let that -size be \(n\). The expectation value of a sample \(\alpha\), the sample mean, is then defined as follows

-
-\[ -\langle x_{\alpha} \rangle \equiv \frac{1}{n}\sum_{k=1}^n x_{\alpha,k}. -\]
-

The sample variance is:

-
-\[ -\mathrm{Var}(x) \equiv \frac{1}{n}\sum_{k=1}^n (x_{\alpha,k} - \langle x_{\alpha} \rangle)^2, -\]
-

with its square root being the standard deviation of the sample.

-
-
-

1.31. Numerical experiments and the covariance, our observables

-

You can think of the above observables as a set of quantities which define -a given experiment. This experiment is then repeated several times, say \(m\) times. -The total average is then

- -
-
-\[ -\begin{equation} -\langle X_m \rangle= \frac{1}{m}\sum_{\alpha=1}^mx_{\alpha}=\frac{1}{mn}\sum_{\alpha, k} x_{\alpha,k}, -\label{eq:exptmean} \tag{6} -\end{equation} -\]
-

where the last sums end at \(m\) and \(n\). -The total variance is

-
-\[ -\sigma^2_m= \frac{1}{mn^2}\sum_{\alpha=1}^m(\langle x_{\alpha} \rangle-\langle X_m \rangle)^2, -\]
-

which we rewrite as

- -
-
-\[ -\begin{equation} -\sigma^2_m=\frac{1}{m}\sum_{\alpha=1}^m\sum_{kl=1}^n (x_{\alpha,k}-\langle X_m \rangle)(x_{\alpha,l}-\langle X_m \rangle). -\label{eq:exptvariance} \tag{7} -\end{equation} -\]
-
-
-

1.32. Numerical experiments and the covariance, the sample variance

-

We define also the sample variance \(\sigma^2\) of all \(mn\) individual experiments as

- -
-
-\[ -\begin{equation} -\sigma^2=\frac{1}{mn}\sum_{\alpha=1}^m\sum_{k=1}^n (x_{\alpha,k}-\langle X_m \rangle)^2. -\label{eq:sampleexptvariance} \tag{8} -\end{equation} -\]
-

These quantities, being known experimental values or the results from our calculations, -may differ, in some cases -significantly, from the similarly named -exact values for the mean value \(\mu_X\), the variance \(\mathrm{Var}(X)\) -and the covariance \(\mathrm{Cov}(X,Y)\).

-
-
-

1.33. Numerical experiments and the covariance, central limit theorem

-

The central limit theorem states that the PDF \(\tilde{p}(z)\) of -the average of \(m\) random values corresponding to a PDF \(p(x)\) -is a normal distribution whose mean is the -mean value of the PDF \(p(x)\) and whose variance is the variance -of the PDF \(p(x)\) divided by \(m\), the number of values used to compute \(z\).

-

The central limit theorem leads then to the well-known expression for the -standard deviation, given by

-
-\[ -\sigma_m= -\frac{\sigma}{\sqrt{m}}. -\]
-

In many cases the above estimate for the standard deviation, in particular if correlations are strong, may be too simplistic. We need therefore a more precise defintion of the error and the variance in our results.

-
-
-

1.34. Definition of Correlation Functions and Standard Deviation

-

Our estimate of the true average \(\mu_{X}\) is the sample mean \(\langle X_m \rangle\)

-
-\[ -\mu_{X}^{\phantom X} \approx X_m=\frac{1}{mn}\sum_{\alpha=1}^m\sum_{k=1}^n x_{\alpha,k}. -\]
-

We can then use Eq. (7)

-
-\[ -\sigma^2_m=\frac{1}{mn^2}\sum_{\alpha=1}^m\sum_{kl=1}^n (x_{\alpha,k}-\langle X_m \rangle)(x_{\alpha,l}-\langle X_m \rangle), -\]
-

and rewrite it as

-
-\[ -\sigma^2_m=\frac{\sigma^2}{n}+\frac{2}{mn^2}\sum_{\alpha=1}^m\sum_{k<l}^n (x_{\alpha,k}-\langle X_m \rangle)(x_{\alpha,l}-\langle X_m \rangle), -\]
-

where the first term is the sample variance of all \(mn\) experiments divided by \(n\) -and the last term is nothing but the covariance which arises when \(k\ne l\).

-
-
-

1.35. Definition of Correlation Functions and Standard Deviation

-

Our estimate of the true average \(\mu_{X}\) is the sample mean \(\langle X_m \rangle\)

-

If the -observables are uncorrelated, then the covariance is zero and we obtain a total variance -which agrees with the central limit theorem. Correlations may often be present in our data set, resulting in a non-zero covariance. The first term is normally called the uncorrelated -contribution. -Computationally the uncorrelated first term is much easier to treat -efficiently than the second. -We just accumulate separately the values \(x^2\) and \(x\) for every -measurement \(x\) we receive. The correlation term, though, has to be -calculated at the end of the experiment since we need all the -measurements to calculate the cross terms. Therefore, all measurements -have to be stored throughout the experiment.

-
-
-

1.36. Definition of Correlation Functions and Standard Deviation

-

Let us analyze the problem by splitting up the correlation term into -partial sums of the form

-
-\[ -f_d = \frac{1}{nm}\sum_{\alpha=1}^m\sum_{k=1}^{n-d}(x_{\alpha,k}-\langle X_m \rangle)(x_{\alpha,k+d}-\langle X_m \rangle), -\]
-

The correlation term of the total variance can now be rewritten in terms of -\(f_d\)

-
-\[ -\frac{2}{mn^2}\sum_{\alpha=1}^m\sum_{k<l}^n (x_{\alpha,k}-\langle X_m \rangle)(x_{\alpha,l}-\langle X_m \rangle)= -\frac{2}{n}\sum_{d=1}^{n-1} f_d -\]
-
-
-

1.37. Definition of Correlation Functions and Standard Deviation

-

The value of \(f_d\) reflects the correlation between measurements -separated by the distance \(d\) in the samples. Notice that for -\(d=0\), \(f\) is just the sample variance, \(\sigma^2\). If we divide \(f_d\) -by \(\sigma^2\), we arrive at the so called autocorrelation function

- -
-
-\[ -\begin{equation} -\kappa_d = \frac{f_d}{\sigma^2} -\label{eq:autocorrelformal} \tag{9} -\end{equation} -\]
-

which gives us a useful measure of the correlation pair correlation -starting always at \(1\) for \(d=0\).

-
-
-

1.38. Definition of Correlation Functions and Standard Deviation, sample variance

-

The sample variance of the \(mn\) experiments can now be -written in terms of the autocorrelation function

- -
-
-\[ -\begin{equation} -\sigma_m^2=\frac{\sigma^2}{n}+\frac{2}{n}\cdot\sigma^2\sum_{d=1}^{n-1} -\frac{f_d}{\sigma^2}=\left(1+2\sum_{d=1}^{n-1}\kappa_d\right)\frac{1}{n}\sigma^2=\frac{\tau}{n}\cdot\sigma^2 -\label{eq:error_estimate_corr_time} \tag{10} -\end{equation} -\]
-

and we see that \(\sigma_m\) can be expressed in terms of the -uncorrelated sample variance times a correction factor \(\tau\) which -accounts for the correlation between measurements. We call this -correction factor the autocorrelation time

- -
-
-\[ -\begin{equation} -\tau = 1+2\sum_{d=1}^{n-1}\kappa_d -\label{eq:autocorrelation_time} \tag{11} -\end{equation} -\]
- - -

For a correlation free experiment, \(\tau\) -equals 1.

-
-
-

1.39. Definition of Correlation Functions and Standard Deviation

-

From the point of view of -Eq. (10) we can interpret a sequential -correlation as an effective reduction of the number of measurements by -a factor \(\tau\). The effective number of measurements becomes

-
-\[ -n_\mathrm{eff} = \frac{n}{\tau} -\]
-

To neglect the autocorrelation time \(\tau\) will always cause our -simple uncorrelated estimate of \(\sigma_m^2\approx \sigma^2/n\) to -be less than the true sample error. The estimate of the error will be -too “good”. On the other hand, the calculation of the full -autocorrelation time poses an efficiency problem if the set of -measurements is very large. The solution to this problem is given by -more practically oriented methods like the blocking technique.

- -
-
-

1.40. Code to compute the Covariance matrix and the Covariance

-
-
-
# Importing various packages
-from math import exp, sqrt
-from random import random, seed
-import numpy as np
-import matplotlib.pyplot as plt
-
-# Sample covariance, note the factor 1/(n-1)
-def covariance(x, y, n):
-    sum = 0.0
-    mean_x = np.mean(x)
-    mean_y = np.mean(y)
-    for i in range(0, n):
-        sum += (x[(i)]-mean_x)*(y[i]-mean_y)
-    return  sum/(n-1.)
-
-n = 100
-x = np.random.normal(size=n)
-print(np.mean(x))
-y = 4+3*x+np.random.normal(size=n)
-print(np.mean(y))
-z = x**3+np.random.normal(size=n)
-print(np.mean(z))
-covxx = covariance(x,x,n)
-covyy = covariance(y,y,n)
-covzz = covariance(z,z,n)
-covxy = covariance(x,y,n)
-covxz = covariance(x,z,n)
-covyz = covariance(y,z,n)
-print(covxx,covyy, covzz)
-print(covxy,covxz, covyz)
-w = np.vstack((x, y, z))
-#print(w)
-c = np.cov(w)
-print(c)
-#eigen = np.zeros(n)
-Eigvals, Eigvecs = np.linalg.eig(c)
-print(Eigvals)
-
-
-
-
-
-0.000171990965637209
-3.967581388294481
--0.025521898567525465
-0.853884005749657 8.208733310166176 9.244798847617261
-2.497355838775297 2.088848443911507 6.174325810031482
-[[0.85388401 2.49735584 2.08884844]
- [2.49735584 8.20873331 6.17432581]
- [2.08884844 6.17432581 9.24479885]]
-[15.62869983  0.07851446  2.60020187]
-
-
-
-
-
-
-

1.41. Random Numbers

-

Uniform deviates are just random numbers that lie within a specified range -(typically 0 to 1), with any one number in the range just as likely as any other. They -are, in other words, what you probably think random numbers are. However, -we want to distinguish uniform deviates from other sorts of random numbers, for -example numbers drawn from a normal (Gaussian) distribution of specified mean -and standard deviation. These other sorts of deviates are almost always generated by -performing appropriate operations on one or more uniform deviates, as we will see -in subsequent sections. So, a reliable source of random uniform deviates, the subject -of this section, is an essential building block for any sort of stochastic modeling -or Monte Carlo computer work.

-
-
-

1.42. Random Numbers, better name: pseudo random numbers

-

A disclaimer is however appropriate. It should be fairly obvious that -something as deterministic as a computer cannot generate purely random numbers.

-

Numbers generated by any of the standard algorithms are in reality pseudo random -numbers, hopefully abiding to the following criteria:

-
    -
  • they produce a uniform distribution in the interval [0,1].

  • -
  • correlations between random numbers are negligible

  • -
  • the period before the same sequence of random numbers is repeated is as large as possible and finally

  • -
  • the algorithm should be fast.

  • -
-
-
-

1.43. Random number generator RNG

-

The most common random number generators are based on so-called -Linear congruential relations of the type

-
-\[ -N_i=(aN_{i-1}+c) \mathrm{MOD} (M), -\]
-

which yield a number in the interval [0,1] through

-
-\[ -x_i=N_i/M -\]
-

The number -\(M\) is called the period and it should be as large as possible -and -\(N_0\) is the starting value, or seed. The function \(\mathrm{MOD}\) means the remainder, -that is if we were to evaluate \((13)\mathrm{MOD}(9)\), the outcome is the remainder -of the division \(13/9\), namely \(4\).

-
-
-

1.44. Random number generator RNG and periodic outputs

-

The problem with such generators is that their outputs are periodic; -they -will start to repeat themselves with a period that is at most \(M\). If however -the parameters \(a\) and \(c\) are badly chosen, the period may be even shorter.

-

Consider the following example

-
-\[ -N_i=(6N_{i-1}+7) \mathrm{MOD} (5), -\]
-

with a seed \(N_0=2\). This generator produces the sequence -\(4,1,3,0,2,4,1,3,0,2,...\dots\), i.e., a sequence with period \(5\). -However, increasing \(M\) may not guarantee a larger period as the following -example shows

-
-\[ -N_i=(27N_{i-1}+11) \mathrm{MOD} (54), -\]
-

which still, with \(N_0=2\), results in \(11,38,11,38,11,38,\dots\), a period of -just \(2\).

-
-
-

1.45. Random number generator RNG and its period

-

Typical periods for the random generators provided in the program library -are of the order of \(\sim 10^9\) or larger. Other random number generators which have -become increasingly popular are so-called shift-register generators. -In these generators each successive number depends on many preceding -values (rather than the last values as in the linear congruential -generator). -For example, you could make a shift register generator whose \(l\)th -number is the sum of the \(l-i\)th and \(l-j\)th values with modulo \(M\),

-
-\[ -N_l=(aN_{l-i}+cN_{l-j})\mathrm{MOD}(M). -\]
-
-
-

1.46. Random number generator RNG, other examples

-

Such a generator again produces a sequence of pseudorandom numbers -but this time with a period much larger than \(M\). -It is also possible to construct more elaborate algorithms by including -more than two past terms in the sum of each iteration. -One example is the generator of Marsaglia and Zaman -which consists of two congruential relations

- -
-
-\[ -\begin{equation} - N_l=(N_{l-3}-N_{l-1})\mathrm{MOD}(2^{31}-69), -\label{eq:mz1} \tag{12} -\end{equation} -\]
-

followed by

- -
-
-\[ -\begin{equation} - N_l=(69069N_{l-1}+1013904243)\mathrm{MOD}(2^{32}), -\label{eq:mz2} \tag{13} -\end{equation} -\]
-

which according to the authors has a period larger than \(2^{94}\).

-
-
-

1.47. Random number generator RNG, other examples

-

Instead of using modular addition, we could use the bitwise -exclusive-OR (\(\oplus\)) operation so that

-
-\[ -N_l=(N_{l-i})\oplus (N_{l-j}) -\]
-

where the bitwise action of \(\oplus\) means that if \(N_{l-i}=N_{l-j}\) the result is -\(0\) whereas if \(N_{l-i}\ne N_{l-j}\) the result is -\(1\). As an example, consider the case where \(N_{l-i}=6\) and \(N_{l-j}=11\). The first -one has a bit representation (using 4 bits only) which reads \(0110\) whereas the -second number is \(1011\). Employing the \(\oplus\) operator yields -\(1101\), or \(2^3+2^2+2^0=13\).

-

In Fortran90, the bitwise \(\oplus\) operation is coded through the intrinsic -function \(\mathrm{IEOR}(m,n)\) where \(m\) and \(n\) are the input numbers, while in \(C\) -it is given by \(m\wedge n\).

-
-
-

1.48. Random number generator RNG, RAN0

-

We show here how the linear congruential algorithm can be implemented, namely

-
-\[ -N_i=(aN_{i-1}) \mathrm{MOD} (M). -\]
-

However, since \(a\) and \(N_{i-1}\) are integers and their multiplication -could become greater than the standard 32 bit integer, there is a trick via -Schrage’s algorithm which approximates the multiplication -of large integers through the factorization

-
-\[ -M=aq+r, -\]
-

where we have defined

-
-\[ -q=[M/a], -\]
-

and

-
-\[ -r = M\hspace{0.1cm}\mathrm{MOD} \hspace{0.1cm}a. -\]
-

where the brackets denote integer division. In the code below the numbers -\(q\) and \(r\) are chosen so that \(r < q\).

-
-
-

1.49. Random number generator RNG, RAN0

-

To see how this works we note first that

- -
-
-\[ -\begin{equation} -(aN_{i-1}) \mathrm{MOD} (M)= (aN_{i-1}-[N_{i-1}/q]M)\mathrm{MOD} (M), -\label{eq:rntrick1} \tag{14} -\end{equation} -\]
-

since we can add or subtract any integer multiple of \(M\) from \(aN_{i-1}\). -The last term \([N_{i-1}/q]M\mathrm{MOD}(M)\) is zero since the integer division -\([N_{i-1}/q]\) just yields a constant which is multiplied with \(M\).

-
-
-

1.50. Random number generator RNG, RAN0

-

We can now rewrite Eq. (14) as

- -
-
-\[ -\begin{equation} -(aN_{i-1}) \mathrm{MOD} (M)= (aN_{i-1}-[N_{i-1}/q](aq+r))\mathrm{MOD} (M), -\label{eq:rntrick2} \tag{15} -\end{equation} -\]
-

which results -in

- -
-
-\[ -\begin{equation} -(aN_{i-1}) \mathrm{MOD} (M)= \left(a(N_{i-1}-[N_{i-1}/q]q)-[N_{i-1}/q]r)\right)\mathrm{MOD} (M), -\label{eq:rntrick3} \tag{16} -\end{equation} -\]
-

yielding

- -
-
-\[ -\begin{equation} -(aN_{i-1}) \mathrm{MOD} (M)= \left(a(N_{i-1}\mathrm{MOD} (q)) -[N_{i-1}/q]r)\right)\mathrm{MOD} (M). -\label{eq:rntrick4} \tag{17} -\end{equation} -\]
-
-
-

1.51. Random number generator RNG, RAN0

-

The term \([N_{i-1}/q]r\) is always smaller or equal \(N_{i-1}(r/q)\) and with \(r < q\) we obtain always a -number smaller than \(N_{i-1}\), which is smaller than \(M\). -And since the number \(N_{i-1}\mathrm{MOD} (q)\) is between zero and \(q-1\) then -\(a(N_{i-1}\mathrm{MOD} (q))< aq\). Combined with our definition of \(q=[M/a]\) ensures that -this term is also smaller than \(M\) meaning that both terms fit into a -32-bit signed integer. None of these two terms can be negative, but their difference could. -The algorithm below adds \(M\) if their difference is negative. -Note that the program uses the bitwise \(\oplus\) operator to generate -the starting point for each generation of a random number. The period -of \(ran0\) is \(\sim 2.1\times 10^{9}\). A special feature of this -algorithm is that is should never be called with the initial seed -set to \(0\).

-
-
-

1.52. Random number generator RNG, RAN0 code

-
        /*
-         ** The function
-         **           ran0()
-         ** is an "Minimal" random number generator of Park and Miller
-         ** Set or reset the input value
-         ** idum to any integer value (except the unlikely value MASK)
-         ** to initialize the sequence; idum must not be altered between
-         ** calls for sucessive deviates in a sequence.
-         ** The function returns a uniform deviate between 0.0 and 1.0.
-         */
-    double ran0(long &idum)
-    {
-       const int a = 16807, m = 2147483647, q = 127773;
-       const int r = 2836, MASK = 123459876;
-       const double am = 1./m;
-       long     k;
-       double   ans;
-       idum ^= MASK;
-       k = (*idum)/q;
-       idum = a*(idum - k*q) - r*k;
-       // add m if negative difference
-       if(idum < 0) idum += m;
-       ans=am*(idum);
-       idum ^= MASK;
-       return ans;
-    } // End: function ran0() 
-
-
-
-
-

1.53. Properties of Selected Random Number Generators

-

As mentioned previously, the underlying PDF for the generation of -random numbers is the uniform distribution, meaning that the -probability for finding a number \(x\) in the interval [0,1] is \(p(x)=1\).

-

A random number generator should produce numbers which are uniformly distributed -in this interval. The table shows the distribution of \(N=10000\) random -numbers generated by the functions in the program library. -We note in this table that the number of points in the various -intervals \(0.0-0.1\), \(0.1-0.2\) etc are fairly close to \(1000\), with some minor -deviations.

-

Two additional measures are the standard deviation \(\sigma\) and the mean -\(\mu=\langle x\rangle\).

-
-
-

1.54. Properties of Selected Random Number Generators

-

For the uniform distribution, the mean value \(\mu\) is then

-
-\[ -\mu=\langle x\rangle=\frac{1}{2} -\]
-

while the standard deviation is

-
-\[ -\sigma=\sqrt{\langle x^2\rangle-\mu^2}=\frac{1}{\sqrt{12}}=0.2886. -\]
-
-
-

1.55. Properties of Selected Random Number Generators

-

The various random number generators produce results which agree rather well with -these limiting values.

- - - - - - - - - - - - - - - - - - -
$x$-bin ran0 ran1 ran2 ran3
0.0-0.1 1013 991 938 1047
0.1-0.2 1002 1009 1040 1030
0.2-0.3 989 999 1030 993
0.3-0.4 939 960 1023 937
0.4-0.5 1038 1001 1002 992
0.5-0.6 1037 1047 1009 1009
0.6-0.7 1005 989 1003 989
0.7-0.8 986 962 985 954
0.8-0.9 1000 1027 1009 1023
0.9-1.0 991 1015 961 1026
$\mu$ 0.4997 0.5018 0.4992 0.4990
$\sigma$ 0.2882 0.2892 0.2861 0.2915
-
-
-

1.56. Simple demonstration of RNGs using python

-

The following simple Python code plots the distribution of the produced random numbers using the linear congruential RNG employed by Python. The trend displayed in the previous table is seen rather clearly.

-
-
-
#!/usr/bin/env python
-import numpy as np
-import matplotlib.mlab as mlab
-import matplotlib.pyplot as plt
-import random
-
-# initialize the rng with a seed
-random.seed() 
-counts = 10000
-values = np.zeros(counts)   
-for i in range (1, counts, 1):
-    values[i] = random.random()
-
-# the histogram of the data
-n, bins, patches = plt.hist(values, 10, facecolor='green')
-
-plt.xlabel('$x$')
-plt.ylabel('Number of counts')
-plt.title(r'Test of uniform distribution')
-plt.axis([0, 1, 0, 1100])
-plt.grid(True)
-plt.show()
-
-
-
-
-_images/statistics_178_0.png -
-
-
-
-

1.57. Properties of Selected Random Number Generators

-

Since our random numbers, which are typically generated via a linear congruential algorithm, -are never fully independent, we can then define -an important test which measures the degree of correlation, namely the so-called
-auto-correlation function defined previously, see again Eq. (9). -We rewrite it here as

-
-\[ -C_k=\frac{f_d} - {\sigma^2}, -\]
-

with \(C_0=1\). Recall that -\(\sigma^2=\langle x_i^2\rangle-\langle x_i\rangle^2\) and that

-
-\[ -f_d = \frac{1}{nm}\sum_{\alpha=1}^m\sum_{k=1}^{n-d}(x_{\alpha,k}-\langle X_m \rangle)(x_{\alpha,k+d}-\langle X_m \rangle), -\]
-

The non-vanishing of \(C_k\) for \(k\ne 0\) means that the random -numbers are not independent. The independence of the random numbers is crucial -in the evaluation of other expectation values. If they are not independent, our -assumption for approximating \(\sigma_N\) is no longer valid.

-
-
-

1.58. Autocorrelation function

-

This program computes the autocorrelation function as discussed in the equation on the previous slide for random numbers generated with the normal distribution \(N(0,1)\).

-
-
-
# Importing various packages
-from math import exp, sqrt
-from random import random, seed
-import numpy as np
-import matplotlib.pyplot as plt
-
-def autocovariance(x, n, k, mean_x):
-    sum = 0.0
-    for i in range(0, n-k):
-        sum += (x[(i+k)]-mean_x)*(x[i]-mean_x)
-    return  sum/n
-
-n = 1000
-x=np.random.normal(size=n)
-autocor = np.zeros(n)
-figaxis = np.zeros(n)
-mean_x=np.mean(x)
-var_x = np.var(x)
-print(mean_x, var_x)
-for i in range (0, n):
-    figaxis[i] = i
-    autocor[i]=(autocovariance(x, n, i, mean_x))/var_x    
-
-plt.plot(figaxis, autocor, "r-")
-plt.axis([0,n,-0.1, 1.0])
-plt.xlabel(r'$i$')
-plt.ylabel(r'$\gamma_i$')
-plt.title(r'Autocorrelation function')
-plt.show()
-
-
-
-
-
0.005481494389472717 1.029117514654528
-
-
-_images/statistics_184_1.png -
-
-

As can be seen from the plot, the first point gives back the variance and a value of one. -For the remaining values we notice that there are still non-zero values for the auto-correlation function.

-
-
-

1.59. Correlation function and which random number generators should I use

-

The program here computes the correlation function for one of the standard functions included with the c++ compiler.

-
    //  This function computes the autocorrelation function for 
-    //  the standard c++ random number generator
-    
-    #include <fstream>
-    #include <iomanip>
-    #include <iostream>
-    #include <cmath>
-    using namespace std;
-    // output file as global variable
-    ofstream ofile;  
-    
-    //     Main function begins here     
-    int main(int argc, char* argv[])
-    {
-         int n;
-         char *outfilename;
-    
-         cin >> n;
-         double MCint = 0.;      double MCintsqr2=0.;
-         double invers_period = 1./RAND_MAX; // initialise the random number generator
-         srand(time(NULL));  // This produces the so-called seed in MC jargon
-         // Compute the variance and the mean value of the uniform distribution
-         // Compute also the specific values x for each cycle in order to be able to
-         // the covariance and the correlation function  
-         // Read in output file, abort if there are too few command-line arguments
-         if( argc <= 2 ){
-           cout << "Bad Usage: " << argv[0] << 
-    	 " read also output file and number of cycles on same line" << endl;
-           exit(1);
-         }
-         else{
-           outfilename=argv[1];
-         }
-         ofile.open(outfilename); 
-         // Get  the number of Monte-Carlo samples
-         n = atoi(argv[2]);
-         double *X;  
-         X = new double[n];
-         for (int i = 0;  i < n; i++){
-               double x = double(rand())*invers_period; 
-               X[i] = x;
-               MCint += x;
-               MCintsqr2 += x*x;
-         }
-         double Mean = MCint/((double) n );
-         MCintsqr2 = MCintsqr2/((double) n );
-         double STDev = sqrt(MCintsqr2-Mean*Mean);
-         double Variance = MCintsqr2-Mean*Mean;
-    //   Write mean value and standard deviation 
-         cout << " Standard deviation= " << STDev << " Integral = " << Mean << endl;
-    
-         // Now we compute the autocorrelation function
-         double *autocor;  autocor = new double[n];
-         for (int j = 0; j < n; j++){
-           double sum = 0.0;
-           for (int k = 0; k < (n-j); k++){
-    	 sum  += (X[k]-Mean)*(X[k+j]-Mean); 
-           }
-           autocor[j] = sum/Variance/((double) n );
-           ofile << setiosflags(ios::showpoint | ios::uppercase);
-           ofile << setw(15) << setprecision(8) << j;
-           ofile << setw(15) << setprecision(8) << autocor[j] << endl;
-         }
-         ofile.close();  // close output file
-         return 0;
-    }  // end of main program 
-
-
-
-
-

1.60. Which RNG should I use?

-
    -
  • C++ has a class called random. The random class contains a large selection of RNGs and is highly recommended. Some of these RNGs have very large periods making it thereby very safe to use these RNGs in case one is performing large calculations. In particular, the Mersenne twister random number engine has a period of \(2^{19937}\).

  • -
  • Add RNGs in Python

  • -
-
-
-

1.61. How to use the Mersenne generator

-

The following part of a c++ code (from project 4) sets up the uniform distribution for \(x\in [0,1]\).

-
    /*
-    
-    //  You need this 
-    #include <random>
-    
-    // Initialize the seed and call the Mersienne algo
-    std::random_device rd;
-    std::mt19937_64 gen(rd());
-    // Set up the uniform distribution for x \in [[0, 1]
-    std::uniform_real_distribution<double> RandomNumberGenerator(0.0,1.0);
-    
-    // Now use the RNG
-    int ix = (int) (RandomNumberGenerator(gen)*NSpins);
-
-
-
-
-

1.62. Why blocking?

-

Statistical analysis.

-
* Monte Carlo simulations can be treated as *computer experiments*
-
-* The results can be analysed with the same statistical tools as we would use analysing experimental data.
-
-* As in all experiments, we are looking for expectation values and an estimate of how accurate they are, i.e., possible sources for errors.
-
-
-

A very good article which explains blocking is H. Flyvbjerg and H. G. Petersen, Error estimates on averages of correlated data, Journal of Chemical Physics 91, 461-466 (1989).

-
-
-

1.63. Why blocking?

-

Statistical analysis.

-
* As in other experiments, Monte Carlo experiments have two classes of errors:
-
-  * Statistical errors
-
-  * Systematical errors
-
-
-* Statistical errors can be estimated using standard tools from statistics
-
-* Systematical errors are method specific and must be treated differently from case to case. (In VMC a common source is the step length or time step in importance sampling)
-
-
-
-
-

1.64. Code to demonstrate the calculation of the autocorrelation function

-

The following code computes the autocorrelation function, the covariance and the standard deviation -for standard RNG. -The following file gives the code.

-
    //  This function computes the autocorrelation function for 
-    //  the Mersenne random number generator with a uniform distribution
-    #include <iostream>
-    #include <fstream>
-    #include <iomanip>
-    #include <cstdlib>
-    #include <random>
-    #include <armadillo>
-    #include <string>
-    #include <cmath>
-    using namespace  std;
-    using namespace arma;
-    // output file
-    ofstream ofile;
-    
-    //     Main function begins here     
-    int main(int argc, char* argv[])
-    {
-      int MonteCarloCycles;
-      string filename;
-      if (argc > 1) {
-        filename=argv[1];
-        MonteCarloCycles = atoi(argv[2]);
-        string fileout = filename;
-        string argument = to_string(MonteCarloCycles);
-        fileout.append(argument);
-        ofile.open(fileout);
-      }
-    
-      // Compute the variance and the mean value of the uniform distribution
-      // Compute also the specific values x for each cycle in order to be able to
-      // compute the covariance and the correlation function  
-    
-      vec X  = zeros<vec>(MonteCarloCycles);
-      double MCint = 0.;      double MCintsqr2=0.;
-      std::random_device rd;
-      std::mt19937_64 gen(rd());
-      // Set up the uniform distribution for x \in [[0, 1]
-      std::uniform_real_distribution<double> RandomNumberGenerator(0.0,1.0);
-      for (int i = 0;  i < MonteCarloCycles; i++){
-        double x =   RandomNumberGenerator(gen); 
-        X(i) = x;
-        MCint += x;
-        MCintsqr2 += x*x;
-      }
-      double Mean = MCint/((double) MonteCarloCycles );
-      MCintsqr2 = MCintsqr2/((double) MonteCarloCycles );
-      double STDev = sqrt(MCintsqr2-Mean*Mean);
-      double Variance = MCintsqr2-Mean*Mean;
-      //   Write mean value and variance
-      cout << " Sample variance= " << Variance  << " Mean value = " << Mean << endl;
-      // Now we compute the autocorrelation function
-      vec autocorrelation = zeros<vec>(MonteCarloCycles);
-      for (int j = 0; j < MonteCarloCycles; j++){
-        double sum = 0.0;
-        for (int k = 0; k < (MonteCarloCycles-j); k++){
-          sum  += (X(k)-Mean)*(X(k+j)-Mean); 
-        }
-        autocorrelation(j) = sum/Variance/((double) MonteCarloCycles );
-        ofile << setiosflags(ios::showpoint | ios::uppercase);
-        ofile << setw(15) << setprecision(8) << j;
-        ofile << setw(15) << setprecision(8) << autocorrelation(j) << endl;
-      }
-      // Now compute the exact covariance using the autocorrelation function
-      double Covariance = 0.0;
-      for (int j = 0; j < MonteCarloCycles; j++){
-        Covariance  += autocorrelation(j);
-      }
-      Covariance *=  2.0/((double) MonteCarloCycles);
-      // Compute now the total variance, including the covariance, and obtain the standard deviation
-      double TotalVariance = (Variance/((double) MonteCarloCycles ))+Covariance;
-      cout << "Covariance =" << Covariance << "Totalvariance= " << TotalVariance << "Sample Variance/n= " << (Variance/((double) MonteCarloCycles )) << endl;
-      cout << " STD from sample variance= " << sqrt(Variance/((double) MonteCarloCycles )) << " STD with covariance = " << sqrt(TotalVariance) << endl;
-    
-      ofile.close();  // close output file
-      return 0;
-    }  // end of main program 
-
-
-
-
-

1.65. What is blocking?

-

Blocking.

-
* Say that we have a set of samples from a Monte Carlo experiment
-
-* Assuming (wrongly) that our samples are uncorrelated our best estimate of the standard deviation of the mean $\langle \mathbf{M}\rangle$ is given by
-
-
-
-\[ -\sigma=\sqrt{\frac{1}{n}\left(\langle \mathbf{M}^2\rangle-\langle \mathbf{M}\rangle^2\right)} -\]
-
    -
  • If the samples are correlated we can rewrite our results to show that

  • -
-
-\[ -\sigma=\sqrt{\frac{1+2\tau/\Delta t}{n}\left(\langle \mathbf{M}^2\rangle-\langle \mathbf{M}\rangle^2\right)} -\]
-

where \(\tau\) is the correlation time (the time between a sample and the next uncorrelated sample) and \(\Delta t\) is time between each sample

-
-
-

1.66. What is blocking?

-

Blocking.

-
* If $\Delta t\gg\tau$ our first estimate of $\sigma$ still holds
-
-* Much more common that $\Delta t<\tau$
-
-* In the method of data blocking we divide the sequence of samples into blocks
-
-* We then take the mean $\langle \mathbf{M}_i\rangle$ of block $i=1\ldots n_{blocks}$ to calculate the total mean and variance
-
-* The size of each block must be so large that sample $j$ of block $i$ is not correlated with sample $j$ of block $i+1$
-
-* The correlation time $\tau$ would be a good choice
-
-
-
-
-

1.67. What is blocking?

-

Blocking.

-
* Problem: We don't know $\tau$ or it is too expensive to compute
-
-* Solution: Make a plot of std. dev. as a function of blocksize
-
-* The estimate of std. dev. of correlated data is too low $\to$ the error will increase with increasing block size until the blocks are uncorrelated, where we reach a plateau
-
-* When the std. dev. stops increasing the blocks are uncorrelated
-
-
-
-
-

1.68. Implementation

-
* Do a Monte Carlo simulation, storing all samples to file
-
-* Do the statistical analysis on this file, independently of your Monte Carlo program
-
-* Read the file into an array
-
-* Loop over various block sizes
-
-* For each block size $n_b$, loop over the array in steps of $n_b$ taking the mean of elements $i n_b,\ldots,(i+1) n_b$
-
-* Take the mean and variance of the resulting array
-
-* Write the results for each block size to file for later
-  analysis
-
-
-
-
-

1.69. Actual implementation with code, main function

-

When the file gets large, it can be useful to write your data in binary mode instead of ascii characters. -The following python file reads data from file with the output from every Monte Carlo cycle.

-
-
-
# Blocking
-    @timeFunction
-    def blocking(self, blockSizeMax = 500):
-        blockSizeMin = 1
-
-        self.blockSizes = []
-        self.meanVec = []
-        self.varVec = []
-
-        for i in range(blockSizeMin, blockSizeMax):
-            if(len(self.data) % i != 0):
-                pass#continue
-            blockSize = i
-            meanTempVec = []
-            varTempVec = []
-            startPoint = 0
-            endPoint = blockSize
-
-            while endPoint <= len(self.data):
-                meanTempVec.append(np.average(self.data[startPoint:endPoint]))
-                startPoint = endPoint
-                endPoint += blockSize
-            mean, var = np.average(meanTempVec), np.var(meanTempVec)/len(meanTempVec)
-            self.meanVec.append(mean)
-            self.varVec.append(var)
-            self.blockSizes.append(blockSize)
-
-        self.blockingAvg = np.average(self.meanVec[-200:])
-        self.blockingVar = (np.average(self.varVec[-200:]))
-        self.blockingStd = np.sqrt(self.blockingVar)
-
-
-
-
-
  File "<ipython-input-6-2ff97f4bf03b>", line 2
-    @timeFunction
-    ^
-IndentationError: unexpected indent
-
-
-
-
-
-
-

1.70. The Bootstrap method

-

The Bootstrap resampling method is also very popular. It is very simple:

-
    -
  1. Start with your sample of measurements and compute the sample variance and the mean values

  2. -
  3. Then start again but pick in a random way the numbers in the sample and recalculate the mean and the sample variance.

  4. -
  5. Repeat this \(K\) times.

  6. -
-

It can be shown, see the article by Efron -that it produces the correct standard deviation.

-

This method is very useful for small ensembles of data points.

-
-
-

1.71. Bootstrapping

-

Given a set of \(N\) data, assume that we are interested in some -observable \(\theta\) which may be estimated from that set. This observable can also be for example the result of a fit based on all \(N\) raw data. -Let us call the value of the observable obtained from the original -data set \(\hat{\theta}\). One recreates from the sample repeatedly -other samples by choosing randomly \(N\) data out of the original set. -This costs essentially nothing, since we just recycle the original data set for the building of new sets.

-
-
-

1.72. Bootstrapping, recipe

-

Let us assume we have done this \(K\) times and thus have \(K\) sets of \(N\) -data values each. -Of course some values will enter more than once in the new sets. For each of these sets one computes the observable \(\theta\) resulting in values \(\theta_k\) with \(k = 1,...,K\). Then one determines

-
-\[ -\tilde{\theta} = \frac{1}{K} \sum_{k=1}^K \theta_k, -\]
-

and

-
-\[ -sigma^2_{\tilde{\theta}} = \frac{1}{K} \sum_{k=1}^K \left(\theta_k-\tilde{\theta}\right)^2. -\]
-

These are estimators for \(\angle\theta\rangle\) and its variance. They are not unbiased and therefore -\(\tilde{\theta}\neq\hat{\theta}\) for finite K.

-

The difference is called bias and gives an idea on how far away the result may be from -the true \(\angle\theta\rangle\). As final result for the observable one quotes \(\angle\theta\rangle = \tilde{\theta} \pm \sigma_{\tilde{\theta}}\) .

-
-
-

1.73. Bootstrapping, code

-
    # Bootstrap
-        @timeFunction
-        def bootstrap(self, nBoots = 1000):
-            bootVec = np.zeros(nBoots)
-            for k in range(0,nBoots):
-                bootVec[k] = np.average(np.random.choice(self.data, len(self.data)))
-            self.bootAvg = np.average(bootVec)
-            self.bootVar = np.var(bootVec)
-            self.bootStd = np.std(bootVec)
-
-
-
-
-

1.74. Jackknife, code

-
    # Jackknife
-        @timeFunction
-        def jackknife(self):
-            jackknVec = np.zeros(len(self.data))
-            for k in range(0,len(self.data)):
-                jackknVec[k] = np.average(np.delete(self.data, k))
-            self.jackknAvg = self.avg - (len(self.data) - 1) * (np.average(jackknVec) - self.avg)
-            self.jackknVar = float(len(self.data) - 1) * np.var(jackknVec)
-            self.jackknStd = np.sqrt(self.jackknVar)
-
-
-
-
- - - - -
- - - - -
-
-
-
-

- - By Morten Hjorth-Jensen
- - © Copyright 2021.
-

-
-
-
- - -
-
- - - - - - \ No newline at end of file diff --git a/doc/LectureNotes/_build/html/teachers.html b/doc/LectureNotes/_build/html/teachers.html deleted file mode 100644 index f75a2938c..000000000 --- a/doc/LectureNotes/_build/html/teachers.html +++ /dev/null @@ -1,413 +0,0 @@ - - - - - - - - Teachers and Grading — Applied Data Analysis and Machine Learning - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
- - - - - - - - -
- -
-
- -
- - - - - - - - - - - - - - -
- - - -
-
-
-
- -
- -
-

Teachers and Grading

-
-

Instructor information

-
    -
  • Name: Morten Hjorth-Jensen

  • -
  • Email: morten.hjorth-jensen@fys.uio.no

  • -
  • Phone: +47-48257387

  • -
  • Office: Department of Physics, University of Oslo, Eastern wing, room FØ470

  • -
  • Office hours: Anytime! Feel free to send an email for planning. Both in person meetings or digital meetings are possible.

  • -
-
-
-

Teaching Assistants Fall semester 2021

- -
-
-

Grading

-

Grading scale: Grades are awarded on a scale from A to F, where A is the best grade and F is a fail. There are three projects which are graded and each project counts 1/3 of the final grade. The total score is thus the average from all three projects.

-

The final number of points is based on the average of all projects (including eventual additional points) and the grade follows the following table:

-
    -
  • 92-100 points: A

  • -
  • 77-91 points: B

  • -
  • 58-76 points: C

  • -
  • 46-57 points: D

  • -
  • 40-45 points: E

  • -
  • 0-39 points: F-failed

  • -
-
-
- - - - -
- - - - -
-
-
-
-

- - By Morten Hjorth-Jensen
- - © Copyright 2021.
-

-
-
-
- - -
-
- - - - - - \ No newline at end of file diff --git a/doc/LectureNotes/_build/html/textbooks.html b/doc/LectureNotes/_build/html/textbooks.html deleted file mode 100644 index c7fdea196..000000000 --- a/doc/LectureNotes/_build/html/textbooks.html +++ /dev/null @@ -1,412 +0,0 @@ - - - - - - - - Textbooks — Applied Data Analysis and Machine Learning - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-
- - - - - - - - -
- -
-
- -
- - - - - - - - - - - - - - -
- - - -
-
-
-
- -
- -
-

Textbooks

-

Recommended textbooks: -The lecture notes are collected as a jupyter-book at https://compphysics.github.io/MachineLearning/doc/LectureNotes/_build/html/intro.html. In addition to the electure notes, we recommend the books of Bishop and Goodfellow et al. We will follow these texts closely and the weekly reading assignments refer to these two texts.

- -

General learning book on statistical analysis:

-
    -
  • Christian Robert and George Casella, Monte Carlo Statistical Methods, Springer

  • -
  • Peter Hoff, A first course in Bayesian statistical models, Springer

  • -
-

General Machine Learning Books:

-
    -
  • Kevin Murphy, Machine Learning: A Probabilistic Perspective, MIT Press

  • -
  • David J.C. MacKay, Information Theory, Inference, and Learning Algorithms, Cambridge University Press

  • -
  • David Barber, Bayesian Reasoning and Machine Learning, Cambridge University Press

  • -
-
- - - - - -
- - - - -
-
-
-
-

- - By Morten Hjorth-Jensen
- - © Copyright 2021.
-

-
-
-
- - -
-
- - - - - - \ No newline at end of file diff --git a/doc/LectureNotes/_build/jupyter_execute/Clustering.ipynb b/doc/LectureNotes/_build/jupyter_execute/Clustering.ipynb index db3b180c8..0bba49a4d 100644 --- a/doc/LectureNotes/_build/jupyter_execute/Clustering.ipynb +++ b/doc/LectureNotes/_build/jupyter_execute/Clustering.ipynb @@ -2,7 +2,7 @@ "cells": [ { "cell_type": "markdown", - "id": "c475c107", + "id": "3a06ea20", "metadata": {}, "source": [ "\n", @@ -83,7 +83,7 @@ }, { "cell_type": "markdown", - "id": "7741996c", + "id": "d2cf5ff8", "metadata": {}, "source": [ "which we wish to group into $K < n$ clusters. For our dissimilarity measure we\n", @@ -92,7 +92,7 @@ }, { "cell_type": "markdown", - "id": "9fa36cba", + "id": "a5945fae", "metadata": {}, "source": [ "\n", @@ -108,7 +108,7 @@ }, { "cell_type": "markdown", - "id": "67c0c2fb", + "id": "e8cd9e94", "metadata": {}, "source": [ "Next we define the so called *within-cluster point scatter* which gives us a\n", @@ -118,7 +118,7 @@ }, { "cell_type": "markdown", - "id": "9e06af7f", + "id": "de734a41", "metadata": {}, "source": [ "\n", @@ -135,7 +135,7 @@ }, { "cell_type": "markdown", - "id": "617b1871", + "id": "600e9a8f", "metadata": {}, "source": [ "where $\\boldsymbol{\\overline{x_k}}$ is the mean vector associated with the $k$-th\n", @@ -150,7 +150,7 @@ }, { "cell_type": "markdown", - "id": "56283dc8", + "id": "85aac270", "metadata": {}, "source": [ "\n", @@ -169,7 +169,7 @@ }, { "cell_type": "markdown", - "id": "6995cce8", + "id": "027260c1", "metadata": {}, "source": [ "Which is a quantity that is conserved throughout the $k$-means algorithm. It can\n", @@ -183,7 +183,7 @@ }, { "cell_type": "markdown", - "id": "2767eaea", + "id": "d7beb46f", "metadata": {}, "source": [ "\n", @@ -198,7 +198,7 @@ }, { "cell_type": "markdown", - "id": "fe5dd65d", + "id": "1014eab0", "metadata": {}, "source": [ "Now we have all the pieces necessary to formally revisit the k-means algorithm.\n", @@ -209,7 +209,7 @@ }, { "cell_type": "markdown", - "id": "3d051e1f", + "id": "8d84db37", "metadata": {}, "source": [ "## The K-means Clustering Algorithm\n", @@ -244,7 +244,7 @@ }, { "cell_type": "markdown", - "id": "a8d5180d", + "id": "85be301c", "metadata": {}, "source": [ "## Writing Our Own Code\n", @@ -255,7 +255,7 @@ }, { "cell_type": "markdown", - "id": "396b648e", + "id": "8f21c9fa", "metadata": {}, "source": [ "### Basic Python\n", @@ -277,7 +277,7 @@ { "cell_type": "code", "execution_count": 1, - "id": "d1266795", + "id": "5633ab0a", "metadata": {}, "outputs": [], "source": [ @@ -294,7 +294,7 @@ }, { "cell_type": "markdown", - "id": "04e0ae48", + "id": "12faa297", "metadata": {}, "source": [ "Next we define functions, for ease of use later, to generate Gaussians and to\n", @@ -304,7 +304,7 @@ { "cell_type": "code", "execution_count": 2, - "id": "c54add58", + "id": "37c8530f", "metadata": {}, "outputs": [ { @@ -377,7 +377,7 @@ }, { "cell_type": "markdown", - "id": "359f17b2", + "id": "f6d59ae3", "metadata": {}, "source": [ "Now that we are our, albeit very simple, dataset we are ready to start\n", @@ -387,7 +387,7 @@ { "cell_type": "code", "execution_count": 3, - "id": "07b9b0f8", + "id": "dc88590c", "metadata": {}, "outputs": [], "source": [ @@ -428,7 +428,7 @@ }, { "cell_type": "markdown", - "id": "a4f06c0d", + "id": "a481f2ff", "metadata": {}, "source": [ "Let's plot and see" @@ -437,7 +437,7 @@ { "cell_type": "code", "execution_count": 4, - "id": "75654aaf", + "id": "b68960f8", "metadata": {}, "outputs": [ { @@ -474,7 +474,7 @@ }, { "cell_type": "markdown", - "id": "b600aeb7", + "id": "3d86404d", "metadata": {}, "source": [ "So what do we have so far? We have 'picked' $k$ centroids at random from our\n", @@ -492,7 +492,7 @@ { "cell_type": "code", "execution_count": 5, - "id": "44faac12", + "id": "2680188a", "metadata": {}, "outputs": [ { @@ -500,7 +500,7 @@ "output_type": "stream", "text": [ "Converged at iteration 5\n", - "Runtime: 0.23453593254089355 seconds\n" + "Runtime: 0.2307121753692627 seconds\n" ] } ], @@ -557,7 +557,7 @@ }, { "cell_type": "markdown", - "id": "e9ad9ec8", + "id": "cfa1d5c2", "metadata": {}, "source": [ "And thats it! We now have an extremely barebones, un-optimized k-means\n", @@ -567,7 +567,7 @@ { "cell_type": "code", "execution_count": 6, - "id": "8d3e29d6", + "id": "61dc1381", "metadata": {}, "outputs": [ { @@ -604,7 +604,7 @@ }, { "cell_type": "markdown", - "id": "adf41666", + "id": "60221a60", "metadata": {}, "source": [ "Now there are a few glaring improvements to be done here. First of all is\n", @@ -617,7 +617,7 @@ }, { "cell_type": "markdown", - "id": "0bc703d2", + "id": "8b4a95ae", "metadata": {}, "source": [ "## Towards a More Numpythonic Code" @@ -626,7 +626,7 @@ { "cell_type": "code", "execution_count": 7, - "id": "667d9000", + "id": "8203aa82", "metadata": {}, "outputs": [ { @@ -634,7 +634,7 @@ "output_type": "stream", "text": [ "Converged at iteration: 5\n", - "Runtime: 0.19642972946166992 seconds\n" + "Runtime: 0.19350099563598633 seconds\n" ] } ], @@ -748,7 +748,7 @@ }, { "cell_type": "markdown", - "id": "ab038b5c", + "id": "a5f594f3", "metadata": {}, "source": [ "**Note**: the start of the timing is after the random initialization, and first\n", @@ -769,7 +769,7 @@ { "cell_type": "code", "execution_count": 8, - "id": "b610c6ef", + "id": "ab69ba1b", "metadata": {}, "outputs": [ { @@ -777,7 +777,7 @@ "output_type": "stream", "text": [ "Converged at iteration: 11\n", - "Runtime: 0.39145517349243164 seconds\n", + "Runtime: 0.38599205017089844 seconds\n", " " ] } @@ -789,7 +789,7 @@ }, { "cell_type": "markdown", - "id": "c3581c3a", + "id": "cdfce8c7", "metadata": {}, "source": [ "Here we can see the reason for profiling. We now know for certain a lot can be\n", @@ -801,7 +801,7 @@ { "cell_type": "code", "execution_count": 9, - "id": "56cc3361", + "id": "9940cb72", "metadata": {}, "outputs": [], "source": [ @@ -892,7 +892,7 @@ }, { "cell_type": "markdown", - "id": "0214a338", + "id": "c263ed5e", "metadata": {}, "source": [ "When working towards becoming a data scientist using Python this last step is\n", @@ -905,7 +905,7 @@ { "cell_type": "code", "execution_count": 10, - "id": "1d86e363", + "id": "4dd4eaff", "metadata": {}, "outputs": [ { @@ -913,7 +913,7 @@ "output_type": "stream", "text": [ "Converged at iteration: 5\n", - "Runtime: 0.0024149417877197266 seconds\n" + "Runtime: 0.0023620128631591797 seconds\n" ] } ], @@ -924,7 +924,7 @@ { "cell_type": "code", "execution_count": null, - "id": "5846cfe7", + "id": "17609564", "metadata": {}, "outputs": [], "source": [] diff --git a/doc/LectureNotes/_build/jupyter_execute/Clustering.py b/doc/LectureNotes/_build/jupyter_execute/Clustering.py deleted file mode 100644 index 36885f47b..000000000 --- a/doc/LectureNotes/_build/jupyter_execute/Clustering.py +++ /dev/null @@ -1,600 +0,0 @@ - - -# Clustering Analysis -In this chapter we will concern ourselves with the study of **cluster analysis**. -In general terms cluster analysis, or clustering, is the task of grouping a -data-set into different distinct categories based on some measure of equality of -the data. This measure is often referred to as a **metric** or **similarity -measure** in the literature (note: sometimes we deal with a **dissimilarity -measure** instead). Usually, these metrics are formulated as some kind of -distance function between points in a high-dimensional space. - -There exists a lot of such distance measures. The simplest, and also the most -common is the **Euclidean distance** (i.e. Pythagoras). A good source for those of -you wanting a thorough overview is the article (DOI:10.5120/ijca2016907841 -Irani, Pise, Phatak). A few other metrics mentioned there are: *cosine -similarity*, *Manhattan distance*, *Chebychev distance* and the *Minkowski -distance*. The Minkowski distance is a general formulation which encapsulates a -range of metrics. All of these, and many more, can be used in clustering. There -exists different categories of clustering algorithms. A few of the most -common are: *centroid-*, *distribution-*, *density-* and *hierarchical- -clustering*. We will concern ourselves primarily with the first one. - -## Basic Idea of the K-means Clustering Algorithm -The simplest of all clustering algorithms is the aptly named **k-means algorithm** -, sometimes also referred to as *Lloyds algorithm*. It is the simplest and also -the most common. From its simplicity it obtains both strengths and weaknesses. -These will be discussed in more detail later. The k-means algorithm is a -**centroid based** clustering algorithm. - -Assume, we are given $n$ data points and we wish to split the data into $K < n$ -different categories, or clusters. We label each cluster by an integer $k\in\{ -1, \cdots, K \}$. In the basic k-means algorithm each point is assigned to only -one cluster $k$, and these assignments are *non-injective* i.e. many-to-one. We -can think of these mappings as an encoder $k = C(i)$, which assigns the $i$-th -data-point $\bf x_i$ to the $k$-th cluster. Before we jump into the mathematics -let us describe the k-means algorithm in words: -1. We start with guesses / random initializations of our $k$ cluster centers / centroids - -2. For each centroid the points that are most similar are identified - -3. Then we move / replace each centroid with a coordinate average of all the points that were assigned to that centroid. - -4. Iterate this points 2, 3) until the centroids no longer move (to some tolerance) - -Now we consider the method formally. Again, we assume we have $n$ data-points -(vectors) - - -
- -$$ -\begin{equation}\label{eq:kmeanspoints} \tag{1} - \boldsymbol{x_i} = \{x_{i, 1}, \cdots, x_{i, p}\}\in\mathbb{R}^p. -\end{equation} -$$ - -which we wish to group into $K < n$ clusters. For our dissimilarity measure we -will use the *squared Euclidean distance* - - -
- -$$ -\begin{equation}\label{eq:squaredeuclidean} \tag{2} - d(\boldsymbol{x_i}, \boldsymbol{x_i'}) = \sum_{j=1}^p(x_{ij} - x_{i'j})^2 - = ||\boldsymbol{x_i} - \boldsymbol{x_{i'}}||^2 -\end{equation} -$$ - -Next we define the so called *within-cluster point scatter* which gives us a -measure of how close each data point assigned to the same cluster tends to be to -the all the others. - - -
- -$$ -\begin{equation}\label{eq:withincluster} \tag{3} - W(C) = \frac{1}{2}\sum_{k=1}^K\sum_{C(i)=k} - \sum_{C(i')=k}d(\boldsymbol{x_i}, \boldsymbol{x_{i'}}) = - \sum_{k=1}^KN_k\sum_{C(i)=k}||\boldsymbol{x_i} - \boldsymbol{\overline{x_k}}||^2 -\end{equation} -$$ - -where $\boldsymbol{\overline{x_k}}$ is the mean vector associated with the $k$-th -cluster, and $N_k = \sum_{i=1}^nI(C(i) = k)$, where the $I()$ notation is -similar to the Kronecker delta (*Commonly used in statistics, it just means that -when $i = k$ we have the encoder $C(i)$*). In other words, the within-cluster -scatter measures the compactness of each cluster with respect to the data points -assigned to each cluster. This is the quantity that the $k$-means algorithm aims -to minimize. We refer to this quantity $W(C)$ as the within cluster scatter -because of its relation to the *total scatter*. - - -
- -$$ -\begin{equation}\label{eq:totalscatter} \tag{4} - T = W(C) + B(C) = \frac{1}{2}\sum_{i=1}^n - \sum_{i'=1}^nd(\boldsymbol{x_i}, \boldsymbol{x_{i'}}) - = \frac{1}{2}\sum_{k=1}^K\sum_{C(i)=k} - \Big(\sum_{C(i') = k}d(\boldsymbol{x_i}, \boldsymbol{x_{i'}}) - + \sum_{C(i')\neq k}d(\boldsymbol{x_i}, \boldsymbol{x_{i'}})\Big) -\end{equation} -$$ - -Which is a quantity that is conserved throughout the $k$-means algorithm. It can -be thought of as the total amount of information in the data, and it is composed -of the aforementioned within-cluster scatter and the *between-cluster scatter* -$B(C)$. In methods such as principle component analysis the total scatter is not -conserved. - -Given a cluster mean $\boldsymbol{m_k}$ we define the **total cluster variance** - - -
- -$$ -\begin{equation}\label{eq:totalclustervariance} \tag{5} - \min_{C, \{\boldsymbol{m_k}\}_1^K}\sum_{k=1}^KN_k\sum||\boldsymbol{x_i} - \boldsymbol{m_k}||^2 -\end{equation} -$$ - -Now we have all the pieces necessary to formally revisit the k-means algorithm. -If you at this point feel like some of the above definitions came a bit out of -no-where, don't fret, the method does get a whole lot simpler once we start -programming. - -## The K-means Clustering Algorithm -The k-means clustering algorithm goes as follows (note in my opinion this -description is a bit complicated and is lifted directly out of ESL HASTIE for -deeper understanding purposes) - -1. For a given cluster assignment $C$, and $k$ cluster means $\{m_1, \cdots, m_k\}$. We minimize the total cluster variance with respect to the cluster means $\{m_k\}$ yielding the means of the currently assigned clusters. - -2. Given a current set of $k$ means $\{m_k\}$ the total cluster variance is minimized by assigning each observation to the closest (current) cluster mean. That is $$C(i) = \underset{1\leq k\leq K}{\mathrm{argmin}} ||\boldsymbol{x_i} - \boldsymbol{m_k}||^2$$ - -3. Steps 1 and 2 are repeated until the assignments do not change. - -As previously stated the above formulation can be a bit difficult to understand, -*at least the first time*, due to the dense notation used. But all in all the -concept is fairly simple when explained in words. The math needs to be -understood but to help you along the way we summarize the algorithm as follows -(try to look at the terms above to match with the summary). - -1. Before we start we specify a number $k$ which is the number of clusters we want to try to separate our data into. - -2. We initially choose $k$ random data points in our data as our initial centroids, *or means* (this is where the name comes from). - -3. Assign each data point to their closest centroid, based on the squared Euclidean distance. - -4. For each of the $k$ cluster we update the centroid by calculating new mean values for all the data points in the cluster. - -5. Iteratively minimize the within cluster scatter by performing steps (3, 4) until the new assignments stop changing (can be to some tolerance) or until a maximum number of iterations have passed. - -That's it, nothing magical happening. - -## Writing Our Own Code -In the following section we will work to develop a deeper understanding of the -previously discussed mathematics through developing codes to do k-means cluster -analysis. - -### Basic Python - -Let us now program the most basic version of the algorithm using nothing but -Python with numpy arrays. This code is kept intentionally simple to gradually -progress our understanding. There is no vectorization of any kind, and even most -helper functions are not utilized. Throughout our implementation process it will -be helpful to keep in mind both the mathematical description of the algorithm -*and* our summary from above. In addition, try to think of ways to optimize this -while reading the next section. We will get to it, take it as a challenge to see -if your optimizations are better. - -First of all we need a dataset to do our cluster analysis on, for clarity (and -lack of googling beforehand) we generate it ourselves using Gaussians. First we -import - -%matplotlib inline - -%matplotlib inline -import matplotlib.pyplot as plt -import numpy as np -import time -from IPython.display import display - -np.random.seed(2021) - -Next we define functions, for ease of use later, to generate Gaussians and to -set up our toy data set. - -def gaussian_points(dim=2, n_points=1000, mean_vector=np.array([0, 0]), - sample_variance=1): - """ - Very simple custom function to generate gaussian distributed point clusters - with variable dimension, number of points, means in each direction - (must match dim) and sample variance. - - Inputs: - dim (int) - n_points (int) - mean_vector (np.array) (where index 0 is x, index 1 is y etc.) - sample_variance (float) - - Returns: - data (np.array): with dimensions (dim x n_points) - """ - - mean_matrix = np.zeros(dim) + mean_vector - covariance_matrix = np.eye(dim) * sample_variance - data = np.random.multivariate_normal(mean_matrix, covariance_matrix, - n_points) - return data - - - -def generate_simple_clustering_dataset(dim=2, n_points=1000, plotting=True, - return_data=True): - """ - Toy model to illustrate k-means clustering - """ - - data1 = gaussian_points(mean_vector=np.array([5, 5])) - data2 = gaussian_points() - data3 = gaussian_points(mean_vector=np.array([1, 4.5])) - data4 = gaussian_points(mean_vector=np.array([5, 1])) - data = np.concatenate((data1, data2, data3, data4), axis=0) - - if plotting: - fig, ax = plt.subplots() - ax.scatter(data[:, 0], data[:, 1], alpha=0.2) - ax.set_title('Toy Model Dataset') - plt.show() - - - if return_data: - return data - - -data = generate_simple_clustering_dataset() - -Now that we are our, albeit very simple, dataset we are ready to start -implementing the k-means algorithm. - -n_samples, dimensions = data.shape -n_clusters = 4 - -# we randomly initialize our centroids -np.random.seed(2021) -centroids = data[np.random.choice(n_samples, n_clusters, replace=False), :] -distances = np.zeros((n_samples, n_clusters)) - -# first we need to calculate the distance to each centroid from our data -for k in range(n_clusters): - for n in range(n_samples): - dist = 0 - for d in range(dimensions): - dist += np.abs(data[n, d] - centroids[k, d])**2 - distances[n, k] = dist - -# we initialize an array to keep track of to which cluster each point belongs -# the way we set it up here the index tracks which point and the value which -# cluster the point belongs to -cluster_labels = np.zeros(n_samples, dtype='int') - -# next we loop through our samples and for every point assign it to the cluster -# to which it has the smallest distance to -for n in range(n_samples): - # tracking variables (all of this is basically just an argmin) - smallest = 1e10 - smallest_row_index = 1e10 - for k in range(n_clusters): - if distances[n, k] < smallest: - smallest = distances[n, k] - smallest_row_index = k - - cluster_labels[n] = smallest_row_index - -Let's plot and see - -fig = plt.figure() -ax = fig.add_subplot() -unique_cluster_labels = np.unique(cluster_labels) -for i in unique_cluster_labels: - ax.scatter(data[cluster_labels == i, 0], - data[cluster_labels == i, 1], - label = i, - alpha = 0.2) - ax.scatter(centroids[:, 0], centroids[:, 1], c='black') - -ax.set_title("First Grouping of Points to Centroids") - -plt.show() - -So what do we have so far? We have 'picked' $k$ centroids at random from our -data points. There are other ways of more intelligently choosing their -initializations, however for our purposes randomly is fine. Then we have -initialized an array 'distances' which holds the information of the distance, -*or dissimilarity*, of every point to of our centroids. Finally, we have -initialized an array 'cluster_labels' which according to our distances array -holds the information of to which centroid every point is assigned. This was the -first pass of our algorithm. Essentially, all we need to do now is repeat the -distance and assignment steps above until we have reached a desired convergence -or a maximum amount of iterations. - - -max_iterations = 100 -tolerance = 1e-8 -start_time = time.time() - -for iteration in range(max_iterations): - prev_centroids = centroids.copy() - for k in range(n_clusters): - # this array will be used to update our centroid positions - vector_mean = np.zeros(dimensions) - mean_divisor = 0 - for n in range(n_samples): - if cluster_labels[n] == k: - vector_mean += data[n, :] - mean_divisor += 1 - - # update according to the k means - centroids[k, :] = vector_mean / mean_divisor - - # we find the dissimilarity - for k in range(n_clusters): - for n in range(n_samples): - dist = 0 - for d in range(dimensions): - dist += np.abs(data[n, d] - centroids[k, d])**2 - distances[n, k] = dist - - # assign each point - for n in range(n_samples): - smallest = 1e10 - smallest_row_index = 1e10 - for k in range(n_clusters): - if distances[n, k] < smallest: - smallest = distances[n, k] - smallest_row_index = k - - cluster_labels[n] = smallest_row_index - - # convergence criteria - centroid_difference = np.sum(np.abs(centroids - prev_centroids)) - if centroid_difference < tolerance: - print(f'Converged at iteration {iteration}') - print(f'Runtime: {time.time() - start_time} seconds') - break - - elif iteration == max_iterations: - print(f'Did not converge in {max_iterations} iterations') - print(f'Runtime: {time.time() - start_time} seconds') - -And thats it! We now have an extremely barebones, un-optimized k-means -clustering implementation. Lets plot the final result - -fig = plt.figure() -ax = fig.add_subplot() -unique_cluster_labels = np.unique(cluster_labels) -for i in unique_cluster_labels: - ax.scatter(data[cluster_labels == i, 0], - data[cluster_labels == i, 1], - label = i, - alpha = 0.2) - ax.scatter(centroids[:, 0], centroids[:, 1], c='black') - -ax.set_title("Final Result of K-means Clustering") - -plt.show() - -Now there are a few glaring improvements to be done here. First of all is -organizing things into functions for better readability. Second is getting rid -of the small inefficiencies like manually calculating distances and argmin. And -finally, we need to optimize for better run-time. It's like we always say: the -best way of looping in Python is to not loop in Python. Let us tackle the first -two improvements. - -## Towards a More Numpythonic Code - - -def get_distances_to_clusters(data, centroids): - """ - Function that for each cluster finds the squared Euclidean distance - from every data point to the cluster centroid and returns a numpy array - containing the distances such that distance[i, j] means the distance between - the i-th point and the j-th centroid. - Inputs: - data (np.array): with dimensions (n_samples x dim) - centroids (np.array): with dimensions (n_clusters x dim) - - Returns: - distances (np.array): with dimensions (n_samples x n_clusters) - """ - - n_samples, dimensions = data.shape - n_clusters = centroids.shape[0] - distances = np.zeros((n_samples, n_clusters)) - for k in range(n_clusters): - for i in range(n_samples): - dist = 0 - for j in range(dimensions): - dist += np.abs(data[i, j] - centroids[k, j])**2 - distances[i, k] = dist - - return distances - - - -def assign_points_to_clusters(distances): - """ - Function to assign each data point to the cluster to which it is the closest - based on the squared Euclidean distance from the get_distances_to_clusters - method. - Inputs: - distances (np.array): with dimensions (n_samples x n_clusters) - - Returns: - cluster_labels (np.array): with dimensions (n_samples) - """ - cluster_labels = np.argmin(distances, axis=1) - - return cluster_labels - - - -def k_means(data, n_clusters=4, max_iterations=100, tolerance=1e-8): - """ - Naive implementation of the k-means clustering algorithm. A short summary of - the algorithm is as follows: we randomly initialize k centroids / means. - Then we assign, using the squared Euclidean distance, every data-point to a - cluster. We then update the position of the k centroids / means, and repeat - until convergence or we reach our desired maximum iterations. The method - returns the cluster assignments of our data-points and a sequence of - centroids. - Inputs: - data (np.array): with dimesions (n_samples x dim) - n_clusters (int): hyperparameter which depends on dataset - max_iterations (int): hyperparameter which depends on dataset - tolerance (float): convergence measure - - Returns: - cluster_labels (np.array): with dimension (n_samples) - centroid_list (list): list of centroids (np.array) - with dimensions (n_clusters x dim) - """ - - samples, dimensions = data.shape - np.random.seed(2021) - centroids = data[np.random.choice(len(data), n_clusters, replace=False), :] - distances = get_distances_to_clusters(data, centroids) - cluster_labels = assign_points_to_clusters(distances) - - start_time = time.time() - - for iteration in range(max_iterations): - prev_centroids = centroids.copy() - for k in range(n_clusters): - vector_mean = np.zeros(dimensions) - mean_divisor = 0 - for n in range(n_samples): - if cluster_labels[n] == k: - vector_mean += data[n, :] - mean_divisor += 1 - # And update according to the new means - centroids[k, :] = vector_mean / mean_divisor - - distances = get_distances_to_clusters(data, centroids) - cluster_labels = assign_points_to_clusters(distances) - - centroid_difference = np.sum(np.abs(centroids - prev_centroids)) - if centroid_difference < tolerance: - print(f'Converged at iteration: {iteration}') - print(f'Runtime: {time.time() - start_time} seconds') - - return cluster_labels, centroids - - print(f'Did not converge in {max_iterations} iterations') - print(f'Runtime: {time.time() - start_time} seconds') - - return cluster_labels, centroids - - -# quirk of numpy / Jupyter need to set seed again -cluster_labels, centroids = k_means(data) - -**Note**: the start of the timing is after the random initialization, and first -'cycle' of our algorithm. This is technically not the correct way to time it but -due to this being in a Jupyter notebook and the way it is structured this way of -comparing our algorithms will produce a more equal result. When timing code we -should always encapsulate our whole computation block. - -So we see an improvement from just switching to numpy's argmin function. There -is a very nice tool (or category of tools) called profilers. These can be -utilized to make clearer which improvements to our code we should care most -about here is an [excellent source](https://ipython-books.github.io/42-profiling-your-code-easily-with-cprofile-and-ipython/) -on the topic. Even before optimizing we can understand which parts of our code -will be taking the most of the run-time. It will be the longest Python loop, -i.e. the loop over all the samples. Nonetheless, let us do some profiling! - -test_data = generate_simple_clustering_dataset(n_points=10000, plotting=False) -%prun -l 10 cluster_labels, centroids = k_means(test_data) - -Here we can see the reason for profiling. We now know for certain a lot can be -gained just by vectorizing our distance function. Ideally we wish to perform -most of our loops in numpy, i.e. C. To do this we need our array shapes to match -and clever reshaping will let us do so. - - -def np_get_distances_to_clusters(data, centroids): - """ - Squared Euclidean distance between all data-points and every centroid. For - the function to work properly it needs data and centroids to be numpy - broadcastable. We sum along the dimension axis. - Inputs: - data (np.array): with dimensions (samples x 1 x dim) - centroids (np.array): with dimensions (1 x n_clusters x dim) - - Returns: - distances (np.array): with dimensions (samples x n_clusters) - """ - - distances = np.sum(np.abs((data - centroids))**2, axis=2) - return distances - -def np_assign_points_to_clusters(distances): - """ - Assigning each data-point to a cluster given an array distances containing - the squared Euclidean distance from every point to each centroid. We do - np.argmin along the cluster axis to find the closest cluster. Returns a - numpy array with corresponding labels. - Inputs: - distances (np.array): with dimensions (samples x n_clusters) - - Returns: - cluster_labels (np.array): with dimensions (samples x None) - """ - cluster_labels = np.argmin(distances, axis=1) - return cluster_labels - - -def np_k_means(data, n_clusters=4, max_iterations=100, tolerance=1e-8): - """ - Numpythonic implementation of the k-means clusting algorithm. - Inputs: - data (np.array): with dimesions (samples x dim) - n_clusters (int): hyperparameter which depends on dataset - max_iterations (int): hyperparameter which depends on dataset - tolerance (float): convergence measure - progression_plot (bool): activation flag for plotting - Returns: - cluster_labels (np.array): with dimension (samples) - centroid_list (list): list of centroids (np.array) - with dimensions (n_clusters x dim) - """ - n_samples, dimensions = data.shape - np.random.seed(2021) - centroids = data[np.random.choice(len(data), n_clusters, replace=False), :] - - distances = np_get_distances_to_clusters(np.reshape(data, - (n_samples, 1, dimensions)), - np.reshape(centroids, - (1, n_clusters, dimensions))) - cluster_labels = np_assign_points_to_clusters(distances) - - start_time = time.time() - - for iteration in range(max_iterations): - prev_centroids = centroids.copy() - for k in range(n_clusters): - points_in_cluster = data[cluster_labels == k] - mean_vector = np.mean(points_in_cluster, axis=0) - centroids[k] = mean_vector - - distances = np_get_distances_to_clusters(np.reshape(data, - (n_samples, 1, dimensions)), - np.reshape(centroids, - (1, n_clusters, dimensions))) - cluster_labels = np_assign_points_to_clusters(distances) - - centroid_difference = np.sum(np.abs(centroids - prev_centroids)) - if centroid_difference < tolerance: - print(f'Converged at iteration: {iteration}') - print(f'Runtime: {time.time() - start_time} seconds') - - return cluster_labels, centroids - - print(f'Did not converge in {max_iterations} iterations') - print(f'Runtime: {time.time() - start_time} seconds') - - return cluster_labels, centroids - -When working towards becoming a data scientist using Python this last step is -arguably one of the most important. Thinking of ways to avoid explicitly looping -by adding dimensions to our arrays in such a way that they become broadcastable -using numpy (also tensorflow and many others). Let us take a look at our the -fruits of our labor. - -cluster_labels, centroids = np_k_means(data) - diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter1.ipynb b/doc/LectureNotes/_build/jupyter_execute/chapter1.ipynb index 1c0661faf..fc6c3ada8 100644 --- a/doc/LectureNotes/_build/jupyter_execute/chapter1.ipynb +++ b/doc/LectureNotes/_build/jupyter_execute/chapter1.ipynb @@ -310,7 +310,7 @@ "outputs": [ { "data": { - "image/png": "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\n", + "image/png": "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\n", "text/plain": [ "
" ] @@ -461,7 +461,7 @@ "outputs": [ { "data": { - "image/png": "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\n", + "image/png": "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\n", "text/plain": [ "
" ] @@ -526,18 +526,18 @@ "output_type": "stream", "text": [ "The intercept alpha: \n", - " [2.08534155]\n", + " [1.89342228]\n", "Coefficient beta : \n", - " [[4.76326745]]\n", - "Mean squared error: 0.26\n", - "Variance score: 0.88\n", + " [[5.07308879]]\n", + "Mean squared error: 0.21\n", + "Variance score: 0.91\n", "Mean squared log error: 0.01\n", - "Mean absolute error: 0.42\n" + "Mean absolute error: 0.36\n" ] }, { "data": { - "image/png": "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\n", + "image/png": "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\n", "text/plain": [ "
" ] @@ -730,7 +730,7 @@ "outputs": [ { "data": { - "image/png": "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\n", + "image/png": "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\n", "text/plain": [ "
" ] @@ -1136,19 +1136,19 @@ "text": [ " N Z A Element Ebinding\n", "A \n", - "1 0 0 1 1 H 0.000000\n", - "2 1 1 1 2 H 1.112283\n", - "3 2 2 1 3 H 2.827265\n", - "4 6 2 2 4 He 7.073915\n", - "5 9 3 2 5 He 5.512132\n", + "4 0 1 3 4 Li 1.153760\n", + "5 2 3 2 5 He 5.512132\n", + "6 7 3 3 6 Li 5.332331\n", + "7 12 4 3 7 Li 5.606439\n", + "8 17 4 4 8 Be 7.062435\n", "... ... ... ... ... ...\n", - "264 3304 156 108 264 Hs 7.298375\n", - "265 3310 157 108 265 Hs 7.296247\n", - "266 3317 158 108 266 Hs 7.298273\n", - "269 3338 159 110 269 Ds 7.250154\n", - "270 3344 160 110 270 Ds 7.253775\n", + "264 3297 156 108 264 Hs 7.298375\n", + "265 3303 157 108 265 Hs 7.296247\n", + "266 3310 158 108 266 Hs 7.298273\n", + "269 3331 159 110 269 Ds 7.250154\n", + "270 3337 160 110 270 Ds 7.253775\n", "\n", - "[267 rows x 5 columns]\n" + "[264 rows x 5 columns]\n" ] } ], @@ -1232,14 +1232,14 @@ "name": "stdout", "output_type": "stream", "text": [ - "Mean squared error: 0.04\n", + "Mean squared error: 0.02\n", "Variance score: 0.95\n", "Mean absolute error: 0.05\n" ] }, { "data": { - "image/png": "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Svd4sbbyWIEtIiJTTSST6c0tbNP15sBWl7iIiEwtkQzs4E0tbNNdua6er6k8VgtbRESmmkgm05tb2Oz2wBgKWYNlWTha6UxERKaYiAb2m57oDSqrnNVUwtqyFNgiIjK1RDSwxya21edjgHINWpZURESmpEim05iVSY3B6g8ITGWnLm38ISIiU1EkA9vsM+rMKYIpAwmLIG7haMCZiIhMQZFMp31XOosNVbrIvZpKyzqbjk1WsURERA4okoE9kteWZVUCG8glKx3lzfWpySuYiIjIAUQysEda2PGYTWzQEASGwVhlLrYCW0REpqKqLk06VYy0sBuzSeyCR9kL2EMZgOa65CSWTEREZP8i2cIemdblOBbNJADIJXxs26KhNjGZRRMREdmviAZ25dayLBqpDDIrZyyaapM4diSrREREprhIptPINWzbgtpy5apAuQZm6Pq1iIhMUZEM7JEWtm1Z2AMBMdemlIHmel2/FhGRqSmig84qiW15hmAooL4uQd1MiyVz6ya5ZCIiIvsX0cCu3LqDldv6uSmuunDRpJVHRETkYCLZJT5yDdsZqiyW4tRF8u8WEREJkUgG9ui0rkLlsV3rTGJpREREDi6SgT2y94eTG75VYIuIyBQXycAebWHnKl3idjaS1SAiIiESyaQandaVr9w6WbWwRURkaotoYA8vnJIbvlVgi4jIFHfQwP7tb39bjXJUVfCmwNY1bBERmeoOOp/pL//yL3EchyuuuILLL7+clpaWapRrQo0MOlMLW0REwuKgLexf/vKX/N3f/R1btmzh4osv5rOf/SwPP/wwnudVo3wTYnSls/xwC1uBLSIiU9y4rmG/+93v5uabb+bJJ5/kggsu4K677uKcc87hH/7hHya6fBNidNDZ0HALW13iIiIyxR3SoLNMJsMf//Ef87nPfY7Zs2dz7733TlS5JpQxBrtssDyDFbOwEtZkF0lERORtjXtNzi1btvDTn/6Uhx56iJkzZ3LFFVdw6aWXTmTZJowxe1c5c7IOlqXAFhGRqe2ggX3vvfdy3333sX37di655BL+7d/+jWXLllWjbBMmMAY3DxYacCYiIuFw0MD+5S9/yac+9SnOP/98isUira2t1SjXhDIG3AKApQFnIiISCge9hv1v//ZvXHjhhTzzzDP80R/9Eddddx0AL7/8Mtdcc82EF3AiVFrYBsvSgDMREQmHcQ86u/XWW/nJT35CbW0tAO94xzvYvn37hBVsIhljhlvYWjRFRETC4ZBGiTc3N495HI/Hj2hhqsUYcIfXEdfGHyIiEgbjTqtMJsPu3btHR1Q/99xzZLPZCSvYRBoddGZp0JmIiITDuKd13XDDDVx99dXs3LmTq666im3btvG9731vIss2YYwBp1i579QosEVEZOobd2AvX76c//iP/2D16tUAnHzyyaPXs8PGGINTNJVpXRl1iYuIyNQ37sAGyGaznHvuuRNVlqoxBpwSYFlYKQW2iIhMfQcN7HvuuedtX//4xz9+xApTLYEx2OXhhVPSCmwREZn6DhrYX/va1zjhhBM45phjqlGeqhi9hp0AO61r2CIiMvUdNLBvuukm7r//fjZt2sQHP/hBLrnkEurq6qpRtgkTBAFuGUiCrS5xEREJgYMG9hVXXMEVV1zBjh07eOCBB/joRz/KMcccw7XXXhvaNcVNGSwfLMfCimnjDxERmfrG3bycP38+n/zkJ/nEJz7B888/z8svvzyR5ZpYhaBym1JYi4hIOBy0hW2M4amnnuK+++5j06ZNXHTRRfzoRz9i/vz51SjfxBgObCup7nAREQmHgwb2OeecM7r/9ec//3ksy6JYLPL6668DcPTRR094IY+44XXE1cIWEZGwOGhgx2Ixenp6uOOOO7jzzjsxxoy+ZlkWjz322IQWcEKMtLA14ExERELioIH9q1/9qhrlqK5C5Y8OdYmLiEhYHDSx/vEf/5GXXnqpGmWpGmsksLVoioiIhMRBE2vZsmX8+7//OxdccAE33ngjv/rVrygWi9Uo24QZCWzNwRYRkbA4aJf4ZZddxmWXXUapVOI3v/kNjz32GDfddBPHHnss559/PitWrKCxsbEaZT1yisMtbA06ExGRkBj35h/xeJxzzz2Xc889F2MMa9eu5Ze//CV33nknP/vZzyayjEecusRFRCRsfq/EsiyLk046iRtuuOGQwrpQKHDppZdy8803/z6nPWJGu8STWkdcRETCoapNzFtuuYXjjz++mqfcv+LwtK60usRFRCQcxt0lvnr16gO+dsoppxz0/Q888ACnnHIKGzduJJfLjfe0E8IaHjNnpdTCFhGRcBh3YD/zzDMArF27liAIOOGEE1i3bh3xeJzvfve7b/ve119/nS1btnD99dezcePGcReuoSGN6x6ZUG1uzo7ej/s2vm3R0JIe87zspXoZP9XVoVF9jZ/qavyiUFfjDuyVK1cC8NnPfpY77rhj9Pmrr776oO999NFHicfjrFq1ihdffJFyucxdd93FJz/5ybd9X0/PkWmJNzdn6eoaGH3sD3oEgWHAK415XireXF9yYKqrQ6P6Gj/V1fhNp7p6uz88xh3YI4rFIo8++ijHHXcc69evH9ec7GuvvXbM+3O53EHDeiJZxZF52LqGLSIi4XDIg85uvfVWWltbuf3222ltbeW2224b93sffvhhXnjhBdasWTOpU8Hs4b8x7LSuYYuISDgccgs7mUyydOlSWlpaMMbw5JNPcumll47rve9///t5//vff8iFPJKMb7DKBiywk2phi4hIOBxyC/szn/kMGzZswPM8fN/H87yJKNeECfIBxoAfB8fRwikiIhIOh9zCzmQyfO5zn5uIslSFyVXmYAexygIwIiIiYXDIgQ1w/fXXs3Tp0tHAu+aaa45ooSZSkA8Agx8H5bWIiITFIQf2pz/96TGPw9ZKNcVKl7ha2CIiEibjDuyHHnqIyy67jBdffHE06IwxWJbF6aefPmEFPNJMqTKlK3DUwhYRkfAYd2Afc8wxAJx66qkTVphqMGWDAQLXwlZii4hISIx7mPSyZcsAOPnkk9m9ezdr165l9+7dnHTSSRNVtgkRDC+aYly1sEVEJDwOeV7TddddR2dnJyeeeCKdnZ1cd911E1GuCWNKARgIXNTCFhGR0DjkQWee540uK/qe97yHp5566kiXaULt7RJXC1tERMJj3IH9ve99D8uysCyLlStXcuyxx7Jx40YSicRElu+IM0UDxhC4lkaJi4hIaBw0sK+77jpuu+02Tj31VIrF4pi9r88444wJLdxEMOUAQ+Uatq28FhGRkDhoYO/YsQOAd73rXVxxxRXcd999o6+NZ4vMqcYU953WpcQWEZFwOKRBZ0EQjHn84IMPHtHCVIMpmcrCKbqGLSIiIXLQwN63FfrmFqkx5siXaIKZ0vBa4holLiIiIXLQLvHW1la+8pWv8I53vIN8Pk+5XCYWiwHh7FIOSvvOww5f+UVEJJoOGtirVq1i3bp1rF27llgsxqmnnsqcOXM45phj6OjoqEYZj6igWGlhG1dhLSIi4XHQwD7ttNM47bTTRh+XSiU2bNjAq6++Sl1d3YQWbiIEw13iJjbJBRERETkEh7xwSjweZ/ny5SxfvnwiyjPhRkaJE1MLW0REwuOQlyYNu70tbAW2iIiER+QCe2R7TbWwRUQkTCIX2KOjxBXYIiISIpELbDM8ShwNOhMRkRCJXGAH6hIXEZEQilxgG03rEhGREIpUYBtjNOhMRERCKVKBjQcYMA7YjgJbRETCI1KBHRQre2Fra00REQmbSAW2KRswRht/iIhI6EQrsEum0sLWXtgiIhIy0Qrs4j57YaPEFhGR8IhWYJcNxgy3sCP1yUVEJOwiFVumaDAYjAOuE6mPLiIiIRep1DLlYLSF7djqEhcRkfCIVmAXR7rELbWwRUQkVCKVWqY0PK3LUQtbRETCJWKBHYxO63K00pmIiIRItAK7bDDGDF/DjtRHFxGRkItUagWlvdO6XLWwRUQkRCIV2KYYjLawNehMRETCJFKpZcqVpUk16ExERMImWoE9Mq0rpsAWEZFwiVZg7zvoTF3iIiISIpFKrco17EqXuKsWtoiIhEi0ArtUWUs8cC3NwxYRkVCJVmB7hsBA4GgetoiIhEukUssElaVJsTUPW0REwiVSgY1XyWtjq4UtIiLhEqnUMn6lS9zYWktcRETCJVKBjWcAM9zCVmCLiEh4RCqwTTDcJW5pHraIiIRLtFLLN5qHLSIioRSpwDZeZR62usRFRCRs3GqdaPv27dxyyy0cf/zxtLe3U19fz8qVK6t1emCfLnFbXeIiIhIuVQvs3t5eLr74Yt73vvcBcPHFF7NixQpOPPHEahVhuEvcYGytdCYiIuFStcBevnz5mMdBEJBKpap1eqAyrcsYwAJX87BFRCREqhbY+3r00Uc566yzWLJkydt+XUNDGtd1jsg5m5uzdLkulm3hplxaWrIk45Py8UOhuTk72UUIDdXVoVF9jZ/qavyiUFdVT6xnn32W5557jq985SsH/dqentwROWdzc5aurgEKuTK+H1Aqe/TsGcLVdez9GqkvOTjV1aFRfY2f6mr8plNdvd0fHlVNrMcff5ynn36aG2+8ka6uLl566aVqnn60S9w4GiUuIiLhUrXAfuWVV/jSl77E2rVr+cQnPsGf/dmfsXXr1mqdHgBTNgDYro1lKbBFRCQ8qtYlfuKJJ1a9Rf1mgV8JbCemsBYRkXCJzEVcE5jK9poWOG5kPraIiEwT0UkuX1triohIeEUmuczIoikWuFo0RUREQiY6ge0ZDCMjxCPzsUVEZJqITnIFjLawtSypiIiETWQCe8wcbAW2iIiETGQCG2/vOuLqEhcRkbCJTHKZgNG9sF2tciYiIiETmcAeaWFX9sJWYIuISLhEJrBHr2FrHraIiIRQdJLLHx4lrha2iIiEUGQC2/jD87B1DVtEREIoWoE92sKOzMcWEZFpIjrJNWYtcbWwRUQkXCIT2CODzrDBVQtbRERCJjrJ5ZvRedhqYYuISNhEJrDNaJe4pVHiIiISOpEJbPYZdKYucRERCZvIJNfYhVPUwhYRkXCJTGDjD68lbimwRUQkfCIT2GbMWuKR+dgiIjJNRCa5TLA3sGMKbBERCZnoJNc+a4nH3Oh8bBERmR4ik1zGMwTGgAJbRERCKDrJ5RuCQC1sEREJp8gklwkY3a1LgS0iImETneTap4UdV2CLiEjIRCa5Ai8YHSWulc5ERCRsIpNcftkAYMdsLEsLp4iISLhEJrC9cgCAHVNYi4hI+EQmsP1SJbBdV4EtIiLhE5nAHmlhO64zySURERE5dJEJ7JEWthNXC1tERMInOoG9z6AzERGRsIlMevne8DVsBbaIiIRQZNJrtEtco8RFRCSEIhPYgVfpEnfjkfnIIiIyjUQmvUa6xB0tSyoiIiEUmfQabWEnIvORRURkGolMeo2MEndjmoctIiLhE5nADjRKXEREQiwy6aUucRERCbPIpFcwvDRpTKPERUQkhCKTXsavtLAV2CIiEkaRSS/NwxYRkTCLTHqNBHYsrlHiIiISPpEJbDMS2AkFtoiIhE+EArtyqxa2iIiEUXQCW4POREQkxCKRXkFgRgNbg85ERCSMIpFeJc/HMmDbFrar7TVFRCR83Gqe7JlnnuGRRx6hqakJy7JYuXJlVc5b9gIsHywLcBTYIiISPlUL7Hw+z9/8zd/w85//nHg8znXXXcdvfvMb3vOe90z4uUvl4Ra2ZWEpsEVEJISq1iW+Zs0a5syZQzweB+CUU07h8ccfr8q5y16AFQy3sKvapyAiInJkVC2+uru7yWQyo49ramro7u5+2/c0NKRx3cOfhlUq+WSSMbKZODNn1h728aKguTk72UUIDdXVoVF9jZ/qavyiUFdVC+ympiaGhoZGHw8ODtLU1PS27+npyR2Zc9dlmNmQwnIturoGjsgxp7Pm5qzqaZxUV4dG9TV+qqvxm0519XZ/eFStS/ykk06ira2NUqkEwOrVq1mxYkVVzj0ypcvSmikiIhJSVWthp1Ip/vZv/5a///u/p6GhgWOPPbYqA85gb2BrhLiIiIRVVYdgnXnmmZx55pnVPGWFX7nRCHEREQmrSCycMrLxB+oSFxGRkIpGYI9cw9YqZyIiElLRCmx1iYuISEhFI7BHusQj8WlFRGQ6ikSEqUtcRETCLhqB7Wlal4iIhFskAjvWGMNyLGItsckuioiIyO8lElthxBpjzL11IXZG87pERCScIhHYAE5dZD6qiIhMQ5HoEhcREQk7BbaIiEgIKLBFRERCQIEtIiISAgpsERGREFBgi4iIhIACW0REJAQU2CIiIiGgwBYREQkBBbaIiEgIKLBFRERCwDLGmMkuhIiIiLw9tbBFRERCQIEtIiISAgpsERGREFBgi4iIhIACW0REJAQU2CIiIiHgTnYBJtozzzzDI488QlNTE5ZlsXLlysku0pTykY98hEQiAYBt2/zgBz+gt7eXb33rW8yfP59t27Zx/fXXM2PGjEku6eTo6urilltuYcOGDfz0pz8FoFgscvPNN9PS0sK2bdv47Gc/y1FHHQXAgw8+yPr167FtmwULFvDRj350MotfVfurq/vuu4//+q//Gv0e+9CHPsTll18ORLuutm/fzi233MLxxx9Pe3s79fX1rFy58m1/9m6//XYGBwfp7+/nzDPP5Pzzz5/kT1E9B6qv2267jeeff37066655hrOPPNMYJrWl5nGcrmced/73meKxaIxxpiVK1eaZ555ZpJLNbXceuutb3nur//6r83Pf/5zY4wxjz32mLnhhhuqXawp4xe/+IV57LHHzAc/+MHR5/71X//VrFq1yhhjzIYNG8yVV15pjDFm165d5rLLLjNBEBhjjLniiivM1q1bq17mybK/uvrpT39qduzY8ZavjXpdrV271jz66KOjjy+66CLz8ssvH/Bnb82aNeYzn/mMMcaYcrlsLrjgAtPf31/9gk+SA9XX/n5/GTN962tad4mvWbOGOXPmEI/HATjllFN4/PHHJ7dQU8xrr73GqlWruO2220br5oknnuDkk08GKnX2xBNPTGIJJ9eFF15IJpMZ89zjjz8+Wj/HHnssGzZsYHBwkKeeeooTTjgBy7IAOPnkk3nyySerXubJsr+6Arjnnnu44447+Jd/+Rd6e3sBIl9Xy5cv533ve9/o4yAISKVSB/zZ+/Wvf81JJ50EgOu6LF68eEzLcro7UH0BfO973+OOO+5g1apV5PN5YPrW17TuEu/u7h7zC6Smpobu7u5JLNHUc/XVV7N8+XJ83+fjH/84mUxmTL3V1NTQ19eH53m47rT+dhm3A31f7dmzZ8zzI3UZZaeffjorVqygsbGRJ554gi9+8Yv84Ac/UF3t49FHH+Wss85iyZIlB/zZ27NnD4sXLx59T01NDXv27JmsIk+qfevrwgsvZO7cuaTTae655x6+9rWvcdNNN03b+prWLeympiaGhoZGHw8ODtLU1DSJJZp6li9fDoDjOJx22mk899xzY+ptcHCQuro6hfU+DvR91djYOOb5oaGhyH+/zZ8/n8bGRgDe/e5388ILL+D7vupq2LPPPstzzz3HV77yFYAD/uy9ub4GBwdH6zVK3lxfS5cuJZ1OA5Xvr2effRZg2tbXtA7sk046iba2NkqlEgCrV69mxYoVk1uoKWTz5s38+Mc/Hn3c2trK/PnzOffcc3nppZeASp2de+65k1XEKWnFihWj9bNx40aWLVtGTU0NZ599Nq+++ipmeHn+l156iXPOOWcyizrpvvWtb+F5HgDbtm1j7ty5OI6juqJyaeXpp5/mxhtvpKuri5deeumAP3srVqxgzZo1AJTLZbZs2cLpp58+WUWfFPurr5tvvnn09dbWVhYsWABM3/qa9pt//O///i8PP/wwDQ0NxGIxjRLfR0dHB1/72tc47rjjGBwcxPM8/uqv/or+/n6++c1vMmfOHHbs2MGf//mfR3aU+PPPP88DDzzAU089xZVXXsmnP/1pAG6++Waam5vZvn07n/vc58aMEn/llVdwHIdFixZFauTz/urq3nvvZdOmTcybN4/XXnuNT3ziE6PXFqNcV6+88gpXXXUVJ554IgC5XI6Pf/zjnHfeeQf82bv99tvp7++nr6+Pc845Z3qMeh6nA9XX1q1byefzNDU18dprr/GFL3xh9GdxOtbXtA9sERGR6WBad4mLiIhMFwpsERGREFBgi4iIhIACW0REJAQU2CIiIiGgwBYREQkBBbaIiEgIKLBFQuqFF17g2GOP5f777z/sY/32t7/l2GOP5Tvf+c7ocy+99BIXXXTRYR33n/7pn/jABz4w5t+yZcv4y7/8y8MtskjkKLBFQigIAr7+9a/z7ne/m/Xr1x/28V599VWWL1/Oo48+Oua5448//oDvOe+88w563Ouvv54HH3xw9N973vMelixZwpe//OXDLrNI1CiwRULoRz/6EQsWLOBjH/sYGzZsOOzjrVu3jssuu4x8Ps+OHTuASmCfcMIJh33sEd/61rd4/PHHueuuu6bFRgwi1aYtmERCpr+/n+9///vcc889lMtlNm7cuN+v+8IXvkBra+t+X7v33ntJJpOjj9etW8eHP/xhLrjgAh599FE+/elPs27dOj7wgQ8ckTJ/+9vf5uGHH+buu++mubn5iBxTJGoU2CIhc9ttt3H55Zczd+5cgiCgVCqxa9cuZs+ePebrbr311nEdr1gssnXrVo477jji8Tg33XQTf/Inf8LmzZvf0iV+zTXXsGvXLgA6OztHA91xHO677779Hv873/kODz30ED/84Q9paWk51I8rIsMU2CIhsnnzZn70ox9RX1/PQw89BFS2D1y/fv1bAnu8LewNGzYwb948MpkM73jHO+jo6ODpp59m1qxZ1NbWjnnf97///dH75513Hg8++ODblnfVqlX85Cc/4e67735L+UTk0CiwRULkpptu4qtf/Sof+tCHRp+78cYb2bBhw1sGgY23hb3vtWrLsjjvvPO49dZb33bA2Xjceeed/PCHP+SHP/wh8+bNO6xjiYgCWyQ0HnvsMTo7O/ngBz845vmlS5eyevXq3/u469atGxPOF1xwAT/84Q8Pa0rX1q1bufnmm5k5cybXXXfdmNc+//nP84d/+Ie/97FFokr7YYuIiISApnWJiIiEgAJbREQkBBTYIiIiIaDAFhERCQEFtoiISAgosEVEREJAgS0iIhICCmwREZEQ+P8BYqe1VChmaXYAAAAASUVORK5CYII=\n", + "image/png": "iVBORw0KGgoAAAANSUhEUgAAAewAAAFZCAYAAABaLRymAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjQuMywgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/MnkTPAAAACXBIWXMAAAsTAAALEwEAmpwYAABBu0lEQVR4nO3deZhdVYHv/e8++8xDzZXKUAkhIQOQxAABZE4DUURExNZHpfFFWxQa0Beay9Ott73Pba809BUbiaKmwcZG+m0UmRpbmZRJICCECGSeKmPN46kz773eP05VhUCmSqpO1a7z+zxPnjPW3uusVNWv1rDXsowxBhERERnXfGNdABERETk0BbaIiIgHKLBFREQ8QIEtIiLiAQpsERERD1Bgi4iIeIB/rAtwMG1tfUf0ddXVUbq6UiNcmolL9TU8qq/hU50Nj+preCZSfdXXJw742oRsYfv99lgXwVNUX8Oj+ho+1dnwqL6Gp1zqa0IGtoiIyERT0i7x++67j5aWFiKRCLlcjr/927/FsqxSFkFERMSTShbYa9as4ZFHHuGxxx4D4IYbbuCZZ55h2bJlpSqCiIiIZ5WsS7ypqYkpU6YMPW5sbOSVV14p1elFREQ8rWQt7IULF/L973+fbDZLMBjknXfe2SfA96e6OnrEkwkONtNOPkj1NTyqr+FTnQ2P6mt4yqG+rFLu1vXKK6/w6quvUl1dzY4dO4jH49x4440HfP+RXtZVX5844q8tR6qv4VF9DZ/qbHhUX8Mzkepr3FzWVVVVxY033shVV11Fb28vl156aSlPLyIi4lklnSX+f/7P/2HJkiUEAgHOP/98Zs+eXcrTi4jIBNHfn+Syyz7G8uUrqK8/7aiP98orL/GHPzzLzJmz2Lx5I0uXns855ywFYOPG9Tz88K+YMmUqXV1dXHfdN/D7i/H57LNP8dOf/ohvfONmzjrrnKHjbd++jaeffpJQKMRbb73Jl7/8VU44YcFRlbGkgf3AAw+U8nQiIjJBPfXU7zj77PN4/PGHOeecow/slpYW/vqvv0ZDw2Q6Ozv4/Ocv57e//QOWZfGP//gP3Hnn3dTW1rF8+b/wu989wSWXXMbu3buorq5h0qSGfY7lOA7Ll/8Lt9/+L/h8Pi666BJs++gXdxnXS5OKiMj49NhLW9m2p3dEjzlzSgWfPPvYw3rvzp3b+frXb+Kv/uoz9Pf38847f+Z737uNRYs+hOu6bNy4gS984UrefPNPrFu3lhtv/B/Mn38C/f1JfvCDO5g+fQatra2cffa5nH76GVx22aeHju26hnA4gs/nY9eunWSzWWpr6wBYtOhDPPnkb7nkksuYOnUaU6dO42c/W7FP2dauXYMxhoceepBsNkNFRSWXXvqpo64frXQmh7Sno58NO7pxXJem5j7e3tJBwXFxjaHguABsb+lj5ZoWsjlnjEsrIhPdu+++w6JFJ1FdXcPpp5/JE088wYIFizjnnPNIJCq4+ea/54ILlvHCC3/gxhtv4Qtf+CK//e0TANx//300Nk7nyiu/xPXXf4N//ufvUigU9jn+f/zHz7nxxv8BQFdXJ9FobOi1aDRGV1fnQcvX0rKHd955m4sv/gRXXvklVq9eNXT+o6EWdplLZwv0p/Mk03meen0HmWyB6Q1xtjX3kc05VCdC7GxNAhDw+8gXigH92poWCq4hm3NoqInQ3FFceP/drZ3EowF6+3PMn1HN1LoYlgUzGuJYWPSmclTGglrhTsTjDrclPBp+//unCIcjbNq0gUAgwIMPPsj5518MwLRpjQDE4wmmTi3eTyQSpFLF31GbN2+koqKS+++/D4DZs4+jr6+X6uoaAP7jP+5n1qzjWLr0AgCqq2tIpfqHzp1K9Q+990Ci0RjHHDOTeDwOFFvlq1a9wcUXf+KoPrcCuwwNXsnX2pXmkRe3gOXDdZyhMG7rTg+9tz+dx2/7iEcDdPdliYT8RMJ+OnsyQ+9p7kjh81lUxUN09mboS+UAeGN9K2+sL74nEQtijCGZynNcYyVL5k8il3eZVBXBcQ3tPWmm1EYJ+G2yOYdgwDdioW6MobkzhWVZNFRH9MeCiIclk0ni8QRf+tLVQ899/vOfYt26tYf19ccdN5eamlo+85nPAfDkk/9NRUUlAPfddw/Tp8/gggs+wptv/onZs49j6tRphEIhOjraqa2t489/Xs2ZZ5510HOceOICenp6cBwH27Zpbm5m+vQZR/iJ91Jgl5lUJs8v/7CJXL7YpZ3NOYRCxZZz46Q4C2fV0tyZYmptjMp4kLbuNI31cRLRAF19WRLRALbtY1dbkqjtJ2TbNO3qpb4qTHVFiE27evHZFrFogHe3dZLJOfSkcnT3ZjA+sHw+Nu3sYdPOHoCh8DTGEI8GqE6E2dHSx7T6OHOnV9LRm2VSVQSAddu7qKsMc+yUCna0JklEg9QkQmxv7SMWDhCLBHh3ayehgM2sqRXs7ugnk3XoTmZp6Sz+dV1XGaGuKkxdZYTjj6kiGg6MzX+EiAxbLpfje9/7JwKBvT+3TU3bqKys5O67fwDAli2bWLBgEX/84wv09fWxfXsTTz7532zevJE1a97hyiuv4u677+K+++6hUChQW1uHbdv86lf/yUMPPcjMmcfyyCMP0d7exr/8y4+orKzi29/+DitW3M3kyVNwXZeLLroEKP7e+vnP76WlpZnf//4p/H4/p59+BhUVlVx77Q3cddcdVFVV093dxZe+9JWj/vwlXThluLRwysgpOC75gstvX21i9/Y+/Gnwp+CYWJSl8xvZtambhC8AGRc34+KmXUza4GZcTNrF5FyMA6ZgwDEYdxgnN4Z01sGywB/y0ZbMkMNgBSzSjoOxwQ77yLoOrg1u0MIJgBukeBsAJ1i8dQPveS0EhVDxFt/BW82RUPFv03R237Eqn8+iKhHilLn1NNbHiUcC+A5xLH1/DZ/qbHhUX8MzkerrYAunqIU9Abn9DukdWVatbCaa8hFP+9j8507sbpfqfqg3FpNqIriuIRKy6HilFStXIDnM81i2hWUD/vcEnAsYA6Z4gwGMRdS2hkJ+Sjw69HbjFv9etFzoS+dxXUMsHKAvlaPguAT8NplcAddAIhIgnSuQL7hEQn5yeRfHcQmH/OT8hqzfpaohTD4IvRSoqA0RrQnii9tMqYvhq7BpL+RIBVy29PaxrSOJ6xo6ezI8/foOAEJBmxNm1uC3Lfy2j+OPqSYRDR7pf4WIyIhRYHtUOlsgFPDhdjhkN2XIN+XI7cyS3JLG6nbp7M1QSOXpBXqBCDA4dDtpWozEpBC+Chu70qZyWoyUVcAX9eGL+LDCPnwR6z33fVgh31A4W7YFNsMeCzbGYPIG8gZTMJjcwG2++K8hZzA5FzdtaBho6ZvB27QptvqHHru4KRe338HtdxnqJ+ou3tRjQytAbuDp4ri8D4gDi4DF4RhWwqbHKtBayJD0u6TsPNvfbKEQsShE4c14M74qm0g8wElz6qiIBunJOMSDFrZPF1mISOkosMc51zVDXbTGGHJbs6z7fSvbXu1gcl+ABjtEMp0n4PeRzTt09mYxfshUQWGqD6vWpjtYYNaCGpacORl/nR9faN8L+EvVnWRZFlbQghFusBpjcPvd4r+kU/w3eL/fxUk6uEkXt8/B6XFwex2cXgc3YyBTIA7ECQOQzTn0Z/L4LIt8wSGZLgAOTjjHzlg/+Ri4FTZuwsJXZZOLwZzja5h2XAXELeqqNKlNREaHAnsc27Szh2f+uJ2T3AQNzX6aX+7CShrS2QKVQJoc22J5eusgXQfpWotMrY9cpYWx4IJTGpl/TDV9qTzVidBYf5xRY1kWdtzGjtvQcHiTyIZCvrcY4sUgL+D0vifUux3yHXkK3QXS6QK9fTnoA1osMtkCUBwP72YP3ezB+IAKH6bSRyZqqD4mRsW0MLk4TJ9XSc30KL7Y0a92JCLlSYE9DrkZl57Xetl4fxPztjqk3U6arOKYcD4Ofcda1J9cwRqSZCoMiXiIguOSyTpcuKSRGQ0J+jN5GqqLY8UTOayP1HtDPjD14O81xhQDvNPB6S4QcwJse7cDt8ch05ajdVsSq9dgpVwK3S5Wt0sUyK7tpY3iSlA9tOK3LZwgBCcFCdQFSEdcqmZEmTQrTqHConZGjFBdAOsQk95EpDwpsMeBXW1JVq5t4eR4NYlVBZIv9dLWmiaSdvAHfPRMNvTOgElnVjFzcTUV0SANNVGm7u6huSPFknmTsG2LXN4lGi7+l8YjulxppFiWhV3px670AyFq6xO4S/b2688fuHWzDi1N/TidBUynw/b1PbhdBexul77dWdxegy8N2aYs2aYsAB2k6KAdgM0W+EM2mZjBPylAeEqQVMxQ0Rhh2vxK8lUWtZMiQzPeRaS86Cd/jOXyDi/+son4K1ma9vQQDftJZx2S9YbuU30s+8oc0gGX/kyB+TOq9hkfnT21ktlTK4ce+21NghpLvpDNlLkVQ4+nX1w/dD+dLZDOFjD9LtvXdZNvLxDuh5YtSQrteUJ9UOh0cNMOvgy4HVlSa4uh3kuSXtoA2BCxiEwN4lT5CE8NMXlOgmBDkMT0EOFJIbXOZUJbs+Yd7r77LgqFAqeeejpQvDbbtg0rV77OihX3Yds2L7zwHHPmzGXKlEN0n3mMAnuMFByHXX/spvX/a2Xy+iw+n0XBb2ia7dC+wKJ2ToJzF0ymvj526IPJuBcJ+Yst4wqonRLd73u6k1n6erJEkhYtm5OkdmeI9Fp0NaXItxRDPZ92yG4uBnnyjTSbBqbFWxaEI37yCfDVB6g7Lo6/wU+kMVS8X6+udvG+E05YwEknnUI6neav//prAGSzWTZufJurr75hqEHz4ovPEY/HFdhy9PJ7cqz+v1tJvlVcn7YQhuOunELq5ADVlstfNCSorQyPcSml1KriIarixfkGdfM+uHiCMYaOHf00b+rD12Xo2JIkuTNLoMfFdDiY/gKkgJYCu9/Zu7zsJtsC28LU+IjPiGDqbPwNARpPqCA2PUKgzq9L1GTYWv/vbtKrUyN6zMiHokz6H4cfsoVCgZ/85If8xV+cw2c+cynLl/+Urq5ONm7cADzBu+8WVzabKBTYJeTmXHof66LniS7Su1I4IXDOi1D/8VpmLpw01sWTcc6yLOpmxKmbEf/Aaz39OZpb+gn1GVo3JOnY3E+wx1BozuFrdwn0G2h26W3ee/le10A3OwEITglCnR8m2VTPjBJsDBGcGmTajMQhV34TKbU33/wTP/jBHRhjsCyLCy64gBUr7gGKrfA5c+bysY9dwsknLxnjko4sBXaJ5HbmaF/eTH5XjlQmT9tcyHwkyuc/OU/X7cpRq4wFqZxVnAg380N7dxIyxtDTn4OcoW1zktYNfQS6DNldWZI7MgS7DXYKcttzsL24yEwLe0N9U9zCnhzAmuxn+oIqGo6vIDAlgF3r1/dtmRtOS3iknXzyEq6//v/FGMOOHdvHrBylpsAeZcYY+v/QS+f97Zici1Nrs/XMADvsHGcfX6NfejKqLMsa6mavqgkz59S6D7ynpz3DrrW9mLY8ud05+ralsTtcTGuBQtLF3ZSDTTm2vZRil7+ZUMAmXhWk4pgIwcYQgakBAlOD+KcGCUwOYPn1PS2lYVkWM2Yc84HnfQNDPLt27aS6uoZodP/zRrxGgT2KTMHQ+W9tJJ8vXovbPNvw2vxeXNvCsizmzage4xKKQGVdmMpzPjhnwnVdOppS9DdlaNvQx+41vdjtDuEul+SePM17+rF9FrFIgGjYT8D2EQj68NcHCEwL4h8I8kBjECcxMX5hythat24Nq1evIp/P8/vfP8P5518IwHPPPUdLSzOPPvprrr32Bk499XT+678exbIsbrnlW2Nc6pGj3bpGiZt1aV/eTPqtFL6gRcX/U8sDnTvIF1wq4yHmNFZy1sIpY1rGQeOhvrykXOvLcV06e7M0Nfexfl0nmZ1Zgp0u4S4IdUOo21CZsYmHA/j9PsJBe6gHKRTy41RaBBuDBKYFCUwvBnlgShAroBb5+5Xr99iRmkj1pd26SsxJOrT93z1kN2fIBw0dnw3RPiVPvtVlSl2Mz/7FcWNdRJFhs30+6qsi1FdFWDJ/UnHWek+Gd7Z10t6dYWd3mkK6QKgnR6gLEkmL+myAUAfUZgz+DBRacvDm3oC2fOBvCBTDuzFEYFqQ4PQg/gZ1rYu8nwJ7hDlJh9Zbd5HbnsNf6+eNc3Ps6OuE1cXXFxxbc/ADiHiEZRU3O1m6eBoA2bzD2m1dtHanaetOs7M7zU7yAAT9LlZrgUgXTC2EqE8H8Lc7BLshuNuQ352D1/v3Htu2imPjg63xaUEC00P46/26nlzKlgJ7BLkZl7bv7SG3PUdgcoCKmxvY+dKGodcDAZs5jZUHOYKId4UCNovn7J3U1t6TprsvR09/ji0tfewu9JGtgW5yDG57ahUM4W6IdEJdNkBtyk+g3SXcB5Eml9yOHLy69xy+oFVsjR8TIjg9SGBG8Vabqkg5UGCPEGMMHT9tIbspg7/Wz6S/n8aWVBJjDJNro9RXRZhaGyPg1y8WKQ91lRHqKiMAXHT2LNra+sjmHDbt7qGjJ0MmW6C5K01PMEu6ztDJ3h3QfHlDqCtLZdJHbcpPZZ+Nv80l2A2RtIO9ObN3g3fAX+sfCu/AjBDBYwa61dUalwlEgT1Cen7dSer1fnwRH5NumYq/1s+2zcXZ4cdNq+KUefWHOILIxBcK2pw484PDQvmCy+72fjp6M2RzDjtak7SEUjS7hmbyMNC1bmcM4Q6IdkJ10qau30+40xDYVSDclie96j3j44GBSW4zQgRnFG8D04PFbVhFPEiBPQLSb6fofawLy4K6GyYTmBbEGMO2luKsxWOnHHjWn4hAwO/jmMkJjplc/Fk5A3CNoT+dp7U7TVdvlrzj0tKZoqUyTXujQ5tx2UAOXEOoB8IdEO+Cyj6b2j6bUA8E+vMEt2T2We/AX+MnMCNIcEZo6NY/Wa1xGf8U2EfJ6S7QcXcLxkDVp2uILIqSLzg899Zu0pkCiWhQ+1GLHAGfZZGIBklEg/C+RbUc16WlM82ejn56+3O0dKVpq03T4xp24QJusTXeWWyNV/X5qOj2Ee+1COzM4W/OEF5lD3Wr+4LWQFd6iOCxxdtAoy45k/FFgX0UjDF03teG0+cQPiFCxSeLC6E8/aedbNzRjW37OHvRFK1mJjLCbJ+PqXUxptbt3c3OGEPBcWnuTLOzLUlvf4627jRtPRnaMIBTbI33QrgdEr0WdUk/8S6LaK9FYG0B/4b0UEvbsi0C0wIEZw4E+MwQwRkhfBFtlCJjo6SBfc8997Br1y6qq6tpamriu9/9LuGwd3elSq3sJ/WnfnxhH/YXqti8u5dJNRE27ezB57P43PnHUVcVGetiipQFy7II+G2mT4ozfdLeDVLyBYdkukB7T5rmjhT9mQKtXSl29mXZOTDJzU4bIu0Q7YC6pJ+KLotQtyHcnye4NYPts8CysCzwTwoUZ6kfGxoKc7tC4+Iy+koW2G1tbaxYsYJXX30Vn8/Htddey1NPPcWll15aqiKMKDfl0vXvxd2Oqj5fy39v2U1zR4r6qgjGGI5rrFJYi4wDAb9NdcKmOhFiTmPV0PO9/Tk6ejO0dKbY3dFPclKe9v4cra4DFGeqhzsKRNoNiU6Lml6bWI+F3ZslvD1NaOXeldz81X4CxwSLAT4Y4nXaIEVGVskCOxKJEAgESCaTVFRUkEqlmDNnTqlOP2LautNkcg6J32dxeh1Cs8NElyZoe2z70OugBVJExruKWJCKWJBjp1QMPZcvuDR3pkimcnT2ZdnZlqQ7maMjW2AbLpZjCHdBpD1HpB0SXRZVPT7CfTb2zhSh122Cfh9YFnbcR/DYcLElfmyI4Kwwdo2tEJcjVtK1xB999FH+67/+i/r6eowxfPvb3yYWix3w/YWCg3+cXbd814OrSO/O8tE/RLGNxew7ZpNusPjRQ6uH3lMVD3HDZxfrB1NkguhP59nR2kdvMkdnb4Ytu3vo7MngGgPGEOyGcJsh0mYIt7lE2yDm2oSCNrbPIhS0CQX8BKv9xOfFiBwXKf6bEyFQExjrjyceUbLAXrt2LbfccguPPPIIfr+f2267DZ/Pxy233HLArxlvm3+kswVWPP4u03/vcnxbmPoLaqi7toFNO3v4zSvbmFofo6E6yrFTKvYZQxvvJtLC+aWg+hq+iVhnxhj6Unl2DbTCe/pz7GpPkkzlwRgCSYi2QbTNEGk1RNvBzoDftoYWUAoGfIRqAvhnBonNiVI5P0pkdoTJc6onXH2Npon0/TUuNv9oaWmhqqoKv98/UKh69uzZU6rTj4juZJZgt6FmgyFX4VJ5ebHbu6M3A8DkmijnLBq7Td1FpHQsyxroVt93+MsYQzbvsKutn+5kjkyuwJ6OFC19GdwOh+Ael2i7UwzyNrC352B7P7zQNXQMu8aPmebHneYneGyImhPjRGqCxMJ+qitC2D7NVC9HJQvsc845h+eff57bbruNRCLBxo0b+eY3v1mq04+Izr4sk980YKD7eB+BhmJXVudAYNdWeHfGu4iMDMuyCAf9zJ72wX0DjDF09WXpTeVwXENrR4qe7WnMjjxOUw5rZ4FIq8HX7eB2FuBtyJGkmQ7ycUjVW6QnWTiNNkwPEK4MEAn5qasMs+DYWqJhXak7kZXsf9e2bf7X//pfpTrdqOjekaJ6gwELmhbuHUloV2CLyGGwLIuaijA1A78rZk+thIX7vqfgOLjtsO3VNpymLOktGQrbcpisIbrDJb/VhZUukCdbBalJFhsa4M+Tm5l0fIJZMyqZ01hFKDi+5v/I0dOfY8OQeyGJZaB7tkWXP08mVyDg99Hdlx34QdSKZiJydPy2Tf2CBMGGvYFrXENhT57c1iyZzRlSG1Nkt2Yp5FycVkP/9jypTAFjd7O9tpsNU3YQOS5M7YIK5p5cQ1VCjYmJQIF9mNyci39lBgfoPtkGDG3dGVzX4LqGynhQO3GJyKiwfFZxT/BpQWJnJ6gFTMGQ254ltyVLbnOG/g1p+ramSPbkSbc6sDpF6tcp3gg1Y6b5Cc+NMP2UKqadUoW/SjPTvUiBfZiSr/Th9rukJ1lMObmSnu3dPP7HrRQKLgC1lVokRURKx/JbhGaFCc0Kw4WV1AJuv0Nua5a+df10vpukZ20/6bYcZkuBwpY+tv6uj+2+nfjr/FQcH6P6xARVx0cJz47gC2si23inwD5MXc92Ywz0nxzg+EkJ1m3vplBwiYYDHDM5wanzJ411EUWkzPliNuEFUcILotT/ZXG9i1x7nrbVvex+q4fud5P4dzs4rXnaWrtpe74by4Jo2E/4mDCxuRHqFlYQnhMubn6iHczGFQX2YSi05kmtSeH6IXByhPnHVJEvuFQnQkxviOPTAikiMg5ZlkWoPkjjhXU0XliHMYbeZI4db3ez+80e8lsy+HYWMB0F+tcl6ViXZNcT7YSCNoGoTWxulKoFMeLzo4TmRLATGvYbSwrs/TDG8N+vNgFw8YePof+lPnJ5l55ZFrX1EWyfj8Vz6sa4lCIiw2NZFpWJEJVnNrDgzAYA+lI5Nm3tpntdP73r+jFNeaItBYKdBXpezbL71S58PotIyCY0OUhobpi6RRUkjo8RmB7EstVgKRUF9n44rmHTzh4Akuk8yZf6yOQcOudaLKiNjnHpRERGTiIa5KQTJ8GJxcddfdnitqRN/XS83Ut+S5bwbhenrUD/1gJsTbHnyU4Cfh922EdwVoj4/BjReRHqF1cQqtaEttGiwN6PbN4Zut/8Ti+BlhzJgENymsW0ugOvfS4i4nXViRDViRBzp1fB2dOGlmBt2tVL14Z+UhvSZDdmiOxxCfa6ZP5coPfP/QBstsBX78c6JkBsXpSaRQkSs6NUVYbwaTz8qCmw9yOXd4fud7/cQ2XepXsGVFWGiYb116OIlI/BJVgXzq2DucWhwILj0p3M0rk7RdtbvWQ2ZqApXxwPby1Aa4Ge19P00IHxQ6bBwj42hD07SOUJcabMjFOdCBMJafey4VBg70fuPS3s3Ko0mZxFz7EW09W6FhHBb/uoq4xQVxlh7vG1Q8+nUnna1/XRtzZF75p+CltyWO0FrF0GdmXgpQxJenk3Af2TLQoz/MTmR4jMDFNbFaahOkplPEgooCDfHwX2fgx2iQd7DO6uPOmEn+Q01B0uInIQ0WiAGSfXwMl7N0Rx+hx61iTpejtJZkOazKYMuX6H8GYXd2Mens3jBnppaoA1Uyz6GyysmQEmT41TWxGmOhGiKhGiWotTKbD3Z7BLvHKbwXENzZMKGNunwBYRGSY7YVNzeiU1pxc3QzGuIb8jR2ZDmp53+kmu6afQlqeiwyXX7FBwXFyypGuz7JhssW6yRf8UyMctKuMhJtdEqYoHqakIM7UuRjxSPsOUCuz9yBaKLezEzuIGHz0zYNbUCirjWitcRORoWD6L4DEhgseEqFhWBUChq0B2fYbsxjTZDRn6N6XJZgvkt7nkNrkUCi6piEOyIU3H5DTbJ1ukawGfRTjkp7EhQUXYP9Qan1wTxW9PvJXbFNj7kcs7WI4hNrBdd/D4KB89bcbYFkpEZILyV/vxfzhO7MNxANyMS25Lthjg6zNkN2WKy672uGTbHQpvuWQsl85ql776HJ0zethS7eCGiuPePp9FVbw4271xUpxJVRGqEyEiIW9HnrdLP0pyeZdoC1QFg/iPCXDaxbMIBsp77EREpFR8YR/hEyKETyju0WCMIb8zR3ZjhuyGDLmNGfIteabkDc5Og9lpkUznyNRYdNe7tFQW6JucpjOeZvOunqHj1lSEmVYfY1pdjGn1cc91pyuw9yOXd0jsNPhti8aza3Qpl4jIGLIsi+D0EMHpIRLnF8fCne5CMcA3ZvDtcAisSWJyhsm7YN4OQ361Sy4CPZMMXfUuzZUFOk2azt4Mb2/uAOD4mTUsW9LomRnpCuz9yOYd4rsMPssifKJWNhMRGW/sKj/RU+NET41TX5+gZVfPQDf6YCs8TTDpEt8N03bDiSZAzm/on2zRUeuwPZZjndNBwLbY2d5PIhLgglMaSUSDY/3RDkiBvR+5lEO0FXyVFuH52vhdRGS88wV9hOdHCM/f241e2J0ns35gHHx9Gqu9QGgX1OzyMy1taO5L0z+pleBki84pFv/fnvWcvKiBDx1XOy4vIVNg78+OPJYL9vQgvtj4+08TEZGDsyyLwLQggWnBoW70QkeB7Po02XVpAuszZNc6+PbkaOwLklvjkMrmaavdyX9P38O006upXBjHSti4xtBYHycaHtvIVGDvh7U9D0Bgti7jEhGZKPy1fvxnJoidmQCgIemQWZcmtzFDZl2annX9dPVkya5ySK5qJ0k72Uron2Lx2jSLmkUJ5p5Uy7FTK7B9pb9sTIG9H/bO4nXYIQW2iMiEZcdtYkvixJYULydryLpkN6bZ9Xo3bat68TXliWahaiuk1xXg2R62xnpY32gTnBsmPd1iydJpTC3RoloK7PcxxhDcVQzsyHxNOBMRKRe+kI/IghjHLYhx3JemYQqG3PYs2XUZ+t5N0vFWH8n2LIH1DqzvJwA097Uz9UsK7DHhdDr4koZ8CKLT1MIWESlXlt8iNCtMaFaYiourmGoM+V05Wt/spX9NP/4Ow5ST6kpWHgX2+2Q2pnFdQ6oBgkFNOBMRkSLLsgg2hmhsrIdL60t+/om32OpRSm9IA5CdYuPzyMX0IiIy8Smw3yezPQuAM1mtaxERGT8U2O+TayoGtqvAFhGRcaRkY9g7d+7kqquuYsqUKQAkk0nmzZvHbbfdVqoifIDrGn713CbqqyKcf3IjTq+D01PADYCvToEtIiLjR8kCOxaL8Y//+I+ceeaZACxfvpwzzjijVKffr2Q6T3NHiq6+LOef3Eh+RxbHhUwNhIKajyciIuNHybrEq6urh8I6l8vxzjvvsGTJklKdfr8c1xTLk3dxjSG3I4cxhnSNpe00RURkXBmTZuQTTzzBxRdffMj3VVdH8R/hAuz19YlDvsfx+QgObGieqIiQ7+rFZ/soTLapqYoe1jEminL6rCNB9TV8qrPhUX0NTznU15gE9u9+9zt+9KMfHfJ9XV2pIzp+fX2Ctra+Q76vrTNFLlsAYOfuHrJresnlCvRVuOSz+cM6xkRwuPUlRaqv4VOdDY/qa3gmUn0d7A+Pkgf2ypUrWbx4MYFAoNSn/oCC4w7dT2fyFHbmcF1DpgZ1iYuIyLhS8su6HnzwQT73uc+V+rT75Q6MYQNkW3OYvCEftXDCFpGQJp2JiMj4UfJU+v73v1/qUx5Qwdkb2OldOWJAtrhtKrGIAltERMaPsl44xXH3donnm4t7YKfixRCPh8e+y15ERGRQWQf2e1vYheYcAMlYMcSjYbWwRURk/CjrwH7vGLbTVgBj6Iu6WJalwBYRkXGlrAP7vbPETWsBxzVkKyEcsrF9ZV01IiIyzpR1Kg2udIYx0OlQcAzZCo1fi4jI+FPWgT3Ywg4kwc0bnJiFG1R3uIiIjD9lHdiDLexQb3E826m2AIhF1MIWEZHxpaybks7ALPFQt8FxIVtZDGx1iYuIyHhT1i3swsB12KGeYgs7lSgGuBZNERGR8aasA3uwhR1IFh93B4sbgcTUwhYRkXGmvAN7YAw70F+87bCKq51pDFtERMabMg/sYpd4cKCFnQ4VH8c0S1xERMaZsg7sgmPANQT6i4/z8eKtLusSEZHxpqwD23Fc/GmwgEIEjG0xuTaqVc5ERGTcKetkclxDMAmhgE0+DjWVYT5x5rFjXSwREZEPKOu+X2egO7wqEaL2xDAfuXCGWtciIjIulXU6FRyXQNLg81nUzogprEVEZNwq64Qa7BK3ALu2rDsbRERknCvvwHaKXeI+y8JfrcAWEZHxq8wDu9gljgV2jQJbRETGr/IO7IFJZxaWusRFRGRcK+vALhScYmBbYFfbY10cERGRAyrrwLaSBssFf8LGFyzrqhARkXGubFPKGINvYNMPu0qtaxERGd/KNrAd1xSXJbXArtD4tYiIjG9lG9gFx8WfAcuy8CXUwhYRkfGtbAO72MI2Ay1sBbaIiIxv5RvYjhnaqcuuVGCLiMj4VtLB2y1btvCb3/yGUCjE66+/zg033MCiRYtKWYQhe8ew1SUuIiLjX8kC23EcbrvtNn7yk5/g8/m47LLL8PvHbrLX3jFssBXYIiIyzpUsMd9++22MMdx///1kMhmqqqr47Gc/W6rTf8DeMWwfPo1hi4jIOFeywN69ezdvvfUW3//+90kkEtx8880EAgEuv/zyA35NdXUUv//IwrS+PnHQ11MFQyjnw2/7qD+2gnB9+IjOM1Ecqr5kX6qv4VOdDY/qa3jKob5KFtixWIxZs2aRSBQr9ZRTTuG11147aGB3daWO6Fz19Qna2voO+p629iRWv4uLj+5CBrstf0TnmggOp75kL9XX8KnOhkf1NTwTqb4O9odHyWaJf+hDH6K7uxvHcYBii3vmzJmlOv0HFHIudhYsH/hiZTtZXkREPKJkLeyqqipuvvlmbr31Vqqrq+ns7OS6664r1ek/oNBbAMBELSzLGrNyiIiIHI6STtNetmwZy5YtK+UpD8jpKbb0TVytaxERGf/KNq3cZLGFjQJbREQ8oGzTyul1AbAU2CIi4gFlm1buQJe4WtgiIuIFZZtWJlkMbCuuRVNERGT8K9vAdvuKXeK+RNlWgYiIeEj5plX/QGCrhS0iIh5wyMD+05/+VIpylJybHghsLZoiIiIecMjrsP/u7/4O27a5/PLLueyyy2hoaChFuUZfxgDgi6qFLSIi498hm5fPPPMM//t//2+2bNnCxRdfzFe/+lWefPJJCoVCKco3elLFFratFraIiHjAYaXVhz/8YW6//XZeeOEFli1bxn333ce5557LP/3TP412+UZNob84SzxeHRzjkoiIiBzasJqXsViMv/zLv+RrX/saU6ZM4cEHHxytco0qY8xQYFeX+baaIiLiDYe9lviWLVv49a9/zeOPP86kSZO4/PLL+cQnPjGaZRtxm3f38OdNHZx3whTcvAE/JCpDY10sERGRQzpkYD/44IM8/PDDbN++nUsuuYR//dd/Zf78+aUo24h74o/bAHh8d5qZgB23tVOXiIh4wiED+5lnnuFLX/oSF1xwAdlslqamplKUa1RlevMABOMl3axMRETkiB1yDPtf//Vfueiii3j55Zf5+Mc/zg033ADA22+/zTXXXDPqBRxJFbHiBDM7V3wcrFBgi4iINxz2pLO77rqLhx56iIqKCgAWLlzI9u3bR61go6EqXhyvtrPFx+GKwBiWRkRE5PANa5Z4fX39Po+DQW9dEmUGbgcDO1qlwBYREW847MCOxWK0t7cPTdJauXIliURi1Ao2GowpRradK95GdQ22iIh4xGEP4t58881cffXV7Ny5kyuvvJJt27bx4x//eDTLNuIG8ho7CwG/D39My5KKiIg3HHZgL1q0iH//93/nzTffBOCkk04aGs/2CjPQKT6jKkZ9lauNP0RExDOGNU06kUhw3nnnjVZZRt1gC3tKLIodzGjjDxER8YxDBvYDDzxw0NevuOKKESvMaBscw2Zwa82IWtgiIuINhwzs73znO5x44onMnTu3FOUZVYN5TXpga011iYuIiEccMrBvvfVWHnnkETZu3MinPvUpLrnkEiorK0tRthG3N7CLLWwrqsAWERFvOGRgX3755Vx++eXs2LGDRx99lM997nPMnTuXa6+91nNrig92iZvBFra6xEVExCMOO7GmT5/OVVddxRe/+EVee+013n777dEs16h4fwvbp8u6RETEIw7ZwjbG8OKLL/Lwww+zceNGPvaxj/HLX/6S6dOnl6J8I8plsIXtAj61sEVExDMOGdjnnnvu0P7X1113HZZlkc1m2bRpEwDHHXfcYZ/ss5/9LKFQcT1vn8/Hz3/+8yMs9hEygGsga7CCYEW0taaIiHjDIQM7EAjQ1dXFvffey89+9rO9l0YBlmXx7LPPHvbJzjnnnKHdvsaCMWZopy4r6tNe2CIi4hmHDOzf//73I3ayDRs2sGLFCrLZLAsXLmTp0qUjduzD4ZqBjT8sS93hIiLiKYcM7H/+539m2bJlnHTSSUd9squvvppFixbhOA5XXHEFsViMU0899YDvr66O4vcf2cSw+voPbkwSCvkxlk0waBOrCe/3PeVKdTE8qq/hU50Nj+preMqhvg4Z2PPnz+ff/u3fuOWWWzjttNO44IILOOuss4bGoodj0aJFANi2zZIlS1i5cuVBA7urKzXsc0DxP66tre8Dz6fTeZyUQz7nkHEK+31POTpQfcn+qb6GT3U2PKqv4ZlI9XWwPzwO2S986aWXctddd/Gb3/yGj3zkIzz33HN8/OMf57rrruPhhx+ms7PzsAqxefNmfvWrXw09bmpqKvlMc4PBlwcssMIavxYREe847M0/gsEg5513Hueddx7GGFavXs0zzzzDz372M5544olDfn08Huf555+ntbWVZDLJ5MmT+cQnPnFUhR8uY8AugAX4QhrDFhER7xjWbl2DLMti8eLFLF68mJtvvvmwvqahoYEf/vCHR3K6EWOMwVco3reCamGLiIh3lFUz0xjw5Q1gYamFLSIiHnLYLew333zzgK+dfPLJI1KY0WYAOw+WBVZILWwREfGOww7sl19+GYDVq1fjui4nnngia9asIRgMcvfdd49aAUeSMQZroEtcY9giIuIlhx3Y119/PQBf/epXuffee4eev/rqq0e+VKPEHZh0BpolLiIi3jLsSWfZbJann36a448/nrVr15LNZkejXKNisIVtAVZQLWwREfGOYafWXXfdRVNTE/fccw9NTU0sX758NMo1OkxxDBuNYYuIiMcMO7DD4TBz5szhlFNOYdKkSbzwwgujUa5R4ZqBhVPQGLaIiHjLsFPrK1/5CuvWraNQKOA4DoVCYTTKNSqMAd9gl7ha2CIi4iHDHsOOxWJ87WtfG42yjLriwinF7UF1HbaIiHjJEa10dtNNNzFnzpyh/aSvueaaES3UaBjcx9vKA7aFTy1sERHxkGEH9pe//OV9Hg+G9ng3kNfYBQtszRIXERFvOezAfvzxx7n00kt54403hkLaGINlWQfdInO8MBQT2+cMtLR1HbaIiHjIYQf23LlzATjllFNGrTCjaaiFnS8GtcawRUTESw47tebPnw/ASSedRHt7O6tXr6a9vZ3FixePVtlG1OAY9uBuXT7t1iUiIh4y7GbmDTfcQGtrKwsWLKC1tZUbbrhhNMo14lwDaJa4iIh41LAnnRUKBa666ioAzjjjDF588cWRLtPoMGC5YBkLy7aw/Gphi4iIdxx2YP/4xz/Gsiwsy+L6669n3rx5rF+/nlAoNJrlGzHvXeVMi6aIiIjXHDKwb7jhBpYvX84pp5xCNpvdZ+/r008/fVQLN5L2WeVM49ciIuIxhwzsHTt2AHDaaadx+eWX8/DDDw+9dt999w11j493hoEWtqV1xEVExHuGlVyu6+7z+LHHHhvRwoymwRY2gBVWYIuIiLccMrneu5LZ+1c1G7xUygvMwBi2usRFRMSLDtkl3tTUxDe/+U0WLlxIOp0mn88TCAQA7yxLCvu2sNUlLiIiXnPIwF6xYgVr1qxh9erVBAIBTjnlFKZOncrcuXNpaWkpRRlHRHGnruJ9zRIXERGvOWRgL1myhCVLlgw9zuVyrFu3jnfffZfKyspRLdxIcg348sW1z7VoioiIeM2wF04JBoMsWrSIRYsWjUZ5RpVa2CIi4lVl09Q071k4RWPYIiLiNWWTXO7AGLZlaZa4iIh4T9kEtjHsXZpU12GLiIjHlDS5MpkMn/jEJ7j99ttLeVoADO+9rEstbBER8ZaSBvadd97JCSecUMpTDjHuey/rUgtbRES8pWTJ9eijj3LyySfT2NhYqlPuw1DsEi9e1qUWtoiIeMuwL+s6Eps2bWLLli3cdNNNrF+//rC/rro6it9vH9E56+sT+zzOuBDAh21b1DTEqXjf6+Xu/fUlB6f6Gj7V2fCovoanHOqrJIH99NNPEwwGWbFiBW+88Qb5fP6wdvrq6kod0fnq6xO0tfXt81xnZz9uzsF1bLr7UmTb1MoetL/6kgNTfQ2f6mx4VF/DM5Hq62B/eJQksK+99tqh+9lsllQqVfJtOV1jsJzifcuvsBYREW8p6eyrJ598ktdff5233nqLJ554opSnBgO+wcAOKLBFRMRbStLCHvTRj36Uj370o6U85ZDBFrZlAWphi4iIx5TV9U3FLnFLLWwREfGcsgls1xgst3hfgS0iIl5TNoFt3juGrS5xERHxmLIK7MExbLWwRUTEa8onsNFlXSIi4l3lE9ju3i5x1MIWERGPKZvAdlxXXeIiIuJZZRPYDLaufRaWpcAWERFvKZvANvmBa7pKulSMiIjIyCibwHbzxVtjq3UtIiLeUzaBrRa2iIh4WdkENgVTvFULW0REPKhsAtsMBrZa2CIi4kFlGNhqYYuIiPeUT2DnFdgiIuJd5RfY9tiWQ0RE5EiUUWAP3FELW0REPKhsAptC8bIuS5PORETEg8omsF21sEVExMPKJrBxBhdOUWCLiIj3lE9gFwZuFdgiIuJBZRPYQ7PEtbWmiIh4UPkE9sDCKZp0JiIiXlQ2gY1WOhMREQ8rm8BWl7iIiHhZ2QQ2Q13iCmwREfGeMgrsgVstTSoiIh5UsilYrutyzTXXsGjRIvL5PDt27ODWW28lHA6X5PyDXeKWv3z+RhERkYmjpOm1ePFirr/+em688UbS6TRPPfVU6U4+2CUeKN0pRURERkrJAtvn8/E3f/M3ABQKBVpaWjj22GNLdXpwBm416UxERDyo5Fclv/jii9x3330sXbqUhQsXluy8Q13itgJbRES8xzLGmLE48S233MKHPvQhrrjiigO+p1Bw8PtHZpbY09e8Re8rvUy9uZEzrpw1IscUEREplZK1sDdt2sTOnTtZunQpAI2NjezcufOgX9PVlTqic9XXJ2hr69vnuWwqj+saUrncB14rd/urLzkw1dfwqc6GR/U1PBOpvurrEwd8rWSBHQwGeeihh1izZg2FQoHNmzfzP//n/yzV6bX5h4iIeFrJAnvGjBn88Ic/LNXpPmhglrhPk85ERMSDyuei5KHLuhTYIiLiPeUT2LqsS0REPKx8Arugy7pERMS7yiiwizfqEhcRES8qo8DWGLaIiHhX2QS2NTCGre01RUTEi8omsNXCFhERLyvDwC6fjywiIhNHWaSXMWbosi5trykiIl5UFoE9OEPc2GD7yuMji4jIxFIW6WXyBmPAlMWnFRGRiagsIswMjF8bG3yWJp2JiIj3lEdg5w1gcG1QXouIiBeVR2C/p4VtKbFFRMSDyiKwKewdw1Zci4iIF5VFYBe7xFGXuIiIeFZZBLYvVvyY+bilLnEREfEk/1gXoBT89QF2Xxlmt5PmVOW1iIh4UFm0sAFyk304EUuXdYmIiCeVTWC7bnEcW7PORETEi8omsAfiWmPYIiLiSeUT2KYY2WXzgUVEZEIpm/wygz3iamGLiIgHlVFgD+yHrbwWEREPKp/AHrhVC1tERLyofAJbLWwREfGwsglsV2PYIiLiYWUT2EMt7DEuh4iIyJEo2dKk27dv58477+SEE06gubmZqqoqrr/++lKdfmgQWw1sERHxopIFdnd3NxdffDEXXnghABdffDFLly5lwYIFJTm/usRFRMTLShbYixYt2uex67pEIpFSnR4z0MT2Ka9FRMSDxmS3rqeffpqzzz6b2bNnH/R91dVR/H77iM5RX5/Y53Ew6McxUFeXIBYJHNExJ7L315ccnOpr+FRnw6P6Gp5yqK+SB/arr77KypUr+eY3v3nI93Z1pY7oHPX1Cdra+vZ5LpPJk8s5dHQkSYXKYlfRw7a/+pIDU30Nn+pseFRfwzOR6utgf3iUdJb4c889x0svvcS3vvUt2traWLVqVcnOPbg0qbbXFBERLypZYL/zzjvceOONrF69mi9+8Yv8zd/8DVu3bi3V6bVwioiIeFrJ+oYXLFhQ0hb1+xld1iUiIh5WPgunDNzqsi4REfGi8glsdYmLiIiHlVFgF2/VwhYRES8qi8A2xmgtcRER8bTyCOyBW8uy1MIWERFPKo/A1vi1iIh4XJkE9liXQERE5OiUVWBrlTMREfGqMglsdYmLiIi3lUlgF2814UxERLyqLALbVQtbREQ8riwCe5Ba2CIi4lVlEdgawxYREa8ri8B2B8ewtc6ZiIh4VFkEtlrYIiLideUR2AO3CmwREfGq8ghsXdYlIiIeVyaBXUxsn/JaREQ8qkwCe/CeEltERLypTAJbLWwREfG2Mgns4q3GsEVExKvKJLB1WZeIiHhbWQS2O3CrhVNERMSryiKwUQtbREQ8riwCW2PYIiLidWUR2LFIAJ/PoioeHOuiiIiIHBH/WBegFOKRAH/98eMJBe2xLoqIiMgRKYvABoiGA2NdBBERkSNWsi7xtrY2vvWtb/HpT3+6VKcUERGZMEoW2G+88QYXXHDB0DXRIiIicvhKFtgXXXQRsVisVKcTERGZUMb1GHZ1dRS//8gmitXXJ0a4NBOb6mt4VF/DpzobHtXX8JRDfY3rwO7qSh3R19XXJ2hr6xvh0kxcqq/hUX0Nn+pseFRfwzOR6utgf3iUxXXYIiIiXleywH7ttdd47LHHaGtr4+677yaTyZTq1CIiIp5Xsi7x0047jdNOO61UpxMREZlQ1CUuIiLiAQpsERERD1Bgi4iIeIBltPSYiIjIuKcWtoiIiAcosEVERDxAgS0iIuIBCmwREREPUGCLiIh4gAJbRETEA8b1bl3D9fLLL/PUU09RW1uLZVlcf/31Y12kceezn/0soVAIAJ/Px89//nO6u7u54447mD59Otu2beOmm26irq5ujEs6dtra2rjzzjtZt24dv/71rwHIZrPcfvvtNDQ0sG3bNr761a9y7LHHAvDYY4+xdu1afD4fM2bM4HOf+9xYFr/k9ldfDz/8MP/5n/859L326U9/mssuuwxQfW3fvp0777yTE044gebmZqqqqrj++usP+nN4zz33kEwm6e3t5ayzzuKCCy4Y409ROgeqr+XLl/Paa68Nve+aa67hrLPOAiZwfZkJIpVKmQsvvNBks1ljjDHXX3+9efnll8e4VOPPXXfd9YHn/uEf/sH85je/McYY8+yzz5qbb7651MUaV37729+aZ5991nzqU58aeu6nP/2pWbFihTHGmHXr1pnPf/7zxhhj9uzZYy699FLjuq4xxpjLL7/cbN26teRlHkv7q69f//rXZseOHR94r+rLmNWrV5unn3566PHHPvYx8/bbbx/w5/Ctt94yX/nKV4wxxuTzebNs2TLT29tb+oKPkQPV1/5+lxkzsetrwnSJv/XWW0ydOpVgMAjAySefzHPPPTe2hRqHNmzYwIoVK1i+fPlQ/Tz//POcdNJJQLHenn/++TEs4di76KKLiMVi+zz33HPPDdXRvHnzWLduHclkkhdffJETTzwRy7IAOOmkk3jhhRdKXuaxtL/6AnjggQe49957+eEPf0h3dzeA6gtYtGgRF1544dBj13WJRCIH/Dn8wx/+wOLFiwHw+/3MmjVrn5blRHeg+gL48Y9/zL333suKFStIp9PAxK6vCdMl3tHRsc8vjXg8TkdHxxiWaHy6+uqrWbRoEY7jcMUVVxCLxfapu3g8Tk9PD4VCAb9/wnx7HLUDfX91dnbu8/xgfZa7U089laVLl1JTU8Pzzz/PN77xDX7+85+rvt7n6aef5uyzz2b27NkH/Dns7Oxk1qxZQ18Tj8fp7OwcqyKPqffW10UXXcS0adOIRqM88MADfOc73+HWW2+d0PU1YVrYtbW19Pf3Dz1OJpPU1taOYYnGp0WLFgFg2zZLlixh5cqV+9RdMpmksrJSYf0+B/r+qqmp2ef5/v5+fd8B06dPp6amBoAPf/jDvP766ziOo/p6j1dffZWVK1fyzW9+E+CAP4fvr7NkMjlUt+Xk/fU1Z84cotEoUPwee/XVVwEmdH1NmMBevHgxu3fvJpfLAfDmm2+ydOnSsS3UOLN582Z+9atfDT1uampi+vTpnHfeeaxatQoo1tt55503VkUct5YuXTpUR+vXr2f+/PnE43HOOecc3n33XczAkvyrVq3i3HPPHcuijgt33HEHhUIBgG3btjFt2jRs21Z9DXjuued46aWX+Na3vkVbWxurVq064M/h0qVLeeuttwDI5/Ns2bKFU089dayKPib2V1+333770OtNTU3MmDEDmNj1NaE2//jjH//Ik08+SXV1NYFAQLPE36elpYXvfOc7HH/88SSTSQqFAn//939Pb28v3/ve95g6dSo7duzgb//2b8t6lvhrr73Go48+yosvvsjnP/95vvzlLwNw++23U19fz/bt2/na1762zyzxd955B9u2mTlzZtnNet5ffT344INs3LiRxsZGNmzYwBe/+MWhccVyr6933nmHK6+8kgULFgCQSqW44oorOP/88w/4c3jPPffQ29tLT08P55577sSZ9XwYDlRfW7duJZ1OU1tby4YNG/j6178+9DM5UetrQgW2iIjIRDVhusRFREQmMgW2iIiIByiwRUREPECBLSIi4gEKbBEREQ9QYIuIiHiAAltERMQDFNgiHvX6668zb948HnnkkaM+1p/+9CfmzZvHj370o6HnVq1axcc+9rGjOu73v/99PvnJT+7zb/78+fzd3/3d0RZZpOwosEU8yHVdvvvd7/LhD3+YtWvXHvXx3n33XRYtWsTTTz+9z3MnnHDCAb/m/PPPP+Rxb7rpJh577LGhf2eccQazZ8/mlltuOeoyi5QbBbaIB/3yl79kxowZfOELX2DdunVHfbw1a9Zw6aWXkk6n2bFjB1AM7BNPPPGojz3ojjvu4LnnnuO+++6bMJsxiJSStmQS8Zje3l5+8pOf8MADD5DP51m/fv1+3/f1r3+dpqam/b724IMPEg6Hhx6vWbOGz3zmMyxbtoynn36aL3/5y6xZs4ZPfvKTI1LmH/zgBzz55JPcf//91NfXj8gxRcqNAlvEY5YvX85ll13GtGnTcF2XXC7Hnj17mDJlyj7vu+uuuw7reNlslq1bt3L88ccTDAa59dZb+au/+is2b978gS7xa665hj179gDQ2to6FOi2bfPwww/v9/g/+tGPePzxx/nFL35BQ0PDcD+uiAxQYIt4yObNm/nlL39JVVUVjz/+OFDcQnDt2rUfCOzDbWGvW7eOxsZGYrEYCxcupKWlhZdeeonJkydTUVGxz9f95Cc/Gbp//vnn89hjjx20vCtWrOChhx7i/vvv/0D5RGR4FNgiHnLrrbfy7W9/m09/+tNDz33rW99i3bp1H5gEdrgt7PeOVVuWxfnnn89dd9110Alnh+NnP/sZv/jFL/jFL35BY2PjUR1LRBTYIp7x7LPP0trayqc+9al9np8zZw5vvvnmER93zZo1+4TzsmXL+MUvfnFUl3Rt3bqV22+/nUmTJnHDDTfs89p1113HRz7ykSM+tki50n7YIiIiHqDLukRERDxAgS0iIuIBCmwREREPUGCLiIh4gAJbRETEAxTYIiIiHqDAFhER8QAFtoiIiAf8/4DBbA/qVQNEAAAAAElFTkSuQmCC\n", "text/plain": [ "
" ] @@ -1291,7 +1291,7 @@ "outputs": [ { "data": { - "image/png": "iVBORw0KGgoAAAANSUhEUgAAAesAAAFpCAYAAAC8iwByAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjMuMywgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/Il7ecAAAACXBIWXMAAAsTAAALEwEAmpwYAABLaUlEQVR4nO3deXwU9f3H8deeuUNOCOG+5b4RRAU8EBARtFovPKq1atVWa/Fqtdaq4FUrtCq1rf486lEURK1nRRFFUQEBuQk3hJB7k+w9vz82WQgkZCPJbjb7fj4ePLKZnZ357DcJ7/3OfGe+JsMwDERERKTFMke6ABERETk2hbWIiEgLp7AWERFp4RTWIiIiLZzCWkREpIVTWIuIiLRw1kgXINKcli1bxsMPP8yGDRsYOXIkhmHgdDqZNGkSV155JTab7bi2/8033/C3v/2Nf/7zn8dcb/HixSxfvpwHHnjguPZ3pEmTJpGdnQ3Atm3bMAyDHj16AFBQUMB7773XpPs70sKFC3n66afZvXs3Q4cOxev1cvDgQcaNG8ddd92F2Rwd/YFzzjmHefPm0aVLl0iXIlInk66zltbuq6++4vLLL2fdunVYrVaKi4u57bbbsFgsPP3008cVKIZh4HA4SElJOeZ6Pp8Pp9NJUlLSj95XXWbOnMkLL7wAwB133IHX6+XRRx896rnm9MYbb/DEE0/w2WefAbBr1y6mTJnCfffdx3nnndfs+28KZWVlpKamRroMkXpFx8dekSaUnp7O7Nmz+eqrr3jrrbeOa1smk6nBoAawWCxNHtQAt9566496rjl16tSJXr16sXbt2ojs/8dQUEtLp8PgEpOys7M5+eSTee+995g+fToQOKT78ssvY7fbadeuHffddx/JyclA4HD63Llzsdls+P1+LrvsMk488USuu+46Vq9ezcaNGwF49dVXWbBgAQkJCcTHxzNr1iy8Xi+zZs2ivLyc//3vfwAcPHiQ++67j6KiIjweDxdffDEzZsxg7969/PrXv2b16tXMnj2bRYsWsW/fPh566CGGDRt21PsYOnRove9x6NChvPrqqzzzzDMMHjyYpKQk1qxZQ2pqKi+88AJLly5l3rx52Gw2kpOTue+++2jXrh0Aa9eu5aGHHsJkMmGxWLjnnnuCh9dD4fP5yMnJCX5/rO2tWbOGe++9F7vdTp8+fdi0aRPFxcX89re/ZenSpbz99ttcdtllbNmyhbVr13L++edz00038eyzz/LBBx9gtVrp27cvt99+O3a7na1bt3LfffcB4PV6+clPfsJ5553HwYMHueOOO3C5XHi9XiZMmMC1117L7Nmz+c9//sNdd90VPBJQ87tgs9lIT0/nD3/4A1lZWcybN49///vfnHXWWZSXl7N+/Xr69+/PnDlzQm4bkR/FEGnlli9fbvTu3dvweDy1lj/wwAPG5MmTDcMwjG+++cYYNWqUUVhYaBiGYcyePdu46667DMMwjJ07dxpDhw418vLyDMMwjNWrVxuXXXaZYRiGsWvXLqN3796GYRiGw+EwRo0aZbhcLsMwDOO5554zFixYEKxhwoQJwX1fccUVxpNPPmkYhmEUFhYaY8eONVasWFFrm++8845hGIYxf/5842c/+1mD7/P22283fvOb3xy1/MknnzROOukko7Cw0PD5fMbDDz9s7Ny50xgyZIixdetWwzAM48UXXzSuuOIKwzAMo6yszDjxxBONL774wjAMw/jkk0+MiRMnGj6fr879LliwwDjllFOC3//www/GTTfdZJSXlze4PZfLZZx66qnG4sWLg6/t27dvsN0MwzAuu+wy46qrrjK8Xq+xdetW47XXXjMWLVpkTJo0yaisrDT8fr9x8803G3/9618NwzCMm2++Odh2Bw4cMK6++mrDMAxjzpw5xjPPPGMYhmFUVFQYF110Ua191OxzxYoVxujRo4O/C3/961+Nyy+/vFY7n3vuuYbL5TKcTqcxatQo47vvvmvgpyNyfHQYXGKW3+8PPn7zzTc57bTTyMjIAAIDjhYvXoxhGLz99tsMGDCArl27AjBo0CB+/etfH7U9i8UCBHplVVVVXHrppUydOvWo9fLz8/nyyy85//zzAcjIyGD8+PEsWLCg1nqnnnoqAH369GH37t3H9V6HDBlCRkYGZrOZ3/72t8H31L17dwCmTp3Kl19+yYEDB/jkk09ITExkzJgxAIwfP56DBw+yevXqerdfVFTEzJkzmTZtWvB91xyVONb2Vq1aRWFhIZMnTwagb9++dfbgx40bh8VioXv37lxwwQW8+eabnH322SQkJGAymZg6dSqLFi0CoE2bNrz33nvs3r2b7Oxs5s6dC0BaWhpLly5l8+bNJCYm1jsocOHChYwfPz74u3D++eezfPly9u7dG1znxBNP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+fncf//99O3bF4fDgdfr5c4776SsrIxHH32U3Nxcdu3axW9+85uYHQ3+9ddfs3DhQpYuXcrFF1/Mz372MwDmzJlDdnY2O3fu5Be/+EWt0eBr167FYrHQtWvXmBrhXFdbvfrqq2zevJmOHTuyadMmLr/88uD5xFhuq7Vr1zJz5kwGDBgAQGVlJZdeeimnnXZavX97zz77LGVlZZSWlnLqqae2jhHOIaivrfLy8qiqqiIzM5NNmzZx8803B/8OW2NbteqwFhERaQ1a7WFwERGR1kJhLSIi0sIprEVERFo4hbWIiEgLp7AWERFp4RTWIiIiLZzCWkREpIVTWItILStWrKBPnz68+eabkS5FRKoprEUkyO/388ADDzB69GjWr18f6XJEpJrCWkSCXnvtNTp37swll1zChg0bIl2OiFTTVEoiAkBZWRlPP/00L730Eh6Ph40bN0a6JBGpprAWEQDmzp3L9OnT6dChA36/H7fbzb59+2jfvn2kSxOJeQprEWHr1q289tprpKWl8dZbbwGB6QXXr1+vsBZpATTrlohw9dVXM2XKFM4///zgsrvvvpsOHTpwww03RLAyEQENMBOJeR9//DEHDhxgxowZtZb36tVLg8xEWgj1rEVERFo49axFRERaOIW1iIhIC6ewFhERaeEU1iIiIi2cwlpERKSFU1iLiIi0cAprERGRFk5hLSIi0sL9P9puQA2En1dtAAAAAElFTkSuQmCC\n", + "image/png": "iVBORw0KGgoAAAANSUhEUgAAAesAAAFpCAYAAAC8iwByAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjQuMywgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/MnkTPAAAACXBIWXMAAAsTAAALEwEAmpwYAABMiElEQVR4nO3dd3hUVf7H8feU9N5IQu+IdEFUUAmKChYEewF11XXVVde21l3Lzwauuq7gqqy6upa1LAJixQKiIsWGhN4JPT2Z1Cnn98eQgUBCCCQzmczn9Tw8ZGZu+d5Dwifn3nPvsRhjDCIiItJiWQNdgIiIiBycwlpERKSFU1iLiIi0cAprERGRFk5hLSIi0sIprEVERFo4e6ALEGlO33//PU8++SSrVq3i2GOPxRhDZWUlo0eP5qqrriIsLOyItv/jjz/yz3/+k1dfffWgy82ePZuFCxfy2GOPHdH+9jd69GjS0tIA2LBhA8YYunXrBkBubi6fffZZk+5vfzNnzuTFF19k69atDBo0CJfLRV5eHiNGjOC+++7Dag2O/sA555zD1KlT6dSpU6BLEamTRfdZS2u3aNEirrjiCpYvX47dbqewsJA777wTm83Giy++eESBYozB4XAQFxd30OXcbjeVlZXExMQc9r7qMnHiRN544w0A7rnnHlwuF0899dQBnzWnDz74gGeffZb58+cDkJOTw5lnnsnDDz/Meeed1+z7bwolJSXEx8cHugyRegXHr70iTSgpKYlJkyaxaNEiPvzwwyPalsViaTCoAWw2W5MHNcDtt99+WJ81pw4dOtCjRw+ys7MDsv/DoaCWlk6nwSUkpaWlceKJJ/LZZ58xbtw4wHtK9+233yY8PJz09HQefvhhYmNjAe/p9ClTphAWFobH42HChAkcd9xxXH/99SxdupTVq1cD8O677zJ9+nSioqKIjIzkrrvuwuVycdddd1FaWsrXX38NQF5eHg8//DAFBQU4nU4uvfRSxo8fz/bt27n11ltZunQpkyZNYtasWezYsYMnnniCY4455oDjGDRoUL3HOGjQIN59911eeuklBgwYQExMDMuWLSM+Pp433niDb7/9lqlTpxIWFkZsbCwPP/ww6enpAGRnZ/PEE09gsViw2Ww88MADvtPrh8LtdpORkeF7fbDtLVu2jAcffJDw8HB69erFmjVrKCws5M9//jPffvstH330ERMmTGDdunVkZ2dz/vnnc/PNN/Pyyy8zZ84c7HY7vXv35u677yY8PJz169fz8MMPA+Byubjgggs477zzyMvL45577qGqqgqXy8XIkSO57rrrmDRpEv/73/+47777fGcCar4XwsLCSEpK4qGHHiI1NZWpU6fy3//+lzPOOIPS0lJWrlxJnz59mDx58iG3jchhMSKt3MKFC03Pnj2N0+ms9f5jjz1mxowZY4wx5scffzRDhw41+fn5xhhjJk2aZO677z5jjDFbtmwxgwYNMhs3bjTGGLN06VIzYcIEY4wxOTk5pmfPnsYYYxwOhxk6dKipqqoyxhjz2muvmenTp/tqGDlypG/fV155pXnuueeMMcbk5+eb4cOHmyVLltTa5scff2yMMWbatGnm6quvbvA47777bnPHHXcc8P5zzz1nhg0bZvLz843b7TZPPvmk2bJlixk4cKBZv369McaYN99801x55ZXGGGNKSkrMcccdZxYsWGCMMWbu3Lnm9NNPN263u879Tp8+3Zx00km+1ytWrDA333yzKS0tbXB7VVVV5uSTTzazZ8/2rdu7d29fuxljzIQJE8zvfvc743K5zPr16817771nZs2aZUaPHm3Ky8uNx+Mxt9xyi3n++eeNMcbccsstvrbbvXu3ueaaa4wxxkyePNm89NJLxhhjysrKzCWXXFJrHzX7XLJkiTn++ON93wvPP/+8ueKKK2q187nnnmuqqqpMZWWlGTp0qPn5558b+NcROTI6DS4hy+Px+L6eMWMGp5xyCsnJyYB3wNHs2bMxxvDRRx/Rt29fOnfuDED//v259dZbD9iezWYDvL2yiooKLr/8cs4+++wDltu1axc//PAD559/PgDJyclkZWUxffr0WsudfPLJAPTq1YutW7ce0bEOHDiQ5ORkrFYrf/7zn33H1LVrVwDOPvtsfvjhB3bv3s3cuXOJjo7mhBNOACArK4u8vDyWLl1a7/YLCgqYOHEiY8eO9R13zVmJg23v119/JT8/nzFjxgDQu3fvOnvwI0aMwGaz0bVrVy688EJmzJjBWWedRVRUFBaLhbPPPptZs2YBkJCQwGeffcbWrVtJS0tjypQpACQmJvLtt9+ydu1aoqOj6x0UOHPmTLKysnzfC+effz4LFy5k+/btvmWOO+44wsPDiYiIoFOnTkf87yPSEJ0Gl5C1bds2Onbs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63K5sTfhRBs/zliM47xyCmLyOM9xQZNtV0REpLk12LN+6623uPzyywHo1q0b3bp18332/vvvc+GFFx7yzvr37w+AzWZjyJAhLFq0qN6wLiwsP+Tt7istLY7c3NID3i/KL8OOBWPx1Pl5KKuvzaRuaq/GUXs1ntqscVpTe6Wl1T0WrMGwfv311/n555/r/Gz58uWHHNbr16/n559/9i2/efNmRo0adUjrNgV3tRM74RhdsxYRkSDTYFgnJSXx22+/cfbZZ2Oz1T4tvWXLlkPeUWxsLN988w27d+/G4XCQkZHBOeec0/iKD5PH5b1WrfusRUQk2DQY1u+++y7ff/89H374IUOHDmXcuHG+0O7bt+8h7yg9PZ2pU6cefqVHyFXtBCI1wExERILOIT0UZfjw4UyePJm2bdty//338/777+Nyufw6mvtIedwaDS4iIsHpkJ9gBt4R4HfccQczZ87kmmuuaa6amoW7uiasdc1aRESCyyGH9e7du3n00Uc5/fTTycjI4IEHHmjOupqcrlmLiEiwavCa9a5du5g2bRoffPABp512GtOnT/fdX71p0yY6d+7c3DU2Cd9DUVDPWkREgkuDYT1q1CgyMzO599576dy5M/n5+eTn52OM4Y033mDKlCn+qPOIeZx7ng2u+axFRCTINBjWgwYNYvz48QBs27at1mcOh6N5qmoGZs9pcIPCWkREgkuDYX3DDTdwwgkn1PlZly5dmryg5qJng4uISLBqcIBZfUENMHDgwKaspVkZd80AM12zFhGR4NJgWH///fcNbqRmco+WzF1zGlxhLSIiQabBsP7iiy8a3MjcuXObpJjmVNOz1mlwEREJNg1es37nnXd49913ATDGYLFYfJ/VvB4wYEDzVdhEPHuuWaNbt0REJMgc0q1bNc/0rqqqIiIiotmLag57r1mrZy0iIsGlwdPg+96udemll9b67LXXXmvygppLTVija9YiIhJkGgxrY/aGm8dTu1c6a9aspq+omRiPrlmLiEhwajCs971Gve/XUDvIWzqP21urHjcqIiLBpsFr1ps3b+a+++6jX79+VFRU4HQ6CQsLAw4M75Zs72hwhbWIiASXBsN62rRprFixgqVLlxIWFsbgwYNp27YtPXv2ZNeuXf6osUkorEVEJFg1GNZDhgxhyJAhvtfV1dWsWrWK5cuXk5CQ0KzFNSnPntPgumYtIiJBpsGw3l94eDj9+/enf//+zVFPs/F41KMWEZHg1OAAs1ZDo8FFRCRIhUxYmz2jwXWftYiIBJvQCWuPbt0SEZHgFHphHTx3m4mIiAAhFNY1o8F1GlxERIJN6IT1nozWfdYiIhJsQias954GV1iLiEhwCZmw9p0G1wAzEREJMiEU1t6/1LMWEZFg49ewrqys5JxzzmHy5Mn+3K1XzQxhGg0uIiJBxq9h/eyzz3L00Uf7c5c+RmEtIiJBym9hPXPmTI455hjat2/vr13WVvOUUZ0GFxGRINPoiTwOx7p169iwYQO33347q1evPqR1kpKisdtth7W/tLS4A96z1sy9ba3781CnNmkctVfjqL0aT23WOK29vfwS1l988QXh4eFMmzaNn376CafTyWuvvcZVV11V7zqFheWHta+0tDhyc0sPeN/j2vu40bo+D2X1tZnUTe3VOGqvxlObNU5raq/6funwS1jfcMMNvq+rqqooLy8/aFA3K12zFhGRIOPXAWaff/45S5Ys4ddff+Wjjz7y5673uXXLv7sVERE5Un7pWdc444wzOOOMM/y5y718A8wCs3sREZHDFToPRamhsBYRkSATMmHtu2NLYS0iIkEmZMLa1JwGD5kjFhGR1iJkostSM7JMPWsREQkyIRPWPgprEREJMqET1mbvE8xERESCSchE194BZupai4hIcAmZsKZm0q3QOWIREWklQia69g4wU89aRESCS8iEdU3POoSOWEREWonQia49PWuLVT1rEREJLiET1joNLiIiwSp0whr1rEVEJDiFTFjrPmsREQlWIRNdFt8165A5ZBERaSVCJrl816xtOg0uIiLBJWTCuuah4BYNMBMRkSATMmHtOw2unrWIiASZ0AtrXbMWEZEgEzLJpZ61iIgEq5AJa981a/WsRUQkyIRMclmM91DVsxYRkWATQmFdcxo8ZA5ZRERaiZBJLl2zFhGRYBU6Yb3nUK02W4ArERERaZzQCes9PWurToOLiEiQCZnk8oW1PWQOWUREWgm7v3bk8Xi4/vrr6d+/P06nk5ycHB5//HEiIyP9sv+a0eDo1i0REQkyfk2ugQMHctNNN3HbbbdRUVHBnDlz/LbvmvmsbXZdsxYRkeDit7C2Wq3ceOONALhcLnbt2kWXLl38tfu991nrNLiIiAQZv50Gr/Htt9/y2muvkZWVRb9+/fy235pr1upZi4hIsLEYY0wgdnzXXXcxYMAALr/88jo/d7nc2JswWN9IfYUO+d0ofjCXcx+6sMm2KyIi0tz81rNet24dW7duJSsrC4D27duzdevWepcvLCw/rP2kpcWRm1t6wPvWPafBq5yeOj8PZfW1mdRN7dU4aq/GU5s1Tmtqr7S0uDrf91tYh4eH87///Y8VK1bgcrlYv349f/nLX/y1e981a926JSIiwcZvYd2xY0emTp3qr90doCas7eF+v0wvIiJyREKmm+m7dStMA8xERCS4hExY11yzRo8bFRGRIBMyyVVz65Y9IizAlYiIiDROCIW19/S37rMWEZFgE0JhXdOz1gAzEREJLiET1lbfrVvqWYuISHAJmbD2PW40IjzAlYiIiDROyIS1dc81a3tYyByyiIi0EiGTXLpmLSIiwSpkwrrmmrUtXNesRUQkuIRMWPseN6pr1iIiEmRCJqytnj1hHabT4CIiElxCJ6xretZReoKZiIgEl5DpZvrCOkxhLSLSnFasyOaf/3wOl8vFscceR1VVFQATJ/6OuLi652sGeO+9t7noosv8VWZQCZmedc1o8PBoXbMWEWlORx/dl0GDBtO3b3+uueYP3HjjLQwaNJg//el6XC5Xveu9995//VhlcAmJnrXb5cZWc5+1bt0SkRBy2WVRfPll0/6/N2qUi7ffrmjUOiecMJx///tfLFr0AzNn/o8BAwaxZctmTjttNMceexxfffUFDkcpr7zyEp06dWbYsJN48MF7D1guVIVEcnncHu/feDSRh4hIgGRkZLJ9+zYuuugyjj32OEpKirn99ps59tjjOPXU03jhhee45po/AFBZWVnncqEqJMK6urwaAGMxAa5ERMS/GtsDbk47d+5g9Oiz+OWXn1i+fBk2m52iosI6lzXGHNJyoSIkrlm7qp0AuK3uAFciIhKaFi9eSHV1NVu35pCXl8tVV13LJZdcXmsZq9WKMYa1a9cwe/bMepcLRSHRs3ZVqGctIuIvq1atYOnSX3A6nbz22stUVVXhcrl47rkXKCwsZN68r3j++X8QHx+Pw+Fg3ryvyMo6lWHDTmTq1GcBGDt2fL3LhSKLMaZFJlhubulhrZeWFnfAurvW7iBv+HYqwioYsu3EpiivVamrzaR+aq/GUXs1ntqscVpTe6Wl1X1rW2icBq+q6Vl7AlyJiIhI44VEWLurvdeqPQprEREJQiER1s5K7wAz9axFRCQYhURYu5177rO2KqxFRCT4hERY19y6ZWiRY+lEREQOKiTC2uPUNWsREQleIRHWripdsxYRkeDlt7DesmULt99+Oy+//DKPPvooU6dO9deucVV7Z3lRz1pEpPVZs2YNt9xyPZ98Mvuwt/Hee2/7vp4z51NGjx55WNvZsWM7l112PjfddB033XQdU6b8/bBr2pffnmBWVFTEmWeeyahRowA488wzycrKom/fvs2+b4/LexpcTzATkVATf9kFRHw5p0m3WTXqdEre/l+TbvNI9OzZkwEDBh3RNt5777++ubRPP30M06b987C3NWHCVZx55jlHVM/+/BbW/fv3r/Xa4/EQFRXll3179vSsdRpcRKT5ffzxh7z00vNccsnlrF+/lqKiYs488xwWL/6BrVtzePLJvzNnzmds3Lie5OQUdu7cwZ133svGjet5+unJREVFcf/9D3HXXbcxduw4xo27oM79vPHGa2zatIH+/fuwadNGMjPbArBhw3reeut1unXrzubNm7jiiqux2ez84x9/w+l00rdvf3JyNtO5czcmTryKWbM+8E3P2adPP44/fhgA77zzJqtXr6KszMETTzyNzWZj5szpzJ8/74Ba+vTp65sx7Pvv51NUVIjD4eC000bTpUvXI29UEwBz5swxjzzyyEGXcTpdTbe/f3xi5jLX/DfxP022TRERqd+ECRPMggULjDHG3HDDDea9994zxhjzyCOPmM8++8x89dVXxu12+96bO3euMcaYvLw8c8YZZ5j//Oc/5sMPP6x3+6tXrzZjxozxvb7jjjvM9OnTjTHGXHTRReann34yxhizcOFCc+ONNxpjjJk+fbq54447fOuMGTPGrF692hhjzMiRI2ttf+TIkWbjxo3GGGOuu+46s2zZskM67rKyMrNmzRpjjDG5ublm5MiRpri4+JDWPRi/T+SxcOFCFi1axH333XfQ5QoLyw9r+3U9I7aksIwUovBYPK3m+bFNqTU9V9cf1F6No/ZqvNbQZtXVLmJiksnNLSU8PIr4+FRyc0ux2yPZuTOfNm3Sefjhx0hISGTFitV06NB1zzGHM3HiNbzwwnO8996setvh55+zychoS25uKWlpcaSkpFNaWklubimrVq1izpyvmTfve6qrq7DZwsjNLaW0tJKUlHTfNtPT2/Lz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\n", "text/plain": [ "
" ] @@ -1309,20 +1309,20 @@ "text": [ " N Z A Element Ebinding Eapprox\n", "A \n", - "1 0 0 1 1 H 0.000000 0.000000\n", - "2 1 1 1 2 H 1.112283 1.112283\n", - "3 2 2 1 3 H 2.827265 2.827265\n", - "4 6 2 2 4 He 7.073915 7.073915\n", - "5 9 3 2 5 He 5.512132 5.512132\n", + "4 0 1 3 4 Li 1.153760 1.153760\n", + "5 2 3 2 5 He 5.512132 5.512132\n", + "6 7 3 3 6 Li 5.332331 5.332331\n", + "7 12 4 3 7 Li 5.606439 5.606439\n", + "8 17 4 4 8 Be 7.062435 7.062435\n", "... ... ... ... ... ... ...\n", - "264 3304 156 108 264 Hs 7.298375 7.298375\n", - "265 3310 157 108 265 Hs 7.296247 7.297260\n", - "266 3317 158 108 266 Hs 7.298273 7.297260\n", - "269 3338 159 110 269 Ds 7.250154 7.250154\n", - "270 3344 160 110 270 Ds 7.253775 7.253775\n", + "264 3297 156 108 264 Hs 7.298375 7.298375\n", + "265 3303 157 108 265 Hs 7.296247 7.296247\n", + "266 3310 158 108 266 Hs 7.298273 7.298273\n", + "269 3331 159 110 269 Ds 7.250154 7.250154\n", + "270 3337 160 110 270 Ds 7.253775 7.253775\n", "\n", - "[267 rows x 6 columns]\n", - "0.009883615646716186\n" + "[264 rows x 6 columns]\n", + "0.007012403613997257\n" ] } ], @@ -1390,11 +1390,15 @@ "name": "stderr", "output_type": "stream", "text": [ - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", + "/opt/homebrew/lib/python3.9/site-packages/sklearn/neural_network/_multilayer_perceptron.py:692: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", " warnings.warn(\n", - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", + "/opt/homebrew/lib/python3.9/site-packages/sklearn/neural_network/_multilayer_perceptron.py:692: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", " warnings.warn(\n", - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", + "/opt/homebrew/lib/python3.9/site-packages/sklearn/neural_network/_multilayer_perceptron.py:692: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", + " warnings.warn(\n", + "/opt/homebrew/lib/python3.9/site-packages/sklearn/neural_network/_multilayer_perceptron.py:692: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", + " warnings.warn(\n", + "/opt/homebrew/lib/python3.9/site-packages/sklearn/neural_network/_multilayer_perceptron.py:692: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", " warnings.warn(\n" ] }, @@ -1402,11 +1406,15 @@ "name": "stderr", "output_type": "stream", "text": [ - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", + "/opt/homebrew/lib/python3.9/site-packages/sklearn/neural_network/_multilayer_perceptron.py:692: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", " warnings.warn(\n", - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", + "/opt/homebrew/lib/python3.9/site-packages/sklearn/neural_network/_multilayer_perceptron.py:692: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", " warnings.warn(\n", - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", + "/opt/homebrew/lib/python3.9/site-packages/sklearn/neural_network/_multilayer_perceptron.py:692: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", + " warnings.warn(\n", + "/opt/homebrew/lib/python3.9/site-packages/sklearn/neural_network/_multilayer_perceptron.py:692: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", + " warnings.warn(\n", + "/opt/homebrew/lib/python3.9/site-packages/sklearn/neural_network/_multilayer_perceptron.py:692: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", " warnings.warn(\n" ] }, @@ -1414,11 +1422,15 @@ "name": "stderr", "output_type": "stream", "text": [ - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", + "/opt/homebrew/lib/python3.9/site-packages/sklearn/neural_network/_multilayer_perceptron.py:692: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", " warnings.warn(\n", - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", + "/opt/homebrew/lib/python3.9/site-packages/sklearn/neural_network/_multilayer_perceptron.py:692: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", " warnings.warn(\n", - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", + "/opt/homebrew/lib/python3.9/site-packages/sklearn/neural_network/_multilayer_perceptron.py:692: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", + " warnings.warn(\n", + "/opt/homebrew/lib/python3.9/site-packages/sklearn/neural_network/_multilayer_perceptron.py:692: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", + " warnings.warn(\n", + "/opt/homebrew/lib/python3.9/site-packages/sklearn/neural_network/_multilayer_perceptron.py:692: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", " warnings.warn(\n" ] }, @@ -1426,11 +1438,15 @@ "name": "stderr", "output_type": "stream", "text": [ - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", + "/opt/homebrew/lib/python3.9/site-packages/sklearn/neural_network/_multilayer_perceptron.py:692: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", " warnings.warn(\n", - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", + "/opt/homebrew/lib/python3.9/site-packages/sklearn/neural_network/_multilayer_perceptron.py:692: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", " warnings.warn(\n", - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", + "/opt/homebrew/lib/python3.9/site-packages/sklearn/neural_network/_multilayer_perceptron.py:692: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", + " warnings.warn(\n", + "/opt/homebrew/lib/python3.9/site-packages/sklearn/neural_network/_multilayer_perceptron.py:692: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", + " warnings.warn(\n", + "/opt/homebrew/lib/python3.9/site-packages/sklearn/neural_network/_multilayer_perceptron.py:692: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", " warnings.warn(\n" ] }, @@ -1438,11 +1454,15 @@ "name": "stderr", "output_type": "stream", "text": [ - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", + "/opt/homebrew/lib/python3.9/site-packages/sklearn/neural_network/_multilayer_perceptron.py:692: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", " warnings.warn(\n", - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", + "/opt/homebrew/lib/python3.9/site-packages/sklearn/neural_network/_multilayer_perceptron.py:692: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", " warnings.warn(\n", - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", + "/opt/homebrew/lib/python3.9/site-packages/sklearn/neural_network/_multilayer_perceptron.py:692: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", + " warnings.warn(\n", + "/opt/homebrew/lib/python3.9/site-packages/sklearn/neural_network/_multilayer_perceptron.py:692: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", + " warnings.warn(\n", + "/opt/homebrew/lib/python3.9/site-packages/sklearn/neural_network/_multilayer_perceptron.py:692: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", " warnings.warn(\n" ] }, @@ -1450,11 +1470,11 @@ "name": "stderr", "output_type": "stream", "text": [ - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", + "/opt/homebrew/lib/python3.9/site-packages/sklearn/neural_network/_multilayer_perceptron.py:692: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", " warnings.warn(\n", - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", + "/opt/homebrew/lib/python3.9/site-packages/sklearn/neural_network/_multilayer_perceptron.py:692: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", " warnings.warn(\n", - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", + "/opt/homebrew/lib/python3.9/site-packages/sklearn/neural_network/_multilayer_perceptron.py:692: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", " warnings.warn(\n" ] }, @@ -1462,13 +1482,9 @@ "name": "stderr", "output_type": "stream", "text": [ - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", + "/opt/homebrew/lib/python3.9/site-packages/sklearn/neural_network/_multilayer_perceptron.py:692: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", " warnings.warn(\n", - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", - " warnings.warn(\n", - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", - " warnings.warn(\n", - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", + "/opt/homebrew/lib/python3.9/site-packages/sklearn/neural_network/_multilayer_perceptron.py:692: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", " warnings.warn(\n" ] }, @@ -1476,64 +1492,26 @@ "name": "stderr", "output_type": "stream", "text": [ - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", + "/opt/homebrew/lib/python3.9/site-packages/sklearn/neural_network/_multilayer_perceptron.py:692: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", " warnings.warn(\n", - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", + "/opt/homebrew/lib/python3.9/site-packages/sklearn/neural_network/_multilayer_perceptron.py:692: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", " warnings.warn(\n", - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", - " warnings.warn(\n" - ] - }, - { - "name": "stderr", - "output_type": "stream", - "text": [ - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", + "/opt/homebrew/lib/python3.9/site-packages/sklearn/neural_network/_multilayer_perceptron.py:692: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", " warnings.warn(\n", - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", - " warnings.warn(\n", - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", - " warnings.warn(\n" - ] - }, - { - "name": "stderr", - "output_type": "stream", - "text": [ - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", - " warnings.warn(\n" - ] - }, - { - "name": "stderr", - "output_type": "stream", - "text": [ - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", - " warnings.warn(\n", - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", - " warnings.warn(\n" - ] - }, - { - "name": "stderr", - "output_type": "stream", - "text": [ - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", - " warnings.warn(\n", - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", + "/opt/homebrew/lib/python3.9/site-packages/sklearn/neural_network/_multilayer_perceptron.py:692: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", " warnings.warn(\n" ] }, { "data": { - "image/png": "iVBORw0KGgoAAAANSUhEUgAAAlgAAAJjCAYAAADQ22+yAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjMuMywgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/Il7ecAAAACXBIWXMAAAsTAAALEwEAmpwYAABh5ElEQVR4nO3dd3wUdf7H8dduCkWalFBV4FRsWLGfYpciIConVkA9K2AXsGEBBcSCYOGsiA04BcQDu2DDUzl/YMdDUZESihp6kt39/TEnRcKaJZMNCa8njzwe7Oxk5/ud3Z397Pv7nUkkkUgkkCRJUmiiZd0ASZKkisYCS5IkKWQWWJIkSSGzwJIkSQqZBZYkSVLILLAkSZJCllnWDZC2ZQMGDODjjz8GYM6cOTRu3JjKlSsDMGbMmHX//zN///vf6dOnDzvvvPNm1xk2bBg77bQTJ598conb/btevXrx0UcfMXXqVKpUqRLa40pSeRfxOljS1uGYY45h2LBhtGzZsqybUiyLFi2iU6dO7LPPPhx11FGcccYZZd0kSdpqOEQobaWGDx/O+eefT4cOHbjmmmtYsmQJl156KaeffjrHHHMM55xzDkuXLgWC4uyzzz7j3//+N127duXaa6/l5JNPpl27dnz44YcA9O3bl8ceewyAli1bMnz4cLp27coxxxzDk08+CUAsFuPOO+/k+OOP55RTTuGWW27hnHPOKbJ9Y8eO5dBDD6Vz58489dRTbPhdbebMmXTp0oWTTjqJzp07M3369KTLW7RowbJly9b9/u+3//3vf9OxY0e6du1Kx44dyc/PZ8CAAXTp0oV27drRtm1bZsyYAcDKlSvp168fJ554Iu3ateOee+5h1apVHHjggXz//ffrHrtHjx688cYbYTxFkrRZFljSVuznn39m/PjxDB06lH/961/su+++jBkzhjfffJPKlSszceLETX5n1qxZnHfeeUyYMIHTTjuNESNGbLJOfn4+22+/Pc8//zz3338/d999N2vXrmXcuHF88cUXvPzyyzz//PP89NNPRbarsLCQsWPH0rFjR4455hiWLl3KO++8A0BBQQGXXXYZl112GS+//DK33347d9xxB/n5+UUuj8fjSffBt99+y913381LL73EF198QW5uLmPGjGHy5Ml07tyZRx55BID777+ftWvXMnnyZCZMmMB//vMfPvvsM04++WTGjRsHwI8//sj333/P0UcfndLzIEmpcg6WtBXbd999ycwM3qbdunXjk08+4YknnmDu3Ll8++237LPPPpv8TqNGjdh9990B2GOPPRg/fnyRj33ssccCsOeee5Kfn8+qVauYNm0anTp1olKlSgCcfvrpjB49epPfffPNN4nH4xxxxBFkZmbSrl07Ro0aRevWrZk9ezbRaJSjjjoKgL322otJkybxxRdfFLn8zzRs2JDGjRsDsN9++1GzZs11xd+///1vtttuOwA++OAD+vXrR0ZGBhkZGTz99NMA5OTkcPbZZ3PllVcyZswYTjvtNDIyMv50u5JUEhZY0lasatWq6/5/1113MWvWLE499VQOPvhgCgsLKWoK5YYT4yORSJHrAOuKqEgkAkAikVhXzP0uGi065H7uuedYs2YNJ5xwAhAkYosXL+bbb78lIyNj3WP+bvbs2Ztd3rx5842W5efnb3R7w30wdepUBg4cSI8ePTj22GNp3rw5L730EgCZmZkbPf6CBQuoXLkyzZo1o0WLFrz55ptMmjRpXZolSaXJIUKpnHjvvffo1q0bJ598MnXq1OGDDz4gFouFuo3WrVvz0ksvkZ+fT2FhYZHp1/fff89HH33E+PHjeeutt3jrrbd47733aNWqFaNGjaJ58+ZEIhHef/99AL744gu6deu22eXxeJzatWvz2WefAfD6669vtn3vv/8+Rx99NGeeeSYtW7bkjTfeWLcPDj30UMaPH088Hic/P5/evXuvO0PzzDPPZMiQIeyzzz7Ur18/1H0mSUUxwZLKicsuu4whQ4bw4IMPkpGRwf7778+PP/4Y6jZOOeUUvv/+e04++WSqVq1KkyZNNrn8wnPPPcdxxx3HjjvuuNHynj17ctFFF3HVVVcxfPhw7rjjDoYMGUJWVhbDhw8nOzt7s8tvvPFGbrvtNmrUqMFhhx1GvXr1imxf165dueaaa+jQoQMZGRm0atWK1157jXg8Ts+ePRk4cCCdOnUiFovRrl27dQnb0UcfzY033kjXrl1D3V+StDlepkHSOu+99x5Lly6lU6dOQHCdrkqVKnHttdeWcctK5j//+Q833XQTL7/88ibDlJJUGiywJK2zaNEi+vbty9KlS4nFYuy2227ccsstVK9evaybtsX69OnDRx99xODBgznooIPKujmSthEWWJIkqdybNGkSDz30EAUF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\n", + "image/png": "iVBORw0KGgoAAAANSUhEUgAAAlgAAAJjCAYAAADQ22+yAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjQuMywgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/MnkTPAAAACXBIWXMAAAsTAAALEwEAmpwYAABv4UlEQVR4nO3dd3gU5dfG8e9uOr0lgdBRilIsgIj+pFkgoUZEEEXErjRREUSKBaQq0lRUkKoCKlUiIAqKgBQVEGlSpJPQDCVtd+f9YyQhL2HNJpPdJNyf69qL7OzszHNmht0z53lm1mYYhoGIiIiIWMbu6waIiIiI5DdKsEREREQspgRLRERExGJKsEREREQspgRLRERExGJKsEREREQs5u/rBohcy4YOHcrGjRsB2Lt3L2XLliU4OBiAOXPmpP79X5566in69evH9ddff9V5xo0bR8WKFWnXrl22231Jz5492bBhA6tWrSIkJMSy5YqI5HU23QdLJHdo1qwZ48aNo3bt2r5uSqacOHGCtm3bctNNN9GkSRMeeughXzdJRCTXUBehSC41YcIEnnjiCVq3bs3LL7/MyZMnef755+nYsSPNmjWjS5cunDp1CjCTs23btvHLL7/QqVMn+vbtS7t27YiKimL9+vUA9O/fnylTpgBQu3ZtJkyYQKdOnWjWrBnTpk0DwOl0Mnz4cO69917uv/9+Xn/9dbp06ZJh++bOnUvDhg2Jjo5mxowZXH6utmXLFjp06ECrVq2Ijo5m3bp1bqdXr16d06dPp77/0vNffvmFNm3a0KlTJ9q0aUNycjJDhw6lQ4cOREVFERkZyebNmwG4cOECr776Ks2bNycqKop3332XixcvUr9+ffbv35+67G7duvHdd99ZsYtERK5KCZZILnbkyBHmz5/PmDFj+Oabb7j55puZM2cOK1euJDg4mIULF17xnq1bt/L444+zYMECHnjgASZOnHjFPMnJyRQvXpwvvviC8ePH884775CUlMS8efPYvn07S5Ys4YsvvuDQoUMZtsvhcDB37lzatGlDs2bNOHXqFD/++CMAKSkpdO/ene7du7NkyRLeeust3n77bZKTkzOc7nK53G6DPXv28M4777Bo0SK2b99ObGwsc+bMYenSpURHR/Pxxx8DMH78eJKSkli6dCkLFizg119/Zdu2bbRr14558+YBcPDgQfbv30/Tpk092g8iIp7SGCyRXOzmm2/G39/8b9q1a1c2bdrEp59+yoEDB9izZw833XTTFe+JiIjghhtuAODGG29k/vz5GS777rvvBqBmzZokJydz8eJFVq9eTdu2bQkKCgKgY8eOzJw584r3rly5EpfLxV133YW/vz9RUVFMnz6dxo0bs3v3bux2O02aNAGgVq1aLF68mO3bt2c4/b+UKVOGsmXLAnDLLbdQtGjR1OTvl19+oWDBggCsXbuWV199FT8/P/z8/Jg1axYAYWFhPPLII/Tp04c5c+bwwAMP4Ofn95/rFRHJDiVYIrlYgQIFUv8ePXo0W7dupX379jRo0ACHw0FGQygvHxhvs9kynAdITaJsNhsAhmGkJnOX2O0ZF7k///xzEhMTue+++wCzIhYXF8eePXvw8/NLXeYlu3fvvur0KlWqpJuWnJyc7vnl22DVqlUMGzaMbt26cffdd1OlShUWLVoEgL+/f7rlHzt2jODgYCpXrkz16tVZuXIlixcvTq1miYjkJHURiuQRa9asoWvXrrRr146SJUuydu1anE6npeto3LgxixYtIjk5GYfDkWH1a//+/WzYsIH58+fz/fff8/3337NmzRrq1avH9OnTqVKlCjabjZ9//hmA7du307Vr16tOd7lclChRgm3btgGwYsWKq7bv559/pmnTpnTu3JnatWvz3XffpW6Dhg0bMn/+fFwuF8nJyfTq1Sv1Cs3OnTszatQobrrpJsLDwy3dZiIiGVEFSySP6N69O6NGjeL999/Hz8+PW2+9lYMHD1q6jvvvv5/9+/fTrl07ChQoQLly5a64/cLnn3/OPffcQ4UKFdJN79GjB8888wwvvvgiEyZM4O2332bUqFEEBAQwYcIEAgMDrzp94MCBvPnmmxQpUoQ77riD0NDQDNvXqVMnXn75ZVq3bo2fnx/16tVj+fLluFwuevTowbBhw2jbti1Op5OoqKjUClvTpk0ZOHAgnTp1snR7iYhcjW7TICKp1qxZw6lTp2jbti1g3qcrKCiIvn37+rhl2fPrr78yaNAglixZckU3pYhITlCCJSKpTpw4Qf/+/Tl16hROp5MaNWrw+uuvU7hwYV83Lcv69evHhg0bGDlyJLfddpuvmyMi1wglWCIiIiIW0yB3ERERyfMWL15MVFQU9957L7Nnz/Z1czTIXURERPK2EydOMHbsWL7++msC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1T73Z0wJwjBg4rvBqdNuqOnk2V55/wRLss9m/P+SUg7ZunUr8+bN46233rJ0ubsO5d7uRW9IvsaH0QXb8vdZ43/xI+93RYpkRco1XlGpXt790Bur9fz1Ya+ta8Kts722rpzktcu96tSpQ506dby1OhERERGfyb/X04uIiIglnFzbFcOsuLb7l0RERERygCpYIiIi4pauIvScKlgiIiIiFlOCJSIiImIxdRGKiIiIWy5D9RhPaYuJiIiIWEwVLBEREXHLpds0eEwVLBERERGLqYIlIiIibjl1mwaPqYIlIiIiYjFVsERERMQtXUXoOW0xEREREYupgiUiIiJu6adyPKcKloiIiIjFVMESERERt3QfLM+pgiUiIiJiMVWwRERExC2NwfKcKlgiIiIiFlMFS0RERNzSfbA8py0mIiIiYjElWCIiIiIWUxehiIiIuKVB7p5TBUtERETEYqpgiYiIiFu60ajnVMESERERsZgqWCIiIuKWxmB5ThUsEREREYupgiUiIiJuqYLlOVWwRERERCymCpaIiIi4pQqW51TBEhEREbGYKlgiIiLilipYnsvzCVbVgEK+boKIiIhIOnk+wRIREZGcpTu5e05jsEREREQspgqWiIiIuKUxWJ5TBUtERETEYkqwRERERCymLkIRERFxS12EnlMFS0RERMRiqmCJiIiIW6pgeU4VLBERERGLqYIlIiIibqmC5TlVsEREREQspgqWiIiIuGWoguUxVbBERERELKYKloiIiLilH3v2nCpYIiIiIhZTBUtERETc0lWEnlMFS0RERMRiqmCJiIiIW7qK0HOqYImIiIhYTAmWiIiIuOUybF575IQ///yTWrVqpT5PTk6mb9++REZGEh0dzd69ewEwDIORI0fSokULoqKi2Lx5c5bXqS5CERERybcSEhJ48803SUlJSZ02c+ZMQkJCiImJYePGjfTv35958+axbNky9u7dy9KlS/n77795+umniYmJwd/f83RJFSwRERHJNeLj4zl8+PAVj/j4+Cwtb8SIETz22GPppq1atYo2bdoAUL9+fc6cOcPRo0dZvXo1UVFR2O12KleuTEREBL/99luW1qsKloiIiLjlzUHu06dPZ+LEiVdM79GjBz179vRoWStXriQxMZEWLVqkmx4bG0toaGjq89DQUI4fP05sbCxhYWFXTM8KJVgiIiKSa3Tt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b550OJ0wbS5E/r9xerlZZuK32cx9fPiY+fzzBVD9OigdBut/NS/0cDjMatjiFXD7rV4NIceoi9BzXvmx54kTJ7J27Vr69+9PnTpmh/TmzZvp0aMHycnJbN68OcvLzqkfe1693rxUNyUFypc1vzAPHzUHbc+fkn7eI8egTTfY/K35/PEXzcu0y5VJm6dsaZg4LEeamiOyEz/AlM/NM7mhr3i33VbQvs98/K8OT3+bhgsXod8ws9vIMODph6HNfd6PITsyE//nC8yB/v5+5i1IBvcx93nzzubA5vDQtOXdUst8Pa/4r/g/nGkm0dX+3/jDqe9C0cLm+KNVa82rKRvcAgN7p130kRdkZv8vWg4ffwYup7mvh/aDiHBzoP/wCWYVz26DW2ubF8KEBFvfTm//2HPtRUO8tq5tbd7w2rpyklcSLIB169YRFhbGddddlzrt2LFjTJ06lddeey3Ly82pBEtERCS38naCVXPh615b1/a23ltXTvJa73jDhg2vmFamTJlsJVciIiIiuVEeGn4oIiIivpALr0fL9XSjURERERGLqYIlIiIibuWnq/u8RRUsEREREYupgiUiIiJuqYLlOVWwRERERCymCpaIiIi4pYsIPacKloiIiIjFVMESERERtzQGy3OqYImIiIhYTBUsERERcU+DsDymCpaIiIiIxZRgiYiIiFhMXYQiIiLilga5e04VLBERERGLqYIlIiIibhka5O4xVbBERERELKYKloiIiLilMVieUwVLRERExGKqYImIiIh7qmB5TBUsEREREYupgiUiIiJu6SpCz6mCJSIiImIxVbBERETEPVWwPKYKloiIiIjFVMESERERt3QfLM+pgiUiIiJiMVWwRERExD2NwfKYKlgiIiIiFlOCJSIiImIxdRGKiIiIWxrk7jlVsEREREQspgqWiIiIuKdB7h5TBUtERETEYqpgiYiIyH/QGCxPqYIlIiIiYjFVsERERMQ9jcHymCpYIiIiIhZTBUtERETcUwXLY6pgiYiIiFhMFSwRERFxT3dy95gqWCIiIiIWUwVLRERE3DI0BstjqmCJiIiIWEwVLBEREXFPFSyPqYIlIiIiYjElWCIiIiIWUxehiIiIuKfbNHhMFSwRERERi6mCJSIiIm7ZNMjdY6pgiYiIiFhMFSwRERFxTxUsj6mCJSIiImIxVbBERETEPV1F6DFV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LI+pgiUiIiJiMSVYIiIiIhZTF6GIiIi4py5Cj6mCJSIiImIxVbBERETELd2mwXOqYImIiIhYTBUsERERcc+w+boFeY4qWCIiIiIWUwVLRERE3NMYLI+pgiUiIiJiMVWwRERExC1dReg5VbBERERELKYKloiIiLinCpbHVMESERERsZgqWCIiIuKWxmB5ThUsEREREYupgiUiIiLuqYLlMVWwRERERCymBEtERETEYuoiFBEREffURegxVbBERERELKYKloiIiLil2zR4ThUsEREREYspwRIRERGxmBIsEREREYtpDJaIiIi4pzFYHlMFS0RERMRiqmCJiIiIW7qK0HOqYImIiIhYTBUsERERcU8VLI+pgiUiIiJiMVWwRERExD1VsDymCpaIiIiIxVTBEhEREbd0FaHnVMESERERsZgSLBERERGLqYtQRERE3FMXocdUwRIRERGxmCpYIiIi4pYGuXtOFSwRERERi6mCJSIiIu6pguUxVbBERERELKYKloiIiLinCpbHVMESERERsZgqWCIiIuKWriL0nCpYIiIiIhZTBUtERETcUwXLY6pgiYiIiFhMFSwRERFxTxUsj6mCJSIiImIxVbBERETELV1F6DlVsEREREQspgRLRERExGLqIhQRERH31EXoMVWwRERERCymCpaIiIi4pUHunlMFS0RERMRiqmCJiIiIe6pgeUwVLBERERGLqYIlIiIi7qmC5TFVsEREREQspgqWiIiIuGXzdQPyIFWwRERERCymCpaIiIi4pzFYHlMFS0RERMRiqmBdxap1MPYjSE6B6lVgaD8oVDD9PCMnwbJVULSI+bxSeRj7OgwbB5u2ps13Ig5CS8LCT73V+uzLTvzJyTBsPKz/FQqGQJM7oEc3sOeRdD47sQMsXw2TZ5nvjwiHEQOgeFFvRpA92Y2//VOQlAQBAebzVvfAEw95q/XWyu62yIsyE/Psr+HzhWCzQYUIeLMvlCwO587DwFGw7yAYLmjbAp7q7Js4rJCZbXHJdz9B/7dhU4x32+gtupO752yGYeTpzeY6Xs3yZZ4+C627wuxJUKkcjPkQLlyEIS+mn6/Tc9CvO9xS6+rLOnIMHukJ7w+HG6pa3tQckd34J0yFrTtg4lDzS3bIGKhxPTx8v9dCyLLsxv7HTnjuVfjifShbBoZPNJON11/yWgjZkt34LyZAkwfg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13y2/7MfGza6VGpOo9CbMIDYxDO8u2sOp5L/cR+/XyC9q3bg+sLlsNtsfPb3Clae2EyzsFt59cYu7D9/FNdl3ZQjdszmwIVj/xnPiibevfQ8skx3r60r5tgkr60rJ3klwQI4dOgQ3333HX///TdOp5NSpUrRtGlT6tSpk63lZjfBEsnLfJFg5RaeJlj5TVYTrHzDwwQrv1GClft5rX+ufPnydOvWzVurExEREatoDJbHcvG1PiIiIiJ5U+67G6CIiIjkLqpgeUwVLBERERGLqYIlIiIi7rlUwfKUKlgiIiIiFlMFS0RERNwyMvq9J3FLFSwRERERi6mCJSIiIu5pDJbHVMESERERsZgqWCIiIuKe7oPlMVWwRERERCymBEtERETEYuoiFBEREfdcuk2Dp1TBEhEREbGYKlgiIiLinga5e0wVLBERERGLqYIlIiIibhkag+UxVbBERERELKYKloiIiLinMVgeUwVLRERExGKqYImIiIh7+rFnj6mCJSIiImIxJVgiIiLinuHy3iMHjBs3jgkTJqQ+37t3L507d6Zt27Z07NiRHTt2AJCcnEzfvn2JjIwkOjqavXv3muEbBiNHjqRFixZERUWxefPm/1ynEiwRERHJl86dO8eAAQOYOnVquukDBw7kqaeeYuHChbzwwgv069cPgJkzZxISEkJMTAwDBgygf//+ACxbtoy9e/eydOlSJk2aRP/+/XE4HG7XrTFYIiIi4pbhxTFY8fHxxMfHXzG9SJEiFClSxKNlrVy5kkqVKtGtW7d00zt06ECjRo0AqF69OseOHQNg1apV9O7dG4D69etz5swZjh49yurVq4mKisJut1O5cmUiIiL47bffqF+//lXXrQRLREREco3p06czceLEK6b36NGDnj17erSsdu3aAaTrHgS4//77U/8eP34899xzDwCxsbGEhoamvhYaGsrx48eJjY0lLCzsiunuKMESERER93JobFRGunbtSnR09BXT3VWvYmJiGD58eLppVapUYdq0aVd9j2EYjBo1ii1btjBjxoyrzme32zEyuA+Y3e5+lJUSLBEREck1stIVGBkZSWRkZKbndzgc9OvXjxMnTjBjxgwKFy4MQFhYGHFxcVSsWBGAuLg4wsLCCA8PJy4uLvX9l6a7o0HuIiIick0ZOXIk58+fZ+rUqanJFUDjxo1ZuHAhAJs2bSIoKIiIiAgaNWrE4sWLcTqd/P333xw4cIDatWu7XYcqWCIiIuKWNwe557TTp08ze/ZsypUrR4cOHVKnL1y4kC5dujB48GBatmxJYGAgo0aNAqBFixZs3bqVNm3aADBs2DCCg4PdrsdmZNSxmIe4jlfzdRNEfOaU64Kvm+AzQ4439XUTfGpPvSRfN8G3vi/n6xb41IomY726vnv9OnptXSucc7y2rpykCpaIiIi458VB7vmFxmCJiIiIWCzPdxGKiIiI5DaqYImIiIhYTAmWiIiIiMWUYImIiIhYTAmWiIiIiMWUYImIiIhYTAmWiIiIiMWUYImIiIhYTAmWiIiIiMWUYImIiIhYTAmWiIiIiMWUYImIiIhYTAmWiIiIiMWUYImIiIhYTAlWNixevJioqCjuvfdeZs+e7evmeN358+dp1aoVhw8f9nVTvG7ixIm0bNmSli1bMmrUKF83x+vGjRtHVFQULVu25NNPP/V1c3xi5MiR9O/f39fN8LpHH32Uli1b0rZtW9q2bcuWLVt83SSv+v7777n//vtp0aIFQ4cO9XVzJBfz93UD8qoTJ04wduxYvv76awIDA+nUqRMNGjTg+uuv93XTvGLLli0MHDiQAwcO+LopXrd27VrWrFnD/PnzsdlsPPnkk6xYsYJ7773X103zig0bNrB+/XoWLVqEw+EgKiqKxo0bU6VKFV83zWvWrVvH/PnzadKkia+b4lWGYbBv3z5WrVqFv/+19/Vx6NAhhgwZwrx58yhZsiRdu3Zl9erVNG7c2NdNk1xIFawsWrt2LbfffjvFihWjQIECNG/enG+//dbXzfKauXPnMmTIEMLCwnzdFK8LDQ2lf//+BAYGEhAQwHXXXcfRo0d93Syvue2225gxYwb+/v6cOnUKp9NJgQIFfN0srzl79ixjx47l2Wef9XVTvG7fvn3YbDaeeuop2rRpw6xZs3zdJK9asWIFUVFRlC5dmoCAAMaOHctNN93k62ZJLnXtnYJYJDY2ltDQ0NTnYWFhbN261Yct8q5hw4b5ugk+U7Vq1dS/Dxw4wNKlS/niiy982CLvCwgIYPz48UydOpUWLVoQHh7u6yZ5zeDBg+nTpw/Hjh3zdVO8Lj4+noYNG/L666+TmJjIo48+SuXKlbnzzjt93TSv+PvvvwkICOCJJ54gLi6Opk2b8sILL/i6WZJLqYKVRYZhXDHNZrP5oCXiK3v27OHxxx+nX79+VKpUydfN8bpevXqxbt06jh07xty5c33dHK+YN28eZcqUoWHDhr5uik/ccsstjBo1igIFClCiRAkeeOABVq9e7etmeY3T6WTdunWMHj2auXPnsm3bNubPn+/rZkkupQQri8LDwzl58mTq89jY2Guyu+xatXnzZh577DFeeukloqOjfd0cr9q7dy87duwAICQkhPvuu49du3b5uFXesXTpUn7++Wfatm3L+PHj+f7773n77bd93Syv2bRpE+vWrUt9bhjGNTUWq1SpUjRs2JASJUoQHBzM3XfffU31XIhnlGBl0R133MG6des4ffo0CQkJLF++nEaNGvm6WeIFx44do3v37owZM4aWLVv6ujled/jwYQYOHEhycjLJycmsXLmSunXr+rpZXvHpp5+yZMkSFi5cSK9evWjWrBkDBgzwdbO85ty5c4waNYqkpCTOnz/P/Pnzr5mLOwCaNm3KmjVriI+Px+l08tNPP1GzZk1fN0tyqWvn1MNi4eHh9OnTh0cffZSUlBQeeOAB6tSp4+tmiRdMmTKFpKQkRowYkTqtU6dOPPTQQz5slfc0btyYLVu20K5dO/z8/LjvvvuuyUTzWtS0adPUfe9yuejcuTO33HKLr5vlNTfddBNPPvkknTt3JiUlhTvvvJP27dv7ulmSS9mMjAYTiYiIiEiWqYtQRERExGJKsEREREQspgRLRERExGJKsEREREQspgRLRERExGJKsEREREQspgRLRERExGJKsETEY5GRkTRq1Ig9e/b4uikiIrmSEiwR8diSJUuoVKkSy5Yt83VTRERyJSVYIuIxPz8/6tate838yLOIiKf0W4Qi4rHExES++eYb9EtbIiIZUwVLRDw2duxYwsPDOXToEBcuXPB1c0REch0lWCLikd9++41vv/2WCRMmULhwYXbv3u3rJomI5DpKsEQk05KSknj11Vd54403KFasGDVq1NA4LBGRDCjBEpFMGzduHLfccgtNmjQBoEaNGuzcudO3jRIRyYWUYIlIpmzdupVvv/2WAQMGpE674YYbVMESEcmAzdBlQCIiIiKWUgVLRERExGJKsEREREQspgRLRERExGJKsEREREQspgRLRERExGJKsEREREQspgRLRERExGL/B0CerAPa1d2tAAAAAElFTkSuQmCC\n", "text/plain": [ "
" ] }, "metadata": { "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter1_61_12.png" + "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter1_61_8.png" } }, "output_type": "display_data" @@ -1947,30 +1925,6 @@ " \n", " \n", " \n", - " 1\n", - " 1.0\n", - " 1.0\n", - " 1.000000\n", - " 1.000000\n", - " 1.000000\n", - " \n", - " \n", - " 2\n", - " 1.0\n", - " 2.0\n", - " 1.587401\n", - " 0.793701\n", - " 0.500000\n", - " \n", - " \n", - " 3\n", - " 1.0\n", - " 3.0\n", - " 2.080084\n", - " 0.693361\n", - " 0.333333\n", - " \n", - " \n", " 4\n", " 1.0\n", " 4.0\n", @@ -1987,6 +1941,30 @@ " 0.200000\n", " \n", " \n", + " 6\n", + " 1.0\n", + " 6.0\n", + " 3.301927\n", + " 0.550321\n", + " 0.166667\n", + " \n", + " \n", + " 7\n", + " 1.0\n", + " 7.0\n", + " 3.659306\n", + " 0.522758\n", + " 0.142857\n", + " \n", + " \n", + " 8\n", + " 1.0\n", + " 8.0\n", + " 4.000000\n", + " 0.500000\n", + " 0.125000\n", + " \n", + " \n", " ...\n", " ...\n", " ...\n", @@ -2036,17 +2014,17 @@ " \n", " \n", "\n", - "

267 rows × 5 columns

\n", + "

264 rows × 5 columns

\n", "" ], "text/plain": [ " 1 A A^(2/3) A^(-1/3) 1/A\n", "A \n", - "1 1.0 1.0 1.000000 1.000000 1.000000\n", - "2 1.0 2.0 1.587401 0.793701 0.500000\n", - "3 1.0 3.0 2.080084 0.693361 0.333333\n", "4 1.0 4.0 2.519842 0.629961 0.250000\n", "5 1.0 5.0 2.924018 0.584804 0.200000\n", + "6 1.0 6.0 3.301927 0.550321 0.166667\n", + "7 1.0 7.0 3.659306 0.522758 0.142857\n", + "8 1.0 8.0 4.000000 0.500000 0.125000\n", ".. ... ... ... ... ...\n", "264 1.0 264.0 41.153106 0.155883 0.003788\n", "265 1.0 265.0 41.256962 0.155687 0.003774\n", @@ -2054,7 +2032,7 @@ "269 1.0 269.0 41.671089 0.154911 0.003717\n", "270 1.0 270.0 41.774300 0.154720 0.003704\n", "\n", - "[267 rows x 5 columns]" + "[264 rows x 5 columns]" ] }, "metadata": {}, @@ -2635,7 +2613,7 @@ "outputs": [ { "data": { - "image/png": "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0mmMUVluDL7rV+4xD9nqLhERmXqUTmOMqsy90g5qVqh0j3ltQnuZi4jI1KMwH2N4rXfLssA3GAPl9d9obYhPZtNERETGpTAfY3g110jYxvIMvu+T94fDPDZ5DRMREdkBhfkYphzcdYkI0ZCF5xv6yku6ttSrMhcRkalHYT7G8H3mtm3RlIwCUCjvvtJSr8pcRESmHoX5GMPz3ywL6qLlpetDNvU1USLh0OQ1TEREZAcU5mMMz2a3LIu4EwIssC1dLxcRkSlLYT7GcGVuWxZewSMatjEhSzPZRURkyqr6FqhT3ba12Q25XJH6mijh+hgL5jZMZrNERER2SGE+RiXL/dLM9ob6GO8789BJbZOIiMjOaJh9jMp+5l5pBns0pt93RERkalOYj1GZze6VHkSimsEuIiJTm8J8jOFr5qZ8b3k0qspcRESmNoX5GKa8nqspV+bhiMJcRESmtp2Gue/7O/vytFSpzMvXzDXMLiIiU91Ow/zEE0/klltuYeXKldVqz6QzlTAfvmauylxERKa2nYb5jTfeyIYNG7jgggs477zz+P73v09vb2+12jYpyvusjAhzVeYiIjK17bTsPPXUUzn11FMZHBzkwQcf5P777+fWW2/lhBNO4LzzzuPkk08mHA5Xq61VYUYOszshIrpmLiIiU9yEJsDV1dWxbNkyfvzjH/PrX/+aww8/nC9+8YuccMIJ+7p9VTd8a5rvaphdRESCYZdmsxcKBV588UVeeOEFuru7Ofjgg/dVuybNcGXuawKciIgExITKzmeffZb777+fhx56iKamJt7znvdwww03MGfOnH3dvqrzDWAMxh0Oc1XmIiIyte00qb761a/yy1/+kv7+ft71rnfxrW99i2OOOaZabZsUxhiGV3QNR0LYtjW5DRIREXkDOw3z559/nquvvppTTz2VaDRarTZNKmMA32BZWjBGRESCYadp9d3vfrfy+IknnuBXv/oVvb29fOtb3+LFF18klUqxZMmSfd7IajLGYPm6LU1ERIJjQhPg7rrrLm688UYOOOAAnnnmGQBisRhf+cpX9mnjJoNvhv/H0rrsIiISCBMK8+9///t873vf4/LLL8e2S2858MADWbNmzT5t3GQwxmwbZldlLiIiATChME+n08yaNQsAyypNCHNdd9otGAOltdm3DbOrMhcRkalvQmH+tre9je985zujjv3gBz/g2GOP3SeNmkyVCXCg1d9ERCQQJpRW119/PR/96Ee59957SafTnHHGGSSTSb797W/v6/ZV3fAwO44mwImISDBMKMzb2tr42c9+xosvvsjGjRuZNWsWRx55ZOX6+XRSqsxLj8MRhbmIiEx9Ow3zTZs2jXre0tJCS0sLAFu2bAFg9uzZ+6hpk8M3BsuUhtkdZ/r9siIiItPPTsP85JNPrkx4G16zfCTLslixYsW+adkk8Y0pl+eWKnMREQmEnYb5woULyeVynHfeebznPe+hra2tWu2aNMPD7JYFIVXmIiISADsN81/84hesXLmS++67jwsvvJD58+dz7rnncvrppxOLxarVxqoylcocwmFV5iIiMvW9Yel58MEHs3z5ch599FEuueQSfv/733PCCSfw8ssvV6N9Vef7pfvMLcBRmIuISABMeBx57dq1PPPMM/zpT3/i0EMPpa6ubl+2a9IM72NuhSztmCYiIoGw02H2/v5+fvWrX3HfffeRTqc599xzufvuu6fdDPaRPK80xB4K6Xq5iIgEw07D/B3veAdz587l3HPP5aijjgJg3bp1rFu3rvKa6bZrmueWKnNNfhMRkaDYaZi3traSz+f5yU9+wk9+8pPtvm5ZFo888sg+a9xkUJiLiEjQ7DTMH3300Wq1Y8oYvmauMBcRkaDYaZgvXbqUE088kaVLl3L88ccTj8er1a5J47vla+aOZrKLiEgw7LT8vPfeeznyyCO5//77Oemkk7j00ku58847Wb16dbXaV3XDlbmWchURkaDYaWXe1tbG+973Pt73vvfhui7PPPMM//3f/81VV11FsVisVO6LFy8mEolUq837lDc8zB5WmIuISDBMeMNux3FYsmQJS5YsYfny5WzYsIHHHnuMu+++m1WrVvGRj3xkX7azanxXlbmIiATLhMN8rLlz5/LBD36QD37wg7v83n/5l3+hr6+Pm2++eXe//T5j/NI1c0eVuYiIBETVE+upp57ivvvuq/a3nbDhW9O0lKuIiARFVcO8v7+f2267jY9+9KPV/La7ZLgy161pIiISFLs0zP7pT396h1/74he/+Ibv//znP88111zD5s2bd+Xb7lBzc81eOU9ra23lcci2sW2LpqbkqOOyjfpl4tRXu0b9NXHqq4mbCX21S2H+4Q9/GIA777yTI444giOOOIKXXnqJV1999Q3fe++9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rWx3tbbW0lYfwxhDT08a21Z1vjOtrbV0dQ1NdjMCQX21a9RfE6e+mrjp0le2be20gK3qMPtxxx3HU089RW9vL9lslocffpgTTzyxmk3YjjGmMmKgUXYREQmiqlfm11xzDRdffDHFYpELLriAI488sppN2I7xh4Nc18xFRCSYqhrmAOeccw7nnHNOtb/tDvnDVbmG10VEJKBm/JJnfnkvc10rFxGRoJrxYW5UmYuISMDN+DD3fU1+ExGRYJvxYW5Ke6xgK81FRCSgZnyY+34pzTXMLiIiQaUwN5oAJyIiwTbjwzwWC2OHbBI1kcluioiIyG6p+n3mU00k6nDSmYfghGf87zUiIhJQMz7MAaIxdYOIiASXylEREZGAU5iLiIgEnMJcREQk4BTmIiIiAacwFxERCTiFuYiISMApzEVERAJOYS4iIhJwCnMREZGAU5iLiIgEXKDXMd1bO51px7Rdo/6aOPXVrlF/TZz6auKmQ1+90c9gGVPeA1REREQCScPsIiIiAacwFxERCTiFuYiISMApzEVERAJOYS4iIhJwCnMREZGAU5iLiIgEnMJcREQk4BTmIiIiAacwFxERCTiFuYiISMApzEVERAJuRof5Aw88wJlnnslpp53GD3/4w8luzpRz8cUXc9ZZZ3Huuedy7rnn8vzzz6vPxkilUpx99tls2LABgCeffJJzzjmH008/ndtuu63yuhUrVvDe976XM844g89+9rO4rjtZTZ5UY/vr05/+NKeffnrlM/bb3/4W2HE/zhRf+9rXOOusszjrrLO45ZZbAH22dma8/ppxny0zQ23ZssWcdNJJpq+vz6TTaXPOOeeYVatWTXazpgzf983xxx9visVi5Zj6bLQ//elP5uyzzzaLFi0y69evN9ls1ixdutS8/vrrplgsmg9/+MPm97//vTHGmLPOOsv88Y9/NMYY8+lPf9r88Ic/nMSWT46x/WWMMWeffbbp7Owc9bqd9eNM8MQTT5gPfOADJp/Pm0KhYC6++GLzwAMP6LO1A+P118MPPzzjPlsztjJ/8sknWbx4MQ0NDSQSCc444wweeuihyW7WlLF69Wosy+Jv//Zvec973sPdd9+tPhvjJz/5CTfccANtbW0AvPDCC+y///7MmzcPx3E455xzeOihh9i4cSO5XI43v/nNAJx//vkzst/G9lcmk2HTpk187nOf45xzzuH222/H9/0d9uNM0draynXXXUckEiEcDjN//nzWrl2rz9YOjNdfmzZtmnGfLWeyGzBZtm7dSmtra+V5W1sbL7zwwiS2aGoZHBxkyZIl3HjjjeRyOS6++GLe/e53q89G+MIXvjDq+Xifqc7Ozu2Ot7a20tnZWbV2ThVj+6unp4fFixfzj//4jyQSCa644gp++tOfkkgkxu3HmWLBggWVx2vXruXBBx/kQx/6kD5bOzBef/3oRz/i6aefnlGfrRlbmRtjtjtmWdYktGRqOvroo7nllltIJBI0NTVxwQUXcPvtt2/3OvXZNjv6TOmzNr558+bx9a9/nebmZuLxOB/60Id47LHH1F9lq1at4sMf/jDLly9nv/322+7r+myNNrK/DjzwwBn32ZqxYd7e3k53d3fl+datWyvDfwLPPvssTz31VOW5MYY5c+aoz3ZiR5+psce7urrUb8Brr73Gb37zm8pzYwyO4+j/m8Bzzz3HJZdcwic/+UnOO+88fbbewNj+momfrRkb5scddxxPPfUUvb29ZLNZHn74YU488cTJbtaUMTQ0xC233EI+nyeVSnHfffdx6623qs924qijjmLNmjWsW7cOz/P4z//8T0488UTmzJlDNBrlueeeA+AXv/iF+o3SP7A33XQTAwMDFItF/uM//oPTTjtth/04U2zevJkrr7ySL33pS5x11lmAPls7M15/zcTP1oy9Zt7e3s4111zDxRdfTLFY5IILLuDII4+c7GZNGSeddBLPP/88f/VXf4Xv+1x00UUcc8wx6rOdiEaj3HzzzXz84x8nn8+zdOlS3vWudwHwpS99ieuvv550Os1hhx3GxRdfPMmtnXwLFy7k8ssv58ILL8R1XU4//XTOPvtsgB3240xwxx13kM/nufnmmyvHli1bps/WDuyov2baZ8sy411EEBERkcCYscPsIiIi04XCXEREJOAU5iIiIgGnMBcREQk4hbmIiEjAKcxFREQCTmEuIiIScApzkWnEdV3e/e53c/rpp++1cw4MDHDIIYfwgQ98YNTxz3/+89x00017fP6vf/3rHH300aP+HHHEERxyyCH86le/2uPzi8wEM3YFOJHp6J577qG3t5fBwUEymQyJRGKPz7lixQpaW1v585//TFdXV2XXqRUrVnDRRRft8H1f/epXAfj4xz++0/NfeeWVXHnllZXn6XSaSy+9lMbGxr36S4nIdKbKXGSaGBoa4mtf+xqf+9znCIVCrFq1aq+c99VXX+Xwww/n+OOP55FHHgHA8zxWrlzJoYceule+x7BcLsdHP/pR4vE4t99+O+FweK+eX2S6UmUuMk184xvfYN68eZx99tl861vf4rXXXuOoo47a7nVXXHFFZWOOsY455hi+/e1vjzr2yiuvsHDhQt70pjfxwAMPsGzZMlavXo3v+8yfP3+vtb9QKHDVVVdRLBb593//d6LR6F47t8h0pzAXmQbWr1/PXXfdxR133AHAQQcdxGuvvTbua8eG9RtZsWIFp5xyCosXL+bGG28klUqxYsUKFixYsNcqZ9d1+cQnPkFPTw8/+MEP9srlAZGZRGEuMg3ceuutHHfccRx77LFAKcxH7ke/uwqFAqtXr+bQQw+lvr6eI444gv/+7/9mxYoVLFy4cLvXj6z68/k8AN///veB8at+AN/3ue6661izZg133XUXtbW1e9xukZlGYS4ScM8++yy/+c1vqKmp4fjjjwdK155te/wpMZdddtlOh9m/+93vVp6vXLmSWCzGvHnzADj11FN55JFH6O7u5rTTTtvu/SPDeqIT4G644QZeeOEF7r77bpqamnb6WhEZn8JcJMCMMdx8880sW7aMq666qnJ806ZNvP/972fTpk3Mnj171HtGhvUbWbFiBYcccgiWZQFw8sknc/vtt2Pb9huG9ER88Ytf5A9/+AM//OEPaWtr2+PzicxUCnORAPvlL39JT08P1157LclksnK8paWFZDLJa6+9tl2Y74oVK1aMmrE+d+5c5syZw2uvvTbuMPuuWLlyJXfeeSfhcJizzz571Nfi8TiPP/74DkcXRGQ0yxhjJrsRIiIisvv0a6+IiEjAKcxFREQCTmEuIiIScApzERGRgFOYi4iIBJzCXEREJOAU5iIiIgGnMBcREQm4/x8jLm31tc16WQAAAABJRU5ErkJggg==\n", + "image/png": "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h85768x1Xfess85yt23btsvr9laXo8Vzzz3nfuITn3Cz2ayby+XcpUuXuo8++qjeY/3YU309+eSTo/L9NSpa5s8//zxz586lpqaGqqoqPvShD/H4448PdbGGlXXr1mEYBp/73Oc455xzWL58ueptD+677z6uv/56xowZA8Brr73GlClTmDRpEl6vl7PPPpvHH3+cLVu2kMlkOPbYYwE477zzRm3dvbfOUqkUzc3NfPOb3+Tss8/mtttuw3GcfutyNGlsbOTaa6/F7/fj8/mYPn06GzZs0HusH3uqr+bm5lH5/vIOdQHKYfv27TQ2NhYfjxkzhtdee20ISzT89PT0MG/ePG644QYymQxLly7lzDPPVL29x4033rjL4z29t7Zt27bb842NjWzbtq1s5RxO3ltn7e3tzJ07l29/+9tUVVXx+c9/nt/85jdUVVXtsS5HkxkzZhQ/3rBhA4899hif/vSn9R7rx57q65577uHFF18cde+vUdEyd113t+cMwxiCkgxfxx13HDfffDNVVVXU1dVx/vnnc9ttt+32OtXbrvp7b+k9179Jkybx4x//mPr6ekKhEJ/+9Kd55plnVGc7Wbt2LZ/97GdZtmwZkydP3u3zeo/tauf6mjZt2qh8f42KMG9qaqKtra34ePv27cUuPyl46aWXeOGFF4qPXddlwoQJqrd96O+99d7nW1tbVXe9Vq9ezRNPPFF87LouXq9XP6e9Xn75ZS6++GK+8pWvcO655+o9tg/vra/R+v4aFWH+gQ98gBdeeIGOjg7S6TRPPvkkJ5988lAXa1iJx+PcfPPNZLNZEokEDz30ELfccovqbR+OOeYY1q9fz8aNG7Ftm//+7//m5JNPZsKECQQCAV5++WUAHn74YdVdL9d1+c53vkN3dzf5fJ7/+q//4owzzui3LkeTrVu3csUVV/C9732PxYsXA3qP7c2e6mu0vr9GxZh5U1MTV199NUuXLiWfz3P++edz9NFHD3WxhpVTTjmFlStX8pGPfATHcbjooouYM2eO6m0fAoEAN910E1/84hfJZrMsWLCAD3/4wwB873vf47rrriOZTHLEEUewdOnSIS7t8DBz5kwuu+wyLrzwQizLYuHChZx11lkA/dblaHHHHXeQzWa56aabis9dcMEFeo/1o7/6Go3vL8Pd00CCiIiIVIxR0c0uIiIykinMRUREKpzCXEREpMIpzEVERCqcwlxERKTCKcxFREQqnMJcRESkwinMRUYQy7I488wzWbhw4aBds7u7m8MPP5xPfOITuzz/rW99i+985zsHfP0f//jHHHfccbv8Oeqoozj88MP53e9+d8DXFxkNRsUOcCKjxb333ktHRwc9PT2kUimqqqoO+JqrVq2isbGRf/zjH7S2thZPnlq1ahUXXXRRv1/3wx/+EIAvfvGLe73+FVdcwRVXXFF8nEwmueSSS6itrR3UX0pERjK1zEVGiHg8zo9+9CO++c1v4vF4WLt27aBc9+233+bII4/kxBNP5KmnngLAtm3WrFnDrFmzBuUefTKZDJdffjmhUIjbbrsNn883qNcXGanUMhcZIX7yk58wadIkzjrrLH7605+yevVqjjnmmN1e9/nPf754OMd7zZkzh9tvv32X59566y1mzpzJ1KlTefTRR7ngggtYt24djuMwffr0QSt/LpfjyiuvJJ/P85//+Z8EAoFBu7bISKcwFxkBNm3axN13380dd9wBwKGHHsrq1av3+Nr3hvW+rFq1itNOO425c+dyww03kEgkWLVqFTNmzBi0lrNlWXz5y1+mvb2dX/7yl4MyPCAymijMRUaAW265hQ984AOccMIJQCHMdz6ffqByuRzr1q1j1qxZVFdXc9RRR/GXv/yFVatWMXPmzN1ev3OrP5vNAvCLX/wC2HOrH8BxHK699lrWr1/P3XffTTQaPeByi4w2CnORCvfSSy/xxBNPEIlEOPHEE4HC2LNp7nlKzKWXXrrXbvaf//znxcdr1qwhGAwyadIkAE4//XSeeuop2traOOOMM3b7+p3Den8nwF1//fW89tprLF++nLq6ur2+VkT2TGEuUsFc1+Wmm27iggsu4Morryw+39zczMc//nGam5sZP378Ll+zc1jvy6pVqzj88MMxDAOAU089ldtuuw3TNPcZ0vvju9/9Ln/961/51a9+xZgxYw74eiKjlcJcpIL99re/pb29nWuuuYZwOFx8vqGhgXA4zOrVq3cL81KsWrVqlxnrEydOZMKECaxevXqP3eylWLNmDXfddRc+n4+zzjprl8+FQiGeffbZfnsXRGRXhuu67lAXQkRERAZOv/aKiIhUOIW5iIhIhVOYi4iIVDiFuYiISIVTmIuIiFQ4hbmIiEiFU5iLiIhUOIW5iIhIhfv/AaB42/HV2OLoAAAAAElFTkSuQmCC\n", "text/plain": [ "
" ] @@ -2703,7 +2681,7 @@ "name": "stdout", "output_type": "stream", "text": [ - "0.9547578478889096\n" + "0.9549351910143222\n" ] } ], @@ -2730,7 +2708,7 @@ "name": "stdout", "output_type": "stream", "text": [ - "0.03787596148305236\n" + "0.022022882954618378\n" ] } ], @@ -2762,18 +2740,18 @@ "output_type": "stream", "text": [ "A \n", - "1 0 inf\n", - "2 1 1.123190\n", - "3 2 0.327631\n", - "4 6 0.344172\n", - "5 9 0.044402\n", + "4 0 1.093247\n", + "5 2 0.275341\n", + "6 7 0.060080\n", + "7 12 0.019587\n", + "8 17 0.117986\n", " ... \n", - "264 3304 0.009911\n", - "265 3310 0.009154\n", - "266 3317 0.007824\n", - "269 3338 0.011347\n", - "270 3344 0.009790\n", - "Name: Ebinding, Length: 267, dtype: float64\n" + "264 3297 0.000148\n", + "265 3303 0.001263\n", + "266 3310 0.002948\n", + "269 3331 0.000599\n", + "270 3337 0.002526\n", + "Name: Ebinding, Length: 264, dtype: float64\n" ] } ], @@ -3146,12 +3124,12 @@ "Mean squared error: 12.36\n", "Variance score: 1.00\n", "Mean absolute error: 2.83\n", - "[ 0. 618.32047562 -861.13519106 1404.91549644] -11.057088709963637\n" + "[ 0. 618.32047562 -861.13519106 1404.91549644] -11.057088709962727\n" ] }, { "data": { - "image/png": "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jb3WyYo1mRRln8QExMa2YdzEngQG+nm7NPkBBQAREakXxaU1rFiVTk1xFWaziQEDohn1oy6YzWrvb4oUAERE5IrtP3yCdWv246quw9/Pwo+SutK7b5S3y5ILUAAQEZHLZhgGqd/ksXPrYXC4CA0NYOKknkS2b+Xt0sQDBQAREbksDqeLVesPkJtZBIZBVPswJk3uRXBIgLdLk4ugACAiIpestNLOio8zqThejslkomfvSEZf1x2LVQ/zaS4UAERE5JJkHysj5ZNMnBW1WK1mho/oxKDBHTS4TzOjACAiIhfFMAy2fXucHZuzoc5FUJAfY8f3JLZTG2+XJpdBAUBERDxyOF188tlBctILMRkG7WwhTJqsh/k0ZwoAIiJyQeVVtSxflU758QrMJhM9erbjujFxWNXe36wpAIiIyHkdPlbGJ6szcVTWYrWYGTayE/Fq728RFABEROScduw5xldfZIPjVHv/uAk96RjbxttlST1RABARkTM4nC5SPj9EzncFoPb+FksBQERE3MqralnxcQZlx07d3989rh3Xj1V7f0ukACAiIgAcOV7G6tWZOCpqsVjMDBsRy+CrYtTe30IpAIiICGl7j7N1Y9Z/2/vH96Sj7u9v0RQARER8mNN1qr0/e++p9v6IdiFMTu5NWJja+1s6BQARER9VUV3L8lWn2vs53d4/Ru39PkMBQETEB33//n6LxczQ4bFcNUTt/b5EAUBExIcYhsH2b4+xfVOOu71/7ISexOr+fp+jACAi4iMcThcfr9vP0X3F7vv7Jyf3JjRU7f2+SAFARMQHnCyvYcVHGVQWVWIymejZJ5LR13XHYlF7v69q0D3/pz/9icmTJzN58mReeOEFAFJTU0lOTmbcuHG89NJL7vemp6czbdo0xo8fz29+8xscDgcAeXl53H777UyYMIH777+fysrKhixZRKTFOXj4JO++s4vKokqsVgs/urYbY8bG6eTv4y5q79fU1JCZmYlhGNTU1FzUglNTU9m0aRPLly9nxYoV7N27l1WrVvHkk0+yePFiVq9ezZ49e9i4cSMAjz76KE899RRr1qzBMAyWLl0KwDPPPMOMGTNISUmhf//+LF68+DJ/VBER32IYBl9uO0LKynScNQ5CQgO4aWo/Bgxo7+3SpAnwGAB27tzJmDFjmDVrFvn5+SQlJfH11197XLDNZuPxxx/H398f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WCz8/Oc/56677jrrfTNnzmT79u2kpaXx3HPPsWzZMu655x5mzJjBhx9+yJEjR5g0aRK/+tWvePzxx0lLS2PQoEH88Y9/pHXr1thsNpYsWXLOGmpra/H39wcgLCyMoKCghvyRRXyOAoCInOWBBx7g6quvZvPmzaSlpXH33XczZcqUs9731ltvceedd3LDDTdw6623uqevXbuWf/zjHzidTm666SbS09NZsGAB3bt3595772XJkiU8+OCDF6whIyOD3/3ud5jNZgICAnjuuefq/ecU8WUKACJyhs8++wyA++67D4CRI0cSFRVFVlbWRS/jjjvuoF27dgAkJCQQHh5O3759ARg7dixbtmzxuIyBAwfy9ttvX2r5InKRdBeAiJxhw4YNXH/99e7XLpeL8vJyIiIiLnoZ/zn5AwQEBJzxOjAwkKqqqvopVkQumwKAiJxh165dtGnTxv1669athIeH061bN+8VJSL1TgFARNzq6urIzs5mzZo12O129u/fzzPPPMPDDz/s7dJEpJ6pD4CIuB08eJCOHTsSFxfHqFGjiIiI4P7772fChAneLk1E6pmGAhYRtw8//JB169bxyiuvnHP+gAED8Pf358477+SXv/xl4xb3PT/72c/YuXMnAwcO5J///KfX6hBpznQFQETcMjIyLtjW/+233zZiNef3j3/8w9sliDR76gMgIm779u1TZz8RH6EmABERER+kKwAiIiI+SAFARETEBykAiIiI+CAFABERER+kACAiIuKDFABERER8kAKAiIiID1IAEBER8UEKACIiIj7o/wG/u0XiRQqQvQAAAABJRU5ErkJggg==\n", + "image/png": "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jb3WyYo1mRRln8QExMa2YdzEngQG+nm7NPkBBQAREakXxaU1rFiVTk1xFWaziQEDohn1oy6YzWrvb4oUAERE5IrtP3yCdWv246quw9/Pwo+SutK7b5S3y5ILUAAQEZHLZhgGqd/ksXPrYXC4CA0NYOKknkS2b+Xt0sQDBQAREbksDqeLVesPkJtZBIZBVPswJk3uRXBIgLdLk4ugACAiIpestNLOio8zqThejslkomfvSEZf1x2LVQ/zaS4UAERE5JJkHysj5ZNMnBW1WK1mho/oxKDBHTS4TzOjACAiIhfFMAy2fXucHZuzoc5FUJAfY8f3JLZTG2+XJpdBAUBERDxyOF188tlBctILMRkG7WwhTJqsh/k0ZwoAIiJyQeVVtSxflU758QrMJhM9erbjujFxWNXe36wpAIiIyHkdPlbGJ6szcVTWYrWYGTayE/Fq728RFABEROScduw5xldfZIPjVHv/uAk96RjbxttlST1RABARkTM4nC5SPj9EzncFoPb+FksBQERE3MqralnxcQZlx07d3989rh3Xj1V7f0ukACAiIgAcOV7G6tWZOCpqsVjMDBsRy+CrYtTe30IpAIiICGl7j7N1Y9Z/2/vH96Sj7u9v0RQARER8mNN1qr0/e++p9v6IdiFMTu5NWJja+1s6BQARER9VUV3L8lWn2vs53d4/Ru39PkMBQETEB33//n6LxczQ4bFcNUTt/b5EAUBExIcYhsH2b4+xfVOOu71/7ISexOr+fp+jACAi4iMcThcfr9vP0X3F7vv7Jyf3JjRU7f2+SAFARMQHnCyvYcVHGVQWVWIymejZJ5LR13XHYlF7v69q0D3/pz/9icmTJzN58mReeOEFAFJTU0lOTmbcuHG89NJL7vemp6czbdo0xo8fz29+8xscDgcAeXl53H777UyYMIH777+fysrKhixZRKTFOXj4JO++s4vKokqsVgs/urYbY8bG6eTv4y5q79fU1JCZmYlhGNTU1FzUglNTU9m0aRPLly9nxYoV7N27l1WrVvHkk0+yePFiVq9ezZ49e9i4cSMAjz76KE899RRr1qzBMAyWLl0KwDPPPMOMGTNISUmhf//+LF68+DJ/VBER32IYBl9uO0LKynScNQ5CQgO4aWo/Bgxo7+3SpAnwGAB27tzJmDFjmDVrFvn5+SQlJfH11197XLDNZuPxxx/H398f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WCz8/Oc/56677jrrfTNnzmT79u2kpaXx3HPPsWzZMu655x5mzJjBhx9+yJEjR5g0aRK/+tWvePzxx0lLS2PQoEH88Y9/pHXr1thsNpYsWXLOGmpra/H39wcgLCyMoKCghvyRRXyOAoCInOWBBx7g6quvZvPmzaSlpXH33XczZcqUs9731ltvceedd3LDDTdw6623uqevXbuWf/zjHzidTm666SbS09NZsGAB3bt3595772XJkiU8+OCDF6whIyOD3/3ud5jNZgICAnjuuefq/ecU8WUKACJyhs8++wyA++67D4CRI0cSFRVFVlbWRS/jjjvuoF27dgAkJCQQHh5O3759ARg7dixbtmzxuIyBAwfy9ttvX2r5InKRdBeAiJxhw4YNXH/99e7XLpeL8vJyIiIiLnoZ/zn5AwQEBJzxOjAwkKqqqvopVkQumwKAiJxh165dtGnTxv1669athIeH061bN+8VJSL1TgFARNzq6urIzs5mzZo12O129u/fzzPPPMPDDz/s7dJEpJ6pD4CIuB08eJCOHTsSFxfHqFGjiIiI4P7772fChAneLk1E6pmGAhYRtw8//JB169bxyiuvnHP+gAED8Pf358477+SXv/xl4xb3PT/72c/YuXMnAwcO5J///KfX6hBpznQFQETcMjIyLtjW/+233zZiNef3j3/8w9sliDR76gMgIm779u1TZz8RH6EmABERER+kKwAiIiI+SAFARETEBykAiIiI+CAFABERER+kACAiIuKDFABERER8kAKAiIiID1IAEBER8UEKACIiIj7o/wG/u0XiRQqQvQAAAABJRU5ErkJggg==\n", "text/plain": [ "
" ] @@ -3280,15 +3258,15 @@ "name": "stdout", "output_type": "stream", "text": [ - "[2.00240127 0.09885613 4.86421839]\n", + "[1.92453978 0.40268983 4.64949142]\n", "Training R2\n", - "0.994788006691541\n", + "0.9955243414157036\n", "Training MSE\n", - "0.011239358265567037\n", + "0.010551175036576054\n", "Test R2\n", - "0.9940257354319456\n", + "0.9970085524282044\n", "Test MSE\n", - "0.010708859852916969\n" + "0.008178361333005103\n" ] } ], @@ -3392,13 +3370,13 @@ "output_type": "stream", "text": [ "Training R2\n", - "0.9999940124132914\n", + "0.9999911950922993\n", "Training MSE\n", - "2.1043064188572242\n", + "3.8076601164885733\n", "Test R2\n", - "0.9999292683946882\n", + "0.9999511330806471\n", "Test MSE\n", - "56.241106846210215\n" + "24.486869065060258\n" ] } ], @@ -3544,10 +3522,52 @@ "editable": true }, "outputs": [ + { + "name": "stderr", + "output_type": "stream", + "text": [ + "/opt/homebrew/lib/python3.9/site-packages/sklearn/utils/deprecation.py:87: FutureWarning: Function load_boston is deprecated; `load_boston` is deprecated in 1.0 and will be removed in 1.2.\n", + "\n", + " The Boston housing prices dataset has an ethical problem. You can refer to\n", + " the documentation of this function for further details.\n", + "\n", + " The scikit-learn maintainers therefore strongly discourage the use of this\n", + " dataset unless the purpose of the code is to study and educate about\n", + " ethical issues in data science and machine learning.\n", + "\n", + " In this special case, you can fetch the dataset from the original\n", + " source::\n", + "\n", + " import pandas as pd\n", + " import numpy as np\n", + "\n", + "\n", + " data_url = \"http://lib.stat.cmu.edu/datasets/boston\"\n", + " raw_df = pd.read_csv(data_url, sep=\"\\s+\", skiprows=22, header=None)\n", + " data = np.hstack([raw_df.values[::2, :], raw_df.values[1::2, :2]])\n", + " target = raw_df.values[1::2, 2]\n", + "\n", + " Alternative datasets include the California housing dataset (i.e.\n", + " :func:`~sklearn.datasets.fetch_california_housing`) and the Ames housing\n", + " dataset. You can load the datasets as follows::\n", + "\n", + " from sklearn.datasets import fetch_california_housing\n", + " housing = fetch_california_housing()\n", + "\n", + " for the California housing dataset and::\n", + "\n", + " from sklearn.datasets import fetch_openml\n", + " housing = fetch_openml(name=\"house_prices\", as_frame=True)\n", + "\n", + " for the Ames housing dataset.\n", + " \n", + " warnings.warn(msg, category=FutureWarning)\n" + ] + }, { "data": { "text/plain": [ - "dict_keys(['data', 'target', 'feature_names', 'DESCR', 'filename'])" + "dict_keys(['data', 'target', 'feature_names', 'DESCR', 'filename', 'data_module'])" ] }, "execution_count": 28, @@ -3650,13 +3670,13 @@ "name": "stderr", "output_type": "stream", "text": [ - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/seaborn/distributions.py:2551: FutureWarning: `distplot` is a deprecated function and will be removed in a future version. Please adapt your code to use either `displot` (a figure-level function with similar flexibility) or `histplot` (an axes-level function for histograms).\n", + "/opt/homebrew/lib/python3.9/site-packages/seaborn/distributions.py:2619: FutureWarning: `distplot` is a deprecated function and will be removed in a future version. Please adapt your code to use either `displot` (a figure-level function with similar flexibility) or `histplot` (an axes-level function for histograms).\n", " warnings.warn(msg, FutureWarning)\n" ] }, { "data": { - "image/png": "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BiWn06kf/ehH+sY3viGv16vrr79et9xyi9mxotYzzzwjr9erH/3oR1233XPPPRyDAXb99ddrz549uvPOO2Wz2XTzzTdr0aJFSktL4ziYbPXq1Xr44YfV2tqqsWPHavny5WZHimrz58/v+lkIBoO69957NW3aNN6jB9CkSZP0la98Rffee698Pp+uueYafeELX1BBQUGfXo8sxqUGNgEAAABgGAYAAADQHcoyAAAA0A3KMgAAANANyjIAAADQDcoyAAAA0A2mjgOACFNeXq6bbrpJ06dP19q1ay/Y9q1vfUsvv/yytm3bpjlz5qiwsFBW64XnRZ544glJ0oIFC1RYWChJCgaDcjgcWr58ue68806dOXNGt956q7Zs2aKsrKwL9l+8eLG+8Y1v6Oabbw7h/yUAhAfKMgBEIKfTqZMnT6qiokJ5eXmSpLa2tq5FKD7xi1/8oms1q08rLy9XbGysNmzY0HVbRUWF7r//fsXFxWnhwoW65ppr9PLLL+tv/uZvuu6za9cuNTc366abbgrR/xkAhBeGYQBABLLZbLr11lu1cePGrts2b97cpxKbl5enBx54QM8884wk6d5779XLL7+sT0/Hv27dOn3+85+/YPlYAIhmlGUAiFB33nmnfvvb33Z9vX79en32s5+94D733XeflixZ0vXnb//2by/7mMXFxTp8+LAk6brrrpNhGPr4448lnV/Od8uWLfrc5z7Xz/8nABC+GIYBABFq/Pjxslqt2r9/v9LT09Xa2to1BvkT3Q3D6I7FYlFsbKwkyWq16p577tFvfvMbzZo1S7/97W81b948paen9+v/BwCEM8oyAESwO+64Q7/97W+VlpamJUuW9Pnx9u3bd0HhXrZsmW655Ra1tLRo3bp1+t73vtfn5wCASEJZBoAItmTJEt19991KSUnRL3/5yz491okTJ/Tkk0/qoYce6rotNTVV8+fP109+8hPZbDZNnjy5j4kBILJQlgEggmVlZWnkyJFKTExUSkrKRdvvu+++i6aO++Y3v6mRI0eqo6Oj62y01WqV0+nUN7/5Td1www0X3P/ee+/V5z73Of3whz8M1f8GAIQti/Hpy5wBAAAAdGE2DAAAAKAblGUAAACgG5RlAAAAoBuUZQAAAKAblGUAAACgG5RlAAAAoBuUZQAAAKAb/z9mAdtQEKgqHwAAAABJRU5ErkJggg==\n", + "image/png": "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BiWn06kf/ehH+sY3viGv16vrr79et9xyi9mxotYzzzwjr9erH/3oR1233XPPPRyDAXb99ddrz549uvPOO2Wz2XTzzTdr0aJFSktL4ziYbPXq1Xr44YfV2tqqsWPHavny5WZHimrz58/v+lkIBoO69957NW3aNN6jB9CkSZP0la98Rffee698Pp+uueYafeELX1BBQUGfXo8sxqUGNgEAAABgGAYAAADQHcoyAAAA0A3KMgAAANANyjIAAADQDcoyAAAA0A2mjgOACFNeXq6bbrpJ06dP19q1ay/Y9q1vfUsvv/yytm3bpjlz5qiwsFBW64XnRZ544glJ0oIFC1RYWChJCgaDcjgcWr58ue68806dOXNGt956q7Zs2aKsrKwL9l+8eLG+8Y1v6Oabbw7h/yUAhAfKMgBEIKfTqZMnT6qiokJ5eXmSpLa2tq5FKD7xi1/8oms1q08rLy9XbGysNmzY0HVbRUWF7r//fsXFxWnhwoW65ppr9PLLL+tv/uZvuu6za9cuNTc366abbgrR/xkAhBeGYQBABLLZbLr11lu1cePGrts2b97cpxKbl5enBx54QM8884wk6d5779XLL7+sT0/Hv27dOn3+85+/YPlYAIhmlGUAiFB33nmnfvvb33Z9vX79en32s5+94D733XeflixZ0vXnb//2by/7mMXFxTp8+LAk6brrrpNhGPr4448lnV/Od8uWLfrc5z7Xz/8nABC+GIYBABFq/Pjxslqt2r9/v9LT09Xa2to1BvkT3Q3D6I7FYlFsbKwkyWq16p577tFvfvMbzZo1S7/97W81b948paen9+v/BwCEM8oyAESwO+64Q7/97W+VlpamJUuW9Pnx9u3bd0HhXrZsmW655Ra1tLRo3bp1+t73vtfn5wCASEJZBoAItmTJEt19991KSUnRL3/5yz491okTJ/Tkk0/qoYce6rotNTVV8+fP109+8hPZbDZNnjy5j4kBILJQlgEggmVlZWnkyJFKTExUSkrKRdvvu+++i6aO++Y3v6mRI0eqo6Oj62y01WqV0+nUN7/5Td1www0X3P/ee+/V5z73Of3whz8M1f8GAIQti/Hpy5wBAAAAdGE2DAAAAKAblGUAAACgG5RlAAAAoBuUZQAAAKAblGUAAACgG5RlAAAAoBuUZQAAAKAb/z9mAdtQEKgqHwAAAABJRU5ErkJggg==\n", "text/plain": [ "
" ] @@ -3705,7 +3725,7 @@ }, { "data": { - "image/png": "iVBORw0KGgoAAAANSUhEUgAAAq4AAAHqCAYAAADF3szhAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjMuMywgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/Il7ecAAAACXBIWXMAAAsTAAALEwEAmpwYAAEAAElEQVR4nOzddXQU19/H8fdq3B1ocYIFd9cAQYKU4u4WNBCCQ7FCcafQQmmLlV+Boi20FIpT3CVCiLvb7j5/LA0Jm1DYJCR5el/n5Bx25zu7H8b27p07sxKNRqNBEARBEARBEAo5aUEHEARBEARBEIT3IRqugiAIgiAIQpEgGq6CIAiCIAhCkSAaroIgCIIgCEKRIBqugiAIgiAIQpEgGq6CIAiCIAhCkSAaroIgCIIgCEKuxMfH06lTJwICAnSmPXz4kB49etCuXTtmzZpFenq63u8jGq6CIAiCIAiC3m7fvk2fPn3w9fXNdrqnpydz5szh1KlTaDQa9u/fr/d7iYarIAiCIAjCf1xsbCwBAQE6f7Gxsf867/79+5k3bx729vY60169ekVycjI1atQAoHv37pw8eVLvnHK95/x/KC38RUFH0LG49pyCjqBjcquQgo6g4/Bpx4KOkK2ubqEFHUHH8l9tCzqCjqnVXxV0hGyNumVZ0BF07JpVpqAj6IqPL+gE2Yo78rSgI+gY42Ne0BF07HJXF3SEbA06XPj61g75HSnoCPnWVtn14zE2bNig8/z48eOZMGHCO+ddvHhxjtNCQ0Oxs7PLeGxnZ0dIiP7tCNFwFQRBEARB+I8bNGgQ3bp103ne3Dx3X7Y0Go3OcxKJRO/XEw1XQRAEQRCEokKtypeXNTc3z3UjNTsODg6Eh4dnPA4LC8t2SMH7Knz98IIgCIIgCML/C8WLF8fAwIAbN24A8PPPP9OsWTO9X080XAVBEARBEIoKjTp//vLYiBEjuHv3LgArV65k6dKldOjQgaSkJAYOHKj364qhAoIgCIIgCEKunT17NuPf27dvz/h3xYoVOXjwYJ68h2i4CoIgCIIgFBXqwnkXiI9FDBUQBEEQBEEQigTR4yoIgiAIglBEaPJhPGpRInpcBUEQBEEQhCJB9LgKgiAIgiAUFf/xMa6i4SoIgiAIglBU/MeHCoiGaz7QaDTMXryKcmVKMqTvZx/9/cu3qkGb6b2QKeWEPHrJkenbSYlP0qmr1q0xjUZ2BA2kJadwYt5uAu/65EkGebX6GH42DOQK1AEvSNz5FSQnZl9bsxHGI2YQO9Y96wQjE0xnriZp50pUvk/yJFfx1jWo5fU5UgMFUQ/9uTT1a9KyWTbvqnMe1IZyfVogM1QQeceXi9O2o05N1zuT3KUeBt2Hvl5WPiTtWpXzsqrRCKOhnsR5vP5ZPokEg+7DkFerB2oN6tBXJH+3Fk18jN55/uHcsgau03sjU8oJfvSS/83Ylu12VL1rY5qO6gQaDalJqRybv4tXd32QSCS4zuiNc6uaaNRqInyD+dl7B4mRcXrlUdRugNHAkUgUClS+L4hfvxySsi4nA7duGHRwB40GdXAgCRtXoImJBsBy92HUEWEZtck/7yX13G96ZXlbrVa16Tt9IAqlAr9Hvmyevp6kbJZV+0FuuPbvgEajIcQvmC1eG4mNiEEqlTJs4UgqN6gKwN+/X+e7xd/qnef8i1DWn39MqkpNeTsz5rm6YGqgyFLzNCyW5WcfEJ+SjlQKs9u6UNnBgjSVmuVn7/N3QBQAjUvbMalZRWRS/X+iEUBa2gVlk+4gk6MODyD19C5ITc5So2jWE1mF2hnbvzoqmNRj27TTGnZGVqEuaNSoQ/xI/e07UOm/3/1D2aABpiNGIFEoSH/xgtgvv0STmHW7MmzbFuNevQDQJCcTt3496Y8fg0KB2YQJKGvVQpOURMrFiyR8+y1k8xOXH6p2qzr0mz4QhVKO3yM/Nk5fl+021WFQR9r17wAaDcF+wWz22kBMRAymFqaMWjyGUpVLk5KUwtkDv3H822N655FVroNB50FI5ApUgb4k/7gWknXzAMhdGmA4YArx0z9/81z1RihdPweZAk1UKEnfrYJE/Y4FmRW25STkv486xjU+Pp4FCxbQqVMn3N3dGTBgAPfv3ycgIICqVavi7u6Ou7s7nTt3plWrVqxbty5jXmdnZwACAgJwdnZm7ty5WV774cOHODs7c+jQoY/5X9Lx3NefYR4zOXX2fIG8v7G1GV1XjGTf6DVsaOVJlH8obbx66dTZlHGirXcf9gz6ki1u3vy5/md6bZ2UJxkkZhYYDZtG4sYFxHsPQR0WhGHP4dnWSh2KY9hrFEiyboryavUwnbsRqdMneZIJwMDajEarRvDHyLUcbuZJvF8otbx1l8276j7tUAfnIW35tfdSjrT0QmaooPKIDnpnkphaYDh4GkmbF5IwZxjq8CAMuw/LtlZqXwzDniOyLCtF43bISpYnYdE4EhaMQh0aiMHnI/XO8w9jazO6rxjFD2PWsKb1NKJehtBuRm+dOtsyTnTw7suugcvZ4ObNH+t/pu+WyQDU/rw5xV1Ks7GTN+vbexHhG4LbrP565ZGYW2Di4UX8sjnEjB2AKjgQ44GjstTIylbAsGsv4maMI9ZjCKrAAIz6apeltPgnaOLjiJ08POMvrxqt5tbmjF3hwcrRy5jYaiwh/sH089K9uXaZqmXpPKIrs7vPYKqrB0G+gfSe2heAZt1bUKxscaa6ejCt/UQq169KA7dGeuWJTExh3sk7rOhSi5+HNqeEhTHrzj/OUpOUpmLsT9cYVLcMewc2YUSD8sw6dguAvTd9iUpM5eDgpuwf1ITbgVGcfhykV5YMRqYYtBtMytHNJH87B01MOIom3XXKpMXKknpsO8l7FpK8Z2FGo1VaogIy57okf7+I5N3zwcAIec1WucsESCwssJgxg5i5c4kYOBBVYCCmI7PuP7JPPsF09Giip08ncvhwEr77DsuFCwEw6dcPmaMjEUOHEjlyJFIbG4y6ds11LnNrc8av8GDF6KVMeL1NDfAapFNXpmpZ3Ed0xbv7dCa5TiDIN5A+U/sBMGTucJISk5nYZjxeXT2p2aI2tVvV0SuPxNQcw36TSNq5lITFo1FHBGPQeXD2tXbFMOg6FDL9Fr30k3IYfDaapB1LSFw2DnXoKww66X8D+n8UtuX00ahV+fNXRHy0hqtarWbEiBFYWFjw888/c/jwYcaNG8eIESOIjo7G3t6ew4cPc/jwYY4ePcqPP/7Izp07ef78uc5rWVpacv78eVSqNwv6+PHjWFtbf6z/To72/vQLXTu2pV2rpgXy/mWbufDqzgsifUMAuL7nN1zcG+vUqVLTODLja+JDowEIvOODqZ0lMoUs1xnkVWqj8nmCOuQVAClnj6Js0Fq3UGmA0Qgvkvdu0Z3UphtJXy9HEx2R6zz/KNbchYjbPsT5aJfN491nKN1Nt3HwrroynzXhwdYTpEYngEbDZa9veP7TBb0zyarURuX7GHVoIACpf/yCon42H8hKA4yGeZG8f2uWp9WBfiQf3A7paQCo/J4gtXbQO88/yjetxqs7L4jwDQbgyp7fqJ7NdpSemsb/ZmwnLiwagFd3X2RsRyFPX3FyyQ+oXvdGv7r7AssStnrlUdSsS/qzR6iDXm9TJw+jbN4mS43q+RNixvRDk5gACiVSGzs0cbEAyCtWBbUasy/WYL52J4a9BoE0bw5/1ZrV5PmdZwT7aht3p/ecpKl7c526F/ee49FiDIlxiSgMFFg72BAXpe1xksqkGBgZIlfKUSgVyBVy0lLS9Mpz2S+cKo4WlLQyAaBn9U858TAQTaZewMu+YZSwMKZpGe3vhbcoa8/yzjUBGFCnDMs61UQqkRCTlEZ8ShoWRgrdN/oAspJVUAf7ookOBSD99h/IK9V/q0iO1P5T5HVcMRwwF2Xn0UjMXh/TJVKQKUCuAKkMiUwO6bnvbTWoW5e0R49QvdJuV4lHjmDYJut2pUlLI3bFCtSRkQCkPX6M1Noa5HIUzs4knz0Lqamg0ZBy4QKGzXXX/Yeq0awmz+48Jej1NnVyz4kct6lxLUZnu02VdSnLuUO/o1arSU9L58bZ6zR0092H34esYi3U/k/RhGmPU2kXjqOo00K3UGGA0YCpJP/v66xP121J2uXTaCK16z/lxA+knsn9zegL23ISPo6PNlTgypUrhIaG4uHhgfT1B0aDBg1YunQp6mwGGoeFhaHRaDAxMdGZZmJiQsWKFbl27RoNGjQA4K+//qJRI/16KPLSrKljAbhy/VaBvL+Fkw2xgZEZj2ODIjE0N8bA1CjLad7ogHCiA8IzHreb04/Hv/2NKi3337qk1vaoXx+gADRRYUiMTcDQOMspcKNBk0g9dwzVyxc6r5G4amauc7zNpJgNCYFvGsKJQZEozY1RmBplGS7wrjrzMk4Y2r6g9Z7pGDtYEnL1MX9/sVfvTFIrOzRRb05f57SsDPtPJPXPY6gCsg7lUL14+OaBsSkGnfqTeu4XvfP8w6KYNTFBb5bB+25HbrP78+i3G6jSVLz8++mb/OYmtPLoztXvz+iVR2prjzr8zTalDg9DamIKRsZZhwuoVCjqN8FkvCekpRH7ww4AJFIZabevk/jNZiQGBpjOWYYmMYGUo7n/8LR1siU88M0yiAgKx9jcBCNTI51Tlqp0FXVd6zN6+XjSU9PYt+oHAP44cJaGbo3ZevUbZDIZt8/f5MaZa3rlCY5NxsHMMOOxvZkh8anpJKSmZwwX8ItKwMbEgPmn7vAkLBYzAwWTmlXMmEchk7L2z0fsu+VHZQcLahbPXaeAxMwKdVxUxmNNXBQSA2NQGmYMF5CYWKJ++Yi0C4fQRIUgr+OKgfs4kvcsQv3yEWr/BxgNXw5qFerIYNLvnMtVJgCpvT2qsDf7nzosDKmpKRJj44zhAurgYFKDgzNqzMaNI+XiRUhPJ+3BAwxbtiTl3Dk0aWkYtm6tbdTmkk0225TJO7apeq71Gbt8Ammpaexd9T0AT249oXn3ljy6/hCFUkHDDo1IT9OvsS+1tEUd9SaPJjociZEJGBplGS5g2HscqRdPog70zTq/XXFUgT4YjpiN1NoBdaAvKf/bTm4VtuX00fzHx7h+tB7XBw8e4OLiktFo/Ufz5s2xtrYmNDQUd3d32rdvT/369VmzZg0bNmzA0dEx29fr0KEDp06dAuDOnTs4OzujUOSuV+D/A0kO49DUquw3dIWRAT03eWBd0pEjM3J/INGGyGEsXKYvKMqWXUClIu38ybx5z/eRw7LRvL1s3lEnVcgo1qwqf45ezzG3ORhYmlLDq2eeZ8q8rBQtOoNaRdpfp3J8GYmdEyaeX6F6do+034/on+ef15Nkf2h413bUe+NErEs58D+vrNuR9af2jNg/B7/rj7m8+7SegXI4VGXzpTftygWiB7iT9OO3mM1fCRIJKb/+QuL2dZCehiYhnuTD+1E2yJuzIh+6z107fYVhNQewf/WPzP5uPhKJhJ6TehMbGcOI2oMY3WAoppZmdBrhnu38/0ZD9uMrM49RTVdr+MsnlB7VPuWH/k3oXbMUEw5dIzX9zRfXic0qcm5cW4pZGLHkt3t6ZcnwHutPExtOyv/WoYnSnulIv34aiYUdEnNbZFUaIzG3JWnrNJK2TkMTG46i+efZv+YH5cphX8/uqm1DQyzmz0dWvDixK1YAkPDjj6T7+mK1cSNWX31F2v37aPKgJ/jtz8l/5LRNXT19hcE1+7Nv9Y/M+W4BEomEb7/YCRoNXx1fw4xt3tw+f0v/Btl7HNMVTdxApSL98q+6dTIZ8qr1SNm7gcQvPdDERmHQe4J+WTIpdMtJ+Cg+Wo+rVCrNcqrqbf8MFVCr1SxbtozHjx9n9KZmp2XLlqxZswa1Ws2JEyfo0KEDx48fz4/ohV7LKT1wblMbAAMzI0IevcyYZuZoTVJ0PGlJKTrzWRSzoc+OqYQ/C+Tb3l+QruepybepI0NRlK2U8VhiZYs6PjbLhRiKJq5IlAaYLtiiPQWoVGK6YAsJq2fl6fCA6tN68IlrLe17mhoRnWnZGDtakRIVT/pbyybhVQR2NctmW5cYHIX/iesZPbQvDv1FtUld9c6niQhDUvpNT5fE0hZNQtZlpWzUFpSGmMzdDDI5KJWYzN1M4tpZaGIikTlXx2jkLFJP7Sf1tP49iK0nf0alttplZWBqTMhj/4xp5o7WJL5jOxqwYxphzwLZ8dZ2VLphZXqvn8D5rb9wYbv+Fzyow0KQV3izTUltbFHHxULKm+UkdSyO1Mqa9Id3AUg5cxzjMVOQmJqhqN0Alc8zVH6ve/clklxd2NNrSl/qtKkLgJGZMf6P/DKmWTvaEB8dR8pby8qxpCOWdlY8uq7tJf99/xlGLhmDiYUp9do3YOe87aSnpZOels65g2dp4NaIX7Yf/uBsjmZG3A2KzngcGp+CuaECI8Wbw72dqQGlrE1xcbIEoGU5BxaevktATBKxyalYGSkpaW2KQialS5USLD97/4NzZKaJi0DqWDrjscTUEk1yAqSnvnnOtjhSu09QPbz8ZkaJBNQq5OVrkf7oCqRpl2n6nT9RtupLbo9Y6tBQFJUybVe2tqhjYyE560VjUnt7LJcsQeXvT9SkSdqhAYDU3JzEffuI37wZAIOWLTOGHXyo3lP6UrdNPUB3m7JxtCEu223KCUs7y4xt6uz+3xj1epsyNDZg95JviY+JB6Db6O4Zw1k+lDoqDHkp54zHEgsbNAlxkPomj6J+G1AYYDx9HcjloFBiPH0dSVvmo4mJRB3khyYuGoC0K79hNH6xXlkK83L6aP7jt8P6aD2uVatW5cGDBzqN11WrVnHlypU3gaRSpk+fTkREBDt37szx9UxNTalYsSI3btzg8uXLhWKYQEH5fdVPbHHzZoubN193nUeJmuWwLqUd51inX2senb6hM4+RhQmD98/m4cnrHJywIc8arQDp924gK1MJqUNxAJQtO5N+82KWmoRF44mfM4L4eaNJWO0NqanEzxudp41WgNsrf+IX11n84jqLE53nY1urHGaltcumwoDWvDz9t848Qefu5ljnf+wqJTvVR2ao7d3/tF1tIm7rDnV4X+kPXi8r+2IAKJt3Iu3WpSw1CUs8SJg/koSFY0hcNxtSU0lYOEbbaC1bGeOx80ja+WWuGq0AZ1YfZIObNxvcvNnSbS6f1CiPTSntGY96/Vrz8Nfst6Ph++bw4OQ19k1Yn2U7+rRWefptnczBqZtz1WgFSLt1DblzZaRO2m3KoH0X0q7+laVGam2D6bS5SMwsAFA2b4vK3wdNXCyyT0tj1HeodlyrUomhWzdSz/+ud559q37A020ynm6T8e46nfI1nXEs5QSAa7/2XDt9VWceS3trJm2YhpmVGQBNujbH/7E/8dFx+Nx7QaOO2nF1MrmMOm3r8eTmY53XeB8NS9lyNygav6gEAA7e9qNFWfssNY1L2xMYm8SDEO3dJ24ERCIBilsYcdU/gpV/PCRdrUat0XD8YSB1P9FvbPI/VL4PkDmVQWKpzSGv3hzVs1tZizQalC17IzG3fV3TAnVYAJr4KNShfsjL1crouZWVr4U6SP/97h8p166hqFwZWXHtdmXcpQspf2XdriRmZlivXUvK+fPELFyY0WgFMGjUCPOpU7V1RkaY9OxJ8m/6XfS3d9UPTHWbxFS3Sczs6kmFms44ZWxTHbh2+orOPFb2Vkzd4JmxTTXr2pyXr7epdv060Pv1BUgWtpa06dOO84f1G16henQTWUlnJHba45SiiRvpdy9nqUn8agqJy8aR+KUHSVvmQ1rq697VSNJu/4W8ch0w1uaUV2+E2v/p22/zXgrzcvpYNBp1vvwVFR+tx7VOnTrY2NiwYcMGxo4di0wm4/z58xw6dIiNGzdmDSWXM336dCZOnEj37t2xs7PL9jU7dOjAV199RdWqVZHLxZ29ABIiYjnsuZXPN09EppQT5RfK/yZrewOKuZSmy/IRbHHzps6ANlgUs6VSuzpUavfmCspdfZeQFB2fqwyauGiSdq7AeOxckMtRhwaR9PVyZKUqYDRkCvHzRufq9fWVHBHLxSnbaL7NA6lCTrxfKBcmai8Ms6lWmoYrh/OL66x31j3e9RtKS1M6nvgCiUxK5F1fri/8Qe9Mmrhokr9ZidHoOdrbYYUFkrRjBdKS5TEaNIWEhWPeOb9Bl4GABMMew6CH9gp6dXgwSZsW6J0JtNvRT55b6bN5IjKFnEi/EA5O0W5HxV1K0235CDa4eVO/fxssi9lSuV0dKmfajnb0XULryZ8hQUK7Gb0z7kgQ9TKM70et/uA8mphoEtYtw3TGQu3teIJfkbBmCbJyzpiM8yR28nDSH9wh6cAezBavAZUKdWQE8UtmAZC091tMRk3CYt03IJOT+tcfpPya+7HAALERMWzyXMfUzTOQK+WE+AWzYfIaAMq4lGPM8nF4uk3m0bUHHNpwgPn7FqNOVxEZGsmKkUsA+HbhDoYtHMGaMxtRq9Xc/esOhzfrd4cUa2MD5rerhufRv0lXqSlhacyi9tW5HxzNwtN32TewKbYmBqxyr83S3+6RlKZCKZPyVZdaGMhlDKlXlhW/P6DX7gtIJVCjuDUTmjr/+xu/S1IcKae/waDzaJDK0cSEkXJyB1KHkijbDiJ5z0I0EYGk/v4jBl3Hg0SKJj6K1OPaYSdpV46jaP45hoMXgioNdVgAqWf03+/+oYmOJnb5ciwWLNDeZi0wkJglS5A7O2Pu6Unk8OEYu7sjtbfHoGlTDJq+GV4SNWUKSSdOoKhUCZtvvgGZjKRffiHlXO4bPTERMWzwXIvnZi/kSjnBfsGsm6zdb8q6lGPs8vFMdZvEw2sPOLjhAIv2LUH1epta9nqb+mnTQSaunsya0+tBImHfmh95dueZfsspPobkH9ZiNHQmyORowoNI2rMK6SflMOzjQeKXHu+cX3XvKqmWNhh7LAOpBE1kKMk/rHvnPO+jsC0n4eOQaN51/j6PRUZGsnTpUu7du4dcLsfKygovLy/Mzc0ZOHAgZ8+ezVI/ZMgQihUrxuLFi3F2dubx48cEBARk1CYkJNCoUSO2bNlCw4YN8fLyol69enTvrnublfeRFp77b/B5bXHtOQUdQcfkViEFHUHH4dPZj4UuaF3dQv+96CNb/mvues/yw9Tq+p1ezW+jblkWdAQdu2aVKegIuuJz92U3v8Qd0a9XLz+N8TEv6Ag6drkXzt62QYcL36/SH/LL/TUEuZXy9OK/F+nBoHzROHP9Ubspra2tWfF6UPvb3m60AnzzzTcZ/378WHvarESJEhm1JiYm3L59O6Nm2bJleRlXEARBEARBKETE+XVBEARBEISiogiNR80Pha8fXhAEQRAEQRCyIXpcBUEQBEEQiooi9POs+UE0XAVBEARBEIoKMVRAEARBEARBEAo/0eMqCIIgCIJQVIhfzhIEQRAEQRCEwk/0uAqCIAiCIBQVYoyrIAiCIAiCIBR+osdVEARBEAShqPiPj3EVDddMFteeU9ARdMy6saigI+ho6DKooCPomCrRFHSEbLU5llLQEXQcq/KqoCPoaHo5uaAjZOv6l5UKOoIOj3nPCzpCkRGhMS/oCDqWGKQXdAQd/X8unCdfv60bW9ARCiWN5r99H9fCubUKgiAIgiAIwltEj6sgCIIgCEJRIS7OEgRBEARBEITCT/S4CoIgCIIgFBX/8YuzRI+rIAiCIAiCUCSIHldBEARBEISi4j8+xlU0XAVBEARBEIoKtbgdliAIgiAIgiAUeqLHVRAEQRAEoaj4jw8VED2ugiAIgiAIQpEgelwFQRAEQRCKiv/47bBEwzWXyreqQZvpvZAp5YQ8esmR6dtJiU/SqavWrTGNRnYEDaQlp3Bi3m4C7/p8tJwajYbZi1dRrkxJhvT97KO8Z+PWDRnvPQqlUsHTh89ZNGUZCfGJOnWT5o2jTeeWxERpf5fa77k/3qPnI1fImb54EjXqVwfg4tnLrFu0GXUudtpirWtQfWYvpAZyoh+85MrU7aRns77ep67J15NIConixqxdeuf5R+PWDRg7cyRKAwXPHrzgi6nLs11WE+eOpXXnFsRG/7OsXjJr9AIkEgnjZ42icesGqNUaXvoEsHT6SqIjY/TKo6zXAJNhI0GhQOXzgrivlqNJzJrH0L0bRp3cQaNBFRRI3OoVaKKjM6ZL7eywXLeZqFHD0MTql+Ntzdo0ZtKsMSiVSp48eMacyYtJiE/QqfOc70G7zq2Jeb2cfJ77MW3kbGYunkKdBjUz6uwd7QgLDad7y/56Z/rzWTDrf79PqkpNeXtz5neshamBIkvN09AYlp2+Q3xKGjKJhNkdalDZyQqA3x69YsfFJ6Smq3CyMOaLzrWxNDbQO88/XFrWovv0vsiVCgIe+bFrxmaSs9nWWw5sT4v+rmg0GsL8Q9jttYW4iDe/EW/lZMPM/y1hYYdpxEfF/b/LBFC7VR36TR+IQinH75EfG6evIymbXB0GdaRd/w6g0RDsF8xmrw3ERMRgamHKqMVjKFW5NClJKZw98BvHvz2mdx6TFnWxmzIYiVJBymMfgr3XoE7QzQPgtGwyKU/8iNx5SPuEVIrD3DEY13MBIP7cNcKW79A7S2a1W9Vh4IxBKJQKfB/5st5zbbbL6R/1XRswafUU+lT5POv/z9yEJQeWsd5zLc/uPMtVJnmtBhj1H4FErkDl94KETV9CUtZjlUGHbhi06wIaUAW/InHzSjSx0dpp7dxRtumIRGlA+vMnJG76EtLTcpVJyF+FfqjA9evXcXd3z/JXqVIlNm3aRP369QkPD8+oDQgIoFWrVh8tm7G1GV1XjGTf6DVsaOVJlH8obbx66dTZlHGirXcf9gz6ki1u3vy5/md6bZ300XI+9/VnmMdMTp09/9He09LGknlrZjJ9+Gx6NO3HK79Axs8anW1ttTpV8R49n35th9Kv7VC8R88HoNfQHljaWNKrxUD6tBpMtTpVadulpd6ZDKzNqL96JOdHrOFYU0/i/UOp4a27vt6nrtLYTtjVd9Y7S2aW1hbMWe2F14g59Gw6gFf+gYzzHpVtbbU6VZk1ZgH92w6nf9vhzBq9AIAufdyo6FKBAe1G0Lf1EAJ8XzFp3ji98kgsLDCb5kXswjlEDR2AKigQk2FZ88jLV8D4s15ETxxH1MghqF4FYDJoWMZ0gzbtsFy1HpmtnV4ZsmNlY8kXa2czaehMOjX+nAC/V0yZPTbb2hp1qzFt1Gx6tB5Aj9YDmDZyNgBLZ63KeG7C4OmkpKTiPX6B3pkiE1KY98sNVvaoz+HRbSlhacLa3+9nqUlKS2fMj38xuEF59g1rxYgmzngfvg7A/aAolp26zcru9fhpZBtKWpuy4dwDvfP8w9TanMErxrJ5zErmtJ5I+MsQus/op1P3adUyuI7szLIes5nfbiohPkG4T+2dMb1h92ZMP7AQK0fr/5eZAMytzRm/woMVo5cyodVYQvyDGeA1SKeuTNWyuI/oinf36UxynUCQbyB9pmrzD5k7nKTEZCa2GY9XV09qtqhN7VZ19MojszLHaelkXk1YjE/7kaS9DMZu2hCdOmXZT/hk11LMOjTN8ryFeyuUpUvg02ksPl3GYVzPBbP2TfTKkpm5tTkeKyexbNRSxrYcTbB/MAO9BudY71SqGENmD0UilWR5vnbLOqw4soriZUvkOpPE3AKT8TNIWDGXWI+BqEMCMeo/MkuNrEwFDLr0ItZ7PLGTh6AOeoVRn6EAKOo3xcCtO/ELphI7aTASAyUGnXvmOle+06jz56+IKPQN1zp16nD48OGMv27duuHs7IyVlRUJCQnMmzevwLKVbebCqzsviPQNAeD6nt9wcW+sU6dKTePIjK+JD40GIPCOD6Z2lsgUso+Sc+9Pv9C1Y1vatWr678V5pEHzujy49YiXPgEAHNz1Mx26t9WpUygVOFctT/8xvfnht2/48utFOBS3B+D7rfuYOWoeGo0GCytzzCxMiYnWv3fFsbkLEbdeEO+jXV/Pdv1Gye666+vf6uwbVcapRTWe7T6jd5bM6mcsq1cA/LTrMO27t9GpUygVVKhajv6je/P9rztYtn1hxrJ68diXdV9sJi1V21Pw8PZjHEs46JVHWbsuaU8eoXqlzZN09DAGrbPmSX/6hMjB/dAkJoBCidTWDk2ctkdMamODQeMmxMyaodf756RRi/rcu/kQf5+XAOzddYiOPdrr1CmUCipVrcDgsf04dHYPa3Ysw6m47rJY8NVMdm/9gUf3n+qd6ZJPKFWcrChpbQpAz1qlOXH/JRqN5k3Ni1BKWJnQtJwjAC3KO/Fl93oAHLv3kq7VS1Hc0gSA0U0rMbhBBb3z/KNK02r43nlOqG8wAH/sOU19d9393//eC2a38CApLhG5gQIrR2sSXvdgWthbUcO1HusGL811nsKaCaBGs5o8u/OUIN8gAE7uOUFT9+Y6dS/uPWdci9EkxiWiMFBg7WBD3OtcZV3Kcu7Q76jVatLT0rlx9joN3XSPLe/DpEktku8+Ic0vEIDoH49hns0Xdqt+nYg59CtxJ97qkJBJkRobIlEqtH8KOZqUVL2yZFazWS2e3X5KkK8218nvjtO8a4tsa5WGBkxZO5Wdi77WmdZpSGfWTllNZEhkrjMpqtdF9ewR6iDtsSrl1BEMmmY9VqlePCF2fD/451hlY4v69bFK2aIdyUf2o4mPA42GxK2rSD13Ote58p1anT9/RUShb7hmdv36dTZv3sy6deswMDCgXbt2+Pn5cfTo0QLJY+FkQ2zgm50vNigSQ3NjDEyNstRFB4Tz9OytjMft5vTj8W9/o0r7OPdimzV1LF3at/4o7/UPh2L2hASGZDwODQrD1NwUE1PjLHV2DrZc/+tvNi7ZSt82Q7h74wGrvnnzoaRKVzHeexQ/X95LZFgUN6/c1juTcXEbEjOtr8SgSJTmxsjfWl/vqjNysKT2wgFcHL8JTR7t6A7F7QkNDM14nPOysuH6XzfZuHQb/doO497fD1j5zRIA7t64z+O72gaYmYUpwyYP5Mwvf+iVR2pnjzrsTR51WBhSE1MkxlnzoFKhbNQEmx8PoHCpRvKp49r6iAhiF8xB5e+n1/vnxKmYA8GZtqmQwFDMzE0xMTXJUmfvaMuVCzdYs3gT3Vv15/aNe6zftSJLTZNWDXEs5sCe7ftzlSkkNhFH8zfbj4O5EfEp6SSkpmc85xcZj62JIfOP/U3fnb8z+se/UKk1GdNUGjWTDlzi86/PsPTUbYyVuR/BZVXMlqigN2ejooIiMDY3xvCtbR20+1gN17p8eWkL5etV5q8DvwMQExrF5tErCXoWkOs8hTUTgI2TLeGBb3JFBIVjYm6CUQ656rnWZ/vlb6hcvwpnD/wGwJNbT2jevSUyuQxDY0MadmiElb2VXnnkTnakZVpOacHhyMxMkJpkzROycDOxh8/qzB9z6DdUMXGUO7+bchf2kOYXRPzvV/XKkpltMVvCM+UKf8dyGrtsHCe/P4nvQ1+daQsGzuPx349ynQdAYmuPOjws47E6IgyJiSkY6R6rFPWaYLHtAPJK1Uj9/QQAMqcSSC0sMZ39JWardmD4+WA0CfF5kk3IP0Wm4RoREcGUKVNYvHgxn376KQAKhYKlS5eydOnSLEMGPpa3T4H8Q63KvkGjMDKg5yYPrEs6cmTG9vyMVuCk0uw3LdVbyybwZRAT+0/H77m2F+27zT9SvFRxin3ilFGzYclWWlZ0I/BlMDOXTdU7k0SS/frSvJUppzqJBBptnsDf874j+XXveV6QSt53WQUzecAM/F8vqz2b91K8ZDGKfeKYUVO8ZDG2HlrP7at3OfDN//TKI8lh3WXXUE+9eIGIz9xJ3P0tFktXahdSPslxf3vrZtyv/IMY028yvs/9Afhm0x4+KVWC4p++2aYGjurDjvW7czVeGkCtyf55WablkK7WcOF5CD1qlOKHoS3pXacM4/ddJDVdRbpKzbmnwczuUJO9w1pha2rAwhM3c5UJQJrDesjp2HTr9DWm1BrG0TX7mbR7do77wP+3TJDzsSqnXFdPX2Fwzf7sW/0jc77Tji//9oudoNHw1fE1zNjmze3zt0hPS892/n+T03b+vl+Ubcf3RRUVy9NG/XjebCBSC1Osh3bTK0uWXO+5/joMcEOdruLM/l9z/Z76Zsqu9zDt6gVihriTtP9bTOes0B6r5HLk1esQ/9V84qaPQmpmjlHf4fmcOg8Uwh7Xo0eP4ubmRtu2bfn+++91pt+/f58ePXrQpUsXRo0aRWxsbDav8n6KxMVZarWaqVOn0rFjR9q0yXoawMXFhZ49ezJv3jxmzpyZ71laTumBc5vaABiYGRHy6GXGNDNHa5Ki40lLStGZz6KYDX12TCX8WSDf9v6C9JT/f4O/R3kOo5mr9vSYiZkJzx8+z5hm52RLTFQsyUnJWeYpV6ksFaqU4/jBUxnPSSQS0tPTqV7XhaiIaPxfvESVruKXfcfxXDzpgzK5ePaguKt2fSlMjYjOtL6MHK1JiYpH9db6SnwVgU2tcjp15hWKY/KpHTXnay/kMbSzQCKTIjNQcHWa7imxdxnpOZRmro0AMDE14dmjFxnT7BxzWlZlKF+5HCd+enMqS7ustA232o1qsnjLPL7b9CPfb9n3QXkyU4WGIK9YKeOx1NYWdWwsJL/JIy1WHKmVNen37wKQfOo4phOnIDE1yxgykBfGTx9Jy3ba08kmZiY8zbRN2TvZERMVQ1Ji1uVUoXI5nCuX5+jBExnPSSSQ/voMh5WNJdVqVWHikOm5zudkYcS9TL3zoXHJmBsqMMrUa2pnakgpG1NcimvHZLasUIyFx24SEJ2AnZkh5e3NsTU1BKBLtZKM/P6CXlm6TO5FjbbacZWGpka8euyfMc3S0ZqE6HhS39rW7Uo6YmFnybPr2h6wC/t/p//ikRhbmJAQnfuep8KYCaD3lL7UbaMdrmFkZoz/ozdnB2wcbYiLjiPlrVyOJZ2wtLPk0fWHAJzd/xujlozBxMIUQ2MDdi/5lvgYbb5uo7sT/HrowYdKCwzDsNqb8fNyB1tU0XFosvlcyY6ZayNCFm2BtHTUaenE/u8MZu2bELnzw7/I9p3Sj7pt6wNgbGaM3yPfjGk5LadWPdtgYGTA6hPrUCjlKA2VrD6xjkWD5+fJ8IDM1OGhyMpnOlb9MwwgJdOxyrE4EktrVI+0x6rUsycwHjkFiYkZ6shw0q6cz7iYK+Xcrxj1HJinGf8LQkJCWL16NYcOHUKpVNK7d2/q169PuXJvPkcXL16Mh4cHzZs3Z9myZezYsYPJkyfr9X5Fosd1w4YNpKWlMXVq9r1t48aNw8/Pj19++SXfs/y+6ie2uHmzxc2br7vOo0TNcliX0o6fq9OvNY9O39CZx8jChMH7Z/Pw5HUOTtjw/7LRCrB1xY6MC6yGdBxF1dpV+KS0dgB+j4FdOXdK9wNZo1YzbdHEjB7WzwZ15dmD54QGhVGnSS2mLJiATCZDIpHQvocr1/76+4My3V3xEyfbenOyrTenO83DtlY5TEtr11f5ga15lc36Cjp3N9u6iBvPOFLHI+P1nn13Bv8jlz+40QqwbcXOjAushnYaQ9ValfmkdHEAug/swp+n/9KZR63WMHWRR0YPa49BXXn2ULusXOpU4csdi5jvsSRXjVaA1BvXUFSqjKy4No9Rpy6kXsqaR2Ztg/msuUjMLQAwaNUWla9PnjZaATZ8uS3jYqq+bsOoVrsqn5b+BIBeg7pz9qTuBYdqtZqZi6dk9LD2HtyDJw+eERKkHf5Qs1417t16oNPg1UfD0g7ceRWFX6S2wXLwbx9aVHDKUtOkrAOBMYk8CIoC4IZ/OEiguKUJbSsW5/yzEKITtR/+Zx8HUqWYpV5Zjqzex0I3Txa6ebK0mzdlapTHvpR2W2nez5Vbv17TmcfS3pKR6ydhamUGQIOuTXj1xD/PGoiFMRPA3lU/MNVtElPdJjGzqycVajrjVEq73lz7deDa6Ss681jZWzF1gydmr3M169qcl4/9iY+Oo12/DvR+faGWha0lbfq04/zhc3plS7jwN0Y1KqIoWUz7vn3ciDtz+b3nT37w/M0FW3IZpq3rk3RLv1PzP6z6nskdPJjcwYPp7lNxrumMUyltrvb93bh6WjeXZ5cpeLQdx+QOHiwcNJ/U5FQmd/DI80YrQNqta8grVEbqpD1WKV27kHYt67FKamWN6ZS5SMy0xypl0zaoXvqgiY8l7dI5FA1bgFKpnVavCenPH+d5zrym0ajy5S82NpaAgACdv3/rHb148SINGjTA0tISY2Nj2rVrx8mTJ7PUqNVqEhK0d4BJSkrC0NBQ7/9/oe9x/euvvzhw4AA//fQTcnn2cZVKJUuXLmXAgAFYW+fNlabvIyEilsOeW/l880RkSjlRfqH8b/JmAIq5lKbL8hFscfOmzoA2WBSzpVK7OlRq9+ZK0119l5CUhwfjwiQqIpqFk5ayfPsiFEo5Ab6BzPP4AoBK1Z2ZvXIG/doO5fljH1bMXsPq3cuQyqSEBobhPXY+ALs2fM/UhR78cOYbNGo1t67eZcOSrXpnSomI5fLkrTTZNhGpUk68byiXJ2rXl3W10tT7agQn23q/sy4/REVEs2jyMpZtW4hcqeCV7yvmT9SOXa1UzZlZX3nSv+1wXjz2YeXstXy1aylSmYzQoDBmj10IwMhpQ1/fEmsk42dpr6oN9A9m+rDZH5xHEx1N3MplmM9ZqL0dVuAr4r5cgryCM2ZTPIkaPZy0e3dI/GEPlivXgFqFKiKCmPmz8myZZCcyPIrZExexZsdS5Ao5L/1eZdwRoEr1iixcNYserQfw7NELlnh/xcbvvkIqlRISFIrn6DkZr1Oy9Ke8eqlfb9jbrE0MWNCpFp6HrpCmUlPCyoQvOtfhflAUC47dZP/wVtiaGrL6swYsOXWbpNR0lHIZq3rUx0Auo3l5J0Jikxi25zwaDThZGDOvY81/f+N/ERcRyzeemxi9eSpyhZwwvxB2TNkAQEmXMgxaPoaFbp48vfaIYxsPMW3vfNQqNdEhkWwaseJfXv3/TyaAmIgYNniuxXOzF3KlnGC/YNZNXg1AWZdyjF0+nqluk3h47QEHNxxg0b4lqNJVRIZGsmykdj/9adNBJq6ezJrT60EiYd+aH/W+zZMqMoagmaspvt4biUJOmn8wgdNXYli1PI6LPfB1n/DO+UOWbMNhzhhKn9wKKjUJl24Rsf2AXlkyi4mIYd20tczYMhO5Qk6wfxBrJq0CoFy1coxbrm3gfkya2GgSNi7HZNoC7e2wggNJXL8EWVlnjMd4EjdtOOkP75L003eYLVyDRqVCExVOwnLtcTHl1GEkpuaYf7kNpFJUPk9J3LLpo/4fCpNdu3axYcMGnefHjx/PhAk5b3ehoaHY2b25g4y9vT137tzJUuPl5cWQIUNYsmQJRkZG7N+v//UFEk3my18LoYEDB/Ls2bMsCwWgd+/e3L59m2XLlmU8t3r1ao4ePcrZs7oD1t/H/JK6t2YpaLNuLCroCDoauujeKqagTZV8WtARsrWavLuIJK8cq1LQCXS1uJP73s/8cP1L/W+/ll885j3/9yIBgAjN+51e/5iWGOg39jU/zUgunCdfv61b+Dp2rH76o6AjkPTHznx53bRan2Xbu2pubo65uXmO823ZsoWkpKSMU/8HDhzg7t27LFyo7VhJTk6mR48eLF26lGrVqvHNN99w6dIltm3bplfOQt/junv37hyn9enTJ8vjyZMn6z1mQhAEQRAEodDLp3uu/lsDNScODg5cv34943FoaCj29vYZj588eYKBgQHVqlUDoFevXqxdu1bvnIXza5YgCIIgCIJQ6DVq1IhLly4RGRlJUlISp0+fplmzZhnTS5YsSXBwMC9eaC9CPnPmDC4uLnq/X6HvcRUEQRAEQRBeK2Q/FuDg4MDkyZMZOHAgaWlpfPbZZ1SrVo0RI0bg4eGBi4sLS5cuZdKkSWg0GmxsbFiyZIne7ycaroIgCIIgCILeOnfuTOfOnbM8t337m/vVN2/enObNdX+RTh+i4SoIgiAIglBU5NMY16JCjHEVBEEQBEEQigTR4yoIgiAIglBUFLIxrh+baLgKgiAIgiAUFWKogCAIgiAIgiAUfqLHVRAEQRAEoaj4jw8VED2ugiAIgiAIQpEgelwzmdwqpKAj6GjoMqigI+i4dHdXQUfQ8VeVGQUdIVvndvcs6Ag6+o08XdARdFxfXLugI2TLYez+go6gI3hZ+4KOoENS4tOCjpCtlP2nCjqCjrEXLQs6go4fPZ0KOkK22i97XNARdPxZ0AFA9LgWdABBEARBEARBeB+ix1UQBEEQBKGo+I/fVUA0XAVBEARBEIoKMVRAEARBEARBEAo/0eMqCIIgCIJQVPzHhwqIHldBEARBEAShSBA9roIgCIIgCEWFGOMqCIIgCIIgCIWf6HEVBEEQBEEoKv7jY1xFw1UQBEEQBKGoEEMFBEEQBEEQBKHwEz2uH0herT6Gnw0DuQJ1wAsSd34FyYnZ19ZshPGIGcSOdc86wcgE05mrSdq5EpXvkzzJ1bh1Q8Z7j0KpVPD04XMWTVlGQrxurknzxtGmc0tiomIB8Hvuj/fo+cgVcqYvnkSN+tUBuHj2MusWbUadj9/sNBoNsxevolyZkgzp+1m+vc8/rNvUosysvkiVCuIf+PF48mZU8UnvXVNssCtO/VojNVQSf+cFjyZvRpOanutcf973Yf3RS6SmqyhfzJb5fVpjaqTMmH706kO++/1WxuP4pFRCo+M5tXAINubG7Dt/h/9dekBKWjqVPrFnfp/WKBWyXOeq3aoO/aYPRKGU4/fIj43T15H01vIC6DCoI+36dwCNhmC/YDZ7bSAmIgZTC1NGLR5DqcqlSUlK4eyB3zj+7TG98/z5PIT1fz4mVaWmvJ0Z89tXw9RAkaXmaVgsy87cJz4lHZlEwmxXFyo7WmSpWXH2Af5RCazvUVfvLG9r164l8xZ6YqBUcu/eI8aP9SIuLj5LTZ++3Rg3YVjGY3NzM4oXd6RihcaEhYYDULy4E2f++IlGDToSGRGVJ9nO+4az/tJz7XKzMWVe60qYKrMe+p+Gx7P8z8fEp6YjlUiY3bIile3N8+T9//Hno5esP3lDu507WTO/R2NMDTNt5zee8d2F+xmP45NTCY1J4NTMXpgYKlj682XuB4Sh1oDLJ3bM7NoAQ0XuP8LkNRtg1Hs4yBWo/F+QuG0FJGU9dipdu2LQ1h00GtQhgSRuX4kmNhokUoyGeCCvpD1upt26QvL3W3KdCaBGq9r0nt4fuVLBy0d+bJu+Idv9z3VQB9r0b49GAyF+wXzttYnYiBgA2gxoT8vebVAaGuBz9znbpm8gPQ+OWVB4tqsGreszyms4CgMFzx++YPnUlSRm89n3jybtGjNr7Qw6VOyS8dyQKQNp1aUFKpWaJ3efsnLGKlJT0vI0Z54SPa55z9nZGYCAgACcnZ3566+/skxv1aoVAQEBBAQEULVqVdzd3XF3d6ddu3Z4eHgQHh6eMX+rVq1yfH2A77//Hnd3d7p06YK7uzs///xzfvyXAJCYWWA0bBqJGxcQ7z0EdVgQhj2HZ1srdSiOYa9RIMm6iOXV6mE6dyNSp0/yLJeljSXz1sxk+vDZ9Gjaj1d+gYyfNTrb2mp1quI9ej792g6lX9uheI+eD0CvoT2wtLGkV4uB9Gk1mGp1qtK2S8s8y/i2577+DPOYyamz5/PtPTJT2JhTce1Y7g9dydXGE0n2C6HM7H7vXWPrVo/iwzpwu+cirjWbgtRQySejOuU6V2RcEvO+P8PKoW4cnj2AEjbmrD16MUtN53qV2D+jD/tn9OH7aZ9ja26MV8/m2Jgbc+b2M/b+eYet47ry08x+pKSls+ePm7nOZW5tzvgVHqwYvZQJrcYS4h/MAK9BOnVlqpbFfURXvLtPZ5LrBIJ8A+kzVbvMhswdTlJiMhPbjMerqyc1W9Smdqs6euWJTExh3sk7rOxam8PDW1DC0pi1fz7KUpOUpmLMgasMrleWfYOaMqJhObyPZV0Wpx4FcvzBK70y5MTG1ppNW5czoO9Yatdsg6/vSxYsnK5T9+MP/6NJw040adiJFk27EhoSxrQp8zMarX36duPkr/soVswxz7JFJqUy78wDVnRw4ef+DSlhYcS6i8+y1CSlqRh75CaDapVkb+/6jKhbmlmn7+fwinrmiE9m3oELrOzfksPTelDC2pS1J29kqelcuxz7J7qzf6I734/vjK2ZEV7uDbAxM+Lrs7dRqdXsn9iVA5PcSUlPZ+fvd3KdS2JmgfGo6SSsnkfc1EGoQ4Mw6jMyS42sdAUMO/Uibu544qYPRRUcgGHPoQAom7ZFWuwT4qYPI85rOPJK1VHUb57rXGbW5oxaMYE1o79kWqvxhPgH09trgE5d6apl6DiiK/O6z2SG60SCfQPpObUPAHXbN6Dd4I4s6Tuf6W08UBoq6TCsi85r6KOwbFcW1hbMXOXJnJHz6d9sMEF+QYzyzv4zGaBE6eKMnTMKifTN53KNhtVp5d6SYe1HM7j1cIxNjek+pFue5hTyVr4PFVAoFMyZM4f4+Phsp9vb23P48GEOHz7MyZMnKVmyJB4eHu/12rdv3+bAgQPs27ePI0eOsHPnTtasWcOjR4/+fWY9yKvURuXzBHWI9oMv5exRlA1a6xYqDTAa4UXyXt1v3so23Uj6ejma6Ig8y9WgeV0e3HrES58AAA7u+pkO3dvq1CmUCpyrlqf/mN788Ns3fPn1IhyK2wPw/dZ9zBw1D41Gg4WVOWYWpsREx+VZxrft/ekXunZsS7tWTfPtPTKzalGNuJvPSfIJBiBw12kcejR97xrHz5sTsOUo6dHxoNHwZPp2gg/8metclx75U+VTe0raWwLQs4kLJ64/RqPRZFv/7W9/Y21qxGeNqwJw9OojBrSsiYWJIVKphFmft6Rj3Yq5zlWjWU2e3XlKkG8QACf3nKCpu+4H8ot7zxnXYjSJcYkoDBRYO9gQF6Xdbsq6lOXcod9Rq9Wkp6Vz4+x1Gro11ivPJd9wqjhaUNLKBICeNUpy4kFgluV0yTeMEpbGNC2j3aZblHPgy8613mSNiGPX1ReMbFROrww5ad26KX/fuMvz574A7Ni+h5693N85z+QpowgLi+CbnT8C4OhoT8dOrnzWfWieZrvsH0kVe3NKWhoD0LNqcU48Cc6y3C6/jKSEhRFNS9kC0KK0LcvbV83THJeevqJKCVtK2mp7v3vWr8iJm89z3s7/uIO1iSGf1dduy7VKOzKiVXWkUgkyqRTnYjYERmf/mfIh5NXqonrxGHWw9pie+uthlI2zHtNVPk+IndwfkhJAoUBqbYsmXnvGCqkMiYERKBQgVyCRK9CkpeY6V7VmNXhx5ynBr/e/3/acpLF7M506n3svmNJiLEmZ9r/41/tf0+4tOLb9MAkx8Wg0GnZ4b+HCoT9ynQ0Kz3ZVr3kdHt1+TICPdv39vPsIbbtl85kMGBgaMHvdTDYu2JzlealMitJAiYGhAXKFHKWBktSU3K/DfKXR5M9fEZHvDVd7e3saNWrE8uXL/7VWIpEwYcIEnj59+l6Nz7CwMDQaDUlJ2tMnNjY2rFu3Disrq1znzo7U2h51ZGjGY01UGBJjEzA0zlJnNGgSqeeOoXr5Quc1ElfNRPX8YZ7mcihmT0hgSMbj0KAwTM1NMTHNmsvOwZbrf/3NxiVb6dtmCHdvPGDVN0szpqvSVYz3HsXPl/cSGRbFzSu38zRnZrOmjqVL++wPMPnBsJgtKYHhGY9TAiOQmxsjMzV6rxqjMsVQ2FpQ7cdZ1Pl9JaWm9SQ9NiHXuUKi43C0Mst47GBpSnxyKgnJuqepouKT2H32Jp6ZGtz+odFExicydtNhei77gS0nrmBuZJDrXDZOtoRnWhYRQeGYmJtglGl5/UOVrqKea322X/6GyvWrcPbAbwA8ufWE5t1bIpPLMDQ2pGGHRljZ67dvhsQl4Wj25r0dzAyJT00nIdNpT7/IBGxNDJh/8jZ9d19g9P4rqF4fjBNT05l97DYLO1THWJm3I6SKl3AiICAo4/GrV8FYWJhhZmaabb21jRXjPYbjNX1RxnPBwaH07zuGx4+eZTuPvoLjk3EwNcx4bG9qQHyqioQ0VcZzftGJ2BgrmX/mAX33XWX04Zuo1Hn7IRYSk4CjpUnGYwcLE+JT0kjI5nRsVEIyu8/fx7Nz/YznGlUoTkk7baM3MCqeHy7cx9WldK5zSW3sUEe8OaarI8OQGJuCUdZjJyoVijqNMd94AHnFaqSeOwFA6rmTaBLiMN94AIvNP6EKfkX635dyncvayZaIwDedG5FBERi/Y/+r41qPDZe/pmL9ypw7cBYAxzLFsLCxYMauOSw7uZoek3uTmAfHLCg825V9MTtCA8MyHoe9/uwzfuuzD2Dal5M5sucXnj/M+rn894WbXP/zBgeu/sjPNw9gamHKkT2/5GlOIW99lIuzvLy8uHDhgs6QgewolUpKlizJixe6jb63NWvWjOLFi9O0aVP69+/P+vXrsbS0xMHBIS9i65JIsn8+03gTZcsuoFKRdv5k/mTIhlSa/WpUqbKOgwl8GcTE/tPxe/4SgO82/0jxUsUp9olTRs2GJVtpWdGNwJfBzFw2Nf9Cf2zS7NedJvNYoXfUSBQyrJpX4/6IVdxw9UJuZUqZmX1yHUudw7dcWTZZfrp4jxYupSlu82bMZppazeVHL/lySAd+mNaL2MRk1v+S+w/OnLYptSr7sVVXT19hcM3+7Fv9I3O+W4BEIuHbL3aCRsNXx9cwY5s3t8/fIj1Nv/F1OX3eyTLtk+lqNRdehNKj2qf8MLAJvWuVYvzBa6Smq5h/8g69a5WinJ1Z9i+UC1JJTvufKtvnhwzpw/Fjv+LnF5DnWd6WUyfK28vtL78IelQpzg+96tG72idM+OU2qTmsa3180HZ+9TEtKn9KcWvddfUgIJyhW47Tq1ElmlXKg+FWOay77MYQpl3/i9iRXUn+aRcmXl+CRIJhj0FoYqOJHd2dmHGfIzE1w6Bjz1zHkuZwLMpp/7t++iqjag7ip9X78PpuLhKJBLlcRtWm1Vk3biWzOntiamHK5579sp3/QxWW7UrynseproO6oEpXcXyf7ueyW6/2OH3qSLeaPelW63OC/IMYNzf7oXaFhlqdP39FxEdpuJqamrJo0aJ3DhnITCKRYGhomO2Hp0ajQfJ651AqlWzatIljx47RoUMH7t+/T5cuXbh161Ze/xcAUEeGIrW0eZPTyhZ1fCykJmc8p2jiiqy0M6YLtmAyeQkolZgu2IIk03x5YZTnML7/dSff/7oT976dsLV/8/p2TrbERMWSnJScZZ5ylcri9lm7LM9JJBLS09OpXteFT8toPwhU6Sp+2Xecii4V8jRzQUoJCEfp8Ka3T+lkTVpUPOrElPeqSQ2OIvz4VVTxSWjS0gk5eB7zOrlfPk5WZoTHvOkFCY2Jx9zYAKO3LjoCOP33U9zrV87ynL25Ca2ql8XUSIlCLsOtrjN3fIP1ytJ7Sl++Or6Gr46voXXvtljZW2dMs3G0IS46jpSklCzzOJZ0omKdShmPz+7/DbvidphYmGJsasTuJd8yyXUCC/rPRaNWZ5z6/FBOZoaEJ7x579C4ZMwNFRhl6j21MzWklLUpLsW067BleUfUGg33gmO4GRDJnus+fP7teTZfeMLNgEjGHbyqVxaAWbMnceHSL1y49AsDB3+Oo6NdxrRixRyIiowmMVH3QhqA7p91ZM93B/V+7w/haGZAeKZtPDQ+BXMDOUaZLt6zMzaglJUJLq8vYmtZxg6VWkNATPb59eFkaUp47JsLZkJjEzE3UmKkzGY7v+2De53yOs+fvP2C0TtO4dGhNsNbVs+TXOqIkKzHdGs77TE95c2xU+pQDJnzm1Pcqb+fQGrngMTEDEW9pqT+cQJU6ZCUQNqfp5BXrqlXls+m9GHJ8VUsOb6Klr3bYJnp7IS1ow3x2ex/DiUdcc60//2x/wy2r/e/qJAorp+8QlJ8Eqq0dC78fI7ytZzJCwW5XQ2dNpgdp7ey4/RWOvXpgE2m45Stoy2x2Xz2dejZjorVndlxeitffrcUA0MlO05vxcbBhmZuTfn10BmSEpJIS03j6PfHqNmoRq4yCvnro90Oq0mTJu81ZCA1NRUfHx/KlSuHubk5cXFZx1lGRERgYaHdEX7++WcuXbpEyZIl6devH1u2bGHQoEEcPnw4X/4P6fduICtTCalDcQCULTuTfjPrhTQJi8YTP2cE8fNGk7DaG1JTiZ83Ok/HtAJsXbEj4wKrIR1HUbV2FT4pXQKAHgO7cu7UBZ15NGo10xZNzOhh/WxQV549eE5oUBh1mtRiyoIJyGQyJBIJ7Xu4cu2vv/M0c0GKPHcb89rlMSqtvfCl2CBXwk9ee++asF8uYde5IdLXV0HbdqhL3M3nuc7VsOKn3PELxi80GoCDF+7RwqWMTl1sYjL+4TFUL5P1wp02Ncrx682nJKemo9Fo+P3OC6p8aq9Xlr2rfmCq2ySmuk1iZldPKtR0xqmUdltx7deBa6ev6MxjZW/F1A2emL0e7tCsa3NePvYnPjqOdv060Pv1hVoWtpa06dOO84fP6ZWtYSk77gRG4RelbeQfvO1Pi3JZz6w0KW1HYGwSD4K1V1TfeBkBEqjiaMGvY9uwf3BT9g9uypgmFahZwpqNn9XTKwvA4i/WZFxo1bplD+rWq0nZsqUAGDq8H8eO/ZbtfJaW5pQpU5Irlz/OvtXwExvuBsfgF61tNB6894oWpe2y1DQuaaNdbqHacZs3XkUhkUBxc0Od19M7R/li3HkZhl+4dt0cvPKIFpU/1amLTUzBPyKO6iWzbsO/3vVl+ZErbB7WDrcaZfMsV/qd68jKV0LqqD2mG7TpTNr1rGcGJZY2mEyYi8RMezW8okkb1C990cTHovJ5iqJBC22hTIa8diPSnz3QK8vBVT/i7TYFb7cpzO3qRfmaFXB8vf+17teOG6d1v2hZ2lsxfsOUjP2vSddmGfvflRMXqd+xEQoD7TGrjmt9XtzJm6EoBbld7Vz5LcNcRzHMdRSjO0+gcq3KlCitXX/uAzpz4fRFnXlGdRrH4NbDGeY6iukDZpKSnMow11FEhETw5O5Tmrk1RSbTNoeadWjCg7/zdjhfnvuP97h+1NtheXl50blzZ8LCwrKdrlarWb9+PdWrV+fTT7UHtZIlS3Lq1CnatdP2FO7bt4+GDRsC2lNxX331Fdu2bcPa2pr09HR8fHxo2jR/LvjRxEWTtHMFxmPnglyOOjSIpK+XIytVAaMhU4ifVzCnF6Iiolk4aSnLty9CoZQT4BvIPI8vAKhU3ZnZK2fQr+1Qnj/2YcXsNazevQypTEpoYBjeY+cDsGvD90xd6MEPZ75Bo1Zz6+pdNizZWiD/n/yQFh7Lo4mbqLJjKhKFnGS/EB6O34BZ9TI4rxrD9daeOdYAvPrmNHJLU2qfXo5EJiXu7guezNuW61zWZsYs6NsGz53HSVOpKWFrwRf923LfP4QFP55l/wztcAT/sBjszE1QyLLe5urzpi7EJCbTd8VeVBoNlUrYMbVr7rf/mIgYNniuxXOzF3KlnGC/YNZNXg1AWZdyjF0+nqluk3h47QEHNxxg0b4lqNJVRIZGsmzkEgB+2nSQiasns+b0epBI2LfmR57p+cFpbWLAgg7V8Tx8Q7ucLE34wq0694OjWXDyLvsHN8XW1JDVXWuz5Ld7JKWlo5RJWeVeGwN57m8N9i7hYRGMHT2d3d9vRKlQ4OPjz6gR2mE2NWu6sH7TUpo01N6BokyZUoQEh5Kenje3JPo31sZK5reujOeJu6Sr1ZQwN2JR2yrcD4ll4e8P2de7PrYmBqxyq8bSc49JSlOhlEn5qkO1PF1u1qZGLPisCZ57fteuPxszvvi8GfcDwlnw01/sn6i9mM0/IhY7cyMUsqx9KutOXgc0LPjpTaOyRkl7vLs2zFUuTWw0iVu+xGTSAu0xPSSQxE1LkZWpgPEIT+JmjkD1+C7JP+/BdM4aUKlQR4WT8NVsAJK+24jRYA/MVu4CjZr0e3+TcuTHXGUCiI2IYavneiZu9kSuVBDiF8zmyWsBKO1SlhHLx+HtNoXH1x5yeMNBZu/7AlW6iujQSFaNXAbAr7tPYmphyuJjK5FKpfjee8GOL77JdTYoPNtVdEQ0y6Z8ycJt81Ao5LzyC2LxRO3/37laBaavnMow11HvfI09679n3Lwx7P7jG9JSUnn24AWrZ63Ls4z54j/+y1kSTU6XdeaCs7Mzjx8/JiAggIEDB3L27NmMaRcuXGDYsGGcOXMGgPbt21O2rPYbtFqtplKlSnh7e2NpaQmAj48P8+fPJyoqirS0NJydnZk7dy7W1trTA19//TUHDhzIGFbQsWNHxo0blzGc4EPEDGmTm/92vmh9MuXfiz6yS3d3FXQEHX9VmVHQEbJVf3fub42T1/qNPF3QEXR8Pydvr/TPKw4Tfy7oCDqCl7Uv6Ag6JCV0e08Lg5T9pwo6go6xFy0LOoKOr6c5/XtRAWi/7HFBR9Dx56szBR2BpD2z8uV1jfovzpfXzWv50uP6+LF2YytRokSWRitohwz8Mx3g3r1773yt0qVLs2tXzg2l4cOHM3x4zvdtEwRBEARB+H+jCJ3Wzw/iJ18FQRAEQRCEIkH85KsgCIIgCEJRUYR+LCA/iB5XQRAEQRAEoUgQPa6CIAiCIAhFxX98jKtouAqCIAiCIBQV//GGqxgqIAiCIAiCIBQJosdVEARBEAShqPiP/wCB6HEVBEEQBEEQigTR4yoIgiAIglBEaNTidliCIAiCIAiCUOhJNJr/+J1sM9ldvH9BR9ChKISrx0mVWtARstX4/vKCjqDjmotnQUcQcuGO3KigI+iwTyt849tSpJKCjpCtCFnhy1UpNa2gI+gIlikKOkK2aptGFnQEHRWfHC/oCCRumZgvr2s8em2+vG5eE0MFhP8XCmOjVRAEQRDynLg4SxAEQRAEQRAKP9FwFQRBEARBKCrUmvz5y4WjR4/i5uZG27Zt+f7773Wmv3jxggEDBtClSxeGDRtGTEyM3u8lGq6CIAiCIAiCXkJCQli9ejU//PADhw8fZt++fTx79ixjukajYcyYMYwYMYIjR45QqVIltm3bpvf7iTGugiAIgiAIRUU+/eRrbGwssbGxOs+bm5tjbm6e43wXL16kQYMGWFpaAtCuXTtOnjzJ+PHjAbh//z7GxsY0a9YMgNGjR2f7Pu9LNFwFQRAEQRD+43bt2sWGDRt0nh8/fjwTJkzIcb7Q0FDs7OwyHtvb23Pnzp2Mx/7+/tja2jJjxgwePHhAhQoVmDNnjt45RcNVEARBEAShqMinHtdBQwbRrVs3neff1dsK2qEAb5NI3tyKLj09natXr7Jnzx5cXFxYs2YNy5YtY9myZXrlFA1XQRAEQRCEoiKf7u/+b0MCcuLg4MD169czHoeGhmJvb5/x2M7OjpIlS+Li4gJAp06d8PDw0DunuDhLEARBEARB0EujRo24dOkSkZGRJCUlcfr06YzxrAA1a9YkMjKSR48eAXD27FmqVKmi9/uJHldBEARBEISiIp+GCujLwcGByZMnM3DgQNLS0vjss8+oVq0aI0aMwMPDAxcXFzZu3Mjs2bNJSkrC0dGRL7/8Uu/3Ew1XQRAEQRAEQW+dO3emc+fOWZ7bvn17xr+rV6/OwYMH8+S9RMNVEARBEAShqMjljwUUdaLh+oGKt65BLa/PkRooiHroz6WpX5MWn/RBdc6D2lCuTwtkhgoi7/hycdp21KnpucpVrHUNqs/shdRATvSDl1yZup30bHK9T12TryeRFBLFjVm79M5j3aYWZWb1RapUEP/Aj8eTN6N6633eVVNssCtO/VojNVQSf+cFjyZvRpPLZfS+NBoNsxevolyZkgzp+1m+v59V61p86t0fqVJOwkM/nk/ZpLOscqqRW5pSZtlITKqUQpWUQujeswTvPCEyfaRM2fm0VQ3qe32OTKkg4qE/f3hmf4z4R8tVI4l8HMDtrcfzNIdjmxpU8e6NVCkn5uFL/p68Ldtjwr/VGRWzpsWxhZxpPZPUyLhcZSpsxymAkq1q0DDT+jrzL+ur9ev1dfP1+pIZKmj+xWAcqpcBiYSQW885N/tbVMlpemeyaVOTsrP6vD42+vNw8hadbf1dNU3vbyclODKj1m/TUUJ+uqB3nn8Ua12DGjM/R2agIOqBP5enfp3j+suprsfdTSQGR2XUPtx0DN//XdQ7k0mLuthNGYxEqSDlsQ/B3mtQJ2S//pyWTSbliR+ROw9pn5BKcZg7BuN62ouG4s9dI2z5Dr2zCB/HR7k4Kz4+ngULFtCpUyfc3d0ZMGAA9+/fJyAggFatWunUOzs7Z3n8+++/4+zszL1797I8/+jRIwYOHEiXLl3o2LEjs2bNIjExMd/+HwbWZjRaNYI/Rq7lcDNP4v1CqeXd64PqPu1QB+chbfm191KOtPRCZqig8ogOuc5Vf/VIzo9Yw7GmnsT7h1Ijh1z/VldpbCfs6jvrzPshFDbmVFw7lvtDV3K18USS/UIoM7vfe9fYutWj+LAO3O65iGvNpiA1VPLJqE65yvS+nvv6M8xjJqfOnv8o7ye3MafcmvE8Hr6Cm009SPELoeSs/u9dU2rBYFQJydxsPom7HWdi1aoWVm1qi0wfIVN2DK3NaPnVCE6PXMveFp7E+ofSYKbuvghgWa4YnffOpEyn+nmeQ2ljRq01o7g8bA2/NplGgl8IVWf3/uC6T3s2pdnheRg5Wec6U2E7ToF2fbX+agQnRq7l+xaexPiH0iiH9WVVrhhd986k3Fvrq84Ed6QyKT+6erPXdSZyQyW1x3XRO5PCxozKa8dwd+gqLjeeTJJfCOVm933vGuOyTqTHxHO19YyMv7xotBpYm9Fw9QjOj1jL0dfrpWYO6y+nOrOyTqRGJ3Ci7ayMv9w0WmVW5jgtncyrCYvxaT+StJfB2E0bolOnLPsJn+xailmHplmet3BvhbJ0CXw6jcWnyziM67lg1r6J3nk+Go06f/6KiHxvuKrVakaMGIGFhQU///wzhw8fZty4cYwYMYLo6Oj3eo1Dhw7Rrl079u7dm+X5yZMnM3nyZI4cOcLRo0eRy+WsXbs2H/4XWsWauxBx24c4nxAAHu8+Q+lujT6orsxnTXiw9QSp0Qmg0XDZ6xue5/Kg4tjchYhbL4h//X7Pdv1Gye6NP7jOvlFlnFpU49nuM7nKY9WiGnE3n5PkEwxA4K7TOPRo+t41jp83J2DLUdKj40Gj4cn07QQf+DNXmd7X3p9+oWvHtrRr1fTfi/OAZfPqxN96RrJPEADBu05h273pe9eYVitL2MFzoFajSUsn6rcb2HRqKDJ9hEzZ+aSZC6G3fYjx1e5jD747Q7muuscIgKqD2vBo/5+8+OVKnudwaF6N6FsvSHi9f/ns+o1PsjkmvKvO0MESp/a1udhP/4soMitsxymAT99aX/e+O0OFHNaXy6A2PNz/J8/eWl+BVx5xfd1h0GjQqDWE3fPFvLit3pmsW1QnNtOx8dWuX3Hs0eS9ayzqOqNRaah1aC71fv+S0lN6gFRCbjk1dyHi1pvPtae7zlCqu+6yeledXZ3yaNRqWh/wxu23JVSd3BVJLrKZNKlF8t0npPkFAhD94zHMu7TUqbPq14mYQ78Sd+KtDgmZFKmxIRKlQvunkKNJSdU7z0ej1uTPXxGR7w3XK1euEBoaioeHB3K5dmRCgwYNWLp0Ker3uDIuMjKSS5cuMX36dE6ePEl8fHzGtPDwcJKTkwGQSqWMHz+eDh1y13v5LibFbEgIjMh4nBgUidLcGIWp0XvXmZdxwtDWnNZ7ptP51yVUn9qdtJjc9RIbF7chMfDNaaF/3k/+Vq531Rk5WFJ74QAujt+EJpdXLBoWsyUlMDzjcUpgBHJzY2SZ8ryrxqhMMRS2FlT7cRZ1fl9JqWk9SY9NyFWm9zVr6li6tG/9Ud4LwODt5RAUgdzcJMuyeldN3N9PsfusORK5DKmxITYdG6BwsBKZPkKm7JgUsyE+074fHxSJQTbHCIALc3bz9NBfeZ4BtKf3E1+9yZEUGIkim2PCu+qSQ6K5MmwNcU9e5UmmwnacAjD9gPX155zdPM5mfb388x7RrxuQZsVtqDG8Pc+O6f9lxLCYDcmZMmV//My5RiKXEvnnHW72XsLf7vOxblmdT4bn/nNRu150P9eyX3/Z10lkUoL+vMfv/b7k1+5fUKxFNSoMddU7k9zJjrSgN/t8WnA4MjMTpCZZM4Us3Ezs4bM688cc+g1VTBzlzu+m3IU9pPkFEf/7Vb3zCB9HvjdcHzx4gIuLC1Jp1rdq3rw51tbWhIaG4u7unuUvs6NHj9K4cWNKlChB1apVOXz4cMa0mTNnMmbMGFxdXZkzZw7379+nRo0a+fefyeGboUalfu86qUJGsWZV+XP0eo65zcHA0pQaXj1zFSvzL1S8K1dOdRIJNNo8gb/nfUdyaHSusgA5//8zf9C8o0aikGHVvBr3R6zihqsXcitTyszsk/tchdH7bFPvqPFd8C1oNFT/dSUVd04n+s/buR8LLDLpLafeI51jRD6TSLM/tL/d2HvfujzJVNiOU+Tt+rJzKUX3n+Zw59tf8T1zS/9QuTx+Bu45y5NZ36JJTSc9NhH/Lb9g16Gu/nley+3606jUPP/hD27M+Q51ajppsYk83HqCTzrU0T/T+yyrd7Ad3xdVVCxPG/XjebOBSC1MsR6q+8tRhY1Grc6Xv6Ii3y/Okkql2f4c2D/s7e2zNEYh6xjXQ4cOMX78eADc3NzYs2cP/fppx0J2794dV1dXLl26xMWLF/Hy8qJz587MmjUrz/JXn9aDT1xrAaAwNSL60cuMacaOVqRExZOelJJlnoRXEdjVLJttXWJwFP4nrmcM/n9x6C+qTer6wblcPHtQ3LV2trmMHK1JiYpH9VauxFcR2NQqp1NnXqE4Jp/aUXO+djygoZ0FEpkUmYGCq9O+/uBsKQHhmNcqn/FY6WRNWlQ86sSU96pJDY4i/PjVjAsNQg6ep9TU/L9IqiCkvArHrOab5WDgZENaVBzqTOvuXTVKa1v8vvhOO6wCKD6uK8m+QSLTR8j0jzpTe1CqrfYYoTQ1IuLxm33RxNGK5GjdY0R+qDT9M5z+OVaZGRPz0D9jmqGTNalR8agS3z4mhGNVq+y/1umrMB6n6k3tQekc1pepnuurfJcGNF88mD/n7OLJz5c+aN63pQSEY5Hp/2+Qw/EzpxrHz5oS/8CP+Afa9S+RSNCkq/TKUs2zB8X/5fPv7fWX8CoCm1q6n3+qpBRK92hM1AN/oh++fh0JqPXMBpAWGIZhtTftBbmDLaroODTvuf7MXBsRsmgLpKWjTksn9n9nMGvfhMid/9M7k5D/8r3HtWrVqjx48ECn8bpq1SquXHn36ZQHDx7w5MkTFi9eTKtWrdi4cSNPnz7l5s2b+Pr6snHjRkxNTWnbti3z5s1j7969HDhwIE/z3175E7+4zuIX11mc6Dwf21rlMCvtAECFAa15efpvnXmCzt3Nsc7/2FVKdqqPzFABwKftahNx+8UH57q74idOtvXmZFtvTneah22tcpi+fr/yA1vz6vSNHHO9XRdx4xlH6nhkvN6z787gf+SyXo1WgMhztzGvXR6j0o4AFBvkSvjJa+9dE/bLJew6N0RqqATAtkNd4m4+1ytLYRfzxy1Ma1fAsLQTAA4DXYk6de29axwHuvKJp/ZiGoWtBfb92hB+KHcXlolMH+b6Vz9xsP0sDrafxSH3+TjULIdFKe0+Vrl/a3yzOUbkh4dfHuRsG2/OtvHmj45zsa5dHpPX+1eZga0JOqV7TAg9d/e96vRVGI9TV7/6iX3tZ7Gv/SwOus/HMdP6qtq/NT4fuL7KutWl6YIBHOm3PNeNVoCIc3ewyHRsLD6oLWEnr793jUnFTygz/XOQSpAaKigxtB0hh/W7AOrOip8yLqI61Snr51/5ga0JeI/Pv8x1FhVLUM2zBxKpBJmhAuchrvgdvqxXNoCEC39jVKMiipLFALDq40bcmfd/veQHz99csCWXYdq6Pkm3Humd56P5j49xzfce1zp16mBjY8OGDRsYO3YsMpmM8+fPc+jQITZu3PjOeQ8dOsTnn3/OggULMp7z8vJi3759eHt7s3v3bmrVqkXDhtqLLJ49e0alSpXy7f+SHBHLxSnbaL7NA6lCTrxfKBcmbgHAplppGq4czi+us95Z93jXbygtTel44gskMimRd325vvCHXOVKiYjl8uStNNk2EalSTrxvKJcnbgbAulpp6n01gpNtvd9Zl5fSwmN5NHETVXZMRaKQk+wXwsPxGzCrXgbnVWO43tozxxqAV9+cRm5pSu3Ty5HIpMTdfcGTedvyPGdhkBYRy7NJG3HePg2JUk6ybzDPPNZjUr0s5VaO4XbbaTnWAASsO0T5DROp8ftqkEh4+dV+4m/nrpEvMukvOSKWP6Zuo+1WD2QKObF+oZydrN337aqVpvmXwznYPu/OCOUkJTyWG5O2Uv/riUgVchL8Qrg+QbuvW1YvTa2vRnC2jfc76/I8UyE7TgEkRcRyZuo2OmzVHqtj/UL59fX6sq9WmpZfDmffv6yvhl69kEgktPxyeMZzQdef8Ods/W7TlRYey4OJm3HZMQWpQk6SXzD3x2/ErHoZKq0axdXWM3KsAfD56iDOS4fS4I+VSBQyQo9eJnCP7vjOD6VdL9tous0jY71cfP25Zl2tNPW/Gs6JtrPeWXd31f+ou3gQHc8uQyKX4f/LVZ7/8IfemVSRMQTNXE3x9d5IFHLS/IMJnL4Sw6rlcVzsga/7hHfOH7JkGw5zxlD65FZQqUm4dIuI7Xnb+SXkPYnmXefx80hkZCRLly7l3r17yOVyrKys8PLywtzcnIEDB3L2bNadytnZmbt379K0aVN2796dZejAo0eP6NWrF3/++Se+vr6sWLGCoKAgFAoFpUuXZu7cuTg5OemVc3fx/v9e9JEp8n/1fDAnVeG76rLx/eUFHSFb11w8CzqCkAt35LoX6RQ0+7TCNxYtJQ+uWs8PEbLCl6tSqv73d80vwTJFQUfIVm3TyH8v+sgqPsnb+y3rI+GL/GmrmMzeky+vm9c+yg8QWFtbs2LFimynvd1oBXj8+DFAtkMJKlasyO3btwHtT4jt2VM0FrQgCIIgCEKuFaHT+vnho/wAgSAIgiAIgiDklvjJV0EQBEEQhKKiCN26Kj+IHldBEARBEAShSBA9roIgCIIgCEWFGOMqCIIgCIIgCIWf6HEVBEEQBEEoKjT/7TGuouEqCIIgCIJQVIihAoIgCIIgCIJQ+IkeV0EQBEEQhCJC8x+/HZZouGbS1S20oCPoaHMspaAj6Di3u2dBR9CRfuM4Nwf/XtAxdNS9m/0vxhWk8XVmFHQEHWvW1i3oCNlq1nNtQUfQEbu6W0FH0CGxsCjoCNny/+Lvgo6gY7ZUWdARdOyabFnQEbL12arC95OvBf+Dr4JouAr/LxTGRqsgCIIg5DkxxlUQBEEQBEEQCj/R4yoIgiAIglBU/Md7XEXDVRAEQRAEoaj4j9/HVQwVEARBEARBEIoE0eMqCIIgCIJQVPzHhwqIHldBEARBEAShSBA9roIgCIIgCEWERvS4CoIgCIIgCELhJ3pcBUEQBEEQior/eI+raLgKgiAIgiAUFWpxOyxBEARBEARBKPREj+sHkLvUw6D7UJArUAf4kLRrFSQnZl9boxFGQz2J8+imfUIiwaD7MOTV6oFagzr0FcnfrUUTH5Mn2Rq3bsDYmSNRGih49uAFX0xdTkK8braJc8fSunMLYqNjAfB7/pJZoxcgkUgYP2sUjVs3QK3W8NIngKXTVxIdqV++P+/7sP7oJVLTVZQvZsv8Pq0xNVJmTD969SHf/X4r43F8Uiqh0fGcWjgEG3Nj9p2/w/8uPSAlLZ1Kn9gzv09rlAqZXlkys2pdi0+9+yNVykl46MfzKZtQxSe9V43c0pQyy0ZiUqUUqqQUQveeJXjniVxneh8ajYbZi1dRrkxJhvT97KO8Z2ZVW9ai2/S+yJUKXj3yY/eMzSS/tdwAWgxsT/P+rmg0GsL8Q9jjtYW4iNg8yfDnQ3/Wn7hOarqa8k5WzO/ZFFPDTNvUjad89+e9jMfxyamExiRwalYflHIZCw6exyc0Go0GOtcux5CW1fMkF4Bbh9Z88YUXBgYG3L37kBEjpxIXF5+lpn//z5g0cWTGYwtzM0qUcKJk6TqsX7eEsmVLZUwrXeoT/jx/mW7dh+iV57xPGOsvPiNVpaa8rSnzWlfB1CDr4f5peBzLzz0mPiUdqRRmt6pMZXvzjOlxKWkMO3ideW0qU8XBQq8cmf35NIj1Z+9pjwkOFszvXAdTA0XWTCExLDt1k/jkdGRSCbM71qKykxXLT97ihn9YRl1YXBK2pkYcGNU217lMmtfFbsoQJEoFKY99CJ61BnVC9sd1x6VTSHnqR9TOnwCQWpjiMG88hpXKok5MJuZ/vxK950iuMwHUalWbvtMHolAq8Hvky+bp60nKZp9rP8gN1/4d0Gg0hPgFs8VrI7ERMUilUoYtHEnlBlUB+Pv363y3+Fu980hLVUXZuBvI5KjDX5H6225ITc5So2j6GbLytSElAQB1VAipx7eDTI6iRS9kJZwhLQXVizukXf4FyP0p77qt6jJ4xmAUSgU+j3xY47km2+X0j4auDZm6eiqfVdEeR+UKOaMXjqZqPe1yuv77dXYu2Ym6MPdq/seHChRoj2tAQADOzs789ddfWZ5v1aoVAQEBJCQksGDBAtq2bUuXLl3o27cvly5dArQf5IMGDWL9+vUZ80VHR+Pq6sq9e/fIaxJTCwwHTyNp80IS5gxDHR6EYfdh2dZK7Yth2HMESN4sXkXjdshKlidh0TgSFoxCHRqIwecjs53/Q1laWzBntRdeI+bQs+kAXvkHMs57VLa11epUZdaYBfRvO5z+bYcza/QCALr0caOiSwUGtBtB39ZDCPB9xaR54/TKExmXxLzvz7ByqBuHZw+ghI05a49ezFLTuV4l9s/ow/4Zffh+2ufYmhvj1bM5NubGnLn9jL1/3mHruK78NLMfKWnp7Pnjpl5ZMpPbmFNuzXgeD1/BzaYepPiFUHJW//euKbVgMKqEZG42n8TdjjOxalULqza1c53r3zz39WeYx0xOnT2f7++VHVNrcwatGMvWMSuZ13oi4S9D6Dajn07dp1XL0HZkZ5b3mM3CdlMJ9Qmiy9TeeZIhMj6JefvPs3JAaw5P/4wSNmasPXEtS03n2uXZP7kb+yd343sPd2zNjPDq2ggbMyM2nb6BvYUJP03twfceXdh/+RG3/ULyJJutrTVfb1/F571GUqVqM3x8/Fiy2Funbs+eg9Sp60qduq40aOhGSEgYHhNnExoaTq/eIzOmjR7tSXR0LBM8ZumVJzIxlXm/3WdFx2r8PLAxJSyMWXfxaZaapDQVY3/+m0G1S7K3bwNG1C3DrFN3M6af9w2j/76r+EQl6JVBJ1NCCvOOXGflZw04PK49JSxNWHvmbpaapLR0xvxwnsENndk3sg0jmlbC+39XAZjRvgb7R7Zl/8i2rP68EUq5jEXudXOdS2ZlgeOSKbzy+AKfDiNIfRmM7VTdLwvKMp9Q4tulmLVvmuV5+5mjUCcm49NxFH69J2PStA4mLerlOpe5tTljV3iwcvQyJrYaS4h/MP28BurUlalals4jujK7+wymunoQ5BtI76l9AWjWvQXFyhZnqqsH09pPpHL9qjRwa6RfICNTDFwHkXJsK8m756GJDUfRuJtOmbRYWVJPbCf5+y9I/v4LbaMVUNTtgNTMhuQ9C0n+YQkSEwvk1ZvrlyUTc2tzJq+czOJRixnZciTB/sEM8cr5y16xUsUYNnsYEqkk47nOgzpjYW3BmDZjGOs6lkq1K9G0U9McX0MoeAU+VEChUDBnzhzi47P2Tmg0GkaPHo1CoeDYsWMcOXKE2bNn4+npyZUrV5BIJCxfvpwffviBO3fuoNFo8PLyom/fvlStWjXPc8qq1Ebl+xh1aCAAqX/8gqJ+K91CpQFGw7xI3r81y9PqQD+SD26H9DQAVH5PkFo75Em2+s3r8uDWI176vALgp12Had+9jU6dQqmgQtVy9B/dm+9/3cGy7QtxKG4PwIvHvqz7YjNpqdp8D28/xrGEfvkuPfKnyqf2lLS3BKBnExdOXH+MRpP9t8Rvf/sba1MjPmusXW9Hrz5iQMuaWJgYIpVKmPV5SzrWrahXlswsm1cn/tYzkn2CAAjedQrb7k3fu8a0WlnCDp4DtRpNWjpRv93AplPDXOf6N3t/+oWuHdvSrlXBHEwrN62G353nhPoGA3Buz2nqu+tm8b/3gjktPEiOS0RuoMDS0ZqEqLg8yXDpySuqfGJLSTttz1/PBpU4cfN5ztvUH7e121QD7XYzvUsDpnTUNijCYpNIS1dl6a3NjbZtm3P9+m2ePfMBYMvW3fTto/uhntl0z3GEhoWz/es9WZ5XKBTs3LmGKdPmERAQqFeey/4RVHGwoKSlCQA9XUpw4nFwlmV12T+CEhbGNC1lB0CLMnYs71AtY/reWy9Z2LYKdiYGemV426UXIVQpZkVJGzNtpjplOXHPP0umS89DKGFlQtPyTtpMFZz4skd9ndda+MsN+tcvT0VHy1znMm5ci+S7T0jz0y7r6L2/YN65pU6dZb9OxB76lbiTWb88GlYuR+yRM9oxh2npJJy7ilm7JrnOVa1ZTZ7feUawr/Y4dHrPSZq66zb0Xtx7jkeLMSTGJaIwUGDtYEPc631OKpNiYGSIXClHoVQgV8hJS0nTK4/s08qoQ/zQRIcCkH7nHPKKb60bmRyp3SfIa7ti2G82yo6jkJhZabPYf0r6k2ugSgc0pD+/hax8Lb2yZFarWS2e3H5CoK92/R377hgtu+quPwADQwM813qyfdH2LM//7+v/sWzcMjQaDeZW5piYmxAXnTfHrXyj1uTPXxFR4A1Xe3t7GjVqxPLly7M8f+3aNQIDA5k5cyZKpfYDpnLlyowZM4ZNmzYB4OjoyJw5c/D09GTnzp1oNBoGDx6cLzmlVnZoot6cqtJEhSExNgFD4yx1hv0nkvrnMVQBPlmeV714iNr/mfaBsSkGnfqTduPPPMnmUNye0MDQjMehQWGYmptiYpo1m52DDdf/usnGpdvo13YY9/5+wMpvlgBw98Z9Ht/V9sqYWZgybPJAzvzyh155QqLjcLQye5PP0pT45FQSknUPmlHxSew+exPPHm8aQv6h0UTGJzJ202F6LvuBLSeuYG6U+w9Qg2K2pASGZzxOCYpAbm6CzNTovWri/n6K3WfNkchlSI0NsenYAIWDVa5z/ZtZU8fSpX3rfH+fnFgVsyUy6M0yiQqKwMjcGMNMy+0f6nQV1V3rsvzSFsrXq8zFA7/nSYaQmAQcLUwzHjtYmBCfnEZCNh/EUQnJ7P7zHp5dGmQ8J5FIkMukeP/4B5+tOkSdMk6Ussv96W+AT0oU42WmRmZAQBAWFuaYmZlmW29jY8XkSSOZMnWezrShQ/oQFBjC4cMn9c4THJ+Mg+mb/cXe1ID41HQSUlUZz/lFJ2JjrGT+b/fpu/cyo3/+G1WmD66NXWtR3clS7wxvC4lNxNH8zfHIwdyI+JR0ElLT32SKjMfWxJD5R6/T9+szjP7+fJZMABeeBRESm0TfeuXzJJfCyZb04DfH9fTgcGRmJkhNsh47QxdtJvbIWZ35k+48xrxLa5DLkBgbYuraGLmdda5z2TrZEp7pOBQRFI6xuQlG2exzqnQVdV3rs+XyTirXr8LvB84A8MeBsyTExLP16jdsu/YtwX5B3DhzTWf+9yExs0IdF5nxWBMXhcTACJSGb2pMLFC/fETaX/8j+fsvUAf7YNB5rDZjsA/yCnVAYQBSGfKK9ZAY537/sytmR3imY1N4UDgmOSynCcsmcPz74/g89NGZpkpXMdhrMDvO7yA6PJr7V+/nOpuQfwq84Qrg5eXFhQsXsgwZiIyMpGrVqkgkkiy1devW5e7dN6eY3NzcqFy5Mlu2bGHp0qX5F1Iqyf75TONgFC06g1pF2l+ncnwZiZ0TJp5foXp2j7Tf82YslFSS/WpUqbKO0Ql8GczkATPwf/4SgD2b91K8ZDGKfeKYUVO8ZDG2HlrP7at3OfDN//TKo86hF0yWzTL86eI9WriUprjNm4NYmlrN5Ucv+XJIB36Y1ovYxGTW/3JJryxZ5LAONZmX0ztqfBd8CxoN1X9dScWd04n+8zaaTB+8/19JJdkvE7Uq+zFgt09fY2qtYfyyZj8eu2fr7MP6+KBt6sojWlQuSXFrM51pS/q04I95/YhJSmHrb7dynQtAKs1p/1Nl+/yI4f05cvQ0vr4vdaZNnDiCJUvX5ipPDosqy7JKV6v5yy+cHlVL8EPvBvSu9gkTjtwkNT1/xvXluP4ybRvpKjUXngXTo1Zpfhjemt51yzH+xwukpr9ZjnuuPGVIY+ds17teclh3GnX26+5tYcu3g0ZDqUMbKL5+DokXb6JJy/0xQZLD/y+nfe7a6SsMqzmA/at/ZPZ385FIJPSc1JvYyBhG1B7E6AZDMbU0o9MId30DZf98ps8/TWwEKYc3oInSDsFJv3EaiYUdEnMb0q+fQh0RiGGvGRh0n4w68AW85zJ+Z6z3PDZ1HNARVbqKX/f/muNrfbvsWz53+ZyQgBDGLdFvmNzHotFo8uWvqCgUDVdTU1MWLVqUZciARCLJ9sCflpa1hyUhIYGHDx+iVCq5fft2vmXURIQhsXjzTVpiaYsmITbL4HRlo7bISjljMnczxh5fgFKJydzNGfPJnKtj4rWWtEu/krxnXa7yjPQcyp5fv2bPr1/j3rcjNg42GdPsHG2JiYolOSnrwPlylcrQoYdrluckEgnprz8YajeqyY6jmzh24CTLvFbpnc3JyozwmDdj40Jj4jE3NsDorQsxAE7//RT3+pWzPGdvbkKr6mUxNVKikMtwq+vMndenqXMj5VU4Svs3PaQGTjakRcWhTkp5rxqZmTF+X3zHrZaTedB7Iag1JL8+lff/TefJvZh9fAWzj6+gce/WWGRaJpaO1iREx5OaabkB2JV0pGydN0M6/tr/OzbF7TC2MMl1HidLU8Lj3lwwExqbgLmREiNlNtvUbR/c62Ttkbv4OIDQ19uksYGC9jXK8OhVuM6872v+vGlcv3aa69dOM3RIH5yc7DOmFS/uSGRkFImJ2V8g0rNnF3bt2qfzfI0aVZDLZJz7M3df0hzNDAlPSM14HBqfgrmBHKNMFzfamRhQysoEF0ftF8aWZe1RqTUExGZ/UVJuOZkbE57pgpnQ2CTMDRUYKd9cMGZnZkQpWzNcimuPZS2di6HWaAh4Pc42MiGFe68ica1UIs9ypQeGIsvUQyp3sEUVHYfmrW07J1JTY8JW7sC3yxgChs0CtYZUP/2GePSa0pcVx1ez4vhqWvdui1Wmfc7a0Yb46DhS3srlWNKRinUqZTz+ff8Z7IrbYWJhSr32DTi7/wzpaekkxiVy7uBZqjZ00SubJi4SicmbzgWJqSWa5ARIf7OdSWyLI3t7+IBEom2gGpqQduNXkvcsJOXgSjTJ8aijQ9FH/yn9WX9iPetPrKddn3ZZlpOtoy1x2SynNj3bUL56edafWM/CXQtRGipZf2I91g7WVK5TmeKliwPantffDvxGuarl9Mr20YihAoVDkyZNsgwZqF69Ovfu3dNpqN66dQsXlzc738KFC2nSpAkrVqxg9uzZRERE5Eu+9Ac3kJWphNS+GADK5p1Iu5X1AyZhiQcJ80eSsHAMietmQ2oqCQvHoImJRFa2MsZj55G080tSTx/MdZ5tK3ZmXGA1tNMYqtaqzCevd77uA7vw5+m/dOZRqzVMXeSR0cPaY1BXnj18TmhQGC51qvDljkXM91jC91t0P1Q/RMOKn3LHLxi/0GgADl64RwuXMjp1sYnJ+IfHUL2MY5bn29Qox683n5Kcmo5Go+H3Oy+o8qm9zvwfKuaPW5jWroBhae0YOoeBrkSduvbeNY4DXfnEU3uxkcLWAvt+bQg/VDAXTOW3o6v38YWbJ1+4ebK8mzdlapTHvpR2PTXr58rtX3VPOVrYWzJi/SRMXg8Tqd+1Ca+e+JMQHa9T+6EaVijOHf9Q/MK0d7k4ePkRLaqU1KmLTUzBPzyW6qWyjs8+fceHrb/dRKPRkJqu4vRtH+qWLaZ3nvkLVmZcTNW4aWfq16tFuXKlARg1cgBHjp7Odj5LSwvKlS3FxUvXdaY1a9qQ3//Q3W8/VMNPbbgbHINftLbBd/BuAC3KZN1/Gpe0JTA2iQeh2js+3HgVhUQCxc11T7HmhYZlHbjzKhK/CO3YwYM3XtDCOevyb1LOkcDoBB4ERWkz+YUBEopbab/43HoZTpVi1lkau7mV8NffGFWviKKkNotlbzfiz77/FwfL3m7YegwAQGZjiUXP9sTpOcRq36of8HSbjKfbZLy7Tqd8TWccS2mPQ6792nPt9FXd97e3ZtKGaZi93ueadG2O/2N/4qPj8Ln3gkYdG2uzyWXUaVuPJzcf65VN5fcAmWMZJJba7UherRmq5291FGk0KFv0QmJu87qmOerwADTx0cjKVEfZ+vWFsAoD5LXaoHqk+/95H3tW7WFChwlM6DCBKe5TqFizIsVKadefW383Lp++rDPP5C6TGdt2LBM6TGDuoLmkJqcyocMEIkMiqd6oOiPmjkAqkyKRSGjZrSW3L+ZfJ5iQe4XqdlheXl507tyZsLAwHB0dKVeuHEuWLMHb2xuFQsG9e/fYvHkzX331FQCHDx/mwYMHHDx4EAMDA9zc3PD29mbr1q3/8k4fThMXTfI3KzEaPUd7O6ywQJJ2rEBasjxGg6aQsHDMO+c36DIQkGDYYxj00N6NQB0eTNKmBbnOFhURzaLJy1i2baH2dkW+r5g/UTt2tVI1Z2Z95Un/tsN58diHlbPX8tWupUhlMkKDwpg9diEAI6cNfX1LrJGMn6W920GgfzDTh83+4DzWZsYs6NsGz53HSVOpKWFrwRf923LfP4QFP55l/4w+APiHxWBnboJClvU2V583dSEmMZm+K/ai0mioVMKOqV1zf2FSWkQszyZtxHn7NCRKOcm+wTzzWI9J9bKUWzmG222n5VgDELDuEOU3TKTG76tBIuHlV/uJv/0817kKu7iIWHZ5bmLk5qnIFXLC/EL4ZsoGAEq6lGHA8jF84ebJs2uPOL7xEFP3zketUhMdEsnmESvyJIO1qRELejbDc89Z0lQqSlib80Xv5tx/GcaCgxfYP1l7MZR/RCx25kYoZFm/k0/pVI/Fh/7is1WHtB9OVUrSr0mVPMkWFhbB8BFT2Ld3G0qlghfP/Rg8dCIAtWtVY+tWbSMXoFzZUgQFhZCerns6uVy50vj5BeQ6j7WxkvltK+N5/A7pKg0lLIxY5FqV+yExLDzzgH19G2JrYsCqTjVY+vtDktJUKGVSvupYHQN57m85l20mE0MWdK6D58HL2mOCtQlfuNfjfmAkC365wf6RbbE1NWT1541YcvzvjEyrejbMyOQfGU8xC+N/eacPo4qMIdh7NcXWzkKikJP2MoigGSsxqFoex0UT8es2/p3zR2zbj9PyaZQ6shkkEiI27CH53pNc54qNiGGT5zqmbp6BXCknxC+YDZPXAFDGpRxjlo/D020yj6494NCGA8zftxh1uorI0EhWjNQe+79duINhC0ew5sxG1Go1d/+6w+HNh/QLlBRHyq+7MOg4EmRyNNFhpJz6Bql9SZRtB5D8/RdoIgJJ/WMfBl3GgVSKJi6K1BNfA6C6/xcyx1IYDpgHEinp986jevZ3rpdTTEQMq6etxnuLN3KFnGD/YFZOWglA+Wrl8VjuwYQOE975Ggc2H2DkvJFsPLURjVrD/Wv3+XbZt7nOlq+KUO9ofpBoCnBgQ0BAAAMHDuTs2TeD3i9cuMCwYcM4c+YMtra2rF69mj/++AOZTIaFhQUeHh40bNgQPz8/evXqxbfffkvFitrTkykpKXTv3p1+/frRt2/fD84TO8L134s+sjbH3u+U1cd07pueBR1Bx83BeXMRUF6rezdvGm55aXydGQUdQceatbm/tVF+MOuZu/Gm+SF29bvvWFAQJBZ5c6FbXvP/IveNo7w2Oylv7maRl3ZNdvz3ogLw2SrdceAF7bj/8YKOQOyw3N+/ODvmO3IeA1yYFGiPa4kSJbI0WkE7ZODx4zenM2bOnMnMmTN15i1ZsiSXL2c9JWBgYMCxY8fyJ6wgCIIgCEIB0xTCHtejR4+yefNm0tLSGDx4MP366d7rG+CPP/5g4cKFOm2/D1GohgoIgiAIgiAIRUdISAirV6/m0KFDKJVKevfuTf369SlXLutFbuHh4Tq3PtVHobk4SxAEQRAEQfgX+XRXgdjYWAICAnT+YmPf/bPdFy9epEGDBlhaWmJsbEy7du04eVL3XtSzZ89m/Ph3jxt/H6LHVRAEQRAE4T9u165dbNiwQef58ePHM2FCzhe5hYaGYmdnl/HY3t6eO3fuZKnZvXs3lStXpnr16rnOKRqugiAIgiAIRUX+/E4IgwYNols33Ys/zc3N3zlfdtf4Z/5xiCdPnnD69Gm+/fZbgoNzf0920XAVBEEQBEEoIvLr4iwLc/N/baRmx8HBgevX39ybOjQ0FHv7N/eOPnnyJGFhYfTo0YO0tDRCQ0Pp27cvP/zwg145xRhXQRAEQRAEQS+NGjXi0qVLREZGkpSUxOnTp2nWrFnGdA8PD06dOsXhw4fZtm0b9vb2ejdaQTRcBUEQBEEQio5C9pOvDg4OTJ48mYEDB9K1a1c6depEtWrVGDFiBHfv3s3D/7iWGCogCIIgCIIg6K1z58507tw5y3Pbt2/Xqcvu/v0fSjRcBUEQBEEQiop8ujirqBAN10yW/2pb0BF0HKvyqqAj6Og38nRBR9ClhGmpioJOoaMw/rzqhuu5vwF0XptVZ1ZBR8jW4wpVCzqCjiUrIgs6go5IQgs6QraiNYYFHUGHt6bwtTpcvrhW0BGydW9T14KOIBRCouEq/L9QGButgiAIgpDXCuNPvn5MouEqCIIgCIJQVBS+TvuPStxVQBAEQRAEQSgSRI+rIAiCIAhCEfFfHyogelwFQRAEQRCEIkH0uAqCIAiCIBQVYoyrIAiCIAiCIBR+osdVEARBEAShiCiEtwL+qETDVRAEQRAEoaj4jzdcxVABQRAEQRAEoUgQPa6CIAiCIAhFxH99qIDocRUEQRAEQRCKBNHj+oGcW9bAdXpvZEo5wY9e8r8Z20iJT9Kpq961MU1HdQKNhtSkVI7N38Wruz5IJBJcZ/TGuVVNNGo1Eb7B/Oy9g8TIOL0zKes1wGTYSFAoUPm8IO6r5WgSE7PUGLp3w6iTO2g0qIICiVu9Ak10dMZ0qZ0dlus2EzVqGJrYGL2zZFa7VR36TR+IQinH75EfG6evIymbZdVhUEfa9e8AGg3BfsFs9tpATEQMphamjFo8hlKVS5OSlMLZA79x/Ntjucpk1boWn3r3R6qUk/DQj+dTNqF6K1NONXJLU8osG4lJlVKoklII3XuW4J0ncpUnO1Vb1qLb9L7IlQpePfJj94zNJGez3FoMbE/z/q5oNBrC/EPY47WFuIjYPM+TE41Gw+zFqyhXpiRD+n72Ud6zYsuadJjeG7lSTtAjfw7ksP/V7NqE5pn2vyPzdxFw90WWms5zBmBbypFvhq3IVSbjZvWwnjQEiUJB6hMfQueuRpOQdf8z7dQKyyE9QaNBk5xC+NJNpNx/mjFdamZCsV0rCZuzKsvzuVEh07Eq5F+OVU1eL6u0pFR+mb+LwLs+GdMNzY0Zvm8uh6ZvzfK8Pqq2rIl7pm17z4wt2W7b9bo2pc2ozmg0kJaUwv753+B/9wVypZye84fg3LAqKYnJ3P3tBsfWHECj0f+G7DVa1ab39P7IlQpePvJj2/QN2R6nXAd1oE3/9mg0EOIXzNdem4iN0B4r2wxoT8vebVAaGuBz9znbpm8gPTVd70zmrWpTbMZAJEoFSY988fdcjzqbTACffuVB8mN/Qrf9DIDUzJhPV0zAsGxxkEqJPHiW0M2H9M6SWYu2TfCcPQGlgYJH958yc+JC4uMTdOoqVCrHvGXTMTMzRa1WM3vqYu7dfpgx3czclL1Hd+A1cT53bz3UmV9ffz5+xfpfb5GarqK8oxXzuzbA1FCRMf3ozRd8d/FRxuP45FRCYxM55dkNG1OjPMuR70SPa+EUEBBA1apVcXd3x93dnc6dO9OqVSvWrVtHQEAAzs7OzJ07N8s8Dx8+xNnZmUOH8mYnfZuxtRndV4zihzFrWNN6GlEvQ2g3o7dOnW0ZJzp492XXwOX8H3t3HR3F9bBx/Lub3WzcjSQUd/fgmgCB4BSKuzskuLu7F1qkeGkptAWK1Ci0wK/FpUgSQtxdVt4/lm5YNqFlkzTk7f2ck3OYmTs7D3dnJnfu3Jls8Z3F95u/pM+OyQDU+bA5HtVKsbXjLDa3m0FMYAS+s/sZnUlia4v1tBkkLppL3JD+qMJCsRw6Uq+MrFx5LHr0In7iWOJGDEb1MgTLgUN1yxVt2mK3bjMmTs5G53iTjYMN41ZPYPWo5YxvNYaI4HD6zxhoUK501TJ0Ht6FWd0CmOQznrDAUD6a2heAwfOGkZaazsQ245jRxZ9aLepQp1VdozPJHG0ou2Ecj4at5vemE8gIiqDEG3X/tjIlFw5ClZLO780ncafDTOxb1ca+TR2j8+TEysGGgavHsHP0Gua3nkj0iwi6Tu9rUO6DqqXxHuHHyu5zWNR2KpHPw+g01XBfLChPA4MZOmEm5y799K9t09LBmg9Xj+TA6PWsbj2VmBeRtJ/+kUE559LF6DCrD3sGrGCD70wubf6C/q+Ov79U7+BFrS5N8pxJam+Ly+KpRExazAu/YWSFhOM4eYheGXlJTxynDiNs5GxCeowhbuchXDdkn7ssmtbD4/AmTEsVz3Me3We+OlcdHr2Bja2nEfsiAp9czlXtXp2rtr5xrgIo36Imo75cjFMZ9zxnsnKwpv/qMewavZaFrScR/SKSLtP7GJRzKV2MrrP6sWXAMpb7BvDt5pOM2DENgLZju+Lg4cySdtNY0XEGNi72NOvvY3QmawcbRq4ez4ZRq5jWahwRweH0ntHfoFypqqXpMLwL87vNZLrPRMIDQ+k5Vbvv1WvnRdtBHVjWZwEBbSZgamZK+6GdjM4kc7DhgzUTeD5yBQ9ajiEzOBz3GQMMyinKelL28GLsO+rvx8Wm9SUrLJqH3hN43HEqTv3aYVG7gtF5/uLgaMeqTQsYO3ga3l7deBH0Ev954w3KmZmbse/EVnZv3kenVn3YsnY363Ys0S1v0aYxX3x3gNLlSuY50+tiU9KZ/8VV1nzUlFOTOuFpb8XG737XK+NXqzTHxvpybKwvn41qh5O1OTM61itajVbh/W24Ari4uHDq1ClOnTrF6dOnOXz4MHv37iUjIwM7Ozt++uknVCqVrvw333yDg4NDgeUp17Q6L28/IyYwHIBfD16gRufGBuWUmVl8MX03SVHxALy88wwrZztM5CZE/PmSs8sOoXp1Nf7yzjPsPJ2MzmRapx5Zjx+ievkSgLTTp1C0bqOf58/HxA7qiyY1BeSmSJ2c0SRpe+akjo4oGjchYfZ0ozPkpGazWjy5/SdhgWEAnD34LU07Nzco9+zuU8a2GEVqUipyhRwHV0eS4rS9z2WqleGHk5dRq9Uos5TcvHSDhr6G9f1P2TWvQfIfT0h/rs0Uvu8cTt2a/uMyVtXLEHXiB1Cr0WQpibtwE8eODY3Ok5PKTasTdPspka/2sR8OnqdB56YG5YLvPmNuiwmkJ6UiU8ixc3MgJc74Xvt3deTzM3Tp4E3bVobZCkr5ptV5cfsZ0a/q5trB76iVy/F34rXj78WdZ1i/Ov4AXMq402KkHxc25f0C16JRbdLvPSIrOBSAxKNnsOrQSq+MJjOLqPkbUEXHApBx7zEyJ3uQaW942fbtQuTsNSgjY/Kc5y9vnqt++5tzVXIO5yoAr8Ft+XzaDpIi4/KcqVLTGgTdfkrUq0w/HjxPvRz2bWWmks+m7yDxVaagO0+xeZXpg6qluXn6CsqMLDQaDbfP/0YtXy+jM1VvVpNnt/8k/NV56sLBszTu3Myg3PO7z5jSYgxpr52nkl8db027teDr3adISUhGo9GwZ9YOfj75vdGZrJvVIvXWEzJeZYo+cBaHLobnTucBvsQcv0jcmZ/15r+cv5uXSz4BQOZij1QhR52UarD+u2rSsiG3/7hH4LMXAHz2yXE692hvUK5pCy+Cn4fw/YUrAFz49gfGD52hWz5w+Ef4j51PZHhUnjO97uqTMKp4OFLC0QaAnvXL8e2twFx74z/96R4Olmb0qFcuX3P8GzTqgvkpKorUUIGoqCg0Gg1xcXFYWlpSsWJFrl+/jpeX9sR15coVGjVqVGDbt3V3ICEs+5dLYlgsZjYWKKzM9W7BxYdEEx8SrZv2ndOPhxduospS8eJ/2bcBzWwsaTWhG799dtHoTFJnF9RRkbppdVQUUksrJBYW+sMFVCpMGzXBeoo/mqwsEvbt0ZaPiSFx4Vyjt58bx2JORIdm10FMWDSWNpaYW5kb3IZTKVXU92nAmJXjycrM4si6zwB4/MdjmndrycMbD5CbymnYvhHKLONvvyncnch4LVNGWAwyG0tMrMx1wwXeVibpf3/i3KM5SdcfIjGV49jBC7VSZbCdvLB3dyI2LHv7cWExmNtYYGZlbnBLVa1UUcOnHgNWjCIrU8npdUfzNcvbzJ46BoBfb/zxr23T1t1R7/hLCIvFPIfjLy4kmrjXjj+/Of25/+r4M7VQ0Hv9WI5O245n9dJ5ziRzc0YZnr0tZUQUJtaWSCwtdMMFlKERKEMjdGUcA0aScvkaKLX7ctio2XnO8SZjz1XtXztXAewfuDLfMtm7OxL3Wqb4XPbt2JAoYkOyGzU95gzk9oUbqLJUBP7xhDodG/H7N9dQZimp27kJts72RmdyKOZETGh2ptiwGCzecp6q61Of4SvHkpWZxYl1hwFwK+2O7S1bpu+bi72rAw+vP+Dwsn1GZzJ1dyLrtXNAZlg0JjaWSK3M9YYLhMzbBYB14+qGH6JSU2LDZOx8G5Fw7hrpT18anecvxdxdCXuZvR+Hh0ZibWONlZWl3nCBUmVLEBUZw/IN86hUtTyJCUmsXLhRt3xwr3F5zpKTiIRU3GwtdNOuNhYkZ2SRkqHUGy4AEJeSzv4rDzkyxrDhXRQUpUZmQXive1wjIyPp3Lkz7dq1o0GDBmzYsIEtW7bg5uYGQPv27Tl37hwAt2/fpkKFCsjl8rd9ZJ5IJDlXl1qV814kN1fQe+tEHEq68sWM3XrLHD5wYfixuQTdeMS1/eeNzyTNOZNGbZgp85efienRmdT9n2K7fA1IJEZv9+9Ic8mVW139dv5XBtXqx9H1h5l7YCESiYRPl+wFjYa132xg+q5Z3Prpjzw1XJHm/P/VvJ7pLWUCF34KGg01vltDxb0BxP94C00exrHlHDHn7edWb7fOX2dq7aGc2XCMCfvnICnA77Sw5fZ/e9vx12/rRBxLunJihvaXfM9VI7my7xwRj0PyJ1Qu+zlqwwsaibkC17WzkRd3J2r++vzZfi6MPVc5lnTlyzfOVYWVydRcwbCtk3Eu6cpnM3YAcH7Hl4Q9DmHayaVMODiXZzcf5+mcIM3leM8t043zvzGy1kA+X3+UGQfmIZFIkMlMqNq0BpvGrmG2nz9WtlZ86G84vOcfy+0YziVTboImredOzf6Y2FnjNqmX8Xleye2crnpjX5fJZLRo05gj+0/SpU0/9n98hD2HN2FqWnC/mwHUufSsmuTwHX9+4wktKnniYW9VoJmEgvFe97j+NVRArVazYsUKHj16hJeXFxER2qu+li1bsmHDBtRqNd9++y3t27fnm2++ydcMrSf3oJJ3bQAUVhZEPArWLbNxcyA1PpmstAyD9WzdHem/ZxpRT0LZ03sJyows3bJSDSvTe/N4ftp5hp935+1hI1VkBLKKlXTTUicn1ImJkJ6ePc/dA6m9A8p7dwBIP/cNVhOnILGy1g0ZyA+9p/ShXpv6AJhbWxD8MEi3zNHNkaT4JDLeqCu3EsWwc7bj4Q3tAP1Lxy4wctloLG2tMLNQsH/ZpyQnJAPQdVQ33S09Y2S8jMa6VvZtIUUxR7LiklC/lultZUwdnAhacgBlvDaPx9gupOchz1/8Jveihrd27K6ZlTkvX9vH7NwcSIlPJvONenMu4YaNsx1Pb2gfNLhy7DJ9l47AwtaSlFf5/j/wmdyDyt7accQKK3PCH73QLXvb8Wfn7sigPf5EPnnJzt6LUWZkYevmQKl6FXEuXYymQ9tjbmuFmbUFQz4JYO/gVUblU4ZFYlatom5a5uKEKiEJzRuZZG7OuG1dROazYEKHBKDJyDRqe2/TenIPKhp5ruqXy7kqrzpO/pBqr/Zt83+4b4O2d3b0numEP3nJht4LyXqVydLOigu7T3Ny2QEA6nRsSFRQ+Dtl6jHlI2q3qQeAhbU5wQ+zMzm4OZKcw3nKtYQbds72PHp1nvr+2EWGLhuJpa0VcRFx3Dj7q66H9ucvf6DbhA/fKdPrMkOjsKhVXjctd3NEGa9/nnob62a1SHsUhDIiFnVqOnGnfsTO17ghTZNmjKJ1W+0wBStrSx49eKJb5lrMhfi4BNJS0/XWiQiP4umTQG797y6gHSqwbP08ipfw5OmfeXu4722K2VpyNyS79zwyKRUbc1PMTQ2bOefvBBHQwfjnJQqb6HEtAqRSKQEBAcTExLB3717dfCsrKypWrMjNmze5du1agQwTuLj+BFt8Z7HFdxY7us6jeM1yOJbU9vjW79uaB9/dNFjH3NaSYUfncv/sdY6O36z3i+CD2uXou3MyJ6Zuz3OjFSDz5nXklSpj4uGh3XbHTmRevaJXxsTBEZvZ85DY2AKgaOWNKvB5vjZaAY6sO8RU30lM9Z3EzC7+lK9VgWIliwHg07c918//arCOvYs9U7f4Y21vDUCzLs158SiY5Pgk2vZtT+9XD2rZOtnR5qO2/HTqB6PzJXz/B1Z1ymNWSpvJdYAPceeu/+MybgN8KO6vfcBF7mSLS982RJ/M+8NJp9cfZYmvP0t8/VnZdRala5bD5dU+1qyvD7e+u26wjq2LHcM3T8LyVb016NKEl4+D/181WgHOrz/BBt+ZbPCdyZau8/igZjmcXtWNV9823PvuhsE65raWjDo6j7tnr3PoteMvITyWJQ3G6D7v/PrjBF5/aHSjFSDtl5soalRE/oH24SWbXh1IuXRVr4zUxhr3T9eQcuFnIv2XF0ijFbTnqq2+s9jqO4udb5yr6vVtzcO/OVcde+NclR/OrD/Gct8AlvsGsKrrbErVLIfzq0xN+3pzO4d928LWkslHF/LH2d/YO36jrtEKUK1NXfosGwGAwkJBq2Eduf7lux2DJ9YdZpbvFGb5TmFelxmUq1Uet1fnqdZ923Lz/G8G69i52DNuyxTdeapJl2a689Sv3/5Cgw6NkCtMAajr04Bnt58YfMY/lfTjH1jWqoDiVSanfu1IyCFTbuw7NqbYqx5WiakMu46NSbpyx6gsG1bswK/lR/i1/Ige7QZSq041SpbWPkTYZ1B3LnxreD7+4eIVPIu7U7WGtkOlXsPaoNHwIjjvwxXepmHZYtx+EU3QqzernPjtT1pU9DQol5iWQXBsEjU+yL+HkYV/13vd4/o6mUxGQEAAEydOpEGDBrr57du3Z+3atVStWhWZrGD/OykxiXzuv5OPtk/ERC4jNiiCE1O2A+BRrRRdVw5ni+8sGvRrg527E5Xb1qVy2+yruj19ltF6cg8kSGg7vbfujQRxL6L4bKRxtw418fEkrVmBzdxF2tdhhb4kadUyZOUrYD3Fn7hRw8i6e5vUQwexW7MB1CpUMTEkLMj/cXWvS4hJYIv/Rvy3z0BmKiM8KJxNk7X/xzLVyjJm5Tim+k7iwfX7nNhynMVHl6FSqoiNjGXFiGUAfL7tBBPXT2bD+c0gkXB0w2Ge5OEXQlZMIk8mbaXC7mlITGWkB4bzZMJmLGuUoeya0dzynpZrGYCQTScpt2UiNS+vB4mEF2uPkXzrad4r6zVJMYns89/GiO1TkcllRAVF8MmULQCUqFaa/itHs8TXnyfXH/LN1pNMPbIAtUpNfEQs24fn7bVO77uUmESO+++g3/ZJuuPvyJRtAHhWK02PlcPZ4DuThv28sXN3omrbulR97fjb1WcpqfncsFfFJhA1Zy2u6+cikcvIehFG5MzVKKqUw3nhZEJ6jMGmd0dkxZyxbN0Yy9bZD0iFDp2OOqFgHqhLiUnkpP9Oer92rvr81bnK/dW5aqvvLOr3a4NtDueqvX2WkZbPdZUck8gB/+0M3z5Ft2/ve7Vvf1CtNH1XjmK5bwDN+vng4O5Ejbb1qdG2vm79TX0WcfXYZUrVLMec82uRmki5cvgiv39reEH8TyXGJLDTfzMTt/sjM5UTERTO9sna8ZilqpVh+MqxzPKdwqPrDzi15QRzji5BpVQRHxnLuhErAPhu/1msbK1Y+vUapFIpgXefsefVw1HGUMYkEDxtE6V2TEcil5ERHE7QpA2YVy/LByvH8qj95Leu/3LJJxRfNpqK320CjYaEc78Stfe00Xn+EhMdx/QJC9iydzVyUznBgSFMG6N9PqJazUosWz8Pv5YfER0Zw6gBU1m4agYWFuZkZmYxetA0Mgvogu0vDlZmLOzmhf/hn8hSqfF0sGJJ90bcexnDwi9/5dhYXwCCY5JxtjZHblIk+u1ypvn/OyTsn5Bo8vICvAIUEhLCgAEDuHTpkt78wYMHo9FoCA4O5tKlS6SkpNCoUSN27NhBw4YNmTFjBvXr16dbt27vvM3ZJQ1fzVLYJpUr2KtUY4x8bFvYEQxMyyzY8VPG2qd4/06OW27k3wM3+WV23YK9kDLWSKvYwo5g4JNkx8KOYCCW/B3rnV/iNfnbg5wf/N/D+7w9Ul/8faFCcHdbl8KOYMD8w3l/X6iARbRoUSCf6/r99wXyufntve1x9fT0NGi0Anzyif6VrKWlJbdu3dJNr1ixosCzCYIgCIIgFIb38NrnX/XeNlwFQRAEQRAEfRr1f3uowPt3H1MQBEEQBEEQciB6XAVBEARBEIqI//pQAdHjKgiCIAiCIBQJosdVEARBEAShiND8x1+HJXpcBUEQBEEQhCJB9LgKgiAIgiAUEf/1Ma6i4SoIgiAIglBEiNdhCYIgCIIgCEIRIHpcXzO1xvv351WbXksv7AgGbiytU9gRcvT73KDCjmBgw8Z6hR3BwPv451WX3lha2BFyZOnRrLAjGIgZWbOwIxiQ2loUdoQcxZ1PKOwIBlZHuBR2BAN35nsVdoQcDfC/WdgRDBz/sLATgEZT2AkKl+hxFf5feB8brYIgCIIg5C/R4yoIgiAIglBEiDGugiAIgiAIglAEiB5XQRAEQRCEIuK/3uMqGq6CIAiCIAhFhHg4SxAEQRAEQRCKANHjKgiCIAiCUET814cKiB5XQRAEQRAEwWinT5/G19cXb29vPvvsM4PlFy5coHPnznTq1IkxY8aQkGD8O5ZFw1UQBEEQBKGI0GgkBfJjrIiICNavX8+hQ4c4deoUR48e5cmTJ7rlycnJLFiwgF27dvHVV19RoUIFNm/ebPT2RMNVEARBEAThPy4xMZGQkBCDn8TExLeu98svv+Dl5YWdnR0WFha0bduWs2fP6pZnZWWxYMECXF1dAahQoQJhYWFG5xRjXAVBEARBEIoIjbpgPnffvn1s2bLFYP64ceMYP358rutFRkbi7Oysm3ZxceH27du6aXt7e9q0aQNAeno6u3bton///kbnFA1XQRAEQRCEIkKdh9v6bzNw4EC6du1qMN/Gxuat62lyeD+XRGKYMSkpiTFjxlCxYsUct/NPiYbrO5LX8cJ8wAgkcjmqwGckb14Jaal6ZRS+XVG07wwaDerwUFK2rkaTEA+A3f5TqGOidGXTvzxC5g8X8pyrWZvGTJo9GlNTUx7ff8LcyUtJSU4xKOe/YAJt/VqTEK/t+n/+NIhpI+Ywc+kU6nrV0pVzcXMmKjKabi37GZXnx6cRbP7xEZkqNeWcrVnQrjpWCrlemT+jEllx8R7JGUpMJBLm+FSjsputXpnVl+4THJfC5u71jMrxJvvWtflgVj+kpjJSHgTxdMo2VMlp/6iMzM6K0itGYFmlJKq0DCKPXCJ877d5zvTjg2A2f3uDTKWacsXsWdCzKVZmprrlp2/+yYEf7+qmk9MziUxI4dzsjzCVmbDwxE88j4xHowG/OmUZ3LJGnjMBVGxZi/YBvZGZygh7GMzx6bvIeKOuAGp1aULzkR1BoyEzLZOvFuwj5M4zvTJ+c/vjVNKNT4auzpdsb6PRaJizdB1lS5dgcJ8eBb49gPbtW7Fk8UwUClPu3HnAiJHTSEpK1ivTr293Jk4coZu2sbXG06MYpUrXIzIympchtwgNDdctX7duB4ePfGFUHpPKdVH4DUQik6MKDST98EZIN/zuAGTVvDDrP4XkgA+z59VohKnPh2AiRxMXSdqBdZCaZFQWXabytTD17gMyOerwIDK+3AEZ+plM2/XHpEpDNGnautNEh5JxbEN2ATMLzIcuJOOL7ahD9fcxY5k1boDN6GFITE3JevKMuKWr0aTon9Mt2rXBql8v0GjQpGcQv3YzWQ8fA2DesinWg/oikctRhkcQt2AF6r+5tfpPVG5ZC7+A3piYygl9GMzh6TtzPP7qdmlCq5F+aDQastIy+XzBp7y484xu8wdSpkElXTk7VwcSI+NY2X56nrMB/BQYzearT7XneEcr5reuhJWpfpPiz+hkVv74iORMJVKJhDktK1LZ5e2NoHdVu1Ud+gQMQG4qJ+hhINsDNpOWQz21G+iLT7/2aDQaIoLC2TFjK4kxCUilUoYuGkFlr6oA/O/yDQ4s/TRfMxYVNjY2f9tIzYmrqys3btzQTUdGRuLi4qJXJjIykqFDh+Ll5cWsWbPylPO9GeP6+PFjKlSowLlz5/TmX716lX79+tG2bVu8vb2ZMGEC4eHak3tISAhVq1alc+fOej85PdGWHyQ2tlhOmEHyirkkjOmPKjwUiwEj9cqYlCmPWZdeJE0fS+KEwahCQzDvMxQAqUdxNMlJJE4epvvJj0arvaMdSzbOYdKQmXRs/CEhQS+ZMmdMjmVr1qvOtJFz6N66P91b92faiDkALJ+9Tjdv/KAAMjIymTVuoVF5YlMzmH/2Nmu61OHUsBZ42lmw8ceHemXSslSMPv4bg+qX4ejApgxvWJZZX/+uV+bcw1C+uf/SqAw5kTnaUHbDOB4NW83vTSeQERRBidn9/nGZkgsHoUpJ5/fmk7jTYSb2rWpj36ZOnjLFJqcx/9hPrOnfmlMBPfB0tGbjt9f1yvjVKcexyV05Nrkrn03ojJO1OTO6NMLR2pxt52/iYmvJ51O789mEThy79pBbQRF5ygRg6WDNh6tHcmD0ela3nkrMi0jaT//IoJxz6WJ0mNWHPQNWsMF3Jpc2f0H/HZP1ylTv4EWtLk3ynOmfeBoYzNAJMzl36ad/ZXsATk4O7N61jl69R1C1WnOePw9m6dKZBuUOfvY59eq3pV79tjRs1IGI8CgmTppDZGQ05cuXJj4+Qbe8Xv22RjdaJVY2mPWdRNre5aQsHYU6JhyF36Ccyzq7o+gyBF7rHZEWL4uixyjS9iwjdcVY1JEvUXQcYFQWHQtrFF3HkH54LWkbJ6GOi9Q2Yt8gLV6BjGMbSN8WQPq2AL1Gq0m5WpiPXIbEySNvWV7fnp0t9nMCiJ25gIgPB6J6GYrtmOF6ZWQfFMd2/EiiJ04nsv8Ikj45iONK7blRXrE8dtMmEDNjPhF9hqIMDsFm9JA857J0sKbP6lHsHb2eZa2nEPMikk45HH8upYvRaVZfdgxYzmrfGZzffJKhO6YAcHLhPlb7zmC17wz2jFhLVkYWB6duy3M2gNi0TOZfvM/q9tX4sl9DPG3N2fTLE70yaVkqxnz1OwNrl+BI7wYMr1eK2efv5cv2/2LjYMOY1RNYM2oFE1uNISI4nL4zDPfV0lXL4De8C3O6TWeqzwTCAkPpPVW7/zXr1gL3Mh5M9ZnAtHYTqdygKl6+jfI1Z3573x7OatSoEVevXiU2Npa0tDTOnz9Ps2bNdMtVKhWjRo2iffv2zJ49O8fe2Hfx3jRcT548Sdu2bTly5Ihu3o0bN/D392fatGmcO3eO7777jgYNGjB27FhdGRcXF06dOqX307dv3wLJKK9VD+WTh6jDtI2pjLOnMG3eRq+M6uljEkb3RZOaAnJTpI7OaJK0V9+yilVBrcZ6yQZsNu7FrNdAkOb9K2jUogF3f39A8PMXABzZd5IO3dsZ5jeVU6lqeQaN6cvJSwfZsGcFxTxcDcotXDuT/TsP8fDen0bluRoYTRU3W0rYWwLQs2YJvr0fqnc74WpgFJ52FjQtrb0qa1HWlVV+tXXLn8Ukse+3Z4xoVNaoDDmxa16D5D+ekP5cOyg8fN85nLo1/cdlrKqXIerED6BWo8lSEnfhJo4dG+Yp09XHL6lS3IkSztqe5p5elfj296c53noB+PT7WzhYmdPDqyIAAZ28mNKhPgBRiWlkKVV6vbXGKt+0Oi9uPyM6UHuReO3gd9Tq3NignDIzixPTd5MUFQ/AizvPsHa2w0RuAoBLGXdajPTjwqaTec70Txz5/AxdOnjTtlXTvy+cT7zbNOfGzVs8efIcgJ279vNR77ffBvOfNoaoqGg+/lh7ke3lVReVSsX5c8e4eeM7Zs+ahNTIc4NJxdqog/9EExUKQNbP3yCv28KwoFyBef+ppH/xsf7sei3JunYeTWwkABnfHiLz4gmjsugyla2B6uVTNLHa/Un523lkNd74jkxkSIuVRN7ED7Oxq1D0norE1lG3WNawPRknt6JJis1TltcpGtQl88EjlC+05/Tkk19h0a61XhlNViZxy9agjtFuN/PBI0wcHUAmw6K9NylffYsqTHuxmLh7H0kHjuY5V8Wm1Qm+/ZSoV8fflYPfUaez4cWfMlPJkem7SHx1/AW/cfz9pffy4Xy/52te3g/KczaAa8GxVHGxoYSdBQA9q3rw7eNwvfPWtRexeNqa07SkEwAtSjmxsl3VfNn+X6o3q8XT208ID9Ser88fPEvTzs0Nyj27+5QJLUaTmpSKXCHHwdWRpDjtHQSpiRSFuRkyUxlyUzkyuYysjKx8zfn/naurK5MnT2bAgAF06dKFjh07Ur16dYYPH86dO3e4dOkS9+/f59y5c7oOxtmzZxu9vfdiqIBSqeSrr77is88+o3fv3gQHB/PBBx+wbds2Ro8eTc2aNXVl+/btS3p6OpmZmf96TqmTC+roSN20OjoKqaUVmFvoDxdQqZA3aILlOH/IyiLx0B4AJFITsm7dIPWT7UgUCqzmrkCTmkLG6bz9Uijm7kp4aHYvW0RoJNY2VlhaWeoNF3Bxc+LXn2+yYek2Ap8GM3hMPzbvW02PNtlXqE1aNcTN3ZWDu48ZnSciKQ03a3PdtKu1GcmZSlIylbrhAkGxKThZKlhw9haPI5OwVsiY1EJ7Wys1U8mcr2+xqH0N7kXEG53jTQp3JzJCo3XTGWExyGwsMbEy1w0XeFuZpP/9iXOP5iRdf4jEVI5jBy/USlWeMkUkpOBma6WbdrW1JDk9i5SMLIMGaFxKOvt/vMuRiV108yQSCTITCbMOf8+FO4G0qlKCks76wy2MYevuSEJYjG46ISwWcxsLFFbmercr40KiiQvJri+/Of25f+EmqiwVphYKeq8fy9Fp2/GsXjrPmf6J2VO1dxp+vfHHv7I9AE9Pd0JCQnXTISFh2NraYG1tZTBcAMDR0Z5Jk0bQwKu9bp5MJuPCxZ+YMWMJ5uZmnPpyH4lJSWzevOed80jtnFDHZX8nmvhoJOaWYGauN1zArPdYMn85izo0UH99Zw9Uoc8xGz4HqYMr6tBAMr7Y/c459D7T1hFNQvb+pEmMQWJmAQpz3XABibU9qud3yfzuEJroMOSN/VD0DSB9m/bWdsb+ZXnKkBOZqwuqiOxzuioyCqmVFRJLC91wAVVYhK5hCmA7cTRpP/0CSiWyDzzJ+vMZjqsXY1LMjawnz0jYkPdeTXt3R+JfO/7iw2JyPP5iQ6KIDckeetZ1Tn/uvjr+/lKpRU3s3B354ZO8D2v6S3hyOq5WZrppFysFyZkqUrJUuuECQfGpOFqYsuDifR5HJ2vP8fnYEQHgVMyJ6NfO1zFh0VjYWGJuZW4wXEClVFHPpwGjVo5DmZnF0XWHAPj++CUa+jZm52+fYGJiwq2ffufmRf27Xu+b9/EPEPj5+eHn56c3b/du7XmjWrVqPHz4MKfVjPJe9Lh+//33uLu7U6pUKdq0aaPrdf3jjz+oV89wbOPQoUMxNdX+Uo+MjDQYKvDo0aOCCSrJpbrUho/4Zf36M/H9O5N2+FOsF6wBiYSM786QunsTKLPQpCSTfuoYpl557xmSSHPeidVq/UbVy+AwRvedTODTYAA+2XaQ4iU98figmK7MgJEfsWfzftQ5/J/+KXUuf0fZ5LXbA0q1mp+fRdK9+gccGtCE3rVLMu7EdTKVKhacvU3v2iUp62xtdIYc5VJPGpX6H5UJXPgpaDTU+G4NFfcGEP/jLTSZyjxFUufSs2qSQ47Pf31Ii8ol8HAwrJdlH7Xg+/l9SUjLYOeFP/KUCXIeWA+gVuW8X8jNFfTbOhHHkq6cmLELgJ6rRnJl3zkiHofkOc/7TJrLPqNS5XxRM2xoX06fPk9g4AvdvL17DzFlyjwyMzNJSEhk48bddO7UPsf1/1Zut+FeO6blTXxBpUJ57TvDciYmyKrWJ+PIFlJXTUCTGIeid+5PFP+zTH9/7tTER5FxYAWaaG3vWdaV00jtXZHYOee8bn7Ira5y2M8lZmY4LJuPrLgHcUvXaOeZmGDetCFxy9cR2X8E6tg47GdNzYdYOdeXJpfjz9RcwaCtk3Aq6caRGTv1lrUY4suF7V+hye3EbIRcTlsG5/grQTF0r+LBoV716V29OOPP3CIzl/+DMXL93ZfLNq6f/5WhtfpzbP1h5hxYgEQioeek3iTGJjC8zkBGeQ3Bys6ajsM751tGIf+9Fz2uJ0+epGPHjgD4+voybdo0Jk2aBGT/As3MzKRnz54AJCQksG7dOlxcXHRDBf4N6qgIZOWzB7tLHZ1QJyVCRnr2PDcPpPYOKB/cASDj4jdYjJ6CxMoaeR0vVM+foAp69VCBRAIq4xo+4wJG0LKtttFraW3Jnw+e6pa5FHMmIS6BtNR0vXXKVy5LhcrlOH0i+8pbIgHlq6tze0c7qteuwsTBAUZl+ksxazPuhsXrpiOT0rExk2P+2sB9ZyszSjpYUc3dHoCW5dxYdO4Od8MT+D0klsDYFA7eeE5ieibJGUrGnviNrT3q5ylXxstorGuV000rijmSFZeEOi3jH5UxdXAiaMkBlPHaXjSPsV1IDzT+XXQAxeysuBuc3WMSmZiCjbkp5qZyg7Lnbz0noJOX3rxfHoVQ1s0eF1tLLBRy2tUszcU7gUZl8Zncg8re2jG7Citzwh9lN6xs3BxIjU8m67W6+ouduyOD9vgT+eQlO3svRpmRha2bA6XqVcS5dDGaDm2Pua0VZtYWDPkkgL2DVxmV730yf940Onb0BsDaxop7d7N7Ezw83IiNjSc1NeeHoXr27MTkKfP05vXt053bt+9z5+4DQHvey1Iad7tSHReFrGQF3bTE1hFNShJkZn938gZtQK7AImATyGQgN8UiYBNpOxagSYhFHRaEJikegKxfL2A+bqlRWXSZEqKReWb3tkmsHdCkJkNWdiaJ6weYuJVAeeu18ckSCajzdlfjbVQRkZhWzT6nmzg7o05IRJOuf+40cXXBce1SlIFBRI2ZAhnaO36q6Biynj5HHRsHQMrpszhvW2NUlvaTe1L11fFnZmVO2GvHn62bAynxyWTmcPzZuzsyfE8AEU9esqX3Ir3b3JYO1pSoWZY9I9calSk3btYK7kRk/+WjyOQMbBQyzF8bouBsoaCkvSXVXj1w27K0M4suPSAkIY3SDpZGb7vXlD7UbaPt0DK3tiD4YfbwBwc3R5Ljk8h4o57cSrhh52zPwxva4+vysYuMWDYaS1sr6rfzYu/83SizlCizlPxw4hJevo04s/vfaVcYI7cLh/+KQu9xjYmJ4ccff2Tv3r20atWKOXPmkJiYyPnz56lWrRr/+9//ADA1NdWNYS1evDhZWf/+GJSsP64jq1AZaTHtwwGKdp3I+u2KXhmpgyNW0+YhsdYerKbNvVEFP0eTlIjJB6Uw7zNEO67V1BQz365k/nTZqCxbVu3SPUzVx3co1etU5YNSxQHoNbAbl84aPpyiVquZuXSKroe196DuPL7/hIgw7a2yWvWrc/eP+wYN3nfVsKQzt0PjCIrTDlM4cSuYFmX1x9I2KeVMaGIa98O1J7+bL2JAAlXcbPluTBuODWrKsUFNGd2kPLU8HfLcaAVI+P4PrOqUx6yU9v/vOsCHuHPX/3EZtwE+FPfvDYDcyRaXvm2IPpm3h4AalvfgdnAkQVHaejhx7SEtqpQwKJeYmkFwdCI1SurX4/nbz9l54Xc0Gg2ZShXnbz2nXhl3o7KcX3+CDb4z2eA7ky1d5/FBzXI4lXQDwKtvG+59d8NgHXNbS0Ydncfds9c5NH4zyle/NBPCY1nSYIzu886vP07g9Yf/LxqtAAsXrdE9RNW0aSfq169N2bKlABgxvD+nT5/LcT07O1vKlCnJ1av6dVmlSgXmz5+KVCrFzMyM0aMHcfz4aaOyqR7+jkmJCkictfuBvIkvyjvX9Mqkrp1C6oqxpK6aQNqOBZCV+ap3NZasW1eQVa4LFtqefVmNRqiDjRvvrsv05BYmxcshcdDuT7L63igfvnE7VqPBtMNgXQ+rrL4P6vAgNIn5N6b1Tem/3sC0aiVkxbXndMtuftphAK+R2FjjvGM9aZd/InbOEl2jFSDt0o+YNfZC+upJbPOWTci8b9wdv2/XH9c9TLW+61xK1iyL86vjr3HfNtzN4fizsLVk/NH53D77G/vGbzIYm1m6bgWCbz/NscGbFw2LO3InPIGgeO1wihN3X9KilH7PeOMSjtpzfKT2GY+bL+OQSMDDxszg897F0XWH8PedjL/vZGZ1CaBcrQq4ldSer336tuP6+d8M1rFzcWDSlmlY22v36SZdmhP8KJjk+CSe331Gow7a8fsmMhPqetfn8e8FdNc2n2jUkgL5KSoKvcf1q6++wsvLi48/zn5AYPPmzRw9epSJEycyZcoUKlasSI0a2lf8PHz4kBcvXmBiYpLbRxYYTUI8KZtWYDV9kfY1M+EvSdmwDJOyFbAc60/i5GEo798m7fhBrJduAJUKdWwMycu0g5DTjnyK5chJ2G76BExkZF75nozvzuQ5V2x0HHMmLmbDnuXI5DJeBL3UvRGgSo2KLFo3m+6t+/Pk4TOWzVrL1gNrkUqlRIRF4j9qru5zSpT6gJcv8taDCOBgqWBh+xr4n7pJlkqNp50lS3xrcC88noVn73BsUFOcrMxY36UOyy7cJS1LiamJlHWd66CQFdz3mhWTyJNJW6mwexoSUxnpgeE8mbAZyxplKLtmNLe8p+VaBiBk00nKbZlIzcvrQSLhxdpjJN96+jdbfTsHK3MW9myG/8FLZKlUeDrYsKR3c+69iGLhiZ85Nln7kE9wTCLONubITfSvNad0rM/Sk1fose4kEomEllVK0LdJlTxlAkiJSeS4/w76bZ+EiVxGbFAER6Zox+55VitNj5XD2eA7k4b9vLFzd6Jq27pUbVtXt/6uPktJjTcc3/n/UVRUDMNHTOXI4Z2Ymsp5+iyIIUMmAVC7dnV27lhNvfptAShTpiRh4ZEolfp3WhYvWcfGDUv4/X8XkMnlnPz8DHv3HjIqjyY5gfRDGzEfMhNMZGiiw0g7uA5p8bKYfTSB1FUT3rq+6u5vZNo5YjFhBUglaGIjST+0yagsOimJZJzcjuKjKUhMZKhjI8j4fAtS99KYdhlF+rYANJEvyPj6E8z6TQepFE1CLBnHN+Ztu39DHRdP3OLVOCxfgEQmQ/kylNiFK5BXLI/97GlE9h+BVbdOmLi6YN6iCeYtsh+Qih47jfSfr2Li4ozzjvUglaAKiyB2qXE9rq9LjknkkP8OBm+fjIlcRkxQBAenbAWgeLXS9F45gtW+M2jczxt7dyeqta1HtbbZw+q29llCanwyziXd9MbA5hcHC1MWtK6M/7d3UKrVeNqYs9i7CvciEll0+QFHezfAyVLBOt/qLP/hEWlZKkxNpKxtXz1fz/GJMQls89/E1O3TkZnKiAgKZ8vkDQCUrlaW0SvH4u87mYfX73Nyy3EWHF2KWqkiNjKW1SO0Y6Y/XbSHoYuGs+HiVtRqNXeu3ObU9n/nYVLBOBJNbo8v/0v8/PyYPHkyrVq10s2LiYmhVatWnDx5kvj4eLZs2UJ0dDQajQY7Ozv69u1L+/btCQkJoV27dpQpU0bvM+vVq8ecOXPeOUtsDk8jFram1/LW+1kQbiw1fLq8sP0+N3+els1vtXY0KOwIBuZP/P3vC/3Llt7I263ogmLp0ezvC/3LYkbWLOwIBqS2FoUdIUdx56P/vtC/bHWEy98X+pctn+pQ2BFyNHBN/r0OMb8cDyr8IQR3S3cskM+t+izvHWn/hkLvcT192vB2mKOjI7du3dJNf/LJJzmu6+npyd27d3NcJgiCIAiCIPz/UugNV0EQBEEQBOGfycsfC/j/oNAfzhIEQRAEQRCEf0L0uAqCIAiCIBQR//XXYYmGqyAIgiAIQhGhFkMFBEEQBEEQBOH9J3pcBUEQBEEQigjxcJYgCIIgCIIgFAGix1UQBEEQBKGI+K8/nCV6XAVBEARBEIQiQfS4CoIgCIIgFBH/9bcKiIbra0b+YVfYEQzcWFWpsCMYcB1zrLAjGFjl0KiwI+SoWc+NhR3BwKPyVQs7ggFLj2aFHSFHKS9/LOwIBlrVGF7YEQykqRMKO0KOvBXFCzuCgVklQws7ggHvFZGFHSFHR9z/2w00IWei4SoIgiAIglBE/NffKiAaroIgCIIgCEXEf32ogHg4SxAEQRAEQSgSRI+rIAiCIAhCEfEffxuW6HEVBEEQBEEQigbR4yoIgiAIglBEiDGugiAIgiAIglAEiB5XQRAEQRCEIkK8DksQBEEQBEEoEtSFHaCQiaECgiAIgiAIQpEgelwFQRAEQRCKCA1iqIDwDmq3qkOfgAHITeUEPQxke8Bm0pLTDMq1G+iLT7/2aDQaIoLC2TFjK4kxCUilUoYuGkFlL+3fi//f5RscWPppnjL9+CSczZfvkalSU87FhgUdamOlkOuV+TMygRXnb5OckYWJRMKc9jWpXMwegAsPX7Lnl8dkKlUUs7VgiV8d7CwUecoE0LZtS+Yv8kdhasrduw8ZN2YGSUnJemU+6tOVseOH6qZtbKzx8HCjYvnGREVGA+DhUYyL339OI68OxMbE5TnX6z5oVZMGMz7ExFROzINgvvf/mKwcvs+/tFw3gthHIdza+U2+5vBt35olS2agUCi4c+cBw0dMNairfv16MGniCN20rY01np7FKFGqLps3LaNMmZK6ZaVKFufHn67Rtdtgo/JYNKuPw6TBSORyMh8/J3LeejQpqXplrDq2wm5wT9Bo0KRnEL18Gxn3/tQtl1pb4r5vDVFz1+nNz4v27VuxZPFMFApT7tx5wIiR0wzrqW93Jr5WTza21nh6FKNU6XpERkbzMuQWoaHhuuXr1u3g8JEv8iVfbjQaDXOWrqNs6RIM7tOjQLf1l4atGzByxjDkCjlPHzxjxdQ1pCan5lq+advGzN44nXYVOwEgN5UzcfE4ajeuSVpKGr98d429a/eh0Rj/FsnGrRsybtZITE3l/PngKYunrCAlh0yT5o+ljV9LEuISAQh6GsysUQuQyWUELJ1EzQY1APjl0jU2Ld6OWm38zdMKLWvSNqA3MlMZ4Q9f8Pn0XWTkcA6o2aUxzUZ2RKPRkJWWyekF+3h55zkmchP8Fg6iZL0KADz+/hbfLj+ERm18PZl6eWE1fDgSuRzls2ckrlqFJlW/nsy8vbHo1QsATXo6SZs3o3z0CORyrMePx7R2bTRpaWT88gspn34KefjectKwdQNGzRiGqcKUJw+esXzq6hz3r3HzRtGyY3OS4pMACH76gnmjF+dLBrPGDbAdOwyJqZysP58Ru2SNwXnKon0brPt9CGjPU3FrtpD14DEArvu3I1Eo0CizAEj99iJJB4/lSzah4LyXQwVCQkKoWrUqnTt3pnPnzrRt25YJEyYQHa1tyFSoUEFX9uzZs3Tr1o1OnTrh5+fHxx9/XGC5bBxsGLN6AmtGrWBiqzFEBIfTd8YAg3Klq5bBb3gX5nSbzlSfCYQFhtJ7ah8AmnVrgXsZD6b6TGBau4lUblAVL99GRmeKTclg/pmbrOnegFOjvPG0s2Tj5Xt6ZdKylIw+fIVBXuU4OrQVw5tUYNapGwDcC4tjxblbrOlWn89HtKGEgxVbfrhvdJ6/ODo5sG3nSvr3GUOdWm0IDHzBwkUBBuUOH/qCJg070qRhR1o07UJkRBTTpizQNVo/6tOVs98dxd3dLc+Z3mTmYE3LtcM5P2IjR1r4kxgcidfMXjmWtSvrjt+RmZTu2CDfczg5OfDx7nV82GsEVao24/nzIJYtnWVQ7uDBE9St50Pdej54NfQlIiKKCRPnEBkZTa/eI3TLRo3yJz4+kfETZhuVR2pvi8viqURMWswLv2FkhYTjOHmIXhl5SU8cpw4jbORsQnqMIW7nIVw3zNMtt2haD4/DmzAtVdyoDDlxcnJg96519Oo9gqrVmvP8eTBLl840KHfws8+pV78t9eq3pWGjDkSERzFxkraeypcvTXx8gm55vfptC7zR+jQwmKETZnLu0k8Fup3X2TnYMnOdP3NGLKBvs0GEBoUxatawXMt7lvJgzNyRSKTZvxL6j++Dm4cLg1oPY1i70Ti6ONB1YCfjMznaMX/DTAKGzaF70768DApl3OxROZatXrcqs0YtoK/3EPp6D2HWqAUA9BrSHTtHO3q1GMBHrQZRvW5VvDu1NDqTpYM1PVaP5LPRG1jXehqxLyJoN723QTmn0sVoP6sPnwxYyWbfWVze/CX9dkwGoOGAtlg6WLPRZzqb2s2gRJ3yVO/oZXQmia0tttOnkzBvHjEDBqAKDcVqxAi9MibFi2M1ahTxAQHEDhtGyoED2C1apP0/9e2LiZsbMUOGEDtiBFJHR8y7dDE6T07sHGyZvS6A2SMW8FGzgYQGhTJ61vAcy1arW4X5Y5YwyGcEg3xG5FujVWpni8M8f2KmLyC8xyCUL8OwG6e/j8tKeGI3YQRRE2YQ0XckiXsO4rRqAQASMzNknu6E9xlORN+RRPQdWWQarWpNwfwUFe9lwxXAxcWFU6dOcerUKc6ePUuJEiWYMGGCXpmIiAhWrlzJnj17+Oqrrzhy5AjffPMNFy9eLJBM1ZvV4untJ4QHhgFw/uBZmnZublDu2d2nTGgxmtSkVOQKOQ6ujiTFaa82pSZSFOZmyExlyE3lyOQysjKyjM509XkkVYrZU8LBCoCetUvx7b0Xer0iV59F4mlvSdOy2sZfi3LFWNWtPgBf331Blxol8bCzBGBU00oM8ipvdJ6/tG7dlP/dvMPTp4EA7Nl9kJ69Or91nclTRhIVFcMnew8D4ObmQoeOPvToNuSt6xmreLNqRN56TkJgBAD3D1ykbJecLyKqDmzDw2M/8uzMr/mew9u7OTdu3OLJk+cA7Ni5nz4fdX3rOgH+Y4mMimb3xwf15svlcvbu3cCUafMJCQk1Ko9Fo9qk33tEVrB2/cSjZ7Dq0EqvjCYzi6j5G1BFxwKQce8xMid7kGlv4tj27ULk7DUoI2OMypAT7zbNuXEzu5527trPR73fXk/+08YQFRXNxx9/BoCXV11UKhXnzx3j5o3vmD1rElJpwZ4Gj3x+hi4dvGnbqmmBbud19ZrX5eGtR4Q8fwnAl/u/wrtr6xzLKswUzN00ky0Lt+vNr1C9PBe/+p7MjCw0Gg0/nbtCiw7NjM7k1bwe9/94yIvnIQCc2Pcl7bt5G5STm8qpULUc/Ub35tCFT1j18WJcPVwA+GznUWaOnI9Go8HW3gZrWysSXvXkGaNc0+qE3H5GTKC2B/7awQvU7NzYoJwyM4uT03eTFBUPQMidZ1g522EiN+HnPd9weNxmNBoNFvZWmNlYkBqfYnQmRb16ZD18iOql9rtL/eorzNq00SujycoicfVq1LHa4y/r0SOkDg4gkyGvUIH0S5cgMxM0GjJ+/hmz5oa/p/KifvO6PHht//pi/1f45LB/yU3llKtSjj4jP+TT73azdNcCXN1d8iWDmVddMu8/QvlCmyH586+waKefQZOZReyStahjtPWU+eAxJo7aejKtUhF1ahrOG5bheng3dpNHI1GY5ks2oWC9tw3X10kkEsaPH8+ff/7Jw4cPdfPj4uLIysoiPT0dAEtLS1asWEHZsmULJIdTMSeiQ6N10zFh0VjYWGJuZW5QVqVUUc+nATuu7aVygypcPq5tTH9//BIpCcns/O0Tdl3/lPCgMG5evG50pojEVNxssrfvamNOcoaSlEylbl5QbDJOlmYs+Pp/9Nl7mVGHr6B6dXkVFJuMSqNm0vGrfPjxRZafu4WFad5HkHh4FiMkJEw3/fJlOLa21lhbW+VY3sHRnnEThjEjIPtqPDw8kn59RvPo4ZM858mJpbsjyaHZDavksFgUNhbIc/g+f567nz9PXimQHMU93XnxWiMzJCQMW1ubXOvK0dGeyZNGMGXqfINlQwZ/RFhoBKdOnTU6j8zNGWV49n6ujIjCxNoSiaVF9rzQCFJ//C07U8BIUi5fA6V2vwsbNZuMWw+MzpATT093vcb4P6mnSZNGMHXaAt08mUzGhYs/0dGvH61ad8fbuzljxxo3nOKfmj11DJ3a5dxoLCgu7s5EhEbppqPCorCyscLCysKgrP+qyZw6eIanD57pzb//+wNa+bXA3MIMmVxGmy6tcHR1NDqTq7sLEaERuunIV5ks38jk7OrEjSv/Y+uynfRpM5g7N++z7pPluuUqpYpxs0by5bUjxEbF8fuvt4zOZOvuQEJY9jkgMSwWMxsLFG+cA+JDonl0+Q/ddIc5/Xhw4SaqLBUAaqWKttN7M+2HDSRHJxD420OMJXVxQRWV/d2po6KQWlkhsciuJ3V4OJnXrummrceOJeOXX0CpJOv+fcxatkRibg4yGWatW2sbtfnIxd2FyNBI3XRu+5eTqyP/u/I7O1Z8zCDv4dz73wNWfJI/Pa4mrs6oIrLrSRX5qp5eO0+pwiJIv5Ld2WA3eTRpP14FpRKJpTkZN/8gesZCIgaOwcTNBduxud+VeJ+okRTIT1FRJBquAKamppQoUYJnz7JPrhUrVqR169a0adOGHj16sHr1atRqNSVKlCiQDBJpzl+sWpXz+Krr539laK3+HFt/mDkHFiCRSOg5qTeJsQkMrzOQUV5DsLKzpuPwt/dEvk1u3fsmkuysSrWGn59G0L1mSQ4NaUnvuqUZd/QXMpUqlCo1P/wZzpz2tTgytBVOVgoWffu70Xn+IpXkvGupVKoc5w8e/BHffP0dQUEhed72P5Xb96nJ5fssKLn1+OVWV8OH9eOr0+cJDHxhsGzixOEsW74xr4Fynq82zCMxV+C6djby4u5EzV+ft+3+baycv6/c6mnY0L6cfqOe9u49xJQp88jMzCQhIZGNG3fTuVP7AslbmHLbp948V3UZ2AmVUsU3Rw0vdD7beoTnjwPZ/tVm1h9Zzd0b98nKNP7uUO77uX6m0BdhTOwXQNBT7fd2YPthPEp64F68mK7MlmU7aVnRl9AX4cxcMdXoTJJczlO5ndPl5gr6bJ2IY0lXTs7Yrbfs3MojLKoxnLiQKLoszcNdIkku56WcxvGamWG7YAEmHh4krl4NQMrhwygDA7HfuhX7tWvJuncPjVJpuG4e5HYsvllvYS/CmTZgJsGvvstDO47iUcKdYsXzYehXLt8dOXx3EjMzHJfPQ+bpTuySNQCk/3iV2PkrtGNiM7NI/OQQ5i2a5D3Xv0CDpEB+iooi9XCWRCLBzMxMb97ChQsZM2YMP//8Mz///DMffvgha9aswcfHJ1+22WtKH+q2qQeAubUFwQ+DdMsc3BxJjk8iIy1Dbx23Em7YOdvz8Ia2x+nysYuMWDYaS1sr6rfzYu/83SizlCizlPxw4hJevo04s/uUUfmK2ZpzNzRWNx2ZlI6NmRzz13pNna3MKOloRTUP7VV3y/LuLPr6d0LiU3C2NqOciw1OVtp67VS9BCM++9moLLPnTKJ9B+0tLWtrK+7fe6Rb5u7uSlxsPKmpOT/41K1HBwKmLTRqu++i7tTulPSuDYCplTkxj7IbNZZu9qTHJ6N84/ssCAvmT6NjR+0+amNtxd172T00Hh5uxMbG5VpXPXt2YvLkuQbza9asgszEhB9+vJqnbMqwSMyqVdRNy1ycUCUkoXmjXmRuzrhtXUTms2BChwSgycjM03ZzMn/eNDp21N5Otrax4t7dN+sp932qZ89OTJ4yT29e3z7duX37Pnfuao9NiURCltL4xtj7ZOi0QTT2aQiApZUFTx8+1y1zcnMiMS6R9LR0vXXa92yLmbmCved3IpfLUZiZsvf8Tvz7z0KjVnN053G2Ld4JQKtOLXgZ+G7DT0b6D6WZj/bWu6W1JU8fPNUtcy7mREIOmcpWKkP5KmX55sQ53TyJRIJSqaRGvWrExcQT/OwFKqWKM0e/wX/ppHfK1GZyDyq9OgeYWVkQ/ihYt8zGzYHU+GSycjgH2Lo7MnDPNCKfhLK79xKUr4Z4lahTnpTYRKKfh6NWqrh54kc6LRj4Tplep46MRF6pkm5a6uSEOjER0vXrSerigt2yZaiCg4mbNEk7NACQ2tiQevQoydu1Qz8ULVvqhh3kxbBpg2jiox1KZWFlwTO9/cs5x/2rTKXSlK1chnOff6eb99d3mVeqiEgUVbPPUybOTqgSEtG8UU8mri44rVuCMjCYqNFTdecps6YN0SQnk/H7nb+C5XsDXygYRabHNTMzk+fPn+sNA/j+++/55ptvcHV1pXv37qxfv545c+Zw4sSJfNvu0XWH8PedjL/vZGZ1CaBcrQq4ldRe+fv0bcf1878ZrGPn4sCkLdOwtrcGoEmX5gQ/CiY5Ponnd5/RqIP2RG4iM6Gud30e//7I4DP+qYalXLn9Mo6gWO2T1Sf+95wW5YvplWlSxpXQhFTuh2mfyL8ZHA0S8LCzxLuiBz89iSA+VXuivvQolCrudkZlWbpkg+5Bq9Ytu1Ovfi3dk+5DhvXl668v5LienZ0NpUuX4Ndr/zNqu+/ixtrPOdFuNifazeZk5wW41iqLbUlXACr3a03g+YLPALBg4Rrdw1SNm/rRoH5typYtBcDIEf356vT5HNezs7OlbJmS/HL1hsGyZk0bcvn7vA9nSPvlJooaFZF/4A6ATa8OpFzSbwxLbaxx/3QNKRd+JtJ/eYE0WgEWLlqje4iqadNO1H+tnkYM78/p0+dyXM/OzpYyZUpy9Y16qlKlAvPnT0UqlWJmZsbo0YM4fvx0gWT/t+1Z8ylDfEYyxGckI/3GU6V2ZTxLeQDQpb8fP5//xWCdkR3HMrD1MIb4jMS//0wy0jMZ4jOSmIgYGvs0YtpK7QNI5hZm9Breg+++eLfnB3au3qN7wGpwh5FUrVOF4qU8Aeg+oAs/nDO8SNao1UxbPFHXw9pjYBee3H9KZFgUdZvUZsrC8ZiYmCCRSGjX3YfrV97tmL2w/gSbfWex2XcW27rOo3jNcjiW1PYANujbmvvf3TRYx9zWkhFH53Lv7HWOjN+sa7QClGlUhQ5z+yM1kSKRSKjZuTFPrxr/gGvG9evIK1fGxEP73Vl06kTGFf3jWmJtjcPGjWT89BMJixbpGq0AikaNsJmq7YWWmJtj2bMn6RdyPve+i4/XfKp7wGqE3ziq1K6k27+69vfjpxz2L7VazaRF43Q9rF0HduLJg2dEhUUblH1X6dduYFq1MrLi2gxW3f1I/1E/g9TGGped60i7/BMxs5fonadMXJywnThKO65VKsW6Tw/Svvs+z7n+DeoC+ikqikSPq1qtZvPmzdSoUYMPPvhAN9/MzIzFixdTvXp1PD090Wg0PHnyhEqvXa3mp8SYBLb5b2Lq9unITGVEBIWzZfIGAEpXK8volWPx953Mw+v3ObnlOAuOLkWtVBEbGcvqEcsA+HTRHoYuGs6Gi1tRq9XcuXKbU9tPGp3JwVLBwo618T/5K1kqNZ72lizxq8u9sDgWfv07x4a1wsnKjPU9vFh27hZpmUpMZSas694AhcyE5uWKEZGYxtCDP6HRQDFbC+Z3qJXnuoqOimHMqAD2f7YVU7mc58+DGTlcezKtVasam7ctp0nDjtq6K12SiPDIfLkKfxfpMYl8P3UX3jsnYCKXkRgUyaXJOwBwrl6K5quGcaKdcU/mv4uoqBiGDZ/C0SO7MDWV8+xpEIOGTASgTu3q7NypbeQClC1TkrCwiBzrqmzZUvky1EIVm0DUnLW4rp+LRC4j60UYkTNXo6hSDueFkwnpMQab3h2RFXPGsnVjLFtnP8wSOnQ66gTjH5Z5m6ioGIaPmMqRwzsxNZXz9FkQQ4ZMAqB27ers3LGaevXbAlCmTEnCctinFi9Zx8YNS/j9fxeQyeWc/PwMe/ceKpC8hSk+Jp7lU1axeNd8ZHIZoUFhLJm4AtA+dDV9zVSG+Ix862d8c+RbKteqxP5Le5CaSDl96Bu+//pHozPFxcSzaNJyVu5ejNxURkhgKPMnLAGgUo0KzFkznb7eQ3j66Dmr52xg/f4VSE2kRIZGMWvMAgD2bfmMqYsmcOjiJ2jUav747Q5blu00OlNKTCKf+++k7/aJmMhlxAZFcGyKtqfSo1opuq0czmbfWTTo1wY7dycqt61L5bZ1devv6bOMH3Z8Rcd5A5jw7Qo0ajWBNx5zbuURozNp4uNJXLkS24ULkcjlqEJDSVi2DFmFCtj4+xM7bBgWnTsjdXFB0bQpiqbZD/3FTZlC2rffIq9UCcdPPgETE9LOnCHjhx+MzpOT+Jh4lk1ZzZJdC5DLZbwMCmXxq/2rYvXyzFgzjUE+I3j+KJD1czez6tOlSE2kRIVFsWDMknzJoI6LJ3bRKhxXzEcil6EMCSN2wQrklcrjMGcqEX1HYtndDxM3F8xbNsG8ZfYwgKgx/qScPIPMoxiuB3aAiQkZN/8g4eMD+ZJNKFgSTV5eyldAQkJCaNeuHWXKlAG0DddKlSoxa9Ys7OzsqFChAo8eaXspv/jiC/bs2UNWlvYKuGnTpgQEBGBq+u5PB/YsYfxY04Kyf1HBNMLzwnXM+/fKkFUOxr9SrCCNi7hc2BEMPCpftbAjGKj0572/L1QIUl4a31ArKK1q5PzaocKUpi6YHve88lbk3+vY8sukksa97aMgdfvz/bz5esT9/Rt3Wfx6wby16F2cdzV8ZVt+8Ikw/oLr3/Re9rh6enpy9+7dXJf/1WgF6Nq1K127vv2VOIIgCIIgCELR9142XAVBEARBEARDRWk8akEQDVdBEARBEIQi4r/ecH0/B7YIgiAIgiAIwhtEj6sgCIIgCEIRUZT+WEBBED2ugiAIgiAIgtFOnz6Nr68v3t7efPbZZwbLHzx4QPfu3Wnbti2zZ8/O0+svRcNVEARBEAShiFBLCubHWBEREaxfv55Dhw5x6tQpjh49ypMnT/TK+Pv7M3fuXM6dO4dGo+HYMeNfqykaroIgCIIgCP9xiYmJhISEGPwkJia+db1ffvkFLy8v7OzssLCwoG3btpw9e1a3/OXLl6Snp1OzZk0AunXrprf8XYkxroIgCIIgCEWEuoDGuO7bt48tW7YYzB83bhzjx4/Pdb3IyEicnZ110y4uLty+fTvX5c7OzkRERBidUzRcBUEQBEEQioiC+nOnAwcOzPEPOtnY2Lw9Tw5/gFUikfzj5e9KNFwFQRAEQRD+42xsbP62kZoTV1dXbty4oZuOjIzExcVFb3l0dLRuOioqSm/5uxIN19fsm126sCMYmDD/aWFHMBC+ol1hRzBwdml8YUfIUeL69+/PES9bHVvYEQzEjKxZ2BFy1KrG8MKOYODSrd2FHcGAOvpFYUfIUea21YUdwUCPL8wLO4KBc/3ev0wAg4+oCjuCgeOFHYD37w8QNGrUiM2bNxMbG4u5uTnnz59n8eLFuuUeHh4oFApu3rxJnTp1+PLLL2nWrJnR2xMPZwmCIAiCIAhGcXV1ZfLkyQwYMIAuXbrQsWNHqlevzvDhw7lz5w4Aa9asYfny5bRv3560tDQGDBhg9PZEj6sgCIIgCEIRoc7D+NCC4ufnh5+fn9683buz7w5VrFiREydO5Mu2RI+rIAiCIAiCUCSIHldBEARBEIQioqDeKlBUiIarIAiCIAhCEfG+PZz1bxNDBQRBEARBEIQiQfS4CoIgCIIgFBHq9+/ZrH+V6HEVBEEQBEEQigTR4yoIgiAIglBEqPlvd7mKHldBEARBEAShSBA9roIgCIIgCEWEeB2W8E5+ehbJ5p8ekalSU87Zmvk+1bBSyPXK/BmVyMpL90nOUCKVwhzvalR2tSVLpWblpXv8LyQOgMalnJnUrCIm0rx3+1drWZtuAX2QmcoJeRjEvunbSU9OMyjXckA7WvTzQaPREBUcwf4ZO0iKSdQtty/myMwvlrGo/TSS45LynAvgp8BoNl99qq0zRyvmt66Elan+rvdndDIrf3xEcqYSqUTCnJYVqexiky/bf51bm5pUmdUbqamMhAcv+N/kXShzqKe/K2fu7kCLrxdxsfVMMmPzVk8/PY9i8y9PtPXjZMX81lWwUrxZP0ms/OFR9j7VqrJe/SRlZDH0xA3mt6lMFVfbPOX5S/mWNfEJ6I2JqYyIhy/4YvouMnKoqxpdGtNkZEfQaMhKy+TMgn2E3nmuW25mY8Gwo/M4GbBTb/67MqlcF4XfQCQyOarQQNIPb4R0wzwAsmpemPWfQnLAh9nzajTC1OdDMJGjiYsk7cA6SM2ffbxh6waMnDEMuULO0wfPWDF1DanJqbmWb9q2MbM3TqddxU4AyE3lTFw8jtqNa5KWksYv311j79p9aDQF9ytKo9EwZ+k6ypYuweA+PQpsO3/58cZtNu7/gswsJeVLerBw/ECsLMz1yhw6c4nDX1/GTCGnlGcxZo/sg621pW55eFQs/QJWcHzjXOxtrPMl1/u6X9VvVY/BMwYjN5Xz/MFz1vtveOs+1bBtQ/zXT6Nb5e4Gy0bOH4FHSXfmDV5gdB6TinUwbdcXiUyOOiyI9BNbISPnejKpXB+zXhNImd/v1QwZis7DMClTFU1GOqoHN8i8cBTyYf+u3aoOfQIGIDeVE/QwkO0Bm0nL4TzVbqAvPv3ao9FoiAgKZ8eMrSTGJCCVShm6aASVvaoC8L/LNziw9NM85ypI4uGsQhYSEkLVqlXp3LkznTt3xs/Pj1atWrFp0yZdmcePH1OhQgXOnTunt27//v3x9vamc+fOdOzYkW7duvHDDz8UWNbY1Azmn73N6k61+XJIczxtLdj00yO9MmlZKsZ8fp2B9UpzZEAThnuVY/bXfwBw5PdA4lIzOTGoKccGNuFWaBznH4XlOZeVgw2DVo9h++g1zG09kegXEXSb3teg3AdVS+Mzwo8V3eewoO1UIp6H0Xlqb93yht2aEXB8EfZuDnnO9JfYtEzmX7zP6vbV+LJfQzxtzdn0yxO9MmlZKsZ89TsDa5fgSO8GDK9Xitnn7+Vbhr+YOlpTe8NIrg3dwHdNppESFEHVOb3fudwHPZvS7NR8zIvlvZ5iUzOZf+EeqztU58sBjbX71C9/6pVJy1Ix5sv/MbBOCY708WJ4vdLMPndHt/ynwCj6Hf2N53Epec7zFwsHa7qtHsnh0RvY2HoasS8i8JluWFdOpYvRblYf9g1YyVbfWXy/+Uv67JisW16+RU1GfbkYpzLuecojsbLBrO8k0vYuJ2XpKNQx4Sj8BuVc1tkdRZch8NqfRZQWL4uixyjS9iwjdcVY1JEvUXQ0/m9lv87OwZaZ6/yZM2IBfZsNIjQojFGzhuVa3rOUB2PmjkQizT799h/fBzcPFwa1HsawdqNxdHGg68BO+ZIvJ08Dgxk6YSbnLv1UYNt4XWxCEnM37WPdjFGc3r4YTzdnNuw/qVfmt9sP2XvyLLsXT+H4hnk0rVOVhVsP6JZ/dekqg2atJjI2Pt9yva/7la2DLVPXTmHxiCUMazGc8OBwhswcnGt595LujJgzDGkOnSDNOjalVddWeQtkaYOi5zjSD6wmdc141LERKNr3z7GoxLEYig4D9erJtFV3JHbOpK6fTNpmfyQ29si92uUtE2DjYMOY1RNYM2oFE1uNISI4nL4zDOu/dNUy+A3vwpxu05nqM4GwwFB6T+0DQLNuLXAv48FUnwlMazeRyg2q4uXbKM/ZhIJT6A1XABcXF06dOsWpU6c4ffo0hw8fZu/evTx9+hSAkydP0rZtW44cOWKw7pIlSzh16hRnzpxh4cKFBAQE8OTJE4Ny+eFaUDRV3GwpYa/tAehZ4wO+fRCq1ytyLTAKT1sLmpZ2AaBFGRdW+tUCoH/d0qzoWAupREJCWhbJGVnYmssNN/SOqjStTuDtp0QGhgPw/cHzNOjc1KBc8N1nzGkxgbSkVGQKOfZuDqS86lW1dbGnpk99Ng1anuc8r7sWHEsVFxtK2FkA0LOqB98+DtevsxexeNqa07SkEwAtSjmxsl3VfM0B4Nq8OvF/PCPlubaenu+7QPFujd+pnJmrHcXa1eGXvqvyJdO14BiquNpSwu7VPlXNk28fvVE/wTHafaqkMwAtSjuzsn113fIjf7xgkXcVnC0V+ZIJoFzT6ry8/YyYV/vUbwcvUKOzYV0pM7P4YvpukqPiAXh55xlWznaYyE0A8Brcls+n7SApMi5PeUwq1kYd/CeaqFAAsn7+BnndFoYF5QrM+08l/YuP9WfXa0nWtfNoYiMByPj2EJkX8+fvZtdrXpeHtx4R8vwlAF/u/wrvrq1zLKswUzB300y2LNyuN79C9fJc/Op7MjOy0Gg0/HTuCi06NMuXfDk58vkZunTwpm0rw/NEQbj6+32qli1BCXdXAD5s15xvfvhVbz+//zQYrxqVcHOyB6B1w9r8cP02WVlKImPiufzrH2ydOz5fc72v+1XtZrV5dOsxoYHaXGcOnKFVl5Y5llWYKZi+yZ+di3YZLCtetjg9R/fgsw2H8pRHVq4m6hdP0MRoO1qyrp1FViuHfUduilnviWSc+VRvttSjDMpbP4MyCzQalPd+Q1atYZ4yAVRvVount58QHqjNdf7gWZp2bm5Q7tndp0xoMZrUpFTkCjkOro4kvfrdJzWRojA3Q2YqQ24qRyaXkZWRledsBUldQD9FxXvRcH1TVFQUGo0GS0tLlEolX331FZMnT+b+/fsEBwfnul61atVo3749x48fL5Bc4YnpuFqb6aZdrM1IzlSSkqnUzQuKS8HRUsGCc7fpc/BnRp34DZU6++QsN5Gy8ceH+O35HgcLBbU88t5rZ+/uRFxYtG46LiwGCxsLzKzMDcqqlCpq+tRj1dUdlKtfmSvHLwOQEBnH9lFrCHsSkuc8rwtPTsfV6rU6s1KQnKkiJUulmxcUn4qjhSkLLt6nz9HfGHXqd706yy/m7g6kvozRTaeFxiK3sUD2Rj29rVx6RDy/Dt1A0uOX+ZJJWz/ZDU5t/ShJycyhfi7co8+Ra4z68n969bO1S21qFLPLlzx/sXV3ICEsuw4Sw2Ixs7FA8UZdxYdE8/jyH7rp9nP68fDCTVSvvt/9A1fy4n/6PcjGkNo5oY7L3sc18dFIzC3BTD+PWe+xZP5yFnVooP76zh4gNcFs+Bwspm/GrOfoXG9zvisXd2ciQqN001FhUVjZWGFhZWFQ1n/VZE4dPMPTB8/05t///QGt/FpgbmGGTC6jTZdWOLo65ku+nMyeOoZO7XJuXBeE8OhY3Jyyz3WuTvYkp6aTkpaum1e1fEl+u/2Q0Ejtfnfq4hWylErik5JxcbRj/czRlPkgbz33b3pf9ytndyei9fapaCxtLHPcpyasGM/Xn33L8wf6w3DMLMwI2DiNNVPWkZaS+xCDf0Ji54gm4bV6SohBYmYJCv16UnQbRdav51GHB+rNV734E1mNxmBqBiYyZDWbIrGxz1MmAKdiTkSHZueKCYvGwsYS81x+99XzacCOa3up3KAKl49fBOD745dISUhm52+fsOv6p4QHhXHz4vU8ZxMKznvRcI2MjKRz5860a9eOBg0asGHDBrZs2YKbmxvff/897u7ulCpVijZt2uTY6/q6cuXK8ezZs7eWMZYmlyHRr49RVao1XHkeSffqH3CoXxN61yrJ+JPXyVRmN0QmNqvID2O9cbc1Z9mFu3nOJZXkPOBFrcr5GuqP89eZUnsopzccY9L+OUhyWT8/5DaEyUTyep2puRIUQ/cqHhzqVZ/e1Ysz/swtMnPJb6zXb83qZVSrjSqXH3KtH+mb9RNN96qeHOrtpa2fr34nU1lw18gSSc51kNs+JTdX0HvrRBxLuvLljN0FESjn+a99J/ImvqBSobz2nWE5ExNkVeuTcWQLqasmoEmMQ9E7f3rvpLnsL2/WVZeBnVApVXxz9KxB2c+2HuH540C2f7WZ9UdWc/fGfbIy3+9en3ehzmVHf73u6lYpz6jefkxavo3eU5YikUixtbZELivARzHe0/0qt31KpVLpTXcc0AG1SsX5o+cNyk5ZM4lTn5wm6FFQnvOQy/ng9XqSebUDtRrljUsGxbK+/wJ1xAvMxyzHfNh81EEP0SiVBuXePda7/e67fv5Xhtbqz7H1h5lzYAESiYSek3qTGJvA8DoDGeU1BCs7azoO75znbAVJU0A/RcV78XDWX0MF1Go1K1as4NGjR3h5eQHaYQIdO3YEwNfXl2nTpjFp0iRMTU1z/CyJRIKZmVmOy/LKzdqcO2HxuunI5AxszOSYy7Or0dlKQUkHK6q96gFrWdaVRefvEJKQRmJ6JvbmppRwsEJuIqVTFU9WXjJuLGenyb2o6V0XADMrc14+yu6JtnNzICU+mcy0DL11nEu4Yetsx5MbDwH4+dhl+i0dgYWtJSnxyUbl+Dtu1gruRCTopiOTM7BRyDB/dSsZwNlCQUl7S6q5aR8qalnamUWXHhCSkEZpB0uDz3wXlQJ6UMynNgByawsSHmTXk1kxBzLjklGl6tdT6sto7GuX+dty+cHN2ow74X9TP5Zv1E8ZFxZdvE9IYiqlHazyLUvryT2o6K2tK4WVBRGv7VM2bg6kxieTlWZYB7bujvTbM42oJ6Hs6b0EZQHcZlPHRSErWUE3LbF1RJOSBJnZeeQN2oBcgUXAJpDJQG6KRcAm0nYsQJMQizosCE1SPABZv17AfNxSo/MMnTaIxj7aW52WVhY8fZjd2+Xk5kRiXCLpr/UmArTv2RYzcwV7z+9ELpejMDNl7/md+PefhUat5ujO42xbvBOAVp1a8PLVbeL/D4o5O3DncXYdRcbEY2NlgYVZ9t2GlNR06lYtTzfvJgDExCey9dApvYez8tv7tF8NmNofL+8GAFhYWRD4KFC3zMnNiaT4JDLeOP58enqjMFew7ewWZHI5pmambDu7hflDFlK1flU8S3vSbVgXrO2ssbS2ZPG+RcwdOO+ds2nio5AUL6ebltg4oklNgqzX6qluS+2QiolrkZho68l84lrS9y7RPrj541dkfr0PAFn1xmhiwt85B0CvKX2o26YeAObWFgQ/zG6YO7g5kpxDPbmVcMPO2Z6HNx4AcPnYRUYsG42lrRX123mxd/5ulFlKlFlKfjhxCS/fRpzZfcqofELBey8arn+RSqUEBATQpUsX9u7dS48ePfjxxx+5e/cu+/fvR6PRkJiYyPnz53WN2Tc9evSIMmXK5LgsrxqWdGLdDw8IikuhhL0lJ24F0aKMi16ZxqVcWPfDQ+5HJFDZ1ZabIbFIAA9bcy48DuNOWDzru9RBKpHwzYNQ6hV3MirLV+uP8tX6owBYO9qw4OxaXEq6ERkYTvO+PvzxneGtDjsXO4ZvmsQiX3+S45Lw6tKEl4+DC6zRCtCwuCPrfv6ToPhUSthZcOLuS1qUctYr07iEI+uu/Mn9yEQqu9hw82UcEgl42OT9AuTBqhM8WKUdc6ZwsqH15ZVYlnIj5Xk4pQe0JuzcTYN1In+4Q7UF/f62XH5o+IEj6356TFB8CiXsLDlxJ4QWpd/Yp0o4se6nxznUj+HtsLy4uP4EF9dr68rS0YbxZ1fiWNKNmMBw6vVtzcPvDOvA3NaSYUfn8r8TP3J540mD5flF9fB3FF2GInF2RxMViryJL8o71/TKpK6dovu3xMEFy5lbSV01AYCsW1cw6zyEjHNHITUJWY1GqIONH8KwZ82n7FnzKQB2jnbsu/gxnqU8CHn+ki79/fj5/C8G64zsOFb3bzdPV/Zd2sMQn5EA+PXtQKM2XswcPBdzCzN6De/B4R3HjM73vmlYszJr9h4nKDSCEu6uHD/7Ay3r19QrExkbz/B56/hyy0KsLMzZefQM7ZvWK9A7Qu/TfrV/7QH2r9U+jGbraMvO77bjXtKd0MBQOvTz5er5qwbrTPCbpPu3q6cLOy/sYEy7cQD0qdtPt8y7Zxua+jYx+q0Cqse3MO0wCIljMTQxYci9fFDe1/8dk7Zluu7fEntnLCZvIG3jVABk9b2RVapL+r7lYGqGvKkfmT8a1zA8uu4QR9dpx+zaONqy9twm3EoWIzwwDJ++7bh+/jeDdexcHJi0eSr+7SeRFJdEky7NCX4UTHJ8Es/vPqNRh8bcu3oHE5kJdb3r8/j3Rwaf8T75r79V4L1quALIZDICAgKYOHEiGo0GLy8vPv44e0D85s2bOXr0aI4N19u3b3Pu3DlOnMifhy7e5GChYEHb6vif/h9KlRpPOwsWt6vBvfB4Fp2/w9EBTXGyVLCucx2WX7hLWpYKUxMpazvVRiEzYXD9Mqy+fJ9e+39GKoGaHg6Mb1rh7zf8N5JiEvnEfxujtk9FJpcRFRTBnilbAChRrTQDV45mka8/f15/yNdbTzLtyALUKjXxEbFsG746z9t/GwcLUxa0roz/t3dQqtV42piz2LsK9yISWXT5AUd7N9DWmW91lv/wKLvO2ldHITP5+w28g4zoRG5O2kmDjycilctICYrgxnjtQzJ2NUpRe+1wLrWZ9dZy+c3BwpQF3pXx/+Y2SpUGT1tzFvtU5V5EAosu3udon4ba+ulYk+WXH2TXT4ca+V4/r0uJSeSk/056b5+IiVxGbFAEn0/R1oF7tVJ0XTmcrb6zqN+vDbbuTlRuW5fKbevq1t/bZxlp+XhBpElOIP3QRsyHzAQTGZroMNIOrkNavCxmH03QNSRyo7r7G5l2jlhMWAFSCZrYSNIPbXrrOv9UfEw8y6esYvGu+cjkMkKDwlgycQWgfehq+pqpugZqbr458i2Va1Vi/6U9SE2knD70Dd9//WO+5HsfONrZsHjCIKau3EmWUklxN2eWThrCvT8DWbB1P8c3zKOUpxtDu7ejr/9y1GoNtSuXZeaIjwo01/u6XyXEJLB26nrm7pyNTC4jLCiM1ZPXAFCuejkmr5qoa6D+GzQpCWQc34JZP38kMhnqmHDSj25C6lEGRY8xugZqbpQ3LmLyQTnMp2xAIpGS9dsFVHcMG+LvKjEmgW3+m5i6fToyUxkRQeFsmbwBgNLVyjJ65Vj8fSfz8Pp9Tm45zoKjS1ErVcRGxrJ6xDIAPl20h6GLhrPh4lbUajV3rtzm1PaCuwjPD0XpQaqCINEU5IsC/4GQkBAGDBjApUv642IGDx5MUFAQc+bMoVWr7Fd5xMTE0KpVK06ePMmCBQsIDw/HwsICiUSCubk5EyZMoGFD455WTN01+e8L/csmLsvfh6Xyw8apzn9f6F92dml8YUfIUbu5+fdqsfyybHVsYUcwML1T4t8XKgS+n+fPA1z56dKtAhhDnEfq6BeFHSFHmdsK9sLcGD2+UP19oX/Z533y9+5Nfhl85P2rq+NBhT+EYLdnv78vZIThIQcL5HPzW6H3uHp6eho0WgE++eSTHMs7Ojpy69YtAA4cOJBjGUEQBEEQhP+P/us9ru/FWwUEQRAEQRAE4e8Ueo+rIAiCIAiC8M9o/uMPZ4keV0EQBEEQBKFIED2ugiAIgiAIRcR/fYyraLgKgiAIgiAUEf/1hqsYKiAIgiAIgiAUCaLHVRAEQRAEoYgo1JfvvwdEj6sgCIIgCIJQJIgeV0EQBEEQhCJCLV6HJQiCIAiCIAjvP9Hj+rrk5MJOUCRIPD8o7AgGMqQJhR0hRxJb28KOYCCWyMKOYEBqa1HYEXKUpn7/9it19IvCjmBA6lS8sCMIeSCxfj+Pv2hVRGFHeC/9198qIBqugiAIgiAIRcR/veEqhgoIgiAIgiAIRYLocRUEQRAEQSgixOuwBEEQBEEQBKEIED2ugiAIgiAIRYR4HZYgCIIgCIIgFAGix1UQBEEQBKGIEG8VEARBEARBEIQiQPS4CoIgCIIgFBH/9bcKiIarIAiCIAhCEaH+jzddxVABQRAEQRAEoUgQPa7vSFqqGqZNuoGJDHV0CJnn90Fmul4ZebOemJSvA+mpAKjjwsn8epd2WUM/TMrXA40adUQQmRcOgEqZ51zVWtamW0AfZKZyQh4GsW/6dtKT0wzKtRzQjhb9fNBoNEQFR7B/xg6SYhJ1y+2LOTLzi2Usaj+N5Lgko/P8+PAFm8/eJFOpolwxBxZ0b4yVmalu+embTzjw8z3ddHJ6JpEJKZyb2QtLMznLv7zGvZAo1BqoVtyZmV28MJPnfXd1b12TGjN7IVXIiL//gl+n7kaZQz39k3JNPp5EWkQcN2fvy1OmH/8MY/Olu9q6crVlgV9drBRyvTJ/RiSw4tzvJKcrMZFKmNOhNpWL2bPy7B/cDI7SlYtKSsPJypzjI73zlAmgastadH61T718GMTB6Tty3Kfqd2lKm5F+aDSQlZbBsQWfEHznGTJTGT0XDKZCw6pkpKZz58JNvt5wHI3GuN4Ck/K1MPXuAzI56vAgMr7cARn6eUzb9cekSkM0ackAaKJDyTi2IbuAmQXmQxeS8cV21KHPjMqRk8atGzJu1khMTeX8+eApi6esICU51aDcpPljaePXkoQ47TEX9DSYWaMWIJPLCFg6iZoNagDwy6VrbFq8HbXauMcwfrxxm437vyAzS0n5kh4sHD8QKwtzvTKHzlzi8NeXMVPIKeVZjNkj+2BrbalbHh4VS7+AFRzfOBd7G2ujcrwrjUbDnKXrKFu6BIP79PhXtmlSuS4Kv4FIZHJUoYGkH94I6Yb7OYCsmhdm/aeQHPBh9rwajTD1+RBM5GjiIkk7sA5SjT93/qV+q3oMnjEYuamc5w+es95/A6k57FN/adi2If7rp9GtcneDZSPnj8CjpDvzBi8wOo9J2ZqYtvxQe/xFBJNx5mPIfOP4a9MHk0r10aSlAKCJCSPjiy36Zbz7InFwI+PoWqOzvM6rVX2GzRyK3FTOswfPWT1t7VvrqXHbRszcEEDHSl0AGL9oDNUbVNctd3JzJCYylmHeI/MlX0EQD2e9JxYuXEjnzp3x9fWlatWqdO7cmc6dO/P5559z+fJlKlSowN27d3XlY2NjadKkCVevXtXN++OPP2jbti1JSXk/aeTI3ApF20FknN5O+qdz0SREI2/SzaCY1L0MmV/vJv3gItIPLtI1WqWe5TGpUI/0zxaTvn8BKMyR1WqV51hWDjYMWj2G7aPXMLf1RKJfRNBtel+Dch9ULY3PCD9WdJ/DgrZTiXgeRuepvXXLG3ZrRsDxRdi7OeQpT2xyOvOP/8yafi05Na07ng5WbDx7U6+MX52yHJvYmWMTO/PZOD+crM2Z0dkLR2tzPr50C5VazbGJXTg+qTMZSiV7L9/OUyYAhYM1DdaP4KfhG/i6qT/JwZHUnNXLqHKVxnTEuUGFPGeKTclg/lc3WNPDi1Nj2+FpZ8nGi3f0yqRlKRl96CcGNazA0RFtGN60ErO++A2A6e1qcmyEN8dGeLP+w0aYykxY3LlennNZOVjTf/UYdo1ey8LWk4h+EUmX6X0MyrmULkbXWf3YMmAZy30D+HbzSUbsmAZA27FdcfBwZkm7aazoOAMbF3ua9fcxLpCFNYquY0g/vJa0jZNQx0VqG7FvkBavQMaxDaRvCyB9W4Beo9WkXC3MRy5D4uRhXIZc2DnaMX/DTAKGzaF70768DApl3OxROZatXrcqs0YtoK/3EPp6D2HWqAUA9BrSHTtHO3q1GMBHrQZRvW5VvDu1NCpPbEISczftY92MUZzevhhPN2c27D+pV+a32w/Ze/IsuxdP4fiGeTStU5WFWw/oln916SqDZq0mMjbeqAzGeBoYzNAJMzl36ad/bZsSKxvM+k4ibe9yUpaOQh0TjsJvUM5lnd1RdBkCkuyXaEqLl0XRYxRpe5aRumIs6siXKDoOyHMuWwdbpq6dwuIRSxjWYjjhweEMmTk41/LuJd0ZMWcYUqnhCz6bdWxKq655/D1jYY3CbzjpJzaStt0fdXwkpq0Mz51Sz3JkfLGV9I9nk/7xbINGq0mlBsiqNs5bltfYOtgSsG4a80csYmDzIYQFhzFi5tBcy3uU8mD03BFIpdlNn83ztjG87SiGtx3FnKHzyczIZPnEVfmW8b8sNDSUvn370q5dO0aPHk1KSopBmcjISIYOHUrnzp3p2rWrXpsuN+9Nw3X+/PmcOnWKXbt24eLiwqlTpzh16hTdu3fn5MmTtG3bliNHjujKOzg4sGTJEmbNmkVSUhLx8fH4+/uzevVqrK0LpnfApEQV1OGBaOIjAVDe+h5ZpQZvFJIhdfkAWV0fzPrPw9RvFBLrVw1BiRRM5CCTg9QEiYkMlHnvba3StDqBt58SGRgOwPcHz9Ogc1ODcsF3nzGnxQTSklKRKeTYuzmQ8qpX1dbFnpo+9dk0aHme81z98yVVPJ0o4WQLQM8GFfn296e59rR9+v1tHCzN6NGgIgC1S7kxvFUNpFIJJlIpFdwdCY1PznMut+bViPnjGcnPIwB4su8CJboZnkT/rpxLo8oUa1GdJ/sv5jnT1WcRVHG3p4Sjdp/tWbcM394N1qurq08j8LS3pGm5YgC0KF+MVd0bGHzWojM36degHBXd7PKcq1LTGgTdfkrUq33qx4PnqZfDPqXMVPLZ9B0kRsUDEHTnKTbOdpjITfigamlunr6CMiMLjUbD7fO/UcvXy6g8JmVroHr5FE2sNo/yt/PIaryRx0SGtFhJ5E38MBu7CkXvqUhsHXWLZQ3bk3FyK5qkWKMy5MareT3u//GQF89DADix70vadzPs8ZabyqlQtRz9Rvfm0IVPWPXxYlw9XAD4bOdRZo6cj0ajwdbeBmtbKxLijbsAv/r7faqWLUEJd1cAPmzXnG9++FVvn7r/NBivGpVwc7IHoHXD2vxw/TZZWUoiY+K5/OsfbJ073qjtG+vI52fo0sGbtq0M97OCYlKxNurgP9FEhQKQ9fM3yOu2MCwoV2DefyrpX3ysP7teS7KunUcTq/2dkPHtITIvnshzrtrNavPo1mNCA7W5zhw4Q6suOV/IKMwUTN/kz85FuwyWFS9bnJ6je/DZhkN5ymNSuhqq0Odo4rTnROXNi8iqNnqjkAypWwnkXr6YDV+KovsEJDbZx5/E0R15ww5k/vRFnrK8rl7zOjy69ZiXz18CcGr/aVp3bZ1jWYWZgtmbprNt4c5cP2/aqskc3/U5T+8/zbeMBUFTQD/5beHChfTp04ezZ89StWpVtm3bZlBm1apVtGzZklOnTrF27VqmTZuGSqV66+e+Nw3X3MTGxnL16lUCAgI4e/YsycnZDZgWLVrQrFkzlixZwrx58+jVqxfVq1d/y6fljcTaHnVSnG5akxSHRGEBpmbZZSztUL94SNbPJ0k/sAh12DMUnccCoH7xEHXwfcyHrcR81FpQWKC8/UOec9m7OxEXFq2bjguLwcLGAjMrc4OyKqWKmj71WHV1B+XqV+bK8csAJETGsX3UGsKehOQ5T0RCCm522bccXW0tSc7IIiUjy6BsXEo6+3+6h79fdkOsUXkPSjhrG72hcckc+vkePtVK5TmXhYcjqaHZjZbUsFhMbSyQvVFPbytn7mpHnUX9+WXcNjRG3sZ9XURiKm42FrppVxtzkjOUpGRmX9AExSbjZGnGgtM36PPxRUZ99hMqtf5p5ucnYUQkptGnfrk8ZwKwd3ckLixGNx0fFoN5DvtUbEgUdy//rpvuMWcgty/cQJWlIvCPJ9Tp2AiFhQITuQl1OzfB1tneqDxSW0c0Cdl5NIkxSMwsQJGdR2Jtj+r5XTK/O0T61gDULx6j6BugW56xfxnqF38atf23cXV3ISI0QjcdGRaFlY0VllYWeuWcXZ24ceV/bF22kz5tBnPn5n3WfZJ9oahSqhg3ayRfXjtCbFQcv/96y6g84dGxuDll3zVxdbInOTWdlLTsIU1Vy5fkt9sPCY3U1umpi1fIUiqJT0rGxdGO9TNHU+YDd6O2b6zZU8fQqV3OjY6CIrVzQh2Xfe7UxEcjMbcEM/393Kz3WDJ/OYs6NFB/fWcPkJpgNnwOFtM3Y9ZztMHwFWM4uzsRHfraEKCwaCxtLLF4Y58CmLBiPF9/9i3PHzzXz2xhRsDGaayZso60lNxvnf8TUhtHNImvH3+x2uPP9I3jL/A+mZeOkb57NuqXT1F8OFm7UK5A0XkUGad3GQytywtnd2ci9eopCqtc6mnKykmcPvg1Tx/kPESofst6uLg7c3Lvl/mWr6hJTEwkJCTE4CcxMfHvV35DVlYW169fp23btgB069aNs2fPGpTz8fHBz88PgBIlSpCRkUFq6tv31/e+4Xr69GkaN26Mp6cnVatW5dSpU3rLZ8yYwY0bN4iJiWHo0NxvEeQLSS7V9VoDRpMYTcYXm7KvTG+cR2LrjMTGCZMqjZHYOJG2cxppO6ehSYxG3vzDnD/zHUglOf/9N7Uq54bVH+evM6X2UE5vOMak/XOQ5LK+sdS59Kya5HAb6/PfHtGi8gd4OBj2kt8PiWbIjm/o1agSzSoVz3Ou3P6fmjfqKbdyEgk02j6e/80/QHpkfJ7zwFvq6rUMSpWan5+E0712KQ4Na03vemUZd/hnMpXZV6UHf/2TwY0r5FjHxpDksq/ntk+ZmisYtnUyziVd+WzGDgDO7/iSsMchTDu5lAkH5/Ls5mOUWUbeYfgnx158FBkHVqCJDgMg68pppPauSOycjdvmP/T6bcfXqd6oq9AXYUzsF0DQ0xcAHNh+GI+SHrgXL6Yrs2XZTlpW9CX0RTgzV0w1Kk9u+9TrOetWKc+o3n5MWr6N3lOWIpFIsbW2RC77jz32kNu577X9St7EF1QqlNe+MyxnYoKsan0yjmwhddUENIlxKHrnvac6931Kvyeq44AOqFUqzh89b1B2yppJnPrkNEGPgvKcJ9d60rxx/B1Zgyb21fF37Wvd8afoOBzlje/QROW9Y+R10n94nuo8wA+VUsW3R8/l+lk9hnXn0NajRo8r/zepC+hn3759tG7d2uBn3753f44jLi4OKysrZK/OKc7OzkRERBiU8/HxwdZW21G1Z88eKlWq9Ld3zd/7s9TJkycZN24cAL6+vhw8eJC+fbPHbwYFBZGVlcWzZ8+IiIjAzc2twLJokmKQumX3/Ems7NCkp4AyM3uekwdS5+KoHlzLXlEiAbUKWbnaKB/+ClkZAChv/4hpqz4Y9kP+vU6Te1HTuy4AZlbmvHwUrFtm5+ZASnwymWkZeus4l3DD1tmOJzceAvDzscv0WzoCC1tLUvLhVvxfitlZcfe1B4YiE1OxMTfF3FRuUPb8recEdDK8fXz21jOWfXmVGZ298K1Zxugs1fy74+FTBwC5lTnxD1/olpm7OZARl4zqjXpKfRmDY+2yBuVsyntg+YEztRb0A8DM2RaJiRQThZzfpunfQvynitlYcPdldu9uZGIaNmZyzE2zD01na3NKOllTzUN7261lBXcWnblBSFwKpZ1tiE3J4O7LWNb3bGTw+e+i4+QPqfZqnzL/h/sUaHtnR++ZTviTl2zovZCsVz3rlnZWXNh9mpPLtGMn63RsSFRQuFHZ1AnRyDyzvxOJtQOa1GTdsQQgcf0AE7cSKG+9Nkby1bGX30b6D6WZj3b4iKW1JU8fZN9adC7mREJcIulp+j1LZSuVoXyVsnxzIvuXp0QiQalUUqNeNeJi4gl+9gKVUsWZo9/gv3SSUdmKOTtw53F271tkTDw2VhZYmCl081JS06lbtTzdvJsAEBOfyNZDp/QezvovUMdFISuZPVZdYuuIJiUJMrP3K3mDNiBXYBGwCWQykJtiEbCJtB0L0CTEog4LQpMUD0DWrxcwH7fUqCwDpvbHy1t758nCyoLAR4G6ZU5uTiTFJ5HxxvHn09MbhbmCbWe3IJPLMTUzZdvZLcwfspCq9aviWdqTbsO6YG1njaW1JYv3LWLuwHnvnE2dEIPMPfs8LLGx1z4A+frx51IcE9cPUN65or+ySoX0gwpIHIshq98OibklEoUFit7TyDiy5p2zDJ42kEbeDQFtPT1/mL2vO7s5kRhveOy1/dAHMzMFu8/tQCaXYWpmyu5zO5gxYDYxETHYOthSqVZF5g1b8M55CoM6f/uadAYOHEjXrl0N5tvY2Lx1vW+//Zbly/WHGZYsWdKg3Ns6yT799FOOHj3KwYMH/zbne91wvX//Po8fP2bp0qUsX74clUpFZGQkv//+O7Vq1SItLY0pU6YwZ84cHjx4QEBAAJ9++mmuV6t5pQq8j2mzD5HYuaCJj0RWozmqJ3/oF9JoMG3Zm/SXT9AkRiOr0QJ1VAia5DjUkUHIytZGdf8aaNSYlKuNOsy4J5u/Wn+Ur9YfBcDa0YYFZ9fiUtKNyMBwmvf14Y/vrhusY+dix/BNk1jk609yXBJeXZrw8nFwvjZaARqWc2ft178RFJ1ACSdbTvz6kBaVPzAol5iaQXBMEjVKuOjN/+5OICu/+pXtQ9tSxdMpT1nurP6cO6s/B0DhaIPvpRVYlXIl+XkE5Qa05uX5mwbrhP1wh1rz+xqUi7n5hK/qTtCVqzq1GwoH6zy9VaBhGVfWXrhNUEwSJRytOXHzGS0q6N+ibVLWjXXf3eJ+WByVi9lzMygKkOBhr21k/PEimiruDnqNXWOcWX+MM+uPAWDlaMOcs2twLulGVGA4Tft6czuHfcrC1pLJRxdy7cT3fLNRf2xftTZ1qdaqDjuGr0JhoaDVsI5c2PmVUdlUT26haNcfiYMbmthwZPW9UT58I49Gg2mHwaiCHqKJj0JW3wd1eBCaxPwd0wqwc/Uedq7eA4C9ox1HLu+jeClPXjwPofuALvxw7meDdTRqNdMWT+SPX28T+iKMHgO78OT+UyLDovDr7Uu12lWYOmgmarWadt19uH7lf0Zla1izMmv2HicoNIIS7q4cP/sDLevX1CsTGRvP8Hnr+HLLQqwszNl59Aztm9bL97sv7zvVw99RdBmKxNkdTVQo8ia+KO9c0yuTunaK7t8SBxcsZ24ldZX2PJB16wpmnYeQce4opCYhq9EIdbBxw1H2rz3A/rXaizxbR1t2frcd95LuhAaG0qGfL1fPGz60MsFvku7frp4u7LywgzHttB09fer20y3z7tmGpr5NjH6rgOrZHRRt+iCxd0UTF4GsdmuUj9/YPzUaTH0GoHrxWHv81WmDOvIFmqRY0jZm90LLqjfFpFJ9o98q8MmafXyyRnvOtXO0Y8+FXXiU8uDl85f49e/IlXOG9TSmY/b2XT1d+eTiboa3zX6Asmq9Kjy69cigwftfY2Nj87eN1Jy0b9+e9u3b683LysqiQYMGqFQqTExMiIqKwsXFJcf1V61axQ8//MBnn332jzof3+uG68mTJ/nwww9ZuHChbt6MGTM4evQotWrVYsmSJdSqVQsfHx9atmxJ79692bt3L8OGDSuYQGlJZJz/BIXfKJDK0CREkXF2D1LXEph6DyT94CI0MaFkXj6Moss4kEjRJMeR+c1uALJ+/QZ58w8xG7QIVFmoo0LIvJi3QfMASTGJfOK/jVHbpyKTy4gKimDPFO3TnCWqlWbgytEs8vXnz+sP+XrrSaYdWYBapSY+IpZtw1fneftvcrAyZ2GPJvgfvEyWSo2nozVLPmzGvZBoFn5+hWMTOwMQHJOIs405chP9C41NZ28AGhZ+nn3lXrOEC7O6NMxTroyYRK5N3kmTXRORmspIDozk2sTt2szVS1F/7XDOes96a7n85mBpxkK/uvifuKatKwdLlnSuz73QWBaeucmxEd44WZmx/sNGLPvmf6RlqTA1kbKuZ0MUMhMAgmOTcbc1HNOVF8kxiRzw387w7VN0+9S+V/vUB9VK03flKJb7BtCsnw8O7k7UaFufGm3r69bf1GcRV49dplTNcsw5vxapiZQrhy/y+7e/GhcoJZGMk9tRfDQFiYkMdWwEGZ9vQepeGtMuo0jfFoAm8gUZX3+CWb/pIJWiSYgl4/jG/KiOt4qLiWfRpOWs3L0YuamMkMBQ5k9YAkClGhWYs2Y6fb2H8PTRc1bP2cD6/SuQmkiJDI1i1pgFAOzb8hlTF03g0MVP0KjV/PHbHbYsy/0hkrdxtLNh8YRBTF25kyylkuJuziydNIR7fwayYOt+jm+YRylPN4Z2b0df/+Wo1RpqVy7LzBEf5VeVFBma5ATSD23EfMhMMJGhiQ4j7eA6pMXLYvbRBF0DNTequ7+RaeeIxYQVIJWgiY0k/dCmPOdKiElg7dT1zN05G5lcRlhQGKsna3sny1Uvx+RVE3UN1H9FaiIZp3eh6DFBe/zFRZJxagfSYqUw7TCM9I9no4kKIePcfsw+nKI9/hJjyfhia4HGio+JZ9XUNSzcOReZXE5oUCjLJ2nfCFC+enn8V0/Ra6DmxrOUB+Ehhrex31dF4Q8QyOVy6tatyzfffIOfnx9ffvklzZo1Myj36aef8uuvv3L48OF/3GiWaIx9qWIBCQkJYcCAAZw9e5amTZuyf/9+KlTIvpXz8OFDevXqxfLly9m4cSNffPEFFhbaX9rPnj2jV69eHDhwgIoVK77ztlPXDc+3/0d+mbgpvrAjGNi0vk5hRzDw5dg7f1+oEHRZVbKwIxiYOif/H1DKq9X9CztBzpp/HFbYEQxcubyksCMYkDrlfQx6QUhf9PaGZ2Ho8UX+D13Jq5MjHf++UCHouOP9a0xeDslhrPO/bE5Jw1cB5oclgXnvSHvdy5cvmTFjBjExMRQrVox169Zha2vL4cOHiYyMZMKECdSvXx8rKyu9RuuuXbtwdXXN9XPfux5XT09PLl26BMCvvxr2d8ROZQAAeoZJREFUzlSsWJFbt7RP2/r6+uotK126NNevG97OFARBEARB+P/gveptfAsPDw8OHDhgMP+jj7Lv7hjTZnvv3yogCIIgCIIgCPAe9rgKgiAIgiAIOXv/X9hVsETDVRAEQRAEoYgoCg9nFSQxVEAQBEEQBEEoEkSPqyAIgiAIQhHx3+5vFT2ugiAIgiAIQhEhelwFQRAEQRCKiP/6w1mix1UQBEEQBEEoEkSPqyAIgiAIQhHxX3+rgGi4CoIgCIIgFBH/7WaraLjqSfrq/fsb7jEam78v9C/LOHausCMYiDHxKOwIOQpe8r/CjmAgXmNW2BEMxJ1PKOwIOfJWFC/sCAYyt60u7AhFhtm8TYUdwUCzU3MLO4KBzFshhR0hR2n/9cGcQo5Ew1UQBEEQBKGI+K+358XDWYIgCIIgCEKRIHpcBUEQBEEQigjNf3yUq+hxFQRBEARBEIoE0eMqCIIgCIJQRPzXx7iKhqsgCIIgCEIR8V9/j6sYKiAIgiAIgiAUCaLHVRAEQRAEoYj4b/e3ih5XQRAEQRAEoYgQPa6CIAiCIAhFhBjjKgiCIAiCIAhFgOhxfUemXl5YDR+ORC5H+ewZiatWoUlN1Stj5u2NRa9eAGjS00navBnlo0cgl2M9fjymtWujSUsj45dfSPn0U9Dk/eqpTqu69A0YgNxURtDDILYGbCItOc2gXPuBHWjbrz1oNIQHhbN9xhYSYhKwsrVi5NLRlKxcioy0DC4dv8A3n35tdB5ZLS/Mew8DmRxV8DNSd62GNP16MvXpgsK7M2g0/F979x0WxfH4cfx9lV4ERew9lqiJRsXeG1hQ0uya2LArCqJi72KLYomaRKOJGpXEXqLGWL7WJPYWC6BSpXeOu/39cXqCB5YDC7/MK4/Pk9ud3fuwNzvMzc4uuohQUtYuREqIA5kci69Goqz6EQCai2dJ+2m1yVmyKtPyYxr4foFCrSL6RghHvNehyeE4PdVq8SBibj3kn2/3AaAwV9FsVj+KflQeZDIiLt7lT7/1aNM0JmeyalaXIl5fIVOrSL91n/BJS9Elp+RY1nmuF+n/BhP7/Q4A5HbWFJ06HPOqFdClpBH/6+/EbdplcpasPm75Cd18eqFUq3hwM5g1PgE51qm2fV1p3as9kgQRweGs811JQnQ8AK17t6dFt9aozc24f+Uua3wCyMzINCmPeSMXbIcMQKZWo7lzj9jZ/kjPHSfL9q2x7vUlSBJSWjpxi5ajuXkbAIsWTbDp11N/7oZHEDttHrqEBJOyPK9yi49p59MNpVpJ+M0H7Bi/hvQcjtXHXRrRdHBHJElCk5rB7mkbeHTlPgqVgk7T+1G2bmUAbh+7xP65PyPpTGsbFNXqYNapLzKlCm1oEGmbv4G0nOu5skZ9zHt7keTzxbNlHzVE3fYLUKiQYiNJ3bgYUhJNyvI+Z3pVkiThN3sxFcuX4asen72V96zY8mOa+3yJUq0k8uYD9visJeMFbVXHhYOJuv2As2v0bZVMLqPdjH6Url8VgLt/XOTI7J9NzqOsXR+LHvrffdrgeySvWmDUppu174pZ284ggTbiESmr9W261djpyJ1LGMopnJzRXL9E8vxJJud5qmGr+gydMBCVmYo71+8xe+wCUpKM28+RU4bQslNzEuL0dSbkbgh+njMM661trVkd+A2zvBZw8/KtPOd6k/7rj8N66Yjrw4cPqV69Ou7u7nTp0oUOHTrw1Vdf8euvv+Lu7o67uzu1atWiTZs2uLu7M2zYMAAqV65sWN+5c2datGjBlClT0Gq1hn3HxsZSo0YNvv/+e8Prp9s0atSIRo0aGV7Hxsbi6+tLYGCgYftdu3bRuXNnOnToQKdOnVixYkW2/ec3mZ0dduPHEz9lCtF9+qANDcV60KBsZRSlSmHt6Umcjw8xAwaQvHEj9jP0J4dVz54onJ2J/vprYgYNQu7oiEWXLnnOZetgy3D/kfh7zmVEy6FEhITT27evUbny1SvgPrALEz18GN12BGFBoXQf2xOAr6YMIDUljVGth+PbxZtazT/hk5Z1TMojs7HDcrAPyUumkji2L7rIMCy6P3ecyn2AeccvSZwynESfr9GGP8T8868BUDdpg7x4KRJ9+pPoOwBl1Y9QuTQzKUtW5g42tFo0kP2DvuGn5t7Eh0TScMKXOZYtVLE4XbZMoGJHl2zL64xwR66Qs7ntRLa0nYDSXM0nwzqbnElRyA7nOV48GjmL+64DyXgQTuGxXxmVU5cvRcn1c7Fp3yTbcqcJg9GlpHG/w2CCu43BqkkdrJrXMznPUzYOtgz2H8FSzwWMazmciJBwuvn2NipXrnp5OgzswlSPCYxvO4rwoFA+H9sdgLrt69OuXwfm9JiGT+uRqM3VuPY37VjJ7e0o5OdDzIRpRHzRF+2jUOyGDsxWRlm6FHYjBvN41Hgiew8i8YdNOM6fDoCqygfYjxtJtO9UInr0JzPkIbZDvjYpy/OsHGz4zH8wPw1ZyuJW44h5EEH78d2MyhUuXwzXiT34oc98lrtN5I/lv9Fr9RgAGvRph5WDDd+0Hc+y9r6U+eQDanasb1IembUt5j1Hk/r9XJJne6KLDsesU7+cyxYpjlmXr0EmMyyTl6qI2WeepH43h5R5w9BFPsKsYx+TsrzPmV7V3aAQ+o+cwMGjJ97K+wFYOtjQ0X8QOzyXsrqlN7EhkbT0zbmtcqxYnJ6bJ1LtubaqhkcTHCsUY23b8axrP4HSLlWo4mZa2yCztcNq6HiSF04hYVQfdBGhWPR8rk0v/wFmnb4kwW84CWO/Qhf2CItu+nMsedFUEr0HkOg9gJTV/uiSk0hZt9SkLFnZO9jht2Q8EwZO4csmfQgNCWXYxEE5lq1RpzqTh8ygT5sB9GkzIFuntUFLF77fu4oyFUvnOdPbIL2h/wqKV5oq4OTkxM6dO/ntt9/Yu3cv1atX5/Dhw+zcuZOdO3dSvXp1Zs2axc6dO1mxYoVhu6frd+3axe7duzl+/DgnT540rN+zZw8tWrRg69atSJJEoUKFDNt069aNbt26GV4XKlQoW6bAwEDWrl1LQEAAe/fuZfPmzdy4cYPJkyfn06ExZla3LpqbN9E+egRAyq5dmLduna2MpNGQ4O+PLiYGAM2tW8gdHECpRFW5MmlHj0JGBkgS6SdPYt4s7x2yj5vW4s7lfwkLCgPgwKb9NHE33u+9q3cZ1tyTlMQUVGYqHIo6khir//ZZoUYF/gz8A51OR6Ymk7+OXqCBWyOT8ihr1kV77xa6cP1xyvh9J+pGrbKV0d6/TcKYXpCaDCoVcofCSElPRr/kCmRmFqBSgVKFTKlC0mSYlCWr0k1rEHnpPvFBEQBc3XiED7o0zLFsjb6tufHLce7sOZtteejZm1xYtlM/oqeTiLoahG2JwiZnsmxUm7Qrt9EEhwIQt2UPtp1aGJWz79mRhMDfSTyQ/ZenebWKJOw6AjodaDJJ/vMcNu0am5znqZpNP+be5X8Jf1KnDm86QCP3pkbl7l+9h1fzoaRmqVNJT+pUE4/m7F27k+T4JCRJ4ruJqzkZeMykPGYudci4cYvMB/o6lRS4C8v22euUpMkgds5CdNH6cy/jxi0Ujvpzz9K1Dcm79qMN03/2CWs3kLhxq0lZnlepSU0eXr5HdFA4AGc2HeZjd+NzJzNDQ+D4tSRGxQHw8Mo9rIvYo1ApOPndPjYPX44kSVgWssbc1pKUuGST8iiq1EYX8i9SlL5OaU7uQ1WnuXFBlRkWvceS9uu67IvrtkBz5hBSTCQA6ft/JuPIdpOyvM+ZXtWWHXvo0qEN7Vo2eXnhfFKuaQ3CLt8j9klb9femw3yYQ50CqNOnDZd+Oc7159oqmUKGysIMhVqFQq1EoVKiTTftypCqZl20d28a2vT0Q7swa5L9d5/23m0SRvaElGRQqZE7FEaX+NwVDaUSq+ETSF0fgBQdZVKWrFya1eXGxZs8uK/PFbhhF+08WhuVU6lVfFC9Ej09v2Tj7+uYu3Y6RUs4GdZ/0f9TZoyey+OI6DxnEt48k+a41qlTh6CgoNfaJjY2ltTUVOzt7Q3LAgMD6dmzJ2q1mjNnzrzW/gICAvDz86N0af03JGtra2bPns2ePXt49KRjmd/kTk5oo56dbLqoKOTW1sgsLZ8tCw8nI8vPYjNsGOn/+x9kZqK5fh3zFi2QWViAUol5q1b6Tm0eORYrzOPQx4bX0WGPsbK1wsLawqisNlNLvbYurD3zA9VcPuTotsMA3L54m2YeLVAoFZhbmtPAtSGFnAoZbf8q5I5F0EVHGl7rYqKQWVqDhWX2glotqjqNsF2xDWWVmmT8uR+AjD8PICUnYrtiG3ardqANf0Tm36dNypKVdXFHkkKfNUxJYTGY2VqiyuE4HZ/8I7cCTxktf3D8KnH39R0UmxKOfDygPXf2njUq96pUxQqTGf6sTmWGP0ZhY4XcKvuxipy5ioRdR422T718C9vOrUCpQGZpjnXbRiiL5L1OORQrTHSWYxUTFo3lC+pUnbb1CDizjiou1fhzmz6nc/ni2DnaMX7DZOYdWMKnY7qRkmBaZ0xZ1AltxLM6pY18cu5lOU7asAjSTj37LOxGDSH1hP7cU5YuCQoFjv4zcdq0FnvvkUZTfExlV9yB+LBnxyohLAZzW0vMnjtWcQ8fc+uPi4bXHfx6cePwX2g1+qtEukwt7cZ3Y9yfS0l6HE/QuZsm5ZHbF0YX+6w9kOIeI7OwAvPsecy7DSPjfwfQhQZl375ICZArMB/oh+X45Zh/PgTSc79EXVAzvapJY4fS+bkvSW+abTFHEkJjDK+f1il1DuffwSkbuPrrSaPll7cdJy0+mZHnAhh1fgWxwRH8e+Qfk/LICjuhe5zld1/0C9r0uo2xW70NZbWaZPyxP9tqdUs3dDHRaM4Z5zWFUwknIkKf5YoMi8La1hpL6+y5Chd15K9Tf7Ny7lp6txnA1b+vs+CH2Yb1Y3r6cPWv6/mS6W3QvaF/BcVrd1w1Gg379++ndu3aLy3r7u5Ohw4dqF+/Pr6+vvj5+fHRR/p5izdv3iQqKoo6derg6urKli1bXjlDTEwMjx49ombNmtmW29nZUbFiRa5du/Z6P9SrynLpKitJl8NHbm6O3bRpKEqUIMHfH4DkzZvJDAqi0IoVFFq0CM21a0iZps33y0ouz/lj1GlzrornDp2lX61ebF2ymckbpyOTyVg/63uQJBbtW8r4NRO5dOIimRoTs8lyqVY5HCfNhVMkDOpC2o4NWPkuAJkM80/7IiXEkeDpQfywL5BZ22DW4XPTsmSLlcvnl8txepEiNcrisWMyl9f/TtCRi6aHyuWzk3SvNuUlav5akCTKBgZQYvlkUv73D5Kpn1u2WDkfq9zq1IVD5xhcqy87lmzFd+MUZDIZSqWC6k0+YtmwhUzq5I21nTVfePc0LVAu5x455JGZm+MwZyrKUiWInb1Qv0yhwKJJA2LnLiay9yB0MbEUmjjWtCxG0V7v/FNZmNFjxSgcyxYl0HdttnUH529hxkcDiX0YRZfZJk5lyO1YZTn/VI3dQKsl88zvxuUUCpTV65G+JYCUBSOREmIx6zbCtCzvc6b3WH60VU1Ge5ASk8jST4awvP4IzO2tcRnoZlqeV/j8ntKcP0l8f3dSf1mPtZ9/ts/evMPnpO3YaFKGnMhzyfX8uRf2IByv3r6E3H0AwE+rtlKyTHGKlXLOtyzC2/NKN2dFRkbi7u4OQEZGBjVr1mTs2Jc3+jt37gRg/fr17Nixg+bNmxvW7dixg/bt26NQKHBzc2PlypU8fvyYwoVf/bJrTvNZNRrTb5J5GV1kJKqqVQ2v5YUL62/uSEvLVk7u5IT9nDloQ0KIHT1aPzUAkNvakrJ1K0mrVgFg1qKFYdrB6+rm1YO6rfXzlSxsLAm5GWxY5+jsSGJcIump6dm2cS5TDPsi9ty8cAOAo78cZvCcIVjZWWNuacaPc9aTFJ8EQFdPD8Nl4teli45AWfHZcZI5FEGXlADpz46TvGhxZPYOaG9dBSDjj/1Y9B+DzMoGVb0mpK5fBtpMSM1Ec/wgKpdmpO/d9tpZ6o39lHJt9F+y1NYWRN96YFhn7VyItLgkMp87Ti9TqXN9ms3ux/HJG7j9W95GgjNDIzGvWdnwWlm0MNq4RKRXzCS3tiRq4XfonnxuDgM+J+PJtIPX9ZlXd2q3rguApY0FITdDDOscnB1JyqFOFS3jjH2RQtx6UqeO/XKE/nMGY2VnTWxELBcOnDXc0HXytz/xGPkFptBGRKKu/qxOKYoUQRefgPTcuaco6oTjotlkBgUTNdQL0vXnnvZxNJq799HFxAKQvPsARVYuNCkLQOsxn1H1Sb0yt7Yk/NazY2Xr7EBKXBKaHD5Du+KO9P1uHJF3QlnbbRaZTy7dlvnkA5JjEnh8Pxxdppa/th+n8zTjeeqvQhcbhbLsszols3NESk6EjGd5VC6tQWWGpc8yUCpBpcbSZxmpq6chxcegCwtGSowDQHP2MBbDZz//NgU+0/umqdenfND6EwDUNhZE3XzWVtk4O5CaS53KTeX2dTk09Ud0Gi3pmlSubD9BFbd6nF2777Wz6R5HoqiU5XefQ2HjNt25hL5Nv3kF0LfploO8kFnZICUloChbERQKMq9ffO33z2qg91c0aaufNmFlbcndm/cM64o4FyY+NoG01OztQsWq5alYrQIHdmT5UiSTkZn55u6JeZMK0nzUN+G15rju3LmT/fv3M3/+/GyX/F+mX79+ODk54f9k5FGj0bB7924OHDhAy5Yt+fpr/cjCjh07Xml/Dg4OlC5dmn/+yX7ZIyYmhgcPHlC9evVXzvY60s+fR1WtGooS+rsjLTt3Jv1U9svJMhsbHL75hvQTJ4ifMcPQaQUwa9gQ2ycdfpmFBVaff07a4cMmZdmy+GfGuo1mrNtoJnTx5oNalSlWthgAbXu6cv6Q8eXrQk6FGBvgjU0hGwCadmnGg1shJMUl0q6nK92e3KhlV9ie1t3bcWLnnyZly7x8AUWlqoa7SM1ad0Jz4bnjZO+I1YgpyGxsAVA1bo3uQRBSUgLa+/+iqt9cX1ChQPlJQzLvmHYZ59yiHWxtP4mt7Sex3X0azrUqYle2KADVe7Xi/qG/X2t/Fdzq0mR6b3b1nJ/nTitA8qm/sfioCqoyxQGw7+ZG0tFX3699NzcKj9TfNKVwtMfu8/Yk7jlmUpbtizcz0c2LiW5eTOniS6VaH+D8pE616tmOvw6dM35/p0IMD/Ay1KnGXZoa6tTZ/f/DpUNDVGZqAOq0deHe5TsmZUs7ewF19aooS+nrlJVHJ/00gCxktjYUWb2E1D9OEOM3y9BpBUg9ehzzRvWR2+rrm0WLxmRcN/3O4cNLtrPcbSLL3SaysusUSn1cCcey+tEbl56tuP77X0bbWNhZMWjrZK4dOM+WEcsNnVaACg0/pMPk3sgVcmQyGR+7N+LuadPqvPbmPyjKVEZWRF+nVI3dyLySfSpWyiIvUuYNI2XBSFJXTwNNxpORzBg0l06hrFYHLPWfqfKjhuhC/jUpy/uc6X1zfPEO1rlNZJ3bRNZ3mUrxWhUp9KStqt2zFbcPGdepFwm/GkTVDvobtuRKBZXa1ObRP6adf5pL51FWqmZo09VtO6M5n71Nl9s7YD16CjIbO32Zxq3Rhtw33LugrPYxmVdNm6qQ1Vr/Hww3WA3oOJTqtatRqpw+V9c+nTlxyHiKl04n4TVzpGGE9dO+7ty9cZeosLzPsxXevrf2OCxfX1+6du1Kjx49CAkJwcHBgX37nn3zCwwMZMWKFQwaNCj3yxJZjB49mjlz5rBmzRpKlSpFcnIyfn5+uLm5Ubx48TfyM0hxcSTMn4/d9On6R4KEhhI/Zw7KypWx9fYmZsAALN3dkTs5YdakCWZNnk3mj/XyInX/flRVq+L4ww+gUJC6Zw/pf5rWOcwqPjqeAO9v8F7lq38cT3A4y8YsAaBCjYoMnT+csW6juXH+OtsDtjFz6xy0mVpiImOYN2gOADtWbmfUkjEsPbQcZDK2Lt3MHRM7GVJCHCmrF2A1ejoolfpHXa2ci6L8B1gO9CZxwkC0t66Q9tsmrCcvBa0WXexjkhf5AZC6cQUW/UZis3ADSDoyr/5N+q7NeT5OqdEJHBm7BtdvRyJXKUkIjuT3MfrHbDnVLEeLBQPY2v7Fj2dp4PslMpmMFgsGGJaFXbjNcb8NJmXSxsQTPnEJxb+ZhEylRPMgjLDxCzGrXgnnmaMI7jr8hdtHr/mFYvPHUXbXKpDJiA7YRNrV2yZlySohOp5vvZczapU3SrWKiOBwVo35BoByNSowcP4wJrp5cev8DXYGbMdv6yy0mVriImNYPGgeAL//eABrO2tm712IXC4n6Oo9vpv1g0l5dLFxxM70x2HuNGRKJZmPQomZPg9VlQ8oNGkckb0HYe3RGUVRJyyaN8ai+bMb1B4PG0faydMonIpQZPUSkMvQhkUQM9v0EdeskqMT2OH9LT1XjUKhUhITHMEvXvqrKiVqlMNj/kCWu03EpVdr7IsXplq7OlRr9+yJHd/1mMOfq3fRcUofRu6fh6TTEXThNgfnv/r0qaykpHjSfv4Gi68ngEKJ9DiM1E2LkZeqiHn3kaQsGPnC7bVXz5Fh74jlyHkglyHFRJL28zKTsrzPmd5nKdEJ7PH+lk9XjUKhVhIbHMmuMfo6VaxGOTrMH8g6t4kv3MfhGZtoO6Mvg4/46+vUqWucXrXbpDxSQhzJK+djNXa6/nFmEaGkBMxBUb4ylkO8SfQeQObNK6QGbsRm2lIknRYp5jHJ/n6GfciLlUAXGW7S++cmNjqOmWPmM2fNdFRqFQ+DQpkxSv87rUrNykxc5E2fNgO4d+s+i/2WsXDDXBQKOZFhUUweOjNfs7xNBWk+6psgk6QXP0T04cOH9OnTh6NHjW8Meap3794MHz4cF5dnj+OoXLkyt25lH9Hw8/Pj0aNHmJmZ0ahRI3r3fvZ4nYyMDFq2bMmcOXNo2rQpy5cvB2DEiGfzmHx9falXrx4eHh4AHDhwgDVr1pCRkYFWq6VDhw54enqiVJrWH4/IMpXhfTHkvu27jmDk+4Zv59mJr2PTyRIvL/QOtLF6/+5SnZ5q/q4jGFngHP+uI+RoRcT7NwduYuf8efbsf4H5lPevc7vgkzf35BtTDa33Zm5ozitX48HTd+5M6LF3HYHeZTzeyH43Bge+vNB74KU9vJIlS76w0wqwcaPxZOvnO60As2bNynUfarU626OysnZYn5o3b1621+3bt6d9+/YvzCYIgiAIgiD8/yD+cpYgCIIgCEIB8d++NcvE57gKgiAIgiAIwtsmRlwFQRAEQRAKCN1/fMxVjLgKgiAIgiAIBYIYcRUEQRAEQSgg/ut/gEB0XAVBEARBEAqI//pzXMVUAUEQBEEQBKFAECOugiAIgiAIBYS4OUsQBEEQBEEQCgAx4ioIgiAIglBAiJuzBIMh923fdQQjc8wy33UEI0P/Z/+uIxjpn6F51xFy5CdXv+sIRiZK79/Ufv8Ip3cdIUcTy4a+6whGPvvV4l1HKDCa7pz8riMY8flr5ruOYKTXJ17vOkKO9taKfdcRhDwIDQ3F29ub6OhoypUrx8KFC7GyssqxbFJSEl26dGH27Nm4uLi8cL9iqoAgCIIgCEIBoXtD//Lb9OnT6dGjBwcOHKB69eqsXLky17IzZ84kISHhlfYrOq6CIAiCIAgFhCRJb+RfQkICDx8+NPr3qh3KrDQaDefPn6ddu3YAeHh4cODAgRzL7tu3DysrKypXrvxK+xZTBQRBEARBEP7jNmzYQEBAgNHy4cOHM2LEiNfaV2xsLNbW1iiV+m5mkSJFiIiIMCoXGhrKhg0b2LBhAwMHDnylfYuOqyAIgiAIQgHxph6H1bdvX7p27Wq03Nb2xff/7N+/n7lz52ZbVrZsWaNyMpks22udTsekSZOYPHky5ubmr5xTdFwFQRAEQRD+42xtbV/aSc2Jq6srrq6u2ZZpNBpcXFzQarUoFAqioqJwcsp+E+69e/e4d+8ekyZNAiAkJAQ/Pz9mzpxJ/fr1c30/0XEVBEEQBEEoIN6/58IYU6lU1KlTh3379tGpUyd+++03mjZtmq1MxYoV+fPPPw2ve/fuzfDhw8VTBQRBEARBEIS3a+rUqfzyyy+4ublx4cIFRo8eDcDmzZv55ptvTN6vGHEVBEEQBEEoIArKHyAoUaIEGzduNFrevXv3HMvnVDYnouMqCIIgCIJQQLypm7MKCjFVQBAEQRAEQSgQxIirIAiCIAhCASFJ/+0RV9FxfU2ftKxDT58+qNRKgm8Gs8JnGalJqUblXPt2oF0vV5AkwoPDWeUbQHx0PNZ21gyePYSy1cqRnprO0W2H2bd+b54yWTWvSxGvfsjUKtJv3Sd84lJ0ycaZAIrNG0P67WBivg/UL5DLKTplCJb1agCQ9Od5ouZ/l6c8T33c8hO6+fRCqVbx4GYwa3wCcjxWbfu60rpXeyQJIoLDWee7koToeABa925Pi26tUZubcf/KXdb4BJCZkWlSHsfWtagwqTtytYqk6yHcGLMa7XN5XlSmybW1pIfHGMoGr9xNxI6TJmV5Xu2Wn9DDpw8qtYrgm0Gs8lme47Fq39eNtr1ckSSJiOBwVvuuICE6HrlcTv8Zg6hWvzoAf/9xgY2z15ucx7blJxQf3weZWkXqzSBCvJejyyEPQOlFI0m7FULkmt8AkNtYUtp/BOYVSoBcTsz2o0SuCjQ5S1bVWtSik083FGoVoTdD2Dz+W9JzyFWnS2NaDu6EJEloUjPYMW09D67cw2NqXyq4VDWUsy/qQEJkLPNdx5ucSV2/PtYDByJTqci8d4+EBQuQUlKylTFv0wbLL78EQEpLI3H5cjJv3QKVCpsRI1DXro2Umkr6//5H8vr1kA+/mOq1rMtXvl+hUqu4f+M+S7yXkpKUkmv5Bu0a4L1kHB7VPjVaN3jqIEqULc6Ur6b9v8sEULHlxzT3+RKlWknkzQfs8VlLRi71HaDjwsFE3X7A2TX7AJDJZbSb0Y/S9fV16+4fFzky++c853oRSZLwm72YiuXL8FWPz97oez1Vq+UndPfpjUqtIuRmEKtzadPb9XWjTa/2ht9/a5606WNW+eBcppihnFMpJ66fvYb/gDkmZ1LVrY9l30H68y/oHslL5yOlPnf+deyKmZs7SBK68FCSlvkjxcchs7TCapQPipKlQS4n/cgB0rZvNjmL8HYU6KkCZ8+epVatWri7u9O5c2dcXV1ZtWrVG3s/WwdbhvuPxN9zLiNaDiUiJJzevn2NypWvXgH3gV2Y6OHD6LYjCAsKpfvYngB8NWUAqSlpjGo9HN8u3tRq/gmftKxjciZFIVuKzR3DoxGzud9+EJoH4RQZ95VROXWFUpTaMBcb1ybZltu5t0RdriT3Ow7lfudhWNargU37xibnecrGwZbB/iNY6rmAcS2HExESTjff3kblylUvT4eBXZjqMYHxbUcRHhTK52P1E7frtq9Pu34dmNNjGj6tR6I2V+Pav7NJeVSONlT7ZghXvl7MmUZjSA2OoKJfj1cuY1mhGJnxSZxrNd7wL786rbYOtgz1H8lCz3mMelKvevr2MSpXvnoFOg3sgp/HeMa2HUlYUCjdxurzNfVoTvEKJRjbdiTj2o+imkt16rs1NCmP0sGW0gtHcn/wPG60GEpGSDjFc8hjVrEkFTfPpFDH7PWl2LieaMIec7PNSG53HEvhXu2xrP1qf8rvRawcbOjh78n3Q5Ywp5UX0Q8i6TzeeJK/U/lidJ7Yk9V95uLv5suh5YH0X+0FQOD0Dfi7+eLv5st3gxahSdewaWzufz/7ZWR2dtiNH0/8lClE9+mDNjQU60GDspVRlCqFtacncT4+xAwYQPLGjdjPmKH/mXr2ROHsTPTXXxMzaBByR0csunQxOc9Tdg52jF3kxcxBsxjQfCDhIeF8PcG4XXiqeNniDPIbgFwuM1rXtGMTWnZt+f8yE4Clgw0d/Qexw3Mpq1t6ExsSSUvfL3Ms61ixOD03T6Rax+yP66nh0QTHCsVY23Y869pPoLRLFaq41cuXfDm5GxRC/5ETOHj0xBt7j+fZONgyxH8Eiz3nM6blMCJCIuiRQ7tQrnoFOg7swmQPX8a1HUV4UBhfPmmnlgxZwHi3MYx3G8Ma3xUkJyTz/eQ1JmeS2dphPdqXxDmTiRvcG114KJZfDc5WRlHxA8w9viRh3DDih32FNvQhlr37A2DRuz+6x1HED/uK+NGDMXdzR1nlQ5PzvC26N/SvoCjQHVeA6tWrs3PnTnbt2sX27dvZsmULd+7ceSPv9XHTWty5/C9hQWEAHNi0nybuzYzK3bt6l2HNPUlJTEFlpsKhqCOJsYkAVKhRgT8D/0Cn05GpyeSvoxdo4NbI5ExWjWuTduU2muBQAOI278W2cwujcoV6diQ+8HcS9z/X0CnkyC3NkalV+n8qJVJ6hsl5nqrZ9GPuXf6X8CfH6vCmAzRyb2pU7v7Ve3g1H0pqlmOV9ORYNfFozt61O0mOT0KSJL6buJqTgcdMyuPQ/CMS/rlL6v1wAB5t+B3nTxu/chm7upWRtBK1A6dQ748FlPP6FHL4hWqKmk1rcffyHcOxOrTpQK71amTzITnWK7lCjpmFOUq1EpVahVKlRJOuMSmPTdNapFy6Q/qTPI83HsChi3GeIn3ciN52hNg92Tvwj6au5dGsHwBQOhVCbqZCl5j7qNqrqtKkJiGX7xIVpP98Tm36nU/cjb9kZWZksmX8GhKi4gAIuXIPmyL2KFSKbOW6zR3Ise/28uh6sMmZzOrWRXPzJtpHjwBI2bUL89ats5WRNBoS/P3RxehH6zW3biF3cAClElXlyqQdPQoZGSBJpJ88iXkz42P9umo3rc2tS7cJDdK3C3s27qFlF+N2AcDM3Izxy7z5doZxB6JUxVJ8PuQzflqa99HD9zETQLmmNQi7fI/YIP2fo/x702E+dM+5Ta7Tpw2XfjnO9T1nsy2XKWSoLMxQqFUo1EoUKiVaE8+/V7Flxx66dGhDu5ZNXl44n3zU9ONs7dTvmw7QOMc2/S6jmw/J0qY7GNqppxQqJUMXj2LDjO+IDntsciZV7bpk/nsTXaj+/EvbuxN18+znn/bObeIG9kRKSQaVGrljEXQJCQCkfLuMlO/0g11yB0dkKjVScpLJeYS3o8B3XLNKS0tDoVBgY2PzRvbvWKwwj0OfnWTRYY+xsrXCwtrCqKw2U0u9ti6sPfMD1Vw+5Oi2wwDcvnibZh4tUCgVmFua08C1IYWcCpmcSVmsCJosJ74m/DEKGyvkVtkzRcxYRcLOo0bbxwceRhufSMUTP1Lx5CY0wWEk/XHO5DxPORQrTHRotOF1TFg0li84VnXa1iPgzDqquFTjz236nM7li2PnaMf4DZOZd2AJn47pRkpCskl5zIs7kpYlT3poNEpbSxRZ8ryojEwpJ+b4Zf7pNoe/3afh0OIjSg3I/pdCTFU4h3r1omNVt60Lq898TzWXD/lj2xEAjm07SnJ8Et+e+4E159cTHhzGX0fOm5RHXbxwtjqVEfYYha0V8ufyPJyyhtjcvkhodZRZOoaqvy8n6fRV0u4+MilLVoWKOxIX9uzziQuLxsLWErPncsU8jOL6H/8YXnf1683Vw3+h1WgNy6o2/xj74o78+cP+PGWSOzmhjYoyvNZFRSG3tkZmaflsWXg4GWfOGF7bDBtG+v/+B5mZaK5fx7xFC2QWFqBUYt6qlb5Tm0dFihfmceizXFFP2ipLa0ujsiPnjWDvT/u5f+N+tuXmlub4fDOOhV6LSU3O+xeP9zETgG0xRxJCn00BSgiLwdzWEnUO59/BKRu4+qvxlZbL246TFp/MyHMBjDq/gtjgCP498o9RufwyaexQOrdv9cb2nxPHYoWJfo12qk5bF1ae+Y6qLh9y7Ek79VTLL1sTGxHD+YNnjbZ9HfIiTuiiIg2vdY+jkFtZI7N4rk5ptajqN6bQhm2oPqxJ+uF9z9bptFiPm4T9yh/QXLmI9tGDPGV6G6Q39F9BUeA7rlevXsXd3Z1OnTrRsmVL6tWrZ/RnxfKLXJ7z4dJpcx5kP3foLP1q9WLrks1M3jgdmUzG+lnfgySxaN9Sxq+ZyKUTF8nUmDZnE/Rzq3Ii6V5t4L/w8B5oYxP4t2FP7jbtg9zOGoevjf9W8evK6fIe5H6sLhw6x+BafdmxZCu+G6cgk8lQKhVUb/IRy4YtZFInb6ztrPnCu6eJgV7hOL2gTOimo9yetB4pI5PMhBRCVu+hiGtd07I8J7fPMLdjdf7QWfrX6s0vSzbjt3EaMpmMz0d3IyEmnoGf9MWz/tdY29vQcaC7iYFyGUnOJU9ugkcv4crHvVHY2+A8OudLr68XK+fzT8oll9rCjH4rRlO4rDNbfL/Ntq75124cXrULSZfHxjqXY5Xj+Wdujt20aShKlCDB3x+A5M2byQwKotCKFRRatAjNtWtImaa3B0/l1lZptdpsrzv26YBOq+XQ1kNGZb0WjmbnD7sJvmX6iPT7ngle0Ia+Rn1vMtqDlJhEln4yhOX1R2Bub43LQLf8ivhekL3m778Lh84ysFYfti3ZwsSNU7P9nXq3/p0IXL4t75lyaxNyOP80Z04S28OdlJ/XYztzYbZzN2nhbGK6uyOztsGiu/H0P+H9UuBvzqpevbrhobXJycl4enqyZs0aBg8e/JItX003rx7Uba2fq2RhY0nIzWcNpqOzI4lxiaSnpmfbxrlMMeyL2HPzwg0Ajv5ymMFzhmBlZ425pRk/zllPUrz+ckRXTw/DpRdTaEKjMK/5bP6gsmhhtHGJSM9lyo1N24ZEzFwNmkx0mkwSfj2CTfvGxHz/62tn+cyrO7Vb6ztzljYWhNwMMaxzcHYkKYdjVbSMM/ZFCnHrybE69ssR+s8ZjJWdNbERsVw4cNYw+f/kb3/iMfKL184FkP7wMXa1KxpemxVzQBObhC4l/ZXKOH/WhKTrwSRd1/9MMpkMKTP7L9zX8aVXD+o8OVbP16vcjpXzk2P1tF798csRBj2pV/Xa1+f7qWvJ1GSSqcnkz+1Hqe/WkD1rd752tozQKCxrfWB4rXJ2JDMuEd2r1qmmtUi9FUxmRAy6lDRidx7H3q3Ba+cAcB3zOdXbfAKAubUFYbeejYbYOTuQHJdERg65ChV3ZOB3PkTceURAtxnZpk1YOdhQ5uOKfDd4kUmZstJFRqKq+uxmL3nhwvrLkGlp2crJnZywnzMHbUgIsaNH66cGAHJbW1K2biXpydx8sxYtDNMOXlefsb2p30Y/99LS2pKgW0GGdYWdC+fYVrX9vA1mFmasPBCAUqVCba5m5YEApn49ner1qlOyfEk8BnTBxt4GKxsrZm6YweS+Uwp0JoCmXp/yQWt9vVLbWBB181m9snF2IDUuCc0r1neAyu3rcmjqj+g0WtI1qVzZfoIqbvU4u3bfyzd+j33u1Z06ht9/Fq/UTj3fpv/xyxEGzvHEys6apLhEyn5YDoVSwfUzV/OcTxsVgbJylvPPsTC6xARIf3b+yYuVQF7IgczrVwBI/30fVsO8kFnboKxUmcyge0gx0ZCWSsbxI6gb5n2qzpv2X3+Oa4HvuGZlZWVF69at+d///pdv+9yy+Ge2LNbPpbJztGPJweUUK1uMsKAw2vZ05fwh40sdhZwK4bV8HF6uo0iMTaRpl2Y8uBVCUlwi7gO7YGFjybop32JX2J7W3duxZIS/yfmST/6Nk+8AVGWKowkOpVB3NxKPnHn5hk+kXb+LjWsTUs5eBqUC61YupF68aVKW7Ys3s32x/o5MW0c75h9cinPZYoQHhdGqZzv+OmQ8BcHeqRDDl3sx0dWLxNhEGndpajhWZ/f/j/odGnF08+9o0jOo09aFe5dNm78c/edlKk3vjUU5Z1Lvh1OibxuiDlx45TJWVUrh1NGFy18vQq5WUvLrdoQHmn5z1tbFP7P1Sb2ydbRj0cFlhmPVtmd7zud4rBwYvXws3q6jnxyrZoQ8OVb3r96jYYdGXDt9BYVSQZ029bj9zy2TsiUev0gJv68xK1uM9KAwCvdqT3wOeXJTqGMj7F3r82DCKmRqJfYdG5F44pJJWfYv2cb+JfqRGWtHW3wPLKBIWWeigsJp1LM1V3+/YLSNpZ0VI7ZO5dz2PznwzQ6j9eXrVCbk8t0cO7yvK/38eayHDEFRogTaR4+w7NyZ9FOnspWR2djg8M03pB44QPKGDdnWmTVsiFmDBsRNmoTMwgKrzz8neetWk7L8uGgjPy7Sf4m3c7Tj299XUbxscUKDQunQy43Th04bbTOy02jD/xct6cS3h1cztP1wAHrU6WVY1+bz1jRxa/zad/C/j5kAji/ewfHF+rph6WjLwIPzKFS2KLFBEdTu2Yrbh/56rf2FXw2iagcXgk9fR65UUKlNbR7982butXibti3ezLYsbbr/wW8M7VSbnu24kEO7UMjJgZHLvRjvOobE2ESaZGnTAaq5VOfa/67kSz7N3+ex6j8UefES6EIfYe7WmYwz2c8/uYMj1j6TiR8xACkhHnXzNmiD7yMlJqBu0gJ1w6YkBywCpQp14xZoLhq3Ke8b8Tis/0e0Wi3nzp2jWrVqb2T/8dHxBHh/g/cqX5RqJeHB4SwbswSACjUqMnT+cMa6jebG+etsD9jGzK1z0GZqiYmMYd4g/eM+dqzczqglY1h6aDnIZGxdupk7JnbGALQx8YRNWEKJ5RORqZRoQsIJ9VmIefVKOM8eSZD7iBduHzFnDUUnD6HcgW9BqyP59EWi1+b9Ek5CdDzfei9n1CpvlGoVEcHhrBqj/9vE5WpUYOD8YUx08+LW+RvsDNiO39ZZaDO1xEXGsHjQPAB+//EA1nbWzN67ELlcTtDVe3z35Kaf16V5nMD1Uauo8Z0XcpWS1OBwrg1fgc1H5am6eDDnWo3PtQzA/UXbqTz3a+ofW4hMpSBy9xlCNxnPGTb1WK30XsbYVeNRqpVEBIcTMGYpAOVrVGTI/GF4u43h5vnrBAZsY9rW2eie1Cv/J/Vq/Yzv6D9jIEuPrECn03Hl1GV2mvgIqszoeELGLaPc6vHIVErSQ8IJHr0Ui5oVKT1/GLdcx7xw+0ezfqDUnCFU+X0ZSBLxB88S9f1uk7JklRSdwM/eq/lq1RgUKiXRwRFs8tJ/PqVqlKfb/EH4u/nSqFcbChUvTI12danR7tl0jhU9ZpESl0SRss7EPIzK7W1eixQXR8L8+dhNn45MpUIbGkr8nDkoK1fG1tubmAEDsHR3R+7khFmTJpg1eXYzTayXF6n796OqWhXHH34AhYLUPXtI//PPPOeKj45n0dglTP52EkqVkrDgMPzHLASgUs1KjFkwytAZfFvex0wAKdEJ7PH+lk9XjUKhVhIbHMmuMfoR8GI1ytFh/kDWuU184T4Oz9hE2xl9GXzEH0mnI+jUNU6vynudf58kRMezyns5Xqt8DL//Vjxp08vXqMDg+cMZ/6Sd+jVgO1O3zkKbqSM2Mgb/QXMN+3EuV4yoh5G5vc1rkeLjSFo6D5sJM0ClQhf2iKRFc1BUrIz1KG/iRwwg89plUrduwnbuUtBp0UVHkzhrEgAp61ZiNcwLuxX63ysZp0+QtnN7vmQT3hyZVIC77mfPnsXT05PSpUsDkJqaSo0aNZg5cyaWlsYT/l/Go4xpj1p6k+aY5X2+W36bkW72riMY6Z+mftcRcrTaPO3lhd6yie/hGb9ebnyDx/tgYtnwdx3BSJ+77+exeh81lef9Rrf85vPXzHcdwUivT7zedYQcrawe+64jGHHcm/cvlnnVomSbN7LfPx7+/kb2m98K9Iiri4sL//zz5u7cFARBEARBEN4fBbrjKgiCIAiC8F9SkB5d9SYU+MdhCYIgCIIgCP8NYsRVEARBEAShgNAV3FuT8oXouAqCIAiCIBQQ/+1uq5gqIAiCIAiCIBQQYsRVEARBEAShgPiv/+UsMeIqCIIgCIIgFAhixFUQBEEQBKGAECOugiAIgiAIglAAiBFXQRAEQRCEAkISj8MSntrgrnvXEYz0+u39GxTf7F3sXUfI0a9zE951BCMbxti/6whGasw6/64jGLkytf67jpCjNvMi33UEIwd7WbzrCEZkNpbvOkKOMi49fNcRjPT6xOtdRzCy6a/F7zpCjmxKNn/XEYykvesAiKkC71+vSBBM8D52WgVBEARByF9ixFUQBEEQBKGAkMSIqyAIgiAIgiC8/8SIqyAIgiAIQgHxX785S4y4CoIgCIIgCAWCGHEVBEEQBEEoIP7rTxUQHVdBEARBEIQCQkwVEARBEARBEIQCQIy4CoIgCIIgFBD/9akCYsRVEARBEARBKBDEiKsgCIIgCEIBIf4AgSAIgiAIgiAUAGLE9TUoqtXBrFNfZEoV2tAg0jZ/A2mpOZZV1qiPeW8vkny+eLbso4ao234BChVSbCSpGxdDSmK+ZPukZR36jO+LSq0i6GYQy72/ITUp52wALm3rM3qJF90//CLbcitbK+Zsm8dy72+4c/lOvmQ7EfSY5afvkqHVUcnRmqmtqmKtzl71/n2cxPzjt0jKyEQuk+HXogrVnGzz5f2zKt7qYz6e8AUKMxWx10M4M3YdmTkcpxeV+/TKSlLCYw1lb6zcS9Cv/zM5k7xsddSNuoJCie7xIzIO/wgZadnKqJp8hqLSJ5CeDIAuNoKMfWtBoUTV/EsUJSuDJh3tvctozuyBfPhG3rxNY7z9RqA2U3Hz2r9MGDWDpKRko3IfVK3I1Hk+2NhYo9Pp8Bs7m6uXbhjW29has2X3d/iOmsaVizeMtjfV+1SvsmrQygVP3wGozdTcuXGPuWP9SUlKMSo3fIonLTo2IzFO3waE3H3AlCEz8yWDosonqNv3RKZUoQsLJm37CkjPuT1QVKuH+ZcjSZ7a68kCJWbuA1BUqI6Unob2xgUyDm+FPN7JrKj4MeoWX4BShS4ihPQ96yAjeyZ16x4oqtZDStXXMyk6jPRfA7KXadMTmYMz6VsX5SnPU8ra9bHoMRCZSoU2+B7JqxZAavbPy6x9V8zadgYJtBGPSFm9ECkhDqux05E7l3j2Mzo5o7l+ieT5k/Kcq1bLT+ju0xuVWkXIzSBW+wTk2Ka36+tGm17tQZIIDw5nje9KEqLjGbPKB+cyxQzlnEo5cf3sNfwHzMlzttxIkoTf7MVULF+Gr3p89sbeJ6v27Vsyc+Z4zMzUXLlyE09PbxITk7KV6dnzU0aOHGB4bWdnQ4kSxahQwYXIyMeG5Vu2fEtYWARjxkx5K9lNpRNPFXgzzp49S+/evY2WHzhwAA8PDzp37kynTp1Yt24dACdOnMDd3R13d3dq1apFmzZtcHd3Z9iwYQBkZmbSuHFjZs581rB//vnnuLu707x5c+rVq2fY/tatW/n+88isbTHvOZrU7+eSPNsTXXQ4Zp365Vy2SHHMunwNMplhmbxURcw+8yT1uzmkzBuGLvIRZh375Es2WwdbRi4czbzBcxnawpPwkHD6+OacDaBY2eJ85fc1Mrks2/JPWtTBf9diSlQomS+5AGJSM5h65Dr+rjX4rVcDStpZsOx/2TvEqRotQ3f9Q9/aZdjSzYWBdcsx6dC1fMvwlJmDDQ2WDOTEwG/Y3cSbpJBIak388rXK2VQoRkZcMvvbTDL8y0unFQtrzNr2JX3vt6T9OBUp4TGqRl2NismLVyBj/1rSfppF2k+z9J1WQFXXFbmNI2mbZpD28xxkVnYoP2pmep4nHBztWbBsGsO+Gkeb+h48CH6E95QRRuXMLczZsH0Fa5dvoHPLHgQsWsvi1bMM65u3bsSvv2+kfKWyec6U1ftUr7Kyd7Bj0mIfJg2aRvemfQkNDmXIxIE5lq1R50OmDp1Fv7aD6Nd2UL51WrGyxezz4aRt9Cdl4Qh0MRGYuRq3xQAyx2KYdeibra1St/wUmX0RUpaMIXW5NzLbQqjqt89bJksbzDoNJG37N6Su8kYXF4m6pfG5Jy9ZifRfV5C2bhJp6yYZdVoVVV1QVm+UtyxZyGztsBo6nuSFU0gY1QddRCgWPQdlf8/yH2DW6UsS/IaTMPYrdGGPsOj2NQDJi6aS6D2ARO8BpKz2R5ecRMq6pXnOZeNgyxD/ESz2nM+YlsOICImgh6/x74ty1SvQcWAXJnv4Mq7tKMKDwvhybA8AlgxZwHi3MYx3G8Ma3xUkJyTz/eQ1ec6Wm7tBIfQfOYGDR0+8sfd4XuHCDqxZs5Bu3QZTs2YL7t8PYdYsX6NyP/20AxcXV1xcXGnUqBPh4VGMGTMlW6fVy8uTRo3qvbXseSG9of8Kirc6VSAiIoL58+fz3XffsWvXLrZs2cK+ffs4cuQITZo0YefOnezcuZPq1asza9Ysdu7cyYoVKwA4fvw4NWrUYP/+/aSm6r91btu2jZ07dzJy5Ehatmxp2L5y5cr5nl1RpTa6kH+RokIB0Jzch6pOc+OCKjMseo8l7dd12RfXbYHmzCGkmEgA0vf/TMaR7fmSrVbT2ty59C9hQfpsBzbuo1mXHLIBanMzvL4Zy/cz1xmt6/hVJ77xWkJMREy+5AI4ExLDh062lLG3BODz6iXYfzs823PozjyIoaSdBU3KFgagebnCzG9fPd8yPFWsWQ2iL94n8X4EAP9uOEJZj4avVa5InUpIOh2ttk3E7fAcqo/pYvQF4HUoSldDFxGMFKevF5mX/0RZxeW5QkrkRUqh/KQt5j39UHcYjMymEAByp9Jk3j4P2kxAIvPuRRSVapuc56nGLRpw+eI1gu49AOCnH7bh/pmrUbkmzesTcv8hxw6fAuDw/j8Z0f/ZL46+A7vjPWwqkeFRec6U1ftUr7Kq16wONy7d4uH9RwD8+uMu2nZtZVROpVZR6cNK9Bj8Bet/X8vsNdMoWtwpXzIoK32M7sEdpOgwADRnDqCs1cS4oEqNebdRpO9Zn22xvEQFMi+dhEwNSBKZ186hrNEgT5kU5WugDb2PFKs/pzL/OoKy+nPnnkKJ3LkMqvpumA+cjdmnI5HZOhpWyxyLo2rQgYwTv+YpS1aqmnXR3r2JLlz/eaUf2oVZk9bZymjv3SZhZE9ISQaVGrlDYXSJCdl3pFRiNXwCqesDkKLzXtc/avoxdy/fITxI/xn+vukAjd2bGpW7f/Uuo5sPITUxBZWZCoeiDiTGZr+Kp1ApGbp4FBtmfEd02GOjfeSXLTv20KVDG9q1zKGuvSGtWzflr78ucfduEABr126kW7cuL9xm3LghREVFs27dT4ZlzZo1oG3bZqxbt+kNphXyy1vtuMbGxqLRaEhL018GtbKyYt68eVSsWPGl2wYGBtKmTRtq1qzJ3r1733RUI3L7wuhin530UtxjZBZWYG6RrZx5t2Fk/O8AutCg7NsXKQFyBeYD/bAcvxzzz4fkeunudRUuXpjHWRqkx2GPsbK1wsLawqjs0HnDOPDTAYJuBBmtm95nKrf+vpkvmZ4KT0qjqLW54bWTtRlJGVqSNVrDsuC4FBwt1Uw7cp0eW8/hufMftLr8//ZnWcKRlNBow+uUsBjUtpYonztOLyonU8gJO36VP3ou4HePWRRvXpMPvm5rciaZTSF0ic++KEiJscjMLED97JjJrOzQPbiJ5tSvpP00C134fcw6DQVAG34f5Qd1QGUGcgXKKvWQWdqZnOepYsWLEvYowvA6PDQSG1sbrK2tspUrV7EMUZHRzF06hd8Ob+LHHatQKhWG9V99OZx/LlzOc57nvU/1Kiun4k5EhkYaXkeFRWFta42ltWW2coWLOvL3qX9YPW8d/doM5NrfN5j3Q/6MuMrsHZHis7RV8dHIzK3ALHs9N/PwRHP2ELrwoGzLtQ/+RflRI30dVChRftwEmW2hPGWS2zoiJTw7p6SEGGTmlqB+lklmUwht0HUyjv5C2tpJ6B7dxeyLMfqVKjPM3D1J373GaBpNXsgKO6F7/KyjqYuOQmZpDRbZPy+0WlR1G2O3ehvKajXJ+GN/ttXqlm7oYqLRnDuZL7kcixUmOvTZZxgd9hjLXNp0baaWOm1dWHnmO6q6fMixbUeyrW/5ZWtiI2I4f/BsvmTLzaSxQ+nc3vhL2ptUsmRxHj4MM7x++DAMOztbbGyscyzv6FiIUaMG4e093bCsWLGiLFw4jX79RqHV6t545vygk6Q38q+geKsd1ypVqtCqVStat27NZ599hr+/PzqdjjJlyrxwu5iYGE6dOkWrVq1wdXVly5YtbylxFrJcRtV0zyq6qrEbaLVknvnduJxCgbJ6PdK3BJCyYCRSQixm3YwvvZoWLedsuudOQtfebugytRz5JYd8b0hu54IiS+ZMnY5TwdF8+mEJfv6yHt1qlmLEnktk5HMjkttxkp57nxeVu/vzMf6avBFdRiaahBRufLufUq518hAql1MwS72SEqJJ3xmQZbTqEDK7IshsHcm8cBBddCjmX47HzGMMutB7oNPmvM/XIJfnnEv73L6VSiXNWzdiy4+BdGndix/XbeG7zctQq1V5zvAi71O9ykqey+j78+di2INwxvWZQMhd/Yj2z6u3UqJMcYqVcs57iFeoU8r67UGnI/PCUaNimmO/oot4gMXQuVgMmIou+CZSZmYeM+XSfkpZ6nlcFOlbFiLFPB0p3ou8UFFk9kUw6ziQzAu/I0U9zFsOo1gvb9ef0pw/SXx/d1J/WY+1n3+2n8m8w+ek7diYf7lyOf+er0dPXTh0loG1+rBtyRYmbpya7edy69+JwOXb8i3b+yS3802rzbkN7N+/B3v2HCIoSH/eKZVKNm4MwNt7OuHhkTluI7x/3vrNWdOnT2fo0KGcPHmSkydP8sUXX7Bw4ULats191GrXrl3Ur18fOzs7WrVqxeTJk7l+/TrVqlV7a7l1sVEoyz6bgiCzc0RKToSMdMMylUtrUJlh6bMMlEpQqbH0WUbq6mlI8THowoKREuMA0Jw9jMXw2Sbn6eHVk7pt9JeULW0sCb4ZZFjn6OxIYlwi6anp2bZp+XlrzCzMWLJ/GSq1ErW5miX7lzGz37R8nR6QlbONGVci4g2vI5PSsTVTYqF6NipXxNKMsoWsqOGsHylsUb4IM47e4GF8KuUdrIz2+Tpqen9Kibb6S+cqawvibj4wrLN0LkR6bBLa545T8qNoHGtXyLFcuU8bEXs9hLgbT/YjA12m6R1FKTEGuXNZw2uZtT1SWjJkZjxbVrgE8sIl0d7MMmIik+k7qOZWaP76Hc2JHQAoPqiDLs60Bni0ryet2unnx1rbWHHrxrM5o0WLOREXG09qSvbRrojwKO7eCeLS31cB/VSBOUumUKpMSe7+e9+kHK/iXderrAaM60fjtvrL3pbWlty7+eznLuxchITYBNJSsx+3ClXLU7FaBQ7uePYlUiaTkZnXDiL6DqCsVKVn+7V1REpJBE2WtqpOC/20plGLkCn0bZXFqEWkfT8LJAnN8V1k7N0AgLJmI6To8Dxl0sVHoyz+7JyS2RZCSk3KlknmVApF0dJkXjmVfWOtFnnpysgci6Gs1x6ZhRUyM0vMuo0jfcvCvOV6HImiUlXDa7lDYXRJCZD+7POSO5dAZu+A9uYVADL+2I/lIC9kVjZISQkoylYEhYLM6xfzlOVzr+7Uaa2fY2lhY0HIzWDDOgdnR5JyaNOLlnHGvkghbl3Q3/T4xy9HGDjHEys7a5LiEin7YTkUSgXXz1zNU7b3yZQpXnTo0AYAW1sbrl59dpWwRAlnYmLiSEnJ+WrmZ591YuzYqYbXn3xSk7JlSzF//mQAihYtgkKhwNzcjCFDxr/BnyJvCtJ81DfhrY64Hjt2jH379lG0aFE+/fRTlixZgp+fH9u3v3iuZ2BgIP/88w8tW7akc+fOyOXytz7qqr35D4oylZEVKQ7oR1czr5zJViZlkRcp84aRsmAkqaungSbjyehqDJpLp1BWqwOWNoD+CQO6kH9NzvPz4p8Y4zqSMa4j8XEfS+ValSlWVp+tfS83zh06Y7SNd2cvRrYZxhjXkczoO42MtAzGuI58Y51WgAalHLkSHk9wnP4u3e1XH9G8XJFsZRqVcSQ0IZXrkfp5Y389ikUmgxK25kb7e12X/XcYbqI62HEahWtXxKZcUQAq9WnFw0N/G20T9ueVXMvZVSlJTe9PkcllKMxVVP6qLcE7jY/1q9IGX0fhXB6ZvX5+o7JmU7R3L2UvJEmom39pmO+nrNkM3eOHSElxKMp/hLrVk7vBVWYoa7dGe/OcSVmWzltNpxbd6dSiO5+170utT2pQtnwpAHr0+5TD+/802ubPI6coWao41T/S//Kv26A2SBIPQh6ZlOFVvet6ldW6hesNN1gN6jScD2tXpWQ5/Z3mXXt34sQh45v3dDodo2cMN4ywdu3bmTs37hGVD3MQtbcvIS/9ATJH/R3lqvptybx+PluZ1IDxpC4ZTeo3Y0n9YRZoMkj9ZixSYiyKanUx8/DUF1Sbo2rSCc3F43nLdO8KihIVkRXSn1PK2q3IvP3cuSdJqNv2QWav/xyVn7RGF/kAKTGG1G9GGG7Y0vy5A+2DW3nutAJoLp1HWama4ckA6rad0ZzP3nGW2ztgPXoKMhv9FyB149ZoQ+4jJenrlbLax2Re/SfPWbYt3my4mcqvy3gq1aqMc1n9Z9imZzsuHDI+rws5OTAqYCw2hfS/V5p0acqDWyEkPXlSRTWX6lz735U8Z3ufzJix2HCjVdOm7tSrV4sKFcoCMHBgL/bsOZTjdvb2dlSoUJbTp/8yLDt79m8qVqxv2N+6dT+xffvu97rTWpCEhobSs2dP2rdvz5AhQ0hONn4qTUZGBrNmzaJLly506NCBkydfPt3mrY64mpubM3PmTGrWrEnJkiWRJIk7d+5QtWrVXLe5du0a4eHhHD9+HHNz/S+cs2fP4unpiY+PD9bWOc9lyW9SUjxpP3+DxdcTQKFEehxG6qbFyEtVxLz7SFIWjHzh9tqr58iwd8Ry5DyQy5BiIkn7eVm+ZIuPjmfZuG8Yv3oCSpWS8JAwlo5eDEDFmhUZNl/fwX0XHCzVTGtVDe/9V8jU6Shpa8HMNh9yLSKBGX/cYGs3FwpbmbHYrSZz/7xFqkaLWiFnkWtNzLLMlcwP6dEJnBmzhiZrRiJXK0kKiuR/o1brc9Ysh8uiAexvM+mF5a4s/pW6s/vS4eg8ZEoFIXvOcffnY6aHSk0k/fcNmHUYpK9XcVGkH/wBuVMZ1G16k/bTLKToUDKObcWs8zCQy5ESY8nYr7+5TnvtFArnspj3ngoyOZlXT6C9Y9wZf13Rj2MZP3IaAd/76x/HE/SQcUP1oxI1Pq7KnCVT6NSiO48jo/HsM5bpC3yxtLQgI0PDkH7jyEjPeMk75M37VK+yiouOY46XP7PWTEOlUvIoOJSZo+YBUKXmB/guHEe/toO4fyuIJZOXs2D9bOQKOVFhUUwbOusle381UnI86dsCMO/ljUypRBcdTtrWZchLVMDss6GkfjP2hdtnXjiConQlLLyWIpPJ0Zw7jPbK6byFSkkgffcazD4biUyhRBcbSfrO1ciLlUPdYQBp6yYhRT0k/eCPmH/hpa/nCTGk/7oib+/7ElJCHMkr52M1drr+MYcRoaQEzEFRvjKWQ7xJ9B5A5s0rpAZuxGbaUiSdFinmMcn+foZ9yIuVQBeZtxHp5yVEx7PKezleq3xQqpWEB4ezYsw3AJSvUYHB84cz3m0MN89f59eA7UzdOgttpo7YyBj8B8017Me5XDGiHv7/vQQeFRXNoEHj2Lx5NWq1inv3QujffzQAtWvXZNWq+bi46G8qrVChDOHhkflyVeNdKyjzUadPn06PHj3o0KEDK1asYOXKlXh7e2crs27dOmJjY/n111+5c+cOX3/9NcePH899Gg8gk6Q3cwTOnj1Lv379DJ1NgE6dOlGrVi2+++47NBoNAE2aNMHHxwe1Wm0o17t3b4YPH46LiwszZ85EpVLh65v9ERceHh58/vnndO/encDAQM6dO8e8efPylDlxZMc8bf8m9PrtXScwttm79LuOYOTXuQkvL/QOdPXJv0vS+aXGrPMvL/SWXZla/11HyFGbefl7s2J+ONjL/l1HMCKzsXx5oXcg41L+zonND57n7N91BCOb/lr8riPkyKZk83cdwUhaWsi7jkClIp+8kf3+dfcPEhKMf5fa2tpia/t6z7/WaDS4uLhw7tw5lEolYWFh9OrViyNHst882KlTJ/z9/alSpQoAd+7coXz58rneZwFvcMTVxcWFGzdyfth4167Gz6nMauPGZ5PcJ0+enGOZwMBAw/97eHjg4eFhQkpBEARBEARhw4YNBAQEGC0fPnw4I0a83s3ksbGxWFtbo1Tqu5lFihQhIiLCqFxwcDDnz59n4sSJqFQqxowZ89InTYm/nCUIgiAIglBAvKmpAn379s1xYPFlo6379+9n7ty52ZaVLVvWqFxOl/+1Wi3h4eHs2LGDW7duMWDAAPbv34+NjU2u7yc6roIgCIIgCP9xpkwJAHB1dcXVNfsfqHk6VUCr1aJQKIiKisLJyfiPrBQuXJgOHTogk8moUqUKzs7O3L9/n5o1a+b6fm/1qQKCIAiCIAiC6QrCn3xVqVTUqVOHffv2AfDbb7/RtKnxX39r0aKFocyDBw8ICwujXLlyL9y36LgKgiAIgiAI+Wrq1Kn88ssvuLm5ceHCBUaPHg3A5s2b+eYb/VMyxo0bR2RkJB06dMDT05NZs2a9cJoAiKkCgiAIgiAIBYYkFYw/TVuiRIlsN9s/1b17d8P/W1tbs2DBgtfar+i4CoIgCIIgFBA68ZezBEEQBEEQBOH9J0ZcBUEQBEEQCog39HejCgwx4ioIgiAIgiAUCGLENYu+O9+/fvz6uu/fnzJtP+/Wu45gTAZrrMzedQojny2OedcRjFxd2eVdRzDSx/uvdx0hR1uK5/73st+Vr7Zo33UEI4+1xn8R532Q+h7ew7K3Vuy7jmDkffzTqgCJD4+96wjvJTHHVRD+H3gfO62CIAiCIOQvMeIqCIIgCIJQQPzX57iKjqsgCIIgCEIBofuPd1zFVAFBEARBEAShQBAjroIgCIIgCAWEJG7OEgRBEARBEIT3nxhxFQRBEARBKCD+6zdniRFXQRAEQRAEoUAQI66CIAiCIAgFxH/9DxCIjqsgCIIgCEIBIaYKCIIgCIIgCEIBIEZcBUEQBEEQCoj/+h8gEB3X1/RJyzr09OmDSq0k+GYwK3yWkZqUalTOtW8H2vVyBUkiPDicVb4BxEfHY21nzeDZQyhbrRzpqekc3XaYfev35imTsnZ9LHoNRKZUoQ2+R/LKBZCakq2MmWtXzNp1Bgm04Y9IWbUQKSFOv66dO+rWHZCpzci8e5uUlQsgU5OnTAD1W7kw2HcAKjMVd2/cY/7YhaQkpeRavnG7Rkz6ZjyuVTobln3l1YeWnZuj1eq4feVfFo5fTEa66dmsmteliFc/ZGoV6bfuEz5xKbpk488PoNi8MaTfDibm+0D9ArmcolOGYFmvBgBJf54nav53JmfJqm7LuvQb3w+VWsX9m/dZ6r00x3r1VIO2DRi7ZCyfffgZAEqVEs8ZnlSvVx2AC39c4Ps536PT6fKc7fitRyz//SIZmVoqORdiWpf6WJurDOt3/3OPjf+7aXidlJZBZEIKB7274mhtkef3z6p2y0/o4dMHlVpF8M0gVvksz/E4te/rRtterkiSRERwOKt9V5AQHY9cLqf/jEFUq68/Tn//cYGNs9fnKZN5Ixfshg1Aplah+fceMbMWIiVnr+eWrq2x6fUFICGlpRO7MADNjdsAFP1xFTIzM6Qn51zK/iMkbvolT5ng/TxW9VvWY8CE/qjUKu7duI//uEUvbBMatWvIhKU+dKzaBYARM4ZS06WmYX1hZ0eiI2MY0GawyZkatqrP0AkDUZmpuHP9HrPHLsgx08gpQ2jZqTkJcYkAhNwNwc9zhmG9ta01qwO/YZbXAm5evmVyHgBV3fpY9h2ETKUiM+geyUvnIz3Xppt37IqZmztIErrwUJKW+SPFxyGztMJqlA+KkqVBLif9yAHStm/OU56n2rdvycyZ4zEzU3Plyk08Pb1JTEzKVqZnz08ZOXKA4bWdnQ0lShSjQgUXIiMfG5Zv2fItYWERjBkzJV+yvYgkSfjNXkzF8mX4qsdnb/z9hDfrjU4VePjwIZUrV2bKlOwV88aNG1SuXJnAwEBatmyJm5sb7u7uhn8TJkwAwNfXl+bNm+Pu7k6nTp3o1KkTv/76KwCnT5+mffv2Ru8ZEBDA3Llz38jPY+tgy3D/kfh7zmVEy6FEhITT27evUbny1SvgPrALEz18GN12BGFBoXQf2xOAr6YMIDUljVGth+PbxZtazT/hk5Z1TM4ks7XDavh4kv2nkDCyD7qIUCx6DcpWRlH+A8w6f0nCxOEkjPkKXdgjLLp/DYDKpQlmbh4kTR9Lwuh+yMzUmHX63OQ8T9k52DFhsTeTB02jV9N+hAWHMXjigFzLlyxXgqGTByOTP6uSHzf4iJbuLejf3pN+rQZgaW2Jx1ddTc6kKGRLsbljeDRiNvfbD0LzIJwi474yKqeuUIpSG+Zi49ok+8/k3hJ1uZLc7ziU+52HYVmvBjbtG5uc5ylbB1vGLBzD7MGzGdRiEOEh4Xzla5zrqeJli9Pfrz8yucywrFPfTtg52DGk9RCGth1K1U+q0qRjk1z38apiktOY+utpFnZvws7RnSlZyJpvfv8nW5lOtcrzyzA3fhnmxk+e7SlsY4Fvx7r53mm1dbBlqP9IFnrOY9ST86+nbx+jcuWrV6DTwC74eYxnbNuRhAWF0m1sDwCaejSneIUSjG07knHtR1HNpTr13RqanElub4fDFG+ix08j/LN+ZD4Kw3549nquLFMS+5GDiBrpS0TPwSR8t4nCC6YBIDM3R1myOOE9BhLRczARPQfnS6f1fTxWdg52+Cwex9RBM+jb7GvCQsIYNKF/ruVLlCvBkMmDkGdpE5ZPWcnAdp4MbOeJX/+pZKRnMHfUApMz2TvY4bdkPBMGTuHLJn0IDQll2MRBOZatUac6k4fMoE+bAfRpMyBbp7VBSxe+37uKMhVLm5zlKZmtHdajfUmcM5m4wb3RhYdi+VX2jrmi4geYe3xJwrhhxA/7Cm3oQyx764+lRe/+6B5HET/sK+JHD8bczR1llQ/znKtwYQfWrFlIt26DqVmzBffvhzBrlq9RuZ9+2oGLiysuLq40atSJ8PAoxoyZkq3T6uXlSaNG9fKc6VXcDQqh/8gJHDx64q2839sgSdIb+VdQvPE5rvb29pw4cQKtVmtYtm/fPhwcHAyv16xZw86dOw3/snY8R44cyc6dO9m9ezcrV65k8eLF/O9//6N+/fpkZGRw9erVbO+3a9cuPv300zfys3zctBZ3Lv9LWFAYAAc27aeJezOjcveu3mVYc09SElNQmalwKOpIYqz+W3qFGhX4M/APdDodmZpM/jp6gQZujUzOpPqoLto7N9GFPQIg/eAuzJq0zlZGe+82CcN7QkoyqNTIHQujS0wAQN28HWm7fkFKSgRJIuXbxWT8ecjkPE/Va1aHm5du8fC+PtdvP+6iTddWOZY1MzfDb9kEVkxflW25XCFHbabGzNwMpUqJ2kxNRnqGyZmsGtcm7cptNMGhAMRt3ott5xZG5Qr17Eh84O8k7n+uoVPIkVuaI1Or9P9USqQ85HmqdtPa3L50m9Agfa69G/fSootxLtAfK+9vvFk7c2225b+u+5V5w+YhSRK2hWyxsrUi8cnIUF6cvhPGhyUcKeNoC8Dn9Sqx/1JQro3c+hPXcLAy57O6lfL83s+r2bQWdy/fIfzJ+Xdo04Fcz7+RzYfkeP7JFXLMLMxRqpWo1CqUKiWaPIzgm9evQ8b1W2Q+0NfzpB27sGyfvZ5LGRpiZi1CFx0DQMaN2ygcHUCpRP1hFXQpqRRZOoeim9diP2YIMjO1yXmeeh+PVd1mn3Dr0m0ePWkTdv64m1YvaBMmLRvPyunf5rq/cQvGsG3NDu5ev2tyJpdmdblx8SYPnmQK3LCLdh6tjcqp1Co+qF6Jnp5fsvH3dcxdO52iJZwM67/o/ykzRs/lcUS0yVkM71W7Lpn/3kQXqs+Utncn6ubPtel3bhM3sCeSoU0vgi5B36anfLuMlO/0bancwRGZSo2UnH1U1BStWzflr78ucfduEABr126kW7cuL9xm3LghREVFs27dT4ZlzZo1oG3bZqxbtynPmV7Flh176NKhDe1a5v2LvPB+eOMdVysrK6pWrcr58+cNy06dOkXDhq//zb1UqVL06dOHn3/+GZlMRteuXdmzZ49h/d9//42dnR0ffPBBvmR/nmOxwjwOffatMTrsMVa2VljkMLKkzdRSr60La8/8QDWXDzm67TAAty/epplHCxRKBeaW5jRwbUghp0ImZ5IVdkL3OMrwWhcdhczKGiwsnwukRVWvMXZrtqGsWpOMP/YDoChWErmdPdZ+C7BZ/B3mX/TLl0bOqXgRIkOf5YoKi8La1hpLa0ujsuMWjGHXpj3cvXEv2/K/T/7DheN/se3cZn77ZxvWdtbs2rTHaPtXpSxWBE3Ys89PE/4YhY0Vcqvsn1/EjFUk7DxqtH184GG08YlUPPEjFU9uQhMcRtIf50zO81SR4kV4nCXX4xfUqxHzRrDvp33cv3HfaJ02U0s/3358d+I74h7Hce3ctTxni4hPwdnu2WdW1NaSpHQNyemZRmVjk9P48dRNvN0+yfP75qRwDuef5QvOv7ptXVh95nuquXzIH9uOAHBs21GS45P49twPrDm/nvDgMP46ct5o+1elKFoEbcSzeq6NjEJubY3M6tkx04ZFkHbqrOG1/ZghpB4/DZmZyKwsSP/rIo99pxPRdygKZyfshuV+ZeJVvY/HqkiObYJVjm2C1/zR7N6016hNeKpei7o4FS9C4Pe/mZwHwKmEExFZMkXm0k4VLurIX6f+ZuXctfRuM4Crf19nwQ+zDevH9PTh6l/X85TlKXkRJ3RRkYbXusdRyK2skeXUptdvTKEN21B9WJP0w/uerdNpsR43CfuVP6C5chHtowd5zlWyZHEePgwzvH74MAw7O1tsbKxzLO/oWIhRowbh7T3dsKxYsaIsXDiNfv1GodXmfRrTq5g0diid2+f8Bamg0iG9kX8FxVt5qoCrqysHDx4E4PLly1SuXBmV6tkcuUGDBmWbKrBjx45c9/XBBx9w756+MevatSv79+83zOP77bff3thoK5DtklVWulxOwHOHztKvVi+2LtnM5I3TkclkrJ/1PUgSi/YtZfyaiVw6cZFMjXEn4FXJZLKcV+Qwt1Fz7iTxX7mT+st6rCf7g0wGSiXKj+qQtGgaiT6DkdvYYtEj7784Za94rLr07Yw2U8u+rQeMyrp92Z5ipZ3pWutzutb+grCQMIZN8cxDppyPlfSK80ALD++BNjaBfxv25G7TPsjtrHH42vSpC4ZcuXyGzx+rDr07oM3U8vsvv+e6r/Xz1vNFjS+IeBjBsDnD8pwtt5sAFDkcyx0X7tC8aklKFMr5F1le5fb55Xb+nT90lv61evPLks34bZyGTCbj89HdSIiJZ+AnffGs/zXW9jZ0HOiel1A5L88hk8zcHMe5U1CWLE7MrIUApB0/TczUefo5sRkaEn74GYvmeZ9+8j4eK3kux+r5TO59OqHN1LJ/68Fc9/XZgE/5ecXWPM/hlr/iuRf2IByv3r6E3NV3AH9atZWSZYpTrJRznt4/J7JcjlNO7ZTmzElie7iT8vN6bGcu1LfpTyQtnE1Md3dk1jZYdDee0va65LnUqaxXU7Pq378He/YcIihIf8yUSiUbNwbg7T2d8PDIHLcRXs1/farAW7k5q0WLFixduhSdTsf+/ftxdXVl375n3w7XrFlDyZIlX3l/5ubmAJQsWZKyZcty7tw5ateuzbFjx/Dx8cnX7N28elC3tX4ujoWNJSE3gw3rHJ0dSYxLJD01Pds2zmWKYV/EnpsXbgBw9JfDDJ4zBCs7a8wtzfhxznqS4vWjml09PQyX80yhexyJolJVw2vDNID0tGfLnEsgs3dAe/MKABlH92M5yAuZlQ26mMdozp4w3MyV/ufvWHxuPBfuVXw9rh+N2jYAwMrakns3n40KFnYuTEJsAmmpadm2cf28HWYWZnx36FtUKhVm5mq+O/QtPr0n0tStCb8HHiH1yc1Tu3/ay+hZI0zKBqAJjcK8ZmXDa2XRwmjjEpGe+/xyY9O2IREzV4MmE50mk4Rfj2DTvjEx3//62ll6efXCpY0LAJY2lgTdDDKsK+xcOMd61frz1phZmLF8/3JUahVqczXL9y9nar+pOJdyJj46nkf3H6HN1HJ422GGzBjy2rmeV8zOiqsPn13+jExMwdZCjYXauOk4dCUYnw6mz9fOyZdePajTui5gfP45ODuSlOP554x9kUKG8++PX44w6Mn5V699fb6fupZMTSaZmkz+3H6U+m4N2bN2p0n5tBGRmFWvYnitKFIYbXwCUlr2eq4o6kThxbPIDAohashYwxQT8yYNkJKSSP9Hf24ikyFlmvZF9n08Vl+N60vDNvo2wdLakvtZ2oQizoVJiDNuE9p90RZzczPWHlytnyJkrmbtwdX49plEdEQ0dg52VK1VhSkDpr3W8XlqoPdXNGmrn55lZW3J3ZvPRnWLOBcmPod2qmLV8lSsVoEDO7J8aZTJyMzMudOWF9qoCJSVX9KmFyuBvJADmdf19Sb9931YDfNCZm2DslJlMoPuIcVEQ1oqGcePoG5oPE3kVUyZ4kWHDm0AsLW14erVZzdhlijhTExMHCkpOd9E+tlnnRg7dqrh9Sef1KRs2VLMnz8ZgKJFi6BQKDA3N2PIkPEm5RP+m95Kx9Xa2poqVarw119/cebMGcaOHZut4/o6bt26RYUKFQyvPTw82LNnDwkJCdSvXx9r6/wd7dmy+Ge2LP4ZADtHO5YcXE6xssUICwqjbU9Xzh86a7RNIadCeC0fh5frKBJjE2napRkPboWQFJeI+8AuWNhYsm7Kt9gVtqd193YsGeFvcj7NxfNY9B2CvFgJdGGPULftjOb8qWxl5IUcsBozhYSxA5AS41E3aY32wX2kpAQ0p/9E1bAF6Yf3QEYG6nqNybxr2h2x3y9cz/cL1wNg72jP+iPrKFmuBA/vP8K9dydOHvqf0TaDOz4bFXQuWZT1R7+jf1v9jQi3r/xLU7cmHNrxO1qtjqaujbn+9w2TsgEkn/wbJ98BqMoURxMcSqHubiQeOfPK26ddv4uNaxNSzl4GpQLrVi6kXrz58g1zsGnxJjYt1s/xsnO0Y+WhlRQvW5zQoFDcerlx5pBxrjGdxxj+36mkE6t+X8UIV31Hvt2X7ahcqzIzBsxA0km06NqCS/+7ZFK2rBpULMaiA38THJ1AGUdbtp/7l+ZVjL9kJqSmExKTyEeli+T5PbPauvhntj45/2wd7Vh0cBnOZYsRHhRG257tOX/IeKqGvZMDo5ePxdt1NImxiTTu0oyQJ+ff/av3aNihEddOX0GhVFCnTT1u/2P6HeBpZy5gP8oTZakSZD54hPWnnUg7nr2ey21tcPp2Mcl7DpKwbmO2dQqnwlj170XU4DFImkxsenxG6u/HTMryPh6rHxZu4IeFG/Tv5WjPd4fXUKJcCR7df0Sn3h05dfC00TZDOz77clq0ZFF+OLKWge2eXWmpXvdDbl26ZdS5fFVr/X9grf8PABRytOeno99TqlwJHtx/RNc+nTlx6JTRNjqdhNfMkVw6d4WwB+F82teduzfuEhUWZVQ2rzR/n8eq/1DkxUugC32EuVtnMs4816Y7OGLtM5n4EQOQEuJRN2+DNvg+UmIC6iYtUDdsSnLAIlCqUDdugebiBZOyzJixmBkzFgNQpIgjFy4cokKFsty9G8TAgb3Ysyfn+yHs7e2oUKEsp0//ZVh29uzfVKxY3/Daz28Mjo6F3spTBf6/EY/DektcXV1ZtGgR1atXR6k07W2DgoL4+eefWbx4sWFZu3btWL58OQkJCfTq1Su/4uYoPjqeAO9v8F7li1KtJDw4nGVjlgBQoUZFhs4fzli30dw4f53tAduYuXUO2kwtMZExzBs0B4AdK7czaskYlh5aDjIZW5du5s7lOyZnkhLiSF4xH6tx0/WPwwoPJWX5HBQVKmM5xJvEcQPIvHGF1B0bsZmxFEmrRYp9TPJ8PwDSD+5EZm2L7YI1IJejvf8vKatX5vlYxUXHMc9rATPWTEWlUvIoOIzZo+YBULnmB/gsHGvooOZm0/KfGDZ1CD8e+wFNegZ3rt9jyaRlJmfSxsQTNmEJJZZPRKZSogkJJ9RnIebVK+E8eyRB7i8ezY2Ys4aik4dQ7sC3oNWRfPoi0Wu3mZznqfjoeJaMW8LE1RNRqpSEh4SzcLT+UnKlmpUYOX+koYOam22rtjFo6iBWHFyBpJO4dv4a6+etz3M2B2tzpnvUx3vzCTRaHSUdrJn1aUOuPYpm+m9n+WWYGwAh0UkUsbFApXhzs48SouNZ6b2MsavGo1QriQgOJ2DMUgDK16jIkPnD8HYbw83z1wkM2Ma0rbPRPTn//J+cf+tnfEf/GQNZemQFOp2OK6cus3NVoMmZdLFxxMxYgOO8qchUSjIfhhEzbR6qqh/g4DeWiJ6Dsfq0EwpnJyxaNMaixbNpAFFDvUkO3IOyRDGKblwNCgXpf10k/rnOrSnex2MVFx3HgrELmf7tZJQqFaHBocwdrX8iwAc1P8Db3ytbBzU3JcuVIPxhhMk5soqNjmPmmPnMWTMdlVrFw6BQZozS//xValZm4iJv+rQZwL1b91nst4yFG+aiUMiJDIti8tCZ+ZLheVJ8HElL52EzYQaoVOjCHpG0aA6KipWxHuVN/IgBZF67TOrWTdjOXQo6LbroaBJnTQIgZd1KrIZ5YbdC3znPOH2CtJ3b85wrKiqaQYPGsXnzatRqFffuhdC//2gAateuyapV83FxcQWgQoUyhIdHkmni1QNBeBGZ9AYnNjx8+JA+ffpw9OhRkpOTadiwIatXr6ZBgwb4+vpSr149AgICMDc3zzbn1cLCgi1btuDr68uZM2ews7NDJpOhUCgYMGAArq6u2d5nypQpnD17lgMHDuQ+5/MVeJTp/PJCb9l3dRLedQQj7mcU7zqCkTVWZu86Qo68TBsUeqN2LKz/8kJvWR/vv15e6B1Y7JT3GxXzm1fkm5lDnBePtbk/i/VdStXl/XnU+W1vrfdvtKzEEeObPd8HiQ+PvesIRlSFy7/rCFhZln0j+01OCXoj+81vb3TEtWTJkhw9qr8728rKikuXnl26nDdPP/rm4eGR6/ZPy7zMjBkzXl5IEARBEARBKNDEX84SBEEQBEEoIP7rc1zfyuOwBEEQBEEQBCGvxIirIAiCIAhCAVGQnrn6JoiOqyAIgiAIQgEhFaC/cvUmiKkCgiAIgiAIQoEgRlwFQRAEQRAKiP/6VAEx4ioIgiAIgiAUCGLEVRAEQRAEoYAQI66CIAiCIAiCUACIEVdBEARBEIQC4r893goy6b8+5iwIgiAIgiAUCGKqgCAIgiAIglAgiI6rIAiCIAiCUCCIjqsgCIIgCIJQIIiOqyAIgiAIglAgiI6rIAiCIAiCUCCIjqsgCIIgCIJQIIiOqyAIgiAIglAgiI6rIAiCIAiCUCCIjqsgCIIgCIJQIIiOqyAIgiAIglAgiI6rIAiCIAiCUCCIjqsgCIIgCIJQIIiOqyAIgiAIglAgKN91gIIgKSmJRYsWcf78eRQKBba2tvj6+mJnZ0f79u2pUKECADqdjuTkZLp06cLIkSMBqFy5Mrdu3eLhw4e0atWKL7/8khkzZhj2fePGDbp06cLcuXPx8PDIc9YLFy4wc+bMbMtu377NiBEj2LBhA3v37qVw4cIAPHz4kD59+nD06FGT3+/5n+/777+nUaNGhvUtW7bkxx9/BMh2rNLS0qhcuTJTpkyhcOHCuWZ5un+An376iV9++QVJkpDJZHz11Vd06dLlhfle9Nm97P0A/vjjDzw9PdmxYwfVq1c3LL958yZz5swhLi4OrVbLxx9/zKRJk7C0tHyt4/ey41aoUCEWLlzIyZMnsbCwwNramhEjRtCgQQMkSaJfv37UqVOHESNGABAXF8cXX3zB4sWLs+XNi4cPH+Zazz08PN5Kvc7q9u3bdOrUiWXLltGuXTvD8tOnT7NixQqioqLQ6XRUrVqViRMn4uzsbPQzPPXFF1/Qs2fPfMn1/Hs8X8ez1q0DBw6wZs0aMjMzkSQJd3d3BgwY8EZy5NQu5XYMe/fuTXh4OJaWlmi1WtRqNaNGjaJZs2Z5zjV9+nT+/vtvNBoNISEhhnx9+vTBwcHB6DyLiYmhc+fO+Pv706BBAwAuXrzI+PHj2b59OzY2Ni/82WUyGRqNBicnJzp37sz69esBCAkJoXDhwlhaWlKyZElWrFhB5cqVqVKlCgCSJJGYmEiTJk2YOnUqCoUCgNjYWJo2bcqYMWP4+uuviY2NpV+/fgA8fvwYwNC2rl+/nvnz51OvXj1D/d+1axfr1q1Dq9Uil8tp3749np6ehv2/qrNnz+Lp6Unp0qWRJAmNRkPnzp0ZMmTIa+3nZe8REBDAxo0bsy3Prd6eOHGChQsXAjkf38zMTJo3b067du2YPHkyAJ9//jkZGRnEx8eTkpJCsWLFAFiwYAGVK1fOMder/B4NCAjA3NwclUplWF+tWjXmzp2Lr68vZ86cwc7ODp1OB8DXX39N165dOX36NNOnT+fAgQPZ3jMgIIDExEQmTJiQx6Mq5BtJeCGtVit169ZNWrJkiaTRaCRJkqTTp09LDRo0kK5cuSK1aNEiW/nw8HDpo48+ku7cuSNJkiR98MEHkiRJ0oMHD6R69epJzZs3lzIzMw3lFy5cKNWvX1/asWPHG8n/ww8/SO7u7tLPP/8sffjhh9LQoUMN6x48eGCU/3Vl/fk+/PBDqUWLFlJiYqJhfYsWLaQHDx4YvZdOp5MWLlwode/e/YVZnu7/4sWLkru7u5SamipJkiQ9fvxYatasmXTjxo1cs73uZ5f1/Z4aPny4NGLECGnSpEnZlrdv3176+++/De8zZcoUac6cOblmyc2LjltISIjUq1cvafbs2VJ6erokSZJ07do1qVGjRtKZM2ckSZKksLAwqX79+tKlS5cknU4nDR48WPrhhx9eO8fLMr6onr/tej137lxpxIgRUr9+/QzLzp8/LzVq1Ej6559/DMs2bdokeXh45Poz5LeX1fGndSs8PFxq3ry5FBMTI0mSJCUlJUldu3aVDh8+/EZyPH3PrO1STsdQkiSpV69ehrolSZJ0+fJlqV69etK///6bL9lyy5fbefbHH39IzZs3lxISEqTY2FipdevW0qVLl15r3wsXLszW7j3/M0qS8XmfmJgoNWvWTDp27Jhh2Y8//iiNGDFCatu2raTT6bKVX7ZsmbRs2bJsy8aPH2+o/zt27JA6duwoBQcHG/Y/bNgwacKECbn+LLk5c+aM1KtXL8PrpKQkqWnTpvn6GT3/HpL06vU2p+N75MgRydPTU2rQoIGUkpKSbd2OHTuk8ePHv1KuV/k9+vR3Tk6yfiaSJEkhISFS48aNpVOnTkk6nU5q0aKFdOXKlWzbtGnTRrp169Yr5RPeDjFV4CXOnj1LZGQkI0eORKnUD1DXr1+fuXPnGr6xZRUVFYUkSVhZWRmts7KyomrVqpw/f96w7NSpUzRs2PCNZL9w4QKrVq1i2bJlmJmZ0a5dO4KDg9m9e/cbeT8nJycaNmzI/PnzX1pWJpMxYsQI/v33X27evPnS8k+Pa2pqKgCOjo4sW7aMQoUK5brN6352z4uJieH06dP4+Phw4MABkpKSDOseP35MWloaAHK5nOHDh+Pq6vrSfeYkt+N2/vx5QkNDmTBhAmq1GtCPHAwZMoSVK1cC4OzszOTJk/H29ub77783jMK+aU8/j9jY2LdarzMzM9m1axdjxozh+vXrhISEALBy5UqGDBnCxx9/bCjbs2dP3NzcyMjIyPccryK3Oh4bG4tGozHUHysrK+bNm0fFihXfWJas7VJuxzAnNWrUwNXVlW3btr2xbC86z5o3b07Tpk2ZNWsWU6ZM4csvv6RmzZqvtf86deoQFBT0WtvExsaSmpqKvb29YVlgYCA9e/ZErVZz5syZ19pfQEAAfn5+lC5dGgBra2tmz57Nnj17ePTo0Wvt63lpaWkoFIocR6DzU17qbWBgIG3atKFmzZrs3bs3Tznys70pVaoUffr04eeff0Ymk9G1a1f27NljWP/3339jZ2fHBx98kKfMQv4SUwVe4vr169SoUQO5PHsfv1mzZjx8+JDIyEjc3d1JT08nNjaWGjVqEBAQgLOzc477c3V15eDBg9SvX5/Lly9TuXJlJEnK99zR0dF4eXkxe/ZsSpcuzYULF1CpVMydO5fBgwcbLr3lN19fXzp16sSpU6eyXfrOiVqtpkyZMty7d++lv4yaNm1KYGAgTZo04eOPP8bFxQV3d3eKFi2a6zav+tnlZvfu3TRq1IiSJUtSvXp1du7cabisPGHCBIYMGYKTkxMuLi60atWK5s2bv/BneJGcjltMTAzVq1dHJpNlK1u3bl0WLVpkeO3m5sbvv//O6tWrOXjwoMkZXuRl9fxt1etjx45RvHhxypUrR+vWrdmyZQs+Pj5cvHgRX19fo/L9+/c3+hmyetFlyfyQtY4/VaVKFVq1akXr1q2pWrUqLi4udOrUiTJlyuTb+77o8zp8+HCOxzA3lSpV4tixY/mW7XkvOs9Af2507NgRZ2fnbJ/nq9BoNOzfv5/atWu/tKy7uzuZmZlER0dToUIF/Pz8+OijjwD91KCoqCjq1KmDq6srW7ZseeU2NCYmhkePHhm1cXZ2dlSsWJFr165RokSJ1/q5rl69iru7OzqdjpCQEFxdXXFycnqtfbwuU+ttTEwMp06dYvbs2SgUCjZu3Mhnn32Wpywva28GDRqUbapAnz59+PTTT3Pc1wcffMCvv/4KQNeuXenZsyc+Pj7I5XJ+++23XLcT3h0x4voScrn8hb+AnZyc2LlzJ/v27cPd3R2NRkP9+vVzLd+iRQuOHz+OTqdj//79Jo/SvYhOp2Ps2LF06NCB1q1bZ1tXo0YNPv/8c6ZOnZrv7wv6kYSZM2cyefLkbCMnuZHJZJibmxt1LgHDXFbQdwBWrlzJ3r17cXV15dq1a3Tu3JmLFy/muu9X/eyy/ssqMDCQjh07AvrO4datWw3rPDw8OHnyJN7e3iiVSnx9fZk9e/ZLf97c5HTcZDIZWq3WqKxGo8n2Ojk5mRs3bqBWq7l06ZLJGV7kZfX8bdRrMP5Mfv31V8OI6tO6kpGRgbu7O+7u7jRv3py///4728+Q9d+b7LQ+9bSOZzV9+nSOHj1K9+7dCQ0N5YsvvuDQoUP59p4v+rxedAxfNX9+etF5BhAcHIxGo+HevXtERES8dH9PO+3u7u507twZSZIYO3bsS7fbuXMne/fuxdPTk4SEhGxfRHfs2EH79u1RKBS4ublx5MgRw7zWV/Uq5/KretrB3717N//73/949OgRa9asMWlfr8OUertr1y7q16+PnZ0drVq14vbt21y/fj1POV7W3qxZsybbef6yzufT+l2yZEnKli3LuXPnyMjI4NixY4a6Kbw/RMf1JapXr87169eNOkCLFy/m7NmzhtdyuRwfHx+io6P5/vvvc92ftbU1VapU4a+//uLMmTNv5HJqQEAAGo0m18Z62LBhBAcHZ7skkp8aN278SlMGMjIyuH//PhUrVsTW1pbExMRs66Ojo7GzswPgt99+4/Tp05QpU4aePXuyevVq+vbta9TZzOpVP7ucXL9+ndu3bzN79mxatmzJihUr+Pfff/nnn38ICgpixYoVWFtb06ZNG6ZOncqWLVvyfDn1+eP20UcfcfXqVaNfbhcvXqRGjRqG1zNmzKBx48b4+/vj5+dHdHR0nnK8SG71/G3U6+joaI4fP873339Py5Yt8fPzIyEhgUOHDlGjRg1DB1WtVht+YZUqVcrkzkF+yFrHnzp27Bj79u2jaNGifPrppyxZsgQ/Pz+2b9+e7+///Of1omOYm1u3bhnd1JZfXnSeAaSmpuLl5YWfnx/dunXDx8fnpdN8sn5B2b9/P/Pnz892yf9l+vXrh5OTE/7+/oC+c7l7924OHDhAy5Yt+frrrwF9Z/ZVODg4ULp0acPP9FRMTAwPHjzI802UVlZWtG7d2lD/3xRT621gYCD//PMPLVu2pHPnzsjlcrZs2ZKnLPnZ3jxfvz08PNizZw/Hjh2jfv36WFtb5ymrkP9Ex/Ul6tSpg6OjIwEBAYZvzCdOnCAwMNBobo9SqcTHx4fVq1cTFRWV6z5dXV1ZtGgR1atXN8y9zC+nTp1i27ZtLFmyJNd9q9Vq5s6dy+rVq/P1vbPy9fXl5MmTREZG5rhep9OxfPlyPvroI0qXLo21tTVlypTJdql769athstxWq2WRYsWERMTA+jnOt6/f59q1arlmuF1PrvnBQYG8sUXX3Ds2DGOHj3Kn3/+ibu7O1u3bsXBwYEff/yR06dPG8rfuXOHqlWrvtrBeYGsx83Z2ZmKFSsyZ84cQ+fr6tWrrFq1iqFDhwL6UaLr16/j7e1Nw4YNcXNzY+LEiXnO8SJZ63nWUac3Wa/h2cjN8ePHOXr0qOGJD1u3bmXEiBGsWLEi24jzzZs3efDgwWvftZ1fnq/jT5mbm7No0SIePnwI6K8s5Ff9yUnWz2vbtm25HsOcXL58mYMHD+b50m5uXnSeAcyaNYtatWrRtm1bhg4dSnJy8gsHBvKLr68vgYGB3Lx5kz/++AMHBwdOnjzJ0aNHOXr0KDNmzDA84eRVjB49mjlz5vDgwQNAf5XEz88PNzc3ihcvnqesWq2Wc+fOvbAtzA+m1Ntr164RHh5u+HyPHj3Kt99+y+7du1/pityL5Ed7ExQUxM8//0z37t0Ny9q1a8eZM2fYs2fPG6v3Qt6IOa4vIZPJWLlyJXPnzqVjx44olUoKFSrEmjVrsLW1NSrftGlTPv74Y5YuXZrrpeMWLVowadIkRo0ale95v/32W7RaLQMHDsy2vFu3btle16hRg759+76xG7WeXvrObY7h08cVZZ2r6e/vz7Rp01ixYgUajcbwKCGATz/9lNjYWLp3726YVtChQ4cXNiyv+9k9lZGRwe7duw2P8XqqX79+fPnll0yYMIE1a9YYRjhVKhXlypVj8eLFr3+gnvP8cQsICGDJkiV07NgRhUKBnZ0d/v7+uLi4EBwczNy5c1m/fj1mZmYAjBs3Dg8PD37++Wd69OiR5zy5yVrPn3qT9Rr0nZwxY8ZkW9ajRw/WrVtHoUKFWLJkCUuXLuXx48dIkoS9vT3jx4+nTp06uc5prlu3Ln5+fvmW8WV1HPQ3CA4fPhxPT0/DF5ImTZowbNiwfMvxvKef1y+//GL08z49hnfv3gXAz88PS0tLZDIZFhYWLFmyhJIlS+Z7ppedZ02bNuXChQuG+YcqlQp/f3++/PJLGjdubHh81ZtQqVIlunTpwvz58zEzM8vWsQHo2LEjixcv5sSJEzRt2vSl++vQoQMKhYJRo0aRkZGBVqulQ4cOeHp6mpTv6RxX0I9K16hRw6jNz6sLFy5Qq1Ytw+tOnTq9dr0NDAzEw8Mj21QTFxcXypUrx+7du42O6+t4UXvz/BxXCwsLwyjvsmXL2LBhAzKZDIVCwfjx47PNgTY3N6dhw4acPXuWunXrmpxPeHNk0pu4g0IQBEEQBEEQ8pmYKiAIgiAIgiAUCKLjKgiCIAiCIBQIouMqCIIgCIIgFAii4yoIgiAIgiAUCKLjKgiCIAiCIBQIouMqCIIgCIIgFAii4yoIgiAIgiAUCP8H62XV5VX1dZgAAAAASUVORK5CYII=\n", + "image/png": "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\n", "text/plain": [ "
" ] @@ -3743,7 +3763,7 @@ "outputs": [ { "data": { - "image/png": "iVBORw0KGgoAAAANSUhEUgAABJEAAAFRCAYAAADEnjyhAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjMuMywgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/Il7ecAAAACXBIWXMAAAsTAAALEwEAmpwYAACCYElEQVR4nO3de3xU9Z0//teZmdwkpGAMphR0/UYhkIqi20sKGmBRiUKK1P68dAFLi/ZBV/2y++Wrde3lt9tVLO2vVl36XSlYtIWqXURDAQtFU4359uINNkGsqTcWIzFCwyWZZGbO74/0DGfOnPuc65zX8x8lc/ucc2bOeX/e5/N5fwRRFEUQERERERERERHpiPndACIiIiIiIiIiCj4mkYiIiIiIiIiIyBCTSEREREREREREZIhJJCIiIiIiIiIiMsQkEhERERERERERGWISiYiIiIiIiIiIDCX8bgARRcPBgwexYMECvPLKK3mPrVu3Dtu2bYMoishkMrjkkkuwcuVKDA4OYvHixQCAkydP4oMPPsA555wDAPjc5z6H22+/HcPDw5g9ezYmT56M9evXAwAeeugh/OpXvwIAvPvuuxg7dixGjx4NAHjggQdw1llnebHJRERERKEwefJkTJo0CbFYDIIgYGBgAJWVlfjOd76D888/H1u2bME3vvENrFixArfddlv2daIoYu7cuaioqMC2bdt83AIi8gqTSETkqx07dmD37t147LHHUF5ejmQyiVtvvRUPPvgg/vEf/xFPPfUUAOB3v/sd/vVf/zX7b8muXbswefJkdHZ2oru7G3V1dbjppptw0003AQAWL16ML33pS5g3b57n20ZEREQUFhs3bsTpp5+e/ff69evx3e9+F4899hgAYPz48Whtbc1JIv3xj3/E4OAgKioqPG8vEfmD09mIyFe9vb1Ip9MYHBwEAJSVleGb3/wm5s6da+r1mzdvxty5c3HllVdi48aNbjaViIiIKBJSqRTef/99fOxjH8v+bdKkSTjttNPw8ssvZ//25JNPoqWlxY8mEpFPmEQiIl9dffXVqKqqwsyZM3Httddi9erVeP/99zFt2jTD17755pt49dVX0dzcjIULF+Kpp57CkSNHPGg1ERERUXFZunQpWlpaMHPmTFxxxRUAgHvuuSfnOVK8BQADAwN46aWXcMkll3jeViLyD5NIROSr0aNHY8OG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ZyMiKkDYh4oXQ72hsB8DIiIKLqevMV5es4rhGk9EwcORSEREBQj7UHHprmeYp4KF/RgQEVFwOX2N8fKapbzGc3U2InICk0hERAUohqHiVuorBFExHAMiIgomp68xXl+z5Nd4rbqCRERWcDobEVEBOFTcfzwGRETkFqevMbxmEVHYcSQSEVEBimE6WNjxGBARkVucvsbwmkVEYcckEhFRgcI+HawY8BgQEZFbnL7G8JpFRGHG6WxERERERERERGSISSQiIiIiIiIiIjLEJBIRERERERERERliEomIiIiIiIiIiAwxiURERERERERERIaYRCIiIiIiIiIiIkNMIhERERERERERkaGE3w1wQiwm+N0E30R524Fob3+Utx3g9kd5+6O87UC0tj9K2xo2UT02Ud1uL3Efu4v7113cv+7jPnaXtH/19rMgiqLoVYOIiIiIiIiIiCicOJ2NiIiIiIiIiIgMMYlERERERERERESGmEQiIiIiIiIiIiJDTCIREREREREREZEhJpGIiIiIiIiIiMgQk0hERERERERERGSISSQiIiIiIiIiIjLEJBIRERERERERERliEomIiIiIiIiIiAwxiURERERERERERIaYRCIiIiIiIiIiIkNMIhERERERERERkaHQJpFaW1tx5ZVX4rLLLsPPf/5zv5vjuSVLluCqq67C5z//eXz+85/Ha6+95neTXHf8+HHMnz8fBw8eBAC8+OKLWLBgAS6//HL88Ic/9Ll17lNu/ze+8Q1cfvnl2e/Arl27fG6hOx588EFcddVVuOqqq/C9730PQLSOvdr2R+XYA8CPfvQjXHnllbjqqqvw8MMPA4jO8Vfb9igde6Kguffee3HHHXf43YyiFMW41kt79uzBokWLMG/ePHz3u9/1uzlF54knnsh+dz//+c/j4osvxr/8y7/43ayi8tRTT2Xj4Xvvvdfv5hSdhx56CFdccQUWLFiAH//4x8YvEEOop6dHnD17tnjkyBHxxIkT4oIFC8Q//elPfjfLM5lMRpwxY4Y4PDzsd1M88+qrr4rz588XGxoaxPfee08cGBgQm5qaxHfffVccHh4Wly1bJj733HN+N9M1yu0XRVGcP3+++MEHH/jcMne1t7eL1157rZhMJsWhoSFxyZIlYmtra2SOvdr2//rXv47EsRdFUfzd734nXnfddeLw8LA4MDAgzp49W9y/f38kjr/atnd3d0fm2BMFzYsvvih+5jOfEW+//Xa/m1J0ohjXeundd98VZ86cKb7//vvi0NCQeP311xfldTMo3njjDfGyyy4T+/r6/G5K0Th58qT4qU99Suzr6xOHh4fFa665Rmxvb/e7WUWjvb1dnD9/vnjs2DExlUqJN998s/jMM8/oviaUI5FefPFFfPazn8WYMWNw2mmn4YorrsDOnTv9bpZn/vznP0MQBCxfvhwtLS342c9+5neTXPf444/j29/+NsaNGwcA2Lt3L84++2xMnDgRiUQCCxYsKOrvgHL7T548iUOHDuGb3/wmFixYgPvvvx+ZTMbnVjqvpqYGd9xxB0pLS1FSUoK6ujq8/fbbkTn2att/6NChSBx7APj0pz+NRx55BIlEAn19fUin0+jv74/E8Vfb9rKyssgce6IgOXr0KH74wx/ia1/7mt9NKUpRjGu9tGvXLlx55ZWora1FSUkJfvjDH+KCCy7wu1lF6zvf+Q5WrlyJ008/3e+mFI10Oo1MJoOBgQGkUimkUimUlZX53ayi0dXVhZkzZ6KyshLxeByXXHIJdu/erfuaUCaRDh8+jJqamuy/x40bhw8++MDHFnmrv78fjY2N+Pd//3f89Kc/xS9+8Qu0t7f73SxX/du//Rv+9m//NvvvqH0HlNvf19eHz372s7j77rvx+OOP449//CN++ctf+thCd5x33nm48MILAQBvv/02tm/fDkEQInPs1bb/kksuicSxl5SUlOD+++/HVVddhcbGxkj99pXbnk6nI3XsiYLiW9/6FlauXImqqiq/m1KUohjXeumdd95BOp3GV77yFbS0tGDTpk342Mc+5nezitKLL76IwcFBNDc3+92UolJZWYnbbrsNzc3NuPTSS/GJT3wCF110kd/NKhoNDQ144YUXcPToUSSTSezZswcffvih7mtCmUQSRTHvb4Ig+NASf0yfPh3f+973cNppp+H000/HNddcg7a2Nr+b5amofwcmTpyIf//3f0d1dTUqKiqwePHiov4O/OlPf8KyZctw++2346yzzsp7vNiPvXz7/8f/+B+ROvYAcOutt6KjowPvv/8+3n777bzHi/n4y7e9o6MjcseeyG9PPPEEPv7xj6OxsdHvphQtxrXuSqfT6OjowJo1a/D4449j3759ePLJJ/1uVlH6xS9+gS9/+ct+N6PovP766/jP//xPPPvss3jhhRcQi8Wwfv16v5tVNBobG7Fo0SIsXrwYX/3qV3HxxRejpKRE9zWhTCKdeeaZOdmxw4cPZ6f5RMEf//hHdHR0ZP8tiiISiYSPLfJe1L8DBw4cwDPPPJP9dzF/B1566SXceOON+Kd/+idcffXVkTv2yu2P0rHv7u7G/v37AQAVFRW4/PLL8bvf/S4Sx19t27dv3x6ZY08UFNu3b0d7ezs+//nP4/7778eePXtw9913+92sosK41l1nnHEGGhsbcfrpp6O8vBx/93d/h7179/rdrKIzNDSEP/zhD5gzZ47fTSk6L7zwAhobG1FdXY3S0lIsWrQIv//97/1uVtE4fvw4LrvsMrS2tuLRRx9FRUUFJk6cqPuaUCaRPve5z6GjowMfffQRBgYG8Otf/xqXXnqp383yzLFjx/C9730PyWQSx48fx5NPPonLLrvM72Z56oILLsBbb72VHaK7bdu2SH0HRFHE3Xffjb/85S8YHh7GY489VpTfgffffx9f//rX8f3vfx9XXXUVgGgde7Xtj8qxB4CDBw/irrvuwtDQEIaGhvCb3/wG1113XSSOv9q2f+pTn4rMsScKiocffhjbtm3DU089hVtvvRVz5szBnXfe6XezigrjWnfNnj0bL7zwAvr7+5FOp/H888+joaHB72YVnQMHDuBv/uZvcNppp/ndlKJTX1+PF198ESdPnoQoitizZw/OP/98v5tVNA4ePIivf/3rSKVSOHbsGJ544gnDKZmhTPOfeeaZWLlyJZYsWYLh4WFcc801mDZtmt/N8szs2bPx2muvYeHChchkMrjhhhswffp0v5vlqbKyMqxevRq33HILkskkmpqaMG/ePL+b5Zn6+nrcdNNNuP7665FKpXD55Zdj/vz5fjfLcevXr0cymcTq1auzf7vuuusic+y1tj8Kxx4Ampqasue6eDyOyy+/HFdddRVOP/30oj/+atv+D//wDxg7dmwkjj0RRQfjWnddcMEF+OpXv4obbrgBw8PDmDFjBr7whS/43ayi895776G2ttbvZhSlmTNnoqurC4sWLUJJSQnOP/983HTTTX43q2jU19fj8ssvR0tLC9LpNG688UZcfPHFuq8RRLXiMkRERERERERERDKhnM5GRERERERERETeYhKJiIiIiIiIiIgMMYlERERERERERESGmEQiIiIiIiIiIiJDTCIREREREREREZGhhN8NIKJoOHjwIBYsWIBXXnkl77F169Zh27ZtEEURmUwGl1xyCVauXInBwUEsXrwYAHDy5El88MEHOOeccwAAn/vc53D77bdjeHgYs2fPxuTJk7F+/XoAwEMPPYRf/epXAIB3330XY8eOxejRowEADzzwAM466ywvNpmIiIgoFCZPnoxJkyYhFotBEAQMDAygsrIS3/nOd3D++edjy5Yt+MY3voEVK1bgtttuy75OFEXMnTsXFRUV2LZtm49bQEReYRKJiHy1Y8cO7N69G4899hjKy8uRTCZx66234sEHH8Q//uM/4qmnngIA/O53v8O//uu/Zv8t2bVrFyZPnozOzk50d3ejrq4ON910E2666SYAwOLFi/GlL30J8+bN83zbiIiIiMJi48aNOP3007P/Xr9+Pb773e/iscceAwCMHz8era2tOUmkP/7xjxgcHERFRYXn7SUif3A6GxH5qre3F+l0GoODgwCAsrIyfPOb38TcuXNNvX7z5s2YO3currzySmzcuNHNphIRERFFQiqVwvvvv4+Pfexj2b9NmjQJp512Gl5++eXs35588km0tLT40UQi8gmTSETkq6uvvhpVVVWYOXMmrr32WqxevRrvv/8+pk2bZvjaN998E6+++iqam5uxcOFCPPXUUzhy5IgHrSYiIiIqLkuXLkVLSwtmzpyJK664AgBwzz335DxHircAYGBgAC+99BIuueQSz9tKRP5hEomIfDV69Ghs2LABO3bswDXXXIO+vj7cdNNNWLNmjeFrN2/ejFmzZmHMmDGYNm0aJkyYkB1yTURERETmbdy4EU8//TQeeughDA4OYvr06aiurs55zoIFC7Br1y4MDw9j165dmDNnDuLxuE8tJiI/MIlERL5at24dXn75ZUycOBFf/OIXsWbNGqxbtw6bNm3Sfd3JkyexdetWvPTSS5gzZw7mzJmD3t5e/PznP8fw8LBHrSciIiIqLlOnTsU3vvEN3HXXXTh48GDOYzU1NZg6dSra2tqwdetWXH311T61koj8wiQSEflqcHAQP/jBD3D06NHs39566y1MnTpV93Wtra0YO3Ysnn/+eezZswd79uzB7t27cfLkSezYscPlVhMREREVr/nz5+PCCy/E3XffnffYwoUL8fDDD+PYsWOYNGmSD60jIj9xdTYi8szJkycxffr0nL9t3rwZgiDguuuugyAIyGQy+OQnP4n77rtP9702b96ML3/5yzlDqKuqqrB48WJs3LiRRR6JiIiICvDNb34TLS0teP7553P+PnfuXHz729/GypUrfWoZEflJEEVR9LsRREREREREREQUbJzORkREREREREREhphEIiIiIiIiIiIiQ0wiERERERERERGRISaRiIiIiIiIiIjIEJNIRERERERERERkiEkkIiIiIiIiIiIyxCQSEREREREREREZYhKJiIiIiIiIiIgM/f8DoNXX46X5bAAAAABJRU5ErkJggg==\n", + "image/png": "iVBORw0KGgoAAAANSUhEUgAABJEAAAFRCAYAAADEnjyhAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjQuMywgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/MnkTPAAAACXBIWXMAAAsTAAALEwEAmpwYAACCYElEQVR4nO3de3xU9Z0//teZmdwkpGAMphR0/UYhkIqi20sKGmBRiUKK1P68dAFLi/ZBV/2y++Wrde3lt9tVLO2vVl36XSlYtIWqXURDAQtFU4359uINNkGsqTcWIzFCwyWZZGbO74/0DGfOnPuc65zX8x8lc/ucc2bOeX/e5/N5fwRRFEUQERERERERERHpiPndACIiIiIiIiIiCj4mkYiIiIiIiIiIyBCTSEREREREREREZIhJJCIiIiIiIiIiMsQkEhERERERERERGWISiYiIiIiIiIiIDCX8bgARRcPBgwexYMECvPLKK3mPrVu3Dtu2bYMoishkMrjkkkuwcuVKDA4OYvHixQCAkydP4oMPPsA555wDAPjc5z6H22+/HcPDw5g9ezYmT56M9evXAwAeeugh/OpXvwIAvPvuuxg7dixGjx4NAHjggQdw1llnebHJRERERKEwefJkTJo0CbFYDIIgYGBgAJWVlfjOd76D888/H1u2bME3vvENrFixArfddlv2daIoYu7cuaioqMC2bdt83AIi8gqTSETkqx07dmD37t147LHHUF5ejmQyiVtvvRUPPvgg/vEf/xFPPfUUAOB3v/sd/vVf/zX7b8muXbswefJkdHZ2oru7G3V1dbjppptw0003AQAWL16ML33pS5g3b57n20ZEREQUFhs3bsTpp5+e/ff69evx3e9+F4899hgAYPz48Whtbc1JIv3xj3/E4OAgKioqPG8vEfmD09mIyFe9vb1Ip9MYHBwEAJSVleGb3/wm5s6da+r1mzdvxty5c3HllVdi48aNbjaViIiIKBJSqRTef/99fOxjH8v+bdKkSTjttNPw8ssvZ//25JNPoqWlxY8mEpFPmEQiIl9dffXVqKqqwsyZM3Httddi9erVeP/99zFt2jTD17755pt49dVX0dzcjIULF+Kpp57CkSNHPGg1ERERUXFZunQpWlpaMHPmTFxxxRUAgHvuuSfnOVK8BQADAwN46aWXcMkll3jeViLyD5NIROSr0aNHY8OG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ZyMiKkDYh4oXQ72hsB8DIiIKLqevMV5es4rhGk9EwcORSEREBQj7UHHprmeYp4KF/RgQEVFwOX2N8fKapbzGc3U2InICk0hERAUohqHiVuorBFExHAMiIgomp68xXl+z5Nd4rbqCRERWcDobEVEBOFTcfzwGRETkFqevMbxmEVHYcSQSEVEBimE6WNjxGBARkVucvsbwmkVEYcckEhFRgcI+HawY8BgQEZFbnL7G8JpFRGHG6WxERERERERERGSISSQiIiIiIiIiIjLEJBIRERERERERERliEomIiIiIiIiIiAwxiURERERERERERIaYRCIiIiIiIiIiIkNMIhERERERERERkaGE3w1wQiwm+N0E30R524Fob3+Utx3g9kd5+6O87UC0tj9K2xo2UT02Ud1uL3Efu4v7113cv+7jPnaXtH/19rMgiqLoVYOIiIiIiIiIiCicOJ2NiIiIiIiIiIgMMYlERERERERERESGmEQiIiIiIiIiIiJDTCIREREREREREZEhJpGIiIiIiIiIiMgQk0hERERERERERGSISSQiIiIiIiIiIjLEJBIRERERERERERliEomIiIiIiIiIiAwxiURERERERERERIaYRCIiIiIiIiIiIkNMIhERERERERERkaHQJpFaW1tx5ZVX4rLLLsPPf/5zv5vjuSVLluCqq67C5z//eXz+85/Ha6+95neTXHf8+HHMnz8fBw8eBAC8+OKLWLBgAS6//HL88Ic/9Ll17lNu/ze+8Q1cfvnl2e/Arl27fG6hOx588EFcddVVuOqqq/C9730PQLSOvdr2R+XYA8CPfvQjXHnllbjqqqvw8MMPA4jO8Vfb9igde6Kguffee3HHHXf43YyiFMW41kt79uzBokWLMG/ePHz3u9/1uzlF54knnsh+dz//+c/j4osvxr/8y7/43ayi8tRTT2Xj4Xvvvdfv5hSdhx56CFdccQUWLFiAH//4x8YvEEOop6dHnD17tnjkyBHxxIkT4oIFC8Q//elPfjfLM5lMRpwxY4Y4PDzsd1M88+qrr4rz588XGxoaxPfee08cGBgQm5qaxHfffVccHh4Wly1bJj733HN+N9M1yu0XRVGcP3+++MEHH/jcMne1t7eL1157rZhMJsWhoSFxyZIlYmtra2SOvdr2//rXv47EsRdFUfzd734nXnfddeLw8LA4MDAgzp49W9y/f38kjr/atnd3d0fm2BMFzYsvvih+5jOfEW+//Xa/m1J0ohjXeundd98VZ86cKb7//vvi0NCQeP311xfldTMo3njjDfGyyy4T+/r6/G5K0Th58qT4qU99Suzr6xOHh4fFa665Rmxvb/e7WUWjvb1dnD9/vnjs2DExlUqJN998s/jMM8/oviaUI5FefPFFfPazn8WYMWNw2mmn4YorrsDOnTv9bpZn/vznP0MQBCxfvhwtLS342c9+5neTXPf444/j29/+NsaNGwcA2Lt3L84++2xMnDgRiUQCCxYsKOrvgHL7T548iUOHDuGb3/wmFixYgPvvvx+ZTMbnVjqvpqYGd9xxB0pLS1FSUoK6ujq8/fbbkTn2att/6NChSBx7APj0pz+NRx55BIlEAn19fUin0+jv74/E8Vfb9rKyssgce6IgOXr0KH74wx/ia1/7mt9NKUpRjGu9tGvXLlx55ZWora1FSUkJfvjDH+KCCy7wu1lF6zvf+Q5WrlyJ008/3e+mFI10Oo1MJoOBgQGkUimkUimUlZX53ayi0dXVhZkzZ6KyshLxeByXXHIJdu/erfuaUCaRDh8+jJqamuy/x40bhw8++MDHFnmrv78fjY2N+Pd//3f89Kc/xS9+8Qu0t7f73SxX/du//Rv+9m//NvvvqH0HlNvf19eHz372s7j77rvx+OOP449//CN++ctf+thCd5x33nm48MILAQBvv/02tm/fDkEQInPs1bb/kksuicSxl5SUlOD+++/HVVddhcbGxkj99pXbnk6nI3XsiYLiW9/6FlauXImqqiq/m1KUohjXeumdd95BOp3GV77yFbS0tGDTpk342Mc+5nezitKLL76IwcFBNDc3+92UolJZWYnbbrsNzc3NuPTSS/GJT3wCF110kd/NKhoNDQ144YUXcPToUSSTSezZswcffvih7mtCmUQSRTHvb4Ig+NASf0yfPh3f+973cNppp+H000/HNddcg7a2Nr+b5amofwcmTpyIf//3f0d1dTUqKiqwePHiov4O/OlPf8KyZctw++2346yzzsp7vNiPvXz7/8f/+B+ROvYAcOutt6KjowPvv/8+3n777bzHi/n4y7e9o6MjcseeyG9PPPEEPv7xj6OxsdHvphQtxrXuSqfT6OjowJo1a/D4449j3759ePLJJ/1uVlH6xS9+gS9/+ct+N6PovP766/jP//xPPPvss3jhhRcQi8Wwfv16v5tVNBobG7Fo0SIsXrwYX/3qV3HxxRejpKRE9zWhTCKdeeaZOdmxw4cPZ6f5RMEf//hHdHR0ZP8tiiISiYSPLfJe1L8DBw4cwDPPPJP9dzF/B1566SXceOON+Kd/+idcffXVkTv2yu2P0rHv7u7G/v37AQAVFRW4/PLL8bvf/S4Sx19t27dv3x6ZY08UFNu3b0d7ezs+//nP4/7778eePXtw9913+92sosK41l1nnHEGGhsbcfrpp6O8vBx/93d/h7179/rdrKIzNDSEP/zhD5gzZ47fTSk6L7zwAhobG1FdXY3S0lIsWrQIv//97/1uVtE4fvw4LrvsMrS2tuLRRx9FRUUFJk6cqPuaUCaRPve5z6GjowMfffQRBgYG8Otf/xqXXnqp383yzLFjx/C9730PyWQSx48fx5NPPonLLrvM72Z56oILLsBbb72VHaK7bdu2SH0HRFHE3Xffjb/85S8YHh7GY489VpTfgffffx9f//rX8f3vfx9XXXUVgGgde7Xtj8qxB4CDBw/irrvuwtDQEIaGhvCb3/wG1113XSSOv9q2f+pTn4rMsScKiocffhjbtm3DU089hVtvvRVz5szBnXfe6XezigrjWnfNnj0bL7zwAvr7+5FOp/H888+joaHB72YVnQMHDuBv/uZvcNppp/ndlKJTX1+PF198ESdPnoQoitizZw/OP/98v5tVNA4ePIivf/3rSKVSOHbsGJ544gnDKZmhTPOfeeaZWLlyJZYsWYLh4WFcc801mDZtmt/N8szs2bPx2muvYeHChchkMrjhhhswffp0v5vlqbKyMqxevRq33HILkskkmpqaMG/ePL+b5Zn6+nrcdNNNuP7665FKpXD55Zdj/vz5fjfLcevXr0cymcTq1auzf7vuuusic+y1tj8Kxx4Ampqasue6eDyOyy+/HFdddRVOP/30oj/+atv+D//wDxg7dmwkjj0RRQfjWnddcMEF+OpXv4obbrgBw8PDmDFjBr7whS/43ayi895776G2ttbvZhSlmTNnoqurC4sWLUJJSQnOP/983HTTTX43q2jU19fj8ssvR0tLC9LpNG688UZcfPHFuq8RRLXiMkRERERERERERDKhnM5GRERERERERETeYhKJiIiIiIiIiIgMMYlERERERERERESGmEQiIiIiIiIiIiJDTCIREREREREREZGhhN8NIKJoOHjwIBYsWIBXXnkl77F169Zh27ZtEEURmUwGl1xyCVauXInBwUEsXrwYAHDy5El88MEHOOeccwAAn/vc53D77bdjeHgYs2fPxuTJk7F+/XoAwEMPPYRf/epXAIB3330XY8eOxejRowEADzzwAM466ywvNpmIiIgoFCZPnoxJkyYhFotBEAQMDAygsrIS3/nOd3D++edjy5Yt+MY3voEVK1bgtttuy75OFEXMnTsXFRUV2LZtm49bQEReYRKJiHy1Y8cO7N69G4899hjKy8uRTCZx66234sEHH8Q//uM/4qmnngIA/O53v8O//uu/Zv8t2bVrFyZPnozOzk50d3ejrq4ON910E2666SYAwOLFi/GlL30J8+bN83zbiIiIiMJi48aNOP3007P/Xr9+Pb773e/iscceAwCMHz8era2tOUmkP/7xjxgcHERFRYXn7SUif3A6GxH5qre3F+l0GoODgwCAsrIyfPOb38TcuXNNvX7z5s2YO3currzySmzcuNHNphIRERFFQiqVwvvvv4+Pfexj2b9NmjQJp512Gl5++eXs35588km0tLT40UQi8gmTSETkq6uvvhpVVVWYOXMmrr32WqxevRrvv/8+pk2bZvjaN998E6+++iqam5uxcOFCPPXUUzhy5IgHrSYiIiIqLkuXLkVLSwtmzpyJK664AgBwzz335DxHircAYGBgAC+99BIuueQSz9tKRP5hEomIfDV69Ghs2LABO3bswDXXXIO+vj7cdNNNWLNmjeFrN2/ejFmzZmHMmDGYNm0aJkyYkB1yTURERETmbdy4EU8//TQeeughDA4OYvr06aiurs55zoIFC7Br1y4MDw9j165dmDNnDuLxuE8tJiI/MIlERL5at24dXn75ZUycOBFf/OIXsWbNGqxbtw6bNm3Sfd3JkyexdetWvPTSS5gzZw7mzJmD3t5e/PznP8fw8LBHrSciIiIqLlOnTsU3vvEN3HXXXTh48GDOYzU1NZg6dSra2tqwdetWXH311T61koj8wiQSEflqcHAQP/jBD3D06NHs39566y1MnTpV93Wtra0YO3Ysnn/+eezZswd79uzB7t27cfLkSezYscPlVhMREREVr/nz5+PCCy/E3XffnffYwoUL8fDDD+PYsWOYNGmSD60jIj9xdTYi8szJkycxffr0nL9t3rwZgiDguuuugyAIyGQy+OQnP4n77rtP9702b96ML3/5yzlDqKuqqrB48WJs3LiRRR6JiIiICvDNb34TLS0teP7553P+PnfuXHz729/GypUrfWoZEflJEEVR9LsRREREREREREQUbJzORkREREREREREhphEIiIiIiIiIiIiQ0wiERERERERERGRISaRiIiIiIiIiIjIEJNIRERERERERERkiEkkIiIiIiIiIiIyxCQSEREREREREREZYhKJiIiIiIiIiIgM/f8DoNXX46X5bAAAAABJRU5ErkJggg==\n", "text/plain": [ "
" ] @@ -3851,13 +3871,13 @@ "text": [ "The model performance for training set\n", "--------------------------------------\n", - "RMSE is 5.637129335071195\n", + "RMSE is 5.6371293350711955\n", "R2 score is 0.6300745149331701\n", "\n", "\n", "The model performance for testing set\n", "--------------------------------------\n", - "RMSE is 5.137400784702912\n", + "RMSE is 5.137400784702911\n", "R2 score is 0.6628996975186952\n" ] } @@ -3906,7 +3926,7 @@ "outputs": [ { "data": { - "image/png": "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\n", + "image/png": "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\n", "text/plain": [ "
" ] @@ -4536,7 +4556,7 @@ "outputs": [ { "data": { - "image/png": "iVBORw0KGgoAAAANSUhEUgAAAr0AAAHmCAYAAAB+hTZxAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjMuMywgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/Il7ecAAAACXBIWXMAAAsTAAALEwEAmpwYAABXwElEQVR4nO3deZxU1Z3///e9t6q6u3qhq7qrih2kW0UFXEIiosEVEQRRNBmXSJyJS6KTRL7R6CRxRI2jSVScLGZiTOJvIk40iUIwBDFjYkIgxmWEFldQdujqBXpfqqvu74/qLrrprXqrjdfz8ch037VOneGBb4/nfI5h27YtAAAAIIOZyW4AAAAAMNIIvQAAAMh4hF4AAABkPEIvAAAAMh6hFwAAABmP0AsAAICM50h2Awbi4MEGRSKJq7BWVJSnqqr6hH3e0Y7+Thz6OnHo68SivxOHvk4c+jp+pmnI48nt8Vpahd5IxE5o6O34TCQO/Z049HXi0NeJRX8nDn2dOPT10DG9AQAAABmP0AsAAICMR+gFAABAxiP0AgAAIOMRegEAAJDxCL0AAADIeIReAAAAZDxCLwAAADJeXJtTrFmzRj/+8Y8VCoV03XXX6Zprruly/aWXXtL3v/99RSIRTZ8+Xffee69cLpdWrVqlhx56SEVFRZKkc845R8uWLRv+bwEAAICYhx/+jsrKNqutLaQ9e3Zr8uQpkqTPfOZKXXzxJXG9o76+Xvfff7ceeODhbtfOOmumSkuP63LujDPO1E033TL0xo+QfkNveXm5VqxYoeeee04ul0tXXnmlTj/9dJWWlkqSGhsbde+99+r5559XcXGxli1bpueff17/9E//pLKyMt15551auHDhiH8RAAAARH3ta3dIkvbv36cvf/kmPfnk0wN+R11drT788INerw/mncnUb+jduHGjZs2apcLCQknSvHnztG7dOv3rv/6rJMntduvll1+W0+lUY2OjqqqqVFBQIEkqKyvTzp079fjjj+u4447TXXfdpVGjRo3ctwEAAEgBfyvbrw1b9g/Lu5wuS6HWcOz4rBljdOb0MYN61549u/XQQw+otrZGWVnZWrbsdh133FStX79OTz/93zJNU2PHjtVdd92nRx/9niorK/Rv/3abHnjgobg/44orFunEE6fpww/f11133atvf/tujRpVKJcrSytW/FDf//7Dev3112QY0rx5C/S5z12nN998XT/+8fcVDkc0ZUqJvvWtewb1/frSb+gNBoPy+XyxY7/fry1btnS5x+l06pVXXtHXv/51+f1+nXXWWZIkn8+nG2+8UTNmzNAjjzyie++9Vw8/3H2IPF5FRXmDfnawfL78hH/m0Yz+Thz6OnHo68SivxOHvu5dQcFBOV3WsL2v87sKCrLj7vuWllxZlhm7/8tfvlf//u//rhNPPFHbtm3TLbfcohdffFE///l/6dlnn1VRUZFWrFihuroK3Xvvci1dulRPPPGTHt99/fWf63J822236dOf/rQsy9Tcuefpxz/+ofbs2aNdu3bqf//35xo/frxWrlypQ4eqtHbtC2ptbdW1116rU0+drsJCt/bs2a0//elPys8fmT9X/YZe27a7nTMMo9u5s88+W6+++qoeeeQRLV++XA8//LB+9KMfxa5ff/31uuCCC4bU2KqqekUi3dszUny+fFVU1CXs84529Hfi0NeJQ18nFv2dOPR136ZP8mj6JM+wvKunvo6376urGxQOR1RRUafGxkaVlZXp9tvviF2vr2/Qtm27NWvWWfrsZ/9Jn/70OTr77PNUXDxe+/fviz3bkyeeeKrbuYqKOoXDEU2YUKqKijpVVzfI4/EqK2uUKirq9Je/bNC8eQtUXd0oSTr33Av18suv6Mwz52j8+Ilqbpaamwf/58o0jV4HSfut3hAIBFRZWRk7DgaD8vv9seNDhw5pw4YNseNFixbp/fffV11dnZ588snYedu25XDEtW4OAAAAwywSicjlytKTTz4d+9/jjz+pgoJRuvXW2/Ttb39XBQUFuu++u/Tii2uH9FlZWVk9/t598NJWOBzudt9I6Df0zp49W5s2bVJ1dbWampq0fv16zZkzJ3bdtm3dfvvt2rdvnyTpD3/4g0477TS53W498cQT2rx5syTpqaee0ty5c0foawAAAKAveXl5Gj9+QizQvvba33XLLTcqHA7ryisvU2Fhoa699p910UUX64MP3pdlWbFAOlw+8YmZ+sMffq9wOKzm5matX79Op546c1g/ozf9Dr0GAgEtW7ZMS5cuVSgU0hVXXKEZM2bohhtu0Fe+8hVNnz5d9913n2666SYZhqHS0lLdc889sixLjz76qJYvX67m5mZNnjxZ3/3udxPxnQAAANCDu+/+tr73vf/Q00//txwOp+699z/kcDj0hS/cpFtvvVlZWdnKy8vXt761XB6PV4HAaH35yzfpBz/oPq/3uuuu7nI8fvx4ffvbfWe9xYsv1+7du3TddVepra1N8+Yt0Nlnn6s333x9WL9nTwy7p0m7KSrRc3qLi/NUWVmfsM872jE/LHHo68ShrxOL/k4c+jpx6Ov4DWlO79Hqg92HdO3ydapvCiW7KQAAABgiQm8vQm0R1dS3ak+QkV4AAIB0R+jtRcCTI0kKHmpKcksAAAAwVITeXngLsuWwTJW315EDAABA+iL09sI0DY0ucqv8ICO9AAAA6Y7Q24exxXkKHmSkFwAAIN0RevswpjhXwYNNiqRPVTcAAAD0gH2B+zDWl6vWtogO1bXIW5Cd7OYAAADE5eGHv6Oyss1qawtpz57dmjx5iiTpM5+5UhdffElc77juuqv15JNPx3Xvm2++rjvuWKZx4yZ0Of/P/3yDzj773IE1foQQevswtjhXkhQ82EToBQAAaeNrX7tDkrR//z59+cs3xR1eOxvoM8cff4J++MPHB/w5iULo7cOY4uiOHuUHGzV1kifJrQEAAOki9MHfFHr/L8Pyrn1Oh0Khttix8/g5ch535qDfd8UVi3TiidP04Yfv67HHntCzz/6P3njjNdXW1qqwsFD33/9dFRUV66yzZmrDhtf1s5/9RJWVFdq9e5fKyw9o4cLF+vznvxD35+3fv09f+9qXNWpUoVyuLM2bN19/+MMLqqk5pDPPnKPPfOZKPfjgfSovPyDLsnTjjbdo1qzZ+tnPfqKtW99WMHhAS5Z8VkuWfGbQ31ki9PapuDBHDstQkAoOAAAgg8yaNVv33vuA9uzZrV27dui//uvnMk1T993371q/fp2uuupzXe7ftu1DPfbYE6qvr9NnP3upliz5rPLz87vc8/777+q6667ucu4///MxSdKuXTv161//QGPGjNXatWtUURHUU0/9Wg6HQ3fddadOO22mrrzyc9q7d49uvvl6/eIXKyVJra0teuqpXw/Ldyb09sEyDfkKcyhbBgAABsR53JlDGo3tzOfLV0VF3bC8q8OJJ06TJI0fP0H/+q/LtGbNKu3atVNbt5Zp3Ljx3e4/7bSZcjqd8ni8KigoUENDfbfQ29v0hsbGRnk8Xo0ZMzZ27rjjpsrhiMbQN998TXfc8S1J0rhx43XiidP0zjtvd2nncKB6Qz8CHrfKKVsGAAAySFZWliTpvffe1bJl/yrbjujcc8/XnDnnyO6hapXL5Yr9bhhGj/fE83k9HUciR77LVjgc7vG5oSD09sPvyVEFZcsAAEAGeuutN3TqqZ/QpZdeocmTp+gf/3hVkUgkoW34xCdm6oUXVkmS9u7do7KyzTrppBnD/jlMb+hHwJND2TIAAJCRzj//Qn3jG7fr85+/UpblUElJqfbv3zeod/U0p/f88y/UBRdc2Odzt956u7773fu1du0aGYahO+74loqLiwfVhr4Y9kDHp5Ooqqq+hyHwkePz5evPr+3Uw796S7dfdapOoILDiBqJOUvoGX2dOPR1YtHfiUNfJw59HT/TNFRUlNfztQS3Je0EPDmSxHbEAAAAaYzQ2w9vfrYclkEFBwAAgDRG6O2H2V62jFq9AAAA6YvQGwfKlgEAAKQ3Qm8c/J7oSC9lywAAANIToTcOAa9bofayZQAAAEg/hN44+NsrOLCYDQAAID0ReuMQiIVe5vUCAACkI0JvHLwF2XJYJhUcAAAA0hShNw6mYchXmK3yakZ6AQAA0hGhN04Bj1vBQ4z0AgAApCNCb5wCXsqWAQAApCtCb5z8HsqWAQAApCtCb5wClC0DAABIW4TeOPkpWwYAAJC2CL1xomwZAABA+iL0xsk0DPk9OZQtAwAASEOE3gHwF+Yw0gsAAJCGCL0DEPDmKHiIsmUAAADphtA7AAHKlgEAAKQlQu8AxCo4MK8XAAAgrRB6ByDgcUuSytmOGAAAIK0QegfAU5AVLVtWTegFAABIJ4TeAYiVLWODCgAAgLRC6B2ggIeyZQAAAOmG0DtAfg9lywAAANINoXeAKFsGAACQfgi9AxSgbBkAAEDaIfQOkL+jbBnzegEAANIGoXeAYmXLCL0AAABpg9A7QJQtAwAASD+E3kGgbBkAAEB6IfQOQsDjpmwZAABAGiH0DoLfk6NQW0QHaylbBgAAkA4IvYPQUbYsyLxeAACAtEDoHYSAl7JlAAAA6SSu0LtmzRotWLBAc+fO1cqVK7tdf+mll7Ro0SJdfPHFuvPOO9Xa2ipJ2rdvn6655hpddNFF+tKXvqSGhobhbX2SFOZnyemgbBkAAEC66Df0lpeXa8WKFXr66ae1evVqPfPMM9q2bVvsemNjo+6991794he/0O9//3u1tLTo+eeflyTdc889uvrqq7Vu3TpNmzZNjz322Mh9kwQyDUP+QsqWAQAApIt+Q+/GjRs1a9YsFRYWyu12a968eVq3bl3sutvt1ssvv6zi4mI1NjaqqqpKBQUFCoVCeu211zRv3jxJ0pIlS7o8l+6itXoZ6QUAAEgHjv5uCAaD8vl8sWO/368tW7Z0ucfpdOqVV17R17/+dfn9fp111lk6ePCg8vLy5HBEP8Ln86m8vHxIjS0qyhvS84Ph8+X3eH7yuEK9/XG1ioryZJpGgluVuXrrbww/+jpx6OvEor8Th75OHPp66PoNvXYPtWgNo3vIO/vss/Xqq6/qkUce0fLly/X1r389rucGoqqqXpFI4mrj+nz5qqio6/FafralUFtEH3xUqaJR2QlrUybrq78xvOjrxKGvE4v+Thz6OnHo6/iZptHrIGm/0xsCgYAqKytjx8FgUH6/P3Z86NAhbdiwIXa8aNEivf/++/J6vaqvr1c4HJYkVVRUdHku3QUKo2XLmNcLAACQ+voNvbNnz9amTZtUXV2tpqYmrV+/XnPmzIldt21bt99+u/bt2ydJ+sMf/qDTTjtNTqdTM2fO1Nq1ayVJq1at6vJcuusoW0YFBwAAgNQX10jvsmXLtHTpUl166aVauHChZsyYoRtuuEFlZWXyeDy67777dNNNN+mSSy7Rjh07dPvtt0uS7r77bj377LNasGCBXn/9dd16660j/X0SpqNsGSO9AAAAqc+we5q0m6JSaU6vJN31xKvye3L05ctnJKxNmYw5S4lDXycOfZ1Y9Hfi0NeJQ1/Hb0hzetE7ypYBAACkB0LvEAQ8bgUPNimSPoPlAAAARyVC7xD4vTlqC0d0sLYl2U0BAABAHwi9QxDwRCs4sJgNAAAgtRF6hyDg6ajVy7xeAACAVEboHYKOsmVBRnoBAABSGqF3CEzDkL8wR+XVjPQCAACkMkLvEPk9OQoeIvQCAACkMkLvEAW8lC0DAABIdYTeIfJ7omXLqmubk90UAAAA9ILQO0QdZcuCVHAAAABIWYTeIaJsGQAAQOoj9A5RR9my8mrKlgEAAKQqQu8QmYYRreDASC8AAEDKIvQOA39hDlsRAwAApDBC7zAIeN2qONSkSISyZQAAAKmI0DsMAp4ctYVtVddRtgwAACAVEXqHgb+9bBkVHAAAAFIToXcYdJQtYzEbAABAaiL0DoPC/Cy5KFsGAACQsgi9w8A0DPkoWwYAAJCyCL3DJOBxU7YMAAAgRRF6h4nfk0PZMgAAgBRF6B0mlC0DAABIXYTeYRKgbBkAAEDKIvQOE39H2TIqOAAAAKQcQu8wiZUtY6QXAAAg5RB6h4lpGPJTtgwAACAlEXqHkZ+yZQAAACmJ0DuMApQtAwAASEmE3mHk7yhbVkvZMgAAgFRC6B1GsbJlh5jXCwAAkEoIvcMo4I2GXsqWAQAApBZC7zAaleeibBkAAEAKIvQOI8qWAQAApCZC7zALULYMAAAg5RB6h5mfsmUAAAAph9A7zAJeN2XLAAAAUgyhd5j5C3MkicVsAAAAKYTQO8xiZcuY1wsAAJAyCL3DrJCyZQAAACmH0DvMjPayZeVsUAEAAJAyCL0jIOBxK8hWxAAAACmD0DsC/F7KlgEAAKQSQu8ICHgoWwYAAJBKCL0jIOChbBkAAEAqIfSOAL8nWraM7YgBAABSA6F3BBTmueRymgoy0gsAAJASCL0jwDAM+QvdlC0DAABIEYTeERLw5FC2DAAAIEUQekcIZcsAAABSR1yhd82aNVqwYIHmzp2rlStXdrv+xz/+UYsXL9Yll1yim2++WTU1NZKkVatW6ayzztLixYu1ePFirVixYnhbn8I6ypZVUbYMAAAg6Rz93VBeXq4VK1boueeek8vl0pVXXqnTTz9dpaWlkqT6+notX75cv/3tbxUIBPSf//mf+sEPfqBvfetbKisr05133qmFCxeO+BdJNR1ly4IHm+QrzElyawAAAI5u/Y70bty4UbNmzVJhYaHcbrfmzZundevWxa6HQiEtX75cgUBAknT88cdr//79kqSysjKtWrVKl1xyiW677bbYCPDRgLJlAAAAqaPfkd5gMCifzxc79vv92rJlS+zY4/HoggsukCQ1Nzfr8ccf17XXXitJ8vl8uvHGGzVjxgw98sgjuvfee/Xwww8PurFFRXmDfnawfL78QT1XXJynLJel2ua2Qb/jaERfJQ59nTj0dWLR34lDXycOfT10/YZe2+6+EMswjG7n6urqdPPNN2vq1Km67LLLJEk/+tGPYtevv/76WDgerKqq+oQuDPP58lVRUTf450flaOfemiG942gy1P5G/OjrxKGvE4v+Thz6OnHo6/iZptHrIGm/0xsCgYAqKytjx8FgUH6/v8s9wWBQV199taZOnar7779fUjQEP/nkk7F7bNuWw9Fvxs4oAW8OWxEDAACkgH5D7+zZs7Vp0yZVV1erqalJ69ev15w5c2LXw+GwvvjFL2r+/Pn65je/GRsFdrvdeuKJJ7R582ZJ0lNPPaW5c+eO0NdITX4PZcsAAABSQb9Dr4FAQMuWLdPSpUsVCoV0xRVXaMaMGbrhhhv0la98RQcOHNA777yjcDisF198UZI0bdo03X///Xr00Ue1fPlyNTc3a/Lkyfrud7874l8olQQ8boUj0bJlVHAAAABInrjmGyxatEiLFi3qcu6nP/2pJGn69Ol67733enxu5syZev7554fYxPTVUbas/GAjoRcAACCJ2JFtBHWULQsyrxcAACCpCL0jqDDPJZfTVHk1oRcAACCZCL0jyDAM+QvdbFABAACQZITeERbw5jC9AQAAIMkIvb2wW5vU8MFrQ35PwONWxaEmhSORYWgVAAAABoPQ24vwgfdV/usHFa7cOaT3+D05CkdsVde2DFPLAAAAMFCE3l6YnnGSpHD5tiG9p3PZMgAAACQHobcXRl6xrNzCIYfejrJlVHAAAABIHkJvLwzDUNb44xUObh/SewrzXMpyWixmAwAASCJCbx+yxx0nuzaoSFPtoN9hGIb8nhymNwAAACQRobcP2eOPlzT0eb3R0MtILwAAQLIQevvgGj1FMixFhryYza1KypYBAAAkDaG3D6YzS2bxxCHP6w20ly2romwZAABAUhB6+2EFShUOfiw70jbod/jby5YFmdcLAACQFITeflj+EincqkjVnkG/I+ClbBkAAEAyEXr7YY0+VtLQFrONyo2WLaOCAwAAQHIQevth5HpluAsVDg4+9HaULaNWLwAAQHIQevthGEZ0Xm/50BezUbYMAAAgOQi9cbACJbLrKhRprBn0O/yULQMAAEgaQm8cLH+pJA1pigNlywAAAJKH0BsHs3iSZFqKDGGKQ0cFh2A1i9kAAAASjdAbB8Phklk8aUgVHDpq9TKvFwAAIPEIvXGy/KUKV3wsOzy4TSooWwYAAJA8hN44WYFSKRxSpGrXoJ6nbBkAAEDyEHrjZAVKJEnh4BDm9VK2DAAAICkIvXEy84pk5HqGNK834KVsGQAAQDIQegfA8pcMbTFbIWXLAAAAkoHQOwBW4FjZ9VWKNB4a1POULQMAAEgOQu8AxOb1DnK0N0DZMgAAgKQg9A5AdJMKx6BDb0GuS1kuypYBAAAkGqF3AAzLKdM3edA7sxmGoUAhZcsAAAASjdA7QJa/ROHKwW9S4ffkqJw5vQAAAAlF6B2g6CYVbYPepCLgdauyppmyZQAAAAlE6B0gK1AqafCL2fye9rJlNc3D2SwAAAD0gdA7QGauR0audwgVHNrLljGvFwAAIGEIvYNgBUopWwYAAJBGCL2DYAVKZDdUK9JwcMDPxsqWsZgNAAAgYQi9gzCUeb2xsmWHGOkFAABIFELvIJhFkyRr8JtU+L1uRnoBAAASiNA7CIblkFV8jMLBwW1SEfDkULYMAAAggQi9g2QGShSp2CE7HBrws5QtAwAASCxC7yBZgVIp0qZI5c4BP9tRtowKDgAAAIlB6B2kw4vZBj7FoaNsGbV6AQAAEoPQO0imu1BGXpHCwYEvZqNsGQAAQGIReocguknFwEd6DcNQwJPD9AYAAIAEIfQOgRUojW5SUV814Gf9HreCBxnpBQAASARC7xBY/hJJg5/XS9kyAACAxCD0DoFZNFGynIPapIKyZQAAAIlD6B0Cw3LI8h0zqMVslC0DAABIHELvEJn+EkUqd8puax3QcwFve+ilggMAAMCII/QOkTW6VIqEB7xJRYHbqSyXRa1eAACABIgr9K5Zs0YLFizQ3LlztXLlym7X//jHP2rx4sW65JJLdPPNN6umpkaStG/fPl1zzTW66KKL9KUvfUkNDQ3D2/oUYPnbN6kY4BQHypYBAAAkTr+ht7y8XCtWrNDTTz+t1atX65lnntG2bYcDXn19vZYvX67HH39cv/vd73T88cfrBz/4gSTpnnvu0dVXX61169Zp2rRpeuyxx0bumySJ6R4lI983yAoObpVTtgwAAGDE9Rt6N27cqFmzZqmwsFBut1vz5s3TunXrYtdDoZCWL1+uQCAgSTr++OO1f/9+hUIhvfbaa5o3b54kacmSJV2eyyRWoETh8m2ybXtAz/k9OaqqaVZbmLJlAAAAI8nR3w3BYFA+ny927Pf7tWXLltixx+PRBRdcIElqbm7W448/rmuvvVYHDx5UXl6eHI7oR/h8PpWXlw+psUVFeUN6fjB8vvx+76mZcpKqtv1d3qwWOUb5+r2/Q+lEr8Kbdsp2WPIVJ/67paJ4+hvDg75OHPo6sejvxKGvE4e+Hrp+Q29Po5eGYXQ7V1dXp5tvvllTp07VZZdd1mPA7em5gaiqqlckMrDR1KHw+fJVUVHX733h3AmSpOC7m+UsOT3u9+c4ov3x3vZKOQc4SpyJ4u1vDB19nTj0dWLR34lDXycOfR0/0zR6HSTtd3pDIBBQZWVl7DgYDMrv93e5JxgM6uqrr9bUqVN1//33S5K8Xq/q6+sVDoclSRUVFd2eyxRm0XjJcg14kwrKlgEAACRGv6F39uzZ2rRpk6qrq9XU1KT169drzpw5sevhcFhf/OIXNX/+fH3zm9+MjeY6nU7NnDlTa9eulSStWrWqy3OZxDAdsvzHDDj0FridynZZVHAAAAAYYf1ObwgEAlq2bJmWLl2qUCikK664QjNmzNANN9ygr3zlKzpw4IDeeecdhcNhvfjii5KkadOm6f7779fdd9+tO++8Uz/+8Y81ZswYPfLIIyP+hZLF8peodcuLsttaZThccT1jGIb8nhxq9QIAAIywfkOvJC1atEiLFi3qcu6nP/2pJGn69Ol67733enxu3Lhx+uUvfznEJqYHM1Aq2WsVrtwhx+jj4n4u4HFrZznzdAAAAEYSO7INEysQ3aQiMsApDn5PjioPUbYMAABgJBF6h4mZUzCoTSoCHrcitq2q2uYRahkAAAAIvcPICpQOeJOKgDdHklRezbxeAACAkULoHUZWoFR2U43s+sr+b27n90TLlgXZjhgAAGDEEHqHUce83oFMcaBsGQAAwMgj9A4j0ztecmQNqF6vYRgKeNwqZ6QXAABgxBB6h5FhWrJ8xygcHNhiNmr1AgAAjCxC7zCzAqWKVO6S3dYa9zMBL2XLAAAARhKhd5hZgRLJDitc8XHcz/gLKVsGAAAwkgi9w8z0l0jSgOb1UrYMAABgZBF6h5mZUyCjIDCgndkC7WXLWMwGAAAwMgi9I8AKlCgc3B73JhX57WXLWMwGAAAwMgi9IyC6SUWt7LqKuO6nbBkAAMDIIvSOAGuQ83qDzOkFAAAYEYTeEWB6x0vO7AHtzOb35KiyhrJlAAAAI4HQOwIOb1IxsMVsEdtWVQ1lywAAAIYboXeEWIFSRap2yw61xHW/39NetozFbAAAAMOO0DtCoptUROLepIKyZQAAACOH0DtCLH+pJMU9xSHf7VROlsViNgAAgBFA6B0hRnaejFGjFYlzMZthGPIXulV+iJFeAACA4UboHUFWoETh8m1xb1JB2TIAAICRQegdQZa/VHZznezaYFz3+z1uypYBAACMAELvCLIC7fN649ykIuDJoWwZAADACCD0jiDTMy66SUUwvnm9VHAAAAAYGYTeEWSYpiz/lLhHeqnVCwAAMDIIvSPMCpQqUr1bdqj/KQuULQMAABgZhN4RZvlLJduOa5MKwzDk97iZ3gAAADDMCL0jzAqUSBrYYrYg0xsAAACGFaF3hBlZuTILxwxgXi9lywAAAIYboTcBTH+pIsGP4tqkoqNsWSVlywAAAIYNoTcBrEBJ+yYV5f3e21G2LMi8XgAAgGFD6E2Aw5tU9F+v1+9tL1tGBQcAAIBhQ+hNANMzVnLmxDWvNz+nvWwZi9kAAACGDaE3AQwj/k0qKFsGAAAw/Ai9CWIFShU5uEd2a/8juAFPDqEXAABgGBF6E8QKlMS9SQVlywAAAIYXoTdBLH/8m1QEPDmybVG2DAAAYJgQehPEyMqV6RkbX+j1UrYMAABgOBF6E8jylyoc3N7vJhV+D2XLAAAAhhOhN4HMQInU0iC75kCf90XLljlYzAYAADBMCL0JdHiTir6nOETLluVQqxcAAGCYEHoTyCwcI7ncce3MRtkyAACA4UPoTaDYJhXBeCo4ULYMAABguBB6E8wKlCpSvbffTSr8lC0DAAAYNoTeBIvO67UVDn7U530dZcvKq5niAAAAMFSE3gSz/FMkGf0uZgu0ly1jMRsAAMDQEXoTzHC5o5tU9DOvN4+yZQAAAMOG0JsEVqBE4fLtsu3eF6kZhtFewYGRXgAAgKEi9CaB5S+VWhsVOdT3JhXRWr2M9AIAAAwVoTcJzNHRTSoi/c7rpWwZAADAcCD0JoE5arSUldvvvN6AN1q2rOIQUxwAAACGgtCbBNFNKkr63ZnN74mWLaOCAwAAwNDEFXrXrFmjBQsWaO7cuVq5cmWv991xxx167rnnYserVq3SWWedpcWLF2vx4sVasWLF0FucIaxAiSIH98lu7X3ObkfZMhazAQAADI2jvxvKy8u1YsUKPffcc3K5XLryyit1+umnq7S0tMs9d999tzZt2qTTTz89dr6srEx33nmnFi5cODKtT2OW//AmFY7x03q8Jy/HKXeWg8VsAAAAQ9TvSO/GjRs1a9YsFRYWyu12a968eVq3bl2Xe9asWaPzzz9f8+fP73K+rKxMq1at0iWXXKLbbrtNNTU1w9v6NBbPJhWGYchP2TIAAIAh63ekNxgMyufzxY79fr+2bNnS5Z7rr79ekvTGG290Oe/z+XTjjTdqxowZeuSRR3Tvvffq4YcfHnRji4ryBv3sYPl8+SP05ny1+ifIOrijz8+YOKZA7+88OILtSC1Hy/dMBfR14tDXiUV/Jw59nTj09dD1G3pt2+52zjCMuF7+ox/9KPb79ddfrwsuuGAATeuuqqpekUj39owUny9fFRV1I/Z+2ztFTR+9qmCwRobR86D7qBynggcbtf9AjRxWZq87HOn+xmH0deLQ14lFfycOfZ049HX8TNPodZC03xQVCARUWVkZOw4Gg/L7/f1+aF1dnZ588snYsW3bcjj6zdhHFStQIrU2KXJwf6/3ULYMAABg6PoNvbNnz9amTZtUXV2tpqYmrV+/XnPmzOn3xW63W0888YQ2b94sSXrqqac0d+7cobc4g1iB6GLAvur1BihbBgAAMGRxjfQuW7ZMS5cu1aWXXqqFCxdqxowZuuGGG1RWVtbrc5Zl6dFHH9Xy5cs1f/58bd26VbfffvuwNj7dGe2bVPS1M5ufsmUAAABDFtd8g0WLFmnRokVdzv30pz/tdt+DDz7Y5XjmzJl6/vnnh9C8zGYYRr+bVHSULSunbBkAAMCgZfbKqDRgBUoVObRPdktDj9c7ypYxvQEAAGDwCL1Jdnheb++jvQGvW+XVjPQCAAAMFqE3ySz/FMkw+pziEPDkqKq2WW3hSAJbBgAAkDkIvUlmOLNlesf3uTOb30PZMgAAgKEg9KYAy1+qcPAj2XbPI7kdZcuo4AAAADA4hN4UYAVKpVCTIgf39Xg94KVWLwAAwFAQelOAFSiRpF6nOORmOyhbBgAAMASE3hRgFARkZOf3upjNMAwFvDkKUsEBAABgUAi9KcAwDJn+KYqUf9jrPX6Pmzm9AAAAg0ToTRFWoFSRmgOym+t7vE7ZMgAAgMEj9KaI/japCHjclC0DAAAYJEJvirB8x7RvUtHzYja/J0cSZcsAAAAGg9CbIqKbVEzsfaS3o2wZi9kAAAAGjNCbQqxASXSTikj3ebt5OU7lZjtUzvQGAACAASP0ppDoJhXNihzc2+N1v4eyZQAAAINB6E0hscVsvczrDVC2DAAAYFAIvSnEyPdFN6kI9r6Yraq2WaE2ypYBAAAMBKE3hRiGIStQ2uvObB1lyyprGO0FAAAYCEJvijEDJbJ72aTC720vW1ZN6AUAABgIQm+Ksfwdm1R0n+IQ8LSXLTvIYjYAAICBIPSmmOgmFabCB7qH3ljZMhazAQAADAihN8UYziyZRRN63aTC73Ez0gsAADBAhN4UZPlL2zepCHe7FvDkMNILAAAwQITeFGSNLpXaWhSp3tPtGmXLAAAABo7Qm4IOL2brPsWBsmUAAAADR+hNQUZ+sYycgh53ZqNsGQAAwMARelNQX5tUULYMAABg4Ai9Kcr0l8quLVekqbbLecqWAQAADByhN0VZgRJJUqSHeb1+j1vljPQCAADEjdCboqKbVFg9T3Hw5ijISC8AAEDcCL0pynC4ZBZP7HkxWyFlywAAAAaC0JvCLH+JwhXdN6kIeKNlyyoOMdoLAAAQD0JvCrMCpVJbqyLVu7uc93uiZcuY4gAAABAfQm8K61jMduQUh46yZSxmAwAAiA+hN4UZecUyckZ1W8zWUbaMkV4AAID4EHpT2OFNKnpYzEbZMgAAgLgRelOcFSiVXVfRbZOKgDeHrYgBAADiROhNcWagVFLP83qrKVsGAAAQF0JvirOKJ0mmpcgRodfvyZEtypYBAADEg9Cb4gyHS2bRJIWP2I6YCg4AAADxI/SmAStQonDwY9mRttg5avUCAADEj9CbBqxAqRRuVaRqT+xcR9myckIvAABAvwi9acDqbTGb160g0xsAAAD6RehNA0auV4a7sFvo9XsoWwYAABAPQm8aiG1SEeytbFk4SS0DAABID4TeNGEFSmTXVSrSeCh2LhArW9actHYBAACkA0JvmrD8HfN6D5cu81O2DAAAIC6E3jRhFk+STEeXeb0Bb7RsGfN6AQAA+kboTROGwyWzeJIinTapyM2Oli0LsisbAABAnwi9acQKlCpc8bHs8OFNKgJet8qrmd4AAADQF0JvGrECJVI4pEjVrti5gCeHXdkAAAD6EVfoXbNmjRYsWKC5c+dq5cqVvd53xx136Lnnnosd79u3T9dcc40uuugifelLX1JDQ8PQW3wUiy1mC3ZdzEbZMgAAgL71G3rLy8u1YsUKPf3001q9erWeeeYZbdu2rds9X/ziF7Vu3bou5++55x5dffXVWrdunaZNm6bHHntseFt/lDHzvDJyvV0Xs7WXLQtStgwAAKBX/YbejRs3atasWSosLJTb7da8efO6hds1a9bo/PPP1/z582PnQqGQXnvtNc2bN0+StGTJkm7PYeCsQMkRFRyiZcvYjhgAAKB3jv5uCAaD8vl8sWO/368tW7Z0uef666+XJL3xxhuxcwcPHlReXp4cjuhH+Hw+lZeXD6mxRUV5Q3p+MHy+/IR/Zl8OTTlJ1R+9Jk92SI58r3JysyRJDa2RlGvrYGTCd0gX9HXi0NeJRX8nDn2dOPT10PUbem3b7nbOMIx+XzzY5/pSVVWvSKT7e0eKz5evioq6hH1ePMK54yVJwXfeknPKJyVJeTlOfbTnUMq1daBSsb8zFX2dOPR1YtHfiUNfJw59HT/TNHodJO13ekMgEFBlZWXsOBgMyu/39/uhXq9X9fX1CoejC6wqKirieg59i21S0WUxWw5lywAAAPrQb+idPXu2Nm3apOrqajU1NWn9+vWaM2dOvy92Op2aOXOm1q5dK0latWpVXM+hb4bllOmb3G0xG3N6AQAAehfXSO+yZcu0dOlSXXrppVq4cKFmzJihG264QWVlZX0+e/fdd+vZZ5/VggUL9Prrr+vWW28drnYf1Sx/iSKVO2KbVAQ8blXXtlC2DAAAoBf9zumVpEWLFmnRokVdzv30pz/tdt+DDz7Y5XjcuHH65S9/OYTmoSdWoFShshcVqdopy18if6eyZeOKc5PdPAAAgJTDjmxpyAq0b1LRPsUhVraMeb0AAAA9IvSmITPXIyOvSOHy6GI2vydHklTOdsQAAAA9IvSmKct/eJOK3Gyn8nKcLGYDAADoBaE3TVmBUtkN1Yo0HJQUreCQriO9EdvWvsoGhRNYgxkAABxd4lrIhtTTeV6vOeWT8nty9MHuQ8lt1AA0Nrdp645qbdlWqbKPqlTbGNLcT03UVeeVJrtpAAAgAxF605RZNFGynAqXb5NzyicV8Lj1963lCrWF5XRYyW5eN3b7aO6Wj6q0ZVuVtu2tUThiKzfboWlTimQahl76xy6NL3Lr0yePTXZzAQBAhiH0pinDcsgqnhzbmc3vTb2yZS2hsN7beVBbtldpy/YqVdU2S5Im+PN00ekTNaOkSFPGFsgyTUUitppaw3rqpQ80MZCvSaPZYxwAAAwfQm8aMwMlCr39R9nhkAKew2XLkhl6Kw41xULue7sOKtQWUZbT0omTPbp49iTNmFIkb0F2t+dM09Btn/uEvvzQn/TYqjLdfd0n5c52JuEbAACATEToTWNWoFShLesUqdwpv2eSpMSXLWsLR/ThnhqVba/S5u2V2l8VrSDh9+To7FPG6uSSYh03oVBOR/9rJkflZelLl07Td1a+qSdeeFf/evl0mYYx0l8BAAAcBQi9aazzYrbcQGnCypbV1LdE5+Zur9I7O6rV1BKWwzJ0/IRCnX3KOJ1cUhTbMGOgSseN0mfPK9X//PFDrXt1lxbMmjTMrQcAAEcjQm8aM92F7ZtUtO/MNkJlyyK2rY/312rLtipt+ahKOw/USZI8+Vn65NSATi4p0gmTPcp2Dc8fpws+MV7b99bot69s1zFjCnTCJM+wvBcAABy9CL1pzgocq/CB9yVJfo9bH+w+OCzvbWgOaevH1dq8rUpvf1ylusaQDEMqGTdKS+ZM0YySIk3w58kYgekHhmHouvlTtTtYr5+sflt3//On5MnPGvbPAQAARw9Cb5qzAiVq2/53ReqrFPDk6O9bDwyqbJlt29pb0VFSrFLb9tYqYkdLik0vKdKMKUWaNqVIeTmJWVyW7XLo5sum69v/3+v68eq39fWrTpXDYi8VAAAwOITeNHd4Xu92+b0To2XLDjZpnC+v32dbWsN6d+dBbdleqS0fVam6tkWSNNGfpwVnTNSMkmJNGVMg00zOYrJxxbm6bv5U/eR3W/WbP2/Xlecfm5R2AACA9EfoTXNm0QTJcilcvk2BY6ZK6jv0Bg82diopdkht4YiyXJZOmuzVJWcWafqUopSaSnD6iQFt21Oj9a/tVum4UZo51Z/sJgEAgDRE6E1zhumQ5ZuscHCbAqflSOpatqwtHNEHuw/Fgu6B6mh1h4DXrfNOG6fpJUU6bnx8JcWS5Z/OL9XHB2r187Xvarw/T6MHWRkCAAAcvQi9GcAKlKq17EXlOWzl5Tj10f5a/WXzPm3ZXqWtO6rV0tpeUmyiR+eeNk4zSopim1mkA4dl6uZLp2n5L17Tj54v07eunaksV+pttQwAAFIXoTcDmIESaXNYkcqdCnhz9Pp7Qb3+XlCe/CydcWJA00uKdOIkb1oHRW9Btm665CQ98sxb+u8X39P1C08ckcoRAAAgMxF6M4Dlb1/MFtymy+fM0sf7azVtSpHG+3IzKhiedIxXiz99jFb99WOVji/UuaeOS3aTAABAmiD0ZgDTPUpGvk/hA9s0dcZ8Tc3gzRwWzp6s7Xtr9T9//ECTR+frmDEFyW4SAABIA6m7egkDYgVKFA5ul23byW7KiDINQzcsOlGjcrP02PNlqm8KJbtJAAAgDRB6M4TlL5XdeEh2fVWymzLi8nKcuvmyaappaNXja7YqkuFBHwAADB2hN0NYozs2qdiW5JYkxjFjCnT1Bcfp7Y+q9cLfdiS7OQAAIMURejOE6Z0gOVwKB7cnuykJc/YpY3XGSaO1esPHevvjzB/hBgAAg0fozRCGacnyHXPUjPRKkmEYWnrR8Rrny9Xjv3tHVTXNyW4SAABIUYTeDGIFShWp3CW7rTXZTUmYLKelmy+brrZwRD9e/bbawpFkNwkAAKQgQm8Gsfylkh1WuHJHspuSUKO9bn3h4hP00b5aPfO/R89INwAAiB+hN4OYgRJJUuQomuLQ4RPH+zXvUxP0v2/u0d+3Hkh2cwAAQIoh9GYQM6dARoFfoR1vym5tTHZzEu7ys0t07PhRenLde9pbUZ/s5gAAgBRC6M0wrmlzFSnfroZnv6HQ9n9k/GYVnTksU19cPE3ZLod+9PzbamppS3aTAABAiiD0ZhjXtLlyX3qXDPcoNf/vY2r6w8OK1AaT3ayE8eRn6YuXnKTyg4168g/vHVWhHwAA9I7Qm4Es/xS5L71bWbOvUbh8mxp+/Q21vLladvjo2LJ36iSPrji7RK+9F9QfX9+T7OYAAIAUQOjNUIZpyjVtrnI/+4Ack05T6+vPq/E3d6lt37vJblpCXHT6RJ16bLGe/dM2bdtTk+zmAACAJCP0Zjgz16OcC25Wzvz/JzsSVtML31HTnx5XpKk22U0bUYZh6AsXn6Cigmz9ePXbqm04emoXAwCA7gi9RwnHhBnK/cz9cp26SG3bX1XDM3eq9d0/y7YzdzMHd7ZTN182TfVNIf3kd1sViTC/FwCAoxWh9yhiOFzK+uTlcl9+n6yiiWr565NqXH2/wlW7kt20ETMxkK/PXXic3t15UKs2fJTs5gAAgCQh9B6FLM9Y5Sy8Q9nn3CC7NqjG55ar+e+/kh1qTnbTRsSnZ4zVnJPH6IWNO/XWtspkNwcAACQBofcoZRiGnMedqdzPPiDn8Z9WaMu6aG3fHW9kZJmva+Yep4mBPD2x5h1VHGpKdnMAAECCEXqPckZ2nrLn/LPcl3xTRpZbzet/oKYX/1ORuswaEXU6LN182XRJ0mPPv61QWzjJLQIAAIlE6IUkyRp9rNxLlivr9H9SeN870dq+b62VHcmcXc38hTm6ftGJ2llep5UvfZjs5gAAgAQi9CLGMB1ynTw/Wtt3/DS1/uNZNf52udoOfJDspg2bU0qLdfEZk/SXzfu0Ycv+ZDcHAAAkCKEX3Zh5Rcq58CvKufCrslsb1fS7/1DzKz+X3Vyf7KYNi0s/fYxOmOTRL9e/r13ldcluDgAASABCL3rlmHyqcj/7H3LOmK/QBxvU8MydCr3/17Rf6GaZpm665CTlZjv02PNvq7H56NieGQCAoxmhF30ynNnKnvVPcl9+j4zC0Wp+5WdqeuFBhQ/uTXbThqQg16UvXTpNVbXN+tnv3037IA8AAPpG6EVcLO8EuS/5hrLm/LPC1XvU+Jt/V8s/fiO7rSXZTRu0Y8cX6jPnlur/PqzUun9k7gYdAABAciS7AUgfhmHKNfVsOSadqpZXn1HrWy8otP3vyj7zWjkmnpzs5g3K3JnjtW1vjX775480ZUyBjp/oSXaTAADACGCkFwNm5hQo55wblLPwDhmWU03rVqjppR8qUl+d7KYNmGEY+uf5U+X35OjHq7fqUH36jlwDAIDeEXoxaI6xJ8h9+X1yffJyte3arIZff0OtZS/KjqTXxg85WQ7dctk0Nbe26b9Wva22cCTZTQIAAMOM0IshMSyHsk5dpNzP3C9r9HFq2fQ/anz+HoWDHyW7aQMyzpenz180VR/sqdFzr6RX2wEAQP8IvRgWZoFfORctU/YFt8huqlXjqvvUvOG/Zbc0JLtpcTvjpNE697RxWvePXXrj/YpkNwcAAAwjQi+GjWEYck75pHI/+4Cc0y5Q6N0/qeHZf1No29/TpiTYlecdq2PGFOjna99ReXVjspsDAACGCaEXw85w5Sh79jVyX3a3jLwiNb/8X2pa+5AiNQeS3bR+OR2mbr50mizT1I+eL1NLKL3mJwMAgJ7FFXrXrFmjBQsWaO7cuVq5cmW36++++64uv/xyzZs3T9/85jfV1tYmSVq1apXOOussLV68WIsXL9aKFSuGt/VIaVbxZLkX36WsM69VOPiRGn79LbW8/rzsttZkN61PRaOydeOiE7W3okG/fPH9tBmlBgAAveu3Tm95eblWrFih5557Ti6XS1deeaVOP/10lZaWxu65/fbb9e1vf1unnHKKvvGNb+jZZ5/V1VdfrbKyMt15551auHDhiH4JpC7DNOU66Xw5jvmEWjb9Sq1vrm6v7btUjvEnJbt5vZo2pUiXnHWMVm/4WKXjR+mcU8Ylu0kAAGAI+h3p3bhxo2bNmqXCwkK53W7NmzdP69ati13fu3evmpubdcopp0iSlixZErteVlamVatW6ZJLLtFtt92mmpqakfkWSHmmu1A5539ROQtuk2ypae331PTyfynSeCjZTevVojMna9oxXj390gf6eH9tspsDAACGoN+R3mAwKJ/PFzv2+/3asmVLr9d9Pp/Ky8tjv994442aMWOGHnnkEd177716+OGHB93YoqK8QT87WD5ffsI/M6P5zlBk+id0aOPzOrTxOUV2b5H33GuUf+rc6OUU6+87r/uUlj36in7yu6169P+do3y3K9lNGjap1teZjL5OLPo7cejrxKGvh67f0NvTfEbDMOK6/qMf/Sh27vrrr9cFF1wwqEZ2qKqqVySSuPmVPl++KirqEvZ5R5UTFih3zGlq/tt/q3LdT1X9xh81ev71qstOvWkENy06SQ889YYefPIf+soVM2R2+vOfrviznTj0dWLR34lDXycOfR0/0zR6HSTtd3pDIBBQZWVl7DgYDMrv9/d6vaKiQn6/X3V1dXryySdj523blsPRb8bGUcQsHK2cBbcr+7ybZNdXad9/f1ONax9SuHxbspvWxZSxBbr6gmO1ZXuVfr9pZ7KbAwAABqHf0Dt79mxt2rRJ1dXVampq0vr16zVnzpzY9XHjxikrK0tvvPGGpGjFhjlz5sjtduuJJ57Q5s2bJUlPPfWU5s6dO0JfA+nKMAw5S89Q7pXfk/f8pYpU7lTj6m+r8Q+PpNSubuecOk6zTgpo1V8+0tYd1cluDgAAGKC4RnqXLVumpUuX6tJLL9XChQs1Y8YM3XDDDSorK5MkPfTQQ3rggQc0f/58NTU1aenSpbIsS48++qiWL1+u+fPna+vWrbr99ttH/AshPRnOLBXOWqzcq74n16c+o3BwuxpX3avGdSsUrtyR7ObJMAx9ft5UjS3O1U9Wb1V1bXOymwQAAAbAsNOoCClzejNb5/62W5vUuvWPat2yTmppkGPSqXJ94lJZxZOS2sb9VQ267/97XeOKc3XHNafJYaXn/i782U4c+jqx6O/Eoa8Th76O35Dm9ALJYLhylHXqIuVd9T25Zl6mtv3vqfG5u9W0/gcKV+9OWrvGFOXqXxacoO37avXsy6k19xgAAPSOlWVIaYbLrazTFst10gVqLVuv1rL1atvxhhxTPinXaZfK8ia+2sPMqX5d+MkJWv/abpWMG6VPneDvUtEEAACkHkIv0oKRlausmZfJNW2uWsteVOvbL6nto9flKPmUXJ9YLKtwbELbc8U5Jfpof61+8rutevx3W+VwmHJaZvtPQw7LlNNhyhE7d/g4+tOI3t/rfcbh+3u4p6fPcTpMWaZBAAcAoAeEXqQVIztPWZ+8XK7p89S6ZV17+P2HHCWzlHXaYpmFoxPSDodl6stLpmvDlv1qag2rLRxRW1tEbeGIQm0RhcIRtYVthTrOhSNqbGmL3ReK/Tx8z3AwJDk6heCOYNw1LJsqmVCoTx7n0wR/4jd8AQAgGVjI1gcmjifWYPo70lSr0JZ1at36RykckqN0trJOu0TmqMAItXJk2LatcMQ+HJg7Bei2sK1Q7PfDoTnUzz29BfDWtrB2ldcr1BbRlLEFOvvksfrUCQFluaxkd0NG4u+RxKK/E4e+Thz6On59LWRjpBdpzcwpUNbpn5VzxkVq3bxWoa3/q7Ztm+Q49kxlnbZIZoG//5ekAMMw5Ggflc1JwOdlubO05pVteuWtvfrFH97Tr17+ULNOHK2zTxmriQG2ugQAZB5CLzKCmVOg7FlXyjXjIrW+tVahd19W24cb5Tz+TLlOXSQz35fsJqaUglyXLvzkBM2dOV4f7qnRK2/t01+37Nef/m+vjhmTr7NPGadPneBXtou/IgAAmYHpDX3gPyck1nD2d6ThoFrf+r1C7/5Zki3n8Z+Oht+8omF5f7rrqa/rm0LatPWAXnlrn/ZVNijbZWnWSaN19sljNWk0o7+Dxd8jiUV/Jw59nTj0dfyY3oCjjpnrUfaZn5Pr5AVqfesFhd57RaH3N8g5dY5cpyyUmedNdhNTTl6OU3NnTtAFnxiv7Xtr9cpbe/W3sv368//t1aTR+TrnlOjc35ws/toAAKQfRnr7wL9ZJdZI9nekvkqt/7dGoff+KpmGnFPPkeuUi2Xmekbk81JdvH3d0BzS37eW689v7dXeigZluSzNOjGgs08Zq8mjCxLQ0vTH3yOJRX8nDn2dOPR1/BjpxVHPzCtS9qevk+uUi6Ph952XFXrvFTlPOFeuUxbIdBcmu4kpKTfbqfM/MV7nnTZO2/dFR383vR2dAjEpkK+zTxmr009k9BcAkPoY6e0D/2aVWIns70htUC1vrlHbh3+TTIecJ50n18kLZOYcHaOXQ+nrxuaQNm0t1ytv7dWeigZlOS2dfqJfZ58yTpNH57M5xhH4eySx6O/Eoa8Th76OHyO9wBHMAr9yzvmCIqcuVMubv1Oo7EWF3nlZrpMukPPk+TKzWbjVG3en0d+P9tfqlbf26e/vlOsvm/droj+vffR3tNzZ/PUCAEgdjPT2gX+zSqxk9nfk0H61vPk7tW37u+TMkuukC+SacZGM7MzcsWy4+7qxuU2vvnNAf35rn3YH6+VymvrUCdG5v1PGFBzVo7/8PZJY9Hfi0NeJQ1/Hj5FeoB9m4RjlnHeTwqcuUuubq9X61u/VuvWPck2bGw2/WbnJbmJKc2c7dO5p43XOqeO040CdXnlrr159J6gNW/ZrvC86+nvGSQG5s53JbioA4CjFSG8f+DerxEql/g5X71Xrm6vU9tFrkjNHrukXyjX9wowJv4no66aWNr36TrTyw67yerkcpj55QnTub8nYo2f0N5X+XB8N6O/Eoa8Th76OHyO9wABZ3nHKueAWhat2q/WNVdHR37dfkmvGPLmmXSjDlYjNgtNbTpZD55w6rn309/Dc37+VHdA4X67OPnmszpg2WrmM/gIAEoCR3j7wb1aJlcr9Ha7cqdY3Vqlt5/9JWblyzbhIrpMuSNvwm6y+bmpp0z/eLdcrb+3TjgN1cjpMfWpq++jvuMwc/U3lP9eZiP5OHPo6cejr+PU10kvo7QN/yBIrHfo7XLFDLW88r/CuzTKy8uQ84ZzolAdDiv4fo/339uNYiDMO39P5nHT4uP2n0fkew1CnF/Z83ujhc7udN9rfG/3dMyagWsMrw5k1lO4Ykp0H6vTK5n36+9YDam4Na1xxruacMlazM2z0Nx3+XGcS+jtx6OvEoa/jR+gdJP6QJVY69Xc4+JFa3lil8O4tyW7KEBgyCvyyiibI9E6QWTRelneijPwiGYaZsFY0t7bpH+8G9cpbe/Xx/ujo78zj/Tr7lLE6dvyotB/9Tac/15mA/k4c+jpx6Ov4MacXGGaWf4rc8/+f7LYWKRJpP2tLnf8dsv13u/N5247e1+l6z+ft9sMe7rE73trpni73dj7f87l8R4sOfvyBItW7Fa7erbaP3zj8vDNbpne8rKKJ0Z/eCTK940dsKke2y6E5J4/VnJPHaueBOv1l8z5t2npAm7Ye0Jgit84+ZZxmTxutvJzMGf0FACQeoRcYAsPR//SAVBynzPXlq9F7QuzYDjUrcnCvwlW7FanerUjVboW2bZJam2L3GPm+TqPCE2R5J8go8A3rqPCk0fm6dvTx+uy5pdG5v5v36Vf/+6F+8+ftmnm8TydM9miiP19ji3PldCRuNBoAkP4IvQBkOLNl+Utk+Uti52zblt1QrUjVrvYwvEeRql3RxXwdI8iOrMOjwUXjZRZNlOUdL8PlHlJ7slyWPn3yWH365LHaVd4x+luuv79TLkmyTENjinI1MZCnif48TQjka4I/j9FgAECvCL0AemQYhoy8Ipl5RXJMOjV23m5rUeTgPoWrdrUH4d0Kffya9N6fDz+bVxSbHhEdFZ4oo8Avwxz46OzEQL4+d+HxuvqC4xQ81KRd5XXaHazXrvJ6bd1RrY1vH4jdW1SQpQn+fE0M5MV+Fo/KTvt5wQCAoSP0AhgQw5Ely3eMLN8xsXPRUeGD0TnCHVMkqnerbddmyW6f82y5ZHrHHZ4i4Z0gq2hC3Bt+mKah0V63Rnvd+tQJgdj5moZW7Q7WaXd5vXYF67WrvE6bt1fGBqNzsixN8EVHgyf68zQxwPQIADgaEXoBDFl0VNgrM88rx8STY+fttlZFDu1TpGq3wh3TIz5+U/Z7fzn8bK43NkfY7AjEowIyTCuuzx6V69KoY4o07Zii2LmWUFj7Khu0q7xOu4L12l1erw1b9qslFJbUMT3CHRsN7pgiwfQIAMhchF4AI8ZwuGQVT5ZVPFkdcdK2bdlNNe1zhffERoVbd78t2dFQKssp0zOufTS4Y67wBBnZPZehOVKW09IxYwp0zJiC2LmIbaviYFNsNHh3sF7v7qzWpq2Hp0d4C7I00R+dHzwxEA3CxaOyZTI9AgDSHqEXQEIZhiHDXSjTXSjHhBmx83Y4pMih/e2jwtEKEuHdm9X2wV8PP5yVK7MgILPAL7PAFx0RLvDLLPDLyOm7pq9pGAp43Qp43frkVH/sfG1Da3SOcKcpEkdOjxjvy4uG4UA0DI8rzpXTEd9INAAgNRB6AaQEw3LKKpooq2iiOk8yiDTWxEaDIzVBRWqDCge3q+2jV7vWOnZkRYNwQUBGga89GEcDspHn7XW6REGuSycd49VJx3hj51pDYe2tbGhfMBedIrHh7f1qeTM6Em0ahsYUu6PTImIL5/KU73aNRNcAAIYBoRdASjPdo2S6R0njp3U5b4fbZNdXKlIbjIXhSG0wOlq8e7MUbjt8s2HJKChuD8KH/2cUBGTmF8twdA2rrt6mRxxqah8NrtOu8nq9t+uQNm0tj93jyc+KzQ+e2D5ForedgQAAiUXoBZCWDMshY9RomaNGSxO6XrPtSLSaRHsQtjsCcU1QoQPbpFBT5zfJyPUcDsKjjgjG7TWHTcNQwONWwOPWzM7TIxqj0yM6wvDu8nqVfVStSPsodJbLUlFBtopHZR/+OSpbxaNyVDQqWwVuJyXVACABCL0AMo5hmLEawxp7Qpdrtm3LbqmXXVN+eHS4/X9tu96S3VTb9V3Z+e3TJQJHjBL7ZeQUqMDt0kmTvTppcs/TI6obWrXnQJ0qa5q0fW+NGprburzf5TBV1BGECw4H4uJR0YBckOsiFAPAMCD0AjiqGIYhIztfys6XFSjtdt1ubeoUhCtk10bDcfjAB2rb9ndJneYRO7Oj84jz/V0W1TkK/Joc8OqYMQXy+fJVUVEXe6SppU1VNc2qrGlWZU2TKmuaVVUbPd6xv071TaEu7XFYZnsQ7jpa3DFSPCrPRXUJAIgDoRcAOjFcObKKJ8kqntTtmh0Oya6rVKS2XJHaCkU6RosP7lXbrrekSPjwzaZDZn6x2orHqM1ZEK1jnOuVM9ejMblejZvkkeEq7vYZza2dQ3Fz9PfaZlXVNOnN8jrVNR4Zig15C44MxTmxoFyYlyXTJBQDAKEXAOJkWE4ZhWNkFo7pds2ORGQ3VHedR1xTrnB9tdpqtsluruv+QmeOzDxPdIOO3MM/A7lejfZ6ZE7wSi53l+kNLa3h9hAcDcKxcFzbrLe2Vam2obXLR1imIW9BVpcg3Hm0uDDfJWsQ20MDQLoh9ALAMDBMU0Z+scz8YmncibHzHdMb7LZW2Y2HFGk4GA3H9dGfdsNBRRqq1Va9R3ZjjbpMn5AkhysahvO80QV3uV752oOxMdEjIy8gIysvFoxbQmFVt4fiyk7TKKpqm1X2UZVq6ruHYk9+VtcFdgXZ8uRnKd/tVF6OU/luF9s2A0h7hF4ASADD4YrN+e2NHWmT3Vgju776cDju9DOy9121NR6S7EjXBy1Hl9Fib65HRbleHe/xyBzvlZE7XkZOgQzDVKgtrKralvZQ3NRlCsU7Ow7qUN2BI2O3JCnbZSnfHQ3A0SAc/b1zMI6dy3Eq22WxAA9ASiH0AkCKMEyHjLwiKa9Ive33ZkfCsptq20eLD48U2w0HZTccVLj8Q7U1HOw6v1iSTCu6E15ekUblelSY69GxuV4ZEzwyT/DKyB0rI2eU2iJSdV2zaupbVdfYqrqmkOoaQ6prbFV9+89D9S3aHaxXXWNIbeFIj+10WGY0BHcKyH2F5dwcJwvyAIwoQi8ApBHDtGTkeqRcjyx/SY/32HZEdlNdp0DcHo7bQ3K4YofsHW9K4dCRL5fhLlRerkcF+T6ZhdE6yOb4MTJHTZLhzDric2w1t4ZV1xSKBeK6xpDqmjoCcigWnIOHalTfFFJTyxFhvOOjDSkvp+dR4zy3s8txx3WHxZQLAPEj9AJAhjEMU4Z7lOQeJcs3ucd7bNuWWhpiobhjjnHHdIpwcJvatr+qznOMjVyvzMIx0SBcOFpm4RhlFY5R9iiP/IU5cbUt1BZRfVPXgFzXHpDrO40s76tsUF3jITU0hXqcbiFJOVmW8nMOjxrnuZ3KdWepubm12712Ly/p7d19XbT7emown6No6DcNQ4ZhyDSNTsfRn6ZhyDA73dP5utlx7ojnzMP3drluHvHejnvMzu/t9FyX9hgyTcmQofpQRAcPNkbb3/5/jPYvY7R/p+ih0fP12Dkj1gcd93ccd76/4/lu12XEnj183uh0f9d7ul9P7//CELFthcMRtYVttbX/DIcjaotEj8Ox8+3n2trviUS63h+21RY54rjj+U739vTOnu4Ph21dcU6JzpzefeFvshB6AeAoZBiGlJ0nKztPKprY4z12W2u0LFvNfkUOHYhu8VxzQKEP/yaFmg/faLlkFgZkjopWtoiOEEd/Gs7sLu90Okx58rPkyc9SPCIRWw3NnUaNG0NHhObo7wfrWrQrWC/DMBSJ9DzlYjDhprdH+n5Tz1d7e5dtR4O0bUe/r23bithq/9n+e6Trud5CPAavcwjvHJA7AnOXkN4pMB8Z8DueG2hgPzKMd/6XB9M01RpqiwXSUKdgGhmhPwwOy5BlmXKYhhyWefi445wj+tNpmcpxOTpdN+Qwoz/H+1JrG3ZCLwCgR4bDJatogqyirvs827Ytu6kmGoI7heFwxcdq+/i1LsOqRq6nfWS46wixkVckw+h/eoJpGu3TGVyScvu9/8jNQDKVbUfHm6MhWe1B2FYkEg3QXc93DtOHzx8O053P9R6+D5+P3pufn63a2qbY/7vt9nZF29c+Im63j3J3CvZHXu94tvP3Ovyc3f7evq+r8z2dPrdrezrd39v1XtrY13ew7U7Xem273akNR7Yx1upe25Wd5VC4Ldw1dFqmLCsaOi2rI5i2/94eOh2dr5mdQmt7QHXG7jkcVi3LkNX+XwkyDaEXADAghmFEF8W5C7tv89zWGt2449A+RWoORENxzX6Ftm2SWpsO32g5ZY4KHA7EsVA8RoYrvqkSR7OOEUbTSl4wOVr+BSMV0NfDg9ALABg2hsMlyztOlndcl/PR0eHa9iC8P/YzXLVbbTve7FKGzcgZ1W2aRHR0uFgGG2kAGCRCLwBgxEVHh0fJdI+Sxhzf5ZodbovuZFez//CUiZoDCn30mtTScPhGyyGz4IjR4fYKE0ZW/1MfABzdCL0AgKQyLIcsz1hZnrFdztu2Lbu57vDo8KEDsmsOKHxwr9p2viXZh8ufGTkFMgsC2u92q7W1LcHfYBgcWX5ARx7HDtpPGUdc6+X+Xt9ldDrdy/1G52tGbFFXx7WKbJeam0Nd39HrOzs78t7O53qartHLtT7u7XE+ak991dt7+r238/fr9ssA7u1auaK3vjmUl6XWzrsp9tR3XV90hJ7aMJhne1vZ2f28IUPWxJOj/6KbIgi9AICUZBhGNMzmFEijj+tyzY60ya6tUOTQAYUP7Zddsz86WtzaLLut51rAKatjJZR0eKVTl2vt52Kn7S6LwI681uO7Oi346nZ/l9X/nVZp9dSGTseNpqFIxO5+vdt3637cY9m3nt5jd/ulh/fafdzby7WB3JsCWpLdgEFyzVyirNMuSXYzYgi9AIC0Y5gOGe1THBw6NXaeBT+Jc7T1tR1XKO8jOHcrLdZbIO8etouLclVZVd/r9b7O2322oafzA3t/X88aud6en0kSQi8AAEA/jD6nK4wsMztXhqvn+tP9ybzCY4PHMlgAAABkPEIvAAAAMl5coXfNmjVasGCB5s6dq5UrV3a7/u677+ryyy/XvHnz9M1vflNtbdGVs/v27dM111yjiy66SF/60pfU0NDQ7VkAAABgpPUbesvLy7VixQo9/fTTWr16tZ555hlt27atyz2333677rrrLr344ouybVvPPvusJOmee+7R1VdfrXXr1mnatGl67LHHRuZbAAAAAH3oN/Ru3LhRs2bNUmFhodxut+bNm6d169bFru/du1fNzc065ZRTJElLlizRunXrFAqF9Nprr2nevHldzgMAAACJ1m/1hmAwKJ/PFzv2+/3asmVLr9d9Pp/Ky8t18OBB5eXlyeFwdDk/FEVFeUN6fjB8vvyEf+bRjP5OHPo6cejrxKK/E4e+Thz6euj6Db12D3XZOu900tv1/p4bjKqq+mgh7AQ52moQJhv9nTj0deLQ14lFfycOfZ049HX8TNPodZC03+kNgUBAlZWVseNgMCi/39/r9YqKCvn9fnm9XtXX1yscDnc5DwAAACRav6F39uzZ2rRpk6qrq9XU1KT169drzpw5sevjxo1TVlaW3njjDUnSqlWrNGfOHDmdTs2cOVNr167tch4AAABItLhGepctW6alS5fq0ksv1cKFCzVjxgzdcMMNKisrkyQ99NBDeuCBBzR//nw1NTVp6dKlkqS7775bzz77rBYsWKDXX39dt95664h+GQAAAKAnht3T5NsUxZzezEZ/Jw59nTj0dWLR34lDXycOfR2/Ic3pBQAAANIdoRcAAAAZj9ALAACAjEfoBQAAQMYj9AIAACDjEXoBAACQ8frdhjiVmObQtjFOl888mtHfiUNfJw59nVj0d+LQ14lDX8enr35Kqzq9AAAAwGAwvQEAAAAZj9ALAACAjEfoBQAAQMYj9AIAACDjEXoBAACQ8Qi9AAAAyHiEXgAAAGQ8Qi8AAAAyHqEXAAAAGY/QCwAAgIxH6AUAAEDGI/QCAAAg4xF6AQAAkPEIvb1Ys2aNFixYoLlz52rlypXJbk5G++EPf6iLL75YF198sb773e8muzlHhe985zu68847k92MjPfyyy9ryZIluuiii/Ttb3872c3JaKtXr479PfKd73wn2c3JSPX19Vq4cKH27NkjSdq4caMWLVqkCy+8UCtWrEhy6zLLkX39zDPPaOHChVq0aJH+7d/+Ta2trUluYXoi9PagvLxcK1as0NNPP63Vq1frmWee0bZt25LdrIy0ceNGbdiwQc8//7xWrVqlrVu36qWXXkp2szLapk2b9Pzzzye7GRlv9+7duvvuu/XYY49pzZo1euedd/TKK68ku1kZqampSffff79++ctfavXq1Xr99de1cePGZDcro2zevFlXXXWVduzYIUlqbm7WN77xDT322GNau3at3n77bf58D5Mj+/rjjz/Wz372M/3qV7/S7373O0UiET399NPJbWSaIvT2YOPGjZo1a5YKCwvldrs1b948rVu3LtnNykg+n0933nmnXC6XnE6nSkpKtG/fvmQ3K2MdOnRIK1as0Be/+MVkNyXjvfTSS1qwYIFGjx4tp9OpFStW6OSTT052szJSOBxWJBJRU1OT2tra1NbWpqysrGQ3K6M8++yzuvvuu+X3+yVJW7Zs0aRJkzRhwgQ5HA4tWrSIf04OkyP72uVyafny5crLy5NhGDruuOP45+QgOZLdgFQUDAbl8/lix36/X1u2bEliizLXscceG/t9x44dWrt2rX71q18lsUWZ7d///d+1bNky7d+/P9lNyXg7d+6U0+nUF77wBVVUVOjcc8/VrbfemuxmZaS8vDx99atf1fz585Wdna1PfepTOu2005LdrIxy//33dznu6Z+T5eXliW5WRjqyr8eNG6dx48ZJkqqrq7Vy5Uo98MADyWha2mOktwe2bXc7ZxhGElpy9Pjwww/1L//yL7rjjjs0efLkZDcnI/3617/WmDFjdMYZZyS7KUeFcDisTZs26Xvf+56effZZlZWVMa1khLz33nv67W9/qz/96U/asGGDTNPUz372s2Q3K6Pxz8nEKy8v1+c//3ldfvnlOv3005PdnLRE6O1BIBBQZWVl7DgYDMb+MwOG3xtvvKHrrrtOX/va13TZZZcluzkZa+3atfrb3/6mxYsX6/vf/75efvll/cd//Eeym5WxiouLdcYZZ8jr9So7O1vnn38+/8VohGzYsEFnnHGGioqK5HK5tGTJEv3jH/9IdrMyGv+cTKzt27frqquu0mWXXaZbbrkl2c1JW4TeHsyePVubNm1SdXW1mpqatH79es2ZMyfZzcpI+/fv1y233KKHHnpIF198cbKbk9F+8Ytf6IUXXtDq1av1la98Reedd56+8Y1vJLtZGevcc8/Vhg0bVFtbq3A4rL/+9a866aSTkt2sjDR16lRt3LhRjY2Nsm1bL7/8sqZPn57sZmW0k08+WR9//LF27typcDisF154gX9OjpD6+np94Qtf0Fe/+lX9y7/8S7Kbk9aY09uDQCCgZcuWaenSpQqFQrriiis0Y8aMZDcrI/3sZz9TS0uLHnzwwdi5K6+8UldddVUSWwUM3cknn6zrr79eV199tUKhkM4880xdfvnlyW5WRjrrrLP0zjvvaMmSJXI6nZo+fbpuvPHGZDcro2VlZenBBx/Ul7/8ZbW0tOjss8/WRRddlOxmZaTf/OY3qqys1M9//nP9/Oc/lySdd955+upXv5rklqUfw+5pYg4AAACQQZjeAAAAgIxH6AUAAEDGI/QCAAAg4xF6AQAAkPEIvQAAAMh4hF4AAABkPEIvAAAAMt7/D7vNunJDLlVlAAAAAElFTkSuQmCC\n", + "image/png": "iVBORw0KGgoAAAANSUhEUgAAAr0AAAHmCAYAAAB+hTZxAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjQuMywgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/MnkTPAAAACXBIWXMAAAsTAAALEwEAmpwYAABXwElEQVR4nO3deZxU1Z3///e9t6q6u3qhq7qrih2kW0UFXEIiosEVEQRRNBmXSJyJS6KTRL7R6CRxRI2jSVScLGZiTOJvIk40iUIwBDFjYkIgxmWEFldQdujqBXpfqqvu74/qLrrprXqrjdfz8ch037VOneGBb4/nfI5h27YtAAAAIIOZyW4AAAAAMNIIvQAAAMh4hF4AAABkPEIvAAAAMh6hFwAAABmP0AsAAICM50h2Awbi4MEGRSKJq7BWVJSnqqr6hH3e0Y7+Thz6OnHo68SivxOHvk4c+jp+pmnI48nt8Vpahd5IxE5o6O34TCQO/Z049HXi0NeJRX8nDn2dOPT10DG9AQAAABmP0AsAAICMR+gFAABAxiP0AgAAIOMRegEAAJDxCL0AAADIeIReAAAAZDxCLwAAADJeXJtTrFmzRj/+8Y8VCoV03XXX6Zprruly/aWXXtL3v/99RSIRTZ8+Xffee69cLpdWrVqlhx56SEVFRZKkc845R8uWLRv+bwEAAICYhx/+jsrKNqutLaQ9e3Zr8uQpkqTPfOZKXXzxJXG9o76+Xvfff7ceeODhbtfOOmumSkuP63LujDPO1E033TL0xo+QfkNveXm5VqxYoeeee04ul0tXXnmlTj/9dJWWlkqSGhsbde+99+r5559XcXGxli1bpueff17/9E//pLKyMt15551auHDhiH8RAAAARH3ta3dIkvbv36cvf/kmPfnk0wN+R11drT788INerw/mncnUb+jduHGjZs2apcLCQknSvHnztG7dOv3rv/6rJMntduvll1+W0+lUY2OjqqqqVFBQIEkqKyvTzp079fjjj+u4447TXXfdpVGjRo3ctwEAAEgBfyvbrw1b9g/Lu5wuS6HWcOz4rBljdOb0MYN61549u/XQQw+otrZGWVnZWrbsdh133FStX79OTz/93zJNU2PHjtVdd92nRx/9niorK/Rv/3abHnjgobg/44orFunEE6fpww/f11133atvf/tujRpVKJcrSytW/FDf//7Dev3112QY0rx5C/S5z12nN998XT/+8fcVDkc0ZUqJvvWtewb1/frSb+gNBoPy+XyxY7/fry1btnS5x+l06pVXXtHXv/51+f1+nXXWWZIkn8+nG2+8UTNmzNAjjzyie++9Vw8/3H2IPF5FRXmDfnawfL78hH/m0Yz+Thz6OnHo68SivxOHvu5dQcFBOV3WsL2v87sKCrLj7vuWllxZlhm7/8tfvlf//u//rhNPPFHbtm3TLbfcohdffFE///l/6dlnn1VRUZFWrFihuroK3Xvvci1dulRPPPGTHt99/fWf63J822236dOf/rQsy9Tcuefpxz/+ofbs2aNdu3bqf//35xo/frxWrlypQ4eqtHbtC2ptbdW1116rU0+drsJCt/bs2a0//elPys8fmT9X/YZe27a7nTMMo9u5s88+W6+++qoeeeQRLV++XA8//LB+9KMfxa5ff/31uuCCC4bU2KqqekUi3dszUny+fFVU1CXs84529Hfi0NeJQ18nFv2dOPR136ZP8mj6JM+wvKunvo6376urGxQOR1RRUafGxkaVlZXp9tvviF2vr2/Qtm27NWvWWfrsZ/9Jn/70OTr77PNUXDxe+/fviz3bkyeeeKrbuYqKOoXDEU2YUKqKijpVVzfI4/EqK2uUKirq9Je/bNC8eQtUXd0oSTr33Av18suv6Mwz52j8+Ilqbpaamwf/58o0jV4HSfut3hAIBFRZWRk7DgaD8vv9seNDhw5pw4YNseNFixbp/fffV11dnZ588snYedu25XDEtW4OAAAAwywSicjlytKTTz4d+9/jjz+pgoJRuvXW2/Ttb39XBQUFuu++u/Tii2uH9FlZWVk9/t598NJWOBzudt9I6Df0zp49W5s2bVJ1dbWampq0fv16zZkzJ3bdtm3dfvvt2rdvnyTpD3/4g0477TS53W498cQT2rx5syTpqaee0ty5c0foawAAAKAveXl5Gj9+QizQvvba33XLLTcqHA7ryisvU2Fhoa699p910UUX64MP3pdlWbFAOlw+8YmZ+sMffq9wOKzm5matX79Op546c1g/ozf9Dr0GAgEtW7ZMS5cuVSgU0hVXXKEZM2bohhtu0Fe+8hVNnz5d9913n2666SYZhqHS0lLdc889sixLjz76qJYvX67m5mZNnjxZ3/3udxPxnQAAANCDu+/+tr73vf/Q00//txwOp+699z/k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r2nevHldzgMAAACJ1m/1hmAwKJ/PFzv2+/3asmVLr9d9Pp/Ky8t18OBB5eXlyeFwdDk/FEVFeUN6fjB8vvyEf+bRjP5OHPo6cejrxKK/E4e+Thz6euj6Db12D3XZOu900tv1/p4bjKqq+mgh7AQ52moQJhv9nTj0deLQ14lFfycOfZ049HX8TNPodZC03+kNgUBAlZWVseNgMCi/39/r9YqKCvn9fnm9XtXX1yscDnc5DwAAACRav6F39uzZ2rRpk6qrq9XU1KT169drzpw5sevjxo1TVlaW3njjDUnSqlWrNGfOHDmdTs2cOVNr167tch4AAABItLhGepctW6alS5fq0ksv1cKFCzVjxgzdcMMNKisrkyQ99NBDeuCBBzR//nw1NTVp6dKlkqS7775bzz77rBYsWKDXX39dt95664h+GQAAAKAnht3T5NsUxZzezEZ/Jw59nTj0dWLR34lDXycOfR2/Ic3pBQAAANIdoRcAAAAZj9ALAACAjEfoBQAAQMYj9AIAACDjEXoBAACQ8frdhjiVmObQtjFOl888mtHfiUNfJw59nVj0d+LQ14lDX8enr35Kqzq9AAAAwGAwvQEAAAAZj9ALAACAjEfoBQAAQMYj9AIAACDjEXoBAACQ8Qi9AAAAyHiEXgAAAGQ8Qi8AAAAyHqEXAAAAGY/QCwAAgIxH6AUAAEDGI/QCAAAg4xF6AQAAkPEIvb1Ys2aNFixYoLlz52rlypXJbk5G++EPf6iLL75YF198sb773e8muzlHhe985zu68847k92MjPfyyy9ryZIluuiii/Ttb3872c3JaKtXr479PfKd73wn2c3JSPX19Vq4cKH27NkjSdq4caMWLVqkCy+8UCtWrEhy6zLLkX39zDPPaOHChVq0aJH+7d/+Ta2trUluYXoi9PagvLxcK1as0NNPP63Vq1frmWee0bZt25LdrIy0ceNGbdiwQc8//7xWrVqlrVu36qWXXkp2szLapk2b9Pzzzye7GRlv9+7duvvuu/XYY49pzZo1euedd/TKK68ku1kZqampSffff79++ctfavXq1Xr99de1cePGZDcro2zevFlXXXWVduzYIUlqbm7WN77xDT322GNau3at3n77bf58D5Mj+/rjjz/Wz372M/3qV7/S7373O0UiET399NPJbWSaIvT2YOPGjZo1a5YKCwvldrs1b948rVu3LtnNykg+n0933nmnXC6XnE6nSkpKtG/fvmQ3K2MdOnRIK1as0Be/+MVkNyXjvfTSS1qwYIFGjx4tp9OpFStW6OSTT052szJSOBxWJBJRU1OT2tra1NbWpqysrGQ3K6M8++yzuvvuu+X3+yVJW7Zs0aRJkzRhwgQ5HA4tWrSIf04OkyP72uVyafny5crLy5NhGDruuOP45+QgOZLdgFQUDAbl8/lix36/X1u2bEliizLXscceG/t9x44dWrt2rX71q18lsUWZ7d///d+1bNky7d+/P9lNyXg7d+6U0+nUF77wBVVUVOjcc8/VrbfemuxmZaS8vDx99atf1fz585Wdna1PfepTOu2005LdrIxy//33dznu6Z+T5eXliW5WRjqyr8eNG6dx48ZJkqqrq7Vy5Uo98MADyWha2mOktwe2bXc7ZxhGElpy9Pjwww/1L//yL7rjjjs0efLkZDcnI/3617/WmDFjdMYZZyS7KUeFcDisTZs26Xvf+56effZZlZWVMa1khLz33nv67W9/qz/96U/asGGDTNPUz372s2Q3K6Pxz8nEKy8v1+c//3ldfvnlOv3005PdnLRE6O1BIBBQZWVl7DgYDMb+MwOG3xtvvKHrrrtOX/va13TZZZcluzkZa+3atfrb3/6mxYsX6/vf/75efvll/cd//Eeym5WxiouLdcYZZ8jr9So7O1vnn38+/8VohGzYsEFnnHGGioqK5HK5tGTJEv3jH/9IdrMyGv+cTKzt27frqquu0mWXXaZbbrkl2c1JW4TeHsyePVubNm1SdXW1mpqatH79es2ZMyfZzcpI+/fv1y233KKHHnpIF198cbKbk9F+8Ytf6IUXXtDq1av1la98Reedd56+8Y1vJLtZGevcc8/Vhg0bVFtbq3A4rL/+9a866aSTkt2sjDR16lRt3LhRjY2Nsm1bL7/8sqZPn57sZmW0k08+WR9//LF27typcDisF154gX9OjpD6+np94Qtf0Fe/+lX9y7/8S7Kbk9aY09uDQCCgZcuWaenSpQqFQrriiis0Y8aMZDcrI/3sZz9TS0uLHnzwwdi5K6+8UldddVUSWwUM3cknn6zrr79eV199tUKhkM4880xdfvnlyW5WRjrrrLP0zjvvaMmSJXI6nZo+fbpuvPHGZDcro2VlZenBBx/Ul7/8ZbW0tOjss8/WRRddlOxmZaTf/OY3qqys1M9//nP9/Oc/lySdd955+upXv5rklqUfw+5pYg4AAACQQZjeAAAAgIxH6AUAAEDGI/QCAAAg4xF6AQAAkPEIvQAAAMh4hF4AAABkPEIvAAAAMt7/D7vNunJDLlVlAAAAAElFTkSuQmCC\n", "text/plain": [ "
" ] @@ -4886,7 +4906,7 @@ "name": "python", "nbconvert_exporter": "python", "pygments_lexer": "ipython3", - "version": "3.8.5" + "version": "3.9.7" } }, "nbformat": 4, diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter1.py b/doc/LectureNotes/_build/jupyter_execute/chapter1.py deleted file mode 100644 index e0298542b..000000000 --- a/doc/LectureNotes/_build/jupyter_execute/chapter1.py +++ /dev/null @@ -1,2331 +0,0 @@ -# Linear Regression - - -## Introduction - - - - - -Our emphasis throughout this series of lectures is on understanding -the mathematical aspects of different algorithms used in the fields of -data analysis and machine learning. - -However, where possible we will emphasize the importance of using -available software. We start thus with a hands-on and top-down -approach to machine learning. The aim is thus to start with relevant -data or data we have produced and use these to introduce statistical -data analysis concepts and machine learning algorithms before we delve -into the algorithms themselves. The examples we will use in the -beginning, start with simple polynomials with random noise added. We -will use the Python software package -[Scikit-Learn](http://scikit-learn.org/stable/) and introduce various -machine learning algorithms to make fits of the data and -predictions. We move thereafter to more interesting cases such as data -from say experiments (below we will look at experimental nuclear -binding energies as an example). These are examples where we can -easily set up the data and then use machine learning algorithms -included in for example **Scikit-Learn**. - -These examples will serve us the purpose of getting -started. Furthermore, they allow us to catch more than two birds with -a stone. They will allow us to bring in some programming specific -topics and tools as well as showing the power of various Python -libraries for machine learning and statistical data analysis. - -Here, we will mainly focus on two specific Python packages for Machine -Learning, Scikit-Learn and Tensorflow (see below for links etc). -Moreover, the examples we introduce will serve as inputs to many of -our discussions later, as well as allowing you to set up models and -produce your own data and get started with programming. - - - -## What is Machine Learning? - -Statistics, data science and machine learning form important fields of -research in modern science. They describe how to learn and make -predictions from data, as well as allowing us to extract important -correlations about physical process and the underlying laws of motion -in large data sets. The latter, big data sets, appear frequently in -essentially all disciplines, from the traditional Science, Technology, -Mathematics and Engineering fields to Life Science, Law, education -research, the Humanities and the Social Sciences. - -It has become more -and more common to see research projects on big data in for example -the Social Sciences where extracting patterns from complicated survey -data is one of many research directions. Having a solid grasp of data -analysis and machine learning is thus becoming central to scientific -computing in many fields, and competences and skills within the fields -of machine learning and scientific computing are nowadays strongly -requested by many potential employers. The latter cannot be -overstated, familiarity with machine learning has almost become a -prerequisite for many of the most exciting employment opportunities, -whether they are in bioinformatics, life science, physics or finance, -in the private or the public sector. This author has had several -students or met students who have been hired recently based on their -skills and competences in scientific computing and data science, often -with marginal knowledge of machine learning. - -Machine learning is a subfield of computer science, and is closely -related to computational statistics. It evolved from the study of -pattern recognition in artificial intelligence (AI) research, and has -made contributions to AI tasks like computer vision, natural language -processing and speech recognition. Many of the methods we will study are also -strongly rooted in basic mathematics and physics research. - -Ideally, machine learning represents the science of giving computers -the ability to learn without being explicitly programmed. The idea is -that there exist generic algorithms which can be used to find patterns -in a broad class of data sets without having to write code -specifically for each problem. The algorithm will build its own logic -based on the data. You should however always keep in mind that -machines and algorithms are to a large extent developed by humans. The -insights and knowledge we have about a specific system, play a central -role when we develop a specific machine learning algorithm. - -Machine learning is an extremely rich field, in spite of its young -age. The increases we have seen during the last three decades in -computational capabilities have been followed by developments of -methods and techniques for analyzing and handling large date sets, -relying heavily on statistics, computer science and mathematics. The -field is rather new and developing rapidly. Popular software packages -written in Python for machine learning like -[Scikit-learn](http://scikit-learn.org/stable/), -[Tensorflow](https://www.tensorflow.org/), -[PyTorch](http://pytorch.org/) and [Keras](https://keras.io/), all -freely available at their respective GitHub sites, encompass -communities of developers in the thousands or more. And the number of -code developers and contributors keeps increasing. Not all the -algorithms and methods can be given a rigorous mathematical -justification, opening up thereby large rooms for experimenting and -trial and error and thereby exciting new developments. However, a -solid command of linear algebra, multivariate theory, probability -theory, statistical data analysis, understanding errors and Monte -Carlo methods are central elements in a proper understanding of many -of algorithms and methods we will discuss. - - - -The approaches to machine learning are many, but are often split into -two main categories. In *supervised learning* we know the answer to a -problem, and let the computer deduce the logic behind it. On the other -hand, *unsupervised learning* is a method for finding patterns and -relationship in data sets without any prior knowledge of the system. -Some authours also operate with a third category, namely -*reinforcement learning*. This is a paradigm of learning inspired by -behavioral psychology, where learning is achieved by trial-and-error, -solely from rewards and punishment. - -Another way to categorize machine learning tasks is to consider the -desired output of a system. Some of the most common tasks are: - - * Classification: Outputs are divided into two or more classes. The goal is to produce a model that assigns inputs into one of these classes. An example is to identify digits based on pictures of hand-written ones. Classification is typically supervised learning. - - * Regression: Finding a functional relationship between an input data set and a reference data set. The goal is to construct a function that maps input data to continuous output values. - - * Clustering: Data are divided into groups with certain common traits, without knowing the different groups beforehand. It is thus a form of unsupervised learning. - -The methods we cover have three main topics in common, irrespective of -whether we deal with supervised or unsupervised learning. -* The first ingredient is normally our data set (which can be subdivided into training, validation and test data). Many find the most difficult part of using Machine Learning to be the set up of your data in a meaningful way. - -* The second item is a model which is normally a function of some parameters. The model reflects our knowledge of the system (or lack thereof). As an example, if we know that our data show a behavior similar to what would be predicted by a polynomial, fitting our data to a polynomial of some degree would then determin our model. - -* The last ingredient is a so-called **cost/loss** function (or error or risk function) which allows us to present an estimate on how good our model is in reproducing the data it is supposed to train. - - - -At the heart of basically all Machine Learning algorithms we will encounter so-called minimization or optimization algorithms. A large family of such methods are so-called **gradient methods**. - - -### A Frequentist approach to data analysis - -When you hear phrases like **predictions and estimations** and -**correlations and causations**, what do you think of? May be you think -of the difference between classifying new data points and generating -new data points. -Or perhaps you consider that correlations represent some kind of symmetric statements like -if $A$ is correlated with $B$, then $B$ is correlated with -$A$. Causation on the other hand is directional, that is if $A$ causes $B$, $B$ does not -necessarily cause $A$. - -These concepts are in some sense the difference between machine -learning and statistics. In machine learning and prediction based -tasks, we are often interested in developing algorithms that are -capable of learning patterns from given data in an automated fashion, -and then using these learned patterns to make predictions or -assessments of newly given data. In many cases, our primary concern -is the quality of the predictions or assessments, and we are less -concerned about the underlying patterns that were learned in order -to make these predictions. - -In machine learning we normally use [a so-called frequentist approach](https://en.wikipedia.org/wiki/Frequentist_inference), -where the aim is to make predictions and find correlations. We focus -less on for example extracting a probability distribution function (PDF). The PDF can be -used in turn to make estimations and find causations such as given $A$ -what is the likelihood of finding $B$. - - -### What is a good model? - -In science and engineering we often end up in situations where we want to infer (or learn) a -quantitative model $M$ for a given set of sample points $\boldsymbol{X} \in [x_1, x_2,\dots x_N]$. - -As we will see repeatedely in these lectures, we could try to fit these data points to a model given by a -straight line, or if we wish to be more sophisticated to a more complex -function. - -The reason for inferring such a model is that it -serves many useful purposes. On the one hand, the model can reveal information -encoded in the data or underlying mechanisms from which the data were generated. For instance, we could discover important -corelations that relate interesting physics interpretations. - -In addition, it can simplify the representation of the given data set and help -us in making predictions about future data samples. - -A first important consideration to keep in mind is that inferring the *correct* model -for a given data set is an elusive, if not impossible, task. The fundamental difficulty -is that if we are not specific about what we mean by a *correct* model, there -could easily be many different models that fit the given data set *equally well*. - - - - -The central question is this: what leads us to say that a model is correct or -optimal for a given data set? To make the model inference problem well posed, i.e., -to guarantee that there is a unique optimal model for the given data, we need to -impose additional assumptions or restrictions on the class of models considered. To -this end, we should not be looking for just any model that can describe the data. -Instead, we should look for a **model** $M$ that is the best among a restricted class -of models. In addition, to make the model inference problem computationally -tractable, we need to specify how restricted the class of models needs to be. A -common strategy is to start -with the simplest possible class of models that is just necessary to describe the data -or solve the problem at hand. More precisely, the model class should be rich enough -to contain at least one model that can fit the data to a desired accuracy and yet be -restricted enough that it is relatively simple to find the best model for the given data. - -Thus, the most popular strategy is to start from the -simplest class of models and increase the complexity of the models only when the -simpler models become inadequate. For instance, if we work with a regression problem to fit a set of sample points, one -may first try the simplest class of models, namely linear models, followed obviously by more complex models. - -How to evaluate which model fits best the data is something we will come back to over and over again in these sets of lectures. - - - - - - - - - - - -## Simple linear regression model using **scikit-learn** - -We start with perhaps our simplest possible example, using -**Scikit-Learn** to perform linear regression analysis on a data set -produced by us. - -What follows is a simple Python code where we have defined a function -$y$ in terms of the variable $x$. Both are defined as vectors with $100$ entries. -The numbers in the vector $\boldsymbol{x}$ are given -by random numbers generated with a uniform distribution with entries -$x_i \in [0,1]$ (more about probability distribution functions -later). These values are then used to define a function $y(x)$ -(tabulated again as a vector) with a linear dependence on $x$ plus a -random noise added via the normal distribution. - - -The Numpy functions are imported used the **import numpy as np** -statement and the random number generator for the uniform distribution -is called using the function **np.random.rand()**, where we specificy -that we want $100$ random variables. Using Numpy we define -automatically an array with the specified number of elements, $100$ in -our case. With the Numpy function **randn()** we can compute random -numbers with the normal distribution (mean value $\mu$ equal to zero and -variance $\sigma^2$ set to one) and produce the values of $y$ assuming a linear -dependence as function of $x$ - -$$ -y = 2x+N(0,1), -$$ - -where $N(0,1)$ represents random numbers generated by the normal -distribution. From **Scikit-Learn** we import then the -**LinearRegression** functionality and make a prediction $\tilde{y} = -\alpha + \beta x$ using the function **fit(x,y)**. We call the set of -data $(\boldsymbol{x},\boldsymbol{y})$ for our training data. The Python package -**scikit-learn** has also a functionality which extracts the above -fitting parameters $\alpha$ and $\beta$ (see below). Later we will -distinguish between training data and test data. - -For plotting we use the Python package -[matplotlib](https://matplotlib.org/) which produces publication -quality figures. Feel free to explore the extensive -[gallery](https://matplotlib.org/gallery/index.html) of examples. In -this example we plot our original values of $x$ and $y$ as well as the -prediction **ypredict** ($\tilde{y}$), which attempts at fitting our -data with a straight line. Note also that **Scikit-Learn** requires a -matrix as input for the input values $x$ and $y$. In the above code we -have solved this by declaring $x$ and $y$ as arrays of dimension -$n\times 1$. - -In the code here we have also made a new array for $x\in [0,1]$. Our -prediction is computed for these values, meaning that they were not -included in the data set used to *train* (or fit) the model. -This is a recurrring theme in machine learning and data analysis. We would like to train a model on a specific given data set. -Thereafter we wish to apply it to data which were not included in the training. Below we will encounter this again in the so-called *train-validate-test* spliting. We will typically split our data into different sets, oen for training, one for validation and finally, our data from the untouched test vault! - - -The Python code follows here. - -%matplotlib inline - -# Importing various packages -import numpy as np -import matplotlib.pyplot as plt -from sklearn.linear_model import LinearRegression - -x = np.random.rand(100,1) -y = 2*x+np.random.randn(100,1) -linreg = LinearRegression() -linreg.fit(x,y) -# This is our new x-array to which we test our model -xnew = np.array([[0],[1]]) -ypredict = linreg.predict(xnew) - -plt.plot(xnew, ypredict, "r-") -plt.plot(x, y ,'ro') -plt.axis([0,1.0,0, 5.0]) -plt.xlabel(r'$x$') -plt.ylabel(r'$y$') -plt.title(r'Simple Linear Regression') -plt.show() - -This example serves several aims. It allows us to demonstrate several -aspects of data analysis and later machine learning algorithms. The -immediate visualization shows that our linear fit is not -impressive. It goes through the data points, but there are many -outliers which are not reproduced by our linear regression. We could -now play around with this small program and change for example the -factor in front of $x$ and the normal distribution. Try to change the -function $y$ to - -$$ -y = 10x+0.01 \times N(0,1), -$$ - -where $x$ is defined as before. Does the fit look better? Indeed, by -reducing the role of the noise given by the normal distribution we see immediately that -our linear prediction seemingly reproduces better the training -set. However, this testing 'by the eye' is obviouly not satisfactory in the -long run. Here we have only defined the training data and our model, and -have not discussed a more rigorous approach to the **cost** function. - -We need more rigorous criteria in defining whether we have succeeded or -not in modeling our training data. You will be surprised to see that -many scientists seldomly venture beyond this 'by the eye' approach. A -standard approach for the *cost* function is the so-called $\chi^2$ -function (a variant of the mean-squared error (MSE)) - -$$ -\chi^2 = \frac{1}{n} -\sum_{i=0}^{n-1}\frac{(y_i-\tilde{y}_i)^2}{\sigma_i^2}, -$$ - -where $\sigma_i^2$ is the variance (to be defined later) of the entry -$y_i$. We may not know the explicit value of $\sigma_i^2$, it serves -however the aim of scaling the equations and make the cost function -dimensionless. - -Minimizing the cost function is a central aspect of -our discussions to come. Finding its minima as function of the model -parameters ($\alpha$ and $\beta$ in our case) will be a recurring -theme in these series of lectures. Essentially all machine learning -algorithms we will discuss center around the minimization of the -chosen cost function. This depends in turn on our specific -model for describing the data, a typical situation in supervised -learning. Automatizing the search for the minima of the cost function is a -central ingredient in all algorithms. Typical methods which are -employed are various variants of **gradient** methods. These will be -discussed in more detail later. Again, you'll be surprised to hear that -many practitioners minimize the above function ''by the eye', popularly dubbed as -'chi by the eye'. That is, change a parameter and see (visually and numerically) that -the $\chi^2$ function becomes smaller. - -There are many ways to define the cost function. A simpler approach is to look at the relative difference between the training data and the predicted data, that is we define -the relative error (why would we prefer the MSE instead of the relative error?) as - -$$ -\epsilon_{\mathrm{relative}}= \frac{\vert \boldsymbol{y} -\boldsymbol{\tilde{y}}\vert}{\vert \boldsymbol{y}\vert}. -$$ - -The squared cost function results in an arithmetic mean-unbiased -estimator, and the absolute-value cost function results in a -median-unbiased estimator (in the one-dimensional case, and a -geometric median-unbiased estimator for the multi-dimensional -case). The squared cost function has the disadvantage that it has the tendency -to be dominated by outliers. - -We can modify easily the above Python code and plot the relative error instead - -import numpy as np -import matplotlib.pyplot as plt -from sklearn.linear_model import LinearRegression -# Number of data points -n = 100 -x = np.random.rand(100,1) -y = 5*x+0.01*np.random.randn(100,1) -linreg = LinearRegression() -linreg.fit(x,y) -ypredict = linreg.predict(x) - -plt.plot(x, np.abs(ypredict-y)/abs(y), "ro") -plt.axis([0,1.0,0.0, 0.5]) -plt.xlabel(r'$x$') -plt.ylabel(r'$\epsilon_{\mathrm{relative}}$') -plt.title(r'Relative error') -plt.show() - -Depending on the parameter in front of the normal distribution, we may -have a small or larger relative error. Try to play around with -different training data sets and study (graphically) the value of the -relative error. - -As mentioned above, **Scikit-Learn** has an impressive functionality. -We can for example extract the values of $\alpha$ and $\beta$ and -their error estimates, or the variance and standard deviation and many -other properties from the statistical data analysis. - -Here we show an -example of the functionality of **Scikit-Learn**. - -import numpy as np -import matplotlib.pyplot as plt -from sklearn.linear_model import LinearRegression -from sklearn.metrics import mean_squared_error, r2_score, mean_squared_log_error, mean_absolute_error - -x = np.random.rand(100,1) -y = 2.0+ 5*x+0.5*np.random.randn(100,1) -linreg = LinearRegression() -linreg.fit(x,y) -ypredict = linreg.predict(x) -print('The intercept alpha: \n', linreg.intercept_) -print('Coefficient beta : \n', linreg.coef_) -# The mean squared error -print("Mean squared error: %.2f" % mean_squared_error(y, ypredict)) -# Explained variance score: 1 is perfect prediction -print('Variance score: %.2f' % r2_score(y, ypredict)) -# Mean squared log error -print('Mean squared log error: %.2f' % mean_squared_log_error(y, ypredict) ) -# Mean absolute error -print('Mean absolute error: %.2f' % mean_absolute_error(y, ypredict)) -plt.plot(x, ypredict, "r-") -plt.plot(x, y ,'ro') -plt.axis([0.0,1.0,1.5, 7.0]) -plt.xlabel(r'$x$') -plt.ylabel(r'$y$') -plt.title(r'Linear Regression fit ') -plt.show() - -The function **coef** gives us the parameter $\beta$ of our fit while **intercept** yields -$\alpha$. Depending on the constant in front of the normal distribution, we get values near or far from $alpha =2$ and $\beta =5$. Try to play around with different parameters in front of the normal distribution. The function **meansquarederror** gives us the mean square error, a risk metric corresponding to the expected value of the squared (quadratic) error or loss defined as - -$$ -MSE(\boldsymbol{y},\boldsymbol{\tilde{y}}) = \frac{1}{n} -\sum_{i=0}^{n-1}(y_i-\tilde{y}_i)^2, -$$ - -The smaller the value, the better the fit. Ideally we would like to -have an MSE equal zero. The attentive reader has probably recognized -this function as being similar to the $\chi^2$ function defined above. - -The **r2score** function computes $R^2$, the coefficient of -determination. It provides a measure of how well future samples are -likely to be predicted by the model. Best possible score is 1.0 and it -can be negative (because the model can be arbitrarily worse). A -constant model that always predicts the expected value of $\boldsymbol{y}$, -disregarding the input features, would get a $R^2$ score of $0.0$. - -If $\tilde{\boldsymbol{y}}_i$ is the predicted value of the $i-th$ sample and $y_i$ is the corresponding true value, then the score $R^2$ is defined as - -$$ -R^2(\boldsymbol{y}, \tilde{\boldsymbol{y}}) = 1 - \frac{\sum_{i=0}^{n - 1} (y_i - \tilde{y}_i)^2}{\sum_{i=0}^{n - 1} (y_i - \bar{y})^2}, -$$ - -where we have defined the mean value of $\boldsymbol{y}$ as - -$$ -\bar{y} = \frac{1}{n} \sum_{i=0}^{n - 1} y_i. -$$ - -Another quantity taht we will meet again in our discussions of regression analysis is - the mean absolute error (MAE), a risk metric corresponding to the expected value of the absolute error loss or what we call the $l1$-norm loss. In our discussion above we presented the relative error. -The MAE is defined as follows - -$$ -\text{MAE}(\boldsymbol{y}, \boldsymbol{\tilde{y}}) = \frac{1}{n} \sum_{i=0}^{n-1} \left| y_i - \tilde{y}_i \right|. -$$ - -We present the -squared logarithmic (quadratic) error - -$$ -\text{MSLE}(\boldsymbol{y}, \boldsymbol{\tilde{y}}) = \frac{1}{n} \sum_{i=0}^{n - 1} (\log_e (1 + y_i) - \log_e (1 + \tilde{y}_i) )^2, -$$ - -where $\log_e (x)$ stands for the natural logarithm of $x$. This error -estimate is best to use when targets having exponential growth, such -as population counts, average sales of a commodity over a span of -years etc. - - -Finally, another cost function is the Huber cost function used in robust regression. - -The rationale behind this possible cost function is its reduced -sensitivity to outliers in the data set. In our discussions on -dimensionality reduction and normalization of data we will meet other -ways of dealing with outliers. - -The Huber cost function is defined as - -$$ -H_{\delta}(\boldsymbol{a})=\left\{\begin{array}{cc}\frac{1}{2} \boldsymbol{a}^{2}& \text{for }|\boldsymbol{a}|\leq \delta\\ \delta (|\boldsymbol{a}|-\frac{1}{2}\delta ),&\text{otherwise}.\end{array}\right. -$$ - -Here $\boldsymbol{a}=\boldsymbol{y} - \boldsymbol{\tilde{y}}$. - - - - -We will discuss in more -detail these and other functions in the various lectures. We conclude this part with another example. Instead of -a linear $x$-dependence we study now a cubic polynomial and use the polynomial regression analysis tools of scikit-learn. - -import matplotlib.pyplot as plt -import numpy as np -import random -from sklearn.linear_model import Ridge -from sklearn.preprocessing import PolynomialFeatures -from sklearn.pipeline import make_pipeline -from sklearn.linear_model import LinearRegression - -x=np.linspace(0.02,0.98,200) -noise = np.asarray(random.sample((range(200)),200)) -y=x**3*noise -yn=x**3*100 -poly3 = PolynomialFeatures(degree=3) -X = poly3.fit_transform(x[:,np.newaxis]) -clf3 = LinearRegression() -clf3.fit(X,y) - -Xplot=poly3.fit_transform(x[:,np.newaxis]) -poly3_plot=plt.plot(x, clf3.predict(Xplot), label='Cubic Fit') -plt.plot(x,yn, color='red', label="True Cubic") -plt.scatter(x, y, label='Data', color='orange', s=15) -plt.legend() -plt.show() - -def error(a): - for i in y: - err=(y-yn)/yn - return abs(np.sum(err))/len(err) - -print (error(y)) - -Let us now dive into nuclear physics and remind ourselves briefly about some basic features about binding -energies. A basic quantity which can be measured for the ground -states of nuclei is the atomic mass $M(N, Z)$ of the neutral atom with -atomic mass number $A$ and charge $Z$. The number of neutrons is $N$. There are indeed several sophisticated experiments worldwide which allow us to measure this quantity to high precision (parts per million even). - -Atomic masses are usually tabulated in terms of the mass excess defined by - -$$ -\Delta M(N, Z) = M(N, Z) - uA, -$$ - -where $u$ is the Atomic Mass Unit - -$$ -u = M(^{12}\mathrm{C})/12 = 931.4940954(57) \hspace{0.1cm} \mathrm{MeV}/c^2. -$$ - -The nucleon masses are - -$$ -m_p = 1.00727646693(9)u, -$$ - -and - -$$ -m_n = 939.56536(8)\hspace{0.1cm} \mathrm{MeV}/c^2 = 1.0086649156(6)u. -$$ - -In the [2016 mass evaluation of by W.J.Huang, G.Audi, M.Wang, F.G.Kondev, S.Naimi and X.Xu](http://nuclearmasses.org/resources_folder/Wang_2017_Chinese_Phys_C_41_030003.pdf) -there are data on masses and decays of 3437 nuclei. - -The nuclear binding energy is defined as the energy required to break -up a given nucleus into its constituent parts of $N$ neutrons and $Z$ -protons. In terms of the atomic masses $M(N, Z)$ the binding energy is -defined by - -$$ -BE(N, Z) = ZM_H c^2 + Nm_n c^2 - M(N, Z)c^2 , -$$ - -where $M_H$ is the mass of the hydrogen atom and $m_n$ is the mass of the neutron. -In terms of the mass excess the binding energy is given by - -$$ -BE(N, Z) = Z\Delta_H c^2 + N\Delta_n c^2 -\Delta(N, Z)c^2 , -$$ - -where $\Delta_H c^2 = 7.2890$ MeV and $\Delta_n c^2 = 8.0713$ MeV. - - -A popular and physically intuitive model which can be used to parametrize -the experimental binding energies as function of $A$, is the so-called -**liquid drop model**. The ansatz is based on the following expression - -$$ -BE(N,Z) = a_1A-a_2A^{2/3}-a_3\frac{Z^2}{A^{1/3}}-a_4\frac{(N-Z)^2}{A}, -$$ - -where $A$ stands for the number of nucleons and the $a_i$s are parameters which are determined by a fit -to the experimental data. - - - - -To arrive at the above expression we have assumed that we can make the following assumptions: - - * There is a volume term $a_1A$ proportional with the number of nucleons (the energy is also an extensive quantity). When an assembly of nucleons of the same size is packed together into the smallest volume, each interior nucleon has a certain number of other nucleons in contact with it. This contribution is proportional to the volume. - - * There is a surface energy term $a_2A^{2/3}$. The assumption here is that a nucleon at the surface of a nucleus interacts with fewer other nucleons than one in the interior of the nucleus and hence its binding energy is less. This surface energy term takes that into account and is therefore negative and is proportional to the surface area. - - * There is a Coulomb energy term $a_3\frac{Z^2}{A^{1/3}}$. The electric repulsion between each pair of protons in a nucleus yields less binding. - - * There is an asymmetry term $a_4\frac{(N-Z)^2}{A}$. This term is associated with the Pauli exclusion principle and reflects the fact that the proton-neutron interaction is more attractive on the average than the neutron-neutron and proton-proton interactions. - -We could also add a so-called pairing term, which is a correction term that -arises from the tendency of proton pairs and neutron pairs to -occur. An even number of particles is more stable than an odd number. - - -### Organizing our data - -Let us start with reading and organizing our data. -We start with the compilation of masses and binding energies from 2016. -After having downloaded this file to our own computer, we are now ready to read the file and start structuring our data. - - -We start with preparing folders for storing our calculations and the data file over masses and binding energies. We import also various modules that we will find useful in order to present various Machine Learning methods. Here we focus mainly on the functionality of **scikit-learn**. - -# Common imports -import numpy as np -import pandas as pd -import matplotlib.pyplot as plt -import sklearn.linear_model as skl -from sklearn.model_selection import train_test_split -from sklearn.metrics import mean_squared_error, r2_score, mean_absolute_error -import os - -# Where to save the figures and data files -PROJECT_ROOT_DIR = "Results" -FIGURE_ID = "Results/FigureFiles" -DATA_ID = "DataFiles/" - -if not os.path.exists(PROJECT_ROOT_DIR): - os.mkdir(PROJECT_ROOT_DIR) - -if not os.path.exists(FIGURE_ID): - os.makedirs(FIGURE_ID) - -if not os.path.exists(DATA_ID): - os.makedirs(DATA_ID) - -def image_path(fig_id): - return os.path.join(FIGURE_ID, fig_id) - -def data_path(dat_id): - return os.path.join(DATA_ID, dat_id) - -def save_fig(fig_id): - plt.savefig(image_path(fig_id) + ".png", format='png') - -infile = open(data_path("MassEval2016.dat"),'r') - -Before we proceed, we define also a function for making our plots. You can obviously avoid this and simply set up various **matplotlib** commands every time you need them. You may however find it convenient to collect all such commands in one function and simply call this function. - -from pylab import plt, mpl -plt.style.use('seaborn') -mpl.rcParams['font.family'] = 'serif' - -def MakePlot(x,y, styles, labels, axlabels): - plt.figure(figsize=(10,6)) - for i in range(len(x)): - plt.plot(x[i], y[i], styles[i], label = labels[i]) - plt.xlabel(axlabels[0]) - plt.ylabel(axlabels[1]) - plt.legend(loc=0) - -Our next step is to read the data on experimental binding energies and -reorganize them as functions of the mass number $A$, the number of -protons $Z$ and neutrons $N$ using **pandas**. Before we do this it is -always useful (unless you have a binary file or other types of compressed -data) to actually open the file and simply take a look at it! - - -In particular, the program that outputs the final nuclear masses is written in Fortran with a specific format. It means that we need to figure out the format and which columns contain the data we are interested in. Pandas comes with a function that reads formatted output. After having admired the file, we are now ready to start massaging it with **pandas**. The file begins with some basic format information. - -""" -This is taken from the data file of the mass 2016 evaluation. -All files are 3436 lines long with 124 character per line. - Headers are 39 lines long. - col 1 : Fortran character control: 1 = page feed 0 = line feed - format : a1,i3,i5,i5,i5,1x,a3,a4,1x,f13.5,f11.5,f11.3,f9.3,1x,a2,f11.3,f9.3,1x,i3,1x,f12.5,f11.5 - These formats are reflected in the pandas widths variable below, see the statement - widths=(1,3,5,5,5,1,3,4,1,13,11,11,9,1,2,11,9,1,3,1,12,11,1), - Pandas has also a variable header, with length 39 in this case. -""" - -The data we are interested in are in columns 2, 3, 4 and 11, giving us -the number of neutrons, protons, mass numbers and binding energies, -respectively. We add also for the sake of completeness the element name. The data are in fixed-width formatted lines and we will -covert them into the **pandas** DataFrame structure. - -# Read the experimental data with Pandas -Masses = pd.read_fwf(infile, usecols=(2,3,4,6,11), - names=('N', 'Z', 'A', 'Element', 'Ebinding'), - widths=(1,3,5,5,5,1,3,4,1,13,11,11,9,1,2,11,9,1,3,1,12,11,1), - header=39, - index_col=False) - -# Extrapolated values are indicated by '#' in place of the decimal place, so -# the Ebinding column won't be numeric. Coerce to float and drop these entries. -Masses['Ebinding'] = pd.to_numeric(Masses['Ebinding'], errors='coerce') -Masses = Masses.dropna() -# Convert from keV to MeV. -Masses['Ebinding'] /= 1000 - -# Group the DataFrame by nucleon number, A. -Masses = Masses.groupby('A') -# Find the rows of the grouped DataFrame with the maximum binding energy. -Masses = Masses.apply(lambda t: t[t.Ebinding==t.Ebinding.max()]) - -We have now read in the data, grouped them according to the variables we are interested in. -We see how easy it is to reorganize the data using **pandas**. If we -were to do these operations in C/C++ or Fortran, we would have had to -write various functions/subroutines which perform the above -reorganizations for us. Having reorganized the data, we can now start -to make some simple fits using both the functionalities in **numpy** and -**Scikit-Learn** afterwards. - -Now we define five variables which contain -the number of nucleons $A$, the number of protons $Z$ and the number of neutrons $N$, the element name and finally the energies themselves. - -A = Masses['A'] -Z = Masses['Z'] -N = Masses['N'] -Element = Masses['Element'] -Energies = Masses['Ebinding'] -print(Masses) - -The next step, and we will define this mathematically later, is to set up the so-called **design matrix**. We will throughout call this matrix $\boldsymbol{X}$. -It has dimensionality $n\times p$, where $n$ is the number of data points and $p$ are the so-called predictors. In our case here they are given by the number of polynomials in $A$ we wish to include in the fit. - -# Now we set up the design matrix X -X = np.zeros((len(A),5)) -X[:,0] = 1 -X[:,1] = A -X[:,2] = A**(2.0/3.0) -X[:,3] = A**(-1.0/3.0) -X[:,4] = A**(-1.0) - -Note well that we have made life simple here. We perform a fit in -terms of the number of nucleons only. A more sophisticated fit can be -done by including an explicit dependence on the number of protons and -neutrons in the asymmetry and Coulomb terms. We leave this as an exercise to you the reader. - -With **Scikit-Learn** we are now ready to use linear regression and fit our data. - -clf = skl.LinearRegression().fit(X, Energies) -fity = clf.predict(X) - -Pretty simple! -Now we can print measures of how our fit is doing, the coefficients from the fits and plot the final fit together with our data. - -# The mean squared error -print("Mean squared error: %.2f" % mean_squared_error(Energies, fity)) -# Explained variance score: 1 is perfect prediction -print('Variance score: %.2f' % r2_score(Energies, fity)) -# Mean absolute error -print('Mean absolute error: %.2f' % mean_absolute_error(Energies, fity)) - -Masses['Eapprox'] = fity -# Generate a plot comparing the experimental with the fitted values values. -fig, ax = plt.subplots() -ax.set_xlabel(r'$A = N + Z$') -ax.set_ylabel(r'$E_\mathrm{bind}\,/\mathrm{MeV}$') -ax.plot(Masses['A'], Masses['Ebinding'], alpha=0.7, lw=2, - label='Ame2016') -ax.plot(Masses['A'], Masses['Eapprox'], alpha=0.7, lw=2, c='m', - label='Fit') -ax.legend() -save_fig("Masses2016") -plt.show() - -As a teaser, let us now see how we can do this with decision trees using **Scikit-Learn**. Later we will switch to so-called **random forests**! - - -#Decision Tree Regression -from sklearn.tree import DecisionTreeRegressor -regr_1=DecisionTreeRegressor(max_depth=5) -regr_2=DecisionTreeRegressor(max_depth=7) -regr_3=DecisionTreeRegressor(max_depth=9) -regr_1.fit(X, Energies) -regr_2.fit(X, Energies) -regr_3.fit(X, Energies) - - -y_1 = regr_1.predict(X) -y_2 = regr_2.predict(X) -y_3=regr_3.predict(X) -Masses['Eapprox'] = y_3 -# Plot the results -plt.figure() -plt.plot(A, Energies, color="blue", label="Data", linewidth=2) -plt.plot(A, y_1, color="red", label="max_depth=5", linewidth=2) -plt.plot(A, y_2, color="green", label="max_depth=7", linewidth=2) -plt.plot(A, y_3, color="m", label="max_depth=9", linewidth=2) - -plt.xlabel("$A$") -plt.ylabel("$E$[MeV]") -plt.title("Decision Tree Regression") -plt.legend() -save_fig("Masses2016Trees") -plt.show() -print(Masses) -print(np.mean( (Energies-y_1)**2)) - -With a deeper and deeper tree level, we can almost reproduce every -single data point by increasing the max depth of the tree. -We can actually decide to make a decision tree which fits every single point. -As we will -see later, this has the benefit that we can really train a model which -traverses every single data point. However, the price we pay is that -we will easily overfit. That is, if we apply our model to unseen data, -we will most likely fail miserably in our attempt at making -predictions. As an exercise, try to make the tree level larger by adjusting the maximum depth variable. When printing out the predicition, you will note that the binding energy of every nucleus is accurately reproduced. - - -The **seaborn** package allows us to visualize data in an efficient way. Note that we use **scikit-learn**'s multi-layer perceptron (or feed forward neural network) -functionality. - -from sklearn.neural_network import MLPRegressor -from sklearn.metrics import accuracy_score -import seaborn as sns - -X_train = X -Y_train = Energies -n_hidden_neurons = 100 -epochs = 100 -# store models for later use -eta_vals = np.logspace(-5, 1, 7) -lmbd_vals = np.logspace(-5, 1, 7) -# store the models for later use -DNN_scikit = np.zeros((len(eta_vals), len(lmbd_vals)), dtype=object) -train_accuracy = np.zeros((len(eta_vals), len(lmbd_vals))) -sns.set() -for i, eta in enumerate(eta_vals): - for j, lmbd in enumerate(lmbd_vals): - dnn = MLPRegressor(hidden_layer_sizes=(n_hidden_neurons), activation='logistic', - alpha=lmbd, learning_rate_init=eta, max_iter=epochs) - dnn.fit(X_train, Y_train) - DNN_scikit[i][j] = dnn - train_accuracy[i][j] = dnn.score(X_train, Y_train) - -fig, ax = plt.subplots(figsize = (10, 10)) -sns.heatmap(train_accuracy, annot=True, ax=ax, cmap="viridis") -ax.set_title("Training Accuracy") -ax.set_ylabel("$\eta$") -ax.set_xlabel("$\lambda$") -plt.show() - -## Linear Regression, basic elements - - -[Video of Lecture](https://www.uio.no/studier/emner/matnat/fys/FYS-STK4155/h20/forelesningsvideoer/LectureAug27.mp4?vrtx=view-as-webpage). - - -Fitting a continuous function with linear parameterization in terms of the parameters $\boldsymbol{\beta}$. -* Method of choice for fitting a continuous function! - -* Gives an excellent introduction to central Machine Learning features with **understandable pedagogical** links to other methods like **Neural Networks**, **Support Vector Machines** etc - -* Analytical expression for the fitting parameters $\boldsymbol{\beta}$ - -* Analytical expressions for statistical propertiers like mean values, variances, confidence intervals and more - -* Analytical relation with probabilistic interpretations - -* Easy to introduce basic concepts like bias-variance tradeoff, cross-validation, resampling and regularization techniques and many other ML topics - -* Easy to code! And links well with classification problems and logistic regression and neural networks - -* Allows for **easy** hands-on understanding of gradient descent methods - -* and many more features - -For more discussions of Ridge and Lasso regression, [Wessel van Wieringen's](https://arxiv.org/abs/1509.09169) article is highly recommended. -Similarly, [Mehta et al's article](https://arxiv.org/abs/1803.08823) is also recommended. - - - -Regression modeling deals with the description of the sampling distribution of a given random variable $y$ and how it varies as function of another variable or a set of such variables $\boldsymbol{x} =[x_0, x_1,\dots, x_{n-1}]^T$. -The first variable is called the **dependent**, the **outcome** or the **response** variable while the set of variables $\boldsymbol{x}$ is called the independent variable, or the predictor variable or the explanatory variable. - -A regression model aims at finding a likelihood function $p(\boldsymbol{y}\vert \boldsymbol{x})$, that is the conditional distribution for $\boldsymbol{y}$ with a given $\boldsymbol{x}$. The estimation of $p(\boldsymbol{y}\vert \boldsymbol{x})$ is made using a data set with -* $n$ cases $i = 0, 1, 2, \dots, n-1$ - -* Response (target, dependent or outcome) variable $y_i$ with $i = 0, 1, 2, \dots, n-1$ - -* $p$ so-called explanatory (independent or predictor) variables $\boldsymbol{x}_i=[x_{i0}, x_{i1}, \dots, x_{ip-1}]$ with $i = 0, 1, 2, \dots, n-1$ and explanatory variables running from $0$ to $p-1$. See below for more explicit examples. - - The goal of the regression analysis is to extract/exploit relationship between $\boldsymbol{y}$ and $\boldsymbol{x}$ in or to infer causal dependencies, approximations to the likelihood functions, functional relationships and to make predictions, making fits and many other things. - - -Consider an experiment in which $p$ characteristics of $n$ samples are -measured. The data from this experiment, for various explanatory variables $p$ are normally represented by a matrix -$\mathbf{X}$. - -The matrix $\mathbf{X}$ is called the *design -matrix*. Additional information of the samples is available in the -form of $\boldsymbol{y}$ (also as above). The variable $\boldsymbol{y}$ is -generally referred to as the *response variable*. The aim of -regression analysis is to explain $\boldsymbol{y}$ in terms of -$\boldsymbol{X}$ through a functional relationship like $y_i = -f(\mathbf{X}_{i,\ast})$. When no prior knowledge on the form of -$f(\cdot)$ is available, it is common to assume a linear relationship -between $\boldsymbol{X}$ and $\boldsymbol{y}$. This assumption gives rise to -the *linear regression model* where $\boldsymbol{\beta} = [\beta_0, \ldots, -\beta_{p-1}]^{T}$ are the *regression parameters*. - -Linear regression gives us a set of analytical equations for the parameters $\beta_j$. - - -In order to understand the relation among the predictors $p$, the set of data $n$ and the target (outcome, output etc) $\boldsymbol{y}$, -consider the model we discussed for describing nuclear binding energies. - -There we assumed that we could parametrize the data using a polynomial approximation based on the liquid drop model. -Assuming - -$$ -BE(A) = a_0+a_1A+a_2A^{2/3}+a_3A^{-1/3}+a_4A^{-1}, -$$ - -we have five predictors, that is the intercept, the $A$ dependent term, the $A^{2/3}$ term and the $A^{-1/3}$ and $A^{-1}$ terms. -This gives $p=0,1,2,3,4$. Furthermore we have $n$ entries for each predictor. It means that our design matrix is a -$p\times n$ matrix $\boldsymbol{X}$. - -Here the predictors are based on a model we have made. A popular data set which is widely encountered in ML applications is the -so-called [credit card default data from Taiwan](https://www.sciencedirect.com/science/article/pii/S0957417407006719?via%3Dihub). The data set contains data on $n=30000$ credit card holders with predictors like gender, marital status, age, profession, education, etc. In total there are $24$ such predictors or attributes leading to a design matrix of dimensionality $24 \times 30000$. This is however a classification problem and we will come back to it when we discuss Logistic Regression. - - -Before we proceed let us study a case from linear algebra where we aim at fitting a set of data $\boldsymbol{y}=[y_0,y_1,\dots,y_{n-1}]$. We could think of these data as a result of an experiment or a complicated numerical experiment. These data are functions of a series of variables $\boldsymbol{x}=[x_0,x_1,\dots,x_{n-1}]$, that is $y_i = y(x_i)$ with $i=0,1,2,\dots,n-1$. The variables $x_i$ could represent physical quantities like time, temperature, position etc. We assume that $y(x)$ is a smooth function. - -Since obtaining these data points may not be trivial, we want to use these data to fit a function which can allow us to make predictions for values of $y$ which are not in the present set. The perhaps simplest approach is to assume we can parametrize our function in terms of a polynomial of degree $n-1$ with $n$ points, that is - -$$ -y=y(x) \rightarrow y(x_i)=\tilde{y}_i+\epsilon_i=\sum_{j=0}^{n-1} \beta_j x_i^j+\epsilon_i, -$$ - -where $\epsilon_i$ is the error in our approximation. - - -For every set of values $y_i,x_i$ we have thus the corresponding set of equations - -$$ -\begin{align*} -y_0&=\beta_0+\beta_1x_0^1+\beta_2x_0^2+\dots+\beta_{n-1}x_0^{n-1}+\epsilon_0\\ -y_1&=\beta_0+\beta_1x_1^1+\beta_2x_1^2+\dots+\beta_{n-1}x_1^{n-1}+\epsilon_1\\ -y_2&=\beta_0+\beta_1x_2^1+\beta_2x_2^2+\dots+\beta_{n-1}x_2^{n-1}+\epsilon_2\\ -\dots & \dots \\ -y_{n-1}&=\beta_0+\beta_1x_{n-1}^1+\beta_2x_{n-1}^2+\dots+\beta_{n-1}x_{n-1}^{n-1}+\epsilon_{n-1}.\\ -\end{align*} -$$ - -Defining the vectors - -$$ -\boldsymbol{y} = [y_0,y_1, y_2,\dots, y_{n-1}]^T, -$$ - -and - -$$ -\boldsymbol{\beta} = [\beta_0,\beta_1, \beta_2,\dots, \beta_{n-1}]^T, -$$ - -and - -$$ -\boldsymbol{\epsilon} = [\epsilon_0,\epsilon_1, \epsilon_2,\dots, \epsilon_{n-1}]^T, -$$ - -and the design matrix - -$$ -\boldsymbol{X}= -\begin{bmatrix} -1& x_{0}^1 &x_{0}^2& \dots & \dots &x_{0}^{n-1}\\ -1& x_{1}^1 &x_{1}^2& \dots & \dots &x_{1}^{n-1}\\ -1& x_{2}^1 &x_{2}^2& \dots & \dots &x_{2}^{n-1}\\ -\dots& \dots &\dots& \dots & \dots &\dots\\ -1& x_{n-1}^1 &x_{n-1}^2& \dots & \dots &x_{n-1}^{n-1}\\ -\end{bmatrix} -$$ - -we can rewrite our equations as - -$$ -\boldsymbol{y} = \boldsymbol{X}\boldsymbol{\beta}+\boldsymbol{\epsilon}. -$$ - -The above design matrix is called a [Vandermonde matrix](https://en.wikipedia.org/wiki/Vandermonde_matrix). - -We are obviously not limited to the above polynomial expansions. We -could replace the various powers of $x$ with elements of Fourier -series or instead of $x_i^j$ we could have $\cos{(j x_i)}$ or $\sin{(j -x_i)}$, or time series or other orthogonal functions. For every set -of values $y_i,x_i$ we can then generalize the equations to - -$$ -\begin{align*} -y_0&=\beta_0x_{00}+\beta_1x_{01}+\beta_2x_{02}+\dots+\beta_{n-1}x_{0n-1}+\epsilon_0\\ -y_1&=\beta_0x_{10}+\beta_1x_{11}+\beta_2x_{12}+\dots+\beta_{n-1}x_{1n-1}+\epsilon_1\\ -y_2&=\beta_0x_{20}+\beta_1x_{21}+\beta_2x_{22}+\dots+\beta_{n-1}x_{2n-1}+\epsilon_2\\ -\dots & \dots \\ -y_{i}&=\beta_0x_{i0}+\beta_1x_{i1}+\beta_2x_{i2}+\dots+\beta_{n-1}x_{in-1}+\epsilon_i\\ -\dots & \dots \\ -y_{n-1}&=\beta_0x_{n-1,0}+\beta_1x_{n-1,2}+\beta_2x_{n-1,2}+\dots+\beta_{n-1}x_{n-1,n-1}+\epsilon_{n-1}.\\ -\end{align*} -$$ - -**Note that we have $p=n$ here. The matrix is symmetric. This is generally not the case!** - -We redefine in turn the matrix $\boldsymbol{X}$ as - -$$ -\boldsymbol{X}= -\begin{bmatrix} -x_{00}& x_{01} &x_{02}& \dots & \dots &x_{0,n-1}\\ -x_{10}& x_{11} &x_{12}& \dots & \dots &x_{1,n-1}\\ -x_{20}& x_{21} &x_{22}& \dots & \dots &x_{2,n-1}\\ -\dots& \dots &\dots& \dots & \dots &\dots\\ -x_{n-1,0}& x_{n-1,1} &x_{n-1,2}& \dots & \dots &x_{n-1,n-1}\\ -\end{bmatrix} -$$ - -and without loss of generality we rewrite again our equations as - -$$ -\boldsymbol{y} = \boldsymbol{X}\boldsymbol{\beta}+\boldsymbol{\epsilon}. -$$ - -The left-hand side of this equation is kwown. Our error vector $\boldsymbol{\epsilon}$ and the parameter vector $\boldsymbol{\beta}$ are our unknow quantities. How can we obtain the optimal set of $\beta_i$ values? - -We have defined the matrix $\boldsymbol{X}$ via the equations - -$$ -\begin{align*} -y_0&=\beta_0x_{00}+\beta_1x_{01}+\beta_2x_{02}+\dots+\beta_{n-1}x_{0n-1}+\epsilon_0\\ -y_1&=\beta_0x_{10}+\beta_1x_{11}+\beta_2x_{12}+\dots+\beta_{n-1}x_{1n-1}+\epsilon_1\\ -y_2&=\beta_0x_{20}+\beta_1x_{21}+\beta_2x_{22}+\dots+\beta_{n-1}x_{2n-1}+\epsilon_1\\ -\dots & \dots \\ -y_{i}&=\beta_0x_{i0}+\beta_1x_{i1}+\beta_2x_{i2}+\dots+\beta_{n-1}x_{in-1}+\epsilon_1\\ -\dots & \dots \\ -y_{n-1}&=\beta_0x_{n-1,0}+\beta_1x_{n-1,2}+\beta_2x_{n-1,2}+\dots+\beta_{n-1}x_{n-1,n-1}+\epsilon_{n-1}.\\ -\end{align*} -$$ - -As we noted above, we stayed with a system with the design matrix - $\boldsymbol{X}\in {\mathbb{R}}^{n\times n}$, that is we have $p=n$. For reasons to come later (algorithmic arguments) we will hereafter define -our matrix as $\boldsymbol{X}\in {\mathbb{R}}^{n\times p}$, with the predictors refering to the column numbers and the entries $n$ being the row elements. - -In our [introductory notes](https://compphysics.github.io/MachineLearning/doc/pub/How2ReadData/html/How2ReadData.html) we looked at the so-called [liquid drop model](https://en.wikipedia.org/wiki/Semi-empirical_mass_formula). Let us remind ourselves about what we did by looking at the code. - -We restate the parts of the code we are most interested in. - -# Common imports -import numpy as np -import pandas as pd -import matplotlib.pyplot as plt -from IPython.display import display -import os - -# Where to save the figures and data files -PROJECT_ROOT_DIR = "Results" -FIGURE_ID = "Results/FigureFiles" -DATA_ID = "DataFiles/" - -if not os.path.exists(PROJECT_ROOT_DIR): - os.mkdir(PROJECT_ROOT_DIR) - -if not os.path.exists(FIGURE_ID): - os.makedirs(FIGURE_ID) - -if not os.path.exists(DATA_ID): - os.makedirs(DATA_ID) - -def image_path(fig_id): - return os.path.join(FIGURE_ID, fig_id) - -def data_path(dat_id): - return os.path.join(DATA_ID, dat_id) - -def save_fig(fig_id): - plt.savefig(image_path(fig_id) + ".png", format='png') - -infile = open(data_path("MassEval2016.dat"),'r') - - -# Read the experimental data with Pandas -Masses = pd.read_fwf(infile, usecols=(2,3,4,6,11), - names=('N', 'Z', 'A', 'Element', 'Ebinding'), - widths=(1,3,5,5,5,1,3,4,1,13,11,11,9,1,2,11,9,1,3,1,12,11,1), - header=39, - index_col=False) - -# Extrapolated values are indicated by '#' in place of the decimal place, so -# the Ebinding column won't be numeric. Coerce to float and drop these entries. -Masses['Ebinding'] = pd.to_numeric(Masses['Ebinding'], errors='coerce') -Masses = Masses.dropna() -# Convert from keV to MeV. -Masses['Ebinding'] /= 1000 - -# Group the DataFrame by nucleon number, A. -Masses = Masses.groupby('A') -# Find the rows of the grouped DataFrame with the maximum binding energy. -Masses = Masses.apply(lambda t: t[t.Ebinding==t.Ebinding.max()]) -A = Masses['A'] -Z = Masses['Z'] -N = Masses['N'] -Element = Masses['Element'] -Energies = Masses['Ebinding'] - -# Now we set up the design matrix X -X = np.zeros((len(A),5)) -X[:,0] = 1 -X[:,1] = A -X[:,2] = A**(2.0/3.0) -X[:,3] = A**(-1.0/3.0) -X[:,4] = A**(-1.0) -# Then nice printout using pandas -DesignMatrix = pd.DataFrame(X) -DesignMatrix.index = A -DesignMatrix.columns = ['1', 'A', 'A^(2/3)', 'A^(-1/3)', '1/A'] -display(DesignMatrix) - -With $\boldsymbol{\beta}\in {\mathbb{R}}^{p\times 1}$, it means that we will hereafter write our equations for the approximation as - -$$ -\boldsymbol{\tilde{y}}= \boldsymbol{X}\boldsymbol{\beta}, -$$ - -throughout these lectures. - -With the above we use the design matrix to define the approximation $\boldsymbol{\tilde{y}}$ via the unknown quantity $\boldsymbol{\beta}$ as - -$$ -\boldsymbol{\tilde{y}}= \boldsymbol{X}\boldsymbol{\beta}, -$$ - -and in order to find the optimal parameters $\beta_i$ instead of solving the above linear algebra problem, we define a function which gives a measure of the spread between the values $y_i$ (which represent hopefully the exact values) and the parameterized values $\tilde{y}_i$, namely - -$$ -C(\boldsymbol{\beta})=\frac{1}{n}\sum_{i=0}^{n-1}\left(y_i-\tilde{y}_i\right)^2=\frac{1}{n}\left\{\left(\boldsymbol{y}-\boldsymbol{\tilde{y}}\right)^T\left(\boldsymbol{y}-\boldsymbol{\tilde{y}}\right)\right\}, -$$ - -or using the matrix $\boldsymbol{X}$ and in a more compact matrix-vector notation as - -$$ -C(\boldsymbol{\beta})=\frac{1}{n}\left\{\left(\boldsymbol{y}-\boldsymbol{X}\boldsymbol{\beta}\right)^T\left(\boldsymbol{y}-\boldsymbol{X}\boldsymbol{\beta}\right)\right\}. -$$ - -This function is one possible way to define the so-called cost function. - - - -It is also common to define -the function $C$ as - -$$ -C(\boldsymbol{\beta})=\frac{1}{2n}\sum_{i=0}^{n-1}\left(y_i-\tilde{y}_i\right)^2, -$$ - -since when taking the first derivative with respect to the unknown parameters $\beta$, the factor of $2$ cancels out. - -The function - -$$ -C(\boldsymbol{\beta})=\frac{1}{n}\left\{\left(\boldsymbol{y}-\boldsymbol{X}\boldsymbol{\beta}\right)^T\left(\boldsymbol{y}-\boldsymbol{X}\boldsymbol{\beta}\right)\right\}, -$$ - -can be linked to the variance of the quantity $y_i$ if we interpret the latter as the mean value. -When linking (see the discussion below) with the maximum likelihood approach below, we will indeed interpret $y_i$ as a mean value - -$$ -y_{i}=\langle y_i \rangle = \beta_0x_{i,0}+\beta_1x_{i,1}+\beta_2x_{i,2}+\dots+\beta_{n-1}x_{i,n-1}+\epsilon_i, -$$ - -where $\langle y_i \rangle$ is the mean value. Keep in mind also that -till now we have treated $y_i$ as the exact value. Normally, the -response (dependent or outcome) variable $y_i$ the outcome of a -numerical experiment or another type of experiment and is thus only an -approximation to the true value. It is then always accompanied by an -error estimate, often limited to a statistical error estimate given by -the standard deviation discussed earlier. In the discussion here we -will treat $y_i$ as our exact value for the response variable. - -In order to find the parameters $\beta_i$ we will then minimize the spread of $C(\boldsymbol{\beta})$, that is we are going to solve the problem - -$$ -{\displaystyle \min_{\boldsymbol{\beta}\in -{\mathbb{R}}^{p}}}\frac{1}{n}\left\{\left(\boldsymbol{y}-\boldsymbol{X}\boldsymbol{\beta}\right)^T\left(\boldsymbol{y}-\boldsymbol{X}\boldsymbol{\beta}\right)\right\}. -$$ - -In practical terms it means we will require - -$$ -\frac{\partial C(\boldsymbol{\beta})}{\partial \beta_j} = \frac{\partial }{\partial \beta_j}\left[ \frac{1}{n}\sum_{i=0}^{n-1}\left(y_i-\beta_0x_{i,0}-\beta_1x_{i,1}-\beta_2x_{i,2}-\dots-\beta_{n-1}x_{i,n-1}\right)^2\right]=0, -$$ - -which results in - -$$ -\frac{\partial C(\boldsymbol{\beta})}{\partial \beta_j} = -\frac{2}{n}\left[ \sum_{i=0}^{n-1}x_{ij}\left(y_i-\beta_0x_{i,0}-\beta_1x_{i,1}-\beta_2x_{i,2}-\dots-\beta_{n-1}x_{i,n-1}\right)\right]=0, -$$ - -or in a matrix-vector form as - -$$ -\frac{\partial C(\boldsymbol{\beta})}{\partial \boldsymbol{\beta}} = 0 = \boldsymbol{X}^T\left( \boldsymbol{y}-\boldsymbol{X}\boldsymbol{\beta}\right). -$$ - -We can rewrite - -$$ -\frac{\partial C(\boldsymbol{\beta})}{\partial \boldsymbol{\beta}} = 0 = \boldsymbol{X}^T\left( \boldsymbol{y}-\boldsymbol{X}\boldsymbol{\beta}\right), -$$ - -as - -$$ -\boldsymbol{X}^T\boldsymbol{y} = \boldsymbol{X}^T\boldsymbol{X}\boldsymbol{\beta}, -$$ - -and if the matrix $\boldsymbol{X}^T\boldsymbol{X}$ is invertible we have the solution - -$$ -\boldsymbol{\beta} =\left(\boldsymbol{X}^T\boldsymbol{X}\right)^{-1}\boldsymbol{X}^T\boldsymbol{y}. -$$ - -We note also that since our design matrix is defined as $\boldsymbol{X}\in -{\mathbb{R}}^{n\times p}$, the product $\boldsymbol{X}^T\boldsymbol{X} \in -{\mathbb{R}}^{p\times p}$. In the above case we have that $p \ll n$, -in our case $p=5$ meaning that we end up with inverting a small -$5\times 5$ matrix. This is a rather common situation, in many cases we end up with low-dimensional -matrices to invert. The methods discussed here and for many other -supervised learning algorithms like classification with logistic -regression or support vector machines, exhibit dimensionalities which -allow for the usage of direct linear algebra methods such as **LU** decomposition or **Singular Value Decomposition** (SVD) for finding the inverse of the matrix -$\boldsymbol{X}^T\boldsymbol{X}$. - -**Small question**: Do you think the example we have at hand here (the nuclear binding energies) can lead to problems in inverting the matrix $\boldsymbol{X}^T\boldsymbol{X}$? What kind of problems can we expect? - - -The following matrix and vector relation will be useful here and for the rest of the course. Vectors are always written as boldfaced lower case letters and -matrices as upper case boldfaced letters. - -4 -3 - -< -< -< -! -! -M -A -T -H -_ -B -L -O -C -K - -4 -4 - -< -< -< -! -! -M -A -T -H -_ -B -L -O -C -K - -4 -5 - -< -< -< -! -! -M -A -T -H -_ -B -L -O -C -K - -$$ -\frac{\partial\log{\vert\boldsymbol{A}\vert}}{\partial \boldsymbol{A}}=(\boldsymbol{A}^{-1})^T. -$$ - -We can then compute the second derivative of the cost function, which in our case is the second derivative -of the means squared error. This leads to - -$$ -\frac{\partial^2 C(\boldsymbol{\beta})}{\partial \boldsymbol{\beta}^T\partial \boldsymbol{\beta}} =\frac{2}{n}\boldsymbol{X}^T\boldsymbol{X}. -$$ - -This quantity defines was what is called the Hessian matrix (the second derivative of a function we want to optimize). - -The Hessian matrix plays an important role and is defined for the mean squared error as - -$$ -\boldsymbol{H}=\boldsymbol{X}^T\boldsymbol{X}. -$$ - -The Hessian matrix for ordinary least squares is also proportional to -the covariance matrix. As we will see in the chapter on Ridge and Lasso regression, This means that we can use the Singular Value Decomposition of a matrix to find -the eigenvalues of the covariance matrix and the Hessian matrix in -terms of the singular values. - - -The residuals $\boldsymbol{\epsilon}$ are in turn given by - -$$ -\boldsymbol{\epsilon} = \boldsymbol{y}-\boldsymbol{\tilde{y}} = \boldsymbol{y}-\boldsymbol{X}\boldsymbol{\beta}, -$$ - -and with - -$$ -\boldsymbol{X}^T\left( \boldsymbol{y}-\boldsymbol{X}\boldsymbol{\beta}\right)= 0, -$$ - -we have - -$$ -\boldsymbol{X}^T\boldsymbol{\epsilon}=\boldsymbol{X}^T\left( \boldsymbol{y}-\boldsymbol{X}\boldsymbol{\beta}\right)= 0, -$$ - -meaning that the solution for $\boldsymbol{\beta}$ is the one which minimizes the residuals. Later we will link this with the maximum likelihood approach. - - -Let us now return to our nuclear binding energies and simply code the above equations. - - -It is rather straightforward to implement the matrix inversion and obtain the parameters $\boldsymbol{\beta}$. After having defined the matrix $\boldsymbol{X}$ we simply need to -write - -# matrix inversion to find beta -beta = np.linalg.inv(X.T.dot(X)).dot(X.T).dot(Energies) -# and then make the prediction -ytilde = X @ beta - -Alternatively, you can use the least squares functionality in **Numpy** as - -fit = np.linalg.lstsq(X, Energies, rcond =None)[0] -ytildenp = np.dot(fit,X.T) - -And finally we plot our fit with and compare with data - -Masses['Eapprox'] = ytilde -# Generate a plot comparing the experimental with the fitted values values. -fig, ax = plt.subplots() -ax.set_xlabel(r'$A = N + Z$') -ax.set_ylabel(r'$E_\mathrm{bind}\,/\mathrm{MeV}$') -ax.plot(Masses['A'], Masses['Ebinding'], alpha=0.7, lw=2, - label='Ame2016') -ax.plot(Masses['A'], Masses['Eapprox'], alpha=0.7, lw=2, c='m', - label='Fit') -ax.legend() -save_fig("Masses2016OLS") -plt.show() - -We can easily test our fit by computing the $R2$ score that we discussed in connection with the functionality of **Scikit-Learn** in the introductory slides. -Since we are not using **Scikit-Learn** here we can define our own $R2$ function as - -def R2(y_data, y_model): - return 1 - np.sum((y_data - y_model) ** 2) / np.sum((y_data - np.mean(y_data)) ** 2) - -and we would be using it as - -print(R2(Energies,ytilde)) - -We can easily add our **MSE** score as - -def MSE(y_data,y_model): - n = np.size(y_model) - return np.sum((y_data-y_model)**2)/n - -print(MSE(Energies,ytilde)) - -and finally the relative error as - -def RelativeError(y_data,y_model): - return abs((y_data-y_model)/y_data) -print(RelativeError(Energies, ytilde)) - -### The $\chi^2$ function - -Normally, the response (dependent or outcome) variable $y_i$ is the -outcome of a numerical experiment or another type of experiment and is -thus only an approximation to the true value. It is then always -accompanied by an error estimate, often limited to a statistical error -estimate given by the standard deviation discussed earlier. In the -discussion here we will treat $y_i$ as our exact value for the -response variable. - -Introducing the standard deviation $\sigma_i$ for each measurement -$y_i$, we define now the $\chi^2$ function (omitting the $1/n$ term) -as - -$$ -\chi^2(\boldsymbol{\beta})=\frac{1}{n}\sum_{i=0}^{n-1}\frac{\left(y_i-\tilde{y}_i\right)^2}{\sigma_i^2}=\frac{1}{n}\left\{\left(\boldsymbol{y}-\boldsymbol{\tilde{y}}\right)^T\frac{1}{\boldsymbol{\Sigma^2}}\left(\boldsymbol{y}-\boldsymbol{\tilde{y}}\right)\right\}, -$$ - -where the matrix $\boldsymbol{\Sigma}$ is a diagonal matrix with $\sigma_i$ as matrix elements. - - -In order to find the parameters $\beta_i$ we will then minimize the spread of $\chi^2(\boldsymbol{\beta})$ by requiring - -$$ -\frac{\partial \chi^2(\boldsymbol{\beta})}{\partial \beta_j} = \frac{\partial }{\partial \beta_j}\left[ \frac{1}{n}\sum_{i=0}^{n-1}\left(\frac{y_i-\beta_0x_{i,0}-\beta_1x_{i,1}-\beta_2x_{i,2}-\dots-\beta_{n-1}x_{i,n-1}}{\sigma_i}\right)^2\right]=0, -$$ - -which results in - -$$ -\frac{\partial \chi^2(\boldsymbol{\beta})}{\partial \beta_j} = -\frac{2}{n}\left[ \sum_{i=0}^{n-1}\frac{x_{ij}}{\sigma_i}\left(\frac{y_i-\beta_0x_{i,0}-\beta_1x_{i,1}-\beta_2x_{i,2}-\dots-\beta_{n-1}x_{i,n-1}}{\sigma_i}\right)\right]=0, -$$ - -or in a matrix-vector form as - -$$ -\frac{\partial \chi^2(\boldsymbol{\beta})}{\partial \boldsymbol{\beta}} = 0 = \boldsymbol{A}^T\left( \boldsymbol{b}-\boldsymbol{A}\boldsymbol{\beta}\right). -$$ - -where we have defined the matrix $\boldsymbol{A} =\boldsymbol{X}/\boldsymbol{\Sigma}$ with matrix elements $a_{ij} = x_{ij}/\sigma_i$ and the vector $\boldsymbol{b}$ with elements $b_i = y_i/\sigma_i$. - -We can rewrite - -$$ -\frac{\partial \chi^2(\boldsymbol{\beta})}{\partial \boldsymbol{\beta}} = 0 = \boldsymbol{A}^T\left( \boldsymbol{b}-\boldsymbol{A}\boldsymbol{\beta}\right), -$$ - -as - -$$ -\boldsymbol{A}^T\boldsymbol{b} = \boldsymbol{A}^T\boldsymbol{A}\boldsymbol{\beta}, -$$ - -and if the matrix $\boldsymbol{A}^T\boldsymbol{A}$ is invertible we have the solution - -$$ -\boldsymbol{\beta} =\left(\boldsymbol{A}^T\boldsymbol{A}\right)^{-1}\boldsymbol{A}^T\boldsymbol{b}. -$$ - -If we then introduce the matrix - -$$ -\boldsymbol{H} = \left(\boldsymbol{A}^T\boldsymbol{A}\right)^{-1}, -$$ - -we have then the following expression for the parameters $\beta_j$ (the matrix elements of $\boldsymbol{H}$ are $h_{ij}$) - -$$ -\beta_j = \sum_{k=0}^{p-1}h_{jk}\sum_{i=0}^{n-1}\frac{y_i}{\sigma_i}\frac{x_{ik}}{\sigma_i} = \sum_{k=0}^{p-1}h_{jk}\sum_{i=0}^{n-1}b_ia_{ik} -$$ - -We state without proof the expression for the uncertainty in the parameters $\beta_j$ as (we leave this as an exercise) - -$$ -\sigma^2(\beta_j) = \sum_{i=0}^{n-1}\sigma_i^2\left( \frac{\partial \beta_j}{\partial y_i}\right)^2, -$$ - -resulting in - -$$ -\sigma^2(\beta_j) = \left(\sum_{k=0}^{p-1}h_{jk}\sum_{i=0}^{n-1}a_{ik}\right)\left(\sum_{l=0}^{p-1}h_{jl}\sum_{m=0}^{n-1}a_{ml}\right) = h_{jj}! -$$ - -The first step here is to approximate the function $y$ with a first-order polynomial, that is we write - -$$ -y=y(x) \rightarrow y(x_i) \approx \beta_0+\beta_1 x_i. -$$ - -By computing the derivatives of $\chi^2$ with respect to $\beta_0$ and $\beta_1$ show that these are given by - -$$ -\frac{\partial \chi^2(\boldsymbol{\beta})}{\partial \beta_0} = -2\left[ \frac{1}{n}\sum_{i=0}^{n-1}\left(\frac{y_i-\beta_0-\beta_1x_{i}}{\sigma_i^2}\right)\right]=0, -$$ - -and - -$$ -\frac{\partial \chi^2(\boldsymbol{\beta})}{\partial \beta_1} = -\frac{2}{n}\left[ \sum_{i=0}^{n-1}x_i\left(\frac{y_i-\beta_0-\beta_1x_{i}}{\sigma_i^2}\right)\right]=0. -$$ - -For a linear fit (a first-order polynomial) we don't need to invert a matrix!! -Defining - -$$ -\gamma = \sum_{i=0}^{n-1}\frac{1}{\sigma_i^2}, -$$ - -$$ -\gamma_x = \sum_{i=0}^{n-1}\frac{x_{i}}{\sigma_i^2}, -$$ - -$$ -\gamma_y = \sum_{i=0}^{n-1}\left(\frac{y_i}{\sigma_i^2}\right), -$$ - -$$ -\gamma_{xx} = \sum_{i=0}^{n-1}\frac{x_ix_{i}}{\sigma_i^2}, -$$ - -$$ -\gamma_{xy} = \sum_{i=0}^{n-1}\frac{y_ix_{i}}{\sigma_i^2}, -$$ - -we obtain - -$$ -\beta_0 = \frac{\gamma_{xx}\gamma_y-\gamma_x\gamma_y}{\gamma\gamma_{xx}-\gamma_x^2}, -$$ - -$$ -\beta_1 = \frac{\gamma_{xy}\gamma-\gamma_x\gamma_y}{\gamma\gamma_{xx}-\gamma_x^2}. -$$ - -This approach (different linear and non-linear regression) suffers -often from both being underdetermined and overdetermined in the -unknown coefficients $\beta_i$. A better approach is to use the -Singular Value Decomposition (SVD) method discussed below. Or using -Lasso and Ridge regression. See below. - - -### Fitting an Equation of State for Dense Nuclear Matter - -Before we continue, let us introduce yet another example. We are going to fit the -nuclear equation of state using results from many-body calculations. -The equation of state we have made available here, as function of -density, has been derived using modern nucleon-nucleon potentials with -[the addition of three-body -forces](https://www.sciencedirect.com/science/article/pii/S0370157399001106). This -time the file is presented as a standard **csv** file. - -The beginning of the Python code here is similar to what you have seen -before, with the same initializations and declarations. We use also -**pandas** again, rather extensively in order to organize our data. - -The difference now is that we use **Scikit-Learn's** regression tools -instead of our own matrix inversion implementation. - -# Common imports -import os -import numpy as np -import pandas as pd -import matplotlib.pyplot as plt -import matplotlib.pyplot as plt -import sklearn.linear_model as skl -from sklearn.metrics import mean_squared_error, r2_score, mean_absolute_error - -# Where to save the figures and data files -PROJECT_ROOT_DIR = "Results" -FIGURE_ID = "Results/FigureFiles" -DATA_ID = "DataFiles/" - -if not os.path.exists(PROJECT_ROOT_DIR): - os.mkdir(PROJECT_ROOT_DIR) - -if not os.path.exists(FIGURE_ID): - os.makedirs(FIGURE_ID) - -if not os.path.exists(DATA_ID): - os.makedirs(DATA_ID) - -def image_path(fig_id): - return os.path.join(FIGURE_ID, fig_id) - -def data_path(dat_id): - return os.path.join(DATA_ID, dat_id) - -def save_fig(fig_id): - plt.savefig(image_path(fig_id) + ".png", format='png') - -infile = open(data_path("EoS.csv"),'r') - -# Read the EoS data as csv file and organize the data into two arrays with density and energies -EoS = pd.read_csv(infile, names=('Density', 'Energy')) -EoS['Energy'] = pd.to_numeric(EoS['Energy'], errors='coerce') -EoS = EoS.dropna() -Energies = EoS['Energy'] -Density = EoS['Density'] -# The design matrix now as function of various polytrops -X = np.zeros((len(Density),4)) -X[:,3] = Density**(4.0/3.0) -X[:,2] = Density -X[:,1] = Density**(2.0/3.0) -X[:,0] = 1 - -# We use now Scikit-Learn's linear regressor and ridge regressor -# OLS part -clf = skl.LinearRegression().fit(X, Energies) -ytilde = clf.predict(X) -EoS['Eols'] = ytilde -# The mean squared error -print("Mean squared error: %.2f" % mean_squared_error(Energies, ytilde)) -# Explained variance score: 1 is perfect prediction -print('Variance score: %.2f' % r2_score(Energies, ytilde)) -# Mean absolute error -print('Mean absolute error: %.2f' % mean_absolute_error(Energies, ytilde)) -print(clf.coef_, clf.intercept_) - - -fig, ax = plt.subplots() -ax.set_xlabel(r'$\rho[\mathrm{fm}^{-3}]$') -ax.set_ylabel(r'Energy per particle') -ax.plot(EoS['Density'], EoS['Energy'], alpha=0.7, lw=2, - label='Theoretical data') -ax.plot(EoS['Density'], EoS['Eols'], alpha=0.7, lw=2, c='m', - label='OLS') -ax.legend() -save_fig("EoSfitting") -plt.show() - -The above simple polynomial in density $\rho$ gives an excellent fit -to the data. - - - -## Splitting our Data in Training and Test data - - -It is normal in essentially all Machine Learning studies to split the -data in a training set and a test set (sometimes also an additional -validation set). **Scikit-Learn** has an own function for this. There -is no explicit recipe for how much data should be included as training -data and say test data. An accepted rule of thumb is to use -approximately $2/3$ to $4/5$ of the data as training data. We will -postpone a discussion of this splitting to the end of these notes and -our discussion of the so-called **bias-variance** tradeoff. Here we -limit ourselves to repeat the above equation of state fitting example -but now splitting the data into a training set and a test set. - -Let us study some examples. The first code here takes a simple -one-dimensional second-order polynomial and we fit it to a -second-order polynomial. Depending on the strength of the added noise, -the various measures like the $R2$ score or the mean-squared error, -the fit becomes better or worse. - -import os -import numpy as np -import pandas as pd -import matplotlib.pyplot as plt -from sklearn.model_selection import train_test_split - - -def R2(y_data, y_model): - return 1 - np.sum((y_data - y_model) ** 2) / np.sum((y_data - np.mean(y_data)) ** 2) -def MSE(y_data,y_model): - n = np.size(y_model) - return np.sum((y_data-y_model)**2)/n - -x = np.random.rand(100) -y = 2.0+5*x*x+0.1*np.random.randn(100) - - -# The design matrix now as function of a given polynomial -X = np.zeros((len(x),3)) -X[:,0] = 1.0 -X[:,1] = x -X[:,2] = x**2 -# We split the data in test and training data -X_train, X_test, y_train, y_test = train_test_split(X, y, test_size=0.2) -# matrix inversion to find beta -beta = np.linalg.inv(X_train.T @ X_train) @ X_train.T @ y_train -print(beta) -# and then make the prediction -ytilde = X_train @ beta -print("Training R2") -print(R2(y_train,ytilde)) -print("Training MSE") -print(MSE(y_train,ytilde)) -ypredict = X_test @ beta -print("Test R2") -print(R2(y_test,ypredict)) -print("Test MSE") -print(MSE(y_test,ypredict)) - -Alternatively, you could write your own test-train splitting function as shown here. - -# equivalently in numpy -def train_test_split_numpy(inputs, labels, train_size, test_size): - n_inputs = len(inputs) - inputs_shuffled = inputs.copy() - labels_shuffled = labels.copy() - - np.random.shuffle(inputs_shuffled) - np.random.shuffle(labels_shuffled) - - train_end = int(n_inputs*train_size) - X_train, X_test = inputs_shuffled[:train_end], inputs_shuffled[train_end:] - Y_train, Y_test = labels_shuffled[:train_end], labels_shuffled[train_end:] - - return X_train, X_test, Y_train, Y_test - -But since **scikit-learn** has its own function for doing this and since -it interfaces easily with **tensorflow** and other libraries, we -normally recommend using the latter functionality. - - -As another example, we apply the training and testing split to -to the above equation of state fitting example -but now splitting the data into a training set and a test set. - -import os -import numpy as np -import pandas as pd -import matplotlib.pyplot as plt -from sklearn.model_selection import train_test_split -# Where to save the figures and data files -PROJECT_ROOT_DIR = "Results" -FIGURE_ID = "Results/FigureFiles" -DATA_ID = "DataFiles/" - -if not os.path.exists(PROJECT_ROOT_DIR): - os.mkdir(PROJECT_ROOT_DIR) - -if not os.path.exists(FIGURE_ID): - os.makedirs(FIGURE_ID) - -if not os.path.exists(DATA_ID): - os.makedirs(DATA_ID) - -def image_path(fig_id): - return os.path.join(FIGURE_ID, fig_id) - -def data_path(dat_id): - return os.path.join(DATA_ID, dat_id) - -def save_fig(fig_id): - plt.savefig(image_path(fig_id) + ".png", format='png') - -def R2(y_data, y_model): - return 1 - np.sum((y_data - y_model) ** 2) / np.sum((y_data - np.mean(y_data)) ** 2) -def MSE(y_data,y_model): - n = np.size(y_model) - return np.sum((y_data-y_model)**2)/n - -infile = open(data_path("EoS.csv"),'r') - -# Read the EoS data as csv file and organized into two arrays with density and energies -EoS = pd.read_csv(infile, names=('Density', 'Energy')) -EoS['Energy'] = pd.to_numeric(EoS['Energy'], errors='coerce') -EoS = EoS.dropna() -Energies = EoS['Energy'] -Density = EoS['Density'] -# The design matrix now as function of various polytrops -X = np.zeros((len(Density),5)) -X[:,0] = 1 -X[:,1] = Density**(2.0/3.0) -X[:,2] = Density -X[:,3] = Density**(4.0/3.0) -X[:,4] = Density**(5.0/3.0) -# We split the data in test and training data -X_train, X_test, y_train, y_test = train_test_split(X, Energies, test_size=0.2) -# matrix inversion to find beta -beta = np.linalg.inv(X_train.T.dot(X_train)).dot(X_train.T).dot(y_train) -# and then make the prediction -ytilde = X_train @ beta -print("Training R2") -print(R2(y_train,ytilde)) -print("Training MSE") -print(MSE(y_train,ytilde)) -ypredict = X_test @ beta -print("Test R2") -print(R2(y_test,ypredict)) -print("Test MSE") -print(MSE(y_test,ypredict)) - -## The Boston housing data example - -The Boston housing -data set was originally a part of UCI Machine Learning Repository -and has been removed now. The data set is now included in **Scikit-Learn**'s -library. There are 506 samples and 13 feature (predictor) variables -in this data set. The objective is to predict the value of prices of -the house using the features (predictors) listed here. - -The features/predictors are -1. CRIM: Per capita crime rate by town - -2. ZN: Proportion of residential land zoned for lots over 25000 square feet - -3. INDUS: Proportion of non-retail business acres per town - -4. CHAS: Charles River dummy variable (= 1 if tract bounds river; 0 otherwise) - -5. NOX: Nitric oxide concentration (parts per 10 million) - -6. RM: Average number of rooms per dwelling - -7. AGE: Proportion of owner-occupied units built prior to 1940 - -8. DIS: Weighted distances to five Boston employment centers - -9. RAD: Index of accessibility to radial highways - -10. TAX: Full-value property tax rate per USD10000 - -11. B: $1000(Bk - 0.63)^2$, where $Bk$ is the proportion of [people of African American descent] by town - -12. LSTAT: Percentage of lower status of the population - -13. MEDV: Median value of owner-occupied homes in USD 1000s - -## Housing data, the code -We start by importing the libraries - -import numpy as np -import matplotlib.pyplot as plt - -import pandas as pd -import seaborn as sns - -and load the Boston Housing DataSet from **Scikit-Learn** - -from sklearn.datasets import load_boston - -boston_dataset = load_boston() - -# boston_dataset is a dictionary -# let's check what it contains -boston_dataset.keys() - -Then we invoke Pandas - -boston = pd.DataFrame(boston_dataset.data, columns=boston_dataset.feature_names) -boston.head() -boston['MEDV'] = boston_dataset.target - -and preprocess the data - -# check for missing values in all the columns -boston.isnull().sum() - -We can then visualize the data - -# set the size of the figure -sns.set(rc={'figure.figsize':(11.7,8.27)}) - -# plot a histogram showing the distribution of the target values -sns.distplot(boston['MEDV'], bins=30) -plt.show() - -It is now useful to look at the correlation matrix - -# compute the pair wise correlation for all columns -correlation_matrix = boston.corr().round(2) -# use the heatmap function from seaborn to plot the correlation matrix -# annot = True to print the values inside the square -sns.heatmap(data=correlation_matrix, annot=True) - -From the above coorelation plot we can see that **MEDV** is strongly correlated to **LSTAT** and **RM**. We see also that **RAD** and **TAX** are stronly correlated, but we don't include this in our features together to avoid multi-colinearity - -plt.figure(figsize=(20, 5)) - -features = ['LSTAT', 'RM'] -target = boston['MEDV'] - -for i, col in enumerate(features): - plt.subplot(1, len(features) , i+1) - x = boston[col] - y = target - plt.scatter(x, y, marker='o') - plt.title(col) - plt.xlabel(col) - plt.ylabel('MEDV') - -Now we start training our model - -X = pd.DataFrame(np.c_[boston['LSTAT'], boston['RM']], columns = ['LSTAT','RM']) -Y = boston['MEDV'] - -We split the data into training and test sets - -from sklearn.model_selection import train_test_split - -# splits the training and test data set in 80% : 20% -# assign random_state to any value.This ensures consistency. -X_train, X_test, Y_train, Y_test = train_test_split(X, Y, test_size = 0.2, random_state=5) -print(X_train.shape) -print(X_test.shape) -print(Y_train.shape) -print(Y_test.shape) - -Then we use the linear regression functionality from **Scikit-Learn** - -from sklearn.linear_model import LinearRegression -from sklearn.metrics import mean_squared_error, r2_score - -lin_model = LinearRegression() -lin_model.fit(X_train, Y_train) - -# model evaluation for training set - -y_train_predict = lin_model.predict(X_train) -rmse = (np.sqrt(mean_squared_error(Y_train, y_train_predict))) -r2 = r2_score(Y_train, y_train_predict) - -print("The model performance for training set") -print("--------------------------------------") -print('RMSE is {}'.format(rmse)) -print('R2 score is {}'.format(r2)) -print("\n") - -# model evaluation for testing set - -y_test_predict = lin_model.predict(X_test) -# root mean square error of the model -rmse = (np.sqrt(mean_squared_error(Y_test, y_test_predict))) - -# r-squared score of the model -r2 = r2_score(Y_test, y_test_predict) - -print("The model performance for testing set") -print("--------------------------------------") -print('RMSE is {}'.format(rmse)) -print('R2 score is {}'.format(r2)) - -# plotting the y_test vs y_pred -# ideally should have been a straight line -plt.scatter(Y_test, y_test_predict) -plt.show() - -## Reducing the number of degrees of freedom, overarching view - -Many Machine Learning problems involve thousands or even millions of -features for each training instance. Not only does this make training -extremely slow, it can also make it much harder to find a good -solution, as we will see. This problem is often referred to as the -curse of dimensionality. Fortunately, in real-world problems, it is -often possible to reduce the number of features considerably, turning -an intractable problem into a tractable one. - -Later we will discuss some of the most popular dimensionality reduction -techniques: the principal component analysis (PCA), Kernel PCA, and -Locally Linear Embedding (LLE). - - -Principal component analysis and its various variants deal with the -problem of fitting a low-dimensional [affine -subspace](https://en.wikipedia.org/wiki/Affine_space) to a set of of -data points in a high-dimensional space. With its family of methods it -is one of the most used tools in data modeling, compression and -visualization. - - - -Before we proceed however, we will discuss how to preprocess our -data. Till now and in connection with our previous examples we have -not met so many cases where we are too sensitive to the scaling of our -data. Normally the data may need a rescaling and/or may be sensitive -to extreme values. Scaling the data renders our inputs much more -suitable for the algorithms we want to employ. - -For data sets gathered for real world applications, it is rather normal that -different features have very different units and -numerical scales. For example, a data set detailing health habits may include -features such as **age** in the range $0-80$, and **caloric intake** of order $2000$. -Many machine learning methods sensitive to the scales of the features and may perform poorly if they -are very different scales. Therefore, it is typical to scale -the features in a way to avoid such outlier values. - - -**Scikit-Learn** has several functions which allow us to rescale the -data, normally resulting in much better results in terms of various -accuracy scores. The **StandardScaler** function in **Scikit-Learn** -ensures that for each feature/predictor we study the mean value is -zero and the variance is one (every column in the design/feature -matrix). This scaling has the drawback that it does not ensure that -we have a particular maximum or minimum in our data set. Another -function included in **Scikit-Learn** is the **MinMaxScaler** which -ensures that all features are exactly between $0$ and $1$. The - - -The **Normalizer** scales each data -point such that the feature vector has a euclidean length of one. In other words, it -projects a data point on the circle (or sphere in the case of higher dimensions) with a -radius of 1. This means every data point is scaled by a different number (by the -inverse of it’s length). -This normalization is often used when only the direction (or angle) of the data matters, -not the length of the feature vector. - -The **RobustScaler** works similarly to the StandardScaler in that it -ensures statistical properties for each feature that guarantee that -they are on the same scale. However, the RobustScaler uses the median -and quartiles, instead of mean and variance. This makes the -RobustScaler ignore data points that are very different from the rest -(like measurement errors). These odd data points are also called -outliers, and might often lead to trouble for other scaling -techniques. - - -Many features are often scaled using standardization to improve -performance. In **Scikit-Learn** this is given by the **StandardScaler** -function as discussed above. It is easy however to write your own. -Mathematically, this involves subtracting the mean and divide by the -standard deviation over the data set, for each feature: - -$$ -x_j^{(i)} \rightarrow \frac{x_j^{(i)} - \overline{x}_j}{\sigma(x_j)}, -$$ - -where $\overline{x}_j$ and $\sigma(x_j)$ are the mean and standard -deviation, respectively, of the feature $x_j$. This ensures that each -feature has zero mean and unit standard deviation. For data sets -where we do not have the standard deviation or don't wish to calculate -it, it is then common to simply set it to one. - - - -Let us consider the following vanilla example where we use both -**Scikit-Learn** and write our own function as well. We produce a -simple test design matrix with random numbers. Each column could then -represent a specific feature whose mean value is subracted. - -import sklearn.linear_model as skl -from sklearn.metrics import mean_squared_error -from sklearn.model_selection import train_test_split -from sklearn.preprocessing import MinMaxScaler, StandardScaler, Normalizer -import numpy as np -import pandas as pd -from IPython.display import display -np.random.seed(100) -# setting up a 10 x 5 matrix -rows = 10 -cols = 5 -X = np.random.randn(rows,cols) -XPandas = pd.DataFrame(X) -display(XPandas) -print(XPandas.mean()) -print(XPandas.std()) -XPandas = (XPandas -XPandas.mean()) -display(XPandas) -# This option does not include the standard deviation -scaler = StandardScaler(with_std=False) -scaler.fit(X) -Xscaled = scaler.transform(X) -display(XPandas-Xscaled) - -Small exercise: perform the standard scaling by including the standard deviation and compare with what Scikit-Learn gives. - - - -Another commonly used scaling method is min-max scaling. This is very -useful for when we want the features to lie in a certain interval. To -scale the feature $x_j$ to the interval $[a, b]$, we can apply the -transformation - -$$ -x_j^{(i)} \rightarrow (b-a)\frac{x_j^{(i)} - \min(x_j)}{\max(x_j) - \min(x_j)} - a -$$ - -where $\min(x_j)$ and $\max(x_j)$ return the minimum and maximum value of $x_j$ over the data set, respectively. - - - - -## Testing the Means Squared Error as function of Complexity - - -Before we proceed with a more detailed analysis of the so-called -Bias-Variance tradeoff, we present here an example of the relation -between model complexity and the mean squared error for the triaining -data and the test data. - -The results here tell us clearly that for the data not included in the -training, there is an optimal model as function of the complexity of -ourmodel (here in terms of the polynomial degree of the model). - -The results here will vary as function of model complexity and the amount od data used for training. - - -Our data is defined by $x\in [-3,3]$ with a total of for example $100$ data points. - -import matplotlib.pyplot as plt -import numpy as np -from sklearn.linear_model import LinearRegression, Ridge, Lasso -from sklearn.preprocessing import PolynomialFeatures -from sklearn.model_selection import train_test_split -from sklearn.pipeline import make_pipeline - - -np.random.seed(2018) -n = 100 -maxdegree = 14 -# Make data set. -x = np.linspace(-3, 3, n).reshape(-1, 1) -y = np.exp(-x**2) + 1.5 * np.exp(-(x-2)**2)+ np.random.normal(0, 0.1, x.shape) -TestError = np.zeros(maxdegree) -TrainError = np.zeros(maxdegree) -polydegree = np.zeros(maxdegree) -x_train, x_test, y_train, y_test = train_test_split(x, y, test_size=0.2) - - -for degree in range(maxdegree): - model = make_pipeline(PolynomialFeatures(degree=degree), LinearRegression(fit_intercept=False)) - clf = model.fit(x_train,y_train) - y_fit = clf.predict(x_train) - y_pred = clf.predict(x_test) - polydegree[degree] = degree - TestError[degree] = np.mean( np.mean((y_test - y_pred)**2) ) - TrainError[degree] = np.mean( np.mean((y_train - y_fit)**2) ) - -plt.plot(polydegree, TestError, label='Test Error') -plt.plot(polydegree, TrainError, label='Train Error') -plt.legend() -plt.show() - -## Exercises - -### Exercise: Setting up various Python environments - -The first exercise here is of a mere technical art. We want you to have -* git as a version control software and to establish a user account on a provider like GitHub. Other providers like GitLab etc are equally fine. You can also use the University of Oslo [GitHub facilities](https://www.uio.no/tjenester/it/maskin/filer/versjonskontroll/github.html). - -* Install various Python packages - -We will make extensive use of Python as programming language and its -myriad of available libraries. You will find -IPython/Jupyter notebooks invaluable in your work. You can run **R** -codes in the Jupyter/IPython notebooks, with the immediate benefit of -visualizing your data. You can also use compiled languages like C++, -Rust, Fortran etc if you prefer. The focus in these lectures will be -on Python. - -If you have Python installed (we recommend Python3) and you feel -pretty familiar with installing different packages, we recommend that -you install the following Python packages via **pip** as - -1. pip install numpy scipy matplotlib ipython scikit-learn sympy pandas pillow - -For **Tensorflow**, we recommend following the instructions in the text of -[Aurelien Geron, Hands‑On Machine Learning with Scikit‑Learn and TensorFlow, O'Reilly](http://shop.oreilly.com/product/0636920052289.do) - -We will come back to **tensorflow** later. - -For Python3, replace **pip** with **pip3**. - -For OSX users we recommend, after having installed Xcode, to -install **brew**. Brew allows for a seamless installation of additional -software via for example - -1. brew install python3 - -For Linux users, with its variety of distributions like for example the widely popular Ubuntu distribution, -you can use **pip** as well and simply install Python as - -1. sudo apt-get install python3 (or python for Python2.7) - -If you don't want to perform these operations separately and venture -into the hassle of exploring how to set up dependencies and paths, we -recommend two widely used distrubutions which set up all relevant -dependencies for Python, namely - -* [Anaconda](https://docs.anaconda.com/), - -which is an open source -distribution of the Python and R programming languages for large-scale -data processing, predictive analytics, and scientific computing, that -aims to simplify package management and deployment. Package versions -are managed by the package management system **conda**. - -* [Enthought canopy](https://www.enthought.com/product/canopy/) - -is a Python -distribution for scientific and analytic computing distribution and -analysis environment, available for free and under a commercial -license. - -We recommend using **Anaconda** if you are not too familiar with setting paths in a terminal environment. - - - - -### Exercise: making your own data and exploring scikit-learn - -We will generate our own dataset for a function $y(x)$ where $x \in [0,1]$ and defined by random numbers computed with the uniform distribution. The function $y$ is a quadratic polynomial in $x$ with added stochastic noise according to the normal distribution $\cal {N}(0,1)$. -The following simple Python instructions define our $x$ and $y$ values (with 100 data points). - -x = np.random.rand(100,1) -y = 2.0+5*x*x+0.1*np.random.randn(100,1) - -1. Write your own code (following the examples under the [regression notes](https://compphysics.github.io/MachineLearning/doc/LectureNotes/_build/html/chapter1.html)) for computing the parametrization of the data set fitting a second-order polynomial. - -2. Use thereafter **scikit-learn** (see again the examples in the regression slides) and compare with your own code. - -3. Using scikit-learn, compute also the mean square error, a risk metric corresponding to the expected value of the squared (quadratic) error defined as - -$$ -MSE(\boldsymbol{y},\boldsymbol{\tilde{y}}) = \frac{1}{n} -\sum_{i=0}^{n-1}(y_i-\tilde{y}_i)^2, -$$ - -and the $R^2$ score function. -If $\tilde{\boldsymbol{y}}_i$ is the predicted value of the $i-th$ sample and $y_i$ is the corresponding true value, then the score $R^2$ is defined as - -$$ -R^2(\boldsymbol{y}, \tilde{\boldsymbol{y}}) = 1 - \frac{\sum_{i=0}^{n - 1} (y_i - \tilde{y}_i)^2}{\sum_{i=0}^{n - 1} (y_i - \bar{y})^2}, -$$ - -where we have defined the mean value of $\boldsymbol{y}$ as - -$$ -\bar{y} = \frac{1}{n} \sum_{i=0}^{n - 1} y_i. -$$ - -You can use the functionality included in scikit-learn. If you feel for it, you can use your own program and define functions which compute the above two functions. -Discuss the meaning of these results. Try also to vary the coefficient in front of the added stochastic noise term and discuss the quality of the fits. - - - - -### Exercise: Normalizing our data - -A much used approach before starting to train the data is to preprocess our -data. Normally the data may need a rescaling and/or may be sensitive -to extreme values. Scaling the data renders our inputs much more -suitable for the algorithms we want to employ. - -**Scikit-Learn** has several functions which allow us to rescale the -data, normally resulting in much better results in terms of various -accuracy scores. The **StandardScaler** function in **Scikit-Learn** -ensures that for each feature/predictor we study the mean value is -zero and the variance is one (every column in the design/feature -matrix). This scaling has the drawback that it does not ensure that -we have a particular maximum or minimum in our data set. Another -function included in **Scikit-Learn** is the **MinMaxScaler** which -ensures that all features are exactly between $0$ and $1$. The - - -The **Normalizer** scales each data -point such that the feature vector has a euclidean length of one. In other words, it -projects a data point on the circle (or sphere in the case of higher dimensions) with a -radius of 1. This means every data point is scaled by a different number (by the -inverse of it’s length). -This normalization is often used when only the direction (or angle) of the data matters, -not the length of the feature vector. - -The **RobustScaler** works similarly to the StandardScaler in that it -ensures statistical properties for each feature that guarantee that -they are on the same scale. However, the RobustScaler uses the median -and quartiles, instead of mean and variance. This makes the -RobustScaler ignore data points that are very different from the rest -(like measurement errors). These odd data points are also called -outliers, and might often lead to trouble for other scaling -techniques. - - -It also common to split the data in a **training** set and a **testing** set. A typical split is to use $80\%$ of the data for training and the rest -for testing. This can be done as follows with our design matrix $\boldsymbol{X}$ and data $\boldsymbol{y}$ (remember to import **scikit-learn**) - -# split in training and test data -# X_train, X_test, y_train, y_test = train_test_split(X,y,test_size=0.2) - -Then we can use the standard scaler to scale our data as - -scaler = StandardScaler() -scaler.fit(X_train) -X_train_scaled = scaler.transform(X_train) -X_test_scaled = scaler.transform(X_test) - -In this exercise we want you to to compute the MSE for the training -data and the test data as function of the complexity of a polynomial, -that is the degree of a given polynomial. We want you also to compute the $R2$ score as function of the complexity of the model for both training data and test data. You should also run the calculation with and without scaling. - -One of -the aims is to reproduce Figure 2.11 of [Hastie et al](https://github.com/CompPhysics/MLErasmus/blob/master/doc/Textbooks/elementsstat.pdf). - - - -Our data is defined by $x\in [-3,3]$ with a total of for example $100$ data points. - -np.random.seed() -n = 100 -maxdegree = 14 -# Make data set. -x = np.linspace(-3, 3, n).reshape(-1, 1) -y = np.exp(-x**2) + 1.5 * np.exp(-(x-2)**2)+ np.random.normal(0, 0.1, x.shape) - -where $y$ is the function we want to fit with a given polynomial. - - -Write a first code which sets up a design matrix $X$ defined by a -fifth-order polynomial. Scale your data and split it in training and -test data. - - - -Perform an ordinary least squares and compute the means squared error -and the $R2$ factor for the training data and the test data, with and -without scaling. - - - -Add now a model which allows you to make polynomials up to degree -$15$. Perform a standard OLS fitting of the training data and compute -the MSE and $R2$ for the training and test data and plot both test and -training data MSE and $R2$ as functions of the polynomial -degree. Compare what you see with Figure 2.11 of Hastie et al. Comment -your results. For which polynomial degree do you find an optimal MSE -(smallest value)? \ No newline at end of file diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter10.ipynb b/doc/LectureNotes/_build/jupyter_execute/chapter10.ipynb deleted file mode 100644 index 85d81c6c5..000000000 --- a/doc/LectureNotes/_build/jupyter_execute/chapter10.ipynb +++ /dev/null @@ -1,3327 +0,0 @@ -{ - "cells": [ - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "# Building a Feed Forward Neural Network\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", - "\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", - "\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", - "\n", - "### The Softmax function\n", - "\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", - "\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": { - "collapsed": false, - "editable": true - }, - "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": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter10_33_1.png" - }, - "needs_background": "light" - }, - "output_type": "display_data" - } - ], - "source": [ - "%matplotlib inline\n", - "\n", - "# 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": 2, - "metadata": { - "collapsed": false, - "editable": true - }, - "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", - "### 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", - "\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": 3, - "metadata": { - "collapsed": false, - "editable": true - }, - "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", - "\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": 4, - "metadata": { - "collapsed": false, - "editable": true - }, - "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", - "[5.41511965e-04 2.17174962e-03 8.84355903e-03 1.44970586e-03\n", - " 1.10378326e-04 5.08318298e-09 2.03256632e-04 1.92507116e-03\n", - " 9.84443254e-01 3.11507992e-04]\n", - "probabilities sum up to: 1.0\n", - "\n", - "predictions = (n_inputs) = (1437,)\n", - "prediction for image 0: 8\n", - "correct label for image 0: 6\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", - "\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", - "\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": 5, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Old accuracy on training data: 0.1440501043841336\n" - ] - }, - { - "name": "stderr", - "output_type": "stream", - "text": [ - ":4: RuntimeWarning: overflow encountered in exp\n", - " return 1/(1 + np.exp(-x))\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "New accuracy on training data: 0.1022964509394572\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", - "\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": 6, - "metadata": { - "collapsed": false, - "editable": true - }, - "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": 7, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Accuracy score on test set: 0.9361111111111111\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": 8, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 1e-05\n", - "Lambda = 1e-05\n", - "Accuracy score on test set: 0.11666666666666667\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 1e-05\n", - "Lambda = 0.0001\n", - "Accuracy score on test set: 0.20833333333333334\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 1e-05\n", - "Lambda = 0.001\n", - "Accuracy score on test set: 0.12222222222222222\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 1e-05\n", - "Lambda = 0.01\n", - "Accuracy score on test set: 0.14722222222222223\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 1e-05\n", - "Lambda = 0.1\n", - "Accuracy score on test set: 0.17777777777777778\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 1e-05\n", - "Lambda = 1.0\n", - "Accuracy score on test set: 0.16111111111111112\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 1e-05\n", - "Lambda = 10.0\n", - "Accuracy score on test set: 0.20277777777777778\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 0.0001\n", - "Lambda = 1e-05\n", - "Accuracy score on test set: 0.5305555555555556\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 0.0001\n", - "Lambda = 0.0001\n", - "Accuracy score on test set: 0.5944444444444444\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 0.0001\n", - "Lambda = 0.001\n", - "Accuracy score on test set: 0.5888888888888889\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 0.0001\n", - "Lambda = 0.01\n", - "Accuracy score on test set: 0.6111111111111112\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 0.0001\n", - "Lambda = 0.1\n", - "Accuracy score on test set: 0.5222222222222223\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 0.0001\n", - "Lambda = 1.0\n", - "Accuracy score on test set: 0.5555555555555556\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 0.0001\n", - "Lambda = 10.0\n", - "Accuracy score on test set: 0.8055555555555556\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 0.001\n", - "Lambda = 1e-05\n", - "Accuracy score on test set: 0.85\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 0.001\n", - "Lambda = 0.0001\n", - "Accuracy score on test set: 0.85\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 0.001\n", - "Lambda = 0.001\n", - "Accuracy score on test set: 0.875\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 0.001\n", - "Lambda = 0.01\n", - "Accuracy score on test set: 0.8666666666666667\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 0.001\n", - "Lambda = 0.1\n", - "Accuracy score on test set: 0.8638888888888889\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 0.001\n", - "Lambda = 1.0\n", - "Accuracy score on test set: 0.9555555555555556\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 0.001\n", - "Lambda = 10.0\n", - "Accuracy score on test set: 0.925\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 0.01\n", - "Lambda = 1e-05\n", - "Accuracy score on test set: 0.9583333333333334\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 0.01\n", - "Lambda = 0.0001\n", - "Accuracy score on test set: 0.9277777777777778\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 0.01\n", - "Lambda = 0.001\n", - "Accuracy score on test set: 0.9388888888888889\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 0.01\n", - "Lambda = 0.01\n", - "Accuracy score on test set: 0.9166666666666666\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 0.01\n", - "Lambda = 0.1\n", - "Accuracy score on test set: 0.9611111111111111\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 0.01\n", - "Lambda = 1.0\n", - "Accuracy score on test set: 0.8777777777777778\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 0.01\n", - "Lambda = 10.0\n", - "Accuracy score on test set: 0.11388888888888889\n", - "\n" - ] - }, - { - "name": "stderr", - "output_type": "stream", - "text": [ - ":4: RuntimeWarning: overflow encountered in exp\n", - " return 1/(1 + np.exp(-x))\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 0.1\n", - "Lambda = 1e-05\n", - "Accuracy score on test set: 0.09166666666666666\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 0.1\n", - "Lambda = 0.0001\n", - "Accuracy score on test set: 0.10555555555555556\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 0.1\n", - "Lambda = 0.001\n", - "Accuracy score on test set: 0.08888888888888889\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 0.1\n", - "Lambda = 0.01\n", - "Accuracy score on test set: 0.10555555555555556\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 0.1\n", - "Lambda = 0.1\n", - "Accuracy score on test set: 0.11666666666666667\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 0.1\n", - "Lambda = 1.0\n", - "Accuracy score on test set: 0.12777777777777777\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 0.1\n", - "Lambda = 10.0\n", - "Accuracy score on test set: 0.09166666666666666\n", - "\n" - ] - }, - { - "name": "stderr", - "output_type": "stream", - "text": [ - ":43: RuntimeWarning: overflow encountered in exp\n", - " exp_term = np.exp(self.z_o)\n", - ":44: RuntimeWarning: invalid value encountered in true_divide\n", - " self.probabilities = exp_term / np.sum(exp_term, axis=1, keepdims=True)\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 1.0\n", - "Lambda = 1e-05\n", - "Accuracy score on test set: 0.07777777777777778\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 1.0\n", - "Lambda = 0.0001\n", - "Accuracy score on test set: 0.07777777777777778\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 1.0\n", - "Lambda = 0.001\n", - "Accuracy score on test set: 0.07777777777777778\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 1.0\n", - "Lambda = 0.01\n", - "Accuracy score on test set: 0.07777777777777778\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 1.0\n", - "Lambda = 0.1\n", - "Accuracy score on test set: 0.07777777777777778\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 1.0\n", - "Lambda = 1.0\n", - "Accuracy score on test set: 0.08888888888888889\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 1.0\n", - "Lambda = 10.0\n", - "Accuracy score on test set: 0.07777777777777778\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 10.0\n", - "Lambda = 1e-05\n", - "Accuracy score on test set: 0.07777777777777778\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 10.0\n", - "Lambda = 0.0001\n", - "Accuracy score on test set: 0.07777777777777778\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 10.0\n", - "Lambda = 0.001\n", - "Accuracy score on test set: 0.07777777777777778\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 10.0\n", - "Lambda = 0.01\n", - "Accuracy score on test set: 0.07777777777777778\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 10.0\n", - "Lambda = 0.1\n", - "Accuracy score on test set: 0.07777777777777778\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 10.0\n", - "Lambda = 1.0\n", - "Accuracy score on test set: 0.07777777777777778\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 10.0\n", - "Lambda = 10.0\n", - "Accuracy score on test set: 0.07777777777777778\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": 9, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stderr", - "output_type": "stream", - "text": [ - ":4: RuntimeWarning: overflow encountered in exp\n", - " return 1/(1 + np.exp(-x))\n" - ] - }, - { - "data": { - "image/png": "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0hAdobsUEhKiyMhI53J4eLgph4nMas+ePfrPf/6j119/XW3atHF3OC517Ngx/fnnn5IkPz8/NWzYUIcPH3ZzVK6zevVq7dixQ61atdJnn32mTZs2afTo0e4Oy2V2796t0NBQ57LD4TDVXKHcuXOrevXqypkzp3x9fVWvXj1TjQaYAR2hu1SjRg2FhobqwoULunbtmtatW6datWq5Oyy4QFhYmPr06aMJEyaoWbNm7g7H5U6dOqWhQ4cqPj5e8fHx2rhxoypVquTusFzmm2++0apVq7R8+XL1799fdevW1TvvvOPusFzmypUrGj9+vOLi4nT16lUtXbrUNCcKSFKdOnW0fft2RUVFyWazadu2bXriiSfcHRbSkHm69Q8oJCREAwcOVOfOnZWQkKB27dqpbNmy7g4LLjBjxgzFxcVp7NixznUdOnTQCy+84MaoXKd27drat2+fWrduLavVqoYNG5qyQ2hWderUcba/3W5Xx44dVaFCBXeH5TLlypVTjx491LFjRyUkJOipp55S27Zt3R0W0pDFkdLkFwAAABNgaAwAAJgWHSEAAGBadIQAAIBp0RECAACmRUcIAACYFh0hAABgWnSEAACAadERAnBXmjRpolq1auno0aPuDgUA0gwdIQB3ZdWqVXr00Ue1du1ad4cCAGmGjhCAu2K1WlWpUiVT3XAVQObHvcYA3JXY2Fj98MMP4q48ADITKkIA7srEiRMVEhKikydPKjo62t3hAECaoCMEIFW//vqr1qxZo8mTJysgIEBHjhxxd0gAkCboCAG4o7i4OL399tv64IMPlD17dpUsWZJ5QgAyDTpCAO5o0qRJqlChgp555hlJUsmSJXXo0CH3BgUAaYSOEIDb2r9/v9asWaN33nnHua5UqVJUhABkGhYHp4AAAACToiIEAABMi44QAAAwLTpCAADAtOgIAQAA06IjBAAATIuOEAAAMC06QgAAwLToCAEAANP6fw1MSQlo1cSsAAAAAElFTkSuQmCC\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter10_49_1.png" - } - }, - "output_type": "display_data" - }, - { - "data": { - "image/png": "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oB9dFREREXEDqgiJiIiIgcWm7xESERERyfFUERIREREDfY+QiIiIiBtQRUhEREQMrPoeIREREZGcTxUhERERMdAcIRERERE3oERIRERE3JaGxkRERMRAX6goIiIi4gayZUXo0HsVXN0F18mf5OoeuJattKt74FIe3hZXd8FlrOf8XN0Fl7L6WV3dBZd6pcEWV3fBrehHV0VERETcQLasCImIiEjmsegLFUVERERyPlWERERExMCKrhoTERERyfFUERIREREDzRESERERcQOqCImIiIiBfnRVRERExA2oIiQiIiIGVv3WmIiIiEjOp4qQiIiIGGiOkIiIiIgbUCIkIiIibktDYyIiImJg1RcqioiIiOR8qgiJiIiIgUU/uioiIiKStYSFhdGmTRtatGjB4sWLU92/f/9+unbtSocOHXjppZeIjY294zaVCImIiIiB1WZ22i29zp8/T2hoKEuWLGH16tV89dVXHD161NDmgw8+YNCgQaxZs4bSpUszb968O25XiZCIiIhkeTt37qRu3brky5cPf39/WrVqxfr16w1trFYrV69eBSAhIQFfX987bldzhERERMTAmXOEYmNj0xzCCggIICAgwLEcGRlJYGCgYzkoKIi9e/caHjN8+HD69OnDuHHj8PPzY9myZXfcvxIhERERcZmFCxcyY8aMVOsHDBjAwIEDHcs2my1VG5PpRsKWmJjIO++8w8KFC6lcuTILFixg2LBhzJ49+1/3r0RIREREDJz5PUK9e/emc+fOqdbfXA0CCA4OZteuXY7lyMhIgoKCHMuHDx/Gx8eHypUrA/DUU08xbdq0O+5fc4RERETEZQICAihevHiq262JUP369QkPDycmJoaEhAQ2btxIo0aNHPc/8MADnDt3jmPHjgGwefNmKlWqdMf9qyIkIiIiBpYs+M3SwcHBhISE0KtXL5KTk+nWrRuVK1emX79+DBo0iEqVKvHhhx8yePBgbDYbBQsWZNy4cXfcrhIhERERyRbat29P+/btDevmzJnj+Ltx48Y0btz4rrapREhEREQMrPpmaREREZGcTxUhERERMciKc4Qyi/tEKiIiInILVYRERETEwGrTHCERERGRHE+JkIiIiLgtDY2JiIiIgcWN6iRKhK5r+kBp3qzXEG8PDw5eiGLY5o1cSU4ytHmnQWNaly3P5cREAI5dusjADd/gZTYz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8zjtrFqvXr1U64oUKXLXSZCIiIhkLn2hooiIiIgbcN86u4iIiKQpC1zQ7TSqCImIiIjbUkVIREREDLLCFx06iypCIiIi4rZUERIREREDVYRERERE3IAqQiIiImLgRheNqSIkIiIi7ksVIRERETHQHCERERERN6CKkIiIiBi50SQhVYRERETEbSkREhEREbeloTEREREx0GRpERERETegipCIiIgY2DRZWkRERCTnU0VIREREDDRHSERERCSLCQsLo02bNrRo0YLFixenuv/YsWM8++yzdOjQgeeff57Lly/fcZtKhERERMTIZnLeLZ3Onz9PaGgoS5YsYfXq1Xz11VccPXr0RpdtNl5++WX69evHmjVrqFixIrNnz77jdpUIiYiISJa3c+dO6tatS758+fD396dVq1asX7/ecf/+/fvx9/enUaNGAPTv35+ePXvecbuaIyQiIiIGzrxqLDY2ltjY2FTrAwICCAgIcCxHRkYSGBjoWA4KCmLv3r2O5X/++YdChQoxbNgwDhw4QPny5Rk5cuQd96+KkIiIiLjMwoULad68earbwoULDe1saWRnJtONobWUlBR++eUXnnnmGcLCwihRogTjx4+/4/5VERIREREjJ1aEevfuTefOnVOtv7kaBBAcHMyuXbscy5GRkQQFBTmWAwMDeeCBB6hUqRIA7dq1Y9CgQXfcvypCIiIi4jIBAQEUL1481e3WRKh+/fqEh4cTExNDQkICGzdudMwHAqhWrRoxMTEcPHgQgC1btvDII4/ccf+qCImIiIhBVvweoeDgYEJCQujVqxfJycl069aNypUr069fPwYNGkSlSpX4+OOPGTFiBAkJCRQuXJiJEyfecbsmW1qDblnc8r9ruLoL4iJBHnGu7oJLJdrc97OLxc0L2C39El3dBZeKtMS7ugsuVbRYhFP3V3rxh07b1/GebzltX2lx37OqiIiIpC3blUjunXt/xBIRERG3pkRIRERE3JaGxkRERMQgK06WziyqCImIiIjbypYVoa653PfKoUjLFVd3waV8TR6u7oJLXbKmuLoLLlPSM4+ru+BSOxLd+3Prh9XauLoLLrX+opN3qMnSIiIiIjlftqwIiYiISGbSHCERERGRHE8VIRERETHSHCERERGRnE8VIRERETFSRUhEREQk51NFSERERIz0zdIiIiIiOZ8qQiIiImJg0xwh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iIgYOPPy+VuHwG4nODiYXbt2OZYjIyMJCgpyLEdERLBz5066dbP/6q/NZsMzHb/3oqExERERyfLq169PeHg4MTExJCQksHHjRho1uvHTK76+vkyaNIlTp05hs9lYvHix4VcxbkcVIRERETGyme7cxsmCg4MJCQmhV69eJCcn061bNypXrky/fv0YNGgQlSpV4r333uPll18mOTmZ6tWr06dPnztuV4mQiIiIZAvt27enffv2hnU3zwtq1aoVrVq1uqttKhESERERI/3EhoiIiEjOp4qQiIiIGOhHV0VERETcgCpCIiIiYqSKkIiIiEjOp4qQiIiIGGiOkIiIiIgbUEVIREREjFQREhEREcn5lAiJiIiI29LQmIiIiBhpaExEREQk51NFSERERAx0+byIiIiIG1AiJCIiIm5LiZCIiIi4Lc0REhERESPNERIRERHJ+VQREhEREQNdNSYiIiLiBrJlRah1qVqu7oLLmLy9Xd0Fl7ImXnN1F1zK7Ovj6i64jme2PF1lGJOXe8dvS4h1dRfciypCIiIiIjmfe3/EEBERkdRUERIRERHJ+VQREhEREQNdNSYiIiLiBpQIiYiIiNvS0JiIiIgYaWhMREREJOdTRUhEREQMNFlaRERExA2oIiQiIiJGqgiJiIiI5HyqCImIiIiRKkIiIiIiOZ8qQiIiImKgq8ZERERE3IAqQiIiImKkipCIiIhIzqeKkIiIiBipIiQiIiKS86kiJCIiIga6akxERETEDSgREhEREbeloTEREREx0tCYiIiISM6nipCIiIgYaLK0iIiIiBtQRUhERESMVBESERERyflUERIREREjVYREREREcj4lQiIiImJgcuLtboSFhdGmTRtatGjB4sWLb9tu27ZtNGvWLF3b1NCYiIiIZHnnz58nNDSUlStX4u3tTffu3alTpw5ly5Y1tIuOjmbChAnp3q4qQiIiImJkc94tNjaW06dPp7rFxsYaurRz507q1q1Lvnz58Pf3p1WrVqxfvz5V10eMGMGAAQPSHapbV4RqP1GVPmOfwsvHk+P7ThHafw7xcQnpapMnfy4G/rcvZaqUJPHqNTZ+/j1rZm4EoHyNMvSf/Cy+/j6YPcws+yiMLUt/dEWId6V2q8r0Gd3NHuufpwkdMJ/4uMQ0274+83lOHDjDiuk3noS58vox+du3mPLqfI78dsJJvb53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IiIi4r5UERIREREDfY+QiIiIiBtQRUhERESMVBESERERyflUERIREREDzRESERERcQOqCImIiIiRKkIiIiIiOZ8SIREREXFbGhoTERERA02WFhEREXED2bIiZE1KcnUXXMedYxcsV5Jd3QVxEZOnl6u74FK2FD33nUoVIREREZGcL1tWhERERCTzaI6QiIiIiBtQRUhERESMbO5TElJFSERERNyWKkIiIiJioDlCIiIiIm5AFSERERExUkVIREREJOdTRUhEREQMTFZX98B5VBESERERt6WKkIiIiBhpjpCIiIhIzqdESERERNyWhsZERETEQF+oKCIiIpLFhIWF0aZNG1q0aMHixYtT3b9p0ybat29P27ZtGT58OElJSXfcphIhERERMbLZnHdLp/PnzxMaGsqSJUtYvXo1X331FUePHnXcHx8fz3vvvceCBQtYu3Yt165dY9WqVXfcrhIhERERyfJ27txJ3bp1yZcvH/7+/rRq1Yr169c77vf392fLli0UKlSI+Ph4Lly4QEBAwB23qzlCIiIiYuDMOUKxsbHExsamWh8QEGBIZCIjIwkMDHQsBwUFsXfvXsNjvLy82L59O2+++SZBQUE89thjd9y/KkIiIiLiMgsXLqR58+apbgsXLjS0s6UxjGYymVKta9y4MT///DNNmzZlzJgxd9y/KkIiIiJi5MSKUO/evencuXOq9bcOawUHB7Nr1y7HcmRkJEFBQY7lS5cu8eeffzqqQO3btyckJOSO+1dFSERERFwmICCA4sWLp7rdmgjVr1+f8PBwYmJiSEhIYOPGjTRq1Mhxv81mY+jQoURERADw7bffUr169TvuXxUhERERMciK3yMUHBxMSEgIvXr1Ijk5mW7dulG5cmX69evHoEGDqFSpEmPHjuWll17CZDJRtmxZ3n333Ttu12RLa9Ati2thftLVXRARcSqTp5eru+BStpRkV3fBpTZZlzt1fw07T3bavnasesNp+0qLKkIiIiJilP1qJPdMc4RERETEbakiJCIiIgZZcY5QZlFFSERERNyWKkIiIiJipIqQiIiISM6nREhERETclobGRERExECTpUVERETcgCpCIiIiYmR1n5KQWydCtdtU5/lxPfDy8eL43pN89MJM4uMS0tVm5LLXKVa2sKNd4dJB7N1+gFGdJlCyYnFCZr2EX25fbDYb895azK6Nfzg7vDtS/O4bvzvHDoq/duuq9H2/O14+nhzfd4opL85OHf9t2pjNJl6d1ofKjSoA8Mu3vzNn+BIAqjR+mBcn9sTD04PYC3F8+sYiju39x+nx3Ym7H38xctvfGstbKIA5f04h5LERnDl6jhfG98Qvjx/TX517V20Aytd8kFHLXyek4UiiTl9g8pYxbFq0nQ0LtvJg1VJ8tPVduhTqg9Vive9+ZxTF777xu3PskH3jz6jfGstbKA9zfp/I4CbvEnH0HM+P645/bj+mD1qQrjYtnm1Ei2caMrz1OExmM1O/H8Oyj75h96a9LDryX8Z2n8rvW/dT4qGijFkxhP7Vh5OclHLf/c6o3xrLrsff2b811rjNRKfta/u6N522r7Q4ZY7Q3r17HX+Hh4czfvx4Jk+ezB9/uC5TrtGyMod//ZszR88BEDZzI817NLzrNp5enrz52QBmhnxG1OkLAJg9zOTJnwsA/zx+JCUmZXY4d03xu2/87hw7KP4aLSpzaNcxIq7H9s2s72j2dIN0t/HwMOObywcvHy+8fDzx9PYkOTGZYmULc/VyPL9v3Q/AqUMRxMcmULFuOSdGd2fufvwlNacMjY0ePZpVq1axePFivvzyS7p27QrAqFGjePLJJ3nmmWec0Q2DwBKFiDod7ViOOn2BXHn98c/j5yiRpqfNE88340JEDD9+/Yuj3fQBc5m0eTRdBrcjX1Bexj0dmqU+EYPid+f43Tl2UPyBxQs43rgBok7HpI7/X9ps/Hw7DbvWYcmJj/HwNLP7u338tHYP/nn88MvtS43HK7H7u32Ur1GGBx4uToEi+Zwd4r9y9+OfXu501ZhT5wgtW7aMzz//nPz58wPQrVs3unXr5pJEyGw2pbn+5idtetp0HdyW0JdmOZa9fLwY8WUIk/p8zM9r91CxTjneWzOcQ7/+bTixuJrid9/43Tl2UPwmc9oDATfH9m9tnhnZlcvRsTxVvD/eft6M+d8Qug5uw4qp6xjd9SP6vPcfXhjfg307DvL71v2kZMCwWEZy9+MvqTllaCwlJQWr1UrBggXx9/d3rPf29sZ8mxdcZov8J5oChfM7lgsVK0BszBUS46+lu82DVUvh4enB3u0HHG1KP1oCH38ffl67B4C/fj7Cyf2nqFAna5WHFb/7xu/OsYPijzoVbajSpBX/v7V5rFMtNny2nZRkC/GxCWxatIMqjR/GZDKReDWRoS3e5+Wab/FJyEKKPhhMxN/nnRjdnbn78U83m815NxdzShaSP39+GjduzNGjRxk9ejRgnyvUvXt3nnjiCWd0IZXdG/+gYt1yjtn/7fq3JHz1r3fVpnLjh/l965+Gx5w5eo5cef15uF55AIqUCaZkxWIc/e14ZoZz1xS/+8bvzrGD4t+9aR8Va5ej6P/H9mJzwsN2p7vNkd9O0KhbXQA8PD2o1746B385is1m4/3Vb1KuemkAGnatQ0qyJctdNebux19Sc+pVY8eOHSM2NpaqVauye/du4uLiaNKkyV1vJyOuGgOo3boafcf1wMvbk4i/zzOx9wyKlAliyJyX6V996G3bxF28AsDAGc9z4exFlnyw0rDdKk0eod+EZ/D29SYlOYUvxv6Pnbe80LICxe++8btz7JA948+oq8YAaj1Rlb7vP+WIbVLfmRQuHcSQWf14udbbt20Td/EqeQrk5tWpvSlXrTQWi5Xft/zJrDcXY0mxUKlhBV7+qBee3p7EnL3E1Ffmcu54ZIb0OaOuGoPsefydfdVY01YTnLavrRuGOW1faXHby+dFRLKTjEyEsqOMTISyIyVCmcetv1BRRERE0pDtSiT3Tr81JiIiIm5LFSERERExMGW/WTP3TBUhERERcVtKhERERMRtaWhMREREjLLnL4PcE1WERERExG2pIiQiIiIGmiwtIiIi4gZUERIREREj9ykIqSIkIiIi7ksVIRERETHSHCERERGRnE8VIRERETEwuU9BSBUhERERcV+qCImIiIiR5giJiIiI5HyqCImIiIiBSb81JiIiIpLzqSIkIiIiRpojJCIiIpLzqSIkIiIiRu5TEFJFSERERNyXEiERERFxWxoaExEREQOTJkuLiIiI5HyqCImIiIiRKkIiIiIiOZ8qQiIiImKkn9gQERERyflUERIREREDXTUmIiIi4gZUERIREREjVYREREREcj5VhEREsgFbSrKruyDuJItWhMLCwpg5cybJyck899xz9OzZ03D/d999x/Tp07HZbBQvXpwPP/yQvHnz/us2VRESERGRLO/8+fOEhoayZMkSVq9ezVdffcXRo0cd91+5coUxY8Ywe/Zs1qxZw0MPPcT06dPvuF0lQiIiImJkdd4tNjaW06dPp7rFxsYaurRz507q1q1Lvnz58Pf3p1WrVqxfv95xf3JyMmPG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M5PJdN/7VyIkIiIiRk780dXevXvTuXPnVOtvrgYBBAcHs2vXLsdyZGQkQUFB971/JUIiIiLiMrcOgd1O/fr1mT59OjExMfj5+bFx40bGjh173/vXZGkRERExslmdd0un4OBgQkJC6NWrF506daJdu3ZUrlyZfv36sW/fvnsO1WRLa9Ati2thftLVXRAREXGaTdblTt1fK9+eTtvXhsTbfx+QM2hoTERERAxsTpwj5GoaGhMRERG3pYqQiIiIGN3F3J3sThUhERERcVtKhERERMRtaWhMREREDDRZWkRERMQNqCIkIiIiRm40WTpbfqGiiIiISEbQ0JiIiIi4LSVCIiIi4raUCImIiIjbUiIkIiIibkuJkIiIiLgtJUIiIiLitpQIiYiIiNtSIiQiIiJuS4mQiIiIuC0lQnchLCyMNm3a0KJFCxYvXuzq7jjdlStXaNeuHadPn3Z1V5xuxowZtG3blrZt2zJx4kRXd8fppk2bRps2bWjbti0LFixwdXdcZsKECQwfPtzV3XC6Xr160bZtWzp27EjHjh35448/XN0lp9qyZQtdunThiSee4P3333d1dySD6bfG0un8+fOEhoaycuVKvL296d69O3Xq1KFs2bKu7ppT/PHHH4wYMYITJ064uitOt3PnTn744QdWrVqFyWTihRdeYNOmTbRo0cLVXXOKX375hZ9++ok1a9aQkpJCmzZtaNy4MWXKlHF115wqPDycVatW0aRJE1d3xalsNhvHjh1j27ZteHq631vGqVOnGD16NMuXL6dgwYL07t2b7du307hxY1d3TTKIKkLptHPnTurWrUu+fPnw9/enVatWrF+/3tXdcpply5YxevRogoKCXN0VpwsMDGT48OF4e3vj5eXFgw8+SEREhKu75TS1a9fm888/x9PTkwsXLmCxWPD393d1t5zq0qVLhIaG0r9/f1d3xemOHTuGyWSiX79+dOjQgS+++MLVXXKqTZs20aZNGwoXLoyXlxehoaFUqVLF1d2SDOR+6f09ioyMJDAw0LEcFBTE3r17Xdgj5/rggw9c3QWXKVeunOPvEydOsG7dOr788ksX9sj5vLy8+O9//8v8+fN54oknCA4OdnWXnGrUqFGEhIRw9uxZV3fF6WJjY6lXrx5jxowhMTGRXr16Ubp0aRo0aODqrjnFyZMn8fLy4vnnnycqKoqmTZsyePBgV3dLMpAqQulks9lSrTOZTC7oibjKkSNH6Nu3L8OGDaNUqVKu7o7TDRo0iPDwcM6ePcuyZctc3R2nWb58OUWKFKFevXqu7opLVKtWjYkTJ+Lv70+BAgXo1q0b27dvd3W3nMZisRAeHs6kSZNYtmwZ+/btY9WqVa7ulmQgJULpFBwcTHR0tGM5MjLSLYeJ3NXu3bt57rnneP311+ncubOru+NUf//9N3/99RcAfn5+tGzZkkOHDrm4V86zbt06fvzxRzp27Mh///tftmzZwrhx41zdLafZtWsX4eHhjmWbzeZWc4UKFSpEvXr1KFCgAL6+vjRv3tytRgPcgRKhdKpfvz7h4eHExMSQkJDAxo0badSokau7JU5w9uxZXn31VSZPnkzbtm1d3R2nO336NCNGjCApKYmkpCQ2b95MjRo1XN0tp1mwYAHffPMNq1evZtCgQTRr1oy3337b1d1ymri4OCZOnMi1a9e4cuUKq1atcpsLBQCaNm3KDz/8QGxsLBaLhR07dvDII4+4uluSgdwnrb9PwcHBhISE0KtXL5KTk+nWrRuVK1d2dbfECebNm8e1a9cYP368Y1337t15+umnXdgr52ncuDF//PEHnTp1wsPDg5YtW7plQuiumjZt6jj+VquVHj16UK1aNVd3y2mqVKnCCy+8QI8ePUhOTqZBgwZ07drV1d2SDGSypTX5RURERMQNaGhMRERE3JYSIREREXFbSoRERETEbSkREhEREbelREhERETclhIhERERcVtKhERERMRtKRESkXRp3bo1jRo14siRI67uiohIhlEiJCLp8s0331CqVCk2bNjg6q6IiGQYJUIiki4eHh7UqFHDrX5wVURyPv3WmIikS2JiImvXrkW/yiMiOYkqQiKSLqGhoQQHB3Pq1CmuXr3q6u6IiGQIJUIicke//fYb69evZ/r06eTJk4fDhw+7uksiIhlCiZCI/Ktr167x1ltv8e6775IvXz4qVKigeUIikmMoERKRfzVt2jSqVatGkyZNAKhQoQIHDx50badERDKIEiERua29e/eyfv163n77bce6ihUrqiIkIjmGyaZLQERERMRNqSIkIiIibkuJkIiIiLgtJUIiIiLitpQIiYiIiNtSIiQiIiJuS4mQiIiIuC0lQiIiIuK2lAiJiIiI2/o/JLJEXjtbgnkAAAAASUVORK5CYII=\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter10_49_2.png" - } - }, - "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": 10, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stderr", - "output_type": "stream", - "text": [ - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", - " warnings.warn(\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 1e-05\n", - "Lambda = 1e-05\n", - "Accuracy score on test set: 0.18333333333333332\n", - "\n" - ] - }, - { - "name": "stderr", - "output_type": "stream", - "text": [ - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", - " warnings.warn(\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 1e-05\n", - "Lambda = 0.0001\n", - "Accuracy score on test set: 0.18611111111111112\n", - "\n" - ] - }, - { - "name": "stderr", - "output_type": "stream", - "text": [ - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", - " warnings.warn(\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 1e-05\n", - "Lambda = 0.001\n", - "Accuracy score on test set: 0.13055555555555556\n", - "\n" - ] - }, - { - "name": "stderr", - "output_type": "stream", - "text": [ - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", - " warnings.warn(\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 1e-05\n", - "Lambda = 0.01\n", - "Accuracy score on test set: 0.24444444444444444\n", - "\n" - ] - }, - { - "name": "stderr", - "output_type": "stream", - "text": [ - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", - " warnings.warn(\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 1e-05\n", - "Lambda = 0.1\n", - "Accuracy score on test set: 0.23333333333333334\n", - "\n" - ] - }, - { - "name": "stderr", - "output_type": "stream", - "text": [ - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", - " warnings.warn(\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 1e-05\n", - "Lambda = 1.0\n", - "Accuracy score on test set: 0.12777777777777777\n", - "\n" - ] - }, - { - "name": "stderr", - "output_type": "stream", - "text": [ - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", - " warnings.warn(\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 1e-05\n", - "Lambda = 10.0\n", - "Accuracy score on test set: 0.1527777777777778\n", - "\n" - ] - }, - { - "name": "stderr", - "output_type": "stream", - "text": [ - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", - " warnings.warn(\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 0.0001\n", - "Lambda = 1e-05\n", - "Accuracy score on test set: 0.9111111111111111\n", - "\n" - ] - }, - { - "name": "stderr", - "output_type": "stream", - "text": [ - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", - " warnings.warn(\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 0.0001\n", - "Lambda = 0.0001\n", - "Accuracy score on test set: 0.8888888888888888\n", - "\n" - ] - }, - { - "name": "stderr", - "output_type": "stream", - "text": [ - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", - " warnings.warn(\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 0.0001\n", - "Lambda = 0.001\n", - "Accuracy score on test set: 0.8722222222222222\n", - "\n" - ] - }, - { - "name": "stderr", - "output_type": "stream", - "text": [ - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", - " warnings.warn(\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 0.0001\n", - "Lambda = 0.01\n", - "Accuracy score on test set: 0.8305555555555556\n", - "\n" - ] - }, - { - "name": "stderr", - "output_type": "stream", - "text": [ - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", - " warnings.warn(\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 0.0001\n", - "Lambda = 0.1\n", - "Accuracy score on test set: 0.8888888888888888\n", - "\n" - ] - }, - { - "name": "stderr", - "output_type": "stream", - "text": [ - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", - " warnings.warn(\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 0.0001\n", - "Lambda = 1.0\n", - "Accuracy score on test set: 0.8805555555555555\n", - "\n" - ] - }, - { - "name": "stderr", - "output_type": "stream", - "text": [ - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", - " warnings.warn(\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 0.0001\n", - "Lambda = 10.0\n", - "Accuracy score on test set: 0.8944444444444445\n", - "\n" - ] - }, - { - "name": "stderr", - "output_type": "stream", - "text": [ - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", - " warnings.warn(\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 0.001\n", - "Lambda = 1e-05\n", - "Accuracy score on test set: 0.975\n", - "\n" - ] - }, - { - "name": "stderr", - "output_type": "stream", - "text": [ - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", - " warnings.warn(\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 0.001\n", - "Lambda = 0.0001\n", - "Accuracy score on test set: 0.9777777777777777\n", - "\n" - ] - }, - { - "name": "stderr", - "output_type": "stream", - "text": [ - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", - " warnings.warn(\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 0.001\n", - "Lambda = 0.001\n", - "Accuracy score on test set: 0.9805555555555555\n", - "\n" - ] - }, - { - "name": "stderr", - "output_type": "stream", - "text": [ - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", - " warnings.warn(\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 0.001\n", - "Lambda = 0.01\n", - "Accuracy score on test set: 0.9861111111111112\n", - "\n" - ] - }, - { - "name": "stderr", - "output_type": "stream", - "text": [ - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", - " warnings.warn(\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 0.001\n", - "Lambda = 0.1\n", - "Accuracy score on test set: 0.9805555555555555\n", - "\n" - ] - }, - { - "name": "stderr", - "output_type": "stream", - "text": [ - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", - " warnings.warn(\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 0.001\n", - "Lambda = 1.0\n", - "Accuracy score on test set: 0.9777777777777777\n", - "\n" - ] - }, - { - "name": "stderr", - "output_type": "stream", - "text": [ - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", - " warnings.warn(\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 0.001\n", - "Lambda = 10.0\n", - "Accuracy score on test set: 0.9444444444444444\n", - "\n" - ] - }, - { - "name": "stderr", - "output_type": "stream", - "text": [ - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/neural_network/_multilayer_perceptron.py:582: ConvergenceWarning: Stochastic Optimizer: Maximum iterations (100) reached and the optimization hasn't converged yet.\n", - " warnings.warn(\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 0.01\n", - "Lambda = 1e-05\n", - "Accuracy score on test set: 0.9861111111111112\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 0.01\n", - "Lambda = 0.0001\n", - "Accuracy score on test set: 0.9888888888888889\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 0.01\n", - "Lambda = 0.001\n", - "Accuracy score on test set: 0.9888888888888889\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 0.01\n", - "Lambda = 0.01\n", - "Accuracy score on test set: 0.9861111111111112\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 0.01\n", - "Lambda = 0.1\n", - "Accuracy score on test set: 0.9888888888888889\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 0.01\n", - "Lambda = 1.0\n", - "Accuracy score on test set: 0.9722222222222222\n", - "\n", - "Learning rate = 0.01\n", - "Lambda = 10.0\n", - "Accuracy score on test set: 0.9527777777777777\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 0.1\n", - "Lambda = 1e-05\n", - "Accuracy score on test set: 0.9111111111111111\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 0.1\n", - "Lambda = 0.0001\n", - "Accuracy score on test set: 0.9222222222222223\n", - "\n", - "Learning rate = 0.1\n", - "Lambda = 0.001\n", - "Accuracy score on test set: 0.9111111111111111\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 0.1\n", - "Lambda = 0.01\n", - "Accuracy score on test set: 0.9305555555555556\n", - "\n", - "Learning rate = 0.1\n", - "Lambda = 0.1\n", - "Accuracy score on test set: 0.8388888888888889\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 0.1\n", - "Lambda = 1.0\n", - "Accuracy score on test set: 0.9055555555555556\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 0.1\n", - "Lambda = 10.0\n", - "Accuracy score on test set: 0.8666666666666667\n", - "\n", - "Learning rate = 1.0\n", - "Lambda = 1e-05\n", - "Accuracy score on test set: 0.09166666666666666\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 1.0\n", - "Lambda = 0.0001\n", - "Accuracy score on test set: 0.11944444444444445\n", - "\n", - "Learning rate = 1.0\n", - "Lambda = 0.001\n", - "Accuracy score on test set: 0.1361111111111111\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 1.0\n", - "Lambda = 0.01\n", - "Accuracy score on test set: 0.1527777777777778\n", - "\n", - "Learning rate = 1.0\n", - "Lambda = 0.1\n", - "Accuracy score on test set: 0.16666666666666666\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 1.0\n", - "Lambda = 1.0\n", - "Accuracy score on test set: 0.1111111111111111\n", - "\n", - "Learning rate = 1.0\n", - "Lambda = 10.0\n", - "Accuracy score on test set: 0.05\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 10.0\n", - "Lambda = 1e-05\n", - "Accuracy score on test set: 0.08888888888888889\n", - "\n", - "Learning rate = 10.0\n", - "Lambda = 0.0001\n", - "Accuracy score on test set: 0.08611111111111111\n", - "\n", - "Learning rate = 10.0\n", - "Lambda = 0.001\n", - "Accuracy score on test set: 0.08888888888888889\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 10.0\n", - "Lambda = 0.01\n", - "Accuracy score on test set: 0.08888888888888889\n", - "\n", - "Learning rate = 10.0\n", - "Lambda = 0.1\n", - "Accuracy score on test set: 0.10555555555555556\n", - "\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Learning rate = 10.0\n", - "Lambda = 1.0\n", - "Accuracy score on test set: 0.1111111111111111\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": 11, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "data": { - "image/png": "iVBORw0KGgoAAAANSUhEUgAAAkIAAAJgCAYAAABmwww9AAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjMuMywgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/Il7ecAAAACXBIWXMAAAsTAAALEwEAmpwYAABkgElEQVR4nO3deZyNdf/H8dd1zmwGY50Za0XWZC9bkSXJTqnUXUTcyRa6/dqIkhKyRAohyp7sssSdyFJRkb2iss4wGGbMzFmu3x/HPVxmRJk5x8z1fj4e8+C6znXO+Xzmus51PvP5fq9zDNM0TURERERsyBHoAEREREQCRYWQiIiI2JYKIREREbEtFUIiIiJiWyqERERExLZUCImIiIhtBQU6ABG7efPNN/nuu+8A+PXXXylatChhYWEAzJ07N/X/19K1a1defPFFSpUqddVtxo4dy6233kqbNm1uOO7/6dWrF99++y1fffUVOXLkyLDHFREJBEOfIyQSOA0bNmTs2LFUrFgx0KFclxMnTtC6dWsqV65M/fr1efzxxwMdkojIDdHQmMhNZNy4cTzzzDO0bNmS//znP5w8eZLu3bvz2GOP0bBhQ5566ilOnToF+IqonTt3snXrVtq3b0///v1p06YNzZo1Y8uWLQC89NJLTJkyBYCKFSsybtw42rdvT8OGDfn4448B8Hg8vP322zRu3JiHHnqIwYMH89RTT6Ub37x586hduzZt27ZlxowZXP531E8//cQjjzxCixYtaNu2LZs3b/7L9WXLliUuLi71/v9b3rp1K61ataJ9+/a0atWKlJQU3nzzTR555BGaNWtG06ZN2bZtGwAJCQm8/PLLNGnShGbNmjFq1CgSExO5++67OXjwYOpjd+rUiS+//DIjdpGIZDMqhERuMkeOHGHhwoWMHDmS5cuXU6VKFebOncvatWsJCwtj8eLFae6zY8cOOnfuzKJFi2jXrh3jx49Ps01KSgr58uVjzpw5vPfee7z77rskJyczf/58du3axbJly5gzZw5//vlnunG53W7mzZtHq1ataNiwIadOneLrr78GwOVy0aNHD3r06MGyZcsYMmQIb731FikpKemu93q9f/k7OHDgAO+++y5Llixh165dxMTEMHfuXFasWEHbtm2ZPHkyAO+99x7JycmsWLGCRYsWsX37dnbu3EmbNm2YP38+AH/88QcH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OxuXwKgBCxgw5nGCgi6e+175jNIVitLnjbb0eHj8X95/2Zyt5M4Tzrj5PXA6DH7Zc5TJwxf7KfrMdTNMYvYXwzTNLPf5kQ/UHhLoEALGcZXPt7ALI9He+V8olfU+niGjhMTZe9879ma9YecMVbxIoCMIqJW7hvr1+bb/4b8hvmq3/OG350qPPlBRRERELDw2+phB+2QqIiIicgV1hERERMTiZris3V/UERIRERHbUkdIRERELOx01Zg6QiIiImJb6giJiIiIhce0T5/EPpmKiIiIXEEdIREREbHw2qhPYp9MRURERK6gjpCIiIhY6KoxERERERtQR0hEREQsdNWYiIiIiA2oEBIRERHb0tCYiIiIWHg1WVpEREQk+1NHSERERCw8NuqT2CdTERERkSuoIyQiIiIWunxeRERExAbUERIRERELfemqiIiIiA2oIyQiIiIWHlOfIyQiIiKS7akjJCIiIhb6HCERERERG1BHSERERCy8+hwhERERkexPHSERERGx0BwhERERERtQISQiIiK2paExERERsdAHKoqIiIjYQJbsCA2cPT3QIQRMkhkc6BACyu75u0xnoEMImKJBZwIdQkDFe8MCHUJAebFPhyJ9Q/36bPrSVREREREbyJIdIREREck8Hn2gooiIiEj2p46QiIiIWNhpTpY6QiIiImJb6giJiIiIheYIiYiIiNiAOkIiIiJioS9dFREREbEBdYRERETEwqvvGhMRERHJ/tQREhEREQvNERIRERGxARVCIiIiYlsaGhMRERELrz5QUURERCT7U0dIRERELDz60lURERGR7E8dIREREbHQHCERERERG1BHSERERCw0R0hERETEBtQREhEREQvNERIRERGxAXWERERExMKjjpCIiIhI9qeOkIiIiFh4ddWYiIiISPanjpCIiIhYaI6QiIiIiA2oIyQiIiIWXlNzhERERESyPRVCIiIiYlsqhERERMTCg8NvP3/H0qVLadasGY0bN2bmzJlpbt+1axcPP/wwrVq14tlnnyU+Pv6aj6k5Qhft2AoLpjlwu6BYCXi6r5ccOa3brF1ssG6JQUgIFL7F5IkeJrkiLt0eFwNv9XEw6AMvufP4N/6M9vNWkyXTTNwuKFoCnuhrkCOndcz4q8UmXy8xCQ6FQsXh0Z4GOXNnzXHl3d96+GKaB7cLCpcweLRPEGFX5Lvz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cOk0WrqCScdeGX/VXLz32le/ZISb9bXvJfOLjV3f+i6f91zM/cn+Dk4dg9ljvLw4wffa+3qJlw0Xcy9ZwaCdH3IHaFJid6Y/x+We/+Fxvz3X2Kqz/fZc6fFbIZSRMqMQyir8VQjdrOyef2YVQllBZhVCWYW/CqGblT8KoZuZCqHMkzUu7RARERG/8ZpZZ3j/RtknUxEREZErqCMkIiIiFh4bDUWqIyQiIiK2pY6QiIiIWHhvws8RyizqCImIiIhtqRASERER29LQmIiIiFjo8nkRERERG1BHSERERCzs9Ene6giJiIiIbakjJCIiIhYeXT4vIiIikv2pIyQiIiIWumpMRERExAbUERIRERELfcWGiIiIiA2oIyQiIiIW+hwhERERERtQR0hEREQsNEdIRERExAbUERIRERELfY6QiIiIiA2oEBIRERHb0tCYiIiIWGiytIiIiIgNqCMkIiIiFvpARREREREbUEdIRERELDRHSERERMQG1BESERERC3WERERERGxAHSERERGxUEdIRERExAayZEeodligIwgkV6ADCCgHnkCHIAETHOgAAsplJgc6hIA67U0KdAi2oo6QiIiIiA1kyY6QiIiIZB59srSIiIiIDagjJCIiIhaaIyQiIiJiAyqERERExLY0NCYiIiIWGhoTERERsQF1hERERMRCHSERERERG1BHSERERCzUERIRERGxAXWERERExMJUR0hEREQk+1NHSERERCz0pasiIiIiNqCOkIiIiFjoqjERERERG1BHSERERCx01ZiIiIiIDagjJCIiIhaaIyQiIiJiAyqERERExLY0NCYiIiIWmiwtIiIiYgPqCImIiIiFJkuLiIiI2IA6QiIiImJhmoGOwH/UERIRERHbUkdIRERELLxojpCIiIhItqeOkIiIiFjoc4REREREbEAdob/JNOHVYQalS0Cn9jaaVo+9cwdf/q8Mg9IloHP7QEfjf8o/e+b/9WaDsZOdpLigTEmT1//PQ66c1m1mfe5g9kIHYSFQ4laTV/t4yBMBZ+PhzdFO9v5ikCMM2jT18sRD3sAk8g9t3uJk0kehuFIMSpb08GL/JHJekf+Cz4NZuCiE0FCTW27x0vf5JCIifLctXBzM8uXBJKdA2TJe/u8/SYSE+D+PjKbPEZJ0/XoIOvd1sOq/9jlA/sfOuYMv/059YeV/Ax1JYCj/7Jl/3BkY+I6TUW+4WfqJm2JFTMZMsr4tfPuDwdRZDia/62b+FDd1a3l5faQTgOHvOwnPAYs+djNzgpuNWw3Wb8o654gzZwyGDQ9jyOALfDojgSJFvEycHGrZZvsPTmbPCWHUu4lMmZxIrZpuRo4KA+Drr4P4fGEwo0YmMn1qIsnJMP+zbFAF2YzfCqEvv/ySTz75hD/++MOyfu7cuf4K4YbNXmTQtqlJkwb264bYOXeAWYugbVN4sEGgIwkM5Z8989/8ncGd5UxuLeZbfrSVlxVfOiyfIbN7n0Gt6iaFonzLjeqarN9s4HL5bmvR2IvTCcHBUK+WyZr1Wefv6+++d1KurJdixXwJt27l4su1wZb89+93UL26h6hI38p6dd1s2hyEywWr1gTx2CMuIiLA4YAX+ibzQGNXIFLJcKbpv59A88sRO3LkSD799FMOHTpE+/btWbx4ceptc+bM8UcIGWJAH5NWTW6CvRYAds4dYGAfaN0k0FEEjvLPnvkfjzEoFHnpdR0dCecTDBISL21zZ3mTb38wOHrct7z4Cwcul8GZeKh0h8myNQ5cbkhMhDVfG5yM83MSNyAmxkFU1KWhvMhIk4QEg8TL8i9fzsv2H5wcP+7rdH2xMhiXyyA+3uDPww5OnzHo/2IOOnUJZ9r0EHLlsu95Mqvyyxyh9evXs3DhQoKCgnjqqafo3LkzISEhNG3aFPNmKAdFRGzIe5XTr+OyP5HvqmzSraOHPgODcBgmbZqZ5IkwCQ6CF57z8O4HTh7tEkRkAZPad5n8+HPWGRq7nvwrV/bwdIcUBryWA4cDmjZ1ERFhEhRk4nYbfL/NyVtDLhASAm8NC+OjKaH06pnsnwQykZ2uGvNLIWSaJobh+6XedtttTJw4kU6dOpE/f/7U9SIi4l+Fo0x27rn0rh9zEiJym4TnuLRNQqKvGHqouRuAU3Hw/lQHeSLgeAz06+abOA0wdZaDW4pmnT9uo6O87Nlz6W3wZKxB7twmOS7LPzERKld207yZb8grLs5g6rRQIiKgYAEvde91p06ufqCxi+kzrHOM5Obnl6GxBx98kKeeeoodO3YAULp0acaOHUufPn3SzBkSERH/qH23yY7dBr8f9i3PX+KgwT3WQibmJHTuE8T5BN/yxBkOmjb0Yhgwb4mD96f63kZOxcGCZQ6a3Z91CqG77/Kwe4+Tw4d9f5AvWRrMPXXclm1OnjTo0zechIv5z/gkhEYNXBgG3FfPzVfrg0hO9s112bAxiHJlPf5OQ26QXzpCPXv2pHr16uS87JrE6tWr8/nnnzN16lR/hCAiIlcokA+GvOjhhUG+yb/Fi5gMfcXDrr0Gg0c4mT/FTYlb4JknvPzruSC8JlSraPLy8743+y7/8vLKUCdtn/a9lTz3tIc7y2WdQihfPpOX+ifx2uAcuNxQtIjJKy9dYO8+ByNGhjFlciK33GLyxOMpdOsRjuk1qFjRTZ/evqGvNq1dnDtn0LVbOF6PQenSHno8lxTgrDKGnYbGDDMLTtJxHy8V6BAkQBz6xAexKZfpvvZG2dhpb/YoMP6pQkWP+vX5Ki4Z5Lfn2tnqdb89V3r0gYoiIiJioQ9UFBEREbEBdYRERETEIutNmvnn1BESERER21JHSERERCzsdNWYOkIiIiJiW+oIiYiIiIU6QiIiIiI2oI6QiIiIWNjoojF1hERERMS+1BESERERC80REhEREbEBdYRERETEykaThNQREhEREdtSISQiIiK2paExERERsdBkaREREREbUEdIRERELExNlhYRERHJ/tQREhEREQvNERIRERGxAXWERERExEodIREREZHsTx0hERERsdBVYyIiIiI2oI6QiIiIWKkjJCIiIpL9qSMkIiIiFvocIREREZGbzNKlS2nWrBmNGzdm5syZaW7/7bffeOqpp2jVqhXPPPMMZ8+eveZjqhASERERK9OPP9fpxIkTjB49mlmzZrF48WLmzp3LL7/8cilk0+S5556ja9euLFmyhPLlyzNp0qRrPq6GxkRERCRg4uPjiY+PT7M+IiKCiIiI1OVNmzZRq1Yt8ubNC0CTJk1YuXIlPXv2BGDXrl2Eh4dTr149ALp165bu415JhZCIiIgEzPTp0xk/fnya9T179qRXr16pyzExMURGRqYuR0VFsWPHjtTlP/74g4IFC/Liiy+ye/duypQpw8CBA6/5/CqERERExMKfk6U7duxI27Zt06y/vBsEvqGvKxnGpTjdbjfffvstn376KRUrVmTMmDEMGzaMYcOG/eXzqxASERGRgLlyCOxqoqOj+f7771OXY2JiiIqKSl2OjIzk1ltvpWLFigC0aNGC3r17X/Nxs2Qh5NAcbxGxGadh7/Oey06f8HczuAl/3XXq1GHcuHHExcWRI0cOVq9ezZAhQ1Jvr1q1KnFxcezdu5dy5cqxbt06KlSocM3HzZKFkIiIiNhLdHQ0ffv2pUOHDrhcLtq1a0elSpXo2rUrvXv3pmLFirz//vsMGDCACxcuUKhQIYYPH37NxzXM9AbdbnLe42UCHYKIiF958QY6hIA65kkIdAgBVbzoMb8+320z3vHbcx3q8KLfnis99u61ioiIiK1paExERESsstxY0T+njpCIiIjYljpCIiIiYqWOkIiIiEj2p46QiIiIWPnxk6UDTR0hERERsS11hERERMQi633C4D+njpCIiIjYljpCIiIiYqWOkIiIiEj2p0JIREREbEtDYyIiImKly+dFREREsj91hERERMTC0GRpERERkexPHSERERGxUkdIREREJPtTR0hERESsdNWYiIiISPanjpCIiIhYaY6QiIiISPanjpCIiIhYqSMkIiIikv2pIyQiIiJW6giJiIiIZH/qCImIiIiVPkdIREREJPtTISQiIiK2paExERERsTA0WVpEREQk+1NHSERERKxs1BFSIfQ3mSa8MgxKl4DO7QMdjX/ZOXdQ/so/e+a/fjOMmeQgxQVlSsKQF73kymndZuYCg1kLDUJDoeQtJgP6muSNgDPxMGSUwd5fDHKEQdumJv96OGu9g27ZEsSUj0JxpUDJkl5e6H+BnFfkv/DzYBYvCiE0FG65xUuv5y8QEeG7bfHiYL5YHkJKCpQu4+GF/yQREuL/POSf09DY3/DrIejUF1b+N9CR+J+dcwflr/yzZ/5xZ2DAMAdjhnhZ/qmXYkVMRk20Xja9dTtMmW0wZZSXz6d4qVcLBo/0vXW8M94gPAcsme5l1gdeNmw1+GpTABL5h86cMRg5PIxBgy/w8YwEChfx8tHkMMs2P/7gZO6cUEa8m8jEyQnUqOlm9KgcAGz4OojFC0MYPjKBj6YmkJxssOAzVUFZjd8KoUOHDnHixAkA5s+fz5tvvsmKFSv89fQZYtYiaNsUHmwQ6Ej8z865g/JX/tkz/03fGdxZDm4t5ltu39pk+ZcG5mVNnd37DWpVNykU5Vu+v57JV5sgxeW7reUDJk4nhARDvdomq9dnnc+f2fa9kzJlPRQr5gWgZasU1q4NtuS/f7+TatXdREb6Vt5b18WWzUG4XLBmTTDtHkkhIgIcDujTN4nGjV2BSEVuwDWHxqZOncr48ePxeDwUKVKEsmXLpv6UKVOGYsWKXfNJPv74Yz755BO8Xi+1atXi2LFjNG7cmAULFnDw4EF69OiRIclktoF9fP9u2R7QMALCzrmD8lf+vn+zW/7HYqBQ1KV3/ehIOJ9gkJBI6vBYxfImny5wcPS4SZFCsPALA5fL4Gw8VCpvsnS1QdWKJikpsGa9QVAQZJUJJjExDqIuyz8y0iQxwSAxkdThsXLlPCxcGMKJ4wbRhUxWrQzG5TKIjzc4fNjBmTMGL70YzqlTBhUreuj676QAZZOx7HTV2DULoYkTJzJ8+HAqVarEn3/+yf79+9m3bx9ff/01Bw4cAKB06dLMnj37qo+xYMECVqxYwcmTJ2nRogVbtmwhNDSURx55hHbt2mWZQkhEJDsxvemvd1w2VnBXZej+tEnvAQ4cDt88oDwRJsFB0L+7ycgPDNp1cRCZH+rcZfLDz1mnI2Re5c3+8vwrVfbQoUMyg14Lx+GAJk1TyB3hJSgIPG7Yti2IN4YkEhICw4flYNqUULr3TPZPApIhrlkI5cqVi/r16xMUFERUVBTVq1e33H748OHUguhqvF4vISEhFC1alM6dOxMaGpp6m8fj+Yehi4jIjSgcDTv2GPyvgxNzEiJym4TnuLRNQiLcVdnk4ea+bU7GwbipBnkifB2lft1M8kb4bvtolsEtxbJOKyEqymTPnkuF28lYg9y5TXJcln9iIlSq7KZpM9+Q1+k4g4+nhRIRYVKggMm997pTu0eNGrv4dEYokA0KIX3FxiX//ve/mT9//lVvL1asGA0a/PXA+QMPPMCTTz6Jx+OhV69eAOzdu5cnnniCpk2b/s2QRUQkI9S522THbvj9sG957hKDhvdYC5mYk9Cpj4PzCb7lD2cYNGtkYhgwb7HB+Km+N8yTcfDZMoPmjbJOIVT9Ljd79jg5fNj3Vrh0aQh16ljn+Jw66eCFvjlJuJj/p5+E0rCBG8OAuvVcrF8fRHKyr7v0zcYgypbVH/dZzTU7QsOGDcPlcrFhwwbq1q1L+fLlKVu2LDkuL5mv4fnnn+e7777D6XSmrgsJCaFXr17cd999/yxyERG5IQXywZsveenzmgO3C4oXhbde8fLzXnhthIPPp3gpcQs884TJ490ceE2oVtHk1T6+YqfrkyYvDXXQ+mnfBOseT5tULB/gpP6GfPlM+vdP4o3BOXC7oXARLy++dIF9+xyMGpmDiZMTKH6Ll/aPJ9OrR068XrizoodevX3zgFq1dnHunMFz3XLi9UDp0l66PXchwFllkKxTz94wwzSvNkrq8+eff7J371727dvHvn372Lt3L0ePHqVYsWKsWrXKX3FaeI+XCcjziogEiperTOixiWOehECHEFDFix7z6/OVHDPKb8/1W59+fnuu9FyzI1S8eHGKFy9O48aNU9clJiayf//+TA1MREREAsRGHaF/9DlC4eHhVKlSJYNDEREREfEvfcWGiIiIWNjpc4T0FRsiIiJiW+oIiYiIiJU6QiIiIiLZnwohERERsS0NjYmIiIiVhsZEREREsj91hERERMRCl8+LiIiI2IA6QiIiImJlGoGOwG/UERIRERHbUkdIRERErDRHSERERCT7U0dIRERELHTVmIiIiIgNqCMkIiIiVuoIiYiIiGR/6giJiIiIheYIiYiIiNiAOkIiIiJipY6QiIiISPanQkhERERsS0NjIiIiYqWhMREREZHsTx0hERERsdDl8yIiIiI2oEJIREREbEuFkIiIiNiW5giJiIiIleYIiYiIiGR/6giJiIiIha4aExEREbGBLNkR2utKCHQIARNspzI9HV57p09uG//p8tWF4oEOIaBuC44NdAgBtTf59kCHEFCd/f2ENjrX2vi0KiIiInaXJTtCIiIikonUERIRERHJ/tQREhEREQs7TUdVR0hERERsS4WQiIiI2JaGxkRERMRKQ2MiIiIi2Z86QiIiImKhydIiIiIiNqCOkIiIiFipIyQiIiKS/akjJCIiIlbqCImIiIhkf+oIiYiIiIWuGhMRERGxAXWERERExEodIREREZHsTx0hERERsVJHSERERCT7U0dIRERELHTVmIiIiIgNqBASERER29LQmIiIiFhpaExEREQk+1NHSERERCw0WVpERETEBtQREhERESt1hERERESyP3WERERExEodIREREZGby9KlS2nWrBmNGzdm5syZV93uq6++omHDhtf1mOoIiYiIiIUR6ADSceLECUaPHs3nn39OSEgI7du3p2bNmpQqVcqy3cmTJ3nnnXeu+3HVERIREZGAiY+P5/Dhw2l+4uPjLdtt2rSJWrVqkTdvXsLDw2nSpAkrV65M83gDBgygZ8+e1/386giJiIiIlR/nCE2fPp3x48enWd+zZ0969eqVuhwTE0NkZGTqclRUFDt27LDcZ8aM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/F0IVenlv0Lox3GBLYRsfFoVERERu8smg5kiIiKSYWzUfVdHSERERGxLHSERERGxsNN0VHWERERExLbUERIRERErdYREREREsj91hERERMRCc4REREREbEAdIREREbFSR0hEREQk+1NHSERERKzUERIRERHJ/lQIiYiIiG1paExEREQsdPm8iIiIiA2oIyQiIiJW6giJiIiIZH/qCImIiIiFYdqnJaSOkIiIiNiWOkIiIiJiZZ+GkDpCIiIiYl/qCImIiIiFPkdIRERExAbUERIRERErdYREREREsj91hERERMRCc4REREREbEAdIREREbFSR0hEREQk+1MhJCIiIraloTERERGx0GRpERERERvIkh2hflWbBzqEwCkaHegIAspIcQc6hIDyhocEOoSAMpLsu/+NmFOBDiGg3KfsnX9nr5+fUB0hEZGbi52LIBHJPFmyIyQiIiKZR3OERERERGxAHSERERGxMu3TElJHSERERGxLHSERERGx0BwhERERERtQR0hERESs1BESERERyf7UERIRERELw9+fZB1A6giJiIiIbakjJCIiIlaaIyQiIiKS/akQEhEREdvS0JiIiIhY6AMVRURERGxAHSERERGx0peuioiIiGR/6giJiIiIheYIiYiIiNiAOkIiIiJipY6QiIiISPanjpCIiIhYaI6QiIiIiA2oIyQiIiJW+hwhERERkexPHSERERGx0BwhERERERtQR0hERESs1BESERERyf5UCImIiIhtaWhMRERELDRZWkRERMQG1BESERERK699WkIqhK6iRuOKdBrQluDQIA7uOsLo56eTeD4p3W1fGPc0h/YeYcH7a/wcZcapUbcMnXo3JjgkiIP7jzN68CISE5LT3faFN9py6JcYFsz4BgCHw6D7yy2oWP02AL7buJ+PRq3yV+gZ4u77ytKpbxNf/vuOM2bAgqvm3++tdvx+4AQLpm1IXdf88Vo82O4uQkKD+WXXEcYMWIDL5fFX+Desxr2l6dTzfoKDgzj4ywlGv7H46vt/cBt+/zWGzz7ZBEDuiBz0erkFJcsUIikphdVLfmTJ3K3+DP+G1KhXlk59HiA4xOk79gcuvHruQx/m0IETLPh4Y+q6Fu1r8uDDdxESGsQvu48yeuDnWWrfX+nuxnfS6dU2vnPf7iOMef6Tq577+o3ryO97jrJgQtY699VoVo1n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tIiIiIgNqCMkIiIiVjaaLG2Ypo2+YlZERETkMhoaExEREdtSISQiIiK2pUJIREREbEuFkIiIiNiWCiERERGxLRVCIiIiYlsqhERERMS2VAiJiIiIbakQEhEREdtSIfQ3LF26lGbNmtG4cWNmzpwZ6HD87vz587Ro0YLDhw8HOhS/Gz9+PM2bN6d58+YMHz480OH43dixY2nWrBnNmzdn2rRpgQ4nYN555x1eeumlQIfhdx06dKB58+a0bt2a1q1b89NPPwU6JL9at24dDz30EA8++CBvvvlmoMORDKbvGrtOJ06cYPTo0Xz++eeEhITQvn17atasSalSpQIdml/89NNPDBgwgEOHDgU6FL/btGkTGzduZOHChRiGQZcuXVizZg2NGzcOdGh+8e2337JlyxaWLFmC2+2mWbNm3HfffZQsWTLQofnV5s2bWbhwIfXr1w90KH5lmia//fYbX331FUFB9nvL+PPPPxk0aBDz58+nQIECdOzYkfXr13PfffcFOjTJIOoIXadNmzZRq1Yt8ubNS3h4OE2aNGHlypWBDstv5s2bx6BBg4iKigp0KH4XGRnJSy+9REhICMHBwdx+++0cPXo00GH5TY0aNZgxYwZBQUGcOnUKj8dDeHh4oMPyqzNnzjB69Gi6desW6FD87rfffsMwDLp27UqrVq349NNPAx2SX61Zs4ZmzZpRqFAhgoODGT16NJUrVw50WJKB7Ffe/0MxMTFERkamLkdFRbFjx44ARuRfQ4cODXQIAVO6dOnU/x86dIgVK1YwZ86cAEbkf8HBwbz33ntMnTqVBx98kOjo6ECH5FevvfYaffv25dixY4EOxe/i4+OpXbs2gwcPJikpiQ4dOlCiRAnuueeeQIfmF7///jvBwcE888wzxMbG0qBBA/r06RPosCQDqSN0nUzTTLPOMIwARCKBcuDAATp37syLL77IbbfdFuhw/K53795s3ryZY8eOMW/evECH4zfz58+ncOHC1K5dO9ChBETVqlUZPnw44eHh5M+fn3bt2rF+/fpAh+U3Ho+HzZs3M2LECObNm8fOnTtZuHBhoMOSDKRC6DpFR0dz8uTJ1OWYmBhbDhPZ1bZt23j66ad54YUXaNu2baDD8atff/2VPXv2AJAjRw4eeOAB9u3bF+Co/GfFihV88803tG7dmvfee49169bx1ltvBTosv/n+++/ZvHlz6rJpmraaK1SwYEFq165N/vz5CQsLo1GjRrYaDbADFULXqU6dOmzevJm4uDguXLjA6tWrqVevXqDDEj84duwYPXr0YOTIkTRv3jzQ4fjd4cOHGTBgACkpKaSkpLB27VqqV68e6LD8Ztq0aSxbtozFixfTu3dvGjZsyCuvvBLosPzm3LlzDB8+nOTkZM6fP8/ChQttc6EAQIMGDdi4cSPx8fF4PB42bNhAhQoVAh2WZCD7lPU3KDo6mr59+9KhQwdcLhft2rWjUqVKgQ5L/GDKlCkkJyczbNiw1HXt27fn8ccfD2BU/nPffffx008/0aZNG5xOJw888IAtC0K7atCgQer+93q9PPHEE1StWjXQYflN5cqV6dKlC0888QQul4t77rmHhx9+ONBhSQYyzPQmv4iIiIjYgIbGRERExLZUCImIiIhtqRASERER21IhJCIiIralQkhERERsS4WQiIiI2JYKIREREbEtFUIicl2aNm1KvXr1OHDgQKBDERHJMCqEROS6LFu2jNtuu41Vq1YFOhQRkQyjQkhErovT6aR69eq2+sJVEcn+9F1jInJdkpKSWL58OfpWHhHJTtQREpHrMnr0aKKjo/nzzz9JSEgIdDgiIhlChZCIXNMPP/zAypUrGTduHLlz52b//v2BDklEJEOoEBKRv5ScnMzLL7/M66+/Tt68eSlXrpzmCYlItqFCSET+0tixY6latSr169cHoFy5cuzduzewQYmIZBAVQiJyVTt27GDlypW88sorqevKly+vjpCIZBuGqUtARERExKbUERIRERHbUiEkIiIitqVCSERERGxLhZCIiIjYlgohERERsS0VQiIiImJbKoRERETEtlQIiYiIiG39P9VCMgc57xl2AAAAAElFTkSuQmCC\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter10_53_0.png" - } - }, - "output_type": "display_data" - }, - { - "data": { - "image/png": "iVBORw0KGgoAAAANSUhEUgAAAkIAAAJgCAYAAABmwww9AAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjMuMywgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/Il7ecAAAACXBIWXMAAAsTAAALEwEAmpwYAABo0UlEQVR4nO3deZyN5f/H8dd9zuzDWGfGWighIWTPHrJESd+UIkXJFtpLqISiECUKkSUka9ZSsiVbqGxlyT7GNhgzc5b798fxm3EbImbOcea8n4/HeXDf5zr3uT5z3+c+n/O5r+scwzRNExEREZEAZPN1B0RERER8RYmQiIiIBCwlQiIiIhKwlAiJiIhIwFIiJCIiIgFLiZCIiIgELCVCIjep/v3706JFC1q0aMFdd91Fo0aNUpeTkpL+07a2bNlCnz59rnj/jh07KFGiBGPGjLnRbouI+BVD3yMkcvOrV68ew4cPp0yZMtf1+G+//ZbFixczevToy97fr18/zp49y7p16/jhhx8ICgq6ke6KiPgNne1E/NCMGTOYOnUqbrebnDlz8tZbb3Hbbbexfv16Bg0ahNvtBuC5556jbNmyfPzxx5w5c4bXX3+dgQMHWrZ19uxZ5s6dy4wZM9i+fTuLFi2iWbNmADidTgYPHsxPP/2E3W6nfPny9O3bF5vNdtn1o0eP5uTJk6nVpxEjRqQuP/nkk+TIkYPdu3fz2GOPUaZMGQYPHkxKSgrHjh2jevXqDBgwAIAff/yRYcOG4Xa7iYiI4O233+bHH3/kr7/+4sMPPwRgw4YNvPvuu8yePdtLf3URyYqUCIn4mV9//ZXZs2czefJkwsPDWblyJd26dWPBggWMGDGC9u3b07RpU7Zv3860adNo1KgR3bt3Z/HixemSIIC5c+dSpEgRbrvtNh588EEmTJiQmghNmTKFP/74gzlz5hASEkKvXr1YsGABCQkJl11/NVFRUantevXqRffu3alSpQrnzp2jfv36/P777+TLl4+XX36Zr776ilKlSrFkyRKGDBnC+++/T8OGDTl16hQ5c+Zk2rRptG7dOmP/uCIScJQIifiZn376iX379lmSgNOnT3Pq1CkaN27MO++8w7Jly6hevTq9evW66vamTp3K//73PwCaN2/ORx99xMaNG6lQoQKrV6+mRYsWhIWFATBs2DAAOnXqdNn1I0aM+Nfnuueee1L/P2jQIH7++Wc+++wzdu/eTVJSEomJiWzcuJHixYtTqlQpABo2bEjDhg0BqFOnDnPmzOHBBx9k5cqV9O3b9xr+YiIiV6ZESMTPuN1uWrRowcsvv5y6HBcXR44cOWjdujV169Zl1apVrFixgpEjRzJ37twrbmv9+vXs2rWLL774gvHjxwMQHBzMhAkTqFChQrqxQvHx8bjd7iuuNwyDi4cdOhwOS7uIiIjU/7dp04aSJUtSs2ZNGjduzObNmzFNE7vdjmEYqe1M02THjh2ULFmSNm3a0K9fP4KCgmjYsCGRkZH/8a8nImKlWWMifqZGjRp89913xMXFAZ6KTrt27QBo3bo127Zto2XLlrz77rskJCRw+vRp7HY7Tqcz3bamTp1KixYtWL58OcuWLWPZsmV89tlnLF26lEOHDlGtWjXmz59PSkoKbrebfv368d13311xfa5cufjjjz8wTZPExERWrlx52RhOnz7N77//zksvvUTDhg05evQo//zzD263m3LlyvH333+za9cuAH744YfUpK9ChQrYbDbGjh3LY489lhl/XhEJMKoIifiZmjVr0rFjR55++mkMwyBbtmyMHDkSwzB46aWXGDBgAMOGDcNms9G1a1cKFSqE2+1m2LBhdOnShU8++QSAEydOsGTJEmbOnGnZfrVq1bj77rv56quveOmllzh48CAtW7bENE0qV67Mk08+iWEYl11//vx5VqxYQcOGDYmNjaV8+fJcbmJqjhw5ePbZZ3nooYfImTMnuXLlokKFCuzbt49q1aoxZMgQXn31VVwuF9myZWPo0KGpj23ZsiULFiygRIkSmfuHFpGAoOnzIuI3nE4nXbt2pXnz5jRp0sTX3RGRLECXxkTEL/z1119Uq1aNyMhI7r//fl93R0SyCFWEREREJGCpIiQiIiIBS4mQiIiIBCwlQiIiIhKw/HL6fKOKAfxtshd90VwgssWf9nUXfCqpRD5fd8FnbA63r7vgUyG743zdBd8KD/N1D3xq4bb0P4+TmdxH7vDac9ny7fTac132+X367CIiIiI+5JcVIREREck8brxXgfV1RcbXzy8iIiLiM6oIiYiIiIXL9F5FyNeJiCpCIiIiErCUCImIiEjA8nVFSkRERG4ybgLn17dUERIREZGApYqQiIiIWHhz+ryvqSIkIiIiAUsVIREREbFwmRojJCIiIpLl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74tnSK8p5L8lDy+8/yhdmwyxtL10CnFkVBjd3nuEW+/Ij2marFnyO5OGLiIzXlpJJTJnDE6VSsXo+HRtgoLsHDp8koGDvyN/vpy83PN+Onb+kjaPVaP9k/eyZ+8xy+NefPVrEs6kDY5t1OAuatcskSnT522OzPmkXbnKbXTo4In98KFTDBo0j/z5c/LiS0147tlxPN6mOk89VZM9e6yxv/zSVBITk+ncpQHlyhXG7Tb5/fcDfDbqB5IzYbJESCaNvfGXY5/wsIzfJlCpVgme6tnIc+7bf4Ihr00nf6HcvPBuS7q2HGFpe+n0+dCwYDr3bk7JcoWxB9tZsWgrEzLpq1MWbhuYKdu9ko3/3OK156pwyz9ee67L8VoilJEyIxHyG5mUCPmLzEqE/EVmJUL+ILMSIX+RWYmQ38ikRMhfKBHKPPpCRREREbFwBdDXDAZOpCIiIiKXUEVIRERELG6Gae3eooqQiIiIBCxVhERERMTiZvjpC29RRUhEREQClipCIiIiYuEyA6dOEjiRioiIiFxCFSERERGxcAdQnSRwIhURERG5hCpCIiIiYqFZYyIiIiIBQBUhERERsdCsMREREZEAoERIREREApYujYmIiIiFW4OlRURERLI+VYRERETEwhVAdZLAiVRERETkEqoIiYiIiIWmz4uIiIgEAFWERERExEI/uioiIiISAFQREhEREQuXqe8REhEREcnyVBESERERC32PkIiIiEgAUEVIRERELNz6HiERERGRrE8VIREREbHQGCERERGRAKBESERERAKWLo2JiIiIhb5QUURERCQA+GVF6J1vJ/q6Cz5zyh3u6y741Dl3qK+74FP7UqJ93QWfuTPsgK+74FMppl+erjNMpC3Z113wsYFefTb96KqIiIhIAAjsjxgiIiKSjktfqCgiIiKS9akiJCIiIhZuNGtMREREJMtTRUhEREQsNEZIREREJACoIiQiIiIW+tFVERERkQCgipCIiIhYuPVbYyIiIiJZnypCIiIiYqExQiIiIiIBQImQiIiIBCxdGhMRERELt75QUURERCTrU0VIRERELFz60VURERGRrE8VIREREbHQGCERERGRAKCKkIiIiFhojJCIiIhIAFBFSERERCw0RkhEREQkAKgiJCIiIhYuVYREREREsj5VhERERMTCrVljIiIiIlmfEiERERGxcJk2r93+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IREREbEwNVhaREREJOtTRUhEREQsNEZIREREJACoIiQiIiJWqgiJiIiIZH1KhERERMTCNL13+y/mzZtHkyZNaNCgAZMnT053/+7du3nyySdp3rw5zzzzDKdPn77qNpUIiYiIyE3v6NGjDB06lClTpjBnzhymTZvGX3/9lXq/aZo8//zzdOzYkblz51KqVCnGjBlz1e0qERIREREr04u3a7R69WqqVq1Kzpw5iYiIoFGjRixatCj1/j/++IOIiAhq1aoFQKdOnWjTps1Vt6vB0iIiIuIzCQkJJCQkpFsfFRVFVFRU6nJcXBzR0dGpyzExMWzZsiV1+Z9//iFv3ry8+uqr/Pnnn9xxxx289dZbV31+VYRERETEwjQNr90mTJhA/fr1090mTJhwSZ/Sl48MI212m9Pp5Ndff+WJJ55g3rx5FC5cmEGDBl01VlWERERExGfatWvHQw89lG79xdUggNjYWNavX5+6HBcXR0xMTOpydHQ0t956K2XKlAGgWbNmdO/e/arPr4qQiIiIWHlxjFBUVBSFChVKd7s0EapevTpr1qzhxIkTnD9/niVLlqSOBwIoX748J06cYPv27QAsW7aM0qVLXzVUVYRERETkphcbG0vPnj1p27YtDoeDVq1aUbZsWTp27Ej37t0pU6YMn3zyCb179+b8+fPky5ePDz744KrbNczLXXS7yZ0/XNTXXRAfsRE433Z6OcFG4H52cZhOX3fBp9z/ZXpNFnTUleTrLvhUkUKHvfp8RScN9Npz7Xnida891+UE7llVRERELks/uioiIiISAPyyIhRqBPu6CyLiZYF8WRDgvJns6y74VJgROBWKm0IAXYlVRUhEREQCVmB/xBIREZHLCJwKnCpCIiIiErBUERIRERErjRESERERyfpUERIRERErVYREREREsj5VhERERMRK3ywtIiIikvWpIiQiIiIW/vdz7NdPFSEREREJWKoIiYiIiJUqQiIiIiJZnxIhERERCVi6NCYiIiJWmj4vIiIikvWpIiQiIiIWhgZLi4iIiGR9qgiJiIiIlSpCIiIiIlmfKkIiIiJipVljIiIiIlmfKkIiIiJipTFCIiIiIlmfKkIiIiJipYqQiIiISNanipCIiIhYqSIkIiIikvWpIiQiIiJW+h4hERERkaxPiZCIiIgELF0aExEREQtDg6VFREREsj5VhERERMQq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7ezYsYMdO3awfft2Dh06RKFChVi8eLG3+mmRGYmQiMjNLLMSIX+RWYmQv1AilHmuejWzcOHCFC5cmAYNGqSuS0xMZOfOnZnaMREREfGRm2A2l7dc1/cIRUREcPfdd2dwV0RERES8K6uMbxcREZEMcjN8v4+36Cc2REREJGCpIiQiIiJWqgiJiIiIZH1KhERERCRg6dKYiIiIWOnSmIiIiEjWp4qQiIiIWGj6vIiIiEgAUEVIRERErMxM+OXYm5QqQiIiIhKwVBESERERK40REhEREcn6VBESERERC80aExEREQkAqgiJiIiIlSpCIiIiIlmfKkIiIiJioTFCIiIiIgFAFSERERGxUkVIREREJOtTIiQiIiIBS5fGRERExEqXxkRERESyPlWERERExELT50VEREQCgBIhERERCVhKhERERCRgaYyQiIiIWGmMkIiIiEjWp4qQiIiIWGjWmIiIiEgA8MuK0Lpkh6+74DNhhtPXXfCpJNMvD9kMk9OW7Osu+MwPiSV83QWfujtsn6+74FP7HTG+7oJPPertJ1RFSERERCTrC+yP1yIiIpKeKkIiIiIiWZ8qQiIiImKhWWMiIiIiAUCJkIiIiAQsXRoTERERK10aExEREcn6VBESERERCw2WFhEREQkAqgiJiIiIlSpCIiIiIlmfKkIiIiJipYqQiIiISNanipCIiIhYaNaYiIiISABQRUhERESsVBESERERyfpUERIRERErVYREREREsj5VhERERMRCs8ZEREREAoASIREREQlYujQmIiIiVro0JiIiIpL1qSIkIiIiFhosLSIiInKTmTdvHk2aNKFBgwZMnjz5iu1++ukn6tWrd03bVEVIRERErG7CitDRo0cZOnQo3377LSEhIbRu3ZoqVapw++23W9rFx8fz/vvvX/N2VRESERGRm97q1aupWrUqOXPmJCIigkaNGrFo0aJ07Xr37k3Xrl2vebuqCImIiIiVFytCCQkJJCQkpFsfFRVFVFRU6nJcXBzR0dGpyzExMWzZssXymIkTJ3LnnXdSrly5a35+JUIiIiLiMxMmTGDkyJHp1nft2pVu3bqlLptm+uzMMIzU/+/cuZMlS5bw5ZdfcuTIkWt+fiVCIiIiYmFcvUmGadeuHQ899FC69RdXgwBiY2NZv3596nJcXBwxMTGpy4sWLeLYsWM8/PDDOBwO4uLi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noVRw8LYt9eGAVSp4eTxdimWywsZ4YfEEhm7wQv2rE9i9cQEXE7Ikc9Oo565OH3EyfcjT9FmuOdbazd/d47N353DHgRh2W3UeS4HeW6xvmH+MiWB8wnuTJs+f3fYvkzZ7uZfDWZemD4fU8Ckw8sujh0xGP+RnXcuHPvfz7GxbK5nEHXx0p7p85ce++0bBvPxjMz76oj9jjyZst2d6xwsnZCMywG589to+WI4J4+4mTP8PJ1HZgNg7fwU1s5LwR4M4dkMmj0fRsytngrQ/E/Pky23jTqZfGns0dvXZer2L1Wu+1CvPdfmj3t67bkux+uJUEbIjETIX2RWIuQvMisR8heZlQj5g8xKhPxFZiVC/iKzEiF/4e1E6O5u3kuEfhvh20RI8/xEREQkYAX2x2sRERFJz++uFV0/VYREREQkYKkiJCIiIhY3w09feIsqQiIiIhKwVBESERERK1WERERERLI+VYRERETEQmOERERERAKAKkIiIiJipYqQiIiISNanipCIiIhYqSIkIiIikvUpERIREZGApUtjIiIiYqHp8yIiIiIBQBUhERERsVJFSERERCTrU0VIRERELAwzcEpCqgiJiIhIwFJFSERERKwCpyCkipCIiIgELlWERERExELfIyQiIiISAFQREhEREStVhERERESyPlWERERExEJjhEREREQCgCpCIiIiYqWKkIiIiEjWp0RIREREApYujYmIiIiFBkuLiIiIBAC/rAj1LX+fr7vgM0ZEuK+74FshIb7ugW+FBvu6Bz5lBgXuZ7d58Xf6ugs+5Twa5+su+NSjbi8/oSpCIiI3l0BOgkQk8/hlRUhEREQyj8YIiYiIiAQAVYRERETEygyckpAqQiIiIhKwVBESERERC40REhEREQkAqgiJiIiIlSpCIiIiIlmfKkIiIiJiYXj7m6x9SBUhERERCViqCImIiIiVxgiJiIiIZH1KhERERCRg6dKYiIiIWOgLFUVEREQCgCpCIiIiYqUfXRURERHJ+lQREhEREQuNERIREREJAKoIiYiIiJUqQiIiIiJZnypCIiIiYqExQiIiIiIBQBUhERERsdL3CImIiIhkfaoIiYiIiIXGCImIiIgEAFWERERExEoVIREREZGsT4mQiIiIBCxdGhMRERELDZYWERERCQCqCImIiIiVO3BKQgGdCFVuUIb2fVoSHBLEnj8P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p4qQiIiIWJhm4HxnnSpCIiIiErBUERIRERErjRESERERyfpUERIRERErfY+QiIiISNanREhEREQCli6NiYiIiJVb0+dFREREsjxVhERERMRKg6VFREREsj5VhERERMTC1BghERERkaxPFSERERGx0hghERERkaxPFSERERGx0o+uioiIiGR9qgiJiIiIlalZYyIiIiJZnipCIiIiYmFqjJCIiIhI1qeKkIiIiFhpjJCIiIhI1qdESERERAKWLo2JiIiIhQZLi4iIiAQAVYRERETEKoAGSxumGUA/MSsiIiJyEV0aExERkYClREhEREQClhIhERERCVhKhERERCRgKRESERGRgKVESERERAKWEiEREREJWEqEREREJGApERIREZGApUToP5g3bx5NmjShQYMGTJ482dfd8bqzZ8/SrFkzDhw44OuueN3IkSNp2rQpTZs25YMPPvB1d7xu+PDhNGnShKZNmzJ+/Hhfd8dn3n//fV577TVfd8Pr2rZtS9OmTWnRogUtWrRg8+bNvu6SVy1btoyWLVty//33079/f193RzKYfmvsGh09epShQ4fy7bffEhISQuvWralSpQq33367r7vmFZs3b6Z3797s3bvX113xutWrV7Ny5UpmzZqFYRh06NCBpUuX0qBBA193zSt+/fVXfvnlF+bOnYvT6aRJkybUrl2bYsWK+bprXrVmzRpmzZpFnTp1fN0VrzJNk927d/PTTz8RFBR4bxn79++nb9++zJgxgzx58tCuXTuWL19O7dq1fd01ySCqCF2j1atXU7VqVXLmzElERASNGjVi0aJFvu6W10yfPp2+ffsSExPj6654XXR0NK+99hohISEEBwdz2223cejQIV93y2sqV67MxIkTCQoK4vjx47hcLiIiInzdLa86deoUQ4cOpVOnTr7uitft3r0bwzDo2LEjzZs3Z9KkSb7uklctXbqUJk2akC9fPoKDgxk6dCjlypXzdbckAwVeen+d4uLiiI6OTl2OiYlhy5YtPuyRd7333nu+7oLPFC9ePPX/e/fuZcGCBXz99dc+7JH3BQcH8/HHHzNu3Djuv/9+YmNjfd0lr+rTpw89e/bk8OHDvu6K1yUkJFCtWjX69etHUlISbdu2pWjRotSoUcPXXfOKffv2ERwczDPPPMOxY8eoW7cuPXr08HW3JAOpInSNTNNMt84wDB/0RHxl165dPP3007z66qsUKVLE193xuu7du7NmzRoOHz7M9OnTfd0dr5kxYwb58+enWrVqvu6KT5QvX54PPviAiIgIcufOTatWrVi+fLmvu+U1LpeLNWvWMHjwYKZPn87WrVuZNWuWr7slGUiJ0DWKjY0lPj4+dTkuLi4gLxMFqg0bNvDUU0/x4osv8tBDD/m6O171999/s23bNgDCw8Np2LAhO3bs8HGvvGfBggWsWrWKFi1a8PHHH7Ns2TIGDBjg6255zfr161mzZk3qsmmaATVWKG/evFSrVo3cuXMTFhZG/fr1A+pqQCBQInSNqlevzpo1azhx4gTnz59nyZIl1KpVy9fdEi84fPgwXbp0YciQITRt2tTX3fG6AwcO0Lt3b1JSUkhJSeGHH36gYsWKvu6W14wfP5758+czZ84cunfvTr169XjjjTd83S2vOXPmDB988AHJycmcPXuWWbNmBcxEAYC6deuycuVKEhIScLlcrFixgtKlS/u6W5KBAietv0GxsbH07NmTtm3b4nA4aNWqFWXLlvV1t8QLxo4dS3JyMoMGDUpd17p1ax577DEf9sp7ateuzebNm3nwwQex2+00bNgwIBPCQFW3bt3U/e92u3n88ccpX768r7vlNeXKlaNDhw48/vjjOBwOatSowcMPP+zrbkkGMszLDX4RERERCQC6NCYiIiIBS4mQiIiIBCwlQiIiIhKwlAiJiIhIwFIiJCIiIgFLiZCIiIgELCVCIiIiErCUCInINWncuDG1atVi165dvu6KiEiGUSIkItdk/vz5FClShMWLF/u6KyIiGUaJkIhcE7vdTsWKFQPqB1dFJOvTb42JyDVJSkriu+++Q7/KIyJZiSpCInJNhg4dSmxsLPv37+fcuXO+7o6ISIZQIiQiV7Vp0yYWLVrEiBEjyJ49Ozt37vR1l0REMoQSIRH5V8nJybz++uu8/fbb5MyZk5IlS2qckIhkGUqERORfDR8+nPLly1OnTh0ASpYsyfbt233bKRGRDKJESESuaMuWLSxatIg33ngjdV2pUqVUERKRLMMwNQVEREREApQqQiIiIhKwlAiJiIhIwFIiJCIiIgFLiZCIiIgELCVCIiIiErCUCImIiEjAUiIkIiIiAUuJkIiIiASs/wMU7T7RonvzxQAAAABJRU5ErkJggg==\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter10_53_1.png" - } - }, - "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", - "\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": 12, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "ename": "SyntaxError", - "evalue": "invalid syntax (, line 1)", - "output_type": "error", - "traceback": [ - "\u001b[0;36m File \u001b[0;32m\"\"\u001b[0;36m, line \u001b[0;32m1\u001b[0m\n\u001b[0;31m pip3 install tensorflow\u001b[0m\n\u001b[0m ^\u001b[0m\n\u001b[0;31mSyntaxError\u001b[0m\u001b[0;31m:\u001b[0m invalid syntax\n" - ] - } - ], - "source": [ - "pip3 install tensorflow" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and/or if you use **anaconda**, just write (or install from the graphical user interface)\n", - "(current release of CPU-only TensorFlow)" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "conda create -n tf tensorflow\n", - "conda activate tf" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "To install the current release of GPU TensorFlow" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "conda create -n tf-gpu tensorflow-gpu\n", - "conda activate tf-gpu" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "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 Anaconda installed you may run the following command" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "conda install keras" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "You can look up the [instructions here](https://keras.io/) for more information.\n", - "\n", - "We will to a large extent use **keras** in this course. \n", - "\n", - "\n", - "Let us look again at the MINST data set." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "# import necessary packages\n", - "import numpy as np\n", - "import matplotlib.pyplot as plt\n", - "import tensorflow as tf\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": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "from tensorflow.keras.layers import Input\n", - "from tensorflow.keras.models import Sequential #This allows appending layers to existing models\n", - "from tensorflow.keras.layers import Dense #This allows defining the characteristics of a particular layer\n", - "from tensorflow.keras import optimizers #This allows using whichever optimiser we want (sgd,adam,RMSprop)\n", - "from tensorflow.keras import regularizers #This allows using whichever regularizer we want (l1,l2,l1_l2)\n", - "from tensorflow.keras.utils import to_categorical #This allows using categorical cross entropy as the cost function\n", - "\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": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "\n", - "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)\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=regularizers.l2(lmbd)))\n", - " model.add(Dense(n_neurons_layer2, activation='sigmoid', kernel_regularizer=regularizers.l2(lmbd)))\n", - " model.add(Dense(n_categories, activation='softmax'))\n", - " \n", - " sgd = optimizers.SGD(lr=eta)\n", - " model.compile(loss='categorical_crossentropy', optimizer=sgd, metrics=['accuracy'])\n", - " \n", - " return model" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "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,\n", - " 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": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "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": [ - "## The Breast Cancer Data, now with Keras" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "\n", - "import tensorflow as tf\n", - "from tensorflow.keras.layers import Input\n", - "from tensorflow.keras.models import Sequential #This allows appending layers to existing models\n", - "from tensorflow.keras.layers import Dense #This allows defining the characteristics of a particular layer\n", - "from tensorflow.keras import optimizers #This allows using whichever optimiser we want (sgd,adam,RMSprop)\n", - "from tensorflow.keras import regularizers #This allows using whichever regularizer we want (l1,l2,l1_l2)\n", - "from tensorflow.keras.utils import to_categorical #This allows using categorical cross entropy as the cost function\n", - "import numpy as np\n", - "import matplotlib.pyplot as plt\n", - "import seaborn as sns\n", - "from sklearn.model_selection import train_test_split as splitter\n", - "from sklearn.datasets import load_breast_cancer\n", - "import pickle\n", - "import os \n", - "\n", - "\n", - "\"\"\"Load breast cancer dataset\"\"\"\n", - "\n", - "np.random.seed(0) #create same seed for random number every time\n", - "\n", - "cancer=load_breast_cancer() #Download breast cancer dataset\n", - "\n", - "inputs=cancer.data #Feature matrix of 569 rows (samples) and 30 columns (parameters)\n", - "outputs=cancer.target #Label array of 569 rows (0 for benign and 1 for malignant)\n", - "labels=cancer.feature_names[0:30]\n", - "\n", - "print('The content of the breast cancer dataset is:') #Print information about the datasets\n", - "print(labels)\n", - "print('-------------------------')\n", - "print(\"inputs = \" + str(inputs.shape))\n", - "print(\"outputs = \" + str(outputs.shape))\n", - "print(\"labels = \"+ str(labels.shape))\n", - "\n", - "x=inputs #Reassign the Feature and Label matrices to other variables\n", - "y=outputs\n", - "\n", - "#%% \n", - "\n", - "# Visualisation of dataset (for correlation analysis)\n", - "\n", - "plt.figure()\n", - "plt.scatter(x[:,0],x[:,2],s=40,c=y,cmap=plt.cm.Spectral)\n", - "plt.xlabel('Mean radius',fontweight='bold')\n", - "plt.ylabel('Mean perimeter',fontweight='bold')\n", - "plt.show()\n", - "\n", - "plt.figure()\n", - "plt.scatter(x[:,5],x[:,6],s=40,c=y, cmap=plt.cm.Spectral)\n", - "plt.xlabel('Mean compactness',fontweight='bold')\n", - "plt.ylabel('Mean concavity',fontweight='bold')\n", - "plt.show()\n", - "\n", - "\n", - "plt.figure()\n", - "plt.scatter(x[:,0],x[:,1],s=40,c=y,cmap=plt.cm.Spectral)\n", - "plt.xlabel('Mean radius',fontweight='bold')\n", - "plt.ylabel('Mean texture',fontweight='bold')\n", - "plt.show()\n", - "\n", - "plt.figure()\n", - "plt.scatter(x[:,2],x[:,1],s=40,c=y,cmap=plt.cm.Spectral)\n", - "plt.xlabel('Mean perimeter',fontweight='bold')\n", - "plt.ylabel('Mean compactness',fontweight='bold')\n", - "plt.show()\n", - "\n", - "\n", - "# Generate training and testing datasets\n", - "\n", - "#Select features relevant to classification (texture,perimeter,compactness and symmetery) \n", - "#and add to input matrix\n", - "\n", - "temp1=np.reshape(x[:,1],(len(x[:,1]),1))\n", - "temp2=np.reshape(x[:,2],(len(x[:,2]),1))\n", - "X=np.hstack((temp1,temp2)) \n", - "temp=np.reshape(x[:,5],(len(x[:,5]),1))\n", - "X=np.hstack((X,temp)) \n", - "temp=np.reshape(x[:,8],(len(x[:,8]),1))\n", - "X=np.hstack((X,temp)) \n", - "\n", - "X_train,X_test,y_train,y_test=splitter(X,y,test_size=0.1) #Split datasets into training and testing\n", - "\n", - "y_train=to_categorical(y_train) #Convert labels to categorical when using categorical cross entropy\n", - "y_test=to_categorical(y_test)\n", - "\n", - "del temp1,temp2,temp\n", - "\n", - "# %%\n", - "\n", - "# Define tunable parameters\"\n", - "\n", - "eta=np.logspace(-3,-1,3) #Define vector of learning rates (parameter to SGD optimiser)\n", - "lamda=0.01 #Define hyperparameter\n", - "n_layers=2 #Define number of hidden layers in the model\n", - "n_neuron=np.logspace(0,3,4,dtype=int) #Define number of neurons per layer\n", - "epochs=100 #Number of reiterations over the input data\n", - "batch_size=100 #Number of samples per gradient update\n", - "\n", - "# %%\n", - "\n", - "\"\"\"Define function to return Deep Neural Network model\"\"\"\n", - "\n", - "def NN_model(inputsize,n_layers,n_neuron,eta,lamda):\n", - " model=Sequential() \n", - " for i in range(n_layers): #Run loop to add hidden layers to the model\n", - " if (i==0): #First layer requires input dimensions\n", - " model.add(Dense(n_neuron,activation='relu',kernel_regularizer=regularizers.l2(lamda),input_dim=inputsize))\n", - " else: #Subsequent layers are capable of automatic shape inferencing\n", - " model.add(Dense(n_neuron,activation='relu',kernel_regularizer=regularizers.l2(lamda)))\n", - " model.add(Dense(2,activation='softmax')) #2 outputs - ordered and disordered (softmax for prob)\n", - " sgd=optimizers.SGD(lr=eta)\n", - " model.compile(loss='categorical_crossentropy',optimizer=sgd,metrics=['accuracy'])\n", - " return model\n", - "\n", - " \n", - "Train_accuracy=np.zeros((len(n_neuron),len(eta))) #Define matrices to store accuracy scores as a function\n", - "Test_accuracy=np.zeros((len(n_neuron),len(eta))) #of learning rate and number of hidden neurons for \n", - "\n", - "for i in range(len(n_neuron)): #run loops over hidden neurons and learning rates to calculate \n", - " for j in range(len(eta)): #accuracy scores \n", - " DNN_model=NN_model(X_train.shape[1],n_layers,n_neuron[i],eta[j],lamda)\n", - " DNN_model.fit(X_train,y_train,epochs=epochs,batch_size=batch_size,verbose=1)\n", - " Train_accuracy[i,j]=DNN_model.evaluate(X_train,y_train)[1]\n", - " Test_accuracy[i,j]=DNN_model.evaluate(X_test,y_test)[1]\n", - " \n", - "\n", - "def plot_data(x,y,data,title=None):\n", - "\n", - " # plot results\n", - " fontsize=16\n", - "\n", - "\n", - " fig = plt.figure()\n", - " ax = fig.add_subplot(111)\n", - " cax = ax.matshow(data, interpolation='nearest', vmin=0, vmax=1)\n", - " \n", - " cbar=fig.colorbar(cax)\n", - " cbar.ax.set_ylabel('accuracy (%)',rotation=90,fontsize=fontsize)\n", - " cbar.set_ticks([0,.2,.4,0.6,0.8,1.0])\n", - " cbar.set_ticklabels(['0%','20%','40%','60%','80%','100%'])\n", - "\n", - " # put text on matrix elements\n", - " for i, x_val in enumerate(np.arange(len(x))):\n", - " for j, y_val in enumerate(np.arange(len(y))):\n", - " c = \"${0:.1f}\\\\%$\".format( 100*data[j,i]) \n", - " ax.text(x_val, y_val, c, va='center', ha='center')\n", - "\n", - " # convert axis vaues to to string labels\n", - " x=[str(i) for i in x]\n", - " y=[str(i) for i in y]\n", - "\n", - "\n", - " ax.set_xticklabels(['']+x)\n", - " ax.set_yticklabels(['']+y)\n", - "\n", - " ax.set_xlabel('$\\\\mathrm{learning\\\\ rate}$',fontsize=fontsize)\n", - " ax.set_ylabel('$\\\\mathrm{hidden\\\\ neurons}$',fontsize=fontsize)\n", - " if title is not None:\n", - " ax.set_title(title)\n", - "\n", - " plt.tight_layout()\n", - "\n", - " plt.show()\n", - " \n", - "plot_data(eta,n_neuron,Train_accuracy, 'training')\n", - "plot_data(eta,n_neuron,Test_accuracy, 'testing')" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Fine-tuning neural network hyperparameters\n", - "\n", - "The flexibility of neural networks is also one of their main\n", - "drawbacks: there are many hyperparameters to tweak. Not only can you\n", - "use any imaginable network topology (how neurons/nodes are interconnected),\n", - "but even in a simple FFNN you can change the number of layers, the\n", - "number of neurons per layer, the type of activation function to use in\n", - "each layer, the weight initialization logic, the stochastic gradient optmized and much more. How do you\n", - "know what combination of hyperparameters is the best for your task?\n", - "\n", - "* You can use grid search with cross-validation to find the right hyperparameters.\n", - "\n", - "However,since there are many hyperparameters to tune, and since\n", - "training a neural network on a large dataset takes a lot of time, you\n", - "will only be able to explore a tiny part of the hyperparameter space.\n", - "\n", - "\n", - "* You can use randomized search.\n", - "\n", - "* Or use tools like [Oscar](http://oscar.calldesk.ai/), which implements more complex algorithms to help you find a good set of hyperparameters quickly. \n", - "\n", - "For many problems you can start with just one or two hidden layers and it will work just fine.\n", - "For the MNIST data set you ca easily get a high accuracy using just one hidden layer with a\n", - "few hundred neurons.\n", - "You can reach for this data set above 98% accuracy using two hidden layers with the same total amount of\n", - "neurons, in roughly the same amount of training time. \n", - "\n", - "For more complex problems, you can gradually\n", - "ramp up the number of hidden layers, until you start overfitting the training set. Very complex tasks, such\n", - "as large image classification or speech recognition, typically require networks with dozens of layers\n", - "and they need a huge amount\n", - "of training data. However, you will rarely have to train such networks from scratch: it is much more\n", - "common to reuse parts of a pretrained state-of-the-art network that performs a similar task.\n", - "\n", - "\n", - "\n", - "\n", - "\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", - "\n", - "\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", - "\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": [ - "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", - "\n", - "In most cases you can use the ReLU activation function in the hidden layers (or one of its variants).\n", - "\n", - "It is a bit faster to compute than other activation functions, and the gradient descent optimization does in general not get stuck.\n", - "\n", - "**For the output layer:**\n", - "\n", - "* For classification the softmax activation function is generally a good choice for classification tasks (when the classes are mutually exclusive).\n", - "\n", - "* For regression tasks, you can simply use no activation function at all.\n", - "\n", - "## Batch Normalization\n", - "\n", - "Batch Normalization\n", - "aims to address the vanishing/exploding gradients problems, and more generally the problem that the\n", - "distribution of each layer’s inputs changes during training, as the parameters of the previous layers change.\n", - "\n", - "The technique consists of adding an operation in the model just before the activation function of each\n", - "layer, simply zero-centering and normalizing the inputs, then scaling and shifting the result using two new\n", - "parameters per layer (one for scaling, the other for shifting). In other words, this operation lets the model\n", - "learn the optimal scale and mean of the inputs for each layer.\n", - "In order to zero-center and normalize the inputs, the algorithm needs to estimate the inputs’ mean and\n", - "standard deviation. It does so by evaluating the mean and standard deviation of the inputs over the current\n", - "mini-batch, from this the name batch normalization.\n", - "\n", - "## Dropout\n", - "\n", - "It is a fairly simple algorithm: at every training step, every neuron (including the input neurons but\n", - "excluding the output neurons) has a probability $p$ of being temporarily dropped out, meaning it will be\n", - "entirely ignored during this training step, but it may be active during the next step.\n", - "\n", - "The\n", - "hyperparameter $p$ is called the dropout rate, and it is typically set to 50%. After training, the neurons are not dropped anymore.\n", - " It is viewed as one of the most popular regularization techniques.\n", - "\n", - "## Gradient Clipping\n", - "\n", - "A popular technique to lessen the exploding gradients problem is to simply clip the gradients during\n", - "backpropagation so that they never exceed some threshold (this is mostly useful for recurrent neural\n", - "networks).\n", - "\n", - "This technique is called Gradient Clipping.\n", - "\n", - "In general however, Batch\n", - "Normalization is preferred.\n", - "\n", - "\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", - "\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": { - "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.8.5" - } - }, - "nbformat": 4, - "nbformat_minor": 4 -} \ No newline at end of file diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter10.py b/doc/LectureNotes/_build/jupyter_execute/chapter10.py deleted file mode 100644 index dfcd72372..000000000 --- a/doc/LectureNotes/_build/jupyter_execute/chapter10.py +++ /dev/null @@ -1,1569 +0,0 @@ -# Building a Feed Forward Neural Network - -We are now gong to develop an example based on the MNIST data -base. This is a classification problem and we need to use our -cross-entropy function we discussed in connection with logistic -regression. The cross-entropy defines our cost function for the -classificaton problems with neural networks. - -In binary classification with two classes $(0, 1)$ we define the -logistic/sigmoid function as the probability that a particular input -is in class $0$ or $1$. This is possible because the logistic -function takes any input from the real numbers and inputs a number -between 0 and 1, and can therefore be interpreted as a probability. It -also has other nice properties, such as a derivative that is simple to -calculate. - -For an input $\boldsymbol{a}$ from the hidden layer, the probability that the input $\boldsymbol{x}$ -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$ -represents our activation values $z$. We have - -$$ -P(y = 0 \mid \hat{x}, \hat{\theta}) = \frac{1}{1 + \exp{(- \hat{x}})} , -$$ - -and - -$$ -P(y = 1 \mid \hat{x}, \hat{\theta}) = 1 - P(y = 0 \mid \hat{x}, \hat{\theta}) , -$$ - -where $y \in \{0, 1\}$ and $\hat{\theta}$ represents the weights and biases -of our network. - - - -## Defining the cost function - -Our cost function is given as (see the Logistic regression lectures) - -$$ -\mathcal{C}(\hat{\theta}) = - \ln P(\mathcal{D} \mid \hat{\theta}) = - \sum_{i=1}^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}) . -$$ - -This last equality means that we can interpret our *cost* function as a sum over the *loss* function -for each point in the dataset $\mathcal{L}_i(\hat{\theta})$. -The negative sign is just so that we can think about our algorithm as minimizing a positive number, rather -than maximizing a negative number. - -In *multiclass* classification it is common to treat each integer label as a so called *one-hot* vector: - -$y = 5 \quad \rightarrow \quad \hat{y} = (0, 0, 0, 0, 0, 1, 0, 0, 0, 0) ,$ and - - -$y = 1 \quad \rightarrow \quad \hat{y} = (0, 1, 0, 0, 0, 0, 0, 0, 0, 0) ,$ - - -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$).. - -If $\hat{x}_i$ is the $i$-th input (image), $y_{ic}$ refers to the $c$-th component of the $i$-th -output vector $\hat{y}_i$. -The probability of $\hat{x}_i$ being in class $c$ will be given by the softmax function: - -$$ -P(y_{ic} = 1 \mid \hat{x}_i, \hat{\theta}) = \frac{\exp{((\hat{a}_i^{hidden})^T \hat{w}_c)}} -{\sum_{c'=0}^{C-1} \exp{((\hat{a}_i^{hidden})^T \hat{w}_{c'})}} , -$$ - -which reduces to the logistic function in the binary case. -The likelihood of this $C$-class classifier -is now given as: - -$$ -P(\mathcal{D} \mid \hat{\theta}) = \prod_{i=1}^n \prod_{c=0}^{C-1} [P(y_{ic} = 1)]^{y_{ic}} . -$$ - -Again we take the negative log-likelihood to define our cost function: - -$$ -\mathcal{C}(\hat{\theta}) = - \log{P(\mathcal{D} \mid \hat{\theta})}. -$$ - -See the logistic regression lectures for a full definition of the cost function. - -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! - - -### Example: binary classification problem - -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 - -$$ -\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), -$$ - -where we had defined the logistic (sigmoid) function - -$$ -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)}}, -$$ - -and - -$$ -p(y_i =0\vert x_i,\hat{\beta})=1-p(y_i =1\vert x_i,\hat{\beta}). -$$ - -The parameters $\hat{\beta}$ were defined using a minimization method like gradient descent or Newton-Raphson's method. - -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$. -We have then - -$$ -a_i^l = y_i = \frac{\exp{(z_i^l)}}{1+\exp{(z_i^l)}}, -$$ - -with - -$$ -z_i^l = \sum_{j}w_{ij}^l a_j^{l-1}+b_i^l, -$$ - -where the superscript $l-1$ indicates that these are the outputs from layer $l-1$. -Our cost function at the final layer $l=L$ is now - -$$ -\mathcal{C}(\hat{W}) = - \sum_{i=1}^n \left(t_i\log{a_i^L}+(1-t_i)\log{(1-a_i^L)}\right), -$$ - -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 - -$$ -\frac{\partial \mathcal{C}(\hat{W})}{\partial a_i^L} = \frac{a_i^L-t_i}{a_i^L(1-a_i^L)}. -$$ - -In case we use another activation function than the logistic one, we need to evaluate other derivatives. - - - -### The Softmax function - -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 - -$$ -\frac{\partial f(z_i^l)}{\partial w_{jk}^l} = -\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}. -$$ - -For the Softmax function we have - -$$ -f(z_i^l) = \frac{\exp{(z_i^l)}}{\sum_{m=1}^K\exp{(z_m^l)}}. -$$ - -Its derivative with respect to $z_j^l$ gives - -$$ -\frac{\partial f(z_i^l)}{\partial z_j^l}= f(z_i^l)\left(\delta_{ij}-f(z_j^l)\right), -$$ - -which in case of the simply binary model reduces to having $i=j$. - - -## Developing a code for doing neural networks with back propagation - - -One can identify a set of key steps when using neural networks to solve supervised learning problems: - -1. Collect and pre-process data - -2. Define model and architecture - -3. Choose cost function and optimizer - -4. Train the model - -5. Evaluate model performance on test data - -6. Adjust hyperparameters (if necessary, network architecture) - -### Collect and pre-process data - -Here we will be using the MNIST dataset, which is readily available through the **scikit-learn** -package. You may also find it for example [here](http://yann.lecun.com/exdb/mnist/). -The *MNIST* (Modified National Institute of Standards and Technology) database is a large database -of handwritten digits that is commonly used for training various image processing systems. -The MNIST dataset consists of 70 000 images of size $28\times 28$ pixels, each labeled from 0 to 9. -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. - -To feed data into a feed-forward neural network we need to represent -the inputs as a design/feature matrix $X = (n_{inputs}, n_{features})$. Each -row represents an *input*, in this case a handwritten digit, and -each column represents a *feature*, in this case a pixel. The -correct answers, also known as *labels* or *targets* are -represented as a 1D array of integers -$Y = (n_{inputs}) = (5, 3, 1, 8,...)$. - -As an example, say we want to build a neural network using supervised learning to predict Body-Mass Index (BMI) from -measurements of height (in m) -and weight (in kg). If we have measurements of 5 people the design/feature matrix could be for example: - -$$ X = \begin{bmatrix} -1.85 & 81\\ -1.71 & 65\\ -1.95 & 103\\ -1.55 & 42\\ -1.63 & 56 -\end{bmatrix} ,$$ - -and the targets would be: - -$$ Y = (23.7, 22.2, 27.1, 17.5, 21.1) $$ - -Since each input image is a 2D matrix, we need to flatten the image -(i.e. "unravel" the 2D matrix into a 1D array) to turn the data into a -design/feature matrix. This means we lose all spatial information in the -image, such as locality and translational invariance. More complicated -architectures such as Convolutional Neural Networks can take advantage -of such information, and are most commonly applied when analyzing -images. - -%matplotlib inline - -# import necessary packages -import numpy as np -import matplotlib.pyplot as plt -from sklearn import datasets - - -# ensure the same random numbers appear every time -np.random.seed(0) - -# display images in notebook -%matplotlib inline -plt.rcParams['figure.figsize'] = (12,12) - - -# download MNIST dataset -digits = datasets.load_digits() - -# define inputs and labels -inputs = digits.images -labels = digits.target - -print("inputs = (n_inputs, pixel_width, pixel_height) = " + str(inputs.shape)) -print("labels = (n_inputs) = " + str(labels.shape)) - - -# flatten the image -# the value -1 means dimension is inferred from the remaining dimensions: 8x8 = 64 -n_inputs = len(inputs) -inputs = inputs.reshape(n_inputs, -1) -print("X = (n_inputs, n_features) = " + str(inputs.shape)) - - -# choose some random images to display -indices = np.arange(n_inputs) -random_indices = np.random.choice(indices, size=5) - -for i, image in enumerate(digits.images[random_indices]): - plt.subplot(1, 5, i+1) - plt.axis('off') - plt.imshow(image, cmap=plt.cm.gray_r, interpolation='nearest') - plt.title("Label: %d" % digits.target[random_indices[i]]) -plt.show() - -### Train and test datasets - -Performing analysis before partitioning the dataset is a major error, that can lead to incorrect conclusions. - -We will reserve $80 \%$ of our dataset for training and $20 \%$ for testing. - -It is important that the train and test datasets are drawn randomly from our dataset, to ensure -no bias in the sampling. -Say you are taking measurements of weather data to predict the weather in the coming 5 days. -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 -collected from 12.00 to 24.00. - -from sklearn.model_selection import train_test_split - -# one-liner from scikit-learn library -train_size = 0.8 -test_size = 1 - train_size -X_train, X_test, Y_train, Y_test = train_test_split(inputs, labels, train_size=train_size, - test_size=test_size) - -# equivalently in numpy -def train_test_split_numpy(inputs, labels, train_size, test_size): - n_inputs = len(inputs) - inputs_shuffled = inputs.copy() - labels_shuffled = labels.copy() - - np.random.shuffle(inputs_shuffled) - np.random.shuffle(labels_shuffled) - - train_end = int(n_inputs*train_size) - X_train, X_test = inputs_shuffled[:train_end], inputs_shuffled[train_end:] - Y_train, Y_test = labels_shuffled[:train_end], labels_shuffled[train_end:] - - return X_train, X_test, Y_train, Y_test - -#X_train, X_test, Y_train, Y_test = train_test_split_numpy(inputs, labels, train_size, test_size) - -print("Number of training images: " + str(len(X_train))) -print("Number of test images: " + str(len(X_test))) - -### Define model and architecture - -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 - -$$ z = \sum_{i=1}^n w_i a_i ,$$ - -$$ y = f(z) ,$$ - -where $f$ is the activation function, $a_i$ represents input from neuron $i$ in the preceding layer -and $w_i$ is the weight to input $i$. -The activation of the neurons in the input layer is just the features (e.g. a pixel value). - -The simplest activation function for a neuron is the *Heaviside* function: - -$$ f(z) = -\begin{cases} -1, & z > 0\\ -0, & \text{otherwise} -\end{cases} -$$ - -A feed-forward neural network with this activation is known as a *perceptron*. -For a binary classifier (i.e. two classes, 0 or 1, dog or not-dog) we can also use this in our output layer. -This activation can be generalized to $k$ classes (using e.g. the *one-against-all* strategy), -and we call these architectures *multiclass perceptrons*. - -However, it is now common to use the terms Single Layer Perceptron (SLP) (1 hidden layer) and -Multilayer Perceptron (MLP) (2 or more hidden layers) to refer to feed-forward neural networks with any activation function. - -Typical choices for activation functions include the sigmoid function, hyperbolic tangent, and Rectified Linear Unit (ReLU). -We will be using the sigmoid function $\sigma(x)$: - -$$ f(x) = \sigma(x) = \frac{1}{1 + e^{-x}} ,$$ - -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. - -### Layers - -* Input - -Since each input image has 8x8 = 64 pixels or features, we have an input layer of 64 neurons. - -* Hidden layer - -We will use 50 neurons in the hidden layer receiving input from the neurons in the input layer. -Since each neuron in the hidden layer is connected to the 64 inputs we have 64x50 = 3200 weights to the hidden layer. - -* Output - -If we were building a binary classifier, it would be sufficient with a single neuron in the output layer, -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. - -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. - -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: - -$$ P(\text{class $j$} \mid \text{input $\hat{a}$}) = \frac{\exp{(\hat{a}^T \hat{w}_j)}} -{\sum_{c=0}^{9} \exp{(\hat{a}^T \hat{w}_c)}} ,$$ - -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. -The denominator is a normalization factor to ensure the outputs (probabilities) sum up to 1. -The exponent is just the weighted sum of inputs as before: - -$$ z_j = \sum_{i=1}^n w_ {ij} a_i+b_j.$$ - -Since each neuron in the output layer is connected to the 50 inputs from the hidden layer we have 50x10 = 500 -weights to the output layer. - - -Typically weights are initialized with small values distributed around zero, drawn from a uniform -or normal distribution. Setting all weights to zero means all neurons give the same output, making the network useless. - -Adding a bias value to the weighted sum of inputs allows the neural network to represent a greater range -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$: - -$$ z_j = \sum_{i=1}^n w_ {ij} a_i + b_j.$$ - -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. - -# building our neural network - -n_inputs, n_features = X_train.shape -n_hidden_neurons = 50 -n_categories = 10 - -# we make the weights normally distributed using numpy.random.randn - -# weights and bias in the hidden layer -hidden_weights = np.random.randn(n_features, n_hidden_neurons) -hidden_bias = np.zeros(n_hidden_neurons) + 0.01 - -# weights and bias in the output layer -output_weights = np.random.randn(n_hidden_neurons, n_categories) -output_bias = np.zeros(n_categories) + 0.01 - -### Feed-forward pass - -Denote $F$ the number of features, $H$ the number of hidden neurons and $C$ the number of categories. -For each input image we calculate a weighted sum of input features (pixel values) to each neuron $j$ in the hidden layer $l$: - -$$ z_{j}^{l} = \sum_{i=1}^{F} w_{ij}^{l} x_i + b_{j}^{l},$$ - -this is then passed through our activation function - -$$ a_{j}^{l} = f(z_{j}^{l}) .$$ - -We calculate a weighted sum of inputs (activations in the hidden layer) to each neuron $j$ in the output layer: - -$$ z_{j}^{L} = \sum_{i=1}^{H} w_{ij}^{L} a_{i}^{l} + b_{j}^{L}.$$ - -Finally we calculate the output of neuron $j$ in the output layer using the softmax function: - -$$ a_{j}^{L} = \frac{\exp{(z_j^{L})}} -{\sum_{c=0}^{C-1} \exp{(z_c^{L})}} .$$ - - -Since our data has the dimensions $X = (n_{inputs}, n_{features})$ and our weights to the hidden -layer have the dimensions -$W_{hidden} = (n_{features}, n_{hidden})$, -we can easily feed the network all our training data in one go by taking the matrix product - -$$ X W^{h} = (n_{inputs}, n_{hidden}),$$ - -and obtain a matrix that holds the weighted sum of inputs to the hidden layer -for each input image and each hidden neuron. -We also add the bias to obtain a matrix of weighted sums to the hidden layer $Z^{h}$: - -$$ \hat{z}^{l} = \hat{X} \hat{W}^{l} + \hat{b}^{l} ,$$ - -meaning the same bias (1D array with size equal number of hidden neurons) is added to each input image. -This is then passed through the activation: - -$$ \hat{a}^{l} = f(\hat{z}^l) .$$ - -This is fed to the output layer: - -$$ \hat{z}^{L} = \hat{a}^{L} \hat{W}^{L} + \hat{b}^{L} .$$ - -Finally we receive our output values for each image and each category by passing it through the softmax function: - -$$ output = softmax (\hat{z}^{L}) = (n_{inputs}, n_{categories}) .$$ - -# setup the feed-forward pass, subscript h = hidden layer - -def sigmoid(x): - return 1/(1 + np.exp(-x)) - -def feed_forward(X): - # weighted sum of inputs to the hidden layer - z_h = np.matmul(X, hidden_weights) + hidden_bias - # activation in the hidden layer - a_h = sigmoid(z_h) - - # weighted sum of inputs to the output layer - z_o = np.matmul(a_h, output_weights) + output_bias - # softmax output - # axis 0 holds each input and axis 1 the probabilities of each category - exp_term = np.exp(z_o) - probabilities = exp_term / np.sum(exp_term, axis=1, keepdims=True) - - return probabilities - -probabilities = feed_forward(X_train) -print("probabilities = (n_inputs, n_categories) = " + str(probabilities.shape)) -print("probability that image 0 is in category 0,1,2,...,9 = \n" + str(probabilities[0])) -print("probabilities sum up to: " + str(probabilities[0].sum())) -print() - -# we obtain a prediction by taking the class with the highest likelihood -def predict(X): - probabilities = feed_forward(X) - return np.argmax(probabilities, axis=1) - -predictions = predict(X_train) -print("predictions = (n_inputs) = " + str(predictions.shape)) -print("prediction for image 0: " + str(predictions[0])) -print("correct label for image 0: " + str(Y_train[0])) - -### Choose cost function and optimizer - -To measure how well our neural network is doing we need to introduce a cost function. -We will call the function that gives the error of a single sample output the *loss* function, and the function -that gives the total error of our network across all samples the *cost* function. -A typical choice for multiclass classification is the *cross-entropy* loss, also known as the negative log likelihood. - -In *multiclass* classification it is common to treat each integer label as a so called *one-hot* vector: - -$$ y = 5 \quad \rightarrow \quad \hat{y} = (0, 0, 0, 0, 0, 1, 0, 0, 0, 0) ,$$ - - -$$ y = 1 \quad \rightarrow \quad \hat{y} = (0, 1, 0, 0, 0, 0, 0, 0, 0, 0) ,$$ - - -i.e. a binary bit string of length $C$, where $C = 10$ is the number of classes in the MNIST dataset. - -Let $y_{ic}$ denote the $c$-th component of the $i$-th one-hot vector. -We define the cost function $\mathcal{C}$ as a sum over the cross-entropy loss for each point $\hat{x}_i$ in the dataset. - -In the one-hot representation only one of the terms in the loss function is non-zero, namely the -probability of the correct category $c'$ -(i.e. the category $c'$ such that $y_{ic'} = 1$). This means that the cross entropy loss only punishes you for how wrong -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. - - - -### Optimizing the cost function - -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 -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. -Each parameter $\theta$ is iteratively adjusted according to the rule - -$$ \theta_{i+1} = \theta_i - \eta \nabla \mathcal{C}(\theta_i) ,$$ - -where $\eta$ is known as the *learning rate*, which controls how big a step we take towards the minimum. -This update can be repeated for any number of iterations, or until we are satisfied with the result. - -A simple and effective improvement is a variant called *Batch Gradient Descent*. -Instead of calculating the gradient on the whole dataset, we calculate an approximation of the gradient -on a subset of the data called a *minibatch*. -If there are $N$ data points and we have a minibatch size of $M$, the total number of batches -is $N/M$. -We denote each minibatch $B_k$, with $k = 1, 2,...,N/M$. The gradient then becomes: - -$$ \nabla \mathcal{C}(\theta) = \frac{1}{N} \sum_{i=1}^N \nabla \mathcal{L}_i(\theta) \quad \rightarrow \quad -\frac{1}{M} \sum_{i \in B_k} \nabla \mathcal{L}_i(\theta) ,$$ - -i.e. instead of averaging the loss over the entire dataset, we average over a minibatch. - -This has two important benefits: -1. Introducing stochasticity decreases the chance that the algorithm becomes stuck in a local minima. - -2. It significantly speeds up the calculation, since we do not have to use the entire dataset to calculate the gradient. - -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). - - -### Regularization - -It is common to add an extra term to the cost function, proportional -to the size of the weights. This is equivalent to constraining the -size of the weights, so that they do not grow out of control. -Constraining the size of the weights means that the weights cannot -grow arbitrarily large to fit the training data, and in this way -reduces *overfitting*. - -We will measure the size of the weights using the so called *L2-norm*, meaning our cost function becomes: - -$$ \mathcal{C}(\theta) = \frac{1}{N} \sum_{i=1}^N \mathcal{L}_i(\theta) \quad \rightarrow \quad -\frac{1}{N} \sum_{i=1}^N \mathcal{L}_i(\theta) + \lambda \lvert \lvert \hat{w} \rvert \rvert_2^2 -= \frac{1}{N} \sum_{i=1}^N \mathcal{L}(\theta) + \lambda \sum_{ij} w_{ij}^2,$$ - -i.e. we sum up all the weights squared. The factor $\lambda$ is known as a regularization parameter. - - -In order to train the model, we need to calculate the derivative of -the cost function with respect to every bias and weight in the -network. In total our network has $(64 + 1)\times 50=3250$ weights in -the hidden layer and $(50 + 1)\times 10=510$ weights to the output -layer ($+1$ for the bias), and the gradient must be calculated for -every parameter. We use the *backpropagation* algorithm discussed -above. This is a clever use of the chain rule that allows us to -calculate the gradient efficently. - - -### Matrix multiplication - -To more efficently train our network these equations are implemented using matrix operations. -The error in the output layer is calculated simply as, with $\hat{t}$ being our targets, - -$$ \delta_L = \hat{t} - \hat{y} = (n_{inputs}, n_{categories}) .$$ - -The gradient for the output weights is calculated as - -$$ \nabla W_{L} = \hat{a}^T \delta_L = (n_{hidden}, n_{categories}) ,$$ - -where $\hat{a} = (n_{inputs}, n_{hidden})$. This simply means that we are summing up the gradients for each input. -Since we are going backwards we have to transpose the activation matrix. - -The gradient with respect to the output bias is then - -$$ \nabla \hat{b}_{L} = \sum_{i=1}^{n_{inputs}} \delta_L = (n_{categories}) .$$ - -The error in the hidden layer is - -$$ \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}) ,$$ - -where $f'(a_{h})$ is the derivative of the activation in the hidden layer. The matrix products mean -that we are summing up the products for each neuron in the output layer. The symbol $\circ$ denotes -the *Hadamard product*, meaning element-wise multiplication. - -This again gives us the gradients in the hidden layer: - -$$ \nabla W_{h} = X^T \delta_h = (n_{features}, n_{hidden}) ,$$ - -$$ \nabla b_{h} = \sum_{i=1}^{n_{inputs}} \delta_h = (n_{hidden}) .$$ - -# to categorical turns our integer vector into a onehot representation -from sklearn.metrics import accuracy_score - -# one-hot in numpy -def to_categorical_numpy(integer_vector): - n_inputs = len(integer_vector) - n_categories = np.max(integer_vector) + 1 - onehot_vector = np.zeros((n_inputs, n_categories)) - onehot_vector[range(n_inputs), integer_vector] = 1 - - return onehot_vector - -#Y_train_onehot, Y_test_onehot = to_categorical(Y_train), to_categorical(Y_test) -Y_train_onehot, Y_test_onehot = to_categorical_numpy(Y_train), to_categorical_numpy(Y_test) - -def feed_forward_train(X): - # weighted sum of inputs to the hidden layer - z_h = np.matmul(X, hidden_weights) + hidden_bias - # activation in the hidden layer - a_h = sigmoid(z_h) - - # weighted sum of inputs to the output layer - z_o = np.matmul(a_h, output_weights) + output_bias - # softmax output - # axis 0 holds each input and axis 1 the probabilities of each category - exp_term = np.exp(z_o) - probabilities = exp_term / np.sum(exp_term, axis=1, keepdims=True) - - # for backpropagation need activations in hidden and output layers - return a_h, probabilities - -def backpropagation(X, Y): - a_h, probabilities = feed_forward_train(X) - - # error in the output layer - error_output = probabilities - Y - # error in the hidden layer - error_hidden = np.matmul(error_output, output_weights.T) * a_h * (1 - a_h) - - # gradients for the output layer - output_weights_gradient = np.matmul(a_h.T, error_output) - output_bias_gradient = np.sum(error_output, axis=0) - - # gradient for the hidden layer - hidden_weights_gradient = np.matmul(X.T, error_hidden) - hidden_bias_gradient = np.sum(error_hidden, axis=0) - - return output_weights_gradient, output_bias_gradient, hidden_weights_gradient, hidden_bias_gradient - -print("Old accuracy on training data: " + str(accuracy_score(predict(X_train), Y_train))) - -eta = 0.01 -lmbd = 0.01 -for i in range(1000): - # calculate gradients - dWo, dBo, dWh, dBh = backpropagation(X_train, Y_train_onehot) - - # regularization term gradients - dWo += lmbd * output_weights - dWh += lmbd * hidden_weights - - # update weights and biases - output_weights -= eta * dWo - output_bias -= eta * dBo - hidden_weights -= eta * dWh - hidden_bias -= eta * dBh - -print("New accuracy on training data: " + str(accuracy_score(predict(X_train), Y_train))) - -## Improving performance - -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. -In order to obtain a network that does something useful, we will have to do a bit more work. - -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}$. - -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 -going through the entire dataset ($n/M$ batches) an *epoch*. - -If this does not improve network performance, you may want to consider altering the network architecture, adding more neurons or hidden layers. -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/). - - -It is very natural to think of the network as an object, with specific instances of the network -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. - -class NeuralNetwork: - def __init__( - self, - X_data, - Y_data, - n_hidden_neurons=50, - n_categories=10, - epochs=10, - batch_size=100, - eta=0.1, - lmbd=0.0): - - self.X_data_full = X_data - self.Y_data_full = Y_data - - self.n_inputs = X_data.shape[0] - self.n_features = X_data.shape[1] - self.n_hidden_neurons = n_hidden_neurons - self.n_categories = n_categories - - self.epochs = epochs - self.batch_size = batch_size - self.iterations = self.n_inputs // self.batch_size - self.eta = eta - self.lmbd = lmbd - - self.create_biases_and_weights() - - def create_biases_and_weights(self): - self.hidden_weights = np.random.randn(self.n_features, self.n_hidden_neurons) - self.hidden_bias = np.zeros(self.n_hidden_neurons) + 0.01 - - self.output_weights = np.random.randn(self.n_hidden_neurons, self.n_categories) - self.output_bias = np.zeros(self.n_categories) + 0.01 - - def feed_forward(self): - # feed-forward for training - self.z_h = np.matmul(self.X_data, self.hidden_weights) + self.hidden_bias - self.a_h = sigmoid(self.z_h) - - self.z_o = np.matmul(self.a_h, self.output_weights) + self.output_bias - - exp_term = np.exp(self.z_o) - self.probabilities = exp_term / np.sum(exp_term, axis=1, keepdims=True) - - def feed_forward_out(self, X): - # feed-forward for output - z_h = np.matmul(X, self.hidden_weights) + self.hidden_bias - a_h = sigmoid(z_h) - - z_o = np.matmul(a_h, self.output_weights) + self.output_bias - - exp_term = np.exp(z_o) - probabilities = exp_term / np.sum(exp_term, axis=1, keepdims=True) - return probabilities - - def backpropagation(self): - error_output = self.probabilities - self.Y_data - error_hidden = np.matmul(error_output, self.output_weights.T) * self.a_h * (1 - self.a_h) - - self.output_weights_gradient = np.matmul(self.a_h.T, error_output) - self.output_bias_gradient = np.sum(error_output, axis=0) - - self.hidden_weights_gradient = np.matmul(self.X_data.T, error_hidden) - self.hidden_bias_gradient = np.sum(error_hidden, axis=0) - - if self.lmbd > 0.0: - self.output_weights_gradient += self.lmbd * self.output_weights - self.hidden_weights_gradient += self.lmbd * self.hidden_weights - - self.output_weights -= self.eta * self.output_weights_gradient - self.output_bias -= self.eta * self.output_bias_gradient - self.hidden_weights -= self.eta * self.hidden_weights_gradient - self.hidden_bias -= self.eta * self.hidden_bias_gradient - - def predict(self, X): - probabilities = self.feed_forward_out(X) - return np.argmax(probabilities, axis=1) - - def predict_probabilities(self, X): - probabilities = self.feed_forward_out(X) - return probabilities - - def train(self): - data_indices = np.arange(self.n_inputs) - - for i in range(self.epochs): - for j in range(self.iterations): - # pick datapoints with replacement - chosen_datapoints = np.random.choice( - data_indices, size=self.batch_size, replace=False - ) - - # minibatch training data - self.X_data = self.X_data_full[chosen_datapoints] - self.Y_data = self.Y_data_full[chosen_datapoints] - - self.feed_forward() - self.backpropagation() - -## Evaluate model performance on test data - -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. -We measure the performance of the network using the *accuracy* score. -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$. - -$$ \text{Accuracy} = \frac{\sum_{i=1}^n I(\hat{y}_i = y_i)}{n} ,$$ - -where $I$ is the indicator function, $1$ if $\hat{y}_i = y_i$ and $0$ otherwise. - -epochs = 100 -batch_size = 100 - -dnn = NeuralNetwork(X_train, Y_train_onehot, eta=eta, lmbd=lmbd, epochs=epochs, batch_size=batch_size, - n_hidden_neurons=n_hidden_neurons, n_categories=n_categories) -dnn.train() -test_predict = dnn.predict(X_test) - -# accuracy score from scikit library -print("Accuracy score on test set: ", accuracy_score(Y_test, test_predict)) - -# equivalent in numpy -def accuracy_score_numpy(Y_test, Y_pred): - return np.sum(Y_test == Y_pred) / len(Y_test) - -#print("Accuracy score on test set: ", accuracy_score_numpy(Y_test, test_predict)) - -## Adjust hyperparameters - -We now perform a grid search to find the optimal hyperparameters for the network. -Note that we are only using 1 layer with 50 neurons, and human performance is estimated to be around $98\%$ ($2\%$ error rate). - -eta_vals = np.logspace(-5, 1, 7) -lmbd_vals = np.logspace(-5, 1, 7) -# store the models for later use -DNN_numpy = np.zeros((len(eta_vals), len(lmbd_vals)), dtype=object) - -# grid search -for i, eta in enumerate(eta_vals): - for j, lmbd in enumerate(lmbd_vals): - dnn = NeuralNetwork(X_train, Y_train_onehot, eta=eta, lmbd=lmbd, epochs=epochs, batch_size=batch_size, - n_hidden_neurons=n_hidden_neurons, n_categories=n_categories) - dnn.train() - - DNN_numpy[i][j] = dnn - - test_predict = dnn.predict(X_test) - - print("Learning rate = ", eta) - print("Lambda = ", lmbd) - print("Accuracy score on test set: ", accuracy_score(Y_test, test_predict)) - print() - -## Visualization - -# visual representation of grid search -# uses seaborn heatmap, you can also do this with matplotlib imshow -import seaborn as sns - -sns.set() - -train_accuracy = np.zeros((len(eta_vals), len(lmbd_vals))) -test_accuracy = np.zeros((len(eta_vals), len(lmbd_vals))) - -for i in range(len(eta_vals)): - for j in range(len(lmbd_vals)): - dnn = DNN_numpy[i][j] - - train_pred = dnn.predict(X_train) - test_pred = dnn.predict(X_test) - - train_accuracy[i][j] = accuracy_score(Y_train, train_pred) - test_accuracy[i][j] = accuracy_score(Y_test, test_pred) - - -fig, ax = plt.subplots(figsize = (10, 10)) -sns.heatmap(train_accuracy, annot=True, ax=ax, cmap="viridis") -ax.set_title("Training Accuracy") -ax.set_ylabel("$\eta$") -ax.set_xlabel("$\lambda$") -plt.show() - -fig, ax = plt.subplots(figsize = (10, 10)) -sns.heatmap(test_accuracy, annot=True, ax=ax, cmap="viridis") -ax.set_title("Test Accuracy") -ax.set_ylabel("$\eta$") -ax.set_xlabel("$\lambda$") -plt.show() - -## scikit-learn implementation - -**scikit-learn** focuses more -on traditional machine learning methods, such as regression, -clustering, decision trees, etc. As such, it has only two types of -neural networks: Multi Layer Perceptron outputting continuous values, -*MPLRegressor*, and Multi Layer Perceptron outputting labels, -*MLPClassifier*. We will see how simple it is to use these classes. - -**scikit-learn** implements a few improvements from our neural network, -such as early stopping, a varying learning rate, different -optimization methods, etc. We would therefore expect a better -performance overall. - -from sklearn.neural_network import MLPClassifier -# store models for later use -DNN_scikit = np.zeros((len(eta_vals), len(lmbd_vals)), dtype=object) - -for i, eta in enumerate(eta_vals): - for j, lmbd in enumerate(lmbd_vals): - dnn = MLPClassifier(hidden_layer_sizes=(n_hidden_neurons), activation='logistic', - alpha=lmbd, learning_rate_init=eta, max_iter=epochs) - dnn.fit(X_train, Y_train) - - DNN_scikit[i][j] = dnn - - print("Learning rate = ", eta) - print("Lambda = ", lmbd) - print("Accuracy score on test set: ", dnn.score(X_test, Y_test)) - print() - -## Visualization - -# optional -# visual representation of grid search -# uses seaborn heatmap, could probably do this in matplotlib -import seaborn as sns - -sns.set() - -train_accuracy = np.zeros((len(eta_vals), len(lmbd_vals))) -test_accuracy = np.zeros((len(eta_vals), len(lmbd_vals))) - -for i in range(len(eta_vals)): - for j in range(len(lmbd_vals)): - dnn = DNN_scikit[i][j] - - train_pred = dnn.predict(X_train) - test_pred = dnn.predict(X_test) - - train_accuracy[i][j] = accuracy_score(Y_train, train_pred) - test_accuracy[i][j] = accuracy_score(Y_test, test_pred) - - -fig, ax = plt.subplots(figsize = (10, 10)) -sns.heatmap(train_accuracy, annot=True, ax=ax, cmap="viridis") -ax.set_title("Training Accuracy") -ax.set_ylabel("$\eta$") -ax.set_xlabel("$\lambda$") -plt.show() - -fig, ax = plt.subplots(figsize = (10, 10)) -sns.heatmap(test_accuracy, annot=True, ax=ax, cmap="viridis") -ax.set_title("Test Accuracy") -ax.set_ylabel("$\eta$") -ax.set_xlabel("$\lambda$") -plt.show() - -## Building neural networks in Tensorflow and Keras - -Now we want to build on the experience gained from our neural network implementation in NumPy and scikit-learn -and use it to construct a neural network in Tensorflow. Once we have constructed a neural network in NumPy -and Tensorflow, building one in Keras is really quite trivial, though the performance may suffer. - -In our previous example we used only one hidden layer, and in this we will use two. From this it should be quite -clear how to build one using an arbitrary number of hidden layers, using data structures such as Python lists or -NumPy arrays. - - -Tensorflow is an open source library machine learning library -developed by the Google Brain team for internal use. It was released -under the Apache 2.0 open source license in November 9, 2015. - -Tensorflow is a computational framework that allows you to construct -machine learning models at different levels of abstraction, from -high-level, object-oriented APIs like Keras, down to the C++ kernels -that Tensorflow is built upon. The higher levels of abstraction are -simpler to use, but less flexible, and our choice of implementation -should reflect the problems we are trying to solve. - -[Tensorflow uses](https://www.tensorflow.org/guide/graphs) so-called graphs to represent your computation -in terms of the dependencies between individual operations, such that you first build a Tensorflow *graph* -to represent your model, and then create a Tensorflow *session* to run the graph. - -In this guide we will analyze the same data as we did in our NumPy and -scikit-learn tutorial, gathered from the MNIST database of images. We -will give an introduction to the lower level Python Application -Program Interfaces (APIs), and see how we use them to build our graph. -Then we will build (effectively) the same graph in Keras, to see just -how simple solving a machine learning problem can be. - -To install tensorflow on Unix/Linux systems, use pip as - -pip3 install tensorflow - -and/or if you use **anaconda**, just write (or install from the graphical user interface) -(current release of CPU-only TensorFlow) - -conda create -n tf tensorflow -conda activate tf - -To install the current release of GPU TensorFlow - -conda create -n tf-gpu tensorflow-gpu -conda activate tf-gpu - -Keras is a high level [neural network](https://en.wikipedia.org/wiki/Application_programming_interface) -that supports Tensorflow, CTNK and Theano as backends. -If you have Anaconda installed you may run the following command - -conda install keras - -You can look up the [instructions here](https://keras.io/) for more information. - -We will to a large extent use **keras** in this course. - - -Let us look again at the MINST data set. - -# import necessary packages -import numpy as np -import matplotlib.pyplot as plt -import tensorflow as tf -from sklearn import datasets - - -# ensure the same random numbers appear every time -np.random.seed(0) - -# display images in notebook -%matplotlib inline -plt.rcParams['figure.figsize'] = (12,12) - - -# download MNIST dataset -digits = datasets.load_digits() - -# define inputs and labels -inputs = digits.images -labels = digits.target - -print("inputs = (n_inputs, pixel_width, pixel_height) = " + str(inputs.shape)) -print("labels = (n_inputs) = " + str(labels.shape)) - - -# flatten the image -# the value -1 means dimension is inferred from the remaining dimensions: 8x8 = 64 -n_inputs = len(inputs) -inputs = inputs.reshape(n_inputs, -1) -print("X = (n_inputs, n_features) = " + str(inputs.shape)) - - -# choose some random images to display -indices = np.arange(n_inputs) -random_indices = np.random.choice(indices, size=5) - -for i, image in enumerate(digits.images[random_indices]): - plt.subplot(1, 5, i+1) - plt.axis('off') - plt.imshow(image, cmap=plt.cm.gray_r, interpolation='nearest') - plt.title("Label: %d" % digits.target[random_indices[i]]) -plt.show() - -from tensorflow.keras.layers import Input -from tensorflow.keras.models import Sequential #This allows appending layers to existing models -from tensorflow.keras.layers import Dense #This allows defining the characteristics of a particular layer -from tensorflow.keras import optimizers #This allows using whichever optimiser we want (sgd,adam,RMSprop) -from tensorflow.keras import regularizers #This allows using whichever regularizer we want (l1,l2,l1_l2) -from tensorflow.keras.utils import to_categorical #This allows using categorical cross entropy as the cost function - -from sklearn.model_selection import train_test_split - -# one-hot representation of labels -labels = to_categorical(labels) - -# split into train and test data -train_size = 0.8 -test_size = 1 - train_size -X_train, X_test, Y_train, Y_test = train_test_split(inputs, labels, train_size=train_size, - test_size=test_size) - - -epochs = 100 -batch_size = 100 -n_neurons_layer1 = 100 -n_neurons_layer2 = 50 -n_categories = 10 -eta_vals = np.logspace(-5, 1, 7) -lmbd_vals = np.logspace(-5, 1, 7) -def create_neural_network_keras(n_neurons_layer1, n_neurons_layer2, n_categories, eta, lmbd): - model = Sequential() - model.add(Dense(n_neurons_layer1, activation='sigmoid', kernel_regularizer=regularizers.l2(lmbd))) - model.add(Dense(n_neurons_layer2, activation='sigmoid', kernel_regularizer=regularizers.l2(lmbd))) - model.add(Dense(n_categories, activation='softmax')) - - sgd = optimizers.SGD(lr=eta) - model.compile(loss='categorical_crossentropy', optimizer=sgd, metrics=['accuracy']) - - return model - -DNN_keras = np.zeros((len(eta_vals), len(lmbd_vals)), dtype=object) - -for i, eta in enumerate(eta_vals): - for j, lmbd in enumerate(lmbd_vals): - DNN = create_neural_network_keras(n_neurons_layer1, n_neurons_layer2, n_categories, - eta=eta, lmbd=lmbd) - DNN.fit(X_train, Y_train, epochs=epochs, batch_size=batch_size, verbose=0) - scores = DNN.evaluate(X_test, Y_test) - - DNN_keras[i][j] = DNN - - print("Learning rate = ", eta) - print("Lambda = ", lmbd) - print("Test accuracy: %.3f" % scores[1]) - print() - -# optional -# visual representation of grid search -# uses seaborn heatmap, could probably do this in matplotlib -import seaborn as sns - -sns.set() - -train_accuracy = np.zeros((len(eta_vals), len(lmbd_vals))) -test_accuracy = np.zeros((len(eta_vals), len(lmbd_vals))) - -for i in range(len(eta_vals)): - for j in range(len(lmbd_vals)): - DNN = DNN_keras[i][j] - - train_accuracy[i][j] = DNN.evaluate(X_train, Y_train)[1] - test_accuracy[i][j] = DNN.evaluate(X_test, Y_test)[1] - - -fig, ax = plt.subplots(figsize = (10, 10)) -sns.heatmap(train_accuracy, annot=True, ax=ax, cmap="viridis") -ax.set_title("Training Accuracy") -ax.set_ylabel("$\eta$") -ax.set_xlabel("$\lambda$") -plt.show() - -fig, ax = plt.subplots(figsize = (10, 10)) -sns.heatmap(test_accuracy, annot=True, ax=ax, cmap="viridis") -ax.set_title("Test Accuracy") -ax.set_ylabel("$\eta$") -ax.set_xlabel("$\lambda$") -plt.show() - -## The Breast Cancer Data, now with Keras - - -import tensorflow as tf -from tensorflow.keras.layers import Input -from tensorflow.keras.models import Sequential #This allows appending layers to existing models -from tensorflow.keras.layers import Dense #This allows defining the characteristics of a particular layer -from tensorflow.keras import optimizers #This allows using whichever optimiser we want (sgd,adam,RMSprop) -from tensorflow.keras import regularizers #This allows using whichever regularizer we want (l1,l2,l1_l2) -from tensorflow.keras.utils import to_categorical #This allows using categorical cross entropy as the cost function -import numpy as np -import matplotlib.pyplot as plt -import seaborn as sns -from sklearn.model_selection import train_test_split as splitter -from sklearn.datasets import load_breast_cancer -import pickle -import os - - -"""Load breast cancer dataset""" - -np.random.seed(0) #create same seed for random number every time - -cancer=load_breast_cancer() #Download breast cancer dataset - -inputs=cancer.data #Feature matrix of 569 rows (samples) and 30 columns (parameters) -outputs=cancer.target #Label array of 569 rows (0 for benign and 1 for malignant) -labels=cancer.feature_names[0:30] - -print('The content of the breast cancer dataset is:') #Print information about the datasets -print(labels) -print('-------------------------') -print("inputs = " + str(inputs.shape)) -print("outputs = " + str(outputs.shape)) -print("labels = "+ str(labels.shape)) - -x=inputs #Reassign the Feature and Label matrices to other variables -y=outputs - -#%% - -# Visualisation of dataset (for correlation analysis) - -plt.figure() -plt.scatter(x[:,0],x[:,2],s=40,c=y,cmap=plt.cm.Spectral) -plt.xlabel('Mean radius',fontweight='bold') -plt.ylabel('Mean perimeter',fontweight='bold') -plt.show() - -plt.figure() -plt.scatter(x[:,5],x[:,6],s=40,c=y, cmap=plt.cm.Spectral) -plt.xlabel('Mean compactness',fontweight='bold') -plt.ylabel('Mean concavity',fontweight='bold') -plt.show() - - -plt.figure() -plt.scatter(x[:,0],x[:,1],s=40,c=y,cmap=plt.cm.Spectral) -plt.xlabel('Mean radius',fontweight='bold') -plt.ylabel('Mean texture',fontweight='bold') -plt.show() - -plt.figure() -plt.scatter(x[:,2],x[:,1],s=40,c=y,cmap=plt.cm.Spectral) -plt.xlabel('Mean perimeter',fontweight='bold') -plt.ylabel('Mean compactness',fontweight='bold') -plt.show() - - -# Generate training and testing datasets - -#Select features relevant to classification (texture,perimeter,compactness and symmetery) -#and add to input matrix - -temp1=np.reshape(x[:,1],(len(x[:,1]),1)) -temp2=np.reshape(x[:,2],(len(x[:,2]),1)) -X=np.hstack((temp1,temp2)) -temp=np.reshape(x[:,5],(len(x[:,5]),1)) -X=np.hstack((X,temp)) -temp=np.reshape(x[:,8],(len(x[:,8]),1)) -X=np.hstack((X,temp)) - -X_train,X_test,y_train,y_test=splitter(X,y,test_size=0.1) #Split datasets into training and testing - -y_train=to_categorical(y_train) #Convert labels to categorical when using categorical cross entropy -y_test=to_categorical(y_test) - -del temp1,temp2,temp - -# %% - -# Define tunable parameters" - -eta=np.logspace(-3,-1,3) #Define vector of learning rates (parameter to SGD optimiser) -lamda=0.01 #Define hyperparameter -n_layers=2 #Define number of hidden layers in the model -n_neuron=np.logspace(0,3,4,dtype=int) #Define number of neurons per layer -epochs=100 #Number of reiterations over the input data -batch_size=100 #Number of samples per gradient update - -# %% - -"""Define function to return Deep Neural Network model""" - -def NN_model(inputsize,n_layers,n_neuron,eta,lamda): - model=Sequential() - for i in range(n_layers): #Run loop to add hidden layers to the model - if (i==0): #First layer requires input dimensions - model.add(Dense(n_neuron,activation='relu',kernel_regularizer=regularizers.l2(lamda),input_dim=inputsize)) - else: #Subsequent layers are capable of automatic shape inferencing - model.add(Dense(n_neuron,activation='relu',kernel_regularizer=regularizers.l2(lamda))) - model.add(Dense(2,activation='softmax')) #2 outputs - ordered and disordered (softmax for prob) - sgd=optimizers.SGD(lr=eta) - model.compile(loss='categorical_crossentropy',optimizer=sgd,metrics=['accuracy']) - return model - - -Train_accuracy=np.zeros((len(n_neuron),len(eta))) #Define matrices to store accuracy scores as a function -Test_accuracy=np.zeros((len(n_neuron),len(eta))) #of learning rate and number of hidden neurons for - -for i in range(len(n_neuron)): #run loops over hidden neurons and learning rates to calculate - for j in range(len(eta)): #accuracy scores - DNN_model=NN_model(X_train.shape[1],n_layers,n_neuron[i],eta[j],lamda) - DNN_model.fit(X_train,y_train,epochs=epochs,batch_size=batch_size,verbose=1) - Train_accuracy[i,j]=DNN_model.evaluate(X_train,y_train)[1] - Test_accuracy[i,j]=DNN_model.evaluate(X_test,y_test)[1] - - -def plot_data(x,y,data,title=None): - - # plot results - fontsize=16 - - - fig = plt.figure() - ax = fig.add_subplot(111) - cax = ax.matshow(data, interpolation='nearest', vmin=0, vmax=1) - - cbar=fig.colorbar(cax) - cbar.ax.set_ylabel('accuracy (%)',rotation=90,fontsize=fontsize) - cbar.set_ticks([0,.2,.4,0.6,0.8,1.0]) - cbar.set_ticklabels(['0%','20%','40%','60%','80%','100%']) - - # put text on matrix elements - for i, x_val in enumerate(np.arange(len(x))): - for j, y_val in enumerate(np.arange(len(y))): - c = "${0:.1f}\\%$".format( 100*data[j,i]) - ax.text(x_val, y_val, c, va='center', ha='center') - - # convert axis vaues to to string labels - x=[str(i) for i in x] - y=[str(i) for i in y] - - - ax.set_xticklabels(['']+x) - ax.set_yticklabels(['']+y) - - ax.set_xlabel('$\\mathrm{learning\\ rate}$',fontsize=fontsize) - ax.set_ylabel('$\\mathrm{hidden\\ neurons}$',fontsize=fontsize) - if title is not None: - ax.set_title(title) - - plt.tight_layout() - - plt.show() - -plot_data(eta,n_neuron,Train_accuracy, 'training') -plot_data(eta,n_neuron,Test_accuracy, 'testing') - -## Fine-tuning neural network hyperparameters - -The flexibility of neural networks is also one of their main -drawbacks: there are many hyperparameters to tweak. Not only can you -use any imaginable network topology (how neurons/nodes are interconnected), -but even in a simple FFNN you can change the number of layers, the -number of neurons per layer, the type of activation function to use in -each layer, the weight initialization logic, the stochastic gradient optmized and much more. How do you -know what combination of hyperparameters is the best for your task? - -* You can use grid search with cross-validation to find the right hyperparameters. - -However,since there are many hyperparameters to tune, and since -training a neural network on a large dataset takes a lot of time, you -will only be able to explore a tiny part of the hyperparameter space. - - -* You can use randomized search. - -* Or use tools like [Oscar](http://oscar.calldesk.ai/), which implements more complex algorithms to help you find a good set of hyperparameters quickly. - -For many problems you can start with just one or two hidden layers and it will work just fine. -For the MNIST data set you ca easily get a high accuracy using just one hidden layer with a -few hundred neurons. -You can reach for this data set above 98% accuracy using two hidden layers with the same total amount of -neurons, in roughly the same amount of training time. - -For more complex problems, you can gradually -ramp up the number of hidden layers, until you start overfitting the training set. Very complex tasks, such -as large image classification or speech recognition, typically require networks with dozens of layers -and they need a huge amount -of training data. However, you will rarely have to train such networks from scratch: it is much more -common to reuse parts of a pretrained state-of-the-art network that performs a similar task. - - - - - -## Which activation function should I use? - -The Back propagation algorithm we derived above works by going from -the output layer to the input layer, propagating the error gradient on -the way. Once the algorithm has computed the gradient of the cost -function with regards to each parameter in the network, it uses these -gradients to update each parameter with a Gradient Descent (GD) step. - - -Unfortunately for us, the gradients often get smaller and smaller as the -algorithm progresses down to the first hidden layers. As a result, the -GD update leaves the lower layer connection weights -virtually unchanged, and training never converges to a good -solution. This is known in the literature as -**the vanishing gradients problem**. - -In other cases, the opposite can happen, namely the the gradients can grow bigger and -bigger. The result is that many of the layers get large updates of the -weights the -algorithm diverges. This is the **exploding gradients problem**, which is -mostly encountered in recurrent neural networks. More generally, deep -neural networks suffer from unstable gradients, different layers may -learn at widely different speeds - - - - -Although this unfortunate behavior has been empirically observed for -quite a while (it was one of the reasons why deep neural networks were -mostly abandoned for a long time), it is only around 2010 that -significant progress was made in understanding it. - -A paper titled [Understanding the Difficulty of Training Deep -Feedforward Neural Networks by Xavier Glorot and Yoshua Bengio](http://proceedings.mlr.press/v9/glorot10a.html) found that -the problems with the popular logistic -sigmoid activation function and the weight initialization technique -that was most popular at the time, namely random initialization using -a normal distribution with a mean of 0 and a standard deviation of -1. - -They showed that with this activation function and this -initialization scheme, the variance of the outputs of each layer is -much greater than the variance of its inputs. Going forward in the -network, the variance keeps increasing after each layer until the -activation function saturates at the top layers. This is actually made -worse by the fact that the logistic function has a mean of 0.5, not 0 -(the hyperbolic tangent function has a mean of 0 and behaves slightly -better than the logistic function in deep networks). - - - -Looking at the logistic activation function, when inputs become large -(negative or positive), the function saturates at 0 or 1, with a -derivative extremely close to 0. Thus when backpropagation kicks in, -it has virtually no gradient to propagate back through the network, -and what little gradient exists keeps getting diluted as -backpropagation progresses down through the top layers, so there is -really nothing left for the lower layers. - -In their paper, Glorot and Bengio propose a way to significantly -alleviate this problem. We need the signal to flow properly in both -directions: in the forward direction when making predictions, and in -the reverse direction when backpropagating gradients. We don’t want -the signal to die out, nor do we want it to explode and saturate. For -the signal to flow properly, the authors argue that we need the -variance of the outputs of each layer to be equal to the variance of -its inputs, and we also need the gradients to have equal variance -before and after flowing through a layer in the reverse direction. - - - -One of the insights in the 2010 paper by Glorot and Bengio was that -the vanishing/exploding gradients problems were in part due to a poor -choice of activation function. Until then most people had assumed that -if Nature had chosen to use roughly sigmoid activation functions in -biological neurons, they must be an excellent choice. But it turns out -that other activation functions behave much better in deep neural -networks, in particular the ReLU activation function, mostly because -it does not saturate for positive values (and also because it is quite -fast to compute). - - -## The RELU function family - -The ReLU activation function suffers from a problem known as the dying -ReLUs: during training, some neurons effectively die, meaning they -stop outputting anything other than 0. - -In some cases, you may find that half of your network’s neurons are -dead, especially if you used a large learning rate. During training, -if a neuron’s weights get updated such that the weighted sum of the -neuron’s inputs is negative, it will start outputting 0. When this -happen, the neuron is unlikely to come back to life since the gradient -of the ReLU function is 0 when its input is negative. - -To solve this problem, nowadays practitioners use a variant of the ReLU -function, such as the leaky ReLU discussed above or the so-called -exponential linear unit (ELU) function - -$$ -ELU(z) = \left\{\begin{array}{cc} \alpha\left( \exp{(z)}-1\right) & z < 0,\\ z & z \ge 0.\end{array}\right. -$$ - -In general it seems that the ELU activation function is better than -the leaky ReLU function (and its variants), which is better than -ReLU. ReLU performs better than $\tanh$ which in turn performs better -than the logistic function. - -If runtime -performance is an issue, then you may opt for the leaky ReLU function over the -ELU function If you don’t -want to tweak yet another hyperparameter, you may just use the default -$\alpha$ of $0.01$ for the leaky ReLU, and $1$ for ELU. If you have -spare time and computing power, you can use cross-validation or -bootstrap to evaluate other activation functions. - - - -In most cases you can use the ReLU activation function in the hidden layers (or one of its variants). - -It is a bit faster to compute than other activation functions, and the gradient descent optimization does in general not get stuck. - -**For the output layer:** - -* For classification the softmax activation function is generally a good choice for classification tasks (when the classes are mutually exclusive). - -* For regression tasks, you can simply use no activation function at all. - -## Batch Normalization - -Batch Normalization -aims to address the vanishing/exploding gradients problems, and more generally the problem that the -distribution of each layer’s inputs changes during training, as the parameters of the previous layers change. - -The technique consists of adding an operation in the model just before the activation function of each -layer, simply zero-centering and normalizing the inputs, then scaling and shifting the result using two new -parameters per layer (one for scaling, the other for shifting). In other words, this operation lets the model -learn the optimal scale and mean of the inputs for each layer. -In order to zero-center and normalize the inputs, the algorithm needs to estimate the inputs’ mean and -standard deviation. It does so by evaluating the mean and standard deviation of the inputs over the current -mini-batch, from this the name batch normalization. - -## Dropout - -It is a fairly simple algorithm: at every training step, every neuron (including the input neurons but -excluding the output neurons) has a probability $p$ of being temporarily dropped out, meaning it will be -entirely ignored during this training step, but it may be active during the next step. - -The -hyperparameter $p$ is called the dropout rate, and it is typically set to 50%. After training, the neurons are not dropped anymore. - It is viewed as one of the most popular regularization techniques. - -## Gradient Clipping - -A popular technique to lessen the exploding gradients problem is to simply clip the gradients during -backpropagation so that they never exceed some threshold (this is mostly useful for recurrent neural -networks). - -This technique is called Gradient Clipping. - -In general however, Batch -Normalization is preferred. - - -## A top-down perspective on Neural networks - - -The first thing we would like to do is divide the data into two or three -parts. A training set, a validation or dev (development) set, and a -test set. The test set is the data on which we want to make -predictions. The dev set is a subset of the training data we use to -check how well we are doing out-of-sample, after training the model on -the training dataset. We use the validation error as a proxy for the -test error in order to make tweaks to our model. It is crucial that we -do not use any of the test data to train the algorithm. This is a -cardinal sin in ML. Then: - - -* Estimate optimal error rate - -* Minimize underfitting (bias) on training data set. - -* Make sure you are not overfitting. - -If the validation and test sets are drawn from the same distributions, -then a good performance on the validation set should lead to similarly -good performance on the test set. - -However, sometimes -the training data and test data differ in subtle ways because, for -example, they are collected using slightly different methods, or -because it is cheaper to collect data in one way versus another. In -this case, there can be a mismatch between the training and test -data. This can lead to the neural network overfitting these small -differences between the test and training sets, and a poor performance -on the test set despite having a good performance on the validation -set. To rectify this, Andrew Ng suggests making two validation or dev -sets, one constructed from the training data and one constructed from -the test data. The difference between the performance of the algorithm -on these two validation sets quantifies the train-test mismatch. This -can serve as another important diagnostic when using DNNs for -supervised learning. - - -## Limitations of supervised learning with deep networks - -Like all statistical methods, supervised learning using neural -networks has important limitations. This is especially important when -one seeks to apply these methods, especially to physics problems. Like -all tools, DNNs are not a universal solution. Often, the same or -better performance on a task can be achieved by using a few -hand-engineered features (or even a collection of random -features). - -Here we list some of the important limitations of supervised neural network based models. - - - -* **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). - -* **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. - -* **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. - -* **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. - -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. \ No newline at end of file diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter10_33_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter10_33_1.png deleted file mode 100644 index 03e01a89d..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter10_33_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter10_49_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter10_49_1.png deleted file mode 100644 index 27ee23cc1..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter10_49_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter10_49_2.png b/doc/LectureNotes/_build/jupyter_execute/chapter10_49_2.png deleted file mode 100644 index e4d211026..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter10_49_2.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter10_53_0.png b/doc/LectureNotes/_build/jupyter_execute/chapter10_53_0.png deleted file mode 100644 index 8d17ae6f7..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter10_53_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter10_53_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter10_53_1.png deleted file mode 100644 index fd2da8862..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter10_53_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter11.ipynb b/doc/LectureNotes/_build/jupyter_execute/chapter11.ipynb deleted file mode 100644 index 344f752d3..000000000 --- a/doc/LectureNotes/_build/jupyter_execute/chapter11.ipynb +++ /dev/null @@ -1,3310 +0,0 @@ -{ - "cells": [ - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "# Solving Differential Equations with Deep Learning\n", - "\n", - "The Universal Approximation Theorem states that a neural network can\n", - "approximate any function at a single hidden layer along with one input\n", - "and output layer to any given precision. \n", - "\n", - "\n", - "An ordinary differential equation (ODE) is an equation involving functions having one variable.\n", - "\n", - "In general, an ordinary differential equation looks like" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation} \\label{ode} \\tag{1}\n", - "f\\left(x, \\, g(x), \\, g'(x), \\, g''(x), \\, \\dots \\, , \\, g^{(n)}(x)\\right) = 0\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $g(x)$ is the function to find, and $g^{(n)}(x)$ is the $n$-th derivative of $g(x)$.\n", - "\n", - "The $f\\left(x, g(x), g'(x), g''(x), \\, \\dots \\, , g^{(n)}(x)\\right)$ is just a way to write that there is an expression involving $x$ and $g(x), \\ g'(x), \\ g''(x), \\, \\dots \\, , \\text{ and } g^{(n)}(x)$ on the left side of the equality sign in ([1](#ode)).\n", - "The highest order of derivative, that is the value of $n$, determines to the order of the equation.\n", - "The equation is referred to as a $n$-th order ODE.\n", - "Along with ([1](#ode)), some additional conditions of the function $g(x)$ are typically given\n", - "for the solution to be unique.\n", - "\n", - "\n", - "\n", - "Let the trial solution $g_t(x)$ be" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - "\tg_t(x) = h_1(x) + h_2(x,N(x,P))\n", - "\\label{_auto1} \\tag{2}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $h_1(x)$ is a function that makes $g_t(x)$ satisfy a given set\n", - "of conditions, $N(x,P)$ a neural network with weights and biases\n", - "described by $P$ and $h_2(x, N(x,P))$ some expression involving the\n", - "neural network. The role of the function $h_2(x, N(x,P))$, is to\n", - "ensure that the output from $N(x,P)$ is zero when $g_t(x)$ is\n", - "evaluated at the values of $x$ where the given conditions must be\n", - "satisfied. The function $h_1(x)$ should alone make $g_t(x)$ satisfy\n", - "the conditions.\n", - "\n", - "But what about the network $N(x,P)$?\n", - "\n", - "\n", - "As described previously, an optimization method could be used to minimize the parameters of a neural network, that being its weights and biases, through backward propagation.\n", - "\n", - "\n", - "\n", - "For the minimization to be defined, we need to have a cost function at hand to minimize.\n", - "\n", - "It is given that $f\\left(x, \\, g(x), \\, g'(x), \\, g''(x), \\, \\dots \\, , \\, g^{(n)}(x)\\right)$ should be equal to zero in ([1](#ode)).\n", - "We can choose to consider the mean squared error as the cost function for an input $x$.\n", - "Since we are looking at one input, the cost function is just $f$ squared.\n", - "The cost function $c\\left(x, P \\right)$ can therefore be expressed as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C\\left(x, P\\right) = \\big(f\\left(x, \\, g(x), \\, g'(x), \\, g''(x), \\, \\dots \\, , \\, g^{(n)}(x)\\right)\\big)^2\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "If $N$ inputs are given as a vector $\\boldsymbol{x}$ with elements $x_i$ for $i = 1,\\dots,N$,\n", - "the cost function becomes" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation} \\label{cost} \\tag{3}\n", - "\tC\\left(\\boldsymbol{x}, P\\right) = \\frac{1}{N} \\sum_{i=1}^N \\big(f\\left(x_i, \\, g(x_i), \\, g'(x_i), \\, g''(x_i), \\, \\dots \\, , \\, g^{(n)}(x_i)\\right)\\big)^2\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The neural net should then find the parameters $P$ that minimizes the cost function in\n", - "([3](#cost)) for a set of $N$ training samples $x_i$.\n", - "\n", - "\n", - "\n", - "To perform the minimization using gradient descent, the gradient of $C\\left(\\boldsymbol{x}, P\\right)$ is needed.\n", - "It might happen so that finding an analytical expression of the gradient of $C(\\boldsymbol{x}, P)$ from ([3](#cost)) gets too messy, depending on which cost function one desires to use.\n", - "\n", - "Luckily, there exists libraries that makes the job for us through automatic differentiation.\n", - "Automatic differentiation is a method of finding the derivatives numerically with very high precision.\n", - "\n", - "\n", - "### Example: Exponential decay\n", - "\n", - "An exponential decay of a quantity $g(x)$ is described by the equation" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation} \\label{solve_expdec} \\tag{4}\n", - " g'(x) = -\\gamma g(x)\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with $g(0) = g_0$ for some chosen initial value $g_0$.\n", - "\n", - "The analytical solution of ([4](#solve_expdec)) is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - " g(x) = g_0 \\exp\\left(-\\gamma x\\right)\n", - "\\label{_auto2} \\tag{5}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Having an analytical solution at hand, it is possible to use it to compare how well a neural network finds a solution of ([4](#solve_expdec)).\n", - "\n", - "\n", - "\n", - "The program will use a neural network to solve" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation} \\label{solveode} \\tag{6}\n", - "g'(x) = -\\gamma g(x)\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $g(0) = g_0$ with $\\gamma$ and $g_0$ being some chosen values.\n", - "\n", - "In this example, $\\gamma = 2$ and $g_0 = 10$.\n", - "\n", - "\n", - "To begin with, a trial solution $g_t(t)$ must be chosen. A general trial solution for ordinary differential equations could be" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "g_t(x, P) = h_1(x) + h_2(x, N(x, P))\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with $h_1(x)$ ensuring that $g_t(x)$ satisfies some conditions and $h_2(x,N(x, P))$ an expression involving $x$ and the output from the neural network $N(x,P)$ with $P $ being the collection of the weights and biases for each layer. For now, it is assumed that the network consists of one input layer, one hidden layer, and one output layer.\n", - "\n", - "\n", - "\n", - "In this network, there are no weights and bias at the input layer, so $P = \\{ P_{\\text{hidden}}, P_{\\text{output}} \\}$.\n", - "If there are $N_{\\text{hidden} }$ neurons in the hidden layer, then $P_{\\text{hidden}}$ is a $N_{\\text{hidden} } \\times (1 + N_{\\text{input}})$ matrix, given that there are $N_{\\text{input}}$ neurons in the input layer.\n", - "\n", - "The first column in $P_{\\text{hidden} }$ represents the bias for each neuron in the hidden layer and the second column represents the weights for each neuron in the hidden layer from the input layer.\n", - "If there are $N_{\\text{output} }$ neurons in the output layer, then $P_{\\text{output}} $ is a $N_{\\text{output} } \\times (1 + N_{\\text{hidden} })$ matrix.\n", - "\n", - "Its first column represents the bias of each neuron and the remaining columns represents the weights to each neuron.\n", - "\n", - "It is given that $g(0) = g_0$. The trial solution must fulfill this condition to be a proper solution of ([6](#solveode)). A possible way to ensure that $g_t(0, P) = g_0$, is to let $F(N(x,P)) = x \\cdot N(x,P)$ and $A(x) = g_0$. This gives the following trial solution:" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation} \\label{trial} \\tag{7}\n", - "g_t(x, P) = g_0 + x \\cdot N(x, P)\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "### Reformulating the problem\n", - "\n", - "We wish that our neural network manages to minimize a given cost function.\n", - "\n", - "A reformulation of out equation, ([6](#solveode)), must therefore be done,\n", - "such that it describes the problem a neural network can solve for.\n", - "\n", - "The neural network must find the set of weights and biases $P$ such that the trial solution in ([7](#trial)) satisfies ([6](#solveode)).\n", - "\n", - "The trial solution" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "g_t(x, P) = g_0 + x \\cdot N(x, P)\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "has been chosen such that it already solves the condition $g(0) = g_0$. What remains, is to find $P$ such that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation} \\label{nnmin} \\tag{8}\n", - "g_t'(x, P) = - \\gamma g_t(x, P)\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "is fulfilled as *best as possible*.\n", - "\n", - "\n", - "The left hand side and right hand side of ([8](#nnmin)) must be computed separately, and then the neural network must choose weights and biases, contained in $P$, such that the sides are equal as best as possible.\n", - "This means that the absolute or squared difference between the sides must be as close to zero, ideally equal to zero.\n", - "In this case, the difference squared shows to be an appropriate measurement of how erroneous the trial solution is with respect to $P$ of the neural network.\n", - "\n", - "This gives the following cost function our neural network must solve for:" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\min_{P}\\Big\\{ \\big(g_t'(x, P) - ( -\\gamma g_t(x, P) \\big)^2 \\Big\\}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "(the notation $\\min_{P}\\{ f(x, P) \\}$ means that we desire to find $P$ that yields the minimum of $f(x, P)$)\n", - "\n", - "or, in terms of weights and biases for the hidden and output layer in our network:" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\min_{P_{\\text{hidden} }, \\ P_{\\text{output} }}\\Big\\{ \\big(g_t'(x, \\{ P_{\\text{hidden} }, P_{\\text{output} }\\}) - ( -\\gamma g_t(x, \\{ P_{\\text{hidden} }, P_{\\text{output} }\\}) \\big)^2 \\Big\\}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "for an input value $x$.\n", - "\n", - "\n", - "\n", - "If the neural network evaluates $g_t(x, P)$ at more values for $x$, say $N$ values $x_i$ for $i = 1, \\dots, N$, then the *total* error to minimize becomes" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation} \\label{min} \\tag{9}\n", - "\\min_{P}\\Big\\{\\frac{1}{N} \\sum_{i=1}^N \\big(g_t'(x_i, P) - ( -\\gamma g_t(x_i, P) \\big)^2 \\Big\\}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Letting $\\boldsymbol{x}$ be a vector with elements $x_i$ and $C(\\boldsymbol{x}, P) = \\frac{1}{N} \\sum_i \\big(g_t'(x_i, P) - ( -\\gamma g_t(x_i, P) \\big)^2$ denote the cost function, the minimization problem that our network must solve, becomes" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\min_{P} C(\\boldsymbol{x}, P)\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In terms of $P_{\\text{hidden} }$ and $P_{\\text{output} }$, this could also be expressed as\n", - "\n", - "$$\n", - "\\min_{P_{\\text{hidden} }, \\ P_{\\text{output} }} C(\\boldsymbol{x}, \\{P_{\\text{hidden} }, P_{\\text{output} }\\})\n", - "$$\n", - "\n", - "\n", - "For simplicity, it is assumed that the input is an array $\\boldsymbol{x} = (x_1, \\dots, x_N)$ with $N$ elements. It is at these points the neural network should find $P$ such that it fulfills ([9](#min)).\n", - "\n", - "First, the neural network must feed forward the inputs.\n", - "This means that $\\boldsymbol{x}s$ must be passed through an input layer, a hidden layer and a output layer. The input layer in this case, does not need to process the data any further.\n", - "The input layer will consist of $N_{\\text{input} }$ neurons, passing its element to each neuron in the hidden layer. The number of neurons in the hidden layer will be $N_{\\text{hidden} }$.\n", - "\n", - "\n", - "For the $i$-th in the hidden layer with weight $w_i^{\\text{hidden} }$ and bias $b_i^{\\text{hidden} }$, the weighting from the $j$-th neuron at the input layer is:" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{aligned}\n", - "z_{i,j}^{\\text{hidden}} &= b_i^{\\text{hidden}} + w_i^{\\text{hidden}}x_j \\\\\n", - "&=\n", - "\\begin{pmatrix}\n", - "b_i^{\\text{hidden}} & w_i^{\\text{hidden}}\n", - "\\end{pmatrix}\n", - "\\begin{pmatrix}\n", - "1 \\\\\n", - "x_j\n", - "\\end{pmatrix}\n", - "\\end{aligned}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The result after weighting the inputs at the $i$-th hidden neuron can be written as a vector:" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{aligned}\n", - "\\boldsymbol{z}_{i}^{\\text{hidden}} &= \\Big( b_i^{\\text{hidden}} + w_i^{\\text{hidden}}x_1 , \\ b_i^{\\text{hidden}} + w_i^{\\text{hidden}} x_2, \\ \\dots \\, , \\ b_i^{\\text{hidden}} + w_i^{\\text{hidden}} x_N\\Big) \\\\\n", - "&=\n", - "\\begin{pmatrix}\n", - " b_i^{\\text{hidden}} & w_i^{\\text{hidden}}\n", - "\\end{pmatrix}\n", - "\\begin{pmatrix}\n", - "1 & 1 & \\dots & 1 \\\\\n", - "x_1 & x_2 & \\dots & x_N\n", - "\\end{pmatrix} \\\\\n", - "&= \\boldsymbol{p}_{i, \\text{hidden}}^T X\n", - "\\end{aligned}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The vector $\\boldsymbol{p}_{i, \\text{hidden}}^T$ constitutes each row in $P_{\\text{hidden} }$, which contains the weights for the neural network to minimize according to ([9](#min)).\n", - "\n", - "After having found $\\boldsymbol{z}_{i}^{\\text{hidden}} $ for every $i$-th neuron within the hidden layer, the vector will be sent to an activation function $a_i(\\boldsymbol{z})$.\n", - "\n", - "In this example, the sigmoid function has been chosen to be the activation function for each hidden neuron:" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "f(z) = \\frac{1}{1 + \\exp{(-z)}}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "It is possible to use other activations functions for the hidden layer also.\n", - "\n", - "The output $\\boldsymbol{x}_i^{\\text{hidden}}$ from each $i$-th hidden neuron is:\n", - "\n", - "$$\n", - "\\boldsymbol{x}_i^{\\text{hidden} } = f\\big( \\boldsymbol{z}_{i}^{\\text{hidden}} \\big)\n", - "$$\n", - "\n", - "The outputs $\\boldsymbol{x}_i^{\\text{hidden} } $ are then sent to the output layer.\n", - "\n", - "The output layer consists of one neuron in this case, and combines the\n", - "output from each of the neurons in the hidden layers. The output layer\n", - "combines the results from the hidden layer using some weights $w_i^{\\text{output}}$\n", - "and biases $b_i^{\\text{output}}$. In this case,\n", - "it is assumes that the number of neurons in the output layer is one.\n", - "\n", - "\n", - "\n", - "The procedure of weighting the output neuron $j$ in the hidden layer to the $i$-th neuron in the output layer is similar as for the hidden layer described previously." - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{aligned}\n", - "z_{1,j}^{\\text{output}} & =\n", - "\\begin{pmatrix}\n", - "b_1^{\\text{output}} & \\boldsymbol{w}_1^{\\text{output}}\n", - "\\end{pmatrix}\n", - "\\begin{pmatrix}\n", - "1 \\\\\n", - "\\boldsymbol{x}_j^{\\text{hidden}}\n", - "\\end{pmatrix}\n", - "\\end{aligned}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Expressing $z_{1,j}^{\\text{output}}$ as a vector gives the following way of weighting the inputs from the hidden layer:" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{z}_{1}^{\\text{output}} =\n", - "\\begin{pmatrix}\n", - "b_1^{\\text{output}} & \\boldsymbol{w}_1^{\\text{output}}\n", - "\\end{pmatrix}\n", - "\\begin{pmatrix}\n", - "1 & 1 & \\dots & 1 \\\\\n", - "\\boldsymbol{x}_1^{\\text{hidden}} & \\boldsymbol{x}_2^{\\text{hidden}} & \\dots & \\boldsymbol{x}_N^{\\text{hidden}}\n", - "\\end{pmatrix}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In this case we seek a continuous range of values since we are approximating a function. This means that after computing $\\boldsymbol{z}_{1}^{\\text{output}}$ the neural network has finished its feed forward step, and $\\boldsymbol{z}_{1}^{\\text{output}}$ is the final output of the network.\n", - "\n", - "\n", - "The next step is to decide how the parameters should be changed such that they minimize the cost function.\n", - "\n", - "The chosen cost function for this problem is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(\\boldsymbol{x}, P) = \\frac{1}{N} \\sum_i \\big(g_t'(x_i, P) - ( -\\gamma g_t(x_i, P) \\big)^2\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In order to minimize the cost function, an optimization method must be chosen.\n", - "\n", - "Here, gradient descent with a constant step size has been chosen.\n", - "\n", - "### Gradient descent\n", - "\n", - "The idea of the gradient descent algorithm is to update parameters in\n", - "a direction where the cost function decreases goes to a minimum.\n", - "\n", - "In general, the update of some parameters $\\boldsymbol{\\omega}$ given a cost\n", - "function defined by some weights $\\boldsymbol{\\omega}$, $C(\\boldsymbol{x},\n", - "\\boldsymbol{\\omega})$, goes as follows:" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{\\omega}_{\\text{new} } = \\boldsymbol{\\omega} - \\lambda \\nabla_{\\boldsymbol{\\omega}} C(\\boldsymbol{x}, \\boldsymbol{\\omega})\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "for a number of iterations or until $ \\big|\\big| \\boldsymbol{\\omega}_{\\text{new} } - \\boldsymbol{\\omega} \\big|\\big|$ becomes smaller than some given tolerance.\n", - "\n", - "The value of $\\lambda$ decides how large steps the algorithm must take\n", - "in the direction of $ \\nabla_{\\boldsymbol{\\omega}} C(\\boldsymbol{x}, \\boldsymbol{\\omega})$.\n", - "The notation $\\nabla_{\\boldsymbol{\\omega}}$ express the gradient with respect\n", - "to the elements in $\\boldsymbol{\\omega}$.\n", - "\n", - "In our case, we have to minimize the cost function $C(\\boldsymbol{x}, P)$ with\n", - "respect to the two sets of weights and biases, that is for the hidden\n", - "layer $P_{\\text{hidden} }$ and for the output layer $P_{\\text{output}\n", - "}$ .\n", - "\n", - "This means that $P_{\\text{hidden} }$ and $P_{\\text{output} }$ is updated by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{aligned}\n", - "P_{\\text{hidden},\\text{new}} &= P_{\\text{hidden}} - \\lambda \\nabla_{P_{\\text{hidden}}} C(\\boldsymbol{x}, P) \\\\\n", - "P_{\\text{output},\\text{new}} &= P_{\\text{output}} - \\lambda \\nabla_{P_{\\text{output}}} C(\\boldsymbol{x}, P)\n", - "\\end{aligned}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "### The code for solving the ODE" - ] - }, - { - "cell_type": "code", - "execution_count": 1, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Initial cost: 367.01\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Final cost: 0.0666807\n", - "Max absolute difference: 0.0437499\n" - ] - }, - { - "data": { - "image/png": "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4hgvSZK0/pYtW8aECRNYvHhx0lEqhcLCQlq2bEl+fn6Zr2PxkiSpipgwYQK1a9emdevWhBCSjlOhxRiZMWMGEyZMoE2bNmW+nrsaJUmqIhYvXkzDhg0tXRtACIGGDRuu9eihxUuSpCrE0rXhrMtjafGSJEnKEIuXJEmqcB599FHOPvvsNV5m0qRJv/5+yimnMHLkyLW+rz59+nDIIYes9fVWxuIlSZIqpdLF68EHH6Rjx44JJrJ4SZKkDOvevTtdunShU6dO3H///QDUqlWLK664gm222YZu3boxdepUAN544w123HFHtt12W/bZZ59f/77CvHnzaNOmDcuWLQNg7ty5tGnThhdeeIHBgwfTq1cvOnfuzKJFi9hjjz1+/QrCd955h+22245tttmGvffeG4CBAwey0047se2227LzzjszatSoDT7vnk5CkqQq6Oo3RjBy0twNepsdN6rDlb/vtMbLPfzwwzRo0IBFixax/fbbc+SRR7JgwQK6devGv//9by655BIeeOAB/va3v7HrrrvSv39/Qgg8+OCD3Hjjjdxyyy2/3lbt2rXZY489eOutt+jevTvPPvssRxxxBD169OCuu+7i5ptvpmvXrr+5/+nTp3PqqafSt29f2rRpw8yZMwHYfPPN+fTTT8nLy+ODDz7g8ssv56WXXtqgj5HFS5IkZdTtt9/OK6+8AsD48eP54YcfKCgo+PU4qi5duvD+++8DqXOP/eEPf2Dy5MksXbp0pefMOuWUU7jxxhvp3r07jzzyCA888MBq779///787ne/+/W2GjRoAMCcOXM44YQT+OGHHwgh/DqKtiFZvCRJqoLKMjJVHvr06cMHH3zAF198QY0aNdhjjz1YvHgx+fn5v56eITc3l+XLlwNwzjnn8Je//IVDDz2UPn36cNVVV/3Pbe6yyy6MGTOGPn36UFRUxJZbbrlO2f7+97+z55578sorrzBmzBj22GOPdZ3NVfIYL0mSlDFz5syhfv361KhRg++++47+/fuv8fItWrQA4LHHHlvl5Y4//nh69uzJSSed9Ovfateuzbx58/7nst26daNv3778/PPPAL/uaix5X48++uhazVdZWbwkSVLGHHDAASxfvpwtttiCv/71r3Tr1m21l7/qqqvo0aMHXbp0oVGjRqu8XK9evZg1axbHHHPMr3878cQTOeOMM349uH6Fxo0b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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter11_47_2.png" - }, - "needs_background": "light" - }, - "output_type": "display_data" - } - ], - "source": [ - "%matplotlib inline\n", - "\n", - "import autograd.numpy as np\n", - "from autograd import grad, elementwise_grad\n", - "import autograd.numpy.random as npr\n", - "from matplotlib import pyplot as plt\n", - "\n", - "def sigmoid(z):\n", - " return 1/(1 + np.exp(-z))\n", - "\n", - "# Assuming one input, hidden, and output layer\n", - "def neural_network(params, x):\n", - "\n", - " # Find the weights (including and biases) for the hidden and output layer.\n", - " # Assume that params is a list of parameters for each layer.\n", - " # The biases are the first element for each array in params,\n", - " # and the weights are the remaning elements in each array in params.\n", - "\n", - " w_hidden = params[0]\n", - " w_output = params[1]\n", - "\n", - " # Assumes input x being an one-dimensional array\n", - " num_values = np.size(x)\n", - " x = x.reshape(-1, num_values)\n", - "\n", - " # Assume that the input layer does nothing to the input x\n", - " x_input = x\n", - "\n", - " ## Hidden layer:\n", - "\n", - " # Add a row of ones to include bias\n", - " x_input = np.concatenate((np.ones((1,num_values)), x_input ), axis = 0)\n", - "\n", - " z_hidden = np.matmul(w_hidden, x_input)\n", - " x_hidden = sigmoid(z_hidden)\n", - "\n", - " ## Output layer:\n", - "\n", - " # Include bias:\n", - " x_hidden = np.concatenate((np.ones((1,num_values)), x_hidden ), axis = 0)\n", - "\n", - " z_output = np.matmul(w_output, x_hidden)\n", - " x_output = z_output\n", - "\n", - " return x_output\n", - "\n", - "# The trial solution using the deep neural network:\n", - "def g_trial(x,params, g0 = 10):\n", - " return g0 + x*neural_network(params,x)\n", - "\n", - "# The right side of the ODE:\n", - "def g(x, g_trial, gamma = 2):\n", - " return -gamma*g_trial\n", - "\n", - "# The cost function:\n", - "def cost_function(P, x):\n", - "\n", - " # Evaluate the trial function with the current parameters P\n", - " g_t = g_trial(x,P)\n", - "\n", - " # Find the derivative w.r.t x of the neural network\n", - " d_net_out = elementwise_grad(neural_network,1)(P,x)\n", - "\n", - " # Find the derivative w.r.t x of the trial function\n", - " d_g_t = elementwise_grad(g_trial,0)(x,P)\n", - "\n", - " # The right side of the ODE\n", - " func = g(x, g_t)\n", - "\n", - " err_sqr = (d_g_t - func)**2\n", - " cost_sum = np.sum(err_sqr)\n", - "\n", - " return cost_sum / np.size(err_sqr)\n", - "\n", - "# Solve the exponential decay ODE using neural network with one input, hidden, and output layer\n", - "def solve_ode_neural_network(x, num_neurons_hidden, num_iter, lmb):\n", - " ## Set up initial weights and biases\n", - "\n", - " # For the hidden layer\n", - " p0 = npr.randn(num_neurons_hidden, 2 )\n", - "\n", - " # For the output layer\n", - " p1 = npr.randn(1, num_neurons_hidden + 1 ) # +1 since bias is included\n", - "\n", - " P = [p0, p1]\n", - "\n", - " print('Initial cost: %g'%cost_function(P, x))\n", - "\n", - " ## Start finding the optimal weights using gradient descent\n", - "\n", - " # Find the Python function that represents the gradient of the cost function\n", - " # w.r.t the 0-th input argument -- that is the weights and biases in the hidden and output layer\n", - " cost_function_grad = grad(cost_function,0)\n", - "\n", - " # Let the update be done num_iter times\n", - " for i in range(num_iter):\n", - " # Evaluate the gradient at the current weights and biases in P.\n", - " # The cost_grad consist now of two arrays;\n", - " # one for the gradient w.r.t P_hidden and\n", - " # one for the gradient w.r.t P_output\n", - " cost_grad = cost_function_grad(P, x)\n", - "\n", - " P[0] = P[0] - lmb * cost_grad[0]\n", - " P[1] = P[1] - lmb * cost_grad[1]\n", - "\n", - " print('Final cost: %g'%cost_function(P, x))\n", - "\n", - " return P\n", - "\n", - "def g_analytic(x, gamma = 2, g0 = 10):\n", - " return g0*np.exp(-gamma*x)\n", - "\n", - "# Solve the given problem\n", - "if __name__ == '__main__':\n", - " # Set seed such that the weight are initialized\n", - " # with same weights and biases for every run.\n", - " npr.seed(15)\n", - "\n", - " ## Decide the vales of arguments to the function to solve\n", - " N = 10\n", - " x = np.linspace(0, 1, N)\n", - "\n", - " ## Set up the initial parameters\n", - " num_hidden_neurons = 10\n", - " num_iter = 10000\n", - " lmb = 0.001\n", - "\n", - " # Use the network\n", - " P = solve_ode_neural_network(x, num_hidden_neurons, num_iter, lmb)\n", - "\n", - " # Print the deviation from the trial solution and true solution\n", - " res = g_trial(x,P)\n", - " res_analytical = g_analytic(x)\n", - "\n", - " print('Max absolute difference: %g'%np.max(np.abs(res - res_analytical)))\n", - "\n", - " # Plot the results\n", - " plt.figure(figsize=(10,10))\n", - "\n", - " plt.title('Performance of neural network solving an ODE compared to the analytical solution')\n", - " plt.plot(x, res_analytical)\n", - " plt.plot(x, res[0,:])\n", - " plt.legend(['analytical','nn'])\n", - " plt.xlabel('x')\n", - " plt.ylabel('g(x)')\n", - " plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## The network with one input layer, specified number of hidden layers, and one output layer\n", - "\n", - "It is also possible to extend the construction of our network into a more general one, allowing the network to contain more than one hidden layers.\n", - "\n", - "The number of neurons within each hidden layer are given as a list of integers in the program below." - ] - }, - { - "cell_type": "code", - "execution_count": 2, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Initial cost: 324.246\n" - ] - }, - { - "name": "stderr", - "output_type": "stream", - "text": [ - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/numpy/core/_asarray.py:83: VisibleDeprecationWarning: Creating an ndarray from ragged nested sequences (which is a list-or-tuple of lists-or-tuples-or ndarrays with different lengths or shapes) is deprecated. If you meant to do this, you must specify 'dtype=object' when creating the ndarray\n", - " return array(a, dtype, copy=False, order=order)\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Final cost: 0.119936\n" - ] - }, - { - "data": { - "image/png": "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F2dXZSTOd1N19n4iWiRoGWPicd5kdHY3SejSrkYRERERH9GuRhEREREfCYhdjRUqVLC1atVyO4aIiIhIvhYuXLjXWpvrl28HRPGqVasWcXFxbscQERERyZcxJs9fUdCuRhEREREfUfESERER8REVLxEREREfCYhjvEREROTUpaens23bNlJTU92OEhSio6OpVq0aERERBb6NipeIiEiI2LZtGyVLlqRWrVo4v0stJ8taS2JiItu2baN27doFvp12NYqIiISI1NRUypcvr9JVCIwxlC9f/oRHD1W8REREQohKV+E5mXmp4iUiIiLiIypeIiIiEnAGDBhA3759873Ojh07/jndq1cvVq5cecKPNXXqVK655poTvl1uVLxEREQkKOUsXv3796dRo0YuJlLxEhERER/r3LkzLVu2pHHjxnz99dcAlChRgueee46mTZtyzjnnsHv3bgDGjBlDmzZtaN68OR06dPjn/GOSk5OpXbs26enpABw8eJDatWszfPhw4uLi6NmzJ82aNePIkSO0a9fun58g/P3332nRogVNmzalffv2AMyfP59zzz2X5s2bc95557FmzZpCn3Z9nYSIiEgIemXMClbuOFio99moSileurZxvtf77rvvKFeuHEeOHKF169Zcf/31HD58mHPOOYc33niDJ598km+++Ybnn3+e888/n7lz52KMoX///rzzzju8//77/9xXyZIladeuHePGjaNz584MGzaMLl260LVrVz777DPee+89WrVq9a/HT0hI4O6772b69OnUrl2bffv2AXDGGWcwY8YMwsPDmTRpEs8++yy//PJLoc4jFS8RERHxqY8//piRI0cCsHXrVtatW0dkZOQ/x1G1bNmSiRMnAs53j3Xr1o2dO3dy9OjRXL8zq1evXrzzzjt07tyZ77//nm+++ea4jz937lwuvPDCf+6rXLlyACQlJXHbbbexbt06jDH/jKIVJhUvERGREFSQkamiMHXqVCZNmsScOXOIiYmhXbt2pKamEhER8c/XM4SFhZGRkQHAAw88wKOPPkrHjh2ZOnUqL7/88n/us23btsTHxzN16lQyMzNp0qTJSWV74YUXuPjiixk5ciTx8fG0a9fuZCczTzrGS0RERHwmKSmJsmXLEhMTw+rVq5k7d26+169atSoAAwcOzPN6t956Kz169OCOO+7457ySJUuSnJz8n+uec845TJ8+nU2bNgH8s6sx+2MNGDDghKaroFS8RERExGeuuOIKMjIyaNiwIU8//TTnnHPOca//8ssv07VrV1q2bEmFChXyvF7Pnj3Zv38/3bt3/+e822+/nd69e/9zcP0xsbGxfP3113Tp0oWmTZvSrVs3AJ588kmeeeYZmjdv/s+IW2Ez1toiuePC1KpVK3vsUwgiIiJyclatWkXDhg3djlEkRowYwejRoxk8eLBPHze3eWqMWWitbZXb9XWMl4iIiAS0Bx54gAkTJjB+/Hi3o+RLxUtEREQC2ieffOJ2hALTMV4iIiIiPlJkxcsY850xZo8xZnm288oZYyYaY9Z5/y1bVI8vIiIi4m+KcsRrAHBFjvOeBv6y1tYD/vKe9gsZ6UfdjiAiIiJBrsiKl7V2OrAvx9mdgGNfwjEQ6FxUj38i5gx8lo3/a0tWZqbbUURERCSI+foYr0rW2p3e/+8CKuV1RWPMPcaYOGNMXEJCQpGGCi9bg/oZa1k6aWiRPo6IiIj828svv8x7773ndgyfce3geut8gVieXyJmrf3aWtvKWtsqNja2SLM0v/IutpgqlJ7/PjZLo14iIiJSNHxdvHYbYyoDeP/d4+PHz1V4RAS7mj3I6ZnxLJ30g9txREREgtobb7xB/fr1Of/881mzZg0A7dq146mnnuLss8+mfv36zJgxA3B+uqdLly5cccUV1KtXjyeffNLN6KfM19/j9RtwG/C299/RPn78PLW46i62LPmYUvPex3bogfGEuR1JRESk6Ex4Gnb9Xbj3edqZcOXbx73KwoULGTZsGEuWLCEjI4MWLVrQsmVLADIyMpg/fz7jx4/nlVdeYdKkSQAsWbKExYsXExUVRYMGDXjggQeoXr164Wb3kaL8OokfgTlAA2PMNmPMXTiF61JjzDqgg/e0XwiPiGRH0wc4PXMTf/+lUS8REZGiMGPGDK677jpiYmIoVaoUHTt2/OeyLl26ANCyZUvi4+P/Ob99+/aULl2a6OhoGjVqxObNm30du9AU2YiXtbZ7Hhe1L6rHPFUtr+7FlqWfUGLu+9j2GvUSEZEgls/IlBuioqIACAsL+9ePVB87P7fLAo2+uT6biIhIdpzVl9MzN7F8yjC344iIiASdCy+8kFGjRnHkyBGSk5MZM2aM25F8SsUrhxZX380WU5nic97DZmW5HUdERCSotGjRgm7dutG0aVOuvPJKWrdu7XYknzLOtzr4t1atWtm4uDifPd7sXz/jvGXPsvyCL2jSvofPHldERKQorVq1ioYNG7odI6jkNk+NMQutta1yu75GvHLR6hpn1Ctmzrsa9RIREZFCo+KVi8jISLY26cPpGRtZNVXHeomIiEjhUPHKQ6tr72ErlSk2W6NeIiISPALhEKNAcTLzUsUrD1GRUcQ36UPtjI2snvaT23FEREROWXR0NImJiSpfhcBaS2JiItHR0Sd0O19/c31AaX3tPWxd/inRs96FdjeBMW5HEhEROWnVqlVj27ZtJCQkuB0lKERHR1OtWrUTuo2K13FER0WxqXEfLlzxAmum/USDdje5HUlEROSkRUREULt2bbdjhDTtaszH2R3vZQunETnrXdDQrIiIiJwCFa98REdFsanRfdROX8/a6T+7HUdEREQCmIpXAZzd8T62chqRM9/RqJeIiIicNBWvAigWHcWGhvdRK30962dq1EtEREROjopXAZ3dqTdbOY3w6Rr1EhERkZOj4lVAMdHRrD+jN7XS17Nh1gi344iIiEgAUvE6AWd3uo8tVCJs+v806iUiIiInTMXrBBQvFs26Br2pdXQdG2f/4nYcERERCTAqXieoTef72UIlPNPe1qiXiIiInBAVrxNUolg06+rfS62j64jXqJeIiIicABWvk9C6031spRJM07FeIiIiUnAqXiehVPEYVte7l1pH17J5zq9uxxEREZEAoeJ1ks7+Z9RLx3qJiIhIwah4naTSJWJYWfceaqatZeu8kW7HERERkQCg4nUKzul0P9tsRbKmvKVRLxEREcmXitcpKF0yhhXeUa9t80e7HUdERET8nIrXKWrT+X622opkTn5To14iIiJyXCpep6hMyeIsr3M3NdPWsH2BRr1EREQkbypehaBN5z5stRXJ0KiXiIiIHIeKVyEoV6o4f59+NzVT17Aj7je344iIiIifUvEqJG063882G0v6Xxr1EhERkdypeBWS8qVLsPT0u6mZupqdGvUSERGRXKh4FaKzO/XRqJeIiIjkScWrEMWWKcGSWr2okbqa3QvHuB1HRERE/IyKVyE7+zrnWK80jXqJiIhIDipehaximVIsqnUXNY6sYs+isW7HERERET+i4lUEnO/1iiV10hsa9RIREZF/qHgVgUplS7G4xp3UOLKKhMUa9RIRERGH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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter11_49_3.png" - }, - "needs_background": "light" - }, - "output_type": "display_data" - } - ], - "source": [ - "import autograd.numpy as np\n", - "from autograd import grad, elementwise_grad\n", - "import autograd.numpy.random as npr\n", - "from matplotlib import pyplot as plt\n", - "\n", - "def sigmoid(z):\n", - " return 1/(1 + np.exp(-z))\n", - "\n", - "# The neural network with one input layer and one output layer,\n", - "# but with number of hidden layers specified by the user.\n", - "def deep_neural_network(deep_params, x):\n", - " # N_hidden is the number of hidden layers\n", - "\n", - " N_hidden = np.size(deep_params) - 1 # -1 since params consists of\n", - " # parameters to all the hidden\n", - " # layers AND the output layer.\n", - "\n", - " # Assumes input x being an one-dimensional array\n", - " num_values = np.size(x)\n", - " x = x.reshape(-1, num_values)\n", - "\n", - " # Assume that the input layer does nothing to the input x\n", - " x_input = x\n", - "\n", - " # Due to multiple hidden layers, define a variable referencing to the\n", - " # output of the previous layer:\n", - " x_prev = x_input\n", - "\n", - " ## Hidden layers:\n", - "\n", - " for l in range(N_hidden):\n", - " # From the list of parameters P; find the correct weigths and bias for this layer\n", - " w_hidden = deep_params[l]\n", - "\n", - " # Add a row of ones to include bias\n", - " x_prev = np.concatenate((np.ones((1,num_values)), x_prev ), axis = 0)\n", - "\n", - " z_hidden = np.matmul(w_hidden, x_prev)\n", - " x_hidden = sigmoid(z_hidden)\n", - "\n", - " # Update x_prev such that next layer can use the output from this layer\n", - " x_prev = x_hidden\n", - "\n", - " ## Output layer:\n", - "\n", - " # Get the weights and bias for this layer\n", - " w_output = deep_params[-1]\n", - "\n", - " # Include bias:\n", - " x_prev = np.concatenate((np.ones((1,num_values)), x_prev), axis = 0)\n", - "\n", - " z_output = np.matmul(w_output, x_prev)\n", - " x_output = z_output\n", - "\n", - " return x_output\n", - "\n", - "# The trial solution using the deep neural network:\n", - "def g_trial_deep(x,params, g0 = 10):\n", - " return g0 + x*deep_neural_network(params, x)\n", - "\n", - "# The right side of the ODE:\n", - "def g(x, g_trial, gamma = 2):\n", - " return -gamma*g_trial\n", - "\n", - "# The same cost function as before, but calls deep_neural_network instead.\n", - "def cost_function_deep(P, x):\n", - "\n", - " # Evaluate the trial function with the current parameters P\n", - " g_t = g_trial_deep(x,P)\n", - "\n", - " # Find the derivative w.r.t x of the neural network\n", - " d_net_out = elementwise_grad(deep_neural_network,1)(P,x)\n", - "\n", - " # Find the derivative w.r.t x of the trial function\n", - " d_g_t = elementwise_grad(g_trial_deep,0)(x,P)\n", - "\n", - " # The right side of the ODE\n", - " func = g(x, g_t)\n", - "\n", - " err_sqr = (d_g_t - func)**2\n", - " cost_sum = np.sum(err_sqr)\n", - "\n", - " return cost_sum / np.size(err_sqr)\n", - "\n", - "# Solve the exponential decay ODE using neural network with one input and one output layer,\n", - "# but with specified number of hidden layers from the user.\n", - "def solve_ode_deep_neural_network(x, num_neurons, num_iter, lmb):\n", - " # num_hidden_neurons is now a list of number of neurons within each hidden layer\n", - "\n", - " # The number of elements in the list num_hidden_neurons thus represents\n", - " # the number of hidden layers.\n", - "\n", - " # Find the number of hidden layers:\n", - " N_hidden = np.size(num_neurons)\n", - "\n", - " ## Set up initial weights and biases\n", - "\n", - " # Initialize the list of parameters:\n", - " P = [None]*(N_hidden + 1) # + 1 to include the output layer\n", - "\n", - " P[0] = npr.randn(num_neurons[0], 2 )\n", - " for l in range(1,N_hidden):\n", - " P[l] = npr.randn(num_neurons[l], num_neurons[l-1] + 1) # +1 to include bias\n", - "\n", - " # For the output layer\n", - " P[-1] = npr.randn(1, num_neurons[-1] + 1 ) # +1 since bias is included\n", - "\n", - " print('Initial cost: %g'%cost_function_deep(P, x))\n", - "\n", - " ## Start finding the optimal weights using gradient descent\n", - "\n", - " # Find the Python function that represents the gradient of the cost function\n", - " # w.r.t the 0-th input argument -- that is the weights and biases in the hidden and output layer\n", - " cost_function_deep_grad = grad(cost_function_deep,0)\n", - "\n", - " # Let the update be done num_iter times\n", - " for i in range(num_iter):\n", - " # Evaluate the gradient at the current weights and biases in P.\n", - " # The cost_grad consist now of N_hidden + 1 arrays; the gradient w.r.t the weights and biases\n", - " # in the hidden layers and output layers evaluated at x.\n", - " cost_deep_grad = cost_function_deep_grad(P, x)\n", - "\n", - " for l in range(N_hidden+1):\n", - " P[l] = P[l] - lmb * cost_deep_grad[l]\n", - "\n", - " print('Final cost: %g'%cost_function_deep(P, x))\n", - "\n", - " return P\n", - "\n", - "def g_analytic(x, gamma = 2, g0 = 10):\n", - " return g0*np.exp(-gamma*x)\n", - "\n", - "# Solve the given problem\n", - "if __name__ == '__main__':\n", - " npr.seed(15)\n", - "\n", - " ## Decide the vales of arguments to the function to solve\n", - " N = 10\n", - " x = np.linspace(0, 1, N)\n", - "\n", - " ## Set up the initial parameters\n", - " num_hidden_neurons = np.array([10,10])\n", - " num_iter = 10000\n", - " lmb = 0.001\n", - "\n", - " P = solve_ode_deep_neural_network(x, num_hidden_neurons, num_iter, lmb)\n", - "\n", - " res = g_trial_deep(x,P)\n", - " res_analytical = g_analytic(x)\n", - "\n", - " plt.figure(figsize=(10,10))\n", - "\n", - " plt.title('Performance of a deep neural network solving an ODE compared to the analytical solution')\n", - " plt.plot(x, res_analytical)\n", - " plt.plot(x, res[0,:])\n", - " plt.legend(['analytical','dnn'])\n", - " plt.ylabel('g(x)')\n", - " plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "### Example: Population growth\n", - "\n", - "A logistic model of population growth assumes that a population converges toward an equilibrium.\n", - "The population growth can be modeled by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation} \\label{log} \\tag{10}\n", - "\tg'(t) = \\alpha g(t)(A - g(t))\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $g(t)$ is the population density at time $t$, $\\alpha > 0$ the growth rate and $A > 0$ is the maximum population number in the environment.\n", - "Also, at $t = 0$ the population has the size $g(0) = g_0$, where $g_0$ is some chosen constant.\n", - "\n", - "In this example, similar network as for the exponential decay using Autograd has been used to solve the equation. However, as the implementation might suffer from e.g numerical instability\n", - "and high execution time (this might be more apparent in the examples solving PDEs),\n", - "using a library like TensorFlow is recommended.\n", - "Here, we stay with a more simple approach and implement for comparison, the simple forward Euler method.\n", - "\n", - "\n", - "\n", - "Here, we will model a population $g(t)$ in an environment having carrying capacity $A$.\n", - "The population follows the model" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation} \\label{solveode_population} \\tag{11}\n", - "g'(t) = \\alpha g(t)(A - g(t))\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $g(0) = g_0$.\n", - "\n", - "In this example, we let $\\alpha = 2$, $A = 1$, and $g_0 = 1.2$.\n", - "\n", - "\n", - "We will get a slightly different trial solution, as the boundary conditions are different\n", - "compared to the case for exponential decay.\n", - "\n", - "A possible trial solution satisfying the condition $g(0) = g_0$ could be\n", - "\n", - "$$\n", - "h_1(t) = g_0 + t \\cdot N(t,P)\n", - "$$\n", - "\n", - "with $N(t,P)$ being the output from the neural network with weights and biases for each layer collected in the set $P$.\n", - "\n", - "The analytical solution is\n", - "\n", - "$$\n", - "g(t) = \\frac{Ag_0}{g_0 + (A - g_0)\\exp(-\\alpha A t)}\n", - "$$\n", - "\n", - "\n", - "\n", - "The network will be the similar as for the exponential decay example, but with some small modifications for our problem." - ] - }, - { - "cell_type": "code", - "execution_count": 3, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Initial cost: 0.221805\n" - ] - }, - { - "name": "stderr", - "output_type": "stream", - "text": [ - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/numpy/core/_asarray.py:83: VisibleDeprecationWarning: Creating an ndarray from ragged nested sequences (which is a list-or-tuple of lists-or-tuples-or ndarrays with different lengths or shapes) is deprecated. If you meant to do this, you must specify 'dtype=object' when creating the ndarray\n", - " return array(a, dtype, copy=False, order=order)\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Final cost: 0.000417932\n", - "The max absolute difference between the solutions is: 0.00424909\n" - ] - }, - { - "data": { - "image/png": "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P8fyWSq4iYiIiIQJBTcREREpcoYMGcKNN954xHHWrVv39/Orr76aBQsWHPV7jR07lh49ehz163Ki4CYiIiKSg+zB7Z133qFx48Y+VqTgJiIiImGmd+/etG7dmiZNmjB48GAASpUqxf3330/z5s1p3749GzduBGDUqFG0a9eOli1b0q1bt7+HH7Br1y5q165NWloaADt37qR27dp8/vnnTJs2jcsuu4wWLVqwb98+unbt+vctNH/44QdatWpF8+bNOfXUUwGYMmUKJ554Ii1btqRDhw4sWrQo3+dd3YGIiIjIUXtk1HwWrNuZr9NsXLU0D53T5Ijjvffee8THx7Nv3z5OOOEEzjvvPPbs2UP79u154oknuPvuu3n77bd54IEH6NixI5MmTcLMeOedd3jmmWd47rnn/p5WXFwcXbt25bvvvqN3794MGzaMPn36cMEFF/Daa6/x7LPP0qZNm0PePzk5mWuuuYbx48dTu3Zttm7dCkDDhg35/fffiYqK4pdffuG+++5jxIgR+foZKbiJiIhIWHn55ZcZOXIkAGvWrGHJkiXExMT8fR5Z69at+fnnnwGv77mLLrqI9evXs3///hz7TLv66qt55pln6N27N++//z5vv/32Yd9/0qRJdO7c+e9pxcfHA7Bjxw769evHkiVLMLO/9+LlJwU3EREROWp52TMWDGPHjuWXX35h4sSJlChRgq5du5KSkkJ0dPTf3WtERkaSnp4OwE033cTtt99Oz549GTt2LA8//PA/pnnSSSexcuVKxo4dS0ZGBk2bNj2m2v773/9y8sknM3LkSFauXEnXrl2PdTZzpXPcREREJGzs2LGDcuXKUaJECRYuXMikSZOOOH61atUA+OCDD3Id74orruDSSy/lyiuv/HtYXFwcu3bt+se47du3Z/z48axYsQLg70OlWd9ryJAhRzVfeaXgJiIiImGje/fupKen06hRI+69917at29/2PEffvhhLrjgAlq3bk2FChVyHe+yyy5j27ZtXHLJJX8P69+/P4MGDfr74oQDEhISGDx4MH369KF58+ZcdNFFANx999385z//oWXLln/v8ctv5pwLyoRDSZs2bdyBq0BERETk2Pz11180atTI7zKC4osvvuDrr7/mo48+KtD3zekzNbPpzrk2OY2vc9xERESkSLvpppv4/vvvGT16tN+lHJGCm4iIiBRp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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter11_55_3.png" - }, - "needs_background": "light" - }, - "output_type": "display_data" - } - ], - "source": [ - "import autograd.numpy as np\n", - "from autograd import grad, elementwise_grad\n", - "import autograd.numpy.random as npr\n", - "from matplotlib import pyplot as plt\n", - "\n", - "def sigmoid(z):\n", - " return 1/(1 + np.exp(-z))\n", - "\n", - "# Function to get the parameters.\n", - "# Done such that one can easily change the paramaters after one's liking.\n", - "def get_parameters():\n", - " alpha = 2\n", - " A = 1\n", - " g0 = 1.2\n", - " return alpha, A, g0\n", - "\n", - "def deep_neural_network(P, x):\n", - " # N_hidden is the number of hidden layers\n", - " N_hidden = np.size(P) - 1 # -1 since params consist of parameters to all the hidden layers AND the output layer\n", - "\n", - " # Assumes input x being an one-dimensional array\n", - " num_values = np.size(x)\n", - " x = x.reshape(-1, num_values)\n", - "\n", - " # Assume that the input layer does nothing to the input x\n", - " x_input = x\n", - "\n", - " # Due to multiple hidden layers, define a variable referencing to the\n", - " # output of the previous layer:\n", - " x_prev = x_input\n", - "\n", - " ## Hidden layers:\n", - "\n", - " for l in range(N_hidden):\n", - " # From the list of parameters P; find the correct weigths and bias for this layer\n", - " w_hidden = P[l]\n", - "\n", - " # Add a row of ones to include bias\n", - " x_prev = np.concatenate((np.ones((1,num_values)), x_prev ), axis = 0)\n", - "\n", - " z_hidden = np.matmul(w_hidden, x_prev)\n", - " x_hidden = sigmoid(z_hidden)\n", - "\n", - " # Update x_prev such that next layer can use the output from this layer\n", - " x_prev = x_hidden\n", - "\n", - " ## Output layer:\n", - "\n", - " # Get the weights and bias for this layer\n", - " w_output = P[-1]\n", - "\n", - " # Include bias:\n", - " x_prev = np.concatenate((np.ones((1,num_values)), x_prev), axis = 0)\n", - "\n", - " z_output = np.matmul(w_output, x_prev)\n", - " x_output = z_output\n", - "\n", - " return x_output\n", - "\n", - "\n", - "def cost_function_deep(P, x):\n", - "\n", - " # Evaluate the trial function with the current parameters P\n", - " g_t = g_trial_deep(x,P)\n", - "\n", - " # Find the derivative w.r.t x of the trial function\n", - " d_g_t = elementwise_grad(g_trial_deep,0)(x,P)\n", - "\n", - " # The right side of the ODE\n", - " func = f(x, g_t)\n", - "\n", - " err_sqr = (d_g_t - func)**2\n", - " cost_sum = np.sum(err_sqr)\n", - "\n", - " return cost_sum / np.size(err_sqr)\n", - "\n", - "# The right side of the ODE:\n", - "def f(x, g_trial):\n", - " alpha,A, g0 = get_parameters()\n", - " return alpha*g_trial*(A - g_trial)\n", - "\n", - "# The trial solution using the deep neural network:\n", - "def g_trial_deep(x, params):\n", - " alpha,A, g0 = get_parameters()\n", - " return g0 + x*deep_neural_network(params,x)\n", - "\n", - "# The analytical solution:\n", - "def g_analytic(t):\n", - " alpha,A, g0 = get_parameters()\n", - " return A*g0/(g0 + (A - g0)*np.exp(-alpha*A*t))\n", - "\n", - "def solve_ode_deep_neural_network(x, num_neurons, num_iter, lmb):\n", - " # num_hidden_neurons is now a list of number of neurons within each hidden layer\n", - "\n", - " # Find the number of hidden layers:\n", - " N_hidden = np.size(num_neurons)\n", - "\n", - " ## Set up initial weigths and biases\n", - "\n", - " # Initialize the list of parameters:\n", - " P = [None]*(N_hidden + 1) # + 1 to include the output layer\n", - "\n", - " P[0] = npr.randn(num_neurons[0], 2 )\n", - " for l in range(1,N_hidden):\n", - " P[l] = npr.randn(num_neurons[l], num_neurons[l-1] + 1) # +1 to include bias\n", - "\n", - " # For the output layer\n", - " P[-1] = npr.randn(1, num_neurons[-1] + 1 ) # +1 since bias is included\n", - "\n", - " print('Initial cost: %g'%cost_function_deep(P, x))\n", - "\n", - " ## Start finding the optimal weigths using gradient descent\n", - "\n", - " # Find the Python function that represents the gradient of the cost function\n", - " # w.r.t the 0-th input argument -- that is the weights and biases in the hidden and output layer\n", - " cost_function_deep_grad = grad(cost_function_deep,0)\n", - "\n", - " # Let the update be done num_iter times\n", - " for i in range(num_iter):\n", - " # Evaluate the gradient at the current weights and biases in P.\n", - " # The cost_grad consist now of N_hidden + 1 arrays; the gradient w.r.t the weights and biases\n", - " # in the hidden layers and output layers evaluated at x.\n", - " cost_deep_grad = cost_function_deep_grad(P, x)\n", - "\n", - " for l in range(N_hidden+1):\n", - " P[l] = P[l] - lmb * cost_deep_grad[l]\n", - "\n", - " print('Final cost: %g'%cost_function_deep(P, x))\n", - "\n", - " return P\n", - "\n", - "if __name__ == '__main__':\n", - " npr.seed(4155)\n", - "\n", - " ## Decide the vales of arguments to the function to solve\n", - " Nt = 10\n", - " T = 1\n", - " t = np.linspace(0,T, Nt)\n", - "\n", - " ## Set up the initial parameters\n", - " num_hidden_neurons = [100, 50, 25]\n", - " num_iter = 1000\n", - " lmb = 1e-3\n", - "\n", - " P = solve_ode_deep_neural_network(t, num_hidden_neurons, num_iter, lmb)\n", - "\n", - " g_dnn_ag = g_trial_deep(t,P)\n", - " g_analytical = g_analytic(t)\n", - "\n", - " # Find the maximum absolute difference between the solutons:\n", - " diff_ag = np.max(np.abs(g_dnn_ag - g_analytical))\n", - " print(\"The max absolute difference between the solutions is: %g\"%diff_ag)\n", - "\n", - " plt.figure(figsize=(10,10))\n", - "\n", - " plt.title('Performance of neural network solving an ODE compared to the analytical solution')\n", - " plt.plot(t, g_analytical)\n", - " plt.plot(t, g_dnn_ag[0,:])\n", - " plt.legend(['analytical','nn'])\n", - " plt.xlabel('t')\n", - " plt.ylabel('g(t)')\n", - "\n", - " plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Using forward Euler to solve the ODE\n", - "\n", - "A straightforward way of solving an ODE numerically, is to use Euler's method.\n", - "\n", - "Euler's method uses Taylor series to approximate the value at a function $f$ at a step $\\Delta x$ from $x$:\n", - "\n", - "$$\n", - "f(x + \\Delta x) \\approx f(x) + \\Delta x f'(x)\n", - "$$\n", - "\n", - "In our case, using Euler's method to approximate the value of $g$ at a step $\\Delta t$ from $t$ yields" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{aligned}\n", - " g(t + \\Delta t) &\\approx g(t) + \\Delta t g'(t) \\\\\n", - " &= g(t) + \\Delta t \\big(\\alpha g(t)(A - g(t))\\big)\n", - "\\end{aligned}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "along with the condition that $g(0) = g_0$.\n", - "\n", - "Let $t_i = i \\cdot \\Delta t$ where $\\Delta t = \\frac{T}{N_t-1}$ where $T$ is the final time our solver must solve for and $N_t$ the number of values for $t \\in [0, T]$ for $i = 0, \\dots, N_t-1$.\n", - "\n", - "For $i \\geq 1$, we have that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{aligned}\n", - "t_i &= i\\Delta t \\\\\n", - "&= (i - 1)\\Delta t + \\Delta t \\\\\n", - "&= t_{i-1} + \\Delta t\n", - "\\end{aligned}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Now, if $g_i = g(t_i)$ then" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - " \\begin{aligned}\n", - " g_i &= g(t_i) \\\\\n", - " &= g(t_{i-1} + \\Delta t) \\\\\n", - " &\\approx g(t_{i-1}) + \\Delta t \\big(\\alpha g(t_{i-1})(A - g(t_{i-1}))\\big) \\\\\n", - " &= g_{i-1} + \\Delta t \\big(\\alpha g_{i-1}(A - g_{i-1})\\big)\n", - " \\end{aligned}\n", - "\\end{equation} \\label{odenum} \\tag{12}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "for $i \\geq 1$ and $g_0 = g(t_0) = g(0) = g_0$.\n", - "\n", - "Equation ([12](#odenum)) could be implemented in the following way,\n", - "extending the program that uses the network using Autograd:" - ] - }, - { - "cell_type": "code", - "execution_count": 4, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Initial cost: 0.221805\n" - ] - }, - { - "name": "stderr", - "output_type": "stream", - "text": [ - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/numpy/core/_asarray.py:83: VisibleDeprecationWarning: Creating an ndarray from ragged nested sequences (which is a list-or-tuple of lists-or-tuples-or ndarrays with different lengths or shapes) is deprecated. If you meant to do this, you must specify 'dtype=object' when creating the ndarray\n", - " return array(a, dtype, copy=False, order=order)\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Final cost: 0.000417932\n", - "The max absolute difference between the solutions is: 0.00424909\n", - "Max absolute difference between Euler method and analytical: 0.011225\n", - "Max absolute difference between deep neural network and analytical: 0.00424909\n" - ] - }, - { - "data": { - "image/png": "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P8fyWSq4iYiIiIQJBTcREREpcoYMGcKNN954xHHWrVv39/Orr76aBQsWHPV7jR07lh49ehz163Ki4CYiIiKSg+zB7Z133qFx48Y+VqTgJiIiImGmd+/etG7dmiZNmjB48GAASpUqxf3330/z5s1p3749GzduBGDUqFG0a9eOli1b0q1bt7+HH7Br1y5q165NWloaADt37qR27dp8/vnnTJs2jcsuu4wWLVqwb98+unbt+vctNH/44QdatWpF8+bNOfXUUwGYMmUKJ554Ii1btqRDhw4sWrQo3+dd3YGIiIjIUXtk1HwWrNuZr9NsXLU0D53T5Ijjvffee8THx7Nv3z5OOOEEzjvvPPbs2UP79u154oknuPvuu3n77bd54IEH6NixI5MmTcLMeOedd3jmmWd47rnn/p5WXFwcXbt25bvvvqN3794MGzaMPn36cMEFF/Daa6/x7LPP0qZNm0PePzk5mWuuuYbx48dTu3Zttm7dCkDDhg35/fffiYqK4pdffuG+++5jxIgR+foZKbiJiIhIWHn55ZcZOXIkAGvWrGHJkiXExMT8fR5Z69at+fnnnwGv77mLLrqI9evXs3///hz7TLv66qt55pln6N27N++//z5vv/32Yd9/0qRJdO7c+e9pxcfHA7Bjxw769evHkiVLMLO/9+LlJwU3EREROWp52TMWDGPHjuWXX35h4sSJlChRgq5du5KSkkJ0dPTf3WtERkaSnp4OwE033cTtt99Oz549GTt2LA8//PA/pnnSSSexcuVKxo4dS0ZGBk2bNj2m2v773/9y8sknM3LkSFauXEnXrl2PdTZzpXPcREREJGzs2LGDcuXKUaJECRYuXMikSZOOOH61atUA+OCDD3Id74orruDSSy/lyiuv/HtYXFwcu3bt+se47du3Z/z48axYsQLg70OlWd9ryJAhRzVfeaXgJiIiImGje/fupKen06hRI+69917at29/2PEffvhhLrjgAlq3bk2FChVyHe+yyy5j27ZtXHLJJX8P69+/P4MGDfr74oQDEhISGDx4MH369KF58+ZcdNFFANx999385z//oWXLln/v8ctv5pwLyoRDSZs2bdyBq0BERETk2Pz11180atTI7zKC4osvvuDrr7/mo48+KtD3zekzNbPpzrk2OY2vc9xERESkSLvpppv4/vvvGT16tN+lHJGCm4iIiBRp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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter11_63_3.png" - }, - "needs_background": "light" - }, - "output_type": "display_data" - }, - { - "data": { - "image/png": "iVBORw0KGgoAAAANSUhEUgAAAm4AAAJNCAYAAACIkPmLAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjMuMywgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/Il7ecAAAACXBIWXMAAAsTAAALEwEAmpwYAACHB0lEQVR4nOzdZ3RV1cKF4XelJ5AEAqEm9NA7oVfpzQJIVwFRxIK9l4uo2MGCvQEqCiogKB0BQXrovbfQAgkkIb3s++PECNLlnJyTZD5jMCS7zjju9915995rLWNZFiIiIiLi+tycHUBEREREro2Km4iIiEguoeImIiIikkuouImIiIjkEipuIiIiIrmEipuIiIhILuHh7AA5oWjRola5cuWcHUNERETkqtatW3fasqzgS+3LF8WtXLlyREREODuGiIiIyFUZYw5dbp9elYqIiIjkEipuIiIiIrmEipuIiIhILpEvvnETERGRG5eWlkZkZCTJycnOjpIn+Pj4EBISgqen5zWfo+ImIiIi1yQyMhJ/f3/KlSuHMcbZcXI1y7KIjo4mMjKS8uXLX/N5elUqIiIi1yQ5OZkiRYqotNmBMYYiRYpc99NLFTcRERG5Zipt9vNf/l2quImIiEie9fLLL/Puu+86O4bdqLiJiIiIZElPT3d2hCtScRMREZFc5fvvv6dRo0bUrVuX++67j4yMDAoWLJi9/5dffmHw4MEXnbdv3z46d+5MgwYNaNmyJTt37gRg8ODBDB8+nMaNG/P000/n1K/xn2hUqYiIiOQaO3bsYMqUKSxfvhxPT08eeOABJk2adE3nDhs2jM8++4ywsDBWr17NAw88wKJFiwDbiNkVK1bg7u7uyPg3TMVNRERErtuo37ax/VicXa9ZvVQAI2+uccVj/vjjD9atW0fDhg0BSEpKolixYle99rlz51ixYgW9e/fO3paSkpL99969e7t8aQMVNxEREclFLMti0KBBvPHGGxdsHzNmTPbfLzXFRmZmJoUKFWLjxo2XvG6BAgXsmtNRVNxERETkul3tyZijtGvXjltvvZXHHnuMYsWKERMTQ3x8PMWLF2fHjh1UqVKF6dOn4+/vf8F5AQEBlC9fnp9//pnevXtjWRabN2+mTp06Tvk9/isNThAREZFco3r16rz22mt07NiR2rVr06FDB44fP86bb75J9+7dadasGSVLlrzkuZMmTeLrr7+mTp061KhRgxkzZuRw+htnLMtydgaHCw8PtyIiIpwdQ0REJFfbsWMH1apVc3aMPOVS/06NMessywq/1PF64iYiIiKSS6i4iYiIiOQSKm4iIiIiuYRDi5sx5htjTJQxZutl9g80xmw2xmwxxqwwxtQ5b19nY8wuY8xeY8yz520vb4xZnbV9ijHGy5G/g4iIiIircPQTtwlA5yvsPwC0tiyrFvAq8AWAMcYd+BjoAlQH+htjqmed8xbwnmVZlYAzwFDHRBcRERFxLQ4tbpZlLQVirrB/hWVZZ7J+XAWEZP29EbDXsqz9lmWlApOBW40xBmgL/JJ13ETgNkdkv15pqSlXP0hERETkBrjSN25DgTlZfy8NHDlvX2TWtiLAWcuy0v+13anemzKCrt824GzcaWdHERERkWswYcIEHnrooasec+zYseyf77nnHrZv337d91qyZAndu3e/7vMuxSWKmzHmJmzF7Rk7XnOYMSbCGBNx6tQpe132kkoFVeGEp+HrOc859D4iIiKSc/5d3L766iuqV69+hTMcz+nFzRhTG/gKuNWyrOiszUeB0PMOC8naFg0UMsZ4/Gv7RSzL+sKyrHDLssKDg4MdEz7L7TfdT6UUw/z4lWSkpzr0XiIiIvndbbfdRoMGDahRowZffPEFAAULFuSFF16gTp06NGnShJMnTwLw22+/0bhxY+rVq0f79u2zt/8tPj6e8uXLk5aWBkBcXFz20lgREREMHDiQunXrkpSURJs2bfh7Qv+5c+dSv3596tSpQ7t27QBYs2YNTZs2pV69ejRr1oxdu3bZ/Xd3anEzxpQBpgF3Wpa1+7xda4GwrBGkXkA/YKZlW+ZhMXB71nGDAKevV+Hu4U7Tgh045mmYtuRNZ8cRERHJ07755hvWrVtHREQEH374IdHR0SQkJNCkSRM2bdpEq1at+PLLLwFo0aIFq1atYsOGDfTr14+33377gmv5+/vTpk0bZs2aBcDkyZPp2bMnvXv3Jjw8nEmTJrFx40Z8fX2zzzl16hT33nsvU6dOZdOmTfz8888AVK1alWXLlrFhwwZeeeUVnn/+ebv/7g5dZN4Y8yPQBihqjIkERgKeAJZlfQb8D9t3a5/Yxh2QnvWULN0Y8xAwD3AHvrEsa1vWZZ8BJhtjXgM2AF878ne4VgM7/48/ps1l8sFp3G69RNbvIyIikjfNeRZObLHvNUvUgi5XfwDy4YcfMn36dACOHDnCnj178PLyyv6OrEGDBixYsACAyMhI+vbty/Hjx0lNTaV8+fIXXe+ee+7h7bff5rbbbmP8+PHZpe9yVq1aRatWrbKvFRQUBEBsbCyDBg1iz549GGOyn+LZk0OLm2VZ/a+y/x7gnsvsmw3MvsT2/dhGnbqU0kGB1EqvwzzfLaze/C1N6gxydiQREZE8Z8mSJSxcuJCVK1fi5+dHmzZtSE5OxtPTM/uhibu7O+nptnGMI0aM4PHHH+eWW25hyZIlvPzyyxdds3nz5hw8eJAlS5aQkZFBzZo1/1O2l156iZtuuonp06dz8OBB2rRp819/zctyaHHLb9o3fonVG27nq/WfqriJiEjedg1PxhwhNjaWwoUL4+fnx86dO1m1atVVjy9d2jYBxcSJEy973F133cWAAQN46aWXsrf5+/sTHx9/0bFNmjThgQce4MCBA5QvX56YmBiCgoIuuNeECRP+w293dU4fnJCXtK9dherxIax2S2DvwcXOjiMiIpLndO7cmfT0dKpVq8azzz5LkyZNrnj8yy+/TO/evWnQoAFFixa97HEDBw7kzJkz9O//z8vCwYMHM3z48OzBCX8LDg7miy++oGfPntSpU4e+ffsC8PTTT/Pcc89Rr1697Cd+9mZs3/vnbeHh4dbfo0Acbcyv85h85nHaeZXizYELcuSeIiIiOWHHjh1Uq1bN2TEc4pdffmHGjBl89913OXrfS/07Ncassywr/FLH61Wpnd3esgVbvy/EvMDjPHZ6B8WL5s3/gIuIiOQVI0aMYM6cOcyefdGn9S5Hr0rtrGyRAvh5DcICvl860tlxRERE5CrGjRvH3r17qVy5srOjXJWKmwN0bNqN2ue8+Tl2O/EJjl21QURERPIPFTcH6FSjBKnxnUlwM/yyTE/dRERExD5U3BzAx9OdajX6UyPR8N3xZaSlpTg7koiIiOQBKm4O0rdRGdyim3DKDWat0jJYIiIicuNU3BykaokAkgoNpEJqJhP2/UqmlensSCIiInnOyy+/zLvvvuvsGDlGxc2B+jUuT5Ho6uwz6fy10SWWVBUREZFcTMXNgbrXLsXmxH4UT8/kmy0qbiIiIvYwevRoKleuTIsWLdi1axcAbdq04ZlnnqFRo0ZUrlyZZcuWAbalp3r27Ennzp0JCwvj6aefdmb0G6bi5kAFvD1oXyeMSmfLsM5KYPPeOc6OJCIikqutW7eOyZMns3HjRmbPns3atWuz96Wnp7NmzRref/99Ro0alb1948aNTJkyhS1btjBlyhSOHDnijOh2oZUTHKxvw1DuXXc7/oXHMmHtu4yt1MXZkURERG7YW2veYmfMTrtes2pQVZ5p9MwVj1m2bBk9evTAz88PgFtuuSV7X8+ePQFo0KABBw8ezN7erl07AgMDAahevTqHDh0iNDTUrtlzip64OVjd0EIULRZGo8SiLEw5yeGTm5wdSUREJE/y9vYGwN3d/YJF3v/efql9uY2euDmYMYa+DUP5ds6teFT6honLX+GlnlOdHUtEROSGXO3JmKO0atWKwYMH89xzz5Gens5vv/3Gfffd55QszqAnbjmgR73SHKUarVIKMiNuF9HxR50dSUREJFeqX78+ffv2pU6dOnTp0oWGDRs6O1KOMpZlOTuDw4WHh1sRERFOzfDI5A1E7fuVbaWnMqxYEx7q+pVT84iIiFyvHTt2UK1aNWfHyFMu9e/UGLPOsqzwSx2vJ245pG/DUFbGN6R5mieTT64mMeWcsyOJiIhILqPilkOalC9C2SIFKJTcllg3mL7ydWdHEhERkVxGxS2HuLkZ+oSH8tPR1tRJs/ju4GzSM3PvqBYRERHJeSpuOah3gxBw86CBezOOmgwWrP/M2ZFERESuS374Nj6n/Jd/lypuOahYgA9tqxZjamRXyqVnMH77t/o/ABERyTV8fHyIjo7Wf3fZgWVZREdH4+Pjc13naR63HNavYShDt5/kDu86fJyxldW7f6VJlR7OjiUiInJVISEhREZGcurUKWdHyRN8fHwICQm5rnNU3HJY68rBlAjwYVtSf4q4P8uEdR+ouImISK7g6elJ+fLlnR0jX9Or0hzm4e5G7/AQZu13p493eZanRbPr2BpnxxIREZFcQMXNCfqEh5JpgaffUHwzM5mw4jVnRxIREZFcQMXNCUKD/GhRqSgTdhXidvcizD23n+NnDzo7loiIiLg4FTcn6dcolKNnk2gQeg8W8N1fLzs7koiIiLg4FTcn6VC9OIX9PJl6tDpdMr2ZenodsUlnnR1LREREXJiKm5N4e7jTs34IC3ZEcXvlu0g08POK0c6OJSIiIi5Mxc2J+jUMJS3DYkN6F5qnwqQj80nJSHF2LBEREXFRKm5OFFbcnwZlC/PDumMMqnAzp00mv0d85OxYIiIi4qJU3Jysb8NQ9p9KwDP0PqqlZTBh149kWpnOjiUiIiIuSMXNybrXLklBbw9+3HiWIcWactBKYcmOKc6OJSIiIi5Ixc3J/Lw8uKVuKWZtOUbjRi9SOj2dCRs+cXYsERERcUEqbi6gX8NQktMymXXQjTsLVmFD+lk2Hl7q7FgiIiLiYlTcXECt0oFUKxnAlLWH6dFyJIEZGYxf/aazY4mIiIiLUXFzAcYY+jcKZevROPZbFejnUYzFCYc5EL3T2dFERETEhai4uYhb65TG28ONyWsP07/xU3hZFhOXv+rsWCIiIuJCVNxcRKCfJ11rlWTGhmP4levErZk+zIzZzOmEKGdHExEREReh4uZC+jUMJT4lndlbT3BX7WGkY/GDlsESERGRLCpuLqRR+SDKFy3AlLVHKFt/KO3TYPLRxSSkJTg7moiIiLgAFTcXYoyhb8NQ1hyMYW90MoMr9iLeWExb+4Gzo4mIiIgLUHFzMb3qh+DhZvgp4gi1mz9Jg5R0vt37C2mZac6OJiIiIk6m4uZigv29aV+tOFPXRZLqXoAhJVtywkpj3tbvnR1NREREnEzFzQX1bRRKdEIqC3ecpGWrkVRMTWP85i+xLMvZ0URERMSJVNxcUKuwYEoF+jB57RHcAkszKLA6uzPiWXlgvrOjiYiIiBOpuLkgdzdD7/BQlu05ReSZRLq1HEmx9HS+Wfuus6OJiIiIE6m4uaje4SEA/BwRiVfJOgz0LMHq5BNsP7nRucFERETEaVTcXFRIYT9ahgXzc8QRMjItejd5hgKZmUxYqQl5RURE8isVNxfWr2Eox2KTWbrnFP5hneid4cv8szuJjD3s7GgiIiLiBCpuLqx9teIUKeDFlDVHwBgG1nsAg8V3q153djQRERFxAhU3F+bl4UavBiEs3HGSU/EplKh7J11TYfrxFZxNPuvseCIiIpLDVNxcXJ/wUNIzLaaujwR3TwZX7kuSsZiy9j1nRxMREZEcpuLm4ioVK0ijckFMWXsEy7IIa/ooLZPT+GH/TJLTk50dT0RERHKQilsu0LdhKAdOJ7DmQAx4+zOkdFtiSGfmlvHOjiYiIiI5SMUtF+haqyT+3h5MXnsEgPCWL1AzJZWJ2yaQkZnh5HQiIiKSUxxW3Iwx3xhjoowxWy+zv6oxZqUxJsUY8+R526sYYzae9yfOGPNo1r6XjTFHz9vX1VH5XYmvlzu31ivF7C3HiU1MwwSWZkih2hzOSGTx3t+cHU9ERERyiCOfuE0AOl9hfwzwMHDBOk6WZe2yLKuuZVl1gQZAIjD9vEPe+3u/ZVmz7RvZdfVrWIaU9ExmbDoKQLtWIwlNS2P8+g+0+LyIiEg+4bDiZlnWUmzl7HL7oyzLWgukXeEy7YB9lmUdsne+3KZm6UBqlg7gxzW2QQruJWoyyKs0m1NOs/74amfHExERkRzg6t+49QN+/Ne2h4wxm7NexRZ2Rihn6duwDDuOx7HlaCwAtzZ9hsIZGYxf9aaTk4mIiEhOcNniZozxAm4Bfj5v86dARaAucBwYc4XzhxljIowxEadOnXJk1Bxza91S+Hi6ZQ9S8KnUgf6ZfvwZv499MXucnE5EREQczWWLG9AFWG9Z1sm/N1iWddKyrAzLsjKBL4FGlzvZsqwvLMsKtywrPDg4OAfiOl6AjyfdapVi5sZjJKamgzH0qz8Cn8xMJqx6w9nxRERExMFcubj151+vSY0xJc/7sQdwyRGreVm/RqGcS0nn983HAShcZwA9Ugy/R60lKjHKyelERETEkRw5HciPwEqgijEm0hgz1Bgz3BgzPGt/CWNMJPA48GLWMQFZ+woAHYBp/7rs28aYLcaYzcBNwGOOyu+qwssWpmJwAaZkvS7F3ZO7qg0gE4vv11z2zbGIiIjkAR6OurBlWf2vsv8EEHKZfQlAkUtsv9M+6XIvYwz9GpZh9Owd7DkZT1hxf0KajKDjjon8fGgew1JfoqBXQWfHFBEREQdw5Velchk96pfG093889TN25/BoR05Rwa/bPrSueFERETEYVTccqGiBb3pUL04U9dHkpJuW/KqRsvnaJyUwnc7fyAt40pT44mIiEhupeKWS/VrWIYziWks2J416DagFIOL1CcqM5nZu36+8skiIiKSK6m45VItKhWldCHff16XAs1bvkhYaioTNn6qZbBERETyIBW3XMrNzdAnPJRle05zJCYRAFOiJkO8Q9mbdpZlhxc5OaGIiIjYm4pbLtY7PAQ3Az9F/PPUrXPTZymRns6EtZoaREREJK9RccvFShXypXXlYH6OiCQ9IxMAz0rtuMMqyNqEI2yN2uzkhCIiImJPKm65XN+GZTgRl8zSPVnrsRrD7Q0exj8jk/Fr3nZuOBEREbErFbdcrl21YhQt6M2Pa/55XVqgdj/6pBoWnt7EkbgjVzhbREREchMVt1zO092N2xuEsGhnFFFxybaN7p4MrH4n7lhM1LduIiIieYaKWx7Qt2EoGZkWv6yPzN4W3Oh+bk5M5dfIRcQkxzgxnYiIiNiLilseUL5oARqXD2LK2iNkZmbN3+YTwKCyXUnBYvKGz5wbUEREROxCxS2P6NcolEPRiaw6EJ29rULLp2mTmMSPe34hKT3JielERETEHlTc8oguNUsS4ONxwUoKBJRiSNFGnLXS+HX7D84LJyIiInah4pZH+Hi606NeaeZsPcHZxNTs7fVaPEed5BS+3fI16ZnpTkwoIiIiN0rFLQ/p27AMqemZTN9wNHubKVmLIb5liUyPZ+GBuU5MJyIiIjdKxS0PqV4qgDohgUxec+SCRebbNHuWcqlpjF/3gRafFxERycVU3PKYvg3LsOtkPJsiY7O3uVdsy11WANuTTrD2xBonphMREZEboeKWx9xcpyS+nu5MXnP4n43GcEvDRwjKyGD8mnedF05ERERuiIpbHuPv48nNdUoyc9MxzqX8MxjBu3YfBqYY/jq7k91ndjsxoYiIiPxXKm55UN+GZUhMzWDW5mP/bHT3pG/NwfhmZjJx7VjnhRMREZH/TMUtD6pfphBhxQoyee2FC8wHNryPXolpzD6+ghMJJ5yUTkRERP4rFbc8yBhD34ahbDh8ll0n4v/Z4RPAneVvxrIy+X7DJ84LKCIiIv+Jilse1bN+CF7ubkxee/iC7aWaP06nxCR+3j+TuNQ4J6UTERGR/0LFLY8KKuBFxxrFmb7hKMlpGf/sCCzNkOCmJFoZ/Lz1W+cFFBERkeum4paH9WtYhrOJaczffvKC7VVbPkPTpCS+3/4tqRmplzlbREREXI2KWx7WrGIRQoN8L5zTDaBELYb4VeR0RhKz9v7qlGwiIiJy/VTc8jA3N0Pf8FBW7IvmUHTCBfuaNHuaqimpjN/wCZlWppMSioiIyPVQccvjbm8QipuBnyIunBrEVGzLEAI5kBLN0iN/OimdiIiIXA8VtzyuRKAPN1Upxs8RkaRnnPdkzRg6NnqMUmnpjI94z3kBRURE5JqpuOUD/RqVISo+hcW7Tl2w3aPW7dyVYlgff4CNURudE05ERESumYpbPnBTlWCK+Xsz5V9zuuHuSY/aQwnIyGDCug+cE05ERESumYpbPuDh7sbtDUJYtDOKE7HJF+zza3gP/RJSWRQVwcHYg84JKCIiItdExS2f6NswlEwLfll34SAFfALpX+k2PC2LiRs+dk44ERERuSYqbvlE2SIFaFaxCFMijpCZaV2wr2izR7n1XCIzD83ndNJpJyUUERGRq1Fxy0f6NgzlSEwSK/dHX7gjMIRBJZqTZmXww5bxzgknIiIiV6Xilo90qlGCQn6e/PjvlRSAsi2epl1iElN2TSYxLdEJ6URERORqVNzyER9Pd3rUK838bSeJSfjXGqUlajG4QBhxmalM2/WTcwKKiIjIFam45TN9G4aSmpHJ9A1HL9pXp/lT1E9O5tvNX5KWmeaEdCIiInIlKm75TNUSAdQNLcSUtYexrAsHKVCxLUNMYY6nxTH/wDznBBQREZHLUnHLh/o3CmX3yXOsP3z2wh3G0KrRY1RITWPCho8uLnYiIiLiVCpu+VD32qUo4OV+8UoKgFvNXgxOcWNnwlFWHV/lhHQiIiJyOSpu+VABbw9urlOK3zYdJz75X9+yeXjRre49BKenM37dh84JKCIiIpek4pZP9W0YSlJaBr9tOn7RPq/woQxMSGVlzFZ2xux0QjoRERG5FBW3fKpuaCGqlvC/5OtSfALpHdYLv8xMxmsZLBEREZeh4pZPGWPo2zCUTZGxbD8Wd9H+gGYP0zs+kXmRf3Ls3DEnJBQREZF/U3HLx3rUK42Xhxs/RRy5eGdgCHeUaoWxMvlu81c5H05EREQuouKWjxXy86JLzRJMWx9JclrGRftLNH+CrucSmLp3OrEpsU5IKCIiIudTccvn+jYMJS45nblbT1y8s2RtBvlXJclKZ8qOH3I+nIiIiFxAxS2fa1K+CGWL+DH5UoMUgMrNn6RFYhKTtk0gJSMlh9OJiIjI+VTc8jk3N0Of8FBW7Y/hwOmEiw+o2JYhJoiY9ER+2jkl5wOKiIhINhU3oXeDENzdDFPWXmKQgjE0bPwozROTGLf+A40wFRERcSIVN6FYgA9tqxbjl3WRpGVkXrTf1Lqd/6UVgIxUXlkxSmuYioiIOImKmwDQr2Eop8+lsGhn1MU7Pbwo1eVdHomJYfnxFfy+//ecDygiIiIqbmLTunIwJQJ8mLzm0oMUCOtAv1I3UTsljbfXvElMckzOBhQREREVN7HxcHejd3gIf+4+xbGzSZc8xr3Lm7xyJoGE1HjeXPNmDicUERERFTfJ1ic8lEwLflkXeekDAkOo2OJJ7j1zhjkH5rA0cmnOBhQREcnnVNwkW2iQHy3DijJl7REyMy8zAKHJA9zjWZJKGfDKylGcSz2XsyFFRETyMRU3uUDfhqEcPZvEX3tPX/oAd088u41l1MkTRCVG8f7693M0n4iISH7msOJmjPnGGBNljNl6mf1VjTErjTEpxpgn/7XvoDFmizFmozEm4rztQcaYBcaYPVn/LOyo/PlVh+rFKezneek53f5WrgW1q/RkYFwCU3ZNYf3J9TkXUEREJB9z5BO3CUDnK+yPAR4G3r3M/pssy6prWVb4edueBf6wLCsM+CPrZ7Ejbw93etYPYf72E0Sfu8ISVx1fZURCOqXxYOSKkVoOS0REJAc4rLhZlrUUWzm73P4oy7LWAmnXcdlbgYlZf58I3PafA8pl9WsYSlqGxbT1Ry9/UMFi+LV9if+dOMbBuIN8vunznAsoIiKST7nqN24WMN8Ys84YM+y87cUtyzqe9fcTQPGcj5b3hRX3p0HZwkxee/jKqySE302zQlW4JTmD8Vu/YVfMrpwLKSIikg+5anFrYVlWfaAL8KAxptW/D7BsjeKyrcIYM8wYE2GMiTh16pQDo+ZNfRuGsu9UAusOnbn8QW7u0O09nj55ggDjzv9W/I/0zPScCykiIpLPuGRxsyzraNY/o4DpQKOsXSeNMSUBsv55ifWZsq/xhWVZ4ZZlhQcHBzs6cp7TvXZJCnp7MPlKgxQAQhoQWO8unjtxgu3R2/l++/c5E1BERCQfcrniZowpYIzx//vvQEfg75GpM4FBWX8fBMzI+YT5g5+XB7fULcXvm48Rl3yVzxDb/Y9OljdtMr35eOPHHIm7StkTERGR/8SR04H8CKwEqhhjIo0xQ40xw40xw7P2lzDGRAKPAy9mHROA7bu1v4wxm4A1wCzLsuZmXfZNoIMxZg/QPutncZB+DUNJTstk5sZjVz7QLwjT4VVejNyPh5XJqJWjrvxtnIiIiPwnHo66sGVZ/a+y/wQQcoldcUCdy5wTDbS78XRyLWqVDqRayQCmrD3CHU3KXvngOv0pvv5bHjt7gFczVzN973R6hvXMmaAiIiL5hMu9KhXXYYyhf6NQthyNZevR2Csf7OYG3cZwe8xpGngU4t2173IqUYNCRERE7EnFTa7o1jql8fZwu/JKCn8rURO3Jvfz8oEdpGQk8frq1x0fUEREJB9RcZMrCvTzpGutkvy68ShJqRlXP6HNs5TzLcoDKZ4sPLyQhYcWOj6kiIhIPqHiJlfVr2Eo8cnpzNh4hZUU/ubtD51eZ1DkLqp5BzN69WhiU67ymlVERESuiYqbXFWj8kHUCS3E+wv3XNtTtxo98KjQhlFH9nMmOYax68Y6PqSIiEg+oOImV2WM4aVu1TgRl8yXy/ZfywnQdQzVkhMY5FmCaXumsfr4ascHFRERyeNU3OSahJcLokvNEnz25z6i4pKvfkLRStD8Ee7fvZqyvsV4ecXLJKUnOT6oiIhIHqbiJtfs2S5VScvIZOyC3dd2QovH8QkMZWR0LJHnIvlk4yeODSgiIpLHqbjJNStbpAB3NS3HTxFH2HE87uonePlBl3doeHIPtwdU4dvt37L19NarnyciIiKXpOIm12VE20r4+3jy+uwd17asVZXOUKUbj+9YQVHvwoxcMZK0zKusfSoiIiKXpOIm16WQnxcPtwtj2Z7TLNl9jSsjdHkT/8xMXsjwZ/eZ3YzfOt6xIUVERPIoFTe5bnc2KUu5In68PmsH6RmZVz+hUBlo/RRtdy+lY5E6fLbpM/bHXsPoVBEREbmAiptcNy8PN57tUo09UeeYEnENS2EBNB0BRSvz3P7N+Hr4MmrFKDKtayh9IiIikk3FTf6TTjWK06hcEO8t2E188jV8s+bhBV3fpWjMIZ4qWJ31Uev5addPjg8qIiKSh6i4yX9ijOHF7tU4fS6Vz/7cd20nVWgNNW/n1o0zaFq0Du+te48TCSccG1RERCQPUXGT/6x2SCFuq1uKr5Yd4NjZa5xct9NojLsX/4uOxSKTV1e9em2jU0VERETFTW7MU52rAvDOvF3XdoJ/CWj7AiH7l/JQyZtYGrmUOQfmODChiIhI3qHiJjekdCFfhrYoz/QNR9kcefbaTmp4LxSvxcANv1ErqDpvrnmTM8lnHJpTREQkL1Bxkxt2f5uKFC3oxWu/X+OkvO4e0H0s7vHHGOVWgvi0eN5e+7bjg4qIiORyKm5yw/x9PHm0fWXWHIxh3raT13ZSaCOodydh677nngq38fv+31kWucyxQUVERHI5FTexi34NQwkrVpA35+wgNf0a52drPwq8/bl39yoqBFbglVWvkJCW4NigIiIiuZiKm9iFh7sbz3erxsHoRL5fdejaTipQBNqPwuvQCkYVa8nJhJN8sP4DxwYVERHJxVTcxG7aVA6mZVhRPly0h9jEa1xIvt6dENKQuss/o3+lnkzeOZmNURsdmlNERCS3UnETuzHG8HzXasQmpTFu0Z5rO8nNDbqNgcRoHjlzlhIFSjByxUhSM1IdG1ZERCQXUnETu6pWMoA+DUKZuPIgh6Kv8Xu1knWg0TD8Iibwv8oD2R+7ny82f+HYoCIiIrmQipvY3RMdK+Pp7sZbc3de+0k3PQ8Fi9Fi1QS6l+/G11u+ZveZ3Y4LKSIikgupuIndFQvw4b5WFZm95QQRB2Ou7SSfQOg4Go6t52mvUPy9/Hl5xctkZGY4NqyIiEguouImDnFvq/IUD/Dm1Vk7yMy8xrVIa90O5VpSeMnbPFvnAbac3sKkHZMcG1RERCQXUXETh/Dz8uDJjlXYdOQsv20+dm0nGWMbqJCaQJedf9IqpBUfbfyIyPhIx4YVERHJJVTcxGF61Q+heskA3p67i+S0a3zlGVwFmj2E2fQDL4V0xc24MWrlqGtbSktERCSPU3ETh3FzM7zYrRpHzyYxfvnBaz+x1VMQGEqJP17j0bojWHV8FTP2zXBYThERkdxCxU0cqlmlorSvVoxPFu8l+lzKtZ3kVQA6vwlR2+lzJob6xerzztp3OJ102rFhRUREXJyKmzjcs12qkZiWwfsLr3FSXoCq3SCsE25/vsnI2veTlJ7EG6vfcFxIERGRXEDFTRyuUrGCDGxchh/WHGZvVPy1nWQMdHkLMtOpsOIz7q9zP/MPzeePw384NqyIiIgLU3GTHPFIuzD8PN15Y/Z1TMobVB5aPgHbpjPYpyxVCldh9KrRxKXGOS6oiIiIC1NxkxxRpKA3D7atxB87o1i+9zq+VWv2MARVxHPus4xq/ALRydGMjRjruKAiIiIuTMVNcszgZuUoXciX12btIONaJ+X19IGu70DMPmrsXMhd1e9i6p6prD2x1rFhRUREXJCKm+QYH093nulSlR3H45i6/jom1a3UDqrfBsve5YGy3Qj1D+XlFS+TnJ7ssKwiIiKuSMVNctTNtUtSN7QQ787bRWJq+rWf2PkNcPPAd/7/GNnkfxyOP8wnmz5xXFAREREXpOImOcoYw0vdqxEVn8IXS/df+4kBpaDNs7BnHo3joukZ1pNvt33L9ujtjgsrIiLiYlTcJMc1KBtEt1ol+fzP/ZyMu47XnY2HQ7HqMOcZHq89nMI+hRm5YiRpmWmOCysiIuJCVNzEKZ7pXJWMTIsx83dd+0nuntBtLMQeIXDVF7zQ+AV2xuxk4raJjgsqIiLiQlTcxCnKFPFjULOy/Lwuku3HrmNetrJNoc4AWDGO9n6htC/Tnk83fsrB2IMOyyoiIuIqVNzEaR66KYxAX09Gz96OZV3j9CAAHV4BLz+Y9QTPN3oObw9vXl75MplWpuPCioiIuAAVN3GaQD9PHmkXxvK90SzeFXXtJxYMhnYj4eAygvcv5cnwJ1l3ch2/7P7FcWFFRERcgIqbONXAxmUpX7QAr8/eSXrGdTwxazAYStWDec/TI6QtjUs05r1173Ei4YTDsoqIiDibips4lZeHG892qcreqHP8uPbItZ/o5m4bqHAuCrPkDUY2HUl6ZjqjV42+vteuIiIiuYiKmzhdx+rFaVQ+iPcX7CY++Tqm9ihdHxoOhTVfEJpwhgfrPsiSyCXMOzjPcWFFREScSMVNnM4Yw0vdqhOdkMonS/Zd38ltXwTfIJj1OHdUHUCNIjV4Y80bnE0+65CsIiIizqTiJi6hVkggPeuV5uu/DhB5JvHaT/QtDB1fg8i1eGz6kVHNRhGXEsc7Ee84LqyIiIiTqLiJy3iyUxUM8M6865iUF6BOPyjTDBaOpIp3UYbUHMLMfTNZfnS5Q3KKiIg4i4qbuIxShXy5t2UFZmw8xsYjZ6/9RGOg2xhIjoM/Xua+OvdRLqAcr6x8hcS063h6JyIi4uJU3MSlDG9TkaIFvRk96zon5S1eHZo+AOu/xfvYJkY1G8WxhGOM2zDOcWFFRERymIqbuJSC3h483qEyaw+eYe7W65yTrfWz4F8KZj1O/aK16VulL5N2TGLTqU2OCSsiIpLDVNzE5fQJD6Fy8YK8OXcnqenXMSmvd0Ho/Aac2AJrv+LR+o9SzK8YL694mbSM65hmRERExEWpuInL8XB34/mu1TgUnci3Kw9e38nVb4WK7WDRaxRMOcf/mv6PvWf38tWWrxySVUREJCepuIlLalOlGC3DijJu0V7OJqZe+4nGQNd3ICMF5r9Iq5BWdCnfhS+2fMHeM3sdF1hERCQHqLiJy3qhWzXik9P48I/rLFxFKkKLx2DLz7D/T55t9CwFPQsycuVIMjIzHBNWREQkBzisuBljvjHGRBljtl5mf1VjzEpjTIox5snztocaYxYbY7YbY7YZYx45b9/LxpijxpiNWX+6Oiq/OF/VEgH0bRjKd6sOcvB0wvWd3OIxKFwOZj9JkEdBnm74NJtPbWbyrskOySoiIpITHPnEbQLQ+Qr7Y4CHgXf/tT0deMKyrOpAE+BBY0z18/a/Z1lW3aw/s+0ZWFzPYx0q4+Xuxptzdl7fiZ6+0OUdOL0bVn5E9wrdaVG6BR+s/4Cj5446JqyIiIiDOay4WZa1FFs5u9z+KMuy1gJp/9p+3LKs9Vl/jwd2AKUdlVNcWzF/H4a3rsjcbSdYc+Cy/3G6tModoWp3+PNtTOwRXmryEgCvrHzl+uaIExERcREu/Y2bMaYcUA9Yfd7mh4wxm7NexRZ2TjLJSfe0rECJAB9em7WdzMzrLFyd37QNWJjzLKUKluKR+o+w4tgKftv/m2PCioiIOJDLFjdjTEFgKvCoZVlxWZs/BSoCdYHjwJgrnD/MGBNhjIk4deqUo+OKA/l6ufNUpypsjoxl5qZj13dyoVBo/TTsmgW75tKvSj/qBNfh7bVvE50U7ZjAIiIiDuKSxc0Y44mttE2yLGva39styzppWVaGZVmZwJdAo8tdw7KsLyzLCrcsKzw4ONjxocWhetQrTc3SAbw9dyfJadc5MrTJg1C0Csx5Cvf0FEY1G0ViWiJvrnnTMWFFREQcxOWKmzHGAF8DOyzLGvuvfSXP+7EHcMkRq5L3uLkZXuhanWOxyXz914HrO9nDy7YI/dnD8NdYKhaqyLDaw5h7cC5LjixxRFwRERGHcOR0ID8CK4EqxphIY8xQY8xwY8zwrP0ljDGRwOPAi1nHBADNgTuBtpeY9uNtY8wWY8xm4CbgMUflF9fTtGIR2lcrzqdL9nH6XMr1nVy+JdTqA8s/gNN7GVpzKJUKVeLVVa8SnxrvmMAiIiJ2ZvLD6Lrw8HArIiLC2THEDvadOken95bSt2Eoo3vUur6T40/CR+FQuj7c+StbTm/ljjl3cHvY7bzU9CXHBBYREblOxph1lmWFX2qfy70qFbmSisEFuaNJWX5cc5g9J6/zSZl/cWj7EuxfAtumUyu4FgOrDeSn3T8RcULFXkREXJ+Km+Q6D7cLo4C3B6/P3nH9JzccCiVqw7znISWeh+o+ROmCpRm1chQpGdf5+lVERCSHqbhJrhNUwIsRbSuxeNcplu25zqle3Nyh+3sQfwKWvImfpx8jm47kYNxBPt74sWMCi4iI2ImKm+RKg5qVIzTIl9GzdpBxvZPyhoRDg0Gw6lM4uY2mpZrSK6wX47eOZ8GhBY4JLCIiYgcqbpIreXu480znquw8Ec8v645c/wXajQSfQPj9ccjM5LnGz1E7uDYv/PUCO6L/wytYERGRHKDiJrlWt1olqV+mEO/O301CSvr1newXBB1egSOrYNOPeLt788FNHxDgFcDDix/mdNJpx4QWERG5ASpukmsZY3ihW3VOxafw+dL913+BugMhtDEseAkSYyjqW5RxbccRmxLLo4sfJTUj1f6hRUREboCKm+RqDcoWplvtknyxdB8nYpOv72Q3N9uKCklnYNGrAFQrUo3Xmr/GplObGLVyFPlhnkMREck9VNwk13u2c1UyM+Hd+buu/+QStaDxcIgYD5HrAOhYriMP1H2AmftmMnHbRDunFRER+e9U3CTXCw3yY0jzckxdH8m2Y7HXf4E2z0HB4jDzIUhNAGB47eF0KteJsevGsjRyqZ0Ti4iI/DcqbpInPHBTJQr5ejJ61o7rf73pEwC3fQKndsKMh8CyMMbwavNXqRpUlaeXPs3eM3sdE1xEROQ6qLhJnhDo68mj7SuzYl80i3ZGXf8FKrWDdv+DbdNsC9EDvh6+fNj2Q3w9fBmxaARnks/YObWIiMj1UXGTPGNA4zJUCC7A6Nk7SMvIvP4LNH8UavSAP0bB3j8AKFGgBB/c9AFRiVE8vuRx0jLS7BtaRETkOqi4SZ7h6e7Gc12qsf9UAj+uOXz9FzAGbv0YgqvBL3dDjG2KkdrBtXm52ctEnIzgjTVvaKSpiIg4jYqb5CntqxWjSYUg3l+4h7jk//B0zKsA9Jtk+/vkO7IHK9xc8WaG1hzKz7t/ZvKuyXZMLCIicu1U3CRPMcbwYrfqnElM5ePF/3FAQVB56D0eTu2AGQ9C1hO2h+s/TJuQNry15i1WHltpx9QiIiLXRsVN8pyapQPpUa804/86yJGYxP92kYptof3LsG06LH8fADfjxput3qR8YHme+PMJDsUdsltmERGRa6HiJnnSU52q4OYGb8/7D5Py/q3Zw1CzFywcBXsWAlDAswDj2o7Dw3jw0B8PEZcaZ6fEIiIiV6fiJnlSyUBfhrWswG+bjrHh8H+cxsMYuGUcFK8BU++G6H0AhPiHMLbNWCLjI3n6z6dJz7zOBe5FRET+IxU3ybPua12RYH9vXvsvk/L+7e/BCsYNJg+ElHMAhJcI58UmL7L82HLGRIyxY2oREZHLU3GTPKuAtwdPdKjMukNnmLP1xH+/UOFycPt4OL0LZjyQPVihV+Ve3FHtDr7f8T3T9kyzT2gREZErUHGTPK13eChVS/jzxpwdpKRn/PcLVbwJOrwC22fAX2OzNz8R/gTNSjXj1VWvsu7kOjskFhERuTwVN8nT3N0Mz3etxpGYJL5dcYOjQJs+BLV6wx+vwp4FAHi4efBO63cIKRjCY4sf4+i5o3ZILSIicmkqbpLntaocTOvKwYxbtIczCan//ULGwM0fQomaMHVo9mCFAK8AxrUdR7qVzohFI0hIS7BTchERkQupuEm+8EK3apxLSeeDP/bc2IW8/KDvJDDuWYMV4gEoF1iOd1u/y/6z+3l22bNkWv9hrVQREZGrUHGTfKFycX/6NizD96sOsf/UuRu7WOGytpUVTu+CX+/PHqzQrFQznmr4FEuOLGHchnE3HlpERORfVNwk33i8Q2W8Pdx4c87OG79YhTbQ4VXY8Rssezd784CqA7i98u18teUrft//+43fR0RE5DwqbpJvBPt788BNlZi//SSr9kff+AWbPgi1+sCi0bB7HmBbK/X5Rs8TXjyckctHsvnU5hu/j4iISBYVN8lXhrYoT6lAH0bP2kFm5n+clPdvxsDNH0CJWjD13uzBCp7unoxtM5Zgv2AeWfwIJxJuYA45ERGR86i4Sb7i4+nOU52rsOVoLL9utMPUHV5+tpUV3D1g8oDswQqFfQrzUduPSExL5JHFj5CUnnTj9xIRkXxPxU3ynVvrlKZ2SCDvzNtFUuoNTMr7t0JloPcEOL0Hpg+HTNuI0kqFK/F2q7fZEb2Dl5a/9N+X3RIREcmi4ib5jpub4YWu1Tgem8zXf+23z0XLt4KOr8HO32HZP2uXtg5tzWMNHmPewXl8vvlz+9xLRETyLRU3yZcaVyhCx+rF+XTJPqLik+1z0Sb3Q+2+sHg07JqbvXlwjcHcXOFmPt74MQsOLbDPvUREJF+65uJmjClsjKlhjKlgjFHhk1zv2S5VSUnP5L0FNzgp79/+HqxQsjZMu9f26hTbSNORzUZSO7g2L/z1Ajuid9jnfiIiku9csYAZYwKNMc8bY7YAq4DPgZ+AQ8aYn40xN+VESBFHqBBckDualGXK2sPsOhFvn4t6+tpWVnD3tA1WSI4DwNvdmw9u+oAArwAeXvwwp5NO2+d+IiKSr1ztydkvwBGgpWVZVSzLamFZVrhlWaHAW8CtxpihDk8p4iCPtAujoLcHr8+241OwQqHQe6JtepDzBisU9S3KuLbjiE2J5dHFj5KacQPrpoqISL50xeJmWVYHy7K+syzr7CX2RViW9ahlWV87LJ2IgxUu4MXD7cL4c/cplu4+Zb8Ll28JnV6HXbNg6TvZm6sVqcZrzV9j06lNjFo5SiNNRUTkulzTt2rGmD+uZZtIbnRn07KUCfJj5MxtxCen2e/Cje+DOv1hyeuwa0725o7lOvJA3QeYuW8mE7dNtN/9REQkz7vaN24+xpggoGjW4ISgrD/lgNI5klDEwbw93Hnn9tocjknk6V822+8pmDHQ/T0oWRemDYNTu7N3Da89nE7lOjF23ViWRi61z/1ERCTPu9oTt/uAdUDVrH/+/WcG8JFjo4nknMYVivBs56rM2XqCr5YdsN+FPX2zVlbwyhqsEAvYRpq+2vxVqgZV5emlT7P3zF773VNERPKsq33j9oFlWeWBJy3LqmBZVvmsP3Usy1Jxkzzlnpbl6VKzBG/O3clqeyxC/7fAEOgzEc4cgGn3ZQ9W8PXw5cO2H+Lr4cuIRSM4k3zGfvcUEZE86WqvSlsAWJY17jL7A4wxNR0RTCSnGWN4+/balA3y46EfNxAVZ6eJeQHKtbANVtg9B/58K3tziQIl+OCmD4hKjOLxJY+TlmHHb+xERCTPudqr0l7GmBXGmP8ZY7oZYxoZY1oZY+42xnwH/A745kBOkRzh7+PJZ3c24FxyOg/+sJ60jEz7XbzRMKgzAP58E3bOyt5cO7g2Lzd7mYiTEby+5nWNNBURkcu62qvSx4DuwHGgN/AK8BhQCfjMsqxWlmWtdXhKkRxUubg/b/aqxdqDZ3hrzk77XfjvwQql6ttemZ43WOHmijcztOZQftn9Cz/u/NF+9xQRkTzlqtOBWJYVAwQAm4EFwF/AaaCqMaauQ9OJOMmtdUszqGlZvvrrALO3HLffhT19oO/3tn9O7p89WAHg4foP0yakDW+vfZuVx1ba754iIpJnXOuaow2A4UBJoBS20aadgS+NMU87KJuIU73QrTr1yhTiqZ83sTfqnP0uHFga+nwLZw7apgnJGqzgZtx4s9WblA8szxN/PsGhuEP2u6eIiOQJ11rcQoD6lmU9aVnWE9iKXDGgFTDYQdlEnMrLw41PBtbHx9Od+79fR0JKuv0uXrYZdH4Tds+FJW9kby7gWYBxbcfhYTx46I+HiEuNs989RUQk17vW4lYMSDnv5zSguGVZSf/aLpKnlAz05cP+9dh36hzPTtti34EDDe+BunfA0rdhx2/Zm0P8QxjbZiyR8ZE8/efTpGfasTCKiEiudq3FbRKw2hgz0hgzElgO/GCMKQBsd1g6ERfQvFJRnuhYhd82HWPiioP2u7Ax0G0MlG5gW4w+6p+BEOElwnmxyYssP7acMRFj7HdPERHJ1a6puFmW9SowDDib9We4ZVmvWJaVYFnWQMfFE3EN97euSPtqxXlt1g7WHYqx34U9faDPd7YVFiYPgKSz2bt6Ve7FHdXu4Psd3zN191T73VNERHKta33ihmVZEVkrKXxgWVaEI0OJuBo3N8OYPnUoXdiXByat5/Q5O34h8PdghbOHLhisAPBE+BM0K9WM11a/xrqT6+x3TxERyZWuubiJ5HeBvp58OrABZxPTGPHDBtLtOTlv2WbQ5S3YMw+WvJ692cPNg3dav0NIwRAeW/wYR88dtd89RUQk11FxE7kO1UsFMLpHLVbuj2bMgt1XP+F6hA+FenfC0ndg+8zszQFeAYxrO450K50Ri0aQkJZg3/uKiEiuoeImcp1ubxDCgMZl+HTJPuZvO2G/C2cPVgjPGqywI3tXucByvNv6Xfaf3c+zy54l07Lj0z4REck1VNxE/oP/da9O7ZBAnvhpEwdP2/EJmIc39P0OvAtmDVY4k72rWalmPNXwKZYcWcK4DePsd08REck1VNxE/gMfT3c+GVgfd3fD8O/XkZSaYb+LB5TKGqxwBKbeC5n/XHtA1QHcXvl2vtryFb/v/91+9xQRkVxBxU3kPwop7McH/eqx62Q8L0y38+S8ZZrYBivsXQCLR2dvNsbwfKPnCS8ezsjlI9l8arP97ikiIi5PxU3kBrSuHMyj7SozbcNRJq0+bN+Lh98N9e+CZWNg+4zszZ7unoxtM5Zgv2AeWfwIJxLs+J2diIi4NBU3kRs0om0l2lQJ5pXftrPxyFn7XdgY6PouhDSE6ffDyX8WKSnsU5iP2n5EYloiDy96mKT0JPvdV0REXJZDi5sx5htjTJQxZutl9lc1xqw0xqQYY578177Oxphdxpi9xphnz9te3hizOmv7FGOMlyN/B5GrcXMzvN+3LsH+3jzw/TpiElLtd3EPb9vKCpcYrFCpcCXebvU2O2N28tLyl+z7qlZERFySo5+4TQA6X2F/DPAw8O75G40x7sDHQBegOtDfGFM9a/dbwHuWZVUCzgBD7ZxZ5LoV8vPiszsacDohlUcmbyAj044lKqCkrbzFRsIvQy8YrNA6tDWPNXiMeQfn8fnmz+13TxERcUkOLW6WZS3FVs4utz/Ksqy1QNq/djUC9lqWtd+yrFRgMnCrMcYAbYFfso6bCNxm9+Ai/0GtkEBeuaUGy/ac5oOFdp6ct0xj6PoO7PsDFr16wa7BNQZzc4Wb+Xjjxyw4tMC+9xUREZfiqt+4lQaOnPdzZNa2IsBZy7LS/7VdxCX0bRhK7wYhfLhoL4t2nrTvxcOHQIPB8Nd7sG169mZjDCObjaR2cG1e+OsFdkTvuPw1REQkV3PV4nbDjDHDjDERxpiIU6dOOTuO5BPGGF69rSbVSwbw6OSNHIlJtO8NurwNIY3g1wfg5Lbszd7u3nxw0wcEeAXw8OKHOZ102r73FRERl+Cqxe0oEHrezyFZ26KBQsYYj39tv4hlWV9YlhVuWVZ4cHCwQ8OKnM/H053P7mgAwPDv15GcZsfJebNXVgiwDVZI/OdLhKK+RRnXdhyxKbE8svgRUjJS7HdfERFxCa5a3NYCYVkjSL2AfsBMyzZsbjFwe9Zxg4AZl7mGiNOUKeLHe33rsu1YHCNnbLv6CdfDv4StvMUehakXDlaoVqQarzV/jc2nNvPKylc00lREJI9x9HQgPwIrgSrGmEhjzFBjzHBjzPCs/SWMMZHA48CLWccEZH3D9hAwD9gB/GRZ1t//7fcM8LgxZi+2b96+duTvIPJftatWnIduqsSUiCNMWWvnyXlDG9kWpN+3CP4YdcGujuU68kDdB5i5byYTt020731FRMSpPK5+yH9nWVb/q+w/ge1156X2zQZmX2L7fmyjTkVc3mMdKrMp8iwvzdhGjVKB1CwdaL+LNxgExzfC8g+gZB2o2St71/Daw9l3dh9j142lQqEKtAppZb/7ioiI07jqq1KRPMHdzfBBv3oULeDF8O/XcTbRjpPzAnR+C0KbwIyH4MSW7M3GGF5t/ipVg6ry9NKn2Xtmr33vKyIiTqHiJuJgQQW8+HhgfU7GJfPYlI1k2nNyXg8v6PMt+ATC5IEXDFbw9fDlw7Yf4uvhy4hFIziTfOYKFxIRkdxAxU0kB9QrU5j/3VyDxbtO8dFiOz/98i8Ofb+H+OPwy92QkZ69q0SBEnxw0wdEJUbx+JLHSc2w8xM/ERHJUSpuIjnkjsZl6FGvNO8t3M3S3XaeWzAk3DZYYf/iiwYr1A6uzajmo4g4GcFjSx5TeRMRycVU3ERyiDGG13vUokpxfx6ZvIHIM3aenLf+XRA+FFZ8CFt+uWBX9wrdeanJSyyNXMqjix/VHG8iIrmUiptIDvL1cufTOxqQnmHx4KT1pKTbcXJegM5vQpmmtsEKxzdfsKtPlT78r+n/WHZ0mSboFRHJpVTcRHJY+aIFeLdPHTZFxvLKb9vte/G/Byv4FoYpFw5WAOhduTcjm45k+dHlPLJI5U1EJLdRcRNxgk41SnBf6wpMWn2Yqesi7XvxgsWyBiuchJ8HXzBYAeD2yrczqtkoVhxbwcOLHiY5Pdm+9xcREYdRcRNxkqc6VqFJhSBe+HULO47H2ffiIQ2g+1g48CcsHHnR7p5hPRnVbBQrj61UeRMRyUVU3EScxMPdjXH96xPo68nw79cRm5Rm3xvUuwMa3gsrP4LNP1+0u0dYD0Y1G8Wq46sYsWgESelJ9r2/iIjYnYqbiBMF+3vz8YD6HD2TxJM/b7Lv5LwAnd+AMs1g5gg4vumi3T3CevBq81dZfXw1I/5QeRMRcXUqbiJOFl4uiOe7VmPB9pN8vnS/fS/u7gl9JoJfEEy+A2KPXnTIrZVu5bUWr7HmxBoe+uMhEtPsPE2JiIjYjYqbiAsY0rwc3WuX5J15O1mx97R9L/73YIWkMzC+C5w5eNEht1S8hdEtRrP2xFoeWqTyJiLiqlTcRFyAMYa3etWmQnBBRvy4gROxdh4sULo+3DUDkmNhfFc4ffGyWzdXvJnRLUaz7uQ6HvzjQZU3EREXpOIm4iIKeHvw2R0NSE7L4IFJ60hNz7TvDUIawOBZkJ5ie/J28uI55G6ueDOvt3id9VHreeCPB1TeRERcjIqbiAupVKwgb99eh/WHz/L67B32v0GJmjBkDri5w4SucGzDRYd0q9CNN1q8wYaoDdy/8H6VNxERF6LiJuJiutUuydAW5Zmw4iAzNl48mOCGBVeGIbPByx8m3gKHV110SNcKXXmr5VtsOrWJ+xfeT0Jagv1ziIjIdVNxE3FBz3apSsNyhXl26hZ2n4y3/w2CKsDdc6BAMHzXA/b/edEhnct35s1Wb6q8iYi4EBU3ERfk6e7GRwPqU8Dbg+HfryM+2c6T8wIEhthemxYqC5N6w+75Fx3SuVxn3mr1FptPbWb4guGcSz1n/xwiInLNVNxEXFTxAB8+GlCPQ9GJPDN1M5Zl58l5AfyL2wYsFKsKkwfA9hkXHdKpXCfebvU2W05vYfhClTcREWdScRNxYU0qFOGZzlWYveUEX/91wDE3KVAE7poJperBz0Ng05SLDulYriPvtH6Hbae3cd/C+4hPdcDrWxERuSoVNxEXd2/LCnSuUYI35uxk9f5ox9zEtxDcOR3KNoPp90HE+IsO6VC2A++2fpftp7czfMFwlTcRESdQcRNxccYY3uldmzJBfjz04wai4uw8Oe/fvAvCwJ+hUnv4/VFY9elFh7Qr245327zL9ujt3LfgPuJS4xyTRURELknFTSQX8Pfx5LM7GnAuOZ2HfthAWoadJ+f9m6cv9JsEVbvD3Gdh6bsXHdKuTDvGtBnDjpgd3Ddf5U1EJCepuInkElVK+PNGz1qsORjD23N3Ou5GHt7QeyLU6gOLXoU/XoV/DYxoW6YtY1uPZeeZnQybP4zYlFjH5RERkWwqbiK5yG31SnNX07J8uewAs7ccd9yN3D2gx2dQ/y5Y9i7Me/6i8nZTmZt4r8177Dqzi2ELVN5ERHKCiptILvNit+rUK1OIp37exL5TDpyaw80dbv4QGg+HVZ/YvnvLvPAVbZvQNrzf5n32nNnDvfPvVXkTEXEwFTeRXMbLw41PBtbH29Od4d+tIyEl3XE3MwY6vwktHod1E+DX4ZBx4f1ah7bm/ZveZ+/ZvSpvIiIOpuImkguVDPRlXP967Dt1juembXHM5Lx/Mwbaj4S2L8LmKfDLEEhPveCQViGt+OCmD9h3dh/3zL+Hs8lnHZdHRCQfU3ETyaWaVyrKEx2rMHPTMSauOOj4G7Z6Cjq9DjtmwpQ7IO3CaUlahrTkg7YfsP/sfu6Zfw9nks84PpOISD6j4iaSi93fuiLtqxXjtVk7WHcoB4pS0weh+3uwZz780AdSL1x4vkXpFnzY9kMOxB5QeRMRcQAVN5FczM3NMKZPXUoV8uXBSes5fS7F8TcNv9s24vTgMviuJyRf+E1b89LNGdd2HIfiDjF0/lBikmMcn0lEJJ9QcRPJ5QJ9Pfn0jvqcSUxlxA8bSHfU5Lznq9MPbv8GjkbAxFsg8cJy1qx0Mz5s+yGH4w5zz/x7VN5EROxExU0kD6hRKpDRPWqxcn80YxbszqGb9oC+kyBqB0zoBueiLtjdrFQzxrUdx+G4wwydN5ToJAetsyoiko+ouInkEbc3CKF/ozJ8umQf87edyJmbVukMA6bAmYMwvgvEHr1gd9NSTfmo3UdExkdyz/x7VN5ERG6QiptIHjLy5urUDgnkiZ82cfB0wtVPsIeKN8Ed0yD+pK28nTl4we4mJZtkl7eh84ZyOul0zuQSEcmDVNxE8hAfT3c+GVgfd3fD8O/XkZSakTM3LtsUBs2wDVT4pguc3nPB7sYlG/NJ+084lnBM5U1E5AaouInkMSGF/Xi/b112nYznhV8dPDnv+Uo3gMGzIDPN9uTtxNYLdjcs0ZCP233M8YTj3D3vbk4lnsqZXCIieYiKm0ge1KZKMR5pF8a09Uf5Yc3hnLtxiZoweDa4edgGLBxdf8HuhiUa8km7TziRcELlTUTkP1BxE8mjHm4bRpsqwYyauZ1NR87m3I2DK8OQOeATAN/eCodXXbA7vEQ4n7b/lJOJJ7l73t1EJUZd5kIiIvJvKm4ieZSbm+G9PnUJ9vfmgUnriUlIvfpJ9hJU3lbeChaD73rA/iUX7G5QvAGftf+MqMQo7p53NycTTuZcNhGRXEzFTSQPK1zAi8/uaMCp+BQemZxDk/P+LTDEVt4Kl4NJfWD3vAt21y9en886fMapxFMMnT9U5U1E5BqouInkcbVCAnnl1hos23Oah37YQEp6Do00BdsTt8GzoFg1mDwQtv16we56xerxeYfPOZ10mrvn3c2JhByaf05EJJdScRPJB/o1KsP/uldn7rYT3PttDk4TAuAXBINmQun68MsQ2DT5gt11i9Xls/afEZ0crfImInIVKm4i+cTdLcrzdq/aLNtzikHfrCE+OS3nbu4TaJukt1wLmD4cIsZfsLtusbp83uFzziSfYcjcIRw/dzznsomI5CIqbiL5SJ+GoXzYrx7rD59h4FerOZOTAxa8C8KAnyCsA/z+KKz85ILddYLr8HmHzzmbcpYh81TeREQuRcVNJJ+5uU4pPr+zATtPxNP3i5VExSXn3M09fW0L01e7BeY9B0vfuWB37eDafNHhC+JS4hgybwjHzh3LuWwiIrmAiptIPtSuWnEmDG5I5Jkken++ksgziTl3cw8vuH081O4Li16DP16B81Z3qBVciy862srb3fPu5ui5o1e4mIhI/qLiJpJPNatUlO/vacyZhFR6f7aS/afO5dzN3T3gts+g/iBYNgbmPndBeatZtCZfdvySuNQ47p6r8iYi8jcVN5F8rH6Zwvw4rAmp6Zn0+XwlO47H5dzN3dzg5g+g8f2w+lP47RHI/Ge0a42iNfiy45ecSzvHkLlDiIyPzLlsIiIuSsVNJJ+rUSqQKfc1xcPNjb6fr2TD4TM5d3NjoPMb0PIJWD/RNuI0I/2fbEVs5S0hLYG7593NkfgjOZdNRMQFqbiJCJWKFeTn4U0p5OfFHV+tZuW+6Jy7uTHQ7n/Q9iXY8pNtrrf0f0a7Vi9Sna86fkVieqKtvMWpvIlI/qXiJiIAhAb58fPwppQq5Mvg8WtYvDOHF39v9SR0egN2zIQpAyEtKXtXtSLV+KrjVySlJzFk3hCVNxHJt1TcRCRb8QAfptzXlLDiBRn2XQSzNufwXGpNH4Du78OeBfBDH0j5Z8BE1aCqfN3xa1IyUhg8bzCH4w7nbDYREReg4iYiFwgq4MUP9zahTkghRvy4np8jcvjpVvgQ6PE5HPwLvu8JybHZu6oEVeGrjl+RmpHKkHlDOBR3KGeziYg4mYqbiFwkwMeTb4c2olnFojz1y2YmrjiYswHq9LXN9XZ0HUy8BRJjsnf9Xd7SMtK4e+7dHIzN4WwiIk6k4iYil+Tn5cFXg8LpUL04I2du4+PFe3M2QI3boN8PELUDJnSD+JPZu6oEVeGrTl+RlpnG3fPu5kDsgZzNJiLiJCpuInJZPp7ufDKwPrfWLcU783bx1tydWOdNlOtwlTvBwJ/gzEGY0BVi/5mIt3Lhynzd6WsyrAyGzhuq8iYi+YLDipsx5htjTJQxZutl9htjzIfGmL3GmM3GmPpZ228yxmw870+yMea2rH0TjDEHzttX11H5RcTG092NsX3q0r9RGT5dso+XZ24jMzMHy1uFNnDndDgXBeM7Q8w/BS2scBhfd7SVt7vn3c3eMzn8VFBEJIc58onbBKDzFfZ3AcKy/gwDPgWwLGuxZVl1LcuqC7QFEoH555331N/7Lcva6IDcIvIv7m6G13vU5N6W5Zm48hBPT91MekZmzgUo0wTumgEp8TC+K5zanb2rUuFKfNPpGyzL4s45d7IsclnO5RIRyWEOK26WZS0FYq5wyK3At5bNKqCQMabkv465HZhjWVYOroAtIpdijOH5rtV4tH0Yv6yL5OHJG0hNz8HyVro+DJ4FmWkwvguc+OdhfsVCFfmx24+ULliahxY9xMRtE3P2la6ISA5x5jdupYHz5xmIzNp2vn7Aj//aNjrr1ep7xhhvRwYUkQsZY3i0fWVe7FaN2VtOMOy7CJLTMq5+or0UrwFD5oC7l23AwtF12btKFizJt12+pW1oW96NeJeXlr9EakbqFS4mIpL7uOzghKynb7WAeedtfg6oCjQEgoBnrnD+MGNMhDEm4tSpUw7NKpLf3NOyAq/3qMWfu08x6Js1nEtJv/pJ9lI0DO6eAz6BMPFWOLQye5efpx9j2oxheJ3hzNg3g6HzhnI66XTOZRMRcTBnFrejQOh5P4dkbftbH2C6ZVlpf2+wLOt41qvVFGA80OhyF7cs6wvLssItywoPDg62c3QRGdC4DO/3rUvEoTMM/Go1ZxNz8OlW4XK2J2/+xW2T9O5bnL3LzbjxYN0Heaf1O+yM2Un/Wf3ZEb0j57KJiDiQM4vbTOCurNGlTYBYy7LOX1+nP/96Tfr3N3DGGAPcBlxyxKqI5Ixb65bm04H12XEsjn5frOJUfErO3TywtK28FS4PP/SF3fMu2N25XGcmdJlAppXJoLmDWHBoQc5lExFxEEdOB/IjsBKoYoyJNMYMNcYMN8YMzzpkNrAf2At8CTxw3rnlsD2N+/Nfl51kjNkCbAGKAq85Kr+IXJuONUrw9eBwDkUn0ufzlRw9m3T1k+ylYDEY/DsUrw6TB8CGSRfsrlGkBpO7TSasUBiPL3mcTzd9qkELIpKrmfzw/8TCw8OtiIgIZ8cQydMiDsYwZPxaAnw9mXRPY8oVLZBzN0+OhckD4eAyqDMAur4D3gWzd6dkpDBqxSh+2/8bHct25LUWr+Hr4Ztz+UREroMxZp1lWeGX2ueygxNEJHcJLxfEj8OakJSWQe/PV7LrRHzO3dwn0DbPW+tnYdOP8OVNF0wX4u3uzegWo3mswWMsOLSAQXMGcSLhRM7lExGxExU3EbGbmqUDmTKsCW4G+n6xks2RZ3Pu5m7ucNNztgKXHAtftYOI8ZD1VsEYw90172Zc23EcijtEv9/7senUppzLJyJiBypuImJXYcX9+fm+ZhT09mDAl6tZc+BK83A7QIXWMHw5lG0Gvz8Kv9wNyXHZu1uHtmZS10n4evgyZO4QZu6bmbP5RERugIqbiNhdmSJ+/DK8GcUDvLnrm9X8uTuH51IsGAwDp0K7kbB9BnzeCo5tyN5dqXAlfuj2A3WL1eWFv15gbMRYMjJzcCJhEZH/SMVNRByiRKAPU+5rSoWiBbln4lrmbj1+9ZPsyc0NWj4OQ2ZDRip81QFWfZb96rSwT2E+7/A5fSr3Yfy28Ty8+GHOpZ7L2YwiItdJxU1EHKZoQW9+HNaEWqUDefCHDUxbH5nzIco0geF/QaX2MPcZ2+jTRNvrW083T15q+hIvNH6B5UeXc8fsOzgSd+QqFxQRcR4VNxFxqEBfT74b2pjG5YN4/KdNfLfqUM6H8AuC/j9Cpzdgz3zbq9Mja7J396vaj886fMappFP0n92fNcfXXOFiIiLOo+ImIg5XwNuDbwY3pH21Yrz061Y++3NfzocwBpo+AEPngXGDbzrDX+9DZiYATUo24cduPxLkE8R9C+7jp10/5XxGEZGrUHETkRzh4+nOp3c0oHvtkrw5ZyfvztvlnFUMSjeA4cugWndYOBJ+6A0JtoXoywSUYVLXSTQp1YRXV73Ka6teIy0z7SoXFBHJOSpuIpJjPN3d+KBfPfqGh/LR4r2M+m07mZlOKG8+gdB7InQbAweWwWct4OBfAPh7+fNR248YXGMwU3ZN4f4F9xObEpvzGUVELkHFTURylLub4c1etbi7eXkmrDjIs9M2k+GM8mYMNLwH7lkIXgVg4s2w5C3IzMDdzZ0nwp/gteavsT5qPf1n9Wf/2f05n1FE5F9U3EQkxxljeKl7NR5uW4mfIiJ5ePIGUtMznROmZG0YtgRq3g5LXodvb4V423JYt1a6lW86fUNCWgIDZw9kaeRS52QUEcmi4iYiTmGM4fGOVXiuS1VmbT7O8O/XkZzmpElwvf2h5xdw68cQGQGfNoe9fwBQt1hdJnebTIh/CA/98RATtk5wzrd5IiKouImIk93XuiKv3VaTxbuiGDJ+LQkp6c4JYgzUu8P29K1AMHzfC/54BTLSKVmwJBM7T6R92faMWTeGF5e/SGpGqnNyiki+puImIk53R5OyjO1ThzUHY7jj69XEJjpxJGexqnDvIqh/JywbAxO6QWwkfp5+vNv6Xe6vcz8z983k7nl3czrptPNyiki+pOImIi6hR70QPh5Qn61HY+n35SpOn0txXhgvP7hlHPT8Ck5utY063TUHN+PGA3Uf4N3W77IrZhf9Z/VnR/QO5+UUkXxHxU1EXEbnmiX4alBDDpw+R5/PV3I8Nsm5gWr3hvuWQmAI/NgP5j4P6al0KteJiV0mYlkWg+YOYv7B+c7NKSL5hoqbiLiU1pWD+fbuxkTFpdD7s5Ucik5wbqAiFWHoQmg0DFZ9DN90gpgDVC9SncndJxNWOIwn/nyCTzd+SqblpJGxIpJvqLiJiMtpVD6IH+5tzLmUdHp/tpI9J+OdG8jTB7q+A32+g+h9trVOt/1KUd+ifNPpG26peAufbPqEJ/98ksS0ROdmFZE8TcVNRFxS7ZBCTBnWFAvo8/lKth51gdULqt8Cw5dC0TD4eRD8/jjemRavNX+NJxo8wcJDCxk8dzAnEk44O6mI5FEqbiLisqqU8Ofn+5ri5+VB/y9WEXEwxtmRoHA5GDIXmo2AiK/hq/aY6H0MrjmYj9p9xOH4w/T7vR8bozY6O6mI5EEqbiLi0soVLcDPw5sS7O/NnV+vYdmeU86OBB5e0PE1GPATxB21vTrd/BOtQloxqesk/Dz9uHve3czYO8PZSUUkj1FxExGXV6qQL1Pua0rZIn4MnRDB/G0u8iqycicY/heUrAPT7oUZD1LRrwQ/dP2BesXq8eLyFxkTMYaMTCetCCEieY6Km4jkCsH+3kwe1oRqpQK4f9J6Zmw86uxINoGlYdBv0Oop2DAJvmxLobjjfNbhM/pW6cuEbRMYsWgE51LPOTupiOQBKm4ikmsU8vNi0j2NaViuMI9O2cgPqw87O5KNuwe0fRHunA6JMfDFTXhu/JEXG7/Ai41fZMWxFQycPZDDcS6SV0RyLRU3EclVCnp7MGFII1pXDub56Vv4cul+Z0f6R8WbbK9OQxvBzBEw7V76lu/KFx2+IDo5mgGzB7D6+GpnpxSRXEzFTURyHR9Pd764M5yutUowevYO3luwG8uynB3Lxr+47clb2xdh61T4vBWN8ObHrj9SxKcI9y24j8k7Jzs7pYjkUipuIpIreXm48WG/etzeIIQP/tjD6Fk7XKe8ubnbvnkb9DukJcNX7QndOZdJXb6neenmjF49mtdWvUZaZpqzk4pILqPiJiK5loe7G2/3qs2gpmX56q8DPDBpPWcTU50d6x/lmttenVZoA7OfpOCv9/Nhk1cYUmMIU3ZNYfiC4ZxNPuvslCKSi6i4iUiu5uZmePmWGjzbpSoLtp+k8/vLWLH3tLNj/aNAEeg/xTbv2645uH/ZhsdLtGJ0i9FsiNpA/1n92Xd2n7NTikguoeImIrmeMYbhrSsy/YHm+Hm7M+Cr1YyetZ2UdBeZP83NzbbSwt3zwAK+6cQtJw/xTcevSUpPYuDsgSyNXOrslCKSC6i4iUieUSskkN9HtGBg4zJ8uewAt328gt3OXqD+fCHhtrVOK3eG+S9Sd+EbTG77KWX8y/DQHw8xfut41/lOT0RckoqbiOQpfl4ejO5Ri6/uCicqLpmbx/3FhOUHXKcQ+RaGvt9Dl3dg/2JKfNuTCTXup0PZDoxdN5YX/nqBlIwUZ6cUERel4iYieVL76sWZ+2grmlUswsu/bWfw+LVExSc7O5aNMdB4GAxdAJ4++H3Xk3dNcR6ocz+/7f+Nu+fdzekkF/pOT0RchoqbiORZwf7efDO4Ia/cWoNV+6Pp/P4yFmw/6exY/yhVF4b9CTV6YBaP5v7N8xjbZCR7zuyh3+/92B693dkJRcTFqLiJSJ5mjOGupuX4fUQLSgT4cO+3ETw3bQuJqenOjmbjEwC9voabP4TDq+gw8zm+rfUwxhgGzRnEvIPznJ1QRFyIipuI5Athxf2Z/mAz7mtVgclrD9P9w7/YHHnW2bFsjIEGg+DexeBbmKrTHuLHwCZUKVyZJ/98ko83fkymlenslCLiAlTcRCTf8PZw57mu1Zh0T2OS0jLo+ckKPl68l4xMFxm4ULw6DFsMdQdSdPmHfBMVw61lOvDZps948s8nSUxLdHZCEXEyFTcRyXeaVSzK3Eda0almCd6Zt4v+X6ziSIyLlCKvAnDbx9Djc7yObeLVNdN5suzN/HH4D+6Ycwe7YnY5O6GIOJGKm4jkS4F+nnzUvx5j+9Rh+/E4un6wjF83HHV2rH/U6Qf3/YkJKMWgJR/zSeHGxCTF0G9WP77a8hUZmS4yubCI5CgVNxHJt4wx9KwfwpxHWlKlhD+PTtnIwz9uIDbJRRZ/LxoG9yyE8KE0XzeF6WczuKlIXT5Y/wGD5w7mcNxhZycUkRym4iYi+V5okB+ThzXhiQ6VmbXlOF0/WMaq/dHOjmXj6Qvdx0KfbykcH8WYNdN40yeMfWf3cvtvtzN552TXmVxYRBxOxU1EBPBwd2NEuzB+Gd4UT3dD/y9X8dbcnaSmu8hozuq3woh1mJZP0G33MqYfOkI9z8KMXj2a4QuHcyLhhLMTikgOMPnhf6mFh4dbERERzo4hIrlEQko6r/y2nSkRR6hZOoD3+9ajUrGCzo71j5gDMP9FrJ2/81OxMozx98TD3YfnmzxPt/LdMMY4O6GI3ABjzDrLssIvtU9P3ERE/qWAtwdv3V6bz+5oQOSZJLqPW8b3qw65zivJoPLQbxLmrhn0pSC/HDpExbRUnlv2HE/8+QQxyTHOTigiDqLiJiJyGZ1rlmDeo61oWC6IF3/dyj0TIzh9zoUWgK/QBu5bRpmObzLhxGkejYllyaGF9Pj1NhYfXuzsdCLiAHpVKiJyFZmZFhNWHOTNuTsJ8PHgndvrcFPVYs6OdaHEGFjyBrs2TuT5YkXZ7enObRVv5ZlGz1LQy4Ve84rIVelVqYjIDXBzM9zdojwzH2pO0YLeDJmwlpd+3UpSqgvNpeYXBF3focrQJUz2rMi9Z2OZuXcGvaZ1Y+2Jtc5OJyJ2ouImInKNqpYI4NcHmzO0RXm+W3WImz/6i61HY50d60LFq+N510we7vgJE88ZPM+d5O55d/PW0udJTk92djoRuUEqbiIi18HH052Xulfnu6GNiEtKo8cny/nsz31kusp6p2BbtL5ad+ret4afwobQ71wy3x/4jT5T2rL12GpnpxORG6Bv3ERE/qMzCak8N20Lc7edoEmFIMb2qUupQr7OjnWxuOOsmPcYL8VtItrdnXtLtGRY+/fx9PB2djIRuQR94yYi4gCFC3jx6R31ebtXbTZHxtL5/aX8tumYs2NdLKAkzXpPZnrbz+ma6cNnJ/9i4HdN2LdzhrOTich1UnETEbkBxhj6NAxl9sMtqRBckBE/buDxKRuJT3aR9U7PE1C+Fa8PXsN75XpxgjT6rHyBiZO7kxEb6exoInKN9KpURMRO0jIyGbdoLx8t2kOpQr6837cu4eWCnB3rkk7HHuKVucNYnHyMBilpvFapHyEtnwVPH2dHE8n39KpURCQHeLq78XiHyvw8vCnGQJ/PVzJm/i7SMlxkvdPzFA0sywd95vJq3UfY5e1Nr0M/M/XLhljbZ0I++B/0IrmVnriJiDhAfHIaL8/cztT1kdQJLcT7fetSvmgBZ8e6pOPnjvPSwodYHbubVolJvOxXmeDO70Lx6s6OJpIv6YmbiEgO8/fxZEyfOnw8oD4HTyfQ7cNlTF5z2HXWOz1PyYIl+eLWn3k2/ClWFyhIj8xDzP22Pcx60rYig4i4DBU3EREH6la7JHMfbUnd0EI8O20L9323jpiEVGfHuoibcWNgjbv46dZphBapzlPFivD0wenEflQf1nwJGenOjigi6FWpiEiOyMy0+Oqv/bwzbxeF/bx4t3cdWlUOdnasS0rPTOfrLV/z2aZPKWzBKyeO06Jgeejypm1hexFxKKe9KjXGfGOMiTLGbL3MfmOM+dAYs9cYs9kYU/+8fRnGmI1Zf2aet728MWZ11jlTjDFejvwdRETswc3NMKxVRX59sDmBvp7c9c0aRv22jeQ0F1rvNIuHmwf31bmPSd1+ILBQOe4vUYxXPBNI/O42mDwQYg44O6JIvuXoV6UTgM5X2N8FCMv6Mwz49Lx9SZZl1c36c8t5298C3rMsqxJwBhhq38giIo5To1Qgv41oweBm5Ri//CC3frScHcfjnB3rkqoXqc7k7lMYXGMwv3gbelWqzvojy+DjRrBwFKScc3ZEkXzHocXNsqylwJW+bL0V+NayWQUUMsaUvNzBxhgDtAV+ydo0EbjNTnFFRHKEj6c7L99Sg/FDGhKdkMqtHy3nq2X7XWu90yze7t48Ef4E4zuPx/IJYHCxQoytWJ+U5WNhXAPYNBkyXW+6E5G8ytmDE0oDR877OTJrG4CPMSbCGLPKGHNb1rYiwFnLstIvcbyISK5yU5VizHu0Ja0qB/ParB3c9c0aTsYlOzvWJTUo3oCpt0ylV+VejE87Rr8aTdlZqDhMvw++7gCR+o5YJCc4u7hdSdmsD/MGAO8bYypez8nGmGFZxS/i1KlTjkkoInKDihT05su7GjC6R00iDsXQ6f2lzN163NmxLqmAZwFGNh3Jx+0+JjYzlf5e8XzR9E7SY4/AV+1g+v0Qf8LZMUXyNGcXt6NA6Hk/h2Rtw7Ksv/+5H1gC1AOisb1O9fj38f9mWdYXlmWFW5YVHhzsmiO3RETAtt7pwMZlmfVwS0IL+zH8+/U8/csmElJccwqOViGtmHbLNNqXbc+4E38yqGp9DjS+B7b+Ynt9umwspLnmk0OR3M7ZxW0mcFfW6NImQKxlWceNMYWNMd4AxpiiQHNgu2Wbu2QxcHvW+YOAGc4ILiJibxWDCzL1/mY80KYiP6+LpOuHy9hw+IyzY11SIZ9CvNP6Hd5u9TYH44/QJ3opk7q+RGb51vDHKPikMez4XctnidiZo6cD+RFYCVQxxkQaY4YaY4YbY4ZnHTIb2A/sBb4EHsjaXg2IMMZswlbU3rQsa3vWvmeAx40xe7F98/a1I38HEZGc5OXhxtOdqzL53iakZ1jc/tlKPli4h3QXXO8UoEv5Lky/dTrhJcJ5c+uXDAvy43jvb8DDF6YMhG9vhZPbr34hEbkmmoBXRMRFxSalMXLGVn7deIz6ZQrxXt+6lC3imuudWpbF1D1TeXvt27gbd54Nf4pbYk5hlrwOKfHQcCi0eQ78gpwdVcTlXWkCXhU3EREXN2PjUV78dSsp6ZkMblaOB9pUpJCfa849fiT+CC/+9SLro9bTNrQt/6v7MEVWfgoRX4NPINz0AjQYAu4eV7+YSD6l4qbiJiK53LGzSYyZv5tpGyIp6O3B8NYVGdK8HH5erleAMjIz+G77d3y44UP8vfz5X5P/0c6nBMx5Bg4ug2LVofObUKG1s6OKuCQVNxU3Eckjdp2I5935u1iw/STB/t483C6Mfg1D8XR39lizi+05s4cX/nqBHTE7uKXiLTzT8GkC9i+FeS/A2UNQtTt0fA2Cyjs7qohLUXFTcRORPGbdoRjemrOLNQdjKFvEj8c7VObm2qVwczPOjnaBtIw0Pt/8OV9t+YqivkV5tfmrNA2uBys/sk0bkpkOzR6CFo+Dd0FnxxVxCSpuKm4ikgdZlsWSXad4a+5Odp6Ip3rJAJ7uXIXWlYOxrRDoOrac2sLzfz3PwbiD9K/an8caPIZv4hnbmqebJ0PBEtD+ZajdB9zcnR1XxKlU3FTcRCQPy8y0+G3zMcbM383hmEQalw/imS5VqV+msLOjXSApPYkP13/I9zu+p1xAOUa3GE3t4NpwZI3t+7dj6yGoAjR9EOoMAC8/Z0cWcQoVNxU3EckHUtMzmbz2MB/+sZfT51LoWL04T3WqQlhxf2dHu8Dq46t5aflLnEw8ydCaQ7m/zv14GnfYMQOWf2grcL5B0OheaHgvFNTqN5K/qLipuIlIPpKQks745Qf4/M/9JKSm07N+CI91qEzpQr7OjpYtPjWet9a8xYx9M6gaVJXRLUZTuXBl20oLh1faCtzuOeDhA3X6Q9OHoGglZ8cWyREqbipuIpIPnUlI5ZMle5m48hBYcGfTsjx4UyWCCrjOHHCLDi9i1MpRxKfG81C9h7ir+l14uGVNcXJqt20Qw6bJkJEKVbpC84chtDG42Dd8Ivak4qbiJiL52LGzSby/cDe/rIvEz8uDe1tW4J6W5Sng7RpzwMUkx/DqyldZeHgh5QPL83iDx2kd0vqfARbnomDNF7D2K0g6AyENodkI23QiGsggeZCKm4qbiAh7o+J5d95u5m47QZECXoxoW4kBjcvi5eH8OeAsy2LJkSWMXTeWg3EHaViiIU+EP0GNIjX+OSg1ATb+YHsKd+YgFC5vG8hQd6AGMkieouKm4iYikm3D4TO8PXcXK/dHE1LYlyc6VuaWOqVxd4E54NIy05i6eyqfbPyEMyln6F6hOw/Xe5iSBUv+c1BmBuz4DVZ8CEfX2QYyNLwHGg3TQAbJE1TcVNxERC5gWRbL9pzmrbk72XYsjqol/HmqUxXaVi3mEnPAxafG883Wb/hu+3cA3Fn9TobWHEpBr/Mm6bUsOLzKVuB2zQZ3b6j790CGMCclF7lxKm4qbiIil5SZaTFry3HGzN/FwehEGpYrzNOdq9KwXJCzowFw/Nxxxm0Yx2/7fyPIJ4j769xPr8q98HTzvPDA03tsr1A3/ggZKbaBDM0ehjJNNJBBch0VNxU3EZErSsvI5KeII3ywcA9R8Sm0q1qMpzpXoWqJAGdHA2Bb9DbGRIxh7Ym1lAsox+MNHqdNaJuLnw6eOwVrv4Q1X0JSDJQOtw1kqHazBjJIrqHipuImInJNklIzGL/iAJ8u2ce5lHR61C3NYx0qExrk/I//LctiaeRSxqwbw4HYA4QXD+fJ8CepUbTGxQenJsLGSbDyYzhzAAqXs71CrTsAvArkeHaR66HipuImInJdziam8tmf+xm//ACZlsXAxmV5qG0lihb0dnY00jPTbQMYNn1CTHIM3Sp04+F6D1OqYKmLD87MgJ2/2yb0PRoBvoVtqzE0uhcKFsv58CLXQMVNxU1E5D85EZvMB3/s4aeII3h7uHFPywrc27I8/j6eVz/Zwc6lnuObrd/w7fZvsSyLO6rfwT217sHf6xJLfFkWHFkNK8bBzlng7gV1+tmewgVXzvnwIleg4qbiJiJyQ/adOsfY+buZteU4QQW8ePCmSgxsXAYfT+d/N3Yi4YRtAMO+3yjkXYjhdYbTu0rviwcw/O30Htsr1I0/nDeQYQSUaaqBDOISVNxU3ERE7GJz5FnembeLZXtOU7qQL4+2D6Nn/RCXmANue/R2xkSMYc2JNZQNKMtjDR6jbWjby09vctFAhgZZAxlu0UAGcSoVNxU3ERG7Wr7XNgfc5shYwooV5KlOVehQvbjT54CzLItlR5cxJmIM+2P3U79YfZ4Mf5JawbUuf1JqImz6wfYULmY/FCpre4Vab6AGMohTqLipuImI2J1lWczZeoJ35+1i/+kE6pcpxDOdq9K4QhFnRyM9M51pe6bx8caPiUmOoUv5LjxS/xFKFyx9+ZMyM2zfv634ECLXZg1k+HtFBg1kkJyj4qbiJiLiMOkZmfyyLpL3F+7hRFwybaoE81SnKtQoFejsaCSkJdgGMGz7lgwrgzuq3cE9te8hwOsq89MdXm0rcNkDGfpC0xEayCA5QsVNxU1ExOGS0zKYuOIgnyzZR2xSGrfUKcUTHStTtojzXzeeSDjBRxs+Yua+mQR4B3B/nfvpU7kPnu5XGR17ei+syhrIkJ4MlbvYvoMr20wDGcRhVNxU3EREckxsUhpfLN3H138dID3Don+jMoxoV4li/j7OjsbOmJ28G/Euq4+vpox/GR5r8BjtyrS7+rd5Cadh7Vew5gtIjIZS9aH5w1D1ZnD3yJnwkm+ouKm4iYjkuKi4ZD5ctIfJa47g6e7G0BblGda6AgFOngPOsiz+OvoXYyLGsC92H/WK1ePJ8CepHVz76ienJsKmH23romYPZHgQ6t2hgQxiNypuKm4iIk5z8HQCYxbs5rdNxyjk58kDbSpyV9NyTp8DLj0znV/3/spHGz4iOjmazuU680j9RwjxD7n6yZkZsGuO7Tu4I6vBp9A/Axn8izs8u+RtKm4qbiIiTrf1aCzvzNvFn7tPUTLQh0fbh9Grfgge7m5OzZWQlsCEbROYsHUCGVYGA6oO4N7a9xLofY2DKw6vhpXjYMfv4O4JtfvavoMLruLY4JJnqbipuImIuIyV+6J5a+5ONh45S4XgAjzVsQqda5Zw+hxwJxNO8vHGj/l176/4e/kzvM5w+lXpd/UBDH+L3pe1IsOkrIEMnbMGMjTXQAa5LipuKm4iIi7Fsizmbz/JO/N2sTfqHHVCAnm6c1WaVSzi9AK3K2YXYyLGsPL4SkL9Q3mswWO0L9P+2nNdaiDD3ysyaCCDXAMVNxU3ERGXlJFpMXV9JO8v2M2x2GSqlQxgQOMy3Fa3lFMXsrcsi+XHljMmYgx7z+6lbnBdnmz4JHWC61z7RdKSbAMZVnwEMfugUBkIvxtq9YbAa/iOTvItFTcVNxERl5aclsHU9ZFMWnWY7cfj8PNy59a6pRjQqCy1Qpw3kW9GZoZtAMPGjziddJpO5TrxSP1HCPUPvfaLZGbC7jm2And4BWCgXAtbgat+K/gWclR8yaVU3FTcRERyBcuy2BQZy6RVh/ht8zGS0zKpHRLIgEZluKVuKfy8nPOqMTEt0TaAYdsE0jLTGFB1AMNqD7v2AQx/i9kPW36BzVMgeq9tVYbKnWwDGsI6goe3Y34ByVVU3FTcRERyndikNKavj+SHNYfZffIc/t4e3FavNAMal6FayassWeUgUYlRfLzxY6bvmY6/lz/31b6PflX74eXudX0Xsiw4tgE2/wRbp0JCFPgEQvXbbCWuTFNwc+5oW3EeFTcVNxGRXMuyLCIOneGH1YeZteU4qemZ1C9TiIGNy9KtdkmnzAe3K2YX7617j+XHlhNSMIRHGzxKx7Id/9vAiox0OLDEVuJ2/A5pCRAYCrVut5W4YtXsnl9cm4qbipuISJ5wJiGVqesj+WH1YfafTiDQ15Ne9UMY0LgMlYoVzPE8y48uZ8y6Mew5s4c6wXV4MvxJ6har+98vmJoAO2fbXqXuWwRWBhSvBbX72IpcQCm7ZRfXpeKm4iYikqdYlsXK/dH8sPow87adIC3DonH5IAY0LkPnmiXw9si5p3AZmRnM3DeTcRvGcSrpFB3KduCx+o8RGnAdAxgu5dwp2DbNVuKOrgMMlG9pewpX7Wbbq1XJk1TcVNxERPKs0+dS+Dkikh/WHOJITBJBBbzo3SCE/o3KUK5ozq0fmpiWyMTtExm/dTxpmWn0q9KP+2rfRyGfQjd+8eh9tlepW36yDXBw94YqXWwlrlJ78LjOb+zEpam4qbiJiOR5mZkWf+09zaTVh1i4I4qMTIsWlYoyoHEZOlQvjmcOLa11KvGUbQDD3ukU8CzAfbXvo3/V/tc/gOFSLMv29O3vQQ2Jp8G3MNToYStxoY21SkMeoOKm4iYikq+cjEtmytojTF5zmGOxyQT7e9MnPIR+DcsQGuSXIxn2nNnD2HVj+evoX5QuWJpH6z9Kp3Kd7LcyREYa7Ftsewq343dIT7JN8lurj+2bOK2VmmupuKm4iYjkSxmZFn/ujmLSqsMs3hWFBbSuHMzAxmW5qUpwjixwv+LYCsZEjGH3md1UCKxAz7Ce3FzxZoJ8gux3k5R42DnL9iRu/2KwMqFkHdtTuJq9wL+E/e4lDqfipuImIpLvHT2bxJQ1h5m89ghR8SmUCPChX6NQ+jYMpWSgr0PvnZGZwewDs5myawqbTm3Cw82DtqFt6RXWiyalmuBm7Fgg40/aXqNu+ck2V5xxg/KtswY1dAdvf/vdSxxCxU3FTUREsqRlZPLHjih+WHOYpbtP4WagXbXiDGhchlZhwbi7OfYbsb1n9jJt7zR+2/cbZ1POUqpAKW4Lu40elXpQooCdn4yd3mN7Crd5Cpw9BB6+ULWr7XVqpXbg7rz1YOXyVNxU3ERE5BIORyfy49rD/BxxhNPnUgkp7Ev/RmXoHR5CMX8fh947NSOVRUcWMW33NFYeX4nB0Lx0c3qF9aJ1SGs87VmqLAuOrLE9hds6DZJiwK/IP4MaQhpqUIMLUXFTcRMRkStITc9k/vYT/LD6MCv2RePhZuhYozgDG5elaYUiuDn4KVxkfCS/7v2V6XunE5UYRZBPELdWvJUeYT0oH1jevjdLT4V9f9iexO2aDenJULjcP4MaiobZ935y3VTcVNxEROQa7T91jh/XHObndZGcTUyjXBE/+jcqw+0NQihS0LGLwGdkZrD82HKm7ZnGn0f+JN1Kp36x+vSq3IsOZTvg62Hnb/GS42DHb7Yncfv/BCwoVd9W4Gr2goLF7Hs/uSYqbipuIiJynZLTMpi79QSTVh9i7cEzeLm70blmCQY2LkOj8kH2m9bjMk4nnWbmvplM2zONQ3GHKOhZkG4VutEzrCfVi1S3/w3jjtsGNWyeAic2g3GHCm1sr1KrdgPvnF9SLL9ScVNxExGRG7D7ZDw/rD7M1PWRxCenU6lYQQY0KkOv+iEE+jn2A3/Lslh3ch3T9kxj/qH5pGSkUC2oGj3DetK1QlcCvALsf9OonbancJt/htjD4OlnK2+1+0KFm8Ddw/73lGwqbipuIiJiB0mpGfy++RiTVh9m45GzeHu40b12KQY0LkP9MoUc/hQuLjWO2ftnM3XPVHbG7MTb3ZuOZTvSM6wnDYo3sP/9MzPhyCrb93DbpkPyWSgQDDV62kpc6foa1OAAKm4qbiIiYmfbjsXyw+rD/LrhKAmpGVQt4c/AxmW4rV5p/H0cP83G9ujtTNszjVn7Z3Eu7RzlAsrRI6wHt1S8haK+Re1/w/QU2LvQ9ip111zISIGgCrYCV6s3FKlo/3vmUypuKm4iIuIg51LSmbnxGJNWH2LbsTj8vNy5pY7tKVztkEIOv39SehLzD85n2p5prI9aj4fxoHVoa3qG9aR5qea4u7nb/6bJsbB9pq3EHfwLsKB0ONS6HcI6qsTdIBU3FTcREXEwy7LYHGl7Cjdz0zGS0jKoVTqQAY3LcEudUhTwdvx3Yftj9/Prnl+ZsW8GMckxFPcrzm2VbqNHWA9KFyztmJvGHoWtv9hep57cattWuDxUam/7U74leBVwzL3zKBU3FTcREclBcclp/LrhKD+sPszOE/EU9Pbgtnql6Fk/hLohhRw+L1xaRhp/Rv7J1D1TWX50OQBNSjahZ+WetA1ti5e7l2NuHLMf9v5he6V6YCmkJYK7F5RtBpU62IpccBV9F3cVKm4qbiIi4gSWZbH+8BkmrT7M75uPk5qeSbC/N+2rFaND9eI0q1gUH08HvMo8z/Fzx7Mn9z2ecJxC3oW4ueLN9ArrRcVCDnylmZYMh1faStzehXBqp217YKhtua1K7W1rqPo4YFRsLqfipuImIiJOFpuUxpJdUczffpIlO6NISM3Az8udVmHBdKhenLZVi1G4gIOehGGb3HfV8VVM2zONRUcWkZ6ZTp3gOvQK60Wncp3w8/Rz2L0BOHvknxK3/09IjQc3DwhtYityYR2geE09jUPFTcVNRERcSkp6Biv3RbNwx0kWbo/iRFwy7m6G8LKF6VC9OB2rl6BMEccVqZjkGH7b9xtT90zlQOwBCngWoEv5LvQK60WNIjUcPq0J6akQucZW4vYshJNbbNsLlsj6Nq4dVLwJfAs7NoeLUnFTcRMRERdlWRZbjsayYPtJFmw/yc4T8QBUKe5Ph+rF6VC9OLVKBzrkuzjLsth4aiNTd09l/qH5JKUnUblwZXqG9aR7he4Eegfa/Z6XFHfctn7q3oWwb5Ft1Kpxg5CG/wxyKFkX3NxyJo+TqbipuImISC5xODqRBTtOsmD7CdYePENGpkXxAG/aV7OVuKYVi+DtYf/v4uJT45lzYA7T9kxjW/Q2vNy8aF+2Pb3CehFeIhw3k0OlKSMdjq7Leq26AI5tsG33KwIVs16pVmwLBRwwV52LcEpxM8Z8A3QHoizLqnmJ/Qb4AOgKJAKDLctab4ypC3wKBAAZwGjLsqZknTMBaA3EZl1msGVZG6+WRcVNRERyozMJqSzeFcWC7Sf5c/cpElMzKOjtQevKtu/ibqpSzCFLbu2M2cm0PdP4ff/vxKfGE+ofSs+wntxS8RaK+eXwwvPnTsH+xbBnge2pXGI0YKBUvX+exoWEgyPmq3MSZxW3VsA54NvLFLeuwAhsxa0x8IFlWY2NMZUBy7KsPcaYUsA6oJplWWezitvvlmX9cj1ZVNxERCS3S06zfRc3f/tJFu44yan4FNzdDI3LB9GhenHaVytOaJB9v4tLTk9m4eGFTNszjbUn1uJu3GkZ0pJeYb1oUboFHm45vGZpZiYc3/DPlCORa8HKBJ9Ctm/iKnWwfR/nXyJnc9mZ016VGmPKYStalypunwNLLMv6MevnXUAby7KO/+u4TcDtWUVuAipuIiKSz2VmWmyKPJv9XdyeqHMAVC3hT8fqxelQvQQ1SwfYdZDBobhDTN8znRn7ZnA66TTBvsG2yX0r9SA0INRu97kuiTGwf8k/o1XPnbRtL14LwrKexoU2BnfHL0FmT65a3H4H3rQs66+sn/8AnrEsK+K8YxoBE4EalmVlZhW3pkAK8AfwrGVZKVfLoeImIiJ52cHTCdklLuJQDJkWlAz0yf4urkmFInh52OcbtbTMNJZFLmPanmksO7qMTCuTxiUa0zOsJ+3KtsPb3dsu97lulmVbuWHPAtsTuSOrIDMdvPyhQut/XqsWclLJvA65srgZY0oCS4BBlmWtOm/bCcAL+ALYZ1nWK5e59zBgGECZMmUaHDp0yL6/nIiIiAuKPpfCop227+KW7TlNUloG/t4etK5i+y6uTZViBPra5wnUyYSTzNg3g2l7pnH03FG83LwoE1CG8oHlKR9YnnIB5agQWIFygeUo4JnDy14lx8GBP/+ZciQu0rY9uOo/Ja5sM/BwUtG8Alctbpd9VWqMCcBW2l6/3GtRY0wb4EnLsrpfLYeeuImISH6UnJbBX3tOs2D7Sf7YeZLT51LxcDM0qVAke6qRUoV8b/g+mVYma06sYfnR5RyMPciBuANExkeSYWVkH1PMrxjlA8pTLrCcrdgF2Mpd8QLFHT9i1bLg1C7bKNW9C+HQCshIBU8/KN/qnyIXVN6xOa6Rqxa3bsBD/DM44UPLshoZY7yAOcBvlmW9/69zSmYVOwO8ByRblvXs1XKouImISH6XkWmx8cgZ5me9Ut1/KgGAGqUCsktc9ZL2+y4uLSONI/FHOBB7gANxBzgQe8BW6mIPEJ8Wn32cr4cv5QLKUS6g3D9P6gLLUTagLL4eN14qLyk1AQ4s+2fKkTMHbduDKtoKXFgHKNscvBy8msRlOGtU6Y9AG6AocBIYCXgCWJb1WVb5+gjojG06kCGWZUUYY+4AxgPbzrvcYMuyNhpjFgHBgAE2AsMtyzp3tSwqbiIiIhfad+pc9ndx6w+fwbKgdCHf7BLXqHwQnu72fxJmWRbRydG2Qhd7gINxB7P/fuzcMSz+6SWlCpS66AlducByBPsG22/ghWVBzP6sV6oL4OAySE8GDx9befv7aVzRsBxbjksT8Kq4iYiIXNap+BQW7TyZ/V1cSnomAT4e3FS1GB2qF6d15WD8fRw/MjM5PZnD8YcvWeqS0pOyjyvgWeDC165Zxa5MQBm83G9wvde0JDi03DbAYc8CiN5j216ojK3AhQ+FEhe9SLQrFTcVNxERkWuSmJrOsqzv4hbtjCImIRVPd0PTikVtT+OqFadEoE+OZrIsi6jEqIteuR6IO8CJhBPZx7kZN0oXLJ09MOL8QRJBPkH/7SndmYP/zBu3/0/4f3t3H1rned5x/HtZku24lhUdO/GcytERbhLiOKGeJVNnsIV1GWkLyVhDaaG0HWGDwcbeCGxssLCxP9rsBTa6VxaSbWxdF9gw7doQuqzN2iZ+md2kyZbWraTEcV3bObIix7ElWdf+eE4Ux9Xso8bn5fH5fkBwpPOgc4mLI/103/dz3x96pJhKbSKDm8FNkqRlO7eQ7J+c4vHnj/L4899n4pXTANw2NMCdN2/kzls2ctPG/uYfSn8Rp+dOM/nq5GKQeyPUTbw6wdlzb+4Ytm7luh8IdCMDIwz1D9G3osHRxPnZYrq0yfvCGdwMbpIkvS2ZyaFjpxZvbjj40kkANleu4s6bf4Q7t25krDpIbxPWxf0wFnKBo68dXZxqPX/q9fjrxxev641ehvqHFtfPvbGWbmRghIFVA22p3eBmcJMk6bI6NnOGL/1PsV/cfx06wez8Av2retlRHWSsWmGsWuG2oQFW93XeGaIzszNvjtKdF+omX51kbmFu8brK6soPjNDduuFWBlcPNrU+g5vBTZKkpnnt7DxPfvs4X/7WCfZN1BaP4FrZs4LbhgYYG6kwVh1kx3Dlsm3+2wzzC/McOXXkLTdFvBHqamdqADz44w9y18hdTa3D4GZwkySpZWqvzbJ/coq9EzX2TtR49vA08wtJBNy0sZ+xaoXR6iA7RypsGmjSXm2X2fTZacanxxleN+yIW7MZ3CRJap/XZ89x8KWTi0HuvyeneG22OFVhaPCqxanVseog77p2bVtvdugEFwtuva0uRpIkdZerVvawa8t6dm1ZD8D8uQX+9+gMe8aLIPfkt0/wrwdeBmBwTR87hivsHBlktFph23UDrOztjBseOoEjbpIkqa0yk4lXThcjcuM19k1OMX6iOJJrdd8K3r35anZWK4yNVNh+/SBrV13Z405OlRrcJEkqlWMzZ9g/McWeiRr7JqZ47sg0Cwk9K4Ktm9YVa+SqFUarFa7pX9Xuci8rg5vBTZKkUjt1dp4DL06xd7zGnokaB186yZm5BQBGNryDsWoxtbqzWmF4/ZpSr5MzuBncJEm6oszOL/DNI9Psm6ixZ3yKfZM1Tp4u9mC7pn9VEeSGK+wcqXDzpnX0rChPkDO4GdwkSbqiLSwk3zl+ir0Tb25DcniqOJh+7apetl9/9eLU6vbrr+7IjYHfYHAzuEmS1HW+N/06e8aLNXJ7J2q88P0ZMqGvJ9j2zoHFIDc6PMjgO1a2u9xFBjeDmyRJXW/69Bz7X6wVo3LjNZ45PM3suWKd3A3XrmVspFIPc4MMDa5pW50GN4ObJEm6wJm5czxzeHpxanX/xBQzZ+cBuG5gNaP1LUjGqoPceG0/K1q0Ts4NeCVJki6wuq+HnSPFDQwA5xaSF47OLAa5p8dfYfc3jgAwcFUfo8OD/OIdWxitVtpWs8FNkiSJ+h5x161j63Xr+PjtVTKTw1P1dXKTNfaM15idX2hrjQY3SZKkJUQEmytr2FxZwwd3DLW7HAA8/EuSJKkkDG6SJEklYXCTJEkqCYObJElSSRjcJEmSSsLgJkmSVBIGN0mSpJIwuEmSJJWEwU2SJKkkDG6SJEklYXCTJEkqCYObJElSSRjcJEmSSsLgJkmSVBIGN0mSpJIwuEmSJJWEwU2SJKkkDG6SJEklYXCTJEkqCYObJElSSRjcJEmSSsLgJkmSVBIGN0mSpJKIzGx3DU0XEceBySa/zAbgRJNfQ8tnXzqPPelM9qXz2JPO1Iq+DGfmNUs90RXBrRUiYl9mjra7Dr2Vfek89qQz2ZfOY086U7v74lSpJElSSRjcJEmSSsLgdvn8dbsL0JLsS+exJ53JvnQee9KZ2toX17hJkiSVhCNukiRJJWFwW6aIuCsiXoiIQxHxm0s8vyoi/rn+/NMRUW1DmV2lgZ78ekQ8HxHPRMSXImK4HXV2m0v15bzrPhgRGRHePddkjfQkIj5Uf788FxH/2Ooau1EDv8Ouj4gnIuJA/ffY+9tRZzeJiIci4lhEfPP/eT4i4k/rPXsmIn60VbUZ3JYhInqATwPvA7YCH4mIrRdcdh8wlZnvAv4E+GRrq+wuDfbkADCambcBjwKfam2V3afBvhAR/cCvAE+3tsLu00hPIuIG4LeAH8vMW4BfbXWd3abB98rvAJ/NzO3Ah4E/b22VXelh4K6LPP8+4Ib6xy8Af9GCmgCD23LtBA5l5nczcxb4DHDPBdfcAzxSf/wo8N6IiBbW2G0u2ZPMfCIzT9c/fQoYanGN3aiR9wrA71P8c3OmlcV1qUZ68vPApzNzCiAzj7W4xm7USF8SWFd/PAAcaWF9XSkzvwLULnLJPcDfZeEp4OqI2NSK2gxuy/NO4KXzPj9c/9qS12TmPDANrG9Jdd2pkZ6c7z7gC02tSNBAX+pTC5sz8/OtLKyLNfJeuRG4MSK+GhFPRcTFRhx0eTTSlweAj0bEYeDfgV9uTWm6iOX+7blselvxIlIniIiPAqPAT7S7lm4XESuAPwY+0eZS9Fa9FFM/d1CMTH8lIm7NzJPtLEp8BHg4M/8oInYBfx8R2zJzod2FqfUccVuel4HN530+VP/aktdERC/FsPYrLamuOzXSEyLip4DfBu7OzLMtqq2bXaov/cA24D8jYgJ4D7DbGxSaqpH3ymFgd2bOZeY48C2KIKfmaaQv9wGfBcjMrwOrKc7LVPs09LenGQxuy7MXuCEiRiJiJcUi0d0XXLMb+Hj98b3Af6Sb5TXTJXsSEduBv6IIba7ZaY2L9iUzpzNzQ2ZWM7NKsfbw7szc155yu0Ijv7/+jWK0jYjYQDF1+t0W1tiNGunLi8B7ASLiZorgdrylVepCu4GP1e8ufQ8wnZnfa8ULO1W6DJk5HxG/BDwG9AAPZeZzEfF7wL7M3A38LcUw9iGKhY0fbl/FV74Ge/IgsBb4l/p9Ii9m5t1tK7oLNNgXtVCDPXkM+OmIeB44B9yfmc4YNFGDffkN4G8i4tcoblT4hAMCzRUR/0TxT8yG+trC3wX6ADLzLynWGr4fOAScBn6uZbXZe0mSpHJwqlSSJKkkDG6SJEklYXCTJEkqCYObJElSSRjcJEmSSsLgJqlrRcT6iDhY/zgaES/XH5+KiMt+kHdE/MwSB4hLUsPcDkSSgIh4ADiVmX/YxNd4GPhcZj7arNeQdGVzxE2SLhARd0TE5+qPH4iIRyLiyYiYjIifjYhPRcSzEfHFiOirX7cjIr4cEfsj4rGI2HTB97wduBt4sD6qt6X1P5mksjO4SdKlbQF+kiJ4/QPwRGbeCrwOfKAe3v4MuDczdwAPAX9w/jfIzK9RHJNzf2a+OzO/08ofQNKVwSOvJOnSvpCZcxHxLMWxRF+sf/1ZoArcBGwDHq8fq9YDtOTcQkndxeAmSZd2FiAzFyJi7rxzIhcofo8G8Fxm7mpXgZK6g1OlkvT2vQBcExG7ACKiLyJuWeK6GaC/pZVJuqIY3CTpbcrMWeBe4JMR8Q3gIHD7Epd+Brg/Ig54c4KkH4bbgUiSJJWEI26SJEklYXCTJEkqCYObJElSSRjcJEmSSsLgJkmSVBIGN0mSpJIwuEmSJJWEwU2SJKkk/g+w08YTEdcQ8gAAAABJRU5ErkJggg==\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter11_63_4.png" - }, - "needs_background": "light" - }, - "output_type": "display_data" - } - ], - "source": [ - "# Assume that all function definitions from the example program using Autograd\n", - "# are located here.\n", - "\n", - "if __name__ == '__main__':\n", - " npr.seed(4155)\n", - "\n", - " ## Decide the vales of arguments to the function to solve\n", - " Nt = 10\n", - " T = 1\n", - " t = np.linspace(0,T, Nt)\n", - "\n", - " ## Set up the initial parameters\n", - " num_hidden_neurons = [100,50,25]\n", - " num_iter = 1000\n", - " lmb = 1e-3\n", - "\n", - " P = solve_ode_deep_neural_network(t, num_hidden_neurons, num_iter, lmb)\n", - "\n", - " g_dnn_ag = g_trial_deep(t,P)\n", - " g_analytical = g_analytic(t)\n", - "\n", - " # Find the maximum absolute difference between the solutons:\n", - " diff_ag = np.max(np.abs(g_dnn_ag - g_analytical))\n", - " print(\"The max absolute difference between the solutions is: %g\"%diff_ag)\n", - "\n", - " plt.figure(figsize=(10,10))\n", - "\n", - " plt.title('Performance of neural network solving an ODE compared to the analytical solution')\n", - " plt.plot(t, g_analytical)\n", - " plt.plot(t, g_dnn_ag[0,:])\n", - " plt.legend(['analytical','nn'])\n", - " plt.xlabel('t')\n", - " plt.ylabel('g(t)')\n", - "\n", - " ## Find an approximation to the funtion using forward Euler\n", - "\n", - " alpha, A, g0 = get_parameters()\n", - " dt = T/(Nt - 1)\n", - "\n", - " # Perform forward Euler to solve the ODE\n", - " g_euler = np.zeros(Nt)\n", - " g_euler[0] = g0\n", - "\n", - " for i in range(1,Nt):\n", - " g_euler[i] = g_euler[i-1] + dt*(alpha*g_euler[i-1]*(A - g_euler[i-1]))\n", - "\n", - " # Print the errors done by each method\n", - " diff1 = np.max(np.abs(g_euler - g_analytical))\n", - " diff2 = np.max(np.abs(g_dnn_ag[0,:] - g_analytical))\n", - "\n", - " print('Max absolute difference between Euler method and analytical: %g'%diff1)\n", - " print('Max absolute difference between deep neural network and analytical: %g'%diff2)\n", - "\n", - " # Plot results\n", - " plt.figure(figsize=(10,10))\n", - "\n", - " plt.plot(t,g_euler)\n", - " plt.plot(t,g_analytical)\n", - " plt.plot(t,g_dnn_ag[0,:])\n", - "\n", - " plt.legend(['euler','analytical','dnn'])\n", - " plt.xlabel('Time t')\n", - " plt.ylabel('g(t)')\n", - "\n", - " plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Solving the one dimensional Poisson equation\n", - "\n", - "The Poisson equation for $g(x)$ in one dimension is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation} \\label{poisson} \\tag{13}\n", - " -g''(x) = f(x)\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $f(x)$ is a given function for $x \\in (0,1)$.\n", - "\n", - "The conditions that $g(x)$ is chosen to fulfill, are" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{align*}\n", - " g(0) &= 0 \\\\\n", - " g(1) &= 0\n", - "\\end{align*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "This equation can be solved numerically using programs where e.g Autograd and TensorFlow are used.\n", - "The results from the networks can then be compared to the analytical solution.\n", - "In addition, it could be interesting to see how a typical method for numerically solving second order ODEs compares to the neural networks.\n", - "\n", - "\n", - "Here, the function $g(x)$ to solve for follows the equation" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "-g''(x) = f(x),\\qquad x \\in (0,1)\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $f(x)$ is a given function, along with the chosen conditions" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{aligned}\n", - "g(0) = g(1) = 0\n", - "\\end{aligned}\\label{cond} \\tag{14}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In this example, we consider the case when $f(x) = (3x + x^2)\\exp(x)$.\n", - "\n", - "For this case, a possible trial solution satisfying the conditions could be" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "g_t(x) = x \\cdot (1-x) \\cdot N(P,x)\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The analytical solution for this problem is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "g(x) = x(1 - x)\\exp(x)\n", - "$$" - ] - }, - { - "cell_type": "code", - "execution_count": 5, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stderr", - "output_type": "stream", - "text": [ - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/numpy/core/_asarray.py:83: VisibleDeprecationWarning: Creating an ndarray from ragged nested sequences (which is a list-or-tuple of lists-or-tuples-or ndarrays with different lengths or shapes) is deprecated. If you meant to do this, you must specify 'dtype=object' when creating the ndarray\n", - " return array(a, dtype, copy=False, order=order)\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Initial cost: 457.256\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Final cost: 0.00310113\n", - "The max absolute difference between the solutions is: 0.000464088\n" - ] - }, - { - "data": { - "image/png": "iVBORw0KGgoAAAANSUhEUgAAAmEAAAJcCAYAAACxEXM4AAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjMuMywgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/Il7ecAAAACXBIWXMAAAsTAAALEwEAmpwYAABr90lEQVR4nO3dd3xb1eH+8c+RZzwSx4mz7Hhk7z0hQAiBEkbYe48CLRQotHy7B7S/trRAyyqjUFaBskkgbAgrZC+yp2M7znDsxI73Or8/pFBjnMR2LB+N5/165RVrWHqke3X16Or4HmOtRURERETal8d1ABEREZFwpBImIiIi4oBKmIiIiIgDKmEiIiIiDqiEiYiIiDigEiYiIiLigEqYA8aY7saYz4wx+40x97jO45oxpoMxZrYxptgY87LrPIdijLnSGPOF6xxHwhgz1RiT5+f7mGuMubYZ1zvGGLPen1kksDV3XWnD+8s2xkxvr/trjSPZzhhj0o0xpcaYiCPM0ObL5Uie+7Z6XIFGJayZfCtPhW8l2GWMecoYk9DKm7sO2AN0tNbe3oYxg9W5QHegi7X2PNdhXDDGZBpjrDEm0nWW9mSt/dxaO9B1juYwxpxmjFlojCkzxhQaY/5jjElrcPmVxpg63zai1Biz1Rjzb2PMgAbXObCcSxv9u8DNowpsxpjfGWOeO4Lff8oY84e2zBRoGhcba22OtTbBWlvnMteRCtXH1ZhKWMucbq1NAMYA44BfteSXjZcHyADW2FYcKTdE36QzgA3W2lqXIUL0uf2WcHiM/mCMORd4Hvg70BUYClQBXxhjOje46le+bUQnYDpQASwxxgxrdJNJvjeUA//+6/cH0Q60fom0kLVW/5rxD8gGpjc4/VfgLd/Pk4B5wD5gBTC1wfXmAn8EvsS7QX4OqAGqgVK8G+oYvBv3fN+/vwMxvt+fCuQB/wfsBJ4Ffge87Lut/cDXwADg58BuIBc4qUGGq4C1vutuAa5vcNmB27/d97s7gKsaXN4BuAfYBhQDXwAdDve4m3j+Bvuei33AamCm7/zf+56LGt/zcU0Tv/s74CXgGd9jWA2Ma3B5L+BVoADYCtzc4LKngD80fryNluv/ASvxvqlGAj8DNvvuaw1wVoPrXwl8cZDHmAlY4AogB+/ezl82uNzT4LYLfY8p2XdZju93S33/Jvue87G+yy/xXT7Ud/oa4A3fzy1dfxo/Bzf7HmdaE4+pH/Cpb9nvAf7b4LKjgEW+yxYBRzVa76/1ZdsHDGtwWQre10K3gyyPn/iWRzHwXyC2weV34F1H8323b4F+B1kerV7vG92O8S2LOxqd7wFWAXceat0A3gJeabSORDZzu5MM/Nv3ePceWOa+y74PbAKKgFlArwaXWeCHwEbf478L6Iv39VqCd92LbvRc/MK3jLOBSxrc1qnAMt/v5QK/a2KdvwbvOvyZ7/yrfc/9XuA9IKPB75wIrPMt3wfxrl/XNvHYT+bb24YVDV7vs3yPexPw/YM8d9fx7W3t7GauY6cBy/Gut/OAEYdYPv/wPSclwBLgmBZst5q1nQEeAu5pdL+zgB/jfT3X4309leJ9fRxYJpGHWoeAznjXzQLf+W/RYBuA7zV8kMc9AVjse9y7gHsbXDbT91j3+W5jcKPX9/TDbZub+bgOuh4c7rkPpH/OAwTLv0YrT2/fQr0LSMX7hnoK3o3yib7TKb7rzsW7cRqK9w0+qomV705gPt43pRS8L/y7GqyYtcBf8L6hdfCtYJXA93y3+Qze8vFL3+1/H9ja4PZPxbsBNsBxQDkwptHt3+n73VN8l3f2Xf6Q7zGkAhF433hjDve4Gz13Ub4XyS+AaGCa74UxsMEL5rlDPPcHHu8pvgx/Aub7LvPg3fj9xnfbffC+4X7Pd3nj53oq333TX+5bpgfK5Xl4X+Ae4AKgDOjpu+xKDl/CHvctp5F4i91g3+W3+JZzmu85fBR4odHvRja4vWeA230/P4Z3g/2DBpf9uJXrzzfPge95W9rUcvNd/gLe9coDxAJTfOcn491wX4Z3HbzId7pLg/X+Wt/PTwJ/bHCbNwLvHmJ5LPQ9/8l438hv8F12Mt4iORSIw/sh5FAlrNXrfaPbGeS7n6wmLvs93r1fB1038BaSXQdbzofZ7ryNtyR09uU8znf+NLyFaYxvuT6ArwD5LrfAm0BH/rfX7iO8r49OeN/0r2j0XNzru63j8K7zAxtcPty3DozA+6Z7ZqPH8wwQj3f9OgPv632wb934FTDPd/2ueF/75/oez499932wN/vf0WjbAHwGPIx3fRyFt0RMO8jvP0WD138z1rHReEv5RLzbmit81485yO1fCnTxPc7b8a6fsYfbbrVkO4O38OQDngbPYTnQvfF7U1PrGAdfh7oA5+B9LSXi/WD/RoPbmXuI5fIVcJnv5wRgku/nAb7HcaLvvu7wrQvRjbM2XjY0vS041OM66HpwuOc+kP45DxAs/3wrRCnedr/Nt/A74N3D8Gyj677H/zZwc/F9Um5weeOVbzNwSoPT3wOyfT9PxftJruEntd8BHzQ4fbovW4TvdKJvZU06yGN5A7ilwe1X8O03/91493J5fJeNbOI2Dvm4G51/DN6Nk6fBeS/g+0RN80rYhw1ODwEqfD9PBHIaXf/nwL8P8lw39UK/+jDLfjlwhu/nKzl8CWv4aXIhcKHv57XACQ0u64n3k3okTZewa4BZDX73WuBF3+lt/K9QtHT9mQpsx/um+wXQ6RCP/Rm8BTCt0fmXAQsbnfcVcGWD9f5ACZsObG5wvS+Byw+xPC5tcPpu4BHfz08Cf2pwWT8OUcJau9438XtTfPcT28RlNwAbD7Vu4C2PNY3WkX2N/g1u4vd64t0b0FQxfAK4u8HpBN+6lOk7bYGjG1y+BPi/BqfvAf7e4LmoBeIbXP4S8OuDPI9/B+5r9Hj6NLj8HRrs0ca7HSnHO+zgcr5dRAzevXDNKmF4PyzVAYkNzvsT8NRBfv8pmi5hB1vH/onvA0yDy9fjKy7NWMf24ttecojt1kF+dzkH2c7gff2f6Pv5JmBOo8fTZFk51DrUxP2PAvY2OD33EMvlM7wfQLo2Ov/XwEuNlv12fN+S0EYl7HDrQUufe5f/NCasZc601iZZazOstT+01lbg3bCcZ4zZd+Af3o12zwa/l3uY2+2F9031gG2+8w4osNZWNvqdXQ1+rgD22P8NWKzw/Z8AYIyZYYyZb4wp8uU7Be+nqQMK7bfHY5X7frcr3k8Zm5vI3JzH3fDx5Vpr6xs9xtQmrnswOxvli/WNP8kAejXK8Qu8A/2b61vLxxhzuTFmeYPbG8a3n6+WZj3wBxwZwOsNbnct3g3JwbJ+ChxjjOmJ99PcS8DRxphMvHszlvuu15r1Jwnv1zV/stYWH+Kx3IH3jXKhMWa1Mebqg9zngfttapl+AsQZYyb6so8CXj/EfR7s+evFt5fVIV9XR7DeN7bH939T63bPBpcfTCrer0wa6urblhz4t7aJ3+sNFFlr9zZx2beef2ttKd490Q2f/8bbiManGz7Wvdbasganv1mHfMvtE2NMgTGmGG/xbPx6aLgsMoB/NFjPi/CuQ6k0WobW+w55uO1jQ73wPif7G2VtybYEDv0avb3R9qQ33349fcMY8xNjzFrfX3bvw/u6bPjcHGy71dLtzNN497rh+//Z5j3Mg69Dxpg4Y8yjxphtxpgSvMUqqZl/fXgN3r1e64wxi4wxp/nOb7xe1uNdvi1dPofTnPXgoM99IFEJO3K5ePcINdygxltr/9zgOvYwt5GP98V/QLrvvOb+/kEZY2Lwjpf6G97d10nAHLwbxcPZg3eXbt8mLmvO4z4gH+jt+6OEA9LxfkI6Url4v3ptmCPRWnuK7/IyvLvbD+jRxG188/waYzLwfp14E96v1pLwjvtpzvPVnKwzGmWNtdZup4llbK3dhHfj8SO8XzWV4N2wXIf3U/KBUtua9Wcv3rEv/zbGHH2wwNbandba71trewHXAw8bY/o1cZ8H7vc7y9T34eAlvF9ZXoR3LOX+xtdrhh14v8o9oPfBrniE631j6/HurfnWX+761udz8H7NdyhnAZ+34n5zgWRjTFITl33r+TfGxOP9eqm1r6nOvts4oOE69DzesTe9rbWdgEf47vPYcB3LxTv+ruF63sFaOw/vMvxmuRljDIdYjnx33c3H+5wkNsp6sMfd0m1nLt6vzhtmj7PWvtD4isaYY/B+SDkf756mJLxjzA67jrViO/MccIYxZiTer3nfaHDZoR7jodah24GBwERrbUfg2APxDpffWrvRWnsR3iEQfwFe8a0/jdfLA8u3qeVzuG3zoR5XS9eDgKUSduSeA043xnzPGBNhjIk13uMwpR32N//nBeBXxpgUY0xXvON0Wv1n2Y1E4x3nUQDUGmNmACc15xd9b/JPAvcaY3r5Ht9k3xtcSx73Arxl4g5jTJQxZirer1BfPOJH5/26b78x5v+M93hjEcaYYcaY8b7LlwOnGGOSjTE9gFsPc3vxeF/8BQDGmKvwfkJtC48Af/RtgPEt7zN8lxXg/dqgT6Pf+RTvhvpT3+m5jU5DK9cfa+1cvAP+XzPGTGjqOsaY8xos0714n5t6vIVmgDHmYmNMpPEeYmEI3sG9TXke77iXS3w/t8ZLwFXGmMHGmDi8X30cTKvX+8Z8e2t+gvc5vti3rvcA/oV3zNV9jX/Htx5mGWMewPs1y+9bcb878H6197AxprPvtXPgjfIFvM/FKN/r8f8BC6y12a14iAf83hgT7SsXp+EdIwTe4Q1F1tpK33py8WFu5xHg58aYoQDGmE7GmAMF9m1gqDHmbN9eiZtp+oPRAbuAzAMf4Ky1uXjHPP7JtxxG4N0rc7D1fRfffU0dyuPADb69f8YYE2+MObXRm/0BiXi/xi0AIo0xv8G7PjRHi7Yz1to8vH/88izwqu9bmAMO+hgPsw4l4t0jus8Ykwz8tpnZMcZcaoxJ8b1H7POdXY/3NXqqMeYEY0wU3qJXhXeZNbacQ2+bD/W4WroeBCyVsCPkWxnOwPsVWAHeTx4/pWXP7R/w/qXJSrx/6bjUd15b5NuPd0P3Et430Yvxfqptrp/4Mi3C+7XCX/CO7Wr247bWVuMtXTPw7l17GO+YoHWte1Tfuu06vG8Yo/D+ccIevG+OnXxXeRbvX25mA+/jHaB6qNtbg3e8zFd4NwLD8Y5hagv/wPvcv2+M2Y93MP1E3/2W4/srWt/XE5N8v/Mp3o3lZwc5DUew/lhrP8A7cHy2MWZME1cZDywwxpT6st9ird1irS3E+7zfjvdrsDuA06y1TX41Z61dgPeTby+8bwotZq19B7gf79ebm/A+f+DdyDe+7pGu941v7794x8H9GO/jXYN3TOjRvufigMm+56oEb2HuCIy31n7d6Cb3mW8fJ+y2g9z1ZXjHeq3DO2btVl+eD/GW0Ffx7l3qC1zY2seHdw/rXrx7GP6Dd6D6gdfnD4E7fevsb/A+pwdlrX0d73biReP9mmsV3tc+vvXjPODPeJ/H/hz69XWgCBYaY5b6fr4I7/igfLxfa//W93w05QlgiO819cahcvvyLcb7h00P4n0+NuEdn9WU94B3gQ14vwqrpJlfrbZyO/O073qNv4r8E94PCPuMMT9p4veaXIfwju3rgHebOd/3WJrrZGC1b13/B95xrxXW2vV4vy59wHe7p+M9tFN1E7dxuG3z4R5XS9aDgGW8H/JERIKLMWYw3jf4GOv4GHPBzLdn+jlrbUv23ks78+3Beg7v4T70xh0itCdMRIKGMeYsY0yM8R4g9S94j/2kAiYhzffV3i3Av1TAQotKmIgEk+vxfqWyGe9flv7AbRwR//Lt8d2H9y9x/+40jLQ5fR0pIiIi4oD2hImIiIg4EHAHLjucrl272szMTNcxRERERA5ryZIle6y1KU1dFnQlLDMzk8WLF7uOISIiInJYxpjGs4t8Q19HioiIiDigEiYiIiLigEqYiIiIiANBNyZMREREjlxNTQ15eXlUVla6jhISYmNjSUtLIyoqqtm/oxImIiIShvLy8khMTCQzMxNjjOs4Qc1aS2FhIXl5eWRlZTX79/R1pIiISBiqrKykS5cuKmBtwBhDly5dWrxXUSVMREQkTKmAtZ3WPJcqYSIiIiIOqISJiIhIUHvqqae46aabDnud/Pz8b05fe+21rFmzpsX3NXfuXE477bQW/15TVMJEREQk5DUuYf/6178YMmSIw0QqYSIiIuLQmWeeydixYxk6dCiPPfYYAAkJCfzyl79k5MiRTJo0iV27dgEwe/ZsJk6cyOjRo5k+ffo35x+wf/9+srKyqKmpAaCkpISsrCxefvllFi9ezCWXXMKoUaOoqKhg6tSp30yD+O677zJmzBhGjhzJCSecAMDChQuZPHkyo0eP5qijjmL9+vVt/th1iAoREZEw9/vZq1mTX9KmtzmkV0d+e/rQw17vySefJDk5mYqKCsaPH88555xDWVkZkyZN4o9//CN33HEHjz/+OL/61a+YMmUK8+fPxxjDv/71L+6++27uueeeb24rMTGRqVOn8vbbb3PmmWfy4osvcvbZZ3Peeefx0EMP8be//Y1x48Z96/4LCgr4/ve/z2effUZWVhZFRUUADBo0iM8//5zIyEg+/PBDfvGLX/Dqq6+26XOkEiYiIiLO3H///bz++usA5ObmsnHjRqKjo78ZdzV27Fg++OADwHtsswsuuIAdO3ZQXV3d5DG5rr32Wu6++27OPPNM/v3vf/P4448f8v7nz5/Pscce+81tJScnA1BcXMwVV1zBxo0bMcZ8s3etLamEiYiIhLnm7LHyh7lz5/Lhhx/y1VdfERcXx9SpU6msrCQqKuqbQz5ERERQW1sLwI9+9CNuu+02Zs6cydy5c/nd7373nds8+uijyc7OZu7cudTV1TFs2LBWZfv1r3/N8ccfz+uvv052djZTp05t7cM8KI0JExERESeKi4vp3LkzcXFxrFu3jvnz5x/2+qmpqQA8/fTTB73e5ZdfzsUXX8xVV131zXmJiYns37//O9edNGkSn332GVu3bgX45uvIhvf11FNPtehxNZdKmIiIiDhx8sknU1tby+DBg/nZz37GpEmTDnn93/3ud5x33nmMHTuWrl27HvR6l1xyCXv37uWiiy765rwrr7ySG2644ZuB+QekpKTw2GOPcfbZZzNy5Egu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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter11_76_3.png" - }, - "needs_background": "light" - }, - "output_type": "display_data" - } - ], - "source": [ - "import autograd.numpy as np\n", - "from autograd import grad, elementwise_grad\n", - "import autograd.numpy.random as npr\n", - "from matplotlib import pyplot as plt\n", - "\n", - "def sigmoid(z):\n", - " return 1/(1 + np.exp(-z))\n", - "\n", - "def deep_neural_network(deep_params, x):\n", - " # N_hidden is the number of hidden layers\n", - " N_hidden = np.size(deep_params) - 1 # -1 since params consist of parameters to all the hidden layers AND the output layer\n", - "\n", - " # Assumes input x being an one-dimensional array\n", - " num_values = np.size(x)\n", - " x = x.reshape(-1, num_values)\n", - "\n", - " # Assume that the input layer does nothing to the input x\n", - " x_input = x\n", - "\n", - " # Due to multiple hidden layers, define a variable referencing to the\n", - " # output of the previous layer:\n", - " x_prev = x_input\n", - "\n", - " ## Hidden layers:\n", - "\n", - " for l in range(N_hidden):\n", - " # From the list of parameters P; find the correct weigths and bias for this layer\n", - " w_hidden = deep_params[l]\n", - "\n", - " # Add a row of ones to include bias\n", - " x_prev = np.concatenate((np.ones((1,num_values)), x_prev ), axis = 0)\n", - "\n", - " z_hidden = np.matmul(w_hidden, x_prev)\n", - " x_hidden = sigmoid(z_hidden)\n", - "\n", - " # Update x_prev such that next layer can use the output from this layer\n", - " x_prev = x_hidden\n", - "\n", - " ## Output layer:\n", - "\n", - " # Get the weights and bias for this layer\n", - " w_output = deep_params[-1]\n", - "\n", - " # Include bias:\n", - " x_prev = np.concatenate((np.ones((1,num_values)), x_prev), axis = 0)\n", - "\n", - " z_output = np.matmul(w_output, x_prev)\n", - " x_output = z_output\n", - "\n", - " return x_output\n", - "\n", - "def solve_ode_deep_neural_network(x, num_neurons, num_iter, lmb):\n", - " # num_hidden_neurons is now a list of number of neurons within each hidden layer\n", - "\n", - " # Find the number of hidden layers:\n", - " N_hidden = np.size(num_neurons)\n", - "\n", - " ## Set up initial weigths and biases\n", - "\n", - " # Initialize the list of parameters:\n", - " P = [None]*(N_hidden + 1) # + 1 to include the output layer\n", - "\n", - " P[0] = npr.randn(num_neurons[0], 2 )\n", - " for l in range(1,N_hidden):\n", - " P[l] = npr.randn(num_neurons[l], num_neurons[l-1] + 1) # +1 to include bias\n", - "\n", - " # For the output layer\n", - " P[-1] = npr.randn(1, num_neurons[-1] + 1 ) # +1 since bias is included\n", - "\n", - " print('Initial cost: %g'%cost_function_deep(P, x))\n", - "\n", - " ## Start finding the optimal weigths using gradient descent\n", - "\n", - " # Find the Python function that represents the gradient of the cost function\n", - " # w.r.t the 0-th input argument -- that is the weights and biases in the hidden and output layer\n", - " cost_function_deep_grad = grad(cost_function_deep,0)\n", - "\n", - " # Let the update be done num_iter times\n", - " for i in range(num_iter):\n", - " # Evaluate the gradient at the current weights and biases in P.\n", - " # The cost_grad consist now of N_hidden + 1 arrays; the gradient w.r.t the weights and biases\n", - " # in the hidden layers and output layers evaluated at x.\n", - " cost_deep_grad = cost_function_deep_grad(P, x)\n", - "\n", - " for l in range(N_hidden+1):\n", - " P[l] = P[l] - lmb * cost_deep_grad[l]\n", - "\n", - " print('Final cost: %g'%cost_function_deep(P, x))\n", - "\n", - " return P\n", - "\n", - "## Set up the cost function specified for this Poisson equation:\n", - "\n", - "# The right side of the ODE\n", - "def f(x):\n", - " return (3*x + x**2)*np.exp(x)\n", - "\n", - "def cost_function_deep(P, x):\n", - "\n", - " # Evaluate the trial function with the current parameters P\n", - " g_t = g_trial_deep(x,P)\n", - "\n", - " # Find the derivative w.r.t x of the trial function\n", - " d2_g_t = elementwise_grad(elementwise_grad(g_trial_deep,0))(x,P)\n", - "\n", - " right_side = f(x)\n", - "\n", - " err_sqr = (-d2_g_t - right_side)**2\n", - " cost_sum = np.sum(err_sqr)\n", - "\n", - " return cost_sum/np.size(err_sqr)\n", - "\n", - "# The trial solution:\n", - "def g_trial_deep(x,P):\n", - " return x*(1-x)*deep_neural_network(P,x)\n", - "\n", - "# The analytic solution;\n", - "def g_analytic(x):\n", - " return x*(1-x)*np.exp(x)\n", - "\n", - "if __name__ == '__main__':\n", - " npr.seed(4155)\n", - "\n", - " ## Decide the vales of arguments to the function to solve\n", - " Nx = 10\n", - " x = np.linspace(0,1, Nx)\n", - "\n", - " ## Set up the initial parameters\n", - " num_hidden_neurons = [200,100]\n", - " num_iter = 1000\n", - " lmb = 1e-3\n", - "\n", - " P = solve_ode_deep_neural_network(x, num_hidden_neurons, num_iter, lmb)\n", - "\n", - " g_dnn_ag = g_trial_deep(x,P)\n", - " g_analytical = g_analytic(x)\n", - "\n", - " # Find the maximum absolute difference between the solutons:\n", - " max_diff = np.max(np.abs(g_dnn_ag - g_analytical))\n", - " print(\"The max absolute difference between the solutions is: %g\"%max_diff)\n", - "\n", - " plt.figure(figsize=(10,10))\n", - "\n", - " plt.title('Performance of neural network solving an ODE compared to the analytical solution')\n", - " plt.plot(x, g_analytical)\n", - " plt.plot(x, g_dnn_ag[0,:])\n", - " plt.legend(['analytical','nn'])\n", - " plt.xlabel('x')\n", - " plt.ylabel('g(x)')\n", - " plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "### Comparing with a numerical scheme\n", - "\n", - "The Poisson equation is possible to solve using Taylor series to approximate the second derivative.\n", - "\n", - "Using Taylor series, the second derivative can be expressed as\n", - "\n", - "$$\n", - "g''(x) = \\frac{g(x + \\Delta x) - 2g(x) + g(x-\\Delta x)}{\\Delta x^2} + E_{\\Delta x}(x)\n", - "$$\n", - "\n", - "where $\\Delta x$ is a small step size and $E_{\\Delta x}(x)$ being the error term.\n", - "\n", - "Looking away from the error terms gives an approximation to the second derivative:" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation} \\label{approx} \\tag{15}\n", - "g''(x) \\approx \\frac{g(x + \\Delta x) - 2g(x) + g(x-\\Delta x)}{\\Delta x^2}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "If $x_i = i \\Delta x = x_{i-1} + \\Delta x$ and $g_i = g(x_i)$ for $i = 1,\\dots N_x - 2$ with $N_x$ being the number of values for $x$, ([15](#approx)) becomes" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{aligned}\n", - "g''(x_i) &\\approx \\frac{g(x_i + \\Delta x) - 2g(x_i) + g(x_i -\\Delta x)}{\\Delta x^2} \\\\\n", - "&= \\frac{g_{i+1} - 2g_i + g_{i-1}}{\\Delta x^2}\n", - "\\end{aligned}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Since we know from our problem that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{aligned}\n", - "-g''(x) &= f(x) \\\\\n", - "&= (3x + x^2)\\exp(x)\n", - "\\end{aligned}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "along with the conditions $g(0) = g(1) = 0$,\n", - "the following scheme can be used to find an approximate solution for $g(x)$ numerically:" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - " \\begin{aligned}\n", - " -\\Big( \\frac{g_{i+1} - 2g_i + g_{i-1}}{\\Delta x^2} \\Big) &= f(x_i) \\\\\n", - " -g_{i+1} + 2g_i - g_{i-1} &= \\Delta x^2 f(x_i)\n", - " \\end{aligned}\n", - "\\end{equation} \\label{odesys} \\tag{16}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "for $i = 1, \\dots, N_x - 2$ where $g_0 = g_{N_x - 1} = 0$ and $f(x_i) = (3x_i + x_i^2)\\exp(x_i)$, which is given for our specific problem.\n", - "\n", - "The equation can be rewritten into a matrix equation:" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{aligned}\n", - "\\begin{pmatrix}\n", - "2 & -1 & 0 & \\dots & 0 \\\\\n", - "-1 & 2 & -1 & \\dots & 0 \\\\\n", - "\\vdots & & \\ddots & & \\vdots \\\\\n", - "0 & \\dots & -1 & 2 & -1 \\\\\n", - "0 & \\dots & 0 & -1 & 2\\\\\n", - "\\end{pmatrix}\n", - "\\begin{pmatrix}\n", - "g_1 \\\\\n", - "g_2 \\\\\n", - "\\vdots \\\\\n", - "g_{N_x - 3} \\\\\n", - "g_{N_x - 2}\n", - "\\end{pmatrix}\n", - "&=\n", - "\\Delta x^2\n", - "\\begin{pmatrix}\n", - "f(x_1) \\\\\n", - "f(x_2) \\\\\n", - "\\vdots \\\\\n", - "f(x_{N_x - 3}) \\\\\n", - "f(x_{N_x - 2})\n", - "\\end{pmatrix} \\\\\n", - "\\boldsymbol{A}\\boldsymbol{g} &= \\boldsymbol{f},\n", - "\\end{aligned}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which makes it possible to solve for the vector $\\boldsymbol{g}$.\n", - "\n", - "\n", - "We can then compare the result from this numerical scheme with the output from our network using Autograd:" - ] - }, - { - "cell_type": "code", - "execution_count": 6, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Initial cost: 457.256\n" - ] - }, - { - "name": "stderr", - "output_type": "stream", - "text": [ - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/numpy/core/_asarray.py:83: VisibleDeprecationWarning: Creating an ndarray from ragged nested sequences (which is a list-or-tuple of lists-or-tuples-or ndarrays with different lengths or shapes) is deprecated. If you meant to do this, you must specify 'dtype=object' when creating the ndarray\n", - " return array(a, dtype, copy=False, order=order)\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Final cost: 0.00310113\n", - "The max absolute difference between the analytical solution and DNN Autograd: 0.000464088\n", - "The max absolute difference between the analytical solution and numerical scheme: 0.00266858\n" - ] - }, - { - "data": { - "image/png": "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REREjlxNTQ15eXlUVla6jhISYmNjSUtLIyoqqtm/oxImIiIShvLy8khMTCQzMxNjjOs4Qc1aS2FhIXl5eWRlZTX79/R1pIiISBiqrKykS5cuKmBtwBhDly5dWrxXUSVMREQkTKmAtZ3WPJcqYSIiIiIOqISJiIhIUHvqqae46aabDnud/Pz8b05fe+21rFmzpsX3NXfuXE477bQW/15TVMJEREQk5DUuYf/6178YMmSIw0QqYSIiIuLQmWeeydixYxk6dCiPPfYYAAkJCfzyl79k5MiRTJo0iV27dgEwe/ZsJk6cyOjRo5k+ffo35x+wf/9+srKyqKmpAaCkpISsrCxefvllFi9ezCWXXMKoUaOoqKhg6tSp30yD+O677zJmzBhGjhzJCSecAMDChQuZPHkyo0eP5qijjmL9+vVt/th1iAoREZEw9/vZq1mTX9KmtzmkV0d+e/rQw17vySefJDk5mYqKCsaPH88555xDWVkZkyZN4o9//CN33HEHjz/+OL/61a+YMmUK8+fPxxjDv/71L+6++27uueeeb24rMTGRqVOn8vbbb3PmmWfy4osvcvbZZ3Peeefx0EMP8be//Y1x48Z96/4LCgr4/ve/z2effUZWVhZFRUUADBo0iM8//5zIyEg+/PBDfvGLX/Dqq6+26XOkEiYiIiLO3H///bz++usA5ObmsnHjRqKjo78ZdzV27Fg++OADwHtsswsuuIAdO3ZQXV3d5DG5rr32Wu6++27OPPNM/v3vf/P4448f8v7nz5/Pscce+81tJScnA1BcXMwVV1zBxo0bMcZ8s3etLamEiYiIhLnm7LHyh7lz5/Lhhx/y1VdfERcXx9SpU6msrCQqKuqbQz5ERERQW1sLwI9+9CNuu+02Zs6cydy5c/nd7373nds8+uijyc7OZu7cudTV1TFs2LBWZfv1r3/N8ccfz+uvv052djZTp05t7cM8KI0JExERESeKi4vp3LkzcXFxrFu3jvnz5x/2+qmpqQA8/fTTB73e5ZdfzsUXX8xVV131zXmJiYns37//O9edNGkSn332GVu3bgX45uvIhvf11FNPtehxNZdKmIiIiDhx8sknU1tby+DBg/nZz37GpEmTDnn93/3ud5x33nmMHTuWrl27HvR6l1xyCXv37uWiiy765rwrr7ySG2644ZuB+QekpKTw2GOPcfbZZzNy5Egu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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter11_88_3.png" - }, - "needs_background": "light" - }, - "output_type": "display_data" - }, - { - "data": { - "image/png": "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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter11_88_4.png" - }, - "needs_background": "light" - }, - "output_type": "display_data" - } - ], - "source": [ - "import autograd.numpy as np\n", - "from autograd import grad, elementwise_grad\n", - "import autograd.numpy.random as npr\n", - "from matplotlib import pyplot as plt\n", - "\n", - "def sigmoid(z):\n", - " return 1/(1 + np.exp(-z))\n", - "\n", - "def deep_neural_network(deep_params, x):\n", - " # N_hidden is the number of hidden layers\n", - " N_hidden = np.size(deep_params) - 1 # -1 since params consist of parameters to all the hidden layers AND the output layer\n", - "\n", - " # Assumes input x being an one-dimensional array\n", - " num_values = np.size(x)\n", - " x = x.reshape(-1, num_values)\n", - "\n", - " # Assume that the input layer does nothing to the input x\n", - " x_input = x\n", - "\n", - " # Due to multiple hidden layers, define a variable referencing to the\n", - " # output of the previous layer:\n", - " x_prev = x_input\n", - "\n", - " ## Hidden layers:\n", - "\n", - " for l in range(N_hidden):\n", - " # From the list of parameters P; find the correct weigths and bias for this layer\n", - " w_hidden = deep_params[l]\n", - "\n", - " # Add a row of ones to include bias\n", - " x_prev = np.concatenate((np.ones((1,num_values)), x_prev ), axis = 0)\n", - "\n", - " z_hidden = np.matmul(w_hidden, x_prev)\n", - " x_hidden = sigmoid(z_hidden)\n", - "\n", - " # Update x_prev such that next layer can use the output from this layer\n", - " x_prev = x_hidden\n", - "\n", - " ## Output layer:\n", - "\n", - " # Get the weights and bias for this layer\n", - " w_output = deep_params[-1]\n", - "\n", - " # Include bias:\n", - " x_prev = np.concatenate((np.ones((1,num_values)), x_prev), axis = 0)\n", - "\n", - " z_output = np.matmul(w_output, x_prev)\n", - " x_output = z_output\n", - "\n", - " return x_output\n", - "\n", - "def solve_ode_deep_neural_network(x, num_neurons, num_iter, lmb):\n", - " # num_hidden_neurons is now a list of number of neurons within each hidden layer\n", - "\n", - " # Find the number of hidden layers:\n", - " N_hidden = np.size(num_neurons)\n", - "\n", - " ## Set up initial weigths and biases\n", - "\n", - " # Initialize the list of parameters:\n", - " P = [None]*(N_hidden + 1) # + 1 to include the output layer\n", - "\n", - " P[0] = npr.randn(num_neurons[0], 2 )\n", - " for l in range(1,N_hidden):\n", - " P[l] = npr.randn(num_neurons[l], num_neurons[l-1] + 1) # +1 to include bias\n", - "\n", - " # For the output layer\n", - " P[-1] = npr.randn(1, num_neurons[-1] + 1 ) # +1 since bias is included\n", - "\n", - " print('Initial cost: %g'%cost_function_deep(P, x))\n", - "\n", - " ## Start finding the optimal weigths using gradient descent\n", - "\n", - " # Find the Python function that represents the gradient of the cost function\n", - " # w.r.t the 0-th input argument -- that is the weights and biases in the hidden and output layer\n", - " cost_function_deep_grad = grad(cost_function_deep,0)\n", - "\n", - " # Let the update be done num_iter times\n", - " for i in range(num_iter):\n", - " # Evaluate the gradient at the current weights and biases in P.\n", - " # The cost_grad consist now of N_hidden + 1 arrays; the gradient w.r.t the weights and biases\n", - " # in the hidden layers and output layers evaluated at x.\n", - " cost_deep_grad = cost_function_deep_grad(P, x)\n", - "\n", - " for l in range(N_hidden+1):\n", - " P[l] = P[l] - lmb * cost_deep_grad[l]\n", - "\n", - " print('Final cost: %g'%cost_function_deep(P, x))\n", - "\n", - " return P\n", - "\n", - "## Set up the cost function specified for this Poisson equation:\n", - "\n", - "# The right side of the ODE\n", - "def f(x):\n", - " return (3*x + x**2)*np.exp(x)\n", - "\n", - "def cost_function_deep(P, x):\n", - "\n", - " # Evaluate the trial function with the current parameters P\n", - " g_t = g_trial_deep(x,P)\n", - "\n", - " # Find the derivative w.r.t x of the trial function\n", - " d2_g_t = elementwise_grad(elementwise_grad(g_trial_deep,0))(x,P)\n", - "\n", - " right_side = f(x)\n", - "\n", - " err_sqr = (-d2_g_t - right_side)**2\n", - " cost_sum = np.sum(err_sqr)\n", - "\n", - " return cost_sum/np.size(err_sqr)\n", - "\n", - "# The trial solution:\n", - "def g_trial_deep(x,P):\n", - " return x*(1-x)*deep_neural_network(P,x)\n", - "\n", - "# The analytic solution;\n", - "def g_analytic(x):\n", - " return x*(1-x)*np.exp(x)\n", - "\n", - "if __name__ == '__main__':\n", - " npr.seed(4155)\n", - "\n", - " ## Decide the vales of arguments to the function to solve\n", - " Nx = 10\n", - " x = np.linspace(0,1, Nx)\n", - "\n", - " ## Set up the initial parameters\n", - " num_hidden_neurons = [200,100]\n", - " num_iter = 1000\n", - " lmb = 1e-3\n", - "\n", - " P = solve_ode_deep_neural_network(x, num_hidden_neurons, num_iter, lmb)\n", - "\n", - " g_dnn_ag = g_trial_deep(x,P)\n", - " g_analytical = g_analytic(x)\n", - "\n", - " # Find the maximum absolute difference between the solutons:\n", - "\n", - " plt.figure(figsize=(10,10))\n", - "\n", - " plt.title('Performance of neural network solving an ODE compared to the analytical solution')\n", - " plt.plot(x, g_analytical)\n", - " plt.plot(x, g_dnn_ag[0,:])\n", - " plt.legend(['analytical','nn'])\n", - " plt.xlabel('x')\n", - " plt.ylabel('g(x)')\n", - "\n", - " ## Perform the computation using the numerical scheme\n", - "\n", - " dx = 1/(Nx - 1)\n", - "\n", - " # Set up the matrix A\n", - " A = np.zeros((Nx-2,Nx-2))\n", - "\n", - " A[0,0] = 2\n", - " A[0,1] = -1\n", - "\n", - " for i in range(1,Nx-3):\n", - " A[i,i-1] = -1\n", - " A[i,i] = 2\n", - " A[i,i+1] = -1\n", - "\n", - " A[Nx - 3, Nx - 4] = -1\n", - " A[Nx - 3, Nx - 3] = 2\n", - "\n", - " # Set up the vector f\n", - " f_vec = dx**2 * f(x[1:-1])\n", - "\n", - " # Solve the equation\n", - " g_res = np.linalg.solve(A,f_vec)\n", - "\n", - " g_vec = np.zeros(Nx)\n", - " g_vec[1:-1] = g_res\n", - "\n", - " # Print the differences between each method\n", - " max_diff1 = np.max(np.abs(g_dnn_ag - g_analytical))\n", - " max_diff2 = np.max(np.abs(g_vec - g_analytical))\n", - " print(\"The max absolute difference between the analytical solution and DNN Autograd: %g\"%max_diff1)\n", - " print(\"The max absolute difference between the analytical solution and numerical scheme: %g\"%max_diff2)\n", - "\n", - " # Plot the results\n", - " plt.figure(figsize=(10,10))\n", - "\n", - " plt.plot(x,g_vec)\n", - " plt.plot(x,g_analytical)\n", - " plt.plot(x,g_dnn_ag[0,:])\n", - "\n", - " plt.legend(['numerical scheme','analytical','dnn'])\n", - " plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Partial Differential Equations\n", - "\n", - "A partial differential equation (PDE) has a solution here the function\n", - "is defined by multiple variables. The equation may involve all kinds\n", - "of combinations of which variables the function is differentiated with\n", - "respect to.\n", - "\n", - "In general, a partial differential equation for a function $g(x_1,\\dots,x_N)$ with $N$ variables may be expressed as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation} \\label{PDE} \\tag{17}\n", - " f\\left(x_1, \\, \\dots \\, , x_N, \\frac{\\partial g(x_1,\\dots,x_N) }{\\partial x_1}, \\dots , \\frac{\\partial g(x_1,\\dots,x_N) }{\\partial x_N}, \\frac{\\partial g(x_1,\\dots,x_N) }{\\partial x_1\\partial x_2}, \\, \\dots \\, , \\frac{\\partial^n g(x_1,\\dots,x_N) }{\\partial x_N^n} \\right) = 0\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $f$ is an expression involving all kinds of possible mixed derivatives of $g(x_1,\\dots,x_N)$ up to an order $n$. In order for the solution to be unique, some additional conditions must also be given.\n", - "\n", - "### Type of problem\n", - "\n", - "The problem our network must solve for, is similar to the ODE case.\n", - "We must have a trial solution $g_t$ at hand.\n", - "\n", - "For instance, the trial solution could be expressed as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{align*}\n", - " g_t(x_1,\\dots,x_N) = h_1(x_1,\\dots,x_N) + h_2(x_1,\\dots,x_N,N(x_1,\\dots,x_N,P))\n", - "\\end{align*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $h_1(x_1,\\dots,x_N)$ is a function that ensures $g_t(x_1,\\dots,x_N)$ satisfies some given conditions.\n", - "The neural network $N(x_1,\\dots,x_N,P)$ has weights and biases described by $P$ and $h_2(x_1,\\dots,x_N,N(x_1,\\dots,x_N,P))$ is an expression using the output from the neural network in some way.\n", - "\n", - "The role of the function $h_2(x_1,\\dots,x_N,N(x_1,\\dots,x_N,P))$, is to ensure that the output of $N(x_1,\\dots,x_N,P)$ is zero when $g_t(x_1,\\dots,x_N)$ is evaluated at the values of $x_1,\\dots,x_N$ where the given conditions must be satisfied. The function $h_1(x_1,\\dots,x_N)$ should alone make $g_t(x_1,\\dots,x_N)$ satisfy the conditions.\n", - "\n", - "\n", - "\n", - "### Network requirements\n", - "\n", - "The network tries then the minimize the cost function following the\n", - "same ideas as described for the ODE case, but now with more than one\n", - "variables to consider. The concept still remains the same; find a set\n", - "of parameters $P$ such that the expression $f$ in ([17](#PDE)) is as\n", - "close to zero as possible.\n", - "\n", - "As for the ODE case, the cost function is the mean squared error that\n", - "the network must try to minimize. The cost function for the network to\n", - "minimize is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C\\left(x_1, \\dots, x_N, P\\right) = \\left( f\\left(x_1, \\, \\dots \\, , x_N, \\frac{\\partial g(x_1,\\dots,x_N) }{\\partial x_1}, \\dots , \\frac{\\partial g(x_1,\\dots,x_N) }{\\partial x_N}, \\frac{\\partial g(x_1,\\dots,x_N) }{\\partial x_1\\partial x_2}, \\, \\dots \\, , \\frac{\\partial^n g(x_1,\\dots,x_N) }{\\partial x_N^n} \\right) \\right)^2\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "If we let $\\boldsymbol{x} = \\big( x_1, \\dots, x_N \\big)$ be an array containing the values for $x_1, \\dots, x_N$ respectively, the cost function can be reformulated into the following:" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C\\left(\\boldsymbol{x}, P\\right) = f\\left( \\left( \\boldsymbol{x}, \\frac{\\partial g(\\boldsymbol{x}) }{\\partial x_1}, \\dots , \\frac{\\partial g(\\boldsymbol{x}) }{\\partial x_N}, \\frac{\\partial g(\\boldsymbol{x}) }{\\partial x_1\\partial x_2}, \\, \\dots \\, , \\frac{\\partial^n g(\\boldsymbol{x}) }{\\partial x_N^n} \\right) \\right)^2\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "If we also have $M$ different sets of values for $x_1, \\dots, x_N$, that is $\\boldsymbol{x}_i = \\big(x_1^{(i)}, \\dots, x_N^{(i)}\\big)$ for $i = 1,\\dots,M$ being the rows in matrix $X$, the cost function can be generalized into" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C\\left(X, P \\right) = \\sum_{i=1}^M f\\left( \\left( \\boldsymbol{x}_i, \\frac{\\partial g(\\boldsymbol{x}_i) }{\\partial x_1}, \\dots , \\frac{\\partial g(\\boldsymbol{x}_i) }{\\partial x_N}, \\frac{\\partial g(\\boldsymbol{x}_i) }{\\partial x_1\\partial x_2}, \\, \\dots \\, , \\frac{\\partial^n g(\\boldsymbol{x}_i) }{\\partial x_N^n} \\right) \\right)^2.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Example: The diffusion equation\n", - "\n", - "In one spatial dimension, the equation reads" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial g(x,t)}{\\partial t} = \\frac{\\partial^2 g(x,t)}{\\partial x^2}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where a possible choice of conditions are" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{align*}\n", - "g(0,t) &= 0 ,\\qquad t \\geq 0 \\\\\n", - "g(1,t) &= 0, \\qquad t \\geq 0 \\\\\n", - "g(x,0) &= u(x),\\qquad x\\in [0,1]\n", - "\\end{align*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with $u(x)$ being some given function.\n", - "\n", - "\n", - "\n", - "For this case, we want to find $g(x,t)$ such that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - " \\frac{\\partial g(x,t)}{\\partial t} = \\frac{\\partial^2 g(x,t)}{\\partial x^2}\n", - "\\end{equation} \\label{diffonedim} \\tag{18}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{align*}\n", - "g(0,t) &= 0 ,\\qquad t \\geq 0 \\\\\n", - "g(1,t) &= 0, \\qquad t \\geq 0 \\\\\n", - "g(x,0) &= u(x),\\qquad x\\in [0,1]\n", - "\\end{align*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with $u(x) = \\sin(\\pi x)$.\n", - "\n", - "First, let us set up the deep neural network.\n", - "The deep neural network will follow the same structure as discussed in the examples solving the ODEs.\n", - "First, we will look into how Autograd could be used in a network tailored to solve for bivariate functions.\n", - "\n", - "\n", - "\n", - "\n", - "The only change to do here, is to extend our network such that\n", - "functions of multiple parameters are correctly handled. In this case\n", - "we have two variables in our function to solve for, that is time $t$\n", - "and position $x$. The variables will be represented by a\n", - "one-dimensional array in the program. The program will evaluate the\n", - "network at each possible pair $(x,t)$, given an array for the desired\n", - "$x$-values and $t$-values to approximate the solution at." - ] - }, - { - "cell_type": "code", - "execution_count": 7, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "def sigmoid(z):\n", - " return 1/(1 + np.exp(-z))\n", - "\n", - "def deep_neural_network(deep_params, x):\n", - " # x is now a point and a 1D numpy array; make it a column vector\n", - " num_coordinates = np.size(x,0)\n", - " x = x.reshape(num_coordinates,-1)\n", - "\n", - " num_points = np.size(x,1)\n", - "\n", - " # N_hidden is the number of hidden layers\n", - " N_hidden = np.size(deep_params) - 1 # -1 since params consist of parameters to all the hidden layers AND the output layer\n", - "\n", - " # Assume that the input layer does nothing to the input x\n", - " x_input = x\n", - " x_prev = x_input\n", - "\n", - " ## Hidden layers:\n", - "\n", - " for l in range(N_hidden):\n", - " # From the list of parameters P; find the correct weigths and bias for this layer\n", - " w_hidden = deep_params[l]\n", - "\n", - " # Add a row of ones to include bias\n", - " x_prev = np.concatenate((np.ones((1,num_points)), x_prev ), axis = 0)\n", - "\n", - " z_hidden = np.matmul(w_hidden, x_prev)\n", - " x_hidden = sigmoid(z_hidden)\n", - "\n", - " # Update x_prev such that next layer can use the output from this layer\n", - " x_prev = x_hidden\n", - "\n", - " ## Output layer:\n", - "\n", - " # Get the weights and bias for this layer\n", - " w_output = deep_params[-1]\n", - "\n", - " # Include bias:\n", - " x_prev = np.concatenate((np.ones((1,num_points)), x_prev), axis = 0)\n", - "\n", - " z_output = np.matmul(w_output, x_prev)\n", - " x_output = z_output\n", - "\n", - " return x_output[0][0]" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The cost function must then iterate through the given arrays\n", - "containing values for $x$ and $t$, defines a point $(x,t)$ the deep\n", - "neural network and the trial solution is evaluated at, and then finds\n", - "the Jacobian of the trial solution.\n", - "\n", - "A possible trial solution for this PDE is\n", - "\n", - "$$\n", - "g_t(x,t) = h_1(x,t) + x(1-x)tN(x,t,P)\n", - "$$\n", - "\n", - "with $A(x,t)$ being a function ensuring that $g_t(x,t)$ satisfies our given conditions, and $N(x,t,P)$ being the output from the deep neural network using weights and biases for each layer from $P$.\n", - "\n", - "To fulfill the conditions, $A(x,t)$ could be:\n", - "\n", - "$$\n", - "h_1(x,t) = (1-t)\\Big(u(x) - \\big((1-x)u(0) + x u(1)\\big)\\Big) = (1-t)u(x) = (1-t)\\sin(\\pi x)\n", - "$$\n", - "since $(0) = u(1) = 0$ and $u(x) = \\sin(\\pi x)$.\n", - "\n", - "\n", - "\n", - "The Jacobian is used because the program must find the derivative of\n", - "the trial solution with respect to $x$ and $t$.\n", - "\n", - "This gives the necessity of computing the Jacobian matrix, as we want\n", - "to evaluate the gradient with respect to $x$ and $t$ (note that the\n", - "Jacobian of a scalar-valued multivariate function is simply its\n", - "gradient).\n", - "\n", - "In Autograd, the differentiation is by default done with respect to\n", - "the first input argument of your Python function. Since the points is\n", - "an array representing $x$ and $t$, the Jacobian is calculated using\n", - "the values of $x$ and $t$.\n", - "\n", - "To find the second derivative with respect to $x$ and $t$, the\n", - "Jacobian can be found for the second time. The result is a Hessian\n", - "matrix, which is the matrix containing all the possible second order\n", - "mixed derivatives of $g(x,t)$." - ] - }, - { - "cell_type": "code", - "execution_count": 8, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "# Set up the trial function:\n", - "def u(x):\n", - " return np.sin(np.pi*x)\n", - "\n", - "def g_trial(point,P):\n", - " x,t = point\n", - " return (1-t)*u(x) + x*(1-x)*t*deep_neural_network(P,point)\n", - "\n", - "# The right side of the ODE:\n", - "def f(point):\n", - " return 0.\n", - "\n", - "# The cost function:\n", - "def cost_function(P, x, t):\n", - " cost_sum = 0\n", - "\n", - " g_t_jacobian_func = jacobian(g_trial)\n", - " g_t_hessian_func = hessian(g_trial)\n", - "\n", - " for x_ in x:\n", - " for t_ in t:\n", - " point = np.array([x_,t_])\n", - "\n", - " g_t = g_trial(point,P)\n", - " g_t_jacobian = g_t_jacobian_func(point,P)\n", - " g_t_hessian = g_t_hessian_func(point,P)\n", - "\n", - " g_t_dt = g_t_jacobian[1]\n", - " g_t_d2x = g_t_hessian[0][0]\n", - "\n", - " func = f(point)\n", - "\n", - " err_sqr = ( (g_t_dt - g_t_d2x) - func)**2\n", - " cost_sum += err_sqr\n", - "\n", - " return cost_sum" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "### Setting up the network using Autograd; The full program\n", - "\n", - "Having set up the network, along with the trial solution and cost function, we can now see how the deep neural network performs by comparing the results to the analytical solution.\n", - "\n", - "The analytical solution of our problem is\n", - "\n", - "$$\n", - "g(x,t) = \\exp(-\\pi^2 t)\\sin(\\pi x)\n", - "$$\n", - "\n", - "A possible way to implement a neural network solving the PDE, is given below.\n", - "Be aware, though, that it is fairly slow for the parameters used.\n", - "A better result is possible, but requires more iterations, and thus longer time to complete.\n", - "\n", - "\n", - "Indeed, the program below is not optimal in its implementation, but rather serves as an example on how to implement and use a neural network to solve a PDE.\n", - "Using TensorFlow results in a much better execution time. Try it!" - ] - }, - { - "cell_type": "code", - "execution_count": 9, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stderr", - "output_type": "stream", - "text": [ - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/numpy/core/_asarray.py:83: VisibleDeprecationWarning: Creating an ndarray from ragged nested sequences (which is a list-or-tuple of lists-or-tuples-or ndarrays with different lengths or shapes) is deprecated. If you meant to do this, you must specify 'dtype=object' when creating the ndarray\n", - " return array(a, dtype, copy=False, order=order)\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Initial cost: 41.05505310046363\n" - ] - } - ], - "source": [ - "import autograd.numpy as np\n", - "from autograd import jacobian,hessian,grad\n", - "import autograd.numpy.random as npr\n", - "from matplotlib import cm\n", - "from matplotlib import pyplot as plt\n", - "from mpl_toolkits.mplot3d import axes3d\n", - "\n", - "## Set up the network\n", - "\n", - "def sigmoid(z):\n", - " return 1/(1 + np.exp(-z))\n", - "\n", - "def deep_neural_network(deep_params, x):\n", - " # x is now a point and a 1D numpy array; make it a column vector\n", - " num_coordinates = np.size(x,0)\n", - " x = x.reshape(num_coordinates,-1)\n", - "\n", - " num_points = np.size(x,1)\n", - "\n", - " # N_hidden is the number of hidden layers\n", - " N_hidden = np.size(deep_params) - 1 # -1 since params consist of parameters to all the hidden layers AND the output layer\n", - "\n", - " # Assume that the input layer does nothing to the input x\n", - " x_input = x\n", - " x_prev = x_input\n", - "\n", - " ## Hidden layers:\n", - "\n", - " for l in range(N_hidden):\n", - " # From the list of parameters P; find the correct weigths and bias for this layer\n", - " w_hidden = deep_params[l]\n", - "\n", - " # Add a row of ones to include bias\n", - " x_prev = np.concatenate((np.ones((1,num_points)), x_prev ), axis = 0)\n", - "\n", - " z_hidden = np.matmul(w_hidden, x_prev)\n", - " x_hidden = sigmoid(z_hidden)\n", - "\n", - " # Update x_prev such that next layer can use the output from this layer\n", - " x_prev = x_hidden\n", - "\n", - " ## Output layer:\n", - "\n", - " # Get the weights and bias for this layer\n", - " w_output = deep_params[-1]\n", - "\n", - " # Include bias:\n", - " x_prev = np.concatenate((np.ones((1,num_points)), x_prev), axis = 0)\n", - "\n", - " z_output = np.matmul(w_output, x_prev)\n", - " x_output = z_output\n", - "\n", - " return x_output[0][0]\n", - "\n", - "## Define the trial solution and cost function\n", - "def u(x):\n", - " return np.sin(np.pi*x)\n", - "\n", - "def g_trial(point,P):\n", - " x,t = point\n", - " return (1-t)*u(x) + x*(1-x)*t*deep_neural_network(P,point)\n", - "\n", - "# The right side of the ODE:\n", - "def f(point):\n", - " return 0.\n", - "\n", - "# The cost function:\n", - "def cost_function(P, x, t):\n", - " cost_sum = 0\n", - "\n", - " g_t_jacobian_func = jacobian(g_trial)\n", - " g_t_hessian_func = hessian(g_trial)\n", - "\n", - " for x_ in x:\n", - " for t_ in t:\n", - " point = np.array([x_,t_])\n", - "\n", - " g_t = g_trial(point,P)\n", - " g_t_jacobian = g_t_jacobian_func(point,P)\n", - " g_t_hessian = g_t_hessian_func(point,P)\n", - "\n", - " g_t_dt = g_t_jacobian[1]\n", - " g_t_d2x = g_t_hessian[0][0]\n", - "\n", - " func = f(point)\n", - "\n", - " err_sqr = ( (g_t_dt - g_t_d2x) - func)**2\n", - " cost_sum += err_sqr\n", - "\n", - " return cost_sum /( np.size(x)*np.size(t) )\n", - "\n", - "## For comparison, define the analytical solution\n", - "def g_analytic(point):\n", - " x,t = point\n", - " return np.exp(-np.pi**2*t)*np.sin(np.pi*x)\n", - "\n", - "## Set up a function for training the network to solve for the equation\n", - "def solve_pde_deep_neural_network(x,t, num_neurons, num_iter, lmb):\n", - " ## Set up initial weigths and biases\n", - " N_hidden = np.size(num_neurons)\n", - "\n", - " ## Set up initial weigths and biases\n", - "\n", - " # Initialize the list of parameters:\n", - " P = [None]*(N_hidden + 1) # + 1 to include the output layer\n", - "\n", - " P[0] = npr.randn(num_neurons[0], 2 + 1 ) # 2 since we have two points, +1 to include bias\n", - " for l in range(1,N_hidden):\n", - " P[l] = npr.randn(num_neurons[l], num_neurons[l-1] + 1) # +1 to include bias\n", - "\n", - " # For the output layer\n", - " P[-1] = npr.randn(1, num_neurons[-1] + 1 ) # +1 since bias is included\n", - "\n", - " print('Initial cost: ',cost_function(P, x, t))\n", - "\n", - " cost_function_grad = grad(cost_function,0)\n", - "\n", - " # Let the update be done num_iter times\n", - " for i in range(num_iter):\n", - " cost_grad = cost_function_grad(P, x , t)\n", - "\n", - " for l in range(N_hidden+1):\n", - " P[l] = P[l] - lmb * cost_grad[l]\n", - "\n", - " print('Final cost: ',cost_function(P, x, t))\n", - "\n", - " return P\n", - "\n", - "if __name__ == '__main__':\n", - " ### Use the neural network:\n", - " npr.seed(15)\n", - "\n", - " ## Decide the vales of arguments to the function to solve\n", - " Nx = 10; Nt = 10\n", - " x = np.linspace(0, 1, Nx)\n", - " t = np.linspace(0,1,Nt)\n", - "\n", - " ## Set up the parameters for the network\n", - " num_hidden_neurons = [100, 25]\n", - " num_iter = 250\n", - " lmb = 0.01\n", - "\n", - " P = solve_pde_deep_neural_network(x,t, num_hidden_neurons, num_iter, lmb)\n", - "\n", - " ## Store the results\n", - " g_dnn_ag = np.zeros((Nx, Nt))\n", - " G_analytical = np.zeros((Nx, Nt))\n", - " for i,x_ in enumerate(x):\n", - " for j, t_ in enumerate(t):\n", - " point = np.array([x_, t_])\n", - " g_dnn_ag[i,j] = g_trial(point,P)\n", - "\n", - " G_analytical[i,j] = g_analytic(point)\n", - "\n", - " # Find the map difference between the analytical and the computed solution\n", - " diff_ag = np.abs(g_dnn_ag - G_analytical)\n", - " print('Max absolute difference between the analytical solution and the network: %g'%np.max(diff_ag))\n", - "\n", - " ## Plot the solutions in two dimensions, that being in position and time\n", - "\n", - " T,X = np.meshgrid(t,x)\n", - "\n", - " fig = plt.figure(figsize=(10,10))\n", - " ax = fig.gca(projection='3d')\n", - " ax.set_title('Solution from the deep neural network w/ %d layer'%len(num_hidden_neurons))\n", - " s = ax.plot_surface(T,X,g_dnn_ag,linewidth=0,antialiased=False,cmap=cm.viridis)\n", - " ax.set_xlabel('Time $t$')\n", - " ax.set_ylabel('Position $x$');\n", - "\n", - "\n", - " fig = plt.figure(figsize=(10,10))\n", - " ax = fig.gca(projection='3d')\n", - " ax.set_title('Analytical solution')\n", - " s = ax.plot_surface(T,X,G_analytical,linewidth=0,antialiased=False,cmap=cm.viridis)\n", - " ax.set_xlabel('Time $t$')\n", - " ax.set_ylabel('Position $x$');\n", - "\n", - " fig = plt.figure(figsize=(10,10))\n", - " ax = fig.gca(projection='3d')\n", - " ax.set_title('Difference')\n", - " s = ax.plot_surface(T,X,diff_ag,linewidth=0,antialiased=False,cmap=cm.viridis)\n", - " ax.set_xlabel('Time $t$')\n", - " ax.set_ylabel('Position $x$');\n", - "\n", - " ## Take some slices of the 3D plots just to see the solutions at particular times\n", - " indx1 = 0\n", - " indx2 = int(Nt/2)\n", - " indx3 = Nt-1\n", - "\n", - " t1 = t[indx1]\n", - " t2 = t[indx2]\n", - " t3 = t[indx3]\n", - "\n", - " # Slice the results from the DNN\n", - " res1 = g_dnn_ag[:,indx1]\n", - " res2 = g_dnn_ag[:,indx2]\n", - " res3 = g_dnn_ag[:,indx3]\n", - "\n", - " # Slice the analytical results\n", - " res_analytical1 = G_analytical[:,indx1]\n", - " res_analytical2 = G_analytical[:,indx2]\n", - " res_analytical3 = G_analytical[:,indx3]\n", - "\n", - " # Plot the slices\n", - " plt.figure(figsize=(10,10))\n", - " plt.title(\"Computed solutions at time = %g\"%t1)\n", - " plt.plot(x, res1)\n", - " plt.plot(x,res_analytical1)\n", - " plt.legend(['dnn','analytical'])\n", - "\n", - " plt.figure(figsize=(10,10))\n", - " plt.title(\"Computed solutions at time = %g\"%t2)\n", - " plt.plot(x, res2)\n", - " plt.plot(x,res_analytical2)\n", - " plt.legend(['dnn','analytical'])\n", - "\n", - " plt.figure(figsize=(10,10))\n", - " plt.title(\"Computed solutions at time = %g\"%t3)\n", - " plt.plot(x, res3)\n", - " plt.plot(x,res_analytical3)\n", - " plt.legend(['dnn','analytical'])\n", - "\n", - " plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Solving the wave equation with Neural Networks\n", - "\n", - "The wave equation is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial^2 g(x,t)}{\\partial t^2} = c^2\\frac{\\partial^2 g(x,t)}{\\partial x^2}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with $c$ being the specified wave speed.\n", - "\n", - "Here, the chosen conditions are" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{align*}\n", - "\tg(0,t) &= 0 \\\\\n", - "\tg(1,t) &= 0 \\\\\n", - "\tg(x,0) &= u(x) \\\\\n", - "\t\\frac{\\partial g(x,t)}{\\partial t} \\Big |_{t = 0} &= v(x)\n", - "\\end{align*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $\\frac{\\partial g(x,t)}{\\partial t} \\Big |_{t = 0}$ means the derivative of $g(x,t)$ with respect to $t$ is evaluated at $t = 0$, and $u(x)$ and $v(x)$ being given functions.\n", - "\n", - "\n", - "The wave equation to solve for, is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation} \\label{wave} \\tag{19}\n", - "\\frac{\\partial^2 g(x,t)}{\\partial t^2} = c^2 \\frac{\\partial^2 g(x,t)}{\\partial x^2}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $c$ is the given wave speed.\n", - "The chosen conditions for this equation are" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{aligned}\n", - "g(0,t) &= 0, &t \\geq 0 \\\\\n", - "g(1,t) &= 0, &t \\geq 0 \\\\\n", - "g(x,0) &= u(x), &x\\in[0,1] \\\\\n", - "\\frac{\\partial g(x,t)}{\\partial t}\\Big |_{t = 0} &= v(x), &x \\in [0,1]\n", - "\\end{aligned} \\label{condwave} \\tag{20}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In this example, let $c = 1$ and $u(x) = \\sin(\\pi x)$ and $v(x) = -\\pi\\sin(\\pi x)$.\n", - "\n", - "\n", - "\n", - "Setting up the network is done in similar matter as for the example of solving the diffusion equation.\n", - "The only things we have to change, is the trial solution such that it satisfies the conditions from ([20](#condwave)) and the cost function.\n", - "\n", - "The trial solution becomes slightly different since we have other conditions than in the example of solving the diffusion equation. Here, a possible trial solution $g_t(x,t)$ is\n", - "\n", - "$$\n", - "g_t(x,t) = h_1(x,t) + x(1-x)t^2N(x,t,P)\n", - "$$\n", - "\n", - "where\n", - "\n", - "$$\n", - "h_1(x,t) = (1-t^2)u(x) + tv(x)\n", - "$$\n", - "\n", - "Note that this trial solution satisfies the conditions only if $u(0) = v(0) = u(1) = v(1) = 0$, which is the case in this example.\n", - "\n", - "\n", - "The analytical solution for our specific problem, is\n", - "\n", - "$$\n", - "g(x,t) = \\sin(\\pi x)\\cos(\\pi t) - \\sin(\\pi x)\\sin(\\pi t)\n", - "$$" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import autograd.numpy as np\n", - "from autograd import hessian,grad\n", - "import autograd.numpy.random as npr\n", - "from matplotlib import cm\n", - "from matplotlib import pyplot as plt\n", - "from mpl_toolkits.mplot3d import axes3d\n", - "\n", - "## Set up the trial function:\n", - "def u(x):\n", - " return np.sin(np.pi*x)\n", - "\n", - "def v(x):\n", - " return -np.pi*np.sin(np.pi*x)\n", - "\n", - "def h1(point):\n", - " x,t = point\n", - " return (1 - t**2)*u(x) + t*v(x)\n", - "\n", - "def g_trial(point,P):\n", - " x,t = point\n", - " return h1(point) + x*(1-x)*t**2*deep_neural_network(P,point)\n", - "\n", - "## Define the cost function\n", - "def cost_function(P, x, t):\n", - " cost_sum = 0\n", - "\n", - " g_t_hessian_func = hessian(g_trial)\n", - "\n", - " for x_ in x:\n", - " for t_ in t:\n", - " point = np.array([x_,t_])\n", - "\n", - " g_t_hessian = g_t_hessian_func(point,P)\n", - "\n", - " g_t_d2x = g_t_hessian[0][0]\n", - " g_t_d2t = g_t_hessian[1][1]\n", - "\n", - " err_sqr = ( (g_t_d2t - g_t_d2x) )**2\n", - " cost_sum += err_sqr\n", - "\n", - " return cost_sum / (np.size(t) * np.size(x))\n", - "\n", - "## The neural network\n", - "def sigmoid(z):\n", - " return 1/(1 + np.exp(-z))\n", - "\n", - "def deep_neural_network(deep_params, x):\n", - " # x is now a point and a 1D numpy array; make it a column vector\n", - " num_coordinates = np.size(x,0)\n", - " x = x.reshape(num_coordinates,-1)\n", - "\n", - " num_points = np.size(x,1)\n", - "\n", - " # N_hidden is the number of hidden layers\n", - " N_hidden = np.size(deep_params) - 1 # -1 since params consist of parameters to all the hidden layers AND the output layer\n", - "\n", - " # Assume that the input layer does nothing to the input x\n", - " x_input = x\n", - " x_prev = x_input\n", - "\n", - " ## Hidden layers:\n", - "\n", - " for l in range(N_hidden):\n", - " # From the list of parameters P; find the correct weigths and bias for this layer\n", - " w_hidden = deep_params[l]\n", - "\n", - " # Add a row of ones to include bias\n", - " x_prev = np.concatenate((np.ones((1,num_points)), x_prev ), axis = 0)\n", - "\n", - " z_hidden = np.matmul(w_hidden, x_prev)\n", - " x_hidden = sigmoid(z_hidden)\n", - "\n", - " # Update x_prev such that next layer can use the output from this layer\n", - " x_prev = x_hidden\n", - "\n", - " ## Output layer:\n", - "\n", - " # Get the weights and bias for this layer\n", - " w_output = deep_params[-1]\n", - "\n", - " # Include bias:\n", - " x_prev = np.concatenate((np.ones((1,num_points)), x_prev), axis = 0)\n", - "\n", - " z_output = np.matmul(w_output, x_prev)\n", - " x_output = z_output\n", - "\n", - " return x_output[0][0]\n", - "\n", - "## The analytical solution\n", - "def g_analytic(point):\n", - " x,t = point\n", - " return np.sin(np.pi*x)*np.cos(np.pi*t) - np.sin(np.pi*x)*np.sin(np.pi*t)\n", - "\n", - "def solve_pde_deep_neural_network(x,t, num_neurons, num_iter, lmb):\n", - " ## Set up initial weigths and biases\n", - " N_hidden = np.size(num_neurons)\n", - "\n", - " ## Set up initial weigths and biases\n", - "\n", - " # Initialize the list of parameters:\n", - " P = [None]*(N_hidden + 1) # + 1 to include the output layer\n", - "\n", - " P[0] = npr.randn(num_neurons[0], 2 + 1 ) # 2 since we have two points, +1 to include bias\n", - " for l in range(1,N_hidden):\n", - " P[l] = npr.randn(num_neurons[l], num_neurons[l-1] + 1) # +1 to include bias\n", - "\n", - " # For the output layer\n", - " P[-1] = npr.randn(1, num_neurons[-1] + 1 ) # +1 since bias is included\n", - "\n", - " print('Initial cost: ',cost_function(P, x, t))\n", - "\n", - " cost_function_grad = grad(cost_function,0)\n", - "\n", - " # Let the update be done num_iter times\n", - " for i in range(num_iter):\n", - " cost_grad = cost_function_grad(P, x , t)\n", - "\n", - " for l in range(N_hidden+1):\n", - " P[l] = P[l] - lmb * cost_grad[l]\n", - "\n", - "\n", - " print('Final cost: ',cost_function(P, x, t))\n", - "\n", - " return P\n", - "\n", - "if __name__ == '__main__':\n", - " ### Use the neural network:\n", - " npr.seed(15)\n", - "\n", - " ## Decide the vales of arguments to the function to solve\n", - " Nx = 10; Nt = 10\n", - " x = np.linspace(0, 1, Nx)\n", - " t = np.linspace(0,1,Nt)\n", - "\n", - " ## Set up the parameters for the network\n", - " num_hidden_neurons = [50,20]\n", - " num_iter = 1000\n", - " lmb = 0.01\n", - "\n", - " P = solve_pde_deep_neural_network(x,t, num_hidden_neurons, num_iter, lmb)\n", - "\n", - " ## Store the results\n", - " res = np.zeros((Nx, Nt))\n", - " res_analytical = np.zeros((Nx, Nt))\n", - " for i,x_ in enumerate(x):\n", - " for j, t_ in enumerate(t):\n", - " point = np.array([x_, t_])\n", - " res[i,j] = g_trial(point,P)\n", - "\n", - " res_analytical[i,j] = g_analytic(point)\n", - "\n", - " diff = np.abs(res - res_analytical)\n", - " print(\"Max difference between analytical and solution from nn: %g\"%np.max(diff))\n", - "\n", - " ## Plot the solutions in two dimensions, that being in position and time\n", - "\n", - " T,X = np.meshgrid(t,x)\n", - "\n", - " fig = plt.figure(figsize=(10,10))\n", - " ax = fig.gca(projection='3d')\n", - " ax.set_title('Solution from the deep neural network w/ %d layer'%len(num_hidden_neurons))\n", - " s = ax.plot_surface(T,X,res,linewidth=0,antialiased=False,cmap=cm.viridis)\n", - " ax.set_xlabel('Time $t$')\n", - " ax.set_ylabel('Position $x$');\n", - "\n", - "\n", - " fig = plt.figure(figsize=(10,10))\n", - " ax = fig.gca(projection='3d')\n", - " ax.set_title('Analytical solution')\n", - " s = ax.plot_surface(T,X,res_analytical,linewidth=0,antialiased=False,cmap=cm.viridis)\n", - " ax.set_xlabel('Time $t$')\n", - " ax.set_ylabel('Position $x$');\n", - "\n", - "\n", - " fig = plt.figure(figsize=(10,10))\n", - " ax = fig.gca(projection='3d')\n", - " ax.set_title('Difference')\n", - " s = ax.plot_surface(T,X,diff,linewidth=0,antialiased=False,cmap=cm.viridis)\n", - " ax.set_xlabel('Time $t$')\n", - " ax.set_ylabel('Position $x$');\n", - "\n", - " ## Take some slices of the 3D plots just to see the solutions at particular times\n", - " indx1 = 0\n", - " indx2 = int(Nt/2)\n", - " indx3 = Nt-1\n", - "\n", - " t1 = t[indx1]\n", - " t2 = t[indx2]\n", - " t3 = t[indx3]\n", - "\n", - " # Slice the results from the DNN\n", - " res1 = res[:,indx1]\n", - " res2 = res[:,indx2]\n", - " res3 = res[:,indx3]\n", - "\n", - " # Slice the analytical results\n", - " res_analytical1 = res_analytical[:,indx1]\n", - " res_analytical2 = res_analytical[:,indx2]\n", - " res_analytical3 = res_analytical[:,indx3]\n", - "\n", - " # Plot the slices\n", - " plt.figure(figsize=(10,10))\n", - " plt.title(\"Computed solutions at time = %g\"%t1)\n", - " plt.plot(x, res1)\n", - " plt.plot(x,res_analytical1)\n", - " plt.legend(['dnn','analytical'])\n", - "\n", - " plt.figure(figsize=(10,10))\n", - " plt.title(\"Computed solutions at time = %g\"%t2)\n", - " plt.plot(x, res2)\n", - " plt.plot(x,res_analytical2)\n", - " plt.legend(['dnn','analytical'])\n", - "\n", - " plt.figure(figsize=(10,10))\n", - " plt.title(\"Computed solutions at time = %g\"%t3)\n", - " plt.plot(x, res3)\n", - " plt.plot(x,res_analytical3)\n", - " plt.legend(['dnn','analytical'])\n", - "\n", - " plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Resources on differential equations and deep learning\n", - "\n", - "1. [Artificial neural networks for solving ordinary and partial differential equations by I.E. Lagaris et al](https://pdfs.semanticscholar.org/d061/df393e0e8fbfd0ea24976458b7d42419040d.pdf)\n", - "\n", - "2. [Neural networks for solving differential equations by A. Honchar](https://becominghuman.ai/neural-networks-for-solving-differential-equations-fa230ac5e04c)\n", - "\n", - "3. [Solving differential equations using neural networks by M.M Chiaramonte and M. Kiener](http://cs229.stanford.edu/proj2013/ChiaramonteKiener-SolvingDifferentialEquationsUsingNeuralNetworks.pdf)\n", - "\n", - "4. [Introduction to Partial Differential Equations by A. Tveito, R. Winther](https://www.springer.com/us/book/9783540225515)" - ] - } - ], - "metadata": { - "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.8.5" - } - }, - "nbformat": 4, - "nbformat_minor": 4 -} \ No newline at end of file diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter11.py b/doc/LectureNotes/_build/jupyter_execute/chapter11.py deleted file mode 100644 index 17470c2a0..000000000 --- a/doc/LectureNotes/_build/jupyter_execute/chapter11.py +++ /dev/null @@ -1,2345 +0,0 @@ -# Solving Differential Equations with Deep Learning - -The Universal Approximation Theorem states that a neural network can -approximate any function at a single hidden layer along with one input -and output layer to any given precision. - - -An ordinary differential equation (ODE) is an equation involving functions having one variable. - -In general, an ordinary differential equation looks like - - -
- -$$ -\begin{equation} \label{ode} \tag{1} -f\left(x, \, g(x), \, g'(x), \, g''(x), \, \dots \, , \, g^{(n)}(x)\right) = 0 -\end{equation} -$$ - -where $g(x)$ is the function to find, and $g^{(n)}(x)$ is the $n$-th derivative of $g(x)$. - -The $f\left(x, g(x), g'(x), g''(x), \, \dots \, , g^{(n)}(x)\right)$ is just a way to write that there is an expression involving $x$ and $g(x), \ g'(x), \ g''(x), \, \dots \, , \text{ and } g^{(n)}(x)$ on the left side of the equality sign in ([1](#ode)). -The highest order of derivative, that is the value of $n$, determines to the order of the equation. -The equation is referred to as a $n$-th order ODE. -Along with ([1](#ode)), some additional conditions of the function $g(x)$ are typically given -for the solution to be unique. - - - -Let the trial solution $g_t(x)$ be - - -
- -$$ -\begin{equation} - g_t(x) = h_1(x) + h_2(x,N(x,P)) -\label{_auto1} \tag{2} -\end{equation} -$$ - -where $h_1(x)$ is a function that makes $g_t(x)$ satisfy a given set -of conditions, $N(x,P)$ a neural network with weights and biases -described by $P$ and $h_2(x, N(x,P))$ some expression involving the -neural network. The role of the function $h_2(x, N(x,P))$, is to -ensure that the output from $N(x,P)$ is zero when $g_t(x)$ is -evaluated at the values of $x$ where the given conditions must be -satisfied. The function $h_1(x)$ should alone make $g_t(x)$ satisfy -the conditions. - -But what about the network $N(x,P)$? - - -As described previously, an optimization method could be used to minimize the parameters of a neural network, that being its weights and biases, through backward propagation. - - - -For the minimization to be defined, we need to have a cost function at hand to minimize. - -It is given that $f\left(x, \, g(x), \, g'(x), \, g''(x), \, \dots \, , \, g^{(n)}(x)\right)$ should be equal to zero in ([1](#ode)). -We can choose to consider the mean squared error as the cost function for an input $x$. -Since we are looking at one input, the cost function is just $f$ squared. -The cost function $c\left(x, P \right)$ can therefore be expressed as - -$$ -C\left(x, P\right) = \big(f\left(x, \, g(x), \, g'(x), \, g''(x), \, \dots \, , \, g^{(n)}(x)\right)\big)^2 -$$ - -If $N$ inputs are given as a vector $\boldsymbol{x}$ with elements $x_i$ for $i = 1,\dots,N$, -the cost function becomes - - -
- -$$ -\begin{equation} \label{cost} \tag{3} - C\left(\boldsymbol{x}, P\right) = \frac{1}{N} \sum_{i=1}^N \big(f\left(x_i, \, g(x_i), \, g'(x_i), \, g''(x_i), \, \dots \, , \, g^{(n)}(x_i)\right)\big)^2 -\end{equation} -$$ - -The neural net should then find the parameters $P$ that minimizes the cost function in -([3](#cost)) for a set of $N$ training samples $x_i$. - - - -To perform the minimization using gradient descent, the gradient of $C\left(\boldsymbol{x}, P\right)$ is needed. -It might happen so that finding an analytical expression of the gradient of $C(\boldsymbol{x}, P)$ from ([3](#cost)) gets too messy, depending on which cost function one desires to use. - -Luckily, there exists libraries that makes the job for us through automatic differentiation. -Automatic differentiation is a method of finding the derivatives numerically with very high precision. - - -### Example: Exponential decay - -An exponential decay of a quantity $g(x)$ is described by the equation - - -
- -$$ -\begin{equation} \label{solve_expdec} \tag{4} - g'(x) = -\gamma g(x) -\end{equation} -$$ - -with $g(0) = g_0$ for some chosen initial value $g_0$. - -The analytical solution of ([4](#solve_expdec)) is - - -
- -$$ -\begin{equation} - g(x) = g_0 \exp\left(-\gamma x\right) -\label{_auto2} \tag{5} -\end{equation} -$$ - -Having an analytical solution at hand, it is possible to use it to compare how well a neural network finds a solution of ([4](#solve_expdec)). - - - -The program will use a neural network to solve - - -
- -$$ -\begin{equation} \label{solveode} \tag{6} -g'(x) = -\gamma g(x) -\end{equation} -$$ - -where $g(0) = g_0$ with $\gamma$ and $g_0$ being some chosen values. - -In this example, $\gamma = 2$ and $g_0 = 10$. - - -To begin with, a trial solution $g_t(t)$ must be chosen. A general trial solution for ordinary differential equations could be - -$$ -g_t(x, P) = h_1(x) + h_2(x, N(x, P)) -$$ - -with $h_1(x)$ ensuring that $g_t(x)$ satisfies some conditions and $h_2(x,N(x, P))$ an expression involving $x$ and the output from the neural network $N(x,P)$ with $P $ being the collection of the weights and biases for each layer. For now, it is assumed that the network consists of one input layer, one hidden layer, and one output layer. - - - -In this network, there are no weights and bias at the input layer, so $P = \{ P_{\text{hidden}}, P_{\text{output}} \}$. -If there are $N_{\text{hidden} }$ neurons in the hidden layer, then $P_{\text{hidden}}$ is a $N_{\text{hidden} } \times (1 + N_{\text{input}})$ matrix, given that there are $N_{\text{input}}$ neurons in the input layer. - -The first column in $P_{\text{hidden} }$ represents the bias for each neuron in the hidden layer and the second column represents the weights for each neuron in the hidden layer from the input layer. -If there are $N_{\text{output} }$ neurons in the output layer, then $P_{\text{output}} $ is a $N_{\text{output} } \times (1 + N_{\text{hidden} })$ matrix. - -Its first column represents the bias of each neuron and the remaining columns represents the weights to each neuron. - -It is given that $g(0) = g_0$. The trial solution must fulfill this condition to be a proper solution of ([6](#solveode)). A possible way to ensure that $g_t(0, P) = g_0$, is to let $F(N(x,P)) = x \cdot N(x,P)$ and $A(x) = g_0$. This gives the following trial solution: - - -
- -$$ -\begin{equation} \label{trial} \tag{7} -g_t(x, P) = g_0 + x \cdot N(x, P) -\end{equation} -$$ - -### Reformulating the problem - -We wish that our neural network manages to minimize a given cost function. - -A reformulation of out equation, ([6](#solveode)), must therefore be done, -such that it describes the problem a neural network can solve for. - -The neural network must find the set of weights and biases $P$ such that the trial solution in ([7](#trial)) satisfies ([6](#solveode)). - -The trial solution - -$$ -g_t(x, P) = g_0 + x \cdot N(x, P) -$$ - -has been chosen such that it already solves the condition $g(0) = g_0$. What remains, is to find $P$ such that - - -
- -$$ -\begin{equation} \label{nnmin} \tag{8} -g_t'(x, P) = - \gamma g_t(x, P) -\end{equation} -$$ - -is fulfilled as *best as possible*. - - -The left hand side and right hand side of ([8](#nnmin)) must be computed separately, and then the neural network must choose weights and biases, contained in $P$, such that the sides are equal as best as possible. -This means that the absolute or squared difference between the sides must be as close to zero, ideally equal to zero. -In this case, the difference squared shows to be an appropriate measurement of how erroneous the trial solution is with respect to $P$ of the neural network. - -This gives the following cost function our neural network must solve for: - -$$ -\min_{P}\Big\{ \big(g_t'(x, P) - ( -\gamma g_t(x, P) \big)^2 \Big\} -$$ - -(the notation $\min_{P}\{ f(x, P) \}$ means that we desire to find $P$ that yields the minimum of $f(x, P)$) - -or, in terms of weights and biases for the hidden and output layer in our network: - -$$ -\min_{P_{\text{hidden} }, \ P_{\text{output} }}\Big\{ \big(g_t'(x, \{ P_{\text{hidden} }, P_{\text{output} }\}) - ( -\gamma g_t(x, \{ P_{\text{hidden} }, P_{\text{output} }\}) \big)^2 \Big\} -$$ - -for an input value $x$. - - - -If the neural network evaluates $g_t(x, P)$ at more values for $x$, say $N$ values $x_i$ for $i = 1, \dots, N$, then the *total* error to minimize becomes - - -
- -$$ -\begin{equation} \label{min} \tag{9} -\min_{P}\Big\{\frac{1}{N} \sum_{i=1}^N \big(g_t'(x_i, P) - ( -\gamma g_t(x_i, P) \big)^2 \Big\} -\end{equation} -$$ - -Letting $\boldsymbol{x}$ be a vector with elements $x_i$ and $C(\boldsymbol{x}, P) = \frac{1}{N} \sum_i \big(g_t'(x_i, P) - ( -\gamma g_t(x_i, P) \big)^2$ denote the cost function, the minimization problem that our network must solve, becomes - -$$ -\min_{P} C(\boldsymbol{x}, P) -$$ - -In terms of $P_{\text{hidden} }$ and $P_{\text{output} }$, this could also be expressed as - -$$ -\min_{P_{\text{hidden} }, \ P_{\text{output} }} C(\boldsymbol{x}, \{P_{\text{hidden} }, P_{\text{output} }\}) -$$ - - -For simplicity, it is assumed that the input is an array $\boldsymbol{x} = (x_1, \dots, x_N)$ with $N$ elements. It is at these points the neural network should find $P$ such that it fulfills ([9](#min)). - -First, the neural network must feed forward the inputs. -This means that $\boldsymbol{x}s$ must be passed through an input layer, a hidden layer and a output layer. The input layer in this case, does not need to process the data any further. -The input layer will consist of $N_{\text{input} }$ neurons, passing its element to each neuron in the hidden layer. The number of neurons in the hidden layer will be $N_{\text{hidden} }$. - - -For the $i$-th in the hidden layer with weight $w_i^{\text{hidden} }$ and bias $b_i^{\text{hidden} }$, the weighting from the $j$-th neuron at the input layer is: - -$$ -\begin{aligned} -z_{i,j}^{\text{hidden}} &= b_i^{\text{hidden}} + w_i^{\text{hidden}}x_j \\ -&= -\begin{pmatrix} -b_i^{\text{hidden}} & w_i^{\text{hidden}} -\end{pmatrix} -\begin{pmatrix} -1 \\ -x_j -\end{pmatrix} -\end{aligned} -$$ - -The result after weighting the inputs at the $i$-th hidden neuron can be written as a vector: - -$$ -\begin{aligned} -\boldsymbol{z}_{i}^{\text{hidden}} &= \Big( b_i^{\text{hidden}} + w_i^{\text{hidden}}x_1 , \ b_i^{\text{hidden}} + w_i^{\text{hidden}} x_2, \ \dots \, , \ b_i^{\text{hidden}} + w_i^{\text{hidden}} x_N\Big) \\ -&= -\begin{pmatrix} - b_i^{\text{hidden}} & w_i^{\text{hidden}} -\end{pmatrix} -\begin{pmatrix} -1 & 1 & \dots & 1 \\ -x_1 & x_2 & \dots & x_N -\end{pmatrix} \\ -&= \boldsymbol{p}_{i, \text{hidden}}^T X -\end{aligned} -$$ - -The vector $\boldsymbol{p}_{i, \text{hidden}}^T$ constitutes each row in $P_{\text{hidden} }$, which contains the weights for the neural network to minimize according to ([9](#min)). - -After having found $\boldsymbol{z}_{i}^{\text{hidden}} $ for every $i$-th neuron within the hidden layer, the vector will be sent to an activation function $a_i(\boldsymbol{z})$. - -In this example, the sigmoid function has been chosen to be the activation function for each hidden neuron: - -$$ -f(z) = \frac{1}{1 + \exp{(-z)}} -$$ - -It is possible to use other activations functions for the hidden layer also. - -The output $\boldsymbol{x}_i^{\text{hidden}}$ from each $i$-th hidden neuron is: - -$$ -\boldsymbol{x}_i^{\text{hidden} } = f\big( \boldsymbol{z}_{i}^{\text{hidden}} \big) -$$ - -The outputs $\boldsymbol{x}_i^{\text{hidden} } $ are then sent to the output layer. - -The output layer consists of one neuron in this case, and combines the -output from each of the neurons in the hidden layers. The output layer -combines the results from the hidden layer using some weights $w_i^{\text{output}}$ -and biases $b_i^{\text{output}}$. In this case, -it is assumes that the number of neurons in the output layer is one. - - - -The procedure of weighting the output neuron $j$ in the hidden layer to the $i$-th neuron in the output layer is similar as for the hidden layer described previously. - -$$ -\begin{aligned} -z_{1,j}^{\text{output}} & = -\begin{pmatrix} -b_1^{\text{output}} & \boldsymbol{w}_1^{\text{output}} -\end{pmatrix} -\begin{pmatrix} -1 \\ -\boldsymbol{x}_j^{\text{hidden}} -\end{pmatrix} -\end{aligned} -$$ - -Expressing $z_{1,j}^{\text{output}}$ as a vector gives the following way of weighting the inputs from the hidden layer: - -$$ -\boldsymbol{z}_{1}^{\text{output}} = -\begin{pmatrix} -b_1^{\text{output}} & \boldsymbol{w}_1^{\text{output}} -\end{pmatrix} -\begin{pmatrix} -1 & 1 & \dots & 1 \\ -\boldsymbol{x}_1^{\text{hidden}} & \boldsymbol{x}_2^{\text{hidden}} & \dots & \boldsymbol{x}_N^{\text{hidden}} -\end{pmatrix} -$$ - -In this case we seek a continuous range of values since we are approximating a function. This means that after computing $\boldsymbol{z}_{1}^{\text{output}}$ the neural network has finished its feed forward step, and $\boldsymbol{z}_{1}^{\text{output}}$ is the final output of the network. - - -The next step is to decide how the parameters should be changed such that they minimize the cost function. - -The chosen cost function for this problem is - -$$ -C(\boldsymbol{x}, P) = \frac{1}{N} \sum_i \big(g_t'(x_i, P) - ( -\gamma g_t(x_i, P) \big)^2 -$$ - -In order to minimize the cost function, an optimization method must be chosen. - -Here, gradient descent with a constant step size has been chosen. - -### Gradient descent - -The idea of the gradient descent algorithm is to update parameters in -a direction where the cost function decreases goes to a minimum. - -In general, the update of some parameters $\boldsymbol{\omega}$ given a cost -function defined by some weights $\boldsymbol{\omega}$, $C(\boldsymbol{x}, -\boldsymbol{\omega})$, goes as follows: - -$$ -\boldsymbol{\omega}_{\text{new} } = \boldsymbol{\omega} - \lambda \nabla_{\boldsymbol{\omega}} C(\boldsymbol{x}, \boldsymbol{\omega}) -$$ - -for a number of iterations or until $ \big|\big| \boldsymbol{\omega}_{\text{new} } - \boldsymbol{\omega} \big|\big|$ becomes smaller than some given tolerance. - -The value of $\lambda$ decides how large steps the algorithm must take -in the direction of $ \nabla_{\boldsymbol{\omega}} C(\boldsymbol{x}, \boldsymbol{\omega})$. -The notation $\nabla_{\boldsymbol{\omega}}$ express the gradient with respect -to the elements in $\boldsymbol{\omega}$. - -In our case, we have to minimize the cost function $C(\boldsymbol{x}, P)$ with -respect to the two sets of weights and biases, that is for the hidden -layer $P_{\text{hidden} }$ and for the output layer $P_{\text{output} -}$ . - -This means that $P_{\text{hidden} }$ and $P_{\text{output} }$ is updated by - -$$ -\begin{aligned} -P_{\text{hidden},\text{new}} &= P_{\text{hidden}} - \lambda \nabla_{P_{\text{hidden}}} C(\boldsymbol{x}, P) \\ -P_{\text{output},\text{new}} &= P_{\text{output}} - \lambda \nabla_{P_{\text{output}}} C(\boldsymbol{x}, P) -\end{aligned} -$$ - -### The code for solving the ODE - -%matplotlib inline - -import autograd.numpy as np -from autograd import grad, elementwise_grad -import autograd.numpy.random as npr -from matplotlib import pyplot as plt - -def sigmoid(z): - return 1/(1 + np.exp(-z)) - -# Assuming one input, hidden, and output layer -def neural_network(params, x): - - # Find the weights (including and biases) for the hidden and output layer. - # Assume that params is a list of parameters for each layer. - # The biases are the first element for each array in params, - # and the weights are the remaning elements in each array in params. - - w_hidden = params[0] - w_output = params[1] - - # Assumes input x being an one-dimensional array - num_values = np.size(x) - x = x.reshape(-1, num_values) - - # Assume that the input layer does nothing to the input x - x_input = x - - ## Hidden layer: - - # Add a row of ones to include bias - x_input = np.concatenate((np.ones((1,num_values)), x_input ), axis = 0) - - z_hidden = np.matmul(w_hidden, x_input) - x_hidden = sigmoid(z_hidden) - - ## Output layer: - - # Include bias: - x_hidden = np.concatenate((np.ones((1,num_values)), x_hidden ), axis = 0) - - z_output = np.matmul(w_output, x_hidden) - x_output = z_output - - return x_output - -# The trial solution using the deep neural network: -def g_trial(x,params, g0 = 10): - return g0 + x*neural_network(params,x) - -# The right side of the ODE: -def g(x, g_trial, gamma = 2): - return -gamma*g_trial - -# The cost function: -def cost_function(P, x): - - # Evaluate the trial function with the current parameters P - g_t = g_trial(x,P) - - # Find the derivative w.r.t x of the neural network - d_net_out = elementwise_grad(neural_network,1)(P,x) - - # Find the derivative w.r.t x of the trial function - d_g_t = elementwise_grad(g_trial,0)(x,P) - - # The right side of the ODE - func = g(x, g_t) - - err_sqr = (d_g_t - func)**2 - cost_sum = np.sum(err_sqr) - - return cost_sum / np.size(err_sqr) - -# Solve the exponential decay ODE using neural network with one input, hidden, and output layer -def solve_ode_neural_network(x, num_neurons_hidden, num_iter, lmb): - ## Set up initial weights and biases - - # For the hidden layer - p0 = npr.randn(num_neurons_hidden, 2 ) - - # For the output layer - p1 = npr.randn(1, num_neurons_hidden + 1 ) # +1 since bias is included - - P = [p0, p1] - - print('Initial cost: %g'%cost_function(P, x)) - - ## Start finding the optimal weights using gradient descent - - # Find the Python function that represents the gradient of the cost function - # w.r.t the 0-th input argument -- that is the weights and biases in the hidden and output layer - cost_function_grad = grad(cost_function,0) - - # Let the update be done num_iter times - for i in range(num_iter): - # Evaluate the gradient at the current weights and biases in P. - # The cost_grad consist now of two arrays; - # one for the gradient w.r.t P_hidden and - # one for the gradient w.r.t P_output - cost_grad = cost_function_grad(P, x) - - P[0] = P[0] - lmb * cost_grad[0] - P[1] = P[1] - lmb * cost_grad[1] - - print('Final cost: %g'%cost_function(P, x)) - - return P - -def g_analytic(x, gamma = 2, g0 = 10): - return g0*np.exp(-gamma*x) - -# Solve the given problem -if __name__ == '__main__': - # Set seed such that the weight are initialized - # with same weights and biases for every run. - npr.seed(15) - - ## Decide the vales of arguments to the function to solve - N = 10 - x = np.linspace(0, 1, N) - - ## Set up the initial parameters - num_hidden_neurons = 10 - num_iter = 10000 - lmb = 0.001 - - # Use the network - P = solve_ode_neural_network(x, num_hidden_neurons, num_iter, lmb) - - # Print the deviation from the trial solution and true solution - res = g_trial(x,P) - res_analytical = g_analytic(x) - - print('Max absolute difference: %g'%np.max(np.abs(res - res_analytical))) - - # Plot the results - plt.figure(figsize=(10,10)) - - plt.title('Performance of neural network solving an ODE compared to the analytical solution') - plt.plot(x, res_analytical) - plt.plot(x, res[0,:]) - plt.legend(['analytical','nn']) - plt.xlabel('x') - plt.ylabel('g(x)') - plt.show() - -## The network with one input layer, specified number of hidden layers, and one output layer - -It is also possible to extend the construction of our network into a more general one, allowing the network to contain more than one hidden layers. - -The number of neurons within each hidden layer are given as a list of integers in the program below. - -import autograd.numpy as np -from autograd import grad, elementwise_grad -import autograd.numpy.random as npr -from matplotlib import pyplot as plt - -def sigmoid(z): - return 1/(1 + np.exp(-z)) - -# The neural network with one input layer and one output layer, -# but with number of hidden layers specified by the user. -def deep_neural_network(deep_params, x): - # N_hidden is the number of hidden layers - - N_hidden = np.size(deep_params) - 1 # -1 since params consists of - # parameters to all the hidden - # layers AND the output layer. - - # Assumes input x being an one-dimensional array - num_values = np.size(x) - x = x.reshape(-1, num_values) - - # Assume that the input layer does nothing to the input x - x_input = x - - # Due to multiple hidden layers, define a variable referencing to the - # output of the previous layer: - x_prev = x_input - - ## Hidden layers: - - for l in range(N_hidden): - # From the list of parameters P; find the correct weigths and bias for this layer - w_hidden = deep_params[l] - - # Add a row of ones to include bias - x_prev = np.concatenate((np.ones((1,num_values)), x_prev ), axis = 0) - - z_hidden = np.matmul(w_hidden, x_prev) - x_hidden = sigmoid(z_hidden) - - # Update x_prev such that next layer can use the output from this layer - x_prev = x_hidden - - ## Output layer: - - # Get the weights and bias for this layer - w_output = deep_params[-1] - - # Include bias: - x_prev = np.concatenate((np.ones((1,num_values)), x_prev), axis = 0) - - z_output = np.matmul(w_output, x_prev) - x_output = z_output - - return x_output - -# The trial solution using the deep neural network: -def g_trial_deep(x,params, g0 = 10): - return g0 + x*deep_neural_network(params, x) - -# The right side of the ODE: -def g(x, g_trial, gamma = 2): - return -gamma*g_trial - -# The same cost function as before, but calls deep_neural_network instead. -def cost_function_deep(P, x): - - # Evaluate the trial function with the current parameters P - g_t = g_trial_deep(x,P) - - # Find the derivative w.r.t x of the neural network - d_net_out = elementwise_grad(deep_neural_network,1)(P,x) - - # Find the derivative w.r.t x of the trial function - d_g_t = elementwise_grad(g_trial_deep,0)(x,P) - - # The right side of the ODE - func = g(x, g_t) - - err_sqr = (d_g_t - func)**2 - cost_sum = np.sum(err_sqr) - - return cost_sum / np.size(err_sqr) - -# Solve the exponential decay ODE using neural network with one input and one output layer, -# but with specified number of hidden layers from the user. -def solve_ode_deep_neural_network(x, num_neurons, num_iter, lmb): - # num_hidden_neurons is now a list of number of neurons within each hidden layer - - # The number of elements in the list num_hidden_neurons thus represents - # the number of hidden layers. - - # Find the number of hidden layers: - N_hidden = np.size(num_neurons) - - ## Set up initial weights and biases - - # Initialize the list of parameters: - P = [None]*(N_hidden + 1) # + 1 to include the output layer - - P[0] = npr.randn(num_neurons[0], 2 ) - for l in range(1,N_hidden): - P[l] = npr.randn(num_neurons[l], num_neurons[l-1] + 1) # +1 to include bias - - # For the output layer - P[-1] = npr.randn(1, num_neurons[-1] + 1 ) # +1 since bias is included - - print('Initial cost: %g'%cost_function_deep(P, x)) - - ## Start finding the optimal weights using gradient descent - - # Find the Python function that represents the gradient of the cost function - # w.r.t the 0-th input argument -- that is the weights and biases in the hidden and output layer - cost_function_deep_grad = grad(cost_function_deep,0) - - # Let the update be done num_iter times - for i in range(num_iter): - # Evaluate the gradient at the current weights and biases in P. - # The cost_grad consist now of N_hidden + 1 arrays; the gradient w.r.t the weights and biases - # in the hidden layers and output layers evaluated at x. - cost_deep_grad = cost_function_deep_grad(P, x) - - for l in range(N_hidden+1): - P[l] = P[l] - lmb * cost_deep_grad[l] - - print('Final cost: %g'%cost_function_deep(P, x)) - - return P - -def g_analytic(x, gamma = 2, g0 = 10): - return g0*np.exp(-gamma*x) - -# Solve the given problem -if __name__ == '__main__': - npr.seed(15) - - ## Decide the vales of arguments to the function to solve - N = 10 - x = np.linspace(0, 1, N) - - ## Set up the initial parameters - num_hidden_neurons = np.array([10,10]) - num_iter = 10000 - lmb = 0.001 - - P = solve_ode_deep_neural_network(x, num_hidden_neurons, num_iter, lmb) - - res = g_trial_deep(x,P) - res_analytical = g_analytic(x) - - plt.figure(figsize=(10,10)) - - plt.title('Performance of a deep neural network solving an ODE compared to the analytical solution') - plt.plot(x, res_analytical) - plt.plot(x, res[0,:]) - plt.legend(['analytical','dnn']) - plt.ylabel('g(x)') - plt.show() - -### Example: Population growth - -A logistic model of population growth assumes that a population converges toward an equilibrium. -The population growth can be modeled by - - -
- -$$ -\begin{equation} \label{log} \tag{10} - g'(t) = \alpha g(t)(A - g(t)) -\end{equation} -$$ - -where $g(t)$ is the population density at time $t$, $\alpha > 0$ the growth rate and $A > 0$ is the maximum population number in the environment. -Also, at $t = 0$ the population has the size $g(0) = g_0$, where $g_0$ is some chosen constant. - -In this example, similar network as for the exponential decay using Autograd has been used to solve the equation. However, as the implementation might suffer from e.g numerical instability -and high execution time (this might be more apparent in the examples solving PDEs), -using a library like TensorFlow is recommended. -Here, we stay with a more simple approach and implement for comparison, the simple forward Euler method. - - - -Here, we will model a population $g(t)$ in an environment having carrying capacity $A$. -The population follows the model - - -
- -$$ -\begin{equation} \label{solveode_population} \tag{11} -g'(t) = \alpha g(t)(A - g(t)) -\end{equation} -$$ - -where $g(0) = g_0$. - -In this example, we let $\alpha = 2$, $A = 1$, and $g_0 = 1.2$. - - -We will get a slightly different trial solution, as the boundary conditions are different -compared to the case for exponential decay. - -A possible trial solution satisfying the condition $g(0) = g_0$ could be - -$$ -h_1(t) = g_0 + t \cdot N(t,P) -$$ - -with $N(t,P)$ being the output from the neural network with weights and biases for each layer collected in the set $P$. - -The analytical solution is - -$$ -g(t) = \frac{Ag_0}{g_0 + (A - g_0)\exp(-\alpha A t)} -$$ - - - -The network will be the similar as for the exponential decay example, but with some small modifications for our problem. - -import autograd.numpy as np -from autograd import grad, elementwise_grad -import autograd.numpy.random as npr -from matplotlib import pyplot as plt - -def sigmoid(z): - return 1/(1 + np.exp(-z)) - -# Function to get the parameters. -# Done such that one can easily change the paramaters after one's liking. -def get_parameters(): - alpha = 2 - A = 1 - g0 = 1.2 - return alpha, A, g0 - -def deep_neural_network(P, x): - # N_hidden is the number of hidden layers - N_hidden = np.size(P) - 1 # -1 since params consist of parameters to all the hidden layers AND the output layer - - # Assumes input x being an one-dimensional array - num_values = np.size(x) - x = x.reshape(-1, num_values) - - # Assume that the input layer does nothing to the input x - x_input = x - - # Due to multiple hidden layers, define a variable referencing to the - # output of the previous layer: - x_prev = x_input - - ## Hidden layers: - - for l in range(N_hidden): - # From the list of parameters P; find the correct weigths and bias for this layer - w_hidden = P[l] - - # Add a row of ones to include bias - x_prev = np.concatenate((np.ones((1,num_values)), x_prev ), axis = 0) - - z_hidden = np.matmul(w_hidden, x_prev) - x_hidden = sigmoid(z_hidden) - - # Update x_prev such that next layer can use the output from this layer - x_prev = x_hidden - - ## Output layer: - - # Get the weights and bias for this layer - w_output = P[-1] - - # Include bias: - x_prev = np.concatenate((np.ones((1,num_values)), x_prev), axis = 0) - - z_output = np.matmul(w_output, x_prev) - x_output = z_output - - return x_output - - -def cost_function_deep(P, x): - - # Evaluate the trial function with the current parameters P - g_t = g_trial_deep(x,P) - - # Find the derivative w.r.t x of the trial function - d_g_t = elementwise_grad(g_trial_deep,0)(x,P) - - # The right side of the ODE - func = f(x, g_t) - - err_sqr = (d_g_t - func)**2 - cost_sum = np.sum(err_sqr) - - return cost_sum / np.size(err_sqr) - -# The right side of the ODE: -def f(x, g_trial): - alpha,A, g0 = get_parameters() - return alpha*g_trial*(A - g_trial) - -# The trial solution using the deep neural network: -def g_trial_deep(x, params): - alpha,A, g0 = get_parameters() - return g0 + x*deep_neural_network(params,x) - -# The analytical solution: -def g_analytic(t): - alpha,A, g0 = get_parameters() - return A*g0/(g0 + (A - g0)*np.exp(-alpha*A*t)) - -def solve_ode_deep_neural_network(x, num_neurons, num_iter, lmb): - # num_hidden_neurons is now a list of number of neurons within each hidden layer - - # Find the number of hidden layers: - N_hidden = np.size(num_neurons) - - ## Set up initial weigths and biases - - # Initialize the list of parameters: - P = [None]*(N_hidden + 1) # + 1 to include the output layer - - P[0] = npr.randn(num_neurons[0], 2 ) - for l in range(1,N_hidden): - P[l] = npr.randn(num_neurons[l], num_neurons[l-1] + 1) # +1 to include bias - - # For the output layer - P[-1] = npr.randn(1, num_neurons[-1] + 1 ) # +1 since bias is included - - print('Initial cost: %g'%cost_function_deep(P, x)) - - ## Start finding the optimal weigths using gradient descent - - # Find the Python function that represents the gradient of the cost function - # w.r.t the 0-th input argument -- that is the weights and biases in the hidden and output layer - cost_function_deep_grad = grad(cost_function_deep,0) - - # Let the update be done num_iter times - for i in range(num_iter): - # Evaluate the gradient at the current weights and biases in P. - # The cost_grad consist now of N_hidden + 1 arrays; the gradient w.r.t the weights and biases - # in the hidden layers and output layers evaluated at x. - cost_deep_grad = cost_function_deep_grad(P, x) - - for l in range(N_hidden+1): - P[l] = P[l] - lmb * cost_deep_grad[l] - - print('Final cost: %g'%cost_function_deep(P, x)) - - return P - -if __name__ == '__main__': - npr.seed(4155) - - ## Decide the vales of arguments to the function to solve - Nt = 10 - T = 1 - t = np.linspace(0,T, Nt) - - ## Set up the initial parameters - num_hidden_neurons = [100, 50, 25] - num_iter = 1000 - lmb = 1e-3 - - P = solve_ode_deep_neural_network(t, num_hidden_neurons, num_iter, lmb) - - g_dnn_ag = g_trial_deep(t,P) - g_analytical = g_analytic(t) - - # Find the maximum absolute difference between the solutons: - diff_ag = np.max(np.abs(g_dnn_ag - g_analytical)) - print("The max absolute difference between the solutions is: %g"%diff_ag) - - plt.figure(figsize=(10,10)) - - plt.title('Performance of neural network solving an ODE compared to the analytical solution') - plt.plot(t, g_analytical) - plt.plot(t, g_dnn_ag[0,:]) - plt.legend(['analytical','nn']) - plt.xlabel('t') - plt.ylabel('g(t)') - - plt.show() - -## Using forward Euler to solve the ODE - -A straightforward way of solving an ODE numerically, is to use Euler's method. - -Euler's method uses Taylor series to approximate the value at a function $f$ at a step $\Delta x$ from $x$: - -$$ -f(x + \Delta x) \approx f(x) + \Delta x f'(x) -$$ - -In our case, using Euler's method to approximate the value of $g$ at a step $\Delta t$ from $t$ yields - -$$ -\begin{aligned} - g(t + \Delta t) &\approx g(t) + \Delta t g'(t) \\ - &= g(t) + \Delta t \big(\alpha g(t)(A - g(t))\big) -\end{aligned} -$$ - -along with the condition that $g(0) = g_0$. - -Let $t_i = i \cdot \Delta t$ where $\Delta t = \frac{T}{N_t-1}$ where $T$ is the final time our solver must solve for and $N_t$ the number of values for $t \in [0, T]$ for $i = 0, \dots, N_t-1$. - -For $i \geq 1$, we have that - -$$ -\begin{aligned} -t_i &= i\Delta t \\ -&= (i - 1)\Delta t + \Delta t \\ -&= t_{i-1} + \Delta t -\end{aligned} -$$ - -Now, if $g_i = g(t_i)$ then - - -
- -$$ -\begin{equation} - \begin{aligned} - g_i &= g(t_i) \\ - &= g(t_{i-1} + \Delta t) \\ - &\approx g(t_{i-1}) + \Delta t \big(\alpha g(t_{i-1})(A - g(t_{i-1}))\big) \\ - &= g_{i-1} + \Delta t \big(\alpha g_{i-1}(A - g_{i-1})\big) - \end{aligned} -\end{equation} \label{odenum} \tag{12} -$$ - -for $i \geq 1$ and $g_0 = g(t_0) = g(0) = g_0$. - -Equation ([12](#odenum)) could be implemented in the following way, -extending the program that uses the network using Autograd: - -# Assume that all function definitions from the example program using Autograd -# are located here. - -if __name__ == '__main__': - npr.seed(4155) - - ## Decide the vales of arguments to the function to solve - Nt = 10 - T = 1 - t = np.linspace(0,T, Nt) - - ## Set up the initial parameters - num_hidden_neurons = [100,50,25] - num_iter = 1000 - lmb = 1e-3 - - P = solve_ode_deep_neural_network(t, num_hidden_neurons, num_iter, lmb) - - g_dnn_ag = g_trial_deep(t,P) - g_analytical = g_analytic(t) - - # Find the maximum absolute difference between the solutons: - diff_ag = np.max(np.abs(g_dnn_ag - g_analytical)) - print("The max absolute difference between the solutions is: %g"%diff_ag) - - plt.figure(figsize=(10,10)) - - plt.title('Performance of neural network solving an ODE compared to the analytical solution') - plt.plot(t, g_analytical) - plt.plot(t, g_dnn_ag[0,:]) - plt.legend(['analytical','nn']) - plt.xlabel('t') - plt.ylabel('g(t)') - - ## Find an approximation to the funtion using forward Euler - - alpha, A, g0 = get_parameters() - dt = T/(Nt - 1) - - # Perform forward Euler to solve the ODE - g_euler = np.zeros(Nt) - g_euler[0] = g0 - - for i in range(1,Nt): - g_euler[i] = g_euler[i-1] + dt*(alpha*g_euler[i-1]*(A - g_euler[i-1])) - - # Print the errors done by each method - diff1 = np.max(np.abs(g_euler - g_analytical)) - diff2 = np.max(np.abs(g_dnn_ag[0,:] - g_analytical)) - - print('Max absolute difference between Euler method and analytical: %g'%diff1) - print('Max absolute difference between deep neural network and analytical: %g'%diff2) - - # Plot results - plt.figure(figsize=(10,10)) - - plt.plot(t,g_euler) - plt.plot(t,g_analytical) - plt.plot(t,g_dnn_ag[0,:]) - - plt.legend(['euler','analytical','dnn']) - plt.xlabel('Time t') - plt.ylabel('g(t)') - - plt.show() - -## Solving the one dimensional Poisson equation - -The Poisson equation for $g(x)$ in one dimension is - - -
- -$$ -\begin{equation} \label{poisson} \tag{13} - -g''(x) = f(x) -\end{equation} -$$ - -where $f(x)$ is a given function for $x \in (0,1)$. - -The conditions that $g(x)$ is chosen to fulfill, are - -$$ -\begin{align*} - g(0) &= 0 \\ - g(1) &= 0 -\end{align*} -$$ - -This equation can be solved numerically using programs where e.g Autograd and TensorFlow are used. -The results from the networks can then be compared to the analytical solution. -In addition, it could be interesting to see how a typical method for numerically solving second order ODEs compares to the neural networks. - - -Here, the function $g(x)$ to solve for follows the equation - -$$ --g''(x) = f(x),\qquad x \in (0,1) -$$ - -where $f(x)$ is a given function, along with the chosen conditions - - -
- -$$ -\begin{aligned} -g(0) = g(1) = 0 -\end{aligned}\label{cond} \tag{14} -$$ - -In this example, we consider the case when $f(x) = (3x + x^2)\exp(x)$. - -For this case, a possible trial solution satisfying the conditions could be - -$$ -g_t(x) = x \cdot (1-x) \cdot N(P,x) -$$ - -The analytical solution for this problem is - -$$ -g(x) = x(1 - x)\exp(x) -$$ - -import autograd.numpy as np -from autograd import grad, elementwise_grad -import autograd.numpy.random as npr -from matplotlib import pyplot as plt - -def sigmoid(z): - return 1/(1 + np.exp(-z)) - -def deep_neural_network(deep_params, x): - # N_hidden is the number of hidden layers - N_hidden = np.size(deep_params) - 1 # -1 since params consist of parameters to all the hidden layers AND the output layer - - # Assumes input x being an one-dimensional array - num_values = np.size(x) - x = x.reshape(-1, num_values) - - # Assume that the input layer does nothing to the input x - x_input = x - - # Due to multiple hidden layers, define a variable referencing to the - # output of the previous layer: - x_prev = x_input - - ## Hidden layers: - - for l in range(N_hidden): - # From the list of parameters P; find the correct weigths and bias for this layer - w_hidden = deep_params[l] - - # Add a row of ones to include bias - x_prev = np.concatenate((np.ones((1,num_values)), x_prev ), axis = 0) - - z_hidden = np.matmul(w_hidden, x_prev) - x_hidden = sigmoid(z_hidden) - - # Update x_prev such that next layer can use the output from this layer - x_prev = x_hidden - - ## Output layer: - - # Get the weights and bias for this layer - w_output = deep_params[-1] - - # Include bias: - x_prev = np.concatenate((np.ones((1,num_values)), x_prev), axis = 0) - - z_output = np.matmul(w_output, x_prev) - x_output = z_output - - return x_output - -def solve_ode_deep_neural_network(x, num_neurons, num_iter, lmb): - # num_hidden_neurons is now a list of number of neurons within each hidden layer - - # Find the number of hidden layers: - N_hidden = np.size(num_neurons) - - ## Set up initial weigths and biases - - # Initialize the list of parameters: - P = [None]*(N_hidden + 1) # + 1 to include the output layer - - P[0] = npr.randn(num_neurons[0], 2 ) - for l in range(1,N_hidden): - P[l] = npr.randn(num_neurons[l], num_neurons[l-1] + 1) # +1 to include bias - - # For the output layer - P[-1] = npr.randn(1, num_neurons[-1] + 1 ) # +1 since bias is included - - print('Initial cost: %g'%cost_function_deep(P, x)) - - ## Start finding the optimal weigths using gradient descent - - # Find the Python function that represents the gradient of the cost function - # w.r.t the 0-th input argument -- that is the weights and biases in the hidden and output layer - cost_function_deep_grad = grad(cost_function_deep,0) - - # Let the update be done num_iter times - for i in range(num_iter): - # Evaluate the gradient at the current weights and biases in P. - # The cost_grad consist now of N_hidden + 1 arrays; the gradient w.r.t the weights and biases - # in the hidden layers and output layers evaluated at x. - cost_deep_grad = cost_function_deep_grad(P, x) - - for l in range(N_hidden+1): - P[l] = P[l] - lmb * cost_deep_grad[l] - - print('Final cost: %g'%cost_function_deep(P, x)) - - return P - -## Set up the cost function specified for this Poisson equation: - -# The right side of the ODE -def f(x): - return (3*x + x**2)*np.exp(x) - -def cost_function_deep(P, x): - - # Evaluate the trial function with the current parameters P - g_t = g_trial_deep(x,P) - - # Find the derivative w.r.t x of the trial function - d2_g_t = elementwise_grad(elementwise_grad(g_trial_deep,0))(x,P) - - right_side = f(x) - - err_sqr = (-d2_g_t - right_side)**2 - cost_sum = np.sum(err_sqr) - - return cost_sum/np.size(err_sqr) - -# The trial solution: -def g_trial_deep(x,P): - return x*(1-x)*deep_neural_network(P,x) - -# The analytic solution; -def g_analytic(x): - return x*(1-x)*np.exp(x) - -if __name__ == '__main__': - npr.seed(4155) - - ## Decide the vales of arguments to the function to solve - Nx = 10 - x = np.linspace(0,1, Nx) - - ## Set up the initial parameters - num_hidden_neurons = [200,100] - num_iter = 1000 - lmb = 1e-3 - - P = solve_ode_deep_neural_network(x, num_hidden_neurons, num_iter, lmb) - - g_dnn_ag = g_trial_deep(x,P) - g_analytical = g_analytic(x) - - # Find the maximum absolute difference between the solutons: - max_diff = np.max(np.abs(g_dnn_ag - g_analytical)) - print("The max absolute difference between the solutions is: %g"%max_diff) - - plt.figure(figsize=(10,10)) - - plt.title('Performance of neural network solving an ODE compared to the analytical solution') - plt.plot(x, g_analytical) - plt.plot(x, g_dnn_ag[0,:]) - plt.legend(['analytical','nn']) - plt.xlabel('x') - plt.ylabel('g(x)') - plt.show() - -### Comparing with a numerical scheme - -The Poisson equation is possible to solve using Taylor series to approximate the second derivative. - -Using Taylor series, the second derivative can be expressed as - -$$ -g''(x) = \frac{g(x + \Delta x) - 2g(x) + g(x-\Delta x)}{\Delta x^2} + E_{\Delta x}(x) -$$ - -where $\Delta x$ is a small step size and $E_{\Delta x}(x)$ being the error term. - -Looking away from the error terms gives an approximation to the second derivative: - - -
- -$$ -\begin{equation} \label{approx} \tag{15} -g''(x) \approx \frac{g(x + \Delta x) - 2g(x) + g(x-\Delta x)}{\Delta x^2} -\end{equation} -$$ - -If $x_i = i \Delta x = x_{i-1} + \Delta x$ and $g_i = g(x_i)$ for $i = 1,\dots N_x - 2$ with $N_x$ being the number of values for $x$, ([15](#approx)) becomes - -$$ -\begin{aligned} -g''(x_i) &\approx \frac{g(x_i + \Delta x) - 2g(x_i) + g(x_i -\Delta x)}{\Delta x^2} \\ -&= \frac{g_{i+1} - 2g_i + g_{i-1}}{\Delta x^2} -\end{aligned} -$$ - -Since we know from our problem that - -$$ -\begin{aligned} --g''(x) &= f(x) \\ -&= (3x + x^2)\exp(x) -\end{aligned} -$$ - -along with the conditions $g(0) = g(1) = 0$, -the following scheme can be used to find an approximate solution for $g(x)$ numerically: - - -
- -$$ -\begin{equation} - \begin{aligned} - -\Big( \frac{g_{i+1} - 2g_i + g_{i-1}}{\Delta x^2} \Big) &= f(x_i) \\ - -g_{i+1} + 2g_i - g_{i-1} &= \Delta x^2 f(x_i) - \end{aligned} -\end{equation} \label{odesys} \tag{16} -$$ - -for $i = 1, \dots, N_x - 2$ where $g_0 = g_{N_x - 1} = 0$ and $f(x_i) = (3x_i + x_i^2)\exp(x_i)$, which is given for our specific problem. - -The equation can be rewritten into a matrix equation: - -$$ -\begin{aligned} -\begin{pmatrix} -2 & -1 & 0 & \dots & 0 \\ --1 & 2 & -1 & \dots & 0 \\ -\vdots & & \ddots & & \vdots \\ -0 & \dots & -1 & 2 & -1 \\ -0 & \dots & 0 & -1 & 2\\ -\end{pmatrix} -\begin{pmatrix} -g_1 \\ -g_2 \\ -\vdots \\ -g_{N_x - 3} \\ -g_{N_x - 2} -\end{pmatrix} -&= -\Delta x^2 -\begin{pmatrix} -f(x_1) \\ -f(x_2) \\ -\vdots \\ -f(x_{N_x - 3}) \\ -f(x_{N_x - 2}) -\end{pmatrix} \\ -\boldsymbol{A}\boldsymbol{g} &= \boldsymbol{f}, -\end{aligned} -$$ - -which makes it possible to solve for the vector $\boldsymbol{g}$. - - -We can then compare the result from this numerical scheme with the output from our network using Autograd: - -import autograd.numpy as np -from autograd import grad, elementwise_grad -import autograd.numpy.random as npr -from matplotlib import pyplot as plt - -def sigmoid(z): - return 1/(1 + np.exp(-z)) - -def deep_neural_network(deep_params, x): - # N_hidden is the number of hidden layers - N_hidden = np.size(deep_params) - 1 # -1 since params consist of parameters to all the hidden layers AND the output layer - - # Assumes input x being an one-dimensional array - num_values = np.size(x) - x = x.reshape(-1, num_values) - - # Assume that the input layer does nothing to the input x - x_input = x - - # Due to multiple hidden layers, define a variable referencing to the - # output of the previous layer: - x_prev = x_input - - ## Hidden layers: - - for l in range(N_hidden): - # From the list of parameters P; find the correct weigths and bias for this layer - w_hidden = deep_params[l] - - # Add a row of ones to include bias - x_prev = np.concatenate((np.ones((1,num_values)), x_prev ), axis = 0) - - z_hidden = np.matmul(w_hidden, x_prev) - x_hidden = sigmoid(z_hidden) - - # Update x_prev such that next layer can use the output from this layer - x_prev = x_hidden - - ## Output layer: - - # Get the weights and bias for this layer - w_output = deep_params[-1] - - # Include bias: - x_prev = np.concatenate((np.ones((1,num_values)), x_prev), axis = 0) - - z_output = np.matmul(w_output, x_prev) - x_output = z_output - - return x_output - -def solve_ode_deep_neural_network(x, num_neurons, num_iter, lmb): - # num_hidden_neurons is now a list of number of neurons within each hidden layer - - # Find the number of hidden layers: - N_hidden = np.size(num_neurons) - - ## Set up initial weigths and biases - - # Initialize the list of parameters: - P = [None]*(N_hidden + 1) # + 1 to include the output layer - - P[0] = npr.randn(num_neurons[0], 2 ) - for l in range(1,N_hidden): - P[l] = npr.randn(num_neurons[l], num_neurons[l-1] + 1) # +1 to include bias - - # For the output layer - P[-1] = npr.randn(1, num_neurons[-1] + 1 ) # +1 since bias is included - - print('Initial cost: %g'%cost_function_deep(P, x)) - - ## Start finding the optimal weigths using gradient descent - - # Find the Python function that represents the gradient of the cost function - # w.r.t the 0-th input argument -- that is the weights and biases in the hidden and output layer - cost_function_deep_grad = grad(cost_function_deep,0) - - # Let the update be done num_iter times - for i in range(num_iter): - # Evaluate the gradient at the current weights and biases in P. - # The cost_grad consist now of N_hidden + 1 arrays; the gradient w.r.t the weights and biases - # in the hidden layers and output layers evaluated at x. - cost_deep_grad = cost_function_deep_grad(P, x) - - for l in range(N_hidden+1): - P[l] = P[l] - lmb * cost_deep_grad[l] - - print('Final cost: %g'%cost_function_deep(P, x)) - - return P - -## Set up the cost function specified for this Poisson equation: - -# The right side of the ODE -def f(x): - return (3*x + x**2)*np.exp(x) - -def cost_function_deep(P, x): - - # Evaluate the trial function with the current parameters P - g_t = g_trial_deep(x,P) - - # Find the derivative w.r.t x of the trial function - d2_g_t = elementwise_grad(elementwise_grad(g_trial_deep,0))(x,P) - - right_side = f(x) - - err_sqr = (-d2_g_t - right_side)**2 - cost_sum = np.sum(err_sqr) - - return cost_sum/np.size(err_sqr) - -# The trial solution: -def g_trial_deep(x,P): - return x*(1-x)*deep_neural_network(P,x) - -# The analytic solution; -def g_analytic(x): - return x*(1-x)*np.exp(x) - -if __name__ == '__main__': - npr.seed(4155) - - ## Decide the vales of arguments to the function to solve - Nx = 10 - x = np.linspace(0,1, Nx) - - ## Set up the initial parameters - num_hidden_neurons = [200,100] - num_iter = 1000 - lmb = 1e-3 - - P = solve_ode_deep_neural_network(x, num_hidden_neurons, num_iter, lmb) - - g_dnn_ag = g_trial_deep(x,P) - g_analytical = g_analytic(x) - - # Find the maximum absolute difference between the solutons: - - plt.figure(figsize=(10,10)) - - plt.title('Performance of neural network solving an ODE compared to the analytical solution') - plt.plot(x, g_analytical) - plt.plot(x, g_dnn_ag[0,:]) - plt.legend(['analytical','nn']) - plt.xlabel('x') - plt.ylabel('g(x)') - - ## Perform the computation using the numerical scheme - - dx = 1/(Nx - 1) - - # Set up the matrix A - A = np.zeros((Nx-2,Nx-2)) - - A[0,0] = 2 - A[0,1] = -1 - - for i in range(1,Nx-3): - A[i,i-1] = -1 - A[i,i] = 2 - A[i,i+1] = -1 - - A[Nx - 3, Nx - 4] = -1 - A[Nx - 3, Nx - 3] = 2 - - # Set up the vector f - f_vec = dx**2 * f(x[1:-1]) - - # Solve the equation - g_res = np.linalg.solve(A,f_vec) - - g_vec = np.zeros(Nx) - g_vec[1:-1] = g_res - - # Print the differences between each method - max_diff1 = np.max(np.abs(g_dnn_ag - g_analytical)) - max_diff2 = np.max(np.abs(g_vec - g_analytical)) - print("The max absolute difference between the analytical solution and DNN Autograd: %g"%max_diff1) - print("The max absolute difference between the analytical solution and numerical scheme: %g"%max_diff2) - - # Plot the results - plt.figure(figsize=(10,10)) - - plt.plot(x,g_vec) - plt.plot(x,g_analytical) - plt.plot(x,g_dnn_ag[0,:]) - - plt.legend(['numerical scheme','analytical','dnn']) - plt.show() - -## Partial Differential Equations - -A partial differential equation (PDE) has a solution here the function -is defined by multiple variables. The equation may involve all kinds -of combinations of which variables the function is differentiated with -respect to. - -In general, a partial differential equation for a function $g(x_1,\dots,x_N)$ with $N$ variables may be expressed as - - -
- -$$ -\begin{equation} \label{PDE} \tag{17} - f\left(x_1, \, \dots \, , x_N, \frac{\partial g(x_1,\dots,x_N) }{\partial x_1}, \dots , \frac{\partial g(x_1,\dots,x_N) }{\partial x_N}, \frac{\partial g(x_1,\dots,x_N) }{\partial x_1\partial x_2}, \, \dots \, , \frac{\partial^n g(x_1,\dots,x_N) }{\partial x_N^n} \right) = 0 -\end{equation} -$$ - -where $f$ is an expression involving all kinds of possible mixed derivatives of $g(x_1,\dots,x_N)$ up to an order $n$. In order for the solution to be unique, some additional conditions must also be given. - -### Type of problem - -The problem our network must solve for, is similar to the ODE case. -We must have a trial solution $g_t$ at hand. - -For instance, the trial solution could be expressed as - -$$ -\begin{align*} - g_t(x_1,\dots,x_N) = h_1(x_1,\dots,x_N) + h_2(x_1,\dots,x_N,N(x_1,\dots,x_N,P)) -\end{align*} -$$ - -where $h_1(x_1,\dots,x_N)$ is a function that ensures $g_t(x_1,\dots,x_N)$ satisfies some given conditions. -The neural network $N(x_1,\dots,x_N,P)$ has weights and biases described by $P$ and $h_2(x_1,\dots,x_N,N(x_1,\dots,x_N,P))$ is an expression using the output from the neural network in some way. - -The role of the function $h_2(x_1,\dots,x_N,N(x_1,\dots,x_N,P))$, is to ensure that the output of $N(x_1,\dots,x_N,P)$ is zero when $g_t(x_1,\dots,x_N)$ is evaluated at the values of $x_1,\dots,x_N$ where the given conditions must be satisfied. The function $h_1(x_1,\dots,x_N)$ should alone make $g_t(x_1,\dots,x_N)$ satisfy the conditions. - - - -### Network requirements - -The network tries then the minimize the cost function following the -same ideas as described for the ODE case, but now with more than one -variables to consider. The concept still remains the same; find a set -of parameters $P$ such that the expression $f$ in ([17](#PDE)) is as -close to zero as possible. - -As for the ODE case, the cost function is the mean squared error that -the network must try to minimize. The cost function for the network to -minimize is - -$$ -C\left(x_1, \dots, x_N, P\right) = \left( f\left(x_1, \, \dots \, , x_N, \frac{\partial g(x_1,\dots,x_N) }{\partial x_1}, \dots , \frac{\partial g(x_1,\dots,x_N) }{\partial x_N}, \frac{\partial g(x_1,\dots,x_N) }{\partial x_1\partial x_2}, \, \dots \, , \frac{\partial^n g(x_1,\dots,x_N) }{\partial x_N^n} \right) \right)^2 -$$ - -If we let $\boldsymbol{x} = \big( x_1, \dots, x_N \big)$ be an array containing the values for $x_1, \dots, x_N$ respectively, the cost function can be reformulated into the following: - -$$ -C\left(\boldsymbol{x}, P\right) = f\left( \left( \boldsymbol{x}, \frac{\partial g(\boldsymbol{x}) }{\partial x_1}, \dots , \frac{\partial g(\boldsymbol{x}) }{\partial x_N}, \frac{\partial g(\boldsymbol{x}) }{\partial x_1\partial x_2}, \, \dots \, , \frac{\partial^n g(\boldsymbol{x}) }{\partial x_N^n} \right) \right)^2 -$$ - -If we also have $M$ different sets of values for $x_1, \dots, x_N$, that is $\boldsymbol{x}_i = \big(x_1^{(i)}, \dots, x_N^{(i)}\big)$ for $i = 1,\dots,M$ being the rows in matrix $X$, the cost function can be generalized into - -$$ -C\left(X, P \right) = \sum_{i=1}^M f\left( \left( \boldsymbol{x}_i, \frac{\partial g(\boldsymbol{x}_i) }{\partial x_1}, \dots , \frac{\partial g(\boldsymbol{x}_i) }{\partial x_N}, \frac{\partial g(\boldsymbol{x}_i) }{\partial x_1\partial x_2}, \, \dots \, , \frac{\partial^n g(\boldsymbol{x}_i) }{\partial x_N^n} \right) \right)^2. -$$ - -## Example: The diffusion equation - -In one spatial dimension, the equation reads - -$$ -\frac{\partial g(x,t)}{\partial t} = \frac{\partial^2 g(x,t)}{\partial x^2} -$$ - -where a possible choice of conditions are - -$$ -\begin{align*} -g(0,t) &= 0 ,\qquad t \geq 0 \\ -g(1,t) &= 0, \qquad t \geq 0 \\ -g(x,0) &= u(x),\qquad x\in [0,1] -\end{align*} -$$ - -with $u(x)$ being some given function. - - - -For this case, we want to find $g(x,t)$ such that - - -
- -$$ -\begin{equation} - \frac{\partial g(x,t)}{\partial t} = \frac{\partial^2 g(x,t)}{\partial x^2} -\end{equation} \label{diffonedim} \tag{18} -$$ - -and - -$$ -\begin{align*} -g(0,t) &= 0 ,\qquad t \geq 0 \\ -g(1,t) &= 0, \qquad t \geq 0 \\ -g(x,0) &= u(x),\qquad x\in [0,1] -\end{align*} -$$ - -with $u(x) = \sin(\pi x)$. - -First, let us set up the deep neural network. -The deep neural network will follow the same structure as discussed in the examples solving the ODEs. -First, we will look into how Autograd could be used in a network tailored to solve for bivariate functions. - - - - -The only change to do here, is to extend our network such that -functions of multiple parameters are correctly handled. In this case -we have two variables in our function to solve for, that is time $t$ -and position $x$. The variables will be represented by a -one-dimensional array in the program. The program will evaluate the -network at each possible pair $(x,t)$, given an array for the desired -$x$-values and $t$-values to approximate the solution at. - -def sigmoid(z): - return 1/(1 + np.exp(-z)) - -def deep_neural_network(deep_params, x): - # x is now a point and a 1D numpy array; make it a column vector - num_coordinates = np.size(x,0) - x = x.reshape(num_coordinates,-1) - - num_points = np.size(x,1) - - # N_hidden is the number of hidden layers - N_hidden = np.size(deep_params) - 1 # -1 since params consist of parameters to all the hidden layers AND the output layer - - # Assume that the input layer does nothing to the input x - x_input = x - x_prev = x_input - - ## Hidden layers: - - for l in range(N_hidden): - # From the list of parameters P; find the correct weigths and bias for this layer - w_hidden = deep_params[l] - - # Add a row of ones to include bias - x_prev = np.concatenate((np.ones((1,num_points)), x_prev ), axis = 0) - - z_hidden = np.matmul(w_hidden, x_prev) - x_hidden = sigmoid(z_hidden) - - # Update x_prev such that next layer can use the output from this layer - x_prev = x_hidden - - ## Output layer: - - # Get the weights and bias for this layer - w_output = deep_params[-1] - - # Include bias: - x_prev = np.concatenate((np.ones((1,num_points)), x_prev), axis = 0) - - z_output = np.matmul(w_output, x_prev) - x_output = z_output - - return x_output[0][0] - -The cost function must then iterate through the given arrays -containing values for $x$ and $t$, defines a point $(x,t)$ the deep -neural network and the trial solution is evaluated at, and then finds -the Jacobian of the trial solution. - -A possible trial solution for this PDE is - -$$ -g_t(x,t) = h_1(x,t) + x(1-x)tN(x,t,P) -$$ - -with $A(x,t)$ being a function ensuring that $g_t(x,t)$ satisfies our given conditions, and $N(x,t,P)$ being the output from the deep neural network using weights and biases for each layer from $P$. - -To fulfill the conditions, $A(x,t)$ could be: - -$$ -h_1(x,t) = (1-t)\Big(u(x) - \big((1-x)u(0) + x u(1)\big)\Big) = (1-t)u(x) = (1-t)\sin(\pi x) -$$ -since $(0) = u(1) = 0$ and $u(x) = \sin(\pi x)$. - - - -The Jacobian is used because the program must find the derivative of -the trial solution with respect to $x$ and $t$. - -This gives the necessity of computing the Jacobian matrix, as we want -to evaluate the gradient with respect to $x$ and $t$ (note that the -Jacobian of a scalar-valued multivariate function is simply its -gradient). - -In Autograd, the differentiation is by default done with respect to -the first input argument of your Python function. Since the points is -an array representing $x$ and $t$, the Jacobian is calculated using -the values of $x$ and $t$. - -To find the second derivative with respect to $x$ and $t$, the -Jacobian can be found for the second time. The result is a Hessian -matrix, which is the matrix containing all the possible second order -mixed derivatives of $g(x,t)$. - -# Set up the trial function: -def u(x): - return np.sin(np.pi*x) - -def g_trial(point,P): - x,t = point - return (1-t)*u(x) + x*(1-x)*t*deep_neural_network(P,point) - -# The right side of the ODE: -def f(point): - return 0. - -# The cost function: -def cost_function(P, x, t): - cost_sum = 0 - - g_t_jacobian_func = jacobian(g_trial) - g_t_hessian_func = hessian(g_trial) - - for x_ in x: - for t_ in t: - point = np.array([x_,t_]) - - g_t = g_trial(point,P) - g_t_jacobian = g_t_jacobian_func(point,P) - g_t_hessian = g_t_hessian_func(point,P) - - g_t_dt = g_t_jacobian[1] - g_t_d2x = g_t_hessian[0][0] - - func = f(point) - - err_sqr = ( (g_t_dt - g_t_d2x) - func)**2 - cost_sum += err_sqr - - return cost_sum - -### Setting up the network using Autograd; The full program - -Having set up the network, along with the trial solution and cost function, we can now see how the deep neural network performs by comparing the results to the analytical solution. - -The analytical solution of our problem is - -$$ -g(x,t) = \exp(-\pi^2 t)\sin(\pi x) -$$ - -A possible way to implement a neural network solving the PDE, is given below. -Be aware, though, that it is fairly slow for the parameters used. -A better result is possible, but requires more iterations, and thus longer time to complete. - - -Indeed, the program below is not optimal in its implementation, but rather serves as an example on how to implement and use a neural network to solve a PDE. -Using TensorFlow results in a much better execution time. Try it! - -import autograd.numpy as np -from autograd import jacobian,hessian,grad -import autograd.numpy.random as npr -from matplotlib import cm -from matplotlib import pyplot as plt -from mpl_toolkits.mplot3d import axes3d - -## Set up the network - -def sigmoid(z): - return 1/(1 + np.exp(-z)) - -def deep_neural_network(deep_params, x): - # x is now a point and a 1D numpy array; make it a column vector - num_coordinates = np.size(x,0) - x = x.reshape(num_coordinates,-1) - - num_points = np.size(x,1) - - # N_hidden is the number of hidden layers - N_hidden = np.size(deep_params) - 1 # -1 since params consist of parameters to all the hidden layers AND the output layer - - # Assume that the input layer does nothing to the input x - x_input = x - x_prev = x_input - - ## Hidden layers: - - for l in range(N_hidden): - # From the list of parameters P; find the correct weigths and bias for this layer - w_hidden = deep_params[l] - - # Add a row of ones to include bias - x_prev = np.concatenate((np.ones((1,num_points)), x_prev ), axis = 0) - - z_hidden = np.matmul(w_hidden, x_prev) - x_hidden = sigmoid(z_hidden) - - # Update x_prev such that next layer can use the output from this layer - x_prev = x_hidden - - ## Output layer: - - # Get the weights and bias for this layer - w_output = deep_params[-1] - - # Include bias: - x_prev = np.concatenate((np.ones((1,num_points)), x_prev), axis = 0) - - z_output = np.matmul(w_output, x_prev) - x_output = z_output - - return x_output[0][0] - -## Define the trial solution and cost function -def u(x): - return np.sin(np.pi*x) - -def g_trial(point,P): - x,t = point - return (1-t)*u(x) + x*(1-x)*t*deep_neural_network(P,point) - -# The right side of the ODE: -def f(point): - return 0. - -# The cost function: -def cost_function(P, x, t): - cost_sum = 0 - - g_t_jacobian_func = jacobian(g_trial) - g_t_hessian_func = hessian(g_trial) - - for x_ in x: - for t_ in t: - point = np.array([x_,t_]) - - g_t = g_trial(point,P) - g_t_jacobian = g_t_jacobian_func(point,P) - g_t_hessian = g_t_hessian_func(point,P) - - g_t_dt = g_t_jacobian[1] - g_t_d2x = g_t_hessian[0][0] - - func = f(point) - - err_sqr = ( (g_t_dt - g_t_d2x) - func)**2 - cost_sum += err_sqr - - return cost_sum /( np.size(x)*np.size(t) ) - -## For comparison, define the analytical solution -def g_analytic(point): - x,t = point - return np.exp(-np.pi**2*t)*np.sin(np.pi*x) - -## Set up a function for training the network to solve for the equation -def solve_pde_deep_neural_network(x,t, num_neurons, num_iter, lmb): - ## Set up initial weigths and biases - N_hidden = np.size(num_neurons) - - ## Set up initial weigths and biases - - # Initialize the list of parameters: - P = [None]*(N_hidden + 1) # + 1 to include the output layer - - P[0] = npr.randn(num_neurons[0], 2 + 1 ) # 2 since we have two points, +1 to include bias - for l in range(1,N_hidden): - P[l] = npr.randn(num_neurons[l], num_neurons[l-1] + 1) # +1 to include bias - - # For the output layer - P[-1] = npr.randn(1, num_neurons[-1] + 1 ) # +1 since bias is included - - print('Initial cost: ',cost_function(P, x, t)) - - cost_function_grad = grad(cost_function,0) - - # Let the update be done num_iter times - for i in range(num_iter): - cost_grad = cost_function_grad(P, x , t) - - for l in range(N_hidden+1): - P[l] = P[l] - lmb * cost_grad[l] - - print('Final cost: ',cost_function(P, x, t)) - - return P - -if __name__ == '__main__': - ### Use the neural network: - npr.seed(15) - - ## Decide the vales of arguments to the function to solve - Nx = 10; Nt = 10 - x = np.linspace(0, 1, Nx) - t = np.linspace(0,1,Nt) - - ## Set up the parameters for the network - num_hidden_neurons = [100, 25] - num_iter = 250 - lmb = 0.01 - - P = solve_pde_deep_neural_network(x,t, num_hidden_neurons, num_iter, lmb) - - ## Store the results - g_dnn_ag = np.zeros((Nx, Nt)) - G_analytical = np.zeros((Nx, Nt)) - for i,x_ in enumerate(x): - for j, t_ in enumerate(t): - point = np.array([x_, t_]) - g_dnn_ag[i,j] = g_trial(point,P) - - G_analytical[i,j] = g_analytic(point) - - # Find the map difference between the analytical and the computed solution - diff_ag = np.abs(g_dnn_ag - G_analytical) - print('Max absolute difference between the analytical solution and the network: %g'%np.max(diff_ag)) - - ## Plot the solutions in two dimensions, that being in position and time - - T,X = np.meshgrid(t,x) - - fig = plt.figure(figsize=(10,10)) - ax = fig.gca(projection='3d') - ax.set_title('Solution from the deep neural network w/ %d layer'%len(num_hidden_neurons)) - s = ax.plot_surface(T,X,g_dnn_ag,linewidth=0,antialiased=False,cmap=cm.viridis) - ax.set_xlabel('Time $t$') - ax.set_ylabel('Position $x$'); - - - fig = plt.figure(figsize=(10,10)) - ax = fig.gca(projection='3d') - ax.set_title('Analytical solution') - s = ax.plot_surface(T,X,G_analytical,linewidth=0,antialiased=False,cmap=cm.viridis) - ax.set_xlabel('Time $t$') - ax.set_ylabel('Position $x$'); - - fig = plt.figure(figsize=(10,10)) - ax = fig.gca(projection='3d') - ax.set_title('Difference') - s = ax.plot_surface(T,X,diff_ag,linewidth=0,antialiased=False,cmap=cm.viridis) - ax.set_xlabel('Time $t$') - ax.set_ylabel('Position $x$'); - - ## Take some slices of the 3D plots just to see the solutions at particular times - indx1 = 0 - indx2 = int(Nt/2) - indx3 = Nt-1 - - t1 = t[indx1] - t2 = t[indx2] - t3 = t[indx3] - - # Slice the results from the DNN - res1 = g_dnn_ag[:,indx1] - res2 = g_dnn_ag[:,indx2] - res3 = g_dnn_ag[:,indx3] - - # Slice the analytical results - res_analytical1 = G_analytical[:,indx1] - res_analytical2 = G_analytical[:,indx2] - res_analytical3 = G_analytical[:,indx3] - - # Plot the slices - plt.figure(figsize=(10,10)) - plt.title("Computed solutions at time = %g"%t1) - plt.plot(x, res1) - plt.plot(x,res_analytical1) - plt.legend(['dnn','analytical']) - - plt.figure(figsize=(10,10)) - plt.title("Computed solutions at time = %g"%t2) - plt.plot(x, res2) - plt.plot(x,res_analytical2) - plt.legend(['dnn','analytical']) - - plt.figure(figsize=(10,10)) - plt.title("Computed solutions at time = %g"%t3) - plt.plot(x, res3) - plt.plot(x,res_analytical3) - plt.legend(['dnn','analytical']) - - plt.show() - -## Solving the wave equation with Neural Networks - -The wave equation is - -$$ -\frac{\partial^2 g(x,t)}{\partial t^2} = c^2\frac{\partial^2 g(x,t)}{\partial x^2} -$$ - -with $c$ being the specified wave speed. - -Here, the chosen conditions are - -$$ -\begin{align*} - g(0,t) &= 0 \\ - g(1,t) &= 0 \\ - g(x,0) &= u(x) \\ - \frac{\partial g(x,t)}{\partial t} \Big |_{t = 0} &= v(x) -\end{align*} -$$ - -where $\frac{\partial g(x,t)}{\partial t} \Big |_{t = 0}$ means the derivative of $g(x,t)$ with respect to $t$ is evaluated at $t = 0$, and $u(x)$ and $v(x)$ being given functions. - - -The wave equation to solve for, is - - -
- -$$ -\begin{equation} \label{wave} \tag{19} -\frac{\partial^2 g(x,t)}{\partial t^2} = c^2 \frac{\partial^2 g(x,t)}{\partial x^2} -\end{equation} -$$ - -where $c$ is the given wave speed. -The chosen conditions for this equation are - - -
- -$$ -\begin{aligned} -g(0,t) &= 0, &t \geq 0 \\ -g(1,t) &= 0, &t \geq 0 \\ -g(x,0) &= u(x), &x\in[0,1] \\ -\frac{\partial g(x,t)}{\partial t}\Big |_{t = 0} &= v(x), &x \in [0,1] -\end{aligned} \label{condwave} \tag{20} -$$ - -In this example, let $c = 1$ and $u(x) = \sin(\pi x)$ and $v(x) = -\pi\sin(\pi x)$. - - - -Setting up the network is done in similar matter as for the example of solving the diffusion equation. -The only things we have to change, is the trial solution such that it satisfies the conditions from ([20](#condwave)) and the cost function. - -The trial solution becomes slightly different since we have other conditions than in the example of solving the diffusion equation. Here, a possible trial solution $g_t(x,t)$ is - -$$ -g_t(x,t) = h_1(x,t) + x(1-x)t^2N(x,t,P) -$$ - -where - -$$ -h_1(x,t) = (1-t^2)u(x) + tv(x) -$$ - -Note that this trial solution satisfies the conditions only if $u(0) = v(0) = u(1) = v(1) = 0$, which is the case in this example. - - -The analytical solution for our specific problem, is - -$$ -g(x,t) = \sin(\pi x)\cos(\pi t) - \sin(\pi x)\sin(\pi t) -$$ - -import autograd.numpy as np -from autograd import hessian,grad -import autograd.numpy.random as npr -from matplotlib import cm -from matplotlib import pyplot as plt -from mpl_toolkits.mplot3d import axes3d - -## Set up the trial function: -def u(x): - return np.sin(np.pi*x) - -def v(x): - return -np.pi*np.sin(np.pi*x) - -def h1(point): - x,t = point - return (1 - t**2)*u(x) + t*v(x) - -def g_trial(point,P): - x,t = point - return h1(point) + x*(1-x)*t**2*deep_neural_network(P,point) - -## Define the cost function -def cost_function(P, x, t): - cost_sum = 0 - - g_t_hessian_func = hessian(g_trial) - - for x_ in x: - for t_ in t: - point = np.array([x_,t_]) - - g_t_hessian = g_t_hessian_func(point,P) - - g_t_d2x = g_t_hessian[0][0] - g_t_d2t = g_t_hessian[1][1] - - err_sqr = ( (g_t_d2t - g_t_d2x) )**2 - cost_sum += err_sqr - - return cost_sum / (np.size(t) * np.size(x)) - -## The neural network -def sigmoid(z): - return 1/(1 + np.exp(-z)) - -def deep_neural_network(deep_params, x): - # x is now a point and a 1D numpy array; make it a column vector - num_coordinates = np.size(x,0) - x = x.reshape(num_coordinates,-1) - - num_points = np.size(x,1) - - # N_hidden is the number of hidden layers - N_hidden = np.size(deep_params) - 1 # -1 since params consist of parameters to all the hidden layers AND the output layer - - # Assume that the input layer does nothing to the input x - x_input = x - x_prev = x_input - - ## Hidden layers: - - for l in range(N_hidden): - # From the list of parameters P; find the correct weigths and bias for this layer - w_hidden = deep_params[l] - - # Add a row of ones to include bias - x_prev = np.concatenate((np.ones((1,num_points)), x_prev ), axis = 0) - - z_hidden = np.matmul(w_hidden, x_prev) - x_hidden = sigmoid(z_hidden) - - # Update x_prev such that next layer can use the output from this layer - x_prev = x_hidden - - ## Output layer: - - # Get the weights and bias for this layer - w_output = deep_params[-1] - - # Include bias: - x_prev = np.concatenate((np.ones((1,num_points)), x_prev), axis = 0) - - z_output = np.matmul(w_output, x_prev) - x_output = z_output - - return x_output[0][0] - -## The analytical solution -def g_analytic(point): - x,t = point - return np.sin(np.pi*x)*np.cos(np.pi*t) - np.sin(np.pi*x)*np.sin(np.pi*t) - -def solve_pde_deep_neural_network(x,t, num_neurons, num_iter, lmb): - ## Set up initial weigths and biases - N_hidden = np.size(num_neurons) - - ## Set up initial weigths and biases - - # Initialize the list of parameters: - P = [None]*(N_hidden + 1) # + 1 to include the output layer - - P[0] = npr.randn(num_neurons[0], 2 + 1 ) # 2 since we have two points, +1 to include bias - for l in range(1,N_hidden): - P[l] = npr.randn(num_neurons[l], num_neurons[l-1] + 1) # +1 to include bias - - # For the output layer - P[-1] = npr.randn(1, num_neurons[-1] + 1 ) # +1 since bias is included - - print('Initial cost: ',cost_function(P, x, t)) - - cost_function_grad = grad(cost_function,0) - - # Let the update be done num_iter times - for i in range(num_iter): - cost_grad = cost_function_grad(P, x , t) - - for l in range(N_hidden+1): - P[l] = P[l] - lmb * cost_grad[l] - - - print('Final cost: ',cost_function(P, x, t)) - - return P - -if __name__ == '__main__': - ### Use the neural network: - npr.seed(15) - - ## Decide the vales of arguments to the function to solve - Nx = 10; Nt = 10 - x = np.linspace(0, 1, Nx) - t = np.linspace(0,1,Nt) - - ## Set up the parameters for the network - num_hidden_neurons = [50,20] - num_iter = 1000 - lmb = 0.01 - - P = solve_pde_deep_neural_network(x,t, num_hidden_neurons, num_iter, lmb) - - ## Store the results - res = np.zeros((Nx, Nt)) - res_analytical = np.zeros((Nx, Nt)) - for i,x_ in enumerate(x): - for j, t_ in enumerate(t): - point = np.array([x_, t_]) - res[i,j] = g_trial(point,P) - - res_analytical[i,j] = g_analytic(point) - - diff = np.abs(res - res_analytical) - print("Max difference between analytical and solution from nn: %g"%np.max(diff)) - - ## Plot the solutions in two dimensions, that being in position and time - - T,X = np.meshgrid(t,x) - - fig = plt.figure(figsize=(10,10)) - ax = fig.gca(projection='3d') - ax.set_title('Solution from the deep neural network w/ %d layer'%len(num_hidden_neurons)) - s = ax.plot_surface(T,X,res,linewidth=0,antialiased=False,cmap=cm.viridis) - ax.set_xlabel('Time $t$') - ax.set_ylabel('Position $x$'); - - - fig = plt.figure(figsize=(10,10)) - ax = fig.gca(projection='3d') - ax.set_title('Analytical solution') - s = ax.plot_surface(T,X,res_analytical,linewidth=0,antialiased=False,cmap=cm.viridis) - ax.set_xlabel('Time $t$') - ax.set_ylabel('Position $x$'); - - - fig = plt.figure(figsize=(10,10)) - ax = fig.gca(projection='3d') - ax.set_title('Difference') - s = ax.plot_surface(T,X,diff,linewidth=0,antialiased=False,cmap=cm.viridis) - ax.set_xlabel('Time $t$') - ax.set_ylabel('Position $x$'); - - ## Take some slices of the 3D plots just to see the solutions at particular times - indx1 = 0 - indx2 = int(Nt/2) - indx3 = Nt-1 - - t1 = t[indx1] - t2 = t[indx2] - t3 = t[indx3] - - # Slice the results from the DNN - res1 = res[:,indx1] - res2 = res[:,indx2] - res3 = res[:,indx3] - - # Slice the analytical results - res_analytical1 = res_analytical[:,indx1] - res_analytical2 = res_analytical[:,indx2] - res_analytical3 = res_analytical[:,indx3] - - # Plot the slices - plt.figure(figsize=(10,10)) - plt.title("Computed solutions at time = %g"%t1) - plt.plot(x, res1) - plt.plot(x,res_analytical1) - plt.legend(['dnn','analytical']) - - plt.figure(figsize=(10,10)) - plt.title("Computed solutions at time = %g"%t2) - plt.plot(x, res2) - plt.plot(x,res_analytical2) - plt.legend(['dnn','analytical']) - - plt.figure(figsize=(10,10)) - plt.title("Computed solutions at time = %g"%t3) - plt.plot(x, res3) - plt.plot(x,res_analytical3) - plt.legend(['dnn','analytical']) - - plt.show() - -## Resources on differential equations and deep learning - -1. [Artificial neural networks for solving ordinary and partial differential equations by I.E. Lagaris et al](https://pdfs.semanticscholar.org/d061/df393e0e8fbfd0ea24976458b7d42419040d.pdf) - -2. [Neural networks for solving differential equations by A. Honchar](https://becominghuman.ai/neural-networks-for-solving-differential-equations-fa230ac5e04c) - -3. [Solving differential equations using neural networks by M.M Chiaramonte and M. Kiener](http://cs229.stanford.edu/proj2013/ChiaramonteKiener-SolvingDifferentialEquationsUsingNeuralNetworks.pdf) - -4. [Introduction to Partial Differential Equations by A. Tveito, R. Winther](https://www.springer.com/us/book/9783540225515) \ No newline at end of file diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter11_47_2.png b/doc/LectureNotes/_build/jupyter_execute/chapter11_47_2.png deleted file mode 100644 index 5667f3351..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter11_47_2.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter11_49_3.png b/doc/LectureNotes/_build/jupyter_execute/chapter11_49_3.png deleted file mode 100644 index d8fe671bb..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter11_49_3.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter11_55_3.png b/doc/LectureNotes/_build/jupyter_execute/chapter11_55_3.png deleted file mode 100644 index 25118b436..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter11_55_3.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter11_63_3.png b/doc/LectureNotes/_build/jupyter_execute/chapter11_63_3.png deleted file mode 100644 index 25118b436..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter11_63_3.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter11_63_4.png b/doc/LectureNotes/_build/jupyter_execute/chapter11_63_4.png deleted file mode 100644 index 7b1474c1b..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter11_63_4.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter11_76_3.png b/doc/LectureNotes/_build/jupyter_execute/chapter11_76_3.png deleted file mode 100644 index 40d7e8815..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter11_76_3.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter11_88_3.png b/doc/LectureNotes/_build/jupyter_execute/chapter11_88_3.png deleted file mode 100644 index 40d7e8815..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter11_88_3.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter11_88_4.png b/doc/LectureNotes/_build/jupyter_execute/chapter11_88_4.png deleted file mode 100644 index 0af57c0aa..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter11_88_4.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter1_11_0.png b/doc/LectureNotes/_build/jupyter_execute/chapter1_11_0.png index e28b79ded..737339781 100644 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter1_11_0.png and b/doc/LectureNotes/_build/jupyter_execute/chapter1_11_0.png differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter1_132_0.png b/doc/LectureNotes/_build/jupyter_execute/chapter1_132_0.png deleted file mode 100644 index 29a1bd652..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter1_132_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter1_136_0.png b/doc/LectureNotes/_build/jupyter_execute/chapter1_136_0.png index 29a1bd652..fafcc3b51 100644 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter1_136_0.png and b/doc/LectureNotes/_build/jupyter_execute/chapter1_136_0.png differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter1_13_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter1_13_1.png index cd3adcd7f..ad83fe026 100644 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter1_13_1.png and b/doc/LectureNotes/_build/jupyter_execute/chapter1_13_1.png differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter1_179_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter1_179_1.png deleted file mode 100644 index 25ef92e54..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter1_179_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter1_183_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter1_183_1.png index 0821feaf6..7569dc2be 100644 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter1_183_1.png and b/doc/LectureNotes/_build/jupyter_execute/chapter1_183_1.png differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter1_191_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter1_191_1.png deleted file mode 100644 index f19e88b16..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter1_191_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter1_193_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter1_193_1.png deleted file mode 100644 index 13fd31349..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter1_193_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter1_195_0.png b/doc/LectureNotes/_build/jupyter_execute/chapter1_195_0.png deleted file mode 100644 index dfe1e253c..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter1_195_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter1_199_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter1_199_1.png index f19e88b16..117c56859 100644 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter1_199_1.png and b/doc/LectureNotes/_build/jupyter_execute/chapter1_199_1.png differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter1_201_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter1_201_1.png index 13fd31349..ae4e0eca5 100644 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter1_201_1.png and b/doc/LectureNotes/_build/jupyter_execute/chapter1_201_1.png differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter1_202_0.png b/doc/LectureNotes/_build/jupyter_execute/chapter1_202_0.png deleted file mode 100644 index a3eac788b..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter1_202_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter1_203_0.png b/doc/LectureNotes/_build/jupyter_execute/chapter1_203_0.png index dfe1e253c..2b6455801 100644 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter1_203_0.png and b/doc/LectureNotes/_build/jupyter_execute/chapter1_203_0.png differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter1_210_0.png b/doc/LectureNotes/_build/jupyter_execute/chapter1_210_0.png index a3eac788b..e889447c1 100644 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter1_210_0.png and b/doc/LectureNotes/_build/jupyter_execute/chapter1_210_0.png differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter1_214_0.png b/doc/LectureNotes/_build/jupyter_execute/chapter1_214_0.png deleted file mode 100644 index cbac4fd70..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter1_214_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter1_218_0.png b/doc/LectureNotes/_build/jupyter_execute/chapter1_218_0.png index cbac4fd70..3bac81a35 100644 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter1_218_0.png and b/doc/LectureNotes/_build/jupyter_execute/chapter1_218_0.png differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter1_27_0.png b/doc/LectureNotes/_build/jupyter_execute/chapter1_27_0.png index 36f8fe801..4e8e8c8cb 100644 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter1_27_0.png and b/doc/LectureNotes/_build/jupyter_execute/chapter1_27_0.png differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter1_3_0.png b/doc/LectureNotes/_build/jupyter_execute/chapter1_3_0.png index fd690ccaa..90e45b8d0 100644 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter1_3_0.png and b/doc/LectureNotes/_build/jupyter_execute/chapter1_3_0.png differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter1_57_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter1_57_1.png index df30b2f1e..0d2f04887 100644 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter1_57_1.png and b/doc/LectureNotes/_build/jupyter_execute/chapter1_57_1.png differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter1_59_0.png b/doc/LectureNotes/_build/jupyter_execute/chapter1_59_0.png index 82b1758af..ef03a15ab 100644 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter1_59_0.png and b/doc/LectureNotes/_build/jupyter_execute/chapter1_59_0.png differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter1_61_10.png b/doc/LectureNotes/_build/jupyter_execute/chapter1_61_10.png deleted file mode 100644 index b9c53a9f4..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter1_61_10.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter1_61_11.png b/doc/LectureNotes/_build/jupyter_execute/chapter1_61_11.png deleted file mode 100644 index 916bfd378..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter1_61_11.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter1_61_12.png b/doc/LectureNotes/_build/jupyter_execute/chapter1_61_12.png deleted file mode 100644 index 4665b32d3..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter1_61_12.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter1_61_13.png b/doc/LectureNotes/_build/jupyter_execute/chapter1_61_13.png deleted file mode 100644 index 49ab6f13d..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter1_61_13.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter1_61_8.png b/doc/LectureNotes/_build/jupyter_execute/chapter1_61_8.png new file mode 100644 index 000000000..e609a3501 Binary files /dev/null and b/doc/LectureNotes/_build/jupyter_execute/chapter1_61_8.png differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter1_61_9.png b/doc/LectureNotes/_build/jupyter_execute/chapter1_61_9.png deleted file mode 100644 index b07e234e6..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter1_61_9.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter2.ipynb b/doc/LectureNotes/_build/jupyter_execute/chapter2.ipynb deleted file mode 100644 index e5bb8edc9..000000000 --- a/doc/LectureNotes/_build/jupyter_execute/chapter2.ipynb +++ /dev/null @@ -1,5189 +0,0 @@ -{ - "cells": [ - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "# Ridge and Lasso Regression\n", - "\n", - "\n", - "\n", - "## Mathematical Interpretation of Ordinary Least Squares\n", - "\n", - "What is presented here is a mathematical analysis of various regression algorithms (ordinary least squares, Ridge and Lasso Regression). The analysis is based on an important algorithm in linear algebra, the so-called Singular Value Decomposition (SVD). \n", - "\n", - "\n", - "We have shown that in ordinary least squares (OLS) the optimal parameters $\\beta$ are given by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\hat{\\boldsymbol{\\beta}}_{\\mathrm{OLS}} = \\left(\\boldsymbol{X}^T\\boldsymbol{X}\\right)^{-1}\\boldsymbol{X}^T\\boldsymbol{y}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The **hat** over $\\boldsymbol{\\beta}$ means we have the optimal parameters after minimization of the cost function.\n", - "\n", - "This means that our best model is defined as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\tilde{\\boldsymbol{y}}=\\boldsymbol{X}\\hat{\\boldsymbol{\\beta}} = \\boldsymbol{X}\\left(\\boldsymbol{X}^T\\boldsymbol{X}\\right)^{-1}\\boldsymbol{X}^T\\boldsymbol{y}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We now define a matrix" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{A}=\\boldsymbol{X}\\left(\\boldsymbol{X}^T\\boldsymbol{X}\\right)^{-1}\\boldsymbol{X}^T.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We can rewrite" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\tilde{\\boldsymbol{y}}=\\boldsymbol{X}\\hat{\\boldsymbol{\\beta}} = \\boldsymbol{A}\\boldsymbol{y}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The matrix $\\boldsymbol{A}$ has the important property that $\\boldsymbol{A}^2=\\boldsymbol{A}$. This is the definition of a [projection matrix](https://en.wikipedia.org/wiki/Projection_matrix).\n", - "We can then interpret our optimal model $\\tilde{\\boldsymbol{y}}$ as being represented by an orthogonal projection of $\\boldsymbol{y}$ onto a space defined by the column vectors of $\\boldsymbol{X}$. In our case here the matrix $\\boldsymbol{A}$ is a square matrix. If it is a general rectangular matrix we have an oblique projection matrix.\n", - "\n", - "\n", - "\n", - "\n", - "We have defined the residual error as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{\\epsilon}=\\boldsymbol{y}-\\tilde{\\boldsymbol{y}}=\\left[\\boldsymbol{I}-\\boldsymbol{X}\\left(\\boldsymbol{X}^T\\boldsymbol{X}\\right)^{-1}\\boldsymbol{X}^T\\right]\\boldsymbol{y}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The residual errors are then the projections of $\\boldsymbol{y}$ onto the orthogonal component of the space defined by the column vectors of $\\boldsymbol{X}$.\n", - "\n", - "\n", - "If the matrix $\\boldsymbol{X}$ is an orthogonal (or unitary in case of complex values) matrix, we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}^T\\boldsymbol{X}=\\boldsymbol{X}\\boldsymbol{X}^T = \\boldsymbol{I}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In this case the matrix $\\boldsymbol{A}$ becomes" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{A}=\\boldsymbol{X}\\left(\\boldsymbol{X}^T\\boldsymbol{X}\\right)^{-1}\\boldsymbol{X}^T)=\\boldsymbol{I},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and we have the obvious case" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{\\epsilon}=\\boldsymbol{y}-\\tilde{\\boldsymbol{y}}=0.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "This serves also as a useful test of our codes. \n", - "\n", - "\n", - "\n", - "\n", - "## The singular value decomposition\n", - "\n", - "\n", - "The examples we have looked at so far are cases where we normally can\n", - "invert the matrix $\\boldsymbol{X}^T\\boldsymbol{X}$. Using a polynomial expansion where we fit of various functions leads to\n", - "row vectors of the design matrix which are essentially orthogonal due\n", - "to the polynomial character of our model. Obtaining the inverse of the\n", - "design matrix is then often done via a so-called LU, QR or Cholesky\n", - "decomposition.\n", - "\n", - "\n", - "As we will also see in the first project, \n", - "this may\n", - "however not the be case in general and a standard matrix inversion\n", - "algorithm based on say LU, QR or Cholesky decomposition may lead to singularities. We will see examples of this below.\n", - "\n", - "There is however a way to circumvent this problem and also\n", - "gain some insights about the ordinary least squares approach, and\n", - "later shrinkage methods like Ridge and Lasso regressions.\n", - "\n", - "This is given by the **Singular Value Decomposition** (SVD) algorithm,\n", - "perhaps the most powerful linear algebra algorithm. The SVD provides\n", - "a numerically stable matrix decomposition that is used in a large\n", - "swath oc applications and the decomposition is always stable\n", - "numerically.\n", - "\n", - "In machine learning it plays a central role in dealing with for\n", - "example design matrices that may be near singular or singular.\n", - "Furthermore, as we will see here, the singular values can be related\n", - "to the covariance matrix (and thereby the correlation matrix) and in\n", - "turn the variance of a given quantity. It plays also an important role\n", - "in the principal component analysis where high-dimensional data can be\n", - "reduced to the statistically relevant features.\n", - "\n", - "\n", - "\n", - "\n", - "One of the typical problems we encounter with linear regression, in particular \n", - "when the matrix $\\boldsymbol{X}$ (our so-called design matrix) is high-dimensional, \n", - "are problems with near singular or singular matrices. The column vectors of $\\boldsymbol{X}$ \n", - "may be linearly dependent, normally referred to as super-collinearity. \n", - "This means that the matrix may be rank deficient and it is basically impossible to \n", - "to model the data using linear regression. As an example, consider the matrix" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{align*}\n", - "\\mathbf{X} & = \\left[\n", - "\\begin{array}{rrr}\n", - "1 & -1 & 2\n", - "\\\\\n", - "1 & 0 & 1\n", - "\\\\\n", - "1 & 2 & -1\n", - "\\\\\n", - "1 & 1 & 0\n", - "\\end{array} \\right]\n", - "\\end{align*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The columns of $\\boldsymbol{X}$ are linearly dependent. We see this easily since the \n", - "the first column is the row-wise sum of the other two columns. The rank (more correct,\n", - "the column rank) of a matrix is the dimension of the space spanned by the\n", - "column vectors. Hence, the rank of $\\mathbf{X}$ is equal to the number\n", - "of linearly independent columns. In this particular case the matrix has rank 2.\n", - "\n", - "Super-collinearity of an $(n \\times p)$-dimensional design matrix $\\mathbf{X}$ implies\n", - "that the inverse of the matrix $\\boldsymbol{X}^T\\boldsymbol{X}$ (the matrix we need to invert to solve the linear regression equations) is non-invertible. If we have a square matrix that does not have an inverse, we say this matrix singular. The example here demonstrates this" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{align*}\n", - "\\boldsymbol{X} & = \\left[\n", - "\\begin{array}{rr}\n", - "1 & -1\n", - "\\\\\n", - "1 & -1\n", - "\\end{array} \\right].\n", - "\\end{align*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We see easily that $\\mbox{det}(\\boldsymbol{X}) = x_{11} x_{22} - x_{12} x_{21} = 1 \\times (-1) - 1 \\times (-1) = 0$. Hence, $\\mathbf{X}$ is singular and its inverse is undefined.\n", - "This is equivalent to saying that the matrix $\\boldsymbol{X}$ has at least an eigenvalue which is zero.\n", - "\n", - "\n", - "\n", - "If our design matrix $\\boldsymbol{X}$ which enters the linear regression problem" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - "\\boldsymbol{\\beta} = (\\boldsymbol{X}^{T} \\boldsymbol{X})^{-1} \\boldsymbol{X}^{T} \\boldsymbol{y},\n", - "\\label{_auto1} \\tag{1}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "has linearly dependent column vectors, we will not be able to compute the inverse\n", - "of $\\boldsymbol{X}^T\\boldsymbol{X}$ and we cannot find the parameters (estimators) $\\beta_i$. \n", - "The estimators are only well-defined if $(\\boldsymbol{X}^{T}\\boldsymbol{X})^{-1}$ exits. \n", - "This is more likely to happen when the matrix $\\boldsymbol{X}$ is high-dimensional. In this case it is likely to encounter a situation where \n", - "the regression parameters $\\beta_i$ cannot be estimated.\n", - "\n", - "A cheap *ad hoc* approach is simply to add a small diagonal component to the matrix to invert, that is we change" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}^{T} \\boldsymbol{X} \\rightarrow \\boldsymbol{X}^{T} \\boldsymbol{X}+\\lambda \\boldsymbol{I},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $\\boldsymbol{I}$ is the identity matrix. When we discuss **Ridge** regression this is actually what we end up evaluating. The parameter $\\lambda$ is called a hyperparameter. More about this later. \n", - "\n", - "\n", - "\n", - "\n", - "## Basic math of the SVD\n", - "\n", - "\n", - "From standard linear algebra we know that a square matrix $\\boldsymbol{X}$ can be diagonalized if and only it is \n", - "a so-called [normal matrix](https://en.wikipedia.org/wiki/Normal_matrix), that is if $\\boldsymbol{X}\\in {\\mathbb{R}}^{n\\times n}$\n", - "we have $\\boldsymbol{X}\\boldsymbol{X}^T=\\boldsymbol{X}^T\\boldsymbol{X}$ or if $\\boldsymbol{X}\\in {\\mathbb{C}}^{n\\times n}$ we have $\\boldsymbol{X}\\boldsymbol{X}^{\\dagger}=\\boldsymbol{X}^{\\dagger}\\boldsymbol{X}$.\n", - "The matrix has then a set of eigenpairs" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "(\\lambda_1,\\boldsymbol{u}_1),\\dots, (\\lambda_n,\\boldsymbol{u}_n),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and the eigenvalues are given by the diagonal matrix" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{\\Sigma}=\\mathrm{Diag}(\\lambda_1, \\dots,\\lambda_n).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The matrix $\\boldsymbol{X}$ can be written in terms of an orthogonal/unitary transformation $\\boldsymbol{U}$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X} = \\boldsymbol{U}\\boldsymbol{\\Sigma}\\boldsymbol{V}^T,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with $\\boldsymbol{U}\\boldsymbol{U}^T=\\boldsymbol{I}$ or $\\boldsymbol{U}\\boldsymbol{U}^{\\dagger}=\\boldsymbol{I}$.\n", - "\n", - "Not all square matrices are diagonalizable. A matrix like the one discussed above" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X} = \\begin{bmatrix} \n", - "1& -1 \\\\\n", - "1& -1\\\\\n", - "\\end{bmatrix}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "is not diagonalizable, it is a so-called [defective matrix](https://en.wikipedia.org/wiki/Defective_matrix). It is easy to see that the condition\n", - "$\\boldsymbol{X}\\boldsymbol{X}^T=\\boldsymbol{X}^T\\boldsymbol{X}$ is not fulfilled. \n", - "\n", - "\n", - "\n", - "\n", - "\n", - "However, and this is the strength of the SVD algorithm, any general\n", - "matrix $\\boldsymbol{X}$ can be decomposed in terms of a diagonal matrix and\n", - "two orthogonal/unitary matrices. The [Singular Value Decompostion\n", - "(SVD) theorem](https://en.wikipedia.org/wiki/Singular_value_decomposition)\n", - "states that a general $m\\times n$ matrix $\\boldsymbol{X}$ can be written in\n", - "terms of a diagonal matrix $\\boldsymbol{\\Sigma}$ of dimensionality $m\\times n$\n", - "and two orthognal matrices $\\boldsymbol{U}$ and $\\boldsymbol{V}$, where the first has\n", - "dimensionality $m \\times m$ and the last dimensionality $n\\times n$.\n", - "We have then" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X} = \\boldsymbol{U}\\boldsymbol{\\Sigma}\\boldsymbol{V}^T\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "As an example, the above defective matrix can be decomposed as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X} = \\frac{1}{\\sqrt{2}}\\begin{bmatrix} 1& 1 \\\\ 1& -1\\\\ \\end{bmatrix} \\begin{bmatrix} 2& 0 \\\\ 0& 0\\\\ \\end{bmatrix} \\frac{1}{\\sqrt{2}}\\begin{bmatrix} 1& -1 \\\\ 1& 1\\\\ \\end{bmatrix}=\\boldsymbol{U}\\boldsymbol{\\Sigma}\\boldsymbol{V}^T,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with eigenvalues $\\sigma_1=2$ and $\\sigma_2=0$. \n", - "The SVD exits always! \n", - "\n", - "The SVD\n", - "decomposition (singular values) gives eigenvalues \n", - "$\\sigma_i\\geq\\sigma_{i+1}$ for all $i$ and for dimensions larger than $i=p$, the\n", - "eigenvalues (singular values) are zero.\n", - "\n", - "In the general case, where our design matrix $\\boldsymbol{X}$ has dimension\n", - "$n\\times p$, the matrix is thus decomposed into an $n\\times n$\n", - "orthogonal matrix $\\boldsymbol{U}$, a $p\\times p$ orthogonal matrix $\\boldsymbol{V}$\n", - "and a diagonal matrix $\\boldsymbol{\\Sigma}$ with $r=\\mathrm{min}(n,p)$\n", - "singular values $\\sigma_i\\geq 0$ on the main diagonal and zeros filling\n", - "the rest of the matrix. There are at most $p$ singular values\n", - "assuming that $n > p$. In our regression examples for the nuclear\n", - "masses and the equation of state this is indeed the case, while for\n", - "the Ising model we have $p > n$. These are often cases that lead to\n", - "near singular or singular matrices.\n", - "\n", - "The columns of $\\boldsymbol{U}$ are called the left singular vectors while the columns of $\\boldsymbol{V}$ are the right singular vectors.\n", - "\n", - "\n", - "If we assume that $n > p$, then our matrix $\\boldsymbol{U}$ has dimension $n\n", - "\\times n$. The last $n-p$ columns of $\\boldsymbol{U}$ become however\n", - "irrelevant in our calculations since they are multiplied with the\n", - "zeros in $\\boldsymbol{\\Sigma}$.\n", - "\n", - "The economy-size decomposition removes extra rows or columns of zeros\n", - "from the diagonal matrix of singular values, $\\boldsymbol{\\Sigma}$, along with the columns\n", - "in either $\\boldsymbol{U}$ or $\\boldsymbol{V}$ that multiply those zeros in the expression. \n", - "Removing these zeros and columns can improve execution time\n", - "and reduce storage requirements without compromising the accuracy of\n", - "the decomposition.\n", - "\n", - "If $n > p$, we keep only the first $p$ columns of $\\boldsymbol{U}$ and $\\boldsymbol{\\Sigma}$ has dimension $p\\times p$. \n", - "If $p > n$, then only the first $n$ columns of $\\boldsymbol{V}$ are computed and $\\boldsymbol{\\Sigma}$ has dimension $n\\times n$.\n", - "The $n=p$ case is obvious, we retain the full SVD. \n", - "In general the economy-size SVD leads to less FLOPS and still conserving the desired accuracy.\n", - "\n", - "## Codes for the SVD" - ] - }, - { - "cell_type": "code", - "execution_count": 1, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "[[ 1. -1.]\n", - " [ 1. -1.]]\n", - "test U\n", - "[[0. 0.]\n", - " [0. 0.]]\n", - "test VT\n", - "[[0. 0.]\n", - " [0. 0.]]\n", - "[[-0.70710678 -0.70710678]\n", - " [-0.70710678 0.70710678]]\n", - "[2. 0.]\n", - "[[-0.70710678 0.70710678]\n", - " [ 0.70710678 0.70710678]]\n", - "[[-3.33066907e-16 4.44089210e-16]\n", - " [ 0.00000000e+00 2.22044605e-16]]\n" - ] - } - ], - "source": [ - "import numpy as np\n", - "# SVD inversion\n", - "def SVD(A):\n", - " ''' Takes as input a numpy matrix A and returns inv(A) based on singular value decomposition (SVD).\n", - " SVD is numerically more stable than the inversion algorithms provided by\n", - " numpy and scipy.linalg at the cost of being slower.\n", - " '''\n", - " U, S, VT = np.linalg.svd(A,full_matrices=True)\n", - " print('test U')\n", - " print( (np.transpose(U) @ U - U @np.transpose(U)))\n", - " print('test VT')\n", - " print( (np.transpose(VT) @ VT - VT @np.transpose(VT)))\n", - " print(U)\n", - " print(S)\n", - " print(VT)\n", - "\n", - " D = np.zeros((len(U),len(VT)))\n", - " for i in range(0,len(VT)):\n", - " D[i,i]=S[i]\n", - " return U @ D @ VT\n", - "\n", - "\n", - "X = np.array([ [1.0,-1.0], [1.0,-1.0]])\n", - "#X = np.array([[1, 2], [3, 4], [5, 6]])\n", - "\n", - "print(X)\n", - "C = SVD(X)\n", - "# Print the difference between the original matrix and the SVD one\n", - "print(C-X)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The matrix $\\boldsymbol{X}$ has columns that are linearly dependent. The first\n", - "column is the row-wise sum of the other two columns. The rank of a\n", - "matrix (the column rank) is the dimension of space spanned by the\n", - "column vectors. The rank of the matrix is the number of linearly\n", - "independent columns, in this case just $2$. We see this from the\n", - "singular values when running the above code. Running the standard\n", - "inversion algorithm for matrix inversion with $\\boldsymbol{X}^T\\boldsymbol{X}$ results\n", - "in the program terminating due to a singular matrix.\n", - "\n", - "\n", - "\n", - "The $U$, $S$, and $V$ matrices returned from the **svd()** function\n", - "cannot be multiplied directly.\n", - "\n", - "As you can see from the code, the $S$ vector must be converted into a\n", - "diagonal matrix. This may cause a problem as the size of the matrices\n", - "do not fit the rules of matrix multiplication, where the number of\n", - "columns in a matrix must match the number of rows in the subsequent\n", - "matrix.\n", - "\n", - "If you wish to include the zero singular values, you will need to\n", - "resize the matrices and set up a diagonal matrix as done in the above\n", - "example\n", - "\n", - "\n", - "## Code for SVD and Inversion of Matrices\n", - "\n", - "How do we use the SVD to invert a matrix $\\boldsymbol{X}^T\\boldsymbol{X}$ which is singular or near singular?\n", - "The simple answer is to use the linear algebra function for the pseudoinverse, that is" - ] - }, - { - "cell_type": "code", - "execution_count": 2, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "#Ainv = np.linlag.pinv(A)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Let us first look at a matrix which does not causes problems and write our own function where we just use the SVD." - ] - }, - { - "cell_type": "code", - "execution_count": 3, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "[[1 2 3]\n", - " [2 4 5]\n", - " [3 5 6]]\n", - "test U\n", - "[[ 2.22044605e-16 -7.77156117e-16 -5.55111512e-16]\n", - " [-7.77156117e-16 0.00000000e+00 -1.11022302e-16]\n", - " [-5.55111512e-16 -1.11022302e-16 0.00000000e+00]]\n", - "test VT\n", - "[[ 1.11022302e-16 -2.22044605e-16 1.38777878e-16]\n", - " [-2.22044605e-16 -1.11022302e-16 -1.11022302e-16]\n", - " [ 1.38777878e-16 -1.11022302e-16 0.00000000e+00]]\n", - "[[0. 0. 0.]\n", - " [0. 0. 0.]\n", - " [0. 0. 0.]]\n" - ] - } - ], - "source": [ - "import numpy as np\n", - "# SVD inversion\n", - "def SVDinv(A):\n", - " ''' Takes as input a numpy matrix A and returns inv(A) based on singular value decomposition (SVD).\n", - " SVD is numerically more stable than the inversion algorithms provided by\n", - " numpy and scipy.linalg at the cost of being slower.\n", - " '''\n", - " U, s, VT = np.linalg.svd(A)\n", - " print('test U')\n", - " print( (np.transpose(U) @ U - U @np.transpose(U)))\n", - " print('test VT')\n", - " print( (np.transpose(VT) @ VT - VT @np.transpose(VT)))\n", - "\n", - "\n", - " D = np.zeros((len(U),len(VT)))\n", - " D = np.diag(s)\n", - " UT = np.transpose(U); V = np.transpose(VT); invD = np.linalg.inv(D)\n", - " return np.matmul(V,np.matmul(invD,UT))\n", - "\n", - "\n", - "#X = np.array([ [1.0, -1.0, 2.0], [1.0, 0.0, 1.0], [1.0, 2.0, -1.0], [1.0, 1.0, 0.0] ])\n", - "# Non-singular square matrix\n", - "X = np.array( [ [1,2,3],[2,4,5],[3,5,6]])\n", - "print(X)\n", - "A = np.transpose(X) @ X\n", - "# Brute force inversion\n", - "B = np.linalg.pinv(A) # here we could use np.linalg.inv(A), try it!\n", - "C = SVDinv(A)\n", - "print(np.abs(B-C))" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Although our matrix to invert $\\boldsymbol{X}^T\\boldsymbol{X}$ is a square matrix, our matrix may be singular. \n", - "\n", - "The pseudoinverse is the generalization of the matrix inverse for square matrices to\n", - "rectangular matrices where the number of rows and columns are not equal.\n", - "\n", - "It is also called the the Moore-Penrose Inverse after two independent discoverers of the method or the Generalized Inverse.\n", - "It is used for the calculation of the inverse for singular or near singular matrices and for rectangular matrices.\n", - "\n", - "Using the SVD we can obtain the pseudoinverse of a matrix $\\boldsymbol{A}$ (labeled here as $\\boldsymbol{A}_{\\mathrm{PI}}$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{A}_{\\mathrm{PI}}= \\boldsymbol{V}\\boldsymbol{D}_{\\mathrm{PI}}\\boldsymbol{U}^T,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $\\boldsymbol{D}_{\\mathrm{PI}}$ can be calculated by creating a diagonal matrix from $\\boldsymbol{Sigma}$ where we only keep the singular values (the non-zero values). The following code computes the pseudoinvers of the matrix based on the SVD." - ] - }, - { - "cell_type": "code", - "execution_count": 4, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "[[0.3 0.4]\n", - " [0.5 0.6]\n", - " [0.7 0.8]\n", - " [0.9 1. ]]\n", - "[[-13. -6. 1. 8. ]\n", - " [ 11.5 5.5 -0.5 -6.5]]\n", - "[[0. 0. 0. 0.]\n", - " [0. 0. 0. 0.]]\n" - ] - } - ], - "source": [ - "import numpy as np\n", - "# SVD inversion\n", - "def SVDinv(A):\n", - " U, s, VT = np.linalg.svd(A)\n", - " # reciprocals of singular values of s\n", - " d = 1.0 / s\n", - " # create m x n D matrix\n", - " D = np.zeros(A.shape)\n", - " # populate D with n x n diagonal matrix\n", - " D[:A.shape[1], :A.shape[1]] = np.diag(d)\n", - " UT = np.transpose(U)\n", - " V = np.transpose(VT)\n", - " return np.matmul(V,np.matmul(D.T,UT))\n", - "\n", - "\n", - "A = np.array([ [0.3, 0.4], [0.5, 0.6], [0.7, 0.8],[0.9, 1.0]])\n", - "print(A)\n", - "# Brute force inversion of super-collinear matrix\n", - "B = np.linalg.pinv(A)\n", - "print(B)\n", - "# Compare our own algorithm with pinv\n", - "C = SVDinv(A)\n", - "print(np.abs(C-B))" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "As you can see from these examples, our own decomposition based on the SVD agrees the pseudoinverse algorithm provided by **Numpy**.\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "## Mathematics of the SVD and implications\n", - "\n", - "Let us take a closer look at the mathematics of the SVD and the various implications for machine learning studies.\n", - "\n", - "Our starting point is our design matrix $\\boldsymbol{X}$ of dimension $n\\times p$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}=\\begin{bmatrix}\n", - "x_{0,0} & x_{0,1} & x_{0,2}& \\dots & \\dots x_{0,p-1}\\\\\n", - "x_{1,0} & x_{1,1} & x_{1,2}& \\dots & \\dots x_{1,p-1}\\\\\n", - "x_{2,0} & x_{2,1} & x_{2,2}& \\dots & \\dots x_{2,p-1}\\\\\n", - "\\dots & \\dots & \\dots & \\dots \\dots & \\dots \\\\\n", - "x_{n-2,0} & x_{n-2,1} & x_{n-2,2}& \\dots & \\dots x_{n-2,p-1}\\\\\n", - "x_{n-1,0} & x_{n-1,1} & x_{n-1,2}& \\dots & \\dots x_{n-1,p-1}\\\\\n", - "\\end{bmatrix}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We can SVD decompose our matrix as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}=\\boldsymbol{U}\\boldsymbol{\\Sigma}\\boldsymbol{V}^T,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $\\boldsymbol{U}$ is an orthogonal matrix of dimension $n\\times n$, meaning that $\\boldsymbol{U}\\boldsymbol{U}^T=\\boldsymbol{U}^T\\boldsymbol{U}=\\boldsymbol{I}_n$. Here $\\boldsymbol{I}_n$ is the unit matrix of dimension $n \\times n$.\n", - "\n", - "Similarly, $\\boldsymbol{V}$ is an orthogonal matrix of dimension $p\\times p$, meaning that $\\boldsymbol{V}\\boldsymbol{V}^T=\\boldsymbol{V}^T\\boldsymbol{V}=\\boldsymbol{I}_p$. Here $\\boldsymbol{I}_n$ is the unit matrix of dimension $p \\times p$.\n", - "\n", - "Finally $\\boldsymbol{\\Sigma}$ contains the singular values $\\sigma_i$. This matrix has dimension $n\\times p$ and the singular values $\\sigma_i$ are all positive. The non-zero values are ordered in descending order, that is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\sigma_0 > \\sigma_1 > \\sigma_2 > \\dots > \\sigma_{p-1} > 0.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "All values beyond $p-1$ are all zero.\n", - "\n", - "\n", - "As an example, consider the following $3\\times 2$ example for the matrix $\\boldsymbol{\\Sigma}$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{\\Sigma}=\n", - "\\begin{bmatrix}\n", - "2& 0 \\\\\n", - "0 & 1 \\\\\n", - "0 & 0 \\\\\n", - "\\end{bmatrix}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The singular values are $\\sigma_0=2$ and $\\sigma_1=1$. It is common to rewrite the matrix $\\boldsymbol{\\Sigma}$ as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{\\Sigma}=\n", - "\\begin{bmatrix}\n", - "\\boldsymbol{\\tilde{\\Sigma}}\\\\\n", - "\\boldsymbol{0}\\\\\n", - "\\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{\\tilde{\\Sigma}}=\n", - "\\begin{bmatrix}\n", - "2& 0 \\\\\n", - "0 & 1 \\\\\n", - "\\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "contains only the singular values. Note also (and we will use this below) that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{\\Sigma}^T\\boldsymbol{\\Sigma}=\n", - "\\begin{bmatrix}\n", - "4& 0 \\\\\n", - "0 & 1 \\\\\n", - "\\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which is a $2\\times 2 $ matrix while" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{\\Sigma}\\boldsymbol{\\Sigma}^T=\n", - "\\begin{bmatrix}\n", - "4& 0 & 0\\\\\n", - "0 & 1 & 0\\\\\n", - "0 & 0 & 0\\\\\n", - "\\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "is a $3\\times 3 $ matrix. The last row and column of this last matrix\n", - "contain only zeros. This will have important consequences for our SVD\n", - "decomposition of the design matrix.\n", - "\n", - "\n", - "\n", - "The matrix that may cause problems for us is $\\boldsymbol{X}^T\\boldsymbol{X}$. Using the SVD we can rewrite this matrix as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}^T\\boldsymbol{X}=\\boldsymbol{V}\\boldsymbol{\\Sigma}^T\\boldsymbol{U}^T\\boldsymbol{U}\\boldsymbol{\\Sigma}\\boldsymbol{V}^T,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and using the orthogonality of the matrix $\\boldsymbol{U}$ we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}^T\\boldsymbol{X}=\\boldsymbol{V}\\boldsymbol{\\Sigma}^T\\boldsymbol{\\Sigma}\\boldsymbol{V}^T.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We define $\\boldsymbol{\\Sigma}^T\\boldsymbol{\\Sigma}=\\tilde{\\boldsymbol{\\Sigma}}^2$ which is a diagonal matrix containing only the singular values squared. It has dimensionality $p \\times p$.\n", - "\n", - "This means, using the orthogonality of $\\boldsymbol{V}$, that we get" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}^T\\boldsymbol{X}=\\tilde{\\boldsymbol{\\Sigma}}^2.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We can now insert the result for the matrix $\\boldsymbol{X}^T\\boldsymbol{X}$ into our equation for ordinary least squares where" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\tilde{y}_{\\mathrm{OLS}}=\\boldsymbol{X}\\left(\\boldsymbol{X}^T\\boldsymbol{X}\\right)^{-1}\\boldsymbol{X}^T\\boldsymbol{y},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and using our SVD decomposition of $\\boldsymbol{X}$ we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\tilde{y}_{\\mathrm{OLS}}=\\boldsymbol{U}\\boldsymbol{\\Sigma}\\boldsymbol{V}^T\\tilde{\\boldsymbol{\\Sigma}}^{-2}\\boldsymbol{V}\\boldsymbol{\\Sigma}^T\\boldsymbol{U}^T\\boldsymbol{y},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which gives us, using the orthogonality of the matrices $\\boldsymbol{U}$ and $\\boldsymbol{V}$," - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\tilde{y}_{\\mathrm{OLS}}=\\boldsymbol{U}\\boldsymbol{U}^T\\boldsymbol{y}=\\sum_{i=0}^{p-1}\\boldsymbol{u}_i\\boldsymbol{u}^T_j\\boldsymbol{y},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Note here that when we perform the multiplication of the various matrices, the orthogonal vectors of the matrix $\\boldsymbol{U}$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{U}=[\\boldsymbol{u}_0,\\boldsymbol{u}_1,\\dots,\\boldsymbol{u}_{n-1}],\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "that belong to $i>p-1$, result in only zeros when we perform the multiplications. This means that the sum above has non-zero elements only up to $i=p-1$. This corresponds also to the number of singular values (these are all non-zero).\n", - "\n", - "It means that the ordinary least square model (with the optimal parameters) $\\boldsymbol{\\tilde{y}}$, corresponds to an orthogonal transformation of the output (or target) vector $\\boldsymbol{y}$ by the vectors of the matrix $\\boldsymbol{U}$.\n", - "\n", - "\n", - "## Further properties (important for our analyses later)\n", - "\n", - "Let us study again $\\boldsymbol{X}^T\\boldsymbol{X}$ in terms of our SVD," - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}^T\\boldsymbol{X}=\\boldsymbol{V}\\boldsymbol{\\Sigma}^T\\boldsymbol{U}^T\\boldsymbol{U}\\boldsymbol{\\Sigma}\\boldsymbol{V}^T=\\boldsymbol{V}\\boldsymbol{\\Sigma}^T\\boldsymbol{\\Sigma}\\boldsymbol{V}^T.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "If we now multiply from the right with $\\boldsymbol{V}$ (using the orthogonality of $\\boldsymbol{V}$) we get" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\left(\\boldsymbol{X}^T\\boldsymbol{X}\\right)\\boldsymbol{V}=\\boldsymbol{V}\\boldsymbol{\\Sigma}^T\\boldsymbol{\\Sigma}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "This means the vectors $\\boldsymbol{v}_i$ of the orthogonal matrix $\\boldsymbol{V}$ are the eigenvectors of the matrix $\\boldsymbol{X}^T\\boldsymbol{X}$\n", - "with eigenvalues given by the singular values squared, that is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\left(\\boldsymbol{X}^T\\boldsymbol{X}\\right)\\boldsymbol{v}_i=\\boldsymbol{v}_i\\sigma_i^2.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Similarly, if we use the SVD decomposition for the matrix $\\boldsymbol{X}\\boldsymbol{X}^T$, we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}\\boldsymbol{X}^T=\\boldsymbol{U}\\boldsymbol{\\Sigma}\\boldsymbol{V}^T\\boldsymbol{V}\\boldsymbol{\\Sigma}^T\\boldsymbol{U}^T=\\boldsymbol{U}\\boldsymbol{\\Sigma}\\boldsymbol{\\Sigma}^T\\boldsymbol{U}^T.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "If we now multiply from the right with $\\boldsymbol{U}$ (using the orthogonality of $\\boldsymbol{U}$) we get" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\left(\\boldsymbol{X}\\boldsymbol{X}^T\\right)\\boldsymbol{U}=\\boldsymbol{U}\\boldsymbol{\\Sigma}\\boldsymbol{\\Sigma}^T.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "This means the vectors $\\boldsymbol{u}_i$ of the orthogonal matrix $\\boldsymbol{U}$ are the eigenvectors of the matrix $\\boldsymbol{X}\\boldsymbol{X}^T$\n", - "with eigenvalues given by the singular values squared, that is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\left(\\boldsymbol{X}\\boldsymbol{X}^T\\right)\\boldsymbol{u}_i=\\boldsymbol{u}_i\\sigma_i^2.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "**Important note**: we have defined our design matrix $\\boldsymbol{X}$ to be an\n", - "$n\\times p$ matrix. In most supervised learning cases we have that $n\n", - "\\ge p$, and quite often we have $n >> p$. For linear algebra based methods like ordinary least squares or Ridge regression, this leads to a matrix $\\boldsymbol{X}^T\\boldsymbol{X}$ which is small and thereby easier to handle from a computational point of view (in terms of number of floating point operations).\n", - "\n", - "In our lectures, the number of columns will\n", - "always refer to the number of features in our data set, while the\n", - "number of rows represents the number of data inputs. Note that in\n", - "other texts you may find the opposite notation. This has consequences\n", - "for the definition of for example the covariance matrix and its relation to the SVD.\n", - "\n", - "\n", - "## Meet the Covariance Matrix\n", - "\n", - "\n", - "Before we move on to a discussion of Ridge and Lasso regression, we want to show an important example of the above.\n", - "\n", - "We have already noted that the matrix $\\boldsymbol{X}^T\\boldsymbol{X}$ in ordinary\n", - "least squares is proportional to the second derivative of the cost\n", - "function, that is we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial^2 C(\\boldsymbol{\\beta})}{\\partial \\boldsymbol{\\beta}^T\\partial \\boldsymbol{\\beta}} =\\frac{2}{n}\\boldsymbol{X}^T\\boldsymbol{X}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "This quantity defines was what is called the Hessian matrix (the second derivative of a function we want to optimize).\n", - "\n", - "The Hessian matrix plays an important role and is defined in this course as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{H}=\\boldsymbol{X}^T\\boldsymbol{X}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The Hessian matrix for ordinary least squares is also proportional to\n", - "the covariance matrix. This means also that we can use the SVD to find\n", - "the eigenvalues of the covariance matrix and the Hessian matrix in\n", - "terms of the singular values. Let us develop these arguments, as they will play an important role in our machine learning studies.\n", - "\n", - "\n", - "\n", - "Before we discuss the link between for example Ridge regression and the singular value decomposition, we need to remind ourselves about\n", - "the definition of the covariance and the correlation function. These are quantities that play a central role in machine learning methods.\n", - "\n", - "Suppose we have defined two vectors\n", - "$\\hat{x}$ and $\\hat{y}$ with $n$ elements each. The covariance matrix $\\boldsymbol{C}$ is defined as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{C}[\\boldsymbol{x},\\boldsymbol{y}] = \\begin{bmatrix} \\mathrm{cov}[\\boldsymbol{x},\\boldsymbol{x}] & \\mathrm{cov}[\\boldsymbol{x},\\boldsymbol{y}] \\\\\n", - " \\mathrm{cov}[\\boldsymbol{y},\\boldsymbol{x}] & \\mathrm{cov}[\\boldsymbol{y},\\boldsymbol{y}] \\\\\n", - " \\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where for example" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathrm{cov}[\\boldsymbol{x},\\boldsymbol{y}] =\\frac{1}{n} \\sum_{i=0}^{n-1}(x_i- \\overline{x})(y_i- \\overline{y}).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "With this definition and recalling that the variance is defined as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathrm{var}[\\boldsymbol{x}]=\\frac{1}{n} \\sum_{i=0}^{n-1}(x_i- \\overline{x})^2,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "we can rewrite the covariance matrix as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{C}[\\boldsymbol{x},\\boldsymbol{y}] = \\begin{bmatrix} \\mathrm{var}[\\boldsymbol{x}] & \\mathrm{cov}[\\boldsymbol{x},\\boldsymbol{y}] \\\\\n", - " \\mathrm{cov}[\\boldsymbol{x},\\boldsymbol{y}] & \\mathrm{var}[\\boldsymbol{y}] \\\\\n", - " \\end{bmatrix}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "**Note:** we have used $1/n$ in the above definitions of the *sample* variance and covariance. We assume then that we can calculate the exact mean value. \n", - "What you will find in essentially all statistics texts are equations\n", - "with a factor $1/(n-1)$. This is called [Bessel's correction](https://mathworld.wolfram.com/BesselsCorrection.html). This\n", - "method corrects the bias in the estimation of the population variance\n", - "and covariance. It also partially corrects the bias in the estimation\n", - "of the population standard deviation. If you use a library like\n", - "**Scikit-Learn** or **nunmpy's** function calculate the covariance, this\n", - "quantity will be computed with a factor $1/(n-1)$.\n", - "\n", - "\n", - "The covariance takes values between zero and infinity and may thus\n", - "lead to problems with loss of numerical precision for particularly\n", - "large values. It is common to scale the covariance matrix by\n", - "introducing instead the correlation matrix defined via the so-called\n", - "correlation function" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathrm{corr}[\\boldsymbol{x},\\boldsymbol{y}]=\\frac{\\mathrm{cov}[\\boldsymbol{x},\\boldsymbol{y}]}{\\sqrt{\\mathrm{var}[\\boldsymbol{x}] \\mathrm{var}[\\boldsymbol{y}]}}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The correlation function is then given by values $\\mathrm{corr}[\\boldsymbol{x},\\boldsymbol{y}]\n", - "\\in [-1,1]$. This avoids eventual problems with too large values. We\n", - "can then define the correlation matrix for the two vectors $\\boldsymbol{x}$\n", - "and $\\boldsymbol{y}$ as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{K}[\\boldsymbol{x},\\boldsymbol{y}] = \\begin{bmatrix} 1 & \\mathrm{corr}[\\boldsymbol{x},\\boldsymbol{y}] \\\\\n", - " \\mathrm{corr}[\\boldsymbol{y},\\boldsymbol{x}] & 1 \\\\\n", - " \\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In the above example this is the function we constructed using **pandas**.\n", - "\n", - "\n", - "\n", - "In our derivation of the various regression algorithms like **Ordinary Least Squares** or **Ridge regression**\n", - "we defined the design/feature matrix $\\boldsymbol{X}$ as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}=\\begin{bmatrix}\n", - "x_{0,0} & x_{0,1} & x_{0,2}& \\dots & \\dots x_{0,p-1}\\\\\n", - "x_{1,0} & x_{1,1} & x_{1,2}& \\dots & \\dots x_{1,p-1}\\\\\n", - "x_{2,0} & x_{2,1} & x_{2,2}& \\dots & \\dots x_{2,p-1}\\\\\n", - "\\dots & \\dots & \\dots & \\dots \\dots & \\dots \\\\\n", - "x_{n-2,0} & x_{n-2,1} & x_{n-2,2}& \\dots & \\dots x_{n-2,p-1}\\\\\n", - "x_{n-1,0} & x_{n-1,1} & x_{n-1,2}& \\dots & \\dots x_{n-1,p-1}\\\\\n", - "\\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with $\\boldsymbol{X}\\in {\\mathbb{R}}^{n\\times p}$, with the predictors/features $p$ refering to the column numbers and the\n", - "entries $n$ being the row elements.\n", - "We can rewrite the design/feature matrix in terms of its column vectors as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}=\\begin{bmatrix} \\boldsymbol{x}_0 & \\boldsymbol{x}_1 & \\boldsymbol{x}_2 & \\dots & \\dots & \\boldsymbol{x}_{p-1}\\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with a given vector" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{x}_i^T = \\begin{bmatrix}x_{0,i} & x_{1,i} & x_{2,i}& \\dots & \\dots x_{n-1,i}\\end{bmatrix}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "With these definitions, we can now rewrite our $2\\times 2$\n", - "correlation/covariance matrix in terms of a moe general design/feature\n", - "matrix $\\boldsymbol{X}\\in {\\mathbb{R}}^{n\\times p}$. This leads to a $p\\times p$\n", - "covariance matrix for the vectors $\\boldsymbol{x}_i$ with $i=0,1,\\dots,p-1$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{C}[\\boldsymbol{x}] = \\begin{bmatrix}\n", - "\\mathrm{var}[\\boldsymbol{x}_0] & \\mathrm{cov}[\\boldsymbol{x}_0,\\boldsymbol{x}_1] & \\mathrm{cov}[\\boldsymbol{x}_0,\\boldsymbol{x}_2] & \\dots & \\dots & \\mathrm{cov}[\\boldsymbol{x}_0,\\boldsymbol{x}_{p-1}]\\\\\n", - "\\mathrm{cov}[\\boldsymbol{x}_1,\\boldsymbol{x}_0] & \\mathrm{var}[\\boldsymbol{x}_1] & \\mathrm{cov}[\\boldsymbol{x}_1,\\boldsymbol{x}_2] & \\dots & \\dots & \\mathrm{cov}[\\boldsymbol{x}_1,\\boldsymbol{x}_{p-1}]\\\\\n", - "\\mathrm{cov}[\\boldsymbol{x}_2,\\boldsymbol{x}_0] & \\mathrm{cov}[\\boldsymbol{x}_2,\\boldsymbol{x}_1] & \\mathrm{var}[\\boldsymbol{x}_2] & \\dots & \\dots & \\mathrm{cov}[\\boldsymbol{x}_2,\\boldsymbol{x}_{p-1}]\\\\\n", - "\\dots & \\dots & \\dots & \\dots & \\dots & \\dots \\\\\n", - "\\dots & \\dots & \\dots & \\dots & \\dots & \\dots \\\\\n", - "\\mathrm{cov}[\\boldsymbol{x}_{p-1},\\boldsymbol{x}_0] & \\mathrm{cov}[\\boldsymbol{x}_{p-1},\\boldsymbol{x}_1] & \\mathrm{cov}[\\boldsymbol{x}_{p-1},\\boldsymbol{x}_{2}] & \\dots & \\dots & \\mathrm{var}[\\boldsymbol{x}_{p-1}]\\\\\n", - "\\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and the correlation matrix" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{K}[\\boldsymbol{x}] = \\begin{bmatrix}\n", - "1 & \\mathrm{corr}[\\boldsymbol{x}_0,\\boldsymbol{x}_1] & \\mathrm{corr}[\\boldsymbol{x}_0,\\boldsymbol{x}_2] & \\dots & \\dots & \\mathrm{corr}[\\boldsymbol{x}_0,\\boldsymbol{x}_{p-1}]\\\\\n", - "\\mathrm{corr}[\\boldsymbol{x}_1,\\boldsymbol{x}_0] & 1 & \\mathrm{corr}[\\boldsymbol{x}_1,\\boldsymbol{x}_2] & \\dots & \\dots & \\mathrm{corr}[\\boldsymbol{x}_1,\\boldsymbol{x}_{p-1}]\\\\\n", - "\\mathrm{corr}[\\boldsymbol{x}_2,\\boldsymbol{x}_0] & \\mathrm{corr}[\\boldsymbol{x}_2,\\boldsymbol{x}_1] & 1 & \\dots & \\dots & \\mathrm{corr}[\\boldsymbol{x}_2,\\boldsymbol{x}_{p-1}]\\\\\n", - "\\dots & \\dots & \\dots & \\dots & \\dots & \\dots \\\\\n", - "\\dots & \\dots & \\dots & \\dots & \\dots & \\dots \\\\\n", - "\\mathrm{corr}[\\boldsymbol{x}_{p-1},\\boldsymbol{x}_0] & \\mathrm{corr}[\\boldsymbol{x}_{p-1},\\boldsymbol{x}_1] & \\mathrm{corr}[\\boldsymbol{x}_{p-1},\\boldsymbol{x}_{2}] & \\dots & \\dots & 1\\\\\n", - "\\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The Numpy function **np.cov** calculates the covariance elements using\n", - "the factor $1/(n-1)$ instead of $1/n$ since it assumes we do not have\n", - "the exact mean values. The following simple function uses the\n", - "**np.vstack** function which takes each vector of dimension $1\\times n$\n", - "and produces a $2\\times n$ matrix $\\boldsymbol{W}$\n", - "\n", - "Note that this assumes you have the features as the rows, and the inputs as columns, that is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{W} = \\begin{bmatrix} x_0 & x_1 & x_2 & \\dots & x_{n-2} & x_{n-1} \\\\\n", - " y_0 & y_1 & y_2 & \\dots & y_{n-2} & y_{n-1} \\\\\n", - " \\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which in turn is converted into into the $2\\times 2$ covariance matrix\n", - "$\\boldsymbol{C}$ via the Numpy function **np.cov()**. We note that we can also calculate\n", - "the mean value of each set of samples $\\boldsymbol{x}$ etc using the Numpy\n", - "function **np.mean(x)**. We can also extract the eigenvalues of the\n", - "covariance matrix through the **np.linalg.eig()** function." - ] - }, - { - "cell_type": "code", - "execution_count": 5, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "0.0119839668275544\n", - "3.9026821944532157\n", - "[[ 1.21805483 3.6417002 ]\n", - " [ 3.6417002 11.67950066]]\n" - ] - } - ], - "source": [ - "# Importing various packages\n", - "import numpy as np\n", - "n = 100\n", - "x = np.random.normal(size=n)\n", - "print(np.mean(x))\n", - "y = 4+3*x+np.random.normal(size=n)\n", - "print(np.mean(y))\n", - "W = np.vstack((x, y))\n", - "C = np.cov(W)\n", - "print(C)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The previous example can be converted into the correlation matrix by\n", - "simply scaling the matrix elements with the variances. We should also\n", - "subtract the mean values for each column. This leads to the following\n", - "code which sets up the correlations matrix for the previous example in\n", - "a more brute force way. Here we scale the mean values for each column of the design matrix, calculate the relevant mean values and variances and then finally set up the $2\\times 2$ correlation matrix (since we have only two vectors)." - ] - }, - { - "cell_type": "code", - "execution_count": 6, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "0.08283349271892\n", - "1.6319972672199556\n", - "[[1. 0.65062105]\n", - " [0.65062105 1. ]]\n" - ] - } - ], - "source": [ - "import numpy as np\n", - "n = 100\n", - "# define two vectors \n", - "x = np.random.random(size=n)\n", - "y = 4+3*x+np.random.normal(size=n)\n", - "#scaling the x and y vectors \n", - "x = x - np.mean(x)\n", - "y = y - np.mean(y)\n", - "variance_x = np.sum(x@x)/n\n", - "variance_y = np.sum(y@y)/n\n", - "print(variance_x)\n", - "print(variance_y)\n", - "cov_xy = np.sum(x@y)/n\n", - "cov_xx = np.sum(x@x)/n\n", - "cov_yy = np.sum(y@y)/n\n", - "C = np.zeros((2,2))\n", - "C[0,0]= cov_xx/variance_x\n", - "C[1,1]= cov_yy/variance_y\n", - "C[0,1]= cov_xy/np.sqrt(variance_y*variance_x)\n", - "C[1,0]= C[0,1]\n", - "print(C)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We see that the matrix elements along the diagonal are one as they\n", - "should be and that the matrix is symmetric. Furthermore, diagonalizing\n", - "this matrix we easily see that it is a positive definite matrix.\n", - "\n", - "The above procedure with **numpy** can be made more compact if we use **pandas**.\n", - "\n", - "\n", - "\n", - "We whow here how we can set up the correlation matrix using **pandas**, as done in this simple code" - ] - }, - { - "cell_type": "code", - "execution_count": 7, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "[[ 0.30199745 0.72164987]\n", - " [ 1.04858244 2.95539603]\n", - " [ 0.46840512 1.52940309]\n", - " [ 0.24117177 1.78848481]\n", - " [-1.38690487 -4.17705119]\n", - " [-0.65735283 -2.46141305]\n", - " [ 0.94916469 2.81774574]\n", - " [-0.52449732 -2.22140879]\n", - " [-0.66999836 -2.66511337]\n", - " [ 0.22943192 1.71230687]]\n", - " 0 1\n", - "0 0.301997 0.721650\n", - "1 1.048582 2.955396\n", - "2 0.468405 1.529403\n", - "3 0.241172 1.788485\n", - "4 -1.386905 -4.177051\n", - "5 -0.657353 -2.461413\n", - "6 0.949165 2.817746\n", - "7 -0.524497 -2.221409\n", - "8 -0.669998 -2.665113\n", - "9 0.229432 1.712307\n", - " 0 1\n", - "0 1.000000 0.975127\n", - "1 0.975127 1.000000\n" - ] - } - ], - "source": [ - "import numpy as np\n", - "import pandas as pd\n", - "n = 10\n", - "x = np.random.normal(size=n)\n", - "x = x - np.mean(x)\n", - "y = 4+3*x+np.random.normal(size=n)\n", - "y = y - np.mean(y)\n", - "# Note that we transpose the matrix in order to stay with our ordering n x p\n", - "X = (np.vstack((x, y))).T\n", - "print(X)\n", - "Xpd = pd.DataFrame(X)\n", - "print(Xpd)\n", - "correlation_matrix = Xpd.corr()\n", - "print(correlation_matrix)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We expand this model to the Franke function discussed earlier." - ] - }, - { - "cell_type": "code", - "execution_count": 8, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - " 0 1 2 3 4 5 6 7 \\\n", - "0 0.0 0.000000 0.000000 0.000000 0.000000 0.000000 0.000000 0.000000 \n", - "1 0.0 0.096033 0.089499 0.100065 0.095636 0.091356 0.093135 0.089366 \n", - "2 0.0 0.089499 0.084679 0.095430 0.091860 0.088348 0.090343 0.087109 \n", - "3 0.0 0.100065 0.095430 0.109996 0.106272 0.102568 0.105983 0.102429 \n", - "4 0.0 0.095636 0.091860 0.106272 0.103072 0.099840 0.103254 0.100074 \n", - "5 0.0 0.091356 0.088348 0.102568 0.099840 0.097041 0.100443 0.097606 \n", - "6 0.0 0.093135 0.090343 0.105983 0.103254 0.100443 0.104606 0.101680 \n", - "7 0.0 0.089366 0.087109 0.102429 0.100074 0.097606 0.101680 0.099049 \n", - "8 0.0 0.085816 0.084032 0.099028 0.097007 0.094850 0.098834 0.096471 \n", - "9 0.0 0.082468 0.081101 0.095771 0.094052 0.092175 0.096070 0.093951 \n", - "10 0.0 0.085269 0.083748 0.099374 0.097448 0.095375 0.099827 0.097488 \n", - "11 0.0 0.082003 0.080845 0.096087 0.094440 0.092628 0.096955 0.094852 \n", - "12 0.0 0.078938 0.078099 0.092968 0.091572 0.089996 0.094201 0.092313 \n", - "13 0.0 0.076058 0.075503 0.090008 0.088838 0.087475 0.091561 0.089869 \n", - "14 0.0 0.073350 0.073045 0.087198 0.086231 0.085061 0.089033 0.087519 \n", - "\n", - " 8 9 10 11 12 13 14 \n", - "0 0.000000 0.000000 0.000000 0.000000 0.000000 0.000000 0.000000 \n", - "1 0.085816 0.082468 0.085269 0.082003 0.078938 0.076058 0.073350 \n", - "2 0.084032 0.081101 0.083748 0.080845 0.078099 0.075503 0.073045 \n", - "3 0.099028 0.095771 0.099374 0.096087 0.092968 0.090008 0.087198 \n", - "4 0.097007 0.094052 0.097448 0.094440 0.091572 0.088838 0.086231 \n", - "5 0.094850 0.092175 0.095375 0.092628 0.089996 0.087475 0.085061 \n", - "6 0.098834 0.096070 0.099827 0.096955 0.094201 0.091561 0.089033 \n", - "7 0.096471 0.093951 0.097488 0.094852 0.092313 0.089869 0.087519 \n", - "8 0.094138 0.091843 0.095173 0.092754 0.090414 0.088152 0.085968 \n", - "9 0.091843 0.089754 0.092891 0.090673 0.088516 0.086423 0.084394 \n", - "10 0.095173 0.092891 0.096568 0.094135 0.091779 0.089500 0.087297 \n", - "11 0.092754 0.090673 0.094135 0.091901 0.089727 0.087616 0.085567 \n", - "12 0.090414 0.088516 0.091779 0.089727 0.087721 0.085765 0.083859 \n", - "13 0.088152 0.086423 0.089500 0.087616 0.085765 0.083951 0.082179 \n", - "14 0.085968 0.084394 0.087297 0.085567 0.083859 0.082179 0.080529 \n" - ] - } - ], - "source": [ - "# Common imports\n", - "import numpy as np\n", - "import pandas as pd\n", - "\n", - "\n", - "def FrankeFunction(x,y):\n", - "\tterm1 = 0.75*np.exp(-(0.25*(9*x-2)**2) - 0.25*((9*y-2)**2))\n", - "\tterm2 = 0.75*np.exp(-((9*x+1)**2)/49.0 - 0.1*(9*y+1))\n", - "\tterm3 = 0.5*np.exp(-(9*x-7)**2/4.0 - 0.25*((9*y-3)**2))\n", - "\tterm4 = -0.2*np.exp(-(9*x-4)**2 - (9*y-7)**2)\n", - "\treturn term1 + term2 + term3 + term4\n", - "\n", - "\n", - "def create_X(x, y, n ):\n", - "\tif len(x.shape) > 1:\n", - "\t\tx = np.ravel(x)\n", - "\t\ty = np.ravel(y)\n", - "\n", - "\tN = len(x)\n", - "\tl = int((n+1)*(n+2)/2)\t\t# Number of elements in beta\n", - "\tX = np.ones((N,l))\n", - "\n", - "\tfor i in range(1,n+1):\n", - "\t\tq = int((i)*(i+1)/2)\n", - "\t\tfor k in range(i+1):\n", - "\t\t\tX[:,q+k] = (x**(i-k))*(y**k)\n", - "\n", - "\treturn X\n", - "\n", - "\n", - "# Making meshgrid of datapoints and compute Franke's function\n", - "n = 4\n", - "N = 100\n", - "x = np.sort(np.random.uniform(0, 1, N))\n", - "y = np.sort(np.random.uniform(0, 1, N))\n", - "z = FrankeFunction(x, y)\n", - "X = create_X(x, y, n=n) \n", - "\n", - "Xpd = pd.DataFrame(X)\n", - "# subtract the mean values and set up the covariance matrix\n", - "Xpd = Xpd - Xpd.mean()\n", - "covariance_matrix = Xpd.cov()\n", - "print(covariance_matrix)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We note here that the covariance is zero for the first rows and\n", - "columns since all matrix elements in the design matrix were set to one\n", - "(we are fitting the function in terms of a polynomial of degree $n$).\n", - "\n", - "This means that the variance for these elements will be zero and will\n", - "cause problems when we set up the correlation matrix. We can simply\n", - "drop these elements and construct a correlation\n", - "matrix without these elements. \n", - "\n", - "\n", - "\n", - "We can rewrite the covariance matrix in a more compact form in terms of the design/feature matrix $\\boldsymbol{X}$ as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{C}[\\boldsymbol{x}] = \\frac{1}{n}\\boldsymbol{X}^T\\boldsymbol{X}= \\mathbb{E}[\\boldsymbol{X}^T\\boldsymbol{X}].\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "To see this let us simply look at a design matrix $\\boldsymbol{X}\\in {\\mathbb{R}}^{2\\times 2}$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}=\\begin{bmatrix}\n", - "x_{00} & x_{01}\\\\\n", - "x_{10} & x_{11}\\\\\n", - "\\end{bmatrix}=\\begin{bmatrix}\n", - "\\boldsymbol{x}_{0} & \\boldsymbol{x}_{1}\\\\\n", - "\\end{bmatrix}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "If we then compute the expectation value (note the $1/n$ factor instead of $1/(n-1)$)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbb{E}[\\boldsymbol{X}^T\\boldsymbol{X}] = \\frac{1}{n}\\boldsymbol{X}^T\\boldsymbol{X}=\\frac{1}{n}\\begin{bmatrix}\n", - "x_{00}^2+x_{10}^2 & x_{00}x_{01}+x_{10}x_{11}\\\\\n", - "x_{01}x_{00}+x_{11}x_{10} & x_{01}^2+x_{11}^2\\\\\n", - "\\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which is just" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{C}[\\boldsymbol{x}_0,\\boldsymbol{x}_1] = \\boldsymbol{C}[\\boldsymbol{x}]=\\begin{bmatrix} \\mathrm{var}[\\boldsymbol{x}_0] & \\mathrm{cov}[\\boldsymbol{x}_0,\\boldsymbol{x}_1] \\\\\n", - " \\mathrm{cov}[\\boldsymbol{x}_1,\\boldsymbol{x}_0] & \\mathrm{var}[\\boldsymbol{x}_1] \\\\\n", - " \\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where we wrote $$\\boldsymbol{C}[\\boldsymbol{x}_0,\\boldsymbol{x}_1] = \\boldsymbol{C}[\\boldsymbol{x}]$$ to indicate that this is the covariance of the vectors $\\boldsymbol{x}$ of the design/feature matrix $\\boldsymbol{X}$.\n", - "\n", - "It is easy to generalize this to a matrix $\\boldsymbol{X}\\in {\\mathbb{R}}^{n\\times p}$.\n", - "\n", - "\n", - "\n", - "## Linking with the SVD\n", - "\n", - "We saw earlier that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}^T\\boldsymbol{X}=\\boldsymbol{V}\\boldsymbol{\\Sigma}^T\\boldsymbol{U}^T\\boldsymbol{U}\\boldsymbol{\\Sigma}\\boldsymbol{V}^T=\\boldsymbol{V}\\boldsymbol{\\Sigma}^T\\boldsymbol{\\Sigma}\\boldsymbol{V}^T.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Since the matrices here have dimension $p\\times p$, with $p$ corresponding to the singular values, we defined earlier the matrix" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{\\Sigma}^T\\boldsymbol{\\Sigma} = \\begin{bmatrix} \\tilde{\\boldsymbol{\\Sigma}} & \\boldsymbol{0}\\\\ \\end{bmatrix}\\begin{bmatrix} \\tilde{\\boldsymbol{\\Sigma}} \\\\ \\boldsymbol{0}\\\\ \\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where the tilde-matrix $\\tilde{\\boldsymbol{\\Sigma}}$ is a matrix of dimension $p\\times p$ containing only the singular values $\\sigma_i$, that is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\tilde{\\boldsymbol{\\Sigma}}=\\begin{bmatrix} \\sigma_0 & 0 & 0 & \\dots & 0 & 0 \\\\\n", - " 0 & \\sigma_1 & 0 & \\dots & 0 & 0 \\\\\n", - "\t\t\t\t 0 & 0 & \\sigma_2 & \\dots & 0 & 0 \\\\\n", - "\t\t\t\t 0 & 0 & 0 & \\dots & \\sigma_{p-2} & 0 \\\\\n", - "\t\t\t\t 0 & 0 & 0 & \\dots & 0 & \\sigma_{p-1} \\\\\n", - "\\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "meaning we can write" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}^T\\boldsymbol{X}=\\boldsymbol{V}\\tilde{\\boldsymbol{\\Sigma}}^2\\boldsymbol{V}^T.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Multiplying from the right with $\\boldsymbol{V}$ (using the orthogonality of $\\boldsymbol{V}$) we get" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\left(\\boldsymbol{X}^T\\boldsymbol{X}\\right)\\boldsymbol{V}=\\boldsymbol{V}\\tilde{\\boldsymbol{\\Sigma}}^2.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "This means the vectors $\\boldsymbol{v}_i$ of the orthogonal matrix $\\boldsymbol{V}$\n", - "are the eigenvectors of the matrix $\\boldsymbol{X}^T\\boldsymbol{X}$ with eigenvalues\n", - "given by the singular values squared, that is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\left(\\boldsymbol{X}^T\\boldsymbol{X}\\right)\\boldsymbol{v}_i=\\boldsymbol{v}_i\\sigma_i^2.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In other words, each non-zero singular value of $\\boldsymbol{X}$ is a positive\n", - "square root of an eigenvalue of $\\boldsymbol{X}^T\\boldsymbol{X}$. It means also that\n", - "the columns of $\\boldsymbol{V}$ are the eigenvectors of\n", - "$\\boldsymbol{X}^T\\boldsymbol{X}$. Since we have ordered the singular values of\n", - "$\\boldsymbol{X}$ in a descending order, it means that the column vectors\n", - "$\\boldsymbol{v}_i$ are hierarchically ordered by how much correlation they\n", - "encode from the columns of $\\boldsymbol{X}$. \n", - "\n", - "\n", - "Note that these are also the eigenvectors and eigenvalues of the\n", - "Hessian matrix.\n", - "\n", - "If we now recall the definition of the covariance matrix (not using\n", - "Bessel's correction) we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{C}[\\boldsymbol{X}]=\\frac{1}{n}\\boldsymbol{X}^T\\boldsymbol{X},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "meaning that every squared non-singular value of $\\boldsymbol{X}$ divided by $n$ (\n", - "the number of samples) are the eigenvalues of the covariance\n", - "matrix. Every singular value of $\\boldsymbol{X}$ is thus a positive square\n", - "root of an eigenvalue of $\\boldsymbol{X}^T\\boldsymbol{X}$. If the matrix $\\boldsymbol{X}$ is\n", - "self-adjoint, the singular values of $\\boldsymbol{X}$ are equal to the\n", - "absolute value of the eigenvalues of $\\boldsymbol{X}$.\n", - "\n", - "\n", - "For $\\boldsymbol{X}\\boldsymbol{X}^T$ we found" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}\\boldsymbol{X}^T=\\boldsymbol{U}\\boldsymbol{\\Sigma}\\boldsymbol{V}^T\\boldsymbol{V}\\boldsymbol{\\Sigma}^T\\boldsymbol{U}^T=\\boldsymbol{U}\\boldsymbol{\\Sigma}^T\\boldsymbol{\\Sigma}\\boldsymbol{U}^T.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Since the matrices here have dimension $n\\times n$, we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{\\Sigma}\\boldsymbol{\\Sigma}^T = \\begin{bmatrix} \\tilde{\\boldsymbol{\\Sigma}} \\\\ \\boldsymbol{0}\\\\ \\end{bmatrix}\\begin{bmatrix} \\tilde{\\boldsymbol{\\Sigma}} \\boldsymbol{0}\\\\ \\end{bmatrix}=\\begin{bmatrix} \\tilde{\\boldsymbol{\\Sigma}} & \\boldsymbol{0} \\\\ \\boldsymbol{0} & \\boldsymbol{0}\\\\ \\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "leading to" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}\\boldsymbol{X}^T=\\boldsymbol{U}\\begin{bmatrix} \\tilde{\\boldsymbol{\\Sigma}} & \\boldsymbol{0} \\\\ \\boldsymbol{0} & \\boldsymbol{0}\\\\ \\end{bmatrix}\\boldsymbol{U}^T.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Multiplying with $\\boldsymbol{U}$ from the right gives us the eigenvalue problem" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "(\\boldsymbol{X}\\boldsymbol{X}^T)\\boldsymbol{U}=\\boldsymbol{U}\\begin{bmatrix} \\tilde{\\boldsymbol{\\Sigma}} & \\boldsymbol{0} \\\\ \\boldsymbol{0} & \\boldsymbol{0}\\\\ \\end{bmatrix}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "It means that the eigenvalues of $\\boldsymbol{X}\\boldsymbol{X}^T$ are again given by\n", - "the non-zero singular values plus now a series of zeros. The column\n", - "vectors of $\\boldsymbol{U}$ are the eigenvectors of $\\boldsymbol{X}\\boldsymbol{X}^T$ and\n", - "measure how much correlations are contained in the rows of $\\boldsymbol{X}$.\n", - "\n", - "Since we will mainly be interested in the correlations among the features\n", - "of our data (the columns of $\\boldsymbol{X}$, the quantity of interest for us are the non-zero singular\n", - "values and the column vectors of $\\boldsymbol{V}$.\n", - "\n", - "\n", - "\n", - "\n", - "## Ridge and Lasso Regression\n", - "\n", - "Let us remind ourselves about the expression for the standard Mean Squared Error (MSE) which we used to define our cost function and the equations for the ordinary least squares (OLS) method, that is \n", - "our optimization problem is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "{\\displaystyle \\min_{\\boldsymbol{\\beta}\\in {\\mathbb{R}}^{p}}}\\frac{1}{n}\\left\\{\\left(\\boldsymbol{y}-\\boldsymbol{X}\\boldsymbol{\\beta}\\right)^T\\left(\\boldsymbol{y}-\\boldsymbol{X}\\boldsymbol{\\beta}\\right)\\right\\}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "or we can state it as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "{\\displaystyle \\min_{\\boldsymbol{\\beta}\\in\n", - "{\\mathbb{R}}^{p}}}\\frac{1}{n}\\sum_{i=0}^{n-1}\\left(y_i-\\tilde{y}_i\\right)^2=\\frac{1}{n}\\vert\\vert \\boldsymbol{y}-\\boldsymbol{X}\\boldsymbol{\\beta}\\vert\\vert_2^2,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where we have used the definition of a norm-2 vector, that is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\vert\\vert \\boldsymbol{x}\\vert\\vert_2 = \\sqrt{\\sum_i x_i^2}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "By minimizing the above equation with respect to the parameters\n", - "$\\boldsymbol{\\beta}$ we could then obtain an analytical expression for the\n", - "parameters $\\boldsymbol{\\beta}$. We can add a regularization parameter $\\lambda$ by\n", - "defining a new cost function to be optimized, that is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "{\\displaystyle \\min_{\\boldsymbol{\\beta}\\in\n", - "{\\mathbb{R}}^{p}}}\\frac{1}{n}\\vert\\vert \\boldsymbol{y}-\\boldsymbol{X}\\boldsymbol{\\beta}\\vert\\vert_2^2+\\lambda\\vert\\vert \\boldsymbol{\\beta}\\vert\\vert_2^2\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which leads to the Ridge regression minimization problem where we\n", - "require that $\\vert\\vert \\boldsymbol{\\beta}\\vert\\vert_2^2\\le t$, where $t$ is\n", - "a finite number larger than zero. By defining" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(\\boldsymbol{X},\\boldsymbol{\\beta})=\\frac{1}{n}\\vert\\vert \\boldsymbol{y}-\\boldsymbol{X}\\boldsymbol{\\beta}\\vert\\vert_2^2+\\lambda\\vert\\vert \\boldsymbol{\\beta}\\vert\\vert_1,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "we have a new optimization equation" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "{\\displaystyle \\min_{\\boldsymbol{\\beta}\\in\n", - "{\\mathbb{R}}^{p}}}\\frac{1}{n}\\vert\\vert \\boldsymbol{y}-\\boldsymbol{X}\\boldsymbol{\\beta}\\vert\\vert_2^2+\\lambda\\vert\\vert \\boldsymbol{\\beta}\\vert\\vert_1\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which leads to Lasso regression. Lasso stands for least absolute shrinkage and selection operator. \n", - "\n", - "Here we have defined the norm-1 as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\vert\\vert \\boldsymbol{x}\\vert\\vert_1 = \\sum_i \\vert x_i\\vert.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Using the matrix-vector expression for Ridge regression and dropping the parameter $1/n$ in front of the standard means squared error equation, we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(\\boldsymbol{X},\\boldsymbol{\\beta})=\\left\\{(\\boldsymbol{y}-\\boldsymbol{X}\\boldsymbol{\\beta})^T(\\boldsymbol{y}-\\boldsymbol{X}\\boldsymbol{\\beta})\\right\\}+\\lambda\\boldsymbol{\\beta}^T\\boldsymbol{\\beta},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and \n", - "taking the derivatives with respect to $\\boldsymbol{\\beta}$ we obtain then\n", - "a slightly modified matrix inversion problem which for finite values\n", - "of $\\lambda$ does not suffer from singularity problems. We obtain\n", - "the optimal parameters" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\hat{\\boldsymbol{\\beta}}_{\\mathrm{Ridge}} = \\left(\\boldsymbol{X}^T\\boldsymbol{X}+\\lambda\\boldsymbol{I}\\right)^{-1}\\boldsymbol{X}^T\\boldsymbol{y},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with $\\boldsymbol{I}$ being a $p\\times p$ identity matrix with the constraint that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\sum_{i=0}^{p-1} \\beta_i^2 \\leq t,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with $t$ a finite positive number. \n", - "\n", - "When we compare this with the ordinary least squares result we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\hat{\\boldsymbol{\\beta}}_{\\mathrm{OLS}} = \\left(\\boldsymbol{X}^T\\boldsymbol{X}\\right)^{-1}\\boldsymbol{X}^T\\boldsymbol{y},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which can lead to singular matrices. However, with the SVD, we can always compute the inverse of the matrix $\\boldsymbol{X}^T\\boldsymbol{X}$.\n", - "\n", - "\n", - "We see that Ridge regression is nothing but the standard OLS with a\n", - "modified diagonal term added to $\\boldsymbol{X}^T\\boldsymbol{X}$. The consequences, in\n", - "particular for our discussion of the bias-variance tradeoff are rather\n", - "interesting. We will see that for specific values of $\\lambda$, we may\n", - "even reduce the variance of the optimal parameters $\\boldsymbol{\\beta}$. These topics and other related ones, will be discussed after the more linear algebra oriented analysis here.\n", - "\n", - "\n", - "\n", - "Using our insights about the SVD of the design matrix $\\boldsymbol{X}$ \n", - "We have already analyzed the OLS solutions in terms of the eigenvectors (the columns) of the right singular value matrix $\\boldsymbol{U}$ as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\tilde{\\boldsymbol{y}}_{\\mathrm{OLS}}=\\boldsymbol{X}\\boldsymbol{\\beta} =\\boldsymbol{U}\\boldsymbol{U}^T\\boldsymbol{y}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "For Ridge regression this becomes" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\tilde{\\boldsymbol{y}}_{\\mathrm{Ridge}}=\\boldsymbol{X}\\boldsymbol{\\beta}_{\\mathrm{Ridge}} = \\boldsymbol{U\\Sigma V^T}\\left(\\boldsymbol{V}\\boldsymbol{\\Sigma}^2\\boldsymbol{V}^T+\\lambda\\boldsymbol{I} \\right)^{-1}(\\boldsymbol{U\\Sigma V^T})^T\\boldsymbol{y}=\\sum_{j=0}^{p-1}\\boldsymbol{u}_j\\boldsymbol{u}_j^T\\frac{\\sigma_j^2}{\\sigma_j^2+\\lambda}\\boldsymbol{y},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with the vectors $\\boldsymbol{u}_j$ being the columns of $\\boldsymbol{U}$ from the SVD of the matrix $\\boldsymbol{X}$. \n", - "\n", - "\n", - "\n", - "Since $\\lambda \\geq 0$, it means that compared to OLS, we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\sigma_j^2}{\\sigma_j^2+\\lambda} \\leq 1.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Ridge regression finds the coordinates of $\\boldsymbol{y}$ with respect to the\n", - "orthonormal basis $\\boldsymbol{U}$, it then shrinks the coordinates by\n", - "$\\frac{\\sigma_j^2}{\\sigma_j^2+\\lambda}$. Recall that the SVD has\n", - "eigenvalues ordered in a descending way, that is $\\sigma_i \\geq\n", - "\\sigma_{i+1}$.\n", - "\n", - "For small eigenvalues $\\sigma_i$ it means that their contributions become less important, a fact which can be used to reduce the number of degrees of freedom. More about this when we have covered the material on a statistical interpretation of various linear regression methods.\n", - "\n", - "\n", - "\n", - "For the sake of simplicity, let us assume that the design matrix is orthonormal, that is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}^T\\boldsymbol{X}=(\\boldsymbol{X}^T\\boldsymbol{X})^{-1} =\\boldsymbol{I}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In this case the standard OLS results in" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{\\beta}^{\\mathrm{OLS}} = \\boldsymbol{X}^T\\boldsymbol{y}=\\sum_{i=0}^{p-1}\\boldsymbol{u}_j\\boldsymbol{u}_j^T\\boldsymbol{y},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{\\beta}^{\\mathrm{Ridge}} = \\left(\\boldsymbol{I}+\\lambda\\boldsymbol{I}\\right)^{-1}\\boldsymbol{X}^T\\boldsymbol{y}=\\left(1+\\lambda\\right)^{-1}\\boldsymbol{\\beta}^{\\mathrm{OLS}},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "that is the Ridge estimator scales the OLS estimator by the inverse of a factor $1+\\lambda$, and\n", - "the Ridge estimator converges to zero when the hyperparameter goes to\n", - "infinity.\n", - "\n", - "We will come back to more interpreations after we have gone through some of the statistical analysis part. \n", - "\n", - "\n", - "\n", - "Using the matrix-vector expression for Lasso regression and dropping the parameter $1/n$ in front of the standard mean squared error equation, we have the following **cost** function" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(\\boldsymbol{X},\\boldsymbol{\\beta})=\\left\\{(\\boldsymbol{y}-\\boldsymbol{X}\\boldsymbol{\\beta})^T(\\boldsymbol{y}-\\boldsymbol{X}\\boldsymbol{\\beta})\\right\\}+\\lambda\\vert\\vert\\boldsymbol{\\beta}\\vert\\vert_1,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Taking the derivative with respect to $\\boldsymbol{\\beta}$ and recalling that the derivative of the absolute value is (we drop the boldfaced vector symbol for simplicty)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{d \\vert \\beta\\vert}{d \\boldsymbol{\\beta}}=\\mathrm{sgn}(\\boldsymbol{\\beta})=\\left\\{\\begin{array}{cc} 1 & \\beta > 0 \\\\ 0 & \\beta =0\\\\-1 & \\beta < 0, \\end{array}\\right.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "we have that the derivative of the cost function is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial C(\\boldsymbol{X},\\boldsymbol{\\beta})}{\\partial \\boldsymbol{\\beta}}=-2\\boldsymbol{X}^T(\\boldsymbol{y}-\\boldsymbol{X}\\boldsymbol{\\beta})+\\lambda sgn(\\boldsymbol{\\beta})=0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and reordering we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}^T\\boldsymbol{X}\\boldsymbol{\\beta}+\\lambda sgn(\\boldsymbol{\\beta})=2\\boldsymbol{X}^T\\boldsymbol{y}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "This equation does not lead to a nice analytical equation as in Ridge regression or ordinary least squares. This equation can however be solved by using standard convex optimization algorithms using for example the Python package [CVXOPT](https://cvxopt.org/). We will discuss this later. \n", - "\n", - "\n", - "\n", - "\n", - "\n", - "Let us assume that our design matrix is given by unit (identity) matrix, that is a square diagonal matrix with ones only along the\n", - "diagonal. In this case we have an equal number of rows and columns $n=p$.\n", - "\n", - "Our model approximation is just $\\tilde{\\boldsymbol{y}}=\\boldsymbol{\\beta}$ and the mean squared error and thereby the cost function for ordinary least sqquares (OLS) is then (we drop the term $1/n$)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(\\boldsymbol{\\beta})=\\sum_{i=0}^{p-1}(y_i-\\beta_i)^2,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and minimizing we have that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\hat{\\beta}_i^{\\mathrm{OLS}} = y_i.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "For Ridge regression our cost function is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(\\boldsymbol{\\beta})=\\sum_{i=0}^{p-1}(y_i-\\beta_i)^2+\\lambda\\sum_{i=0}^{p-1}\\beta_i^2,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and minimizing we have that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\hat{\\beta}_i^{\\mathrm{Ridge}} = \\frac{y_i}{1+\\lambda}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "For Lasso regression our cost function is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(\\boldsymbol{\\beta})=\\sum_{i=0}^{p-1}(y_i-\\beta_i)^2+\\lambda\\sum_{i=0}^{p-1}\\vert\\beta_i\\vert=\\sum_{i=0}^{p-1}(y_i-\\beta_i)^2+\\lambda\\sum_{i=0}^{p-1}\\sqrt{\\beta_i^2},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and minimizing we have that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "-2\\sum_{i=0}^{p-1}(y_i-\\beta_i)+\\lambda \\sum_{i=0}^{p-1}\\frac{(\\beta_i)}{\\vert\\beta_i\\vert}=0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which leads to" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\hat{\\boldsymbol{\\beta}}_i^{\\mathrm{Lasso}} = \\left\\{\\begin{array}{ccc}y_i-\\frac{\\lambda}{2} &\\mathrm{if} & y_i> \\frac{\\lambda}{2}\\\\\n", - " y_i+\\frac{\\lambda}{2} &\\mathrm{if} & y_i< -\\frac{\\lambda}{2}\\\\\n", - "\t\t\t\t\t\t\t 0 &\\mathrm{if} & \\vert y_i\\vert\\le \\frac{\\lambda}{2}\\end{array}\\right.\\\\.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Plotting these results ([figure in handwritten notes for week 36](https://github.com/CompPhysics/MachineLearning/blob/master/doc/HandWrittenNotes/2021/NotesSeptember9.pdf)) shows clearly that Lasso regression suppresses (sets to zero) values of $\\beta_i$ for specific values of $\\lambda$. Ridge regression reduces on the other hand the values of $\\beta_i$ as function of $\\lambda$.\n", - "\n", - "\n", - "As another examples, \n", - "let us assume we have a data set with outputs/targets given by the vector" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{y}=\\begin{bmatrix}4 \\\\ 2 \\\\3\\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and our inputs as a $3\\times 2$ design matrix" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}=\\begin{bmatrix}2 & 0\\\\ 0 & 1 \\\\ 0 & 0\\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "meaning that we have two features and two unknown parameters $\\beta_0$ and $\\beta_1$ to be determined either by ordinary least squares, Ridge or Lasso regression.\n", - "\n", - "\n", - "For ordinary least squares (OLS) we know that the optimal solution is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\hat{\\boldsymbol{\\beta}}^{\\mathrm{OLS}}=\\left( \\boldsymbol{X}^T\\boldsymbol{X}\\right)^{-1}\\boldsymbol{X}^T\\boldsymbol{y}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Inserting the above values we obtain that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\hat{\\boldsymbol{\\beta}}^{\\mathrm{OLS}}=\\begin{bmatrix}2 \\\\ 2\\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The code which implements this simpler case is presented after the discussion of Ridge and Lasso.\n", - "\n", - "\n", - "For Ridge regression we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\hat{\\boldsymbol{\\beta}}^{\\mathrm{Ridge}}=\\left( \\boldsymbol{X}^T\\boldsymbol{X}+\\lambda\\boldsymbol{I}\\right)^{-1}\\boldsymbol{X}^T\\boldsymbol{y}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Inserting the above values we obtain that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\hat{\\boldsymbol{\\beta}}^{\\mathrm{Ridge}}=\\begin{bmatrix}\\frac{8}{4+\\lambda} \\\\ \\frac{2}{1+\\lambda}\\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "There is normally a constraint on the value of $\\vert\\vert \\boldsymbol{\\beta}\\vert\\vert_2$ via the parameter $\\lambda$.\n", - "Let us for simplicity assume that $\\beta_0^2+\\beta_1^2=1$ as constraint. This will allow us to find an expression for the optimal values of $\\beta$ and $\\lambda$.\n", - "\n", - "To see this, let us write the cost function for Ridge regression. \n", - "\n", - "\n", - "\n", - "We define the MSE without the $1/n$ factor and have then, using that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}\\boldsymbol{\\beta}=\\begin{bmatrix} 2\\beta_0 \\\\ \\beta_1 \\\\0 \\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(\\boldsymbol{\\beta})=(4-2\\beta_0)^2+(2-\\beta_1)^2+\\lambda(\\beta_0^2+\\beta_1^2),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and taking the derivative with respect to $\\beta_0$ we get" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\beta_0=\\frac{8}{4+\\lambda},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and for $\\beta_1$ we obtain" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\beta_1=\\frac{2}{1+\\lambda},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Using the constraint for $\\beta_0^2+\\beta_1^2=1$ we can constrain $\\lambda$ by solving" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\left(\\frac{8}{4+\\lambda}\\right)^2+\\left(\\frac{2}{1+\\lambda}\\right)^2=1,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which gives $\\lambda=4.571$ and $\\beta_0=0.933$ and $\\beta_1=0.359$.\n", - "\n", - "\n", - "For Lasso we need now, keeping a constraint on $\\vert\\beta_0\\vert+\\vert\\beta_1\\vert=1$, to take the derivative of the absolute values of $\\beta_0$\n", - "and $\\beta_1$. This gives us the following derivatives of the cost function" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(\\boldsymbol{\\beta})=(4-2\\beta_0)^2+(2-\\beta_1)^2+\\lambda(\\vert\\beta_0\\vert+\\vert\\beta_1\\vert),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial C(\\boldsymbol{\\beta})}{\\partial \\beta_0}=-4(4-2\\beta_0)+\\lambda\\mathrm{sgn}(\\beta_0)=0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial C(\\boldsymbol{\\beta})}{\\partial \\beta_1}=-2(2-\\beta_1)+\\lambda\\mathrm{sgn}(\\beta_1)=0.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We have now four cases to solve besides the trivial cases $\\beta_0$ and/or $\\beta_1$ are zero, namely\n", - "1. $\\beta_0 > 0$ and $\\beta_1 > 0$,\n", - "\n", - "2. $\\beta_0 > 0$ and $\\beta_1 < 0$,\n", - "\n", - "3. $\\beta_0 < 0$ and $\\beta_1 > 0$,\n", - "\n", - "4. $\\beta_0 < 0$ and $\\beta_1 < 0$.\n", - "\n", - "If we consider the first case, we have then" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "-4(4-2\\beta_0)+\\lambda=0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "-2(2-\\beta_1)+\\lambda=0.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which yields" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\beta_0=\\frac{16+\\lambda}{8},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\beta_1=\\frac{4+\\lambda}{2}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Using the constraint on $\\beta_0$ and $\\beta_1$ we can then find the optimal value of $\\lambda$ for the different cases. We leave this as an exercise to you.\n", - "\n", - "\n", - "Here we set up the OLS, Ridge and Lasso functionality in order to study the above example. Note that here we have opted for a set of values of $\\lambda$, meaning that we need to perform a search in order to find the optimal values.\n", - "\n", - "First we study and compare the OLS and Ridge results. The next code compares all three methods.\n", - "We select values of the hyperparameter $\\lambda\\in [10^{-4},10^4]$ and compute the predicted values for ordinary least squares and Ridge regression." - ] - }, - { - "cell_type": "code", - "execution_count": 9, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "[2. 2.]\n", - "Training MSE for OLS\n", - "3.0\n" - ] - }, - { - "data": { - "image/png": "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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter2_245_1.png" - }, - "needs_background": "light" - }, - "output_type": "display_data" - } - ], - "source": [ - "%matplotlib inline\n", - "\n", - "import os\n", - "import numpy as np\n", - "import pandas as pd\n", - "import matplotlib.pyplot as plt\n", - "\n", - "def R2(y_data, y_model):\n", - " return 1 - np.sum((y_data - y_model) ** 2) / np.sum((y_data - np.mean(y_data)) ** 2)\n", - "def MSE(y_data,y_model):\n", - " n = np.size(y_model)\n", - " return np.sum((y_data-y_model)**2)/n\n", - "\n", - "\n", - "# A seed just to ensure that the random numbers are the same for every run.\n", - "# Useful for eventual debugging.\n", - "\n", - "X = np.array( [ [ 2, 0], [0, 1], [0,0]])\n", - "y = np.array( [4, 2, 3])\n", - "\n", - "\n", - "# matrix inversion to find beta\n", - "OLSbeta = np.linalg.inv(X.T @ X) @ X.T @ y\n", - "print(OLSbeta)\n", - "# and then make the prediction\n", - "ytildeOLS = X @ OLSbeta\n", - "print(\"Training MSE for OLS\")\n", - "print(MSE(y,ytildeOLS))\n", - "ypredictOLS = X @ OLSbeta\n", - "\n", - "# Repeat now for Ridge regression and various values of the regularization parameter\n", - "I = np.eye(2,2)\n", - "# Decide which values of lambda to use\n", - "nlambdas = 100\n", - "MSEPredict = np.zeros(nlambdas)\n", - "lambdas = np.logspace(-4, 4, nlambdas)\n", - "for i in range(nlambdas):\n", - " lmb = lambdas[i]\n", - " Ridgebeta = np.linalg.inv(X.T @ X+lmb*I) @ X.T @ y\n", - "# print(Ridgebeta)\n", - " # and then make the prediction\n", - " ypredictRidge = X @ Ridgebeta\n", - " MSEPredict[i] = MSE(y,ypredictRidge)\n", - "# print(MSEPredict[i])\n", - " # Now plot the results\n", - "plt.figure()\n", - "plt.plot(np.log10(lambdas), MSEPredict, 'r--', label = 'MSE Ridge Train')\n", - "plt.xlabel('log10(lambda)')\n", - "plt.ylabel('MSE')\n", - "plt.legend()\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We see here that we reach a plateau for the Ridge results. Writing out the coefficients $\\boldsymbol{\\beta}$, we that they are getting smaller and smaller and our error stabilizes since the predicted values of $\\tilde{\\boldsymbol{y}}$ approach zero.\n", - "\n", - "This happens also for Lasso regression, as seen from the next code\n", - "output. The difference is that Lasso shrinks the values of $\\beta$ to\n", - "zero at a much earlier stage and the results flatten out. We see that\n", - "Lasso gives also an excellent fit for small values of $\\lambda$ and\n", - "shows rthe best performance of the three regression methods." - ] - }, - { - "cell_type": "code", - "execution_count": 10, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "[2. 2.]\n", - "Training MSE for OLS\n", - "3.0\n", - "[1.99995 1.99980002]\n", - "[ 0.50001525 -0.99953475]\n", - "[1.99993978 1.99975913]\n", - "[ 0.50001525 -0.99944272]\n", - "[1.99992746 1.99970988]\n", - "[ 0.50001525 -0.99933188]\n", - "[1.99991263 1.99965056]\n", - "[ 0.50001525 -0.99919837]\n", - "[1.99989476 1.99957911]\n", - "[ 0.50001524 -0.99903755]\n", - "[1.99987324 1.99949306]\n", - "[ 0.50001524 -0.99884384]\n", - "[1.99984732 1.99938942]\n", - "[ 0.50001524 -0.99861053]\n", - "[1.9998161 1.99926459]\n", - "[ 0.50001523 -0.9983295 ]\n", - "[1.99977849 1.99911427]\n", - "[ 0.50001523 -0.99799099]\n", - "[1.9997332 1.99893323]\n", - "[ 0.50001522 -0.99758326]\n", - "[1.99967865 1.99871521]\n", - "[ 0.50001521 -0.99709215]\n", - "[1.99961294 1.99845267]\n", - "[ 0.50001521 -0.99650061]\n", - "[1.99953381 1.99813653]\n", - "[ 0.50001519 -0.99578809]\n", - "[1.9994385 1.99775587]\n", - "[ 0.50001518 -0.99492986]\n", - "[1.9993237 1.99729756]\n", - "[ 0.50001517 -0.99389612]\n", - "[1.99918546 1.9967458 ]\n", - "[ 0.50001515 -0.99265097]\n", - "[1.99901896 1.99608161]\n", - "[ 0.50001512 -0.99115119]\n", - "[1.99881845 1.99528218]\n", - "[ 0.5000151 -0.9893447]\n", - "[1.998577 1.9943201]\n", - "[ 0.50001506 -0.98716878]\n", - "[1.99828624 1.99316252]\n", - "[ 0.50001502 -0.98454786]\n", - "[1.99793613 1.99176998]\n", - "[ 0.50001498 -0.98139097]\n", - "[1.99751458 1.99009525]\n", - "[ 0.50001492 -0.97758848]\n", - "[1.99700706 1.98808176]\n", - "[ 0.50001485 -0.97300836]\n", - "[1.9963961 1.98566191]\n", - "[ 0.50001476 -0.9674916 ]\n", - "[1.99566069 1.98275501]\n", - "[ 0.50001466 -0.96084663]\n", - "[1.9947756 1.97926491]\n", - "[ 0.50001454 -0.95284275]\n", - "[1.99371056 1.97507735]\n", - "[ 0.50001439 -0.94320205]\n", - "[1.99242921 1.97005689]\n", - "[ 0.50001422 -0.93158979]\n", - "[1.99088801 1.9640435 ]\n", - "[ 0.500014 -0.91760278]\n", - "[1.9890348 1.95684892]\n", - "[ 0.50001374 -0.90075537]\n", - "[1.98680716 1.9482527 ]\n", - "[ 0.50001343 -0.88046261]\n", - "[1.98413059 1.93799826]\n", - "[ 0.50001306 -0.85601992]\n", - "[1.98091621 1.92578916]\n", - "[ 0.50001261 -0.8265786 ]\n", - "[1.97705827 1.91128596]\n", - "[ 0.50001207 -0.79111643]\n", - "[1.97243128 1.89410423]\n", - "[ 0.50001142 -0.74840212]\n", - "[1.96688672 1.87381451]\n", - "[ 0.50001063 -0.69695259]\n", - "[1.96024953 1.84994524]\n", - "[ 0.50000969 -0.63498144]\n", - "[1.95231424 1.82198978]\n", - "[ 0.50000855 -0.56033697]\n", - "[1.94284104 1.78941903]\n", - "[ 0.50000718 -0.47042744]\n", - "[1.93155188 1.75170092]\n", - "[ 0.50000553 -0.3621311 ]\n", - "[1.91812702 1.70832814]\n", - "[ 0.50001414 -0.23167717]\n", - "[1.90220243 1.65885453]\n", - "[ 0.50000455 -0.07456491]\n", - "[1.88336879 1.60293962]\n", - "[ 0.47132891 -0. ]\n", - "[1.86117291 1.54039921]\n", - "[ 0.41433969 -0. ]\n", - "[1.83512277 1.47125748]\n", - "[ 0.34569596 -0. ]\n", - "[1.80469739 1.39579407]\n", - "[ 0.26301436 -0. ]\n", - "[1.76936315 1.31457796]\n", - "[ 0.16342407 -0. ]\n", - "[1.72859758 1.22847924]\n", - "[ 0.04346721 -0. ]\n", - "[1.68192193 1.13865173]\n", - "[ 0. -0.]\n", - "[1.62894215 1.04648335]\n", - "[ 0. -0.]\n", - "[1.56939714 0.95351665]\n", - "[ 0. -0.]\n", - "[1.50321091 0.86134827]\n", - "[ 0. -0.]\n", - "[1.43054282 0.77152076]\n", - "[ 0. -0.]\n", - "[1.35182854 0.68542204]\n", - "[ 0. -0.]\n", - "[1.26780278 0.60420593]\n", - "[ 0. -0.]\n", - "[1.17949575 0.52874252]\n", - "[ 0. -0.]\n", - "[1.0881981 0.45960079]\n", - "[ 0. -0.]\n", - "[0.99539415 0.39706038]\n", - "[ 0. -0.]\n", - "[0.90266948 0.34114547]\n", - "[ 0. -0.]\n", - "[0.81160425 0.29167186]\n", - "[ 0. -0.]\n", - "[0.7236674 0.24829908]\n", - "[ 0. -0.]\n", - "[0.64012627 0.21058097]\n", - "[ 0. -0.]\n", - "[0.56198284 0.17801022]\n", - "[ 0. -0.]\n", - "[0.48994188 0.15005476]\n", - "[ 0. -0.]\n", - "[0.42441033 0.12618549]\n", - "[ 0. -0.]\n", - "[0.3655222 0.10589577]\n", - "[ 0. -0.]\n", - "[0.31318084 0.08871404]\n", - "[ 0. -0.]\n", - "[0.26710969 0.07421084]\n", - "[ 0. -0.]\n", - "[0.22690428 0.06200174]\n", - "[ 0. -0.]\n", - "[0.19207979 0.0517473 ]\n", - "[ 0. -0.]\n", - "[0.16211139 0.04315108]\n", - "[ 0. -0.]\n", - "[0.13646574 0.0359565 ]\n", - "[ 0. -0.]\n", - "[0.11462415 0.02994311]\n", - "[ 0. -0.]\n", - "[0.09609807 0.02492265]\n", - "[ 0. -0.]\n", - "[0.08043851 0.02073509]\n", - "[ 0. -0.]\n", - "[0.06724062 0.01724499]\n", - "[ 0. -0.]\n", - "[0.05614483 0.01433809]\n", - "[ 0. -0.]\n", - "[0.04683565 0.01191824]\n", - "[ 0. -0.]\n", - "[0.039039 0.00990475]\n", - "[ 0. -0.]\n", - "[0.03251863 0.00823002]\n", - "[ 0. -0.]\n", - "[0.02707227 0.00683748]\n", - "[ 0. -0.]\n", - "[0.02252765 0.0056799 ]\n", - "[ 0. -0.]\n", - "[0.01873869 0.00471782]\n", - "[ 0. -0.]\n", - "[0.01558197 0.00391839]\n", - "[ 0. -0.]\n", - "[0.01295356 0.0032542 ]\n", - "[ 0. -0.]\n", - "[0.01076611 0.00270244]\n", - "[ 0. -0.]\n", - "[0.00894639 0.00224413]\n", - "[ 0. -0.]\n", - "[0.0074331 0.00186347]\n", - "[ 0. -0.]\n", - "[0.00617499 0.00154733]\n", - "[ 0. -0.]\n", - "[0.00512927 0.00128479]\n", - "[ 0. -0.]\n", - "[0.00426027 0.00106677]\n", - "[ 0. -0.]\n", - "[0.00353823 0.00088573]\n", - "[ 0. -0.]\n", - "[0.00293838 0.00073541]\n", - "[ 0. -0.]\n", - "[0.0024401 0.00061058]\n", - "[ 0. -0.]\n", - "[0.00202624 0.00050694]\n", - "[ 0. -0.]\n", - "[0.00168251 0.00042089]\n", - "[ 0. -0.]\n", - "[0.00139705 0.00034944]\n", - "[ 0. -0.]\n", - "[0.00115999 0.00029012]\n", - "[ 0. -0.]\n", - "[0.00096314 0.00024087]\n", - "[ 0. -0.]\n", - "[0.00079968 0.00019998]\n", - "[ 0. -0.]\n" - ] - }, - { - "data": { - "image/png": "iVBORw0KGgoAAAANSUhEUgAAAX4AAAEHCAYAAACp9y31AAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjMuMywgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/Il7ecAAAACXBIWXMAAAsTAAALEwEAmpwYAAAqrElEQVR4nO3dd5xU1fnH8c/DUhYBQQGJCAgaRQwCwmogRLCBBSIQVLBFQMSoKLFGJUaNqESMJSY/CRpR1ODPny0EsKCBSKIoHWkWEBGDSO9ly/P748wWdgaWsrt3Z+b7fr3ua2fuc2fus4WHM+eee465OyIikj4qRZ2AiIiULxV+EZE0o8IvIpJmVPhFRNKMCr+ISJpR4RcRSTOVy+qNzexZoDvwvbu3jO07HPhfoCmwDLjY3deX9F716tXzpk2bllWqIiIpaebMmWvcvX7x/VZW4/jNrBOwBRhTpPA/DKxz9+FmdgdwmLv/uqT3ysrK8hkzZpRJniIiqcrMZrp7VvH9ZdbV4+4fAOuK7e4BPB97/DzQs6zOLyIiiZV3H38Dd18Ze/wd0GBPB5rZIDObYWYzVq9eXT7ZiYikgcgu7nroY9pjP5O7j3L3LHfPql8/rotKREQOUJld3N2DVWZ2pLuvNLMjge8P9I2ys7NZsWIFO3bsKMX0JAqZmZk0atSIKlWqRJ2KSFoo78I/DrgSGB77+vcDfaMVK1ZQq1YtmjZtipmVVn5SztydtWvXsmLFCpo1axZ1OiJpocy6esxsLPAR0NzMVpjZVYSC38XMvgDOjj0/IDt27KBu3boq+knOzKhbt64+uYmUozJr8bv7JXsInVVa51DRTw36PYqUr/Lu6hERSS55ebBzJ+zYAdu3h69mkN81OXcurFsH2dmFW+3acMYZIf73v8OaNZCbW7gddRT06hXif/kLrF8fzpO/nXACXHxx2X1P7l7ht3bt2nlxCxcujNtX3gC/7LLLCp5nZ2d7vXr1vFu3bu7u/t1333m3bt28VatW3qJFCz/vvPPc3f2rr77yzMxMb926dcH2/PPPx71/586d/fjjj/dWrVp5VlaWz549uyB23nnn+fr16+Nec8899/iIESMO6vtas2ZNQV4NGjTwhg0bFjzfuXNnia+fPn2633DDDft1zorw+5QUtX27+1dfuX/yifuECe7PP+/+l78Uxh9/3L1nT/czznA/5RT3Fi3cO3QojHft6g67byeeWBjv2DE+fuqphfFWreLjZ51VGG/WLD7es2epfOvADE9QU9XiPwg1atRg/vz5bN++nerVqzNp0iSOOuqogvhvf/tbunTpwpAhQwCYN29eQezYY49lzpw5JZ7jpZdeIisri9GjR3PbbbcxadIkACZOnFi630wRdevWLcjt3nvvpWbNmtx66627HZOTk0Plyon/fLKyssjKirtZUKRsbNwIixfDl1/CV1/B11/Dt9/C+PFQqRLccAM888zur6lWDQYNCo+XL4clS+DQQ6FuXTj6aGjYsPDY/v1D67169fC6zEyoV68w/vjjsGULVKlSuNWqVRifODG08jMyCrdq1Qrj8+eHTxAZGSFfs7CVIRX+g3T++eczYcIELrzwQsaOHcsll1zC1KlTAVi5ciVdu3YtOLZVq1YHfJ4OHTowYsSIgudNmzZlxowZ1KtXjwceeIDnn3+eI444gsaNG9OuXTsApk+fzlVXXUWlSpXo0qULb731FvPnzyc3N5c77riDKVOmsHPnTq6//nquueaaEnPo168fmZmZzJ49m44dO9K3b1+GDBnCjh07qF69OqNHj6Z58+ZMmTKFRx55hPHjx3PvvfeyfPlyli5dyvLly/nVr37FjTfeeMA/B0lju3aFIjlzZuheGTYM6tQJhffeewuPa9AAmjSBzZtDl8sVV0D79nDEEVC/fijahx8e2tZm8Ic/7P28ffvuPV5SI6dIYzChQw7Ze7wMpE7hP/30+H0XXwzXXQfbtsH558fH+/UL25o1cOGFu8emTNmn0/bt25ff/e53dO/enXnz5jFgwICCwn/99dfTp08f/vSnP3H22WfTv39/GsZaEkuWLKFNmzYF7/Pkk09y2mmn7fE8b7/9Nj179ozbP3PmTF5++WXmzJlDTk4Obdu2LSj8/fv35+mnn6ZDhw7ccccdBa/561//Su3atZk+fTo7d+6kY8eOdO3adZ+GU65YsYIPP/yQjIwMNm3axNSpU6lcuTLvvfced911F6+99lrcaxYvXszkyZPZvHkzzZs359prr9WYfdl3U6fCbbfB7Nmh+ENoUV99dSj8F18MbdvCD38ITZuGlnlRnTqFTQqkTuGPSKtWrVi2bBljx47l/GL/uZxzzjksXbqUt99+m7feeouTTz6Z+fPnA/ve1XPZZZexa9cutmzZkvD4qVOn0qtXLw6JtRouuOACADZs2MDmzZvp0KEDAJdeeinjx48H4N1332XevHm8+uqrAGzcuJEvvvhinwr/RRddREZGRsHrrrzySr744gvMjOzs7ISv6datG9WqVaNatWocccQRrFq1ikaNGpV4Lkkz7qFFP2FC6B655Rbo0QNq1oTKleHGG+GUU0ILu1mzwu6QFi3CJvssdQr/3lrohxyy93i9evvcwk/kggsu4NZbb2XKlCmsXbt2t9jhhx/OpZdeyqWXXkr37t354IMPClrk++Kll16iXbt23Hbbbdxwww28/vrrB5xnPnfnySef5Jxzztnv19aoUaPg8d13380ZZ5zBG2+8wbJlyzg90acuoFqR/syMjAxycnL2+7ySwnbsgIcfhpdfhkWLwr6TTw6jW/If//vf0eWXgrQQSykYMGAA99xzDyeddNJu+//5z3+ybds2ADZv3sySJUto0qTJfr+/mXH//fczbdo0Fi9evFusU6dOvPnmm2zfvp3Nmzfzj3/8A4A6depQq1YtPv74YwBefvnlgtecc845PPXUUwUt9M8//5ytW7fud14bN24suJj93HPP7ffrJY3t2gX5gx2qVYPnnw/973/+c7gwO2tW4XBHKXUq/KWgUaNGCS9Yzpw5k6ysLFq1akWHDh0YOHAgp5xyClDYx5+//fGPf9zrOapXr84tt9yy2wVegLZt29KnTx9at27NeeedV/D+EPryr776atq0acPWrVupXbs2AAMHDuTEE0+kbdu2tGzZkmuuueaAWuG33347d955JyeffLJa8bJvNm2C3/8+XHw988zCMfGffgr/+le4Jld0RI2UiTJbiKU0JVqIZdGiRbRQv95ebdmyhZo1awIwfPhwVq5cyRNPPBFxVonp95niNm2Cxx6DJ54INyt16QI33QTnnBOGMEqZ2NNCLKnTxy9xJkyYwEMPPUROTg5HH320umMkOrNnhyGXPXrA0KHhIq1ERoU/hfXp04c+ffpEnYakq08+gY8+giFDoHNn+OwzOP74qLMS1McvIqVtxw64807o0CF07ezcGfar6FcYKvwiUnrmzoV27WD48DDVwezZu09PIBWCunpEpHSsXx/ukK1ZE956C849N+qMZA9U+EXk4OTPeXPYYfDcc/CTn4T5cqTCUlfPQTAzLr/88oLnOTk51K9fn+7duwOwatUqunfvTuvWrTnxxBMLpnRYtmwZ1atX320c/5gxY+Le//TTT6f4MNby8MADDxTklZGRsc/3GuQbOHAgCxcuLOMspULYtAm6doX8OZp69VLRTwJq8R+E8piWOQpDhw5l6NChANSsWTMuz/w5vSvtYfz1M8WnwJXU9N13cN55YX6dK6+MOhvZD2rxH6T8aZmBgmmZ861cuXK3ycgOZlrmfMuWLeO0006jbdu2tG3blg8//LDgXJ06daJNmza0bNmSqVOnkpubS79+/WjZsiUnnXQSjz32GABz5syhffv2tGrVil69erF+/fp9Om/z5s35xS9+QcuWLfnmm2+49tprycrK4kc/+hH33HNPwbFFP6nUrFmToUOH0rp1a9q3b8+qVasO+mcgFcDSpdCxI3z+OfzjH1Dkk68kgUSrs1S0bZ9W4OrcOX77859DbOvWxPHRo0N89er42D6oUaOGz50713v37u3bt2/31q1b++TJkwtW4Hr77be9du3afvrpp/uwYcP822+/dffEK3B98MEHce/fuXNnnz59+m77tm7d6tu3b3d3988//9zzfzaPPPKIDxs2zN3dc3JyfNOmTT5jxgw/++yzC16bv2LXSSed5FOmTHF397vvvtuHDBmy1+8xP2cz848++qggtnbt2oLzde7c2efOnRuXN+Djxo1zd/fbbrvN77///oTn0QpcSWTNGvcmTdzr1nWfNi3qbGQv0ApcZaOsp2UuLjs7m8GDBzNnzhwyMjL4/PPPATjllFMYMGAA2dnZ9OzZkzZt2nDMMcewdOlSbrjhBrp160bXrl3ZuHEjGzZsoHPnzgBceeWVXHTRRft07qOPPpr27dsXPH/llVcYNWoUOTk5rFy5koULF8Z9qqlatWrBNY927doVrCAmSezww2HgQOjePcycKUkndQp/ik7LXNxjjz1GgwYNmDt3Lnl5eWRmZgJhls4PPviACRMm0K9fP26++WZ+8YtfMHfuXN555x1GjhzJK6+8UtDdcyCKTsn81Vdf8cgjjzB9+nQOO+ww+vXrx44dO+JeU6VKFSw2b7qmZE5yq1fD2rVhIfC77446GzkI6uMvBWU9LXNRGzdu5Mgjj6RSpUq88MIL5ObmAvD111/ToEEDrr76agYOHMisWbNYs2YNeXl59O7dm2HDhjFr1ixq167NYYcdVrBK2AsvvFDQ+t8fmzZtokaNGtSuXZtV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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter2_247_1.png" - }, - "needs_background": "light" - }, - "output_type": "display_data" - } - ], - "source": [ - "import os\n", - "import numpy as np\n", - "import pandas as pd\n", - "import matplotlib.pyplot as plt\n", - "from sklearn import linear_model\n", - "\n", - "def R2(y_data, y_model):\n", - " return 1 - np.sum((y_data - y_model) ** 2) / np.sum((y_data - np.mean(y_data)) ** 2)\n", - "def MSE(y_data,y_model):\n", - " n = np.size(y_model)\n", - " return np.sum((y_data-y_model)**2)/n\n", - "\n", - "\n", - "# A seed just to ensure that the random numbers are the same for every run.\n", - "# Useful for eventual debugging.\n", - "\n", - "X = np.array( [ [ 2, 0], [0, 1], [0,0]])\n", - "y = np.array( [4, 2, 3])\n", - "\n", - "\n", - "# matrix inversion to find beta\n", - "OLSbeta = np.linalg.inv(X.T @ X) @ X.T @ y\n", - "print(OLSbeta)\n", - "# and then make the prediction\n", - "ytildeOLS = X @ OLSbeta\n", - "print(\"Training MSE for OLS\")\n", - "print(MSE(y,ytildeOLS))\n", - "ypredictOLS = X @ OLSbeta\n", - "\n", - "# Repeat now for Ridge regression and various values of the regularization parameter\n", - "I = np.eye(2,2)\n", - "# Decide which values of lambda to use\n", - "nlambdas = 100\n", - "MSERidgePredict = np.zeros(nlambdas)\n", - "MSELassoPredict = np.zeros(nlambdas)\n", - "lambdas = np.logspace(-4, 4, nlambdas)\n", - "for i in range(nlambdas):\n", - " lmb = lambdas[i]\n", - " Ridgebeta = np.linalg.inv(X.T @ X+lmb*I) @ X.T @ y\n", - " print(Ridgebeta)\n", - " # and then make the prediction\n", - " ypredictRidge = X @ Ridgebeta\n", - " MSERidgePredict[i] = MSE(y,ypredictRidge)\n", - " RegLasso = linear_model.Lasso(lmb)\n", - " RegLasso.fit(X,y)\n", - " ypredictLasso = RegLasso.predict(X)\n", - " print(RegLasso.coef_)\n", - " MSELassoPredict[i] = MSE(y,ypredictLasso)\n", - "# Now plot the results\n", - "plt.figure()\n", - "plt.plot(np.log10(lambdas), MSERidgePredict, 'r--', label = 'MSE Ridge Train')\n", - "plt.plot(np.log10(lambdas), MSELassoPredict, 'r--', label = 'MSE Lasso Train')\n", - "plt.xlabel('log10(lambda)')\n", - "plt.ylabel('MSE')\n", - "plt.legend()\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We bring then back our exponential function example and study all\n", - "three regression methods. Depending on the level of noise, we note\n", - "that for small values of the hyperparameter $\\lambda$ all three\n", - "methods produce the same mean squared error. Again, Lasso shrinks the\n", - "parameter values to zero much earlier than Ridge regression and the\n", - "Lasso results flatten out much earlier since all $\\beta_j=0$ (check\n", - "this by printing the values). This case is an example of where OLS\n", - "performs best. Lasso and Ridge reproduce the OLS results for a limited\n", - "set of $\\lambda$ values." - ] - }, - { - "cell_type": "code", - "execution_count": 11, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "[ 2.03099776 -0.17917768 5.18029127]\n", - "Training MSE for OLS\n", - "0.009163470508352228\n", - "Test MSE OLS\n", - "0.008675369724976777\n" - ] - }, - { - "data": { - "image/png": "iVBORw0KGgoAAAANSUhEUgAAAX4AAAEKCAYAAAAVaT4rAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjMuMywgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/Il7ecAAAACXBIWXMAAAsTAAALEwEAmpwYAAA4aUlEQVR4nO3dd3hUZfbA8e9JIw2SkIRQAoQmJIQQSAIEpIggIBixgh0QWFcprsrqys+ya2PX3jsgLotigaULrkZUQOkISBEIEEQ6IUBIfX9/zBDSIJTM3MzM+TxPnszc95Yzk+Tknfe+91wxxqCUUspzeFkdgFJKKefSxK+UUh5GE79SSnkYTfxKKeVhNPErpZSH0cSvlFIexmGJX0Qmish+EVlfQduDImJEJMJRx1dKKVUxR/b4JwN9yy4UkYbAVcAuBx5bKaXUWTgs8RtjFgOHK2h6GfgroFeOKaWUBXyceTARuRbYY4xZKyLnvV1ERISJiYlxWFxKKeWOVq5cedAYE1l2udMSv4gEAo9iG+Y5n/VHAiMBGjVqxIoVKxwYnVJKuR8R2VnRcmfO6mkGNAHWikgGEA2sEpG6Fa1sjHnPGJNsjEmOjCz3D0sppdRFclqP3xjzC1Dn9HN78k82xhx0VgxKKaUcO51zGrAUaCkimSJyt6OOpZRS6vw5rMdvjLmlkvaYS9l/fn4+mZmZnDp16lJ2oyzm7+9PdHQ0vr6+VoeilMdw6qyeqpSZmUnNmjWJiYnhQmYIqerDGMOhQ4fIzMykSZMmVoejlMdw2ZINp06dIjw8XJO+CxMRwsPD9VObUk7msokf0KTvBvRnqJTzuXTiV0opt5STA19/DevWOWT3mvgvgYhw++23Fz8vKCggMjKSAQMGALBv3z4GDBhA27ZtiYuL4+qrrwYgIyODgIAAEhMTi7+mTJlSbv89evSgZcuWtG3blpSUFNasWVPcdvXVV3P06NFy2zz55JO88MILl/zajh49yltvvXVR254tNqXUebj5ZggNhd694c03HXIIlz25Wx0EBQWxfv16cnJyCAgIYNGiRTRo0KC4/fHHH6d3796MHTsWgHUl/ns3a9asVCI/m6lTp5KcnMykSZMYN24cixYtAmDevHlV+2LKOJ3477333nJtBQUF+Pic/VfH0bEp5TZ27oSPP4YffoD580EE4uOhcWPo2RO6dnXIYbXHf4muvvpq5s6dC8C0adO45ZYzs1j37t1LdHR08fOEhISLPk5qaip79uwpfh4TE8PBg7Zr35555hkuu+wyLr/8cjZv3ly8zvLly0lISCAxMZFx48YRHx8PQGFhIePGjSMlJYWEhATefffdcsd75JFH2LZtW/G26enpdO3albS0NOLi4gAYOHAgSUlJtG7dmvfee69cbBkZGcTGxjJixAhat27NVVddRU5OzkW/B0q5hYIC+OwzW2KPiYHHHrMN7Zz+lPz44/D889CvH3sLvcktKKzyENyix//32RvY+PuxKt1nXP1aPHFN60rXGzx4MP/4xz8YMGAA69atY9iwYXz//fcA3HfffQwaNIg33niDXr16MXToUOrXrw9QnFRPe/311+l6jv/uCxYsYODAgeWWr1y5kk8++YQ1a9ZQUFBA+/btSUpKAmDo0KG8//77pKam8sgjjxRv8+GHHxISEsLy5cvJzc2lS5cuXHXVVaWmVE6YMIH169cXfypJT09n1apVrF+/vni9iRMnUrt2bXJyckhJSeGGG24gPDy8VHxbt25l2rRpvP/++9x888188cUXpYbHlPI4M2fahnOaNIF//APuuMP2DwA4diqf77ccZMm2gyzZdogdB08wdXhHujSv2luXuEXit1JCQgIZGRlMmzateAz/tD59+rB9+3YWLFjA/PnzadeuHevX2+5Lc75DPbfddht5eXkcP368wvW///57rrvuOgIDAwFIS0sDbEM12dnZpKamAnDrrbcyZ84cABYuXMi6dev4/PPPAcjKymLr1q2VzqXv0KFDqXVee+01ZsyYAcDu3bvZunVrucTfpEmT4n9wSUlJZGRkVPqalXIrOTm2sfpatWDkSLj2Wpg9G/r1A29vDmTnMn9pBos27mPptkMUFBmCa/jQsUltbuvYiKaRQVUeklsk/vPpmTtSWloaDz30EOnp6Rw6dKhUW+3atbn11lu59dZbGTBgAIsXLy7ukZ+PqVOnkpSUxLhx4xg9ejRffvnlJcdrjOH111+nT58+F7RdUNCZX8D09HS+/vprli5dSmBgID169KhwPn6NGjWKH3t7e+tQj/IcxsCUKTB+POzZA7feakv8vr7k9u3H1xv288WqTL7bcoDCIkPTyCDu7tqE3rFRJDYMxcfbcSPxOsZfBYYNG8YTTzxBmzZtSi3/5ptvOHnyJADZ2dls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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter2_249_1.png" - }, - "needs_background": "light" - }, - "output_type": "display_data" - } - ], - "source": [ - "import os\n", - "import numpy as np\n", - "import pandas as pd\n", - "import matplotlib.pyplot as plt\n", - "from sklearn.model_selection import train_test_split\n", - "from sklearn import linear_model\n", - "\n", - "def R2(y_data, y_model):\n", - " return 1 - np.sum((y_data - y_model) ** 2) / np.sum((y_data - np.mean(y_data)) ** 2)\n", - "def MSE(y_data,y_model):\n", - " n = np.size(y_model)\n", - " return np.sum((y_data-y_model)**2)/n\n", - "\n", - "\n", - "# A seed just to ensure that the random numbers are the same for every run.\n", - "# Useful for eventual debugging.\n", - "np.random.seed(3155)\n", - "\n", - "x = np.random.rand(100)\n", - "y = 2.0+5*x*x+0.1*np.random.randn(100)\n", - "\n", - "# number of features p (here degree of polynomial\n", - "p = 3\n", - "# The design matrix now as function of a given polynomial\n", - "X = np.zeros((len(x),p))\n", - "X[:,0] = 1.0\n", - "X[:,1] = x\n", - "X[:,2] = x*x\n", - "# We split the data in test and training data\n", - "X_train, X_test, y_train, y_test = train_test_split(X, y, test_size=0.2)\n", - "\n", - "# matrix inversion to find beta\n", - "OLSbeta = np.linalg.inv(X_train.T @ X_train) @ X_train.T @ y_train\n", - "print(OLSbeta)\n", - "# and then make the prediction\n", - "ytildeOLS = X_train @ OLSbeta\n", - "print(\"Training MSE for OLS\")\n", - "print(MSE(y_train,ytildeOLS))\n", - "ypredictOLS = X_test @ OLSbeta\n", - "print(\"Test MSE OLS\")\n", - "print(MSE(y_test,ypredictOLS))\n", - "\n", - "# Repeat now for Lasso and Ridge regression and various values of the regularization parameter\n", - "I = np.eye(p,p)\n", - "# Decide which values of lambda to use\n", - "nlambdas = 100\n", - "MSEPredict = np.zeros(nlambdas)\n", - "MSETrain = np.zeros(nlambdas)\n", - "MSELassoPredict = np.zeros(nlambdas)\n", - "MSELassoTrain = np.zeros(nlambdas)\n", - "lambdas = np.logspace(-4, 4, nlambdas)\n", - "for i in range(nlambdas):\n", - " lmb = lambdas[i]\n", - " Ridgebeta = np.linalg.inv(X_train.T @ X_train+lmb*I) @ X_train.T @ y_train\n", - " # include lasso using Scikit-Learn\n", - " RegLasso = linear_model.Lasso(lmb)\n", - " RegLasso.fit(X_train,y_train)\n", - " # and then make the prediction\n", - " ytildeRidge = X_train @ Ridgebeta\n", - " ypredictRidge = X_test @ Ridgebeta\n", - " ytildeLasso = RegLasso.predict(X_train)\n", - " ypredictLasso = RegLasso.predict(X_test)\n", - " MSEPredict[i] = MSE(y_test,ypredictRidge)\n", - " MSETrain[i] = MSE(y_train,ytildeRidge)\n", - " MSELassoPredict[i] = MSE(y_test,ypredictLasso)\n", - " MSELassoTrain[i] = MSE(y_train,ytildeLasso)\n", - "\n", - "# Now plot the results\n", - "plt.figure()\n", - "plt.plot(np.log10(lambdas), MSETrain, label = 'MSE Ridge train')\n", - "plt.plot(np.log10(lambdas), MSEPredict, 'r--', label = 'MSE Ridge Test')\n", - "plt.plot(np.log10(lambdas), MSELassoTrain, label = 'MSE Lasso train')\n", - "plt.plot(np.log10(lambdas), MSELassoPredict, 'r--', label = 'MSE Lasso Test')\n", - "\n", - "plt.xlabel('log10(lambda)')\n", - "plt.ylabel('MSE')\n", - "plt.legend()\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Both these example send a clear message. The addition of a\n", - "shrinkage/regularization term implies that we need to perform a search\n", - "for the optimal values of $\\lambda$. We will see this throughout these\n", - "series of lectures.\n", - "\n", - "\n", - "As a small addendum, we note that you can also solve this problem using the convex optimization package [CVXOPT](https://cvxopt.org/examples/mlbook/l1regls.html). This requires, in addition to having installed **CVXOPT**, you need to download the file *l1regl.py*.\n", - "The following code example solves the simpler problem we discussed above, where we have added the latter python file." - ] - }, - { - "cell_type": "code", - "execution_count": 12, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "from cvxopt import matrix, spdiag, mul, div, sqrt, normal, setseed\n", - "from cvxopt import blas, lapack, solvers, sparse, spmatrix\n", - "import math\n", - "\n", - "try:\n", - " import mosek\n", - " import sys\n", - " __MOSEK = True\n", - "except: __MOSEK = False\n", - "\n", - "if __MOSEK:\n", - "\n", - " def l1regls_mosek(A, b):\n", - " \"\"\"\n", - "\n", - " Returns the solution of l1-norm regularized least-squares problem\n", - "\n", - " minimize || A*x - b ||_2^2 + e'*u\n", - "\n", - " subject to -u <= x <= u\n", - "\n", - " \"\"\"\n", - "\n", - " m, n = A.size\n", - "\n", - " env = mosek.Env()\n", - " task = env.Task(0,0)\n", - " task.set_Stream(mosek.streamtype.log, lambda x: sys.stdout.write(x))\n", - "\n", - " task.appendvars( 2*n) # number of variables\n", - " task.appendcons( 2*n) # number of constraints\n", - "\n", - " # input quadratic objective\n", - " Q = matrix(0.0, (n,n)) \n", - " blas.syrk(A, Q, alpha = 2.0, trans='T')\n", - "\n", - " I = []\n", - " for i in range(n):\n", - " I.extend(range(i,n))\n", - "\n", - " J = []\n", - " for i in range(n):\n", - " J.extend((n-i)*[i])\n", - "\n", - " task.putqobj(I, J, list(Q[matrix(I) + matrix(J)*n]))\n", - " task.putclist(range(2*n), list(-2*A.T*b) + n*[1.0]) # setup linear objective\n", - "\n", - " # input constraint matrix row by row\n", - " for i in range(n):\n", - " task.putarow( i, [i, n+i], [1.0, -1.0])\n", - " task.putarow( n+i, [i, n+i], [1.0, 1.0])\n", - "\n", - " # setup bounds on constraints\n", - " task.putboundslice(mosek.accmode.con,\n", - " 0, n, n*[mosek.boundkey.up], n*[0.0], n*[0.0])\n", - " task.putboundslice(mosek.accmode.con,\n", - " n, 2*n, n*[mosek.boundkey.lo], n*[0.0], n*[0.0])\n", - "\n", - " # setup variable bounds\n", - " task.putboundslice(mosek.accmode.var,\n", - " 0, 2*n, 2*n*[mosek.boundkey.fr], 2*n*[0.0], 2*n*[0.0])\n", - "\n", - " # optimize the task\n", - " task.putobjsense(mosek.objsense.minimize)\n", - " task.optimize()\n", - " task.solutionsummary(mosek.streamtype.log)\n", - " x = n*[0.0]\n", - " task.getsolutionslice(mosek.soltype.itr, mosek.solitem.xx, 0, n, x)\n", - "\n", - " return matrix(x)\n", - "\n", - " def l1regls_mosek2(A, b):\n", - " \"\"\"\n", - "\n", - " Returns the solution of l1-norm regularized least-squares problem\n", - "\n", - " minimize w'*w + e'*u\n", - "\n", - " subject to -u <= x <= u\n", - "\n", - " A*x - w = b\n", - "\n", - " \"\"\"\n", - "\n", - " m, n = A.size\n", - "\n", - " env = mosek.Env()\n", - " task = env.Task(0,0)\n", - " task.set_Stream(mosek.streamtype.log, lambda x: sys.stdout.write(x))\n", - "\n", - " task.appendvars(2*n + m) # number of variables\n", - " task.appendcons(2*n + m) # number of constraints\n", - "\n", - " # input quadratic objective\n", - " task.putqobj(range(2*n,2*n+m), range(2*n,2*n+m), m*[2.0])\n", - "\n", - " task.putclist(range(2*n+m), n*[0.0] + n*[1.0] + m*[0.0]) # setup linear objective\n", - "\n", - " # input constraint matrix row by row\n", - " for i in range(n):\n", - " task.putarow( i, [i, n+i], [1.0, -1.0])\n", - " task.putarow( n+i, [i, n+i], [1.0, 1.0])\n", - "\n", - " for i in range(m):\n", - " task.putarow( 2*n+i, range(n) + [2*n+i], list(A[i,:]) + [-1.0])\n", - "\n", - " # setup bounds on constraints\n", - " task.putboundslice(mosek.accmode.con,\n", - " 0, n, n*[mosek.boundkey.up], n*[0.0], n*[0.0])\n", - " task.putboundslice(mosek.accmode.con,\n", - " n, 2*n, n*[mosek.boundkey.lo], n*[0.0], n*[0.0])\n", - " task.putboundslice(mosek.accmode.con,\n", - " 2*n, 2*n+m, m*[mosek.boundkey.fx], list(b), list(b))\n", - "\n", - " # setup variable bounds\n", - " task.putboundslice(mosek.accmode.var, 0, 2*n+m, (2*n+m)*[mosek.boundkey.fr], \n", - " (2*n+m)*[0.0], (2*n+m)*[0.0])\n", - "\n", - " # optimize the task\n", - " task.putobjsense(mosek.objsense.minimize)\n", - " task.optimize()\n", - " task.solutionsummary(mosek.streamtype.log)\n", - " x = n*[0.0]\n", - " task.getsolutionslice(mosek.soltype.itr, mosek.solitem.xx, 0, n, x)\n", - "\n", - " return matrix(x)\n", - "\n", - "def l1regls(A, b):\n", - " \"\"\"\n", - " \n", - " Returns the solution of l1-norm regularized least-squares problem\n", - " \n", - " minimize || A*x - b ||_2^2 + || x ||_1.\n", - "\n", - " \"\"\"\n", - "\n", - " m, n = A.size\n", - " q = matrix(1.0, (2*n,1))\n", - " q[:n] = -2.0 * A.T * b\n", - "\n", - " def P(u, v, alpha = 1.0, beta = 0.0 ):\n", - " \"\"\"\n", - " v := alpha * 2.0 * [ A'*A, 0; 0, 0 ] * u + beta * v \n", - " \"\"\"\n", - " v *= beta\n", - " v[:n] += alpha * 2.0 * A.T * (A * u[:n])\n", - "\n", - "\n", - " def G(u, v, alpha=1.0, beta=0.0, trans='N'):\n", - " \"\"\"\n", - " v := alpha*[I, -I; -I, -I] * u + beta * v (trans = 'N' or 'T')\n", - " \"\"\"\n", - "\n", - " v *= beta\n", - " v[:n] += alpha*(u[:n] - u[n:])\n", - " v[n:] += alpha*(-u[:n] - u[n:])\n", - "\n", - " h = matrix(0.0, (2*n,1))\n", - "\n", - "\n", - " # Customized solver for the KKT system \n", - " #\n", - " # [ 2.0*A'*A 0 I -I ] [x[:n] ] [bx[:n] ]\n", - " # [ 0 0 -I -I ] [x[n:] ] = [bx[n:] ].\n", - " # [ I -I -D1^-1 0 ] [zl[:n]] [bzl[:n]]\n", - " # [ -I -I 0 -D2^-1 ] [zl[n:]] [bzl[n:]]\n", - " #\n", - " # where D1 = W['di'][:n]**2, D2 = W['di'][:n]**2.\n", - " # \n", - " # We first eliminate zl and x[n:]:\n", - " #\n", - " # ( 2*A'*A + 4*D1*D2*(D1+D2)^-1 ) * x[:n] = \n", - " # bx[:n] - (D2-D1)*(D1+D2)^-1 * bx[n:] + \n", - " # D1 * ( I + (D2-D1)*(D1+D2)^-1 ) * bzl[:n] - \n", - " # D2 * ( I - (D2-D1)*(D1+D2)^-1 ) * bzl[n:] \n", - " #\n", - " # x[n:] = (D1+D2)^-1 * ( bx[n:] - D1*bzl[:n] - D2*bzl[n:] ) \n", - " # - (D2-D1)*(D1+D2)^-1 * x[:n] \n", - " #\n", - " # zl[:n] = D1 * ( x[:n] - x[n:] - bzl[:n] )\n", - " # zl[n:] = D2 * (-x[:n] - x[n:] - bzl[n:] ).\n", - " #\n", - " # The first equation has the form\n", - " #\n", - " # (A'*A + D)*x[:n] = rhs\n", - " #\n", - " # and is equivalent to\n", - " #\n", - " # [ D A' ] [ x:n] ] = [ rhs ]\n", - " # [ A -I ] [ v ] [ 0 ].\n", - " #\n", - " # It can be solved as \n", - " #\n", - " # ( A*D^-1*A' + I ) * v = A * D^-1 * rhs\n", - " # x[:n] = D^-1 * ( rhs - A'*v ).\n", - "\n", - " S = matrix(0.0, (m,m))\n", - " Asc = matrix(0.0, (m,n))\n", - " v = matrix(0.0, (m,1))\n", - "\n", - " def Fkkt(W):\n", - "\n", - " # Factor \n", - " #\n", - " # S = A*D^-1*A' + I \n", - " #\n", - " # where D = 2*D1*D2*(D1+D2)^-1, D1 = d[:n]**-2, D2 = d[n:]**-2.\n", - "\n", - " d1, d2 = W['di'][:n]**2, W['di'][n:]**2\n", - "\n", - " # ds is square root of diagonal of D\n", - " ds = math.sqrt(2.0) * div( mul( W['di'][:n], W['di'][n:]), \n", - " sqrt(d1+d2) )\n", - " d3 = div(d2 - d1, d1 + d2)\n", - " \n", - " # Asc = A*diag(d)^-1/2\n", - " Asc = A * spdiag(ds**-1)\n", - "\n", - " # S = I + A * D^-1 * A'\n", - " blas.syrk(Asc, S)\n", - " S[::m+1] += 1.0 \n", - " lapack.potrf(S)\n", - "\n", - " def g(x, y, z):\n", - "\n", - " x[:n] = 0.5 * ( x[:n] - mul(d3, x[n:]) + \n", - " mul(d1, z[:n] + mul(d3, z[:n])) - mul(d2, z[n:] - \n", - " mul(d3, z[n:])) )\n", - " x[:n] = div( x[:n], ds) \n", - "\n", - " # Solve\n", - " #\n", - " # S * v = 0.5 * A * D^-1 * ( bx[:n] - \n", - " # (D2-D1)*(D1+D2)^-1 * bx[n:] + \n", - " # D1 * ( I + (D2-D1)*(D1+D2)^-1 ) * bzl[:n] - \n", - " # D2 * ( I - (D2-D1)*(D1+D2)^-1 ) * bzl[n:] )\n", - " \n", - " blas.gemv(Asc, x, v)\n", - " lapack.potrs(S, v)\n", - " \n", - " # x[:n] = D^-1 * ( rhs - A'*v ).\n", - " blas.gemv(Asc, v, x, alpha=-1.0, beta=1.0, trans='T')\n", - " x[:n] = div(x[:n], ds)\n", - "\n", - " # x[n:] = (D1+D2)^-1 * ( bx[n:] - D1*bzl[:n] - D2*bzl[n:] ) \n", - " # - (D2-D1)*(D1+D2)^-1 * x[:n] \n", - " x[n:] = div( x[n:] - mul(d1, z[:n]) - mul(d2, z[n:]), d1+d2 )\\\n", - " - mul( d3, x[:n] )\n", - " \n", - " # zl[:n] = D1^1/2 * ( x[:n] - x[n:] - bzl[:n] )\n", - " # zl[n:] = D2^1/2 * ( -x[:n] - x[n:] - bzl[n:] ).\n", - " z[:n] = mul( W['di'][:n], x[:n] - x[n:] - z[:n] ) \n", - " z[n:] = mul( W['di'][n:], -x[:n] - x[n:] - z[n:] ) \n", - "\n", - " return g\n", - "\n", - " return solvers.coneqp(P, q, G, h, kktsolver = Fkkt)['x'][:n]" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Then we call the above functions and solve the problem, as done here" - ] - }, - { - "cell_type": "code", - "execution_count": 13, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - " pcost dcost gap pres dres\n", - " 0: -2.7070e+01 -1.6544e+01 2e+01 6e+00 2e-01\n", - " 1: -2.2433e+01 -2.4632e+01 2e+00 9e-16 1e-16\n", - " 2: -2.4140e+01 -2.4332e+01 2e-01 1e-15 3e-16\n", - " 3: -2.4200e+01 -2.4203e+01 2e-03 5e-16 2e-15\n", - " 4: -2.4201e+01 -2.4201e+01 2e-05 9e-16 6e-16\n", - "Optimal solution found.\n" - ] - } - ], - "source": [ - "from cvxopt import matrix, normal\n", - "\n", - "X = matrix( [ [ 2, 0, 1], [0, 1, 3]])\n", - "y = matrix( [4, 2, 3])\n", - "x = l1regls(X,y)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "**More text will be added to this example.**\n", - "\n", - "## Linking the regression analysis with a statistical interpretation\n", - "\n", - "We will now couple the discussions of ordinary least squares, Ridge\n", - "and Lasso regression with a statistical interpretation, that is we\n", - "move from a linear algebra analysis to a statistical analysis. In\n", - "particular, we will focus on what the regularization terms can result\n", - "in. We will amongst other things show that the regularization\n", - "parameter can reduce considerably the variance of the parameters\n", - "$\\beta$.\n", - "\n", - "\n", - "The\n", - "advantage of doing linear regression is that we actually end up with\n", - "analytical expressions for several statistical quantities. \n", - "Standard least squares and Ridge regression allow us to\n", - "derive quantities like the variance and other expectation values in a\n", - "rather straightforward way.\n", - "\n", - "\n", - "It is assumed that $\\varepsilon_i\n", - "\\sim \\mathcal{N}(0, \\sigma^2)$ and the $\\varepsilon_{i}$ are\n", - "independent, i.e.:" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{align*} \n", - "\\mbox{Cov}(\\varepsilon_{i_1},\n", - "\\varepsilon_{i_2}) & = \\left\\{ \\begin{array}{lcc} \\sigma^2 & \\mbox{if}\n", - "& i_1 = i_2, \\\\ 0 & \\mbox{if} & i_1 \\not= i_2. \\end{array} \\right.\n", - "\\end{align*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The randomness of $\\varepsilon_i$ implies that\n", - "$\\mathbf{y}_i$ is also a random variable. In particular,\n", - "$\\mathbf{y}_i$ is normally distributed, because $\\varepsilon_i \\sim\n", - "\\mathcal{N}(0, \\sigma^2)$ and $\\mathbf{X}_{i,\\ast} \\, \\boldsymbol{\\beta}$ is a\n", - "non-random scalar. To specify the parameters of the distribution of\n", - "$\\mathbf{y}_i$ we need to calculate its first two moments. \n", - "\n", - "Recall that $\\boldsymbol{X}$ is a matrix of dimensionality $n\\times p$. The\n", - "notation above $\\mathbf{X}_{i,\\ast}$ means that we are looking at the\n", - "row number $i$ and perform a sum over all values $p$.\n", - "\n", - "\n", - "\n", - "The assumption we have made here can be summarized as (and this is going to be useful when we discuss the bias-variance trade off)\n", - "that there exists a function $f(\\boldsymbol{x})$ and a normal distributed error $\\boldsymbol{\\varepsilon}\\sim \\mathcal{N}(0, \\sigma^2)$\n", - "which describe our data" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{y} = f(\\boldsymbol{x})+\\boldsymbol{\\varepsilon}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We approximate this function with our model from the solution of the linear regression equations, that is our\n", - "function $f$ is approximated by $\\boldsymbol{\\tilde{y}}$ where we want to minimize $(\\boldsymbol{y}-\\boldsymbol{\\tilde{y}})^2$, our MSE, with" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{\\tilde{y}} = \\boldsymbol{X}\\boldsymbol{\\beta}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We can calculate the expectation value of $\\boldsymbol{y}$ for a given element $i$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{align*} \n", - "\\mathbb{E}(y_i) & =\n", - "\\mathbb{E}(\\mathbf{X}_{i, \\ast} \\, \\boldsymbol{\\beta}) + \\mathbb{E}(\\varepsilon_i)\n", - "\\, \\, \\, = \\, \\, \\, \\mathbf{X}_{i, \\ast} \\, \\beta, \n", - "\\end{align*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "while\n", - "its variance is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{align*} \\mbox{Var}(y_i) & = \\mathbb{E} \\{ [y_i\n", - "- \\mathbb{E}(y_i)]^2 \\} \\, \\, \\, = \\, \\, \\, \\mathbb{E} ( y_i^2 ) -\n", - "[\\mathbb{E}(y_i)]^2 \\\\ & = \\mathbb{E} [ ( \\mathbf{X}_{i, \\ast} \\,\n", - "\\beta + \\varepsilon_i )^2] - ( \\mathbf{X}_{i, \\ast} \\, \\boldsymbol{\\beta})^2 \\\\ &\n", - "= \\mathbb{E} [ ( \\mathbf{X}_{i, \\ast} \\, \\boldsymbol{\\beta})^2 + 2 \\varepsilon_i\n", - "\\mathbf{X}_{i, \\ast} \\, \\boldsymbol{\\beta} + \\varepsilon_i^2 ] - ( \\mathbf{X}_{i,\n", - "\\ast} \\, \\beta)^2 \\\\ & = ( \\mathbf{X}_{i, \\ast} \\, \\boldsymbol{\\beta})^2 + 2\n", - "\\mathbb{E}(\\varepsilon_i) \\mathbf{X}_{i, \\ast} \\, \\boldsymbol{\\beta} +\n", - "\\mathbb{E}(\\varepsilon_i^2 ) - ( \\mathbf{X}_{i, \\ast} \\, \\boldsymbol{\\beta})^2 \n", - "\\\\ & = \\mathbb{E}(\\varepsilon_i^2 ) \\, \\, \\, = \\, \\, \\,\n", - "\\mbox{Var}(\\varepsilon_i) \\, \\, \\, = \\, \\, \\, \\sigma^2. \n", - "\\end{align*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Hence, $y_i \\sim \\mathcal{N}( \\mathbf{X}_{i, \\ast} \\, \\boldsymbol{\\beta}, \\sigma^2)$, that is $\\boldsymbol{y}$ follows a normal distribution with \n", - "mean value $\\boldsymbol{X}\\boldsymbol{\\beta}$ and variance $\\sigma^2$ (not be confused with the singular values of the SVD). \n", - "\n", - "\n", - "With the OLS expressions for the parameters $\\boldsymbol{\\beta}$ we can evaluate the expectation value" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbb{E}(\\boldsymbol{\\beta}) = \\mathbb{E}[ (\\mathbf{X}^{\\top} \\mathbf{X})^{-1}\\mathbf{X}^{T} \\mathbf{Y}]=(\\mathbf{X}^{T} \\mathbf{X})^{-1}\\mathbf{X}^{T} \\mathbb{E}[ \\mathbf{Y}]=(\\mathbf{X}^{T} \\mathbf{X})^{-1} \\mathbf{X}^{T}\\mathbf{X}\\boldsymbol{\\beta}=\\boldsymbol{\\beta}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "This means that the estimator of the regression parameters is unbiased.\n", - "\n", - "We can also calculate the variance\n", - "\n", - "The variance of $\\boldsymbol{\\beta}$ is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{eqnarray*}\n", - "\\mbox{Var}(\\boldsymbol{\\beta}) & = & \\mathbb{E} \\{ [\\boldsymbol{\\beta} - \\mathbb{E}(\\boldsymbol{\\beta})] [\\boldsymbol{\\beta} - \\mathbb{E}(\\boldsymbol{\\beta})]^{T} \\}\n", - "\\\\\n", - "& = & \\mathbb{E} \\{ [(\\mathbf{X}^{T} \\mathbf{X})^{-1} \\, \\mathbf{X}^{T} \\mathbf{Y} - \\boldsymbol{\\beta}] \\, [(\\mathbf{X}^{T} \\mathbf{X})^{-1} \\, \\mathbf{X}^{T} \\mathbf{Y} - \\boldsymbol{\\beta}]^{T} \\}\n", - "\\\\\n", - "% & = & \\mathbb{E} \\{ [(\\mathbf{X}^{T} \\mathbf{X})^{-1} \\, \\mathbf{X}^{T} \\mathbf{Y}] \\, [(\\mathbf{X}^{T} \\mathbf{X})^{-1} \\, \\mathbf{X}^{T} \\mathbf{Y}]^{T} \\} - \\boldsymbol{\\beta} \\, \\boldsymbol{\\beta}^{T}\n", - "% \\\\\n", - "% & = & \\mathbb{E} \\{ (\\mathbf{X}^{T} \\mathbf{X})^{-1} \\, \\mathbf{X}^{T} \\mathbf{Y} \\, \\mathbf{Y}^{T} \\, \\mathbf{X} \\, (\\mathbf{X}^{T} \\mathbf{X})^{-1} \\} - \\boldsymbol{\\beta} \\, \\boldsymbol{\\beta}^{T}\n", - "% \\\\\n", - "& = & (\\mathbf{X}^{T} \\mathbf{X})^{-1} \\, \\mathbf{X}^{T} \\, \\mathbb{E} \\{ \\mathbf{Y} \\, \\mathbf{Y}^{T} \\} \\, \\mathbf{X} \\, (\\mathbf{X}^{T} \\mathbf{X})^{-1} - \\boldsymbol{\\beta} \\, \\boldsymbol{\\beta}^{T}\n", - "\\\\\n", - "& = & (\\mathbf{X}^{T} \\mathbf{X})^{-1} \\, \\mathbf{X}^{T} \\, \\{ \\mathbf{X} \\, \\boldsymbol{\\beta} \\, \\boldsymbol{\\beta}^{T} \\, \\mathbf{X}^{T} + \\sigma^2 \\} \\, \\mathbf{X} \\, (\\mathbf{X}^{T} \\mathbf{X})^{-1} - \\boldsymbol{\\beta} \\, \\boldsymbol{\\beta}^{T}\n", - "% \\\\\n", - "% & = & (\\mathbf{X}^T \\mathbf{X})^{-1} \\, \\mathbf{X}^T \\, \\mathbf{X} \\, \\boldsymbol{\\beta} \\, \\boldsymbol{\\beta}^T \\, \\mathbf{X}^T \\, \\mathbf{X} \\, (\\mathbf{X}^T % \\mathbf{X})^{-1}\n", - "% \\\\\n", - "% & & + \\, \\, \\sigma^2 \\, (\\mathbf{X}^T \\mathbf{X})^{-1} \\, \\mathbf{X}^T \\, \\mathbf{X} \\, (\\mathbf{X}^T \\mathbf{X})^{-1} - \\boldsymbol{\\beta} \\boldsymbol{\\beta}^T\n", - "\\\\\n", - "& = & \\boldsymbol{\\beta} \\, \\boldsymbol{\\beta}^{T} + \\sigma^2 \\, (\\mathbf{X}^{T} \\mathbf{X})^{-1} - \\boldsymbol{\\beta} \\, \\boldsymbol{\\beta}^{T}\n", - "\\, \\, \\, = \\, \\, \\, \\sigma^2 \\, (\\mathbf{X}^{T} \\mathbf{X})^{-1},\n", - "\\end{eqnarray*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where we have used that $\\mathbb{E} (\\mathbf{Y} \\mathbf{Y}^{T}) =\n", - "\\mathbf{X} \\, \\boldsymbol{\\beta} \\, \\boldsymbol{\\beta}^{T} \\, \\mathbf{X}^{T} +\n", - "\\sigma^2 \\, \\mathbf{I}_{nn}$. From $\\mbox{Var}(\\boldsymbol{\\beta}) = \\sigma^2\n", - "\\, (\\mathbf{X}^{T} \\mathbf{X})^{-1}$, one obtains an estimate of the\n", - "variance of the estimate of the $j$-th regression coefficient:\n", - "$\\boldsymbol{\\sigma}^2 (\\boldsymbol{\\beta}_j ) = \\boldsymbol{\\sigma}^2 [(\\mathbf{X}^{T} \\mathbf{X})^{-1}]_{jj} $. This may be used to\n", - "construct a confidence interval for the estimates.\n", - "\n", - "\n", - "In a similar way, we can obtain analytical expressions for say the\n", - "expectation values of the parameters $\\boldsymbol{\\beta}$ and their variance\n", - "when we employ Ridge regression, allowing us again to define a confidence interval. \n", - "\n", - "It is rather straightforward to show that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbb{E} \\big[ \\boldsymbol{\\beta}^{\\mathrm{Ridge}} \\big]=(\\mathbf{X}^{T} \\mathbf{X} + \\lambda \\mathbf{I}_{pp})^{-1} (\\mathbf{X}^{\\top} \\mathbf{X})\\boldsymbol{\\beta}^{\\mathrm{OLS}}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We see clearly that \n", - "$\\mathbb{E} \\big[ \\boldsymbol{\\beta}^{\\mathrm{Ridge}} \\big] \\not= \\boldsymbol{\\beta}^{\\mathrm{OLS}}$ for any $\\lambda > 0$. We say then that the ridge estimator is biased.\n", - "\n", - "We can also compute the variance as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mbox{Var}[\\boldsymbol{\\beta}^{\\mathrm{Ridge}}]=\\sigma^2[ \\mathbf{X}^{T} \\mathbf{X} + \\lambda \\mathbf{I} ]^{-1} \\mathbf{X}^{T} \\mathbf{X} \\{ [ \\mathbf{X}^{\\top} \\mathbf{X} + \\lambda \\mathbf{I} ]^{-1}\\}^{T},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and it is easy to see that if the parameter $\\lambda$ goes to infinity then the variance of Ridge parameters $\\boldsymbol{\\beta}$ goes to zero. \n", - "\n", - "With this, we can compute the difference" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mbox{Var}[\\boldsymbol{\\beta}^{\\mathrm{OLS}}]-\\mbox{Var}(\\boldsymbol{\\beta}^{\\mathrm{Ridge}})=\\sigma^2 [ \\mathbf{X}^{T} \\mathbf{X} + \\lambda \\mathbf{I} ]^{-1}[ 2\\lambda\\mathbf{I} + \\lambda^2 (\\mathbf{X}^{T} \\mathbf{X})^{-1} ] \\{ [ \\mathbf{X}^{T} \\mathbf{X} + \\lambda \\mathbf{I} ]^{-1}\\}^{T}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The difference is non-negative definite since each component of the\n", - "matrix product is non-negative definite. \n", - "This means the variance we obtain with the standard OLS will always for $\\lambda > 0$ be larger than the variance of $\\boldsymbol{\\beta}$ obtained with the Ridge estimator. This has interesting consequences when we discuss the so-called bias-variance trade-off below. \n", - "\n", - "\n", - "\n", - "## Deriving OLS from a probability distribution\n", - "\n", - "Our basic assumption when we derived the OLS equations was to assume\n", - "that our output is determined by a given continuous function\n", - "$f(\\boldsymbol{x})$ and a random noise $\\boldsymbol{\\epsilon}$ given by the normal\n", - "distribution with zero mean value and an undetermined variance\n", - "$\\sigma^2$.\n", - "\n", - "We found above that the outputs $\\boldsymbol{y}$ have a mean value given by\n", - "$\\boldsymbol{X}\\hat{\\boldsymbol{\\beta}}$ and variance $\\sigma^2$. Since the entries to\n", - "the design matrix are not stochastic variables, we can assume that the\n", - "probability distribution of our targets is also a normal distribution\n", - "but now with mean value $\\boldsymbol{X}\\hat{\\boldsymbol{\\beta}}$. This means that a\n", - "single output $y_i$ is given by the Gaussian distribution" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "y_i\\sim \\mathcal{N}(\\boldsymbol{X}_{i,*}\\boldsymbol{\\beta}, \\sigma^2)=\\frac{1}{\\sqrt{2\\pi\\sigma^2}}\\exp{\\left[-\\frac{(y_i-\\boldsymbol{X}_{i,*}\\boldsymbol{\\beta})^2}{2\\sigma^2}\\right]}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We assume now that the various $y_i$ values are stochastically distributed according to the above Gaussian distribution. \n", - "We define this distribution as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(y_i, \\boldsymbol{X}\\vert\\boldsymbol{\\beta})=\\frac{1}{\\sqrt{2\\pi\\sigma^2}}\\exp{\\left[-\\frac{(y_i-\\boldsymbol{X}_{i,*}\\boldsymbol{\\beta})^2}{2\\sigma^2}\\right]},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which reads as finding the likelihood of an event $y_i$ with the input variables $\\boldsymbol{X}$ given the parameters (to be determined) $\\boldsymbol{\\beta}$.\n", - "\n", - "Since these events are assumed to be independent and identicall distributed we can build the probability distribution function (PDF) for all possible event $\\boldsymbol{y}$ as the product of the single events, that is we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(\\boldsymbol{y},\\boldsymbol{X}\\vert\\boldsymbol{\\beta})=\\prod_{i=0}^{n-1}\\frac{1}{\\sqrt{2\\pi\\sigma^2}}\\exp{\\left[-\\frac{(y_i-\\boldsymbol{X}_{i,*}\\boldsymbol{\\beta})^2}{2\\sigma^2}\\right]}=\\prod_{i=0}^{n-1}p(y_i,\\boldsymbol{X}\\vert\\boldsymbol{\\beta}).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We will write this in a more compact form reserving $\\boldsymbol{D}$ for the domain of events, including the ouputs (targets) and the inputs. That is\n", - "in case we have a simple one-dimensional input and output case" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{D}=[(x_0,y_0), (x_1,y_1),\\dots, (x_{n-1},y_{n-1})].\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In the more general case the various inputs should be replaced by the possible features represented by the input data set $\\boldsymbol{X}$. \n", - "We can now rewrite the above probability as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(\\boldsymbol{D}\\vert\\boldsymbol{\\beta})=\\prod_{i=0}^{n-1}\\frac{1}{\\sqrt{2\\pi\\sigma^2}}\\exp{\\left[-\\frac{(y_i-\\boldsymbol{X}_{i,*}\\boldsymbol{\\beta})^2}{2\\sigma^2}\\right]}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "It is a conditional probability (see below) and reads as the\n", - "likelihood of a domain of events $\\boldsymbol{D}$ given a set of parameters\n", - "$\\boldsymbol{\\beta}$.\n", - "\n", - "\n", - "In statistics, maximum likelihood estimation (MLE) is a method of\n", - "estimating the parameters of an assumed probability distribution,\n", - "given some observed data. This is achieved by maximizing a likelihood\n", - "function so that, under the assumed statistical model, the observed\n", - "data is the most probable. \n", - "\n", - "\n", - "We will assume here that our events are given by the above Gaussian\n", - "distribution and we will determine the optimal parameters $\\beta$ by\n", - "maximizing the above PDF. However, computing the derivatives of a\n", - "product function is cumbersome and can easily lead to overflow and/or\n", - "underflowproblems, with potentials for loss of numerical precision.\n", - "\n", - "\n", - "In practice, it is more convenient to maximize the logarithm of the\n", - "PDF because it is a monotonically increasing function of the argument.\n", - "Alternatively, and this will be our option, we will minimize the\n", - "negative of the logarithm since this is a monotonically decreasing\n", - "function.\n", - "\n", - "Note also that maximization/minimization of the logarithm of the PDF\n", - "is equivalent to the maximization/minimization of the function itself.\n", - "\n", - "\n", - "\n", - "\n", - "We could now define a new cost function to minimize, namely the negative logarithm of the above PDF" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(\\boldsymbol{\\beta}=-\\log{\\prod_{i=0}^{n-1}p(y_i,\\boldsymbol{X}\\vert\\boldsymbol{\\beta})}=-\\sum_{i=0}^{n-1}\\log{p(y_i,\\boldsymbol{X}\\vert\\boldsymbol{\\beta})},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which becomes" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(\\boldsymbol{\\beta}=\\frac{n}{2}\\log{2\\pi\\sigma^2}+\\frac{\\vert\\vert (\\boldsymbol{y}-\\boldsymbol{X}\\boldsymbol{\\beta})\\vert\\vert_2^2}{2\\sigma^2}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Taking the derivative of the *new* cost function with respect to the parameters $\\beta$ we recognize our familiar OLS equation, namely" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}^T\\left(\\boldsymbol{y}-\\boldsymbol{X}\\boldsymbol{\\beta}\\right) =0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which leads to the well-known OLS equation for the optimal paramters $\\beta$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\hat{\\boldsymbol{\\beta}}^{\\mathrm{OLS}}=\\left(\\boldsymbol{X}^T\\boldsymbol{X}\\right)^{-1}\\boldsymbol{X}^T\\boldsymbol{y}!\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Before we make a similar analysis for Ridge and Lasso regression, we need a short reminder on statistics. \n", - "\n", - "\n", - "A central theorem in statistics is Bayes' theorem. This theorem plays a similar role as the good old Pythagoras' theorem in geometry.\n", - "Bayes' theorem is extremely simple to derive. But to do so we need some basic axioms from statistics.\n", - "\n", - "Assume we have two domains of events $X=[x_0,x_1,\\dots,x_{n-1}]$ and $Y=[y_0,y_1,\\dots,y_{n-1}]$.\n", - "\n", - "We define also the likelihood for $X$ and $Y$ as $p(X)$ and $p(Y)$ respectively.\n", - "The likelihood of a specific event $x_i$ (or $y_i$) is then written as $p(X=x_i)$ or just $p(x_i)=p_i$. \n", - "\n", - "The union of events is given by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(X \\cup Y)= p(X)+p(Y)-p(X \\cap Y).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The product rule (aka joint probability) is given by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(X \\cup Y)= p(X,Y)= p(X\\vert Y)p(Y)=p(Y\\vert X)p(X),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where we read $p(X\\vert Y)$ as the likelihood of obtaining $X$ given $Y$.\n", - "\n", - "If we have independent events then $p(X,Y)=p(X)p(Y)$.\n", - "\n", - "\n", - "\n", - "The marginal probability is defined in terms of only one of the set of variables $X,Y$. For a discrete probability we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(X)=\\sum_{i=0}^{n-1}p(X,Y=y_i)=\\sum_{i=0}^{n-1}p(X\\vert Y=y_i)p(Y=y_i)=\\sum_{i=0}^{n-1}p(X\\vert y_i)p(y_i).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The conditional probability, if $p(Y) > 0$, is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(X\\vert Y)= \\frac{p(X,Y)}{p(Y)}=\\frac{p(X,Y)}{\\sum_{i=0}^{n-1}p(Y\\vert X=x_i)p(x_i)}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "If we combine the conditional probability with the marginal probability and the standard product rule, we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(X\\vert Y)= \\frac{p(X,Y)}{p(Y)},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which we can rewrite as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(X\\vert Y)= \\frac{p(X,Y)}{\\sum_{i=0}^{n-1}p(Y\\vert X=x_i)p(x_i)}=\\frac{p(Y\\vert X)p(X)}{\\sum_{i=0}^{n-1}p(Y\\vert X=x_i)p(x_i)},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which is Bayes' theorem. It allows us to evaluate the uncertainty in in $X$ after we have observed $Y$. We can easily interchange $X$ with $Y$. \n", - "\n", - "\n", - "The quantity $p(Y\\vert X)$ on the right-hand side of the theorem is\n", - "evaluated for the observed data $Y$ and can be viewed as a function of\n", - "the parameter space represented by $X$. This function is not\n", - "necesseraly normalized and is normally called the likelihood function.\n", - "\n", - "The function $p(X)$ on the right hand side is called the prior while\n", - "the function on the left hand side is the called the posterior\n", - "probability. The denominator on the right hand side serves as a\n", - "normalization factor for the posterior distribution.\n", - "\n", - "Let us try to illustrate Bayes' theorem through an example.\n", - "\n", - "\n", - "Let us suppose that you are undergoing a series of mammography scans\n", - "in order to rule out possible breast cancer cases. We define the\n", - "sensitivity for a positive event by the variable $X$. It takes binary\n", - "values with $X=1$ representing a positive event and $X=0$ being a\n", - "negative event. We reserve $Y$ as a classification parameter for\n", - "either a negative or a positive breast cancer confirmation. (Short\n", - "note on wordings: positive here means having breast cancer, although\n", - "none of us would consider this being a positive thing).\n", - "\n", - "We let $Y=1$ represent the the case of having breast cancer and $Y=0$ as not.\n", - "\n", - "Let us assume that if you have breast cancer, the test will be positive with a probability of $0.8$ (the numbers here are all made up),\n", - "that is we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(X=1\\vert Y=1) =0.8.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "This obviously sounds scary since many would conclude that if the test\n", - "is positive, there is a likelihood of $80\\%$ for having cancer. It is\n", - "however not correct, as the following Bayesian analysis shows. The correct question to pose is *what is the probability of having breast cancer in case of a positive test?*\n", - "We are thus interested in" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(Y=1\\vert X=1),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "instead of $p(X=1\\vert Y=1)$.\n", - "\n", - "\n", - "\n", - "If we look at various national surveys on breast cancer, the general\n", - "likelihood of developing breast cancer is a very small number. Let us\n", - "assume that the prior probability in the population as a whole is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(Y=1) =0.004.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We need also to account for the fact that the test may produce a false\n", - "positive result (false alarm). Let us here assume that we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(X=1\\vert Y=0) =0.1.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Using Bayes' theorem we can then find the posterior probability that\n", - "the person has breast cancer in case of a positive test, that is we\n", - "can compute" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - "p(Y=1\\vert X=1)=\\frac{p(X=1\\vert Y=1)p(Y=1)}{p(X=1\\vert Y=1)p(Y=1)+p(X=1\\vert Y=0)p(Y=0)}= \n", - "\\label{_auto2} \\tag{2}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation} \n", - " \\frac{0.8\\times 0.004}{0.8\\times 0.004+0.1\\times 0.996}=0.031.\n", - "\\label{_auto3} \\tag{3}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "That is, in case of a positive test, there is only a $3\\%$ chance of having breast cancer!\n", - "\n", - "\n", - "\n", - "## Bayes' Theorem and Ridge and Lasso Regression\n", - "\n", - "Hitherto we have discussed Ridge and Lasso regression in terms of a\n", - "linear analysis. This may to many of you feel rather technical and\n", - "perhaps not that intuitive. The question is whether we can develop a\n", - "more intuitive way of understanding what Ridge and Lasso express.\n", - "\n", - "Before we proceed let us perform a Ridge, Lasso and OLS analysis of a polynomial fit. \n", - "\n", - "\n", - "We will play around with a study of the values for the optimal\n", - "parameters $\\boldsymbol{\\beta}$ using OLS, Ridge and Lasso regression. For\n", - "OLS, you will notice as function of the noise and polynomial degree,\n", - "that the parameters $\\beta$ will fluctuate from order to order in the\n", - "polynomial fit and that for larger and larger polynomial degrees of\n", - "freedom, the parameters will tend to increase in value for OLS.\n", - "\n", - "For Ridge and Lasso regression, the higher order parameters will\n", - "typically be reduced, providing thereby less fluctuations from one\n", - "order to another one." - ] - }, - { - "cell_type": "code", - "execution_count": 14, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "[ 1.0169643 0.27924636 -1.4087793 1.03308408 0. ]\n", - "Test MSE OLS\n", - "0.958228616652075\n" - ] - }, - { - "data": { - "image/png": "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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter2_316_1.png" - }, - "needs_background": "light" - }, - "output_type": "display_data" - } - ], - "source": [ - "import numpy as np\n", - "import matplotlib.pyplot as plt\n", - "from sklearn.model_selection import train_test_split\n", - "from sklearn import linear_model\n", - "\n", - "def R2(y_data, y_model):\n", - " return 1 - np.sum((y_data - y_model) ** 2) / np.sum((y_data - np.mean(y_data)) ** 2)\n", - "def MSE(y_data,y_model):\n", - " n = np.size(y_model)\n", - " return np.sum((y_data-y_model)**2)/n\n", - "\n", - "# Make data set.\n", - "n = 10000\n", - "x = np.random.rand(n)\n", - "y = np.exp(-x**2) + 1.5 * np.exp(-(x-2)**2)+ np.random.randn(n)\n", - "\n", - "Maxpolydegree = 5\n", - "X = np.zeros((len(x),Maxpolydegree))\n", - "X[:,0] = 1.0\n", - "\n", - "for polydegree in range(1, Maxpolydegree):\n", - " for degree in range(polydegree):\n", - " X[:,degree] = x**(degree)\n", - "\n", - "\n", - "# We split the data in test and training data\n", - "X_train, X_test, y_train, y_test = train_test_split(X, y, test_size=0.2)\n", - "\n", - "# matrix inversion to find beta\n", - "OLSbeta = np.linalg.pinv(X_train.T @ X_train) @ X_train.T @ y_train\n", - "print(OLSbeta)\n", - "ypredictOLS = X_test @ OLSbeta\n", - "print(\"Test MSE OLS\")\n", - "print(MSE(y_test,ypredictOLS))\n", - "# Repeat now for Lasso and Ridge regression and various values of the regularization parameter using Scikit-Learn\n", - "# Decide which values of lambda to use\n", - "nlambdas = 4\n", - "MSERidgePredict = np.zeros(nlambdas)\n", - "MSELassoPredict = np.zeros(nlambdas)\n", - "lambdas = np.logspace(-3, 1, nlambdas)\n", - "for i in range(nlambdas):\n", - " lmb = lambdas[i]\n", - " # Make the fit using Ridge and Lasso\n", - " RegRidge = linear_model.Ridge(lmb,fit_intercept=False)\n", - " RegRidge.fit(X_train,y_train)\n", - " RegLasso = linear_model.Lasso(lmb,fit_intercept=False)\n", - " RegLasso.fit(X_train,y_train)\n", - " # and then make the prediction\n", - " ypredictRidge = RegRidge.predict(X_test)\n", - " ypredictLasso = RegLasso.predict(X_test)\n", - " # Compute the MSE and print it\n", - " MSERidgePredict[i] = MSE(y_test,ypredictRidge)\n", - " MSELassoPredict[i] = MSE(y_test,ypredictLasso)\n", - "# print(lmb,RegRidge.coef_)\n", - "# print(lmb,RegLasso.coef_)\n", - "# Now plot the results\n", - "plt.figure()\n", - "plt.plot(np.log10(lambdas), MSERidgePredict, 'b', label = 'MSE Ridge Test')\n", - "plt.plot(np.log10(lambdas), MSELassoPredict, 'r', label = 'MSE Lasso Test')\n", - "plt.xlabel('log10(lambda)')\n", - "plt.ylabel('MSE')\n", - "plt.legend()\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "How can we understand this?\n", - "\n", - "Let us write out the values of the coefficients $\\beta_i$ as functions\n", - "of the polynomial degree and noise. We will focus only on the Ridge\n", - "results and some few selected values of the hyperparameter $\\lambda$.\n", - "\n", - "If we don't include any noise and run this code for different values\n", - "of the polynomial degree, we notice that the results for $\\beta_i$ do\n", - "not show great changes from one order to the next. This is an\n", - "indication that for higher polynomial orders, our parameters become\n", - "less important.\n", - "\n", - "If we however add noise, what happens is that the polynomial fit is\n", - "trying to adjust the fit to traverse in the best possible way all data\n", - "points. This can lead to large fluctuations in the parameters\n", - "$\\beta_i$ as functions of polynomial order. It will also be reflected\n", - "in a larger value of the variance of each parameter $\\beta_i$. What\n", - "Ridge regression (and Lasso as well) are doing then is to try to\n", - "quench the fluctuations in the parameters of $\\beta_i$ which have a\n", - "large variance (normally for higher orders in the polynomial)." - ] - }, - { - "cell_type": "code", - "execution_count": 15, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "data": { - "text/html": [ - "
\n", - "\n", - "\n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - "
beta
00.986699
1-0.606760
21.280573
3-0.850164
40.000000
\n", - "
" - ], - "text/plain": [ - " beta\n", - "0 0.986699\n", - "1 -0.606760\n", - "2 1.280573\n", - "3 -0.850164\n", - "4 0.000000" - ] - }, - "metadata": {}, - "output_type": "display_data" - }, - { - "data": { - "text/html": [ - "
\n", - "\n", - "\n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - "
beta
00.978553
1-0.511888
21.051418
3-0.701370
40.000000
\n", - "
" - ], - "text/plain": [ - " beta\n", - "0 0.978553\n", - "1 -0.511888\n", - "2 1.051418\n", - "3 -0.701370\n", - "4 0.000000" - ] - }, - "metadata": {}, - "output_type": "display_data" - }, - { - "data": { - "text/html": [ - "
\n", - "\n", - "\n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - "
beta
00.946957
1-0.162246
20.221921
3-0.167787
40.000000
\n", - "
" - ], - "text/plain": [ - " beta\n", - "0 0.946957\n", - "1 -0.162246\n", - "2 0.221921\n", - "3 -0.167787\n", - "4 0.000000" - ] - }, - "metadata": {}, - "output_type": "display_data" - }, - { - "data": { - "text/html": [ - "
\n", - "\n", - "\n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - "
beta
00.906747
10.017665
2-0.029483
3-0.053849
40.000000
\n", - "
" - ], - "text/plain": [ - " beta\n", - "0 0.906747\n", - "1 0.017665\n", - "2 -0.029483\n", - "3 -0.053849\n", - "4 0.000000" - ] - }, - "metadata": {}, - "output_type": "display_data" - }, - { - "data": { - "text/html": [ - "
\n", - "\n", - "\n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - "
beta
00.718165
10.156956
20.040102
3-0.001880
40.000000
\n", - "
" - ], - "text/plain": [ - " beta\n", - "0 0.718165\n", - "1 0.156956\n", - "2 0.040102\n", - "3 -0.001880\n", - "4 0.000000" - ] - }, - "metadata": {}, - "output_type": "display_data" - } - ], - "source": [ - "import numpy as np\n", - "import pandas as pd\n", - "from IPython.display import display\n", - "import matplotlib.pyplot as plt\n", - "from sklearn.model_selection import train_test_split\n", - "from sklearn import linear_model\n", - "\n", - "# Make data set.\n", - "n = 1000\n", - "x = np.random.rand(n)\n", - "y = np.exp(-x**2) + 1.5 * np.exp(-(x-2)**2)+ np.random.randn(n)\n", - "\n", - "Maxpolydegree = 5\n", - "X = np.zeros((len(x),Maxpolydegree))\n", - "X[:,0] = 1.0\n", - "\n", - "for polydegree in range(1, Maxpolydegree):\n", - " for degree in range(polydegree):\n", - " X[:,degree] = x**(degree)\n", - "\n", - "\n", - "# We split the data in test and training data\n", - "X_train, X_test, y_train, y_test = train_test_split(X, y, test_size=0.2)\n", - "\n", - "# Decide which values of lambda to use\n", - "nlambdas = 5\n", - "lambdas = np.logspace(-3, 2, nlambdas)\n", - "for i in range(nlambdas):\n", - " lmb = lambdas[i]\n", - " # Make the fit using Ridge only\n", - " RegRidge = linear_model.Ridge(lmb,fit_intercept=False)\n", - " RegRidge.fit(X_train,y_train)\n", - " # and then make the prediction\n", - " ypredictRidge = RegRidge.predict(X_test)\n", - " Coeffs = np.array(RegRidge.coef_)\n", - " BetaValues = pd.DataFrame(Coeffs)\n", - " BetaValues.columns = ['beta']\n", - " display(BetaValues)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "As an exercise, repeat these calculations with ordinary least squares\n", - "only with and without noise. Calculate thereafter the variance of the\n", - "parameters $\\beta_j$ as function of polynomial order and of the added\n", - "noise. Here we recommend to use $\\sigma^2=1$ as variance for the\n", - "added noise (which follows a normal distribution with mean value zero).\n", - "Comment your results. If you have a large noise term, do the parameters $\\beta_j$ vary more as function\n", - "model complexity? And what about their variance? \n", - "\n", - "\n", - "\n", - "\n", - "## Linking Bayes' Theorem with Ridge and Lasso Regression\n", - "\n", - "We have seen that Ridge regression suppresses those features which\n", - "have a small singular value. This corresponds to a feature which exhibits\n", - "a large variance in the parameters $\\beta_j$.\n", - "Our analysis hitherto has been based on linear algebra. To add to our intuition, we will use\n", - "Bayes' theorem in order to deepen our understanding of Ridge and Lasso regression. \n", - "\n", - "For ordinary least squares we postulated that the maximum likelihood for the domain of events $\\boldsymbol{D}$ (one-dimensional case)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{D}=[(x_0,y_0), (x_1,y_1),\\dots, (x_{n-1},y_{n-1})],\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "is given by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(\\boldsymbol{D}\\vert\\boldsymbol{\\beta})=\\prod_{i=0}^{n-1}\\frac{1}{\\sqrt{2\\pi\\sigma^2}}\\exp{\\left[-\\frac{(y_i-\\boldsymbol{X}_{i,*}\\boldsymbol{\\beta})^2}{2\\sigma^2}\\right]}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In Bayes' theorem this function plays the role of the so-called likelihood. We could now ask the question what is the posterior probability of a parameter set $\\boldsymbol{\\beta}$ given a domain of events $\\boldsymbol{D}$? That is, how can we define the posterior probability" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(\\boldsymbol{\\beta}\\vert\\boldsymbol{D}).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Bayes' theorem comes to our rescue here since (omitting the normalization constant)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(\\boldsymbol{\\beta}\\vert\\boldsymbol{D})\\propto p(\\boldsymbol{D}\\vert\\boldsymbol{\\beta})p(\\boldsymbol{\\beta}).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We have a model for $p(\\boldsymbol{D}\\vert\\boldsymbol{\\beta})$ but need one for the **prior** $p(\\boldsymbol{\\beta}$! \n", - "\n", - "\n", - "\n", - "With the posterior probability defined by a likelihood which we have\n", - "already modeled and an unknown prior, we are now ready to make\n", - "additional models for the prior.\n", - "\n", - "We can, based on our discussions of the variance of $\\boldsymbol{\\beta}$ and\n", - "the mean value, assume that the prior for the values $\\boldsymbol{\\beta}$ is\n", - "given by a Gaussian with mean value zero and variance $\\tau^2$, that\n", - "is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(\\boldsymbol{\\beta})=\\prod_{j=0}^{p-1}\\exp{\\left(-\\frac{\\beta_j^2}{2\\tau^2}\\right)}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Our posterior probability becomes then (omitting the normalization factor which is just a constant)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(\\boldsymbol{\\beta\\vert\\boldsymbol{D})}=\\prod_{i=0}^{n-1}\\frac{1}{\\sqrt{2\\pi\\sigma^2}}\\exp{\\left[-\\frac{(y_i-\\boldsymbol{X}_{i,*}\\boldsymbol{\\beta})^2}{2\\sigma^2}\\right]}\\prod_{j=0}^{p-1}\\exp{\\left(-\\frac{\\beta_j^2}{2\\tau^2}\\right)}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We can now optimize this quantity with respect to $\\boldsymbol{\\beta}$. As we\n", - "did for OLS, this is most conveniently done by taking the negative\n", - "logarithm of the posterior probability. Doing so and leaving out the\n", - "terms that do not depend on $\\beta$, we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(\\boldsymbol{\\beta})=\\frac{\\vert\\vert (\\boldsymbol{y}-\\boldsymbol{X}\\boldsymbol{\\beta})\\vert\\vert_2^2}{2\\sigma^2}+\\frac{1}{2\\tau^2}\\vert\\vert\\boldsymbol{\\beta}\\vert\\vert_2^2,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and replacing $1/2\\tau^2$ with $\\lambda$ we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(\\boldsymbol{\\beta})=\\frac{\\vert\\vert (\\boldsymbol{y}-\\boldsymbol{X}\\boldsymbol{\\beta})\\vert\\vert_2^2}{2\\sigma^2}+\\lambda\\vert\\vert\\boldsymbol{\\beta}\\vert\\vert_2^2,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which is our Ridge cost function! Nice, isn't it?\n", - "\n", - "\n", - "To derive the Lasso cost function, we simply replace the Gaussian prior with an exponential distribution ([Laplace in this case](https://en.wikipedia.org/wiki/Laplace_distribution)) with zero mean value, that is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(\\boldsymbol{\\beta})=\\prod_{j=0}^{p-1}\\exp{\\left(-\\frac{\\vert\\beta_j\\vert}{\\tau}\\right)}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Our posterior probability becomes then (omitting the normalization factor which is just a constant)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(\\boldsymbol{\\beta}\\vert\\boldsymbol{D})=\\prod_{i=0}^{n-1}\\frac{1}{\\sqrt{2\\pi\\sigma^2}}\\exp{\\left[-\\frac{(y_i-\\boldsymbol{X}_{i,*}\\boldsymbol{\\beta})^2}{2\\sigma^2}\\right]}\\prod_{j=0}^{p-1}\\exp{\\left(-\\frac{\\vert\\beta_j\\vert}{\\tau}\\right)}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Taking the negative\n", - "logarithm of the posterior probability and leaving out the\n", - "constants terms that do not depend on $\\beta$, we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(\\boldsymbol{\\beta}=\\frac{\\vert\\vert (\\boldsymbol{y}-\\boldsymbol{X}\\boldsymbol{\\beta})\\vert\\vert_2^2}{2\\sigma^2}+\\frac{1}{\\tau}\\vert\\vert\\boldsymbol{\\beta}\\vert\\vert_1,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and replacing $1/\\tau$ with $\\lambda$ we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(\\boldsymbol{\\beta}=\\frac{\\vert\\vert (\\boldsymbol{y}-\\boldsymbol{X}\\boldsymbol{\\beta})\\vert\\vert_2^2}{2\\sigma^2}+\\lambda\\vert\\vert\\boldsymbol{\\beta}\\vert\\vert_1,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which is our Lasso cost function! \n", - "\n", - "\n", - "Plotting these prior functions shows us that we can use the parameter\n", - "$\\lambda$ to shrink or increase the role of a given parameter\n", - "$\\beta_j$. The variance for the Laplace distribution is\n", - "$2\\tau^2=1/\\lambda$ while for the Gaussian distribution it is\n", - "$\\sigma^2=1/(2\\lambda)$. Thus, increasing the variance means\n", - "decreasing $\\lambda$ and shrinking the variance means increasing\n", - "$\\lamdbda$. When we increase $\\lambda$, this corresponds to shrinking the role of less important features (small singular values)." - ] - } - ], - "metadata": { - "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.8.5" - } - }, - "nbformat": 4, - "nbformat_minor": 4 -} \ No newline at end of file diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter2.py b/doc/LectureNotes/_build/jupyter_execute/chapter2.py deleted file mode 100644 index fda4add84..000000000 --- a/doc/LectureNotes/_build/jupyter_execute/chapter2.py +++ /dev/null @@ -1,2600 +0,0 @@ -# Ridge and Lasso Regression - - - -## Mathematical Interpretation of Ordinary Least Squares - -What is presented here is a mathematical analysis of various regression algorithms (ordinary least squares, Ridge and Lasso Regression). The analysis is based on an important algorithm in linear algebra, the so-called Singular Value Decomposition (SVD). - - -We have shown that in ordinary least squares (OLS) the optimal parameters $\beta$ are given by - -$$ -\hat{\boldsymbol{\beta}}_{\mathrm{OLS}} = \left(\boldsymbol{X}^T\boldsymbol{X}\right)^{-1}\boldsymbol{X}^T\boldsymbol{y}. -$$ - -The **hat** over $\boldsymbol{\beta}$ means we have the optimal parameters after minimization of the cost function. - -This means that our best model is defined as - -$$ -\tilde{\boldsymbol{y}}=\boldsymbol{X}\hat{\boldsymbol{\beta}} = \boldsymbol{X}\left(\boldsymbol{X}^T\boldsymbol{X}\right)^{-1}\boldsymbol{X}^T\boldsymbol{y}. -$$ - -We now define a matrix - -$$ -\boldsymbol{A}=\boldsymbol{X}\left(\boldsymbol{X}^T\boldsymbol{X}\right)^{-1}\boldsymbol{X}^T. -$$ - -We can rewrite - -$$ -\tilde{\boldsymbol{y}}=\boldsymbol{X}\hat{\boldsymbol{\beta}} = \boldsymbol{A}\boldsymbol{y}. -$$ - -The matrix $\boldsymbol{A}$ has the important property that $\boldsymbol{A}^2=\boldsymbol{A}$. This is the definition of a [projection matrix](https://en.wikipedia.org/wiki/Projection_matrix). -We can then interpret our optimal model $\tilde{\boldsymbol{y}}$ as being represented by an orthogonal projection of $\boldsymbol{y}$ onto a space defined by the column vectors of $\boldsymbol{X}$. In our case here the matrix $\boldsymbol{A}$ is a square matrix. If it is a general rectangular matrix we have an oblique projection matrix. - - - - -We have defined the residual error as - -$$ -\boldsymbol{\epsilon}=\boldsymbol{y}-\tilde{\boldsymbol{y}}=\left[\boldsymbol{I}-\boldsymbol{X}\left(\boldsymbol{X}^T\boldsymbol{X}\right)^{-1}\boldsymbol{X}^T\right]\boldsymbol{y}. -$$ - -The residual errors are then the projections of $\boldsymbol{y}$ onto the orthogonal component of the space defined by the column vectors of $\boldsymbol{X}$. - - -If the matrix $\boldsymbol{X}$ is an orthogonal (or unitary in case of complex values) matrix, we have - -$$ -\boldsymbol{X}^T\boldsymbol{X}=\boldsymbol{X}\boldsymbol{X}^T = \boldsymbol{I}. -$$ - -In this case the matrix $\boldsymbol{A}$ becomes - -$$ -\boldsymbol{A}=\boldsymbol{X}\left(\boldsymbol{X}^T\boldsymbol{X}\right)^{-1}\boldsymbol{X}^T)=\boldsymbol{I}, -$$ - -and we have the obvious case - -$$ -\boldsymbol{\epsilon}=\boldsymbol{y}-\tilde{\boldsymbol{y}}=0. -$$ - -This serves also as a useful test of our codes. - - - - -## The singular value decomposition - - -The examples we have looked at so far are cases where we normally can -invert the matrix $\boldsymbol{X}^T\boldsymbol{X}$. Using a polynomial expansion where we fit of various functions leads to -row vectors of the design matrix which are essentially orthogonal due -to the polynomial character of our model. Obtaining the inverse of the -design matrix is then often done via a so-called LU, QR or Cholesky -decomposition. - - -As we will also see in the first project, -this may -however not the be case in general and a standard matrix inversion -algorithm based on say LU, QR or Cholesky decomposition may lead to singularities. We will see examples of this below. - -There is however a way to circumvent this problem and also -gain some insights about the ordinary least squares approach, and -later shrinkage methods like Ridge and Lasso regressions. - -This is given by the **Singular Value Decomposition** (SVD) algorithm, -perhaps the most powerful linear algebra algorithm. The SVD provides -a numerically stable matrix decomposition that is used in a large -swath oc applications and the decomposition is always stable -numerically. - -In machine learning it plays a central role in dealing with for -example design matrices that may be near singular or singular. -Furthermore, as we will see here, the singular values can be related -to the covariance matrix (and thereby the correlation matrix) and in -turn the variance of a given quantity. It plays also an important role -in the principal component analysis where high-dimensional data can be -reduced to the statistically relevant features. - - - - -One of the typical problems we encounter with linear regression, in particular -when the matrix $\boldsymbol{X}$ (our so-called design matrix) is high-dimensional, -are problems with near singular or singular matrices. The column vectors of $\boldsymbol{X}$ -may be linearly dependent, normally referred to as super-collinearity. -This means that the matrix may be rank deficient and it is basically impossible to -to model the data using linear regression. As an example, consider the matrix - -$$ -\begin{align*} -\mathbf{X} & = \left[ -\begin{array}{rrr} -1 & -1 & 2 -\\ -1 & 0 & 1 -\\ -1 & 2 & -1 -\\ -1 & 1 & 0 -\end{array} \right] -\end{align*} -$$ - -The columns of $\boldsymbol{X}$ are linearly dependent. We see this easily since the -the first column is the row-wise sum of the other two columns. The rank (more correct, -the column rank) of a matrix is the dimension of the space spanned by the -column vectors. Hence, the rank of $\mathbf{X}$ is equal to the number -of linearly independent columns. In this particular case the matrix has rank 2. - -Super-collinearity of an $(n \times p)$-dimensional design matrix $\mathbf{X}$ implies -that the inverse of the matrix $\boldsymbol{X}^T\boldsymbol{X}$ (the matrix we need to invert to solve the linear regression equations) is non-invertible. If we have a square matrix that does not have an inverse, we say this matrix singular. The example here demonstrates this - -$$ -\begin{align*} -\boldsymbol{X} & = \left[ -\begin{array}{rr} -1 & -1 -\\ -1 & -1 -\end{array} \right]. -\end{align*} -$$ - -We see easily that $\mbox{det}(\boldsymbol{X}) = x_{11} x_{22} - x_{12} x_{21} = 1 \times (-1) - 1 \times (-1) = 0$. Hence, $\mathbf{X}$ is singular and its inverse is undefined. -This is equivalent to saying that the matrix $\boldsymbol{X}$ has at least an eigenvalue which is zero. - - - -If our design matrix $\boldsymbol{X}$ which enters the linear regression problem - - -
- -$$ -\begin{equation} -\boldsymbol{\beta} = (\boldsymbol{X}^{T} \boldsymbol{X})^{-1} \boldsymbol{X}^{T} \boldsymbol{y}, -\label{_auto1} \tag{1} -\end{equation} -$$ - -has linearly dependent column vectors, we will not be able to compute the inverse -of $\boldsymbol{X}^T\boldsymbol{X}$ and we cannot find the parameters (estimators) $\beta_i$. -The estimators are only well-defined if $(\boldsymbol{X}^{T}\boldsymbol{X})^{-1}$ exits. -This is more likely to happen when the matrix $\boldsymbol{X}$ is high-dimensional. In this case it is likely to encounter a situation where -the regression parameters $\beta_i$ cannot be estimated. - -A cheap *ad hoc* approach is simply to add a small diagonal component to the matrix to invert, that is we change - -$$ -\boldsymbol{X}^{T} \boldsymbol{X} \rightarrow \boldsymbol{X}^{T} \boldsymbol{X}+\lambda \boldsymbol{I}, -$$ - -where $\boldsymbol{I}$ is the identity matrix. When we discuss **Ridge** regression this is actually what we end up evaluating. The parameter $\lambda$ is called a hyperparameter. More about this later. - - - - -## Basic math of the SVD - - -From standard linear algebra we know that a square matrix $\boldsymbol{X}$ can be diagonalized if and only it is -a so-called [normal matrix](https://en.wikipedia.org/wiki/Normal_matrix), that is if $\boldsymbol{X}\in {\mathbb{R}}^{n\times n}$ -we have $\boldsymbol{X}\boldsymbol{X}^T=\boldsymbol{X}^T\boldsymbol{X}$ or if $\boldsymbol{X}\in {\mathbb{C}}^{n\times n}$ we have $\boldsymbol{X}\boldsymbol{X}^{\dagger}=\boldsymbol{X}^{\dagger}\boldsymbol{X}$. -The matrix has then a set of eigenpairs - -$$ -(\lambda_1,\boldsymbol{u}_1),\dots, (\lambda_n,\boldsymbol{u}_n), -$$ - -and the eigenvalues are given by the diagonal matrix - -$$ -\boldsymbol{\Sigma}=\mathrm{Diag}(\lambda_1, \dots,\lambda_n). -$$ - -The matrix $\boldsymbol{X}$ can be written in terms of an orthogonal/unitary transformation $\boldsymbol{U}$ - -$$ -\boldsymbol{X} = \boldsymbol{U}\boldsymbol{\Sigma}\boldsymbol{V}^T, -$$ - -with $\boldsymbol{U}\boldsymbol{U}^T=\boldsymbol{I}$ or $\boldsymbol{U}\boldsymbol{U}^{\dagger}=\boldsymbol{I}$. - -Not all square matrices are diagonalizable. A matrix like the one discussed above - -$$ -\boldsymbol{X} = \begin{bmatrix} -1& -1 \\ -1& -1\\ -\end{bmatrix} -$$ - -is not diagonalizable, it is a so-called [defective matrix](https://en.wikipedia.org/wiki/Defective_matrix). It is easy to see that the condition -$\boldsymbol{X}\boldsymbol{X}^T=\boldsymbol{X}^T\boldsymbol{X}$ is not fulfilled. - - - - - -However, and this is the strength of the SVD algorithm, any general -matrix $\boldsymbol{X}$ can be decomposed in terms of a diagonal matrix and -two orthogonal/unitary matrices. The [Singular Value Decompostion -(SVD) theorem](https://en.wikipedia.org/wiki/Singular_value_decomposition) -states that a general $m\times n$ matrix $\boldsymbol{X}$ can be written in -terms of a diagonal matrix $\boldsymbol{\Sigma}$ of dimensionality $m\times n$ -and two orthognal matrices $\boldsymbol{U}$ and $\boldsymbol{V}$, where the first has -dimensionality $m \times m$ and the last dimensionality $n\times n$. -We have then - -$$ -\boldsymbol{X} = \boldsymbol{U}\boldsymbol{\Sigma}\boldsymbol{V}^T -$$ - -As an example, the above defective matrix can be decomposed as - -$$ -\boldsymbol{X} = \frac{1}{\sqrt{2}}\begin{bmatrix} 1& 1 \\ 1& -1\\ \end{bmatrix} \begin{bmatrix} 2& 0 \\ 0& 0\\ \end{bmatrix} \frac{1}{\sqrt{2}}\begin{bmatrix} 1& -1 \\ 1& 1\\ \end{bmatrix}=\boldsymbol{U}\boldsymbol{\Sigma}\boldsymbol{V}^T, -$$ - -with eigenvalues $\sigma_1=2$ and $\sigma_2=0$. -The SVD exits always! - -The SVD -decomposition (singular values) gives eigenvalues -$\sigma_i\geq\sigma_{i+1}$ for all $i$ and for dimensions larger than $i=p$, the -eigenvalues (singular values) are zero. - -In the general case, where our design matrix $\boldsymbol{X}$ has dimension -$n\times p$, the matrix is thus decomposed into an $n\times n$ -orthogonal matrix $\boldsymbol{U}$, a $p\times p$ orthogonal matrix $\boldsymbol{V}$ -and a diagonal matrix $\boldsymbol{\Sigma}$ with $r=\mathrm{min}(n,p)$ -singular values $\sigma_i\geq 0$ on the main diagonal and zeros filling -the rest of the matrix. There are at most $p$ singular values -assuming that $n > p$. In our regression examples for the nuclear -masses and the equation of state this is indeed the case, while for -the Ising model we have $p > n$. These are often cases that lead to -near singular or singular matrices. - -The columns of $\boldsymbol{U}$ are called the left singular vectors while the columns of $\boldsymbol{V}$ are the right singular vectors. - - -If we assume that $n > p$, then our matrix $\boldsymbol{U}$ has dimension $n -\times n$. The last $n-p$ columns of $\boldsymbol{U}$ become however -irrelevant in our calculations since they are multiplied with the -zeros in $\boldsymbol{\Sigma}$. - -The economy-size decomposition removes extra rows or columns of zeros -from the diagonal matrix of singular values, $\boldsymbol{\Sigma}$, along with the columns -in either $\boldsymbol{U}$ or $\boldsymbol{V}$ that multiply those zeros in the expression. -Removing these zeros and columns can improve execution time -and reduce storage requirements without compromising the accuracy of -the decomposition. - -If $n > p$, we keep only the first $p$ columns of $\boldsymbol{U}$ and $\boldsymbol{\Sigma}$ has dimension $p\times p$. -If $p > n$, then only the first $n$ columns of $\boldsymbol{V}$ are computed and $\boldsymbol{\Sigma}$ has dimension $n\times n$. -The $n=p$ case is obvious, we retain the full SVD. -In general the economy-size SVD leads to less FLOPS and still conserving the desired accuracy. - -## Codes for the SVD - -import numpy as np -# SVD inversion -def SVD(A): - ''' Takes as input a numpy matrix A and returns inv(A) based on singular value decomposition (SVD). - SVD is numerically more stable than the inversion algorithms provided by - numpy and scipy.linalg at the cost of being slower. - ''' - U, S, VT = np.linalg.svd(A,full_matrices=True) - print('test U') - print( (np.transpose(U) @ U - U @np.transpose(U))) - print('test VT') - print( (np.transpose(VT) @ VT - VT @np.transpose(VT))) - print(U) - print(S) - print(VT) - - D = np.zeros((len(U),len(VT))) - for i in range(0,len(VT)): - D[i,i]=S[i] - return U @ D @ VT - - -X = np.array([ [1.0,-1.0], [1.0,-1.0]]) -#X = np.array([[1, 2], [3, 4], [5, 6]]) - -print(X) -C = SVD(X) -# Print the difference between the original matrix and the SVD one -print(C-X) - -The matrix $\boldsymbol{X}$ has columns that are linearly dependent. The first -column is the row-wise sum of the other two columns. The rank of a -matrix (the column rank) is the dimension of space spanned by the -column vectors. The rank of the matrix is the number of linearly -independent columns, in this case just $2$. We see this from the -singular values when running the above code. Running the standard -inversion algorithm for matrix inversion with $\boldsymbol{X}^T\boldsymbol{X}$ results -in the program terminating due to a singular matrix. - - - -The $U$, $S$, and $V$ matrices returned from the **svd()** function -cannot be multiplied directly. - -As you can see from the code, the $S$ vector must be converted into a -diagonal matrix. This may cause a problem as the size of the matrices -do not fit the rules of matrix multiplication, where the number of -columns in a matrix must match the number of rows in the subsequent -matrix. - -If you wish to include the zero singular values, you will need to -resize the matrices and set up a diagonal matrix as done in the above -example - - -## Code for SVD and Inversion of Matrices - -How do we use the SVD to invert a matrix $\boldsymbol{X}^T\boldsymbol{X}$ which is singular or near singular? -The simple answer is to use the linear algebra function for the pseudoinverse, that is - -#Ainv = np.linlag.pinv(A) - -Let us first look at a matrix which does not causes problems and write our own function where we just use the SVD. - -import numpy as np -# SVD inversion -def SVDinv(A): - ''' Takes as input a numpy matrix A and returns inv(A) based on singular value decomposition (SVD). - SVD is numerically more stable than the inversion algorithms provided by - numpy and scipy.linalg at the cost of being slower. - ''' - U, s, VT = np.linalg.svd(A) - print('test U') - print( (np.transpose(U) @ U - U @np.transpose(U))) - print('test VT') - print( (np.transpose(VT) @ VT - VT @np.transpose(VT))) - - - D = np.zeros((len(U),len(VT))) - D = np.diag(s) - UT = np.transpose(U); V = np.transpose(VT); invD = np.linalg.inv(D) - return np.matmul(V,np.matmul(invD,UT)) - - -#X = np.array([ [1.0, -1.0, 2.0], [1.0, 0.0, 1.0], [1.0, 2.0, -1.0], [1.0, 1.0, 0.0] ]) -# Non-singular square matrix -X = np.array( [ [1,2,3],[2,4,5],[3,5,6]]) -print(X) -A = np.transpose(X) @ X -# Brute force inversion -B = np.linalg.pinv(A) # here we could use np.linalg.inv(A), try it! -C = SVDinv(A) -print(np.abs(B-C)) - -Although our matrix to invert $\boldsymbol{X}^T\boldsymbol{X}$ is a square matrix, our matrix may be singular. - -The pseudoinverse is the generalization of the matrix inverse for square matrices to -rectangular matrices where the number of rows and columns are not equal. - -It is also called the the Moore-Penrose Inverse after two independent discoverers of the method or the Generalized Inverse. -It is used for the calculation of the inverse for singular or near singular matrices and for rectangular matrices. - -Using the SVD we can obtain the pseudoinverse of a matrix $\boldsymbol{A}$ (labeled here as $\boldsymbol{A}_{\mathrm{PI}}$ - -$$ -\boldsymbol{A}_{\mathrm{PI}}= \boldsymbol{V}\boldsymbol{D}_{\mathrm{PI}}\boldsymbol{U}^T, -$$ - -where $\boldsymbol{D}_{\mathrm{PI}}$ can be calculated by creating a diagonal matrix from $\boldsymbol{Sigma}$ where we only keep the singular values (the non-zero values). The following code computes the pseudoinvers of the matrix based on the SVD. - -import numpy as np -# SVD inversion -def SVDinv(A): - U, s, VT = np.linalg.svd(A) - # reciprocals of singular values of s - d = 1.0 / s - # create m x n D matrix - D = np.zeros(A.shape) - # populate D with n x n diagonal matrix - D[:A.shape[1], :A.shape[1]] = np.diag(d) - UT = np.transpose(U) - V = np.transpose(VT) - return np.matmul(V,np.matmul(D.T,UT)) - - -A = np.array([ [0.3, 0.4], [0.5, 0.6], [0.7, 0.8],[0.9, 1.0]]) -print(A) -# Brute force inversion of super-collinear matrix -B = np.linalg.pinv(A) -print(B) -# Compare our own algorithm with pinv -C = SVDinv(A) -print(np.abs(C-B)) - -As you can see from these examples, our own decomposition based on the SVD agrees the pseudoinverse algorithm provided by **Numpy**. - - - - - -## Mathematics of the SVD and implications - -Let us take a closer look at the mathematics of the SVD and the various implications for machine learning studies. - -Our starting point is our design matrix $\boldsymbol{X}$ of dimension $n\times p$ - -$$ -\boldsymbol{X}=\begin{bmatrix} -x_{0,0} & x_{0,1} & x_{0,2}& \dots & \dots x_{0,p-1}\\ -x_{1,0} & x_{1,1} & x_{1,2}& \dots & \dots x_{1,p-1}\\ -x_{2,0} & x_{2,1} & x_{2,2}& \dots & \dots x_{2,p-1}\\ -\dots & \dots & \dots & \dots \dots & \dots \\ -x_{n-2,0} & x_{n-2,1} & x_{n-2,2}& \dots & \dots x_{n-2,p-1}\\ -x_{n-1,0} & x_{n-1,1} & x_{n-1,2}& \dots & \dots x_{n-1,p-1}\\ -\end{bmatrix}. -$$ - -We can SVD decompose our matrix as - -$$ -\boldsymbol{X}=\boldsymbol{U}\boldsymbol{\Sigma}\boldsymbol{V}^T, -$$ - -where $\boldsymbol{U}$ is an orthogonal matrix of dimension $n\times n$, meaning that $\boldsymbol{U}\boldsymbol{U}^T=\boldsymbol{U}^T\boldsymbol{U}=\boldsymbol{I}_n$. Here $\boldsymbol{I}_n$ is the unit matrix of dimension $n \times n$. - -Similarly, $\boldsymbol{V}$ is an orthogonal matrix of dimension $p\times p$, meaning that $\boldsymbol{V}\boldsymbol{V}^T=\boldsymbol{V}^T\boldsymbol{V}=\boldsymbol{I}_p$. Here $\boldsymbol{I}_n$ is the unit matrix of dimension $p \times p$. - -Finally $\boldsymbol{\Sigma}$ contains the singular values $\sigma_i$. This matrix has dimension $n\times p$ and the singular values $\sigma_i$ are all positive. The non-zero values are ordered in descending order, that is - -$$ -\sigma_0 > \sigma_1 > \sigma_2 > \dots > \sigma_{p-1} > 0. -$$ - -All values beyond $p-1$ are all zero. - - -As an example, consider the following $3\times 2$ example for the matrix $\boldsymbol{\Sigma}$ - -$$ -\boldsymbol{\Sigma}= -\begin{bmatrix} -2& 0 \\ -0 & 1 \\ -0 & 0 \\ -\end{bmatrix} -$$ - -The singular values are $\sigma_0=2$ and $\sigma_1=1$. It is common to rewrite the matrix $\boldsymbol{\Sigma}$ as - -$$ -\boldsymbol{\Sigma}= -\begin{bmatrix} -\boldsymbol{\tilde{\Sigma}}\\ -\boldsymbol{0}\\ -\end{bmatrix}, -$$ - -where - -$$ -\boldsymbol{\tilde{\Sigma}}= -\begin{bmatrix} -2& 0 \\ -0 & 1 \\ -\end{bmatrix}, -$$ - -contains only the singular values. Note also (and we will use this below) that - -$$ -\boldsymbol{\Sigma}^T\boldsymbol{\Sigma}= -\begin{bmatrix} -4& 0 \\ -0 & 1 \\ -\end{bmatrix}, -$$ - -which is a $2\times 2 $ matrix while - -$$ -\boldsymbol{\Sigma}\boldsymbol{\Sigma}^T= -\begin{bmatrix} -4& 0 & 0\\ -0 & 1 & 0\\ -0 & 0 & 0\\ -\end{bmatrix}, -$$ - -is a $3\times 3 $ matrix. The last row and column of this last matrix -contain only zeros. This will have important consequences for our SVD -decomposition of the design matrix. - - - -The matrix that may cause problems for us is $\boldsymbol{X}^T\boldsymbol{X}$. Using the SVD we can rewrite this matrix as - -$$ -\boldsymbol{X}^T\boldsymbol{X}=\boldsymbol{V}\boldsymbol{\Sigma}^T\boldsymbol{U}^T\boldsymbol{U}\boldsymbol{\Sigma}\boldsymbol{V}^T, -$$ - -and using the orthogonality of the matrix $\boldsymbol{U}$ we have - -$$ -\boldsymbol{X}^T\boldsymbol{X}=\boldsymbol{V}\boldsymbol{\Sigma}^T\boldsymbol{\Sigma}\boldsymbol{V}^T. -$$ - -We define $\boldsymbol{\Sigma}^T\boldsymbol{\Sigma}=\tilde{\boldsymbol{\Sigma}}^2$ which is a diagonal matrix containing only the singular values squared. It has dimensionality $p \times p$. - -This means, using the orthogonality of $\boldsymbol{V}$, that we get - -$$ -\boldsymbol{X}^T\boldsymbol{X}=\tilde{\boldsymbol{\Sigma}}^2. -$$ - -We can now insert the result for the matrix $\boldsymbol{X}^T\boldsymbol{X}$ into our equation for ordinary least squares where - -$$ -\tilde{y}_{\mathrm{OLS}}=\boldsymbol{X}\left(\boldsymbol{X}^T\boldsymbol{X}\right)^{-1}\boldsymbol{X}^T\boldsymbol{y}, -$$ - -and using our SVD decomposition of $\boldsymbol{X}$ we have - -$$ -\tilde{y}_{\mathrm{OLS}}=\boldsymbol{U}\boldsymbol{\Sigma}\boldsymbol{V}^T\tilde{\boldsymbol{\Sigma}}^{-2}\boldsymbol{V}\boldsymbol{\Sigma}^T\boldsymbol{U}^T\boldsymbol{y}, -$$ - -which gives us, using the orthogonality of the matrices $\boldsymbol{U}$ and $\boldsymbol{V}$, - -$$ -\tilde{y}_{\mathrm{OLS}}=\boldsymbol{U}\boldsymbol{U}^T\boldsymbol{y}=\sum_{i=0}^{p-1}\boldsymbol{u}_i\boldsymbol{u}^T_j\boldsymbol{y}, -$$ - -Note here that when we perform the multiplication of the various matrices, the orthogonal vectors of the matrix $\boldsymbol{U}$ - -$$ -\boldsymbol{U}=[\boldsymbol{u}_0,\boldsymbol{u}_1,\dots,\boldsymbol{u}_{n-1}], -$$ - -that belong to $i>p-1$, result in only zeros when we perform the multiplications. This means that the sum above has non-zero elements only up to $i=p-1$. This corresponds also to the number of singular values (these are all non-zero). - -It means that the ordinary least square model (with the optimal parameters) $\boldsymbol{\tilde{y}}$, corresponds to an orthogonal transformation of the output (or target) vector $\boldsymbol{y}$ by the vectors of the matrix $\boldsymbol{U}$. - - -## Further properties (important for our analyses later) - -Let us study again $\boldsymbol{X}^T\boldsymbol{X}$ in terms of our SVD, - -$$ -\boldsymbol{X}^T\boldsymbol{X}=\boldsymbol{V}\boldsymbol{\Sigma}^T\boldsymbol{U}^T\boldsymbol{U}\boldsymbol{\Sigma}\boldsymbol{V}^T=\boldsymbol{V}\boldsymbol{\Sigma}^T\boldsymbol{\Sigma}\boldsymbol{V}^T. -$$ - -If we now multiply from the right with $\boldsymbol{V}$ (using the orthogonality of $\boldsymbol{V}$) we get - -$$ -\left(\boldsymbol{X}^T\boldsymbol{X}\right)\boldsymbol{V}=\boldsymbol{V}\boldsymbol{\Sigma}^T\boldsymbol{\Sigma}. -$$ - -This means the vectors $\boldsymbol{v}_i$ of the orthogonal matrix $\boldsymbol{V}$ are the eigenvectors of the matrix $\boldsymbol{X}^T\boldsymbol{X}$ -with eigenvalues given by the singular values squared, that is - -$$ -\left(\boldsymbol{X}^T\boldsymbol{X}\right)\boldsymbol{v}_i=\boldsymbol{v}_i\sigma_i^2. -$$ - -Similarly, if we use the SVD decomposition for the matrix $\boldsymbol{X}\boldsymbol{X}^T$, we have - -$$ -\boldsymbol{X}\boldsymbol{X}^T=\boldsymbol{U}\boldsymbol{\Sigma}\boldsymbol{V}^T\boldsymbol{V}\boldsymbol{\Sigma}^T\boldsymbol{U}^T=\boldsymbol{U}\boldsymbol{\Sigma}\boldsymbol{\Sigma}^T\boldsymbol{U}^T. -$$ - -If we now multiply from the right with $\boldsymbol{U}$ (using the orthogonality of $\boldsymbol{U}$) we get - -$$ -\left(\boldsymbol{X}\boldsymbol{X}^T\right)\boldsymbol{U}=\boldsymbol{U}\boldsymbol{\Sigma}\boldsymbol{\Sigma}^T. -$$ - -This means the vectors $\boldsymbol{u}_i$ of the orthogonal matrix $\boldsymbol{U}$ are the eigenvectors of the matrix $\boldsymbol{X}\boldsymbol{X}^T$ -with eigenvalues given by the singular values squared, that is - -$$ -\left(\boldsymbol{X}\boldsymbol{X}^T\right)\boldsymbol{u}_i=\boldsymbol{u}_i\sigma_i^2. -$$ - -**Important note**: we have defined our design matrix $\boldsymbol{X}$ to be an -$n\times p$ matrix. In most supervised learning cases we have that $n -\ge p$, and quite often we have $n >> p$. For linear algebra based methods like ordinary least squares or Ridge regression, this leads to a matrix $\boldsymbol{X}^T\boldsymbol{X}$ which is small and thereby easier to handle from a computational point of view (in terms of number of floating point operations). - -In our lectures, the number of columns will -always refer to the number of features in our data set, while the -number of rows represents the number of data inputs. Note that in -other texts you may find the opposite notation. This has consequences -for the definition of for example the covariance matrix and its relation to the SVD. - - -## Meet the Covariance Matrix - - -Before we move on to a discussion of Ridge and Lasso regression, we want to show an important example of the above. - -We have already noted that the matrix $\boldsymbol{X}^T\boldsymbol{X}$ in ordinary -least squares is proportional to the second derivative of the cost -function, that is we have - -$$ -\frac{\partial^2 C(\boldsymbol{\beta})}{\partial \boldsymbol{\beta}^T\partial \boldsymbol{\beta}} =\frac{2}{n}\boldsymbol{X}^T\boldsymbol{X}. -$$ - -This quantity defines was what is called the Hessian matrix (the second derivative of a function we want to optimize). - -The Hessian matrix plays an important role and is defined in this course as - -$$ -\boldsymbol{H}=\boldsymbol{X}^T\boldsymbol{X}. -$$ - -The Hessian matrix for ordinary least squares is also proportional to -the covariance matrix. This means also that we can use the SVD to find -the eigenvalues of the covariance matrix and the Hessian matrix in -terms of the singular values. Let us develop these arguments, as they will play an important role in our machine learning studies. - - - -Before we discuss the link between for example Ridge regression and the singular value decomposition, we need to remind ourselves about -the definition of the covariance and the correlation function. These are quantities that play a central role in machine learning methods. - -Suppose we have defined two vectors -$\hat{x}$ and $\hat{y}$ with $n$ elements each. The covariance matrix $\boldsymbol{C}$ is defined as - -$$ -\boldsymbol{C}[\boldsymbol{x},\boldsymbol{y}] = \begin{bmatrix} \mathrm{cov}[\boldsymbol{x},\boldsymbol{x}] & \mathrm{cov}[\boldsymbol{x},\boldsymbol{y}] \\ - \mathrm{cov}[\boldsymbol{y},\boldsymbol{x}] & \mathrm{cov}[\boldsymbol{y},\boldsymbol{y}] \\ - \end{bmatrix}, -$$ - -where for example - -$$ -\mathrm{cov}[\boldsymbol{x},\boldsymbol{y}] =\frac{1}{n} \sum_{i=0}^{n-1}(x_i- \overline{x})(y_i- \overline{y}). -$$ - -With this definition and recalling that the variance is defined as - -$$ -\mathrm{var}[\boldsymbol{x}]=\frac{1}{n} \sum_{i=0}^{n-1}(x_i- \overline{x})^2, -$$ - -we can rewrite the covariance matrix as - -$$ -\boldsymbol{C}[\boldsymbol{x},\boldsymbol{y}] = \begin{bmatrix} \mathrm{var}[\boldsymbol{x}] & \mathrm{cov}[\boldsymbol{x},\boldsymbol{y}] \\ - \mathrm{cov}[\boldsymbol{x},\boldsymbol{y}] & \mathrm{var}[\boldsymbol{y}] \\ - \end{bmatrix}. -$$ - -**Note:** we have used $1/n$ in the above definitions of the *sample* variance and covariance. We assume then that we can calculate the exact mean value. -What you will find in essentially all statistics texts are equations -with a factor $1/(n-1)$. This is called [Bessel's correction](https://mathworld.wolfram.com/BesselsCorrection.html). This -method corrects the bias in the estimation of the population variance -and covariance. It also partially corrects the bias in the estimation -of the population standard deviation. If you use a library like -**Scikit-Learn** or **nunmpy's** function calculate the covariance, this -quantity will be computed with a factor $1/(n-1)$. - - -The covariance takes values between zero and infinity and may thus -lead to problems with loss of numerical precision for particularly -large values. It is common to scale the covariance matrix by -introducing instead the correlation matrix defined via the so-called -correlation function - -$$ -\mathrm{corr}[\boldsymbol{x},\boldsymbol{y}]=\frac{\mathrm{cov}[\boldsymbol{x},\boldsymbol{y}]}{\sqrt{\mathrm{var}[\boldsymbol{x}] \mathrm{var}[\boldsymbol{y}]}}. -$$ - -The correlation function is then given by values $\mathrm{corr}[\boldsymbol{x},\boldsymbol{y}] -\in [-1,1]$. This avoids eventual problems with too large values. We -can then define the correlation matrix for the two vectors $\boldsymbol{x}$ -and $\boldsymbol{y}$ as - -$$ -\boldsymbol{K}[\boldsymbol{x},\boldsymbol{y}] = \begin{bmatrix} 1 & \mathrm{corr}[\boldsymbol{x},\boldsymbol{y}] \\ - \mathrm{corr}[\boldsymbol{y},\boldsymbol{x}] & 1 \\ - \end{bmatrix}, -$$ - -In the above example this is the function we constructed using **pandas**. - - - -In our derivation of the various regression algorithms like **Ordinary Least Squares** or **Ridge regression** -we defined the design/feature matrix $\boldsymbol{X}$ as - -$$ -\boldsymbol{X}=\begin{bmatrix} -x_{0,0} & x_{0,1} & x_{0,2}& \dots & \dots x_{0,p-1}\\ -x_{1,0} & x_{1,1} & x_{1,2}& \dots & \dots x_{1,p-1}\\ -x_{2,0} & x_{2,1} & x_{2,2}& \dots & \dots x_{2,p-1}\\ -\dots & \dots & \dots & \dots \dots & \dots \\ -x_{n-2,0} & x_{n-2,1} & x_{n-2,2}& \dots & \dots x_{n-2,p-1}\\ -x_{n-1,0} & x_{n-1,1} & x_{n-1,2}& \dots & \dots x_{n-1,p-1}\\ -\end{bmatrix}, -$$ - -with $\boldsymbol{X}\in {\mathbb{R}}^{n\times p}$, with the predictors/features $p$ refering to the column numbers and the -entries $n$ being the row elements. -We can rewrite the design/feature matrix in terms of its column vectors as - -$$ -\boldsymbol{X}=\begin{bmatrix} \boldsymbol{x}_0 & \boldsymbol{x}_1 & \boldsymbol{x}_2 & \dots & \dots & \boldsymbol{x}_{p-1}\end{bmatrix}, -$$ - -with a given vector - -$$ -\boldsymbol{x}_i^T = \begin{bmatrix}x_{0,i} & x_{1,i} & x_{2,i}& \dots & \dots x_{n-1,i}\end{bmatrix}. -$$ - -With these definitions, we can now rewrite our $2\times 2$ -correlation/covariance matrix in terms of a moe general design/feature -matrix $\boldsymbol{X}\in {\mathbb{R}}^{n\times p}$. This leads to a $p\times p$ -covariance matrix for the vectors $\boldsymbol{x}_i$ with $i=0,1,\dots,p-1$ - -$$ -\boldsymbol{C}[\boldsymbol{x}] = \begin{bmatrix} -\mathrm{var}[\boldsymbol{x}_0] & \mathrm{cov}[\boldsymbol{x}_0,\boldsymbol{x}_1] & \mathrm{cov}[\boldsymbol{x}_0,\boldsymbol{x}_2] & \dots & \dots & \mathrm{cov}[\boldsymbol{x}_0,\boldsymbol{x}_{p-1}]\\ -\mathrm{cov}[\boldsymbol{x}_1,\boldsymbol{x}_0] & \mathrm{var}[\boldsymbol{x}_1] & \mathrm{cov}[\boldsymbol{x}_1,\boldsymbol{x}_2] & \dots & \dots & \mathrm{cov}[\boldsymbol{x}_1,\boldsymbol{x}_{p-1}]\\ -\mathrm{cov}[\boldsymbol{x}_2,\boldsymbol{x}_0] & \mathrm{cov}[\boldsymbol{x}_2,\boldsymbol{x}_1] & \mathrm{var}[\boldsymbol{x}_2] & \dots & \dots & \mathrm{cov}[\boldsymbol{x}_2,\boldsymbol{x}_{p-1}]\\ -\dots & \dots & \dots & \dots & \dots & \dots \\ -\dots & \dots & \dots & \dots & \dots & \dots \\ -\mathrm{cov}[\boldsymbol{x}_{p-1},\boldsymbol{x}_0] & \mathrm{cov}[\boldsymbol{x}_{p-1},\boldsymbol{x}_1] & \mathrm{cov}[\boldsymbol{x}_{p-1},\boldsymbol{x}_{2}] & \dots & \dots & \mathrm{var}[\boldsymbol{x}_{p-1}]\\ -\end{bmatrix}, -$$ - -and the correlation matrix - -$$ -\boldsymbol{K}[\boldsymbol{x}] = \begin{bmatrix} -1 & \mathrm{corr}[\boldsymbol{x}_0,\boldsymbol{x}_1] & \mathrm{corr}[\boldsymbol{x}_0,\boldsymbol{x}_2] & \dots & \dots & \mathrm{corr}[\boldsymbol{x}_0,\boldsymbol{x}_{p-1}]\\ -\mathrm{corr}[\boldsymbol{x}_1,\boldsymbol{x}_0] & 1 & \mathrm{corr}[\boldsymbol{x}_1,\boldsymbol{x}_2] & \dots & \dots & \mathrm{corr}[\boldsymbol{x}_1,\boldsymbol{x}_{p-1}]\\ -\mathrm{corr}[\boldsymbol{x}_2,\boldsymbol{x}_0] & \mathrm{corr}[\boldsymbol{x}_2,\boldsymbol{x}_1] & 1 & \dots & \dots & \mathrm{corr}[\boldsymbol{x}_2,\boldsymbol{x}_{p-1}]\\ -\dots & \dots & \dots & \dots & \dots & \dots \\ -\dots & \dots & \dots & \dots & \dots & \dots \\ -\mathrm{corr}[\boldsymbol{x}_{p-1},\boldsymbol{x}_0] & \mathrm{corr}[\boldsymbol{x}_{p-1},\boldsymbol{x}_1] & \mathrm{corr}[\boldsymbol{x}_{p-1},\boldsymbol{x}_{2}] & \dots & \dots & 1\\ -\end{bmatrix}, -$$ - -The Numpy function **np.cov** calculates the covariance elements using -the factor $1/(n-1)$ instead of $1/n$ since it assumes we do not have -the exact mean values. The following simple function uses the -**np.vstack** function which takes each vector of dimension $1\times n$ -and produces a $2\times n$ matrix $\boldsymbol{W}$ - -Note that this assumes you have the features as the rows, and the inputs as columns, that is - -$$ -\boldsymbol{W} = \begin{bmatrix} x_0 & x_1 & x_2 & \dots & x_{n-2} & x_{n-1} \\ - y_0 & y_1 & y_2 & \dots & y_{n-2} & y_{n-1} \\ - \end{bmatrix}, -$$ - -which in turn is converted into into the $2\times 2$ covariance matrix -$\boldsymbol{C}$ via the Numpy function **np.cov()**. We note that we can also calculate -the mean value of each set of samples $\boldsymbol{x}$ etc using the Numpy -function **np.mean(x)**. We can also extract the eigenvalues of the -covariance matrix through the **np.linalg.eig()** function. - -# Importing various packages -import numpy as np -n = 100 -x = np.random.normal(size=n) -print(np.mean(x)) -y = 4+3*x+np.random.normal(size=n) -print(np.mean(y)) -W = np.vstack((x, y)) -C = np.cov(W) -print(C) - -The previous example can be converted into the correlation matrix by -simply scaling the matrix elements with the variances. We should also -subtract the mean values for each column. This leads to the following -code which sets up the correlations matrix for the previous example in -a more brute force way. Here we scale the mean values for each column of the design matrix, calculate the relevant mean values and variances and then finally set up the $2\times 2$ correlation matrix (since we have only two vectors). - -import numpy as np -n = 100 -# define two vectors -x = np.random.random(size=n) -y = 4+3*x+np.random.normal(size=n) -#scaling the x and y vectors -x = x - np.mean(x) -y = y - np.mean(y) -variance_x = np.sum(x@x)/n -variance_y = np.sum(y@y)/n -print(variance_x) -print(variance_y) -cov_xy = np.sum(x@y)/n -cov_xx = np.sum(x@x)/n -cov_yy = np.sum(y@y)/n -C = np.zeros((2,2)) -C[0,0]= cov_xx/variance_x -C[1,1]= cov_yy/variance_y -C[0,1]= cov_xy/np.sqrt(variance_y*variance_x) -C[1,0]= C[0,1] -print(C) - -We see that the matrix elements along the diagonal are one as they -should be and that the matrix is symmetric. Furthermore, diagonalizing -this matrix we easily see that it is a positive definite matrix. - -The above procedure with **numpy** can be made more compact if we use **pandas**. - - - -We whow here how we can set up the correlation matrix using **pandas**, as done in this simple code - -import numpy as np -import pandas as pd -n = 10 -x = np.random.normal(size=n) -x = x - np.mean(x) -y = 4+3*x+np.random.normal(size=n) -y = y - np.mean(y) -# Note that we transpose the matrix in order to stay with our ordering n x p -X = (np.vstack((x, y))).T -print(X) -Xpd = pd.DataFrame(X) -print(Xpd) -correlation_matrix = Xpd.corr() -print(correlation_matrix) - -We expand this model to the Franke function discussed earlier. - -# Common imports -import numpy as np -import pandas as pd - - -def FrankeFunction(x,y): - term1 = 0.75*np.exp(-(0.25*(9*x-2)**2) - 0.25*((9*y-2)**2)) - term2 = 0.75*np.exp(-((9*x+1)**2)/49.0 - 0.1*(9*y+1)) - term3 = 0.5*np.exp(-(9*x-7)**2/4.0 - 0.25*((9*y-3)**2)) - term4 = -0.2*np.exp(-(9*x-4)**2 - (9*y-7)**2) - return term1 + term2 + term3 + term4 - - -def create_X(x, y, n ): - if len(x.shape) > 1: - x = np.ravel(x) - y = np.ravel(y) - - N = len(x) - l = int((n+1)*(n+2)/2) # Number of elements in beta - X = np.ones((N,l)) - - for i in range(1,n+1): - q = int((i)*(i+1)/2) - for k in range(i+1): - X[:,q+k] = (x**(i-k))*(y**k) - - return X - - -# Making meshgrid of datapoints and compute Franke's function -n = 4 -N = 100 -x = np.sort(np.random.uniform(0, 1, N)) -y = np.sort(np.random.uniform(0, 1, N)) -z = FrankeFunction(x, y) -X = create_X(x, y, n=n) - -Xpd = pd.DataFrame(X) -# subtract the mean values and set up the covariance matrix -Xpd = Xpd - Xpd.mean() -covariance_matrix = Xpd.cov() -print(covariance_matrix) - -We note here that the covariance is zero for the first rows and -columns since all matrix elements in the design matrix were set to one -(we are fitting the function in terms of a polynomial of degree $n$). - -This means that the variance for these elements will be zero and will -cause problems when we set up the correlation matrix. We can simply -drop these elements and construct a correlation -matrix without these elements. - - - -We can rewrite the covariance matrix in a more compact form in terms of the design/feature matrix $\boldsymbol{X}$ as - -$$ -\boldsymbol{C}[\boldsymbol{x}] = \frac{1}{n}\boldsymbol{X}^T\boldsymbol{X}= \mathbb{E}[\boldsymbol{X}^T\boldsymbol{X}]. -$$ - -To see this let us simply look at a design matrix $\boldsymbol{X}\in {\mathbb{R}}^{2\times 2}$ - -$$ -\boldsymbol{X}=\begin{bmatrix} -x_{00} & x_{01}\\ -x_{10} & x_{11}\\ -\end{bmatrix}=\begin{bmatrix} -\boldsymbol{x}_{0} & \boldsymbol{x}_{1}\\ -\end{bmatrix}. -$$ - -If we then compute the expectation value (note the $1/n$ factor instead of $1/(n-1)$) - -$$ -\mathbb{E}[\boldsymbol{X}^T\boldsymbol{X}] = \frac{1}{n}\boldsymbol{X}^T\boldsymbol{X}=\frac{1}{n}\begin{bmatrix} -x_{00}^2+x_{10}^2 & x_{00}x_{01}+x_{10}x_{11}\\ -x_{01}x_{00}+x_{11}x_{10} & x_{01}^2+x_{11}^2\\ -\end{bmatrix}, -$$ - -which is just - -$$ -\boldsymbol{C}[\boldsymbol{x}_0,\boldsymbol{x}_1] = \boldsymbol{C}[\boldsymbol{x}]=\begin{bmatrix} \mathrm{var}[\boldsymbol{x}_0] & \mathrm{cov}[\boldsymbol{x}_0,\boldsymbol{x}_1] \\ - \mathrm{cov}[\boldsymbol{x}_1,\boldsymbol{x}_0] & \mathrm{var}[\boldsymbol{x}_1] \\ - \end{bmatrix}, -$$ - -where we wrote $$\boldsymbol{C}[\boldsymbol{x}_0,\boldsymbol{x}_1] = \boldsymbol{C}[\boldsymbol{x}]$$ to indicate that this is the covariance of the vectors $\boldsymbol{x}$ of the design/feature matrix $\boldsymbol{X}$. - -It is easy to generalize this to a matrix $\boldsymbol{X}\in {\mathbb{R}}^{n\times p}$. - - - -## Linking with the SVD - -We saw earlier that - -$$ -\boldsymbol{X}^T\boldsymbol{X}=\boldsymbol{V}\boldsymbol{\Sigma}^T\boldsymbol{U}^T\boldsymbol{U}\boldsymbol{\Sigma}\boldsymbol{V}^T=\boldsymbol{V}\boldsymbol{\Sigma}^T\boldsymbol{\Sigma}\boldsymbol{V}^T. -$$ - -Since the matrices here have dimension $p\times p$, with $p$ corresponding to the singular values, we defined earlier the matrix - -$$ -\boldsymbol{\Sigma}^T\boldsymbol{\Sigma} = \begin{bmatrix} \tilde{\boldsymbol{\Sigma}} & \boldsymbol{0}\\ \end{bmatrix}\begin{bmatrix} \tilde{\boldsymbol{\Sigma}} \\ \boldsymbol{0}\\ \end{bmatrix}, -$$ - -where the tilde-matrix $\tilde{\boldsymbol{\Sigma}}$ is a matrix of dimension $p\times p$ containing only the singular values $\sigma_i$, that is - -$$ -\tilde{\boldsymbol{\Sigma}}=\begin{bmatrix} \sigma_0 & 0 & 0 & \dots & 0 & 0 \\ - 0 & \sigma_1 & 0 & \dots & 0 & 0 \\ - 0 & 0 & \sigma_2 & \dots & 0 & 0 \\ - 0 & 0 & 0 & \dots & \sigma_{p-2} & 0 \\ - 0 & 0 & 0 & \dots & 0 & \sigma_{p-1} \\ -\end{bmatrix}, -$$ - -meaning we can write - -$$ -\boldsymbol{X}^T\boldsymbol{X}=\boldsymbol{V}\tilde{\boldsymbol{\Sigma}}^2\boldsymbol{V}^T. -$$ - -Multiplying from the right with $\boldsymbol{V}$ (using the orthogonality of $\boldsymbol{V}$) we get - -$$ -\left(\boldsymbol{X}^T\boldsymbol{X}\right)\boldsymbol{V}=\boldsymbol{V}\tilde{\boldsymbol{\Sigma}}^2. -$$ - -This means the vectors $\boldsymbol{v}_i$ of the orthogonal matrix $\boldsymbol{V}$ -are the eigenvectors of the matrix $\boldsymbol{X}^T\boldsymbol{X}$ with eigenvalues -given by the singular values squared, that is - -$$ -\left(\boldsymbol{X}^T\boldsymbol{X}\right)\boldsymbol{v}_i=\boldsymbol{v}_i\sigma_i^2. -$$ - -In other words, each non-zero singular value of $\boldsymbol{X}$ is a positive -square root of an eigenvalue of $\boldsymbol{X}^T\boldsymbol{X}$. It means also that -the columns of $\boldsymbol{V}$ are the eigenvectors of -$\boldsymbol{X}^T\boldsymbol{X}$. Since we have ordered the singular values of -$\boldsymbol{X}$ in a descending order, it means that the column vectors -$\boldsymbol{v}_i$ are hierarchically ordered by how much correlation they -encode from the columns of $\boldsymbol{X}$. - - -Note that these are also the eigenvectors and eigenvalues of the -Hessian matrix. - -If we now recall the definition of the covariance matrix (not using -Bessel's correction) we have - -$$ -\boldsymbol{C}[\boldsymbol{X}]=\frac{1}{n}\boldsymbol{X}^T\boldsymbol{X}, -$$ - -meaning that every squared non-singular value of $\boldsymbol{X}$ divided by $n$ ( -the number of samples) are the eigenvalues of the covariance -matrix. Every singular value of $\boldsymbol{X}$ is thus a positive square -root of an eigenvalue of $\boldsymbol{X}^T\boldsymbol{X}$. If the matrix $\boldsymbol{X}$ is -self-adjoint, the singular values of $\boldsymbol{X}$ are equal to the -absolute value of the eigenvalues of $\boldsymbol{X}$. - - -For $\boldsymbol{X}\boldsymbol{X}^T$ we found - -$$ -\boldsymbol{X}\boldsymbol{X}^T=\boldsymbol{U}\boldsymbol{\Sigma}\boldsymbol{V}^T\boldsymbol{V}\boldsymbol{\Sigma}^T\boldsymbol{U}^T=\boldsymbol{U}\boldsymbol{\Sigma}^T\boldsymbol{\Sigma}\boldsymbol{U}^T. -$$ - -Since the matrices here have dimension $n\times n$, we have - -$$ -\boldsymbol{\Sigma}\boldsymbol{\Sigma}^T = \begin{bmatrix} \tilde{\boldsymbol{\Sigma}} \\ \boldsymbol{0}\\ \end{bmatrix}\begin{bmatrix} \tilde{\boldsymbol{\Sigma}} \boldsymbol{0}\\ \end{bmatrix}=\begin{bmatrix} \tilde{\boldsymbol{\Sigma}} & \boldsymbol{0} \\ \boldsymbol{0} & \boldsymbol{0}\\ \end{bmatrix}, -$$ - -leading to - -$$ -\boldsymbol{X}\boldsymbol{X}^T=\boldsymbol{U}\begin{bmatrix} \tilde{\boldsymbol{\Sigma}} & \boldsymbol{0} \\ \boldsymbol{0} & \boldsymbol{0}\\ \end{bmatrix}\boldsymbol{U}^T. -$$ - -Multiplying with $\boldsymbol{U}$ from the right gives us the eigenvalue problem - -$$ -(\boldsymbol{X}\boldsymbol{X}^T)\boldsymbol{U}=\boldsymbol{U}\begin{bmatrix} \tilde{\boldsymbol{\Sigma}} & \boldsymbol{0} \\ \boldsymbol{0} & \boldsymbol{0}\\ \end{bmatrix}. -$$ - -It means that the eigenvalues of $\boldsymbol{X}\boldsymbol{X}^T$ are again given by -the non-zero singular values plus now a series of zeros. The column -vectors of $\boldsymbol{U}$ are the eigenvectors of $\boldsymbol{X}\boldsymbol{X}^T$ and -measure how much correlations are contained in the rows of $\boldsymbol{X}$. - -Since we will mainly be interested in the correlations among the features -of our data (the columns of $\boldsymbol{X}$, the quantity of interest for us are the non-zero singular -values and the column vectors of $\boldsymbol{V}$. - - - - -## Ridge and Lasso Regression - -Let us remind ourselves about the expression for the standard Mean Squared Error (MSE) which we used to define our cost function and the equations for the ordinary least squares (OLS) method, that is -our optimization problem is - -$$ -{\displaystyle \min_{\boldsymbol{\beta}\in {\mathbb{R}}^{p}}}\frac{1}{n}\left\{\left(\boldsymbol{y}-\boldsymbol{X}\boldsymbol{\beta}\right)^T\left(\boldsymbol{y}-\boldsymbol{X}\boldsymbol{\beta}\right)\right\}. -$$ - -or we can state it as - -$$ -{\displaystyle \min_{\boldsymbol{\beta}\in -{\mathbb{R}}^{p}}}\frac{1}{n}\sum_{i=0}^{n-1}\left(y_i-\tilde{y}_i\right)^2=\frac{1}{n}\vert\vert \boldsymbol{y}-\boldsymbol{X}\boldsymbol{\beta}\vert\vert_2^2, -$$ - -where we have used the definition of a norm-2 vector, that is - -$$ -\vert\vert \boldsymbol{x}\vert\vert_2 = \sqrt{\sum_i x_i^2}. -$$ - -By minimizing the above equation with respect to the parameters -$\boldsymbol{\beta}$ we could then obtain an analytical expression for the -parameters $\boldsymbol{\beta}$. We can add a regularization parameter $\lambda$ by -defining a new cost function to be optimized, that is - -$$ -{\displaystyle \min_{\boldsymbol{\beta}\in -{\mathbb{R}}^{p}}}\frac{1}{n}\vert\vert \boldsymbol{y}-\boldsymbol{X}\boldsymbol{\beta}\vert\vert_2^2+\lambda\vert\vert \boldsymbol{\beta}\vert\vert_2^2 -$$ - -which leads to the Ridge regression minimization problem where we -require that $\vert\vert \boldsymbol{\beta}\vert\vert_2^2\le t$, where $t$ is -a finite number larger than zero. By defining - -$$ -C(\boldsymbol{X},\boldsymbol{\beta})=\frac{1}{n}\vert\vert \boldsymbol{y}-\boldsymbol{X}\boldsymbol{\beta}\vert\vert_2^2+\lambda\vert\vert \boldsymbol{\beta}\vert\vert_1, -$$ - -we have a new optimization equation - -$$ -{\displaystyle \min_{\boldsymbol{\beta}\in -{\mathbb{R}}^{p}}}\frac{1}{n}\vert\vert \boldsymbol{y}-\boldsymbol{X}\boldsymbol{\beta}\vert\vert_2^2+\lambda\vert\vert \boldsymbol{\beta}\vert\vert_1 -$$ - -which leads to Lasso regression. Lasso stands for least absolute shrinkage and selection operator. - -Here we have defined the norm-1 as - -$$ -\vert\vert \boldsymbol{x}\vert\vert_1 = \sum_i \vert x_i\vert. -$$ - -Using the matrix-vector expression for Ridge regression and dropping the parameter $1/n$ in front of the standard means squared error equation, we have - -$$ -C(\boldsymbol{X},\boldsymbol{\beta})=\left\{(\boldsymbol{y}-\boldsymbol{X}\boldsymbol{\beta})^T(\boldsymbol{y}-\boldsymbol{X}\boldsymbol{\beta})\right\}+\lambda\boldsymbol{\beta}^T\boldsymbol{\beta}, -$$ - -and -taking the derivatives with respect to $\boldsymbol{\beta}$ we obtain then -a slightly modified matrix inversion problem which for finite values -of $\lambda$ does not suffer from singularity problems. We obtain -the optimal parameters - -$$ -\hat{\boldsymbol{\beta}}_{\mathrm{Ridge}} = \left(\boldsymbol{X}^T\boldsymbol{X}+\lambda\boldsymbol{I}\right)^{-1}\boldsymbol{X}^T\boldsymbol{y}, -$$ - -with $\boldsymbol{I}$ being a $p\times p$ identity matrix with the constraint that - -$$ -\sum_{i=0}^{p-1} \beta_i^2 \leq t, -$$ - -with $t$ a finite positive number. - -When we compare this with the ordinary least squares result we have - -$$ -\hat{\boldsymbol{\beta}}_{\mathrm{OLS}} = \left(\boldsymbol{X}^T\boldsymbol{X}\right)^{-1}\boldsymbol{X}^T\boldsymbol{y}, -$$ - -which can lead to singular matrices. However, with the SVD, we can always compute the inverse of the matrix $\boldsymbol{X}^T\boldsymbol{X}$. - - -We see that Ridge regression is nothing but the standard OLS with a -modified diagonal term added to $\boldsymbol{X}^T\boldsymbol{X}$. The consequences, in -particular for our discussion of the bias-variance tradeoff are rather -interesting. We will see that for specific values of $\lambda$, we may -even reduce the variance of the optimal parameters $\boldsymbol{\beta}$. These topics and other related ones, will be discussed after the more linear algebra oriented analysis here. - - - -Using our insights about the SVD of the design matrix $\boldsymbol{X}$ -We have already analyzed the OLS solutions in terms of the eigenvectors (the columns) of the right singular value matrix $\boldsymbol{U}$ as - -$$ -\tilde{\boldsymbol{y}}_{\mathrm{OLS}}=\boldsymbol{X}\boldsymbol{\beta} =\boldsymbol{U}\boldsymbol{U}^T\boldsymbol{y}. -$$ - -For Ridge regression this becomes - -$$ -\tilde{\boldsymbol{y}}_{\mathrm{Ridge}}=\boldsymbol{X}\boldsymbol{\beta}_{\mathrm{Ridge}} = \boldsymbol{U\Sigma V^T}\left(\boldsymbol{V}\boldsymbol{\Sigma}^2\boldsymbol{V}^T+\lambda\boldsymbol{I} \right)^{-1}(\boldsymbol{U\Sigma V^T})^T\boldsymbol{y}=\sum_{j=0}^{p-1}\boldsymbol{u}_j\boldsymbol{u}_j^T\frac{\sigma_j^2}{\sigma_j^2+\lambda}\boldsymbol{y}, -$$ - -with the vectors $\boldsymbol{u}_j$ being the columns of $\boldsymbol{U}$ from the SVD of the matrix $\boldsymbol{X}$. - - - -Since $\lambda \geq 0$, it means that compared to OLS, we have - -$$ -\frac{\sigma_j^2}{\sigma_j^2+\lambda} \leq 1. -$$ - -Ridge regression finds the coordinates of $\boldsymbol{y}$ with respect to the -orthonormal basis $\boldsymbol{U}$, it then shrinks the coordinates by -$\frac{\sigma_j^2}{\sigma_j^2+\lambda}$. Recall that the SVD has -eigenvalues ordered in a descending way, that is $\sigma_i \geq -\sigma_{i+1}$. - -For small eigenvalues $\sigma_i$ it means that their contributions become less important, a fact which can be used to reduce the number of degrees of freedom. More about this when we have covered the material on a statistical interpretation of various linear regression methods. - - - -For the sake of simplicity, let us assume that the design matrix is orthonormal, that is - -$$ -\boldsymbol{X}^T\boldsymbol{X}=(\boldsymbol{X}^T\boldsymbol{X})^{-1} =\boldsymbol{I}. -$$ - -In this case the standard OLS results in - -$$ -\boldsymbol{\beta}^{\mathrm{OLS}} = \boldsymbol{X}^T\boldsymbol{y}=\sum_{i=0}^{p-1}\boldsymbol{u}_j\boldsymbol{u}_j^T\boldsymbol{y}, -$$ - -and - -$$ -\boldsymbol{\beta}^{\mathrm{Ridge}} = \left(\boldsymbol{I}+\lambda\boldsymbol{I}\right)^{-1}\boldsymbol{X}^T\boldsymbol{y}=\left(1+\lambda\right)^{-1}\boldsymbol{\beta}^{\mathrm{OLS}}, -$$ - -that is the Ridge estimator scales the OLS estimator by the inverse of a factor $1+\lambda$, and -the Ridge estimator converges to zero when the hyperparameter goes to -infinity. - -We will come back to more interpreations after we have gone through some of the statistical analysis part. - - - -Using the matrix-vector expression for Lasso regression and dropping the parameter $1/n$ in front of the standard mean squared error equation, we have the following **cost** function - -$$ -C(\boldsymbol{X},\boldsymbol{\beta})=\left\{(\boldsymbol{y}-\boldsymbol{X}\boldsymbol{\beta})^T(\boldsymbol{y}-\boldsymbol{X}\boldsymbol{\beta})\right\}+\lambda\vert\vert\boldsymbol{\beta}\vert\vert_1, -$$ - -Taking the derivative with respect to $\boldsymbol{\beta}$ and recalling that the derivative of the absolute value is (we drop the boldfaced vector symbol for simplicty) - -$$ -\frac{d \vert \beta\vert}{d \boldsymbol{\beta}}=\mathrm{sgn}(\boldsymbol{\beta})=\left\{\begin{array}{cc} 1 & \beta > 0 \\ 0 & \beta =0\\-1 & \beta < 0, \end{array}\right. -$$ - -we have that the derivative of the cost function is - -$$ -\frac{\partial C(\boldsymbol{X},\boldsymbol{\beta})}{\partial \boldsymbol{\beta}}=-2\boldsymbol{X}^T(\boldsymbol{y}-\boldsymbol{X}\boldsymbol{\beta})+\lambda sgn(\boldsymbol{\beta})=0, -$$ - -and reordering we have - -$$ -\boldsymbol{X}^T\boldsymbol{X}\boldsymbol{\beta}+\lambda sgn(\boldsymbol{\beta})=2\boldsymbol{X}^T\boldsymbol{y}. -$$ - -This equation does not lead to a nice analytical equation as in Ridge regression or ordinary least squares. This equation can however be solved by using standard convex optimization algorithms using for example the Python package [CVXOPT](https://cvxopt.org/). We will discuss this later. - - - - - -Let us assume that our design matrix is given by unit (identity) matrix, that is a square diagonal matrix with ones only along the -diagonal. In this case we have an equal number of rows and columns $n=p$. - -Our model approximation is just $\tilde{\boldsymbol{y}}=\boldsymbol{\beta}$ and the mean squared error and thereby the cost function for ordinary least sqquares (OLS) is then (we drop the term $1/n$) - -$$ -C(\boldsymbol{\beta})=\sum_{i=0}^{p-1}(y_i-\beta_i)^2, -$$ - -and minimizing we have that - -$$ -\hat{\beta}_i^{\mathrm{OLS}} = y_i. -$$ - -For Ridge regression our cost function is - -$$ -C(\boldsymbol{\beta})=\sum_{i=0}^{p-1}(y_i-\beta_i)^2+\lambda\sum_{i=0}^{p-1}\beta_i^2, -$$ - -and minimizing we have that - -$$ -\hat{\beta}_i^{\mathrm{Ridge}} = \frac{y_i}{1+\lambda}. -$$ - -For Lasso regression our cost function is - -$$ -C(\boldsymbol{\beta})=\sum_{i=0}^{p-1}(y_i-\beta_i)^2+\lambda\sum_{i=0}^{p-1}\vert\beta_i\vert=\sum_{i=0}^{p-1}(y_i-\beta_i)^2+\lambda\sum_{i=0}^{p-1}\sqrt{\beta_i^2}, -$$ - -and minimizing we have that - -$$ --2\sum_{i=0}^{p-1}(y_i-\beta_i)+\lambda \sum_{i=0}^{p-1}\frac{(\beta_i)}{\vert\beta_i\vert}=0, -$$ - -which leads to - -$$ -\hat{\boldsymbol{\beta}}_i^{\mathrm{Lasso}} = \left\{\begin{array}{ccc}y_i-\frac{\lambda}{2} &\mathrm{if} & y_i> \frac{\lambda}{2}\\ - y_i+\frac{\lambda}{2} &\mathrm{if} & y_i< -\frac{\lambda}{2}\\ - 0 &\mathrm{if} & \vert y_i\vert\le \frac{\lambda}{2}\end{array}\right.\\. -$$ - -Plotting these results ([figure in handwritten notes for week 36](https://github.com/CompPhysics/MachineLearning/blob/master/doc/HandWrittenNotes/2021/NotesSeptember9.pdf)) shows clearly that Lasso regression suppresses (sets to zero) values of $\beta_i$ for specific values of $\lambda$. Ridge regression reduces on the other hand the values of $\beta_i$ as function of $\lambda$. - - -As another examples, -let us assume we have a data set with outputs/targets given by the vector - -$$ -\boldsymbol{y}=\begin{bmatrix}4 \\ 2 \\3\end{bmatrix}, -$$ - -and our inputs as a $3\times 2$ design matrix - -$$ -\boldsymbol{X}=\begin{bmatrix}2 & 0\\ 0 & 1 \\ 0 & 0\end{bmatrix}, -$$ - -meaning that we have two features and two unknown parameters $\beta_0$ and $\beta_1$ to be determined either by ordinary least squares, Ridge or Lasso regression. - - -For ordinary least squares (OLS) we know that the optimal solution is - -$$ -\hat{\boldsymbol{\beta}}^{\mathrm{OLS}}=\left( \boldsymbol{X}^T\boldsymbol{X}\right)^{-1}\boldsymbol{X}^T\boldsymbol{y}. -$$ - -Inserting the above values we obtain that - -$$ -\hat{\boldsymbol{\beta}}^{\mathrm{OLS}}=\begin{bmatrix}2 \\ 2\end{bmatrix}, -$$ - -The code which implements this simpler case is presented after the discussion of Ridge and Lasso. - - -For Ridge regression we have - -$$ -\hat{\boldsymbol{\beta}}^{\mathrm{Ridge}}=\left( \boldsymbol{X}^T\boldsymbol{X}+\lambda\boldsymbol{I}\right)^{-1}\boldsymbol{X}^T\boldsymbol{y}. -$$ - -Inserting the above values we obtain that - -$$ -\hat{\boldsymbol{\beta}}^{\mathrm{Ridge}}=\begin{bmatrix}\frac{8}{4+\lambda} \\ \frac{2}{1+\lambda}\end{bmatrix}, -$$ - -There is normally a constraint on the value of $\vert\vert \boldsymbol{\beta}\vert\vert_2$ via the parameter $\lambda$. -Let us for simplicity assume that $\beta_0^2+\beta_1^2=1$ as constraint. This will allow us to find an expression for the optimal values of $\beta$ and $\lambda$. - -To see this, let us write the cost function for Ridge regression. - - - -We define the MSE without the $1/n$ factor and have then, using that - -$$ -\boldsymbol{X}\boldsymbol{\beta}=\begin{bmatrix} 2\beta_0 \\ \beta_1 \\0 \end{bmatrix}, -$$ - -$$ -C(\boldsymbol{\beta})=(4-2\beta_0)^2+(2-\beta_1)^2+\lambda(\beta_0^2+\beta_1^2), -$$ - -and taking the derivative with respect to $\beta_0$ we get - -$$ -\beta_0=\frac{8}{4+\lambda}, -$$ - -and for $\beta_1$ we obtain - -$$ -\beta_1=\frac{2}{1+\lambda}, -$$ - -Using the constraint for $\beta_0^2+\beta_1^2=1$ we can constrain $\lambda$ by solving - -$$ -\left(\frac{8}{4+\lambda}\right)^2+\left(\frac{2}{1+\lambda}\right)^2=1, -$$ - -which gives $\lambda=4.571$ and $\beta_0=0.933$ and $\beta_1=0.359$. - - -For Lasso we need now, keeping a constraint on $\vert\beta_0\vert+\vert\beta_1\vert=1$, to take the derivative of the absolute values of $\beta_0$ -and $\beta_1$. This gives us the following derivatives of the cost function - -$$ -C(\boldsymbol{\beta})=(4-2\beta_0)^2+(2-\beta_1)^2+\lambda(\vert\beta_0\vert+\vert\beta_1\vert), -$$ - -$$ -\frac{\partial C(\boldsymbol{\beta})}{\partial \beta_0}=-4(4-2\beta_0)+\lambda\mathrm{sgn}(\beta_0)=0, -$$ - -and - -$$ -\frac{\partial C(\boldsymbol{\beta})}{\partial \beta_1}=-2(2-\beta_1)+\lambda\mathrm{sgn}(\beta_1)=0. -$$ - -We have now four cases to solve besides the trivial cases $\beta_0$ and/or $\beta_1$ are zero, namely -1. $\beta_0 > 0$ and $\beta_1 > 0$, - -2. $\beta_0 > 0$ and $\beta_1 < 0$, - -3. $\beta_0 < 0$ and $\beta_1 > 0$, - -4. $\beta_0 < 0$ and $\beta_1 < 0$. - -If we consider the first case, we have then - -$$ --4(4-2\beta_0)+\lambda=0, -$$ - -and - -$$ --2(2-\beta_1)+\lambda=0. -$$ - -which yields - -$$ -\beta_0=\frac{16+\lambda}{8}, -$$ - -and - -$$ -\beta_1=\frac{4+\lambda}{2}. -$$ - -Using the constraint on $\beta_0$ and $\beta_1$ we can then find the optimal value of $\lambda$ for the different cases. We leave this as an exercise to you. - - -Here we set up the OLS, Ridge and Lasso functionality in order to study the above example. Note that here we have opted for a set of values of $\lambda$, meaning that we need to perform a search in order to find the optimal values. - -First we study and compare the OLS and Ridge results. The next code compares all three methods. -We select values of the hyperparameter $\lambda\in [10^{-4},10^4]$ and compute the predicted values for ordinary least squares and Ridge regression. - -%matplotlib inline - -import os -import numpy as np -import pandas as pd -import matplotlib.pyplot as plt - -def R2(y_data, y_model): - return 1 - np.sum((y_data - y_model) ** 2) / np.sum((y_data - np.mean(y_data)) ** 2) -def MSE(y_data,y_model): - n = np.size(y_model) - return np.sum((y_data-y_model)**2)/n - - -# A seed just to ensure that the random numbers are the same for every run. -# Useful for eventual debugging. - -X = np.array( [ [ 2, 0], [0, 1], [0,0]]) -y = np.array( [4, 2, 3]) - - -# matrix inversion to find beta -OLSbeta = np.linalg.inv(X.T @ X) @ X.T @ y -print(OLSbeta) -# and then make the prediction -ytildeOLS = X @ OLSbeta -print("Training MSE for OLS") -print(MSE(y,ytildeOLS)) -ypredictOLS = X @ OLSbeta - -# Repeat now for Ridge regression and various values of the regularization parameter -I = np.eye(2,2) -# Decide which values of lambda to use -nlambdas = 100 -MSEPredict = np.zeros(nlambdas) -lambdas = np.logspace(-4, 4, nlambdas) -for i in range(nlambdas): - lmb = lambdas[i] - Ridgebeta = np.linalg.inv(X.T @ X+lmb*I) @ X.T @ y -# print(Ridgebeta) - # and then make the prediction - ypredictRidge = X @ Ridgebeta - MSEPredict[i] = MSE(y,ypredictRidge) -# print(MSEPredict[i]) - # Now plot the results -plt.figure() -plt.plot(np.log10(lambdas), MSEPredict, 'r--', label = 'MSE Ridge Train') -plt.xlabel('log10(lambda)') -plt.ylabel('MSE') -plt.legend() -plt.show() - -We see here that we reach a plateau for the Ridge results. Writing out the coefficients $\boldsymbol{\beta}$, we that they are getting smaller and smaller and our error stabilizes since the predicted values of $\tilde{\boldsymbol{y}}$ approach zero. - -This happens also for Lasso regression, as seen from the next code -output. The difference is that Lasso shrinks the values of $\beta$ to -zero at a much earlier stage and the results flatten out. We see that -Lasso gives also an excellent fit for small values of $\lambda$ and -shows rthe best performance of the three regression methods. - -import os -import numpy as np -import pandas as pd -import matplotlib.pyplot as plt -from sklearn import linear_model - -def R2(y_data, y_model): - return 1 - np.sum((y_data - y_model) ** 2) / np.sum((y_data - np.mean(y_data)) ** 2) -def MSE(y_data,y_model): - n = np.size(y_model) - return np.sum((y_data-y_model)**2)/n - - -# A seed just to ensure that the random numbers are the same for every run. -# Useful for eventual debugging. - -X = np.array( [ [ 2, 0], [0, 1], [0,0]]) -y = np.array( [4, 2, 3]) - - -# matrix inversion to find beta -OLSbeta = np.linalg.inv(X.T @ X) @ X.T @ y -print(OLSbeta) -# and then make the prediction -ytildeOLS = X @ OLSbeta -print("Training MSE for OLS") -print(MSE(y,ytildeOLS)) -ypredictOLS = X @ OLSbeta - -# Repeat now for Ridge regression and various values of the regularization parameter -I = np.eye(2,2) -# Decide which values of lambda to use -nlambdas = 100 -MSERidgePredict = np.zeros(nlambdas) -MSELassoPredict = np.zeros(nlambdas) -lambdas = np.logspace(-4, 4, nlambdas) -for i in range(nlambdas): - lmb = lambdas[i] - Ridgebeta = np.linalg.inv(X.T @ X+lmb*I) @ X.T @ y - print(Ridgebeta) - # and then make the prediction - ypredictRidge = X @ Ridgebeta - MSERidgePredict[i] = MSE(y,ypredictRidge) - RegLasso = linear_model.Lasso(lmb) - RegLasso.fit(X,y) - ypredictLasso = RegLasso.predict(X) - print(RegLasso.coef_) - MSELassoPredict[i] = MSE(y,ypredictLasso) -# Now plot the results -plt.figure() -plt.plot(np.log10(lambdas), MSERidgePredict, 'r--', label = 'MSE Ridge Train') -plt.plot(np.log10(lambdas), MSELassoPredict, 'r--', label = 'MSE Lasso Train') -plt.xlabel('log10(lambda)') -plt.ylabel('MSE') -plt.legend() -plt.show() - -We bring then back our exponential function example and study all -three regression methods. Depending on the level of noise, we note -that for small values of the hyperparameter $\lambda$ all three -methods produce the same mean squared error. Again, Lasso shrinks the -parameter values to zero much earlier than Ridge regression and the -Lasso results flatten out much earlier since all $\beta_j=0$ (check -this by printing the values). This case is an example of where OLS -performs best. Lasso and Ridge reproduce the OLS results for a limited -set of $\lambda$ values. - -import os -import numpy as np -import pandas as pd -import matplotlib.pyplot as plt -from sklearn.model_selection import train_test_split -from sklearn import linear_model - -def R2(y_data, y_model): - return 1 - np.sum((y_data - y_model) ** 2) / np.sum((y_data - np.mean(y_data)) ** 2) -def MSE(y_data,y_model): - n = np.size(y_model) - return np.sum((y_data-y_model)**2)/n - - -# A seed just to ensure that the random numbers are the same for every run. -# Useful for eventual debugging. -np.random.seed(3155) - -x = np.random.rand(100) -y = 2.0+5*x*x+0.1*np.random.randn(100) - -# number of features p (here degree of polynomial -p = 3 -# The design matrix now as function of a given polynomial -X = np.zeros((len(x),p)) -X[:,0] = 1.0 -X[:,1] = x -X[:,2] = x*x -# We split the data in test and training data -X_train, X_test, y_train, y_test = train_test_split(X, y, test_size=0.2) - -# matrix inversion to find beta -OLSbeta = np.linalg.inv(X_train.T @ X_train) @ X_train.T @ y_train -print(OLSbeta) -# and then make the prediction -ytildeOLS = X_train @ OLSbeta -print("Training MSE for OLS") -print(MSE(y_train,ytildeOLS)) -ypredictOLS = X_test @ OLSbeta -print("Test MSE OLS") -print(MSE(y_test,ypredictOLS)) - -# Repeat now for Lasso and Ridge regression and various values of the regularization parameter -I = np.eye(p,p) -# Decide which values of lambda to use -nlambdas = 100 -MSEPredict = np.zeros(nlambdas) -MSETrain = np.zeros(nlambdas) -MSELassoPredict = np.zeros(nlambdas) -MSELassoTrain = np.zeros(nlambdas) -lambdas = np.logspace(-4, 4, nlambdas) -for i in range(nlambdas): - lmb = lambdas[i] - Ridgebeta = np.linalg.inv(X_train.T @ X_train+lmb*I) @ X_train.T @ y_train - # include lasso using Scikit-Learn - RegLasso = linear_model.Lasso(lmb) - RegLasso.fit(X_train,y_train) - # and then make the prediction - ytildeRidge = X_train @ Ridgebeta - ypredictRidge = X_test @ Ridgebeta - ytildeLasso = RegLasso.predict(X_train) - ypredictLasso = RegLasso.predict(X_test) - MSEPredict[i] = MSE(y_test,ypredictRidge) - MSETrain[i] = MSE(y_train,ytildeRidge) - MSELassoPredict[i] = MSE(y_test,ypredictLasso) - MSELassoTrain[i] = MSE(y_train,ytildeLasso) - -# Now plot the results -plt.figure() -plt.plot(np.log10(lambdas), MSETrain, label = 'MSE Ridge train') -plt.plot(np.log10(lambdas), MSEPredict, 'r--', label = 'MSE Ridge Test') -plt.plot(np.log10(lambdas), MSELassoTrain, label = 'MSE Lasso train') -plt.plot(np.log10(lambdas), MSELassoPredict, 'r--', label = 'MSE Lasso Test') - -plt.xlabel('log10(lambda)') -plt.ylabel('MSE') -plt.legend() -plt.show() - -Both these example send a clear message. The addition of a -shrinkage/regularization term implies that we need to perform a search -for the optimal values of $\lambda$. We will see this throughout these -series of lectures. - - -As a small addendum, we note that you can also solve this problem using the convex optimization package [CVXOPT](https://cvxopt.org/examples/mlbook/l1regls.html). This requires, in addition to having installed **CVXOPT**, you need to download the file *l1regl.py*. -The following code example solves the simpler problem we discussed above, where we have added the latter python file. - -from cvxopt import matrix, spdiag, mul, div, sqrt, normal, setseed -from cvxopt import blas, lapack, solvers, sparse, spmatrix -import math - -try: - import mosek - import sys - __MOSEK = True -except: __MOSEK = False - -if __MOSEK: - - def l1regls_mosek(A, b): - """ - - Returns the solution of l1-norm regularized least-squares problem - - minimize || A*x - b ||_2^2 + e'*u - - subject to -u <= x <= u - - """ - - m, n = A.size - - env = mosek.Env() - task = env.Task(0,0) - task.set_Stream(mosek.streamtype.log, lambda x: sys.stdout.write(x)) - - task.appendvars( 2*n) # number of variables - task.appendcons( 2*n) # number of constraints - - # input quadratic objective - Q = matrix(0.0, (n,n)) - blas.syrk(A, Q, alpha = 2.0, trans='T') - - I = [] - for i in range(n): - I.extend(range(i,n)) - - J = [] - for i in range(n): - J.extend((n-i)*[i]) - - task.putqobj(I, J, list(Q[matrix(I) + matrix(J)*n])) - task.putclist(range(2*n), list(-2*A.T*b) + n*[1.0]) # setup linear objective - - # input constraint matrix row by row - for i in range(n): - task.putarow( i, [i, n+i], [1.0, -1.0]) - task.putarow( n+i, [i, n+i], [1.0, 1.0]) - - # setup bounds on constraints - task.putboundslice(mosek.accmode.con, - 0, n, n*[mosek.boundkey.up], n*[0.0], n*[0.0]) - task.putboundslice(mosek.accmode.con, - n, 2*n, n*[mosek.boundkey.lo], n*[0.0], n*[0.0]) - - # setup variable bounds - task.putboundslice(mosek.accmode.var, - 0, 2*n, 2*n*[mosek.boundkey.fr], 2*n*[0.0], 2*n*[0.0]) - - # optimize the task - task.putobjsense(mosek.objsense.minimize) - task.optimize() - task.solutionsummary(mosek.streamtype.log) - x = n*[0.0] - task.getsolutionslice(mosek.soltype.itr, mosek.solitem.xx, 0, n, x) - - return matrix(x) - - def l1regls_mosek2(A, b): - """ - - Returns the solution of l1-norm regularized least-squares problem - - minimize w'*w + e'*u - - subject to -u <= x <= u - - A*x - w = b - - """ - - m, n = A.size - - env = mosek.Env() - task = env.Task(0,0) - task.set_Stream(mosek.streamtype.log, lambda x: sys.stdout.write(x)) - - task.appendvars(2*n + m) # number of variables - task.appendcons(2*n + m) # number of constraints - - # input quadratic objective - task.putqobj(range(2*n,2*n+m), range(2*n,2*n+m), m*[2.0]) - - task.putclist(range(2*n+m), n*[0.0] + n*[1.0] + m*[0.0]) # setup linear objective - - # input constraint matrix row by row - for i in range(n): - task.putarow( i, [i, n+i], [1.0, -1.0]) - task.putarow( n+i, [i, n+i], [1.0, 1.0]) - - for i in range(m): - task.putarow( 2*n+i, range(n) + [2*n+i], list(A[i,:]) + [-1.0]) - - # setup bounds on constraints - task.putboundslice(mosek.accmode.con, - 0, n, n*[mosek.boundkey.up], n*[0.0], n*[0.0]) - task.putboundslice(mosek.accmode.con, - n, 2*n, n*[mosek.boundkey.lo], n*[0.0], n*[0.0]) - task.putboundslice(mosek.accmode.con, - 2*n, 2*n+m, m*[mosek.boundkey.fx], list(b), list(b)) - - # setup variable bounds - task.putboundslice(mosek.accmode.var, 0, 2*n+m, (2*n+m)*[mosek.boundkey.fr], - (2*n+m)*[0.0], (2*n+m)*[0.0]) - - # optimize the task - task.putobjsense(mosek.objsense.minimize) - task.optimize() - task.solutionsummary(mosek.streamtype.log) - x = n*[0.0] - task.getsolutionslice(mosek.soltype.itr, mosek.solitem.xx, 0, n, x) - - return matrix(x) - -def l1regls(A, b): - """ - - Returns the solution of l1-norm regularized least-squares problem - - minimize || A*x - b ||_2^2 + || x ||_1. - - """ - - m, n = A.size - q = matrix(1.0, (2*n,1)) - q[:n] = -2.0 * A.T * b - - def P(u, v, alpha = 1.0, beta = 0.0 ): - """ - v := alpha * 2.0 * [ A'*A, 0; 0, 0 ] * u + beta * v - """ - v *= beta - v[:n] += alpha * 2.0 * A.T * (A * u[:n]) - - - def G(u, v, alpha=1.0, beta=0.0, trans='N'): - """ - v := alpha*[I, -I; -I, -I] * u + beta * v (trans = 'N' or 'T') - """ - - v *= beta - v[:n] += alpha*(u[:n] - u[n:]) - v[n:] += alpha*(-u[:n] - u[n:]) - - h = matrix(0.0, (2*n,1)) - - - # Customized solver for the KKT system - # - # [ 2.0*A'*A 0 I -I ] [x[:n] ] [bx[:n] ] - # [ 0 0 -I -I ] [x[n:] ] = [bx[n:] ]. - # [ I -I -D1^-1 0 ] [zl[:n]] [bzl[:n]] - # [ -I -I 0 -D2^-1 ] [zl[n:]] [bzl[n:]] - # - # where D1 = W['di'][:n]**2, D2 = W['di'][:n]**2. - # - # We first eliminate zl and x[n:]: - # - # ( 2*A'*A + 4*D1*D2*(D1+D2)^-1 ) * x[:n] = - # bx[:n] - (D2-D1)*(D1+D2)^-1 * bx[n:] + - # D1 * ( I + (D2-D1)*(D1+D2)^-1 ) * bzl[:n] - - # D2 * ( I - (D2-D1)*(D1+D2)^-1 ) * bzl[n:] - # - # x[n:] = (D1+D2)^-1 * ( bx[n:] - D1*bzl[:n] - D2*bzl[n:] ) - # - (D2-D1)*(D1+D2)^-1 * x[:n] - # - # zl[:n] = D1 * ( x[:n] - x[n:] - bzl[:n] ) - # zl[n:] = D2 * (-x[:n] - x[n:] - bzl[n:] ). - # - # The first equation has the form - # - # (A'*A + D)*x[:n] = rhs - # - # and is equivalent to - # - # [ D A' ] [ x:n] ] = [ rhs ] - # [ A -I ] [ v ] [ 0 ]. - # - # It can be solved as - # - # ( A*D^-1*A' + I ) * v = A * D^-1 * rhs - # x[:n] = D^-1 * ( rhs - A'*v ). - - S = matrix(0.0, (m,m)) - Asc = matrix(0.0, (m,n)) - v = matrix(0.0, (m,1)) - - def Fkkt(W): - - # Factor - # - # S = A*D^-1*A' + I - # - # where D = 2*D1*D2*(D1+D2)^-1, D1 = d[:n]**-2, D2 = d[n:]**-2. - - d1, d2 = W['di'][:n]**2, W['di'][n:]**2 - - # ds is square root of diagonal of D - ds = math.sqrt(2.0) * div( mul( W['di'][:n], W['di'][n:]), - sqrt(d1+d2) ) - d3 = div(d2 - d1, d1 + d2) - - # Asc = A*diag(d)^-1/2 - Asc = A * spdiag(ds**-1) - - # S = I + A * D^-1 * A' - blas.syrk(Asc, S) - S[::m+1] += 1.0 - lapack.potrf(S) - - def g(x, y, z): - - x[:n] = 0.5 * ( x[:n] - mul(d3, x[n:]) + - mul(d1, z[:n] + mul(d3, z[:n])) - mul(d2, z[n:] - - mul(d3, z[n:])) ) - x[:n] = div( x[:n], ds) - - # Solve - # - # S * v = 0.5 * A * D^-1 * ( bx[:n] - - # (D2-D1)*(D1+D2)^-1 * bx[n:] + - # D1 * ( I + (D2-D1)*(D1+D2)^-1 ) * bzl[:n] - - # D2 * ( I - (D2-D1)*(D1+D2)^-1 ) * bzl[n:] ) - - blas.gemv(Asc, x, v) - lapack.potrs(S, v) - - # x[:n] = D^-1 * ( rhs - A'*v ). - blas.gemv(Asc, v, x, alpha=-1.0, beta=1.0, trans='T') - x[:n] = div(x[:n], ds) - - # x[n:] = (D1+D2)^-1 * ( bx[n:] - D1*bzl[:n] - D2*bzl[n:] ) - # - (D2-D1)*(D1+D2)^-1 * x[:n] - x[n:] = div( x[n:] - mul(d1, z[:n]) - mul(d2, z[n:]), d1+d2 )\ - - mul( d3, x[:n] ) - - # zl[:n] = D1^1/2 * ( x[:n] - x[n:] - bzl[:n] ) - # zl[n:] = D2^1/2 * ( -x[:n] - x[n:] - bzl[n:] ). - z[:n] = mul( W['di'][:n], x[:n] - x[n:] - z[:n] ) - z[n:] = mul( W['di'][n:], -x[:n] - x[n:] - z[n:] ) - - return g - - return solvers.coneqp(P, q, G, h, kktsolver = Fkkt)['x'][:n] - -Then we call the above functions and solve the problem, as done here - -from cvxopt import matrix, normal - -X = matrix( [ [ 2, 0, 1], [0, 1, 3]]) -y = matrix( [4, 2, 3]) -x = l1regls(X,y) - -**More text will be added to this example.** - -## Linking the regression analysis with a statistical interpretation - -We will now couple the discussions of ordinary least squares, Ridge -and Lasso regression with a statistical interpretation, that is we -move from a linear algebra analysis to a statistical analysis. In -particular, we will focus on what the regularization terms can result -in. We will amongst other things show that the regularization -parameter can reduce considerably the variance of the parameters -$\beta$. - - -The -advantage of doing linear regression is that we actually end up with -analytical expressions for several statistical quantities. -Standard least squares and Ridge regression allow us to -derive quantities like the variance and other expectation values in a -rather straightforward way. - - -It is assumed that $\varepsilon_i -\sim \mathcal{N}(0, \sigma^2)$ and the $\varepsilon_{i}$ are -independent, i.e.: - -$$ -\begin{align*} -\mbox{Cov}(\varepsilon_{i_1}, -\varepsilon_{i_2}) & = \left\{ \begin{array}{lcc} \sigma^2 & \mbox{if} -& i_1 = i_2, \\ 0 & \mbox{if} & i_1 \not= i_2. \end{array} \right. -\end{align*} -$$ - -The randomness of $\varepsilon_i$ implies that -$\mathbf{y}_i$ is also a random variable. In particular, -$\mathbf{y}_i$ is normally distributed, because $\varepsilon_i \sim -\mathcal{N}(0, \sigma^2)$ and $\mathbf{X}_{i,\ast} \, \boldsymbol{\beta}$ is a -non-random scalar. To specify the parameters of the distribution of -$\mathbf{y}_i$ we need to calculate its first two moments. - -Recall that $\boldsymbol{X}$ is a matrix of dimensionality $n\times p$. The -notation above $\mathbf{X}_{i,\ast}$ means that we are looking at the -row number $i$ and perform a sum over all values $p$. - - - -The assumption we have made here can be summarized as (and this is going to be useful when we discuss the bias-variance trade off) -that there exists a function $f(\boldsymbol{x})$ and a normal distributed error $\boldsymbol{\varepsilon}\sim \mathcal{N}(0, \sigma^2)$ -which describe our data - -$$ -\boldsymbol{y} = f(\boldsymbol{x})+\boldsymbol{\varepsilon} -$$ - -We approximate this function with our model from the solution of the linear regression equations, that is our -function $f$ is approximated by $\boldsymbol{\tilde{y}}$ where we want to minimize $(\boldsymbol{y}-\boldsymbol{\tilde{y}})^2$, our MSE, with - -$$ -\boldsymbol{\tilde{y}} = \boldsymbol{X}\boldsymbol{\beta}. -$$ - -We can calculate the expectation value of $\boldsymbol{y}$ for a given element $i$ - -$$ -\begin{align*} -\mathbb{E}(y_i) & = -\mathbb{E}(\mathbf{X}_{i, \ast} \, \boldsymbol{\beta}) + \mathbb{E}(\varepsilon_i) -\, \, \, = \, \, \, \mathbf{X}_{i, \ast} \, \beta, -\end{align*} -$$ - -while -its variance is - -$$ -\begin{align*} \mbox{Var}(y_i) & = \mathbb{E} \{ [y_i -- \mathbb{E}(y_i)]^2 \} \, \, \, = \, \, \, \mathbb{E} ( y_i^2 ) - -[\mathbb{E}(y_i)]^2 \\ & = \mathbb{E} [ ( \mathbf{X}_{i, \ast} \, -\beta + \varepsilon_i )^2] - ( \mathbf{X}_{i, \ast} \, \boldsymbol{\beta})^2 \\ & -= \mathbb{E} [ ( \mathbf{X}_{i, \ast} \, \boldsymbol{\beta})^2 + 2 \varepsilon_i -\mathbf{X}_{i, \ast} \, \boldsymbol{\beta} + \varepsilon_i^2 ] - ( \mathbf{X}_{i, -\ast} \, \beta)^2 \\ & = ( \mathbf{X}_{i, \ast} \, \boldsymbol{\beta})^2 + 2 -\mathbb{E}(\varepsilon_i) \mathbf{X}_{i, \ast} \, \boldsymbol{\beta} + -\mathbb{E}(\varepsilon_i^2 ) - ( \mathbf{X}_{i, \ast} \, \boldsymbol{\beta})^2 -\\ & = \mathbb{E}(\varepsilon_i^2 ) \, \, \, = \, \, \, -\mbox{Var}(\varepsilon_i) \, \, \, = \, \, \, \sigma^2. -\end{align*} -$$ - -Hence, $y_i \sim \mathcal{N}( \mathbf{X}_{i, \ast} \, \boldsymbol{\beta}, \sigma^2)$, that is $\boldsymbol{y}$ follows a normal distribution with -mean value $\boldsymbol{X}\boldsymbol{\beta}$ and variance $\sigma^2$ (not be confused with the singular values of the SVD). - - -With the OLS expressions for the parameters $\boldsymbol{\beta}$ we can evaluate the expectation value - -$$ -\mathbb{E}(\boldsymbol{\beta}) = \mathbb{E}[ (\mathbf{X}^{\top} \mathbf{X})^{-1}\mathbf{X}^{T} \mathbf{Y}]=(\mathbf{X}^{T} \mathbf{X})^{-1}\mathbf{X}^{T} \mathbb{E}[ \mathbf{Y}]=(\mathbf{X}^{T} \mathbf{X})^{-1} \mathbf{X}^{T}\mathbf{X}\boldsymbol{\beta}=\boldsymbol{\beta}. -$$ - -This means that the estimator of the regression parameters is unbiased. - -We can also calculate the variance - -The variance of $\boldsymbol{\beta}$ is - -$$ -\begin{eqnarray*} -\mbox{Var}(\boldsymbol{\beta}) & = & \mathbb{E} \{ [\boldsymbol{\beta} - \mathbb{E}(\boldsymbol{\beta})] [\boldsymbol{\beta} - \mathbb{E}(\boldsymbol{\beta})]^{T} \} -\\ -& = & \mathbb{E} \{ [(\mathbf{X}^{T} \mathbf{X})^{-1} \, \mathbf{X}^{T} \mathbf{Y} - \boldsymbol{\beta}] \, [(\mathbf{X}^{T} \mathbf{X})^{-1} \, \mathbf{X}^{T} \mathbf{Y} - \boldsymbol{\beta}]^{T} \} -\\ -% & = & \mathbb{E} \{ [(\mathbf{X}^{T} \mathbf{X})^{-1} \, \mathbf{X}^{T} \mathbf{Y}] \, [(\mathbf{X}^{T} \mathbf{X})^{-1} \, \mathbf{X}^{T} \mathbf{Y}]^{T} \} - \boldsymbol{\beta} \, \boldsymbol{\beta}^{T} -% \\ -% & = & \mathbb{E} \{ (\mathbf{X}^{T} \mathbf{X})^{-1} \, \mathbf{X}^{T} \mathbf{Y} \, \mathbf{Y}^{T} \, \mathbf{X} \, (\mathbf{X}^{T} \mathbf{X})^{-1} \} - \boldsymbol{\beta} \, \boldsymbol{\beta}^{T} -% \\ -& = & (\mathbf{X}^{T} \mathbf{X})^{-1} \, \mathbf{X}^{T} \, \mathbb{E} \{ \mathbf{Y} \, \mathbf{Y}^{T} \} \, \mathbf{X} \, (\mathbf{X}^{T} \mathbf{X})^{-1} - \boldsymbol{\beta} \, \boldsymbol{\beta}^{T} -\\ -& = & (\mathbf{X}^{T} \mathbf{X})^{-1} \, \mathbf{X}^{T} \, \{ \mathbf{X} \, \boldsymbol{\beta} \, \boldsymbol{\beta}^{T} \, \mathbf{X}^{T} + \sigma^2 \} \, \mathbf{X} \, (\mathbf{X}^{T} \mathbf{X})^{-1} - \boldsymbol{\beta} \, \boldsymbol{\beta}^{T} -% \\ -% & = & (\mathbf{X}^T \mathbf{X})^{-1} \, \mathbf{X}^T \, \mathbf{X} \, \boldsymbol{\beta} \, \boldsymbol{\beta}^T \, \mathbf{X}^T \, \mathbf{X} \, (\mathbf{X}^T % \mathbf{X})^{-1} -% \\ -% & & + \, \, \sigma^2 \, (\mathbf{X}^T \mathbf{X})^{-1} \, \mathbf{X}^T \, \mathbf{X} \, (\mathbf{X}^T \mathbf{X})^{-1} - \boldsymbol{\beta} \boldsymbol{\beta}^T -\\ -& = & \boldsymbol{\beta} \, \boldsymbol{\beta}^{T} + \sigma^2 \, (\mathbf{X}^{T} \mathbf{X})^{-1} - \boldsymbol{\beta} \, \boldsymbol{\beta}^{T} -\, \, \, = \, \, \, \sigma^2 \, (\mathbf{X}^{T} \mathbf{X})^{-1}, -\end{eqnarray*} -$$ - -where we have used that $\mathbb{E} (\mathbf{Y} \mathbf{Y}^{T}) = -\mathbf{X} \, \boldsymbol{\beta} \, \boldsymbol{\beta}^{T} \, \mathbf{X}^{T} + -\sigma^2 \, \mathbf{I}_{nn}$. From $\mbox{Var}(\boldsymbol{\beta}) = \sigma^2 -\, (\mathbf{X}^{T} \mathbf{X})^{-1}$, one obtains an estimate of the -variance of the estimate of the $j$-th regression coefficient: -$\boldsymbol{\sigma}^2 (\boldsymbol{\beta}_j ) = \boldsymbol{\sigma}^2 [(\mathbf{X}^{T} \mathbf{X})^{-1}]_{jj} $. This may be used to -construct a confidence interval for the estimates. - - -In a similar way, we can obtain analytical expressions for say the -expectation values of the parameters $\boldsymbol{\beta}$ and their variance -when we employ Ridge regression, allowing us again to define a confidence interval. - -It is rather straightforward to show that - -$$ -\mathbb{E} \big[ \boldsymbol{\beta}^{\mathrm{Ridge}} \big]=(\mathbf{X}^{T} \mathbf{X} + \lambda \mathbf{I}_{pp})^{-1} (\mathbf{X}^{\top} \mathbf{X})\boldsymbol{\beta}^{\mathrm{OLS}}. -$$ - -We see clearly that -$\mathbb{E} \big[ \boldsymbol{\beta}^{\mathrm{Ridge}} \big] \not= \boldsymbol{\beta}^{\mathrm{OLS}}$ for any $\lambda > 0$. We say then that the ridge estimator is biased. - -We can also compute the variance as - -$$ -\mbox{Var}[\boldsymbol{\beta}^{\mathrm{Ridge}}]=\sigma^2[ \mathbf{X}^{T} \mathbf{X} + \lambda \mathbf{I} ]^{-1} \mathbf{X}^{T} \mathbf{X} \{ [ \mathbf{X}^{\top} \mathbf{X} + \lambda \mathbf{I} ]^{-1}\}^{T}, -$$ - -and it is easy to see that if the parameter $\lambda$ goes to infinity then the variance of Ridge parameters $\boldsymbol{\beta}$ goes to zero. - -With this, we can compute the difference - -$$ -\mbox{Var}[\boldsymbol{\beta}^{\mathrm{OLS}}]-\mbox{Var}(\boldsymbol{\beta}^{\mathrm{Ridge}})=\sigma^2 [ \mathbf{X}^{T} \mathbf{X} + \lambda \mathbf{I} ]^{-1}[ 2\lambda\mathbf{I} + \lambda^2 (\mathbf{X}^{T} \mathbf{X})^{-1} ] \{ [ \mathbf{X}^{T} \mathbf{X} + \lambda \mathbf{I} ]^{-1}\}^{T}. -$$ - -The difference is non-negative definite since each component of the -matrix product is non-negative definite. -This means the variance we obtain with the standard OLS will always for $\lambda > 0$ be larger than the variance of $\boldsymbol{\beta}$ obtained with the Ridge estimator. This has interesting consequences when we discuss the so-called bias-variance trade-off below. - - - -## Deriving OLS from a probability distribution - -Our basic assumption when we derived the OLS equations was to assume -that our output is determined by a given continuous function -$f(\boldsymbol{x})$ and a random noise $\boldsymbol{\epsilon}$ given by the normal -distribution with zero mean value and an undetermined variance -$\sigma^2$. - -We found above that the outputs $\boldsymbol{y}$ have a mean value given by -$\boldsymbol{X}\hat{\boldsymbol{\beta}}$ and variance $\sigma^2$. Since the entries to -the design matrix are not stochastic variables, we can assume that the -probability distribution of our targets is also a normal distribution -but now with mean value $\boldsymbol{X}\hat{\boldsymbol{\beta}}$. This means that a -single output $y_i$ is given by the Gaussian distribution - -$$ -y_i\sim \mathcal{N}(\boldsymbol{X}_{i,*}\boldsymbol{\beta}, \sigma^2)=\frac{1}{\sqrt{2\pi\sigma^2}}\exp{\left[-\frac{(y_i-\boldsymbol{X}_{i,*}\boldsymbol{\beta})^2}{2\sigma^2}\right]}. -$$ - -We assume now that the various $y_i$ values are stochastically distributed according to the above Gaussian distribution. -We define this distribution as - -$$ -p(y_i, \boldsymbol{X}\vert\boldsymbol{\beta})=\frac{1}{\sqrt{2\pi\sigma^2}}\exp{\left[-\frac{(y_i-\boldsymbol{X}_{i,*}\boldsymbol{\beta})^2}{2\sigma^2}\right]}, -$$ - -which reads as finding the likelihood of an event $y_i$ with the input variables $\boldsymbol{X}$ given the parameters (to be determined) $\boldsymbol{\beta}$. - -Since these events are assumed to be independent and identicall distributed we can build the probability distribution function (PDF) for all possible event $\boldsymbol{y}$ as the product of the single events, that is we have - -$$ -p(\boldsymbol{y},\boldsymbol{X}\vert\boldsymbol{\beta})=\prod_{i=0}^{n-1}\frac{1}{\sqrt{2\pi\sigma^2}}\exp{\left[-\frac{(y_i-\boldsymbol{X}_{i,*}\boldsymbol{\beta})^2}{2\sigma^2}\right]}=\prod_{i=0}^{n-1}p(y_i,\boldsymbol{X}\vert\boldsymbol{\beta}). -$$ - -We will write this in a more compact form reserving $\boldsymbol{D}$ for the domain of events, including the ouputs (targets) and the inputs. That is -in case we have a simple one-dimensional input and output case - -$$ -\boldsymbol{D}=[(x_0,y_0), (x_1,y_1),\dots, (x_{n-1},y_{n-1})]. -$$ - -In the more general case the various inputs should be replaced by the possible features represented by the input data set $\boldsymbol{X}$. -We can now rewrite the above probability as - -$$ -p(\boldsymbol{D}\vert\boldsymbol{\beta})=\prod_{i=0}^{n-1}\frac{1}{\sqrt{2\pi\sigma^2}}\exp{\left[-\frac{(y_i-\boldsymbol{X}_{i,*}\boldsymbol{\beta})^2}{2\sigma^2}\right]}. -$$ - -It is a conditional probability (see below) and reads as the -likelihood of a domain of events $\boldsymbol{D}$ given a set of parameters -$\boldsymbol{\beta}$. - - -In statistics, maximum likelihood estimation (MLE) is a method of -estimating the parameters of an assumed probability distribution, -given some observed data. This is achieved by maximizing a likelihood -function so that, under the assumed statistical model, the observed -data is the most probable. - - -We will assume here that our events are given by the above Gaussian -distribution and we will determine the optimal parameters $\beta$ by -maximizing the above PDF. However, computing the derivatives of a -product function is cumbersome and can easily lead to overflow and/or -underflowproblems, with potentials for loss of numerical precision. - - -In practice, it is more convenient to maximize the logarithm of the -PDF because it is a monotonically increasing function of the argument. -Alternatively, and this will be our option, we will minimize the -negative of the logarithm since this is a monotonically decreasing -function. - -Note also that maximization/minimization of the logarithm of the PDF -is equivalent to the maximization/minimization of the function itself. - - - - -We could now define a new cost function to minimize, namely the negative logarithm of the above PDF - -$$ -C(\boldsymbol{\beta}=-\log{\prod_{i=0}^{n-1}p(y_i,\boldsymbol{X}\vert\boldsymbol{\beta})}=-\sum_{i=0}^{n-1}\log{p(y_i,\boldsymbol{X}\vert\boldsymbol{\beta})}, -$$ - -which becomes - -$$ -C(\boldsymbol{\beta}=\frac{n}{2}\log{2\pi\sigma^2}+\frac{\vert\vert (\boldsymbol{y}-\boldsymbol{X}\boldsymbol{\beta})\vert\vert_2^2}{2\sigma^2}. -$$ - -Taking the derivative of the *new* cost function with respect to the parameters $\beta$ we recognize our familiar OLS equation, namely - -$$ -\boldsymbol{X}^T\left(\boldsymbol{y}-\boldsymbol{X}\boldsymbol{\beta}\right) =0, -$$ - -which leads to the well-known OLS equation for the optimal paramters $\beta$ - -$$ -\hat{\boldsymbol{\beta}}^{\mathrm{OLS}}=\left(\boldsymbol{X}^T\boldsymbol{X}\right)^{-1}\boldsymbol{X}^T\boldsymbol{y}! -$$ - -Before we make a similar analysis for Ridge and Lasso regression, we need a short reminder on statistics. - - -A central theorem in statistics is Bayes' theorem. This theorem plays a similar role as the good old Pythagoras' theorem in geometry. -Bayes' theorem is extremely simple to derive. But to do so we need some basic axioms from statistics. - -Assume we have two domains of events $X=[x_0,x_1,\dots,x_{n-1}]$ and $Y=[y_0,y_1,\dots,y_{n-1}]$. - -We define also the likelihood for $X$ and $Y$ as $p(X)$ and $p(Y)$ respectively. -The likelihood of a specific event $x_i$ (or $y_i$) is then written as $p(X=x_i)$ or just $p(x_i)=p_i$. - -The union of events is given by - -$$ -p(X \cup Y)= p(X)+p(Y)-p(X \cap Y). -$$ - -The product rule (aka joint probability) is given by - -$$ -p(X \cup Y)= p(X,Y)= p(X\vert Y)p(Y)=p(Y\vert X)p(X), -$$ - -where we read $p(X\vert Y)$ as the likelihood of obtaining $X$ given $Y$. - -If we have independent events then $p(X,Y)=p(X)p(Y)$. - - - -The marginal probability is defined in terms of only one of the set of variables $X,Y$. For a discrete probability we have - -$$ -p(X)=\sum_{i=0}^{n-1}p(X,Y=y_i)=\sum_{i=0}^{n-1}p(X\vert Y=y_i)p(Y=y_i)=\sum_{i=0}^{n-1}p(X\vert y_i)p(y_i). -$$ - -The conditional probability, if $p(Y) > 0$, is - -$$ -p(X\vert Y)= \frac{p(X,Y)}{p(Y)}=\frac{p(X,Y)}{\sum_{i=0}^{n-1}p(Y\vert X=x_i)p(x_i)}. -$$ - -If we combine the conditional probability with the marginal probability and the standard product rule, we have - -$$ -p(X\vert Y)= \frac{p(X,Y)}{p(Y)}, -$$ - -which we can rewrite as - -$$ -p(X\vert Y)= \frac{p(X,Y)}{\sum_{i=0}^{n-1}p(Y\vert X=x_i)p(x_i)}=\frac{p(Y\vert X)p(X)}{\sum_{i=0}^{n-1}p(Y\vert X=x_i)p(x_i)}, -$$ - -which is Bayes' theorem. It allows us to evaluate the uncertainty in in $X$ after we have observed $Y$. We can easily interchange $X$ with $Y$. - - -The quantity $p(Y\vert X)$ on the right-hand side of the theorem is -evaluated for the observed data $Y$ and can be viewed as a function of -the parameter space represented by $X$. This function is not -necesseraly normalized and is normally called the likelihood function. - -The function $p(X)$ on the right hand side is called the prior while -the function on the left hand side is the called the posterior -probability. The denominator on the right hand side serves as a -normalization factor for the posterior distribution. - -Let us try to illustrate Bayes' theorem through an example. - - -Let us suppose that you are undergoing a series of mammography scans -in order to rule out possible breast cancer cases. We define the -sensitivity for a positive event by the variable $X$. It takes binary -values with $X=1$ representing a positive event and $X=0$ being a -negative event. We reserve $Y$ as a classification parameter for -either a negative or a positive breast cancer confirmation. (Short -note on wordings: positive here means having breast cancer, although -none of us would consider this being a positive thing). - -We let $Y=1$ represent the the case of having breast cancer and $Y=0$ as not. - -Let us assume that if you have breast cancer, the test will be positive with a probability of $0.8$ (the numbers here are all made up), -that is we have - -$$ -p(X=1\vert Y=1) =0.8. -$$ - -This obviously sounds scary since many would conclude that if the test -is positive, there is a likelihood of $80\%$ for having cancer. It is -however not correct, as the following Bayesian analysis shows. The correct question to pose is *what is the probability of having breast cancer in case of a positive test?* -We are thus interested in - -$$ -p(Y=1\vert X=1), -$$ - -instead of $p(X=1\vert Y=1)$. - - - -If we look at various national surveys on breast cancer, the general -likelihood of developing breast cancer is a very small number. Let us -assume that the prior probability in the population as a whole is - -$$ -p(Y=1) =0.004. -$$ - -We need also to account for the fact that the test may produce a false -positive result (false alarm). Let us here assume that we have - -$$ -p(X=1\vert Y=0) =0.1. -$$ - -Using Bayes' theorem we can then find the posterior probability that -the person has breast cancer in case of a positive test, that is we -can compute - - -
- -$$ -\begin{equation} -p(Y=1\vert X=1)=\frac{p(X=1\vert Y=1)p(Y=1)}{p(X=1\vert Y=1)p(Y=1)+p(X=1\vert Y=0)p(Y=0)}= -\label{_auto2} \tag{2} -\end{equation} -$$ - - -
- -$$ -\begin{equation} - \frac{0.8\times 0.004}{0.8\times 0.004+0.1\times 0.996}=0.031. -\label{_auto3} \tag{3} -\end{equation} -$$ - -That is, in case of a positive test, there is only a $3\%$ chance of having breast cancer! - - - -## Bayes' Theorem and Ridge and Lasso Regression - -Hitherto we have discussed Ridge and Lasso regression in terms of a -linear analysis. This may to many of you feel rather technical and -perhaps not that intuitive. The question is whether we can develop a -more intuitive way of understanding what Ridge and Lasso express. - -Before we proceed let us perform a Ridge, Lasso and OLS analysis of a polynomial fit. - - -We will play around with a study of the values for the optimal -parameters $\boldsymbol{\beta}$ using OLS, Ridge and Lasso regression. For -OLS, you will notice as function of the noise and polynomial degree, -that the parameters $\beta$ will fluctuate from order to order in the -polynomial fit and that for larger and larger polynomial degrees of -freedom, the parameters will tend to increase in value for OLS. - -For Ridge and Lasso regression, the higher order parameters will -typically be reduced, providing thereby less fluctuations from one -order to another one. - -import numpy as np -import matplotlib.pyplot as plt -from sklearn.model_selection import train_test_split -from sklearn import linear_model - -def R2(y_data, y_model): - return 1 - np.sum((y_data - y_model) ** 2) / np.sum((y_data - np.mean(y_data)) ** 2) -def MSE(y_data,y_model): - n = np.size(y_model) - return np.sum((y_data-y_model)**2)/n - -# Make data set. -n = 10000 -x = np.random.rand(n) -y = np.exp(-x**2) + 1.5 * np.exp(-(x-2)**2)+ np.random.randn(n) - -Maxpolydegree = 5 -X = np.zeros((len(x),Maxpolydegree)) -X[:,0] = 1.0 - -for polydegree in range(1, Maxpolydegree): - for degree in range(polydegree): - X[:,degree] = x**(degree) - - -# We split the data in test and training data -X_train, X_test, y_train, y_test = train_test_split(X, y, test_size=0.2) - -# matrix inversion to find beta -OLSbeta = np.linalg.pinv(X_train.T @ X_train) @ X_train.T @ y_train -print(OLSbeta) -ypredictOLS = X_test @ OLSbeta -print("Test MSE OLS") -print(MSE(y_test,ypredictOLS)) -# Repeat now for Lasso and Ridge regression and various values of the regularization parameter using Scikit-Learn -# Decide which values of lambda to use -nlambdas = 4 -MSERidgePredict = np.zeros(nlambdas) -MSELassoPredict = np.zeros(nlambdas) -lambdas = np.logspace(-3, 1, nlambdas) -for i in range(nlambdas): - lmb = lambdas[i] - # Make the fit using Ridge and Lasso - RegRidge = linear_model.Ridge(lmb,fit_intercept=False) - RegRidge.fit(X_train,y_train) - RegLasso = linear_model.Lasso(lmb,fit_intercept=False) - RegLasso.fit(X_train,y_train) - # and then make the prediction - ypredictRidge = RegRidge.predict(X_test) - ypredictLasso = RegLasso.predict(X_test) - # Compute the MSE and print it - MSERidgePredict[i] = MSE(y_test,ypredictRidge) - MSELassoPredict[i] = MSE(y_test,ypredictLasso) -# print(lmb,RegRidge.coef_) -# print(lmb,RegLasso.coef_) -# Now plot the results -plt.figure() -plt.plot(np.log10(lambdas), MSERidgePredict, 'b', label = 'MSE Ridge Test') -plt.plot(np.log10(lambdas), MSELassoPredict, 'r', label = 'MSE Lasso Test') -plt.xlabel('log10(lambda)') -plt.ylabel('MSE') -plt.legend() -plt.show() - -How can we understand this? - -Let us write out the values of the coefficients $\beta_i$ as functions -of the polynomial degree and noise. We will focus only on the Ridge -results and some few selected values of the hyperparameter $\lambda$. - -If we don't include any noise and run this code for different values -of the polynomial degree, we notice that the results for $\beta_i$ do -not show great changes from one order to the next. This is an -indication that for higher polynomial orders, our parameters become -less important. - -If we however add noise, what happens is that the polynomial fit is -trying to adjust the fit to traverse in the best possible way all data -points. This can lead to large fluctuations in the parameters -$\beta_i$ as functions of polynomial order. It will also be reflected -in a larger value of the variance of each parameter $\beta_i$. What -Ridge regression (and Lasso as well) are doing then is to try to -quench the fluctuations in the parameters of $\beta_i$ which have a -large variance (normally for higher orders in the polynomial). - -import numpy as np -import pandas as pd -from IPython.display import display -import matplotlib.pyplot as plt -from sklearn.model_selection import train_test_split -from sklearn import linear_model - -# Make data set. -n = 1000 -x = np.random.rand(n) -y = np.exp(-x**2) + 1.5 * np.exp(-(x-2)**2)+ np.random.randn(n) - -Maxpolydegree = 5 -X = np.zeros((len(x),Maxpolydegree)) -X[:,0] = 1.0 - -for polydegree in range(1, Maxpolydegree): - for degree in range(polydegree): - X[:,degree] = x**(degree) - - -# We split the data in test and training data -X_train, X_test, y_train, y_test = train_test_split(X, y, test_size=0.2) - -# Decide which values of lambda to use -nlambdas = 5 -lambdas = np.logspace(-3, 2, nlambdas) -for i in range(nlambdas): - lmb = lambdas[i] - # Make the fit using Ridge only - RegRidge = linear_model.Ridge(lmb,fit_intercept=False) - RegRidge.fit(X_train,y_train) - # and then make the prediction - ypredictRidge = RegRidge.predict(X_test) - Coeffs = np.array(RegRidge.coef_) - BetaValues = pd.DataFrame(Coeffs) - BetaValues.columns = ['beta'] - display(BetaValues) - -As an exercise, repeat these calculations with ordinary least squares -only with and without noise. Calculate thereafter the variance of the -parameters $\beta_j$ as function of polynomial order and of the added -noise. Here we recommend to use $\sigma^2=1$ as variance for the -added noise (which follows a normal distribution with mean value zero). -Comment your results. If you have a large noise term, do the parameters $\beta_j$ vary more as function -model complexity? And what about their variance? - - - - -## Linking Bayes' Theorem with Ridge and Lasso Regression - -We have seen that Ridge regression suppresses those features which -have a small singular value. This corresponds to a feature which exhibits -a large variance in the parameters $\beta_j$. -Our analysis hitherto has been based on linear algebra. To add to our intuition, we will use -Bayes' theorem in order to deepen our understanding of Ridge and Lasso regression. - -For ordinary least squares we postulated that the maximum likelihood for the domain of events $\boldsymbol{D}$ (one-dimensional case) - -$$ -\boldsymbol{D}=[(x_0,y_0), (x_1,y_1),\dots, (x_{n-1},y_{n-1})], -$$ - -is given by - -$$ -p(\boldsymbol{D}\vert\boldsymbol{\beta})=\prod_{i=0}^{n-1}\frac{1}{\sqrt{2\pi\sigma^2}}\exp{\left[-\frac{(y_i-\boldsymbol{X}_{i,*}\boldsymbol{\beta})^2}{2\sigma^2}\right]}. -$$ - -In Bayes' theorem this function plays the role of the so-called likelihood. We could now ask the question what is the posterior probability of a parameter set $\boldsymbol{\beta}$ given a domain of events $\boldsymbol{D}$? That is, how can we define the posterior probability - -$$ -p(\boldsymbol{\beta}\vert\boldsymbol{D}). -$$ - -Bayes' theorem comes to our rescue here since (omitting the normalization constant) - -$$ -p(\boldsymbol{\beta}\vert\boldsymbol{D})\propto p(\boldsymbol{D}\vert\boldsymbol{\beta})p(\boldsymbol{\beta}). -$$ - -We have a model for $p(\boldsymbol{D}\vert\boldsymbol{\beta})$ but need one for the **prior** $p(\boldsymbol{\beta}$! - - - -With the posterior probability defined by a likelihood which we have -already modeled and an unknown prior, we are now ready to make -additional models for the prior. - -We can, based on our discussions of the variance of $\boldsymbol{\beta}$ and -the mean value, assume that the prior for the values $\boldsymbol{\beta}$ is -given by a Gaussian with mean value zero and variance $\tau^2$, that -is - -$$ -p(\boldsymbol{\beta})=\prod_{j=0}^{p-1}\exp{\left(-\frac{\beta_j^2}{2\tau^2}\right)}. -$$ - -Our posterior probability becomes then (omitting the normalization factor which is just a constant) - -$$ -p(\boldsymbol{\beta\vert\boldsymbol{D})}=\prod_{i=0}^{n-1}\frac{1}{\sqrt{2\pi\sigma^2}}\exp{\left[-\frac{(y_i-\boldsymbol{X}_{i,*}\boldsymbol{\beta})^2}{2\sigma^2}\right]}\prod_{j=0}^{p-1}\exp{\left(-\frac{\beta_j^2}{2\tau^2}\right)}. -$$ - -We can now optimize this quantity with respect to $\boldsymbol{\beta}$. As we -did for OLS, this is most conveniently done by taking the negative -logarithm of the posterior probability. Doing so and leaving out the -terms that do not depend on $\beta$, we have - -$$ -C(\boldsymbol{\beta})=\frac{\vert\vert (\boldsymbol{y}-\boldsymbol{X}\boldsymbol{\beta})\vert\vert_2^2}{2\sigma^2}+\frac{1}{2\tau^2}\vert\vert\boldsymbol{\beta}\vert\vert_2^2, -$$ - -and replacing $1/2\tau^2$ with $\lambda$ we have - -$$ -C(\boldsymbol{\beta})=\frac{\vert\vert (\boldsymbol{y}-\boldsymbol{X}\boldsymbol{\beta})\vert\vert_2^2}{2\sigma^2}+\lambda\vert\vert\boldsymbol{\beta}\vert\vert_2^2, -$$ - -which is our Ridge cost function! Nice, isn't it? - - -To derive the Lasso cost function, we simply replace the Gaussian prior with an exponential distribution ([Laplace in this case](https://en.wikipedia.org/wiki/Laplace_distribution)) with zero mean value, that is - -$$ -p(\boldsymbol{\beta})=\prod_{j=0}^{p-1}\exp{\left(-\frac{\vert\beta_j\vert}{\tau}\right)}. -$$ - -Our posterior probability becomes then (omitting the normalization factor which is just a constant) - -$$ -p(\boldsymbol{\beta}\vert\boldsymbol{D})=\prod_{i=0}^{n-1}\frac{1}{\sqrt{2\pi\sigma^2}}\exp{\left[-\frac{(y_i-\boldsymbol{X}_{i,*}\boldsymbol{\beta})^2}{2\sigma^2}\right]}\prod_{j=0}^{p-1}\exp{\left(-\frac{\vert\beta_j\vert}{\tau}\right)}. -$$ - -Taking the negative -logarithm of the posterior probability and leaving out the -constants terms that do not depend on $\beta$, we have - -$$ -C(\boldsymbol{\beta}=\frac{\vert\vert (\boldsymbol{y}-\boldsymbol{X}\boldsymbol{\beta})\vert\vert_2^2}{2\sigma^2}+\frac{1}{\tau}\vert\vert\boldsymbol{\beta}\vert\vert_1, -$$ - -and replacing $1/\tau$ with $\lambda$ we have - -$$ -C(\boldsymbol{\beta}=\frac{\vert\vert (\boldsymbol{y}-\boldsymbol{X}\boldsymbol{\beta})\vert\vert_2^2}{2\sigma^2}+\lambda\vert\vert\boldsymbol{\beta}\vert\vert_1, -$$ - -which is our Lasso cost function! - - -Plotting these prior functions shows us that we can use the parameter -$\lambda$ to shrink or increase the role of a given parameter -$\beta_j$. The variance for the Laplace distribution is -$2\tau^2=1/\lambda$ while for the Gaussian distribution it is -$\sigma^2=1/(2\lambda)$. Thus, increasing the variance means -decreasing $\lambda$ and shrinking the variance means increasing -$\lamdbda$. When we increase $\lambda$, this corresponds to shrinking the role of less important features (small singular values). \ No newline at end of file diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter2_245_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter2_245_1.png deleted file mode 100644 index dc3a3ce3e..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter2_245_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter2_245_2.png b/doc/LectureNotes/_build/jupyter_execute/chapter2_245_2.png deleted file mode 100644 index dc3a3ce3e..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter2_245_2.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter2_247_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter2_247_1.png deleted file mode 100644 index ac2df9e69..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter2_247_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter2_249_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter2_249_1.png deleted file mode 100644 index 9666ad291..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter2_249_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter2_249_2.png b/doc/LectureNotes/_build/jupyter_execute/chapter2_249_2.png deleted file mode 100644 index 9666ad291..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter2_249_2.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter2_25_2.png b/doc/LectureNotes/_build/jupyter_execute/chapter2_25_2.png deleted file mode 100644 index 3c8dab8ed..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter2_25_2.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter2_287_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter2_287_1.png deleted file mode 100644 index dc3a3ce3e..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter2_287_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter2_289_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter2_289_1.png deleted file mode 100644 index ac2df9e69..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter2_289_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter2_291_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter2_291_1.png deleted file mode 100644 index 9666ad291..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter2_291_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter2_313_2.png b/doc/LectureNotes/_build/jupyter_execute/chapter2_313_2.png deleted file mode 100644 index 07584f6bb..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter2_313_2.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter2_316_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter2_316_1.png deleted file mode 100644 index 07584f6bb..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter2_316_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter2_351_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter2_351_1.png deleted file mode 100644 index 07584f6bb..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter2_351_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3.ipynb b/doc/LectureNotes/_build/jupyter_execute/chapter3.ipynb deleted file mode 100644 index 6788e5d1e..000000000 --- a/doc/LectureNotes/_build/jupyter_execute/chapter3.ipynb +++ /dev/null @@ -1,4546 +0,0 @@ -{ - "cells": [ - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "# Resampling Methods\n", - "\n", - "## Introduction\n", - "\n", - "Resampling methods are an indispensable tool in modern\n", - "statistics. They involve repeatedly drawing samples from a training\n", - "set and refitting a model of interest on each sample in order to\n", - "obtain additional information about the fitted model. For example, in\n", - "order to estimate the variability of a linear regression fit, we can\n", - "repeatedly draw different samples from the training data, fit a linear\n", - "regression to each new sample, and then examine the extent to which\n", - "the resulting fits differ. Such an approach may allow us to obtain\n", - "information that would not be available from fitting the model only\n", - "once using the original training sample.\n", - "\n", - "Two resampling methods are often used in Machine Learning analyses,\n", - "1. The **bootstrap method**\n", - "\n", - "2. and **Cross-Validation**\n", - "\n", - "In addition there are several other methods such as the Jackknife and the Blocking methods. We will discuss in particular\n", - "cross-validation and the bootstrap method. \n", - "\n", - "\n", - "Resampling approaches can be computationally expensive, because they\n", - "involve fitting the same statistical method multiple times using\n", - "different subsets of the training data. However, due to recent\n", - "advances in computing power, the computational requirements of\n", - "resampling methods generally are not prohibitive. In this chapter, we\n", - "discuss two of the most commonly used resampling methods,\n", - "cross-validation and the bootstrap. Both methods are important tools\n", - "in the practical application of many statistical learning\n", - "procedures. For example, cross-validation can be used to estimate the\n", - "test error associated with a given statistical learning method in\n", - "order to evaluate its performance, or to select the appropriate level\n", - "of flexibility. The process of evaluating a model’s performance is\n", - "known as model assessment, whereas the process of selecting the proper\n", - "level of flexibility for a model is known as model selection. The\n", - "bootstrap is widely used.\n", - "\n", - "\n", - "* Our simulations can be treated as *computer experiments*. This is particularly the case for Monte Carlo methods\n", - "\n", - "* The results can be analysed with the same statistical tools as we would use analysing experimental data.\n", - "\n", - "* As in all experiments, we are looking for expectation values and an estimate of how accurate they are, i.e., possible sources for errors.\n", - "\n", - "## Reminder on Statistics\n", - "\n", - "\n", - "* As in other experiments, many numerical experiments have two classes of errors:\n", - "\n", - " * Statistical errors\n", - "\n", - " * Systematical errors\n", - "\n", - "\n", - "* Statistical errors can be estimated using standard tools from statistics\n", - "\n", - "* Systematical errors are method specific and must be treated differently from case to case. \n", - "\n", - "The\n", - "advantage of doing linear regression is that we actually end up with\n", - "analytical expressions for several statistical quantities. \n", - "Standard least squares and Ridge regression allow us to\n", - "derive quantities like the variance and other expectation values in a\n", - "rather straightforward way.\n", - "\n", - "\n", - "It is assumed that $\\varepsilon_i\n", - "\\sim \\mathcal{N}(0, \\sigma^2)$ and the $\\varepsilon_{i}$ are\n", - "independent, i.e.:" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{align*} \n", - "\\mbox{Cov}(\\varepsilon_{i_1},\n", - "\\varepsilon_{i_2}) & = \\left\\{ \\begin{array}{lcc} \\sigma^2 & \\mbox{if}\n", - "& i_1 = i_2, \\\\ 0 & \\mbox{if} & i_1 \\not= i_2. \\end{array} \\right.\n", - "\\end{align*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The randomness of $\\varepsilon_i$ implies that\n", - "$\\mathbf{y}_i$ is also a random variable. In particular,\n", - "$\\mathbf{y}_i$ is normally distributed, because $\\varepsilon_i \\sim\n", - "\\mathcal{N}(0, \\sigma^2)$ and $\\mathbf{X}_{i,\\ast} \\, \\boldsymbol{\\beta}$ is a\n", - "non-random scalar. To specify the parameters of the distribution of\n", - "$\\mathbf{y}_i$ we need to calculate its first two moments. \n", - "\n", - "Recall that $\\boldsymbol{X}$ is a matrix of dimensionality $n\\times p$. The\n", - "notation above $\\mathbf{X}_{i,\\ast}$ means that we are looking at the\n", - "row number $i$ and perform a sum over all values $p$.\n", - "\n", - "\n", - "The assumption we have made here can be summarized as (and this is going to be useful when we discuss the bias-variance trade off)\n", - "that there exists a function $f(\\boldsymbol{x})$ and a normal distributed error $\\boldsymbol{\\varepsilon}\\sim \\mathcal{N}(0, \\sigma^2)$\n", - "which describe our data" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{y} = f(\\boldsymbol{x})+\\boldsymbol{\\varepsilon}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We approximate this function with our model from the solution of the linear regression equations, that is our\n", - "function $f$ is approximated by $\\boldsymbol{\\tilde{y}}$ where we want to minimize $(\\boldsymbol{y}-\\boldsymbol{\\tilde{y}})^2$, our MSE, with" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{\\tilde{y}} = \\boldsymbol{X}\\boldsymbol{\\beta}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We can calculate the expectation value of $\\boldsymbol{y}$ for a given element $i$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{align*} \n", - "\\mathbb{E}(y_i) & =\n", - "\\mathbb{E}(\\mathbf{X}_{i, \\ast} \\, \\boldsymbol{\\beta}) + \\mathbb{E}(\\varepsilon_i)\n", - "\\, \\, \\, = \\, \\, \\, \\mathbf{X}_{i, \\ast} \\, \\beta, \n", - "\\end{align*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "while\n", - "its variance is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{align*} \\mbox{Var}(y_i) & = \\mathbb{E} \\{ [y_i\n", - "- \\mathbb{E}(y_i)]^2 \\} \\, \\, \\, = \\, \\, \\, \\mathbb{E} ( y_i^2 ) -\n", - "[\\mathbb{E}(y_i)]^2 \\\\ & = \\mathbb{E} [ ( \\mathbf{X}_{i, \\ast} \\,\n", - "\\beta + \\varepsilon_i )^2] - ( \\mathbf{X}_{i, \\ast} \\, \\boldsymbol{\\beta})^2 \\\\ &\n", - "= \\mathbb{E} [ ( \\mathbf{X}_{i, \\ast} \\, \\boldsymbol{\\beta})^2 + 2 \\varepsilon_i\n", - "\\mathbf{X}_{i, \\ast} \\, \\boldsymbol{\\beta} + \\varepsilon_i^2 ] - ( \\mathbf{X}_{i,\n", - "\\ast} \\, \\beta)^2 \\\\ & = ( \\mathbf{X}_{i, \\ast} \\, \\boldsymbol{\\beta})^2 + 2\n", - "\\mathbb{E}(\\varepsilon_i) \\mathbf{X}_{i, \\ast} \\, \\boldsymbol{\\beta} +\n", - "\\mathbb{E}(\\varepsilon_i^2 ) - ( \\mathbf{X}_{i, \\ast} \\, \\boldsymbol{\\beta})^2 \n", - "\\\\ & = \\mathbb{E}(\\varepsilon_i^2 ) \\, \\, \\, = \\, \\, \\,\n", - "\\mbox{Var}(\\varepsilon_i) \\, \\, \\, = \\, \\, \\, \\sigma^2. \n", - "\\end{align*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Hence, $y_i \\sim \\mathcal{N}( \\mathbf{X}_{i, \\ast} \\, \\boldsymbol{\\beta}, \\sigma^2)$, that is $\\boldsymbol{y}$ follows a normal distribution with \n", - "mean value $\\boldsymbol{X}\\boldsymbol{\\beta}$ and variance $\\sigma^2$ (not be confused with the singular values of the SVD). \n", - "\n", - "\n", - "With the OLS expressions for the parameters $\\boldsymbol{\\beta}$ we can evaluate the expectation value" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbb{E}(\\boldsymbol{\\beta}) = \\mathbb{E}[ (\\mathbf{X}^{\\top} \\mathbf{X})^{-1}\\mathbf{X}^{T} \\mathbf{Y}]=(\\mathbf{X}^{T} \\mathbf{X})^{-1}\\mathbf{X}^{T} \\mathbb{E}[ \\mathbf{Y}]=(\\mathbf{X}^{T} \\mathbf{X})^{-1} \\mathbf{X}^{T}\\mathbf{X}\\boldsymbol{\\beta}=\\boldsymbol{\\beta}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "This means that the estimator of the regression parameters is unbiased.\n", - "v\n", - "We can also calculate the variance\n", - "\n", - "The variance of $\\boldsymbol{\\beta}$ is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{eqnarray*}\n", - "\\mbox{Var}(\\boldsymbol{\\beta}) & = & \\mathbb{E} \\{ [\\boldsymbol{\\beta} - \\mathbb{E}(\\boldsymbol{\\beta})] [\\boldsymbol{\\beta} - \\mathbb{E}(\\boldsymbol{\\beta})]^{T} \\}\n", - "\\\\\n", - "& = & \\mathbb{E} \\{ [(\\mathbf{X}^{T} \\mathbf{X})^{-1} \\, \\mathbf{X}^{T} \\mathbf{Y} - \\boldsymbol{\\beta}] \\, [(\\mathbf{X}^{T} \\mathbf{X})^{-1} \\, \\mathbf{X}^{T} \\mathbf{Y} - \\boldsymbol{\\beta}]^{T} \\}\n", - "\\\\\n", - "% & = & \\mathbb{E} \\{ [(\\mathbf{X}^{T} \\mathbf{X})^{-1} \\, \\mathbf{X}^{T} \\mathbf{Y}] \\, [(\\mathbf{X}^{T} \\mathbf{X})^{-1} \\, \\mathbf{X}^{T} \\mathbf{Y}]^{T} \\} - \\boldsymbol{\\beta} \\, \\boldsymbol{\\beta}^{T}\n", - "% \\\\\n", - "% & = & \\mathbb{E} \\{ (\\mathbf{X}^{T} \\mathbf{X})^{-1} \\, \\mathbf{X}^{T} \\mathbf{Y} \\, \\mathbf{Y}^{T} \\, \\mathbf{X} \\, (\\mathbf{X}^{T} \\mathbf{X})^{-1} \\} - \\boldsymbol{\\beta} \\, \\boldsymbol{\\beta}^{T}\n", - "% \\\\\n", - "& = & (\\mathbf{X}^{T} \\mathbf{X})^{-1} \\, \\mathbf{X}^{T} \\, \\mathbb{E} \\{ \\mathbf{Y} \\, \\mathbf{Y}^{T} \\} \\, \\mathbf{X} \\, (\\mathbf{X}^{T} \\mathbf{X})^{-1} - \\boldsymbol{\\beta} \\, \\boldsymbol{\\beta}^{T}\n", - "\\\\\n", - "& = & (\\mathbf{X}^{T} \\mathbf{X})^{-1} \\, \\mathbf{X}^{T} \\, \\{ \\mathbf{X} \\, \\boldsymbol{\\beta} \\, \\boldsymbol{\\beta}^{T} \\, \\mathbf{X}^{T} + \\sigma^2 \\} \\, \\mathbf{X} \\, (\\mathbf{X}^{T} \\mathbf{X})^{-1} - \\boldsymbol{\\beta} \\, \\boldsymbol{\\beta}^{T}\n", - "% \\\\\n", - "% & = & (\\mathbf{X}^T \\mathbf{X})^{-1} \\, \\mathbf{X}^T \\, \\mathbf{X} \\, \\boldsymbol{\\beta} \\, \\boldsymbol{\\beta}^T \\, \\mathbf{X}^T \\, \\mathbf{X} \\, (\\mathbf{X}^T % \\mathbf{X})^{-1}\n", - "% \\\\\n", - "% & & + \\, \\, \\sigma^2 \\, (\\mathbf{X}^T \\mathbf{X})^{-1} \\, \\mathbf{X}^T \\, \\mathbf{X} \\, (\\mathbf{X}^T \\mathbf{X})^{-1} - \\boldsymbol{\\beta} \\boldsymbol{\\beta}^T\n", - "\\\\\n", - "& = & \\boldsymbol{\\beta} \\, \\boldsymbol{\\beta}^{T} + \\sigma^2 \\, (\\mathbf{X}^{T} \\mathbf{X})^{-1} - \\boldsymbol{\\beta} \\, \\boldsymbol{\\beta}^{T}\n", - "\\, \\, \\, = \\, \\, \\, \\sigma^2 \\, (\\mathbf{X}^{T} \\mathbf{X})^{-1},\n", - "\\end{eqnarray*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where we have used that $\\mathbb{E} (\\mathbf{Y} \\mathbf{Y}^{T}) =\n", - "\\mathbf{X} \\, \\boldsymbol{\\beta} \\, \\boldsymbol{\\beta}^{T} \\, \\mathbf{X}^{T} +\n", - "\\sigma^2 \\, \\mathbf{I}_{nn}$. From $\\mbox{Var}(\\boldsymbol{\\beta}) = \\sigma^2\n", - "\\, (\\mathbf{X}^{T} \\mathbf{X})^{-1}$, one obtains an estimate of the\n", - "variance of the estimate of the $j$-th regression coefficient:\n", - "$\\boldsymbol{\\sigma}^2 (\\boldsymbol{\\beta}_j ) = \\boldsymbol{\\sigma}^2 \\sqrt{\n", - "[(\\mathbf{X}^{T} \\mathbf{X})^{-1}]_{jj} }$. This may be used to\n", - "construct a confidence interval for the estimates.\n", - "\n", - "\n", - "In a similar way, we can obtain analytical expressions for say the\n", - "expectation values of the parameters $\\boldsymbol{\\beta}$ and their variance\n", - "when we employ Ridge regression, allowing us again to define a confidence interval. \n", - "\n", - "It is rather straightforward to show that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbb{E} \\big[ \\boldsymbol{\\beta}^{\\mathrm{Ridge}} \\big]=(\\mathbf{X}^{T} \\mathbf{X} + \\lambda \\mathbf{I}_{pp})^{-1} (\\mathbf{X}^{\\top} \\mathbf{X})\\boldsymbol{\\beta}^{\\mathrm{OLS}}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We see clearly that \n", - "$\\mathbb{E} \\big[ \\boldsymbol{\\beta}^{\\mathrm{Ridge}} \\big] \\not= \\boldsymbol{\\beta}^{\\mathrm{OLS}}$ for any $\\lambda > 0$. We say then that the ridge estimator is biased.\n", - "\n", - "We can also compute the variance as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mbox{Var}[\\boldsymbol{\\beta}^{\\mathrm{Ridge}}]=\\sigma^2[ \\mathbf{X}^{T} \\mathbf{X} + \\lambda \\mathbf{I} ]^{-1} \\mathbf{X}^{T} \\mathbf{X} \\{ [ \\mathbf{X}^{\\top} \\mathbf{X} + \\lambda \\mathbf{I} ]^{-1}\\}^{T},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and it is easy to see that if the parameter $\\lambda$ goes to infinity then the variance of Ridge parameters $\\boldsymbol{\\beta}$ goes to zero. \n", - "\n", - "With this, we can compute the difference" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mbox{Var}[\\boldsymbol{\\beta}^{\\mathrm{OLS}}]-\\mbox{Var}(\\boldsymbol{\\beta}^{\\mathrm{Ridge}})=\\sigma^2 [ \\mathbf{X}^{T} \\mathbf{X} + \\lambda \\mathbf{I} ]^{-1}[ 2\\lambda\\mathbf{I} + \\lambda^2 (\\mathbf{X}^{T} \\mathbf{X})^{-1} ] \\{ [ \\mathbf{X}^{T} \\mathbf{X} + \\lambda \\mathbf{I} ]^{-1}\\}^{T}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The difference is non-negative definite since each component of the\n", - "matrix product is non-negative definite. \n", - "This means the variance we obtain with the standard OLS will always for $\\lambda > 0$ be larger than the variance of $\\boldsymbol{\\beta}$ obtained with the Ridge estimator. This has interesting consequences when we discuss the so-called bias-variance trade-off below. \n", - "\n", - "\n", - "\n", - "## Resampling methods\n", - "\n", - "With all these analytical equations for both the OLS and Ridge\n", - "regression, we will now outline how to assess a given model. This will\n", - "lead us to a discussion of the so-called bias-variance tradeoff (see\n", - "below) and so-called resampling methods.\n", - "\n", - "One of the quantities we have discussed as a way to measure errors is\n", - "the mean-squared error (MSE), mainly used for fitting of continuous\n", - "functions. Another choice is the absolute error.\n", - "\n", - "In the discussions below we will focus on the MSE and in particular since we will split the data into test and training data,\n", - "we discuss the\n", - "1. prediction error or simply the **test error** $\\mathrm{Err_{Test}}$, where we have a fixed training set and the test error is the MSE arising from the data reserved for testing. We discuss also the \n", - "\n", - "2. training error $\\mathrm{Err_{Train}}$, which is the average loss over the training data.\n", - "\n", - "As our model becomes more and more complex, more of the training data tends to used. The training may thence adapt to more complicated structures in the data. This may lead to a decrease in the bias (see below for code example) and a slight increase of the variance for the test error.\n", - "For a certain level of complexity the test error will reach minimum, before starting to increase again. The\n", - "training error reaches a saturation.\n", - "\n", - "\n", - "\n", - "Two famous\n", - "resampling methods are the **independent bootstrap** and **the jackknife**. \n", - "\n", - "The jackknife is a special case of the independent bootstrap. Still, the jackknife was made\n", - "popular prior to the independent bootstrap. And as the popularity of\n", - "the independent bootstrap soared, new variants, such as **the dependent bootstrap**.\n", - "\n", - "The Jackknife and independent bootstrap work for\n", - "independent, identically distributed random variables.\n", - "If these conditions are not\n", - "satisfied, the methods will fail. Yet, it should be said that if the data are\n", - "independent, identically distributed, and we only want to estimate the\n", - "variance of $\\overline{X}$ (which often is the case), then there is no\n", - "need for bootstrapping. \n", - "\n", - "\n", - "The Jackknife works by making many replicas of the estimator $\\widehat{\\beta}$. \n", - "The jackknife is a resampling method where we systematically leave out one observation from the vector of observed values $\\boldsymbol{x} = (x_1,x_2,\\cdots,X_n)$. \n", - "Let $\\boldsymbol{x}_i$ denote the vector" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{x}_i = (x_1,x_2,\\cdots,x_{i-1},x_{i+1},\\cdots,x_n),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which equals the vector $\\boldsymbol{x}$ with the exception that observation\n", - "number $i$ is left out. Using this notation, define\n", - "$\\widehat{\\beta}_i$ to be the estimator\n", - "$\\widehat{\\beta}$ computed using $\\vec{X}_i$." - ] - }, - { - "cell_type": "code", - "execution_count": 1, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Runtime: 0.138685 sec\n", - "Jackknife Statistics :\n", - "original bias std. error\n", - " 99.8911 99.8811 0.149732\n" - ] - } - ], - "source": [ - "from numpy import *\n", - "from numpy.random import randint, randn\n", - "from time import time\n", - "\n", - "def jackknife(data, stat):\n", - " n = len(data);t = zeros(n); inds = arange(n); t0 = time()\n", - " ## 'jackknifing' by leaving out an observation for each i \n", - " for i in range(n):\n", - " t[i] = stat(delete(data,i) )\n", - "\n", - " # analysis \n", - " print(\"Runtime: %g sec\" % (time()-t0)); print(\"Jackknife Statistics :\")\n", - " print(\"original bias std. error\")\n", - " print(\"%8g %14g %15g\" % (stat(data),(n-1)*mean(t)/n, (n*var(t))**.5))\n", - "\n", - " return t\n", - "\n", - "\n", - "# Returns mean of data samples \n", - "def stat(data):\n", - " return mean(data)\n", - "\n", - "\n", - "mu, sigma = 100, 15\n", - "datapoints = 10000\n", - "x = mu + sigma*random.randn(datapoints)\n", - "# jackknife returns the data sample \n", - "t = jackknife(x, stat)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "### Bootstrap\n", - "\n", - "Bootstrapping is a nonparametric approach to statistical inference\n", - "that substitutes computation for more traditional distributional\n", - "assumptions and asymptotic results. Bootstrapping offers a number of\n", - "advantages: \n", - "1. The bootstrap is quite general, although there are some cases in which it fails. \n", - "\n", - "2. Because it does not require distributional assumptions (such as normally distributed errors), the bootstrap can provide more accurate inferences when the data are not well behaved or when the sample size is small. \n", - "\n", - "3. It is possible to apply the bootstrap to statistics with sampling distributions that are difficult to derive, even asymptotically. \n", - "\n", - "4. It is relatively simple to apply the bootstrap to complex data-collection plans (such as stratified and clustered samples).\n", - "\n", - "Since $\\widehat{\\beta} = \\widehat{\\beta}(\\boldsymbol{X})$ is a function of random variables,\n", - "$\\widehat{\\beta}$ itself must be a random variable. Thus it has\n", - "a pdf, call this function $p(\\boldsymbol{t})$. The aim of the bootstrap is to\n", - "estimate $p(\\boldsymbol{t})$ by the relative frequency of\n", - "$\\widehat{\\beta}$. You can think of this as using a histogram\n", - "in the place of $p(\\boldsymbol{t})$. If the relative frequency closely\n", - "resembles $p(\\vec{t})$, then using numerics, it is straight forward to\n", - "estimate all the interesting parameters of $p(\\boldsymbol{t})$ using point\n", - "estimators. \n", - "\n", - "\n", - "\n", - "In the case that $\\widehat{\\beta}$ has\n", - "more than one component, and the components are independent, we use the\n", - "same estimator on each component separately. If the probability\n", - "density function of $X_i$, $p(x)$, had been known, then it would have\n", - "been straight forward to do this by: \n", - "1. Drawing lots of numbers from $p(x)$, suppose we call one such set of numbers $(X_1^*, X_2^*, \\cdots, X_n^*)$. \n", - "\n", - "2. Then using these numbers, we could compute a replica of $\\widehat{\\beta}$ called $\\widehat{\\beta}^*$. \n", - "\n", - "By repeated use of (1) and (2), many\n", - "estimates of $\\widehat{\\beta}$ could have been obtained. The\n", - "idea is to use the relative frequency of $\\widehat{\\beta}^*$\n", - "(think of a histogram) as an estimate of $p(\\boldsymbol{t})$.\n", - "\n", - "\n", - "But\n", - "unless there is enough information available about the process that\n", - "generated $X_1,X_2,\\cdots,X_n$, $p(x)$ is in general\n", - "unknown. Therefore, [Efron in 1979](https://projecteuclid.org/euclid.aos/1176344552) asked the\n", - "question: What if we replace $p(x)$ by the relative frequency\n", - "of the observation $X_i$; if we draw observations in accordance with\n", - "the relative frequency of the observations, will we obtain the same\n", - "result in some asymptotic sense? The answer is yes.\n", - "\n", - "\n", - "Instead of generating the histogram for the relative\n", - "frequency of the observation $X_i$, just draw the values\n", - "$(X_1^*,X_2^*,\\cdots,X_n^*)$ with replacement from the vector\n", - "$\\boldsymbol{X}$. \n", - "\n", - "\n", - "The independent bootstrap works like this: \n", - "\n", - "1. Draw with replacement $n$ numbers for the observed variables $\\boldsymbol{x} = (x_1,x_2,\\cdots,x_n)$. \n", - "\n", - "2. Define a vector $\\boldsymbol{x}^*$ containing the values which were drawn from $\\boldsymbol{x}$. \n", - "\n", - "3. Using the vector $\\boldsymbol{x}^*$ compute $\\widehat{\\beta}^*$ by evaluating $\\widehat \\beta$ under the observations $\\boldsymbol{x}^*$. \n", - "\n", - "4. Repeat this process $k$ times. \n", - "\n", - "When you are done, you can draw a histogram of the relative frequency\n", - "of $\\widehat \\beta^*$. This is your estimate of the probability\n", - "distribution $p(t)$. Using this probability distribution you can\n", - "estimate any statistics thereof. In principle you never draw the\n", - "histogram of the relative frequency of $\\widehat{\\beta}^*$. Instead\n", - "you use the estimators corresponding to the statistic of interest. For\n", - "example, if you are interested in estimating the variance of $\\widehat\n", - "\\beta$, apply the etsimator $\\widehat \\sigma^2$ to the values\n", - "$\\widehat \\beta^*$.\n", - "\n", - "Before we proceed however, we need to remind ourselves about a central\n", - "theorem in statistics, namely the so-called **central limit theorem**.\n", - "This theorem plays a central role in understanding why the Bootstrap\n", - "(and other resampling methods) work so well on independent and\n", - "identically distributed variables.\n", - "\n", - "\n", - "Suppose we have a PDF $p(x)$ from which we generate a series $N$\n", - "of averages $\\langle x_i \\rangle$. Each mean value $\\langle x_i \\rangle$\n", - "is viewed as the average of a specific measurement, e.g., throwing \n", - "dice 100 times and then taking the average value, or producing a certain\n", - "amount of random numbers. \n", - "For notational ease, we set $\\langle x_i \\rangle=x_i$ in the discussion\n", - "which follows. \n", - "\n", - "If we compute the mean $z$ of $m$ such mean values $x_i$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "z=\\frac{x_1+x_2+\\dots+x_m}{m},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "the question we pose is which is the PDF of the new variable $z$.\n", - "\n", - "\n", - "The probability of obtaining an average value $z$ is the product of the \n", - "probabilities of obtaining arbitrary individual mean values $x_i$,\n", - "but with the constraint that the average is $z$. We can express this through\n", - "the following expression" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\tilde{p}(z)=\\int dx_1p(x_1)\\int dx_2p(x_2)\\dots\\int dx_mp(x_m)\n", - " \\delta(z-\\frac{x_1+x_2+\\dots+x_m}{m}),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where the $\\delta$-function enbodies the constraint that the mean is $z$.\n", - "All measurements that lead to each individual $x_i$ are expected to\n", - "be independent, which in turn means that we can express $\\tilde{p}$ as the \n", - "product of individual $p(x_i)$. The independence assumption is important in the derivation of the central limit theorem.\n", - "\n", - "\n", - "\n", - "If we use the integral expression for the $\\delta$-function" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\delta(z-\\frac{x_1+x_2+\\dots+x_m}{m})=\\frac{1}{2\\pi}\\int_{-\\infty}^{\\infty}\n", - " dq\\exp{\\left(iq(z-\\frac{x_1+x_2+\\dots+x_m}{m})\\right)},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and inserting $e^{i\\mu q-i\\mu q}$ where $\\mu$ is the mean value\n", - "we arrive at" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\tilde{p}(z)=\\frac{1}{2\\pi}\\int_{-\\infty}^{\\infty}\n", - " dq\\exp{\\left(iq(z-\\mu)\\right)}\\left[\\int_{-\\infty}^{\\infty}\n", - " dxp(x)\\exp{\\left(iq(\\mu-x)/m\\right)}\\right]^m,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with the integral over $x$ resulting in" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\int_{-\\infty}^{\\infty}dxp(x)\\exp{\\left(iq(\\mu-x)/m\\right)}=\n", - " \\int_{-\\infty}^{\\infty}dxp(x)\n", - " \\left[1+\\frac{iq(\\mu-x)}{m}-\\frac{q^2(\\mu-x)^2}{2m^2}+\\dots\\right].\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The second term on the rhs disappears since this is just the mean and \n", - "employing the definition of $\\sigma^2$ we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\int_{-\\infty}^{\\infty}dxp(x)e^{\\left(iq(\\mu-x)/m\\right)}=\n", - " 1-\\frac{q^2\\sigma^2}{2m^2}+\\dots,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "resulting in" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\left[\\int_{-\\infty}^{\\infty}dxp(x)\\exp{\\left(iq(\\mu-x)/m\\right)}\\right]^m\\approx\n", - " \\left[1-\\frac{q^2\\sigma^2}{2m^2}+\\dots \\right]^m,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and in the limit $m\\rightarrow \\infty$ we obtain" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\tilde{p}(z)=\\frac{1}{\\sqrt{2\\pi}(\\sigma/\\sqrt{m})}\n", - " \\exp{\\left(-\\frac{(z-\\mu)^2}{2(\\sigma/\\sqrt{m})^2}\\right)},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which is the normal distribution with variance\n", - "$\\sigma^2_m=\\sigma^2/m$, where $\\sigma$ is the variance of the PDF $p(x)$\n", - "and $\\mu$ is also the mean of the PDF $p(x)$. \n", - "\n", - "\n", - "Thus, the central limit theorem states that the PDF $\\tilde{p}(z)$ of\n", - "the average of $m$ random values corresponding to a PDF $p(x)$ \n", - "is a normal distribution whose mean is the \n", - "mean value of the PDF $p(x)$ and whose variance is the variance\n", - "of the PDF $p(x)$ divided by $m$, the number of values used to compute $z$.\n", - "\n", - "The central limit theorem leads to the well-known expression for the\n", - "standard deviation, given by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\sigma_m=\n", - "\\frac{\\sigma}{\\sqrt{m}}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The latter is true only if the average value is known exactly. This is obtained in the limit\n", - "$m\\rightarrow \\infty$ only. Because the mean and the variance are measured quantities we obtain \n", - "the familiar expression in statistics" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\sigma_m\\approx \n", - "\\frac{\\sigma}{\\sqrt{m-1}}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In many cases however the above estimate for the standard deviation,\n", - "in particular if correlations are strong, may be too simplistic. Keep\n", - "in mind that we have assumed that the variables $x$ are independent\n", - "and identically distributed. This is obviously not always the\n", - "case. For example, the random numbers (or better pseudorandom numbers)\n", - "we generate in various calculations do always exhibit some\n", - "correlations.\n", - "\n", - "\n", - "\n", - "The theorem is satisfied by a large class of PDFs. Note however that for a\n", - "finite $m$, it is not always possible to find a closed form /analytic expression for\n", - "$\\tilde{p}(x)$.\n", - "\n", - "\n", - "The following code starts with a Gaussian distribution with mean value\n", - "$\\mu =100$ and variance $\\sigma=15$. We use this to generate the data\n", - "used in the bootstrap analysis. The bootstrap analysis returns a data\n", - "set after a given number of bootstrap operations (as many as we have\n", - "data points). This data set consists of estimated mean values for each\n", - "bootstrap operation. The histogram generated by the bootstrap method\n", - "shows that the distribution for these mean values is also a Gaussian,\n", - "centered around the mean value $\\mu=100$ but with standard deviation\n", - "$\\sigma/\\sqrt{n}$, where $n$ is the number of bootstrap samples (in\n", - "this case the same as the number of original data points). The value\n", - "of the standard deviation is what we expect from the central limit\n", - "theorem." - ] - }, - { - "cell_type": "code", - "execution_count": 2, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Bootstrap Statistics :\n", - "original bias std. error\n", - " 99.751 15.2137 99.7503 0.153129\n" - ] - } - ], - "source": [ - "%matplotlib inline\n", - "\n", - "import numpy as np\n", - "from time import time\n", - "from scipy.stats import norm\n", - "import matplotlib.pyplot as plt\n", - "\n", - "# Returns mean of bootstrap samples \n", - "# Bootstrap algorithm\n", - "def bootstrap(data, datapoints):\n", - " t = np.zeros(datapoints)\n", - " n = len(data)\n", - " # non-parametric bootstrap \n", - " for i in range(datapoints):\n", - " t[i] = np.mean(data[np.random.randint(0,n,n)])\n", - " # analysis \n", - " print(\"Bootstrap Statistics :\")\n", - " print(\"original bias std. error\")\n", - " print(\"%8g %8g %14g %15g\" % (np.mean(data), np.std(data),np.mean(t),np.std(t)))\n", - " return t\n", - "\n", - "# We set the mean value to 100 and the standard deviation to 15\n", - "mu, sigma = 100, 15\n", - "datapoints = 10000\n", - "# We generate random numbers according to the normal distribution\n", - "x = mu + sigma*np.random.randn(datapoints)\n", - "# bootstrap returns the data sample \n", - "t = bootstrap(x, datapoints)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We see that our new variance and from that the standard deviation, agrees with the central limit theorem.\n", - "\n", - "We plot then the histogram together with a best fit for the data set." - ] - }, - { - "cell_type": "code", - "execution_count": 3, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "data": { - "image/png": "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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter3_47_0.png" - }, - "needs_background": "light" - }, - "output_type": "display_data" - } - ], - "source": [ - "# the histogram of the bootstrapped data (normalized data if density = True)\n", - "n, binsboot, patches = plt.hist(t, 50, density=True, facecolor='red', alpha=0.75)\n", - "# add a 'best fit' line \n", - "y = norm.pdf(binsboot, np.mean(t), np.std(t))\n", - "lt = plt.plot(binsboot, y, 'b', linewidth=1)\n", - "plt.xlabel('x')\n", - "plt.ylabel('Probability')\n", - "plt.grid(True)\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## The bias-variance tradeoff\n", - "\n", - "\n", - "We will discuss the bias-variance tradeoff in the context of\n", - "continuous predictions such as regression. However, many of the\n", - "intuitions and ideas discussed here also carry over to classification\n", - "tasks. Consider a dataset $\\mathcal{L}$ consisting of the data\n", - "$\\mathbf{X}_\\mathcal{L}=\\{(y_j, \\boldsymbol{x}_j), j=0\\ldots n-1\\}$. \n", - "\n", - "Let us assume that the true data is generated from a noisy model" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{y}=f(\\boldsymbol{x}) + \\boldsymbol{\\epsilon}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $\\epsilon$ is normally distributed with mean zero and standard deviation $\\sigma^2$.\n", - "\n", - "In our derivation of the ordinary least squares method we defined then\n", - "an approximation to the function $f$ in terms of the parameters\n", - "$\\boldsymbol{\\beta}$ and the design matrix $\\boldsymbol{X}$ which embody our model,\n", - "that is $\\boldsymbol{\\tilde{y}}=\\boldsymbol{X}\\boldsymbol{\\beta}$. \n", - "\n", - "Thereafter we found the parameters $\\boldsymbol{\\beta}$ by optimizing the means squared error via the so-called cost function" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(\\boldsymbol{X},\\boldsymbol{\\beta}) =\\frac{1}{n}\\sum_{i=0}^{n-1}(y_i-\\tilde{y}_i)^2=\\mathbb{E}\\left[(\\boldsymbol{y}-\\boldsymbol{\\tilde{y}})^2\\right].\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We can rewrite this as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbb{E}\\left[(\\boldsymbol{y}-\\boldsymbol{\\tilde{y}})^2\\right]=\\frac{1}{n}\\sum_i(f_i-\\mathbb{E}\\left[\\boldsymbol{\\tilde{y}}\\right])^2+\\frac{1}{n}\\sum_i(\\tilde{y}_i-\\mathbb{E}\\left[\\boldsymbol{\\tilde{y}}\\right])^2+\\sigma^2.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The three terms represent the square of the bias of the learning\n", - "method, which can be thought of as the error caused by the simplifying\n", - "assumptions built into the method. The second term represents the\n", - "variance of the chosen model and finally the last terms is variance of\n", - "the error $\\boldsymbol{\\epsilon}$.\n", - "\n", - "To derive this equation, we need to recall that the variance of $\\boldsymbol{y}$ and $\\boldsymbol{\\epsilon}$ are both equal to $\\sigma^2$. The mean value of $\\boldsymbol{\\epsilon}$ is by definition equal to zero. Furthermore, the function $f$ is not a stochastics variable, idem for $\\boldsymbol{\\tilde{y}}$.\n", - "We use a more compact notation in terms of the expectation value" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbb{E}\\left[(\\boldsymbol{y}-\\boldsymbol{\\tilde{y}})^2\\right]=\\mathbb{E}\\left[(\\boldsymbol{f}+\\boldsymbol{\\epsilon}-\\boldsymbol{\\tilde{y}})^2\\right],\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and adding and subtracting $\\mathbb{E}\\left[\\boldsymbol{\\tilde{y}}\\right]$ we get" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbb{E}\\left[(\\boldsymbol{y}-\\boldsymbol{\\tilde{y}})^2\\right]=\\mathbb{E}\\left[(\\boldsymbol{f}+\\boldsymbol{\\epsilon}-\\boldsymbol{\\tilde{y}}+\\mathbb{E}\\left[\\boldsymbol{\\tilde{y}}\\right]-\\mathbb{E}\\left[\\boldsymbol{\\tilde{y}}\\right])^2\\right],\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which, using the abovementioned expectation values can be rewritten as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbb{E}\\left[(\\boldsymbol{y}-\\boldsymbol{\\tilde{y}})^2\\right]=\\mathbb{E}\\left[(\\boldsymbol{y}-\\mathbb{E}\\left[\\boldsymbol{\\tilde{y}}\\right])^2\\right]+\\mathrm{Var}\\left[\\boldsymbol{\\tilde{y}}\\right]+\\sigma^2,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "that is the rewriting in terms of the so-called bias, the variance of the model $\\boldsymbol{\\tilde{y}}$ and the variance of $\\boldsymbol{\\epsilon}$." - ] - }, - { - "cell_type": "code", - "execution_count": 4, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Error: 0.01312157412031145\n", - "Bias^2: 0.012073649480472317\n", - "Var: 0.0010479246398391328\n", - "0.01312157412031145 >= 0.012073649480472317 + 0.0010479246398391328 = 0.01312157412031145\n" - ] - }, - { - "data": { - "image/png": "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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter3_61_1.png" - }, - "needs_background": "light" - }, - "output_type": "display_data" - } - ], - "source": [ - "import matplotlib.pyplot as plt\n", - "import numpy as np\n", - "from sklearn.linear_model import LinearRegression, Ridge, Lasso\n", - "from sklearn.preprocessing import PolynomialFeatures\n", - "from sklearn.model_selection import train_test_split\n", - "from sklearn.pipeline import make_pipeline\n", - "from sklearn.utils import resample\n", - "\n", - "np.random.seed(2018)\n", - "\n", - "n = 500\n", - "n_boostraps = 100\n", - "degree = 18 # A quite high value, just to show.\n", - "noise = 0.1\n", - "\n", - "# Make data set.\n", - "x = np.linspace(-1, 3, n).reshape(-1, 1)\n", - "y = np.exp(-x**2) + 1.5 * np.exp(-(x-2)**2) + np.random.normal(0, 0.1, x.shape)\n", - "\n", - "# Hold out some test data that is never used in training.\n", - "x_train, x_test, y_train, y_test = train_test_split(x, y, test_size=0.2)\n", - "\n", - "# Combine x transformation and model into one operation.\n", - "# Not neccesary, but convenient.\n", - "model = make_pipeline(PolynomialFeatures(degree=degree), LinearRegression(fit_intercept=False))\n", - "\n", - "# The following (m x n_bootstraps) matrix holds the column vectors y_pred\n", - "# for each bootstrap iteration.\n", - "y_pred = np.empty((y_test.shape[0], n_boostraps))\n", - "for i in range(n_boostraps):\n", - " x_, y_ = resample(x_train, y_train)\n", - "\n", - " # Evaluate the new model on the same test data each time.\n", - " y_pred[:, i] = model.fit(x_, y_).predict(x_test).ravel()\n", - "\n", - "# Note: Expectations and variances taken w.r.t. different training\n", - "# data sets, hence the axis=1. Subsequent means are taken across the test data\n", - "# set in order to obtain a total value, but before this we have error/bias/variance\n", - "# calculated per data point in the test set.\n", - "# Note 2: The use of keepdims=True is important in the calculation of bias as this \n", - "# maintains the column vector form. Dropping this yields very unexpected results.\n", - "error = np.mean( np.mean((y_test - y_pred)**2, axis=1, keepdims=True) )\n", - "bias = np.mean( (y_test - np.mean(y_pred, axis=1, keepdims=True))**2 )\n", - "variance = np.mean( np.var(y_pred, axis=1, keepdims=True) )\n", - "print('Error:', error)\n", - "print('Bias^2:', bias)\n", - "print('Var:', variance)\n", - "print('{} >= {} + {} = {}'.format(error, bias, variance, bias+variance))\n", - "\n", - "plt.plot(x[::5, :], y[::5, :], label='f(x)')\n", - "plt.scatter(x_test, y_test, label='Data points')\n", - "plt.scatter(x_test, np.mean(y_pred, axis=1), label='Pred')\n", - "plt.legend()\n", - "plt.show()" - ] - }, - { - "cell_type": "code", - "execution_count": 5, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Polynomial degree: 0\n", - "Error: 0.32149601703519126\n", - "Bias^2: 0.3123314713548606\n", - "Var: 0.009164545680330616\n", - "0.32149601703519126 >= 0.3123314713548606 + 0.009164545680330616 = 0.3214960170351912\n", - "Polynomial degree:" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - " 1\n", - "Error: 0.08426840630693411\n", - "Bias^2: 0.07968918676726028\n", - "Var: 0.004579219539673833\n", - "0.08426840630693411 >= 0.07968918676726028 + 0.004579219539673833 = 0.08426840630693411\n", - "Polynomial degree: 2\n", - "Error: 0.10398646080125035\n", - "Bias^2: 0.10077114273548986\n", - "Var: 0.0032153180657605086\n", - "0.10398646080125035 >= 0.10077114273548986 + 0.0032153180657605086 = 0.10398646080125036\n", - "Polynomial degree: 3\n", - "Error: 0.06547790180152352\n", - "Bias^2: 0.062082386342319454\n", - "Var: 0.0033955154592040936\n", - "0.06547790180152352 >= 0.062082386342319454 + 0.0033955154592040936 = 0.06547790180152355\n", - "Polynomial degree: 4\n", - "Error: 0.06844519414009442\n", - "Bias^2: 0.06453579006728317\n", - "Var: 0.003909404072811237\n", - "0.06844519414009442 >= 0.06453579006728317 + 0.003909404072811237 = 0.06844519414009441\n", - "Polynomial degree:" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - " 5\n", - "Error: 0.05227921801205707\n", - "Bias^2: 0.048187277304303125\n", - "Var: 0.004091940707753964\n", - "0.05227921801205707 >= 0.048187277304303125 + 0.004091940707753964 = 0.05227921801205709\n", - "Polynomial degree: 6\n", - "Error: 0.03781367141738898\n", - "Bias^2: 0.03365768507152761\n", - "Var: 0.004155986345861379\n", - "0.03781367141738898 >= 0.03365768507152761 + 0.004155986345861379 = 0.03781367141738899\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Polynomial degree: 7\n", - "Error: 0.027609773491022498\n", - "Bias^2: 0.02299949826036597\n", - "Var: 0.004610275230656537\n", - "0.027609773491022498 >= 0.02299949826036597 + 0.004610275230656537 = 0.027609773491022505\n", - "Polynomial degree: 8\n", - "Error: 0.017355848195591973\n", - "Bias^2: 0.010331721306655588\n", - "Var: 0.007024126888936384\n", - "0.017355848195591973 >= 0.010331721306655588 + 0.007024126888936384 = 0.017355848195591973\n", - "Polynomial degree: 9\n", - "Error: 0.026605727637189085\n", - "Bias^2: 0.010018312644140933\n", - "Var: 0.016587414993048166\n", - "0.026605727637189085 >= 0.010018312644140933 + 0.016587414993048166 = 0.0266057276371891\n", - "Polynomial degree: 10\n", - "Error: 0.021592704588043153\n", - "Bias^2: 0.010516485576652981\n", - "Var: 0.011076219011390184\n", - "0.021592704588043153 >= 0.010516485576652981 + 0.011076219011390184 = 0.021592704588043167\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Polynomial degree: 11\n", - "Error: 0.07160048164228314\n", - "Bias^2: 0.01443680008897583\n", - "Var: 0.0571636815533073\n", - "0.07160048164228314 >= 0.01443680008897583 + 0.0571636815533073 = 0.07160048164228312\n", - "Polynomial degree: 12\n", - "Error: 0.1154777721897675\n", - "Bias^2: 0.01628578269590588\n", - "Var: 0.09919198949386163\n", - "0.1154777721897675 >= 0.01628578269590588 + 0.09919198949386163 = 0.11547777218976751\n", - "Polynomial degree: 13\n", - "Error: 0.22842468702166951\n", - "Bias^2: 0.01975416527163567\n", - "Var: 0.20867052175003387\n", - "0.22842468702166951 >= 0.01975416527163567 + 0.20867052175003387 = 0.22842468702166954\n" - ] - }, - { - "data": { - "image/png": "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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter3_62_5.png" - }, - "needs_background": "light" - }, - "output_type": "display_data" - } - ], - "source": [ - "import matplotlib.pyplot as plt\n", - "import numpy as np\n", - "from sklearn.linear_model import LinearRegression, Ridge, Lasso\n", - "from sklearn.preprocessing import PolynomialFeatures\n", - "from sklearn.model_selection import train_test_split\n", - "from sklearn.pipeline import make_pipeline\n", - "from sklearn.utils import resample\n", - "\n", - "np.random.seed(2018)\n", - "\n", - "n = 40\n", - "n_boostraps = 100\n", - "maxdegree = 14\n", - "\n", - "\n", - "# Make data set.\n", - "x = np.linspace(-3, 3, n).reshape(-1, 1)\n", - "y = np.exp(-x**2) + 1.5 * np.exp(-(x-2)**2)+ np.random.normal(0, 0.1, x.shape)\n", - "error = np.zeros(maxdegree)\n", - "bias = np.zeros(maxdegree)\n", - "variance = np.zeros(maxdegree)\n", - "polydegree = np.zeros(maxdegree)\n", - "x_train, x_test, y_train, y_test = train_test_split(x, y, test_size=0.2)\n", - "\n", - "for degree in range(maxdegree):\n", - " model = make_pipeline(PolynomialFeatures(degree=degree), LinearRegression(fit_intercept=False))\n", - " y_pred = np.empty((y_test.shape[0], n_boostraps))\n", - " for i in range(n_boostraps):\n", - " x_, y_ = resample(x_train, y_train)\n", - " y_pred[:, i] = model.fit(x_, y_).predict(x_test).ravel()\n", - "\n", - " polydegree[degree] = degree\n", - " error[degree] = np.mean( np.mean((y_test - y_pred)**2, axis=1, keepdims=True) )\n", - " bias[degree] = np.mean( (y_test - np.mean(y_pred, axis=1, keepdims=True))**2 )\n", - " variance[degree] = np.mean( np.var(y_pred, axis=1, keepdims=True) )\n", - " print('Polynomial degree:', degree)\n", - " print('Error:', error[degree])\n", - " print('Bias^2:', bias[degree])\n", - " print('Var:', variance[degree])\n", - " print('{} >= {} + {} = {}'.format(error[degree], bias[degree], variance[degree], bias[degree]+variance[degree]))\n", - "\n", - "plt.plot(polydegree, error, label='Error')\n", - "plt.plot(polydegree, bias, label='bias')\n", - "plt.plot(polydegree, variance, label='Variance')\n", - "plt.legend()\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The bias-variance tradeoff summarizes the fundamental tension in\n", - "machine learning, particularly supervised learning, between the\n", - "complexity of a model and the amount of training data needed to train\n", - "it. Since data is often limited, in practice it is often useful to\n", - "use a less-complex model with higher bias, that is a model whose asymptotic\n", - "performance is worse than another model because it is easier to\n", - "train and less sensitive to sampling noise arising from having a\n", - "finite-sized training dataset (smaller variance). \n", - "\n", - "\n", - "\n", - "The above equations tell us that in\n", - "order to minimize the expected test error, we need to select a\n", - "statistical learning method that simultaneously achieves low variance\n", - "and low bias. Note that variance is inherently a nonnegative quantity,\n", - "and squared bias is also nonnegative. Hence, we see that the expected\n", - "test MSE can never lie below $Var(\\epsilon)$, the irreducible error.\n", - "\n", - "\n", - "What do we mean by the variance and bias of a statistical learning\n", - "method? The variance refers to the amount by which our model would change if we\n", - "estimated it using a different training data set. Since the training\n", - "data are used to fit the statistical learning method, different\n", - "training data sets will result in a different estimate. But ideally the\n", - "estimate for our model should not vary too much between training\n", - "sets. However, if a method has high variance then small changes in\n", - "the training data can result in large changes in the model. In general, more\n", - "flexible statistical methods have higher variance.\n", - "\n", - "\n", - "You may also find this recent [article](https://www.pnas.org/content/116/32/15849) of interest." - ] - }, - { - "cell_type": "code", - "execution_count": 6, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "\n", - "============================\n", - "Underfitting vs. Overfitting\n", - "============================\n", - "\n", - "This example demonstrates the problems of underfitting and overfitting and\n", - "how we can use linear regression with polynomial features to approximate\n", - "nonlinear functions. The plot shows the function that we want to approximate,\n", - "which is a part of the cosine function. In addition, the samples from the\n", - "real function and the approximations of different models are displayed. The\n", - "models have polynomial features of different degrees. We can see that a\n", - "linear function (polynomial with degree 1) is not sufficient to fit the\n", - "training samples. This is called **underfitting**. A polynomial of degree 4\n", - "approximates the true function almost perfectly. However, for higher degrees\n", - "the model will **overfit** the training data, i.e. it learns the noise of the\n", - "training data.\n", - "We evaluate quantitatively **overfitting** / **underfitting** by using\n", - "cross-validation. We calculate the mean squared error (MSE) on the validation\n", - "set, the higher, the less likely the model generalizes correctly from the\n", - "training data.\n", - "\n" - ] - }, - { - "data": { - "image/png": "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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter3_64_1.png" - } - }, - "output_type": "display_data" - } - ], - "source": [ - "\"\"\"\n", - "============================\n", - "Underfitting vs. Overfitting\n", - "============================\n", - "\n", - "This example demonstrates the problems of underfitting and overfitting and\n", - "how we can use linear regression with polynomial features to approximate\n", - "nonlinear functions. The plot shows the function that we want to approximate,\n", - "which is a part of the cosine function. In addition, the samples from the\n", - "real function and the approximations of different models are displayed. The\n", - "models have polynomial features of different degrees. We can see that a\n", - "linear function (polynomial with degree 1) is not sufficient to fit the\n", - "training samples. This is called **underfitting**. A polynomial of degree 4\n", - "approximates the true function almost perfectly. However, for higher degrees\n", - "the model will **overfit** the training data, i.e. it learns the noise of the\n", - "training data.\n", - "We evaluate quantitatively **overfitting** / **underfitting** by using\n", - "cross-validation. We calculate the mean squared error (MSE) on the validation\n", - "set, the higher, the less likely the model generalizes correctly from the\n", - "training data.\n", - "\"\"\"\n", - "\n", - "print(__doc__)\n", - "\n", - "import numpy as np\n", - "import matplotlib.pyplot as plt\n", - "from sklearn.pipeline import Pipeline\n", - "from sklearn.preprocessing import PolynomialFeatures\n", - "from sklearn.linear_model import LinearRegression\n", - "from sklearn.model_selection import cross_val_score\n", - "\n", - "\n", - "def true_fun(X):\n", - " return np.cos(1.5 * np.pi * X)\n", - "\n", - "np.random.seed(0)\n", - "\n", - "n_samples = 30\n", - "degrees = [1, 4, 15]\n", - "\n", - "X = np.sort(np.random.rand(n_samples))\n", - "y = true_fun(X) + np.random.randn(n_samples) * 0.1\n", - "\n", - "plt.figure(figsize=(14, 5))\n", - "for i in range(len(degrees)):\n", - " ax = plt.subplot(1, len(degrees), i + 1)\n", - " plt.setp(ax, xticks=(), yticks=())\n", - "\n", - " polynomial_features = PolynomialFeatures(degree=degrees[i],\n", - " include_bias=False)\n", - " linear_regression = LinearRegression()\n", - " pipeline = Pipeline([(\"polynomial_features\", polynomial_features),\n", - " (\"linear_regression\", linear_regression)])\n", - " pipeline.fit(X[:, np.newaxis], y)\n", - "\n", - " # Evaluate the models using crossvalidation\n", - " scores = cross_val_score(pipeline, X[:, np.newaxis], y,\n", - " scoring=\"neg_mean_squared_error\", cv=10)\n", - "\n", - " X_test = np.linspace(0, 1, 100)\n", - " plt.plot(X_test, pipeline.predict(X_test[:, np.newaxis]), label=\"Model\")\n", - " plt.plot(X_test, true_fun(X_test), label=\"True function\")\n", - " plt.scatter(X, y, edgecolor='b', s=20, label=\"Samples\")\n", - " plt.xlabel(\"x\")\n", - " plt.ylabel(\"y\")\n", - " plt.xlim((0, 1))\n", - " plt.ylim((-2, 2))\n", - " plt.legend(loc=\"best\")\n", - " plt.title(\"Degree {}\\nMSE = {:.2e}(+/- {:.2e})\".format(\n", - " degrees[i], -scores.mean(), scores.std()))\n", - "plt.show()" - ] - }, - { - "cell_type": "code", - "execution_count": 7, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Degree of polynomial: 1\n", - "Mean squared error on training data: 439230.69504801\n", - "Mean squared error on test data: 481979.17861098\n", - "Degree of polynomial: 2\n", - "Mean squared error on training data: 115822.95008046\n", - "Mean squared error on test data: 123711.53703498\n", - "Degree of polynomial: 3\n", - "Mean squared error on training data: 9011.85263220\n", - "Mean squared error on test data: 10913.84780262\n", - "Degree of polynomial: 4\n", - "Mean squared error on training data: 303.47610036\n", - "Mean squared error on test data: 426.30787294\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Degree of polynomial: 5\n", - "Mean squared error on training data: 3.80354994\n", - "Mean squared error on test data: 5.98822371\n", - "Degree of polynomial: 6\n", - "Mean squared error on training data: 3.66204648\n", - "Mean squared error on test data: 8.14812206\n", - "Degree of polynomial: 7\n", - "Mean squared error on training data: 0.47075725\n", - "Mean squared error on test data: 2.00607783\n", - "Degree of polynomial: 8\n", - "Mean squared error on training data: 0.04912436\n", - "Mean squared error on test data: 0.21596432\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Degree of polynomial: 9\n", - "Mean squared error on training data: 0.02522069\n", - "Mean squared error on test data: 0.08576932\n", - "Degree of polynomial: 10\n", - "Mean squared error on training data: 0.02511518\n", - "Mean squared error on test data: 1.20015436\n", - "Degree of polynomial: 11\n", - "Mean squared error on training data: 0.01640891\n", - "Mean squared error on test data: 1.35533774\n", - "Degree of polynomial: 12\n", - "Mean squared error on training data: 0.00813803\n", - "Mean squared error on test data: 0.17446471\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Degree of polynomial: 13\n", - "Mean squared error on training data: 0.00759119\n", - "Mean squared error on test data: 1.08131001\n", - "Degree of polynomial: 14\n", - "Mean squared error on training data: 0.00472199\n", - "Mean squared error on test data: 0.81333802\n", - "Degree of polynomial: 15\n", - "Mean squared error on training data: 0.00410478\n", - "Mean squared error on test data: 92.09160813\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Degree of polynomial: 16\n", - "Mean squared error on training data: 0.00315593\n", - "Mean squared error on test data: 234.40530431\n", - "Degree of polynomial: 17\n", - "Mean squared error on training data: 0.00242999\n", - "Mean squared error on test data: 1270.94936405\n", - "Degree of polynomial: 18\n", - "Mean squared error on training data: 0.00228741\n", - "Mean squared error on test data: 108.11945731\n", - "Degree of polynomial: 19\n", - "Mean squared error on training data: 0.00156372\n", - "Mean squared error on test data: 1376.61081005\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Degree of polynomial: 20\n", - "Mean squared error on training data: 0.00137945\n", - "Mean squared error on test data: 1931.97211078\n", - "Degree of polynomial: 21\n", - "Mean squared error on training data: 0.00118678\n", - "Mean squared error on test data: 14496.70992192\n", - "Degree of polynomial: 22\n", - "Mean squared error on training data: 0.00092686\n", - "Mean squared error on test data: 873.95463048\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Degree of polynomial: 23\n", - "Mean squared error on training data: 0.00085890\n", - "Mean squared error on test data: 5535.20053452\n", - "Degree of polynomial: 24\n", - "Mean squared error on training data: 0.00084714\n", - "Mean squared error on test data: 1289.22422186\n", - "Degree of polynomial: 25\n", - "Mean squared error on training data: 0.00079022\n", - "Mean squared error on test data: 136582.88824397\n", - "Degree of polynomial: 26\n", - "Mean squared error on training data: 0.00076923\n", - "Mean squared error on test data: 18194.23521766\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Degree of polynomial: 27\n", - "Mean squared error on training data: 0.00069302\n", - "Mean squared error on test data: 2579.13493762\n", - "Degree of polynomial: 28\n", - "Mean squared error on training data: 0.00062728\n", - "Mean squared error on test data: 3984.82493809\n", - "Degree of polynomial: 29\n", - "Mean squared error on training data: 0.00060724\n", - "Mean squared error on test data: 3204.07047448\n" - ] - }, - { - "name": "stderr", - "output_type": "stream", - "text": [ - ":73: RuntimeWarning: divide by zero encountered in log10\n", - " plt.plot(polynomial, np.log10(trainingerror), label='Training Error')\n", - ":74: RuntimeWarning: divide by zero encountered in log10\n", - " plt.plot(polynomial, np.log10(testerror), label='Test Error')\n" - ] - }, - { - "data": { - "image/png": "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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter3_65_9.png" - }, - "needs_background": "light" - }, - "output_type": "display_data" - } - ], - "source": [ - "# Common imports\n", - "import os\n", - "import numpy as np\n", - "import pandas as pd\n", - "import matplotlib.pyplot as plt\n", - "from sklearn.linear_model import LinearRegression, Ridge, Lasso\n", - "from sklearn.model_selection import train_test_split\n", - "from sklearn.utils import resample\n", - "from sklearn.metrics import mean_squared_error\n", - "# Where to save the figures and data files\n", - "PROJECT_ROOT_DIR = \"Results\"\n", - "FIGURE_ID = \"Results/FigureFiles\"\n", - "DATA_ID = \"DataFiles/\"\n", - "\n", - "if not os.path.exists(PROJECT_ROOT_DIR):\n", - " os.mkdir(PROJECT_ROOT_DIR)\n", - "\n", - "if not os.path.exists(FIGURE_ID):\n", - " os.makedirs(FIGURE_ID)\n", - "\n", - "if not os.path.exists(DATA_ID):\n", - " os.makedirs(DATA_ID)\n", - "\n", - "def image_path(fig_id):\n", - " return os.path.join(FIGURE_ID, fig_id)\n", - "\n", - "def data_path(dat_id):\n", - " return os.path.join(DATA_ID, dat_id)\n", - "\n", - "def save_fig(fig_id):\n", - " plt.savefig(image_path(fig_id) + \".png\", format='png')\n", - "\n", - "infile = open(data_path(\"EoS.csv\"),'r')\n", - "\n", - "# Read the EoS data as csv file and organize the data into two arrays with density and energies\n", - "EoS = pd.read_csv(infile, names=('Density', 'Energy'))\n", - "EoS['Energy'] = pd.to_numeric(EoS['Energy'], errors='coerce')\n", - "EoS = EoS.dropna()\n", - "Energies = EoS['Energy']\n", - "Density = EoS['Density']\n", - "# The design matrix now as function of various polytrops\n", - "\n", - "Maxpolydegree = 30\n", - "X = np.zeros((len(Density),Maxpolydegree))\n", - "X[:,0] = 1.0\n", - "testerror = np.zeros(Maxpolydegree)\n", - "trainingerror = np.zeros(Maxpolydegree)\n", - "polynomial = np.zeros(Maxpolydegree)\n", - "\n", - "trials = 100\n", - "for polydegree in range(1, Maxpolydegree):\n", - " polynomial[polydegree] = polydegree\n", - " for degree in range(polydegree):\n", - " X[:,degree] = Density**(degree/3.0)\n", - "\n", - "# loop over trials in order to estimate the expectation value of the MSE\n", - " testerror[polydegree] = 0.0\n", - " trainingerror[polydegree] = 0.0\n", - " for samples in range(trials):\n", - " x_train, x_test, y_train, y_test = train_test_split(X, Energies, test_size=0.2)\n", - " model = LinearRegression(fit_intercept=False).fit(x_train, y_train)\n", - " ypred = model.predict(x_train)\n", - " ytilde = model.predict(x_test)\n", - " testerror[polydegree] += mean_squared_error(y_test, ytilde)\n", - " trainingerror[polydegree] += mean_squared_error(y_train, ypred) \n", - "\n", - " testerror[polydegree] /= trials\n", - " trainingerror[polydegree] /= trials\n", - " print(\"Degree of polynomial: %3d\"% polynomial[polydegree])\n", - " print(\"Mean squared error on training data: %.8f\" % trainingerror[polydegree])\n", - " print(\"Mean squared error on test data: %.8f\" % testerror[polydegree])\n", - "\n", - "plt.plot(polynomial, np.log10(trainingerror), label='Training Error')\n", - "plt.plot(polynomial, np.log10(testerror), label='Test Error')\n", - "plt.xlabel('Polynomial degree')\n", - "plt.ylabel('log10[MSE]')\n", - "plt.legend()\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Cross-validation\n", - "\n", - "When the repetitive splitting of the data set is done randomly,\n", - "samples may accidently end up in a fast majority of the splits in\n", - "either training or test set. Such samples may have an unbalanced\n", - "influence on either model building or prediction evaluation. To avoid\n", - "this $k$-fold cross-validation structures the data splitting. The\n", - "samples are divided into $k$ more or less equally sized exhaustive and\n", - "mutually exclusive subsets. In turn (at each split) one of these\n", - "subsets plays the role of the test set while the union of the\n", - "remaining subsets constitutes the training set. Such a splitting\n", - "warrants a balanced representation of each sample in both training and\n", - "test set over the splits. Still the division into the $k$ subsets\n", - "involves a degree of randomness. This may be fully excluded when\n", - "choosing $k=n$. This particular case is referred to as leave-one-out\n", - "cross-validation (LOOCV). \n", - "\n", - "\n", - "* Define a range of interest for the penalty parameter.\n", - "\n", - "* Divide the data set into training and test set comprising samples $\\{1, \\ldots, n\\} \\setminus i$ and $\\{ i \\}$, respectively.\n", - "\n", - "* Fit the linear regression model by means of ridge estimation for each $\\lambda$ in the grid using the training set, and the corresponding estimate of the error variance $\\boldsymbol{\\sigma}_{-i}^2(\\lambda)$, as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{align*}\n", - "\\boldsymbol{\\beta}_{-i}(\\lambda) & = ( \\boldsymbol{X}_{-i, \\ast}^{T}\n", - "\\boldsymbol{X}_{-i, \\ast} + \\lambda \\boldsymbol{I}_{pp})^{-1}\n", - "\\boldsymbol{X}_{-i, \\ast}^{T} \\boldsymbol{y}_{-i}\n", - "\\end{align*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "* Evaluate the prediction performance of these models on the test set by $\\log\\{L[y_i, \\boldsymbol{X}_{i, \\ast}; \\boldsymbol{\\beta}_{-i}(\\lambda), \\boldsymbol{\\sigma}_{-i}^2(\\lambda)]\\}$. Or, by the prediction error $|y_i - \\boldsymbol{X}_{i, \\ast} \\boldsymbol{\\beta}_{-i}(\\lambda)|$, the relative error, the error squared or the R2 score function.\n", - "\n", - "* Repeat the first three steps such that each sample plays the role of the test set once.\n", - "\n", - "* Average the prediction performances of the test sets at each grid point of the penalty bias/parameter. It is an estimate of the prediction performance of the model corresponding to this value of the penalty parameter on novel data. It is defined as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{align*}\n", - "\\frac{1}{n} \\sum_{i = 1}^n \\log\\{L[y_i, \\mathbf{X}_{i, \\ast}; \\boldsymbol{\\beta}_{-i}(\\lambda), \\boldsymbol{\\sigma}_{-i}^2(\\lambda)]\\}.\n", - "\\end{align*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "For the various values of $k$\n", - "\n", - "1. shuffle the dataset randomly.\n", - "\n", - "2. Split the dataset into $k$ groups.\n", - "\n", - "3. For each unique group:\n", - "\n", - "a. Decide which group to use as set for test data\n", - "\n", - "b. Take the remaining groups as a training data set\n", - "\n", - "c. Fit a model on the training set and evaluate it on the test set\n", - "\n", - "d. Retain the evaluation score and discard the model\n", - "\n", - "\n", - "5. Summarize the model using the sample of model evaluation scores\n", - "\n", - "The code here uses Ridge regression with cross-validation (CV) resampling and $k$-fold CV in order to fit a specific polynomial." - ] - }, - { - "cell_type": "code", - "execution_count": 8, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "data": { - "image/png": "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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter3_71_0.png" - }, - "needs_background": "light" - }, - "output_type": "display_data" - } - ], - "source": [ - "import numpy as np\n", - "import matplotlib.pyplot as plt\n", - "from sklearn.model_selection import KFold\n", - "from sklearn.linear_model import Ridge\n", - "from sklearn.model_selection import cross_val_score\n", - "from sklearn.preprocessing import PolynomialFeatures\n", - "\n", - "# A seed just to ensure that the random numbers are the same for every run.\n", - "# Useful for eventual debugging.\n", - "np.random.seed(3155)\n", - "\n", - "# Generate the data.\n", - "nsamples = 100\n", - "x = np.random.randn(nsamples)\n", - "y = 3*x**2 + np.random.randn(nsamples)\n", - "\n", - "## Cross-validation on Ridge regression using KFold only\n", - "\n", - "# Decide degree on polynomial to fit\n", - "poly = PolynomialFeatures(degree = 6)\n", - "\n", - "# Decide which values of lambda to use\n", - "nlambdas = 500\n", - "lambdas = np.logspace(-3, 5, nlambdas)\n", - "\n", - "# Initialize a KFold instance\n", - "k = 5\n", - "kfold = KFold(n_splits = k)\n", - "\n", - "# Perform the cross-validation to estimate MSE\n", - "scores_KFold = np.zeros((nlambdas, k))\n", - "\n", - "i = 0\n", - "for lmb in lambdas:\n", - " ridge = Ridge(alpha = lmb)\n", - " j = 0\n", - " for train_inds, test_inds in kfold.split(x):\n", - " xtrain = x[train_inds]\n", - " ytrain = y[train_inds]\n", - "\n", - " xtest = x[test_inds]\n", - " ytest = y[test_inds]\n", - "\n", - " Xtrain = poly.fit_transform(xtrain[:, np.newaxis])\n", - " ridge.fit(Xtrain, ytrain[:, np.newaxis])\n", - "\n", - " Xtest = poly.fit_transform(xtest[:, np.newaxis])\n", - " ypred = ridge.predict(Xtest)\n", - "\n", - " scores_KFold[i,j] = np.sum((ypred - ytest[:, np.newaxis])**2)/np.size(ypred)\n", - "\n", - " j += 1\n", - " i += 1\n", - "\n", - "\n", - "estimated_mse_KFold = np.mean(scores_KFold, axis = 1)\n", - "\n", - "## Cross-validation using cross_val_score from sklearn along with KFold\n", - "\n", - "# kfold is an instance initialized above as:\n", - "# kfold = KFold(n_splits = k)\n", - "\n", - "estimated_mse_sklearn = np.zeros(nlambdas)\n", - "i = 0\n", - "for lmb in lambdas:\n", - " ridge = Ridge(alpha = lmb)\n", - "\n", - " X = poly.fit_transform(x[:, np.newaxis])\n", - " estimated_mse_folds = cross_val_score(ridge, X, y[:, np.newaxis], scoring='neg_mean_squared_error', cv=kfold)\n", - "\n", - " # cross_val_score return an array containing the estimated negative mse for every fold.\n", - " # we have to the the mean of every array in order to get an estimate of the mse of the model\n", - " estimated_mse_sklearn[i] = np.mean(-estimated_mse_folds)\n", - "\n", - " i += 1\n", - "\n", - "## Plot and compare the slightly different ways to perform cross-validation\n", - "\n", - "plt.figure()\n", - "\n", - "plt.plot(np.log10(lambdas), estimated_mse_sklearn, label = 'cross_val_score')\n", - "plt.plot(np.log10(lambdas), estimated_mse_KFold, 'r--', label = 'KFold')\n", - "\n", - "plt.xlabel('log10(lambda)')\n", - "plt.ylabel('mse')\n", - "\n", - "plt.legend()\n", - "\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "More examples of the application of cross-validation follow here." - ] - }, - { - "cell_type": "code", - "execution_count": 9, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stderr", - "output_type": "stream", - "text": [ - ":63: RuntimeWarning: divide by zero encountered in log10\n", - " plt.plot(polynomial, np.log10(estimated_mse_sklearn), label='Test Error')\n" - ] - }, - { - "data": { - "image/png": "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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter3_73_1.png" - }, - "needs_background": "light" - }, - "output_type": "display_data" - } - ], - "source": [ - "# Common imports\n", - "import os\n", - "import numpy as np\n", - "import pandas as pd\n", - "import matplotlib.pyplot as plt\n", - "from sklearn.linear_model import LinearRegression, Ridge, Lasso\n", - "from sklearn.metrics import mean_squared_error\n", - "from sklearn.model_selection import KFold\n", - "from sklearn.model_selection import cross_val_score\n", - "\n", - "\n", - "# Where to save the figures and data files\n", - "PROJECT_ROOT_DIR = \"Results\"\n", - "FIGURE_ID = \"Results/FigureFiles\"\n", - "DATA_ID = \"DataFiles/\"\n", - "\n", - "if not os.path.exists(PROJECT_ROOT_DIR):\n", - " os.mkdir(PROJECT_ROOT_DIR)\n", - "\n", - "if not os.path.exists(FIGURE_ID):\n", - " os.makedirs(FIGURE_ID)\n", - "\n", - "if not os.path.exists(DATA_ID):\n", - " os.makedirs(DATA_ID)\n", - "\n", - "def image_path(fig_id):\n", - " return os.path.join(FIGURE_ID, fig_id)\n", - "\n", - "def data_path(dat_id):\n", - " return os.path.join(DATA_ID, dat_id)\n", - "\n", - "def save_fig(fig_id):\n", - " plt.savefig(image_path(fig_id) + \".png\", format='png')\n", - "\n", - "infile = open(data_path(\"EoS.csv\"),'r')\n", - "\n", - "# Read the EoS data as csv file and organize the data into two arrays with density and energies\n", - "EoS = pd.read_csv(infile, names=('Density', 'Energy'))\n", - "EoS['Energy'] = pd.to_numeric(EoS['Energy'], errors='coerce')\n", - "EoS = EoS.dropna()\n", - "Energies = EoS['Energy']\n", - "Density = EoS['Density']\n", - "# The design matrix now as function of various polytrops\n", - "\n", - "Maxpolydegree = 30\n", - "X = np.zeros((len(Density),Maxpolydegree))\n", - "X[:,0] = 1.0\n", - "estimated_mse_sklearn = np.zeros(Maxpolydegree)\n", - "polynomial = np.zeros(Maxpolydegree)\n", - "k =5\n", - "kfold = KFold(n_splits = k)\n", - "\n", - "for polydegree in range(1, Maxpolydegree):\n", - " polynomial[polydegree] = polydegree\n", - " for degree in range(polydegree):\n", - " X[:,degree] = Density**(degree/3.0)\n", - " OLS = LinearRegression(fit_intercept=False)\n", - "# loop over trials in order to estimate the expectation value of the MSE\n", - " estimated_mse_folds = cross_val_score(OLS, X, Energies, scoring='neg_mean_squared_error', cv=kfold)\n", - "#[:, np.newaxis]\n", - " estimated_mse_sklearn[polydegree] = np.mean(-estimated_mse_folds)\n", - "\n", - "plt.plot(polynomial, np.log10(estimated_mse_sklearn), label='Test Error')\n", - "plt.xlabel('Polynomial degree')\n", - "plt.ylabel('log10[MSE]')\n", - "plt.legend()\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Note that we have kept the intercept in the first column of design matrix $\\boldsymbol{X}$. When we call the corresponding **Scikit-Learn** function we need thus to set the intercept to **False**. Libraries like **Scikit-Learn** normally scale the design matrix and does not fit intercept. See the discussions below.\n", - "\n", - "## More on Rescaling data\n", - "\n", - "We end this chapter by adding some words on scaling and how to deal with the intercept for regression cases.\n", - "\n", - "When you are comparing your own code with for example **Scikit-Learn**'s\n", - "library, there are some technicalities to keep in mind. The examples\n", - "here demonstrate some of these aspects with potential pitfalls.\n", - "\n", - "The discussion here focuses on the role of the intercept, how we can\n", - "set up the design matrix, what scaling we should use and other topics\n", - "which tend confuse us.\n", - "\n", - "The intercept can be interpreted as the expected value of our\n", - "target/output variables when all other predictors are set to zero.\n", - "Thus, if we cannot assume that the expected outputs/targets are zero\n", - "when all predictors are zero (the columns in the design matrix), it\n", - "may be a bad idea to implement a model which penalizes the intercept.\n", - "Furthermore, in for example Ridge and Lasso regression, the default solutions\n", - "from the library **Scikit-Learn** (when not shrinking $\\beta_0$) for the unknown parameters\n", - "$\\boldsymbol{\\beta}$, are derived under the assumption that both $\\boldsymbol{y}$ and\n", - "$\\boldsymbol{X}$ are zero centered, that is we subtract the mean values.\n", - "\n", - "\n", - "If our predictors represent different scales, then it is important to\n", - "standardize the design matrix $\\boldsymbol{X}$ by subtracting the mean of each\n", - "column from the corresponding column and dividing the column with its\n", - "standard deviation. Most machine learning libraries do this as a default. This means that if you compare your code with the results from a given library,\n", - "the results may differ. \n", - "\n", - "The\n", - "[Standardscaler](https://scikit-learn.org/stable/modules/generated/sklearn.preprocessing.StandardScaler.html)\n", - "function in **Scikit-Learn** does this for us. For the data sets we\n", - "have been studying in our various examples, the data are in many cases\n", - "already scaled and there is no need to scale them. You as a user of different machine learning algorithms, should always perform a\n", - "survey of your data, with a critical assessment of them in case you need to scale the data.\n", - "\n", - "If you need to scale the data, not doing so will give an *unfair*\n", - "penalization of the parameters since their magnitude depends on the\n", - "scale of their corresponding predictor.\n", - "\n", - "Suppose as an example that you \n", - "you have an input variable given by the heights of different persons.\n", - "Human height might be measured in inches or meters or\n", - "kilometers. If measured in kilometers, a standard linear regression\n", - "model with this predictor would probably give a much bigger\n", - "coefficient term, than if measured in millimeters.\n", - "This can clearly lead to problems in evaluating the cost/loss functions.\n", - "\n", - "\n", - "\n", - "Keep in mind that when you transform your data set before training a model, the same transformation needs to be done\n", - "on your eventual new data set before making a prediction. If we translate this into a Python code, it would could be implemented as follows" - ] - }, - { - "cell_type": "code", - "execution_count": 10, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "data": { - "text/plain": [ - "'\\n#Model training, we compute the mean value of y and X\\ny_train_mean = np.mean(y_train)\\nX_train_mean = np.mean(X_train,axis=0)\\nX_train = X_train - X_train_mean\\ny_train = y_train - y_train_mean\\n\\n# The we fit our model with the training data\\ntrained_model = some_model.fit(X_train,y_train)\\n\\n\\n#Model prediction, we need also to transform our data set used for the prediction.\\nX_test = X_test - X_train_mean #Use mean from training data\\ny_pred = trained_model(X_test)\\ny_pred = y_pred + y_train_mean\\n'" - ] - }, - "execution_count": 10, - "metadata": {}, - "output_type": "execute_result" - } - ], - "source": [ - "\"\"\"\n", - "#Model training, we compute the mean value of y and X\n", - "y_train_mean = np.mean(y_train)\n", - "X_train_mean = np.mean(X_train,axis=0)\n", - "X_train = X_train - X_train_mean\n", - "y_train = y_train - y_train_mean\n", - "\n", - "# The we fit our model with the training data\n", - "trained_model = some_model.fit(X_train,y_train)\n", - "\n", - "\n", - "#Model prediction, we need also to transform our data set used for the prediction.\n", - "X_test = X_test - X_train_mean #Use mean from training data\n", - "y_pred = trained_model(X_test)\n", - "y_pred = y_pred + y_train_mean\n", - "\"\"\"" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Let us try to understand what this may imply mathematically when we\n", - "subtract the mean values, also known as *zero centering*. For\n", - "simplicity, we will focus on ordinary regression, as done in the above example.\n", - "\n", - "The cost/loss function for regression is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(\\beta_0, \\beta_1, ... , \\beta_{p-1}) = \\frac{1}{n}\\sum_{i=0}^{n} \\left(y_i - \\beta_0 - \\sum_{j=1}^{p-1} X_{ij}\\beta_j\\right)^2,.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Recall also that we use the squared value. This expression can lead to an\n", - "increased penalty for higher differences between predicted and\n", - "output/target values.\n", - "\n", - "What we have done is to single out the $\\beta_0$ term in the\n", - "definition of the mean squared error (MSE). The design matrix $X$\n", - "does in this case not contain any intercept column. When we take the\n", - "derivative with respect to $\\beta_0$, we want the derivative to obey" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial C}{\\partial \\beta_j} = 0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "for all $j$. For $\\beta_0$ we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial C}{\\partial \\beta_0} = -\\frac{2}{n}\\sum_{i=0}^{n-1} \\left(y_i - \\beta_0 - \\sum_{j=1}^{p-1} X_{ij} \\beta_j\\right).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Multiplying away the constant $2/n$, we obtain" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\sum_{i=0}^{n-1} \\beta_0 = \\sum_{i=0}^{n-1}y_i - \\sum_{i=0}^{n-1} \\sum_{j=1}^{p-1} X_{ij} \\beta_j.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Let us specialize first to the case where we have only two parameters $\\beta_0$ and $\\beta_1$.\n", - "Our result for $\\beta_0$ simplifies then to" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "n\\beta_0 = \\sum_{i=0}^{n-1}y_i - \\sum_{i=0}^{n-1} X_{i1} \\beta_1.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We obtain then" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\beta_0 = \\frac{1}{n}\\sum_{i=0}^{n-1}y_i - \\beta_1\\frac{1}{n}\\sum_{i=0}^{n-1} X_{i1}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "If we define" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mu_{\\boldsymbol{x}_1}=\\frac{1}{n}\\sum_{i=0}^{n-1} X_{i1},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and the mean value of the outputs as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mu_y=\\frac{1}{n}\\sum_{i=0}^{n-1}y_i,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\beta_0 = \\mu_y - \\beta_1\\mu_{\\boldsymbol{x}_1}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In the general case with more parameters than $\\beta_0$ and $\\beta_1$, we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\beta_0 = \\frac{1}{n}\\sum_{i=0}^{n-1}y_i - \\frac{1}{n}\\sum_{i=0}^{n-1}\\sum_{j=1}^{p-1} X_{ij}\\beta_j.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We can rewrite the latter equation as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\beta_0 = \\frac{1}{n}\\sum_{i=0}^{n-1}y_i - \\sum_{j=1}^{p-1} \\mu_{\\boldsymbol{x}_j}\\beta_j,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where we have defined" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mu_{\\boldsymbol{x}_j}=\\frac{1}{n}\\sum_{i=0}^{n-1} X_{ij},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "the mean value for all elements of the column vector $\\boldsymbol{x}_j$.\n", - "\n", - "\n", - "\n", - "Replacing $y_i$ with $y_i - y_i - \\overline{\\boldsymbol{y}}$ and centering also our design matrix results in a cost function (in vector-matrix disguise)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(\\boldsymbol{\\beta}) = (\\boldsymbol{\\tilde{y}} - \\tilde{X}\\boldsymbol{\\beta})^T(\\boldsymbol{\\tilde{y}} - \\tilde{X}\\boldsymbol{\\beta}).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "If we minimize with respect to $\\boldsymbol{\\beta}$ we have then" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\hat{\\boldsymbol{\\beta}} = (\\tilde{X}^T\\tilde{X})^{-1}\\tilde{X}^T\\boldsymbol{\\tilde{y}},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $\\boldsymbol{\\tilde{y}} = \\boldsymbol{y} - \\overline{\\boldsymbol{y}}$\n", - "and $\\tilde{X}_{ij} = X_{ij} - \\frac{1}{n}\\sum_{k=0}^{n-1}X_{kj}$.\n", - "\n", - "For Ridge regression we need to add $\\lambda \\boldsymbol{\\beta}^T\\boldsymbol{\\beta}$ to the cost function and get then" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\hat{\\boldsymbol{\\beta}} = (\\tilde{X}^T\\tilde{X} + \\lambda I)^{-1}\\tilde{X}^T\\boldsymbol{\\tilde{y}}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "What does this mean? And why do we insist on all this? Let us look at some examples.\n", - "\n", - "\n", - "This code shows a simple first-order fit to a data set using the above transformed data, where we consider the role of the intercept first, by either excluding it or including it (*code example thanks to Øyvind Sigmundson Schøyen*). Here our scaling of the data is done by subtracting the mean values only.\n", - "Note also that we do not split the data into training and test." - ] - }, - { - "cell_type": "code", - "execution_count": 11, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "True beta: [2, 0.5, 3.7]\n", - "Fitted beta: [2.08376632 0.19569961 3.97898392]\n", - "Sklearn fitted beta: [2.08376632 0.19569961 3.97898392]\n", - "MSE with intercept column\n", - "0.004113634617443137\n", - "MSE with intercept column from SKL\n", - "0.0041136346174431284\n", - "Manual intercept: 2.083766322923905\n", - "Fitted beta (wiothout intercept): [0.19569961 3.97898392]\n", - "Sklearn intercept: 2.0837663229239025\n", - "Sklearn fitted beta (without intercept): [0.19569961 3.97898392]\n", - "MSE with Manual intercept\n", - "0.004113634617443136\n", - "MSE with Sklearn intercept\n", - "0.004113634617443135\n" - ] - }, - { - "data": { - "image/png": "iVBORw0KGgoAAAANSUhEUgAAAWoAAAD4CAYAAADFAawfAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjMuMywgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/Il7ecAAAACXBIWXMAAAsTAAALEwEAmpwYAAA7MElEQVR4nO3deVhV1frA8e8GEY+CoqKIQ+KQCsggaKKkgeY8hFNqZtqtzGuD10rTrFRuA4UN2vBrNLVraTmWDQ4BaQ4VCIihpCSKSIooCMjM+v2BnESmI9M5wPt5nvMIZ6999rs4+LLO2nu/S1NKIYQQwnSZGTsAIYQQ5ZNELYQQJk4StRBCmDhJ1EIIYeIkUQshhIlrVBMvamtrqxwcHCq1b0ZGBs2aNavegEyc9Ln+a2j9BenzrQoLC7uklGpT2rYaSdQODg6EhoZWat+QkBB8fHyqNyATJ32u/xpaf0H6fKs0TTtT1jaZ+hBCCBMniVoIIUycJGohhDBxNTJHXZrc3FzOnTtHVlZWue1atGjB8ePHaykq0yB9rhuaNGlCx44dsbCwMHYoooGptUR97tw5rK2tcXBwQNO0MtulpaVhbW1dW2GZBOmz6VNKkZyczLlz5+jSpYuxwxENTK1NfWRlZdG6detyk7QQpkrTNFq3bl3hJ0IhakKtzlFLkhZ1mfz+CmOptakPIYSor7aHJ/D9tvX4ND3LwIN5LBrliF+fDtX2+g3qqg9zc3Pc3d31j7i4OAYOHAhAXFwcX3zxhZEjFELUNdvDE1i15SfGHF1Ls1MhpFxNZcnWKLaHJ1TbMRpUotbpdEREROgfDg4OHDx4EJBELYSonNU/hPO+WSCDXK5y2nE612hCZm4+gbtiqu0YDSpRl8bKygqAxYsXs3//ftzd3XnrrbeMHJUQoi7IzcnmoailNM9JZH7+k5i3c9NvO5+SWW3HMcoc9Ypv/yD6/NVSt+Xn52Nubn7Lr+nUvjnLxjmX2yYzMxN3d3cAunTpwrZt2/TbAgICWLlyJTt37rzlYwshGqYtc3zwCM9hk86V/W1duYM8/bb2NrpqO06DOplYNPUhhBBV9dUL03A7nEJU7yZ8ZP8U5P+zTWdhzsIRPavtWEZJ1OWNfOvajRBCiIZn7/pX6Lk1krgOGqM//YnGf2Ven5NOo4ONjoUjelbrVR8NakRdHmtra9LS0owdhhDCxF04F0vu+s9JawY931mLVYtW+PUBvz4dCAkJ4YkZPtV+zAZ/MrGIq6sr5ubmuLm5yclEIUSpMjPSuPrZvbj1T8F82SK6Ot1RK8dtUCPq9PT0Mp+zsLAgKCiotkMSQtQR+Xl5fPPUUMa2jeXkkA8YMHRarR3boBG1pmk2mqZt1jTthKZpxzVNG1DTgQkhhCn5eq4vrj+nsTNzIO61mKTB8BH1KuBHpdRkTdMaA01rMCYhhDApW/wfwO2XS0Q7WTI54JtaP36FiVrTtBbAYGA2gFIqB8ip2bCEEMI0BG98k25f/c5Ze427P/kR80a1P2OsKaXKb6Bp7sBHQDTgBoQB85VSGTe1mwPMAbCzs/PcuHFjsddp0aIF3bt3rzCgyt7wUpdJn+uOU6dOkZqaesv7paen6++CbSjqQ58zUi6gW7kcy2y4MP8JWnV0Krd9Vfrs6+sbppTqW9o2QxJ1X+Aw4K2U+lXTtFXAVaXUC2Xt07dvX3XzKuTHjx/H0dGxwmAb4nXU0ue6w9Df45vJitx1T1ZmBmfeGEJB6jku9FuEz73zK9yniquQl5moDTmZeA44p5T69fr3mwGPSkUihBB1QH5eHt89P4rbc0+QdfcrBiXpmlRholZK/Q3Ea5pWdD/kUAqnQYQQol766vFhOH2XxObcu+gzYpaxwzH4hpcngA2aph0F3IFXaiyiGvTyyy/j7OyMq6sr7u7u/Ppr4YcEBwcHLl26VKK9MebXtm/fjr+/PwBJSUn079+fPn36sH//fkaPHk1KSgopKSm8//775b7O+fPnmTx5coXHe+UV472VlSkt6+DggIuLi76meFGZ2rLalva+VuSZZ56Ra+obsG0Bc3AN+ZsTPS2Y5L/V2OEUUkpV+8PT01PdLDo6usRzpbl69apB7W7VwYMHlZeXl8rKylJKKZWUlKQSEhKUUkp17txZJSUlldinWbNm1XLsvLy8crff2OcBAwboY/nyyy/VQw89VKL96dOnlbOzc7XEVpk+VtQfQ1y9elUFBwerMWPG3NJ+Zb1XVW17o7i4ODVs2LBStxn6e3yz4ODgSu1Xl9XFPu/b8q4Kc+mldg92VJcvnrvl/avSZyBUlZFTjXNn4g+L4e+oUjfp8vPAvBJhtXOBUQFlbk5MTMTW1hZLS0sAbG1tS7TJzMxk4sSJTJw4kUceeaTYtsDAQL766iuys7OZMGECK1asAMDPz4/4+HiysrKYP38+c+bMAQpH448++ih79+7lvffeY+TIkcyfP5+dO3ei0+nYsWMHdnZ2xY7x559/Ymlpia2tLRERESxatIjMzExCQ0M5dOgQjo6OhIaGsnjxYmJjY3F3d2fYsGEEBgaW6EtcXBxjx47l2LFjrF27lm+++YZr164RGxvLhAkTeP3111m8eLG+9KuzszMbNmzgf//7H6tXryYnJ4f+/fvz/vvvY25uXqI/f/31FytXrkTTNFxdXfn8889JSkpi7ty5nD17FoC3334bb29vli9fTmxsLKdOneLSpUssWrSIadOmsXjxYo4fP467uzuzZs1iwYIFt/CG/6Os96BIRkYG9957L+fOnSM/P58XXniBqVOnEhYWxlNPPUV6ejq2trasXbsWe3t7OnfuTHJyMn///Tft2rWrVEyi7vk7/iTq9XfJbgwdV66mZZvqK6pUVQ2m1sfw4cOJj4+nR48ezJs3j59//rnY9vT0dMaNG8f06dNLJOndu3dz8uRJfvvtNyIiIggLC2Pfvn0ArFmzhrCwMEJDQ1m9ejXJyclAYXLo378/kZGR3HnnnWRkZODl5UVkZCSDBw/m448/LhHjgQMH8PAoPE/r7u6Ov78/U6dOJSIiAp3un9q2AQEBdOvWjYiIiFKTdGkiIiLYtGkTUVFRbNq0ifj4eAICAvSlXzds2MDx48fZtGkTBw4cICIiAnNzczZs2FCiPy1btuSll14iKCiIyMhIVq1aBcD8+fNZsGABv//+O1u2bOHhhx/WH//o0aMEBQVx6NAh/P39SUxMJCAggEGDBhEREcGCBQuIiYkptlTajY+UlBT9a/n6+uLu7k7//v3LfQ+K/Pjjj7Rv357IyEiOHTvGyJEjyc3N5YknnmDz5s2EhYXxr3/9i6VLl+r38fDw4MCBAwb9bEXdl5OdxeX1szHvm0HG/Fk49rvb2CEVY5wRdTkj38waumzLysqKsLAw9u/fT3BwMFOnTiUgIIDZs2cDcM8997Bo0SJmzJhRYt/du3eze/du+vTpAxQm9ZMnTzJ48GBWr16tX4AgPj6ekydP0rp1a8zNzZk0aZL+NRo3bszYsWMB8PT0ZM+ePSWOk5iYSJs2baq76wAMHTqUFi1aAODk5MSZM2fo1KlTsTY//fQTYWFh9OvXDyj8hNG2bVuAYv0JCgpiypQp+k8lrVq1AmDv3r1ER/9znvnq1av6Wir33HMPOp0OnU6Hr68vYWFh2NvbFzt+z549DaoXHhwcXOwTUVnvQREXFxeefvppnn32WcaOHcugQYM4duwYx44dY9iwYUDhdd03xtO2bVvOnz9fYSyi7svPy2P3KxMYqx0jdNRKvMc8UvFOtaxBFWUyNzfHx8cHHx8fXFxcWLdunT5Re3t78+OPP3LfffehaVqx/ZRSLFmyhEcffbTY8yEhIezdu5dDhw7RtGlTfHx8yMrKAqBJkybFbuiwsLDQv665uTl5eXncTKfTVepmCkMUTfmUd3ylFLNmzeLVV18tse3m/pSmoKCAw4cP06RJkxLbbv6Z3vw9QExMDFOnTi31tUNCQrCxsSn1+bLegyI9evTgyJEjfP/99zz//PMMHTqUCRMm4OzszKFDh0o9XlZWVrFPMaL++nrBaFz2xrNt2jAmmGCShgY09RETE8PJkyf130dERNC5c2f99/7+/rRs2ZLHHnusxL4jRoxgzZo1+tFhQkICFy9eJDU1lZYtW9K0aVNOnDjB4cOHqxSjo6Mjp06dqrBdddbOtrCwIDc3FygcdW/evJmLFy8CcPnyZc6cOVNinyFDhvD111/rpxguX74MFE4vvfPOO/p2N46Od+zYQVZWFsnJyYSEhODh4VGiH0Uj6tIepSVpwKD34Pz58zRt2pT777+fhQsXcuTIEXr27ElSUpI+Uefm5vLHH3/o9/nzzz/p3bu3IT9CUYfteOMJXPbGc7JbI8Yu2WDscMrUYBJ1eno6s2bNwsnJCVdXV6Kjo1m+fHmxNqtWrSIzM5NFixYVe3748OHcd999DBgwABcXFyZPnkxaWhojR44kLy8PR0dHFi9ejJeXV5ViHDx4MOHh4agK7hZt3bo13t7e9O7dm4ULF1bpmHPmzMHV1ZUZM2bg5OTESy+9xPDhw3F1dWXYsGEkJiaW2MfZ2ZmlS5dy11134ebmxlNPPQUUTkGEhobi6uqKk5MTH3zwgX4fV1dXfH198fLy4oUXXsDe3r5aaoAb8h5ERUVxxx134O7uzooVK3j++edp3Lgxmzdv5tlnn8XNza3YpX65ubmcOnWKvn1LvUlM1BMHv/uMjuv28rctDPxwOxaNLSveyVjKuhykKg9TvDzPlN3Y5yeffFLt2bPHiNFUv2XLlqnAwMBiz5ny+7x161b1/PPPl7pNLs8znCn3OeGvaPVz/17qcJ9eKmL/jmp73Zq6PK/BjKjriueee45r164ZO4wGLS8vj6efftrYYYgakpuTTfKXc8jolU3KY1Nxu3O8sUOqUIM6mVgX2NnZMX684b84UVFRzJw5s9hzlpaW+rsuTcHNU0ymbsqUKcYOQdSgn99+gLtzjpLl9zL9/B43djgGkURdx7m4uBh0SZsQAjYuGM3tQaf5bupIxtSRJA0N6GSiEKJh2/nuM/T+8TQJ7c25e8Fnxg7nlkiiFkLUe7/v/pJ2n3xHUivo98FmLHV1azVBSdRCiHot4XQ0Gcv9KdCgub8/9p17GTukW9agErW5uXmx+hFxcXEMHDgQqLjkZmJiov4WcFMye/ZsNm/eXOL5F198kb1795a7b0hISLllQmva2rVri92mPW3atGI3JQlRVXm5OSRueJw0u3yS5vjhObRunihuUIm6qABR0cPBwUGfqCpK1G+++WaJYk2mzN/fn7vvLr+wTGUSdWm3nlfWzYn63//+N6+//nq1vb4QBz94lL55YdjNmMuYf5csjVBXNKhEXZqixQEWL17M/v37cXd3L/UuuS1btjBy5EigMMH4+fkxbNgwHBwcePfdd3nzzTfp06cPXl5e+luqP/74Y/r164ebmxuTJk3SXx89e/ZsnnzySQYOHEjXrl3Zvn07UJg4bxy1P/7446xduxYoTLz9+vWjd+/ezJkzp8K7F28caTs4OLBs2TI8PDxwcXHhxIkTxMXF8cEHH/DWW2/h7u7O/v37SUpKYtKkSfTr149+/frpq8ctX76cmTNn4u3tzcyZM7lw4QITJkzAzc0NNzc3fbL/3//+p78D8NFHHyU/P1//M16wYAHOzs4MHTqUpKQktm/fTmhoKDNmzMDd3Z3MzEwGDRrE3r17q/WPgWi4Ni3ygy8OsafpKO6Y/JSxw6kSo12e9+CPD5Z4boTDCMZ0GENmXibz9s4rsf2e7vfg192PK1lXeCqk+A/+s5EVn8Utqr0M0KVLF33FNSgsHbpy5Up27txZYr/Tp0/TsmXLYoWNjh07Rnh4OFlZWXTv3p3XXnuN8PBwFixYwPr16/nPf/5TrK71888/z6effsoTTzwBFE6l/PLLL5w4cYKxY8eWuBb6Zo8//jgvvvgiADNnzmTnzp2MGzeuwj4XsbW15ciRI7z//vusXLmSTz75hLlz52JlZcUzzzwDwH333ceCBQu48847OXv2LCNGjOD48eMAREdH88svv6DT6Zg6dSp33XUX27ZtIz8/n/T09GIlUi0sLJg3bx4bNmzggQceICMjg759+/LWW2/h7+/PihUrePXVV/n0009ZuXJlsVu1u3fvTmRkJJ6engb3TYgi28MTCNwVQ59zG3g0KIYzHc0Z+thHxg6ryhrUddRFUx+3qrTyo76+vlhbW2NtbU2LFi30SdPFxYWjR48Chcn8+eefJyUlhfT0dEaMGKHf38/PDzMzM5ycnEhKSqowhuDgYF5//XWuXbvG5cuXcXZ2vqVEPXHiRKCwxOrWraUvL1RemdLx48frq8kFBQWxfv16oHDev0WLFnz++edllkg1MzPTV8W7//779bGUpqi8qCRqcau2hyewZGsU3a/9zgMHDnK5BQR6PEnen2n49Wlu7PCqxGiJuqwRcFpaGrpGunJHyC2btDRoBF1ddDpdidKZN46uzczM9N+bmZnpP7rPnj2b7du34+bmxtq1awkJCSl1/6JpjEaNGlFQUKB/vuiYWVlZzJs3j9DQUDp16sTy5ctLxFORouOVVeIUyi9T2qxZs3JfX5VTIvVmpZU4LSLlRUVlBe6KoXnmWRYc/gKzAnjHaxJn6Ejgrhj8+pjOai2V0eDnqIuUVzq0R48exMXF3fJrpqWlYW9vT25urn6llPJ07tyZ6OhosrOzSUlJ4aeffgL+Sdi2trakp6eXepVHZdzc5/LKlN5o6NCh/N///R9QWHA/NTW13BKpBQUF+pi/+OIL7rzzzlKPD1JeVFReckoKARYfkddY8cWdnoRaDgDgfEqmkSOrOknU15VXcrNZs2Z069bNoFrRN/rvf/9L//798fb2pleviq/d7NSpE/feey+9e/fm3nvv1a8oY2NjwyOPPELv3r0ZMWKEfnqhqsaNG8e2bdv0JxPLK1N6o1WrVhEcHIyLiwuenp5ER0eXWyK1WbNm/Pbbb/Tu3ZugoCD9XPvs2bOZO3eu/mTihQsX0Ol0sk6huGUZaam8Y/42dzU+xXavSWy1nq7f1t6m7n9C0yq6eqAy+vbtq0JDQ4s9d/z4cRwdHSvcN62GluKqqm3bthEWFsZLL71U7a9tqn2uLlZWVvq57iKl9fmtt96iefPmPPTQQ7UZ3i0x9Pf4ZiEhIfj4+FR/QCastvqcm5PNt/fegS4zi4N9R/F5/jD9Np2FOa9OdKm1qY+q9FnTtDClVKlF0GVEbaAJEybg4OBg7DDqNRsbG2bNmmXsMEQdkp+Xx7ZZ3jieyCGlczs8Jy+kg40ODehgo6vVJF2TGtRVH1V146rawnA3j6bL8uCDJS/ZFKI8X8/1xS08g6OeVtz7/k+YN2pULxLzzWRELYSokzY9NQa3Xy4R7WTJxM9+wbxR/R13SqIWQtQ5oTs/wkULI9rZgtGf7zPt9Q6rgSRqIUSdEvzlStx+XwytuzPm84PomtXtm1kMIYlaCFFn7Pp0OS1f/pRvz7Wn47wdNGlqZeyQaoUkaiFEnbBvy7u0Xr2JVGtwefJDmtu0NnZItaZBJeqXX34ZZ2dnXF1dcXd31y8A6+DgwKVLl0q0L6qsV5u2b9+Ov78/AElJSfTv358+ffqwf/9+Ro8eTUpKCikpKbz//vvlvs758+eZPHlyhcd75ZVXqiXuyqiotOzN+vfvj7u7O7fddhtt2rQpVle8KqQOtukL++lrGr/yHjkW0CLgFW538zZ2SLVLKVXtD09PT3Wz6OjoEs+V5urVqwa1u1UHDx5UXl5eKisrSymlVFJSkkpISFBKKdW5c2eVlJRUYp9mzZpVy7Hz8vLK3X5jnwcMGKCP5csvv1QPPfRQifanT59Wzs7O1RJbZfpYUX8McfXqVRUcHKzGjBlzy/t+9tln6rHHHivxfG5ubqViCQkJUQ8//LBBbQ39Pb5ZcHBwpfary6qrz+dOH1chXr3Ub2691IEdH1XLa9aUqvQZCFVl5FSjjajPzHygxOPy9dFVQWZmqdtTthaWJc27cqXEtookJiZia2urL05ka2tL+/bti7XJzMxk1KhRfPzxxyX2DwwMpF+/fri6urJs2TL9835+fnh6euLs7MxHH/1TTtHKyoqnn34aNzc3Dh06hJWVFUuXLsXNzQ0vLy8uXLhQ4hh//vknlpaW2NraEhERwaJFi9ixY4f+Fuuikf/ixYuJjY3F3d2dhQsXltrfuLg4fc2MtWvXMnHiREaOHMntt9/OokWLgMIa3EWlX2fMmAGUX1P6xv6sX78eV1dX3Nzc9CVaK6pnPWDAAG6//Xb9z7eiGuCGuLlW9tq1a3n88X9Wlx47dqy+GNbu3bsZMGAAHh4eTJkyRX99t9TBNl2pVy6RvX4q+e6ZXPnPDAaOrzuLd1SnBjP1MXz4cOLj4+nRowfz5s3j559/LrY9PT2dcePGMX369BIruezevZuTJ0/y22+/ERERQVhYGPv27QNgzZo1hIWFERoayurVq0lOTgYgIyOD/v37ExkZyZ133klGRgZeXl5ERkYyePDgUv8YHDhwAA8PDwDc3d3x9/dn6tSpREREFKsoFxAQQLdu3YiIiCAwMNCg/kdERLBp0yaioqLYtGkT8fHxBAQE6Eu/btiwoVhN6YiICMzNzfXFpG7sT8uWLXnppZcICgoiMjKSVatWATB//nwWLFjA77//zpYtW4rdIHT06FGCgoI4dOgQ/v7+JCYmEhAQwKBBg4iIiGDBggXExMQUWyrtxkdKSkqZfYuOjmbv3r18+eWXZba5dOkSL730Env37uXIkSP07duXN998EyiseFhUB1uYjssX4jn00nA65sfTZvpbDJ/9vLFDMhqjXSHe+fP1pT6flpaGmU5X5naARi1blru9NFZWVoSFhbF//36Cg4OZOnUqAQEBzJ49G4B77rmHRYsW6UeWN9q9eze7d+/WF0lKT0/n5MmTDB48mNWrV+sXIIiPj+fkyZO0bt0ac3NzJk2apH+Nxo0b61dv8fT0ZM+ePSWOU1rd6+oydOhQWrRoAYCTkxNnzpyhU6dOxdr89NNPZdaUvrE/QUFBTJkyBVtbWwBatWoFlF/P+p577kGn06HT6fD19SUsLAx7e/tix+/Zs2el6oXfWCu7LIcPHyY6Ohpv78K5zZycHAYMGKDfLnWwTUtGWioHZo/itrP5/LLkGYYMnmDskIyq/t7KUwpzc3N8fHzw8fHBxcWFdevW6RO1t7c3P/74I/fdd1+JeslKKZYsWcKjjz5a7PmQkBD27t3LoUOHaNq0KT4+PvqSpE2aNMHc3Fzf1sLCQv+6ZdWE1ul0pKamVmeX9W6sf13W8VU5NaVv7k9pyqtnffPPtLSa1DExMfoFBm4WEhKCjY1NqdturJVdVk1vpRTDhg0rc9QtdbBNR25ONrtmDsbxdD6RY7sz7f7njB2S0TWYqY+YmJhiZ/YjIiLo3Lmz/nt/f39atmzJY489VmLfESNGsGbNGv3oMCEhgYsXL5KamkrLli1p2rQpJ06c4PDhw1WK0dHR0aBSquXVzr5VFhYW5ObmApRbU/pGQ4YM4euvv9ZP8xStEVlePesdO3aQlZVFcnIyISEheHh4lOhH0Yi6tEdZSfpmDg4OREREUFBQQHx8PL/99hsAXl5eHDhwQP/zzcjI4M8//9TvJ3WwTUN+Xh7bHigsshR5lx3TVn5r7JBMQoNJ1Onp6cyaNQsnJydcXV2Jjo5m+fLlxdqsWrWKzMxM/cm2IsOHD+e+++5jwIABuLi4MHnyZNLS0hg5ciR5eXk4OjqyePFivLy8qhTj4MGDCQ8Pr3Dh2tatW+Pt7U3v3r3LPJloqDlz5uDq6sqMGTPKrSl9I2dnZ5YuXcpdd92Fm5sbTz1VuH5lefWsXV1d8fX1xcvLixdeeAF7e/tya4BXlre3N126dMHJyYknn3xSP+ffpk0b1q5dy/Tp03F1dWXAgAGcOHECQOpgm5CtL07EJSKDo57WTHlvr7HDMR1lXQ5SlYcpXp5nym7s85NPPqn27NljxGiq37Jly1RgYGCx50zpfX7zzTfVJ598YlBbuTzPcLfa58NfvqLyX2yuvv7PIJVXyUstja3eXZ4nSvfcc89x7do1Y4fRoEgdbOPb7D+TtkfeIrLZQPxe31uvK+FVhkE/DU3T4oA0IB/IU2WsQiCqzs7OjvHjxxvcPioqSn8dcxFLS0v9XZem4OYpJlMjdbCNa/vKefTcGEpkt7aM/GozjSwaGzskk3Mrf7Z8lVIl77MWRuXi4lKpS9qEMAW7PlmGw9pg/raF/u9upomu/NXuGyqZ+hBCGMW+ze/S+p2vSLUGh3c+wb5zxQtAN1QGLW6radpp4AqggA+VUh+V0mYOMAfAzs7Oc+PGjcW2t2jRgu7du1d4rPz8/Aqv161vpM91x6lTpyp1rXt6erpRinwZU3l9zricQMGn/6X1RY2Euf+iTbd+tRxdzajK++zr61vm4raGJuoOSqkETdPaAnuAJ5RS+8pqXx9XIa9J0ue6Q1YhN1xZfb50/gzZHw+DvGskeL/KHSNnlty5jjLqKuRKqYTr/14EtgF3VCoSIzM3N8fd3R1nZ2fc3Nx44403it3FVppbLcUphCjb2ZOR7HtyFOY5qWRM+F+9StI1qcJErWlaM03TrIu+BoYDx2o6sJpQVIDojz/+YM+ePfzwww+sWLGi3H0kUQtRPS5fiCf60el0P64I6/Qvenj4GDukOsOQEbUd8IumaZHAb8B3SqkfazYs2B6egHdAEF0Wf4d3QBDbwxOq9fXbtm3LRx99xLvvvotSiri4OAYNGoSHhwceHh4cPHgQKFmKs6x2Qoiypade5sCskXRKVJycdgdj5pasJyPKVuHleUqpvwC3WohFb3t4Aku2RpGZW1gLOSElkyVbowDw69Oh2o7TtWtX8vPzuXjxIm3btmXPnj00adKEkydPMn36dEJDQwkICGDlypXs3LkTgGvXrpXaTghRutycbHY/4INjXAFHx/Vg6gvrjB1SnWOSt/8E7orRJ+kimbn5BO6KqdZEfaPc3Fwef/xxfR3mGwv2VKadEAJUQQHBb83EPiGXCJ92TA/cYeyQ6iSTTNTnUzJv6fnK+uuvvzA3N6dt27asWLECOzs7IiMjKSgoKLVUJ8Bbb71lUDshGqrt4QkE7ophWqc0olc8wjxtF0H3T2Dak2uMHVqdZZKJur2NjoRSknJ7m+qrF5yUlMTcuXN5/PHH0TSN1NRUOnbsiJmZGevWrdMvQXVzKc6y2gkhik9b6mLfpF3Keb7qOQiLQf9FM5P76yrLJH9yC0f0RGdR/GYInYU5C0f0rNLrFq0P6OzszN13383w4cP16x/OmzePdevW4ebmxokTJ/TF6G8uxVlWOyHEP9OWcy+txnv/RXIzLFmaM5uVe2SV96owyRF10Tx04K4Yzqdk0t5Gx8IRPas8P13e6Pf222/n6NGj+u9fe+01oLCwflBQULG2pbUTQhROTz5x4Q1GH0ok9jaNF3ovIddMV+3Tlg2NSSZqKEzWNXXiUAhRM5658BpDDiUR08WcuMnPkn7SBqjeacuGyCSnPoQQdYsqKODQZ8/Sp+lpjvVoxLMuyzBv0hyonmnLhq5WE7UhdUWEMFXy+1u6/Lw8vnl5KgPOfIBF94GYv7gT21atAehgo+PViS7y6biKam3qo0mTJiQnJ9O6detSV6AWwpQppUhOTpbLMW+Sm5PNtlneOEdk8M2UOxn75Bf0MzdnYt/OhISE8MQMH2OHWC/UWqLu2LEj586dIykpqdx2WVlZDe4/g/S5bmjSpAkdO3Y0dhgmIzvzGt/O9MblWBZH+1oz+cUdmNXB0rV1Qa0lagsLC7p06VJhu5CQEPr06VMLEZkO6bOoazLSUtk1czDOJ3KIHNiKKR/9LOsc1iA5mSiEuCXZWdf44bkROJ7IIcLHjmlrDkiSrmGSqIUQBsu6lk7M2+OZ2Oo4J2bdwfQPQowdUoMgiVoIYZCLCbHsurc/jZOOEeq6nAlLpApebZFELYSoUHzsMcLvH0e32AKirIZwx6QFxg6pQZFELYQo11/Rv3HiwSm0v6CIub8/U1bIike1TRK1EKJMf0bu58wjs2h7GWL/5cukpWuNHVKDJKdqhRCl+jv+FGZb53DNpoCM+8bj91igsUNqsCRRCyFKOBK8haZ7n6VDo3Tyln1OrzuGGTukBk0StRCimIPffQbLXufv1o0wf+1rerkPMnZIDZ4kaiGE3r7N72L5ynsAWD/6BLdLkjYJkqiFEADs/TwAmzfWkdMIzP67mEGjZhk7JHGdJGohBH8c/A6zj9aRaQlWAS/Rx3eSsUMSN5BELUQDF7VvB91+eoRM79Y08XuT3l6jjB2SuIkkaiEasO2BczE/HITO1Q6H/3yPbbtOxg5JlEJueBGigdri/wDdPvuZJpca0WTGF5KkTZiMqIVogL5aOgXnrceIt9dw+XQzHbo4GTskUQ5J1ELUU9vDEwjcFcP5lEza2+hYOKInfn06sHHheFy+PUlcJzP6r9+JrX3FC3oI45JELUQ9tD08gSVbo8jMzQcgISWTJVujUIfeo2t2GKe6t2TwZ7to2UYWna0LZI5aiHoocFeMPkkXeTDtAyZcfI9GnTwYtSVUknQdIolaiHrofErmP9+ofJ4/s4IxP8bw2WUXXP+zhcaWdWth4YZOErUQ9VB7G13hFyqfFX8txzs8jUinxnzSdimNLBobNzhxyyRRC1EPLRzRE2uzbF45+QJ3RGXyu4sOf8eXWTjG1dihiUqQk4lC1EO+nRuzIu1lHKNzONDHmk97v0TAaGf8+si8dF0kiVqIeib2j19pvHk2Y1td4Ic5U3n4qf/jYWMHJapEErUQ9cjOd5+h1brvsBicRfq9X3JP/xHGDklUA0nUQtQTm54ei/P3sSS1giZjAnGUJF1vSKIWoo7LzLjKtw8PwTU8g1NdzOn7wWbsO/cydliiGhmcqDVNMwdCgQSl1NiaC0kIYajUK5fYvWg4LuGZHPW0xu+TECx1TY0dlqhmt3J53nzgeE0FIoS4NWf/PErKO3cxul0cf9znwdQNv0mSrqcMStSapnUExgCf1Gw4QghDfPfes/z58FTystKIG/U/Jr+4wdghiRqkKaUqbqRpm4FXAWvgmdKmPjRNmwPMAbCzs/PcuHFjpQJKT0/HysqqUvvWVdLn+q86+xu3+RU8g+JJtoELsx/ArseAannd6tbQ3mOoWp99fX3DlFJ9S92olCr3AYwF3r/+tQ+ws6J9PD09VWUFBwdXet+6Svpc/1VHf7OuZahN9/VV0T17qW+HO6lzf/1R9cBqUEN7j5WqWp+BUFVGTjXkZKI3MF7TtNFAE6C5pmn/U0rdX6k/G0KIW3Y1JZldjw/FJSybKA8rxn38E7pmzY0dlqglFc5RK6WWKKU6KqUcgGlAkCRpIWpPwl/Hubz6LgbdlsBRP0fu/eJ3SdINjFxHLYQJ+/6D5yj4div9Pa5yYcwapnqPM3ZIwghuKVErpUKAkBqJRAhRzKZFfjjtjCHZRuPcsPfpI0m6wZIRtRAmJjvzGtsf8cE1NI3Y28xw+79NdOrW29hhCSOSRC2ECUlLvcyuh31wjcolyr0Z4z4NkvloIYlaCFNxPi6G7PVTcO58kaO39WXqGzuNHZIwEbLCixA1aHt4At4BQUQlpOIdEMT28IRS2/348Qv8vmQ8LfMvkTf+Q0nSohgZUQtRQ7aHJ7Bka1ThauCdICElkyVbowCKrbTy1ZJJOO6I5nILM84/tQ6XfsOMFbIwUTKiFqKGBO6KKUzSN8jMzSdwVwxQeNJw08z+uGyL5mxHM7qs34iTJGlRChlRC1FDzqdklvl8+tUr7J45GNeYPI656Rj9STDNrFvUcoSirpARtRA1pL2NrtTnXa1Tufi2D207pBA5sjNTNh2RJC3KJYlaiBqycERPdBbmxZ4bk/kNc+OWYVtwkRZTVzHt7R+NFJ2oS2TqQ4gaUnTCsHBOOo15V95j5C+nudyiERee2IaLq5dxAxR1hiRqIWqQX58OjHG25at/DcIjNI3THc1wemcdDo6llx0WojSSqIWoQefPxHBkzkQ8zhTwh0sTRq0JkflocctkjlqIGnLkx7U0+8wXzS6bX+/uxIQvf5ckLSpFRtRCVLOLCbHsmz+Z29pf5GLb9ri+8CmxCVcwbyT/3UTlyIhaiGq09/MATkwai+OxLP7K7obDogN0ut3N2GGJOk7+xAtRDbIzr7F1/ih6/3KRq80gbr4f0/79qrHDEvWEJGohqijxTAy/Bk7DfV8WJ3pa4Lnyc7xlFC2qkUx9CFEFe9f70+wzH4a0SuT47IGM33KE2yRJi2omI2ohKiHxzAkOLpiGw6lsjo3vQOd/fc7Ero7GDkvUU5KohbhFu9asoOmHG+l1FaIGtuaeJd/LKiyiRkmiFsJAOdlZbJ13Ny4Hk7liDeeemcq0h5YbOyzRAEiiFsIACX8dJ+2LB7G6nMyJXk0Z8NZG2jvIVIeoHZKohShHfl4eW5ZNp0fWYbpa55E66wX6+80zdliigZFELUQZ4mOPEfrUfbjE5HLcqQV2b22hf+eexg5LNECSqIUoxfcfPEeLNdvong4Rg9sycdUPWOqaGjss0UBJohbiBrk52ezwn4Lj5pMk28CFxTOZ/sBzxg5LNHCSqIW47vSJMHI3z2W89ifbBvTE96Uvaduhm7HDEkIStRD5eXlsfm4ydr/E0NX3KsfufJupox40dlhC6EmiFg3amRNhhD8zG9dTeZzuZEa631o8+g0zdlhCFCOJWjRYO999hlZrv6PbNYgcYs+kt3/AorGlscMSogRJ1KLBycnO4shnT2H+7U/kNDYj6emHmDb9GWOHJUSZJFGLBuXgd59hfnAVXhanCbp7BL3vfw1b+y7GDkuIckmiFg1CduY1ti6eiONPZzjXWRE+/z2GDL/f2GEJYRBJ1KLe+/6D57DcsA33JIjtbEZ3/3fo5TnE2GEJYTBJ1KLeunAuln2vzaT3nitcbg5bh/TiY+sH6bAHFpol4Neng7FDFMIgkqhFvZOSnMih9S9yV8oOfJrDDwNv5x27f5OkWgKQkJLJkq1RAJKsRZ0gS3GJeiM/L49trz1K1Ogh6Dbv53hTT3If3seHPf6rT9JFMnPzCdwVY6RIhbg1MqIW9cLhH9aRtOp1esUV8HcrSL93JD7z3wbgfEpsqfucT8msxQiFqLwKE7WmaU2AfYDl9fablVLLajowIQyRfvUKe958kO5fxWDRCCLv7si4VzfTzLqFvk17Gx0JpSTl9ja62gxViEozZOojGxiilHID3IGRmqZ51WhUQlQgNyebXR8/R9ab7owtCCa6rxVW6z9k2rt7iiVpgIUjeqKzMC/2nM7CnIUjpLa0qBsqHFErpRSQfv1bi+sPVZNBCVGeoC9WkvvxGmxSFfHjbLnst46pHj5lti86YRi4K4bzKZm0t9GxcERPOZEo6gyD5qg1TTMHwoDuwHtKqV9rNCohShEbdZBw/8dwjMoivSnEDe/FxKUbDarP4dengyRmUWdphQNmAxtrmg2wDXhCKXXspm1zgDkAdnZ2nhs3bqxUQOnp6VhZWVVq37pK+ly+gvw8Lv66ge6bDmOZC8dcm2I1eQHWth1rOMrqI+9xw1CVPvv6+oYppfqWulEpdUsP4EXgmfLaeHp6qsoKDg6u9L51lfS5bD9veUf9tcJFqWXN1Vf3u6oDOz6q2cBqiLzHDUNV+gyEqjJyqiFXfbQBcpVSKZqm6YBhwGuV+pMhhIGOHviW2NeW0jU2l8vj8rni+y6TX5yBZiaX/ouGx5A5antg3fV5ajPgK6XUzpoNSzRUKcmJ/PjsvfQ6fImuwPEBtox4eiMt28j8smi4KhyeKKWOKqX6KKVclVK9lVL+tRGYqJ+2hyfgHRBEVEIq3gFBbA9PAEAVFPDrzk+IHDsEt18uEdelEer/Apj2yX5J0qLBkzsTRa3ZHp7Akq1RZObmQ6d/am6kRO/BI349/bPC2NazI2l9R+H3+EpjhyuEyZBELWpN4K6YwiR9XZv8v3ns9Pt4brlG+vBrHO6/iHFLF9LIorERoxTC9EiiFrWmqLaGmcqh8YH/453D8Vhfg0jHxtzxr0/p7jrQyBEKYZokUYtaY9/ckh7pvzIxfAO3n1actdf45E5fjrefxH2SpIUokyRqUeMy0lL54Y15rFGR9Gocz7f2duzr2pXXrB7FsrGOV6XmhhDlkkQtasylxNPsfXUuHQ+fxfkqnB5mRpTbUt5p7MqUztnYx1tLzQ0hDCCJWlS7xDMn+dn/QboeScYtE8500EiaNIixC1Zj0diSKUBISAhPzPAxdqhC1AmSqEW1if3jVy4Ff4jThW+xj25Non0jrkycxMiHVxg7NCHqNEnUospCvn6Hyxs+of3ZHHqOvshx2+HYvTOHu/r6Gjs0IeoFSdSiUvLz8vjhwyXwzfd0O1NA88Zw0tUa26mfcoeLXMEhRHWSRC1uSX5eHpF7PiclaDXdvs0itSlE3mWH98J38OjuYuzwhKiXJFELg6QkJ7LrlTk0vniKCd3Oc87KnkNTXBn2n1V4tbY3dnhC1GuSqEW54mOPceD1x3H4/QKu1wqv4Aid+iZ9Rs5iSiP59RGiNsj/NFGqiwmnCXlrLt13n8UtB2I7m3Fp3GhGzX0Vc0nQQtQq+R8nijm081OuhG3l7oJDeGgWHO1iR6v7/sXYqf8xdmhCNFiSqAUAu9asIGvz1/T4K5/k7gWEj/Sj05hFTOzSy9ihCdHgSaJuwAry8/l21XwsdwbR+bwivQlEDmxNvwWv000usRPCZEiiboBORh7gwrFgOsZuotGJa1inNyZy+G3cveQD+tl3MXZ4QoibSKJuIM7GHOHQJyuwijyFQ3wB2pB08tu1xmbCY7iPfAhv6xbGDlEIUQZJ1PXY1ZRkwr//kKvrN+BwtgDXAkiygSivlnQZu5iuI2bSTVb1FsLkSaKuZy4mxBLywVK4eAq/dqcZRB678toT3bc5bUbdy11T5vNt1AWe2hXD+Z9/oL2NTkqNCmHiJFHXA5cvxBP04VIa/RZOl7g8XPLgfBsIc5tIqzumM3KZD9r1kXOxBWb5Z4FZQJK1ECZKEnUdlZKcyF+/70H9sY2EQ3/gfMyc1KYQ07sZzYeOYuis57FobFliv5sXmAXIzM0ncFeMJGohTJQk6jokPfUyez9aSv7BgzjE5tD47hQ6Njfnb9c+xPr2Yti/VuCla1ruaxQtMGvo80II45NEbeLycnP47YfPOL/uAxxis+iZBRmWcPp2S1q4PUav6QsZU8rIuSztbXQklJKU29voqjNsIUQ1kkRtgrIzr7H3sxVkxoUxpGkMnvlXUWfbc6ZLY8wHDODuR1+hb4tWlXrthSN6FpujBtBZmLNQFpgVwmRJojYRuTnZ/LTuJa7+9AO3ncygawYktFWcvscTrfck3J8dTzOrql/rXDQPHbgrhvMpmXLVhxB1gCRqI0pPvUz8iVByf1vH96vm0uO4Rk4jOO3QiHN93fB59L/Y1sCdgn59OkhiFqIOkURdS/Lz8jh64FtOBX2NOnWSFuczaHdR0XxMMnfp8tjV3ZFjzh0ZNOcl3G673djhCiFMiCTqGpJ45gRh33xMo4J02mWf4dKZU3T4yYLeQHYj+NtO4w83K6LMhmLvMJBNF9qxcERP2t0mI10hRHGSqKtBfl4eMWHBRH39Duanz9L672zaJkM34KxXFq266rjS0YnI0fm07TeE/mMfJu5UOv+9flLv6cZ5cuOJEKJMkqgr4fjve4ne/QV5MdE00mUxqt15OhfkUPCdPdeawIV25lxwbInOuQ8e4x6hU3cXbrvpNQJ3hcmNJ0IIg5hMot4enkDgrhimdUpjaUBQrV2JUHTcsq6ASEtN5tyJUFJPHuTc9u3Yn8mhVRo4AXlmcNLZjCiXsZjfdgfmQ9vieed4g5aqkhtPhBCGMolEXaz+RKfaqz9xc92LxCupfP2/90he/wfNz8fTMjETDcXQIYmF7fPbc7G9BfG3taOV5yDuGPcwLpVcgVtuPBFCGMokEnVt1Z9IvXyB038c5mJsFBl/nyXu1Gn+k5mGZef2dDW/SMqxJG4/Xli8KLMxJLYzI61DC8IHvkAn18H4tetUbbHIjSdCCEOZRKKuyjRARloqqZf/JuPKRc7+cYDko7+Sf+Uy5mkZWGTk0CQjD3svRVeLFA7G6nD43ZKidFu0GqDFbQlkay2J6diO460sCbfuw+ev++NxC7dm36obbzyBNDrIjSdCiDKYRKK+eRqgkcqhU94ZHBsl8M3bu7Fq2ZqmWi4X4/4g70gsltfyaJpRQLNrYJ0JuaNTcG1+jXPnbXDZV1iU6FpjSG8G15pqJFl0ILvNQHJ1uRy1v4plm3ZYt+/KxycaEZndgUxlBTlAs8JHBxtdqZXnqlvRjSchISE8McOnxo8nhKibTCJRLxzRk8VbInn72iJs3shnRyaYqX+2Jw9Jx6vtVQ5faUFuYjOuNdVIbdmISx0tyLdqRsseY8nv6kYLiyZkzTDHwekOWrapeGSaFp5A5NYokOkHIYQJM4lEXfRxP+XLdqQ6JJHepAlmNi1obm9Ps3a30bmPDxk9PfGytqmR40rdCyGEKaswUWua1glYD9gBCvhIKbWqugPx69MB+uwlJCSEqT4+1f3y5R5XErMQwpQZMqLOA55WSh3RNM0aCNM0bY9SKrqGYxNCCAFUuAS1UipRKXXk+tdpwHFAhqBCCFFLNKVUxa2KGmuaA7AP6K2UunrTtjnAHAA7OzvPjRs3Viqg9PR0rKysKrVvXSV9rv8aWn9B+nyrfH19w5RSfUvdqJQy6AFYAWHAxIraenp6qsoKDg6u9L51lfS5/mto/VVK+nyrgFBVRk6tcOoDQNM0C2ALsEEptbVSfy6EEEJUSoWJWtM0DfgUOK6UerPmQxJCCHEjQ0bU3sBMYIimaRHXH6NrOC4hhBDXVXh5nlLqF0CrhViEEEKU4pau+jD4RTUtCThTyd1tgUvVGE5dIH2u/xpaf0H6fKs6K6XalLahRhJ1VWiaFqrKukSlnpI+138Nrb8gfa5OBl31IYQQwngkUQshhIkzxUT9kbEDMALpc/3X0PoL0udqY3Jz1EIIIYozxRG1EEKIG0iiFkIIE2e0RK1p2khN02I0TTuladriUrZbapq26fr2X69X7quzDOjvU5qmRWuadlTTtJ80TetsjDirU0V9vqHdJE3TlKZpdf5SLkP6rGnavdff6z80TfuitmOsbgb8bt+maVqwpmnh13+/6/SdzZqmrdE07aKmacfK2K5pmrb6+s/jqKZpHlU+aFnVmmryAZgDsUBXoDEQCTjd1GYe8MH1r6cBm4wRay321xdoev3rf9fl/hra5+vtrCksnXsY6GvsuGvhfb4dCAdaXv++rbHjroU+fwT8+/rXTkCcseOuYp8HAx7AsTK2jwZ+oPCObi/g16oe01gj6juAU0qpv5RSOcBG4J6b2twDrLv+9WZg6PUCUXVRhf1VSgUrpa5d//Yw0LGWY6xuhrzHAP8FXgOyajO4GmJInx8B3lNKXQFQSl2s5RirmyF9VkDz61+3AM7XYnzVTim1D7hcTpN7gPWq0GHARtM0+6oc01iJugMQf8P35yi5aoy+jVIqD0gFWtdKdNXPkP7e6CEK/yLXZRX2+fpHwk5Kqe9qM7AaZMj73APooWnaAU3TDmuaNrLWoqsZhvR5OXC/pmnngO+BJ2onNKO51f/vFTKJVcjFPzRNux/oC9xl7FhqkqZpZsCbwGwjh1LbGlE4/eFD4aemfZqmuSilUowZVA2bDqxVSr2hadoA4HNN03orpQqMHVhdYawRdQLQ6YbvO15/rtQ2mqY1ovAjU3KtRFf9DOkvmqbdDSwFxiulsmsptppSUZ+tgd5AiKZpcRTO5X1Tx08oGvI+nwO+UUrlKqVOA39SmLjrKkP6/BDwFYBS6hDQhMLiRfWVQf/fb4WxEvXvwO2apnXRNK0xhScLv7mpzTfArOtfTwaC1PWZ+jqowv5qmtYH+JDCJF3X5y2hgj4rpVKVUrZKKQellAOF8/LjlVKhxgm3Whjye72dwtE0mqbZUjgV8lctxljdDOnzWWAogKZpjhQm6qRajbJ2fQM8cP3qDy8gVSmVWKVXNOKZ09EUjiZigaXXn/On8D8rFL6ZXwOngN+ArsY+21vD/d0LXAAirj++MXbMNd3nm9qGUMev+jDwfdYonPKJBqKAacaOuRb67AQcoPCKkAhguLFjrmJ/vwQSgVwKPyE9BMwF5t7wHr93/ecRVR2/13ILuRBCmDi5M1EIIUycJGohhDBxkqiFEMLESaIWQggTJ4laCCFMnCRqIYQwcZKohRDCxP0/5zUzMkNVbe8AAAAASUVORK5CYII=\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter3_107_1.png" - }, - "needs_background": "light" - }, - "output_type": "display_data" - } - ], - "source": [ - "import numpy as np\n", - "import matplotlib.pyplot as plt\n", - "\n", - "from sklearn.linear_model import LinearRegression\n", - "\n", - "\n", - "np.random.seed(2021)\n", - "\n", - "def MSE(y_data,y_model):\n", - " n = np.size(y_model)\n", - " return np.sum((y_data-y_model)**2)/n\n", - "\n", - "\n", - "def fit_beta(X, y):\n", - " return np.linalg.pinv(X.T @ X) @ X.T @ y\n", - "\n", - "\n", - "true_beta = [2, 0.5, 3.7]\n", - "\n", - "x = np.linspace(0, 1, 11)\n", - "y = np.sum(\n", - " np.asarray([x ** p * b for p, b in enumerate(true_beta)]), axis=0\n", - ") + 0.1 * np.random.normal(size=len(x))\n", - "\n", - "degree = 3\n", - "X = np.zeros((len(x), degree))\n", - "\n", - "# Include the intercept in the design matrix\n", - "for p in range(degree):\n", - " X[:, p] = x ** p\n", - "\n", - "beta = fit_beta(X, y)\n", - "\n", - "# Intercept is included in the design matrix\n", - "skl = LinearRegression(fit_intercept=False).fit(X, y)\n", - "\n", - "print(f\"True beta: {true_beta}\")\n", - "print(f\"Fitted beta: {beta}\")\n", - "print(f\"Sklearn fitted beta: {skl.coef_}\")\n", - "ypredictOwn = X @ beta\n", - "ypredictSKL = skl.predict(X)\n", - "print(f\"MSE with intercept column\")\n", - "print(MSE(y,ypredictOwn))\n", - "print(f\"MSE with intercept column from SKL\")\n", - "print(MSE(y,ypredictSKL))\n", - "\n", - "\n", - "plt.figure()\n", - "plt.scatter(x, y, label=\"Data\")\n", - "plt.plot(x, X @ beta, label=\"Fit\")\n", - "plt.plot(x, skl.predict(X), label=\"Sklearn (fit_intercept=False)\")\n", - "\n", - "\n", - "# Do not include the intercept in the design matrix\n", - "X = np.zeros((len(x), degree - 1))\n", - "\n", - "for p in range(degree - 1):\n", - " X[:, p] = x ** (p + 1)\n", - "\n", - "# Intercept is not included in the design matrix\n", - "skl = LinearRegression(fit_intercept=True).fit(X, y)\n", - "\n", - "# Use centered values for X and y when computing coefficients\n", - "y_offset = np.average(y, axis=0)\n", - "X_offset = np.average(X, axis=0)\n", - "\n", - "beta = fit_beta(X - X_offset, y - y_offset)\n", - "intercept = np.mean(y_offset - X_offset @ beta)\n", - "\n", - "print(f\"Manual intercept: {intercept}\")\n", - "print(f\"Fitted beta (wiothout intercept): {beta}\")\n", - "print(f\"Sklearn intercept: {skl.intercept_}\")\n", - "print(f\"Sklearn fitted beta (without intercept): {skl.coef_}\")\n", - "ypredictOwn = X @ beta\n", - "ypredictSKL = skl.predict(X)\n", - "print(f\"MSE with Manual intercept\")\n", - "print(MSE(y,ypredictOwn+intercept))\n", - "print(f\"MSE with Sklearn intercept\")\n", - "print(MSE(y,ypredictSKL))\n", - "\n", - "plt.plot(x, X @ beta + intercept, \"--\", label=\"Fit (manual intercept)\")\n", - "plt.plot(x, skl.predict(X), \"--\", label=\"Sklearn (fit_intercept=True)\")\n", - "plt.grid()\n", - "plt.legend()\n", - "\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The intercept is the value of our output/target variable\n", - "when all our features are zero and our function crosses the $y$-axis (for a one-dimensional case). \n", - "\n", - "Printing the MSE, we see first that both methods give the same MSE, as\n", - "they should. However, when we move to for example Ridge regression,\n", - "the way we treat the intercept may give a larger or smaller MSE,\n", - "meaning that the MSE can be penalized by the value of the\n", - "intercept. Not including the intercept in the fit, means that the\n", - "regularization term does not include $\\beta_0$. For different values\n", - "of $\\lambda$, this may lead to differeing MSE values. \n", - "\n", - "To remind the reader, the regularization term, with the intercept in Ridge regression, is given by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\lambda \\vert\\vert \\boldsymbol{\\beta} \\vert\\vert_2^2 = \\lambda \\sum_{j=0}^{p-1}\\beta_j^2,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "but when we take out the intercept, this equation becomes" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\lambda \\vert\\vert \\boldsymbol{\\beta} \\vert\\vert_2^2 = \\lambda \\sum_{j=1}^{p-1}\\beta_j^2.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "For Lasso regression we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\lambda \\vert\\vert \\boldsymbol{\\beta} \\vert\\vert_1 = \\lambda \\sum_{j=1}^{p-1}\\vert\\beta_j\\vert.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "It means that, when scaling the design matrix and the outputs/targets,\n", - "by subtracting the mean values, we have an optimization problem which\n", - "is not penalized by the intercept. The MSE value can then be smaller\n", - "since it focuses only on the remaining quantities. If we however bring\n", - "back the intercept, we will get a MSE which then contains the\n", - "intercept.\n", - "\n", - "\n", - "Armed with this wisdom, we attempt first to simply set the intercept equal to **False** in our implementation of Ridge regression for our well-known vanilla data set." - ] - }, - { - "cell_type": "code", - "execution_count": 12, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Beta values for own Ridge implementation\n", - "[ 1.03032441e+00 6.28336218e-02 -6.24175744e-01 5.21169159e-02\n", - " 2.80847477e-01 2.12552073e-01 8.13220609e-02 -1.69634577e-02\n", - " -6.50846112e-02 -7.38962192e-02 -5.94226022e-02 -3.50227564e-02\n", - " -9.80609614e-03 1.08299273e-02 2.41882037e-02 2.93492130e-02\n", - " 2.64742912e-02 1.63249532e-02 -5.01831250e-05 -2.15098090e-02]\n", - "Beta values for Scikit-Learn Ridge implementation\n", - "[ 1.03032441e+00 6.28336218e-02 -6.24175744e-01 5.21169159e-02\n", - " 2.80847477e-01 2.12552073e-01 8.13220608e-02 -1.69634577e-02\n", - " -6.50846112e-02 -7.38962192e-02 -5.94226022e-02 -3.50227564e-02\n", - " -9.80609615e-03 1.08299273e-02 2.41882037e-02 2.93492130e-02\n", - " 2.64742912e-02 1.63249532e-02 -5.01831152e-05 -2.15098090e-02]\n", - "MSE values for own Ridge implementation\n", - "4.3632959273186007e-07\n", - "MSE values for Scikit-Learn Ridge implementation\n", - "4.363295916523824e-07\n", - "Beta values for own Ridge implementation\n", - "[ 1.03630548 -0.01963611 -0.37900111 -0.07062318 0.12182967 0.16343471\n", - " 0.13003291 0.07490892 0.02365049 -0.01449782 -0.03814292 -0.04909093\n", - " -0.05009826 -0.04389027 -0.03279636 -0.01866537 -0.00289724 0.01348565\n", - " 0.02976145 0.04543942]\n", - "Beta values for Scikit-Learn Ridge implementation\n", - "[ 1.03630548 -0.01963611 -0.37900111 -0.07062318 0.12182967 0.16343471\n", - " 0.13003291 0.07490892 0.02365049 -0.01449782 -0.03814292 -0.04909093\n", - " -0.05009826 -0.04389027 -0.03279636 -0.01866537 -0.00289724 0.01348565\n", - " 0.02976145 0.04543942]\n", - "MSE values for own Ridge implementation\n", - "5.194042826640948e-06\n", - "MSE values for Scikit-Learn Ridge implementation\n", - "5.194042826840599e-06\n", - "Beta values for own Ridge implementation\n", - "[ 1.04220758 -0.10931453 -0.17641709 -0.06020587 0.02208512 0.05789007\n", - " 0.06491736 0.05785343 0.04537385 0.03196357 0.01969145 0.00934499\n", - " 0.00107405 -0.00526348 -0.00992331 -0.01318643 -0.01531845 -0.01655318\n", - " -0.01708852 -0.01708781]\n", - "Beta values for Scikit-Learn Ridge implementation\n", - "[ 1.04220758 -0.10931453 -0.17641709 -0.06020587 0.02208512 0.05789007\n", - " 0.06491736 0.05785343 0.04537385 0.03196357 0.01969145 0.00934499\n", - " 0.00107405 -0.00526348 -0.00992331 -0.01318643 -0.01531845 -0.01655318\n", - " -0.01708852 -0.01708781]\n", - "MSE values for own Ridge implementation\n", - "2.094082198961287e-05\n", - "MSE values for Scikit-Learn Ridge implementation\n", - "2.0940821989631478e-05\n", - "Beta values for own Ridge implementation\n", - "[ 1.01219292 -0.06043581 -0.10391807 -0.05651951 -0.01898855 0.00312361\n", - " 0.01463049 0.01975848 0.02123176 0.02068067 0.01905883 0.01691985\n", - " 0.01458337 0.01223198 0.00996754 0.00784393 0.00588657 0.00410387\n", - " 0.00249435 0.00105081]\n", - "Beta values for Scikit-Learn Ridge implementation\n", - "[ 1.01219292 -0.06043581 -0.10391807 -0.05651951 -0.01898855 0.00312361\n", - " 0.01463049 0.01975848 0.02123176 0.02068067 0.01905883 0.01691985\n", - " 0.01458337 0.01223198 0.00996754 0.00784393 0.00588657 0.00410387\n", - " 0.00249435 0.00105081]\n", - "MSE values for own Ridge implementation\n", - "0.00031535148309579146\n", - "MSE values for Scikit-Learn Ridge implementation\n", - "0.00031535148309581185\n", - "Beta values for own Ridge implementation\n", - "[ 8.38916861e-01 1.31276579e-01 8.97497404e-03 -1.72271878e-02\n", - " -2.11744554e-02 -1.91492986e-02 -1.57201944e-02 -1.23002365e-02\n", - " -9.30466214e-03 -6.81048318e-03 -4.78184120e-03 -3.15130074e-03\n", - " -1.84923989e-03 -8.13661243e-04 7.46984697e-06 6.56636616e-04\n", - " 1.16805821e-03 1.56912044e-03 1.88168312e-03 2.12318726e-03]\n", - "Beta values for Scikit-Learn Ridge implementation\n", - "[ 8.38916861e-01 1.31276579e-01 8.97497404e-03 -1.72271878e-02\n", - " -2.11744554e-02 -1.91492986e-02 -1.57201944e-02 -1.23002365e-02\n", - " -9.30466214e-03 -6.81048318e-03 -4.78184120e-03 -3.15130074e-03\n", - " -1.84923989e-03 -8.13661243e-04 7.46984697e-06 6.56636616e-04\n", - " 1.16805821e-03 1.56912044e-03 1.88168312e-03 2.12318726e-03]\n", - "MSE values for own Ridge implementation\n", - "0.01507238889517716\n", - "MSE values for Scikit-Learn Ridge implementation\n", - "0.015072388895177083\n", - "Beta values for own Ridge implementation\n", - "[0.37396662 0.14174745 0.0764924 0.04892055 0.03447512 0.02586427\n", - " 0.02024962 0.01633913 0.01347916 0.0113104 0.0096208 0.00827728\n", - " 0.00719176 0.00630331 0.00556826 0.0049544 0.00443743 0.0039987\n", - " 0.0036237 0.003301 ]\n", - "Beta values for Scikit-Learn Ridge implementation\n", - "[0.37396662 0.14174745 0.0764924 0.04892055 0.03447512 0.02586427\n", - " 0.02024962 0.01633913 0.01347916 0.0113104 0.0096208 0.00827728\n", - " 0.00719176 0.00630331 0.00556826 0.0049544 0.00443743 0.0039987\n", - " 0.0036237 0.003301 ]\n", - "MSE values for own Ridge implementation\n", - "0.2640931530791003\n", - "MSE values for Scikit-Learn Ridge implementation\n", - "0.26409315307910036\n" - ] - }, - { - "data": { - "image/png": "iVBORw0KGgoAAAANSUhEUgAAAYgAAAEGCAYAAAB/+QKOAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjMuMywgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/Il7ecAAAACXBIWXMAAAsTAAALEwEAmpwYAAAr4ElEQVR4nO3deXyU5b338c8vIRAwCArUBRTQAsqSBAhQRFCrCMpO4gGV1qUWrVXrUan1eB61ejxi9Wld6nHpUXvqsS5NQEAQRYHiIwoJCsgigoga3NhlC2T5PX/MEIc4EAiZ3DOT77svXs69f+9A85vrvmauy9wdERGRqlKCDiAiIvFJBUJERKJSgRARkahUIEREJCoVCBERiapB0AFqS8uWLb1du3ZBxxARSSiLFi3a6O6tom1LmgLRrl07ioqKgo4hIpJQzOyzA23TIyYREYlKBUJERKJSgRARkaiSpg8imtLSUoqLiykpKQk6isSZ9PR02rRpQ1paWtBRROJWUheI4uJimjZtSrt27TCzoONInHB3Nm3aRHFxMe3btw86jkjcSupHTCUlJbRo0ULFQfZjZrRo0UItS5FqJHWBAFQcJCr9uxCpXtIXCBGRZPa3x8bzzCNXxOTcKhAxZmaMGzeucrmsrIxWrVoxdOhQAL755huGDh1KVlYWnTt35sILLwRg3bp1NG7cmOzs7Mo/f/vb3+o0e2SGzp078/Of/5zS0lIAioqKuOGGG6Ie165dOzZu3HhE13722Wcr77thw4Z069aN7Oxsfve73x3yOR566CF27dp1RDlE4plXVHDv2r/y97VTYnL+pO6kjgdHHXUUy5YtY/fu3TRu3JhZs2bRunXryu133HEHAwcO5De/+Q0AS5curdx26qmnsnjx4rqOvJ99GcrLyxk4cCAvv/wyl156KTk5OeTk5MTsuldccQVXXBF6V9SuXTvmzJlDy5YtD+scDz30EOPGjaNJkyaxiCgSuOXvTuHjo0v516aDY3J+tSDqwIUXXsj06dMBeOGFF7j44osrt3311Ve0adOmcjkzM/Owzv3WW2/RvXt3unXrxpVXXsmePXsoLCxk9OjRAEyZMoXGjRuzd+9eSkpKOOWUUwA4++yzufXWW+nduzcdO3bk7bffPuh1UlNT6d27N+vXrwdg7ty5la2gTZs2cf7559OlSxeuuuoqImcpvOeee+jUqRNnnnkmF198MQ8++CAAn3zyCYMHD6Znz57079+fjz766JDu94EHHqBXr15kZmZy5513ArBz506GDBlCVlYWXbt25aWXXuKRRx7hyy+/5JxzzuGcc845jJ+oSOIoePMRzGHkyENvWR+O+tOCuPFGqO1349nZ8NBD1e42duxY7r77boYOHcrSpUu58sorK38h//rXv2bMmDH8+c9/5rzzzuOKK67gxBNPBEK/RLOzsyvP8+ijj9K/f//K5ZKSEi6//HLeeustOnbsyM9//nMef/xxrrvuusqWx9tvv03Xrl0pLCykrKyMPn36VB5fVlbGwoULmTFjBr///e958803D3gPJSUlLFiwgIcffvgH237/+99z5plncscddzB9+nSefvppAAoLCykoKGDJkiWUlpbSo0cPevbsCcD48eN54okn6NChAwsWLODaa69l9uzZB/05vvHGG6xevZqFCxfi7gwfPpx58+axYcMGTjzxxMoivG3bNpo1a8Yf//jHGrU8RBJF/rZ36V/RjONPObw3loeq/hSIAGVmZrJu3TpeeOGFyj6GfQYNGsTatWuZOXMmr732Gt27d2fZsmVA9Y+YVq1aRfv27enYsSMAl112GY899hg33ngjp556KitXrmThwoXcdNNNzJs3j/Ly8v0KzL5WRs+ePVm3bl3Ua+wrUp9++ilDhgyJ2sKZN28ekyZNAmDIkCEcc8wxALzzzjuMGDGC9PR00tPTGTZsGAA7duxg/vz5XHTRRZXn2LNnz8F+hECoQLzxxht079698jyrV6+mf//+3Hzzzdx6660MHTp0v3sUSVarCl9jWbM9PNx4SMyuUX8KxCG804+l4cOHc8sttzB37lw2bdq037Zjjz2WSy65hEsuuYShQ4cyb968ynfaNTVgwABee+010tLSOO+887j88sspLy/ngQceqNynUaNGQOjxUVlZWdTz7CtSGzdupF+/fkydOpXhw4cfUbaKigqaN29+2P0r7s5tt93G1Vdf/YNt77//PjNmzODf//3fOffcc7njjjuOKKNIvCuY+ScARo+IzeMlUB9Enbnyyiu588476dat237rZ8+eXflJm+3bt/PJJ59w8sknH9I5O3XqxLp161izZg0Azz33HGeddRYA/fv356GHHqJv3760atWKTZs2sWrVKrp27Vqj/C1btmTixIncd999P9g2YMAA/v73vwPw2muvsWXLFgD69evHtGnTKCkpYceOHbz66qsAHH300bRv355//OMfQOgX/5IlS6rNMGjQIJ555hl27NgBwPr16/n222/58ssvadKkCePGjWPChAm8//77ADRt2pTt27fX6H5F4l3+5v9H3y0ZtOnUK2bXqD8tiIC1adMm6sdCFy1axHXXXUeDBg2oqKjgqquuolevXqxbt+4HfRBXXnnlfudIT0/n2Wef5aKLLqKsrIxevXpxzTXXANCnTx+++eYbBgwYAIQec3399ddH9AWxkSNHctddd/2gQ/vOO+/k4osvpkuXLpxxxhmVBa5Xr14MHz6czMxMjjvuOLp160azZs0AeP755/nVr37Ff/zHf1BaWsrYsWPJyso66PXPP/98Vq5cSd++fQHIyMjgf//3f1mzZg0TJkwgJSWFtLQ0Hn/8cSDUzzF48GBOPPFE5syZU+P7Fok3a5fM5YPmu3mw4dCYXsciP3FS6yc3Gww8DKQC/+3uE6tsvwm4CigDNgBXuvtn4W3lwIfhXT9394M+18jJyfGqEwatXLmS008/vTZuRWpox44dZGRksGvXLgYMGMBTTz1Fjx49go4F6N+HJK4H/nMIvy2dwae5b9Ou65lHdC4zW+TuUT+zHrMWhJmlAo8BA4FioNDMprr7iojdPgBy3H2Xmf0K+AMwJrxtt7tnxyqf1I3x48ezYsUKSkpKuOyyy+KmOIgksvwN/6QnTY64OFQnlo+YegNr3H0tgJm9CIwAKguEu0e2+98DxiFJZV/fhIjUjs9XvMvC5ju5L3VQzK8Vy07q1sAXEcvF4XUH8gvgtYjldDMrMrP3zGxktAPMbHx4n6INGzYccWARkXg3adofAMi94OaYXysuOqnNbByQA5wVsbqtu683s1OA2Wb2obt/Enmcuz8FPAWhPog6CywiEpD8r94i09Lp0HNgzK8VyxbEeuCkiOU24XX7MbPzgNuB4e5e+W0pd18f/u9aYC7QPYZZRUTi3per32d+8+3kHXNGnVwvlgWiEOhgZu3NrCEwFpgauYOZdQeeJFQcvo1Yf4yZNQq/bgn0I6LvQkSkPpo8ZSJukDfoX+vkejErEO5eBlwHvA6sBF529+VmdreZ7fvI6gNABvAPM1tsZvsKyOlAkZktAeYAE6t8+ilhxHq477PPPptOnTqRlZVFr1699vt28oUXXsjWrVt/cMxdd91VOWheTW3atKky1/HHH0/r1q0rl/fu3XtI55g7dy7z588/ohwi9UlB8SxO39aQ0/vE9vsP+8S0D8LdZwAzqqy7I+L1eQc4bj7QLdq2RFMXw30///zz5OTk8OyzzzJhwgRmzZoFwIwZM6o5suZatGhRme2uu+4iIyODW2655bDOMXfuXDIyMjjjjLppLosksm/XLeefzbZyO3U31piG2qgDsRzuO1Lfvn0rh+OG/Sfuuffee+nYsSNnnnkmq1atqtynsLCQzMxMsrOzmTBhQuVQHOXl5UyYMKFyaO0nn3zykDIsWrSIs846i549ezJo0CC++uorAB555BE6d+5MZmYmY8eOZd26dTzxxBP86U9/Ijs7u9rhxkXqu1deuY+KFMg997o6u2ZcfIqpLtw480YWf724Vs+ZfXw2Dw1+qNr9YjXcd1UzZ85k5MiRP1i/aNEiXnzxRRYvXkxZWdl+w25fccUV/OUvf6Fv3777zdb29NNP06xZMwoLC9mzZw/9+vXj/PPPp3379ge8fmlpKddffz1TpkyhVatWvPTSS9x+++0888wzTJw4kU8//ZRGjRqxdetWmjdvzjXXXFOjlodIfVSwbiY/Tk0j88y8OrtmvSkQQYrVcN/7XHrppezdu5cdO3ZE3f/tt99m1KhRlTOr7RuNdevWrWzfvr1ybKNLLrmkckC9N954g6VLl5Kfnw+E5lhYvXr1QQvEqlWrWLZsGQMHhj5+V15ezgknnFD5M7j00ksZOXJk1CImIge2+ctPmH30Jm7xn2Apdffgp94UiEN5px9LsRzu+/nnn6dnz55MmDCB66+/vnJuhiPh7jz66KMMGnTo39Z0d7p06cK77777g23Tp09n3rx5TJs2jXvvvZcPP/wwyhlEJJqpk+6jLBVy+/2qTq+rPog6EovhviOZGffccw/vvffeD6bvHDBgAK+88gq7d+9m+/btTJs2DYDmzZvTtGlTFixYAMCLL75YecygQYN4/PHHKS0tBeDjjz9m586dB83QqVMnNmzYUFkgSktLWb58ORUVFXzxxRecc8453H///Wzbto0dO3ZoOG6RQ5T/yTTabk+l50/rdjQiFYg6crDhvnNycsjMzKRv376Vw33D930Q+/488sgjB71G48aNufnmm/ebFAigR48ejBkzhqysLC644ILK80Oor+GXv/wl2dnZ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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter3_115_1.png" - }, - "needs_background": "light" - }, - "output_type": "display_data" - } - ], - "source": [ - "import numpy as np\n", - "import pandas as pd\n", - "import matplotlib.pyplot as plt\n", - "from sklearn.model_selection import train_test_split\n", - "from sklearn import linear_model\n", - "\n", - "def MSE(y_data,y_model):\n", - " n = np.size(y_model)\n", - " return np.sum((y_data-y_model)**2)/n\n", - "\n", - "\n", - "# A seed just to ensure that the random numbers are the same for every run.\n", - "# Useful for eventual debugging.\n", - "np.random.seed(3155)\n", - "\n", - "n = 100\n", - "x = np.random.rand(n)\n", - "y = np.exp(-x**2) + 1.5 * np.exp(-(x-2)**2)\n", - "\n", - "Maxpolydegree = 20\n", - "X = np.zeros((n,Maxpolydegree))\n", - "#We include explicitely the intercept column\n", - "for degree in range(Maxpolydegree):\n", - " X[:,degree] = x**degree\n", - "# We split the data in test and training data\n", - "X_train, X_test, y_train, y_test = train_test_split(X, y, test_size=0.2)\n", - "\n", - "p = Maxpolydegree\n", - "I = np.eye(p,p)\n", - "# Decide which values of lambda to use\n", - "nlambdas = 6\n", - "MSEOwnRidgePredict = np.zeros(nlambdas)\n", - "MSERidgePredict = np.zeros(nlambdas)\n", - "lambdas = np.logspace(-4, 2, nlambdas)\n", - "for i in range(nlambdas):\n", - " lmb = lambdas[i]\n", - " OwnRidgeBeta = np.linalg.pinv(X_train.T @ X_train+lmb*I) @ X_train.T @ y_train\n", - " # Note: we include the intercept column and no scaling\n", - " RegRidge = linear_model.Ridge(lmb,fit_intercept=False)\n", - " RegRidge.fit(X_train,y_train)\n", - " # and then make the prediction\n", - " ytildeOwnRidge = X_train @ OwnRidgeBeta\n", - " ypredictOwnRidge = X_test @ OwnRidgeBeta\n", - " ytildeRidge = RegRidge.predict(X_train)\n", - " ypredictRidge = RegRidge.predict(X_test)\n", - " MSEOwnRidgePredict[i] = MSE(y_test,ypredictOwnRidge)\n", - " MSERidgePredict[i] = MSE(y_test,ypredictRidge)\n", - " print(\"Beta values for own Ridge implementation\")\n", - " print(OwnRidgeBeta)\n", - " print(\"Beta values for Scikit-Learn Ridge implementation\")\n", - " print(RegRidge.coef_)\n", - " print(\"MSE values for own Ridge implementation\")\n", - " print(MSEOwnRidgePredict[i])\n", - " print(\"MSE values for Scikit-Learn Ridge implementation\")\n", - " print(MSERidgePredict[i])\n", - "\n", - "# Now plot the results\n", - "plt.figure()\n", - "plt.plot(np.log10(lambdas), MSEOwnRidgePredict, 'r', label = 'MSE own Ridge Test')\n", - "plt.plot(np.log10(lambdas), MSERidgePredict, 'g', label = 'MSE Ridge Test')\n", - "\n", - "plt.xlabel('log10(lambda)')\n", - "plt.ylabel('MSE')\n", - "plt.legend()\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The results here agree when we force **Scikit-Learn**'s Ridge function to include the first column in our design matrix.\n", - "We see that the results agree very well. Here we have thus explicitely included the intercept column in the design matrix.\n", - "What happens if we do not include the intercept in our fit?\n", - "Let us see how we can change this code by zero centering." - ] - }, - { - "cell_type": "code", - "execution_count": 13, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Beta values for own Ridge implementation\n", - "[ 3.43579948e-02 -5.43330971e-01 -3.10141414e-03 2.47116868e-01\n", - " 2.18613217e-01 1.02054837e-01 -4.25617662e-04 -5.90475506e-02\n", - " -7.68534263e-02 -6.68929213e-02 -4.24906604e-02 -1.40927184e-02\n", - " 1.11482289e-02 2.88529063e-02 3.67047975e-02 3.38135733e-02\n", - " 2.02198702e-02 -3.46383924e-03 -3.63025821e-02]\n", - "Beta values for Scikit-Learn Ridge implementation\n", - "[ 3.43579948e-02 -5.43330971e-01 -3.10141413e-03 2.47116868e-01\n", - " 2.18613217e-01 1.02054837e-01 -4.25617658e-04 -5.90475506e-02\n", - " -7.68534263e-02 -6.68929213e-02 -4.24906604e-02 -1.40927184e-02\n", - " 1.11482289e-02 2.88529063e-02 3.67047975e-02 3.38135733e-02\n", - " 2.02198702e-02 -3.46383925e-03 -3.63025821e-02]\n", - "Intercept from own implementation:\n", - "1.0330308045181225\n", - "Intercept from Scikit-Learn Ridge implementation\n", - "1.033030804518383\n", - "MSE values for own Ridge implementation\n", - "3.139255958275475e-06\n", - "MSE values for Scikit-Learn Ridge implementation\n", - "3.139255958572018e-06\n", - "Beta values for own Ridge implementation\n", - "[-0.05807125 -0.29822833 -0.08551306 0.08156108 0.13679863 0.12333649\n", - " 0.08251519 0.03815288 0.00111756 -0.02498832 -0.04010697 -0.04566964\n", - " -0.04355837 -0.03562355 -0.02348765 -0.00848904 0.00831018 0.0260906\n", - " 0.04423486]\n", - "Beta values for Scikit-Learn Ridge implementation\n", - "[-0.05807125 -0.29822833 -0.08551306 0.08156108 0.13679863 0.12333649\n", - " 0.08251519 0.03815288 0.00111756 -0.02498832 -0.04010697 -0.04566964\n", - " -0.04355837 -0.03562355 -0.02348765 -0.00848904 0.00831018 0.0260906\n", - " 0.04423486]\n", - "Intercept from own implementation:\n", - "1.0411487294305548\n", - "Intercept from Scikit-Learn Ridge implementation\n", - "1.0411487294305266\n", - "MSE values for own Ridge implementation\n", - "1.9601304850163794e-05\n", - "MSE values for Scikit-Learn Ridge implementation\n", - "1.9601304850085328e-05\n", - "Beta values for own Ridge implementation\n", - "[-0.1416398 -0.14021063 -0.05383795 0.01367553 0.04784395 0.05796251\n", - " 0.05447415 0.044613 0.03267527 0.02098261 0.01066519 0.00217499\n", - " -0.00440346 -0.00917248 -0.01231917 -0.01405935 -0.0146081 -0.01416528\n", - " -0.01290947]\n", - "Beta values for Scikit-Learn Ridge implementation\n", - "[-0.1416398 -0.14021063 -0.05383795 0.01367553 0.04784395 0.05796251\n", - " 0.05447415 0.044613 0.03267527 0.02098261 0.01066519 0.00217499\n", - " -0.00440346 -0.00917248 -0.01231917 -0.01405935 -0.0146081 -0.01416528\n", - " -0.01290947]\n", - "Intercept from own implementation:\n", - "1.0495569966278282\n", - "Intercept from Scikit-Learn Ridge implementation\n", - "1.0495569966278269\n", - "MSE values for own Ridge implementation\n", - "5.4959161509370406e-05\n", - "MSE values for Scikit-Learn Ridge implementation\n", - "5.4959161509366834e-05\n", - "Beta values for own Ridge implementation\n", - "[-0.13535942 -0.08593216 -0.03568439 -0.0036367 0.01397146 0.02229529\n", - " 0.02503753 0.0245528 0.02228115 0.01908936 0.01549377 0.01179792\n", - " 0.00817631 0.00472512 0.00149311 -0.00149956 -0.00424967 -0.00676387\n", - " -0.00905423]\n", - "Beta values for Scikit-Learn Ridge implementation\n", - "[-0.13535942 -0.08593216 -0.03568439 -0.0036367 0.01397146 0.02229529\n", - " 0.02503753 0.0245528 0.02228115 0.01908936 0.01549377 0.01179792\n", - " 0.00817631 0.00472512 0.00149311 -0.00149956 -0.00424967 -0.00676387\n", - " -0.00905423]\n", - "Intercept from own implementation:\n", - "1.039967668952797\n", - "Intercept from Scikit-Learn Ridge implementation\n", - "1.0399676689527975\n", - "MSE values for own Ridge implementation\n", - "7.571105947979326e-05\n", - "MSE values for Scikit-Learn Ridge implementation\n", - "7.57110594797945e-05\n", - "Beta values for own Ridge implementation\n", - "[-0.05100875 -0.04063602 -0.02723445 -0.01713366 -0.0100706 -0.00517114\n", - " -0.00174276 0.00068734 0.00243186 0.00369758 0.00462287 0.0053018\n", - " 0.00579953 0.006162 0.00642221 0.00660427 0.00672607 0.0068011\n", - " 0.00683964]\n", - "Beta values for Scikit-Learn Ridge implementation\n", - "[-0.05100875 -0.04063602 -0.02723445 -0.01713366 -0.0100706 -0.00517114\n", - " -0.00174276 0.00068734 0.00243186 0.00369758 0.00462287 0.0053018\n", - " 0.00579953 0.006162 0.00642221 0.00660427 0.00672607 0.0068011\n", - " 0.00683964]\n", - "Intercept from own implementation:\n", - "0.999955585168597\n", - "Intercept from Scikit-Learn Ridge implementation\n", - "0.999955585168597\n", - "MSE values for own Ridge implementation\n", - "0.0007698473260556339\n", - "MSE values for Scikit-Learn Ridge implementation\n", - "0.000769847326055633\n", - "Beta values for own Ridge implementation\n", - "[-0.00834567 -0.00803064 -0.00673407 -0.00554552 -0.00458878 -0.0038335\n", - " -0.00323332 -0.00274989 -0.0023548 -0.00202756 -0.00175331 -0.00152117\n", - " -0.001323 -0.0011526 -0.00100519 -0.00087697 -0.00076495 -0.00066668\n", - " -0.00058016]\n", - "Beta values for Scikit-Learn Ridge implementation\n", - "[-0.00834567 -0.00803064 -0.00673407 -0.00554552 -0.00458878 -0.0038335\n", - " -0.00323332 -0.00274989 -0.0023548 -0.00202756 -0.00175331 -0.00152117\n", - " -0.001323 -0.0011526 -0.00100519 -0.00087697 -0.00076495 -0.00066668\n", - " -0.00058016]\n", - "Intercept from own implementation:\n", - "0.9637117593816477\n", - "Intercept from Scikit-Learn Ridge implementation\n", - "0.9637117593816477\n", - "MSE values for own Ridge implementation\n", - "0.0023813163025848865\n", - "MSE values for Scikit-Learn Ridge implementation\n", - "0.002381316302584886\n" - ] - }, - { - "data": { - "image/png": "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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter3_117_1.png" - }, - "needs_background": "light" - }, - "output_type": "display_data" - } - ], - "source": [ - "import numpy as np\n", - "import pandas as pd\n", - "import matplotlib.pyplot as plt\n", - "from sklearn.model_selection import train_test_split\n", - "from sklearn import linear_model\n", - "from sklearn.preprocessing import StandardScaler\n", - "\n", - "def MSE(y_data,y_model):\n", - " n = np.size(y_model)\n", - " return np.sum((y_data-y_model)**2)/n\n", - "# A seed just to ensure that the random numbers are the same for every run.\n", - "# Useful for eventual debugging.\n", - "np.random.seed(315)\n", - "\n", - "n = 100\n", - "x = np.random.rand(n)\n", - "y = np.exp(-x**2) + 1.5 * np.exp(-(x-2)**2)\n", - "\n", - "Maxpolydegree = 20\n", - "X = np.zeros((n,Maxpolydegree-1))\n", - "\n", - "for degree in range(1,Maxpolydegree): #No intercept column\n", - " X[:,degree-1] = x**(degree)\n", - "\n", - "# We split the data in test and training data\n", - "X_train, X_test, y_train, y_test = train_test_split(X, y, test_size=0.2)\n", - "\n", - "#For our own implementation, we will need to deal with the intercept by centering the design matrix and the target variable\n", - "X_train_mean = np.mean(X_train,axis=0)\n", - "#Center by removing mean from each feature\n", - "X_train_scaled = X_train - X_train_mean \n", - "X_test_scaled = X_test - X_train_mean\n", - "#The model intercept (called y_scaler) is given by the mean of the target variable (IF X is centered)\n", - "#Remove the intercept from the training data.\n", - "y_scaler = np.mean(y_train) \n", - "y_train_scaled = y_train - y_scaler \n", - "\n", - "p = Maxpolydegree-1\n", - "I = np.eye(p,p)\n", - "# Decide which values of lambda to use\n", - "nlambdas = 6\n", - "MSEOwnRidgePredict = np.zeros(nlambdas)\n", - "MSERidgePredict = np.zeros(nlambdas)\n", - "\n", - "lambdas = np.logspace(-4, 2, nlambdas)\n", - "for i in range(nlambdas):\n", - " lmb = lambdas[i]\n", - " OwnRidgeBeta = np.linalg.pinv(X_train_scaled.T @ X_train_scaled+lmb*I) @ X_train_scaled.T @ (y_train_scaled)\n", - " intercept_ = y_scaler - X_train_mean@OwnRidgeBeta #The intercept can be shifted so the model can predict on uncentered data\n", - " #Add intercept to prediction\n", - " ypredictOwnRidge = X_test_scaled @ OwnRidgeBeta + y_scaler \n", - " RegRidge = linear_model.Ridge(lmb)\n", - " RegRidge.fit(X_train,y_train)\n", - " ypredictRidge = RegRidge.predict(X_test)\n", - " MSEOwnRidgePredict[i] = MSE(y_test,ypredictOwnRidge)\n", - " MSERidgePredict[i] = MSE(y_test,ypredictRidge)\n", - " print(\"Beta values for own Ridge implementation\")\n", - " print(OwnRidgeBeta) #Intercept is given by mean of target variable\n", - " print(\"Beta values for Scikit-Learn Ridge implementation\")\n", - " print(RegRidge.coef_)\n", - " print('Intercept from own implementation:')\n", - " print(intercept_)\n", - " print('Intercept from Scikit-Learn Ridge implementation')\n", - " print(RegRidge.intercept_)\n", - " print(\"MSE values for own Ridge implementation\")\n", - " print(MSEOwnRidgePredict[i])\n", - " print(\"MSE values for Scikit-Learn Ridge implementation\")\n", - " print(MSERidgePredict[i])\n", - "\n", - "\n", - "# Now plot the results\n", - "plt.figure()\n", - "plt.plot(np.log10(lambdas), MSEOwnRidgePredict, 'b--', label = 'MSE own Ridge Test')\n", - "plt.plot(np.log10(lambdas), MSERidgePredict, 'g--', label = 'MSE SL Ridge Test')\n", - "plt.xlabel('log10(lambda)')\n", - "plt.ylabel('MSE')\n", - "plt.legend()\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We see here, when compared to the code which includes explicitely the\n", - "intercept column, that our MSE value is actually smaller. This is\n", - "because the regularization term does not include the intercept value\n", - "$\\beta_0$ in the fitting. This applies to Lasso regularization as\n", - "well. It means that our optimization is now done only with the\n", - "centered matrix and/or vector that enter the fitting procedure. Note\n", - "also that the problem with the intercept occurs mainly in these type\n", - "of polynomial fitting problem.\n", - "\n", - "The next example is indeed an example where all these discussions about the role of intercept are not present.\n", - "\n", - "## More complicated Example: The Ising model\n", - "\n", - "The one-dimensional Ising model with nearest neighbor interaction, no\n", - "external field and a constant coupling constant $J$ is given by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - " H = -J \\sum_{k}^L s_k s_{k + 1},\n", - "\\label{_auto1} \\tag{1}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $s_i \\in \\{-1, 1\\}$ and $s_{N + 1} = s_1$. The number of spins\n", - "in the system is determined by $L$. For the one-dimensional system\n", - "there is no phase transition.\n", - "\n", - "We will look at a system of $L = 40$ spins with a coupling constant of\n", - "$J = 1$. To get enough training data we will generate 10000 states\n", - "with their respective energies." - ] - }, - { - "cell_type": "code", - "execution_count": 14, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import numpy as np\n", - "import matplotlib.pyplot as plt\n", - "from mpl_toolkits.axes_grid1 import make_axes_locatable\n", - "import seaborn as sns\n", - "import scipy.linalg as scl\n", - "from sklearn.model_selection import train_test_split\n", - "import tqdm\n", - "sns.set(color_codes=True)\n", - "cmap_args=dict(vmin=-1., vmax=1., cmap='seismic')\n", - "\n", - "L = 40\n", - "n = int(1e4)\n", - "\n", - "spins = np.random.choice([-1, 1], size=(n, L))\n", - "J = 1.0\n", - "\n", - "energies = np.zeros(n)\n", - "\n", - "for i in range(n):\n", - " energies[i] = - J * np.dot(spins[i], np.roll(spins[i], 1))" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Here we use ordinary least squares\n", - "regression to predict the energy for the nearest neighbor\n", - "one-dimensional Ising model on a ring, i.e., the endpoints wrap\n", - "around. We will use linear regression to fit a value for\n", - "the coupling constant to achieve this.\n", - "\n", - "A more general form for the one-dimensional Ising model is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - " H = - \\sum_j^L \\sum_k^L s_j s_k J_{jk}.\n", - "\\label{_auto2} \\tag{2}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Here we allow for interactions beyond the nearest neighbors and a state dependent\n", - "coupling constant. This latter expression can be formulated as\n", - "a matrix-product" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - " \\boldsymbol{H} = \\boldsymbol{X} J,\n", - "\\label{_auto3} \\tag{3}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $X_{jk} = s_j s_k$ and $J$ is a matrix which consists of the\n", - "elements $-J_{jk}$. This form of writing the energy fits perfectly\n", - "with the form utilized in linear regression, that is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - " \\boldsymbol{y} = \\boldsymbol{X}\\boldsymbol{\\beta} + \\boldsymbol{\\epsilon},\n", - "\\label{_auto4} \\tag{4}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We split the data in training and test data as discussed in the previous example" - ] - }, - { - "cell_type": "code", - "execution_count": 15, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "X = np.zeros((n, L ** 2))\n", - "for i in range(n):\n", - " X[i] = np.outer(spins[i], spins[i]).ravel()\n", - "y = energies\n", - "X_train, X_test, y_train, y_test = train_test_split(X, y, test_size=0.2)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In the ordinary least squares method we choose the cost function" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - " C(\\boldsymbol{X}, \\boldsymbol{\\beta})= \\frac{1}{n}\\left\\{(\\boldsymbol{X}\\boldsymbol{\\beta} - \\boldsymbol{y})^T(\\boldsymbol{X}\\boldsymbol{\\beta} - \\boldsymbol{y})\\right\\}.\n", - "\\label{_auto5} \\tag{5}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We then find the extremal point of $C$ by taking the derivative with respect to $\\boldsymbol{\\beta}$ as discussed above.\n", - "This yields the expression for $\\boldsymbol{\\beta}$ to be" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{\\beta} = \\frac{\\boldsymbol{X}^T \\boldsymbol{y}}{\\boldsymbol{X}^T \\boldsymbol{X}},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which immediately imposes some requirements on $\\boldsymbol{X}$ as there must exist\n", - "an inverse of $\\boldsymbol{X}^T \\boldsymbol{X}$. If the expression we are modeling contains an\n", - "intercept, i.e., a constant term, we must make sure that the\n", - "first column of $\\boldsymbol{X}$ consists of $1$. We do this here" - ] - }, - { - "cell_type": "code", - "execution_count": 16, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "X_train_own = np.concatenate(\n", - " (np.ones(len(X_train))[:, np.newaxis], X_train),\n", - " axis=1\n", - ")\n", - "X_test_own = np.concatenate(\n", - " (np.ones(len(X_test))[:, np.newaxis], X_test),\n", - " axis=1\n", - ")" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Doing the inversion directly turns out to be a bad idea since the matrix\n", - "$\\boldsymbol{X}^T\\boldsymbol{X}$ is singular. An alternative approach is to use the **singular\n", - "value decomposition**. Using the definition of the Moore-Penrose\n", - "pseudoinverse we can write the equation for $\\boldsymbol{\\beta}$ as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{\\beta} = \\boldsymbol{X}^{+}\\boldsymbol{y},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where the pseudoinverse of $\\boldsymbol{X}$ is given by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}^{+} = \\frac{\\boldsymbol{X}^T}{\\boldsymbol{X}^T\\boldsymbol{X}}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Using singular value decomposition we can decompose the matrix $\\boldsymbol{X} = \\boldsymbol{U}\\boldsymbol{\\Sigma} \\boldsymbol{V}^T$,\n", - "where $\\boldsymbol{U}$ and $\\boldsymbol{V}$ are orthogonal(unitary) matrices and $\\boldsymbol{\\Sigma}$ contains the singular values (more details below).\n", - "where $X^{+} = V\\Sigma^{+} U^T$. This reduces the equation for\n", - "$\\omega$ to" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - " \\boldsymbol{\\beta} = \\boldsymbol{V}\\boldsymbol{\\Sigma}^{+} \\boldsymbol{U}^T \\boldsymbol{y}.\n", - "\\label{_auto6} \\tag{6}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Note that solving this equation by actually doing the pseudoinverse\n", - "(which is what we will do) is not a good idea as this operation scales\n", - "as $\\mathcal{O}(n^3)$, where $n$ is the number of elements in a\n", - "general matrix. Instead, doing $QR$-factorization and solving the\n", - "linear system as an equation would reduce this down to\n", - "$\\mathcal{O}(n^2)$ operations." - ] - }, - { - "cell_type": "code", - "execution_count": 17, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "def ols_svd(x: np.ndarray, y: np.ndarray) -> np.ndarray:\n", - " u, s, v = scl.svd(x)\n", - " return v.T @ scl.pinv(scl.diagsvd(s, u.shape[0], v.shape[0])) @ u.T @ y" - ] - }, - { - "cell_type": "code", - "execution_count": 18, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "beta = ols_svd(X_train_own,y_train)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "When extracting the $J$-matrix we need to make sure that we remove the intercept, as is done here" - ] - }, - { - "cell_type": "code", - "execution_count": 19, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "J = beta[1:].reshape(L, L)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "A way of looking at the coefficients in $J$ is to plot the matrices as images." - ] - }, - { - "cell_type": "code", - "execution_count": 20, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stderr", - "output_type": "stream", - "text": [ - ":7: UserWarning: FixedFormatter should only be used together with FixedLocator\n", - " cb.ax.set_yticklabels(cb.ax.get_yticklabels(), fontsize=18)\n" - ] - }, - { - "data": { - "image/png": "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6q+ip6cnenp64rrrrov33nvv4CMHAAAgmUIjgqtXr46lS5fGnDlz4hvf+EZs3rw57r///vjNb34Tvb29UalUYsuWLfHVr341du/eHZdddlnUarW49957Y926dbFy5coYN27caB8LAABAG6VbVCqdfY/9FSoE77jjjpgxY0Y88MADMWHChIjYM7x4yy23xNNPPx2nnHJKfO9734s333wznnjiiTjmmGMiIuL444+PSy+9NB577LE4//zzEx0IAAAAB2PEqaG7du2KT37yk3H++ecPFIERET09PRERsW7duoiIWLVqVfT09AwUgRERJ598chx11FGxatWq1HEDAABkph57RgVz+W//j/4YcURw/Pjxce+99w55fc2aNRERcdhhh8XWrVtj48aNsWDBgiHt5syZEz/96U9H2g0AAAAt0vSqoZs2bYpf/OIXcdttt8Xs2bPji1/8Yrz22msRETF9+vQh7adNmxbbt2+P7du3x6GHHnrwEQMAAHBQmioEf//738dpp50WERETJ06MG2+8McaPHz+weujEiROH/Jvx48dHRMTOnTsVggAAwBhWi4iMHiQYXft9p6lCsKurK5YtWxa7d++OFStWxKWXXhrLli2LadOmFfq3TakUeLJFgTaFn4/RcnlGVjSqIqcn12NMqR1HWCz3yffajp3mqcUnQOY/1ur7jtx/rJPv+SmjajSqCbdWTJHc1/f/E6AD3WuGW0q/tZF31/o+3dH5ouM0VQh+4hOfiIULF0ZExOmnnx5nnnlm3HrrrfHf/tt/i4g9C8v8sb2vTZ48ubnIRrqrVSqF7nz1TC+CyjA/3GynIvkqmPpsjzGlVvevorlPvt8SnMtC2nACcr2HtVo77jtyv0en3/NTnsdqNd2y8LXayEVl0dx3N/1Dn+HV+/O8jlrax9r0gdux+SqqPX/NZj8O+GxMmDAhTj311Ni8eXN8+tOfjoiId955Z0i7t99+O6ZMmRKTJk068CgBAACyV8/wv30bsRBcv359nHbaadHb2zvkvb6+vujq6opx48bFrFmz4oUXXhjS5sUXX4zjjjtupN0AAADQIiMWgkcccURs3749Hn744di9e/fA65s2bYof/vCHceKJJ8bkyZNj/vz5sXr16li/fv1Am2eeeSY2bNgwMJ0UAACA9utqNBojLmvz+OOPx3XXXRcnnHBCfPnLX44tW7ZE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AAAAJdPd7gCatXHjxrjtttvi2WefjYiIU089Na6//vqYOnVqmyMb+84999x4/vnnh7y+YMGCuPPOO9sQ0dh30003xauvvhorVqwY9LrroDX2l3/XQnpPP/103H333fHCCy9EpVKJ448/Pq6++uo44YQTBtro96OjSO71+dGzevXquPPOO2Pt2rUxefLkOP300+Pqq6+OQw45ZKCNvj86iuRe32cs66hCcMuWLfHVr341du/eHZdddlnUarW49957Y926dbFy5coYN25cu0McsxqNRqxfvz7mzZsX8+fPH/TezJkz2xTV2LZy5cp45JFHoqenZ9DrroPW2F/+XQvpPfvss3H55ZfHscceG9dcc0309/fHgw8+GF/5ylfiwQcfjM9+9rP6/Sgpknt9fvSsXr06li5dGnPmzIlvfOMbsXnz5rj//vvjN7/5TfT29kalUtH3R0mR3Ov7jHmNDvL3f//3jT/7sz9rvPzyywOv/fznP2/Mnj278f3vf7+NkY19//f//t/G7NmzG//9v//3docy5vX39ze+853vNP7kT/6kMXv27MZXvvKVQe+7DkbXSPl3LaS3aNGixqmnntrYuXPnwGvvvPNO48QTT2xccskljUZDvx8tRXKvz4+es88+u/Ef/sN/aLz//vsDrz3wwAON2bNnN/75n/+50Wjo+6OlSO71fca6jvqN4KpVq6KnpyeOOeaYgddOPvnkOOqoo2LVqlVtjGzse/nllyMiBuWe9Hbt2hVnn312fOc734lFixbF9OnTh7RxHYyeIvl3LaS1devWWLt2bZx++ukxceLEgdc/9alPxYknnhi//vWvI0K/Hw1Fc6/Pj45du3bFJz/5yTj//PNjwoQJA6/vnYWwbt26iND3R0PR3Ov7jHUdMzV069atsXHjxliwYMGQ9+bMmRM//elP2xBVebz00ksR8fHNcOfOnTFp0qR2hjQm7dq1K3bs2BHLli2LhQsXxmmnnTbofdfB6Bop/xGuhdQmT54cTz311KBCZK8tW7ZEtVrV70dJkdxH6POjZfz48XHvvfcOeX3NmjUREXHYYYfp+6OkSO4j9H3Gvo4ZEXzrrbciIvb5F/pp06bF9u3bY/v27a0OqzReeumlOOSQQ+LWW2+NuXPnxty5c2PevHn+GpnY5MmT40c/+lEsXLhwn++7DkbXSPmPcC2kVq1W48gjjxzSp9euXRvPPfdczJ07V78fJUVyH6HPt8qmTZvi0UcfjW9961sxe/bs+OIXv6jvt8i+ch+h7zP2dcyIYF9fX0TEPv9yOX78+IjY85eaQw89tKVxlcXLL78cfX19sX379rj99ttj27Ztcf/998e1114bH374YSxevLjdIY4JlUolKpX9/33GdTC6Rsp/hGuhFfr6+uKb3/xmRERcccUV+n0L/XHuI/T5Vvj9738/MANh4sSJceONN8b48eP1/RbYX+4j9H3Gvo4pBBuNxohturq6WhBJOZ1//vlRr9djyZIlA6+dccYZceaZZ8Ydd9wRZ5111sA0IkaP66D9XAuj6/33348rr7wy1q5dG1//+tejp6cnnnvuuRH/nX5/8PaV+wh9vhW6urpi2bJlsXv37lixYkVceumlsWzZspg2bVqhf8uB21/uFyxYoO8z5nXM1NC9c7J37do15L29r02ePLmlMZXJRRddNOhGGBExYcKEWLRoUbz77rsDP6hmdLkO2s+1MHq2bdsWS5cujV/84hdxzjnnxDXXXBMR+n0r7C/3Efp8K3ziE5+IhQsXxuLFi6O3tzcOO+ywuPXWW/X9Fthf7iP0fca+jikE9/5w95133hny3ttvvx1TpkzxA9422Psw2507d7Y5knJwHeTLtXBwfve738XFF18czz33XFxwwQXxrW99a2CkQ78fXcPlfjj6/OiYMGFCnHrqqbF58+b49Kc/HRH6fqv8Ye7fe++9/bbT9xkrOqYQnDJlSsyaNSteeOGFIe+9+OKLcdxxx7UhqnJ466234owzzoi77rpryHsbNmyIiIhZs2a1OqxSch20l2thdOzYsSO+9rWvxZo1a+KSSy6JW265ZVAhot+PnpFyr8+PnvXr18dpp50Wvb29Q97r6+uLrq6uGDdunL4/Cork/v3339f3GfM6phCMiJg/f36sXr061q9fP/DaM888Exs2bBh2lT8OzvTp02Pbtm2xcuXK2LFjx8Drb7zxRjz66KNx0kknFfodA2m4DtrHtTA6brnlllizZk1cfPHFccMNN+yzjX4/OkbKvT4/eo444ojYvn17PPzww7F79+6B1zdt2hQ//OEP48QTT4zJkyfr+6OgSO5nzpyp7zPmdTWKrD6Riffeey/OPPPMqFarsXTp0ti1a1csX748Dj/88Hj44Ydj3Lhx7Q5xzPrxj38cV111VRx77LFx3nnnRV9fX/T29saHH34YDz30kIetjpLTTjstZs6cGStWrBh4zXXQOvvKv2shrfXr18fChQtjypQpccMNN+xz4YVFixbp96OgaO71+dHz+OOPx3XXXRcnnHBCfPnLX44tW7YM5PbBBx+M2bNn6/ujpEju9X3Guo4qBCMiXnnllbj11lvjl7/8ZUyYMCFOOeWUuO666wbmazN6fvzjH8c999wTa9eujQkTJkRPT09ce+21boSjaF+FSITroFX2l3/XQjoPPfRQ/PVf//WwbdatWxcR+n1qzeRenx89Tz75ZCxfvjx++9vfxqRJk+Jzn/tcXHPNNXHUUUcNtNH3R0eR3Ov7jGUdVwgCAABwcDrqN4IAAAAcPIUgAABAySgEAQAASkYhCAAAUDIKQQAAgJJRCAIAAJSMQhAAAKBkFIIAAAAloxAEAAAomf8fcpttBfj//P0AAAAASUVORK5CYII=\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter3_148_1.png" - } - }, - "output_type": "display_data" - } - ], - "source": [ - "fig = plt.figure(figsize=(20, 14))\n", - "im = plt.imshow(J, **cmap_args)\n", - "plt.title(\"OLS\", fontsize=18)\n", - "plt.xticks(fontsize=18)\n", - "plt.yticks(fontsize=18)\n", - "cb = fig.colorbar(im)\n", - "cb.ax.set_yticklabels(cb.ax.get_yticklabels(), fontsize=18)\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "It is interesting to note that OLS\n", - "considers both $J_{j, j + 1} = -0.5$ and $J_{j, j - 1} = -0.5$ as\n", - "valid matrix elements for $J$.\n", - "In our discussion below on hyperparameters and Ridge and Lasso regression we will see that\n", - "this problem can be removed, partly and only with Lasso regression. \n", - "\n", - "In this case our matrix inversion was actually possible. The obvious question now is what is the mathematics behind the SVD?\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "Let us now \n", - "focus on Ridge and Lasso regression as well. We repeat some of the\n", - "basic parts of the Ising model and the setup of the training and test\n", - "data. The one-dimensional Ising model with nearest neighbor\n", - "interaction, no external field and a constant coupling constant $J$ is\n", - "given by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - " H = -J \\sum_{k}^L s_k s_{k + 1},\n", - "\\label{_auto7} \\tag{7}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $s_i \\in \\{-1, 1\\}$ and $s_{N + 1} = s_1$. The number of spins in the system is determined by $L$. For the one-dimensional system there is no phase transition.\n", - "\n", - "We will look at a system of $L = 40$ spins with a coupling constant of $J = 1$. To get enough training data we will generate 10000 states with their respective energies." - ] - }, - { - "cell_type": "code", - "execution_count": 21, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import numpy as np\n", - "import matplotlib.pyplot as plt\n", - "from mpl_toolkits.axes_grid1 import make_axes_locatable\n", - "import seaborn as sns\n", - "import scipy.linalg as scl\n", - "from sklearn.model_selection import train_test_split\n", - "import sklearn.linear_model as skl\n", - "import tqdm\n", - "sns.set(color_codes=True)\n", - "cmap_args=dict(vmin=-1., vmax=1., cmap='seismic')\n", - "\n", - "L = 40\n", - "n = int(1e4)\n", - "\n", - "spins = np.random.choice([-1, 1], size=(n, L))\n", - "J = 1.0\n", - "\n", - "energies = np.zeros(n)\n", - "\n", - "for i in range(n):\n", - " energies[i] = - J * np.dot(spins[i], np.roll(spins[i], 1))" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "A more general form for the one-dimensional Ising model is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - " H = - \\sum_j^L \\sum_k^L s_j s_k J_{jk}.\n", - "\\label{_auto8} \\tag{8}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Here we allow for interactions beyond the nearest neighbors and a more\n", - "adaptive coupling matrix. This latter expression can be formulated as\n", - "a matrix-product on the form" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - " H = X J,\n", - "\\label{_auto9} \\tag{9}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $X_{jk} = s_j s_k$ and $J$ is the matrix consisting of the\n", - "elements $-J_{jk}$. This form of writing the energy fits perfectly\n", - "with the form utilized in linear regression, viz." - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - " \\boldsymbol{y} = \\boldsymbol{X}\\boldsymbol{\\beta} + \\boldsymbol{\\epsilon}.\n", - "\\label{_auto10} \\tag{10}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We organize the data as we did above" - ] - }, - { - "cell_type": "code", - "execution_count": 22, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "X = np.zeros((n, L ** 2))\n", - "for i in range(n):\n", - " X[i] = np.outer(spins[i], spins[i]).ravel()\n", - "y = energies\n", - "X_train, X_test, y_train, y_test = train_test_split(X, y, test_size=0.96)\n", - "\n", - "X_train_own = np.concatenate(\n", - " (np.ones(len(X_train))[:, np.newaxis], X_train),\n", - " axis=1\n", - ")\n", - "\n", - "X_test_own = np.concatenate(\n", - " (np.ones(len(X_test))[:, np.newaxis], X_test),\n", - " axis=1\n", - ")" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We will do all fitting with **Scikit-Learn**," - ] - }, - { - "cell_type": "code", - "execution_count": 23, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "clf = skl.LinearRegression().fit(X_train, y_train)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "When extracting the $J$-matrix we make sure to remove the intercept" - ] - }, - { - "cell_type": "code", - "execution_count": 24, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "J_sk = clf.coef_.reshape(L, L)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "And then we plot the results" - ] - }, - { - "cell_type": "code", - "execution_count": 25, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stderr", - "output_type": "stream", - "text": [ - ":7: UserWarning: FixedFormatter should only be used together with FixedLocator\n", - " cb.ax.set_yticklabels(cb.ax.get_yticklabels(), fontsize=18)\n" - ] - }, - { - "data": { - "image/png": "iVBORw0KGgoAAAANSUhEUgAAA4IAAAM2CAYAAACjUj0CAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjMuMywgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/Il7ecAAAACXBIWXMAAAsTAAALEwEAmpwYAAB7LklEQVR4nO3de3xU1b3//3cmcRjiOMZpICGkIQSMCJTbUbDUqsUICip4FLygqHhpe7CtWEvRH60txwqoRyrar9ripSDeOHKqFr/aWusd4etBi4jhHiGEBGMIQwghJpnfH0Ag5rI3zCfJDvN6Ph48fDj7k898smftPbOy1qyVEI1GowIAAAAAxA1fexcAAAAAAGhbdAQBAAAAIM7QEQQAAACAOENHEAAAAADiDB1BAAAAAIgzdAQBAAAAIM7QEQTQaqZPn65TTjlFhYWFruK8asmSJTrllFMa/evXr5+++93v6uabb9ann37a3mW2ieXLl+uUU07RkiVL2vR5t23bpmuuuUYDBgzQsGHDVFZW1qbP79ann36qn/70p/re976n/v3768wzz9TUqVOPqn0UFhbqlFNO0UMPPVT/2CmnnKLp06e3+HMjRozQNddc0+Cxr776SpWVlY7P6fVrEQBgJ6m9CwCAyy+/XN/97nfbuwxHl19+uf7t3/6t/v+rq6u1du1aPffcc/p//+//6aWXXlJWVlY7Vtj6evXqpXvvvVdDhgxp0+edM2eOPvroI91yyy3q0qWLwuFwmz6/G++8845+9KMfqXfv3po0aZLC4bC2b9+uF198Ua+99poeeugh5eXluc4XDod17733HnHH7M4771Tnzp3r///tt9/W7bffrv/5n/9RcnLyEeUCABy76AgCaHeDBw/W4MGD27sMR4MGDdLYsWMbPT5kyBBNnTpVTzzxhH7zm9+0fWFtKDU1tclz0NrWrl2rU089VVOmTGnz53brd7/7nfr06aPnn39exx13XP3jkyZN0tixYzVz5kydc845Skpy99abnJx8VOf6m53NVatWKRKJHHEeAMCxjamhABCjCy64QJ07d9a//vWv9i7lmPX111/r+OOPb+8ymlVWVqaCggINGzasQSdQklJSUjRu3DiVlpY6TpMGAKCt0BEE0O6++b2k6dOn6/zzz9eqVat09dVXa+DAgRo+fLjuvvtuVVVVNfjZ4uJiTZs2TWeccYa+853vaNy4cXr55ZcbPceyZct04403atiwYerXr5++//3v69e//nWDkZKDz7to0SKdfvrpOv300/XOO+841p+QkKBOnTopGo02eHzDhg2aMmWKTjvtNA0cOFBXXHGF3n333UY//69//UuTJk3S4MGD9f3vf18PPfSQHn744SbPSVO1uTkH0WhUDz/8sEaNGqXvfOc7Gj58uH7xi19o+/btDeKeffZZXXTRRRo4cKCGDRumKVOmaP369fXHm/qOYG1trebPn69Ro0bVfy/urrvuavA9voM/9/777+u3v/2tvvvd72rgwIG69tprlZ+f3+y5Pfhz27Zt04oVK+q/M3fw8f/5n//RRRddpO985zu64447jrieDz74QP/f//f/6fTTT9e//du/6Y477lBlZaXefvttjR07VgMHDtTYsWO1bNmyZmuUpM6dOysxMVH/+Mc/9OWXXzY6/pOf/ESfffaZsrOzG7wmCxYs0IUXXqgBAwZoxIgRuv/++7V3715JTX9H8Js2btyoYcOG6fzzz1dpaamkht8RnD59uh5++GFJ0rnnntvou4NutMU1diTXPADABlNDAXhSWVmZbrjhBl1wwQW6+OKL9c4772jhwoXy+/2aNm2aJKmkpETjx49XNBrVNddcoxNPPFH/+Mc/9Itf/EI7duzQjTfeKEl67733dNNNN2nIkCH66U9/qoSEBL3//vt6/vnntWvXLj344IP1z7t9+3Y98sgjuuWWW7Rjxw4NGjRIb7zxRou1fvrppyovL9eIESPqH1u7dq2uuuoqpaam6oc//KGOO+44/fWvf9XNN9+s//qv/9Lo0aMlSatXr9akSZOUmpqqKVOmaO/evVqwYIF8vsZ/p2uqNrfn4NFHH9Uf/vAHTZw4sX4BnwULFmj16tX661//qsTERL388sv6zW9+o3Hjxumaa65RWVmZ/vznP+uaa67R3//+d51wwglN/v5Tp07V66+/rpEjR2rSpEnavHmznn32WX344YdavHixQqFQfeyMGTPUtWtX/cd//Id27dql+fPn66abbtI///nPJqdMHvxO4qxZs3TSSSfpRz/6kU455RTt2rVLkjRz5kz9+7//u8aPH6+MjIwjrmf69Onq3bu3fv7zn2vFihVasmSJiouLtWbNGl1zzTU64YQT9Mc//lE/+9nP9MYbbzT42cN17txZo0eP1iuvvKK8vDyNGDFCZ555ps444wx17969yd/tt7/9rZ599ln94Ac/0JVXXqnNmzfriSeeUEFBQX3nrSVFRUWaPHmygsGg/vznPys1NbVRzOWXX66Kigr9/e9/1x133KGTTz7ZMe/h2uoae/XVV11d8wAAQ1EAaCW//OUvo7m5udGtW7e6ivvm/y9YsKBB3AUXXBA988wzG8QNHTo0WlJSUv9YXV1d9Lbbbov2798/WlpaGo1Go9Ebbrgh+oMf/CC6b9++BvkmTJgQHTx4cKPnXbp0aYO4F198MZqbmxtduHBh9Kuvvqr/V1RUFP373/8ezcvLiw4YMCC6adOm+p+5+uqro3l5edE9e/bUP/b1119Hr7rqqujw4cPra5k0aVL09NNPj3711Vf1cZ999lm0T58+TZ6Tb9bm9hxccMEF0ZtvvrnBzz777LPRiy++OPrFF19Eo9Fo9MYbb4yOGTOmQcxbb70VHT16dPSjjz6KRqPR6IcffhjNzc2Nvvjii9FoNBp9++23o7m5udG77767wc+9+uqr0dzc3OicOXMa/Nyll14arampqY977LHHorm5udH33nsv2pIf/OAH0auvvrr+/w/mu+GGGxrEHU09tbW10Wg0Gq2trY1+73vfi+bm5kbffvvt+p994YUXXNVYUVERvfXWW6O5ubkN/o0ZMyb69NNP1z9PNBqNrl+/PnrKKadEZ8yY0SDHAw88EM3NzY2uX78+unXr1mhubm503rx59cdzc3Ojv/zlL6NfffVVdOTIkdGzzjqr0fX1zXM1b948V9dhNNr0tdgW15jbax4AYIepoQA864ILLmjw/3369Kmf/lZXV6c33nhDp512mpKSklRWVqaysjLt3LlTI0eOVHV1td5//31J0mOPPaYXX3xRfr+/PtfOnTsVDAabXFL/tNNOa7Ke//zP/9R3v/vd+n/nnHOOfvKTn6hr16567rnn1LNnz/rcK1as0Nlnn62qqqr62iKRiM477zyVlpbq008/1a5du7RixQpdfPHFDVbB7Nu3r773ve81WcPhtR3JOUhPT9fy5cv15z//uf4cXnHFFQ1WOk1PT9emTZv08MMP13+X7eyzz9bSpUsbrJZ6uDfffFOS9MMf/rDB4xdccIF69uypf/zjHw0eHzlypBITE+v//9RTT5WkJqdTunH66afHVM+5555bP/rq8/n07W9/W4FAQGeddVZ9TGZmpqsajz/+eM2dO1evvvqqfvKTn2jw4MFKSkrS+vXrNXPmTP3Hf/yHamtrJUlvvfVW/Sjb4W644Qa9/PLLLa4+W1FRoRtvvFHbtm3TU089VV+ftfa4xlq65gEAtpgaCsCzvrlFgN/vV11dnaT9HzJ3796tN954o9mpmwe//5aYmKitW7fqwQcf1IYNG7RlyxaVlJQ0+7zf+ta3mnz8hhtu0Jlnnqm6ujrl5+frj3/8o3r06KH77ruvflqiJG3dulWStHDhQi1cuLDZ2jp16qS6ujr16NGj0fGcnJwmv094eG1Hcg6mTZumH//4x7rnnns0a9Ys9evXTyNGjNCECRPUpUsXSdKUKVP0ySef6KGHHtJDDz2k3r17a8SIERo/fnyzHZPCwkKFQqEmpyX26tWr0Xcsm3pNJdW/rkfqm/mOtJ5vxiUlJTXKebCj6LbGXr166ZZbbtEtt9yi3bt367XXXtODDz6of/7zn3r99dc1evRobdu2TZIafGdQkkKhULPTTw/6+9//Lp/Pp7q6Oq1evbr+DxBuVVdX10+tPSgQCDSa+tse11hL1zwAwBYdQQCe1dT35A46OLIyatQoXXHFFU3GfPvb35YkPf7447r33nvVs2dPnXbaaRo5cqQGDhyohQsX6pVXXmn0c4ePWB2ud+/eGj58uCTpzDPP1LBhw3TVVVfpmmuu0eLFi+s/xB6sbeLEic3uG9e7d28VFRVJUoNRlIM6derU5M8dXtuRnIM+ffro9ddf17vvvqt//vOfevfddzVv3jw9+eSTev7559WrVy+lp6frpZde0vLly/WPf/xD7777rv74xz/qySef1BNPPKGhQ4c2yh/9xgI5h6urq2u0gmZLr+nR+OZrdaT1NPVaJyQkHHEdb731lt5//3394he/aPB6nnDCCRo/frxyc3M1YcIE/e///q9Gjx5d/9odjRNOOEGPPvqo7rzzTs2ePVtnnXWWTjzxRNc///HHH2vSpEkNHrvkkks0e/bsBo+1xzVm3T4AAM2jIwigQwqHw+rcubNqamrqO2cHFRUVac2aNercubP27dunhx56SMOGDdMTTzzRYNGOwxewOBrf+c539POf/1yzZs3SjBkz9H/+z/+RJHXv3l3S/g+736xtw4YNKiwsVOfOnes/RBcUFDTK/cUXXzg+v9tzUFtbq/z8fAWDQZ177rk699xzJUmvvvqqpk6dqsWLF2v69Olau3atJNVPfZWk//3f/9W1116rhQsXNtkR7N69u9577z2VlpY2Gl3bvHmzunXr5vh7WGqvej777DMtWLBA5513XpPn6eAiLYFAQJLqR5C3bt2qXr161ceVlJRo1qxZuvrqq5Went7kc+Xl5em0007TjBkzdNNNN+m//uu/NHPmTNe19unTR08++WSDx7p27doozgvXGACg9fCnNwAdUlJSks466yy9/fbbjbYfmD17tqZMmaKdO3eqqqpKe/fuVXZ2doMPqJ9//rlWrFghSaqpqTnqOq699loNGTJE//jHP/Tqq69K2v+hun///vqf//mfBtPjvv76a91555366U9/qpqaGn3rW9/S4MGD9de//rXBVL2tW7e62rbC7Tmora3VpEmTdM899zSIGThwoKRDozA/+9nPNG3atAajVX379tVxxx3X7EjNwZVSH3vssQaPv/HGG9q8ebPOOeccx9/DUnvVM2bMGPl8Ps2ZM6fJzdtfeOEFSarvhJ999tmS9m/XcbglS5bo//7f/6tgMOj4nGeddZbOO+88vfDCC1q5cmWzcQdfu4OjpSeeeKKGDx/e4F/v3r0b/ZxXrjEAQOtgRBBAq5s7d26Tm4FfcMEF9SNPR+P222/X8uXLNXHiRE2cOFEZGRl666239M9//lOXX355/SjMwIEDtWTJEgWDQfXs2VPr16/X4sWL6z8g79mz54im1h0uISFBM2fO1CWXXKLf/e53+t73vqcTTzxRM2bM0LXXXqtLL71UV155pVJSUrR06VL961//0s9//nOddNJJkqRf/vKXuuaaa3TZZZfpiiuuUHV1tRYuXOj6e1Fuz8E111yjRx55RFOmTNH3v/99VVVV6fnnn1fnzp116aWXStr/HcgZM2bouuuu0/nnn69oNKqXXnpJ+/bt01VXXdXk85999tk699xztWDBApWUlGjYsGEqKCjQs88+q29/+9uNFm1pbe1VT3Z2tu644w7dc8899dsf5OTkqKqqSu+//77++c9/6pprrtGQIUMk7V8kZ/z48Vq4cKF27Nih7373u9qwYYOee+45jRs3Tn369HG1+fydd96p9957T3fddZeWLFnSaOqrdOh7d/Pnz9dZZ51V3xl1wwvXGACgddARBNDq/vrXvzb5eE5OTkwdwaysLL3wwguaN2+e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XT3yyCP67LPP5PP5NHDgQN16660adNhE8q1bt2rOnDlasWKFJOmcc87R9OnTFQ6HY68eAAAAADyspqa9K2jM72/6cVcdwRUrVuimm27SySefrKlTp6qmpkbPPPOMrr76aj3zzDMaMGCAdu7cqWuvvVbV1dW68cYbVVtbq8cff1xr167V4sWL5W+uAgAAAABAm3LVEbznnnvUrVs3vfDCC+rcubMkady4cRo9erTmzp2rJ598Uk899ZSKi4v1yiuvqFevXpKkgQMH6vrrr9df/vIXTZgwofV+CwAAAACAa47L2uzatUv5+fk6//zz6zuBkpSamqrTTz9dH3/8sSRp6dKlGjp0aH0nUJKGDx+unj17aunSpa1QOgAAAAB4R23t/umhXvn3jfVhGnAcEQwGg3rttdcadAIP2rlzpxITE7Vr1y5t3bpVo0aNahTTr18/vf3220d2BgEAAAAArcZxRDAxMVHZ2dlKS0tr8Hh+fr5WrlypwYMHq6SkRJIaxUhSly5dtHv3bu3evduoZAAAAABALBKi0Wj0SH9oz549uuqqq7R27VotWLBAxx13nK644grdfffdGj9+fIPYuXPn6tFHH9U777zTZEcRAAAAAI4Fu3dLR967aj0JCdIJJzR97Ij3Edy7d69+/OMfKz8/Xz/84Q81dOhQrVy50kURCUf0POXlUl1d88fDYamszDlPuKroiJ63RcXFZqm2pA4xy5WebpZKhYXOMTk50qZNznGWdSUHWmgMR6io2HEg3LWKCrNUCgScY7KypC1bnONSU2Ov53DJFTvsklkW99e/2uXq3985xm3jT0mJuZx65eV2uQzP/a/vD5nlmvkbF9e3z9fym8IB98y2u77vvGydWS7Tdl9VZZcrGHSOCYWkSMQxrDpg1yb8NZVmuUp2J5vlSuti916kDz90jhk+XPrgA8ewN6uGGxR0yGE7g8UsXOHiTculsmCWWS6npu/3S9XV7nL5K1x8IHXL8LNmybf6muUya/s+u3s0YndEr0YkEtHkyZO1fPlyXXrppZo6daokKTl5/0123759jX7m4GNBN282AAAAAIBW53pE8KuvvtINN9ygzz//XJdffrl++9vf1o/yZWRkSJK+/PLLRj+3Y8cOhUKh+s4iAAAAAByLamtdTWBpMy0NwrrqCFZUVNR3Aq+77jrdcccdDY6HQiFlZmbqs88+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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter3_166_1.png" - } - }, - "output_type": "display_data" - } - ], - "source": [ - "fig = plt.figure(figsize=(20, 14))\n", - "im = plt.imshow(J_sk, **cmap_args)\n", - "plt.title(\"LinearRegression from Scikit-learn\", fontsize=18)\n", - "plt.xticks(fontsize=18)\n", - "plt.yticks(fontsize=18)\n", - "cb = fig.colorbar(im)\n", - "cb.ax.set_yticklabels(cb.ax.get_yticklabels(), fontsize=18)\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The results agree perfectly with our previous discussion where we used our own code.\n", - "\n", - "\n", - "Having explored the ordinary least squares we move on to ridge\n", - "regression. In ridge regression we include a **regularizer**. This\n", - "involves a new cost function which leads to a new estimate for the\n", - "weights $\\boldsymbol{\\beta}$. This results in a penalized regression problem. The\n", - "cost function is given by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "6\n", - "0\n", - " \n", - "<\n", - "<\n", - "<\n", - "!\n", - "!\n", - "M\n", - "A\n", - "T\n", - "H\n", - "_\n", - "B\n", - "L\n", - "O\n", - "C\n", - "K" - ] - }, - { - "cell_type": "code", - "execution_count": 26, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stderr", - "output_type": "stream", - "text": [ - ":10: UserWarning: FixedFormatter should only be used together with FixedLocator\n", - " cb.ax.set_yticklabels(cb.ax.get_yticklabels(), fontsize=18)\n" - ] - }, - { - "data": { - "image/png": "iVBORw0KGgoAAAANSUhEUgAAA4IAAAM2CAYAAACjUj0CAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjMuMywgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/Il7ecAAAACXBIWXMAAAsTAAALEwEAmpwYAAB4jElEQVR4nO3dfXxU5Z3//3cmYRiGYYzZQCBkYww0ImAEVyOyLlpMwYIabAVR1Crqun7pb4uuteh6t66KVitdql/rFqpFgrfLqpXeuG7Xm65Yvj4oVbkVMIQQEoghhBBCSGZ+f0AGYm7OwfkkOWFez8eDR+ucTz7zyZnrnJlrrivXlRSNRqMCAAAAACQMX08XAAAAAADoXnQEAQAAACDB0BEEAAAAgARDRxAAAAAAEgwdQQAAAABIMHQEAQAAACDB0BEEgHbMmzdPp512Wpt/Z5xxhr75zW/q7rvvVlVVVaufmThxoq699lrH3G7jrD3//PM6//zzlZ+fryeeeKLbn9+NxsZG/fu//7suu+wyjRkzRmeddZa+853v6N///d918ODB487X8jq2+NnPfqbTTjtNZWVlHf7M8uXLddppp+lPf/pTq8e3b9/u+HxlZWU67bTT9LOf/ey4awUAoDul9HQBAOBld911l04++eTYf9fV1WnlypX6j//4D3322Wd67bXX5Pf7JUl33323+vXr11Oldmrjxo2aP3++xowZox/84AcaMWJET5fURlNTk2688UatWbNG06ZN05VXXqnm5mZ9/PHHevLJJ/WHP/xBS5YsiZ1vN6688kqdd955x1XHOeecox//+McaNmxY7LEbb7xRAwcO1KOPPnpcuQAA8Co6ggDQicLCQmVlZbV6bNasWXrggQf04osv6p133tGUKVNisV61adMmSdItt9yiiRMn9nA17fvtb3+rVatW6Wc/+5kmTZoUe/y6667TokWL9Pjjj+u1117T1Vdf7Trn2LFjNXbs2OOq46//+q/113/9160e++Mf/6jLL7/8uPIAAOBlTA0FgK+hpVPwl7/8pYcrcefQoUOSpP79+/dwJR3785//LEn627/92zbHrr76avXp00dr1qzp5qoAADgx0REEgK+hZQpoNBqNPdbe3/795je/UVFRkfLz83XJJZfov//7v9vN995772n69OkaM2aMLrroIhUXF+uf//mf24zebd68WXPmzNHZZ5+tM888UzNnztQHH3zQaa3XXnut7rrrLkmHR9da/mbu2muv1Y033qgFCxZo7NixOu+887Rx40ZJh6eS/p//83909tlnKz8/XzNmzNA777zTJu8tt9yid955R5dddpnOOOMMTZ06Ve+9957q6up033336ZxzztF5552n++67Tw0NDZ3W2dJJffnll9scCwaDWr16tX784x+3enzLli36wQ9+oHPPPVd/8zd/o2uvvVYff/xx7PhX/0awPQ888IBOO+00Pf/885Ja/41gy9/8SdJ//ud/tvu3g24sX75c06ZN0xlnnKFx48Zp3rx52rVrV6uYuro6/eQnP9HFF1+sM844Q2PHjtWMGTNatZmWep5//nldddVVGj16tK6//vrY46+//roWLFigCRMm6IwzztD06dP10UcfHXe9AIATH1NDAeBraOl8jRw5ssOY5cuX66677tLYsWP1wx/+UNu2bdPcuXOVlJSkoUOHxuL+53/+R3PmzFFeXp5uu+02VVZW6tFHH1UwGGw1grdx40ZdffXVSk9P1y233KI+ffrorbfe0t///d/rJz/5SWyK6lf9wz/8g0499VS9/PLL+od/+Afl5ubGjq1evVrbt2/XD3/4Q5WVlWn48OH65JNPdN111ykUCumGG25Q//799cYbb2jOnDm67777NGvWrNjPr127Vn/+85913XXXacCAAXr22Wc1d+5cnX766erXr59uv/12ffzxx3r55Zc1aNAgff/73+/wfF122WV67rnn9Nhjj2n58uUqLCzUeeedp7Fjx8rv97f528CSkhLNmDFDKSkpuuaaa5SWlqaXXnpJN9xwg4qLi5Wfn9/hc7X46U9/qhdffFG33Xabrr/++jbH09LS9OMf/1h33nmnzj77bM2YMaPV3w668dRTT+lnP/uZJk+erBkzZqiyslJLly7VqlWr9NprryktLU3RaFS33HKL1q1bp2uuuUbZ2dmqqKjQSy+9pO9///t6/fXXW3Vo/+3f/k0TJ07UpZdeqr59+7Z6vF+/fpo9e7YOHTqkX/7yl7rlllv07rvvtvpbVwAAFAUAtPGjH/0ompeXF127dm30yy+/jP3btm1bdOnSpdExY8ZEv/3tb0cbGxtjP/PNb34zes0110Sj0Wi0qakpet5550W/+93vtor5j//4j2heXl4sLhqNRgsLC6OTJk2KHjhw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zJkzVVRUpOrqai1ZsqTNdNF77rlH3/ve9/Td735XV111lVJTU7VixQr95S9/0T/90z+ZbQ/Q8jxXXHGFrrrqKvXv319vvvmm1q5dq3vuuUfhcNjkeb5q3rx5+uSTT3TnnXfqzTff1N/93d8pFAqptLRUy5cv16FDh3TffffF4v/pn/5J06dP1/Tp0zVr1iyFQiG98sorqq+v19y5c10958iRIzVz5kwVFxdrxYoVmjp1artxaWlpWrVqlV555RWdf/75yszMdJU/Ly9P1157rV544QXV1NSosLBQNTU1Wrp0qfr3768f/OAHkqQJEybohRde0C233KIrrrhChw4d0m9/+1t99tln8vl8bRaLAQAgXowIAsDXMH36dP3N3/yN/vjHP+r1119vN+ab3/ymnn32WQUCAT355JN655139PDDD7daDVSSLr74Yi1YsEBNTU16/PHH9dZbb+muu+7S6NGjW3UGx44dqxdffFGjR4/Wc889p8cff1wHDhzQo48+qr//+783+91anmfUqFH65S9/qX/7t39T37599fTTT+vaa681e56vSktL0/Lly/WDH/xANTU1evrpp/XAAw/orbfe0qRJk/TrX/9aOTk5sfhhw4bp5Zdf1hlnnKFFixZp4cKFGjRokJYtWxabeuvG3Llz9Vd/9VeaP39+m+meLe644w41NTXpX//1X9v8baCTf/7nf9b999+v6upqPfbYY1q2bJnOPvtsLVu2LLYAz4QJE/TQQw/FXs9FixYpNTVVL7/8sk4//fSvtYk9AACdSYq6XcYNAGCuublZe/fubXcVyEsvvVThcFjFxcU9UBkAADiRMSIIAD2oublZEyZMaDXlUZI2btyozz//XPn5+T1UGQAAOJHxN4IA0IP8fr8uvvhivfbaa0pKStLo0aO1a9cuvfjiizr55JN1ww039HSJAADgBMTUUADoYQ0NDVq8eLHefPNN7dy5UwMGDNB5552nuXPnxvYwBAAAsERHEAAAAABOULW1te0uhkZHEAAAAADidKC6Wv3aWfytpzU0NGjChAnau3dvq8e92xE8ZuPedvl8zjGS/vVhu/Vw7v1Ro3OQSwea/c5BLlVXm6VSByunt3L66dL69S7ihtmdL0uVe+zOfUbTDrNcam52jsnOlkpLHcO2NmUbFHRUbv9K5yCXavpmmOVKDdq1sfc/cm4XEyZI77/vnOvIjgAmhjY7v95u7TvZrl0MWGe3nUFlzrmOMRkZUqWLZpgRPmBQ0WH7mvqZ5Wpnr/mvzb9ujVmuA6eNcYzp10864OK09uvr/J7cE3bstPscMHCgWSpX/H6p0cVtzr/H7h4tSY0n292nLWszff8oWdN5wJgx0hqHmBaWi3rt3GmWqnHgULNcHeySdFyCQemSS+LP43W/PP981ZaV9XQZMeGsLM3+4x+1c+dONX/ls+YJv1jMnj09XUH7LLvfbvoPbh06ZBvnRZbnyzRZU5NZnNtUrhn+ni6+v+kRDQ12caZtzPDFNP3a7+BBs1Ruz5erOMNf0qNfk7rrGbjk9nf07LlwwfR69Cov/5Jeff9wcx0ZXmuuefS1rKvr6Qp6j9qyMu3dtq2ny2hjyJAhbR5j+wgAAAAASDDmHcHt27fr+9//vgoKClRQUKA777xT1ZZzFwEAAADAg3we/NcR06mhe/bs0fe+9z01NjbqpptuUnNzsxYvXqyNGzfq1Vdfld9v97dZAAAAAICvx7Qj+Pzzz6uiokK//vWvNezIaglnnnmmbrjhBr3++uuaMWOG5dMBAAAAAL4G06mhK1asUEFBQawTKEnjx4/XqaeeqhUrVlg+FQAAAAB4Sk9PAz2eqaFmHcG9e/dq+/btGjVqVJtjo0aN0tq1a62eCgAAAAAQB7OOYOWRDZ4yMtru8TJw4EDt27dP+/bts3o6AAAAAMDXZPY3gvv375ck9evXdgPevkd20q2vr9eAAQPcJfS56KO6iHnySXdP547dYjdBw3Vzsg33Dneby93eqd5cHCgz0zKb7cbtruTmOobkmT+p3UlLM8skWbaxSZNs4+w4v95uhc0ySZowwSyV29bl7toNxlFJa6bny1JBgVkqt2cr6CrQmztSWb5H9gRX6+zZvrHZvnsb1mb6/uHmOjK81lwzbLCWr+Ps2YbJTnBO0zG7W7esGhp1sdtsUlKS+4ROu4b6fK52Fr39DruX4slH7TYWrW+yuzyrqsxSqabGOSY/X/rkExdxI3pgI1YXyqvszn1mU6lZLlcbh+fmSlu3OoZtarLrPEhSXqjcLFd1wPBDQciujb39rnO7mDRJevtt51wjRhgUdER2k/Pr7VZtumGncs37ZrnKhzt3KjMzpXIXzTAztd6gosNqm+w6lYGAWSr516wyy1U/2vmDbjAo1bs4rcGA5W7fdkrL7D4HDB5slsoVv9/dnub+Krt7tCQ1ptvdpy1rM33/2OxwHRUUSKtcXmtnnx1/QS3KysxSNQ6261QuXRp/jlBIYt1IbzG7OwaPfF148ODBNsdaHguFQlZPBwAAAAD4msxGBDOPDP3v3r27zbFdu3YpHA7HOosAAAAAcKJJkremhnY2H9OsznA4rKysrHZXB123bp1Gjx5t9VQAAAAAgDiYdlgnTZqklStXasuWLbHHPvzwQ33xxReaMmWK5VMBAAAAAL4ms6mhknTzzTfrjTfe0PXXX6/Zs2fr4MGDWrRokUaNGqWioiLLpwIAAAAAT+lNq4aa1pmWlqalS5dqxIgRWrhwoX71q1+psLBQixYtkt/V+scAAAAAgK5mOiIoSbm5ufrFL34Rd55/fdinPXs6Pv7kk+62hnjyCbvlrO+cZ9eZnTfPLJVSDF/FfLnYF0L5ruJqG1xtNuiKm20t3Mou+9Au2bhxZqnqG5zbc1BS/WAX+wjW7TKo6Kj6kOGS3YZLzJdX2F2Tbl9KN3ElJXGV0kr26ByzXOEmu+02SnPs9hHMdrUNS7a77VpS7Nb3D1fYbd1huSS8xowxS7VmjXPM+PEu40bUxFnNMQz328je/JFZrk0NE81y5Q13cy/0yZ/iHFfaZLuPYHaZXduP5NhtW1NTYpZKaW4+PLn8gLW1xG5cJSfHbsuHzRvMUmn29Vbv3V4aK4N5RxAAAAAAElHCTg0FAAAAAHgfHUEAAAAASDBMDQUAAAAAA0wNBQAAAAB4Fh1BAAAAAEgwTA0FAAAAAANJ8tZIW1Inx7xUJwAAAACgG9ARBAAAAIAEw9RQAAAAADDAqqEAAAAAAM9iRBAAAAAADCSp8wVauhuLxQAAAAAAYugIAgAAAECCYWooAAAAABhIPvLPKzqrhRFBAAAAAEgwdAQBAAAAIMEwNRQAAAAADCTJWyNtna0amhSNRqPdVsnxaGzs/Ljf7xwj6c57/EYFST9+NGKW69Y5dk3k4YfNUikUco5xeerlr9kVf0EtamrMUjXm5Jnl8qfYtYmIi9uGzydFXDxlSUn89Rwrt2mTWa5PGuzOf37DKrNcGjzYOSY7WyotdQxb9sdsg4IOu3pavVmuxpSgWa6GBrNUCpd84hyUny994iIuPT3+grpAbSjTLFc4ZHffUV2diycMS7W1jmHrysIGBdkbMcIul0+G597NRRQMSvUu7gFlZfHXc6xAwCzVh2V298OzzzZL5fwZZdAgaZfLzzEphuMqbq5Jlyr72p37AQPiz5GUJPXrF38eryvOyVHdtm09XUZM6JRTNKuDD4Ze6rACAAAAALoBU0MBAAAAwIBP3hpp66wWL9UJAAAAAOgGdAQBAAAAIMEwNRQAAAAADDA1FAAAAADgWXQEAQAAACDBMDUUAAAAAAwwNRQAAAAA4Fl0BAEAAAAgwTA1FAAAAAAMJMlbI21JnRzzUp0AAAAAgG5ARxAAAAAAEgxTQwEAAADAAKuGAgAAAAA8i44gAAAAACQYpoYCAAAAgIEkdb5SZ3dj1VAAAAAAQExSNBqN9nQR7TlwQOqssmBQqq93ztPQYFfTP/+zXa5nno6Y5XrkUbv+/N037XIOGjRI2uUc9+HmQQYVHTZ+jIsX263f/c4s1eqc75jlOqtplXNQQYG0yjkucnaBQUVH+TZvMsvVmJNnlstfVW6W65OqTMeY/Hzpk0+cc+WPtru+I4bf1zU1maWSP8XudyyvcP4dMzOlchcvd2ao1qCiw2oVNssVll1dkZBdXW74fFLExcvta2o0e851m/1muUaOsGurph8qUlxMyvL7pUbn82p5viRpZKrdvdXynNWm55rlCocc2oXbhm/N8EZdWmHXLrLr1sWfpE8f6RvfiD+Px/1nTo72b9vW02XE9D/lFF1eUtLuMaaGAgAAAICB5CP/vKKzWpgaCgAAAAAJho4gAAAAACQYpoYCAAAAgIEkeWukjVVDAQAAAAAxdAQBAAAAIMEwNRQAAAAADPjkrZG2zmrxUp0AAAAAgG5ARxAAAAAAEgxTQwEAAADAAFNDAQAAAACeRUcQAAAAABIMU0MBAAAAwABTQwEAAAAAnkVHEAAAAAASDFNDAQAAAMBAkrw10pbUyTEv1QkAAAAA6AZ0BAEAAAAgwXh2amh1tdTc3PHx7Gypqso5T4rhb/jww3a5HnnUrg9+97yIWa6rrxnkGLNsmXT1XBdxP91lUZIkqbzG+fncqhnxHbNcAbNMknJGu4sb7Rznq6mOs5iu4//ofbNcjeMmmOXKbyp1EZWt/FTnuIiy4y/oiLo6s1RqarLLlRayS5aa6ncZ5yIoxe6qDDfUmuVSTY1Zqj+uCZvlOv98s1S2DUzu2kR3e//joFmu4cOdYzIzpfIq53MxMrDVoKKjakO5ZrnC6Y1muSpKzFIpXPNx5wEFBdLHDjFHRM4uMKjosJo6u7Zv+f6xNTAy7hwpKTJ8d/QuVg0FAAAAAHgWHUEAAAAASDCenRoKAAAAAL1JkjpfqbO7sWooAAAAACCGjiAAAAAAJBimhgIAAACAgeQj/7yis1oYEQQAAACABENHEAAAAAASDFNDAQAAAMBAkrw10saqoQAAAACAGDqCAAAAAJBgmBoKAAAAAAZ88tZIW2e1eKlOAAAAAEA3oCMIAAAAAAmGqaEAAAAAYICpoQAAAAAAz6IjCAAAAAAJhqmhAAAAAGCgN00N9WxHsLZWOnSo4+PZ2VJNjXOefH1iVlPjiHyzXHfftMss19XXDDLLtWxpxEWUz1Xc7XfY1fWjH5ml0sgRbn5HlxoazFJtrQg6xuTmuosrK3OOOR4TRtvlaszJM8tVVWWWSk3KdozJllTqJq7K7voOpdtdRyUlZqmUlmLX9ssq/I4xeXlSWZlzrrz0OoOKDqtNSTPLVaOwWa4Uw3fuNWucY846y11cerrdfWfwYLNUqq2z+0iWmmqWSsnJhnGWhUkKhQyTlVWYpTrpJOf7r1vV6QWdHk+TVD2885hY7B/fN6joSK4xY8xyBXLs7jsVdi8jesjOnTvV3Nzc6jHPdgQBAAAAAPGbNWuWduzY0eoxOoIAAAAAYCBJ3poamnTkf4uLixkRBAAAAIBEMmTIkDaPeanDCgAAAADoBuYjgldccYU+/fTTNo9PnjxZCxcutH46AAAAAPCEhF01NBqNasuWLSosLNSkSZNaHRs6dKjlUwEAAAAAvibTjmBZWZnq6+t10UUXqaioyDI1AAAAAMCIaUdw8+bNkqRhw4ZZpgUAAAAAz0vS0ZU6vaCzWkynsH7++eeSjnYE6+vrLdMDAAAAAAyYdwT79++v+fPna+zYsRo7dqwKCwu1YsUKy6cBAAAAAMQhKRqNRq2SXX755Vq3bp0mT56sSy+9VLW1tVqyZIk2bNigxx57TNOmTbN6KgAAAADwlNU5OTq4bVtPlxHT95RTdFZJSbvHTDuCL774oiKRiGbNmhV7rKGhQZdccokOHDig999/X8nJya5yrV8vHTrU8fH8fOmTT5zz5MtFkEuNI/LNcvlrdpnlunruILNcy5ZGnIN8PiniHHf7HXYDzj/6kVkqZQx08Tu61dBglmprRdAxJjdX2rrVOVdZmUFBx5gwutosV2MozSxXVZVZKjU1OcdkZ0ulpS7iAnbXdyTd7vru4H3ga8lNrzXLtaki7BiTlydt2uScKy/drq3Wpti11Zoas1Sm13cg4Bxz1lnS6tXOcenp8dfTIhSyy5ViuBqC5TWUkeEuprLSRVwfu3YvSZFUu7bvK3Nx03Spsm+2Wa4+fTo/npYmVbs8rWmfvR9/QS3GjDFLVZ/ifG91q6Ii/hwpKYffR090vakjaDo19KqrrmrVCZSkQCCgoqIiVVVVxRaTAQAAAAD0HPMN5duTlnb4myUWjwEAAABwokqStzaU75ZVQysrKzV16lQ99dRTbY598cUXkqSsrCyrpwMAAAAAfE1mHcGMjAzV1tbq1VdfVV1dXezx8vJyLV++XOeee64GDhxo9XQAAAAAgK/JdGro/fffrzlz5mjmzJmaPn269u/fr+LiYqWkpOj++++3fCoAAAAA8BSfvDU1tLNaTOssLCzU008/rX79+umJJ57Qc889pzFjxujFF1+MbTIPAAAAAOhZpttHmGps7Py43+8cI6m2wW9UkBRusFsS/sPNdkvCjx9uV9ftjzrX9eST0u23O+d68gm7bRrunGf3ncU//ZNZKsflp49HWo2LfSFc7h+xqSnXoKKjBg+2yxUOOF+3rrnZ88EtN+v7Z2ZK5eXOcRs2xF1Oi9qzJ5rlCtfYLeNu2Sga5XyfdnnLl18ebV+Ge51EsuzWX/fJbssgy/Plpk24tWePWSplDLBb9C4ScN4yyO2pP+YvckxYbBXQIifHLpfllkGZf3yl84AZM6RXHGJaXHhh3PV0CcP3IpNtLZKSpAED4s/jcX/JyVGjh7aP8J9yis7sYPuIblk1FAAAAABOdAk7NRQAAAAA4H10BAEAAAAgwTA1FAAAAAAMMDUUAAAAAOBZdAQBAAAAIMEwNRQAAAAADCTJWyNtSZ0c81KdAAAAAIBuQEcQAAAAABIMU0MBAAAAwACrhgIAAAAAPIuOIAAAAAAkGKaGAgAAAICBJHW+Umd3Y9VQAAAAAEAMHUEAAAAASDBMDQUAAAAAA8mSIj1dxDGSOznGiCAAAAAAJBg6ggAAAACQYJKi0Wi0p4toV2Nj58f9fucYSaUVfqOCpOyGTWa5lJVllqq8JmiWK7mz8eMjMjKkykrnuJ/8JP56Wvz4UbtB9n+ca/f9x8yZZqk0eLBzTG6utHWrc1xOTtzltFJXZ5cr3LDLLlkoZJcrxcVMeZf3nU822N13DG8VSgvUm+UqrbK772Rnubi+fT4p4iLuo4/iL6jF8OF2uQzbauU+u3P/pz85x1x2mfTmmy7iLqyNv6AWTU1mqUrr0sxyZafa/Y6VB8KOMW7fbwcONCjoGL4SF280LlX2zzXL1a+fWSrHS9LtLUeSfGWl8Rd0RH16tlmuigqzVMpNN2j7SUnSgAHx5/G4LTk5atq2rafLiEk55RQNKylp9xgjggAAAACQYOgIAgAAAECCYdVQAAAAADDgk7dG2jqrxUt1AgAAAAC6AR1BAAAAAEgwTA0FAAAAAANMDQUAAAAAeBYjggAAAABggBFBAAAAAIBn0REEAAAAgATD1FAAAAAAMJAkb420JXVyzEt1AgAAAAC6AR1BAAAAAEgwTA0FAAAAAAM+SdGeLuIYrBoKAAAAAIihIwgAAAAACYapoQAAAABgIEmdr9TZ3Vg1FAAAAAAQkxSNRr3094wxlZVSc3PHxzMzpfJy5zyZJR+a1dR49nizXP63lpvlWjfiO2a5Ro6IOAf5fFLEOa5yt933DA8/bJZKC3/q4nd0acZMu9/xlZfszn3E+DuesjK7XCmG8xAyQ7V2yWpqnGOys6XSUue4rKy4y2lRW+fN7+vCIbvrqLTM+Xd0e+pDIYOCjkhNtctVV2eXK9xUbZfMzQnz+6XGRsew+ia/QUGHBRvsfsdNVWlmufJCLj54WHL5Yae0KdP0abMHO7/ebr3/kV27OP98s1SO12Q4LNW6fIsJf/yH+AtqMWKEXa6SErtcFm/efr80Zkz8eTxuZ06Omrdt6+kyYpJPOUVDOmgLTA0FAAAAAAPJPV3AV3RWjze/agYAAAAAdBk6ggAAAACQYJgaCgAAAAAGkuStkTZWDQUAAAAAxNARBAAAAIAEw9RQAAAAADDgtVG2zurxWq0AAAAAgC5GRxAAAAAAEgxTQwEAAADAgNdG2ZgaCgAAAACIoSMIAAAAAAmGqaEAAAAAYMBro2xMDQUAAAAAxNARBAAAAIAEw9RQAAAAADCQJG+NtCV1csxLdQIAAAAAugEdQQAAAABIMJ6dGprRtENqbu4kIluZTaXOicaNM6vJr4hZrtU53zHLFTDLJKmhwTkmGHQV16dP0KCgw2bONEulGTPtvv945SW7NvHIo8513X23u7g77rCo6KisLLtcvs2b7JKFBpulqk/PdowJuoyrqTAo6IhQyC5XVZVdrvDH75rlqkmf6BiTnS3V1Djnyg7sir+gFk2pZqlCIb9ZLtUZvnU3NTnH+P2u4hoa7H7HYIXdRZSXY/guWVJjlqo8daRjTKakcmU6xpm2e0n6aINZqtGjJ5jl8n28yixX+OyznZ5N4ZC79/gPA873MLfGq9wsl+VnYFc3YCe+xBh/8kmK9nQRx2BqKAAAAAAgho4gAAAAACQYz04NBQAAAIDehKmhAAAAAADPoiMIAAAAAAmGqaEAAAAAYICpoQAAAAAAz6IjCAAAAAAJhqmhAAAAAGAgSZ1Px/QSRgQBAAAAIMHQEQQAAACABMPUUAAAAAAw0JtG2XpTrQAAAAAAA3QEAQAAACDBMDUUAAAAAAz0plG23lQrAAAAAMAAHUEAAAAASDBMDQUAAAAAA71plM27HcHmZqmpqfMYp+OS6hvsXo5AwCyVzmpaZZcsZ7RZqq0VQceY3FyXcdpqUZIkafDgXLNcr7wUMcv1yKN27evueW7q8rmKs6xLclubO/VZeWa5gg3VdrlS6t1EKSjnuMBg5+vDrd27zVJp8GC7XOWBiWa50t3GuQm0vFGXlJil2n2SXbsfODBslstXUe4cFAxKNTWOYWlyjnGrPHWkWa5Ag1kqpRm2r8xQrYuosLu4lFDc9bRy/vlmqdLq3PyeLmVlmaWqrev8fTIcdo5p4ere5JZhGysts/sskN1QFX+SlBQpNTX+PDDj3Y4gAAAAACBuO3fuVHNzc6vH6AgCAAAAgIGkpCQpKamnyzjqSC2zZs3Sjh07Wh2iIwgAAAAAJ7Di4mJGBAEAAAAgkQwZMqTNY1+rI3jvvfeqpKREL7zwQqvHt2/frscee0yrVh1eCOXCCy/UvHnzlJaW9nWeBgAAAAB6j5SUw/+8opNajrvKV199Va+88ooKCgpaPb5nzx5973vfU2Njo2666SY1Nzdr8eLF2rhxo1599VX5/f7jLxwAAAAAYM51R7C5uVnPPPOMnnrqqXaPP//886qoqNCvf/1rDRs2TJJ05pln6oYbbtDrr7+uGTNm2FQMAAAAAIiLq47gwYMHNX36dG3cuFHTpk3TypUr28SsWLFCBQUFsU6gJI0fP16nnnqqVqxYQUcQAAAAwIktOdlbU0OTkzs85GqnyYMHD6qurk4LFizQY489ppSv/HJ79+7V9u3bNWrUqDY/O2rUKK1du/Y4KwYAAAAAdBVX3dVQKKS33367TQewRWVlpSQpIyOjzbGBAwdq37592rdvnwYMGBBHqQAAAAAAC646gj6fTz5fx4OH+/fvlyT169evzbG+fftKkurr64+vI5id7RyTm+sYEnT/jN3rK4vteIWLU3occS6TdWsmyeVAuCt3322WSq7r6uRabGFbl2R5zoKWF2WwB1YkdvEL2J0tqZ3v1zzB9HV0KTPTTVTY7gnDdrk8+jK6Panu44x077MdhzTbdyNXDNthj7Cs3zCXm0xun872JbJ7X8s2fYvMs0x2YjuRVw1tTzQadYxJOrKrvWulpVJTU8fHc3OlrVsd09QPtrtpBwJmqeT7eJVdstGjzVJtrXD+dOfy1CtXLoJc2mrZqcyJmOV65FHDTuU8F3X5fFLEOc6yLsllbS7VNxh2KhuqzXK5usCDQam+3jEsErDrJe3ebZZKlpMyamrscrmRmSmVl7uIC9XaPWlFhVmqypPsPkQNHGiWSr4KNyfV5ck3VG7YFbR8706rsXtfU3q6c0w4LNW6aNPWHzotT1pdnSdz1YY6b2NuT71keqtQXrrd+1ppnWGnsmFT/ElSUtyPOKBbmHwiCx75avjgwYNtjrU8FgqFLJ4KAAAAABAnk6+QMo9MGdndzlfXu3btUjgcjnUWAQAAAOCEdKKtGuokHA4rKyur3dVB161bp9GGUxcBAAAAAPEx+2OdSZMmaeXKldqyZUvssQ8//FBffPGFpkyZYvU0AAAAAIA4mY1b3nzzzXrjjTd0/fXXa/bs2Tp48KAWLVqkUaNGqaioyOppAAAAAMCbetGqoWYjgmlpaVq6dKlGjBihhQsX6le/+pUKCwu1aNEi+f1+q6cBAAAAAMTpa3VX//CHP7T7eG5urn7xi1/EVRAAAAAAoGt5aNyyta1N2Z1uI5gnaVOT814keXW77GqqGGSWK+dsuw3lfTV2e86UlbnbR7CszDlXk+EejsOHm6VSxHC77zvuMEvlau+/u+92GWe4758k3TrH7pzdeqtZKo0YYbdHUkODc0xYUm2T8zUSlt35zxjgojC3OrupHqdgjYubgEu1WSNdxbnahchyzzLDvdQykuzeiyQX+8+5lZpqFteYYrc6eMVnZqlcbdfnVprhBppu9jkOSqpPcd6tPFhValDRMSxPmuUmezk5ZqnCdU6fndIUbnL3+erASXbvRZFUu1xNNWapVJ0e/16oPp+UGn8p3pdoq4YCAAAAAHoPOoIAAAAAkGA8NG4JAAAAAL1YIq4aCgAAAADoHegIAgAAAECC8dC4JQAAAAD0YqwaCgAAAADwKjqCAAAAAJBgPDRuCQAAAAC9GKuGAgAAAAC8io4gAAAAACQYD41bAgAAAEAvxqqhAAAAAACvoiMIAAAAAAnGQ+OWAAAAANCLsWooAAAAAMCr6AgCAAAAQILx0LglAAAAAPRivWjV0KRoNBrtxlLcq6yUmps7Pp6ZKZWXO6apT800KylYtsksl2elpzvHpKVJ1dWOYbUpaQYF2aupscuVlWWXy6eIiyCfFHGOu3WO7WD/M0+7qM2lu++xq+2BB8xSyd9Q6xwUDku1LuKamuIvqIVlg01NNUvVGLK7vv0Vpc5B2dlSqYu4UCj+grog19Yyv1muQMAslTJT652DgkGp3kXcmjVx19OiPGe8Wa7MOsP3bsM20Zju/PnE75caG51zbdhgUNAx8kfb3fPrG+zu+cEUFyfDLaf7tNt2L+mTzUGDgg7LH7zLLNe6qkFmuYYPt8njt7sVetfUqdLOnT1dxVFDhkgrVrR7iKmhAAAAAJBgPDRuCQAAAAC9GKuGAgAAAAC8io4gAAAAACQYD41bAgAAAEAv1otWDWVEEAAAAAASDB1BAAAAAEgwHhq3BAAAAIBejFVDAQAAAABeRUcQAAAAABKMh8YtAQAAAKAXY9VQAAAAAIBX0REEAAAAgATjoXFLAAAAAOjFWDUUAAAAAOBVdAQBAAAAIMF4aNwSAAAAAHoxVg0FAAAAAHiVh7qrrdX0zVAk0vHxNEnVgUzHPGmBTpIcp08a8sxyjRhhlkr+j943y9WY4/w7+iU1htIc48JqNKjoiJoas1R1KYPMcvk2bzLLVZ/lfO6DQam+wfn7m1tvtajoqLvvsfvO6JGH7K7JGTPt6nrppbBjjE9SJOQmzu53VCBgl6ukxCyVXxVmuTR8uLu4wYOdYxoa4qvlGOs2+81yjQyVmuWKDM62y6WgY4xPUiTgIi41Nf6CjsgcbHgNfWbXJtzcp11rcg7x+6UmF3H5WdXx13OsBrv7TtBwZKS6zu6aTGuo6jwgGHT92SM/y66Nqc4u18gRdtfR1pL4329TUqRsu9sXDHi2IwgAAAAAvQqrhgIAAAAAvMpD3VUAAAAA6MVYLAYAAAAA4FV0BAEAAAAgwXho3BIAAAAAejEWiwEAAAAAeBUdQQAAAABIMB4atwQAAACAXoxVQwEAAAAAXkVHEAAAAAASjIfGLQEAAACgF2PVUAAAAACAV9ERBAAAAIAE46FxSwAAAADoxVg1FAAAAADgVXQEAQAAACDBeGjcEgAAAAB6sV60aqiHqmwtNdjoEOFXWsgpRiqv8NsUJCm/YZVZLlVlmaVqHDfBLFdVlXNMZqbLuNSm+AtqEQqZpcpsqjXLpdBgs1TBhmoXQWmu4kaMSDOo6KgHHrDLNWOm3USEV16KmOX65fPOdc2eLT3/vHOucePsfsecnKBZrqDlG1N6ul2ud991jpk0yVVc44WT4i6nK0Syss1y+T77xCxXbU6+Y0w4LNXVOecKG9QTs3mzXS7D94+g6s1yvf+x87U9YYL08cfOuSaMNijoGNUNdvedtFS7+3RayWqzXPUjzur0eFBSfWqmq1yWt1a/YXtVQ4NZqtycgFEmJiN6Ca8GAAAAACQYz44IAgAAAECvwqqhAAAAAACvoiMIAAAAAAnGQ+OWAAAAANCL9aJVQxkRBAAAAIAEQ0cQAAAAABKMh8YtAQAAAKAXY9VQAAAAAIBX0REEAAAAgATjoXFLAAAAAOjFWDUUAAAAAOBVdAQBAAAAIMF4aNwSAAAAAHoxVg0FAAAAAHgVHUEAAAAASDAeGrcEAAAAgF6MVUMBAAAAAF6VFI1Goz1dRHvef19qaOj4+KRJ0ttvO+cZN86upnBNqVmuT2qyzXLlp9rVVSrnurKzpVIXT5mdUm5Q0RHp6Xa5KirMUtWn272OQdW7CApK9c5xtU1Bg4qOCqvWLFckFDbL9fzzZqk0+/qIc5DPJ0Wc426/w+47tieeMEtlqqbGLlda0y7noEGDpF0u4pqa4i+oheV9x5Lh77iuxPleMXKktG6dc66cnPjraWHZvjpZJ+G4ZfzFxQcPt9x8QAmHpVoX91/r0QfDF6A6kGmWK63B8HNFamrnx12+30rS6g1277lnhTaZ5VrXlGeWKysr/hxJSdKAAfHn8bwnn7S9icUrNVW6/Xbt3LlTzc3NrQ55aNwSAAAAAHoxj64aOmvWLO3YsaPVIQ9VCQAAAACwVlxczIggAAAAACSSIUOGtHnsa3UE7733XpWUlOiFF15o9fgVV1yhTz/9tE385MmTtXDhwq/zVAAAAADQO/SiVUOPu8pXX31Vr7zyigoKClo9Ho1GtWXLFhUWFmrSpEmtjg0dOvR4nwYAAAAA0EVcdwSbm5v1zDPP6Kmnnmr3eFlZmerr63XRRRepqKjIrEAAAAAAgC1XHcGDBw9q+vTp2rhxo6ZNm6aVK1e2idm8ebMkadiwYbYVAgAAAEBv4NFVQ9vjarOrgwcPqq6uTgsWLNBjjz2mlHZ+uc8//1zS0Y5gvcu9VwAAAAAA3ctVdzUUCuntt99utwPY4vPPP1f//v01f/58/eY3v1F9fb3++q//WrfddpumTp1qVjAAAAAAID5J0Wg0erw/NHHiRA0dOrTVqqGXX3651q1bp8mTJ+vSSy9VbW2tlixZog0bNuixxx7TtGnTLOsGAAAAAG9ZtEiqre3pKo4Kh6Wbbmr3kNkE1hkzZigSiWjWrFmxx6ZOnapLLrlEjz/+uC699FIldzJH9avef19qaOj4+KRJ0ttvO+cZN871UzoK15Sa5fqkJtssV36qXV2lcq4rO1sqdfGU2SnlBhUdkZ5ul6uiwixVfbrd6xiUi+nUwaDkYtp1bVPQoKKjwrK7oUVCYbNczz9vlkqzr484B/l8UsQ57vY7XM26d+WJJ8xSmaqpscuV1rTLOWjQIGmXi7impvgLamF537Fk+DuuK3G+V4wcKa1b55wrJyf+elpYtq/j+OjhKOMvLj54uOXmA0o47O4DpfXfIxm+ANWBTLNcaQ2GnytSUzs/7vL9VpJWb7B7zz0rtMks17qmPLNcWVnx50hKkgYMiD8P7Jh9WrnqqqtadQIlKRAIqKioSFVVVbHFZAAAAAAAPavLl7RJS0uTxOIxAAAAAE5wJ9qqoU4qKys1derUdvcY/OKLLyRJWRZjygAAAACAuJl0BDMyMlRbW6tXX31VdXV1scfLy8u1fPlynXvuuRo4cKDFUwEAAAAA4mQ2bnn//fdrzpw5mjlzpqZPn679+/eruLhYKSkpuv/++62eBgAAAAC8KSXFW1NDO6nFbLGYwsJCPf300+rXr5+eeOIJPffccxozZoxefPHF2CbzAAAAAICe97W6q3/4wx/afbywsFCFhYVxFQQAAAAA6FoeGrdsbdgwqbm585gRI5zzlJSYlCNJ+uwzuz3jrp7pYs8ylyIu9v5zK7vKxT5dGqTsgIu4zzbEXU+LT9InmuXKH223cFGN3ZaECgx23ofIJykScI4Ly659SZJq7PYt8xnWNm6c3X59bvb+e/JJl3FP2P2O/zjX7nd86CGzVAqF7HKpyWUyF0/q5vpwy3LXo7ycRrtkhty8j7qN81XY7fEW7Gwj4eMVCNjlstyc2M3vGA67izO9IGW6V6VtaXavZXVD5/eKtKBzTIuzcqotSjqszu53HCm7faarm+L/rOmzezvztkRbNRQAAAAA0HvQEQQAAACABOOhcUsAAAAA6MUScdVQAAAAAEDvQEcQAAAAABKMh8YtAQAAAKAXY9VQAAAAAIBX0REEAAAAgATjoXFLAAAAAOjFWDUUAAAAAOBVdAQBAAAAIMF4aNwSAAAAAHoxVg0FAAAAAHgVHUEAAAAASDAeGrcEAAAAgF6MVUMBAAAAAF5FRxAAAAAAEoyHxi0BAAAAoBfrRauGJkWj0Wg3luJeaanU1NTx8dxcaetW5zw5OWYlqaHBLFUkEDTLVVdnlkqhkHOMzydFIs5xlnV11hSOl5euzWMdOOAck5EhVVa6iBtQH39Bx6qosMs1eLBZqnrZXUeBgHOM27Y/d27c5cQs/KmLJ3Tp21PtJoG88YZZKvnLXNzLXd7zK/vnGlR0WEafarNckdQ0s1zPP2+WSrMv2eUcNGiQtMs5bmvdIIOKDtu92yyVBgywyzVysF2bqA84t4lgUKp3cTsP1pQbVHQMNx8G3Copscs1fLhZKqf3D7fnXpJqauKvp0Wm7F7LyOBMs1y+NavjT+L3S6NHx5/H6/7rv9x9qOsu/fpJ3/pWu4eYGgoAAAAACcajYyMAAAAA0MuwaigAAAAAwKvoCAIAAABAgvHQuCUAAAAA9GK9aNVQRgQBAAAAIMHQEQQAAACABOOhcUsAAAAA6MVYNRQAAAAA4FV0BAEAAAAgwXho3BIAAAAAejFWDQUAAAAAeBUdQQAAAABIMB4atwQAAACAXiwlRWpu7ukqjmLVUAAAAABACzqCAAAAAJBgmBoKAAAAABZYNRQAAAAA4FVJ0Wg02tNFtGffPqmzysJhqbbWOU840GhWU6P8Zrks1dXZ5aqpcY7JzZW2bnURl1Iadz0x6elmqWqbgma5qqrMUmnwYOeYYFCqr3cR1+Ti4jgeTU12uSoq7HIZfuMWGZ7nGOPzSZGIcy7La/LKK+1y/XaFi+JdWrLU7nvE6wrLnYMyM6VyF3GbN8df0BGfpE4wy5UfcnHTdKk6NdcsV1qdi/t0drZUang/dyM11S6X4f2r8lCaWa4vv3SOGTlSWrfOOS4nJ+5yWrG85Vt+Dnv7XbvPYZPGObxPuv2gKZl+GKjsb3d9ZyTtMsv1ScWguHP06SOdfrpBMV63Zo3UaNfu4+b3S2PGtHvIQ+OWAAAAANCLpaS4+9a4u7BqKAAAAACgBR1BAAAAAEgwTA0FAAAAAAusGgoAAAAA8Co6ggAAAACQYDw0bgkAAAAAvVhKSud74HU3Vg0FAAAAALSgIwgAAAAACYapoQAAAABgITnZW1NDWTUUAAAAANCCjiAAAAAAJBimhgIAAACABS9tJi+xaigAAAAA4CiPdVkBAAAAoJfqZHGWHsFiMQAAAACAFnQEAQAAACDBMDUUAAAAACykpEhJST1dxVGdTA31bEdwwLo/SQcPdhwwYYLCa953zFOaM8GsptRUs1QKhyJmudJCTXa5UhpcRIWVm17rHBYYHHc9LUor/Ga5srPszn3443fNcpUHJjrGBINSTY1zrmBNWfwFHaNx+EizXH5VmOVSerpZKjfnNS3NXVwoFG81R73xhl2uJUvtJoFcd43ddXT3PZmOMY88It39lHPczJnOMW412d1apawss1R1hpfQms3ZjjETs6U/uIlLXW1RkiSpsq/z87nVp49ZKmX0qbbLlerm/TZTI1PLHaMiAbt2L0kbNtjlGplaZZZr3DjD39PNBe7yJlDZPzfOYo7K+HKdWa7ICLv37lBd/Dm8tpgmmBoKAAAAAAmHvjkAAAAAWEhO9tbUUF/H436MCAIAAABAgqEjCAAAAAAJhqmhAAAAAGAhJUWK2C2oFjemhgIAAAAAWtARBAAAAIAEw9RQAAAAALCQnNzpdMxu18kKph6qEgAAAADQHegIAgAAAECCYWooAAAAAFhISZGi0Z6u4iimhgIAAAAAWtARBAAAAIAEw9RQAAAAALCQnNzTFbjGiCAAAAAAJBg6ggAAAACQYJgaCgAAAAAWUnpP94oRQQAAAABIMEnRqJc2ujiqslJqbu74eGamVF7unCezqdSuqJoas1Tl6flmuVJTzVKprMw5Ji9P2rTJOS4nJ+5yYvwpEbNcpWV2338YNgmlpzvHuG33oVD89RwrXGN4HQ0ebJfr3Xftco0Z4xwzaJC0a5dznOULUFFhlysQMEt191OZZrkeecjF9e3zSRHnuPsesLu+H7x+q1ku0xt1XZ1dLjdtNS1Nqq52DIukphkUdJivod4sV+W+oFmujJMbzXJpzRrnmIICadUqx7DfVBXEX88xLrzQLlewyu79ozqUbZbLqen7/VKjy5fbX+XijdmtqiqzVJUZdp81zdq+32+Tx8tcvFd1O59PO3fuVPNXOle9Z+wSAAAAADws4sEJlz5Js2bN0o4dO1o9TkcQAAAAAE5gxcXFjAgCAAAAQCIZMmRIm8dcdwQ/+OADPfPMM1q7dq18Pp/OPPNMzZ07V2OO+bua7du367HHHtOqI/PZL7zwQs2bN09paXZ/NwAAAAAAXtTU1NMVtNXRn2a66giuWrVKN998s77xjW/otttuU1NTk5YtW6ZrrrlGy5YtU35+vvbs2aPvfe97amxs1E033aTm5mYtXrxYGzdu1Kuvvip/IvxxKAAAAAD0Aq46go888oiGDBmiV155Rf369ZMkTZs2TVOmTNGCBQv03HPP6fnnn1dFRYV+/etfa9iwYZKkM888UzfccINef/11zZgxo+t+CwAAAACAa47L2uzdu1cbNmzQxRdfHOsESlJ6errOOecc/fnPf5YkrVixQgUFBbFOoCSNHz9ep556qlasWNEFpQMAAACAdzQ3H54e6pV/nW3H5zgiGAqF9Lvf/a5VJ7DFnj17lJycrL1792r79u2aPHlym5hRo0bpvffeO74zCAAAAADoMo4jgsnJycrJyVFGRkarxzds2KDVq1dr7NixqqyslKQ2MZI0cOBA7du3T/v27TMqGQAAAAAQj6RoNBo93h/av3+/rr76am3cuFFLlixRnz59NHPmTD300EOaPn16q9gFCxbo5z//ud5///12O4oAAAAAcCLYt086/t5V10lKkgYMaP/Yce8jeODAAd16663asGGDbrnlFhUUFGj16tUuikg6rueprOx8TmtmplRe7pwns6n0uJ63UzU1ZqnK0/PNcqWmmqVSWZlzTF6etGmTc1xOTtzlxPhTIma5SsscB8JdM2wSSk93jnHb7kOh+Os5VrjG8DoaPNgu17vv2uU6ZiucDg0aJO3a5Rxn+QJUVNjlCgTMUt39VKZZrkcecnF9+3xSxDnuvgfsru8Hr99qlsv0Rl1XZ5fLTVtNS5Oqqx3DIql2W0X5GurNclXuC5rlyji50SyX1qxxjikokI5sydWZ31QVxF/PMS680C5XsMru/aM6lG2Wy6np+/1So8uX21/l4o3Zraoqs1SVGXafNc3aPrsIeMpxvWPW1tZq9uzZ+tOf/qTvfve7uu222yRJweDhm+zBgwfb/EzLYyHrT6YAAAAAgK/F9Yjgl19+qRtvvFHr16/XlVdeqX/5l3+JjfJlZh7+Znj37t1tfm7Xrl0Kh8OxziIAAAAAnIiam11NYOk2vk6G/Vx1BOvq6mKdwOuvv1533XVXq+PhcFhZWVlau3Ztm59dt26dRo8efXwVAwAAAAC6jKupoQ8++KDWr1+v6667rk0nsMWkSZO0cuVKbdmyJfbYhx9+qC+++EJTpkyxqRYAAAAAEDfHEcEtW7bojTfeUDgc1umnn6433nijTUxRUZFuvvlmvfHGG7r++us1e/ZsHTx4UIsWLdKoUaNUVFTUJcUDAAAAgFc0NZ1AU0NXHVmtqra2tsPRwKKiIqWlpWnp0qWaP3++Fi5cqEAgoMLCQt15553ys0IQAAAAAHiGY0fwqquu0lVXXeUqWW5urn7xi1/EXRQAAAAAoOt8rQ3lu8WBA53vxhgMSvUu9hlKOe6tEjtmuLeL6T5jhnuDudqfyuWeUqa/48cfm6WqHjHeLFdak4s95dxy8zqGw1JtrXOc5T5jkm0bM7wmGwNhs1yu9oFyuZFjZLDdHnvtLMb8tWVsfN8s1yepE8xyvfaac8yDD0r33eci7gG7+Th3zrPbk/DRR81S2baJyk+cg/LzpU9cxA0fHn9BR2wqs1tpPG/Dm2a5ZLj4XW16rmOM21t+uGydQUXHyMoyS7Wpwu4+nZdq+J7b0ND58exsqdTlHogefY90/B2Ph8Vnus52Nj+BOO2F3t2Sk6WMjPaP2b3LAQAAAAB6BTqCAAAAAJBgDMefAQAAACBxNTV5a2poZ39px4ggAAAAACQYOoIAAAAAkGCYGgoAAAAABpqbD08P7Q0YEQQAAACABENHEAAAAAASDFNDAQAAAMBAUxNTQwEAAAAAHkVHEAAAAAASDFNDAQAAAMCA11YNTUrq+BgjggAAAACQYOgIAgAAAECCYWooAAAAABjw2qqhTA0FAAAAAMTQEQQAAACABMPUUAAAAAAw4LVVQ32dDPslRaPRaPeV4t6+fVJnlYXDUm2tc55w1Va7ogIBs1S1oUyzXGG5OBEu1Srs/Hxuz31KvUFFR9TVmaWKpA8yy+VrajTLpZIS55i8PGnTJuc4w7YqSRo82CzVus1+s1yWRg538Vr6/VKjc9ymErvfMS+92izXJ2VpZrks3+TOSnVxn87NlbY6x93581yDig778aMRs1y3zrGbgPPDH5qlUk6Oc4zPJ0VcnIrdu+MuJ6ZfP7tc4YDdfTqSYndtu3r/cHnP0YYN8RfUVUaPNkv14Ud219H4cQ6N2m3Dl6SamrjriamoMEvVOHykWS5/k8FnuqQk24vboz77zN1l2138/o4vQ6aGAgAAAECCYWooAAAAABjw2qqhnU0NZUQQAAAAABIMHUEAAAAASDBMDQUAAAAAA15bNTQ5ueNjjAgCAAAAQIKhIwgAAAAACYapoQAAAABgwGurhjI1FAAAAAAQQ0cQAAAAABIMU0MBAAAAwIDXVg1N6aS3x4ggAAAAACQYOoIAAAAAkGCYGgoAAAAABry2amhntTAiCAAAAAAJho4gAAAAACQYpoYCAAAAgAGvrRra3NzxMUYEAQAAACDBeHZEsG9f55hAwEWisrK4a2lRO2aCWa6was1yqabGLpXCjjHhsLunDKsq/oJapKebpaqrM0ulUMhvlmv3SXmOMRmSKt3EJe0yqOiorWV2v+fIUKlZrkhWtlkuGX57l5fTaJYrkpJmliu/ZqtZLmVl2eWqS3UXl+oc9+ijcVXSyq1z7L4rfebpiFmub0+1q+vZZ51jsrPdvZVmD7Zr95Y36so9dtdQZaVZKqWnO99XMzOl8ioXcaGQRUkx75flmuWaUGf3eWfYMOfPKD2hMWTXxlJG2OXyV5Sb5TIZ4kpOloYOjT8PzHi2IwgAAAAAvQmrhgIAAAAAPIuOIAAAAAAkGKaGAgAAAIABVg0FAAAAAHgWHUEAAAAASDBMDQUAAAAAA6waCgAAAADwLDqCAAAAAJBgmBoKAAAAAAZYNRQAAAAA4Fl0BAEAAAAgwTA1FAAAAAAMsGooAAAAAMCz6AgCAAAAQIJhaigAAAAAGGDVUAAAAACAZ9ERBAAAAIAE49mpof51a6TGxo4DCgrkX7PKOdGYMVYlKRyKmOWKKGyW649r7HKluGgR2dlSWZlzXNa47PgLOmL3brNUyuhTbZeszu4SGjjQ3es4cKCbqPS4avmqgOEUh8hgu3bh++wTs1waPtw5xu/v9vkezy/1m+WaNi3XLFddhVkqZavOOSgtTapzjtt9KM2gosN++EOzVPr2VLvvXX+7wu696O57nOt65BHp5z93zvXQQ3Zt1ZeaapZrQINZKmUMtDv31TXu2kQg4BzTmG53bUvSGMO3kMoDdp9RBgwwSyXV1HR+PC3NOaZFyO6+46soN8v1SVWmWa78wbviT+JLjPEnVg0FAAAAAHgWHUEAAAAASDCenRoKAAAAAL0Jq4YCAAAAADyLjiAAAAAAJBimhgIAAACAAVYNBQAAAAB4Fh1BAAAAAEgwTA0FAAAAAAOsGgoAAAAA8CxGBAEAAADAAIvFAAAAAAA8i44gAAAAACQYpoYCAAAAgAEWiwEAAAAAeBYdQQAAAABIMEwNBQAAAAADrBoKAAAAAPAsz44IHjhtjKLRjo8HJdWPLnDMs2aNWUkaP7rWLlkobJbq/PPNUrk+X4GAc4xPkbhqOdaf/mT3ncVlF4fMcll+5eOrKHcOysx0F5eaGnc9rZ7WMF1EQbNctTn5ZrnKSpxjRo6U1pU41z9iRPz1tJh9yS67ZHUNZqnWbM42y5U9xuU1GXKOyyj7JM5qjoqMtmtfzz5rlkp332N3P3zkITf3aZ+ruOWv29VVWGiXy/abebu60gL1LqKC7uI2bI67nmP5Bw+2S9ZvkFmqYJ3h/dANl43HX+XifdmlTXWZZrlMPwpUVMSfo08fKT09/jz4Wnbu3Knmr6wc49mOIAAAAAD0Jl5dNXTWrFnasWNHq2N0BAEAAADgBFZcXMyIIAAAAAAkkiFDhrR5zHVH8IMPPtAzzzyjtWvXyufz6cwzz9TcuXM1ZsyYWMwVV1yhTz/9tM3PTp48WQsXLvx6VQMAAABAL9CbVg111RFctWqVbr75Zn3jG9/QbbfdpqamJi1btkzXXHONli1bpvz8fEWjUW3ZskWFhYWaNGlSq58fOnRoXL8AAAAAAMCOq47gI488oiFDhuiVV15Rv379JEnTpk3TlClTtGDBAj333HMqKytTfX29LrroIhUVFXVp0QAAAACAr8+xI7h3715t2LBBN9xwQ6wTKEnp6ek655xz9L//+7+SpM2bDy9dPGzYsC4qFQAAAAC8y6urhrbHsSMYCoX0u9/9rlUnsMWePXuUnJwsSfr8888lHe0I1tfXKxi02y8MAAAAAGDDcWfU5ORk5eTkKCMjo9XjGzZs0OrVqzV27FhJhzuC/fv31/z58zV27FiNHTtWhYWFWrFiRddUDgAAAAD4WpKi0Wj0eH9o//79uvrqq7Vx40YtWbJEBQUFuvzyy7Vu3TpNnjxZl156qWpra7VkyRJt2LBBjz32mKZNm9YF5QMAAACAN/zrv0p79vR0FUedfLJ0773tHzvufQQPHDigW2+9VRs2bNAtt9yigoICSdKMGTMUiUQ0a9asWOzUqVN1ySWX6PHHH9ell14am0bq7nmkzrqowaBUX++cZ80a10/paPzoWrNckVDYLJclN+frrLOk1atdxI2JxF1Pizffchy8du2yixvNcplOAq+pcY7JzJTKy53jUlPjrabLRAJ2U8br6sxSqazMOWbkSGndOue4ESPir6eFr2qXXbKGBrNUf9icbZZr4phq56C0NKnaRZybF9KlyOh8s1yGZennP7fL9chDLu7TPp8UcY5b/rrdfbqw0CyV6W06ELDLFZSLDzFuP+wcWafBzODBZqlqA4PMcoUbDO+HTgYNkna5fD7DRrapLtMsl2V7za75JP4kffpIp58efx6YOa67dm1trWbPnq0//elP+u53v6vbbrstduyqq65q1QmUpEAgoKKiIlVVVcUWkwEAAAAA9CzXI4JffvmlbrzxRq1fv15XXnml/uVf/kVJSUmOP5eWlibp8OIxAAAAAHCi6k2rhroaEayrq4t1Aq+//no9+OCDrTqBlZWVmjp1qp566qk2P/vFF19IkrKyso6zbAAAAABAV3DVEXzwwQe1fv16XXfddbrrrrvaHM/IyFBtba1effVV1R3zRzvl5eVavny5zj33XA0cONCuagAAAADA1+Y4NXTLli164403FA6Hdfrpp+uNN95oE1NUVKT7779fc+bM0cyZMzV9+nTt379fxcXFSklJ0f33398lxQMAAACAVzQ1eWtqaGe1OHYEV61aJenwQjHtjQZKhzuChYWFevrpp/Xss8/qiSeeUCAQUEFBgW6//fbYJvMAAAAAgJ7n2BG86qqrdNVVV7lKVlhYqELLNZ8BAAAAAOaOex/B7tKvr9OeRT4FA877Go0fUWNSjyStK0szyzVyuDf3sktPd7fHW3q6iyDDui670G7/s/omuz0cGxr8ZrnSVGOWqzHFbq8+SfJ//KFZLp/hHoeWu3Hm5Ix0Gecc46twsdejS1sb7PaUyk0p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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter3_169_1.png" - } - }, - "output_type": "display_data" - } - ], - "source": [ - "_lambda = 0.1\n", - "clf_ridge = skl.Ridge(alpha=_lambda).fit(X_train, y_train)\n", - "J_ridge_sk = clf_ridge.coef_.reshape(L, L)\n", - "fig = plt.figure(figsize=(20, 14))\n", - "im = plt.imshow(J_ridge_sk, **cmap_args)\n", - "plt.title(\"Ridge from Scikit-learn\", fontsize=18)\n", - "plt.xticks(fontsize=18)\n", - "plt.yticks(fontsize=18)\n", - "cb = fig.colorbar(im)\n", - "cb.ax.set_yticklabels(cb.ax.get_yticklabels(), fontsize=18)\n", - "\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In the **Least Absolute Shrinkage and Selection Operator** (LASSO)-method we get a third cost function." - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - " C(\\boldsymbol{X}, \\boldsymbol{\\beta}; \\lambda) = (\\boldsymbol{X}\\boldsymbol{\\beta} - \\boldsymbol{y})^T(\\boldsymbol{X}\\boldsymbol{\\beta} - \\boldsymbol{y}) + \\lambda \\sqrt{\\boldsymbol{\\beta}^T\\boldsymbol{\\beta}}.\n", - "\\label{_auto12} \\tag{12}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Finding the extremal point of this cost function is not so straight-forward as in least squares and ridge. We will therefore rely solely on the function ``Lasso`` from **Scikit-Learn**." - ] - }, - { - "cell_type": "code", - "execution_count": 27, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stderr", - "output_type": "stream", - "text": [ - ":9: UserWarning: FixedFormatter should only be used together with FixedLocator\n", - " cb.ax.set_yticklabels(cb.ax.get_yticklabels(), fontsize=18)\n" - ] - }, - { - "data": { - "image/png": "iVBORw0KGgoAAAANSUhEUgAAA4IAAAM2CAYAAACjUj0CAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjMuMywgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/Il7ecAAAACXBIWXMAAAsTAAALEwEAmpwYAABNzElEQVR4nO3dfZxWdZkw8GtmCAZELFZCXnxBntAeSJlcsGxTRAQDDEpFDV8ALbfcp8Ra0j6UaSmJGi7qogZZ4PjGI+UWbm9bmquk22O7lQIhoSGSbyAvA4Lcc54/jFvHgZkbODP3mTnf7+czn81zfvfv/Oaac7te9++6r1ORJEkSAAAA5EZluRcAAABA65IIAgAA5IxEEAAAIGckggAAADkjEQQAAMgZiSAAAEDOSAQB3uGyyy6LI444Ip5//vlyLyVVjz32WHzsYx+LQYMGxac+9alyL2e3HnzwwTj33HNjyJAhcdRRR8XIkSPjm9/8Zrz00kt7PNeiRYviiCOOiMcffzwiIh5//PE44ogjYtGiRbt9zfPPPx9HHHFE3HTTTQ2Or169uqRrDh8+PM4999w9XisAtKYO5V4AAC2vvr4+vvjFL0ZVVVVcfvnlcdBBB5V7Sbs0a9asuPXWW2PYsGFx8cUXR3V1daxYsSL+7//9v7F48eK4995745BDDil5viFDhsTMmTOjf//+Jb+me/fuMXPmzDjiiCOKx/71X/81fvCDH8TPf/7zPfp9ACCrJIIAOfDyyy/HunXrYvLkyTFx4sRyL2eX1q5dG9/5znfi3HPPjenTpzc4N3bs2Jg4cWJ8+9vfjhtvvLHkOQ8++OA4+OCD92gdXbp0iXHjxjU4tmTJkigUCns0DwBkmdJQgBx44403IiJiv/32K/NKdu9//ud/olAoxEc+8pFG52pqauKoo46K//7v/279hQFAOyQRBNgH//7v/x7nnHNOHHPMMTFo0KAYPnx4zJw5M7Zv314cs3379rj66qvjpJNOikGDBsUJJ5wQV155ZWzYsKE4JkmSuPnmm2PUqFHxgQ98II477rj453/+51i7dm2D661fvz6+/vWvx0c/+tEYNGhQjBo1Km6//fYmd6tuuummOOmkkyIi4uabby5+Z+6mm26KD3zgA/Hzn/88PvKRj0RNTU0sXLiw5OvcdNNNUVNTE88880xMnjw5Bg8eHB/96EfjO9/5TiRJEvPmzYthw4ZFTU1NXHDBBc1+53JnkvqDH/ygQfx2mj9/fjz00EMNjm3evDmuueaaGDZsWBx99NFx6qmnFn+HiMbfEdyVxYsXx/vf//74/Oc/H4VCodF3BIcPHx5PPPFErFmzZpffHSzF7373u5g8eXLU1NRETU1NTJkyJX7/+983GJMkSdx9991x+umnR01NTXzgAx+IU045JW6//fZIkqQ4bvjw4TF9+vT4yle+EkcddVQcf/zxsW7duhg+fHh87WtfiwceeCDGjBkTH/jAB2LkyJFRW1u7x+sFoP1TGgqwlxYuXBjTp0+P4cOHx5e+9KV444034uc//3nMmzcvIiKmTZsWERFXXXVV/PjHP47zzjsvDj744FixYkXU1tbGc889F9/97ncjIuLWW2+NW265JSZOnFhsVDN//vz44x//GD/+8Y+jqqoqNmzYEGeddVasWbMmzjrrrOjXr188+uijccMNN8TTTz+925LJk08+Ofbff/+YMWNGnHzyyXHyySdH//7944knnogdO3bE1772tZg8eXJs3749jjnmmD26zhtvvBHnn39+jBgxIkaOHBn3339/XH/99fGb3/wm1qxZE5MmTYr169fH3Llz4/LLL48FCxbsNp7HHnts9O3bN37605/G//t//y9GjhwZH/nIR2LIkCFxwAEHRMeOHRuM3759e0ycODFWrFgREyZMiCOPPDIefvjhmD59emzdujXOO++8Zv+Gv/71r+PLX/5yHH/88XHDDTdEVVVVozFf+cpX4oYbboj169fH5Zdf3uC7g6V49NFH46KLLoojjzwyvvCFL8T27dtj0aJFMXHixLjjjjvi7//+7yMi4sYbb4xbb701PvGJT8SECROirq4ufvjDH8YNN9wQ++23X4OS3sWLF8fhhx8eX/nKV+KVV16J7t27R0TEI488Ej/5yU/inHPOiQMPPDDuvffeuOqqq6Jv375xwgkn7NG6AWjnEgAa+PKXv5wMGDAgWb16dZPjTjnllOTMM89M6uvri8feeOON5Pjjj0/Gjh1bPHbUUUclV155ZYPXzpo1K/nkJz+ZbN68OUmSJPnYxz6WfOYzn2kw5u67704+/vGPJ88991ySJEly3XXXJQMGDEh+/vOfNxj39a9/PRkwYEDy0EMP7Xatq1evTgYMGJDMnj27eGz27NnJgAEDkttuu63B2FKvs/P13/rWt4pjVqxYkQwYMCCpqalJXn311eLxL37xi8kRRxyRbNu2bbdrTJIk+fOf/5yMHz8+GTBgQPHn/e9/f3LuuecmjzzySIOxtbW1yYABA5J/+7d/Kx6rr69PPvWpTyUf+chHkkKhkNx///3JgAEDkt/85jdJkiTJb37zm2TAgAHJ/fffnzz55JPJ0UcfnZx//vnJ66+/3mSszjnnnOTEE09scu07nXjiick555yTJEmSFAqF5KSTTkrOOuusZMeOHcUxdXV1ycknn5yMGzcuSZIk2b59e/LBD34wmTp1aoO5Nm3alAwaNCi56KKLGsx/5JFHJn/9618bXfeII45Ili5dWjz20ksvJUcccURy6aWXlrR2APJDaSjAXvq3f/u3uP3226OioqJ47NVXX41u3brFli1biscOOuigePDBB2PRokWxcePGiIi45JJL4v777y+WQx500EHx+OOPx/e///145ZVXIiLirLPOigceeKDYJfOXv/xl9O/fP0aMGNFgHZ/73OciIuI//uM/9ur3GDJkSIN/3tPrvH3cYYcdFhERH/zgB4u7VBERffv2jSRJir/b7vTr1y8WLVoU8+fPj/POOy/69+8fhUIhHn/88bjgggvi9ttvL4596KGHonv37jF27NjisYqKipg5c2bU1tY2+Lu804oVK+Kiiy6Kvn37xpw5c6JTp05NrmtvPf3007F69eoYMWJEbNiwIdatWxfr1q2L119/PU488cRYunRpvPjii/Gud70rHnvssbjqqqsavH79+vXRtWvXBvdTRMQhhxwSPXv2bHS9fv36xZFHHln85x49esSBBx7YbNwByB+loQB76V3velf813/9V/z4xz+OP//5z/GXv/wlXn311YiI6NOnT3Hc17/+9bjkkkvi8ssvj69+9asxePDgOPnkk+O0006L/fffPyLeLCP97Gc/G9dcc03MmDEjBg4cGMOHD48JEyZEjx49IuLN59t99KMfbbSOHj16RLdu3WLNmjV79Xv83d/9XYN/3tPrHHjggcX/3aFDh13OubPksr6+vtn1VFRUxLHHHhvHHntsRES88MILcf/998dtt90W//Iv/xLjxo2Lnj17xpo1a+KQQw5plPC9Pfa7893vfjcqKyvj9ddfj5dffnmPHkkREVFXV9coOdt///2jurq6wbG//OUvERExc+bMmDlz5i7neuGFF6Jnz57xrne9Kx566KH4j//4j1i1alU899xzxe+RJm/7jmBE4/ju9Pbke6eOHTuWFHcA8kUiCLCXvvGNb8Sdd94Z//t//+8YPHhwjBs3LmpqauIb3/hGgyYvH/7wh+NXv/pV8efRRx+NGTNmxPe+971YtGhRdO/ePY488sj46U9/Go888kj86le/ikceeSRmz54dd9xxR9x7773Rv3//RsnA29XX18e73vWuvfo9KisbFofs6XV29b26pnbjdmfBggWxbdu2uPDCCxsc7927d/yf//N/olOnTnHDDTfEf//3f8eoUaOiUCjs1XUiIo444oj42te+FpMmTYorr7yy+L3OUn33u9+Nm2++ucGxGTNmxCc/+ckGx3YmYF/4whdi8ODBu5zr8MMPjyRJ4nOf+1z86le/imOOOSZqamrizDPPjCFDhsT555/f6DW7inlE478lAOyORBBgL6xZsybuvPPOGDduXKOdnreX4W3fvj2WLl0aBx10UIwZMybGjBkT9fX1cccdd8TMmTNj8eLF8alPfSqWLVsWXbt2jZNOOqnY4fPBBx+MqVOnxsKFC+Oyyy6LPn36xKpVqxqt5eWXX47NmzdHr169UvndWus67/SLX/wifv/738enPvWp6NKlS6PzAwYMiIgo7rr17t07li9f3mjcww8/HA8++GD88z//826vNWnSpPj7v//7mDRpUnznO9+JH//4xw1KTJszfvz4OOaYYxoc+1//6381Grdzd7JLly5x3HHHNTj3+9//PjZs2BDV1dXx29/+Nn71q1/F5z73ufjCF75QHLNjx4547bXX9vhZiADQHB8dAuyFnSV77/yP/4cffjieffbZ2LFjR0S8+R2vM888M2677bbimMrKyvjABz5Q/N+FQiHOO++8uOaaaxrMdfTRRxfHRESceOKJsXLlyvjFL37RYNzO780NGzYsld+tta7zTqeeemps2bIlvvWtbzUqZayvr4+FCxdGt27dit9pPP744+OVV16Jn//85w3Gfv/734+HHnoo3vOe9zR7zc997nPRq1evmDFjRvH7m7tSWVnZYE0HH3xwHHfccQ1+3vve9zZ63aBBg6JHjx6xYMGCqKurKx7fvHlzsVy4qqoqXnvttYhofD/dd999sXXr1uL9BABpsSMIsBuzZs3a5QPYP/axj8UxxxwTvXv3jltvvTW2bdsWBx10UPz+97+PH/zgB9GpU6fif/T37NkzTj311Ljrrrti69atUVNTE6+99lrceeedceCBB8bHPvax6NixY5x77rkxZ86cuPjii+OjH/1ovP7663HvvfdG586d47TTTouIiIsuuih+9rOfxSWXXBJnn312HHbYYfGb3/wmfvazn8XIkSNTezxAa13nnT75yU/GI488Evfee2/87ne/i1NOOSUOOuigePXVV+Pf//3fY/ny5XHDDTcUdwvPOuusuP/++2Pq1KkxceLE6NevXzz00EPx6KOPxjXXXLPb8sm369KlS1x22WXxhS98Ia6//vpGzVp26t69e/zXf/1XfPe7341jjjmmmKQ3513veldMnz49pk6dGp/85Cfj9NNPj06dOsXChQvjhRdeiOuvvz46dOgQNTU10bVr15gxY0asWbMmDjjggHj88cfjwQcfbHA/AUBaJIIAu/HjH/94l8cPP/zw+PCHPxy33357fOtb34r58+dHkiRxyCGHxFe+8pXYsWNHXH311fHHP/4xBg0aFN/4xjfi4IMPjsWLF8fixYujc+fO8eEPfzimTp1abO7x+c9/Pt797nfH/fffH9dee21UVVXFBz/4wbjuuuuif//+ERHx7ne/O+6999648cYb48EHH4yNGzfGwQcfHNOmTYtJkyal9nu31nXeqbKyMm688cZ44IEH4oEHHog777wzNm3aFAcccEAcc8wxceWVV8ZRRx1VHF9dXR0LFiyIG2+8MRYvXhybNm2K/v37x4033hgf+9jHSr7uKaecEv/wD/8Q9913X3ziE58oNud5uwsvvDCWL18e3/72t+OTn/xkyYngzvkPOOCAmDNnTvzrv/5rVFZWxvve976YM2dOnHjiiRHxZsOd22+/Pa6//vqYM2dOdOzYMfr16xff/va34/e//33Mnz8/XnnllQaNeQBgX1QkTXUFAAAAoN3xHUEAAICckQgCAADkjEQQAAAgZzSLAQAAaKc2bty4y0ckaRYDAACwj7auWxed/9YNPEtef/31OP7444vPQN4pu4ngOx4m3EhlZfNjIuKww29rdkypnv3zRanN1aaVGHtagNiXl/iXj9iXj9iXj9iXj9g3cNjh39nnOfr27Rr/+Z8TU1hNtn33H/4hNj7/fLmXUdStb9+Y8p//GWvXro1CodDgXLsvDX3uuQ3NDwIAAHbpuecalxWy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sPea/Y7gtm3b4j3veU9MmDChmARGRAwdOjQiIpYvXx4REc8880xERPTv378l1gkAAJBxOx8on5WffSgN7dSpU8ybN6/R8aVLl0ZERO/evSMiYsWKFRHxViK4ZcuW6NKlS3PTAwAA0Mr2uGvomjVrYtGiRXH11VfHgAED4uSTT46INxPB/fbbL2bMmBE1NTVRU1MTI0aMiMWLF6e+aAAAAPbeHj1H8LXXXovhw4dHRETnzp1j+vTp0alTp4h4szS0rq4uNm3aFDNnzoyNGzfG/Pnz49JLL4033ngjxo8fv2crqywhRy1lDC1D7MtH7MtL/MtH7MtH7MtH7IvSjUR6/52ZJHP2cS20L9l8oPyuVCRJkpQ6zYYNG+LRRx+N7du3x4IFC2Lp0qUxa9asGDVqVNx9991RX18fEydOLI5//fXXY+zYsbF169b49a9/HVVVVaWvub6ZtquVlc2PoWWIffmIfXmJf/mIffmIffmIfQP1KaaClc2199+D2FdUXZzCit6UFG5Jba5MysEHG4cddk8899zmci+j6NBDu8azz561y3N79Nc44IADYvTo0TF+/Piora2N3r17x4wZMyIi4uyzz26QBEZEVFdXx7hx4+KVV14pNpMBAACgvPY6La+uro5hw4bF2rVrY926dbsd171794h4s3kMAABA+1XuLqG7+tm1ZhPBlStXxvDhw6O2trbRubq6uqioqIitW7fGmDFj4uabb240ZtWqVRER0bdv3+YuBQAAQCtoNhE89NBDY9OmTXHPPffE9u3bi8fXrFkTP/3pT2PIkCHRp0+f2LhxYyxcuDA2b36rJvaFF16IRYsWxbHHHhs9evRomd8AAACAPdJs19AOHTrE9OnTY9q0aXHuuefGxz/+8Vi/fn3U1tZGZWVlfPWrX42IiCuuuCIuvvjiOOuss+KMM86Iurq6qK2tjQ4dOsQVV1zR4r8IAABAee18oHxW7L7pUcldQx988MGYO3du/OlPf4ouXbrEhz70oZg6dWr069evOOYXv/hF3HbbbbFs2bKorq6OoUOHxqWXXlp8yPyerVnX0MwS+/IR+/IS//IR+/IR+/IR+wZ0DW0HctE1dEE899ymci+j6NBD949nnz13l+f26PERrUoimF1iXz5iX17iXz5iXz5iXz5i34BEsB2QCLa6phLBPXqgPAAAlEOzydseaC6prCxhzE5pJm8VVdNSmyspzExtLvZEfTRVjtn6dr+W9p+WAwAA0IAdQQAAgFQ0/ey+1rcPzxEEAACgfZEIAgAA5IzSUAAAgFS0necI2hEEAADIGYkgAABAzigNBQAASIWuoQAAAGSURBAAACBnlIYCAACkQtdQAAAAMkoiCAAAkDNKQwEAAFKhaygAAAAZJREEAADIGaWhAAAAqaiPpjp1tj5dQwEAAPgbO4IAAORKZbM7NpUljHlTfYr7KklhZmpzVVR9PrW5ksLs1OYiOySCAAAAqfBAeQAAADJKIggAAJAzSkMBAABS4YHyAAAAZJREEAAAIGeUhgIAAKRCaSgAAAAZJREEAADIGaWhAAAAqUiiqYe4t75kt2fsCAIAAOSMRBAAACBnlIYCAACkQtdQAAAAMkoiCAAAkDNKQwEAAFKhNBQAAICMkggCAADkjNJQAADYS5UpPjy8PsU9mqQwO7W5Kqq+uM9zHHroe+LZZ7+Wwmqyrj6yVRq6+/vTjiAAAEDOSAQBAAByRmkoAABAKnQNBQAAIKMkggAAADmjNBQAACAV9dFUp87Wp2soAAAAfyMRBAAAyBmloQAAAKnwQHkAAAAySiIIAACQM0pDAQAAUuGB8gAAAGSURBAAACBnlIYCAACkQmkoAAAAGSURBAAAyBmloQAAAKloOw+Uz2wi+JfnK2PHjt2fP/zwiD8/2/yG5uGH7f6XBwCArKhs4j/a91R9ioV/SeGG1OYiO5SGAgAA5ExmdwQBAADaFl1DAQAAyCiJIAAAQM4oDQUAAEhFfTTVqbP17X4tdgQBAAByRiIIAACQM0pDAQAAUtF2HihvRxAAACBnJIIAAAA5ozQUAAAgFR4oDwAAQEZJBAEAAHJGaSgAAEAqdA0FAAAgoySCAAAAOaM0FAAAIBX10VQ5Zuvb/VoymwhWVTU/pkNmVw8AAORN375/V+4lNLBzPWvXro1CoeF3FyuSJEnKsSgAAABa1uuvvx7HH398bNiwocFxiSAAAEA7tXHjxti4cWOj4xJBAACAnNE1FAAAIGckggAAADkjEQQAAMgZiSAAAEDOSAQBAAByRiIIAACQMxJBAACAnJEIAgAA5EyHci9gT61evTquvfbaeOKJJyIiYtiwYXHZZZdF9+7dy7yy9u/000+PP/zhD42Ojxo1KmbPnl2GFbV/X/3qV+PZZ5+NBQsWNDjufdA6dhd/74X0PfLIIzFnzpx46qmnorKyMo4++ui45JJLYvDgwcUx7vuWUUrs3fMtZ8mSJTF79uxYtmxZdO3aNU455ZS45JJLYr/99iuOce+3jFJi796nPWtTieD69evj/PPPj+3bt8eFF14YhUIh5s2bF8uXL4+FCxdGx44dy73EditJkli5cmWMGDEiRo4c2eBcnz59yrSq9m3hwoVx3333xdChQxsc9z5oHbuLv/dC+p544on49Kc/He973/ti6tSpsWPHjrjrrrvinHPOibvuuiuOOuoo930LKSX27vmWs2TJkpgyZUoMHDgwvvSlL8XatWtj/vz58cc//jFqa2ujsrLSvd9CSom9e592L2lDvv3tbyfvf//7k2eeeaZ47NFHH00GDBiQ3HvvvWVcWfv3l7/8JRkwYEBy//33l3sp7d6OHTuSm266KTniiCOSAQMGJOecc06D894HLau5+HsvpG/cuHHJsGHDki1bthSPvfzyy8mQIUOSSZMmJUnivm8ppcTePd9yPvGJTyQnnnhisnXr1uKxO++8MxkwYEDy0EMPJUni3m8ppcTevU9716a+I7h48eIYOnRo9O/fv3jsuOOOi379+sXixYvLuLL275lnnomIaBB70rdt27b4xCc+ETfddFOMGzcuevbs2WiM90HLKSX+3gvp2rBhQyxbtixOOeWU6Ny5c/H4gQceGEOGDInf/e53EeG+bwmlxt493zK2bdsW73nPe2LChAlRXV1dPL6zCmH58uUR4d5vCaXG3r1Pe9dmSkM3bNgQq1evjlGjRjU6N3DgwHj44YfLsKr8WLFiRUS89S/DLVu2RJcuXcq5pHZp27ZtsXnz5pg1a1aMHj06hg8f3uC890HLai7+Ed4LaevatWv85Cc/aZCI7LR+/fqoqqpy37eQUmIf4Z5vKZ06dYp58+Y1Or506dKIiOjdu7d7v4WUEvsI9z7tX5vZEXzxxRcjInb5CX2PHj1i06ZNsWnTptZeVm6sWLEi9ttvv5gxY0bU1NRETU1NjBgxwqeRKevatWv87Gc/i9GjR+/yvPdBy2ou/hHeC2mrqqqKww47rNE9vWzZsnjyySejpqbGfd9CSol9hHu+taxZsyYWLVoUV199dQwYMCBOPvlk934r2VXsI9z7tH9tZkewrq4uImKXn1x26tQpIt78pGb//fdv1XXlxTPPPBN1dXWxadOmmDlzZmzcuDHmz58fl156abzxxhsxfvz4ci+xXaisrIzKyt1/PuN90LKai3+E90JrqKuriy9/+csREfGZz3zGfd+K3hn7CPd8a3jttdeKFQidO3eO6dOnR6dOndz7rWB3sY9w79P+tZlEMEmSZsdUVFS0wkryacKECVFfXx8TJ04sHhszZkyMHTs2rrvuujj11FOLZUS0HO+D8vNeaFlbt26Nz372s7Fs2bK46KKLYujQofHkk082+zr3/b7bVewj3POtoaKiImbNmhXbt2+PBQsWxOTJk2PWrFnRo0ePkl7L3ttd7EeNGuXep91rM6WhO2uyt23b1ujczmNdu3Zt1TXlydlnn93gX4QREdXV1TFu3Lh45ZVXil+opmV5H5Sf90LL2bhxY0yZMiUef/zxOO2002Lq1KkR4b5vDbuLfYR7vjUccMABMXr06Bg/fnzU1tZG7969Y8aMGe79VrC72Ee492n/2kwiuPOLuy+//HKjcy+99FJ069bNF3jLYOfDbLds2VLmleSD90F2eS/sm1dffTXOO++8ePLJJ+PMM8+Mq6++urjT4b5vWU3Fvinu+ZZRXV0dw4YNi7Vr18Z73/veiHDvt5a3x37dunW7Hefep71oM4lgt27dom/fvvHUU081Ovf000/HoEGDyrCqfHjxxRdjzJgxcfPNNzc6t2rVqoiI6Nu3b2svK5e8D8rLe6FlbN68OS644IJYunRpTJo0Ka666qoGiYj7vuU0F3v3fMtZuXJlDB8+PGpraxudq6uri4qKiujYsaN7vwWUEvutW7e692n32kwiGBExcuTIWLJkSaxcubJ47LHHHotVq1Y12eWPfdOzZ8/YuHFjLFy4MDZv3lw8/sILL8SiRYvi2GOPLel7DKTD+6B8vBdaxlVXXRVLly6N8847Ly6//PJdjnHft4zmYu+ebzmHHnpobNq0Ke65557Yvn178fiaNWvipz/9aQwZMiS6du3q3m8BpcS+T58+7n3avYqklO4TGbFu3boYO3ZsVFVVxZQpU2Lbtm0xd+7cOOSQQ+Kee+6Jjh07lnuJ7dYvfvGLuPjii+N973tfnHHGGVFXVxe1tbXxxhtvxN133+1hqy1k+PDh0adPn1iwYEHxmPdB69lV/L0X0rVy5coYPXp0dOvWLS6//PJdNl4YN26c+74FlBp793zLeeCBB2LatGkxePDg+PjHPx7r168vxvauu+6KAQMGuPdbSCmxd+/T3rWpRDAi4s9//nPMmDEjfvvb30Z1dXWccMIJMW3atGK9Ni3nF7/4Rdx2222xbNmyqK6ujqFDh8all17qX4QtaFeJSIT3QWvZXfy9F9Jz9913x9e//vUmxyxfvjwi3Pdp25PYu+dbzoMPPhhz586NP/3pT9GlS5f40Ic+FFOnTo1+/foVx7j3W0YpsXfv0561uUQQAACAfdOmviMIAADAvpMIAgAA5IxEEAAAIGckggAAADkjEQQAAMgZiSAAAEDOSAQBAAByRiIIAACQMxJBAACAnPn/YovtX1B9RgoAAAAASUVORK5CYII=\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter3_173_1.png" - } - }, - "output_type": "display_data" - } - ], - "source": [ - "clf_lasso = skl.Lasso(alpha=_lambda).fit(X_train, y_train)\n", - "J_lasso_sk = clf_lasso.coef_.reshape(L, L)\n", - "fig = plt.figure(figsize=(20, 14))\n", - "im = plt.imshow(J_lasso_sk, **cmap_args)\n", - "plt.title(\"Lasso from Scikit-learn\", fontsize=18)\n", - "plt.xticks(fontsize=18)\n", - "plt.yticks(fontsize=18)\n", - "cb = fig.colorbar(im)\n", - "cb.ax.set_yticklabels(cb.ax.get_yticklabels(), fontsize=18)\n", - "\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "It is quite striking how LASSO breaks the symmetry of the coupling\n", - "constant as opposed to ridge and OLS. We get a sparse solution with\n", - "$J_{j, j + 1} = -1$.\n", - "\n", - "\n", - "\n", - "\n", - "We see how the different models perform for a different set of values for $\\lambda$." - ] - }, - { - "cell_type": "code", - "execution_count": 28, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stderr", - "output_type": "stream", - "text": [ - "\r", - " 0%| | 0/10 [00:00" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter3_175_13.png" - } - }, - "output_type": "display_data" - } - ], - "source": [ - "lambdas = np.logspace(-4, 5, 10)\n", - "\n", - "train_errors = {\n", - " \"ols_sk\": np.zeros(lambdas.size),\n", - " \"ridge_sk\": np.zeros(lambdas.size),\n", - " \"lasso_sk\": np.zeros(lambdas.size)\n", - "}\n", - "\n", - "test_errors = {\n", - " \"ols_sk\": np.zeros(lambdas.size),\n", - " \"ridge_sk\": np.zeros(lambdas.size),\n", - " \"lasso_sk\": np.zeros(lambdas.size)\n", - "}\n", - "\n", - "plot_counter = 1\n", - "\n", - "fig = plt.figure(figsize=(32, 54))\n", - "\n", - "for i, _lambda in enumerate(tqdm.tqdm(lambdas)):\n", - " for key, method in zip(\n", - " [\"ols_sk\", \"ridge_sk\", \"lasso_sk\"],\n", - " [skl.LinearRegression(), skl.Ridge(alpha=_lambda), skl.Lasso(alpha=_lambda)]\n", - " ):\n", - " method = method.fit(X_train, y_train)\n", - "\n", - " train_errors[key][i] = method.score(X_train, y_train)\n", - " test_errors[key][i] = method.score(X_test, y_test)\n", - "\n", - " omega = method.coef_.reshape(L, L)\n", - "\n", - " plt.subplot(10, 5, plot_counter)\n", - " plt.imshow(omega, **cmap_args)\n", - " plt.title(r\"%s, $\\lambda = %.4f$\" % (key, _lambda))\n", - " plot_counter += 1\n", - "\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We see that LASSO reaches a good solution for low\n", - "values of $\\lambda$, but will \"wither\" when we increase $\\lambda$ too\n", - "much. Ridge is more stable over a larger range of values for\n", - "$\\lambda$, but eventually also fades away.\n", - "\n", - "\n", - "To determine which value of $\\lambda$ is best we plot the accuracy of\n", - "the models when predicting the training and the testing set. We expect\n", - "the accuracy of the training set to be quite good, but if the accuracy\n", - "of the testing set is much lower this tells us that we might be\n", - "subject to an overfit model. The ideal scenario is an accuracy on the\n", - "testing set that is close to the accuracy of the training set." - ] - }, - { - "cell_type": "code", - "execution_count": 29, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "data": { - "image/png": "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2Lc9YFdVSJ/zriAAbadlrrJTqZTe+9736tSpUzp16pQefvhhra6uXvN+3/zmN3X//ffrZS97me666y7963/9r3XuHG+EuDUp19bs47v0gAGAmzG2y3vKZrmi9RL96wAA7cEwjLrZUvmNKY+qAdCO/F4XIElra2u67777VCqV9MADD6harerxxx/X1NSUPvaxjykYDDa837lz5/TOd75TkUhEP/mTPylJ+sAHPqAf//Ef15NPPqnh4eFm/megg8y6Q6mr9IABgBt1tfeU6XRefaFAE6sBAODmRZLHlV76cu04v3lGtm3JMFpm/gOAFtYSodQTTzyh+fl5ffrTn9bRo0clSS996Ut1//3361Of+pTe/va3N7zfBz/4QeVyOf3BH/yBXvziF0uSXv3qV+ttb3ubnnjiCf3cz/1c0/4b0Dks29aca/nebrtlAcDNuFooNZPJ69sHe5pYDQAANy8Un5DhC8muFiVJViWnUvaCQvFxjysD0A5aIr5+6qmndOrUqVogJUl33323jhw5oqeeemrX+83Nzamvr68WSEnSt33bt6m3t1enT7PzA27OYr6kkrXd0yXq96mfWQsA9lAssPv7yrRrpiYAAK3MMHyK9BxzjLGED8D18jyU2tjYUCqV0h133FF37o477tCzzz67630nJye1sbHh6D21vr6udDqtAwcO7Eu96HzupXsTsbAMw/CoGgCdarfZUov5knKVapOrAQDg5kV6XH2lNs94VAmAduN5KLWwsCBJDfs/DQ0NKZ1OK51ON7zvAw88oJGREf30T/+0nn/+eU1NTelnfuZnFAgE9M53vnNf60bncu+8R5NzAPvhxX0xvfpAUm87Mqwh16yp2Uzeo6oAALhxkZ6j2nlpWS4sqVy89qZVAOB5T6lsNitJikQidedCoZAkKZfLKZFI1J0fHR3Vv/pX/0q/9mu/pnvuuUeS5PP59MgjjziW9AE3oq7JOaEUgH3wkv6EXtK/9dmWyha0tLhROzedLuhkb9yr0gAAuCGmP6JQfELFzHRtLL9xWoEDr/auKABtwfNQyrbta95mt6VT/+W//Be9733v06lTp/T2t79d1WpVH/3oR/Xv/t2/0yOPPKLXve51N1TLwAAXAN0uV65oqVCqHRuSXjYxqEjA19Q6hobqQ1gAzdXM1+FLymX9/Y5Q6mKxxPsAuh6vAcB7N/I6tHLf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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter3_177_0.png" - } - }, - "output_type": "display_data" - } - ], - "source": [ - "fig = plt.figure(figsize=(20, 14))\n", - "\n", - "colors = {\n", - " \"ols_sk\": \"r\",\n", - " \"ridge_sk\": \"y\",\n", - " \"lasso_sk\": \"c\"\n", - "}\n", - "\n", - "for key in train_errors:\n", - " plt.semilogx(\n", - " lambdas,\n", - " train_errors[key],\n", - " colors[key],\n", - " label=\"Train {0}\".format(key),\n", - " linewidth=4.0\n", - " )\n", - "\n", - "for key in test_errors:\n", - " plt.semilogx(\n", - " lambdas,\n", - " test_errors[key],\n", - " colors[key] + \"--\",\n", - " label=\"Test {0}\".format(key),\n", - " linewidth=4.0\n", - " )\n", - "plt.legend(loc=\"best\", fontsize=18)\n", - "plt.xlabel(r\"$\\lambda$\", fontsize=18)\n", - "plt.ylabel(r\"$R^2$\", fontsize=18)\n", - "plt.tick_params(labelsize=18)\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "From the above figure we can see that LASSO with $\\lambda = 10^{-2}$\n", - "achieves a very good accuracy on the test set. This by far surpasses the\n", - "other models for all values of $\\lambda$.\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "## Exercises and Projects\n", - "\n", - "\n", - "\n", - "The main aim of this project is to study in more detail various\n", - "regression methods, including the Ordinary Least Squares (OLS) method,\n", - "The total score is **100** points. Each subtask has its own final score.\n", - "\n", - "\n", - "We will first study how to fit polynomials to a specific\n", - "two-dimensional function called [Franke's\n", - "function](http://www.dtic.mil/dtic/tr/fulltext/u2/a081688.pdf). This\n", - "is a function which has been widely used when testing various\n", - "interpolation and fitting algorithms. Furthermore, after having\n", - "established the model and the method, we will employ resamling\n", - "techniques such as cross-validation and/or bootstrap in order to perform a\n", - "proper assessment of our models. We will also study in detail the\n", - "so-called Bias-Variance trade off.\n", - "\n", - "\n", - "The Franke function, which is a weighted sum of four exponentials reads as follows" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{align*}\n", - "f(x,y) &= \\frac{3}{4}\\exp{\\left(-\\frac{(9x-2)^2}{4} - \\frac{(9y-2)^2}{4}\\right)}+\\frac{3}{4}\\exp{\\left(-\\frac{(9x+1)^2}{49}- \\frac{(9y+1)}{10}\\right)} \\\\\n", - "&+\\frac{1}{2}\\exp{\\left(-\\frac{(9x-7)^2}{4} - \\frac{(9y-3)^2}{4}\\right)} -\\frac{1}{5}\\exp{\\left(-(9x-4)^2 - (9y-7)^2\\right) }.\n", - "\\end{align*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The function will be defined for $x,y\\in [0,1]$. Our first step will\n", - "be to perform an OLS regression analysis of this function, trying out\n", - "a polynomial fit with an $x$ and $y$ dependence of the form $[x, y,\n", - "x^2, y^2, xy, \\dots]$. We will also include bootstrap first as\n", - "a resampling technique. After that we will include the cross-validation technique. As in homeworks 1 and 2, we can use a uniform\n", - "distribution to set up the arrays of values for $x$ and $y$, or as in\n", - "the example below just a set of fixed \n", - "values for $x$ and $y$ with a given step\n", - "size. We will fit a\n", - "function (for example a polynomial) of $x$ and $y$. Thereafter we\n", - "will repeat much of the same procedure using the Ridge and Lasso\n", - "regression methods, introducing thus a dependence on the bias\n", - "(penalty) $\\lambda$.\n", - "\n", - "Finally we are going to use (real) digital terrain data and try to\n", - "reproduce these data using the same methods. We will also try to go\n", - "beyond the second-order polynomials metioned above and explore \n", - "which polynomial fits the data best.\n", - "\n", - "\n", - "The Python code for the Franke function is included here (it performs also a three-dimensional plot of it)" - ] - }, - { - "cell_type": "code", - "execution_count": 30, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "data": { - "image/png": "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N9LpRC1Nbf3jO5p0kb5emUwOAwNDGB7OQlHI+9ff343+/h6kUgm89tqreP3113ynzfl8HnPnzsUHH3zgeszatWvx+c9/3riezWZx5pln4vDDD8eJJ56IgYGBtp7TRMZmETnR3ThaJwJ05PMl3/enaRwJ6/3Vl2iBnX6ZvGAulGezRWiaClXVoChkSx6o77xJUgSRiARJEse0cOzUlGsuZFOPc3P/XSfqZgSERDTNHr1YrWE0TbNEn17EE2Sq5WYP8/OfP4S1a9ciFothzz33woUXLkFfX5/jOV5//TV8//vX4N1333V9nMHBQVx//fWWv918882YPXs2VqxYgcceewxXX301br755qCe2oTAJh050WiJZYl9bjweQbFY9v1loWkcz3MtkVk8HoEk0X46zfMDz3EskklivJbLuaeLdNetXK4gny8inyd1slQqgUmTetDVlapZsnC+1zoayLKCfL6IoaEMBgaGUCyWwLKsaT3J2vMLfj1upKeqakO0pygqolEa7ZHoU5JE1/elU7uW1Bpm6dKr8cc//hFLllyO7bffESzr/vlYtepRXHbZZZg0aZLrMUuWLMHZZ59t+dvatWtxxBFHAADmzp2L3//+90Y71OaCTTZysregaJpe0y4xvlIic59buVytfYCa35HopIgtit9+OhphtTMBuF44LhruB6IoBlrM9gtSGyKPB9RrQ5IkoqsrCYYx72wFsR7n9hU77H5Rdo2VXffVuV1A08oZBj09PTjwwINwwAGfb3rsRRddiv7+pOvt9913H2bMmIE99tjD8vcNGzagv78fAIm4E4kEhoaGMHny5NE/gQmCTZKc3FpQAIBhdM9IJholjb7m3Tgvm5K6Va9/d8vRGM/Zn4OuW0c42YvZwaiy/YOms+k0MDg4bNrZMheL62TV6nraTRftGiur7ouHpqnQdR2CwHcsVaZv3Wjfgn/9619Ys2YN7rnnHqxbt87z+HZqcBMZmxQ5WVtQyBff3oLS7ANB0zhd133vxpkfy41k7KRGozlVbeYf7s6ExJXAj01vY73KHjGMVb3K3TY4YmppIT8iQTpxesGu+0okohBF0bCGkWXFJroMDqP9gVi9ejUGBgZw9NFHQ5ZlbNiwASeccAJ++tOfYtKkSRgcHMSUKVOgKAry+Ty6urqCWfgEwSZDTlb73OaDA5y+2ILAIRaLWKIsM5wI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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter3_181_0.png" - } - }, - "output_type": "display_data" - } - ], - "source": [ - "from mpl_toolkits.mplot3d import Axes3D\n", - "import matplotlib.pyplot as plt\n", - "from matplotlib import cm\n", - "from matplotlib.ticker import LinearLocator, FormatStrFormatter\n", - "import numpy as np\n", - "from random import random, seed\n", - "\n", - "fig = plt.figure()\n", - "ax = fig.gca(projection='3d')\n", - "\n", - "# Make data.\n", - "x = np.arange(0, 1, 0.05)\n", - "y = np.arange(0, 1, 0.05)\n", - "x, y = np.meshgrid(x,y)\n", - "\n", - "\n", - "def FrankeFunction(x,y):\n", - " term1 = 0.75*np.exp(-(0.25*(9*x-2)**2) - 0.25*((9*y-2)**2))\n", - " term2 = 0.75*np.exp(-((9*x+1)**2)/49.0 - 0.1*(9*y+1))\n", - " term3 = 0.5*np.exp(-(9*x-7)**2/4.0 - 0.25*((9*y-3)**2))\n", - " term4 = -0.2*np.exp(-(9*x-4)**2 - (9*y-7)**2)\n", - " return term1 + term2 + term3 + term4\n", - "\n", - "\n", - "z = FrankeFunction(x, y)\n", - "\n", - "# Plot the surface.\n", - "surf = ax.plot_surface(x, y, z, cmap=cm.coolwarm,\n", - " linewidth=0, antialiased=False)\n", - "\n", - "# Customize the z axis.\n", - "ax.set_zlim(-0.10, 1.40)\n", - "ax.zaxis.set_major_locator(LinearLocator(10))\n", - "ax.zaxis.set_major_formatter(FormatStrFormatter('%.02f'))\n", - "\n", - "# Add a color bar which maps values to colors.\n", - "fig.colorbar(surf, shrink=0.5, aspect=5)\n", - "\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "### Exercise: Ordinary Least Square (OLS) on the Franke function\n", - "\n", - "We will generate our own dataset for a function\n", - "$\\mathrm{FrankeFunction}(x,y)$ with $x,y \\in [0,1]$. The function\n", - "$f(x,y)$ is the Franke function. You should explore also the addition\n", - "of an added stochastic noise to this function using the normal\n", - "distribution $N(0,1)$.\n", - "\n", - "*Write your own code* (using either a matrix inversion or a singular\n", - "value decomposition from e.g., **numpy** ) or use your code from\n", - "homeworks 1 and 2 and perform a standard least square regression\n", - "analysis using polynomials in $x$ and $y$ up to fifth order. Find the\n", - "[confidence intervals](https://en.wikipedia.org/wiki/Confidence_interval) of the parameters (estimators) $\\beta$ by computing their\n", - "variances, evaluate the Mean Squared error (MSE)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "MSE(\\hat{y},\\hat{\\tilde{y}}) = \\frac{1}{n}\n", - "\\sum_{i=0}^{n-1}(y_i-\\tilde{y}_i)^2,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and the $R^2$ score function. If $\\tilde{\\hat{y}}_i$ is the predicted\n", - "value of the $i-th$ sample and $y_i$ is the corresponding true value,\n", - "then the score $R^2$ is defined as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "R^2(\\hat{y}, \\tilde{\\hat{y}}) = 1 - \\frac{\\sum_{i=0}^{n - 1} (y_i - \\tilde{y}_i)^2}{\\sum_{i=0}^{n - 1} (y_i - \\bar{y})^2},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where we have defined the mean value of $\\hat{y}$ as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\bar{y} = \\frac{1}{n} \\sum_{i=0}^{n - 1} y_i.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Your code has to include a scaling of the data (for example by\n", - "subtracting the mean value), and\n", - "a split of the data in training and test data. For this exercise you can\n", - "either write your own code or use for example the function for\n", - "splitting training data provided by the library **Scikit-Learn** (make\n", - "sure you have installed it). This function is called\n", - "$train\\_test\\_split$. **You should present a critical discussion of why and how you have scaled or not scaled the data**.\n", - "\n", - "It is normal in essentially all Machine Learning studies to split the\n", - "data in a training set and a test set (eventually also an additional\n", - "validation set). There\n", - "is no explicit recipe for how much data should be included as training\n", - "data and say test data. An accepted rule of thumb is to use\n", - "approximately $2/3$ to $4/5$ of the data as training data.\n", - "\n", - "\n", - "You can easily reuse the solutions to your exercises from week 35 and week 36.\n", - "\n", - "\n", - "\n", - "### Exercise: Bias-variance trade-off and resampling techniques\n", - "\n", - "Our aim here is to study the bias-variance trade-off by implementing the **bootstrap** resampling technique.\n", - "\n", - "With a code which does OLS and includes resampling techniques, \n", - "we will now discuss the bias-variance trade-off in the context of\n", - "continuous predictions such as regression. However, many of the\n", - "intuitions and ideas discussed here also carry over to classification\n", - "tasks and basically all Machine Learning algorithms. \n", - "\n", - "Before you perform an analysis of the bias-variance trade-off on your test data, make\n", - "first a figure similar to Fig. 2.11 of Hastie, Tibshirani, and\n", - "Friedman. Figure 2.11 of this reference displays only the test and training MSEs. The test MSE can be used to \n", - "indicate possible regions of low/high bias and variance. You will most likely not get an\n", - "equally smooth curve!\n", - "\n", - "With this result we move on to the bias-variance trade-off analysis.\n", - "\n", - "Consider a\n", - "dataset $\\mathcal{L}$ consisting of the data\n", - "$\\mathbf{X}_\\mathcal{L}=\\{(y_j, \\boldsymbol{x}_j), j=0\\ldots n-1\\}$.\n", - "\n", - "Let us assume that the true data is generated from a noisy model" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{y}=f(\\boldsymbol{x}) + \\boldsymbol{\\epsilon}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Here $\\epsilon$ is normally distributed with mean zero and standard\n", - "deviation $\\sigma^2$.\n", - "\n", - "In our derivation of the ordinary least squares method we defined then\n", - "an approximation to the function $f$ in terms of the parameters\n", - "$\\boldsymbol{\\beta}$ and the design matrix $\\boldsymbol{X}$ which embody our model,\n", - "that is $\\boldsymbol{\\tilde{y}}=\\boldsymbol{X}\\boldsymbol{\\beta}$.\n", - "\n", - "The parameters $\\boldsymbol{\\beta}$ are in turn found by optimizing the means\n", - "squared error via the so-called cost function" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(\\boldsymbol{X},\\boldsymbol{\\beta}) =\\frac{1}{n}\\sum_{i=0}^{n-1}(y_i-\\tilde{y}_i)^2=\\mathbb{E}\\left[(\\boldsymbol{y}-\\boldsymbol{\\tilde{y}})^2\\right].\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Here the expected value $\\mathbb{E}$ is the sample value. \n", - "\n", - "Show that you can rewrite this as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbb{E}\\left[(\\boldsymbol{y}-\\boldsymbol{\\tilde{y}})^2\\right]=\\frac{1}{n}\\sum_i(f_i-\\mathbb{E}\\left[\\boldsymbol{\\tilde{y}}\\right])^2+\\frac{1}{n}\\sum_i(\\tilde{y}_i-\\mathbb{E}\\left[\\boldsymbol{\\tilde{y}}\\right])^2+\\sigma^2.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Explain what the terms mean, which one is the bias and which one is\n", - "the variance and discuss their interpretations.\n", - "\n", - "Perform then a bias-variance analysis of the Franke function by\n", - "studying the MSE value as function of the complexity of your model.\n", - "\n", - "Discuss the bias and variance trade-off as function\n", - "of your model complexity (the degree of the polynomial) and the number\n", - "of data points, and possibly also your training and test data using the **bootstrap** resampling method.\n", - "\n", - "Note also that when you calculate the bias, in all applications you don't know the function values $f_i$. You would hence replace them with the actual data points $y_i$.\n", - "\n", - "\n", - "### Exercise: Cross-validation as resampling techniques, adding more complexity\n", - "\n", - "The aim here is to write your own code for another widely popular\n", - "resampling technique, the so-called cross-validation method. Again,\n", - "before you start with cross-validation approach, you should scale your\n", - "data.\n", - "\n", - "Implement the $k$-fold cross-validation algorithm (write your own\n", - "code) and evaluate again the MSE function resulting\n", - "from the test folds. You can compare your own code with that from\n", - "**Scikit-Learn** if needed. \n", - "\n", - "Compare the MSE you get from your cross-validation code with the one\n", - "you got from your **bootstrap** code. Comment your results. Try $5-10$\n", - "folds. You can also compare your own cross-validation code with the\n", - "one provided by **Scikit-Learn**.\n", - "\n", - "\n", - "### Exercise: Ridge Regression on the Franke function with resampling\n", - "\n", - "Write your own code for the Ridge method, either using matrix\n", - "inversion or the singular value decomposition as done in the previous\n", - "exercise. Perform the same bootstrap analysis as in the\n", - "Exercise 2 (for the same polynomials) and the cross-validation in exercise 3 but now for different values of $\\lambda$. Compare and\n", - "analyze your results with those obtained in exercises 1-3. Study the\n", - "dependence on $\\lambda$.\n", - "\n", - "Study also the bias-variance trade-off as function of various values of\n", - "the parameter $\\lambda$. For the bias-variance trade-off, use the **bootstrap** resampling method. Comment your results. \n", - "\n", - "### Exercise: Lasso Regression on the Franke function with resampling\n", - "\n", - "This exercise is essentially a repeat of the previous two ones, but now\n", - "with Lasso regression. Write either your own code (difficult and optional) or, in this case,\n", - "you can also use the functionalities of **Scikit-Learn** (recommended). \n", - "Give a\n", - "critical discussion of the three methods and a judgement of which\n", - "model fits the data best. Perform here as well an analysis of the bias-variance trade-off using the **bootstrap** resampling technique and an analysis of the mean squared error using cross-validation. \n", - "\n", - "### Exercise: Analysis of real data\n", - "\n", - "With our codes functioning and having been tested properly on a\n", - "simpler function we are now ready to look at real data. We will\n", - "essentially repeat in this exercise what was done in exercises 1-5. However, we\n", - "need first to download the data and prepare properly the inputs to our\n", - "codes. We are going to download digital terrain data from the website\n", - ",\n", - "\n", - "Or, if you prefer, we have placed selected datafiles at \n", - "\n", - "In order to obtain data for a specific region, you need to register as\n", - "a user (free) at this website and then decide upon which area you want\n", - "to fetch the digital terrain data from. In order to be able to read\n", - "the data properly, you need to specify that the format should be **SRTM\n", - "Arc-Second Global** and download the data as a **GeoTIF** file. The\n", - "files are then stored in *tif* format which can be imported into a\n", - "Python program using" - ] - }, - { - "cell_type": "code", - "execution_count": 31, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "ename": "NameError", - "evalue": "name 'scipy' is not defined", - "output_type": "error", - "traceback": [ - "\u001b[0;31m---------------------------------------------------------------------------\u001b[0m", - "\u001b[0;31mNameError\u001b[0m Traceback (most recent call last)", - "\u001b[0;32m\u001b[0m in \u001b[0;36m\u001b[0;34m\u001b[0m\n\u001b[0;32m----> 1\u001b[0;31m \u001b[0mscipy\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mmisc\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mimread\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0m", - "\u001b[0;31mNameError\u001b[0m: name 'scipy' is not defined" - ] - } - ], - "source": [ - "scipy.misc.imread" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Here is a simple part of a Python code which reads and plots the data\n", - "from such files" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "\"\"\"\n", - "import numpy as np\n", - "from imageio import imread\n", - "import matplotlib.pyplot as plt\n", - "from mpl_toolkits.mplot3d import Axes3D\n", - "from matplotlib import cm\n", - "\n", - "# Load the terrain\n", - "terrain1 = imread('SRTM_data_Norway_1.tif')\n", - "# Show the terrain\n", - "plt.figure()\n", - "plt.title('Terrain over Norway 1')\n", - "plt.imshow(terrain1, cmap='gray')\n", - "plt.xlabel('X')\n", - "plt.ylabel('Y')\n", - "plt.show()\n", - "\"\"\"" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "If you should have problems in downloading the digital terrain data,\n", - "we provide two examples under the data folder of project 1. One is\n", - "from a region close to Stavanger in Norway and the other Møsvatn\n", - "Austfjell, again in Norway.\n", - "Feel free to produce your own terrain data.\n", - "\n", - "\n", - "Alternatively, if you would like to use another data set, feel free to do so. This could be data close to your reseach area or simply a data set you found interesting. See for example [kaggle.com](https://www.kaggle.com/datasets) for examples.\n", - "\n", - "\n", - "Our final part deals with the parameterization of your digital terrain\n", - "data (or your own data). We will apply all three methods for linear regression, the same type (or higher order) of polynomial\n", - "approximation and cross-validation as resampling technique to evaluate which\n", - "model fits the data best.\n", - "\n", - "At the end, you should present a critical evaluation of your results\n", - "and discuss the applicability of these regression methods to the type\n", - "of data presented here (either the terrain data we propose or other data sets)." - ] - } - ], - "metadata": { - "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.8.5" - } - }, - "nbformat": 4, - "nbformat_minor": 4 -} \ No newline at end of file diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3.py b/doc/LectureNotes/_build/jupyter_execute/chapter3.py deleted file mode 100644 index 8f21e2cc5..000000000 --- a/doc/LectureNotes/_build/jupyter_execute/chapter3.py +++ /dev/null @@ -1,2402 +0,0 @@ -# Resampling Methods - -## Introduction - -Resampling methods are an indispensable tool in modern -statistics. They involve repeatedly drawing samples from a training -set and refitting a model of interest on each sample in order to -obtain additional information about the fitted model. For example, in -order to estimate the variability of a linear regression fit, we can -repeatedly draw different samples from the training data, fit a linear -regression to each new sample, and then examine the extent to which -the resulting fits differ. Such an approach may allow us to obtain -information that would not be available from fitting the model only -once using the original training sample. - -Two resampling methods are often used in Machine Learning analyses, -1. The **bootstrap method** - -2. and **Cross-Validation** - -In addition there are several other methods such as the Jackknife and the Blocking methods. We will discuss in particular -cross-validation and the bootstrap method. - - -Resampling approaches can be computationally expensive, because they -involve fitting the same statistical method multiple times using -different subsets of the training data. However, due to recent -advances in computing power, the computational requirements of -resampling methods generally are not prohibitive. In this chapter, we -discuss two of the most commonly used resampling methods, -cross-validation and the bootstrap. Both methods are important tools -in the practical application of many statistical learning -procedures. For example, cross-validation can be used to estimate the -test error associated with a given statistical learning method in -order to evaluate its performance, or to select the appropriate level -of flexibility. The process of evaluating a model’s performance is -known as model assessment, whereas the process of selecting the proper -level of flexibility for a model is known as model selection. The -bootstrap is widely used. - - -* Our simulations can be treated as *computer experiments*. This is particularly the case for Monte Carlo methods - -* The results can be analysed with the same statistical tools as we would use analysing experimental data. - -* As in all experiments, we are looking for expectation values and an estimate of how accurate they are, i.e., possible sources for errors. - -## Reminder on Statistics - - -* As in other experiments, many numerical experiments have two classes of errors: - - * Statistical errors - - * Systematical errors - - -* Statistical errors can be estimated using standard tools from statistics - -* Systematical errors are method specific and must be treated differently from case to case. - -The -advantage of doing linear regression is that we actually end up with -analytical expressions for several statistical quantities. -Standard least squares and Ridge regression allow us to -derive quantities like the variance and other expectation values in a -rather straightforward way. - - -It is assumed that $\varepsilon_i -\sim \mathcal{N}(0, \sigma^2)$ and the $\varepsilon_{i}$ are -independent, i.e.: - -$$ -\begin{align*} -\mbox{Cov}(\varepsilon_{i_1}, -\varepsilon_{i_2}) & = \left\{ \begin{array}{lcc} \sigma^2 & \mbox{if} -& i_1 = i_2, \\ 0 & \mbox{if} & i_1 \not= i_2. \end{array} \right. -\end{align*} -$$ - -The randomness of $\varepsilon_i$ implies that -$\mathbf{y}_i$ is also a random variable. In particular, -$\mathbf{y}_i$ is normally distributed, because $\varepsilon_i \sim -\mathcal{N}(0, \sigma^2)$ and $\mathbf{X}_{i,\ast} \, \boldsymbol{\beta}$ is a -non-random scalar. To specify the parameters of the distribution of -$\mathbf{y}_i$ we need to calculate its first two moments. - -Recall that $\boldsymbol{X}$ is a matrix of dimensionality $n\times p$. The -notation above $\mathbf{X}_{i,\ast}$ means that we are looking at the -row number $i$ and perform a sum over all values $p$. - - -The assumption we have made here can be summarized as (and this is going to be useful when we discuss the bias-variance trade off) -that there exists a function $f(\boldsymbol{x})$ and a normal distributed error $\boldsymbol{\varepsilon}\sim \mathcal{N}(0, \sigma^2)$ -which describe our data - -$$ -\boldsymbol{y} = f(\boldsymbol{x})+\boldsymbol{\varepsilon} -$$ - -We approximate this function with our model from the solution of the linear regression equations, that is our -function $f$ is approximated by $\boldsymbol{\tilde{y}}$ where we want to minimize $(\boldsymbol{y}-\boldsymbol{\tilde{y}})^2$, our MSE, with - -$$ -\boldsymbol{\tilde{y}} = \boldsymbol{X}\boldsymbol{\beta}. -$$ - -We can calculate the expectation value of $\boldsymbol{y}$ for a given element $i$ - -$$ -\begin{align*} -\mathbb{E}(y_i) & = -\mathbb{E}(\mathbf{X}_{i, \ast} \, \boldsymbol{\beta}) + \mathbb{E}(\varepsilon_i) -\, \, \, = \, \, \, \mathbf{X}_{i, \ast} \, \beta, -\end{align*} -$$ - -while -its variance is - -$$ -\begin{align*} \mbox{Var}(y_i) & = \mathbb{E} \{ [y_i -- \mathbb{E}(y_i)]^2 \} \, \, \, = \, \, \, \mathbb{E} ( y_i^2 ) - -[\mathbb{E}(y_i)]^2 \\ & = \mathbb{E} [ ( \mathbf{X}_{i, \ast} \, -\beta + \varepsilon_i )^2] - ( \mathbf{X}_{i, \ast} \, \boldsymbol{\beta})^2 \\ & -= \mathbb{E} [ ( \mathbf{X}_{i, \ast} \, \boldsymbol{\beta})^2 + 2 \varepsilon_i -\mathbf{X}_{i, \ast} \, \boldsymbol{\beta} + \varepsilon_i^2 ] - ( \mathbf{X}_{i, -\ast} \, \beta)^2 \\ & = ( \mathbf{X}_{i, \ast} \, \boldsymbol{\beta})^2 + 2 -\mathbb{E}(\varepsilon_i) \mathbf{X}_{i, \ast} \, \boldsymbol{\beta} + -\mathbb{E}(\varepsilon_i^2 ) - ( \mathbf{X}_{i, \ast} \, \boldsymbol{\beta})^2 -\\ & = \mathbb{E}(\varepsilon_i^2 ) \, \, \, = \, \, \, -\mbox{Var}(\varepsilon_i) \, \, \, = \, \, \, \sigma^2. -\end{align*} -$$ - -Hence, $y_i \sim \mathcal{N}( \mathbf{X}_{i, \ast} \, \boldsymbol{\beta}, \sigma^2)$, that is $\boldsymbol{y}$ follows a normal distribution with -mean value $\boldsymbol{X}\boldsymbol{\beta}$ and variance $\sigma^2$ (not be confused with the singular values of the SVD). - - -With the OLS expressions for the parameters $\boldsymbol{\beta}$ we can evaluate the expectation value - -$$ -\mathbb{E}(\boldsymbol{\beta}) = \mathbb{E}[ (\mathbf{X}^{\top} \mathbf{X})^{-1}\mathbf{X}^{T} \mathbf{Y}]=(\mathbf{X}^{T} \mathbf{X})^{-1}\mathbf{X}^{T} \mathbb{E}[ \mathbf{Y}]=(\mathbf{X}^{T} \mathbf{X})^{-1} \mathbf{X}^{T}\mathbf{X}\boldsymbol{\beta}=\boldsymbol{\beta}. -$$ - -This means that the estimator of the regression parameters is unbiased. -v -We can also calculate the variance - -The variance of $\boldsymbol{\beta}$ is - -$$ -\begin{eqnarray*} -\mbox{Var}(\boldsymbol{\beta}) & = & \mathbb{E} \{ [\boldsymbol{\beta} - \mathbb{E}(\boldsymbol{\beta})] [\boldsymbol{\beta} - \mathbb{E}(\boldsymbol{\beta})]^{T} \} -\\ -& = & \mathbb{E} \{ [(\mathbf{X}^{T} \mathbf{X})^{-1} \, \mathbf{X}^{T} \mathbf{Y} - \boldsymbol{\beta}] \, [(\mathbf{X}^{T} \mathbf{X})^{-1} \, \mathbf{X}^{T} \mathbf{Y} - \boldsymbol{\beta}]^{T} \} -\\ -% & = & \mathbb{E} \{ [(\mathbf{X}^{T} \mathbf{X})^{-1} \, \mathbf{X}^{T} \mathbf{Y}] \, [(\mathbf{X}^{T} \mathbf{X})^{-1} \, \mathbf{X}^{T} \mathbf{Y}]^{T} \} - \boldsymbol{\beta} \, \boldsymbol{\beta}^{T} -% \\ -% & = & \mathbb{E} \{ (\mathbf{X}^{T} \mathbf{X})^{-1} \, \mathbf{X}^{T} \mathbf{Y} \, \mathbf{Y}^{T} \, \mathbf{X} \, (\mathbf{X}^{T} \mathbf{X})^{-1} \} - \boldsymbol{\beta} \, \boldsymbol{\beta}^{T} -% \\ -& = & (\mathbf{X}^{T} \mathbf{X})^{-1} \, \mathbf{X}^{T} \, \mathbb{E} \{ \mathbf{Y} \, \mathbf{Y}^{T} \} \, \mathbf{X} \, (\mathbf{X}^{T} \mathbf{X})^{-1} - \boldsymbol{\beta} \, \boldsymbol{\beta}^{T} -\\ -& = & (\mathbf{X}^{T} \mathbf{X})^{-1} \, \mathbf{X}^{T} \, \{ \mathbf{X} \, \boldsymbol{\beta} \, \boldsymbol{\beta}^{T} \, \mathbf{X}^{T} + \sigma^2 \} \, \mathbf{X} \, (\mathbf{X}^{T} \mathbf{X})^{-1} - \boldsymbol{\beta} \, \boldsymbol{\beta}^{T} -% \\ -% & = & (\mathbf{X}^T \mathbf{X})^{-1} \, \mathbf{X}^T \, \mathbf{X} \, \boldsymbol{\beta} \, \boldsymbol{\beta}^T \, \mathbf{X}^T \, \mathbf{X} \, (\mathbf{X}^T % \mathbf{X})^{-1} -% \\ -% & & + \, \, \sigma^2 \, (\mathbf{X}^T \mathbf{X})^{-1} \, \mathbf{X}^T \, \mathbf{X} \, (\mathbf{X}^T \mathbf{X})^{-1} - \boldsymbol{\beta} \boldsymbol{\beta}^T -\\ -& = & \boldsymbol{\beta} \, \boldsymbol{\beta}^{T} + \sigma^2 \, (\mathbf{X}^{T} \mathbf{X})^{-1} - \boldsymbol{\beta} \, \boldsymbol{\beta}^{T} -\, \, \, = \, \, \, \sigma^2 \, (\mathbf{X}^{T} \mathbf{X})^{-1}, -\end{eqnarray*} -$$ - -where we have used that $\mathbb{E} (\mathbf{Y} \mathbf{Y}^{T}) = -\mathbf{X} \, \boldsymbol{\beta} \, \boldsymbol{\beta}^{T} \, \mathbf{X}^{T} + -\sigma^2 \, \mathbf{I}_{nn}$. From $\mbox{Var}(\boldsymbol{\beta}) = \sigma^2 -\, (\mathbf{X}^{T} \mathbf{X})^{-1}$, one obtains an estimate of the -variance of the estimate of the $j$-th regression coefficient: -$\boldsymbol{\sigma}^2 (\boldsymbol{\beta}_j ) = \boldsymbol{\sigma}^2 \sqrt{ -[(\mathbf{X}^{T} \mathbf{X})^{-1}]_{jj} }$. This may be used to -construct a confidence interval for the estimates. - - -In a similar way, we can obtain analytical expressions for say the -expectation values of the parameters $\boldsymbol{\beta}$ and their variance -when we employ Ridge regression, allowing us again to define a confidence interval. - -It is rather straightforward to show that - -$$ -\mathbb{E} \big[ \boldsymbol{\beta}^{\mathrm{Ridge}} \big]=(\mathbf{X}^{T} \mathbf{X} + \lambda \mathbf{I}_{pp})^{-1} (\mathbf{X}^{\top} \mathbf{X})\boldsymbol{\beta}^{\mathrm{OLS}}. -$$ - -We see clearly that -$\mathbb{E} \big[ \boldsymbol{\beta}^{\mathrm{Ridge}} \big] \not= \boldsymbol{\beta}^{\mathrm{OLS}}$ for any $\lambda > 0$. We say then that the ridge estimator is biased. - -We can also compute the variance as - -$$ -\mbox{Var}[\boldsymbol{\beta}^{\mathrm{Ridge}}]=\sigma^2[ \mathbf{X}^{T} \mathbf{X} + \lambda \mathbf{I} ]^{-1} \mathbf{X}^{T} \mathbf{X} \{ [ \mathbf{X}^{\top} \mathbf{X} + \lambda \mathbf{I} ]^{-1}\}^{T}, -$$ - -and it is easy to see that if the parameter $\lambda$ goes to infinity then the variance of Ridge parameters $\boldsymbol{\beta}$ goes to zero. - -With this, we can compute the difference - -$$ -\mbox{Var}[\boldsymbol{\beta}^{\mathrm{OLS}}]-\mbox{Var}(\boldsymbol{\beta}^{\mathrm{Ridge}})=\sigma^2 [ \mathbf{X}^{T} \mathbf{X} + \lambda \mathbf{I} ]^{-1}[ 2\lambda\mathbf{I} + \lambda^2 (\mathbf{X}^{T} \mathbf{X})^{-1} ] \{ [ \mathbf{X}^{T} \mathbf{X} + \lambda \mathbf{I} ]^{-1}\}^{T}. -$$ - -The difference is non-negative definite since each component of the -matrix product is non-negative definite. -This means the variance we obtain with the standard OLS will always for $\lambda > 0$ be larger than the variance of $\boldsymbol{\beta}$ obtained with the Ridge estimator. This has interesting consequences when we discuss the so-called bias-variance trade-off below. - - - -## Resampling methods - -With all these analytical equations for both the OLS and Ridge -regression, we will now outline how to assess a given model. This will -lead us to a discussion of the so-called bias-variance tradeoff (see -below) and so-called resampling methods. - -One of the quantities we have discussed as a way to measure errors is -the mean-squared error (MSE), mainly used for fitting of continuous -functions. Another choice is the absolute error. - -In the discussions below we will focus on the MSE and in particular since we will split the data into test and training data, -we discuss the -1. prediction error or simply the **test error** $\mathrm{Err_{Test}}$, where we have a fixed training set and the test error is the MSE arising from the data reserved for testing. We discuss also the - -2. training error $\mathrm{Err_{Train}}$, which is the average loss over the training data. - -As our model becomes more and more complex, more of the training data tends to used. The training may thence adapt to more complicated structures in the data. This may lead to a decrease in the bias (see below for code example) and a slight increase of the variance for the test error. -For a certain level of complexity the test error will reach minimum, before starting to increase again. The -training error reaches a saturation. - - - -Two famous -resampling methods are the **independent bootstrap** and **the jackknife**. - -The jackknife is a special case of the independent bootstrap. Still, the jackknife was made -popular prior to the independent bootstrap. And as the popularity of -the independent bootstrap soared, new variants, such as **the dependent bootstrap**. - -The Jackknife and independent bootstrap work for -independent, identically distributed random variables. -If these conditions are not -satisfied, the methods will fail. Yet, it should be said that if the data are -independent, identically distributed, and we only want to estimate the -variance of $\overline{X}$ (which often is the case), then there is no -need for bootstrapping. - - -The Jackknife works by making many replicas of the estimator $\widehat{\beta}$. -The jackknife is a resampling method where we systematically leave out one observation from the vector of observed values $\boldsymbol{x} = (x_1,x_2,\cdots,X_n)$. -Let $\boldsymbol{x}_i$ denote the vector - -$$ -\boldsymbol{x}_i = (x_1,x_2,\cdots,x_{i-1},x_{i+1},\cdots,x_n), -$$ - -which equals the vector $\boldsymbol{x}$ with the exception that observation -number $i$ is left out. Using this notation, define -$\widehat{\beta}_i$ to be the estimator -$\widehat{\beta}$ computed using $\vec{X}_i$. - -from numpy import * -from numpy.random import randint, randn -from time import time - -def jackknife(data, stat): - n = len(data);t = zeros(n); inds = arange(n); t0 = time() - ## 'jackknifing' by leaving out an observation for each i - for i in range(n): - t[i] = stat(delete(data,i) ) - - # analysis - print("Runtime: %g sec" % (time()-t0)); print("Jackknife Statistics :") - print("original bias std. error") - print("%8g %14g %15g" % (stat(data),(n-1)*mean(t)/n, (n*var(t))**.5)) - - return t - - -# Returns mean of data samples -def stat(data): - return mean(data) - - -mu, sigma = 100, 15 -datapoints = 10000 -x = mu + sigma*random.randn(datapoints) -# jackknife returns the data sample -t = jackknife(x, stat) - -### Bootstrap - -Bootstrapping is a nonparametric approach to statistical inference -that substitutes computation for more traditional distributional -assumptions and asymptotic results. Bootstrapping offers a number of -advantages: -1. The bootstrap is quite general, although there are some cases in which it fails. - -2. Because it does not require distributional assumptions (such as normally distributed errors), the bootstrap can provide more accurate inferences when the data are not well behaved or when the sample size is small. - -3. It is possible to apply the bootstrap to statistics with sampling distributions that are difficult to derive, even asymptotically. - -4. It is relatively simple to apply the bootstrap to complex data-collection plans (such as stratified and clustered samples). - -Since $\widehat{\beta} = \widehat{\beta}(\boldsymbol{X})$ is a function of random variables, -$\widehat{\beta}$ itself must be a random variable. Thus it has -a pdf, call this function $p(\boldsymbol{t})$. The aim of the bootstrap is to -estimate $p(\boldsymbol{t})$ by the relative frequency of -$\widehat{\beta}$. You can think of this as using a histogram -in the place of $p(\boldsymbol{t})$. If the relative frequency closely -resembles $p(\vec{t})$, then using numerics, it is straight forward to -estimate all the interesting parameters of $p(\boldsymbol{t})$ using point -estimators. - - - -In the case that $\widehat{\beta}$ has -more than one component, and the components are independent, we use the -same estimator on each component separately. If the probability -density function of $X_i$, $p(x)$, had been known, then it would have -been straight forward to do this by: -1. Drawing lots of numbers from $p(x)$, suppose we call one such set of numbers $(X_1^*, X_2^*, \cdots, X_n^*)$. - -2. Then using these numbers, we could compute a replica of $\widehat{\beta}$ called $\widehat{\beta}^*$. - -By repeated use of (1) and (2), many -estimates of $\widehat{\beta}$ could have been obtained. The -idea is to use the relative frequency of $\widehat{\beta}^*$ -(think of a histogram) as an estimate of $p(\boldsymbol{t})$. - - -But -unless there is enough information available about the process that -generated $X_1,X_2,\cdots,X_n$, $p(x)$ is in general -unknown. Therefore, [Efron in 1979](https://projecteuclid.org/euclid.aos/1176344552) asked the -question: What if we replace $p(x)$ by the relative frequency -of the observation $X_i$; if we draw observations in accordance with -the relative frequency of the observations, will we obtain the same -result in some asymptotic sense? The answer is yes. - - -Instead of generating the histogram for the relative -frequency of the observation $X_i$, just draw the values -$(X_1^*,X_2^*,\cdots,X_n^*)$ with replacement from the vector -$\boldsymbol{X}$. - - -The independent bootstrap works like this: - -1. Draw with replacement $n$ numbers for the observed variables $\boldsymbol{x} = (x_1,x_2,\cdots,x_n)$. - -2. Define a vector $\boldsymbol{x}^*$ containing the values which were drawn from $\boldsymbol{x}$. - -3. Using the vector $\boldsymbol{x}^*$ compute $\widehat{\beta}^*$ by evaluating $\widehat \beta$ under the observations $\boldsymbol{x}^*$. - -4. Repeat this process $k$ times. - -When you are done, you can draw a histogram of the relative frequency -of $\widehat \beta^*$. This is your estimate of the probability -distribution $p(t)$. Using this probability distribution you can -estimate any statistics thereof. In principle you never draw the -histogram of the relative frequency of $\widehat{\beta}^*$. Instead -you use the estimators corresponding to the statistic of interest. For -example, if you are interested in estimating the variance of $\widehat -\beta$, apply the etsimator $\widehat \sigma^2$ to the values -$\widehat \beta^*$. - -Before we proceed however, we need to remind ourselves about a central -theorem in statistics, namely the so-called **central limit theorem**. -This theorem plays a central role in understanding why the Bootstrap -(and other resampling methods) work so well on independent and -identically distributed variables. - - -Suppose we have a PDF $p(x)$ from which we generate a series $N$ -of averages $\langle x_i \rangle$. Each mean value $\langle x_i \rangle$ -is viewed as the average of a specific measurement, e.g., throwing -dice 100 times and then taking the average value, or producing a certain -amount of random numbers. -For notational ease, we set $\langle x_i \rangle=x_i$ in the discussion -which follows. - -If we compute the mean $z$ of $m$ such mean values $x_i$ - -$$ -z=\frac{x_1+x_2+\dots+x_m}{m}, -$$ - -the question we pose is which is the PDF of the new variable $z$. - - -The probability of obtaining an average value $z$ is the product of the -probabilities of obtaining arbitrary individual mean values $x_i$, -but with the constraint that the average is $z$. We can express this through -the following expression - -$$ -\tilde{p}(z)=\int dx_1p(x_1)\int dx_2p(x_2)\dots\int dx_mp(x_m) - \delta(z-\frac{x_1+x_2+\dots+x_m}{m}), -$$ - -where the $\delta$-function enbodies the constraint that the mean is $z$. -All measurements that lead to each individual $x_i$ are expected to -be independent, which in turn means that we can express $\tilde{p}$ as the -product of individual $p(x_i)$. The independence assumption is important in the derivation of the central limit theorem. - - - -If we use the integral expression for the $\delta$-function - -$$ -\delta(z-\frac{x_1+x_2+\dots+x_m}{m})=\frac{1}{2\pi}\int_{-\infty}^{\infty} - dq\exp{\left(iq(z-\frac{x_1+x_2+\dots+x_m}{m})\right)}, -$$ - -and inserting $e^{i\mu q-i\mu q}$ where $\mu$ is the mean value -we arrive at - -$$ -\tilde{p}(z)=\frac{1}{2\pi}\int_{-\infty}^{\infty} - dq\exp{\left(iq(z-\mu)\right)}\left[\int_{-\infty}^{\infty} - dxp(x)\exp{\left(iq(\mu-x)/m\right)}\right]^m, -$$ - -with the integral over $x$ resulting in - -$$ -\int_{-\infty}^{\infty}dxp(x)\exp{\left(iq(\mu-x)/m\right)}= - \int_{-\infty}^{\infty}dxp(x) - \left[1+\frac{iq(\mu-x)}{m}-\frac{q^2(\mu-x)^2}{2m^2}+\dots\right]. -$$ - -The second term on the rhs disappears since this is just the mean and -employing the definition of $\sigma^2$ we have - -$$ -\int_{-\infty}^{\infty}dxp(x)e^{\left(iq(\mu-x)/m\right)}= - 1-\frac{q^2\sigma^2}{2m^2}+\dots, -$$ - -resulting in - -$$ -\left[\int_{-\infty}^{\infty}dxp(x)\exp{\left(iq(\mu-x)/m\right)}\right]^m\approx - \left[1-\frac{q^2\sigma^2}{2m^2}+\dots \right]^m, -$$ - -and in the limit $m\rightarrow \infty$ we obtain - -$$ -\tilde{p}(z)=\frac{1}{\sqrt{2\pi}(\sigma/\sqrt{m})} - \exp{\left(-\frac{(z-\mu)^2}{2(\sigma/\sqrt{m})^2}\right)}, -$$ - -which is the normal distribution with variance -$\sigma^2_m=\sigma^2/m$, where $\sigma$ is the variance of the PDF $p(x)$ -and $\mu$ is also the mean of the PDF $p(x)$. - - -Thus, the central limit theorem states that the PDF $\tilde{p}(z)$ of -the average of $m$ random values corresponding to a PDF $p(x)$ -is a normal distribution whose mean is the -mean value of the PDF $p(x)$ and whose variance is the variance -of the PDF $p(x)$ divided by $m$, the number of values used to compute $z$. - -The central limit theorem leads to the well-known expression for the -standard deviation, given by - -$$ -\sigma_m= -\frac{\sigma}{\sqrt{m}}. -$$ - -The latter is true only if the average value is known exactly. This is obtained in the limit -$m\rightarrow \infty$ only. Because the mean and the variance are measured quantities we obtain -the familiar expression in statistics - -$$ -\sigma_m\approx -\frac{\sigma}{\sqrt{m-1}}. -$$ - -In many cases however the above estimate for the standard deviation, -in particular if correlations are strong, may be too simplistic. Keep -in mind that we have assumed that the variables $x$ are independent -and identically distributed. This is obviously not always the -case. For example, the random numbers (or better pseudorandom numbers) -we generate in various calculations do always exhibit some -correlations. - - - -The theorem is satisfied by a large class of PDFs. Note however that for a -finite $m$, it is not always possible to find a closed form /analytic expression for -$\tilde{p}(x)$. - - -The following code starts with a Gaussian distribution with mean value -$\mu =100$ and variance $\sigma=15$. We use this to generate the data -used in the bootstrap analysis. The bootstrap analysis returns a data -set after a given number of bootstrap operations (as many as we have -data points). This data set consists of estimated mean values for each -bootstrap operation. The histogram generated by the bootstrap method -shows that the distribution for these mean values is also a Gaussian, -centered around the mean value $\mu=100$ but with standard deviation -$\sigma/\sqrt{n}$, where $n$ is the number of bootstrap samples (in -this case the same as the number of original data points). The value -of the standard deviation is what we expect from the central limit -theorem. - -%matplotlib inline - -import numpy as np -from time import time -from scipy.stats import norm -import matplotlib.pyplot as plt - -# Returns mean of bootstrap samples -# Bootstrap algorithm -def bootstrap(data, datapoints): - t = np.zeros(datapoints) - n = len(data) - # non-parametric bootstrap - for i in range(datapoints): - t[i] = np.mean(data[np.random.randint(0,n,n)]) - # analysis - print("Bootstrap Statistics :") - print("original bias std. error") - print("%8g %8g %14g %15g" % (np.mean(data), np.std(data),np.mean(t),np.std(t))) - return t - -# We set the mean value to 100 and the standard deviation to 15 -mu, sigma = 100, 15 -datapoints = 10000 -# We generate random numbers according to the normal distribution -x = mu + sigma*np.random.randn(datapoints) -# bootstrap returns the data sample -t = bootstrap(x, datapoints) - -We see that our new variance and from that the standard deviation, agrees with the central limit theorem. - -We plot then the histogram together with a best fit for the data set. - -# the histogram of the bootstrapped data (normalized data if density = True) -n, binsboot, patches = plt.hist(t, 50, density=True, facecolor='red', alpha=0.75) -# add a 'best fit' line -y = norm.pdf(binsboot, np.mean(t), np.std(t)) -lt = plt.plot(binsboot, y, 'b', linewidth=1) -plt.xlabel('x') -plt.ylabel('Probability') -plt.grid(True) -plt.show() - -## The bias-variance tradeoff - - -We will discuss the bias-variance tradeoff in the context of -continuous predictions such as regression. However, many of the -intuitions and ideas discussed here also carry over to classification -tasks. Consider a dataset $\mathcal{L}$ consisting of the data -$\mathbf{X}_\mathcal{L}=\{(y_j, \boldsymbol{x}_j), j=0\ldots n-1\}$. - -Let us assume that the true data is generated from a noisy model - -$$ -\boldsymbol{y}=f(\boldsymbol{x}) + \boldsymbol{\epsilon} -$$ - -where $\epsilon$ is normally distributed with mean zero and standard deviation $\sigma^2$. - -In our derivation of the ordinary least squares method we defined then -an approximation to the function $f$ in terms of the parameters -$\boldsymbol{\beta}$ and the design matrix $\boldsymbol{X}$ which embody our model, -that is $\boldsymbol{\tilde{y}}=\boldsymbol{X}\boldsymbol{\beta}$. - -Thereafter we found the parameters $\boldsymbol{\beta}$ by optimizing the means squared error via the so-called cost function - -$$ -C(\boldsymbol{X},\boldsymbol{\beta}) =\frac{1}{n}\sum_{i=0}^{n-1}(y_i-\tilde{y}_i)^2=\mathbb{E}\left[(\boldsymbol{y}-\boldsymbol{\tilde{y}})^2\right]. -$$ - -We can rewrite this as - -$$ -\mathbb{E}\left[(\boldsymbol{y}-\boldsymbol{\tilde{y}})^2\right]=\frac{1}{n}\sum_i(f_i-\mathbb{E}\left[\boldsymbol{\tilde{y}}\right])^2+\frac{1}{n}\sum_i(\tilde{y}_i-\mathbb{E}\left[\boldsymbol{\tilde{y}}\right])^2+\sigma^2. -$$ - -The three terms represent the square of the bias of the learning -method, which can be thought of as the error caused by the simplifying -assumptions built into the method. The second term represents the -variance of the chosen model and finally the last terms is variance of -the error $\boldsymbol{\epsilon}$. - -To derive this equation, we need to recall that the variance of $\boldsymbol{y}$ and $\boldsymbol{\epsilon}$ are both equal to $\sigma^2$. The mean value of $\boldsymbol{\epsilon}$ is by definition equal to zero. Furthermore, the function $f$ is not a stochastics variable, idem for $\boldsymbol{\tilde{y}}$. -We use a more compact notation in terms of the expectation value - -$$ -\mathbb{E}\left[(\boldsymbol{y}-\boldsymbol{\tilde{y}})^2\right]=\mathbb{E}\left[(\boldsymbol{f}+\boldsymbol{\epsilon}-\boldsymbol{\tilde{y}})^2\right], -$$ - -and adding and subtracting $\mathbb{E}\left[\boldsymbol{\tilde{y}}\right]$ we get - -$$ -\mathbb{E}\left[(\boldsymbol{y}-\boldsymbol{\tilde{y}})^2\right]=\mathbb{E}\left[(\boldsymbol{f}+\boldsymbol{\epsilon}-\boldsymbol{\tilde{y}}+\mathbb{E}\left[\boldsymbol{\tilde{y}}\right]-\mathbb{E}\left[\boldsymbol{\tilde{y}}\right])^2\right], -$$ - -which, using the abovementioned expectation values can be rewritten as - -$$ -\mathbb{E}\left[(\boldsymbol{y}-\boldsymbol{\tilde{y}})^2\right]=\mathbb{E}\left[(\boldsymbol{y}-\mathbb{E}\left[\boldsymbol{\tilde{y}}\right])^2\right]+\mathrm{Var}\left[\boldsymbol{\tilde{y}}\right]+\sigma^2, -$$ - -that is the rewriting in terms of the so-called bias, the variance of the model $\boldsymbol{\tilde{y}}$ and the variance of $\boldsymbol{\epsilon}$. - -import matplotlib.pyplot as plt -import numpy as np -from sklearn.linear_model import LinearRegression, Ridge, Lasso -from sklearn.preprocessing import PolynomialFeatures -from sklearn.model_selection import train_test_split -from sklearn.pipeline import make_pipeline -from sklearn.utils import resample - -np.random.seed(2018) - -n = 500 -n_boostraps = 100 -degree = 18 # A quite high value, just to show. -noise = 0.1 - -# Make data set. -x = np.linspace(-1, 3, n).reshape(-1, 1) -y = np.exp(-x**2) + 1.5 * np.exp(-(x-2)**2) + np.random.normal(0, 0.1, x.shape) - -# Hold out some test data that is never used in training. -x_train, x_test, y_train, y_test = train_test_split(x, y, test_size=0.2) - -# Combine x transformation and model into one operation. -# Not neccesary, but convenient. -model = make_pipeline(PolynomialFeatures(degree=degree), LinearRegression(fit_intercept=False)) - -# The following (m x n_bootstraps) matrix holds the column vectors y_pred -# for each bootstrap iteration. -y_pred = np.empty((y_test.shape[0], n_boostraps)) -for i in range(n_boostraps): - x_, y_ = resample(x_train, y_train) - - # Evaluate the new model on the same test data each time. - y_pred[:, i] = model.fit(x_, y_).predict(x_test).ravel() - -# Note: Expectations and variances taken w.r.t. different training -# data sets, hence the axis=1. Subsequent means are taken across the test data -# set in order to obtain a total value, but before this we have error/bias/variance -# calculated per data point in the test set. -# Note 2: The use of keepdims=True is important in the calculation of bias as this -# maintains the column vector form. Dropping this yields very unexpected results. -error = np.mean( np.mean((y_test - y_pred)**2, axis=1, keepdims=True) ) -bias = np.mean( (y_test - np.mean(y_pred, axis=1, keepdims=True))**2 ) -variance = np.mean( np.var(y_pred, axis=1, keepdims=True) ) -print('Error:', error) -print('Bias^2:', bias) -print('Var:', variance) -print('{} >= {} + {} = {}'.format(error, bias, variance, bias+variance)) - -plt.plot(x[::5, :], y[::5, :], label='f(x)') -plt.scatter(x_test, y_test, label='Data points') -plt.scatter(x_test, np.mean(y_pred, axis=1), label='Pred') -plt.legend() -plt.show() - -import matplotlib.pyplot as plt -import numpy as np -from sklearn.linear_model import LinearRegression, Ridge, Lasso -from sklearn.preprocessing import PolynomialFeatures -from sklearn.model_selection import train_test_split -from sklearn.pipeline import make_pipeline -from sklearn.utils import resample - -np.random.seed(2018) - -n = 40 -n_boostraps = 100 -maxdegree = 14 - - -# Make data set. -x = np.linspace(-3, 3, n).reshape(-1, 1) -y = np.exp(-x**2) + 1.5 * np.exp(-(x-2)**2)+ np.random.normal(0, 0.1, x.shape) -error = np.zeros(maxdegree) -bias = np.zeros(maxdegree) -variance = np.zeros(maxdegree) -polydegree = np.zeros(maxdegree) -x_train, x_test, y_train, y_test = train_test_split(x, y, test_size=0.2) - -for degree in range(maxdegree): - model = make_pipeline(PolynomialFeatures(degree=degree), LinearRegression(fit_intercept=False)) - y_pred = np.empty((y_test.shape[0], n_boostraps)) - for i in range(n_boostraps): - x_, y_ = resample(x_train, y_train) - y_pred[:, i] = model.fit(x_, y_).predict(x_test).ravel() - - polydegree[degree] = degree - error[degree] = np.mean( np.mean((y_test - y_pred)**2, axis=1, keepdims=True) ) - bias[degree] = np.mean( (y_test - np.mean(y_pred, axis=1, keepdims=True))**2 ) - variance[degree] = np.mean( np.var(y_pred, axis=1, keepdims=True) ) - print('Polynomial degree:', degree) - print('Error:', error[degree]) - print('Bias^2:', bias[degree]) - print('Var:', variance[degree]) - print('{} >= {} + {} = {}'.format(error[degree], bias[degree], variance[degree], bias[degree]+variance[degree])) - -plt.plot(polydegree, error, label='Error') -plt.plot(polydegree, bias, label='bias') -plt.plot(polydegree, variance, label='Variance') -plt.legend() -plt.show() - -The bias-variance tradeoff summarizes the fundamental tension in -machine learning, particularly supervised learning, between the -complexity of a model and the amount of training data needed to train -it. Since data is often limited, in practice it is often useful to -use a less-complex model with higher bias, that is a model whose asymptotic -performance is worse than another model because it is easier to -train and less sensitive to sampling noise arising from having a -finite-sized training dataset (smaller variance). - - - -The above equations tell us that in -order to minimize the expected test error, we need to select a -statistical learning method that simultaneously achieves low variance -and low bias. Note that variance is inherently a nonnegative quantity, -and squared bias is also nonnegative. Hence, we see that the expected -test MSE can never lie below $Var(\epsilon)$, the irreducible error. - - -What do we mean by the variance and bias of a statistical learning -method? The variance refers to the amount by which our model would change if we -estimated it using a different training data set. Since the training -data are used to fit the statistical learning method, different -training data sets will result in a different estimate. But ideally the -estimate for our model should not vary too much between training -sets. However, if a method has high variance then small changes in -the training data can result in large changes in the model. In general, more -flexible statistical methods have higher variance. - - -You may also find this recent [article](https://www.pnas.org/content/116/32/15849) of interest. - -""" -============================ -Underfitting vs. Overfitting -============================ - -This example demonstrates the problems of underfitting and overfitting and -how we can use linear regression with polynomial features to approximate -nonlinear functions. The plot shows the function that we want to approximate, -which is a part of the cosine function. In addition, the samples from the -real function and the approximations of different models are displayed. The -models have polynomial features of different degrees. We can see that a -linear function (polynomial with degree 1) is not sufficient to fit the -training samples. This is called **underfitting**. A polynomial of degree 4 -approximates the true function almost perfectly. However, for higher degrees -the model will **overfit** the training data, i.e. it learns the noise of the -training data. -We evaluate quantitatively **overfitting** / **underfitting** by using -cross-validation. We calculate the mean squared error (MSE) on the validation -set, the higher, the less likely the model generalizes correctly from the -training data. -""" - -print(__doc__) - -import numpy as np -import matplotlib.pyplot as plt -from sklearn.pipeline import Pipeline -from sklearn.preprocessing import PolynomialFeatures -from sklearn.linear_model import LinearRegression -from sklearn.model_selection import cross_val_score - - -def true_fun(X): - return np.cos(1.5 * np.pi * X) - -np.random.seed(0) - -n_samples = 30 -degrees = [1, 4, 15] - -X = np.sort(np.random.rand(n_samples)) -y = true_fun(X) + np.random.randn(n_samples) * 0.1 - -plt.figure(figsize=(14, 5)) -for i in range(len(degrees)): - ax = plt.subplot(1, len(degrees), i + 1) - plt.setp(ax, xticks=(), yticks=()) - - polynomial_features = PolynomialFeatures(degree=degrees[i], - include_bias=False) - linear_regression = LinearRegression() - pipeline = Pipeline([("polynomial_features", polynomial_features), - ("linear_regression", linear_regression)]) - pipeline.fit(X[:, np.newaxis], y) - - # Evaluate the models using crossvalidation - scores = cross_val_score(pipeline, X[:, np.newaxis], y, - scoring="neg_mean_squared_error", cv=10) - - X_test = np.linspace(0, 1, 100) - plt.plot(X_test, pipeline.predict(X_test[:, np.newaxis]), label="Model") - plt.plot(X_test, true_fun(X_test), label="True function") - plt.scatter(X, y, edgecolor='b', s=20, label="Samples") - plt.xlabel("x") - plt.ylabel("y") - plt.xlim((0, 1)) - plt.ylim((-2, 2)) - plt.legend(loc="best") - plt.title("Degree {}\nMSE = {:.2e}(+/- {:.2e})".format( - degrees[i], -scores.mean(), scores.std())) -plt.show() - -# Common imports -import os -import numpy as np -import pandas as pd -import matplotlib.pyplot as plt -from sklearn.linear_model import LinearRegression, Ridge, Lasso -from sklearn.model_selection import train_test_split -from sklearn.utils import resample -from sklearn.metrics import mean_squared_error -# Where to save the figures and data files -PROJECT_ROOT_DIR = "Results" -FIGURE_ID = "Results/FigureFiles" -DATA_ID = "DataFiles/" - -if not os.path.exists(PROJECT_ROOT_DIR): - os.mkdir(PROJECT_ROOT_DIR) - -if not os.path.exists(FIGURE_ID): - os.makedirs(FIGURE_ID) - -if not os.path.exists(DATA_ID): - os.makedirs(DATA_ID) - -def image_path(fig_id): - return os.path.join(FIGURE_ID, fig_id) - -def data_path(dat_id): - return os.path.join(DATA_ID, dat_id) - -def save_fig(fig_id): - plt.savefig(image_path(fig_id) + ".png", format='png') - -infile = open(data_path("EoS.csv"),'r') - -# Read the EoS data as csv file and organize the data into two arrays with density and energies -EoS = pd.read_csv(infile, names=('Density', 'Energy')) -EoS['Energy'] = pd.to_numeric(EoS['Energy'], errors='coerce') -EoS = EoS.dropna() -Energies = EoS['Energy'] -Density = EoS['Density'] -# The design matrix now as function of various polytrops - -Maxpolydegree = 30 -X = np.zeros((len(Density),Maxpolydegree)) -X[:,0] = 1.0 -testerror = np.zeros(Maxpolydegree) -trainingerror = np.zeros(Maxpolydegree) -polynomial = np.zeros(Maxpolydegree) - -trials = 100 -for polydegree in range(1, Maxpolydegree): - polynomial[polydegree] = polydegree - for degree in range(polydegree): - X[:,degree] = Density**(degree/3.0) - -# loop over trials in order to estimate the expectation value of the MSE - testerror[polydegree] = 0.0 - trainingerror[polydegree] = 0.0 - for samples in range(trials): - x_train, x_test, y_train, y_test = train_test_split(X, Energies, test_size=0.2) - model = LinearRegression(fit_intercept=False).fit(x_train, y_train) - ypred = model.predict(x_train) - ytilde = model.predict(x_test) - testerror[polydegree] += mean_squared_error(y_test, ytilde) - trainingerror[polydegree] += mean_squared_error(y_train, ypred) - - testerror[polydegree] /= trials - trainingerror[polydegree] /= trials - print("Degree of polynomial: %3d"% polynomial[polydegree]) - print("Mean squared error on training data: %.8f" % trainingerror[polydegree]) - print("Mean squared error on test data: %.8f" % testerror[polydegree]) - -plt.plot(polynomial, np.log10(trainingerror), label='Training Error') -plt.plot(polynomial, np.log10(testerror), label='Test Error') -plt.xlabel('Polynomial degree') -plt.ylabel('log10[MSE]') -plt.legend() -plt.show() - -## Cross-validation - -When the repetitive splitting of the data set is done randomly, -samples may accidently end up in a fast majority of the splits in -either training or test set. Such samples may have an unbalanced -influence on either model building or prediction evaluation. To avoid -this $k$-fold cross-validation structures the data splitting. The -samples are divided into $k$ more or less equally sized exhaustive and -mutually exclusive subsets. In turn (at each split) one of these -subsets plays the role of the test set while the union of the -remaining subsets constitutes the training set. Such a splitting -warrants a balanced representation of each sample in both training and -test set over the splits. Still the division into the $k$ subsets -involves a degree of randomness. This may be fully excluded when -choosing $k=n$. This particular case is referred to as leave-one-out -cross-validation (LOOCV). - - -* Define a range of interest for the penalty parameter. - -* Divide the data set into training and test set comprising samples $\{1, \ldots, n\} \setminus i$ and $\{ i \}$, respectively. - -* Fit the linear regression model by means of ridge estimation for each $\lambda$ in the grid using the training set, and the corresponding estimate of the error variance $\boldsymbol{\sigma}_{-i}^2(\lambda)$, as - -$$ -\begin{align*} -\boldsymbol{\beta}_{-i}(\lambda) & = ( \boldsymbol{X}_{-i, \ast}^{T} -\boldsymbol{X}_{-i, \ast} + \lambda \boldsymbol{I}_{pp})^{-1} -\boldsymbol{X}_{-i, \ast}^{T} \boldsymbol{y}_{-i} -\end{align*} -$$ - -* Evaluate the prediction performance of these models on the test set by $\log\{L[y_i, \boldsymbol{X}_{i, \ast}; \boldsymbol{\beta}_{-i}(\lambda), \boldsymbol{\sigma}_{-i}^2(\lambda)]\}$. Or, by the prediction error $|y_i - \boldsymbol{X}_{i, \ast} \boldsymbol{\beta}_{-i}(\lambda)|$, the relative error, the error squared or the R2 score function. - -* Repeat the first three steps such that each sample plays the role of the test set once. - -* Average the prediction performances of the test sets at each grid point of the penalty bias/parameter. It is an estimate of the prediction performance of the model corresponding to this value of the penalty parameter on novel data. It is defined as - -$$ -\begin{align*} -\frac{1}{n} \sum_{i = 1}^n \log\{L[y_i, \mathbf{X}_{i, \ast}; \boldsymbol{\beta}_{-i}(\lambda), \boldsymbol{\sigma}_{-i}^2(\lambda)]\}. -\end{align*} -$$ - -For the various values of $k$ - -1. shuffle the dataset randomly. - -2. Split the dataset into $k$ groups. - -3. For each unique group: - -a. Decide which group to use as set for test data - -b. Take the remaining groups as a training data set - -c. Fit a model on the training set and evaluate it on the test set - -d. Retain the evaluation score and discard the model - - -5. Summarize the model using the sample of model evaluation scores - -The code here uses Ridge regression with cross-validation (CV) resampling and $k$-fold CV in order to fit a specific polynomial. - -import numpy as np -import matplotlib.pyplot as plt -from sklearn.model_selection import KFold -from sklearn.linear_model import Ridge -from sklearn.model_selection import cross_val_score -from sklearn.preprocessing import PolynomialFeatures - -# A seed just to ensure that the random numbers are the same for every run. -# Useful for eventual debugging. -np.random.seed(3155) - -# Generate the data. -nsamples = 100 -x = np.random.randn(nsamples) -y = 3*x**2 + np.random.randn(nsamples) - -## Cross-validation on Ridge regression using KFold only - -# Decide degree on polynomial to fit -poly = PolynomialFeatures(degree = 6) - -# Decide which values of lambda to use -nlambdas = 500 -lambdas = np.logspace(-3, 5, nlambdas) - -# Initialize a KFold instance -k = 5 -kfold = KFold(n_splits = k) - -# Perform the cross-validation to estimate MSE -scores_KFold = np.zeros((nlambdas, k)) - -i = 0 -for lmb in lambdas: - ridge = Ridge(alpha = lmb) - j = 0 - for train_inds, test_inds in kfold.split(x): - xtrain = x[train_inds] - ytrain = y[train_inds] - - xtest = x[test_inds] - ytest = y[test_inds] - - Xtrain = poly.fit_transform(xtrain[:, np.newaxis]) - ridge.fit(Xtrain, ytrain[:, np.newaxis]) - - Xtest = poly.fit_transform(xtest[:, np.newaxis]) - ypred = ridge.predict(Xtest) - - scores_KFold[i,j] = np.sum((ypred - ytest[:, np.newaxis])**2)/np.size(ypred) - - j += 1 - i += 1 - - -estimated_mse_KFold = np.mean(scores_KFold, axis = 1) - -## Cross-validation using cross_val_score from sklearn along with KFold - -# kfold is an instance initialized above as: -# kfold = KFold(n_splits = k) - -estimated_mse_sklearn = np.zeros(nlambdas) -i = 0 -for lmb in lambdas: - ridge = Ridge(alpha = lmb) - - X = poly.fit_transform(x[:, np.newaxis]) - estimated_mse_folds = cross_val_score(ridge, X, y[:, np.newaxis], scoring='neg_mean_squared_error', cv=kfold) - - # cross_val_score return an array containing the estimated negative mse for every fold. - # we have to the the mean of every array in order to get an estimate of the mse of the model - estimated_mse_sklearn[i] = np.mean(-estimated_mse_folds) - - i += 1 - -## Plot and compare the slightly different ways to perform cross-validation - -plt.figure() - -plt.plot(np.log10(lambdas), estimated_mse_sklearn, label = 'cross_val_score') -plt.plot(np.log10(lambdas), estimated_mse_KFold, 'r--', label = 'KFold') - -plt.xlabel('log10(lambda)') -plt.ylabel('mse') - -plt.legend() - -plt.show() - -More examples of the application of cross-validation follow here. - -# Common imports -import os -import numpy as np -import pandas as pd -import matplotlib.pyplot as plt -from sklearn.linear_model import LinearRegression, Ridge, Lasso -from sklearn.metrics import mean_squared_error -from sklearn.model_selection import KFold -from sklearn.model_selection import cross_val_score - - -# Where to save the figures and data files -PROJECT_ROOT_DIR = "Results" -FIGURE_ID = "Results/FigureFiles" -DATA_ID = "DataFiles/" - -if not os.path.exists(PROJECT_ROOT_DIR): - os.mkdir(PROJECT_ROOT_DIR) - -if not os.path.exists(FIGURE_ID): - os.makedirs(FIGURE_ID) - -if not os.path.exists(DATA_ID): - os.makedirs(DATA_ID) - -def image_path(fig_id): - return os.path.join(FIGURE_ID, fig_id) - -def data_path(dat_id): - return os.path.join(DATA_ID, dat_id) - -def save_fig(fig_id): - plt.savefig(image_path(fig_id) + ".png", format='png') - -infile = open(data_path("EoS.csv"),'r') - -# Read the EoS data as csv file and organize the data into two arrays with density and energies -EoS = pd.read_csv(infile, names=('Density', 'Energy')) -EoS['Energy'] = pd.to_numeric(EoS['Energy'], errors='coerce') -EoS = EoS.dropna() -Energies = EoS['Energy'] -Density = EoS['Density'] -# The design matrix now as function of various polytrops - -Maxpolydegree = 30 -X = np.zeros((len(Density),Maxpolydegree)) -X[:,0] = 1.0 -estimated_mse_sklearn = np.zeros(Maxpolydegree) -polynomial = np.zeros(Maxpolydegree) -k =5 -kfold = KFold(n_splits = k) - -for polydegree in range(1, Maxpolydegree): - polynomial[polydegree] = polydegree - for degree in range(polydegree): - X[:,degree] = Density**(degree/3.0) - OLS = LinearRegression(fit_intercept=False) -# loop over trials in order to estimate the expectation value of the MSE - estimated_mse_folds = cross_val_score(OLS, X, Energies, scoring='neg_mean_squared_error', cv=kfold) -#[:, np.newaxis] - estimated_mse_sklearn[polydegree] = np.mean(-estimated_mse_folds) - -plt.plot(polynomial, np.log10(estimated_mse_sklearn), label='Test Error') -plt.xlabel('Polynomial degree') -plt.ylabel('log10[MSE]') -plt.legend() -plt.show() - -Note that we have kept the intercept in the first column of design matrix $\boldsymbol{X}$. When we call the corresponding **Scikit-Learn** function we need thus to set the intercept to **False**. Libraries like **Scikit-Learn** normally scale the design matrix and does not fit intercept. See the discussions below. - -## More on Rescaling data - -We end this chapter by adding some words on scaling and how to deal with the intercept for regression cases. - -When you are comparing your own code with for example **Scikit-Learn**'s -library, there are some technicalities to keep in mind. The examples -here demonstrate some of these aspects with potential pitfalls. - -The discussion here focuses on the role of the intercept, how we can -set up the design matrix, what scaling we should use and other topics -which tend confuse us. - -The intercept can be interpreted as the expected value of our -target/output variables when all other predictors are set to zero. -Thus, if we cannot assume that the expected outputs/targets are zero -when all predictors are zero (the columns in the design matrix), it -may be a bad idea to implement a model which penalizes the intercept. -Furthermore, in for example Ridge and Lasso regression, the default solutions -from the library **Scikit-Learn** (when not shrinking $\beta_0$) for the unknown parameters -$\boldsymbol{\beta}$, are derived under the assumption that both $\boldsymbol{y}$ and -$\boldsymbol{X}$ are zero centered, that is we subtract the mean values. - - -If our predictors represent different scales, then it is important to -standardize the design matrix $\boldsymbol{X}$ by subtracting the mean of each -column from the corresponding column and dividing the column with its -standard deviation. Most machine learning libraries do this as a default. This means that if you compare your code with the results from a given library, -the results may differ. - -The -[Standardscaler](https://scikit-learn.org/stable/modules/generated/sklearn.preprocessing.StandardScaler.html) -function in **Scikit-Learn** does this for us. For the data sets we -have been studying in our various examples, the data are in many cases -already scaled and there is no need to scale them. You as a user of different machine learning algorithms, should always perform a -survey of your data, with a critical assessment of them in case you need to scale the data. - -If you need to scale the data, not doing so will give an *unfair* -penalization of the parameters since their magnitude depends on the -scale of their corresponding predictor. - -Suppose as an example that you -you have an input variable given by the heights of different persons. -Human height might be measured in inches or meters or -kilometers. If measured in kilometers, a standard linear regression -model with this predictor would probably give a much bigger -coefficient term, than if measured in millimeters. -This can clearly lead to problems in evaluating the cost/loss functions. - - - -Keep in mind that when you transform your data set before training a model, the same transformation needs to be done -on your eventual new data set before making a prediction. If we translate this into a Python code, it would could be implemented as follows - -""" -#Model training, we compute the mean value of y and X -y_train_mean = np.mean(y_train) -X_train_mean = np.mean(X_train,axis=0) -X_train = X_train - X_train_mean -y_train = y_train - y_train_mean - -# The we fit our model with the training data -trained_model = some_model.fit(X_train,y_train) - - -#Model prediction, we need also to transform our data set used for the prediction. -X_test = X_test - X_train_mean #Use mean from training data -y_pred = trained_model(X_test) -y_pred = y_pred + y_train_mean -""" - -Let us try to understand what this may imply mathematically when we -subtract the mean values, also known as *zero centering*. For -simplicity, we will focus on ordinary regression, as done in the above example. - -The cost/loss function for regression is - -$$ -C(\beta_0, \beta_1, ... , \beta_{p-1}) = \frac{1}{n}\sum_{i=0}^{n} \left(y_i - \beta_0 - \sum_{j=1}^{p-1} X_{ij}\beta_j\right)^2,. -$$ - -Recall also that we use the squared value. This expression can lead to an -increased penalty for higher differences between predicted and -output/target values. - -What we have done is to single out the $\beta_0$ term in the -definition of the mean squared error (MSE). The design matrix $X$ -does in this case not contain any intercept column. When we take the -derivative with respect to $\beta_0$, we want the derivative to obey - -$$ -\frac{\partial C}{\partial \beta_j} = 0, -$$ - -for all $j$. For $\beta_0$ we have - -$$ -\frac{\partial C}{\partial \beta_0} = -\frac{2}{n}\sum_{i=0}^{n-1} \left(y_i - \beta_0 - \sum_{j=1}^{p-1} X_{ij} \beta_j\right). -$$ - -Multiplying away the constant $2/n$, we obtain - -$$ -\sum_{i=0}^{n-1} \beta_0 = \sum_{i=0}^{n-1}y_i - \sum_{i=0}^{n-1} \sum_{j=1}^{p-1} X_{ij} \beta_j. -$$ - -Let us specialize first to the case where we have only two parameters $\beta_0$ and $\beta_1$. -Our result for $\beta_0$ simplifies then to - -$$ -n\beta_0 = \sum_{i=0}^{n-1}y_i - \sum_{i=0}^{n-1} X_{i1} \beta_1. -$$ - -We obtain then - -$$ -\beta_0 = \frac{1}{n}\sum_{i=0}^{n-1}y_i - \beta_1\frac{1}{n}\sum_{i=0}^{n-1} X_{i1}. -$$ - -If we define - -$$ -\mu_{\boldsymbol{x}_1}=\frac{1}{n}\sum_{i=0}^{n-1} X_{i1}, -$$ - -and the mean value of the outputs as - -$$ -\mu_y=\frac{1}{n}\sum_{i=0}^{n-1}y_i, -$$ - -we have - -$$ -\beta_0 = \mu_y - \beta_1\mu_{\boldsymbol{x}_1}. -$$ - -In the general case with more parameters than $\beta_0$ and $\beta_1$, we have - -$$ -\beta_0 = \frac{1}{n}\sum_{i=0}^{n-1}y_i - \frac{1}{n}\sum_{i=0}^{n-1}\sum_{j=1}^{p-1} X_{ij}\beta_j. -$$ - -We can rewrite the latter equation as - -$$ -\beta_0 = \frac{1}{n}\sum_{i=0}^{n-1}y_i - \sum_{j=1}^{p-1} \mu_{\boldsymbol{x}_j}\beta_j, -$$ - -where we have defined - -$$ -\mu_{\boldsymbol{x}_j}=\frac{1}{n}\sum_{i=0}^{n-1} X_{ij}, -$$ - -the mean value for all elements of the column vector $\boldsymbol{x}_j$. - - - -Replacing $y_i$ with $y_i - y_i - \overline{\boldsymbol{y}}$ and centering also our design matrix results in a cost function (in vector-matrix disguise) - -$$ -C(\boldsymbol{\beta}) = (\boldsymbol{\tilde{y}} - \tilde{X}\boldsymbol{\beta})^T(\boldsymbol{\tilde{y}} - \tilde{X}\boldsymbol{\beta}). -$$ - -If we minimize with respect to $\boldsymbol{\beta}$ we have then - -$$ -\hat{\boldsymbol{\beta}} = (\tilde{X}^T\tilde{X})^{-1}\tilde{X}^T\boldsymbol{\tilde{y}}, -$$ - -where $\boldsymbol{\tilde{y}} = \boldsymbol{y} - \overline{\boldsymbol{y}}$ -and $\tilde{X}_{ij} = X_{ij} - \frac{1}{n}\sum_{k=0}^{n-1}X_{kj}$. - -For Ridge regression we need to add $\lambda \boldsymbol{\beta}^T\boldsymbol{\beta}$ to the cost function and get then - -$$ -\hat{\boldsymbol{\beta}} = (\tilde{X}^T\tilde{X} + \lambda I)^{-1}\tilde{X}^T\boldsymbol{\tilde{y}}. -$$ - -What does this mean? And why do we insist on all this? Let us look at some examples. - - -This code shows a simple first-order fit to a data set using the above transformed data, where we consider the role of the intercept first, by either excluding it or including it (*code example thanks to Øyvind Sigmundson Schøyen*). Here our scaling of the data is done by subtracting the mean values only. -Note also that we do not split the data into training and test. - -import numpy as np -import matplotlib.pyplot as plt - -from sklearn.linear_model import LinearRegression - - -np.random.seed(2021) - -def MSE(y_data,y_model): - n = np.size(y_model) - return np.sum((y_data-y_model)**2)/n - - -def fit_beta(X, y): - return np.linalg.pinv(X.T @ X) @ X.T @ y - - -true_beta = [2, 0.5, 3.7] - -x = np.linspace(0, 1, 11) -y = np.sum( - np.asarray([x ** p * b for p, b in enumerate(true_beta)]), axis=0 -) + 0.1 * np.random.normal(size=len(x)) - -degree = 3 -X = np.zeros((len(x), degree)) - -# Include the intercept in the design matrix -for p in range(degree): - X[:, p] = x ** p - -beta = fit_beta(X, y) - -# Intercept is included in the design matrix -skl = LinearRegression(fit_intercept=False).fit(X, y) - -print(f"True beta: {true_beta}") -print(f"Fitted beta: {beta}") -print(f"Sklearn fitted beta: {skl.coef_}") -ypredictOwn = X @ beta -ypredictSKL = skl.predict(X) -print(f"MSE with intercept column") -print(MSE(y,ypredictOwn)) -print(f"MSE with intercept column from SKL") -print(MSE(y,ypredictSKL)) - - -plt.figure() -plt.scatter(x, y, label="Data") -plt.plot(x, X @ beta, label="Fit") -plt.plot(x, skl.predict(X), label="Sklearn (fit_intercept=False)") - - -# Do not include the intercept in the design matrix -X = np.zeros((len(x), degree - 1)) - -for p in range(degree - 1): - X[:, p] = x ** (p + 1) - -# Intercept is not included in the design matrix -skl = LinearRegression(fit_intercept=True).fit(X, y) - -# Use centered values for X and y when computing coefficients -y_offset = np.average(y, axis=0) -X_offset = np.average(X, axis=0) - -beta = fit_beta(X - X_offset, y - y_offset) -intercept = np.mean(y_offset - X_offset @ beta) - -print(f"Manual intercept: {intercept}") -print(f"Fitted beta (wiothout intercept): {beta}") -print(f"Sklearn intercept: {skl.intercept_}") -print(f"Sklearn fitted beta (without intercept): {skl.coef_}") -ypredictOwn = X @ beta -ypredictSKL = skl.predict(X) -print(f"MSE with Manual intercept") -print(MSE(y,ypredictOwn+intercept)) -print(f"MSE with Sklearn intercept") -print(MSE(y,ypredictSKL)) - -plt.plot(x, X @ beta + intercept, "--", label="Fit (manual intercept)") -plt.plot(x, skl.predict(X), "--", label="Sklearn (fit_intercept=True)") -plt.grid() -plt.legend() - -plt.show() - -The intercept is the value of our output/target variable -when all our features are zero and our function crosses the $y$-axis (for a one-dimensional case). - -Printing the MSE, we see first that both methods give the same MSE, as -they should. However, when we move to for example Ridge regression, -the way we treat the intercept may give a larger or smaller MSE, -meaning that the MSE can be penalized by the value of the -intercept. Not including the intercept in the fit, means that the -regularization term does not include $\beta_0$. For different values -of $\lambda$, this may lead to differeing MSE values. - -To remind the reader, the regularization term, with the intercept in Ridge regression, is given by - -$$ -\lambda \vert\vert \boldsymbol{\beta} \vert\vert_2^2 = \lambda \sum_{j=0}^{p-1}\beta_j^2, -$$ - -but when we take out the intercept, this equation becomes - -$$ -\lambda \vert\vert \boldsymbol{\beta} \vert\vert_2^2 = \lambda \sum_{j=1}^{p-1}\beta_j^2. -$$ - -For Lasso regression we have - -$$ -\lambda \vert\vert \boldsymbol{\beta} \vert\vert_1 = \lambda \sum_{j=1}^{p-1}\vert\beta_j\vert. -$$ - -It means that, when scaling the design matrix and the outputs/targets, -by subtracting the mean values, we have an optimization problem which -is not penalized by the intercept. The MSE value can then be smaller -since it focuses only on the remaining quantities. If we however bring -back the intercept, we will get a MSE which then contains the -intercept. - - -Armed with this wisdom, we attempt first to simply set the intercept equal to **False** in our implementation of Ridge regression for our well-known vanilla data set. - -import numpy as np -import pandas as pd -import matplotlib.pyplot as plt -from sklearn.model_selection import train_test_split -from sklearn import linear_model - -def MSE(y_data,y_model): - n = np.size(y_model) - return np.sum((y_data-y_model)**2)/n - - -# A seed just to ensure that the random numbers are the same for every run. -# Useful for eventual debugging. -np.random.seed(3155) - -n = 100 -x = np.random.rand(n) -y = np.exp(-x**2) + 1.5 * np.exp(-(x-2)**2) - -Maxpolydegree = 20 -X = np.zeros((n,Maxpolydegree)) -#We include explicitely the intercept column -for degree in range(Maxpolydegree): - X[:,degree] = x**degree -# We split the data in test and training data -X_train, X_test, y_train, y_test = train_test_split(X, y, test_size=0.2) - -p = Maxpolydegree -I = np.eye(p,p) -# Decide which values of lambda to use -nlambdas = 6 -MSEOwnRidgePredict = np.zeros(nlambdas) -MSERidgePredict = np.zeros(nlambdas) -lambdas = np.logspace(-4, 2, nlambdas) -for i in range(nlambdas): - lmb = lambdas[i] - OwnRidgeBeta = np.linalg.pinv(X_train.T @ X_train+lmb*I) @ X_train.T @ y_train - # Note: we include the intercept column and no scaling - RegRidge = linear_model.Ridge(lmb,fit_intercept=False) - RegRidge.fit(X_train,y_train) - # and then make the prediction - ytildeOwnRidge = X_train @ OwnRidgeBeta - ypredictOwnRidge = X_test @ OwnRidgeBeta - ytildeRidge = RegRidge.predict(X_train) - ypredictRidge = RegRidge.predict(X_test) - MSEOwnRidgePredict[i] = MSE(y_test,ypredictOwnRidge) - MSERidgePredict[i] = MSE(y_test,ypredictRidge) - print("Beta values for own Ridge implementation") - print(OwnRidgeBeta) - print("Beta values for Scikit-Learn Ridge implementation") - print(RegRidge.coef_) - print("MSE values for own Ridge implementation") - print(MSEOwnRidgePredict[i]) - print("MSE values for Scikit-Learn Ridge implementation") - print(MSERidgePredict[i]) - -# Now plot the results -plt.figure() -plt.plot(np.log10(lambdas), MSEOwnRidgePredict, 'r', label = 'MSE own Ridge Test') -plt.plot(np.log10(lambdas), MSERidgePredict, 'g', label = 'MSE Ridge Test') - -plt.xlabel('log10(lambda)') -plt.ylabel('MSE') -plt.legend() -plt.show() - -The results here agree when we force **Scikit-Learn**'s Ridge function to include the first column in our design matrix. -We see that the results agree very well. Here we have thus explicitely included the intercept column in the design matrix. -What happens if we do not include the intercept in our fit? -Let us see how we can change this code by zero centering. - -import numpy as np -import pandas as pd -import matplotlib.pyplot as plt -from sklearn.model_selection import train_test_split -from sklearn import linear_model -from sklearn.preprocessing import StandardScaler - -def MSE(y_data,y_model): - n = np.size(y_model) - return np.sum((y_data-y_model)**2)/n -# A seed just to ensure that the random numbers are the same for every run. -# Useful for eventual debugging. -np.random.seed(315) - -n = 100 -x = np.random.rand(n) -y = np.exp(-x**2) + 1.5 * np.exp(-(x-2)**2) - -Maxpolydegree = 20 -X = np.zeros((n,Maxpolydegree-1)) - -for degree in range(1,Maxpolydegree): #No intercept column - X[:,degree-1] = x**(degree) - -# We split the data in test and training data -X_train, X_test, y_train, y_test = train_test_split(X, y, test_size=0.2) - -#For our own implementation, we will need to deal with the intercept by centering the design matrix and the target variable -X_train_mean = np.mean(X_train,axis=0) -#Center by removing mean from each feature -X_train_scaled = X_train - X_train_mean -X_test_scaled = X_test - X_train_mean -#The model intercept (called y_scaler) is given by the mean of the target variable (IF X is centered) -#Remove the intercept from the training data. -y_scaler = np.mean(y_train) -y_train_scaled = y_train - y_scaler - -p = Maxpolydegree-1 -I = np.eye(p,p) -# Decide which values of lambda to use -nlambdas = 6 -MSEOwnRidgePredict = np.zeros(nlambdas) -MSERidgePredict = np.zeros(nlambdas) - -lambdas = np.logspace(-4, 2, nlambdas) -for i in range(nlambdas): - lmb = lambdas[i] - OwnRidgeBeta = np.linalg.pinv(X_train_scaled.T @ X_train_scaled+lmb*I) @ X_train_scaled.T @ (y_train_scaled) - intercept_ = y_scaler - X_train_mean@OwnRidgeBeta #The intercept can be shifted so the model can predict on uncentered data - #Add intercept to prediction - ypredictOwnRidge = X_test_scaled @ OwnRidgeBeta + y_scaler - RegRidge = linear_model.Ridge(lmb) - RegRidge.fit(X_train,y_train) - ypredictRidge = RegRidge.predict(X_test) - MSEOwnRidgePredict[i] = MSE(y_test,ypredictOwnRidge) - MSERidgePredict[i] = MSE(y_test,ypredictRidge) - print("Beta values for own Ridge implementation") - print(OwnRidgeBeta) #Intercept is given by mean of target variable - print("Beta values for Scikit-Learn Ridge implementation") - print(RegRidge.coef_) - print('Intercept from own implementation:') - print(intercept_) - print('Intercept from Scikit-Learn Ridge implementation') - print(RegRidge.intercept_) - print("MSE values for own Ridge implementation") - print(MSEOwnRidgePredict[i]) - print("MSE values for Scikit-Learn Ridge implementation") - print(MSERidgePredict[i]) - - -# Now plot the results -plt.figure() -plt.plot(np.log10(lambdas), MSEOwnRidgePredict, 'b--', label = 'MSE own Ridge Test') -plt.plot(np.log10(lambdas), MSERidgePredict, 'g--', label = 'MSE SL Ridge Test') -plt.xlabel('log10(lambda)') -plt.ylabel('MSE') -plt.legend() -plt.show() - -We see here, when compared to the code which includes explicitely the -intercept column, that our MSE value is actually smaller. This is -because the regularization term does not include the intercept value -$\beta_0$ in the fitting. This applies to Lasso regularization as -well. It means that our optimization is now done only with the -centered matrix and/or vector that enter the fitting procedure. Note -also that the problem with the intercept occurs mainly in these type -of polynomial fitting problem. - -The next example is indeed an example where all these discussions about the role of intercept are not present. - -## More complicated Example: The Ising model - -The one-dimensional Ising model with nearest neighbor interaction, no -external field and a constant coupling constant $J$ is given by - - -
- -$$ -\begin{equation} - H = -J \sum_{k}^L s_k s_{k + 1}, -\label{_auto1} \tag{1} -\end{equation} -$$ - -where $s_i \in \{-1, 1\}$ and $s_{N + 1} = s_1$. The number of spins -in the system is determined by $L$. For the one-dimensional system -there is no phase transition. - -We will look at a system of $L = 40$ spins with a coupling constant of -$J = 1$. To get enough training data we will generate 10000 states -with their respective energies. - -import numpy as np -import matplotlib.pyplot as plt -from mpl_toolkits.axes_grid1 import make_axes_locatable -import seaborn as sns -import scipy.linalg as scl -from sklearn.model_selection import train_test_split -import tqdm -sns.set(color_codes=True) -cmap_args=dict(vmin=-1., vmax=1., cmap='seismic') - -L = 40 -n = int(1e4) - -spins = np.random.choice([-1, 1], size=(n, L)) -J = 1.0 - -energies = np.zeros(n) - -for i in range(n): - energies[i] = - J * np.dot(spins[i], np.roll(spins[i], 1)) - -Here we use ordinary least squares -regression to predict the energy for the nearest neighbor -one-dimensional Ising model on a ring, i.e., the endpoints wrap -around. We will use linear regression to fit a value for -the coupling constant to achieve this. - -A more general form for the one-dimensional Ising model is - - -
- -$$ -\begin{equation} - H = - \sum_j^L \sum_k^L s_j s_k J_{jk}. -\label{_auto2} \tag{2} -\end{equation} -$$ - -Here we allow for interactions beyond the nearest neighbors and a state dependent -coupling constant. This latter expression can be formulated as -a matrix-product - - -
- -$$ -\begin{equation} - \boldsymbol{H} = \boldsymbol{X} J, -\label{_auto3} \tag{3} -\end{equation} -$$ - -where $X_{jk} = s_j s_k$ and $J$ is a matrix which consists of the -elements $-J_{jk}$. This form of writing the energy fits perfectly -with the form utilized in linear regression, that is - - -
- -$$ -\begin{equation} - \boldsymbol{y} = \boldsymbol{X}\boldsymbol{\beta} + \boldsymbol{\epsilon}, -\label{_auto4} \tag{4} -\end{equation} -$$ - -We split the data in training and test data as discussed in the previous example - -X = np.zeros((n, L ** 2)) -for i in range(n): - X[i] = np.outer(spins[i], spins[i]).ravel() -y = energies -X_train, X_test, y_train, y_test = train_test_split(X, y, test_size=0.2) - -In the ordinary least squares method we choose the cost function - - -
- -$$ -\begin{equation} - C(\boldsymbol{X}, \boldsymbol{\beta})= \frac{1}{n}\left\{(\boldsymbol{X}\boldsymbol{\beta} - \boldsymbol{y})^T(\boldsymbol{X}\boldsymbol{\beta} - \boldsymbol{y})\right\}. -\label{_auto5} \tag{5} -\end{equation} -$$ - -We then find the extremal point of $C$ by taking the derivative with respect to $\boldsymbol{\beta}$ as discussed above. -This yields the expression for $\boldsymbol{\beta}$ to be - -$$ -\boldsymbol{\beta} = \frac{\boldsymbol{X}^T \boldsymbol{y}}{\boldsymbol{X}^T \boldsymbol{X}}, -$$ - -which immediately imposes some requirements on $\boldsymbol{X}$ as there must exist -an inverse of $\boldsymbol{X}^T \boldsymbol{X}$. If the expression we are modeling contains an -intercept, i.e., a constant term, we must make sure that the -first column of $\boldsymbol{X}$ consists of $1$. We do this here - -X_train_own = np.concatenate( - (np.ones(len(X_train))[:, np.newaxis], X_train), - axis=1 -) -X_test_own = np.concatenate( - (np.ones(len(X_test))[:, np.newaxis], X_test), - axis=1 -) - -Doing the inversion directly turns out to be a bad idea since the matrix -$\boldsymbol{X}^T\boldsymbol{X}$ is singular. An alternative approach is to use the **singular -value decomposition**. Using the definition of the Moore-Penrose -pseudoinverse we can write the equation for $\boldsymbol{\beta}$ as - -$$ -\boldsymbol{\beta} = \boldsymbol{X}^{+}\boldsymbol{y}, -$$ - -where the pseudoinverse of $\boldsymbol{X}$ is given by - -$$ -\boldsymbol{X}^{+} = \frac{\boldsymbol{X}^T}{\boldsymbol{X}^T\boldsymbol{X}}. -$$ - -Using singular value decomposition we can decompose the matrix $\boldsymbol{X} = \boldsymbol{U}\boldsymbol{\Sigma} \boldsymbol{V}^T$, -where $\boldsymbol{U}$ and $\boldsymbol{V}$ are orthogonal(unitary) matrices and $\boldsymbol{\Sigma}$ contains the singular values (more details below). -where $X^{+} = V\Sigma^{+} U^T$. This reduces the equation for -$\omega$ to - - -
- -$$ -\begin{equation} - \boldsymbol{\beta} = \boldsymbol{V}\boldsymbol{\Sigma}^{+} \boldsymbol{U}^T \boldsymbol{y}. -\label{_auto6} \tag{6} -\end{equation} -$$ - -Note that solving this equation by actually doing the pseudoinverse -(which is what we will do) is not a good idea as this operation scales -as $\mathcal{O}(n^3)$, where $n$ is the number of elements in a -general matrix. Instead, doing $QR$-factorization and solving the -linear system as an equation would reduce this down to -$\mathcal{O}(n^2)$ operations. - -def ols_svd(x: np.ndarray, y: np.ndarray) -> np.ndarray: - u, s, v = scl.svd(x) - return v.T @ scl.pinv(scl.diagsvd(s, u.shape[0], v.shape[0])) @ u.T @ y - -beta = ols_svd(X_train_own,y_train) - -When extracting the $J$-matrix we need to make sure that we remove the intercept, as is done here - -J = beta[1:].reshape(L, L) - -A way of looking at the coefficients in $J$ is to plot the matrices as images. - -fig = plt.figure(figsize=(20, 14)) -im = plt.imshow(J, **cmap_args) -plt.title("OLS", fontsize=18) -plt.xticks(fontsize=18) -plt.yticks(fontsize=18) -cb = fig.colorbar(im) -cb.ax.set_yticklabels(cb.ax.get_yticklabels(), fontsize=18) -plt.show() - -It is interesting to note that OLS -considers both $J_{j, j + 1} = -0.5$ and $J_{j, j - 1} = -0.5$ as -valid matrix elements for $J$. -In our discussion below on hyperparameters and Ridge and Lasso regression we will see that -this problem can be removed, partly and only with Lasso regression. - -In this case our matrix inversion was actually possible. The obvious question now is what is the mathematics behind the SVD? - - - - - -Let us now -focus on Ridge and Lasso regression as well. We repeat some of the -basic parts of the Ising model and the setup of the training and test -data. The one-dimensional Ising model with nearest neighbor -interaction, no external field and a constant coupling constant $J$ is -given by - - -
- -$$ -\begin{equation} - H = -J \sum_{k}^L s_k s_{k + 1}, -\label{_auto7} \tag{7} -\end{equation} -$$ - -where $s_i \in \{-1, 1\}$ and $s_{N + 1} = s_1$. The number of spins in the system is determined by $L$. For the one-dimensional system there is no phase transition. - -We will look at a system of $L = 40$ spins with a coupling constant of $J = 1$. To get enough training data we will generate 10000 states with their respective energies. - -import numpy as np -import matplotlib.pyplot as plt -from mpl_toolkits.axes_grid1 import make_axes_locatable -import seaborn as sns -import scipy.linalg as scl -from sklearn.model_selection import train_test_split -import sklearn.linear_model as skl -import tqdm -sns.set(color_codes=True) -cmap_args=dict(vmin=-1., vmax=1., cmap='seismic') - -L = 40 -n = int(1e4) - -spins = np.random.choice([-1, 1], size=(n, L)) -J = 1.0 - -energies = np.zeros(n) - -for i in range(n): - energies[i] = - J * np.dot(spins[i], np.roll(spins[i], 1)) - -A more general form for the one-dimensional Ising model is - - -
- -$$ -\begin{equation} - H = - \sum_j^L \sum_k^L s_j s_k J_{jk}. -\label{_auto8} \tag{8} -\end{equation} -$$ - -Here we allow for interactions beyond the nearest neighbors and a more -adaptive coupling matrix. This latter expression can be formulated as -a matrix-product on the form - - -
- -$$ -\begin{equation} - H = X J, -\label{_auto9} \tag{9} -\end{equation} -$$ - -where $X_{jk} = s_j s_k$ and $J$ is the matrix consisting of the -elements $-J_{jk}$. This form of writing the energy fits perfectly -with the form utilized in linear regression, viz. - - -
- -$$ -\begin{equation} - \boldsymbol{y} = \boldsymbol{X}\boldsymbol{\beta} + \boldsymbol{\epsilon}. -\label{_auto10} \tag{10} -\end{equation} -$$ - -We organize the data as we did above - -X = np.zeros((n, L ** 2)) -for i in range(n): - X[i] = np.outer(spins[i], spins[i]).ravel() -y = energies -X_train, X_test, y_train, y_test = train_test_split(X, y, test_size=0.96) - -X_train_own = np.concatenate( - (np.ones(len(X_train))[:, np.newaxis], X_train), - axis=1 -) - -X_test_own = np.concatenate( - (np.ones(len(X_test))[:, np.newaxis], X_test), - axis=1 -) - -We will do all fitting with **Scikit-Learn**, - -clf = skl.LinearRegression().fit(X_train, y_train) - -When extracting the $J$-matrix we make sure to remove the intercept - -J_sk = clf.coef_.reshape(L, L) - -And then we plot the results - -fig = plt.figure(figsize=(20, 14)) -im = plt.imshow(J_sk, **cmap_args) -plt.title("LinearRegression from Scikit-learn", fontsize=18) -plt.xticks(fontsize=18) -plt.yticks(fontsize=18) -cb = fig.colorbar(im) -cb.ax.set_yticklabels(cb.ax.get_yticklabels(), fontsize=18) -plt.show() - -The results agree perfectly with our previous discussion where we used our own code. - - -Having explored the ordinary least squares we move on to ridge -regression. In ridge regression we include a **regularizer**. This -involves a new cost function which leads to a new estimate for the -weights $\boldsymbol{\beta}$. This results in a penalized regression problem. The -cost function is given by - -6 -0 - -< -< -< -! -! -M -A -T -H -_ -B -L -O -C -K - -_lambda = 0.1 -clf_ridge = skl.Ridge(alpha=_lambda).fit(X_train, y_train) -J_ridge_sk = clf_ridge.coef_.reshape(L, L) -fig = plt.figure(figsize=(20, 14)) -im = plt.imshow(J_ridge_sk, **cmap_args) -plt.title("Ridge from Scikit-learn", fontsize=18) -plt.xticks(fontsize=18) -plt.yticks(fontsize=18) -cb = fig.colorbar(im) -cb.ax.set_yticklabels(cb.ax.get_yticklabels(), fontsize=18) - -plt.show() - -In the **Least Absolute Shrinkage and Selection Operator** (LASSO)-method we get a third cost function. - - -
- -$$ -\begin{equation} - C(\boldsymbol{X}, \boldsymbol{\beta}; \lambda) = (\boldsymbol{X}\boldsymbol{\beta} - \boldsymbol{y})^T(\boldsymbol{X}\boldsymbol{\beta} - \boldsymbol{y}) + \lambda \sqrt{\boldsymbol{\beta}^T\boldsymbol{\beta}}. -\label{_auto12} \tag{12} -\end{equation} -$$ - -Finding the extremal point of this cost function is not so straight-forward as in least squares and ridge. We will therefore rely solely on the function ``Lasso`` from **Scikit-Learn**. - -clf_lasso = skl.Lasso(alpha=_lambda).fit(X_train, y_train) -J_lasso_sk = clf_lasso.coef_.reshape(L, L) -fig = plt.figure(figsize=(20, 14)) -im = plt.imshow(J_lasso_sk, **cmap_args) -plt.title("Lasso from Scikit-learn", fontsize=18) -plt.xticks(fontsize=18) -plt.yticks(fontsize=18) -cb = fig.colorbar(im) -cb.ax.set_yticklabels(cb.ax.get_yticklabels(), fontsize=18) - -plt.show() - -It is quite striking how LASSO breaks the symmetry of the coupling -constant as opposed to ridge and OLS. We get a sparse solution with -$J_{j, j + 1} = -1$. - - - - -We see how the different models perform for a different set of values for $\lambda$. - -lambdas = np.logspace(-4, 5, 10) - -train_errors = { - "ols_sk": np.zeros(lambdas.size), - "ridge_sk": np.zeros(lambdas.size), - "lasso_sk": np.zeros(lambdas.size) -} - -test_errors = { - "ols_sk": np.zeros(lambdas.size), - "ridge_sk": np.zeros(lambdas.size), - "lasso_sk": np.zeros(lambdas.size) -} - -plot_counter = 1 - -fig = plt.figure(figsize=(32, 54)) - -for i, _lambda in enumerate(tqdm.tqdm(lambdas)): - for key, method in zip( - ["ols_sk", "ridge_sk", "lasso_sk"], - [skl.LinearRegression(), skl.Ridge(alpha=_lambda), skl.Lasso(alpha=_lambda)] - ): - method = method.fit(X_train, y_train) - - train_errors[key][i] = method.score(X_train, y_train) - test_errors[key][i] = method.score(X_test, y_test) - - omega = method.coef_.reshape(L, L) - - plt.subplot(10, 5, plot_counter) - plt.imshow(omega, **cmap_args) - plt.title(r"%s, $\lambda = %.4f$" % (key, _lambda)) - plot_counter += 1 - -plt.show() - -We see that LASSO reaches a good solution for low -values of $\lambda$, but will "wither" when we increase $\lambda$ too -much. Ridge is more stable over a larger range of values for -$\lambda$, but eventually also fades away. - - -To determine which value of $\lambda$ is best we plot the accuracy of -the models when predicting the training and the testing set. We expect -the accuracy of the training set to be quite good, but if the accuracy -of the testing set is much lower this tells us that we might be -subject to an overfit model. The ideal scenario is an accuracy on the -testing set that is close to the accuracy of the training set. - -fig = plt.figure(figsize=(20, 14)) - -colors = { - "ols_sk": "r", - "ridge_sk": "y", - "lasso_sk": "c" -} - -for key in train_errors: - plt.semilogx( - lambdas, - train_errors[key], - colors[key], - label="Train {0}".format(key), - linewidth=4.0 - ) - -for key in test_errors: - plt.semilogx( - lambdas, - test_errors[key], - colors[key] + "--", - label="Test {0}".format(key), - linewidth=4.0 - ) -plt.legend(loc="best", fontsize=18) -plt.xlabel(r"$\lambda$", fontsize=18) -plt.ylabel(r"$R^2$", fontsize=18) -plt.tick_params(labelsize=18) -plt.show() - -From the above figure we can see that LASSO with $\lambda = 10^{-2}$ -achieves a very good accuracy on the test set. This by far surpasses the -other models for all values of $\lambda$. - - - - - - -## Exercises and Projects - - - -The main aim of this project is to study in more detail various -regression methods, including the Ordinary Least Squares (OLS) method, -The total score is **100** points. Each subtask has its own final score. - - -We will first study how to fit polynomials to a specific -two-dimensional function called [Franke's -function](http://www.dtic.mil/dtic/tr/fulltext/u2/a081688.pdf). This -is a function which has been widely used when testing various -interpolation and fitting algorithms. Furthermore, after having -established the model and the method, we will employ resamling -techniques such as cross-validation and/or bootstrap in order to perform a -proper assessment of our models. We will also study in detail the -so-called Bias-Variance trade off. - - -The Franke function, which is a weighted sum of four exponentials reads as follows - -$$ -\begin{align*} -f(x,y) &= \frac{3}{4}\exp{\left(-\frac{(9x-2)^2}{4} - \frac{(9y-2)^2}{4}\right)}+\frac{3}{4}\exp{\left(-\frac{(9x+1)^2}{49}- \frac{(9y+1)}{10}\right)} \\ -&+\frac{1}{2}\exp{\left(-\frac{(9x-7)^2}{4} - \frac{(9y-3)^2}{4}\right)} -\frac{1}{5}\exp{\left(-(9x-4)^2 - (9y-7)^2\right) }. -\end{align*} -$$ - -The function will be defined for $x,y\in [0,1]$. Our first step will -be to perform an OLS regression analysis of this function, trying out -a polynomial fit with an $x$ and $y$ dependence of the form $[x, y, -x^2, y^2, xy, \dots]$. We will also include bootstrap first as -a resampling technique. After that we will include the cross-validation technique. As in homeworks 1 and 2, we can use a uniform -distribution to set up the arrays of values for $x$ and $y$, or as in -the example below just a set of fixed -values for $x$ and $y$ with a given step -size. We will fit a -function (for example a polynomial) of $x$ and $y$. Thereafter we -will repeat much of the same procedure using the Ridge and Lasso -regression methods, introducing thus a dependence on the bias -(penalty) $\lambda$. - -Finally we are going to use (real) digital terrain data and try to -reproduce these data using the same methods. We will also try to go -beyond the second-order polynomials metioned above and explore -which polynomial fits the data best. - - -The Python code for the Franke function is included here (it performs also a three-dimensional plot of it) - -from mpl_toolkits.mplot3d import Axes3D -import matplotlib.pyplot as plt -from matplotlib import cm -from matplotlib.ticker import LinearLocator, FormatStrFormatter -import numpy as np -from random import random, seed - -fig = plt.figure() -ax = fig.gca(projection='3d') - -# Make data. -x = np.arange(0, 1, 0.05) -y = np.arange(0, 1, 0.05) -x, y = np.meshgrid(x,y) - - -def FrankeFunction(x,y): - term1 = 0.75*np.exp(-(0.25*(9*x-2)**2) - 0.25*((9*y-2)**2)) - term2 = 0.75*np.exp(-((9*x+1)**2)/49.0 - 0.1*(9*y+1)) - term3 = 0.5*np.exp(-(9*x-7)**2/4.0 - 0.25*((9*y-3)**2)) - term4 = -0.2*np.exp(-(9*x-4)**2 - (9*y-7)**2) - return term1 + term2 + term3 + term4 - - -z = FrankeFunction(x, y) - -# Plot the surface. -surf = ax.plot_surface(x, y, z, cmap=cm.coolwarm, - linewidth=0, antialiased=False) - -# Customize the z axis. -ax.set_zlim(-0.10, 1.40) -ax.zaxis.set_major_locator(LinearLocator(10)) -ax.zaxis.set_major_formatter(FormatStrFormatter('%.02f')) - -# Add a color bar which maps values to colors. -fig.colorbar(surf, shrink=0.5, aspect=5) - -plt.show() - -### Exercise: Ordinary Least Square (OLS) on the Franke function - -We will generate our own dataset for a function -$\mathrm{FrankeFunction}(x,y)$ with $x,y \in [0,1]$. The function -$f(x,y)$ is the Franke function. You should explore also the addition -of an added stochastic noise to this function using the normal -distribution $N(0,1)$. - -*Write your own code* (using either a matrix inversion or a singular -value decomposition from e.g., **numpy** ) or use your code from -homeworks 1 and 2 and perform a standard least square regression -analysis using polynomials in $x$ and $y$ up to fifth order. Find the -[confidence intervals](https://en.wikipedia.org/wiki/Confidence_interval) of the parameters (estimators) $\beta$ by computing their -variances, evaluate the Mean Squared error (MSE) - -$$ -MSE(\hat{y},\hat{\tilde{y}}) = \frac{1}{n} -\sum_{i=0}^{n-1}(y_i-\tilde{y}_i)^2, -$$ - -and the $R^2$ score function. If $\tilde{\hat{y}}_i$ is the predicted -value of the $i-th$ sample and $y_i$ is the corresponding true value, -then the score $R^2$ is defined as - -$$ -R^2(\hat{y}, \tilde{\hat{y}}) = 1 - \frac{\sum_{i=0}^{n - 1} (y_i - \tilde{y}_i)^2}{\sum_{i=0}^{n - 1} (y_i - \bar{y})^2}, -$$ - -where we have defined the mean value of $\hat{y}$ as - -$$ -\bar{y} = \frac{1}{n} \sum_{i=0}^{n - 1} y_i. -$$ - -Your code has to include a scaling of the data (for example by -subtracting the mean value), and -a split of the data in training and test data. For this exercise you can -either write your own code or use for example the function for -splitting training data provided by the library **Scikit-Learn** (make -sure you have installed it). This function is called -$train\_test\_split$. **You should present a critical discussion of why and how you have scaled or not scaled the data**. - -It is normal in essentially all Machine Learning studies to split the -data in a training set and a test set (eventually also an additional -validation set). There -is no explicit recipe for how much data should be included as training -data and say test data. An accepted rule of thumb is to use -approximately $2/3$ to $4/5$ of the data as training data. - - -You can easily reuse the solutions to your exercises from week 35 and week 36. - - - -### Exercise: Bias-variance trade-off and resampling techniques - -Our aim here is to study the bias-variance trade-off by implementing the **bootstrap** resampling technique. - -With a code which does OLS and includes resampling techniques, -we will now discuss the bias-variance trade-off in the context of -continuous predictions such as regression. However, many of the -intuitions and ideas discussed here also carry over to classification -tasks and basically all Machine Learning algorithms. - -Before you perform an analysis of the bias-variance trade-off on your test data, make -first a figure similar to Fig. 2.11 of Hastie, Tibshirani, and -Friedman. Figure 2.11 of this reference displays only the test and training MSEs. The test MSE can be used to -indicate possible regions of low/high bias and variance. You will most likely not get an -equally smooth curve! - -With this result we move on to the bias-variance trade-off analysis. - -Consider a -dataset $\mathcal{L}$ consisting of the data -$\mathbf{X}_\mathcal{L}=\{(y_j, \boldsymbol{x}_j), j=0\ldots n-1\}$. - -Let us assume that the true data is generated from a noisy model - -$$ -\boldsymbol{y}=f(\boldsymbol{x}) + \boldsymbol{\epsilon}. -$$ - -Here $\epsilon$ is normally distributed with mean zero and standard -deviation $\sigma^2$. - -In our derivation of the ordinary least squares method we defined then -an approximation to the function $f$ in terms of the parameters -$\boldsymbol{\beta}$ and the design matrix $\boldsymbol{X}$ which embody our model, -that is $\boldsymbol{\tilde{y}}=\boldsymbol{X}\boldsymbol{\beta}$. - -The parameters $\boldsymbol{\beta}$ are in turn found by optimizing the means -squared error via the so-called cost function - -$$ -C(\boldsymbol{X},\boldsymbol{\beta}) =\frac{1}{n}\sum_{i=0}^{n-1}(y_i-\tilde{y}_i)^2=\mathbb{E}\left[(\boldsymbol{y}-\boldsymbol{\tilde{y}})^2\right]. -$$ - -Here the expected value $\mathbb{E}$ is the sample value. - -Show that you can rewrite this as - -$$ -\mathbb{E}\left[(\boldsymbol{y}-\boldsymbol{\tilde{y}})^2\right]=\frac{1}{n}\sum_i(f_i-\mathbb{E}\left[\boldsymbol{\tilde{y}}\right])^2+\frac{1}{n}\sum_i(\tilde{y}_i-\mathbb{E}\left[\boldsymbol{\tilde{y}}\right])^2+\sigma^2. -$$ - -Explain what the terms mean, which one is the bias and which one is -the variance and discuss their interpretations. - -Perform then a bias-variance analysis of the Franke function by -studying the MSE value as function of the complexity of your model. - -Discuss the bias and variance trade-off as function -of your model complexity (the degree of the polynomial) and the number -of data points, and possibly also your training and test data using the **bootstrap** resampling method. - -Note also that when you calculate the bias, in all applications you don't know the function values $f_i$. You would hence replace them with the actual data points $y_i$. - - -### Exercise: Cross-validation as resampling techniques, adding more complexity - -The aim here is to write your own code for another widely popular -resampling technique, the so-called cross-validation method. Again, -before you start with cross-validation approach, you should scale your -data. - -Implement the $k$-fold cross-validation algorithm (write your own -code) and evaluate again the MSE function resulting -from the test folds. You can compare your own code with that from -**Scikit-Learn** if needed. - -Compare the MSE you get from your cross-validation code with the one -you got from your **bootstrap** code. Comment your results. Try $5-10$ -folds. You can also compare your own cross-validation code with the -one provided by **Scikit-Learn**. - - -### Exercise: Ridge Regression on the Franke function with resampling - -Write your own code for the Ridge method, either using matrix -inversion or the singular value decomposition as done in the previous -exercise. Perform the same bootstrap analysis as in the -Exercise 2 (for the same polynomials) and the cross-validation in exercise 3 but now for different values of $\lambda$. Compare and -analyze your results with those obtained in exercises 1-3. Study the -dependence on $\lambda$. - -Study also the bias-variance trade-off as function of various values of -the parameter $\lambda$. For the bias-variance trade-off, use the **bootstrap** resampling method. Comment your results. - -### Exercise: Lasso Regression on the Franke function with resampling - -This exercise is essentially a repeat of the previous two ones, but now -with Lasso regression. Write either your own code (difficult and optional) or, in this case, -you can also use the functionalities of **Scikit-Learn** (recommended). -Give a -critical discussion of the three methods and a judgement of which -model fits the data best. Perform here as well an analysis of the bias-variance trade-off using the **bootstrap** resampling technique and an analysis of the mean squared error using cross-validation. - -### Exercise: Analysis of real data - -With our codes functioning and having been tested properly on a -simpler function we are now ready to look at real data. We will -essentially repeat in this exercise what was done in exercises 1-5. However, we -need first to download the data and prepare properly the inputs to our -codes. We are going to download digital terrain data from the website -, - -Or, if you prefer, we have placed selected datafiles at - -In order to obtain data for a specific region, you need to register as -a user (free) at this website and then decide upon which area you want -to fetch the digital terrain data from. In order to be able to read -the data properly, you need to specify that the format should be **SRTM -Arc-Second Global** and download the data as a **GeoTIF** file. The -files are then stored in *tif* format which can be imported into a -Python program using - -scipy.misc.imread - -Here is a simple part of a Python code which reads and plots the data -from such files - -""" -import numpy as np -from imageio import imread -import matplotlib.pyplot as plt -from mpl_toolkits.mplot3d import Axes3D -from matplotlib import cm - -# Load the terrain -terrain1 = imread('SRTM_data_Norway_1.tif') -# Show the terrain -plt.figure() -plt.title('Terrain over Norway 1') -plt.imshow(terrain1, cmap='gray') -plt.xlabel('X') -plt.ylabel('Y') -plt.show() -""" - -If you should have problems in downloading the digital terrain data, -we provide two examples under the data folder of project 1. One is -from a region close to Stavanger in Norway and the other Møsvatn -Austfjell, again in Norway. -Feel free to produce your own terrain data. - - -Alternatively, if you would like to use another data set, feel free to do so. This could be data close to your reseach area or simply a data set you found interesting. See for example [kaggle.com](https://www.kaggle.com/datasets) for examples. - - -Our final part deals with the parameterization of your digital terrain -data (or your own data). We will apply all three methods for linear regression, the same type (or higher order) of polynomial -approximation and cross-validation as resampling technique to evaluate which -model fits the data best. - -At the end, you should present a critical evaluation of your results -and discuss the applicability of these regression methods to the type -of data presented here (either the terrain data we propose or other data sets). \ No newline at end of file diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_103_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_103_1.png deleted file mode 100644 index 0d08a7f4f..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_103_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_107_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_107_1.png deleted file mode 100644 index 0d08a7f4f..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_107_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_109_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_109_1.png deleted file mode 100644 index 0d08a7f4f..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_109_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_110_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_110_1.png deleted file mode 100644 index 0d08a7f4f..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_110_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_111_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_111_1.png deleted file mode 100644 index 78fb94a30..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_111_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_113_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_113_1.png deleted file mode 100644 index 92f4ae772..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_113_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_115_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_115_1.png deleted file mode 100644 index 78fb94a30..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_115_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_117_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_117_1.png deleted file mode 100644 index 92f4ae772..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_117_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_118_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_118_1.png deleted file mode 100644 index 78fb94a30..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_118_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_119_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_119_1.png deleted file mode 100644 index 92f4ae772..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_119_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_120_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_120_1.png deleted file mode 100644 index 92f4ae772..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_120_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_144_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_144_1.png deleted file mode 100644 index a518cb04b..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_144_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_148_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_148_1.png deleted file mode 100644 index a518cb04b..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_148_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_150_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_150_1.png deleted file mode 100644 index a518cb04b..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_150_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_151_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_151_1.png deleted file mode 100644 index a518cb04b..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_151_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_162_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_162_1.png deleted file mode 100644 index 8098b2e40..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_162_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_165_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_165_1.png deleted file mode 100644 index 32745c831..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_165_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_166_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_166_1.png deleted file mode 100644 index 8098b2e40..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_166_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_168_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_168_1.png deleted file mode 100644 index 8098b2e40..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_168_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_169_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_169_1.png deleted file mode 100644 index 32745c831..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_169_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_171_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_171_1.png deleted file mode 100644 index 32745c831..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_171_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_171_13.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_171_13.png deleted file mode 100644 index 118120ef6..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_171_13.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_172_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_172_1.png deleted file mode 100644 index 32745c831..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_172_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_173_0.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_173_0.png deleted file mode 100644 index e6bb9a232..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_173_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_173_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_173_1.png deleted file mode 100644 index f629a218c..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_173_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_175_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_175_1.png deleted file mode 100644 index f629a218c..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_175_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_175_13.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_175_13.png deleted file mode 100644 index 118120ef6..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_175_13.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_176_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_176_1.png deleted file mode 100644 index f629a218c..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_176_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_177_0.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_177_0.png deleted file mode 100644 index e6bb9a232..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_177_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_177_13.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_177_13.png deleted file mode 100644 index 118120ef6..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_177_13.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_178_13.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_178_13.png deleted file mode 100644 index 118120ef6..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_178_13.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_179_0.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_179_0.png deleted file mode 100644 index e6bb9a232..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_179_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_180_0.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_180_0.png deleted file mode 100644 index e6bb9a232..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_180_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_181_0.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_181_0.png deleted file mode 100644 index ef5da849b..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_181_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_183_0.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_183_0.png deleted file mode 100644 index ef5da849b..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_183_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_184_0.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_184_0.png deleted file mode 100644 index ef5da849b..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_184_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_25_2.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_25_2.png deleted file mode 100644 index dada82b44..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_25_2.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_37_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_37_1.png deleted file mode 100644 index 2d1866571..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_37_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_38_4.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_38_4.png deleted file mode 100644 index 2116c169f..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_38_4.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_38_6.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_38_6.png deleted file mode 100644 index 2116c169f..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_38_6.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_40_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_40_1.png deleted file mode 100644 index f66188c6f..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_40_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_41_10.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_41_10.png deleted file mode 100644 index df911b5f7..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_41_10.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_41_11.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_41_11.png deleted file mode 100644 index df911b5f7..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_41_11.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_47_0.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_47_0.png deleted file mode 100644 index 8130fefb0..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_47_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_49_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_49_1.png deleted file mode 100644 index 6dff76ded..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_49_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_50_0.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_50_0.png deleted file mode 100644 index 021694b4c..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_50_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_54_0.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_54_0.png deleted file mode 100644 index cf4b6a42e..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_54_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_57_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_57_1.png deleted file mode 100644 index 2d1866571..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_57_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_58_5.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_58_5.png deleted file mode 100644 index 2116c169f..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_58_5.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_60_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_60_1.png deleted file mode 100644 index f66188c6f..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_60_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_61_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_61_1.png deleted file mode 100644 index 2d1866571..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_61_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_61_11.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_61_11.png deleted file mode 100644 index df911b5f7..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_61_11.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_62_4.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_62_4.png deleted file mode 100644 index 2116c169f..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_62_4.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_62_5.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_62_5.png deleted file mode 100644 index 2116c169f..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_62_5.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_62_6.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_62_6.png deleted file mode 100644 index 2116c169f..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_62_6.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_64_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_64_1.png deleted file mode 100644 index f66188c6f..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_64_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_65_10.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_65_10.png deleted file mode 100644 index d1b31b1aa..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_65_10.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_65_11.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_65_11.png deleted file mode 100644 index df911b5f7..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_65_11.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_65_9.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_65_9.png deleted file mode 100644 index d1b31b1aa..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_65_9.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_67_0.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_67_0.png deleted file mode 100644 index 392e93eb1..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_67_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_69_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_69_1.png deleted file mode 100644 index 6dff76ded..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_69_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_70_0.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_70_0.png deleted file mode 100644 index 021694b4c..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_70_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_71_0.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_71_0.png deleted file mode 100644 index 392e93eb1..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_71_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_73_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_73_1.png deleted file mode 100644 index 30a446da4..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_73_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_74_0.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_74_0.png deleted file mode 100644 index 021694b4c..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_74_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter3_78_0.png b/doc/LectureNotes/_build/jupyter_execute/chapter3_78_0.png deleted file mode 100644 index cf4b6a42e..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter3_78_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter4.ipynb b/doc/LectureNotes/_build/jupyter_execute/chapter4.ipynb deleted file mode 100644 index 1fcf20596..000000000 --- a/doc/LectureNotes/_build/jupyter_execute/chapter4.ipynb +++ /dev/null @@ -1,1252 +0,0 @@ -{ - "cells": [ - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "# Logistic Regression\n", - "\n", - "\n", - "\n", - "## Logistic Regression\n", - "\n", - "In linear regression our main interest was centered on learning the\n", - "coefficients of a functional fit (say a polynomial) in order to be\n", - "able to predict the response of a continuous variable on some unseen\n", - "data. The fit to the continuous variable $y_i$ is based on some\n", - "independent variables $x_i$. Linear regression resulted in\n", - "analytical expressions for standard ordinary Least Squares or Ridge\n", - "regression (in terms of matrices to invert) for several quantities,\n", - "ranging from the variance and thereby the confidence intervals of the\n", - "optimal parameters $\\hat{\\beta}$ to the mean squared error. If we can invert\n", - "the product of the design matrices, linear regression gives then a\n", - "simple recipe for fitting our data.\n", - "\n", - "\n", - "Classification problems, however, are concerned with outcomes taking\n", - "the form of discrete variables (i.e. categories). We may for example,\n", - "on the basis of DNA sequencing for a number of patients, like to find\n", - "out which mutations are important for a certain disease; or based on\n", - "scans of various patients' brains, figure out if there is a tumor or\n", - "not; or given a specific physical system, we'd like to identify its\n", - "state, say whether it is an ordered or disordered system (typical\n", - "situation in solid state physics); or classify the status of a\n", - "patient, whether she/he has a stroke or not and many other similar\n", - "situations.\n", - "\n", - "The most common situation we encounter when we apply logistic\n", - "regression is that of two possible outcomes, normally denoted as a\n", - "binary outcome, true or false, positive or negative, success or\n", - "failure etc.\n", - "\n", - "\n", - "Logistic regression will also serve as our stepping stone towards\n", - "neural network algorithms and supervised deep learning. For logistic\n", - "learning, the minimization of the cost function leads to a non-linear\n", - "equation in the parameters $\\hat{\\beta}$. The optimization of the\n", - "problem calls therefore for minimization algorithms. This forms the\n", - "bottle neck of all machine learning algorithms, namely how to find\n", - "reliable minima of a multi-variable function. This leads us to the\n", - "family of gradient descent methods. The latter are the working horses\n", - "of basically all modern machine learning algorithms.\n", - "\n", - "We note also that many of the topics discussed here on logistic \n", - "regression are also commonly used in modern supervised Deep Learning\n", - "models, as we will see later.\n", - "\n", - "\n", - "\n", - "## Basics\n", - "\n", - "We consider the case where the dependent variables, also called the\n", - "responses or the outcomes, $y_i$ are discrete and only take values\n", - "from $k=0,\\dots,K-1$ (i.e. $K$ classes).\n", - "\n", - "The goal is to predict the\n", - "output classes from the design matrix $\\boldsymbol{X}\\in\\mathbb{R}^{n\\times p}$\n", - "made of $n$ samples, each of which carries $p$ features or predictors. The\n", - "primary goal is to identify the classes to which new unseen samples\n", - "belong.\n", - "\n", - "Let us specialize to the case of two classes only, with outputs\n", - "$y_i=0$ and $y_i=1$. Our outcomes could represent the status of a\n", - "credit card user that could default or not on her/his credit card\n", - "debt. That is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "y_i = \\begin{bmatrix} 0 & \\mathrm{no}\\\\ 1 & \\mathrm{yes} \\end{bmatrix}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Before moving to the logistic model, let us try to use our linear\n", - "regression model to classify these two outcomes. We could for example\n", - "fit a linear model to the default case if $y_i > 0.5$ and the no\n", - "default case $y_i \\leq 0.5$.\n", - "\n", - "We would then have our \n", - "weighted linear combination, namely" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - "\\boldsymbol{y} = \\boldsymbol{X}^T\\boldsymbol{\\beta} + \\boldsymbol{\\epsilon},\n", - "\\label{_auto1} \\tag{1}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $\\boldsymbol{y}$ is a vector representing the possible outcomes, $\\boldsymbol{X}$ is our\n", - "$n\\times p$ design matrix and $\\boldsymbol{\\beta}$ represents our estimators/predictors.\n", - "\n", - "\n", - "The main problem with our function is that it takes values on the\n", - "entire real axis. In the case of logistic regression, however, the\n", - "labels $y_i$ are discrete variables. A typical example is the credit\n", - "card data discussed below here, where we can set the state of\n", - "defaulting the debt to $y_i=1$ and not to $y_i=0$ for one the persons\n", - "in the data set (see the full example below).\n", - "\n", - "One simple way to get a discrete output is to have sign\n", - "functions that map the output of a linear regressor to values $\\{0,1\\}$,\n", - "$f(s_i)=sign(s_i)=1$ if $s_i\\ge 0$ and 0 if otherwise. \n", - "We will encounter this model in our first demonstration of neural networks. Historically it is called the ``perceptron\" model in the machine learning\n", - "literature. This model is extremely simple. However, in many cases it is more\n", - "favorable to use a ``soft\" classifier that outputs\n", - "the probability of a given category. This leads us to the logistic function.\n", - "\n", - "\n", - "The following example on data for coronary heart disease (CHD) as function of age may serve as an illustration. In the code here we read and plot whether a person has had CHD (output = 1) or not (output = 0). This ouput is plotted the person's against age. Clearly, the figure shows that attempting to make a standard linear regression fit may not be very meaningful." - ] - }, - { - "cell_type": "code", - "execution_count": 1, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "data": { - "text/html": [ - "
\n", - "\n", - "\n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - "
IDAgeAgegroupCHD
012110
122310
232511
342910
452110
...............
95966181
96976981
97986581
98996481
991006380
\n", - "

100 rows × 4 columns

\n", - "
" - ], - "text/plain": [ - " ID Age Agegroup CHD\n", - "0 1 21 1 0\n", - "1 2 23 1 0\n", - "2 3 25 1 1\n", - "3 4 29 1 0\n", - "4 5 21 1 0\n", - ".. ... ... ... ...\n", - "95 96 61 8 1\n", - "96 97 69 8 1\n", - "97 98 65 8 1\n", - "98 99 64 8 1\n", - "99 100 63 8 0\n", - "\n", - "[100 rows x 4 columns]" - ] - }, - "metadata": {}, - "output_type": "display_data" - }, - { - "data": { - "image/png": "iVBORw0KGgoAAAANSUhEUgAAAfgAAAFnCAYAAABKGFvpAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjMuMywgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/Il7ecAAAACXBIWXMAAAsTAAALEwEAmpwYAAA0yElEQVR4nO3deWAU9f3/8dfm2BCygYTNcsQTubTliMiXrxEroHwVLa3iWRB/X0FBUdCKEFBOEVRAsKJSQHphsdVvkcsoINaoFRAFwqEcEuQMYA5ybK5NNvP7g7IlkGSXZCcJw/PxF7sz+5n3vGd2XzufTILNMAxDAADAUkLquwAAABB8BDwAABZEwAMAYEEEPAAAFkTAAwBgQQQ8AAAWRMCjWitXrlS3bt3k8XhM31ZKSor69u2rhx56yPfcpEmTtHz58qBt49tvv9WQIUMkSZ9++uk52wvm+A3Viy++qG7duumDDz6och2v16sFCxboN7/5jR566CHdf//9Gj9+vLZv316HldaN7du3684779TNN99c36VU6sSJE7r//vvVoUMH33OrVq3S+PHj67EqXBAMoBpPPfWU0aVLF+PTTz+tk+0tXbrUGDRokO+x2+02SktL/b5u0KBBxtKlS/2uV15ebuTl5VW5vfPVvn174/Dhw1WO31D569fo0aONZ5991igpKTEMwzBKSkqMcePGGb/+9a/rqsQ6tXHjRqN37951tr1Az9fTDh8+bLRv3973uKyszHC73WaUBgvhCh5Vys/PV2hoqHr37q2PP/64XmqIiopSWFhY0Maz2WyKjo4O2nh1PX5d+Prrr7V27VpNnjxZdrtdkmS32zV+/HjfY9Sv0NBQRUVF1XcZaOCC98kJy/n000916623KiwsTElJSfJ4PL4P+Pnz52vVqlVq0aKFrr/+es2ePVvdu3fXH/7wB9lsNs2ZM0dbt26VzWZTjx499OSTT8pms52zjcLCQk2cOFFpaWlq2bJlhWnI5cuXa+7cuerevbteeeUVFRUVady4ccrKypLX61WnTp30/PPPa/bs2dq1a5cyMjK0bNkyPfLII0pJSdGHH36oQYMGad++fdq5c6d69+6t7777Ttu2bdOePXt82zEMQ9OmTdN3332nkpISvfjii/r5z3+umTNn6v3339fzzz+vu+++W5MmTdKyZcu0aNEi/fd//7ceffRRSdKo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8fHxuvbaa6sctyavOe2KK67Q7t275fF4VFZWpg0bNgS073369FF6err+8Y9/6MYbbwzoNWfr0qWLWrVqpbVr10o6FeJPPvmkDhw4UOPj4u98Pfs99uGHH1Y51vbt2zV37lxJp77MtW7dWl6v13f+nfnjsd///ve+vytx+eWXa9u2bZKk3bt3V5i1euqpp1RUVKSwsDB17drV917u37+/Pv/8c+Xm5kqS9u/fr+HDhwe0z6h7NoMfnuAM+fn5GjRokNxutyZOnOi7uzclJUXTpk3TiRMndM8996hly5ZauXKlWrVqpZ49e2r69Om+kCwtLdXrr7+uTZs2KSIiQi1bttTUqVMVGRl5zvZO30W/b98+uVwutWnTRkuXLlW/fv2UkJCguXPnqqSkRIMGDVJiYqJee+01GYYht9utHj166Nlnn5UkffLJJ3r11VcVHR2t0aNH64svvtD777+vuLg4PfDAAxo8eLCys7P1+OOPa9u2berevbv+93//V6+++qpiY2PVpk0b7du3Tx6PR1OnTlXHjh0lnQr/3/72t2ratKl69+6tJUuWKDo6WtOnT1fHjh316quv6vPPP5fD4dCcOXP09NNP+8b/85//rOLiYr300kvav3+/vF6v+vTpo6FDh8pms2nIkCH66quv1KVLF/3hD3/QI488om3btqlHjx764x//eE6v/va3v+ntt99Wu3btdMUVV+gvf/mLevTooeeff17PPvus9u/fr/79++vee+9VUlKSMjMzdf/99yspKUnbt2/XlClTZLfb1a5dO+3bt08nT57UmDFjzplSlk7Nurz99ttat26dGjVqpNLS0gp3YEunZnnefPPNc+6IX7VqlV577TWVlJSoR48emjlz5nm95sknn1RoaKjmzp2riIgIPfPMM7rllls0ZswY7d+/X+3atZPX61VqaqrvNxkWLVqkiIgI9e3bV0lJSRX2Zfz48YqMjNSECRMqPef37dvnt3+HDh3SCy+8oJKSEpWXl+vuu+/WvffeG/BxSUhI0BtvvOGbgTj7fK1sFmr+/PlauXKl7zdV5syZo+7du2v8+PEaO3as9u/fr969e2vixImaNm2asrKyfFPmL730kpo0aaKCggK99NJLSktLU1hYmK655hqNGzdOoaGh2rx5syZMmKC4uDh16NBBq1evltPp1OzZs/XZZ5/p008/VXh4uIqL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pNDQUHXr1k1ff/0152otRUVF6aqrrlJ0dLQk6brrrtPevXtVXFws499/AZ1ztXZWr17tC/ianK8XxdmckpKib7/9VuPHj9dPP/2k9PR09ezZU1u3blWrVq20ZcsW9ezZs77LvKDs27dPR44cUa9evSRJl156qY4cOUJfa2H48OG+f5eUlKiwsFAPP/ywPB6Ptm7dqm7dumnPnj26+uqruXo/D2lpadqyZYvuu+8+SdLBgwfVp08fztVa6tKli3JycuT1ehUaGqr09HS1a9dOOTk52rFjhzp37kxfa+Hrr79WQkKCwsPDJalG56vl/7OZnTt36qGHHlLHjh0lSYWFhXrwwQd1880369VXX1V8fLwOHz6sZ599ljtoz8OhQ4c0c+ZM/exnP1NZWZnS0tI0YcIEhYeH09daWrNmjZYsWaLS0lI9+OCD6tOnj2bMmCGXy6VDhw7pscce4y7683DixAm9+OKLuuaaa+R2u1VWVqbnnntOeXl5nKu19Mknn2jjxo2KjY3VsWPHNHHiRGVmZuqtt97SZZddpmPHjmncuHHcRV8Do0aN0oQJE9SsWTNJUk5Oznmfr5YPeAAALkYXzc/gAQC4mBDwAABYEAEPAIAFEfAAAFgQAQ8AgAUR8AAqGD58uCZNmlTfZQCoJQIegE9GRobS09OVnJysoqKi+i4HQC3we/AAfBYuXKiuXbtqzJgxevrpp3XXXXdJkt555x2tXbtW7dq1U0lJib744gs98cQTGjBggD766COtX79eMTExOnHihJKSkuRyuep3RwBwBQ/gP07/Sdy77rpLS5culSTt3r1b8+fP19tvv61JkyYpLi5OV155pQYMGKC0tDS99dZbmjp1qkaPHq3u3btr1qxZ9bwXAKSL5G/RA/Dv22+/VUJCgiSpf//+mj9/vg4ePKhNmzapY8eOatSokSSpW7du2rJliyRpw4YNKikp0ZQpUyRJBQUFKi0trY/yAZyFgAcg6dT/RV9eXq7p06dLklwul5YuXer3711feeWVmjp1qu/xmf/zHYD6Q8ADkNvtVnFxsV599VXfc126dNGMGTP09ttva8GCBSouLlajRo20efNm3zqJiYl688035Xa75XA49P333+vdd9/VtGnT6mM3AJyBgAcucsXFxRo9erQKCgp04sQJtWjRQpL0ww8/6KefftLChQs1bNgwPfroo7ryyisVFRXl+y8s27Rpo4kTJyopKUmXX3658vLyNGbMmPrcHQD/xl30APxav369brjhBknSkiVLdPToUSUlJdVzVQCqQ8AD8Oupp55S8+bNZbPZlJubqwkTJqhJkyb1XRaAahDwAABYEL8HDwCABRHwAABYEAEPAIAFEfAAAFgQAQ8AgAUR8AAAWND/B+FnOmO6n4HAAAAAAElFTkSuQmCC\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter4_5_1.png" - } - }, - "output_type": "display_data" - } - ], - "source": [ - "%matplotlib inline\n", - "\n", - "# Common imports\n", - "import os\n", - "import numpy as np\n", - "import pandas as pd\n", - "import matplotlib.pyplot as plt\n", - "from sklearn.linear_model import LinearRegression, Ridge, Lasso\n", - "from sklearn.model_selection import train_test_split\n", - "from sklearn.utils import resample\n", - "from sklearn.metrics import mean_squared_error\n", - "from IPython.display import display\n", - "from pylab import plt, mpl\n", - "plt.style.use('seaborn')\n", - "mpl.rcParams['font.family'] = 'serif'\n", - "\n", - "# Where to save the figures and data files\n", - "PROJECT_ROOT_DIR = \"Results\"\n", - "FIGURE_ID = \"Results/FigureFiles\"\n", - "DATA_ID = \"DataFiles/\"\n", - "\n", - "if not os.path.exists(PROJECT_ROOT_DIR):\n", - " os.mkdir(PROJECT_ROOT_DIR)\n", - "\n", - "if not os.path.exists(FIGURE_ID):\n", - " os.makedirs(FIGURE_ID)\n", - "\n", - "if not os.path.exists(DATA_ID):\n", - " os.makedirs(DATA_ID)\n", - "\n", - "def image_path(fig_id):\n", - " return os.path.join(FIGURE_ID, fig_id)\n", - "\n", - "def data_path(dat_id):\n", - " return os.path.join(DATA_ID, dat_id)\n", - "\n", - "def save_fig(fig_id):\n", - " plt.savefig(image_path(fig_id) + \".png\", format='png')\n", - "\n", - "infile = open(data_path(\"chddata.csv\"),'r')\n", - "\n", - "# Read the chd data as csv file and organize the data into arrays with age group, age, and chd\n", - "chd = pd.read_csv(infile, names=('ID', 'Age', 'Agegroup', 'CHD'))\n", - "chd.columns = ['ID', 'Age', 'Agegroup', 'CHD']\n", - "output = chd['CHD']\n", - "age = chd['Age']\n", - "agegroup = chd['Agegroup']\n", - "numberID = chd['ID'] \n", - "display(chd)\n", - "\n", - "plt.scatter(age, output, marker='o')\n", - "plt.axis([18,70.0,-0.1, 1.2])\n", - "plt.xlabel(r'Age')\n", - "plt.ylabel(r'CHD')\n", - "plt.title(r'Age distribution and Coronary heart disease')\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "What we could attempt however is to plot the mean value for each group." - ] - }, - { - "cell_type": "code", - "execution_count": 2, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "data": { - "image/png": "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fdyuXbug1WoxcuRIJCcno3v37ti5c6d0owkiIiIqOLMdQ2/VqtUTd/B6VGRkpLRFrtFooFarpct2iIiIqHBkOykuKSkp192gnJ2dn7gJRF54Uj4REdGTZDsprkyZMrmebKTVavO8Q9PjVCoVEhLSzBmtWHh6ulj8OJQwBoDjKEmUMAZAGeNQwhgAZY3DlGLdQr9//760Fe7n54fo6GgAOdeK6nQ61KxZszjjEBERKYbZCv3YsWPYunUrEhISsHjxYmRmZmLz5s2YP38+AKB169ZwcnLCokWLMHv2bMyaNYsnxBERET0js+1yb9SokXR7xYf8/f2lr62srBAaGmqujyciIipVeKc4IiIiBWChExERKQALnYiISAFY6ERERArAQiciIlIAFjoREZECsNCJiIgUgIVORESkACx0IiIiBWChExERKQALnYiISAFY6ERERArAQiciIlIAFjoREZECsNCJiIgUgIVORESkACx0IiIiBWChExERKQALnYiISAFY6ERERArAQiciIlIAFjoREZECsNCJiIgUgIVORESkACx0IiIiBWChExERKQALnYiISAFY6ERERArAQiciIlIAFjoREZECsNCJiIgUgIVORESkACx0IiIiBWChExERKQALnYiISAFY6ERERArAQiciIlIAFjoREZECsNCJiIgUgIVORESkACx0IiIiBWChExERKQALnYiISAFY6ERERArAQiciIlIAFjoREZECsNCJiIgUgIVORESkACx0IiIiBWChExERKQALnYiISAFszLnwQ4cOYffu3fDw8IBKpUJISEiu92/cuIHZs2ejXr16OHfuHNq1a4eWLVuaMxIREZEima3QMzIyMHnyZERERECtVmPYsGE4fPgwfH19pXmWL1+OV155BX369MFff/2Fjz/+mIVORET0DMy2yz06OhqVKlWCWq0GAPj4+CAyMjLXPGXLlkVSUhIAICkpCXXq1DFXHCIiKk0MBlifPwckJMidpNiYbQs9MTERTk5O0rSzszMSExNzzdO3b18MHToUM2bMwJkzZzBkyBBzxSEiIqUSAla3bsLmVBRsT0bl/H/0KajupwNNmwKbdsqdsFiYrdA9PDyQnp4uTWu1Wnh4eOSaZ8yYMejatSvatWuHpKQkvPPOO9i7dy80Gs1Tl+3p6WKOyMVOCeNQwhgAjqMkUcIYAGWMo8SO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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter4_7_0.png" - } - }, - "output_type": "display_data" - } - ], - "source": [ - "agegroupmean = np.array([0.1, 0.133, 0.250, 0.333, 0.462, 0.625, 0.765, 0.800])\n", - "group = np.array([1, 2, 3, 4, 5, 6, 7, 8])\n", - "plt.plot(group, agegroupmean, \"r-\")\n", - "plt.axis([0,9,0, 1.0])\n", - "plt.xlabel(r'Age group')\n", - "plt.ylabel(r'CHD mean values')\n", - "plt.title(r'Mean values for each age group')\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We are now trying to find a function $f(y\\vert x)$, that is a function which gives us an expected value for the output $y$ with a given input $x$.\n", - "In standard linear regression with a linear dependence on $x$, we would write this in terms of our model" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "f(y_i\\vert x_i)=\\beta_0+\\beta_1 x_i.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "This expression implies however that $f(y_i\\vert x_i)$ could take any\n", - "value from minus infinity to plus infinity. If we however let\n", - "$f(y\\vert y)$ be represented by the mean value, the above example\n", - "shows us that we can constrain the function to take values between\n", - "zero and one, that is we have $0 \\le f(y_i\\vert x_i) \\le 1$. Looking\n", - "at our last curve we see also that it has an S-shaped form. This leads\n", - "us to a very popular model for the function $f$, namely the so-called\n", - "Sigmoid function or logistic model. We will consider this function as\n", - "representing the probability for finding a value of $y_i$ with a given\n", - "$x_i$.\n", - "\n", - "\n", - "## The logistic function\n", - "\n", - "Another widely studied model, is the so-called \n", - "perceptron model, which is an example of a \"hard classification\" model. We\n", - "will encounter this model when we discuss neural networks as\n", - "well. Each datapoint is deterministically assigned to a category (i.e\n", - "$y_i=0$ or $y_i=1$). In many cases, and the coronary heart disease data forms one of many such examples, it is favorable to have a \"soft\"\n", - "classifier that outputs the probability of a given category rather\n", - "than a single value. For example, given $x_i$, the classifier\n", - "outputs the probability of being in a category $k$. Logistic regression\n", - "is the most common example of a so-called soft classifier. In logistic\n", - "regression, the probability that a data point $x_i$\n", - "belongs to a category $y_i=\\{0,1\\}$ is given by the so-called logit function (or Sigmoid) which is meant to represent the likelihood for a given event," - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(t) = \\frac{1}{1+\\mathrm \\exp{-t}}=\\frac{\\exp{t}}{1+\\mathrm \\exp{t}}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Note that $1-p(t)= p(-t)$.\n", - "\n", - "## Examples of likelihood functions used in logistic regression and nueral networks\n", - "\n", - "\n", - "The following code plots the logistic function, the step function and other functions we will encounter from here and on." - ] - }, - { - "cell_type": "code", - "execution_count": 3, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "data": { - "image/png": "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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter4_13_0.png" - } - }, - "output_type": "display_data" - }, - { - "data": { - "image/png": "iVBORw0KGgoAAAANSUhEUgAAAfIAAAFnCAYAAABdOssgAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjMuMywgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/Il7ecAAAACXBIWXMAAAsTAAALEwEAmpwYAAAlPUlEQVR4nO3dfXRU9Z3H8c+QMDEPQJIhgIFELNoUwQhZiqYqhIcjrkdrU6rLKlZFShdNdAtbedA1yCJrolCWokUoPahV61EeshzoAZ8CatIIBGrREHyAgEYkz2SSQBJy9w+WayNCLp3MzL2T9+ucnpM7987MN99GPvP73d/c6zIMwxAAAHCkHsEuAAAA/OMIcgAAHIwgBwDAwQhyAAAcjCAHAMDBCHIAAByMIAcgSdq5c6cyMzP1s5/9THPnzg3oez/22GPauHFjQN8TCBUEOeAQc+fO1W9/+1u/vf5vfvMbTZs2Ta+//rpSU1P99j7r16/XXXfd1eGxOXPm6Oabb/bbewKhLDzYBQCwh6NHj6pfv36SpDvuuCOg7x0dHR3Q9wNCiYsruwH20d7erscff1wHDhxQjx49NHjwYD3yyCN67bXXtGrVKkVERGjgwIH68Y9/rNtuu0379u3Tf//3f8vlciksLEyPPfaYhgwZohUrVuiVV15RRkaGamtr9fXXX8vj8ejJJ59UfHz8We+blZWl7du363vf+54SEhJ07bXX6ve//72mTJmi7OxsLV++XC+88ILmz5+vn/70p+brT5o0SQ0NDSotLdWwYcOUm5trvub//u//6o9//KMuuugiSdLMmTPNGquqqjR06FB9//vf15VXXqnly5dr9OjRevLJJyVJH374ofLy8mQYhlwulx5++GGlpqbqrbfe0lNPPaW+ffvqqquu0s6dO9WjRw8988wz8ng8gfk/CbAbA4BtFBQUGPfdd5+5ff/99xtHjhwxDMMw5syZYyxfvtzcd/z4cePqq682CgsLDcMwjHfeece44YYbjFOnTpnHT5w40WhoaDAMwzAeffRRY9asWed873Hjxhl/+ctfzO1vv9/UqVONdevWddh/6623GidPnjROnDhhjB492igpKTEMwzB2795t/OhHPzKqq6sNwzCMP//5z8acOXMMwzCMdevWGVOnTu3w3suXLzf3Hz9+3Bg9erRZy86dO43Ro0cb9fX15vOvuuoq4/Dhw4ZhGMb06dONlStXnq+tQEjjHDlgI71799aBAwf0/vvvq729XUuXLlViYuJ3HvvOO+8oKipK6enpkqSMjAxVVVXpr3/9q3nM2LFjFRMTI0m69dZbtXXrVp06darL6r366qvldrsVERGhSy65RF988YWk0+fBx4wZY47+J06cqH/913+19JrvvPOOYmJidPXVV0uSRo0apT59+ujtt982j7n00kuVlJQkSUpJSTHfF+iOCHLARkaOHKn/+q//0urVqzVu3DitWbNGxjnOfh09elT19fW66667zP/Fx8errq7OPKZPnz7mz7GxsWptbVVtbW2X1XvmQ4IkRUREqLW11azt76fww8PDddVVV1l6zW8/V5Li4+N19OjRTt8X6I5Y7AbYSENDg0aPHq2xY8fq8OHDmj59uvr376/JkyefdezFF1+sAQMG6MUXXzQf83q9crvd5nZ9fb35c21trXr27Km4uDhLtfTs2VMtLS3m9vHjxy3/HhdffLFqamrM7ba2Nn366af6wQ9+cMHPlaSamhoNGDDA8vsD3QkjcsBG3njjDb366quSpOTkZPXv31/t7e2STq/sbm5uVlNTk2bPnq1x48aptrZWH374oSSpqalJP//5z+X1es3Xe++998ztjRs3atKkSQoLC7NUy6BBg/TJJ59IksrLy1VeXm7598jMzNSOHTvMQN6yZYvWr1/f4feQpOzsbLW1tXV47rhx49TY2KidO3dKknbv3q36+nqNHz/e8vsD3Qmr1gEb+fzzz/Xkk0/qxIkTampqUkpKinJycuR2u7Vnzx7NmzdPMTExuvvuu3XLLbdo3759ys3NlWEYMgxD06dP17hx4ySd/t55ZGSkqqur9eWXXyo+Pl65ubmdrlq/5ZZbNH36dFVVVemBBx6QYRgaNWqUPvzwQ1VVVWnu3Lk6ePCgfv/73ysiIkLz5s1TWVmZ1q5dq759+yonJ0fp6enKz8/Xyy+/LLfbrbi4OC1evFgxMTGqr6/XPffco4iICA0fPlzDhw/X8uXLdfLkSU2dOlUzZ840f6/29vYOq9aLior0+OOPq6qqSj//+c81bNgwPfHEEzp58qSmT5+ue++9N9D/lwFBR5ADIWru3LkaOHCgsrOzg10KAD9iah0AAAdjsRsQglasWKF3331XERERGjBggG677bZglwTAT7pkar2yslLLli3T/v37tW7durP2FxcXa/Hixerdu7ek099tnT59uiSpsLBQ27Ztk8fjkcvlUlZWlq/lAADQbXTJiHz37t2aMGGCSktLz3nM/PnzzQs8nNHc3KycnBxt3rxZbrdb2dnZKioqMi9wAQAAzq9LzpHfeOONnd70ID8/X2vWrNH//M//6KuvvpIk7d27V4mJieb3XtPS0lRQUNAVJQEA0C0E5Bz5ZZddpvvvv9/8Xuq9996rLVu2qLq6usMHgJiYGFVXV3f6em1tpxQebu27sAAAhLKABPnf35Xo8ssvV0NDg7766it5PB41Njaa+7xer6U7GNXWNvmlTn9JSOilysqGYJcR8uiz/9Fj/6PHgeG0Pick9DrnPr99/aypqcm8qtOqVavM6z/X1dWptbVVffv21YgRI1RRUWFeBrKkpEQZGRn+KgkAgJDTJSPyDz74QPn5+aqsrNSzzz6radOmacOGDSorK9PChQs1aNAgPfHEE7rsssv06aefKjc3VxEREZKkBQsWaNGiRYqLi1NKSgoL3QAAuACOvLKbk6ZDJOdN4TgVffY/eux/9DgwnNbnoEytAwAA/yPIAQBwMIIcAAAHI8gBAHAwghwAAAcjyAEAcDCCHAAAByPIAQBwMIIcAAAHI8gBAHAwghwAAAcjyAEAcDCCHAAAByPIAQBwMIIcAAAHI8gBAHAwghwAAAcjyAEAcDCCHAAAByPIAQBwMIIcAAAHI8gBAHAwghwAAAcjyAEAcDCCHAAAByPIAQBwMIIcAAAHI8gBAHAwghwAAAcL74oXqays1LJly7R//36tW7furP3r16/X3r17lZycrI8//lhTp05VWlqaJOn2229XRESEJKlHjx56/vnnu6IkAAC6hS4J8t27d2vChAkqLS39zv1ff/21HnnkEUVEROivf/2rHn30UW3atEmSdP311ys7O7srygAAoNvpkiC/8cYbVVxcfM79M2fONH9ub29XVFSUuX3gwAGtWrVKJ0+e1JVXXqmMjIyuKAkAgG6hS4LcKsMw9MILL2ju3LnmY7/4xS+UmpqqU6dO6c4771R0dLR++MMfnvd14uKiFB4e5u9yu1RCQq9gl9At0Gf/o8f+R48DI1T6HLAgNwxDeXl5yszM1MiRI83HU1NTJUlhYWEaNWqUiouLOw3y2tomv9ba1RISeqmysiHYZYQ8+ux/9Nj/6HFgOK3P5/vQ4bdV601NTaqpqZEknTp1Sk888YTGjRunMWPGaOvWrZKkzz77TK+99pr5nPLyciUlJfmrJAAAQk6XjMg/+OAD5efnq7KyUs8++6ymTZumDRs2qKysTAsXLlReXp7efPNNlZWVSZIOHz6sSZMmKSYmRtu3b9exY8fk9Xo1YMAA3XLLLV1REgAA3YLLMAwj2EVcKCdNh0jOm8JxKvrsf/TY/+hxYDitz0GZWgcAAP5HkAMA4GAEOQAADkaQAwDgYAQ5AAAORpADAOBgBDkAAA5GkAMA4GAEOQAADkaQAwDgYAQ5AAAORpADAOBgBDkAAA5GkAMA4GAEOQAADkaQAwDgYAQ5AAAORpADAOBgBDkAAA5GkAMA4GAEOQAADkaQAwDgYAQ5AAAORpADAOBgBDkAAA5GkAMA4GAEOQAADkaQAwDgYAQ5AAAOFt4VL1JZWally5Zp//79Wrdu3Vn729vbtXTpUkVHR+vLL7/Uz372M40YMUKSVFhYqG3btsnj8cjlcikrK6srSgIAoFvokiDfvXu3JkyYoNLS0u/c/+c//1ler1f/8R//obq6Ov3Lv/yLtmzZopaWFuXk5Gjz5s1yu93Kzs5WUVGR0tPTu6IsAABCXpcE+Y033qji4uJz7i8oKNC1114rSYqNjZXb7dYnn3yi2tpaJSYmyu12S5LS0tJUUFBAkAM2VVHl1b4DlcEuI6T1/tqr4/XNwS4j5Dmpz72j3UpI6HXO/V0S5J2pqalRTEyMuR0TE6OamhrV1NQoOjq6w+PV1dWBKAnAP2DeM++r5viJYJcBdDubRgw6576ABHl8fLy8Xq+57fV6FR8fL5fLpcbGxg6PezyeTl8vLi5K4eFhfqnVX873aQpdhz77l7epRX1jI3XrmCHBLgXoNuJ6RZx3v9+CvKmpSSdOnFB8fLwyMjK0c+dO/eQnP1FdXZ1aWlp0+eWXq6WlRRUVFWppaZHb7VZJSYnuuOOOTl+7trbJX2X7RUJCL1VWNgS7jJBHn/2v3ZB6R/XUtVf0C3YpIYu/48AIpT53SZB/8MEHys/PV2VlpZ599llNmzZNGzZsUFlZmRYuXKh//ud/1scff6wVK1aooqJCubm5CgsLU2RkpBYsWKBFixYpLi5OKSkpnB8HbM2QK9glAOjAZRiGEewiLpTTPkWF0ic/O6PP/jc97x197+Lemn/XPwW7lJDF33FgOK3P5zttyAVhAFhnGGJIDtgLQQ7AsnaDfzQAu+G/SQCWnDkL53IxJAfshCAHYMmZxTTkOGAvBDkAa/4/yRmRA/ZCkAOwpN15X3ABugWCHMAF6cGAHLAVghyAJeYlJ5haB2yFIAdgSTs5DtgSQQ7AmjNBzhVhAFshyAFY0m5+jzzIhQDogCAHcEHIccBeCHIAlnBlN8CeCHIAlnBlN8CeCHIAlhhc2Q2wJYIcgCUGi90AWyLIAVhijsiDWwaAbyHIAVjyzTlyohywE4IcgCVMrQP2RJADsITFboA9EeQALDFH5EGuA0BHBDmAC8KAHLAXghyAJWeutc6YHLAXghyANf+f4z3IccBWCHIAlrSf+YEgB2yFIAdgDTdNAWyJIAdgCVd2A+yJIAdgSTsjcsCWCHIAF4QcB+yFIAdgSTtXdgNsKbwrXqSwsFDbtm2Tx+ORy+VSVlZWh/3z58/XkSNHzO0DBw5o3bp1GjRokMaPH6+BAwdKkvr166clS5Z0RUkAuhrXWgdsyecgb25uVk5OjjZv3iy3263s7GwVFRUpPT3dPOa6667TTTfdJEnyer2aO3euBg0aJEnKzMxUdna2r2UA8DMWuwH25PPU+t69e5WYmCi32y1JSktLU0FBQYdjzoS4JL3++uuaPHmyub1r1y6tXr1ay5YtU0lJia/lAPATbmMK2JPPI/Lq6mpFR0eb2zExMaqurv7OY9vb2/Xee+/p7rvvNh+bPXu2UlNT1dzcrMzMTD333HO65JJLzvuecXFRCg8P87X0gEpI6BXsEroF+uw/DS2nLwkTFeWmz35GfwMjVPrsc5B7PB41Njaa216vVx6P5zuPffvtt5WRkdHhE31qaqokKTIyUkOHDlVJSUmnQV5b2+Rr2QGVkNBLlZUNwS4j5NFn/6qpOf3f+YnmVvrsR/wdB4bT+ny+Dx0+T62PGDFCFRUVamlpkSSVlJQoIyNDdXV18nq9HY7dsGGDMjMzze2ioiLt2LHD3C4vL1dSUpKvJQHwA0MsdgPsyOcReWRkpBYsWKBFixYpLi5OKSkpSk9PV15enmJjYzVjxgxJUmlpqZKTkztMw8fHx2vFihX6+OOPdezYMd1www0aNWqUryUB8ANzsRtBDtiKyzDMexM6hpOmQyTnTeE4FX32r88rjmvRC7t04+hk3T7+smCXE7L4Ow4Mp/XZr1PrALoHptYBeyLIAVhizt0R5ICtEOQArPn/IO/BkBywFYIcgCXtzltOA3QLBDmAC8KV3QB7IcgBWHLmCy7EOGAvBDkAS/geOWBPBDkAS86MyFnsBtgLQQ7AkvYzP5DjgK0Q5ACsMafWSXLATghyAJaw2A2wJ4IcgCXmhd1IcsBWCHIAlpgjcpIcsBWCHIAlfP0MsCeCHIAlZpBzlhywFYIcgCXcxhSwJ4IcgCXfjMgB2AlBDsASg++RA7ZEkAOwxGBIDtgSQQ7ggnCtdcBeCHIAlrSfGZEDsBWCHMAF6cGAHLAVghyAJe1c2Q2wJYIcgDXmxdaDWgWAbyHIAVhy5hQ5i90AeyHIAVjCYjfAnghyABeEATlgLwQ5AEvMxW6cJAdshSAHYA23MQVsKbwrXqSwsFDbtm2Tx+ORy+VSVlZWh/3r16/Xn/70J0VEREiSJk+erJ/85CeSpPz8fJWWlqpHjx5KTk7WlClTuqIkAF3MXLROkAO24nOQNzc3KycnR5s3b5bb7VZ2draKioqUnp7e4bilS5dq0KBBHR47evSo/vCHP2jjxo1yuVyaPHmyrrnmGg0ePNjXsgB0MYPvkQO25PPU+t69e5WYmCi32y1JSktLU0FBwVnHvfTSS1qzZo1WrFihuro6SdK7776rYcOGmf8wjBw5Ujt27PC1JAB+wD1TAHvyeUReXV2t6OhoczsmJkbV1dUdjvnhD3+ojIwMxcfHa/v27XrooYf0/PPPq6ampsNzo6Ojz3rud4mLi1J4eJivpQdUQkKvYJfQLdBn/4mJOX1qrE+fSPrsZ/Q3MEKlzz4HucfjUWNjo7nt9Xrl8Xg6HJOUlGT+fM0112jmzJk6deqU4uPjVV5ebu5rbGxUcnJyp+9ZW9vka9kBlZDQS5WVDcEuI+TRZ/863nBCktTQcII++xF/x4HhtD6f70OHz1PrI0aMUEVFhVpaWiRJJSUlysjIUF1dnbxeryRpyZIlamtrkyQdOnRIAwcOVFhYmK6//np99NFH5rm3PXv2aMyYMb6WBMAPzKl1zpEDtuLziDwyMlILFizQokWLFBcXp5SUFKWnpysvL0+xsbGaMWOG+vbtqwULFmjQoEE6cOCAnnrqKUnSgAEDNG3aNC1evFhhYWG67bbbWOgG2JS52C3IdQDoyGUYzrvuopOmQyTnTeE4FX32rzd2HdErb36iBzKH659S+gW7nJDF33FgOK3Pfp1aB9A9MLUO2BNBDsAaptYBWyLIAVjSzogcsCWCHMCFIccBWyHIAVhyZl1sD4IcsBWCHIAl33y9hSQH7IQgB2AJI3LAnghyAJa0m/cxDWoZAL6FIAdgDbcxBWyJIAdgCbcxBeyJIAdgiTmzzogcsBWCHIAl3DQFsCeCHIAl31xrPbh1AOiIIAdgiSEWuwF2RJADsIQROWBPBDkAS7iNKWBPBDkAS8yp9SDXAaAjghyAJYzIAXsiyAFYwzlywJYIcgCWtJuXaA1yIQA6IMgBXBAXZ8kBWyHIAVjCiBywJ4IcgDVG54cACDyCHIAlZ1at92BIDtgKQQ7AEkPcxxSwI4IcgCV8jxywJ4IcgCXcxhSwJ4IcgCVn1roxIAfshSAHYMmZETmL3QB7IcgBWGKYQ/KglgHgW8K74kUKCwu1bds2eTweuVwuZWVlddi/atUqVVVVKSEhQfv27dODDz6oIUOGSJLGjx+vgQMHSpL69eunJUuWdEVJALoYi90Ae/I5yJubm5WTk6PNmzfL7XYrOztbRUVFSk9PN49pamrSvHnz5HK5tGXLFj311FNauXKlJCkzM1PZ2dm+lgHAz7iNKWBPPk+t7927V4mJiXK73ZKktLQ0FRQUdDjm3//9381P8e3t7YqKijL37dq1S6tXr9ayZctUUlLiazkA/MTg7meALfk8Iq+urlZ0dLS5HRMTo+rq6u88tqWlRRs2bFBOTo752OzZs5Wamqrm5mZlZmbqueee0yWXXHLe94yLi1J4eJivpQdUQkKvYJfQLdBn/4mIOP3PhccTo4S4qE6Ohi/4Ow6MUOmzz0Hu8XjU2Nhobnu9Xnk8nrOOa2lp0YIFC/SrX/1KycnJ5uOpqamSpMjISA0dOlQlJSWdBnltbZOvZQdUQkIvVVY2BLuMkEef/av5RKskqbamUa62U0GuJnTxdxwYTuvz+T50+Dy1PmLECFVUVKilpUWSVFJSooyMDNXV1cnr9Ur65jz6vffeq+HDh2vr1q2SpKKiIu3YscN8rfLyciUlJflaEgB/YLEbYEs+j8gjIyO1YMECLVq0SHFxcUpJSVF6erry8vIUGxurGTNm6Ne//rU++eQTffHFF5JOL36bNGmS4uPjtWLFCn388cc6duyYbrjhBo0aNcrnXwpA1+M2poA9uQzDcNzNCZ00HSI5bwrHqeizf63M36cPSo/pN1nXqk9MRLDLCVn8HQeG0/rs16l1AN1DO1PrgC0R5ACsMbiNKWBHBDkAS87kONdaB+yFIAdgieMW0wDdBEEOwJJv7n4W5EIAdECQA7CEm6YA9kSQA7DEgd9UBboFghyAJWdinMVugL0Q5AAsMQfk5DhgKwQ5AEtY7AbYE0EOwJJvzpCT5ICdEOQALDG4aQpgSwQ5AEu++fpZcOsA0BFBDsCSb0bkJDlgJwQ5gAtCjAP2QpADsITbmAL2RJADsMYwOD8O2BBBDsCSdjEaB+yIIAdgjcH5ccCOCHIAlhiGwYgcsCGCHIAlhrg8K2BHBDkASwzD4GowgA0R5AAsMQxG5IAdEeQALGFADtgTQQ7AEha7AfZEkAOwxBBfPwPsiCAHYAkjcsCeCHIAlhjiHDlgRwQ5AEtOL3YjyQG7Ce+KFyksLNS2bdvk8XjkcrmUlZXVYf/JkyeVm5ur/v3769ChQ5oxY4YuvfRSSVJ+fr5KS0vVo0cPJScna8qUKV1REoAuZnDTFMCWfA7y5uZm5eTkaPPmzXK73crOzlZRUZHS09PNY55//nldfPHF+sUvfqGysjI98sgjevnll3X06FH94Q9/0MaNG+VyuTR58mRdc801Gjx4sK9lAehijMgBe/I5yPfu3avExES53W5JUlpamgoKCjoEeUFBgWbNmiVJSklJ0f79++X1evXuu+9q2LBh5j8OI0eO1I4dOzoN8sfWFPtadkCFh4epre1UsMsIefTZv6rqm9Uryh3sMgB8i89BXl1drejoaHM7JiZG1dXVlo6pqanp8Hh0dPRZz/0udd4WX8sGcIEucodr1ND+SkjoFexSQh49DoxQ6bPPQe7xeNTY2Ghue71eeTweS8fEx8ervLzcfLyxsVHJycmdvufyh673teyASkjopcrKhmCXEfLos//RY/+jx4HhtD6f70OHz6vWR4wYoYqKCrW0nB4ll5SUKCMjQ3V1dfJ6vZKkjIwM7dmzR5JUVlamH/zgB4qJidH111+vjz766PTNGCTt2bNHY8aM8bUkAAC6DZdxJkV98P7772vr1q2Ki4tTz549lZWVpby8PMXGxmrGjBk6ceKEcnNzlZCQoMOHD+uXv/xlh1Xr+/btU1hYmAYPHmxp1bqTPkVJzvvk51T02f/osf/R48BwWp/PNyLvkiAPNCc1X3LeH4xT0Wf/o8f+R48Dw2l99uvUOgAACB6CHAAAByPIAQBwMIIcAAAHI8gBAHAwghwAAAcjyAEAcDCCHAAAByPIAQBwMIIcAAAHI8gBAHAwghwAAAcjyAEAcDCCHAAAByPIAQBwMIIcAAAHI8gBAHAwghwAAAcjyAEAcDCCHAAAByPIAQBwMIIcAAAHI8gBAHAwghwAAAcjyAEAcDCCHAAAByPIAQBwMIIcAAAHI8gBAHCwcF+eXFdXpyVLligpKUmHDh3SrFmz1Ldv3w7HfPjhh3r++ed1xRVX6ODBg0pNTdXtt98uSXrsscd08OBB89hHH31UKSkpvpQEAEC34lOQL126VOnp6brpppv09ttvKzc3V0899VSHYyorK3X33XcrNTVVra2t+tGPfqSJEycqPj5eCQkJWrhwoU+/AAAA3ZlPQb59+3bNnDlTkpSWlqa5c+eedcyECRM6bIeFhalnz56SpMbGRv3ud79TWFiYoqKiNGXKFIWH+1QSAADdisswDON8B9x3332qqqo66/EHH3xQDz30kAoLC9W7d2+1tbVp2LBh+uijj84ZxmvXrpUk3XPPPZKkjz76SCkpKQoPD1deXp6io6P1wAMPdFp0W9sphYeHdXocAAChrtPh75o1a865z+PxqLGxUb1795bX61WfPn3OGeKbNm1SU1OT7r//fvOxYcOGmT9fc801Wr16taUgr61t6vQYO0lI6KXKyoZglxHy6LP/0WP/o8eB4bQ+JyT0Ouc+n1atjx07Vnv27JEklZSUaOzYsZKk9vZ2VVRUmMe99tprqq6u1v3336+ysjJzgVtubq55THl5uZKTk30pBwCAbsenE9KzZs3S008/rUOHDunIkSOaM2eOJKmsrEwPP/ywNm3apDfffFNPPvmkrrjiCr311luqq6vTo48+qksvvVR1dXV6+umnddFFF+ngwYOaN29el/xSAAB0F52eI7cjJ02HSM6bwnEq+ux/9Nj/6HFgOK3PfptaBwAAwUWQAwDgYAQ5AAAORpADAOBgBDkAAA5GkAMA4GAEOQAADkaQAwDgYAQ5AAAORpADAOBgBDkAAA5GkAMA4GAEOQAADkaQAwDgYAQ5AAAORpADAOBgBDkAAA5GkAMA4GAEOQAADkaQAwDgYAQ5AAAORpADAOBgBDkAAA5GkAMA4GAEOQAADkaQAwDgYAQ5AAAORpADAOBgBDkAAA5GkAMA4GDhvjy5rq5OS5YsUVJSkg4dOqRZs2apb9++Zx03fvx4DRw4UJLUr18/LVmyRJL0xRdf6Nlnn9Ull1yiL7/8UnPmzFF0dLQvJQEA0K34NCJfunSp0tPTNWPGDE2cOFG5ubnfeVxmZqZefPFFvfjii2aIS1JOTo6mTJmiX/7yl7r88su1evVqX8oBAKDb8SnIt2/frpEjR0qS0tLStH379u88bteuXVq9erWWLVumkpISSVJra6uKi4t15ZVXdvp8AADw3TqdWr/vvvtUVVV11uMPPvigqqurzanwmJgY1dfXq62tTeHhHV929uzZSk1NVXNzszIzM/Xcc88pMjJSF110kVwul/n86upqS0UnJPSydJydOLFmJ6LP/keP/Y8eB0ao9LnTIF+zZs0593k8HjU2Nqp3797yer3q06fPWSEuSampqZKkyMhIDR06VCUlJbr55pt14sQJGYYhl8slr9crj8fjw68CAED349PU+tixY7Vnzx5JUklJicaOHStJam9vV0VFhSSpqKhIO3bsMJ9TXl6upKQk9ezZU1dffbX+9re/nfV8AABgjcswDOMffXJdXZ2efvppJSYm6siRI5o9e7b69u2r0tJSPfzww9q0aZPKysq0YsUKDRs2TMeOHVO/fv30b//2b5JOr1p/5plnlJSUpK+++kpz585l1ToAABfApyAHAADBxQVhAABwMIIcAAAH8+nKbrhwv/vd77R27VoVFxcHu5SQs3jxYkVGRioqKkr79+/X/PnzlZCQEOyyQkJhYaG2bdsmj8cjl8ulrKysYJcUcg4fPqxly5bpiiuu0NGjRxUbG0uf/eTEiRO67bbbdN1112nOnDnBLsdnBHkAFRcXq76+PthlhKzIyEj96le/kiStWrVKK1eu1H/+538GuSrna25uVk5OjjZv3iy3263s7GwVFRUpPT092KWFlLq6Ot10002aOHGiJOmmm25SRkaGhg8fHuTKQs+ZD0yhgqn1AKmqqtKWLVs0derUYJcSss6EuCQZhqGoqKggVhM69u7dq8TERLndbkmnr8JYUFAQ3KJCUGpqqhni0umv8UZGRgaxotC0ceNGpaWladCgQcEupcswIu9C57sK3ltvvaU5c+aooaEhCJWFjvP1eMKECZKk48eP67333tNvf/vbQJcXkv7+Co7ShV2FEf+YN954Q9ddd52GDBkS7FJCyqeffqrPP/9cs2bNUllZWbDL6TIEeRc611Xw/va3vyk8PFyvvvqq6uvrdfLkSa1atUo33HCDBg8eHNgiHe58VxqUpIaGBj3++ONavHixYmNjA1NUiDtzBcczuAqjf/3lL39RcXGx5s+fH+xSQs4bb7wht9utVatWaffu3WptbdXatWt1zz33BLs0nxDkAXDllVeaN4f54osv9Prrr2vGjBlBrir01NTUaPHixXr44YfVv39/bd26VZMmTQp2WY43YsQIVVRUqKWlRW63WyUlJbrjjjuCXVZIKigo0K5du/TII4/o2LFjqqioMG9MBd/NnDnT/PnkyZNqampyfIhLXBAmoMrLy/WnP/1Jr7zyimbMmKF77rmH87hdKDMzU21tbeZIPDo6WitXrgxuUSHi/fff19atWxUXF6eePXuymtoP9u3bp7vuustc3NbU1KQ777xTP/3pT4NcWejZunWrXnrpJbW2turOO+/UzTffHOySfEKQAwDgYKxaBwDAwQhyAAAcjCAHAMDBCHIAAByMIAcAwMEIcgAAHIwgBwDAwbiyG4BOrV+/Xm+99Zb69++v+vp6bdmyRfn5+fr+978f7NKAbo8LwgDo1J49exQbG6tLL71U2dnZSk5O1q9//etglwVABDmAC/Daa6/p5Zdf1quvvmre1hRAcDG1DsCSgwcPasmSJXrppZcIccBGWOwGoFOtra2aPXu2srOzNWTIEH322WfatWtXsMsCIEbkACxYu3atPvvsM3322WdauHChvv76a02YMEGjRo0KdmlAt8c5cgAAHIypdQAAHIwgBwDAwQhyAAAcjCAHAMDBCHIAAByMIAcAwMEIcgAAHIwgBwDAwf4PI7ucjeDSrdsAAAAASUVORK5CYII=\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter4_13_1.png" - } - }, - "output_type": "display_data" - }, - { - "data": { - "image/png": "iVBORw0KGgoAAAANSUhEUgAAAfIAAAFnCAYAAABdOssgAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjMuMywgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/Il7ecAAAACXBIWXMAAAsTAAALEwEAmpwYAAA3KklEQVR4nO3deXxU9b3/8ddkJpOd7CwJCTthkQiISu7FgnultYpcW+vS+pOf9NqCbdEKLi3Uh+WW9eFtaV2otV6vW1sLFrEVlx+gEkEMiGwBgYSQEMg2SSbbJJnz+yMwNcKQgUlyZnk//yEz5zszn/kwk3fO92wWwzAMREREJChFmF2AiIiIXDgFuYiISBBTkIuIiAQxBbmIiEgQU5CLiIgEMQW5iIhIEFOQi4SoOXPmMG7cOLZu3erzY5YvX84tt9zCjTfeyHvvvdeD1XXW0tLC1KlTaWpq6rXXFAkVCnKRAHLXXXfxt7/9rVuea9WqVaSnp/s8/ujRo7z00ku8+uqr/Pa3vyUmJqZb6jibr77PqKgo1q1b16OvKRKqbGYXICKBoby8nOTkZOx2O4MHD2bw4MG9+vp9+vTp1dcTCRUKcpEAsWLFCvbt20dFRQVr1qxh1qxZXHrppSxatIjKykpaWloYMWIEP//5z7HZbKxatYpXXnmF66+/nvr6evbt28fYsWNZsmRJp+f97LPPeOGFFzh48CB33303d9xxxxmvvWvXLn71q19RUVHBXXfdxTXXXMOmTZv46KOPeO+990hLS+N73/sen332GYWFhbhcLmbNmsW2bdv4xS9+wcaNGzly5Ajz58/n2muvBaChoYH/+q//4tChQwAMGTKEBx98kOeff/6M97lu3To2bNjAH/7wBy6//HIMw+C5555jw4YNWK1WBg8ezKOPPkp8fDyLFi3izTff5M477+Tw4cMUFhZy/fXXM2/evJ7/TxIJRIaIBIw777zTeP311z23a2pqjLVr13puz58/3/jzn//c6fZNN91ktLS0GM3NzcZll11mFBQUeJZfeeWVxsKFCw3DMIzPPvvMGD9+vNHa2nrW1/7444+NK6+8stN9I0eONEpKSgzDMIySkhJj5MiRZyx/9tlnDcMwjPXr1xvXXXedZ9ljjz1mLFiwwDAMw2hvbzd+8IMfGB9//PFZ3+fpWk8vX7NmjTF9+nSjsbHRMAzDeOSRR4yHH364U5/uvfdew+12GydOnDDGjBljlJeXn/V9iYQ6bSMXCWCJiYmUlZXx3e9+l7vuuott27axZ8+eTmMuv/xy7HY7UVFRDBo0iGPHjnVafsUVVwAwatQoGhsbqaqq6tYaTz9/Tk4OpaWlALjdbtauXcstt9wCQEREBAsWLGD48OE+Pecbb7zBDTfc4Nlmfsstt/D3v/+d9vZ2z5gpU6ZgsVjo27cvSUlJntcWCTeaWhcJYGvWrOG1115j7dq1JCUl8dvf/vaMwIqPj/f8HBUVRWtr61mX2+12gDOW++v083/5taurq3G5XKSkpHjGnc829/Ly8k6PTUlJobW1lcrKSvr169fpdb/62iLhRmvkIgFs165d5ObmkpSUBEBbW1uvvn5kZCQulwuA+vp6nx+XkpKC3W6nurrac9+JEyeoqKjw6fEDBgzo9Njq6moiIyNJS0vzuQaRcKEgFwkgcXFxNDU1UVRUxJIlSxg0aBD79+/H5XLR1tZGfn5+r9aTmZnJwYMHAdi0aZPPj4uIiODmm2/2HGLmdrt59NFHqaysBM58n181Y8YM/vnPf9Lc3AzA2rVr+da3voXVavX3LYmEHAW5SACZOXMm//M//8ODDz7I1KlT+c53vsOIESO46aabmDdvHunp6XzwwQc8//zzPP/883zwwQesWbOGd955h1WrVrFv3z6effZZ8vPzeeihh6ioqGDx4sWUlJQwZ84cAObNm4fD4ej0urt27WLx4sWevdYLCws9Y5ctW8a9995LQkIC0HEMeHt7O/fcc49nTH19vWev8dP3L1iwgIiICL773e9y++23c+WVVzJ69Oizvs8HHnjAU+vu3bu58cYbmTFjBt///vf57ne/S1tbG4888ggAS5cu9bzPHTt2sGjRIs9jv/jii579DxIJQBbDMAyzixAREZELozVyERGRIKYgFxERCWLdcvhZRUUFTz75JPv37+f1118/Y7nb7WblypXExcVRWlrKf/zHfzB+/HgAtmzZwoYNG0hNTcVisXi244mIiEjXuiXIP/30U66++mr27dt31uX/+Mc/cDqdPPjggzgcDr7zne/w1ltv4XK5WLhwIevXr8dutzN37lzy8/PJy8vrjrJERERCXrdMrX/9618nLi7O6/KNGzd61sCTkpKw2+0cPHiQnTt3kpGR4TlRxcSJE9m4cWN3lCQiIhIWeuXM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bNYIn59PRCTY+BXkY8aM6XLMzp07ycjIwG7v2Nt34sSJbNy4kby8PDZt2sR9993nuX/BggU+ve6Pf/PhhRctAcUaYcEeacUeGUFMlI3k+CiiTv0cE20jJspGbJSNuOhI4mI6/u0TaychNpKEWDsxUVbtiCYiYa3LIJ81axaVlZVn3H///fdz9dVXd/kCVVVVxMXFeW7Hx8dTVVV1xrL4+Hhqa2tpa2vDZjt3WetW3NTl64r4Iz09wewSApZ645164516452/vekyyJ977jm/XiA1NZWGhn/tHex0OklNTe20rE+fPjidThITE7sMcREREfmXHtt4WFJSAsD48eMpKyvD5erYVl1QUMC0adMAmDp1Kjt27PDcP3Xq1J4qR0REJCRZDONcu1mdW21tLS+99BLPP/88N910E9/85jcZP3481dXV3HTTTbz77rtERUXx0Ucf8fbbb5OcnExkZGSnvdaXL19ORkYGJSUlPPDAA9prXURE5Dz4FeQiIiJiLh2XIyIiEsQU5CIiIkEs5HcRd7lcPP/888TGxnLw4EGSk5P56U9/anZZAeWpp57iT3/6E1u3bjW7lICxePFiYmJiiI2NZf/+/TzyyCOkp6ebXZapvJ2hMdwdPXqUJ598kjFjxlBeXk5SUpJ68yXNzc3ceuutTJkyhfnz55tdTkA5fPgw69evJyoqik8++YS5c+eSm5t73s8T8kG+evVqLrvsMi699FKg42x08i9bt26ltrbW7DICTkxMjOcPvmeffZann36an//85yZXZZ5znaEx3DkcDqZPn84111wDwPTp05k2bRoXXXSRyZUFhtN/5Ehn7e3t/PrXv+bpp58mIiKCm2+++YIPvw75IH/zzTfJyMhgz549OBwO7rrrLrNLChiVlZW89dZb3HvvvaxZs8bscgLKl2dtDMMgNjbWxGrMd64zNIa7r65Bud3uc562OpysXbuWiRMnUlhYSGNjo9nlBJTPP/8cwzB48cUXaW5uJikpiW9/+9sX9FwhEeTnOvtcaWkpFouFu+++my1btvCTn/yEF1980YQqzXGu3rz33nvMnz+f+vrwvNKXL2ctrKur48MPP+S3v/1tb5cXUM51hkb5l3feeYcpU6YwbNgws0sx3RdffMHhw4eZN28ehYWFZpcTcMrKyti5cycrV64kISGBBx98kMjISG655Zbzfq6QCPJznX0uPj7e8xfzJZdcwvbt22lvb8dqtfZWeaby1pvPP/8cm83Ga6+9Rm1tLS0tLTz77LNcd911DB48uHeLNElXZy2sr6/nl7/8JYsXLyYpKal3igpQ5zpDo3T4+OOP2bp1K4888ojZpQSEd955B7vdzrPPPsunn35Ka2srf/rTn7j77rvNLi0gxMXFMXToUBISOk7Peskll7Bt27bwDfJzycvLo6SkhKFDh1JaWkp2dnbYhPi5jBs3jnHjxgFw7Ngx/vrXvzJ79myTqwoc1dXVLF68mIceeoh+/frx9ttvc/3115tdlmm+fIZGu91OQUEBt99+u9llBYyNGzeyfft2Hn30UU6ePElZWRkTJkwwuyxTnb4gFkBLSwuNjY0K8S+5+OKLcTgcnhXLsrKyC16JCvkTwpw4cYLf/OY3ZGdnc+jQIe68884L2iswVBUXF/Pqq6/yyiuvMHv2bO6+++6w3x4MMGPGDNra2jxr4nFxcTz99NPmFmUyb2doDHe7d+/mrrvu8uzc1tjYyB133HFBa1ah6O233+all16itbWVO+64g29+85tmlxQw3nnnHT7++GOSk5M5fvw4P//5z4mOjj7v5wn5IBcREQllOiGMiIhIEFOQi4iIBDEFuYiISBBTkIuIiAQxBbmIiEgQU5CLiIgEMQW5iIhIEAv5M7uJiP/+9re/8d5779GvXz9qa2t56623eOONNxg5cqTZpYmEPZ0QRkS6tGPHDpKSkhgyZAhz584lOzubn/3sZ2aXJSIoyEXkPPzlL3/h5Zdf5rXXXvNc0lREzKWpdRHxyZEjR1ixYgUvvfSSQlwkgGhnNxHpUmtrKw888ABz585l2LBhHDp0iO3bt5tdloigNXIR8cGf/vQnDh06xKFDh3j88cc5ceIEV199NZMmTTK7NJGwp23kIiIiQUxT6yIiIkFMQS4iIhLEFOQiIiJBTEEuIiISxBTkIiIiQUxBLiIiEsQU5CIiIkFMQS4iIhLE/j+D9tG7MzafHQAAAABJRU5ErkJggg==\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter4_13_2.png" - } - }, - "output_type": "display_data" - } - ], - "source": [ - "\"\"\"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", - "\"\"\"tanh Function\"\"\"\n", - "z = numpy.arange(-2*mt.pi, 2*mt.pi, 0.1)\n", - "t = numpy.tanh(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('tanh function')\n", - "\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We assume now that we have two classes with $y_i$ either $0$ or $1$. Furthermore we assume also that we have only two parameters $\\beta$ in our fitting of the Sigmoid function, that is we define probabilities" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{align*}\n", - "p(y_i=1|x_i,\\boldsymbol{\\beta}) &= \\frac{\\exp{(\\beta_0+\\beta_1x_i)}}{1+\\exp{(\\beta_0+\\beta_1x_i)}},\\nonumber\\\\\n", - "p(y_i=0|x_i,\\boldsymbol{\\beta}) &= 1 - p(y_i=1|x_i,\\boldsymbol{\\beta}),\n", - "\\end{align*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $\\boldsymbol{\\beta}$ are the weights we wish to extract from data, in our case $\\beta_0$ and $\\beta_1$. \n", - "\n", - "Note that we used" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(y_i=0\\vert x_i, \\boldsymbol{\\beta}) = 1-p(y_i=1\\vert x_i, \\boldsymbol{\\beta}).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In order to define the total likelihood for all possible outcomes from a \n", - "dataset $\\mathcal{D}=\\{(y_i,x_i)\\}$, with the binary labels\n", - "$y_i\\in\\{0,1\\}$ and where the data points are drawn independently, we use the so-called [Maximum Likelihood Estimation](https://en.wikipedia.org/wiki/Maximum_likelihood_estimation) (MLE) principle. \n", - "We aim thus at maximizing \n", - "the probability of seeing the observed data. We can then approximate the \n", - "likelihood in terms of the product of the individual probabilities of a specific outcome $y_i$, that is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{align*}\n", - "P(\\mathcal{D}|\\boldsymbol{\\beta})& = \\prod_{i=1}^n \\left[p(y_i=1|x_i,\\boldsymbol{\\beta})\\right]^{y_i}\\left[1-p(y_i=1|x_i,\\boldsymbol{\\beta}))\\right]^{1-y_i}\\nonumber \\\\\n", - "\\end{align*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "from which we obtain the log-likelihood and our **cost/loss** function" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathcal{C}(\\boldsymbol{\\beta}) = \\sum_{i=1}^n \\left( y_i\\log{p(y_i=1|x_i,\\boldsymbol{\\beta})} + (1-y_i)\\log\\left[1-p(y_i=1|x_i,\\boldsymbol{\\beta}))\\right]\\right).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Reordering the logarithms, we can rewrite the **cost/loss** function as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathcal{C}(\\boldsymbol{\\beta}) = \\sum_{i=1}^n \\left(y_i(\\beta_0+\\beta_1x_i) -\\log{(1+\\exp{(\\beta_0+\\beta_1x_i)})}\\right).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The maximum likelihood estimator is defined as the set of parameters that maximize the log-likelihood where we maximize with respect to $\\beta$.\n", - "Since the cost (error) function is just the negative log-likelihood, for logistic regression we have that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathcal{C}(\\boldsymbol{\\beta})=-\\sum_{i=1}^n \\left(y_i(\\beta_0+\\beta_1x_i) -\\log{(1+\\exp{(\\beta_0+\\beta_1x_i)})}\\right).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "This equation is known in statistics as the **cross entropy**. Finally, we note that just as in linear regression, \n", - "in practice we often supplement the cross-entropy with additional regularization terms, usually $L_1$ and $L_2$ regularization as we did for Ridge and Lasso regression.\n", - "\n", - "\n", - "The cross entropy is a convex function of the weights $\\boldsymbol{\\beta}$ and,\n", - "therefore, any local minimizer is a global minimizer. \n", - "\n", - "\n", - "Minimizing this\n", - "cost function with respect to the two parameters $\\beta_0$ and $\\beta_1$ we obtain" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial \\mathcal{C}(\\boldsymbol{\\beta})}{\\partial \\beta_0} = -\\sum_{i=1}^n \\left(y_i -\\frac{\\exp{(\\beta_0+\\beta_1x_i)}}{1+\\exp{(\\beta_0+\\beta_1x_i)}}\\right),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial \\mathcal{C}(\\boldsymbol{\\beta})}{\\partial \\beta_1} = -\\sum_{i=1}^n \\left(y_ix_i -x_i\\frac{\\exp{(\\beta_0+\\beta_1x_i)}}{1+\\exp{(\\beta_0+\\beta_1x_i)}}\\right).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Let us now define a vector $\\boldsymbol{y}$ with $n$ elements $y_i$, an\n", - "$n\\times p$ matrix $\\boldsymbol{X}$ which contains the $x_i$ values and a\n", - "vector $\\boldsymbol{p}$ of fitted probabilities $p(y_i\\vert x_i,\\boldsymbol{\\beta})$. We can rewrite in a more compact form the first\n", - "derivative of cost function as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial \\mathcal{C}(\\boldsymbol{\\beta})}{\\partial \\boldsymbol{\\beta}} = -\\boldsymbol{X}^T\\left(\\boldsymbol{y}-\\boldsymbol{p}\\right).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "If we in addition define a diagonal matrix $\\boldsymbol{W}$ with elements \n", - "$p(y_i\\vert x_i,\\boldsymbol{\\beta})(1-p(y_i\\vert x_i,\\boldsymbol{\\beta})$, we can obtain a compact expression of the second derivative as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial^2 \\mathcal{C}(\\boldsymbol{\\beta})}{\\partial \\boldsymbol{\\beta}\\partial \\boldsymbol{\\beta}^T} = \\boldsymbol{X}^T\\boldsymbol{W}\\boldsymbol{X}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Within a binary classification problem, we can easily expand our model to include multiple predictors. Our ratio between likelihoods is then with $p$ predictors" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\log{ \\frac{p(\\boldsymbol{\\beta}\\boldsymbol{x})}{1-p(\\boldsymbol{\\beta}\\boldsymbol{x})}} = \\beta_0+\\beta_1x_1+\\beta_2x_2+\\dots+\\beta_px_p.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Here we defined $\\boldsymbol{x}=[1,x_1,x_2,\\dots,x_p]$ and $\\boldsymbol{\\beta}=[\\beta_0, \\beta_1, \\dots, \\beta_p]$ leading to" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(\\boldsymbol{\\beta}\\boldsymbol{x})=\\frac{ \\exp{(\\beta_0+\\beta_1x_1+\\beta_2x_2+\\dots+\\beta_px_p)}}{1+\\exp{(\\beta_0+\\beta_1x_1+\\beta_2x_2+\\dots+\\beta_px_p)}}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Till now we have mainly focused on two classes, the so-called binary\n", - "system. Suppose we wish to extend to $K$ classes. Let us for the sake\n", - "of simplicity assume we have only two predictors. We have then following model" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\log{\\frac{p(C=1\\vert x)}{p(K\\vert x)}} = \\beta_{10}+\\beta_{11}x_1,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\log{\\frac{p(C=2\\vert x)}{p(K\\vert x)}} = \\beta_{20}+\\beta_{21}x_1,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and so on till the class $C=K-1$ class" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\log{\\frac{p(C=K-1\\vert x)}{p(K\\vert x)}} = \\beta_{(K-1)0}+\\beta_{(K-1)1}x_1,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and the model is specified in term of $K-1$ so-called log-odds or\n", - "**logit** transformations.\n", - "\n", - "\n", - "\n", - "In our discussion of neural networks we will encounter the above again\n", - "in terms of a slightly modified function, the so-called **Softmax** function.\n", - "\n", - "The softmax function is used in various multiclass classification\n", - "methods, such as multinomial logistic regression (also known as\n", - "softmax regression), multiclass linear discriminant analysis, naive\n", - "Bayes classifiers, and artificial neural networks. Specifically, in\n", - "multinomial logistic regression and linear discriminant analysis, the\n", - "input to the function is the result of $K$ distinct linear functions,\n", - "and the predicted probability for the $k$-th class given a sample\n", - "vector $\\boldsymbol{x}$ and a weighting vector $\\boldsymbol{\\beta}$ is (with two\n", - "predictors):" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(C=k\\vert \\mathbf {x} )=\\frac{\\exp{(\\beta_{k0}+\\beta_{k1}x_1)}}{1+\\sum_{l=1}^{K-1}\\exp{(\\beta_{l0}+\\beta_{l1}x_1)}}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "It is easy to extend to more predictors. The final class is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(C=K\\vert \\mathbf {x} )=\\frac{1}{1+\\sum_{l=1}^{K-1}\\exp{(\\beta_{l0}+\\beta_{l1}x_1)}},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and they sum to one. Our earlier discussions were all specialized to\n", - "the case with two classes only. It is easy to see from the above that\n", - "what we derived earlier is compatible with these equations.\n", - "\n", - "To find the optimal parameters we would typically use a gradient\n", - "descent method. Newton's method and gradient descent methods are\n", - "discussed in the material on [optimization\n", - "methods](https://compphysics.github.io/MachineLearning/doc/pub/Splines/html/Splines-bs.html).\n", - "\n", - "## Wisconsin Cancer Data\n", - "\n", - "We show here how we can use a simple regression case on the breast\n", - "cancer data using Logistic regression as our algorithm for\n", - "classification." - ] - }, - { - "cell_type": "code", - "execution_count": 4, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "(426, 30)\n", - "(143, 30)\n", - "Test set accuracy with Logistic Regression: 0.94\n", - "Test set accuracy Logistic Regression with scaled data: 0.96\n" - ] - }, - { - "name": "stderr", - "output_type": "stream", - "text": [ - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/linear_model/_logistic.py:762: ConvergenceWarning: lbfgs failed to converge (status=1):\n", - "STOP: TOTAL NO. of ITERATIONS REACHED LIMIT.\n", - "\n", - "Increase the number of iterations (max_iter) or scale the data as shown in:\n", - " https://scikit-learn.org/stable/modules/preprocessing.html\n", - "Please also refer to the documentation for alternative solver options:\n", - " https://scikit-learn.org/stable/modules/linear_model.html#logistic-regression\n", - " n_iter_i = _check_optimize_result(\n" - ] - } - ], - "source": [ - "import matplotlib.pyplot as plt\n", - "import numpy as np\n", - "from sklearn.model_selection import train_test_split \n", - "from sklearn.datasets import load_breast_cancer\n", - "from sklearn.linear_model import LogisticRegression\n", - "\n", - "# Load the data\n", - "cancer = load_breast_cancer()\n", - "\n", - "X_train, X_test, y_train, y_test = train_test_split(cancer.data,cancer.target,random_state=0)\n", - "print(X_train.shape)\n", - "print(X_test.shape)\n", - "# Logistic Regression\n", - "logreg = LogisticRegression(solver='lbfgs')\n", - "logreg.fit(X_train, y_train)\n", - "print(\"Test set accuracy with Logistic Regression: {:.2f}\".format(logreg.score(X_test,y_test)))\n", - "#now scale the data\n", - "from sklearn.preprocessing import StandardScaler\n", - "scaler = StandardScaler()\n", - "scaler.fit(X_train)\n", - "X_train_scaled = scaler.transform(X_train)\n", - "X_test_scaled = scaler.transform(X_test)\n", - "# Logistic Regression\n", - "logreg.fit(X_train_scaled, y_train)\n", - "print(\"Test set accuracy Logistic Regression with scaled data: {:.2f}\".format(logreg.score(X_test_scaled,y_test)))" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In addition to the above scores, we could also study the covariance (and the correlation matrix).\n", - "We use **Pandas** to compute the correlation matrix." - ] - }, - { - "cell_type": "code", - "execution_count": 5, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "data": { - "image/png": "iVBORw0KGgoAAAANSUhEUgAAAscAAAWYCAYAAABaiWuCAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjMuMywgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/Il7ecAAAACXBIWXMAAAsTAAALEwEAmpwYAAEAAElEQVR4nOzdd1gU1/oH8C8sVUApYq+oYEU09t6SaIyNm9gxlgQbGmPXqFgSFWMLtkBijInk3hQFa6LGG8tVwSQKimIFBAuIFJG+wPn9wTI/URYX2Arfz/P4PO7u7Mx7zg7vvHvmzKyREEKAiIiIiIhgrOsAiIiIiIj0BYtjIiIiIiIFFsdERERERAosjomIiIiIFFgcExEREREpsDgmIiIiIlJgcUz0Grt27UL37t2xbds26bkhQ4bg/v37OoyKiIiINIHFMdFrTJ8+HT179izyXEBAABo2bKijiIiI9M+2bduwePFitayrX79+CAkJUcu6iEqLxTFRGVStWlXXIRAREZEGmOg6AKo4fvrpJ/j5+aFt27awsbHB5cuX0bx5c3h5eWHz5s2IiIjAxIkTMW7cOACAXC7H5s2bceXKFRgZGaF79+6YOXMmjIyMcOfOHXzxxReQy+XIyMiAu7s7Ro0aBQDw8vLCmTNnMGvWLISGhuLOnTtF1vuiq1evYvny5Xj+/DnGjh2LM2fO4K+//sLNmzexfft2XLp0CQBgaWmJ1atXo2bNmgCAmJgYLF68GHl5eXByckJWVpa0zvXr1+PXX3/F0qVL0a9fP3h6eiIsLAy3bt1CbGwsvLy88Pz5c/z3v/8FAPzxxx/4+uuvYWFhAWNjY8yePRvt2rXT6GdBRBWXPubaY8eOITAwENnZ2fDw8EC3bt0wffp0xMTEYOXKlcjJyUF+fj7mz5+P9u3bY/369fjxxx9Ru3ZtHDhwALNnz8adO3cwd+5chISEICEhAWvXrkXVqlWxaNEirF69WmmeffToEebMmYOwsDCsW7cOR44cwaVLl/D777/D0tIS3t7eSE5ORl5eHj788EMMGDBAq58XGSBBpEa+vr6iV69eIjU1VWRnZ4uuXbuKZcuWifz8fBEeHi7c3NyEXC4XQgixc+dO4eHhIXJzc0VOTo4YNWqUCAoKEkIIERoaKkJDQ4UQQuTk5IiBAweKqKgoaTt9+/YV3t7eQgghwsLCiqz3ZcHBwaJVq1bi/PnzQggh1q9fL4QQ4vvvvxf5+flCCCH2798v5s+fL73nvffeE1999ZUQQoi4uDjRsWNH4evrK70+fvx4sX//fiGEELGxscLZ2bnI9vr27Ss97tKli0hISBBCCHHy5Mki6yEiKgt9zLW+vr5i0aJF0mO5XC4GDhwofvnlFyGEEBEREaJTp07i+fPnQggh/Pz8hLu7u8jNzRXr1q0TERERRbYbHBwsPX5dni18PTAwUAghxLfffivi4+PFxIkTxdatW4UQQsTHx4tOnTqJ2NhY1TuaKiVOqyC1c3V1hY2NDczMzNCwYUM4OzvDyMgILi4uyMjIQGJiIgAgMDAQI0aMgEwmg6mpKQYOHIhDhw4BABo2bIhff/0Vo0ePxuTJk5GQkIAbN24U2U7hPOCX11scS0tLdOvWDQCwaNEiAEDt2rUxYcIEjBs3Dnv37sX169cBAA8fPsTVq1cxdOhQAEDNmjXRvn37MvdHtWrV8PPPPyM1NVUaaSYiKi99zLUvCgsLQ2xsLIYNGwYAaN68OWrWrInTp08DAKZMmQIAmDdvHqytrdG8efNy90n//v0BAJMmTYIQAhcuXMB7770HAKhRowbat2+Po0ePlns7VLFxWgWpnZWVlfR/ExMT6bGJScHuJpfLAQBxcXHYs2cPDhw4AABIT0+X5vKuX78eqampCAgIgEwmg4eHR5GpDQBgbW0NADA3Ny+y3uLY2NgUeRwdHY05c+bgxx9/hKurK0JCQrBkyRIAQEJCAgDAzs5OWt7W1rYUPVDUnj178NVXX2HQoEF44403sGDBAtSvX7/M6yMiAvQz174oPj4eADB58mTpuZycHDx//hwAIJPJsGTJEowbN04q1svrxVwfFxcHoGBAxMjICACQnJwMZ2dntWyLKi4Wx6QztWvXxvTp0zFo0CAAQH5+PlJTUwEUzBUeO3YsZDIZANWTsapu3LgBKysruLq6AgByc3Ol1xwdHQEASUlJqFOnDgAgJSUFdevWLXZdpqamAAqSvpmZmZT4C8lkMqxatQpLliyBj48PlixZgn379qm1PUREyugq19aqVQumpqb44YcfpOcyMjJgbPz/J60PHz6M999/H97e3vjxxx+LvPai1+VZZdsHAF9fX9jb2wMAsrOzi+R7ouKoNK3i5s2bmo6DKqERI0bgyJEjyMvLA1Bw6u+rr74CADRo0ABhYWEAgCdPnuDWrVtq3XbDhg2RmpqKqKgoAMC5c+ek1+rWrQtXV1ccPHgQQMHoR+GFe8VxcHCApaUlbt++DQA4e/ZskdenTZuGvLw8WFhYwNXVVWovEZE2aCvXWllZITMzE0IIzJw5E23btkXt2rVx4sQJAAWDEDNnzkR0dDQA4MyZM2jcuDG8vb2RmZmJ77//vsi6srKyEBwcjL179742zxanZs2a6N69u5TLAcDb25u3iKPXMhJCiNctNGTIEMybNw99+vTRQkhkqA4fPowtW7YgOzsbM2fORFJSEr777jtUr14d69atw+7du3Hy5Em0bdsW/v7+sLKywpdffolLly7B3NwctWrVwurVq2FpaYl79+5hwYIFMDU1hZOTE8LDwyGXy+Ht7Y3AwED89ttvcHJywvbt2+Hj41NkvS9Ogbh79y7mzZuHyMhIuLm5Ydu2bdLrW7duxaFDh+Di4gJHR0cEBgZi0KBB2LBhA2JiYrBo0SLk5eWhXr16yMnJwY0bNzB16lRERUXh119/RfXq1bF48WL06dMH+/btw969e9G0aVO0b98evr6+6Nu3L3x9fbFu3TqEhYXB1NQUeXl5WLFihVrm1hFR5aSPuRYA7t+/jxkzZsDa2hpvvvkmPvzwQ8TExGDVqlXIzs5Gfn4+3N3d8d577+Gbb77B119/jSFDhmDq1KkYN24c4uPjMXLkSHz66afYt28ffvzxR1hbW+Pzzz9Hs2bNlObZ1atXS3cN6tSpE7y9vdG0aVMAQGJiIlatWoWnT58CAHr16oVp06Zp+yMjA6NScbxjxw40bNgQp0+fhouLC957770i8zGJiIiIiCoClYrjF124cAGLFi1C165dMW7cOLRt21ZTsRERERERaZVKxXFAQADatGmDgIAAnD59Gm+99Rbc3d1x9epVxMbGYtmyZdqIlYiIiIhIo1Qqjt3c3FC7dm2MHj0a7u7u0q1ShBDw8vLCjh07NB4oEREREZGmqXQrt/fee6/Y0eFHjx6hY8eOag+KiIiIiEgXVBo5/uuvv3D79m3p99R/+eUXDBkyBBYWFsUun5Dw+vsPGjo7uypITs7QdRh6iX1TPPZL8SpTvzg62rx+oTJSV96tKJ9HRWkHUHHawnbol8rSjrLkXZXuc+zn54d69epJj2vUqIHPP/+81BurSExMZLoOQW+xb4rHfike+0W/VJTPo6K0A6g4bWE79AvbUcI6VVnIxcUFvXv3lh737t0bwcHBag+msjkaeaLY5wc7vaXlSIiIKg/mXiIqiUrFcVxcHHJzc4v8Xnvhb6aT+ilL3MowoRMRERGph0rFcf/+/dG/f3+0aNECQMHPSS9cuFCjgREREelaaUeZOSpNZPhUKo7feecduLi44OLFizAyMsLChQvh5OSk6diIiIiIiLRKpeIYAJo0aYImTZpIj3/44Qd4eHhoJCgiIiIiIl1QqTj+888/4efnh8TEROTn50MIgdTUVBbHeoKn8YiI9BvzNJHhUKk49vHxwfLly9GgQQMYGxtDCAF/f39Nx0ZEWhR0LlKt6xvek1OviIjI8Kh0n+NmzZqhe/fuqF+/PurWrYt69eph2rRpmo6NiCqw0NDL8PLyRN++fSGXy4u8tnOnL4YNG4jDh4OKfW9YWCgmTx6Hy5f/BgB8881X+N//zmg65CJ+/vlHrW6PlDsaeeKVfz+HH9F1WERkoFQaOa5duzaWLFmCdu3awczMDABw6NAhfPvttxoNjsqHp/FIn7m5tUe7dm/g77+DcfhwENzd3wcAJCcnISLiOqpXd8SQIcOLfW/btm5o0qSZ9HjKlKkwMjLSRtiSn3/+N0aOHKvVbRIRkeapVBz/9ttv6NGjB65cuSI9x/scE5E6zJw5EytWeOPdd4fBzMwMBw78ghEj3kdAwF4AgI/PZ6he3RGZmZlwcKiOMWPGF3l/XFwcvvzyCzRt6owpU6bi0aOH2Lp1I5o1c0aVKlXwww978PHH85Gfnw8/vx0YNswdcXGP8ejRQ2zYsAVWVtYIDPwVUVH3YG/vgLi4x5g/fwkyMjKwcuWnECIfDRs2xt27t/HWW4MwdOgInDp1Emlpz7F7tx8aNmyEAQPe1kXXERGRBqhUHM+YMQNjxowp8tzp06c1EQ9pAUeUSZ80a9YMrVu74tChA+jX700YGxvD1tZWer1btx7o2bMPAGDixLEYNmwEqlSxkl6vVasWevbsg8ePHwEomJLx9tuD0L//W3jwIBaBgb9i0KB3AQC//XYErVu7YsqUqdi0yQd//RWCPn36w9GxBoYNc4exsTG2bv0Cly4Fo1u3Hhg//gP4+e3AnDnzkZycjI8/noahQ0egf/83sWuXL6ZMmaq1fiIiIu1QqTgeM2YM7t+/j4cPH6Jz58548uQJ+vTpo+HQiKiymDTpI8ybNwvx8fEYN+4DREbelV5LTHwKP78dqFLFCunp6Xj27FmR4vhl0dGRqFdvEgCgTp26r7xev34DAICtrS0yMjIAABYWFti50xfVqtkiKioKzs7NX1nezs5OWp6otL9kSkSGQ6Xi+MCBA9i5cyfq1q2LDh06YN26dejfvz+GDRum6fiIqBJo3NgJbdu2g4mJSZFR4zt3biMg4Af88stBAMD582dfu65GjRojNvY+XFya49Gjh6+8Xtzc5GXLFuG77/6NWrVqISMj/bXLA5Du3HP37h00a+b82riIdEHZXWh4Nxki5VQqjv/++2+cOHECq1atgpmZGXx9fbFq1SoWx0QViLYPljdv3kBY2BUYGeVhwgRPeHt/BgBITk7G8ePHkJj4FFFR99CoUSOsX78GDRo0QkLCExw9eggdO3bBvXt3cPz4MdSpUxfnz5/F8+fPERUVienTZ2PLlg24d+8uatasKRW3f/0VjPj4OBw9egiDBr2LsLAriIy8i65de2D48H9h82YfuLq2RXj4VcTERKNLl244fvwY7t27g5s3byAy8h7S0tJw+vQp9OnTH9269cD27VsBgMVxGXGKl3IvFrVWVuZIT88GwKKWSBtUKo4dHR1hbFz0rm8vPyYiKo3mzVvC1/crODraICHhufS8nZ0dlixZIT1+661B0v/Hjv3/Hx769tsA6f+ff/6F9P/Y2Bh4e38OGxsbxMXF4c8//wsA6NixC3755ZC0nK/vV9L/p03zkv4/fvxE6f8vxtG8eUu8884Q6fGcOQtUbywRERkMlYrjpKQkHD58GM+fP8fVq1dx/vx5pKSkaDi0ioNz04i0Jy7uMb777hs0adIUDx7EYtasT3QdEukIcy8RlYVKxfH8+fPx+eef48KFC7hw4QJ69eqFZcuWaTo2IqJS69ixMzp27KzrMEgDNF3sspgmIkDF4rhatWrYsGFDkedycnI0EhARERERka6oVBw/evTolee2bduGdevWqT0gIiKiykL5aHVTrcZBRP9PpeJ4yJAhsLW1hRACubm5SExMRM2aNTUdG+k5ZUl9ouO/tBwJERERkXqoVBwvWLAAo0ePlh4/efIEBw8e1FhQ+qQyFYC8rVLlpu75ltxviLRH2f2MS7s8bxVHpGJx/GJhDAA1atRAdHS0JuIhokrixo1w7NzpCyMjATe3DkhKSsSzZ8/g7f0ZTE1NS7Wu9PQ0LFo0F9u3+2soWiLtupf3l/R/00wTyPNyAQBB53QVEVHloVJxvGTJEun/QggkJCTwPsdEVC4tW7ZGu3ZvwMgoD5MnTwUAzJo1FSEhF9CjR+9SrcvKyhrbtvlpIkzSgYp414ibMckaXf+LxfSLmsg6lmo9HFEmUrE4jouLw9ChQwEU/JRq9erV0bkzb5VUWVTEAxXpn/z8fKSmPoOtrR3Cwq7g6NFDaNSoMWJi7mPatFl4/jwVa9eugoODA+ztHXD79i1MmDAZ3br1wG+/HcGXX27E77+fBgD88MN3iI6+hwYNGuHatTCYmpri44/nY8OGtRAiHw0bNsbdu7fx1luDMHToCN02nIiI9IpKxfGMGTPQsWPx3z7j4uJQq1YttQZlyFhIKscRCSrO1atX8cMP3+HOnVto2rQZnJ2bY+TIYfj6671wdKyBY8cO4/vvd2P27HkYMmQ4QkIuYu7cRYiIuI49e75Bt249MGjQu9i9u2DkODLyLo4fP4p9+34BAKxevRwdOnRCrVq1MX78B/Dz24E5c+YjOTkZH388jcUxEREVoVJx/P3338PIyAhCiFde27NnD3bu3Kn2wPTdz+FHkKH4rXsiVfELwqtcXV3h4TERAPDDD3uwbdsWpKam4vffjwEAnj9/BmNjmbR8gwYNAQC2tnbIyEh/ZX1RUVGoW7ee9LhOnbpFXq9fvwGAgp+pzsjIUGtbiDRN2fSJ0i5f2ukWRJWJSsVxbGwspk6dimbNmgEA7ty5g2bNmsHU1BT379/XaIBkeH48fhPp/OJAZeDgUB23bt2Era0thg1zR9WqVfHsWQrCw6+pvI5GjRrjwYNY6fGjRw+LFMhGRkZqjZmoMivNXTKsrMzxZvu6r1+QSMdUKo7d3Nywd+9eVKtWDQCQmpqK7du3Y+nSpfjPf/6j0QCp4lPXaGpx61G2jtJus7S3STLEkWBt33rt5s0bCAu7AiAfe/fuRl5eHiIj72LKlGlIS3uOXbu2oU6duoiPj8N7741CUlIizp8/i+fPn+PBg1gcP34M8fFx+PvvS0hKSkRaWhqCgn7F8OHv4a23BsHbeymaNnVGTk4OjIyMkJOTg+PHj+HevTu4efMGIiPvIS0tDadPn0KfPv212nYyHMoupGvewK5Uy+sbQxhR5pk20hWViuOsrCypMAaAqlWrIjExEcCrt3kzVJwrrFxpDw5EqmjevCV8fb+Co6MNEhKev/J6mzZtX3nu88+/kP4/ZcpUTJkyVXr81luDpP936tQFH3wwBQCwdu0q1KlTD2ZmZliyZEWR7b/zzhC1tIWIiCoOlYrjhIQEfPfdd9JFeZcuXUJKSoom4yIDoKxodq2q5UDUqLQjxJreLkdIyuaXX/6DBg0aIj8/H46ONdC2rZuuQ6IKxlBGiNVFXbmRuY4MgUrF8dq1a/H5559j165dAIAuXbpg7dq1Gg1MUzhCzJFgqvhWrFij6xDoBcy7FVdpp2cov6CQxTHpD5WK45o1a8LX11fTsZCOGcpISGlGMPRpJNjKylwHkRARVW7KvpzxJ+5JGZV+5i4xMRGLFi3CnDlzkJmZiRUrVuDZs2eajo2IiIiISKtUGjnesGEDOnTogEuXLsHS0hKjR4/GF198gc8++0zT8ZUZT+MZzkiwMroa9TUEnLdH9HqGngOJSDdUnlbx/vvvIzw8HADQsmVL2NjYaDQwMlwRmcGQ5+W+8rw+3SLIUOjTtBCAxXdlU9pBBp6mpkLFzS02zVSp5HitTad/KtXypb2ehtMwSKU9tfDOFIU3z8/IyEBsbGwJ71C/yrSzcrSDiAyRps/Y8WJizTOE+x+XlrL9ZrCS7/qlXZ4qHpWK4y5duuDdd99FTk4OPD09ER4ejmXLlmk6NpUYwvQJJvQCpf3ZU2UMOUkTERGRfjMSQghVFoyMjMTFixcBAF27doWTk/KvUMXd0F9VhlDsAkAVK3NkqPgTyZVtJNjU1ARy+avTKjStuKJZn0ZBrKzM9e5ntdX1i4Dl2Wbhj4Bo+lcI1dWm8kwtcXTU3HQ0deXdF3Obun4dTl0DAaVZfxUrc1yOiFPLdnVNVzlV3UpqR2lysroGWkqrcD97+fivbL9U1iZ1/XKrsukl8/qMKvb5lyn7ASZdKsuUvte1oyx5V6XiuEuXLpg9ezbGjh1b6g0QERERERkKlW7l5uzs/EphnJSUpJGAiIiIiIh0RaXi+J133sGZM2cgl8ul53bu3KmxoIiIiIiIdEGlaRXNmzf//zcYGUEIASMjI0RERGg0OCIiIiIibSrxbhWPHj2CiYkJ+vfvjx07dhR57csvv9RoYERERERE2lbiyPG//vUvvPfee+jduzcAwMLCAvb29loLjoiIiIhIm0qcc9y6dWuMGTMGBw4cwNSpU3Hu3DltxUVEREREpHUlFseFv4jn5eWFZs2aYdiwYdJrOTk5mo2MiIiIiEjLVP6h88JCudCGDRv05lfyNC0hIQFbt27FzZs3sX//fgBAdnY2fHx8ULNmTURHR8PT0xONGzfWcaTaV1zfHDhwAP/5z39gbm4OoGB6zvDhw3UYpXbFxMRg69ataNmyJeLi4mBrawsvLy+kpKRg06ZNqF+/PqKjozF37lxUr15d1+FqjbJ+2bZtGy5duiQtN23aNHTv3l2HkVYeFSW3VZQ8VFFyR0X5W8/Pz8e0adPg6uoKuVyO2NhYrF27FllZWQb1eShrx9dff21Qn0ehrKwsvP/+++jRowcWLVqkkZxVYnF88uRJ3Lx5EwAQHR2N0aNHS689ePCg0hTH//zzD/r371/k7hx79+5F7dq18dFHH+HWrVv49NNP8eOPP+owSt0orm8AYPPmzahXr56OotKtlJQUvPPOOxgwYACAglsh9unTBz///DO6du2Kd955B//973/h4+ODL774QsfRao+yfgGAH374QYeRVV4VJbdVlDxUUXJHRfpbd3Nzw4wZMwAA06dPx4kTJ/D3338b1OcBFN8OwPA+DwDSF69CmshZJRbHTZo0wYgRI4p97dChQ+XasCEZOHAgQkJCijx3+vRpzJ07FwDg4uKCmzdvIi0tDdbW1roIUWeK6xsACAgIQPXq1ZGZmYnx48fD1tZW+8HpiKura5HH+fn5sLS0xJkzZzB9+nQAQPv27bF48WJdhKczyvoFAHbt2gUzMzPk5eXBw8NDep40q6LktoqShypK7qgof+vGxsZSQZmbm4v4+Hg0btwYmzZtMqjPQ1k77t+/b1CfBwAEBQWhffv2uHXrFjIyMgBoJmeVWBzPmTMH7du3L/Y1fT/NpmmJiYmwsrKSHltbWyMxMVGvDyDa0rFjR/Tp0wf29vY4c+YMPv74Y+zdu1fXYenEyZMn0aNHDzRp0qTIPmNtbY1nz54hNzcXJiYqz26qMF7sl4EDB6Ju3bqoUqUKAgICsGbNGqxdu1bXIVZaFSW3GXoeqii5oyL8rZ87dw7fffcd+vTpgzZt2hjs5/FyOywsLAzq87h79y4iIyMxd+5c3Lp1S3peEzmrxAvylBXGQMEQfWXm4OCA9PR06XFaWhocHBx0GJH+qF+/vnTLvy5duuCvv/5CXl6ejqPSvuDgYISEhGDp0qUAiu4zaWlpqFatmt4nU014uV+aNWuGKlWqACjYX4KDg3UZXqVXUXKbIeehipI7Ksrfes+ePbF79248ePAAAQEBBvt5vNwOQ/s8Tp48CTMzM/j7++Off/7B1atX8d1332kkZ6n089H0qj59+uDKlSsAgFu3bqF58+YGN7KiKZs2bUJubi6AgrnqdevWhUwm03FU2nX69Gn873//w6effoqEhARcuXIFvXv3lvaZy5cvS/cPr0yK6xcfHx/p9fv376NBgwY6jJAqSm4z1DxUUXJHRfhbv3v3Lk6fPi09rlevHh48eGBwn4eydhja5zF9+nR4eXnB09MTb7zxBlxdXTFx4kSN5CyVfj66srt06RKCgoJw7tw5jBkzBpMnTwYA+Pj4wNHRETExMZg6dWqlnGpSXN/89NNPuHPnDurVq4fbt29jwoQJlepMQ3h4ODw8PNC6dWsAQEZGBsaNG4d+/fph48aNqFOnDmJjYzFv3jy9vsJZ3ZT1S1RUFDIzM+Hg4IDbt29j9uzZlfJvSRcqSm6rKHmoouSOivK3HhMTgw0bNqBly5bIzc3FvXv3sGzZMpiamhrU56GsHd9//71BfR6Fjh8/joCAAMjlcowbNw4DBgxQe85icUxEREREpMBpFURERERECiyOiYiIiIgUWBwTERERESmwOCYiIiIiUmBxTERERESkwOKYJP/88w88PDzQrVs3rFixQvrn7u6OBw8elGmdHh4exf6sa0XzySef4OzZswCAkJAQeHh4lHodcXFxmDZtWpneS0REROqh/z/pQlrzxhtvYMSIEfjPf/6D1atXS88HBATA1NRUh5Hpv8WLF8POzq5c66hVqxYmTZqE7du3qykqIiIiKi0Wx1Sibdu2YcSIEahZsyaOHTuGCxcuwNbWFvHx8Vi4cCEcHR1x9OhR/PHHH6hbty4ePXqEGTNmoGnTpjh48CCio6Px/fff4/jx4xg2bBi2bNmCWrVqYf369fj3v/+NL774AocOHYK9vT2mTJmC+Ph4uLu749y5c8jOzkZQUBC+//57REdHw9zcHM+fP8eSJUuK/I46APj6+uKHH37AhAkTcOPGDURHR2PlypX47bffcPXqVbi4uGDdunUAoDReAPj999+xd+9euLi4wNTUFPv374enpyecnJzg4+ODzp07IzMzExEREfjggw8w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k0/g6OiIWrVqoUGDBkX60traGs+ePUNubq5OT6Uo+3yTkpKKPG9lZaXTPgWAnJwcBAYGwtvbGwD0KsYtW7ZgxowZUhFcSFn/6sKjR4+QlpYGLy8vREVF4cMPP8SxY8eQlJQEJyenIjEWFqjaNmnSJMycORPr1q3D1atXMWPGDAD69VlT8T766CO4uroiLy8P48aNkz6j4nKePu1z6lTafJqcnKxXx67y6NixI/r06QN7e3ucOXMGH3/8Mfbu3Vth237y5En06NEDTZo0KfV+rk/HhbJ4se0DBw5E3bp1UaVKFQQEBGDNmjVYu3at1tuusSrq5MmTMDMzg7+/P/755x/I5XJ89913cHBwQHp6urRcWloaHBwcNBXGa1lZWcHJyQk2NjYAgDfeeAN///03srKyIISAkZGRzmOMiIjA7t27ERgYCBMTE6xfvx47duyQ+rJq1apIS0tDtWrVdD7HSNnna29vj/v370vPp6eno0GDBroIEUBBYbxy5Up88sknUhz6EuPjx4+RmpqK3377TXpuz5496N27t179/VhbW6Nt27YAgMaNGyMtLQ2PHz+Gvb39KzHa29vrJMbFixfj/fffx7vvvoukpCS89dZb+OOPP/TmsyblXF1dAQAymQwdOnRASEiI0pynT/ucOpU2n9rZ2enVsas86tevL/2/S5cumD59OvLy8ipk24ODgxESEoKlS5cCQKn3c306LpTWy21v1qyZ9FqXLl2we/duANB62zU2rWL69Onw8vKCp6cn3njjDbi6umLixIno06cPrly5AgC4desWmjdvrrNRYwBo27YtUlJSkJeXB6BgNKxZs2bo3Lkzrl27BgC4fPkyevfurbMY4+PjYWtrKxW+jo6OyMnJQe/evaW+1HWMhZR9vj179sT169chhAAAXLlyBb169dJJjJmZmfD29sakSZPQunVrHD9+HAD0JsbatWtj/fr18PT0hKenJ4CCEdA2bdrAzc0Njx49Qk5ODoCCz71Pnz5ajxEAunbtitjYWAAFCSkvLw+Ojo7o06cPQkNDAQByuRyRkZHo2LGjTmJ8/PixdLqtatWqMDY2Rn5+vt581lS8e/fu4ZdffpEe379/H/Xr11ea8/Rpn1On0uZTU1NTvTp2lcemTZuQm5sLAIiOjkbdunUhk8kqXNtPnz6N//3vf/j000+RkJCAK1eulHo/r1+/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+5fwND23uG3Tunrdrin78dDVEvfFPI+uvuXkt6hkjkymODamh7wTEVHl4+eA7qwL26N2+ly3dys5EiLjYzLFsbHR9BVZ8dMtyoJ/WRMRkTraDsNwwWt6iuQxXT1yjj3NZApYHOuYNgltXZj6eTV9dai882KJ18WPl2NSISJTxJ5g06HvR86pG6pjKj9fTuaHxbER0vyBUTI5Fd8kqKm3WlMyK2vxXUxT8a3uazm53AotG9RUOz8TnenQNKa0Kh1D7gPdjS1mEax/Vx5FlrhpvLx01UOs6dyJK9QwnhzPfi49GcuTvzWgbYeQplg0febJG91QO11X1766ffz0byk8qSp1gBlL3rUQQohK3SIRERERkZGyNHQARERERETGgsUxEREREZEKi2MiIiIiIhUWx0REREREKiyOiYiIiIhUWBwTEREREalU6nOOT506hcOHD8PBwQEWFhbw8vIq8X5eXh78/Pzg7OyMmzdvwtPTE82bNwcAhISE4MqVK7C0tETTpk3x3nvvGTymfv36oVGjRgCAevXqYd26dZUSEwD89ttvWL9+PRYtWoS+fftqtawh4nrnnXdgY2MDALC0tMTOnTsrJabAwECkpqbCyckJsbGxmD17Nlq2bAlAf+dUReMy1Hn122+/4dixY2jbti0uX76MkSNHol+/fgAMu69Ki8uQ1yAA/Prrr/j0009x4cIF2NraarVsZTHGvKtLFWnfrVu34OfnBysrK2zatMkQ4T9XedsXExODnTt3on379khISICLiwveeecdA7VCs/K2T6FQwMfHB926dYNCoYBSqcSSJUtgaWl8fX4VOUcBQKFQYOTIkZg2bRrc3d0rO/znMsY6qsJEJcnJyREDBgwQeXl5QgghvLy8xKlTp0rMs3XrVhEYGCiEEOLq1ati7NixQggh/v33XzF8+HBRVFQkhBBi9OjRIiEhwaAxCSHEpk2bKhxDeWJKTEwUp0+fFu7u7uL48eNaLWuIuIQw3L7asGGDdN4cPHhQTJs2TQihv3OqonEJYbh9tW/fPnHnzh0hhBB///23+M9//iOEMPy+0hSXEIbbV0IIcePGDbF+/XrRunVrkZWVpdWylcUY864uVTSHh4SEiN27d4tZs2ZVXtBaqEj7jh49KqKjo4UQQuTn54uXXnpJKBSKSoz++SrSvuTkZLFnzx5pvmHDholz585VUuRlV9FztLCwUCxevFhMnz5dfP/995UXeBkZYx2lC5X2J9alS5fQsGFDWFtbAwC6du2KsLCwEvOEhYWhS5cuAIA2bdrg6tWryMrKQkREBDp06AALCwsAQJcuXfDnn38aNCYAOHfuHLZt24aNGzfiwoULFY6nrDE1adIEr7zySrmWNURcAHD9+nUEBgbC39+/UmP6+OOPpfOmqKgINWrUAAC9nVMVjQsw3Hk1evRoNGzYEMDjHrXinmxD7ytNcQGG21ePHj3C119/jQ8//FDrZSuTMeZdXapoDh8+fDjkcnmlxqyNirSvf//+cHFxkeaTyWRG19aKtM/Z2VnqCc/KykJOTo7UA2lMKnqObtu2DW+99RZq165dqXGXlTHWUbpQacMqFAqF9LUjANjZ2UGhUJRpnrS0tBLTbW1tn1m2smOys7PD3Llz4eLigkePHmHUqFHYunUrXnjhBb3HpI9l9b3uqVOnwsXFBYWFhRg3bhxsbW3x8ssvV1pM+fn5CAoKwrJlywBAb+dUReMCYNDzKjc3F/7+/oiKisLatWsBGMe+UhcXYLh9tWHDBsycOVP6QNC2PZXFGPOuLlU0hxs7XbVv165dmD59OmrWrKn/oLWgi/YdPHgQP/30E6ZMmYL69etXTuBaqEgbL1++jGrVqqFz58746aefKi1mbRhjHaULldZz7ODggOzsbOl1VlYWHBwcyjSPvb19ienZ2dnPLFvZMQGQ/iqvXr062rVrp5O/esoSkz6W1fe6i/eVTCbDSy+9hDNnzlRaTPn5+Vi+fDk++eQTNG3aFAD0dk5VNC7AsOdVtWrV8Omnn2Lt2rUYP348lEqlUewrdXEBhtlX//77LzIzM/H7778jMDAQALBjxw5cvnxZr9dgeRhj3tWliuZwY6eL9h04cAA5OTn44IMP9B6vtnTRviFDhuC7777DwYMHER4erv+gtVSRNh4/fhx5eXkIDAzE9evXcfLkSezbt6/SYi8LY6yjdKHSimNXV1fcvXsX+fn5AIALFy7Azc0NGRkZUve6m5sbLl68CAC4du0a2rZtCzs7O/Tu3Rt///03hBAAgIsXL+L11183aEynT58u8RXjrVu30KRJk0qJSdtldaEiccXFxeHnn3+WXlfmvnr06BGWLVuGiRMnomPHjjh06BAA6O2cqmhchjyvtm/fLu2P+vXrIz09HXl5eQbfV5riMtS+atCgAVavXg1PT094enoCACZOnIhOnTrp9RosD2PMu7pUkfaZgoq27+eff4ZCocDMmTNx7do1JCQkGKYhGlSkfVFRUYiJiQHw+Cbvhg0bIikpyTANKUVF2rho0SIpz7Ru3Rq9evXCmDFjDNYWdYyxjtIFC1Gc+SrByZMncejQIdStWxdyuRxeXl5Ys2YN6tSpA09PT+Tm5sLPzw9OTk5ITEzEtGnTStw1HRsbC5lMhmbNmunsrunyxnTt2jUEBASgQ4cOuHfvHurVq4fp06dXSkxCCGzZsgW//PILunXrhuHDh6N3794al9WV8saVkpKCFStWoF27dsjKykJBQQF8fHx0clfx82Ly8vLCP//8g3r16gEAcnJypL+89XVOVSQuQ55XW7ZsQUpKCho2bIi4uDh07doV7777LgDD7itNcRlyXwGPh5vs3r0b//3vfzFz5ky89957cHZ21us1qI+2GCLv6lJF2nf06FGEhIQgISEBI0aMwNSpUw3cmmeVt31Hjx6Ft7c32rdvDwDIyMjA4sWL0aNHDwO3qKTyti86Ohrbt29H+/btkZ2djZSUFCxfvrzE/RvGoiLnKAD88ssv2LVrF5ydnTF27Fj06dPHgK15ljHWURVVqcUxEREREZExM74HAhIRERERGQiLYyIiIiIiFRbHREREREQqLI6JiIiIiFRYHBMRERERqbA4JiIiIiJSYXFMRERERKTC4piIiIiISIXFMRERERGRCotjIiIiIiIVFsdERERERCosjomIiIiIVFgcExERERGpsDgmIiIiIlJhcUxEREREpMLimIiIiIhIhcUxEREREZEKi2MiIiIiIhUWx0REREREKiyOiYiIiIhUWBwTEREREamwOCYiIiIiUmFxTERERESkwuKYiIiIiEiFxTERERERkQqLYyIiIiIiFRbHRERE5ZSTkwNPT0+89957GDFiBO7cuWOwWAICAtCrVy/4+/s/d97CwkJ4eHigTZs2uH37NgDg3LlzmDRpkr7DLLPbt29j8ODBhg6DqiAWx2R2nkz2RET6dPDgQRQUFGD37t34+OOPYWmp24/VBQsWlKnYBQAvLy/07t27TPPKZDJ8//33JaZ169YN//3vf7WOUV8aN26M3bt3GzoMqoKsDB0AERGRqUpJSUG9evUAAH379jVwNBVjYWGBmjVrGjqMEmrVqmXoEKgK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DpautpOlpSWSkpKwf/9++Pv7S8tqYzslJibCx8cHHTt2BFD+HY0fPx4DBw5UuJ99++23yM3NxYMHD9CvXz+134VBUaZdu3ahtLRUGjG2trbGli1bcOLECezZswft27fHrVu30K1btwrztjWZ6caNGwr3fU1vJ1UdO3YMkZGRsLe3h5mZmVbuVlGdflwT201dfebt27exefNmNGvWDHfv3kVAQEC1r6BXV/+krkzq7AuSkpKwa9cuNG7cGA8ePKjWnQ/Uuc+pIw9QfgeNlStXokOHDigtLcW1a9fw6aefwszMTCfbSFGenTt36mwbAUBkZCR2796NkpISjB8/HoMHD9bpvqYJOiuOiYiIiIj0DX8EhIiIiIhIjsUxEREREZEci2MiIiIiIjkWx0REREREciyOiYiIiIjkWBwTEREREcmxOCYiIiIikmNxTEREREQkx+KYiIiIiEiOxTERERERkRyLYyIiIiIiORbHRERERERyLI6JiIiIiORYHBMRERERybE4JiIiIiKSY3FMRERERCTH4piIiIiISI7FMRERERGRHItjIiIiIiI5FsdERERERHIsjomIiIiI5FgcExERERHJsTgmIiIiIpJjcUxEREREJMfimIiIiIhIjsUxEREREZEci2MiFX322Wfo3r079u3bp+soREREpGYsjkmn9u3bBx8fH13HeC4fH58KhfBnn32G9u3b6zAREZHyDKGfrYmn+2iimmJxTEREREQkZySEELoOQboXEBCA0NBQdO/eHTt37kRKSgq8vb0RExOD+/fvY8qUKSguLsYPP/wAc3NzLFu2DDdu3IBMJsOgQYMwZcoUlJSUYPLkyYiLi8OiRYsQHR2NU6dOYcuWLbh58yZCQkJgZWUFS0tLzJs3D5mZmVi0aBEyMjLQvn17tGnTBgsXLqyQSyaTYcmSJbh8+TKMjY3RokULLFiwACdOnMCqVatQv359uLq6IjY2Fvb29vj888+xbt06JCQkYOjQoZgzZw4AQAiBbdu24ffff4eJiYm0HhsbGwDAn3/+ia+++gomJiawtLTEwoUL0aJFC6xZswY//vgj6tevDycnJ0yePBkeHh7w8fFBt27dcP36dVy6dAlDhw7F3LlzUVxcXGEbREVF4caNG/D398eQIUMAAI8ePcIXX3yBmzdvQgiBkSNHwsvLCwDwxx9/4JtvvoGlpSWM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ybE4JiIiIiKSY3FMRERERCTH4piIiIiISI7FMRERERGRHItjIiIiIiI5FsdERERERHIsjomIiIiI5FgcExERERHJsTgmIiIiIpJjcUxEREREJMfimIiIiIhIjsUxEREREZEci2MiIiIiIjkWx0REREREciyOiYiIiIjkWBwTEREREcmxOCYiIiIikmNxTEREREQkx+KYiIiIiEiOxTGRFkRERGDBggW6jkFERE9g30yVMRJCCF2HIKrMvn37EBoail27duk6So2VlZWhsLAQ1tbWAICAgAA0adIEM2fO1HEyIqotalOfqS1P981VGThwIIKCgvDKK69oOBnpEkeOibTAxMRE6c6XiIi0g30zVYYjx1SlgIAAhIaGonv37ti5cydSUlLg7e2NmJgY3L9/H1OmTEFxcTF++OEHmJubY9myZbhx4wZkMhkGDRqEKVOmoKSkBJMnT0ZcXBwWLVqE6OhonDp1Clu2bMHNmzcREhICKysrWFpaYt68ecjMzMSiRYuQkZGB9u3bo02bNli4cOEz2ZKTk7F06VIUFhaipKQEvXv3xqxZswAAf/75J7766iuYmJjA0tISCxcuRIsWLbBnzx5s3boVnTt3hq2tLRISElC/fn1s2rQJFhYWAIBjx45h48aNMDMzg0wmg7e3N9544w1cuXIFq1atQklJCfLz8zFmzBi88847OHz4MD799FNYWVnh448/xptvvgkfHx9cv34d06ZNw969e/Hw4UMcOXIEO3bsQHBwMCwsLNCkSROMGDEC33zzDbKzs/Gf//wHc+bMwfLlyxEaGoopU6bg/fff1+r3TUQ1wz6zZn1mUFAQ3N3dsXbtWpw9exZGRkbo3bs3PvjgAxgZGVVoz/nz57Fw4UI8fPgQw4cPx99//40HDx5g3rx56Nu3LwAgIyMDS5YsQVZWFkpKSuDl5YXRo0fj0qVLmDdvntQ3Hz58GKtWrUL9+vXRuXNnnDp1CsbGxti8eTMcHR0RGBiIAwcOoFWrVqhbty78/f1hZWWFJUuWAABKS0vx73//G2PGjNHknxdpgyBSQr9+/cSZM2eEEEJs375dtG/fXiQkJAghhAgODpb+HRgYKPz9/YUQQhQUFAhPT08RGhoqradNmzZi48aNQgghIiIiRFxcnOjZs6coKioSQgjx3XffiZCQECGEECEhIcLb21thptLSUvHGG2+I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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter4_51_0.png" - } - }, - "output_type": "display_data" - }, - { - "data": { - "image/png": "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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter4_51_1.png" - } - }, - "output_type": "display_data" - } - ], - "source": [ - "import matplotlib.pyplot as plt\n", - "import numpy as np\n", - "from sklearn.model_selection import train_test_split \n", - "from sklearn.datasets import load_breast_cancer\n", - "from sklearn.linear_model import LogisticRegression\n", - "cancer = load_breast_cancer()\n", - "import pandas as pd\n", - "# Making a data frame\n", - "cancerpd = pd.DataFrame(cancer.data, columns=cancer.feature_names)\n", - "\n", - "fig, axes = plt.subplots(15,2,figsize=(10,20))\n", - "malignant = cancer.data[cancer.target == 0]\n", - "benign = cancer.data[cancer.target == 1]\n", - "ax = axes.ravel()\n", - "\n", - "for i in range(30):\n", - " _, bins = np.histogram(cancer.data[:,i], bins =50)\n", - " ax[i].hist(malignant[:,i], bins = bins, alpha = 0.5)\n", - " ax[i].hist(benign[:,i], bins = bins, alpha = 0.5)\n", - " ax[i].set_title(cancer.feature_names[i])\n", - " ax[i].set_yticks(())\n", - "ax[0].set_xlabel(\"Feature magnitude\")\n", - "ax[0].set_ylabel(\"Frequency\")\n", - "ax[0].legend([\"Malignant\", \"Benign\"], loc =\"best\")\n", - "fig.tight_layout()\n", - "plt.show()\n", - "\n", - "import seaborn as sns\n", - "correlation_matrix = cancerpd.corr().round(1)\n", - "# use the heatmap function from seaborn to plot the correlation matrix\n", - "# annot = True to print the values inside the square\n", - "plt.figure(figsize=(15,8))\n", - "sns.heatmap(data=correlation_matrix, annot=True)\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In the above example we note two things. In the first plot we display\n", - "the overlap of benign and malignant tumors as functions of the various\n", - "features in the Wisconsing breast cancer data set. We see that for\n", - "some of the features we can distinguish clearly the benign and\n", - "malignant cases while for other features we cannot. This can point to\n", - "us which features may be of greater interest when we wish to classify\n", - "a benign or not benign tumour.\n", - "\n", - "In the second figure we have computed the so-called correlation\n", - "matrix, which in our case with thirty features becomes a $30\\times 30$\n", - "matrix.\n", - "\n", - "We constructed this matrix using **pandas** via the statements" - ] - }, - { - "cell_type": "code", - "execution_count": 6, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "cancerpd = pd.DataFrame(cancer.data, columns=cancer.feature_names)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and then" - ] - }, - { - "cell_type": "code", - "execution_count": 7, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "correlation_matrix = cancerpd.corr().round(1)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Diagonalizing this matrix we can in turn say something about which\n", - "features are of relevance and which are not. This leads us to\n", - "the classical Principal Component Analysis (PCA) theorem with\n", - "applications. This will be discussed later this semester ([week 43](https://compphysics.github.io/MachineLearning/doc/pub/week43/html/week43-bs.html))." - ] - }, - { - "cell_type": "code", - "execution_count": 8, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "(426, 30)\n", - "(143, 30)\n", - "Test set accuracy with Logistic Regression: 0.94\n", - "Test set accuracy Logistic Regression with scaled data: 0.96\n", - "[1. 1. 1. 1. 1. 1.\n", - " 1. 1. 0.92857143 0.92857143]\n", - "Test set accuracy with Logistic Regression and scaled data: 0.96\n" - ] - }, - { - "name": "stderr", - "output_type": "stream", - "text": [ - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/linear_model/_logistic.py:762: ConvergenceWarning: lbfgs failed to converge (status=1):\n", - "STOP: TOTAL NO. of ITERATIONS REACHED LIMIT.\n", - "\n", - "Increase the number of iterations (max_iter) or scale the data as shown in:\n", - " https://scikit-learn.org/stable/modules/preprocessing.html\n", - "Please also refer to the documentation for alternative solver options:\n", - " https://scikit-learn.org/stable/modules/linear_model.html#logistic-regression\n", - " n_iter_i = _check_optimize_result(\n" - ] - }, - { - "data": { - "image/png": "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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter4_57_2.png" - } - }, - "output_type": "display_data" - }, - { - "data": { - "image/png": "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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter4_57_3.png" - } - }, - "output_type": "display_data" - }, - { - "data": { - "image/png": "iVBORw0KGgoAAAANSUhEUgAAAfgAAAFmCAYAAACBRIhMAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjMuMywgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/Il7ecAAAACXBIWXMAAAsTAAALEwEAmpwYAAB21klEQVR4nO3dd3gU1dfA8e9ukk0lpBB6CyV0CCC9hV4E6SAKKF1KELCi/gQrAgISmgKKiA3pXXroHULvLSEJIb3X3Xn/WN8BlBIgm0k5n+fxebyzszNnh82euXdmztUpiqIghBBCiDxFr3UAQgghhMh6kuCFEEKIPEgSvBBCCJEHSYIXQggh8iBJ8EIIIUQeJAleCCGEyIOstQ5AiJzg6NGjLFiwgIyMDIxGI7a2trzyyiu8/PLLGAyGbItj7ty5/PHHH7z66qv4+vo+8/tTU1Np164df//9N/b29lkaW0hICLNmzeLOnTtYWVmRkpJC3bp1efXVV/H09Hzq+4cNG8bQoUNp0KBBlsaVnJzMnDlzOHnyJDY2NqSmplKrVi369u1LhQoVsnRfQuQqihD53J49exQfHx/l1q1b6jJ/f3+latWqyoULF7I9ng8++EDx8/PL1Lr9+/dXVq1a9dCy2NjYLI/p7t27SrNmzZStW7eqy6Kjo5VevXop33zzTaa2ER8fr5hMpiyNKyMjQ+nfv78yffp0ddvx8fHKkCFDlJEjR2bpvoTIbWSIXuRrJpOJzz77jLfeeosyZcqoy1u0aEH79u01jOz5OTs7Z/k2Z86cSb169WjXrp26zMXFhXHjxmFra5upbTg5OaHT6bI0rnXr1hEUFMS4cePUbTs5OfHRRx9l+b6EyG0kwYt87fz589y5c4cmTZr857Wvv/4aLy8vlixZQpMmTZgzZw4Afn5+vPTSS6xevRowD6s3adKEzz//nHfffZf27dszffp0zpw5w6hRo2jdujU7duwAYMOGDbRq1YoPP/wQgN9///2hbT/K5MmTeeONNxgwYAATJkwgISEBgBkzZnDx4kUWLlzIgAED8Pf355133qFGjRocOXKE5cuXU6dOHTp27MjRo0eJiYmhR48etGrViosXL5KYmMjEiRPp168fr776Kn/88ccj928ymdixY8cjj1GTJk0YN27cU2NdvHjxQ59z8uTJvPTSS3z33XeMHTuW9u3bM3PmTHU7J0+epF+/fgwcOJABAwawe/fuR8a2detWGjZsiLX1w1cby5Urx9SpU4mJiaFPnz5UqlQJgKCgILp27UqrVq0A82WH/3999erVDB48mOrVqzNkyBAqVarE0KFD1X+3Zs2aMWrUKADOnTvH66+/Tv/+/XnjjTe4fv36Y//9hNCM1kMIQmhp06ZNipeXl5KWlvbE9f49bP7vofEPPvhA6d69u5KamqpERkYq1apVU+bNm6coiqJs3bpVad++vbqun5+f8sEHHzx22/9uL1269KH3zpo167FxKIqitGzZUjl8+LCiKIry9ddfK5988on62s8//6zs379fURRF+fjjj5X3339fURTzsHarVq2UY8eO/eezh4eHK15eXur7nuRJsT7qGA4bNkwxmUxKWFiYUrVqVeXu3buKoihKz549lYCAAEVRFOXixYsPHa8HdejQQZk5c+YTYwoKClK8vLzU9uHDh5WWLVv+5/U1a9YoiqIoP/30kxISEqI0atRIOXHihLreW2+9pRiNRiUuLk5p0KCBcvDgQUVRFGX37t1Ku3btFKPR+MQ4hMhu0oMXIovUr18fg8GAm5sbbm5uVK5cGYBKlSpx586d596ura0tr732Gv3792fTpk2cP38+0+/t1q0bW7ZsITU1FYAjR47QqFEjTCYT69ato2fPnoB5WLtly5asX7/+sdtSHpi2wmg0MmDAAHr06EG/fv2eO9amTZui0+koXLgwLi4uBAcHA1CwYEHWrVtHREQElStXZtKkSZn+zM+rdevWAAwaNIhixYrx8ssvs3btWgCuXLlCxYoV0ev17N69GwcHBxo1agSAj48PERERnD592uIxCvEs5C56ka+VLl0agLCwMEqWLPlC23J0dFT/39raWm1bWVmRnp7+XNs8cuQI33zzDRs2bKBkyZKsXr2aNWvWZPr9VapUoVixYuzcuRMvLy/KlSuHXq8nIiKCtLQ0pk+fjp2dHQBxcXFUqVLlP9twc3PD0dGRsLAwdZmVlRXLli1jxYoVLFiw4LljdXJyUv/f1tZWPU4zZsxg4cKFdO/eHS8vL959991HxlamTJmH4noRBQoUeKjdrVs33nzzTT755BPWrVtHjx49ALh79y6xsbEMGDBAXdfNzY2YmJgsiUOIrCIJXuRrVatWpWzZshw4cIC+ffs+9NpHH33E66+/TrVq1bCxsSEtLU19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CJEHSYIXQggh8iBJ8EIIIUQeJAleCCGEyINyXKEbIXKzM2fOMH36dNLT02nSpAlRUVHo9Xo+/vhj9PrsP5/esWMHlStX1qyoy5QpU3BxceH06dPMmDEj28vEhoaG8vXXX+Pl5YWvr2+27lsIrUmCFyIL1axZk/r165OUlKQmlP79+7Nv3z5Nnr3esWMHBQoU0CzB79ixg507d5Keno6NjU22779YsWK0bNmS4ODgbN+3EFqTBC+EBWVkZBAdHY2rqyvbt29n3759lCxZkpCQECZOnMiFCxeYPHky1apVw2AwsHXrVrZu3cqWLVu4efMmrq6uBAQEMH36dAC++uorypYty927d2nVqhXNmjVj+vTpbNy4ke7du3P9+nWcnJyYMmUKZ86c4eLFiwCcPn2a4cOH88knn1CkSBGSkpLw8PBg8ODBAKxdu5Zdu3ZRpUoVrl69Snh4OB9//DGurq7MmDGDihUrEhgYSN++falevfpDnzEhIYFp06apn6tp06a0adOGX375hdjYWObMmUPHjh2pUKGC+p7ffvuNsLAwderLzz//XD0Z8PT05PLly3z22Wc4OTkxbtw4goODady4MadOnaJNmzZERUVx8eJFqlatyttvv83OnTv56quvePnll7G1teXcuXP4+vr+Z9KTsLCwp34eIfKMrJzuTgihKH5+fkrfvn0VPz8/5fPPP1fWr1+vxMTEKE2aNFGSk5PVdX7++Wf1/6dOnaooinkq00uXLikvv/yyur0tW7YocXFxyrfffqssWLBAURRFSU5OVnx8fJT09HRFURSlevXqSlxcnKIoitKpUyclKipKURRF+eCDD5TDhw+r29q+fbv6/6+88ooSHx+vREVFKU2aNFGnA505c6bi5+enKIqijB8/Xlm/fr2iKIoSFBSkdO3a9T+f99tvv1UWL16sKIqipKamKs2aNVNiYmIURVGUli1bPvIYvfLKK8qRI0cURVGUEydOKIqiKEeOHFE/w08//aT8+uuv6n59fHwUo9GoxMbGKjVr1lQSEhIUo9GotGjRQt1m//79lQMHDiiKoigBAQFKjx49FEVRlFWrVj3T5xEir5AevBAWULt27Yeu+Z45cwaAX375BYDY2NiHpuAtX748AJUrV2bLli0PDal36NABMM+74OLiwsKFCwHw8vIiNjYWd3d3ChUqRIECBQDzpBSJiYm4urr+J67w8HBmzpyJk5MTCQkJxMTEEBUVhaurqzqrXalSpQgNDVX36ebmRmhoKIqi4O7ujslkeuh+gsuXL9OrVy8ADAYDBQsW5Pbt29SsWfOxx+ebb75h8eLFTJs2ja5du1KnTh0cHByYN28erq6unD9//qE62yVLlkSv1+Ps7Iy7u7t6Lf/f9zWUKlUKgNKlS3Pt2rX/7Dczn0eIvEISvBDZoEyZMtja2jJ48GCsra0JDAzk3r176us6nU79fy8vr4euGW/dupV69epRuXJlChUqxMCBAwFYt26dOlvXg+9/kF6vR1EUAgMDSUpKYvHixezcuROAXbt2AeakGBkZSWpqKra2tgQFBWFtbf5pqFy5Mo0aNaJ169YoikKRIkX+kwwrV65MYGAgAKmpqcTGxlK2bNknHo/Q0FBmzJhBUlISnTt3pkuXLnzyySd8/PHH1KtXj+XLlz90fDIrKCiIUqVKcevWLfWk6d+xPu3zCJFXSIIXIgudPXuWY8eOkZ6eztatW2nfvj0ABQsWZOLEiXz11VcUK1aM4OBgxowZw82bNzl27BhXrlyhYsWK1KhRg/Lly9O/f3+++uorXF1dMZlMtG/fnuHDhzN9+nTmz59Peno6Hh4eWFlZsWLFCuLj49m6dSsFCxYkODiYVatW8fbbb9OkSRNWrFiBTqfj888/p3z58nz88ceUK1eOsLAwdb133nmH8ePHU7NmTSIjIylatCgA77//Pn5+fly7do2YmBhq1679n888fPhwvvnmG+bPn09oaCiffvopzs7O/Pbbb8THxzN//nxGjBiBlZWV+p5du3Zx4cIFANq2bYuLiwu9evVi/vz5NGjQgPPnzxMbG8vt27dZvXo1wcHBHD58mJCQEOLj49m+fTsA8fHxrFixgt69e6vH//jx45w5c4bPPvuM0NBQdu/eTWxsLNeuXcvU5xEir5DJZoQQnDlzRh1Snzt3LqVKlaJr164aR/VsBgwYwJQpU2SedyH+IWNTQgg2btzI7Nmz+f7774mOjubll1/WOqRn4u/vT3BwML///rvWoQiRY0gPXgghhMiDpAcvhBBC5EGS4IUQQog8SBK8EEIIkQdJghdCCCHyIEnwQgghRB4kCV4IIYTIg/4P2w5ECBkhgJ8AAAAASUVORK5CYII=\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter4_57_4.png" - } - }, - "output_type": "display_data" - } - ], - "source": [ - "import matplotlib.pyplot as plt\n", - "import numpy as np\n", - "from sklearn.model_selection import train_test_split \n", - "from sklearn.datasets import load_breast_cancer\n", - "from sklearn.linear_model import LogisticRegression\n", - "\n", - "# Load the data\n", - "cancer = load_breast_cancer()\n", - "\n", - "X_train, X_test, y_train, y_test = train_test_split(cancer.data,cancer.target,random_state=0)\n", - "print(X_train.shape)\n", - "print(X_test.shape)\n", - "# Logistic Regression\n", - "logreg = LogisticRegression(solver='lbfgs')\n", - "logreg.fit(X_train, y_train)\n", - "print(\"Test set accuracy with Logistic Regression: {:.2f}\".format(logreg.score(X_test,y_test)))\n", - "#now scale the data\n", - "from sklearn.preprocessing import StandardScaler\n", - "scaler = StandardScaler()\n", - "scaler.fit(X_train)\n", - "X_train_scaled = scaler.transform(X_train)\n", - "X_test_scaled = scaler.transform(X_test)\n", - "# Logistic Regression\n", - "logreg.fit(X_train_scaled, y_train)\n", - "print(\"Test set accuracy Logistic Regression with scaled data: {:.2f}\".format(logreg.score(X_test_scaled,y_test)))\n", - "\n", - "\n", - "from sklearn.preprocessing import LabelEncoder\n", - "from sklearn.model_selection import cross_validate\n", - "#Cross validation\n", - "accuracy = cross_validate(logreg,X_test_scaled,y_test,cv=10)['test_score']\n", - "print(accuracy)\n", - "print(\"Test set accuracy with Logistic Regression and scaled data: {:.2f}\".format(logreg.score(X_test_scaled,y_test)))\n", - "\n", - "\n", - "import scikitplot as skplt\n", - "y_pred = logreg.predict(X_test_scaled)\n", - "skplt.metrics.plot_confusion_matrix(y_test, y_pred, normalize=True)\n", - "plt.show()\n", - "y_probas = logreg.predict_proba(X_test_scaled)\n", - "skplt.metrics.plot_roc(y_test, y_probas)\n", - "plt.show()\n", - "skplt.metrics.plot_cumulative_gain(y_test, y_probas)\n", - "plt.show()" - ] - } - ], - "metadata": { - "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.8.5" - } - }, - "nbformat": 4, - "nbformat_minor": 4 -} \ No newline at end of file diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter4.py b/doc/LectureNotes/_build/jupyter_execute/chapter4.py deleted file mode 100644 index 43b245517..000000000 --- a/doc/LectureNotes/_build/jupyter_execute/chapter4.py +++ /dev/null @@ -1,574 +0,0 @@ -# Logistic Regression - - - -## Logistic Regression - -In linear regression our main interest was centered on learning the -coefficients of a functional fit (say a polynomial) in order to be -able to predict the response of a continuous variable on some unseen -data. The fit to the continuous variable $y_i$ is based on some -independent variables $x_i$. Linear regression resulted in -analytical expressions for standard ordinary Least Squares or Ridge -regression (in terms of matrices to invert) for several quantities, -ranging from the variance and thereby the confidence intervals of the -optimal parameters $\hat{\beta}$ to the mean squared error. If we can invert -the product of the design matrices, linear regression gives then a -simple recipe for fitting our data. - - -Classification problems, however, are concerned with outcomes taking -the form of discrete variables (i.e. categories). We may for example, -on the basis of DNA sequencing for a number of patients, like to find -out which mutations are important for a certain disease; or based on -scans of various patients' brains, figure out if there is a tumor or -not; or given a specific physical system, we'd like to identify its -state, say whether it is an ordered or disordered system (typical -situation in solid state physics); or classify the status of a -patient, whether she/he has a stroke or not and many other similar -situations. - -The most common situation we encounter when we apply logistic -regression is that of two possible outcomes, normally denoted as a -binary outcome, true or false, positive or negative, success or -failure etc. - - -Logistic regression will also serve as our stepping stone towards -neural network algorithms and supervised deep learning. For logistic -learning, the minimization of the cost function leads to a non-linear -equation in the parameters $\hat{\beta}$. The optimization of the -problem calls therefore for minimization algorithms. This forms the -bottle neck of all machine learning algorithms, namely how to find -reliable minima of a multi-variable function. This leads us to the -family of gradient descent methods. The latter are the working horses -of basically all modern machine learning algorithms. - -We note also that many of the topics discussed here on logistic -regression are also commonly used in modern supervised Deep Learning -models, as we will see later. - - - -## Basics - -We consider the case where the dependent variables, also called the -responses or the outcomes, $y_i$ are discrete and only take values -from $k=0,\dots,K-1$ (i.e. $K$ classes). - -The goal is to predict the -output classes from the design matrix $\boldsymbol{X}\in\mathbb{R}^{n\times p}$ -made of $n$ samples, each of which carries $p$ features or predictors. The -primary goal is to identify the classes to which new unseen samples -belong. - -Let us specialize to the case of two classes only, with outputs -$y_i=0$ and $y_i=1$. Our outcomes could represent the status of a -credit card user that could default or not on her/his credit card -debt. That is - -$$ -y_i = \begin{bmatrix} 0 & \mathrm{no}\\ 1 & \mathrm{yes} \end{bmatrix}. -$$ - -Before moving to the logistic model, let us try to use our linear -regression model to classify these two outcomes. We could for example -fit a linear model to the default case if $y_i > 0.5$ and the no -default case $y_i \leq 0.5$. - -We would then have our -weighted linear combination, namely - - -
- -$$ -\begin{equation} -\boldsymbol{y} = \boldsymbol{X}^T\boldsymbol{\beta} + \boldsymbol{\epsilon}, -\label{_auto1} \tag{1} -\end{equation} -$$ - -where $\boldsymbol{y}$ is a vector representing the possible outcomes, $\boldsymbol{X}$ is our -$n\times p$ design matrix and $\boldsymbol{\beta}$ represents our estimators/predictors. - - -The main problem with our function is that it takes values on the -entire real axis. In the case of logistic regression, however, the -labels $y_i$ are discrete variables. A typical example is the credit -card data discussed below here, where we can set the state of -defaulting the debt to $y_i=1$ and not to $y_i=0$ for one the persons -in the data set (see the full example below). - -One simple way to get a discrete output is to have sign -functions that map the output of a linear regressor to values $\{0,1\}$, -$f(s_i)=sign(s_i)=1$ if $s_i\ge 0$ and 0 if otherwise. -We will encounter this model in our first demonstration of neural networks. Historically it is called the ``perceptron" model in the machine learning -literature. This model is extremely simple. However, in many cases it is more -favorable to use a ``soft" classifier that outputs -the probability of a given category. This leads us to the logistic function. - - -The following example on data for coronary heart disease (CHD) as function of age may serve as an illustration. In the code here we read and plot whether a person has had CHD (output = 1) or not (output = 0). This ouput is plotted the person's against age. Clearly, the figure shows that attempting to make a standard linear regression fit may not be very meaningful. - -%matplotlib inline - -# Common imports -import os -import numpy as np -import pandas as pd -import matplotlib.pyplot as plt -from sklearn.linear_model import LinearRegression, Ridge, Lasso -from sklearn.model_selection import train_test_split -from sklearn.utils import resample -from sklearn.metrics import mean_squared_error -from IPython.display import display -from pylab import plt, mpl -plt.style.use('seaborn') -mpl.rcParams['font.family'] = 'serif' - -# Where to save the figures and data files -PROJECT_ROOT_DIR = "Results" -FIGURE_ID = "Results/FigureFiles" -DATA_ID = "DataFiles/" - -if not os.path.exists(PROJECT_ROOT_DIR): - os.mkdir(PROJECT_ROOT_DIR) - -if not os.path.exists(FIGURE_ID): - os.makedirs(FIGURE_ID) - -if not os.path.exists(DATA_ID): - os.makedirs(DATA_ID) - -def image_path(fig_id): - return os.path.join(FIGURE_ID, fig_id) - -def data_path(dat_id): - return os.path.join(DATA_ID, dat_id) - -def save_fig(fig_id): - plt.savefig(image_path(fig_id) + ".png", format='png') - -infile = open(data_path("chddata.csv"),'r') - -# Read the chd data as csv file and organize the data into arrays with age group, age, and chd -chd = pd.read_csv(infile, names=('ID', 'Age', 'Agegroup', 'CHD')) -chd.columns = ['ID', 'Age', 'Agegroup', 'CHD'] -output = chd['CHD'] -age = chd['Age'] -agegroup = chd['Agegroup'] -numberID = chd['ID'] -display(chd) - -plt.scatter(age, output, marker='o') -plt.axis([18,70.0,-0.1, 1.2]) -plt.xlabel(r'Age') -plt.ylabel(r'CHD') -plt.title(r'Age distribution and Coronary heart disease') -plt.show() - -What we could attempt however is to plot the mean value for each group. - -agegroupmean = np.array([0.1, 0.133, 0.250, 0.333, 0.462, 0.625, 0.765, 0.800]) -group = np.array([1, 2, 3, 4, 5, 6, 7, 8]) -plt.plot(group, agegroupmean, "r-") -plt.axis([0,9,0, 1.0]) -plt.xlabel(r'Age group') -plt.ylabel(r'CHD mean values') -plt.title(r'Mean values for each age group') -plt.show() - -We are now trying to find a function $f(y\vert x)$, that is a function which gives us an expected value for the output $y$ with a given input $x$. -In standard linear regression with a linear dependence on $x$, we would write this in terms of our model - -$$ -f(y_i\vert x_i)=\beta_0+\beta_1 x_i. -$$ - -This expression implies however that $f(y_i\vert x_i)$ could take any -value from minus infinity to plus infinity. If we however let -$f(y\vert y)$ be represented by the mean value, the above example -shows us that we can constrain the function to take values between -zero and one, that is we have $0 \le f(y_i\vert x_i) \le 1$. Looking -at our last curve we see also that it has an S-shaped form. This leads -us to a very popular model for the function $f$, namely the so-called -Sigmoid function or logistic model. We will consider this function as -representing the probability for finding a value of $y_i$ with a given -$x_i$. - - -## The logistic function - -Another widely studied model, is the so-called -perceptron model, which is an example of a "hard classification" model. We -will encounter this model when we discuss neural networks as -well. Each datapoint is deterministically assigned to a category (i.e -$y_i=0$ or $y_i=1$). In many cases, and the coronary heart disease data forms one of many such examples, it is favorable to have a "soft" -classifier that outputs the probability of a given category rather -than a single value. For example, given $x_i$, the classifier -outputs the probability of being in a category $k$. Logistic regression -is the most common example of a so-called soft classifier. In logistic -regression, the probability that a data point $x_i$ -belongs to a category $y_i=\{0,1\}$ is given by the so-called logit function (or Sigmoid) which is meant to represent the likelihood for a given event, - -$$ -p(t) = \frac{1}{1+\mathrm \exp{-t}}=\frac{\exp{t}}{1+\mathrm \exp{t}}. -$$ - -Note that $1-p(t)= p(-t)$. - -## Examples of likelihood functions used in logistic regression and nueral networks - - -The following code plots the logistic function, the step function and other functions we will encounter from here and on. - -"""The sigmoid function (or the logistic curve) is a -function that takes any real number, z, and outputs a number (0,1). -It is useful in neural networks for assigning weights on a relative scale. -The value z is the weighted sum of parameters involved in the learning algorithm.""" - -import numpy -import matplotlib.pyplot as plt -import math as mt - -z = numpy.arange(-5, 5, .1) -sigma_fn = numpy.vectorize(lambda z: 1/(1+numpy.exp(-z))) -sigma = sigma_fn(z) - -fig = plt.figure() -ax = fig.add_subplot(111) -ax.plot(z, sigma) -ax.set_ylim([-0.1, 1.1]) -ax.set_xlim([-5,5]) -ax.grid(True) -ax.set_xlabel('z') -ax.set_title('sigmoid function') - -plt.show() - -"""Step Function""" -z = numpy.arange(-5, 5, .02) -step_fn = numpy.vectorize(lambda z: 1.0 if z >= 0.0 else 0.0) -step = step_fn(z) - -fig = plt.figure() -ax = fig.add_subplot(111) -ax.plot(z, step) -ax.set_ylim([-0.5, 1.5]) -ax.set_xlim([-5,5]) -ax.grid(True) -ax.set_xlabel('z') -ax.set_title('step function') - -plt.show() - -"""tanh Function""" -z = numpy.arange(-2*mt.pi, 2*mt.pi, 0.1) -t = numpy.tanh(z) - -fig = plt.figure() -ax = fig.add_subplot(111) -ax.plot(z, t) -ax.set_ylim([-1.0, 1.0]) -ax.set_xlim([-2*mt.pi,2*mt.pi]) -ax.grid(True) -ax.set_xlabel('z') -ax.set_title('tanh function') - -plt.show() - -We assume now that we have two classes with $y_i$ either $0$ or $1$. Furthermore we assume also that we have only two parameters $\beta$ in our fitting of the Sigmoid function, that is we define probabilities - -$$ -\begin{align*} -p(y_i=1|x_i,\boldsymbol{\beta}) &= \frac{\exp{(\beta_0+\beta_1x_i)}}{1+\exp{(\beta_0+\beta_1x_i)}},\nonumber\\ -p(y_i=0|x_i,\boldsymbol{\beta}) &= 1 - p(y_i=1|x_i,\boldsymbol{\beta}), -\end{align*} -$$ - -where $\boldsymbol{\beta}$ are the weights we wish to extract from data, in our case $\beta_0$ and $\beta_1$. - -Note that we used - -$$ -p(y_i=0\vert x_i, \boldsymbol{\beta}) = 1-p(y_i=1\vert x_i, \boldsymbol{\beta}). -$$ - -In order to define the total likelihood for all possible outcomes from a -dataset $\mathcal{D}=\{(y_i,x_i)\}$, with the binary labels -$y_i\in\{0,1\}$ and where the data points are drawn independently, we use the so-called [Maximum Likelihood Estimation](https://en.wikipedia.org/wiki/Maximum_likelihood_estimation) (MLE) principle. -We aim thus at maximizing -the probability of seeing the observed data. We can then approximate the -likelihood in terms of the product of the individual probabilities of a specific outcome $y_i$, that is - -$$ -\begin{align*} -P(\mathcal{D}|\boldsymbol{\beta})& = \prod_{i=1}^n \left[p(y_i=1|x_i,\boldsymbol{\beta})\right]^{y_i}\left[1-p(y_i=1|x_i,\boldsymbol{\beta}))\right]^{1-y_i}\nonumber \\ -\end{align*} -$$ - -from which we obtain the log-likelihood and our **cost/loss** function - -$$ -\mathcal{C}(\boldsymbol{\beta}) = \sum_{i=1}^n \left( y_i\log{p(y_i=1|x_i,\boldsymbol{\beta})} + (1-y_i)\log\left[1-p(y_i=1|x_i,\boldsymbol{\beta}))\right]\right). -$$ - -Reordering the logarithms, we can rewrite the **cost/loss** function as - -$$ -\mathcal{C}(\boldsymbol{\beta}) = \sum_{i=1}^n \left(y_i(\beta_0+\beta_1x_i) -\log{(1+\exp{(\beta_0+\beta_1x_i)})}\right). -$$ - -The maximum likelihood estimator is defined as the set of parameters that maximize the log-likelihood where we maximize with respect to $\beta$. -Since the cost (error) function is just the negative log-likelihood, for logistic regression we have that - -$$ -\mathcal{C}(\boldsymbol{\beta})=-\sum_{i=1}^n \left(y_i(\beta_0+\beta_1x_i) -\log{(1+\exp{(\beta_0+\beta_1x_i)})}\right). -$$ - -This equation is known in statistics as the **cross entropy**. Finally, we note that just as in linear regression, -in practice we often supplement the cross-entropy with additional regularization terms, usually $L_1$ and $L_2$ regularization as we did for Ridge and Lasso regression. - - -The cross entropy is a convex function of the weights $\boldsymbol{\beta}$ and, -therefore, any local minimizer is a global minimizer. - - -Minimizing this -cost function with respect to the two parameters $\beta_0$ and $\beta_1$ we obtain - -$$ -\frac{\partial \mathcal{C}(\boldsymbol{\beta})}{\partial \beta_0} = -\sum_{i=1}^n \left(y_i -\frac{\exp{(\beta_0+\beta_1x_i)}}{1+\exp{(\beta_0+\beta_1x_i)}}\right), -$$ - -and - -$$ -\frac{\partial \mathcal{C}(\boldsymbol{\beta})}{\partial \beta_1} = -\sum_{i=1}^n \left(y_ix_i -x_i\frac{\exp{(\beta_0+\beta_1x_i)}}{1+\exp{(\beta_0+\beta_1x_i)}}\right). -$$ - -Let us now define a vector $\boldsymbol{y}$ with $n$ elements $y_i$, an -$n\times p$ matrix $\boldsymbol{X}$ which contains the $x_i$ values and a -vector $\boldsymbol{p}$ of fitted probabilities $p(y_i\vert x_i,\boldsymbol{\beta})$. We can rewrite in a more compact form the first -derivative of cost function as - -$$ -\frac{\partial \mathcal{C}(\boldsymbol{\beta})}{\partial \boldsymbol{\beta}} = -\boldsymbol{X}^T\left(\boldsymbol{y}-\boldsymbol{p}\right). -$$ - -If we in addition define a diagonal matrix $\boldsymbol{W}$ with elements -$p(y_i\vert x_i,\boldsymbol{\beta})(1-p(y_i\vert x_i,\boldsymbol{\beta})$, we can obtain a compact expression of the second derivative as - -$$ -\frac{\partial^2 \mathcal{C}(\boldsymbol{\beta})}{\partial \boldsymbol{\beta}\partial \boldsymbol{\beta}^T} = \boldsymbol{X}^T\boldsymbol{W}\boldsymbol{X}. -$$ - -Within a binary classification problem, we can easily expand our model to include multiple predictors. Our ratio between likelihoods is then with $p$ predictors - -$$ -\log{ \frac{p(\boldsymbol{\beta}\boldsymbol{x})}{1-p(\boldsymbol{\beta}\boldsymbol{x})}} = \beta_0+\beta_1x_1+\beta_2x_2+\dots+\beta_px_p. -$$ - -Here we defined $\boldsymbol{x}=[1,x_1,x_2,\dots,x_p]$ and $\boldsymbol{\beta}=[\beta_0, \beta_1, \dots, \beta_p]$ leading to - -$$ -p(\boldsymbol{\beta}\boldsymbol{x})=\frac{ \exp{(\beta_0+\beta_1x_1+\beta_2x_2+\dots+\beta_px_p)}}{1+\exp{(\beta_0+\beta_1x_1+\beta_2x_2+\dots+\beta_px_p)}}. -$$ - -Till now we have mainly focused on two classes, the so-called binary -system. Suppose we wish to extend to $K$ classes. Let us for the sake -of simplicity assume we have only two predictors. We have then following model - -$$ -\log{\frac{p(C=1\vert x)}{p(K\vert x)}} = \beta_{10}+\beta_{11}x_1, -$$ - -and - -$$ -\log{\frac{p(C=2\vert x)}{p(K\vert x)}} = \beta_{20}+\beta_{21}x_1, -$$ - -and so on till the class $C=K-1$ class - -$$ -\log{\frac{p(C=K-1\vert x)}{p(K\vert x)}} = \beta_{(K-1)0}+\beta_{(K-1)1}x_1, -$$ - -and the model is specified in term of $K-1$ so-called log-odds or -**logit** transformations. - - - -In our discussion of neural networks we will encounter the above again -in terms of a slightly modified function, the so-called **Softmax** function. - -The softmax function is used in various multiclass classification -methods, such as multinomial logistic regression (also known as -softmax regression), multiclass linear discriminant analysis, naive -Bayes classifiers, and artificial neural networks. Specifically, in -multinomial logistic regression and linear discriminant analysis, the -input to the function is the result of $K$ distinct linear functions, -and the predicted probability for the $k$-th class given a sample -vector $\boldsymbol{x}$ and a weighting vector $\boldsymbol{\beta}$ is (with two -predictors): - -$$ -p(C=k\vert \mathbf {x} )=\frac{\exp{(\beta_{k0}+\beta_{k1}x_1)}}{1+\sum_{l=1}^{K-1}\exp{(\beta_{l0}+\beta_{l1}x_1)}}. -$$ - -It is easy to extend to more predictors. The final class is - -$$ -p(C=K\vert \mathbf {x} )=\frac{1}{1+\sum_{l=1}^{K-1}\exp{(\beta_{l0}+\beta_{l1}x_1)}}, -$$ - -and they sum to one. Our earlier discussions were all specialized to -the case with two classes only. It is easy to see from the above that -what we derived earlier is compatible with these equations. - -To find the optimal parameters we would typically use a gradient -descent method. Newton's method and gradient descent methods are -discussed in the material on [optimization -methods](https://compphysics.github.io/MachineLearning/doc/pub/Splines/html/Splines-bs.html). - -## Wisconsin Cancer Data - -We show here how we can use a simple regression case on the breast -cancer data using Logistic regression as our algorithm for -classification. - -import matplotlib.pyplot as plt -import numpy as np -from sklearn.model_selection import train_test_split -from sklearn.datasets import load_breast_cancer -from sklearn.linear_model import LogisticRegression - -# Load the data -cancer = load_breast_cancer() - -X_train, X_test, y_train, y_test = train_test_split(cancer.data,cancer.target,random_state=0) -print(X_train.shape) -print(X_test.shape) -# Logistic Regression -logreg = LogisticRegression(solver='lbfgs') -logreg.fit(X_train, y_train) -print("Test set accuracy with Logistic Regression: {:.2f}".format(logreg.score(X_test,y_test))) -#now scale the data -from sklearn.preprocessing import StandardScaler -scaler = StandardScaler() -scaler.fit(X_train) -X_train_scaled = scaler.transform(X_train) -X_test_scaled = scaler.transform(X_test) -# Logistic Regression -logreg.fit(X_train_scaled, y_train) -print("Test set accuracy Logistic Regression with scaled data: {:.2f}".format(logreg.score(X_test_scaled,y_test))) - -In addition to the above scores, we could also study the covariance (and the correlation matrix). -We use **Pandas** to compute the correlation matrix. - -import matplotlib.pyplot as plt -import numpy as np -from sklearn.model_selection import train_test_split -from sklearn.datasets import load_breast_cancer -from sklearn.linear_model import LogisticRegression -cancer = load_breast_cancer() -import pandas as pd -# Making a data frame -cancerpd = pd.DataFrame(cancer.data, columns=cancer.feature_names) - -fig, axes = plt.subplots(15,2,figsize=(10,20)) -malignant = cancer.data[cancer.target == 0] -benign = cancer.data[cancer.target == 1] -ax = axes.ravel() - -for i in range(30): - _, bins = np.histogram(cancer.data[:,i], bins =50) - ax[i].hist(malignant[:,i], bins = bins, alpha = 0.5) - ax[i].hist(benign[:,i], bins = bins, alpha = 0.5) - ax[i].set_title(cancer.feature_names[i]) - ax[i].set_yticks(()) -ax[0].set_xlabel("Feature magnitude") -ax[0].set_ylabel("Frequency") -ax[0].legend(["Malignant", "Benign"], loc ="best") -fig.tight_layout() -plt.show() - -import seaborn as sns -correlation_matrix = cancerpd.corr().round(1) -# use the heatmap function from seaborn to plot the correlation matrix -# annot = True to print the values inside the square -plt.figure(figsize=(15,8)) -sns.heatmap(data=correlation_matrix, annot=True) -plt.show() - -In the above example we note two things. In the first plot we display -the overlap of benign and malignant tumors as functions of the various -features in the Wisconsing breast cancer data set. We see that for -some of the features we can distinguish clearly the benign and -malignant cases while for other features we cannot. This can point to -us which features may be of greater interest when we wish to classify -a benign or not benign tumour. - -In the second figure we have computed the so-called correlation -matrix, which in our case with thirty features becomes a $30\times 30$ -matrix. - -We constructed this matrix using **pandas** via the statements - -cancerpd = pd.DataFrame(cancer.data, columns=cancer.feature_names) - -and then - -correlation_matrix = cancerpd.corr().round(1) - -Diagonalizing this matrix we can in turn say something about which -features are of relevance and which are not. This leads us to -the classical Principal Component Analysis (PCA) theorem with -applications. This will be discussed later this semester ([week 43](https://compphysics.github.io/MachineLearning/doc/pub/week43/html/week43-bs.html)). - -import matplotlib.pyplot as plt -import numpy as np -from sklearn.model_selection import train_test_split -from sklearn.datasets import load_breast_cancer -from sklearn.linear_model import LogisticRegression - -# Load the data -cancer = load_breast_cancer() - -X_train, X_test, y_train, y_test = train_test_split(cancer.data,cancer.target,random_state=0) -print(X_train.shape) -print(X_test.shape) -# Logistic Regression -logreg = LogisticRegression(solver='lbfgs') -logreg.fit(X_train, y_train) -print("Test set accuracy with Logistic Regression: {:.2f}".format(logreg.score(X_test,y_test))) -#now scale the data -from sklearn.preprocessing import StandardScaler -scaler = StandardScaler() -scaler.fit(X_train) -X_train_scaled = scaler.transform(X_train) -X_test_scaled = scaler.transform(X_test) -# Logistic Regression -logreg.fit(X_train_scaled, y_train) -print("Test set accuracy Logistic Regression with scaled data: {:.2f}".format(logreg.score(X_test_scaled,y_test))) - - -from sklearn.preprocessing import LabelEncoder -from sklearn.model_selection import cross_validate -#Cross validation -accuracy = cross_validate(logreg,X_test_scaled,y_test,cv=10)['test_score'] -print(accuracy) -print("Test set accuracy with Logistic Regression and scaled data: {:.2f}".format(logreg.score(X_test_scaled,y_test))) - - -import scikitplot as skplt -y_pred = logreg.predict(X_test_scaled) -skplt.metrics.plot_confusion_matrix(y_test, y_pred, normalize=True) -plt.show() -y_probas = logreg.predict_proba(X_test_scaled) -skplt.metrics.plot_roc(y_test, y_probas) -plt.show() -skplt.metrics.plot_cumulative_gain(y_test, y_probas) -plt.show() \ No newline at end of file diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter4_114_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter4_114_1.png deleted file mode 100644 index 6c642a6a1..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter4_114_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter4_116_0.png b/doc/LectureNotes/_build/jupyter_execute/chapter4_116_0.png deleted file mode 100644 index dfd44cb86..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter4_116_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter4_122_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter4_122_1.png deleted file mode 100644 index 59590fe49..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter4_122_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter4_13_0.png b/doc/LectureNotes/_build/jupyter_execute/chapter4_13_0.png deleted file mode 100644 index cde80495d..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter4_13_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter4_13_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter4_13_1.png deleted file mode 100644 index aee9096ee..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter4_13_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter4_13_2.png b/doc/LectureNotes/_build/jupyter_execute/chapter4_13_2.png deleted file mode 100644 index 0a17d7002..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter4_13_2.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter4_176_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter4_176_1.png deleted file mode 100644 index 409346c45..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter4_176_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter4_185_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter4_185_1.png deleted file mode 100644 index ae819dcfd..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter4_185_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter4_199_2.png b/doc/LectureNotes/_build/jupyter_execute/chapter4_199_2.png deleted file mode 100644 index b619d6183..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter4_199_2.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter4_235_0.png b/doc/LectureNotes/_build/jupyter_execute/chapter4_235_0.png deleted file mode 100644 index d4f6ff104..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter4_235_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter4_51_0.png b/doc/LectureNotes/_build/jupyter_execute/chapter4_51_0.png deleted file mode 100644 index 903d98702..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter4_51_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter4_51_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter4_51_1.png deleted file mode 100644 index 42ba3f001..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter4_51_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter4_57_2.png b/doc/LectureNotes/_build/jupyter_execute/chapter4_57_2.png deleted file mode 100644 index fa199fba3..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter4_57_2.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter4_57_3.png b/doc/LectureNotes/_build/jupyter_execute/chapter4_57_3.png deleted file mode 100644 index 88bffd58a..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter4_57_3.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter4_57_4.png b/doc/LectureNotes/_build/jupyter_execute/chapter4_57_4.png deleted file mode 100644 index e242a4058..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter4_57_4.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter4_5_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter4_5_1.png deleted file mode 100644 index 89d6b14ac..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter4_5_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter4_7_0.png b/doc/LectureNotes/_build/jupyter_execute/chapter4_7_0.png deleted file mode 100644 index de0c567ed..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter4_7_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter5.ipynb b/doc/LectureNotes/_build/jupyter_execute/chapter5.ipynb deleted file mode 100644 index e0728e970..000000000 --- a/doc/LectureNotes/_build/jupyter_execute/chapter5.ipynb +++ /dev/null @@ -1,2022 +0,0 @@ -{ - "cells": [ - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "# Support Vector Machines, overarching aims\n", - "\n", - "A Support Vector Machine (SVM) is a very powerful and versatile\n", - "Machine Learning method, capable of performing linear or nonlinear\n", - "classification, regression, and even outlier detection. It is one of\n", - "the most popular models in Machine Learning, and anyone interested in\n", - "Machine Learning should have it in their toolbox. SVMs are\n", - "particularly well suited for classification of complex but small-sized or\n", - "medium-sized datasets. \n", - "\n", - "The case with two well-separated classes only can be understood in an\n", - "intuitive way in terms of lines in a two-dimensional space separating\n", - "the two classes (see figure below).\n", - "\n", - "The basic mathematics behind the SVM is however less familiar to most of us. \n", - "It relies on the definition of hyperplanes and the\n", - "definition of a **margin** which separates classes (in case of\n", - "classification problems) of variables. It is also used for regression\n", - "problems.\n", - "\n", - "With SVMs we distinguish between hard margin and soft margins. The\n", - "latter introduces a so-called softening parameter to be discussed\n", - "below. We distinguish also between linear and non-linear\n", - "approaches. The latter are the most frequent ones since it is rather\n", - "unlikely that we can separate classes easily by say straight lines.\n", - "\n", - "\n", - "## Hyperplanes and all that\n", - "\n", - "The theory behind support vector machines (SVM hereafter) is based on\n", - "the mathematical description of so-called hyperplanes. Let us start\n", - "with a two-dimensional case. This will also allow us to introduce our\n", - "first SVM examples. These will be tailored to the case of two specific\n", - "classes, as displayed in the figure here based on the usage of the petal data.\n", - "\n", - "We assume here that our data set can be well separated into two\n", - "domains, where a straight line does the job in the separating the two\n", - "classes. Here the two classes are represented by either squares or\n", - "circles." - ] - }, - { - "cell_type": "code", - "execution_count": 1, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "LinearSVC: [0.28475098] [[1.05364854 1.09903804]]\n", - "SVC: [0.31896852] [[1.1203284 1.02625193]]\n", - "SGDClassifier(alpha=0.00200): [0.117] [[0.77714169 0.72981762]]\n" - ] - }, - { - "data": { - "image/png": "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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter5_1_1.png" - }, - "needs_background": "light" - }, - "output_type": "display_data" - } - ], - "source": [ - "%matplotlib inline\n", - "\n", - "from sklearn import datasets\n", - "from sklearn.svm import SVC, LinearSVC\n", - "from sklearn.linear_model import SGDClassifier\n", - "from sklearn.preprocessing import StandardScaler\n", - "import matplotlib\n", - "import matplotlib.pyplot as plt\n", - "plt.rcParams['axes.labelsize'] = 14\n", - "plt.rcParams['xtick.labelsize'] = 12\n", - "plt.rcParams['ytick.labelsize'] = 12\n", - "\n", - "\n", - "iris = datasets.load_iris()\n", - "X = iris[\"data\"][:, (2, 3)] # petal length, petal width\n", - "y = iris[\"target\"]\n", - "\n", - "setosa_or_versicolor = (y == 0) | (y == 1)\n", - "X = X[setosa_or_versicolor]\n", - "y = y[setosa_or_versicolor]\n", - "\n", - "\n", - "\n", - "C = 5\n", - "alpha = 1 / (C * len(X))\n", - "\n", - "lin_clf = LinearSVC(loss=\"hinge\", C=C, random_state=42)\n", - "svm_clf = SVC(kernel=\"linear\", C=C)\n", - "sgd_clf = SGDClassifier(loss=\"hinge\", learning_rate=\"constant\", eta0=0.001, alpha=alpha,\n", - " max_iter=100000, random_state=42)\n", - "\n", - "scaler = StandardScaler()\n", - "X_scaled = scaler.fit_transform(X)\n", - "\n", - "lin_clf.fit(X_scaled, y)\n", - "svm_clf.fit(X_scaled, y)\n", - "sgd_clf.fit(X_scaled, y)\n", - "\n", - "print(\"LinearSVC: \", lin_clf.intercept_, lin_clf.coef_)\n", - "print(\"SVC: \", svm_clf.intercept_, svm_clf.coef_)\n", - "print(\"SGDClassifier(alpha={:.5f}):\".format(sgd_clf.alpha), sgd_clf.intercept_, sgd_clf.coef_)\n", - "\n", - "# Compute the slope and bias of each decision boundary\n", - "w1 = -lin_clf.coef_[0, 0]/lin_clf.coef_[0, 1]\n", - "b1 = -lin_clf.intercept_[0]/lin_clf.coef_[0, 1]\n", - "w2 = -svm_clf.coef_[0, 0]/svm_clf.coef_[0, 1]\n", - "b2 = -svm_clf.intercept_[0]/svm_clf.coef_[0, 1]\n", - "w3 = -sgd_clf.coef_[0, 0]/sgd_clf.coef_[0, 1]\n", - "b3 = -sgd_clf.intercept_[0]/sgd_clf.coef_[0, 1]\n", - "\n", - "# Transform the decision boundary lines back to the original scale\n", - "line1 = scaler.inverse_transform([[-10, -10 * w1 + b1], [10, 10 * w1 + b1]])\n", - "line2 = scaler.inverse_transform([[-10, -10 * w2 + b2], [10, 10 * w2 + b2]])\n", - "line3 = scaler.inverse_transform([[-10, -10 * w3 + b3], [10, 10 * w3 + b3]])\n", - "\n", - "# Plot all three decision boundaries\n", - "plt.figure(figsize=(11, 4))\n", - "plt.plot(line1[:, 0], line1[:, 1], \"k:\", label=\"LinearSVC\")\n", - "plt.plot(line2[:, 0], line2[:, 1], \"b--\", linewidth=2, label=\"SVC\")\n", - "plt.plot(line3[:, 0], line3[:, 1], \"r-\", label=\"SGDClassifier\")\n", - "plt.plot(X[:, 0][y==1], X[:, 1][y==1], \"bs\") # label=\"Iris-Versicolor\"\n", - "plt.plot(X[:, 0][y==0], X[:, 1][y==0], \"yo\") # label=\"Iris-Setosa\"\n", - "plt.xlabel(\"Petal length\", fontsize=14)\n", - "plt.ylabel(\"Petal width\", fontsize=14)\n", - "plt.legend(loc=\"upper center\", fontsize=14)\n", - "plt.axis([0, 5.5, 0, 2])\n", - "\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The aim of the SVM algorithm is to find a hyperplane in a\n", - "$p$-dimensional space, where $p$ is the number of features that\n", - "distinctly classifies the data points.\n", - "\n", - "In a $p$-dimensional space, a hyperplane is what we call an affine subspace of dimension of $p-1$.\n", - "As an example, in two dimension, a hyperplane is simply as straight line while in three dimensions it is \n", - "a two-dimensional subspace, or stated simply, a plane. \n", - "\n", - "In two dimensions, with the variables $x_1$ and $x_2$, the hyperplane is defined as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "b+w_1x_1+w_2x_2=0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $b$ is the intercept and $w_1$ and $w_2$ define the elements of a vector orthogonal to the line \n", - "$b+w_1x_1+w_2x_2=0$. \n", - "In two dimensions we define the vectors $\\boldsymbol{x} =[x1,x2]$ and $\\boldsymbol{w}=[w1,w2]$. \n", - "We can then rewrite the above equation as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{x}^T\\boldsymbol{w}+b=0.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We limit ourselves to two classes of outputs $y_i$ and assign these classes the values $y_i = \\pm 1$. \n", - "In a $p$-dimensional space of say $p$ features we have a hyperplane defines as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "b+wx_1+w_2x_2+\\dots +w_px_p=0.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "If we define a \n", - "matrix $\\boldsymbol{X}=\\left[\\boldsymbol{x}_1,\\boldsymbol{x}_2,\\dots, \\boldsymbol{x}_p\\right]$\n", - "of dimension $n\\times p$, where $n$ represents the observations for each feature and each vector $x_i$ is a column vector of the matrix $\\boldsymbol{X}$," - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{x}_i = \\begin{bmatrix} x_{i1} \\\\ x_{i2} \\\\ \\dots \\\\ \\dots \\\\ x_{ip} \\end{bmatrix}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "If the above condition is not met for a given vector $\\boldsymbol{x}_i$ we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "b+w_1x_{i1}+w_2x_{i2}+\\dots +w_px_{ip} >0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "if our output $y_i=1$.\n", - "In this case we say that $\\boldsymbol{x}_i$ lies on one of the sides of the hyperplane and if" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "b+w_1x_{i1}+w_2x_{i2}+\\dots +w_px_{ip} < 0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "for the class of observations $y_i=-1$, \n", - "then $\\boldsymbol{x}_i$ lies on the other side. \n", - "\n", - "Equivalently, for the two classes of observations we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "y_i\\left(b+w_1x_{i1}+w_2x_{i2}+\\dots +w_px_{ip}\\right) > 0.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "When we try to separate hyperplanes, if it exists, we can use it to construct a natural classifier: a test observation is assigned a given class depending on which side of the hyperplane it is located.\n", - "\n", - "\n", - "### The two-dimensional case\n", - "\n", - "Let us try to develop our intuition about SVMs by limiting ourselves to a two-dimensional\n", - "plane. To separate the two classes of data points, there are many\n", - "possible lines (hyperplanes if you prefer a more strict naming) \n", - "that could be chosen. Our objective is to find a\n", - "plane that has the maximum margin, i.e the maximum distance between\n", - "data points of both classes. Maximizing the margin distance provides\n", - "some reinforcement so that future data points can be classified with\n", - "more confidence.\n", - "\n", - "What a linear classifier attempts to accomplish is to split the\n", - "feature space into two half spaces by placing a hyperplane between the\n", - "data points. This hyperplane will be our decision boundary. All\n", - "points on one side of the plane will belong to class one and all points\n", - "on the other side of the plane will belong to the second class two.\n", - "\n", - "Unfortunately there are many ways in which we can place a hyperplane\n", - "to divide the data. Below is an example of two candidate hyperplanes\n", - "for our data sample.\n", - "\n", - "\n", - "Let us define the function" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "f(x) = \\boldsymbol{w}^T\\boldsymbol{x}+b = 0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "as the function that determines the line $L$ that separates two classes (our two features), see the figure here. \n", - "\n", - "\n", - "Any point defined by $\\boldsymbol{x}_i$ and $\\boldsymbol{x}_2$ on the line $L$ will satisfy $\\boldsymbol{w}^T(\\boldsymbol{x}_1-\\boldsymbol{x}_2)=0$. \n", - "\n", - "The signed distance $\\delta$ from any point defined by a vector $\\boldsymbol{x}$ and a point $\\boldsymbol{x}_0$ on the line $L$ is then" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\delta = \\frac{1}{\\vert\\vert \\boldsymbol{w}\\vert\\vert}(\\boldsymbol{w}^T\\boldsymbol{x}+b).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "How do we find the parameter $b$ and the vector $\\boldsymbol{w}$? What we could\n", - "do is to define a cost function which now contains the set of all\n", - "misclassified points $M$ and attempt to minimize this function" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(\\boldsymbol{w},b) = -\\sum_{i\\in M} y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We could now for example define all values $y_i =1$ as misclassified in case we have $\\boldsymbol{w}^T\\boldsymbol{x}_i+b < 0$ and the opposite if we have $y_i=-1$. Taking the derivatives gives us" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial C}{\\partial b} = -\\sum_{i\\in M} y_i,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial C}{\\partial \\boldsymbol{w}} = -\\sum_{i\\in M} y_ix_i.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We can now use the Newton-Raphson method or different variants of the gradient descent family (from plain gradient descent to various stochastic gradient descent approaches) to solve the equations" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "b \\leftarrow b +\\eta \\frac{\\partial C}{\\partial b},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{w} \\leftarrow \\boldsymbol{w} +\\eta \\frac{\\partial C}{\\partial \\boldsymbol{w}},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $\\eta$ is our by now well-known learning rate. \n", - "\n", - "\n", - "\n", - "The equations we discussed above can be coded rather easily (the\n", - "framework is similar to what we developed for logistic\n", - "regression). We are going to set up a simple case with two classes only and we want to find a line which separates them the best possible way." - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "There are however problems with this approach, although it looks\n", - "pretty straightforward to implement. When running the above code, we see that we can easily end up with many diffeent lines which separate the two classes.\n", - "\n", - "\n", - "For small\n", - "gaps between the entries, we may also end up needing many iterations\n", - "before the solutions converge and if the data cannot be separated\n", - "properly into two distinct classes, we may not experience a converge\n", - "at all.\n", - "\n", - "\n", - "### A better approach\n", - "\n", - "A better approach is rather to try to define a large margin between\n", - "the two classes (if they are well separated from the beginning).\n", - "\n", - "Thus, we wish to find a margin $M$ with $\\boldsymbol{w}$ normalized to\n", - "$\\vert\\vert \\boldsymbol{w}\\vert\\vert =1$ subject to the condition" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b) \\geq M \\hspace{0.1cm}\\forall i=1,2,\\dots, p.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "All points are thus at a signed distance from the decision boundary defined by the line $L$. The parameters $b$ and $w_1$ and $w_2$ define this line. \n", - "\n", - "We seek thus the largest value $M$ defined by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{1}{\\vert \\vert \\boldsymbol{w}\\vert\\vert}y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b) \\geq M \\hspace{0.1cm}\\forall i=1,2,\\dots, n,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "or just" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b) \\geq M\\vert \\vert \\boldsymbol{w}\\vert\\vert \\hspace{0.1cm}\\forall i.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "If we scale the equation so that $\\vert \\vert \\boldsymbol{w}\\vert\\vert = 1/M$, we have to find the minimum of \n", - "$\\boldsymbol{w}^T\\boldsymbol{w}=\\vert \\vert \\boldsymbol{w}\\vert\\vert$ (the norm) subject to the condition" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b) \\geq 1 \\hspace{0.1cm}\\forall i.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We have thus defined our margin as the invers of the norm of\n", - "$\\boldsymbol{w}$. We want to minimize the norm in order to have a as large as\n", - "possible margin $M$. Before we proceed, we need to remind ourselves\n", - "about Lagrangian multipliers.\n", - "\n", - "\n", - "## A quick Reminder on Lagrangian Multipliers\n", - "\n", - "Consider a function of three independent variables $f(x,y,z)$ . For the function $f$ to be an\n", - "extreme we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "df=0.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "A necessary and sufficient condition is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial f}{\\partial x} =\\frac{\\partial f}{\\partial y}=\\frac{\\partial f}{\\partial z}=0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "due to" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "df = \\frac{\\partial f}{\\partial x}dx+\\frac{\\partial f}{\\partial y}dy+\\frac{\\partial f}{\\partial z}dz.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In many problems the variables $x,y,z$ are often subject to constraints (such as those above for the margin)\n", - "so that they are no longer all independent. It is possible at least in principle to use each \n", - "constraint to eliminate one variable\n", - "and to proceed with a new and smaller set of independent varables.\n", - "\n", - "The use of so-called Lagrangian multipliers is an alternative technique when the elimination\n", - "of variables is incovenient or undesirable. Assume that we have an equation of constraint on \n", - "the variables $x,y,z$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\phi(x,y,z) = 0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "resulting in" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "d\\phi = \\frac{\\partial \\phi}{\\partial x}dx+\\frac{\\partial \\phi}{\\partial y}dy+\\frac{\\partial \\phi}{\\partial z}dz =0.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Now we cannot set anymore" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial f}{\\partial x} =\\frac{\\partial f}{\\partial y}=\\frac{\\partial f}{\\partial z}=0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "if $df=0$ is wanted\n", - "because there are now only two independent variables! Assume $x$ and $y$ are the independent \n", - "variables.\n", - "Then $dz$ is no longer arbitrary.\n", - "\n", - "\n", - "However, we can add to" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "df = \\frac{\\partial f}{\\partial x}dx+\\frac{\\partial f}{\\partial y}dy+\\frac{\\partial f}{\\partial z}dz,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "a multiplum of $d\\phi$, viz. $\\lambda d\\phi$, resulting in" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "df+\\lambda d\\phi = (\\frac{\\partial f}{\\partial z}+\\lambda\n", - "\\frac{\\partial \\phi}{\\partial x})dx+(\\frac{\\partial f}{\\partial y}+\\lambda\\frac{\\partial \\phi}{\\partial y})dy+\n", - "(\\frac{\\partial f}{\\partial z}+\\lambda\\frac{\\partial \\phi}{\\partial z})dz =0.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Our multiplier is chosen so that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial f}{\\partial z}+\\lambda\\frac{\\partial \\phi}{\\partial z} =0.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We need to remember that we took $dx$ and $dy$ to be arbitrary and thus we must have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial f}{\\partial x}+\\lambda\\frac{\\partial \\phi}{\\partial x} =0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial f}{\\partial y}+\\lambda\\frac{\\partial \\phi}{\\partial y} =0.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "When all these equations are satisfied, $df=0$. We have four unknowns, $x,y,z$ and\n", - "$\\lambda$. Actually we want only $x,y,z$, $\\lambda$ needs not to be determined, \n", - "it is therefore often called\n", - "Lagrange's undetermined multiplier.\n", - "If we have a set of constraints $\\phi_k$ we have the equations" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial f}{\\partial x_i}+\\sum_k\\lambda_k\\frac{\\partial \\phi_k}{\\partial x_i} =0.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In order to solve the above problem, we define the following Lagrangian function to be minimized" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\cal{L}(\\lambda,b,\\boldsymbol{w})=\\frac{1}{2}\\boldsymbol{w}^T\\boldsymbol{w}-\\sum_{i=1}^n\\lambda_i\\left[y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b)-1\\right],\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $\\lambda_i$ is a so-called Lagrange multiplier subject to the condition $\\lambda_i \\geq 0$.\n", - "\n", - "Taking the derivatives with respect to $b$ and $\\boldsymbol{w}$ we obtain" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial \\cal{L}}{\\partial b} = -\\sum_{i} \\lambda_iy_i=0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial \\cal{L}}{\\partial \\boldsymbol{w}} = 0 = \\boldsymbol{w}-\\sum_{i} \\lambda_iy_i\\boldsymbol{x}_i.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Inserting these constraints into the equation for $\\cal{L}$ we obtain" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\cal{L}=\\sum_i\\lambda_i-\\frac{1}{2}\\sum_{ij}^n\\lambda_i\\lambda_jy_iy_j\\boldsymbol{x}_i^T\\boldsymbol{x}_j,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "subject to the constraints $\\lambda_i\\geq 0$ and $\\sum_i\\lambda_iy_i=0$. \n", - "We must in addition satisfy the [Karush-Kuhn-Tucker](https://en.wikipedia.org/wiki/Karush%E2%80%93Kuhn%E2%80%93Tucker_conditions) (KKT) condition" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\lambda_i\\left[y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b) -1\\right] \\hspace{0.1cm}\\forall i.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "1. If $\\lambda_i > 0$, then $y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b)=1$ and we say that $x_i$ is on the boundary.\n", - "\n", - "2. If $y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b)> 1$, we say $x_i$ is not on the boundary and we set $\\lambda_i=0$. \n", - "\n", - "When $\\lambda_i > 0$, the vectors $\\boldsymbol{x}_i$ are called support vectors. They are the vectors closest to the line (or hyperplane) and define the margin $M$. \n", - "\n", - "\n", - "We can rewrite" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\cal{L}=\\sum_i\\lambda_i-\\frac{1}{2}\\sum_{ij}^n\\lambda_i\\lambda_jy_iy_j\\boldsymbol{x}_i^T\\boldsymbol{x}_j,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and its constraints in terms of a matrix-vector problem where we minimize w.r.t. $\\lambda$ the following problem" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{1}{2} \\boldsymbol{\\lambda}^T\\begin{bmatrix} y_1y_1\\boldsymbol{x}_1^T\\boldsymbol{x}_1 & y_1y_2\\boldsymbol{x}_1^T\\boldsymbol{x}_2 & \\dots & \\dots & y_1y_n\\boldsymbol{x}_1^T\\boldsymbol{x}_n \\\\\n", - "y_2y_1\\boldsymbol{x}_2^T\\boldsymbol{x}_1 & y_2y_2\\boldsymbol{x}_2^T\\boldsymbol{x}_2 & \\dots & \\dots & y_1y_n\\boldsymbol{x}_2^T\\boldsymbol{x}_n \\\\\n", - "\\dots & \\dots & \\dots & \\dots & \\dots \\\\\n", - "\\dots & \\dots & \\dots & \\dots & \\dots \\\\\n", - "y_ny_1\\boldsymbol{x}_n^T\\boldsymbol{x}_1 & y_ny_2\\boldsymbol{x}_n^T\\boldsymbol{x}_2 & \\dots & \\dots & y_ny_n\\boldsymbol{x}_n^T\\boldsymbol{x}_n \\\\\n", - "\\end{bmatrix}\\boldsymbol{\\lambda}-\\mathbb{1}\\boldsymbol{\\lambda},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "subject to $\\boldsymbol{y}^T\\boldsymbol{\\lambda}=0$. Here we defined the vectors $\\boldsymbol{\\lambda} =[\\lambda_1,\\lambda_2,\\dots,\\lambda_n]$ and \n", - "$\\boldsymbol{y}=[y_1,y_2,\\dots,y_n]$. \n", - "\n", - "\n", - "\n", - "Solving the above problem, yields the values of $\\lambda_i$.\n", - "To find the coefficients of your hyperplane we need simply to compute" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{w}=\\sum_{i} \\lambda_iy_i\\boldsymbol{x}_i.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "With our vector $\\boldsymbol{w}$ we can in turn find the value of the intercept $b$ (here in two dimensions) via" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b)=1,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "resulting in" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "b = \\frac{1}{y_i}-\\boldsymbol{w}^T\\boldsymbol{x}_i,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "or if we write it out in terms of the support vectors only, with $N_s$ being their number, we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "b = \\frac{1}{N_s}\\sum_{j\\in N_s}\\left(y_j-\\sum_{i=1}^n\\lambda_iy_i\\boldsymbol{x}_i^T\\boldsymbol{x}_j\\right).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "With our hyperplane coefficients we can use our classifier to assign any observation by simply using" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "y_i = \\mathrm{sign}(\\boldsymbol{w}^T\\boldsymbol{x}_i+b).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Below we discuss how to find the optimal values of $\\lambda_i$. Before we proceed however, we discuss now the so-called soft classifier. \n", - "\n", - "\n", - "## A soft classifier\n", - "\n", - "Till now, the margin is strictly defined by the support vectors. This defines what is called a hard classifier, that is the margins are well defined.\n", - "\n", - "Suppose now that classes overlap in feature space, as shown in the\n", - "figure here. One way to deal with this problem before we define the\n", - "so-called **kernel approach**, is to allow a kind of slack in the sense\n", - "that we allow some points to be on the wrong side of the margin.\n", - "\n", - "We introduce thus the so-called **slack** variables $\\boldsymbol{\\xi} =[\\xi_1,x_2,\\dots,x_n]$ and \n", - "modify our previous equation" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b)=1,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "to" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b)=1-\\xi_i,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with the requirement $\\xi_i\\geq 0$. The total violation is now $\\sum_i\\xi$. \n", - "The value $\\xi_i$ in the constraint the last constraint corresponds to the amount by which the prediction\n", - "$y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b)=1$ is on the wrong side of its margin. Hence by bounding the sum $\\sum_i \\xi_i$,\n", - "we bound the total amount by which predictions fall on the wrong side of their margins.\n", - "\n", - "Misclassifications occur when $\\xi_i > 1$. Thus bounding the total sum by some value $C$ bounds in turn the total number of\n", - "misclassifications.\n", - "\n", - "\n", - "This has in turn the consequences that we change our optmization problem to finding the minimum of" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\cal{L}=\\frac{1}{2}\\boldsymbol{w}^T\\boldsymbol{w}-\\sum_{i=1}^n\\lambda_i\\left[y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b)-(1-\\xi_)\\right]+C\\sum_{i=1}^n\\xi_i-\\sum_{i=1}^n\\gamma_i\\xi_i,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "subject to" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b)=1-\\xi_i \\hspace{0.1cm}\\forall i,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with the requirement $\\xi_i\\geq 0$.\n", - "\n", - "Taking the derivatives with respect to $b$ and $\\boldsymbol{w}$ we obtain" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial \\cal{L}}{\\partial b} = -\\sum_{i} \\lambda_iy_i=0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial \\cal{L}}{\\partial \\boldsymbol{w}} = 0 = \\boldsymbol{w}-\\sum_{i} \\lambda_iy_i\\boldsymbol{x}_i,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\lambda_i = C-\\gamma_i \\hspace{0.1cm}\\forall i.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Inserting these constraints into the equation for $\\cal{L}$ we obtain the same equation as before" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\cal{L}=\\sum_i\\lambda_i-\\frac{1}{2}\\sum_{ij}^n\\lambda_i\\lambda_jy_iy_j\\boldsymbol{x}_i^T\\boldsymbol{x}_j,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "but now subject to the constraints $\\lambda_i\\geq 0$, $\\sum_i\\lambda_iy_i=0$ and $0\\leq\\lambda_i \\leq C$. \n", - "We must in addition satisfy the Karush-Kuhn-Tucker condition which now reads" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "5\n", - "0\n", - " \n", - "<\n", - "<\n", - "<\n", - "!\n", - "!\n", - "M\n", - "A\n", - "T\n", - "H\n", - "_\n", - "B\n", - "L\n", - "O\n", - "C\n", - "K" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\gamma_i\\xi_i = 0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "y_i(\\boldsymbol{w}^T\\boldsymbol{x}_i+b) -(1-\\xi_) \\geq 0 \\hspace{0.1cm}\\forall i.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Kernels and non-linearity\n", - "\n", - "The cases we have studied till now, were all characterized by two classes\n", - "with a close to linear separability. The classifiers we have described\n", - "so far find linear boundaries in our input feature space. It is\n", - "possible to make our procedure more flexible by exploring the feature\n", - "space using other basis expansions such as higher-order polynomials,\n", - "wavelets, splines etc.\n", - "\n", - "If our feature space is not easy to separate, as shown in the figure\n", - "here, we can achieve a better separation by introducing more complex\n", - "basis functions. The ideal would be, as shown in the next figure, to, via a specific transformation to \n", - "obtain a separation between the classes which is almost linear. \n", - "\n", - "The change of basis, from $x\\rightarrow z=\\phi(x)$ leads to the same type of equations to be solved, except that\n", - "we need to introduce for example a polynomial transformation to a two-dimensional training set." - ] - }, - { - "cell_type": "code", - "execution_count": 2, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "data": { - "image/png": "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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter5_109_0.png" - }, - "needs_background": "light" - }, - "output_type": "display_data" - } - ], - "source": [ - "import numpy as np\n", - "import os\n", - "\n", - "np.random.seed(42)\n", - "\n", - "# To plot pretty figures\n", - "import matplotlib\n", - "import matplotlib.pyplot as plt\n", - "plt.rcParams['axes.labelsize'] = 14\n", - "plt.rcParams['xtick.labelsize'] = 12\n", - "plt.rcParams['ytick.labelsize'] = 12\n", - "\n", - "\n", - "from sklearn.svm import SVC\n", - "from sklearn import datasets\n", - "\n", - "\n", - "\n", - "X1D = np.linspace(-4, 4, 9).reshape(-1, 1)\n", - "X2D = np.c_[X1D, X1D**2]\n", - "y = np.array([0, 0, 1, 1, 1, 1, 1, 0, 0])\n", - "\n", - "plt.figure(figsize=(11, 4))\n", - "\n", - "plt.subplot(121)\n", - "plt.grid(True, which='both')\n", - "plt.axhline(y=0, color='k')\n", - "plt.plot(X1D[:, 0][y==0], np.zeros(4), \"bs\")\n", - "plt.plot(X1D[:, 0][y==1], np.zeros(5), \"g^\")\n", - "plt.gca().get_yaxis().set_ticks([])\n", - "plt.xlabel(r\"$x_1$\", fontsize=20)\n", - "plt.axis([-4.5, 4.5, -0.2, 0.2])\n", - "\n", - "plt.subplot(122)\n", - "plt.grid(True, which='both')\n", - "plt.axhline(y=0, color='k')\n", - "plt.axvline(x=0, color='k')\n", - "plt.plot(X2D[:, 0][y==0], X2D[:, 1][y==0], \"bs\")\n", - "plt.plot(X2D[:, 0][y==1], X2D[:, 1][y==1], \"g^\")\n", - "plt.xlabel(r\"$x_1$\", fontsize=20)\n", - "plt.ylabel(r\"$x_2$\", fontsize=20, rotation=0)\n", - "plt.gca().get_yaxis().set_ticks([0, 4, 8, 12, 16])\n", - "plt.plot([-4.5, 4.5], [6.5, 6.5], \"r--\", linewidth=3)\n", - "plt.axis([-4.5, 4.5, -1, 17])\n", - "plt.subplots_adjust(right=1)\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Suppose we define a polynomial transformation of degree two only (we continue to live in a plane with $x_i$ and $y_i$ as variables)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "z = \\phi(x_i) =\\left(x_i^2, y_i^2, \\sqrt{2}x_iy_i\\right).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "With our new basis, the equations we solved earlier are basically the same, that is we have now (without the slack option for simplicity)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\cal{L}=\\sum_i\\lambda_i-\\frac{1}{2}\\sum_{ij}^n\\lambda_i\\lambda_jy_iy_j\\boldsymbol{z}_i^T\\boldsymbol{z}_j,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "subject to the constraints $\\lambda_i\\geq 0$, $\\sum_i\\lambda_iy_i=0$, and for the support vectors" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "y_i(\\boldsymbol{w}^T\\boldsymbol{z}_i+b)= 1 \\hspace{0.1cm}\\forall i,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "from which we also find $b$.\n", - "To compute $\\boldsymbol{z}_i^T\\boldsymbol{z}_j$ we define the kernel $K(\\boldsymbol{x}_i,\\boldsymbol{x}_j)$ as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "K(\\boldsymbol{x}_i,\\boldsymbol{x}_j)=\\boldsymbol{z}_i^T\\boldsymbol{z}_j= \\phi(\\boldsymbol{x}_i)^T\\phi(\\boldsymbol{x}_j).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "For the above example, the kernel reads" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "K(\\boldsymbol{x}_i,\\boldsymbol{x}_j)=[x_i^2, y_i^2, \\sqrt{2}x_iy_i]^T\\begin{bmatrix} x_j^2 \\\\ y_j^2 \\\\ \\sqrt{2}x_jy_j \\end{bmatrix}=x_i^2x_j^2+2x_ix_jy_iy_j+y_i^2y_j^2.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We note that this is nothing but the dot product of the two original\n", - "vectors $(\\boldsymbol{x}_i^T\\boldsymbol{x}_j)^2$. Instead of thus computing the\n", - "product in the Lagrangian of $\\boldsymbol{z}_i^T\\boldsymbol{z}_j$ we simply compute\n", - "the dot product $(\\boldsymbol{x}_i^T\\boldsymbol{x}_j)^2$.\n", - "\n", - "\n", - "This leads to the so-called\n", - "kernel trick and the result leads to the same as if we went through\n", - "the trouble of performing the transformation\n", - "$\\phi(\\boldsymbol{x}_i)^T\\phi(\\boldsymbol{x}_j)$ during the SVM calculations.\n", - "\n", - "\n", - "\n", - "Using our definition of the kernel We can rewrite again the Lagrangian" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\cal{L}=\\sum_i\\lambda_i-\\frac{1}{2}\\sum_{ij}^n\\lambda_i\\lambda_jy_iy_j\\boldsymbol{x}_i^T\\boldsymbol{z}_j,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "subject to the constraints $\\lambda_i\\geq 0$, $\\sum_i\\lambda_iy_i=0$ in terms of a convex optimization problem" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{1}{2} \\boldsymbol{\\lambda}^T\\begin{bmatrix} y_1y_1K(\\boldsymbol{x}_1,\\boldsymbol{x}_1) & y_1y_2K(\\boldsymbol{x}_1,\\boldsymbol{x}_2) & \\dots & \\dots & y_1y_nK(\\boldsymbol{x}_1,\\boldsymbol{x}_n) \\\\\n", - "y_2y_1K(\\boldsymbol{x}_2,\\boldsymbol{x}_1) & y_2y_2(\\boldsymbol{x}_2,\\boldsymbol{x}_2) & \\dots & \\dots & y_1y_nK(\\boldsymbol{x}_2,\\boldsymbol{x}_n) \\\\\n", - "\\dots & \\dots & \\dots & \\dots & \\dots \\\\\n", - "\\dots & \\dots & \\dots & \\dots & \\dots \\\\\n", - "y_ny_1K(\\boldsymbol{x}_n,\\boldsymbol{x}_1) & y_ny_2K(\\boldsymbol{x}_n\\boldsymbol{x}_2) & \\dots & \\dots & y_ny_nK(\\boldsymbol{x}_n,\\boldsymbol{x}_n) \\\\\n", - "\\end{bmatrix}\\boldsymbol{\\lambda}-\\mathbb{1}\\boldsymbol{\\lambda},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "subject to $\\boldsymbol{y}^T\\boldsymbol{\\lambda}=0$. Here we defined the vectors $\\boldsymbol{\\lambda} =[\\lambda_1,\\lambda_2,\\dots,\\lambda_n]$ and \n", - "$\\boldsymbol{y}=[y_1,y_2,\\dots,y_n]$. \n", - "If we add the slack constants this leads to the additional constraint $0\\leq \\lambda_i \\leq C$.\n", - "\n", - "We can rewrite this (see the solutions below) in terms of a convex optimization problem of the type" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{align*}\n", - " &\\mathrm{min}_{\\lambda}\\hspace{0.2cm} \\frac{1}{2}\\boldsymbol{\\lambda}^T\\boldsymbol{P}\\boldsymbol{\\lambda}+\\boldsymbol{q}^T\\boldsymbol{\\lambda},\\\\ \\nonumber\n", - " &\\mathrm{subject\\hspace{0.1cm}to} \\hspace{0.2cm} \\boldsymbol{G}\\boldsymbol{\\lambda} \\preceq \\boldsymbol{h} \\hspace{0.2cm} \\wedge \\boldsymbol{A}\\boldsymbol{\\lambda}=f.\n", - "\\end{align*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Below we discuss how to solve these equations. Here we note that the matrix $\\boldsymbol{P}$ has matrix elements $p_{ij}=y_iy_jK(\\boldsymbol{x}_i,\\boldsymbol{x}_j)$.\n", - "Given a kernel $K$ and the targets $y_i$ this matrix is easy to set up. The constraint $\\boldsymbol{y}^T\\boldsymbol{\\lambda}=0$ leads to $f=0$ and $\\boldsymbol{A}=\\boldsymbol{y}$. How to set up the matrix $\\boldsymbol{G}$ is discussed later. Here note that the inequalities $0\\leq \\lambda_i \\leq C$ can be split up into\n", - "$0\\leq \\lambda_i$ and $\\lambda_i \\leq C$. These two inequalities define then the matrix $\\boldsymbol{G}$ and the vector $\\boldsymbol{h}$.\n", - "\n", - "\n", - "\n", - "## Different kernels and Mercer's theorem\n", - "\n", - "There are several popular kernels being used. These are\n", - "1. Linear: $K(\\boldsymbol{x},\\boldsymbol{y})=\\boldsymbol{x}^T\\boldsymbol{y}$,\n", - "\n", - "2. Polynomial: $K(\\boldsymbol{x},\\boldsymbol{y})=(\\boldsymbol{x}^T\\boldsymbol{y}+\\gamma)^d$,\n", - "\n", - "3. Gaussian Radial Basis Function: $K(\\boldsymbol{x},\\boldsymbol{y})=\\exp{\\left(-\\gamma\\vert\\vert\\boldsymbol{x}-\\boldsymbol{y}\\vert\\vert^2\\right)}$,\n", - "\n", - "4. Tanh: $K(\\boldsymbol{x},\\boldsymbol{y})=\\tanh{(\\boldsymbol{x}^T\\boldsymbol{y}+\\gamma)}$,\n", - "\n", - "and many other ones.\n", - "\n", - "An important theorem for us is [Mercer's\n", - "theorem](https://en.wikipedia.org/wiki/Mercer%27s_theorem). The\n", - "theorem states that if a kernel function $K$ is symmetric, continuous\n", - "and leads to a positive semi-definite matrix $\\boldsymbol{P}$ then there\n", - "exists a function $\\phi$ that maps $\\boldsymbol{x}_i$ and $\\boldsymbol{x}_j$ into\n", - "another space (possibly with much higher dimensions) such that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "K(\\boldsymbol{x}_i,\\boldsymbol{x}_j)=\\phi(\\boldsymbol{x}_i)^T\\phi(\\boldsymbol{x}_j).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "So you can use $K$ as a kernel since you know $\\phi$ exists, even if\n", - "you don’t know what $\\phi$ is. \n", - "\n", - "Note that some frequently used kernels (such as the Sigmoid kernel)\n", - "don’t respect all of Mercer’s conditions, yet they generally work well\n", - "in practice.\n", - "\n", - "\n", - "## The moons example" - ] - }, - { - "cell_type": "code", - "execution_count": 3, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "data": { - "image/png": "iVBORw0KGgoAAAANSUhEUgAAAZkAAAEXCAYAAAB/HzlmAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjMuMywgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/Il7ecAAAACXBIWXMAAAsTAAALEwEAmpwYAAAgJ0lEQVR4nO3df5Ac5X3n8fdXrI1krUmQrVrZyQmHMsKBhB8FuVzZgHbjijmH4qCAVBkwgSoTYVSUwYTLGQ4VMuKS4BgTnCgUuABZ9kGhsmWHACGcXbsIDHV34gCDiKOycYSxdjFIWNIqtpaVvvfHzMqj2Z7Z+dFP99Pdn1dVl3Z6eqa/6pnpbz8/+nnM3REREQlhXt4BiIhIeSnJiIhIMEoyIiISjJKMiIgEoyQjIiLBKMmIiEgwSjIiIhJMFEnGzK4ys81mts/M1rXZ7jIz229mkw3LcGaBiohIVwbyDqBuO3ALcCawYI5tn3H308KHJCIi/Yoiybj7RgAzOxX4zZzDERGRlESRZLp0spm9CewEvgb8pbtPJ21oZiuAFQDz588/ZenSpdlF2aMDBw4wb14UtZhtKc70FCFGUJxpK0qcW7dufdPdF/f8Bu4ezUKtymxdm+ePBn6LWlvS7wIvA9d38t7Lli3zIhgdHc07hI4ozvQUIUZ3xZm2osQJbPY+zuvxp9EG7v6Ku//Y3Q+4+4vAzcAFecclIiLJCpVkEjhgeQchIiLJokgyZjZgZvOBw4DDzGy+mc1qLzKzj5vZUP3vDwGrgH/INloREelUFEkGuBH4BfA54JP1v280s6X1e2FmWuw/CnzfzPYCjwIbgb/II2AREZlbFL3L3H01sLrF04MN210HXJdBSCIikoJYSjIiIlJCSjIiIhKMkoyIiASjJCMiIsEoyYiISDBKMiIiEoySjIiIBKMkIyIiwSjJiIhIMEoyIiISjJKMRGnJEjCbvSxZkndkItINJRmJ0uuvd7deROKkJCMiIsEoyYiISDBKMiIiEoySjIiIBKMkI1EaGupuvYjEKYqZMUWaTUzkHYGIpEElGRERCUZJRkREglGSERGRYJRkREQkGCUZqTyNkyYSjpKMVJ7GSRMJR0lGRESCUZIREZFglGRERCQYJRkREQlGSUYqT+OkiYSjscuk8jROmkg4KsmIiEgwSjIifdCNnCLtKclIFIp6staNnCLtKclIFHSyFimnKJKMmV1lZpvNbJ+ZrZtj28+a2YSZ7Taze83s8IzCFBGRLkWRZIDtwC3Ave02MrMzgc8BHwWOAo4GPh88OhER6UkUScbdN7r7t4Edc2x6KXCPu29x97eANcBlgcMTEZEembvnHcNBZnYL8JvuflmL518A/sLdH6w/fi/wBvBed5+VoMxsBbACYPHixads2LAhVOipmZycZHBwMO8w5pR2nCMjwy2fGx0d6/l9Qx/P8877MG+99c5Z6488coqNG5/u6D2q+pmHojjTNTIy8qy7n9rzG7h7NAu1KrN1bZ7/EfCfGx6/A3DgA3O997Jly7wIRkdH8w6hI/3GOTTkDnMvQ0P5xtmPVv/H5v9TVT7zrCjOdAGbvY/zehTVZV2YBI5oeDzz954cYpE+tOs11nhKLvLd+P30mCtql26RZkVLMluAExsenwi87glVZVIdZTwhq0u3lEUUScbMBsxsPnAYcJiZzTezpHHV1gOfMrPjzOzXgRuBddlFWi5Znpyb95WmkCfkMiYwkSxFkWSoJYtfUOue/Mn63zea2VIzmzSzpQDu/hjwBWAUeBXYBtyUT8jFl+XVclGvwFWiEOlPFKMwu/tqYHWLpw/pfuHuXwK+FDgkERFJQSwlGSmgUFVJZamK0jw1IpGUZKSYQlUllaUqqp+ecUNDycdBCUqKRiWZCpopgZRFGUsMExPJdw4VuUu3VJOSTAXNVVIIcXIOecIPeUIOncCWLKmNdqAebFJWqi6TQ4QaZWjmhL9kSbGqw0KXHNodiyIdJ5FWVJKRTOnEKVItSjJyiG6qakJVJRW5LUVEDqXqMknUSYkj7aqktKvqalVzw7PWDw2pAb1Zq2pMHSvpl0oyFVSVkoLu1u+cjpWEoiRTQY29sSRf7RJ+VS4GpNyUZCRTZbynpVk3IyFMTNQmZdM9MVJWapORTJX9xNmui7aqnqSKVJKpuBhLFkUeXl+JRORQSjIVNXMibz4pDg3lX1WTVkkgjQRa5ITXjRgvNqQclGQqqt2JvCwn0FbtHd0k0KpUfWmsNAlFSUZmKdsJdC7je8ZZvm45E5PVOaNWpYQm+VOSkcpbs2kNT736FGueWBN0P0lVT60GyAx9sq9KCU3ypyQjlTa+Z5z7nr+PA36A+56/r+/STLu2jaSqJ53speyUZCQ6WTZCr9m0hgN+AID9vr/v0ozaNkQOpSRTUTH3GsrqRD1TipnaPwXA1P6pWaWZUAmvbBPHVV0V2/U6pSRTURMT6rbaWIqZ0VyaCZXwsq4Oa27ol3Rl1a5XREoyFVb1qp1nXnvmYClmxtT+KZ5+7emcIgqn06RWlQuMNKXdrlc2GlZGKuu5K57LO4SWsjzZa6DU/iS16609a23OUcVDJRmRyFSpNFl0nbTrVZ2SjIhIjzpp16s6JRmRHFS900VZVKldr1dqkxHJQWN12NjYGMPDw0H3NzTUenpl6V3M7XqxUJIRqQC18UheVF0mIiLBKMmIiEgwSjIiIhKMkoxICWh+GImVkoxICWjKAIlVNEnGzBaZ2bfMbK+ZbTOzi1pst9rM3jazyYbl6KzjleJpHClXo+aKZCOmLsxrgSlgCDgJeMTMXnD3LQnbPujun8wyOCm+xpFyHT/4t8aZEgknipKMmS0EzgdWufukuz8FPARckm9kvVMdeVwaR8q99/l7ufe5ezVqrkgGzCMYgtXMTga+5+7valh3HbDc3c9u2nY18FlgPzAO/J2739nifVcAKwAWL158yoYNG8L8BxKMjAy3fG50dKzlc5OTkwwODnLeeR/mrbfeOev5I4+cYuPG/IesmIkzdjNx3r71dh6deJRpn8aoTajiOAM2wFnvO4trjrkm9xj7MTIy3PK5dt+3bhTtM49dUeIcGRl51t1P7fkN3D33BTgdmGha96fAWMK2xwHvBw4DPkwt0Vw41z6WLVvmWUqeqaW2tDM6OtrX67MyE2cstu/e7mfcd4aP7xk/ZP3o6Khv373d598y31lN4rLglgWzXpelNI7l0FDyd2VoqP/4ZsT2mbeiONMFbPY+zu9RVJcBk8ARTeuOAPY0b+juL7v7dnff7+5PA3cAF2QQY5RULVfTbmbCpJFyG5Vh1NyqT0An8YolyWwFBszsmIZ1JwJJjf7NHKjshLLtuq5WJeHMNTNh0ki5jTRqrkg4UfQuc/e9ZrYRuNnMLqfWu+wcatVhhzCzc4BNwM+B3wM+A9yQWbAFVPZ7JeaamVAj5YrkJ5aSDMBKYAHwM+AB4Ep332Jmp5vZZMN2nwB+SK0qbT1wq7t/NfNo56D5QrKhmQlF4tZxkjGzx83Mzez8pvVmZuvqz/1Vr4G4+053P9fdF7r7Une/v77+SXcfbNjuQnd/j7sPuvuH3P3Lve4zpH7ryJWkOqOZCUXi1k1J5r8CB4A1ZnZYw/ovApcCd7v759IMrsrUkNsZzUwoEreO22Tc/QUz+xq1hHIJsM7MbgCuBTYAV4YJUdppNeNhVai9pRiWLGk9M6cunMqt2zaZVcAvgZvM7CrgfwD/DFzi3qaPqATTWOJRFZvESgN4EuV4eVnE1FWScfefAH8DfAD4W+Bp4Dx3P6S+wsyuN7P/a2a7zewNM/tHM/udlGIuhVb3t5x33qwOdR1TFZuEMPNdHRkZrvS9WP1qdy9XXrKIqZfeZW80/P0pd//3hG2Ggb+n1gX5D4Bp4DtmtqiH/ZVSqyu4pKFkRPrVz027KoX0b657uZK2D13C6DamXnWVZOrD738RmInm6qTt3P1Md7/P3V9y9xepteEsBj7ST7AikmyuJKJEka+ke7nm2j50CaPbmHrVTRfmPwLWAS8BJwD/ClxuZsd28PJ31/f1Vg8xisgclETi1eperp1TO9tuH7KEkeX9ZR0lGTM7DfgG8Bpwpru/AdxIrXfarR28xR3A88AzvYUpIkVW5U4pre7lWr9t/ZzbhyphZHl/2ZxJxsxOAh4GdgF/6O7jAO7+DWAzcI6Znd7m9V8CTgPOd/f9aQQtIsVS5U4pre7l2rJr9tCMWZUwsry/rO19Mmb2QeAxaoNQnunuP2ra5HrgfwF/DfynhNffTm0YmBF3fyWViEui1f0tRx45BajxX+LR6rtahVJIGmbu5Vr5yEruevYuPn3Kp1l71lrGxsZmbduuhJHmDK5Z3l/WtiTj7j909yXufqS7fz/h+e+4u7l7UoK5A7gQ+AN3/0F6IZdDqyu7GCYkK7oY70fIWz/VVTPf1dHRscqVQtLSaTtLGUewCDIKs5mtpdaj7FzgLTOb6Sg56e6TLV8okoLGnjl/vPCP8w4nE3OVNpQQ8pXUzpL03SzjCBahRmFeSa1H2XepzVw5s1wXaH8iwOwrxlY9eMqmym0eseu2d1nZBEky9Sq0pGV1iP3FTDNXZqv5irFVDx6RrHTbu6xsYppPppR0/0J2kq4YH5t4TG0zkqtuepeVURQzY4qkIaueOZJMIy0na9XOktS7rIxUkpHSSLpinPbpQvfMKRKV2iWJSjJSGklXjGNjYwwPD2cfjIgAKsmIiEhASjKBVXnMJhERVZcFVuUGTxERlWRKTvfpSFZUapckSjIlV4UePxqrrL2sLjQ06oAkUZKRwotx7vSYVOFCQ+KlJJMxVV+lK6t5ykWkN0oyGdNVZbqymqdcRHqjJCOFleU85SIhVKE9UUmm5Mrc4yfLecql2GI9mVehPVFJpkNZtqWkua8y9/gp4yyCIZT5QqNTMZ7Md+zbUYn2RN2M2aEs21LUbtOZMs4iGEIZLij60dw5ZNXyVSwZzL+nzfpt62e1J5ZxtHCVZDKmq0qRbMXYOWR8zziPvf5YJdoTlWQyVubqK5HYxNo5pErtiUoyIpKLLNo5Yz2ZP/PaM0z79CHrpvZP8cS2J3KKKBwlGZEexNpbqUiyaHuMtXPIc1c8x+jyUfwmx29yrjz1SubZPJYftTzXuEKIJsmY2SIz+5aZ7TWzbWZ2UYvtzMxuNbMd9eVWM7PQ8WXZlqJ2m/j101tJCSo7z13x3METeeMSU6eRso9aEU2SAdYCU8AQcDFwp5kdn7DdCuBc4ETgBOBs4IrQwWXZlqJ2m7j1e1KIsTut5CfGjglpiiLJmNlC4HxglbtPuvtTwEPAJQmbXwrc5u6vuftPgduAyzILViqvn5NC2a9apTuxdkxIk7l73jFgZicD33P3dzWsuw5Y7u5nN227C/iYu//v+uNTgVF3f3fC+66gVvJh8eLFp2zYsCHg/yIdk5OTDA4O5h3GnKoa5459O7jo/1zE1IFf1fMfPu9w7v/9+1n0zkVzvv72rbfz6MSjTPs0AzbAWe87i8vfd3klj+XIyHDL50ZHx3p+3yJ9N7+y/SsHvw8zZr4X1xxzTX7BNRgZGXnW3U/t9fWx3Iw5COxuWrcLmJU46tvuatpu0MzMmzKmu98N3A1w7LHH+vDwcGoBhzI2NobiTE/aca58ZCU0tQC6Od99+7us/Vj7G+nG94zz+PceP3hCmfZpHv/Z4/zJUX9SyWM5NJTcyD80RF/76SbO8T3jfOKbn+DBCx5M5QbNbt5vbGyMV/3VWb3Mpn2abQe2FeI70YkoqsuASeCIpnVHAHs62PYIYLI5wYiM7xnn6uevTrXqoZ/eSq26067ftj61+IokhrbHtNvHun2/InRM6FcsSWYrMGBmxzSsOxHYkrDtlvpzc20nFbdm0xpe3PViqj3A+jkptEpQW3bp65uHtNvH1N6WLIok4+57gY3AzWa20Mw+ApwDfC1h8/XAtWb2G2b2fuDPgHWZBSuFMPODdzyaHmCtEtRXTv1KavuQzqXdq6vsvcR6FUWSqVsJLAB+BjwAXOnuW8zsdDObbNjuLuAfgReBl4BH6utEDlIPMGkn7V5dVegl1qtokoy773T3c919obsvdff76+ufdPfBhu3c3f/c3RfVlz9Xe4w06vcHn/YVqW6+jMv4nnFOufuUWe1j0weme/6sYx2+JgbRJBmRtPTzgw9xRaqbL+OyZtMaxifHZ7WPvX3g7Z6Hm4l1+JoYKMlI6YToAdZrgoi16i3LSfhiMvN5ACwYWMDzVzzP/IH5Bx//08X/1NP7VqGXWK+UZKR0Gn/wjYMQ9tMDrNcr0lgbg6s6MV7z53Hxxouj/HzKJJabMUWikOaVZ6uqt1hmZqyapM9jyxu/6j6uzycMlWSkVGJqZFdjcFySPo9m/TT+5yWm73wSJZkINNaPj4wMV6Z+PIS0GtnT+OGqMTguSZ9Hs34a//MSe8cSVZdFoKr142lrbmRftXxVz+/V+MNde1b7MclaUaNvXFp9HuN7xjn6y0fzy+lf9tX4n/Y4aJ3us/k7H1tVn0oyUhppNbLH2iMsTZoY71fS+t7kUaKItWNJIyUZKYVWjew7p3Z2/V5F+OH2K4bBKTsRur0hrfui8rgwKcooA0oyUgppjXBclB9uVYQuHaTVOSOPC5OidCxRkpFSSGuE46L8cKsgi9JBGp0z8rowKUrHEjX8R6Dd5E3SmVaNumNjY129T1F+uN3Ko1G6X0mlg147YbSSRueMdhcmacfbqCgdS5RkItBYD16UGSfLqig/3G6l0VsuS0W6kbWsFyZpUZIRKbkidHNtllfpoBdlvTBJi9pkROYQ+x3VcylibzmVDspDJRmRORStqqlRkaqdGql0UB4qyYi0UfQbM9VbTvKmJCPSRhGrmhqp2knypuoykRaKWtXUqGzVTkXsil11KsmItKCqpvjEPuKwzKYkI9KCqpriUvT2sapSdZlIC2WraspSiGqtLEYAkPSpJCNSMjHc15N2tZYGLi0uJRmRkun2BJ92UgpRraX2seJSkhEpqKTk0MsJPu1SR4hu32ofKy4lGZGCSkoO3Z7g0y51hKrWeu6K5/CbfNbSbbtZDFWJVaMkI9Kk2xNRHieupOTQywk+7VJH7NVa6gKdPSUZkSbdnohimdu92xN8iFJHr9VaWSRqdYHOh5KMSINuT0Qxze2+adumrk7wIUodvVZrZZGoiz5EUFEpyYg06PRENHPlff13r49mbvflRy3v6gQfS2N6p4m6n9KOukDnR0lGpK6bE9GaTWt4ctuTfP37Xy/s3O5pNab3q9PE3k9pJ/a2ojJTkhGp6/RENJOMHGe/759z+7TFkhzS0Gli77daMpZSWxVpWBmRuk5PREnJqN320lqn0yz3O6RMERNwWUSRZMxsEXAP8DHgTeB6d7+/xbargf8O7GtYfYK7vxI6Tim3Tk5EzVfeAAsGFvDK1a9o6PkedJLYQ0y50O/YappyoHOxVJetBaaAIeBi4E4zO77N9g+6+2DDogQjmVDdfro6qfoLccz77c2m+206l3uSMbOFwPnAKnefdPengIeAS/KNTGQ21e1nL+1j3m/7ju636Y65e74BmJ0MfM/d39Ww7jpgubufnbD9auCzwH5gHPg7d7+zxXuvAFYALF68+JQNGzak/x9I2eTkJIODg3mHMSfFmZ4ixAjJce7Yt4Ob/+VmbjruJha9c1FOkR1qruN5+9bbeXTiUaZ9mgEb4Kz3ncU1x1zT8fv3+/pO44zFyMjIs+5+as9v4O65LsDpwETTuj8FxlpsfxzwfuAw4MPUEs2Fc+1n2bJlXgSjo6N5h9ARxZmefmLcvnu7n3HfGT6+Zzy9gFoYHR2dtb8rH77S531+nq98eGXw/Xeq3fHcvnu7z79lvrOag8uCWxZ0fPz6fX2nccYE2Ox9nOODV5eZ2ZiZeYvlKWASOKLpZUcAe5Lez91fdvft7r7f3Z8G7gAuCPu/EIlT1m0DjfsrYrVRv+07apPrXvAk4+7D7m4tltOArcCAmR3T8LITgS2d7gKwtOMWiV3WJ/kd+3Ycsr88RjvoV7/tO2qT617uXZjdfa+ZbQRuNrPLgZOAc6hVhc1iZucAm4CfA78HfAa4IZNgReaQZdfWrKcjXr9t/SH7+/r3v37wZtQ0uhVnod/7ZXS/Tfdy711WtxJYAPwMeAC40t23AJjZ6WY22bDtJ4AfUqtOWw/c6u5fzThekURZVV9lPRbX+J5xHnv9sUP2l8doB1I8USQZd9/p7ue6+0J3X+oNN2K6+5PuPtjw+EJ3f4/X7o/5kLt/OZ+oRQ6VZfVV1m0D7UY5mKFqI0mSe3WZSFlkWX3Vqm3giW1PBNvftE/PWn/SkpNUhSRtKcmIpCDE0CftNJ/YVz6ykruevYvlRy1PfV8z+xsbG2N4eDjI+0t5RVFdJlJ0eXZtLWJXYqkOJRmRFOTZtbUsMz5mMQWzZE/VZSIpyKtdIutqupAae+aF7Iot2VJJRqTAynIHuqr8yktJRqTAynIHelmq/GQ2VZeJFFgZug+XqcpPZlNJRkRyVZYqP0mmJCMiuSpLlZ8kU3WZiOSqDFV+0ppKMiIiEoySjIiIBKMkIyIiwSjJiIhIMEoyIiISjJKMiIgEoyQjIiLBKMmIiEgwSjIiIhKMkoyIiASjJCMiIsEoyYiISDBKMiIiEoySjIiIBKMkIyIiwSjJiIhIMEoyIiISjJKMiIgEoyQjIiLBKMmIiEgwSjIiIhKMkoyIiASjJCMiIsHknmTM7Coz22xm+8xsXQfbf9bMJsxst5nda2aHZxCmiIj0IPckA2wHbgHunWtDMzsT+BzwUeAo4Gjg80GjExGRnuWeZNx9o7t/G9jRweaXAve4+xZ3fwtYA1wWMDwREenDQN4BdOl44B8aHr8ADJnZe9x9VpIysxXAivrDfWb2UgYx9uu9wJt5B9EBxZmeIsQIijNtRYnz2H5eXLQkMwjsang88/e7SSgJufvdwN0AZrbZ3U8NHmGfFGe6ihBnEWIExZm2IsXZz+uDVpeZ2ZiZeYvlqR7echI4ouHxzN97+o9WRETSFrQk4+7DKb/lFuBEYEP98YnA60lVZSIikr/cG/7NbMDM5gOHAYeZ2Xwza5X81gOfMrPjzOzXgRuBdR3u6u6+g82G4kxXEeIsQoygONNWiTjN3dMKpLcAzFYDNzWt/ry7rzazpcDLwHHu/mp9+2uB/wYsAL4JfNrd92UYsoiIdCj3JCMiIuWVe3WZiIiUl5KMiIgEU9ok082YaGZ2mZntN7PJhmU4tjjr2+cydpuZLTKzb5nZXjPbZmYXtdl2tZm93XQ8j84zLqu51cx21JdbzcxCxNRnnJkdu4R9d/ObyW0MwU7jzPl3fbiZ3VP/rPeY2fNm9vE22+f1u+44zl6PZ2mTDF2MiVb3jLsPNixj4UI7RFHGblsLTAFDwMXAnWZ2fJvtH2w6nq/kHNcK4Fxq3d5PAM4GrggUU5Jujl9Wx65ZR9/FnL+H0N1vO6/f9QDwE2A58GvUesJuMLMPNG+Y8/HsOM66ro9naZNMl2Oi5aYIY7eZ2ULgfGCVu0+6+1PAQ8AlofedYlyXAre5+2vu/lPgNjIa9y7W49esi+9irmMIFuG37e573X21u/+bux9w94eBHwOnJGye2/HsMs6elDbJ9OBkM3vTzLaa2ao29+rk6Xhq47XNODh2W+D9LgOm3X1r077blWTONrOdZrbFzK6MIK6kY9cu/jR1e/yyOHb9yOt72IsoftdmNkTte7Al4elojucccUIPxzPGE2keNgG/A2yj9oE/CEwDf5lnUAm6Grst5f3ublq3q77fJBuo3cD1OvD7wDfN7Ofu/kCOcSUdu0EzMw/fj7+bOLM6dv3I63vYrSh+12b2DuB/Al919x8kbBLF8ewgzp6OZyFLMpbymGju/oq7/7heXHwRuBm4ILY4CTR2WwdxNu93Zt+J+3X3l919u7vvd/engTtI4Xgm6CaupGM3mUGCSdr3zP5nxZnhsetHIcYQDPW77oaZzQO+Rq097qoWm+V+PDuJs9fjWcgk4+7D7m4tltPS2AXQd8+jAHHOjN02I5Wx2zqIcyswYGbHNO27VZF61i5I4Xgm6CaupGPXafz96uf4hTp2/QjyPcxApsfSzAy4h1pnj/Pd/e0Wm+Z6PLuIs1lHx7OQSaYT1sWYaGb28XpdJGb2IWAVh85bE0Wc9Dd2W8/cfS+wEbjZzBaa2UeAc6hd+cxiZueY2ZFW8x+BzxDgeHYZ13rgWjP7DTN7P/BnZHDsuo0zq2OXpIvvYi7fw27jzPN3XXcn8NvA2e7+izbb5Xo86TDOno+nu5dyAVZTy7SNy+r6c0upFVGX1h9/kVod+F7gFWrFwHfEFmd93bX1WHcD9wGHZxTnIuDb9WP0KnBRw3OnU6t6mnn8ALW65EngB8Bnso4rISYDvgDsrC9foD6sUp7HL89j1+l3MabvYTdx5vy7Pqoe1y/rMc0sF8d0PLuJs9fjqbHLREQkmNJWl4mISP6UZEREJBglGRERCUZJRkREglGSERGRYJRkREQkGCUZEREJRklGRESCUZIRCczMHq8PNnp+03ozs3X15/4qr/hEQtId/yKBmdmJwP8D/hX4XXffX19/G7XhRO529yxn6RTJjEoyIoG5+wvUBsP8beqzYZrZDdQSzAYgxonJRFKhkoxIBszsP1Ab8n+C2tTPfwv8M/Bf3H0qz9hEQlJJRiQD7v4T4G+AD1BLME8D5zUnGDM7w8weMrOf1ttqLss6VpE0KcmIZOeNhr8/5e7/nrDNIPAScDXQbg4SkUJQkhHJgJldRG0+jon6qquTtnP3R939Bnf/BnAgq/hEQlGSEQnMzP6I2kyHLwEnUOtldrmZHZtnXCJZUJIRCcjMTgO+AbwGnOnub1CbXncAuDXP2ESyoCQjEoiZnQQ8DOwC/tDdxwHqVWGbgXPM7PT8IhQJT0lGJAAz+yDwGLX508909x81bXJ9/d+/zjQwkYwN5B2ASBm5+w+BJW2e/w5g2UUkkg8lGZGImNkg8MH6w3nA0nq12053fzW3wER6pDv+RSJiZsPAaMJTX3X3yzINRiQFSjIiIhKMGv5FRCQYJRkREQlGSUZERIJRkhERkWCUZEREJBglGRERCUZJRkREglGSERGRYP4/nndhII9+6IwAAAAASUVORK5CYII=\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter5_129_0.png" - }, - "needs_background": "light" - }, - "output_type": "display_data" - }, - { - "name": "stderr", - "output_type": "stream", - "text": [ - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/svm/_base.py:976: ConvergenceWarning: Liblinear failed to converge, increase the number of iterations.\n", - " warnings.warn(\"Liblinear failed to converge, increase \"\n" - ] - }, - { - "data": { - "image/png": "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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter5_129_2.png" - }, - "needs_background": "light" - }, - "output_type": "display_data" - }, - { - "data": { - "image/png": "iVBORw0KGgoAAAANSUhEUgAAAqcAAAEoCAYAAABl61iUAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjMuMywgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/Il7ecAAAACXBIWXMAAAsTAAALEwEAmpwYAABZzElEQVR4nO3de3jU533n/fctCSENkpAQkrABCWLLYJCDlfq0GBsckrpOjGmaQxtqP7GfZt26l7fdzcbdJJtczWmbTVMnaRqvXW9TSJwqjxM72JjEdWwFXMBxgm3AAnMQmIM4iWEkkGSNNDrczx+jkYfRjDSH3+H+/eb7ui5dgDSHW8Poo+/vPiqtNUIIIYQQQpigwO0GCCGEEEIIESPFqRBCCCGEMIYUp0IIIYQQwhhSnAohhBBCCGNIcSqEEEIIIYwhxakQQgghhDCGFKdCCCGEEMIYUpwKIYQQQghjSHEqLqGUulEppZVSf+52W4QQwgmSe0KYRYpTkWjZ2J+77HoCpdQipdS/KaX2K6UuKqX6lVIHlFLfVkpdZtfz2kEp9Xml1M+UUm+P/XI7ZuFjB5RS/1Up9bJS6qxSKqKUCiqlnldK3a2Usv3nd+x7SvbRZ/dzC+Eg23MPMssLpVSBUuq/jWXjgFKqQyn1sFJqhp1ttIOd37ddr5Pkr7uK3G6AMM57gRGgzcbnmAdcBmwETgLDwDXA/cCfKKWu1Vqfs/H5rfR3QBfwBlBp1YMqpW4AniL6Wj0PfBsIAQuAjwNPABXA/7HqOSexDXg84XNDDjyvEE5xIvcgs7z4DvBXRHPyYeDqsX83K6U+oLUetbGdVrPz+7b8dZL8dZ8UpyLRMuCg1jps1xNorVuB1sTPK6X+A/gpcC/w91Y819jVbZHWOmLF4yVxhdb67bHn2guU5fqASqlm4CWgH1ihtX4l4etfBj4D7M71udL0ttb6xw49lxBusD33xqSVF0qppcB/AX6utf5o3OePAt8D/gRosaJBDmQk2PR92/E6Sf6aQYb185RSaplS6pmxYfULSqnHlVJlRHswd7vUrONjf1Zlc2el1DfHhjwWK6W+p5Q6RbRX9vcsa2GCWOBaRSk1nWiYTgfuTAzGsecc0Vp/K9nX7KKUKh57fwjhWW7nXgZ58UlAAd9N+Pz/JVo03Z3N87uRkWDr923p6yT5aw7pOc1DSqnVwGbgBPC/iP4Q/xnwS2AmSeZdjV1dz8rgabqmGk5RSpUQvYIuAZYA3xz70i8zeJ54zUAY2AQcAr5BdOhlb8LzWv69WOg+YDHwHa31a5ne2abv7WNEQ75QKRUEngS+qLW+mGn7hHCLKbmXpuuBUeB38Z/UWg8opXaPfT0bpmdkpt+31a+T5K8hpDjNM0qpOqJD57uB98eGsZRSTwBHx262O8ld6+O+no6FwLEpbvNp4J/i/n0MuFtrvS2D54nXDJQC/6K1nmxagB3fi1X+HNDAo1ne3+rv7XfAz4DDRH+JfQh4EFiplFqutfb9xHzhfYblXjouB85rrQeTfO0UsFwpVZzFULzpGZnp92316yT5awgpTvPP/yB6ZffX8fOrtNYXlVK/A24n+YrVs8AHM3ies2nc5hngANHe02bgLmB2Bs8xTik1b+y+O6YI3VjbrP5ecqaUmk107lub1ro9y4ex9HvTWt+Y8KkfKaXeJNrz9NdjfwphOpNyLx0BIFnBBTAQd5u0i1OPZGSm37dlr5Pkr1mkOM0/fwxs11r/LsnXioAOrXUo8Qta6wGik8Qto7U+SXS1PsAzSqmngZ1KqYDW+hsZPlzz2J8/SuN5Lf9eLNJAdP7UwWwfwKHv7VvA3wIfxsfhKHzFmNxLUz9Qm+JrJXG3yYQXMjLT79vK10ny1yBSnOYRpdQcosMg/1+Sr00D3gdsT3HfQqAmg6cLaq1HMmmf1vpNpdQu4C+JzoXKxPvG/vz1VDd04nvJUuHYn9OyfQCH/p+GlFKnybKXWwgnmZ57KZwGliilpicZsp5LdCg70yF9L2Rkpt+3la+T5K9BpDjNL7FNiVWSr91LdJV8qk2o5+PMHKRSMptQHtMMXASOpHFbp76XTB0hOrn/GqWU0lrrLB7D9u9tbCHbPODVTO4nhEu8kHuJdgK/D9xAdJ9LYPxn71rgP7J4TC9kZKbft5Wvk+SvQaQ4zS8dRLcN+YBSqiC2SlApNZfoMAGk3k7Fsrk0Sqk5WusJX1dK3QY0AVszeJ6YZuCNNAPFyDmnWuuQUuoXwBqim0j/Y+JtlFLvAX5fa/1Yioex8v+pOtlQJ/A1otnxXAbPI4RbjMi9DD0JfAH4r8QVXcB/JjqH8t+yeEwvZGSm37dlr5Pkr1lUdhcHwquUUv9CdPuUl4iegHEZ8MDYl2uBhVrrYza3YePY8/6a6N6mJUT32fsTovODVmmtd8fd/hjQoLVO1vOBUmoW0dM7/kFr/ZCdbU/y3PcQnasE0c2gi4meUgJwXGv9RMLtjzH59zKX6NX+e4AXgC1AkOjrdSvwAeDrWuu/TXZ/KymlvgPcNNaGE0QXrn0IuA34LXCbA5uWC5EzE3JvrB1p54VS6p+IrszeSHS7q9jJRzuI7jhwyRZEk2WLmxk59vx2ft9p317y10O01vKRRx9Eh7geJXrF1k/0OLk/B54Guh1qwyeI7jfYQXRFZZjoqv1/AuqT3P48cGqSx1tNdPuPT7rwem4de+5kH1sz/V7GbjMT+AqwB3hn7OMw0SvlvwCqHfre1hIN6FNj/0/vEO1h+gJQ4vRrLR/yke2HCbk31o6084LoHMj/TnSBzuDYz+G3gbIUj50yW9zMSAe+77RvL/nrnQ/pORVGU0q9l2hI/L9a6/VutycXfvpehBDmkGyZmrxG3iLHlwrT3U40UH7odkMs4KfvRQhhDsmWqclr5CFG9JwqpR4kumryGuAnWut7U9zuXuAHRIeBY+7UWm+1t4VCCGEeyU4hhB+Zslr/NPB1olc2pVPc9jda6xX2N0kIIYwn2SmE8B0jilOt9c8BlFLXEd2/SwghxBQkO4UQfmREcZqhZqXUeaALeAL4htZ6ONkNlVL3A/cDlJSU/N68ufU5PbFGo5Lu45zp44yibJ3u6/5UjWxY9fr6ibuvSfR9ZOL/yWSvix4dBYahsBCl7G27Bg63Hzmvtc7kVBi3OJad2qb3jrXZ6c2cTCS5mVxmr8ul7wU/v552vF/0yAiqQKMLQKn0fz7bJ8lOrxWn/0F0k/bjwFKiG/AOk+KoS63148DjAIuuep9+/Hvbkt1sSv2h6DStqurCKW6ZnlDkDaqL3zf1DTMwHLp4yb8D1SUpbmmus5G9zClucrsZRnHjNVGh4Pjfi6srHH3udHVEDjK/eFHSr3Vt3kp5+Yt0f/JGaisbbW1HpCfE+665+7itT2INR7LT6qxMlGt2xuekFzMyGcnN5CZ7XeIzLsbUrLPaZNmZrXDLRgLL2un84OKMMrep4Y6U2emp4lRr/XbcP9uUUl8FHiLzc9jTEgtasC9sc+GHglSYwwtF6VRC7d3MCB7j+KI+vPkd2MPu7PRSVkpO5o9kRSh4N99MpQYvTn2jDHmqOE1Ck/y85JzZ3QOQLSlIhdX8UJQCBFvbCBx5jrPNHUxbstSRXlMPsyw7vZCVkpP+lqwIVaVDgLczzVMqA5Y+nBHFqVKqiGhbCoFCpVQJMJw4H0opdQfRs4E7lVKLgS8BP7OyLab2AEjQCqv5pSiFaGFa0rGFYHMHgbV32F6YxujZ1Y48TypuZqcUpcJJqXpBYxIzTEUKPZ9rXtC96+CU24Rkw4jiFPgiEH9W7d3AV5RS/wq8BSzRWp8gegTbBqVUGdAJ/Bj4O6saYWLYStAKK/mpIE00fyH0LFroWGFqCMezUy7ghR2mKj7Bf5nldaH2bkp2Ps2h5hPMXNBEg4XZa0RxqrX+MvDlFF8ui7vdZ4HP2tEGkwpTCVlhpcTQ93PAD1dbO7RkOqez06ScBMlKL5Hi019i06jO3NbJzCVNNDSutvTxjShO3WRS2ErQCqvkU0EKUBgOQblzz+fx+aYZM623VLLSLFJ45p/CcIi5i8o4v6TC8sIU8rw4NaUwlaAVVsi3gjSRKg8AA449n9vzTZ0yOjwKuJ+TAHp4hOHeaF5KVjpDCk+Rip2Zm7fFqQmFqRSlIhf5vFdfvK7NW5l++hV2LupkGnk139Qxbhem41lZKllph0wXG4n8Fp+5FTXW95pCnhanbhemcvUvsiHF6EThlo0MDG2j67YRKlauzrfFUI4oKnLvtJzEC/ieiJ0n6/mXFJ/CKrHM7fnYDCqa7MvcvCpO3S5K5epfpCP+F4kqHUL1Rv8tv0AuFWrvprboEKEbiqi4dZUUpj4io0rZmawIlfwQuQq2tjGn6BCdfzCDBSvW2fpceVOcujlvSq7+RaJ0ezJkr76pjVxd72hhGukJ5c18U6dJUZqeVBewIEWosE9hOER5XSmqbobtz5U3xSm4W5hK0PpXOgsGEskvkNzN2P4sXZVBwP6gFPaSojS1qY7glAtY4ZRA8BjnLr8IVNn+XHlTnDo9b0rC1jzZFJHpkl8Ozgm1dzNafoGjDdsovfZyAjX1bjdJ5EAu4N8lZ8ELE4XauynZ8ignrjxC6YLLWWDD1lGJ8qY4dZKErXWsLCgl4L0v1N5NYOdWQrcHqLhuEXNvWuN2k0SWJCdlkaMwX6i9m+IdT0SPhl7ebMuepslIcWohCdv0JQvlxLlTMRLWIt7sukJOFxcx90YpTL0on0eVpBgVXlQZCNOzaCFzHSpMQYpTy0hhGvX762oIdU+c21s9c4gXHzkw/u9kgSxzp0Q6dPgibs0zzbeToayWbzmZbjG6ct285LlZNcLLLSdtaZsQmXD6aGgpTnOUb2GbKDF8Q91zkt4udHGaFJ7CMrrQvR0vZKV+5vIpJ7M5qS1ZYTrZ54VwQrC1jcCR5zh4m/MHnEhxmoN8ClyQyfrCfQV959xugsiQ33My348NFv4UbtnIQMHrvNMcomLlHY7vIy3FaRbyZc6UzI8SJgm1dzNj9294telVAvyx280RU/BzUSoFqfCzUHs39XWFhBoiBG51vjAFKU4zlk+BCxK6wgyx4aWzzR3MXN5Ewcgst5skJuHHnJSCVOST6Nx+XDt5T4rTDEjgCuG8UHs3ZZ2HKVr0DoG10av4jgMRt5slkvB7Rko+inwyPGu6a88txWma/BS6doZtddVIylWnQmSruqKP8OyZbjdDTEIyMnuSm8IkJsztl+I0DX4IXafCVrY9EbapdHYrk0SRnpCs1E/CD/kI7o4iSW4Kk+hTZxgo6Ha1DVKcTsLroSvDUUIIO3k9I0FyUoh4A+s3MFDwJm+vmUGg6XrX2iHFaQpeDV2ZQyr8pqDvHAMF3RwtDRKg3u3miDFezcgYKUqFuFS4ZSORyr1EVs5gwYp1rrZFitMkvBi6ErTCj2Kr9A/d1sm0ukbXVo6Kd3kxH2MkJ4VITQ1epHJZLYNNi91uihSnibwWvBK2wq+CrW0MnVxPsDnsyibQYiKv5WOM5KQQaXJ5bn+MFKdxvBS8+Ra2cvZ0/inrPEzgujl0fnCxFKYG8FI+xuRbTiaS3BTpCLV3M2P7sxxt2EZp6eUsqFztdpOkOI3xSvDma9jK2dP5Rw1enPpGwhFeyceYfM3JRJKbYirB1jZKOrZwtmk/geXNNDS6X5iCFKeAN4JXwlbkJUOGmPKZHh4xOhvjSU4KkbmShZ3jB5yYQorTMaaGr4StEMJNBUXK7SZMSXJSCH8pcLsBbhsOXTS+MC2urpDAFXmla/NWRoZOc7S00+2mANEN+IWZJCeFyE5sN5Tjl/e53ZQJ8rrn1NTCND5shcg34ZaNDAxto+u2ESqaVhsz1CSnQ5lFclKI7IVbNjJQ8DrvNIeM3A0lb4vT2DxT00jgJidnT+eHYGsbc4oOEbqhiCvv+s9uN0cYSIbw0ye5KZIJtrYxp+wMoSURAreaV5hCnhanJi6AkqJ0crLtSf4orytl5Go5CUpMpIaHAMnJdEluilQqLitF1c42sjCFPCxOpTAVQghviWWkKi+UnBTCArq/l+Fqc3dDybviFKQwzQey+bQ3FYZDUO52K4QpJgzhR8642Jr8INkpTJBXxalJ80z9UpSaGmSy+bR3nSu/CFS53QzhMr9kZCqSncItheEQ6vIAMOB2U1LKm62k9HB0ArgJvaZ+mjclQSasEm7ZyEBoE6cXRCitkTmn+czvhSlIdgp3jHZdYCC0iZ3lbUbnrBHFqVLqQaXUa0qpQaXUhilu+9+UUmeVUj1KqX9VSk1P93mMKEzzIHSFyESovZveDd/j2JzNjN5cxIIV64ydpG8ap7LTKSoURIWCsmepEBYLtXcTbtnI4LQLRNbMoGKlOdv0JWNEcQqcBr4O/OtkN1JK3Q58DlgNNADvAb6SzhOYcMrJ+KT+IrkyFiJm9MRJ6peWU3HdIubddZ/bzfEa27PTKXLhLoS9ysrOUBgo8UQHgBHFqdb651rrZ4CpjmH5FPADrfU+rXU38DXgXpubZwkJXiGE1fySnZKPQjhgoNftFqTNawuilgLPxv17D1CnlKrWWk8IZ6XU/cD9ALU1dZyN7HWmlYntGB6C0rEe08gZInqAjshBV9pivYaUX8n0e7TydamqnEP3hYmjllWVg5567f31XklueNkI+9SVDJReSceBSFr3iQzotG9rBT1aij7r3PPZwMjsjM2/V+Vjo0lTrMb318+DNdlp9Wsi2elPw3Uj9K+8CV1Q5mh2ZstrxWkZEL/kPvb3cpL0HGitHwceB1hy1TI9p7jJ9gYmis2fitcROcj84kWOt8UqqVaZxquuGsn4e7Tyddn2k7NJP79y3TzuWPv7Ez7v9grZVLz+XklHcE8bjUW72POBAuY3rk7rPh0HIsxfXGxzy94V6en1+vGlxmVnNr2lXv95sCM7rX5NJDv9qXvfQWa3v8qhjyxn/uLZbjdnSl4rTvuA+CSL/d3Ivur4Pfr8ZLJw3fv8cQdbkrlsVsiauuWLEBkwKjvzdRhfsjNKstN5pbt/w/m5PW43I21eK073AcuAn479exnQmWxYym35Gr7pSBVYVZVzUl61u0m2fLGXbLzvCGOyU7Ixe8mzs8HYYk+y032h9m5mbH+Wow3bKL32coqne+PnzojiVClVRLQthUChUqoEGNZaDyfc9EfABqXUvxFdpfpFYIOTbU2HW+Fr11VqOkNRmUj1WMnmOU1Frsz9QTbez47XstPUwtTr2ZnNc0h2+l+ovZvAzq2cbfotgeXNNDSu9sR8UzBktT7RoAwT3erk7rG/f1EpVa+U6lNK1QNorf8d+HtgC3ACOA78rTtNTs7N8LXrKtXkq1y5Mveu2L57hUObZeP97HkmO00tTEGyM53PC2+qruijqKqchjTn85vCiJ5TrfWXgS+n+HJZwm2/DXzb5iZlxeTwFcIkofZuinc8wbH6PVRct4gFN61xu0me5JXsTLYwVAjhjOFZxp23MSUjilM/8VoAWzm0o5S2qlm2qa4aSfn9CmdVziqi57pFzJXC1Nf8WphKdr77eSGsJsWpRbwawFYO7Wjt/ilcU8lmLpWEshDZ8WoupkOyc2qSne4q6DvndhOyJsWpBUzYMmrlunluNyFtqQKrqnLQhdZMTRYHCJE5LxSmVi9YspvXij3JTveE2rsp2fk0rzafYGad83u850qK0xyZMs90soDNNbhSBWK2UgVW9DSPzDZNtjqsJ/tlJatYLTbQC5jfYyQy54XCFKbu5fRCdma72bxkp38FW9sIHHmOYHMHM5c3eW4xFEhxagnTQzjXUIjd38ReBqsDb7Lvz7Tv3Q+GqwNuN0FYzISRJCtYsSm+ZOfUXxPWCrV3U9Z5mKJF7xBYewe1lY1uNykrpmwl5Ul+CeF0ScAIISZjykiSaSQ7hZNm1xVSPHum283IiRSnWfJSCDfd0ZByTmqqIZxshnZMnfckhLCflzIxHZPlJkh2CnPp8EWo9PaolAzr58BLIZzqyt2qoZ1ch8Ciw14NEz7v97lK+XpKi5dXkYqJ/FaYxkzW42lKdq771Mqkp+v5PUPyNTvzhfScZsHE4XyvX3nn62kl+fp9A+iyUrebICzg5cLU67kJqY999nuG5HN2Tqag7xyD/ac5WtrpdlNyIsVplkwL4pdbTloygT/fTfbLyg+/yISwg2l5mC7JTetIdrov2NpG8c6nOdh8GlVX59nFUCDD+hkzsdfUKV7bYy9eukNAMhwkRPryOQ8zIdkp7BZsbWMg+CSD749QcetqTxemIMVpVrzaS5ArL4ePDAGZI7YH36HbOpmGtwM0n3l5ON9pXs3OybbAkuw0S1nnYWqXVXD+6rlUe7wwBSlOM+KFXgI3r9BlgrqYSrhlI0ND2+h+f5Evru7zld8KU8nN5KQA9Z6RmnK3m2AJKU4zZGoYmxBwuVxhZ/vLwYTvOxdeHu7LVKi9m/q6QkINRcy76z63myNyZGoWZsrtDMm1Z7KqcjDlav1U3P6erZBP2ZmPpDhNk+m9ppMF3Mp184wPnJdbTmZ1DJ/Xh5xM/38RIpHpWZgpr2dnyw9fzrvcBMnORGrQ+3ubxpPiNANe7SnwUuBMJhg5x2cPP8jDV36f2cW1bjcnK37osRD5y2/D+VOxMztD7d2MnjgJTNzfOaZr89YpH2f4xjK6fjvxdiOl1dHnUV18dfrf87eD/4NZuoqa1ddk2WJ3SXbmFylO0+C3ngKveuzU93ijdyePnvoeX1r4dcsf34nw80OPhchv+VKY2inY2kZJxxamL+0D7kx5u7LLt035WH3Tbkl6O9U7AMD/KfodbYXtPDn9a3z68DWEW24B/muWLX9X/PC5ZKewmhSnaZJAdlcwco5ngj9Do3km+BQPzP2rjHpP05mfJOEnRGpykZ69UHv3+N/VwT0MhTbxztIw5ctXTHq/C3cum/Kxh0+VprxdaOAiz77wU/QoPFN8jDV3LOPi3s2kW5xOlpvxRadkp7u6Nm9lWlE3Z0u7CFDvdnMsIcWpsIydE9QfO/U9RhkFYJSRjHtPZdjHDDp8keFZyU+0EeaTi/TMhVs2UtK3n4rKaDbuWniUiuU1BJpWUV3ZSPXsQULnkyxomj2Y1m4Wg2cjKW/3z698H40GQKPZXBzm/7m9Gb6V+vF6N3yPyM33UN1YJbnpAcHWNoZCm+haPsK0ukbf7IAixekUvNJbkKowdEKsV+DnX+me5DZTP85w3Qih491UN1Zd8vlYr+mQHgJgSA+N955WV6UeTsrEynXzMrq9sF6wv4vPbv0GD6/6PLMDs9xujojjlRzMhtXZGcvDgr5zlO7+DccatlF67eWcr6sDYCZNNDSuHr/9y69vsey54wX7u3jm8IsMjQ4DMDQ6zDOHX+SBa9dRVf0O3aEZE+5TNbOH0NL91Gx5lOCJNRTUv5uLibkcI9npntj0kNPLh/imeovvzf2E202yjBSnafBCb8HLLScnnfdjl3DLRoojHVTOGnsrDfRm/iAl0X3Z+me+l9r9W7mwY3j8yh0u7TWNifWevtxizdxTOwv7yTayFu96bHcLb3Tu49HdLXxp+YNuN0ck8EIOZsOq7Ay1d1O84wlqA+Hxzx1ccZrAkuZLilGnPLa7hVGdkJt6lEd3t7DtjdQXf+cu3EGQ56k6+UNm7aqBknIudA0TPHFb0sVUkp3umr8Qvjb9BG1n3/ZVdkpx6iNODsGE2rsJ7NzKsTmbKa+vpqd29thXFMPVmW1nURTqAyAybYQTq/oYOniU6h1PjIfhnr43xntNY4b0EHv63rDiW7Fduvu85rNYL49Gj/fuSO+pIYaHfVuYxuSanV2bt1Jy+hWCzR10LV86/vmKGvcOmtgT3D/eaxozNDrMnuD+Se9XW9nIubVwIXiCC0TzWZ87T8GO9YRbbqF03Ufsa3QCyc6pddLHS+f2+i47pTidhJ+HsjIVK0Yhup9aydBpjl15hMDtzczLtVdgLLs7DkSYu3gN5xa3E+J5it86xsD69/JjPoGePpO+uitd2QbFzvDb+/xx2x7bS+J7eWK9O37pARD+E2xto6zzMBDNw4GCN+m6bYSKlXcYM+fvqbWPZH3f2spGiH0fY3+cZD3HTmxmQQv0X78q5TB/PMlO+3236FVGo9OKfZWdUpxOwe89BumInYXe2dxBUVX5+IKWQJ09w1WxK/f+K3ZyliMUdQ0CULBjm+NX7iCLqew22dw4P/QAeJ0qkmHVeOGWjQwUvM7gDRGAsTycQUXT9cYUpnaYd9d9HG9v5dgLm6nfsp/giTVTdhZIdtqre/AIPy17i2EdvQjwU3ZKcSom1bV5K0OhTQSbwwTWOtcrUFvZCCsufa5js1o4tnszC9dfpLf+98Y/X1A/L62reGGmyebG+aEHQPhDbE7pyfo9lNdXM/+Gj6DnVLrdLEc1NK7mXE09wWefp/it9XRtvgv4lNvNyls/DDw7vhtDjF+yU4rTFPJ9SL9710FKd/+Gwsq9RNbMINC0yvVegQUr1nG8rpWTb+2i4XR0+X9ffyFFO2YT4p6cClQ5p9l+BX3noLxswueznRsnhFNiq6JDS/dTsWgRc29ak1AS5I/4kS2e28Ss6R+la3Diz7Vkp/32FR0hwqWvs1+yU4rTSeTrkH73roMU73yaQ80nmLm8iQUurDRNJXblHtu0aujAAYYO7r9kAVU27Bx+ksJ3crnMjRPCbsHWNgaCT/LO0hDly1dQ3fg+t5vkutjI1jFa+Of5f0j94SsYuO0By0ewJDtT69q8lX87/Qecua2TipXuLbyzixSn4hJdm7cy/fQrnLmtk5lLmlzZAmUql/wQ3tRIqPoNQmyn+K1jrsxJnYrMu/K+4opqIudD6NnVbjdFOCS2CPT8nM2UX1dN+dVSmCaKjWYFy/eN741q5aJVyc7kwi0bGRjaNrYIz3+FKUhxKsaoC52ENz7PO2UH6PnYNCqavPOGr258H9WN7+PkpsxXkwrn6FNnOFX8GlDgdlOEmNLoiZNESndQcV10GF8kFxvNOlPZSuCV9Qysfy8l993rdrN8K9jaxpyyM4SWFFFxq/vT7ewivyUE3bsOEt74PIeaXmVk9TQWrFjnyTf8vLvuo+K6RRybs5mSLY8SbG1zu0mCaA9UuGUjA6FNXLyugEDT9W43SYgpFYZDBGZNZ9rixW43xXi1lY1cufYviKyZwdGGbQys3zB+UpawXvnMYVTtbE/+nk6X9JwmoULBvJlvGhvGj80vNXEYPxNzb1rDcHWAYPk+it9aT7D1Plf2RhXvCuzcykDVLkYbi1iwYp3bzRFiSt27DhIIHuP4oj7y4zeBNWLD/Edf2Eb9ltOWD/OLd2V62I3XSHGax4KtbQyFNtF12whzVn7IN1dhsWGmSNV2hsZONXFimH+yIxDzfe7UrKWXMXqF/JoX5rvkgn1Jk29y0SkNjas5DgTL91F45EmCrUxZoEp2ikQyrJ+nwi0bGTq5nsiaGb6cUF1b2ci8u+5j9OYijs3ZTGDnVtuHmVIdtSdnQwvhDcHWNgZCm6ILQn0wkuSWhsbVBNbegbouwkDwScItGye9vWSnSGRMcaqUmqWU2qiUekcpdVwplXT8Tyn1ZaXUkFKqL+7jPU631+vU4EXmXjeHgIGnmgT7u/jULx/ifH/XJX/Pxry77qO8vprqij6LWyky0tvrdgt8S7Izd7F50fEX7F4sTK3MzlzVVjZSevUy6q+RERMrFYZDqHJ/D+mDWcP6jwARoA64FviFUmqP1npfkts+qbW+28nG+Ym60Bn9S6WZb/DHdrfwRuc+Ht3dAjD+92xPvIgdt1rQdw6QFfxuGakpd7sJfiXZmYPYyU/Hxk5+8vK8aKuzM1exn3k1eNGV5xfeZURxqpSaAXwUaNJa9wHblVKbgHuAz7nauDR4ab5MqL2bGdufJzy3nbOlBQSod7tJl4ids67R0T+1Hv97tucFq7o6Xq3bwRU7O+jmo1Q1L7Kh5UI4T7LTGpWBMD0e3zLKjuy0wtHLeqmqPIdu2Shb/OUo2NpG4PQr7FzUyTTMGvG0mhHFKXAVMKy1PhT3uT3AyhS3X6OU6gLOAN/XWj+a7EZKqfuB+wFqa+o4G9k7ZUPU8BCUgoqkP9cl1N2Q4vOFdEQOTvh8RA9wyyfn0H1h+oSvVVUO0vLDl9N+7kwMD4xQEAgSuusyCiuuoHh6BYNnoeNsxJbny1RkQPP9rU8wMho9Zz0yMjT+tZHRUb619cc8+J6/yPhxC7iFGdcu48yiQab1nuVCsJeimXb04iV/HwBJ3wfpiOiBrO9ritH3X05B6SyGTpUwaNF7LTKg6Tjg7PtWj5aiDflZieNAdtba9h40ITuH60boX3kTkdICx99TVoj9LHz/beuzM3cNFM5u4PwfXGCkf4Diwb309FRTVJL4+1WycyqjXRcYWdJLzw03UlBWRsFISVbvVzeyMxumFKdlQE/C5y4CySqInwKPA53AjcDTSqkLWuufJN5Qa/342G1ZctUyPae4acqGqF5rt5GaXzyxl64jcjBpuAJ0X5ie9D5WCG5ro7LoV5z+wGWuz6cK9nfx2a3f4OFVnx+/ot/z5lleOv9rhnX0nHUdd3r1sB7mpfOtPLTq7ix7AGZz7kI7/Xt3Mv25d6iaZv1JUpMdtZft/2lH5KBt7wenhH+9kcCydjo/uNiy+c0dByLMX1xsyWOlK9LTa+IJUbZn59Kr3qvdeA86kZ2h9u7onsjNHRTNW8p8D8wzTczOjgMRSur7eOl3dmWnFWo59epz1Lw9zMWeNdSsXnLJVyU7Jxdq76Z2fyvHlxxj3ur7cnosN7IzG6YUp30wYTu5CmDCKgqt9Vtx/3xFKfWPwMeACQHrdVYPeRWGQ1AOpTXuD+XHz42KzYdqOfkko3o05X1G9WhO86fiz4M+ttv6k6RMm8Ih8oJkZ4J0czPY2kZJxxaCzR2o5Utdv2BPV7LsfGx3i63ZaYVpixejdv026dckO9Ojame73QTHmLJa/xBQpJSK71ZZBiSb0J9IA8qWVrlssu01mu5oYOW6eek/Vns300+/wvHL3V+1njg3KraadH/vQYZGh1Peb2h0mD3B/Tk//4IV66i4bhFFc19j9ISEovA0yc4EU+Vm0x0N3PKJyynrPExo6X7Kl6/wTGGaKjv3BPc7kp3CRQP5teOJET2nWut3lFI/B76qlPo00RWna4HlibdVSq0F/gO4AFwP/BXwBccaa5B094ALtrYxdHI9vc1hpi1Z6vrWUfFX+fFX9I8s+65jww3TFi+muOMA5b97HZATTIQ3SXZmp7t3GrPrCglVlVPd+D63m5O2ZNl576z7eWrtIy63LD26vITC0yG3m+FZfj8VKp4pPacAfwmUAueIDjM9oLXep5S6RSkV3933J8BhosNWPwK+qbX+oeOtjVNdNZLR550UG7oavbmIwNo7XO8hiF35x67yh0aHL+kBcNLRy6JXonIGtPA4yc4s6LC3tjdKlZ1dEe/k14ny8wSCxyRzxZTS7jlVSv0K+CDwMa3103GfV8B64FNEwy6r7Uu01l3AHyb5/Daik/5j//5kNo9vp2zmy0w2Adxq9UvL2Vs72/UeU0g+Nyq+B8AptZWNHK87wdmm31IjZ0DbSg1eNHZPXSdIdqbmdnbG9kD2glTZ2XLySZa9969calX6aisbCS85wdGObdRL5oopZDKs/xDwBvA1pdQzWutYEvwD0XB9PNtwzUdOTgDX/ebMVUk2N2p8PpTDC0kbGldzrqaeIM9TvW9LWmdAC5EFyU4L5evimVTZub/3gEstylxD42qOA8HyfZK5GVAH96DLSt1uhqPSLk611nuUUk8QDdN7gA1KqS8AnyG6RckD9jQxf6XqIciGKXNVJpsb5cbea7WVjZxadID5/dCeej2BZ5iyqbl4l2Sns6zMTZOkyk4v7FkZr6FxNadC/dRTzqHETdBcZGp2BlvbGApt4tDyEd9vvB8v0zmnXwIGgL9VSj0I/C/gBeAerSfZx0Jk5eWWk+x9/rjRc1r9wJTC3QqTrVT2OjfPCg/2d/Hpl7+ey3NLdjoklpuTZeesskEoL0v6NZGfTMvOUHs34ZaNDASfZPTmIipWrs56zYhb2ZnL82a0Wl9r3aGU+i7RY/H+CXgF+COt9SWXbkqpzwN/BCwCBoFXgc9rrac+oslnkl+NNWR0NSY9XvYqranntctbCbxyjHCL9ZvzZ+Pd982lJ6e4fRXvpvj9HZ2cnxx77l3nD/Ivr7fwuVsy3ytSsjMzqXqxqirnsO0nZ9N+nGQ/K7GN918NnGBm3dQHswjrDVcHbJtu5qfsnF1XSKghwvwbPoKurMz6cdzKzmR78qYrm9X6wbi//5nWuj/JbVYB/4fodibvB4aBl5RSbh1P4Rq3r8YKw7Jtx1RqKxupWLma0ZuLaH/PS4RbNlq+mnTlunnjeyzGf6Taq9bt941pEvd3TLVC2Y4egvjn3nQwp50lJDvTlOp9nup0qHQFW9vof/1hgs0dzFze5PruJWJqkp2g51RmfV+3sjPVnrzpyqjnVCm1jugk/rPAHOCvSTJfSmt9e8L97iF6pN7NwHMZtVDkTJUHiI4oilRqKxvhrkbUq89Rdu4MfSdOQoYnR002Z8mPgZkOdaHTksdJ3N8x1QrlXK7U033ubHpPJTvdF2rvpqzzMLUr5nL+iqs9tb+p30l22set7Ey1n3m60u45VUp9CNgA7AXeCxwEPq2USufw2vKx55LNzYTxKi7LblWkhGhyOpDb3L5k+zu+GGydcCWe65V6us+dae+pZKc5ZtcVQq85u5eIKMnO5HT4Yk7bnbmVnVbsZ55WcaqUWgE8BZwEbtdaB4EvEu15/WYaD/GPwG7gN2m3TAiXmLT1VqZMWzwX2r6f4UgHR0uz70GdbG/cVLdL9nUrn/tfXk/vsSU7zTRSU+52E4RhTMtOK7iVnek+72SmHNZXSl0LbCY6tPRBrfUZAK31U0qp14C1SqlbxjZ8Tnb/bwMrgBVx+/sJYaToyn3vLp42acJ/uGUjA0Pb6Fo+QkXT6qwPgUi2v+OwvvSs8FRX6g9cu47Zgeyna6bcl7dz6nPKJTuFmJxJayJMyk6ruJWdk+5nnqZJi1Ol1JXAvwOa6FX/kYSbfB54EfgWcFOS+3+H6JF5t2mt3067VT7i5ElQwhpBOik/8Trg3ubQXn/fBFvbKKraxWhjERW3rsrpdLLY/o5fe+X7/PTgL/nEog9x76z7mb+4ePw2k12p5zJ/Kn5vyUhPCD27Oq37SXbmJtX7v6py0IXWCDuo8kD0IF2LeT07Y9TBPQwU5Dabx63snGw/83RNWpxqrQ8Tnbyf6usvASrZ15RS/wj8MdFw9c4RFhZLdjXWETnI/OJ0ppv5X7C/i89u/QYPr/o8cSctuqa0pp5T13QSHtnGgpaZ9F+/iuoMF0Ylk2lgxt43Xn6vlAVGGL16GdUWHJubOCfqrms/znzqxr9uxZW6lSQ7c5OqF6sjcpDoLlsilp2fmffZS34W/CYfszM26nRobNQpF17LzpiMVuunSyn1CNGTUP4Q6FZKxUK6T2vdZ8dzCm9yc+/KZGorG2FFI6eKnqP9rZdYuKODEPekVaBOFqJ+HDJKh1Vz+6ZacWrFlboJJDtFumLZ2ULy1ddeItn5rnDLRiKlOxi9IfdRJ/BudtpSnAJ/OfZna8LnvwJ82abnFB4z1RWdm+betAZ4jspzRZxL8z75FqJOSbXi9KH+u3OaT2ooyU4xpfjs9MPPgmTnpSqvqmXw1sU5F6Zezk5bilOtddLhKr8z9WxeU6W7/5rIb3bNJzWRZOelJDuTy3UPSWEuNXjRssfycnZmc0KUSEH2aktfuvuvuW7Au9tKucnKVbjprDi1WyaLoUTmHM3O8nIKg979uU7MzmGd+R6SwnCVAUsexoTszJZdw/pCTMoLV3TRbaXecbsZKZne26TLSyx5nGRzojoORC5ZcSpEvvBCdprM9Ny0kpezU4pT4QovXdEV9J0Dcl+xbzXpqRciM+c7RxiInCEcOcq5mvKc5/S5wdTV1V5hcm4OrN9AsOwAI6XTCFDvdnNcJcWpcIVXruh0WXZHmQohzFLdWAWNH4EWCO/YRo9uhZV4rkBNzE4Tc1NkJtTeTWDnVo41bKP02ssJNF3vufel1WTOqRCTCBV1Urr7N4Ta5WjzdHVt3sq07l2cKD/vdlOEmKB03Ucoqb6Lq9qvoH/vTrebIwSjJ04SKd1BxXWLWLBiXd4XpiDF6QS6uoZIqCer+/rxbN581tC4movXFXC0YRslWx6VAjUNwdY2BkKb6LzpGNOWNErIirQ4nZ1q7mWUjJo3VUfkr8Cs6UxbvNjtZhhDhvUt5LfJ1AIWrFjH8bpWguX7qNu5lRDWnBjlR8HWNgJHnqP7/dZsHi3yh9PZOVpW6+jzCZFKqL2b8hOvc3xFHxVuN8YgUpx6UD6tNjRBQ+NqTu4/QXVFH/1uNyaOiWdIz11UxvmrK6QwFUZ6NzsbgGthbPpm9exBXn59i4stE04xKTeDrW2UdGzhbNN+pi1ZKrkZR4pTD8pkteFIaTW6901MmsEROxP64VWfN/6UipjhWdMZ7D+d1X3tupgw7UKkMBwCa04rFcIWKbPz/HSHW5IdL2ZnKrq3n5HSyfcOtiM7TcnNWGEaWrqfwNo7pDBNYE7FIvJG7EzoR3e3uN2UtKm6Oo4sPEbJlkcJtrZldF+Tty6xmiq3ZvNok0R6rDtQQIhceDE7c+H37Jy/EKYtWiiFaRLSc2qTya74frzhoAstMkP8mdDPHH6RB65d54kegIbG1ZyrqSfI8xQeeZJwy2FK133E7WYJh8jpUM6R7EzOq9kpJhc97EUkkp5Tm/j9ii9byc6E9oraykbKl6+g/hqZtp6oa/NW3gn/OzvL2yitye/No0VuJDuT83J2iksFW9sYOrme3YH9kpcpSHEqHJN4JvTQqPfOhB6pkUmV8ULt3Qys30Dh0GZGVk+jYuVqx4aogv1dfOqXD3nq/SPMde5Cu9tNSMkP2SmieRlu2Uhxzw8ZvbnItbmmXshOKU6TyGWvUyd4dT/Vyc6E9ho1eNHtJrguGDnHX/X8Gf3lR7nwiQWObx6db/PvRO5SZeTskouEgyccbk36/JSd+a6s7AzHb53B/yx6i4Jid6YLeSE7Zc7pJOzcsimXx87muYtC/eDynGvfnAldmdkcIZO2LrHSY6e+x5vDu3h05iB3c4ejz90Vkfl3JrMrO9d9aiXdFyaurE/3cZPdJtTeTe2ux3mbGVm3y26TZqeP3/a+zM6BXlrOv8YbF97i0d0tfGn5g44+vVeyU4rTSdg598nJeVUqUA4MWP64mUo8E9qrjpZ2UjPUQ9fmrcy6c9WUtzdl6xIrBSPn2HjuZ2g0T1fs50ORW2lw8PlbTj45Yf6dHSEvK/WzY1e+JStMrXjcngsj6Ff2cZzo4kfTTJadHQciDrbEWX7KzlB7NzO2P8u2BW38queAa8WhU9mZKxnWt4lXh97F5GorGwk0XU/wY2EGQpsYWL/B7Sa54rtvfQs9OgTAqFJsvujckGiwv4sXz/3asfl3slLfWU5nZ3VjFf1XrKFm13wuvrKX4+2ttjyPyF/B1jZKtjzK0YZtPPOeXjQKcH5qhtPZmQvpObXJZFd8HQ5f6PacCaOrznPuQrvsp2aB2spGWNHIMVo4unsbC1pm0n99/hxreuDXL/N86dMMFUSvvof1iKM9AI/tbmGU5PPvTOwBEJmZLDub7rCnf75m9TWE6udx1fZnOVm5y9geVOE9ofZuyjoP09ncwcB1jbS+vm1CcSjZOZEUpz5Xs/oa+loOU7DjMD26FVYiBapFFqxYx6mi5+g8+Cuqd3QQPHEbNauvcbtZE1g5/y/cspENs77HaML0PCcDbk9wP8PaB3OXhVGqG6voOriA6073sGeJ260RbrMyN6sr+ui8YjabL3akXNgm2XkpGdZPQVfXuN0Ey5Su+wgl1Xdx2ZY6el5uNXrLFCs4uU3G3JvWUL58BaGl+ynp2JLx6VFOsGL+X2wLlEjpDt6a3c1wwtW3kwH31NpHeP4/Pcve+57njxd9GIXijxd92DdzmoV7Rkqr6e0Mu90M1ziVnUWh/rG1EOayat60Orhn/OhrtxcFeyk7jek5VUrNAn4A/D5wHvi81nrCZAyllAL+N/DpsU/9C/A5rbW2uk3VM4cIXZw28fMWzH1yehXirDtX0bUZ6nu3ccGWZzBH/DYZ6V6N5nJmdXXj+xgInWJ+P7QPT317r6qu6CO8sJZ/+eBXjeh9t/vEHK8shjIyO23Kt6rKwZSr9a1QUD+Pd07U0f/CNo51dhJout6I97pTMs3OXHIzH3Rt3spAaBMHl48wra6Rp1aYUQR64bQxY4pT4BEgAtQB1wK/UErt0VrvS7jd/cAfAssADbwIHAUes7pBLz5ygOJqe04D8tMqRJNk+0OXTUEbL3oE3SiFYW8UNJkq6DsX/UuG22jZKdmJOVYPjXlkMZRx2WlXvrX88GXmFy+y5bEhOrRP470sXA9dHW/SE8qfqVDZZGeuuelXsZX5AwVvElkzgwrDLnKcyM5cGTGsr5SaAXwU+JLWuk9rvR3YBNyT5OafAh7WWp/UWp8CHgbudayxwmjZHPGXGMrZDGmV1tTz2uVHGAhtomvz1ozvb7LuXQcp3vk0r9bt4GhppxEhG9urzwurTu0k2WmPkvvupaT6Lup7Z7vdFMdkmp1W5KYfhdq7x1fmR9bMcPxwkql4JTtN6Tm9ChjWWh+K+9weYGWS2y4d+1r87ZYme1Cl1P1EewuoranjbGRvRo1SpUOoiPX7jkb0AB2Rg5Y/7lSGbyyjb9otDJ8qZfCseXvjRQZ0Tnv2dUW62HjoRYb0uz90G9tf5K6yjzOrOPVK+u+//QQjo9FQHhkd5Vtbf8yD7/mLDJ+9gYIr19E/t59I3wi9p19htKySopLc3j/WvFdSr3Ce6rGHL/ZSUPsOQ39yAzNKb6FweoUR+yo+cezJ8f+zmOz/75LTo6VoA39OEjiQnbWu5FUyTmbn8E2V9KmbGT41w8i8jMk1NyG77MwlNyPTbmTfldMYHBlhwKb/z9zfK5nn5nBPmILARbo/fj3FZebkZTwnstMKphSnZUDieaEXgWQzpsvGvhZ/uzKllEqcO6W1fhx4HGDJVcv0nOKmjBqleoMAlg/td0QO2jo0lUrXb7dSXv4i3Z+80agruZiOAxHmLy7O+v4bXnkKrUajA5ZjNKNs6vtZyiGLYH8XL/3u1+MrGIf1MC+db+WhVXdnMQenGKjgeHsr/S/sov7wFQzc9kBOW0xZ8V6ZbP7fZI89sH4DXQVv0r98hIrrV1NbOXfK57JiDlo6j3Foz8EJq06H9TBHhg7m9B6Kic039cCwvu3ZufSq92o38ioZJ7MzuKeNoZObGV0SZrpLZ6CnI9fchMyzM9fcPPXqb1l6uIZDPddRs9qe/89c3yuZ5ma4ZSPdQ9uILAlTsfYOaivnZfR8fslOq5hSnPYBiRVgBdCbxm0rgD47JvXr6hpUKGj1w7pmpNTcX7TB/i4e2vt3fL/+C1n/YGazEnKyM6uznYPT0Lia40CwfB81Wx4leGKNq1tMZTr/r3vXQUp3/4ajDdsovfbyjOZLWTEHLZ3HeGTZd20PUg8UpmBodvpBzeprCLbex8xdzxHkeY4vP2Hk3qddkS6++MuHcypqMs1OO3LTNOnmZmx+6bGxvAw0rcrqQsZP2WkFU4rTQ0CRUqpRax3b52gZkDihn7HPLQN+N8XthIc8truFfb3pnzWc7Aoxm+0w7Nrao6FxNedq6glesZPi59YzsP69lNx3b06PaZdQezcAoydOUhgOMf30KxxqPsHM5c0Z/TK2YgWoF1aRGkay00axzflrtjzKid5dHOvsZMGKdW436xItJ5/MeYV9ptnp9pZIpgi2thE48hxHrzxC4PbM8vKSx5HsnMCI4lRr/Y5S6ufAV5VSnya64nQtsDzJzX8EfEYp9UuigxD/Hfgnp9oqrOfmKlE793dLPElq4XoIX/ufqGo2Y4gUxo7V69hCycLOaBqUw/Hb+pi5pCnjoLViBagJq0i9soUUSHY6obqxihAPsHD7s3R1vMkxWozZYip2HKXT2Zlrbg5XB9D9yTr3vSPY2sbQyfUEm8MEMryQT+SX7LSSEav1x/wlUAqcA34CPKC13qeUukUp1Rd3u38GngPagL3AL8Y+JzzK76tEF6xYR+D2Zk6u2EXxzqfp2ryV7l0HCbV3j/daOiX2nKH27vFwDS3dT88HltD9yRvp/uSNVKxcnXHQxv5PclkBasVjWMUjQ/oxkp02q26sGl/BX/VymP69O91uEnDpcZR+zE4Thdq7GVi/gaGT6xm9uYjA2jtyKkz9lp1WMaY41Vp3aa3/UGs9Q2tdH9tEWmu9TWtdFnc7rbX+G631rLGPv5E5U5kpDJpzxZrND1U220Ule16nTpGC6DB/xcrVnLmtE1X8IrPbn6F21+OUbHnUsVOlwi0bKd7xBLX7f0Ltrscp7vnheLhWN76P2srG8Y9MBPu7+Pim/8KITlwBOpLR/81k89hEapKdztGLlnHZtGUUdQ263ZTx7BzW/s5OkyRuEzXvrvty6kGX7EzNmOLUVLq6hkgocTGsd+nAjKlv5KBMf6isukKMH9pySm1lIxUrV9Pz4ct4+09n8PafziDY3MHQyfUMrN+AutBpy/PGjh49NmczF1ec5MSqPt7+0xlc+MSCnMMVoq/l+XAXw6OJK0BHMpqDZsI8Ni8N6Qt3hHqi9b7bx0DnU3aaoGvz1mhnQnMHgdubLZl77KfstJoRc05F/nJjlaibE8drKxtZufp+QucnHsE469k+frX24Us+N3rH1YR/vTGr51KD0V2DSoZOc2xswv48i1cbx15LgOmFxbR8+Nus+8VnGByJML2wmMc++LW0H8uU8509NqQvHFTdWEXwxJXo116nv/t5Ti06wNyb1rjSFj9kZ6Yn6q1cNy/l9k5Wn0oWbG2jrPMwEM3SgYI36bpthIqV1mwr5sfstJIUp8JV8T9U6ezXZ8UVotsTx5MVpgBdg2WcXXvkks+NTJtP6IbfZPU8w7PefZ5AXW4T9lNJfC3/5uW/99WkfCES1ay+hlD7PIp3PMHJ3uiZBm4UqLHsTHefU9OyU5UHkm94Nolkhelkn89WuGUjAwWvM3hDdAP9aJZaewxpvmfnVKNUUpzmmcF9ZfSynT66jdyzbyq5XiGmGtoyZduNxKGijgMR5t14n0utmVyy1/LIxRPjXzfttZ2KDOmLdEVX8N/Dgp3zOfbaZvS58xTfusKIFfypmJSdpTX17CxvJRB6i67NMOvOVTm1zSqh9m4CO7dybM5myuurmXeXPdnrt+zMVDpZK3NO80jN6muI3HwPNbvmc/GVvRzb7u6cITcm1vtx4rhbkr2WiTKd2O+Eyd53MqQv0lXdWEXpuo+w4OydFOwYpv/Z5x2bh+r17IzNv4+smUFn4AkG1m9wfOeSRLE5pZ2Nv4pOgbKpMAVvZqfV77mpslZ6TtMQXRQVzOkY00vnyrx7Zq8dc2UmE9uz76rtz1J6eR+dF9pdu9rPZb+9bI968+PEcbckey0TZTqx3wnJ3nfSa2ouU7IzldJ1H6Gv9UpHT5KKfw/fO+v+jO5rSnbG9oE+XtfK0Re2Ub/lNCFyO+45E7FdUmLzXgdCmyydUzoZL2anVXuLp5u1Upw6xKm5MumobqxiYLvjT3uJZBPro0d/pyfbHxQ/Thx3S6rXMtjfxR88dV9WE/utOF96qsdPtaBDek3NZFJ2puLkSVKJ7+G7rv0486lL+/6mZacbxz0PrN/AUMGb1CwohXLQ5SX0LLd2TulkvJadVi+ESydrZVhfuCKX/fa8vpF09ezkeySm+rzX5PJ/a/c2NcnaJr2mwgrVjVUM3PYAC4/fQvFz73Bse4stw/yJ7+GWk0+mfV9Ts7OhcTWBtXfQ/f4L41vrBVvbJnxUBQaS3r8qMDDhtsM94fG/d23eOv4xsH7D+D6lsYNHLty5jAUr1rk+Z9jU7LRif1zIbIRKek6F41JNrE+3B8Dt1fa5evn1LW43YZzVV9u5LJqwe4uvVG37syvvoHreFZY9j8hf1Y1V0HgvJZu3wnOb6Am1El5i3TB/svfwi8FWHuq/O62fFZOzs7ayEe5q5NisFk6GdtFw+tLCXgdm0Pq556Z8HNX/DgBhtZrKotboJ8d6RwFOLDpPYEnuu5fkS3ZavYg43REq6TkVjks1sT6dHgA/HtPmJquvtnNZNGHV1Xmmbfu/+7PbR1aIVGbduYpp8+7jsi119L+wi+PtrZY8bi4/X17JzgUr1lGxcvV4r2bso3d5Q1ofsaOYh2fNuOT+F+5cxoU7l2V1PHMy+ZKdVi2Ei/SEMpo6JT2nabJiUZSISjWxfn/vgSnva8VG0iLKjqvtbBdNOLHFV8q2XTxqyeMLES82D3Xh9mc5+sI2jnV2EshxTmOy9/CwTm9RkpeyM+lrVJnZYwyejdg2TJ9P2WnFQrhspk5JceqQ6qqRlCdb5JtUk8E7DkSmvK8XV9vbvcgnW3YM8WW7aMKJX5yJbYsFpiyEMpuXszM2zL9wPXR1vElPqBVWpii+0pDs58vJTfidJtmZWVtirMxOqxbCZZqzUpw6JH7Lk47IQeYXL3KxNd7lxdX2Vm3BYSXTDiNw6xenFKbm80N2ltwXnYc6c8srnMHaeajpkuy0hmRnZrJdcCrFqRA2snuRT7ZMG+Jz+henrNBPnx42v4fSC2bduYpQ+zIu2/IoJzrs3W7KDyQ70+OFi45sOgFkQVSe0tNnwoV+t5thCTdOS0mX3Yt8smX61bYTpNdUOM2p7abSJdmZOcnO9GW6CCqe9JxmQBZFmcnEoR8wb/gnnheutu0ivabCTXZvN5UJyc7M5XN2ZiLXnJWeU+Fppm4qDdaeRS2sJb2mmYmEetxugu/MunMVJdV3cdmWOi6+stey7abSJdkp7JZLzkpxKjzN1KEfkOEfE+UyzJS3imSAzS6z7lzFwG0PcNXem+h/YZejw/ySncIuVuSspI7wLJOHfsCbwz+mbt1iBRnOz00k1CNTmmxg9XZT6ZDstJafczNTVuWs9JwKz5KhH+vZfba9W2RP09zo6hq3m+B7JffdOz7M3/Nyq63D/JKd1vJrbmbKypyV4jQLMv/KDDL0Yy2T56BZQQpTYbpZd64icv1HuWxLHUNvtds2xC/ZaR2/52amrMpZGdbPkK6uQYWCbjdD4L2hH7tYNaRkx6knJpDhfOvI0L79qpoX0XVqOQ2nX6TbpueQ7IyyIjv9mpuZsjpnpedUCBs4uX+gFUNKqeageb0XQIbzrSND+84ZKY2+X4cOHHC5Jc7zUnb6NTczZUfOSnGap9TgRagMuN0M30on9KwIYauGlPw4B00KU+FVBfXzGDhaR89rBzm5ab3bzXGUl7LTj7mZKbtyVopTIXKUGJTphp4VPZ5WbQfj1zloUphaK3oQicy5t1t1YxWRm+9hwdk7KdgxzMlN6109ScoOyQpMr2WnX3MzU3bkrBSnQuQoMSjTCT0rrtqtHFJ6au0j7L3v+Qkf6cxNM/EIRNnPVHhddWMVpes+wrR591GwY5j+Z593fKN+OyUrML2WnX7LzUzZmbNSnGZBeg/cl84PthM//IlBeTD0dlqhZ8VVuylDSqZtoyILoOwn+eecmtXXMG3efdTsmm/JSVImZGeyAjPdgtEv2WlabmbK7pyV4lR4Ujo/2E788CcG5d+8/PdThp5VV+2ZDinZ8QvHtG1UZJ6p/WRhlPNqVl/DwG0PcFPnzejOzpwey4TsTFZgplMw+iU7TcvNTDmRs1KcCs9J5wfbiR/+ZEH59sUTU4aeVVftmQ4p2fELx6QjEKUwdZb0nnqPCdmZqsB8vbMtb7LTpNzMlFM5K8Wp8JypfrCD/V18fNN/YcTmH/5kQVlUUMgfL/rwpKHnxiT6dH8pZdI7YNI2KlKYOkt6T92hSmdS1DWY9f1NyM5UBebv1V0zZcHoh+w0KTcz5WTOSnEqPCWdH+zvvPavnA93MWzzD3+2QZnLJPpspXOlnmnvgAnztkAKUyHSYUp25lJg+iE7TcnNbDmVs3JCVB7q2ryV6UOnOVoaJkC9283JyGQ/2F9a/iDB/i42H9ky4X52nNzhlVNWUv1SeuDadeOnoiT2DsR/LRUTtlGRwtRdcmKUs853jjBc0cupV59j7k1rMrqvKdnpldwEe7LThNzMhtM7oEhxmmeCrW0MhTbRddsIFU2rqa1sdLtJGZnqB/ux3S2MMjrhfl744bfLVL+UEm+T7i8jt3/JSGHqLjnK2VnVjVWEWEX1jg5O9u5huDpAQ+PqtO8v2Zk5O7LT7dzMhhtb8xlRnCqlZgE/AH4fOA98XmudtI9bKfVl4H8C8RNv3qu1ftvudsaLbicV9FSvQbC1jYHgk6ibi6i4dZXnClOY/Ac7dgUbb3phMS98bH1OZ8573VS/lNLpHZhKtmdUZ3s/PdbWfC5MTclN6T11TrRAvYeF2ysI/6Kd4x9upYBb0rqvZGfm/JidmXJrz2gjilPgESAC1AHXAr9QSu3RWu9LcfsntdZ3O9U4P6m7IkDv1VdT7cHCdCrpXOXmo6mu1K143eLnXGXyWmdzv2iPaakRhWnfgKt7qrqem9J76rzqxiq6+/4T1Wd6sGq/BMnO5PyWnZlyc89o1xdEKaVmAB8FvqS17tNabwc2Afe42zLhNV6dy+O2XF+3bLeeyeZ+40P5Re5fV7tZmEpuCitJdmbHS9mZKbenTbmf8HAVMKy1PhT3uT3Ayknus0Yp1QWcAb6vtX402Y2UUvcD9wPU1tRxNrLXoiaPPX7pECpSmPH9InqAjshBS9uSjuFlI4TVTYz0l9J/IOL4808lMqDpyKFd31n0nZRfy+Vx3ZT4mnRFuvjGoX/g81c9xKziKkueI9fX7ftvP8HIaLT3YGR0lG9t/TEPvucvLL3f+DB+UTkAw2HN2b3u/p+OjpaiCl2LUNtyEzLMznJQ/SdRRZlnYabcyk7TDC8coG9eM8P9gM4tN0GyM1teyM5E6fyejeZtabQT4Kw7//8mFKdlMGF04iJQnuL2PwUeBzqBG4GnlVIXtNY/Sbyh1vrxsduy5Kplek5xk2WNBlC92c057YgcZH7xIkvbko7gnjYqi1rp/uSNRs437TgQYf7iYrebkTE75/50HIhQUt83/vibdj/Fvt632NT3MyOG24L9Xbz0u18zrKPF47Ae5qXzrTy06u5JX4tM7pfsCv7s3ghzmtx7r/QNhCie6eq0AttyEzLPzmyzMFNuZadpuvcdpPrMyxxdW0DByC2ezE2wNzv3vHmWb7/98Phjb3gl/7Izmal+z7rdYxpj+7C+UmqrUkqn+NgO9AGJqVYB9CZ7PK31W1rr01rrEa31K8A/Ah+z97sQIjUnjvp7o3Mf33ltvXFH3mW7Z1+69zMlKOM5MZzvxdyUE6NEpuzMzpaTT44/tonHhdqdndkwKW9tL0611qu01irFxwrgEFCklIrvylsGpJrUP+EpAGV1u4VIh92h1xV59/E3v/1rRkZHAHM2bc52ztVU94v0hIwKyphYYWp3r6nXclNOjBKZsjM7g/1dvHju1+OP/Z3X/tW440Ltys5sxVblm5K3rg/ra63fUUr9HPiqUurTRFedrgWWJ7u9Umot8B/ABeB64K+ALzjSWI8rDIdSD/r5nF3DR9nsD5qJlpNPjj/+SNzVcjZbltgh2z37JrufiUUpOFeYpkNyM3+F2ruZsfs37G56i5lYO1UtGS9mZ/yerSN6lM1Htoz/28/ZmQ1T89b11fpj/hIoBc4BPwEeiG2HopS6RSnVF3fbPwEOEx2++hHwTa31Dx1ur2fp8hK3m+AKO4aP7D4jOXb1n3iVHGNKD4CVTA1KkwrTOEblZnTvZxnat1OwtY3iHU9wtGEbM5c3ZbQJf7a8lp2xxx6fkzk6POFwAT9mZzZMzVswpDjVWndprf9Qaz1Da10fv5G01nqb1ros7t+f1FpXa63LtNaLtdbfc6fV3hJq72b66Vc4UX7e7aY4zq7hI7vPSE51YkuMn7Z6iQ3jmzSslMiwwlRyM8+E2rsp6zxMaOl+Arc3O1KYejE7kz12Ij9lZ7ZMLkzBgGF9L/PKKVHB1jYCR54j2NzBtCVLjVypbye7ho9Szf15vdOaLcv2BPePX/3HWzzrPZ48Ai+Z+E2eTQ1JA1bme4qcGGWf2XWFhKrKmedAYQrezM5kjw3+ys1cmV6YghSnvhdsbaOkYwvB5g4Ca+/Iu8LUiuPlUkkMuq+98n1+evCX/F6dNfPAnlr7iGe310qHFwJSCtPMyIlR/uHV7Iw9tp+zMxdeOfrZiGF9Ya/6peVMW7Qw7wpTsH/oPcbErUpM5YUhfHD9aFIhXCXZ6T9e6BCIkeJU+JpTx/IlG/4yUbC/i0/98iFXfgGYuj1UMoYugPIEWRhlHx2+yPCs6Y48l2TnpdzMzlxd0iFgwNHP6fBGK0VOdH8vw9UBt5vhCifmGNk5/GW1+JW3Tp2S4oV5pfGkMBVCsjORG9lpBa90CCSSnlMhcuTU8FeunB4+S+wp9UI4SmFqHek9FVOR7LSXVwtTkOLU9wrDMm/Obk4Nf+XKqeEzLxalIIWpleTEKGuF2ruZsf1ZXq3b4XZTLCXZaR8vF6Ygw/p5QZUHgAG3m+FbXtiexInhM68N38eTVfnCVLEdV8427Xds432nSHZazytF6VQLTqXn1MeCrW1MP/0KO8vb3G6KcJmdw2de7SmFaEBKYWoPWRhljbLOw5Qs7KR8+QpfFaZe4ZWpB+CfwhSk59S3gq1tDJ1cT7A5zLQlSyXU8pzVw2de7iWNkWF84RXFs2cyUlPudjPyklemHnitMJ0qd6U49aFQezclHVsYXFFE4Nb823hfTGTV8JkfilKQwlR4hxq86HYT8prpUw+8UpRCZrkrxalPVc4qoqd2thSmImd+KUhjpDB1jleOeDZeZX5uBSgm59fCFKQ49a+BXoarZ7jdCuFR8QUpeCP80iGFqfCSUHs3JUOnOVoaJkC9280RhvBSUQrZ5a4Up0IIwL8FKUhR6rZIqEd6TzMUbG0jcOQ5ztzWybS6RhkFE0B+FKYgxakvqYN73G6C8Ag/F6QxUpi6S1fXoEJBt5vhKcHWNgaCT/JOc4iKlbJuQHhzelUu2SvFqc8EW9sYCm3i4PIRKmpkhb64VD4Uo/GkMBVeNecyTc/yFVRLYZr3vNZbCrlnrxSnPhFq7yawcytDQ9sYvbmIiltXydW2mFCMgrcCLltSlJpHhvYzJ9tH5TcvFqVgTf5Kceojs+sKCTUUMe+u+9xuinBJvhaj8aQwNY8M7WemMBwCqUvzWj4XpiDFqRCeJsXou6QoFX6iy0vcboJwQb4XpTFSnPqIDl9keNZ0t5shbCKFaGpuFaZdo1MfwydEJro2b2Va9y5OLDqPTILIH15c8BRjR/5KcZoDJZtLC5uMXz2PlhLp6R3/vNdCy25u9pZKYZoZ2ZB/auGWjQwMbaNnzQwqmlbLuoE84dXeUrAvg6U49YkZ25/lTOVeoNTtpogMJesRhWhQ6bMRTwaW3UZHh+kbiBbtbhamM0rk/0ZYI9jaxpyiQ3T+wQwWrFjndnOEA7xclIK9nQNSnHpcbJX+sYZtlF57OYGm691ukkhhsiJUpC8aiKWuzS2VwlTYpbyuFFUnJ/v5nZeH8GPsHrWS4tTDYoVppHQHFdctYu5Na9xukkCKULvEh6EqjDj+/FKUWkO2lEqu/MTrnFt2EahyuynCJlKUpk+KU4+bXVdI/5xaBhcvdrspeSdVEQreDR4TxcIQ3FuJL4WpNWRLqYlC7d3M2P4sRxu2UbrgchY0yuEpfuOHohScneMvxanH6fBFt5uQF6Q31HkmFKUghamwT6i9m+IdT3C2aT+B5c00SGHqO16fVxrj9OJTKU79oDLgdgt8RbZscpcpRSlIYSrsVxkI07NoIXOlMPUVKUpzI8WphxX0nXO7CZ4nhag5pCgV+Wq4WjoY/MIvQ/jg7lZ9Upx6VKi9mxm7f8OrTa9SUVrDgkq56p6KFKJmMqkoBSlM7Sb7nUYFW9sIHHmOI80dKJa63RyRIz8VpeD+iXtSnGbJzUn9sVA7euURZso8pZSkGDWbqUUpSGEq7BVu2chAweu80xwisPYO2Wzfw6QotYcUpzlw88q/eNE7BD4ghWk8KUa9wbSiFKS3VDgn1N5NfV0hoYYIgVulMPUqvxWlYE5hClKcelL5idcpvmEmpTX1bjfFdYkFqV9Cwm9MLEhjpDAVTovtsiKFqff4uSgFc/JZilOPCba2ERg6zdHLwuTrFHopSL3DxNCLkaJUuCGwcytnSvcwPEuOmvYSPxalYFZvaTwpTj0k2NrG0Mn1BJvDBJryazjIr8HgRyYXpCBzS02Qj4uixo+anrOZ8vpqOWraI/z6u8f0nC5wuwFKqQeVUq8ppQaVUhvSuP1/U0qdVUr1KKX+VSk13YFmui7Y2kZJxxZGby7Kmwn0kZ7Q+AdEg8FP4eA3fQOhS67CTQy8+N5Srxemkp3eEStMB6p2UXHdIubddV9eZLiX+fl3jwk5Hd9JkIwJPaenga8DtwOTjnMopW4HPge8f+x+G4GvjH3OMW6t1J+/EHpqZ/s61GTI3ltMv/qO8WlvqeeyM59Fj5ouY0iOmjaaX3tKIZrXo6PRqDDh1L3JuF6caq1/DqCUug6YN8XNPwX8QGu9b+w+XwP+DRcC1q3hKD9v1qxHh6N/+iwQ/MYrBWmMX+eWejU7hTCRn4tSeDe3VWGREYXpVHnsenGaoaXAs3H/3gPUKaWqtdYTSnGl1P3A/WP/7Pu9Oy476EAb0zEbOJ/VPf83wD9Y2RaTZP+6+Je8JsmZ9Lo0uN2ANEh2+pe8JsnJ65KcSa9Lyuz0WnFaBlyM+3fs7+XAhIDVWj8OPO5AuzKilHpNa32d2+0wjbwuE8lrkpy8LhmT7PQpeU2Sk9clOa+8LrYuiFJKbVVK6RQf27N4yD4gfjw99vfe3FsrhBBmkOwUQuQzW3tOtdarLH7IfcAy4Kdj/14GdCYblhJCCK+S7BRC5DMTtpIqUkqVAIVAoVKqRCmVqmj+EfBnSqklSqlK4IvABmdaainjhssMIa/LRPKaJJf3r4tkpxgjr0ly8rok54nXRWmt3W2AUl8G/jbh01/RWn9ZKVUPvAUs0VqfGLv9Z4D/QXTrlKeBv9BaDzrYZCGEcJ1kpxDCr1wvToUQQgghhIhxfVhfCCGEEEKIGClOhRBCCCGEMaQ4dUmm52L7mVJqllJqo1LqHaXUcaXUOrfb5DZ5f0yklJqulPrB2HukVym1Wyl1h9vtEs6Sn40oyc3k5P0xkRez02ub8PtJ2udi54FHgAhQB1wL/EIptSd21GKekvfHREVAB7ASOAF8CPipUuoarfUxNxsmHCU/G1GSm8nJ+2Miz2WnLIhymVLq68A8rfW9brfFDUqpGUA30KS1PjT2uSeAU1rrvD/3O9/fH1NRSr1JdIX60263RTgrn382JDenls/vj3SYnp0yrC/cdhUwHAvYMXuIngUuREpKqTqi75987ykS+UdyU2TNC9kpxalwWxnQk/C5i0TP/BYiKaXUNODfgB9qrQ+43R4hHCa5KbLileyU4tQGNpyL7WeJZ34z9m8581skpZQqAJ4gOt/uQZebIywk2Zk2yU2RMS9lpyyIsoEN52L72SGgSCnVqLVuH/vcMgwebhDuUUop4AdEF4F8SGs95HKThIUkO9MmuSky4rXslJ5Tl2R4LrZvaa3fAX4OfFUpNUMpdTOwlujVXd6S90dKjwJXA2u01mG3GyOcJz8bkpuTkfdHSp7KTilO3fNFIAx8Drh77O9fdLVF7vlLolt+nAN+Ajwg26HI+yORUqoB+HOi2+acVUr1jX38qbstEw6Tn40oyc3k5P2RwIvZKVtJCSGEEEIIY0jPqRBCCCGEMIYUp0IIIYQQwhhSnAohhBBCCGNIcSqEEEIIIYwhxakQQgghhDCGFKdCCCGEEMIYUpwKIYQQQghjSHEqhBBCCCGMIcWpyEtKqV8ppbRS6qMJn1dKqQ1jX/vfbrVPCCFMI7kpnCInRIm8pJRaBrwBHASu0VqPjH3+YeAzwONa6z93sYlCCGEUyU3hFOk5FXlJa70HeAK4GrgHQCn1BaIB+1PgAfdaJ4QQ5pHcFE6RnlORt5RS84FDwFngYeCfgBeAu7TWETfbJoQQJpLcFE6QnlORt7TWHcB3gQVEA/YV4I8SA1YpdatSapNS6tTYnKp7nW6rEEKYQHJTOEGKU5HvgnF//zOtdX+S25QBe4G/BsKOtEoIIcwluSlsJcWpyFtKqXXAPxAdnoJoiE6gtf6l1voLWuungFGn2ieEEKaR3BROkOJU5CWl1IeADUSv7N9LdPXpp5VSi9xslxBCmEpyUzhFilORd5RSK4CngJPA7VrrIPBFoAj4ppttE0IIE0luCidJcSryilLqWmAzcBH4oNb6DMDY0NNrwFql1C3utVAIIcwiuSmcJsWpyBtKqSuBfwc00Sv/Iwk3+fzYn99ytGFCCGEoyU3hhiK3GyCEU7TWh4E5k3z9JUA51yIhhDCb5KZwgxSnQkxBKVUGXDn2zwKgfmyYq0trfcK1hgkhhKEkN0Uu5IQoIaaglFoFbEnypR9qre91tDFCCOEBkpsiF1KcCiGEEEIIY8iCKCGEEEIIYQwpToUQQgghhDGkOBVCCCGEEMaQ4lQIIYQQQhhDilMhhBBCCGEMKU6FEEIIIYQxpDgVQgghhBDGkOJUCCGEEEIY4/8Hfpn0YQ+ebT0AAAAASUVORK5CYII=\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter5_129_3.png" - }, - "needs_background": "light" - }, - "output_type": "display_data" - }, - { - "data": { - "image/png": "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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter5_129_4.png" - }, - "needs_background": "light" - }, - "output_type": "display_data" - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Phi(-1.0, -2) = [0.74081822]\n", - "Phi(-1.0, 1) = [0.30119421]\n" - ] - }, - { - "data": { - "image/png": "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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter5_129_6.png" - }, - "needs_background": "light" - }, - "output_type": "display_data" - } - ], - "source": [ - "from __future__ import division, print_function, unicode_literals\n", - "\n", - "import numpy as np\n", - "np.random.seed(42)\n", - "\n", - "import matplotlib\n", - "import matplotlib.pyplot as plt\n", - "plt.rcParams['axes.labelsize'] = 14\n", - "plt.rcParams['xtick.labelsize'] = 12\n", - "plt.rcParams['ytick.labelsize'] = 12\n", - "\n", - "\n", - "from sklearn.svm import SVC\n", - "from sklearn import datasets\n", - "\n", - "\n", - "\n", - "from sklearn.pipeline import Pipeline\n", - "from sklearn.preprocessing import StandardScaler\n", - "from sklearn.svm import LinearSVC\n", - "\n", - "\n", - "from sklearn.datasets import make_moons\n", - "X, y = make_moons(n_samples=100, noise=0.15, random_state=42)\n", - "\n", - "def plot_dataset(X, y, axes):\n", - " plt.plot(X[:, 0][y==0], X[:, 1][y==0], \"bs\")\n", - " plt.plot(X[:, 0][y==1], X[:, 1][y==1], \"g^\")\n", - " plt.axis(axes)\n", - " plt.grid(True, which='both')\n", - " plt.xlabel(r\"$x_1$\", fontsize=20)\n", - " plt.ylabel(r\"$x_2$\", fontsize=20, rotation=0)\n", - "\n", - "plot_dataset(X, y, [-1.5, 2.5, -1, 1.5])\n", - "plt.show()\n", - "\n", - "from sklearn.datasets import make_moons\n", - "from sklearn.pipeline import Pipeline\n", - "from sklearn.preprocessing import PolynomialFeatures\n", - "\n", - "polynomial_svm_clf = Pipeline([\n", - " (\"poly_features\", PolynomialFeatures(degree=3)),\n", - " (\"scaler\", StandardScaler()),\n", - " (\"svm_clf\", LinearSVC(C=10, loss=\"hinge\", random_state=42))\n", - " ])\n", - "\n", - "polynomial_svm_clf.fit(X, y)\n", - "\n", - "def plot_predictions(clf, axes):\n", - " x0s = np.linspace(axes[0], axes[1], 100)\n", - " x1s = np.linspace(axes[2], axes[3], 100)\n", - " x0, x1 = np.meshgrid(x0s, x1s)\n", - " X = np.c_[x0.ravel(), x1.ravel()]\n", - " y_pred = clf.predict(X).reshape(x0.shape)\n", - " y_decision = clf.decision_function(X).reshape(x0.shape)\n", - " plt.contourf(x0, x1, y_pred, cmap=plt.cm.brg, alpha=0.2)\n", - " plt.contourf(x0, x1, y_decision, cmap=plt.cm.brg, alpha=0.1)\n", - "\n", - "plot_predictions(polynomial_svm_clf, [-1.5, 2.5, -1, 1.5])\n", - "plot_dataset(X, y, [-1.5, 2.5, -1, 1.5])\n", - "\n", - "plt.show()\n", - "\n", - "\n", - "from sklearn.svm import SVC\n", - "\n", - "poly_kernel_svm_clf = Pipeline([\n", - " (\"scaler\", StandardScaler()),\n", - " (\"svm_clf\", SVC(kernel=\"poly\", degree=3, coef0=1, C=5))\n", - " ])\n", - "poly_kernel_svm_clf.fit(X, y)\n", - "\n", - "poly100_kernel_svm_clf = Pipeline([\n", - " (\"scaler\", StandardScaler()),\n", - " (\"svm_clf\", SVC(kernel=\"poly\", degree=10, coef0=100, C=5))\n", - " ])\n", - "poly100_kernel_svm_clf.fit(X, y)\n", - "\n", - "plt.figure(figsize=(11, 4))\n", - "\n", - "plt.subplot(121)\n", - "plot_predictions(poly_kernel_svm_clf, [-1.5, 2.5, -1, 1.5])\n", - "plot_dataset(X, y, [-1.5, 2.5, -1, 1.5])\n", - "plt.title(r\"$d=3, r=1, C=5$\", fontsize=18)\n", - "\n", - "plt.subplot(122)\n", - "plot_predictions(poly100_kernel_svm_clf, [-1.5, 2.5, -1, 1.5])\n", - "plot_dataset(X, y, [-1.5, 2.5, -1, 1.5])\n", - "plt.title(r\"$d=10, r=100, C=5$\", fontsize=18)\n", - "\n", - "plt.show()\n", - "\n", - "def gaussian_rbf(x, landmark, gamma):\n", - " return np.exp(-gamma * np.linalg.norm(x - landmark, axis=1)**2)\n", - "\n", - "gamma = 0.3\n", - "\n", - "x1s = np.linspace(-4.5, 4.5, 200).reshape(-1, 1)\n", - "x2s = gaussian_rbf(x1s, -2, gamma)\n", - "x3s = gaussian_rbf(x1s, 1, gamma)\n", - "\n", - "XK = np.c_[gaussian_rbf(X1D, -2, gamma), gaussian_rbf(X1D, 1, gamma)]\n", - "yk = np.array([0, 0, 1, 1, 1, 1, 1, 0, 0])\n", - "\n", - "plt.figure(figsize=(11, 4))\n", - "\n", - "plt.subplot(121)\n", - "plt.grid(True, which='both')\n", - "plt.axhline(y=0, color='k')\n", - "plt.scatter(x=[-2, 1], y=[0, 0], s=150, alpha=0.5, c=\"red\")\n", - "plt.plot(X1D[:, 0][yk==0], np.zeros(4), \"bs\")\n", - "plt.plot(X1D[:, 0][yk==1], np.zeros(5), \"g^\")\n", - "plt.plot(x1s, x2s, \"g--\")\n", - "plt.plot(x1s, x3s, \"b:\")\n", - "plt.gca().get_yaxis().set_ticks([0, 0.25, 0.5, 0.75, 1])\n", - "plt.xlabel(r\"$x_1$\", fontsize=20)\n", - "plt.ylabel(r\"Similarity\", fontsize=14)\n", - "plt.annotate(r'$\\mathbf{x}$',\n", - " xy=(X1D[3, 0], 0),\n", - " xytext=(-0.5, 0.20),\n", - " ha=\"center\",\n", - " arrowprops=dict(facecolor='black', shrink=0.1),\n", - " fontsize=18,\n", - " )\n", - "plt.text(-2, 0.9, \"$x_2$\", ha=\"center\", fontsize=20)\n", - "plt.text(1, 0.9, \"$x_3$\", ha=\"center\", fontsize=20)\n", - "plt.axis([-4.5, 4.5, -0.1, 1.1])\n", - "\n", - "plt.subplot(122)\n", - "plt.grid(True, which='both')\n", - "plt.axhline(y=0, color='k')\n", - "plt.axvline(x=0, color='k')\n", - "plt.plot(XK[:, 0][yk==0], XK[:, 1][yk==0], \"bs\")\n", - "plt.plot(XK[:, 0][yk==1], XK[:, 1][yk==1], \"g^\")\n", - "plt.xlabel(r\"$x_2$\", fontsize=20)\n", - "plt.ylabel(r\"$x_3$ \", fontsize=20, rotation=0)\n", - "plt.annotate(r'$\\phi\\left(\\mathbf{x}\\right)$',\n", - " xy=(XK[3, 0], XK[3, 1]),\n", - " xytext=(0.65, 0.50),\n", - " ha=\"center\",\n", - " arrowprops=dict(facecolor='black', shrink=0.1),\n", - " fontsize=18,\n", - " )\n", - "plt.plot([-0.1, 1.1], [0.57, -0.1], \"r--\", linewidth=3)\n", - "plt.axis([-0.1, 1.1, -0.1, 1.1])\n", - " \n", - "plt.subplots_adjust(right=1)\n", - "\n", - "plt.show()\n", - "\n", - "\n", - "x1_example = X1D[3, 0]\n", - "for landmark in (-2, 1):\n", - " k = gaussian_rbf(np.array([[x1_example]]), np.array([[landmark]]), gamma)\n", - " print(\"Phi({}, {}) = {}\".format(x1_example, landmark, k))\n", - "\n", - "rbf_kernel_svm_clf = Pipeline([\n", - " (\"scaler\", StandardScaler()),\n", - " (\"svm_clf\", SVC(kernel=\"rbf\", gamma=5, C=0.001))\n", - " ])\n", - "rbf_kernel_svm_clf.fit(X, y)\n", - "\n", - "\n", - "from sklearn.svm import SVC\n", - "\n", - "gamma1, gamma2 = 0.1, 5\n", - "C1, C2 = 0.001, 1000\n", - "hyperparams = (gamma1, C1), (gamma1, C2), (gamma2, C1), (gamma2, C2)\n", - "\n", - "svm_clfs = []\n", - "for gamma, C in hyperparams:\n", - " rbf_kernel_svm_clf = Pipeline([\n", - " (\"scaler\", StandardScaler()),\n", - " (\"svm_clf\", SVC(kernel=\"rbf\", gamma=gamma, C=C))\n", - " ])\n", - " rbf_kernel_svm_clf.fit(X, y)\n", - " svm_clfs.append(rbf_kernel_svm_clf)\n", - "\n", - "plt.figure(figsize=(11, 7))\n", - "\n", - "for i, svm_clf in enumerate(svm_clfs):\n", - " plt.subplot(221 + i)\n", - " plot_predictions(svm_clf, [-1.5, 2.5, -1, 1.5])\n", - " plot_dataset(X, y, [-1.5, 2.5, -1, 1.5])\n", - " gamma, C = hyperparams[i]\n", - " plt.title(r\"$\\gamma = {}, C = {}$\".format(gamma, C), fontsize=16)\n", - "\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Mathematical optimization of convex functions\n", - "\n", - "A mathematical (quadratic) optimization problem, or just optimization problem, has the form" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{align*}\n", - " &\\mathrm{min}_{\\lambda}\\hspace{0.2cm} \\frac{1}{2}\\boldsymbol{\\lambda}^T\\boldsymbol{P}\\boldsymbol{\\lambda}+\\boldsymbol{q}^T\\boldsymbol{\\lambda},\\\\ \\nonumber\n", - " &\\mathrm{subject\\hspace{0.1cm}to} \\hspace{0.2cm} \\boldsymbol{G}\\boldsymbol{\\lambda} \\preceq \\boldsymbol{h} \\wedge \\boldsymbol{A}\\boldsymbol{\\lambda}=f.\n", - "\\end{align*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "subject to some constraints for say a selected set $i=1,2,\\dots, n$.\n", - "In our case we are optimizing with respect to the Lagrangian multipliers $\\lambda_i$, and the\n", - "vector $\\boldsymbol{\\lambda}=[\\lambda_1, \\lambda_2,\\dots, \\lambda_n]$ is the optimization variable we are dealing with.\n", - "\n", - "In our case we are particularly interested in a class of optimization problems called convex optmization problems. \n", - "In our discussion on gradient descent methods we discussed at length the definition of a convex function. \n", - "\n", - "Convex optimization problems play a central role in applied mathematics and we recommend strongly [Boyd and Vandenberghe's text on the topics](http://web.stanford.edu/~boyd/cvxbook/).\n", - "\n", - "\n", - "\n", - "\n", - "If we use Python as programming language and wish to venture beyond\n", - "**scikit-learn**, **tensorflow** and similar software which makes our\n", - "lives so much easier, we need to dive into the wonderful world of\n", - "quadratic programming. We can, if we wish, solve the minimization\n", - "problem using say standard gradient methods or conjugate gradient\n", - "methods. However, these methods tend to exhibit a rather slow\n", - "converge. So, welcome to the promised land of quadratic programming.\n", - "\n", - "The functions we need are contained in the quadratic programming package **CVXOPT** and we need to import it together with **numpy** as" - ] - }, - { - "cell_type": "code", - "execution_count": 4, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import numpy\n", - "import cvxopt" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "This will make our life much easier. You don't need t write your own optimizer.\n", - "\n", - "\n", - "\n", - "We remind ourselves about the general problem we want to solve" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{align*}\n", - " &\\mathrm{min}_{x}\\hspace{0.2cm} \\frac{1}{2}\\boldsymbol{x}^T\\boldsymbol{P}\\boldsymbol{x}+\\boldsymbol{q}^T\\boldsymbol{x},\\\\ \\nonumber\n", - " &\\mathrm{subject\\hspace{0.1cm} to} \\hspace{0.2cm} \\boldsymbol{G}\\boldsymbol{x} \\preceq \\boldsymbol{h} \\wedge \\boldsymbol{A}\\boldsymbol{x}=f.\n", - "\\end{align*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Let us show how to perform the optmization using a simple case. Assume we want to optimize the following problem" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{align*}\n", - " &\\mathrm{min}_{x}\\hspace{0.2cm} \\frac{1}{2}x^2+5x+3y \\\\ \\nonumber\n", - " &\\mathrm{subject to} \\\\ \\nonumber\n", - " &x, y \\geq 0 \\\\ \\nonumber\n", - " &x+3y \\geq 15 \\\\ \\nonumber\n", - " &2x+5y \\leq 100 \\\\ \\nonumber\n", - " &3x+4y \\leq 80. \\\\ \\nonumber\n", - "\\end{align*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The minimization problem can be rewritten in terms of vectors and matrices as (with $x$ and $y$ being the unknowns)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{1}{2}\\begin{bmatrix} x\\\\ y \\end{bmatrix}^T \\begin{bmatrix} 1 & 0\\\\ 0 & 0 \\end{bmatrix} \\begin{bmatrix} x \\\\ y \\end{bmatrix} + \\begin{bmatrix}3\\\\ 4 \\end{bmatrix}^T \\begin{bmatrix}x \\\\ y \\end{bmatrix}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Similarly, we can now set up the inequalities (we need to change $\\geq$ to $\\leq$ by multiplying with $-1$ on bot sides) as the following matrix-vector equation" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{bmatrix} -1 & 0 \\\\ 0 & -1 \\\\ -1 & -3 \\\\ 2 & 5 \\\\ 3 & 4\\end{bmatrix}\\begin{bmatrix} x \\\\ y\\end{bmatrix} \\preceq \\begin{bmatrix}0 \\\\ 0\\\\ -15 \\\\ 100 \\\\ 80\\end{bmatrix}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We have collapsed all the inequalities into a single matrix $\\boldsymbol{G}$. We see also that our matrix" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{P} =\\begin{bmatrix} 1 & 0\\\\ 0 & 0 \\end{bmatrix}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "is clearly positive semi-definite (all eigenvalues larger or equal zero). \n", - "Finally, the vector $\\boldsymbol{h}$ is defined as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{h} = \\begin{bmatrix}0 \\\\ 0\\\\ -15 \\\\ 100 \\\\ 80\\end{bmatrix}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Since we don't have any equalities the matrix $\\boldsymbol{A}$ is set to zero\n", - "The following code solves the equations for us" - ] - }, - { - "cell_type": "code", - "execution_count": 5, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "ename": "SyntaxError", - "evalue": "invalid character in identifier (, line 5)", - "output_type": "error", - "traceback": [ - "\u001b[0;36m File \u001b[0;32m\"\"\u001b[0;36m, line \u001b[0;32m5\u001b[0m\n\u001b[0;31m P = matrix(numpy.diag([1,0]), tc=’d’)\u001b[0m\n\u001b[0m ^\u001b[0m\n\u001b[0;31mSyntaxError\u001b[0m\u001b[0;31m:\u001b[0m invalid character in identifier\n" - ] - } - ], - "source": [ - "# Import the necessary packages\n", - "import numpy\n", - "from cvxopt import matrix\n", - "from cvxopt import solvers\n", - "P = matrix(numpy.diag([1,0]), tc=’d’)\n", - "q = matrix(numpy.array([3,4]), tc=’d’)\n", - "G = matrix(numpy.array([[-1,0],[0,-1],[-1,-3],[2,5],[3,4]]), tc=’d’)\n", - "h = matrix(numpy.array([0,0,-15,100,80]), tc=’d’)\n", - "# Construct the QP, invoke solver\n", - "sol = solvers.qp(P,q,G,h)\n", - "# Extract optimal value and solution\n", - "sol[’x’] \n", - "sol[’primal objective’]" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We are now ready to return to our setup of the optmization problem for a more realistic case. Introducing the **slack** parameter $C$ we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{1}{2} \\boldsymbol{\\lambda}^T\\begin{bmatrix} y_1y_1K(\\boldsymbol{x}_1,\\boldsymbol{x}_1) & y_1y_2K(\\boldsymbol{x}_1,\\boldsymbol{x}_2) & \\dots & \\dots & y_1y_nK(\\boldsymbol{x}_1,\\boldsymbol{x}_n) \\\\\n", - "y_2y_1K(\\boldsymbol{x}_2,\\boldsymbol{x}_1) & y_2y_2K(\\boldsymbol{x}_2,\\boldsymbol{x}_2) & \\dots & \\dots & y_1y_nK(\\boldsymbol{x}_2,\\boldsymbol{x}_n) \\\\\n", - "\\dots & \\dots & \\dots & \\dots & \\dots \\\\\n", - "\\dots & \\dots & \\dots & \\dots & \\dots \\\\\n", - "y_ny_1K(\\boldsymbol{x}_n,\\boldsymbol{x}_1) & y_ny_2K(\\boldsymbol{x}_n\\boldsymbol{x}_2) & \\dots & \\dots & y_ny_nK(\\boldsymbol{x}_n,\\boldsymbol{x}_n) \\\\\n", - "\\end{bmatrix}\\boldsymbol{\\lambda}-\\mathbb{I}\\boldsymbol{\\lambda},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "subject to $\\boldsymbol{y}^T\\boldsymbol{\\lambda}=0$. Here we defined the vectors $\\boldsymbol{\\lambda} =[\\lambda_1,\\lambda_2,\\dots,\\lambda_n]$ and \n", - "$\\boldsymbol{y}=[y_1,y_2,\\dots,y_n]$. \n", - "With the slack constants this leads to the additional constraint $0\\leq \\lambda_i \\leq C$.\n", - "\n", - "**code will be added**" - ] - } - ], - "metadata": { - "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.8.5" - } - }, - "nbformat": 4, - "nbformat_minor": 4 -} \ No newline at end of file diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter5.py b/doc/LectureNotes/_build/jupyter_execute/chapter5.py deleted file mode 100644 index 5555a53a4..000000000 --- a/doc/LectureNotes/_build/jupyter_execute/chapter5.py +++ /dev/null @@ -1,1079 +0,0 @@ -# Support Vector Machines, overarching aims - -A Support Vector Machine (SVM) is a very powerful and versatile -Machine Learning method, capable of performing linear or nonlinear -classification, regression, and even outlier detection. It is one of -the most popular models in Machine Learning, and anyone interested in -Machine Learning should have it in their toolbox. SVMs are -particularly well suited for classification of complex but small-sized or -medium-sized datasets. - -The case with two well-separated classes only can be understood in an -intuitive way in terms of lines in a two-dimensional space separating -the two classes (see figure below). - -The basic mathematics behind the SVM is however less familiar to most of us. -It relies on the definition of hyperplanes and the -definition of a **margin** which separates classes (in case of -classification problems) of variables. It is also used for regression -problems. - -With SVMs we distinguish between hard margin and soft margins. The -latter introduces a so-called softening parameter to be discussed -below. We distinguish also between linear and non-linear -approaches. The latter are the most frequent ones since it is rather -unlikely that we can separate classes easily by say straight lines. - - -## Hyperplanes and all that - -The theory behind support vector machines (SVM hereafter) is based on -the mathematical description of so-called hyperplanes. Let us start -with a two-dimensional case. This will also allow us to introduce our -first SVM examples. These will be tailored to the case of two specific -classes, as displayed in the figure here based on the usage of the petal data. - -We assume here that our data set can be well separated into two -domains, where a straight line does the job in the separating the two -classes. Here the two classes are represented by either squares or -circles. - -%matplotlib inline - -from sklearn import datasets -from sklearn.svm import SVC, LinearSVC -from sklearn.linear_model import SGDClassifier -from sklearn.preprocessing import StandardScaler -import matplotlib -import matplotlib.pyplot as plt -plt.rcParams['axes.labelsize'] = 14 -plt.rcParams['xtick.labelsize'] = 12 -plt.rcParams['ytick.labelsize'] = 12 - - -iris = datasets.load_iris() -X = iris["data"][:, (2, 3)] # petal length, petal width -y = iris["target"] - -setosa_or_versicolor = (y == 0) | (y == 1) -X = X[setosa_or_versicolor] -y = y[setosa_or_versicolor] - - - -C = 5 -alpha = 1 / (C * len(X)) - -lin_clf = LinearSVC(loss="hinge", C=C, random_state=42) -svm_clf = SVC(kernel="linear", C=C) -sgd_clf = SGDClassifier(loss="hinge", learning_rate="constant", eta0=0.001, alpha=alpha, - max_iter=100000, random_state=42) - -scaler = StandardScaler() -X_scaled = scaler.fit_transform(X) - -lin_clf.fit(X_scaled, y) -svm_clf.fit(X_scaled, y) -sgd_clf.fit(X_scaled, y) - -print("LinearSVC: ", lin_clf.intercept_, lin_clf.coef_) -print("SVC: ", svm_clf.intercept_, svm_clf.coef_) -print("SGDClassifier(alpha={:.5f}):".format(sgd_clf.alpha), sgd_clf.intercept_, sgd_clf.coef_) - -# Compute the slope and bias of each decision boundary -w1 = -lin_clf.coef_[0, 0]/lin_clf.coef_[0, 1] -b1 = -lin_clf.intercept_[0]/lin_clf.coef_[0, 1] -w2 = -svm_clf.coef_[0, 0]/svm_clf.coef_[0, 1] -b2 = -svm_clf.intercept_[0]/svm_clf.coef_[0, 1] -w3 = -sgd_clf.coef_[0, 0]/sgd_clf.coef_[0, 1] -b3 = -sgd_clf.intercept_[0]/sgd_clf.coef_[0, 1] - -# Transform the decision boundary lines back to the original scale -line1 = scaler.inverse_transform([[-10, -10 * w1 + b1], [10, 10 * w1 + b1]]) -line2 = scaler.inverse_transform([[-10, -10 * w2 + b2], [10, 10 * w2 + b2]]) -line3 = scaler.inverse_transform([[-10, -10 * w3 + b3], [10, 10 * w3 + b3]]) - -# Plot all three decision boundaries -plt.figure(figsize=(11, 4)) -plt.plot(line1[:, 0], line1[:, 1], "k:", label="LinearSVC") -plt.plot(line2[:, 0], line2[:, 1], "b--", linewidth=2, label="SVC") -plt.plot(line3[:, 0], line3[:, 1], "r-", label="SGDClassifier") -plt.plot(X[:, 0][y==1], X[:, 1][y==1], "bs") # label="Iris-Versicolor" -plt.plot(X[:, 0][y==0], X[:, 1][y==0], "yo") # label="Iris-Setosa" -plt.xlabel("Petal length", fontsize=14) -plt.ylabel("Petal width", fontsize=14) -plt.legend(loc="upper center", fontsize=14) -plt.axis([0, 5.5, 0, 2]) - -plt.show() - -The aim of the SVM algorithm is to find a hyperplane in a -$p$-dimensional space, where $p$ is the number of features that -distinctly classifies the data points. - -In a $p$-dimensional space, a hyperplane is what we call an affine subspace of dimension of $p-1$. -As an example, in two dimension, a hyperplane is simply as straight line while in three dimensions it is -a two-dimensional subspace, or stated simply, a plane. - -In two dimensions, with the variables $x_1$ and $x_2$, the hyperplane is defined as - -$$ -b+w_1x_1+w_2x_2=0, -$$ - -where $b$ is the intercept and $w_1$ and $w_2$ define the elements of a vector orthogonal to the line -$b+w_1x_1+w_2x_2=0$. -In two dimensions we define the vectors $\boldsymbol{x} =[x1,x2]$ and $\boldsymbol{w}=[w1,w2]$. -We can then rewrite the above equation as - -$$ -\boldsymbol{x}^T\boldsymbol{w}+b=0. -$$ - -We limit ourselves to two classes of outputs $y_i$ and assign these classes the values $y_i = \pm 1$. -In a $p$-dimensional space of say $p$ features we have a hyperplane defines as - -$$ -b+wx_1+w_2x_2+\dots +w_px_p=0. -$$ - -If we define a -matrix $\boldsymbol{X}=\left[\boldsymbol{x}_1,\boldsymbol{x}_2,\dots, \boldsymbol{x}_p\right]$ -of dimension $n\times p$, where $n$ represents the observations for each feature and each vector $x_i$ is a column vector of the matrix $\boldsymbol{X}$, - -$$ -\boldsymbol{x}_i = \begin{bmatrix} x_{i1} \\ x_{i2} \\ \dots \\ \dots \\ x_{ip} \end{bmatrix}. -$$ - -If the above condition is not met for a given vector $\boldsymbol{x}_i$ we have - -$$ -b+w_1x_{i1}+w_2x_{i2}+\dots +w_px_{ip} >0, -$$ - -if our output $y_i=1$. -In this case we say that $\boldsymbol{x}_i$ lies on one of the sides of the hyperplane and if - -$$ -b+w_1x_{i1}+w_2x_{i2}+\dots +w_px_{ip} < 0, -$$ - -for the class of observations $y_i=-1$, -then $\boldsymbol{x}_i$ lies on the other side. - -Equivalently, for the two classes of observations we have - -$$ -y_i\left(b+w_1x_{i1}+w_2x_{i2}+\dots +w_px_{ip}\right) > 0. -$$ - -When we try to separate hyperplanes, if it exists, we can use it to construct a natural classifier: a test observation is assigned a given class depending on which side of the hyperplane it is located. - - -### The two-dimensional case - -Let us try to develop our intuition about SVMs by limiting ourselves to a two-dimensional -plane. To separate the two classes of data points, there are many -possible lines (hyperplanes if you prefer a more strict naming) -that could be chosen. Our objective is to find a -plane that has the maximum margin, i.e the maximum distance between -data points of both classes. Maximizing the margin distance provides -some reinforcement so that future data points can be classified with -more confidence. - -What a linear classifier attempts to accomplish is to split the -feature space into two half spaces by placing a hyperplane between the -data points. This hyperplane will be our decision boundary. All -points on one side of the plane will belong to class one and all points -on the other side of the plane will belong to the second class two. - -Unfortunately there are many ways in which we can place a hyperplane -to divide the data. Below is an example of two candidate hyperplanes -for our data sample. - - -Let us define the function - -$$ -f(x) = \boldsymbol{w}^T\boldsymbol{x}+b = 0, -$$ - -as the function that determines the line $L$ that separates two classes (our two features), see the figure here. - - -Any point defined by $\boldsymbol{x}_i$ and $\boldsymbol{x}_2$ on the line $L$ will satisfy $\boldsymbol{w}^T(\boldsymbol{x}_1-\boldsymbol{x}_2)=0$. - -The signed distance $\delta$ from any point defined by a vector $\boldsymbol{x}$ and a point $\boldsymbol{x}_0$ on the line $L$ is then - -$$ -\delta = \frac{1}{\vert\vert \boldsymbol{w}\vert\vert}(\boldsymbol{w}^T\boldsymbol{x}+b). -$$ - -How do we find the parameter $b$ and the vector $\boldsymbol{w}$? What we could -do is to define a cost function which now contains the set of all -misclassified points $M$ and attempt to minimize this function - -$$ -C(\boldsymbol{w},b) = -\sum_{i\in M} y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b). -$$ - -We could now for example define all values $y_i =1$ as misclassified in case we have $\boldsymbol{w}^T\boldsymbol{x}_i+b < 0$ and the opposite if we have $y_i=-1$. Taking the derivatives gives us - -$$ -\frac{\partial C}{\partial b} = -\sum_{i\in M} y_i, -$$ - -and - -$$ -\frac{\partial C}{\partial \boldsymbol{w}} = -\sum_{i\in M} y_ix_i. -$$ - -We can now use the Newton-Raphson method or different variants of the gradient descent family (from plain gradient descent to various stochastic gradient descent approaches) to solve the equations - -$$ -b \leftarrow b +\eta \frac{\partial C}{\partial b}, -$$ - -and - -$$ -\boldsymbol{w} \leftarrow \boldsymbol{w} +\eta \frac{\partial C}{\partial \boldsymbol{w}}, -$$ - -where $\eta$ is our by now well-known learning rate. - - - -The equations we discussed above can be coded rather easily (the -framework is similar to what we developed for logistic -regression). We are going to set up a simple case with two classes only and we want to find a line which separates them the best possible way. - -There are however problems with this approach, although it looks -pretty straightforward to implement. When running the above code, we see that we can easily end up with many diffeent lines which separate the two classes. - - -For small -gaps between the entries, we may also end up needing many iterations -before the solutions converge and if the data cannot be separated -properly into two distinct classes, we may not experience a converge -at all. - - -### A better approach - -A better approach is rather to try to define a large margin between -the two classes (if they are well separated from the beginning). - -Thus, we wish to find a margin $M$ with $\boldsymbol{w}$ normalized to -$\vert\vert \boldsymbol{w}\vert\vert =1$ subject to the condition - -$$ -y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b) \geq M \hspace{0.1cm}\forall i=1,2,\dots, p. -$$ - -All points are thus at a signed distance from the decision boundary defined by the line $L$. The parameters $b$ and $w_1$ and $w_2$ define this line. - -We seek thus the largest value $M$ defined by - -$$ -\frac{1}{\vert \vert \boldsymbol{w}\vert\vert}y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b) \geq M \hspace{0.1cm}\forall i=1,2,\dots, n, -$$ - -or just - -$$ -y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b) \geq M\vert \vert \boldsymbol{w}\vert\vert \hspace{0.1cm}\forall i. -$$ - -If we scale the equation so that $\vert \vert \boldsymbol{w}\vert\vert = 1/M$, we have to find the minimum of -$\boldsymbol{w}^T\boldsymbol{w}=\vert \vert \boldsymbol{w}\vert\vert$ (the norm) subject to the condition - -$$ -y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b) \geq 1 \hspace{0.1cm}\forall i. -$$ - -We have thus defined our margin as the invers of the norm of -$\boldsymbol{w}$. We want to minimize the norm in order to have a as large as -possible margin $M$. Before we proceed, we need to remind ourselves -about Lagrangian multipliers. - - -## A quick Reminder on Lagrangian Multipliers - -Consider a function of three independent variables $f(x,y,z)$ . For the function $f$ to be an -extreme we have - -$$ -df=0. -$$ - -A necessary and sufficient condition is - -$$ -\frac{\partial f}{\partial x} =\frac{\partial f}{\partial y}=\frac{\partial f}{\partial z}=0, -$$ - -due to - -$$ -df = \frac{\partial f}{\partial x}dx+\frac{\partial f}{\partial y}dy+\frac{\partial f}{\partial z}dz. -$$ - -In many problems the variables $x,y,z$ are often subject to constraints (such as those above for the margin) -so that they are no longer all independent. It is possible at least in principle to use each -constraint to eliminate one variable -and to proceed with a new and smaller set of independent varables. - -The use of so-called Lagrangian multipliers is an alternative technique when the elimination -of variables is incovenient or undesirable. Assume that we have an equation of constraint on -the variables $x,y,z$ - -$$ -\phi(x,y,z) = 0, -$$ - -resulting in - -$$ -d\phi = \frac{\partial \phi}{\partial x}dx+\frac{\partial \phi}{\partial y}dy+\frac{\partial \phi}{\partial z}dz =0. -$$ - -Now we cannot set anymore - -$$ -\frac{\partial f}{\partial x} =\frac{\partial f}{\partial y}=\frac{\partial f}{\partial z}=0, -$$ - -if $df=0$ is wanted -because there are now only two independent variables! Assume $x$ and $y$ are the independent -variables. -Then $dz$ is no longer arbitrary. - - -However, we can add to - -$$ -df = \frac{\partial f}{\partial x}dx+\frac{\partial f}{\partial y}dy+\frac{\partial f}{\partial z}dz, -$$ - -a multiplum of $d\phi$, viz. $\lambda d\phi$, resulting in - -$$ -df+\lambda d\phi = (\frac{\partial f}{\partial z}+\lambda -\frac{\partial \phi}{\partial x})dx+(\frac{\partial f}{\partial y}+\lambda\frac{\partial \phi}{\partial y})dy+ -(\frac{\partial f}{\partial z}+\lambda\frac{\partial \phi}{\partial z})dz =0. -$$ - -Our multiplier is chosen so that - -$$ -\frac{\partial f}{\partial z}+\lambda\frac{\partial \phi}{\partial z} =0. -$$ - -We need to remember that we took $dx$ and $dy$ to be arbitrary and thus we must have - -$$ -\frac{\partial f}{\partial x}+\lambda\frac{\partial \phi}{\partial x} =0, -$$ - -and - -$$ -\frac{\partial f}{\partial y}+\lambda\frac{\partial \phi}{\partial y} =0. -$$ - -When all these equations are satisfied, $df=0$. We have four unknowns, $x,y,z$ and -$\lambda$. Actually we want only $x,y,z$, $\lambda$ needs not to be determined, -it is therefore often called -Lagrange's undetermined multiplier. -If we have a set of constraints $\phi_k$ we have the equations - -$$ -\frac{\partial f}{\partial x_i}+\sum_k\lambda_k\frac{\partial \phi_k}{\partial x_i} =0. -$$ - -In order to solve the above problem, we define the following Lagrangian function to be minimized - -$$ -\cal{L}(\lambda,b,\boldsymbol{w})=\frac{1}{2}\boldsymbol{w}^T\boldsymbol{w}-\sum_{i=1}^n\lambda_i\left[y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b)-1\right], -$$ - -where $\lambda_i$ is a so-called Lagrange multiplier subject to the condition $\lambda_i \geq 0$. - -Taking the derivatives with respect to $b$ and $\boldsymbol{w}$ we obtain - -$$ -\frac{\partial \cal{L}}{\partial b} = -\sum_{i} \lambda_iy_i=0, -$$ - -and - -$$ -\frac{\partial \cal{L}}{\partial \boldsymbol{w}} = 0 = \boldsymbol{w}-\sum_{i} \lambda_iy_i\boldsymbol{x}_i. -$$ - -Inserting these constraints into the equation for $\cal{L}$ we obtain - -$$ -\cal{L}=\sum_i\lambda_i-\frac{1}{2}\sum_{ij}^n\lambda_i\lambda_jy_iy_j\boldsymbol{x}_i^T\boldsymbol{x}_j, -$$ - -subject to the constraints $\lambda_i\geq 0$ and $\sum_i\lambda_iy_i=0$. -We must in addition satisfy the [Karush-Kuhn-Tucker](https://en.wikipedia.org/wiki/Karush%E2%80%93Kuhn%E2%80%93Tucker_conditions) (KKT) condition - -$$ -\lambda_i\left[y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b) -1\right] \hspace{0.1cm}\forall i. -$$ - -1. If $\lambda_i > 0$, then $y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b)=1$ and we say that $x_i$ is on the boundary. - -2. If $y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b)> 1$, we say $x_i$ is not on the boundary and we set $\lambda_i=0$. - -When $\lambda_i > 0$, the vectors $\boldsymbol{x}_i$ are called support vectors. They are the vectors closest to the line (or hyperplane) and define the margin $M$. - - -We can rewrite - -$$ -\cal{L}=\sum_i\lambda_i-\frac{1}{2}\sum_{ij}^n\lambda_i\lambda_jy_iy_j\boldsymbol{x}_i^T\boldsymbol{x}_j, -$$ - -and its constraints in terms of a matrix-vector problem where we minimize w.r.t. $\lambda$ the following problem - -$$ -\frac{1}{2} \boldsymbol{\lambda}^T\begin{bmatrix} y_1y_1\boldsymbol{x}_1^T\boldsymbol{x}_1 & y_1y_2\boldsymbol{x}_1^T\boldsymbol{x}_2 & \dots & \dots & y_1y_n\boldsymbol{x}_1^T\boldsymbol{x}_n \\ -y_2y_1\boldsymbol{x}_2^T\boldsymbol{x}_1 & y_2y_2\boldsymbol{x}_2^T\boldsymbol{x}_2 & \dots & \dots & y_1y_n\boldsymbol{x}_2^T\boldsymbol{x}_n \\ -\dots & \dots & \dots & \dots & \dots \\ -\dots & \dots & \dots & \dots & \dots \\ -y_ny_1\boldsymbol{x}_n^T\boldsymbol{x}_1 & y_ny_2\boldsymbol{x}_n^T\boldsymbol{x}_2 & \dots & \dots & y_ny_n\boldsymbol{x}_n^T\boldsymbol{x}_n \\ -\end{bmatrix}\boldsymbol{\lambda}-\mathbb{1}\boldsymbol{\lambda}, -$$ - -subject to $\boldsymbol{y}^T\boldsymbol{\lambda}=0$. Here we defined the vectors $\boldsymbol{\lambda} =[\lambda_1,\lambda_2,\dots,\lambda_n]$ and -$\boldsymbol{y}=[y_1,y_2,\dots,y_n]$. - - - -Solving the above problem, yields the values of $\lambda_i$. -To find the coefficients of your hyperplane we need simply to compute - -$$ -\boldsymbol{w}=\sum_{i} \lambda_iy_i\boldsymbol{x}_i. -$$ - -With our vector $\boldsymbol{w}$ we can in turn find the value of the intercept $b$ (here in two dimensions) via - -$$ -y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b)=1, -$$ - -resulting in - -$$ -b = \frac{1}{y_i}-\boldsymbol{w}^T\boldsymbol{x}_i, -$$ - -or if we write it out in terms of the support vectors only, with $N_s$ being their number, we have - -$$ -b = \frac{1}{N_s}\sum_{j\in N_s}\left(y_j-\sum_{i=1}^n\lambda_iy_i\boldsymbol{x}_i^T\boldsymbol{x}_j\right). -$$ - -With our hyperplane coefficients we can use our classifier to assign any observation by simply using - -$$ -y_i = \mathrm{sign}(\boldsymbol{w}^T\boldsymbol{x}_i+b). -$$ - -Below we discuss how to find the optimal values of $\lambda_i$. Before we proceed however, we discuss now the so-called soft classifier. - - -## A soft classifier - -Till now, the margin is strictly defined by the support vectors. This defines what is called a hard classifier, that is the margins are well defined. - -Suppose now that classes overlap in feature space, as shown in the -figure here. One way to deal with this problem before we define the -so-called **kernel approach**, is to allow a kind of slack in the sense -that we allow some points to be on the wrong side of the margin. - -We introduce thus the so-called **slack** variables $\boldsymbol{\xi} =[\xi_1,x_2,\dots,x_n]$ and -modify our previous equation - -$$ -y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b)=1, -$$ - -to - -$$ -y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b)=1-\xi_i, -$$ - -with the requirement $\xi_i\geq 0$. The total violation is now $\sum_i\xi$. -The value $\xi_i$ in the constraint the last constraint corresponds to the amount by which the prediction -$y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b)=1$ is on the wrong side of its margin. Hence by bounding the sum $\sum_i \xi_i$, -we bound the total amount by which predictions fall on the wrong side of their margins. - -Misclassifications occur when $\xi_i > 1$. Thus bounding the total sum by some value $C$ bounds in turn the total number of -misclassifications. - - -This has in turn the consequences that we change our optmization problem to finding the minimum of - -$$ -\cal{L}=\frac{1}{2}\boldsymbol{w}^T\boldsymbol{w}-\sum_{i=1}^n\lambda_i\left[y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b)-(1-\xi_)\right]+C\sum_{i=1}^n\xi_i-\sum_{i=1}^n\gamma_i\xi_i, -$$ - -subject to - -$$ -y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b)=1-\xi_i \hspace{0.1cm}\forall i, -$$ - -with the requirement $\xi_i\geq 0$. - -Taking the derivatives with respect to $b$ and $\boldsymbol{w}$ we obtain - -$$ -\frac{\partial \cal{L}}{\partial b} = -\sum_{i} \lambda_iy_i=0, -$$ - -and - -$$ -\frac{\partial \cal{L}}{\partial \boldsymbol{w}} = 0 = \boldsymbol{w}-\sum_{i} \lambda_iy_i\boldsymbol{x}_i, -$$ - -and - -$$ -\lambda_i = C-\gamma_i \hspace{0.1cm}\forall i. -$$ - -Inserting these constraints into the equation for $\cal{L}$ we obtain the same equation as before - -$$ -\cal{L}=\sum_i\lambda_i-\frac{1}{2}\sum_{ij}^n\lambda_i\lambda_jy_iy_j\boldsymbol{x}_i^T\boldsymbol{x}_j, -$$ - -but now subject to the constraints $\lambda_i\geq 0$, $\sum_i\lambda_iy_i=0$ and $0\leq\lambda_i \leq C$. -We must in addition satisfy the Karush-Kuhn-Tucker condition which now reads - -5 -0 - -< -< -< -! -! -M -A -T -H -_ -B -L -O -C -K - -$$ -\gamma_i\xi_i = 0, -$$ - -and - -$$ -y_i(\boldsymbol{w}^T\boldsymbol{x}_i+b) -(1-\xi_) \geq 0 \hspace{0.1cm}\forall i. -$$ - -## Kernels and non-linearity - -The cases we have studied till now, were all characterized by two classes -with a close to linear separability. The classifiers we have described -so far find linear boundaries in our input feature space. It is -possible to make our procedure more flexible by exploring the feature -space using other basis expansions such as higher-order polynomials, -wavelets, splines etc. - -If our feature space is not easy to separate, as shown in the figure -here, we can achieve a better separation by introducing more complex -basis functions. The ideal would be, as shown in the next figure, to, via a specific transformation to -obtain a separation between the classes which is almost linear. - -The change of basis, from $x\rightarrow z=\phi(x)$ leads to the same type of equations to be solved, except that -we need to introduce for example a polynomial transformation to a two-dimensional training set. - -import numpy as np -import os - -np.random.seed(42) - -# To plot pretty figures -import matplotlib -import matplotlib.pyplot as plt -plt.rcParams['axes.labelsize'] = 14 -plt.rcParams['xtick.labelsize'] = 12 -plt.rcParams['ytick.labelsize'] = 12 - - -from sklearn.svm import SVC -from sklearn import datasets - - - -X1D = np.linspace(-4, 4, 9).reshape(-1, 1) -X2D = np.c_[X1D, X1D**2] -y = np.array([0, 0, 1, 1, 1, 1, 1, 0, 0]) - -plt.figure(figsize=(11, 4)) - -plt.subplot(121) -plt.grid(True, which='both') -plt.axhline(y=0, color='k') -plt.plot(X1D[:, 0][y==0], np.zeros(4), "bs") -plt.plot(X1D[:, 0][y==1], np.zeros(5), "g^") -plt.gca().get_yaxis().set_ticks([]) -plt.xlabel(r"$x_1$", fontsize=20) -plt.axis([-4.5, 4.5, -0.2, 0.2]) - -plt.subplot(122) -plt.grid(True, which='both') -plt.axhline(y=0, color='k') -plt.axvline(x=0, color='k') -plt.plot(X2D[:, 0][y==0], X2D[:, 1][y==0], "bs") -plt.plot(X2D[:, 0][y==1], X2D[:, 1][y==1], "g^") -plt.xlabel(r"$x_1$", fontsize=20) -plt.ylabel(r"$x_2$", fontsize=20, rotation=0) -plt.gca().get_yaxis().set_ticks([0, 4, 8, 12, 16]) -plt.plot([-4.5, 4.5], [6.5, 6.5], "r--", linewidth=3) -plt.axis([-4.5, 4.5, -1, 17]) -plt.subplots_adjust(right=1) -plt.show() - -Suppose we define a polynomial transformation of degree two only (we continue to live in a plane with $x_i$ and $y_i$ as variables) - -$$ -z = \phi(x_i) =\left(x_i^2, y_i^2, \sqrt{2}x_iy_i\right). -$$ - -With our new basis, the equations we solved earlier are basically the same, that is we have now (without the slack option for simplicity) - -$$ -\cal{L}=\sum_i\lambda_i-\frac{1}{2}\sum_{ij}^n\lambda_i\lambda_jy_iy_j\boldsymbol{z}_i^T\boldsymbol{z}_j, -$$ - -subject to the constraints $\lambda_i\geq 0$, $\sum_i\lambda_iy_i=0$, and for the support vectors - -$$ -y_i(\boldsymbol{w}^T\boldsymbol{z}_i+b)= 1 \hspace{0.1cm}\forall i, -$$ - -from which we also find $b$. -To compute $\boldsymbol{z}_i^T\boldsymbol{z}_j$ we define the kernel $K(\boldsymbol{x}_i,\boldsymbol{x}_j)$ as - -$$ -K(\boldsymbol{x}_i,\boldsymbol{x}_j)=\boldsymbol{z}_i^T\boldsymbol{z}_j= \phi(\boldsymbol{x}_i)^T\phi(\boldsymbol{x}_j). -$$ - -For the above example, the kernel reads - -$$ -K(\boldsymbol{x}_i,\boldsymbol{x}_j)=[x_i^2, y_i^2, \sqrt{2}x_iy_i]^T\begin{bmatrix} x_j^2 \\ y_j^2 \\ \sqrt{2}x_jy_j \end{bmatrix}=x_i^2x_j^2+2x_ix_jy_iy_j+y_i^2y_j^2. -$$ - -We note that this is nothing but the dot product of the two original -vectors $(\boldsymbol{x}_i^T\boldsymbol{x}_j)^2$. Instead of thus computing the -product in the Lagrangian of $\boldsymbol{z}_i^T\boldsymbol{z}_j$ we simply compute -the dot product $(\boldsymbol{x}_i^T\boldsymbol{x}_j)^2$. - - -This leads to the so-called -kernel trick and the result leads to the same as if we went through -the trouble of performing the transformation -$\phi(\boldsymbol{x}_i)^T\phi(\boldsymbol{x}_j)$ during the SVM calculations. - - - -Using our definition of the kernel We can rewrite again the Lagrangian - -$$ -\cal{L}=\sum_i\lambda_i-\frac{1}{2}\sum_{ij}^n\lambda_i\lambda_jy_iy_j\boldsymbol{x}_i^T\boldsymbol{z}_j, -$$ - -subject to the constraints $\lambda_i\geq 0$, $\sum_i\lambda_iy_i=0$ in terms of a convex optimization problem - -$$ -\frac{1}{2} \boldsymbol{\lambda}^T\begin{bmatrix} y_1y_1K(\boldsymbol{x}_1,\boldsymbol{x}_1) & y_1y_2K(\boldsymbol{x}_1,\boldsymbol{x}_2) & \dots & \dots & y_1y_nK(\boldsymbol{x}_1,\boldsymbol{x}_n) \\ -y_2y_1K(\boldsymbol{x}_2,\boldsymbol{x}_1) & y_2y_2(\boldsymbol{x}_2,\boldsymbol{x}_2) & \dots & \dots & y_1y_nK(\boldsymbol{x}_2,\boldsymbol{x}_n) \\ -\dots & \dots & \dots & \dots & \dots \\ -\dots & \dots & \dots & \dots & \dots \\ -y_ny_1K(\boldsymbol{x}_n,\boldsymbol{x}_1) & y_ny_2K(\boldsymbol{x}_n\boldsymbol{x}_2) & \dots & \dots & y_ny_nK(\boldsymbol{x}_n,\boldsymbol{x}_n) \\ -\end{bmatrix}\boldsymbol{\lambda}-\mathbb{1}\boldsymbol{\lambda}, -$$ - -subject to $\boldsymbol{y}^T\boldsymbol{\lambda}=0$. Here we defined the vectors $\boldsymbol{\lambda} =[\lambda_1,\lambda_2,\dots,\lambda_n]$ and -$\boldsymbol{y}=[y_1,y_2,\dots,y_n]$. -If we add the slack constants this leads to the additional constraint $0\leq \lambda_i \leq C$. - -We can rewrite this (see the solutions below) in terms of a convex optimization problem of the type - -$$ -\begin{align*} - &\mathrm{min}_{\lambda}\hspace{0.2cm} \frac{1}{2}\boldsymbol{\lambda}^T\boldsymbol{P}\boldsymbol{\lambda}+\boldsymbol{q}^T\boldsymbol{\lambda},\\ \nonumber - &\mathrm{subject\hspace{0.1cm}to} \hspace{0.2cm} \boldsymbol{G}\boldsymbol{\lambda} \preceq \boldsymbol{h} \hspace{0.2cm} \wedge \boldsymbol{A}\boldsymbol{\lambda}=f. -\end{align*} -$$ - -Below we discuss how to solve these equations. Here we note that the matrix $\boldsymbol{P}$ has matrix elements $p_{ij}=y_iy_jK(\boldsymbol{x}_i,\boldsymbol{x}_j)$. -Given a kernel $K$ and the targets $y_i$ this matrix is easy to set up. The constraint $\boldsymbol{y}^T\boldsymbol{\lambda}=0$ leads to $f=0$ and $\boldsymbol{A}=\boldsymbol{y}$. How to set up the matrix $\boldsymbol{G}$ is discussed later. Here note that the inequalities $0\leq \lambda_i \leq C$ can be split up into -$0\leq \lambda_i$ and $\lambda_i \leq C$. These two inequalities define then the matrix $\boldsymbol{G}$ and the vector $\boldsymbol{h}$. - - - -## Different kernels and Mercer's theorem - -There are several popular kernels being used. These are -1. Linear: $K(\boldsymbol{x},\boldsymbol{y})=\boldsymbol{x}^T\boldsymbol{y}$, - -2. Polynomial: $K(\boldsymbol{x},\boldsymbol{y})=(\boldsymbol{x}^T\boldsymbol{y}+\gamma)^d$, - -3. Gaussian Radial Basis Function: $K(\boldsymbol{x},\boldsymbol{y})=\exp{\left(-\gamma\vert\vert\boldsymbol{x}-\boldsymbol{y}\vert\vert^2\right)}$, - -4. Tanh: $K(\boldsymbol{x},\boldsymbol{y})=\tanh{(\boldsymbol{x}^T\boldsymbol{y}+\gamma)}$, - -and many other ones. - -An important theorem for us is [Mercer's -theorem](https://en.wikipedia.org/wiki/Mercer%27s_theorem). The -theorem states that if a kernel function $K$ is symmetric, continuous -and leads to a positive semi-definite matrix $\boldsymbol{P}$ then there -exists a function $\phi$ that maps $\boldsymbol{x}_i$ and $\boldsymbol{x}_j$ into -another space (possibly with much higher dimensions) such that - -$$ -K(\boldsymbol{x}_i,\boldsymbol{x}_j)=\phi(\boldsymbol{x}_i)^T\phi(\boldsymbol{x}_j). -$$ - -So you can use $K$ as a kernel since you know $\phi$ exists, even if -you don’t know what $\phi$ is. - -Note that some frequently used kernels (such as the Sigmoid kernel) -don’t respect all of Mercer’s conditions, yet they generally work well -in practice. - - -## The moons example - -from __future__ import division, print_function, unicode_literals - -import numpy as np -np.random.seed(42) - -import matplotlib -import matplotlib.pyplot as plt -plt.rcParams['axes.labelsize'] = 14 -plt.rcParams['xtick.labelsize'] = 12 -plt.rcParams['ytick.labelsize'] = 12 - - -from sklearn.svm import SVC -from sklearn import datasets - - - -from sklearn.pipeline import Pipeline -from sklearn.preprocessing import StandardScaler -from sklearn.svm import LinearSVC - - -from sklearn.datasets import make_moons -X, y = make_moons(n_samples=100, noise=0.15, random_state=42) - -def plot_dataset(X, y, axes): - plt.plot(X[:, 0][y==0], X[:, 1][y==0], "bs") - plt.plot(X[:, 0][y==1], X[:, 1][y==1], "g^") - plt.axis(axes) - plt.grid(True, which='both') - plt.xlabel(r"$x_1$", fontsize=20) - plt.ylabel(r"$x_2$", fontsize=20, rotation=0) - -plot_dataset(X, y, [-1.5, 2.5, -1, 1.5]) -plt.show() - -from sklearn.datasets import make_moons -from sklearn.pipeline import Pipeline -from sklearn.preprocessing import PolynomialFeatures - -polynomial_svm_clf = Pipeline([ - ("poly_features", PolynomialFeatures(degree=3)), - ("scaler", StandardScaler()), - ("svm_clf", LinearSVC(C=10, loss="hinge", random_state=42)) - ]) - -polynomial_svm_clf.fit(X, y) - -def plot_predictions(clf, axes): - x0s = np.linspace(axes[0], axes[1], 100) - x1s = np.linspace(axes[2], axes[3], 100) - x0, x1 = np.meshgrid(x0s, x1s) - X = np.c_[x0.ravel(), x1.ravel()] - y_pred = clf.predict(X).reshape(x0.shape) - y_decision = clf.decision_function(X).reshape(x0.shape) - plt.contourf(x0, x1, y_pred, cmap=plt.cm.brg, alpha=0.2) - plt.contourf(x0, x1, y_decision, cmap=plt.cm.brg, alpha=0.1) - -plot_predictions(polynomial_svm_clf, [-1.5, 2.5, -1, 1.5]) -plot_dataset(X, y, [-1.5, 2.5, -1, 1.5]) - -plt.show() - - -from sklearn.svm import SVC - -poly_kernel_svm_clf = Pipeline([ - ("scaler", StandardScaler()), - ("svm_clf", SVC(kernel="poly", degree=3, coef0=1, C=5)) - ]) -poly_kernel_svm_clf.fit(X, y) - -poly100_kernel_svm_clf = Pipeline([ - ("scaler", StandardScaler()), - ("svm_clf", SVC(kernel="poly", degree=10, coef0=100, C=5)) - ]) -poly100_kernel_svm_clf.fit(X, y) - -plt.figure(figsize=(11, 4)) - -plt.subplot(121) -plot_predictions(poly_kernel_svm_clf, [-1.5, 2.5, -1, 1.5]) -plot_dataset(X, y, [-1.5, 2.5, -1, 1.5]) -plt.title(r"$d=3, r=1, C=5$", fontsize=18) - -plt.subplot(122) -plot_predictions(poly100_kernel_svm_clf, [-1.5, 2.5, -1, 1.5]) -plot_dataset(X, y, [-1.5, 2.5, -1, 1.5]) -plt.title(r"$d=10, r=100, C=5$", fontsize=18) - -plt.show() - -def gaussian_rbf(x, landmark, gamma): - return np.exp(-gamma * np.linalg.norm(x - landmark, axis=1)**2) - -gamma = 0.3 - -x1s = np.linspace(-4.5, 4.5, 200).reshape(-1, 1) -x2s = gaussian_rbf(x1s, -2, gamma) -x3s = gaussian_rbf(x1s, 1, gamma) - -XK = np.c_[gaussian_rbf(X1D, -2, gamma), gaussian_rbf(X1D, 1, gamma)] -yk = np.array([0, 0, 1, 1, 1, 1, 1, 0, 0]) - -plt.figure(figsize=(11, 4)) - -plt.subplot(121) -plt.grid(True, which='both') -plt.axhline(y=0, color='k') -plt.scatter(x=[-2, 1], y=[0, 0], s=150, alpha=0.5, c="red") -plt.plot(X1D[:, 0][yk==0], np.zeros(4), "bs") -plt.plot(X1D[:, 0][yk==1], np.zeros(5), "g^") -plt.plot(x1s, x2s, "g--") -plt.plot(x1s, x3s, "b:") -plt.gca().get_yaxis().set_ticks([0, 0.25, 0.5, 0.75, 1]) -plt.xlabel(r"$x_1$", fontsize=20) -plt.ylabel(r"Similarity", fontsize=14) -plt.annotate(r'$\mathbf{x}$', - xy=(X1D[3, 0], 0), - xytext=(-0.5, 0.20), - ha="center", - arrowprops=dict(facecolor='black', shrink=0.1), - fontsize=18, - ) -plt.text(-2, 0.9, "$x_2$", ha="center", fontsize=20) -plt.text(1, 0.9, "$x_3$", ha="center", fontsize=20) -plt.axis([-4.5, 4.5, -0.1, 1.1]) - -plt.subplot(122) -plt.grid(True, which='both') -plt.axhline(y=0, color='k') -plt.axvline(x=0, color='k') -plt.plot(XK[:, 0][yk==0], XK[:, 1][yk==0], "bs") -plt.plot(XK[:, 0][yk==1], XK[:, 1][yk==1], "g^") -plt.xlabel(r"$x_2$", fontsize=20) -plt.ylabel(r"$x_3$ ", fontsize=20, rotation=0) -plt.annotate(r'$\phi\left(\mathbf{x}\right)$', - xy=(XK[3, 0], XK[3, 1]), - xytext=(0.65, 0.50), - ha="center", - arrowprops=dict(facecolor='black', shrink=0.1), - fontsize=18, - ) -plt.plot([-0.1, 1.1], [0.57, -0.1], "r--", linewidth=3) -plt.axis([-0.1, 1.1, -0.1, 1.1]) - -plt.subplots_adjust(right=1) - -plt.show() - - -x1_example = X1D[3, 0] -for landmark in (-2, 1): - k = gaussian_rbf(np.array([[x1_example]]), np.array([[landmark]]), gamma) - print("Phi({}, {}) = {}".format(x1_example, landmark, k)) - -rbf_kernel_svm_clf = Pipeline([ - ("scaler", StandardScaler()), - ("svm_clf", SVC(kernel="rbf", gamma=5, C=0.001)) - ]) -rbf_kernel_svm_clf.fit(X, y) - - -from sklearn.svm import SVC - -gamma1, gamma2 = 0.1, 5 -C1, C2 = 0.001, 1000 -hyperparams = (gamma1, C1), (gamma1, C2), (gamma2, C1), (gamma2, C2) - -svm_clfs = [] -for gamma, C in hyperparams: - rbf_kernel_svm_clf = Pipeline([ - ("scaler", StandardScaler()), - ("svm_clf", SVC(kernel="rbf", gamma=gamma, C=C)) - ]) - rbf_kernel_svm_clf.fit(X, y) - svm_clfs.append(rbf_kernel_svm_clf) - -plt.figure(figsize=(11, 7)) - -for i, svm_clf in enumerate(svm_clfs): - plt.subplot(221 + i) - plot_predictions(svm_clf, [-1.5, 2.5, -1, 1.5]) - plot_dataset(X, y, [-1.5, 2.5, -1, 1.5]) - gamma, C = hyperparams[i] - plt.title(r"$\gamma = {}, C = {}$".format(gamma, C), fontsize=16) - -plt.show() - -## Mathematical optimization of convex functions - -A mathematical (quadratic) optimization problem, or just optimization problem, has the form - -$$ -\begin{align*} - &\mathrm{min}_{\lambda}\hspace{0.2cm} \frac{1}{2}\boldsymbol{\lambda}^T\boldsymbol{P}\boldsymbol{\lambda}+\boldsymbol{q}^T\boldsymbol{\lambda},\\ \nonumber - &\mathrm{subject\hspace{0.1cm}to} \hspace{0.2cm} \boldsymbol{G}\boldsymbol{\lambda} \preceq \boldsymbol{h} \wedge \boldsymbol{A}\boldsymbol{\lambda}=f. -\end{align*} -$$ - -subject to some constraints for say a selected set $i=1,2,\dots, n$. -In our case we are optimizing with respect to the Lagrangian multipliers $\lambda_i$, and the -vector $\boldsymbol{\lambda}=[\lambda_1, \lambda_2,\dots, \lambda_n]$ is the optimization variable we are dealing with. - -In our case we are particularly interested in a class of optimization problems called convex optmization problems. -In our discussion on gradient descent methods we discussed at length the definition of a convex function. - -Convex optimization problems play a central role in applied mathematics and we recommend strongly [Boyd and Vandenberghe's text on the topics](http://web.stanford.edu/~boyd/cvxbook/). - - - - -If we use Python as programming language and wish to venture beyond -**scikit-learn**, **tensorflow** and similar software which makes our -lives so much easier, we need to dive into the wonderful world of -quadratic programming. We can, if we wish, solve the minimization -problem using say standard gradient methods or conjugate gradient -methods. However, these methods tend to exhibit a rather slow -converge. So, welcome to the promised land of quadratic programming. - -The functions we need are contained in the quadratic programming package **CVXOPT** and we need to import it together with **numpy** as - -import numpy -import cvxopt - -This will make our life much easier. You don't need t write your own optimizer. - - - -We remind ourselves about the general problem we want to solve - -$$ -\begin{align*} - &\mathrm{min}_{x}\hspace{0.2cm} \frac{1}{2}\boldsymbol{x}^T\boldsymbol{P}\boldsymbol{x}+\boldsymbol{q}^T\boldsymbol{x},\\ \nonumber - &\mathrm{subject\hspace{0.1cm} to} \hspace{0.2cm} \boldsymbol{G}\boldsymbol{x} \preceq \boldsymbol{h} \wedge \boldsymbol{A}\boldsymbol{x}=f. -\end{align*} -$$ - -Let us show how to perform the optmization using a simple case. Assume we want to optimize the following problem - -$$ -\begin{align*} - &\mathrm{min}_{x}\hspace{0.2cm} \frac{1}{2}x^2+5x+3y \\ \nonumber - &\mathrm{subject to} \\ \nonumber - &x, y \geq 0 \\ \nonumber - &x+3y \geq 15 \\ \nonumber - &2x+5y \leq 100 \\ \nonumber - &3x+4y \leq 80. \\ \nonumber -\end{align*} -$$ - -The minimization problem can be rewritten in terms of vectors and matrices as (with $x$ and $y$ being the unknowns) - -$$ -\frac{1}{2}\begin{bmatrix} x\\ y \end{bmatrix}^T \begin{bmatrix} 1 & 0\\ 0 & 0 \end{bmatrix} \begin{bmatrix} x \\ y \end{bmatrix} + \begin{bmatrix}3\\ 4 \end{bmatrix}^T \begin{bmatrix}x \\ y \end{bmatrix}. -$$ - -Similarly, we can now set up the inequalities (we need to change $\geq$ to $\leq$ by multiplying with $-1$ on bot sides) as the following matrix-vector equation - -$$ -\begin{bmatrix} -1 & 0 \\ 0 & -1 \\ -1 & -3 \\ 2 & 5 \\ 3 & 4\end{bmatrix}\begin{bmatrix} x \\ y\end{bmatrix} \preceq \begin{bmatrix}0 \\ 0\\ -15 \\ 100 \\ 80\end{bmatrix}. -$$ - -We have collapsed all the inequalities into a single matrix $\boldsymbol{G}$. We see also that our matrix - -$$ -\boldsymbol{P} =\begin{bmatrix} 1 & 0\\ 0 & 0 \end{bmatrix} -$$ - -is clearly positive semi-definite (all eigenvalues larger or equal zero). -Finally, the vector $\boldsymbol{h}$ is defined as - -$$ -\boldsymbol{h} = \begin{bmatrix}0 \\ 0\\ -15 \\ 100 \\ 80\end{bmatrix}. -$$ - -Since we don't have any equalities the matrix $\boldsymbol{A}$ is set to zero -The following code solves the equations for us - -# Import the necessary packages -import numpy -from cvxopt import matrix -from cvxopt import solvers -P = matrix(numpy.diag([1,0]), tc=’d’) -q = matrix(numpy.array([3,4]), tc=’d’) -G = matrix(numpy.array([[-1,0],[0,-1],[-1,-3],[2,5],[3,4]]), tc=’d’) -h = matrix(numpy.array([0,0,-15,100,80]), tc=’d’) -# Construct the QP, invoke solver -sol = solvers.qp(P,q,G,h) -# Extract optimal value and solution -sol[’x’] -sol[’primal objective’] - -We are now ready to return to our setup of the optmization problem for a more realistic case. Introducing the **slack** parameter $C$ we have - -$$ -\frac{1}{2} \boldsymbol{\lambda}^T\begin{bmatrix} y_1y_1K(\boldsymbol{x}_1,\boldsymbol{x}_1) & y_1y_2K(\boldsymbol{x}_1,\boldsymbol{x}_2) & \dots & \dots & y_1y_nK(\boldsymbol{x}_1,\boldsymbol{x}_n) \\ -y_2y_1K(\boldsymbol{x}_2,\boldsymbol{x}_1) & y_2y_2K(\boldsymbol{x}_2,\boldsymbol{x}_2) & \dots & \dots & y_1y_nK(\boldsymbol{x}_2,\boldsymbol{x}_n) \\ -\dots & \dots & \dots & \dots & \dots \\ -\dots & \dots & \dots & \dots & \dots \\ -y_ny_1K(\boldsymbol{x}_n,\boldsymbol{x}_1) & y_ny_2K(\boldsymbol{x}_n\boldsymbol{x}_2) & \dots & \dots & y_ny_nK(\boldsymbol{x}_n,\boldsymbol{x}_n) \\ -\end{bmatrix}\boldsymbol{\lambda}-\mathbb{I}\boldsymbol{\lambda}, -$$ - -subject to $\boldsymbol{y}^T\boldsymbol{\lambda}=0$. Here we defined the vectors $\boldsymbol{\lambda} =[\lambda_1,\lambda_2,\dots,\lambda_n]$ and -$\boldsymbol{y}=[y_1,y_2,\dots,y_n]$. -With the slack constants this leads to the additional constraint $0\leq \lambda_i \leq C$. - -**code will be added** \ No newline at end of file diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter5_109_0.png b/doc/LectureNotes/_build/jupyter_execute/chapter5_109_0.png deleted file mode 100644 index 7bcfb46bd..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter5_109_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter5_129_0.png b/doc/LectureNotes/_build/jupyter_execute/chapter5_129_0.png deleted file mode 100644 index 562496744..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter5_129_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter5_129_2.png b/doc/LectureNotes/_build/jupyter_execute/chapter5_129_2.png deleted file mode 100644 index b02ae1d94..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter5_129_2.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter5_129_3.png b/doc/LectureNotes/_build/jupyter_execute/chapter5_129_3.png deleted file mode 100644 index b319b08d2..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter5_129_3.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter5_129_4.png b/doc/LectureNotes/_build/jupyter_execute/chapter5_129_4.png deleted file mode 100644 index 696d0ceca..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter5_129_4.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter5_129_6.png b/doc/LectureNotes/_build/jupyter_execute/chapter5_129_6.png deleted file mode 100644 index abc25e8e9..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter5_129_6.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter5_1_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter5_1_1.png deleted file mode 100644 index 3478cb5ff..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter5_1_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter6.ipynb b/doc/LectureNotes/_build/jupyter_execute/chapter6.ipynb deleted file mode 100644 index 23471fc56..000000000 --- a/doc/LectureNotes/_build/jupyter_execute/chapter6.ipynb +++ /dev/null @@ -1,1367 +0,0 @@ -{ - "cells": [ - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "# Decision trees, overarching aims\n", - "\n", - "\n", - "We start here with the most basic algorithm, the so-called decision\n", - "tree. With this basic algorithm we can in turn build more complex\n", - "networks, spanning from homogeneous and heterogenous forests (bagging,\n", - "random forests and more) to one of the most popular supervised\n", - "algorithms nowadays, the extreme gradient boosting, or just\n", - "XGBoost. But let us start with the simplest possible ingredient.\n", - "\n", - "Decision trees are supervised learning algorithms used for both,\n", - "classification and regression tasks.\n", - "\n", - "\n", - "The main idea of decision trees\n", - "is to find those descriptive features which contain the most\n", - "**information** regarding the target feature and then split the dataset\n", - "along the values of these features such that the target feature values\n", - "for the resulting underlying datasets are as pure as possible.\n", - "\n", - "The descriptive features which reproduce best the target/output features are normally said\n", - "to be the most informative ones. The process of finding the **most\n", - "informative** feature is done until we accomplish a stopping criteria\n", - "where we then finally end up in so called **leaf nodes**. \n", - "\n", - "## Basics of a tree\n", - "\n", - "A decision tree is typically divided into a **root node**, the **interior nodes**,\n", - "and the final **leaf nodes** or just **leaves**. These entities are then connected by so-called **branches**.\n", - "\n", - "The leaf nodes\n", - "contain the predictions we will make for new query instances presented\n", - "to our trained model. This is possible since the model has \n", - "learned the underlying structure of the training data and hence can,\n", - "given some assumptions, make predictions about the target feature value\n", - "(class) of unseen query instances.\n", - "\n", - "\n", - "## General Features\n", - "\n", - "The overarching approach to decision trees is a top-down approach.\n", - "\n", - "* A leaf provides the classification of a given instance.\n", - "\n", - "* A node specifies a test of some attribute of the instance.\n", - "\n", - "* A branch corresponds to a possible values of an attribute.\n", - "\n", - "* An instance is classified by starting at the root node of the tree, testing the attribute specified by this node, then moving down the tree branch corresponding to the value of the attribute in the given example.\n", - "\n", - "This process is then repeated for the subtree rooted at the new\n", - "node.\n", - "\n", - "\n", - "\n", - "In simplified terms, the process of training a decision tree and\n", - "predicting the target features of query instances is as follows:\n", - "\n", - "1. Present a dataset containing of a number of training instances characterized by a number of descriptive features and a target feature\n", - "\n", - "2. Train the decision tree model by continuously splitting the target feature along the values of the descriptive features using a measure of information gain during the training process\n", - "\n", - "3. Grow the tree until we accomplish a stopping criteria create leaf nodes which represent the *predictions* we want to make for new query instances\n", - "\n", - "4. Show query instances to the tree and run down the tree until we arrive at leaf nodes\n", - "\n", - "Then we are essentially done!" - ] - }, - { - "cell_type": "code", - "execution_count": 1, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "2nd degree coefficients:\n", - "zero power: -2.575591916051299\n", - "first power: -0.07310737041838755\n", - "second power: 0.0002644543695187602\n" - ] - }, - { - "data": { - "image/png": "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10a85lPZgoICfv75Z+644w4A2rRpw++//05oaCirVq3iySefZOnSpQBs376dbdu2ERERQevWrbnvvvsIDQ3lueeeY8uWLZhMJgYPHkyXLl0AuO+++5gwYQITJkzggw8+4P777+err74CIDU1lT/++IMVK1YwatQo1q1bx7x58+jRowfbt2+nc+fOReTs168f69evp6CggFatWtG7d29++OEHrrzySnbs2EGPHj3Izs5mw4YNCCGYN28eM2fOZPbs2W77/dhjj5Gens6HH37ok2G4a9eu7N+/n6uvvpr//Oc/1KxZk4KCAoYOHcrOnTu5//77+d///sevv/5K7dq1AdyW69ixo0+/iyJ4CUrlIKXMF0LcC/wAhAAfSCn3+Ks9XTlYbVYArDZrkc+Kqkt2djadO3fm5MmTtG3bluHDhwNgtVqZMGECf//9N0II8vLyHMcMHToUk0mbbmzXrh1Hjx4lOTmZQYMGoU9hjh07lr/++gvQpn++/FJLJX3rrbcWGW1cddVVCCG4+OKLqVu3LhdffDEA7du358iRI8WUQ9++fR3KoU+fPvTs2ZMXXniBbdu20aZNG4xGI3///Tdjx44lMTGR3Nxcj+sHXnzxRXr16sV7773n8/lyzu/yxRdf8N5775Gfn09iYiJ79+51+9D3tZyiahGUygFASvkd8F1ltGWKMHEu+xzpuVqyMXfTS4ry4esbfkWj2xyysrK47LLLeOutt7j//vt55plnGDx4MMuWLePIkSMMGjTIcUxERITjc0hICPn5+WVuX6/LYDAUqddgMLitt1+/frzxxhsUFBRw1113ERsbi81mY/Xq1Q57w3333cfDDz/MqFGjWL16NdOnT3fbdo8ePdiyZQspKSnUrFnTJ3m3bdvG0KFDOXz4MLNmzWLTpk3UqFGDiRMnul2r4Gs5RdUjWG0OlYrZaOaY9Zjju1IO1Y+oqCjmzJnD7Nmzyc/Px2q10rCh5gD30UcfeT2+V69e/Pbbb5w7d468vDwWL17s2Ne3b18+//xzABYuXMiAAQPKLGfbtm05deoUa9eudUxbde7cmblz59KvXz+AIrJ//PHHHusaMWIETzzxBFdccQXp6SVnWZVSMmfOHBITExkxYgRpaWlER0djMpk4c+aMww4BEBsb66ivpHKKqo1SDmjK4ajlfFhzpRyqJ126dKFjx4589tlnPP7440ybNo0uXbr4NDKoX78+06dPp0+fPvTr14+2bds69r3xxht8+OGHdOzYkQULFvD666+XWUYhBL169aJWrVqOWER9+vThn3/+cYwcpk+fzpgxY+jWrZtj3t8TY8aM4a677mLUqFFkZ2cX2//YY485XFk3bdrEr7/+Snh4OJ06daJLly60adOGm266yaGYACZNmsSIESMYPHhwieUUVZtqkUO6e/fusjzJfu5ccSfzt813fF88ZjEbT27klfWvEGoIJffpXLXKswzs27evyENUceGiroXgRAixRUrZ3d0+NXJAGzk44zxyyC/MJytP+XQrFIoLC6UcOL8QTsdZOejfFQqF4kJCKQeKjxysNivWnPMurM6fFQqF4kJAKQeKKocQEeIYOYSIEECNHBQKxYWHUg4UVQ4N4xpiydGUQyOTFsFDKQeFQnGhoZQD55VDXEQctSJrOUYOTc1NAaUcFArFhYdSDoDJqBmkzUYzZqPZET5DVw4qhEbV5Pjx4wwePJh27drRvn37Mq0/GDRoEO7cpAcNGkTr1q3p2LEjbdq04d57762wcODlZfXq1ZhMJjp37kznzp0ZNmwYmzdv5v7773fs14P5KRSeCNrwGZWJPnIwRZgwGU3sObuHnIIcmpiaAGrkUFUJDQ1l9uzZdO3alfT0dLp168bw4cNp165ikgouXLiQ7t27k5uby7Rp07j66qv57bffyl1vfn4+oaHluzUHDBjAN998U2Rb9+6aO/vq1auJiYmp8PDfispn165d1KtXj/KkLfCEGjlwXjnoI4cjliMA1I2uS0RIhFIOVZT69evTtWtXQAv50LZtW0fI7kGDBjF16lR69uzJRRddxO+//w5ogfpuvPFG2rZty+jRo92uKnYlPDycmTNncuzYMXbs2AHAp59+Ss+ePencuTN33323I1z2/PnzHWG/77rrriLJeSZPnkyvXr14/PHHOXToECNGjKBbt24MGDCA/fv3A5CUlMR1111Hjx496NGjR5HQ4SWxevVqrrzySo4cOcLcuXN59dVX6dy5s6PfiqpJjx49eOWVV/xStxo5ADHhMRiEQVMOEWbyCrUInbqyUMqhAnjwQdi+vWLr7NwZXnvNp6JHjhxh27Zt9OrVy7EtPz+fjRs38t133/H888+zatUq3nnnHaKioti3bx87d+50KBdvhISE0KlTJ/bv3094eDiL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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter6_1_1.png" - }, - "needs_background": "light" - }, - "output_type": "display_data" - }, - { - "data": { - "image/png": "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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter6_1_2.png" - }, - "needs_background": "light" - }, - "output_type": "display_data" - } - ], - "source": [ - "%matplotlib inline\n", - "\n", - "import numpy as np\n", - "import matplotlib.pyplot as plt\n", - "from sklearn.preprocessing import PolynomialFeatures\n", - "from sklearn.linear_model import LinearRegression\n", - "\n", - "steps=250\n", - "\n", - "distance=0\n", - "x=0\n", - "distance_list=[]\n", - "steps_list=[]\n", - "while x\u001b[0m in \u001b[0;36m\u001b[0;34m\u001b[0m\n\u001b[1;32m 7\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m 8\u001b[0m \u001b[0;32mfrom\u001b[0m \u001b[0mIPython\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mdisplay\u001b[0m \u001b[0;32mimport\u001b[0m \u001b[0mImage\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0;32m----> 9\u001b[0;31m \u001b[0;32mfrom\u001b[0m \u001b[0mpydot\u001b[0m \u001b[0;32mimport\u001b[0m \u001b[0mgraph_from_dot_data\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0m\u001b[1;32m 10\u001b[0m \u001b[0;32mimport\u001b[0m \u001b[0mpandas\u001b[0m \u001b[0;32mas\u001b[0m \u001b[0mpd\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m 11\u001b[0m \u001b[0;32mimport\u001b[0m \u001b[0mnumpy\u001b[0m \u001b[0;32mas\u001b[0m \u001b[0mnp\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n", - "\u001b[0;31mModuleNotFoundError\u001b[0m: No module named 'pydot'" - ] - } - ], - "source": [ - "import os\n", - "from sklearn.datasets import load_breast_cancer\n", - "from sklearn.tree import DecisionTreeClassifier\n", - "from sklearn.model_selection import train_test_split\n", - "from sklearn.metrics import confusion_matrix\n", - "from sklearn.tree import export_graphviz\n", - "\n", - "from IPython.display import Image \n", - "from pydot import graph_from_dot_data\n", - "import pandas as pd\n", - "import numpy as np\n", - "\n", - "\n", - "cancer = load_breast_cancer()\n", - "X = pd.DataFrame(cancer.data, columns=cancer.feature_names)\n", - "print(X)\n", - "y = pd.Categorical.from_codes(cancer.target, cancer.target_names)\n", - "y = pd.get_dummies(y)\n", - "print(y)\n", - "X_train, X_test, y_train, y_test = train_test_split(X, y, random_state=1)\n", - "tree_clf = DecisionTreeClassifier(max_depth=5)\n", - "tree_clf.fit(X_train, y_train)\n", - "\n", - "export_graphviz(\n", - " tree_clf,\n", - " out_file=\"DataFiles/cancer.dot\",\n", - " feature_names=cancer.feature_names,\n", - " class_names=cancer.target_names,\n", - " rounded=True,\n", - " filled=True\n", - ")\n", - "cmd = 'dot -Tpng DataFiles/cancer.dot -o DataFiles/cancer.png'\n", - "os.system(cmd)" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "# Common imports\n", - "import numpy as np\n", - "from sklearn.model_selection import train_test_split \n", - "from sklearn.tree import DecisionTreeClassifier\n", - "from sklearn.datasets import make_moons\n", - "from sklearn.tree import export_graphviz\n", - "from pydot import graph_from_dot_data\n", - "import pandas as pd\n", - "import os\n", - "\n", - "np.random.seed(42)\n", - "X, y = make_moons(n_samples=100, noise=0.25, random_state=53)\n", - "X_train, X_test, y_train, y_test = train_test_split(X,y,random_state=0)\n", - "tree_clf = DecisionTreeClassifier(max_depth=5)\n", - "tree_clf.fit(X_train, y_train)\n", - "\n", - "export_graphviz(\n", - " tree_clf,\n", - " out_file=\"DataFiles/moons.dot\",\n", - " rounded=True,\n", - " filled=True\n", - ")\n", - "cmd = 'dot -Tpng DataFiles/moons.dot -o DataFiles/moons.png'\n", - "os.system(cmd)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "### Other ways of visualizing the trees\n", - "\n", - "**Scikit-Learn** has also another way to visualize the trees which is very useful, here with the Iris data." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "from sklearn.datasets import load_iris\n", - "from sklearn import tree\n", - "X, y = load_iris(return_X_y=True)\n", - "tree_clf = tree.DecisionTreeClassifier()\n", - "tree_clf = tree_clf.fit(X, y)\n", - "# and then plot the tree\n", - "tree.plot_tree(tree_clf)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Alternatively, the tree can also be exported in textual format with the function exporttext.\n", - "This method doesn’t require the installation of external libraries and is more compact:" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "from sklearn.datasets import load_iris\n", - "from sklearn.tree import DecisionTreeClassifier\n", - "from sklearn.tree import export_text\n", - "iris = load_iris()\n", - "decision_tree = DecisionTreeClassifier(random_state=0, max_depth=2)\n", - "decision_tree = decision_tree.fit(iris.data, iris.target)\n", - "r = export_text(decision_tree, feature_names=iris['feature_names'])\n", - "print(r)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Algorithms for Setting up Decision Trees\n", - "\n", - "Two algorithms stand out in the set up of decision trees:\n", - "1. The CART (Classification And Regression Tree) algorithm for both classification and regression\n", - "\n", - "2. The ID3 algorithm based on the computation of the information gain for classification\n", - "\n", - "We discuss both algorithms with applications here. The popular library\n", - "**Scikit-Learn** uses the CART algorithm. For classification problems\n", - "you can use either the **gini** index or the **entropy** to split a tree\n", - "in two branches.\n", - "\n", - "### The CART algorithm for Classification\n", - "\n", - "For classification, the CART algorithm splits the data set in two subsets using a single feature $k$ and a threshold $t_k$.\n", - "This could be for example a threshold set by a number below a certain circumference of a malign tumor.\n", - "\n", - "How do we find these two quantities?\n", - "We search for the pair $(k,t_k)$ that produces the purest subset using for example the **gini** factor $G$.\n", - "The cost function it tries to minimize is then" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(k,t_k) = \\frac{m_{\\mathrm{left}}}{m}G_{\\mathrm{left}}+ \\frac{m_{\\mathrm{right}}}{m}G_{\\mathrm{right}},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $G_{\\mathrm{left/right}}$ measures the impurity of the left/right subset and $m_{\\mathrm{left/right}}$\n", - " is the number of instances in the left/right subset\n", - "\n", - "Once it has successfully split the training set in two, it splits the subsets using the same logic, then the subsubsets\n", - "and so on, recursively. It stops recursing once it reaches the maximum depth (defined by the\n", - "$max\\_depth$ hyperparameter), or if it cannot find a split that will reduce impurity. A few other\n", - "hyperparameters control additional stopping conditions such as the $min\\_samples\\_split$,\n", - "$min\\_samples\\_leaf$, $min\\_weight\\_fraction\\_leaf$, and $max\\_leaf\\_nodes$.\n", - "\n", - "\n", - "### The CART algorithm for Regression\n", - "\n", - "The CART algorithm for regression works is similar to the one for classification except that instead of trying to split the\n", - "training set in a way that minimizes say the **gini** or **entropy** impurity, it now tries to split the training set in a way that minimizes our well-known mean-squared error (MSE). The cost function is now" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(k,t_k) = \\frac{m_{\\mathrm{left}}}{m}\\mathrm{MSE}_{\\mathrm{left}}+ \\frac{m_{\\mathrm{right}}}{m}\\mathrm{MSE}_{\\mathrm{right}}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Here the MSE for a specific node is defined as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathrm{MSE}_{\\mathrm{node}}=\\frac{1}{m_\\mathrm{node}}\\sum_{i\\in \\mathrm{node}}(\\overline{y}_{\\mathrm{node}}-y_i)^2,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\overline{y}_{\\mathrm{node}}=\\frac{1}{m_\\mathrm{node}}\\sum_{i\\in \\mathrm{node}}y_i,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "the mean value of all observations in a specific node.\n", - "\n", - "Without any regularization, the regression task for decision trees, \n", - "just like for classification tasks, is prone to overfitting.\n", - "\n", - "\n", - "\n", - "### Computing the Gini index\n", - "\n", - "The example we will look at is a classical one in many Machine\n", - "Learning applications. Based on various meteorological features, we\n", - "have several so-called attributes which decide whether we at the end\n", - "will do some outdoor activity like skiing, going for a bike ride etc\n", - "etc. The table here contains the feautures **outlook**, **temperature**,\n", - "**humidity** and **wind**. The target or output is whether we ride\n", - "(True=1) or whether we do something else that day (False=0). The\n", - "attributes for each feature are then sunny, overcast and rain for the\n", - "outlook, hot, cold and mild for temperature, high and normal for\n", - "humidity and weak and strong for wind.\n", - "\n", - "The table here summarizes the various attributes and\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "
Day Outlook Temperature Humidity Wind Ride
1 Sunny Hot High Weak 0
2 Sunny Hot High Strong 1
3 Overcast Hot High Weak 1
4 Rain Mild High Weak 1
5 Rain Cool Normal Weak 1
6 Rain Cool Normal Strong 0
7 Overcast Cool Normal Strong 1
8 Sunny Mild High Weak 0
9 Sunny Cool Normal Weak 1
10 Rain Mild Normal Weak 1
11 Sunny Mild Normal Strong 1
12 Overcast Mild High Strong 1
13 Overcast Hot Normal Weak 1
14 Rain Mild High Strong 0
\n", - "\n", - "### Simple Python Code to read in Data and perform Classification" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "# Common imports\n", - "import numpy as np\n", - "import pandas as pd\n", - "import matplotlib.pyplot as plt\n", - "from sklearn.tree import DecisionTreeClassifier\n", - "from sklearn.model_selection import train_test_split\n", - "from sklearn.tree import export_graphviz\n", - "from sklearn.preprocessing import StandardScaler, OneHotEncoder\n", - "from sklearn.compose import ColumnTransformer\n", - "from IPython.display import Image \n", - "from pydot import graph_from_dot_data\n", - "import os\n", - "\n", - "# Where to save the figures and data files\n", - "PROJECT_ROOT_DIR = \"Results\"\n", - "FIGURE_ID = \"Results/FigureFiles\"\n", - "DATA_ID = \"DataFiles/\"\n", - "\n", - "if not os.path.exists(PROJECT_ROOT_DIR):\n", - " os.mkdir(PROJECT_ROOT_DIR)\n", - "\n", - "if not os.path.exists(FIGURE_ID):\n", - " os.makedirs(FIGURE_ID)\n", - "\n", - "if not os.path.exists(DATA_ID):\n", - " os.makedirs(DATA_ID)\n", - "\n", - "def image_path(fig_id):\n", - " return os.path.join(FIGURE_ID, fig_id)\n", - "\n", - "def data_path(dat_id):\n", - " return os.path.join(DATA_ID, dat_id)\n", - "\n", - "def save_fig(fig_id):\n", - " plt.savefig(image_path(fig_id) + \".png\", format='png')\n", - "\n", - "infile = open(data_path(\"rideclass.csv\"),'r')\n", - "\n", - "# Read the experimental data with Pandas\n", - "from IPython.display import display\n", - "ridedata = pd.read_csv(infile,names = ('Outlook','Temperature','Humidity','Wind','Ride'))\n", - "ridedata = pd.DataFrame(ridedata)\n", - "\n", - "# Features and targets\n", - "X = ridedata.loc[:, ridedata.columns != 'Ride'].values\n", - "y = ridedata.loc[:, ridedata.columns == 'Ride'].values\n", - "\n", - "# Create the encoder.\n", - "encoder = OneHotEncoder(handle_unknown=\"ignore\")\n", - "# Assume for simplicity all features are categorical.\n", - "encoder.fit(X) \n", - "# Apply the encoder.\n", - "X = encoder.transform(X)\n", - "print(X)\n", - "# Then do a Classification tree\n", - "tree_clf = DecisionTreeClassifier(max_depth=2)\n", - "tree_clf.fit(X, y)\n", - "print(\"Train set accuracy with Decision Tree: {:.2f}\".format(tree_clf.score(X,y)))\n", - "#transfer to a decision tree graph\n", - "export_graphviz(\n", - " tree_clf,\n", - " out_file=\"DataFiles/ride.dot\",\n", - " rounded=True,\n", - " filled=True\n", - ")\n", - "cmd = 'dot -Tpng DataFiles/cancer.dot -o DataFiles/cancer.png'\n", - "os.system(cmd)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The above functions (gini, entropy and misclassification error) are\n", - "important components of the so-called CART algorithm. We will discuss\n", - "this algorithm below after we have discussed the information gain\n", - "algorithm ID3.\n", - "\n", - "In the example here we have converted all our attributes into numerical values $0,1,2$ etc." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "# Split a dataset based on an attribute and an attribute value\n", - "def test_split(index, value, dataset):\n", - "\tleft, right = list(), list()\n", - "\tfor row in dataset:\n", - "\t\tif row[index] < value:\n", - "\t\t\tleft.append(row)\n", - "\t\telse:\n", - "\t\t\tright.append(row)\n", - "\treturn left, right\n", - " \n", - "# Calculate the Gini index for a split dataset\n", - "def gini_index(groups, classes):\n", - "\t# count all samples at split point\n", - "\tn_instances = float(sum([len(group) for group in groups]))\n", - "\t# sum weighted Gini index for each group\n", - "\tgini = 0.0\n", - "\tfor group in groups:\n", - "\t\tsize = float(len(group))\n", - "\t\t# avoid divide by zero\n", - "\t\tif size == 0:\n", - "\t\t\tcontinue\n", - "\t\tscore = 0.0\n", - "\t\t# score the group based on the score for each class\n", - "\t\tfor class_val in classes:\n", - "\t\t\tp = [row[-1] for row in group].count(class_val) / size\n", - "\t\t\tscore += p * p\n", - "\t\t# weight the group score by its relative size\n", - "\t\tgini += (1.0 - score) * (size / n_instances)\n", - "\treturn gini\n", - "\n", - "# Select the best split point for a dataset\n", - "def get_split(dataset):\n", - "\tclass_values = list(set(row[-1] for row in dataset))\n", - "\tb_index, b_value, b_score, b_groups = 999, 999, 999, None\n", - "\tfor index in range(len(dataset[0])-1):\n", - "\t\tfor row in dataset:\n", - "\t\t\tgroups = test_split(index, row[index], dataset)\n", - "\t\t\tgini = gini_index(groups, class_values)\n", - "\t\t\tprint('X%d < %.3f Gini=%.3f' % ((index+1), row[index], gini))\n", - "\t\t\tif gini < b_score:\n", - "\t\t\t\tb_index, b_value, b_score, b_groups = index, row[index], gini, groups\n", - "\treturn {'index':b_index, 'value':b_value, 'groups':b_groups}\n", - " \n", - "dataset = [[0,0,0,0,0],\n", - " [0,0,0,1,1],\n", - " [1,0,0,0,1],\n", - " [2,1,0,0,1],\n", - " [2,2,1,0,1],\n", - " [2,2,1,1,0],\n", - " [1,2,1,1,1],\n", - " [0,1,0,0,0],\n", - " [0,2,1,0,1],\n", - " [2,1,1,0,1],\n", - " [0,1,1,1,1],\n", - " [1,1,0,1,1],\n", - " [1,0,1,0,1],\n", - " [2,1,0,1,0]]\n", - "\n", - "split = get_split(dataset)\n", - "print('Split: [X%d < %.3f]' % ((split['index']+1), split['value']))" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Entropy and the ID3 algorithm\n", - "\n", - "The ID3 algorithm learns decision trees by constructing\n", - "them in a top down way, beginning with the question **which attribute should be tested at the root of the tree**?\n", - "\n", - "1. Each instance attribute is evaluated using a statistical test to determine how well it alone classifies the training examples.\n", - "\n", - "2. The best attribute is selected and used as the test at the root node of the tree.\n", - "\n", - "3. A descendant of the root node is then created for each possible value of this attribute.\n", - "\n", - "4. Training examples are sorted to the appropriate descendant node.\n", - "\n", - "5. The entire process is then repeated using the training examples associated with each descendant node to select the best attribute to test at that point in the tree.\n", - "\n", - "6. This forms a greedy search for an acceptable decision tree, in which the algorithm never backtracks to reconsider earlier choices. \n", - "\n", - "The ID3 algorithm selects which attribute to test at each node in the\n", - "tree.\n", - "\n", - "We would like to select the attribute that is most useful for classifying\n", - "examples.\n", - "\n", - "What is a good quantitative measure of the worth of an attribute?\n", - "\n", - "Information gain measures how well a given attribute separates the\n", - "training examples according to their target classification.\n", - "\n", - "The ID3 algorithm uses this information gain measure to select among the candidate\n", - "attributes at each step while growing the tree.\n", - "\n", - "\n", - "### Cancer Data again now with Decision Trees and other Methods" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import matplotlib.pyplot as plt\n", - "import numpy as np\n", - "from sklearn.model_selection import train_test_split \n", - "from sklearn.datasets import load_breast_cancer\n", - "from sklearn.svm import SVC\n", - "from sklearn.linear_model import LogisticRegression\n", - "from sklearn.tree import DecisionTreeClassifier\n", - "\n", - "# Load the data\n", - "cancer = load_breast_cancer()\n", - "\n", - "X_train, X_test, y_train, y_test = train_test_split(cancer.data,cancer.target,random_state=0)\n", - "print(X_train.shape)\n", - "print(X_test.shape)\n", - "# Logistic Regression\n", - "logreg = LogisticRegression(solver='lbfgs')\n", - "logreg.fit(X_train, y_train)\n", - "print(\"Test set accuracy with Logistic Regression: {:.2f}\".format(logreg.score(X_test,y_test)))\n", - "# Support vector machine\n", - "svm = SVC(gamma='auto', C=100)\n", - "svm.fit(X_train, y_train)\n", - "print(\"Test set accuracy with SVM: {:.2f}\".format(svm.score(X_test,y_test)))\n", - "# Decision Trees\n", - "deep_tree_clf = DecisionTreeClassifier(max_depth=None)\n", - "deep_tree_clf.fit(X_train, y_train)\n", - "print(\"Test set accuracy with Decision Trees: {:.2f}\".format(deep_tree_clf.score(X_test,y_test)))\n", - "#now scale the data\n", - "from sklearn.preprocessing import StandardScaler\n", - "scaler = StandardScaler()\n", - "scaler.fit(X_train)\n", - "X_train_scaled = scaler.transform(X_train)\n", - "X_test_scaled = scaler.transform(X_test)\n", - "# Logistic Regression\n", - "logreg.fit(X_train_scaled, y_train)\n", - "print(\"Test set accuracy Logistic Regression with scaled data: {:.2f}\".format(logreg.score(X_test_scaled,y_test)))\n", - "# Support Vector Machine\n", - "svm.fit(X_train_scaled, y_train)\n", - "print(\"Test set accuracy SVM with scaled data: {:.2f}\".format(logreg.score(X_test_scaled,y_test)))\n", - "# Decision Trees\n", - "deep_tree_clf.fit(X_train_scaled, y_train)\n", - "print(\"Test set accuracy with Decision Trees and scaled data: {:.2f}\".format(deep_tree_clf.score(X_test_scaled,y_test)))" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "### Another example, the moons again" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "from __future__ import division, print_function, unicode_literals\n", - "\n", - "# Common imports\n", - "import numpy as np\n", - "import os\n", - "\n", - "# to make this notebook's output stable across runs\n", - "np.random.seed(42)\n", - "\n", - "# To plot pretty figures\n", - "import matplotlib\n", - "import matplotlib.pyplot as plt\n", - "from matplotlib.colors import ListedColormap\n", - "plt.rcParams['axes.labelsize'] = 14\n", - "plt.rcParams['xtick.labelsize'] = 12\n", - "plt.rcParams['ytick.labelsize'] = 12\n", - "\n", - "\n", - "from sklearn.svm import SVC\n", - "from sklearn import datasets\n", - "from sklearn.tree import DecisionTreeClassifier\n", - "from sklearn.datasets import make_moons\n", - "from sklearn.tree import export_graphviz\n", - "\n", - "Xm, ym = make_moons(n_samples=100, noise=0.25, random_state=53)\n", - "\n", - "deep_tree_clf1 = DecisionTreeClassifier(random_state=42)\n", - "deep_tree_clf2 = DecisionTreeClassifier(min_samples_leaf=4, random_state=42)\n", - "deep_tree_clf1.fit(Xm, ym)\n", - "deep_tree_clf2.fit(Xm, ym)\n", - "\n", - "\n", - "def plot_decision_boundary(clf, X, y, axes=[0, 7.5, 0, 3], iris=True, legend=False, plot_training=True):\n", - " x1s = np.linspace(axes[0], axes[1], 100)\n", - " x2s = np.linspace(axes[2], axes[3], 100)\n", - " x1, x2 = np.meshgrid(x1s, x2s)\n", - " X_new = np.c_[x1.ravel(), x2.ravel()]\n", - " y_pred = clf.predict(X_new).reshape(x1.shape)\n", - " custom_cmap = ListedColormap(['#fafab0','#9898ff','#a0faa0'])\n", - " plt.contourf(x1, x2, y_pred, alpha=0.3, cmap=custom_cmap)\n", - " if not iris:\n", - " custom_cmap2 = ListedColormap(['#7d7d58','#4c4c7f','#507d50'])\n", - " plt.contour(x1, x2, y_pred, cmap=custom_cmap2, alpha=0.8)\n", - " if plot_training:\n", - " plt.plot(X[:, 0][y==0], X[:, 1][y==0], \"yo\", label=\"Iris-Setosa\")\n", - " plt.plot(X[:, 0][y==1], X[:, 1][y==1], \"bs\", label=\"Iris-Versicolor\")\n", - " plt.plot(X[:, 0][y==2], X[:, 1][y==2], \"g^\", label=\"Iris-Virginica\")\n", - " plt.axis(axes)\n", - " if iris:\n", - " plt.xlabel(\"Petal length\", fontsize=14)\n", - " plt.ylabel(\"Petal width\", fontsize=14)\n", - " else:\n", - " plt.xlabel(r\"$x_1$\", fontsize=18)\n", - " plt.ylabel(r\"$x_2$\", fontsize=18, rotation=0)\n", - " if legend:\n", - " plt.legend(loc=\"lower right\", fontsize=14)\n", - "plt.figure(figsize=(11, 4))\n", - "plt.subplot(121)\n", - "plot_decision_boundary(deep_tree_clf1, Xm, ym, axes=[-1.5, 2.5, -1, 1.5], iris=False)\n", - "plt.title(\"No restrictions\", fontsize=16)\n", - "plt.subplot(122)\n", - "plot_decision_boundary(deep_tree_clf2, Xm, ym, axes=[-1.5, 2.5, -1, 1.5], iris=False)\n", - "plt.title(\"min_samples_leaf = {}\".format(deep_tree_clf2.min_samples_leaf), fontsize=14)\n", - "plt.show()" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "np.random.seed(6)\n", - "Xs = np.random.rand(100, 2) - 0.5\n", - "ys = (Xs[:, 0] > 0).astype(np.float32) * 2\n", - "\n", - "angle = np.pi/4\n", - "rotation_matrix = np.array([[np.cos(angle), -np.sin(angle)], [np.sin(angle), np.cos(angle)]])\n", - "Xsr = Xs.dot(rotation_matrix)\n", - "\n", - "tree_clf_s = DecisionTreeClassifier(random_state=42)\n", - "tree_clf_s.fit(Xs, ys)\n", - "tree_clf_sr = DecisionTreeClassifier(random_state=42)\n", - "tree_clf_sr.fit(Xsr, ys)\n", - "\n", - "plt.figure(figsize=(11, 4))\n", - "plt.subplot(121)\n", - "plot_decision_boundary(tree_clf_s, Xs, ys, axes=[-0.7, 0.7, -0.7, 0.7], iris=False)\n", - "plt.subplot(122)\n", - "plot_decision_boundary(tree_clf_sr, Xsr, ys, axes=[-0.7, 0.7, -0.7, 0.7], iris=False)\n", - "\n", - "plt.show()" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "# Quadratic training set + noise\n", - "np.random.seed(42)\n", - "m = 200\n", - "X = np.random.rand(m, 1)\n", - "y = 4 * (X - 0.5) ** 2\n", - "y = y + np.random.randn(m, 1) / 10" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "from sklearn.tree import DecisionTreeRegressor\n", - "\n", - "tree_reg = DecisionTreeRegressor(max_depth=2, random_state=42)\n", - "tree_reg.fit(X, y)" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "from sklearn.tree import DecisionTreeRegressor\n", - "\n", - "tree_reg1 = DecisionTreeRegressor(random_state=42, max_depth=2)\n", - "tree_reg2 = DecisionTreeRegressor(random_state=42, max_depth=3)\n", - "tree_reg1.fit(X, y)\n", - "tree_reg2.fit(X, y)\n", - "\n", - "def plot_regression_predictions(tree_reg, X, y, axes=[0, 1, -0.2, 1], ylabel=\"$y$\"):\n", - " x1 = np.linspace(axes[0], axes[1], 500).reshape(-1, 1)\n", - " y_pred = tree_reg.predict(x1)\n", - " plt.axis(axes)\n", - " plt.xlabel(\"$x_1$\", fontsize=18)\n", - " if ylabel:\n", - " plt.ylabel(ylabel, fontsize=18, rotation=0)\n", - " plt.plot(X, y, \"b.\")\n", - " plt.plot(x1, y_pred, \"r.-\", linewidth=2, label=r\"$\\hat{y}$\")\n", - "\n", - "plt.figure(figsize=(11, 4))\n", - "plt.subplot(121)\n", - "plot_regression_predictions(tree_reg1, X, y)\n", - "for split, style in ((0.1973, \"k-\"), (0.0917, \"k--\"), (0.7718, \"k--\")):\n", - " plt.plot([split, split], [-0.2, 1], style, linewidth=2)\n", - "plt.text(0.21, 0.65, \"Depth=0\", fontsize=15)\n", - "plt.text(0.01, 0.2, \"Depth=1\", fontsize=13)\n", - "plt.text(0.65, 0.8, \"Depth=1\", fontsize=13)\n", - "plt.legend(loc=\"upper center\", fontsize=18)\n", - "plt.title(\"max_depth=2\", fontsize=14)\n", - "\n", - "plt.subplot(122)\n", - "plot_regression_predictions(tree_reg2, X, y, ylabel=None)\n", - "for split, style in ((0.1973, \"k-\"), (0.0917, \"k--\"), (0.7718, \"k--\")):\n", - " plt.plot([split, split], [-0.2, 1], style, linewidth=2)\n", - "for split in (0.0458, 0.1298, 0.2873, 0.9040):\n", - " plt.plot([split, split], [-0.2, 1], \"k:\", linewidth=1)\n", - "plt.text(0.3, 0.5, \"Depth=2\", fontsize=13)\n", - "plt.title(\"max_depth=3\", fontsize=14)\n", - "\n", - "plt.show()" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "tree_reg1 = DecisionTreeRegressor(random_state=42)\n", - "tree_reg2 = DecisionTreeRegressor(random_state=42, min_samples_leaf=10)\n", - "tree_reg1.fit(X, y)\n", - "tree_reg2.fit(X, y)\n", - "\n", - "x1 = np.linspace(0, 1, 500).reshape(-1, 1)\n", - "y_pred1 = tree_reg1.predict(x1)\n", - "y_pred2 = tree_reg2.predict(x1)\n", - "\n", - "plt.figure(figsize=(11, 4))\n", - "\n", - "plt.subplot(121)\n", - "plt.plot(X, y, \"b.\")\n", - "plt.plot(x1, y_pred1, \"r.-\", linewidth=2, label=r\"$\\hat{y}$\")\n", - "plt.axis([0, 1, -0.2, 1.1])\n", - "plt.xlabel(\"$x_1$\", fontsize=18)\n", - "plt.ylabel(\"$y$\", fontsize=18, rotation=0)\n", - "plt.legend(loc=\"upper center\", fontsize=18)\n", - "plt.title(\"No restrictions\", fontsize=14)\n", - "\n", - "plt.subplot(122)\n", - "plt.plot(X, y, \"b.\")\n", - "plt.plot(x1, y_pred2, \"r.-\", linewidth=2, label=r\"$\\hat{y}$\")\n", - "plt.axis([0, 1, -0.2, 1.1])\n", - "plt.xlabel(\"$x_1$\", fontsize=18)\n", - "plt.title(\"min_samples_leaf={}\".format(tree_reg2.min_samples_leaf), fontsize=14)\n", - "\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Pros and cons of trees, pros\n", - "\n", - "* White box, easy to interpret model. Some people believe that decision trees more closely mirror human decision-making than do the regression and classification approaches discussed earlier (think of support vector machines)\n", - "\n", - "* Trees are very easy to explain to people. In fact, they are even easier to explain than linear regression!\n", - "\n", - "* No feature normalization needed\n", - "\n", - "* Tree models can handle both continuous and categorical data (Classification and Regression Trees)\n", - "\n", - "* Can model nonlinear relationships\n", - "\n", - "* Can model interactions between the different descriptive features\n", - "\n", - "* Trees can be displayed graphically, and are easily interpreted even by a non-expert (especially if they are small)\n", - "\n", - "### Disadvantages\n", - "\n", - "* Unfortunately, trees generally do not have the same level of predictive accuracy as some of the other regression and classification approaches\n", - "\n", - "* If continuous features are used the tree may become quite large and hence less interpretable\n", - "\n", - "* Decision trees are prone to overfit the training data and hence do not well generalize the data if no stopping criteria or improvements like pruning, boosting or bagging are implemented\n", - "\n", - "* Small changes in the data may lead to a completely different tree. This issue can be addressed by using ensemble methods like bagging, boosting or random forests\n", - "\n", - "* Unbalanced datasets where some target feature values occur much more frequently than others may lead to biased trees since the frequently occurring feature values are preferred over the less frequently occurring ones. \n", - "\n", - "* If the number of features is relatively large (high dimensional) and the number of instances is relatively low, the tree might overfit the data\n", - "\n", - "* Features with many levels may be preferred over features with less levels since for them it is *more easy* to split the dataset such that the sub datasets only contain pure target feature values. This issue can be addressed by preferring for instance the information gain ratio as splitting criteria over information gain\n", - "\n", - "However, by aggregating many decision trees, using methods like\n", - "bagging, random forests, and boosting, the predictive performance of\n", - "trees can be substantially improved." - ] - } - ], - "metadata": { - "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.8.5" - } - }, - "nbformat": 4, - "nbformat_minor": 4 -} \ No newline at end of file diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter6.py b/doc/LectureNotes/_build/jupyter_execute/chapter6.py deleted file mode 100644 index 3cb2e71e3..000000000 --- a/doc/LectureNotes/_build/jupyter_execute/chapter6.py +++ /dev/null @@ -1,978 +0,0 @@ -# Decision trees, overarching aims - - -We start here with the most basic algorithm, the so-called decision -tree. With this basic algorithm we can in turn build more complex -networks, spanning from homogeneous and heterogenous forests (bagging, -random forests and more) to one of the most popular supervised -algorithms nowadays, the extreme gradient boosting, or just -XGBoost. But let us start with the simplest possible ingredient. - -Decision trees are supervised learning algorithms used for both, -classification and regression tasks. - - -The main idea of decision trees -is to find those descriptive features which contain the most -**information** regarding the target feature and then split the dataset -along the values of these features such that the target feature values -for the resulting underlying datasets are as pure as possible. - -The descriptive features which reproduce best the target/output features are normally said -to be the most informative ones. The process of finding the **most -informative** feature is done until we accomplish a stopping criteria -where we then finally end up in so called **leaf nodes**. - -## Basics of a tree - -A decision tree is typically divided into a **root node**, the **interior nodes**, -and the final **leaf nodes** or just **leaves**. These entities are then connected by so-called **branches**. - -The leaf nodes -contain the predictions we will make for new query instances presented -to our trained model. This is possible since the model has -learned the underlying structure of the training data and hence can, -given some assumptions, make predictions about the target feature value -(class) of unseen query instances. - - -## General Features - -The overarching approach to decision trees is a top-down approach. - -* A leaf provides the classification of a given instance. - -* A node specifies a test of some attribute of the instance. - -* A branch corresponds to a possible values of an attribute. - -* An instance is classified by starting at the root node of the tree, testing the attribute specified by this node, then moving down the tree branch corresponding to the value of the attribute in the given example. - -This process is then repeated for the subtree rooted at the new -node. - - - -In simplified terms, the process of training a decision tree and -predicting the target features of query instances is as follows: - -1. Present a dataset containing of a number of training instances characterized by a number of descriptive features and a target feature - -2. Train the decision tree model by continuously splitting the target feature along the values of the descriptive features using a measure of information gain during the training process - -3. Grow the tree until we accomplish a stopping criteria create leaf nodes which represent the *predictions* we want to make for new query instances - -4. Show query instances to the tree and run down the tree until we arrive at leaf nodes - -Then we are essentially done! - -%matplotlib inline - -import numpy as np -import matplotlib.pyplot as plt -from sklearn.preprocessing import PolynomialFeatures -from sklearn.linear_model import LinearRegression - -steps=250 - -distance=0 -x=0 -distance_list=[] -steps_list=[] -while x - -Day Outlook Temperature Humidity Wind Ride - - - 1 Sunny Hot High Weak 0 - 2 Sunny Hot High Strong 1 - 3 Overcast Hot High Weak 1 - 4 Rain Mild High Weak 1 - 5 Rain Cool Normal Weak 1 - 6 Rain Cool Normal Strong 0 - 7 Overcast Cool Normal Strong 1 - 8 Sunny Mild High Weak 0 - 9 Sunny Cool Normal Weak 1 - 10 Rain Mild Normal Weak 1 - 11 Sunny Mild Normal Strong 1 - 12 Overcast Mild High Strong 1 - 13 Overcast Hot Normal Weak 1 - 14 Rain Mild High Strong 0 - - - -### Simple Python Code to read in Data and perform Classification - -# Common imports -import numpy as np -import pandas as pd -import matplotlib.pyplot as plt -from sklearn.tree import DecisionTreeClassifier -from sklearn.model_selection import train_test_split -from sklearn.tree import export_graphviz -from sklearn.preprocessing import StandardScaler, OneHotEncoder -from sklearn.compose import ColumnTransformer -from IPython.display import Image -from pydot import graph_from_dot_data -import os - -# Where to save the figures and data files -PROJECT_ROOT_DIR = "Results" -FIGURE_ID = "Results/FigureFiles" -DATA_ID = "DataFiles/" - -if not os.path.exists(PROJECT_ROOT_DIR): - os.mkdir(PROJECT_ROOT_DIR) - -if not os.path.exists(FIGURE_ID): - os.makedirs(FIGURE_ID) - -if not os.path.exists(DATA_ID): - os.makedirs(DATA_ID) - -def image_path(fig_id): - return os.path.join(FIGURE_ID, fig_id) - -def data_path(dat_id): - return os.path.join(DATA_ID, dat_id) - -def save_fig(fig_id): - plt.savefig(image_path(fig_id) + ".png", format='png') - -infile = open(data_path("rideclass.csv"),'r') - -# Read the experimental data with Pandas -from IPython.display import display -ridedata = pd.read_csv(infile,names = ('Outlook','Temperature','Humidity','Wind','Ride')) -ridedata = pd.DataFrame(ridedata) - -# Features and targets -X = ridedata.loc[:, ridedata.columns != 'Ride'].values -y = ridedata.loc[:, ridedata.columns == 'Ride'].values - -# Create the encoder. -encoder = OneHotEncoder(handle_unknown="ignore") -# Assume for simplicity all features are categorical. -encoder.fit(X) -# Apply the encoder. -X = encoder.transform(X) -print(X) -# Then do a Classification tree -tree_clf = DecisionTreeClassifier(max_depth=2) -tree_clf.fit(X, y) -print("Train set accuracy with Decision Tree: {:.2f}".format(tree_clf.score(X,y))) -#transfer to a decision tree graph -export_graphviz( - tree_clf, - out_file="DataFiles/ride.dot", - rounded=True, - filled=True -) -cmd = 'dot -Tpng DataFiles/cancer.dot -o DataFiles/cancer.png' -os.system(cmd) - -The above functions (gini, entropy and misclassification error) are -important components of the so-called CART algorithm. We will discuss -this algorithm below after we have discussed the information gain -algorithm ID3. - -In the example here we have converted all our attributes into numerical values $0,1,2$ etc. - -# Split a dataset based on an attribute and an attribute value -def test_split(index, value, dataset): - left, right = list(), list() - for row in dataset: - if row[index] < value: - left.append(row) - else: - right.append(row) - return left, right - -# Calculate the Gini index for a split dataset -def gini_index(groups, classes): - # count all samples at split point - n_instances = float(sum([len(group) for group in groups])) - # sum weighted Gini index for each group - gini = 0.0 - for group in groups: - size = float(len(group)) - # avoid divide by zero - if size == 0: - continue - score = 0.0 - # score the group based on the score for each class - for class_val in classes: - p = [row[-1] for row in group].count(class_val) / size - score += p * p - # weight the group score by its relative size - gini += (1.0 - score) * (size / n_instances) - return gini - -# Select the best split point for a dataset -def get_split(dataset): - class_values = list(set(row[-1] for row in dataset)) - b_index, b_value, b_score, b_groups = 999, 999, 999, None - for index in range(len(dataset[0])-1): - for row in dataset: - groups = test_split(index, row[index], dataset) - gini = gini_index(groups, class_values) - print('X%d < %.3f Gini=%.3f' % ((index+1), row[index], gini)) - if gini < b_score: - b_index, b_value, b_score, b_groups = index, row[index], gini, groups - return {'index':b_index, 'value':b_value, 'groups':b_groups} - -dataset = [[0,0,0,0,0], - [0,0,0,1,1], - [1,0,0,0,1], - [2,1,0,0,1], - [2,2,1,0,1], - [2,2,1,1,0], - [1,2,1,1,1], - [0,1,0,0,0], - [0,2,1,0,1], - [2,1,1,0,1], - [0,1,1,1,1], - [1,1,0,1,1], - [1,0,1,0,1], - [2,1,0,1,0]] - -split = get_split(dataset) -print('Split: [X%d < %.3f]' % ((split['index']+1), split['value'])) - -## Entropy and the ID3 algorithm - -The ID3 algorithm learns decision trees by constructing -them in a top down way, beginning with the question **which attribute should be tested at the root of the tree**? - -1. Each instance attribute is evaluated using a statistical test to determine how well it alone classifies the training examples. - -2. The best attribute is selected and used as the test at the root node of the tree. - -3. A descendant of the root node is then created for each possible value of this attribute. - -4. Training examples are sorted to the appropriate descendant node. - -5. The entire process is then repeated using the training examples associated with each descendant node to select the best attribute to test at that point in the tree. - -6. This forms a greedy search for an acceptable decision tree, in which the algorithm never backtracks to reconsider earlier choices. - -The ID3 algorithm selects which attribute to test at each node in the -tree. - -We would like to select the attribute that is most useful for classifying -examples. - -What is a good quantitative measure of the worth of an attribute? - -Information gain measures how well a given attribute separates the -training examples according to their target classification. - -The ID3 algorithm uses this information gain measure to select among the candidate -attributes at each step while growing the tree. - - -### Cancer Data again now with Decision Trees and other Methods - -import matplotlib.pyplot as plt -import numpy as np -from sklearn.model_selection import train_test_split -from sklearn.datasets import load_breast_cancer -from sklearn.svm import SVC -from sklearn.linear_model import LogisticRegression -from sklearn.tree import DecisionTreeClassifier - -# Load the data -cancer = load_breast_cancer() - -X_train, X_test, y_train, y_test = train_test_split(cancer.data,cancer.target,random_state=0) -print(X_train.shape) -print(X_test.shape) -# Logistic Regression -logreg = LogisticRegression(solver='lbfgs') -logreg.fit(X_train, y_train) -print("Test set accuracy with Logistic Regression: {:.2f}".format(logreg.score(X_test,y_test))) -# Support vector machine -svm = SVC(gamma='auto', C=100) -svm.fit(X_train, y_train) -print("Test set accuracy with SVM: {:.2f}".format(svm.score(X_test,y_test))) -# Decision Trees -deep_tree_clf = DecisionTreeClassifier(max_depth=None) -deep_tree_clf.fit(X_train, y_train) -print("Test set accuracy with Decision Trees: {:.2f}".format(deep_tree_clf.score(X_test,y_test))) -#now scale the data -from sklearn.preprocessing import StandardScaler -scaler = StandardScaler() -scaler.fit(X_train) -X_train_scaled = scaler.transform(X_train) -X_test_scaled = scaler.transform(X_test) -# Logistic Regression -logreg.fit(X_train_scaled, y_train) -print("Test set accuracy Logistic Regression with scaled data: {:.2f}".format(logreg.score(X_test_scaled,y_test))) -# Support Vector Machine -svm.fit(X_train_scaled, y_train) -print("Test set accuracy SVM with scaled data: {:.2f}".format(logreg.score(X_test_scaled,y_test))) -# Decision Trees -deep_tree_clf.fit(X_train_scaled, y_train) -print("Test set accuracy with Decision Trees and scaled data: {:.2f}".format(deep_tree_clf.score(X_test_scaled,y_test))) - -### Another example, the moons again - -from __future__ import division, print_function, unicode_literals - -# Common imports -import numpy as np -import os - -# to make this notebook's output stable across runs -np.random.seed(42) - -# To plot pretty figures -import matplotlib -import matplotlib.pyplot as plt -from matplotlib.colors import ListedColormap -plt.rcParams['axes.labelsize'] = 14 -plt.rcParams['xtick.labelsize'] = 12 -plt.rcParams['ytick.labelsize'] = 12 - - -from sklearn.svm import SVC -from sklearn import datasets -from sklearn.tree import DecisionTreeClassifier -from sklearn.datasets import make_moons -from sklearn.tree import export_graphviz - -Xm, ym = make_moons(n_samples=100, noise=0.25, random_state=53) - -deep_tree_clf1 = DecisionTreeClassifier(random_state=42) -deep_tree_clf2 = DecisionTreeClassifier(min_samples_leaf=4, random_state=42) -deep_tree_clf1.fit(Xm, ym) -deep_tree_clf2.fit(Xm, ym) - - -def plot_decision_boundary(clf, X, y, axes=[0, 7.5, 0, 3], iris=True, legend=False, plot_training=True): - x1s = np.linspace(axes[0], axes[1], 100) - x2s = np.linspace(axes[2], axes[3], 100) - x1, x2 = np.meshgrid(x1s, x2s) - X_new = np.c_[x1.ravel(), x2.ravel()] - y_pred = clf.predict(X_new).reshape(x1.shape) - custom_cmap = ListedColormap(['#fafab0','#9898ff','#a0faa0']) - plt.contourf(x1, x2, y_pred, alpha=0.3, cmap=custom_cmap) - if not iris: - custom_cmap2 = ListedColormap(['#7d7d58','#4c4c7f','#507d50']) - plt.contour(x1, x2, y_pred, cmap=custom_cmap2, alpha=0.8) - if plot_training: - plt.plot(X[:, 0][y==0], X[:, 1][y==0], "yo", label="Iris-Setosa") - plt.plot(X[:, 0][y==1], X[:, 1][y==1], "bs", label="Iris-Versicolor") - plt.plot(X[:, 0][y==2], X[:, 1][y==2], "g^", label="Iris-Virginica") - plt.axis(axes) - if iris: - plt.xlabel("Petal length", fontsize=14) - plt.ylabel("Petal width", fontsize=14) - else: - plt.xlabel(r"$x_1$", fontsize=18) - plt.ylabel(r"$x_2$", fontsize=18, rotation=0) - if legend: - plt.legend(loc="lower right", fontsize=14) -plt.figure(figsize=(11, 4)) -plt.subplot(121) -plot_decision_boundary(deep_tree_clf1, Xm, ym, axes=[-1.5, 2.5, -1, 1.5], iris=False) -plt.title("No restrictions", fontsize=16) -plt.subplot(122) -plot_decision_boundary(deep_tree_clf2, Xm, ym, axes=[-1.5, 2.5, -1, 1.5], iris=False) -plt.title("min_samples_leaf = {}".format(deep_tree_clf2.min_samples_leaf), fontsize=14) -plt.show() - -np.random.seed(6) -Xs = np.random.rand(100, 2) - 0.5 -ys = (Xs[:, 0] > 0).astype(np.float32) * 2 - -angle = np.pi/4 -rotation_matrix = np.array([[np.cos(angle), -np.sin(angle)], [np.sin(angle), np.cos(angle)]]) -Xsr = Xs.dot(rotation_matrix) - -tree_clf_s = DecisionTreeClassifier(random_state=42) -tree_clf_s.fit(Xs, ys) -tree_clf_sr = DecisionTreeClassifier(random_state=42) -tree_clf_sr.fit(Xsr, ys) - -plt.figure(figsize=(11, 4)) -plt.subplot(121) -plot_decision_boundary(tree_clf_s, Xs, ys, axes=[-0.7, 0.7, -0.7, 0.7], iris=False) -plt.subplot(122) -plot_decision_boundary(tree_clf_sr, Xsr, ys, axes=[-0.7, 0.7, -0.7, 0.7], iris=False) - -plt.show() - -# Quadratic training set + noise -np.random.seed(42) -m = 200 -X = np.random.rand(m, 1) -y = 4 * (X - 0.5) ** 2 -y = y + np.random.randn(m, 1) / 10 - -from sklearn.tree import DecisionTreeRegressor - -tree_reg = DecisionTreeRegressor(max_depth=2, random_state=42) -tree_reg.fit(X, y) - -from sklearn.tree import DecisionTreeRegressor - -tree_reg1 = DecisionTreeRegressor(random_state=42, max_depth=2) -tree_reg2 = DecisionTreeRegressor(random_state=42, max_depth=3) -tree_reg1.fit(X, y) -tree_reg2.fit(X, y) - -def plot_regression_predictions(tree_reg, X, y, axes=[0, 1, -0.2, 1], ylabel="$y$"): - x1 = np.linspace(axes[0], axes[1], 500).reshape(-1, 1) - y_pred = tree_reg.predict(x1) - plt.axis(axes) - plt.xlabel("$x_1$", fontsize=18) - if ylabel: - plt.ylabel(ylabel, fontsize=18, rotation=0) - plt.plot(X, y, "b.") - plt.plot(x1, y_pred, "r.-", linewidth=2, label=r"$\hat{y}$") - -plt.figure(figsize=(11, 4)) -plt.subplot(121) -plot_regression_predictions(tree_reg1, X, y) -for split, style in ((0.1973, "k-"), (0.0917, "k--"), (0.7718, "k--")): - plt.plot([split, split], [-0.2, 1], style, linewidth=2) -plt.text(0.21, 0.65, "Depth=0", fontsize=15) -plt.text(0.01, 0.2, "Depth=1", fontsize=13) -plt.text(0.65, 0.8, "Depth=1", fontsize=13) -plt.legend(loc="upper center", fontsize=18) -plt.title("max_depth=2", fontsize=14) - -plt.subplot(122) -plot_regression_predictions(tree_reg2, X, y, ylabel=None) -for split, style in ((0.1973, "k-"), (0.0917, "k--"), (0.7718, "k--")): - plt.plot([split, split], [-0.2, 1], style, linewidth=2) -for split in (0.0458, 0.1298, 0.2873, 0.9040): - plt.plot([split, split], [-0.2, 1], "k:", linewidth=1) -plt.text(0.3, 0.5, "Depth=2", fontsize=13) -plt.title("max_depth=3", fontsize=14) - -plt.show() - -tree_reg1 = DecisionTreeRegressor(random_state=42) -tree_reg2 = DecisionTreeRegressor(random_state=42, min_samples_leaf=10) -tree_reg1.fit(X, y) -tree_reg2.fit(X, y) - -x1 = np.linspace(0, 1, 500).reshape(-1, 1) -y_pred1 = tree_reg1.predict(x1) -y_pred2 = tree_reg2.predict(x1) - -plt.figure(figsize=(11, 4)) - -plt.subplot(121) -plt.plot(X, y, "b.") -plt.plot(x1, y_pred1, "r.-", linewidth=2, label=r"$\hat{y}$") -plt.axis([0, 1, -0.2, 1.1]) -plt.xlabel("$x_1$", fontsize=18) -plt.ylabel("$y$", fontsize=18, rotation=0) -plt.legend(loc="upper center", fontsize=18) -plt.title("No restrictions", fontsize=14) - -plt.subplot(122) -plt.plot(X, y, "b.") -plt.plot(x1, y_pred2, "r.-", linewidth=2, label=r"$\hat{y}$") -plt.axis([0, 1, -0.2, 1.1]) -plt.xlabel("$x_1$", fontsize=18) -plt.title("min_samples_leaf={}".format(tree_reg2.min_samples_leaf), fontsize=14) - -plt.show() - -## Pros and cons of trees, pros - -* White box, easy to interpret model. Some people believe that decision trees more closely mirror human decision-making than do the regression and classification approaches discussed earlier (think of support vector machines) - -* Trees are very easy to explain to people. In fact, they are even easier to explain than linear regression! - -* No feature normalization needed - -* Tree models can handle both continuous and categorical data (Classification and Regression Trees) - -* Can model nonlinear relationships - -* Can model interactions between the different descriptive features - -* Trees can be displayed graphically, and are easily interpreted even by a non-expert (especially if they are small) - -### Disadvantages - -* Unfortunately, trees generally do not have the same level of predictive accuracy as some of the other regression and classification approaches - -* If continuous features are used the tree may become quite large and hence less interpretable - -* Decision trees are prone to overfit the training data and hence do not well generalize the data if no stopping criteria or improvements like pruning, boosting or bagging are implemented - -* Small changes in the data may lead to a completely different tree. This issue can be addressed by using ensemble methods like bagging, boosting or random forests - -* Unbalanced datasets where some target feature values occur much more frequently than others may lead to biased trees since the frequently occurring feature values are preferred over the less frequently occurring ones. - -* If the number of features is relatively large (high dimensional) and the number of instances is relatively low, the tree might overfit the data - -* Features with many levels may be preferred over features with less levels since for them it is *more easy* to split the dataset such that the sub datasets only contain pure target feature values. This issue can be addressed by preferring for instance the information gain ratio as splitting criteria over information gain - -However, by aggregating many decision trees, using methods like -bagging, random forests, and boosting, the predictive performance of -trees can be substantially improved. \ No newline at end of file diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter6_1_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter6_1_1.png deleted file mode 100644 index 968e34cb6..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter6_1_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter6_1_2.png b/doc/LectureNotes/_build/jupyter_execute/chapter6_1_2.png deleted file mode 100644 index 3fff4c0a7..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter6_1_2.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter7.ipynb b/doc/LectureNotes/_build/jupyter_execute/chapter7.ipynb deleted file mode 100644 index cc88d8ca2..000000000 --- a/doc/LectureNotes/_build/jupyter_execute/chapter7.ipynb +++ /dev/null @@ -1,1605 +0,0 @@ -{ - "cells": [ - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "# Ensemble Methods: From a Single Tree to Many Trees and Extreme Boosting, Meet the Jungle of Methods\n", - "\n", - "As stated previously and seen in many of the examples discussed in the previous chapter about\n", - "a single decision tree, we often end up overfitting our training\n", - "data. This normally means that we have a high variance. Can we reduce\n", - "the variance of a statistical learning method?\n", - "\n", - "This leads us to a set of different methods that can combine different\n", - "machine learning algorithms or just use one of them to construct\n", - "forests and jungles of trees, homogeneous ones or heterogenous\n", - "ones. These methods are recognized by different names which we will\n", - "try to explain here. These are\n", - "\n", - "1. Voting classifiers\n", - "\n", - "2. Bagging and Pasting\n", - "\n", - "3. Random forests\n", - "\n", - "4. Boosting methods, from adaptive to Extreme Gradient Boosting (XGBoost)\n", - "\n", - "We discuss these methods here.\n", - "\n", - "### An Overview of Ensemble Methods\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "## Bagging\n", - "\n", - "The **plain** decision trees suffer from high\n", - "variance. This means that if we split the training data into two parts\n", - "at random, and fit a decision tree to both halves, the results that we\n", - "get could be quite different. In contrast, a procedure with low\n", - "variance will yield similar results if applied repeatedly to distinct\n", - "data sets; linear regression tends to have low variance, if the ratio\n", - "of $n$ to $p$ is moderately large. \n", - "\n", - "**Bootstrap aggregation**, or just **bagging**, is a\n", - "general-purpose procedure for reducing the variance of a statistical\n", - "learning method. \n", - "\n", - "\n", - "Bagging typically results in improved accuracy\n", - "over prediction using a single tree. Unfortunately, however, it can be\n", - "difficult to interpret the resulting model. Recall that one of the\n", - "advantages of decision trees is the attractive and easily interpreted\n", - "diagram that results.\n", - "\n", - "However, when we bag a large number of trees, it is no longer\n", - "possible to represent the resulting statistical learning procedure\n", - "using a single tree, and it is no longer clear which variables are\n", - "most important to the procedure. Thus, bagging improves prediction\n", - "accuracy at the expense of interpretability. Although the collection\n", - "of bagged trees is much more difficult to interpret than a single\n", - "tree, one can obtain an overall summary of the importance of each\n", - "predictor using the MSE (for bagging regression trees) or the Gini\n", - "index (for bagging classification trees). In the case of bagging\n", - "regression trees, we can record the total amount that the MSE is\n", - "decreased due to splits over a given predictor, averaged over all $B$ possible\n", - "trees. A large value indicates an important predictor. Similarly, in\n", - "the context of bagging classification trees, we can add up the total\n", - "amount that the Gini index is decreased by splits over a given\n", - "predictor, averaged over all $B$ trees." - ] - }, - { - "cell_type": "code", - "execution_count": 1, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "ename": "NameError", - "evalue": "name 'np' is not defined", - "output_type": "error", - "traceback": [ - "\u001b[0;31m---------------------------------------------------------------------------\u001b[0m", - "\u001b[0;31mNameError\u001b[0m Traceback (most recent call last)", - "\u001b[0;32m\u001b[0m in \u001b[0;36m\u001b[0;34m\u001b[0m\n\u001b[1;32m 1\u001b[0m \u001b[0mheads_proba\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0;36m0.51\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0;32m----> 2\u001b[0;31m \u001b[0mcoin_tosses\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0;34m(\u001b[0m\u001b[0mnp\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mrandom\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mrand\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0;36m10000\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0;36m10\u001b[0m\u001b[0;34m)\u001b[0m \u001b[0;34m<\u001b[0m \u001b[0mheads_proba\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mastype\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mnp\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mint32\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 3\u001b[0m \u001b[0mcumulative_heads_ratio\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mnp\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mcumsum\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mcoin_tosses\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0maxis\u001b[0m\u001b[0;34m=\u001b[0m\u001b[0;36m0\u001b[0m\u001b[0;34m)\u001b[0m \u001b[0;34m/\u001b[0m \u001b[0mnp\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0marange\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0;36m1\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0;36m10001\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mreshape\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0;34m-\u001b[0m\u001b[0;36m1\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 4\u001b[0m \u001b[0mplt\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mfigure\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mfigsize\u001b[0m\u001b[0;34m=\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0;36m8\u001b[0m\u001b[0;34m,\u001b[0m\u001b[0;36m3.5\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 5\u001b[0m \u001b[0mplt\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mplot\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mcumulative_heads_ratio\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n", - "\u001b[0;31mNameError\u001b[0m: name 'np' is not defined" - ] - } - ], - "source": [ - "heads_proba = 0.51\n", - "coin_tosses = (np.random.rand(10000, 10) < heads_proba).astype(np.int32)\n", - "cumulative_heads_ratio = np.cumsum(coin_tosses, axis=0) / np.arange(1, 10001).reshape(-1, 1)\n", - "plt.figure(figsize=(8,3.5))\n", - "plt.plot(cumulative_heads_ratio)\n", - "plt.plot([0, 10000], [0.51, 0.51], \"k--\", linewidth=2, label=\"51%\")\n", - "plt.plot([0, 10000], [0.5, 0.5], \"k-\", label=\"50%\")\n", - "plt.xlabel(\"Number of coin tosses\")\n", - "plt.ylabel(\"Heads ratio\")\n", - "plt.legend(loc=\"lower right\")\n", - "plt.axis([0, 10000, 0.42, 0.58])\n", - "save_fig(\"votingsimple\")\n", - "plt.show()" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "from sklearn.model_selection import train_test_split\n", - "from sklearn.datasets import make_moons\n", - "\n", - "X, y = make_moons(n_samples=500, noise=0.30, random_state=42)\n", - "X_train, X_test, y_train, y_test = train_test_split(X, y, random_state=42)\n", - "\n", - "from sklearn.ensemble import RandomForestClassifier\n", - "from sklearn.ensemble import VotingClassifier\n", - "from sklearn.linear_model import LogisticRegression\n", - "from sklearn.svm import SVC\n", - "\n", - "log_clf = LogisticRegression(solver=\"liblinear\", random_state=42)\n", - "rnd_clf = RandomForestClassifier(n_estimators=10, random_state=42)\n", - "svm_clf = SVC(gamma=\"auto\", random_state=42)\n", - "\n", - "voting_clf = VotingClassifier(\n", - " estimators=[('lr', log_clf), ('rf', rnd_clf), ('svc', svm_clf)],\n", - " voting='hard')\n", - "\n", - "voting_clf.fit(X_train, y_train)\n", - "\n", - "from sklearn.metrics import accuracy_score\n", - "\n", - "for clf in (log_clf, rnd_clf, svm_clf, voting_clf):\n", - " clf.fit(X_train, y_train)\n", - " y_pred = clf.predict(X_test)\n", - " print(clf.__class__.__name__, accuracy_score(y_test, y_pred))\n", - "\n", - "log_clf = LogisticRegression(solver=\"liblinear\", random_state=42)\n", - "rnd_clf = RandomForestClassifier(n_estimators=10, random_state=42)\n", - "svm_clf = SVC(gamma=\"auto\", probability=True, random_state=42)\n", - "\n", - "voting_clf = VotingClassifier(\n", - " estimators=[('lr', log_clf), ('rf', rnd_clf), ('svc', svm_clf)],\n", - " voting='soft')\n", - "voting_clf.fit(X_train, y_train)\n", - "\n", - "from sklearn.metrics import accuracy_score\n", - "\n", - "for clf in (log_clf, rnd_clf, svm_clf, voting_clf):\n", - " clf.fit(X_train, y_train)\n", - " y_pred = clf.predict(X_test)\n", - " print(clf.__class__.__name__, accuracy_score(y_test, y_pred))" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "from sklearn.model_selection import train_test_split\n", - "from sklearn.datasets import make_moons\n", - "\n", - "X, y = make_moons(n_samples=500, noise=0.30, random_state=42)\n", - "X_train, X_test, y_train, y_test = train_test_split(X, y, random_state=42)\n", - "from sklearn.ensemble import RandomForestClassifier\n", - "from sklearn.ensemble import VotingClassifier\n", - "from sklearn.linear_model import LogisticRegression\n", - "from sklearn.svm import SVC\n", - "\n", - "log_clf = LogisticRegression(random_state=42)\n", - "rnd_clf = RandomForestClassifier(random_state=42)\n", - "svm_clf = SVC(random_state=42)\n", - "\n", - "voting_clf = VotingClassifier(\n", - " estimators=[('lr', log_clf), ('rf', rnd_clf), ('svc', svm_clf)],\n", - " voting='hard')\n", - "voting_clf.fit(X_train, y_train)" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "from sklearn.metrics import accuracy_score\n", - "\n", - "for clf in (log_clf, rnd_clf, svm_clf, voting_clf):\n", - " clf.fit(X_train, y_train)\n", - " y_pred = clf.predict(X_test)\n", - " print(clf.__class__.__name__, accuracy_score(y_test, y_pred))" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "log_clf = LogisticRegression(random_state=42)\n", - "rnd_clf = RandomForestClassifier(random_state=42)\n", - "svm_clf = SVC(probability=True, random_state=42)\n", - "\n", - "voting_clf = VotingClassifier(\n", - " estimators=[('lr', log_clf), ('rf', rnd_clf), ('svc', svm_clf)],\n", - " voting='soft')\n", - "voting_clf.fit(X_train, y_train)" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "from sklearn.metrics import accuracy_score\n", - "\n", - "for clf in (log_clf, rnd_clf, svm_clf, voting_clf):\n", - " clf.fit(X_train, y_train)\n", - " y_pred = clf.predict(X_test)\n", - " print(clf.__class__.__name__, accuracy_score(y_test, y_pred))" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Bagging Examples" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "from sklearn.ensemble import BaggingClassifier\n", - "from sklearn.tree import DecisionTreeClassifier\n", - "\n", - "bag_clf = BaggingClassifier(\n", - " DecisionTreeClassifier(random_state=42), n_estimators=500,\n", - " max_samples=100, bootstrap=True, n_jobs=-1, random_state=42)\n", - "bag_clf.fit(X_train, y_train)\n", - "y_pred = bag_clf.predict(X_test)" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "from sklearn.metrics import accuracy_score\n", - "print(accuracy_score(y_test, y_pred))" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "tree_clf = DecisionTreeClassifier(random_state=42)\n", - "tree_clf.fit(X_train, y_train)\n", - "y_pred_tree = tree_clf.predict(X_test)\n", - "print(accuracy_score(y_test, y_pred_tree))" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "%matplotlib inline\n", - "\n", - "from matplotlib.colors import ListedColormap\n", - "\n", - "def plot_decision_boundary(clf, X, y, axes=[-1.5, 2.5, -1, 1.5], alpha=0.5, contour=True):\n", - " x1s = np.linspace(axes[0], axes[1], 100)\n", - " x2s = np.linspace(axes[2], axes[3], 100)\n", - " x1, x2 = np.meshgrid(x1s, x2s)\n", - " X_new = np.c_[x1.ravel(), x2.ravel()]\n", - " y_pred = clf.predict(X_new).reshape(x1.shape)\n", - " custom_cmap = ListedColormap(['#fafab0','#9898ff','#a0faa0'])\n", - " plt.contourf(x1, x2, y_pred, alpha=0.3, cmap=custom_cmap)\n", - " if contour:\n", - " custom_cmap2 = ListedColormap(['#7d7d58','#4c4c7f','#507d50'])\n", - " plt.contour(x1, x2, y_pred, cmap=custom_cmap2, alpha=0.8)\n", - " plt.plot(X[:, 0][y==0], X[:, 1][y==0], \"yo\", alpha=alpha)\n", - " plt.plot(X[:, 0][y==1], X[:, 1][y==1], \"bs\", alpha=alpha)\n", - " plt.axis(axes)\n", - " plt.xlabel(r\"$x_1$\", fontsize=18)\n", - " plt.ylabel(r\"$x_2$\", fontsize=18, rotation=0)\n", - "plt.figure(figsize=(11,4))\n", - "plt.subplot(121)\n", - "plot_decision_boundary(tree_clf, X, y)\n", - "plt.title(\"Decision Tree\", fontsize=14)\n", - "plt.subplot(122)\n", - "plot_decision_boundary(bag_clf, X, y)\n", - "plt.title(\"Decision Trees with Bagging\", fontsize=14)\n", - "save_fig(\"baggingtree\")\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "### Making your own Bootstrap: Changing the Level of the Decision Tree\n", - "\n", - "Let us bring up our good old boostrap example from the linear regression lectures. We change the linerar regression algorithm with\n", - "a decision tree wth different depths and perform a bootstrap aggregate (in this case we perform as many bootstraps as data points $n$)." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "\n", - "import matplotlib.pyplot as plt\n", - "import numpy as np\n", - "from sklearn.model_selection import train_test_split\n", - "from sklearn.pipeline import make_pipeline\n", - "from sklearn.utils import resample\n", - "from sklearn.tree import DecisionTreeRegressor\n", - "\n", - "n = 100\n", - "n_boostraps = 100\n", - "maxdepth = 8\n", - "\n", - "# Make data set.\n", - "x = np.linspace(-3, 3, n).reshape(-1, 1)\n", - "y = np.exp(-x**2) + 1.5 * np.exp(-(x-2)**2)+ np.random.normal(0, 0.1, x.shape)\n", - "error = np.zeros(maxdepth)\n", - "bias = np.zeros(maxdepth)\n", - "variance = np.zeros(maxdepth)\n", - "polydegree = np.zeros(maxdepth)\n", - "X_train, X_test, y_train, y_test = train_test_split(x, y, test_size=0.2)\n", - "\n", - "from sklearn.preprocessing import StandardScaler\n", - "scaler = StandardScaler()\n", - "scaler.fit(X_train)\n", - "X_train_scaled = scaler.transform(X_train)\n", - "X_test_scaled = scaler.transform(X_test)\n", - "\n", - "# we produce a simple tree first as benchmark\n", - "simpletree = DecisionTreeRegressor(max_depth=3) \n", - "simpletree.fit(X_train_scaled, y_train)\n", - "simpleprediction = simpletree.predict(X_test_scaled)\n", - "for degree in range(1,maxdepth):\n", - " model = DecisionTreeRegressor(max_depth=degree) \n", - " y_pred = np.empty((y_test.shape[0], n_boostraps))\n", - " for i in range(n_boostraps):\n", - " x_, y_ = resample(X_train_scaled, y_train)\n", - " model.fit(x_, y_)\n", - " y_pred[:, i] = model.predict(X_test_scaled)#.ravel()\n", - "\n", - " polydegree[degree] = degree\n", - " error[degree] = np.mean( np.mean((y_test - y_pred)**2, axis=1, keepdims=True) )\n", - " bias[degree] = np.mean( (y_test - np.mean(y_pred, axis=1, keepdims=True))**2 )\n", - " variance[degree] = np.mean( np.var(y_pred, axis=1, keepdims=True) )\n", - " print('Polynomial degree:', degree)\n", - " print('Error:', error[degree])\n", - " print('Bias^2:', bias[degree])\n", - " print('Var:', variance[degree])\n", - " print('{} >= {} + {} = {}'.format(error[degree], bias[degree], variance[degree], bias[degree]+variance[degree]))\n", - " \n", - "mse_simpletree= np.mean( np.mean((y_test - simpleprediction)**2)\n", - "print(mse_simpletree)\n", - "plt.xlim(1,maxdepth)\n", - "plt.plot(polydegree, error, label='MSE')\n", - "plt.plot(polydegree, bias, label='bias')\n", - "plt.plot(polydegree, variance, label='Variance')\n", - "plt.legend()\n", - "save_fig(\"baggingboot\")\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Random forests\n", - "\n", - "Random forests provide an improvement over bagged trees by way of a\n", - "small tweak that decorrelates the trees. \n", - "\n", - "As in bagging, we build a\n", - "number of decision trees on bootstrapped training samples. But when\n", - "building these decision trees, each time a split in a tree is\n", - "considered, a random sample of $m$ predictors is chosen as split\n", - "candidates from the full set of $p$ predictors. The split is allowed to\n", - "use only one of those $m$ predictors. \n", - "\n", - "A fresh sample of $m$ predictors is\n", - "taken at each split, and typically we choose" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "m\\approx \\sqrt{p}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In building a random forest, at\n", - "each split in the tree, the algorithm is not even allowed to consider\n", - "a majority of the available predictors. \n", - "\n", - "The reason for this is rather clever. Suppose that there is one very\n", - "strong predictor in the data set, along with a number of other\n", - "moderately strong predictors. Then in the collection of bagged\n", - "variable importance random forest trees, most or all of the trees will\n", - "use this strong predictor in the top split. Consequently, all of the\n", - "bagged trees will look quite similar to each other. Hence the\n", - "predictions from the bagged trees will be highly correlated.\n", - "Unfortunately, averaging many highly correlated quantities does not\n", - "lead to as large of a reduction in variance as averaging many\n", - "uncorrelated quantities. In particular, this means that bagging will\n", - "not lead to a substantial reduction in variance over a single tree in\n", - "this setting.\n", - "\n", - "\n", - "The algorithm described here can be applied to both classification and regression problems.\n", - "\n", - "We will grow of forest of say $B$ trees.\n", - "1. For $b=1:B$\n", - "\n", - " * Draw a bootstrap sample from the training data organized in our $\\boldsymbol{X}$ matrix.\n", - "\n", - " * We grow then a random forest tree $T_b$ based on the bootstrapped data by repeating the steps outlined till we reach the maximum node size is reached\n", - "\n", - "1. we select $m \\le p$ variables at random from the $p$ predictors/features\n", - "\n", - "2. pick the best split point among the $m$ features using for example the CART algorithm and create a new node\n", - "\n", - "3. split the node into daughter nodes\n", - "\n", - "\n", - "\n", - "4. Output then the ensemble of trees $\\{T_b\\}_1^{B}$ and make predictions for either a regression type of problem or a classification type of problem." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import matplotlib.pyplot as plt\n", - "import numpy as np\n", - "from sklearn.model_selection import train_test_split \n", - "from sklearn.datasets import load_breast_cancer\n", - "from sklearn.svm import SVC\n", - "from sklearn.linear_model import LogisticRegression\n", - "from sklearn.tree import DecisionTreeClassifier\n", - "from sklearn.ensemble import BaggingClassifier\n", - "\n", - "# Load the data\n", - "cancer = load_breast_cancer()\n", - "\n", - "X_train, X_test, y_train, y_test = train_test_split(cancer.data,cancer.target,random_state=0)\n", - "print(X_train.shape)\n", - "print(X_test.shape)\n", - "# Logistic Regression\n", - "logreg = LogisticRegression(solver='lbfgs')\n", - "logreg.fit(X_train, y_train)\n", - "print(\"Test set accuracy with Logistic Regression: {:.2f}\".format(logreg.score(X_test,y_test)))\n", - "# Support vector machine\n", - "svm = SVC(gamma='auto', C=100)\n", - "svm.fit(X_train, y_train)\n", - "print(\"Test set accuracy with SVM: {:.2f}\".format(svm.score(X_test,y_test)))\n", - "# Decision Trees\n", - "deep_tree_clf = DecisionTreeClassifier(max_depth=None)\n", - "deep_tree_clf.fit(X_train, y_train)\n", - "print(\"Test set accuracy with Decision Trees: {:.2f}\".format(deep_tree_clf.score(X_test,y_test)))\n", - "#now scale the data\n", - "from sklearn.preprocessing import StandardScaler\n", - "scaler = StandardScaler()\n", - "scaler.fit(X_train)\n", - "X_train_scaled = scaler.transform(X_train)\n", - "X_test_scaled = scaler.transform(X_test)\n", - "# Logistic Regression\n", - "logreg.fit(X_train_scaled, y_train)\n", - "print(\"Test set accuracy Logistic Regression with scaled data: {:.2f}\".format(logreg.score(X_test_scaled,y_test)))\n", - "# Support Vector Machine\n", - "svm.fit(X_train_scaled, y_train)\n", - "print(\"Test set accuracy SVM with scaled data: {:.2f}\".format(logreg.score(X_test_scaled,y_test)))\n", - "# Decision Trees\n", - "deep_tree_clf.fit(X_train_scaled, y_train)\n", - "print(\"Test set accuracy with Decision Trees and scaled data: {:.2f}\".format(deep_tree_clf.score(X_test_scaled,y_test)))\n", - "\n", - "\n", - "from sklearn.ensemble import RandomForestClassifier\n", - "from sklearn.preprocessing import LabelEncoder\n", - "from sklearn.model_selection import cross_validate\n", - "# Data set not specificied\n", - "#Instantiate the model with 500 trees and entropy as splitting criteria\n", - "Random_Forest_model = RandomForestClassifier(n_estimators=500,criterion=\"entropy\")\n", - "Random_Forest_model.fit(X_train_scaled, y_train)\n", - "#Cross validation\n", - "accuracy = cross_validate(Random_Forest_model,X_test_scaled,y_test,cv=10)['test_score']\n", - "print(accuracy)\n", - "print(\"Test set accuracy with Random Forests and scaled data: {:.2f}\".format(Random_Forest_model.score(X_test_scaled,y_test)))\n", - "\n", - "\n", - "import scikitplot as skplt\n", - "y_pred = Random_Forest_model.predict(X_test_scaled)\n", - "skplt.metrics.plot_confusion_matrix(y_test, y_pred, normalize=True)\n", - "plt.show()\n", - "y_probas = Random_Forest_model.predict_proba(X_test_scaled)\n", - "skplt.metrics.plot_roc(y_test, y_probas)\n", - "plt.show()\n", - "skplt.metrics.plot_cumulative_gain(y_test, y_probas)\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Recall that the cumulative gains curve shows the percentage of the\n", - "overall number of cases in a given category *gained* by targeting a\n", - "percentage of the total number of cases.\n", - "\n", - "Similarly, the receiver operating characteristic curve, or ROC curve,\n", - "displays the diagnostic ability of a binary classifier system as its\n", - "discrimination threshold is varied. It plots the true positive rate against the false positive rate.\n", - "\n", - "\n", - "### Compare Bagging on Trees with Random Forests" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "bag_clf = BaggingClassifier(\n", - " DecisionTreeClassifier(splitter=\"random\", max_leaf_nodes=16, random_state=42),\n", - " n_estimators=500, max_samples=1.0, bootstrap=True, n_jobs=-1, random_state=42)" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "bag_clf.fit(X_train, y_train)\n", - "y_pred = bag_clf.predict(X_test)\n", - "from sklearn.ensemble import RandomForestClassifier\n", - "rnd_clf = RandomForestClassifier(n_estimators=500, max_leaf_nodes=16, n_jobs=-1, random_state=42)\n", - "rnd_clf.fit(X_train, y_train)\n", - "y_pred_rf = rnd_clf.predict(X_test)\n", - "np.sum(y_pred == y_pred_rf) / len(y_pred)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Boosting, a Bird's Eye View\n", - "\n", - "The basic idea is to combine weak classifiers in order to create a good\n", - "classifier. With a weak classifier we often intend a classifier which\n", - "produces results which are only slightly better than we would get by\n", - "random guesses.\n", - "\n", - "This is done by applying in an iterative way a weak (or a standard\n", - "classifier like decision trees) to modify the data. In each iteration\n", - "we emphasize those observations which are misclassified by weighting\n", - "them with a factor.\n", - "\n", - "\n", - "\n", - "Boosting is a way of fitting an additive expansion in a set of\n", - "elementary basis functions like for example some simple polynomials.\n", - "Assume for example that we have a function" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "f_M(x) = \\sum_{i=1}^M \\beta_m b(x;\\gamma_m),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $\\beta_m$ are the expansion parameters to be determined in a\n", - "minimization process and $b(x;\\gamma_m)$ are some simple functions of\n", - "the multivariable parameter $x$ which is characterized by the\n", - "parameters $\\gamma_m$.\n", - "\n", - "As an example, consider the Sigmoid function we used in logistic\n", - "regression. In that case, we can translate the function\n", - "$b(x;\\gamma_m)$ into the Sigmoid function" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\sigma(t) = \\frac{1}{1+\\exp{(-t)}},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $t=\\gamma_0+\\gamma_1 x$ and the parameters $\\gamma_0$ and\n", - "$\\gamma_1$ were determined by the Logistic Regression fitting\n", - "algorithm.\n", - "\n", - "As another example, consider the cost function we defined for linear regression" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(\\boldsymbol{y},\\boldsymbol{f}) = \\frac{1}{n} \\sum_{i=0}^{n-1}(y_i-f(x_i))^2.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In this case the function $f(x)$ was replaced by the design matrix\n", - "$\\boldsymbol{X}$ and the unknown linear regression parameters $\\boldsymbol{\\beta}$,\n", - "that is $\\boldsymbol{f}=\\boldsymbol{X}\\boldsymbol{\\beta}$. In linear regression we can \n", - "simply invert a matrix and obtain the parameters $\\beta$ by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{\\beta}=\\left(\\boldsymbol{X}^T\\boldsymbol{X}\\right)^{-1}\\boldsymbol{X}^T\\boldsymbol{y}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In iterative fitting or additive modeling, we minimize the cost function with respect to the parameters $\\beta_m$ and $\\gamma_m$.\n", - "\n", - "\n", - "### Iterative Fitting, Regression and Squared-error Cost Function\n", - "\n", - "The way we proceed is as follows (here we specialize to the squared-error cost function)\n", - "\n", - "1. Establish a cost function, here $\\cal{C}(\\boldsymbol{y},\\boldsymbol{f}) = \\frac{1}{n} \\sum_{i=0}^{n-1}(y_i-f_M(x_i))^2$ with $f_M(x) = \\sum_{i=1}^M \\beta_m b(x;\\gamma_m)$.\n", - "\n", - "2. Initialize with a guess $f_0(x)$. It could be one or even zero or some random numbers.\n", - "\n", - "3. For $m=1:M$\n", - "\n", - "a. minimize $\\sum_{i=0}^{n-1}(y_i-f_{m-1}(x_i)-\\beta b(x;\\gamma))^2$ wrt $\\gamma$ and $\\beta$\n", - "\n", - "b. This gives the optimal values $\\beta_m$ and $\\gamma_m$\n", - "\n", - "c. Determine then the new values $f_m(x)=f_{m-1}(x) +\\beta_m b(x;\\gamma_m)$\n", - "\n", - "\n", - "We could use any of the algorithms we have discussed till now. If we\n", - "use trees, $\\gamma$ parameterizes the split variables and split points\n", - "at the internal nodes, and the predictions at the terminal nodes.\n", - "\n", - "\n", - "\n", - "To better understand what happens, let us develop the steps for the iterative fitting using the above squared error function.\n", - "\n", - "For simplicity we assume also that our functions $b(x;\\gamma)=1+\\gamma x$. \n", - "\n", - "This means that for every iteration $m$, we need to optimize" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "(\\beta_m,\\gamma_m) = \\mathrm{argmin}_{\\beta,\\lambda}\\hspace{0.1cm} \\sum_{i=0}^{n-1}(y_i-f_{m-1}(x_i)-\\beta b(x;\\gamma))^2=\\sum_{i=0}^{n-1}(y_i-f_{m-1}(x_i)-\\beta(1+\\gamma x_i))^2.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We start our iteration by simply setting $f_0(x)=0$. \n", - "Taking the derivatives with respect to $\\beta$ and $\\gamma$ we obtain" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial \\cal{C}}{\\partial \\beta} = -2\\sum_{i}(1+\\gamma x_i)(y_i-\\beta(1+\\gamma x_i))=0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial \\cal{C}}{\\partial \\gamma} =-2\\sum_{i}\\beta x_i(y_i-\\beta(1+\\gamma x_i))=0.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We can then rewrite these equations as (defining $\\boldsymbol{w}=\\boldsymbol{e}+\\gamma \\boldsymbol{x})$ with $\\boldsymbol{e}$ being the unit vector)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\gamma \\boldsymbol{w}^T(\\boldsymbol{y}-\\beta\\gamma \\boldsymbol{w})=0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which gives us $\\beta = \\boldsymbol{w}^T\\boldsymbol{y}/(\\boldsymbol{w}^T\\boldsymbol{w})$. Similarly we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\beta\\gamma \\boldsymbol{x}^T(\\boldsymbol{y}-\\beta(1+\\gamma \\boldsymbol{x}))=0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which leads to $\\gamma =(\\boldsymbol{x}^T\\boldsymbol{y}-\\beta\\boldsymbol{x}^T\\boldsymbol{e})/(\\beta\\boldsymbol{x}^T\\boldsymbol{x})$. Inserting\n", - "for $\\beta$ gives us an equation for $\\gamma$. This is a non-linear equation in the unknown $\\gamma$ and has to be solved numerically. \n", - "\n", - "The solution to these two equations gives us in turn $\\beta_1$ and $\\gamma_1$ leading to the new expression for $f_1(x)$ as\n", - "$f_1(x) = \\beta_1(1+\\gamma_1x)$. Doing this $M$ times results in our final estimate for the function $f$. \n", - "\n", - "\n", - "\n", - "### Iterative Fitting, Classification and AdaBoost\n", - "\n", - "Let us consider a binary classification problem with two outcomes $y_i \\in \\{-1,1\\}$ and $i=0,1,2,\\dots,n-1$ as our set of\n", - "observations. We define a classification function $G(x)$ which produces a prediction taking one or the other of the two values \n", - "$\\{-1,1\\}$.\n", - "\n", - "The error rate of the training sample is then" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathrm{\\overline{err}}=\\frac{1}{n} \\sum_{i=0}^{n-1} I(y_i\\ne G(x_i)).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The iterative procedure starts with defining a weak classifier whose\n", - "error rate is barely better than random guessing. The iterative\n", - "procedure in boosting is to sequentially apply a weak\n", - "classification algorithm to repeatedly modified versions of the data\n", - "producing a sequence of weak classifiers $G_m(x)$.\n", - "\n", - "Here we will express our function $f(x)$ in terms of $G(x)$. That is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "f_M(x) = \\sum_{i=1}^M \\beta_m b(x;\\gamma_m),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "will be a function of" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "G_M(x) = \\mathrm{sign} \\sum_{i=1}^M \\alpha_m G_m(x).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In our iterative procedure we define thus" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "f_m(x) = f_{m-1}(x)+\\beta_mG_m(x).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The simplest possible cost function which leads (also simple from a computational point of view) to the AdaBoost algorithm is the\n", - "exponential cost/loss function defined as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(\\boldsymbol{y},\\boldsymbol{f}) = \\sum_{i=0}^{n-1}\\exp{(-y_i(f_{m-1}(x_i)+\\beta G(x_i))}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We optimize $\\beta$ and $G$ for each value of $m=1:M$ as we did in the regression case.\n", - "This is normally done in two steps. Let us however first rewrite the cost function as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(\\boldsymbol{y},\\boldsymbol{f}) = \\sum_{i=0}^{n-1}w_i^{m}\\exp{(-y_i\\beta G(x_i))},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where we have defined $w_i^m= \\exp{(-y_if_{m-1}(x_i))}$.\n", - "\n", - "\n", - "\n", - "First, for any $\\beta > 0$, we optimize $G$ by setting" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "G_m(x) = \\mathrm{sign} \\sum_{i=0}^{n-1} w_i^m I(y_i \\ne G_(x_i)),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which is the classifier that minimizes the weighted error rate in predicting $y$.\n", - "\n", - "We can do this by rewriting" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\exp{-(\\beta)}\\sum_{y_i=G(x_i)}w_i^m+\\exp{(\\beta)}\\sum_{y_i\\ne G(x_i)}w_i^m,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which can be rewritten as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "(\\exp{(\\beta)}-\\exp{-(\\beta)})\\sum_{i=0}^{n-1}w_i^mI(y_i\\ne G(x_i))+\\exp{(-\\beta)}\\sum_{i=0}^{n-1}w_i^m=0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which leads to" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\beta_m = \\frac{1}{2}\\log{\\frac{1-\\mathrm{\\overline{err}}}{\\mathrm{\\overline{err}}}},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where we have redefined the error as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathrm{\\overline{err}}_m=\\frac{1}{n}\\frac{\\sum_{i=0}^{n-1}w_i^mI(y_i\\ne G(x_i)}{\\sum_{i=0}^{n-1}w_i^m},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which leads to an update of" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "f_m(x) = f_{m-1}(x) +\\beta_m G_m(x).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "This leads to the new weights" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "w_i^{m+1} = w_i^m \\exp{(-y_i\\beta_m G_m(x_i))}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "### Adaptive boosting: AdaBoost, Basic Algorithm\n", - "\n", - "The algorithm here is rather straightforward. Assume that our weak\n", - "classifier is a decision tree and we consider a binary set of outputs\n", - "with $y_i \\in \\{-1,1\\}$ and $i=0,1,2,\\dots,n-1$ as our set of\n", - "observations. Our design matrix is given in terms of the\n", - "feature/predictor vectors\n", - "$\\boldsymbol{X}=[\\boldsymbol{x}_0\\boldsymbol{x}_1\\dots\\boldsymbol{x}_{p-1}]$. Finally, we define also a\n", - "classifier determined by our data via a function $G(x)$. This function tells us how well we are able to classify our outputs/targets $\\boldsymbol{y}$. \n", - "\n", - "We have already defined the misclassification error $\\mathrm{err}$ as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathrm{err}=\\frac{1}{n}\\sum_{i=0}^{n-1}I(y_i\\ne G(x_i)),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where the function $I()$ is one if we misclassify and zero if we classify correctly. \n", - "\n", - "\n", - "With the above definitions we are now ready to set up the algorithm for AdaBoost.\n", - "The basic idea is to set up weights which will be used to scale the correctly classified and the misclassified cases.\n", - "1. We start by initializing all weights to $w_i = 1/n$, with $i=0,1,2,\\dots n-1$. It is easy to see that we must have $\\sum_{i=0}^{n-1}w_i = 1$.\n", - "\n", - "2. We rewrite the misclassification error as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathrm{\\overline{err}}_m=\\frac{\\sum_{i=0}^{n-1}w_i^m I(y_i\\ne G(x_i))}{\\sum_{i=0}^{n-1}w_i},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "1. Then we start looping over all attempts at classifying, namely we start an iterative process for $m=1:M$, where $M$ is the final number of classifications. Our given classifier could for example be a plain decision tree.\n", - "\n", - "a. Fit then a given classifier to the training set using the weights $w_i$.\n", - "\n", - "b. Compute then $\\mathrm{err}$ and figure out which events are classified properly and which are classified wrongly.\n", - "\n", - "c. Define a quantity $\\alpha_{m} = \\log{(1-\\mathrm{\\overline{err}}_m)/\\mathrm{\\overline{err}}_m}$\n", - "\n", - "d. Set the new weights to $w_i = w_i\\times \\exp{(\\alpha_m I(y_i\\ne G(x_i)}$.\n", - "\n", - "\n", - "5. Compute the new classifier $G(x)= \\sum_{i=0}^{n-1}\\alpha_m I(y_i\\ne G(x_i)$.\n", - "\n", - "For the iterations with $m \\le 2$ the weights are modified\n", - "individually at each steps. The observations which were misclassified\n", - "at iteration $m-1$ have a weight which is larger than those which were\n", - "classified properly. As this proceeds, the observations which were\n", - "difficult to classifiy correctly are given a larger influence. Each\n", - "new classification step $m$ is then forced to concentrate on those\n", - "observations that are missed in the previous iterations.\n", - "\n", - "\n", - "\n", - "\n", - "Using **Scikit-Learn** it is easy to apply the adaptive boosting algorithm, as done here." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "from sklearn.ensemble import AdaBoostClassifier\n", - "\n", - "ada_clf = AdaBoostClassifier(\n", - " DecisionTreeClassifier(max_depth=1), n_estimators=200,\n", - " algorithm=\"SAMME.R\", learning_rate=0.5, random_state=42)\n", - "ada_clf.fit(X_train, y_train)\n", - "\n", - "from sklearn.ensemble import AdaBoostClassifier\n", - "\n", - "ada_clf = AdaBoostClassifier(\n", - " DecisionTreeClassifier(max_depth=1), n_estimators=200,\n", - " algorithm=\"SAMME.R\", learning_rate=0.5, random_state=42)\n", - "ada_clf.fit(X_train_scaled, y_train)\n", - "y_pred = ada_clf.predict(X_test_scaled)\n", - "skplt.metrics.plot_confusion_matrix(y_test, y_pred, normalize=True)\n", - "plt.show()\n", - "y_probas = ada_clf.predict_proba(X_test_scaled)\n", - "skplt.metrics.plot_roc(y_test, y_probas)\n", - "plt.show()\n", - "skplt.metrics.plot_cumulative_gain(y_test, y_probas)\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Gradient boosting: Basics with Steepest Descent/Functional Gradient Descent\n", - "\n", - "Gradient boosting is again a similar technique to Adaptive boosting,\n", - "it combines so-called weak classifiers or regressors into a strong\n", - "method via a series of iterations.\n", - "\n", - "In order to understand the method, let us illustrate its basics by\n", - "bringing back the essential steps in linear regression, where our cost\n", - "function was the least squares function.\n", - "\n", - "\n", - "We start again with our cost function $\\cal{C}(\\boldsymbol{y}m\\boldsymbol{f})=\\sum_{i=0}^{n-1}\\cal{L}(y_i, f(x_i))$ where we want to minimize\n", - "This means that for every iteration, we need to optimize" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "(\\hat{\\boldsymbol{f}}) = \\mathrm{argmin}_{\\boldsymbol{f}}\\hspace{0.1cm} \\sum_{i=0}^{n-1}(y_i-f(x_i))^2.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We define a real function $h_m(x)$ that defines our final function $f_M(x)$ as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "f_M(x) = \\sum_{m=0}^M h_m(x).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In the steepest decent approach we approximate $h_m(x) = -\\rho_m g_m(x)$, where $\\rho_m$ is a scalar and $g_m(x)$ the gradient defined as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "g_m(x_i) = \\left[ \\frac{\\partial \\cal{L}(y_i, f(x_i))}{\\partial f(x_i)}\\right]_{f(x_i)=f_{m-1}(x_i)}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "With the new gradient we can update $f_m(x) = f_{m-1}(x) -\\rho_m g_m(x)$. Using the above squared-error function we see that\n", - "the gradient is $g_m(x_i) = -2(y_i-f(x_i))$.\n", - "\n", - "Choosing $f_0(x)=0$ we obtain $g_m(x) = -2y_i$ and inserting this into the minimization problem for the cost function we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "(\\rho_1) = \\mathrm{argmin}_{\\rho}\\hspace{0.1cm} \\sum_{i=0}^{n-1}(y_i+2\\rho y_i)^2.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Optimizing with respect to $\\rho$ we obtain (taking the derivative) that $\\rho_1 = -1/2$. We have then that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "f_1(x) = f_{0}(x) -\\rho_1 g_1(x)=-y_i.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We can then proceed and compute" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "g_2(x_i) = \\left[ \\frac{\\partial \\cal{L}(y_i, f(x_i))}{\\partial f(x_i)}\\right]_{f(x_i)=f_{1}(x_i)=y_i}=-4y_i,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and find a new value for $\\rho_2=-1/2$ and continue till we have reached $m=M$. We can modify the steepest descent method, or steepest boosting, by introducing what is called **gradient boosting**. \n", - "\n", - "\n", - "Steepest descent is however not much used, since it only optimizes $f$ at a fixed set of $n$ points,\n", - "so we do not learn a function that can generalize. However, we can modify the algorithm by\n", - "fitting a weak learner to approximate the negative gradient signal. \n", - "\n", - "Suppose we have a cost function $C(f)=\\sum_{i=0}^{n-1}L(y_i, f(x_i))$ where $y_i$ is our target and $f(x_i)$ the function which is meant to model $y_i$. The above cost function could be our standard squared-error function" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(\\boldsymbol{y},\\boldsymbol{f})=\\sum_{i=0}^{n-1}(y_i-f(x_i))^2.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The way we proceed in an iterative fashion is to\n", - "1. Initialize our estimate $f_0(x)$.\n", - "\n", - "2. For $m=1:M$, we\n", - "\n", - "a. compute the negative gradient vector $\\boldsymbol{u}_m = -\\partial C(\\boldsymbol{y},\\boldsymbol{f})/\\partial \\boldsymbol{f}(x)$ at $f(x) = f_{m-1}(x)$;\n", - "\n", - "b. fit the so-called base-learner to the negative gradient $h_m(u_m,x)$;\n", - "\n", - "c. update the estimate $f_m(x) = f_{m-1}(x)+h_m(u_m,x)$;\n", - "\n", - "\n", - "4. The final estimate is then $f_M(x) = \\sum_{m=1}^M h_m(u_m,x)$.\n", - "\n", - "## Gradient Boosting, Examples of Regression" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import matplotlib.pyplot as plt\n", - "import numpy as np\n", - "from sklearn.model_selection import train_test_split\n", - "from sklearn.ensemble import GradientBoostingRegressor\n", - "from sklearn.preprocessing import StandardScaler\n", - "import scikitplot as skplt\n", - "from sklearn.metrics import mean_squared_error\n", - "\n", - "n = 100\n", - "maxdegree = 6\n", - "\n", - "# Make data set.\n", - "x = np.linspace(-3, 3, n).reshape(-1, 1)\n", - "y = np.exp(-x**2) + 1.5 * np.exp(-(x-2)**2)+ np.random.normal(0, 0.1, x.shape)\n", - "\n", - "error = np.zeros(maxdegree)\n", - "bias = np.zeros(maxdegree)\n", - "variance = np.zeros(maxdegree)\n", - "polydegree = np.zeros(maxdegree)\n", - "X_train, X_test, y_train, y_test = train_test_split(x, y, test_size=0.2)\n", - "scaler = StandardScaler()\n", - "scaler.fit(X_train)\n", - "X_train_scaled = scaler.transform(X_train)\n", - "X_test_scaled = scaler.transform(X_test)\n", - "\n", - "for degree in range(1,maxdegree):\n", - " model = GradientBoostingRegressor(max_depth=degree, n_estimators=100, learning_rate=1.0) \n", - " model.fit(X_train_scaled,y_train)\n", - " y_pred = model.predict(X_test_scaled)\n", - " polydegree[degree] = degree\n", - " error[degree] = np.mean( np.mean((y_test - y_pred)**2) )\n", - " bias[degree] = np.mean( (y_test - np.mean(y_pred))**2 )\n", - " variance[degree] = np.mean( np.var(y_pred) )\n", - " print('Max depth:', degree)\n", - " print('Error:', error[degree])\n", - " print('Bias^2:', bias[degree])\n", - " print('Var:', variance[degree])\n", - " print('{} >= {} + {} = {}'.format(error[degree], bias[degree], variance[degree], bias[degree]+variance[degree]))\n", - "\n", - "plt.xlim(1,maxdegree-1)\n", - "plt.plot(polydegree, error, label='Error')\n", - "plt.plot(polydegree, bias, label='bias')\n", - "plt.plot(polydegree, variance, label='Variance')\n", - "plt.legend()\n", - "save_fig(\"gdregression\")\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Gradient Boosting, Classification Example" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import matplotlib.pyplot as plt\n", - "import numpy as np\n", - "from sklearn.model_selection import train_test_split \n", - "from sklearn.datasets import load_breast_cancer\n", - "import scikitplot as skplt\n", - "from sklearn.ensemble import GradientBoostingClassifier\n", - "from sklearn.model_selection import cross_validate\n", - "\n", - "# Load the data\n", - "cancer = load_breast_cancer()\n", - "\n", - "X_train, X_test, y_train, y_test = train_test_split(cancer.data,cancer.target,random_state=0)\n", - "print(X_train.shape)\n", - "print(X_test.shape)\n", - "#now scale the data\n", - "from sklearn.preprocessing import StandardScaler\n", - "scaler = StandardScaler()\n", - "scaler.fit(X_train)\n", - "X_train_scaled = scaler.transform(X_train)\n", - "X_test_scaled = scaler.transform(X_test)\n", - "\n", - "gd_clf = GradientBoostingClassifier(max_depth=3, n_estimators=100, learning_rate=1.0) \n", - "gd_clf.fit(X_train_scaled, y_train)\n", - "#Cross validation\n", - "accuracy = cross_validate(gd_clf,X_test_scaled,y_test,cv=10)['test_score']\n", - "print(accuracy)\n", - "print(\"Test set accuracy with Random Forests and scaled data: {:.2f}\".format(gd_clf.score(X_test_scaled,y_test)))\n", - "\n", - "import scikitplot as skplt\n", - "y_pred = gd_clf.predict(X_test_scaled)\n", - "skplt.metrics.plot_confusion_matrix(y_test, y_pred, normalize=True)\n", - "save_fig(\"gdclassiffierconfusion\")\n", - "plt.show()\n", - "y_probas = gd_clf.predict_proba(X_test_scaled)\n", - "skplt.metrics.plot_roc(y_test, y_probas)\n", - "save_fig(\"gdclassiffierroc\")\n", - "plt.show()\n", - "skplt.metrics.plot_cumulative_gain(y_test, y_probas)\n", - "save_fig(\"gdclassiffiercgain\")\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## XGBoost: Extreme Gradient Boosting\n", - "\n", - "\n", - "[XGBoost](https://github.com/dmlc/xgboost) or Extreme Gradient\n", - "Boosting, is an optimized distributed gradient boosting library\n", - "designed to be highly efficient, flexible and portable. It implements\n", - "machine learning algorithms under the Gradient Boosting\n", - "framework. XGBoost provides a parallel tree boosting that solve many\n", - "data science problems in a fast and accurate way. See the [article by Chen and Guestrin](https://arxiv.org/abs/1603.02754).\n", - "\n", - "The authors design and build a highly scalable end-to-end tree\n", - "boosting system. It has a theoretically justified weighted quantile\n", - "sketch for efficient proposal calculation. It introduces a novel sparsity-aware algorithm for parallel tree learning and an effective cache-aware block structure for out-of-core tree learning.\n", - "\n", - "It is now the algorithm which wins essentially all ML competitions!!!\n", - "\n", - "## Regression Case" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import matplotlib.pyplot as plt\n", - "import numpy as np\n", - "from sklearn.model_selection import train_test_split\n", - "import xgboost as xgb\n", - "from sklearn.preprocessing import StandardScaler\n", - "import scikitplot as skplt\n", - "from sklearn.metrics import mean_squared_error\n", - "\n", - "n = 100\n", - "maxdegree = 6\n", - "\n", - "# Make data set.\n", - "x = np.linspace(-3, 3, n).reshape(-1, 1)\n", - "y = np.exp(-x**2) + 1.5 * np.exp(-(x-2)**2)+ np.random.normal(0, 0.1, x.shape)\n", - "\n", - "error = np.zeros(maxdegree)\n", - "bias = np.zeros(maxdegree)\n", - "variance = np.zeros(maxdegree)\n", - "polydegree = np.zeros(maxdegree)\n", - "X_train, X_test, y_train, y_test = train_test_split(x, y, test_size=0.2)\n", - "scaler = StandardScaler()\n", - "scaler.fit(X_train)\n", - "X_train_scaled = scaler.transform(X_train)\n", - "X_test_scaled = scaler.transform(X_test)\n", - "\n", - "for degree in range(maxdegree):\n", - " model = xgb.XGBRegressor(objective ='reg:squarederror', colsaobjective ='reg:squarederror', colsample_bytree = 0.3, learning_rate = 0.1,max_depth = degree, alpha = 10, n_estimators = 200)\n", - "\n", - " model.fit(X_train_scaled,y_train)\n", - " y_pred = model.predict(X_test_scaled)\n", - " polydegree[degree] = degree\n", - " error[degree] = np.mean( np.mean((y_test - y_pred)**2) )\n", - " bias[degree] = np.mean( (y_test - np.mean(y_pred))**2 )\n", - " variance[degree] = np.mean( np.var(y_pred) )\n", - " print('Max depth:', degree)\n", - " print('Error:', error[degree])\n", - " print('Bias^2:', bias[degree])\n", - " print('Var:', variance[degree])\n", - " print('{} >= {} + {} = {}'.format(error[degree], bias[degree], variance[degree], bias[degree]+variance[degree]))\n", - "\n", - "plt.xlim(1,maxdegree-1)\n", - "plt.plot(polydegree, error, label='Error')\n", - "plt.plot(polydegree, bias, label='bias')\n", - "plt.plot(polydegree, variance, label='Variance')\n", - "plt.legend()\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "As you will see from the confusion matrix below, XGBoots does an excellent job on the Wisconsin cancer data and outperforms essentially all agorithms we have discussed till now." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "\n", - "import matplotlib.pyplot as plt\n", - "import numpy as np\n", - "from sklearn.model_selection import train_test_split \n", - "from sklearn.datasets import load_breast_cancer\n", - "from sklearn.preprocessing import LabelEncoder\n", - "from sklearn.model_selection import cross_validate\n", - "import scikitplot as skplt\n", - "import xgboost as xgb\n", - "# Load the data\n", - "cancer = load_breast_cancer()\n", - "\n", - "X_train, X_test, y_train, y_test = train_test_split(cancer.data,cancer.target,random_state=0)\n", - "print(X_train.shape)\n", - "print(X_test.shape)\n", - "#now scale the data\n", - "from sklearn.preprocessing import StandardScaler\n", - "scaler = StandardScaler()\n", - "scaler.fit(X_train)\n", - "X_train_scaled = scaler.transform(X_train)\n", - "X_test_scaled = scaler.transform(X_test)\n", - "\n", - "xg_clf = xgb.XGBClassifier()\n", - "xg_clf.fit(X_train_scaled,y_train)\n", - "\n", - "y_test = xg_clf.predict(X_test_scaled)\n", - "\n", - "print(\"Test set accuracy with Random Forests and scaled data: {:.2f}\".format(xg_clf.score(X_test_scaled,y_test)))\n", - "\n", - "import scikitplot as skplt\n", - "y_pred = xg_clf.predict(X_test_scaled)\n", - "skplt.metrics.plot_confusion_matrix(y_test, y_pred, normalize=True)\n", - "save_fig(\"xdclassiffierconfusion\")\n", - "plt.show()\n", - "y_probas = xg_clf.predict_proba(X_test_scaled)\n", - "skplt.metrics.plot_roc(y_test, y_probas)\n", - "save_fig(\"xdclassiffierroc\")\n", - "plt.show()\n", - "skplt.metrics.plot_cumulative_gain(y_test, y_probas)\n", - "save_fig(\"gdclassiffiercgain\")\n", - "plt.show()\n", - "\n", - "\n", - "xgb.plot_tree(xg_clf,num_trees=0)\n", - "plt.rcParams['figure.figsize'] = [50, 10]\n", - "save_fig(\"xgtree\")\n", - "plt.show()\n", - "\n", - "xgb.plot_importance(xg_clf)\n", - "plt.rcParams['figure.figsize'] = [5, 5]\n", - "save_fig(\"xgparams\")\n", - "plt.show()" - ] - } - ], - "metadata": { - "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.8.5" - } - }, - "nbformat": 4, - "nbformat_minor": 4 -} \ No newline at end of file diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter7.py b/doc/LectureNotes/_build/jupyter_execute/chapter7.py deleted file mode 100644 index 37183ca85..000000000 --- a/doc/LectureNotes/_build/jupyter_execute/chapter7.py +++ /dev/null @@ -1,1012 +0,0 @@ -# Ensemble Methods: From a Single Tree to Many Trees and Extreme Boosting, Meet the Jungle of Methods - -As stated previously and seen in many of the examples discussed in the previous chapter about -a single decision tree, we often end up overfitting our training -data. This normally means that we have a high variance. Can we reduce -the variance of a statistical learning method? - -This leads us to a set of different methods that can combine different -machine learning algorithms or just use one of them to construct -forests and jungles of trees, homogeneous ones or heterogenous -ones. These methods are recognized by different names which we will -try to explain here. These are - -1. Voting classifiers - -2. Bagging and Pasting - -3. Random forests - -4. Boosting methods, from adaptive to Extreme Gradient Boosting (XGBoost) - -We discuss these methods here. - -### An Overview of Ensemble Methods - - - - - -## Bagging - -The **plain** decision trees suffer from high -variance. This means that if we split the training data into two parts -at random, and fit a decision tree to both halves, the results that we -get could be quite different. In contrast, a procedure with low -variance will yield similar results if applied repeatedly to distinct -data sets; linear regression tends to have low variance, if the ratio -of $n$ to $p$ is moderately large. - -**Bootstrap aggregation**, or just **bagging**, is a -general-purpose procedure for reducing the variance of a statistical -learning method. - - -Bagging typically results in improved accuracy -over prediction using a single tree. Unfortunately, however, it can be -difficult to interpret the resulting model. Recall that one of the -advantages of decision trees is the attractive and easily interpreted -diagram that results. - -However, when we bag a large number of trees, it is no longer -possible to represent the resulting statistical learning procedure -using a single tree, and it is no longer clear which variables are -most important to the procedure. Thus, bagging improves prediction -accuracy at the expense of interpretability. Although the collection -of bagged trees is much more difficult to interpret than a single -tree, one can obtain an overall summary of the importance of each -predictor using the MSE (for bagging regression trees) or the Gini -index (for bagging classification trees). In the case of bagging -regression trees, we can record the total amount that the MSE is -decreased due to splits over a given predictor, averaged over all $B$ possible -trees. A large value indicates an important predictor. Similarly, in -the context of bagging classification trees, we can add up the total -amount that the Gini index is decreased by splits over a given -predictor, averaged over all $B$ trees. - -heads_proba = 0.51 -coin_tosses = (np.random.rand(10000, 10) < heads_proba).astype(np.int32) -cumulative_heads_ratio = np.cumsum(coin_tosses, axis=0) / np.arange(1, 10001).reshape(-1, 1) -plt.figure(figsize=(8,3.5)) -plt.plot(cumulative_heads_ratio) -plt.plot([0, 10000], [0.51, 0.51], "k--", linewidth=2, label="51%") -plt.plot([0, 10000], [0.5, 0.5], "k-", label="50%") -plt.xlabel("Number of coin tosses") -plt.ylabel("Heads ratio") -plt.legend(loc="lower right") -plt.axis([0, 10000, 0.42, 0.58]) -save_fig("votingsimple") -plt.show() - -from sklearn.model_selection import train_test_split -from sklearn.datasets import make_moons - -X, y = make_moons(n_samples=500, noise=0.30, random_state=42) -X_train, X_test, y_train, y_test = train_test_split(X, y, random_state=42) - -from sklearn.ensemble import RandomForestClassifier -from sklearn.ensemble import VotingClassifier -from sklearn.linear_model import LogisticRegression -from sklearn.svm import SVC - -log_clf = LogisticRegression(solver="liblinear", random_state=42) -rnd_clf = RandomForestClassifier(n_estimators=10, random_state=42) -svm_clf = SVC(gamma="auto", random_state=42) - -voting_clf = VotingClassifier( - estimators=[('lr', log_clf), ('rf', rnd_clf), ('svc', svm_clf)], - voting='hard') - -voting_clf.fit(X_train, y_train) - -from sklearn.metrics import accuracy_score - -for clf in (log_clf, rnd_clf, svm_clf, voting_clf): - clf.fit(X_train, y_train) - y_pred = clf.predict(X_test) - print(clf.__class__.__name__, accuracy_score(y_test, y_pred)) - -log_clf = LogisticRegression(solver="liblinear", random_state=42) -rnd_clf = RandomForestClassifier(n_estimators=10, random_state=42) -svm_clf = SVC(gamma="auto", probability=True, random_state=42) - -voting_clf = VotingClassifier( - estimators=[('lr', log_clf), ('rf', rnd_clf), ('svc', svm_clf)], - voting='soft') -voting_clf.fit(X_train, y_train) - -from sklearn.metrics import accuracy_score - -for clf in (log_clf, rnd_clf, svm_clf, voting_clf): - clf.fit(X_train, y_train) - y_pred = clf.predict(X_test) - print(clf.__class__.__name__, accuracy_score(y_test, y_pred)) - -from sklearn.model_selection import train_test_split -from sklearn.datasets import make_moons - -X, y = make_moons(n_samples=500, noise=0.30, random_state=42) -X_train, X_test, y_train, y_test = train_test_split(X, y, random_state=42) -from sklearn.ensemble import RandomForestClassifier -from sklearn.ensemble import VotingClassifier -from sklearn.linear_model import LogisticRegression -from sklearn.svm import SVC - -log_clf = LogisticRegression(random_state=42) -rnd_clf = RandomForestClassifier(random_state=42) -svm_clf = SVC(random_state=42) - -voting_clf = VotingClassifier( - estimators=[('lr', log_clf), ('rf', rnd_clf), ('svc', svm_clf)], - voting='hard') -voting_clf.fit(X_train, y_train) - -from sklearn.metrics import accuracy_score - -for clf in (log_clf, rnd_clf, svm_clf, voting_clf): - clf.fit(X_train, y_train) - y_pred = clf.predict(X_test) - print(clf.__class__.__name__, accuracy_score(y_test, y_pred)) - -log_clf = LogisticRegression(random_state=42) -rnd_clf = RandomForestClassifier(random_state=42) -svm_clf = SVC(probability=True, random_state=42) - -voting_clf = VotingClassifier( - estimators=[('lr', log_clf), ('rf', rnd_clf), ('svc', svm_clf)], - voting='soft') -voting_clf.fit(X_train, y_train) - -from sklearn.metrics import accuracy_score - -for clf in (log_clf, rnd_clf, svm_clf, voting_clf): - clf.fit(X_train, y_train) - y_pred = clf.predict(X_test) - print(clf.__class__.__name__, accuracy_score(y_test, y_pred)) - -## Bagging Examples - -from sklearn.ensemble import BaggingClassifier -from sklearn.tree import DecisionTreeClassifier - -bag_clf = BaggingClassifier( - DecisionTreeClassifier(random_state=42), n_estimators=500, - max_samples=100, bootstrap=True, n_jobs=-1, random_state=42) -bag_clf.fit(X_train, y_train) -y_pred = bag_clf.predict(X_test) - -from sklearn.metrics import accuracy_score -print(accuracy_score(y_test, y_pred)) - -tree_clf = DecisionTreeClassifier(random_state=42) -tree_clf.fit(X_train, y_train) -y_pred_tree = tree_clf.predict(X_test) -print(accuracy_score(y_test, y_pred_tree)) - -%matplotlib inline - -from matplotlib.colors import ListedColormap - -def plot_decision_boundary(clf, X, y, axes=[-1.5, 2.5, -1, 1.5], alpha=0.5, contour=True): - x1s = np.linspace(axes[0], axes[1], 100) - x2s = np.linspace(axes[2], axes[3], 100) - x1, x2 = np.meshgrid(x1s, x2s) - X_new = np.c_[x1.ravel(), x2.ravel()] - y_pred = clf.predict(X_new).reshape(x1.shape) - custom_cmap = ListedColormap(['#fafab0','#9898ff','#a0faa0']) - plt.contourf(x1, x2, y_pred, alpha=0.3, cmap=custom_cmap) - if contour: - custom_cmap2 = ListedColormap(['#7d7d58','#4c4c7f','#507d50']) - plt.contour(x1, x2, y_pred, cmap=custom_cmap2, alpha=0.8) - plt.plot(X[:, 0][y==0], X[:, 1][y==0], "yo", alpha=alpha) - plt.plot(X[:, 0][y==1], X[:, 1][y==1], "bs", alpha=alpha) - plt.axis(axes) - plt.xlabel(r"$x_1$", fontsize=18) - plt.ylabel(r"$x_2$", fontsize=18, rotation=0) -plt.figure(figsize=(11,4)) -plt.subplot(121) -plot_decision_boundary(tree_clf, X, y) -plt.title("Decision Tree", fontsize=14) -plt.subplot(122) -plot_decision_boundary(bag_clf, X, y) -plt.title("Decision Trees with Bagging", fontsize=14) -save_fig("baggingtree") -plt.show() - -### Making your own Bootstrap: Changing the Level of the Decision Tree - -Let us bring up our good old boostrap example from the linear regression lectures. We change the linerar regression algorithm with -a decision tree wth different depths and perform a bootstrap aggregate (in this case we perform as many bootstraps as data points $n$). - - -import matplotlib.pyplot as plt -import numpy as np -from sklearn.model_selection import train_test_split -from sklearn.pipeline import make_pipeline -from sklearn.utils import resample -from sklearn.tree import DecisionTreeRegressor - -n = 100 -n_boostraps = 100 -maxdepth = 8 - -# Make data set. -x = np.linspace(-3, 3, n).reshape(-1, 1) -y = np.exp(-x**2) + 1.5 * np.exp(-(x-2)**2)+ np.random.normal(0, 0.1, x.shape) -error = np.zeros(maxdepth) -bias = np.zeros(maxdepth) -variance = np.zeros(maxdepth) -polydegree = np.zeros(maxdepth) -X_train, X_test, y_train, y_test = train_test_split(x, y, test_size=0.2) - -from sklearn.preprocessing import StandardScaler -scaler = StandardScaler() -scaler.fit(X_train) -X_train_scaled = scaler.transform(X_train) -X_test_scaled = scaler.transform(X_test) - -# we produce a simple tree first as benchmark -simpletree = DecisionTreeRegressor(max_depth=3) -simpletree.fit(X_train_scaled, y_train) -simpleprediction = simpletree.predict(X_test_scaled) -for degree in range(1,maxdepth): - model = DecisionTreeRegressor(max_depth=degree) - y_pred = np.empty((y_test.shape[0], n_boostraps)) - for i in range(n_boostraps): - x_, y_ = resample(X_train_scaled, y_train) - model.fit(x_, y_) - y_pred[:, i] = model.predict(X_test_scaled)#.ravel() - - polydegree[degree] = degree - error[degree] = np.mean( np.mean((y_test - y_pred)**2, axis=1, keepdims=True) ) - bias[degree] = np.mean( (y_test - np.mean(y_pred, axis=1, keepdims=True))**2 ) - variance[degree] = np.mean( np.var(y_pred, axis=1, keepdims=True) ) - print('Polynomial degree:', degree) - print('Error:', error[degree]) - print('Bias^2:', bias[degree]) - print('Var:', variance[degree]) - print('{} >= {} + {} = {}'.format(error[degree], bias[degree], variance[degree], bias[degree]+variance[degree])) - -mse_simpletree= np.mean( np.mean((y_test - simpleprediction)**2) -print(mse_simpletree) -plt.xlim(1,maxdepth) -plt.plot(polydegree, error, label='MSE') -plt.plot(polydegree, bias, label='bias') -plt.plot(polydegree, variance, label='Variance') -plt.legend() -save_fig("baggingboot") -plt.show() - -## Random forests - -Random forests provide an improvement over bagged trees by way of a -small tweak that decorrelates the trees. - -As in bagging, we build a -number of decision trees on bootstrapped training samples. But when -building these decision trees, each time a split in a tree is -considered, a random sample of $m$ predictors is chosen as split -candidates from the full set of $p$ predictors. The split is allowed to -use only one of those $m$ predictors. - -A fresh sample of $m$ predictors is -taken at each split, and typically we choose - -$$ -m\approx \sqrt{p}. -$$ - -In building a random forest, at -each split in the tree, the algorithm is not even allowed to consider -a majority of the available predictors. - -The reason for this is rather clever. Suppose that there is one very -strong predictor in the data set, along with a number of other -moderately strong predictors. Then in the collection of bagged -variable importance random forest trees, most or all of the trees will -use this strong predictor in the top split. Consequently, all of the -bagged trees will look quite similar to each other. Hence the -predictions from the bagged trees will be highly correlated. -Unfortunately, averaging many highly correlated quantities does not -lead to as large of a reduction in variance as averaging many -uncorrelated quantities. In particular, this means that bagging will -not lead to a substantial reduction in variance over a single tree in -this setting. - - -The algorithm described here can be applied to both classification and regression problems. - -We will grow of forest of say $B$ trees. -1. For $b=1:B$ - - * Draw a bootstrap sample from the training data organized in our $\boldsymbol{X}$ matrix. - - * We grow then a random forest tree $T_b$ based on the bootstrapped data by repeating the steps outlined till we reach the maximum node size is reached - -1. we select $m \le p$ variables at random from the $p$ predictors/features - -2. pick the best split point among the $m$ features using for example the CART algorithm and create a new node - -3. split the node into daughter nodes - - - -4. Output then the ensemble of trees $\{T_b\}_1^{B}$ and make predictions for either a regression type of problem or a classification type of problem. - -import matplotlib.pyplot as plt -import numpy as np -from sklearn.model_selection import train_test_split -from sklearn.datasets import load_breast_cancer -from sklearn.svm import SVC -from sklearn.linear_model import LogisticRegression -from sklearn.tree import DecisionTreeClassifier -from sklearn.ensemble import BaggingClassifier - -# Load the data -cancer = load_breast_cancer() - -X_train, X_test, y_train, y_test = train_test_split(cancer.data,cancer.target,random_state=0) -print(X_train.shape) -print(X_test.shape) -# Logistic Regression -logreg = LogisticRegression(solver='lbfgs') -logreg.fit(X_train, y_train) -print("Test set accuracy with Logistic Regression: {:.2f}".format(logreg.score(X_test,y_test))) -# Support vector machine -svm = SVC(gamma='auto', C=100) -svm.fit(X_train, y_train) -print("Test set accuracy with SVM: {:.2f}".format(svm.score(X_test,y_test))) -# Decision Trees -deep_tree_clf = DecisionTreeClassifier(max_depth=None) -deep_tree_clf.fit(X_train, y_train) -print("Test set accuracy with Decision Trees: {:.2f}".format(deep_tree_clf.score(X_test,y_test))) -#now scale the data -from sklearn.preprocessing import StandardScaler -scaler = StandardScaler() -scaler.fit(X_train) -X_train_scaled = scaler.transform(X_train) -X_test_scaled = scaler.transform(X_test) -# Logistic Regression -logreg.fit(X_train_scaled, y_train) -print("Test set accuracy Logistic Regression with scaled data: {:.2f}".format(logreg.score(X_test_scaled,y_test))) -# Support Vector Machine -svm.fit(X_train_scaled, y_train) -print("Test set accuracy SVM with scaled data: {:.2f}".format(logreg.score(X_test_scaled,y_test))) -# Decision Trees -deep_tree_clf.fit(X_train_scaled, y_train) -print("Test set accuracy with Decision Trees and scaled data: {:.2f}".format(deep_tree_clf.score(X_test_scaled,y_test))) - - -from sklearn.ensemble import RandomForestClassifier -from sklearn.preprocessing import LabelEncoder -from sklearn.model_selection import cross_validate -# Data set not specificied -#Instantiate the model with 500 trees and entropy as splitting criteria -Random_Forest_model = RandomForestClassifier(n_estimators=500,criterion="entropy") -Random_Forest_model.fit(X_train_scaled, y_train) -#Cross validation -accuracy = cross_validate(Random_Forest_model,X_test_scaled,y_test,cv=10)['test_score'] -print(accuracy) -print("Test set accuracy with Random Forests and scaled data: {:.2f}".format(Random_Forest_model.score(X_test_scaled,y_test))) - - -import scikitplot as skplt -y_pred = Random_Forest_model.predict(X_test_scaled) -skplt.metrics.plot_confusion_matrix(y_test, y_pred, normalize=True) -plt.show() -y_probas = Random_Forest_model.predict_proba(X_test_scaled) -skplt.metrics.plot_roc(y_test, y_probas) -plt.show() -skplt.metrics.plot_cumulative_gain(y_test, y_probas) -plt.show() - -Recall that the cumulative gains curve shows the percentage of the -overall number of cases in a given category *gained* by targeting a -percentage of the total number of cases. - -Similarly, the receiver operating characteristic curve, or ROC curve, -displays the diagnostic ability of a binary classifier system as its -discrimination threshold is varied. It plots the true positive rate against the false positive rate. - - -### Compare Bagging on Trees with Random Forests - -bag_clf = BaggingClassifier( - DecisionTreeClassifier(splitter="random", max_leaf_nodes=16, random_state=42), - n_estimators=500, max_samples=1.0, bootstrap=True, n_jobs=-1, random_state=42) - -bag_clf.fit(X_train, y_train) -y_pred = bag_clf.predict(X_test) -from sklearn.ensemble import RandomForestClassifier -rnd_clf = RandomForestClassifier(n_estimators=500, max_leaf_nodes=16, n_jobs=-1, random_state=42) -rnd_clf.fit(X_train, y_train) -y_pred_rf = rnd_clf.predict(X_test) -np.sum(y_pred == y_pred_rf) / len(y_pred) - -## Boosting, a Bird's Eye View - -The basic idea is to combine weak classifiers in order to create a good -classifier. With a weak classifier we often intend a classifier which -produces results which are only slightly better than we would get by -random guesses. - -This is done by applying in an iterative way a weak (or a standard -classifier like decision trees) to modify the data. In each iteration -we emphasize those observations which are misclassified by weighting -them with a factor. - - - -Boosting is a way of fitting an additive expansion in a set of -elementary basis functions like for example some simple polynomials. -Assume for example that we have a function - -$$ -f_M(x) = \sum_{i=1}^M \beta_m b(x;\gamma_m), -$$ - -where $\beta_m$ are the expansion parameters to be determined in a -minimization process and $b(x;\gamma_m)$ are some simple functions of -the multivariable parameter $x$ which is characterized by the -parameters $\gamma_m$. - -As an example, consider the Sigmoid function we used in logistic -regression. In that case, we can translate the function -$b(x;\gamma_m)$ into the Sigmoid function - -$$ -\sigma(t) = \frac{1}{1+\exp{(-t)}}, -$$ - -where $t=\gamma_0+\gamma_1 x$ and the parameters $\gamma_0$ and -$\gamma_1$ were determined by the Logistic Regression fitting -algorithm. - -As another example, consider the cost function we defined for linear regression - -$$ -C(\boldsymbol{y},\boldsymbol{f}) = \frac{1}{n} \sum_{i=0}^{n-1}(y_i-f(x_i))^2. -$$ - -In this case the function $f(x)$ was replaced by the design matrix -$\boldsymbol{X}$ and the unknown linear regression parameters $\boldsymbol{\beta}$, -that is $\boldsymbol{f}=\boldsymbol{X}\boldsymbol{\beta}$. In linear regression we can -simply invert a matrix and obtain the parameters $\beta$ by - -$$ -\boldsymbol{\beta}=\left(\boldsymbol{X}^T\boldsymbol{X}\right)^{-1}\boldsymbol{X}^T\boldsymbol{y}. -$$ - -In iterative fitting or additive modeling, we minimize the cost function with respect to the parameters $\beta_m$ and $\gamma_m$. - - -### Iterative Fitting, Regression and Squared-error Cost Function - -The way we proceed is as follows (here we specialize to the squared-error cost function) - -1. Establish a cost function, here $\cal{C}(\boldsymbol{y},\boldsymbol{f}) = \frac{1}{n} \sum_{i=0}^{n-1}(y_i-f_M(x_i))^2$ with $f_M(x) = \sum_{i=1}^M \beta_m b(x;\gamma_m)$. - -2. Initialize with a guess $f_0(x)$. It could be one or even zero or some random numbers. - -3. For $m=1:M$ - -a. minimize $\sum_{i=0}^{n-1}(y_i-f_{m-1}(x_i)-\beta b(x;\gamma))^2$ wrt $\gamma$ and $\beta$ - -b. This gives the optimal values $\beta_m$ and $\gamma_m$ - -c. Determine then the new values $f_m(x)=f_{m-1}(x) +\beta_m b(x;\gamma_m)$ - - -We could use any of the algorithms we have discussed till now. If we -use trees, $\gamma$ parameterizes the split variables and split points -at the internal nodes, and the predictions at the terminal nodes. - - - -To better understand what happens, let us develop the steps for the iterative fitting using the above squared error function. - -For simplicity we assume also that our functions $b(x;\gamma)=1+\gamma x$. - -This means that for every iteration $m$, we need to optimize - -$$ -(\beta_m,\gamma_m) = \mathrm{argmin}_{\beta,\lambda}\hspace{0.1cm} \sum_{i=0}^{n-1}(y_i-f_{m-1}(x_i)-\beta b(x;\gamma))^2=\sum_{i=0}^{n-1}(y_i-f_{m-1}(x_i)-\beta(1+\gamma x_i))^2. -$$ - -We start our iteration by simply setting $f_0(x)=0$. -Taking the derivatives with respect to $\beta$ and $\gamma$ we obtain - -$$ -\frac{\partial \cal{C}}{\partial \beta} = -2\sum_{i}(1+\gamma x_i)(y_i-\beta(1+\gamma x_i))=0, -$$ - -and - -$$ -\frac{\partial \cal{C}}{\partial \gamma} =-2\sum_{i}\beta x_i(y_i-\beta(1+\gamma x_i))=0. -$$ - -We can then rewrite these equations as (defining $\boldsymbol{w}=\boldsymbol{e}+\gamma \boldsymbol{x})$ with $\boldsymbol{e}$ being the unit vector) - -$$ -\gamma \boldsymbol{w}^T(\boldsymbol{y}-\beta\gamma \boldsymbol{w})=0, -$$ - -which gives us $\beta = \boldsymbol{w}^T\boldsymbol{y}/(\boldsymbol{w}^T\boldsymbol{w})$. Similarly we have - -$$ -\beta\gamma \boldsymbol{x}^T(\boldsymbol{y}-\beta(1+\gamma \boldsymbol{x}))=0, -$$ - -which leads to $\gamma =(\boldsymbol{x}^T\boldsymbol{y}-\beta\boldsymbol{x}^T\boldsymbol{e})/(\beta\boldsymbol{x}^T\boldsymbol{x})$. Inserting -for $\beta$ gives us an equation for $\gamma$. This is a non-linear equation in the unknown $\gamma$ and has to be solved numerically. - -The solution to these two equations gives us in turn $\beta_1$ and $\gamma_1$ leading to the new expression for $f_1(x)$ as -$f_1(x) = \beta_1(1+\gamma_1x)$. Doing this $M$ times results in our final estimate for the function $f$. - - - -### Iterative Fitting, Classification and AdaBoost - -Let us consider a binary classification problem with two outcomes $y_i \in \{-1,1\}$ and $i=0,1,2,\dots,n-1$ as our set of -observations. We define a classification function $G(x)$ which produces a prediction taking one or the other of the two values -$\{-1,1\}$. - -The error rate of the training sample is then - -$$ -\mathrm{\overline{err}}=\frac{1}{n} \sum_{i=0}^{n-1} I(y_i\ne G(x_i)). -$$ - -The iterative procedure starts with defining a weak classifier whose -error rate is barely better than random guessing. The iterative -procedure in boosting is to sequentially apply a weak -classification algorithm to repeatedly modified versions of the data -producing a sequence of weak classifiers $G_m(x)$. - -Here we will express our function $f(x)$ in terms of $G(x)$. That is - -$$ -f_M(x) = \sum_{i=1}^M \beta_m b(x;\gamma_m), -$$ - -will be a function of - -$$ -G_M(x) = \mathrm{sign} \sum_{i=1}^M \alpha_m G_m(x). -$$ - -In our iterative procedure we define thus - -$$ -f_m(x) = f_{m-1}(x)+\beta_mG_m(x). -$$ - -The simplest possible cost function which leads (also simple from a computational point of view) to the AdaBoost algorithm is the -exponential cost/loss function defined as - -$$ -C(\boldsymbol{y},\boldsymbol{f}) = \sum_{i=0}^{n-1}\exp{(-y_i(f_{m-1}(x_i)+\beta G(x_i))}. -$$ - -We optimize $\beta$ and $G$ for each value of $m=1:M$ as we did in the regression case. -This is normally done in two steps. Let us however first rewrite the cost function as - -$$ -C(\boldsymbol{y},\boldsymbol{f}) = \sum_{i=0}^{n-1}w_i^{m}\exp{(-y_i\beta G(x_i))}, -$$ - -where we have defined $w_i^m= \exp{(-y_if_{m-1}(x_i))}$. - - - -First, for any $\beta > 0$, we optimize $G$ by setting - -$$ -G_m(x) = \mathrm{sign} \sum_{i=0}^{n-1} w_i^m I(y_i \ne G_(x_i)), -$$ - -which is the classifier that minimizes the weighted error rate in predicting $y$. - -We can do this by rewriting - -$$ -\exp{-(\beta)}\sum_{y_i=G(x_i)}w_i^m+\exp{(\beta)}\sum_{y_i\ne G(x_i)}w_i^m, -$$ - -which can be rewritten as - -$$ -(\exp{(\beta)}-\exp{-(\beta)})\sum_{i=0}^{n-1}w_i^mI(y_i\ne G(x_i))+\exp{(-\beta)}\sum_{i=0}^{n-1}w_i^m=0, -$$ - -which leads to - -$$ -\beta_m = \frac{1}{2}\log{\frac{1-\mathrm{\overline{err}}}{\mathrm{\overline{err}}}}, -$$ - -where we have redefined the error as - -$$ -\mathrm{\overline{err}}_m=\frac{1}{n}\frac{\sum_{i=0}^{n-1}w_i^mI(y_i\ne G(x_i)}{\sum_{i=0}^{n-1}w_i^m}, -$$ - -which leads to an update of - -$$ -f_m(x) = f_{m-1}(x) +\beta_m G_m(x). -$$ - -This leads to the new weights - -$$ -w_i^{m+1} = w_i^m \exp{(-y_i\beta_m G_m(x_i))} -$$ - -### Adaptive boosting: AdaBoost, Basic Algorithm - -The algorithm here is rather straightforward. Assume that our weak -classifier is a decision tree and we consider a binary set of outputs -with $y_i \in \{-1,1\}$ and $i=0,1,2,\dots,n-1$ as our set of -observations. Our design matrix is given in terms of the -feature/predictor vectors -$\boldsymbol{X}=[\boldsymbol{x}_0\boldsymbol{x}_1\dots\boldsymbol{x}_{p-1}]$. Finally, we define also a -classifier determined by our data via a function $G(x)$. This function tells us how well we are able to classify our outputs/targets $\boldsymbol{y}$. - -We have already defined the misclassification error $\mathrm{err}$ as - -$$ -\mathrm{err}=\frac{1}{n}\sum_{i=0}^{n-1}I(y_i\ne G(x_i)), -$$ - -where the function $I()$ is one if we misclassify and zero if we classify correctly. - - -With the above definitions we are now ready to set up the algorithm for AdaBoost. -The basic idea is to set up weights which will be used to scale the correctly classified and the misclassified cases. -1. We start by initializing all weights to $w_i = 1/n$, with $i=0,1,2,\dots n-1$. It is easy to see that we must have $\sum_{i=0}^{n-1}w_i = 1$. - -2. We rewrite the misclassification error as - -$$ -\mathrm{\overline{err}}_m=\frac{\sum_{i=0}^{n-1}w_i^m I(y_i\ne G(x_i))}{\sum_{i=0}^{n-1}w_i}, -$$ - -1. Then we start looping over all attempts at classifying, namely we start an iterative process for $m=1:M$, where $M$ is the final number of classifications. Our given classifier could for example be a plain decision tree. - -a. Fit then a given classifier to the training set using the weights $w_i$. - -b. Compute then $\mathrm{err}$ and figure out which events are classified properly and which are classified wrongly. - -c. Define a quantity $\alpha_{m} = \log{(1-\mathrm{\overline{err}}_m)/\mathrm{\overline{err}}_m}$ - -d. Set the new weights to $w_i = w_i\times \exp{(\alpha_m I(y_i\ne G(x_i)}$. - - -5. Compute the new classifier $G(x)= \sum_{i=0}^{n-1}\alpha_m I(y_i\ne G(x_i)$. - -For the iterations with $m \le 2$ the weights are modified -individually at each steps. The observations which were misclassified -at iteration $m-1$ have a weight which is larger than those which were -classified properly. As this proceeds, the observations which were -difficult to classifiy correctly are given a larger influence. Each -new classification step $m$ is then forced to concentrate on those -observations that are missed in the previous iterations. - - - - -Using **Scikit-Learn** it is easy to apply the adaptive boosting algorithm, as done here. - -from sklearn.ensemble import AdaBoostClassifier - -ada_clf = AdaBoostClassifier( - DecisionTreeClassifier(max_depth=1), n_estimators=200, - algorithm="SAMME.R", learning_rate=0.5, random_state=42) -ada_clf.fit(X_train, y_train) - -from sklearn.ensemble import AdaBoostClassifier - -ada_clf = AdaBoostClassifier( - DecisionTreeClassifier(max_depth=1), n_estimators=200, - algorithm="SAMME.R", learning_rate=0.5, random_state=42) -ada_clf.fit(X_train_scaled, y_train) -y_pred = ada_clf.predict(X_test_scaled) -skplt.metrics.plot_confusion_matrix(y_test, y_pred, normalize=True) -plt.show() -y_probas = ada_clf.predict_proba(X_test_scaled) -skplt.metrics.plot_roc(y_test, y_probas) -plt.show() -skplt.metrics.plot_cumulative_gain(y_test, y_probas) -plt.show() - -## Gradient boosting: Basics with Steepest Descent/Functional Gradient Descent - -Gradient boosting is again a similar technique to Adaptive boosting, -it combines so-called weak classifiers or regressors into a strong -method via a series of iterations. - -In order to understand the method, let us illustrate its basics by -bringing back the essential steps in linear regression, where our cost -function was the least squares function. - - -We start again with our cost function $\cal{C}(\boldsymbol{y}m\boldsymbol{f})=\sum_{i=0}^{n-1}\cal{L}(y_i, f(x_i))$ where we want to minimize -This means that for every iteration, we need to optimize - -$$ -(\hat{\boldsymbol{f}}) = \mathrm{argmin}_{\boldsymbol{f}}\hspace{0.1cm} \sum_{i=0}^{n-1}(y_i-f(x_i))^2. -$$ - -We define a real function $h_m(x)$ that defines our final function $f_M(x)$ as - -$$ -f_M(x) = \sum_{m=0}^M h_m(x). -$$ - -In the steepest decent approach we approximate $h_m(x) = -\rho_m g_m(x)$, where $\rho_m$ is a scalar and $g_m(x)$ the gradient defined as - -$$ -g_m(x_i) = \left[ \frac{\partial \cal{L}(y_i, f(x_i))}{\partial f(x_i)}\right]_{f(x_i)=f_{m-1}(x_i)}. -$$ - -With the new gradient we can update $f_m(x) = f_{m-1}(x) -\rho_m g_m(x)$. Using the above squared-error function we see that -the gradient is $g_m(x_i) = -2(y_i-f(x_i))$. - -Choosing $f_0(x)=0$ we obtain $g_m(x) = -2y_i$ and inserting this into the minimization problem for the cost function we have - -$$ -(\rho_1) = \mathrm{argmin}_{\rho}\hspace{0.1cm} \sum_{i=0}^{n-1}(y_i+2\rho y_i)^2. -$$ - -Optimizing with respect to $\rho$ we obtain (taking the derivative) that $\rho_1 = -1/2$. We have then that - -$$ -f_1(x) = f_{0}(x) -\rho_1 g_1(x)=-y_i. -$$ - -We can then proceed and compute - -$$ -g_2(x_i) = \left[ \frac{\partial \cal{L}(y_i, f(x_i))}{\partial f(x_i)}\right]_{f(x_i)=f_{1}(x_i)=y_i}=-4y_i, -$$ - -and find a new value for $\rho_2=-1/2$ and continue till we have reached $m=M$. We can modify the steepest descent method, or steepest boosting, by introducing what is called **gradient boosting**. - - -Steepest descent is however not much used, since it only optimizes $f$ at a fixed set of $n$ points, -so we do not learn a function that can generalize. However, we can modify the algorithm by -fitting a weak learner to approximate the negative gradient signal. - -Suppose we have a cost function $C(f)=\sum_{i=0}^{n-1}L(y_i, f(x_i))$ where $y_i$ is our target and $f(x_i)$ the function which is meant to model $y_i$. The above cost function could be our standard squared-error function - -$$ -C(\boldsymbol{y},\boldsymbol{f})=\sum_{i=0}^{n-1}(y_i-f(x_i))^2. -$$ - -The way we proceed in an iterative fashion is to -1. Initialize our estimate $f_0(x)$. - -2. For $m=1:M$, we - -a. compute the negative gradient vector $\boldsymbol{u}_m = -\partial C(\boldsymbol{y},\boldsymbol{f})/\partial \boldsymbol{f}(x)$ at $f(x) = f_{m-1}(x)$; - -b. fit the so-called base-learner to the negative gradient $h_m(u_m,x)$; - -c. update the estimate $f_m(x) = f_{m-1}(x)+h_m(u_m,x)$; - - -4. The final estimate is then $f_M(x) = \sum_{m=1}^M h_m(u_m,x)$. - -## Gradient Boosting, Examples of Regression - -import matplotlib.pyplot as plt -import numpy as np -from sklearn.model_selection import train_test_split -from sklearn.ensemble import GradientBoostingRegressor -from sklearn.preprocessing import StandardScaler -import scikitplot as skplt -from sklearn.metrics import mean_squared_error - -n = 100 -maxdegree = 6 - -# Make data set. -x = np.linspace(-3, 3, n).reshape(-1, 1) -y = np.exp(-x**2) + 1.5 * np.exp(-(x-2)**2)+ np.random.normal(0, 0.1, x.shape) - -error = np.zeros(maxdegree) -bias = np.zeros(maxdegree) -variance = np.zeros(maxdegree) -polydegree = np.zeros(maxdegree) -X_train, X_test, y_train, y_test = train_test_split(x, y, test_size=0.2) -scaler = StandardScaler() -scaler.fit(X_train) -X_train_scaled = scaler.transform(X_train) -X_test_scaled = scaler.transform(X_test) - -for degree in range(1,maxdegree): - model = GradientBoostingRegressor(max_depth=degree, n_estimators=100, learning_rate=1.0) - model.fit(X_train_scaled,y_train) - y_pred = model.predict(X_test_scaled) - polydegree[degree] = degree - error[degree] = np.mean( np.mean((y_test - y_pred)**2) ) - bias[degree] = np.mean( (y_test - np.mean(y_pred))**2 ) - variance[degree] = np.mean( np.var(y_pred) ) - print('Max depth:', degree) - print('Error:', error[degree]) - print('Bias^2:', bias[degree]) - print('Var:', variance[degree]) - print('{} >= {} + {} = {}'.format(error[degree], bias[degree], variance[degree], bias[degree]+variance[degree])) - -plt.xlim(1,maxdegree-1) -plt.plot(polydegree, error, label='Error') -plt.plot(polydegree, bias, label='bias') -plt.plot(polydegree, variance, label='Variance') -plt.legend() -save_fig("gdregression") -plt.show() - -## Gradient Boosting, Classification Example - -import matplotlib.pyplot as plt -import numpy as np -from sklearn.model_selection import train_test_split -from sklearn.datasets import load_breast_cancer -import scikitplot as skplt -from sklearn.ensemble import GradientBoostingClassifier -from sklearn.model_selection import cross_validate - -# Load the data -cancer = load_breast_cancer() - -X_train, X_test, y_train, y_test = train_test_split(cancer.data,cancer.target,random_state=0) -print(X_train.shape) -print(X_test.shape) -#now scale the data -from sklearn.preprocessing import StandardScaler -scaler = StandardScaler() -scaler.fit(X_train) -X_train_scaled = scaler.transform(X_train) -X_test_scaled = scaler.transform(X_test) - -gd_clf = GradientBoostingClassifier(max_depth=3, n_estimators=100, learning_rate=1.0) -gd_clf.fit(X_train_scaled, y_train) -#Cross validation -accuracy = cross_validate(gd_clf,X_test_scaled,y_test,cv=10)['test_score'] -print(accuracy) -print("Test set accuracy with Random Forests and scaled data: {:.2f}".format(gd_clf.score(X_test_scaled,y_test))) - -import scikitplot as skplt -y_pred = gd_clf.predict(X_test_scaled) -skplt.metrics.plot_confusion_matrix(y_test, y_pred, normalize=True) -save_fig("gdclassiffierconfusion") -plt.show() -y_probas = gd_clf.predict_proba(X_test_scaled) -skplt.metrics.plot_roc(y_test, y_probas) -save_fig("gdclassiffierroc") -plt.show() -skplt.metrics.plot_cumulative_gain(y_test, y_probas) -save_fig("gdclassiffiercgain") -plt.show() - -## XGBoost: Extreme Gradient Boosting - - -[XGBoost](https://github.com/dmlc/xgboost) or Extreme Gradient -Boosting, is an optimized distributed gradient boosting library -designed to be highly efficient, flexible and portable. It implements -machine learning algorithms under the Gradient Boosting -framework. XGBoost provides a parallel tree boosting that solve many -data science problems in a fast and accurate way. See the [article by Chen and Guestrin](https://arxiv.org/abs/1603.02754). - -The authors design and build a highly scalable end-to-end tree -boosting system. It has a theoretically justified weighted quantile -sketch for efficient proposal calculation. It introduces a novel sparsity-aware algorithm for parallel tree learning and an effective cache-aware block structure for out-of-core tree learning. - -It is now the algorithm which wins essentially all ML competitions!!! - -## Regression Case - -import matplotlib.pyplot as plt -import numpy as np -from sklearn.model_selection import train_test_split -import xgboost as xgb -from sklearn.preprocessing import StandardScaler -import scikitplot as skplt -from sklearn.metrics import mean_squared_error - -n = 100 -maxdegree = 6 - -# Make data set. -x = np.linspace(-3, 3, n).reshape(-1, 1) -y = np.exp(-x**2) + 1.5 * np.exp(-(x-2)**2)+ np.random.normal(0, 0.1, x.shape) - -error = np.zeros(maxdegree) -bias = np.zeros(maxdegree) -variance = np.zeros(maxdegree) -polydegree = np.zeros(maxdegree) -X_train, X_test, y_train, y_test = train_test_split(x, y, test_size=0.2) -scaler = StandardScaler() -scaler.fit(X_train) -X_train_scaled = scaler.transform(X_train) -X_test_scaled = scaler.transform(X_test) - -for degree in range(maxdegree): - model = xgb.XGBRegressor(objective ='reg:squarederror', colsaobjective ='reg:squarederror', colsample_bytree = 0.3, learning_rate = 0.1,max_depth = degree, alpha = 10, n_estimators = 200) - - model.fit(X_train_scaled,y_train) - y_pred = model.predict(X_test_scaled) - polydegree[degree] = degree - error[degree] = np.mean( np.mean((y_test - y_pred)**2) ) - bias[degree] = np.mean( (y_test - np.mean(y_pred))**2 ) - variance[degree] = np.mean( np.var(y_pred) ) - print('Max depth:', degree) - print('Error:', error[degree]) - print('Bias^2:', bias[degree]) - print('Var:', variance[degree]) - print('{} >= {} + {} = {}'.format(error[degree], bias[degree], variance[degree], bias[degree]+variance[degree])) - -plt.xlim(1,maxdegree-1) -plt.plot(polydegree, error, label='Error') -plt.plot(polydegree, bias, label='bias') -plt.plot(polydegree, variance, label='Variance') -plt.legend() -plt.show() - -As you will see from the confusion matrix below, XGBoots does an excellent job on the Wisconsin cancer data and outperforms essentially all agorithms we have discussed till now. - - -import matplotlib.pyplot as plt -import numpy as np -from sklearn.model_selection import train_test_split -from sklearn.datasets import load_breast_cancer -from sklearn.preprocessing import LabelEncoder -from sklearn.model_selection import cross_validate -import scikitplot as skplt -import xgboost as xgb -# Load the data -cancer = load_breast_cancer() - -X_train, X_test, y_train, y_test = train_test_split(cancer.data,cancer.target,random_state=0) -print(X_train.shape) -print(X_test.shape) -#now scale the data -from sklearn.preprocessing import StandardScaler -scaler = StandardScaler() -scaler.fit(X_train) -X_train_scaled = scaler.transform(X_train) -X_test_scaled = scaler.transform(X_test) - -xg_clf = xgb.XGBClassifier() -xg_clf.fit(X_train_scaled,y_train) - -y_test = xg_clf.predict(X_test_scaled) - -print("Test set accuracy with Random Forests and scaled data: {:.2f}".format(xg_clf.score(X_test_scaled,y_test))) - -import scikitplot as skplt -y_pred = xg_clf.predict(X_test_scaled) -skplt.metrics.plot_confusion_matrix(y_test, y_pred, normalize=True) -save_fig("xdclassiffierconfusion") -plt.show() -y_probas = xg_clf.predict_proba(X_test_scaled) -skplt.metrics.plot_roc(y_test, y_probas) -save_fig("xdclassiffierroc") -plt.show() -skplt.metrics.plot_cumulative_gain(y_test, y_probas) -save_fig("gdclassiffiercgain") -plt.show() - - -xgb.plot_tree(xg_clf,num_trees=0) -plt.rcParams['figure.figsize'] = [50, 10] -save_fig("xgtree") -plt.show() - -xgb.plot_importance(xg_clf) -plt.rcParams['figure.figsize'] = [5, 5] -save_fig("xgparams") -plt.show() \ No newline at end of file diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter8.ipynb b/doc/LectureNotes/_build/jupyter_execute/chapter8.ipynb deleted file mode 100644 index 494a3222f..000000000 --- a/doc/LectureNotes/_build/jupyter_execute/chapter8.ipynb +++ /dev/null @@ -1,1734 +0,0 @@ -{ - "cells": [ - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "# Basic ideas of the Principal Component Analysis (PCA)\n", - "\n", - "The principal component analysis deals with the problem of fitting a\n", - "low-dimensional affine subspace $S$ of dimension $d$ much smaller than\n", - "the total dimension $D$ of the problem at hand (our data\n", - "set). Mathematically it can be formulated as a statistical problem or\n", - "a geometric problem. In our discussion of the theorem for the\n", - "classical PCA, we will stay with a statistical approach. \n", - "Historically, the PCA was first formulated in a statistical setting in order to estimate the principal component of a multivariate random variable.\n", - "\n", - "We have a data set defined by a design/feature matrix $\\boldsymbol{X}$ (see below for its definition) \n", - "* Each data point is determined by $p$ extrinsic (measurement) variables\n", - "\n", - "* We may want to ask the following question: Are there fewer intrinsic variables (say $d << p$) that still approximately describe the data?\n", - "\n", - "* If so, these intrinsic variables may tell us something important and finding these intrinsic variables is what dimension reduction methods do. \n", - "\n", - "A good read is for example [Vidal, Ma and Sastry](https://www.springer.com/gp/book/9780387878102).\n", - "\n", - "\n", - "\n", - "## Introducing the Covariance and Correlation functions\n", - "\n", - "Before we discuss the PCA theorem, we need to remind ourselves about\n", - "the definition of the covariance and the correlation function. These are quantities \n", - "\n", - "Suppose we have defined two vectors\n", - "$\\hat{x}$ and $\\hat{y}$ with $n$ elements each. The covariance matrix $\\boldsymbol{C}$ is defined as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{C}[\\boldsymbol{x},\\boldsymbol{y}] = \\begin{bmatrix} \\mathrm{cov}[\\boldsymbol{x},\\boldsymbol{x}] & \\mathrm{cov}[\\boldsymbol{x},\\boldsymbol{y}] \\\\\n", - " \\mathrm{cov}[\\boldsymbol{y},\\boldsymbol{x}] & \\mathrm{cov}[\\boldsymbol{y},\\boldsymbol{y}] \\\\\n", - " \\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where for example" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathrm{cov}[\\boldsymbol{x},\\boldsymbol{y}] =\\frac{1}{n} \\sum_{i=0}^{n-1}(x_i- \\overline{x})(y_i- \\overline{y}).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "With this definition and recalling that the variance is defined as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathrm{var}[\\boldsymbol{x}]=\\frac{1}{n} \\sum_{i=0}^{n-1}(x_i- \\overline{x})^2,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "we can rewrite the covariance matrix as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{C}[\\boldsymbol{x},\\boldsymbol{y}] = \\begin{bmatrix} \\mathrm{var}[\\boldsymbol{x}] & \\mathrm{cov}[\\boldsymbol{x},\\boldsymbol{y}] \\\\\n", - " \\mathrm{cov}[\\boldsymbol{x},\\boldsymbol{y}] & \\mathrm{var}[\\boldsymbol{y}] \\\\\n", - " \\end{bmatrix}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The covariance takes values between zero and infinity and may thus\n", - "lead to problems with loss of numerical precision for particularly\n", - "large values. It is common to scale the covariance matrix by\n", - "introducing instead the correlation matrix defined via the so-called\n", - "correlation function" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathrm{corr}[\\boldsymbol{x},\\boldsymbol{y}]=\\frac{\\mathrm{cov}[\\boldsymbol{x},\\boldsymbol{y}]}{\\sqrt{\\mathrm{var}[\\boldsymbol{x}] \\mathrm{var}[\\boldsymbol{y}]}}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The correlation function is then given by values $\\mathrm{corr}[\\boldsymbol{x},\\boldsymbol{y}]\n", - "\\in [-1,1]$. This avoids eventual problems with too large values. We\n", - "can then define the correlation matrix for the two vectors $\\boldsymbol{x}$\n", - "and $\\boldsymbol{y}$ as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{K}[\\boldsymbol{x},\\boldsymbol{y}] = \\begin{bmatrix} 1 & \\mathrm{corr}[\\boldsymbol{x},\\boldsymbol{y}] \\\\\n", - " \\mathrm{corr}[\\boldsymbol{y},\\boldsymbol{x}] & 1 \\\\\n", - " \\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In the above example this is the function we constructed using **pandas**.\n", - "\n", - "\n", - "In our derivation of the various regression algorithms like **Ordinary Least Squares** or **Ridge regression**\n", - "we defined the design/feature matrix $\\boldsymbol{X}$ as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}=\\begin{bmatrix}\n", - "x_{0,0} & x_{0,1} & x_{0,2}& \\dots & \\dots x_{0,p-1}\\\\\n", - "x_{1,0} & x_{1,1} & x_{1,2}& \\dots & \\dots x_{1,p-1}\\\\\n", - "x_{2,0} & x_{2,1} & x_{2,2}& \\dots & \\dots x_{2,p-1}\\\\\n", - "\\dots & \\dots & \\dots & \\dots \\dots & \\dots \\\\\n", - "x_{n-2,0} & x_{n-2,1} & x_{n-2,2}& \\dots & \\dots x_{n-2,p-1}\\\\\n", - "x_{n-1,0} & x_{n-1,1} & x_{n-1,2}& \\dots & \\dots x_{n-1,p-1}\\\\\n", - "\\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with $\\boldsymbol{X}\\in {\\mathbb{R}}^{n\\times p}$, with the predictors/features $p$ refering to the column numbers and the\n", - "entries $n$ being the row elements.\n", - "We can rewrite the design/feature matrix in terms of its column vectors as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}=\\begin{bmatrix} \\boldsymbol{x}_0 & \\boldsymbol{x}_1 & \\boldsymbol{x}_2 & \\dots & \\dots & \\boldsymbol{x}_{p-1}\\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with a given vector" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{x}_i^T = \\begin{bmatrix}x_{0,i} & x_{1,i} & x_{2,i}& \\dots & \\dots x_{n-1,i}\\end{bmatrix}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "With these definitions, we can now rewrite our $2\\times 2$\n", - "correaltion/covariance matrix in terms of a moe general design/feature\n", - "matrix $\\boldsymbol{X}\\in {\\mathbb{R}}^{n\\times p}$. This leads to a $p\\times p$\n", - "covariance matrix for the vectors $\\boldsymbol{x}_i$ with $i=0,1,\\dots,p-1$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{C}[\\boldsymbol{x}] = \\begin{bmatrix}\n", - "\\mathrm{var}[\\boldsymbol{x}_0] & \\mathrm{cov}[\\boldsymbol{x}_0,\\boldsymbol{x}_1] & \\mathrm{cov}[\\boldsymbol{x}_0,\\boldsymbol{x}_2] & \\dots & \\dots & \\mathrm{cov}[\\boldsymbol{x}_0,\\boldsymbol{x}_{p-1}]\\\\\n", - "\\mathrm{cov}[\\boldsymbol{x}_1,\\boldsymbol{x}_0] & \\mathrm{var}[\\boldsymbol{x}_1] & \\mathrm{cov}[\\boldsymbol{x}_1,\\boldsymbol{x}_2] & \\dots & \\dots & \\mathrm{cov}[\\boldsymbol{x}_1,\\boldsymbol{x}_{p-1}]\\\\\n", - "\\mathrm{cov}[\\boldsymbol{x}_2,\\boldsymbol{x}_0] & \\mathrm{cov}[\\boldsymbol{x}_2,\\boldsymbol{x}_1] & \\mathrm{var}[\\boldsymbol{x}_2] & \\dots & \\dots & \\mathrm{cov}[\\boldsymbol{x}_2,\\boldsymbol{x}_{p-1}]\\\\\n", - "\\dots & \\dots & \\dots & \\dots & \\dots & \\dots \\\\\n", - "\\dots & \\dots & \\dots & \\dots & \\dots & \\dots \\\\\n", - "\\mathrm{cov}[\\boldsymbol{x}_{p-1},\\boldsymbol{x}_0] & \\mathrm{cov}[\\boldsymbol{x}_{p-1},\\boldsymbol{x}_1] & \\mathrm{cov}[\\boldsymbol{x}_{p-1},\\boldsymbol{x}_{2}] & \\dots & \\dots & \\mathrm{var}[\\boldsymbol{x}_{p-1}]\\\\\n", - "\\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and the correlation matrix" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{K}[\\boldsymbol{x}] = \\begin{bmatrix}\n", - "1 & \\mathrm{corr}[\\boldsymbol{x}_0,\\boldsymbol{x}_1] & \\mathrm{corr}[\\boldsymbol{x}_0,\\boldsymbol{x}_2] & \\dots & \\dots & \\mathrm{corr}[\\boldsymbol{x}_0,\\boldsymbol{x}_{p-1}]\\\\\n", - "\\mathrm{corr}[\\boldsymbol{x}_1,\\boldsymbol{x}_0] & 1 & \\mathrm{corr}[\\boldsymbol{x}_1,\\boldsymbol{x}_2] & \\dots & \\dots & \\mathrm{corr}[\\boldsymbol{x}_1,\\boldsymbol{x}_{p-1}]\\\\\n", - "\\mathrm{corr}[\\boldsymbol{x}_2,\\boldsymbol{x}_0] & \\mathrm{corr}[\\boldsymbol{x}_2,\\boldsymbol{x}_1] & 1 & \\dots & \\dots & \\mathrm{corr}[\\boldsymbol{x}_2,\\boldsymbol{x}_{p-1}]\\\\\n", - "\\dots & \\dots & \\dots & \\dots & \\dots & \\dots \\\\\n", - "\\dots & \\dots & \\dots & \\dots & \\dots & \\dots \\\\\n", - "\\mathrm{corr}[\\boldsymbol{x}_{p-1},\\boldsymbol{x}_0] & \\mathrm{corr}[\\boldsymbol{x}_{p-1},\\boldsymbol{x}_1] & \\mathrm{corr}[\\boldsymbol{x}_{p-1},\\boldsymbol{x}_{2}] & \\dots & \\dots & 1\\\\\n", - "\\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The Numpy function **np.cov** calculates the covariance elements using\n", - "the factor $1/(n-1)$ instead of $1/n$ since it assumes we do not have\n", - "the exact mean values. The following simple function uses the\n", - "**np.vstack** function which takes each vector of dimension $1\\times n$\n", - "and produces a $2\\times n$ matrix $\\boldsymbol{W}$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{W} = \\begin{bmatrix} x_0 & y_0 \\\\\n", - " x_1 & y_1 \\\\\n", - " x_2 & y_2\\\\\n", - " \\dots & \\dots \\\\\n", - " x_{n-2} & y_{n-2}\\\\\n", - " x_{n-1} & y_{n-1} & \n", - " \\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which in turn is converted into into the $2\\times 2$ covariance matrix\n", - "$\\boldsymbol{C}$ via the Numpy function **np.cov()**. We note that we can also calculate\n", - "the mean value of each set of samples $\\boldsymbol{x}$ etc using the Numpy\n", - "function **np.mean(x)**. We can also extract the eigenvalues of the\n", - "covariance matrix through the **np.linalg.eig()** function." - ] - }, - { - "cell_type": "code", - "execution_count": 1, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "-0.13740265686642364\n", - "3.647867896223553\n", - "[[0.88732076 2.58645106]\n", - " [2.58645106 8.40379027]]\n" - ] - } - ], - "source": [ - "# Importing various packages\n", - "import numpy as np\n", - "n = 100\n", - "x = np.random.normal(size=n)\n", - "print(np.mean(x))\n", - "y = 4+3*x+np.random.normal(size=n)\n", - "print(np.mean(y))\n", - "W = np.vstack((x, y))\n", - "C = np.cov(W)\n", - "print(C)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Correlation Matrix\n", - "\n", - "The previous example can be converted into the correlation matrix by\n", - "simply scaling the matrix elements with the variances. We should also\n", - "subtract the mean values for each column. This leads to the following\n", - "code which sets up the correlations matrix for the previous example in\n", - "a more brute force way. Here we scale the mean values for each column of the design matrix, calculate the relevant mean values and variances and then finally set up the $2\\times 2$ correlation matrix (since we have only two vectors)." - ] - }, - { - "cell_type": "code", - "execution_count": 2, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "0.09282061240353208\n", - "2.0679953259809554\n", - "[[1. 0.65276752]\n", - " [0.65276752 1. ]]\n" - ] - } - ], - "source": [ - "import numpy as np\n", - "n = 100\n", - "# define two vectors \n", - "x = np.random.random(size=n)\n", - "y = 4+3*x+np.random.normal(size=n)\n", - "#scaling the x and y vectors \n", - "x = x - np.mean(x)\n", - "y = y - np.mean(y)\n", - "variance_x = np.sum(x@x)/n\n", - "variance_y = np.sum(y@y)/n\n", - "print(variance_x)\n", - "print(variance_y)\n", - "cov_xy = np.sum(x@y)/n\n", - "cov_xx = np.sum(x@x)/n\n", - "cov_yy = np.sum(y@y)/n\n", - "C = np.zeros((2,2))\n", - "C[0,0]= cov_xx/variance_x\n", - "C[1,1]= cov_yy/variance_y\n", - "C[0,1]= cov_xy/np.sqrt(variance_y*variance_x)\n", - "C[1,0]= C[0,1]\n", - "print(C)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We see that the matrix elements along the diagonal are one as they\n", - "should be and that the matrix is symmetric. Furthermore, diagonalizing\n", - "this matrix we easily see that it is a positive definite matrix.\n", - "\n", - "The above procedure with **numpy** can be made more compact if we use **pandas**.\n", - "\n", - "\n", - "We whow here how we can set up the correlation matrix using **pandas**, as done in this simple code" - ] - }, - { - "cell_type": "code", - "execution_count": 3, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "[[ 0.27416797 2.69235507]\n", - " [-0.30895532 -1.36796587]\n", - " [ 1.03285324 2.17106672]\n", - " [-0.35304998 -2.85655181]\n", - " [-0.79084976 -1.67951873]\n", - " [ 0.19247017 0.868215 ]\n", - " [-0.45745139 -2.25170803]\n", - " [-0.63165748 -1.85258411]\n", - " [-0.19636844 0.14649905]\n", - " [ 1.238841 4.13019269]]\n", - " 0 1\n", - "0 0.274168 2.692355\n", - "1 -0.308955 -1.367966\n", - "2 1.032853 2.171067\n", - "3 -0.353050 -2.856552\n", - "4 -0.790850 -1.679519\n", - "5 0.192470 0.868215\n", - "6 -0.457451 -2.251708\n", - "7 -0.631657 -1.852584\n", - "8 -0.196368 0.146499\n", - "9 1.238841 4.130193\n", - " 0 1\n", - "0 1.000000 0.899606\n", - "1 0.899606 1.000000\n" - ] - } - ], - "source": [ - "import numpy as np\n", - "import pandas as pd\n", - "n = 10\n", - "x = np.random.normal(size=n)\n", - "x = x - np.mean(x)\n", - "y = 4+3*x+np.random.normal(size=n)\n", - "y = y - np.mean(y)\n", - "X = (np.vstack((x, y))).T\n", - "print(X)\n", - "Xpd = pd.DataFrame(X)\n", - "print(Xpd)\n", - "correlation_matrix = Xpd.corr()\n", - "print(correlation_matrix)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We expand this model to the Franke function discussed above." - ] - }, - { - "cell_type": "code", - "execution_count": 4, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - " 0 1 2 3 4 5 6 7 \\\n", - "0 0.0 0.000000 0.000000 0.000000 0.000000 0.000000 0.000000 0.000000 \n", - "1 0.0 0.090368 0.089828 0.084745 0.089694 0.094385 0.072722 0.077607 \n", - "2 0.0 0.089828 0.091016 0.082203 0.087699 0.093293 0.069684 0.074647 \n", - "3 0.0 0.084745 0.082203 0.084433 0.088351 0.091653 0.075222 0.079774 \n", - "4 0.0 0.089694 0.087699 0.088351 0.092763 0.096661 0.078226 0.083104 \n", - "5 0.0 0.094385 0.093293 0.091653 0.096661 0.101332 0.080548 0.085760 \n", - "6 0.0 0.072722 0.069684 0.075222 0.078226 0.080548 0.068780 0.072668 \n", - "7 0.0 0.077607 0.074647 0.079774 0.083104 0.085760 0.072668 0.076854 \n", - "8 0.0 0.082726 0.079963 0.084408 0.088121 0.091191 0.076564 0.081069 \n", - "9 0.0 0.088020 0.085632 0.089011 0.093180 0.096774 0.080344 0.085192 \n", - "10 0.0 0.062054 0.059107 0.065855 0.068244 0.069993 0.061366 0.064683 \n", - "11 0.0 0.066283 0.063260 0.070074 0.072690 0.074644 0.065135 0.068701 \n", - "12 0.0 0.070793 0.067729 0.074516 0.077390 0.079587 0.069075 0.072910 \n", - "13 0.0 0.075587 0.072539 0.079162 0.082333 0.084822 0.073160 0.077286 \n", - "14 0.0 0.080656 0.077711 0.083974 0.087490 0.090338 0.077343 0.081784 \n", - "\n", - " 8 9 10 11 12 13 14 \n", - "0 0.000000 0.000000 0.000000 0.000000 0.000000 0.000000 0.000000 \n", - "1 0.082726 0.088020 0.062054 0.066283 0.070793 0.075587 0.080656 \n", - "2 0.079963 0.085632 0.059107 0.063260 0.067729 0.072539 0.077711 \n", - "3 0.084408 0.089011 0.065855 0.070074 0.074516 0.079162 0.083974 \n", - "4 0.088121 0.093180 0.068244 0.072690 0.077390 0.082333 0.087490 \n", - "5 0.091191 0.096774 0.069993 0.074644 0.079587 0.084822 0.090338 \n", - "6 0.076564 0.080344 0.061366 0.065135 0.069075 0.073160 0.077343 \n", - "7 0.081069 0.085192 0.064683 0.068701 0.072910 0.077286 0.081784 \n", - "8 0.085636 0.090149 0.067977 0.072252 0.076743 0.081428 0.086266 \n", - "9 0.090149 0.095107 0.071137 0.075674 0.080455 0.085465 0.090671 \n", - "10 0.067977 0.071137 0.055542 0.058856 0.062305 0.065864 0.069488 \n", - "11 0.072252 0.075674 0.058856 0.062396 0.066086 0.069899 0.073789 \n", - "12 0.076743 0.080455 0.062305 0.066086 0.070032 0.074118 0.078298 \n", - "13 0.081428 0.085465 0.065864 0.069899 0.074118 0.078497 0.082989 \n", - "14 0.086266 0.090671 0.069488 0.073789 0.078298 0.082989 0.087822 \n" - ] - } - ], - "source": [ - "# Common imports\n", - "import numpy as np\n", - "import pandas as pd\n", - "\n", - "\n", - "def FrankeFunction(x,y):\n", - "\tterm1 = 0.75*np.exp(-(0.25*(9*x-2)**2) - 0.25*((9*y-2)**2))\n", - "\tterm2 = 0.75*np.exp(-((9*x+1)**2)/49.0 - 0.1*(9*y+1))\n", - "\tterm3 = 0.5*np.exp(-(9*x-7)**2/4.0 - 0.25*((9*y-3)**2))\n", - "\tterm4 = -0.2*np.exp(-(9*x-4)**2 - (9*y-7)**2)\n", - "\treturn term1 + term2 + term3 + term4\n", - "\n", - "\n", - "def create_X(x, y, n ):\n", - "\tif len(x.shape) > 1:\n", - "\t\tx = np.ravel(x)\n", - "\t\ty = np.ravel(y)\n", - "\n", - "\tN = len(x)\n", - "\tl = int((n+1)*(n+2)/2)\t\t# Number of elements in beta\n", - "\tX = np.ones((N,l))\n", - "\n", - "\tfor i in range(1,n+1):\n", - "\t\tq = int((i)*(i+1)/2)\n", - "\t\tfor k in range(i+1):\n", - "\t\t\tX[:,q+k] = (x**(i-k))*(y**k)\n", - "\n", - "\treturn X\n", - "\n", - "\n", - "# Making meshgrid of datapoints and compute Franke's function\n", - "n = 4\n", - "N = 100\n", - "x = np.sort(np.random.uniform(0, 1, N))\n", - "y = np.sort(np.random.uniform(0, 1, N))\n", - "z = FrankeFunction(x, y)\n", - "X = create_X(x, y, n=n) \n", - "\n", - "Xpd = pd.DataFrame(X)\n", - "# subtract the mean values and set up the covariance matrix\n", - "Xpd = Xpd - Xpd.mean()\n", - "covariance_matrix = Xpd.cov()\n", - "print(covariance_matrix)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We note here that the covariance is zero for the first rows and\n", - "columns since all matrix elements in the design matrix were set to one\n", - "(we are fitting the function in terms of a polynomial of degree $n$). We would however not include the intercept\n", - "and wee can simply\n", - "drop these elements and construct a correlation\n", - "matrix without them. \n", - "\n", - "\n", - "\n", - "We can rewrite the covariance matrix in a more compact form in terms of the design/feature matrix $\\boldsymbol{X}$ as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{C}[\\boldsymbol{x}] = \\frac{1}{n}\\boldsymbol{X}^T\\boldsymbol{X}= \\mathbb{E}[\\boldsymbol{X}^T\\boldsymbol{X}].\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "To see this let us simply look at a design matrix $\\boldsymbol{X}\\in {\\mathbb{R}}^{2\\times 2}$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}=\\begin{bmatrix}\n", - "x_{00} & x_{01}\\\\\n", - "x_{10} & x_{11}\\\\\n", - "\\end{bmatrix}=\\begin{bmatrix}\n", - "\\boldsymbol{x}_{0} & \\boldsymbol{x}_{1}\\\\\n", - "\\end{bmatrix}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "If we then compute the expectation value" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbb{E}[\\boldsymbol{X}^T\\boldsymbol{X}] = \\frac{1}{n}\\boldsymbol{X}^T\\boldsymbol{X}=\\begin{bmatrix}\n", - "x_{00}^2+x_{01}^2 & x_{00}x_{10}+x_{01}x_{11}\\\\\n", - "x_{10}x_{00}+x_{11}x_{01} & x_{10}^2+x_{11}^2\\\\\n", - "\\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which is just" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{C}[\\boldsymbol{x}_0,\\boldsymbol{x}_1] = \\boldsymbol{C}[\\boldsymbol{x}]=\\begin{bmatrix} \\mathrm{var}[\\boldsymbol{x}_0] & \\mathrm{cov}[\\boldsymbol{x}_0,\\boldsymbol{x}_1] \\\\\n", - " \\mathrm{cov}[\\boldsymbol{x}_1,\\boldsymbol{x}_0] & \\mathrm{var}[\\boldsymbol{x}_1] \\\\\n", - " \\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where we wrote $$\\boldsymbol{C}[\\boldsymbol{x}_0,\\boldsymbol{x}_1] = \\boldsymbol{C}[\\boldsymbol{x}]$$ to indicate that this the covariance of the vectors $\\boldsymbol{x}$ of the design/feature matrix $\\boldsymbol{X}$.\n", - "\n", - "It is easy to generalize this to a matrix $\\boldsymbol{X}\\in {\\mathbb{R}}^{n\\times p}$.\n", - "\n", - "\n", - "\n", - "## Towards the PCA theorem\n", - "\n", - "We have that the covariance matrix (the correlation matrix involves a simple rescaling) is given as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{C}[\\boldsymbol{x}] = \\frac{1}{n}\\boldsymbol{X}^T\\boldsymbol{X}= \\mathbb{E}[\\boldsymbol{X}^T\\boldsymbol{X}].\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Let us now assume that we can perform a series of orthogonal transformations where we employ some orthogonal matrices $\\boldsymbol{S}$.\n", - "These matrices are defined as $\\boldsymbol{S}\\in {\\mathbb{R}}^{p\\times p}$ and obey the orthogonality requirements $\\boldsymbol{S}\\boldsymbol{S}^T=\\boldsymbol{S}^T\\boldsymbol{S}=\\boldsymbol{I}$. The matrix can be written out in terms of the column vectors $\\boldsymbol{s}_i$ as $\\boldsymbol{S}=[\\boldsymbol{s}_0,\\boldsymbol{s}_1,\\dots,\\boldsymbol{s}_{p-1}]$ and $\\boldsymbol{s}_i \\in {\\mathbb{R}}^{p}$.\n", - "\n", - "Assume also that there is a transformation $\\boldsymbol{S}^T\\boldsymbol{C}[\\boldsymbol{x}]\\boldsymbol{S}=\\boldsymbol{C}[\\boldsymbol{y}]$ such that the new matrix $\\boldsymbol{C}[\\boldsymbol{y}]$ is diagonal with elements $[\\lambda_0,\\lambda_1,\\lambda_2,\\dots,\\lambda_{p-1}]$. \n", - "\n", - "That is we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{C}[\\boldsymbol{y}] = \\mathbb{E}[\\boldsymbol{S}^T\\boldsymbol{X}^T\\boldsymbol{X}T\\boldsymbol{S}]=\\boldsymbol{S}^T\\boldsymbol{C}[\\boldsymbol{x}]\\boldsymbol{S},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "since the matrix $\\boldsymbol{S}$ is not a data dependent matrix. Multiplying with $\\boldsymbol{S}$ from the left we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{S}\\boldsymbol{C}[\\boldsymbol{y}] = \\boldsymbol{C}[\\boldsymbol{x}]\\boldsymbol{S},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and since $\\boldsymbol{C}[\\boldsymbol{y}]$ is diagonal we have for a given eigenvalue $i$ of the covariance matrix that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{S}_i\\lambda_i = \\boldsymbol{C}[\\boldsymbol{x}]\\boldsymbol{S}_i.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In the derivation of the PCA theorem we will assume that the eigenvalues are ordered in descending order, that is\n", - "$\\lambda_0 > \\lambda_1 > \\dots > \\lambda_{p-1}$. \n", - "\n", - "\n", - "The eigenvalues tell us then how much we need to stretch the\n", - "corresponding eigenvectors. Dimensions with large eigenvalues have\n", - "thus large variations (large variance) and define therefore useful\n", - "dimensions. The data points are more spread out in the direction of\n", - "these eigenvectors. Smaller eigenvalues mean on the other hand that\n", - "the corresponding eigenvectors are shrunk accordingly and the data\n", - "points are tightly bunched together and there is not much variation in\n", - "these specific directions. Hopefully then we could leave it out\n", - "dimensions where the eigenvalues are very small. If $p$ is very large,\n", - "we could then aim at reducing $p$ to $l << p$ and handle only $l$\n", - "features/predictors.\n", - "\n", - "### The Algorithm before theorem\n", - "\n", - "Here's how we would proceed in setting up the algorithm for the PCA, see also discussion below here. \n", - "* Set up the datapoints for the design/feature matrix $\\boldsymbol{X}$ with $\\boldsymbol{X}\\in {\\mathbb{R}}^{n\\times p}$, with the predictors/features $p$ referring to the column numbers and the entries $n$ being the row elements." - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}=\\begin{bmatrix}\n", - "x_{0,0} & x_{0,1} & x_{0,2}& \\dots & \\dots x_{0,p-1}\\\\\n", - "x_{1,0} & x_{1,1} & x_{1,2}& \\dots & \\dots x_{1,p-1}\\\\\n", - "x_{2,0} & x_{2,1} & x_{2,2}& \\dots & \\dots x_{2,p-1}\\\\\n", - "\\dots & \\dots & \\dots & \\dots \\dots & \\dots \\\\\n", - "x_{n-2,0} & x_{n-2,1} & x_{n-2,2}& \\dots & \\dots x_{n-2,p-1}\\\\\n", - "x_{n-1,0} & x_{n-1,1} & x_{n-1,2}& \\dots & \\dots x_{n-1,p-1}\\\\\n", - "\\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "* Center the data by subtracting the mean value for each column. This leads to a new matrix $\\boldsymbol{X}\\rightarrow \\overline{\\boldsymbol{X}}$.\n", - "\n", - "* Compute then the covariance/correlation matrix $\\mathbb{E}[\\overline{\\boldsymbol{X}}^T\\overline{\\boldsymbol{X}}]$.\n", - "\n", - "* Find the eigenpairs of $\\boldsymbol{C}$ with eigenvalues $[\\lambda_0,\\lambda_1,\\dots,\\lambda_{p-1}]$ and eigenvectors $[\\boldsymbol{s}_0,\\boldsymbol{s}_1,\\dots,\\boldsymbol{s}_{p-1}]$.\n", - "\n", - "* Order the eigenvalue (and the eigenvectors accordingly) in order of decreasing eigenvalues.\n", - "\n", - "* Keep only those $l$ eigenvalues larger than a selected threshold value, discarding thus $p-l$ features since we expect small variations in the data here.\n", - "\n", - "### Writing our own PCA code\n", - "\n", - "We will use a simple example first with two-dimensional data\n", - "drawn from a multivariate normal distribution with the following mean and covariance matrix (we have fixed these quantities but will play around with them below):" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mu = (-1,2) \\qquad \\Sigma = \\begin{bmatrix} 4 & 2 \\\\\n", - "2 & 2\n", - "\\end{bmatrix}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Note that the mean refers to each column of data. \n", - "We will generate $n = 10000$ points $X = \\{ x_1, \\ldots, x_N \\}$ from\n", - "this distribution, and store them in the $1000 \\times 2$ matrix $\\boldsymbol{X}$. This is our design matrix where we have forced the covariance and mean values to take specific values.\n", - "\n", - "The following Python code aids in setting up the data and writing out the design matrix.\n", - "Note that the function **multivariate** returns also the covariance discussed above and that it is defined by dividing by $n-1$ instead of $n$." - ] - }, - { - "cell_type": "code", - "execution_count": 5, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "%matplotlib inline\n", - "\n", - "import numpy as np\n", - "import pandas as pd\n", - "import matplotlib.pyplot as plt\n", - "from IPython.display import display\n", - "n = 10000\n", - "mean = (-1, 2)\n", - "cov = [[4, 2], [2, 2]]\n", - "X = np.random.multivariate_normal(mean, cov, n)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Now we are going to implement the PCA algorithm. We will break it down into various substeps.\n", - "\n", - "\n", - "The first step of PCA is to compute the sample mean of the data and use it to center the data. Recall that the sample mean is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mu_n = \\frac{1}{n} \\sum_{i=1}^n x_i\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and the mean-centered data $\\bar{X} = \\{ \\bar{x}_1, \\ldots, \\bar{x}_n \\}$ takes the form" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\bar{x}_i = x_i - \\mu_n.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "When you are done with these steps, print out $\\mu_n$ to verify it is\n", - "close to $\\mu$ and plot your mean centered data to verify it is\n", - "centered at the origin! \n", - "The following code elements perform these operations using **pandas** or using our own functionality for doing so. The latter, using **numpy** is rather simple through the **mean()** function." - ] - }, - { - "cell_type": "code", - "execution_count": 6, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "df = pd.DataFrame(X)\n", - "# Pandas does the centering for us\n", - "df = df -df.mean()\n", - "# we center it ourselves\n", - "X_centered = X - X.mean(axis=0)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Alternatively, we could use the functions we discussed\n", - "earlier for scaling the data set. That is, we could have used the\n", - "**StandardScaler** function in **Scikit-Learn**, a function which ensures\n", - "that for each feature/predictor we study the mean value is zero and\n", - "the variance is one (every column in the design/feature matrix). You\n", - "would then not get the same results, since we divide by the\n", - "variance. The diagonal covariance matrix elements will then be one,\n", - "while the non-diagonal ones need to be divided by $2\\sqrt{2}$ for our\n", - "specific case.\n", - "\n", - "\n", - "Now we are going to use the mean centered data to compute the sample covariance of the data by using the following equation" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\Sigma_n = \\frac{1}{n-1} \\sum_{i=1}^n \\bar{x}_i^T \\bar{x}_i = \\frac{1}{n-1} \\sum_{i=1}^n (x_i - \\mu_n)^T (x_i - \\mu_n)\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where the data points $x_i \\in \\mathbb{R}^p$ (here in this example $p = 2$) are column vectors and $x^T$ is the transpose of $x$.\n", - "We can write our own code or simply use either the functionaly of **numpy** or that of **pandas**, as follows" - ] - }, - { - "cell_type": "code", - "execution_count": 7, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - " 0 1\n", - "0 3.900266 1.942180\n", - "1 1.942180 1.965724\n", - "[[3.90026646 1.9421795 ]\n", - " [1.9421795 1.96572363]]\n" - ] - } - ], - "source": [ - "print(df.cov())\n", - "print(np.cov(X_centered.T))" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Note that the way we define the covariance matrix here has a factor $n-1$ instead of $n$. This is included in the **cov()** function by **numpy** and **pandas**. \n", - "Our own code here is not very elegant and asks for obvious improvements. It is tailored to this specific $2\\times 2$ covariance matrix." - ] - }, - { - "cell_type": "code", - "execution_count": 8, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Centered covariance using own code\n", - "[[3.90026646 1.9421795 ]\n", - " [1.9421795 1.96572363]]\n" - ] - }, - { - "data": { - "image/png": "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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter8_65_1.png" - }, - "needs_background": "light" - }, - "output_type": "display_data" - } - ], - "source": [ - "# extract the relevant columns from the centered design matrix of dim n x 2\n", - "x = X_centered[:,0]\n", - "y = X_centered[:,1]\n", - "Cov = np.zeros((2,2))\n", - "Cov[0,1] = np.sum(x.T@y)/(n-1.0)\n", - "Cov[0,0] = np.sum(x.T@x)/(n-1.0)\n", - "Cov[1,1] = np.sum(y.T@y)/(n-1.0)\n", - "Cov[1,0]= Cov[0,1]\n", - "print(\"Centered covariance using own code\")\n", - "print(Cov)\n", - "plt.plot(x, y, 'x')\n", - "plt.axis('equal')\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Depending on the number of points $n$, we will get results that are close to the covariance values defined above.\n", - "The plot shows how the data are clustered around a line with slope close to one. Is this expected? Try to change the covariance and the mean values. For example, try to make the variance of the first element much larger than that of the second diagonal element. Try also to shrink the covariance (the non-diagonal elements) and see how the data points are distributed. \n", - "\n", - "### Diagonalize the sample covariance matrix to obtain the principal components\n", - "\n", - "Now we are ready to solve for the principal components! To do so we\n", - "diagonalize the sample covariance matrix $\\Sigma$. We can use the\n", - "function **np.linalg.eig** to do so. It will return the eigenvalues and\n", - "eigenvectors of $\\Sigma$. Once we have these we can perform the \n", - "following tasks:\n", - "\n", - "* We compute the percentage of the total variance captured by the first principal component\n", - "\n", - "* We plot the mean centered data and lines along the first and second principal components\n", - "\n", - "* Then we project the mean centered data onto the first and second principal components, and plot the projected data. \n", - "\n", - "* Finally, we approximate the data as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "x_i \\approx \\tilde{x}_i = \\mu_n + \\langle x_i, v_0 \\rangle v_0\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $v_0$ is the first principal component. \n", - "\n", - "Collecting all these steps we can write our own PCA function and\n", - "compare this with the functionality included in **Scikit-Learn**. \n", - "\n", - "The code here outlines some of the elements we could include in the\n", - "analysis. Feel free to extend upon this in order to address the above\n", - "questions." - ] - }, - { - "cell_type": "code", - "execution_count": 9, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Eigenvalues of Covariance matrix\n", - "5.102712819944882\n", - "0.763277270613554\n", - "First eigenvector\n", - "[0.85023678 0.52640043]\n", - "Second eigenvector\n", - "[-0.52640043 0.85023678]\n" - ] - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Eigenvector of largest eigenvalue\n", - "[-0.85023678 -0.52640043]\n" - ] - } - ], - "source": [ - "# diagonalize and obtain eigenvalues, not necessarily sorted\n", - "EigValues, EigVectors = np.linalg.eig(Cov)\n", - "# sort eigenvectors and eigenvalues\n", - "#permute = EigValues.argsort()\n", - "#EigValues = EigValues[permute]\n", - "#EigVectors = EigVectors[:,permute]\n", - "print(\"Eigenvalues of Covariance matrix\")\n", - "for i in range(2):\n", - " print(EigValues[i])\n", - "FirstEigvector = EigVectors[:,0]\n", - "SecondEigvector = EigVectors[:,1]\n", - "print(\"First eigenvector\")\n", - "print(FirstEigvector)\n", - "print(\"Second eigenvector\")\n", - "print(SecondEigvector)\n", - "#thereafter we do a PCA with Scikit-learn\n", - "from sklearn.decomposition import PCA\n", - "pca = PCA(n_components = 2)\n", - "X2Dsl = pca.fit_transform(X)\n", - "print(\"Eigenvector of largest eigenvalue\")\n", - "print(pca.components_.T[:, 0])" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "This code does not contain all the above elements, but it shows how we can use **Scikit-Learn** to extract the eigenvector which corresponds to the largest eigenvalue. Try to address the questions we pose before the above code. Try also to change the values of the covariance matrix by making one of the diagonal elements much larger than the other. What do you observe then? \n", - "\n", - "\n", - "## Classical PCA Theorem\n", - "\n", - "We assume now that we have a design matrix $\\boldsymbol{X}$ which has been\n", - "centered as discussed above. For the sake of simplicity we skip the\n", - "overline symbol. The matrix is defined in terms of the various column\n", - "vectors $[\\boldsymbol{x}_0,\\boldsymbol{x}_1,\\dots, \\boldsymbol{x}_{p-1}]$ each with dimension\n", - "$\\boldsymbol{x}\\in {\\mathbb{R}}^{n}$.\n", - "\n", - "\n", - "\n", - "The PCA theorem states that minimizing the above reconstruction error\n", - "corresponds to setting $\\boldsymbol{W}=\\boldsymbol{S}$, the orthogonal matrix which\n", - "diagonalizes the empirical covariance(correlation) matrix. The optimal\n", - "low-dimensional encoding of the data is then given by a set of vectors\n", - "$\\boldsymbol{z}_i$ with at most $l$ vectors, with $l << p$, defined by the\n", - "orthogonal projection of the data onto the columns spanned by the\n", - "eigenvectors of the covariance(correlations matrix).\n", - "\n", - "\n", - "\n", - "\n", - "To show the PCA theorem let us start with the assumption that there is one vector $\\boldsymbol{s}_0$ which corresponds to a solution which minimized the reconstruction error $J$. This is an orthogonal vector. It means that we now approximate the reconstruction error in terms of $\\boldsymbol{w}_0$ and $\\boldsymbol{z}_0$ as\n", - "\n", - "\n", - "\n", - "We are almost there, we have obtained a relation between minimizing\n", - "the reconstruction error and the variance and the covariance\n", - "matrix. Minimizing the error is equivalent to maximizing the variance\n", - "of the projected data.\n", - "\n", - "\n", - "We could trivially maximize the variance of the projection (and\n", - "thereby minimize the error in the reconstruction function) by letting\n", - "the norm-2 of $\\boldsymbol{w}_0$ go to infinity. However, this norm since we\n", - "want the matrix $\\boldsymbol{W}$ to be an orthogonal matrix, is constrained by\n", - "$\\vert\\vert \\boldsymbol{w}_0 \\vert\\vert_2^2=1$. Imposing this condition via a\n", - "Lagrange multiplier we can then in turn maximize" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "J(\\boldsymbol{w}_0)= \\boldsymbol{w}_0^T\\boldsymbol{C}[\\boldsymbol{x}]\\boldsymbol{w}_0+\\lambda_0(1-\\boldsymbol{w}_0^T\\boldsymbol{w}_0).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Taking the derivative with respect to $\\boldsymbol{w}_0$ we obtain" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial J(\\boldsymbol{w}_0)}{\\partial \\boldsymbol{w}_0}= 2\\boldsymbol{C}[\\boldsymbol{x}]\\boldsymbol{w}_0-2\\lambda_0\\boldsymbol{w}_0=0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "meaning that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{C}[\\boldsymbol{x}]\\boldsymbol{w}_0=\\lambda_0\\boldsymbol{w}_0.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "**The direction that maximizes the variance (or minimizes the construction error) is an eigenvector of the covariance matrix**! If we left multiply with $\\boldsymbol{w}_0^T$ we have the variance of the projected data is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{w}_0^T\\boldsymbol{C}[\\boldsymbol{x}]\\boldsymbol{w}_0=\\lambda_0.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "If we want to maximize the variance (minimize the construction error)\n", - "we simply pick the eigenvector of the covariance matrix with the\n", - "largest eigenvalue. This establishes the link between the minimization\n", - "of the reconstruction function $J$ in terms of an orthogonal matrix\n", - "and the maximization of the variance and thereby the covariance of our\n", - "observations encoded in the design/feature matrix $\\boldsymbol{X}$.\n", - "\n", - "The proof\n", - "for the other eigenvectors $\\boldsymbol{w}_1,\\boldsymbol{w}_2,\\dots$ can be\n", - "established by applying the above arguments and using the fact that\n", - "our basis of eigenvectors is orthogonal, see [Murphy chapter\n", - "12.2](https://mitpress.mit.edu/books/machine-learning-1). The\n", - "discussion in chapter 12.2 of Murphy's text has also a nice link with\n", - "the Singular Value Decomposition theorem. For categorical data, see\n", - "chapter 12.4 and discussion therein.\n", - "\n", - "For more details, see for example [Vidal, Ma and Sastry, chapter 2](https://www.springer.com/gp/book/9780387878102).\n", - "\n", - "\n", - "## Geometric Interpretation and link with Singular Value Decomposition\n", - "\n", - "For a detailed demonstration of the geometric interpretation, see [Vidal, Ma and Sastry, section 2.1.2](https://www.springer.com/gp/book/9780387878102).\n", - "\n", - "\n", - "Principal Component Analysis (PCA) is by far the most popular dimensionality reduction algorithm.\n", - "First it identifies the hyperplane that lies closest to the data, and then it projects the data onto it.\n", - "\n", - "The following Python code uses NumPy’s **svd()** function to obtain all the principal components of the\n", - "training set, then extracts the first two principal components. First we center the data using either **pandas** or our own code" - ] - }, - { - "cell_type": "code", - "execution_count": 10, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "data": { - "text/html": [ - "
\n", - "\n", - "\n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - "
01234
0-1.5744650.2591531.1973700.1474000.649382
10.6895190.137652-1.0257090.210340-0.076938
2-0.2827270.351636-0.5392611.2166830.340782
30.070889-0.6148081.074067-0.038300-1.450257
41.7942821.458078-0.207545-0.442600-0.147420
51.1123830.6474731.4058900.073598-0.276263
60.397700-1.526744-0.7120181.2162900.418506
7-0.2806471.106095-1.646283-0.956563-1.564374
8-0.369139-0.7516990.051649-0.2131030.967809
9-1.557795-1.0668370.401842-1.2137431.138775
\n", - "
" - ], - "text/plain": [ - " 0 1 2 3 4\n", - "0 -1.574465 0.259153 1.197370 0.147400 0.649382\n", - "1 0.689519 0.137652 -1.025709 0.210340 -0.076938\n", - "2 -0.282727 0.351636 -0.539261 1.216683 0.340782\n", - "3 0.070889 -0.614808 1.074067 -0.038300 -1.450257\n", - "4 1.794282 1.458078 -0.207545 -0.442600 -0.147420\n", - "5 1.112383 0.647473 1.405890 0.073598 -0.276263\n", - "6 0.397700 -1.526744 -0.712018 1.216290 0.418506\n", - "7 -0.280647 1.106095 -1.646283 -0.956563 -1.564374\n", - "8 -0.369139 -0.751699 0.051649 -0.213103 0.967809\n", - "9 -1.557795 -1.066837 0.401842 -1.213743 1.138775" - ] - }, - "metadata": {}, - "output_type": "display_data" - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - " 0 1 2 3 4\n", - "0 0.0 0.0 0.0 0.0 0.0\n", - "1 0.0 0.0 0.0 0.0 0.0\n", - "2 0.0 0.0 0.0 0.0 0.0\n", - "3 0.0 0.0 0.0 0.0 0.0\n", - "4 0.0 0.0 0.0 0.0 0.0\n", - "5 0.0 0.0 0.0 0.0 0.0\n", - "6 0.0 0.0 0.0 0.0 0.0\n", - "7 0.0 0.0 0.0 0.0 0.0\n", - "8 0.0 0.0 0.0 0.0 0.0\n", - "9 0.0 0.0 0.0 0.0 0.0\n", - "[[-1.5378811 -0.94639099]\n", - " [ 0.86145244 0.89288636]\n", - " [-0.00445655 0.81633628]\n", - " [ 0.07145103 -1.00433417]\n", - " [ 2.03707133 -0.48476997]\n", - " [ 0.72174172 -1.4557763 ]\n", - " [-0.55854694 1.60673226]\n", - " [ 1.6999536 0.43766686]\n", - " [-1.10405456 0.31718909]\n", - " [-2.18673098 -0.17953942]]\n" - ] - } - ], - "source": [ - "import numpy as np\n", - "import pandas as pd\n", - "from IPython.display import display\n", - "np.random.seed(100)\n", - "# setting up a 10 x 5 vanilla matrix \n", - "rows = 10\n", - "cols = 5\n", - "X = np.random.randn(rows,cols)\n", - "df = pd.DataFrame(X)\n", - "# Pandas does the centering for us\n", - "df = df -df.mean()\n", - "display(df)\n", - "\n", - "# we center it ourselves\n", - "X_centered = X - X.mean(axis=0)\n", - "# Then check the difference between pandas and our own set up\n", - "print(X_centered-df)\n", - "#Now we do an SVD\n", - "U, s, V = np.linalg.svd(X_centered)\n", - "c1 = V.T[:, 0]\n", - "c2 = V.T[:, 1]\n", - "W2 = V.T[:, :2]\n", - "X2D = X_centered.dot(W2)\n", - "print(X2D)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "PCA assumes that the dataset is centered around the origin. Scikit-Learn’s PCA classes take care of centering\n", - "the data for you. However, if you implement PCA yourself (as in the preceding example), or if you use other libraries, don’t\n", - "forget to center the data first.\n", - "\n", - "Once you have identified all the principal components, you can reduce the dimensionality of the dataset\n", - "down to $d$ dimensions by projecting it onto the hyperplane defined by the first $d$ principal components.\n", - "Selecting this hyperplane ensures that the projection will preserve as much variance as possible." - ] - }, - { - "cell_type": "code", - "execution_count": 11, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "W2 = V.T[:, :2]\n", - "X2D = X_centered.dot(W2)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## PCA and scikit-learn\n", - "\n", - "Scikit-Learn’s PCA class implements PCA using SVD decomposition just like we did before. The\n", - "following code applies PCA to reduce the dimensionality of the dataset down to two dimensions (note\n", - "that it automatically takes care of centering the data):" - ] - }, - { - "cell_type": "code", - "execution_count": 12, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "[[ 1.5378811 -0.94639099]\n", - " [-0.86145244 0.89288636]\n", - " [ 0.00445655 0.81633628]\n", - " [-0.07145103 -1.00433417]\n", - " [-2.03707133 -0.48476997]\n", - " [-0.72174172 -1.4557763 ]\n", - " [ 0.55854694 1.60673226]\n", - " [-1.6999536 0.43766686]\n", - " [ 1.10405456 0.31718909]\n", - " [ 2.18673098 -0.17953942]]\n" - ] - } - ], - "source": [ - "#thereafter we do a PCA with Scikit-learn\n", - "from sklearn.decomposition import PCA\n", - "pca = PCA(n_components = 2)\n", - "X2D = pca.fit_transform(X)\n", - "print(X2D)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "After fitting the PCA transformer to the dataset, you can access the principal components using the\n", - "components variable (note that it contains the PCs as horizontal vectors, so, for example, the first\n", - "principal component is equal to" - ] - }, - { - "cell_type": "code", - "execution_count": 13, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "data": { - "text/plain": [ - "array([-0.62373464, -0.5303329 , 0.317367 , 0.01873344, 0.47815203])" - ] - }, - "execution_count": 13, - "metadata": {}, - "output_type": "execute_result" - } - ], - "source": [ - "pca.components_.T[:, 0]" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Another very useful piece of information is the explained variance ratio of each principal component,\n", - "available via the $explained\\_variance\\_ratio$ variable. It indicates the proportion of the dataset’s\n", - "variance that lies along the axis of each principal component. \n", - "\n", - "## Back to the Cancer Data\n", - "We can now repeat the above but applied to real data, in this case our breast cancer data.\n", - "Here we compute performance scores on the training data using logistic regression." - ] - }, - { - "cell_type": "code", - "execution_count": 14, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Train set accuracy from Logistic Regression: 0.95\n", - "Train set accuracy scaled data: 0.99\n", - "Train set accuracy scaled and PCA data: 0.96\n" - ] - }, - { - "name": "stderr", - "output_type": "stream", - "text": [ - "/Users/mhjensen/opt/anaconda3/lib/python3.8/site-packages/sklearn/linear_model/_logistic.py:762: ConvergenceWarning: lbfgs failed to converge (status=1):\n", - "STOP: TOTAL NO. of ITERATIONS REACHED LIMIT.\n", - "\n", - "Increase the number of iterations (max_iter) or scale the data as shown in:\n", - " https://scikit-learn.org/stable/modules/preprocessing.html\n", - "Please also refer to the documentation for alternative solver options:\n", - " https://scikit-learn.org/stable/modules/linear_model.html#logistic-regression\n", - " n_iter_i = _check_optimize_result(\n" - ] - } - ], - "source": [ - "import matplotlib.pyplot as plt\n", - "import numpy as np\n", - "from sklearn.model_selection import train_test_split \n", - "from sklearn.datasets import load_breast_cancer\n", - "from sklearn.linear_model import LogisticRegression\n", - "cancer = load_breast_cancer()\n", - "\n", - "X_train, X_test, y_train, y_test = train_test_split(cancer.data,cancer.target,random_state=0)\n", - "\n", - "logreg = LogisticRegression()\n", - "logreg.fit(X_train, y_train)\n", - "print(\"Train set accuracy from Logistic Regression: {:.2f}\".format(logreg.score(X_train,y_train)))\n", - "# We scale the data\n", - "from sklearn.preprocessing import StandardScaler\n", - "scaler = StandardScaler()\n", - "scaler.fit(X_train)\n", - "X_train_scaled = scaler.transform(X_train)\n", - "X_test_scaled = scaler.transform(X_test)\n", - "# Then perform again a log reg fit\n", - "logreg.fit(X_train_scaled, y_train)\n", - "print(\"Train set accuracy scaled data: {:.2f}\".format(logreg.score(X_train_scaled,y_train)))\n", - "#thereafter we do a PCA with Scikit-learn\n", - "from sklearn.decomposition import PCA\n", - "pca = PCA(n_components = 2)\n", - "X2D_train = pca.fit_transform(X_train_scaled)\n", - "# and finally compute the log reg fit and the score on the training data\t\n", - "logreg.fit(X2D_train,y_train)\n", - "print(\"Train set accuracy scaled and PCA data: {:.2f}\".format(logreg.score(X2D_train,y_train)))" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We see that our training data after the PCA decomposition has a performance similar to the non-scaled data. \n", - "\n", - "\n", - "Instead of arbitrarily choosing the number of dimensions to reduce down to, it is generally preferable to\n", - "choose the number of dimensions that add up to a sufficiently large portion of the variance (e.g., 95%).\n", - "Unless, of course, you are reducing dimensionality for data visualization — in that case you will\n", - "generally want to reduce the dimensionality down to 2 or 3.\n", - "The following code computes PCA without reducing dimensionality, then computes the minimum number\n", - "of dimensions required to preserve 95% of the training set’s variance:" - ] - }, - { - "cell_type": "code", - "execution_count": 15, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "pca = PCA()\n", - "pca.fit(X)\n", - "cumsum = np.cumsum(pca.explained_variance_ratio_)\n", - "d = np.argmax(cumsum >= 0.95) + 1" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "You could then set $n\\_components=d$ and run PCA again. However, there is a much better option: instead\n", - "of specifying the number of principal components you want to preserve, you can set $n\\_components$ to be\n", - "a float between 0.0 and 1.0, indicating the ratio of variance you wish to preserve:" - ] - }, - { - "cell_type": "code", - "execution_count": 16, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "pca = PCA(n_components=0.95)\n", - "X_reduced = pca.fit_transform(X)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "### Incremental PCA\n", - "\n", - "One problem with the preceding implementation of PCA is that it requires the whole training set to fit in\n", - "memory in order for the SVD algorithm to run. Fortunately, Incremental PCA (IPCA) algorithms have\n", - "been developed: you can split the training set into mini-batches and feed an IPCA algorithm one minibatch\n", - "at a time. This is useful for large training sets, and also to apply PCA online (i.e., on the fly, as new\n", - "instances arrive).\n", - "\n", - "\n", - "### Randomized PCA\n", - "\n", - "Scikit-Learn offers yet another option to perform PCA, called Randomized PCA. This is a stochastic\n", - "algorithm that quickly finds an approximation of the first d principal components. Its computational\n", - "complexity is $O(m \\times d^2)+O(d^3)$, instead of $O(m \\times n^2) + O(n^3)$, so it is dramatically faster than the\n", - "previous algorithms when $d$ is much smaller than $n$.\n", - "\n", - "\n", - "### Kernel PCA\n", - "\n", - "The kernel trick is a mathematical technique that implicitly maps instances into a\n", - "very high-dimensional space (called the feature space), enabling nonlinear classification and regression\n", - "with Support Vector Machines. Recall that a linear decision boundary in the high-dimensional feature\n", - "space corresponds to a complex nonlinear decision boundary in the original space.\n", - "It turns out that the same trick can be applied to PCA, making it possible to perform complex nonlinear\n", - "projections for dimensionality reduction. This is called Kernel PCA (kPCA). It is often good at\n", - "preserving clusters of instances after projection, or sometimes even unrolling datasets that lie close to a\n", - "twisted manifold.\n", - "For example, the following code uses Scikit-Learn’s KernelPCA class to perform kPCA with an" - ] - }, - { - "cell_type": "code", - "execution_count": 17, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "from sklearn.decomposition import KernelPCA\n", - "rbf_pca = KernelPCA(n_components = 2, kernel=\"rbf\", gamma=0.04)\n", - "X_reduced = rbf_pca.fit_transform(X)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Other techniques\n", - "\n", - "\n", - "There are many other dimensionality reduction techniques, several of which are available in Scikit-Learn.\n", - "\n", - "Here are some of the most popular:\n", - "* **Multidimensional Scaling (MDS)** reduces dimensionality while trying to preserve the distances between the instances.\n", - "\n", - "* **Isomap** creates a graph by connecting each instance to its nearest neighbors, then reduces dimensionality while trying to preserve the geodesic distances between the instances.\n", - "\n", - "* **t-Distributed Stochastic Neighbor Embedding** (t-SNE) reduces dimensionality while trying to keep similar instances close and dissimilar instances apart. It is mostly used for visualization, in particular to visualize clusters of instances in high-dimensional space (e.g., to visualize the MNIST images in 2D).\n", - "\n", - "* Linear Discriminant Analysis (LDA) is actually a classification algorithm, but during training it learns the most discriminative axes between the classes, and these axes can then be used to define a hyperplane onto which to project the data. The benefit is that the projection will keep classes as far apart as possible, so LDA is a good technique to reduce dimensionality before running another classification algorithm such as a Support Vector Machine (SVM) classifier discussed in the SVM lectures." - ] - } - ], - "metadata": { - "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.8.5" - } - }, - "nbformat": 4, - "nbformat_minor": 4 -} \ No newline at end of file diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter8.py b/doc/LectureNotes/_build/jupyter_execute/chapter8.py deleted file mode 100644 index a61a1ae60..000000000 --- a/doc/LectureNotes/_build/jupyter_execute/chapter8.py +++ /dev/null @@ -1,791 +0,0 @@ -# Basic ideas of the Principal Component Analysis (PCA) - -The principal component analysis deals with the problem of fitting a -low-dimensional affine subspace $S$ of dimension $d$ much smaller than -the total dimension $D$ of the problem at hand (our data -set). Mathematically it can be formulated as a statistical problem or -a geometric problem. In our discussion of the theorem for the -classical PCA, we will stay with a statistical approach. -Historically, the PCA was first formulated in a statistical setting in order to estimate the principal component of a multivariate random variable. - -We have a data set defined by a design/feature matrix $\boldsymbol{X}$ (see below for its definition) -* Each data point is determined by $p$ extrinsic (measurement) variables - -* We may want to ask the following question: Are there fewer intrinsic variables (say $d << p$) that still approximately describe the data? - -* If so, these intrinsic variables may tell us something important and finding these intrinsic variables is what dimension reduction methods do. - -A good read is for example [Vidal, Ma and Sastry](https://www.springer.com/gp/book/9780387878102). - - - -## Introducing the Covariance and Correlation functions - -Before we discuss the PCA theorem, we need to remind ourselves about -the definition of the covariance and the correlation function. These are quantities - -Suppose we have defined two vectors -$\hat{x}$ and $\hat{y}$ with $n$ elements each. The covariance matrix $\boldsymbol{C}$ is defined as - -$$ -\boldsymbol{C}[\boldsymbol{x},\boldsymbol{y}] = \begin{bmatrix} \mathrm{cov}[\boldsymbol{x},\boldsymbol{x}] & \mathrm{cov}[\boldsymbol{x},\boldsymbol{y}] \\ - \mathrm{cov}[\boldsymbol{y},\boldsymbol{x}] & \mathrm{cov}[\boldsymbol{y},\boldsymbol{y}] \\ - \end{bmatrix}, -$$ - -where for example - -$$ -\mathrm{cov}[\boldsymbol{x},\boldsymbol{y}] =\frac{1}{n} \sum_{i=0}^{n-1}(x_i- \overline{x})(y_i- \overline{y}). -$$ - -With this definition and recalling that the variance is defined as - -$$ -\mathrm{var}[\boldsymbol{x}]=\frac{1}{n} \sum_{i=0}^{n-1}(x_i- \overline{x})^2, -$$ - -we can rewrite the covariance matrix as - -$$ -\boldsymbol{C}[\boldsymbol{x},\boldsymbol{y}] = \begin{bmatrix} \mathrm{var}[\boldsymbol{x}] & \mathrm{cov}[\boldsymbol{x},\boldsymbol{y}] \\ - \mathrm{cov}[\boldsymbol{x},\boldsymbol{y}] & \mathrm{var}[\boldsymbol{y}] \\ - \end{bmatrix}. -$$ - -The covariance takes values between zero and infinity and may thus -lead to problems with loss of numerical precision for particularly -large values. It is common to scale the covariance matrix by -introducing instead the correlation matrix defined via the so-called -correlation function - -$$ -\mathrm{corr}[\boldsymbol{x},\boldsymbol{y}]=\frac{\mathrm{cov}[\boldsymbol{x},\boldsymbol{y}]}{\sqrt{\mathrm{var}[\boldsymbol{x}] \mathrm{var}[\boldsymbol{y}]}}. -$$ - -The correlation function is then given by values $\mathrm{corr}[\boldsymbol{x},\boldsymbol{y}] -\in [-1,1]$. This avoids eventual problems with too large values. We -can then define the correlation matrix for the two vectors $\boldsymbol{x}$ -and $\boldsymbol{y}$ as - -$$ -\boldsymbol{K}[\boldsymbol{x},\boldsymbol{y}] = \begin{bmatrix} 1 & \mathrm{corr}[\boldsymbol{x},\boldsymbol{y}] \\ - \mathrm{corr}[\boldsymbol{y},\boldsymbol{x}] & 1 \\ - \end{bmatrix}, -$$ - -In the above example this is the function we constructed using **pandas**. - - -In our derivation of the various regression algorithms like **Ordinary Least Squares** or **Ridge regression** -we defined the design/feature matrix $\boldsymbol{X}$ as - -$$ -\boldsymbol{X}=\begin{bmatrix} -x_{0,0} & x_{0,1} & x_{0,2}& \dots & \dots x_{0,p-1}\\ -x_{1,0} & x_{1,1} & x_{1,2}& \dots & \dots x_{1,p-1}\\ -x_{2,0} & x_{2,1} & x_{2,2}& \dots & \dots x_{2,p-1}\\ -\dots & \dots & \dots & \dots \dots & \dots \\ -x_{n-2,0} & x_{n-2,1} & x_{n-2,2}& \dots & \dots x_{n-2,p-1}\\ -x_{n-1,0} & x_{n-1,1} & x_{n-1,2}& \dots & \dots x_{n-1,p-1}\\ -\end{bmatrix}, -$$ - -with $\boldsymbol{X}\in {\mathbb{R}}^{n\times p}$, with the predictors/features $p$ refering to the column numbers and the -entries $n$ being the row elements. -We can rewrite the design/feature matrix in terms of its column vectors as - -$$ -\boldsymbol{X}=\begin{bmatrix} \boldsymbol{x}_0 & \boldsymbol{x}_1 & \boldsymbol{x}_2 & \dots & \dots & \boldsymbol{x}_{p-1}\end{bmatrix}, -$$ - -with a given vector - -$$ -\boldsymbol{x}_i^T = \begin{bmatrix}x_{0,i} & x_{1,i} & x_{2,i}& \dots & \dots x_{n-1,i}\end{bmatrix}. -$$ - -With these definitions, we can now rewrite our $2\times 2$ -correaltion/covariance matrix in terms of a moe general design/feature -matrix $\boldsymbol{X}\in {\mathbb{R}}^{n\times p}$. This leads to a $p\times p$ -covariance matrix for the vectors $\boldsymbol{x}_i$ with $i=0,1,\dots,p-1$ - -$$ -\boldsymbol{C}[\boldsymbol{x}] = \begin{bmatrix} -\mathrm{var}[\boldsymbol{x}_0] & \mathrm{cov}[\boldsymbol{x}_0,\boldsymbol{x}_1] & \mathrm{cov}[\boldsymbol{x}_0,\boldsymbol{x}_2] & \dots & \dots & \mathrm{cov}[\boldsymbol{x}_0,\boldsymbol{x}_{p-1}]\\ -\mathrm{cov}[\boldsymbol{x}_1,\boldsymbol{x}_0] & \mathrm{var}[\boldsymbol{x}_1] & \mathrm{cov}[\boldsymbol{x}_1,\boldsymbol{x}_2] & \dots & \dots & \mathrm{cov}[\boldsymbol{x}_1,\boldsymbol{x}_{p-1}]\\ -\mathrm{cov}[\boldsymbol{x}_2,\boldsymbol{x}_0] & \mathrm{cov}[\boldsymbol{x}_2,\boldsymbol{x}_1] & \mathrm{var}[\boldsymbol{x}_2] & \dots & \dots & \mathrm{cov}[\boldsymbol{x}_2,\boldsymbol{x}_{p-1}]\\ -\dots & \dots & \dots & \dots & \dots & \dots \\ -\dots & \dots & \dots & \dots & \dots & \dots \\ -\mathrm{cov}[\boldsymbol{x}_{p-1},\boldsymbol{x}_0] & \mathrm{cov}[\boldsymbol{x}_{p-1},\boldsymbol{x}_1] & \mathrm{cov}[\boldsymbol{x}_{p-1},\boldsymbol{x}_{2}] & \dots & \dots & \mathrm{var}[\boldsymbol{x}_{p-1}]\\ -\end{bmatrix}, -$$ - -and the correlation matrix - -$$ -\boldsymbol{K}[\boldsymbol{x}] = \begin{bmatrix} -1 & \mathrm{corr}[\boldsymbol{x}_0,\boldsymbol{x}_1] & \mathrm{corr}[\boldsymbol{x}_0,\boldsymbol{x}_2] & \dots & \dots & \mathrm{corr}[\boldsymbol{x}_0,\boldsymbol{x}_{p-1}]\\ -\mathrm{corr}[\boldsymbol{x}_1,\boldsymbol{x}_0] & 1 & \mathrm{corr}[\boldsymbol{x}_1,\boldsymbol{x}_2] & \dots & \dots & \mathrm{corr}[\boldsymbol{x}_1,\boldsymbol{x}_{p-1}]\\ -\mathrm{corr}[\boldsymbol{x}_2,\boldsymbol{x}_0] & \mathrm{corr}[\boldsymbol{x}_2,\boldsymbol{x}_1] & 1 & \dots & \dots & \mathrm{corr}[\boldsymbol{x}_2,\boldsymbol{x}_{p-1}]\\ -\dots & \dots & \dots & \dots & \dots & \dots \\ -\dots & \dots & \dots & \dots & \dots & \dots \\ -\mathrm{corr}[\boldsymbol{x}_{p-1},\boldsymbol{x}_0] & \mathrm{corr}[\boldsymbol{x}_{p-1},\boldsymbol{x}_1] & \mathrm{corr}[\boldsymbol{x}_{p-1},\boldsymbol{x}_{2}] & \dots & \dots & 1\\ -\end{bmatrix}, -$$ - -The Numpy function **np.cov** calculates the covariance elements using -the factor $1/(n-1)$ instead of $1/n$ since it assumes we do not have -the exact mean values. The following simple function uses the -**np.vstack** function which takes each vector of dimension $1\times n$ -and produces a $2\times n$ matrix $\boldsymbol{W}$ - -$$ -\boldsymbol{W} = \begin{bmatrix} x_0 & y_0 \\ - x_1 & y_1 \\ - x_2 & y_2\\ - \dots & \dots \\ - x_{n-2} & y_{n-2}\\ - x_{n-1} & y_{n-1} & - \end{bmatrix}, -$$ - -which in turn is converted into into the $2\times 2$ covariance matrix -$\boldsymbol{C}$ via the Numpy function **np.cov()**. We note that we can also calculate -the mean value of each set of samples $\boldsymbol{x}$ etc using the Numpy -function **np.mean(x)**. We can also extract the eigenvalues of the -covariance matrix through the **np.linalg.eig()** function. - -# Importing various packages -import numpy as np -n = 100 -x = np.random.normal(size=n) -print(np.mean(x)) -y = 4+3*x+np.random.normal(size=n) -print(np.mean(y)) -W = np.vstack((x, y)) -C = np.cov(W) -print(C) - -## Correlation Matrix - -The previous example can be converted into the correlation matrix by -simply scaling the matrix elements with the variances. We should also -subtract the mean values for each column. This leads to the following -code which sets up the correlations matrix for the previous example in -a more brute force way. Here we scale the mean values for each column of the design matrix, calculate the relevant mean values and variances and then finally set up the $2\times 2$ correlation matrix (since we have only two vectors). - -import numpy as np -n = 100 -# define two vectors -x = np.random.random(size=n) -y = 4+3*x+np.random.normal(size=n) -#scaling the x and y vectors -x = x - np.mean(x) -y = y - np.mean(y) -variance_x = np.sum(x@x)/n -variance_y = np.sum(y@y)/n -print(variance_x) -print(variance_y) -cov_xy = np.sum(x@y)/n -cov_xx = np.sum(x@x)/n -cov_yy = np.sum(y@y)/n -C = np.zeros((2,2)) -C[0,0]= cov_xx/variance_x -C[1,1]= cov_yy/variance_y -C[0,1]= cov_xy/np.sqrt(variance_y*variance_x) -C[1,0]= C[0,1] -print(C) - -We see that the matrix elements along the diagonal are one as they -should be and that the matrix is symmetric. Furthermore, diagonalizing -this matrix we easily see that it is a positive definite matrix. - -The above procedure with **numpy** can be made more compact if we use **pandas**. - - -We whow here how we can set up the correlation matrix using **pandas**, as done in this simple code - -import numpy as np -import pandas as pd -n = 10 -x = np.random.normal(size=n) -x = x - np.mean(x) -y = 4+3*x+np.random.normal(size=n) -y = y - np.mean(y) -X = (np.vstack((x, y))).T -print(X) -Xpd = pd.DataFrame(X) -print(Xpd) -correlation_matrix = Xpd.corr() -print(correlation_matrix) - -We expand this model to the Franke function discussed above. - -# Common imports -import numpy as np -import pandas as pd - - -def FrankeFunction(x,y): - term1 = 0.75*np.exp(-(0.25*(9*x-2)**2) - 0.25*((9*y-2)**2)) - term2 = 0.75*np.exp(-((9*x+1)**2)/49.0 - 0.1*(9*y+1)) - term3 = 0.5*np.exp(-(9*x-7)**2/4.0 - 0.25*((9*y-3)**2)) - term4 = -0.2*np.exp(-(9*x-4)**2 - (9*y-7)**2) - return term1 + term2 + term3 + term4 - - -def create_X(x, y, n ): - if len(x.shape) > 1: - x = np.ravel(x) - y = np.ravel(y) - - N = len(x) - l = int((n+1)*(n+2)/2) # Number of elements in beta - X = np.ones((N,l)) - - for i in range(1,n+1): - q = int((i)*(i+1)/2) - for k in range(i+1): - X[:,q+k] = (x**(i-k))*(y**k) - - return X - - -# Making meshgrid of datapoints and compute Franke's function -n = 4 -N = 100 -x = np.sort(np.random.uniform(0, 1, N)) -y = np.sort(np.random.uniform(0, 1, N)) -z = FrankeFunction(x, y) -X = create_X(x, y, n=n) - -Xpd = pd.DataFrame(X) -# subtract the mean values and set up the covariance matrix -Xpd = Xpd - Xpd.mean() -covariance_matrix = Xpd.cov() -print(covariance_matrix) - -We note here that the covariance is zero for the first rows and -columns since all matrix elements in the design matrix were set to one -(we are fitting the function in terms of a polynomial of degree $n$). We would however not include the intercept -and wee can simply -drop these elements and construct a correlation -matrix without them. - - - -We can rewrite the covariance matrix in a more compact form in terms of the design/feature matrix $\boldsymbol{X}$ as - -$$ -\boldsymbol{C}[\boldsymbol{x}] = \frac{1}{n}\boldsymbol{X}^T\boldsymbol{X}= \mathbb{E}[\boldsymbol{X}^T\boldsymbol{X}]. -$$ - -To see this let us simply look at a design matrix $\boldsymbol{X}\in {\mathbb{R}}^{2\times 2}$ - -$$ -\boldsymbol{X}=\begin{bmatrix} -x_{00} & x_{01}\\ -x_{10} & x_{11}\\ -\end{bmatrix}=\begin{bmatrix} -\boldsymbol{x}_{0} & \boldsymbol{x}_{1}\\ -\end{bmatrix}. -$$ - -If we then compute the expectation value - -$$ -\mathbb{E}[\boldsymbol{X}^T\boldsymbol{X}] = \frac{1}{n}\boldsymbol{X}^T\boldsymbol{X}=\begin{bmatrix} -x_{00}^2+x_{01}^2 & x_{00}x_{10}+x_{01}x_{11}\\ -x_{10}x_{00}+x_{11}x_{01} & x_{10}^2+x_{11}^2\\ -\end{bmatrix}, -$$ - -which is just - -$$ -\boldsymbol{C}[\boldsymbol{x}_0,\boldsymbol{x}_1] = \boldsymbol{C}[\boldsymbol{x}]=\begin{bmatrix} \mathrm{var}[\boldsymbol{x}_0] & \mathrm{cov}[\boldsymbol{x}_0,\boldsymbol{x}_1] \\ - \mathrm{cov}[\boldsymbol{x}_1,\boldsymbol{x}_0] & \mathrm{var}[\boldsymbol{x}_1] \\ - \end{bmatrix}, -$$ - -where we wrote $$\boldsymbol{C}[\boldsymbol{x}_0,\boldsymbol{x}_1] = \boldsymbol{C}[\boldsymbol{x}]$$ to indicate that this the covariance of the vectors $\boldsymbol{x}$ of the design/feature matrix $\boldsymbol{X}$. - -It is easy to generalize this to a matrix $\boldsymbol{X}\in {\mathbb{R}}^{n\times p}$. - - - -## Towards the PCA theorem - -We have that the covariance matrix (the correlation matrix involves a simple rescaling) is given as - -$$ -\boldsymbol{C}[\boldsymbol{x}] = \frac{1}{n}\boldsymbol{X}^T\boldsymbol{X}= \mathbb{E}[\boldsymbol{X}^T\boldsymbol{X}]. -$$ - -Let us now assume that we can perform a series of orthogonal transformations where we employ some orthogonal matrices $\boldsymbol{S}$. -These matrices are defined as $\boldsymbol{S}\in {\mathbb{R}}^{p\times p}$ and obey the orthogonality requirements $\boldsymbol{S}\boldsymbol{S}^T=\boldsymbol{S}^T\boldsymbol{S}=\boldsymbol{I}$. The matrix can be written out in terms of the column vectors $\boldsymbol{s}_i$ as $\boldsymbol{S}=[\boldsymbol{s}_0,\boldsymbol{s}_1,\dots,\boldsymbol{s}_{p-1}]$ and $\boldsymbol{s}_i \in {\mathbb{R}}^{p}$. - -Assume also that there is a transformation $\boldsymbol{S}^T\boldsymbol{C}[\boldsymbol{x}]\boldsymbol{S}=\boldsymbol{C}[\boldsymbol{y}]$ such that the new matrix $\boldsymbol{C}[\boldsymbol{y}]$ is diagonal with elements $[\lambda_0,\lambda_1,\lambda_2,\dots,\lambda_{p-1}]$. - -That is we have - -$$ -\boldsymbol{C}[\boldsymbol{y}] = \mathbb{E}[\boldsymbol{S}^T\boldsymbol{X}^T\boldsymbol{X}T\boldsymbol{S}]=\boldsymbol{S}^T\boldsymbol{C}[\boldsymbol{x}]\boldsymbol{S}, -$$ - -since the matrix $\boldsymbol{S}$ is not a data dependent matrix. Multiplying with $\boldsymbol{S}$ from the left we have - -$$ -\boldsymbol{S}\boldsymbol{C}[\boldsymbol{y}] = \boldsymbol{C}[\boldsymbol{x}]\boldsymbol{S}, -$$ - -and since $\boldsymbol{C}[\boldsymbol{y}]$ is diagonal we have for a given eigenvalue $i$ of the covariance matrix that - -$$ -\boldsymbol{S}_i\lambda_i = \boldsymbol{C}[\boldsymbol{x}]\boldsymbol{S}_i. -$$ - -In the derivation of the PCA theorem we will assume that the eigenvalues are ordered in descending order, that is -$\lambda_0 > \lambda_1 > \dots > \lambda_{p-1}$. - - -The eigenvalues tell us then how much we need to stretch the -corresponding eigenvectors. Dimensions with large eigenvalues have -thus large variations (large variance) and define therefore useful -dimensions. The data points are more spread out in the direction of -these eigenvectors. Smaller eigenvalues mean on the other hand that -the corresponding eigenvectors are shrunk accordingly and the data -points are tightly bunched together and there is not much variation in -these specific directions. Hopefully then we could leave it out -dimensions where the eigenvalues are very small. If $p$ is very large, -we could then aim at reducing $p$ to $l << p$ and handle only $l$ -features/predictors. - -### The Algorithm before theorem - -Here's how we would proceed in setting up the algorithm for the PCA, see also discussion below here. -* Set up the datapoints for the design/feature matrix $\boldsymbol{X}$ with $\boldsymbol{X}\in {\mathbb{R}}^{n\times p}$, with the predictors/features $p$ referring to the column numbers and the entries $n$ being the row elements. - -$$ -\boldsymbol{X}=\begin{bmatrix} -x_{0,0} & x_{0,1} & x_{0,2}& \dots & \dots x_{0,p-1}\\ -x_{1,0} & x_{1,1} & x_{1,2}& \dots & \dots x_{1,p-1}\\ -x_{2,0} & x_{2,1} & x_{2,2}& \dots & \dots x_{2,p-1}\\ -\dots & \dots & \dots & \dots \dots & \dots \\ -x_{n-2,0} & x_{n-2,1} & x_{n-2,2}& \dots & \dots x_{n-2,p-1}\\ -x_{n-1,0} & x_{n-1,1} & x_{n-1,2}& \dots & \dots x_{n-1,p-1}\\ -\end{bmatrix}, -$$ - -* Center the data by subtracting the mean value for each column. This leads to a new matrix $\boldsymbol{X}\rightarrow \overline{\boldsymbol{X}}$. - -* Compute then the covariance/correlation matrix $\mathbb{E}[\overline{\boldsymbol{X}}^T\overline{\boldsymbol{X}}]$. - -* Find the eigenpairs of $\boldsymbol{C}$ with eigenvalues $[\lambda_0,\lambda_1,\dots,\lambda_{p-1}]$ and eigenvectors $[\boldsymbol{s}_0,\boldsymbol{s}_1,\dots,\boldsymbol{s}_{p-1}]$. - -* Order the eigenvalue (and the eigenvectors accordingly) in order of decreasing eigenvalues. - -* Keep only those $l$ eigenvalues larger than a selected threshold value, discarding thus $p-l$ features since we expect small variations in the data here. - -### Writing our own PCA code - -We will use a simple example first with two-dimensional data -drawn from a multivariate normal distribution with the following mean and covariance matrix (we have fixed these quantities but will play around with them below): - -$$ -\mu = (-1,2) \qquad \Sigma = \begin{bmatrix} 4 & 2 \\ -2 & 2 -\end{bmatrix} -$$ - -Note that the mean refers to each column of data. -We will generate $n = 10000$ points $X = \{ x_1, \ldots, x_N \}$ from -this distribution, and store them in the $1000 \times 2$ matrix $\boldsymbol{X}$. This is our design matrix where we have forced the covariance and mean values to take specific values. - -The following Python code aids in setting up the data and writing out the design matrix. -Note that the function **multivariate** returns also the covariance discussed above and that it is defined by dividing by $n-1$ instead of $n$. - -%matplotlib inline - -import numpy as np -import pandas as pd -import matplotlib.pyplot as plt -from IPython.display import display -n = 10000 -mean = (-1, 2) -cov = [[4, 2], [2, 2]] -X = np.random.multivariate_normal(mean, cov, n) - -Now we are going to implement the PCA algorithm. We will break it down into various substeps. - - -The first step of PCA is to compute the sample mean of the data and use it to center the data. Recall that the sample mean is - -$$ -\mu_n = \frac{1}{n} \sum_{i=1}^n x_i -$$ - -and the mean-centered data $\bar{X} = \{ \bar{x}_1, \ldots, \bar{x}_n \}$ takes the form - -$$ -\bar{x}_i = x_i - \mu_n. -$$ - -When you are done with these steps, print out $\mu_n$ to verify it is -close to $\mu$ and plot your mean centered data to verify it is -centered at the origin! -The following code elements perform these operations using **pandas** or using our own functionality for doing so. The latter, using **numpy** is rather simple through the **mean()** function. - -df = pd.DataFrame(X) -# Pandas does the centering for us -df = df -df.mean() -# we center it ourselves -X_centered = X - X.mean(axis=0) - -Alternatively, we could use the functions we discussed -earlier for scaling the data set. That is, we could have used the -**StandardScaler** function in **Scikit-Learn**, a function which ensures -that for each feature/predictor we study the mean value is zero and -the variance is one (every column in the design/feature matrix). You -would then not get the same results, since we divide by the -variance. The diagonal covariance matrix elements will then be one, -while the non-diagonal ones need to be divided by $2\sqrt{2}$ for our -specific case. - - -Now we are going to use the mean centered data to compute the sample covariance of the data by using the following equation - -$$ -\Sigma_n = \frac{1}{n-1} \sum_{i=1}^n \bar{x}_i^T \bar{x}_i = \frac{1}{n-1} \sum_{i=1}^n (x_i - \mu_n)^T (x_i - \mu_n) -$$ - -where the data points $x_i \in \mathbb{R}^p$ (here in this example $p = 2$) are column vectors and $x^T$ is the transpose of $x$. -We can write our own code or simply use either the functionaly of **numpy** or that of **pandas**, as follows - -print(df.cov()) -print(np.cov(X_centered.T)) - -Note that the way we define the covariance matrix here has a factor $n-1$ instead of $n$. This is included in the **cov()** function by **numpy** and **pandas**. -Our own code here is not very elegant and asks for obvious improvements. It is tailored to this specific $2\times 2$ covariance matrix. - -# extract the relevant columns from the centered design matrix of dim n x 2 -x = X_centered[:,0] -y = X_centered[:,1] -Cov = np.zeros((2,2)) -Cov[0,1] = np.sum(x.T@y)/(n-1.0) -Cov[0,0] = np.sum(x.T@x)/(n-1.0) -Cov[1,1] = np.sum(y.T@y)/(n-1.0) -Cov[1,0]= Cov[0,1] -print("Centered covariance using own code") -print(Cov) -plt.plot(x, y, 'x') -plt.axis('equal') -plt.show() - -Depending on the number of points $n$, we will get results that are close to the covariance values defined above. -The plot shows how the data are clustered around a line with slope close to one. Is this expected? Try to change the covariance and the mean values. For example, try to make the variance of the first element much larger than that of the second diagonal element. Try also to shrink the covariance (the non-diagonal elements) and see how the data points are distributed. - -### Diagonalize the sample covariance matrix to obtain the principal components - -Now we are ready to solve for the principal components! To do so we -diagonalize the sample covariance matrix $\Sigma$. We can use the -function **np.linalg.eig** to do so. It will return the eigenvalues and -eigenvectors of $\Sigma$. Once we have these we can perform the -following tasks: - -* We compute the percentage of the total variance captured by the first principal component - -* We plot the mean centered data and lines along the first and second principal components - -* Then we project the mean centered data onto the first and second principal components, and plot the projected data. - -* Finally, we approximate the data as - -$$ -x_i \approx \tilde{x}_i = \mu_n + \langle x_i, v_0 \rangle v_0 -$$ - -where $v_0$ is the first principal component. - -Collecting all these steps we can write our own PCA function and -compare this with the functionality included in **Scikit-Learn**. - -The code here outlines some of the elements we could include in the -analysis. Feel free to extend upon this in order to address the above -questions. - -# diagonalize and obtain eigenvalues, not necessarily sorted -EigValues, EigVectors = np.linalg.eig(Cov) -# sort eigenvectors and eigenvalues -#permute = EigValues.argsort() -#EigValues = EigValues[permute] -#EigVectors = EigVectors[:,permute] -print("Eigenvalues of Covariance matrix") -for i in range(2): - print(EigValues[i]) -FirstEigvector = EigVectors[:,0] -SecondEigvector = EigVectors[:,1] -print("First eigenvector") -print(FirstEigvector) -print("Second eigenvector") -print(SecondEigvector) -#thereafter we do a PCA with Scikit-learn -from sklearn.decomposition import PCA -pca = PCA(n_components = 2) -X2Dsl = pca.fit_transform(X) -print("Eigenvector of largest eigenvalue") -print(pca.components_.T[:, 0]) - -This code does not contain all the above elements, but it shows how we can use **Scikit-Learn** to extract the eigenvector which corresponds to the largest eigenvalue. Try to address the questions we pose before the above code. Try also to change the values of the covariance matrix by making one of the diagonal elements much larger than the other. What do you observe then? - - -## Classical PCA Theorem - -We assume now that we have a design matrix $\boldsymbol{X}$ which has been -centered as discussed above. For the sake of simplicity we skip the -overline symbol. The matrix is defined in terms of the various column -vectors $[\boldsymbol{x}_0,\boldsymbol{x}_1,\dots, \boldsymbol{x}_{p-1}]$ each with dimension -$\boldsymbol{x}\in {\mathbb{R}}^{n}$. - - - -The PCA theorem states that minimizing the above reconstruction error -corresponds to setting $\boldsymbol{W}=\boldsymbol{S}$, the orthogonal matrix which -diagonalizes the empirical covariance(correlation) matrix. The optimal -low-dimensional encoding of the data is then given by a set of vectors -$\boldsymbol{z}_i$ with at most $l$ vectors, with $l << p$, defined by the -orthogonal projection of the data onto the columns spanned by the -eigenvectors of the covariance(correlations matrix). - - - - -To show the PCA theorem let us start with the assumption that there is one vector $\boldsymbol{s}_0$ which corresponds to a solution which minimized the reconstruction error $J$. This is an orthogonal vector. It means that we now approximate the reconstruction error in terms of $\boldsymbol{w}_0$ and $\boldsymbol{z}_0$ as - - - -We are almost there, we have obtained a relation between minimizing -the reconstruction error and the variance and the covariance -matrix. Minimizing the error is equivalent to maximizing the variance -of the projected data. - - -We could trivially maximize the variance of the projection (and -thereby minimize the error in the reconstruction function) by letting -the norm-2 of $\boldsymbol{w}_0$ go to infinity. However, this norm since we -want the matrix $\boldsymbol{W}$ to be an orthogonal matrix, is constrained by -$\vert\vert \boldsymbol{w}_0 \vert\vert_2^2=1$. Imposing this condition via a -Lagrange multiplier we can then in turn maximize - -$$ -J(\boldsymbol{w}_0)= \boldsymbol{w}_0^T\boldsymbol{C}[\boldsymbol{x}]\boldsymbol{w}_0+\lambda_0(1-\boldsymbol{w}_0^T\boldsymbol{w}_0). -$$ - -Taking the derivative with respect to $\boldsymbol{w}_0$ we obtain - -$$ -\frac{\partial J(\boldsymbol{w}_0)}{\partial \boldsymbol{w}_0}= 2\boldsymbol{C}[\boldsymbol{x}]\boldsymbol{w}_0-2\lambda_0\boldsymbol{w}_0=0, -$$ - -meaning that - -$$ -\boldsymbol{C}[\boldsymbol{x}]\boldsymbol{w}_0=\lambda_0\boldsymbol{w}_0. -$$ - -**The direction that maximizes the variance (or minimizes the construction error) is an eigenvector of the covariance matrix**! If we left multiply with $\boldsymbol{w}_0^T$ we have the variance of the projected data is - -$$ -\boldsymbol{w}_0^T\boldsymbol{C}[\boldsymbol{x}]\boldsymbol{w}_0=\lambda_0. -$$ - -If we want to maximize the variance (minimize the construction error) -we simply pick the eigenvector of the covariance matrix with the -largest eigenvalue. This establishes the link between the minimization -of the reconstruction function $J$ in terms of an orthogonal matrix -and the maximization of the variance and thereby the covariance of our -observations encoded in the design/feature matrix $\boldsymbol{X}$. - -The proof -for the other eigenvectors $\boldsymbol{w}_1,\boldsymbol{w}_2,\dots$ can be -established by applying the above arguments and using the fact that -our basis of eigenvectors is orthogonal, see [Murphy chapter -12.2](https://mitpress.mit.edu/books/machine-learning-1). The -discussion in chapter 12.2 of Murphy's text has also a nice link with -the Singular Value Decomposition theorem. For categorical data, see -chapter 12.4 and discussion therein. - -For more details, see for example [Vidal, Ma and Sastry, chapter 2](https://www.springer.com/gp/book/9780387878102). - - -## Geometric Interpretation and link with Singular Value Decomposition - -For a detailed demonstration of the geometric interpretation, see [Vidal, Ma and Sastry, section 2.1.2](https://www.springer.com/gp/book/9780387878102). - - -Principal Component Analysis (PCA) is by far the most popular dimensionality reduction algorithm. -First it identifies the hyperplane that lies closest to the data, and then it projects the data onto it. - -The following Python code uses NumPy’s **svd()** function to obtain all the principal components of the -training set, then extracts the first two principal components. First we center the data using either **pandas** or our own code - -import numpy as np -import pandas as pd -from IPython.display import display -np.random.seed(100) -# setting up a 10 x 5 vanilla matrix -rows = 10 -cols = 5 -X = np.random.randn(rows,cols) -df = pd.DataFrame(X) -# Pandas does the centering for us -df = df -df.mean() -display(df) - -# we center it ourselves -X_centered = X - X.mean(axis=0) -# Then check the difference between pandas and our own set up -print(X_centered-df) -#Now we do an SVD -U, s, V = np.linalg.svd(X_centered) -c1 = V.T[:, 0] -c2 = V.T[:, 1] -W2 = V.T[:, :2] -X2D = X_centered.dot(W2) -print(X2D) - -PCA assumes that the dataset is centered around the origin. Scikit-Learn’s PCA classes take care of centering -the data for you. However, if you implement PCA yourself (as in the preceding example), or if you use other libraries, don’t -forget to center the data first. - -Once you have identified all the principal components, you can reduce the dimensionality of the dataset -down to $d$ dimensions by projecting it onto the hyperplane defined by the first $d$ principal components. -Selecting this hyperplane ensures that the projection will preserve as much variance as possible. - -W2 = V.T[:, :2] -X2D = X_centered.dot(W2) - -## PCA and scikit-learn - -Scikit-Learn’s PCA class implements PCA using SVD decomposition just like we did before. The -following code applies PCA to reduce the dimensionality of the dataset down to two dimensions (note -that it automatically takes care of centering the data): - -#thereafter we do a PCA with Scikit-learn -from sklearn.decomposition import PCA -pca = PCA(n_components = 2) -X2D = pca.fit_transform(X) -print(X2D) - -After fitting the PCA transformer to the dataset, you can access the principal components using the -components variable (note that it contains the PCs as horizontal vectors, so, for example, the first -principal component is equal to - -pca.components_.T[:, 0] - -Another very useful piece of information is the explained variance ratio of each principal component, -available via the $explained\_variance\_ratio$ variable. It indicates the proportion of the dataset’s -variance that lies along the axis of each principal component. - -## Back to the Cancer Data -We can now repeat the above but applied to real data, in this case our breast cancer data. -Here we compute performance scores on the training data using logistic regression. - -import matplotlib.pyplot as plt -import numpy as np -from sklearn.model_selection import train_test_split -from sklearn.datasets import load_breast_cancer -from sklearn.linear_model import LogisticRegression -cancer = load_breast_cancer() - -X_train, X_test, y_train, y_test = train_test_split(cancer.data,cancer.target,random_state=0) - -logreg = LogisticRegression() -logreg.fit(X_train, y_train) -print("Train set accuracy from Logistic Regression: {:.2f}".format(logreg.score(X_train,y_train))) -# We scale the data -from sklearn.preprocessing import StandardScaler -scaler = StandardScaler() -scaler.fit(X_train) -X_train_scaled = scaler.transform(X_train) -X_test_scaled = scaler.transform(X_test) -# Then perform again a log reg fit -logreg.fit(X_train_scaled, y_train) -print("Train set accuracy scaled data: {:.2f}".format(logreg.score(X_train_scaled,y_train))) -#thereafter we do a PCA with Scikit-learn -from sklearn.decomposition import PCA -pca = PCA(n_components = 2) -X2D_train = pca.fit_transform(X_train_scaled) -# and finally compute the log reg fit and the score on the training data -logreg.fit(X2D_train,y_train) -print("Train set accuracy scaled and PCA data: {:.2f}".format(logreg.score(X2D_train,y_train))) - -We see that our training data after the PCA decomposition has a performance similar to the non-scaled data. - - -Instead of arbitrarily choosing the number of dimensions to reduce down to, it is generally preferable to -choose the number of dimensions that add up to a sufficiently large portion of the variance (e.g., 95%). -Unless, of course, you are reducing dimensionality for data visualization — in that case you will -generally want to reduce the dimensionality down to 2 or 3. -The following code computes PCA without reducing dimensionality, then computes the minimum number -of dimensions required to preserve 95% of the training set’s variance: - -pca = PCA() -pca.fit(X) -cumsum = np.cumsum(pca.explained_variance_ratio_) -d = np.argmax(cumsum >= 0.95) + 1 - -You could then set $n\_components=d$ and run PCA again. However, there is a much better option: instead -of specifying the number of principal components you want to preserve, you can set $n\_components$ to be -a float between 0.0 and 1.0, indicating the ratio of variance you wish to preserve: - -pca = PCA(n_components=0.95) -X_reduced = pca.fit_transform(X) - -### Incremental PCA - -One problem with the preceding implementation of PCA is that it requires the whole training set to fit in -memory in order for the SVD algorithm to run. Fortunately, Incremental PCA (IPCA) algorithms have -been developed: you can split the training set into mini-batches and feed an IPCA algorithm one minibatch -at a time. This is useful for large training sets, and also to apply PCA online (i.e., on the fly, as new -instances arrive). - - -### Randomized PCA - -Scikit-Learn offers yet another option to perform PCA, called Randomized PCA. This is a stochastic -algorithm that quickly finds an approximation of the first d principal components. Its computational -complexity is $O(m \times d^2)+O(d^3)$, instead of $O(m \times n^2) + O(n^3)$, so it is dramatically faster than the -previous algorithms when $d$ is much smaller than $n$. - - -### Kernel PCA - -The kernel trick is a mathematical technique that implicitly maps instances into a -very high-dimensional space (called the feature space), enabling nonlinear classification and regression -with Support Vector Machines. Recall that a linear decision boundary in the high-dimensional feature -space corresponds to a complex nonlinear decision boundary in the original space. -It turns out that the same trick can be applied to PCA, making it possible to perform complex nonlinear -projections for dimensionality reduction. This is called Kernel PCA (kPCA). It is often good at -preserving clusters of instances after projection, or sometimes even unrolling datasets that lie close to a -twisted manifold. -For example, the following code uses Scikit-Learn’s KernelPCA class to perform kPCA with an - -from sklearn.decomposition import KernelPCA -rbf_pca = KernelPCA(n_components = 2, kernel="rbf", gamma=0.04) -X_reduced = rbf_pca.fit_transform(X) - -## Other techniques - - -There are many other dimensionality reduction techniques, several of which are available in Scikit-Learn. - -Here are some of the most popular: -* **Multidimensional Scaling (MDS)** reduces dimensionality while trying to preserve the distances between the instances. - -* **Isomap** creates a graph by connecting each instance to its nearest neighbors, then reduces dimensionality while trying to preserve the geodesic distances between the instances. - -* **t-Distributed Stochastic Neighbor Embedding** (t-SNE) reduces dimensionality while trying to keep similar instances close and dissimilar instances apart. It is mostly used for visualization, in particular to visualize clusters of instances in high-dimensional space (e.g., to visualize the MNIST images in 2D). - -* Linear Discriminant Analysis (LDA) is actually a classification algorithm, but during training it learns the most discriminative axes between the classes, and these axes can then be used to define a hyperplane onto which to project the data. The benefit is that the projection will keep classes as far apart as possible, so LDA is a good technique to reduce dimensionality before running another classification algorithm such as a Support Vector Machine (SVM) classifier discussed in the SVM lectures. \ No newline at end of file diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter8_65_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter8_65_1.png deleted file mode 100644 index 6b5a8cdd0..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter8_65_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter9.ipynb b/doc/LectureNotes/_build/jupyter_execute/chapter9.ipynb deleted file mode 100644 index c1260ff1d..000000000 --- a/doc/LectureNotes/_build/jupyter_execute/chapter9.ipynb +++ /dev/null @@ -1,1357 +0,0 @@ -{ - "cells": [ - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "# 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", - "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": [ - "\n", - "
\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", - "\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", - "\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", - "\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", - "\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", - "\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": [ - "\n", - "
\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": [ - "\n", - "
\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": [ - "\n", - "
\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", - "\n", - "The output of neuron $i$ in layer 2 is thus," - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\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": [ - "\n", - "
\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": [ - "\n", - "
\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": [ - "\n", - "
\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": [ - "We can generalize this expression to an MLP with $l$ hidden\n", - "layers. The complete functional form is," - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\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", - "\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": [ - "\n", - "
\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", - "\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": [ - "\n", - "
\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": [ - "\n", - "
\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", - "\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", - "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": [ - "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": 1, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "data": { - "image/png": "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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter9_29_0.png" - }, - "needs_background": "light" - }, - "output_type": "display_data" - }, - { - "data": { - "image/png": "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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter9_29_1.png" - }, - "needs_background": "light" - }, - "output_type": "display_data" - }, - { - "data": { - "image/png": "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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter9_29_2.png" - }, - "needs_background": "light" - }, - "output_type": "display_data" - }, - { - "data": { - "image/png": "iVBORw0KGgoAAAANSUhEUgAAAYQAAAEWCAYAAABmE+CbAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjMuMywgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/Il7ecAAAACXBIWXMAAAsTAAALEwEAmpwYAAAiXUlEQVR4nO3dd3xW9fn/8dfFFsIm7C2EjSIIrlZwVKQq4KijVXEUbWv79fetVRStftXW0dbWVq3iqqsqBURELDiCWlcFCwmbMGTvGWaS+/r9cR/auzEhIfe5R8j7+XjcD865z+c+nysn4bxz1ifm7oiIiFRLdQEiIpIeFAgiIgIoEEREJKBAEBERQIEgIiIBBYKIiAAKBKmkzOwOM3smZn6kma02s3wz62dm881scAXXvdLMzipl2V/M7P5g+ltmtrgifaSTo+XrkPgpECRUwc50X7Bj3hDsQDPiXOdgM1sT+567/9rdr49567fATe6e4e7/cvde7j4znn7L4u4fu3u3RPaRDMW/jsMFohzdFAiSCOe7ewZwPNAPuD0JfXYA5iehn5QzsxqprkGOTgoESRh33wBMJxoMAJjZSWb2qZntMLO5sad1zKyJmT1vZuvMbLuZTTazesA7QOvgqCPfzFqb2T1m9rKZ1TazfKA6MNfMlgXr+vdvuWZWzczGmNkyM9tqZuPNrElMv1ea2dfBsrHl/fqKH7kEfd5iZjlmttPMXjezOjHLzzOzOcHX/qmZ9Y1Zdqi+3Wa2wMxGxiwbZWafmNnvzWwrcE8Jtfz7VNaR1hbb1sxeAtoDbwXb+tbybg+p/BQIkjBm1hY4F8gL5tsAbwP3A02AW4CJZpYZfOQloC7QC2gO/N7d9wTrWBecDspw93WH+nD3A8HRCMBx7n5sCaX8FBgBnA60BrYDjwc19QT+DFwZLGsKtI3jy/4eMBToBPQFRgX99AOeA24I+ngKmGJmtYPPLQO+BTQE/g942cxaxax3ELAcaAH8KszaYrn7lcAqgqM8d3+4gn1JJaRAkESYbGa7gdXAJuDu4P0fANPcfZq7R9z9XWAWMCzY+Z0L3Oju2929wN0/DKmeG4Gx7r7G3Q8Q/Q374uDUy8XAVHf/KFh2FxCJo68/uvs6d98GvMV/jo5GA0+5+xfuXuTuLwAHgJMA3P1vweci7v46sBQYGLPede7+J3cvdPd9IdcmAigQJDFGuHt9YDDQHWgWvN8BuCQ4ZbLDzHYApwGtgHbANnffnoB6OgBvxPS5ECgi+tt2a6LBBUBwRLI1jr42xEzvBQ4dvXQAfl7sa28X9I+ZXRVzOmkH0Jv/bDdia0xAbSIA6OKUJIy7f2hmfyF6B9AIoju1l9z9h8XbBkcITcyskbvvKL6qOEtZDVzr7p+U0O96oEfMfF2ip3TCthr4lbt/43SPmXUAngbOBD5z9yIzmwNYTLOytsEeoqfbDmkZR60aArmK0hGCJNofgLPN7DjgZeB8MzvHzKqbWZ3ggmZbd19P9OLxE2bW2Mxqmtm3g3VsBJqaWcMK1vAk8Ktgx4uZZZrZ8GDZBOA8MzvNzGoB95KY/xdPAzea2SCLqmdm3zWz+kA9ojvhzUF91xA9QjgSc4ieemtiZi2Bm+OodSPQOY7PSyWlQJCEcvfNwIvAL919NTAcuIPozm818Av+83N4JVAALCJ67eHmYB2LgFeB5cEpldZHWMajwBRgRnBt43OiF2lx9/nAT4C/AuuJXnBeU8p6KszdZwE/BB4L+sgjuKjr7guA3wGfEd0Z9wG+cTRThpeAucBKYAbwehzlPgDcGWzrW+JYj1Qypj+QIyIioCMEEREJxB0IZtbOzLKDh2nmm9n/lNDGzOyPZpYXPBhzQrz9iohIuMK4y6gQ+Lm7fxVcIJttZu8G50UPORfoGrwGEX0QaFAIfYuISEjiPkJw9/Xu/lUwvZvoPd5tijUbDrzoUZ8DjYo9hSkiIikW6nMIZtaR6GBmXxRb1Ib/frBmTfDe+hLWMZroU53UqVOnf/v27cMsMXSRSIRq1dL/UozqDJfqDJfqDM+SJUu2uHtm2S1L4O6hvIg+9TgbuLCEZVOB02Lm3wcGlLXOrKwsT3fZ2dmpLqFcVGe4VGe4VGd4gFlewf14KFFnZjWBicAr7j6phCZriT6mf0jb4D0REUkTYdxlZMCzwEJ3f6SUZlOAq4K7jU4Cdnr0yVQREUkTYVxDOJXoE6a5wfgrEH0StT2Auz8JTAOGEX06cy9wTQj9iohUKZGIk3+wkAZ1aiZk/XEHgrv/g/8ehKukNk50eAAREamAvE35jJmYQ0adGjw/6kSiJ2fCld6Xy0VEqriCogiPZ+cx7NGPyducz/l9j3Qor/LT8NciImlq3tqd3DohhwXrd/HdPq2454JeZNavXfYHK0iBICKSZvYXFPHo+0sZ99FymtSrxZM/6M/Q3vH8iYvyUSCIiKSRL1du47YJOSzfsofvDWjL2GE9aVg3MReRi1MgiIikgfwDhTz890W8+NnXtG18DC9fN4jTujYr+4MhUiCIiKRY9uJNjJ2Uy/pd+7nm1I784pxu1K2V/N2zAkFEJEW27znIfVMXMOlfa+nSPIMJN55C/w6NU1aPAkFEJMncnWm5G7h7yjx27C3gZ2d04SdndKF2jeoprUuBICKSRJt27efOyfOYsWAjfdo05MVrB9GzdYNUlwUoEEREksLd+dusNdz39gIOFka4/dzuXHdaJ2pUT5/ngxUIIiIJtnrbXm6flMs/8rYwsFMTHrywD50zM1Jd1jcoEEREEqQo4rzw6Up+M30x1asZ943ozfcHtqdatfDHIQqDAkFEJAGWbtzNbRNz+GrVDgZ3y+TXI/vQutExqS7rsBQIIiIhKiiK8OTMZfzpgzzq1a7OHy49nuHHt07I6KRhUyCIiIQkd81OfjFhLos27Oa8vtHB6JplJG4wurApEERE4rS/oIjfv7eEpz9aTrOM2oy7sj/f6ZX4wejCpkAQEYnDF8u3MmZSLiu27OHSAe2447s9aHhMcgajC5sCQUSkAnbvL+Chvy/i5c9X0b5JXV65fhCndknuYHRhCyUQzOw54Dxgk7v3LmH5YOBNYEXw1iR3vzeMvkVEki170SbueCOXjbv2c/1pnfjf72SlZDC6sIX1FfwFeAx48TBtPnb380LqT0Qk6XYfdG5+7V9MnrOOrs0zeOJHp9CvfeoGowtbKIHg7h+ZWccw1iUikm7cnbdy1jP2473sj+zjf87syo+HHJvywejClsxjnJPNbC6wDrjF3ecnsW8RkQrZsDM6GN17CzfSqWE1/nzNqXRvmR6D0YXN3D2cFUWPEKaWcg2hARBx93wzGwY86u5dS1nPaGA0QGZmZv/x48eHUl+i5Ofnk5GRfmOSFKc6w6U6w5WOdbo7H64p5PXFBymKwMiutTi12QEa1E+vOosbMmTIbHcfUKEPu3soL6AjMK+cbVcCzcpql5WV5ekuOzs71SWUi+oMl+oMV7rVuXJLvl/21Gfe4bapfulTn/qKzfnunn51lgSY5RXcjyfllJGZtQQ2urub2UCgGrA1GX2LiJRXUcR5/pMV/HbGYmpWq8YDF/bhshPbVYphJ8IQ1m2nrwKDgWZmtga4G6gJ4O5PAhcDPzKzQmAfcFmQZCIiaWHxht3cOjGHuat3cFaP5tw/og8tG9ZJdVlJFdZdRpeXsfwxorelioiklYOFEZ6Ymcfj2XnUr1OTP17ej/P7tqoyRwWxKv+TFCIiFTRn9Q5um5DD4o27ueC41tx9fk+aVqLB6MKmQBCRKmffwSJ+N2Mxz32ygub16/Ds1QM4s0eLVJeVcgoEEalSPl22hTETc1m1bS9XDGrPmHO706BO5RyMLmwKBBGpEnbtL+CBaQt59Z+r6di0Lq/+8CROPrZpqstKKwoEETnqvbtgI3dOzmXz7gPc8O3O3HxWFsfUOrqGnQiDAkFEjlpb8g9wz5T5TM1ZT/eW9Xn6qgH0bdso1WWlLQWCiBx13J0356zj/96aT/6BQv737CxuPP1YatWolurS0poCQUSOKut27OPOyfP4YNEmjm/XiIcv7ktWi/qpLqtSUCCIyFEhEnFe/XIVD0xbRFHEueu8now6pSPVq1W9B8wqSoEgIpXeii17GDMxhy9WbOPULk15YGRf2jetm+qyKh0FgohUWoVFEZ77ZAW/m7GEWjWq8fBFfblkQNsqOexEGBQIIlIpLVy/i9sm5pCzZidn92zB/SN606JB1RqMLmwKBBGpVA4UFvH4B3k8MXMZjerW5PErTmBYn5Y6KgiBAkFEKo2vVm3ntgk5LN2Uz4X92nDXeT1pXK9Wqss6aigQRCTt7T1YyG+nL+H5T1fQqkEdnr/mRIZ0a57qso46CgQRSWuf5G1hzKQcVm/bx5UndeDWod2or8HoEkKBICJpaee+An799kJen7WaTs3q8frokxjUWYPRJZICQUTSzvT5G7hr8jy27jnIjacfy81ndaVOTQ1Gl2gKBBFJG5t3Rwejezt3PT1aNeDZq0+kT9uGqS6rygglEMzsOeA8YJO79y5huQGPAsOAvcAod/8qjL5FpPJzdyZ9tYZ7py5g74EifnFON0Z/uzM1q2swumQK6wjhL8BjwIulLD8X6Bq8BgF/Dv4VkSpu7Y59PDL7ALlb5tK/Q2MeuqgvXZpnpLqsKimUQHD3j8ys42GaDAdedHcHPjezRmbWyt3Xh9G/iFQ+kYjzyhdf8+A7iygsKuKe83ty1ckdqabB6FLGovvoEFYUDYSppZwymgo86O7/CObfB25z91kltB0NjAbIzMzsP378+FDqS5T8/HwyMtL/txnVGS7VGZ/1+RGen3+AJdsj9Gpaje91KqJDs/Srs7h03Z6xhgwZMtvdB1Tks2l3UdndxwHjALp16+aDBw9ObUFlmDlzJuleI6jOsKnOiiksijDu4+X84fOl1KlRjd9c3JuL+7flww8/TKs6S5Nu2zNsyQqEtUC7mPm2wXsiUkXMX7eT2ybmMG/tLob2asm9I3rRvL4Go0snyQqEKcBNZvYa0YvJO3X9QKRq2F9QxJ8+WMqTHy6ncd1a/Pn7J3Bun1apLktKENZtp68Cg4FmZrYGuBuoCeDuTwLTiN5ymkf0ttNrwuhXRNLb7K+3ceuEHJZt3sNFJ7TlrvN60KiuBqNLV2HdZXR5Gcsd+EkYfYlI+ttzoJDfTF/MC5+tpHXDY3jh2oGcnpWZ6rKkDGl3UVlEKrePlmzm9km5rNu5j6tO6sAvhnYno7Z2NZWBvksiEoqdewu47+0FTJi9hs6Z9Rh/w8mc2LFJqsuSI6BAEJG4/X3eeu56cz7b9hzkJ0OO5adnaDC6ykiBICIVtmn3fu5+cz7vzNtAr9YN+Ms1J9KrtQajq6wUCCJyxNydiV+t5b6pC9hXUMStQ7vxw29pMLrKToEgIkdk9ba93PFGLh8v3cKADo15UIPRHTUUCCJSLpGI8+JnK3l4+mIMuHd4L34wqIMGozuKKBBEpEx5m3Zz28RcZn+9ndOzMvnVyN60bVw31WVJyBQIIlKqgqII4z5azqPvLaVu7eo88r3jGNmvDdG/eSVHGwWCiJRo3tqd3DohhwXrd/Hdvq245/xeZNavneqyJIEUCCLyX/YXFPGH95by9MfLaVKvFk9d2Z9zerVMdVmSBAoEEfm3f67YxpiJOSzfsodLB7TjjmE9aFi3ZqrLkiRRIIgI+QcKeeidRbz0+de0bXwML183iNO6Nkt1WZJkCgSRKi578SbGTspl/a79XHtqJ245J4u6tbRrqIr0XReporbvOch9Uxcw6V9r6dI8gwk3nkL/Do1TXZakkAJBpIpxd6blbuDuKfPYsbeAn53RhZ+c0YXaNTQYXVWnQBCpQjbu2s9dk+cxY8FG+rRpyEvXDaJHqwapLkvShAJBpApwd8bPWs39by/kYGGE28/tznWndaKGBqOTGKH8NJjZUDNbbGZ5ZjamhOWjzGyzmc0JXteH0a+IlG3V1r384NkvuG1iLj1aNeDvN3+bG04/VmEg3xD3EYKZVQceB84G1gBfmtkUd19QrOnr7n5TvP2JSPkURZzpKwuY/P5HVK9m3D+iN1cMbK/B6KRUYZwyGgjkuftyADN7DRgOFA8EEUmSpRt3c+vEHP616iBndG/O/SN607rRMakuS9KcuXt8KzC7GBjq7tcH81cCg2KPBsxsFPAAsBlYAvw/d19dyvpGA6MBMjMz+48fPz6u+hItPz+fjIz0HwtedYYrXessjDhvLy/grWUF1KkBF3VyBneql/aD0aXr9iyuMtQ5ZMiQ2e4+oEIfdve4XsDFwDMx81cCjxVr0xSoHUzfAHxQnnVnZWV5usvOzk51CeWiOsOVjnXOWbXdz/n9h97htql+01+/8i2796dlnSVRneEBZnkF9+dhnDJaC7SLmW8bvBcbOltjZp8BHg6hXxEB9h0s4g/vLeHpj5eTWb82T181gLN7tkh1WVIJhREIXwJdzawT0SC4DLgitoGZtXL39cHsBcDCEPoVqfI+X76VMRNzWLl1L5cPbMftw3rQoI4Go5OKiTsQ3L3QzG4CpgPVgefcfb6Z3Uv00GUK8DMzuwAoBLYBo+LtV6Qq272/gAffWcQrX6yifZO6/PX6QZzSRYPRSXxCeTDN3acB04q998uY6duB28PoS6Sq+2DRRsa+MY+Nu/Zz/Wmd+Pl3unFMLQ07IfHTk8oilcS2PQe59635TJ6zjqwWGTzx/VPo116D0Ul4FAgiac7deStnPfdMmc/u/QXcfFZXfjy4C7Vq6EljCZcCQSSNbdi5nzsnz+O9hRs5rl0jHr6oL91a1k91WXKUUiCIpCF357UvV/PrtxdSEIlw53d7cM2pnaiuYSckgRQIImnm6617GDMxl8+Wb+Xkzk158KI+dGhaL9VlSRWgQBBJE0UR5/lPVvDbGYupWa0avx7Zh8sHtkv7YSfk6KFAEEkDizdEB6Obu3oHZ/Vozv0j+tCyYZ1UlyVVjAJBJIUOFkZ4PDuPJ2bmUb9OTf54eT/O79tKRwWSEgoEkRSZs3oHt06Yy5KN+Yw4vjW/PL8XTerVSnVZUoUpEESSbO/BQh6ZsYTnPllBiwZ1eG7UAM7orsHoJPUUCCJJ9GneFsZMymXVtr1cMag9t5/bnfoajE7ShAJBJAl27ivggWkLee3L1XRsWpfXRp/ESZ2bproskf+iQBBJsHcXbOTOybls3n2AG77dmZvPytJgdJKWFAgiCbI1/wD3vLWAt+auo3vL+jx91QD6tm2U6rJESqVAEAmZuzNl7jrumTKfPQeK+PnZWdxw+rEajE7SngJBJETrduzjzsnz+GDRJvq1jw5G17WFBqOTykGBIBKCSMT56z9X8eA7iyiKOHed15NRp3TUYHRSqSgQROK0YssexkzM4YsV2zi1S1MeGNmX9k3rproskSMWSiCY2VDgUaJ/U/kZd3+w2PLawItAf2ArcKm7rwyjb5FUKSyK8Ow/VvDIu0uoVaMaD1/Ul0sGtNWwE1JpxR0IZlYdeBw4G1gDfGlmU9x9QUyz64Dt7t7FzC4DHgIujbdvkVRZtauIkU98Su7anZzdswX3j+hNiwYajE4qtzCOEAYCee6+HMDMXgOGA7GBMBy4J5ieADxmZubufrgVb9rr/Ojl2SGUmDibN+/n9TXpXSOozjAVFEXIXrSfxvUiPH7FCQzr01JHBXJUCCMQ2gCrY+bXAINKa+PuhWa2E2gKbCm+MjMbDYwGqNOiEzkrN4ZQYuJEIhHW70nvGkF1hm1gc+f7vWpQb9tiPvxwcarLKVV+fj4zZ85MdRllUp3pIe0uKrv7OGAcQLdu3fyTO4eluKLDmzlzJoMHD051GWVSneFSneFSnekhjCdl1gLtYubbBu+V2MbMagANiV5cFhGRNBFGIHwJdDWzTmZWC7gMmFKszRTg6mD6YuCDsq4fiIhIcsV9yii4JnATMJ3obafPuft8M7sXmOXuU4BngZfMLA/YRjQ0REQkjYRyDcHdpwHTir33y5jp/cAlYfQlIiKJodG2REQEUCCIiEhAgSAiIoACQUREAgoEEREBFAgiIhJQIIiICKBAEBGRgAJBREQABYKIiAQUCCIiAigQREQkoEAQERFAgSAiIgEFgoiIAAoEEREJKBBERARQIIiISCCuQDCzJmb2rpktDf5tXEq7IjObE7ymxNOniIgkRrxHCGOA9929K/B+MF+Sfe5+fPC6IM4+RUQkAeINhOHAC8H0C8CIONcnIiIpYu5e8Q+b7XD3RsG0AdsPzRdrVwjMAQqBB9198mHWORoYDZCZmdl//PjxFa4vGfLz88nIyEh1GWVSneFSneFSneEZMmTIbHcfUKEPu/thX8B7wLwSXsOBHcXabi9lHW2CfzsDK4Fjy+rX3cnKyvJ0l52dneoSykV1hkt1hkt1hgeY5eXYv5b0qlGOwDirtGVmttHMWrn7ejNrBWwqZR1rg3+Xm9lMoB+wrBx5JSIiSRLvNYQpwNXB9NXAm8UbmFljM6sdTDcDTgUWxNmviIiELN5AeBA428yWAmcF85jZADN7JmjTA5hlZnOBbKLXEBQIIiJppsxTRofj7luBM0t4fxZwfTD9KdAnnn5ERCTx9KSyiIgACgQREQkoEEREBFAgiIhIQIEgIiKAAkFERAIKBBERARQIIiISUCCIiAigQBARkYACQUREAAWCiIgEFAgiIgIoEEREJKBAEBERQIEgIiIBBYKIiAAKBBERCcQVCGZ2iZnNN7OImQ04TLuhZrbYzPLMbEw8fYqISGLEe4QwD7gQ+Ki0BmZWHXgcOBfoCVxuZj3j7FdEREJWI54Pu/tCADM7XLOBQJ67Lw/avgYMBxbE07eIiITL3D3+lZjNBG5x91klLLsYGOru1wfzVwKD3P2mUtY1GhgNkJmZ2X/8+PFx15dI+fn5ZGRkpLqMMqnOcKnOcKnO8AwZMmS2u5d6Cv9wyjxCMLP3gJYlLBrr7m9WpNPDcfdxwDiAbt26+eDBg8PuIlQzZ84k3WsE1Rk21Rku1ZkeygwEdz8rzj7WAu1i5tsG74mISBpJxm2nXwJdzayTmdUCLgOmJKFfERE5AvHedjrSzNYAJwNvm9n04P3WZjYNwN0LgZuA6cBCYLy7z4+vbBERCVu8dxm9AbxRwvvrgGEx89OAafH0JSIiiaUnlUVEBFAgiIhIQIEgIiKAAkFERAIKBBERARQIIiISUCCIiAigQBARkYACQUREAAWCiIgEFAgiIgIoEEREJKBAEBERQIEgIiIBBYKIiAAKBBERCSgQREQEUCCIiEgg3r+pfImZzTeziJkNOEy7lWaWa2ZzzGxWPH2KiEhixPU3lYF5wIXAU+VoO8Tdt8TZn4iIJEhcgeDuCwHMLJxqREQkZZJ1DcGBGWY228xGJ6lPERE5Aubuh29g9h7QsoRFY939zaDNTOAWdy/x+oCZtXH3tWbWHHgX+Km7f1RK29HAaIDMzMz+48ePL+/XkhL5+flkZGSkuowyqc5wqc5wqc7wDBkyZLa7l3pN97DcPe4XMBMYUM629xANjzLbZmVlebrLzs5OdQnlojrDpTrDpTrDA8zyCu7LE37KyMzqmVn9Q9PAd4hejBYRkTQS722nI81sDXAy8LaZTQ/eb21m04JmLYB/mNlc4J/A2+7+93j6FRGR8MV7l9EbwBslvL8OGBZMLweOi6cfERFJPD2pLCIigAJBREQCCgQREQEUCCIiElAgiIgIoEAQEZGAAkFERAAFgoiIBBQIIiICKBBERCSgQBAREUCBICIiAQWCiIgACgQREQkoEEREBFAgiIhIQIEgIiKAAkFERAIKBBERAeIMBDP7jZktMrMcM3vDzBqV0m6omS02szwzGxNPnyIikhjxHiG8C/R2977AEuD24g3MrDrwOHAu0BO43Mx6xtmviIiELK5AcPcZ7l4YzH4OtC2h2UAgz92Xu/tB4DVgeDz9iohI+GqEuK5rgddLeL8NsDpmfg0wqLSVmNloYHQwe8DM5oVWYWI0A7akuohyUJ3hUp3hUp3h6VbRD5YZCGb2HtCyhEVj3f3NoM1YoBB4paKFHOLu44BxwXpnufuAeNeZSJWhRlCdYVOd4VKd4TGzWRX9bJmB4O5nldH5KOA84Ex39xKarAXaxcy3Dd4TEZE0Eu9dRkOBW4EL3H1vKc2+BLqaWSczqwVcBkyJp18REQlfvHcZPQbUB941szlm9iSAmbU2s2kAwUXnm4DpwEJgvLvPL+f6x8VZXzJUhhpBdYZNdYZLdYanwjVayWd5RESkqtGTyiIiAigQREQkkFaBUBmGwjCzS8xsvplFzKzU28/MbKWZ5QbXVip8G1hFHUGdKR1WxMyamNm7ZrY0+LdxKe2Kgm05x8ySdlNCWdvHzGqb2evB8i/MrGOyaitWR1l1jjKzzTHb8PoU1PicmW0q7dkii/pj8DXkmNkJya4xqKOsOgeb2c6YbfnLFNTYzsyyzWxB8P/8f0poc+Tb093T5gV8B6gRTD8EPFRCm+rAMqAzUAuYC/RMYo09iD74MRMYcJh2K4FmKdyWZdaZ6m0Z1PAwMCaYHlPS9zxYlp+CbVjm9gF+DDwZTF8GvJ6mdY4CHkt2bcVq+DZwAjCvlOXDgHcAA04CvkjTOgcDU1O8LVsBJwTT9YkOHVT8e37E2zOtjhC8EgyF4e4L3X1xsvqrqHLWmQ7DigwHXgimXwBGJLn/wynP9omtfwJwpplZEmuE9Pg+lsndPwK2HabJcOBFj/ocaGRmrZJT3X+Uo86Uc/f17v5VML2b6B2cbYo1O+LtmVaBUMy1RNOtuJKGwii+IdKBAzPMbHYwHEc6Sodt2cLd1wfTG4AWpbSrY2azzOxzMxuRnNLKtX3+3Sb4ZWYn0DQp1ZVQQ6C07+NFwamDCWbWroTlqZYOP4/ldbKZzTWzd8ysVyoLCU5T9gO+KLboiLdnmGMZlUuyh8KoiPLUWA6nuftaM2tO9DmNRcFvHqEJqc6EO1ydsTPu7mZW2n3QHYLt2Rn4wMxy3X1Z2LUexd4CXnX3A2Z2A9GjmjNSXFNl9RXRn8d8MxsGTAa6pqIQM8sAJgI3u/uueNeX9EDwSjAURlk1lnMda4N/N5nZG0QP60MNhBDqTMqwIoer08w2mlkrd18fHM5uKmUdh7bncjObSfQ3okQHQnm2z6E2a8ysBtAQ2Jrguoors053j63pGaLXbtJNpRjmJnbH6+7TzOwJM2vm7kkd9M7MahINg1fcfVIJTY54e6bVKSM7SobCMLN6Zlb/0DTRi+XpOGprOmzLKcDVwfTVwDeObMyssZnVDqabAacCC5JQW3m2T2z9FwMflPKLTCKVWWexc8cXED3nnG6mAFcFd8ecBOyMOZ2YNsys5aHrRGY2kOh+NKm/BAT9PwssdPdHSml25NszlVfKS7hynkf0nNec4HXo7o3WwLRiV8+XEP0NcWySaxxJ9FzcAWAjML14jUTv9pgbvOYnu8by1pnqbRn03xR4H1gKvAc0Cd4fADwTTJ8C5AbbMxe4Lon1fWP7APcS/aUFoA7wt+Bn959A52Rvw3LW+UDwszgXyAa6p6DGV4H1QEHws3kdcCNwY7DciP4xrWXB97nUu/hSXOdNMdvyc+CUFNR4GtHrlDkx+8th8W5PDV0hIiJAmp0yEhGR1FEgiIgIoEAQEZGAAkFERAAFgoiIBBQIIiICKBBERCSgQBA5AmZ2Y8w4+CvMLDvVNYmERQ+miVRAMI7MB8DD7v5WqusRCYOOEEQq5lGi4xYpDOSokfTRTkUqu2BE3g5Ex7QROWrolJHIETCz/kT/lsC33H17qusRCZNOGYkcmZuAJkB2cGH5mVQXJBIWHSGIiAigIwQREQkoEEREBFAgiIhIQIEgIiKAAkFERAIKBBERARQIIiIS+P96/jxVnk3KhwAAAABJRU5ErkJggg==\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapter9_29_3.png" - }, - "needs_background": "light" - }, - "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", - "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", - "\n", - "## Deriving the back propagation code for a multilayer perceptron model\n", - "\n", - "\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", - "\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": [ - "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": [ - "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", - "\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": [ - "\n", - "
\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": [ - "\n", - "
\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": [ - "\n", - "
\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", - "\n", - "### Setting up the Back propagation algorithm\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." - ] - } - ], - "metadata": { - "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.8.5" - } - }, - "nbformat": 4, - "nbformat_minor": 4 -} \ No newline at end of file diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter9.py b/doc/LectureNotes/_build/jupyter_execute/chapter9.py deleted file mode 100644 index 8972a6556..000000000 --- a/doc/LectureNotes/_build/jupyter_execute/chapter9.py +++ /dev/null @@ -1,840 +0,0 @@ -# Neural networks - -Artificial neural networks are computational systems that can learn to -perform tasks by considering examples, generally without being -programmed with any task-specific rules. It is supposed to mimic a -biological system, wherein neurons interact by sending signals in the -form of mathematical functions between layers. All layers can contain -an arbitrary number of neurons, and each connection is represented by -a weight variable. - - -The field of artificial neural networks has a long history of -development, and is closely connected with the advancement of computer -science and computers in general. A model of artificial neurons was -first developed by McCulloch and Pitts in 1943 to study signal -processing in the brain and has later been refined by others. The -general idea is to mimic neural networks in the human brain, which is -composed of billions of neurons that communicate with each other by -sending electrical signals. Each neuron accumulates its incoming -signals, which must exceed an activation threshold to yield an -output. If the threshold is not overcome, the neuron remains inactive, -i.e. has zero output. - -This behaviour has inspired a simple mathematical model for an artificial neuron. - - -
- -$$ -\begin{equation} - y = f\left(\sum_{i=1}^n w_ix_i\right) = f(u) -\label{artificialNeuron} \tag{1} -\end{equation} -$$ - -Here, the output $y$ of the neuron is the value of its activation function, which have as input -a weighted sum of signals $x_i, \dots ,x_n$ received by $n$ other neurons. - -Conceptually, it is helpful to divide neural networks into four -categories: -1. general purpose neural networks for supervised learning, - -2. neural networks designed specifically for image processing, the most prominent example of this class being Convolutional Neural Networks (CNNs), - -3. neural networks for sequential data such as Recurrent Neural Networks (RNNs), and - -4. neural networks for unsupervised learning such as Deep Boltzmann Machines. - -In natural science, DNNs and CNNs have already found numerous -applications. In statistical physics, they have been applied to detect -phase transitions in 2D Ising and Potts models, lattice gauge -theories, and different phases of polymers, or solving the -Navier-Stokes equation in weather forecasting. Deep learning has also -found interesting applications in quantum physics. Various quantum -phase transitions can be detected and studied using DNNs and CNNs, -topological phases, and even non-equilibrium many-body -localization. Representing quantum states as DNNs quantum state -tomography are among some of the impressive achievements to reveal the -potential of DNNs to facilitate the study of quantum systems. - -In quantum information theory, it has been shown that one can perform -gate decompositions with the help of neural. - -The applications are not limited to the natural sciences. There is a -plethora of applications in essentially all disciplines, from the -humanities to life science and medicine. - - -An artificial neural network (ANN), is a computational model that -consists of layers of connected neurons, or nodes or units. We will -refer to these interchangeably as units or nodes, and sometimes as -neurons. - -It is supposed to mimic a biological nervous system by letting each -neuron interact with other neurons by sending signals in the form of -mathematical functions between layers. A wide variety of different -ANNs have been developed, but most of them consist of an input layer, -an output layer and eventual layers in-between, called *hidden -layers*. All layers can contain an arbitrary number of nodes, and each -connection between two nodes is associated with a weight variable. - -Neural networks (also called neural nets) are neural-inspired -nonlinear models for supervised learning. As we will see, neural nets -can be viewed as natural, more powerful extensions of supervised -learning methods such as linear and logistic regression and soft-max -methods we discussed earlier. - - -### Feed-forward neural networks - -The feed-forward neural network (FFNN) was the first and simplest type -of ANNs that were devised. In this network, the information moves in -only one direction: forward through the layers. - -Nodes are represented by circles, while the arrows display the -connections between the nodes, including the direction of information -flow. Additionally, each arrow corresponds to a weight variable -(figure to come). We observe that each node in a layer is connected -to *all* nodes in the subsequent layer, making this a so-called -*fully-connected* FFNN. - - - -### Convolutional Neural Network - -A different variant of FFNNs are *convolutional neural networks* -(CNNs), which have a connectivity pattern inspired by the animal -visual cortex. Individual neurons in the visual cortex only respond to -stimuli from small sub-regions of the visual field, called a receptive -field. This makes the neurons well-suited to exploit the strong -spatially local correlation present in natural images. The response of -each neuron can be approximated mathematically as a convolution -operation. (figure to come) - -Convolutional neural networks emulate the behaviour of neurons in the -visual cortex by enforcing a *local* connectivity pattern between -nodes of adjacent layers: Each node in a convolutional layer is -connected only to a subset of the nodes in the previous layer, in -contrast to the fully-connected FFNN. Often, CNNs consist of several -convolutional layers that learn local features of the input, with a -fully-connected layer at the end, which gathers all the local data and -produces the outputs. They have wide applications in image and video -recognition. - -### Recurrent neural networks - -So far we have only mentioned ANNs where information flows in one -direction: forward. *Recurrent neural networks* on the other hand, -have connections between nodes that form directed *cycles*. This -creates a form of internal memory which are able to capture -information on what has been calculated before; the output is -dependent on the previous computations. Recurrent NNs make use of -sequential information by performing the same task for every element -in a sequence, where each element depends on previous elements. An -example of such information is sentences, making recurrent NNs -especially well-suited for handwriting and speech recognition. - -### Other types of networks - -There are many other kinds of ANNs that have been developed. One type -that is specifically designed for interpolation in multidimensional -space is the radial basis function (RBF) network. RBFs are typically -made up of three layers: an input layer, a hidden layer with -non-linear radial symmetric activation functions and a linear output -layer (''linear'' here means that each node in the output layer has a -linear activation function). The layers are normally fully-connected -and there are no cycles, thus RBFs can be viewed as a type of -fully-connected FFNN. They are however usually treated as a separate -type of NN due the unusual activation functions. - - -## Multilayer perceptrons - -One uses often so-called fully-connected feed-forward neural networks -with three or more layers (an input layer, one or more hidden layers -and an output layer) consisting of neurons that have non-linear -activation functions. - -Such networks are often called *multilayer perceptrons* (MLPs). - - -According to the *Universal approximation theorem*, a feed-forward -neural network with just a single hidden layer containing a finite -number of neurons can approximate a continuous multidimensional -function to arbitrary accuracy, assuming the activation function for -the hidden layer is a **non-constant, bounded and -monotonically-increasing continuous function**. - -Note that the requirements on the activation function only applies to -the hidden layer, the output nodes are always assumed to be linear, so -as to not restrict the range of output values. - - - -The output $y$ is produced via the activation function $f$ - -$$ -y = f\left(\sum_{i=1}^n w_ix_i + b_i\right) = f(z), -$$ - -This function receives $x_i$ as inputs. -Here the activation $z=(\sum_{i=1}^n w_ix_i+b_i)$. -In an FFNN of such neurons, the *inputs* $x_i$ are the *outputs* of -the neurons in the preceding layer. Furthermore, an MLP is -fully-connected, which means that each neuron receives a weighted sum -of the outputs of *all* neurons in the previous layer. - - -First, for each node $i$ in the first hidden layer, we calculate a weighted sum $z_i^1$ of the input coordinates $x_j$, - - -
- -$$ -\begin{equation} z_i^1 = \sum_{j=1}^{M} w_{ij}^1 x_j + b_i^1 -\label{_auto1} \tag{2} -\end{equation} -$$ - -Here $b_i$ is the so-called bias which is normally needed in -case of zero activation weights or inputs. How to fix the biases and -the weights will be discussed below. The value of $z_i^1$ is the -argument to the activation function $f_i$ of each node $i$, The -variable $M$ stands for all possible inputs to a given node $i$ in the -first layer. We define the output $y_i^1$ of all neurons in layer 1 as - - -
- -$$ -\begin{equation} - y_i^1 = f(z_i^1) = f\left(\sum_{j=1}^M w_{ij}^1 x_j + b_i^1\right) -\label{outputLayer1} \tag{3} -\end{equation} -$$ - -where we assume that all nodes in the same layer have identical -activation functions, hence the notation $f$. In general, we could assume in the more general case that different layers have different activation functions. -In this case we would identify these functions with a superscript $l$ for the $l$-th layer, - - -
- -$$ -\begin{equation} - 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) -\label{generalLayer} \tag{4} -\end{equation} -$$ - -where $N_l$ is the number of nodes in layer $l$. When the output of -all the nodes in the first hidden layer are computed, the values of -the subsequent layer can be calculated and so forth until the output -is obtained. - - - - -The output of neuron $i$ in layer 2 is thus, - - -
- -$$ -\begin{equation} - y_i^2 = f^2\left(\sum_{j=1}^N w_{ij}^2 y_j^1 + b_i^2\right) -\label{_auto2} \tag{5} -\end{equation} -$$ - - -
- -$$ -\begin{equation} - = 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] -\label{outputLayer2} \tag{6} -\end{equation} -$$ - -where we have substituted $y_k^1$ with the inputs $x_k$. Finally, the ANN output reads - - -
- -$$ -\begin{equation} - y_i^3 = f^3\left(\sum_{j=1}^N w_{ij}^3 y_j^2 + b_i^3\right) -\label{_auto3} \tag{7} -\end{equation} -$$ - - -
- -$$ -\begin{equation} - = 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) - + b_1^3\right] -\label{_auto4} \tag{8} -\end{equation} -$$ - -We can generalize this expression to an MLP with $l$ hidden -layers. The complete functional form is, - - -
- -$$ -\begin{equation} -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] -\label{completeNN} \tag{9} -\end{equation} -$$ - -which illustrates a basic property of MLPs: The only independent -variables are the input values $x_n$. - - -This confirms that an MLP, despite its quite convoluted mathematical -form, is nothing more than an analytic function, specifically a -mapping of real-valued vectors $\hat{x} \in \mathbb{R}^n \rightarrow -\hat{y} \in \mathbb{R}^m$. - -Furthermore, the flexibility and universality of an MLP can be -illustrated by realizing that the expression is essentially a nested -sum of scaled activation functions of the form - - -
- -$$ -\begin{equation} - f(x) = c_1 f(c_2 x + c_3) + c_4 -\label{_auto5} \tag{10} -\end{equation} -$$ - -where the parameters $c_i$ are weights and biases. By adjusting these -parameters, the activation functions can be shifted up and down or -left and right, change slope or be rescaled which is the key to the -flexibility of a neural network. - - -We can introduce a more convenient notation for the activations in an A NN. - -Additionally, we can represent the biases and activations -as layer-wise column vectors $\hat{b}_l$ and $\hat{y}_l$, so that the $i$-th element of each vector -is the bias $b_i^l$ and activation $y_i^l$ of node $i$ in layer $l$ respectively. - -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. -With this notation, the sum becomes a matrix-vector multiplication, and we can write -the equation for the activations of hidden layer 2 (assuming three nodes for simplicity) as - - -
- -$$ -\begin{equation} - \hat{y}_2 = f_2(\mathrm{W}_2 \hat{y}_{1} + \hat{b}_{2}) = - f_2\left(\left[\begin{array}{ccc} - w^2_{11} &w^2_{12} &w^2_{13} \\ - w^2_{21} &w^2_{22} &w^2_{23} \\ - w^2_{31} &w^2_{32} &w^2_{33} \\ - \end{array} \right] \cdot - \left[\begin{array}{c} - y^1_1 \\ - y^1_2 \\ - y^1_3 \\ - \end{array}\right] + - \left[\begin{array}{c} - b^2_1 \\ - b^2_2 \\ - b^2_3 \\ - \end{array}\right]\right). -\label{_auto6} \tag{11} -\end{equation} -$$ - -### Matrix-vector notation and activation - -The activation of node $i$ in layer 2 is - - -
- -$$ -\begin{equation} - 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) = - f_2\left(\sum_{j=1}^3 w^2_{ij} y_j^1 + b^2_i\right). -\label{_auto7} \tag{12} -\end{equation} -$$ - -This is not just a convenient and compact notation, but also a useful -and intuitive way to think about MLPs: The output is calculated by a -series of matrix-vector multiplications and vector additions that are -used as input to the activation functions. For each operation -$\mathrm{W}_l \hat{y}_{l-1}$ we move forward one layer. - - - -### Activation functions - -A property that characterizes a neural network, other than its -connectivity, is the choice of activation function(s). As described -in, the following restrictions are imposed on an activation function -for a FFNN to fulfill the universal approximation theorem - - * Non-constant - - * Bounded - - * Monotonically-increasing - - * Continuous - -The second requirement excludes all linear functions. Furthermore, in -a MLP with only linear activation functions, each layer simply -performs a linear transformation of its inputs. - -Regardless of the number of layers, the output of the NN will be -nothing but a linear function of the inputs. Thus we need to introduce -some kind of non-linearity to the NN to be able to fit non-linear -functions Typical examples are the logistic *Sigmoid* - -$$ -f(x) = \frac{1}{1 + e^{-x}}, -$$ - -and the *hyperbolic tangent* function - -$$ -f(x) = \tanh(x) -$$ - -The *sigmoid* function are more biologically plausible because the -output of inactive neurons are zero. Such activation function are -called *one-sided*. However, it has been shown that the hyperbolic -tangent performs better than the sigmoid for training MLPs. has -become the most popular for *deep neural networks* - -%matplotlib inline - -"""The sigmoid function (or the logistic curve) is a -function that takes any real number, z, and outputs a number (0,1). -It is useful in neural networks for assigning weights on a relative scale. -The value z is the weighted sum of parameters involved in the learning algorithm.""" - -import numpy -import matplotlib.pyplot as plt -import math as mt - -z = numpy.arange(-5, 5, .1) -sigma_fn = numpy.vectorize(lambda z: 1/(1+numpy.exp(-z))) -sigma = sigma_fn(z) - -fig = plt.figure() -ax = fig.add_subplot(111) -ax.plot(z, sigma) -ax.set_ylim([-0.1, 1.1]) -ax.set_xlim([-5,5]) -ax.grid(True) -ax.set_xlabel('z') -ax.set_title('sigmoid function') - -plt.show() - -"""Step Function""" -z = numpy.arange(-5, 5, .02) -step_fn = numpy.vectorize(lambda z: 1.0 if z >= 0.0 else 0.0) -step = step_fn(z) - -fig = plt.figure() -ax = fig.add_subplot(111) -ax.plot(z, step) -ax.set_ylim([-0.5, 1.5]) -ax.set_xlim([-5,5]) -ax.grid(True) -ax.set_xlabel('z') -ax.set_title('step function') - -plt.show() - -"""Sine Function""" -z = numpy.arange(-2*mt.pi, 2*mt.pi, 0.1) -t = numpy.sin(z) - -fig = plt.figure() -ax = fig.add_subplot(111) -ax.plot(z, t) -ax.set_ylim([-1.0, 1.0]) -ax.set_xlim([-2*mt.pi,2*mt.pi]) -ax.grid(True) -ax.set_xlabel('z') -ax.set_title('sine function') - -plt.show() - -"""Plots a graph of the squashing function used by a rectified linear -unit""" -z = numpy.arange(-2, 2, .1) -zero = numpy.zeros(len(z)) -y = numpy.max([zero, z], axis=0) - -fig = plt.figure() -ax = fig.add_subplot(111) -ax.plot(z, y) -ax.set_ylim([-2.0, 2.0]) -ax.set_xlim([-2.0, 2.0]) -ax.grid(True) -ax.set_xlabel('z') -ax.set_title('Rectified linear unit') - -plt.show() - -## The multilayer perceptron (MLP) - -The multilayer perceptron is a very popular, and easy to implement approach, to deep learning. It consists of -1. A neural network with one or more layers of nodes between the input and the output nodes. - -2. The multilayer network structure, or architecture, or topology, consists of an input layer, one or more hidden layers, and one output layer. - -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. - -As a convention it is normal to call a network with one layer of input units, one layer of hidden -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. - -For an MLP network there is no direct connection between the output nodes/neurons/units and the input nodes/neurons/units. -Hereafter we will call the various entities of a layer for nodes. -There are also no connections within a single layer. - -The number of input nodes does not need to equal the number of output -nodes. This applies also to the hidden layers. Each layer may have its -own number of nodes and activation functions. - -The hidden layers have their name from the fact that they are not -linked to observables and as we will see below when we define the -so-called activation $\hat{z}$, we can think of this as a basis -expansion of the original inputs $\hat{x}$. The difference however -between neural networks and say linear regression is that now these -basis functions (which will correspond to the weights in the network) -are learned from data. This results in an important difference between -neural networks and deep learning approaches on one side and methods -like logistic regression or linear regression and their modifications on the other side. - - -### From one to many layers, the universal approximation theorem - -A neural network with only one layer, what we called the simple -perceptron, is best suited if we have a standard binary model with -clear (linear) boundaries between the outcomes. As such it could -equally well be replaced by standard linear regression or logistic -regression. Networks with one or more hidden layers approximate -systems with more complex boundaries. - -As stated earlier, -an important theorem in studies of neural networks, restated without -proof here, is the [universal approximation -theorem](http://citeseerx.ist.psu.edu/viewdoc/download?doi=10.1.1.441.7873&rep=rep1&type=pdf). - -It states that a feed-forward network with a single hidden layer -containing a finite number of neurons can approximate continuous -functions on compact subsets of real functions. The theorem thus -states that simple neural networks can represent a wide variety of -interesting functions when given appropriate parameters. It is the -multilayer feedforward architecture itself which gives neural networks -the potential of being universal approximators. - - - -## Deriving the back propagation code for a multilayer perceptron model - - - -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. -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. -This leads us to the famous [back propagation algorithm](https://www.nature.com/articles/323533a0). - -The questions we want to ask are how do changes in the biases and the -weights in our network change the cost function and how can we use the -final output to modify the weights? - -To derive these equations let us start with a plain regression problem -and define our cost function as - -$$ -{\cal C}(\hat{W}) = \frac{1}{2}\sum_{i=1}^n\left(y_i - t_i\right)^2, -$$ - -where the $t_i$s are our $n$ targets (the values we want to -reproduce), while the outputs of the network after having propagated -all inputs $\hat{x}$ are given by $y_i$. Below we will demonstrate -how the basic equations arising from the back propagation algorithm -can be modified in order to study classification problems with $K$ -classes. - - -With our definition of the targets $\hat{t}$, the outputs of the -network $\hat{y}$ and the inputs $\hat{x}$ we -define now the activation $z_j^l$ of node/neuron/unit $j$ of the -$l$-th layer as a function of the bias, the weights which add up from -the previous layer $l-1$ and the forward passes/outputs -$\hat{a}^{l-1}$ from the previous layer as - -$$ -z_j^l = \sum_{i=1}^{M_{l-1}}w_{ij}^la_i^{l-1}+b_j^l, -$$ - -where $b_k^l$ are the biases from layer $l$. Here $M_{l-1}$ -represents the total number of nodes/neurons/units of layer $l-1$. The -figure here illustrates this equation. We can rewrite this in a more -compact form as the matrix-vector products we discussed earlier, - -$$ -\hat{z}^l = \left(\hat{W}^l\right)^T\hat{a}^{l-1}+\hat{b}^l. -$$ - -With the activation values $\hat{z}^l$ we can in turn define the -output of layer $l$ as $\hat{a}^l = f(\hat{z}^l)$ where $f$ is our -activation function. In the examples here we will use the sigmoid -function discussed in our logistic regression lectures. We will also use the same activation function $f$ for all layers -and their nodes. It means we have - -$$ -a_j^l = f(z_j^l) = \frac{1}{1+\exp{-(z_j^l)}}. -$$ - -### Derivatives and the chain rule - -From the definition of the activation $z_j^l$ we have - -$$ -\frac{\partial z_j^l}{\partial w_{ij}^l} = a_i^{l-1}, -$$ - -and - -$$ -\frac{\partial z_j^l}{\partial a_i^{l-1}} = w_{ji}^l. -$$ - -With our definition of the activation function we have that (note that this function depends only on $z_j^l$) - -$$ -\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)). -$$ - -With these definitions we can now compute the derivative of the cost function in terms of the weights. - -Let us specialize to the output layer $l=L$. Our cost function is - -$$ -{\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, -$$ - -The derivative of this function with respect to the weights is - -$$ -\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}}, -$$ - -The last partial derivative can easily be computed and reads (by applying the chain rule) - -$$ -\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}, -$$ - -### Bringing it together, first back propagation equation - -We have thus - -$$ -\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}, -$$ - -Defining - -$$ -\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)}, -$$ - -and using the Hadamard product of two vectors we can write this as - -$$ -\hat{\delta}^L = f'(\hat{z}^L)\circ\frac{\partial {\cal C}}{\partial (\hat{a}^L)}. -$$ - -This is an important expression. The second term on the right handside -measures how fast the cost function is changing as a function of the $j$th -output activation. If, for example, the cost function doesn't depend -much on a particular output node $j$, then $\delta_j^L$ will be small, -which is what we would expect. The first term on the right, measures -how fast the activation function $f$ is changing at a given activation -value $z_j^L$. - -Notice that everything in the above equations is easily computed. In -particular, we compute $z_j^L$ while computing the behaviour of the -network, and it is only a small additional overhead to compute -$f'(z^L_j)$. The exact form of the derivative with respect to the -output depends on the form of the cost function. -However, provided the cost function is known there should be little -trouble in calculating - -$$ -\frac{\partial {\cal C}}{\partial (a_j^L)} -$$ - -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 - -$$ -\frac{\partial{\cal C}(\hat{W^L})}{\partial w_{jk}^L} = \delta_j^La_k^{L-1}. -$$ - -It is also easy to see that our previous equation can be written as - -$$ -\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}, -$$ - -which can also be interpreted as the partial derivative of the cost function with respect to the biases $b_j^L$, namely - -$$ -\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}, -$$ - -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. - -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 - -**The starting equations.** - - -
- -$$ -\begin{equation} -\frac{\partial{\cal C}(\hat{W^L})}{\partial w_{jk}^L} = \delta_j^La_k^{L-1}, -\label{_auto8} \tag{13} -\end{equation} -$$ - -and - - -
- -$$ -\begin{equation} -\delta_j^L = f'(z_j^L)\frac{\partial {\cal C}}{\partial (a_j^L)}, -\label{_auto9} \tag{14} -\end{equation} -$$ - -and - - -
- -$$ -\begin{equation} -\delta_j^L = \frac{\partial {\cal C}}{\partial b_j^L}, -\label{_auto10} \tag{15} -\end{equation} -$$ - -An interesting consequence of the above equations is that when the -activation $a_k^{L-1}$ is small, the gradient term, that is the -derivative of the cost function with respect to the weights, will also -tend to be small. We say then that the weight learns slowly, meaning -that it changes slowly when we minimize the weights via say gradient -descent. In this case we say the system learns slowly. - -Another interesting feature is that is when the activation function, -represented by the sigmoid function here, is rather flat when we move towards -its end values $0$ and $1$ (see the above Python codes). In these -cases, the derivatives of the activation function will also be close -to zero, meaning again that the gradients will be small and the -network learns slowly again. - - - -We need a fourth equation and we are set. We are going to propagate -backwards in order to the determine the weights and biases. In order -to do so we need to represent the error in the layer before the final -one $L-1$ in terms of the errors in the final output layer. - -### Final back propagating equation - -We have that (replacing $L$ with a general layer $l$) - -$$ -\delta_j^l =\frac{\partial {\cal C}}{\partial z_j^l}. -$$ - -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 - -$$ -\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}}, -$$ - -and recalling that - -$$ -z_j^{l+1} = \sum_{i=1}^{M_{l}}w_{ij}^{l+1}a_i^{l}+b_j^{l+1}, -$$ - -with $M_l$ being the number of nodes in layer $l$, we obtain - -$$ -\delta_j^l =\sum_k \delta_k^{l+1}w_{kj}^{l+1}f'(z_j^l), -$$ - -This is our final equation. - -We are now ready to set up the algorithm for back propagation and learning the weights and biases. - - -### Setting up the Back propagation algorithm - -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. - -First, we set up the input data $\hat{x}$ and the activations -$\hat{z}_1$ of the input layer and compute the activation function and -the pertinent outputs $\hat{a}^1$. - - - -Secondly, we perform then the feed forward till we reach the output -layer and compute all $\hat{z}_l$ of the input layer and compute the -activation function and the pertinent outputs $\hat{a}^l$ for -$l=2,3,\dots,L$. - - - -Thereafter we compute the ouput error $\hat{\delta}^L$ by computing all - -$$ -\delta_j^L = f'(z_j^L)\frac{\partial {\cal C}}{\partial (a_j^L)}. -$$ - -Then we compute the back propagate error for each $l=L-1,L-2,\dots,2$ as - -$$ -\delta_j^l = \sum_k \delta_k^{l+1}w_{kj}^{l+1}f'(z_j^l). -$$ - -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 - -$$ -w_{jk}^l\leftarrow = w_{jk}^l- \eta \delta_j^la_k^{l-1}, -$$ - -$$ -b_j^l \leftarrow b_j^l-\eta \frac{\partial {\cal C}}{\partial b_j^l}=b_j^l-\eta \delta_j^l, -$$ - -The parameter $\eta$ is the learning parameter discussed in connection with the gradient descent methods. -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. \ No newline at end of file diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter9_29_0.png b/doc/LectureNotes/_build/jupyter_execute/chapter9_29_0.png deleted file mode 100644 index fbb1365d2..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter9_29_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter9_29_1.png b/doc/LectureNotes/_build/jupyter_execute/chapter9_29_1.png deleted file mode 100644 index 52b754f2a..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter9_29_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter9_29_2.png b/doc/LectureNotes/_build/jupyter_execute/chapter9_29_2.png deleted file mode 100644 index def243ae9..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter9_29_2.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapter9_29_3.png b/doc/LectureNotes/_build/jupyter_execute/chapter9_29_3.png deleted file mode 100644 index 164dcef76..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapter9_29_3.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapteroptimization.ipynb b/doc/LectureNotes/_build/jupyter_execute/chapteroptimization.ipynb deleted file mode 100644 index b18caef4c..000000000 --- a/doc/LectureNotes/_build/jupyter_execute/chapteroptimization.ipynb +++ /dev/null @@ -1,3093 +0,0 @@ -{ - "cells": [ - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "# Optimization, the central part of any Machine Learning algortithm\n", - "\n", - "Almost every problem in machine learning and data science starts with\n", - "a dataset $X$, a model $g(\\beta)$, which is a function of the\n", - "parameters $\\beta$ and a cost function $C(X, g(\\beta))$ that allows\n", - "us to judge how well the model $g(\\beta)$ explains the observations\n", - "$X$. The model is fit by finding the values of $\\beta$ that minimize\n", - "the cost function. Ideally we would be able to solve for $\\beta$\n", - "analytically, however this is not possible in general and we must use\n", - "some approximative/numerical method to compute the minimum.\n", - "\n", - "\n", - "\n", - "\n", - "In our discussion on Logistic Regression we studied the \n", - "case of\n", - "two classes, with $y_i$ either\n", - "$0$ or $1$. Furthermore we assumed also that we have only two\n", - "parameters $\\beta$ in our fitting, that is we\n", - "defined probabilities" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{align*}\n", - "p(y_i=1|x_i,\\boldsymbol{\\beta}) &= \\frac{\\exp{(\\beta_0+\\beta_1x_i)}}{1+\\exp{(\\beta_0+\\beta_1x_i)}},\\nonumber\\\\\n", - "p(y_i=0|x_i,\\boldsymbol{\\beta}) &= 1 - p(y_i=1|x_i,\\boldsymbol{\\beta}),\n", - "\\end{align*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $\\boldsymbol{\\beta}$ are the weights we wish to extract from data, in our case $\\beta_0$ and $\\beta_1$. \n", - "\n", - "\n", - "\n", - "Our compact equations used a definition of a vector $\\boldsymbol{y}$ with $n$\n", - "elements $y_i$, an $n\\times p$ matrix $\\boldsymbol{X}$ which contains the\n", - "$x_i$ values and a vector $\\boldsymbol{p}$ of fitted probabilities\n", - "$p(y_i\\vert x_i,\\boldsymbol{\\beta})$. We rewrote in a more compact form\n", - "the first derivative of the cost function as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial \\mathcal{C}(\\boldsymbol{\\beta})}{\\partial \\boldsymbol{\\beta}} = -\\boldsymbol{X}^T\\left(\\boldsymbol{y}-\\boldsymbol{p}\\right).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "If we in addition define a diagonal matrix $\\boldsymbol{W}$ with elements \n", - "$p(y_i\\vert x_i,\\boldsymbol{\\beta})(1-p(y_i\\vert x_i,\\boldsymbol{\\beta})$, we can obtain a compact expression of the second derivative as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial^2 \\mathcal{C}(\\boldsymbol{\\beta})}{\\partial \\boldsymbol{\\beta}\\partial \\boldsymbol{\\beta}^T} = \\boldsymbol{X}^T\\boldsymbol{W}\\boldsymbol{X}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "This defines what is called the Hessian matrix.\n", - "\n", - "\n", - "\n", - "If we can set up these equations, Newton-Raphson's iterative method is normally the method of choice. It requires however that we can compute in an efficient way the matrices that define the first and second derivatives. \n", - "\n", - "Our iterative scheme is then given by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{\\beta}^{\\mathrm{new}} = \\boldsymbol{\\beta}^{\\mathrm{old}}-\\left(\\frac{\\partial^2 \\mathcal{C}(\\boldsymbol{\\beta})}{\\partial \\boldsymbol{\\beta}\\partial \\boldsymbol{\\beta}^T}\\right)^{-1}_{\\boldsymbol{\\beta}^{\\mathrm{old}}}\\times \\left(\\frac{\\partial \\mathcal{C}(\\boldsymbol{\\beta})}{\\partial \\boldsymbol{\\beta}}\\right)_{\\boldsymbol{\\beta}^{\\mathrm{old}}},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "or in matrix form as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{\\beta}^{\\mathrm{new}} = \\boldsymbol{\\beta}^{\\mathrm{old}}-\\left(\\boldsymbol{X}^T\\boldsymbol{W}\\boldsymbol{X} \\right)^{-1}\\times \\left(-\\boldsymbol{X}^T(\\boldsymbol{y}-\\boldsymbol{p}) \\right)_{\\boldsymbol{\\beta}^{\\mathrm{old}}}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The right-hand side is computed with the old values of $\\beta$. \n", - "\n", - "If we can compute these matrices, in particular the Hessian, the above is often the easiest method to implement. \n", - "\n", - "\n", - "Let us quickly remind ourselves how we derive the above method.\n", - "\n", - "Perhaps the most celebrated of all one-dimensional root-finding\n", - "routines is Newton's method, also called the Newton-Raphson\n", - "method. This method requires the evaluation of both the\n", - "function $f$ and its derivative $f'$ at arbitrary points. \n", - "If you can only calculate the derivative\n", - "numerically and/or your function is not of the smooth type, we\n", - "normally discourage the use of this method.\n", - "\n", - "\n", - "\n", - "The Newton-Raphson formula consists geometrically of extending the\n", - "tangent line at a current point until it crosses zero, then setting\n", - "the next guess to the abscissa of that zero-crossing. The mathematics\n", - "behind this method is rather simple. Employing a Taylor expansion for\n", - "$x$ sufficiently close to the solution $s$, we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "f(s)=0=f(x)+(s-x)f'(x)+\\frac{(s-x)^2}{2}f''(x) +\\dots.\n", - " \\label{eq:taylornr} \\tag{1}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "For small enough values of the function and for well-behaved\n", - "functions, the terms beyond linear are unimportant, hence we obtain" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "f(x)+(s-x)f'(x)\\approx 0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "yielding" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "s\\approx x-\\frac{f(x)}{f'(x)}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Having in mind an iterative procedure, it is natural to start iterating with" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "x_{n+1}=x_n-\\frac{f(x_n)}{f'(x_n)}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The above is Newton-Raphson's method. It has a simple geometric\n", - "interpretation, namely $x_{n+1}$ is the point where the tangent from\n", - "$(x_n,f(x_n))$ crosses the $x$-axis. Close to the solution,\n", - "Newton-Raphson converges fast to the desired result. However, if we\n", - "are far from a root, where the higher-order terms in the series are\n", - "important, the Newton-Raphson formula can give grossly inaccurate\n", - "results. For instance, the initial guess for the root might be so far\n", - "from the true root as to let the search interval include a local\n", - "maximum or minimum of the function. If an iteration places a trial\n", - "guess near such a local extremum, so that the first derivative nearly\n", - "vanishes, then Newton-Raphson may fail totally\n", - "\n", - "\n", - "\n", - "\n", - "Newton's method can be generalized to systems of several non-linear equations\n", - "and variables. Consider the case with two equations" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{array}{cc} f_1(x_1,x_2) &=0\\\\\n", - " f_2(x_1,x_2) &=0,\\end{array}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which we Taylor expand to obtain" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{array}{cc} 0=f_1(x_1+h_1,x_2+h_2)=&f_1(x_1,x_2)+h_1\n", - " \\partial f_1/\\partial x_1+h_2\n", - " \\partial f_1/\\partial x_2+\\dots\\\\\n", - " 0=f_2(x_1+h_1,x_2+h_2)=&f_2(x_1,x_2)+h_1\n", - " \\partial f_2/\\partial x_1+h_2\n", - " \\partial f_2/\\partial x_2+\\dots\n", - " \\end{array}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Defining the Jacobian matrix $\\boldsymbol{J}$ we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{J}=\\left( \\begin{array}{cc}\n", - " \\partial f_1/\\partial x_1 & \\partial f_1/\\partial x_2 \\\\\n", - " \\partial f_2/\\partial x_1 &\\partial f_2/\\partial x_2\n", - " \\end{array} \\right),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "we can rephrase Newton's method as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\left(\\begin{array}{c} x_1^{n+1} \\\\ x_2^{n+1} \\end{array} \\right)=\n", - "\\left(\\begin{array}{c} x_1^{n} \\\\ x_2^{n} \\end{array} \\right)+\n", - "\\left(\\begin{array}{c} h_1^{n} \\\\ h_2^{n} \\end{array} \\right),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where we have defined" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\left(\\begin{array}{c} h_1^{n} \\\\ h_2^{n} \\end{array} \\right)=\n", - " -\\boldsymbol{J}^{-1}\n", - " \\left(\\begin{array}{c} f_1(x_1^{n},x_2^{n}) \\\\ f_2(x_1^{n},x_2^{n}) \\end{array} \\right).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We need thus to compute the inverse of the Jacobian matrix and it\n", - "is to understand that difficulties may\n", - "arise in case $\\boldsymbol{J}$ is nearly singular.\n", - "\n", - "It is rather straightforward to extend the above scheme to systems of\n", - "more than two non-linear equations. In our case, the Jacobian matrix is given by the Hessian that represents the second derivative of cost function. \n", - "\n", - "\n", - "\n", - "\n", - "## Steepest descent\n", - "\n", - "The basic idea of gradient descent is\n", - "that a function $F(\\mathbf{x})$, \n", - "$\\mathbf{x} \\equiv (x_1,\\cdots,x_n)$, decreases fastest if one goes from $\\bf {x}$ in the\n", - "direction of the negative gradient $-\\nabla F(\\mathbf{x})$.\n", - "\n", - "It can be shown that if" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbf{x}_{k+1} = \\mathbf{x}_k - \\gamma_k \\nabla F(\\mathbf{x}_k),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with $\\gamma_k > 0$.\n", - "\n", - "For $\\gamma_k$ small enough, then $F(\\mathbf{x}_{k+1}) \\leq\n", - "F(\\mathbf{x}_k)$. This means that for a sufficiently small $\\gamma_k$\n", - "we are always moving towards smaller function values, i.e a minimum.\n", - "\n", - "\n", - "The previous observation is the basis of the method of steepest\n", - "descent, which is also referred to as just gradient descent (GD). One\n", - "starts with an initial guess $\\mathbf{x}_0$ for a minimum of $F$ and\n", - "computes new approximations according to" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbf{x}_{k+1} = \\mathbf{x}_k - \\gamma_k \\nabla F(\\mathbf{x}_k), \\ \\ k \\geq 0.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The parameter $\\gamma_k$ is often referred to as the step length or\n", - "the learning rate within the context of Machine Learning.\n", - "\n", - "\n", - "Ideally the sequence $\\{\\mathbf{x}_k \\}_{k=0}$ converges to a global\n", - "minimum of the function $F$. In general we do not know if we are in a\n", - "global or local minimum. In the special case when $F$ is a convex\n", - "function, all local minima are also global minima, so in this case\n", - "gradient descent can converge to the global solution. The advantage of\n", - "this scheme is that it is conceptually simple and straightforward to\n", - "implement. However the method in this form has some severe\n", - "limitations:\n", - "\n", - "In machine learing we are often faced with non-convex high dimensional\n", - "cost functions with many local minima. Since GD is deterministic we\n", - "will get stuck in a local minimum, if the method converges, unless we\n", - "have a very good intial guess. This also implies that the scheme is\n", - "sensitive to the chosen initial condition.\n", - "\n", - "Note that the gradient is a function of $\\mathbf{x} =\n", - "(x_1,\\cdots,x_n)$ which makes it expensive to compute numerically.\n", - "\n", - "\n", - "\n", - "\n", - "The gradient descent method \n", - "is sensitive to the choice of learning rate $\\gamma_k$. This is due\n", - "to the fact that we are only guaranteed that $F(\\mathbf{x}_{k+1}) \\leq\n", - "F(\\mathbf{x}_k)$ for sufficiently small $\\gamma_k$. The problem is to\n", - "determine an optimal learning rate. If the learning rate is chosen too\n", - "small the method will take a long time to converge and if it is too\n", - "large we can experience erratic behavior.\n", - "\n", - "Many of these shortcomings can be alleviated by introducing\n", - "randomness. One such method is that of Stochastic Gradient Descent\n", - "(SGD), see below.\n", - "\n", - "\n", - "\n", - "## Convex functions\n", - "\n", - "Ideally we want our cost/loss function to be convex(concave).\n", - "\n", - "First we give the definition of a convex set: A set $C$ in\n", - "$\\mathbb{R}^n$ is said to be convex if, for all $x$ and $y$ in $C$ and\n", - "all $t \\in (0,1)$ , the point $(1 − t)x + ty$ also belongs to\n", - "C. Geometrically this means that every point on the line segment\n", - "connecting $x$ and $y$ is in $C$ as discussed below.\n", - "\n", - "The convex subsets of $\\mathbb{R}$ are the intervals of\n", - "$\\mathbb{R}$. Examples of convex sets of $\\mathbb{R}^2$ are the\n", - "regular polygons (triangles, rectangles, pentagons, etc...).\n", - "\n", - "\n", - "\n", - "**Convex function**: Let $X \\subset \\mathbb{R}^n$ be a convex set. Assume that the function $f: X \\rightarrow \\mathbb{R}$ is continuous, then $f$ is said to be convex if $$f(tx_1 + (1-t)x_2) \\leq tf(x_1) + (1-t)f(x_2) $$ for all $x_1, x_2 \\in X$ and for all $t \\in [0,1]$. If $\\leq$ is replaced with a strict inequaltiy in the definition, we demand $x_1 \\neq x_2$ and $t\\in(0,1)$ then $f$ is said to be strictly convex. For a single variable function, convexity means that if you draw a straight line connecting $f(x_1)$ and $f(x_2)$, the value of the function on the interval $[x_1,x_2]$ is always below the line as illustrated below.\n", - "\n", - "\n", - "In the following we state first and second-order conditions which\n", - "ensures convexity of a function $f$. We write $D_f$ to denote the\n", - "domain of $f$, i.e the subset of $R^n$ where $f$ is defined. For more\n", - "details and proofs we refer to: [S. Boyd and L. Vandenberghe. Convex Optimization. Cambridge University Press](http://stanford.edu/boyd/cvxbook/, 2004).\n", - "\n", - "**First order condition.**\n", - "\n", - "Suppose $f$ is differentiable (i.e $\\nabla f(x)$ is well defined for\n", - "all $x$ in the domain of $f$). Then $f$ is convex if and only if $D_f$\n", - "is a convex set and $$f(y) \\geq f(x) + \\nabla f(x)^T (y-x) $$ holds\n", - "for all $x,y \\in D_f$. This condition means that for a convex function\n", - "the first order Taylor expansion (right hand side above) at any point\n", - "a global under estimator of the function. To convince yourself you can\n", - "make a drawing of $f(x) = x^2+1$ and draw the tangent line to $f(x)$ and\n", - "note that it is always below the graph.\n", - "\n", - "\n", - "\n", - "**Second order condition.**\n", - "\n", - "Assume that $f$ is twice\n", - "differentiable, i.e the Hessian matrix exists at each point in\n", - "$D_f$. Then $f$ is convex if and only if $D_f$ is a convex set and its\n", - "Hessian is positive semi-definite for all $x\\in D_f$. For a\n", - "single-variable function this reduces to $f''(x) \\geq 0$. Geometrically this means that $f$ has nonnegative curvature\n", - "everywhere.\n", - "\n", - "\n", - "\n", - "This condition is particularly useful since it gives us an procedure for determining if the function under consideration is convex, apart from using the definition.\n", - "\n", - "\n", - "\n", - "The next result is of great importance to us and the reason why we are\n", - "going on about convex functions. In machine learning we frequently\n", - "have to minimize a loss/cost function in order to find the best\n", - "parameters for the model we are considering. \n", - "\n", - "Ideally we want the\n", - "global minimum (for high-dimensional models it is hard to know\n", - "if we have local or global minimum). However, if the cost/loss function\n", - "is convex the following result provides invaluable information:\n", - "\n", - "**Any minimum is global for convex functions.**\n", - "\n", - "Consider the problem of finding $x \\in \\mathbb{R}^n$ such that $f(x)$\n", - "is minimal, where $f$ is convex and differentiable. Then, any point\n", - "$x^*$ that satisfies $\\nabla f(x^*) = 0$ is a global minimum.\n", - "\n", - "\n", - "\n", - "This result means that if we know that the cost/loss function is convex and we are able to find a minimum, we are guaranteed that it is a global minimum.\n", - "\n", - "\n", - "### Some simple problems\n", - "\n", - "1. Show that $f(x)=x^2$ is convex for $x \\in \\mathbb{R}$ using the definition of convexity. Hint: If you re-write the definition, $f$ is convex if the following holds for all $x,y \\in D_f$ and any $\\lambda \\in [0,1]$ $\\lambda f(x)+(1-\\lambda)f(y)-f(\\lambda x + (1-\\lambda) y ) \\geq 0$.\n", - "\n", - "2. Using the second order condition show that the following functions are convex on the specified domain.\n", - "\n", - " * $f(x) = e^x$ is convex for $x \\in \\mathbb{R}$.\n", - "\n", - " * $g(x) = -\\ln(x)$ is convex for $x \\in (0,\\infty)$.\n", - "\n", - "\n", - "3. Let $f(x) = x^2$ and $g(x) = e^x$. Show that $f(g(x))$ and $g(f(x))$ is convex for $x \\in \\mathbb{R}$. Also show that if $f(x)$ is any convex function than $h(x) = e^{f(x)}$ is convex.\n", - "\n", - "4. A norm is any function that satisfy the following properties\n", - "\n", - " * $f(\\alpha x) = |\\alpha| f(x)$ for all $\\alpha \\in \\mathbb{R}$.\n", - "\n", - " * $f(x+y) \\leq f(x) + f(y)$\n", - "\n", - " * $f(x) \\leq 0$ for all $x \\in \\mathbb{R}^n$ with equality if and only if $x = 0$\n", - "\n", - "\n", - "Using the definition of convexity, try to show that a function satisfying the properties above is convex (the third condition is not needed to show this).\n", - "\n", - "\n", - "## Standard steepest descent\n", - "\n", - "\n", - "Before we proceed, we would like to discuss the approach called the\n", - "**standard Steepest descent** (different from the above steepest descent discussion), which again leads to us having to be able\n", - "to compute a matrix. It belongs to the class of Conjugate Gradient methods (CG).\n", - "\n", - "[The success of the CG method](https://www.cs.cmu.edu/~quake-papers/painless-conjugate-gradient.pdf)\n", - "for finding solutions of non-linear problems is based on the theory\n", - "of conjugate gradients for linear systems of equations. It belongs to\n", - "the class of iterative methods for solving problems from linear\n", - "algebra of the type" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{A}\\boldsymbol{x} = \\boldsymbol{b}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In the iterative process we end up with a problem like" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{r}= \\boldsymbol{b}-\\boldsymbol{A}\\boldsymbol{x},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $\\boldsymbol{r}$ is the so-called residual or error in the iterative process.\n", - "\n", - "When we have found the exact solution, $\\boldsymbol{r}=0$.\n", - "\n", - "\n", - "\n", - "The residual is zero when we reach the minimum of the quadratic equation" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "P(\\boldsymbol{x})=\\frac{1}{2}\\boldsymbol{x}^T\\boldsymbol{A}\\boldsymbol{x} - \\boldsymbol{x}^T\\boldsymbol{b},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with the constraint that the matrix $\\boldsymbol{A}$ is positive definite and\n", - "symmetric. This defines also the Hessian and we want it to be positive definite. \n", - "\n", - "\n", - "We denote the initial guess for $\\boldsymbol{x}$ as $\\boldsymbol{x}_0$. \n", - "We can assume without loss of generality that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{x}_0=0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "or consider the system" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{A}\\boldsymbol{z} = \\boldsymbol{b}-\\boldsymbol{A}\\boldsymbol{x}_0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "instead.\n", - "\n", - "\n", - "One can show that the solution $\\boldsymbol{x}$ is also the unique minimizer of the quadratic form" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "f(\\boldsymbol{x}) = \\frac{1}{2}\\boldsymbol{x}^T\\boldsymbol{A}\\boldsymbol{x} - \\boldsymbol{x}^T \\boldsymbol{x} , \\quad \\boldsymbol{x}\\in\\mathbf{R}^n.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "This suggests taking the first basis vector $\\boldsymbol{r}_1$ (see below for definition) \n", - "to be the gradient of $f$ at $\\boldsymbol{x}=\\boldsymbol{x}_0$, \n", - "which equals" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{A}\\boldsymbol{x}_0-\\boldsymbol{b},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and \n", - "$\\boldsymbol{x}_0=0$ it is equal $-\\boldsymbol{b}$.\n", - "\n", - "\n", - "We can compute the residual iteratively as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{r}_{k+1}=\\boldsymbol{b}-\\boldsymbol{A}\\boldsymbol{x}_{k+1},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which equals" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{b}-\\boldsymbol{A}(\\boldsymbol{x}_k+\\alpha_k\\boldsymbol{r}_k),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "or" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "(\\boldsymbol{b}-\\boldsymbol{A}\\boldsymbol{x}_k)-\\alpha_k\\boldsymbol{A}\\boldsymbol{r}_k,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which gives" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\alpha_k = \\frac{\\boldsymbol{r}_k^T\\boldsymbol{r}_k}{\\boldsymbol{r}_k^T\\boldsymbol{A}\\boldsymbol{r}_k}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "leading to the iterative scheme" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{x}_{k+1}=\\boldsymbol{x}_k-\\alpha_k\\boldsymbol{r}_{k},\n", - "$$" - ] - }, - { - "cell_type": "code", - "execution_count": 1, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "data": { - "text/plain": [ - "" - ] - }, - "execution_count": 1, - "metadata": {}, - "output_type": "execute_result" - }, - { - "data": { - "image/png": "iVBORw0KGgoAAAANSUhEUgAAAPcAAADyCAYAAACRQVPgAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjMuMywgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/Il7ecAAAACXBIWXMAAAsTAAALEwEAmpwYAAC8oklEQVR4nOz9d5Rle3bXCX6Oud6buDcibnhvMiN95ntVqlJJKhmEJAQIWjD0qOhmoBkE6hZmWo161DNr6BlATMNqml7NkrAjnFSABEggh8q+lz4zvPfeXO+Pmz+Oych8aSLz5XtV9Sr2WrXyVcS9J64539/e+7u/e2/BMAzO7dzO7ZNn4jf6BZzbuZ3bR2Pn4D63c/uE2jm4z+3cPqF2Du5zO7dPqJ2D+9zO7RNq5+A+t3P7hJr8it+f18nO7dw+ehM+iouee+5zO7dPqJ2D+9zO7RNq5+A+t3P7hNo5uM/t3D6hdg7uczu3T6idg/vczu0TaufgPrdz+4TaObjP7dw+oXYO7nM7t0+onYP73M7tE2rn4D63c/uE2jm4z+3cPqF2Du5zO7dPqJ2D+9zO7RNq5+A+t3P7hNo5uL8BZhgGzWYTVVU5Hy19bh+VvWpYw7m9ZdN1nWazSb1ed34mSRIulwtZlpEkCUH4SHr3z+3bzIRXeI5zt/KWzDAMVFVFVVXq9Tqrq6sEg0Gi0SgejwfDMBxQNxoNQqEQbrf7HOzfHvaRfMHn4P4YzA7DdV3n8PCQlZUVuru7aTQa5HI56vU6wWCQWCxGNBpleXmZnp4e/H4/cO7Zvw3sHNzfiqaqKtvb2yiKQqlUotlsMj4+/pSnNgyDUqlEPp8nl8tRKBSIxWK0tLQQjUZxu93ouu48XpZl53/nYP9E2Dm4v5XsdBi+trbG1tYWfX19dHZ2AtBsNl8IyqmpKVKpFLVajVwuh6IohMNhx7O7XK6niDhZlh3PLoriOdi/9ewj+cLOCbWPwHRdR1EUNE1jd3eX7e1tWltb6erqAnglQy6KIsFgkHQ6TU9PD7quUywWyeVy7O7uoqoqkUiEaDRKNBpFEARUVQVAEISnPPs52L997Rzcb9EMw0DTNBRFQVEU5ubmkGWZ/v5+ms3mcx8vCAKqpiFL0guvK4qiA2QATdMcsG9vb6NpmvP7SCQCgKIowDnYv53tHNxvyQzDcLx1oVBgdnaWvr4+2tra2N/fp9FoOI8VBAFBEBwP/uf/5/+Dn/gD38M7E8PO71/m3SVJIhaLEYvFAJy/mcvl2NzcxDCMc7Cf2zm434bZtWtd11lfX+f4+JgrV644bPfLwGoYBl99OMtvfPU+f+On/yR/5Ps+/dp/X5Ik4vE48XgcMEk8G+zr6+sIgkA0GiUWixEOh1EUhZOTE8rlMplMxsnZJUk6B/snyM7B/SHsNGnWbDaZnp4mFApx48YNRPGJ+O9l4D7KFcgVywD8g3/zW9yeWuD//H03P5RyTZZlEokEiUQCML12oVDg5OSE1dVVRFHE4/EA0NbW5qQR9mu1yTlZlp0o49y+9ewc3G9op2vXJycnLC4uMjw8TDKZ/MBjXwbuhbUd57/3jrJML29wdHzMz/ypP8poKPRWXqvL5SKZTDqvTVEUNjc3yWazPHz48KkwPxQK0Ww2nTRCFEVcLpfj2c/B/q1j5+B+A7NJM03TWF5eplwuc/36dccbPmsvA/f82jYAkWCAk0IJgM39E37sL/0N/re/+mf53I2Jt/76XS4XkUgEQRDo6+uj2WySy+U4ODhgaWkJWZYdsAeDQQfsgiAgiuIHwvhz++a0c3C/hp0Ow2u1GtPT07S0tHDt2rWXerOzgDuTjlMoVwA4KZQplKv83X/+73nv8Tx/6Qt/CJf80X1VbrebdDpNOp0GcJRzu7u7lEolPB6PQ9DZnt1m/8/B/s1r5+A+o9m1a13X2d/fZ21tjfHxcac89TJ7Vc4NEPT5AAgF/eRKJsjL1Tr/27/4D2wfnPAzf+qP0JH+YMj/UZjH46G1tZXW1lYA6vU6uVyOnZ0dyuUyXq/XIegCgcA52L9J7RzcrzC7dr28vExHRwfz8/NomsbNmzdxuVxnusaLwK1pOvfmlrk2NoBhiQE7UnHmLA++d5wDYP84x/f9X/5H/uZf/K/4/d954629r7Oa1+ulra2NtrY2DMNwwL65uUmlUsHn8znqOZ/P9xTYNU1DkiQCgcA52D9mOwf3S+x07Xp7e5u9vT26urrIZDKvRSo9D9zlcpntwyzFcpX7s8t87sZFRFEgFLA8eMDHSb5oPrZao1ip8gv/+j/x2+8/5P/5k/+l87gPY29CjAmCgM/nw+fz0d7ejmEYjkx2fX2dSqVCIBBwwF4sFqnX6446zybobF38Odg/OjsH9wvsdO16e3ubWq3Gpz71KYLB4Gtf6zS4dV1ncXGRfD7PVx8vOo95//E8I70diBbg2pIxSpUaYLLo9nV++Te/ytb+MX/xC3+Idy+NfNi3+aFNEAT8fj9+v59MJoNhGFQqFfL5PKurqxSLRVwul5O3ezweGo0GjUYDwzCeCuHt0tu5vR07PzafMZs0azQaKIrC5OQk5XKZYDBIIBB4o2va4K7Vaty9exePx8OVK1eoGebZ2pqMUm8qzK5skS8U6UzF8HnMkD8aCpAtmHXwctUEu27o/NG/+P/mr/39f0Gt3nj+H/0GmSAIBINBOjo6uHjxIr29vcTjcSe1uX//PgsLCxweHjocRr1ep1KpUCgUKJVK1Ov18yk1b8HOPfcpO127zufzzM3N0d/fT2trK++//z66riO9RAP+IhMEgVqtxoMHDxgbGyMWi5nac4spb03G2T/OA7BxkKXZVGhNRAGIBf3kixXAYPfwxHqh5mv98v1pfuMr9/ibf+m/5t1Lo6/9Xj8u83q9dHR00NnZ+VR76+LiojOYwg7jBUE4n1Lzluwc3JadDsPX1tY4OTnh6tWr+CwWWxTFNwKEfb1KpcKnP/1p3G6387u51S0AvJaXbk/F2T00Q/CTUpUro/14XDJru0dEg37yFot+nLcZdi8zSxv85P/r7/E971zmf/jTP040dPbo4uMAyum+dftvhsNhwuEwXV1d6LpOqVQil8sxNzf3gfZW+2C0r3EO9rPbtz24T9euG40G09PTRKPR50pIdV1/rWvXajUmJyedGvFpYOdLFTpSCfaPc9QbpvQzFY9a4DbYPcyyun3AZ66MMdjdjsclk1/eAHC8fKFgEm7xSJB/9h9+j9+9/Zif/TN/jD/w3e9809z0hmG8lDQTRZFIJEIkEjlze+s52M9m39bgPl27Pj4+ZmlpiZGREUeTfdpEUXwtcB8eHrK0tMTY2Bgej4eFhYWnfj+7ssnt6SXG+zspWB7Z6zY9eCoe5TCbB8xy2Nr2Ad99a4KZlU1S8QgHJ+bvFOvleFzW16hr/ORf+3v843/7m/zPP/UTjA70nP3D+IjsWc/9Knvd9tbTYN/f3yeTyZyD3bJvS3Cf7rvWdZ2lpSWq1So3btx4yruetle1Ydpms+GVSsW5Xq1W+8BzZ1Y2AVjfPSTs99GbSVNvmLXhZCTIYTaPIMDm3hGarpMrlhjp6SAaDnBwYv5ua/8IAEkyv8b2dAv72SKTi+v8wJ/9OX7w3Qn+9I99H53tbUSjUeRTKrePK+d+XXA/a2dtb43FYmxvb9PW1vaUZ/92nlLzbQfu02F4tVplenqa1tZWRkZGXvrFn8Vz22F4KpVieHjYud7zDgYb3F2tLcytbuFxu2hNmjew22WSdp3pJJt7xwCc5Eus7Rzw7qURro8Psn+cY9sC91GuaD3P/Dq72lMsbuzwa195yOOVHf7g567z2YkBZPkJUE7PZPsoTdf1t1rLfll7a61W4+HDh0+1t2qa5jDvdi/7twvYv63AfToM39vbY2Njg/HxcWegwcvsVZ77dBhue5mXPdcGdyhg9ny7JIn3Hs9z6+IQxZJZ+mqJRdncO0aWRLb2TZA3mgoP5lb4zmsXqDcaFEoVdg7M39Uszx8NmbX4eDTIxu4hf/uf/TqPlyf4L37gM3R2Bjk8POTk5MR5XfF4nFAo9JHc6B/Wc7/KTre35nI5JiYmPtDeaoM9FAo5YIdP/uCKbwtwnw7DNU1jbm4OgJs3bz4Vqr7MXsSWPy8Mf9aeBXdTUVna2DVfmxUNdLaZHvz21CIX+jpIxSO4ZMuDt7awtrMPPNGiNxSFRlPlU1dG+dLdaQAnF7fvz/aWJNm8eVB8/dEs//nOY/7g5z/FH/3+zzLY20u1WsXr9bK9ve1oxm3PHggE3sqN/lGD+9m/9bz21lwux9HREcvLyx9ob1VV9RM7peYTD25bQvrgwQP6+vqYmZmhu7ubTCbzWtd5Hlv+ojD8ec89De7F9W0GutqYW9122jzDwSeNI9Or2wR8HtyWdj0eCbG2s4/H7WL7wKx11xpNStUalWqDsf4uGorCyuYeACVL7BL0ewHoaE06IfydyQX+zW9/nR/5zpt8/tZF/tAPfBetra3PlZHas9RjsZhTEnxd+zjB/TxzuVykUilSqRTAK9tbnx1c8a08peYTDe7Ttet8Ps/s7CyXLl16I6XZszn3y8LwZ+1ZcD9eXGdxfZeb44M8nF8xX6tm/r4znWS2vEml1mBmdYObF4cQRfOG6mxtYXnT9Pj7VlOJJInMrmwy0tvBO5dGuDezxLYVpquaBkAqHmF7/wivx82OJYSZW9vi1750hy8/WuCHvvMWn3/3ygdkpOVymVwu95TYJB6PE4vFXkg8PmsfJ7jP8nfO2t76IrA/q4v/Zgb7JxLcp0kzRVGYmZnBMAxu3br1xuSODdCzhOEveq5tjxfW0HSdo3yRK6P9PJhd4dhqEglbDSGRoI+TfImTfIlPXRqhr6OVWNg8lEIBnxOCly39eTjot/TpGVwumcnFdXJWVOAQbW0tLK6bk192j8zDYW1rny/8Dz/P7/vsDb733Sv86Pd8Go/bhSAIhEIhQqHQU2KTbDbLzs4OmqYRiUQcr/ei9ObjAvebsv8vam89nao8297aaDTY3d0lnU7j9/u/aUdSfeLAfVpCmsvlmJ+fZ3BwkHq9/qFYW1EUqdVqLC0tvTIMf9aeBffU0hoAyWiYO9NLjPZmyFn6cUU1vW1bMkahXAUDZpY3qdTq9HW0IggCHemkqW4zDCdMty/vdrl4vLjG5eE+R9Fmi2Rsoi2ViHJoHQ622i1bKPHTf/3v86/+41d49/Iof+KHv8dh7+33b4tNent7P1CSAhwQRCIRR6b7cYH7bbH/Z21vPTw8JJVKPTWlxvbs3yy97J8ocNue2pZ85nI5rl27htfrZXl5+UPdaNVqlf39fSYmJl4Zhj9rp8GtqhrTyyYYymXTs1ZrDRqKwmhfp9Pm6feaEUEqEeHwxATg9sExQ93tJGNhAFriEY6y5u/yFsPu85qjnnLFMtsHx9yaGObIEsTYb701EePwJG+x8GYubkcAYPC//ON/zb//vdsMdrfzJ374u/nMtYsfuFGfLUkpikI+n+f4+JiVlRUnlz2tE/8o7VVKuDexl7W31mo1Hj9+/FR76+le9p/8yZ/kZ3/2ZxkZeb3OPUEQ/gHwQ8ChYRgXrJ/9TeCHgSawAvxJwzDyr7rWJwLcz27QnJ6eJh6Pc+PGDQfMds78uo0fdhheKpUYGBh4bWA/+zp/52u3aTRNT6oa5s0YDfrZ2DuiUq0z0tMOmIw6QFtL3AH35t4R1XqDaCjIrYlh6vUGR9mCI3Y5/byWeISNvUNmVjYQEXjn0gjFchUAv888ANpb4s7z7HKaopiRQzQU4Ne/fIf7M0u4ZIk/8v2f5Q9/32fo7Wh97ntzuVy0tLTQ0tICPMll9/f3mZubw+/3E4vFiMfjb42JP21vu57+PDvd3rq7u8u1a9eoVqtOe2u1WiUYDLKyskI2m8Xr9b7Jn/lHwN8F/smpn/0W8DOGYaiCIPx14GeA/9urLvQt3/Jpk2aqqnJ0dMTDhw8ZGBhgYGDgqRvodeWjwFMtmu3t7W/UEQZPPPeDBw9Y3Nihuz2FKAhs7B0COIMVezJpJpe3GMikyBVNr45FimVSCapWe+dRrsDtyQVikRDd7Sk60knnwLBLZfYGk450kmKlxvuP5ylX69y8OOwAOBI0a+zJWPhUU4oZOdgkXmsyxvb+Mf/Hv/wPfOZP/DQ/9N/8LP/kV3+TncPjl75nO5eNRCJcuHCBoaEhZFlmfX2dO3fuMD09zc7ODtVq9a2o5T4OcD9r9tonu7315s2bdHV1sbW1xcLCAj/8wz/MF77wBfL5/JmvaRjGl4HsMz/7TcMwVOv/vg90nOVa37Ke+9na9dLSEvV6/YUk14fRhsdiMdbW1l77cLCtUChQqVQYGBhg5yvTHGWLfPryGF95OAPgzC2Phs2ceOc4h8/rZrSvE1U3b/yA1/yqJFFk0zoUCqUK2/vHfNfNCUuSKjhMeaVmhsORoEnCtSUTbO4dsrl3yMRQL5eHe5ztc20tCY5zRVyy5JTMShXTy/s85mfZ2dbCwto2j+ZXmFne4Gf+v/+AH/mudxkb6Ob7P32dwZ7nT6exU6Fnw9tKpUIul2N5eZl6ve60fcZisRdOkX2ZfdTgLlWqjuAInk/g2STkn/tzf44vfvGLfOlLX2Jubo7QWxpRbdl/BfzLszzwWxLcp8cfVSoVpqenaW9vZ3R09IXh3lnB/SI2/Kza8mdf59bWFjs7O/j9ftLpNI/mV6nWG9QbDW5dHOL+7DLruyZYDQvImZY4y9v7ZAtlPnN1DFmSiEUjsLlPJhVn01Krbe8douk6hXKFZDRMf1cbX75vClpskOvWNdPJKHvHJ3hcMtPL6+i6waXBbm5NjCBJJig6W1tY3d4HDOf5dphvHxKdrS3O4fKV+9P82n9+j//01bsc5Qr84e/9DKP9XXzq8hiJWMT5DJ79TuyBDsFgkM7OTnRdp1wuk81mmZ2ddTrBTm81Pcv39jbBfZwr8P7DGaYXV/m13/ka3/+Zm/zcX/iTZ36+oij4fD6uXbv21l6TIAh/FVCBXzrL47/lwH26dr23t8fm5iYXLlwgHA6/9HkfRht+1uefNlVVmZ2dRRAEbt68ye3bt2kqqiM7FSSR21OLvHtpmMmFdRRVJWuVrmzxSSQY4CsPZhnobDsF0hib+8cEfB6O8ubjs/kCu0dZYiEf4/1dKKrG4oZZ8rKjArtnvKs9ZanjDFZ39ilV69y6OMw7l0aQJInV7X1aYlGOcnkApzvNdvPJWITNvUPi0RBZ6+8fZvPsHBzz9Ycz/J1/8q+5cXGYUrnK525dIuSR+F63j7GB3pcevHaPd09Pj9MJls1mP9AcEo1Gn5sefRhwq6rGwtomc8sbfP3hFA9mFlnb3qepKPR1tLO2vceF4b6nnvNxl7wEQfgCJtH2PcYZvcy3DLhPk2aapjE7O4soimeWkL4KnK8SpbwOuMvlMpOTk3R1ddHR8SQ9ml/bcnLjvAU6VdWIhgK0JmNsWB5cs/5OV2uSqeUKy5t7pOIRbl0cxl6Z3tWaYm7VPChOCma+7PF4eDC3Sl+mhfHeDOt7R46XtcthsbAZIiYiYU6sfvD94zwbuwe8c2mUa2MDBP1evnQvj8ftYscqtdltqXbNPJNKks2X8HrczoQY+yARRZH5tS18Pg8PZpf4hV/9HTRV58JgD5dHB+jrbGO4t5Pejlbn9Zy2ZzvBVFUln8+TzWZZXV196vfhcNj5bl4Fbk3T2Ds6YXljh6X1bfaOTnj/4QzBgJ+v3Jvk+sVh7k3N09vRRlNRcMkSG7um7PfiKXC/Cltvu/wnCMIPAH8F+E7DMKpnfd63BLhP166LxSKzs7P09PTQ3t5+5mu8CJxnFaWcdVjD3t4ea2trz40mHs2vAmbevL5z6Fx35yjLQFcbl0d6uTez7EhS/T7Tg9vlsMNsgc9cHaM9FXfkqi2xiEOiFStmnt2SiPP+5DwDnW343C5mVrfY2jsAQNNU55onhSJuWWZr33wtxXKF2ZVN3rk0Qm8mTXd7mvszS5QqNbYsVt0m9QLWazOFMdsmY28dTmUrX/dY4XR7S4LppXUmF9f42oMZ53mbe4d8541L5IolblwcQRCguz1N0O8jEQ0TCQUIBwIE/B58Hg+t7Rk6urpQFZVcLsfa+ga5fAEEAR2BSrXOYalBrlCiXK2xtXuAbhg8mlvGJUt89f4kXrfbOaiSsQjHuYLjlW0SMhmPsLa9R3emleX1HXxeD/2dT+41e1zzy+xNAS4Iwj8HPgckBUHYBn4Okx33AL9lXfN9wzD+m1dd65se3Jqmsba2RiwW4+joiIODAy5fvuxs0DyrPQ/cZ9WGw6tzbl3XWVhYcEi95+WJs6tbTAz2UG00HBmpDeR4OMidqUVuXhxictE8BJqW7LH9VDns3swSumEw1tuJKAq0t8Q5yhUQBcHx0vbzoqEg92aWGOhsNUclF8pOHV203ktnawsrW6Ym3a55NxWFtZ0DWuJRGk2FT10do1yuMb28zp7lpRWrsypiCWM6W1MOuJ89CPxWSagjnWSuvInH7XL+1tb+Iatbe3g9bu5MznPj4jB3p+bp62hjdWvPFIbIMk1FYbi3g4W1LW5dGuX24zluXBzhruVp17b2kCyGX9N16/A4srzxAu9cGqXRVBjo7qBQWiMeCXGcK2DAB0hEUTAjgHgkDOwwPtDzFJhfBW5VVd+4smIYxh97zo9/8U2u9U1bCrNJM1voPz09TaPR4ObNm68NbHi+NvzBgwcMDQ3R2/vifPBFzz9t9Xqdu3fv4vV6uXz58gsJoK8/mmd6ZZ2+DlPXbIZ95o1l59TFcpV4OERHKu4sJfBa0URXawu1RpNGU2F5a4++jjaHYe9qTznk12ndOZh66ofzq/R1tpG0JpzYx5TX6h1PRkLOKGVbvQYCTUWlVm8wubhKJhWnt6OVsf5u55CwP7UWi0BLxaMULZDsHZsHga1xD1ukXHd7GsMwkESRLetAyp8K6QESUTPq6WpLOYeVfXjYntd5rPW321MJNF1HlkRHQ79jXb9qiWmCfjPiybSa9fhULGrJdA0nuilaSyHs93ZxuJ/TpmnaS1MAe3b7N9q+KcF9unadzWY5OjqipaWFkZGRNyZNJElC13V0XWd+fp6trS1u3LhxZlHKi1o+j4+PuX//PoODgy89JKr1JosbOxgG5ItVro8NMtjV5tz4x1ZoHQkG2D3KUa7W6WprsZ5resCWuHkTe9wuNvePWN7ao1iucOvisCMVDfq97Fpzzm2w2gsMGk2Fe7NL9HW04rVKXAFrDntbyhwt5XHJDlOetaSpdngdDgW5M7XA8uYOpUqVGxeG8bpd+L0eZ5dZa4upWAsH/c4hYSvk7MPRHuLY3Z5GUTUEATZ2nwaWfTDZ77mjtYWatXl003pswVLlSdY9EXMOulY0TcclSxxaCr4T6/PNW+/JbbXTtqfN992aTDgiH/v6uWIZSRK5NDrw1Hf5KjGU3VH3jbZvKnCfnhmuqirLy8usra3R1tb2Sjb8VWZrw21RytWrV8/c2QQfzLkNw3Be3/Xr1x0Z5otseefQORwOsnnuzS4Tj4RpTcbwekywwpNwNxWPcGdqkQsD3RQtkMrWDd/dlnI8/fbBCbenFpAkkatjA3RaBwIGTpiuWQeIPS75MJvnwfwq7ckYPo8blywRsBj6nlMKNHtAxEnWjAT81oy37rYUJ/kSd6cXuDezSFNRcLtcvHN5lGQ0jCgKdLSa/dQuWXpyWFgpiGCFzwlLRtvZlrKIRsMBVqlsvWfr0Ehbr70jnXQOO/v92cMtbOGN4/UzrWi6jsflcqKgqkUs2vPeVcUccNESN5+TSSdpbYlz6/IYfp8Hj1tmfLDnqe/yVWH5ued+xuwwXFEU6vU69+/fR5IkZzWufYO+qVWrVVZXV88chj9rpz13s9nk/v376LrOtWvXziS6WNoyb9qAz+NIPmv1BpV6g1vjQw5Y7W4vv6URP8zmyeZLXB3td7aARq3usHg46JBpJ7kiD2aXScej9He20Z6KU66aoaitP7e9a1eb2du8e5zjzuQ8oYCfoN9LLBx0vGpna4vD7OdKpker1EzAuWXztrFVc6qqM7W0xvuP5siVytbIqDjvXB5jtLeDSNCPKAofCMFtj5uM2mF10hTfGDgkn615t1OdtBWhZNJJqtZjbZCXrPdrgzxuMfFdmTS6ruP1uJ38umB56UAwxPhgD6GAl76ONNGgn5WNXfYPjnk0u4Sm6Qz3dT31Xb4K3PYSi2+0fVOAW9d1Go0GmqZxcHDAw4cPGRoaor+/H0EQnJD6Ta89Pz9PoVCgp6fnjbXhtufO5/PcvXuXrq4uhoaGzpwmnBRNYPZmWp1DYv8kR6lcpd5UeGdimEgo4OSKNrDaWxIUK1UezK0QCviIhYPOQZA5tfXTLqMVKzVWtvYY6e2gJRYxyasDqzmk+nSY3t4Sp9Zoki2UmFrcoFytEQr4Ge7tJGWFw7Fw0JGkVuqml7MHN4T85gEUDfmd9tKD4xy1epNCucL7j0xBSr5UYay/h9H+Lt65NEo0HGSwu8MZC+V2Pw3cdEvMCZFtMFZrz4A8YUZK7ekElWqd00sb7JzcjhBi4SDJWIRLIwPcuDjCu1fGiUVCxCJBNnb2mFlao1xtsrp9QNDyuCErN+9uS7G7s0OxWHS+t1fl3OVy+ZvCc39D2fJnp5AuLCzQbDY/sEFTFMU38tyn2XB7Ed2bmiAIFItFCoUCV65ceS1SzzAMvj61yvXxQadOHPC62bEWEJSrVWZWt/nUxDBLm7sc5YrsW3mqx7rxe9pT3J1eIhoKOD8LWA0gNjMMT/Lbar1JsVzh3ctj3J9dNMtZzwxxSERC7B5miQQDHJyYYev6zj7Lm7t87voEty6NoGka96ZLeFyyw3DbHjJqscmZdAv50gY+j8sB2IEVBjvEncfFvalFOtItbB+YB1E44CcU8CEKApdG+mmJRXj38hh+n5fOtKm/r9TqpBJRDKA7k0YUBLraU4SCfvq72mlPJYhHwsiCAAJ4PW5EUeTGxWFkSaSjtQUMOM4W6O9s587kHKP93cyurBMJBtgvmN+BEylYB2DAkpreuDSG2+1me3ubUqmE3+93ZqW/qNxlN5B8o+0b5rnt2rWiKFQqFe7evUs4HH4u2yxJ0muD+1k2/MN4fzv/bzab3Lhx47XZ+o3dQwqVGvdmltE1lVjQT097yvn9gd22WSxSrTeYGOgkZ3l6Oyy12zzrzSbvPZ7j4lAPmma+n5ZYFDBD+c1TLZwNRTVJKAM+c20cxWLTj61pqXZd187TJVF0iK3jQpHbk/PIksSlkX5uXRp1wno7L7b16yGLBe/taAPMPNuOQGwPbDecp5Lma21NxilWqpQqNeZWN3k8v8LBcY73Hs5Sqda5N71AQ1GYWV43I4uFVTZ2Dphf3WRz95BcvsjKxi6qojG9uIqiKjyaX2HbUsrdm17kwcwi2/uHThOObr2GsNUw02l9By02Y27Axs6B9V2Yz7k6PkxbWxtjY2PcvHmT/v5+DMMgl8tx584dZmZm2N3dfaq19cPk3IIg/ANBEA4FQZg+9bO4IAi/JQjCkvXvmcLPbwi4T4fh29vbTE9Pc+HCBTo7O597Er4OuF/Ehr9JVxiYIdadO3eIx+MvlD6+yu7OLFn/ZTC9vIkgCU4ImoiGOLZknLLLTaXWoN5oMtLdikuWnMGI9vbPnvY0um4wtbjO7tEJtyZGkOUnRJv1ZxyQ67pOqVqjVKkjyzLvXh4laynTbHDactfuTMoZFvGk5q3yeH6FelNBEAQ+fXWc0f4ufB43285EVjO8thsreqwcVxDg0DpIslZorzRNIittgbwlFnFC+h0rfbDnt9u96RmL0U7GIiYpZzx5ffZ7sA+edNIM17vaUtQbTfPAsj7DY+sQVa37IGgd0hmL/GtPJyhXzZnn69ZzJkaelMHsls9wOExnZ6fTBaaqKgsLC9y5c4df/dVf5f333+dD2D8CfuCZn/33wO8YhjEI/I71/19pHyu4bdLM3qA5NTVFsVjk5s2bL+2cOSswX8aGvwm4d3d3mZyc5OLFi6TT6Tf2/LcnzW0jrYko5VqDXLHCSaHErYtDdNp5s2E4oXUw4Gd+44Dhng4n97VvfI9Vl05Ew+wcnnB7ah4BGO/vImSp1tpTccdj2oSb1+OiWK5wki8iIHBluNd5jF0ft1nmdDLm5K12uI5hUG80qdebPJhdJhz00dGa5NbECKp1INiy2ahNZLWZpS4MOLBEOFawgWZVBeIRixyMhJyIYtdKH56A3Dx8bI6hJX6qNm2F05W6DXLz80lZ7Hp3Jk1TUXG7ZDatOvbhsRmKNy1ew2sRoq0t5iHS3Z7G6/Fw/eLIB8g0eEKo2V1gXV1dXLp0ievXr9PV1cXe3h6/9Eu/xM2bN/nt3/7tDzz/Zfa8lk/gDwD/2Prvfwz86Fmu9bGB+3TtulAocPfuXVpbW7lw4cIrveFZPPerRCmvA25d15mdneXw8NA5eN50EWA+n+fhrLmHu9MSThgGrGztc3tqiUQkRMDnpa0l7vRUly1v5PW42To44Z1Lw5xYDLNmkWmxoHlDioLAo/lVZlY2Cfq9tCZjpBNmVOBxuxwmuWLlybFwiGKlxt5RnmyhZPV3q861ANot7xf0e50hDnYZy+V64iGnFtaYWVpnanGNdDKGz+Ph+oUhh1ewhS3t6YTlYZ+QXpJspl4hKzeNh0wvGgr4n6xSOjIf+6wnt2vTKQfksG/NhCtZB9YTMYz5GrozZu3b5/U4Xt++fq1eJxmLEI+EuXV5jO5MmkKpjK7rTkRw2l5EqImiyJUrV7h8+TI/93M/x+/93u9x48aNDzzuDSxtGMae9d/7QPosT/rIwX26dm1LSRcXF7ly5YozlO5V9jJgnlWU8jre/86dO/j9fi5duuTUWV93EaBhGGxubnL/0WM2DnIMZFqcMUe9mbRTpto9zhIJ+Rnqbrf+DmztmzedKAhouk62UCbTkqSnPU3WAnnSqqu3t8SoWx5oZmmdk1yBZCxMwOe1wmPzMLDDdNu7JmIhmqrG7MoGU0vrTAz14rKG/Hk8tiLODPNP5+K2RNOWlHa1m/dZrlDiaw9nuDu9yGE2TzwaIhIOMt7XwXBPB8lYhJZ41BkHZUciqs0bWOx3hwXcgM/jkHK71mMbVo3aBnlbyvTk6WTMGef8rBjGlpLGIlY00Z4iGYtweaSf7kyay6MDFEsVjrMF9g6Puf1oxjlMLo08LV6x7awiFr/ff6aFF69jVkfYmbzMRwpuG9i2jPTBgwdomvbapNSLPPfriFLOAu6joyMePHjA8PAwPT09H2j5PKvn1jSN6elpCoUChidMqVJjeefICf/skFESRVa3D9g9zNJQVG5eHKKnPe2UiGzdeSwcYGV7n2K5SmdrCy5ZcljdthbzBg8FfBxkC6iazvL6NoJo7hxzyTKtp8Jsm023w9duC5zTS+vcnV4gnYgS8HloiUUc4qk7k3ZycafLzBKB2CWjHkswIooC6zsHZPMl9g5OmFnZplZvcpzL092WYqSvk09fvcBAV4ar44OIgkAyFnFKfxErpO/taHfel+3JN60Orap1MPrscVEWyNta4pSrNSRRoFpvMNLXhc/r4Z3L44QCfoZ6O0lEwxxl86i6wfuPZtk9OGbN6mG3c3Obk7g8OvjC7/djVqgdCILQBmD9e3iWJ31kpTA7DL9z5w59fX0sLi4yPDzsbIJ4HXseuF9nbji8HNyGYbC0tESxWHzp1pCzeO5qtcrk5CTt7e10dnby737xVwCz9PXl+zNcGxtwDonejrTTQHKcK7K8tcd3Xb/ASb5IvdFk3WJuVdX8ux2tSW5PLtDVmnRuLvv46W5vYXppAwM4zJeo1OqUqjVCfh+ZZJjDbB6X/KScZYfpds27O5NmbXuP/eMcTUUlVyxxcbCHa+ODuGSJ1a29p/aH2+G17XkjlvSzuy3N2s6eyTxbXtQ+iGSXzPzMFhPDLiYXVomEAo6E1C1LxCMhZElipK+L1pYYHrdMJBSkXK3hkkWaTZWuNhVD1xnr60BXFCaGeomGAnS3tdDe2kKlVicS8rOxvY8oCqxu7dFoKvR1trG6tUsoMAw80Zi3p5McnuTpbEuxtXeILEmsb5sgvzT2fM/9KnB/BKWwXwN+Avj/WP/+6lme9NY99+kwXNd1KpUKGxsbXL9+/Y2ADTxVxvow2vDngbPRaHDv3j0EQeDatWsv9P5n8dzHx8c8fPiQkZERurq6EASBO1MmmdZuseP3Z1fQdZ1MKkE8Yt4AXo+LtR0bCHUkSWRisMsJoW0g2ao13YDHC6vcuDB0aruIebN2tSYdBjlXrJAtlnG5faRiUS4P9Zgv9NRI5EbTzLftUlsqbjLShgFLGzvcn1nCAK6NDTLa24XH7SIWDjre9PAU4Xb6Oh0W0MBwvH2tZnWJOe2iZtgfDgTYPTwhWyixurXL/Oom2XyJ+zOLVGt17kzOUSxXuTu1wMbuIY8WVpld3WJ5a4/JxTW2dvfNAZOVKsVyhZSVsnR3tNJoKrhdstOXbROENsPvc6KpJ89RVJWA38tA1/O30nyUIhar5fM9YFgQhG1BEP5rTFB/ryAIS8Dnrf//Snur4D4tIbVDZhs0bzIXyzZbxPJhtOHPq3Pncjnu3btHT08Pg4ODr2z5fJnnX1lZcXTm9m7peqPpdH153GaQFI8EuT+7TLFSwWe9/r6OVgfIe8c5csUKTStMb03EHF102VJpmU0iApOL6+wdZbl5ccjJE20yLej3OtrwUqXG/kkORImWeITPXLvo/D071G1az7dD3IDP63j5bL7E/dklKlYoPjHcx40Lw2RSCecxJ88MVrRTj0Q45OS/23apy1K6OT3hVr05FPA7B9m+1VFmd4QFLFVch0VKtsSiDsl3bM18b1iPrVufU8jiBXotMi3o9zkSWJuRt3UEdjnRlsJODA+80DufJed+07lphmH8McMw2gzDcBmG0WEYxi8ahnFiGMb3GIYxaBjG5w3DeJZNf669NXAbhuGQZvv7+zx+/JiRkRE8Hs+HnkohSRL1ev21WjSftdOe2zAM1tfXWVxc5OrVq8443lc9/3meW1EUHj58iKIoHzjEHi2soeo6/R2tjqqrx8pxS5U6MyubvHNxmIhVH44E/U9ml6kad6aW6GxtYbgng5kTHlqvxXzvfZlW8qUKd6YW0TSdsf4ux6M4NW9gzQKwqmocHOep1et43C5ujPdjWIG93aapNM3XmUmZh4QsiU7Nt1St0WgqNJpN7k4vEPT76Ots453LowT9Pnwet8P4uy0iMhE1o5NkNOIcALuHTzaWwqmowwJ5OBhwQL579LQc1/b6T7q54pZW3XCmxmjWexItAFr9NrRbpa54JGR68FOpQ6lUpb8rQzgUMGWqEy+eN36WsPwtD0V8I3tr4BYEAU3TmJmZ4ejoiJs3bzoe7GXh7Jfm9hxG93lmT0ppNBqvFYY/a7b3V1WVR48eUa1WuXHjxpkX3D1vWEOpVOLu3bu0t7c/tx3164/mOMwWOCmUCFhLBuwyUXsqznG+xPtTiw7pZQMfnqz7kSSBhY0dPnPtAorFO5zk7eWB5qGQTkSZWtpgdsUchNDZmnQEJV1tLVStcHjPqu9KkkSpUqNUbVitm0N4rChClMwSlc2Gp+ORJ2SaBQTb88YiIVa39jjJFXm8sIKqqQgCvHNpFK/XTSaddEpJtlDkdEi/9wxwn7xmE+SRYID9IzvHt2vf5nuxa992q2pLLOIIUDZOHUaAEyLbYp1YKEA8EuLyaB+j/V1cHO5j9/CYlc0dlte3eTy/zMWhp2emnbZXjXT6RHaFTU9PE4vFmJiYcEpIr2KpD4p1/sw//BrluvKB39lhuNfrxefzvVYY/qyJougQfK2trYyNjX2oaZl7e3tMTU0xMTHxwpLe1x7NAyYRNru+x80Lg07fdod1UwI8mF+hUq2RiJqnfWsy5rR52t1L9UaTWDjI5eFeh2izQWGLO9yyi68/mmPn4ISAz0syFnZaJU97Q7srK+D1oKga+WKZ+bUtBrraCQb8+H0ex+u1W+WwVDzi9Ifb3s4Wv8Qs7iCTTjK/usX7j+a4N7XIzsExqqoy2t9NOhHj1sQIF4f6aE3GiEdC7FuHjQ3ypuPJTRDa8tBoOOiUxZxGEku04rV09nGb0GtPUas3cMkSW3uHtCbjuGSZW5dGiUUjjA/20ppqIZsvoaoatx/PcpLNkS+V8XrcTpRyeWzoud8pvHqEkqZpZ14N/VHaWwX3lStX6OjoeOqNv0qA8r0X2vnKwgH//b+8y/px2fn5605KeZXt7e1RrVaZmJigra3tja+j6zpzc3Ps7+9z8+bNF7KijabC/dllwGKkBZhZ3cTv8xIJBZ4w5u0pytU6pWqd7YNjblwYpCNlkjtmqWz/yXs4ylFvqlwZ7SMaCjg5rF3W6u1Io2oaum7waH6VUrlKNBQkFg7SbQFFFARH0lq3SKW4dahU63XeezSLrhv4PW4uDD6Zbd5pedNENOwMQrTzddubtsSjAHS0tVgMucH2UZa5lQ32j7PcnpynqSjsH+fIpJO0JeNcHhmgvSXBrUujBAM+bk6MEPB7uTTSTzoeY6Svi/GBHga7M1wY7CEWCTHc24nbJXN5dACv18OtS6OEgz5uXRqjv6uDkf5uLg73m4Kpcpn3Hs1w+/EcM0trzCytObV6uwOso82MmDKpBIZhEAsHUWplCoXCcx3Ty+7Ft7Fg4W3ZWwX38960LMuoqvqcR5sWC3h4ZyDF480cf/jv/A5fmtt7Izb8RWbXnLPZLH6//0OVKHRd5969e3g8Hi5fvvzS0/nxwprjie08tC+TZnJxHY9LplA080+vy/wKXJLE6s4Bd2eWcckyPW0t9HakHe9s93lHQwHuzSwTDvmdxYD5ot3nbb63dDLKSb5IQ1FZ3d6j1mjS1mJ6y96OVsfj2l1pNrnW1vJkGstXH8wwvbROvdHk1sSIkwJ0pO26ut/RxNu5dKVsgj5hCUbaUgkqVkpgE1l2DT/g87J3lEXTdB7MLjG/usmX7z7mzuQcM0vrPJ5fIVsoMr+yiabpLG1sI0kSS+vb5Etl7k0t8GhuiXtT89x+PMthtsDtR7NmI8rKBrIsoek6vR1tFmCtSMHACdvtCMY2mzG/fnHEWRl07949Jicn2d7ePvN2lG+WbZ8fObjPIh39wUsd7BVqJIIe/uq/vM0Xp7JcuXLlQ4XhYBIbd+7cIRwOMzEx8aE+8Hw+T7Vapa+vj76+vlde60v3ZyiUa1we7nUGENqz0Or1Jmt7J9y6OIjPJpPaEo5Ge23HLO30tJmClVDA/2TAg+0lI2HuTC8y0N3uML1N6xDNWIy3x+1ifeeAeqPJ/lGOcqVGb0crbS1xktEnK4TscUh2l5gtbPG4XUwvr3N7cp69oyyJaJhUIsrEcB99nW3OY+yxTk1rx7hhHRZhq987FY863t4Oq212354AY0cWsXDQCddt6WvNCsF9Fm+RSZsEaEdrilKliiAI7Fkchd2gYntce5mCraRrTycolCqIosDa9q71/q3ymMW2X7swQjqdZnR0lBs3bjAwYNa7V1ZWuHv3LrVajf39fZpW5POsfbN4749cfnoWcH/fxQzD6SAuvcF+WeW3lvL8t//sDqVn8vDX+dAODw95+PAhY2NjTs35TcyWkc7Pz+P3+89cq//y/RlKlRqKonHVmsFl37SD3RlUTeP21BIet5ug3+u0bUaCfvZPzKmcG7v7xCMBRrrtNMJwRiLL8hMRy8zyJlfHBhxhik1inS6xre8e0FRVCsUy+8dZBjrS9He2EvA90VrbYLfr6X0drei64ajOTvJF9o6yTC6s4vN6uDjUy7tXxunJtOKWZScXbyj2QERLN25NjomFA6aXNwy2rYYPe9yRU/u2QJiIhq1Dx3Cmqdrvz+3o282oridjRiMuWWJt2zxID54B7JPlh+b315tpo9FU8Hk9bOweEA0H8Xo83Lo0xrULw873aHeC2fvAbC1EvV5nZmaGu3fvsrS0xMnJCZqm0Ww2z7Qh5SwmCMJ/JwjCjCAI04Ig/HNBEF5rs+BHDm5Zll8Kbl3X2d9cJejSSFqNBpmon19/tM2f+oWvML+bB86+zsce+mCH9R9G26tpmtO5duPGjTMTcJVanQdz5njicNDP+5MLDHemOcpZrZ2yvaQvwXuPzZKSYF271+nzNjguVDg4KaJqGhf6OmhPRp1RS/Z0FHso4ObuEWvbe7wzMeIowk6H0nYH2P5xDsOAWlNhZWufiaFero0P4vO4LRnmk4GM9tjinkyr6WkNg80dmzFvMLW4Rq3eYHVrj4GeDGP93SZT7nET8Hkd/bw51MEcfwzmmCi7A8xm4G2Q2yy4neOnknFHDvpEN26+F5trsA/G3s52VE0j4PM617W9v30wSLKELElkWpPcvDTGu5fH6WhtQRJFvn5/kjuPZz8wEPG0GYaB2+2mp6eHK1eucPXqVeLxOLlcjq985St8/vOfp1ar8d577700HX2VCYKQAf4CcN1a5SsBP/461/iGhuWnRSl//LMX+NrKMd85kua4bH0RosCP/a+/y6/e3zhTBFCv17l37x6yLL+2yOVZs0P6WCx2ps610/be43ln2smhtZbHwGTB21riTkmq3ZoUenhSYHppnVsTQ3istT/pU6FsraEyvbpNd0cbY32deFyyQ4qVLG/b2ZZAUTUezC6xd5zlnUsjzrBFezJqOOA/NU2l5ryue9OLdHekuTLaT1dbygGGHeYno09UZ3Y9fMsZ6GiVsfw+Hi+scnCS5/H8CtV6nXqjyXBPhoDfx5WxAWLRMB63i56MGYk8IecM1qzUpWQdXnYKk7GqCu2phCOGWbe8c84Sr9isX8zRpbc6r9vjkrk0MkA46Of6hWHrHjKoNZrceTxLtd5ga+/QiRiG+7qeWvj3rD1b45YkiUQiwcDAAJ/73Of423/7b+P3+/nFX/xFfvqnf/qF1zmjyYBPEAQZ8AO7r/vkj9QkSXruCfasNjydUfG5HlBrarhliY54gFylSV3R+Bfvr+LR6/yt4TqJyPNDnmw2y9zcHCMjIyQSiec+5qx2dHTE4uIi4+PjTq3+dexL92d5Z2KIqaUNh+32ejwsbm3RmU4QD4fY3DtyQub+rlaWNna5PbnIpy+N0JaMEQ/5OMjmcckSK1vmNRRFZXZ1i89eu8Dc6iZH2QL7Vr7csFRZna1JVrYPeP/xHH0drdyaeBJi9mRSTC6smfPCLfWancNHAgFuT87TmozSEosw3NvpEGW2met8j0jFo06t2hGO6PZUmAhrW3uWVt183VsHJ1RrdcYHu2k0mwQDPoZ7O8mkTamsS5aoNxpUa3V0XSWTilOtVkknovi9HlriUbraUqiaTks8QrlSQ5YlPB4XV8YG8Xk8jPd3Egz6uDY+RCQUIJ3N0Z5q4eHsErpu8HhuCVmSEEURVdM4sA5Yu2Jgl9ROh+TPs1cJWAKBAL29vfzCL/zCS6/zKjMMY0cQhJ8HNoEa8JuGYfzm61zjY8+5X6QN97tlPj/ezupRiYW9Aj2JAIYBLSEvxbrCVzfK/NUvPmRq62nlnWEYrK6usrS0xLVr1z4UsG0Z6fr6Ojdu3HgusM+SGvzu3Snen1pitLvVmfBpM8vpRIxHC6u8c3HYmWSSsDxOwOfhval5cqUyQStH7O9sczzwnk1cKQrlap3PXLvgeOCmVbEJW14nEQmxur3P7ckFqvUG70yMOEqwvo5WS5hiOIP+bXB2pFtY2txlaWOH1a09Lgz24PV4iIYCzk19WpBi8wjOzDTr87FD5dZkzJxSCk5DRq5QYmFti2qtwe3Hc1RrDe5NL5Irlplb3Wbn4ITV7X0OTnLsHhxxlM1TrdU5PMnh83gcnfjk3AqzS+t8+d5jple2mFve4P7MAtlCiYOTvDOb3a4C9Ha201QUk6C0ohP7X5tvOAu4Pw4BizVK6Q8AvUA7EBAE4U+8zjU+llKYDe5XacP/8PVu4kEPw20RNrMVNk/KjLZHWdwrEPZIbJ5U+KN/93f5p181T2Nb+mnPNvN6X803vAic9rVUVX1hA8lZ8v617T2WN82wUXJ7GOzO0JdJs3ucB8BUjgrsHmWJhgOkE1Enx+23tnnWGwrLO0eM93c5Aw8S0ZAzl6xcrVNrNKnWG6TiUa6M9jnCFqz+5Z6MGZp63S5mljZ4f3KeYqnEjQtDDhHVmog5ob+tBLMPo662FLphsLa9z1fuT1EoV5BFkXcujRKy2nXtvDgU8Dlhus2827dCwl4U0JZyGlpsj16sPL1c0Na1d7SlHN7ALgHan1G1aj7HPvz6utrRdYOA3+v0iG/uPZ2bP5lnbh6i9mz2tpYE2XzR7B7bNLeiXn0FuD/GhQSfB9YMwzgyDEMB/jXwqde5wMfiuVVVPZMo5Z2BFKWaQjrsY/OkQnsswH6hyrXeJJ1RN0sHZYJeF//i9ho//r/+Nr/xe++9UPr5PHuRWu60jHR4ePiF13qV2q5YLPKPv/jr1v8zxybNrW2TSkTpaUuCYbBhMb9tLXEWN3ZpNhVnmqnfKvW0JqOcFMrMrGxRqda5eXHY0YoLAk6oLwoCO4cn1JsKQz0Z+jpaWbc8kWSVx/q72tENA0GAle0D7s4scnSSZaSnjU5Lnx0JBhxNux2K216vt8McxeySZW5PzvP+4zmOcnnSyRjpZJRr40OMWKOI/F6P0wFm943b33PKamjpbk9/wJPbJKFNNLZak2B6O9qo1hvIkvSkj9yq0dtnrGDX6C0BjQ1YQRBY27L2sVlbRuxSo7NSKJ1EliSujg1xdXyId69ceGEnmG1nmVn+lqSnm8A7giD4BfND/B5g7nUu8JGDWxAEDg8PzyRKkSWR75/I8GDjmFv9LaQjXhb3S2xnKyiaQWvES38qzOJenuWDAn/vQZmvbJx5o+lzO8POIiM9/V5e5Ln39vaYmZmhqAgkoyE60kmnm0vTNHNc0sVBxxPZ3U6pZIS7M0vcGB90vKhNtImCwNzaFnemFwgHffRm0vR3tjlezN4JFgkEmF3Zot5U6OtopT2VcBYR2P3avZlWR0CSL9eYX9+jWq/TlU4w0JHCJcsmUfcM4Gwg9Ha0omqaVR/e5+A4x+7hCfdnFhEFgUwqwc2JEW5cHGa4t9NJIfL2RBTrTrNB3pNppVpvWD3XJgifrAA2DwR7lZAtvDHloebhZXeEua1ozSYiw7Z0tbWFar2Bx+1yymO7Rydk0kl8Xg/vWgMcJFFAlkTeeziDz+t5JXH6cQ1qMAzjNvArwANgChOrf/91rvGRgrtWq7G0tIQoimdmr3/0ajfFukpd1ag2VMI+F12JAEvHdQzDQG/WMBAYao+zfFjm7/ynGf7MP/gq+4VXg/y05z2rjPRFz7fN5hD29/eZuHSZf/t7dxEEkcEuqzZtGKxs7aPpBg1V4/r4IAGvh2WLHY6FQoDA/No21VqDoe4nnmOgq80B5PrOIRu7R/S0p/F7PcTCAScUtkPY9lSC+7PLlKs1klFTV26Xo+wyY0ss4hww5XqTzYMTZLcbj1vm0mA3rYmIGR1Yr88uUUWtslhvR5sjQLEjiFq9yc7BCfV6kzuTc0iiQFNR6O9sIxzw8+7lMbxuN32dbU7Yb0tVezJmz7U5JMH8m9lniLy4xdb3drSh6zrhQIDt/SMMnijf7Hp2NBrB7ZJpiYYZ6GxjfKCLCwM9TAz3USiW2Tk44t7UHO89mmZ7/5BGU3EaY65ffHEnmG0f5xQWwzB+zjCMEcMwLhiG8V8ahtF4nee/Vbb8dKhts+E9PT2cnJycWURyoSPGuwMtVBoqUzt5bvQkwBAwgLCs82i3wrsDKWfnU1ciyO/M7LKXr/LHP9XPj7/T/8Jr251hjUaDx48fk0wmGRkZOfNre9ZzN5tNJicnicViDA8P8+X7s1RqdSq1OvlShetjA+SLZQfISlPh4eoaV0b7yOaLlCo1x0P2d7bxaGEVMPj0pRFkSXRq2NFQgHWL+DrOFfF7vVwa7uF33n/0VJhuT9ayFxi4ZYk+S5Gm6+YN3NnawlG2gNftcsQhxUqNcrWOKLvYOcpxZaTPXG27d8iylYvWrFA6GQ2zsrlLTyZtluOMJ+G1zbyHgwF03UCWJGZXt/B53TQaTXTdQNcMQgE/fq+bi0O9tLbEaYlH8Hm81Bp1NFVDNwwmhvuRJInxgR78Pi8XhnpJJWN43C6ioQDVWgOXy4WmqXS1pajWzJbNSrVOs6kiyjLLW7vcujTKg9k5Rno7qNTqtCUT7B2f4HG7nIjBVs29rM3TtrMQaqlU6oW//zjtrXvu57Hhr7tQ4HvG2/G6JCI+FwgCjzdPGIzJNJHQDVA0neNyncF0mHzVvKGCHhc/+8v3+Sv//A7rR6XnXlcURfL5PPfu3aO/v/9MMtJnn2977lKpxL179+jq6nLWHv3W7ceAOVllZmWLe7PL9HWYjLkoCqxY6jKvy8X+UY5bFwcd8s1tDXPIpBJ87dE8yWjI5sbozTxpBV3Z2uM4X6BcrTPS18GtiREnTN85sie22EKQFt57PM/BcQ6Py0VPJu0IPzpbk+jWGt1nvbTb7ebR/Cpuj4fWZIyro33OnrBiydonbunHO9vt2rfhDPS3G0nsenFfh0kU+i01WKlSZX1nn6nFVXLFErcfz1Fr1Ln9aI5ytc6DmUVWt3Z57+EMM8vrLKxuML24SjZX5NHsEvWmwu1J8znvPZrhOJdnfm2brb0D5lc2ANh32kntzjVrEqs9o7wljqbpZm/3cRZJErnykk4w285CqH0ztHvCWwa3oigfYMNfpVB7nv2BK1083MhxuSvOwm4W3TD3U4U8Mumwl0pDYSdXIxrwEPW7SYa8HBbNm28rW+b3//xv8o++vEhDffJ3DcOgWq2ytrbG1atX36hkZnvu03m6fUob1ugiWRIZ6clYzRkCWwfHjPR2MN77ZDdWvlSmoahkc0WGutoIBXzOaN6MVbY5yhWZXFjn1sVh3Jac0Rz6YO3QzuaZX9vBMAyujw8y2N3+pKXTKuvYI4+SsTBfezTH+s4BLlnm4lCP01/e12nKMDEMRxhjE0+ZVIKVrT12DrOsbO2TSSeIRSKM9HZQb5iePGKTU6mkM9nUVpLVn1lW0NdpNnGEAj7nMTZLb/9Ne8mhvb0kHgmZ7+tUw4c9vlh2FGoR6/qmrDcSDDjh+vqOJXh5Zvlg2pKh2qq5wa52FhfmWV9ff2ov2LP2DRiO+Mb2VsHtcrkYHx9/ig1/k1VAsYCH7x5Js7hzQjLo4UJnjL1ik+m9CkNtEYo1hWTQQ7mucGf1hPFMFFU3yMT8bJyUaagav/5oi9//N/8jX1/Yd2SkqqoyOjp65gENz5ogCKyurrK3t/eBPH1+bYf/+PWHDHa1O+OTIkE/8+s7zKxu4fG4GOhIE/B5WFw3w8FQMMDs2jYRvwdJMG8mO7TtTCeo1pvcnlqk1mhwcajHAWs44HdmrtUbTe7NLBHy+7g1MeyEzfCk39qel+73evn6o1mmFtdBgKtj/U4u3tWWckpH9uJAW/lld4LVGk2+9miWubVtqg2F0b4uWuJRhrrbiQTNaCEVjzhAsjkBOyIIOhtJTOIyGg46IbHTUGJ1wTkNJZknDR+5QslkwW2FWv7pNUF2GtNrNbV0tKbIF8vIksTqlpleOHPTRZEbE6OkWmJ0trfwqeuXGBsbw+v1sr29zZ07d5ienv7AqqBvwHDEN7a3Xud+9o29yRK/4+NjJiJ1jqo6iDK6YRDwSPQmfGweV8hXG4xmoszvFUgEPewX6hwVawy1Rjgu1ulPhVjYL7CTq/LXfvUhf/x/+Q80pLM3fTzPFEUhm806g+efbff89a89AGBubZtsscxAZxtD3e2OB9g7yrO6c8TFvg5HMHJk6avb0knW9o65MtTjaKF9bntMUYjJxXWmFtcJ+L2k4hH6Ok1wCAJOx5kkidyeXKAtGePa+CB+r8dhlu2b0a6jmyz8Dg9mV1BVjRsXhujvNEcJp+IRp1bt1L7tbjGr7zkSCrC2vc/c6iar2wcsbuwSCgbpzqQY6ung4kAXQ11t5vAFw3AGINglsCedYOb1ktGIJYJ5Ml7Y1oLbZUK7Bt7T2UqlVsfjepIz200iT5YXWOKVVMIcNjnSx8Xhfj599SKxcJBwwM/Uwgp3J+dY29pja/eQdy6P4/F4nEEeN2/epKenB1VVmZ+f5+7duywuLlIul1+qdfjEhuXwQSHL6+S0tkJsdXWVn/h9n+LTQylaIz6mtnNUGhoJv8zGSYVU2Md+rsbV3gQD6TALe3nCPjebJ2UG0mHaY34qDZX+lgCLB0WWcyp/8Yuz/JO7+5Rqz2/Te5nZdfBQKEQmk3nue/qNr94HYKQnw8LGLluHJ45arC0ZY+coh24Y1JrmON7B7jZn66a50E+gXG/i8/kY7G531uW2WFNOBBHefzxPsVKjJRbBJcv0d7Y5bLhddgv4fbz/eJ5MKsFwbwdBv9dRj9kDCQe6250+8eXNHe5OL1KqVulobeHScB9tLXEioSdsvLPf2zpweixvGgr4nfD64CTPxs4hTVVjanmTcDhErd6gpz1FIhxktDeDLMKl4T5kSaI1GT/VCWaGxu2ppLNBxPbOdophk1gpq5Ta29WGqmmEQwHqjSZdrS243S5uXRrD5/VwZWzQlJQa4Ha5uD81T6VWY2phlXg0TLFcxef1OAfEzUtjT32ftqPq6uri8uXLXL16lWQySb1eZ3l5mQcPHjw3hH9bYbkgCFFBEH5FEIR5QRDmBEF493Wv8Y2fBWNZs9lkamqKYDDI9evXEUWRm30t/LOvr5KJBUj6Zab3itzsSyIK8P7KEZmYn4hPZiAdJh7wcGf1iPaon2qjyMX2IIqiYACDrRHurR3z9TWd3/7fv85f/P2X+LGbvcjSq8+2/f19VldXmZiYYHNz87mn9sbeER6PB49LdkJDTdN4f3qJWxPD6Jpm9RsbbB/lOMmX+NSlEdyyzMzKJsuWdjwRCbG0uUvI76UrFcPrdhG0+pH7MmlWtkwgTS2uEg8H6EwnWd7YJRENOUC0Q+tYJMj7j+dpazGbVcq1mjMj3G6waE8lngwiPDxh9/CE9lSCvaMs33FtHFXV2D86cTxv1gqDfZ4nU1sfz68SCvidx9i90fZqonDQz+TiOp1tKebWthEwvXG9qRD0efB7PQR8Xno72+huT5GIhYkEA1TrdSRBRDcMro4NmVzBcJ+Z3nS3k4rH2D04pq+jjUez5oCL249mHP14U1Hoak+j6boz881uRkkn4qxv79Pf1c704io9HW3OAsEXmSRJxONxgsEgPT09uFwustmss9o3EAiwvr7+Nocj/h3gPxqG8WOCILgxG0dey75hK3xPm707rLOz8ymF2I/d6OGwVKc96keWRGqqgaobHBbrZGJ+MrEAs7tF6oqG1y0hiQKZmI/tXI1sRaGuy4y0RRxiLRFwkasq/PLtVX7gb/wGvzm1/cIQyzAMFhcX2dnZ4caNGwSDwRcq1H7tS3e5P7dKZ1vK8TRj/Z1UanVuTy3RrNeJR8zB+fZww0rNnH76uesXnJzUFnz0dbQys7brHBTwRKudiIbYPylwkC2wtXtAd2uCXmsFr1uWnSUHdldaayLO+5PzNBqmprq7PeXM7E5bteaWWMQBuR2Sq6rG+4/nCAb89HS08s7lUWRr+Z1NnNl933YXVijgc1IBZ4GgZW2WMKens416U0GWRDb3jqjWGqxv7bC2tUuhVGZqYRVFVXkws0ixUuX+9AILq5t87cE0kwurLK5tsbyxQ6FcpliuOHPH7VlxA90ZmopCJBQwdeOG4UQBduuo/dnYRN/NidHn3gPPMzvndrvdHwjh19bWmJub4wd/8Af5qZ/6KWpWheF1TRCECPBZ4BcBDMNoGoaRf93rfORhuW3PA5E9CGFubo4rV658oD6YCHr4sRvdnFSa3NvIcaXdT72psnpUJh324rY8bybu58sLB1zMRJ3xRZlkiPWTCpIo4HZJJIMeTipmKCqJAutHJf7Rlxf4kb/1n/jS3NOddIqi8ODBAwRB4OrVq07z/YsUar/2pXuAWSY5ypUY7s44pJrP7WJmfQ9VM8hYa2s9Lpn5tW1AoN5o0tmaYKSng6UN83XY5Sq3S+bezBLXxgYcpt0ui8mSyM5Rjo39E1TdYLQ3w0BHyiLRDEdpZpfYutpT3LGG+guCwGhvxnkvXdbhEA4+8cC2DDXo97G2tUexXGVudYNkNEjAZ846s/eD24MQbIY7FPA7ZTGbVzAM87Ep60Dp62ynqajWJBfzILDTB/s7DFvqur5Ok7tIxaPOMEVbWmqH8XakEHtmHVFXppVCqWzWtTef1LVdsoxLlnnnyjifvXnlA9/pi+x5hJodwv/5P//nSSQSfO1rX+NHf/RHz9Tr8ALrBY6AfygIwkNBEH5BEITXTuQ/Fs/9PI+nqiqTk5POIIQX7Q77wzd6iAfcdCcCVBUdWRJpj/rQDfjq0gGfG23lqGh6vnqtwnpe5dODKXZz5qnpd7u4v3ZMfzpMIugmFXKzvF9EFgVOSg3mdvP83d+c4Uf+1n/id2Z2nPy6o6PjA4sKnvc+VrcPWLfEIOl4hJNCibXdQ2cw/nh/F6qmU6zU2D7K8e6lEUb7Op2c9yhfZG3nEJ/HxY0LgwgCzkgl09sJzK5ssbF3yK2LT5oaBrsyDuD3T/LMr+0SiYS5OtbPaG/Hk7FGVknI3unV19nGw7kV5tZ2qNRqvHNp1PF+Njh9XrdT+y5Y89ls/iAZi3J/ZpGHs0s8ml8hGvLjccm8e3mMlniEcMCc7QbmYWHLUG2i0C55xa0BDgNd7Wi6TijoP1XKM1OLYsmecWZ+5hmL9e/JtFIsV3G7ZFYskY0dcdifia2Nb22JI4oiF4b7uDw2yGdvXCYaDiDLIrcfz/D+wxmujr+6vm3bq0Qsuq4TCAT4ru/6rg8z1ksGrgL/u2EYV4AKZ9zJfdo+FnA/W+u2F9onk8lXDkK43BWnoeq0hr3sFJpsnJTpbQlRqitE/G5KNYVKrU5vzENZl2lqBopm4HVJjLVHWT4oIokCdVVjcqdEV9xHd0uQobYoK4dFWkJelvYLLO4X+Llfucvv//n/xJYRJ5H84KKC5y0m+OLv3iYS9NORirNl9Ta3J8I8Xtnh5vggumH3OYfY3D/hvccLxMMhWpMxEtGQ06styxLvTy5yZaTfyWltsmyop518qcLtqXmaqspoXycRa+Vte0vc0ZhnC2UezK0QCgW5cWGI4e4MO7ZXPDLBZWuvW2IRljb3eP/xHJt7h4wPdJOKR/D7PPR3moBzu2RWLA9pD2mwZagDXWb4W6nVee/RHO89mmX38IRipUo4GODSSD8TQ71cGu7l8mi/I/G0689ODTz4ROgCJltvDzI8sIi8prUrrWnX1i2P3t+VQVE1IkE/u0cn+L0eNE3j6vgQPq+H6xeG8cguXLKES5a5NzVHtV5jYXWT7nZT9traEqen4+zTcF82s/wtzk7bBrYtfTmYGvOrr3uRt06ovWgai6qquN1u9vb2WFtb4+LFi2cmHr7wHQP8zL+6RzogkWmJMb9XoKFoXO6Kcm/1CEMQ6UpFEDAXym3nKuzmqtzsb2HQG6bcUJjbyeNziRyVGmxk63xmKE1vS4hEyMu91SP6k36Wj6tkoj7+xy8+5B9+dZU/dKOXH3+3n7DP7by3057bMAy++Lvvs32YZaS3HdHZlxVlfT/L48V1+jvTtLXEaY+HOcoWAYPJpXVqjSa3Lgzwu3cmMQwcUs0ly+wcZbnQ1+7Usu1yUE8mzeTCGgDfef0C7akEmVSC3aMsAZ/HybcVReHh3ApXRvq5NjZgKcLsWeNmxBAP+TnKFYiGAk7HVaOpoKoabck4bpeMqmpMLqwiiaIDcnulUTRkRokD3RnmVjYtL2oNHMzmWVjd5MpoP48X1rg2PshRNk8mlUDXYbi3E5csW2OMfbxzeYxwwJyUEg75yeZLeDwu6vUm3e0GLpeL6xeHCfm9BIMBvC4XE4M9uF0SfR1pQn4vS5sqqWSMqcUVvB43iqKiaTrpZJxGU3EmvNjAjFoKu3evXHgtD/uqyaZvY/KpYRj7giBsCYIwbBjGAmZH2OzrXudjYcslSUJRFGZnZ2k2m9y8efO1hrb/vokMX7y3znE2z/pxmdaoD9HQWdrNMdwWweWSWdgrUGtq3OpLsnJYZDAdZu2wxEm5zo2+JIOtYQRdZ3q3SDriY3Y3T75Spy3iJemX8brMLyQTD7KTqxLyuvjr/+4Rvz29zXBblC98ZgjxmZz73twq69YuMJ8s82hpgxvj/SxvmkAd7+/kwfwqIb8POW0SSsM9HSysbwPmAIero/0oqsrkoimbLFWqqJpOramSiIToSCecqSnpRJT1nQNCfh9feTCDKAiM9nUSDQXoakvxeHEVQcABucslc2dqgbH+LnNKqig5LaH259+ejJEvlvF5zFBcNwy29g+ZX93incujXBrpJxYOMrO8TlNRHAA789EcT95ubjxxyaxsmKGyPQbJ+VupJHenFszva3UTQRDweT1Ua3WG+zpZWN3k1sQYj2aXuHlplEdzywz3dvJofpmg30elVsfQdVKJGIcnOS4O9bG6vc/4QBfVegO/U6prZX5lk9Zkgv3jE2RJYtl6Tfau74ql9HvnyoUz34evMsMw3qb3/vPAL1lM+SrwJ1/3Ah8bWz49Pf2BhfZnNVkS+exwK6IAh8U6qtJEUBscVjVqKtQUjXjAw3gmyvROnkpdoSPu56hUZ6gtwtxugcX9Ij63SMwv05UIclJu0JcK8f7yEaoBQb+fVNhLwaqD21+SKAj8s68v87O/cpf/7osz/M7cgTPd85d/+31ujg8gAGu7hxiGqbDq7Ujj87gRrNZFl0vi7swKlwa7nM2ePo+b+bVtHsytEgkEmBjqIejzsrBu3oQeWWZz/4hypUZHOkEsFHQANdhtDijQdJ07Uws0FZV0MkLA52Wgs93ZDGKrvsIBP7PLm9TqDUJ+HzcvDpOzWH271DbQbfZ9u2WJJQsI2XyRx/Mr1BtNDrN5rowNMjHUx8RwrzOmyH5N9jDFAWuy6+nebrs8Znu0NqvsNNDVTtUSpNgHwsHJ07PUY5aH7e8ySbW2VILDk5yp1bfy7WLZfL9enxnie6zhD7HwE9lro9kkEYuwvX+EKAoUSmWuXRjm3dcE98vA22w2P9TCy2f+ziPDMK4bhjFhGMaPGoaRe/WznraPnC0/Ojri+PiYTCbzgYX2r2P/xa1eNvIKE61eBMNg8rDBpwZSxAJuZrYLCAJE/W7y1SY9LWEebma52BEjGfRSrCmMtEd5vF3AMAx8bgmXJCBqTXSgvzXK7ZUjEkEPYa+LjniAxb08Lklk49hkYw8LNaZ2ivyj9zZ45//+r/mffuUOX/zaLHdmV3lnvJ9ixST1vG43D+ZW6WpNOgvvh7ra0A2Dx8ubKKpGV2sLo30djjx0+/CEqaUNbl4cMgc2GAZ7FkHU0Zrk7vQykiwR9HsRRcHRRw92mUCu1hvMrW4hSSK9mTR+n4f2lrgzT9xeYZSIhtk5PGH3KMthtsDlkT5no4gtKBnq6UTTdGRJchj3wxOTSxCB9x/PUaubYB/oaifo93L9wjCG9d3b5SV7SETQ733ST23v9LY61BKW9HWg54kmfH17H4MPTkW1m2E6LC14f1cH1XqDUMBenmiwYenIm9bhG7Bei9cj093WQn9HKxeH+rg8MsDmzj5buwcMdHe8/s34AvtmUqfBR+i57YX26+vrZDKZN9Zz2yZoTT7f7eK4ZlBWRQZSIRqqxuZJmf5UiGTIx5cX9nmnvwWfWyJfaSIKApPW4AeXJNLUDNrCHr48v08m7CIaDiMIT26GsNfNvbVj2qJ+RjIxLnbGOSzW6W0JsX5cpiXoZuOkiiSK/NOvLmOkhvD132RXD9Pf308qHmZ2Zcu8VtDP/nGea2P9jrCkM5Xg3uwyh/kCcUdIEnfaOfOlCm63m++4MkbOYozLlmSzI5Xg9uQinemWJ9M+La+WTkTZ2j+mWK5azSsy4wM9hIN+QgGfI1G1r5VJxVE1ja29I25PztOWjOPzeOhsbSEYMEE02GOSVZIoOqWqvFUn9rme7IF779EsD2eXeDy7hMclIwkiNydGaGuJM9zbwXBvB6IoEI+GrUjCYGv3iS4entSbey0JbHtLgsOTPIIgsLxppjDPDmtMWD3edpmsPZVE1XQGezoIBQO8e+UCsiTRkU6iGwIbe0dousHUwioNS79/aaTvhSuDnmevWgD4FqewvBX7SHJuu885Eolw/fp11tfXX1tfftrs3vDPD4Q5RKBYU/C5JQzDoFRX6UoEEa2JGrphsLBX4Ep3Ak3XKTY0GqpOqd6kO+GnaqmVUvEIt1eO+PRQmlylQdDrYuvEzBHrisbUVpbrvUkudsZJBD2sHZVoj/o4KjfpjHnJVRrIehPNHeCw1kT0dRBuTxCoVahur9FQVSr1Btv7J/S0p5AlkUQkwNbhCbpm8N7kPBeHeggHvOweZpElkYX1HSq1unmTdqZpKDoLa2boaS8aEEWRu9NLXBzsQbMY6K62FvZPcvi9HhbXd1A1jeN8AUVR+fSVMaaX1snmSyxaub5NqnW1tXCSL1KpN/i9O2a7aiad4J1Lo7hdLubYZKC7nfm1LURRYOfQBLlqgcHahER3e4rVrT1cssTd6QWaimLm0GtbXB0zZ4CP9HaSjRdJRMOoqk5fZzuiJHDtwhAet4vxgR7i4SAD3R20pxJ4vR7iEXO3t0sWkV0uro4N4fO4effyOH6/lxsTo4QDPtqSMTrSSe5MztORbuHO41krL88iSxLH1pilA3uOnWR+lp+6cpH9/X0WFhbw+/3E43Hi8fgLHdG3UkcYfATgLhaLPHz4kKGhIWfv9Zt0hoHp/ZeXlykUCty4cYN79+5xuSvM1xYP2c5WUDWDaz1JFvbyHJUafGYoxfpxmXJDxSWLCBokgx40TWfloMRgXEZyiyRDXo6KphdrqjqzO3m+a7SNteMyfakQ87t5Ql4Xq4cl8tUm3ckAPS0h/G4JtySQtYgiTdPB9SQPq6vQ9CZJDIRZUcHV6iaW9HNnbpauVMLRi4/3d/JwfpWppQ0mBru5MtJHU1GYXt4EzNr3yvYh10b7aWuJcXd6yWnHTCeirO3ss7V/RKlc5fqFQWca4VBPB4/mVhAFgaWNHWqNJoVylYOTHN95fYL9kxwLa1sO4WYPdxjoaufB7BIBn5c7k/PousFIbyddbS10taWdEuDcyqazfQRBAtmsItjMeSYVZ333CI/7SQ6dzZfQdQNV1Zhf2eTGxAh3J+fp7WxjbWsXlywhYMpFa40mK5u7RCNBVrd2SCXGWFzf4uJQH49nl0gloo5H9/u8VKo1+rva2TvK0mq1ytqLGLozaQ5Psgz2dDC3skEqHmV7/xBZklhcM6Or3/fd30F3ptVpB85msywsLNBsNolGoyQSCaLRqAPob6VebvgIwO31erl69epTp58sy04odFZTFIXJyUlCoRDXrl1zcvU/+ZkB/s39TdqifsJeF3N7eVIhL60RP9vZKtWmwpXuBDvZKrv5Kp8aSJEvVwm5RZDdzB9W+PRgirqio+kGy/tmHfyoVGf9qMTnxtpQNYNkyMP9tWOG2yIs7BVoi/q4vVYk4hWpNhX0Zh3B5UMwDFz+MLph0MAFhk5NkBFlcCUy7Gg6gZHvoKhUqFcKjFxMo6kmAZSKR5hcMlny77p+gVj4BJckOWE0wO2pRa6O9VOrNzjOFckVTQ5goKuNe9NLPJxdIej3cuvi8JNcvDvDwvqWuSFk98Ai+prMr25x48IQggCTC6tsWISXrbEf7G7n0ZxZSlre3DW3dwR8zK5scOPyBQbGLyF5wxwqEqLkZ23PrM40LO4g3ZJkffeI7rYWFjd28Hvdzt+w92sb1i72VDzK2tYuA90dzC1vEAr6LeGM4WwPtfNtu+Glu72Vw5M8A90Zlta3zedYB5XdwOIsKrAOroi92jfTxuFJnsGeDgwMutpbnUUEgiAQCAQIBAJ0dnaiaRqFQoGTkxNWV1eRZZlEIoHf738pZ/TN5rnfes7t8Xg+ENa8rucuFouOSmxoaMj5QAVBIOp384XvGCDokbm7dkRPMoRblqirGrIkEvF5qDdVMvEAI20RVvZzzOyVuNqT5LisEPdJ7Oar3F8/pjsZIBXxMdIeZX43T8TvZmG3wNZJGZ9bprclRMSqcUdcBrohkAx6yDZFZAHcoo5azqJpGn5JR5Bk9HoFEFFrZQRBRFTNCEGWRaRoO5tVN6tyN8GBG0iZC7iS3ciRFA+Wd9F0uDjUDZgsvV0yc8syc6tb3JoYdphw3ZJ+jvR2UChXuT21wMb+ETcnhmlJmPloV1vKmZdmC10kSeTO1AIt0RA97SlG+7ucyaceS2bb29ODEUzgywyzrkYJjn83a1qSQ28ne0RoIiOIIuFUhncujeJxu5wQGiAefdIjbhiGuW7YYu7tLiw737ZZ9v5Omw1PcnCcs/LtJ6z9abN70O3ntCajZPNF81Da2MacPHuAKIoIgsD1iyNEwgGG+zqJRULMr2yQjEVeCFS7SWRwcJAbN24wOjqKLMtsbW2Ry+WYm5vj4OAARXl6l93bzLkFQZAs6em/f9NrfGwilrOCe3d3l42NDS5duvSBD8q+zh//VB//9OsrXOgwSypuSWT6qERvIkh7zM9XFvZNzy5pCILAcFuE1eMyqm4wEPPwaL9MdzLIwn6B42KDTw+laAn7yMT83Fs7ZiAd5vbyIV6XRNAt0hlxoQrmR3WUN8Fr6DqK4EYQJRAlquUCstuN3+eiCmC9X81ihmtNFTxmuaYJ4A5QEmTcbQOIhoEmSGi1Ig8qLloGL+Nzu9jd3kKSFDZzVZBcqJrGUa7ErYvDjgY8aKm1etrTrO8esHNwzFB3O9cvDDrlqGQ0/GRqaLGEILsJRBI83skTSyTQg1Ey7RfZ1DWCl3vYFw38/SbQ1fIJosdPvVFxPIHeqCK6vJR0D6V6lZmldTxuFyf5EuODPXi9bm5OjCKi05qM0dmW4u7kvNOFJgCLa2YKkrOA67G0+J2tLewdHjPQ3cHS+hYBn9cBuV1as8tvdpdXMhohGAiQSbfQaCq4ZIndw2NqtTr3J+doKqpTGx/uMw/Pz9y4dKb7EcxotL29Hb/fz8HBAa2trZycnLC9bR6+sVgMv99PsVh8m577pzBHGYff9AIfi4jlLKOW7Nlr9oKB59XC7dHEfo+Hv/C9o/yTr68QcstM7+a51d+Cpul8deGAy11xmrUKs0cN0hEfbVET8AOpEJv5CsNtUVIhL19e2Ge0Lcr9tWMkAXzpELGAm3jAw/JBkZ64j6mdAgPpEBgCF9rDTO/kMAwN3F4Mw8ATCKEioss+VNkDqHiMBjUM0BQMK3THHcDQNZqCC0NtIshu9HoZ0RvAS50aEhI6quSjbtSpy1HC3UGagpuCoROIDLIgykjdMRaEIGrUT6ojzFKjirf3Cko4iEdM4vX6WK+UECsBooablkufQ5Rd+MsVJE+ArVqR4MVL7Kl1/ANDNACtWkARg6jVLHJQRgVEtYkuuZ0B4aIn4LxuwfmZH59kMvbDvZ1MLqxSq9eZW1lH1w0yLQn2j3J0taVIRiMM9XbSkogRCwep1eooqoKqqIz0ZlCUJhcHewn6fVwZGyQRNXXq4aCfaq2O2+VCUVV6M62oqsZofzeVWh2vx01TUVje2KElHuX9R9PcvDTGysYOF4f7mVpYprM9zdbugXlQbJj59nfcuPza97GmaciyTCQScRZMKopCLpfj13/91/n5n/954vE4qVSKH/mRH3E4p9c1QRA6gN8P/DXgjReOfSwilhftC7OtXq9z9+5dfD7fS0Uup6e6/MFr3WSifmqKxpWuOPlKk+ntHMOtISrlCttFjYudcTrjAb62dMB4JkYq7OWkpiEKAtPbOW71txDxu6g2NQZaI3x14YCg14UsCQTcIlUrdIwHvCwfFjnKl0DX8Bp1JFHAaFRRkfAKKqLbC0odFZmaoiMG4+iKgq408elV9EYVt9EEQUBvmGUuXTVzSju8c7lMTyR5AmAYKIIbGQ1BEDEaVYc4U0UPmitAVfTT9CZwR1ooikFEbwg9mEIKxHBFWynLEWqCl6rhNrd6yG4k2fTIuuxFV8y/b2hWt5w36IC5WbN6t4NPHIdHML9Dyf2k22nfmiht16EHujLouuHU1MFgY/eA43yBYrnC47ll6o0mtx/PoSg6jxfXOcgWuT+7xNTiKven5nk4s8Tmzi73p+ep1evcfjxLQ2ny/qNpCpUy96bnOTjOMrWwQqOpOGmFLZZRLQ7AztXtKS6DvWYN/8JQnxPav449rxTmcrlIpVJ84Qtf4E//6T/Nj/3Yj1EoFFhbW3vt65+yvw38FeyOmTe0jw3cL/Lc2WyW+/fvMzAw8MJNJM+7jigKfOEzgxSqTY5KdeqKRnvYjdqsE40EURHwWK2TLknC65K4vXzIWIsHn0siW2lSb2os7ee50deCqhvmJs6wj68vHdIR9ZGMhUkGvawdlxAEOMhXQHKjGiIaIrrawG00qJRNEifoNj9OQ7HCRtlA8gYp15uI3iAuyfSSkYALUamBaB5iTUzAKZIPNBVBdqM1LC20YubYIav+LLjMf0VvEMnQzMOi/vQCAdECqSBKzu8a1kGFO4BgsU1Gs2J9sFZLq+zGhXXQWAesIrgRdPNnbklENlT8HhkqJ1Avc2yNFzvMmsCyW0ztDrN2K4cGWLZaWu0Bh/a4pb4us77d09FKwer2stOIdStHt0crR62wt8+qiQ92m2KWaDjoKNbMvPvJa2o0m7SnkrTEo9y8NMYPftdrDzUBXl0Kq9VqDA0N8dM//dPcvHnzjf6GIAg/BBwahnH/jS5wyj6Wfu7nheWGYbC+vv5aC/yebbm82ZfkByY6iPk9BCWVUkMlEg6zma1xpTtBqa7wYP2Eq90JdMNAQ0A3DI6KdUbbI+gGnFQUdMOgXFMYa4+wcZgHzMEDd1aOGGgL09sSJuYVwe3DUJvoshdD1/EGIzRxgyijVQvOGF23xwRZTTVB5PGbN2RNk5D8EcqGF132IPuCuNQKerOGWM+bgLYAZ6gmGGvWfPaGYd5UkjcAahNBEByyzmdt26jp5mcvym7cFkh9LvN5ott8TYIkmxEEELC8rewLgcUNSLrlnb0+M8KoF2gUjlHLOcpNFUWQqeJB0wFPAH+ijU9fHSfo95GMRdi1vKh9F7RbK3gHujMUyxU8LhdL62ZobG8KtXux7WkoQ72dNBWVRCzibDG1VW47+2berTsqNzOy6LfWAA12dxCPhLkxMUIqHuXS6CC7B0fsHh4xu7zO7Ucz3Jh4eqTSWe0sq4TeQs79aeBHBEFYB/4F8N2CIPz/3uRCH4nnfhbgz4bldi93pVI58wI/+zrPHhL/p5sdnOQK7BQ1+tJxVAP6UiEWdgscFevc6m9hO1fhwcYJnxlOk61pbOcqhLwuPLJIa8RHqd5k7biM3qyTCAe40BFjfjePWxbJVZrcWTnkJFdAq5cJyDoGInqjhipIuFCQfEG8/gCKK4BWLeJ3SeiNCqInAFoTVXDjRsOQ3OiNCggSWr0EgogkisjBGD6vF8kbNAk4pY7P7cJv1DA0Db2SR2k20GolMAyMpun57HDe9vyCy2teH9CaJvAFKwwXPX70phkFKA1re4sgodfLyFodt1LCr1fRlSZarYxqyCZCvWFE2Y0UjKG7Ak9CeSt8V0QPlabO5MIKkiiQL5YZ6s4gS5Kpl/ebCwUy6SThYIDBHlN2GwkFrCaUJwMU7XFIzgoky/sPdGcoV2sEfF6OskWSsTC1Wp3BrnZ0VWG0t5OQ30dHuoVkPML6zh4GBu8/mqGpKBye5GhrSbC9d4jf5/3AvLSz2qt6ud/G5FPDMH7GMIwOwzB6gB8HftcwjNfa7mnbx0Konfa4lUqFyclJurq6yGRevnTtWXsW3MfHx6wuLPB//d5R/tX9XQRAUXVmj8r0tgTwuWS2shWSIQ9Br4vdfA1Nh2u9STaOyxyVTPCXK1VSQZmiJrF7XOB6b5LB1giSKHBv7RifDDW3H1EQaOoqbqFJU9DBMKjXakh+Ny40FGRkSaBkuPDJKrqgUq3kkdx+JI8EgoRPFmgAhvU+yrUGcsCHYggggMsfRkOkiQvV0HFFkriNBg3Bg1GyBiqqCl69iQp4jTr1Rh212SAUClGoFgmIBpVaDbGpILpdeGUFUXJRqBaQBIOmoiK5DZqiB0QdVfah1qrIngiGS0YSZBAEPIKGAghWji0IApLeQMfj/AygKlrCkfY0dybnScQ03ns0Y4lNPFSqdcYHuimWygQGuomGg4wP9rB3nCUVi1Cu1mlPJREEuDw2iCCIXBzuI+j3MdRjKtZKpQqd7SnuTc3Tkogyt7qJz+thbXsfVVPZO86SL5ZxW5GKU+e2BDad7a3sHp7wHdcnnDnwr2uapr3UEX2ziVg+lpzb9uSHh4c8evSI8fHx1wY2PGHL7Z3cq6urXL9+nR+6PsB4JkapoRD0uhjLRAl63czu5kiFfWYHlaYjiyI+l0CpptCZCHKxI8bs9gmz+2X6W2NE/R5GrJXBszs5GqpGb8JPpVQCUSIg6qiim7pqgDeMpDcBHQmNsrUg2+Uxv/xqU0PBRSAURvQGqNSaaJU8IgaSriC6TUBIXpM8awguJDR0QUZvVBAEEcUitWSLV/H5/CAISP4IquACfxRFN8AXIRQIUhN8SG4fiiuIK5xEDkbQPSEq9SZV3Hh9AQzZhxyMIVjXtMk9wVKbCZILWTO9vj3VRPIEcGEeRnYtXPIGHS++XzF/Zw9ksFcEd7e1UKnW8Xk9jirs4DhLrlim0VRY2dhBNzDnpikKD2cW2djZ4+sPpphaWGFyYZnF9S0OT/IcnOQcr2mH+sO9XaiaRmsyTr5YJuDzOuOdFlatzSOWeKapKPR3Z/iB73yzfBvOplB7S8MRATAM4/cMw/ihN33+xxKWG4ZBvV5nc3OTGzduEA6/WelOFEUUReHx48c0Gg2uX7/utNj9he8bJRn0moSyYTC7k2O0PYYkgiwJbOUqqLpO1CuxcVLmpFQnXyrREfNzsSvB9E6OtcMSiaCHaMDDWCbGzFaO7WwF0W2Gu5qVjxpqAxBQFQUpEDNLXpoK9ZIZIqtNJG8AQ1VoCG5kdARfCNHjpyYFUDQNt0vC1Syh1cr4qAMCmkV+BVxPfy32waFIPgRDNwm3urXlUrB+Zym/JH8IDB1BlPBivl6XdUOqksdkwwWRgGQ+z17OKHpDCNb7c0vmtVz+iBN+N6vWcEFE3FqdkNDATx1BV9F8CURRYNHKpe1eaTu8HurpQFE1krEIa5YKzc6hbRVa2Go9tXPn/s4M2XwRv89rHQwGm/ZM89rTM80TVgPNUF8Xmq7T35UhGPBzeXSQaDhIX2c7S2sbrGxsMzHUe+ZGkWftY8q535p95J672Wxy/75J/L1oqf1ZTdM0VlZWaGlpYXR09Kn8x+eW+R9+ZIKIz4UkivS2hKgpGk1NZ+WwzERnnNaIj+mjJn3JACFJYSOvUlUFBMHccjLWEePOyhGluoLfIyGJ0KjXTNGHz0fdcKPVy8SsUE+3aCOPLCL5QgR8bgxVQdZqeAUVvWl6YK1RMQcTWKUkvVlDFVzUFRU5GDNzTU3D75VRy1lK5QoemsgePxgGoieA3qyDIKBa3jxghZ+VhuktVZcPQ9fAyqMBdMX0vIJF8JmHgvk7RbHZc/NvCKeuXdfMA1kSDNTiMW6ljNKoodcrNHFRV3VKuptyXcUQZUSPnxtXrnBxqI+bEyMICKTiUWcSrC02sccZ9Xa0c5wr4LaGNgBOf7htLdY006GeTlRNo7M9zf5xFo/bZT7HgMPjHN2ZVjxuF+9cHicRDTPc20k6aY49lmWJh7PL+LxeytU6A90ZZDTu3r3rbBN5HVn0WbaNvE3P/WHtI825i8Ui09PTDAwMsLy8/KGudXx8zPb2Nul0+oUhfWc8wJ/87BC/8HsLSJKLUk1BkkSGWsOomsGdlWMutLhQmg3mThp8x1AaRdO5vXLEUDqE1yXikSUG0xG+tniICx0REAwdRVMRRDeSIFBUJbw0aEoiuq5SMUQEwaCmCwiyC0PwUMdFwO9DMOqUlCaS28AQzRtDtkJgJDPqMNw+BFGmaghIfjeCIFJTmoguD34alOsKflGjXKpgqApet0ypWiMQ9qB4/OiagiC50Ot5JH8UXVUQgZohIQGa4HIIPkNtgO43WXjVzFGrpSLhcIiy1sRn1GmKMoKuoEouEAUariBy0IUomYsZDaUObh+i58lQy5zmZvHRfS6N9DO1uEosHOQkXyAVj9BUVS6PDRIJBXjn8hiRYIBUIorP66FYqiCKAoqqcmlkANlayOfzerg5MUo0HOTdK+Yu7XQiRsDvY3NnH5cksbi+hc/rYWf/AFXVaIlHOcrmGerrAuxlD09KhN//2XcZGRnBMAwqlQrZbJbZ2Vk0TSMWixGPx4lEIi8kzV5FqNVqtQ/d2vw27SMD987ODpubm46MdG1t7ZU5y/PMLpkdHR3R19f3UjEMwLWeBLV3B/jHX1uioWo06xqJoJe9XIWJdj9HRdMTD7RGaKg6KwcFrvUkMDD42tIhV7oSFCp1MKChNBE9fjyCSqWhIsgiXo+HBlCpK0jeIB6tSrWhEPJbYhGaNCUvulKnJnuQ0JCDcQStSbVeA2q4AyF0XUXyBhC1BrrkRlLraJIXsVnC8AQtiad580uhOJLQRHa5QGvSFF3IIT+aYXrOACpVQ8dQFdAaIIq4DHMQBfUiuuhCVOoIbi+y2wuihBSIYSh1mpIXpDJV0QdeqOEFEcRGEV1yEQwGqQOiy4Nbb9DEjc9rfgai24deryB6Axw3zVvJDpUHujLcnZrH43bxYGYRURTwez2UqzXG+nuYXV7n1uVRHswscOPiKI/nlhns6eDx3BJBv49ao4GmaaSTcQ6Os1wY6mN6cZVbl8ZY29rlncvjgOnZH88v09eVYXVzh2g4yOLaFpIosrC2CRhs7R/g9bj5/KdvAE9GEdsbRVRVJZfLOa3FPp+PRCJBPB5/ikB71f1rGMZLwf9x20fySpaXlzk+PubGjRsOe/gmbZ+apjE5OUmtVuP69et4vd4zXeM7hlP82e8eoTMeoD0WwCUJSIbCQUnFJUmEfR6CHhlJNIfZiaJAQ9HpTgbJlmssHJSQMWdqCxg0VA3JG8AvQbXRwCNoSB4/hq5T10Ukf5hyvWGGvGrTFIkoZi1aqZZBEAm6RaRA1HxfhohayRMUGjQrBQy1iVu0JJ0WzSuIT9eny5pk1qKtcpogCDQrZhht6DoIIt5wFCQPciCGphuIHj9uSTCvIbkwEDHcfiSboBOt2rYtjHH7kDUzTLVHFdVxm3wCIBnmv4rkdZRsWqOCWC9SayqA4ExvsccktVnqsOHeLsrVGqGA7wnoLK24vSQgYTWcDFlKsp6Odg6Os/i8HisUfzJtpVQ1iUCX9TrtGvlAdyeGYXBlbIixgW6+89YVfG43QZ/vhfVtWZZpaWlheHiYGzduOE7E3hG2vLxMLpdDVdUXgtuwUptvJvtIwN3V1cXExMRTMtJXSVCftVqtxp07d0gkEoyNjSGK4gs3fjzPrvYk+LPfM4Ik6Byd5EhGAnSnIoQ9EuWGgiQK7BVqDLWGqTU0dnNVdFVj/aiAS8QckYyMXzLQdDM0NyQJyROgVqvjl3QkrY7g8uJCRfQEkdxeVMmHrqnIMniMBliDAQrWHvFAwGS8kT2UDTcefwhBdlOpKaiVHF6PjFYrIXn9iIaO6PHhMpoIomTWuQGvRXjZC7xrujm4QhVcjiLNbZFphmDdjN4ghqaaLHzFHF5gWF+/4A06opl61fwbDcP6nSCiW+RdqVpHq+TRqwWUwj6SoRAIBtC9IeRIiguXLpuhqyA4ubQ9hcbu+bbHOHW2pcy8WJKcJpITS9RiA6jVAuxwXzeKqtLT0cb+UZaAz8vCyiYCUK7UGOxqx+txc+PSKF6vG6/HhSxL3J2co9FosryxzXd96pqz8vdlZrd/nt4RFo1GOTw8pFgsMjs7y87OzlObP237sAAXBKFTEIT/LAjCrCAIM4Ig/NQbX4yPKCz3eDwf8LCv47lPTk6Yn59nfHycaDT6RtcASLoUvrdV4981w+iIVBsqOyWFofYYTdUgFfayflKh3lAxdI2tfANJctFoNokGvBRrTcqagejy4KJJrQleWaLp9VFRzRvfi0K5UkbyRwjKBhVdRleqCN4w9WYNl9eHjxpFA3S1SV0yS15YgNJkLzIqaiCM2KxRwQcUQJBolE4IBIK4UKnVyoTcEpVGlbpuILlA8ocR0dFlN3qtiOQLoyt1s/RWV5ACppcVDA1DkNBreVOMYpiwrgsu0DVLplpGCsYJBgMoao1mvY6u5vF6vTSadVw+BckfRRQMDEFC1I7RBBlVEBANHUMQqUhBsvkiE6MDHGfzdLYmCPg9vHNpFJcsmaOLAwHGBrpJJWJIokRLIsLu/jGtyQS1RpOO1hYajSYjfV14XDLXLgwTj4R597KZd8ejYcJBP3NL64RDQeZW1okE/Sxt7iCJormHrNFkw+oJz1v97z/w2TcrgUmSRDKZJJlMUigUGBgYIJvNMj8/j6IozlCHFy3VeE1Tgb9oGMYDQRBCwH1BEH7LMIzXHmsMHxG4zypBfdYMw2BjY4ODg4Onyly2nRXcp/P0H/6eT/F9msCf/Ydf46BYwyUJHJcanJSaGIJBU9FoKCpNzUBCQBQNDJebQl3FK0uouo4k6qi6C1ECSVCRDJDQUGUvda2JKxDBUJpU1AaGC0I+D1ULzILbh6YLSN4QPqNKuVZD1RS8oTia2sCQ3Wj1KnjDplgGzHZRQUCQZBqSl1q9ghyIUTc0BENAFATTiwsiPllD0QXCPpls8QRdbSLW86iagt+oUizXkNFxebwE/S40vUpRU/FpFUrVOoKhmco2VUPSdWqGB0nSkYJeQtSp4MUtetAFGUEAl1qhKQfw+IOomOmDWskjBaLkNfP7EgydnYNjWi8Mc2/KHH20vX+IKAoE/X6K5QqGobO+s0trMsbOwRE3L41y5/Esw31dTC4sEw0HWVg1Fy/GIkFyhRLDfV0srG5y/cIIB8dZZ+ZaV1uKqaU1xgZ7mZxfpreznbWtXWKREAurm6STMT73zmvP9P+APW+oQz6fZ29vj5/4iZ+gUqnw9/7e3+MHf/AH6enpee3rG4axB+xZ/10SBGEOyPAGM8vhYxxt/KqwXNM0pqamHEnq80bEniUst69TrVa5fv06brebkM/FP/2z38lnh1opNzR28nWqikqh2kSwQvCAWyTok1F1AV3TiPhkGjqIogS6eV2fDDVdRtEFVM0gIOtoShMDUxyDL4yhqSiajqzWkKxSVtV624bgQvJHcHkDKIY5Az0kKihKE0NTaWI1ugTCYBhIvpAZmnsDoNQxBAmfoJiMtVVLLzdUVHeQqiEjhxK4o61mNBBOoqg6ciiBLxBAcQUp6y6qgg9XJAWSCzmUIBAIIPpCyMGoOcFUFHHpZgqh2R+124toTY+xp7aooueJFFVXQVfNspLsdtYh2TKxzjZzYulofw/FcoVIKGDm3caTnV91qyRlrxkatHLnkf5ucoUS8WiYhVVzzJMtULH3hjWt+8rrceP3eenJtPHO5XGuXxihtSXO5bFhAv63z2JLkkQikWB8fJzf+I3foLu7G13X+eVf/uUPfW1BEHqAK8DtVzz0hfaxgvtFXrdWq3H37l1isRjj4+MvZBxf5bnr9Tr37t0jGo1+4DqCIPDX/ug1fvxKAr9LwC2bnWK6bo5Erqk6hZqKYeiE/B6KdZ2QW0JTFZpIeN2yWT4ydIIuEVxeSjUFr9eHW6879eawz4UiemkoKoIo4tUqoGu4jAZ1XMiG2eNtKA3wRSgrBnIoiVuEZkNBLR7iQUWt5BEEEckCld9STFYtIilgiSVETwhD11EFt5lvCwJYGnLdnu2G21zEJ3uc/LlcNv/VrHKcILvQrZy+aolE6oJZtwdo1sxcvqwKZu6uVPGqVQJGDZ/XB5iEYbp7kGyhhEuWmFteB3BGQ9nzzYZ6u9B1g/7uDAcnOXxeD/MrZt69tWcqzBQLsNGwPQ/dHEE81t9DsVKhp6MNj1vm8uggPo+HK2NDnOQKVKs1Nnf2eP/hNAfHWfYOT/jh7/nMC++Zt2XlcplkMslP/uRP8pf/8l/+UNcSBCEIfBH4bw3DKL7q8S+yjy0sfxEws9ksc3NzjI2NEbMWq7/IXgbuQqHA9PQ0IyMjL+0w+6GxFN8x1s3/498vcFiooegGggACAi4JfC43taaKz20Sb4boIugWqNRVcyCgpoAo4zIMFAwUJLySjijIGPUyVbcHQTCQZA+GIFFRTYmp0SyjKTUzZ/VGCLjMEFytV5ECbmRdQfIGkESNmuABoQoC1Bt1grKE2myiKXX8Ph91VaEuuZE0BV124dYqNPFjqHUggG4ISIAqec18WJQxqgUEX9gBq906qiCj1YpIPnMAZAMzl8cqrWmVPD5/gKam4DNqlDUdl6ijuf3UK02a+EAGUa2iyz4ItRAO+OjtSKEoOuFQAFEQeOfyOLIsc3V8iLDfx/hgL+lkAlmSSFuDD4N+D/WmQiIaxi3LXL84gkuSuHVpDK/Xw/hgL7FoCK/HTbolzvsPp7k0MsDjuWVGB3pY2dimPZ1kZXOHcDDAzNIqLlnm+z5766X31VnsVZtE3pauXBAEFyawf8kwjH/9Ya71sTSOgJlznw7L7fW9+/v7XLt27UydYS8Ky+3RTFeuXHklsSEIAiPpCP/2pz7PT/6T93i0eQKYnlzRNGqq2ZDfVHU8bhldN6g0NURRQlEVQj43FcVAazZwuyQkQaPaNBBdMpGgn0JTQKsUCIdDKKqC4Qkgo6HKPlwuTNBoCuVGDa9HR3R70IGKCqIbBHcAMJzBCZI/RgMD3ePF627SwIVeLyD7gjRKWUSXByQDnwBy0EeudAICCPUCmmYQ9Lko/v/be/MwO8v6/v/17GedfckyWSb7voIElIiggCxJABEQV9T6a6voF7XW5bLaqrRqrfbbVu3vArX9aW2TsAhBCu4KCCQkkz2TZZLMJDNzZp+zPtt9//545hwnkExmklmScN7XleuC5Mzz3HOe533fn/X9yXqEFIEqbUzLAC9DxrWJGZL+dA5devieQ0r4RCIqOV8QtjRsI0RJaQkZQhilEXLCQwsZWCJNBlAjgRuiaDpONo0eD5PRYvRnbUzDomH/fpbMncHug8eYPrma4ycThEMWQghsxyWTydLU0ko8Emb/4WNctWoJW3cdYNXi+by0cy8z6yZztPkk8WiYrO3gej6V5SXkbKegqyYGym7zDSIzpk7iZHsn82fPoKu7j6tWLy2Utp4PhBBjLo6oBDd4CNgnpfzWeV2MCTLLfd9n9+7dJJPJ82r5lFJy4MAB2tvbhxwDPBj5DSJs6Tz04at539VzsAydsKkTMQ1MLRDVs3QVgYLrS8KGhg+URUOkbQ98F8s08dCxXY+opRNRffoc0BQIRWNkfI1czqZE9/EyKVA1DOkiFB1demjRcnKewNfDRMmiChuZ6cH1BX42haIZWNJBUdVCIwcD6ap4JLAKVCuMFi3F1iNkZIgkEaxoDD1WEQwUiJaRdTy0cAnSipLDxDFLcKWCHqsARUWPV2LEy9FilRglNUFO34oiB9RMsphIEWjRmYH6G64y4CMoKiIbkEzRraDOPN2HUVLFgYFGEQZScbWVQVpr+qQqbMdlSnUlTS2tmIZeMN/zJajqwBimyQMNIgvm1OMOSCt19fRRU1VOY9NxLDPfGy7J5mwuW7oAyzBZNGcmju1w5HjLqM0CG07TyCj1cr+HoId7x8Cfm871YuNuludyOXbs2MGUKVOYNm3aiCcs5pGXPi4pKWHFihXDvk6+syyP+69fwpWza/js/2ylrS8DSkBuXVXJ5Fxilo4rBDFLoz/roqoqmqIgpULMgJQ0sIWCqaoo0gPPxTfCmHjYoSgpT6CEomjSxfccRCG7DMoAafrSDnq0jBLVpd/TEa6LrvaTyuWIliiFGnY5ULaaEToSHy1cgiFdXN1EtVMIM4adTgaE1Q0kIIxo4JOrRiFd5ubS6EaYZE6ghQO1Fd23gyCZk0MNxbCFNtBkoiGy3WjRcjI5By0axVVMRK4fFQgZYJLDCYVAARkrp6Z+ESe3/5rykhh7Dx0FKQujhPIEmFRTwcmOTmZMruHgsZNMrq7g8PETmIYe/AxwcmAAou24RCNhaqsqMAyd2qoKUukMYctk36GjxKLVNOxrZEpNNSfbOyiLx0hmMoQs87y6wAZjOAMJztcsl1L+gT/pXJw3xtUsT6fTbNu2bVj+9VBIp9M0NDQwa9YsJk2aNKKffbVpL6Vk5YwKNn30Gh74r5fZ3dKLIwS25xML6bheQK2ULdA1FUMFV4CuK6RsD8vQUKVPxg+EFzQ9jOP6ZJxsULqZzYEZxVQ8MmYJqpNBNQycdA9mKAyIwAQXPv1CQUFilpQjfB89HsWREqEZWF4GIQRupodYNEIqk8GIlODYGZRoOWFLJy1BtwaaWswomvQRmk5U5shgoQxUmilGEDnWwjEUL4vUQ+TSSfS4RShWEggkWmFUN43rg3ByGGov3kAKLe0phFSJY5Tg+i6OUFFUFS3XB6FS0moUFIXF8+ppaU0wdVI1mUyOaZMDwcA1KxYTsgyuXLmYWCRCaUkcS9coL4kMlJ66xGJROrt7mTV9KoePN5POZNnTeDioHa+fTmPTcRbOnk5rRxdXTF0MNDN9Si0n2zuYN2s6LzXs5e3XvKEwA+18cbF1hME4meVSSjo6Oujq6mL16tXnRWzP89ixYwdLliwZMbHhVHJLKfF9HyklsbDJ//vBN3Hf2tlETZ2woaMoCrYXkDpsKFiGRs4PxhZlbY94OJgDnfUVQppCWBtIq1kqejgWCCxqOjHNJzkQgQ6bOh5GUPmlhXBSPUQ0n7jqghD42SSSoDhGUTW8TDKImqvgGVEikTC2HguaOHQLoZlI1yaV9TD9NDFLxe1NoNr9OH0deMlOFN/GS3YRCRmERIaIDlq2By/ZSVRx8fo7g5x+qotcNgN2H8JzCOkKqhUhVF6DCJWil1STsW1UKxwoowJoBiIbVLzZA3umUDS0eDXdPUmOtrQhfMH2vY34vs8fd+yhtaOD3/zxFV7ZfYDntu1k6679nOzsZu/h4zieZOeBIyT7kzQ2HScaNkmlsyyeWx/M+J5UTWPTccIDgxNUVeHg0SCtlkpnWLFoHtFImCXzZnHHjW/B8zxc18X3/XNu9YSzN41caAMJYBxObiFEYS53ZWXlsP3rVyNf4GLbNmvXrj3nUal5BVUpZSHAN/ihffgtC1m7YAqf+e+XOdGTIWyouL4PKORcQcTSEL7AMAxStoeq6oQ0UJCkfQ1N9UGAKiUhQyUndTJ2Di0UxXAz5ACpgBmJ4UuJakYCv9bJoBghYhFBMh3UMVtxHSMaxQHSroJiSHwjqGnXIqWowoNQFMPP4YZi5NI9ONEIVsgKyKgkwYqR8j20COQ0HT/TixYpRdo59HgltnTQ4/GgIGVAatnt70QvKSXtCqQ2oKme6UGLlqOqOpIgEq/7Dp46IH8sZfBd+ClS6SyxmmnsbXwZoDAb2x2Il0ytqeZYSxtL5s1m2+79zKwLRgtFwqEBk1zS1R+0puaHNIoBq6O2spxkMsWC2TNA0SiJR0h0dDFtUg0N+w4ypaaKHXsPUFlWyluvvgJD1xFCFP54nhcoymjaiJo8zuZzZzIZKioqhn298cCY+ty5XI6GhgYmTZpEVVUVjY2N53Q9IQR79gzI9kQi5zUDWVEUfN8vPOTT+erzJ5fyyP3X8n9++FueP9qLohgogKEFI4hcASAxNBVfgi9FIPLnu4QsnYwHwsshFIVoSJL2VEBBN01coSMyvRiRMG42hR6Jowkb14yAkyVrhAlHVVwMXDuDohmYIomqqwgviSN1hGujRctxUj3o8QoMReIClhXIIvqahSIl0oph4eNo+kCXV0mhCUTqgZ66q5jIXBrFihI3FdIEJjkARggy/RAOcukAwoxhSBc7l0WXLp4bCEMgXFQrgk4OPV6FgmD1skVEQgad3b1UlMbo6Qv0z7r7+imLx9A1lYrSONMm12C7DrOmTaWjq5fK8hi27TGjbhKKhCtXLsF2HKZPqaW1vYP+VIbO7l6ONLeycvE8du4/xJpVSwGYUTeFk4lObn/7tYQG3pPBs76EEPi+X/gDFCaTDEX28fC5RxtjZpb39vaybds25s6dy4wZMzAMY0SNI3nYts3LL79MSUlJoTDlXM0rKSWmaXLixAlOnDhxxkb9fDT/L980lf/77iupLrFQFBAyqLkKmWowxlZREL4gZOrYnqQkEiLnBWWnoVAIdJNkxgZNo8wUpB0f6btYkVJy0ghM2gFFlzB2oVAlN1CoEjGC/vCs45JTI+iGCWYE0zLByyGBsMjQn0yhZPvQdR3FSaFpgRqroigFBZX8RA8jVo4UAw0pA5Vo+fumPQUpgrRfjBxhkaM0rOInO9FV8FI9QfGNk0ULxVFCMfSSKrRYOd5Aw0l/LnjGPioNLb3YOYd9B49SVhrnWEsbVeXl7D98FIlg2+4DdPX20dh0jJNtHfQlUxw4chThw7Zd+0BInt+2E9txeWX3gWBueUc3tdUVHGluJRKy2NMYDD7cc+Aw8WgYRYGrVi3lXetveM1zVVUVXdexLAvTNDEMoxBg9X0f13XxPO+079dwfO4LSagBxujkzuewBw8EPJeWz9MVpuQfxkj7ZqWUCCGoqKhg2bJldHZ2smfPHnzfp6qqiurqamKxWGH88OTJk6mrC6qiHru/mi9sfoXf7W/F9nwkCr6USAmRkIHtBdH0nOsjpCQeDpFxfXBtQqEQQkq6M3nxBZdULh0onYRiqF4O34zhSg8PA106hCNhkuke0pqOHhLo0TKk8EljgnDwtQiadCFege1k0EuqsUSGLCa+nUQzY0RCJrbw8VFQ7AxZBJ7bTTgSwUn1Y8VLUYWL4/nYqoLv59AMK+hIC5fQ19+JFq8iK1TUaAhUlZifJaeGULwBaSfFHCiAKSkMTFBDMTQvi+N5WKU17G7cB0B3T7DJlMaDdOXC2fW8sH03S+bNZnfjYWoqy9l94DCGrrP34BEA2gbKS/Nkqywr5fjJdmZPryNkmsyZUUcmlyMSCrHrwEFKo1Ge39rAvJl1lEasIcUT8u+PpmkYhlEgeD4Ok/9vTdMK1t7ZzPLXhc+tKArLly8/papnpCdua2srTU1NrylMyfvMZ5pKcjoMDpzlTfvp06czffp0XNels7OTpqYmkskkrusyc+ZMpkyZUvh5w9D4h7sv54+H2vm7x3bQ1pdBVxX0AQH+rONjqCqOkMRDOmnbDdJlpoUjFEw8woaOL1wy6JghDc9zUT0b4TmYhoFwHDAiSM8jq0ewDAffjOEku1A0g4qITs5XsO0MRMoHUl4VQVcY4PoSVLCicVwpySlW0LcdKSOMQxYT1e3CVS18VcfGRKKgGCpCUYmIHDlFLbR+KqFAiw3VQKS60GIVpLJZ9GgYRwsHs8lVk4ihIoRNOBJCI4vjg6lLfC0GZpR0yz5m1k3m4NFmLNNgd2NA3M6eIAgXCQem8+wZdSQ6u1mxZD7NJxPMra/D83zWrFhMOp3mssXz8IRgam0Vx1pOcqK9g5BpcODIMZYvmkeis4fpUwIZp/vu2hCMHN63D9d1qaiooKqqakiVlXxLMVAQ4RwchHMcp/AOn+4aryuz/NW+7HDz0FJKGhsbaW1t5Q1veMNrClNGagHkA2d5lYxXr8MwDCZPnsyUKVNQVZU5c+aQzWZ58cUX2bVrF21tbQV3Ys2cWp785PW84/J6IpaOkALPF5RGTHRNw9JVso5AUzVQFExdJW4qOFLHkyqqaqAKB8/OgmZiGRoMkMhXdSLYKEik8PFVE5BYkThaOE6PDTnFwoyWoCDQdAMl20culyUksvhCYkon6OnO9qGoGk4qIJBjD0xAGRgNpEVLka6NohuYXuAC+ANlqXq0DEUKVMMiJAOzPRwKBcowqoZIduInOzG8DH42iatZOFIjq4Tp7U/haCGSnjogIKGgVdQxuaaSkliUy5YuoCQaYdXi+WTtQNPsZFsHFaVx2to7g+yE49LW2YmhGTTsPUg6nWJX4xFUTWPH3kYqyks50d7BrGlTOXDkGJOqK9m57yCTa6qRUnLNmtW8c90NTJ8+nVWrVrF69WpKS0tpbW3lxRdfZOfOnZw8eRLHcc74zqiqiqZpmKZJKBTCcRza2tooKysrmO+vjsCPtvLpaGDc8tzDQX5YQSwWY+XKlec1MTRvhufLBofaXJqbm2lvbz9FwFFKSTKZJJFIcOzYMQzDoLq6murqaj67bgV3XTGTL27ezqH2PhxPkHU8YiEDT/VxPB8hQDM0kjmXqKmiKdBn++iqhmKaCDdLyvcJR6Lgy0BhRdp4epSwzCI1hVR/F5oVJmpBxoqgO2kcI4Kf7UOLlBKSWWS4FCfXB1YpmkgjFYOQoaFKB6EqhPwsKdtBsTvwDAMnl6G8vBxFdfF8l3QmjVCyGCELty9BJBwmk+wPUnmegxLWcLQwhurjmxEsN4ltxMjYWdSQhVAU/HQXeryyUK+u6BaancTTQhglVew+0EB/Kk1XTx8nE51MnzKJltYEa1Ys4Y/bdxVM88nVlezcf5CwZbHrwCFA0jFgzqcG4hAhy6R+2hRmz5xKbXUF0ZCFED4z6ybx/Lad/Nm7bice/dOBoOs6NTU11NQE44RTqRSdnZ00NDQAUFlZSVVVFfF4/LTvSDqdZs+ePSxbtoxYLHbaU93zPLq7u18fZvm5IJPJsGPHDurr65k8efIZPzcc8364xBZC0NjYiOd5rFq16jVdZCUlJZSUlBRO846OjlP89O++5zKe3pPg3397gL60gi8kGdcnbGjoUpKyPWKWjgL02z4RQ0FXdfqzbhBgNMJBXlnVKDEd0p5E4uFpJp5UCMdLcRWDZDaJojiELRXHz+CqQYQ+ZXtooYFpIlKSxQTh4+qxYERRtAKw0UuqCIsMWTWMLnzSMoTwJKppoZVGCUkXRzEI+QLXiKGEPJRw0Dyi+MHwQru/B72kOvDBpUS1woRljiwWsXgURwpMy8AUabKOF4g4oqGW1pI+GWZmXZx9h48Stkx2Nx4GKUl0BeWm1sA4pFkzpqIoMGdmHa1tHdRUz0EIycLZM+no7mHh7Jns2H0AyzJp7+jC8zwi4RD9qRT5wq4P3r3hjO+FoijE43Hi8Tj19fU4jkNXVxfHjh0jlUpRWlpKVVUVFRUVhaKrnTt3snTp0gJxB/vq+Xfo+eef5/DhwxeUfhqMIbnPRKjTSdHklVeWLFlSGI16Jpzt5B4usT3PY9euXZSWljJ//vyzug3hcPi0fnqdTPOtW2bw4x3dPHe4B11TEBIyORddVUBRSOY8ysM6Odej3xbEQgauJxG5HJYVwkOh386immFKVJ+s7eDZOdRISSBKGI5jSZskJsJNoYZKsWQOV9Pwk53kUCiLhsgKBUuVZAjmfKlmmFQqjR6zAtkkKVEj5Ug3KESRmR6USBmacIPIvRFoo+mRskDoUTGJKB4ZLIxoCcJzUQCR7AxU2EIGvp3Bi8bw7AwiFCXTH5S/pgbGHilWlOjUuUyLpcnlbObPms6hYy0smlPP0eYTzJo2mQOHj2HqGvsOHgkaQqTgZKKLaDTCjj0HuGLlEnYfOMxVq5fheh6XLVvEC6/s5PLlizjZlmD5ovnYjsON11zF7IHW0OHANE0mT57M5MmTEULQ19dXeK6qqpLJZFi0aNGQJ/Irr7zCX/3VX/HHP/7xnEf2jhXG9eTOR7rzu97gzrDTKa+cDoPH+L4arw6cnYmw2WyWnTt3MmPGjHOqcsv76fmXoqenh/etUrmq2ufHu5Mc6XGJhDSQCrbnY2rgSknWFZSFgznTji+IhEPkfIlwssTCIXzhk/QVpGIQjlq4UuLmbEKWQMpAnC8UMsgB2UwOLVpKRFfJYZHMJVFCMVzpIKXAjJVgSBtf1Yj4afozWVTho+oGvpOjvLwcYem4bopUJoMkRSQcItXfTWlpCX29vZihKCnho5kKGBZhYZPTg0i9sErISIkiAg124fSihqJosXI06eMrGiHFJ5tNoqoGW/cdIZvqxzJNTrR1MKmqkkRXD3Nm1HHk+EkuX76Ilxv2MHNqLUdPtDO1tpqGvY2UxGLs3HeQ2qqKIMC2cimaprJg9ky6e/tpaUsMDC44zhc+9sERP8s8VFWlvLyc8vJyMpkM27dvZ+rUqbS0tHD48GHKy8upqqqivLy8cELv2LGDj33sYzzyyCPMmDHjnO89VlDO0qc6dBPrEPA87zUk3Lp1K0uXLsWyrELlmpRySIGGV+PQoUPE43Fqa2tPXegZKs5ejb6+Pvbu3cuiRYvOaiWMFHk//RevHOb7zzWRSAaCDRB8kVJKkIKMIwjpQU7Z9QaKQJD4wsNUNTTpYvsKnmujhmKYIoetWGh+Dl/RiKkeAoX+VBrVjGDpKq5iYsngc34qaPTwkoEvHBEZMmoYS+SwlRB4DlJVUVQNXdi4qkVUZkgTDopdrDjS99AUBaFoGE4/rhnHTwdValJKDBkMOAz7abJaFFW46NJFRaATqMIKzQjUXFQdra+ZWUaSYydaKYnFcFwHVVGoKCvBHujh7uzqZnJtDTnHIRYJ09reQWVFGc+93MDqpQv54/ZdXLZsEVt37mXFonns2NvI4nmzOXKsmWuuvIz//M5XzvsZZjIZdu7cyeLFiwsBMt/36enpobOzk56eHrZv304ikeCJJ57g8ccfZ968eed72zGRTR1XJyFvUtu2zdatW4nFYixZsmREvsrpzPLBFWdDXautrY39+/ezYsWKUSc2/MlPv/2alfzv52/nM7cuozJq/qkaasCiMLVAYskVgKajqgoKgohpIKUgK010XUMNhTFEjkzWxsBH1zRQDbKuJINFLBpFNULk0qlAU81zULK9lEVDGF7Q4aZJj7QMRCZsNRQUrugmyoAiSy4dlHnmFVSFGQcng6LphAii5YphIX2XUDiK19+Bmusj19uB29+B7fn42X4EGulUkqwaoc/Xgxw4On4qmJHtxSaRdX06u3uorSqjpbU9KBXdcwAVyR9e3kEyk+U3f9zGvoNH+P1L22lsOsbOfQfxfL+g0JJzHBbOqaeqvIwrViwhErawXZcPv+u2835+eYtu0aJFp0S+8yKJCxYsYM2aNdTX1/OLX/yC0tJS3ve+93HkyJHzvvdYYFx9bk3T6Ovr48iRI8yfP5+qqqoRX3dwy+Zw/WspJU1NTfT19bF69eoR5cjPB3e/cQF3XTWfH/5uP//1/GHa+9KB9iEgUVA1LZBRdgWaZsCAskvMBNv2UFQdTTPQoiEUP0tOaES0LJql05/qww7FkG4GLVZBWHHJSh3f7SNJGN/uRY+VY8kMvhrC8jNkcw5SOngii3RdIm4KKxJGlxmSORvfzmCEo9jZFHFNpT/jYIQUbNVAsVO44RJi0UhQLWfF0RD4ioae6UEqgQgkUqAaIUJeknRWErZM0n3tWJEYh/oVSuNRduxtRFEUjg8olGYHmmqmTqqhNdHJ0gVzSXR2Uze5lnQ2SzwS5mR7B9On1PDCK7tYMn8Ov3juRRbNm8XexiNcddlyrn7D+QkgZrNZGhoaWLhw4ZCz7A4ePMiXv/xlfvzjH7N06VL6+vpGS/l01DFmZnn+NB2MrVu3ks1mWbVq1Tkn/FtaWvB9n+nTpw87Ir537150XWfevHkTFtEUQvD1R57j6d3t9NsCSWCWO67A0FVUJZgMGrU0hO+T8SCiQ9b1MBSBkEow3EgKPKmgCxdfM4MWUhXsbHDalsdCJD0d38mimMGMMdU0A9Kh4CsqIpdCDcXw+jvR45VouT78UCkWDrYMNj7VdxCaheUlsfUYlsgGJr0MYgSqFUG3e3H1aLCxZHJEwxaunQUrgi9BKDpSUQl5KXJaFEV4zHUP4zsOFeUldPX0gRSkcw5hK8Txk234A8/Uth3Ky+J0dPUwbXItx0+2MWfmNA4dbeaKlUtxXZfSeIyO7l6++YX/w2VnGDgwHOQ1BhYuXDikRdfU1MQ999zDj370I1auXHnO9zsNLl6zXErJwYMHSafTzJ0797wqefJmeT7POBSxHcfhlVdeoaSkhAULFkwosffv38/6xVX86ou38/G3L2VqeRhd1whZBpqmknEFUTNI82U8iFsqSFAVBakauGhoeIEyqxFsCF6mH2FG0XUdLV5F2LLo8y3cbArVihAWacI6qNkevFQPEZHBT3ahOhkskaUkFiaEgyMUyCXJ2S5uXwJDOtj9XZh+Bt/zCYsMuiIJu31ElSwy24fhZ3GEBtInq4TwPIe0EiKnhnAx8FWLkAxOZIdgwKHM9rGvW9Kw7yA79zWyY28jqXSOxiPHsSyTnr5+lsybRSqd4bJlC4iGQrxlzWqmTqrhrVevQdc0rlixhBe37wIUfv3CVubWTx8VYi9YsGBIYh8/fpx3vetdPPTQQ6NN7DHDmJ3cQohCIf6uXbuIRCKoqkpJSclrgmEjQXt7O62trcydO/esg9B37drFnDlzzsn8Hy3kRyKVlZUxc+bMUzaip7Y38aPfHeRYZxLX95ECbNfD1IINMeP4mLoaBKWEi67pKAiyvoL0XDRdx1AE2UwKUw82Pd0MoyqQkxrSsdFME+EHkXYhlWAQoBHCTwetnyLVhRqrJCqzpAlhSAcXDSlBFQ5SDxHx02TUCJqbDlpOpUDzHIQeIkqWFCE06YMUaAhMP4eHiqKAK1U8LRQUv+gxkIIFtJDsTlBVUU46m0ORgnQ2h6Hr9KezOK5LNmeTzeUoicfo6e2nurKcRGc3s2fWYRoGleXlOI7Ld7/610ydfG7v02BiDx5+8WqcOHGCO++8k3/7t3/jqquuOqd7nQUX38mdyWR4+eWXqa2tZf78+RiGMeLmkcHwfZ/S0lJisRi7du1i69atHD9+nGw2e8rnurq62LVrF0uWLJlQYtu2zSuvvMKkSZOor69/jYVx08p6/vvj1/ODj7yFNXNqiVgaISswZVV14FRXFTzPDbTIFMj6Cqr0KQkZmIogk86ghkqwTAtplaBKj5zUkZleYiGNiMiguhmUTA9euo8wLooXmNAKAjUUQ5E+KUKIXApXMfGSXYF+uQyCgLZqovk2qqbj9rYRkTbZ/k50u4++vn78/g5818Xu78JRDJKEcFWTrBopzBeztTB+qhuR7mFfD+w9dIyWtg627dqHKyT7DgdVgEdbTlJREohErlqygBlTJ/OWKy+jprKCN12+ksYjxymJxfjtH7dxy1uvPmdi27bNjh07mD9//pDEbmtr46677uI73/nOWBF7zDBmJ3d/fz9bt249pTClubkZKSXTp08f0bXOFDjL5XJ0dHTQ0dGB53lUVVUhhKC7u5vly5efV9/3+SJvOcydO3dIqeXByOQcvvfsHp7ddZzutIPj+cEpqQYFKP05DxWfiKaQ9SWu46CaIWKqIGU7hHVwPB/TMHCliuPYKLqJLj08xcBSPGyMIKUVKcNLdqLHKtCcfoQRI6S45ISKFD7C81F0E0PYeEYkSHmpURQvh1B1UDXCMkuWEFFs0liARBc2EiWoPRegGTqe4+KZcTQ3g6eHQVGo17oJ293EImHS2Sxhy6K9sxvLNNl7sInK8lI6uropjUfpT6apLC+jsqKU8tJSco7D5Jpq/v3Bz414aiwExN6+fTvz588fUhUokUhwxx138PWvf53rrrtuxPcZAcbk5B7TgFo6nT6FYPlh5/X19cO+Tp7YeZmbofzr3bt3k0qlMAyDyspKampqKC0tHffpi729vezbt48lS5acczPBS4faeOhXe9l7ojvQTFeCcUeO5wVzB1wPV6pEVI+M4xE2DHwh8VDRFYHtgeLlME0NxXfxPIEUHrYvKYmGcEXwXUoUHKlgChdXC+EPdICp2V5EqDTIZ6MhkZBLoxsWmb4u4mVlJPt6CIfC2I4LwkOLlODZWfRIGSgKIZkjp4TQ/RyuVFF9Byfdi26FkYqKf2w7JZZKR3fPQL15O6uXLSKTyVFdWUHWzgEKR5tPEg5btLQmmFRTQSwc4V++/EkWzZ87YnI7jsP27duZO3fukMopnZ2d3HHHHfzd3/0dN9544zk9wxHg4iK3lPI1nTf5SYlz5swZ9jWGU3GWHyEUi8WYPXs2Qgi6urro6Oigv7+fsrIyqqurqaioGPOgWiKRoKmpieXLl5+zpNRgeL7P//e7/Ty14yjHO1JIJL6QpHMupgaqAp4fKMT4UkHHI+d4RA0VFHCdQNVUFw6uHiGuuSR9AzI9EC4bKEwpQ/VzSEVHVQDfxVd0/HQfaqQU00vhmCWY0sYWWqDp5ufw9TARmSFDGJ3gOaFAyMsg1IGRw4Cr6ODlcPUgVRZSPVyhUqI6xJPHqC4vYcfeAyyaM4vnX9nJlauW8cIru1h7xSr60xmqykvp6U9hmgbb9zTy8N9/lhm1FXR3d2NZFtXV1VRVVZ31+84Te86cOUNaUz09Pdx+++184Qtf4NZbbz3vZzgMXPzkzhNuwYIFw/r54RA7l8uxc+dO6urqTunBzkMIQW9vL4lEgp6eHmKxGDU1NVRWVo56vru5uZlEIsGyZcswDGNUrw3Qm8ryH7/fx3P7W2npTJJxPRQZbG6KGswvcx2XqKXheD6+5+GqZhAkUwzimkfa9nCyaUricVzHxrQsNOmTdQWWGoxUMhQRCCB6LqFwGCEEhirxBODlUFSDbDZNJBymP50lFjZIuwoaHtIqASS6m8U3Iuh+BtuDqKnS39NNSWkZqWwOMxTBV3SiMsNkv52SaBjX8wmHLJpa2qgoLeGVfQd5w7KF2I5HZXkZ/ekMn3j/nbztjZcVvpNMJkNHRwednZ34vk9lZSXV1dWv6fIaLrH7+vq44447+NSnPsXtt98+6s/wDLi4yA28Rsaot7eXEydOsHjx4iF/bjhpLgj8+j179rBgwYJhKaoObuPs6urCNE1qamqorq4utHqeC6SUHDp0iFwuN6JS2vNB1vH46e/38Zu9Jzia6A2GJSBwPYHv+ZiGRtYT+K4bBOdUn6zr4fuCsGkiAV8GlXG2VAnjkcMI8tlqiIjMkcbC8DK4agh8ByEkqhnCT3YH0kqpboxoKXg2mvTRNBXp2eimheu66JpKRppEFZe0MFAUCdl+NF3HtW10TcczwuhehilKDzHLIBQKYRoGrZ3dlMZjJLp7mVE3GUVR+ct71vGm1WceMuC6Ll1dXXR2dpJMJiktLS0o7OzatYtZs2YNGWBNJpO84x3v4KMf/Sh33XXX6D+0M+PiJ3cymaSpqYlly5ad/mYj6MFOJBIcOXKEZcuWnXOFUDqdLgTkFEWhurqampqaM0rznA558cZQKMScOXPG3b/P4+VDrTzywn62H2yh31FwfIGUAdlVJfhuVSDrBDXdoCBkcBqbmsTxBTFdwRWgSRep6GRS/WiGhfBsfDQiIRPPFyiaji5dslhEFYe0NDHwEVIgUAnLHL5Ukb6LaWh4UkWTPikRWDNhbKSi4LtuUF+vWpj4TI34VIZ1srZNeUmc7mSG8rI4c6dP4cO3X8+UmuEFJoFCl1d7ezsnTpwgFosxderUM5rv6XSad77zndx333285z3vGaWnMmxcfOR2HOcUqaVsNsv+/ftPWwQwklLSY8eO0d3dzdKlS0fN/LVtm0QicUrkvaamhmg0esa15KeeVFdXjzgDMNro7e1l//79LF26lEgkwssHT/KLhqPsP9HNie4kyYyDJ4IBC/l0pOMJFBkE2aKGhpCgqxKkQiaXRdd1XMdBNwwsDTwh0VUFISRCSjTAERJLVUh5AlXVkL6Hr2gYXgbVMFGFQFFAKgrSlwiC0mRVuKjqgC68ogTDExUFXYX66hIWzqhh5YKZrFkyjynV56Zz77ou27dvp76+nmg0ekbzPZfLcdddd3HPPffwwQ+ee2fZeeDiJ7fjODQ0NHD55ZefepNh+tdCCPbt2xcM8xvDirN8v3YikSCbzVJRUfGayHtetrm+vp6ampoxWcdw0dnZyeHDh4cM4uVsl1/ubGJ7UzuHT/SQ6M+QzNqBSosQOJ5EUwS2JzBUUBQV13MxjWCAo6ZqgV6blMHJLwWeD7oWbBKaquD5Pp4EXXgouo4mBYqiBtLPSIQvUVVQpMQwgrFMlfEQk8rj1E+p5A0LZvGW1fMxR2HDdl2XHTt2MHPmzNf0WQ823++//35SqRRr167lG9/4xqjroDU3N/Pe976X9vZ2FEXhz/7sz/j4xz/+6o9d/OT2fZ+XX36ZNWvW/OkGwyR2/pSsqqpi+vTp42b++r5Pd3d3IdJfWlpKPB6npaWFhQsXDlkAMR5obW2lpaWF5cuXn1PcIJm12XGklX3NHTR39JPoTdPR3Ud/JkvOcXF9iappeH6gze76PgpKMO974NkKIVGR+J6HrqtYpo6hqViGiqXrREMGpdEwk8pizKytYNGsyayYMw3LHP2gIwTtxtu3b2fGjBlDbryO4/Dud7+bOXPmYBgGjY2NPP7446O6ltbWVlpbW1m1ahXJZJLVq1fz2GOPsWjRKSWzY/Iyj2l7lKIoQyqg5vPX+X87E/I9trNmzRr3U1LTtIJ2mhCC5uZmDh8+jGEYNDc3Y9v2mETeh4Pm5mY6OjpYuXLlOd8/Hra4evFMrl488zX/lg9A5s3ZvI5ceXkFaHqwMQuBqes0HT6IaZoTGneAPxF7+vTpQ74rruty3333cc011/DJT35yzNacF/UAiMfjLFy4kBMnTrya3GOCcX0j81/gSAJnPT097N+/n8WLFw/ZijceaG9vp729nSuvvBLTNAuR96NHj45a5H04kFJy5MgRUqkUK1asGDP3ZLCO3OzZsws6cgcO7C/4rVVVVRw6cohoNMqsWbMmnNg7duxg+vTpQ/YveJ7Hhz/8YVavXj2mxH41jh49yvbt27niiivG5X4TIpA4XGKfPHmSlpYWVq5cOSoFIeeKfBCvp6eHVatWFU7JwQKKmUyGRCJBQ0PDOUfeh7uWAwcOIIRg2bJl40qmV+vIdXR00NDQUJjk0t3dfYoM0XgiT+y6urohie37Pn/xF3/BwoUL+dznPjdu318qleKOO+7g29/+9rgdUmPqc79aaklKyfPPP8+MGTOorq4+oykppeTw4cOk02mWLFlyTvXDo4XBZBpuEM+2bTo6OkgkEriuW4i8x2Kx83qZLpS0G/ypKrCiooK6ujp6enro6OgoFApVV1dTWVk5JsU8p1tLfub7UMq5vu9z//33U1tby4MPPjhu35/rutxyyy3ccMMNPPDAA6f7yMUXUBtM7nzgLJVK0dbWRldXF+FwmJqaGqqqqgovge/77Nmzh3A4fEG8wLt37yYWi52zyZmPvHd0dJBOp8+55j3fOlpeXs7MmTNHvI7RhO/7NDQ0UFNTUxi5lMdgP72rq+uUmMVoWzH5tQyH2EIIHnjgAWKxGN/85jfHzbqQUvK+972PiooKvv3tb5/pYxcvuU8nXiilJJ1O097eTmdnJ6ZpUlFRQVtbG3V1dUydOvV8bn3eyKftpkyZMmprOV3kvaam5qw1767rFtZyuhLb8YTneTQ0NBSmtJwNeT+9o6NjyPLQc0F+k5k0adKQaxFC8Nd//dcA/PM///O4ug1/+MMfuPrqq1m6dGnhvl/72te46aabBn/s4iS34zjD8q87OjrYu3cvhmFgWVZhSsREtG3mo/NjKfQgpSzUvHd3dxONRgtWzGB3xbZtGhoamDlz5oTn0/O542nTpp2TJHQ+v5xIJEin05SXlw9E30fup+eJXVtbO+TmK4Tgb/7mb0gmk3zve9+74AYHDODiI/ePfvQjZs2axYoVK4b0mzs6Ojh8+DBLly4lGo0WdvtEIgEwZsGp0yEvfTye0flXp5xM0yzURO/fv5958+ZN+GB3x3EKRSGjscnk9d7zfnp+cxuOnz5cYksp+cpXvkJraysPPfTQhMZuzoKLj9yPPvooP/nJTzhw4ADXXnst69ev5/LLLz/FNM/napcuXXraFFK+LDSRSOD7PtXV1dTW1o6J4mRHR0ehXn08NpIzIZPJ0NzcTEtLC9FolMmTJ4/b5nY65DuqZs+ePSaWTH6GV76hZyg/XQhBQ0MD1dXVr/H3X33Nr3/96xw6dIgf/ehHE1KHMAJcfOTOI5vN8vTTT7Np0yYaGhp485vfzM0338yTTz7J3Xff/Zo5XWeC4ziFE91xHKqqqqitrR2y/nu4aGlpoa2tjeXLl49LhHcoDK4T13V9TCLvw0W+zPZs4gajiWw2WwhC5n/n6upqotFooUpx2rRpZ/x5KSXf+c532L59Oz/5yU8m/HkOAxcvuQfDtm0ee+wxPvWpT1FTU8PKlSu5/fbbeeMb3ziih/Dq+u/Kykpqa2tHHKgZXBAy0Wk3GLpO/NU+a77mvaysbEyIntfyPpsc0Vhi8O/c2dlJPB5n1qxZZ/TTpZR897vf5Q9/+AP/8z//M+YFRaOES4PcAF/84hdZvnw5t956K7/+9a/ZvHkzzz33HG94wxvYsGEDb37zm0f0UHzfLxA9lUpRUVFBbW3tWdNN+UaUvKb5RKbdYGR14qeLvOdzy6MRNMoHFc+m5T0eEEKwa9cuysrKiMVip/jpeRUWwzCQUvLQQw/xzDPPsHnz5gnV0BshLh1ynw6e5/H73/+ejRs38tvf/paVK1eyYcMGrr322hFVp736pS8vLy+cboNf+vws8MrKygtiiFs+9rBs2bIR+4fDjbwPF/nRtRdCye9gYg9+Tq/20//jP/4D27Zpbm7mmWeeGbOKxvvuu48nn3ySmpoadu/ePVqXvbTJPRi+7/P888+zadMmfvWrX7Fo0SI2bNjA2972thEF0vIR2fb2dvr6+gp55Wg0yq5du5g+ffo5pXRGE3m3IF+Nd76n7uCXPt/ska95H85Jlkwm2b179ykzqScKQgh2795NSUnJWQt3/vVf/5X//u//pqysjFQqxS9/+ctRb98E+N3vfkcsFuO9731vkdznCyEEL7/8Mhs3buTZZ59lzpw5rFu3jhtvvHFEyqL5062lpYVEIkF5eTl1dXVUVlZOmJ89uLR14cKFY+IW5GveOzo6gD+lFU+3SeZlq5YtWzYmxBgJ8sSOx+NnVcvduHEjDz/8MFu2bCEWi5FKpcZ0Yzp69Ci33HJLkdyjCSEEO3bsYNOmTfz85z9n2rRprFu3jptuumlYfdU9PT0cOHCAxYsXI4QomHSRSOS8zNhzQb5OPBwOM3v27HHx94eqee/r62P//v0sX758QtOAEGx6+bLfsxH7scce47vf/S5PPvnkuMUGiuQeY+RfgE2bNrFlyxaqqqrYsGEDN99882nVLdvb2zl27BjLli07xR/Lm7H5MthQKFQwY8cqhZKvE6+oqJgwf9/zvEIQsr+/H8/zWLhwITU1NRMaWJRSsmfPHiKRCLNmzRrys1u2bOGf/umf2LJly7hG84vkHkfkzdtNmzbxxBNPUFJSwrp167j11luprq7mxRdfxDTNYQWrBte767peKIMdrZTKhVQnDoHc9MGDB5kxYwY9PT2F2MRoRt6HCykle/fuJRQKMXv27CE/+8wzz/Dggw/y1FNPDXuiy2ihSO4JQr5ddPPmzTz22GP09fUxZcoUvvvd7zJlypQRnUqD/VVVVQv+6rlGYvPzqS4E3TUIKvKamppYsWJFYfMa7cj7cJEntmVZZ3VTfv3rX/OlL32JLVu2TMj3WCT3BENKyb333ktFRQX19fU8/vjjCCG49dZb2bBhA3V1dSMiei6XK5TBSikLZbDD9U/zeeMLoU4cAjfl+PHjrFix4ozux/lG3ocLKSX79u3DMIyztvn+/ve/53Of+xxbtmyZkEzHPffcw29+8xs6Ozupra3ly1/+8mgophbJPVLs3r2bJUsCEXspJa2trWzevJlHH32UbDbLzTffzPr160fcq+04ToHonucVTvQzRZjz6aULIW8MQbHMiRMnWLFixYhO4/x0j46OjsIGd6bI+3AhpWT//v3oun5WYr/wwgt86lOf4sknn5zwluBRRpHco4lEIsGjjz7KI488Qnd3NzfddBMbNmwYcaVaXm6ovb0d27YLL3y+9js/FPBCSC9BMGs6X0N/PmZ2foPr6Ogo1PmPtOY9T2xN05g7d+6QP7d161buv/9+fvazn024RvwYoEjusUJXVxePP/44mzdvpq2tjRtuuIHbbruNhQsXjiigNDgCnclkCIfDpNNpVq5cOeHpJQiq4Do7O1m2bNmo5vYH/97DrXnPB0EVRTnrhrpjxw7+/M//nEcfffSsEfSLFEVyjwd6e3t54okneOSRR2hqauJtb3sbGzZsYPny5SMi+okTJzh69CixWIxMJjPmTR5nw9GjR+nt7WXZsmVjGgHPz0dPJBL09fVRUlJSUJvJbyhSShobG5FSMn/+/CG/j927d/OhD32ITZs2MW/evDFb9wSjSO7xRjKZZMuWLWzevJkDBw5w3XXXsX79ei677LIhCXL8+PHCCanreuGFb29vL4wUrqmpGTel0MFdb+Od2urr6ysUC+UbPfr6+gDOSux9+/bxgQ98gJ/+9KfjovM9gSiSeyIxuCd9586dvPnNb2b9+vWsWbPmlBPpbHXi+ZHC7e3t9Pb2Fk62scgp59OC+emjE12ckkql2L9/P5lMhng8PmTkvbGxkfe+9738+Mc/ZunSpROw4nHFxUnuT3/60zzxxBOYpsns2bP5wQ9+MOEjeM4XuVyOZ599lk2bNrFt2zauuuoq1q1bx5YtW7jrrru4/PLLh0Wk/MnW3t5Od3d3YXZ4VVXVefvEedPX9/0xq1sf6XoOHTqE67osXLiwkFo8XeS9qamJd73rXfzwhz887dDI0cLTTz/Nxz/+cXzf50Mf+lBBRHECcHGS+5lnnuHaa69F13U+85nPAPAP//AP53vZCwaO4/Dss8/yiU98gkgkwqpVq7jttttYu3btiKrapJT09/cXTNi87PNQ+u5DXWv//v0oinJW03c8kLcgbNtm0aJFr1lPXmGnoaGBz3/+87iuy9/+7d9y7733jtnafd9n3rx5PPvss9TV1XH55ZfzX//1XxNl/o/JLznmDtj1119feDnXrFlDS0vLWN9yXGGaJocOHeIv//Iv2bZtG+95z3v4+c9/zpve9CY+8pGP8POf/5xcLnfW6yiKQmlpKXPnzuWKK65g9uzZZDIZtm3bxvbt2zl58iSu6571OvlKL13XLwhiQ+Dzn4nYEHyHU6dOZfny5cTjcd7//vezZcsWPv3pT4/Zml566SXmzJnDrFmzME2Tu+++e9SHAE40xlU17uGHH+auu+4az1uOC+6///7CS3vttddy7bXX4vs+zz33HJs3b+ZLX/oSixcvZsOGDbz1rW89a9GHoijEYjFisRizZ88mnU6TSCTYvn17od79dL5qvtMs33RxoRA7m82e1edva2vjrrvu4tvf/jZr164d83WdOHHiFB22uro6XnzxxTG/73hiVMj91re+lba2ttf8/Ve/+lXWr19f+G9d17n33ntH45YXFE730mqaxtq1a1m7di1CCF566SU2bdrEgw8+yJw5c9iwYQM33HDDsPqOo9Eo9fX11NfXk81mSSQS7Ny5E0VRTmls2bVrF6WlpRM+kSSPpqamQnBxKGInEgnuvPNOvvGNb4wLsV8vGBVy/+IXvxjy33/4wx/y5JNP8stf/vKCOE3GG6qqsmbNGtasWVPoSd+4cSPf+ta3mD59eqEnfTj9yOFwmBkzZjBjxoyC7PPu3btJJpOFFNuFgKamJpLJ5FmJ3dnZyZ133slXv/pVrrvuunFb39SpU2lubi78f0tLy6VW0jr2AbWnn36aBx54gN/+9rdUV1ef7+UuKeR70jdu3MhTTz1FdXU169ev55Zbbhl2c0leoL+iogLDMGhvb8d13VPKYMcbR48epb+//6x59Z6eHm6//Xa+8IUvcOutt47jCoOqunnz5vHLX/6SqVOncvnll/OTn/yExYsXj+s6BnBxRsvnzJlTGFAPQVDte9/73vle9pJDPsK9adOmgqrIunXruOWWW6iurj7t6ZcfW/vq3vC87HN7ezu5XK5Q9z0a87nOhmPHjtHb23vKbKzToa+vjzvuuINPfepT3H777WO6pjPhqaee4hOf+AS+73Pffffx+c9/fkLWwcVK7iJGjsE96Y8//jiWZXHrrbeyfv16Jk2ahKIow57b5XkeXV1dtLe3n9eU0eHg+PHj9PT0nJXYyWSSd7zjHXz0ox+9JAOs54AiuYfCxo0b+dKXvsS+fft46aWXuOyyyyZ6SaMCKSXHjx8vtKoCXHfddTzzzDM8/PDDI+qQyss+t7e3k0wmC7LP5eXl503048eP093dfdba9XQ6zTvf+U7uu+8+3vOe95zXPS8hFMk9FPbt24eqqnzkIx/hm9/85iVD7sGQUrJz507WrVvHjBkzCkPd169fT319/YgIejrZ59ra2nOqd893m52tuSabzfLOd76Te++9l/vuu29E97jEMSbkvqCno40ECxcunOgljDkUReGFF17gBz/4AW95y1sKPekPPPAAvb293HTTTaxfv35YPemqqlJZWUllZSVSSnp6ekgkEjQ2NhKPx6mtrT2lk+tMaGlpGRaxc7kc9957L3feeScf+MAHzun3L2JkuGRO7jyuueaaS/bkHgpdXV089thjPPLII7S3t5/Skz7S2Wmv7uSqra09bb17XgN++fLlQ24CjuPw7ne/m+uvv56Pfexjr8t06FlQNMuHUyzzeiX3YPT29vKzn/2MRx55hGPHjhV60kfay52fG57XUAuFQgWiJxIJ2tvbz0ps13V5//vfzxvf+EY++clPFol9ehTJPRwUyX0qBvekNzY2FnrSV69ePWLfOi+WePLkSTzPY/bs2dTW1p6xQcbzPD74wQ+ycuVKPvvZzxaJfWZcnI0jRUws4vE4d999Nxs3buSFF17gjW98I9///ve56qqr+MxnPsPzzz+P7/vDulYsFiMcDhMOh1m9ejW+77Njxw62bdtGc3Mztm0XPuv7Pn/+53/OokWLxo3YGzduZPHixaiqytatW8f8fhc6LpmT+9FHH+VjH/sYHR0dlJWVsWLFCv73f/93opd1wWJwT/orr7zCVVddxW233cZVV111xhbT1tZWTp48yYoVK04xxQfLPvf09PD888/T3NzMjBkz+NrXvjZuJ/ZFnDEpmuVFjA0cx+FXv/oVmzdv5oUXXuCKK65gw4YNXH311QWTu62tjZaWlrPKIScSCT7+8Y+za9cuJk2axIc+9KFxT3tdhK5ZMRU2kbiAVDtGHaZpcuONN3LjjTfieR6/+93v2LhxI5/97GdZtWoVtbW1JJNJvv71rw9JbCEE3/zmN5k2bRqPPvoovb29HD16dPx+kSJOQfHkHgYuMNWOcYPv+zz44IN8//vfp6qqigULFrB+/frT9qQLIfjiF79IKpXie9/73pgJMV6iGZPiyT1RGKzaARRUOy51cucFH/Nzsl966SU2btzIgw8+yNy5c9mwYQPXX3890WiUr3zlK3R3d/PQQw+NqcLq2dqLi/gTiuQeBl4Pqh2ng67rPPzww4X/H9yTvn37djZu3Mg//uM/4jgO8+bNY9OmTaM67KCI80MxFVbEiKGqKqtXr+bv//7v2bZtGw8++CD/+Z//OeHEfvTRR6mrq+OFF17g5ptv5oYbbpjQ9Uw0iif3MPB6UO04V6iqyrp16yZ6GQDcdttt3HbbbRO9jAsGxZN7GLj88ss5ePAgTU1NOI7DT3/60wvmhS6iiDOheHIPA7qu8y//8i/ccMMNBdWOCZLjKaKIYaOYCiuiiIlHsbb89YL77ruPmpoalixZMtFLKeIiRpHcFyDe//738/TTT0/0Moq4yFEk9wWItWvXDlvauIgizoQiuYso4hJFkdxFXFD49Kc/zYIFC1i2bBm33XYbvb29E72kixZFchdxQeFtb3sbu3fvZufOncybN48HH3xwopd00aJI7iIuKFzqI5/HE0VyX4C45557uPLKKzlw4AB1dXU89NBDE72kCcHDDz/M29/+9olexkWLYhFLEeOO4Y583rp1K4888sjrQVhxQmSWirjEoSjKNOA/gFqCzfzfpZTfmeA1vR/4CHCdlDIzkWu5mFEk9+sciqJMBiZLKV9RFCUObAM2SCn3TtB6bgS+BbxZStkxEWu4VFAkdxGnQFGUx4F/kVI+O0H3PwRYQNfAX/1RSvn/TMRaLnYUyV1EAYqizAR+ByyRUvZP8HKKOE8Uo+VFAKAoSgzYDHyiSOxLA0VyF4GiKAYBsX8spXxkotdTxOigaJa/zqEEeaYfAd1Syk9M8HKKGEUUyf06h6IobwJ+D+wCxMBff05K+dTEraqI0UCR3EUUcYmi6HMXUcQliiK5iyjiEkWR3EUUcYmiSO4iirhEUSR3EUVcoiiSu4giLlEUyV1EEZcoiuQuoohLFP8/kXYx+2ToM1EAAAAASUVORK5CYII=\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapteroptimization_56_1.png" - }, - "needs_background": "light" - }, - "output_type": "display_data" - } - ], - "source": [ - "%matplotlib inline\n", - "\n", - "import numpy as np\n", - "import numpy.linalg as la\n", - "\n", - "import scipy.optimize as sopt\n", - "\n", - "import matplotlib.pyplot as pt\n", - "from mpl_toolkits.mplot3d import axes3d\n", - "\n", - "def f(x):\n", - " return 0.5*x[0]**2 + 2.5*x[1]**2\n", - "\n", - "def df(x):\n", - " return np.array([x[0], 5*x[1]])\n", - "\n", - "fig = pt.figure()\n", - "ax = fig.gca(projection=\"3d\")\n", - "\n", - "xmesh, ymesh = np.mgrid[-2:2:50j,-2:2:50j]\n", - "fmesh = f(np.array([xmesh, ymesh]))\n", - "ax.plot_surface(xmesh, ymesh, fmesh)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "And then as countor plot" - ] - }, - { - "cell_type": "code", - "execution_count": 2, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "data": { - "image/png": "iVBORw0KGgoAAAANSUhEUgAAAXwAAAD8CAYAAAB0IB+mAAAAOXRFWHRTb2Z0d2FyZQBNYXRwbG90bGliIHZlcnNpb24zLjMuMywgaHR0cHM6Ly9tYXRwbG90bGliLm9yZy/Il7ecAAAACXBIWXMAAAsTAAALEwEAmpwYAABr4klEQVR4nO29d5gcx3nn/6mZ6cl5ZzZn7AKLTCSCgMQgkhIpSqKoLNGyLds6Wr6Tw/l0ln3+3dnns+7kcA5nOUiW5KicKYliziRIAETOWGzOu5PzdE/X748ZLAASJEgizM5sf56nnppQ0/P27vS33nq76i0hpcTAwMDAoP4xVdsAAwMDA4NrgyH4BgYGBssEQ/ANDAwMlgmG4BsYGBgsEwzBNzAwMFgmGIJvYGBgsEy4bMEXQnQIIZ4QQhwTQhwVQvzmRdoIIcT/E0IMCiEOCSE2X+73GhgYGBi8MSxX4Bga8F+klPuEEB7gJSHEI1LKY+e1eSfQXynbgb+v1AYGBgYG14jL9vCllNNSyn2VxyngOND2smbvBf5VlnkB8AshWi73uw0MDAwMXj9XwsNfRAjRDWwCXnzZW23A+HnPJyqvTV/kGPcB9wG4XK4tAwMDV9JEg8tCokuVklSRUkWXKjqVWqroUgP0xdaKyYtLaa+euQZvmLQ6hqanz3vFhEkomISlXKNUnp8rIKplrsFFeOmllxaklOGLvXfFBF8I4Qa+B/yWlDL5Zo8jpfwS8CWArVu3yr17914hCw0uhZQ6+dICGXWiXLRJMuokGW2CrDpFvjQPmCvFDgjs5jBOSzMOS9N5pRGHuRGn0orD0ljdkzJ4Q2S1GbLqNPnSHDltlpxWrrPaLDltmnxp4WWfkDjMYZxKKy5LG06lDZfShsvSjktpx24OIYTRIVxLhBCjr/beFRF8IYRCWey/JqX8/kWaTAId5z1vr7xmcI2RUlIoRUiro6TUUdLqGBl1vFJPUJL581qbcFqacFraaHLuxGlpwam0lmtLKw5LuOLhGdQLTkszTkvzq75fkkXy2hxZbZqsOk1GmyKrTZFVp5jP7yWX/ilwLj+XWdhxKx24lA7cSmeldONWurCZA0ZncI25bMEX5f/YV4DjUsq/eJVm9wOfFkJ8k/LN2oSU8hXhHIMrhy5VMuoEKXWEVHGIVHGElDpMSh29YMhuQsGltONSOmh0bMeldOJWyt6Z09JiCLrBBZiFtfJ7aQfHK98vyWKlI5ggo46TUSdIq+Mki0NMZ55Goi22VUwe3Eo3HmsPnsW6B7fSjhDma3hWy4cr4eG/Bfh54LAQ4kDltf8GdAJIKf8BeAC4CxgEssAvXYHvNaDssedKsyQKp0kWT5EsniFZHCRVHEFHXWxnNzfisXbT6X4XbqUTj7XsZTktzcbFZXDFMAsrHmsXHmvXK97TpUZWmyZdHK2MMEdIF0eZyz7PWOn+xXYmYcWj9OC19uGz9pVr20rs5rAxIrhMxFJOj2zE8C9Elyqp4jDxwgnixZMkCqdIFk9T1BOLbRyWZnzWfrzWFXisvXiUXjzWLhSTu4qWX110qVPQC+RKefKVUtALFEoFCnqBvF6gqBdRdZWiXqSoq6i6iiZVNF1DlRqa1CjpGiWpU5IldEqUpI6UEp2z9cWvFRMCIUyVWmAWJszCggkTZpMZszCjCAsWYcFismARClaTgmJSsJqsKCYFm8mKzWTDZraVa5MNh9mB3WzDbrZjM9kwifpdJ1kspUirI6SKw4tOS7J4hlxpdrGN1eTHZ1uJz7oSv20VPusAHms3JnFF557UPEKIl6SUWy/2nvGXWqKUZJFk4TSxwnHihePEi8dJFs+gyyJQjo16rf20um/HZ12Jz9qPz9qHYvZU2fI3j6qrpLQ0aS1NSk2R0lKktQwZLbNYZ0oZslqWbClLtpQjq2XJ6/lLH/w8ygKsoFTEtyzCFizCjEmYsYiySJuECbPJhEBZFFvxshkpEomUslyjo0uJqmsUZBFNltBlCU2WKp1LuVZ1FVVqlGTpddssENjNdpxmBw6zE6fFgdPsxG1x4TK7cFlcuC0u3BYPHsWN2+LGY3HjsXiwmJb+ZW41ewia1xO0r7/g9WIpSbJ4mkTxFIlCuR5KfgddFgAwCRs+ax9+2wB+2xoCtjV4rSuMUOSrYHj4SwBdaqSKQ8QKR8slf4xE8fRivFMxeQnYVuOzDeC3rsJvG8CtdNZEKEaXOkk1SawYJ67GiasJEmpisU6qKVJqkqSWIlfKvepx7CY7LosTl8WF0+zEaXHiNJdFr+wJ28/VJvs5T9lsw2ayYjXZFr1q8xL5u5VkqTLqUCnqBfKVEUlRL1IoFcjpefKlHLlSnlwpR66UI6vlyJ3t7ErZcieoZcjrhVf9HqfZgcfixat48CpefIoXv+I/V1t9BJQAXsVTE6MIXWqk1VHihZMkCicqI97jqJV7UyYUvLZ+grZ1BGxrCdjX4lG6a+J6uRK8lodvCP4S4ImJnydWOAKAYnJXPJW1BGyr8dvW4LS0LsnYpZSSjJZhvrjAQmGBSCFCpBglWowRLUaJFeMk1AT6eXPzz+K2uPFVxMdjqdSKB6/Fs+ileixlT9VpdtaEl1pNNF0jUyqPhFJqqjxK0tIk1SQpLUVSTZJUUyS0JIligkwp84pjmIUZn+IjoPgJWgMErUEabA00WBsI2RoI20I4zc4l/FscJ144Xh4V548RKxxDk+XzDDuu58bWL1bZymuDEdJZ4vT57kUiCdjW4lY6EEvIy9J0jYXCArOFeeYKc8zl55kvzDNfKIv8y8MpNpONoDVI0Bqg1ddKQPETsPoJWAP4FN+iZ2kI+JXFYrLgM/nwKb6Lzp55OaquklSTxNUEcTVOrBgnVoyVazXGeG6Cg4nDFPXiBZ9zmB2EbSFC1gYa7Y002sI02hoJ28OErA1V+78KIRanfba77wDK60pS6gixwlEs4nX8UZYBhodvgJSSaDHGTH6Gqfw0s/lZZvKzzObnWCgsXOChW01WGm1hQrZQ+cI/W1sbaLA14DK7lqQHaPDGkVKS1tIsFCNEChEWCgvljr4YYa4wz3x+HlWemwlmwkTYFqLZ3kSTvYlmexMtjhaa7c0EFL/xu7hGGB6+AVCOGc/l55nMTTGdn2YyN8VUboqZ/CyF82LAdpONJnsT3a4utjdso9nWtOjN+RSfceEuE4QQeBQPHsVDj6v7Fe/rUieuJpjLzzFXmGcuP8dMfobZwhzHUycvGB3YTTZaHC202Ftoc7TS6mih1dFKoy1cE/cN6gVD8OuQssceZTw7wURukoncJJO5SaZy02jy3MKXBmuQVkcrqzwrKxdjM832JvyGN2bwOjAJUyXWH2CAVRe8J6UkpsaYzs0wk59hOj/DVG6aE6kTPB/ZtdhOEQqtjhbaHG20O9tod7TR4WwnoBircK8GhuDXOLrUmc3PMZIZYSQ7ylh2jNHM+AU35YLWIO2ONtZ51y5eXC2OZhxmI65pcHUQQlTu5QRZ61tzwXu5Uo6p3DSTuUkmc1NM5qY4ljx+QUfgsbjpdHbS5eyky9VJj6ubRluj0QlcJobg1xBSSuYLCwxlhhjOjDCSGWUkM7p441QRFtqd7WwNbqHL2UGHs4M2Rxsui7PKll99dCnJaUVSWoG0WiCrFclo5TpbKpLTVPKlcsmVVAoljYKuUSxpFPQSqq6h6iVUXack9cqc+fK8er2y+Ep/lftdJiEwYSrXQmARJiwmc6U2oZjMWE0WrCYzNrMFq8mC3axgN5+tFZwW67lituKyWHErNtyKHadZqSuhc5gdrHD3ssLde8HraS3NRHaS8dwEY5kxRrNjPDT7yOJ6BafZQZezix5XNz3ubnpdPTRYG+rqb3O1MQR/CZPW0gylhzmTHuJMReTTWnmusSIUOp0dvCW0g25XN92uLlrtLTU/+0VKSbakEi1kFku8mCNWzBIvZokVsiTUPMlijqSaJ6HmSKl50mrhVdbBvhIB2M1KWYTNZmymsggrJjMWkwmzKIt0uS6vnDUJgXjFsqtymjBJuVMoVToITerkVBVN6pR0naKuUdRL5bpUoqCr5EvaRSy7OCYEbsWGR7HjVez4rI7FOmB14q/UPquTBpuLBpuLgM2J02J93d+xFHBb3Ax4VzHgPRce0nSNydwkw5lRRrJlB+fh2UfRZsp/P4/FQ6+rZ7ED6XX14FwGDs6bpbbVoY7Qpc5UbprT6UEG04OcSQ8xnZ8Byqss2xxtbA5sotfVQ6+rmzZHW02Ju5SSeDHHXD7FbC5ZrvMpFvJp5vNpFvJpFgppIoX0q4qhIkz4rE58Vgc+xU6Tw0u/txGvYi97w5ayKLoUG66Kt+yy2HCarTgsCo6KN201mavuFUopKeolcmdHHVqxPCopVWq1QLoyWimPWvIk1cJiR3cmP0+imCNezKHJV65zAHCYFRpsLkJ2N2G7h5DNRdjuodHuocnhodHhpdHuwafYq/73eDUsJgtdri66XOdy82i6xnh2gqHM8GI5NHkYiUQgaHG00Ofqpc/TR7+7jxZ785I9v2uNMS1zCfCPQ19lX2w/2VIWKMcv+9x9rHD30udeQbera8nH20tSZy6XYiIbZzITYyIbZyqbYDqXYDqbYCaXpKC/Usj9Vgchm7siSm5CNjfBipcatLkIWJ0EbU78Vicui9W4cF9GeepkgXgxVxkRZYkVM0Qqo6OFfIaFwtlONUVCfWUaCrvZQovDR7PDR4vTS6vDR5srQIczQLvLT9juwbTE/+5ZLctwZoTB9BnOpIcYTJ9ZvI/lMru4oWE7v9D9c1W28tpgTMtc4ngVD9uCW1np7qPP00fTEr05pek6U9k4w+kIY5ko45koo+kYY5kok5kY6nmepgDCdg8tDh+r/S3c2rKKJoeXJoeHJnvZswzb3VjNxk/wcihPnbTjUex0uAKXbF8oacznU8zmUszmk8zlUszkkszkkkznEjwzO8h8Pn3BZ6wmM+3OAJ3uIJ2uAJ2uIJ3uID3uBlqcPsxLYFql0+JkrW/N4g1iXerM5GfLI+bUIB6lfpMHvhEMD9/gFaTVAkOpBYZS85xJLTCcXmAkHWEsHb1A1J0WK12uIJ2uIB2usjfY7gzQ7grQ4vRhNS2P3CX1RrGkMZlNMJktj9TGMzEmMuWOfSwdJVs6t9jKajLT6QrS7W6g1xOi1xNihSdMjyeEq8buIdQLhodvcFGyWpHB5Dynk3MMpuY4nZxnMDnHbD612EYRJjrdDfS4Q7yteRU9nga6XA10exoIWpdmXhWDy8NqttDjaaDH0/CK96SULBQyjKYjjKQjDKcjjKYjDKUWeHLm1AX3E1ocXvq8jfR7wuXa28gKTxiHxchkWS0MwV8GSCmZziU5Fp/mZGKGk8k5TiZmGc9EF2e22EwWej0hrg/30O8JV7y1MB2uABZT9YfsBksDIQThyv2WraELNzlR9RLjmRhnUvMMpRYYTM4zmJrjxflhinp5aqUJQZc7yCpfEyu9TQz4mljjb6HR7jGch2uAIfh1yFw+xeHoJIfjUxyNTXE0Pk2sWL4hLIBOV5ABXxN3d25gZcXz6nAFlkQs1qB2UUzmxbDO+Wi6zngmyunkHKeSc5xIzHI0Ps2Dk8cW24RsLtb4W1nrb2F9oI31gVZCdiPufqUxBL/GyWpFjsSnOBid4FB0ksOxycWQjFkI+jyNvK15JWsDrazxt7DS21hz87MNahuLyUSPJ0SPJ8Q72s6tus2oBU4mZzkWn+ZopTw7O7i4s1iLw8eGQBsbgm1sDLSzNtCC3WyEgy6HKyL4QoivAu8G5qSU6y7y/i3Aj4Dhykvfl1L+0ZX47uXGVDbBvsgY+6PjHIhOcDIxQ6ly473TFWBbqJv1gVbWB9pY7W9eVhdIsVQiWSiQLORJF4tkisVyrZbrvKaRVVWymkpeVSmUShQ0bbFW9RJqSUfVS2i6jqbrlKRE1/XKwqqLT3AwV1bYmkwmzEJgMZVX2FrN5sXaZq4s8rJYsJnNOBQFh0XBqSg4FAWXouC2WnEpVtw2G26rFa/Vhsdmw2quz5vfLsXG5oZONjd0Lr6W1Yocj89wODbJoUp5aKo8ElCEiQF/M9cF29kU7GRzQwdNDm+1zK9JrsgsHSHETUAa+NfXEPzPSCnf/UaOu9xn6ehSMpicY09klJcWyiI/k0sC4DQrbAi2szHQxsZgB9cF2wnY6meFoabrRLJZFrIZIrkckWyWSK5c4vk8sXyOeC5PPJ8jUSiQKOTJa69v9arVbMZhUbBXxNdmKYvxWYFWzGaUyopbs0mUtzqsiPrFltqe7Qx0qVPSyytui6VKegZdp1gqlVfYahr5kkZe08ir2mJc+1I4LBa8Njs+u52A3Y7f7lisG5xOGhwOGhxOGpxOQk4nQYezru67LOTTHIxOcCA6wcHYBIdjk4uL81qdPjYHO9kS6mRrQxcrPKFlfy/gqs/SkVI+LYTovhLHWs5IKTmTWmDX/BAvzg+zd2F0caFMk91T8YY62NTQySpvU81e1HlNZTKZZDKVYjqdYiadYjqVYiadZi6bYT6TJprLXTRVgmIyXSB43YEA/ooYem02PFYb3oqH7LbacFmtFc+57FE7FGXJ/N00XSerquRUlYxaJKOqpAsFMmqRVKFIqlhYHLEkCgUSlY5uKBYtd3j5PJr+ylW2JiEIOhyEnS4aXW5a3G6a3R5aPB6a3W7aPF7aPF5sltqI6Ibsbm5rHeC21gGgfHP4RGKGfZFx9kfGeWF+mJ9MHAYgYHWyNdTF9nA3O8O9dLuNXDvnc8Xm4VcE/yev4eF/D5gApih7+0cvdczl4uH/dOIIT8+cZtf80OKilw5XgG0NXWwLdbEt1E2rs3by0Jd0nalUirFknPFEgrFEgvFknIlkkolkkkgu+4rPhJxOmt0eml1uwi4XYaeLsMtFyOlc9F4bHA48VlvN/B2uNlJKkoXC4sgnks2xkM0wn82wkM0yl0kzm04znU5f9G8edrpo83hp93np9Prp8Pno9Pro9PlpdrsxL5GO8VJIKRnLxNi7MMqehVH2REaYyiaA8tTQHeFebmlZydtbV1fZ0mvDUpiHvw/oklKmhRB3AT8E+i/WUAhxH3AfQGdn58Wa1B3fGX6JU8k5djT2siPcw45wL20uf7XNek2klCzksgxFowzFYwzFoozEY4zE44wl4qjneZ6KyUSb10e7x8vbe1fQ5i17mK0eL60eD40ud93Gqa8mQgh89vLopjcQfM22BU1jNpNmOpViMpUsl2S5Pjw7y4ODpy8YLVjNZrp8frr9frr9AXr9AXqDQXr9QYIOx5LqdIUoT/Xscgf5QPcmAMbSUXbND7FrbpjHpk+QUHPLRvBfi2vi4V+k7QiwVUq58FrtlouHHytk8VkdSzJfiZSS6XSK05EIp6PlMhiNcCYWJVk4b5csi6UiEAG6/H56fH46K6WWvMXliqbrTFdGZWOJBCPxGKPxeLkTT8Qpls7db/Db7awIBOkLNtB/tjQ00ORyL6mO4CwlqZMs5uvqHtdrUXUPXwjRDMxKKaUQ4nrABESuxXfXAkvlh5hTVY4vzHN8YZ4TlXIqEiFVPCfsDQ4n/cEG3rNygBWBICsCQXqDQVrcSz/BlsGrYzGZ6PD56PD5eEvHhe/pUjKVSnImGuVMrFKiUR4+c5pvHT282M5rszHQEGZVKMRAKMyaUJiBULjq9wrMwrRkrrFqc6WmZX4DuAUICSEmgD8AFAAp5T8AHwR+TQihATngo3IpJ/FZBhQ0jRML8xycneHw3CyH52Y5E40sTj10W60MhMLcvWqAlQ0hVla8uKDDuHCWGyYhaPf6aPf6uLm754L3FrJZTkcWOB2NcDKywMmFeb5//CgZtZxvx2Iy0R9sYF1jE+sbm9jQ1MxAKGyE8KqEkTxtGSClZDQRZ//0NAdmpzk4O8Px+bnFOHuDw7l4Qa5rbGRtuIlWj7HU3eDNoUvJZDLJ0fk5jszNcmRulsNzM8Ty5RlnVrOZteFGNjY1s7G5hc3NrbR7vcbv7QrxWiEdQ/DrkIKmcXB2hr1Tk+yfmeLAzDSRXA4Al6KwoamZDU3NbGxqYUNTEy1uQ9wNri5SSiZTSQ7NznBwdoaDMzMcnpshV1k7EXI62dzcyqaWFra2trEu3FT1UFCtUvUYvsHVJVkosHdqkj1TE+ydmuTw7Oziop7eQIBbunvZ3NLKpuYW+oMNxg1Ug2uOOC8sdFd/eQtDTdc5FVlg3/QU+2em2Tc9xcNDgwDYzBY2NjWztbWNba1tbGltw201UoJcLoaHX4PkNZU9U5M8Nz7G8+NjHJufQ5cSxWRifWNT5SJpZ3NLKwHH0t4p61pQ0nUyhSLZvEq2WCRTUMkWiuRVjVxRpaBq5aKVULXyqtiiVkIrlfek1XVJSS+vpL0YprMrck0C89mVupZySgXFYsZmMWO3KtgUC/ZKcdqsuGxKpS4Xk8kYZS1ks7w0PcneqXI5Oj+HpuuYhWB9YzM7OzrZ2dHJlpZWYwTwKhghnRpHSsmpaIRnRkd4ZmyE3ZOTFEoaisnEdc0t7GjvZHtbO5taWrDXea5xVSsRSWeJprNEUuU6ls4Rz+aJZ87VqVyBVL5AKlcgnS++4e8RAhSzGbPpbHqFspi/PPIlZblD0WW5UyjpOmqpxBu9rIQAt82Gx3Gu+J12fC47fqeDgMtBwO0g6HbS4HYS9DgJuhwolvq++ZlVVfZNT/Hi5DgvTIxzYGaakpQ4LBa2t3dwY2c3N3Z2sSIQNMKSFQzBr0HSxSLPjY/y5MgwT40MM5Mpr8DtCwR5a1f5R769rQOnUj8Cn8oVmI6nmKmU2Xia2USK+USG+VSG+USaePaVe7ICWMwm/E47fpcDn9OO12HH47DhrYiny37Ok3ZWPGuHYsFutWBXFOyKBatiRjGbsVrMlx320kpl4VdLJQpqOXdOQdXIF8ujimxRJZMvlkceBZV0/lwHlcoVSeTyJLN5YpkciczFUygABFwOwl4XYZ+bsMdFk99Ns99Ds99Dk89NS8CD2267rHNZSqQKBXZPTvDM2AhPj40yEo8B0ObxcnN3D2/r6mFHR2ddXRdvFEPwa4SReIzHhod4fHiIvVMTqLqO22rlrR1d3Nzdw42dXbR6ajc7oKqVmIwlGV+IM7YQZyKaYCqaZCqaZDKWJJUrXNDeJAQhr4tGr4uw103Y6yLkdRHyOMuerqdcgi4nTptStx6elJJMoUg0nSOayhJJV0rybEdYrucSaRZSmVeMLnxOO61BL20BL61BL+1BHx0hP50hPy0BD0oNT5EcTyR4ZmyEp0aHeW58jKyqYjWZ2d7ezq09vdzWs4J2r6/aZl5TDMFf4vzlC8/xwOlTnIlFAVgZbOCWnl7e1tXD5pbWmrsgI6ksgzMLDM1GGZmPMTofY2Q+xnQshX7e781htdAW9NFaEaLWgJeWinfa7PcQ8rqwmI0bzG8EtVRiPpFhNpFiJp5mKpZkOpZkMppkKlbuXPPquayiZpOgJeClOxwol8YAvY1B+ppDBNy1df+noGnsnZ7kyZFhnhgZYihW9v5XNoR476oBfm3r9ipbeG0wBH+J8+kHfkyikOe2nhXc1rOCDl9teCQFVWNwJsLJqXlOTc8zOB3h9MwC0XRusY3TptAdDtAVDtAV8tMR8tPRUPYwG9zGnrjXGiklC6kM4wsJxhbijEcSjC3EGJ2PMzIfI1c8t0F5g8dJf3OIvpYGVrWEWdUaZkVzEGuN3Cwdjsd4bOgMjw8P0e7z8qe331ltk64JhuAvcaSUS174MvkixyfnODYxx7GJWU5OzTM8F6Wkl38/DqtCX3PDokD0NTfQ29RAo9e15M/NoIyUktl4mqG5KKdnFjg9vcDgTIQzM5HFUYHFZKK3KchAW5jVbY2s7WhiVWsjTtvSjpnXwjV2pTAE3+ANoWolTk7Nc2hshiNjMxwZn2VkProYG270uVndFmZVayOrWkMMtDXSHvQZ0wrrlJKuMx5JcGJyjpNT85ycWuD4xCwLqXLKZZMQ9DQGWNvRzIauZtZ3NtPfEqq5UGS9YAi+wWsyl0hzcHSaAyNTHBiZ5vjEHGolO2LI42RdZzNr2ptY29HEmvZGQh5XlS02WArMJdIcm5jl2MQcR8dnOTI+sxjOs1nMrGlv4rruFjZ2t7Kxu8X43VwjDME3uIC5RJrdg+PsHhxnz5kJJiLlzSKsFjNr25vY2N3C+s6yp9bsN9IuGLw+pJRMxZIcHp3h0NgMh0anOXae89AV8rOtr4PtfR1s7Ws3OoCrhCH4y5x0vsDuwQmePznK7sFxhufKs4E8DhvbVrSzpbed67pbWN3WWPcLeQyuLUVN49jEHAeGp9g7NMFLQ5OLC+H6mhvY3t/BzpVdbF3RjtNmpE64EhiCv8wo6TpHx2d57sQIu06NcWhsmpIucVgVtvS2sb2vg+v7O1jVGjby6hhcU7SSzvHJufII8/Q4+4YnyasaFrOJjV0t7FzVxVtWdbO6rdG4J/QmMQR/GRBL53j25AjPHh/h+ZMjxLN5hIC17U3sWNXFjpVdXNfVYnjwBkuKgqqxf3iKXadG2XVqjOOTc0B5SuhbVnXx1oEedq7qwue0V9nS2sEQ/DplfCHOo4cHeeLIGQ6OTqNLSdDtYOfZC2VlV80tnqkmWkmnWNTKCdSKGkW1REnXKZV0SqVynpyXIwCTyYTZLDCbTZhNJqyKGau1nKrBqlgwG4vHXjeRVJbnT47wzPERnj81SiKbx2wSbOpp45a1vdy+vo+2YG2sU6kWhuDXEWMLcR48cJKHDpzi1HR5S+DVbY3cvKaHm9f0sqa9adkOhXVdkkjliCUyxJM5EqkciVSeRDJHKpMnnSmQzuRJZ4ukM3lyebVcCiq5fBFNu3i+msvFYjHhsFtx2BWcdgWH3YrLacPtsuFx2XA7bXjcdnweR7l4y3XQ78Trdizb/2dJ1zk8NsPTx4Z58tgQpyu/9zXtjdyxcSV3XLfSEP+LYAh+jTMVTfLggZM8ePAUxyfKQ96NXS28Y+NKblu/Yln86AtFjdmFJLPzSeYiKeYjaeYiKRaiaRaiaSLxDPFEdnEh2Mux2yy4XfayuLpsuJw2HHYFh8OK065gt5XLOe/cgmIxYbaYMZsEFrMJ00WyZeq6rKRP1svZMrUSRbV0wSghl1fJVzqVXF4lmy+SqXQ6qUyBdKZAoahd1G6z2UTA5yTodxEKuGhs8BBqcNMY9BBu8NDS6KUx5MGq1Mbq18thbCHOY4cHefjgKY6MzwKwvrOZO65byZ3XraLJ566yhUsDQ/BrkFg6x8OHTvHAvhPsG54Czv2437Ghn5ZA7SZRuxhSSuLJLOPTcSZn4kxOx5icTTA1G2dmLkkknnnFZ/xeB+EGD6GAi6D//OLE73Xi8zjwex14PfYlL4iFokYylSOeypFI5ognc0TjGWKJLJF4hkgszUI0w0I0TSKVu+CzQkBDwE1z2Etrk4+2Zj9tTX7aWwK0t/jxe+tvH+KJSIKHDp7ioQOnOD45hxCwtbedd20e4PYN/cs65n/VBV8I8VXg3cCclHLdRd4XwF8DdwFZ4BNSyn2XOu5yE/yCqvHksSF+vPcYz50YRdN1VjQFedfm1bxz0yraG2rfk9d1yfRcgqGxBUYmIoxORhibjDE2FSWdOZct02QSNIU8tDb5aQ57aWn00RT20hz2lr3coBubdWmL+NWiUFBZiGWYnU8yM59kZqFcT1c6yLlI6oKMmV63nc62IJ2tATrbgnS3h+jtbKCl0VcXayxG5mP8bN8JfrrvBKMLcRSzmRtXd3P31jXctLpn2U1UuBaCfxOQBv71VQT/LuDXKQv+duCvpZSXTF23XAR/aDbKd184zP17j5HI5mn0uXnXplW8a8tqVraEavai1LQSwxMRTp6Z5eTQLKeH5zgzOk8ufy5BVyjopqstSEdrgM7Wct3W7Kcl7ENRlteFeqUoqhrTswkmZ+OMT8UYm4oxNhllbDJ6wUjJ5bSyoitMf3cjq3qbGOhrorOtoWYzlEopOTYxy0/3neSB/SeIpLIE3Q7eu20tH7xhPZ0hf7VNvCZck5COEKIb+MmrCP4XgSellN+oPD8J3CKlnH6tYy4HwZdScvef/AsTkQS3rl/BB7avZ3t/R83Nj5dSMjWb4OjpaY6dmuLY6RkGR+YoquVVlk6Hlf7uRvp7wqzoCtPbGaa7PYjLWT+bc9QC6UyBkYkIZ0bnGRydZ3BknsGRucVO2Ga1sLKnkdX9Laxd2cKa/haaw96aczq0ks7zJ0f43otHeOrYEANtjXzzt+6ttlnXhKUg+D8BPi+lfLby/DHgs1LKV6i5EOI+4D6Azs7OLaOjo1fEvqXMkbEZmgOemlpqXlQ1TpyZ5fCJSQ4dn+ToqSniyXJs2W6zMLCimVUrmhbr9ubAsp1tstQplXTGp2OLI7HjgzOcHJqlWLmRHPQ7WbuylQ2r29gw0M7KnsaaGn2d3RhmTXtTtU25JryW4C+5IKiU8kvAl6Ds4VfZnGvCus7maptwSfIFlSMnp9h/dJz9R8c5MTiz6L13tAbYuaWXNStbWbuyhZ6OUM2GBZYjZrOJ7vYGutsbuOPmNUA5HHdmbIFjp6Y5enqKIyemeGb3IABWq4U1/c1sWtvBprUdrF3ZuqTvpzT63DQaM3gAI6Rj8CrouuTU8Cwv7Btm98ERjp2eRtN0zCbByt4mNq5pZ8NAG+sHWgn4amdkYvDmicQy5RHdiUkOHJtgcGQOXZdYFTNrV7aybWMXO7b00tcVrrkQUD2xFEI67wI+zbmbtv9PSnn9pY5pCP61JZsrsufgCM+9NMSL+4aJxDMIAat6m9i8vpNNazvYMNBmxN0NAEhl8hw6Psn+o+PsOzzGqeHyGpFw0M0Nm3t5y9Zetm7owr7EN0epN67FLJ1vALcAIWAW+ANAAZBS/kNlWuYXgDspT8v8pYvF71+OIfhXn0gsw7N7Bnl2zyAvHR6jqJZwu2xsv66bGzb3csOmbsODN3hdLMTSvLh/mF0vDbH74CjZXBGb1cK2jV3ceH0fO7esIOCrvzUBSw1j4ZXBBczMJ3nqhVM8+cJpjpycREpoafRx4/V9vHXbCjasbjdi8AaXhaqWOHh8gmf3DPL07kHmFlKYTIINq9t42w0ruWl7P+EGT7XNrEsMwTdgLpLi0WeO88SuUxwfnAGgrzvMzdv7uWl7P72dtTvf32BpI6Xk9PAcz+we5MkXTjE8HgFg/apW3rZzFbe+ZRWhgHFT9UphCP4ypVDUeHbPID997Ah7Do0gJaxa0cTbdqzklhtW0t4SqLaJBsuQ0YkIT75wmid2nWRwZB6zSbB9Uw/vunUdO7esqKkpn0sRQ/CXGUNjC9z/yCEeevoYqXSeppCHd96yljtvWWuIvMGSYnQiws+ePMqDTx1jIZrG73Vw5y1rufv2DXS2BattXk1iCP4yoFBQeXzXKe5/5BCHT0yiWMzctL2Pd9+2gS3rO41FTwZLGq2ks+fACD957DDP7j1DqaSzaW0Hd799Azff0L/kk98tJQzBr2MmZ+L88KED/PTxIyTTeTpaA9z99g3cefNaY0aEQU0SiWV44Ikj3P/IIabnEvi9Dt5z+wbuuWMjTaH6yhJ7NTAEvw45fGKSr/1wN8/tPYNJCG7c3s/777iOTes6jJuvr0FJK5GIZ0lEM6SSOdKVkkrmyWUK5LJFCrliuS6oaGrpXNFKvPxyEQIsihmLxVyuFTN2u4LdYcXutGJ3WHG6bbi9DjxeB26PHY/PiS/owut3GrthvQa6Ltl7aJQfPHiA5146A8BN2/v5uXu2sbqvpcrWLV0Mwa8TpJTsOzLOP39nF/uPjuPzOLjnjo3c846NxhQ3oFjUmJuKMzMRZX4mwcJskvnZBAuzCSJzKeLRDMl4ltf6zdvsCnZHWbBtdgXFasFiMWNWTFgsZkwv60x1KdG0codQ0nTUokY+ry52GsXCxTc2gXIKaK/fiT/oJtjoIdTkJdzkI9xcLi3tQcItPhQjnMHMXIIfPHSQHz18kHS2wPXXdfOJD+1gw0BbtU1bchiCX+NIKXnxwAj/8p1dHD45RUPAxc/dcz3vuX09Dru12uZdU0paidmpOOMjC0wMzzM+PM/kWISZiRgLs8kLxFwIQTDsJtzkIxj24G9wEwi68Te48QVdZY/b68DjK3vfdqf1invcpZJOLlNYHEWkklnSiRzxaIZ4NE0skiYeyRCZT7IwmyS2kL7gHEwmQajZR0tbgNauBjp6wnR0h2nvCdHY4l92I4RMtsAPHjrAN+/fSzyZY/O6Dj7xwR3GyPY8DMGvUaSU7Dk4ype/+RzHTk/TGPLw8fddz7tuXb+kk1VdKRKxDGdOTDN8aobh07MMn5phbGge9bztAH0BF23dDbS2B2luD9LcHqC5LUBji59gyIOlxqb4qapGdD5VHqlMxpiZiDE9GWV6PMrEyAKpxLndrqw2C10rGulZ2UxPfzPd/U30rW7Bswzu3eTyRe5/5BBf/9EeIrEMG1e388mPvYVNazuqbVrVMQS/Bjl4bIIvfv0ZDh2fpCnk4Rc/uIN33rK2buco53NFjh8c5+ThcU4dm2Lw2CRz04nF94NhD939TfT0NdHV10h7T5iO7tCyELfzScQyjA/PMzGywOiZOUZOzzJyepZYJL3YprktQN+aVvrXtDKwoYPVGzqw1mk+m0JR4yePHuJfv/8ikViGLes7ue/eG1m7cvnG+A3BryFm5pN84V+e5MldpwgF3fzCB7bz7tvW1920tEJe5diBMQ7tHebQnmFOHp5A08rpltu6Guhb3Ur/mjb6VrfQs7IZX8DI5/NaxCNphk7PcObYNKeOTTJ4bJLpiRgAitXCwIZ2NmztYcO2HlZv7MRaZyPEQkHlhw8f5N9/sJtYIssdN63h137hpmW5gtcQ/BqgqGp868cv8c/f2QXAz79/Ox+7eyu2OvHMpJSMDs7x0q5BXnr+NEdeGqFY0DCZTfSvbmXDth7Wb+1mzcZO3F5Htc2tC1KJbLlT3TPMob3DnDkxja5LbHaFDdt62LKzny07+2jvrp+0GtlckX//wW6+ef8eLBYzv/KRnXzgnZuwLKN9bQ3BX+K8uH+Yv/zK40xMx7h5ez+//olbaG6s/Q3LC3mVg3uGePHJk7z49AkWZpMAdPaG2byjj007+li3uQuX215lS5cH6WSOwy+NsG/XIPt2DTI5Ws5p09TqZ/vNA2y/eRXrt/bUhfc/MR3jr77yOC/sH6a3M8Rvf/I2rlsm8X1D8Jcwqlri3t/4KmaT4Lc+eRs3bOqptkmXRSqZ44UnjvP848fZt2uQQl7F7rCyeWcf2966ki07+2hs8VfbTANgZiLKS7sG2f30KQ68eIZCXsXhtLJlZz87b1vN9psGcHlqtzOWUvLsnjP89Vcfx+mw8s//9xeXxYpzQ/CXOGOTUZobvTUbpy8WNXY/dZJH7t/P3udOUdJ0ws0+brhlgO03D7BhW314jfVMIa9yYPcQLz51gheePEF0PoWimLn+plXcfvcmtr11Zc3NeDpLvqCyEE0vmzxShuAbXBUmRhb42ff28uj9+0jEsgTDHt5210ZuumMdK9e21U1ceLmh6zonDk3w9EOHeeKBQyRiGQIhN3fcs4U737+F5nYjqdlSxhB8gyuGqmo8/9hxHvjObg7uGcZkNrHjlgHufP9WNu9YgXkZ3RxbDmhqiT3PnuLB7+1lz7OnkBI27VjBXR/cxo5bBoz/9xLEEHyDyyYWSfPAd/fw02/vJjqfoqnVzzs/sJW337OFhrCR1mE5MD8T56Ef7OPB7+9lYTZJuNnHez66nTvfvxWvf3mth1jKXIs9be8E/howA1+WUn7+Ze9/AvgzYLLy0heklF++1HENwa8+o2fm+PZXnubphw6jqiW2vqWfu++9ga1v6cdkWl7L+g3KlEo6Lz51gvu//gIHdg9htVl4210b+civ3ERrZ0O1zVv2XFXBF0KYgVPA24EJYA/wMSnlsfPafALYKqX89Bs5tiH41WNuOs6///3jPHr/fqw2hXfcs5n3fHQ7HT3haptmsIQYOT3Lj76xi8d/chBNK3Hn+7Zy76feZoz6qshrCf6VmDpxPTAopRyqfNk3gfcCx17zUwZLkmQ8yze//BQ//uaLICX3fHwnH/mVm4yVrgYXpbu/id/8H/fw8//xNr7xpSd54Lt7ePTH+7nn53bwoV+60VhEt8S4Eh7+B4E7pZSfrDz/eWD7+d58xcP/P8A85dHAf5ZSjr/K8e4D7gPo7OzcMjo6eln2Gbw+ikWN+7/+At/4xyfJZQrcfvcmPv5rtxpz5g3eEFPjEf7tbx/jiQcO4fE5+Piv3cq7PnR9zU7prEWudkjn9Qh+A5CWUhaEEL8KfERKeeuljm2EdK4+Ukqee/QYX/nLB5meiLHtxpV88rfvpGtFY7VNM6hhzpyY5h//78848OIQHT1hPvlf7uT6G1caU3WvAVdb8HcAfyilvKPy/PcApJT/51Xam4GolPKSuQMMwb+6ROaS/NUf/pA9z56ia0Uj9/3Xd7JlZ3+1zTKoE6SUvPDkCb78Fw8yORrhLbet4df/+3vxB43w4NXkagu+hXKY5jbKs3D2APdKKY+e16ZFSjldefw+4LNSyhsudWxD8K8eLzx5gr/4H9+nkFf5pd94O+/56HZjTrXBVUFVNX7wb8/zb3/7GB6/k8987gNsvqGv2mbVLa8l+Jc9r05KqQGfBh4CjgPfllIeFUL8kRDi7kqz3xBCHBVCHAR+A/jE5X6vwZujkFf52//9Y/7wN/6dcLOPL3zrP3LPx3caYm9w1VAUCx/+5Zv4669/CrfHzn+775/58l88iKq++vaPBlcHY+HVMmLk9Cyf/+y3GRmc5X0/v5Nf+s13GDluDK4p+VyRf/zzB/npd3bTv6aVz37+w7R3h6ptVl1xVT18g9rgiZ8e5Dfu/Xvi0TR//He/wK/+17sMsTe45tgdVn79v9/Nf//Le5mZjPHrH/07nn/cmMF9rTAEfxnw42++yJ/83ndYta6dv/vup9n61pXVNslgmfOW29bwd9/5NJ29jfzxb3+DR+/fX22TlgWG4Nc53/nqM/zt//4x228e4HP/8IsEQ8YKSIOlQbjZx+e//Ets2NrDn/9/3+Mn33qx2ibVPYbg1ylSSv7lC4/ylb96iJvvXM9//4uP1e1G1ga1i8Np44/+9ufZfvMAX/jcj/nOPz1TbZPqGkPw6xApJV/9q4f5xpee5I73beF3/s+HjJWOBksWq03hv//Fx7j5zvV85S8f4utfeqLaJtUtxl27OuT+b7zAd/7pGd794ev5T7//HmN1o8GSx6KYy46Jxcy/fuExwk0+3v7ezdU2q+4wPPw649TRSf7xzx9k+02r+I//7d2G2BvUDGazid/+X+9nw7YevvC5HzMyOFttk+oOQ/DriHQyx//+zDcJhNz8lz/+gJGv3qDmMJtNfPbzH8bhtPK//+u3yGeL1TaprjAUoU6QUvKXf/AD5mcT/N6ffcTYgcigZmkIe/idz3+I8aF5/vb//Lja5tQVhuDXCQ98dw/PPXaMX/qNd7BmY2e1zTEwuCw239DHvffdwiM/2s8TPz1YbXPqBkPw64BiQeXf/+5x1m/t5v2/sLPa5hgYXBHu/dTb6F/bxr984VFKWqna5tQFhuDXAQ//cB+xSJqPf+pWI25vUDeYzSbuve8WZiZjPPXQ4WqbUxcY6lDjlLQS3/mnZxjY0MGGbT3VNsfA4Iqy/eZVdK1o5Ftffhpd16ttTs1jCH6N8+SDh5mdivPRT95sTME0qDtMJhMf+eRNjJ6Z48WnTlbbnJrHEPwa52ff3UNnb5jrbzISohnUJzffsZ7GFh8/+56RKv1yMQS/hikWVE4enmDbW1casXuDusVsMbNlZz9H949SKhlhncvBUIka5tSRSVS1xLot3dU2xcDgqrJ2cxeZVJ5RY/XtZWEIfg1zZN8IAGs3dVXXEAODq8z6ilNzZN9odQ2pca6I4Ash7hRCnBRCDAohfvci79uEEN+qvP+iEKL7SnzvcufogTE6VzQaq2oN6p6m1gDhZh9H9xuCfzlctuALIczA3wLvBNYAHxNCrHlZs18BYlLKPuAvgT+53O81gFQiR6jJW20zDAyuCaEmL6lEttpm1DRXwsO/HhiUUg5JKYvAN4H3vqzNe4F/qTz+LnCbMOYQGhgYGFxTroTgtwHj5z2fqLx20TZSSg1IAA0XO5gQ4j4hxF4hxN75+fkrYJ6BgYGBASzBm7ZSyi9JKbdKKbeGw+Fqm2NgYGBQN1wJwZ8EOs573l557aJthBAWwAdErsB3L2scTiupuBHTNFgeJONZ7A5rtc2oaa6E4O8B+oUQPUIIK/BR4P6Xtbkf+MXK4w8Cj0sp5RX47mXNwIYOzpycIZctVNsUA4OrSiySZnI0wuoNRurvy+GyBb8Sk/808BBwHPi2lPKoEOKPhBB3V5p9BWgQQgwCvw28YuqmwRtn7aYu9JLO8YPjl25sYFDDHK3Mv1+7xVhzcjlckU3MpZQPAA+87LX/cd7jPPChK/FdBudYvbEDk0lwZN8Im3f0VdscA4OrxpF9I9jsCv1rWqttSk2z5G7aGrx+XG4767Z08+wjR6ttioHBVUNKyf4XzrBqfTuKckV81GWLIfg1zs63rWZsaJ5jB8aqbYqBwVXhpecHGT0zx9vu2lhtU2oeQ/BrnDvfvxWv38m3vvxUtU0xMLgqfOvLTxFq8nL73ddV25SaxxD8GsfutHLPx3fw4tMnGTo5XW1zDAyuKEf2jXD4pRE++IkbjXDOFcAQ/DrgPR+9AafLxjf+0fDyDeoHKSXf/Men8AWc3Pn+LdU2py4wBL8O8HgdvO/jO3nm4SM8bWz2bFAnPPzDfex97jQf/uWbjAVXVwhD8OuEj913CwMbOvirP/whU2PGImaD2mb41Ax/+79/zHXbe7nn4zurbU7dYAh+nWBRzPy3P/sIJrOJz33mmxQLarVNMjB4U+SyBT73mW/i8tj57Oc/jNlsyNSVwvhL1hGNLX4+88cf4MyJab705w9W2xwDgzeMlJK/+eP7mRqL8Luf/zCBBne1TaorDMGvM264ZYAP/OJb+cm3XuSH//58tc0xMHhDfOMfn+Txnxzk5z71NjZe31ttc+oOY55THfJLv/F2Ziai/MOfPoCqlvjQL91YbZMMDF4TKSX//neP87UvPsFt776Oj/6HW6ptUl1iePh1iEUx83t/+hFuumMdX/nLh/i3v30MIzmpwVJFSsmX/vxnfO2LT/CO923mt//X+424/VXC8PDrFIti5rOf/zB2p5WvffEJstkC933mnRg7SxosJUolnb/5Xz/iwe+/xHvv3cGv/s47MZkMsb9aGIJfx5jNJn7rD+7B4bDxg397nnQyx6//f3djtSnVNs3AgHy2yF/8wfd5+qEjfPQ/3Mwvfvp2wyG5yhiCX+eYTCY+9dm7cHvsfO2LT3DmxDS/+ycfprO3sdqmGSxjhk5O8/nPfpvx4QV+5T/fYdxnukYYY6dlgBCCn/9Pt/E//+bjROaS/PpH/54HvrvHiOsbXHOklPzw35/nN+/9B9KpPJ/74i8aYn8NMQR/GbH95gH+7jufZs11nfy/P/oRf/zb3yCVMPbENbg2xCJp/sd/+jf+4U8fYPPOfv7uO59m8w3Gxj3XErGUvbytW7fKvXv3VtuMukPXdb73L8/xz3/zCIGgm//8R+9jy87+aptlUMfseuI4f/0/f0gmXeA/fOZO3vOR7Ua8/iohhHhJSrn1ou9djuALIYLAt4BuYAT4sJQydpF2JeBsVq8xKeXdL29zMQzBv7qcPjbJn/7edxkfnmfnrav55G/fSWtnQ7XNMqgjxobm+Mc/f5A9z56id1Uz//VzH6RnZXO1zaprrqbg/ykQlVJ+Xgjxu0BASvnZi7RLSynf8BppQ/CvPoW8yvf/9Tm+9ZWn0dQS7733Bj523y24vY5qm2ZQwyRiGf797x/np9/Zg8Np5d77buHue28wctpfA66m4J8EbpFSTgshWoAnpZSrLtLOEPwlTmQ+xb9+4VEe/uE+XB47H/nlm7j73huw2Y0pnAavn1y2wPf/7Xm+98/Pks+r3PXBbXz8127FH3RV27Rlw9UU/LiU0l95LIDY2ecva6cBBwAN+LyU8oevccz7gPsAOjs7t4yOjr5p+wzeOEMnp/mn//cIe545RUOjh49/6lbecc9mzBZztU0zWMKoqsbPvruXr3/xCeLRDDtvW8Mnfv12Y/pvFbgswRdCPApcLOj2+8C/nC/wQoiYlDJwkWO0SSknhRC9wOPAbVLKM5cy3PDwq8fhvcN89a8f5vjBcVo7G7jn4zu4/T2bcLps1TbNYAmRTuZ4+Ef7+NHXdjE7FWfDth5++TffwcCGjmqbtmypekjnZZ/5Z+AnUsrvXur4huBXFyklLzx5gq9/6UlOH53E6bZxxz1beM9Htxs3d5c5Y0Nz3P+NF3n0/v3kc0XWXNfJvffdwpa39Buzb6rM1RT8PwMi5920DUopf+dlbQJAVkpZEEKEgF3Ae6WUxy51fEPwlwZSSk4cmuBHX9/FM48cQS9JNu/o450f3MoNNw9gUYxwz3KgWNTY9fhxfvbdPRzYPYSimLn5nRt477030L+mrdrmGVS4moLfAHwb6ARGKU/LjAohtgKfklJ+UgixE/gioFNe6PVXUsqvvJ7jG4K/9IjMJXngu3t46PsvsTCXJBByc8c9W7jj/VtoaQ9W2zyDq8DEyAI/+95eHr1/H4lYlsZWP+98/1be+YGt+I0NSpYcV03wrzaG4C9dSlqJPc+e5mff3cOeZ0+h65L1W7q57T3XsfPWNXj9zmqbaHAZxKMZnnvsKI/ev5/jB8cxmU3ccMsAd31wG5t3rDAyWi5hDMFf4iTTeTwuW83GPudn4jx6/wEe/fF+JkcjmMwmNm7r4YZbBth+8wDNba+4j2+wBJkai/DCUyd44ckTHHlpBF2XdK5o5O3v2cSt77mOhrCn2ia+KaSUpLMFPC57tU25JhiCv4QplXTu+72v4fM4+K1fuZXO1toNi0gpOX1simcfPcpzjx5jcnQBgO6+JrbfvIrrb1rFwPp2Y4rnEkFVNY4fHGf30yd58amTjA/PA9C5opG33LaGt96+lt5VzTXriAAMjc3zF19+DIC/+Z8fqelzeb0Ygr+EKZV0vv/gAb78zWcpFkt89O6t/MIHtuOwW6tt2mUzMbLAi0+f5MWnTnBk3yh6ScfptnHd9hVs2dHH5p19NLcFlsVFuBSQUjI5GmHfrkFeen6QQ3uGyGWLWCxm1m/tZvvNA2y/eVVd3IvJZAt89dvP892f7sPltPGrP3cj77l9AyZT/f/WDMGvASKxDH/3b0/x0FPHaAx5+PQv3sLbdqysGzFMJXMceOFMRWxOMzedAKCxxceGrT1s2NbDhq09NBkdwBVDSsn0eJSDe4Y5tHeYw3uGWZhLAtDSHmDLzn427+xj4/W9uNz1Ee7Qdckjzxzn7/7tKaLxDO+5fQO/+nM34vMsn1QhhuDXEAePTfAXX36MM6PzrF/Vyic/9la2rO+stllXFCklEyML7H/hTFmI9g6TiJXTNDc0euhb3Ub/mlb617TSt6aNYMhtdAKXQErJwmySweNTnD42yeljUwwemyIWSQMQaHCzYVsP67d0s3lnH60d9bWOQkrJC/uH+co3n+PEmVlW9zXznz95G2v6W6pt2jXHEPwao1TS+enjR/inbz/PfDTNprUdfPKjb2HjmvZqm3ZV0HWdsaF5Du0d5uShCU4fm2R8eGFxgxZfwEl3XxPd/c30rGyic0UjHd0hPL7lORMoEcswMbLA6Jk5Rk7PMnx6huFTs6STOQBMJkFnbyN9a1pZvaGDDdt6aO8O1WWnKaXkpcNjfPmbz3Hk5BQtjV5++SNv4Y6b1iyL8M3FMAS/RikUNe5/5BD/9v0XiMazbFrbwSc+tIPN6zrq8uI9n1y2wJkT0wwen2bk9ExF2GYp5NXFNr6Ai46eEG1dIVo6grS0B2luD9DcFsDrd9bs30hKSSKWZWYiyvRElJmJGNMTUSZGF5gYXiAZP7dpjcNppbu/iZ6VzXT3N9E30Ervqmbsjtq/B/RanPXo/+W7L3Dk5BSNDR5+4YM38K63rUNZ5gsBDcGvcfIFlfsfOcTXfribSCzD+lWt/OKHdrD9uu6aFbU3g67rzEzEGB+eZ2JkgfHhecaHF5gcXSAezVzQ1mZXCDX5CDd5CTX7aAh78Afd+BtcBBrc+INu3F4HHp/jmmQElVJSyKukEjlSyRzxaJpEJEMsmiYezRCZTbIwm2C+UhcL2gWfD4TctHeFaO8J0dETpr07RGdPmMZW/7KaE6/rkudfOsM/f2cXJ87M0hTy8PH3beeuW9dhsxqpl8EQ/LqhUNT46eOH+fcf7GZuIcXKnkY++t5tvO2Glcveq8lni8xMxhY94vnZRFlAZ8olFklT0vSLflaxWnB77ThdduwOBbvDisNpxWZXsChmFMWM2VKuxcvCBHpJomklNLWEppVQ1RKFnEo+V1ws2XSBdDKHqpYu+v0Wi5lAyE242Ue42bfYUTW3B2npCNLU6q97j/1SFIoajz17gm/+eC9DYwu0Nvn4hfffwB03r1n2v/2XYwh+naGqJR566hhf/9EexqaiBP1O3nP7Bt77jo00NtTm4pirja7rZFJ5YpE0sUiaRDRDKpkjncyRTuZJJ3NkMwXy2bJI53JFCjkVTdPRVG1R1F9+uQgBimLBbDFhUSxYLCbsDmu543DasDsUnG4bHq8D93nFH6yMNBrcuD32ZTVSeyNMzyX44UMH+cljh0mkcvR2hrj3vdu4/cbVWMzLZ2TzRjAEv07RdcmegyN872f72bVvCCEEO7f0cvfbN7D9uh7MxgVhUINoWonnXhri/kcOsvvACEIIbtzWx/vfuWlZ3L+6XAzBXwZMzcb58aOH+enjh4nGszSGPLz7tvXcdctamht91TbPwOCSTM7E+enjR/jp44eJxDKEg27efdt63n37eppC3mqbVzMYgr+M0LQSz+45w/2PHGL3wRGEgC3ru7jr1nXcfH0fNpuxZaHB0iGXL/LkrlP89IkjHDg6gRCwY3N5lHrD5l4jbPMmMAR/mTI9l+BnTx7lgcePMDOfxOmwcuO2Pm7ZsZLrN3YZ4m9QFXL5Ii/sH+bJXad5/qUz5PIq7c1+7rp1HXfesta4D3WZGIK/zNF1yf6j4zz89DGe3j1IKp3HYVfYuaWXm29YyQ2benAu81kgBleXdKbArn1DPPXCKXbtG6ZQ1PB7Hdy0vZ87blrDhtVtRmz+CmEIvsEimlZi/9Fxnth1iqdfPE08mUOxmNmyvpMbr+/jLdtWEAoYm1oYXD5zkRTP7B7k2T2D7D86jqbpNPhd3HxDP7fcsJINa9qNkM1VwBB8g4tSKukcOjHJs7sHeWbPIFOz5YRmq/uauWFzDzs29zKwonnZLlE3eGOUSjrHB2d4/qUhXtg3xKnhOQA6W4O89foV3Litj7UrW43f01XGEHyDSyKlZHh8gWd2n2HXviGOnppCSvB7HWzf1MPmdR1sWttBS6PPGHobAJV0yzNx9h8d56XDY+w+MEIyncdsEqxb1caOLT3cuK2Prvb6StS21Lmae9p+CPhDYDVwvZTyouoshLgT+GvADHxZSvn513N8Q/CrRzyZZfeBEZ5/aYi9h0aJVxJzNYU8bFrXwcbV7WwYaKOzLWh0AMsEXZeMTEQ4dGKSQ8cn2H9knPloORtn0O9k28Zudm7pZdvGbrx1km65Frmagr+a8ubkXwQ+czHBF0KYgVPA24EJYA/wMSnlsUsd3xD8pUHZ+4+w/+g4+4+Oc+Do+GIH4PM4WD/QyvqBNtb0tzCwoqkuNm8xgGyuyInBGY6enubwiUkOn5wilc4DZYHftLZjsRgd/9LhtQT/srINSSmPV77gtZpdDwxKKYcqbb8JvBe4pOAvF2ZiKUJe15K9gSWEoLczRG9niA+8cxNSSsanYhw6Psmhk5McOj7Js3vOAGA2CXo6QxXxb2ZgRRM9HSEj38kSp6hqDI0ucGJolpNnZjh6aprh8YXFVBJdbUFuuaGf9ava2LC6jbZmf80IvKqViGZyNPmMyQjXIr1cGzB+3vMJYPurNRZC3AfcB9DZWV8bf7wav/2vP2E2nuJ929fx/uvX0Rpc2qsKhRB0tgXpbAvy7tvXA+UQ0LHT0xw7Nc3R09M8/txJ7n/kEACKxcyKrhD9PU3094Tp626ktyOE22Wr5mksW5KpHENjCwyOzjM4Ms+p4TmGxubRKsnlvG47q/ubuWXHStb0t7CmrxlvDe4YNb4Q53svHuEHu4+ysiXEP37qA9U2qepcMqQjhHgUaL7IW78vpfxRpc2TvHpI54PAnVLKT1ae/zywXUr56UsZtxxCOlJKnjg6xHd2HeK5kyNICdf3dfDuzQPcvqEfj6M2RVHXJVOzcU4OzXLyzCwnzsxwemR+MSQAEA66FzuOztYgna0BOloDNIa8S3a0UytoWonZhRRjU1HGp2KMTUYZnYwyNhUlEjuXStrvddDX3ciq3iYG+ppY1dtU0zfmE9k8Dx88xU9eOs6+4SlMQnDTmh4+vGMDN67uqbZ514SrPkvnEoK/A/hDKeUdlee/ByCl/D+XOu5yEPzzmYomuf+lY/x473HGFuJYLWZuWt3DuzYPcOPqHmxKbef7llIyF0kxODLP8PgCw+ORsiBNxkhnC4vtzGYTLY0+2pp9tDX5aQ57aW70leuwl4Cvdjc3uVLouiSWyDI9n2B2PsnMfJLpuQRTMwkmZ+PMzCUo6eeubY/bTmdrgM7WID0dDfR0hujvbqQh4Kr5v2WuqPLU0SF+uv8Ez54YQSvp9DQGuXvrat69ZTXN/uW1crfagm+hfNP2NmCS8k3be6WURy913OUm+GeRUnJkfJaf7jvOz/afIprO4rZbuXXdCu64bhU7+jtRLPUTE5eyLF6jk1Emp+NMzsaZmI4xOZtgaiZ+QWcA5RBRKOgm3OAmHPQQCrpo8LsInlf8Xgdejx1rjXWSRVUjkcwRT+WIxjJEE1mi8QzRWIb5aLpcIikWYunFEMxZPG47rU0+2pv9tDb5aW/x094coLMtiN/rqHlhP5+CqvHcyVEePHCSJ48OkSuqNHpdvHPTAO/aPMBAW7iuzveNcDVn6bwP+BsgDMSBA1LKO4QQrZSnX95VaXcX8FeUp2V+VUr5uddz/OUq+OejlXR2D47zs/0neezIIKlcAa/Dxm3r+3j7hn6293dgtdSWqL1R0pkCM/NJZuYTzMwnmYukmI+kmY+W64VomkJRu+hnnQ4rPo8dj9uBx2XD7bThrtQOu4LDYS3XNgWbTcGqWLBZzVgVS3njE7MJs8mE2Swwm0yvEBEpJVpJR9clJV1H03RUVUPVShSKJYqqRqGgks2r5PJF8vny43S2QDpTIJ3Jk84WSaZyJFI5cudt4Xg+dpuFUNBDOOimscFDKOimscF9wcjH5azN8N/rpaBq7Do1ysMHT/PE0TOk80V8Tju3b+jjndetYuuKdszLaPevV8NYeFUnqFqJ50+VvZonjgyRKRRx263cuLqHW9b08paBbnzO5Tf/WUpJLq8SiWWIxjNE4hmSqbKXnEzlSSRzpDJ5UhWBzWSLpDJ58gX1FRuaXG2EAIfdeq7jqXQ+Hrcdv8eB1+PA53Xg9zgIBlwEfU6CfteyzXUUS+d49sQwTx4b4tkTI2QLKh6HjdvW9XHndSu5vr8DxVw/o90rgSH4dUhB1Xjx9BiPHBrk6eNDRNM5zCbBhs4W3rq6mxsHepb1sPb1oOuSQlElX1DJ5lQKRZVisURRK1EsahRVrey5l3S0kl6OiV9kyyuzSWAxmzCbTZhMAqtiwWq1YFXMlRGDBadDwWG3YrNajP/Ja6DrkmMTszxzfJhnT4xweHwGKaHB4+SWtb28fX0/1/d11FVI80pjCH6dU9J1Do/N8HTlIjk+Uc5hEvI42bGyix2rutjR30nI66qypQYGr2Q2kWbXyVGePzXKi6fHiKZzCAHrOpp560A3N67uYW17k5GD53ViCP4yYyGZ4bmTIzx3YpQXTo8Ry5RXxa5sCXHDyk6u7+tgS28bbnt9x3wNlibJXJ69ZybZPTjGC6fGODMbBcpe/A39nbx1oJudq7oIup1VtrQ2MQR/GaPrkhNTc+w6Ncauk6PsH5miqJUwmwRr25vYVhH/jd0teB3LL/5vcPWJZ3IcHJ3mpTMTvDg4zonJeXQpsSsWNvW0srMyCl3ZEjLCXVcAQ/ANFimoGgdHp3nx9Di7B8c4MjaLppen961oCnJddysbulpY39lMb1PQmPVg8IbQSjpnZiMcGp3m8NgMB0amGZ4re/AWs4mNXS1s7+tgW18HG7qa636GWTUwBN/gVckWVA6PTXNwdJoDI9McHJkimSvPe3faFNa2N7Gus5k17Y2s7WiiPVi7qzANriy6LhmPxDk2McexiVkOjc1wfGKWXGWKrN9p57ruVjZ2t7Cxu5X1nc3Ya2xdRC1iCL7B60bXJWOROIdHpzk0NsORsRlOTM2jlSp5Vhw2Vrc3srqtkVWtYVa1hulpDBqpEOoctVRiaDbKyal5Tk7Nc3xijuOTc6TzRQCsFjMDrWHWdzWzvrM8QuxoMJyDamAIvsFlUdQ0Tk9HODYxu+jNDc5EKGoloHyxr2huoL+5gf7mEH0tIfqaG2jyuY0LvsaQUjITT3F6JsLp6QUGZxY4PR1haDaKWir/v20WM/0tIda0N7G2o4k17Y2saG4w5sMvEa5aemSDK8Pnn3uavKpyW88Krm9rx7bE4ppWi4W1HeWL+yxqqcTIXIyTU/OcmJzn9PQCu06Ncf/e44ttXDYr3Y0BusMBusIBukJ+OkJ+OkP+ZblAbKkgpSSeyTMWiTO+EGdsIc7IfIyR+Rij8zGyhXOrfZt8bvpaQuxc1cVAa5iBtjCdoUBNjOgKmsbzE2M8NjxE2OnkN7fvrLZJVWdpKcsyZS6d5meDp/nXQwdwK1be2tnF23p6ubmrm0bX0szhrZjLXl5/S4h3b1m9+Ho8k2NwJsLgTNkrHJmPsn94igf2n7hgzZLHYaOjwUdb0EtrwEdr0EtrwENLwEuz34PXYTNGB28SKSWJbJ6ZeIrpWIqpWJLJaJKpWJKpaJLxSHwxFAPl1b+tAS/d4QCbe1rpbQzS1xxiRXNDzXXMM+kUT40M8/jIEM+OjZLTNJyKwj0Da6pt2pLACOksEXKqyvMTYzw+PMTjw0PMZspbx60LN3Jzdw83d/VwXXMLlhqdNZNXNSYiccYXEoxHEowtxJmIJpiKJpmKJihUwkNncVgtNPk8NPndNHrdhL0uwl4XIa+LkMdF0O2kweNcVh2DrkuSuTzRdJZIOkckmWE+lWE+ka7UGWbiKWYTafLqhbmFHFYLrQEvLQEvHQ1+OkI+Ohp8dIb8tAV9NZuJtVgqsX96iidHh3lqdIQTC/MAtHo83Nrdy209K7ihvWPJjZqvJkYMv8aQUnJiYZ4nRoZ5anSYfdNTlKTEbbWys6OTGzu7uamzmw6fr9qmXhGklETSWSajSWbiqcUyG08zG0+VxSyZWbxxfD4Ws4mAy4HPacfvchBw2fE5HXgdNjwOW6W247JbcdkUXDYrLpsVh03BoSjYrZZrNvVUK+kUVI2cqpItqGTyRTKFItlCkXS+SCpfIJUrkMwVSObyJDJ5YpkciWyeeCZHPJNfnEJ7PorZTKOv3BE2+d00+z00+z00+dy0BLy0Bb0EXPWRLVNKyUgizjOjIzwzNsILE+NkVBWLycS21jZu7urhlu4e+oMNdXG+bwZD8GucRD7Pc+NjPDM2wtOjI0ynUwB0en3s7OhkR0cn29val2z450qg6+UwxVwyTTSdJZrOEUlliaazxNI54tlcWRQr4pjMFS7aQVwMxWzGrpRz3yhmM1aLGcVsQjGbMZnKWTJNlZw5F8uWWdIluixnyyzpEq1UzsejlnTUUomiWiKnqm/IHo/DVu68XA78Tjt+p4Ogx1Ee2bidBN1Ogh4njV4XPqe9rsVtOpXixckJdk2M8dz4KFOp8u+/w+vjxq5ubuzsYkd7J16bsXIcDMGvK6SUDMdjPD06wvPjY7wwOU66WI7HdvsDbG1tZWtLG1tb2+jxB+paCF4LKSUFrUQqlyeZLZAuFMnki+SKKpnK47K3rVFQNfKqWhZpTa+ItYaq6ZSkRK8IuS4lL79ehBCLnYHJZMIsBIrlvI7DYsJmsWC3WrApFuwWC3argrMy2jhbu+22xVFJrYZXrgRSSs7EouydmmTv1CR7piYZTyYA8Nns3NDeURnldtHtD1TZ2qWJIfh1jKbrHJufY/fkBHumJtg7NUksX95GsMHhYFNzK5tbymV9YxMORamyxQYG58gUixyanWHfzDT7pqc4MDN13u/XydbWNra1trG9rZ2BUNhY+f06MAR/GaFLydB5HtK+mWlG4jEALCYTAw0hNja3sLGpmY1NLawIBjEt01GAwbWlpOucjkY4ODvDodkZDs5McyKygF7RoBWBIJtaWowR6mViCP4yJ5rLsn9mmv3T0xyYnebQ7MxiGMitWFkTbmRdYxPrGpvY0NREtz9gdAIGl0VJ1xmKxTgyN8vh+VkOz85wfGGerFqe4++12Radjs0trVzX3Izf7qiy1fWBIfgGF6BLyXAsysHZGQ7OznBkbpZj8/MUSuWpfA6LhZUNIVY1hBgIhVnVEKK/IUSDoz5mehhcOaSUzGcznI5GOLmwwInIPCcXFjgdjZDXzv2ezjoVG5ua2dDUbHjvV5Gruafth4A/BFYD119sE/NKuxEgBZQA7dWMeTmG4F87tMpw+8jcLMfn5zgZWeDEwvxiPBUgYLfTHwzR39DAikCQFYEgvcEgLW6PMSKoc3QpmUolORONciZWLqejEU5HIiQK534jDQ4nq0JlZ2FNuJH1jU2sCBhZV68lVzO1whHg/cAXX0fbt0kpFy7z++oSKWXVvR2LycTqUJjVofDia2e9t7Me22A0wulohB+fOkGyUFhsZ7dY6PEH6PYH6Pb7F+sun5+w01X1czN4fehSMpdJM5ZIMByPMRKPMRKPL9ZnR4BQnjHT39DAXf0r6Q820N/QwMqGEGHn0txVbSlcY0uByxJ8KeVxwPhDXia/8eK3iRYy7GzsZUdjL+sDbSim6ieiEkLQ6HLT6HJzY1f34utSShZyWYbO8/aG4zGOL8zzyNDgBYuD7BYLHV5fufh8tHm8tHq8tHu9tHm8BI0w0TVDl5JILstUMslkKslEpR5PJhhPJBhPJiiWzq14VkwmOnw+un0BbuzsojcQpLcyslvq/7eiXuJAdJxdc0M8PzdEjzvE57feU22zqs61mvArgYeFEBL4opTyS9foe2uCtYEWHp8+yd+eeIovnHgKl8XKloYurg91sTXUxRp/y5LoAM4ihCDsdBF2utje3nHBe2qpxGQqyUg8zlgivigmo4k4uycnSKvFC9pbzWZa3B5a3B6a3W6a3O7ysV2uync4CTqc+Ox2I2z0KuhSEs/niOZyzGcyzGczzGezzGfSzGYyTKdSzKRTzKTTFPULU1h4rDbavV76gg3c2tO72Dn3BAK0erw1k8qjqJc4Gpti78IouxdGeCkyRq6kYhaC9YE2BnxNlz7IMuCSMXwhxKNA80Xe+n0p5Y8qbZ4EPvMaMfw2KeWkEKIReAT4dSnl06/S9j7gPoDOzs4to6Ojr/dcap54Mcfu+RGenz/Di/MjjKQjADjNChuDHWxu6GBTQwfXBdpxKbW3qlBKSbJQYDKVZLLiXc6kU0xVxGg6lWI+k3mFKAGYhSDgcNDgcBKwO/Db7QQc5dpvt+O12fHabHhtNjxWG26rFY/VhstqxWGxLGlvFMp/m5ymkS4WSBeLpItFkoUCyUKBVCFPslgglssTz+eI5c/VkWyWeD5H6SLXsdVsptHlKneoHg/Nbg8tbjftHh+tlRFWra5OTal5DkQn2BcZY39knIOxCfKVkNMKT5gbwt3sCPdyfbgbj1JbCeAul6s+S+dSgv+ytn8IpKWUf36ptsv9pu18Ps1LkVH2LoyyLzLOycQsOhITglW+Jq4LtrMx2M51wQ46XfUx60FKSaKQZz6TrXiqGaK5HJFslmguSySXLQte7pzwXUzszsckBE5FwakoOCxnaws2i4LNYsZmtmCzmFFMZhRTOaWCxWRCMZkQQmAWpnJaBcQrRhm6lEjK6RVKUkeXEk0vp1TQdB1V11H1EgWtRKGkUdDKJatVcuqoKjmtXOuXOA+LyVTu6M52eHYHDU4nwUpHGHQ4FkdHjS4XHmt9JJaTUjKSjnAgOsHB6AT7o+OcTs4hKTsCA75mtjR0sjXUxZaGToK2pXkf4VpRVcEXQrgAk5QyVXn8CPBHUsoHL3Xc5S74LyetFjgYnWBfdIx9kXEOxSbJauUQScDqZEOgjQ3BNjYE2lgXaMNvrf95zVLKsjdcPOsNF0jk82TU4qKnnC4WyWrqosDmKwJbLJUolErkKyKs6uX8N5peKgt1SS/nyqkI+atdKYJyp2IWJkwmsdhZnOs4zNgtFmwWCzZzuYNxKBYcioLTomBXFFyKgttqxaVYcVttuK3KBaMWr82OS1HqQsAvRbSQ4XBsisOxSQ7FJjkUnSChlmcCuS02NgTb2NzQyeZgBxuC7bgs1ipbvLS4mtMy3wf8DRAG4sABKeUdQohW4MtSyruEEL3ADyofsQBfl1J+7vUc3xD816YkdQaT8xyMTnAgOsGh2ARDqYVFYep0BVjjb2Wtv4V1gVZW+5rxLYNO4Grxah64cW/hzRMrZDmWmOZYbJqj8WmOxKeYzMaBckfa521kfaCV64IdXBdsZ4UnbPy9L4Gx8GoZkVYLHI1PcSg2yeHYFEfjU0xlE4vvtzp9rPI2sdLXVK69jXS5G2rm5pxBbaLqJUbSEU4l5ziVmOVEYpZTyVlmcsnFNh2uAGv9LawPtLE+0MYaf4vhvb8JjC0OlxFuxcb2cA/bwz2Lr8UKWY7FpzkWn+ZEcpaTiVmenj29GPtWTGZ63SH6vGH6vY2s8IRZ4QnR4QoaHYHBG0LVS4ylo5xJLXAmNc/p5ByDqXlGUguosjxd1yJM9HpCbAt1sdLbxBp/C2v8LcsiBFltDA9/mVIoaZxJzXMqMcvp1DyDyfLFOZ07NxpQhIlOdwO9nhA97ga6zysBm7OK1htUEyklsWKWkXSE4VSkXKcjDKcWGMtE0eS5dRjtTj993kb6PGH6vGEGfM30eEJYl9A043rD8PANXoHNbFn0rM4nrRYYTi9wJrXAUGqeodQCg8k5npg+ecGF7FPsdLqDdLqCdLgCdLqCtLn8dDgDNDo8mIUxMqhlSlJnJpdkMhNnPBNjPBtjLB1lLFMuKfXcSuuyYxCk1xPi7a0D9FZGiN2ekBGSWWIYgr8EeGz2cVRdpd/TT5ezE4upev8Wt2JbjKGej6qXmMzGGUlHGElFGM1EGc/EOBSb5GcTR9HPm8OiCBMtTj+tTh8tDh8tTi/NDh/NDi9Ndg+NDi8+pb53aVrKSCmJF3PM5pPM5lLM5pJM5xLM5JJMZxNM5RJMZxMXdPBmIWhzBuhyB9kYbKfTFVwc9bU6/Usy9FfUVUYzo5xOD+KyuLg5fGO1Tao6huAvAfbGXuJY8gQAilDocXfT517BCtcKVrh7CFirv7OPYjIvhnNevgyvqJeYziaYyMaYzMSZyMYYz8SZziZ4fu4Mc/nUK6Y02kwWGh0ewjY3IbubsL1cN9jcNNhcBG2ucm114rRYjc7hEkgpyWhFIoUM0UqJVMp8PsVCIcNCPs18PsVcPvWKxW0mBI0OD80OL+sDbbyzbS3trgDtTj/trgDNDu+SWu19MaLFKGfSQwymzzCYPsNIZhRNlhdjbfZfZwg+Rgx/yRAvxjmdHuR0arD8Y82OUpLlizJoDbLC3Uuvq4deVw/dri7s5tpZPajqJebyZU9yNpdiNp9kPpdiNp+qiFCahUKapJq/6OcVkxm/1UHA6sRvdeKzOvAqdnyKHa/VgUex41FsuC023JXHTrMVp8WKy2LDbq6RlbYllaxWJKsVyWhFUlqejFogpRZIaXlSap5kMU9CzS3W8WKOWCFLophdvCn6cnyKnZDdU+5UbW4aHR6a7B6aHF4az6uXopf+auRKOYYzIwynhxnKDHMmPUxMLW/0owgLXa4u+t199Hv66HOvwKf4qmzxtcOYllmDFHWVsezYoscylB5moVhONioQtDpa6HF10+3spsfVRYezA5u5NpfJnyVfUokWsoveaaxSx4s5YsUs8WKOeKVOVkSvoGuXPK4AHBYrDrNSXvRkVrCZFWwmC1aTGavZgtVkWVxpaxYmLMKExWSuLKgqr7I1CxMv7zZ05LnVtpVFWiVdR5M6WqVW9RJFXaNY0ijqJQq6Rl5TyevlRWD5kkqupL7qwq7zsZsteJVKh7fYCToI2Mqd4fkjo2BlpGQz1/ZAPl/KM5YdZyQzwnBmlJHMCNP5Gc4uhQvbwvS5eysj4l46nR1VDYtWG0Pw64SkmmI4M8xQepjhzDDDmVGSWnke89lOoMvZSZezk05XJ52ODtyKu8pWX10KJY2kmiet5klrZW84rebJllQyWmHRWz4nsNqiwBb18uraQklbfHxOqMupEc6Juf6aC6/KnUG5czCbTFjEuc5DMZVX11pNZ4sZh0XBZlLKm5qbFJwW64XFbMWj2PAodlwWG27Fhk+xY61x8b4USTXFeHac0ewYY9kxRjNjF4i7X/HR7epeHO32uLrr/jf+RjEEv06RUhJTY4xkRhfLaHaMuBpfbONTfLQ72srF2Uabo41WRwsOszHn2aB6ZLQs07kpJnJTTOYmmchNMJGdWnRgAILWAJ3OTrqdXeXRrKsLv9VfPaNrBGNaZp0ihCBoDRK0Btkc2LT4elJNMpodYzw7Ub6YspM8Mf8URf1cauKgNUCrvZVWRystjmZa7OXiU3xLPt5tUBuUHZI4M/kZpnPTTOdnmMpNM5mbusApsZqstDna2OhfT7ujjQ5nB53ODjyKp3rG1ymG4NchXsXLet861vvWLb6mS525wjxTuSkmc1NM5aaZyk3x5Ms6AofZQbO9iSZbE032RprsTTTbm2i0hXFb3EZnYHABUkpSWoq5/ByzhTlm8rPM5meZyc8xm58hr5+3M5rJRoujlXW+NbTaW2h1lB2OsC2EyVi3cU0wBH+ZYBImmiviff5oQJc6sWKc6XzZA5vOzTCTn2EwfYYXo7s5P0ekw+yg0Ram0RYmbAsTsoUI2UKEbSFCtgasJmORTT1SKBVYKEZYKCwwX1io1PPMFeaZy8+T18/NrhIIQrYQzfYmVnr6aLE302xvpsXRQkDxGw5DlTEEfwmwkNuHWdjw2VZiEso1/W6TMNFgC9JgC7LOt/aC94q6ynxhntn8HHOFOeby88wV5hjLTrA/fnBxjvNZPBYPDdYgQVuQBmuQgOLHb/UTsAYIKAH8Vh92k7HgaqkgpSSv54kV48SKMWJqpS7GiRajRItRIsUoaS19wecUYSFkC9FoC7PKs3LRAWiyNxG2hVBM1/Y3/FqUZJFE4RSSEg32jdU2p+oYgr8EOBz5S2KFI5hQ8NlWEbCtJWBbg9+2Bo+1G5Oozr/JalJoc7TS5mh9xXu61ImriUWvL1KMsFCIEC1Gmc3Pcjx5glwpd5FjWvErfnyKF5/iw6d48SgefIoPr8WDR/HgsbhxW9y4LC7MYmkv9llqlGSJtJYmrWVIqSlSWoqkmiSppkhqSZJqkriaJKEmSKiJC8J5Z3GaHYv3hnpdPTTYGghZGyojuRBexbskQzC6VEkWh4gXjhMrHCNWOFoRe42w43pubP1itU2sOsYsnSVAVp0iWjhKLH+EWOEoscIxSrIslmZhx2ddid+2Gr9tFX7barzWFdd8JPBmyJfyxItxYmqcaDG2KDLxYmLxcVJLvcKDPB+X2YnL4sZlceIyu3BZXDgtTpxmJ06zA6fFicPswGGyYzfbcZjt2M0ObCYbNrMVm8m2JMXpYuhSp6AXKJQKFPQC+VKeXClfqXNkSzmypWz5sZYlW8qS1jKLdaby+GIIBG6LC4/ixa948Z3X6foVP4HFkZi/JtZzlPQCyeIg8eJJ4oUTxAvHSRRPoctyB2YRLgL2suMUsK0lYF+H03KxnVrrD2NaZo0hZYmUOkq8cHzRW0kUTqLJ8sUssOC1rsBnW4nPWim2fmzm6qdgeDNoukZaS5NQkxXvNE1KS1c81DTZUmZR0NJahlwpS7aUW1yJfCkUoWA1WStFQTFZUUwKirBgMVlQhAWzyYJFWMrbGQozZmHGJMyUZ9cLTJV59i8PR0kp0SnvjCWR6FKnhI4uS5RkiZLU0aSGpmuLtSo1VL1IUVdRdZWiXqSoF1Gl+rrOxyzMix3e2ZGQy+LCZXaeN0Ly4FHKIyWvxYtHcdfsaCmvRUkUT5EsniJROFV5PIykHFK0mNz4rasqo+LV+G1rcCsdiBrp6K80huDXAVLqZNTx8zyakySKpyiUFhbb2M0hvNZ+fNY+vNY+PNZePNZuFFP9LUyRUlLUi4se71lPOK+XveKzXvJZj7ksrmWRLcoiqq4uiq+mq2hSWxToktQqdQkqIn5WzC9GuTMwYRKiUpcXXpkqHYdZmFFMFszCstjJWE3WSkdU7oBsJitWsxW7yY7NbMNmslZGLA7sldHL2RGNIupzq0O1lCKlDpMsDpEsDpIsDpIoDlIoRRbb2M1hfLaV+K0D+G2r8NkGcFnalq24XwxjHn4dIIQJt7ULt7WLdvc7Fl8/6/0kiqdIFk6TLJ7hTPLb6PK86XDmRjzWbjxKDx5rN26lC4/ShcPSXLMXihCiLIxmGwFqc2SzHJGyRFabIaWOkC6OVuoRUuow+fOcF7Ow47H20ux8K15rX82PYpcKhuDXOHZLELvlBpqcNyy+JmWJtDpBSh0iVRwuF3WEsdRP0GRmsZ1J2HArnbiVDlxKR7m2dOBW2nFYmhA1GgIwqC661Mhpc2TUcdLqeKUeK9fa+GKcHUAxufEoPTQ6d+JVenBbu/Fae3FZ2mvWGVnKXJbgCyH+DHgPUATOAL8kpYxfpN2dwF8DZsqbm3/+cr7X4LURwozH2oXH2gWuty2+LqUkX1ogrY6SVscWPaxUcZiZzDPonIshCyy4lFaclvZK3bpYOy2t2MzBugwrGFwaKXUKpShZbYqMOlWutSmy6iQZdZKsNr0YX4eKY2Fpx6V00OR6Kx6lC3elGL+ja8tlxfCFEO8AHpdSakKIPwGQUn72ZW3MwCng7cAEsAf4mJTy2KWOb8Twrx1Slshps2VPTJsio06QUSfJaBNk1UmKeuKC9iZhxWlpxmFpxmlpwWFpKhdzIw5LIw5LE4rJa1zMNUb53kicnDZXKbPkS3NktRly6ky51mYucA4ArCY/LqX9PCehDZelHbe1E4e50fDWryFXLYYvpXz4vKcvAB+8SLPrgUEp5VDFmG8C7wUuKfgG1w4hzDiVVpzKK+fcA6h6mqw6XfHqJslps5WLf5rZ7POV+OuFzkOb6+1sb/7Ta2C9wZXi+elPM5t7/mWvmnCYwziUZgL2NbRabsVpacZpaasIfAsWk7HHcS1wJWP4vwx86yKvtwHj5z2fALa/2kGEEPcB91WepoUQJ897OwQsvPJTNU+dntcB4M/q9Nzq9X9Wt+cF9XtuLz+vrldreEnBF0I8yis2tQPg96WUP6q0+X1AA772xux8JVLKLwFfehVb9r7aUKWWqdfzgvo9N+O8ao96Pbc3cl6XFHwp5e2X+LJPAO8GbpMXvyEwCXSc97y98pqBgYGBwTXksu6kVGbf/A5wt5Ty4mu6yzdp+4UQPUIIK/BR4P7L+V4DAwMDgzfO5d46/wLgAR4RQhwQQvwDgBCiVQjxAICUUgM+DTwEHAe+LaU8+ia/76KhnjqgXs8L6vfcjPOqPer13F73eS3p1AoGBgYGBlcOY3KsgYGBwTLBEHwDAwODZULNCb4Q4n8JIQ5V7hk8LIS4+EqhGkMI8WdCiBOVc/uBEMJfbZuuBEKIDwkhjgohdCFEzU+JE0LcKYQ4KYQYFEL8brXtuVIIIb4qhJgTQhypti1XEiFEhxDiCSHEscrv8DerbdOVQghhF0LsFkIcrJzb/7zkZ2othi+E8Eopk5XHvwGskVJ+qspmXTavJ01FLSKEWA3owBeBz0gpazZXxuWkCVnqCCFuAtLAv0op11XbniuFEKIFaJFS7hNCeICXgHvq5H8mAJeUMi2EUIBngd+UUr7wap+pOQ//rNhXcPHy9fw1ipTy4cqMJiinqWivpj1XCinlcSnlyUu3rAkW04RIKYvA2TQhNY+U8mkgWm07rjRSymkp5b7K4xTlmYJt1bXqyiDLnN0uTqmU19TDmhN8ACHE54QQ48DPAf+j2vZcBX4Z+Fm1jTB4BRdLE1IX4rEcEEJ0A5uAF6tsyhVDCGEWQhwA5oBHpJSveW5LUvCFEI8KIY5cpLwXQEr5+1LKDsqpHD5dXWtfP5c6r0qbK5am4lrxes7LwKCaCCHcwPeA33pZlKCmkVKWpJTXUY4IXC+EeM1w3JLcAOVS6RzO42vAA8AfXEVzrhhXIE3FkuQN/L9qHSNNSA1SiW9/D/ialPL71bbnaiCljAshngDuBF71xvuS9PBfCyFE/3lP3wucqJYtV5LXmabCoLoYaUJqjMqNza8Ax6WUf1Fte64kQojw2dl8QggH5ckEr6mHtThL53vAKsozP0aBT0kpa97LEkIMAjbg7I7NL9TJ7KP3AX8DhIE4cEBKeUdVjboMhBB3AX9Fefe2r0opP1ddi64MQohvALdQTrU7C/yBlPIrVTXqCiCEeCvwDHCYsmYA/Dcp5QPVs+rKIITYAPwL5d+iiXLamj96zc/UmuAbGBgYGLw5ai6kY2BgYGDw5jAE38DAwGCZYAi+gYGBwTLBEHwDAwODZYIh+AYGBgbLBEPwDQwMDJYJhuAbGBgYLBP+f3ciTSpuN9TFAAAAAElFTkSuQmCC\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapteroptimization_58_0.png" - }, - "needs_background": "light" - }, - "output_type": "display_data" - } - ], - "source": [ - "pt.axis(\"equal\")\n", - "pt.contour(xmesh, ymesh, fmesh)\n", - "guesses = [np.array([2, 2./5])]" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Find guesses" - ] - }, - { - "cell_type": "code", - "execution_count": 3, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "x = guesses[-1]\n", - "s = -df(x)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Run it!" - ] - }, - { - "cell_type": "code", - "execution_count": 4, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "[ 1.33333333 -0.26666667]\n" - ] - } - ], - "source": [ - "def f1d(alpha):\n", - " return f(x + alpha*s)\n", - "\n", - "alpha_opt = sopt.golden(f1d)\n", - "next_guess = x + alpha_opt * s\n", - "guesses.append(next_guess)\n", - "print(next_guess)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "What happened?" - ] - }, - { - "cell_type": "code", - "execution_count": 5, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "data": { - "text/plain": [ - "[]" - ] - }, - "execution_count": 5, - "metadata": {}, - "output_type": "execute_result" - }, - { - "data": { - "image/png": "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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapteroptimization_64_1.png" - }, - "needs_background": "light" - }, - "output_type": "display_data" - } - ], - "source": [ - "pt.axis(\"equal\")\n", - "pt.contour(xmesh, ymesh, fmesh, 50)\n", - "it_array = np.array(guesses)\n", - "pt.plot(it_array.T[0], it_array.T[1], \"x-\")" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Conjugate gradient method\n", - "In the CG method we define so-called conjugate directions and two vectors \n", - "$\\boldsymbol{s}$ and $\\boldsymbol{t}$\n", - "are said to be\n", - "conjugate if" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{s}^T\\boldsymbol{A}\\boldsymbol{t}= 0.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The philosophy of the CG method is to perform searches in various conjugate directions\n", - "of our vectors $\\boldsymbol{x}_i$ obeying the above criterion, namely" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{x}_i^T\\boldsymbol{A}\\boldsymbol{x}_j= 0.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Two vectors are conjugate if they are orthogonal with respect to \n", - "this inner product. Being conjugate is a symmetric relation: if $\\boldsymbol{s}$ is conjugate to $\\boldsymbol{t}$, then $\\boldsymbol{t}$ is conjugate to $\\boldsymbol{s}$.\n", - "\n", - "An example is given by the eigenvectors of the matrix" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{v}_i^T\\boldsymbol{A}\\boldsymbol{v}_j= \\lambda\\boldsymbol{v}_i^T\\boldsymbol{v}_j,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which is zero unless $i=j$. \n", - "\n", - "Assume now that we have a symmetric positive-definite matrix $\\boldsymbol{A}$ of size\n", - "$n\\times n$. At each iteration $i+1$ we obtain the conjugate direction of a vector" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{x}_{i+1}=\\boldsymbol{x}_{i}+\\alpha_i\\boldsymbol{p}_{i}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We assume that $\\boldsymbol{p}_{i}$ is a sequence of $n$ mutually conjugate directions. \n", - "Then the $\\boldsymbol{p}_{i}$ form a basis of $R^n$ and we can expand the solution \n", - "$ \\boldsymbol{A}\\boldsymbol{x} = \\boldsymbol{b}$ in this basis, namely" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{x} = \\sum^{n}_{i=1} \\alpha_i \\boldsymbol{p}_i.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The coefficients are given by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbf{A}\\mathbf{x} = \\sum^{n}_{i=1} \\alpha_i \\mathbf{A} \\mathbf{p}_i = \\mathbf{b}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Multiplying with $\\boldsymbol{p}_k^T$ from the left gives" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{p}_k^T \\boldsymbol{A}\\boldsymbol{x} = \\sum^{n}_{i=1} \\alpha_i\\boldsymbol{p}_k^T \\boldsymbol{A}\\boldsymbol{p}_i= \\boldsymbol{p}_k^T \\boldsymbol{b},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and we can define the coefficients $\\alpha_k$ as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\alpha_k = \\frac{\\boldsymbol{p}_k^T \\boldsymbol{b}}{\\boldsymbol{p}_k^T \\boldsymbol{A} \\boldsymbol{p}_k}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "If we choose the conjugate vectors $\\boldsymbol{p}_k$ carefully, \n", - "then we may not need all of them to obtain a good approximation to the solution \n", - "$\\boldsymbol{x}$. \n", - "We want to regard the conjugate gradient method as an iterative method. \n", - "This will us to solve systems where $n$ is so large that the direct \n", - "method would take too much time.\n", - "\n", - "We denote the initial guess for $\\boldsymbol{x}$ as $\\boldsymbol{x}_0$. \n", - "We can assume without loss of generality that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{x}_0=0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "or consider the system" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{A}\\boldsymbol{z} = \\boldsymbol{b}-\\boldsymbol{A}\\boldsymbol{x}_0,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "instead.\n", - "\n", - "One can show that the solution $\\boldsymbol{x}$ is also the unique minimizer of the quadratic form" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "f(\\boldsymbol{x}) = \\frac{1}{2}\\boldsymbol{x}^T\\boldsymbol{A}\\boldsymbol{x} - \\boldsymbol{x}^T \\boldsymbol{x} , \\quad \\boldsymbol{x}\\in\\mathbf{R}^n.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "This suggests taking the first basis vector $\\boldsymbol{p}_1$ \n", - "to be the gradient of $f$ at $\\boldsymbol{x}=\\boldsymbol{x}_0$, \n", - "which equals" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{A}\\boldsymbol{x}_0-\\boldsymbol{b},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and \n", - "$\\boldsymbol{x}_0=0$ it is equal $-\\boldsymbol{b}$.\n", - "The other vectors in the basis will be conjugate to the gradient, \n", - "hence the name conjugate gradient method.\n", - "\n", - "Let $\\boldsymbol{r}_k$ be the residual at the $k$-th step:" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{r}_k=\\boldsymbol{b}-\\boldsymbol{A}\\boldsymbol{x}_k.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Note that $\\boldsymbol{r}_k$ is the negative gradient of $f$ at \n", - "$\\boldsymbol{x}=\\boldsymbol{x}_k$, \n", - "so the gradient descent method would be to move in the direction $\\boldsymbol{r}_k$. \n", - "Here, we insist that the directions $\\boldsymbol{p}_k$ are conjugate to each other, \n", - "so we take the direction closest to the gradient $\\boldsymbol{r}_k$ \n", - "under the conjugacy constraint. \n", - "This gives the following expression" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{p}_{k+1}=\\boldsymbol{r}_k-\\frac{\\boldsymbol{p}_k^T \\boldsymbol{A}\\boldsymbol{r}_k}{\\boldsymbol{p}_k^T\\boldsymbol{A}\\boldsymbol{p}_k} \\boldsymbol{p}_k.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We can also compute the residual iteratively as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{r}_{k+1}=\\boldsymbol{b}-\\boldsymbol{A}\\boldsymbol{x}_{k+1},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which equals" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{b}-\\boldsymbol{A}(\\boldsymbol{x}_k+\\alpha_k\\boldsymbol{p}_k),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "or" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "(\\boldsymbol{b}-\\boldsymbol{A}\\boldsymbol{x}_k)-\\alpha_k\\boldsymbol{A}\\boldsymbol{p}_k,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which gives" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{r}_{k+1}=\\boldsymbol{r}_k-\\boldsymbol{A}\\boldsymbol{p}_{k},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Revisiting our Linear Regression Solvers\n", - "\n", - "We will use linear regression as a case study for the gradient descent\n", - "methods. Linear regression is a great test case for the gradient\n", - "descent methods discussed in the lectures since it has several\n", - "desirable properties such as:\n", - "\n", - "1. An analytical solution.\n", - "\n", - "2. The gradient can be computed analytically.\n", - "\n", - "3. The cost function is convex which guarantees that gradient descent converges for small enough learning rates\n", - "\n", - "We revisit an example similar to what we had in the first homework set. We had a function of the type" - ] - }, - { - "cell_type": "code", - "execution_count": 6, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "m = 100\n", - "x = 2*np.random.rand(m,1)\n", - "y = 4+3*x+np.random.randn(m,1)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with $x_i \\in [0,1] $ is chosen randomly using a uniform distribution. Additionally we have a stochastic noise chosen according to a normal distribution $\\cal {N}(0,1)$. \n", - "The linear regression model is given by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "h_\\beta(x) = \\boldsymbol{y} = \\beta_0 + \\beta_1 x,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "such that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{y}_i = \\beta_0 + \\beta_1 x_i.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Let $\\mathbf{y} = (y_1,\\cdots,y_n)^T$, $\\mathbf{\\boldsymbol{y}} = (\\boldsymbol{y}_1,\\cdots,\\boldsymbol{y}_n)^T$ and $\\beta = (\\beta_0, \\beta_1)^T$\n", - "\n", - "It is convenient to write $\\mathbf{\\boldsymbol{y}} = X\\beta$ where $X \\in \\mathbb{R}^{100 \\times 2} $ is the design matrix given by (we keep the intercept here)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "X \\equiv \\begin{bmatrix}\n", - "1 & x_1 \\\\\n", - "\\vdots & \\vdots \\\\\n", - "1 & x_{100} & \\\\\n", - "\\end{bmatrix}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The cost/loss/risk function is given by (" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(\\beta) = \\frac{1}{n}||X\\beta-\\mathbf{y}||_{2}^{2} = \\frac{1}{n}\\sum_{i=1}^{100}\\left[ (\\beta_0 + \\beta_1 x_i)^2 - 2 y_i (\\beta_0 + \\beta_1 x_i) + y_i^2\\right]\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and we want to find $\\beta$ such that $C(\\beta)$ is minimized.\n", - "\n", - "\n", - "Computing $\\partial C(\\beta) / \\partial \\beta_0$ and $\\partial C(\\beta) / \\partial \\beta_1$ we can show that the gradient can be written as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\nabla_{\\beta} C(\\beta) = \\frac{2}{n}\\begin{bmatrix} \\sum_{i=1}^{100} \\left(\\beta_0+\\beta_1x_i-y_i\\right) \\\\\n", - "\\sum_{i=1}^{100}\\left( x_i (\\beta_0+\\beta_1x_i)-y_ix_i\\right) \\\\\n", - "\\end{bmatrix} = \\frac{2}{n}X^T(X\\beta - \\mathbf{y}),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $X$ is the design matrix defined above.\n", - "\n", - "\n", - "The Hessian matrix of $C(\\beta)$ is given by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{H} \\equiv \\begin{bmatrix}\n", - "\\frac{\\partial^2 C(\\beta)}{\\partial \\beta_0^2} & \\frac{\\partial^2 C(\\beta)}{\\partial \\beta_0 \\partial \\beta_1} \\\\\n", - "\\frac{\\partial^2 C(\\beta)}{\\partial \\beta_0 \\partial \\beta_1} & \\frac{\\partial^2 C(\\beta)}{\\partial \\beta_1^2} & \\\\\n", - "\\end{bmatrix} = \\frac{2}{n}X^T X.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "This result implies that $C(\\beta)$ is a convex function since the matrix $X^T X$ always is positive semi-definite.\n", - "\n", - "\n", - "\n", - "We can now write a program that minimizes $C(\\beta)$ using the gradient descent method with a constant learning rate $\\gamma$ according to" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\beta_{k+1} = \\beta_k - \\gamma \\nabla_\\beta C(\\beta_k), \\ k=0,1,\\cdots\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We can use the expression we computed for the gradient and let use a\n", - "$\\beta_0$ be chosen randomly and let $\\gamma = 0.001$. Stop iterating\n", - "when $||\\nabla_\\beta C(\\beta_k) || \\leq \\epsilon = 10^{-8}$. **Note that the code below does not include the latter stop criterion**.\n", - "\n", - "And finally we can compare our solution for $\\beta$ with the analytic result given by \n", - "$\\beta= (X^TX)^{-1} X^T \\mathbf{y}$.\n", - "\n", - "\n", - "\n", - "Here is our simple example" - ] - }, - { - "cell_type": "code", - "execution_count": 7, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "[0.30862336 4.94226154]\n", - "[[4.09553421]\n", - " [2.99517651]]\n", - "[[4.09553421]\n", - " [2.99517651]]\n" - ] - }, - { - "data": { - "image/png": "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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapteroptimization_118_1.png" - }, - "needs_background": "light" - }, - "output_type": "display_data" - } - ], - "source": [ - "\n", - "# Importing various packages\n", - "from random import random, seed\n", - "import numpy as np\n", - "import matplotlib.pyplot as plt\n", - "from mpl_toolkits.mplot3d import Axes3D\n", - "from matplotlib import cm\n", - "from matplotlib.ticker import LinearLocator, FormatStrFormatter\n", - "import sys\n", - "\n", - "# the number of datapoints\n", - "n = 100\n", - "x = 2*np.random.rand(n,1)\n", - "y = 4+3*x+np.random.randn(n,1)\n", - "\n", - "X = np.c_[np.ones((n,1)), x]\n", - "# Hessian matrix\n", - "H = (2.0/n)* X.T @ X\n", - "# Get the eigenvalues\n", - "EigValues, EigVectors = np.linalg.eig(H)\n", - "print(EigValues)\n", - "\n", - "beta_linreg = np.linalg.inv(X.T @ X) @ X.T @ y\n", - "print(beta_linreg)\n", - "beta = np.random.randn(2,1)\n", - "\n", - "eta = 1.0/np.max(EigValues)\n", - "Niterations = 1000\n", - "\n", - "for iter in range(Niterations):\n", - " gradient = (2.0/n)*X.T @ (X @ beta-y)\n", - " beta -= eta*gradient\n", - "\n", - "print(beta)\n", - "xnew = np.array([[0],[2]])\n", - "xbnew = np.c_[np.ones((2,1)), xnew]\n", - "ypredict = xbnew.dot(beta)\n", - "ypredict2 = xbnew.dot(beta_linreg)\n", - "plt.plot(xnew, ypredict, \"r-\")\n", - "plt.plot(xnew, ypredict2, \"b-\")\n", - "plt.plot(x, y ,'ro')\n", - "plt.axis([0,2.0,0, 15.0])\n", - "plt.xlabel(r'$x$')\n", - "plt.ylabel(r'$y$')\n", - "plt.title(r'Gradient descent example')\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Alternatively, we can use **Scikit-Learn** as done here" - ] - }, - { - "cell_type": "code", - "execution_count": 8, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "[[4.1224808 ]\n", - " [2.97290346]]\n", - "[4.09600813] [2.93854356]\n" - ] - } - ], - "source": [ - "# Importing various packages\n", - "from random import random, seed\n", - "import numpy as np\n", - "import matplotlib.pyplot as plt\n", - "from sklearn.linear_model import SGDRegressor\n", - "\n", - "n = 100\n", - "x = 2*np.random.rand(n,1)\n", - "y = 4+3*x+np.random.randn(n,1)\n", - "\n", - "X = np.c_[np.ones((n,1)), x]\n", - "beta_linreg = np.linalg.inv(X.T @ X) @ (X.T @ y)\n", - "print(beta_linreg)\n", - "sgdreg = SGDRegressor(max_iter = 50, penalty=None, eta0=0.1)\n", - "sgdreg.fit(x,y.ravel())\n", - "print(sgdreg.intercept_, sgdreg.coef_)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We have also discussed Ridge regression where the loss function contains a regularized term given by the $L_2$ norm of $\\beta$," - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C_{\\text{ridge}}(\\beta) = \\frac{1}{n}||X\\beta -\\mathbf{y}||^2 + \\lambda ||\\beta||^2, \\ \\lambda \\geq 0.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In order to minimize $C_{\\text{ridge}}(\\beta)$ using GD we only have adjust the gradient as follows" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\nabla_\\beta C_{\\text{ridge}}(\\beta) = \\frac{2}{n}\\begin{bmatrix} \\sum_{i=1}^{100} \\left(\\beta_0+\\beta_1x_i-y_i\\right) \\\\\n", - "\\sum_{i=1}^{100}\\left( x_i (\\beta_0+\\beta_1x_i)-y_ix_i\\right) \\\\\n", - "\\end{bmatrix} + 2\\lambda\\begin{bmatrix} \\beta_0 \\\\ \\beta_1\\end{bmatrix} = 2 (X^T(X\\beta - \\mathbf{y})+\\lambda \\beta).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We can easily extend our program to minimize $C_{\\text{ridge}}(\\beta)$ using gradient descent and compare with the analytical solution given by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\beta_{\\text{ridge}} = \\left(X^T X + \\lambda I_{2 \\times 2} \\right)^{-1} X^T \\mathbf{y}.\n", - "$$" - ] - }, - { - "cell_type": "code", - "execution_count": 9, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "[[3.95338481]\n", - " [2.95611545]]\n", - "[[3.99545147]\n", - " [2.91812296]]\n" - ] - }, - { - "data": { - "image/png": "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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapteroptimization_127_1.png" - }, - "needs_background": "light" - }, - "output_type": "display_data" - } - ], - "source": [ - "from random import random, seed\n", - "import numpy as np\n", - "import matplotlib.pyplot as plt\n", - "from mpl_toolkits.mplot3d import Axes3D\n", - "from matplotlib import cm\n", - "from matplotlib.ticker import LinearLocator, FormatStrFormatter\n", - "import sys\n", - "\n", - "# the number of datapoints\n", - "n = 100\n", - "x = 2*np.random.rand(n,1)\n", - "y = 4+3*x+np.random.randn(n,1)\n", - "\n", - "X = np.c_[np.ones((n,1)), x]\n", - "XT_X = X.T @ X\n", - "\n", - "#Ridge parameter lambda\n", - "lmbda = 0.001\n", - "Id = lmbda* np.eye(XT_X.shape[0])\n", - "\n", - "beta_linreg = np.linalg.inv(XT_X+Id) @ X.T @ y\n", - "print(beta_linreg)\n", - "# Start plain gradient descent\n", - "beta = np.random.randn(2,1)\n", - "\n", - "eta = 0.1\n", - "Niterations = 100\n", - "\n", - "for iter in range(Niterations):\n", - " gradients = 2.0/n*X.T @ (X @ (beta)-y)+2*lmbda*beta\n", - " beta -= eta*gradients\n", - "\n", - "print(beta)\n", - "ypredict = X @ beta\n", - "ypredict2 = X @ beta_linreg\n", - "plt.plot(x, ypredict, \"r-\")\n", - "plt.plot(x, ypredict2, \"b-\")\n", - "plt.plot(x, y ,'ro')\n", - "plt.axis([0,2.0,0, 15.0])\n", - "plt.xlabel(r'$x$')\n", - "plt.ylabel(r'$y$')\n", - "plt.title(r'Gradient descent example for Ridge')\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Using gradient descent methods, limitations\n", - "\n", - "* **Gradient descent (GD) finds local minima of our function**. Since the GD algorithm is deterministic, if it converges, it will converge to a local minimum of our cost/loss/risk function. Because in ML we are often dealing with extremely rugged landscapes with many local minima, this can lead to poor performance.\n", - "\n", - "* **GD is sensitive to initial conditions**. One consequence of the local nature of GD is that initial conditions matter. Depending on where one starts, one will end up at a different local minima. Therefore, it is very important to think about how one initializes the training process. This is true for GD as well as more complicated variants of GD.\n", - "\n", - "* **Gradients are computationally expensive to calculate for large datasets**. In many cases in statistics and ML, the cost/loss/risk function is a sum of terms, with one term for each data point. For example, in linear regression, $E \\propto \\sum_{i=1}^n (y_i - \\mathbf{w}^T\\cdot\\mathbf{x}_i)^2$; for logistic regression, the square error is replaced by the cross entropy. To calculate the gradient we have to sum over *all* $n$ data points. Doing this at every GD step becomes extremely computationally expensive. An ingenious solution to this, is to calculate the gradients using small subsets of the data called \"mini batches\". This has the added benefit of introducing stochasticity into our algorithm.\n", - "\n", - "* **GD is very sensitive to choices of learning rates**. GD is extremely sensitive to the choice of learning rates. If the learning rate is very small, the training process take an extremely long time. For larger learning rates, GD can diverge and give poor results. Furthermore, depending on what the local landscape looks like, we have to modify the learning rates to ensure convergence. Ideally, we would *adaptively* choose the learning rates to match the landscape.\n", - "\n", - "* **GD treats all directions in parameter space uniformly.** Another major drawback of GD is that unlike Newton's method, the learning rate for GD is the same in all directions in parameter space. For this reason, the maximum learning rate is set by the behavior of the steepest direction and this can significantly slow down training. Ideally, we would like to take large steps in flat directions and small steps in steep directions. Since we are exploring rugged landscapes where curvatures change, this requires us to keep track of not only the gradient but second derivatives. The ideal scenario would be to calculate the Hessian but this proves to be too computationally expensive. \n", - "\n", - "* GD can take exponential time to escape saddle points, even with random initialization. As we mentioned, GD is extremely sensitive to initial condition since it determines the particular local minimum GD would eventually reach. However, even with a good initialization scheme, through the introduction of randomness, GD can still take exponential time to escape saddle points.\n", - "\n", - "## Stochastic Gradient Descent\n", - "\n", - "Stochastic gradient descent (SGD) and variants thereof address some of\n", - "the shortcomings of the Gradient descent method discussed above.\n", - "\n", - "The underlying idea of SGD comes from the observation that the cost\n", - "function, which we want to minimize, can almost always be written as a\n", - "sum over $n$ data points $\\{\\mathbf{x}_i\\}_{i=1}^n$," - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(\\mathbf{\\beta}) = \\sum_{i=1}^n c_i(\\mathbf{x}_i,\n", - "\\mathbf{\\beta}).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "This in turn means that the gradient can be\n", - "computed as a sum over $i$-gradients" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\nabla_\\beta C(\\mathbf{\\beta}) = \\sum_i^n \\nabla_\\beta c_i(\\mathbf{x}_i,\n", - "\\mathbf{\\beta}).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Stochasticity/randomness is introduced by only taking the\n", - "gradient on a subset of the data called minibatches. If there are $n$\n", - "data points and the size of each minibatch is $M$, there will be $n/M$\n", - "minibatches. We denote these minibatches by $B_k$ where\n", - "$k=1,\\cdots,n/M$.\n", - "\n", - "\n", - "\n", - "As an example, suppose we have $10$ data points $(\\mathbf{x}_1,\\cdots, \\mathbf{x}_{10})$ \n", - "and we choose to have $M=5$ minibathces,\n", - "then each minibatch contains two data points. In particular we have\n", - "$B_1 = (\\mathbf{x}_1,\\mathbf{x}_2), \\cdots, B_5 =\n", - "(\\mathbf{x}_9,\\mathbf{x}_{10})$. Note that if you choose $M=1$ you\n", - "have only a single batch with all data points and on the other extreme,\n", - "you may choose $M=n$ resulting in a minibatch for each datapoint, i.e\n", - "$B_k = \\mathbf{x}_k$.\n", - "\n", - "The idea is now to approximate the gradient by replacing the sum over\n", - "all data points with a sum over the data points in one the minibatches\n", - "picked at random in each gradient descent step" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\nabla_{\\beta}\n", - "C(\\mathbf{\\beta}) = \\sum_{i=1}^n \\nabla_\\beta c_i(\\mathbf{x}_i,\n", - "\\mathbf{\\beta}) \\rightarrow \\sum_{i \\in B_k}^n \\nabla_\\beta\n", - "c_i(\\mathbf{x}_i, \\mathbf{\\beta}).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Thus a gradient descent step now looks like" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\beta_{j+1} = \\beta_j - \\gamma_j \\sum_{i \\in B_k}^n \\nabla_\\beta c_i(\\mathbf{x}_i,\n", - "\\mathbf{\\beta})\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $k$ is picked at random with equal\n", - "probability from $[1,n/M]$. An iteration over the number of\n", - "minibathces (n/M) is commonly referred to as an epoch. Thus it is\n", - "typical to choose a number of epochs and for each epoch iterate over\n", - "the number of minibatches, as exemplified in the code below." - ] - }, - { - "cell_type": "code", - "execution_count": 10, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import numpy as np \n", - "\n", - "n = 100 #100 datapoints \n", - "M = 5 #size of each minibatch\n", - "m = int(n/M) #number of minibatches\n", - "n_epochs = 10 #number of epochs\n", - "\n", - "j = 0\n", - "for epoch in range(1,n_epochs+1):\n", - " for i in range(m):\n", - " k = np.random.randint(m) #Pick the k-th minibatch at random\n", - " #Compute the gradient using the data in minibatch Bk\n", - " #Compute new suggestion for \n", - " j += 1" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Taking the gradient only on a subset of the data has two important\n", - "benefits. First, it introduces randomness which decreases the chance\n", - "that our opmization scheme gets stuck in a local minima. Second, if\n", - "the size of the minibatches are small relative to the number of\n", - "datapoints ($M < n$), the computation of the gradient is much\n", - "cheaper since we sum over the datapoints in the $k-th$ minibatch and not\n", - "all $n$ datapoints.\n", - "\n", - "\n", - "\n", - "A natural question is when do we stop the search for a new minimum?\n", - "One possibility is to compute the full gradient after a given number\n", - "of epochs and check if the norm of the gradient is smaller than some\n", - "threshold and stop if true. However, the condition that the gradient\n", - "is zero is valid also for local minima, so this would only tell us\n", - "that we are close to a local/global minimum. However, we could also\n", - "evaluate the cost function at this point, store the result and\n", - "continue the search. If the test kicks in at a later stage we can\n", - "compare the values of the cost function and keep the $\\beta$ that\n", - "gave the lowest value.\n", - "\n", - "\n", - "\n", - "Another approach is to let the step length $\\gamma_j$ depend on the\n", - "number of epochs in such a way that it becomes very small after a\n", - "reasonable time such that we do not move at all.\n", - "\n", - "As an example, let $e = 0,1,2,3,\\cdots$ denote the current epoch and let $t_0, t_1 > 0$ be two fixed numbers. Furthermore, let $t = e \\cdot m + i$ where $m$ is the number of minibatches and $i=0,\\cdots,m-1$. Then the function $$\\gamma_j(t; t_0, t_1) = \\frac{t_0}{t+t_1} $$ goes to zero as the number of epochs gets large. I.e. we start with a step length $\\gamma_j (0; t_0, t_1) = t_0/t_1$ which decays in *time* $t$.\n", - "\n", - "In this way we can fix the number of epochs, compute $\\beta$ and\n", - "evaluate the cost function at the end. Repeating the computation will\n", - "give a different result since the scheme is random by design. Then we\n", - "pick the final $\\beta$ that gives the lowest value of the cost\n", - "function." - ] - }, - { - "cell_type": "code", - "execution_count": 11, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "gamma_j after 500 epochs: 9.97108e-05\n" - ] - } - ], - "source": [ - "import numpy as np \n", - "\n", - "def step_length(t,t0,t1):\n", - " return t0/(t+t1)\n", - "\n", - "n = 100 #100 datapoints \n", - "M = 5 #size of each minibatch\n", - "m = int(n/M) #number of minibatches\n", - "n_epochs = 500 #number of epochs\n", - "t0 = 1.0\n", - "t1 = 10\n", - "\n", - "gamma_j = t0/t1\n", - "j = 0\n", - "for epoch in range(1,n_epochs+1):\n", - " for i in range(m):\n", - " k = np.random.randint(m) #Pick the k-th minibatch at random\n", - " #Compute the gradient using the data in minibatch Bk\n", - " #Compute new suggestion for beta\n", - " t = epoch*m+i\n", - " gamma_j = step_length(t,t0,t1)\n", - " j += 1\n", - "\n", - "print(\"gamma_j after %d epochs: %g\" % (n_epochs,gamma_j))" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "### Program for stochastic gradient" - ] - }, - { - "cell_type": "code", - "execution_count": 12, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Own inversion\n", - "[[3.87218485]\n", - " [3.01403105]]\n", - "sgdreg from scikit\n", - "[3.9030809] [3.07154525]\n", - "theta from own gd\n", - "[[3.87218485]\n", - " [3.01403105]]\n", - "theta from own sdg\n", - "[[3.86110774]\n", - " [3.00070278]]\n" - ] - }, - { - "data": { - "image/png": "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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapteroptimization_141_1.png" - }, - "needs_background": "light" - }, - "output_type": "display_data" - } - ], - "source": [ - "# Importing various packages\n", - "from math import exp, sqrt\n", - "from random import random, seed\n", - "import numpy as np\n", - "import matplotlib.pyplot as plt\n", - "from sklearn.linear_model import SGDRegressor\n", - "\n", - "m = 100\n", - "x = 2*np.random.rand(m,1)\n", - "y = 4+3*x+np.random.randn(m,1)\n", - "\n", - "X = np.c_[np.ones((m,1)), x]\n", - "theta_linreg = np.linalg.inv(X.T @ X) @ (X.T @ y)\n", - "print(\"Own inversion\")\n", - "print(theta_linreg)\n", - "sgdreg = SGDRegressor(max_iter = 50, penalty=None, eta0=0.1)\n", - "sgdreg.fit(x,y.ravel())\n", - "print(\"sgdreg from scikit\")\n", - "print(sgdreg.intercept_, sgdreg.coef_)\n", - "\n", - "\n", - "theta = np.random.randn(2,1)\n", - "eta = 0.1\n", - "Niterations = 1000\n", - "\n", - "\n", - "for iter in range(Niterations):\n", - " gradients = 2.0/m*X.T @ ((X @ theta)-y)\n", - " theta -= eta*gradients\n", - "print(\"theta from own gd\")\n", - "print(theta)\n", - "\n", - "xnew = np.array([[0],[2]])\n", - "Xnew = np.c_[np.ones((2,1)), xnew]\n", - "ypredict = Xnew.dot(theta)\n", - "ypredict2 = Xnew.dot(theta_linreg)\n", - "\n", - "\n", - "n_epochs = 50\n", - "t0, t1 = 5, 50\n", - "def learning_schedule(t):\n", - " return t0/(t+t1)\n", - "\n", - "theta = np.random.randn(2,1)\n", - "\n", - "for epoch in range(n_epochs):\n", - " for i in range(m):\n", - " random_index = np.random.randint(m)\n", - " xi = X[random_index:random_index+1]\n", - " yi = y[random_index:random_index+1]\n", - " gradients = 2 * xi.T @ ((xi @ theta)-yi)\n", - " eta = learning_schedule(epoch*m+i)\n", - " theta = theta - eta*gradients\n", - "print(\"theta from own sdg\")\n", - "print(theta)\n", - "\n", - "plt.plot(xnew, ypredict, \"r-\")\n", - "plt.plot(xnew, ypredict2, \"b-\")\n", - "plt.plot(x, y ,'ro')\n", - "plt.axis([0,2.0,0, 15.0])\n", - "plt.xlabel(r'$x$')\n", - "plt.ylabel(r'$y$')\n", - "plt.title(r'Random numbers ')\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Momentum based GD\n", - "\n", - "The stochastic gradient descent (SGD) is almost always used with a\n", - "*momentum* or inertia term that serves as a memory of the direction we\n", - "are moving in parameter space. This is typically implemented as\n", - "follows" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbf{v}_{t}=\\gamma \\mathbf{v}_{t-1}+\\eta_{t}\\nabla_\\theta E(\\boldsymbol{\\theta}_t) \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation} \n", - "\\boldsymbol{\\theta}_{t+1}= \\boldsymbol{\\theta}_t -\\mathbf{v}_{t},\n", - "\\label{_auto1} \\tag{2}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where we have introduced a momentum parameter $\\gamma$, with\n", - "$0\\le\\gamma\\le 1$, and for brevity we dropped the explicit notation to\n", - "indicate the gradient is to be taken over a different mini-batch at\n", - "each step. We call this algorithm gradient descent with momentum\n", - "(GDM). From these equations, it is clear that $\\mathbf{v}_t$ is a\n", - "running average of recently encountered gradients and\n", - "$(1-\\gamma)^{-1}$ sets the characteristic time scale for the memory\n", - "used in the averaging procedure. Consistent with this, when\n", - "$\\gamma=0$, this just reduces down to ordinary SGD as discussed\n", - "earlier. An equivalent way of writing the updates is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\Delta \\boldsymbol{\\theta}_{t+1} = \\gamma \\Delta \\boldsymbol{\\theta}_t -\\ \\eta_{t}\\nabla_\\theta E(\\boldsymbol{\\theta}_t),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where we have defined $\\Delta \\boldsymbol{\\theta}_{t}= \\boldsymbol{\\theta}_t-\\boldsymbol{\\theta}_{t-1}$.\n", - "\n", - "\n", - "\n", - "Let us try to get more intuition from these equations. It is helpful\n", - "to consider a simple physical analogy with a particle of mass $m$\n", - "moving in a viscous medium with drag coefficient $\\mu$ and potential\n", - "$E(\\mathbf{w})$. If we denote the particle's position by $\\mathbf{w}$,\n", - "then its motion is described by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "m {d^2 \\mathbf{w} \\over dt^2} + \\mu {d \\mathbf{w} \\over dt }= -\\nabla_w E(\\mathbf{w}).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We can discretize this equation in the usual way to get" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "m { \\mathbf{w}_{t+\\Delta t}-2 \\mathbf{w}_{t} +\\mathbf{w}_{t-\\Delta t} \\over (\\Delta t)^2}+\\mu {\\mathbf{w}_{t+\\Delta t}- \\mathbf{w}_{t} \\over \\Delta t} = -\\nabla_w E(\\mathbf{w}).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Rearranging this equation, we can rewrite this as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\Delta \\mathbf{w}_{t +\\Delta t}= - { (\\Delta t)^2 \\over m +\\mu \\Delta t} \\nabla_w E(\\mathbf{w})+ {m \\over m +\\mu \\Delta t} \\Delta \\mathbf{w}_t.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Notice that this equation is identical to previous one if we identify\n", - "the position of the particle, $\\mathbf{w}$, with the parameters\n", - "$\\boldsymbol{\\theta}$. This allows us to identify the momentum\n", - "parameter and learning rate with the mass of the particle and the\n", - "viscous drag as:" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\gamma= {m \\over m +\\mu \\Delta t }, \\qquad \\eta = {(\\Delta t)^2 \\over m +\\mu \\Delta t}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Thus, as the name suggests, the momentum parameter is proportional to\n", - "the mass of the particle and effectively provides inertia.\n", - "Furthermore, in the large viscosity/small learning rate limit, our\n", - "memory time scales as $(1-\\gamma)^{-1} \\approx m/(\\mu \\Delta t)$.\n", - "\n", - "Why is momentum useful? SGD momentum helps the gradient descent\n", - "algorithm gain speed in directions with persistent but small gradients\n", - "even in the presence of stochasticity, while suppressing oscillations\n", - "in high-curvature directions. This becomes especially important in\n", - "situations where the landscape is shallow and flat in some directions\n", - "and narrow and steep in others. It has been argued that first-order\n", - "methods (with appropriate initial conditions) can perform comparable\n", - "to more expensive second order methods, especially in the context of\n", - "complex deep learning models.\n", - "\n", - "These beneficial properties of momentum can sometimes become even more\n", - "pronounced by using a slight modification of the classical momentum\n", - "algorithm called Nesterov Accelerated Gradient (NAG).\n", - "\n", - "In the NAG algorithm, rather than calculating the gradient at the\n", - "current parameters, $\\nabla_\\theta E(\\boldsymbol{\\theta}_t)$, one\n", - "calculates the gradient at the expected value of the parameters given\n", - "our current momentum, $\\nabla_\\theta E(\\boldsymbol{\\theta}_t +\\gamma\n", - "\\mathbf{v}_{t-1})$. This yields the NAG update rule" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbf{v}_{t}=\\gamma \\mathbf{v}_{t-1}+\\eta_{t}\\nabla_\\theta E(\\boldsymbol{\\theta}_t +\\gamma \\mathbf{v}_{t-1}) \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation} \n", - "\\boldsymbol{\\theta}_{t+1}= \\boldsymbol{\\theta}_t -\\mathbf{v}_{t}.\n", - "\\label{_auto2} \\tag{3}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "One of the major advantages of NAG is that it allows for the use of a larger learning rate than GDM for the same choice of $\\gamma$.\n", - "\n", - "\n", - "\n", - "In stochastic gradient descent, with and without momentum, we still\n", - "have to specify a schedule for tuning the learning rates $\\eta_t$\n", - "as a function of time. As discussed in the context of Newton's\n", - "method, this presents a number of dilemmas. The learning rate is\n", - "limited by the steepest direction which can change depending on the\n", - "current position in the landscape. To circumvent this problem, ideally\n", - "our algorithm would keep track of curvature and take large steps in\n", - "shallow, flat directions and small steps in steep, narrow directions.\n", - "Second-order methods accomplish this by calculating or approximating\n", - "the Hessian and normalizing the learning rate by the\n", - "curvature. However, this is very computationally expensive for\n", - "extremely large models. Ideally, we would like to be able to\n", - "adaptively change the step size to match the landscape without paying\n", - "the steep computational price of calculating or approximating\n", - "Hessians.\n", - "\n", - "Recently, a number of methods have been introduced that accomplish\n", - "this by tracking not only the gradient, but also the second moment of\n", - "the gradient. These methods include AdaGrad, AdaDelta, RMS-Prop, and\n", - "ADAM.\n", - "\n", - "\n", - "### RMS prop\n", - "\n", - "In RMS prop, in addition to keeping a running average of the first\n", - "moment of the gradient, we also keep track of the second moment\n", - "denoted by $\\mathbf{s}_t=\\mathbb{E}[\\mathbf{g}_t^2]$. The update rule\n", - "for RMS prop is given by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - "\\mathbf{g}_t = \\nabla_\\theta E(\\boldsymbol{\\theta}) \n", - "\\label{_auto3} \\tag{4}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbf{s}_t =\\beta \\mathbf{s}_{t-1} +(1-\\beta)\\mathbf{g}_t^2 \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{\\theta}_{t+1}=\\boldsymbol{\\theta}_t - \\eta_t { \\mathbf{g}_t \\over \\sqrt{\\mathbf{s}_t +\\epsilon}}, \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $\\beta$ controls the averaging time of the second moment and is\n", - "typically taken to be about $\\beta=0.9$, $\\eta_t$ is a learning rate\n", - "typically chosen to be $10^{-3}$, and $\\epsilon\\sim 10^{-8} $ is a\n", - "small regularization constant to prevent divergences. Multiplication\n", - "and division by vectors is understood as an element-wise operation. It\n", - "is clear from this formula that the learning rate is reduced in\n", - "directions where the norm of the gradient is consistently large. This\n", - "greatly speeds up the convergence by allowing us to use a larger\n", - "learning rate for flat directions.\n", - "\n", - "### ADAM optimizer\n", - "\n", - "A related algorithm is the ADAM optimizer. In ADAM, we keep a running\n", - "average of both the first and second moment of the gradient and use\n", - "this information to adaptively change the learning rate for different\n", - "parameters. In addition to keeping a running average of the first and\n", - "second moments of the gradient\n", - "(i.e. $\\mathbf{m}_t=\\mathbb{E}[\\mathbf{g}_t]$ and\n", - "$\\mathbf{s}_t=\\mathbb{E}[\\mathbf{g}^2_t]$, respectively), ADAM\n", - "performs an additional bias correction to account for the fact that we\n", - "are estimating the first two moments of the gradient using a running\n", - "average (denoted by the hats in the update rule below). The update\n", - "rule for ADAM is given by (where multiplication and division are once\n", - "again understood to be element-wise operations below)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - "\\mathbf{g}_t = \\nabla_\\theta E(\\boldsymbol{\\theta}) \n", - "\\label{_auto4} \\tag{5}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbf{m}_t = \\beta_1 \\mathbf{m}_{t-1} + (1-\\beta_1) \\mathbf{g}_t \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbf{s}_t =\\beta_2 \\mathbf{s}_{t-1} +(1-\\beta_2)\\mathbf{g}_t^2 \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{\\mathbf{m}}_t={\\mathbf{m}_t \\over 1-\\beta_1^t} \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{\\mathbf{s}}_t ={\\mathbf{s}_t \\over1-\\beta_2^t} \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{\\theta}_{t+1}=\\boldsymbol{\\theta}_t - \\eta_t { \\boldsymbol{\\mathbf{m}}_t \\over \\sqrt{\\boldsymbol{\\mathbf{s}}_t} +\\epsilon}, \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation} \n", - "\\label{_auto5} \\tag{6}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $\\beta_1$ and $\\beta_2$ set the memory lifetime of the first and\n", - "second moment and are typically taken to be $0.9$ and $0.99$\n", - "respectively, and $\\eta$ and $\\epsilon$ are identical to RMSprop.\n", - "\n", - "Like in RMSprop, the effective step size of a parameter depends on the\n", - "magnitude of its gradient squared. To understand this better, let us\n", - "rewrite this expression in terms of the variance\n", - "$\\boldsymbol{\\sigma}_t^2 = \\boldsymbol{\\mathbf{s}}_t -\n", - "(\\boldsymbol{\\mathbf{m}}_t)^2$. Consider a single parameter $\\theta_t$. The\n", - "update rule for this parameter is given by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\Delta \\theta_{t+1}= -\\eta_t { \\boldsymbol{m}_t \\over \\sqrt{\\sigma_t^2 + m_t^2 }+\\epsilon}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Practical tips\n", - "\n", - "* **Randomize the data when making mini-batches**. It is always important to randomly shuffle the data when forming mini-batches. Otherwise, the gradient descent method can fit spurious correlations resulting from the order in which data is presented.\n", - "\n", - "* **Transform your inputs**. Learning becomes difficult when our landscape has a mixture of steep and flat directions. One simple trick for minimizing these situations is to standardize the data by subtracting the mean and normalizing the variance of input variables. Whenever possible, also decorrelate the inputs. To understand why this is helpful, consider the case of linear regression. It is easy to show that for the squared error cost function, the Hessian of the cost function is just the correlation matrix between the inputs. Thus, by standardizing the inputs, we are ensuring that the landscape looks homogeneous in all directions in parameter space. Since most deep networks can be viewed as linear transformations followed by a non-linearity at each layer, we expect this intuition to hold beyond the linear case.\n", - "\n", - "* **Monitor the out-of-sample performance.** Always monitor the performance of your model on a validation set (a small portion of the training data that is held out of the training process to serve as a proxy for the test set. If the validation error starts increasing, then the model is beginning to overfit. Terminate the learning process. This *early stopping* significantly improves performance in many settings.\n", - "\n", - "* **Adaptive optimization methods don't always have good generalization.** Recent studies have shown that adaptive methods such as ADAM, RMSPorp, and AdaGrad tend to have poor generalization compared to SGD or SGD with momentum, particularly in the high-dimensional limit (i.e. the number of parameters exceeds the number of data points). Although it is not clear at this stage why these methods perform so well in training deep neural networks, simpler procedures like properly-tuned SGD may work as well or better in these applications.\n", - "\n", - "## Automatic differentiation\n", - "\n", - "[Automatic differentiation (AD)](https://en.wikipedia.org/wiki/Automatic_differentiation), \n", - "also called algorithmic\n", - "differentiation or computational differentiation,is a set of\n", - "techniques to numerically evaluate the derivative of a function\n", - "specified by a computer program. AD exploits the fact that every\n", - "computer program, no matter how complicated, executes a sequence of\n", - "elementary arithmetic operations (addition, subtraction,\n", - "multiplication, division, etc.) and elementary functions (exp, log,\n", - "sin, cos, etc.). By applying the chain rule repeatedly to these\n", - "operations, derivatives of arbitrary order can be computed\n", - "automatically, accurately to working precision, and using at most a\n", - "small constant factor more arithmetic operations than the original\n", - "program.\n", - "\n", - "Automatic differentiation is neither:\n", - "\n", - "* Symbolic differentiation, nor\n", - "\n", - "* Numerical differentiation (the method of finite differences).\n", - "\n", - "Symbolic differentiation can lead to inefficient code and faces the\n", - "difficulty of converting a computer program into a single expression,\n", - "while numerical differentiation can introduce round-off errors in the\n", - "discretization process and cancellation\n", - "\n", - "\n", - "\n", - "Python has tools for so-called **automatic differentiation**.\n", - "Consider the following example" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "f(x) = \\sin\\left(2\\pi x + x^2\\right)\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which has the following derivative" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "f'(x) = \\cos\\left(2\\pi x + x^2\\right)\\left(2\\pi + 2x\\right)\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Using **autograd** we have" - ] - }, - { - "cell_type": "code", - "execution_count": 13, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "data": { - "image/png": "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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/chapteroptimization_177_0.png" - }, - "needs_background": "light" - }, - "output_type": "display_data" - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "The max absolute difference is: 1.77636e-15\n" - ] - } - ], - "source": [ - "import autograd.numpy as np\n", - "\n", - "# To do elementwise differentiation:\n", - "from autograd import elementwise_grad as egrad \n", - "\n", - "# To plot:\n", - "import matplotlib.pyplot as plt \n", - "\n", - "\n", - "def f(x):\n", - " return np.sin(2*np.pi*x + x**2)\n", - "\n", - "def f_grad_analytic(x):\n", - " return np.cos(2*np.pi*x + x**2)*(2*np.pi + 2*x)\n", - "\n", - "# Do the comparison:\n", - "x = np.linspace(0,1,1000)\n", - "\n", - "f_grad = egrad(f)\n", - "\n", - "computed = f_grad(x)\n", - "analytic = f_grad_analytic(x)\n", - "\n", - "plt.title('Derivative computed from Autograd compared with the analytical derivative')\n", - "plt.plot(x,computed,label='autograd')\n", - "plt.plot(x,analytic,label='analytic')\n", - "\n", - "plt.xlabel('x')\n", - "plt.ylabel('y')\n", - "plt.legend()\n", - "\n", - "plt.show()\n", - "\n", - "print(\"The max absolute difference is: %g\"%(np.max(np.abs(computed - analytic))))" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Here we\n", - "experiment with what kind of functions Autograd is capable\n", - "of finding the gradient of. The following Python functions are just\n", - "meant to illustrate what Autograd can do, but please feel free to\n", - "experiment with other, possibly more complicated, functions as well." - ] - }, - { - "cell_type": "code", - "execution_count": 14, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "The gradient of f1 evaluated at a = 1 using autograd is: 3\n", - "The gradient of f1 evaluated at a = 1 by finding the analytic expression is: 3\n" - ] - } - ], - "source": [ - "import autograd.numpy as np\n", - "from autograd import grad\n", - "\n", - "def f1(x):\n", - " return x**3 + 1\n", - "\n", - "f1_grad = grad(f1)\n", - "\n", - "# Remember to send in float as argument to the computed gradient from Autograd!\n", - "a = 1.0\n", - "\n", - "# See the evaluated gradient at a using autograd:\n", - "print(\"The gradient of f1 evaluated at a = %g using autograd is: %g\"%(a,f1_grad(a)))\n", - "\n", - "# Compare with the analytical derivative, that is f1'(x) = 3*x**2 \n", - "grad_analytical = 3*a**2\n", - "print(\"The gradient of f1 evaluated at a = %g by finding the analytic expression is: %g\"%(a,grad_analytical))" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "To differentiate with respect to two (or more) arguments of a Python\n", - "function, Autograd need to know at which variable the function if\n", - "being differentiated with respect to." - ] - }, - { - "cell_type": "code", - "execution_count": 15, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Evaluating at x1 = 1, x2 = 3\n", - "------------------------------\n", - "The derivative of f2 w.r.t x1: 12\n", - "The analytical derivative of f2 w.r.t x1: 12\n", - "\n", - "The derivative of f2 w.r.t x2: -4\n", - "The analytical derivative of f2 w.r.t x2: -4\n" - ] - } - ], - "source": [ - "import autograd.numpy as np\n", - "from autograd import grad\n", - "def f2(x1,x2):\n", - " return 3*x1**3 + x2*(x1 - 5) + 1\n", - "\n", - "# By sending the argument 0, Autograd will compute the derivative w.r.t the first variable, in this case x1\n", - "f2_grad_x1 = grad(f2,0)\n", - "\n", - "# ... and differentiate w.r.t x2 by sending 1 as an additional arugment to grad\n", - "f2_grad_x2 = grad(f2,1)\n", - "\n", - "x1 = 1.0\n", - "x2 = 3.0 \n", - "\n", - "print(\"Evaluating at x1 = %g, x2 = %g\"%(x1,x2))\n", - "print(\"-\"*30)\n", - "\n", - "# Compare with the analytical derivatives:\n", - "\n", - "# Derivative of f2 w.r.t x1 is: 9*x1**2 + x2:\n", - "f2_grad_x1_analytical = 9*x1**2 + x2\n", - "\n", - "# Derivative of f2 w.r.t x2 is: x1 - 5:\n", - "f2_grad_x2_analytical = x1 - 5\n", - "\n", - "# See the evaluated derivations:\n", - "print(\"The derivative of f2 w.r.t x1: %g\"%( f2_grad_x1(x1,x2) ))\n", - "print(\"The analytical derivative of f2 w.r.t x1: %g\"%( f2_grad_x1(x1,x2) ))\n", - "\n", - "print()\n", - "\n", - "print(\"The derivative of f2 w.r.t x2: %g\"%( f2_grad_x2(x1,x2) ))\n", - "print(\"The analytical derivative of f2 w.r.t x2: %g\"%( f2_grad_x2(x1,x2) ))" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Note that the grad function will not produce the true gradient of the function. The true gradient of a function with two or more variables will produce a vector, where each element is the function differentiated w.r.t a variable." - ] - }, - { - "cell_type": "code", - "execution_count": 16, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "The computed gradient of f3 is: [ 2. 3. 5. 7. 88.]\n", - "The analytical gradient of f3 is: [ 2. 3. 5. 7. 88.]\n" - ] - } - ], - "source": [ - "import autograd.numpy as np\n", - "from autograd import grad\n", - "def f3(x): # Assumes x is an array of length 5 or higher\n", - " return 2*x[0] + 3*x[1] + 5*x[2] + 7*x[3] + 11*x[4]**2\n", - "\n", - "f3_grad = grad(f3)\n", - "\n", - "x = np.linspace(0,4,5)\n", - "\n", - "# Print the computed gradient:\n", - "print(\"The computed gradient of f3 is: \", f3_grad(x))\n", - "\n", - "# The analytical gradient is: (2, 3, 5, 7, 22*x[4])\n", - "f3_grad_analytical = np.array([2, 3, 5, 7, 22*x[4]])\n", - "\n", - "# Print the analytical gradient:\n", - "print(\"The analytical gradient of f3 is: \", f3_grad_analytical)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Note that in this case, when sending an array as input argument, the\n", - "output from Autograd is another array. This is the true gradient of\n", - "the function, as opposed to the function in the previous example. By\n", - "using arrays to represent the variables, the output from Autograd\n", - "might be easier to work with, as the output is closer to what one\n", - "could expect form a gradient-evaluting function." - ] - }, - { - "cell_type": "code", - "execution_count": 17, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "The computed derivative of f4 at x = 2.7 is: 13.8759\n", - "The analytical gradient of f4 at x = 2.7 is: 13.8759\n" - ] - } - ], - "source": [ - "import autograd.numpy as np\n", - "from autograd import grad\n", - "def f4(x):\n", - " return np.sqrt(1+x**2) + np.exp(x) + np.sin(2*np.pi*x)\n", - "\n", - "f4_grad = grad(f4)\n", - "\n", - "x = 2.7\n", - "\n", - "# Print the computed derivative:\n", - "print(\"The computed derivative of f4 at x = %g is: %g\"%(x,f4_grad(x)))\n", - "\n", - "# The analytical derivative is: x/sqrt(1 + x**2) + exp(x) + cos(2*pi*x)*2*pi\n", - "f4_grad_analytical = x/np.sqrt(1 + x**2) + np.exp(x) + np.cos(2*np.pi*x)*2*np.pi\n", - "\n", - "# Print the analytical gradient:\n", - "print(\"The analytical gradient of f4 at x = %g is: %g\"%(x,f4_grad_analytical))" - ] - }, - { - "cell_type": "code", - "execution_count": 18, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "The computed derivative of f5 at x = 2.7 is: 5.4\n" - ] - } - ], - "source": [ - "import autograd.numpy as np\n", - "from autograd import grad\n", - "def f5(x):\n", - " if x >= 0:\n", - " return x**2\n", - " else:\n", - " return -3*x + 1\n", - "\n", - "f5_grad = grad(f5)\n", - "\n", - "x = 2.7\n", - "\n", - "# Print the computed derivative:\n", - "print(\"The computed derivative of f5 at x = %g is: %g\"%(x,f5_grad(x)))" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "1\n", - "8\n", - " \n", - "<\n", - "<\n", - "<\n", - "!\n", - "!\n", - "C\n", - "O\n", - "D\n", - "E\n", - "_\n", - "B\n", - "L\n", - "O\n", - "C\n", - "K\n", - " \n", - " \n", - "p\n", - "y\n", - "c\n", - "o\n", - "d" - ] - }, - { - "cell_type": "code", - "execution_count": 19, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "The analytical derivative of f6 at x = 2.7 is: 37732.5\n" - ] - } - ], - "source": [ - "import autograd.numpy as np\n", - "from autograd import grad\n", - "# Both of the functions are implementation of the sum: sum(x**i) for i = 0, ..., 9\n", - "# The analytical derivative is: sum(i*x**(i-1)) \n", - "f6_grad_analytical = 0\n", - "for i in range(10):\n", - " f6_grad_analytical += i*x**(i-1)\n", - "\n", - "print(\"The analytical derivative of f6 at x = %g is: %g\"%(x,f6_grad_analytical))" - ] - }, - { - "cell_type": "code", - "execution_count": 20, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "The computed derivative of f7 at n = 2 is: 1\n", - "The analytical derivative of f7 at n = 2 is: 1\n" - ] - } - ], - "source": [ - "import autograd.numpy as np\n", - "from autograd import grad\n", - "\n", - "def f7(n): # Assume that n is an integer\n", - " if n == 1 or n == 0:\n", - " return 1\n", - " else:\n", - " return n*f7(n-1)\n", - "\n", - "f7_grad = grad(f7)\n", - "\n", - "n = 2.0\n", - "\n", - "print(\"The computed derivative of f7 at n = %d is: %g\"%(n,f7_grad(n)))\n", - "\n", - "# The function f7 is an implementation of the factorial of n.\n", - "# By using the product rule, one can find that the derivative is:\n", - "\n", - "f7_grad_analytical = 0\n", - "for i in range(int(n)-1):\n", - " tmp = 1\n", - " for k in range(int(n)-1):\n", - " if k != i:\n", - " tmp *= (n - k)\n", - " f7_grad_analytical += tmp\n", - "\n", - "print(\"The analytical derivative of f7 at n = %d is: %g\"%(n,f7_grad_analytical))" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Note that if n is equal to zero or one, Autograd will give an error message. This message appears when the output is independent on input.\n", - "\n", - "\n", - "Autograd supports many features. However, there are some functions that are not supported (yet) by Autograd.\n", - "\n", - "Assigning a value to the variable being differentiated with respect to is an example thereof." - ] - }, - { - "cell_type": "code", - "execution_count": 21, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "#import autograd.numpy as np\n", - "#from autograd import grad\n", - "#def f8(x): # Assume x is an array\n", - "# x[2] = 3\n", - "# return x*2\n", - "\n", - "#f8_grad = grad(f8)\n", - "\n", - "#x = 8.4\n", - "\n", - "#print(\"The derivative of f8 is:\",f8_grad(x))" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Here, Autograd tells us that an 'ArrayBox' does not support item assignment. The item assignment is done when the program tries to assign x[2] to the value 3. However, Autograd has implemented the computation of the derivative such that this assignment is not possible." - ] - }, - { - "cell_type": "code", - "execution_count": 22, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "ename": "AttributeError", - "evalue": "'ArrayBox' object has no attribute 'dot'", - "output_type": "error", - "traceback": [ - "\u001b[0;31m---------------------------------------------------------------------------\u001b[0m", - "\u001b[0;31mAttributeError\u001b[0m Traceback (most recent call last)", - "\u001b[0;32m\u001b[0m in \u001b[0;36m\u001b[0;34m\u001b[0m\n\u001b[1;32m 9\u001b[0m \u001b[0mx\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mnp\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0marray\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0;34m[\u001b[0m\u001b[0;36m1.0\u001b[0m\u001b[0;34m,\u001b[0m\u001b[0;36m0.0\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 10\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0;32m---> 11\u001b[0;31m \u001b[0mprint\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0;34m\"The derivative of f9 is:\"\u001b[0m\u001b[0;34m,\u001b[0m\u001b[0mf9_grad\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mx\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[0;32m~/opt/anaconda3/lib/python3.8/site-packages/autograd/wrap_util.py\u001b[0m in \u001b[0;36mnary_f\u001b[0;34m(*args, **kwargs)\u001b[0m\n\u001b[1;32m 18\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 19\u001b[0m \u001b[0mx\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mtuple\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0margs\u001b[0m\u001b[0;34m[\u001b[0m\u001b[0mi\u001b[0m\u001b[0;34m]\u001b[0m \u001b[0;32mfor\u001b[0m \u001b[0mi\u001b[0m \u001b[0;32min\u001b[0m \u001b[0margnum\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0;32m---> 20\u001b[0;31m \u001b[0;32mreturn\u001b[0m \u001b[0munary_operator\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0munary_f\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mx\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0;34m*\u001b[0m\u001b[0mnary_op_args\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0;34m**\u001b[0m\u001b[0mnary_op_kwargs\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 21\u001b[0m \u001b[0;32mreturn\u001b[0m \u001b[0mnary_f\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m 22\u001b[0m \u001b[0;32mreturn\u001b[0m \u001b[0mnary_operator\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n", - "\u001b[0;32m~/opt/anaconda3/lib/python3.8/site-packages/autograd/differential_operators.py\u001b[0m in \u001b[0;36mgrad\u001b[0;34m(fun, x)\u001b[0m\n\u001b[1;32m 23\u001b[0m \u001b[0marguments\u001b[0m \u001b[0;32mas\u001b[0m\u001b[0;31m \u001b[0m\u001b[0;31m`\u001b[0m\u001b[0mfun\u001b[0m\u001b[0;31m`\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mbut\u001b[0m \u001b[0mreturns\u001b[0m \u001b[0mthe\u001b[0m \u001b[0mgradient\u001b[0m \u001b[0minstead\u001b[0m\u001b[0;34m.\u001b[0m \u001b[0mThe\u001b[0m \u001b[0mfunction\u001b[0m\u001b[0;31m \u001b[0m\u001b[0;31m`\u001b[0m\u001b[0mfun\u001b[0m\u001b[0;31m`\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m 24\u001b[0m should be scalar-valued. The gradient has the same type as the argument.\"\"\"\n\u001b[0;32m---> 25\u001b[0;31m \u001b[0mvjp\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mans\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0m_make_vjp\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mfun\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mx\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 26\u001b[0m \u001b[0;32mif\u001b[0m \u001b[0;32mnot\u001b[0m \u001b[0mvspace\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mans\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0msize\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 27\u001b[0m raise TypeError(\"Grad only applies to real scalar-output functions. \"\n", - "\u001b[0;32m~/opt/anaconda3/lib/python3.8/site-packages/autograd/core.py\u001b[0m in \u001b[0;36mmake_vjp\u001b[0;34m(fun, x)\u001b[0m\n\u001b[1;32m 8\u001b[0m \u001b[0;32mdef\u001b[0m \u001b[0mmake_vjp\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mfun\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mx\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[0mstart_node\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mVJPNode\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mnew_root\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---> 10\u001b[0;31m \u001b[0mend_value\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mend_node\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mtrace\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mstart_node\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mfun\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mx\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 11\u001b[0m \u001b[0;32mif\u001b[0m \u001b[0mend_node\u001b[0m \u001b[0;32mis\u001b[0m \u001b[0;32mNone\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m 12\u001b[0m \u001b[0;32mdef\u001b[0m \u001b[0mvjp\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mg\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m:\u001b[0m \u001b[0;32mreturn\u001b[0m \u001b[0mvspace\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mx\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mzeros\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~/opt/anaconda3/lib/python3.8/site-packages/autograd/tracer.py\u001b[0m in \u001b[0;36mtrace\u001b[0;34m(start_node, fun, x)\u001b[0m\n\u001b[1;32m 8\u001b[0m \u001b[0;32mwith\u001b[0m \u001b[0mtrace_stack\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mnew_trace\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0;34m)\u001b[0m \u001b[0;32mas\u001b[0m \u001b[0mt\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[0mstart_box\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mnew_box\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mx\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mt\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mstart_node\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0;32m---> 10\u001b[0;31m \u001b[0mend_box\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mfun\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mstart_box\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 11\u001b[0m \u001b[0;32mif\u001b[0m \u001b[0misbox\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mend_box\u001b[0m\u001b[0;34m)\u001b[0m \u001b[0;32mand\u001b[0m \u001b[0mend_box\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0m_trace\u001b[0m \u001b[0;34m==\u001b[0m \u001b[0mstart_box\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0m_trace\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m 12\u001b[0m \u001b[0;32mreturn\u001b[0m \u001b[0mend_box\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0m_value\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mend_box\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0m_node\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n", - "\u001b[0;32m~/opt/anaconda3/lib/python3.8/site-packages/autograd/wrap_util.py\u001b[0m in \u001b[0;36munary_f\u001b[0;34m(x)\u001b[0m\n\u001b[1;32m 13\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 14\u001b[0m \u001b[0msubargs\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0msubvals\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0margs\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mzip\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0margnum\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mx\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---> 15\u001b[0;31m \u001b[0;32mreturn\u001b[0m \u001b[0mfun\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0;34m*\u001b[0m\u001b[0msubargs\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 16\u001b[0m \u001b[0;32mif\u001b[0m \u001b[0misinstance\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0margnum\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[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m 17\u001b[0m \u001b[0mx\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0margs\u001b[0m\u001b[0;34m[\u001b[0m\u001b[0margnum\u001b[0m\u001b[0;34m]\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n", - "\u001b[0;32m\u001b[0m in \u001b[0;36mf9\u001b[0;34m(a)\u001b[0m\n\u001b[1;32m 3\u001b[0m \u001b[0;32mdef\u001b[0m \u001b[0mf9\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0ma\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m:\u001b[0m \u001b[0;31m# Assume a is an array with 2 elements\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m 4\u001b[0m \u001b[0mb\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mnp\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0marray\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0;34m[\u001b[0m\u001b[0;36m1.0\u001b[0m\u001b[0;34m,\u001b[0m\u001b[0;36m2.0\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[0;32mreturn\u001b[0m \u001b[0ma\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mdot\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mb\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[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m 7\u001b[0m \u001b[0mf9_grad\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mgrad\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mf9\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: 'ArrayBox' object has no attribute 'dot'" - ] - } - ], - "source": [ - "import autograd.numpy as np\n", - "from autograd import grad\n", - "def f9(a): # Assume a is an array with 2 elements\n", - " b = np.array([1.0,2.0])\n", - " return a.dot(b)\n", - "\n", - "f9_grad = grad(f9)\n", - "\n", - "x = np.array([1.0,0.0])\n", - "\n", - "print(\"The derivative of f9 is:\",f9_grad(x))" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Here we are told that the 'dot' function does not belong to Autograd's\n", - "version of a Numpy array. To overcome this, an alternative syntax\n", - "which also computed the dot product can be used:" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import autograd.numpy as np\n", - "from autograd import grad\n", - "def f9_alternative(x): # Assume a is an array with 2 elements\n", - " b = np.array([1.0,2.0])\n", - " return np.dot(x,b) # The same as x_1*b_1 + x_2*b_2\n", - "\n", - "f9_alternative_grad = grad(f9_alternative)\n", - "\n", - "x = np.array([3.0,0.0])\n", - "\n", - "print(\"The gradient of f9 is:\",f9_alternative_grad(x))\n", - "\n", - "# The analytical gradient of the dot product of vectors x and b with two elements (x_1,x_2) and (b_1, b_2) respectively\n", - "# w.r.t x is (b_1, b_2)." - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The documentation recommends to avoid inplace operations such as" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "a += b\n", - "a -= b\n", - "a*= b\n", - "a /=b" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "More examples will be added, in particular how to compare autograd with own codes for the gradients." - ] - } - ], - "metadata": { - "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.8.5" - } - }, - "nbformat": 4, - "nbformat_minor": 4 -} \ No newline at end of file diff --git a/doc/LectureNotes/_build/jupyter_execute/chapteroptimization.py b/doc/LectureNotes/_build/jupyter_execute/chapteroptimization.py deleted file mode 100644 index c72540c46..000000000 --- a/doc/LectureNotes/_build/jupyter_execute/chapteroptimization.py +++ /dev/null @@ -1,1670 +0,0 @@ -# Optimization, the central part of any Machine Learning algortithm - -Almost every problem in machine learning and data science starts with -a dataset $X$, a model $g(\beta)$, which is a function of the -parameters $\beta$ and a cost function $C(X, g(\beta))$ that allows -us to judge how well the model $g(\beta)$ explains the observations -$X$. The model is fit by finding the values of $\beta$ that minimize -the cost function. Ideally we would be able to solve for $\beta$ -analytically, however this is not possible in general and we must use -some approximative/numerical method to compute the minimum. - - - - -In our discussion on Logistic Regression we studied the -case of -two classes, with $y_i$ either -$0$ or $1$. Furthermore we assumed also that we have only two -parameters $\beta$ in our fitting, that is we -defined probabilities - -$$ -\begin{align*} -p(y_i=1|x_i,\boldsymbol{\beta}) &= \frac{\exp{(\beta_0+\beta_1x_i)}}{1+\exp{(\beta_0+\beta_1x_i)}},\nonumber\\ -p(y_i=0|x_i,\boldsymbol{\beta}) &= 1 - p(y_i=1|x_i,\boldsymbol{\beta}), -\end{align*} -$$ - -where $\boldsymbol{\beta}$ are the weights we wish to extract from data, in our case $\beta_0$ and $\beta_1$. - - - -Our compact equations used a definition of a vector $\boldsymbol{y}$ with $n$ -elements $y_i$, an $n\times p$ matrix $\boldsymbol{X}$ which contains the -$x_i$ values and a vector $\boldsymbol{p}$ of fitted probabilities -$p(y_i\vert x_i,\boldsymbol{\beta})$. We rewrote in a more compact form -the first derivative of the cost function as - -$$ -\frac{\partial \mathcal{C}(\boldsymbol{\beta})}{\partial \boldsymbol{\beta}} = -\boldsymbol{X}^T\left(\boldsymbol{y}-\boldsymbol{p}\right). -$$ - -If we in addition define a diagonal matrix $\boldsymbol{W}$ with elements -$p(y_i\vert x_i,\boldsymbol{\beta})(1-p(y_i\vert x_i,\boldsymbol{\beta})$, we can obtain a compact expression of the second derivative as - -$$ -\frac{\partial^2 \mathcal{C}(\boldsymbol{\beta})}{\partial \boldsymbol{\beta}\partial \boldsymbol{\beta}^T} = \boldsymbol{X}^T\boldsymbol{W}\boldsymbol{X}. -$$ - -This defines what is called the Hessian matrix. - - - -If we can set up these equations, Newton-Raphson's iterative method is normally the method of choice. It requires however that we can compute in an efficient way the matrices that define the first and second derivatives. - -Our iterative scheme is then given by - -$$ -\boldsymbol{\beta}^{\mathrm{new}} = \boldsymbol{\beta}^{\mathrm{old}}-\left(\frac{\partial^2 \mathcal{C}(\boldsymbol{\beta})}{\partial \boldsymbol{\beta}\partial \boldsymbol{\beta}^T}\right)^{-1}_{\boldsymbol{\beta}^{\mathrm{old}}}\times \left(\frac{\partial \mathcal{C}(\boldsymbol{\beta})}{\partial \boldsymbol{\beta}}\right)_{\boldsymbol{\beta}^{\mathrm{old}}}, -$$ - -or in matrix form as - -$$ -\boldsymbol{\beta}^{\mathrm{new}} = \boldsymbol{\beta}^{\mathrm{old}}-\left(\boldsymbol{X}^T\boldsymbol{W}\boldsymbol{X} \right)^{-1}\times \left(-\boldsymbol{X}^T(\boldsymbol{y}-\boldsymbol{p}) \right)_{\boldsymbol{\beta}^{\mathrm{old}}}. -$$ - -The right-hand side is computed with the old values of $\beta$. - -If we can compute these matrices, in particular the Hessian, the above is often the easiest method to implement. - - -Let us quickly remind ourselves how we derive the above method. - -Perhaps the most celebrated of all one-dimensional root-finding -routines is Newton's method, also called the Newton-Raphson -method. This method requires the evaluation of both the -function $f$ and its derivative $f'$ at arbitrary points. -If you can only calculate the derivative -numerically and/or your function is not of the smooth type, we -normally discourage the use of this method. - - - -The Newton-Raphson formula consists geometrically of extending the -tangent line at a current point until it crosses zero, then setting -the next guess to the abscissa of that zero-crossing. The mathematics -behind this method is rather simple. Employing a Taylor expansion for -$x$ sufficiently close to the solution $s$, we have - - -
- -$$ -f(s)=0=f(x)+(s-x)f'(x)+\frac{(s-x)^2}{2}f''(x) +\dots. - \label{eq:taylornr} \tag{1} -$$ - -For small enough values of the function and for well-behaved -functions, the terms beyond linear are unimportant, hence we obtain - -$$ -f(x)+(s-x)f'(x)\approx 0, -$$ - -yielding - -$$ -s\approx x-\frac{f(x)}{f'(x)}. -$$ - -Having in mind an iterative procedure, it is natural to start iterating with - -$$ -x_{n+1}=x_n-\frac{f(x_n)}{f'(x_n)}. -$$ - -The above is Newton-Raphson's method. It has a simple geometric -interpretation, namely $x_{n+1}$ is the point where the tangent from -$(x_n,f(x_n))$ crosses the $x$-axis. Close to the solution, -Newton-Raphson converges fast to the desired result. However, if we -are far from a root, where the higher-order terms in the series are -important, the Newton-Raphson formula can give grossly inaccurate -results. For instance, the initial guess for the root might be so far -from the true root as to let the search interval include a local -maximum or minimum of the function. If an iteration places a trial -guess near such a local extremum, so that the first derivative nearly -vanishes, then Newton-Raphson may fail totally - - - - -Newton's method can be generalized to systems of several non-linear equations -and variables. Consider the case with two equations - -$$ -\begin{array}{cc} f_1(x_1,x_2) &=0\\ - f_2(x_1,x_2) &=0,\end{array} -$$ - -which we Taylor expand to obtain - -$$ -\begin{array}{cc} 0=f_1(x_1+h_1,x_2+h_2)=&f_1(x_1,x_2)+h_1 - \partial f_1/\partial x_1+h_2 - \partial f_1/\partial x_2+\dots\\ - 0=f_2(x_1+h_1,x_2+h_2)=&f_2(x_1,x_2)+h_1 - \partial f_2/\partial x_1+h_2 - \partial f_2/\partial x_2+\dots - \end{array}. -$$ - -Defining the Jacobian matrix $\boldsymbol{J}$ we have - -$$ -\boldsymbol{J}=\left( \begin{array}{cc} - \partial f_1/\partial x_1 & \partial f_1/\partial x_2 \\ - \partial f_2/\partial x_1 &\partial f_2/\partial x_2 - \end{array} \right), -$$ - -we can rephrase Newton's method as - -$$ -\left(\begin{array}{c} x_1^{n+1} \\ x_2^{n+1} \end{array} \right)= -\left(\begin{array}{c} x_1^{n} \\ x_2^{n} \end{array} \right)+ -\left(\begin{array}{c} h_1^{n} \\ h_2^{n} \end{array} \right), -$$ - -where we have defined - -$$ -\left(\begin{array}{c} h_1^{n} \\ h_2^{n} \end{array} \right)= - -\boldsymbol{J}^{-1} - \left(\begin{array}{c} f_1(x_1^{n},x_2^{n}) \\ f_2(x_1^{n},x_2^{n}) \end{array} \right). -$$ - -We need thus to compute the inverse of the Jacobian matrix and it -is to understand that difficulties may -arise in case $\boldsymbol{J}$ is nearly singular. - -It is rather straightforward to extend the above scheme to systems of -more than two non-linear equations. In our case, the Jacobian matrix is given by the Hessian that represents the second derivative of cost function. - - - - -## Steepest descent - -The basic idea of gradient descent is -that a function $F(\mathbf{x})$, -$\mathbf{x} \equiv (x_1,\cdots,x_n)$, decreases fastest if one goes from $\bf {x}$ in the -direction of the negative gradient $-\nabla F(\mathbf{x})$. - -It can be shown that if - -$$ -\mathbf{x}_{k+1} = \mathbf{x}_k - \gamma_k \nabla F(\mathbf{x}_k), -$$ - -with $\gamma_k > 0$. - -For $\gamma_k$ small enough, then $F(\mathbf{x}_{k+1}) \leq -F(\mathbf{x}_k)$. This means that for a sufficiently small $\gamma_k$ -we are always moving towards smaller function values, i.e a minimum. - - -The previous observation is the basis of the method of steepest -descent, which is also referred to as just gradient descent (GD). One -starts with an initial guess $\mathbf{x}_0$ for a minimum of $F$ and -computes new approximations according to - -$$ -\mathbf{x}_{k+1} = \mathbf{x}_k - \gamma_k \nabla F(\mathbf{x}_k), \ \ k \geq 0. -$$ - -The parameter $\gamma_k$ is often referred to as the step length or -the learning rate within the context of Machine Learning. - - -Ideally the sequence $\{\mathbf{x}_k \}_{k=0}$ converges to a global -minimum of the function $F$. In general we do not know if we are in a -global or local minimum. In the special case when $F$ is a convex -function, all local minima are also global minima, so in this case -gradient descent can converge to the global solution. The advantage of -this scheme is that it is conceptually simple and straightforward to -implement. However the method in this form has some severe -limitations: - -In machine learing we are often faced with non-convex high dimensional -cost functions with many local minima. Since GD is deterministic we -will get stuck in a local minimum, if the method converges, unless we -have a very good intial guess. This also implies that the scheme is -sensitive to the chosen initial condition. - -Note that the gradient is a function of $\mathbf{x} = -(x_1,\cdots,x_n)$ which makes it expensive to compute numerically. - - - - -The gradient descent method -is sensitive to the choice of learning rate $\gamma_k$. This is due -to the fact that we are only guaranteed that $F(\mathbf{x}_{k+1}) \leq -F(\mathbf{x}_k)$ for sufficiently small $\gamma_k$. The problem is to -determine an optimal learning rate. If the learning rate is chosen too -small the method will take a long time to converge and if it is too -large we can experience erratic behavior. - -Many of these shortcomings can be alleviated by introducing -randomness. One such method is that of Stochastic Gradient Descent -(SGD), see below. - - - -## Convex functions - -Ideally we want our cost/loss function to be convex(concave). - -First we give the definition of a convex set: A set $C$ in -$\mathbb{R}^n$ is said to be convex if, for all $x$ and $y$ in $C$ and -all $t \in (0,1)$ , the point $(1 − t)x + ty$ also belongs to -C. Geometrically this means that every point on the line segment -connecting $x$ and $y$ is in $C$ as discussed below. - -The convex subsets of $\mathbb{R}$ are the intervals of -$\mathbb{R}$. Examples of convex sets of $\mathbb{R}^2$ are the -regular polygons (triangles, rectangles, pentagons, etc...). - - - -**Convex function**: Let $X \subset \mathbb{R}^n$ be a convex set. Assume that the function $f: X \rightarrow \mathbb{R}$ is continuous, then $f$ is said to be convex if $$f(tx_1 + (1-t)x_2) \leq tf(x_1) + (1-t)f(x_2) $$ for all $x_1, x_2 \in X$ and for all $t \in [0,1]$. If $\leq$ is replaced with a strict inequaltiy in the definition, we demand $x_1 \neq x_2$ and $t\in(0,1)$ then $f$ is said to be strictly convex. For a single variable function, convexity means that if you draw a straight line connecting $f(x_1)$ and $f(x_2)$, the value of the function on the interval $[x_1,x_2]$ is always below the line as illustrated below. - - -In the following we state first and second-order conditions which -ensures convexity of a function $f$. We write $D_f$ to denote the -domain of $f$, i.e the subset of $R^n$ where $f$ is defined. For more -details and proofs we refer to: [S. Boyd and L. Vandenberghe. Convex Optimization. Cambridge University Press](http://stanford.edu/boyd/cvxbook/, 2004). - -**First order condition.** - -Suppose $f$ is differentiable (i.e $\nabla f(x)$ is well defined for -all $x$ in the domain of $f$). Then $f$ is convex if and only if $D_f$ -is a convex set and $$f(y) \geq f(x) + \nabla f(x)^T (y-x) $$ holds -for all $x,y \in D_f$. This condition means that for a convex function -the first order Taylor expansion (right hand side above) at any point -a global under estimator of the function. To convince yourself you can -make a drawing of $f(x) = x^2+1$ and draw the tangent line to $f(x)$ and -note that it is always below the graph. - - - -**Second order condition.** - -Assume that $f$ is twice -differentiable, i.e the Hessian matrix exists at each point in -$D_f$. Then $f$ is convex if and only if $D_f$ is a convex set and its -Hessian is positive semi-definite for all $x\in D_f$. For a -single-variable function this reduces to $f''(x) \geq 0$. Geometrically this means that $f$ has nonnegative curvature -everywhere. - - - -This condition is particularly useful since it gives us an procedure for determining if the function under consideration is convex, apart from using the definition. - - - -The next result is of great importance to us and the reason why we are -going on about convex functions. In machine learning we frequently -have to minimize a loss/cost function in order to find the best -parameters for the model we are considering. - -Ideally we want the -global minimum (for high-dimensional models it is hard to know -if we have local or global minimum). However, if the cost/loss function -is convex the following result provides invaluable information: - -**Any minimum is global for convex functions.** - -Consider the problem of finding $x \in \mathbb{R}^n$ such that $f(x)$ -is minimal, where $f$ is convex and differentiable. Then, any point -$x^*$ that satisfies $\nabla f(x^*) = 0$ is a global minimum. - - - -This result means that if we know that the cost/loss function is convex and we are able to find a minimum, we are guaranteed that it is a global minimum. - - -### Some simple problems - -1. Show that $f(x)=x^2$ is convex for $x \in \mathbb{R}$ using the definition of convexity. Hint: If you re-write the definition, $f$ is convex if the following holds for all $x,y \in D_f$ and any $\lambda \in [0,1]$ $\lambda f(x)+(1-\lambda)f(y)-f(\lambda x + (1-\lambda) y ) \geq 0$. - -2. Using the second order condition show that the following functions are convex on the specified domain. - - * $f(x) = e^x$ is convex for $x \in \mathbb{R}$. - - * $g(x) = -\ln(x)$ is convex for $x \in (0,\infty)$. - - -3. Let $f(x) = x^2$ and $g(x) = e^x$. Show that $f(g(x))$ and $g(f(x))$ is convex for $x \in \mathbb{R}$. Also show that if $f(x)$ is any convex function than $h(x) = e^{f(x)}$ is convex. - -4. A norm is any function that satisfy the following properties - - * $f(\alpha x) = |\alpha| f(x)$ for all $\alpha \in \mathbb{R}$. - - * $f(x+y) \leq f(x) + f(y)$ - - * $f(x) \leq 0$ for all $x \in \mathbb{R}^n$ with equality if and only if $x = 0$ - - -Using the definition of convexity, try to show that a function satisfying the properties above is convex (the third condition is not needed to show this). - - -## Standard steepest descent - - -Before we proceed, we would like to discuss the approach called the -**standard Steepest descent** (different from the above steepest descent discussion), which again leads to us having to be able -to compute a matrix. It belongs to the class of Conjugate Gradient methods (CG). - -[The success of the CG method](https://www.cs.cmu.edu/~quake-papers/painless-conjugate-gradient.pdf) -for finding solutions of non-linear problems is based on the theory -of conjugate gradients for linear systems of equations. It belongs to -the class of iterative methods for solving problems from linear -algebra of the type - -$$ -\boldsymbol{A}\boldsymbol{x} = \boldsymbol{b}. -$$ - -In the iterative process we end up with a problem like - -$$ -\boldsymbol{r}= \boldsymbol{b}-\boldsymbol{A}\boldsymbol{x}, -$$ - -where $\boldsymbol{r}$ is the so-called residual or error in the iterative process. - -When we have found the exact solution, $\boldsymbol{r}=0$. - - - -The residual is zero when we reach the minimum of the quadratic equation - -$$ -P(\boldsymbol{x})=\frac{1}{2}\boldsymbol{x}^T\boldsymbol{A}\boldsymbol{x} - \boldsymbol{x}^T\boldsymbol{b}, -$$ - -with the constraint that the matrix $\boldsymbol{A}$ is positive definite and -symmetric. This defines also the Hessian and we want it to be positive definite. - - -We denote the initial guess for $\boldsymbol{x}$ as $\boldsymbol{x}_0$. -We can assume without loss of generality that - -$$ -\boldsymbol{x}_0=0, -$$ - -or consider the system - -$$ -\boldsymbol{A}\boldsymbol{z} = \boldsymbol{b}-\boldsymbol{A}\boldsymbol{x}_0, -$$ - -instead. - - -One can show that the solution $\boldsymbol{x}$ is also the unique minimizer of the quadratic form - -$$ -f(\boldsymbol{x}) = \frac{1}{2}\boldsymbol{x}^T\boldsymbol{A}\boldsymbol{x} - \boldsymbol{x}^T \boldsymbol{x} , \quad \boldsymbol{x}\in\mathbf{R}^n. -$$ - -This suggests taking the first basis vector $\boldsymbol{r}_1$ (see below for definition) -to be the gradient of $f$ at $\boldsymbol{x}=\boldsymbol{x}_0$, -which equals - -$$ -\boldsymbol{A}\boldsymbol{x}_0-\boldsymbol{b}, -$$ - -and -$\boldsymbol{x}_0=0$ it is equal $-\boldsymbol{b}$. - - -We can compute the residual iteratively as - -$$ -\boldsymbol{r}_{k+1}=\boldsymbol{b}-\boldsymbol{A}\boldsymbol{x}_{k+1}, -$$ - -which equals - -$$ -\boldsymbol{b}-\boldsymbol{A}(\boldsymbol{x}_k+\alpha_k\boldsymbol{r}_k), -$$ - -or - -$$ -(\boldsymbol{b}-\boldsymbol{A}\boldsymbol{x}_k)-\alpha_k\boldsymbol{A}\boldsymbol{r}_k, -$$ - -which gives - -$$ -\alpha_k = \frac{\boldsymbol{r}_k^T\boldsymbol{r}_k}{\boldsymbol{r}_k^T\boldsymbol{A}\boldsymbol{r}_k} -$$ - -leading to the iterative scheme - -$$ -\boldsymbol{x}_{k+1}=\boldsymbol{x}_k-\alpha_k\boldsymbol{r}_{k}, -$$ - -%matplotlib inline - -import numpy as np -import numpy.linalg as la - -import scipy.optimize as sopt - -import matplotlib.pyplot as pt -from mpl_toolkits.mplot3d import axes3d - -def f(x): - return 0.5*x[0]**2 + 2.5*x[1]**2 - -def df(x): - return np.array([x[0], 5*x[1]]) - -fig = pt.figure() -ax = fig.gca(projection="3d") - -xmesh, ymesh = np.mgrid[-2:2:50j,-2:2:50j] -fmesh = f(np.array([xmesh, ymesh])) -ax.plot_surface(xmesh, ymesh, fmesh) - -And then as countor plot - -pt.axis("equal") -pt.contour(xmesh, ymesh, fmesh) -guesses = [np.array([2, 2./5])] - -Find guesses - -x = guesses[-1] -s = -df(x) - -Run it! - -def f1d(alpha): - return f(x + alpha*s) - -alpha_opt = sopt.golden(f1d) -next_guess = x + alpha_opt * s -guesses.append(next_guess) -print(next_guess) - -What happened? - -pt.axis("equal") -pt.contour(xmesh, ymesh, fmesh, 50) -it_array = np.array(guesses) -pt.plot(it_array.T[0], it_array.T[1], "x-") - -## Conjugate gradient method -In the CG method we define so-called conjugate directions and two vectors -$\boldsymbol{s}$ and $\boldsymbol{t}$ -are said to be -conjugate if - -$$ -\boldsymbol{s}^T\boldsymbol{A}\boldsymbol{t}= 0. -$$ - -The philosophy of the CG method is to perform searches in various conjugate directions -of our vectors $\boldsymbol{x}_i$ obeying the above criterion, namely - -$$ -\boldsymbol{x}_i^T\boldsymbol{A}\boldsymbol{x}_j= 0. -$$ - -Two vectors are conjugate if they are orthogonal with respect to -this inner product. Being conjugate is a symmetric relation: if $\boldsymbol{s}$ is conjugate to $\boldsymbol{t}$, then $\boldsymbol{t}$ is conjugate to $\boldsymbol{s}$. - -An example is given by the eigenvectors of the matrix - -$$ -\boldsymbol{v}_i^T\boldsymbol{A}\boldsymbol{v}_j= \lambda\boldsymbol{v}_i^T\boldsymbol{v}_j, -$$ - -which is zero unless $i=j$. - -Assume now that we have a symmetric positive-definite matrix $\boldsymbol{A}$ of size -$n\times n$. At each iteration $i+1$ we obtain the conjugate direction of a vector - -$$ -\boldsymbol{x}_{i+1}=\boldsymbol{x}_{i}+\alpha_i\boldsymbol{p}_{i}. -$$ - -We assume that $\boldsymbol{p}_{i}$ is a sequence of $n$ mutually conjugate directions. -Then the $\boldsymbol{p}_{i}$ form a basis of $R^n$ and we can expand the solution -$ \boldsymbol{A}\boldsymbol{x} = \boldsymbol{b}$ in this basis, namely - -$$ -\boldsymbol{x} = \sum^{n}_{i=1} \alpha_i \boldsymbol{p}_i. -$$ - -The coefficients are given by - -$$ -\mathbf{A}\mathbf{x} = \sum^{n}_{i=1} \alpha_i \mathbf{A} \mathbf{p}_i = \mathbf{b}. -$$ - -Multiplying with $\boldsymbol{p}_k^T$ from the left gives - -$$ -\boldsymbol{p}_k^T \boldsymbol{A}\boldsymbol{x} = \sum^{n}_{i=1} \alpha_i\boldsymbol{p}_k^T \boldsymbol{A}\boldsymbol{p}_i= \boldsymbol{p}_k^T \boldsymbol{b}, -$$ - -and we can define the coefficients $\alpha_k$ as - -$$ -\alpha_k = \frac{\boldsymbol{p}_k^T \boldsymbol{b}}{\boldsymbol{p}_k^T \boldsymbol{A} \boldsymbol{p}_k} -$$ - -If we choose the conjugate vectors $\boldsymbol{p}_k$ carefully, -then we may not need all of them to obtain a good approximation to the solution -$\boldsymbol{x}$. -We want to regard the conjugate gradient method as an iterative method. -This will us to solve systems where $n$ is so large that the direct -method would take too much time. - -We denote the initial guess for $\boldsymbol{x}$ as $\boldsymbol{x}_0$. -We can assume without loss of generality that - -$$ -\boldsymbol{x}_0=0, -$$ - -or consider the system - -$$ -\boldsymbol{A}\boldsymbol{z} = \boldsymbol{b}-\boldsymbol{A}\boldsymbol{x}_0, -$$ - -instead. - -One can show that the solution $\boldsymbol{x}$ is also the unique minimizer of the quadratic form - -$$ -f(\boldsymbol{x}) = \frac{1}{2}\boldsymbol{x}^T\boldsymbol{A}\boldsymbol{x} - \boldsymbol{x}^T \boldsymbol{x} , \quad \boldsymbol{x}\in\mathbf{R}^n. -$$ - -This suggests taking the first basis vector $\boldsymbol{p}_1$ -to be the gradient of $f$ at $\boldsymbol{x}=\boldsymbol{x}_0$, -which equals - -$$ -\boldsymbol{A}\boldsymbol{x}_0-\boldsymbol{b}, -$$ - -and -$\boldsymbol{x}_0=0$ it is equal $-\boldsymbol{b}$. -The other vectors in the basis will be conjugate to the gradient, -hence the name conjugate gradient method. - -Let $\boldsymbol{r}_k$ be the residual at the $k$-th step: - -$$ -\boldsymbol{r}_k=\boldsymbol{b}-\boldsymbol{A}\boldsymbol{x}_k. -$$ - -Note that $\boldsymbol{r}_k$ is the negative gradient of $f$ at -$\boldsymbol{x}=\boldsymbol{x}_k$, -so the gradient descent method would be to move in the direction $\boldsymbol{r}_k$. -Here, we insist that the directions $\boldsymbol{p}_k$ are conjugate to each other, -so we take the direction closest to the gradient $\boldsymbol{r}_k$ -under the conjugacy constraint. -This gives the following expression - -$$ -\boldsymbol{p}_{k+1}=\boldsymbol{r}_k-\frac{\boldsymbol{p}_k^T \boldsymbol{A}\boldsymbol{r}_k}{\boldsymbol{p}_k^T\boldsymbol{A}\boldsymbol{p}_k} \boldsymbol{p}_k. -$$ - -We can also compute the residual iteratively as - -$$ -\boldsymbol{r}_{k+1}=\boldsymbol{b}-\boldsymbol{A}\boldsymbol{x}_{k+1}, -$$ - -which equals - -$$ -\boldsymbol{b}-\boldsymbol{A}(\boldsymbol{x}_k+\alpha_k\boldsymbol{p}_k), -$$ - -or - -$$ -(\boldsymbol{b}-\boldsymbol{A}\boldsymbol{x}_k)-\alpha_k\boldsymbol{A}\boldsymbol{p}_k, -$$ - -which gives - -$$ -\boldsymbol{r}_{k+1}=\boldsymbol{r}_k-\boldsymbol{A}\boldsymbol{p}_{k}, -$$ - -## Revisiting our Linear Regression Solvers - -We will use linear regression as a case study for the gradient descent -methods. Linear regression is a great test case for the gradient -descent methods discussed in the lectures since it has several -desirable properties such as: - -1. An analytical solution. - -2. The gradient can be computed analytically. - -3. The cost function is convex which guarantees that gradient descent converges for small enough learning rates - -We revisit an example similar to what we had in the first homework set. We had a function of the type - -m = 100 -x = 2*np.random.rand(m,1) -y = 4+3*x+np.random.randn(m,1) - -with $x_i \in [0,1] $ is chosen randomly using a uniform distribution. Additionally we have a stochastic noise chosen according to a normal distribution $\cal {N}(0,1)$. -The linear regression model is given by - -$$ -h_\beta(x) = \boldsymbol{y} = \beta_0 + \beta_1 x, -$$ - -such that - -$$ -\boldsymbol{y}_i = \beta_0 + \beta_1 x_i. -$$ - -Let $\mathbf{y} = (y_1,\cdots,y_n)^T$, $\mathbf{\boldsymbol{y}} = (\boldsymbol{y}_1,\cdots,\boldsymbol{y}_n)^T$ and $\beta = (\beta_0, \beta_1)^T$ - -It is convenient to write $\mathbf{\boldsymbol{y}} = X\beta$ where $X \in \mathbb{R}^{100 \times 2} $ is the design matrix given by (we keep the intercept here) - -$$ -X \equiv \begin{bmatrix} -1 & x_1 \\ -\vdots & \vdots \\ -1 & x_{100} & \\ -\end{bmatrix}. -$$ - -The cost/loss/risk function is given by ( - -$$ -C(\beta) = \frac{1}{n}||X\beta-\mathbf{y}||_{2}^{2} = \frac{1}{n}\sum_{i=1}^{100}\left[ (\beta_0 + \beta_1 x_i)^2 - 2 y_i (\beta_0 + \beta_1 x_i) + y_i^2\right] -$$ - -and we want to find $\beta$ such that $C(\beta)$ is minimized. - - -Computing $\partial C(\beta) / \partial \beta_0$ and $\partial C(\beta) / \partial \beta_1$ we can show that the gradient can be written as - -$$ -\nabla_{\beta} C(\beta) = \frac{2}{n}\begin{bmatrix} \sum_{i=1}^{100} \left(\beta_0+\beta_1x_i-y_i\right) \\ -\sum_{i=1}^{100}\left( x_i (\beta_0+\beta_1x_i)-y_ix_i\right) \\ -\end{bmatrix} = \frac{2}{n}X^T(X\beta - \mathbf{y}), -$$ - -where $X$ is the design matrix defined above. - - -The Hessian matrix of $C(\beta)$ is given by - -$$ -\boldsymbol{H} \equiv \begin{bmatrix} -\frac{\partial^2 C(\beta)}{\partial \beta_0^2} & \frac{\partial^2 C(\beta)}{\partial \beta_0 \partial \beta_1} \\ -\frac{\partial^2 C(\beta)}{\partial \beta_0 \partial \beta_1} & \frac{\partial^2 C(\beta)}{\partial \beta_1^2} & \\ -\end{bmatrix} = \frac{2}{n}X^T X. -$$ - -This result implies that $C(\beta)$ is a convex function since the matrix $X^T X$ always is positive semi-definite. - - - -We can now write a program that minimizes $C(\beta)$ using the gradient descent method with a constant learning rate $\gamma$ according to - -$$ -\beta_{k+1} = \beta_k - \gamma \nabla_\beta C(\beta_k), \ k=0,1,\cdots -$$ - -We can use the expression we computed for the gradient and let use a -$\beta_0$ be chosen randomly and let $\gamma = 0.001$. Stop iterating -when $||\nabla_\beta C(\beta_k) || \leq \epsilon = 10^{-8}$. **Note that the code below does not include the latter stop criterion**. - -And finally we can compare our solution for $\beta$ with the analytic result given by -$\beta= (X^TX)^{-1} X^T \mathbf{y}$. - - - -Here is our simple example - - -# Importing various packages -from random import random, seed -import numpy as np -import matplotlib.pyplot as plt -from mpl_toolkits.mplot3d import Axes3D -from matplotlib import cm -from matplotlib.ticker import LinearLocator, FormatStrFormatter -import sys - -# the number of datapoints -n = 100 -x = 2*np.random.rand(n,1) -y = 4+3*x+np.random.randn(n,1) - -X = np.c_[np.ones((n,1)), x] -# Hessian matrix -H = (2.0/n)* X.T @ X -# Get the eigenvalues -EigValues, EigVectors = np.linalg.eig(H) -print(EigValues) - -beta_linreg = np.linalg.inv(X.T @ X) @ X.T @ y -print(beta_linreg) -beta = np.random.randn(2,1) - -eta = 1.0/np.max(EigValues) -Niterations = 1000 - -for iter in range(Niterations): - gradient = (2.0/n)*X.T @ (X @ beta-y) - beta -= eta*gradient - -print(beta) -xnew = np.array([[0],[2]]) -xbnew = np.c_[np.ones((2,1)), xnew] -ypredict = xbnew.dot(beta) -ypredict2 = xbnew.dot(beta_linreg) -plt.plot(xnew, ypredict, "r-") -plt.plot(xnew, ypredict2, "b-") -plt.plot(x, y ,'ro') -plt.axis([0,2.0,0, 15.0]) -plt.xlabel(r'$x$') -plt.ylabel(r'$y$') -plt.title(r'Gradient descent example') -plt.show() - -Alternatively, we can use **Scikit-Learn** as done here - -# Importing various packages -from random import random, seed -import numpy as np -import matplotlib.pyplot as plt -from sklearn.linear_model import SGDRegressor - -n = 100 -x = 2*np.random.rand(n,1) -y = 4+3*x+np.random.randn(n,1) - -X = np.c_[np.ones((n,1)), x] -beta_linreg = np.linalg.inv(X.T @ X) @ (X.T @ y) -print(beta_linreg) -sgdreg = SGDRegressor(max_iter = 50, penalty=None, eta0=0.1) -sgdreg.fit(x,y.ravel()) -print(sgdreg.intercept_, sgdreg.coef_) - -We have also discussed Ridge regression where the loss function contains a regularized term given by the $L_2$ norm of $\beta$, - -$$ -C_{\text{ridge}}(\beta) = \frac{1}{n}||X\beta -\mathbf{y}||^2 + \lambda ||\beta||^2, \ \lambda \geq 0. -$$ - -In order to minimize $C_{\text{ridge}}(\beta)$ using GD we only have adjust the gradient as follows - -$$ -\nabla_\beta C_{\text{ridge}}(\beta) = \frac{2}{n}\begin{bmatrix} \sum_{i=1}^{100} \left(\beta_0+\beta_1x_i-y_i\right) \\ -\sum_{i=1}^{100}\left( x_i (\beta_0+\beta_1x_i)-y_ix_i\right) \\ -\end{bmatrix} + 2\lambda\begin{bmatrix} \beta_0 \\ \beta_1\end{bmatrix} = 2 (X^T(X\beta - \mathbf{y})+\lambda \beta). -$$ - -We can easily extend our program to minimize $C_{\text{ridge}}(\beta)$ using gradient descent and compare with the analytical solution given by - -$$ -\beta_{\text{ridge}} = \left(X^T X + \lambda I_{2 \times 2} \right)^{-1} X^T \mathbf{y}. -$$ - -from random import random, seed -import numpy as np -import matplotlib.pyplot as plt -from mpl_toolkits.mplot3d import Axes3D -from matplotlib import cm -from matplotlib.ticker import LinearLocator, FormatStrFormatter -import sys - -# the number of datapoints -n = 100 -x = 2*np.random.rand(n,1) -y = 4+3*x+np.random.randn(n,1) - -X = np.c_[np.ones((n,1)), x] -XT_X = X.T @ X - -#Ridge parameter lambda -lmbda = 0.001 -Id = lmbda* np.eye(XT_X.shape[0]) - -beta_linreg = np.linalg.inv(XT_X+Id) @ X.T @ y -print(beta_linreg) -# Start plain gradient descent -beta = np.random.randn(2,1) - -eta = 0.1 -Niterations = 100 - -for iter in range(Niterations): - gradients = 2.0/n*X.T @ (X @ (beta)-y)+2*lmbda*beta - beta -= eta*gradients - -print(beta) -ypredict = X @ beta -ypredict2 = X @ beta_linreg -plt.plot(x, ypredict, "r-") -plt.plot(x, ypredict2, "b-") -plt.plot(x, y ,'ro') -plt.axis([0,2.0,0, 15.0]) -plt.xlabel(r'$x$') -plt.ylabel(r'$y$') -plt.title(r'Gradient descent example for Ridge') -plt.show() - -## Using gradient descent methods, limitations - -* **Gradient descent (GD) finds local minima of our function**. Since the GD algorithm is deterministic, if it converges, it will converge to a local minimum of our cost/loss/risk function. Because in ML we are often dealing with extremely rugged landscapes with many local minima, this can lead to poor performance. - -* **GD is sensitive to initial conditions**. One consequence of the local nature of GD is that initial conditions matter. Depending on where one starts, one will end up at a different local minima. Therefore, it is very important to think about how one initializes the training process. This is true for GD as well as more complicated variants of GD. - -* **Gradients are computationally expensive to calculate for large datasets**. In many cases in statistics and ML, the cost/loss/risk function is a sum of terms, with one term for each data point. For example, in linear regression, $E \propto \sum_{i=1}^n (y_i - \mathbf{w}^T\cdot\mathbf{x}_i)^2$; for logistic regression, the square error is replaced by the cross entropy. To calculate the gradient we have to sum over *all* $n$ data points. Doing this at every GD step becomes extremely computationally expensive. An ingenious solution to this, is to calculate the gradients using small subsets of the data called "mini batches". This has the added benefit of introducing stochasticity into our algorithm. - -* **GD is very sensitive to choices of learning rates**. GD is extremely sensitive to the choice of learning rates. If the learning rate is very small, the training process take an extremely long time. For larger learning rates, GD can diverge and give poor results. Furthermore, depending on what the local landscape looks like, we have to modify the learning rates to ensure convergence. Ideally, we would *adaptively* choose the learning rates to match the landscape. - -* **GD treats all directions in parameter space uniformly.** Another major drawback of GD is that unlike Newton's method, the learning rate for GD is the same in all directions in parameter space. For this reason, the maximum learning rate is set by the behavior of the steepest direction and this can significantly slow down training. Ideally, we would like to take large steps in flat directions and small steps in steep directions. Since we are exploring rugged landscapes where curvatures change, this requires us to keep track of not only the gradient but second derivatives. The ideal scenario would be to calculate the Hessian but this proves to be too computationally expensive. - -* GD can take exponential time to escape saddle points, even with random initialization. As we mentioned, GD is extremely sensitive to initial condition since it determines the particular local minimum GD would eventually reach. However, even with a good initialization scheme, through the introduction of randomness, GD can still take exponential time to escape saddle points. - -## Stochastic Gradient Descent - -Stochastic gradient descent (SGD) and variants thereof address some of -the shortcomings of the Gradient descent method discussed above. - -The underlying idea of SGD comes from the observation that the cost -function, which we want to minimize, can almost always be written as a -sum over $n$ data points $\{\mathbf{x}_i\}_{i=1}^n$, - -$$ -C(\mathbf{\beta}) = \sum_{i=1}^n c_i(\mathbf{x}_i, -\mathbf{\beta}). -$$ - -This in turn means that the gradient can be -computed as a sum over $i$-gradients - -$$ -\nabla_\beta C(\mathbf{\beta}) = \sum_i^n \nabla_\beta c_i(\mathbf{x}_i, -\mathbf{\beta}). -$$ - -Stochasticity/randomness is introduced by only taking the -gradient on a subset of the data called minibatches. If there are $n$ -data points and the size of each minibatch is $M$, there will be $n/M$ -minibatches. We denote these minibatches by $B_k$ where -$k=1,\cdots,n/M$. - - - -As an example, suppose we have $10$ data points $(\mathbf{x}_1,\cdots, \mathbf{x}_{10})$ -and we choose to have $M=5$ minibathces, -then each minibatch contains two data points. In particular we have -$B_1 = (\mathbf{x}_1,\mathbf{x}_2), \cdots, B_5 = -(\mathbf{x}_9,\mathbf{x}_{10})$. Note that if you choose $M=1$ you -have only a single batch with all data points and on the other extreme, -you may choose $M=n$ resulting in a minibatch for each datapoint, i.e -$B_k = \mathbf{x}_k$. - -The idea is now to approximate the gradient by replacing the sum over -all data points with a sum over the data points in one the minibatches -picked at random in each gradient descent step - -$$ -\nabla_{\beta} -C(\mathbf{\beta}) = \sum_{i=1}^n \nabla_\beta c_i(\mathbf{x}_i, -\mathbf{\beta}) \rightarrow \sum_{i \in B_k}^n \nabla_\beta -c_i(\mathbf{x}_i, \mathbf{\beta}). -$$ - -Thus a gradient descent step now looks like - -$$ -\beta_{j+1} = \beta_j - \gamma_j \sum_{i \in B_k}^n \nabla_\beta c_i(\mathbf{x}_i, -\mathbf{\beta}) -$$ - -where $k$ is picked at random with equal -probability from $[1,n/M]$. An iteration over the number of -minibathces (n/M) is commonly referred to as an epoch. Thus it is -typical to choose a number of epochs and for each epoch iterate over -the number of minibatches, as exemplified in the code below. - -import numpy as np - -n = 100 #100 datapoints -M = 5 #size of each minibatch -m = int(n/M) #number of minibatches -n_epochs = 10 #number of epochs - -j = 0 -for epoch in range(1,n_epochs+1): - for i in range(m): - k = np.random.randint(m) #Pick the k-th minibatch at random - #Compute the gradient using the data in minibatch Bk - #Compute new suggestion for - j += 1 - -Taking the gradient only on a subset of the data has two important -benefits. First, it introduces randomness which decreases the chance -that our opmization scheme gets stuck in a local minima. Second, if -the size of the minibatches are small relative to the number of -datapoints ($M < n$), the computation of the gradient is much -cheaper since we sum over the datapoints in the $k-th$ minibatch and not -all $n$ datapoints. - - - -A natural question is when do we stop the search for a new minimum? -One possibility is to compute the full gradient after a given number -of epochs and check if the norm of the gradient is smaller than some -threshold and stop if true. However, the condition that the gradient -is zero is valid also for local minima, so this would only tell us -that we are close to a local/global minimum. However, we could also -evaluate the cost function at this point, store the result and -continue the search. If the test kicks in at a later stage we can -compare the values of the cost function and keep the $\beta$ that -gave the lowest value. - - - -Another approach is to let the step length $\gamma_j$ depend on the -number of epochs in such a way that it becomes very small after a -reasonable time such that we do not move at all. - -As an example, let $e = 0,1,2,3,\cdots$ denote the current epoch and let $t_0, t_1 > 0$ be two fixed numbers. Furthermore, let $t = e \cdot m + i$ where $m$ is the number of minibatches and $i=0,\cdots,m-1$. Then the function $$\gamma_j(t; t_0, t_1) = \frac{t_0}{t+t_1} $$ goes to zero as the number of epochs gets large. I.e. we start with a step length $\gamma_j (0; t_0, t_1) = t_0/t_1$ which decays in *time* $t$. - -In this way we can fix the number of epochs, compute $\beta$ and -evaluate the cost function at the end. Repeating the computation will -give a different result since the scheme is random by design. Then we -pick the final $\beta$ that gives the lowest value of the cost -function. - -import numpy as np - -def step_length(t,t0,t1): - return t0/(t+t1) - -n = 100 #100 datapoints -M = 5 #size of each minibatch -m = int(n/M) #number of minibatches -n_epochs = 500 #number of epochs -t0 = 1.0 -t1 = 10 - -gamma_j = t0/t1 -j = 0 -for epoch in range(1,n_epochs+1): - for i in range(m): - k = np.random.randint(m) #Pick the k-th minibatch at random - #Compute the gradient using the data in minibatch Bk - #Compute new suggestion for beta - t = epoch*m+i - gamma_j = step_length(t,t0,t1) - j += 1 - -print("gamma_j after %d epochs: %g" % (n_epochs,gamma_j)) - -### Program for stochastic gradient - -# Importing various packages -from math import exp, sqrt -from random import random, seed -import numpy as np -import matplotlib.pyplot as plt -from sklearn.linear_model import SGDRegressor - -m = 100 -x = 2*np.random.rand(m,1) -y = 4+3*x+np.random.randn(m,1) - -X = np.c_[np.ones((m,1)), x] -theta_linreg = np.linalg.inv(X.T @ X) @ (X.T @ y) -print("Own inversion") -print(theta_linreg) -sgdreg = SGDRegressor(max_iter = 50, penalty=None, eta0=0.1) -sgdreg.fit(x,y.ravel()) -print("sgdreg from scikit") -print(sgdreg.intercept_, sgdreg.coef_) - - -theta = np.random.randn(2,1) -eta = 0.1 -Niterations = 1000 - - -for iter in range(Niterations): - gradients = 2.0/m*X.T @ ((X @ theta)-y) - theta -= eta*gradients -print("theta from own gd") -print(theta) - -xnew = np.array([[0],[2]]) -Xnew = np.c_[np.ones((2,1)), xnew] -ypredict = Xnew.dot(theta) -ypredict2 = Xnew.dot(theta_linreg) - - -n_epochs = 50 -t0, t1 = 5, 50 -def learning_schedule(t): - return t0/(t+t1) - -theta = np.random.randn(2,1) - -for epoch in range(n_epochs): - for i in range(m): - random_index = np.random.randint(m) - xi = X[random_index:random_index+1] - yi = y[random_index:random_index+1] - gradients = 2 * xi.T @ ((xi @ theta)-yi) - eta = learning_schedule(epoch*m+i) - theta = theta - eta*gradients -print("theta from own sdg") -print(theta) - -plt.plot(xnew, ypredict, "r-") -plt.plot(xnew, ypredict2, "b-") -plt.plot(x, y ,'ro') -plt.axis([0,2.0,0, 15.0]) -plt.xlabel(r'$x$') -plt.ylabel(r'$y$') -plt.title(r'Random numbers ') -plt.show() - -## Momentum based GD - -The stochastic gradient descent (SGD) is almost always used with a -*momentum* or inertia term that serves as a memory of the direction we -are moving in parameter space. This is typically implemented as -follows - -$$ -\mathbf{v}_{t}=\gamma \mathbf{v}_{t-1}+\eta_{t}\nabla_\theta E(\boldsymbol{\theta}_t) \nonumber -$$ - - -
- -$$ -\begin{equation} -\boldsymbol{\theta}_{t+1}= \boldsymbol{\theta}_t -\mathbf{v}_{t}, -\label{_auto1} \tag{2} -\end{equation} -$$ - -where we have introduced a momentum parameter $\gamma$, with -$0\le\gamma\le 1$, and for brevity we dropped the explicit notation to -indicate the gradient is to be taken over a different mini-batch at -each step. We call this algorithm gradient descent with momentum -(GDM). From these equations, it is clear that $\mathbf{v}_t$ is a -running average of recently encountered gradients and -$(1-\gamma)^{-1}$ sets the characteristic time scale for the memory -used in the averaging procedure. Consistent with this, when -$\gamma=0$, this just reduces down to ordinary SGD as discussed -earlier. An equivalent way of writing the updates is - -$$ -\Delta \boldsymbol{\theta}_{t+1} = \gamma \Delta \boldsymbol{\theta}_t -\ \eta_{t}\nabla_\theta E(\boldsymbol{\theta}_t), -$$ - -where we have defined $\Delta \boldsymbol{\theta}_{t}= \boldsymbol{\theta}_t-\boldsymbol{\theta}_{t-1}$. - - - -Let us try to get more intuition from these equations. It is helpful -to consider a simple physical analogy with a particle of mass $m$ -moving in a viscous medium with drag coefficient $\mu$ and potential -$E(\mathbf{w})$. If we denote the particle's position by $\mathbf{w}$, -then its motion is described by - -$$ -m {d^2 \mathbf{w} \over dt^2} + \mu {d \mathbf{w} \over dt }= -\nabla_w E(\mathbf{w}). -$$ - -We can discretize this equation in the usual way to get - -$$ -m { \mathbf{w}_{t+\Delta t}-2 \mathbf{w}_{t} +\mathbf{w}_{t-\Delta t} \over (\Delta t)^2}+\mu {\mathbf{w}_{t+\Delta t}- \mathbf{w}_{t} \over \Delta t} = -\nabla_w E(\mathbf{w}). -$$ - -Rearranging this equation, we can rewrite this as - -$$ -\Delta \mathbf{w}_{t +\Delta t}= - { (\Delta t)^2 \over m +\mu \Delta t} \nabla_w E(\mathbf{w})+ {m \over m +\mu \Delta t} \Delta \mathbf{w}_t. -$$ - -Notice that this equation is identical to previous one if we identify -the position of the particle, $\mathbf{w}$, with the parameters -$\boldsymbol{\theta}$. This allows us to identify the momentum -parameter and learning rate with the mass of the particle and the -viscous drag as: - -$$ -\gamma= {m \over m +\mu \Delta t }, \qquad \eta = {(\Delta t)^2 \over m +\mu \Delta t}. -$$ - -Thus, as the name suggests, the momentum parameter is proportional to -the mass of the particle and effectively provides inertia. -Furthermore, in the large viscosity/small learning rate limit, our -memory time scales as $(1-\gamma)^{-1} \approx m/(\mu \Delta t)$. - -Why is momentum useful? SGD momentum helps the gradient descent -algorithm gain speed in directions with persistent but small gradients -even in the presence of stochasticity, while suppressing oscillations -in high-curvature directions. This becomes especially important in -situations where the landscape is shallow and flat in some directions -and narrow and steep in others. It has been argued that first-order -methods (with appropriate initial conditions) can perform comparable -to more expensive second order methods, especially in the context of -complex deep learning models. - -These beneficial properties of momentum can sometimes become even more -pronounced by using a slight modification of the classical momentum -algorithm called Nesterov Accelerated Gradient (NAG). - -In the NAG algorithm, rather than calculating the gradient at the -current parameters, $\nabla_\theta E(\boldsymbol{\theta}_t)$, one -calculates the gradient at the expected value of the parameters given -our current momentum, $\nabla_\theta E(\boldsymbol{\theta}_t +\gamma -\mathbf{v}_{t-1})$. This yields the NAG update rule - -$$ -\mathbf{v}_{t}=\gamma \mathbf{v}_{t-1}+\eta_{t}\nabla_\theta E(\boldsymbol{\theta}_t +\gamma \mathbf{v}_{t-1}) \nonumber -$$ - - -
- -$$ -\begin{equation} -\boldsymbol{\theta}_{t+1}= \boldsymbol{\theta}_t -\mathbf{v}_{t}. -\label{_auto2} \tag{3} -\end{equation} -$$ - -One of the major advantages of NAG is that it allows for the use of a larger learning rate than GDM for the same choice of $\gamma$. - - - -In stochastic gradient descent, with and without momentum, we still -have to specify a schedule for tuning the learning rates $\eta_t$ -as a function of time. As discussed in the context of Newton's -method, this presents a number of dilemmas. The learning rate is -limited by the steepest direction which can change depending on the -current position in the landscape. To circumvent this problem, ideally -our algorithm would keep track of curvature and take large steps in -shallow, flat directions and small steps in steep, narrow directions. -Second-order methods accomplish this by calculating or approximating -the Hessian and normalizing the learning rate by the -curvature. However, this is very computationally expensive for -extremely large models. Ideally, we would like to be able to -adaptively change the step size to match the landscape without paying -the steep computational price of calculating or approximating -Hessians. - -Recently, a number of methods have been introduced that accomplish -this by tracking not only the gradient, but also the second moment of -the gradient. These methods include AdaGrad, AdaDelta, RMS-Prop, and -ADAM. - - -### RMS prop - -In RMS prop, in addition to keeping a running average of the first -moment of the gradient, we also keep track of the second moment -denoted by $\mathbf{s}_t=\mathbb{E}[\mathbf{g}_t^2]$. The update rule -for RMS prop is given by - - -
- -$$ -\begin{equation} -\mathbf{g}_t = \nabla_\theta E(\boldsymbol{\theta}) -\label{_auto3} \tag{4} -\end{equation} -$$ - -$$ -\mathbf{s}_t =\beta \mathbf{s}_{t-1} +(1-\beta)\mathbf{g}_t^2 \nonumber -$$ - -$$ -\boldsymbol{\theta}_{t+1}=\boldsymbol{\theta}_t - \eta_t { \mathbf{g}_t \over \sqrt{\mathbf{s}_t +\epsilon}}, \nonumber -$$ - -where $\beta$ controls the averaging time of the second moment and is -typically taken to be about $\beta=0.9$, $\eta_t$ is a learning rate -typically chosen to be $10^{-3}$, and $\epsilon\sim 10^{-8} $ is a -small regularization constant to prevent divergences. Multiplication -and division by vectors is understood as an element-wise operation. It -is clear from this formula that the learning rate is reduced in -directions where the norm of the gradient is consistently large. This -greatly speeds up the convergence by allowing us to use a larger -learning rate for flat directions. - -### ADAM optimizer - -A related algorithm is the ADAM optimizer. In ADAM, we keep a running -average of both the first and second moment of the gradient and use -this information to adaptively change the learning rate for different -parameters. In addition to keeping a running average of the first and -second moments of the gradient -(i.e. $\mathbf{m}_t=\mathbb{E}[\mathbf{g}_t]$ and -$\mathbf{s}_t=\mathbb{E}[\mathbf{g}^2_t]$, respectively), ADAM -performs an additional bias correction to account for the fact that we -are estimating the first two moments of the gradient using a running -average (denoted by the hats in the update rule below). The update -rule for ADAM is given by (where multiplication and division are once -again understood to be element-wise operations below) - - -
- -$$ -\begin{equation} -\mathbf{g}_t = \nabla_\theta E(\boldsymbol{\theta}) -\label{_auto4} \tag{5} -\end{equation} -$$ - -$$ -\mathbf{m}_t = \beta_1 \mathbf{m}_{t-1} + (1-\beta_1) \mathbf{g}_t \nonumber -$$ - -$$ -\mathbf{s}_t =\beta_2 \mathbf{s}_{t-1} +(1-\beta_2)\mathbf{g}_t^2 \nonumber -$$ - -$$ -\boldsymbol{\mathbf{m}}_t={\mathbf{m}_t \over 1-\beta_1^t} \nonumber -$$ - -$$ -\boldsymbol{\mathbf{s}}_t ={\mathbf{s}_t \over1-\beta_2^t} \nonumber -$$ - -$$ -\boldsymbol{\theta}_{t+1}=\boldsymbol{\theta}_t - \eta_t { \boldsymbol{\mathbf{m}}_t \over \sqrt{\boldsymbol{\mathbf{s}}_t} +\epsilon}, \nonumber -$$ - - -
- -$$ -\begin{equation} -\label{_auto5} \tag{6} -\end{equation} -$$ - -where $\beta_1$ and $\beta_2$ set the memory lifetime of the first and -second moment and are typically taken to be $0.9$ and $0.99$ -respectively, and $\eta$ and $\epsilon$ are identical to RMSprop. - -Like in RMSprop, the effective step size of a parameter depends on the -magnitude of its gradient squared. To understand this better, let us -rewrite this expression in terms of the variance -$\boldsymbol{\sigma}_t^2 = \boldsymbol{\mathbf{s}}_t - -(\boldsymbol{\mathbf{m}}_t)^2$. Consider a single parameter $\theta_t$. The -update rule for this parameter is given by - -$$ -\Delta \theta_{t+1}= -\eta_t { \boldsymbol{m}_t \over \sqrt{\sigma_t^2 + m_t^2 }+\epsilon}. -$$ - -## Practical tips - -* **Randomize the data when making mini-batches**. It is always important to randomly shuffle the data when forming mini-batches. Otherwise, the gradient descent method can fit spurious correlations resulting from the order in which data is presented. - -* **Transform your inputs**. Learning becomes difficult when our landscape has a mixture of steep and flat directions. One simple trick for minimizing these situations is to standardize the data by subtracting the mean and normalizing the variance of input variables. Whenever possible, also decorrelate the inputs. To understand why this is helpful, consider the case of linear regression. It is easy to show that for the squared error cost function, the Hessian of the cost function is just the correlation matrix between the inputs. Thus, by standardizing the inputs, we are ensuring that the landscape looks homogeneous in all directions in parameter space. Since most deep networks can be viewed as linear transformations followed by a non-linearity at each layer, we expect this intuition to hold beyond the linear case. - -* **Monitor the out-of-sample performance.** Always monitor the performance of your model on a validation set (a small portion of the training data that is held out of the training process to serve as a proxy for the test set. If the validation error starts increasing, then the model is beginning to overfit. Terminate the learning process. This *early stopping* significantly improves performance in many settings. - -* **Adaptive optimization methods don't always have good generalization.** Recent studies have shown that adaptive methods such as ADAM, RMSPorp, and AdaGrad tend to have poor generalization compared to SGD or SGD with momentum, particularly in the high-dimensional limit (i.e. the number of parameters exceeds the number of data points). Although it is not clear at this stage why these methods perform so well in training deep neural networks, simpler procedures like properly-tuned SGD may work as well or better in these applications. - -## Automatic differentiation - -[Automatic differentiation (AD)](https://en.wikipedia.org/wiki/Automatic_differentiation), -also called algorithmic -differentiation or computational differentiation,is a set of -techniques to numerically evaluate the derivative of a function -specified by a computer program. AD exploits the fact that every -computer program, no matter how complicated, executes a sequence of -elementary arithmetic operations (addition, subtraction, -multiplication, division, etc.) and elementary functions (exp, log, -sin, cos, etc.). By applying the chain rule repeatedly to these -operations, derivatives of arbitrary order can be computed -automatically, accurately to working precision, and using at most a -small constant factor more arithmetic operations than the original -program. - -Automatic differentiation is neither: - -* Symbolic differentiation, nor - -* Numerical differentiation (the method of finite differences). - -Symbolic differentiation can lead to inefficient code and faces the -difficulty of converting a computer program into a single expression, -while numerical differentiation can introduce round-off errors in the -discretization process and cancellation - - - -Python has tools for so-called **automatic differentiation**. -Consider the following example - -$$ -f(x) = \sin\left(2\pi x + x^2\right) -$$ - -which has the following derivative - -$$ -f'(x) = \cos\left(2\pi x + x^2\right)\left(2\pi + 2x\right) -$$ - -Using **autograd** we have - -import autograd.numpy as np - -# To do elementwise differentiation: -from autograd import elementwise_grad as egrad - -# To plot: -import matplotlib.pyplot as plt - - -def f(x): - return np.sin(2*np.pi*x + x**2) - -def f_grad_analytic(x): - return np.cos(2*np.pi*x + x**2)*(2*np.pi + 2*x) - -# Do the comparison: -x = np.linspace(0,1,1000) - -f_grad = egrad(f) - -computed = f_grad(x) -analytic = f_grad_analytic(x) - -plt.title('Derivative computed from Autograd compared with the analytical derivative') -plt.plot(x,computed,label='autograd') -plt.plot(x,analytic,label='analytic') - -plt.xlabel('x') -plt.ylabel('y') -plt.legend() - -plt.show() - -print("The max absolute difference is: %g"%(np.max(np.abs(computed - analytic)))) - -Here we -experiment with what kind of functions Autograd is capable -of finding the gradient of. The following Python functions are just -meant to illustrate what Autograd can do, but please feel free to -experiment with other, possibly more complicated, functions as well. - -import autograd.numpy as np -from autograd import grad - -def f1(x): - return x**3 + 1 - -f1_grad = grad(f1) - -# Remember to send in float as argument to the computed gradient from Autograd! -a = 1.0 - -# See the evaluated gradient at a using autograd: -print("The gradient of f1 evaluated at a = %g using autograd is: %g"%(a,f1_grad(a))) - -# Compare with the analytical derivative, that is f1'(x) = 3*x**2 -grad_analytical = 3*a**2 -print("The gradient of f1 evaluated at a = %g by finding the analytic expression is: %g"%(a,grad_analytical)) - -To differentiate with respect to two (or more) arguments of a Python -function, Autograd need to know at which variable the function if -being differentiated with respect to. - -import autograd.numpy as np -from autograd import grad -def f2(x1,x2): - return 3*x1**3 + x2*(x1 - 5) + 1 - -# By sending the argument 0, Autograd will compute the derivative w.r.t the first variable, in this case x1 -f2_grad_x1 = grad(f2,0) - -# ... and differentiate w.r.t x2 by sending 1 as an additional arugment to grad -f2_grad_x2 = grad(f2,1) - -x1 = 1.0 -x2 = 3.0 - -print("Evaluating at x1 = %g, x2 = %g"%(x1,x2)) -print("-"*30) - -# Compare with the analytical derivatives: - -# Derivative of f2 w.r.t x1 is: 9*x1**2 + x2: -f2_grad_x1_analytical = 9*x1**2 + x2 - -# Derivative of f2 w.r.t x2 is: x1 - 5: -f2_grad_x2_analytical = x1 - 5 - -# See the evaluated derivations: -print("The derivative of f2 w.r.t x1: %g"%( f2_grad_x1(x1,x2) )) -print("The analytical derivative of f2 w.r.t x1: %g"%( f2_grad_x1(x1,x2) )) - -print() - -print("The derivative of f2 w.r.t x2: %g"%( f2_grad_x2(x1,x2) )) -print("The analytical derivative of f2 w.r.t x2: %g"%( f2_grad_x2(x1,x2) )) - -Note that the grad function will not produce the true gradient of the function. The true gradient of a function with two or more variables will produce a vector, where each element is the function differentiated w.r.t a variable. - -import autograd.numpy as np -from autograd import grad -def f3(x): # Assumes x is an array of length 5 or higher - return 2*x[0] + 3*x[1] + 5*x[2] + 7*x[3] + 11*x[4]**2 - -f3_grad = grad(f3) - -x = np.linspace(0,4,5) - -# Print the computed gradient: -print("The computed gradient of f3 is: ", f3_grad(x)) - -# The analytical gradient is: (2, 3, 5, 7, 22*x[4]) -f3_grad_analytical = np.array([2, 3, 5, 7, 22*x[4]]) - -# Print the analytical gradient: -print("The analytical gradient of f3 is: ", f3_grad_analytical) - -Note that in this case, when sending an array as input argument, the -output from Autograd is another array. This is the true gradient of -the function, as opposed to the function in the previous example. By -using arrays to represent the variables, the output from Autograd -might be easier to work with, as the output is closer to what one -could expect form a gradient-evaluting function. - -import autograd.numpy as np -from autograd import grad -def f4(x): - return np.sqrt(1+x**2) + np.exp(x) + np.sin(2*np.pi*x) - -f4_grad = grad(f4) - -x = 2.7 - -# Print the computed derivative: -print("The computed derivative of f4 at x = %g is: %g"%(x,f4_grad(x))) - -# The analytical derivative is: x/sqrt(1 + x**2) + exp(x) + cos(2*pi*x)*2*pi -f4_grad_analytical = x/np.sqrt(1 + x**2) + np.exp(x) + np.cos(2*np.pi*x)*2*np.pi - -# Print the analytical gradient: -print("The analytical gradient of f4 at x = %g is: %g"%(x,f4_grad_analytical)) - -import autograd.numpy as np -from autograd import grad -def f5(x): - if x >= 0: - return x**2 - else: - return -3*x + 1 - -f5_grad = grad(f5) - -x = 2.7 - -# Print the computed derivative: -print("The computed derivative of f5 at x = %g is: %g"%(x,f5_grad(x))) - -1 -8 - -< -< -< -! -! -C -O -D -E -_ -B -L -O -C -K - - -p -y -c -o -d - -import autograd.numpy as np -from autograd import grad -# Both of the functions are implementation of the sum: sum(x**i) for i = 0, ..., 9 -# The analytical derivative is: sum(i*x**(i-1)) -f6_grad_analytical = 0 -for i in range(10): - f6_grad_analytical += i*x**(i-1) - -print("The analytical derivative of f6 at x = %g is: %g"%(x,f6_grad_analytical)) - -import autograd.numpy as np -from autograd import grad - -def f7(n): # Assume that n is an integer - if n == 1 or n == 0: - return 1 - else: - return n*f7(n-1) - -f7_grad = grad(f7) - -n = 2.0 - -print("The computed derivative of f7 at n = %d is: %g"%(n,f7_grad(n))) - -# The function f7 is an implementation of the factorial of n. -# By using the product rule, one can find that the derivative is: - -f7_grad_analytical = 0 -for i in range(int(n)-1): - tmp = 1 - for k in range(int(n)-1): - if k != i: - tmp *= (n - k) - f7_grad_analytical += tmp - -print("The analytical derivative of f7 at n = %d is: %g"%(n,f7_grad_analytical)) - -Note that if n is equal to zero or one, Autograd will give an error message. This message appears when the output is independent on input. - - -Autograd supports many features. However, there are some functions that are not supported (yet) by Autograd. - -Assigning a value to the variable being differentiated with respect to is an example thereof. - -#import autograd.numpy as np -#from autograd import grad -#def f8(x): # Assume x is an array -# x[2] = 3 -# return x*2 - -#f8_grad = grad(f8) - -#x = 8.4 - -#print("The derivative of f8 is:",f8_grad(x)) - -Here, Autograd tells us that an 'ArrayBox' does not support item assignment. The item assignment is done when the program tries to assign x[2] to the value 3. However, Autograd has implemented the computation of the derivative such that this assignment is not possible. - -import autograd.numpy as np -from autograd import grad -def f9(a): # Assume a is an array with 2 elements - b = np.array([1.0,2.0]) - return a.dot(b) - -f9_grad = grad(f9) - -x = np.array([1.0,0.0]) - -print("The derivative of f9 is:",f9_grad(x)) - -Here we are told that the 'dot' function does not belong to Autograd's -version of a Numpy array. To overcome this, an alternative syntax -which also computed the dot product can be used: - -import autograd.numpy as np -from autograd import grad -def f9_alternative(x): # Assume a is an array with 2 elements - b = np.array([1.0,2.0]) - return np.dot(x,b) # The same as x_1*b_1 + x_2*b_2 - -f9_alternative_grad = grad(f9_alternative) - -x = np.array([3.0,0.0]) - -print("The gradient of f9 is:",f9_alternative_grad(x)) - -# The analytical gradient of the dot product of vectors x and b with two elements (x_1,x_2) and (b_1, b_2) respectively -# w.r.t x is (b_1, b_2). - -The documentation recommends to avoid inplace operations such as - -a += b -a -= b -a*= b -a /=b - -More examples will be added, in particular how to compare autograd with own codes for the gradients. \ No newline at end of file diff --git a/doc/LectureNotes/_build/jupyter_execute/chapteroptimization_118_1.png b/doc/LectureNotes/_build/jupyter_execute/chapteroptimization_118_1.png deleted file mode 100644 index 6e794e28f..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapteroptimization_118_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapteroptimization_127_1.png b/doc/LectureNotes/_build/jupyter_execute/chapteroptimization_127_1.png deleted file mode 100644 index 2999003a5..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapteroptimization_127_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapteroptimization_141_1.png b/doc/LectureNotes/_build/jupyter_execute/chapteroptimization_141_1.png deleted file mode 100644 index 739adbf6e..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapteroptimization_141_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapteroptimization_141_2.png b/doc/LectureNotes/_build/jupyter_execute/chapteroptimization_141_2.png deleted file mode 100644 index 375f84294..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapteroptimization_141_2.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapteroptimization_177_0.png b/doc/LectureNotes/_build/jupyter_execute/chapteroptimization_177_0.png deleted file mode 100644 index f1f99208f..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapteroptimization_177_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapteroptimization_56_1.png b/doc/LectureNotes/_build/jupyter_execute/chapteroptimization_56_1.png deleted file mode 100644 index 17454c6f4..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapteroptimization_56_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapteroptimization_58_0.png b/doc/LectureNotes/_build/jupyter_execute/chapteroptimization_58_0.png deleted file mode 100644 index d2d459719..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapteroptimization_58_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/chapteroptimization_64_1.png b/doc/LectureNotes/_build/jupyter_execute/chapteroptimization_64_1.png deleted file mode 100644 index 62ce53a7f..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/chapteroptimization_64_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/linalg.ipynb b/doc/LectureNotes/_build/jupyter_execute/linalg.ipynb deleted file mode 100644 index 77ba1a1a3..000000000 --- a/doc/LectureNotes/_build/jupyter_execute/linalg.ipynb +++ /dev/null @@ -1,1557 +0,0 @@ -{ - "cells": [ - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "# Linear Algebra, Handling of Arrays and more Python Features\n", - "\n", - "## Introduction\n", - "\n", - "The aim of this set of lectures is to review some central linear algebra algorithms that we will need in our \n", - "data analysis part and in the construction of Machine Learning algorithms (ML). \n", - "This will allow us to introduce some central programming features of high-level languages like Python and \n", - "compiled languages like C++ and/or Fortran. \n", - "\n", - "As discussed in the introductory notes, these series of lectures focuses both on using\n", - "central Python packages like **tensorflow** and **scikit-learn** as well\n", - "as writing your own codes for some central ML algorithms. The\n", - "latter can be written in a language of your choice, be it Python, Julia, R,\n", - "Rust, C++, Fortran etc. In order to avoid confusion however, in these lectures we will limit our\n", - "attention to Python, C++ and Fortran. \n", - "\n", - "\n", - "## Important Matrix and vector handling packages\n", - "\n", - "There are several central software packages for linear algebra and eigenvalue problems. Several of the more\n", - "popular ones have been wrapped into ofter software packages like those from the widely used text **Numerical Recipes**. The original source codes in many of the available packages are often taken from the widely used\n", - "software package LAPACK, which follows two other popular packages\n", - "developed in the 1970s, namely EISPACK and LINPACK. We describe them shortly here.\n", - "\n", - " * LINPACK: package for linear equations and least square problems.\n", - "\n", - " * LAPACK:package for solving symmetric, unsymmetric and generalized eigenvalue problems. From LAPACK's website it is possible to download for free all source codes from this library. Both C/C++ and Fortran versions are available.\n", - "\n", - " * BLAS (I, II and III): (Basic Linear Algebra Subprograms) are routines that provide standard building blocks for performing basic vector and matrix operations. Blas I is vector operations, II vector-matrix operations and III matrix-matrix operations. Highly parallelized and efficient codes, all available for download from .\n", - "\n", - "When dealing with matrices and vectors a central issue is memory\n", - "handling and allocation. If our code is written in Python the way we\n", - "declare these objects and the way they are handled, interpreted and\n", - "used by say a linear algebra library, requires codes that interface\n", - "our Python program with such libraries. For Python programmers,\n", - "**Numpy** is by now the standard Python package for numerical arrays in\n", - "Python as well as the source of functions which act on these\n", - "arrays. These functions span from eigenvalue solvers to functions that\n", - "compute the mean value, variance or the covariance matrix. If you are\n", - "not familiar with how arrays are handled in say Python or compiled\n", - "languages like C++ and Fortran, the sections in this chapter may be\n", - "useful. For C++ programmer, **Armadillo** is widely used library for\n", - "linear algebra and eigenvalue problems. In addition it offers a\n", - "convenient way to handle and organize arrays. We discuss this library\n", - "as well. Before we proceed we believe it may be convenient to repeat some basic features of \n", - " matrices and vectors.\n", - "\n", - "\n", - "## Basic Matrix Features\n", - "\n", - "Matrix properties reminder" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbf{A} =\n", - " \\begin{bmatrix} a_{11} & a_{12} & a_{13} & a_{14} \\\\\n", - " a_{21} & a_{22} & a_{23} & a_{24} \\\\\n", - " a_{31} & a_{32} & a_{33} & a_{34} \\\\\n", - " a_{41} & a_{42} & a_{43} & a_{44}\n", - " \\end{bmatrix}\\qquad\n", - "\\mathbf{I} =\n", - " \\begin{bmatrix} 1 & 0 & 0 & 0 \\\\\n", - " 0 & 1 & 0 & 0 \\\\\n", - " 0 & 0 & 1 & 0 \\\\\n", - " 0 & 0 & 0 & 1\n", - " \\end{bmatrix}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The inverse of a matrix is defined by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbf{A}^{-1} \\cdot \\mathbf{A} = I\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "
Relations Name matrix elements
$A = A^{T}$ symmetric $a_{ij} = a_{ji}$
$A = \\left (A^{T} \\right )^{-1}$ real orthogonal $\\sum_k a_{ik} a_{jk} = \\sum_k a_{ki} a_{kj} = \\delta_{ij}$
$A = A^{ * }$ real matrix $a_{ij} = a_{ij}^{ * }$
$A = A^{\\dagger}$ hermitian $a_{ij} = a_{ji}^{ * }$
$A = \\left (A^{\\dagger} \\right )^{-1}$ unitary $\\sum_k a_{ik} a_{jk}^{ * } = \\sum_k a_{ki}^{ * } a_{kj} = \\delta_{ij}$
\n", - "### Some famous Matrices\n", - "\n", - " * Diagonal if $a_{ij}=0$ for $i\\ne j$\n", - "\n", - " * Upper triangular if $a_{ij}=0$ for $i > j$\n", - "\n", - " * Lower triangular if $a_{ij}=0$ for $i < j$\n", - "\n", - " * Upper Hessenberg if $a_{ij}=0$ for $i > j+1$\n", - "\n", - " * Lower Hessenberg if $a_{ij}=0$ for $i < j+1$\n", - "\n", - " * Tridiagonal if $a_{ij}=0$ for $|i -j| > 1$\n", - "\n", - " * Lower banded with bandwidth $p$: $a_{ij}=0$ for $i > j+p$\n", - "\n", - " * Upper banded with bandwidth $p$: $a_{ij}=0$ for $i < j+p$\n", - "\n", - " * Banded, block upper triangular, block lower triangular....\n", - "\n", - "Some Equivalent Statements. For an $N\\times N$ matrix $\\mathbf{A}$ the following properties are all equivalent\n", - "\n", - " * If the inverse of $\\mathbf{A}$ exists, $\\mathbf{A}$ is nonsingular.\n", - "\n", - " * The equation $\\mathbf{Ax}=0$ implies $\\mathbf{x}=0$.\n", - "\n", - " * The rows of $\\mathbf{A}$ form a basis of $R^N$.\n", - "\n", - " * The columns of $\\mathbf{A}$ form a basis of $R^N$.\n", - "\n", - " * $\\mathbf{A}$ is a product of elementary matrices.\n", - "\n", - " * $0$ is not eigenvalue of $\\mathbf{A}$.\n", - "\n", - "## Numpy and arrays\n", - "[Numpy](http://www.numpy.org/) provides an easy way to handle arrays in Python. The standard way to import this library is as" - ] - }, - { - "cell_type": "code", - "execution_count": 1, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "[-0.62370636 0.34673123 0.80408254 2.08638654 1.16894795 1.8464107\n", - " 0.13620973 -1.33881021 -0.05404886 -0.99995891]\n" - ] - } - ], - "source": [ - "import numpy as np\n", - "n = 10\n", - "x = np.random.normal(size=n)\n", - "print(x)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Here we have defined a vector $x$ with $n=10$ elements with its values given by the Normal distribution $N(0,1)$.\n", - "Another alternative is to declare a vector as follows" - ] - }, - { - "cell_type": "code", - "execution_count": 2, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "[1 2 3]\n" - ] - } - ], - "source": [ - "import numpy as np\n", - "x = np.array([1, 2, 3])\n", - "print(x)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Here we have defined a vector with three elements, with $x_0=1$, $x_1=2$ and $x_2=3$. Note that both Python and C++\n", - "start numbering array elements from $0$ and on. This means that a vector with $n$ elements has a sequence of entities $x_0, x_1, x_2, \\dots, x_{n-1}$. We could also let (recommended) Numpy to compute the logarithms of a specific array as" - ] - }, - { - "cell_type": "code", - "execution_count": 3, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "[1.38629436 1.94591015 2.07944154]\n" - ] - } - ], - "source": [ - "import numpy as np\n", - "x = np.log(np.array([4, 7, 8]))\n", - "print(x)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Here we have used Numpy's unary function $np.log$. This function is\n", - "highly tuned to compute array elements since the code is vectorized\n", - "and does not require looping. We normaly recommend that you use the\n", - "Numpy intrinsic functions instead of the corresponding **log** function\n", - "from Python's **math** module. The looping is done explicitely by the\n", - "**np.log** function. The alternative, and slower way to compute the\n", - "logarithms of a vector would be to write" - ] - }, - { - "cell_type": "code", - "execution_count": 4, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "[1 1 2]\n" - ] - } - ], - "source": [ - "import numpy as np\n", - "from math import log\n", - "x = np.array([4, 7, 8])\n", - "for i in range(0, len(x)):\n", - " x[i] = log(x[i])\n", - "print(x)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We note that our code is much longer already and we need to import the **log** function from the **math** module. \n", - "The attentive reader will also notice that the output is $[1, 1, 2]$. Python interprets automacally our numbers as integers (like the **automatic** keyword in C++). To change this we could define our array elements to be double precision numbers as" - ] - }, - { - "cell_type": "code", - "execution_count": 5, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "[1.38629436 1.94591015 2.07944154]\n" - ] - } - ], - "source": [ - "import numpy as np\n", - "x = np.log(np.array([4, 7, 8], dtype = np.float64))\n", - "print(x)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "or simply write them as double precision numbers (Python uses 64 bits as default for floating point type variables), that is" - ] - }, - { - "cell_type": "code", - "execution_count": 6, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "ename": "SyntaxError", - "evalue": "invalid syntax (, line 3)", - "output_type": "error", - "traceback": [ - "\u001b[0;36m File \u001b[0;32m\"\"\u001b[0;36m, line \u001b[0;32m3\u001b[0m\n\u001b[0;31m print(x)\u001b[0m\n\u001b[0m ^\u001b[0m\n\u001b[0;31mSyntaxError\u001b[0m\u001b[0;31m:\u001b[0m invalid syntax\n" - ] - } - ], - "source": [ - "import numpy as np\n", - "x = np.log(np.array([4.0, 7.0, 8.0])\n", - "print(x)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "To check the number of bytes (remember that one byte contains eight bits for double precision variables), you can use simple use the **itemsize** functionality (the array $x$ is actually an object which inherits the functionalities defined in Numpy) as" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import numpy as np\n", - "x = np.log(np.array([4.0, 7.0, 8.0])\n", - "print(x.itemsize)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Having defined vectors, we are now ready to try out matrices. We can define a $3 \\times 3 $ real matrix $\\hat{A}$\n", - "as (recall that we user lowercase letters for vectors and uppercase letters for matrices)" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import numpy as np\n", - "A = np.log(np.array([ [4.0, 7.0, 8.0], [3.0, 10.0, 11.0], [4.0, 5.0, 7.0] ]))\n", - "print(A)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "If we use the **shape** function we would get $(3, 3)$ as output, that is verifying that our matrix is a $3\\times 3$ matrix. We can slice the matrix and print for example the first column (Python organized matrix elements in a row-major order, see below) as" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import numpy as np\n", - "A = np.log(np.array([ [4.0, 7.0, 8.0], [3.0, 10.0, 11.0], [4.0, 5.0, 7.0] ]))\n", - "# print the first column, row-major order and elements start with 0\n", - "print(A[:,0])" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We can continue this was by printing out other columns or rows. The example here prints out the second column" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import numpy as np\n", - "A = np.log(np.array([ [4.0, 7.0, 8.0], [3.0, 10.0, 11.0], [4.0, 5.0, 7.0] ]))\n", - "# print the first column, row-major order and elements start with 0\n", - "print(A[1,:])" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Numpy contains many other functionalities that allow us to slice, subdivide etc etc arrays. We strongly recommend that you look up the [Numpy website for more details](http://www.numpy.org/). Useful functions when defining a matrix are the **np.zeros** function which declares a matrix of a given dimension and sets all elements to zero" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import numpy as np\n", - "n = 10\n", - "# define a matrix of dimension 10 x 10 and set all elements to zero\n", - "A = np.zeros( (n, n) )\n", - "print(A)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "or initializing all elements to" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import numpy as np\n", - "n = 10\n", - "# define a matrix of dimension 10 x 10 and set all elements to one\n", - "A = np.ones( (n, n) )\n", - "print(A)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "or as unitarily distributed random numbers (see the material on random number generators in the statistics part)" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "import numpy as np\n", - "n = 10\n", - "# define a matrix of dimension 10 x 10 and set all elements to random numbers with x \\in [0, 1]\n", - "A = np.random.rand(n, n)\n", - "print(A)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "As we will see throughout these lectures, there are several extremely useful functionalities in Numpy.\n", - "As an example, consider the discussion of the covariance matrix. Suppose we have defined three vectors\n", - "$\\hat{x}, \\hat{y}, \\hat{z}$ with $n$ elements each. The covariance matrix is defined as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\hat{\\Sigma} = \\begin{bmatrix} \\sigma_{xx} & \\sigma_{xy} & \\sigma_{xz} \\\\\n", - " \\sigma_{yx} & \\sigma_{yy} & \\sigma_{yz} \\\\\n", - " \\sigma_{zx} & \\sigma_{zy} & \\sigma_{zz} \n", - " \\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where for example" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\sigma_{xy} =\\frac{1}{n} \\sum_{i=0}^{n-1}(x_i- \\overline{x})(y_i- \\overline{y}).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The Numpy function **np.cov** calculates the covariance elements using the factor $1/(n-1)$ instead of $1/n$ since it assumes we do not have the exact mean values. For a more in-depth discussion of the covariance and covariance matrix and its meaning, we refer you to the lectures on statistics. \n", - "The following simple function uses the **np.vstack** function which takes each vector of dimension $1\\times n$ and produces a $ 3\\times n$ matrix $\\hat{W}$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\hat{W} = \\begin{bmatrix} x_0 & y_0 & z_0 \\\\\n", - " x_1 & y_1 & z_1 \\\\\n", - " x_2 & y_2 & z_2 \\\\\n", - " \\dots & \\dots & \\dots \\\\\n", - " x_{n-2} & y_{n-2} & z_{n-2} \\\\\n", - " x_{n-1} & y_{n-1} & z_{n-1}\n", - " \\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which in turn is converted into into the $3 times 3$ covariance matrix\n", - "$\\hat{\\Sigma}$ via the Numpy function **np.cov()**. In our review of\n", - "statistical functions and quantities we will discuss more about the\n", - "meaning of the covariance matrix. Here we note that we can calculate\n", - "the mean value of each set of samples $\\hat{x}$ etc using the Numpy\n", - "function **np.mean(x)**. We can also extract the eigenvalues of the\n", - "covariance matrix through the **np.linalg.eig()** function." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "# Importing various packages\n", - "import numpy as np\n", - "\n", - "n = 100\n", - "x = np.random.normal(size=n)\n", - "print(np.mean(x))\n", - "y = 4+3*x+np.random.normal(size=n)\n", - "print(np.mean(y))\n", - "z = x**3+np.random.normal(size=n)\n", - "print(np.mean(z))\n", - "W = np.vstack((x, y, z))\n", - "Sigma = np.cov(W)\n", - "print(Sigma)\n", - "Eigvals, Eigvecs = np.linalg.eig(Sigma)\n", - "print(Eigvals)" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "%matplotlib inline\n", - "\n", - "import numpy as np\n", - "import matplotlib.pyplot as plt\n", - "from scipy import sparse\n", - "eye = np.eye(4)\n", - "print(eye)\n", - "sparse_mtx = sparse.csr_matrix(eye)\n", - "print(sparse_mtx)\n", - "x = np.linspace(-10,10,100)\n", - "y = np.sin(x)\n", - "plt.plot(x,y,marker='x')\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Other Matrix and Vector Operations\n", - "\n", - "The following examples show how to compute various quantities like the **mean** value of a matrix or a vector and how to use functions like **reshape** and **ravel**. These are all useful quantities when scaling the data and preparing the data for various machine learning algorithms and when calculating quantities like the mean squared error or the variance." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [], - "source": [ - "\"\"\"\n", - "Simple code that tests various numpy functions\n", - "\"\"\"\n", - "\n", - "import numpy as np\n", - "# Simple test-matrix of dim 3 x 4\n", - "a = np.array([ [1, 2, 3], [4, 5, 6], [7, 8, 9],[10, 11, 12]],dtype=np.float64)\n", - "print(f\"The test matrix:{a}\")\n", - "# This is the total mean summed over all elements, which here has to be 6.5\n", - "print(f\"This is the total mean summed over all elements:{np.mean(a,dtype=np.float64)}\")\n", - "# This is the mean for each column, it returns an array with the mean values for each column. It returns a row-like vector\n", - "print(f\"This is the mean for each column:{np.mean(a, axis=0, keepdims=True,dtype=np.float64)}\")\n", - "# This is the mean value for each row, it returns an array via the keepdims option which is a column-like vector if\n", - "# keepdims=True. Else it return a row-like vector\n", - "# Try setting keepdims=False\n", - "print(f\"This is the mean value for each row:{np.mean(a, axis=1, keepdims=True,dtype=np.float64)}\")\n", - "# We print then the mean value for each row by setting keepdims=False\n", - "print(f\"This is the mean value for each row with keepdims false:{np.mean(a, axis=1, keepdims=False,dtype=np.float64)}\")\n", - "\n", - "# Ravel return a contiguous flattened array.\n", - "print(f\"Flatten the matrix:{np.ravel(a)}\")\n", - "# It is the same as reshaping the matrix into a one-dimensional array\n", - "print(f\"Reshape the matrix to a one-dim array:{a.reshape(-1)}\")\n", - "# ‘C’ means to index the elements in row-major, C-style order, with the last axis index changing fastest, back to the first axis index changing slowest.\n", - "# ‘F’ means to index the elements in column-major, Fortran-style order, with the first index changing fastest, and the last index changing slowest \n", - "print(np.ravel(a, order='F'))\n", - "# When order is ‘A’, it will preserve the array’s ‘C’ or ‘F’ ordering\n", - "# ‘A’ means to read the elements in Fortran-like index order if a is Fortran contiguous in memory, C-like order otherwise.\n", - "# ‘K’ means to read the elements in the order they occur in memory, except for reversing the data when strides are negative. By default, ‘C’ index order is used.\n", - "# Transposing it\n", - "print(np.ravel(a.T))\n", - "print(np.ravel(a.T, order='A'))" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Gaussian Elimination\n", - "\n", - "We start with the linear set of equations" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbf{A}\\mathbf{x} = \\mathbf{w}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We assume also that the matrix $\\mathbf{A}$ is non-singular and that the\n", - "matrix elements along the diagonal satisfy $a_{ii} \\ne 0$. Simple $4\\times 4 $ example" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{bmatrix}\n", - " a_{11}& a_{12} &a_{13}& a_{14}\\\\\n", - " a_{21}& a_{22} &a_{23}& a_{24}\\\\\n", - " a_{31}& a_{32} &a_{33}& a_{34}\\\\\n", - " a_{41}& a_{42} &a_{43}& a_{44}\\\\\n", - " \\end{bmatrix} \\begin{bmatrix}\n", - " x_1\\\\\n", - " x_2\\\\\n", - " x_3 \\\\\n", - " x_4 \\\\\n", - " \\end{bmatrix}\n", - " =\\begin{bmatrix}\n", - " w_1\\\\\n", - " w_2\\\\\n", - " w_3 \\\\\n", - " w_4\\\\\n", - " \\end{bmatrix}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "or" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "a_{11}x_1 +a_{12}x_2 +a_{13}x_3 + a_{14}x_4=w_1 \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "a_{21}x_1 + a_{22}x_2 + a_{23}x_3 + a_{24}x_4=w_2 \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "a_{31}x_1 + a_{32}x_2 + a_{33}x_3 + a_{34}x_4=w_3 \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "a_{41}x_1 + a_{42}x_2 + a_{43}x_3 + a_{44}x_4=w_4. \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The basic idea of Gaussian elimination is to use the first equation to eliminate the first unknown $x_1$\n", - "from the remaining $n-1$ equations. Then we use the new second equation to eliminate the second unknown\n", - "$x_2$ from the remaining $n-2$ equations. With $n-1$ such eliminations\n", - "we obtain a so-called upper triangular set of equations of the form" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "b_{11}x_1 +b_{12}x_2 +b_{13}x_3 + b_{14}x_4=y_1 \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "b_{22}x_2 + b_{23}x_3 + b_{24}x_4=y_2 \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "b_{33}x_3 + b_{34}x_4=y_3 \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "b_{44}x_4=y_4. \\nonumber\n", - "\\label{eq:gaussbacksub} \\tag{1}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We can solve this system of equations recursively starting from $x_n$ (in our case $x_4$) and proceed with\n", - "what is called a backward substitution. \n", - "\n", - "\n", - "This process can be expressed mathematically as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - " x_m = \\frac{1}{b_{mm}}\\left(y_m-\\sum_{k=m+1}^nb_{mk}x_k\\right)\\quad m=n-1,n-2,\\dots,1.\n", - "\\label{_auto1} \\tag{2}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "To arrive at such an upper triangular system of equations, we start by eliminating\n", - "the unknown $x_1$ for $j=2,n$. We achieve this by multiplying the first equation by $a_{j1}/a_{11}$ and then subtract\n", - "the result from the $j$th equation. We assume obviously that $a_{11}\\ne 0$ and that\n", - "$\\mathbf{A}$ is not singular.\n", - "\n", - "\n", - "Our actual $4\\times 4$ example reads after the first operation" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{bmatrix}\n", - " a_{11}& a_{12} &a_{13}& a_{14}\\\\\n", - " 0& (a_{22}-\\frac{a_{21}a_{12}}{a_{11}}) &(a_{23}-\\frac{a_{21}a_{13}}{a_{11}}) & (a_{24}-\\frac{a_{21}a_{14}}{a_{11}})\\\\\n", - "0& (a_{32}-\\frac{a_{31}a_{12}}{a_{11}})& (a_{33}-\\frac{a_{31}a_{13}}{a_{11}})& (a_{34}-\\frac{a_{31}a_{14}}{a_{11}})\\\\\n", - "0&(a_{42}-\\frac{a_{41}a_{12}}{a_{11}}) &(a_{43}-\\frac{a_{41}a_{13}}{a_{11}}) & (a_{44}-\\frac{a_{41}a_{14}}{a_{11}}) \\\\\n", - " \\end{bmatrix} \\begin{bmatrix}\n", - " x_1\\\\\n", - " x_2\\\\\n", - " x_3 \\\\\n", - " x_4 \\\\\n", - " \\end{bmatrix} \n", - " =\\begin{bmatrix}\n", - " y_1\\\\\n", - " w_2^{(2)}\\\\\n", - " w_3^{(2)} \\\\\n", - " w_4^{(2)}\\\\\n", - " \\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "or" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "b_{11}x_1 +b_{12}x_2 +b_{13}x_3 + b_{14}x_4=y_1 \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "a^{(2)}_{22}x_2 + a^{(2)}_{23}x_3 + a^{(2)}_{24}x_4=w^{(2)}_2 \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "a^{(2)}_{32}x_2 + a^{(2)}_{33}x_3 + a^{(2)}_{34}x_4=w^{(2)}_3 \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "a^{(2)}_{42}x_2 + a^{(2)}_{43}x_3 + a^{(2)}_{44}x_4=w^{(2)}_4, \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation} \n", - "\\label{_auto2} \\tag{3}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The new coefficients are" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - " b_{1k} = a_{1k}^{(1)} \\quad k=1,\\dots,n,\n", - "\\label{_auto3} \\tag{4}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where each $a_{1k}^{(1)}$ is equal to the original $a_{1k}$ element. The other coefficients are" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - "a_{jk}^{(2)} = a_{jk}^{(1)}-\\frac{a_{j1}^{(1)}a_{1k}^{(1)}}{a_{11}^{(1)}} \\quad j,k=2,\\dots,n,\n", - "\\label{_auto4} \\tag{5}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with a new right-hand side given by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - "y_{1}=w_1^{(1)}, \\quad w_j^{(2)} =w_j^{(1)}-\\frac{a_{j1}^{(1)}w_1^{(1)}}{a_{11}^{(1)}} \\quad j=2,\\dots,n.\n", - "\\label{_auto5} \\tag{6}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We have also set $w_1^{(1)}=w_1$, the original vector element.\n", - "We see that the system of unknowns $x_1,\\dots,x_n$ is transformed into an $(n-1)\\times (n-1)$ problem.\n", - "\n", - "\n", - "\n", - "This step is called forward substitution.\n", - "Proceeding with these substitutions, we obtain the\n", - "general expressions for the new coefficients" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - " a_{jk}^{(m+1)} = a_{jk}^{(m)}-\\frac{a_{jm}^{(m)}a_{mk}^{(m)}}{a_{mm}^{(m)}} \\quad j,k=m+1,\\dots,n,\n", - "\\label{_auto6} \\tag{7}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with $m=1,\\dots,n-1$ and a\n", - "right-hand side given by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - " w_j^{(m+1)} =w_j^{(m)}-\\frac{a_{jm}^{(m)}w_m^{(m)}}{a_{mm}^{(m)}}\\quad j=m+1,\\dots,n.\n", - "\\label{_auto7} \\tag{8}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "This set of $n-1$ elimations leads us to an equations which is solved by back substitution.\n", - "If the arithmetics is exact and the matrix $\\mathbf{A}$ is not singular, then the computed answer will be exact.\n", - "\n", - "Even though the matrix elements along the diagonal are not zero,\n", - "numerically small numbers may appear and subsequent divisions may lead to large numbers, which, if added\n", - "to a small number may yield losses of precision. Suppose for example that our first division in $(a_{22}-a_{21}a_{12}/a_{11})$\n", - "results in $-10^{-7}$ and that $a_{22}$ is one.\n", - "one. We are then\n", - "adding $10^7+1$. With single precision this results in $10^7$.\n", - "\n", - "\n", - "\n", - "\n", - " * Gaussian elimination, $O(2/3n^3)$ flops, general matrix\n", - "\n", - " * LU decomposition, upper triangular and lower tridiagonal matrices, $O(2/3n^3)$ flops, general matrix. Get easily the inverse, determinant and can solve linear equations with back-substitution only, $O(n^2)$ flops\n", - "\n", - " * Cholesky decomposition. Real symmetric or hermitian positive definite matrix, $O(1/3n^3)$ flops.\n", - "\n", - " * Tridiagonal linear systems, important for differential equations. Normally positive definite and non-singular. $O(8n)$ flops for symmetric. Special case of banded matrices.\n", - "\n", - " * Singular value decomposition\n", - "\n", - " * the QR method will be discussed in chapter 7 in connection with eigenvalue systems. $O(4/3n^3)$ flops.\n", - "\n", - "The LU decomposition method means that we can rewrite\n", - "this matrix as the product of two matrices $\\mathbf{L}$ and $\\mathbf{U}$\n", - "where" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{bmatrix}\n", - " a_{11} & a_{12} & a_{13} & a_{14} \\\\\n", - " a_{21} & a_{22} & a_{23} & a_{24} \\\\\n", - " a_{31} & a_{32} & a_{33} & a_{34} \\\\\n", - " a_{41} & a_{42} & a_{43} & a_{44}\n", - " \\end{bmatrix}\n", - " = \\begin{bmatrix}\n", - " 1 & 0 & 0 & 0 \\\\\n", - " l_{21} & 1 & 0 & 0 \\\\\n", - " l_{31} & l_{32} & 1 & 0 \\\\\n", - " l_{41} & l_{42} & l_{43} & 1\n", - " \\end{bmatrix}\n", - " \\begin{bmatrix}\n", - " u_{11} & u_{12} & u_{13} & u_{14} \\\\\n", - " 0 & u_{22} & u_{23} & u_{24} \\\\\n", - " 0 & 0 & u_{33} & u_{34} \\\\\n", - " 0 & 0 & 0 & u_{44}\n", - " \\end{bmatrix}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "LU decomposition forms the backbone of other algorithms in linear algebra, such as the\n", - "solution of linear equations given by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "a_{11}x_1 +a_{12}x_2 +a_{13}x_3 + a_{14}x_4=w_1 \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "a_{21}x_1 + a_{22}x_2 + a_{23}x_3 + a_{24}x_4=w_2 \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "a_{31}x_1 + a_{32}x_2 + a_{33}x_3 + a_{34}x_4=w_3 \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "a_{41}x_1 + a_{42}x_2 + a_{43}x_3 + a_{44}x_4=w_4. \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The above set of equations is conveniently solved by using LU decomposition as an intermediate step.\n", - "\n", - "The matrix $\\mathbf{A}\\in \\mathbb{R}^{n\\times n}$ has an LU factorization if the determinant\n", - "is different from zero. If the LU factorization exists and $\\mathbf{A}$ is non-singular, then the LU factorization\n", - "is unique and the determinant is given by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "det\\{\\mathbf{A}\\}=det\\{\\mathbf{LU}\\}= det\\{\\mathbf{L}\\}det\\{\\mathbf{U}\\}=u_{11}u_{22}\\dots u_{nn}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "There are at least three main advantages with LU decomposition compared with standard Gaussian elimination:\n", - "\n", - " * It is straightforward to compute the determinant of a matrix\n", - "\n", - " * If we have to solve sets of linear equations with the same matrix but with different vectors $\\mathbf{y}$, the number of FLOPS is of the order $n^3$.\n", - "\n", - " * The inverse is such an operation \n", - "\n", - "With the LU decomposition it is rather\n", - "simple to solve a system of linear equations" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "a_{11}x_1 +a_{12}x_2 +a_{13}x_3 + a_{14}x_4=w_1 \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "a_{21}x_1 + a_{22}x_2 + a_{23}x_3 + a_{24}x_4=w_2 \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "a_{31}x_1 + a_{32}x_2 + a_{33}x_3 + a_{34}x_4=w_3 \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "a_{41}x_1 + a_{42}x_2 + a_{43}x_3 + a_{44}x_4=w_4. \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "This can be written in matrix form as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbf{Ax}=\\mathbf{w}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $\\mathbf{A}$ and $\\mathbf{w}$ are known and we have to solve for\n", - "$\\mathbf{x}$. Using the LU dcomposition we write" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbf{A} \\mathbf{x} \\equiv \\mathbf{L} \\mathbf{U} \\mathbf{x} =\\mathbf{w}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The previous equation can be calculated in two steps" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbf{L} \\mathbf{y} = \\mathbf{w};\\qquad \\mathbf{Ux}=\\mathbf{y}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "To show that this is correct we use to the LU decomposition\n", - "to rewrite our system of linear equations as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbf{LUx}=\\mathbf{w},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and since the determinant of $\\mathbf{L}$ is equal to 1 (by construction\n", - "since the diagonals of $\\mathbf{L}$ equal 1) we can use the inverse of\n", - "$\\mathbf{L}$ to obtain" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbf{Ux}=\\mathbf{L^{-1}w}=\\mathbf{y},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which yields the intermediate step" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbf{L^{-1}w}=\\mathbf{y}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and as soon as we have $\\mathbf{y}$ we can obtain $\\mathbf{x}$\n", - "through $\\mathbf{Ux}=\\mathbf{y}$.\n", - "\n", - "\n", - "For our four-dimentional example this takes the form" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "y_1=w_1 \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "l_{21}y_1 + y_2=w_2\\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "l_{31}y_1 + l_{32}y_2 + y_3 =w_3\\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "l_{41}y_1 + l_{42}y_2 + l_{43}y_3 + y_4=w_4. \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "u_{11}x_1 +u_{12}x_2 +u_{13}x_3 + u_{14}x_4=y_1 \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "u_{22}x_2 + u_{23}x_3 + u_{24}x_4=y_2\\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "u_{33}x_3 + u_{34}x_4=y_3\\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "u_{44}x_4=y_4 \\nonumber\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "This example shows the basis for the algorithm\n", - "needed to solve the set of $n$ linear equations.\n", - "\n", - "\n", - "\n", - "The algorithm goes as follows\n", - "\n", - " * Set up the matrix $\\bf A$ and the vector $\\bf w$ with their correct dimensions. This determines the dimensionality of the unknown vector $\\bf x$.\n", - "\n", - " * Then LU decompose the matrix $\\bf A$ through a call to the function `ludcmp(double a, int n, int indx, double &d)`. This functions returns the LU decomposed matrix $\\bf A$, its determinant and the vector indx which keeps track of the number of interchanges of rows. If the determinant is zero, the solution is malconditioned.\n", - "\n", - " * Thereafter you call the function `lubksb(double a, int n, int indx, double w)` which uses the LU decomposed matrix $\\bf A$ and the vector $\\bf w$ and returns $\\bf x$ in the same place as $\\bf w$. Upon exit the original content in $\\bf w$ is destroyed. If you wish to keep this information, you should make a backup of it in your calling function.\n", - "\n", - "### LU Decomposition, the inverse of a matrix\n", - "\n", - "If the inverse exists then" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbf{A}^{-1}\\mathbf{A}=\\mathbf{I},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "the identity matrix. With an LU decomposed matrix we can rewrite the last equation as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbf{LU}\\mathbf{A}^{-1}=\\mathbf{I}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "If we assume that the first column (that is column 1) of the inverse matrix\n", - "can be written as a vector with unknown entries" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbf{A}_1^{-1}= \\begin{bmatrix}\n", - " a_{11}^{-1} \\\\\n", - " a_{21}^{-1} \\\\\n", - " \\dots \\\\\n", - " a_{n1}^{-1} \\\\\n", - " \\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "then we have a linear set of equations" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbf{LU}\\begin{bmatrix}\n", - " a_{11}^{-1} \\\\\n", - " a_{21}^{-1} \\\\\n", - " \\dots \\\\\n", - " a_{n1}^{-1} \\\\\n", - " \\end{bmatrix} =\\begin{bmatrix}\n", - " 1 \\\\\n", - " 0 \\\\\n", - " \\dots \\\\\n", - " 0 \\\\\n", - " \\end{bmatrix}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In a similar way we can compute the unknow entries of the second column," - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathbf{LU}\\begin{bmatrix}\n", - " a_{12}^{-1} \\\\\n", - " a_{22}^{-1} \\\\\n", - " \\dots \\\\\n", - " a_{n2}^{-1} \\\\\n", - " \\end{bmatrix}=\\begin{bmatrix}\n", - " 0 \\\\\n", - " 1 \\\\\n", - " \\dots \\\\\n", - " 0 \\\\\n", - " \\end{bmatrix},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and continue till we have solved all $n$ sets of linear equations." - ] - } - ], - "metadata": { - "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.8.5" - } - }, - "nbformat": 4, - "nbformat_minor": 4 -} \ No newline at end of file diff --git a/doc/LectureNotes/_build/jupyter_execute/linalg.py b/doc/LectureNotes/_build/jupyter_execute/linalg.py deleted file mode 100644 index 09f19dcd1..000000000 --- a/doc/LectureNotes/_build/jupyter_execute/linalg.py +++ /dev/null @@ -1,796 +0,0 @@ -# Linear Algebra, Handling of Arrays and more Python Features - -## Introduction - -The aim of this set of lectures is to review some central linear algebra algorithms that we will need in our -data analysis part and in the construction of Machine Learning algorithms (ML). -This will allow us to introduce some central programming features of high-level languages like Python and -compiled languages like C++ and/or Fortran. - -As discussed in the introductory notes, these series of lectures focuses both on using -central Python packages like **tensorflow** and **scikit-learn** as well -as writing your own codes for some central ML algorithms. The -latter can be written in a language of your choice, be it Python, Julia, R, -Rust, C++, Fortran etc. In order to avoid confusion however, in these lectures we will limit our -attention to Python, C++ and Fortran. - - -## Important Matrix and vector handling packages - -There are several central software packages for linear algebra and eigenvalue problems. Several of the more -popular ones have been wrapped into ofter software packages like those from the widely used text **Numerical Recipes**. The original source codes in many of the available packages are often taken from the widely used -software package LAPACK, which follows two other popular packages -developed in the 1970s, namely EISPACK and LINPACK. We describe them shortly here. - - * LINPACK: package for linear equations and least square problems. - - * LAPACK:package for solving symmetric, unsymmetric and generalized eigenvalue problems. From LAPACK's website it is possible to download for free all source codes from this library. Both C/C++ and Fortran versions are available. - - * BLAS (I, II and III): (Basic Linear Algebra Subprograms) are routines that provide standard building blocks for performing basic vector and matrix operations. Blas I is vector operations, II vector-matrix operations and III matrix-matrix operations. Highly parallelized and efficient codes, all available for download from . - -When dealing with matrices and vectors a central issue is memory -handling and allocation. If our code is written in Python the way we -declare these objects and the way they are handled, interpreted and -used by say a linear algebra library, requires codes that interface -our Python program with such libraries. For Python programmers, -**Numpy** is by now the standard Python package for numerical arrays in -Python as well as the source of functions which act on these -arrays. These functions span from eigenvalue solvers to functions that -compute the mean value, variance or the covariance matrix. If you are -not familiar with how arrays are handled in say Python or compiled -languages like C++ and Fortran, the sections in this chapter may be -useful. For C++ programmer, **Armadillo** is widely used library for -linear algebra and eigenvalue problems. In addition it offers a -convenient way to handle and organize arrays. We discuss this library -as well. Before we proceed we believe it may be convenient to repeat some basic features of - matrices and vectors. - - -## Basic Matrix Features - -Matrix properties reminder - -$$ -\mathbf{A} = - \begin{bmatrix} a_{11} & a_{12} & a_{13} & a_{14} \\ - a_{21} & a_{22} & a_{23} & a_{24} \\ - a_{31} & a_{32} & a_{33} & a_{34} \\ - a_{41} & a_{42} & a_{43} & a_{44} - \end{bmatrix}\qquad -\mathbf{I} = - \begin{bmatrix} 1 & 0 & 0 & 0 \\ - 0 & 1 & 0 & 0 \\ - 0 & 0 & 1 & 0 \\ - 0 & 0 & 0 & 1 - \end{bmatrix} -$$ - -The inverse of a matrix is defined by - -$$ -\mathbf{A}^{-1} \cdot \mathbf{A} = I -$$ - - - - - - - - - - - - -
Relations Name matrix elements
$A = A^{T}$ symmetric $a_{ij} = a_{ji}$
$A = \left (A^{T} \right )^{-1}$ real orthogonal $\sum_k a_{ik} a_{jk} = \sum_k a_{ki} a_{kj} = \delta_{ij}$
$A = A^{ * }$ real matrix $a_{ij} = a_{ij}^{ * }$
$A = A^{\dagger}$ hermitian $a_{ij} = a_{ji}^{ * }$
$A = \left (A^{\dagger} \right )^{-1}$ unitary $\sum_k a_{ik} a_{jk}^{ * } = \sum_k a_{ki}^{ * } a_{kj} = \delta_{ij}$
-### Some famous Matrices - - * Diagonal if $a_{ij}=0$ for $i\ne j$ - - * Upper triangular if $a_{ij}=0$ for $i > j$ - - * Lower triangular if $a_{ij}=0$ for $i < j$ - - * Upper Hessenberg if $a_{ij}=0$ for $i > j+1$ - - * Lower Hessenberg if $a_{ij}=0$ for $i < j+1$ - - * Tridiagonal if $a_{ij}=0$ for $|i -j| > 1$ - - * Lower banded with bandwidth $p$: $a_{ij}=0$ for $i > j+p$ - - * Upper banded with bandwidth $p$: $a_{ij}=0$ for $i < j+p$ - - * Banded, block upper triangular, block lower triangular.... - -Some Equivalent Statements. For an $N\times N$ matrix $\mathbf{A}$ the following properties are all equivalent - - * If the inverse of $\mathbf{A}$ exists, $\mathbf{A}$ is nonsingular. - - * The equation $\mathbf{Ax}=0$ implies $\mathbf{x}=0$. - - * The rows of $\mathbf{A}$ form a basis of $R^N$. - - * The columns of $\mathbf{A}$ form a basis of $R^N$. - - * $\mathbf{A}$ is a product of elementary matrices. - - * $0$ is not eigenvalue of $\mathbf{A}$. - -## Numpy and arrays -[Numpy](http://www.numpy.org/) provides an easy way to handle arrays in Python. The standard way to import this library is as - -import numpy as np -n = 10 -x = np.random.normal(size=n) -print(x) - -Here we have defined a vector $x$ with $n=10$ elements with its values given by the Normal distribution $N(0,1)$. -Another alternative is to declare a vector as follows - -import numpy as np -x = np.array([1, 2, 3]) -print(x) - -Here we have defined a vector with three elements, with $x_0=1$, $x_1=2$ and $x_2=3$. Note that both Python and C++ -start numbering array elements from $0$ and on. This means that a vector with $n$ elements has a sequence of entities $x_0, x_1, x_2, \dots, x_{n-1}$. We could also let (recommended) Numpy to compute the logarithms of a specific array as - -import numpy as np -x = np.log(np.array([4, 7, 8])) -print(x) - -Here we have used Numpy's unary function $np.log$. This function is -highly tuned to compute array elements since the code is vectorized -and does not require looping. We normaly recommend that you use the -Numpy intrinsic functions instead of the corresponding **log** function -from Python's **math** module. The looping is done explicitely by the -**np.log** function. The alternative, and slower way to compute the -logarithms of a vector would be to write - -import numpy as np -from math import log -x = np.array([4, 7, 8]) -for i in range(0, len(x)): - x[i] = log(x[i]) -print(x) - -We note that our code is much longer already and we need to import the **log** function from the **math** module. -The attentive reader will also notice that the output is $[1, 1, 2]$. Python interprets automacally our numbers as integers (like the **automatic** keyword in C++). To change this we could define our array elements to be double precision numbers as - -import numpy as np -x = np.log(np.array([4, 7, 8], dtype = np.float64)) -print(x) - -or simply write them as double precision numbers (Python uses 64 bits as default for floating point type variables), that is - -import numpy as np -x = np.log(np.array([4.0, 7.0, 8.0]) -print(x) - -To check the number of bytes (remember that one byte contains eight bits for double precision variables), you can use simple use the **itemsize** functionality (the array $x$ is actually an object which inherits the functionalities defined in Numpy) as - -import numpy as np -x = np.log(np.array([4.0, 7.0, 8.0]) -print(x.itemsize) - -Having defined vectors, we are now ready to try out matrices. We can define a $3 \times 3 $ real matrix $\hat{A}$ -as (recall that we user lowercase letters for vectors and uppercase letters for matrices) - -import numpy as np -A = np.log(np.array([ [4.0, 7.0, 8.0], [3.0, 10.0, 11.0], [4.0, 5.0, 7.0] ])) -print(A) - -If we use the **shape** function we would get $(3, 3)$ as output, that is verifying that our matrix is a $3\times 3$ matrix. We can slice the matrix and print for example the first column (Python organized matrix elements in a row-major order, see below) as - -import numpy as np -A = np.log(np.array([ [4.0, 7.0, 8.0], [3.0, 10.0, 11.0], [4.0, 5.0, 7.0] ])) -# print the first column, row-major order and elements start with 0 -print(A[:,0]) - -We can continue this was by printing out other columns or rows. The example here prints out the second column - -import numpy as np -A = np.log(np.array([ [4.0, 7.0, 8.0], [3.0, 10.0, 11.0], [4.0, 5.0, 7.0] ])) -# print the first column, row-major order and elements start with 0 -print(A[1,:]) - -Numpy contains many other functionalities that allow us to slice, subdivide etc etc arrays. We strongly recommend that you look up the [Numpy website for more details](http://www.numpy.org/). Useful functions when defining a matrix are the **np.zeros** function which declares a matrix of a given dimension and sets all elements to zero - -import numpy as np -n = 10 -# define a matrix of dimension 10 x 10 and set all elements to zero -A = np.zeros( (n, n) ) -print(A) - -or initializing all elements to - -import numpy as np -n = 10 -# define a matrix of dimension 10 x 10 and set all elements to one -A = np.ones( (n, n) ) -print(A) - -or as unitarily distributed random numbers (see the material on random number generators in the statistics part) - -import numpy as np -n = 10 -# define a matrix of dimension 10 x 10 and set all elements to random numbers with x \in [0, 1] -A = np.random.rand(n, n) -print(A) - -As we will see throughout these lectures, there are several extremely useful functionalities in Numpy. -As an example, consider the discussion of the covariance matrix. Suppose we have defined three vectors -$\hat{x}, \hat{y}, \hat{z}$ with $n$ elements each. The covariance matrix is defined as - -$$ -\hat{\Sigma} = \begin{bmatrix} \sigma_{xx} & \sigma_{xy} & \sigma_{xz} \\ - \sigma_{yx} & \sigma_{yy} & \sigma_{yz} \\ - \sigma_{zx} & \sigma_{zy} & \sigma_{zz} - \end{bmatrix}, -$$ - -where for example - -$$ -\sigma_{xy} =\frac{1}{n} \sum_{i=0}^{n-1}(x_i- \overline{x})(y_i- \overline{y}). -$$ - -The Numpy function **np.cov** calculates the covariance elements using the factor $1/(n-1)$ instead of $1/n$ since it assumes we do not have the exact mean values. For a more in-depth discussion of the covariance and covariance matrix and its meaning, we refer you to the lectures on statistics. -The following simple function uses the **np.vstack** function which takes each vector of dimension $1\times n$ and produces a $ 3\times n$ matrix $\hat{W}$ - -$$ -\hat{W} = \begin{bmatrix} x_0 & y_0 & z_0 \\ - x_1 & y_1 & z_1 \\ - x_2 & y_2 & z_2 \\ - \dots & \dots & \dots \\ - x_{n-2} & y_{n-2} & z_{n-2} \\ - x_{n-1} & y_{n-1} & z_{n-1} - \end{bmatrix}, -$$ - -which in turn is converted into into the $3 times 3$ covariance matrix -$\hat{\Sigma}$ via the Numpy function **np.cov()**. In our review of -statistical functions and quantities we will discuss more about the -meaning of the covariance matrix. Here we note that we can calculate -the mean value of each set of samples $\hat{x}$ etc using the Numpy -function **np.mean(x)**. We can also extract the eigenvalues of the -covariance matrix through the **np.linalg.eig()** function. - -# Importing various packages -import numpy as np - -n = 100 -x = np.random.normal(size=n) -print(np.mean(x)) -y = 4+3*x+np.random.normal(size=n) -print(np.mean(y)) -z = x**3+np.random.normal(size=n) -print(np.mean(z)) -W = np.vstack((x, y, z)) -Sigma = np.cov(W) -print(Sigma) -Eigvals, Eigvecs = np.linalg.eig(Sigma) -print(Eigvals) - -%matplotlib inline - -import numpy as np -import matplotlib.pyplot as plt -from scipy import sparse -eye = np.eye(4) -print(eye) -sparse_mtx = sparse.csr_matrix(eye) -print(sparse_mtx) -x = np.linspace(-10,10,100) -y = np.sin(x) -plt.plot(x,y,marker='x') -plt.show() - -## Other Matrix and Vector Operations - -The following examples show how to compute various quantities like the **mean** value of a matrix or a vector and how to use functions like **reshape** and **ravel**. These are all useful quantities when scaling the data and preparing the data for various machine learning algorithms and when calculating quantities like the mean squared error or the variance. - -""" -Simple code that tests various numpy functions -""" - -import numpy as np -# Simple test-matrix of dim 3 x 4 -a = np.array([ [1, 2, 3], [4, 5, 6], [7, 8, 9],[10, 11, 12]],dtype=np.float64) -print(f"The test matrix:{a}") -# This is the total mean summed over all elements, which here has to be 6.5 -print(f"This is the total mean summed over all elements:{np.mean(a,dtype=np.float64)}") -# This is the mean for each column, it returns an array with the mean values for each column. It returns a row-like vector -print(f"This is the mean for each column:{np.mean(a, axis=0, keepdims=True,dtype=np.float64)}") -# This is the mean value for each row, it returns an array via the keepdims option which is a column-like vector if -# keepdims=True. Else it return a row-like vector -# Try setting keepdims=False -print(f"This is the mean value for each row:{np.mean(a, axis=1, keepdims=True,dtype=np.float64)}") -# We print then the mean value for each row by setting keepdims=False -print(f"This is the mean value for each row with keepdims false:{np.mean(a, axis=1, keepdims=False,dtype=np.float64)}") - -# Ravel return a contiguous flattened array. -print(f"Flatten the matrix:{np.ravel(a)}") -# It is the same as reshaping the matrix into a one-dimensional array -print(f"Reshape the matrix to a one-dim array:{a.reshape(-1)}") -# ‘C’ means to index the elements in row-major, C-style order, with the last axis index changing fastest, back to the first axis index changing slowest. -# ‘F’ means to index the elements in column-major, Fortran-style order, with the first index changing fastest, and the last index changing slowest -print(np.ravel(a, order='F')) -# When order is ‘A’, it will preserve the array’s ‘C’ or ‘F’ ordering -# ‘A’ means to read the elements in Fortran-like index order if a is Fortran contiguous in memory, C-like order otherwise. -# ‘K’ means to read the elements in the order they occur in memory, except for reversing the data when strides are negative. By default, ‘C’ index order is used. -# Transposing it -print(np.ravel(a.T)) -print(np.ravel(a.T, order='A')) - -## Gaussian Elimination - -We start with the linear set of equations - -$$ -\mathbf{A}\mathbf{x} = \mathbf{w}. -$$ - -We assume also that the matrix $\mathbf{A}$ is non-singular and that the -matrix elements along the diagonal satisfy $a_{ii} \ne 0$. Simple $4\times 4 $ example - -$$ -\begin{bmatrix} - a_{11}& a_{12} &a_{13}& a_{14}\\ - a_{21}& a_{22} &a_{23}& a_{24}\\ - a_{31}& a_{32} &a_{33}& a_{34}\\ - a_{41}& a_{42} &a_{43}& a_{44}\\ - \end{bmatrix} \begin{bmatrix} - x_1\\ - x_2\\ - x_3 \\ - x_4 \\ - \end{bmatrix} - =\begin{bmatrix} - w_1\\ - w_2\\ - w_3 \\ - w_4\\ - \end{bmatrix}. -$$ - -or - -$$ -a_{11}x_1 +a_{12}x_2 +a_{13}x_3 + a_{14}x_4=w_1 \nonumber -$$ - -$$ -a_{21}x_1 + a_{22}x_2 + a_{23}x_3 + a_{24}x_4=w_2 \nonumber -$$ - -$$ -a_{31}x_1 + a_{32}x_2 + a_{33}x_3 + a_{34}x_4=w_3 \nonumber -$$ - -$$ -a_{41}x_1 + a_{42}x_2 + a_{43}x_3 + a_{44}x_4=w_4. \nonumber -$$ - -The basic idea of Gaussian elimination is to use the first equation to eliminate the first unknown $x_1$ -from the remaining $n-1$ equations. Then we use the new second equation to eliminate the second unknown -$x_2$ from the remaining $n-2$ equations. With $n-1$ such eliminations -we obtain a so-called upper triangular set of equations of the form - -$$ -b_{11}x_1 +b_{12}x_2 +b_{13}x_3 + b_{14}x_4=y_1 \nonumber -$$ - -$$ -b_{22}x_2 + b_{23}x_3 + b_{24}x_4=y_2 \nonumber -$$ - -$$ -b_{33}x_3 + b_{34}x_4=y_3 \nonumber -$$ - - -
- -$$ -b_{44}x_4=y_4. \nonumber -\label{eq:gaussbacksub} \tag{1} -$$ - -We can solve this system of equations recursively starting from $x_n$ (in our case $x_4$) and proceed with -what is called a backward substitution. - - -This process can be expressed mathematically as - - -
- -$$ -\begin{equation} - x_m = \frac{1}{b_{mm}}\left(y_m-\sum_{k=m+1}^nb_{mk}x_k\right)\quad m=n-1,n-2,\dots,1. -\label{_auto1} \tag{2} -\end{equation} -$$ - -To arrive at such an upper triangular system of equations, we start by eliminating -the unknown $x_1$ for $j=2,n$. We achieve this by multiplying the first equation by $a_{j1}/a_{11}$ and then subtract -the result from the $j$th equation. We assume obviously that $a_{11}\ne 0$ and that -$\mathbf{A}$ is not singular. - - -Our actual $4\times 4$ example reads after the first operation - -$$ -\begin{bmatrix} - a_{11}& a_{12} &a_{13}& a_{14}\\ - 0& (a_{22}-\frac{a_{21}a_{12}}{a_{11}}) &(a_{23}-\frac{a_{21}a_{13}}{a_{11}}) & (a_{24}-\frac{a_{21}a_{14}}{a_{11}})\\ -0& (a_{32}-\frac{a_{31}a_{12}}{a_{11}})& (a_{33}-\frac{a_{31}a_{13}}{a_{11}})& (a_{34}-\frac{a_{31}a_{14}}{a_{11}})\\ -0&(a_{42}-\frac{a_{41}a_{12}}{a_{11}}) &(a_{43}-\frac{a_{41}a_{13}}{a_{11}}) & (a_{44}-\frac{a_{41}a_{14}}{a_{11}}) \\ - \end{bmatrix} \begin{bmatrix} - x_1\\ - x_2\\ - x_3 \\ - x_4 \\ - \end{bmatrix} - =\begin{bmatrix} - y_1\\ - w_2^{(2)}\\ - w_3^{(2)} \\ - w_4^{(2)}\\ - \end{bmatrix}, -$$ - -or - -$$ -b_{11}x_1 +b_{12}x_2 +b_{13}x_3 + b_{14}x_4=y_1 \nonumber -$$ - -$$ -a^{(2)}_{22}x_2 + a^{(2)}_{23}x_3 + a^{(2)}_{24}x_4=w^{(2)}_2 \nonumber -$$ - -$$ -a^{(2)}_{32}x_2 + a^{(2)}_{33}x_3 + a^{(2)}_{34}x_4=w^{(2)}_3 \nonumber -$$ - -$$ -a^{(2)}_{42}x_2 + a^{(2)}_{43}x_3 + a^{(2)}_{44}x_4=w^{(2)}_4, \nonumber -$$ - - -
- -$$ -\begin{equation} -\label{_auto2} \tag{3} -\end{equation} -$$ - -The new coefficients are - - -
- -$$ -\begin{equation} - b_{1k} = a_{1k}^{(1)} \quad k=1,\dots,n, -\label{_auto3} \tag{4} -\end{equation} -$$ - -where each $a_{1k}^{(1)}$ is equal to the original $a_{1k}$ element. The other coefficients are - - -
- -$$ -\begin{equation} -a_{jk}^{(2)} = a_{jk}^{(1)}-\frac{a_{j1}^{(1)}a_{1k}^{(1)}}{a_{11}^{(1)}} \quad j,k=2,\dots,n, -\label{_auto4} \tag{5} -\end{equation} -$$ - -with a new right-hand side given by - - -
- -$$ -\begin{equation} -y_{1}=w_1^{(1)}, \quad w_j^{(2)} =w_j^{(1)}-\frac{a_{j1}^{(1)}w_1^{(1)}}{a_{11}^{(1)}} \quad j=2,\dots,n. -\label{_auto5} \tag{6} -\end{equation} -$$ - -We have also set $w_1^{(1)}=w_1$, the original vector element. -We see that the system of unknowns $x_1,\dots,x_n$ is transformed into an $(n-1)\times (n-1)$ problem. - - - -This step is called forward substitution. -Proceeding with these substitutions, we obtain the -general expressions for the new coefficients - - -
- -$$ -\begin{equation} - a_{jk}^{(m+1)} = a_{jk}^{(m)}-\frac{a_{jm}^{(m)}a_{mk}^{(m)}}{a_{mm}^{(m)}} \quad j,k=m+1,\dots,n, -\label{_auto6} \tag{7} -\end{equation} -$$ - -with $m=1,\dots,n-1$ and a -right-hand side given by - - -
- -$$ -\begin{equation} - w_j^{(m+1)} =w_j^{(m)}-\frac{a_{jm}^{(m)}w_m^{(m)}}{a_{mm}^{(m)}}\quad j=m+1,\dots,n. -\label{_auto7} \tag{8} -\end{equation} -$$ - -This set of $n-1$ elimations leads us to an equations which is solved by back substitution. -If the arithmetics is exact and the matrix $\mathbf{A}$ is not singular, then the computed answer will be exact. - -Even though the matrix elements along the diagonal are not zero, -numerically small numbers may appear and subsequent divisions may lead to large numbers, which, if added -to a small number may yield losses of precision. Suppose for example that our first division in $(a_{22}-a_{21}a_{12}/a_{11})$ -results in $-10^{-7}$ and that $a_{22}$ is one. -one. We are then -adding $10^7+1$. With single precision this results in $10^7$. - - - - - * Gaussian elimination, $O(2/3n^3)$ flops, general matrix - - * LU decomposition, upper triangular and lower tridiagonal matrices, $O(2/3n^3)$ flops, general matrix. Get easily the inverse, determinant and can solve linear equations with back-substitution only, $O(n^2)$ flops - - * Cholesky decomposition. Real symmetric or hermitian positive definite matrix, $O(1/3n^3)$ flops. - - * Tridiagonal linear systems, important for differential equations. Normally positive definite and non-singular. $O(8n)$ flops for symmetric. Special case of banded matrices. - - * Singular value decomposition - - * the QR method will be discussed in chapter 7 in connection with eigenvalue systems. $O(4/3n^3)$ flops. - -The LU decomposition method means that we can rewrite -this matrix as the product of two matrices $\mathbf{L}$ and $\mathbf{U}$ -where - -$$ -\begin{bmatrix} - a_{11} & a_{12} & a_{13} & a_{14} \\ - a_{21} & a_{22} & a_{23} & a_{24} \\ - a_{31} & a_{32} & a_{33} & a_{34} \\ - a_{41} & a_{42} & a_{43} & a_{44} - \end{bmatrix} - = \begin{bmatrix} - 1 & 0 & 0 & 0 \\ - l_{21} & 1 & 0 & 0 \\ - l_{31} & l_{32} & 1 & 0 \\ - l_{41} & l_{42} & l_{43} & 1 - \end{bmatrix} - \begin{bmatrix} - u_{11} & u_{12} & u_{13} & u_{14} \\ - 0 & u_{22} & u_{23} & u_{24} \\ - 0 & 0 & u_{33} & u_{34} \\ - 0 & 0 & 0 & u_{44} - \end{bmatrix}. -$$ - -LU decomposition forms the backbone of other algorithms in linear algebra, such as the -solution of linear equations given by - -$$ -a_{11}x_1 +a_{12}x_2 +a_{13}x_3 + a_{14}x_4=w_1 \nonumber -$$ - -$$ -a_{21}x_1 + a_{22}x_2 + a_{23}x_3 + a_{24}x_4=w_2 \nonumber -$$ - -$$ -a_{31}x_1 + a_{32}x_2 + a_{33}x_3 + a_{34}x_4=w_3 \nonumber -$$ - -$$ -a_{41}x_1 + a_{42}x_2 + a_{43}x_3 + a_{44}x_4=w_4. \nonumber -$$ - -The above set of equations is conveniently solved by using LU decomposition as an intermediate step. - -The matrix $\mathbf{A}\in \mathbb{R}^{n\times n}$ has an LU factorization if the determinant -is different from zero. If the LU factorization exists and $\mathbf{A}$ is non-singular, then the LU factorization -is unique and the determinant is given by - -$$ -det\{\mathbf{A}\}=det\{\mathbf{LU}\}= det\{\mathbf{L}\}det\{\mathbf{U}\}=u_{11}u_{22}\dots u_{nn}. -$$ - -There are at least three main advantages with LU decomposition compared with standard Gaussian elimination: - - * It is straightforward to compute the determinant of a matrix - - * If we have to solve sets of linear equations with the same matrix but with different vectors $\mathbf{y}$, the number of FLOPS is of the order $n^3$. - - * The inverse is such an operation - -With the LU decomposition it is rather -simple to solve a system of linear equations - -$$ -a_{11}x_1 +a_{12}x_2 +a_{13}x_3 + a_{14}x_4=w_1 \nonumber -$$ - -$$ -a_{21}x_1 + a_{22}x_2 + a_{23}x_3 + a_{24}x_4=w_2 \nonumber -$$ - -$$ -a_{31}x_1 + a_{32}x_2 + a_{33}x_3 + a_{34}x_4=w_3 \nonumber -$$ - -$$ -a_{41}x_1 + a_{42}x_2 + a_{43}x_3 + a_{44}x_4=w_4. \nonumber -$$ - -This can be written in matrix form as - -$$ -\mathbf{Ax}=\mathbf{w}. -$$ - -where $\mathbf{A}$ and $\mathbf{w}$ are known and we have to solve for -$\mathbf{x}$. Using the LU dcomposition we write - -$$ -\mathbf{A} \mathbf{x} \equiv \mathbf{L} \mathbf{U} \mathbf{x} =\mathbf{w}. -$$ - -The previous equation can be calculated in two steps - -$$ -\mathbf{L} \mathbf{y} = \mathbf{w};\qquad \mathbf{Ux}=\mathbf{y}. -$$ - -To show that this is correct we use to the LU decomposition -to rewrite our system of linear equations as - -$$ -\mathbf{LUx}=\mathbf{w}, -$$ - -and since the determinant of $\mathbf{L}$ is equal to 1 (by construction -since the diagonals of $\mathbf{L}$ equal 1) we can use the inverse of -$\mathbf{L}$ to obtain - -$$ -\mathbf{Ux}=\mathbf{L^{-1}w}=\mathbf{y}, -$$ - -which yields the intermediate step - -$$ -\mathbf{L^{-1}w}=\mathbf{y} -$$ - -and as soon as we have $\mathbf{y}$ we can obtain $\mathbf{x}$ -through $\mathbf{Ux}=\mathbf{y}$. - - -For our four-dimentional example this takes the form - -$$ -y_1=w_1 \nonumber -$$ - -$$ -l_{21}y_1 + y_2=w_2\nonumber -$$ - -$$ -l_{31}y_1 + l_{32}y_2 + y_3 =w_3\nonumber -$$ - -$$ -l_{41}y_1 + l_{42}y_2 + l_{43}y_3 + y_4=w_4. \nonumber -$$ - -and - -$$ -u_{11}x_1 +u_{12}x_2 +u_{13}x_3 + u_{14}x_4=y_1 \nonumber -$$ - -$$ -u_{22}x_2 + u_{23}x_3 + u_{24}x_4=y_2\nonumber -$$ - -$$ -u_{33}x_3 + u_{34}x_4=y_3\nonumber -$$ - -$$ -u_{44}x_4=y_4 \nonumber -$$ - -This example shows the basis for the algorithm -needed to solve the set of $n$ linear equations. - - - -The algorithm goes as follows - - * Set up the matrix $\bf A$ and the vector $\bf w$ with their correct dimensions. This determines the dimensionality of the unknown vector $\bf x$. - - * Then LU decompose the matrix $\bf A$ through a call to the function `ludcmp(double a, int n, int indx, double &d)`. This functions returns the LU decomposed matrix $\bf A$, its determinant and the vector indx which keeps track of the number of interchanges of rows. If the determinant is zero, the solution is malconditioned. - - * Thereafter you call the function `lubksb(double a, int n, int indx, double w)` which uses the LU decomposed matrix $\bf A$ and the vector $\bf w$ and returns $\bf x$ in the same place as $\bf w$. Upon exit the original content in $\bf w$ is destroyed. If you wish to keep this information, you should make a backup of it in your calling function. - -### LU Decomposition, the inverse of a matrix - -If the inverse exists then - -$$ -\mathbf{A}^{-1}\mathbf{A}=\mathbf{I}, -$$ - -the identity matrix. With an LU decomposed matrix we can rewrite the last equation as - -$$ -\mathbf{LU}\mathbf{A}^{-1}=\mathbf{I}. -$$ - -If we assume that the first column (that is column 1) of the inverse matrix -can be written as a vector with unknown entries - -$$ -\mathbf{A}_1^{-1}= \begin{bmatrix} - a_{11}^{-1} \\ - a_{21}^{-1} \\ - \dots \\ - a_{n1}^{-1} \\ - \end{bmatrix}, -$$ - -then we have a linear set of equations - -$$ -\mathbf{LU}\begin{bmatrix} - a_{11}^{-1} \\ - a_{21}^{-1} \\ - \dots \\ - a_{n1}^{-1} \\ - \end{bmatrix} =\begin{bmatrix} - 1 \\ - 0 \\ - \dots \\ - 0 \\ - \end{bmatrix}. -$$ - -In a similar way we can compute the unknow entries of the second column, - -$$ -\mathbf{LU}\begin{bmatrix} - a_{12}^{-1} \\ - a_{22}^{-1} \\ - \dots \\ - a_{n2}^{-1} \\ - \end{bmatrix}=\begin{bmatrix} - 0 \\ - 1 \\ - \dots \\ - 0 \\ - \end{bmatrix}, -$$ - -and continue till we have solved all $n$ sets of linear equations. \ No newline at end of file diff --git a/doc/LectureNotes/_build/jupyter_execute/statistics.ipynb b/doc/LectureNotes/_build/jupyter_execute/statistics.ipynb deleted file mode 100644 index f3dcb3d53..000000000 --- a/doc/LectureNotes/_build/jupyter_execute/statistics.ipynb +++ /dev/null @@ -1,3003 +0,0 @@ -{ - "cells": [ - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "# Elements of Probability Theory and Statistical Data Analysis\n", - "\n", - "\n", - "## Domains and probabilities\n", - "Consider the following simple example, namely the tossing of two dice, resulting in the following possible values" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\{2,3,4,5,6,7,8,9,10,11,12\\}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "These values are called the *domain*. \n", - "To this domain we have the corresponding *probabilities*" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\{1/36,2/36/,3/36,4/36,5/36,6/36,5/36,4/36,3/36,2/36,1/36\\}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Tossing the dice\n", - "The numbers in the domain are the outcomes of the physical process of tossing say two dice.\n", - "We cannot tell beforehand whether the outcome is 3 or 5 or any other number in this domain.\n", - "This defines the randomness of the outcome, or unexpectedness or any other synonimous word which\n", - "encompasses the uncertitude of the final outcome. \n", - "\n", - "The only thing we can tell beforehand\n", - "is that say the outcome 2 has a certain probability. \n", - "If our favorite hobby is to spend an hour every evening throwing dice and \n", - "registering the sequence of outcomes, we will note that the numbers in the above domain" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\{2,3,4,5,6,7,8,9,10,11,12\\},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "appear in a random order. After 11 throws the results may look like" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\{10,8,6,3,6,9,11,8,12,4,5\\}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Stochastic variables\n", - "\n", - "**Random variables are characterized by a domain which contains all possible values that the random value may take. This domain has a corresponding probability distribution function(PDF)**.\n", - "\n", - "\n", - "\n", - "\n", - "## Stochastic variables and the main concepts, the discrete case\n", - "There are two main concepts associated with a stochastic variable. The\n", - "*domain* is the set $\\mathbb D = \\{x\\}$ of all accessible values\n", - "the variable can assume, so that $X \\in \\mathbb D$. An example of a\n", - "discrete domain is the set of six different numbers that we may get by\n", - "throwing of a dice, $x\\in\\{1,\\,2,\\,3,\\,4,\\,5,\\,6\\}$.\n", - "\n", - "The *probability distribution function (PDF)* is a function\n", - "$p(x)$ on the domain which, in the discrete case, gives us the\n", - "probability or relative frequency with which these values of $X$\n", - "occur" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(x) = \\mathrm{Prob}(X=x).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Stochastic variables and the main concepts, the continuous case\n", - "In the continuous case, the PDF does not directly depict the\n", - "actual probability. Instead we define the probability for the\n", - "stochastic variable to assume any value on an infinitesimal interval\n", - "around $x$ to be $p(x)dx$. The continuous function $p(x)$ then gives us\n", - "the *density* of the probability rather than the probability\n", - "itself. The probability for a stochastic variable to assume any value\n", - "on a non-infinitesimal interval $[a,\\,b]$ is then just the integral" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathrm{Prob}(a\\leq X\\leq b) = \\int_a^b p(x)dx.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Qualitatively speaking, a stochastic variable represents the values of\n", - "numbers chosen as if by chance from some specified PDF so that the\n", - "selection of a large set of these numbers reproduces this PDF.\n", - "\n", - "\n", - "\n", - "\n", - "## The cumulative probability\n", - "Of interest to us is the *cumulative probability\n", - "distribution function* (**CDF**), $P(x)$, which is just the probability\n", - "for a stochastic variable $X$ to assume any value less than $x$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "P(x)=\\mathrm{Prob(}X\\leq x\\mathrm{)} =\n", - "\\int_{-\\infty}^x p(x^{\\prime})dx^{\\prime}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The relation between a CDF and its corresponding PDF is then" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(x) = \\frac{d}{dx}P(x).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Properties of PDFs\n", - "\n", - "There are two properties that all PDFs must satisfy. The first one is\n", - "positivity (assuming that the PDF is normalized)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "0 \\leq p(x) \\leq 1.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Naturally, it would be nonsensical for any of the values of the domain\n", - "to occur with a probability greater than $1$ or less than $0$. Also,\n", - "the PDF must be normalized. That is, all the probabilities must add up\n", - "to unity. The probability of \"anything\" to happen is always unity. For\n", - "both discrete and continuous PDFs, this condition is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{align*}\n", - "\\sum_{x_i\\in\\mathbb D} p(x_i) & = 1,\\\\\n", - "\\int_{x\\in\\mathbb D} p(x)\\,dx & = 1.\n", - "\\end{align*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Important distributions, the uniform distribution\n", - "The first one\n", - "is the most basic PDF; namely the uniform distribution" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - "p(x) = \\frac{1}{b-a}\\theta(x-a)\\theta(b-x).\n", - "\\label{eq:unifromPDF} \\tag{1}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "For $a=0$ and $b=1$ we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{array}{ll}\n", - "p(x)dx = dx & \\in [0,1].\n", - "\\end{array}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The latter distribution is used to generate random numbers. For other PDFs, one needs normally a mapping from this distribution to say for example the exponential distribution.\n", - "\n", - "\n", - "\n", - "\n", - "## Gaussian distribution\n", - "The second one is the Gaussian Distribution" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(x) = \\frac{1}{\\sigma\\sqrt{2\\pi}} \\exp{(-\\frac{(x-\\mu)^2}{2\\sigma^2})},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with mean value $\\mu$ and standard deviation $\\sigma$. If $\\mu=0$ and $\\sigma=1$, it is normally called the **standard normal distribution**" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(x) = \\frac{1}{\\sqrt{2\\pi}} \\exp{(-\\frac{x^2}{2})},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The following simple Python code plots the above distribution for different values of $\\mu$ and $\\sigma$." - ] - }, - { - "cell_type": "code", - "execution_count": 1, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "data": { - "image/png": "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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/statistics_29_0.png" - }, - "needs_background": "light" - }, - "output_type": "display_data" - } - ], - "source": [ - "%matplotlib inline\n", - "\n", - "import numpy as np\n", - "from math import acos, exp, sqrt\n", - "from matplotlib import pyplot as plt\n", - "from matplotlib import rc, rcParams\n", - "import matplotlib.units as units\n", - "import matplotlib.ticker as ticker\n", - "rc('text',usetex=True)\n", - "rc('font',**{'family':'serif','serif':['Gaussian distribution']})\n", - "font = {'family' : 'serif',\n", - " 'color' : 'darkred',\n", - " 'weight' : 'normal',\n", - " 'size' : 16,\n", - " }\n", - "pi = acos(-1.0)\n", - "mu0 = 0.0\n", - "sigma0 = 1.0\n", - "mu1= 1.0\n", - "sigma1 = 2.0\n", - "mu2 = 2.0\n", - "sigma2 = 4.0\n", - "\n", - "x = np.linspace(-20.0, 20.0)\n", - "v0 = np.exp(-(x*x-2*x*mu0+mu0*mu0)/(2*sigma0*sigma0))/sqrt(2*pi*sigma0*sigma0)\n", - "v1 = np.exp(-(x*x-2*x*mu1+mu1*mu1)/(2*sigma1*sigma1))/sqrt(2*pi*sigma1*sigma1)\n", - "v2 = np.exp(-(x*x-2*x*mu2+mu2*mu2)/(2*sigma2*sigma2))/sqrt(2*pi*sigma2*sigma2)\n", - "plt.plot(x, v0, 'b-', x, v1, 'r-', x, v2, 'g-')\n", - "plt.title(r'{\\bf Gaussian distributions}', fontsize=20)\n", - "plt.text(-19, 0.3, r'Parameters: $\\mu = 0$, $\\sigma = 1$', fontdict=font)\n", - "plt.text(-19, 0.18, r'Parameters: $\\mu = 1$, $\\sigma = 2$', fontdict=font)\n", - "plt.text(-19, 0.08, r'Parameters: $\\mu = 2$, $\\sigma = 4$', fontdict=font)\n", - "plt.xlabel(r'$x$',fontsize=20)\n", - "plt.ylabel(r'$p(x)$ [MeV]',fontsize=20)\n", - "\n", - "# Tweak spacing to prevent clipping of ylabel \n", - "plt.subplots_adjust(left=0.15)\n", - "plt.savefig('gaussian.pdf', format='pdf')\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Exponential distribution\n", - "Another important distribution in science is the exponential distribution" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(x) = \\alpha\\exp{-(\\alpha x)}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Expectation values\n", - "Let $h(x)$ be an arbitrary continuous function on the domain of the stochastic\n", - "variable $X$ whose PDF is $p(x)$. We define the *expectation value*\n", - "of $h$ with respect to $p$ as follows" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - "\\langle h \\rangle_X \\equiv \\int\\! h(x)p(x)\\,dx\n", - "\\label{eq:expectation_value_of_h_wrt_p} \\tag{2}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Whenever the PDF is known implicitly, like in this case, we will drop\n", - "the index $X$ for clarity. \n", - "A particularly useful class of special expectation values are the\n", - "*moments*. The $n$-th moment of the PDF $p$ is defined as\n", - "follows" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\langle x^n \\rangle \\equiv \\int\\! x^n p(x)\\,dx\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Stochastic variables and the main concepts, mean values\n", - "The zero-th moment $\\langle 1\\rangle$ is just the normalization condition of\n", - "$p$. The first moment, $\\langle x\\rangle$, is called the *mean* of $p$\n", - "and often denoted by the letter $\\mu$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\langle x\\rangle = \\mu \\equiv \\int x p(x)dx,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "for a continuous distribution and" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\langle x\\rangle = \\mu \\equiv \\sum_{i=1}^N x_i p(x_i),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "for a discrete distribution. \n", - "Qualitatively it represents the centroid or the average value of the\n", - "PDF and is therefore simply called the expectation value of $p(x)$.\n", - "\n", - "\n", - "\n", - "\n", - "## Stochastic variables and the main concepts, central moments, the variance\n", - "\n", - "A special version of the moments is the set of *central moments*, the n-th central moment defined as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\langle (x-\\langle x\\rangle )^n\\rangle \\equiv \\int\\! (x-\\langle x\\rangle)^n p(x)\\,dx\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The zero-th and first central moments are both trivial, equal $1$ and\n", - "$0$, respectively. But the second central moment, known as the\n", - "*variance* of $p$, is of particular interest. For the stochastic\n", - "variable $X$, the variance is denoted as $\\sigma^2_X$ or $\\mathrm{Var}(X)$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{align*}\n", - "\\sigma^2_X &=\\mathrm{Var}(X) = \\langle (x-\\langle x\\rangle)^2\\rangle =\n", - "\\int (x-\\langle x\\rangle)^2 p(x)dx\\\\\n", - "& = \\int\\left(x^2 - 2 x \\langle x\\rangle^{2} +\\langle x\\rangle^2\\right)p(x)dx\\\\\n", - "& = \\langle x^2\\rangle - 2 \\langle x\\rangle\\langle x\\rangle + \\langle x\\rangle^2\\\\\n", - "& = \\langle x^2 \\rangle - \\langle x\\rangle^2\n", - "\\end{align*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The square root of the variance, $\\sigma =\\sqrt{\\langle (x-\\langle x\\rangle)^2\\rangle}$ is called the \n", - "**standard deviation** of $p$. It is the RMS (root-mean-square)\n", - "value of the deviation of the PDF from its mean value, interpreted\n", - "qualitatively as the \"spread\" of $p$ around its mean.\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "## Probability Distribution Functions\n", - "\n", - "The following table collects properties of probability distribution functions.\n", - "In our notation we reserve the label $p(x)$ for the probability of a certain event,\n", - "while $P(x)$ is the cumulative probability. \n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "
Discrete PDF Continuous PDF
Domain $\\left\\{x_1, x_2, x_3, \\dots, x_N\\right\\}$ $[a,b]$
Probability $p(x_i)$ $p(x)dx$
Cumulative $P_i=\\sum_{l=1}^ip(x_l)$ $P(x)=\\int_a^xp(t)dt$
Positivity $0 \\le p(x_i) \\le 1$ $p(x) \\ge 0$
Positivity $0 \\le P_i \\le 1$ $0 \\le P(x) \\le 1$
Monotonic $P_i \\ge P_j$ if $x_i \\ge x_j$ $P(x_i) \\ge P(x_j)$ if $x_i \\ge x_j$
Normalization $P_N=1$ $P(b)=1$
\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "## Probability Distribution Functions\n", - "With a PDF we can compute expectation values of selected quantities such as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\langle x^k\\rangle=\\sum_{i=1}^{N}x_i^kp(x_i),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "if we have a discrete PDF or" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\langle x^k\\rangle=\\int_a^b x^kp(x)dx,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "in the case of a continuous PDF. We have already defined the mean value $\\mu$\n", - "and the variance $\\sigma^2$.\n", - "\n", - "\n", - "\n", - "\n", - "## The three famous Probability Distribution Functions\n", - "\n", - "There are at least three PDFs which one may encounter. These are the\n", - "\n", - "**Uniform distribution**" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(x)=\\frac{1}{b-a}\\Theta(x-a)\\Theta(b-x),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "yielding probabilities different from zero in the interval $[a,b]$.\n", - "\n", - "**The exponential distribution**" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(x)=\\alpha \\exp{(-\\alpha x)},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "yielding probabilities different from zero in the interval $[0,\\infty)$ and with mean value" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mu = \\int_0^{\\infty}xp(x)dx=\\int_0^{\\infty}x\\alpha \\exp{(-\\alpha x)}dx=\\frac{1}{\\alpha},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with variance" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\sigma^2=\\int_0^{\\infty}x^2p(x)dx-\\mu^2 = \\frac{1}{\\alpha^2}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Probability Distribution Functions, the normal distribution\n", - "Finally, we have the so-called univariate normal distribution, or just the **normal distribution**" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(x)=\\frac{1}{b\\sqrt{2\\pi}}\\exp{\\left(-\\frac{(x-a)^2}{2b^2}\\right)}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with probabilities different from zero in the interval $(-\\infty,\\infty)$.\n", - "The integral $\\int_{-\\infty}^{\\infty}\\exp{\\left(-(x^2\\right)}dx$ appears in many calculations, its value\n", - "is $\\sqrt{\\pi}$, a result we will need when we compute the mean value and the variance.\n", - "The mean value is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mu = \\int_0^{\\infty}xp(x)dx=\\frac{1}{b\\sqrt{2\\pi}}\\int_{-\\infty}^{\\infty}x \\exp{\\left(-\\frac{(x-a)^2}{2b^2}\\right)}dx,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which becomes with a suitable change of variables" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mu =\\frac{1}{b\\sqrt{2\\pi}}\\int_{-\\infty}^{\\infty}b\\sqrt{2}(a+b\\sqrt{2}y)\\exp{-y^2}dy=a.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Probability Distribution Functions, the normal distribution\n", - "Similarly, the variance becomes" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\sigma^2 = \\frac{1}{b\\sqrt{2\\pi}}\\int_{-\\infty}^{\\infty}(x-\\mu)^2 \\exp{\\left(-\\frac{(x-a)^2}{2b^2}\\right)}dx,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and inserting the mean value and performing a variable change we obtain" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\sigma^2 = \\frac{1}{b\\sqrt{2\\pi}}\\int_{-\\infty}^{\\infty}b\\sqrt{2}(b\\sqrt{2}y)^2\\exp{\\left(-y^2\\right)}dy=\n", - "\\frac{2b^2}{\\sqrt{\\pi}}\\int_{-\\infty}^{\\infty}y^2\\exp{\\left(-y^2\\right)}dy,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and performing a final integration by parts we obtain the well-known result $\\sigma^2=b^2$.\n", - "It is useful to introduce the standard normal distribution as well, defined by $\\mu=a=0$, viz. a distribution\n", - "centered around zero and with a variance $\\sigma^2=1$, leading to" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - " p(x)=\\frac{1}{\\sqrt{2\\pi}}\\exp{\\left(-\\frac{x^2}{2}\\right)}.\n", - "\\label{_auto1} \\tag{3}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Probability Distribution Functions, the cumulative distribution\n", - "\n", - "The exponential and uniform distributions have simple cumulative functions,\n", - "whereas the normal distribution does not, being proportional to the so-called\n", - "error function $erf(x)$, given by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "P(x) = \\frac{1}{\\sqrt{2\\pi}}\\int_{-\\infty}^x\\exp{\\left(-\\frac{t^2}{2}\\right)}dt,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which is difficult to evaluate in a quick way.\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "## Probability Distribution Functions, other important distribution\n", - "\n", - "Some other PDFs which one encounters often in the natural sciences are the binomial distribution" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(x) = \\left(\\begin{array}{c} n \\\\ x\\end{array}\\right)y^x(1-y)^{n-x} \\hspace{0.5cm}x=0,1,\\dots,n,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $y$ is the probability for a specific event, such as the tossing of a coin or moving left or right\n", - "in case of a random walker. Note that $x$ is a discrete stochastic variable. \n", - "\n", - "The sequence of binomial trials is characterized by the following definitions\n", - "\n", - " * Every experiment is thought to consist of $N$ independent trials.\n", - "\n", - " * In every independent trial one registers if a specific situation happens or not, such as the jump to the left or right of a random walker.\n", - "\n", - " * The probability for every outcome in a single trial has the same value, for example the outcome of tossing (either heads or tails) a coin is always $1/2$.\n", - "\n", - "\n", - "\n", - "\n", - "## Probability Distribution Functions, the binomial distribution\n", - "\n", - "In order to compute the mean and variance we need to recall Newton's binomial\n", - "formula" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "(a+b)^m=\\sum_{n=0}^m \\left(\\begin{array}{c} m \\\\ n\\end{array}\\right)a^nb^{m-n},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which can be used to show that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\sum_{x=0}^n\\left(\\begin{array}{c} n \\\\ x\\end{array}\\right)y^x(1-y)^{n-x} = (y+1-y)^n = 1,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "the PDF is normalized to one. \n", - "The mean value is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mu = \\sum_{x=0}^n x\\left(\\begin{array}{c} n \\\\ x\\end{array}\\right)y^x(1-y)^{n-x} =\n", - "\\sum_{x=0}^n x\\frac{n!}{x!(n-x)!}y^x(1-y)^{n-x},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "resulting in" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mu = \n", - "\\sum_{x=0}^n x\\frac{(n-1)!}{(x-1)!(n-1-(x-1))!}y^{x-1}(1-y)^{n-1-(x-1)},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which we rewrite as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mu=ny\\sum_{\\nu=0}^n\\left(\\begin{array}{c} n-1 \\\\ \\nu\\end{array}\\right)y^{\\nu}(1-y)^{n-1-\\nu} =ny(y+1-y)^{n-1}=ny.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The variance is slightly trickier to get. It reads $\\sigma^2=ny(1-y)$. \n", - "\n", - "\n", - "## Probability Distribution Functions, Poisson's distribution\n", - "\n", - "Another important distribution with discrete stochastic variables $x$ is \n", - "the Poisson model, which resembles the exponential distribution and reads" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(x) = \\frac{\\lambda^x}{x!} e^{-\\lambda} \\hspace{0.5cm}x=0,1,\\dots,;\\lambda > 0.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In this case both the mean value and the variance are easier to calculate," - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mu = \\sum_{x=0}^{\\infty} x \\frac{\\lambda^x}{x!} e^{-\\lambda} = \\lambda e^{-\\lambda}\\sum_{x=1}^{\\infty}\n", - "\\frac{\\lambda^{x-1}}{(x-1)!}=\\lambda,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and the variance is $\\sigma^2=\\lambda$.\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "## Probability Distribution Functions, Poisson's distribution\n", - "An example of applications of the Poisson distribution could be the counting\n", - "of the number of $\\alpha$-particles emitted from a radioactive source in a given time interval.\n", - "In the limit of $n\\rightarrow \\infty$ and for small probabilities $y$, the binomial distribution\n", - "approaches the Poisson distribution. Setting $\\lambda = ny$, with $y$ the probability for an event in\n", - "the binomial distribution we can show that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\lim_{n\\rightarrow \\infty}\\left(\\begin{array}{c} n \\\\ x\\end{array}\\right)y^x(1-y)^{n-x} e^{-\\lambda}=\\sum_{x=1}^{\\infty}\\frac{\\lambda^x}{x!} e^{-\\lambda}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Meet the covariance!\n", - "An important quantity in a statistical analysis is the so-called covariance. \n", - "\n", - "Consider the set $\\{X_i\\}$ of $n$\n", - "stochastic variables (not necessarily uncorrelated) with the\n", - "multivariate PDF $P(x_1,\\dots,x_n)$. The *covariance* of two\n", - "of the stochastic variables, $X_i$ and $X_j$, is defined as follows" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - "\\mathrm{Cov}(X_i,\\,X_j) = \\langle (x_i-\\langle x_i\\rangle)(x_j-\\langle x_j\\rangle)\\rangle \n", - "\\label{_auto2} \\tag{4}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation} \n", - "=\\int\\cdots\\int (x_i-\\langle x_i\\rangle)(x_j-\\langle x_j\\rangle)P(x_1,\\dots,x_n)\\,dx_1\\dots dx_n,\n", - "\\label{eq:def_covariance} \\tag{5}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\langle x_i\\rangle =\n", - "\\int\\cdots\\int x_i P(x_1,\\dots,x_n)\\,dx_1\\dots dx_n.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Meet the covariance in matrix disguise\n", - "If we consider the above covariance as a matrix" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C_{ij} =\\mathrm{Cov}(X_i,\\,X_j),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "then the diagonal elements are just the familiar\n", - "variances, $C_{ii} = \\mathrm{Cov}(X_i,\\,X_i) = \\mathrm{Var}(X_i)$. It turns out that\n", - "all the off-diagonal elements are zero if the stochastic variables are\n", - "uncorrelated.\n", - "\n", - "\n", - "\n", - "\n", - "## Covariance" - ] - }, - { - "cell_type": "code", - "execution_count": 2, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "2.4890704720929593\n", - "[[11.60990408 7.82544198 14.11622885 1.78979284 6.76376813 14.09060397\n", - " 14.04624055 3.77253612 5.11082097 14.99821162]\n", - " [ 7.82544198 5.27459502 9.51478402 1.20637689 4.55899331 9.49751204\n", - " 9.4676097 2.54280848 3.44485473 10.10926826]\n", - " [14.11622885 9.51478402 17.16361442 2.17617003 8.22391797 17.13245767\n", - " 17.07851716 4.58694429 6.21413561 18.23599801]\n", - " [ 1.78979284 1.20637689 2.17617003 0.27591601 1.04270833 2.17221967\n", - " 2.16538057 0.58157742 0.78788857 2.31213725]\n", - " [ 6.76376813 4.55899331 8.22391797 1.04270833 3.94047694 8.20898927\n", - " 8.18314376 2.19782691 2.97749299 8.73774883]\n", - " [14.09060397 9.49751204 17.13245767 2.17221967 8.20898927 17.10135749\n", - " 17.04751489 4.57861771 6.20285522 18.20289459]\n", - " [14.04624055 9.4676097 17.07851716 2.16538057 8.18314376 17.04751489\n", - " 16.99384182 4.56420221 6.18332591 18.14558387]\n", - " [ 3.77253612 2.54280848 4.58694429 0.58157742 2.19782691 4.57861771\n", - " 4.56420221 1.2258524 1.66071628 4.87353683]\n", - " [ 5.11082097 3.44485473 6.21413561 0.78788857 2.97749299 6.20285522\n", - " 6.18332591 1.66071628 2.24984554 6.60239515]\n", - " [14.99821162 10.10926826 18.23599801 2.31213725 8.73774883 18.20289459\n", - " 18.14558387 4.87353683 6.60239515 19.37538418]]\n" - ] - } - ], - "source": [ - "# Importing various packages\n", - "from math import exp, sqrt\n", - "from random import random, seed\n", - "import numpy as np\n", - "import matplotlib.pyplot as plt\n", - "\n", - "def covariance(x, y, n):\n", - " sum = 0.0\n", - " mean_x = np.mean(x)\n", - " mean_y = np.mean(y)\n", - " for i in range(0, n):\n", - " sum += (x[(i)]-mean_x)*(y[i]-mean_y)\n", - " return sum/n\n", - "\n", - "n = 10\n", - "\n", - "x=np.random.normal(size=n)\n", - "y = 4+3*x+np.random.normal(size=n)\n", - "covxy = covariance(x,y,n)\n", - "print(covxy)\n", - "z = np.vstack((x, y))\n", - "c = np.cov(z.T)\n", - "\n", - "print(c)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Meet the covariance, uncorrelated events\n", - "\n", - "Consider the stochastic variables $X_i$ and $X_j$, ($i\\neq j$). We have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\begin{align*}\n", - "Cov(X_i,\\,X_j) &= \\langle (x_i-\\langle x_i\\rangle)(x_j-\\langle x_j\\rangle)\\rangle\\\\\n", - "&=\\langle x_i x_j - x_i\\langle x_j\\rangle - \\langle x_i\\rangle x_j + \\langle x_i\\rangle\\langle x_j\\rangle\\rangle\\\\\n", - "&=\\langle x_i x_j\\rangle - \\langle x_i\\langle x_j\\rangle\\rangle - \\langle \\langle x_i\\rangle x_j \\rangle +\n", - "\\langle \\langle x_i\\rangle\\langle x_j\\rangle\\rangle \\\\\n", - "&=\\langle x_i x_j\\rangle - \\langle x_i\\rangle\\langle x_j\\rangle - \\langle x_i\\rangle\\langle x_j\\rangle +\n", - "\\langle x_i\\rangle\\langle x_j\\rangle \\\\\n", - "&=\\langle x_i x_j\\rangle - \\langle x_i\\rangle\\langle x_j\\rangle\n", - "\\end{align*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "If $X_i$ and $X_j$ are independent (assuming $i \\neq j$), we have that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\langle x_i x_j\\rangle = \\langle x_i\\rangle\\langle x_j\\rangle,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "leading to" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "Cov(X_i, X_j) = 0 \\hspace{0.1cm} (i\\neq j).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Numerical experiments and the covariance\n", - "\n", - "Now that we have constructed an idealized mathematical framework, let\n", - "us try to apply it to empirical observations. Examples of relevant\n", - "physical phenomena may be spontaneous decays of nuclei, or a purely\n", - "mathematical set of numbers produced by some deterministic\n", - "mechanism. It is the latter we will deal with, using so-called pseudo-random\n", - "number generators. In general our observations will contain only a limited set of\n", - "observables. We remind the reader that\n", - "a *stochastic process* is a process that produces sequentially a\n", - "chain of values" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\{x_1, x_2,\\dots\\,x_k,\\dots\\}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Numerical experiments and the covariance\n", - "We will call these\n", - "values our *measurements* and the entire set as our measured\n", - "*sample*. The action of measuring all the elements of a sample\n", - "we will call a stochastic *experiment* (since, operationally,\n", - "they are often associated with results of empirical observation of\n", - "some physical or mathematical phenomena; precisely an experiment). We\n", - "assume that these values are distributed according to some \n", - "PDF $p_X^{\\phantom X}(x)$, where $X$ is just the formal symbol for the\n", - "stochastic variable whose PDF is $p_X^{\\phantom X}(x)$. Instead of\n", - "trying to determine the full distribution $p$ we are often only\n", - "interested in finding the few lowest moments, like the mean\n", - "$\\mu_X^{\\phantom X}$ and the variance $\\sigma_X^{\\phantom X}$.\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "## Numerical experiments and the covariance, actual situations\n", - "In practical situations however, a sample is always of finite size. Let that\n", - "size be $n$. The expectation value of a sample $\\alpha$, the **sample mean**, is then defined as follows" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\langle x_{\\alpha} \\rangle \\equiv \\frac{1}{n}\\sum_{k=1}^n x_{\\alpha,k}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The *sample variance* is:" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathrm{Var}(x) \\equiv \\frac{1}{n}\\sum_{k=1}^n (x_{\\alpha,k} - \\langle x_{\\alpha} \\rangle)^2,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with its square root being the *standard deviation of the sample*.\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "## Numerical experiments and the covariance, our observables\n", - "You can think of the above observables as a set of quantities which define\n", - "a given experiment. This experiment is then repeated several times, say $m$ times.\n", - "The total average is then" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - "\\langle X_m \\rangle= \\frac{1}{m}\\sum_{\\alpha=1}^mx_{\\alpha}=\\frac{1}{mn}\\sum_{\\alpha, k} x_{\\alpha,k},\n", - "\\label{eq:exptmean} \\tag{6}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where the last sums end at $m$ and $n$.\n", - "The total variance is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\sigma^2_m= \\frac{1}{mn^2}\\sum_{\\alpha=1}^m(\\langle x_{\\alpha} \\rangle-\\langle X_m \\rangle)^2,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which we rewrite as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - "\\sigma^2_m=\\frac{1}{m}\\sum_{\\alpha=1}^m\\sum_{kl=1}^n (x_{\\alpha,k}-\\langle X_m \\rangle)(x_{\\alpha,l}-\\langle X_m \\rangle).\n", - "\\label{eq:exptvariance} \\tag{7}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Numerical experiments and the covariance, the sample variance\n", - "\n", - "We define also the sample variance $\\sigma^2$ of all $mn$ individual experiments as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - "\\sigma^2=\\frac{1}{mn}\\sum_{\\alpha=1}^m\\sum_{k=1}^n (x_{\\alpha,k}-\\langle X_m \\rangle)^2.\n", - "\\label{eq:sampleexptvariance} \\tag{8}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "These quantities, being known experimental values or the results from our calculations, \n", - "may differ, in some cases\n", - "significantly, from the similarly named\n", - "exact values for the mean value $\\mu_X$, the variance $\\mathrm{Var}(X)$\n", - "and the covariance $\\mathrm{Cov}(X,Y)$.\n", - "\n", - "\n", - "\n", - "\n", - "## Numerical experiments and the covariance, central limit theorem\n", - "\n", - "The central limit theorem states that the PDF $\\tilde{p}(z)$ of\n", - "the average of $m$ random values corresponding to a PDF $p(x)$ \n", - "is a normal distribution whose mean is the \n", - "mean value of the PDF $p(x)$ and whose variance is the variance\n", - "of the PDF $p(x)$ divided by $m$, the number of values used to compute $z$.\n", - "\n", - "The central limit theorem leads then to the well-known expression for the\n", - "standard deviation, given by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\sigma_m=\n", - "\\frac{\\sigma}{\\sqrt{m}}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In many cases the above estimate for the standard deviation, in particular if correlations are strong, may be too simplistic. We need therefore a more precise defintion of the error and the variance in our results.\n", - "\n", - "\n", - "\n", - "\n", - "## Definition of Correlation Functions and Standard Deviation\n", - "Our estimate of the true average $\\mu_{X}$ is the sample mean $\\langle X_m \\rangle$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mu_{X}^{\\phantom X} \\approx X_m=\\frac{1}{mn}\\sum_{\\alpha=1}^m\\sum_{k=1}^n x_{\\alpha,k}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We can then use Eq. ([7](#eq:exptvariance))" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\sigma^2_m=\\frac{1}{mn^2}\\sum_{\\alpha=1}^m\\sum_{kl=1}^n (x_{\\alpha,k}-\\langle X_m \\rangle)(x_{\\alpha,l}-\\langle X_m \\rangle),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and rewrite it as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\sigma^2_m=\\frac{\\sigma^2}{n}+\\frac{2}{mn^2}\\sum_{\\alpha=1}^m\\sum_{k\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - "\\kappa_d = \\frac{f_d}{\\sigma^2}\n", - "\\label{eq:autocorrelformal} \\tag{9}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which gives us a useful measure of the correlation pair correlation\n", - "starting always at $1$ for $d=0$.\n", - "\n", - "\n", - "\n", - "\n", - "## Definition of Correlation Functions and Standard Deviation, sample variance\n", - "\n", - "The sample variance of the $mn$ experiments can now be\n", - "written in terms of the autocorrelation function" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - "\\sigma_m^2=\\frac{\\sigma^2}{n}+\\frac{2}{n}\\cdot\\sigma^2\\sum_{d=1}^{n-1}\n", - "\\frac{f_d}{\\sigma^2}=\\left(1+2\\sum_{d=1}^{n-1}\\kappa_d\\right)\\frac{1}{n}\\sigma^2=\\frac{\\tau}{n}\\cdot\\sigma^2\n", - "\\label{eq:error_estimate_corr_time} \\tag{10}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and we see that $\\sigma_m$ can be expressed in terms of the\n", - "uncorrelated sample variance times a correction factor $\\tau$ which\n", - "accounts for the correlation between measurements. We call this\n", - "correction factor the *autocorrelation time*" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - "\\tau = 1+2\\sum_{d=1}^{n-1}\\kappa_d\n", - "\\label{eq:autocorrelation_time} \\tag{11}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "\n", - "For a correlation free experiment, $\\tau$\n", - "equals 1.\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "## Definition of Correlation Functions and Standard Deviation\n", - "From the point of view of\n", - "Eq. ([10](#eq:error_estimate_corr_time)) we can interpret a sequential\n", - "correlation as an effective reduction of the number of measurements by\n", - "a factor $\\tau$. The effective number of measurements becomes" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "n_\\mathrm{eff} = \\frac{n}{\\tau}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "To neglect the autocorrelation time $\\tau$ will always cause our\n", - "simple uncorrelated estimate of $\\sigma_m^2\\approx \\sigma^2/n$ to\n", - "be less than the true sample error. The estimate of the error will be\n", - "too \"good\". On the other hand, the calculation of the full\n", - "autocorrelation time poses an efficiency problem if the set of\n", - "measurements is very large. The solution to this problem is given by \n", - "more practically oriented methods like the blocking technique.\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "## Code to compute the Covariance matrix and the Covariance" - ] - }, - { - "cell_type": "code", - "execution_count": 3, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "-0.000171990965637209\n", - "3.967581388294481\n", - "-0.025521898567525465\n", - "0.853884005749657 8.208733310166176 9.244798847617261\n", - "2.497355838775297 2.088848443911507 6.174325810031482\n", - "[[0.85388401 2.49735584 2.08884844]\n", - " [2.49735584 8.20873331 6.17432581]\n", - " [2.08884844 6.17432581 9.24479885]]\n", - "[15.62869983 0.07851446 2.60020187]\n" - ] - } - ], - "source": [ - "# Importing various packages\n", - "from math import exp, sqrt\n", - "from random import random, seed\n", - "import numpy as np\n", - "import matplotlib.pyplot as plt\n", - "\n", - "# Sample covariance, note the factor 1/(n-1)\n", - "def covariance(x, y, n):\n", - " sum = 0.0\n", - " mean_x = np.mean(x)\n", - " mean_y = np.mean(y)\n", - " for i in range(0, n):\n", - " sum += (x[(i)]-mean_x)*(y[i]-mean_y)\n", - " return sum/(n-1.)\n", - "\n", - "n = 100\n", - "x = np.random.normal(size=n)\n", - "print(np.mean(x))\n", - "y = 4+3*x+np.random.normal(size=n)\n", - "print(np.mean(y))\n", - "z = x**3+np.random.normal(size=n)\n", - "print(np.mean(z))\n", - "covxx = covariance(x,x,n)\n", - "covyy = covariance(y,y,n)\n", - "covzz = covariance(z,z,n)\n", - "covxy = covariance(x,y,n)\n", - "covxz = covariance(x,z,n)\n", - "covyz = covariance(y,z,n)\n", - "print(covxx,covyy, covzz)\n", - "print(covxy,covxz, covyz)\n", - "w = np.vstack((x, y, z))\n", - "#print(w)\n", - "c = np.cov(w)\n", - "print(c)\n", - "#eigen = np.zeros(n)\n", - "Eigvals, Eigvecs = np.linalg.eig(c)\n", - "print(Eigvals)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Random Numbers\n", - "\n", - "Uniform deviates are just random numbers that lie within a specified range\n", - "(typically 0 to 1), with any one number in the range just as likely as any other. They\n", - "are, in other words, what you probably think random numbers are. However,\n", - "we want to distinguish uniform deviates from other sorts of random numbers, for\n", - "example numbers drawn from a normal (Gaussian) distribution of specified mean\n", - "and standard deviation. These other sorts of deviates are almost always generated by\n", - "performing appropriate operations on one or more uniform deviates, as we will see\n", - "in subsequent sections. So, a reliable source of random uniform deviates, the subject\n", - "of this section, is an essential building block for any sort of stochastic modeling\n", - "or Monte Carlo computer work.\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "## Random Numbers, better name: pseudo random numbers\n", - "\n", - "A disclaimer is however appropriate. It should be fairly obvious that \n", - "something as deterministic as a computer cannot generate purely random numbers.\n", - "\n", - "Numbers generated by any of the standard algorithms are in reality pseudo random\n", - "numbers, hopefully abiding to the following criteria:\n", - "\n", - " * they produce a uniform distribution in the interval [0,1].\n", - "\n", - " * correlations between random numbers are negligible\n", - "\n", - " * the period before the same sequence of random numbers is repeated is as large as possible and finally\n", - "\n", - " * the algorithm should be fast.\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "## Random number generator RNG\n", - " The most common random number generators are based on so-called\n", - "Linear congruential relations of the type" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "N_i=(aN_{i-1}+c) \\mathrm{MOD} (M),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which yield a number in the interval [0,1] through" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "x_i=N_i/M\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The number \n", - "$M$ is called the period and it should be as large as possible \n", - " and \n", - "$N_0$ is the starting value, or seed. The function $\\mathrm{MOD}$ means the remainder,\n", - "that is if we were to evaluate $(13)\\mathrm{MOD}(9)$, the outcome is the remainder\n", - "of the division $13/9$, namely $4$.\n", - "\n", - "\n", - "\n", - "\n", - "## Random number generator RNG and periodic outputs\n", - "\n", - "The problem with such generators is that their outputs are periodic;\n", - "they \n", - "will start to repeat themselves with a period that is at most $M$. If however\n", - "the parameters $a$ and $c$ are badly chosen, the period may be even shorter.\n", - "\n", - "Consider the following example" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "N_i=(6N_{i-1}+7) \\mathrm{MOD} (5),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with a seed $N_0=2$. This generator produces the sequence\n", - "$4,1,3,0,2,4,1,3,0,2,...\\dots$, i.e., a sequence with period $5$.\n", - "However, increasing $M$ may not guarantee a larger period as the following\n", - "example shows" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "N_i=(27N_{i-1}+11) \\mathrm{MOD} (54),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which still, with $N_0=2$, results in $11,38,11,38,11,38,\\dots$, a period of\n", - "just $2$.\n", - "\n", - "\n", - "\n", - "\n", - "## Random number generator RNG and its period\n", - "Typical periods for the random generators provided in the program library \n", - "are of the order of $\\sim 10^9$ or larger. Other random number generators which have\n", - "become increasingly popular are so-called shift-register generators.\n", - "In these generators each successive number depends on many preceding\n", - "values (rather than the last values as in the linear congruential\n", - "generator).\n", - "For example, you could make a shift register generator whose $l$th \n", - "number is the sum of the $l-i$th and $l-j$th values with modulo $M$," - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "N_l=(aN_{l-i}+cN_{l-j})\\mathrm{MOD}(M).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Random number generator RNG, other examples\n", - "Such a generator again produces a sequence of pseudorandom numbers\n", - "but this time with a period much larger than $M$.\n", - "It is also possible to construct more elaborate algorithms by including\n", - "more than two past terms in the sum of each iteration.\n", - "One example is the generator of [Marsaglia and Zaman](http://dl.acm.org/citation.cfm?id=187154)\n", - "which consists of two congruential relations" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - " N_l=(N_{l-3}-N_{l-1})\\mathrm{MOD}(2^{31}-69),\n", - "\\label{eq:mz1} \\tag{12}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "followed by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - " N_l=(69069N_{l-1}+1013904243)\\mathrm{MOD}(2^{32}),\n", - "\\label{eq:mz2} \\tag{13}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which according to the authors has a period larger than $2^{94}$.\n", - "\n", - "\n", - "\n", - "\n", - "## Random number generator RNG, other examples\n", - "Instead of using modular addition, we could use the bitwise\n", - "exclusive-OR ($\\oplus$) operation so that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "N_l=(N_{l-i})\\oplus (N_{l-j})\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where the bitwise action of $\\oplus$ means that if $N_{l-i}=N_{l-j}$ the result is\n", - "$0$ whereas if $N_{l-i}\\ne N_{l-j}$ the result is\n", - "$1$. As an example, consider the case where $N_{l-i}=6$ and $N_{l-j}=11$. The first\n", - "one has a bit representation (using 4 bits only) which reads $0110$ whereas the \n", - "second number is $1011$. Employing the $\\oplus$ operator yields \n", - "$1101$, or $2^3+2^2+2^0=13$.\n", - "\n", - "In Fortran90, the bitwise $\\oplus$ operation is coded through the intrinsic\n", - "function $\\mathrm{IEOR}(m,n)$ where $m$ and $n$ are the input numbers, while in $C$\n", - "it is given by $m\\wedge n$.\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "## Random number generator RNG, RAN0\n", - "\n", - "We show here how the linear congruential algorithm can be implemented, namely" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "N_i=(aN_{i-1}) \\mathrm{MOD} (M).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "However, since $a$ and $N_{i-1}$ are integers and their multiplication \n", - "could become greater than the standard 32 bit integer, there is a trick via \n", - "Schrage's algorithm which approximates the multiplication\n", - "of large integers through the factorization" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "M=aq+r,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where we have defined" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "q=[M/a],\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "r = M\\hspace{0.1cm}\\mathrm{MOD} \\hspace{0.1cm}a.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where the brackets denote integer division. In the code below the numbers \n", - "$q$ and $r$ are chosen so that $r < q$.\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "## Random number generator RNG, RAN0\n", - "\n", - "To see how this works we note first that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - "(aN_{i-1}) \\mathrm{MOD} (M)= (aN_{i-1}-[N_{i-1}/q]M)\\mathrm{MOD} (M),\n", - "\\label{eq:rntrick1} \\tag{14}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "since we can add or subtract any integer multiple of $M$ from $aN_{i-1}$.\n", - "The last term $[N_{i-1}/q]M\\mathrm{MOD}(M)$ is zero since the integer division \n", - "$[N_{i-1}/q]$ just yields a constant which is multiplied with $M$.\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "## Random number generator RNG, RAN0\n", - "We can now rewrite Eq. ([14](#eq:rntrick1)) as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - "(aN_{i-1}) \\mathrm{MOD} (M)= (aN_{i-1}-[N_{i-1}/q](aq+r))\\mathrm{MOD} (M),\n", - "\\label{eq:rntrick2} \\tag{15}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "which results\n", - "in" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - "(aN_{i-1}) \\mathrm{MOD} (M)= \\left(a(N_{i-1}-[N_{i-1}/q]q)-[N_{i-1}/q]r)\\right)\\mathrm{MOD} (M),\n", - "\\label{eq:rntrick3} \\tag{16}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "yielding" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "
\n", - "\n", - "$$\n", - "\\begin{equation}\n", - "(aN_{i-1}) \\mathrm{MOD} (M)= \\left(a(N_{i-1}\\mathrm{MOD} (q)) -[N_{i-1}/q]r)\\right)\\mathrm{MOD} (M).\n", - "\\label{eq:rntrick4} \\tag{17}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Random number generator RNG, RAN0\n", - "The term $[N_{i-1}/q]r$ is always smaller or equal $N_{i-1}(r/q)$ and with $r < q$ we obtain always a \n", - "number smaller than $N_{i-1}$, which is smaller than $M$. \n", - "And since the number $N_{i-1}\\mathrm{MOD} (q)$ is between zero and $q-1$ then\n", - "$a(N_{i-1}\\mathrm{MOD} (q))< aq$. Combined with our definition of $q=[M/a]$ ensures that \n", - "this term is also smaller than $M$ meaning that both terms fit into a\n", - "32-bit signed integer. None of these two terms can be negative, but their difference could.\n", - "The algorithm below adds $M$ if their difference is negative.\n", - "Note that the program uses the bitwise $\\oplus$ operator to generate\n", - "the starting point for each generation of a random number. The period\n", - "of $ran0$ is $\\sim 2.1\\times 10^{9}$. A special feature of this\n", - "algorithm is that is should never be called with the initial seed \n", - "set to $0$.\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "## Random number generator RNG, RAN0 code" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - " /*\n", - " ** The function\n", - " ** ran0()\n", - " ** is an \"Minimal\" random number generator of Park and Miller\n", - " ** Set or reset the input value\n", - " ** idum to any integer value (except the unlikely value MASK)\n", - " ** to initialize the sequence; idum must not be altered between\n", - " ** calls for sucessive deviates in a sequence.\n", - " ** The function returns a uniform deviate between 0.0 and 1.0.\n", - " */\n", - " double ran0(long &idum)\n", - " {\n", - " const int a = 16807, m = 2147483647, q = 127773;\n", - " const int r = 2836, MASK = 123459876;\n", - " const double am = 1./m;\n", - " long k;\n", - " double ans;\n", - " idum ^= MASK;\n", - " k = (*idum)/q;\n", - " idum = a*(idum - k*q) - r*k;\n", - " // add m if negative difference\n", - " if(idum < 0) idum += m;\n", - " ans=am*(idum);\n", - " idum ^= MASK;\n", - " return ans;\n", - " } // End: function ran0() \n" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Properties of Selected Random Number Generators\n", - "\n", - "As mentioned previously, the underlying PDF for the generation of\n", - "random numbers is the uniform distribution, meaning that the \n", - "probability for finding a number $x$ in the interval [0,1] is $p(x)=1$.\n", - "\n", - "A random number generator should produce numbers which are uniformly distributed\n", - "in this interval. The table shows the distribution of $N=10000$ random\n", - "numbers generated by the functions in the program library.\n", - "We note in this table that the number of points in the various\n", - "intervals $0.0-0.1$, $0.1-0.2$ etc are fairly close to $1000$, with some minor\n", - "deviations. \n", - "\n", - "Two additional measures are the standard deviation $\\sigma$ and the mean\n", - "$\\mu=\\langle x\\rangle$.\n", - "\n", - "\n", - "\n", - "\n", - "## Properties of Selected Random Number Generators\n", - "For the uniform distribution, the mean value $\\mu$ is then" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mu=\\langle x\\rangle=\\frac{1}{2}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "while the standard deviation is" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\sigma=\\sqrt{\\langle x^2\\rangle-\\mu^2}=\\frac{1}{\\sqrt{12}}=0.2886.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Properties of Selected Random Number Generators\n", - "The various random number generators produce results which agree rather well with\n", - "these limiting values. \n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "
$x$-bin ran0 ran1 ran2 ran3
0.0-0.1 1013 991 938 1047
0.1-0.2 1002 1009 1040 1030
0.2-0.3 989 999 1030 993
0.3-0.4 939 960 1023 937
0.4-0.5 1038 1001 1002 992
0.5-0.6 1037 1047 1009 1009
0.6-0.7 1005 989 1003 989
0.7-0.8 986 962 985 954
0.8-0.9 1000 1027 1009 1023
0.9-1.0 991 1015 961 1026
$\\mu$ 0.4997 0.5018 0.4992 0.4990
$\\sigma$ 0.2882 0.2892 0.2861 0.2915
\n", - "\n", - "\n", - "\n", - "\n", - "## Simple demonstration of RNGs using python\n", - "The following simple Python code plots the distribution of the produced random numbers using the linear congruential RNG employed by Python. The trend displayed in the previous table is seen rather clearly." - ] - }, - { - "cell_type": "code", - "execution_count": 4, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "data": { - "image/png": "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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/statistics_178_0.png" - }, - "needs_background": "light" - }, - "output_type": "display_data" - } - ], - "source": [ - "#!/usr/bin/env python\n", - "import numpy as np\n", - "import matplotlib.mlab as mlab\n", - "import matplotlib.pyplot as plt\n", - "import random\n", - "\n", - "# initialize the rng with a seed\n", - "random.seed() \n", - "counts = 10000\n", - "values = np.zeros(counts) \n", - "for i in range (1, counts, 1):\n", - " values[i] = random.random()\n", - "\n", - "# the histogram of the data\n", - "n, bins, patches = plt.hist(values, 10, facecolor='green')\n", - "\n", - "plt.xlabel('$x$')\n", - "plt.ylabel('Number of counts')\n", - "plt.title(r'Test of uniform distribution')\n", - "plt.axis([0, 1, 0, 1100])\n", - "plt.grid(True)\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Properties of Selected Random Number Generators\n", - "Since our random numbers, which are typically generated via a linear congruential algorithm,\n", - "are never fully independent, we can then define \n", - "an important test which measures the degree of correlation, namely the so-called \n", - "auto-correlation function defined previously, see again Eq. ([9](#eq:autocorrelformal)).\n", - "We rewrite it here as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C_k=\\frac{f_d}\n", - " {\\sigma^2},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with $C_0=1$. Recall that \n", - "$\\sigma^2=\\langle x_i^2\\rangle-\\langle x_i\\rangle^2$ and that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "f_d = \\frac{1}{nm}\\sum_{\\alpha=1}^m\\sum_{k=1}^{n-d}(x_{\\alpha,k}-\\langle X_m \\rangle)(x_{\\alpha,k+d}-\\langle X_m \\rangle),\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The non-vanishing of $C_k$ for $k\\ne 0$ means that the random\n", - "numbers are not independent. The independence of the random numbers is crucial \n", - "in the evaluation of other expectation values. If they are not independent, our\n", - "assumption for approximating $\\sigma_N$ is no longer valid.\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "## Autocorrelation function\n", - "This program computes the autocorrelation function as discussed in the equation on the previous slide for random numbers generated with the normal distribution $N(0,1)$." - ] - }, - { - "cell_type": "code", - "execution_count": 5, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "0.005481494389472717 1.029117514654528\n" - ] - }, - { - "data": { - "image/png": "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\n", - "text/plain": [ - "
" - ] - }, - "metadata": { - "filenames": { - "image/png": "/Users/mhjensen/Teaching/MachineLearning/doc/LectureNotes/_build/jupyter_execute/statistics_184_1.png" - }, - "needs_background": "light" - }, - "output_type": "display_data" - } - ], - "source": [ - "# Importing various packages\n", - "from math import exp, sqrt\n", - "from random import random, seed\n", - "import numpy as np\n", - "import matplotlib.pyplot as plt\n", - "\n", - "def autocovariance(x, n, k, mean_x):\n", - " sum = 0.0\n", - " for i in range(0, n-k):\n", - " sum += (x[(i+k)]-mean_x)*(x[i]-mean_x)\n", - " return sum/n\n", - "\n", - "n = 1000\n", - "x=np.random.normal(size=n)\n", - "autocor = np.zeros(n)\n", - "figaxis = np.zeros(n)\n", - "mean_x=np.mean(x)\n", - "var_x = np.var(x)\n", - "print(mean_x, var_x)\n", - "for i in range (0, n):\n", - " figaxis[i] = i\n", - " autocor[i]=(autocovariance(x, n, i, mean_x))/var_x \n", - "\n", - "plt.plot(figaxis, autocor, \"r-\")\n", - "plt.axis([0,n,-0.1, 1.0])\n", - "plt.xlabel(r'$i$')\n", - "plt.ylabel(r'$\\gamma_i$')\n", - "plt.title(r'Autocorrelation function')\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "As can be seen from the plot, the first point gives back the variance and a value of one. \n", - "For the remaining values we notice that there are still non-zero values for the auto-correlation function.\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "## Correlation function and which random number generators should I use\n", - "The program here computes the correlation function for one of the standard functions included with the c++ compiler." - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - " // This function computes the autocorrelation function for \n", - " // the standard c++ random number generator\n", - " \n", - " #include \n", - " #include \n", - " #include \n", - " #include \n", - " using namespace std;\n", - " // output file as global variable\n", - " ofstream ofile; \n", - " \n", - " // Main function begins here \n", - " int main(int argc, char* argv[])\n", - " {\n", - " int n;\n", - " char *outfilename;\n", - " \n", - " cin >> n;\n", - " double MCint = 0.; double MCintsqr2=0.;\n", - " double invers_period = 1./RAND_MAX; // initialise the random number generator\n", - " srand(time(NULL)); // This produces the so-called seed in MC jargon\n", - " // Compute the variance and the mean value of the uniform distribution\n", - " // Compute also the specific values x for each cycle in order to be able to\n", - " // the covariance and the correlation function \n", - " // Read in output file, abort if there are too few command-line arguments\n", - " if( argc <= 2 ){\n", - " cout << \"Bad Usage: \" << argv[0] << \n", - " \t \" read also output file and number of cycles on same line\" << endl;\n", - " exit(1);\n", - " }\n", - " else{\n", - " outfilename=argv[1];\n", - " }\n", - " ofile.open(outfilename); \n", - " // Get the number of Monte-Carlo samples\n", - " n = atoi(argv[2]);\n", - " double *X; \n", - " X = new double[n];\n", - " for (int i = 0; i < n; i++){\n", - " double x = double(rand())*invers_period; \n", - " X[i] = x;\n", - " MCint += x;\n", - " MCintsqr2 += x*x;\n", - " }\n", - " double Mean = MCint/((double) n );\n", - " MCintsqr2 = MCintsqr2/((double) n );\n", - " double STDev = sqrt(MCintsqr2-Mean*Mean);\n", - " double Variance = MCintsqr2-Mean*Mean;\n", - " // Write mean value and standard deviation \n", - " cout << \" Standard deviation= \" << STDev << \" Integral = \" << Mean << endl;\n", - " \n", - " // Now we compute the autocorrelation function\n", - " double *autocor; autocor = new double[n];\n", - " for (int j = 0; j < n; j++){\n", - " double sum = 0.0;\n", - " for (int k = 0; k < (n-j); k++){\n", - " \t sum += (X[k]-Mean)*(X[k+j]-Mean); \n", - " }\n", - " autocor[j] = sum/Variance/((double) n );\n", - " ofile << setiosflags(ios::showpoint | ios::uppercase);\n", - " ofile << setw(15) << setprecision(8) << j;\n", - " ofile << setw(15) << setprecision(8) << autocor[j] << endl;\n", - " }\n", - " ofile.close(); // close output file\n", - " return 0;\n", - " } // end of main program \n" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Which RNG should I use?\n", - "* C++ has a class called **random**. The [random class](http://www.cplusplus.com/reference/random/) contains a large selection of RNGs and is highly recommended. Some of these RNGs have very large periods making it thereby very safe to use these RNGs in case one is performing large calculations. In particular, the [Mersenne twister random number engine](http://www.cplusplus.com/reference/random/mersenne_twister_engine/) has a period of $2^{19937}$. \n", - "\n", - "* Add RNGs in Python\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "## How to use the Mersenne generator\n", - "The following part of a c++ code (from project 4) sets up the uniform distribution for $x\\in [0,1]$." - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - " /*\n", - " \n", - " // You need this \n", - " #include \n", - " \n", - " // Initialize the seed and call the Mersienne algo\n", - " std::random_device rd;\n", - " std::mt19937_64 gen(rd());\n", - " // Set up the uniform distribution for x \\in [[0, 1]\n", - " std::uniform_real_distribution RandomNumberGenerator(0.0,1.0);\n", - " \n", - " // Now use the RNG\n", - " int ix = (int) (RandomNumberGenerator(gen)*NSpins);\n" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Why blocking?\n", - "**Statistical analysis.**\n", - "\n", - " * Monte Carlo simulations can be treated as *computer experiments*\n", - "\n", - " * The results can be analysed with the same statistical tools as we would use analysing experimental data.\n", - "\n", - " * As in all experiments, we are looking for expectation values and an estimate of how accurate they are, i.e., possible sources for errors.\n", - "\n", - "A very good article which explains blocking is H. Flyvbjerg and H. G. Petersen, *Error estimates on averages of correlated data*, [Journal of Chemical Physics 91, 461-466 (1989)](http://scitation.aip.org/content/aip/journal/jcp/91/1/10.1063/1.457480).\n", - "\n", - " \n", - "\n", - "\n", - "\n", - "\n", - "## Why blocking?\n", - "**Statistical analysis.**\n", - "\n", - " * As in other experiments, Monte Carlo experiments have two classes of errors:\n", - "\n", - " * Statistical errors\n", - "\n", - " * Systematical errors\n", - "\n", - "\n", - " * Statistical errors can be estimated using standard tools from statistics\n", - "\n", - " * Systematical errors are method specific and must be treated differently from case to case. (In VMC a common source is the step length or time step in importance sampling)\n", - "\n", - " \n", - "\n", - "\n", - "\n", - "## Code to demonstrate the calculation of the autocorrelation function\n", - "The following code computes the autocorrelation function, the covariance and the standard deviation\n", - "for standard RNG. \n", - "The [following file](https://github.com/CompPhysics/ComputationalPhysics2/tree/gh-pages/doc/Programs/LecturePrograms/programs/Blocking/autocorrelation.cpp) gives the code." - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - " // This function computes the autocorrelation function for \n", - " // the Mersenne random number generator with a uniform distribution\n", - " #include \n", - " #include \n", - " #include \n", - " #include \n", - " #include \n", - " #include \n", - " #include \n", - " #include \n", - " using namespace std;\n", - " using namespace arma;\n", - " // output file\n", - " ofstream ofile;\n", - " \n", - " // Main function begins here \n", - " int main(int argc, char* argv[])\n", - " {\n", - " int MonteCarloCycles;\n", - " string filename;\n", - " if (argc > 1) {\n", - " filename=argv[1];\n", - " MonteCarloCycles = atoi(argv[2]);\n", - " string fileout = filename;\n", - " string argument = to_string(MonteCarloCycles);\n", - " fileout.append(argument);\n", - " ofile.open(fileout);\n", - " }\n", - " \n", - " // Compute the variance and the mean value of the uniform distribution\n", - " // Compute also the specific values x for each cycle in order to be able to\n", - " // compute the covariance and the correlation function \n", - " \n", - " vec X = zeros(MonteCarloCycles);\n", - " double MCint = 0.; double MCintsqr2=0.;\n", - " std::random_device rd;\n", - " std::mt19937_64 gen(rd());\n", - " // Set up the uniform distribution for x \\in [[0, 1]\n", - " std::uniform_real_distribution RandomNumberGenerator(0.0,1.0);\n", - " for (int i = 0; i < MonteCarloCycles; i++){\n", - " double x = RandomNumberGenerator(gen); \n", - " X(i) = x;\n", - " MCint += x;\n", - " MCintsqr2 += x*x;\n", - " }\n", - " double Mean = MCint/((double) MonteCarloCycles );\n", - " MCintsqr2 = MCintsqr2/((double) MonteCarloCycles );\n", - " double STDev = sqrt(MCintsqr2-Mean*Mean);\n", - " double Variance = MCintsqr2-Mean*Mean;\n", - " // Write mean value and variance\n", - " cout << \" Sample variance= \" << Variance << \" Mean value = \" << Mean << endl;\n", - " // Now we compute the autocorrelation function\n", - " vec autocorrelation = zeros(MonteCarloCycles);\n", - " for (int j = 0; j < MonteCarloCycles; j++){\n", - " double sum = 0.0;\n", - " for (int k = 0; k < (MonteCarloCycles-j); k++){\n", - " sum += (X(k)-Mean)*(X(k+j)-Mean); \n", - " }\n", - " autocorrelation(j) = sum/Variance/((double) MonteCarloCycles );\n", - " ofile << setiosflags(ios::showpoint | ios::uppercase);\n", - " ofile << setw(15) << setprecision(8) << j;\n", - " ofile << setw(15) << setprecision(8) << autocorrelation(j) << endl;\n", - " }\n", - " // Now compute the exact covariance using the autocorrelation function\n", - " double Covariance = 0.0;\n", - " for (int j = 0; j < MonteCarloCycles; j++){\n", - " Covariance += autocorrelation(j);\n", - " }\n", - " Covariance *= 2.0/((double) MonteCarloCycles);\n", - " // Compute now the total variance, including the covariance, and obtain the standard deviation\n", - " double TotalVariance = (Variance/((double) MonteCarloCycles ))+Covariance;\n", - " cout << \"Covariance =\" << Covariance << \"Totalvariance= \" << TotalVariance << \"Sample Variance/n= \" << (Variance/((double) MonteCarloCycles )) << endl;\n", - " cout << \" STD from sample variance= \" << sqrt(Variance/((double) MonteCarloCycles )) << \" STD with covariance = \" << sqrt(TotalVariance) << endl;\n", - " \n", - " ofile.close(); // close output file\n", - " return 0;\n", - " } // end of main program \n", - " \n", - " \n" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## What is blocking?\n", - "**Blocking.**\n", - "\n", - " * Say that we have a set of samples from a Monte Carlo experiment\n", - "\n", - " * Assuming (wrongly) that our samples are uncorrelated our best estimate of the standard deviation of the mean $\\langle \\mathbf{M}\\rangle$ is given by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\sigma=\\sqrt{\\frac{1}{n}\\left(\\langle \\mathbf{M}^2\\rangle-\\langle \\mathbf{M}\\rangle^2\\right)}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "* If the samples are correlated we can rewrite our results to show that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\sigma=\\sqrt{\\frac{1+2\\tau/\\Delta t}{n}\\left(\\langle \\mathbf{M}^2\\rangle-\\langle \\mathbf{M}\\rangle^2\\right)}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $\\tau$ is the correlation time (the time between a sample and the next uncorrelated sample) and $\\Delta t$ is time between each sample\n", - "\n", - " \n", - "\n", - "\n", - "## What is blocking?\n", - "**Blocking.**\n", - "\n", - " * If $\\Delta t\\gg\\tau$ our first estimate of $\\sigma$ still holds\n", - "\n", - " * Much more common that $\\Delta t<\\tau$\n", - "\n", - " * In the method of data blocking we divide the sequence of samples into blocks\n", - "\n", - " * We then take the mean $\\langle \\mathbf{M}_i\\rangle$ of block $i=1\\ldots n_{blocks}$ to calculate the total mean and variance\n", - "\n", - " * The size of each block must be so large that sample $j$ of block $i$ is not correlated with sample $j$ of block $i+1$\n", - "\n", - " * The correlation time $\\tau$ would be a good choice\n", - "\n", - "\n", - "\n", - "\n", - "## What is blocking?\n", - "**Blocking.**\n", - "\n", - " * Problem: We don't know $\\tau$ or it is too expensive to compute\n", - "\n", - " * Solution: Make a plot of std. dev. as a function of blocksize\n", - "\n", - " * The estimate of std. dev. of correlated data is too low $\\to$ the error will increase with increasing block size until the blocks are uncorrelated, where we reach a plateau\n", - "\n", - " * When the std. dev. stops increasing the blocks are uncorrelated\n", - "\n", - "\n", - "\n", - "\n", - "## Implementation\n", - " * Do a Monte Carlo simulation, storing all samples to file\n", - "\n", - " * Do the statistical analysis on this file, independently of your Monte Carlo program\n", - "\n", - " * Read the file into an array\n", - "\n", - " * Loop over various block sizes\n", - "\n", - " * For each block size $n_b$, loop over the array in steps of $n_b$ taking the mean of elements $i n_b,\\ldots,(i+1) n_b$\n", - "\n", - " * Take the mean and variance of the resulting array\n", - "\n", - " * Write the results for each block size to file for later\n", - " analysis\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "## Actual implementation with code, main function\n", - "When the file gets large, it can be useful to write your data in binary mode instead of ascii characters.\n", - "The [following python file](https://github.com/CompPhysics/MachineLearning/blob/master/doc/Programs/Sampling/analysis.py) reads data from file with the output from every Monte Carlo cycle." - ] - }, - { - "cell_type": "code", - "execution_count": 6, - "metadata": { - "collapsed": false, - "editable": true - }, - "outputs": [ - { - "ename": "IndentationError", - "evalue": "unexpected indent (, line 2)", - "output_type": "error", - "traceback": [ - "\u001b[0;36m File \u001b[0;32m\"\"\u001b[0;36m, line \u001b[0;32m2\u001b[0m\n\u001b[0;31m @timeFunction\u001b[0m\n\u001b[0m ^\u001b[0m\n\u001b[0;31mIndentationError\u001b[0m\u001b[0;31m:\u001b[0m unexpected indent\n" - ] - } - ], - "source": [ - "# Blocking\n", - " @timeFunction\n", - " def blocking(self, blockSizeMax = 500):\n", - " blockSizeMin = 1\n", - "\n", - " self.blockSizes = []\n", - " self.meanVec = []\n", - " self.varVec = []\n", - "\n", - " for i in range(blockSizeMin, blockSizeMax):\n", - " if(len(self.data) % i != 0):\n", - " pass#continue\n", - " blockSize = i\n", - " meanTempVec = []\n", - " varTempVec = []\n", - " startPoint = 0\n", - " endPoint = blockSize\n", - "\n", - " while endPoint <= len(self.data):\n", - " meanTempVec.append(np.average(self.data[startPoint:endPoint]))\n", - " startPoint = endPoint\n", - " endPoint += blockSize\n", - " mean, var = np.average(meanTempVec), np.var(meanTempVec)/len(meanTempVec)\n", - " self.meanVec.append(mean)\n", - " self.varVec.append(var)\n", - " self.blockSizes.append(blockSize)\n", - "\n", - " self.blockingAvg = np.average(self.meanVec[-200:])\n", - " self.blockingVar = (np.average(self.varVec[-200:]))\n", - " self.blockingStd = np.sqrt(self.blockingVar)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## The Bootstrap method\n", - "\n", - "The Bootstrap resampling method is also very popular. It is very simple:\n", - "\n", - "1. Start with your sample of measurements and compute the sample variance and the mean values\n", - "\n", - "2. Then start again but pick in a random way the numbers in the sample and recalculate the mean and the sample variance.\n", - "\n", - "3. Repeat this $K$ times.\n", - "\n", - "It can be shown, see the article by [Efron](https://projecteuclid.org/download/pdf_1/euclid.aos/1176344552)\n", - "that it produces the correct standard deviation.\n", - "\n", - "This method is very useful for small ensembles of data points. \n", - "\n", - "\n", - "## Bootstrapping\n", - "Given a set of $N$ data, assume that we are interested in some \n", - "observable $\\theta$ which may be estimated from that set. This observable can also be for example the result of a fit based on all $N$ raw data. \n", - "Let us call the value of the observable obtained from the original \n", - "data set $\\hat{\\theta}$. One recreates from the sample repeatedly \n", - "other samples by choosing randomly $N$ data out of the original set. \n", - "This costs essentially nothing, since we just recycle the original data set for the building of new sets. \n", - "\n", - "\n", - "## Bootstrapping, recipe\n", - "Let us assume we have done this $K$ times and thus have $K$ sets of $N$ \n", - "data values each. \n", - "Of course some values will enter more than once in the new sets. For each of these sets one computes the observable $\\theta$ resulting in values $\\theta_k$ with $k = 1,...,K$. Then one determines" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\tilde{\\theta} = \\frac{1}{K} \\sum_{k=1}^K \\theta_k,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "sigma^2_{\\tilde{\\theta}} = \\frac{1}{K} \\sum_{k=1}^K \\left(\\theta_k-\\tilde{\\theta}\\right)^2.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "These are estimators for $\\angle\\theta\\rangle$ and its variance. They are not unbiased and therefore \n", - "$\\tilde{\\theta}\\neq\\hat{\\theta}$ for finite K. \n", - "\n", - "The difference is called bias and gives an idea on how far away the result may be from \n", - "the true $\\angle\\theta\\rangle$. As final result for the observable one quotes $\\angle\\theta\\rangle = \\tilde{\\theta} \\pm \\sigma_{\\tilde{\\theta}}$ .\n", - "\n", - "\n", - "\n", - "## Bootstrapping, [code](https://github.com/CompPhysics/MachineLearning/blob/master/doc/Programs/Sampling/analysis.py)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - " # Bootstrap\n", - " @timeFunction\n", - " def bootstrap(self, nBoots = 1000):\n", - " bootVec = np.zeros(nBoots)\n", - " for k in range(0,nBoots):\n", - " bootVec[k] = np.average(np.random.choice(self.data, len(self.data)))\n", - " self.bootAvg = np.average(bootVec)\n", - " self.bootVar = np.var(bootVec)\n", - " self.bootStd = np.std(bootVec)\n" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Jackknife, [code](https://github.com/CompPhysics/MachineLearning/blob/master/doc/Programs/Sampling/analysis.py)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - " # Jackknife\n", - " @timeFunction\n", - " def jackknife(self):\n", - " jackknVec = np.zeros(len(self.data))\n", - " for k in range(0,len(self.data)):\n", - " jackknVec[k] = np.average(np.delete(self.data, k))\n", - " self.jackknAvg = self.avg - (len(self.data) - 1) * (np.average(jackknVec) - self.avg)\n", - " self.jackknVar = float(len(self.data) - 1) * np.var(jackknVec)\n", - " self.jackknStd = np.sqrt(self.jackknVar)\n" - ] - } - ], - "metadata": { - "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.8.5" - } - }, - "nbformat": 4, - "nbformat_minor": 4 -} \ No newline at end of file diff --git a/doc/LectureNotes/_build/jupyter_execute/statistics.py b/doc/LectureNotes/_build/jupyter_execute/statistics.py deleted file mode 100644 index de12f2a6f..000000000 --- a/doc/LectureNotes/_build/jupyter_execute/statistics.py +++ /dev/null @@ -1,1824 +0,0 @@ -# Elements of Probability Theory and Statistical Data Analysis - - -## Domains and probabilities -Consider the following simple example, namely the tossing of two dice, resulting in the following possible values - -$$ -\{2,3,4,5,6,7,8,9,10,11,12\}. -$$ - -These values are called the *domain*. -To this domain we have the corresponding *probabilities* - -$$ -\{1/36,2/36/,3/36,4/36,5/36,6/36,5/36,4/36,3/36,2/36,1/36\}. -$$ - -## Tossing the dice -The numbers in the domain are the outcomes of the physical process of tossing say two dice. -We cannot tell beforehand whether the outcome is 3 or 5 or any other number in this domain. -This defines the randomness of the outcome, or unexpectedness or any other synonimous word which -encompasses the uncertitude of the final outcome. - -The only thing we can tell beforehand -is that say the outcome 2 has a certain probability. -If our favorite hobby is to spend an hour every evening throwing dice and -registering the sequence of outcomes, we will note that the numbers in the above domain - -$$ -\{2,3,4,5,6,7,8,9,10,11,12\}, -$$ - -appear in a random order. After 11 throws the results may look like - -$$ -\{10,8,6,3,6,9,11,8,12,4,5\}. -$$ - -## Stochastic variables - -**Random variables are characterized by a domain which contains all possible values that the random value may take. This domain has a corresponding probability distribution function(PDF)**. - - - - -## Stochastic variables and the main concepts, the discrete case -There are two main concepts associated with a stochastic variable. The -*domain* is the set $\mathbb D = \{x\}$ of all accessible values -the variable can assume, so that $X \in \mathbb D$. An example of a -discrete domain is the set of six different numbers that we may get by -throwing of a dice, $x\in\{1,\,2,\,3,\,4,\,5,\,6\}$. - -The *probability distribution function (PDF)* is a function -$p(x)$ on the domain which, in the discrete case, gives us the -probability or relative frequency with which these values of $X$ -occur - -$$ -p(x) = \mathrm{Prob}(X=x). -$$ - -## Stochastic variables and the main concepts, the continuous case -In the continuous case, the PDF does not directly depict the -actual probability. Instead we define the probability for the -stochastic variable to assume any value on an infinitesimal interval -around $x$ to be $p(x)dx$. The continuous function $p(x)$ then gives us -the *density* of the probability rather than the probability -itself. The probability for a stochastic variable to assume any value -on a non-infinitesimal interval $[a,\,b]$ is then just the integral - -$$ -\mathrm{Prob}(a\leq X\leq b) = \int_a^b p(x)dx. -$$ - -Qualitatively speaking, a stochastic variable represents the values of -numbers chosen as if by chance from some specified PDF so that the -selection of a large set of these numbers reproduces this PDF. - - - - -## The cumulative probability -Of interest to us is the *cumulative probability -distribution function* (**CDF**), $P(x)$, which is just the probability -for a stochastic variable $X$ to assume any value less than $x$ - -$$ -P(x)=\mathrm{Prob(}X\leq x\mathrm{)} = -\int_{-\infty}^x p(x^{\prime})dx^{\prime}. -$$ - -The relation between a CDF and its corresponding PDF is then - -$$ -p(x) = \frac{d}{dx}P(x). -$$ - -## Properties of PDFs - -There are two properties that all PDFs must satisfy. The first one is -positivity (assuming that the PDF is normalized) - -$$ -0 \leq p(x) \leq 1. -$$ - -Naturally, it would be nonsensical for any of the values of the domain -to occur with a probability greater than $1$ or less than $0$. Also, -the PDF must be normalized. That is, all the probabilities must add up -to unity. The probability of "anything" to happen is always unity. For -both discrete and continuous PDFs, this condition is - -$$ -\begin{align*} -\sum_{x_i\in\mathbb D} p(x_i) & = 1,\\ -\int_{x\in\mathbb D} p(x)\,dx & = 1. -\end{align*} -$$ - -## Important distributions, the uniform distribution -The first one -is the most basic PDF; namely the uniform distribution - - -
- -$$ -\begin{equation} -p(x) = \frac{1}{b-a}\theta(x-a)\theta(b-x). -\label{eq:unifromPDF} \tag{1} -\end{equation} -$$ - -For $a=0$ and $b=1$ we have - -$$ -\begin{array}{ll} -p(x)dx = dx & \in [0,1]. -\end{array} -$$ - -The latter distribution is used to generate random numbers. For other PDFs, one needs normally a mapping from this distribution to say for example the exponential distribution. - - - - -## Gaussian distribution -The second one is the Gaussian Distribution - -$$ -p(x) = \frac{1}{\sigma\sqrt{2\pi}} \exp{(-\frac{(x-\mu)^2}{2\sigma^2})}, -$$ - -with mean value $\mu$ and standard deviation $\sigma$. If $\mu=0$ and $\sigma=1$, it is normally called the **standard normal distribution** - -$$ -p(x) = \frac{1}{\sqrt{2\pi}} \exp{(-\frac{x^2}{2})}, -$$ - -The following simple Python code plots the above distribution for different values of $\mu$ and $\sigma$. - -%matplotlib inline - -import numpy as np -from math import acos, exp, sqrt -from matplotlib import pyplot as plt -from matplotlib import rc, rcParams -import matplotlib.units as units -import matplotlib.ticker as ticker -rc('text',usetex=True) -rc('font',**{'family':'serif','serif':['Gaussian distribution']}) -font = {'family' : 'serif', - 'color' : 'darkred', - 'weight' : 'normal', - 'size' : 16, - } -pi = acos(-1.0) -mu0 = 0.0 -sigma0 = 1.0 -mu1= 1.0 -sigma1 = 2.0 -mu2 = 2.0 -sigma2 = 4.0 - -x = np.linspace(-20.0, 20.0) -v0 = np.exp(-(x*x-2*x*mu0+mu0*mu0)/(2*sigma0*sigma0))/sqrt(2*pi*sigma0*sigma0) -v1 = np.exp(-(x*x-2*x*mu1+mu1*mu1)/(2*sigma1*sigma1))/sqrt(2*pi*sigma1*sigma1) -v2 = np.exp(-(x*x-2*x*mu2+mu2*mu2)/(2*sigma2*sigma2))/sqrt(2*pi*sigma2*sigma2) -plt.plot(x, v0, 'b-', x, v1, 'r-', x, v2, 'g-') -plt.title(r'{\bf Gaussian distributions}', fontsize=20) -plt.text(-19, 0.3, r'Parameters: $\mu = 0$, $\sigma = 1$', fontdict=font) -plt.text(-19, 0.18, r'Parameters: $\mu = 1$, $\sigma = 2$', fontdict=font) -plt.text(-19, 0.08, r'Parameters: $\mu = 2$, $\sigma = 4$', fontdict=font) -plt.xlabel(r'$x$',fontsize=20) -plt.ylabel(r'$p(x)$ [MeV]',fontsize=20) - -# Tweak spacing to prevent clipping of ylabel -plt.subplots_adjust(left=0.15) -plt.savefig('gaussian.pdf', format='pdf') -plt.show() - -## Exponential distribution -Another important distribution in science is the exponential distribution - -$$ -p(x) = \alpha\exp{-(\alpha x)}. -$$ - -## Expectation values -Let $h(x)$ be an arbitrary continuous function on the domain of the stochastic -variable $X$ whose PDF is $p(x)$. We define the *expectation value* -of $h$ with respect to $p$ as follows - - -
- -$$ -\begin{equation} -\langle h \rangle_X \equiv \int\! h(x)p(x)\,dx -\label{eq:expectation_value_of_h_wrt_p} \tag{2} -\end{equation} -$$ - -Whenever the PDF is known implicitly, like in this case, we will drop -the index $X$ for clarity. -A particularly useful class of special expectation values are the -*moments*. The $n$-th moment of the PDF $p$ is defined as -follows - -$$ -\langle x^n \rangle \equiv \int\! x^n p(x)\,dx -$$ - -## Stochastic variables and the main concepts, mean values -The zero-th moment $\langle 1\rangle$ is just the normalization condition of -$p$. The first moment, $\langle x\rangle$, is called the *mean* of $p$ -and often denoted by the letter $\mu$ - -$$ -\langle x\rangle = \mu \equiv \int x p(x)dx, -$$ - -for a continuous distribution and - -$$ -\langle x\rangle = \mu \equiv \sum_{i=1}^N x_i p(x_i), -$$ - -for a discrete distribution. -Qualitatively it represents the centroid or the average value of the -PDF and is therefore simply called the expectation value of $p(x)$. - - - - -## Stochastic variables and the main concepts, central moments, the variance - -A special version of the moments is the set of *central moments*, the n-th central moment defined as - -$$ -\langle (x-\langle x\rangle )^n\rangle \equiv \int\! (x-\langle x\rangle)^n p(x)\,dx -$$ - -The zero-th and first central moments are both trivial, equal $1$ and -$0$, respectively. But the second central moment, known as the -*variance* of $p$, is of particular interest. For the stochastic -variable $X$, the variance is denoted as $\sigma^2_X$ or $\mathrm{Var}(X)$ - -$$ -\begin{align*} -\sigma^2_X &=\mathrm{Var}(X) = \langle (x-\langle x\rangle)^2\rangle = -\int (x-\langle x\rangle)^2 p(x)dx\\ -& = \int\left(x^2 - 2 x \langle x\rangle^{2} +\langle x\rangle^2\right)p(x)dx\\ -& = \langle x^2\rangle - 2 \langle x\rangle\langle x\rangle + \langle x\rangle^2\\ -& = \langle x^2 \rangle - \langle x\rangle^2 -\end{align*} -$$ - -The square root of the variance, $\sigma =\sqrt{\langle (x-\langle x\rangle)^2\rangle}$ is called the -**standard deviation** of $p$. It is the RMS (root-mean-square) -value of the deviation of the PDF from its mean value, interpreted -qualitatively as the "spread" of $p$ around its mean. - - - - - - -## Probability Distribution Functions - -The following table collects properties of probability distribution functions. -In our notation we reserve the label $p(x)$ for the probability of a certain event, -while $P(x)$ is the cumulative probability. - - - - - - - - - - - - - - - -
Discrete PDF Continuous PDF
Domain $\left\{x_1, x_2, x_3, \dots, x_N\right\}$ $[a,b]$
Probability $p(x_i)$ $p(x)dx$
Cumulative $P_i=\sum_{l=1}^ip(x_l)$ $P(x)=\int_a^xp(t)dt$
Positivity $0 \le p(x_i) \le 1$ $p(x) \ge 0$
Positivity $0 \le P_i \le 1$ $0 \le P(x) \le 1$
Monotonic $P_i \ge P_j$ if $x_i \ge x_j$ $P(x_i) \ge P(x_j)$ if $x_i \ge x_j$
Normalization $P_N=1$ $P(b)=1$
- - - - - -## Probability Distribution Functions -With a PDF we can compute expectation values of selected quantities such as - -$$ -\langle x^k\rangle=\sum_{i=1}^{N}x_i^kp(x_i), -$$ - -if we have a discrete PDF or - -$$ -\langle x^k\rangle=\int_a^b x^kp(x)dx, -$$ - -in the case of a continuous PDF. We have already defined the mean value $\mu$ -and the variance $\sigma^2$. - - - - -## The three famous Probability Distribution Functions - -There are at least three PDFs which one may encounter. These are the - -**Uniform distribution** - -$$ -p(x)=\frac{1}{b-a}\Theta(x-a)\Theta(b-x), -$$ - -yielding probabilities different from zero in the interval $[a,b]$. - -**The exponential distribution** - -$$ -p(x)=\alpha \exp{(-\alpha x)}, -$$ - -yielding probabilities different from zero in the interval $[0,\infty)$ and with mean value - -$$ -\mu = \int_0^{\infty}xp(x)dx=\int_0^{\infty}x\alpha \exp{(-\alpha x)}dx=\frac{1}{\alpha}, -$$ - -with variance - -$$ -\sigma^2=\int_0^{\infty}x^2p(x)dx-\mu^2 = \frac{1}{\alpha^2}. -$$ - -## Probability Distribution Functions, the normal distribution -Finally, we have the so-called univariate normal distribution, or just the **normal distribution** - -$$ -p(x)=\frac{1}{b\sqrt{2\pi}}\exp{\left(-\frac{(x-a)^2}{2b^2}\right)} -$$ - -with probabilities different from zero in the interval $(-\infty,\infty)$. -The integral $\int_{-\infty}^{\infty}\exp{\left(-(x^2\right)}dx$ appears in many calculations, its value -is $\sqrt{\pi}$, a result we will need when we compute the mean value and the variance. -The mean value is - -$$ -\mu = \int_0^{\infty}xp(x)dx=\frac{1}{b\sqrt{2\pi}}\int_{-\infty}^{\infty}x \exp{\left(-\frac{(x-a)^2}{2b^2}\right)}dx, -$$ - -which becomes with a suitable change of variables - -$$ -\mu =\frac{1}{b\sqrt{2\pi}}\int_{-\infty}^{\infty}b\sqrt{2}(a+b\sqrt{2}y)\exp{-y^2}dy=a. -$$ - -## Probability Distribution Functions, the normal distribution -Similarly, the variance becomes - -$$ -\sigma^2 = \frac{1}{b\sqrt{2\pi}}\int_{-\infty}^{\infty}(x-\mu)^2 \exp{\left(-\frac{(x-a)^2}{2b^2}\right)}dx, -$$ - -and inserting the mean value and performing a variable change we obtain - -$$ -\sigma^2 = \frac{1}{b\sqrt{2\pi}}\int_{-\infty}^{\infty}b\sqrt{2}(b\sqrt{2}y)^2\exp{\left(-y^2\right)}dy= -\frac{2b^2}{\sqrt{\pi}}\int_{-\infty}^{\infty}y^2\exp{\left(-y^2\right)}dy, -$$ - -and performing a final integration by parts we obtain the well-known result $\sigma^2=b^2$. -It is useful to introduce the standard normal distribution as well, defined by $\mu=a=0$, viz. a distribution -centered around zero and with a variance $\sigma^2=1$, leading to - - -
- -$$ -\begin{equation} - p(x)=\frac{1}{\sqrt{2\pi}}\exp{\left(-\frac{x^2}{2}\right)}. -\label{_auto1} \tag{3} -\end{equation} -$$ - -## Probability Distribution Functions, the cumulative distribution - -The exponential and uniform distributions have simple cumulative functions, -whereas the normal distribution does not, being proportional to the so-called -error function $erf(x)$, given by - -$$ -P(x) = \frac{1}{\sqrt{2\pi}}\int_{-\infty}^x\exp{\left(-\frac{t^2}{2}\right)}dt, -$$ - -which is difficult to evaluate in a quick way. - - - - - -## Probability Distribution Functions, other important distribution - -Some other PDFs which one encounters often in the natural sciences are the binomial distribution - -$$ -p(x) = \left(\begin{array}{c} n \\ x\end{array}\right)y^x(1-y)^{n-x} \hspace{0.5cm}x=0,1,\dots,n, -$$ - -where $y$ is the probability for a specific event, such as the tossing of a coin or moving left or right -in case of a random walker. Note that $x$ is a discrete stochastic variable. - -The sequence of binomial trials is characterized by the following definitions - - * Every experiment is thought to consist of $N$ independent trials. - - * In every independent trial one registers if a specific situation happens or not, such as the jump to the left or right of a random walker. - - * The probability for every outcome in a single trial has the same value, for example the outcome of tossing (either heads or tails) a coin is always $1/2$. - - - - -## Probability Distribution Functions, the binomial distribution - -In order to compute the mean and variance we need to recall Newton's binomial -formula - -$$ -(a+b)^m=\sum_{n=0}^m \left(\begin{array}{c} m \\ n\end{array}\right)a^nb^{m-n}, -$$ - -which can be used to show that - -$$ -\sum_{x=0}^n\left(\begin{array}{c} n \\ x\end{array}\right)y^x(1-y)^{n-x} = (y+1-y)^n = 1, -$$ - -the PDF is normalized to one. -The mean value is - -$$ -\mu = \sum_{x=0}^n x\left(\begin{array}{c} n \\ x\end{array}\right)y^x(1-y)^{n-x} = -\sum_{x=0}^n x\frac{n!}{x!(n-x)!}y^x(1-y)^{n-x}, -$$ - -resulting in - -$$ -\mu = -\sum_{x=0}^n x\frac{(n-1)!}{(x-1)!(n-1-(x-1))!}y^{x-1}(1-y)^{n-1-(x-1)}, -$$ - -which we rewrite as - -$$ -\mu=ny\sum_{\nu=0}^n\left(\begin{array}{c} n-1 \\ \nu\end{array}\right)y^{\nu}(1-y)^{n-1-\nu} =ny(y+1-y)^{n-1}=ny. -$$ - -The variance is slightly trickier to get. It reads $\sigma^2=ny(1-y)$. - - -## Probability Distribution Functions, Poisson's distribution - -Another important distribution with discrete stochastic variables $x$ is -the Poisson model, which resembles the exponential distribution and reads - -$$ -p(x) = \frac{\lambda^x}{x!} e^{-\lambda} \hspace{0.5cm}x=0,1,\dots,;\lambda > 0. -$$ - -In this case both the mean value and the variance are easier to calculate, - -$$ -\mu = \sum_{x=0}^{\infty} x \frac{\lambda^x}{x!} e^{-\lambda} = \lambda e^{-\lambda}\sum_{x=1}^{\infty} -\frac{\lambda^{x-1}}{(x-1)!}=\lambda, -$$ - -and the variance is $\sigma^2=\lambda$. - - - - - - -## Probability Distribution Functions, Poisson's distribution -An example of applications of the Poisson distribution could be the counting -of the number of $\alpha$-particles emitted from a radioactive source in a given time interval. -In the limit of $n\rightarrow \infty$ and for small probabilities $y$, the binomial distribution -approaches the Poisson distribution. Setting $\lambda = ny$, with $y$ the probability for an event in -the binomial distribution we can show that - -$$ -\lim_{n\rightarrow \infty}\left(\begin{array}{c} n \\ x\end{array}\right)y^x(1-y)^{n-x} e^{-\lambda}=\sum_{x=1}^{\infty}\frac{\lambda^x}{x!} e^{-\lambda}. -$$ - -## Meet the covariance! -An important quantity in a statistical analysis is the so-called covariance. - -Consider the set $\{X_i\}$ of $n$ -stochastic variables (not necessarily uncorrelated) with the -multivariate PDF $P(x_1,\dots,x_n)$. The *covariance* of two -of the stochastic variables, $X_i$ and $X_j$, is defined as follows - - -
- -$$ -\begin{equation} -\mathrm{Cov}(X_i,\,X_j) = \langle (x_i-\langle x_i\rangle)(x_j-\langle x_j\rangle)\rangle -\label{_auto2} \tag{4} -\end{equation} -$$ - - -
- -$$ -\begin{equation} -=\int\cdots\int (x_i-\langle x_i\rangle)(x_j-\langle x_j\rangle)P(x_1,\dots,x_n)\,dx_1\dots dx_n, -\label{eq:def_covariance} \tag{5} -\end{equation} -$$ - -with - -$$ -\langle x_i\rangle = -\int\cdots\int x_i P(x_1,\dots,x_n)\,dx_1\dots dx_n. -$$ - -## Meet the covariance in matrix disguise -If we consider the above covariance as a matrix - -$$ -C_{ij} =\mathrm{Cov}(X_i,\,X_j), -$$ - -then the diagonal elements are just the familiar -variances, $C_{ii} = \mathrm{Cov}(X_i,\,X_i) = \mathrm{Var}(X_i)$. It turns out that -all the off-diagonal elements are zero if the stochastic variables are -uncorrelated. - - - - -## Covariance - -# Importing various packages -from math import exp, sqrt -from random import random, seed -import numpy as np -import matplotlib.pyplot as plt - -def covariance(x, y, n): - sum = 0.0 - mean_x = np.mean(x) - mean_y = np.mean(y) - for i in range(0, n): - sum += (x[(i)]-mean_x)*(y[i]-mean_y) - return sum/n - -n = 10 - -x=np.random.normal(size=n) -y = 4+3*x+np.random.normal(size=n) -covxy = covariance(x,y,n) -print(covxy) -z = np.vstack((x, y)) -c = np.cov(z.T) - -print(c) - -## Meet the covariance, uncorrelated events - -Consider the stochastic variables $X_i$ and $X_j$, ($i\neq j$). We have - -$$ -\begin{align*} -Cov(X_i,\,X_j) &= \langle (x_i-\langle x_i\rangle)(x_j-\langle x_j\rangle)\rangle\\ -&=\langle x_i x_j - x_i\langle x_j\rangle - \langle x_i\rangle x_j + \langle x_i\rangle\langle x_j\rangle\rangle\\ -&=\langle x_i x_j\rangle - \langle x_i\langle x_j\rangle\rangle - \langle \langle x_i\rangle x_j \rangle + -\langle \langle x_i\rangle\langle x_j\rangle\rangle \\ -&=\langle x_i x_j\rangle - \langle x_i\rangle\langle x_j\rangle - \langle x_i\rangle\langle x_j\rangle + -\langle x_i\rangle\langle x_j\rangle \\ -&=\langle x_i x_j\rangle - \langle x_i\rangle\langle x_j\rangle -\end{align*} -$$ - -If $X_i$ and $X_j$ are independent (assuming $i \neq j$), we have that - -$$ -\langle x_i x_j\rangle = \langle x_i\rangle\langle x_j\rangle, -$$ - -leading to - -$$ -Cov(X_i, X_j) = 0 \hspace{0.1cm} (i\neq j). -$$ - -## Numerical experiments and the covariance - -Now that we have constructed an idealized mathematical framework, let -us try to apply it to empirical observations. Examples of relevant -physical phenomena may be spontaneous decays of nuclei, or a purely -mathematical set of numbers produced by some deterministic -mechanism. It is the latter we will deal with, using so-called pseudo-random -number generators. In general our observations will contain only a limited set of -observables. We remind the reader that -a *stochastic process* is a process that produces sequentially a -chain of values - -$$ -\{x_1, x_2,\dots\,x_k,\dots\}. -$$ - -## Numerical experiments and the covariance -We will call these -values our *measurements* and the entire set as our measured -*sample*. The action of measuring all the elements of a sample -we will call a stochastic *experiment* (since, operationally, -they are often associated with results of empirical observation of -some physical or mathematical phenomena; precisely an experiment). We -assume that these values are distributed according to some -PDF $p_X^{\phantom X}(x)$, where $X$ is just the formal symbol for the -stochastic variable whose PDF is $p_X^{\phantom X}(x)$. Instead of -trying to determine the full distribution $p$ we are often only -interested in finding the few lowest moments, like the mean -$\mu_X^{\phantom X}$ and the variance $\sigma_X^{\phantom X}$. - - - - - -## Numerical experiments and the covariance, actual situations -In practical situations however, a sample is always of finite size. Let that -size be $n$. The expectation value of a sample $\alpha$, the **sample mean**, is then defined as follows - -$$ -\langle x_{\alpha} \rangle \equiv \frac{1}{n}\sum_{k=1}^n x_{\alpha,k}. -$$ - -The *sample variance* is: - -$$ -\mathrm{Var}(x) \equiv \frac{1}{n}\sum_{k=1}^n (x_{\alpha,k} - \langle x_{\alpha} \rangle)^2, -$$ - -with its square root being the *standard deviation of the sample*. - - - - - -## Numerical experiments and the covariance, our observables -You can think of the above observables as a set of quantities which define -a given experiment. This experiment is then repeated several times, say $m$ times. -The total average is then - - -
- -$$ -\begin{equation} -\langle X_m \rangle= \frac{1}{m}\sum_{\alpha=1}^mx_{\alpha}=\frac{1}{mn}\sum_{\alpha, k} x_{\alpha,k}, -\label{eq:exptmean} \tag{6} -\end{equation} -$$ - -where the last sums end at $m$ and $n$. -The total variance is - -$$ -\sigma^2_m= \frac{1}{mn^2}\sum_{\alpha=1}^m(\langle x_{\alpha} \rangle-\langle X_m \rangle)^2, -$$ - -which we rewrite as - - -
- -$$ -\begin{equation} -\sigma^2_m=\frac{1}{m}\sum_{\alpha=1}^m\sum_{kl=1}^n (x_{\alpha,k}-\langle X_m \rangle)(x_{\alpha,l}-\langle X_m \rangle). -\label{eq:exptvariance} \tag{7} -\end{equation} -$$ - -## Numerical experiments and the covariance, the sample variance - -We define also the sample variance $\sigma^2$ of all $mn$ individual experiments as - - -
- -$$ -\begin{equation} -\sigma^2=\frac{1}{mn}\sum_{\alpha=1}^m\sum_{k=1}^n (x_{\alpha,k}-\langle X_m \rangle)^2. -\label{eq:sampleexptvariance} \tag{8} -\end{equation} -$$ - -These quantities, being known experimental values or the results from our calculations, -may differ, in some cases -significantly, from the similarly named -exact values for the mean value $\mu_X$, the variance $\mathrm{Var}(X)$ -and the covariance $\mathrm{Cov}(X,Y)$. - - - - -## Numerical experiments and the covariance, central limit theorem - -The central limit theorem states that the PDF $\tilde{p}(z)$ of -the average of $m$ random values corresponding to a PDF $p(x)$ -is a normal distribution whose mean is the -mean value of the PDF $p(x)$ and whose variance is the variance -of the PDF $p(x)$ divided by $m$, the number of values used to compute $z$. - -The central limit theorem leads then to the well-known expression for the -standard deviation, given by - -$$ -\sigma_m= -\frac{\sigma}{\sqrt{m}}. -$$ - -In many cases the above estimate for the standard deviation, in particular if correlations are strong, may be too simplistic. We need therefore a more precise defintion of the error and the variance in our results. - - - - -## Definition of Correlation Functions and Standard Deviation -Our estimate of the true average $\mu_{X}$ is the sample mean $\langle X_m \rangle$ - -$$ -\mu_{X}^{\phantom X} \approx X_m=\frac{1}{mn}\sum_{\alpha=1}^m\sum_{k=1}^n x_{\alpha,k}. -$$ - -We can then use Eq. ([7](#eq:exptvariance)) - -$$ -\sigma^2_m=\frac{1}{mn^2}\sum_{\alpha=1}^m\sum_{kl=1}^n (x_{\alpha,k}-\langle X_m \rangle)(x_{\alpha,l}-\langle X_m \rangle), -$$ - -and rewrite it as - -$$ -\sigma^2_m=\frac{\sigma^2}{n}+\frac{2}{mn^2}\sum_{\alpha=1}^m\sum_{k -
- -$$ -\begin{equation} -\kappa_d = \frac{f_d}{\sigma^2} -\label{eq:autocorrelformal} \tag{9} -\end{equation} -$$ - -which gives us a useful measure of the correlation pair correlation -starting always at $1$ for $d=0$. - - - - -## Definition of Correlation Functions and Standard Deviation, sample variance - -The sample variance of the $mn$ experiments can now be -written in terms of the autocorrelation function - - -
- -$$ -\begin{equation} -\sigma_m^2=\frac{\sigma^2}{n}+\frac{2}{n}\cdot\sigma^2\sum_{d=1}^{n-1} -\frac{f_d}{\sigma^2}=\left(1+2\sum_{d=1}^{n-1}\kappa_d\right)\frac{1}{n}\sigma^2=\frac{\tau}{n}\cdot\sigma^2 -\label{eq:error_estimate_corr_time} \tag{10} -\end{equation} -$$ - -and we see that $\sigma_m$ can be expressed in terms of the -uncorrelated sample variance times a correction factor $\tau$ which -accounts for the correlation between measurements. We call this -correction factor the *autocorrelation time* - - -
- -$$ -\begin{equation} -\tau = 1+2\sum_{d=1}^{n-1}\kappa_d -\label{eq:autocorrelation_time} \tag{11} -\end{equation} -$$ - - - -For a correlation free experiment, $\tau$ -equals 1. - - - - - - -## Definition of Correlation Functions and Standard Deviation -From the point of view of -Eq. ([10](#eq:error_estimate_corr_time)) we can interpret a sequential -correlation as an effective reduction of the number of measurements by -a factor $\tau$. The effective number of measurements becomes - -$$ -n_\mathrm{eff} = \frac{n}{\tau} -$$ - -To neglect the autocorrelation time $\tau$ will always cause our -simple uncorrelated estimate of $\sigma_m^2\approx \sigma^2/n$ to -be less than the true sample error. The estimate of the error will be -too "good". On the other hand, the calculation of the full -autocorrelation time poses an efficiency problem if the set of -measurements is very large. The solution to this problem is given by -more practically oriented methods like the blocking technique. - - - - - - -## Code to compute the Covariance matrix and the Covariance - -# Importing various packages -from math import exp, sqrt -from random import random, seed -import numpy as np -import matplotlib.pyplot as plt - -# Sample covariance, note the factor 1/(n-1) -def covariance(x, y, n): - sum = 0.0 - mean_x = np.mean(x) - mean_y = np.mean(y) - for i in range(0, n): - sum += (x[(i)]-mean_x)*(y[i]-mean_y) - return sum/(n-1.) - -n = 100 -x = np.random.normal(size=n) -print(np.mean(x)) -y = 4+3*x+np.random.normal(size=n) -print(np.mean(y)) -z = x**3+np.random.normal(size=n) -print(np.mean(z)) -covxx = covariance(x,x,n) -covyy = covariance(y,y,n) -covzz = covariance(z,z,n) -covxy = covariance(x,y,n) -covxz = covariance(x,z,n) -covyz = covariance(y,z,n) -print(covxx,covyy, covzz) -print(covxy,covxz, covyz) -w = np.vstack((x, y, z)) -#print(w) -c = np.cov(w) -print(c) -#eigen = np.zeros(n) -Eigvals, Eigvecs = np.linalg.eig(c) -print(Eigvals) - -## Random Numbers - -Uniform deviates are just random numbers that lie within a specified range -(typically 0 to 1), with any one number in the range just as likely as any other. They -are, in other words, what you probably think random numbers are. However, -we want to distinguish uniform deviates from other sorts of random numbers, for -example numbers drawn from a normal (Gaussian) distribution of specified mean -and standard deviation. These other sorts of deviates are almost always generated by -performing appropriate operations on one or more uniform deviates, as we will see -in subsequent sections. So, a reliable source of random uniform deviates, the subject -of this section, is an essential building block for any sort of stochastic modeling -or Monte Carlo computer work. - - - - - -## Random Numbers, better name: pseudo random numbers - -A disclaimer is however appropriate. It should be fairly obvious that -something as deterministic as a computer cannot generate purely random numbers. - -Numbers generated by any of the standard algorithms are in reality pseudo random -numbers, hopefully abiding to the following criteria: - - * they produce a uniform distribution in the interval [0,1]. - - * correlations between random numbers are negligible - - * the period before the same sequence of random numbers is repeated is as large as possible and finally - - * the algorithm should be fast. - - - - - -## Random number generator RNG - The most common random number generators are based on so-called -Linear congruential relations of the type - -$$ -N_i=(aN_{i-1}+c) \mathrm{MOD} (M), -$$ - -which yield a number in the interval [0,1] through - -$$ -x_i=N_i/M -$$ - -The number -$M$ is called the period and it should be as large as possible - and -$N_0$ is the starting value, or seed. The function $\mathrm{MOD}$ means the remainder, -that is if we were to evaluate $(13)\mathrm{MOD}(9)$, the outcome is the remainder -of the division $13/9$, namely $4$. - - - - -## Random number generator RNG and periodic outputs - -The problem with such generators is that their outputs are periodic; -they -will start to repeat themselves with a period that is at most $M$. If however -the parameters $a$ and $c$ are badly chosen, the period may be even shorter. - -Consider the following example - -$$ -N_i=(6N_{i-1}+7) \mathrm{MOD} (5), -$$ - -with a seed $N_0=2$. This generator produces the sequence -$4,1,3,0,2,4,1,3,0,2,...\dots$, i.e., a sequence with period $5$. -However, increasing $M$ may not guarantee a larger period as the following -example shows - -$$ -N_i=(27N_{i-1}+11) \mathrm{MOD} (54), -$$ - -which still, with $N_0=2$, results in $11,38,11,38,11,38,\dots$, a period of -just $2$. - - - - -## Random number generator RNG and its period -Typical periods for the random generators provided in the program library -are of the order of $\sim 10^9$ or larger. Other random number generators which have -become increasingly popular are so-called shift-register generators. -In these generators each successive number depends on many preceding -values (rather than the last values as in the linear congruential -generator). -For example, you could make a shift register generator whose $l$th -number is the sum of the $l-i$th and $l-j$th values with modulo $M$, - -$$ -N_l=(aN_{l-i}+cN_{l-j})\mathrm{MOD}(M). -$$ - -## Random number generator RNG, other examples -Such a generator again produces a sequence of pseudorandom numbers -but this time with a period much larger than $M$. -It is also possible to construct more elaborate algorithms by including -more than two past terms in the sum of each iteration. -One example is the generator of [Marsaglia and Zaman](http://dl.acm.org/citation.cfm?id=187154) -which consists of two congruential relations - - -
- -$$ -\begin{equation} - N_l=(N_{l-3}-N_{l-1})\mathrm{MOD}(2^{31}-69), -\label{eq:mz1} \tag{12} -\end{equation} -$$ - -followed by - - -
- -$$ -\begin{equation} - N_l=(69069N_{l-1}+1013904243)\mathrm{MOD}(2^{32}), -\label{eq:mz2} \tag{13} -\end{equation} -$$ - -which according to the authors has a period larger than $2^{94}$. - - - - -## Random number generator RNG, other examples -Instead of using modular addition, we could use the bitwise -exclusive-OR ($\oplus$) operation so that - -$$ -N_l=(N_{l-i})\oplus (N_{l-j}) -$$ - -where the bitwise action of $\oplus$ means that if $N_{l-i}=N_{l-j}$ the result is -$0$ whereas if $N_{l-i}\ne N_{l-j}$ the result is -$1$. As an example, consider the case where $N_{l-i}=6$ and $N_{l-j}=11$. The first -one has a bit representation (using 4 bits only) which reads $0110$ whereas the -second number is $1011$. Employing the $\oplus$ operator yields -$1101$, or $2^3+2^2+2^0=13$. - -In Fortran90, the bitwise $\oplus$ operation is coded through the intrinsic -function $\mathrm{IEOR}(m,n)$ where $m$ and $n$ are the input numbers, while in $C$ -it is given by $m\wedge n$. - - - - - -## Random number generator RNG, RAN0 - -We show here how the linear congruential algorithm can be implemented, namely - -$$ -N_i=(aN_{i-1}) \mathrm{MOD} (M). -$$ - -However, since $a$ and $N_{i-1}$ are integers and their multiplication -could become greater than the standard 32 bit integer, there is a trick via -Schrage's algorithm which approximates the multiplication -of large integers through the factorization - -$$ -M=aq+r, -$$ - -where we have defined - -$$ -q=[M/a], -$$ - -and - -$$ -r = M\hspace{0.1cm}\mathrm{MOD} \hspace{0.1cm}a. -$$ - -where the brackets denote integer division. In the code below the numbers -$q$ and $r$ are chosen so that $r < q$. - - - - - - -## Random number generator RNG, RAN0 - -To see how this works we note first that - - -
- -$$ -\begin{equation} -(aN_{i-1}) \mathrm{MOD} (M)= (aN_{i-1}-[N_{i-1}/q]M)\mathrm{MOD} (M), -\label{eq:rntrick1} \tag{14} -\end{equation} -$$ - -since we can add or subtract any integer multiple of $M$ from $aN_{i-1}$. -The last term $[N_{i-1}/q]M\mathrm{MOD}(M)$ is zero since the integer division -$[N_{i-1}/q]$ just yields a constant which is multiplied with $M$. - - - - - -## Random number generator RNG, RAN0 -We can now rewrite Eq. ([14](#eq:rntrick1)) as - - -
- -$$ -\begin{equation} -(aN_{i-1}) \mathrm{MOD} (M)= (aN_{i-1}-[N_{i-1}/q](aq+r))\mathrm{MOD} (M), -\label{eq:rntrick2} \tag{15} -\end{equation} -$$ - -which results -in - - -
- -$$ -\begin{equation} -(aN_{i-1}) \mathrm{MOD} (M)= \left(a(N_{i-1}-[N_{i-1}/q]q)-[N_{i-1}/q]r)\right)\mathrm{MOD} (M), -\label{eq:rntrick3} \tag{16} -\end{equation} -$$ - -yielding - - -
- -$$ -\begin{equation} -(aN_{i-1}) \mathrm{MOD} (M)= \left(a(N_{i-1}\mathrm{MOD} (q)) -[N_{i-1}/q]r)\right)\mathrm{MOD} (M). -\label{eq:rntrick4} \tag{17} -\end{equation} -$$ - -## Random number generator RNG, RAN0 -The term $[N_{i-1}/q]r$ is always smaller or equal $N_{i-1}(r/q)$ and with $r < q$ we obtain always a -number smaller than $N_{i-1}$, which is smaller than $M$. -And since the number $N_{i-1}\mathrm{MOD} (q)$ is between zero and $q-1$ then -$a(N_{i-1}\mathrm{MOD} (q))< aq$. Combined with our definition of $q=[M/a]$ ensures that -this term is also smaller than $M$ meaning that both terms fit into a -32-bit signed integer. None of these two terms can be negative, but their difference could. -The algorithm below adds $M$ if their difference is negative. -Note that the program uses the bitwise $\oplus$ operator to generate -the starting point for each generation of a random number. The period -of $ran0$ is $\sim 2.1\times 10^{9}$. A special feature of this -algorithm is that is should never be called with the initial seed -set to $0$. - - - - - -## Random number generator RNG, RAN0 code - - /* - ** The function - ** ran0() - ** is an "Minimal" random number generator of Park and Miller - ** Set or reset the input value - ** idum to any integer value (except the unlikely value MASK) - ** to initialize the sequence; idum must not be altered between - ** calls for sucessive deviates in a sequence. - ** The function returns a uniform deviate between 0.0 and 1.0. - */ - double ran0(long &idum) - { - const int a = 16807, m = 2147483647, q = 127773; - const int r = 2836, MASK = 123459876; - const double am = 1./m; - long k; - double ans; - idum ^= MASK; - k = (*idum)/q; - idum = a*(idum - k*q) - r*k; - // add m if negative difference - if(idum < 0) idum += m; - ans=am*(idum); - idum ^= MASK; - return ans; - } // End: function ran0() - - -## Properties of Selected Random Number Generators - -As mentioned previously, the underlying PDF for the generation of -random numbers is the uniform distribution, meaning that the -probability for finding a number $x$ in the interval [0,1] is $p(x)=1$. - -A random number generator should produce numbers which are uniformly distributed -in this interval. The table shows the distribution of $N=10000$ random -numbers generated by the functions in the program library. -We note in this table that the number of points in the various -intervals $0.0-0.1$, $0.1-0.2$ etc are fairly close to $1000$, with some minor -deviations. - -Two additional measures are the standard deviation $\sigma$ and the mean -$\mu=\langle x\rangle$. - - - - -## Properties of Selected Random Number Generators -For the uniform distribution, the mean value $\mu$ is then - -$$ -\mu=\langle x\rangle=\frac{1}{2} -$$ - -while the standard deviation is - -$$ -\sigma=\sqrt{\langle x^2\rangle-\mu^2}=\frac{1}{\sqrt{12}}=0.2886. -$$ - -## Properties of Selected Random Number Generators -The various random number generators produce results which agree rather well with -these limiting values. - - - - - - - - - - - - - - - - - - - -
$x$-bin ran0 ran1 ran2 ran3
0.0-0.1 1013 991 938 1047
0.1-0.2 1002 1009 1040 1030
0.2-0.3 989 999 1030 993
0.3-0.4 939 960 1023 937
0.4-0.5 1038 1001 1002 992
0.5-0.6 1037 1047 1009 1009
0.6-0.7 1005 989 1003 989
0.7-0.8 986 962 985 954
0.8-0.9 1000 1027 1009 1023
0.9-1.0 991 1015 961 1026
$\mu$ 0.4997 0.5018 0.4992 0.4990
$\sigma$ 0.2882 0.2892 0.2861 0.2915
- - - - -## Simple demonstration of RNGs using python -The following simple Python code plots the distribution of the produced random numbers using the linear congruential RNG employed by Python. The trend displayed in the previous table is seen rather clearly. - -#!/usr/bin/env python -import numpy as np -import matplotlib.mlab as mlab -import matplotlib.pyplot as plt -import random - -# initialize the rng with a seed -random.seed() -counts = 10000 -values = np.zeros(counts) -for i in range (1, counts, 1): - values[i] = random.random() - -# the histogram of the data -n, bins, patches = plt.hist(values, 10, facecolor='green') - -plt.xlabel('$x$') -plt.ylabel('Number of counts') -plt.title(r'Test of uniform distribution') -plt.axis([0, 1, 0, 1100]) -plt.grid(True) -plt.show() - -## Properties of Selected Random Number Generators -Since our random numbers, which are typically generated via a linear congruential algorithm, -are never fully independent, we can then define -an important test which measures the degree of correlation, namely the so-called -auto-correlation function defined previously, see again Eq. ([9](#eq:autocorrelformal)). -We rewrite it here as - -$$ -C_k=\frac{f_d} - {\sigma^2}, -$$ - -with $C_0=1$. Recall that -$\sigma^2=\langle x_i^2\rangle-\langle x_i\rangle^2$ and that - -$$ -f_d = \frac{1}{nm}\sum_{\alpha=1}^m\sum_{k=1}^{n-d}(x_{\alpha,k}-\langle X_m \rangle)(x_{\alpha,k+d}-\langle X_m \rangle), -$$ - -The non-vanishing of $C_k$ for $k\ne 0$ means that the random -numbers are not independent. The independence of the random numbers is crucial -in the evaluation of other expectation values. If they are not independent, our -assumption for approximating $\sigma_N$ is no longer valid. - - - - - -## Autocorrelation function -This program computes the autocorrelation function as discussed in the equation on the previous slide for random numbers generated with the normal distribution $N(0,1)$. - -# Importing various packages -from math import exp, sqrt -from random import random, seed -import numpy as np -import matplotlib.pyplot as plt - -def autocovariance(x, n, k, mean_x): - sum = 0.0 - for i in range(0, n-k): - sum += (x[(i+k)]-mean_x)*(x[i]-mean_x) - return sum/n - -n = 1000 -x=np.random.normal(size=n) -autocor = np.zeros(n) -figaxis = np.zeros(n) -mean_x=np.mean(x) -var_x = np.var(x) -print(mean_x, var_x) -for i in range (0, n): - figaxis[i] = i - autocor[i]=(autocovariance(x, n, i, mean_x))/var_x - -plt.plot(figaxis, autocor, "r-") -plt.axis([0,n,-0.1, 1.0]) -plt.xlabel(r'$i$') -plt.ylabel(r'$\gamma_i$') -plt.title(r'Autocorrelation function') -plt.show() - -As can be seen from the plot, the first point gives back the variance and a value of one. -For the remaining values we notice that there are still non-zero values for the auto-correlation function. - - - - - - - - - - - - - - - - - -## Correlation function and which random number generators should I use -The program here computes the correlation function for one of the standard functions included with the c++ compiler. - - // This function computes the autocorrelation function for - // the standard c++ random number generator - - #include - #include - #include - #include - using namespace std; - // output file as global variable - ofstream ofile; - - // Main function begins here - int main(int argc, char* argv[]) - { - int n; - char *outfilename; - - cin >> n; - double MCint = 0.; double MCintsqr2=0.; - double invers_period = 1./RAND_MAX; // initialise the random number generator - srand(time(NULL)); // This produces the so-called seed in MC jargon - // Compute the variance and the mean value of the uniform distribution - // Compute also the specific values x for each cycle in order to be able to - // the covariance and the correlation function - // Read in output file, abort if there are too few command-line arguments - if( argc <= 2 ){ - cout << "Bad Usage: " << argv[0] << - " read also output file and number of cycles on same line" << endl; - exit(1); - } - else{ - outfilename=argv[1]; - } - ofile.open(outfilename); - // Get the number of Monte-Carlo samples - n = atoi(argv[2]); - double *X; - X = new double[n]; - for (int i = 0; i < n; i++){ - double x = double(rand())*invers_period; - X[i] = x; - MCint += x; - MCintsqr2 += x*x; - } - double Mean = MCint/((double) n ); - MCintsqr2 = MCintsqr2/((double) n ); - double STDev = sqrt(MCintsqr2-Mean*Mean); - double Variance = MCintsqr2-Mean*Mean; - // Write mean value and standard deviation - cout << " Standard deviation= " << STDev << " Integral = " << Mean << endl; - - // Now we compute the autocorrelation function - double *autocor; autocor = new double[n]; - for (int j = 0; j < n; j++){ - double sum = 0.0; - for (int k = 0; k < (n-j); k++){ - sum += (X[k]-Mean)*(X[k+j]-Mean); - } - autocor[j] = sum/Variance/((double) n ); - ofile << setiosflags(ios::showpoint | ios::uppercase); - ofile << setw(15) << setprecision(8) << j; - ofile << setw(15) << setprecision(8) << autocor[j] << endl; - } - ofile.close(); // close output file - return 0; - } // end of main program - - -## Which RNG should I use? -* C++ has a class called **random**. The [random class](http://www.cplusplus.com/reference/random/) contains a large selection of RNGs and is highly recommended. Some of these RNGs have very large periods making it thereby very safe to use these RNGs in case one is performing large calculations. In particular, the [Mersenne twister random number engine](http://www.cplusplus.com/reference/random/mersenne_twister_engine/) has a period of $2^{19937}$. - -* Add RNGs in Python - - - - - -## How to use the Mersenne generator -The following part of a c++ code (from project 4) sets up the uniform distribution for $x\in [0,1]$. - - /* - - // You need this - #include - - // Initialize the seed and call the Mersienne algo - std::random_device rd; - std::mt19937_64 gen(rd()); - // Set up the uniform distribution for x \in [[0, 1] - std::uniform_real_distribution RandomNumberGenerator(0.0,1.0); - - // Now use the RNG - int ix = (int) (RandomNumberGenerator(gen)*NSpins); - - -## Why blocking? -**Statistical analysis.** - - * Monte Carlo simulations can be treated as *computer experiments* - - * The results can be analysed with the same statistical tools as we would use analysing experimental data. - - * As in all experiments, we are looking for expectation values and an estimate of how accurate they are, i.e., possible sources for errors. - -A very good article which explains blocking is H. Flyvbjerg and H. G. Petersen, *Error estimates on averages of correlated data*, [Journal of Chemical Physics 91, 461-466 (1989)](http://scitation.aip.org/content/aip/journal/jcp/91/1/10.1063/1.457480). - - - - - - -## Why blocking? -**Statistical analysis.** - - * As in other experiments, Monte Carlo experiments have two classes of errors: - - * Statistical errors - - * Systematical errors - - - * Statistical errors can be estimated using standard tools from statistics - - * Systematical errors are method specific and must be treated differently from case to case. (In VMC a common source is the step length or time step in importance sampling) - - - - - -## Code to demonstrate the calculation of the autocorrelation function -The following code computes the autocorrelation function, the covariance and the standard deviation -for standard RNG. -The [following file](https://github.com/CompPhysics/ComputationalPhysics2/tree/gh-pages/doc/Programs/LecturePrograms/programs/Blocking/autocorrelation.cpp) gives the code. - - // This function computes the autocorrelation function for - // the Mersenne random number generator with a uniform distribution - #include - #include - #include - #include - #include - #include - #include - #include - using namespace std; - using namespace arma; - // output file - ofstream ofile; - - // Main function begins here - int main(int argc, char* argv[]) - { - int MonteCarloCycles; - string filename; - if (argc > 1) { - filename=argv[1]; - MonteCarloCycles = atoi(argv[2]); - string fileout = filename; - string argument = to_string(MonteCarloCycles); - fileout.append(argument); - ofile.open(fileout); - } - - // Compute the variance and the mean value of the uniform distribution - // Compute also the specific values x for each cycle in order to be able to - // compute the covariance and the correlation function - - vec X = zeros(MonteCarloCycles); - double MCint = 0.; double MCintsqr2=0.; - std::random_device rd; - std::mt19937_64 gen(rd()); - // Set up the uniform distribution for x \in [[0, 1] - std::uniform_real_distribution RandomNumberGenerator(0.0,1.0); - for (int i = 0; i < MonteCarloCycles; i++){ - double x = RandomNumberGenerator(gen); - X(i) = x; - MCint += x; - MCintsqr2 += x*x; - } - double Mean = MCint/((double) MonteCarloCycles ); - MCintsqr2 = MCintsqr2/((double) MonteCarloCycles ); - double STDev = sqrt(MCintsqr2-Mean*Mean); - double Variance = MCintsqr2-Mean*Mean; - // Write mean value and variance - cout << " Sample variance= " << Variance << " Mean value = " << Mean << endl; - // Now we compute the autocorrelation function - vec autocorrelation = zeros(MonteCarloCycles); - for (int j = 0; j < MonteCarloCycles; j++){ - double sum = 0.0; - for (int k = 0; k < (MonteCarloCycles-j); k++){ - sum += (X(k)-Mean)*(X(k+j)-Mean); - } - autocorrelation(j) = sum/Variance/((double) MonteCarloCycles ); - ofile << setiosflags(ios::showpoint | ios::uppercase); - ofile << setw(15) << setprecision(8) << j; - ofile << setw(15) << setprecision(8) << autocorrelation(j) << endl; - } - // Now compute the exact covariance using the autocorrelation function - double Covariance = 0.0; - for (int j = 0; j < MonteCarloCycles; j++){ - Covariance += autocorrelation(j); - } - Covariance *= 2.0/((double) MonteCarloCycles); - // Compute now the total variance, including the covariance, and obtain the standard deviation - double TotalVariance = (Variance/((double) MonteCarloCycles ))+Covariance; - cout << "Covariance =" << Covariance << "Totalvariance= " << TotalVariance << "Sample Variance/n= " << (Variance/((double) MonteCarloCycles )) << endl; - cout << " STD from sample variance= " << sqrt(Variance/((double) MonteCarloCycles )) << " STD with covariance = " << sqrt(TotalVariance) << endl; - - ofile.close(); // close output file - return 0; - } // end of main program - - - - -## What is blocking? -**Blocking.** - - * Say that we have a set of samples from a Monte Carlo experiment - - * Assuming (wrongly) that our samples are uncorrelated our best estimate of the standard deviation of the mean $\langle \mathbf{M}\rangle$ is given by - -$$ -\sigma=\sqrt{\frac{1}{n}\left(\langle \mathbf{M}^2\rangle-\langle \mathbf{M}\rangle^2\right)} -$$ - -* If the samples are correlated we can rewrite our results to show that - -$$ -\sigma=\sqrt{\frac{1+2\tau/\Delta t}{n}\left(\langle \mathbf{M}^2\rangle-\langle \mathbf{M}\rangle^2\right)} -$$ - -where $\tau$ is the correlation time (the time between a sample and the next uncorrelated sample) and $\Delta t$ is time between each sample - - - - -## What is blocking? -**Blocking.** - - * If $\Delta t\gg\tau$ our first estimate of $\sigma$ still holds - - * Much more common that $\Delta t<\tau$ - - * In the method of data blocking we divide the sequence of samples into blocks - - * We then take the mean $\langle \mathbf{M}_i\rangle$ of block $i=1\ldots n_{blocks}$ to calculate the total mean and variance - - * The size of each block must be so large that sample $j$ of block $i$ is not correlated with sample $j$ of block $i+1$ - - * The correlation time $\tau$ would be a good choice - - - - -## What is blocking? -**Blocking.** - - * Problem: We don't know $\tau$ or it is too expensive to compute - - * Solution: Make a plot of std. dev. as a function of blocksize - - * The estimate of std. dev. of correlated data is too low $\to$ the error will increase with increasing block size until the blocks are uncorrelated, where we reach a plateau - - * When the std. dev. stops increasing the blocks are uncorrelated - - - - -## Implementation - * Do a Monte Carlo simulation, storing all samples to file - - * Do the statistical analysis on this file, independently of your Monte Carlo program - - * Read the file into an array - - * Loop over various block sizes - - * For each block size $n_b$, loop over the array in steps of $n_b$ taking the mean of elements $i n_b,\ldots,(i+1) n_b$ - - * Take the mean and variance of the resulting array - - * Write the results for each block size to file for later - analysis - - - - - - - - -## Actual implementation with code, main function -When the file gets large, it can be useful to write your data in binary mode instead of ascii characters. -The [following python file](https://github.com/CompPhysics/MachineLearning/blob/master/doc/Programs/Sampling/analysis.py) reads data from file with the output from every Monte Carlo cycle. - -# Blocking - @timeFunction - def blocking(self, blockSizeMax = 500): - blockSizeMin = 1 - - self.blockSizes = [] - self.meanVec = [] - self.varVec = [] - - for i in range(blockSizeMin, blockSizeMax): - if(len(self.data) % i != 0): - pass#continue - blockSize = i - meanTempVec = [] - varTempVec = [] - startPoint = 0 - endPoint = blockSize - - while endPoint <= len(self.data): - meanTempVec.append(np.average(self.data[startPoint:endPoint])) - startPoint = endPoint - endPoint += blockSize - mean, var = np.average(meanTempVec), np.var(meanTempVec)/len(meanTempVec) - self.meanVec.append(mean) - self.varVec.append(var) - self.blockSizes.append(blockSize) - - self.blockingAvg = np.average(self.meanVec[-200:]) - self.blockingVar = (np.average(self.varVec[-200:])) - self.blockingStd = np.sqrt(self.blockingVar) - -## The Bootstrap method - -The Bootstrap resampling method is also very popular. It is very simple: - -1. Start with your sample of measurements and compute the sample variance and the mean values - -2. Then start again but pick in a random way the numbers in the sample and recalculate the mean and the sample variance. - -3. Repeat this $K$ times. - -It can be shown, see the article by [Efron](https://projecteuclid.org/download/pdf_1/euclid.aos/1176344552) -that it produces the correct standard deviation. - -This method is very useful for small ensembles of data points. - - -## Bootstrapping -Given a set of $N$ data, assume that we are interested in some -observable $\theta$ which may be estimated from that set. This observable can also be for example the result of a fit based on all $N$ raw data. -Let us call the value of the observable obtained from the original -data set $\hat{\theta}$. One recreates from the sample repeatedly -other samples by choosing randomly $N$ data out of the original set. -This costs essentially nothing, since we just recycle the original data set for the building of new sets. - - -## Bootstrapping, recipe -Let us assume we have done this $K$ times and thus have $K$ sets of $N$ -data values each. -Of course some values will enter more than once in the new sets. For each of these sets one computes the observable $\theta$ resulting in values $\theta_k$ with $k = 1,...,K$. Then one determines - -$$ -\tilde{\theta} = \frac{1}{K} \sum_{k=1}^K \theta_k, -$$ - -and - -$$ -sigma^2_{\tilde{\theta}} = \frac{1}{K} \sum_{k=1}^K \left(\theta_k-\tilde{\theta}\right)^2. -$$ - -These are estimators for $\angle\theta\rangle$ and its variance. They are not unbiased and therefore -$\tilde{\theta}\neq\hat{\theta}$ for finite K. - -The difference is called bias and gives an idea on how far away the result may be from -the true $\angle\theta\rangle$. As final result for the observable one quotes $\angle\theta\rangle = \tilde{\theta} \pm \sigma_{\tilde{\theta}}$ . - - - -## Bootstrapping, [code](https://github.com/CompPhysics/MachineLearning/blob/master/doc/Programs/Sampling/analysis.py) - - # Bootstrap - @timeFunction - def bootstrap(self, nBoots = 1000): - bootVec = np.zeros(nBoots) - for k in range(0,nBoots): - bootVec[k] = np.average(np.random.choice(self.data, len(self.data))) - self.bootAvg = np.average(bootVec) - self.bootVar = np.var(bootVec) - self.bootStd = np.std(bootVec) - - -## Jackknife, [code](https://github.com/CompPhysics/MachineLearning/blob/master/doc/Programs/Sampling/analysis.py) - - # Jackknife - @timeFunction - def jackknife(self): - jackknVec = np.zeros(len(self.data)) - for k in range(0,len(self.data)): - jackknVec[k] = np.average(np.delete(self.data, k)) - self.jackknAvg = self.avg - (len(self.data) - 1) * (np.average(jackknVec) - self.avg) - self.jackknVar = float(len(self.data) - 1) * np.var(jackknVec) - self.jackknStd = np.sqrt(self.jackknVar) diff --git a/doc/LectureNotes/_build/jupyter_execute/statistics_178_0.png b/doc/LectureNotes/_build/jupyter_execute/statistics_178_0.png deleted file mode 100644 index d43c704b2..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/statistics_178_0.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/statistics_184_1.png b/doc/LectureNotes/_build/jupyter_execute/statistics_184_1.png deleted file mode 100644 index 9f993f3ab..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/statistics_184_1.png and /dev/null differ diff --git a/doc/LectureNotes/_build/jupyter_execute/statistics_29_0.png b/doc/LectureNotes/_build/jupyter_execute/statistics_29_0.png deleted file mode 100644 index fba899a40..000000000 Binary files a/doc/LectureNotes/_build/jupyter_execute/statistics_29_0.png and /dev/null differ diff --git a/doc/LectureNotes/_toc.yml b/doc/LectureNotes/_toc.yml index 45026a281..ee8322237 100644 --- a/doc/LectureNotes/_toc.yml +++ b/doc/LectureNotes/_toc.yml @@ -29,7 +29,6 @@ parts: numbered: true chapters: - file: chapter8.ipynb - - file: Clustering.ipynb - caption: Deep Learning Methods numbered: true chapters: diff --git a/doc/LectureNotes/add.yml b/doc/LectureNotes/add.yml new file mode 100644 index 000000000..45026a281 --- /dev/null +++ b/doc/LectureNotes/add.yml @@ -0,0 +1,38 @@ +format: jb-book +root: intro +parts: + - caption: About the course + chapters: + - file: schedule + - file: teachers + - file: textbooks + - caption: Review of Statistics with Resampling Techniques and Linear Algebra + numbered: true + chapters: + - file: statistics.ipynb + - file: linalg.ipynb + - caption: From Regression to Support Vector Machines + numbered: true + chapters: + - file: chapter1.ipynb + - file: chapter2.ipynb + - file: chapter3.ipynb + - file: chapter4.ipynb + - file: chapteroptimization.ipynb + - file: chapter5.ipynb + - caption: Decision Trees, Ensemble Methods and Boosting + numbered: true + chapters: + - file: chapter6.ipynb + - file: chapter7.ipynb + - caption: Dimensionality Reduction + numbered: true + chapters: + - file: chapter8.ipynb + - file: Clustering.ipynb + - caption: Deep Learning Methods + numbered: true + chapters: + - file: chapter9.ipynb + - file: chapter10.ipynb + - file: chapter11.ipynb