diff --git a/doc/pub/Statistics/Statistics.ipynb b/doc/pub/Statistics/Statistics.ipynb deleted file mode 100755 index 5f947092e..000000000 --- a/doc/pub/Statistics/Statistics.ipynb +++ /dev/null @@ -1,2855 +0,0 @@ -{ - "cells": [ - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "# Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis\n", - "\n", - " \n", - "**Morten Hjorth-Jensen**, Department of Physics, University of Oslo and Department of Physics and Astronomy and National Superconducting Cyclotron Laboratory, Michigan State University\n", - "\n", - "Date: **Aug 25, 2020**\n", - "\n", - "Copyright 1999-2020, Morten Hjorth-Jensen. Released under CC Attribution-NonCommercial 4.0 license\n", - "\n", - "\n", - "\n", - "\n", - "## To do list\n", - "\n", - "* add math about MVN and define MLE and other quantities\n", - "\n", - "* rewrite about covariance matrix\n", - "\n", - "* add KL theorem\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", - "## 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", - "## 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", - "## 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 - }, - "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", - "## 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", - "## 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", - "## 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", - "## 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", - "## 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", - "## 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", - "## 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", - "## 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", - "## Covariance" - ] - }, - { - "cell_type": "code", - "execution_count": 2, - "metadata": { - "collapsed": false - }, - "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", - "## 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", - "## 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", - "## 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", - "## 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", - "## 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", - "## 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 - }, - "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", - "# 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", - "# 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", - "# 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", - "# 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", - "# 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", - "# 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", - "# 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", - "# 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", - "# 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", - "## 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", - "## 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 - }, - "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", - "## 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 - }, - "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", - "## 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", - "## 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", - "## 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", - "## 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", - "## 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", - "## 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", - "## 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", - "## 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 - }, - "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": [ - "\n", - "## 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/pub/Statistics/html/._Statistics-bs000.html b/doc/pub/Statistics/html/._Statistics-bs000.html index 0383be408..ff6dac9b0 100644 --- a/doc/pub/Statistics/html/._Statistics-bs000.html +++ b/doc/pub/Statistics/html/._Statistics-bs000.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -404,7 +407,7 @@ MathJax.Hub.Config({
[2] Department of Physics and Astronomy and National Superconducting Cyclotron Laboratory, Michigan State University

-

Aug 27, 2018

+

Sep 20, 2020


@@ -428,7 +431,7 @@ MathJax.Hub.Config({

  • 9
  • 10
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • @@ -446,7 +449,7 @@ MathJax.Hub.Config({
    - © 1999-2018, Morten Hjorth-Jensen. Released under CC Attribution-NonCommercial 4.0 license + © 1999-2020, Morten Hjorth-Jensen. Released under CC Attribution-NonCommercial 4.0 license
    diff --git a/doc/pub/Statistics/html/._Statistics-bs001.html b/doc/pub/Statistics/html/._Statistics-bs001.html index 7ccbe08bd..23cc1d20d 100644 --- a/doc/pub/Statistics/html/._Statistics-bs001.html +++ b/doc/pub/Statistics/html/._Statistics-bs001.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -385,29 +388,14 @@ MathJax.Hub.Config({ -

    Domains and probabilities

    -
    -
    -

    -Consider the following simple example, namely the tossing of two dice, resulting in the following possible values -$$ -\begin{equation*} -\{2,3,4,5,6,7,8,9,10,11,12\}. -\end{equation*} -$$ +

    To do list

    -These values are called the domain. -To this domain we have the corresponding probabilities -$$ -\begin{equation*} -\{1/36,2/36/,3/36,4/36,5/36,6/36,5/36,4/36,3/36,2/36,1/36\}. -\end{equation*} -$$ -
    -
    +
      +
    • add math about MVN and define MLE and other quantities
    • +
    • rewrite about covariance matrix
    • +
    • add KL theorem
    • +
    - -

    diff --git a/doc/pub/Statistics/html/._Statistics-bs002.html b/doc/pub/Statistics/html/._Statistics-bs002.html index 7bad7b4e8..9b0afc8df 100644 --- a/doc/pub/Statistics/html/._Statistics-bs002.html +++ b/doc/pub/Statistics/html/._Statistics-bs002.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -385,31 +388,22 @@ MathJax.Hub.Config({ -

    Tossing the dice

    +

    Domains and probabilities

    -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 +Consider the following simple example, namely the tossing of two dice, resulting in the following possible values $$ \begin{equation*} -\{2,3,4,5,6,7,8,9,10,11,12\}, +\{2,3,4,5,6,7,8,9,10,11,12\}. \end{equation*} $$ -appear in a random order. After 11 throws the results may look like - +These values are called the domain. +To this domain we have the corresponding probabilities $$ \begin{equation*} -\{10,8,6,3,6,9,11,8,12,4,5\}. +\{1/36,2/36/,3/36,4/36,5/36,6/36,5/36,4/36,3/36,2/36,1/36\}. \end{equation*} $$

    @@ -434,7 +428,7 @@ $$
  • 11
  • 12
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs003.html b/doc/pub/Statistics/html/._Statistics-bs003.html index 095e5ac8f..43a836a76 100644 --- a/doc/pub/Statistics/html/._Statistics-bs003.html +++ b/doc/pub/Statistics/html/._Statistics-bs003.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -385,13 +388,33 @@ MathJax.Hub.Config({ -

    Stochastic variables

    +

    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.

    -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). +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 +$$ +\begin{equation*} +\{2,3,4,5,6,7,8,9,10,11,12\}, +\end{equation*} +$$ + +appear in a random order. After 11 throws the results may look like + +$$ +\begin{equation*} +\{10,8,6,3,6,9,11,8,12,4,5\}. +\end{equation*} +$$

    @@ -415,7 +438,7 @@ MathJax.Hub.Config({
  • 12
  • 13
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs004.html b/doc/pub/Statistics/html/._Statistics-bs004.html index 6ff2ca862..16f0415d2 100644 --- a/doc/pub/Statistics/html/._Statistics-bs004.html +++ b/doc/pub/Statistics/html/._Statistics-bs004.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -385,26 +388,13 @@ MathJax.Hub.Config({ -

    Stochastic variables and the main concepts, the discrete case

    +

    Stochastic variables

    -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 -$$ -\begin{equation*} -p(x) = \mathrm{Prob}(X=x). -\end{equation*} -$$ +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).

    @@ -429,7 +419,7 @@ $$
  • 13
  • 14
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs005.html b/doc/pub/Statistics/html/._Statistics-bs005.html index acb9d955a..fa46ca4cc 100644 --- a/doc/pub/Statistics/html/._Statistics-bs005.html +++ b/doc/pub/Statistics/html/._Statistics-bs005.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -385,27 +388,26 @@ MathJax.Hub.Config({ -

    Stochastic variables and the main concepts, the continuous case

    +

    Stochastic variables and the main concepts, the discrete 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 +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 $$ \begin{equation*} -\mathrm{Prob}(a\leq X\leq b) = \int_a^b p(x)dx. +p(x) = \mathrm{Prob}(X=x). \end{equation*} $$ - -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.

    @@ -431,7 +433,7 @@ selection of a large set of these numbers reproduces this PDF.
  • 14
  • 15
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs006.html b/doc/pub/Statistics/html/._Statistics-bs006.html index f64849316..57fbc76c6 100644 --- a/doc/pub/Statistics/html/._Statistics-bs006.html +++ b/doc/pub/Statistics/html/._Statistics-bs006.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -385,27 +388,27 @@ MathJax.Hub.Config({ -

    The cumulative probability

    +

    Stochastic variables and the main concepts, the continuous case

    -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 \) -$$ -\begin{equation*} -P(x)=\mathrm{Prob(}X\leq x\mathrm{)} = -\int_{-\infty}^x p(x^{\prime})dx^{\prime}. -\end{equation*} -$$ - -The relation between a CDF and its corresponding PDF is then +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 $$ \begin{equation*} -p(x) = \frac{d}{dx}P(x). +\mathrm{Prob}(a\leq X\leq b) = \int_a^b p(x)dx. \end{equation*} $$ + +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.

    @@ -432,7 +435,7 @@ $$
  • 15
  • 16
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs007.html b/doc/pub/Statistics/html/._Statistics-bs007.html index 26678e24c..70ac42033 100644 --- a/doc/pub/Statistics/html/._Statistics-bs007.html +++ b/doc/pub/Statistics/html/._Statistics-bs007.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -385,31 +388,26 @@ MathJax.Hub.Config({ -

    Properties of PDFs

    +

    The cumulative probability

    - -

    -There are two properties that all PDFs must satisfy. The first one is -positivity (assuming that the PDF is normalized) - +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 \) $$ \begin{equation*} -0 \leq p(x) \leq 1. +P(x)=\mathrm{Prob(}X\leq x\mathrm{)} = +\int_{-\infty}^x p(x^{\prime})dx^{\prime}. \end{equation*} $$ -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 +The relation between a CDF and its corresponding PDF is then + $$ -\begin{align*} -\sum_{x_i\in\mathbb D} p(x_i) & = 1,\\ -\int_{x\in\mathbb D} p(x)\,dx & = 1. -\end{align*} +\begin{equation*} +p(x) = \frac{d}{dx}P(x). +\end{equation*} $$

    @@ -438,7 +436,7 @@ $$
  • 16
  • 17
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs008.html b/doc/pub/Statistics/html/._Statistics-bs008.html index b710632ed..575f2b90c 100644 --- a/doc/pub/Statistics/html/._Statistics-bs008.html +++ b/doc/pub/Statistics/html/._Statistics-bs008.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -385,27 +388,32 @@ MathJax.Hub.Config({ -

    Important distributions, the uniform distribution

    +

    Properties of PDFs

    -The first one -is the most basic PDF; namely the uniform distribution + +

    +There are two properties that all PDFs must satisfy. The first one is +positivity (assuming that the PDF is normalized) + $$ -\begin{equation} -p(x) = \frac{1}{b-a}\theta(x-a)\theta(b-x). -\tag{1} -\end{equation} +\begin{equation*} +0 \leq p(x) \leq 1. +\end{equation*} $$ -For \( a=0 \) and \( b=1 \) we have +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{array}{ll} -p(x)dx = dx & \in [0,1]. -\end{array} +\begin{align*} +\sum_{x_i\in\mathbb D} p(x_i) & = 1,\\ +\int_{x\in\mathbb D} p(x)\,dx & = 1. +\end{align*} $$ - -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.

    @@ -434,7 +442,7 @@ The latter distribution is used to generate random numbers. For other PDFs, one
  • 17
  • 18
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs009.html b/doc/pub/Statistics/html/._Statistics-bs009.html index a8fd06708..3dcdce4d1 100644 --- a/doc/pub/Statistics/html/._Statistics-bs009.html +++ b/doc/pub/Statistics/html/._Statistics-bs009.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -385,70 +388,27 @@ MathJax.Hub.Config({ -

    Gaussian distribution

    +

    Important distributions, the uniform distribution

    -The second one is the Gaussian Distribution +The first one +is the most basic PDF; namely the uniform distribution $$ -\begin{equation*} -p(x) = \frac{1}{\sigma\sqrt{2\pi}} \exp{(-\frac{(x-\mu)^2}{2\sigma^2})}, -\end{equation*} +\begin{equation} +p(x) = \frac{1}{b-a}\theta(x-a)\theta(b-x). +\tag{1} +\end{equation} $$ -with mean value \( \mu \) and standard deviation \( \sigma \). If \( \mu=0 \) and \( \sigma=1 \), it is normally called the standard normal distribution +For \( a=0 \) and \( b=1 \) we have $$ -\begin{equation*} -p(x) = \frac{1}{\sqrt{2\pi}} \exp{(-\frac{x^2}{2})}, -\end{equation*} +\begin{array}{ll} +p(x)dx = dx & \in [0,1]. +\end{array} $$ -

    -The following simple Python code plots the above distribution for different values of \( \mu \) and \( \sigma \). -

    - - -

    -

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

    @@ -478,7 +438,7 @@ plt.show()
  • 18
  • 19
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs010.html b/doc/pub/Statistics/html/._Statistics-bs010.html index 05666b1f4..a9bb83621 100644 --- a/doc/pub/Statistics/html/._Statistics-bs010.html +++ b/doc/pub/Statistics/html/._Statistics-bs010.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -385,16 +388,70 @@ MathJax.Hub.Config({ -

    Exponential distribution

    +

    Gaussian distribution

    -Another important distribution in science is the exponential distribution +The second one is the Gaussian Distribution $$ \begin{equation*} -p(x) = \alpha\exp{-(\alpha x)}. +p(x) = \frac{1}{\sigma\sqrt{2\pi}} \exp{(-\frac{(x-\mu)^2}{2\sigma^2})}, \end{equation*} $$ + +with mean value \( \mu \) and standard deviation \( \sigma \). If \( \mu=0 \) and \( \sigma=1 \), it is normally called the standard normal distribution +$$ +\begin{equation*} +p(x) = \frac{1}{\sqrt{2\pi}} \exp{(-\frac{x^2}{2})}, +\end{equation*} +$$ + +

    +The following simple Python code plots the above distribution for different values of \( \mu \) and \( \sigma \). +

    + + +

    +

    @@ -425,7 +482,7 @@ $$
  • 19
  • 20
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs011.html b/doc/pub/Statistics/html/._Statistics-bs011.html index 1235cd6b5..df44d116c 100644 --- a/doc/pub/Statistics/html/._Statistics-bs011.html +++ b/doc/pub/Statistics/html/._Statistics-bs011.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -385,29 +388,14 @@ MathJax.Hub.Config({ -

    Expectation values

    +

    Exponential distribution

    -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 -\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 +Another important distribution in science is the exponential distribution $$ \begin{equation*} -\langle x^n \rangle \equiv \int\! x^n p(x)\,dx +p(x) = \alpha\exp{-(\alpha x)}. \end{equation*} $$

    @@ -440,7 +428,7 @@ $$
  • 20
  • 21
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs012.html b/doc/pub/Statistics/html/._Statistics-bs012.html index c15ba8ea1..346338464 100644 --- a/doc/pub/Statistics/html/._Statistics-bs012.html +++ b/doc/pub/Statistics/html/._Statistics-bs012.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -385,29 +388,31 @@ MathJax.Hub.Config({ -

    Stochastic variables and the main concepts, mean values

    +

    Expectation 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 \) +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 x\rangle = \mu \equiv \int x p(x)dx, -\end{equation*} +\begin{equation} +\langle h \rangle_X \equiv \int\! h(x)p(x)\,dx +\tag{2} +\end{equation} $$ -for a continuous distribution and +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 $$ \begin{equation*} -\langle x\rangle = \mu \equiv \sum_{i=1}^N x_i p(x_i), +\langle x^n \rangle \equiv \int\! x^n p(x)\,dx \end{equation*} $$ - -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) \).

    @@ -438,7 +443,7 @@ PDF and is therefore simply called the expectation value of \( p(x) \).
  • 21
  • 22
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs013.html b/doc/pub/Statistics/html/._Statistics-bs013.html index e25313478..0b4df3dc3 100644 --- a/doc/pub/Statistics/html/._Statistics-bs013.html +++ b/doc/pub/Statistics/html/._Statistics-bs013.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -385,37 +388,29 @@ MathJax.Hub.Config({ -

    Stochastic variables and the main concepts, central moments, the variance

    +

    Stochastic variables and the main concepts, mean values

    - -

    -A special version of the moments is the set of central moments, the n-th central moment defined as +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 \) $$ \begin{equation*} -\langle (x-\langle x\rangle )^n\rangle \equiv \int\! (x-\langle x\rangle)^n p(x)\,dx +\langle x\rangle = \mu \equiv \int x p(x)dx, \end{equation*} $$ -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) \) +for a continuous distribution and $$ -\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*} +\begin{equation*} +\langle x\rangle = \mu \equiv \sum_{i=1}^N x_i p(x_i), +\end{equation*} $$ -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. +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) \).

    @@ -446,7 +441,7 @@ qualitatively as the "spread" of \( p \) around its mean.
  • 22
  • 23
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs014.html b/doc/pub/Statistics/html/._Statistics-bs014.html index 20db32c95..1e73e7007 100644 --- a/doc/pub/Statistics/html/._Statistics-bs014.html +++ b/doc/pub/Statistics/html/._Statistics-bs014.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -385,37 +388,37 @@ MathJax.Hub.Config({ -

    Probability Distribution Functions

    +

    Stochastic variables and the main concepts, central moments, the variance

    -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. +A special version of the moments is the set of central moments, the n-th central moment defined as +$$ +\begin{equation*} +\langle (x-\langle x\rangle )^n\rangle \equiv \int\! (x-\langle x\rangle)^n p(x)\,dx +\end{equation*} +$$ -

    +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*} +$$ -

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

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

    @@ -446,7 +449,7 @@ while \( P(x) \) is the cumulative probability.
  • 23
  • 24
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs015.html b/doc/pub/Statistics/html/._Statistics-bs015.html index 95d080b23..2ba7757ec 100644 --- a/doc/pub/Statistics/html/._Statistics-bs015.html +++ b/doc/pub/Statistics/html/._Statistics-bs015.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -389,24 +392,33 @@ MathJax.Hub.Config({

    -With a PDF we can compute expectation values of selected quantities such as -$$ -\begin{equation*} - \langle x^k\rangle=\sum_{i=1}^{N}x_i^kp(x_i), -\end{equation*} -$$ +

    +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. -if we have a discrete PDF or +

    -$$ -\begin{equation*} - \langle x^k\rangle=\int_a^b x^kp(x)dx, -\end{equation*} -$$ - -in the case of a continuous PDF. We have already defined the mean value \( \mu \) -and the variance \( \sigma^2 \). +

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

    @@ -437,7 +449,7 @@ and the variance \( \sigma^2 \).
  • 24
  • 25
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs016.html b/doc/pub/Statistics/html/._Statistics-bs016.html index 6a0dd83c7..662f48413 100644 --- a/doc/pub/Statistics/html/._Statistics-bs016.html +++ b/doc/pub/Statistics/html/._Statistics-bs016.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -385,48 +388,32 @@ MathJax.Hub.Config({ -

    The three famous Probability Distribution Functions

    +

    Probability Distribution Functions

    +With a PDF we can compute expectation values of selected quantities such as -

    -There are at least three PDFs which one may encounter. These are the - -

    -Uniform distribution -$$ -\begin{equation*} -p(x)=\frac{1}{b-a}\Theta(x-a)\Theta(b-x), -\end{equation*} -$$ - -yielding probabilities different from zero in the interval \( [a,b] \). - -

    -The exponential distribution -$$ -\begin{equation*} -p(x)=\alpha \exp{(-\alpha x)}, -\end{equation*} -$$ - -yielding probabilities different from zero in the interval \( [0,\infty) \) and with mean value -$$ -\begin{equation*} -\mu = \int_0^{\infty}xp(x)dx=\int_0^{\infty}x\alpha \exp{(-\alpha x)}dx=\frac{1}{\alpha}, -\end{equation*} -$$ -

    -
    - -with variance $$ \begin{equation*} -\sigma^2=\int_0^{\infty}x^2p(x)dx-\mu^2 = \frac{1}{\alpha^2}. + \langle x^k\rangle=\sum_{i=1}^{N}x_i^kp(x_i), \end{equation*} $$ +if we have a discrete PDF or + +$$ +\begin{equation*} + \langle x^k\rangle=\int_a^b x^kp(x)dx, +\end{equation*} +$$ + +in the case of a continuous PDF. We have already defined the mean value \( \mu \) +and the variance \( \sigma^2 \). +
    +
    + +

    @@ -453,7 +440,7 @@ $$

  • 25
  • 26
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs017.html b/doc/pub/Statistics/html/._Statistics-bs017.html index 3a16b71ac..2fe9cd5d9 100644 --- a/doc/pub/Statistics/html/._Statistics-bs017.html +++ b/doc/pub/Statistics/html/._Statistics-bs017.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -385,36 +388,47 @@ MathJax.Hub.Config({ -

    Probability Distribution Functions, the normal distribution

    +

    The three famous Probability Distribution Functions

    -Finally, we have the so-called univariate normal distribution, or just the normal distribution + +

    +There are at least three PDFs which one may encounter. These are the + +

    +Uniform distribution $$ -\begin{equation*} -p(x)=\frac{1}{b\sqrt{2\pi}}\exp{\left(-\frac{(x-a)^2}{2b^2}\right)} +\begin{equation*} +p(x)=\frac{1}{b-a}\Theta(x-a)\Theta(b-x), \end{equation*} $$ -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 +yielding probabilities different from zero in the interval \( [a,b] \). + +

    +The exponential distribution $$ -\begin{equation*} - \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, +\begin{equation*} +p(x)=\alpha \exp{(-\alpha x)}, \end{equation*} $$ -which becomes with a suitable change of variables +yielding probabilities different from zero in the interval \( [0,\infty) \) and with mean value $$ -\begin{equation*} - \mu =\frac{1}{b\sqrt{2\pi}}\int_{-\infty}^{\infty}b\sqrt{2}(a+b\sqrt{2}y)\exp{-y^2}dy=a. +\begin{equation*} +\mu = \int_0^{\infty}xp(x)dx=\int_0^{\infty}x\alpha \exp{(-\alpha x)}dx=\frac{1}{\alpha}, \end{equation*} $$

    +with variance +$$ +\begin{equation*} +\sigma^2=\int_0^{\infty}x^2p(x)dx-\mu^2 = \frac{1}{\alpha^2}. +\end{equation*} +$$

    @@ -442,7 +456,7 @@ $$

  • 26
  • 27
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs018.html b/doc/pub/Statistics/html/._Statistics-bs018.html index f0fc25bed..1883777d5 100644 --- a/doc/pub/Statistics/html/._Statistics-bs018.html +++ b/doc/pub/Statistics/html/._Statistics-bs018.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -389,31 +392,28 @@ MathJax.Hub.Config({

    -Similarly, the variance becomes +Finally, we have the so-called univariate normal distribution, or just the normal distribution $$ -\begin{equation*} - \sigma^2 = \frac{1}{b\sqrt{2\pi}}\int_{-\infty}^{\infty}(x-\mu)^2 \exp{\left(-\frac{(x-a)^2}{2b^2}\right)}dx, +\begin{equation*} +p(x)=\frac{1}{b\sqrt{2\pi}}\exp{\left(-\frac{(x-a)^2}{2b^2}\right)} \end{equation*} $$ -and inserting the mean value and performing a variable change we obtain - +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 $$ \begin{equation*} - \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, + \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, \end{equation*} $$ -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 - +which becomes with a suitable change of variables $$ -\begin{equation} - p(x)=\frac{1}{\sqrt{2\pi}}\exp{\left(-\frac{x^2}{2}\right)}. -\tag{3} -\end{equation} +\begin{equation*} + \mu =\frac{1}{b\sqrt{2\pi}}\int_{-\infty}^{\infty}b\sqrt{2}(a+b\sqrt{2}y)\exp{-y^2}dy=a. +\end{equation*} $$

    @@ -445,7 +445,7 @@ $$
  • 27
  • 28
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs019.html b/doc/pub/Statistics/html/._Statistics-bs019.html index a7a789348..152c66df4 100644 --- a/doc/pub/Statistics/html/._Statistics-bs019.html +++ b/doc/pub/Statistics/html/._Statistics-bs019.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -385,23 +388,36 @@ MathJax.Hub.Config({ -

    Probability Distribution Functions, the cumulative distribution

    +

    Probability Distribution Functions, the normal 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 - +Similarly, the variance becomes $$ -\begin{equation*} -P(x) = \frac{1}{\sqrt{2\pi}}\int_{-\infty}^x\exp{\left(-\frac{t^2}{2}\right)}dt, +\begin{equation*} + \sigma^2 = \frac{1}{b\sqrt{2\pi}}\int_{-\infty}^{\infty}(x-\mu)^2 \exp{\left(-\frac{(x-a)^2}{2b^2}\right)}dx, \end{equation*} $$ -which is difficult to evaluate in a quick way. +and inserting the mean value and performing a variable change we obtain + +$$ +\begin{equation*} + \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, +\end{equation*} +$$ + +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)}. +\tag{3} +\end{equation} +$$

    @@ -432,7 +448,7 @@ which is difficult to evaluate in a quick way.
  • 28
  • 29
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs020.html b/doc/pub/Statistics/html/._Statistics-bs020.html index bddf2f667..152806b76 100644 --- a/doc/pub/Statistics/html/._Statistics-bs020.html +++ b/doc/pub/Statistics/html/._Statistics-bs020.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -385,30 +388,23 @@ MathJax.Hub.Config({ -

    Probability Distribution Functions, other important distribution

    +

    Probability Distribution Functions, the cumulative distribution

    -Some other PDFs which one encounters often in the natural sciences are the binomial 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 + $$ -\begin{equation*} - 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, +\begin{equation*} +P(x) = \frac{1}{\sqrt{2\pi}}\int_{-\infty}^x\exp{\left(-\frac{t^2}{2}\right)}dt, \end{equation*} $$ -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 \).
    • -
    +which is difficult to evaluate in a quick way.
    @@ -439,7 +435,7 @@ The sequence of binomial trials is characterized by the following definitions
  • 29
  • 30
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs021.html b/doc/pub/Statistics/html/._Statistics-bs021.html index b81b133a7..e397783f7 100644 --- a/doc/pub/Statistics/html/._Statistics-bs021.html +++ b/doc/pub/Statistics/html/._Statistics-bs021.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -385,56 +388,33 @@ MathJax.Hub.Config({ -

    Probability Distribution Functions, the binomial distribution

    +

    Probability Distribution Functions, other important distribution

    -In order to compute the mean and variance we need to recall Newton's binomial -formula +Some other PDFs which one encounters often in the natural sciences are the binomial distribution $$ \begin{equation*} - (a+b)^m=\sum_{n=0}^m \left(\begin{array}{c} m \\ n\end{array}\right)a^nb^{m-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, \end{equation*} $$ -which can be used to show that +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. -$$ -\begin{equation*} -\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{equation*} -$$ +

    +The sequence of binomial trials is characterized by the following definitions -the PDF is normalized to one. -The mean value is -$$ -\begin{equation*} -\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{equation*} -$$ - -resulting in -$$ -\begin{equation*} -\mu = -\sum_{x=0}^n x\frac{(n-1)!}{(x-1)!(n-1-(x-1))!}y^{x-1}(1-y)^{n-1-(x-1)}, -\end{equation*} -$$ - -which we rewrite as - -$$ -\begin{equation*} -\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{equation*} -$$ +

      +
    • 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 \).
    • +
    -The variance is slightly trickier to get. It reads \( \sigma^2=ny(1-y) \).

    @@ -462,7 +442,7 @@ The variance is slightly trickier to get. It reads \( \sigma^2=ny(1-y) \).

  • 30
  • 31
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs022.html b/doc/pub/Statistics/html/._Statistics-bs022.html index b7be84176..e9e83aed2 100644 --- a/doc/pub/Statistics/html/._Statistics-bs022.html +++ b/doc/pub/Statistics/html/._Statistics-bs022.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -385,33 +388,56 @@ MathJax.Hub.Config({ -

    Probability Distribution Functions, Poisson's distribution

    +

    Probability Distribution Functions, the binomial distribution

    -Another important distribution with discrete stochastic variables \( x \) is -the Poisson model, which resembles the exponential distribution and reads +In order to compute the mean and variance we need to recall Newton's binomial +formula $$ \begin{equation*} - p(x) = \frac{\lambda^x}{x!} e^{-\lambda} \hspace{0.5cm}x=0,1,\dots,;\lambda > 0. + (a+b)^m=\sum_{n=0}^m \left(\begin{array}{c} m \\ n\end{array}\right)a^nb^{m-n}, \end{equation*} $$ -In this case both the mean value and the variance are easier to calculate, +which can be used to show that $$ \begin{equation*} -\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, +\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{equation*} $$ -and the variance is \( \sigma^2=\lambda \). +the PDF is normalized to one. +The mean value is +$$ +\begin{equation*} +\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{equation*} +$$ + +resulting in +$$ +\begin{equation*} +\mu = +\sum_{x=0}^n x\frac{(n-1)!}{(x-1)!(n-1-(x-1))!}y^{x-1}(1-y)^{n-1-(x-1)}, +\end{equation*} +$$ + +which we rewrite as + +$$ +\begin{equation*} +\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{equation*} +$$

    +The variance is slightly trickier to get. It reads \( \sigma^2=ny(1-y) \).

    @@ -439,7 +465,7 @@ and the variance is \( \sigma^2=\lambda \).

  • 31
  • 32
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs023.html b/doc/pub/Statistics/html/._Statistics-bs023.html index 9e6c696c0..357041f5e 100644 --- a/doc/pub/Statistics/html/._Statistics-bs023.html +++ b/doc/pub/Statistics/html/._Statistics-bs023.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -389,17 +392,26 @@ MathJax.Hub.Config({

    -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 +

    +Another important distribution with discrete stochastic variables \( x \) is +the Poisson model, which resembles the exponential distribution and reads $$ -\begin{equation*} -\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}. +\begin{equation*} + p(x) = \frac{\lambda^x}{x!} e^{-\lambda} \hspace{0.5cm}x=0,1,\dots,;\lambda > 0. \end{equation*} $$ + +In this case both the mean value and the variance are easier to calculate, + +$$ +\begin{equation*} +\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, +\end{equation*} +$$ + +and the variance is \( \sigma^2=\lambda \).

    @@ -430,7 +442,7 @@ $$
  • 32
  • 33
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs024.html b/doc/pub/Statistics/html/._Statistics-bs024.html index e045d4db9..79cc09c42 100644 --- a/doc/pub/Statistics/html/._Statistics-bs024.html +++ b/doc/pub/Statistics/html/._Statistics-bs024.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -385,32 +388,19 @@ MathJax.Hub.Config({ -

    Meet the covariance!

    +

    Probability Distribution Functions, Poisson's distribution

    -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 +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{align} -\mathrm{Cov}(X_i,\,X_j) & = \langle (x_i-\langle x_i\rangle)(x_j-\langle x_j\rangle)\rangle -\tag{4}\\ -&=\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, -\tag{5} -\end{align} -$$ - -with -$$ -\begin{equation*} -\langle x_i\rangle = -\int\cdots\int x_i P(x_1,\dots,x_n)\,dx_1\dots dx_n. +\begin{equation*} +\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{equation*} $$

    @@ -443,7 +433,7 @@ $$
  • 33
  • 34
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs025.html b/doc/pub/Statistics/html/._Statistics-bs025.html index cd2a65058..54917205d 100644 --- a/doc/pub/Statistics/html/._Statistics-bs025.html +++ b/doc/pub/Statistics/html/._Statistics-bs025.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -385,19 +388,34 @@ MathJax.Hub.Config({ -

    Meet the covariance in matrix disguise

    +

    Meet the covariance!

    -If we consider the above covariance as a matrix +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 + $$ -C_{ij} =\mathrm{Cov}(X_i,\,X_j), +\begin{align} +\mathrm{Cov}(X_i,\,X_j) & = \langle (x_i-\langle x_i\rangle)(x_j-\langle x_j\rangle)\rangle +\tag{4}\\ +&=\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, +\tag{5} +\end{align} $$ -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. +with +$$ +\begin{equation*} +\langle x_i\rangle = +\int\cdots\int x_i P(x_1,\dots,x_n)\,dx_1\dots dx_n. +\end{equation*} +$$

    @@ -428,7 +446,7 @@ uncorrelated.
  • 34
  • 35
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs026.html b/doc/pub/Statistics/html/._Statistics-bs026.html index 1a685ef7d..266953522 100644 --- a/doc/pub/Statistics/html/._Statistics-bs026.html +++ b/doc/pub/Statistics/html/._Statistics-bs026.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -385,35 +388,23 @@ MathJax.Hub.Config({ -

    Covariance

    -

    +

    Meet the covariance in matrix disguise

    +
    +
    +

    +If we consider the above covariance as a matrix +$$ +C_{ij} =\mathrm{Cov}(X_i,\,X_j), +$$ - -

    # Importing various packages
    -from math import exp, sqrt
    -from random import random, seed
    -import numpy as np
    -import matplotlib.pyplot as plt
    +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.
    +
    +
    -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) -

    @@ -440,7 +431,7 @@ c = np.c

  • 35
  • 36
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs027.html b/doc/pub/Statistics/html/._Statistics-bs027.html index 465b002e5..9a266a461 100644 --- a/doc/pub/Statistics/html/._Statistics-bs027.html +++ b/doc/pub/Statistics/html/._Statistics-bs027.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -385,38 +388,35 @@ MathJax.Hub.Config({ -

    Meet the covariance, uncorrelated events

    -
    -
    -

    - +

    Covariance

    -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, -$$ + +

    # Importing various packages
    +from math import exp, sqrt
    +from random import random, seed
    +import numpy as np
    +import matplotlib.pyplot as plt
     
    -leading to 
    -$$
    -Cov(X_i, X_j) = 0 \hspace{0.1cm} (i\neq j).
    -$$
    -
    -
    +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) +

    @@ -443,7 +443,7 @@ $$

  • 36
  • 37
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs028.html b/doc/pub/Statistics/html/._Statistics-bs028.html index 41ab5be0c..a993de1f1 100644 --- a/doc/pub/Statistics/html/._Statistics-bs028.html +++ b/doc/pub/Statistics/html/._Statistics-bs028.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -385,25 +388,33 @@ MathJax.Hub.Config({ -

    Numerical experiments and the covariance

    +

    Meet the covariance, uncorrelated events

    -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 +Consider the stochastic variables \( X_i \) and \( X_j \), (\( i\neq j \)). We have $$ -\begin{equation*} -\{x_1, x_2,\dots\,x_k,\dots\}. -\end{equation*} +\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). $$

    @@ -435,7 +446,7 @@ $$
  • 37
  • 38
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs029.html b/doc/pub/Statistics/html/._Statistics-bs029.html index 048ee3d97..ea87fbee2 100644 --- a/doc/pub/Statistics/html/._Statistics-bs029.html +++ b/doc/pub/Statistics/html/._Statistics-bs029.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -389,18 +392,22 @@ MathJax.Hub.Config({

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

    +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 +$$ +\begin{equation*} +\{x_1, x_2,\dots\,x_k,\dots\}. +\end{equation*} +$$

    @@ -431,7 +438,7 @@ interested in finding the few lowest moments, like the mean
  • 38
  • 39
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs030.html b/doc/pub/Statistics/html/._Statistics-bs030.html index 79d5545b7..54f34bf28 100644 --- a/doc/pub/Statistics/html/._Statistics-bs030.html +++ b/doc/pub/Statistics/html/._Statistics-bs030.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -385,26 +388,22 @@ MathJax.Hub.Config({ -

    Numerical experiments and the covariance, actual situations

    +

    Numerical experiments and the covariance

    -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 -$$ -\begin{equation*} -\langle x_{\alpha} \rangle \equiv \frac{1}{n}\sum_{k=1}^n x_{\alpha,k}. -\end{equation*} -$$ - -The sample variance is: -$$ -\begin{equation*} -\mathrm{Var}(x) \equiv \frac{1}{n}\sum_{k=1}^n (x_{\alpha,k} - \langle x_{\alpha} \rangle)^2, -\end{equation*} -$$ - -with its square root being the standard deviation of the sample. +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} \).

    @@ -435,7 +434,7 @@ with its square root being the standard deviation of the sample.
  • 39
  • 40
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs031.html b/doc/pub/Statistics/html/._Statistics-bs031.html index 365d30697..2e6a838e3 100644 --- a/doc/pub/Statistics/html/._Statistics-bs031.html +++ b/doc/pub/Statistics/html/._Statistics-bs031.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -385,35 +388,26 @@ MathJax.Hub.Config({ -

    Numerical experiments and the covariance, our observables

    +

    Numerical experiments and the covariance, actual situations

    -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}, -\tag{6} -\end{equation} -$$ - -where the last sums end at \( m \) and \( n \). -The total variance is +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 $$ \begin{equation*} -\sigma^2_m= \frac{1}{mn^2}\sum_{\alpha=1}^m(\langle x_{\alpha} \rangle-\langle X_m \rangle)^2, +\langle x_{\alpha} \rangle \equiv \frac{1}{n}\sum_{k=1}^n x_{\alpha,k}. \end{equation*} $$ -which we rewrite as +The sample variance is: $$ -\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). -\tag{7} -\end{equation} +\begin{equation*} +\mathrm{Var}(x) \equiv \frac{1}{n}\sum_{k=1}^n (x_{\alpha,k} - \langle x_{\alpha} \rangle)^2, +\end{equation*} $$ + +with its square root being the standard deviation of the sample.

    @@ -444,7 +438,7 @@ $$
  • 40
  • 41
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs032.html b/doc/pub/Statistics/html/._Statistics-bs032.html index 7a798b8a5..9da982cd0 100644 --- a/doc/pub/Statistics/html/._Statistics-bs032.html +++ b/doc/pub/Statistics/html/._Statistics-bs032.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -385,26 +388,35 @@ MathJax.Hub.Config({ -

    Numerical experiments and the covariance, the sample variance

    +

    Numerical experiments and the covariance, our observables

    - -

    -We define also the sample variance \( \sigma^2 \) of all \( mn \) individual experiments as +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} -\sigma^2=\frac{1}{mn}\sum_{\alpha=1}^m\sum_{k=1}^n (x_{\alpha,k}-\langle X_m \rangle)^2. -\tag{8} +\langle X_m \rangle= \frac{1}{m}\sum_{\alpha=1}^mx_{\alpha}=\frac{1}{mn}\sum_{\alpha, k} x_{\alpha,k}, +\tag{6} \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) \). +where the last sums end at \( m \) and \( n \). +The total variance is +$$ +\begin{equation*} +\sigma^2_m= \frac{1}{mn^2}\sum_{\alpha=1}^m(\langle x_{\alpha} \rangle-\langle X_m \rangle)^2, +\end{equation*} +$$ + +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). +\tag{7} +\end{equation} +$$

    @@ -435,7 +447,7 @@ and the covariance \( \mathrm{Cov}(X,Y) \).
  • 41
  • 42
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs033.html b/doc/pub/Statistics/html/._Statistics-bs033.html index 251e479cc..0b59bf4fe 100644 --- a/doc/pub/Statistics/html/._Statistics-bs033.html +++ b/doc/pub/Statistics/html/._Statistics-bs033.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -385,30 +388,26 @@ MathJax.Hub.Config({ -

    Numerical experiments and the covariance, central limit theorem

    +

    Numerical experiments and the covariance, the sample variance

    -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 +We define also the sample variance \( \sigma^2 \) of all \( mn \) individual experiments as $$ -\begin{equation*} - \sigma_m= -\frac{\sigma}{\sqrt{m}}. -\end{equation*} +\begin{equation} +\sigma^2=\frac{1}{mn}\sum_{\alpha=1}^m\sum_{k=1}^n (x_{\alpha,k}-\langle X_m \rangle)^2. +\tag{8} +\end{equation} $$

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

    @@ -439,7 +438,7 @@ In many cases the above estimate for the standard deviation, in particular if co
  • 42
  • 43
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs034.html b/doc/pub/Statistics/html/._Statistics-bs034.html index 9ccf1a224..beef06f3a 100644 --- a/doc/pub/Statistics/html/._Statistics-bs034.html +++ b/doc/pub/Statistics/html/._Statistics-bs034.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -385,35 +388,30 @@ MathJax.Hub.Config({ -

    Definition of Correlation Functions and Standard Deviation

    +

    Numerical experiments and the covariance, central limit theorem

    -Our estimate of the true average \( \mu_{X} \) is the sample mean \( \langle X_m \rangle \) +

    +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 $$ \begin{equation*} -\mu_{X}^{\phantom X} \approx X_m=\frac{1}{mn}\sum_{\alpha=1}^m\sum_{k=1}^n x_{\alpha,k}. + \sigma_m= +\frac{\sigma}{\sqrt{m}}. \end{equation*} $$

    -We can then use Eq. (7) -$$ -\begin{equation*} -\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), -\end{equation*} -$$ - -and rewrite it as -$$ -\begin{equation*} -\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), -\end{equation*} -$$ - -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 \). +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.

    @@ -444,7 +442,7 @@ and the last term is nothing but the covariance which arises when \( k\ne l \).
  • 43
  • 44
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs035.html b/doc/pub/Statistics/html/._Statistics-bs035.html index 9be7ce46f..8a9d5f43d 100644 --- a/doc/pub/Statistics/html/._Statistics-bs035.html +++ b/doc/pub/Statistics/html/._Statistics-bs035.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -391,18 +394,29 @@ MathJax.Hub.Config({

    Our estimate of the true average \( \mu_{X} \) is the sample mean \( \langle X_m \rangle \) +$$ +\begin{equation*} +\mu_{X}^{\phantom X} \approx X_m=\frac{1}{mn}\sum_{\alpha=1}^m\sum_{k=1}^n x_{\alpha,k}. +\end{equation*} +$$ +

    -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. +We can then use Eq. (7) +$$ +\begin{equation*} +\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), +\end{equation*} +$$ + +and rewrite it as +$$ +\begin{equation*} +\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), +\end{equation*} +$$ + +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 \).

    @@ -433,7 +447,7 @@ have to be stored throughout the experiment.
  • 44
  • 45
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs036.html b/doc/pub/Statistics/html/._Statistics-bs036.html index 9b5444177..f99fc6748 100644 --- a/doc/pub/Statistics/html/._Statistics-bs036.html +++ b/doc/pub/Statistics/html/._Statistics-bs036.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -389,26 +392,20 @@ MathJax.Hub.Config({

    +Our estimate of the true average \( \mu_{X} \) is the sample mean \( \langle X_m \rangle \)

    -Let us analyze the problem by splitting up the correlation term into -partial sums of the form - -$$ -\begin{equation*} -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), -\end{equation*} -$$ - -The correlation term of the total variance can now be rewritten in terms of -\( f_d \) - -$$ -\begin{equation*} -\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 -\end{equation*} -$$ +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.

    @@ -439,7 +436,7 @@ $$
  • 45
  • 46
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs037.html b/doc/pub/Statistics/html/._Statistics-bs037.html index e621d7aea..d51f68d2a 100644 --- a/doc/pub/Statistics/html/._Statistics-bs037.html +++ b/doc/pub/Statistics/html/._Statistics-bs037.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -389,20 +392,26 @@ MathJax.Hub.Config({

    -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 + +

    +Let us analyze the problem by splitting up the correlation term into +partial sums of the form $$ -\begin{equation} -\kappa_d = \frac{f_d}{\sigma^2} -\tag{9} -\end{equation} +\begin{equation*} +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), +\end{equation*} $$ -which gives us a useful measure of the correlation pair correlation -starting always at \( 1 \) for \( d=0 \). +The correlation term of the total variance can now be rewritten in terms of +\( f_d \) + +$$ +\begin{equation*} +\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 +\end{equation*} +$$

    @@ -433,7 +442,7 @@ starting always at \( 1 \) for \( d=0 \).
  • 46
  • 47
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs038.html b/doc/pub/Statistics/html/._Statistics-bs038.html index 2d63f6b93..94d33ede2 100644 --- a/doc/pub/Statistics/html/._Statistics-bs038.html +++ b/doc/pub/Statistics/html/._Statistics-bs038.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -385,39 +388,24 @@ MathJax.Hub.Config({ -

    Definition of Correlation Functions and Standard Deviation, sample variance

    +

    Definition of Correlation Functions and Standard Deviation

    - -

    -The sample variance of the \( mn \) experiments can now be -written in terms of the autocorrelation function +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} -\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 -\tag{10} +\kappa_d = \frac{f_d}{\sigma^2} +\tag{9} \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 -\tag{11} -\end{equation} -$$ - - - -For a correlation free experiment, \( \tau \) -equals 1. +which gives us a useful measure of the correlation pair correlation +starting always at \( 1 \) for \( d=0 \).

    @@ -448,7 +436,7 @@ equals 1.
  • 47
  • 48
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs039.html b/doc/pub/Statistics/html/._Statistics-bs039.html index 3311b7e18..307c2ff5b 100644 --- a/doc/pub/Statistics/html/._Statistics-bs039.html +++ b/doc/pub/Statistics/html/._Statistics-bs039.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -385,28 +388,39 @@ MathJax.Hub.Config({ -

    Definition of Correlation Functions and Standard Deviation

    +

    Definition of Correlation Functions and Standard Deviation, sample variance

    -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 + +

    +The sample variance of the \( mn \) experiments can now be +written in terms of the autocorrelation function + $$ -\begin{equation*} -n_\mathrm{eff} = \frac{n}{\tau} -\end{equation*} +\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 +\tag{10} +\end{equation} $$ -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. - +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 +\tag{11} +\end{equation} +$$ + + + +For a correlation free experiment, \( \tau \) +equals 1.

    @@ -437,7 +451,7 @@ more practically oriented methods like the blocking technique.
  • 48
  • 49
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs040.html b/doc/pub/Statistics/html/._Statistics-bs040.html index 739be52ba..941422df7 100644 --- a/doc/pub/Statistics/html/._Statistics-bs040.html +++ b/doc/pub/Statistics/html/._Statistics-bs040.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -383,50 +386,34 @@ MathJax.Hub.Config({

     

     

     

    - + -

    Code to compute the Covariance matrix and the Covariance

    -

    +

    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 +$$ +\begin{equation*} +n_\mathrm{eff} = \frac{n}{\tau} +\end{equation*} +$$ - -

    # Importing various packages
    -from math import exp, sqrt
    -from random import random, seed
    -import numpy as np
    -import matplotlib.pyplot as plt
    +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.
    +
    +
    +
    -# 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) -

    @@ -453,7 +440,7 @@ Eigvals, Eigvecs = np49

  • 50
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs041.html b/doc/pub/Statistics/html/._Statistics-bs041.html index 70d0977ec..79a97ba40 100644 --- a/doc/pub/Statistics/html/._Statistics-bs041.html +++ b/doc/pub/Statistics/html/._Statistics-bs041.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -383,28 +386,50 @@ MathJax.Hub.Config({

     

     

     

    - - -

    Random Numbers

    -
    -
    -

    + +

    Code to compute the Covariance matrix and the Covariance

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

    -
    + +
    # 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)
    +

    @@ -431,7 +456,7 @@ or Monte Carlo computer work.

  • 50
  • 51
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs042.html b/doc/pub/Statistics/html/._Statistics-bs042.html index 54031d712..841231973 100644 --- a/doc/pub/Statistics/html/._Statistics-bs042.html +++ b/doc/pub/Statistics/html/._Statistics-bs042.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -385,25 +388,22 @@ MathJax.Hub.Config({ -

    Random Numbers, better name: pseudo random numbers

    +

    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.
    • -
    +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.
    @@ -434,7 +434,7 @@ numbers, hopefully abiding to the following criteria:
  • 51
  • 52
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs043.html b/doc/pub/Statistics/html/._Statistics-bs043.html index d1964dd09..053ab1fa6 100644 --- a/doc/pub/Statistics/html/._Statistics-bs043.html +++ b/doc/pub/Statistics/html/._Statistics-bs043.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -385,34 +388,25 @@ MathJax.Hub.Config({ -

    Random number generator RNG

    +

    Random Numbers, better name: pseudo random numbers

    - The most common random number generators are based on so-called -Linear congruential relations of the type - -$$ -\begin{equation*} - N_i=(aN_{i-1}+c) \mathrm{MOD} (M), -\end{equation*} -$$ - -which yield a number in the interval [0,1] through - -$$ -\begin{equation*} - x_i=N_i/M -\end{equation*} -$$

    -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 \). +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.
    • +
    @@ -443,7 +437,7 @@ of the division \( 13/9 \), namely \( 4 \).
  • 52
  • 53
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs044.html b/doc/pub/Statistics/html/._Statistics-bs044.html index c80457105..de64e0afa 100644 --- a/doc/pub/Statistics/html/._Statistics-bs044.html +++ b/doc/pub/Statistics/html/._Statistics-bs044.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -385,39 +388,34 @@ MathJax.Hub.Config({ -

    Random number generator RNG and periodic outputs

    +

    Random number generator RNG

    - -

    -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 + The most common random number generators are based on so-called +Linear congruential relations of the type $$ \begin{equation*} - N_i=(6N_{i-1}+7) \mathrm{MOD} (5), + N_i=(aN_{i-1}+c) \mathrm{MOD} (M), \end{equation*} $$ -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 +which yield a number in the interval [0,1] through $$ \begin{equation*} - N_i=(27N_{i-1}+11) \mathrm{MOD} (54), + x_i=N_i/M \end{equation*} $$ -which still, with \( N_0=2 \), results in \( 11,38,11,38,11,38,\dots \), a period of -just \( 2 \). +

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

    @@ -448,7 +446,7 @@ just \( 2 \).
  • 53
  • 54
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs045.html b/doc/pub/Statistics/html/._Statistics-bs045.html index 41d00404d..a566d78c0 100644 --- a/doc/pub/Statistics/html/._Statistics-bs045.html +++ b/doc/pub/Statistics/html/._Statistics-bs045.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -385,23 +388,39 @@ MathJax.Hub.Config({ -

    Random number generator RNG and its period

    +

    Random number generator RNG and periodic outputs

    -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 \), + +

    +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 + $$ \begin{equation*} - N_l=(aN_{l-i}+cN_{l-j})\mathrm{MOD}(M). + N_i=(6N_{i-1}+7) \mathrm{MOD} (5), \end{equation*} $$ + +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 + +$$ +\begin{equation*} + N_i=(27N_{i-1}+11) \mathrm{MOD} (54), +\end{equation*} +$$ + +which still, with \( N_0=2 \), results in \( 11,38,11,38,11,38,\dots \), a period of +just \( 2 \).

    @@ -432,7 +451,7 @@ $$
  • 54
  • 55
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs046.html b/doc/pub/Statistics/html/._Statistics-bs046.html index dab8fb3ec..1b5d92f74 100644 --- a/doc/pub/Statistics/html/._Statistics-bs046.html +++ b/doc/pub/Statistics/html/._Statistics-bs046.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -385,33 +388,23 @@ MathJax.Hub.Config({ -

    Random number generator RNG, other examples

    +

    Random number generator RNG and its period

    -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 - +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 \), $$ -\begin{equation} - N_l=(N_{l-3}-N_{l-1})\mathrm{MOD}(2^{31}-69), -\tag{12} -\end{equation} +\begin{equation*} + N_l=(aN_{l-i}+cN_{l-j})\mathrm{MOD}(M). +\end{equation*} $$ - -followed by -$$ -\begin{equation} - N_l=(69069N_{l-1}+1013904243)\mathrm{MOD}(2^{32}), -\tag{13} -\end{equation} -$$ - -which according to the authors has a period larger than \( 2^{94} \).

    @@ -442,7 +435,7 @@ which according to the authors has a period larger than \( 2^{94} \).
  • 55
  • 56
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs047.html b/doc/pub/Statistics/html/._Statistics-bs047.html index 9f991e549..fc659153b 100644 --- a/doc/pub/Statistics/html/._Statistics-bs047.html +++ b/doc/pub/Statistics/html/._Statistics-bs047.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -389,26 +392,29 @@ MathJax.Hub.Config({

    -Instead of using modular addition, we could use the bitwise -exclusive-OR (\( \oplus \)) operation so that +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-i})\oplus (N_{l-j}) -\end{equation*} +\begin{equation} + N_l=(N_{l-3}-N_{l-1})\mathrm{MOD}(2^{31}-69), +\tag{12} +\end{equation} $$ -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 \). +followed by +$$ +\begin{equation} + N_l=(69069N_{l-1}+1013904243)\mathrm{MOD}(2^{32}), +\tag{13} +\end{equation} +$$ -

    -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 \). +which according to the authors has a period larger than \( 2^{94} \).

    @@ -439,7 +445,7 @@ it is given by \( m\wedge n \).
  • 56
  • 57
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs048.html b/doc/pub/Statistics/html/._Statistics-bs048.html index 2ff5c7903..7987ca36a 100644 --- a/doc/pub/Statistics/html/._Statistics-bs048.html +++ b/doc/pub/Statistics/html/._Statistics-bs048.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -385,46 +388,30 @@ MathJax.Hub.Config({ -

    Random number generator RNG, RAN0

    +

    Random number generator RNG, other examples

    +Instead of using modular addition, we could use the bitwise +exclusive-OR (\( \oplus \)) operation so that + +$$ +\begin{equation*} + N_l=(N_{l-i})\oplus (N_{l-j}) +\end{equation*} +$$ + +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 \).

    -We show here how the linear congruential algorithm can be implemented, namely -$$ -\begin{equation*} - N_i=(aN_{i-1}) \mathrm{MOD} (M). -\end{equation*} -$$ - -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 -$$ -\begin{equation*} - M=aq+r, -\end{equation*} -$$ - -where we have defined - -$$ -\begin{equation*} - q=[M/a], -\end{equation*} -$$ - -and -$$ -\begin{equation*} - r = M\hspace{0.1cm}\mathrm{MOD} \hspace{0.1cm}a. -\end{equation*} -$$ - -where the brackets denote integer division. In the code below the numbers -\( q \) and \( r \) are chosen so that \( r < q \). +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 \).

    @@ -455,7 +442,7 @@ where the brackets denote integer division. In the code below the numbers
  • 57
  • 58
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs049.html b/doc/pub/Statistics/html/._Statistics-bs049.html index 39f90ae7d..6a11dc639 100644 --- a/doc/pub/Statistics/html/._Statistics-bs049.html +++ b/doc/pub/Statistics/html/._Statistics-bs049.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -391,17 +394,40 @@ MathJax.Hub.Config({

    -To see how this works we note first that +We show here how the linear congruential algorithm can be implemented, namely $$ -\begin{equation} -(aN_{i-1}) \mathrm{MOD} (M)= (aN_{i-1}-[N_{i-1}/q]M)\mathrm{MOD} (M), -\tag{14} -\end{equation} +\begin{equation*} + N_i=(aN_{i-1}) \mathrm{MOD} (M). +\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 \). +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 +$$ +\begin{equation*} + M=aq+r, +\end{equation*} +$$ + +where we have defined + +$$ +\begin{equation*} + q=[M/a], +\end{equation*} +$$ + +and +$$ +\begin{equation*} + r = M\hspace{0.1cm}\mathrm{MOD} \hspace{0.1cm}a. +\end{equation*} +$$ + +where the brackets denote integer division. In the code below the numbers +\( q \) and \( r \) are chosen so that \( r < q \). @@ -432,7 +458,7 @@ The last term \( [N_{i-1}/q]M\mathrm{MOD}(M) \) is zero since the integer divisi

  • 58
  • 59
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs050.html b/doc/pub/Statistics/html/._Statistics-bs050.html index b8ea7a3b1..83a2cde5a 100644 --- a/doc/pub/Statistics/html/._Statistics-bs050.html +++ b/doc/pub/Statistics/html/._Statistics-bs050.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -389,32 +392,19 @@ MathJax.Hub.Config({

    -We can now rewrite Eq. (14) as +

    +To see how this works we note first that $$ \begin{equation} -(aN_{i-1}) \mathrm{MOD} (M)= (aN_{i-1}-[N_{i-1}/q](aq+r))\mathrm{MOD} (M), -\tag{15} +(aN_{i-1}) \mathrm{MOD} (M)= (aN_{i-1}-[N_{i-1}/q]M)\mathrm{MOD} (M), +\tag{14} \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), -\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). -\tag{17} -\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 \).

    @@ -445,7 +435,7 @@ $$
  • 59
  • 60
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs051.html b/doc/pub/Statistics/html/._Statistics-bs051.html index 1b2c4e393..82b9d26f6 100644 --- a/doc/pub/Statistics/html/._Statistics-bs051.html +++ b/doc/pub/Statistics/html/._Statistics-bs051.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -389,18 +392,32 @@ MathJax.Hub.Config({

    -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 \). +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), +\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), +\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). +\tag{17} +\end{equation} +$$

    @@ -431,7 +448,7 @@ set to \( 0 \).
  • 60
  • 61
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs052.html b/doc/pub/Statistics/html/._Statistics-bs052.html index 5f0160769..fab83de1c 100644 --- a/doc/pub/Statistics/html/._Statistics-bs052.html +++ b/doc/pub/Statistics/html/._Statistics-bs052.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -385,42 +388,22 @@ MathJax.Hub.Config({ -

    Random number generator RNG, RAN0 code

    +

    Random number generator RNG, RAN0

    - -

    - - -

        /*
    -     ** 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() 
    -
    -

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

    @@ -451,7 +434,7 @@ MathJax.Hub.Config({
  • 61
  • 62
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs053.html b/doc/pub/Statistics/html/._Statistics-bs053.html index 0756a324f..6c7491a10 100644 --- a/doc/pub/Statistics/html/._Statistics-bs053.html +++ b/doc/pub/Statistics/html/._Statistics-bs053.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -385,27 +388,42 @@ MathJax.Hub.Config({ -

    Properties of Selected Random Number Generators

    +

    Random number generator RNG, RAN0 code

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

        /*
    +     ** 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() 
    +

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

    @@ -436,7 +454,7 @@ Two additional measures are the standard deviation \( \sigma \) and the mean
  • 62
  • 63
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs054.html b/doc/pub/Statistics/html/._Statistics-bs054.html index f31f1200c..c3d0702dd 100644 --- a/doc/pub/Statistics/html/._Statistics-bs054.html +++ b/doc/pub/Statistics/html/._Statistics-bs054.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -389,21 +392,23 @@ MathJax.Hub.Config({

    -For the uniform distribution, the mean value \( \mu \) is then -$$ -\begin{equation*} - \mu=\langle x\rangle=\frac{1}{2} -\end{equation*} -$$ +

    +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 \). -while the standard deviation is +

    +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. -$$ -\begin{equation*} - \sigma=\sqrt{\langle x^2\rangle-\mu^2}=\frac{1}{\sqrt{12}}=0.2886. -\end{equation*} -$$ +

    +Two additional measures are the standard deviation \( \sigma \) and the mean +\( \mu=\langle x\rangle \).

    @@ -434,7 +439,7 @@ $$
  • 63
  • 64
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs055.html b/doc/pub/Statistics/html/._Statistics-bs055.html index 15e4f5c5e..213b8d3f5 100644 --- a/doc/pub/Statistics/html/._Statistics-bs055.html +++ b/doc/pub/Statistics/html/._Statistics-bs055.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -389,35 +392,21 @@ MathJax.Hub.Config({

    -The various random number generators produce results which agree rather well with -these limiting values. +For the uniform distribution, the mean value \( \mu \) is then -

    +$$ +\begin{equation*} + \mu=\langle x\rangle=\frac{1}{2} +\end{equation*} +$$ -

    -
    - - - - - - - - - - - - - - - - - - -
    \( 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
    -
    -
    -

    +while the standard deviation is + +$$ +\begin{equation*} + \sigma=\sqrt{\langle x^2\rangle-\mu^2}=\frac{1}{\sqrt{12}}=0.2886. +\end{equation*} +$$

    @@ -448,7 +437,7 @@ these limiting values.
  • 64
  • 65
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs056.html b/doc/pub/Statistics/html/._Statistics-bs056.html index ddcefa5ca..f53b8e4c6 100644 --- a/doc/pub/Statistics/html/._Statistics-bs056.html +++ b/doc/pub/Statistics/html/._Statistics-bs056.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -385,39 +388,38 @@ MathJax.Hub.Config({ -

    Simple demonstration of RNGs using python

    +

    Properties of Selected Random Number Generators

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

    @@ -449,7 +451,7 @@ plt.show()
  • 65
  • 66
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs057.html b/doc/pub/Statistics/html/._Statistics-bs057.html index 5935bca55..ba4a9c026 100644 --- a/doc/pub/Statistics/html/._Statistics-bs057.html +++ b/doc/pub/Statistics/html/._Statistics-bs057.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -385,36 +388,39 @@ MathJax.Hub.Config({ -

    Properties of Selected Random Number Generators

    +

    Simple demonstration of RNGs using python

    -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 -$$ -\begin{equation*} - C_k=\frac{f_d} - {\sigma^2}, -\end{equation*} -$$ - -with \( C_0=1 \). Recall that -\( \sigma^2=\langle x_i^2\rangle-\langle x_i\rangle^2 \) and that -$$ -\begin{equation*} -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), -\end{equation*} -$$ - +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.

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

    @@ -446,7 +452,7 @@ assumption for approximating \( \sigma_N \) is no longer valid.
  • 66
  • 67
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs058.html b/doc/pub/Statistics/html/._Statistics-bs058.html index 6fa85950c..b02ceadb8 100644 --- a/doc/pub/Statistics/html/._Statistics-bs058.html +++ b/doc/pub/Statistics/html/._Statistics-bs058.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -385,44 +388,40 @@ MathJax.Hub.Config({ -

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

    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 +$$ +\begin{equation*} + C_k=\frac{f_d} + {\sigma^2}, +\end{equation*} +$$ + +with \( C_0=1 \). Recall that +\( \sigma^2=\langle x_i^2\rangle-\langle x_i\rangle^2 \) and that +$$ +\begin{equation*} +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), +\end{equation*} +$$ +

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

    # 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. +

    +
    +

    @@ -450,7 +449,7 @@ For the remaining values we notice that there are still non-zero values for the

  • 67
  • 68
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs059.html b/doc/pub/Statistics/html/._Statistics-bs059.html index e3aa089f6..f0b2969c6 100644 --- a/doc/pub/Statistics/html/._Statistics-bs059.html +++ b/doc/pub/Statistics/html/._Statistics-bs059.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -385,85 +388,44 @@ MathJax.Hub.Config({ -

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

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

    - -

    //  This function computes the autocorrelation function for 
    -//  the standard c++ random number generator
    +
    +
    # Importing various packages
    +from math import exp, sqrt
    +from random import random, seed
    +import numpy as np
    +import matplotlib.pyplot as plt
     
    -#include <fstream>
    -#include <iomanip>
    -#include <iostream>
    -#include <cmath>
    -using namespace std;
    -// output file as global variable
    -ofstream ofile;  
    +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
     
    -//     Main function begins here     
    -int main(int argc, char* argv[])
    -{
    -     int n;
    -     char *outfilename;
    +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    
     
    -     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 
    +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.

    @@ -491,7 +453,7 @@ ofstream ofile;

  • 68
  • 69
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs060.html b/doc/pub/Statistics/html/._Statistics-bs060.html index c57063634..032098c40 100644 --- a/doc/pub/Statistics/html/._Statistics-bs060.html +++ b/doc/pub/Statistics/html/._Statistics-bs060.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -385,15 +388,82 @@ MathJax.Hub.Config({ -

    Which RNG should I use?

    +

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

    -

      -
    • 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
    • -
    + +
    //  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 
    +
    +

    @@ -424,7 +494,7 @@ MathJax.Hub.Config({
  • 69
  • 70
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs061.html b/doc/pub/Statistics/html/._Statistics-bs061.html index 6ddd0f5bc..668fe7383 100644 --- a/doc/pub/Statistics/html/._Statistics-bs061.html +++ b/doc/pub/Statistics/html/._Statistics-bs061.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -385,29 +388,15 @@ MathJax.Hub.Config({ -

    How to use the Mersenne generator

    +

    Which RNG should I use?

    -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);
    -
    -

    +

      +
    • 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
    • +
    @@ -438,7 +427,7 @@ The following part of a c++ code (from project 4) sets up the uniform distributi
  • 70
  • 71
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs062.html b/doc/pub/Statistics/html/._Statistics-bs062.html index e9e92e740..43717379f 100644 --- a/doc/pub/Statistics/html/._Statistics-bs062.html +++ b/doc/pub/Statistics/html/._Statistics-bs062.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -385,19 +388,28 @@ MathJax.Hub.Config({ -

    Why blocking?

    +

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

    -

      -
    • 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).
    +//  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);
    +

    @@ -429,7 +441,7 @@ A very good article which explains blocking is H. Flyvbjerg and H. G. Petersen,
  • 71
  • 72
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs063.html b/doc/pub/Statistics/html/._Statistics-bs063.html index cf9b3be9e..359e21b86 100644 --- a/doc/pub/Statistics/html/._Statistics-bs063.html +++ b/doc/pub/Statistics/html/._Statistics-bs063.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -391,16 +394,14 @@ MathJax.Hub.Config({

      -
    • As in other experiments, Monte Carlo experiments have two classes of errors:
    • - -
        -
      • Statistical errors
      • -
      • Systematical errors
      • +
      • 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.
      -
    • 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)
    • -
    +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). + +

    @@ -431,7 +432,7 @@ MathJax.Hub.Config({
  • 72
  • 73
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs064.html b/doc/pub/Statistics/html/._Statistics-bs064.html index 536a1adca..14c5e10cd 100644 --- a/doc/pub/Statistics/html/._Statistics-bs064.html +++ b/doc/pub/Statistics/html/._Statistics-bs064.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -385,91 +388,26 @@ MathJax.Hub.Config({ -

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

    +

    Why blocking?

    +
    +
    +

    - -

    //  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;
    +
      +
    • As in other experiments, Monte Carlo experiments have two classes of errors:
    • -// 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); - } +
        +
      • Statistical errors
      • +
      • Systematical errors
      • +
      - // 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 +
    • 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)
    • +
    +
    +
    - 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 -

    @@ -496,7 +434,7 @@ ofstream ofile;

  • 73
  • 74
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs065.html b/doc/pub/Statistics/html/._Statistics-bs065.html index c21de1405..0403e0e4a 100644 --- a/doc/pub/Statistics/html/._Statistics-bs065.html +++ b/doc/pub/Statistics/html/._Statistics-bs065.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -385,34 +388,91 @@ MathJax.Hub.Config({ -

    What is blocking?

    -
    -
    -

    +

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

    -

      -
    • 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
    • -
    + +
    //  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;
     
    -$$
    -\sigma=\sqrt{\frac{1}{n}\left(\langle \mathbf{M}^2\rangle-\langle \mathbf{M}\rangle^2\right)} 
    -$$
    +//     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  
     
    -
      -
    • 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 -
    -
    - + 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 +

    @@ -438,6 +498,8 @@ $$

  • 73
  • 74
  • 75
  • +
  • ...
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs066.html b/doc/pub/Statistics/html/._Statistics-bs066.html index b44d6f692..a835c3a76 100644 --- a/doc/pub/Statistics/html/._Statistics-bs066.html +++ b/doc/pub/Statistics/html/._Statistics-bs066.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -391,13 +394,24 @@ MathJax.Hub.Config({

      -
    • 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
    • +
    • 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 @@ -426,6 +440,7 @@ MathJax.Hub.Config({
  • 73
  • 74
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs067.html b/doc/pub/Statistics/html/._Statistics-bs067.html index e37f986e4..927d1570c 100644 --- a/doc/pub/Statistics/html/._Statistics-bs067.html +++ b/doc/pub/Statistics/html/._Statistics-bs067.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -391,10 +394,12 @@ MathJax.Hub.Config({

      -
    • 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
    • +
    • 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
    @@ -423,6 +428,7 @@ MathJax.Hub.Config({
  • 73
  • 74
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs068.html b/doc/pub/Statistics/html/._Statistics-bs068.html index 270e6bbb8..c72d4f1ba 100644 --- a/doc/pub/Statistics/html/._Statistics-bs068.html +++ b/doc/pub/Statistics/html/._Statistics-bs068.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -385,20 +388,16 @@ MathJax.Hub.Config({ -

    Implementation

    +

    What is blocking?

      -
    • 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
    • +
    • 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
    @@ -426,6 +425,7 @@ MathJax.Hub.Config({
  • 73
  • 74
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs069.html b/doc/pub/Statistics/html/._Statistics-bs069.html index 6f98bd6ee..c414c06b2 100644 --- a/doc/pub/Statistics/html/._Statistics-bs069.html +++ b/doc/pub/Statistics/html/._Statistics-bs069.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -385,43 +388,25 @@ MathJax.Hub.Config({ -

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

    +

    Implementation

    +
    +
    +

    - -

    # Blocking
    -    @timeFunction
    -    def blocking(self, blockSizeMax = 500):
    -        blockSizeMin = 1
    +
      +
    • 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
    • +
    +
    +
    - 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) -

    @@ -443,6 +428,7 @@ The 73

  • 74
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs070.html b/doc/pub/Statistics/html/._Statistics-bs070.html index 071cd5a60..eb0b352eb 100644 --- a/doc/pub/Statistics/html/._Statistics-bs070.html +++ b/doc/pub/Statistics/html/._Statistics-bs070.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -385,23 +388,43 @@ MathJax.Hub.Config({ -

    The Bootstrap method

    - +

    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.

    -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. -
    + +
    # Blocking
    +    @timeFunction
    +    def blocking(self, blockSizeMax = 500):
    +        blockSizeMin = 1
     
    -It can be shown, see the article by Efron
    -that it produces the correct standard deviation.
    +        self.blockSizes = []
    +        self.meanVec = []
    +        self.varVec = []
     
    -

    -This method is very useful for small ensembles of data points. + 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) +

    @@ -422,6 +445,7 @@ This method is very useful for small ensembles of data points.

  • 73
  • 74
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs071.html b/doc/pub/Statistics/html/._Statistics-bs071.html index be4af3a8f..8f491205f 100644 --- a/doc/pub/Statistics/html/._Statistics-bs071.html +++ b/doc/pub/Statistics/html/._Statistics-bs071.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -383,15 +386,24 @@ MathJax.Hub.Config({

     

     

     

    - + -

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

    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.

    @@ -412,6 +424,7 @@ This costs essentially nothing, since we just recycle the original data set for

  • 73
  • 74
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs072.html b/doc/pub/Statistics/html/._Statistics-bs072.html index a16b22560..1bf61fd73 100644 --- a/doc/pub/Statistics/html/._Statistics-bs072.html +++ b/doc/pub/Statistics/html/._Statistics-bs072.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -385,26 +388,13 @@ MathJax.Hub.Config({ -

    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

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

    @@ -424,6 +414,7 @@ the true \( \angle\theta\rangle \). As final result for the observable one quote

  • 73
  • 74
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs073.html b/doc/pub/Statistics/html/._Statistics-bs073.html index 116ea15e7..2b93160c1 100644 --- a/doc/pub/Statistics/html/._Statistics-bs073.html +++ b/doc/pub/Statistics/html/._Statistics-bs073.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -385,20 +388,27 @@ MathJax.Hub.Config({ -

    Bootstrapping, code

    -

    +

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

    # 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)
    -

    @@ -416,6 +426,7 @@ MathJax.Hub.Config({

  • 73
  • 74
  • 75
  • +
  • 76
  • »
  • diff --git a/doc/pub/Statistics/html/._Statistics-bs074.html b/doc/pub/Statistics/html/._Statistics-bs074.html index 222252c62..711986fd0 100644 --- a/doc/pub/Statistics/html/._Statistics-bs074.html +++ b/doc/pub/Statistics/html/._Statistics-bs074.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -385,22 +388,21 @@ MathJax.Hub.Config({ -

    Jackknife, code

    +

    Bootstrapping, code

    -

    # Jackknife
    +
    # Bootstrap
         @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)
    +    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)
     

    -

      @@ -416,6 +418,8 @@ MathJax.Hub.Config({
    • 73
    • 74
    • 75
    • +
    • 76
    • +
    • »
    diff --git a/doc/pub/Statistics/html/._Statistics-bs075.html b/doc/pub/Statistics/html/._Statistics-bs075.html index 0ef53d488..d8cf8f3c5 100644 --- a/doc/pub/Statistics/html/._Statistics-bs075.html +++ b/doc/pub/Statistics/html/._Statistics-bs075.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,9 +56,9 @@ $(function () { @@ -298,9 +298,9 @@ MathJax.Hub.Config({ @@ -389,21 +388,22 @@ MathJax.Hub.Config({ -

    Bootstrapping, code

    +

    Jackknife, code

    -

    # Bootstrap
    +
    # Jackknife
         @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)
    +    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)
     

    +

      @@ -419,8 +419,6 @@ MathJax.Hub.Config({
    • 74
    • 75
    • 76
    • -
    • 77
    • -
    • »
    diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs000.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs000.html new file mode 100644 index 000000000..b8cde1a33 --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs000.html @@ -0,0 +1,459 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + +

     

     

     

    + + + + + + +
    +

    Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis

    + +

    + + +

    +Morten Hjorth-Jensen [1, 2] +
    + +

    + + +

    [1] Department of Physics, University of Oslo
    +
    [2] Department of Physics and Astronomy and National Superconducting Cyclotron Laboratory, Michigan State University
    +
    +

    +

    Sep 20, 2020

    +
    +

    + + +

    Read »

    + + +
    + +

    + +

    + + +
    + + + + + + + +
    + © 1999-2020, Morten Hjorth-Jensen. Released under CC Attribution-NonCommercial 4.0 license +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs001.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs001.html new file mode 100644 index 000000000..f9a5f9376 --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs001.html @@ -0,0 +1,440 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +
    + +

     

     

     

    + + + + +

    To do list

    + +
      +
    • add math about MVN and define MLE and other quantities
    • +
    • rewrite about covariance matrix
    • +
    • add KL theorem
    • +
    + +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs002.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs002.html new file mode 100644 index 000000000..719e8a3b4 --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs002.html @@ -0,0 +1,456 @@ + + + + + + + + +Data Analysis and Machine Learning: 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 +$$ +\begin{equation*} +\{2,3,4,5,6,7,8,9,10,11,12\}. +\end{equation*} +$$ + +These values are called the domain. +To this domain we have the corresponding probabilities +$$ +\begin{equation*} +\{1/36,2/36/,3/36,4/36,5/36,6/36,5/36,4/36,3/36,2/36,1/36\}. +\end{equation*} +$$ +

    +
    + + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs003.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs003.html new file mode 100644 index 000000000..3f68ad04a --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs003.html @@ -0,0 +1,466 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

    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 +$$ +\begin{equation*} +\{2,3,4,5,6,7,8,9,10,11,12\}, +\end{equation*} +$$ + +appear in a random order. After 11 throws the results may look like + +$$ +\begin{equation*} +\{10,8,6,3,6,9,11,8,12,4,5\}. +\end{equation*} +$$ +

    +
    + + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs004.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs004.html new file mode 100644 index 000000000..f0c92d8e5 --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs004.html @@ -0,0 +1,447 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

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

    +
    + + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs005.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs005.html new file mode 100644 index 000000000..a27ee1e29 --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs005.html @@ -0,0 +1,461 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

    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 +$$ +\begin{equation*} +p(x) = \mathrm{Prob}(X=x). +\end{equation*} +$$ +

    +
    + + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs006.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs006.html new file mode 100644 index 000000000..a9010c766 --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs006.html @@ -0,0 +1,463 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

    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 + +$$ +\begin{equation*} +\mathrm{Prob}(a\leq X\leq b) = \int_a^b p(x)dx. +\end{equation*} +$$ + +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. +

    +
    + + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs007.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs007.html new file mode 100644 index 000000000..ff9604747 --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs007.html @@ -0,0 +1,464 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

    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 \) +$$ +\begin{equation*} +P(x)=\mathrm{Prob(}X\leq x\mathrm{)} = +\int_{-\infty}^x p(x^{\prime})dx^{\prime}. +\end{equation*} +$$ + +The relation between a CDF and its corresponding PDF is then + +$$ +\begin{equation*} +p(x) = \frac{d}{dx}P(x). +\end{equation*} +$$ +

    +
    + + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs008.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs008.html new file mode 100644 index 000000000..28c3464a4 --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs008.html @@ -0,0 +1,470 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

    Properties of PDFs

    +
    +
    +

    + +

    +There are two properties that all PDFs must satisfy. The first one is +positivity (assuming that the PDF is normalized) + +$$ +\begin{equation*} +0 \leq p(x) \leq 1. +\end{equation*} +$$ + +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*} +$$ +

    +
    + + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs009.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs009.html new file mode 100644 index 000000000..37cd4ba89 --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs009.html @@ -0,0 +1,466 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

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

    +
    + + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs010.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs010.html new file mode 100644 index 000000000..b197a9a4a --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs010.html @@ -0,0 +1,510 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

    Gaussian distribution

    +
    +
    +

    +The second one is the Gaussian Distribution +$$ +\begin{equation*} +p(x) = \frac{1}{\sigma\sqrt{2\pi}} \exp{(-\frac{(x-\mu)^2}{2\sigma^2})}, +\end{equation*} +$$ + +with mean value \( \mu \) and standard deviation \( \sigma \). If \( \mu=0 \) and \( \sigma=1 \), it is normally called the standard normal distribution +$$ +\begin{equation*} +p(x) = \frac{1}{\sqrt{2\pi}} \exp{(-\frac{x^2}{2})}, +\end{equation*} +$$ + +

    +The following simple Python code plots the above distribution for different values of \( \mu \) and \( \sigma \). +

    + + +

    +

    +

    +
    + + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs011.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs011.html new file mode 100644 index 000000000..c4c75fae1 --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs011.html @@ -0,0 +1,456 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

    Exponential distribution

    +
    +
    +

    +Another important distribution in science is the exponential distribution +$$ +\begin{equation*} +p(x) = \alpha\exp{-(\alpha x)}. +\end{equation*} +$$ +

    +
    + + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs012.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs012.html new file mode 100644 index 000000000..be60ec6c0 --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs012.html @@ -0,0 +1,471 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

    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 +\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 +$$ +\begin{equation*} +\langle x^n \rangle \equiv \int\! x^n p(x)\,dx +\end{equation*} +$$ +

    +
    + + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs013.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs013.html new file mode 100644 index 000000000..3f6e599d3 --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs013.html @@ -0,0 +1,469 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

    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 \) +$$ +\begin{equation*} +\langle x\rangle = \mu \equiv \int x p(x)dx, +\end{equation*} +$$ + +for a continuous distribution and +$$ +\begin{equation*} +\langle x\rangle = \mu \equiv \sum_{i=1}^N x_i p(x_i), +\end{equation*} +$$ + +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) \). +

    +
    + + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs014.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs014.html new file mode 100644 index 000000000..0ff9a0489 --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs014.html @@ -0,0 +1,477 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

    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 +$$ +\begin{equation*} +\langle (x-\langle x\rangle )^n\rangle \equiv \int\! (x-\langle x\rangle)^n p(x)\,dx +\end{equation*} +$$ + +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. +

    +
    + + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs015.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs015.html new file mode 100644 index 000000000..f51ec44e7 --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs015.html @@ -0,0 +1,477 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

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

    +

    +
    + + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs016.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs016.html new file mode 100644 index 000000000..af278832b --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs016.html @@ -0,0 +1,468 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

    Probability Distribution Functions

    +
    +
    +

    +With a PDF we can compute expectation values of selected quantities such as + +$$ +\begin{equation*} + \langle x^k\rangle=\sum_{i=1}^{N}x_i^kp(x_i), +\end{equation*} +$$ + +if we have a discrete PDF or + +$$ +\begin{equation*} + \langle x^k\rangle=\int_a^b x^kp(x)dx, +\end{equation*} +$$ + +in the case of a continuous PDF. We have already defined the mean value \( \mu \) +and the variance \( \sigma^2 \). +

    +
    + + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs017.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs017.html new file mode 100644 index 000000000..9068b29dc --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs017.html @@ -0,0 +1,484 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

    The three famous Probability Distribution Functions

    +
    +
    +

    + +

    +There are at least three PDFs which one may encounter. These are the + +

    +Uniform distribution +$$ +\begin{equation*} +p(x)=\frac{1}{b-a}\Theta(x-a)\Theta(b-x), +\end{equation*} +$$ + +yielding probabilities different from zero in the interval \( [a,b] \). + +

    +The exponential distribution +$$ +\begin{equation*} +p(x)=\alpha \exp{(-\alpha x)}, +\end{equation*} +$$ + +yielding probabilities different from zero in the interval \( [0,\infty) \) and with mean value +$$ +\begin{equation*} +\mu = \int_0^{\infty}xp(x)dx=\int_0^{\infty}x\alpha \exp{(-\alpha x)}dx=\frac{1}{\alpha}, +\end{equation*} +$$ +

    +
    + +with variance +$$ +\begin{equation*} +\sigma^2=\int_0^{\infty}x^2p(x)dx-\mu^2 = \frac{1}{\alpha^2}. +\end{equation*} +$$ + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs018.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs018.html new file mode 100644 index 000000000..30d11b152 --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs018.html @@ -0,0 +1,473 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

    Probability Distribution Functions, the normal distribution

    +
    +
    +

    +Finally, we have the so-called univariate normal distribution, or just the normal distribution +$$ +\begin{equation*} +p(x)=\frac{1}{b\sqrt{2\pi}}\exp{\left(-\frac{(x-a)^2}{2b^2}\right)} +\end{equation*} +$$ + +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 +$$ +\begin{equation*} + \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, +\end{equation*} +$$ + +which becomes with a suitable change of variables +$$ +\begin{equation*} + \mu =\frac{1}{b\sqrt{2\pi}}\int_{-\infty}^{\infty}b\sqrt{2}(a+b\sqrt{2}y)\exp{-y^2}dy=a. +\end{equation*} +$$ +

    +
    + + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs019.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs019.html new file mode 100644 index 000000000..668d5b370 --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs019.html @@ -0,0 +1,476 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

    Probability Distribution Functions, the normal distribution

    +
    +
    +

    +Similarly, the variance becomes +$$ +\begin{equation*} + \sigma^2 = \frac{1}{b\sqrt{2\pi}}\int_{-\infty}^{\infty}(x-\mu)^2 \exp{\left(-\frac{(x-a)^2}{2b^2}\right)}dx, +\end{equation*} +$$ + +and inserting the mean value and performing a variable change we obtain + +$$ +\begin{equation*} + \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, +\end{equation*} +$$ + +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)}. +\tag{3} +\end{equation} +$$ +

    +
    + + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs020.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs020.html new file mode 100644 index 000000000..1ad2d0761 --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs020.html @@ -0,0 +1,463 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

    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 + +$$ +\begin{equation*} +P(x) = \frac{1}{\sqrt{2\pi}}\int_{-\infty}^x\exp{\left(-\frac{t^2}{2}\right)}dt, +\end{equation*} +$$ + +which is difficult to evaluate in a quick way. +

    +
    + + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs021.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs021.html new file mode 100644 index 000000000..d00f2e76c --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs021.html @@ -0,0 +1,470 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

    Probability Distribution Functions, other important distribution

    +
    +
    +

    + +

    +Some other PDFs which one encounters often in the natural sciences are the binomial distribution +$$ +\begin{equation*} + 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{equation*} +$$ + +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 \).
    • +
    +
    +
    + + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs022.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs022.html new file mode 100644 index 000000000..23922dd6c --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs022.html @@ -0,0 +1,493 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

    Probability Distribution Functions, the binomial distribution

    +
    +
    +

    + +

    +In order to compute the mean and variance we need to recall Newton's binomial +formula +$$ +\begin{equation*} + (a+b)^m=\sum_{n=0}^m \left(\begin{array}{c} m \\ n\end{array}\right)a^nb^{m-n}, +\end{equation*} +$$ + +which can be used to show that + +$$ +\begin{equation*} +\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{equation*} +$$ + +the PDF is normalized to one. +The mean value is +$$ +\begin{equation*} +\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{equation*} +$$ + +resulting in +$$ +\begin{equation*} +\mu = +\sum_{x=0}^n x\frac{(n-1)!}{(x-1)!(n-1-(x-1))!}y^{x-1}(1-y)^{n-1-(x-1)}, +\end{equation*} +$$ + +which we rewrite as + +$$ +\begin{equation*} +\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{equation*} +$$ +

    +
    + +The variance is slightly trickier to get. It reads \( \sigma^2=ny(1-y) \). + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs023.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs023.html new file mode 100644 index 000000000..227d0f892 --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs023.html @@ -0,0 +1,470 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

    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 +$$ +\begin{equation*} + p(x) = \frac{\lambda^x}{x!} e^{-\lambda} \hspace{0.5cm}x=0,1,\dots,;\lambda > 0. +\end{equation*} +$$ + +In this case both the mean value and the variance are easier to calculate, + +$$ +\begin{equation*} +\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, +\end{equation*} +$$ + +and the variance is \( \sigma^2=\lambda \). +

    +
    + + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs024.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs024.html new file mode 100644 index 000000000..943f87af2 --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs024.html @@ -0,0 +1,461 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

    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{equation*} +\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{equation*} +$$ +

    +
    + + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs025.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs025.html new file mode 100644 index 000000000..20c4a05b3 --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs025.html @@ -0,0 +1,474 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

    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{align} +\mathrm{Cov}(X_i,\,X_j) & = \langle (x_i-\langle x_i\rangle)(x_j-\langle x_j\rangle)\rangle +\tag{4}\\ +&=\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, +\tag{5} +\end{align} +$$ + +with +$$ +\begin{equation*} +\langle x_i\rangle = +\int\cdots\int x_i P(x_1,\dots,x_n)\,dx_1\dots dx_n. +\end{equation*} +$$ +

    +
    + + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs026.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs026.html new file mode 100644 index 000000000..4a7c16ac0 --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs026.html @@ -0,0 +1,459 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

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

    +
    + + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs027.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs027.html new file mode 100644 index 000000000..a6aa0d49f --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs027.html @@ -0,0 +1,471 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

    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)
    +
    +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs028.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs028.html new file mode 100644 index 000000000..bf3b367d1 --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs028.html @@ -0,0 +1,474 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

    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). +$$ +

    +
    + + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs029.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs029.html new file mode 100644 index 000000000..ba252212b --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs029.html @@ -0,0 +1,466 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

    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 +$$ +\begin{equation*} +\{x_1, x_2,\dots\,x_k,\dots\}. +\end{equation*} +$$ +

    +
    + + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs030.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs030.html new file mode 100644 index 000000000..0e5275d29 --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs030.html @@ -0,0 +1,462 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

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

    +
    + + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs031.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs031.html new file mode 100644 index 000000000..15fbe4d90 --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs031.html @@ -0,0 +1,466 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

    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 +$$ +\begin{equation*} +\langle x_{\alpha} \rangle \equiv \frac{1}{n}\sum_{k=1}^n x_{\alpha,k}. +\end{equation*} +$$ + +The sample variance is: +$$ +\begin{equation*} +\mathrm{Var}(x) \equiv \frac{1}{n}\sum_{k=1}^n (x_{\alpha,k} - \langle x_{\alpha} \rangle)^2, +\end{equation*} +$$ + +with its square root being the standard deviation of the sample. +

    +
    + + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs032.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs032.html new file mode 100644 index 000000000..6458219d7 --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs032.html @@ -0,0 +1,475 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

    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}, +\tag{6} +\end{equation} +$$ + +where the last sums end at \( m \) and \( n \). +The total variance is +$$ +\begin{equation*} +\sigma^2_m= \frac{1}{mn^2}\sum_{\alpha=1}^m(\langle x_{\alpha} \rangle-\langle X_m \rangle)^2, +\end{equation*} +$$ + +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). +\tag{7} +\end{equation} +$$ +

    +
    + + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs033.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs033.html new file mode 100644 index 000000000..415d13433 --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs033.html @@ -0,0 +1,466 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

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

    +
    + + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs034.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs034.html new file mode 100644 index 000000000..7b0430c01 --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs034.html @@ -0,0 +1,470 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

    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 +$$ +\begin{equation*} + \sigma_m= +\frac{\sigma}{\sqrt{m}}. +\end{equation*} +$$ + +

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

    +
    + + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs035.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs035.html new file mode 100644 index 000000000..7dcbd5e35 --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs035.html @@ -0,0 +1,475 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

    Definition of Correlation Functions and Standard Deviation

    +
    +
    +

    +Our estimate of the true average \( \mu_{X} \) is the sample mean \( \langle X_m \rangle \) + +$$ +\begin{equation*} +\mu_{X}^{\phantom X} \approx X_m=\frac{1}{mn}\sum_{\alpha=1}^m\sum_{k=1}^n x_{\alpha,k}. +\end{equation*} +$$ + +

    +We can then use Eq. (7) +$$ +\begin{equation*} +\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), +\end{equation*} +$$ + +and rewrite it as +$$ +\begin{equation*} +\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), +\end{equation*} +$$ + +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 \). +

    +
    + + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs036.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs036.html new file mode 100644 index 000000000..6deca0bf6 --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs036.html @@ -0,0 +1,464 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

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

    +
    + + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs037.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs037.html new file mode 100644 index 000000000..70202f676 --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs037.html @@ -0,0 +1,470 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

    Definition of Correlation Functions and Standard Deviation

    +
    +
    +

    + +

    +Let us analyze the problem by splitting up the correlation term into +partial sums of the form + +$$ +\begin{equation*} +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), +\end{equation*} +$$ + +The correlation term of the total variance can now be rewritten in terms of +\( f_d \) + +$$ +\begin{equation*} +\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 +\end{equation*} +$$ +

    +
    + + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs038.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs038.html new file mode 100644 index 000000000..09e6410da --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs038.html @@ -0,0 +1,464 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

    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} +\tag{9} +\end{equation} +$$ + +which gives us a useful measure of the correlation pair correlation +starting always at \( 1 \) for \( d=0 \). +

    +
    + + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs039.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs039.html new file mode 100644 index 000000000..9ce4ea2f1 --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs039.html @@ -0,0 +1,479 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

    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 +\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 +\tag{11} +\end{equation} +$$ + + + +For a correlation free experiment, \( \tau \) +equals 1. +

    +
    + + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs040.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs040.html new file mode 100644 index 000000000..1b3df2c96 --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs040.html @@ -0,0 +1,468 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

    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 +$$ +\begin{equation*} +n_\mathrm{eff} = \frac{n}{\tau} +\end{equation*} +$$ + +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. + +

    +
    + + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs041.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs041.html new file mode 100644 index 000000000..ad27911b5 --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs041.html @@ -0,0 +1,484 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

    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)
    +
    +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs042.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs042.html new file mode 100644 index 000000000..f5084cc1d --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs042.html @@ -0,0 +1,462 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

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

    +
    + + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs043.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs043.html new file mode 100644 index 000000000..824a26213 --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs043.html @@ -0,0 +1,465 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

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

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs044.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs044.html new file mode 100644 index 000000000..0e6f21fbf --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs044.html @@ -0,0 +1,474 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

    Random number generator RNG

    +
    +
    +

    + The most common random number generators are based on so-called +Linear congruential relations of the type + +$$ +\begin{equation*} + N_i=(aN_{i-1}+c) \mathrm{MOD} (M), +\end{equation*} +$$ + +which yield a number in the interval [0,1] through + +$$ +\begin{equation*} + x_i=N_i/M +\end{equation*} +$$ + +

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

    +
    + + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs045.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs045.html new file mode 100644 index 000000000..5d5ac9608 --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs045.html @@ -0,0 +1,479 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

    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 + +$$ +\begin{equation*} + N_i=(6N_{i-1}+7) \mathrm{MOD} (5), +\end{equation*} +$$ + +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 + +$$ +\begin{equation*} + N_i=(27N_{i-1}+11) \mathrm{MOD} (54), +\end{equation*} +$$ + +which still, with \( N_0=2 \), results in \( 11,38,11,38,11,38,\dots \), a period of +just \( 2 \). +

    +
    + + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs046.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs046.html new file mode 100644 index 000000000..b43dcdf3f --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs046.html @@ -0,0 +1,463 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

    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 \), +$$ +\begin{equation*} + N_l=(aN_{l-i}+cN_{l-j})\mathrm{MOD}(M). +\end{equation*} +$$ +

    +
    + + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs047.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs047.html new file mode 100644 index 000000000..07d423a62 --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs047.html @@ -0,0 +1,473 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

    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), +\tag{12} +\end{equation} +$$ + +followed by +$$ +\begin{equation} + N_l=(69069N_{l-1}+1013904243)\mathrm{MOD}(2^{32}), +\tag{13} +\end{equation} +$$ + +which according to the authors has a period larger than \( 2^{94} \). +

    +
    + + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs048.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs048.html new file mode 100644 index 000000000..0132b83a4 --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs048.html @@ -0,0 +1,470 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

    Random number generator RNG, other examples

    +
    +
    +

    +Instead of using modular addition, we could use the bitwise +exclusive-OR (\( \oplus \)) operation so that + +$$ +\begin{equation*} + N_l=(N_{l-i})\oplus (N_{l-j}) +\end{equation*} +$$ + +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 \). +

    +
    + + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs049.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs049.html new file mode 100644 index 000000000..8ed9d7495 --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs049.html @@ -0,0 +1,486 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

    Random number generator RNG, RAN0

    +
    +
    +

    + +

    +We show here how the linear congruential algorithm can be implemented, namely +$$ +\begin{equation*} + N_i=(aN_{i-1}) \mathrm{MOD} (M). +\end{equation*} +$$ + +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 +$$ +\begin{equation*} + M=aq+r, +\end{equation*} +$$ + +where we have defined + +$$ +\begin{equation*} + q=[M/a], +\end{equation*} +$$ + +and +$$ +\begin{equation*} + r = M\hspace{0.1cm}\mathrm{MOD} \hspace{0.1cm}a. +\end{equation*} +$$ + +where the brackets denote integer division. In the code below the numbers +\( q \) and \( r \) are chosen so that \( r < q \). +

    +
    + + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs050.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs050.html new file mode 100644 index 000000000..66733c640 --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs050.html @@ -0,0 +1,463 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

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

    +
    + + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs051.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs051.html new file mode 100644 index 000000000..899eb130a --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs051.html @@ -0,0 +1,476 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

    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), +\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), +\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). +\tag{17} +\end{equation} +$$ +

    +
    + + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs052.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs052.html new file mode 100644 index 000000000..e8abc5e67 --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs052.html @@ -0,0 +1,462 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

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

    +
    + + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs053.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs053.html new file mode 100644 index 000000000..27f011b77 --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs053.html @@ -0,0 +1,482 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

    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() 
    +
    +

    +

    +
    + + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs054.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs054.html new file mode 100644 index 000000000..14cfff1be --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs054.html @@ -0,0 +1,467 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

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

    +
    + + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs055.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs055.html new file mode 100644 index 000000000..b03b7daa1 --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs055.html @@ -0,0 +1,465 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

    Properties of Selected Random Number Generators

    +
    +
    +

    +For the uniform distribution, the mean value \( \mu \) is then + +$$ +\begin{equation*} + \mu=\langle x\rangle=\frac{1}{2} +\end{equation*} +$$ + +while the standard deviation is + +$$ +\begin{equation*} + \sigma=\sqrt{\langle x^2\rangle-\mu^2}=\frac{1}{\sqrt{12}}=0.2886. +\end{equation*} +$$ +

    +
    + + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs056.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs056.html new file mode 100644 index 000000000..a0f3a0722 --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs056.html @@ -0,0 +1,479 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

    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
    +
    +
    +

    +

    +
    + + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs057.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs057.html new file mode 100644 index 000000000..0d70f9a89 --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs057.html @@ -0,0 +1,480 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

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

    + + +

    +

    +

    +
    + + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs058.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs058.html new file mode 100644 index 000000000..001e1c29b --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs058.html @@ -0,0 +1,477 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

    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 +$$ +\begin{equation*} + C_k=\frac{f_d} + {\sigma^2}, +\end{equation*} +$$ + +with \( C_0=1 \). Recall that +\( \sigma^2=\langle x_i^2\rangle-\langle x_i\rangle^2 \) and that +$$ +\begin{equation*} +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), +\end{equation*} +$$ + +

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

    +

    +
    + + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs059.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs059.html new file mode 100644 index 000000000..d22bacd1b --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs059.html @@ -0,0 +1,481 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

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

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs060.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs060.html new file mode 100644 index 000000000..e5aa51926 --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs060.html @@ -0,0 +1,522 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

    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 
    +
    +

    +

    +
    + + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs061.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs061.html new file mode 100644 index 000000000..6e658d2d1 --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs061.html @@ -0,0 +1,455 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

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

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs062.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs062.html new file mode 100644 index 000000000..081c078f4 --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs062.html @@ -0,0 +1,469 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

    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);
    +
    +

    +

    +
    + + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs063.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs063.html new file mode 100644 index 000000000..a2c75d542 --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs063.html @@ -0,0 +1,460 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

    Why blocking?

    +
    +
    +

    + +

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

    +

    +
    + + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs064.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs064.html new file mode 100644 index 000000000..8acd0206d --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs064.html @@ -0,0 +1,462 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

    Why blocking?

    +
    +
    +

    + +

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

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs065.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs065.html new file mode 100644 index 000000000..023d19b7f --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs065.html @@ -0,0 +1,527 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

    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 
    +
    +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs066.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs066.html new file mode 100644 index 000000000..d4b3b1a0e --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs066.html @@ -0,0 +1,468 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

    What is 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 +
    +
    + + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs067.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs067.html new file mode 100644 index 000000000..3d0f6e9b3 --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs067.html @@ -0,0 +1,456 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

    What is 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
    • +
    +
    +
    + + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs068.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs068.html new file mode 100644 index 000000000..2792b3b96 --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs068.html @@ -0,0 +1,453 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

    What is 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
    • +
    +
    +
    + + +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs069.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs069.html new file mode 100644 index 000000000..f8319083d --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs069.html @@ -0,0 +1,456 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

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

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs070.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs070.html new file mode 100644 index 000000000..d914e1b7e --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs070.html @@ -0,0 +1,473 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data 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 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)
    +
    +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs071.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs071.html new file mode 100644 index 000000000..516a96cf8 --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs071.html @@ -0,0 +1,452 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

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

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs072.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs072.html new file mode 100644 index 000000000..f980431b5 --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs072.html @@ -0,0 +1,442 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

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

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs073.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs073.html new file mode 100644 index 000000000..b9535c5e6 --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs073.html @@ -0,0 +1,454 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

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

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs074.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs074.html new file mode 100644 index 000000000..195fb4a78 --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs074.html @@ -0,0 +1,446 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

    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)
    +
    +

    +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/._Statistics.do.txt-bs075.html b/doc/pub/Statistics/html/._Statistics.do.txt-bs075.html new file mode 100644 index 000000000..c7ca893d8 --- /dev/null +++ b/doc/pub/Statistics/html/._Statistics.do.txt-bs075.html @@ -0,0 +1,445 @@ + + + + + + + + +Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
    + +

     

     

     

    + + + + +

    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)
    +
    +

    + +

    + +

    + + +
    + + + + + + + +
    + +
    + + + + + + diff --git a/doc/pub/Statistics/html/Statistics-bs.html b/doc/pub/Statistics/html/Statistics-bs.html index 0383be408..ff6dac9b0 100644 --- a/doc/pub/Statistics/html/Statistics-bs.html +++ b/doc/pub/Statistics/html/Statistics-bs.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -55,43 +56,40 @@ $(function () { @@ -296,80 +298,81 @@ MathJax.Hub.Config({ @@ -404,7 +407,7 @@ MathJax.Hub.Config({
    [2] Department of Physics and Astronomy and National Superconducting Cyclotron Laboratory, Michigan State University

    -

    Aug 27, 2018

    +

    Sep 20, 2020


    @@ -428,7 +431,7 @@ MathJax.Hub.Config({

  • 9
  • 10
  • ...
  • -
  • 75
  • +
  • 76
  • »
  • @@ -446,7 +449,7 @@ MathJax.Hub.Config({
    - © 1999-2018, Morten Hjorth-Jensen. Released under CC Attribution-NonCommercial 4.0 license + © 1999-2020, Morten Hjorth-Jensen. Released under CC Attribution-NonCommercial 4.0 license
    diff --git a/doc/pub/Statistics/html/Statistics-reveal.html b/doc/pub/Statistics/html/Statistics-reveal.html index b28db8abf..6b9ebfaee 100644 --- a/doc/pub/Statistics/html/Statistics-reveal.html +++ b/doc/pub/Statistics/html/Statistics-reveal.html @@ -1,8 +1,8 @@ -\ + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -163,18 +163,29 @@ MathJax.Hub.Config({
    [2] Department of Physics and Astronomy and National Superconducting Cyclotron Laboratory, Michigan State University

     
    -

    Aug 27, 2018

    +

    Sep 20, 2020


    - © 1999-2018, Morten Hjorth-Jensen. Released under CC Attribution-NonCommercial 4.0 license + © 1999-2020, Morten Hjorth-Jensen. Released under CC Attribution-NonCommercial 4.0 license
    -

    Domains and probabilities

    +

    To do list

    + +
      +

    • add math about MVN and define MLE and other quantities
    • +

    • rewrite about covariance matrix
    • +

    • add KL theorem
    • +
    +
    + + +
    +

    Domains and probabilities

    @@ -201,7 +212,7 @@ $$

    -

    Tossing the dice

    +

    Tossing the dice

    @@ -237,7 +248,7 @@ $$

    -

    Stochastic variables

    +

    Stochastic variables

    @@ -247,7 +258,7 @@ $$

    -

    Stochastic variables and the main concepts, the discrete case

    +

    Stochastic variables and the main concepts, the discrete case

    @@ -274,7 +285,7 @@ $$

    -

    Stochastic variables and the main concepts, the continuous case

    +

    Stochastic variables and the main concepts, the continuous case

    @@ -302,7 +313,7 @@ selection of a large set of these numbers reproduces this PDF.

    -

    The cumulative probability

    +

    The cumulative probability

    @@ -332,7 +343,7 @@ $$

    -

    Properties of PDFs

    +

    Properties of PDFs

    @@ -365,7 +376,7 @@ $$

    -

    Important distributions, the uniform distribution

    +

    Important distributions, the uniform distribution

    @@ -395,7 +406,7 @@ The latter distribution is used to generate random numbers. For other PDFs, one

    -

    Gaussian distribution

    +

    Gaussian distribution

    @@ -468,7 +479,7 @@ plt.show()

    -

    Exponential distribution

    +

    Exponential distribution

    @@ -485,7 +496,7 @@ $$

    -

    Expectation values

    +

    Expectation values

    @@ -519,7 +530,7 @@ $$

    -

    Stochastic variables and the main concepts, mean values

    +

    Stochastic variables and the main concepts, mean values

    @@ -551,7 +562,7 @@ PDF and is therefore simply called the expectation value of \( p(x) \).

    -

    Stochastic variables and the main concepts, central moments, the variance

    +

    Stochastic variables and the main concepts, central moments, the variance

    @@ -589,7 +600,7 @@ qualitatively as the "spread" of \( p \) around its mean.

    -

    Probability Distribution Functions

    +

    Probability Distribution Functions

    @@ -618,7 +629,7 @@ while \( P(x) \) is the cumulative probability.

    -

    Probability Distribution Functions

    +

    Probability Distribution Functions

    @@ -649,7 +660,7 @@ and the variance \( \sigma^2 \).

    -

    The three famous Probability Distribution Functions

    +

    The three famous Probability Distribution Functions

    @@ -700,7 +711,7 @@ $$

    -

    Probability Distribution Functions, the normal distribution

    +

    Probability Distribution Functions, the normal distribution

    @@ -738,7 +749,7 @@ $$

    -

    Probability Distribution Functions, the normal distribution

    +

    Probability Distribution Functions, the normal distribution

    @@ -779,7 +790,7 @@ $$

    -

    Probability Distribution Functions, the cumulative distribution

    +

    Probability Distribution Functions, the cumulative distribution

    @@ -801,7 +812,7 @@ which is difficult to evaluate in a quick way.

    -

    Probability Distribution Functions, other important distribution

    +

    Probability Distribution Functions, other important distribution

    @@ -833,7 +844,7 @@ The sequence of binomial trials is characterized by the following definitions

    -

    Probability Distribution Functions, the binomial distribution

    +

    Probability Distribution Functions, the binomial distribution

    @@ -894,7 +905,7 @@ The variance is slightly trickier to get. It reads \( \sigma^2=ny(1-y) \).

    -

    Probability Distribution Functions, Poisson's distribution

    +

    Probability Distribution Functions, Poisson's distribution

    @@ -925,7 +936,7 @@ and the variance is \( \sigma^2=\lambda \).

    -

    Probability Distribution Functions, Poisson's distribution

    +

    Probability Distribution Functions, Poisson's distribution

    @@ -947,7 +958,7 @@ $$

    -

    Meet the covariance!

    +

    Meet the covariance!

    @@ -984,7 +995,7 @@ $$

    -

    Meet the covariance in matrix disguise

    +

    Meet the covariance in matrix disguise

    @@ -1004,7 +1015,7 @@ uncorrelated.

    -

    Covariance

    +

    Covariance

    @@ -1027,17 +1038,17 @@ n = 10 x=np.random.normal(size=n) y = 4+3*x+np.random.normal(size=n) covxy = covariance(x,y,n) -print(covxy) +print(covxy) z = np.vstack((x, y)) c = np.cov(z.T) -print(c) +print(c)

    -

    Meet the covariance, uncorrelated events

    +

    Meet the covariance, uncorrelated events

    @@ -1074,7 +1085,7 @@ $$

    -

    Numerical experiments and the covariance

    +

    Numerical experiments and the covariance

    @@ -1099,7 +1110,7 @@ $$

    -

    Numerical experiments and the covariance

    +

    Numerical experiments and the covariance

    @@ -1120,7 +1131,7 @@ interested in finding the few lowest moments, like the mean

    -

    Numerical experiments and the covariance, actual situations

    +

    Numerical experiments and the covariance, actual situations

    @@ -1149,7 +1160,7 @@ with its square root being the standard deviation of the sample.

    -

    Numerical experiments and the covariance, our observables

    +

    Numerical experiments and the covariance, our observables

    @@ -1189,7 +1200,7 @@ $$

    -

    Numerical experiments and the covariance, the sample variance

    +

    Numerical experiments and the covariance, the sample variance

    @@ -1214,7 +1225,7 @@ and the covariance \( \mathrm{Cov}(X,Y) \).

    -

    Numerical experiments and the covariance, central limit theorem

    +

    Numerical experiments and the covariance, central limit theorem

    @@ -1243,7 +1254,7 @@ In many cases the above estimate for the standard deviation, in particular if co

    -

    Definition of Correlation Functions and Standard Deviation

    +

    Definition of Correlation Functions and Standard Deviation

    @@ -1283,7 +1294,7 @@ and the last term is nothing but the covariance which arises when \( k\ne l \).

    -

    Definition of Correlation Functions and Standard Deviation

    +

    Definition of Correlation Functions and Standard Deviation

    @@ -1306,7 +1317,7 @@ have to be stored throughout the experiment.

    -

    Definition of Correlation Functions and Standard Deviation

    +

    Definition of Correlation Functions and Standard Deviation

    @@ -1337,7 +1348,7 @@ $$

    -

    Definition of Correlation Functions and Standard Deviation

    +

    Definition of Correlation Functions and Standard Deviation

    @@ -1362,7 +1373,7 @@ starting always at \( 1 \) for \( d=0 \).

    -

    Definition of Correlation Functions and Standard Deviation, sample variance

    +

    Definition of Correlation Functions and Standard Deviation, sample variance

    @@ -1402,7 +1413,7 @@ equals 1.

    -

    Definition of Correlation Functions and Standard Deviation

    +

    Definition of Correlation Functions and Standard Deviation

    @@ -1431,7 +1442,7 @@ more practically oriented methods like the blocking technique.

    -

    Code to compute the Covariance matrix and the Covariance

    +

    Code to compute the Covariance matrix and the Covariance

    @@ -1452,32 +1463,32 @@ more practically oriented methods like the blocking technique. n = 100 x = np.random.normal(size=n) -print(np.mean(x)) +print(np.mean(x)) y = 4+3*x+np.random.normal(size=n) -print(np.mean(y)) +print(np.mean(y)) z = x**3+np.random.normal(size=n) -print(np.mean(z)) +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) +print(covxx,covyy, covzz) +print(covxy,covxz, covyz) w = np.vstack((x, y, z)) #print(w) c = np.cov(w) -print(c) +print(c) #eigen = np.zeros(n) Eigvals, Eigvecs = np.linalg.eig(c) -print(Eigvals) +print(Eigvals)

    -

    Random Numbers

    +

    Random Numbers

    @@ -1496,7 +1507,7 @@ or Monte Carlo computer work.

    -

    Random Numbers, better name: pseudo random numbers

    +

    Random Numbers, better name: pseudo random numbers

    @@ -1522,7 +1533,7 @@ numbers, hopefully abiding to the following criteria:

    -

    Random number generator RNG

    +

    Random number generator RNG

    @@ -1559,7 +1570,7 @@ of the division \( 13/9 \), namely \( 4 \).

    -

    Random number generator RNG and periodic outputs

    +

    Random number generator RNG and periodic outputs

    @@ -1599,7 +1610,7 @@ just \( 2 \).

    -

    Random number generator RNG and its period

    +

    Random number generator RNG and its period

    @@ -1623,7 +1634,7 @@ $$

    -

    Random number generator RNG, other examples

    +

    Random number generator RNG, other examples

    @@ -1659,7 +1670,7 @@ which according to the authors has a period larger than \( 2^{94} \).

    -

    Random number generator RNG, other examples

    +

    Random number generator RNG, other examples

    @@ -1690,7 +1701,7 @@ it is given by \( m\wedge n \).

    -

    Random number generator RNG, RAN0

    +

    Random number generator RNG, RAN0

    @@ -1741,7 +1752,7 @@ where the brackets denote integer division. In the code below the numbers

    -

    Random number generator RNG, RAN0

    +

    Random number generator RNG, RAN0

    @@ -1763,7 +1774,7 @@ The last term \( [N_{i-1}/q]M\mathrm{MOD}(M) \) is zero since the integer divisi

    -

    Random number generator RNG, RAN0

    +

    Random number generator RNG, RAN0

    @@ -1804,7 +1815,7 @@ $$

    -

    Random number generator RNG, RAN0

    +

    Random number generator RNG, RAN0

    @@ -1825,7 +1836,7 @@ set to \( 0 \).

    -

    Random number generator RNG, RAN0 code

    +

    Random number generator RNG, RAN0 code

    @@ -1864,7 +1875,7 @@ set to \( 0 \).

    -

    Properties of Selected Random Number Generators

    +

    Properties of Selected Random Number Generators

    @@ -1888,7 +1899,7 @@ Two additional measures are the standard deviation \( \sigma \) and the mean

    -

    Properties of Selected Random Number Generators

    +

    Properties of Selected Random Number Generators

    @@ -1916,7 +1927,7 @@ $$

    -

    Properties of Selected Random Number Generators

    +

    Properties of Selected Random Number Generators

    @@ -1949,7 +1960,7 @@ these limiting values.

    -

    Simple demonstration of RNGs using python

    +

    Simple demonstration of RNGs using python

    @@ -1988,7 +1999,7 @@ plt.show()

    -

    Properties of Selected Random Number Generators

    +

    Properties of Selected Random Number Generators

    @@ -2028,7 +2039,7 @@ assumption for approximating \( \sigma_N \) is no longer valid.

    -

    Autocorrelation function

    +

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

    @@ -2051,7 +2062,7 @@ autocor = np.zeros(n) figaxis = np.zeros(n) mean_x=np.mean(x) var_x = np.var(x) -print(mean_x, 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 @@ -2070,7 +2081,7 @@ For the remaining values we notice that there are still non-zero values for the

    -

    Correlation function and which random number generators should I use

    +

    Correlation function and which random number generators should I use

    @@ -2151,7 +2162,7 @@ ofstream ofile;

    -

    Which RNG should I use?

    +

    Which RNG should I use?

      @@ -2163,7 +2174,7 @@ ofstream ofile;
      -

      How to use the Mersenne generator

      +

      How to use the Mersenne generator

      @@ -2191,7 +2202,7 @@ The following part of a c++ code (from project 4) sets up the uniform distributi

      -

      Why blocking?

      +

      Why blocking?

      Statistical analysis.
        @@ -2212,7 +2223,7 @@ A very good article which explains blocking is H. Flyvbjerg and H. G. Petersen,
        -

        Why blocking?

        +

        Why blocking?

        Statistical analysis.
          @@ -2234,7 +2245,7 @@ A very good article which explains blocking is H. Flyvbjerg and H. G. Petersen,
          -

          Code to demonstrate the calculation of the autocorrelation function

          +

          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. @@ -2323,7 +2334,7 @@ ofstream ofile;
          -

          What is blocking?

          +

          What is blocking?

          Blocking.
            @@ -2355,7 +2366,7 @@ $$
            -

            What is blocking?

            +

            What is blocking?

            Blocking.
              @@ -2377,7 +2388,7 @@ $$
              -

              What is blocking?

              +

              What is blocking?

              Blocking.
                @@ -2395,7 +2406,7 @@ $$
                -

                Implementation

                +

                Implementation

                  @@ -2420,7 +2431,7 @@ $$
                  -

                  Actual implementation with code, main function

                  +

                  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.

                  @@ -2461,7 +2472,7 @@ The The Bootstrap method +

                  The Bootstrap method

                  The Bootstrap resampling method is also very popular. It is very simple: @@ -2482,7 +2493,7 @@ This method is very useful for small ensembles of data points.

                  -

                  Bootstrapping

                  +

                  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 @@ -2493,7 +2504,7 @@ This costs essentially nothing, since we just recycle the original data set for
                  -

                  Bootstrapping, recipe

                  +

                  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 @@ -2521,7 +2532,7 @@ the true \( \angle\theta\rangle \). As final result for the observable one quote
                  -

                  Bootstrapping, code

                  +

                  Bootstrapping, code

                  @@ -2539,7 +2550,7 @@ the true \( \angle\theta\rangle \). As final result for the observable one quote

                  -

                  Jackknife, code

                  +

                  Jackknife, code

                  diff --git a/doc/pub/Statistics/html/Statistics-solarized.html b/doc/pub/Statistics/html/Statistics-solarized.html index e53be939f..d6af08719 100644 --- a/doc/pub/Statistics/html/Statistics-solarized.html +++ b/doc/pub/Statistics/html/Statistics-solarized.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -75,43 +76,40 @@ $(function () { @@ -320,12 +322,22 @@ MathJax.Hub.Config({

                  [2] Department of Physics and Astronomy and National Superconducting Cyclotron Laboratory, Michigan State University

                  -

                  Aug 27, 2018

                  +

                  Sep 20, 2020












                  -

                  Domains and probabilities

                  +

                  To do list

                  + +
                    +
                  • add math about MVN and define MLE and other quantities
                  • +
                  • rewrite about covariance matrix
                  • +
                  • add KL theorem
                  • +
                  + +









                  + +

                  Domains and probabilities

                  @@ -349,7 +361,7 @@ $$











                  -

                  Tossing the dice

                  +

                  Tossing the dice

                  @@ -382,7 +394,7 @@ $$











                  -

                  Stochastic variables

                  +

                  Stochastic variables

                  @@ -395,7 +407,7 @@ $$











                  -

                  Stochastic variables and the main concepts, the discrete case

                  +

                  Stochastic variables and the main concepts, the discrete case

                  @@ -421,7 +433,7 @@ $$











                  -

                  Stochastic variables and the main concepts, the continuous case

                  +

                  Stochastic variables and the main concepts, the continuous case

                  @@ -448,7 +460,7 @@ selection of a large set of these numbers reproduces this PDF.











                  -

                  The cumulative probability

                  +

                  The cumulative probability

                  @@ -475,7 +487,7 @@ $$











                  -

                  Properties of PDFs

                  +

                  Properties of PDFs

                  @@ -507,7 +519,7 @@ $$











                  -

                  Important distributions, the uniform distribution

                  +

                  Important distributions, the uniform distribution

                  @@ -534,7 +546,7 @@ The latter distribution is used to generate random numbers. For other PDFs, one











                  -

                  Gaussian distribution

                  +

                  Gaussian distribution

                  @@ -604,7 +616,7 @@ plt.show()











                  -

                  Exponential distribution

                  +

                  Exponential distribution

                  @@ -620,7 +632,7 @@ $$











                  -

                  Expectation values

                  +

                  Expectation values

                  @@ -651,7 +663,7 @@ $$











                  -

                  Stochastic variables and the main concepts, mean values

                  +

                  Stochastic variables and the main concepts, mean values

                  @@ -680,7 +692,7 @@ PDF and is therefore simply called the expectation value of \( p(x) \).











                  -

                  Stochastic variables and the main concepts, central moments, the variance

                  +

                  Stochastic variables and the main concepts, central moments, the variance

                  @@ -717,7 +729,7 @@ qualitatively as the "spread" of \( p \) around its mean.











                  -

                  Probability Distribution Functions

                  +

                  Probability Distribution Functions

                  @@ -749,7 +761,7 @@ while \( P(x) \) is the cumulative probability.











                  -

                  Probability Distribution Functions

                  +

                  Probability Distribution Functions

                  @@ -777,7 +789,7 @@ and the variance \( \sigma^2 \).











                  -

                  The three famous Probability Distribution Functions

                  +

                  The three famous Probability Distribution Functions

                  @@ -821,7 +833,7 @@ $$











                  -

                  Probability Distribution Functions, the normal distribution

                  +

                  Probability Distribution Functions, the normal distribution

                  @@ -854,7 +866,7 @@ $$











                  -

                  Probability Distribution Functions, the normal distribution

                  +

                  Probability Distribution Functions, the normal distribution

                  @@ -890,7 +902,7 @@ $$











                  -

                  Probability Distribution Functions, the cumulative distribution

                  +

                  Probability Distribution Functions, the cumulative distribution

                  @@ -913,7 +925,7 @@ which is difficult to evaluate in a quick way.











                  -

                  Probability Distribution Functions, other important distribution

                  +

                  Probability Distribution Functions, other important distribution

                  @@ -943,7 +955,7 @@ The sequence of binomial trials is characterized by the following definitions











                  -

                  Probability Distribution Functions, the binomial distribution

                  +

                  Probability Distribution Functions, the binomial distribution

                  @@ -996,7 +1008,7 @@ The variance is slightly trickier to get. It reads \( \sigma^2=ny(1-y) \).











                  -

                  Probability Distribution Functions, Poisson's distribution

                  +

                  Probability Distribution Functions, Poisson's distribution

                  @@ -1026,7 +1038,7 @@ and the variance is \( \sigma^2=\lambda \).











                  -

                  Probability Distribution Functions, Poisson's distribution

                  +

                  Probability Distribution Functions, Poisson's distribution

                  @@ -1047,7 +1059,7 @@ $$











                  -

                  Meet the covariance!

                  +

                  Meet the covariance!

                  @@ -1081,7 +1093,7 @@ $$











                  -

                  Meet the covariance in matrix disguise

                  +

                  Meet the covariance in matrix disguise

                  @@ -1100,7 +1112,7 @@ uncorrelated.











                  -

                  Covariance

                  +

                  Covariance

                  @@ -1123,16 +1135,16 @@ n = 10 x=np.random.normal(size=n) y = 4+3*x+np.random.normal(size=n) covxy = covariance(x,y,n) -print(covxy) +print(covxy) z = np.vstack((x, y)) c = np.cov(z.T) -print(c) +print(c)











                  -

                  Meet the covariance, uncorrelated events

                  +

                  Meet the covariance, uncorrelated events

                  @@ -1166,7 +1178,7 @@ $$











                  -

                  Numerical experiments and the covariance

                  +

                  Numerical experiments and the covariance

                  @@ -1192,7 +1204,7 @@ $$











                  -

                  Numerical experiments and the covariance

                  +

                  Numerical experiments and the covariance

                  @@ -1214,7 +1226,7 @@ interested in finding the few lowest moments, like the mean











                  -

                  Numerical experiments and the covariance, actual situations

                  +

                  Numerical experiments and the covariance, actual situations

                  @@ -1240,7 +1252,7 @@ with its square root being the standard deviation of the sample.











                  -

                  Numerical experiments and the covariance, our observables

                  +

                  Numerical experiments and the covariance, our observables

                  @@ -1275,7 +1287,7 @@ $$











                  -

                  Numerical experiments and the covariance, the sample variance

                  +

                  Numerical experiments and the covariance, the sample variance

                  @@ -1301,7 +1313,7 @@ and the covariance \( \mathrm{Cov}(X,Y) \).











                  -

                  Numerical experiments and the covariance, central limit theorem

                  +

                  Numerical experiments and the covariance, central limit theorem

                  @@ -1331,7 +1343,7 @@ In many cases the above estimate for the standard deviation, in particular if co











                  -

                  Definition of Correlation Functions and Standard Deviation

                  +

                  Definition of Correlation Functions and Standard Deviation

                  @@ -1366,7 +1378,7 @@ and the last term is nothing but the covariance which arises when \( k\ne l \).











                  -

                  Definition of Correlation Functions and Standard Deviation

                  +

                  Definition of Correlation Functions and Standard Deviation

                  @@ -1390,7 +1402,7 @@ have to be stored throughout the experiment.











                  -

                  Definition of Correlation Functions and Standard Deviation

                  +

                  Definition of Correlation Functions and Standard Deviation

                  @@ -1420,7 +1432,7 @@ $$











                  -

                  Definition of Correlation Functions and Standard Deviation

                  +

                  Definition of Correlation Functions and Standard Deviation

                  @@ -1444,7 +1456,7 @@ starting always at \( 1 \) for \( d=0 \).











                  -

                  Definition of Correlation Functions and Standard Deviation, sample variance

                  +

                  Definition of Correlation Functions and Standard Deviation, sample variance

                  @@ -1483,7 +1495,7 @@ equals 1.











                  -

                  Definition of Correlation Functions and Standard Deviation

                  +

                  Definition of Correlation Functions and Standard Deviation

                  @@ -1511,7 +1523,7 @@ more practically oriented methods like the blocking technique.

                  -

                  Code to compute the Covariance matrix and the Covariance

                  +

                  Code to compute the Covariance matrix and the Covariance

                  @@ -1532,31 +1544,31 @@ more practically oriented methods like the blocking technique. n = 100 x = np.random.normal(size=n) -print(np.mean(x)) +print(np.mean(x)) y = 4+3*x+np.random.normal(size=n) -print(np.mean(y)) +print(np.mean(y)) z = x**3+np.random.normal(size=n) -print(np.mean(z)) +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) +print(covxx,covyy, covzz) +print(covxy,covxz, covyz) w = np.vstack((x, y, z)) #print(w) c = np.cov(w) -print(c) +print(c) #eigen = np.zeros(n) Eigvals, Eigvecs = np.linalg.eig(c) -print(Eigvals) +print(Eigvals)











                  -

                  Random Numbers

                  +

                  Random Numbers

                  @@ -1578,7 +1590,7 @@ or Monte Carlo computer work.











                  -

                  Random Numbers, better name: pseudo random numbers

                  +

                  Random Numbers, better name: pseudo random numbers

                  @@ -1603,7 +1615,7 @@ numbers, hopefully abiding to the following criteria:











                  -

                  Random number generator RNG

                  +

                  Random number generator RNG

                  @@ -1637,7 +1649,7 @@ of the division \( 13/9 \), namely \( 4 \).











                  -

                  Random number generator RNG and periodic outputs

                  +

                  Random number generator RNG and periodic outputs

                  @@ -1676,7 +1688,7 @@ just \( 2 \).











                  -

                  Random number generator RNG and its period

                  +

                  Random number generator RNG and its period

                  @@ -1699,7 +1711,7 @@ $$











                  -

                  Random number generator RNG, other examples

                  +

                  Random number generator RNG, other examples

                  @@ -1732,7 +1744,7 @@ which according to the authors has a period larger than \( 2^{94} \).











                  -

                  Random number generator RNG, other examples

                  +

                  Random number generator RNG, other examples

                  @@ -1762,7 +1774,7 @@ it is given by \( m\wedge n \).











                  -

                  Random number generator RNG, RAN0

                  +

                  Random number generator RNG, RAN0

                  @@ -1808,7 +1820,7 @@ where the brackets denote integer division. In the code below the numbers











                  -

                  Random number generator RNG, RAN0

                  +

                  Random number generator RNG, RAN0

                  @@ -1831,7 +1843,7 @@ The last term \( [N_{i-1}/q]M\mathrm{MOD}(M) \) is zero since the integer divisi











                  -

                  Random number generator RNG, RAN0

                  +

                  Random number generator RNG, RAN0

                  @@ -1867,7 +1879,7 @@ $$











                  -

                  Random number generator RNG, RAN0

                  +

                  Random number generator RNG, RAN0

                  @@ -1889,7 +1901,7 @@ set to \( 0 \).











                  -

                  Random number generator RNG, RAN0 code

                  +

                  Random number generator RNG, RAN0 code

                  @@ -1931,7 +1943,7 @@ set to \( 0 \).











                  -

                  Properties of Selected Random Number Generators

                  +

                  Properties of Selected Random Number Generators

                  @@ -1958,7 +1970,7 @@ Two additional measures are the standard deviation \( \sigma \) and the mean











                  -

                  Properties of Selected Random Number Generators

                  +

                  Properties of Selected Random Number Generators

                  @@ -1983,7 +1995,7 @@ $$











                  -

                  Properties of Selected Random Number Generators

                  +

                  Properties of Selected Random Number Generators

                  @@ -2017,7 +2029,7 @@ these limiting values.











                  -

                  Simple demonstration of RNGs using python

                  +

                  Simple demonstration of RNGs using python

                  @@ -2057,7 +2069,7 @@ plt.show()











                  -

                  Properties of Selected Random Number Generators

                  +

                  Properties of Selected Random Number Generators

                  @@ -2094,7 +2106,7 @@ assumption for approximating \( \sigma_N \) is no longer valid.











                  -

                  Autocorrelation function

                  +

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

                  @@ -2117,7 +2129,7 @@ autocor = np.zeros(n) figaxis = np.zeros(n) mean_x=np.mean(x) var_x = np.var(x) -print(mean_x, 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 @@ -2136,7 +2148,7 @@ For the remaining values we notice that there are still non-zero values for the











                  -

                  Correlation function and which random number generators should I use

                  +

                  Correlation function and which random number generators should I use

                  @@ -2218,7 +2230,7 @@ ofstream ofile;











                  -

                  Which RNG should I use?

                  +

                  Which RNG should I use?

                  @@ -2233,7 +2245,7 @@ ofstream ofile;











                  -

                  How to use the Mersenne generator

                  +

                  How to use the Mersenne generator

                  @@ -2262,7 +2274,7 @@ The following part of a c++ code (from project 4) sets up the uniform distributi











                  -

                  Why blocking?

                  +

                  Why blocking?

                  Statistical analysis.

                  @@ -2282,7 +2294,7 @@ A very good article which explains blocking is H. Flyvbjerg and H. G. Petersen,











                  -

                  Why blocking?

                  +

                  Why blocking?

                  Statistical analysis.

                  @@ -2304,7 +2316,7 @@ A very good article which explains blocking is H. Flyvbjerg and H. G. Petersen,











                  -

                  Code to demonstrate the calculation of the autocorrelation function

                  +

                  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. @@ -2392,7 +2404,7 @@ ofstream ofile;











                  -

                  What is blocking?

                  +

                  What is blocking?

                  Blocking.

                  @@ -2422,7 +2434,7 @@ $$











                  -

                  What is blocking?

                  +

                  What is blocking?

                  Blocking.

                  @@ -2441,7 +2453,7 @@ $$











                  -

                  What is blocking?

                  +

                  What is blocking?

                  Blocking.

                  @@ -2458,7 +2470,7 @@ $$











                  -

                  Implementation

                  +

                  Implementation

                  @@ -2479,7 +2491,7 @@ $$











                  -

                  Actual implementation with code, main function

                  +

                  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.

                  @@ -2519,7 +2531,7 @@ The The Bootstrap method +

                  The Bootstrap method

                  The Bootstrap resampling method is also very popular. It is very simple: @@ -2539,7 +2551,7 @@ This method is very useful for small ensembles of data points.

                  -

                  Bootstrapping

                  +

                  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 @@ -2550,7 +2562,7 @@ This costs essentially nothing, since we just recycle the original data set for

                  -

                  Bootstrapping, recipe

                  +

                  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 @@ -2574,7 +2586,7 @@ the true \( \angle\theta\rangle \). As final result for the observable one quote

                  -

                  Bootstrapping, code

                  +

                  Bootstrapping, code

                  @@ -2591,7 +2603,7 @@ the true \( \angle\theta\rangle \). As final result for the observable one quote

                  -

                  Jackknife, code

                  +

                  Jackknife, code

                  @@ -2611,7 +2623,7 @@ the true \( \angle\theta\rangle \). As final result for the observable one quote

                  - © 1999-2018, Morten Hjorth-Jensen. Released under CC Attribution-NonCommercial 4.0 license + © 1999-2020, Morten Hjorth-Jensen. Released under CC Attribution-NonCommercial 4.0 license
                  diff --git a/doc/pub/Statistics/html/Statistics.html b/doc/pub/Statistics/html/Statistics.html index fc5eaf8a3..30b253550 100644 --- a/doc/pub/Statistics/html/Statistics.html +++ b/doc/pub/Statistics/html/Statistics.html @@ -6,6 +6,7 @@ Automatically generated HTML file from DocOnce source + Data Analysis and Machine Learning: Elements of Probability Theory and Statistical Data Analysis @@ -80,43 +81,40 @@ $(function () { @@ -325,12 +327,22 @@ MathJax.Hub.Config({
                  [2] Department of Physics and Astronomy and National Superconducting Cyclotron Laboratory, Michigan State University

                  -

                  Aug 27, 2018

                  +

                  Sep 20, 2020












                  -

                  Domains and probabilities

                  +

                  To do list

                  + +
                    +
                  • add math about MVN and define MLE and other quantities
                  • +
                  • rewrite about covariance matrix
                  • +
                  • add KL theorem
                  • +
                  + +









                  + +

                  Domains and probabilities

                  @@ -354,7 +366,7 @@ $$











                  -

                  Tossing the dice

                  +

                  Tossing the dice

                  @@ -387,7 +399,7 @@ $$











                  -

                  Stochastic variables

                  +

                  Stochastic variables

                  @@ -400,7 +412,7 @@ $$











                  -

                  Stochastic variables and the main concepts, the discrete case

                  +

                  Stochastic variables and the main concepts, the discrete case

                  @@ -426,7 +438,7 @@ $$











                  -

                  Stochastic variables and the main concepts, the continuous case

                  +

                  Stochastic variables and the main concepts, the continuous case

                  @@ -453,7 +465,7 @@ selection of a large set of these numbers reproduces this PDF.











                  -

                  The cumulative probability

                  +

                  The cumulative probability

                  @@ -480,7 +492,7 @@ $$











                  -

                  Properties of PDFs

                  +

                  Properties of PDFs

                  @@ -512,7 +524,7 @@ $$











                  -

                  Important distributions, the uniform distribution

                  +

                  Important distributions, the uniform distribution

                  @@ -539,7 +551,7 @@ The latter distribution is used to generate random numbers. For other PDFs, one











                  -

                  Gaussian distribution

                  +

                  Gaussian distribution

                  @@ -609,7 +621,7 @@ plt.show()











                  -

                  Exponential distribution

                  +

                  Exponential distribution

                  @@ -625,7 +637,7 @@ $$











                  -

                  Expectation values

                  +

                  Expectation values

                  @@ -656,7 +668,7 @@ $$











                  -

                  Stochastic variables and the main concepts, mean values

                  +

                  Stochastic variables and the main concepts, mean values

                  @@ -685,7 +697,7 @@ PDF and is therefore simply called the expectation value of \( p(x) \).











                  -

                  Stochastic variables and the main concepts, central moments, the variance

                  +

                  Stochastic variables and the main concepts, central moments, the variance

                  @@ -722,7 +734,7 @@ qualitatively as the "spread" of \( p \) around its mean.











                  -

                  Probability Distribution Functions

                  +

                  Probability Distribution Functions

                  @@ -754,7 +766,7 @@ while \( P(x) \) is the cumulative probability.











                  -

                  Probability Distribution Functions

                  +

                  Probability Distribution Functions

                  @@ -782,7 +794,7 @@ and the variance \( \sigma^2 \).











                  -

                  The three famous Probability Distribution Functions

                  +

                  The three famous Probability Distribution Functions

                  @@ -826,7 +838,7 @@ $$











                  -

                  Probability Distribution Functions, the normal distribution

                  +

                  Probability Distribution Functions, the normal distribution

                  @@ -859,7 +871,7 @@ $$











                  -

                  Probability Distribution Functions, the normal distribution

                  +

                  Probability Distribution Functions, the normal distribution

                  @@ -895,7 +907,7 @@ $$











                  -

                  Probability Distribution Functions, the cumulative distribution

                  +

                  Probability Distribution Functions, the cumulative distribution

                  @@ -918,7 +930,7 @@ which is difficult to evaluate in a quick way.











                  -

                  Probability Distribution Functions, other important distribution

                  +

                  Probability Distribution Functions, other important distribution

                  @@ -948,7 +960,7 @@ The sequence of binomial trials is characterized by the following definitions











                  -

                  Probability Distribution Functions, the binomial distribution

                  +

                  Probability Distribution Functions, the binomial distribution

                  @@ -1001,7 +1013,7 @@ The variance is slightly trickier to get. It reads \( \sigma^2=ny(1-y) \).











                  -

                  Probability Distribution Functions, Poisson's distribution

                  +

                  Probability Distribution Functions, Poisson's distribution

                  @@ -1031,7 +1043,7 @@ and the variance is \( \sigma^2=\lambda \).











                  -

                  Probability Distribution Functions, Poisson's distribution

                  +

                  Probability Distribution Functions, Poisson's distribution

                  @@ -1052,7 +1064,7 @@ $$











                  -

                  Meet the covariance!

                  +

                  Meet the covariance!

                  @@ -1086,7 +1098,7 @@ $$











                  -

                  Meet the covariance in matrix disguise

                  +

                  Meet the covariance in matrix disguise

                  @@ -1105,7 +1117,7 @@ uncorrelated.











                  -

                  Covariance

                  +

                  Covariance

                  @@ -1128,16 +1140,16 @@ n = 10 x=np.random.normal(size=n) y = 4+3*x+np.random.normal(size=n) covxy = covariance(x,y,n) -print(covxy) +print(covxy) z = np.vstack((x, y)) c = np.cov(z.T) -print(c) +print(c)











                  -

                  Meet the covariance, uncorrelated events

                  +

                  Meet the covariance, uncorrelated events

                  @@ -1171,7 +1183,7 @@ $$











                  -

                  Numerical experiments and the covariance

                  +

                  Numerical experiments and the covariance

                  @@ -1197,7 +1209,7 @@ $$











                  -

                  Numerical experiments and the covariance

                  +

                  Numerical experiments and the covariance

                  @@ -1219,7 +1231,7 @@ interested in finding the few lowest moments, like the mean











                  -

                  Numerical experiments and the covariance, actual situations

                  +

                  Numerical experiments and the covariance, actual situations

                  @@ -1245,7 +1257,7 @@ with its square root being the standard deviation of the sample.











                  -

                  Numerical experiments and the covariance, our observables

                  +

                  Numerical experiments and the covariance, our observables

                  @@ -1280,7 +1292,7 @@ $$











                  -

                  Numerical experiments and the covariance, the sample variance

                  +

                  Numerical experiments and the covariance, the sample variance

                  @@ -1306,7 +1318,7 @@ and the covariance \( \mathrm{Cov}(X,Y) \).











                  -

                  Numerical experiments and the covariance, central limit theorem

                  +

                  Numerical experiments and the covariance, central limit theorem

                  @@ -1336,7 +1348,7 @@ In many cases the above estimate for the standard deviation, in particular if co











                  -

                  Definition of Correlation Functions and Standard Deviation

                  +

                  Definition of Correlation Functions and Standard Deviation

                  @@ -1371,7 +1383,7 @@ and the last term is nothing but the covariance which arises when \( k\ne l \).











                  -

                  Definition of Correlation Functions and Standard Deviation

                  +

                  Definition of Correlation Functions and Standard Deviation

                  @@ -1395,7 +1407,7 @@ have to be stored throughout the experiment.











                  -

                  Definition of Correlation Functions and Standard Deviation

                  +

                  Definition of Correlation Functions and Standard Deviation

                  @@ -1425,7 +1437,7 @@ $$











                  -

                  Definition of Correlation Functions and Standard Deviation

                  +

                  Definition of Correlation Functions and Standard Deviation

                  @@ -1449,7 +1461,7 @@ starting always at \( 1 \) for \( d=0 \).











                  -

                  Definition of Correlation Functions and Standard Deviation, sample variance

                  +

                  Definition of Correlation Functions and Standard Deviation, sample variance

                  @@ -1488,7 +1500,7 @@ equals 1.











                  -

                  Definition of Correlation Functions and Standard Deviation

                  +

                  Definition of Correlation Functions and Standard Deviation

                  @@ -1516,7 +1528,7 @@ more practically oriented methods like the blocking technique.

                  -

                  Code to compute the Covariance matrix and the Covariance

                  +

                  Code to compute the Covariance matrix and the Covariance

                  @@ -1537,31 +1549,31 @@ more practically oriented methods like the blocking technique. n = 100 x = np.random.normal(size=n) -print(np.mean(x)) +print(np.mean(x)) y = 4+3*x+np.random.normal(size=n) -print(np.mean(y)) +print(np.mean(y)) z = x**3+np.random.normal(size=n) -print(np.mean(z)) +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) +print(covxx,covyy, covzz) +print(covxy,covxz, covyz) w = np.vstack((x, y, z)) #print(w) c = np.cov(w) -print(c) +print(c) #eigen = np.zeros(n) Eigvals, Eigvecs = np.linalg.eig(c) -print(Eigvals) +print(Eigvals)











                  -

                  Random Numbers

                  +

                  Random Numbers

                  @@ -1583,7 +1595,7 @@ or Monte Carlo computer work.











                  -

                  Random Numbers, better name: pseudo random numbers

                  +

                  Random Numbers, better name: pseudo random numbers

                  @@ -1608,7 +1620,7 @@ numbers, hopefully abiding to the following criteria:











                  -

                  Random number generator RNG

                  +

                  Random number generator RNG

                  @@ -1642,7 +1654,7 @@ of the division \( 13/9 \), namely \( 4 \).











                  -

                  Random number generator RNG and periodic outputs

                  +

                  Random number generator RNG and periodic outputs

                  @@ -1681,7 +1693,7 @@ just \( 2 \).











                  -

                  Random number generator RNG and its period

                  +

                  Random number generator RNG and its period

                  @@ -1704,7 +1716,7 @@ $$











                  -

                  Random number generator RNG, other examples

                  +

                  Random number generator RNG, other examples

                  @@ -1737,7 +1749,7 @@ which according to the authors has a period larger than \( 2^{94} \).











                  -

                  Random number generator RNG, other examples

                  +

                  Random number generator RNG, other examples

                  @@ -1767,7 +1779,7 @@ it is given by \( m\wedge n \).











                  -

                  Random number generator RNG, RAN0

                  +

                  Random number generator RNG, RAN0

                  @@ -1813,7 +1825,7 @@ where the brackets denote integer division. In the code below the numbers











                  -

                  Random number generator RNG, RAN0

                  +

                  Random number generator RNG, RAN0

                  @@ -1836,7 +1848,7 @@ The last term \( [N_{i-1}/q]M\mathrm{MOD}(M) \) is zero since the integer divisi











                  -

                  Random number generator RNG, RAN0

                  +

                  Random number generator RNG, RAN0

                  @@ -1872,7 +1884,7 @@ $$











                  -

                  Random number generator RNG, RAN0

                  +

                  Random number generator RNG, RAN0

                  @@ -1894,7 +1906,7 @@ set to \( 0 \).











                  -

                  Random number generator RNG, RAN0 code

                  +

                  Random number generator RNG, RAN0 code

                  @@ -1936,7 +1948,7 @@ set to \( 0 \).











                  -

                  Properties of Selected Random Number Generators

                  +

                  Properties of Selected Random Number Generators

                  @@ -1963,7 +1975,7 @@ Two additional measures are the standard deviation \( \sigma \) and the mean











                  -

                  Properties of Selected Random Number Generators

                  +

                  Properties of Selected Random Number Generators

                  @@ -1988,7 +2000,7 @@ $$











                  -

                  Properties of Selected Random Number Generators

                  +

                  Properties of Selected Random Number Generators

                  @@ -2022,7 +2034,7 @@ these limiting values.











                  -

                  Simple demonstration of RNGs using python

                  +

                  Simple demonstration of RNGs using python

                  @@ -2062,7 +2074,7 @@ plt.show()











                  -

                  Properties of Selected Random Number Generators

                  +

                  Properties of Selected Random Number Generators

                  @@ -2099,7 +2111,7 @@ assumption for approximating \( \sigma_N \) is no longer valid.











                  -

                  Autocorrelation function

                  +

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

                  @@ -2122,7 +2134,7 @@ autocor = np.= np.zeros(n) mean_x=np.mean(x) var_x = np.var(x) -print(mean_x, 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 @@ -2141,7 +2153,7 @@ For the remaining values we notice that there are still non-zero values for the











                  -

                  Correlation function and which random number generators should I use

                  +

                  Correlation function and which random number generators should I use

                  @@ -2223,7 +2235,7 @@ ofstream ofile;











                  -

                  Which RNG should I use?

                  +

                  Which RNG should I use?

                  @@ -2238,7 +2250,7 @@ ofstream ofile;











                  -

                  How to use the Mersenne generator

                  +

                  How to use the Mersenne generator

                  @@ -2267,7 +2279,7 @@ The following part of a c++ code (from project 4) sets up the uniform distributi











                  -

                  Why blocking?

                  +

                  Why blocking?

                  Statistical analysis.

                  @@ -2287,7 +2299,7 @@ A very good article which explains blocking is H. Flyvbjerg and H. G. Petersen,











                  -

                  Why blocking?

                  +

                  Why blocking?

                  Statistical analysis.

                  @@ -2309,7 +2321,7 @@ A very good article which explains blocking is H. Flyvbjerg and H. G. Petersen,











                  -

                  Code to demonstrate the calculation of the autocorrelation function

                  +

                  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. @@ -2397,7 +2409,7 @@ ofstream ofile;











                  -

                  What is blocking?

                  +

                  What is blocking?

                  Blocking.

                  @@ -2427,7 +2439,7 @@ $$











                  -

                  What is blocking?

                  +

                  What is blocking?

                  Blocking.

                  @@ -2446,7 +2458,7 @@ $$











                  -

                  What is blocking?

                  +

                  What is blocking?

                  Blocking.

                  @@ -2463,7 +2475,7 @@ $$











                  -

                  Implementation

                  +

                  Implementation

                  @@ -2484,7 +2496,7 @@ $$











                  -

                  Actual implementation with code, main function

                  +

                  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.

                  @@ -2524,7 +2536,7 @@ The The Bootstrap method +

                  The Bootstrap method

                  The Bootstrap resampling method is also very popular. It is very simple: @@ -2544,7 +2556,7 @@ This method is very useful for small ensembles of data points.

                  -

                  Bootstrapping

                  +

                  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 @@ -2555,7 +2567,7 @@ This costs essentially nothing, since we just recycle the original data set for

                  -

                  Bootstrapping, recipe

                  +

                  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 @@ -2579,7 +2591,7 @@ the true \( \angle\theta\rangle \). As final result for the observable one quote

                  -

                  Bootstrapping, code

                  +

                  Bootstrapping, code

                  @@ -2596,7 +2608,7 @@ the true \( \angle\theta\rangle \). As final result for the observable one quote

                  -

                  Jackknife, code

                  +

                  Jackknife, code

                  @@ -2616,7 +2628,7 @@ the true \( \angle\theta\rangle \). As final result for the observable one quote

                  - © 1999-2018, Morten Hjorth-Jensen. Released under CC Attribution-NonCommercial 4.0 license + © 1999-2020, Morten Hjorth-Jensen. Released under CC Attribution-NonCommercial 4.0 license
                  diff --git a/doc/pub/Statistics/html/reveal.js/.gitignore b/doc/pub/Statistics/html/reveal.js/.gitignore index e7b4f216a..a5df3133d 100644 --- a/doc/pub/Statistics/html/reveal.js/.gitignore +++ b/doc/pub/Statistics/html/reveal.js/.gitignore @@ -1,8 +1,3 @@ -.idea/ -*.iml -*.iws -*.eml -out/ .DS_Store .svn log/*.log @@ -10,4 +5,4 @@ tmp/** node_modules/ .sass-cache css/reveal.min.css -js/reveal.min.js \ No newline at end of file +js/reveal.min.js diff --git a/doc/pub/Statistics/html/reveal.js/.travis.yml b/doc/pub/Statistics/html/reveal.js/.travis.yml index ec3b27d5d..165d9ae9f 100644 --- a/doc/pub/Statistics/html/reveal.js/.travis.yml +++ b/doc/pub/Statistics/html/reveal.js/.travis.yml @@ -1,7 +1,5 @@ language: node_js node_js: - - 4 + - 0.10 before_script: - - npm install -g grunt-cli -after_script: - - grunt retire + - npm install -g grunt-cli \ No newline at end of file diff --git a/doc/pub/Statistics/html/reveal.js/LICENSE b/doc/pub/Statistics/html/reveal.js/LICENSE index c3e6e5fd6..09623076f 100644 --- a/doc/pub/Statistics/html/reveal.js/LICENSE +++ b/doc/pub/Statistics/html/reveal.js/LICENSE @@ -1,4 +1,4 @@ -Copyright (C) 2017 Hakim El Hattab, http://hakim.se, and reveal.js contributors +Copyright (C) 2015 Hakim El Hattab, http://hakim.se Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal diff --git a/doc/pub/Statistics/html/reveal.js/README.md b/doc/pub/Statistics/html/reveal.js/README.md index f2ab6ca88..573b19597 100644 --- a/doc/pub/Statistics/html/reveal.js/README.md +++ b/doc/pub/Statistics/html/reveal.js/README.md @@ -1,58 +1,12 @@ -# reveal.js [![Build Status](https://travis-ci.org/hakimel/reveal.js.svg?branch=master)](https://travis-ci.org/hakimel/reveal.js) Slides +# reveal.js [![Build Status](https://travis-ci.org/hakimel/reveal.js.svg?branch=master)](https://travis-ci.org/hakimel/reveal.js) -A framework for easily creating beautiful presentations using HTML. [Check out the live demo](http://revealjs.com/). +A framework for easily creating beautiful presentations using HTML. [Check out the live demo](http://lab.hakim.se/reveal-js/). -reveal.js comes with a broad range of features including [nested slides](https://github.com/hakimel/reveal.js#markup), [Markdown contents](https://github.com/hakimel/reveal.js#markdown), [PDF export](https://github.com/hakimel/reveal.js#pdf-export), [speaker notes](https://github.com/hakimel/reveal.js#speaker-notes) and a [JavaScript API](https://github.com/hakimel/reveal.js#api). There's also a fully featured visual editor and platform for sharing reveal.js presentations at [slides.com](https://slides.com?ref=github). +reveal.js comes with a broad range of features including [nested slides](https://github.com/hakimel/reveal.js#markup), [Markdown contents](https://github.com/hakimel/reveal.js#markdown), [PDF export](https://github.com/hakimel/reveal.js#pdf-export), [speaker notes](https://github.com/hakimel/reveal.js#speaker-notes) and a [JavaScript API](https://github.com/hakimel/reveal.js#api). It's best viewed in a modern browser but [fallbacks](https://github.com/hakimel/reveal.js/wiki/Browser-Support) are available to make sure your presentation can still be viewed elsewhere. -## Table of contents -- [Online Editor](#online-editor) -- [Instructions](#instructions) - - [Markup](#markup) - - [Markdown](#markdown) - - [Element Attributes](#element-attributes) - - [Slide Attributes](#slide-attributes) -- [Configuration](#configuration) -- [Presentation Size](#presentation-size) -- [Dependencies](#dependencies) -- [Ready Event](#ready-event) -- [Auto-sliding](#auto-sliding) -- [Keyboard Bindings](#keyboard-bindings) -- [Touch Navigation](#touch-navigation) -- [Lazy Loading](#lazy-loading) -- [API](#api) - - [Slide Changed Event](#slide-changed-event) - - [Presentation State](#presentation-state) - - [Slide States](#slide-states) - - [Slide Backgrounds](#slide-backgrounds) - - [Parallax Background](#parallax-background) - - [Slide Transitions](#slide-transitions) - - [Internal links](#internal-links) - - [Fragments](#fragments) - - [Fragment events](#fragment-events) - - [Code syntax highlighting](#code-syntax-highlighting) - - [Slide number](#slide-number) - - [Overview mode](#overview-mode) - - [Fullscreen mode](#fullscreen-mode) - - [Embedded media](#embedded-media) - - [Stretching elements](#stretching-elements) - - [postMessage API](#postmessage-api) -- [PDF Export](#pdf-export) -- [Theming](#theming) -- [Speaker Notes](#speaker-notes) - - [Share and Print Speaker Notes](#share-and-print-speaker-notes) - - [Server Side Speaker Notes](#server-side-speaker-notes) -- [Multiplexing](#multiplexing) - - [Master presentation](#master-presentation) - - [Client presentation](#client-presentation) - - [Socket.io server](#socketio-server) -- [MathJax](#mathjax) -- [Installation](#installation) - - [Basic setup](#basic-setup) - - [Full setup](#full-setup) - - [Folder Structure](#folder-structure) -- [License](#license) -#### More reading +#### More reading: +- [Installation](#installation): Step-by-step instructions for getting reveal.js running on your computer. - [Changelog](https://github.com/hakimel/reveal.js/releases): Up-to-date version history. - [Examples](https://github.com/hakimel/reveal.js/wiki/Example-Presentations): Presentations created with reveal.js, add your own! - [Browser Support](https://github.com/hakimel/reveal.js/wiki/Browser-Support): Explanation of browser support and fallbacks. @@ -60,36 +14,14 @@ reveal.js comes with a broad range of features including [nested slides](https:/ ## Online Editor -Presentations are written using HTML or Markdown but there's also an online editor for those of you who prefer a graphical interface. Give it a try at [https://slides.com](https://slides.com?ref=github). +Presentations are written using HTML or Markdown but there's also an online editor for those of you who prefer a graphical interface. Give it a try at [http://slides.com](http://slides.com). ## Instructions ### Markup -Here's a barebones example of a fully working reveal.js presentation: -```html - - - - - - -
                  -
                  -
                  Slide 1
                  -
                  Slide 2
                  -
                  -
                  - - - - -``` - -The presentation markup hierarchy needs to be `.reveal > .slides > section` where the `section` represents one slide and can be repeated indefinitely. If you place multiple `section` elements inside of another `section` they will be shown as vertical slides. The first of the vertical slides is the "root" of the others (at the top), and will be included in the horizontal sequence. For example: +Markup hierarchy needs to be ``
                  `` where the ``
                  `` represents one slide and can be repeated indefinitely. If you place multiple ``
                  ``'s inside of another ``
                  `` they will be shown as vertical slides. The first of the vertical slides is the "root" of the others (at the top), and it will be included in the horizontal sequence. For example: ```html
                  @@ -105,36 +37,32 @@ The presentation markup hierarchy needs to be `.reveal > .slides > section` wher ### Markdown -It's possible to write your slides using Markdown. To enable Markdown, add the `data-markdown` attribute to your `
                  ` elements and wrap the contents in a ` +
                  ``` #### External Markdown -You can write your content as a separate file and have reveal.js load it at runtime. Note the separator arguments which determine how slides are delimited in the external file: the `data-separator` attribute defines a regular expression for horizontal slides (defaults to `^\r?\n---\r?\n$`, a newline-bounded horizontal rule) and `data-separator-vertical` defines vertical slides (disabled by default). The `data-separator-notes` attribute is a regular expression for specifying the beginning of the current slide's speaker notes (defaults to `note:`). The `data-charset` attribute is optional and specifies which charset to use when loading the external file. +You can write your content as a separate file and have reveal.js load it at runtime. Note the separator arguments which determine how slides are delimited in the external file. The ```data-charset``` attribute is optional and specifies which charset to use when loading the external file. -When used locally, this feature requires that reveal.js [runs from a local web server](#full-setup). The following example customises all available options: +When used locally, this feature requires that reveal.js [runs from a local web server](#full-setup). ```html -
                  -
                  ``` @@ -164,19 +92,6 @@ Special syntax (in html comment) is available for adding attributes to the slide
                  ``` -#### Configuring *marked* - -We use [marked](https://github.com/chjj/marked) to parse Markdown. To customise marked's rendering, you can pass in options when [configuring Reveal](#configuration): - -```javascript -Reveal.initialize({ - // Options which are passed into marked - // See https://github.com/chjj/marked#options-1 - markdown: { - smartypants: true - } -}); -``` ### Configuration @@ -185,26 +100,12 @@ At the end of your page you need to initialize reveal by running the following c ```javascript Reveal.initialize({ - // Display presentation control arrows + // Display controls in the bottom right corner controls: true, - // Help the user learn the controls by providing hints, for example by - // bouncing the down arrow when they first encounter a vertical slide - controlsTutorial: true, - - // Determines where controls appear, "edges" or "bottom-right" - controlsLayout: 'bottom-right', - - // Visibility rule for backwards navigation arrows; "faded", "hidden" - // or "visible" - controlsBackArrows: 'faded', - // Display a presentation progress bar progress: true, - // Set default timing of 2 minutes per slide - defaultTiming: 120, - // Display the page number of the current slide slideNumber: false, @@ -229,9 +130,6 @@ Reveal.initialize({ // Change the presentation direction to be RTL rtl: false, - // Randomizes the order of slides each time the presentation loads - shuffle: false, - // Turns fragments on and off globally fragments: true, @@ -243,15 +141,6 @@ Reveal.initialize({ // key is pressed help: true, - // Flags if speaker notes should be visible to all viewers - showNotes: false, - - // Global override for autoplaying embedded media (video/audio/iframe) - // - null: Media will only autoplay if data-autoplay is present - // - true: All media will autoplay, regardless of individual setting - // - false: No media will autoplay, regardless of individual setting - autoPlayMedia: null, - // Number of milliseconds between automatically proceeding to the // next slide, disabled when set to 0, this value can be overwritten // by using a data-autoslide attribute on your slides @@ -260,9 +149,6 @@ Reveal.initialize({ // Stop auto-sliding after user input autoSlideStoppable: true, - // Use this method for navigation when auto-sliding - autoSlideMethod: Reveal.navigateNext, - // Enable slide navigation via mouse wheel mouseWheel: false, @@ -270,18 +156,16 @@ Reveal.initialize({ hideAddressBar: true, // Opens links in an iframe preview overlay - // Add `data-preview-link` and `data-preview-link="false"` to customise each link - // individually previewLinks: false, // Transition style - transition: 'slide', // none/fade/slide/convex/concave/zoom + transition: 'default', // none/fade/slide/convex/concave/zoom // Transition speed transitionSpeed: 'default', // default/fast/slow // Transition style for full page slide backgrounds - backgroundTransition: 'fade', // none/fade/slide/convex/concave/zoom + backgroundTransition: 'default', // none/fade/slide/convex/concave/zoom // Number of slides away from the current that are visible viewDistance: 3, @@ -292,14 +176,10 @@ Reveal.initialize({ // Parallax background size parallaxBackgroundSize: '', // CSS syntax, e.g. "2100px 900px" - // Number of pixels to move the parallax background per slide - // - Calculated automatically unless specified - // - Set to 0 to disable movement along an axis - parallaxBackgroundHorizontal: null, - parallaxBackgroundVertical: null, - - // The display mode that will be used to show slides - display: 'block' + // Amount to move parallax background (horizontal and vertical) on slide change + // Number, e.g. 100 + parallaxBackgroundHorizontal: '', + parallaxBackgroundVertical: '' }); ``` @@ -316,6 +196,56 @@ Reveal.configure({ autoSlide: 5000 }); ``` +### Dependencies + +Reveal.js doesn't _rely_ on any third party scripts to work but a few optional libraries are included by default. These libraries are loaded as dependencies in the order they appear, for example: + +```javascript +Reveal.initialize({ + dependencies: [ + // Cross-browser shim that fully implements classList - https://github.com/eligrey/classList.js/ + { src: 'lib/js/classList.js', condition: function() { return !document.body.classList; } }, + + // Interpret Markdown in
                  elements + { src: 'plugin/markdown/marked.js', condition: function() { return !!document.querySelector( '[data-markdown]' ); } }, + { src: 'plugin/markdown/markdown.js', condition: function() { return !!document.querySelector( '[data-markdown]' ); } }, + + // Syntax highlight for elements + { src: 'plugin/highlight/highlight.js', async: true, callback: function() { hljs.initHighlightingOnLoad(); } }, + + // Zoom in and out with Alt+click + { src: 'plugin/zoom-js/zoom.js', async: true }, + + // Speaker notes + { src: 'plugin/notes/notes.js', async: true }, + + // Remote control your reveal.js presentation using a touch device + { src: 'plugin/remotes/remotes.js', async: true }, + + // MathJax + { src: 'plugin/math/math.js', async: true } + ] +}); +``` + +You can add your own extensions using the same syntax. The following properties are available for each dependency object: +- **src**: Path to the script to load +- **async**: [optional] Flags if the script should load after reveal.js has started, defaults to false +- **callback**: [optional] Function to execute when the script has loaded +- **condition**: [optional] Function which must return true for the script to be loaded + + +### Ready Event + +A 'ready' event is fired when reveal.js has loaded all non-async dependencies and is ready to start navigating. To check if reveal.js is already 'ready' you can call `Reveal.isReady()`. + +```javascript +Reveal.addEventListener( 'ready', function( event ) { + // event.currentSlide, event.indexh, event.indexv +} ); +``` + + ### Presentation Size All presentations have a normal size, that is the resolution at which they are authored. The framework will automatically scale presentations uniformly based on this size to ensure that everything fits on any given display or viewport. @@ -343,69 +273,6 @@ Reveal.initialize({ }); ``` -If you wish to disable this behavior and do your own scaling (e.g. using media queries), try these settings: - -```javascript -Reveal.initialize({ - - ... - - width: "100%", - height: "100%", - margin: 0, - minScale: 1, - maxScale: 1 -}); -``` - -### Dependencies - -Reveal.js doesn't _rely_ on any third party scripts to work but a few optional libraries are included by default. These libraries are loaded as dependencies in the order they appear, for example: - -```javascript -Reveal.initialize({ - dependencies: [ - // Cross-browser shim that fully implements classList - https://github.com/eligrey/classList.js/ - { src: 'lib/js/classList.js', condition: function() { return !document.body.classList; } }, - - // Interpret Markdown in
                  elements - { src: 'plugin/markdown/marked.js', condition: function() { return !!document.querySelector( '[data-markdown]' ); } }, - { src: 'plugin/markdown/markdown.js', condition: function() { return !!document.querySelector( '[data-markdown]' ); } }, - - // Syntax highlight for elements - { src: 'plugin/highlight/highlight.js', async: true, callback: function() { hljs.initHighlightingOnLoad(); } }, - - // Zoom in and out with Alt+click - { src: 'plugin/zoom-js/zoom.js', async: true }, - - // Speaker notes - { src: 'plugin/notes/notes.js', async: true }, - - // MathJax - { src: 'plugin/math/math.js', async: true } - ] -}); -``` - -You can add your own extensions using the same syntax. The following properties are available for each dependency object: -- **src**: Path to the script to load -- **async**: [optional] Flags if the script should load after reveal.js has started, defaults to false -- **callback**: [optional] Function to execute when the script has loaded -- **condition**: [optional] Function which must return true for the script to be loaded - -To load these dependencies, reveal.js requires [head.js](http://headjs.com/) *(a script loading library)* to be loaded before reveal.js. - -### Ready Event - -A 'ready' event is fired when reveal.js has loaded all non-async dependencies and is ready to start navigating. To check if reveal.js is already 'ready' you can call `Reveal.isReady()`. - -```javascript -Reveal.addEventListener( 'ready', function( event ) { - // event.currentSlide, event.indexh, event.indexv -} ); -``` - -Note that we also add a `.ready` class to the `.reveal` element so that you can hook into this with CSS. ### Auto-sliding @@ -429,8 +296,6 @@ You can also override the slide duration for individual slides and fragments by
                  ``` -To override the method used for navigation when auto-sliding, you can specify the ```autoSlideMethod``` setting. To only navigate along the top layer and ignore vertical slides, set this to ```Reveal.navigateRight```. - Whenever the auto-slide mode is resumed or paused the ```autoslideresumed``` and ```autoslidepaused``` events are fired. @@ -448,13 +313,6 @@ Reveal.configure({ }); ``` -### Touch Navigation - -You can swipe to navigate through a presentation on any touch-enabled device. Horizontal swipes change between horizontal slides, vertical swipes change between vertical slides. If you wish to disable this you can set the `touch` config option to false when initializing reveal.js. - -If there's some part of your content that needs to remain accessible to touch events you'll need to highlight this by adding a `data-prevent-swipe` attribute to the element. One common example where this is useful is elements that need to be scrolled. - - ### Lazy Loading When working on presentation with a lot of media or iframe content it's important to load lazily. Lazy loading means that reveal.js will only load content for the few slides nearest to the current slide. The number of slides that are preloaded is determined by the `viewDistance` configuration option. @@ -489,18 +347,11 @@ Reveal.next(); Reveal.prevFragment(); Reveal.nextFragment(); -// Randomize the order of slides -Reveal.shuffle(); - // Toggle presentation states, optionally pass true/false to force on/off Reveal.toggleOverview(); Reveal.togglePause(); Reveal.toggleAutoSlide(); -// Shows a help overlay with keyboard shortcuts, optionally pass true/false -// to force on/off -Reveal.toggleHelp(); - // Change a config value at runtime Reveal.configure({ controls: true }); @@ -514,14 +365,9 @@ Reveal.getScale(); Reveal.getPreviousSlide(); Reveal.getCurrentSlide(); -Reveal.getIndices(); // { h: 0, v: 0 } } -Reveal.getPastSlideCount(); -Reveal.getProgress(); // (0 == first slide, 1 == last slide) -Reveal.getSlides(); // Array of all slides -Reveal.getTotalSlides(); // total number of slides - -// Returns the speaker notes for the current slide -Reveal.getSlideNotes(); +Reveal.getIndices(); // { h: 0, v: 0 } } +Reveal.getProgress(); // 0-1 +Reveal.getTotalSlides(); // State checks Reveal.isFirstSlide(); @@ -574,59 +420,26 @@ Reveal.addEventListener( 'somestate', function() { ### Slide Backgrounds -Slides are contained within a limited portion of the screen by default to allow them to fit any display and scale uniformly. You can apply full page backgrounds outside of the slide area by adding a ```data-background``` attribute to your ```
                  ``` elements. Four different types of backgrounds are supported: color, image, video and iframe. +Slides are contained within a limited portion of the screen by default to allow them to fit any display and scale uniformly. You can apply full page backgrounds outside of the slide area by adding a ```data-background``` attribute to your ```
                  ``` elements. Four different types of backgrounds are supported: color, image, video and iframe. Below are a few examples. -#### Color Backgrounds -All CSS color formats are supported, like rgba() or hsl(). ```html -
                  -

                  Color

                  +
                  +

                  All CSS color formats are supported, like rgba() or hsl().

                  +
                  +
                  +

                  This slide will have a full-size background image.

                  +
                  +
                  +

                  This background image will be sized to 100px and repeated.

                  +
                  +
                  +

                  Video. Multiple sources can be defined using a comma separated list. Video will loop when the data-background-video-loop attribute is provided.

                  +
                  +
                  +

                  Embeds a web page as a background. Note that the page won't be interactive.

                  ``` -#### Image Backgrounds -By default, background images are resized to cover the full page. Available options: - -| Attribute | Default | Description | -| :--------------------------- | :--------- | :---------- | -| data-background-image | | URL of the image to show. GIFs restart when the slide opens. | -| data-background-size | cover | See [background-size](https://developer.mozilla.org/docs/Web/CSS/background-size) on MDN. | -| data-background-position | center | See [background-position](https://developer.mozilla.org/docs/Web/CSS/background-position) on MDN. | -| data-background-repeat | no-repeat | See [background-repeat](https://developer.mozilla.org/docs/Web/CSS/background-repeat) on MDN. | -```html -
                  -

                  Image

                  -
                  -
                  -

                  This background image will be sized to 100px and repeated

                  -
                  -``` - -#### Video Backgrounds -Automatically plays a full size video behind the slide. - -| Attribute | Default | Description | -| :--------------------------- | :------ | :---------- | -| data-background-video | | A single video source, or a comma separated list of video sources. | -| data-background-video-loop | false | Flags if the video should play repeatedly. | -| data-background-video-muted | false | Flags if the audio should be muted. | -| data-background-size | cover | Use `cover` for full screen and some cropping or `contain` for letterboxing. | - -```html -
                  -

                  Video

                  -
                  -``` - -#### Iframe Backgrounds -Embeds a web page as a slide background that covers 100% of the reveal.js width and height. The iframe is in the background layer, behind your slides, and as such it's not possible to interact with it by default. To make your background interactive, you can add the `data-background-interactive` attribute. -```html -
                  -

                  Iframe

                  -
                  -``` - -#### Background Transitions Backgrounds transition using a fade animation by default. This can be changed to a linear sliding transition by passing ```backgroundTransition: 'slide'``` to the ```Reveal.initialize()``` call. Alternatively you can set ```data-background-transition``` on any section with a background to override that specific transition. @@ -643,16 +456,16 @@ Reveal.initialize({ // Parallax background size parallaxBackgroundSize: '', // CSS syntax, e.g. "2100px 900px" - currently only pixels are supported (don't use % or auto) - // Number of pixels to move the parallax background per slide - // - Calculated automatically unless specified - // - Set to 0 to disable movement along an axis + // Amount of pixels to move the parallax background per slide step, + // a value of 0 disables movement along the given axis + // These are optional, if they aren't specified they'll be calculated automatically parallaxBackgroundHorizontal: 200, parallaxBackgroundVertical: 50 }); ``` -Make sure that the background size is much bigger than screen size to allow for some scrolling. [View example](http://revealjs.com/?parallaxBackgroundImage=https%3A%2F%2Fs3.amazonaws.com%2Fhakim-static%2Freveal-js%2Freveal-parallax-1.jpg¶llaxBackgroundSize=2100px%20900px). +Make sure that the background size is much bigger than screen size to allow for some scrolling. [View example](http://lab.hakim.se/reveal-js/?parallaxBackgroundImage=https%3A%2F%2Fs3.amazonaws.com%2Fhakim-static%2Freveal-js%2Freveal-parallax-1.jpg¶llaxBackgroundSize=2100px%20900px). @@ -673,15 +486,15 @@ You can also use different in and out transitions for the same slide: ```html
                  - The train goes on … + The train goes on …
                  -
                  - and on … +
                  + and on …
                  -
                  +
                  and stops.
                  -
                  +
                  (Passengers entering and leaving)
                  @@ -690,6 +503,9 @@ You can also use different in and out transitions for the same slide: ``` +Note that this does not work with the page and cube transitions. + + ### Internal links It's easy to link between slides. The first example below targets the index of another slide whereas the second targets a slide with an ID attribute (```
                  ```): @@ -712,7 +528,7 @@ You can also add relative navigation links, similar to the built in reveal.js co ### Fragments -Fragments are used to highlight individual elements on a slide. Every element with the class ```fragment``` will be stepped through before moving on to the next slide. Here's an example: http://revealjs.com/#/fragments +Fragments are used to highlight individual elements on a slide. Every element with the class ```fragment``` will be stepped through before moving on to the next slide. Here's an example: http://lab.hakim.se/reveal-js/#/fragments The default fragment style is to start out invisible and fade in. This style can be changed by appending a different class to the fragment: @@ -721,7 +537,6 @@ The default fragment style is to start out invisible and fade in. This style can

                  grow

                  shrink

                  fade-out

                  -

                  fade-up (also down, left and right!)

                  visible only once

                  blue only once

                  highlight-red

                  @@ -767,41 +582,33 @@ Reveal.addEventListener( 'fragmenthidden', function( event ) { ### Code syntax highlighting -By default, Reveal is configured with [highlight.js](https://highlightjs.org/) for code syntax highlighting. To enable syntax highlighting, you'll have to load the highlight plugin ([plugin/highlight/highlight.js](plugin/highlight/highlight.js)) and a highlight.js CSS theme (Reveal comes packaged with the zenburn theme: [lib/css/zenburn.css](lib/css/zenburn.css)). - -Below is an example with clojure code that will be syntax highlighted. When the `data-trim` attribute is present, surrounding whitespace is automatically removed. HTML will be escaped by default. To avoid this, for example if you are using `` to call out a line of code, add the `data-noescape` attribute to the `` element. +By default, Reveal is configured with [highlight.js](http://softwaremaniacs.org/soft/highlight/en/) for code syntax highlighting. Below is an example with clojure code that will be syntax highlighted. When the `data-trim` attribute is present surrounding whitespace is automatically removed. ```html
                  -
                  
                  +	
                  
                   (def lazy-fib
                     (concat
                      [0 1]
                  -   ((fn rfib [a b]
                  +   ((fn rfib [a b]
                           (lazy-cons (+ a b) (rfib b (+ a b)))) 0 1)))
                   	
                  ``` ### Slide number -If you would like to display the page number of the current slide you can do so using the ```slideNumber``` and ```showSlideNumber``` configuration values. +If you would like to display the page number of the current slide you can do so using the ```slideNumber``` configuration value. ```javascript // Shows the slide number using default formatting Reveal.configure({ slideNumber: true }); // Slide number formatting can be configured using these variables: -// "h.v": horizontal . vertical slide number (default) -// "h/v": horizontal / vertical slide number -// "c": flattened slide number -// "c/t": flattened slide number / total slides -Reveal.configure({ slideNumber: 'c/t' }); - -// Control which views the slide number displays on using the "showSlideNumber" value: -// "all": show on all views (default) -// "speaker": only show slide numbers on speaker notes view -// "print": only show slide numbers when printing to PDF -Reveal.configure({ showSlideNumber: 'speaker' }); +// h: current slide's horizontal index +// v: current slide's vertical index +// c: current slide index (flattened) +// t: total number of slides (flattened) +Reveal.configure({ slideNumber: 'c / t' }); ``` @@ -819,26 +626,20 @@ Reveal.addEventListener( 'overviewhidden', function( event ) { /* ... */ } ); Reveal.toggleOverview(); ``` - ### Fullscreen mode Just press »F« on your keyboard to show your presentation in fullscreen mode. Press the »ESC« key to exit fullscreen mode. ### Embedded media +Embedded HTML5 `
                  diff --git a/doc/pub/Statistics/html/reveal.js/plugin/markdown/example.md b/doc/pub/Statistics/html/reveal.js/plugin/markdown/example.md index 89c75345e..6f6f577a1 100644 --- a/doc/pub/Statistics/html/reveal.js/plugin/markdown/example.md +++ b/doc/pub/Statistics/html/reveal.js/plugin/markdown/example.md @@ -29,8 +29,3 @@ Content 3.1 ## External 3.2 Content 3.2 - - -## External 3.3 - -![External Image](https://s3.amazonaws.com/static.slid.es/logo/v2/slides-symbol-512x512.png) diff --git a/doc/pub/Statistics/html/reveal.js/plugin/markdown/markdown.js b/doc/pub/Statistics/html/reveal.js/plugin/markdown/markdown.js index aa08ee5ed..15e3b40b3 100644 --- a/doc/pub/Statistics/html/reveal.js/plugin/markdown/markdown.js +++ b/doc/pub/Statistics/html/reveal.js/plugin/markdown/markdown.js @@ -4,26 +4,33 @@ * of external markdown documents. */ (function( root, factory ) { - if (typeof define === 'function' && define.amd) { - root.marked = require( './marked' ); - root.RevealMarkdown = factory( root.marked ); - root.RevealMarkdown.initialize(); - } else if( typeof exports === 'object' ) { + if( typeof exports === 'object' ) { module.exports = factory( require( './marked' ) ); - } else { + } + else { // Browser globals (root is window) root.RevealMarkdown = factory( root.marked ); root.RevealMarkdown.initialize(); } }( this, function( marked ) { + if( typeof marked === 'undefined' ) { + throw 'The reveal.js Markdown plugin requires marked to be loaded'; + } + + if( typeof hljs !== 'undefined' ) { + marked.setOptions({ + highlight: function( lang, code ) { + return hljs.highlightAuto( lang, code ).value; + } + }); + } + var DEFAULT_SLIDE_SEPARATOR = '^\r?\n---\r?\n$', - DEFAULT_NOTES_SEPARATOR = 'notes?:', + DEFAULT_NOTES_SEPARATOR = 'note:', DEFAULT_ELEMENT_ATTRIBUTES_SEPARATOR = '\\\.element\\\s*?(.+?)$', DEFAULT_SLIDE_ATTRIBUTES_SEPARATOR = '\\\.slide:\\\s*?(\\\S.+?)$'; - var SCRIPT_END_PLACEHOLDER = '__SCRIPT_END__'; - /** * Retrieves the markdown contents of a slide section @@ -31,15 +38,11 @@ */ function getMarkdownFromSlide( section ) { - // look for a ' ); - var leadingWs = text.match( /^\n?(\s*)/ )[1].length, leadingTabs = text.match( /^\n?(\t*)/ )[1].length; @@ -109,13 +112,9 @@ var notesMatch = content.split( new RegExp( options.notesSeparator, 'mgi' ) ); if( notesMatch.length === 2 ) { - content = notesMatch[0] + ''; + content = notesMatch[0] + ''; } - // prevent script end tags in the content from interfering - // with parsing - content = content.replace( /<\/script>/g, SCRIPT_END_PLACEHOLDER ); - return ''; } @@ -178,7 +177,7 @@ markdownSections += '
                  '; sectionStack[i].forEach( function( child ) { - markdownSections += '
                  ' + createMarkdownSlide( child, options ) + '
                  '; + markdownSections += '
                  ' + createMarkdownSlide( child, options ) + '
                  '; } ); markdownSections += '
                  '; @@ -380,24 +379,6 @@ return { initialize: function() { - if( typeof marked === 'undefined' ) { - throw 'The reveal.js Markdown plugin requires marked to be loaded'; - } - - if( typeof hljs !== 'undefined' ) { - marked.setOptions({ - highlight: function( code, lang ) { - return hljs.highlightAuto( code, [lang] ).value; - } - }); - } - - var options = Reveal.getConfig().markdown; - - if ( options ) { - marked.setOptions( options ); - } - processSlides(); convertSlides(); }, diff --git a/doc/pub/Statistics/html/reveal.js/plugin/markdown/marked.js b/doc/pub/Statistics/html/reveal.js/plugin/markdown/marked.js index 555c1dc1d..70af29bf9 100644 --- a/doc/pub/Statistics/html/reveal.js/plugin/markdown/marked.js +++ b/doc/pub/Statistics/html/reveal.js/plugin/markdown/marked.js @@ -3,4 +3,4 @@ * Copyright (c) 2011-2014, Christopher Jeffrey. (MIT Licensed) * https://github.com/chjj/marked */ -(function(){var block={newline:/^\n+/,code:/^( {4}[^\n]+\n*)+/,fences:noop,hr:/^( *[-*_]){3,} *(?:\n+|$)/,heading:/^ *(#{1,6}) *([^\n]+?) *#* *(?:\n+|$)/,nptable:noop,lheading:/^([^\n]+)\n *(=|-){2,} *(?:\n+|$)/,blockquote:/^( *>[^\n]+(\n(?!def)[^\n]+)*\n*)+/,list:/^( *)(bull) [\s\S]+?(?:hr|def|\n{2,}(?! )(?!\1bull )\n*|\s*$)/,html:/^ *(?:comment *(?:\n|\s*$)|closed *(?:\n{2,}|\s*$)|closing *(?:\n{2,}|\s*$))/,def:/^ *\[([^\]]+)\]: *]+)>?(?: +["(]([^\n]+)[")])? *(?:\n+|$)/,table:noop,paragraph:/^((?:[^\n]+\n?(?!hr|heading|lheading|blockquote|tag|def))+)\n*/,text:/^[^\n]+/};block.bullet=/(?:[*+-]|\d+\.)/;block.item=/^( *)(bull) [^\n]*(?:\n(?!\1bull )[^\n]*)*/;block.item=replace(block.item,"gm")(/bull/g,block.bullet)();block.list=replace(block.list)(/bull/g,block.bullet)("hr","\\n+(?=\\1?(?:[-*_] *){3,}(?:\\n+|$))")("def","\\n+(?="+block.def.source+")")();block.blockquote=replace(block.blockquote)("def",block.def)();block._tag="(?!(?:"+"a|em|strong|small|s|cite|q|dfn|abbr|data|time|code"+"|var|samp|kbd|sub|sup|i|b|u|mark|ruby|rt|rp|bdi|bdo"+"|span|br|wbr|ins|del|img)\\b)\\w+(?!:/|[^\\w\\s@]*@)\\b";block.html=replace(block.html)("comment",//)("closed",/<(tag)[\s\S]+?<\/\1>/)("closing",/])*?>/)(/tag/g,block._tag)();block.paragraph=replace(block.paragraph)("hr",block.hr)("heading",block.heading)("lheading",block.lheading)("blockquote",block.blockquote)("tag","<"+block._tag)("def",block.def)();block.normal=merge({},block);block.gfm=merge({},block.normal,{fences:/^ *(`{3,}|~{3,})[ \.]*(\S+)? *\n([\s\S]*?)\s*\1 *(?:\n+|$)/,paragraph:/^/,heading:/^ *(#{1,6}) +([^\n]+?) *#* *(?:\n+|$)/});block.gfm.paragraph=replace(block.paragraph)("(?!","(?!"+block.gfm.fences.source.replace("\\1","\\2")+"|"+block.list.source.replace("\\1","\\3")+"|")();block.tables=merge({},block.gfm,{nptable:/^ *(\S.*\|.*)\n *([-:]+ *\|[-| :]*)\n((?:.*\|.*(?:\n|$))*)\n*/,table:/^ *\|(.+)\n *\|( *[-:]+[-| :]*)\n((?: *\|.*(?:\n|$))*)\n*/});function Lexer(options){this.tokens=[];this.tokens.links={};this.options=options||marked.defaults;this.rules=block.normal;if(this.options.gfm){if(this.options.tables){this.rules=block.tables}else{this.rules=block.gfm}}}Lexer.rules=block;Lexer.lex=function(src,options){var lexer=new Lexer(options);return lexer.lex(src)};Lexer.prototype.lex=function(src){src=src.replace(/\r\n|\r/g,"\n").replace(/\t/g," ").replace(/\u00a0/g," ").replace(/\u2424/g,"\n");return this.token(src,true)};Lexer.prototype.token=function(src,top,bq){var src=src.replace(/^ +$/gm,""),next,loose,cap,bull,b,item,space,i,l;while(src){if(cap=this.rules.newline.exec(src)){src=src.substring(cap[0].length);if(cap[0].length>1){this.tokens.push({type:"space"})}}if(cap=this.rules.code.exec(src)){src=src.substring(cap[0].length);cap=cap[0].replace(/^ {4}/gm,"");this.tokens.push({type:"code",text:!this.options.pedantic?cap.replace(/\n+$/,""):cap});continue}if(cap=this.rules.fences.exec(src)){src=src.substring(cap[0].length);this.tokens.push({type:"code",lang:cap[2],text:cap[3]||""});continue}if(cap=this.rules.heading.exec(src)){src=src.substring(cap[0].length);this.tokens.push({type:"heading",depth:cap[1].length,text:cap[2]});continue}if(top&&(cap=this.rules.nptable.exec(src))){src=src.substring(cap[0].length);item={type:"table",header:cap[1].replace(/^ *| *\| *$/g,"").split(/ *\| */),align:cap[2].replace(/^ *|\| *$/g,"").split(/ *\| */),cells:cap[3].replace(/\n$/,"").split("\n")};for(i=0;i ?/gm,"");this.token(cap,top,true);this.tokens.push({type:"blockquote_end"});continue}if(cap=this.rules.list.exec(src)){src=src.substring(cap[0].length);bull=cap[2];this.tokens.push({type:"list_start",ordered:bull.length>1});cap=cap[0].match(this.rules.item);next=false;l=cap.length;i=0;for(;i1&&b.length>1)){src=cap.slice(i+1).join("\n")+src;i=l-1}}loose=next||/\n\n(?!\s*$)/.test(item);if(i!==l-1){next=item.charAt(item.length-1)==="\n";if(!loose)loose=next}this.tokens.push({type:loose?"loose_item_start":"list_item_start"});this.token(item,false,bq);this.tokens.push({type:"list_item_end"})}this.tokens.push({type:"list_end"});continue}if(cap=this.rules.html.exec(src)){src=src.substring(cap[0].length);this.tokens.push({type:this.options.sanitize?"paragraph":"html",pre:!this.options.sanitizer&&(cap[1]==="pre"||cap[1]==="script"||cap[1]==="style"),text:cap[0]});continue}if(!bq&&top&&(cap=this.rules.def.exec(src))){src=src.substring(cap[0].length);this.tokens.links[cap[1].toLowerCase()]={href:cap[2],title:cap[3]};continue}if(top&&(cap=this.rules.table.exec(src))){src=src.substring(cap[0].length);item={type:"table",header:cap[1].replace(/^ *| *\| *$/g,"").split(/ *\| */),align:cap[2].replace(/^ *|\| *$/g,"").split(/ *\| */),cells:cap[3].replace(/(?: *\| *)?\n$/,"").split("\n")};for(i=0;i])/,autolink:/^<([^ >]+(@|:\/)[^ >]+)>/,url:noop,tag:/^|^<\/?\w+(?:"[^"]*"|'[^']*'|[^'">])*?>/,link:/^!?\[(inside)\]\(href\)/,reflink:/^!?\[(inside)\]\s*\[([^\]]*)\]/,nolink:/^!?\[((?:\[[^\]]*\]|[^\[\]])*)\]/,strong:/^__([\s\S]+?)__(?!_)|^\*\*([\s\S]+?)\*\*(?!\*)/,em:/^\b_((?:[^_]|__)+?)_\b|^\*((?:\*\*|[\s\S])+?)\*(?!\*)/,code:/^(`+)\s*([\s\S]*?[^`])\s*\1(?!`)/,br:/^ {2,}\n(?!\s*$)/,del:noop,text:/^[\s\S]+?(?=[\\?(?:\s+['"]([\s\S]*?)['"])?\s*/;inline.link=replace(inline.link)("inside",inline._inside)("href",inline._href)();inline.reflink=replace(inline.reflink)("inside",inline._inside)();inline.normal=merge({},inline);inline.pedantic=merge({},inline.normal,{strong:/^__(?=\S)([\s\S]*?\S)__(?!_)|^\*\*(?=\S)([\s\S]*?\S)\*\*(?!\*)/,em:/^_(?=\S)([\s\S]*?\S)_(?!_)|^\*(?=\S)([\s\S]*?\S)\*(?!\*)/});inline.gfm=merge({},inline.normal,{escape:replace(inline.escape)("])","~|])")(),url:/^(https?:\/\/[^\s<]+[^<.,:;"')\]\s])/,del:/^~~(?=\S)([\s\S]*?\S)~~/,text:replace(inline.text)("]|","~]|")("|","|https?://|")()});inline.breaks=merge({},inline.gfm,{br:replace(inline.br)("{2,}","*")(),text:replace(inline.gfm.text)("{2,}","*")()});function InlineLexer(links,options){this.options=options||marked.defaults;this.links=links;this.rules=inline.normal;this.renderer=this.options.renderer||new Renderer;this.renderer.options=this.options;if(!this.links){throw new Error("Tokens array requires a `links` property.")}if(this.options.gfm){if(this.options.breaks){this.rules=inline.breaks}else{this.rules=inline.gfm}}else if(this.options.pedantic){this.rules=inline.pedantic}}InlineLexer.rules=inline;InlineLexer.output=function(src,links,options){var inline=new InlineLexer(links,options);return inline.output(src)};InlineLexer.prototype.output=function(src){var out="",link,text,href,cap;while(src){if(cap=this.rules.escape.exec(src)){src=src.substring(cap[0].length);out+=cap[1];continue}if(cap=this.rules.autolink.exec(src)){src=src.substring(cap[0].length);if(cap[2]==="@"){text=cap[1].charAt(6)===":"?this.mangle(cap[1].substring(7)):this.mangle(cap[1]);href=this.mangle("mailto:")+text}else{text=escape(cap[1]);href=text}out+=this.renderer.link(href,null,text);continue}if(!this.inLink&&(cap=this.rules.url.exec(src))){src=src.substring(cap[0].length);text=escape(cap[1]);href=text;out+=this.renderer.link(href,null,text);continue}if(cap=this.rules.tag.exec(src)){if(!this.inLink&&/^/i.test(cap[0])){this.inLink=false}src=src.substring(cap[0].length);out+=this.options.sanitize?this.options.sanitizer?this.options.sanitizer(cap[0]):escape(cap[0]):cap[0];continue}if(cap=this.rules.link.exec(src)){src=src.substring(cap[0].length);this.inLink=true;out+=this.outputLink(cap,{href:cap[2],title:cap[3]});this.inLink=false;continue}if((cap=this.rules.reflink.exec(src))||(cap=this.rules.nolink.exec(src))){src=src.substring(cap[0].length);link=(cap[2]||cap[1]).replace(/\s+/g," ");link=this.links[link.toLowerCase()];if(!link||!link.href){out+=cap[0].charAt(0);src=cap[0].substring(1)+src;continue}this.inLink=true;out+=this.outputLink(cap,link);this.inLink=false;continue}if(cap=this.rules.strong.exec(src)){src=src.substring(cap[0].length);out+=this.renderer.strong(this.output(cap[2]||cap[1]));continue}if(cap=this.rules.em.exec(src)){src=src.substring(cap[0].length);out+=this.renderer.em(this.output(cap[2]||cap[1]));continue}if(cap=this.rules.code.exec(src)){src=src.substring(cap[0].length);out+=this.renderer.codespan(escape(cap[2],true));continue}if(cap=this.rules.br.exec(src)){src=src.substring(cap[0].length);out+=this.renderer.br();continue}if(cap=this.rules.del.exec(src)){src=src.substring(cap[0].length);out+=this.renderer.del(this.output(cap[1]));continue}if(cap=this.rules.text.exec(src)){src=src.substring(cap[0].length);out+=this.renderer.text(escape(this.smartypants(cap[0])));continue}if(src){throw new Error("Infinite loop on byte: "+src.charCodeAt(0))}}return out};InlineLexer.prototype.outputLink=function(cap,link){var href=escape(link.href),title=link.title?escape(link.title):null;return cap[0].charAt(0)!=="!"?this.renderer.link(href,title,this.output(cap[1])):this.renderer.image(href,title,escape(cap[1]))};InlineLexer.prototype.smartypants=function(text){if(!this.options.smartypants)return text;return text.replace(/---/g,"—").replace(/--/g,"–").replace(/(^|[-\u2014/(\[{"\s])'/g,"$1‘").replace(/'/g,"’").replace(/(^|[-\u2014/(\[{\u2018\s])"/g,"$1“").replace(/"/g,"”").replace(/\.{3}/g,"…")};InlineLexer.prototype.mangle=function(text){if(!this.options.mangle)return text;var out="",l=text.length,i=0,ch;for(;i.5){ch="x"+ch.toString(16)}out+="&#"+ch+";"}return out};function Renderer(options){this.options=options||{}}Renderer.prototype.code=function(code,lang,escaped){if(this.options.highlight){var out=this.options.highlight(code,lang);if(out!=null&&out!==code){escaped=true;code=out}}if(!lang){return"
                  "+(escaped?code:escape(code,true))+"\n
                  "}return'
                  '+(escaped?code:escape(code,true))+"\n
                  \n"};Renderer.prototype.blockquote=function(quote){return"
                  \n"+quote+"
                  \n"};Renderer.prototype.html=function(html){return html};Renderer.prototype.heading=function(text,level,raw){return"'+text+"\n"};Renderer.prototype.hr=function(){return this.options.xhtml?"
                  \n":"
                  \n"};Renderer.prototype.list=function(body,ordered){var type=ordered?"ol":"ul";return"<"+type+">\n"+body+"\n"};Renderer.prototype.listitem=function(text){return"
                • "+text+"
                • \n"};Renderer.prototype.paragraph=function(text){return"

                  "+text+"

                  \n"};Renderer.prototype.table=function(header,body){return"\n"+"\n"+header+"\n"+"\n"+body+"\n"+"
                  \n"};Renderer.prototype.tablerow=function(content){return"\n"+content+"\n"};Renderer.prototype.tablecell=function(content,flags){var type=flags.header?"th":"td";var tag=flags.align?"<"+type+' style="text-align:'+flags.align+'">':"<"+type+">";return tag+content+"\n"};Renderer.prototype.strong=function(text){return""+text+""};Renderer.prototype.em=function(text){return""+text+""};Renderer.prototype.codespan=function(text){return""+text+""};Renderer.prototype.br=function(){return this.options.xhtml?"
                  ":"
                  "};Renderer.prototype.del=function(text){return""+text+""};Renderer.prototype.link=function(href,title,text){if(this.options.sanitize){try{var prot=decodeURIComponent(unescape(href)).replace(/[^\w:]/g,"").toLowerCase()}catch(e){return""}if(prot.indexOf("javascript:")===0||prot.indexOf("vbscript:")===0){return""}}var out='
                  ";return out};Renderer.prototype.image=function(href,title,text){var out=''+text+'":">";return out};Renderer.prototype.text=function(text){return text};function Parser(options){this.tokens=[];this.token=null;this.options=options||marked.defaults;this.options.renderer=this.options.renderer||new Renderer;this.renderer=this.options.renderer;this.renderer.options=this.options}Parser.parse=function(src,options,renderer){var parser=new Parser(options,renderer);return parser.parse(src)};Parser.prototype.parse=function(src){this.inline=new InlineLexer(src.links,this.options,this.renderer);this.tokens=src.reverse();var out="";while(this.next()){out+=this.tok()}return out};Parser.prototype.next=function(){return this.token=this.tokens.pop()};Parser.prototype.peek=function(){return this.tokens[this.tokens.length-1]||0};Parser.prototype.parseText=function(){var body=this.token.text;while(this.peek().type==="text"){body+="\n"+this.next().text}return this.inline.output(body)};Parser.prototype.tok=function(){switch(this.token.type){case"space":{return""}case"hr":{return this.renderer.hr()}case"heading":{return this.renderer.heading(this.inline.output(this.token.text),this.token.depth,this.token.text)}case"code":{return this.renderer.code(this.token.text,this.token.lang,this.token.escaped)}case"table":{var header="",body="",i,row,cell,flags,j;cell="";for(i=0;i/g,">").replace(/"/g,""").replace(/'/g,"'")}function unescape(html){return html.replace(/&([#\w]+);/g,function(_,n){n=n.toLowerCase();if(n==="colon")return":";if(n.charAt(0)==="#"){return n.charAt(1)==="x"?String.fromCharCode(parseInt(n.substring(2),16)):String.fromCharCode(+n.substring(1))}return""})}function replace(regex,opt){regex=regex.source;opt=opt||"";return function self(name,val){if(!name)return new RegExp(regex,opt);val=val.source||val;val=val.replace(/(^|[^\[])\^/g,"$1");regex=regex.replace(name,val);return self}}function noop(){}noop.exec=noop;function merge(obj){var i=1,target,key;for(;iAn error occured:

                  "+escape(e.message+"",true)+"
                  "}throw e}}marked.options=marked.setOptions=function(opt){merge(marked.defaults,opt);return marked};marked.defaults={gfm:true,tables:true,breaks:false,pedantic:false,sanitize:false,sanitizer:null,mangle:true,smartLists:false,silent:false,highlight:null,langPrefix:"lang-",smartypants:false,headerPrefix:"",renderer:new Renderer,xhtml:false};marked.Parser=Parser;marked.parser=Parser.parse;marked.Renderer=Renderer;marked.Lexer=Lexer;marked.lexer=Lexer.lex;marked.InlineLexer=InlineLexer;marked.inlineLexer=InlineLexer.output;marked.parse=marked;if(typeof module!=="undefined"&&typeof exports==="object"){module.exports=marked}else if(typeof define==="function"&&define.amd){define(function(){return marked})}else{this.marked=marked}}).call(function(){return this||(typeof window!=="undefined"?window:global)}()); \ No newline at end of file +(function(){function e(e){this.tokens=[],this.tokens.links={},this.options=e||a.defaults,this.rules=p.normal,this.options.gfm&&(this.rules=this.options.tables?p.tables:p.gfm)}function t(e,t){if(this.options=t||a.defaults,this.links=e,this.rules=u.normal,this.renderer=this.options.renderer||new n,this.renderer.options=this.options,!this.links)throw new Error("Tokens array requires a `links` property.");this.options.gfm?this.rules=this.options.breaks?u.breaks:u.gfm:this.options.pedantic&&(this.rules=u.pedantic)}function n(e){this.options=e||{}}function r(e){this.tokens=[],this.token=null,this.options=e||a.defaults,this.options.renderer=this.options.renderer||new n,this.renderer=this.options.renderer,this.renderer.options=this.options}function s(e,t){return e.replace(t?/&/g:/&(?!#?\w+;)/g,"&").replace(//g,">").replace(/"/g,""").replace(/'/g,"'")}function i(e){return e.replace(/&([#\w]+);/g,function(e,t){return t=t.toLowerCase(),"colon"===t?":":"#"===t.charAt(0)?String.fromCharCode("x"===t.charAt(1)?parseInt(t.substring(2),16):+t.substring(1)):""})}function l(e,t){return e=e.source,t=t||"",function n(r,s){return r?(s=s.source||s,s=s.replace(/(^|[^\[])\^/g,"$1"),e=e.replace(r,s),n):new RegExp(e,t)}}function o(){}function h(e){for(var t,n,r=1;rAn error occured:

                  "+s(c.message+"",!0)+"
                  ";throw c}}var p={newline:/^\n+/,code:/^( {4}[^\n]+\n*)+/,fences:o,hr:/^( *[-*_]){3,} *(?:\n+|$)/,heading:/^ *(#{1,6}) *([^\n]+?) *#* *(?:\n+|$)/,nptable:o,lheading:/^([^\n]+)\n *(=|-){2,} *(?:\n+|$)/,blockquote:/^( *>[^\n]+(\n(?!def)[^\n]+)*\n*)+/,list:/^( *)(bull) [\s\S]+?(?:hr|def|\n{2,}(?! )(?!\1bull )\n*|\s*$)/,html:/^ *(?:comment *(?:\n|\s*$)|closed *(?:\n{2,}|\s*$)|closing *(?:\n{2,}|\s*$))/,def:/^ *\[([^\]]+)\]: *]+)>?(?: +["(]([^\n]+)[")])? *(?:\n+|$)/,table:o,paragraph:/^((?:[^\n]+\n?(?!hr|heading|lheading|blockquote|tag|def))+)\n*/,text:/^[^\n]+/};p.bullet=/(?:[*+-]|\d+\.)/,p.item=/^( *)(bull) [^\n]*(?:\n(?!\1bull )[^\n]*)*/,p.item=l(p.item,"gm")(/bull/g,p.bullet)(),p.list=l(p.list)(/bull/g,p.bullet)("hr","\\n+(?=\\1?(?:[-*_] *){3,}(?:\\n+|$))")("def","\\n+(?="+p.def.source+")")(),p.blockquote=l(p.blockquote)("def",p.def)(),p._tag="(?!(?:a|em|strong|small|s|cite|q|dfn|abbr|data|time|code|var|samp|kbd|sub|sup|i|b|u|mark|ruby|rt|rp|bdi|bdo|span|br|wbr|ins|del|img)\\b)\\w+(?!:/|[^\\w\\s@]*@)\\b",p.html=l(p.html)("comment",//)("closed",/<(tag)[\s\S]+?<\/\1>/)("closing",/])*?>/)(/tag/g,p._tag)(),p.paragraph=l(p.paragraph)("hr",p.hr)("heading",p.heading)("lheading",p.lheading)("blockquote",p.blockquote)("tag","<"+p._tag)("def",p.def)(),p.normal=h({},p),p.gfm=h({},p.normal,{fences:/^ *(`{3,}|~{3,}) *(\S+)? *\n([\s\S]+?)\s*\1 *(?:\n+|$)/,paragraph:/^/}),p.gfm.paragraph=l(p.paragraph)("(?!","(?!"+p.gfm.fences.source.replace("\\1","\\2")+"|"+p.list.source.replace("\\1","\\3")+"|")(),p.tables=h({},p.gfm,{nptable:/^ *(\S.*\|.*)\n *([-:]+ *\|[-| :]*)\n((?:.*\|.*(?:\n|$))*)\n*/,table:/^ *\|(.+)\n *\|( *[-:]+[-| :]*)\n((?: *\|.*(?:\n|$))*)\n*/}),e.rules=p,e.lex=function(t,n){var r=new e(n);return r.lex(t)},e.prototype.lex=function(e){return e=e.replace(/\r\n|\r/g,"\n").replace(/\t/g," ").replace(/\u00a0/g," ").replace(/\u2424/g,"\n"),this.token(e,!0)},e.prototype.token=function(e,t,n){for(var r,s,i,l,o,h,a,u,c,e=e.replace(/^ +$/gm,"");e;)if((i=this.rules.newline.exec(e))&&(e=e.substring(i[0].length),i[0].length>1&&this.tokens.push({type:"space"})),i=this.rules.code.exec(e))e=e.substring(i[0].length),i=i[0].replace(/^ {4}/gm,""),this.tokens.push({type:"code",text:this.options.pedantic?i:i.replace(/\n+$/,"")});else if(i=this.rules.fences.exec(e))e=e.substring(i[0].length),this.tokens.push({type:"code",lang:i[2],text:i[3]});else if(i=this.rules.heading.exec(e))e=e.substring(i[0].length),this.tokens.push({type:"heading",depth:i[1].length,text:i[2]});else if(t&&(i=this.rules.nptable.exec(e))){for(e=e.substring(i[0].length),h={type:"table",header:i[1].replace(/^ *| *\| *$/g,"").split(/ *\| */),align:i[2].replace(/^ *|\| *$/g,"").split(/ *\| */),cells:i[3].replace(/\n$/,"").split("\n")},u=0;u ?/gm,""),this.token(i,t,!0),this.tokens.push({type:"blockquote_end"});else if(i=this.rules.list.exec(e)){for(e=e.substring(i[0].length),l=i[2],this.tokens.push({type:"list_start",ordered:l.length>1}),i=i[0].match(this.rules.item),r=!1,c=i.length,u=0;c>u;u++)h=i[u],a=h.length,h=h.replace(/^ *([*+-]|\d+\.) +/,""),~h.indexOf("\n ")&&(a-=h.length,h=this.options.pedantic?h.replace(/^ {1,4}/gm,""):h.replace(new RegExp("^ {1,"+a+"}","gm"),"")),this.options.smartLists&&u!==c-1&&(o=p.bullet.exec(i[u+1])[0],l===o||l.length>1&&o.length>1||(e=i.slice(u+1).join("\n")+e,u=c-1)),s=r||/\n\n(?!\s*$)/.test(h),u!==c-1&&(r="\n"===h.charAt(h.length-1),s||(s=r)),this.tokens.push({type:s?"loose_item_start":"list_item_start"}),this.token(h,!1,n),this.tokens.push({type:"list_item_end"});this.tokens.push({type:"list_end"})}else if(i=this.rules.html.exec(e))e=e.substring(i[0].length),this.tokens.push({type:this.options.sanitize?"paragraph":"html",pre:"pre"===i[1]||"script"===i[1]||"style"===i[1],text:i[0]});else if(!n&&t&&(i=this.rules.def.exec(e)))e=e.substring(i[0].length),this.tokens.links[i[1].toLowerCase()]={href:i[2],title:i[3]};else if(t&&(i=this.rules.table.exec(e))){for(e=e.substring(i[0].length),h={type:"table",header:i[1].replace(/^ *| *\| *$/g,"").split(/ *\| */),align:i[2].replace(/^ *|\| *$/g,"").split(/ *\| */),cells:i[3].replace(/(?: *\| *)?\n$/,"").split("\n")},u=0;u])/,autolink:/^<([^ >]+(@|:\/)[^ >]+)>/,url:o,tag:/^|^<\/?\w+(?:"[^"]*"|'[^']*'|[^'">])*?>/,link:/^!?\[(inside)\]\(href\)/,reflink:/^!?\[(inside)\]\s*\[([^\]]*)\]/,nolink:/^!?\[((?:\[[^\]]*\]|[^\[\]])*)\]/,strong:/^__([\s\S]+?)__(?!_)|^\*\*([\s\S]+?)\*\*(?!\*)/,em:/^\b_((?:__|[\s\S])+?)_\b|^\*((?:\*\*|[\s\S])+?)\*(?!\*)/,code:/^(`+)\s*([\s\S]*?[^`])\s*\1(?!`)/,br:/^ {2,}\n(?!\s*$)/,del:o,text:/^[\s\S]+?(?=[\\?(?:\s+['"]([\s\S]*?)['"])?\s*/,u.link=l(u.link)("inside",u._inside)("href",u._href)(),u.reflink=l(u.reflink)("inside",u._inside)(),u.normal=h({},u),u.pedantic=h({},u.normal,{strong:/^__(?=\S)([\s\S]*?\S)__(?!_)|^\*\*(?=\S)([\s\S]*?\S)\*\*(?!\*)/,em:/^_(?=\S)([\s\S]*?\S)_(?!_)|^\*(?=\S)([\s\S]*?\S)\*(?!\*)/}),u.gfm=h({},u.normal,{escape:l(u.escape)("])","~|])")(),url:/^(https?:\/\/[^\s<]+[^<.,:;"')\]\s])/,del:/^~~(?=\S)([\s\S]*?\S)~~/,text:l(u.text)("]|","~]|")("|","|https?://|")()}),u.breaks=h({},u.gfm,{br:l(u.br)("{2,}","*")(),text:l(u.gfm.text)("{2,}","*")()}),t.rules=u,t.output=function(e,n,r){var s=new t(n,r);return s.output(e)},t.prototype.output=function(e){for(var t,n,r,i,l="";e;)if(i=this.rules.escape.exec(e))e=e.substring(i[0].length),l+=i[1];else if(i=this.rules.autolink.exec(e))e=e.substring(i[0].length),"@"===i[2]?(n=this.mangle(":"===i[1].charAt(6)?i[1].substring(7):i[1]),r=this.mangle("mailto:")+n):(n=s(i[1]),r=n),l+=this.renderer.link(r,null,n);else if(this.inLink||!(i=this.rules.url.exec(e))){if(i=this.rules.tag.exec(e))!this.inLink&&/^
                  /i.test(i[0])&&(this.inLink=!1),e=e.substring(i[0].length),l+=this.options.sanitize?s(i[0]):i[0];else if(i=this.rules.link.exec(e))e=e.substring(i[0].length),this.inLink=!0,l+=this.outputLink(i,{href:i[2],title:i[3]}),this.inLink=!1;else if((i=this.rules.reflink.exec(e))||(i=this.rules.nolink.exec(e))){if(e=e.substring(i[0].length),t=(i[2]||i[1]).replace(/\s+/g," "),t=this.links[t.toLowerCase()],!t||!t.href){l+=i[0].charAt(0),e=i[0].substring(1)+e;continue}this.inLink=!0,l+=this.outputLink(i,t),this.inLink=!1}else if(i=this.rules.strong.exec(e))e=e.substring(i[0].length),l+=this.renderer.strong(this.output(i[2]||i[1]));else if(i=this.rules.em.exec(e))e=e.substring(i[0].length),l+=this.renderer.em(this.output(i[2]||i[1]));else if(i=this.rules.code.exec(e))e=e.substring(i[0].length),l+=this.renderer.codespan(s(i[2],!0));else if(i=this.rules.br.exec(e))e=e.substring(i[0].length),l+=this.renderer.br();else if(i=this.rules.del.exec(e))e=e.substring(i[0].length),l+=this.renderer.del(this.output(i[1]));else if(i=this.rules.text.exec(e))e=e.substring(i[0].length),l+=s(this.smartypants(i[0]));else if(e)throw new Error("Infinite loop on byte: "+e.charCodeAt(0))}else e=e.substring(i[0].length),n=s(i[1]),r=n,l+=this.renderer.link(r,null,n);return l},t.prototype.outputLink=function(e,t){var n=s(t.href),r=t.title?s(t.title):null;return"!"!==e[0].charAt(0)?this.renderer.link(n,r,this.output(e[1])):this.renderer.image(n,r,s(e[1]))},t.prototype.smartypants=function(e){return this.options.smartypants?e.replace(/--/g,"—").replace(/(^|[-\u2014/(\[{"\s])'/g,"$1‘").replace(/'/g,"’").replace(/(^|[-\u2014/(\[{\u2018\s])"/g,"$1“").replace(/"/g,"”").replace(/\.{3}/g,"…"):e},t.prototype.mangle=function(e){for(var t,n="",r=e.length,s=0;r>s;s++)t=e.charCodeAt(s),Math.random()>.5&&(t="x"+t.toString(16)),n+="&#"+t+";";return n},n.prototype.code=function(e,t,n){if(this.options.highlight){var r=this.options.highlight(e,t);null!=r&&r!==e&&(n=!0,e=r)}return t?'
                  '+(n?e:s(e,!0))+"\n
                  \n":"
                  "+(n?e:s(e,!0))+"\n
                  "},n.prototype.blockquote=function(e){return"
                  \n"+e+"
                  \n"},n.prototype.html=function(e){return e},n.prototype.heading=function(e,t,n){return"'+e+"\n"},n.prototype.hr=function(){return this.options.xhtml?"
                  \n":"
                  \n"},n.prototype.list=function(e,t){var n=t?"ol":"ul";return"<"+n+">\n"+e+"\n"},n.prototype.listitem=function(e){return"
                • "+e+"
                • \n"},n.prototype.paragraph=function(e){return"

                  "+e+"

                  \n"},n.prototype.table=function(e,t){return"\n\n"+e+"\n\n"+t+"\n
                  \n"},n.prototype.tablerow=function(e){return"\n"+e+"\n"},n.prototype.tablecell=function(e,t){var n=t.header?"th":"td",r=t.align?"<"+n+' style="text-align:'+t.align+'">':"<"+n+">";return r+e+"\n"},n.prototype.strong=function(e){return""+e+""},n.prototype.em=function(e){return""+e+""},n.prototype.codespan=function(e){return""+e+""},n.prototype.br=function(){return this.options.xhtml?"
                  ":"
                  "},n.prototype.del=function(e){return""+e+""},n.prototype.link=function(e,t,n){if(this.options.sanitize){try{var r=decodeURIComponent(i(e)).replace(/[^\w:]/g,"").toLowerCase()}catch(s){return""}if(0===r.indexOf("javascript:")||0===r.indexOf("vbscript:"))return""}var l='
                  "},n.prototype.image=function(e,t,n){var r=''+n+'":">"},r.parse=function(e,t,n){var s=new r(t,n);return s.parse(e)},r.prototype.parse=function(e){this.inline=new t(e.links,this.options,this.renderer),this.tokens=e.reverse();for(var n="";this.next();)n+=this.tok();return n},r.prototype.next=function(){return this.token=this.tokens.pop()},r.prototype.peek=function(){return this.tokens[this.tokens.length-1]||0},r.prototype.parseText=function(){for(var e=this.token.text;"text"===this.peek().type;)e+="\n"+this.next().text;return this.inline.output(e)},r.prototype.tok=function(){switch(this.token.type){case"space":return"";case"hr":return this.renderer.hr();case"heading":return this.renderer.heading(this.inline.output(this.token.text),this.token.depth,this.token.text);case"code":return this.renderer.code(this.token.text,this.token.lang,this.token.escaped);case"table":var e,t,n,r,s,i="",l="";for(n="",e=0;ebody{font-family: sans-serif;}

                  reveal.js multiplex server.

                  Generate token'); - res.end(); - }); - stream.on('readable', function() { - stream.pipe(res); - }); + fs.createReadStream(opts.baseDir + '/index.html').pipe(res); }); app.get("/token", function(req,res) { @@ -55,7 +47,7 @@ var createHash = function(secret) { }; // Actually listen -server.listen( opts.port || null ); +app.listen(opts.port || null); var brown = '\033[33m', green = '\033[32m', diff --git a/doc/pub/Statistics/html/reveal.js/plugin/multiplex/master.js b/doc/pub/Statistics/html/reveal.js/plugin/multiplex/master.js index 7f4bf4511..b6a7eb7dc 100644 --- a/doc/pub/Statistics/html/reveal.js/plugin/multiplex/master.js +++ b/doc/pub/Statistics/html/reveal.js/plugin/multiplex/master.js @@ -1,34 +1,51 @@ (function() { - // Don't emit events from inside of notes windows if ( window.location.search.match( /receiver/gi ) ) { return; } var multiplex = Reveal.getConfig().multiplex; - var socket = io.connect( multiplex.url ); + var socket = io.connect(multiplex.url); - function post() { + var notify = function( slideElement, indexh, indexv, origin ) { + if( typeof origin === 'undefined' && origin !== 'remote' ) { + var nextindexh; + var nextindexv; - var messageData = { - state: Reveal.getState(), - secret: multiplex.secret, - socketId: multiplex.id - }; + var fragmentindex = Reveal.getIndices().f; + if (typeof fragmentindex == 'undefined') { + fragmentindex = 0; + } - socket.emit( 'multiplex-statechanged', messageData ); + if (slideElement.nextElementSibling && slideElement.parentNode.nodeName == 'SECTION') { + nextindexh = indexh; + nextindexv = indexv + 1; + } else { + nextindexh = indexh + 1; + nextindexv = 0; + } + var slideData = { + indexh : indexh, + indexv : indexv, + indexf : fragmentindex, + nextindexh : nextindexh, + nextindexv : nextindexv, + secret: multiplex.secret, + socketId : multiplex.id + }; + + socket.emit('slidechanged', slideData); + } + } + + Reveal.addEventListener( 'slidechanged', function( event ) { + notify( event.currentSlide, event.indexh, event.indexv, event.origin ); + } ); + + var fragmentNotify = function( event ) { + notify( Reveal.getCurrentSlide(), Reveal.getIndices().h, Reveal.getIndices().v, event.origin ); }; - // post once the page is loaded, so the client follows also on "open URL". - window.addEventListener( 'load', post ); - - // Monitor events that trigger a change in state - Reveal.addEventListener( 'slidechanged', post ); - Reveal.addEventListener( 'fragmentshown', post ); - Reveal.addEventListener( 'fragmenthidden', post ); - Reveal.addEventListener( 'overviewhidden', post ); - Reveal.addEventListener( 'overviewshown', post ); - Reveal.addEventListener( 'paused', post ); - Reveal.addEventListener( 'resumed', post ); - -}()); + Reveal.addEventListener( 'fragmentshown', fragmentNotify ); + Reveal.addEventListener( 'fragmenthidden', fragmentNotify ); +}()); \ No newline at end of file diff --git a/doc/pub/Statistics/html/reveal.js/plugin/notes-server/client.js b/doc/pub/Statistics/html/reveal.js/plugin/notes-server/client.js index 00b277baf..628586ffb 100644 --- a/doc/pub/Statistics/html/reveal.js/plugin/notes-server/client.js +++ b/doc/pub/Statistics/html/reveal.js/plugin/notes-server/client.js @@ -41,15 +41,10 @@ } // When a new notes window connects, post our current state - socket.on( 'new-subscriber', function( data ) { + socket.on( 'connect', function( data ) { post(); } ); - // When the state changes from inside of the speaker view - socket.on( 'statechanged-speaker', function( data ) { - Reveal.setState( data.state ); - } ); - // Monitor events that trigger a change in state Reveal.addEventListener( 'slidechanged', post ); Reveal.addEventListener( 'fragmentshown', post ); diff --git a/doc/pub/Statistics/html/reveal.js/plugin/notes-server/index.js b/doc/pub/Statistics/html/reveal.js/plugin/notes-server/index.js index b95f07188..df917f112 100644 --- a/doc/pub/Statistics/html/reveal.js/plugin/notes-server/index.js +++ b/doc/pub/Statistics/html/reveal.js/plugin/notes-server/index.js @@ -1,40 +1,37 @@ -var http = require('http'); var express = require('express'); var fs = require('fs'); var io = require('socket.io'); +var _ = require('underscore'); var Mustache = require('mustache'); -var app = express(); +var app = express.createServer(); var staticDir = express.static; -var server = http.createServer(app); -io = io(server); +io = io.listen(app); var opts = { port : 1947, baseDir : __dirname + '/../../' }; -io.on( 'connection', function( socket ) { +io.sockets.on( 'connection', function( socket ) { - socket.on( 'new-subscriber', function( data ) { - socket.broadcast.emit( 'new-subscriber', data ); + socket.on( 'connect', function( data ) { + socket.broadcast.emit( 'connect', data ); }); socket.on( 'statechanged', function( data ) { - delete data.state.overview; socket.broadcast.emit( 'statechanged', data ); }); - socket.on( 'statechanged-speaker', function( data ) { - delete data.state.overview; - socket.broadcast.emit( 'statechanged-speaker', data ); - }); - }); -[ 'css', 'js', 'images', 'plugin', 'lib' ].forEach( function( dir ) { - app.use( '/' + dir, staticDir( opts.baseDir + dir ) ); +app.configure( function() { + + [ 'css', 'js', 'images', 'plugin', 'lib' ].forEach( function( dir ) { + app.use( '/' + dir, staticDir( opts.baseDir + dir ) ); + }); + }); app.get('/', function( req, res ) { @@ -55,7 +52,7 @@ app.get( '/notes/:socketId', function( req, res ) { }); // Actually listen -server.listen( opts.port || null ); +app.listen( opts.port || null ); var brown = '\033[33m', green = '\033[32m', @@ -65,5 +62,5 @@ var slidesLocation = 'http://localhost' + ( opts.port ? ( ':' + opts.port ) : '' console.log( brown + 'reveal.js - Speaker Notes' + reset ); console.log( '1. Open the slides at ' + green + slidesLocation + reset ); -console.log( '2. Click on the link in your JS console to go to the notes page' ); +console.log( '2. Click on the link your JS console to go to the notes page' ); console.log( '3. Advance through your slides and your notes will advance automatically' ); diff --git a/doc/pub/Statistics/html/reveal.js/plugin/notes-server/notes.html b/doc/pub/Statistics/html/reveal.js/plugin/notes-server/notes.html index ab8c5b17a..72d0317f1 100644 --- a/doc/pub/Statistics/html/reveal.js/plugin/notes-server/notes.html +++ b/doc/pub/Statistics/html/reveal.js/plugin/notes-server/notes.html @@ -8,7 +8,6 @@ @@ -247,7 +152,7 @@
                  -
                  Upcoming
                  +
                  UPCOMING:

                  Time Click to Reset

                  @@ -265,10 +170,6 @@
                  -
                  - - -
                  @@ -281,20 +182,11 @@ currentState, currentSlide, upcomingSlide, - layoutLabel, - layoutDropdown, connected = false; var socket = io.connect( window.location.origin ), socketId = '{{socketId}}'; - var SPEAKER_LAYOUTS = { - 'default': 'Default', - 'wide': 'Wide', - 'tall': 'Tall', - 'notes-only': 'Notes only' - }; - socket.on( 'statechanged', function( data ) { // ignore data from sockets that aren't ours @@ -303,6 +195,7 @@ if( connected === false ) { connected = true; + setupIframes( data ); setupKeyboard(); setupNotes(); setupTimer(); @@ -313,28 +206,13 @@ } ); - setupLayout(); - - // Load our presentation iframes - setupIframes(); - - // Once the iframes have loaded, emit a signal saying there's - // a new subscriber which will trigger a 'statechanged' - // message to be sent back window.addEventListener( 'message', function( event ) { var data = JSON.parse( event.data ); if( data && data.namespace === 'reveal' ) { if( /ready/.test( data.eventName ) ) { - socket.emit( 'new-subscriber', { socketId: socketId } ); - } - } - - // Messages sent by reveal.js inside of the current slide preview - if( data && data.namespace === 'reveal' ) { - if( /slidechanged|fragmentshown|fragmenthidden|overviewshown|overviewhidden|paused|resumed/.test( data.eventName ) && currentState !== JSON.stringify( data.state ) ) { - socket.emit( 'statechanged-speaker', { state: data.state } ); + socket.emit( 'connect', { socketId: socketId } ); } } @@ -389,7 +267,7 @@ /** * Creates the preview iframes. */ - function setupIframes() { + function setupIframes( data ) { var params = [ 'receiver', @@ -399,8 +277,9 @@ 'backgroundTransition=none' ].join( '&' ); - var currentURL = '/?' + params + '&postMessageEvents=true'; - var upcomingURL = '/?' + params + '&controls=false'; + var hash = '#/' + data.state.indexh + '/' + data.state.indexv; + var currentURL = '/?' + params + '&postMessageEvents=true' + hash; + var upcomingURL = '/?' + params + '&controls=false' + hash; currentSlide = document.createElement( 'iframe' ); currentSlide.setAttribute( 'width', 1280 ); @@ -472,74 +351,6 @@ } - /** - * Sets up the speaker view layout and layout selector. - */ - function setupLayout() { - - layoutDropdown = document.querySelector( '.speaker-layout-dropdown' ); - layoutLabel = document.querySelector( '.speaker-layout-label' ); - - // Render the list of available layouts - for( var id in SPEAKER_LAYOUTS ) { - var option = document.createElement( 'option' ); - option.setAttribute( 'value', id ); - option.textContent = SPEAKER_LAYOUTS[ id ]; - layoutDropdown.appendChild( option ); - } - - // Monitor the dropdown for changes - layoutDropdown.addEventListener( 'change', function( event ) { - - setLayout( layoutDropdown.value ); - - }, false ); - - // Restore any currently persisted layout - setLayout( getLayout() ); - - } - - /** - * Sets a new speaker view layout. The layout is persisted - * in local storage. - */ - function setLayout( value ) { - - var title = SPEAKER_LAYOUTS[ value ]; - - layoutLabel.innerHTML = 'Layout' + ( title ? ( ': ' + title ) : '' ); - layoutDropdown.value = value; - - document.body.setAttribute( 'data-speaker-layout', value ); - - // Persist locally - if( window.localStorage ) { - window.localStorage.setItem( 'reveal-speaker-layout', value ); - } - - } - - /** - * Returns the ID of the most recently set speaker layout - * or our default layout if none has been set. - */ - function getLayout() { - - if( window.localStorage ) { - var layout = window.localStorage.getItem( 'reveal-speaker-layout' ); - if( layout ) { - return layout; - } - } - - // Default to the first record in the layouts hash - for( var id in SPEAKER_LAYOUTS ) { - return id; - } - - } - function zeroPadInteger( num ) { var str = '00' + parseInt( num ); diff --git a/doc/pub/Statistics/html/reveal.js/plugin/notes/notes.html b/doc/pub/Statistics/html/reveal.js/plugin/notes/notes.html index 4c5b799b5..0cc8cf612 100644 --- a/doc/pub/Statistics/html/reveal.js/plugin/notes/notes.html +++ b/doc/pub/Statistics/html/reveal.js/plugin/notes/notes.html @@ -8,7 +8,6 @@ \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", - "
                  First NameLast NamePlace of birthDate of Birth T.A.
                  0FrodoBagginsShire2968
                  1BilboBagginsShire2890
                  2Aragorn IIElessarEriador2931
                  3SamwiseGamgeeShire2980
                  \n", - "
                  " - ], - "text/plain": [ - " First Name Last Name Place of birth Date of Birth T.A.\n", - "0 Frodo Baggins Shire 2968\n", - "1 Bilbo Baggins Shire 2890\n", - "2 Aragorn II Elessar Eriador 2931\n", - "3 Samwise Gamgee Shire 2980" - ] - }, - "metadata": {}, - "output_type": "display_data" - } - ], - "source": [ - "import pandas as pd\n", - "from IPython.display import display\n", - "data = {'First Name': [\"Frodo\", \"Bilbo\", \"Aragorn II\", \"Samwise\"],\n", - " 'Last Name': [\"Baggins\", \"Baggins\",\"Elessar\",\"Gamgee\"],\n", - " 'Place of birth': [\"Shire\", \"Shire\", \"Eriador\", \"Shire\"],\n", - " 'Date of Birth T.A.': [2968, 2890, 2931, 2980]\n", - " }\n", - "data_pandas = pd.DataFrame(data)\n", - "display(data_pandas)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "In the above we have imported **pandas** with the shorthand **pd**, the latter has become the standard way we import **pandas**. We make then a list of various variables\n", - "and reorganize the aboves lists into a **DataFrame** and then print out a neat table with specific column labels as *Name*, *place of birth* and *date of birth*.\n", - "Displaying these results, we see that the indices are given by the default numbers from zero to three.\n", - "**pandas** is extremely flexible and we can easily change the above indices by defining a new type of indexing as" - ] - }, - { - "cell_type": "code", - "execution_count": 22, - "metadata": {}, - "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", - "
                  First NameLast NamePlace of birthDate of Birth T.A.
                  FrodoFrodoBagginsShire2968
                  BilboBilboBagginsShire2890
                  AragornAragorn IIElessarEriador2931
                  SamSamwiseGamgeeShire2980
                  \n", - "
                  " - ], - "text/plain": [ - " First Name Last Name Place of birth Date of Birth T.A.\n", - "Frodo Frodo Baggins Shire 2968\n", - "Bilbo Bilbo Baggins Shire 2890\n", - "Aragorn Aragorn II Elessar Eriador 2931\n", - "Sam Samwise Gamgee Shire 2980" - ] - }, - "metadata": {}, - "output_type": "display_data" - } - ], - "source": [ - "data_pandas = pd.DataFrame(data,index=['Frodo','Bilbo','Aragorn','Sam'])\n", - "display(data_pandas)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Thereafter we display the content of the row which begins with the index **Aragorn**" - ] - }, - { - "cell_type": "code", - "execution_count": 23, - "metadata": {}, - "outputs": [ - { - "data": { - "text/plain": [ - "First Name Aragorn II\n", - "Last Name Elessar\n", - "Place of birth Eriador\n", - "Date of Birth T.A. 2931\n", - "Name: Aragorn, dtype: object" - ] - }, - "metadata": {}, - "output_type": "display_data" - } - ], - "source": [ - "display(data_pandas.loc['Aragorn'])" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We can easily append data to this, for example" - ] - }, - { - "cell_type": "code", - "execution_count": 24, - "metadata": {}, - "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", - "
                  First NameLast NamePlace of birthDate of Birth T.A.
                  FrodoFrodoBagginsShire2968
                  BilboBilboBagginsShire2890
                  AragornAragorn IIElessarEriador2931
                  SamSamwiseGamgeeShire2980
                  PippinPeregrinTookShire2990
                  \n", - "
                  " - ], - "text/plain": [ - " First Name Last Name Place of birth Date of Birth T.A.\n", - "Frodo Frodo Baggins Shire 2968\n", - "Bilbo Bilbo Baggins Shire 2890\n", - "Aragorn Aragorn II Elessar Eriador 2931\n", - "Sam Samwise Gamgee Shire 2980\n", - "Pippin Peregrin Took Shire 2990" - ] - }, - "metadata": {}, - "output_type": "display_data" - } - ], - "source": [ - "new_hobbit = {'First Name': [\"Peregrin\"],\n", - " 'Last Name': [\"Took\"],\n", - " 'Place of birth': [\"Shire\"],\n", - " 'Date of Birth T.A.': [2990]\n", - " }\n", - "data_pandas=data_pandas.append(pd.DataFrame(new_hobbit, index=['Pippin']))\n", - "display(data_pandas)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Here are other examples where we use the **DataFrame** functionality to handle arrays, now with more interesting features for us, namely numbers. We set up a matrix \n", - "of dimensionality $10\\times 5$ and compute the mean value and standard deviation of each column. Similarly, we can perform mathematial operations like squaring the matrix elements and many other operations." - ] - }, - { - "cell_type": "code", - "execution_count": 6, - "metadata": {}, - "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.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
                  \n", - "
                  " - ], - "text/plain": [ - " 0 1 2 3 4\n", - "0 -1.749765 0.342680 1.153036 -0.252436 0.981321\n", - "1 0.514219 0.221180 -1.070043 -0.189496 0.255001\n", - "2 -0.458027 0.435163 -0.583595 0.816847 0.672721\n", - "3 -0.104411 -0.531280 1.029733 -0.438136 -1.118318\n", - "4 1.618982 1.541605 -0.251879 -0.842436 0.184519\n", - "5 0.937082 0.731000 1.361556 -0.326238 0.055676\n", - "6 0.222400 -1.443217 -0.756352 0.816454 0.750445\n", - "7 -0.455947 1.189622 -1.690617 -1.356399 -1.232435\n", - "8 -0.544439 -0.668172 0.007315 -0.612939 1.299748\n", - "9 -1.733096 -0.983310 0.357508 -1.613579 1.470714" - ] - }, - "metadata": {}, - "output_type": "display_data" - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "0 -0.175300\n", - "1 0.083527\n", - "2 -0.044334\n", - "3 -0.399836\n", - "4 0.331939\n", - "dtype: float64\n", - "0 1.069584\n", - "1 0.965548\n", - "2 1.018232\n", - "3 0.793167\n", - "4 0.918992\n", - "dtype: float64\n" - ] - }, - { - "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
                  03.0616790.1174301.3294920.0637240.962990
                  10.2644210.0489201.1449930.0359090.065026
                  20.2097890.1893670.3405830.6672390.452553
                  30.0109020.2822591.0603490.1919631.250636
                  42.6211022.3765470.0634430.7096980.034047
                  50.8781230.5343621.8538350.1064310.003100
                  60.0494622.0828750.5720690.6665970.563167
                  70.2078881.4152012.8581851.8398181.518895
                  80.2964140.4464530.0000540.3756941.689345
                  93.0036200.9668990.1278122.6036362.162999
                  \n", - "
                  " - ], - "text/plain": [ - " 0 1 2 3 4\n", - "0 3.061679 0.117430 1.329492 0.063724 0.962990\n", - "1 0.264421 0.048920 1.144993 0.035909 0.065026\n", - "2 0.209789 0.189367 0.340583 0.667239 0.452553\n", - "3 0.010902 0.282259 1.060349 0.191963 1.250636\n", - "4 2.621102 2.376547 0.063443 0.709698 0.034047\n", - "5 0.878123 0.534362 1.853835 0.106431 0.003100\n", - "6 0.049462 2.082875 0.572069 0.666597 0.563167\n", - "7 0.207888 1.415201 2.858185 1.839818 1.518895\n", - "8 0.296414 0.446453 0.000054 0.375694 1.689345\n", - "9 3.003620 0.966899 0.127812 2.603636 2.162999" - ] - }, - "metadata": {}, - "output_type": "display_data" - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - " 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\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 matrix\n", - "rows = 10\n", - "cols = 5\n", - "a = np.random.randn(rows,cols)\n", - "df = pd.DataFrame(a)\n", - "display(df)\n", - "print(df.mean())\n", - "print(df.std())\n", - "display(df**2)\n", - "print(df-df.mean())\n" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Thereafter we can select specific columns only and plot final results" - ] - }, - { - "cell_type": "code", - "execution_count": 26, - "metadata": {}, - "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", - "
                  FirstSecondThirdFourthFifth
                  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
                  \n", - "
                  " - ], - "text/plain": [ - " First Second Third Fourth Fifth\n", - "0 -1.749765 0.342680 1.153036 -0.252436 0.981321\n", - "1 0.514219 0.221180 -1.070043 -0.189496 0.255001\n", - "2 -0.458027 0.435163 -0.583595 0.816847 0.672721\n", - "3 -0.104411 -0.531280 1.029733 -0.438136 -1.118318\n", - "4 1.618982 1.541605 -0.251879 -0.842436 0.184519\n", - "5 0.937082 0.731000 1.361556 -0.326238 0.055676\n", - "6 0.222400 -1.443217 -0.756352 0.816454 0.750445\n", - "7 -0.455947 1.189622 -1.690617 -1.356399 -1.232435\n", - "8 -0.544439 -0.668172 0.007315 -0.612939 1.299748\n", - "9 -1.733096 -0.983310 0.357508 -1.613579 1.470714" - ] - }, - "metadata": {}, - "output_type": "display_data" - }, - { - "name": "stdout", - "output_type": "stream", - "text": [ - "0.08352721390288316\n", - "\n", - "Int64Index: 10 entries, 0 to 9\n", - "Data columns (total 5 columns):\n", - " # Column Non-Null Count Dtype \n", - "--- ------ -------------- ----- \n", - " 0 First 10 non-null float64\n", - " 1 Second 10 non-null float64\n", - " 2 Third 10 non-null float64\n", - " 3 Fourth 10 non-null float64\n", - " 4 Fifth 10 non-null float64\n", - "dtypes: float64(5)\n", - "memory usage: 480.0 bytes\n", - "None\n", - " First Second Third Fourth Fifth\n", - "count 10.000000 10.000000 10.000000 10.000000 10.000000\n", - "mean -0.175300 0.083527 -0.044334 -0.399836 0.331939\n", - "std 1.069584 0.965548 1.018232 0.793167 0.918992\n", - "min -1.749765 -1.443217 -1.690617 -1.613579 -1.232435\n", - "25% -0.522836 -0.633949 -0.713163 -0.785061 0.087887\n", - "50% -0.280179 0.281930 -0.122282 -0.382187 0.463861\n", - "75% 0.441264 0.657041 0.861676 -0.205231 0.923602\n", - "max 1.618982 1.541605 1.361556 0.816847 1.470714\n" - ] - }, - { - "data": { - "image/png": "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\n", - "text/plain": [ - "
                  " - ] - }, - "metadata": {}, - "output_type": "display_data" - }, - { - "data": { - "image/png": "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TXV1tT755BPl5eVpx44dmjJlihISEnxdltec/l7ZtWuXvvrqK/Xr108PP/ywr8vyGrvdrk8//VRHjhzRoUOHLPfdYrfbtXfvXhUUFKi8vFzjxo1TQECAT2tq8jNb//rXv5STk6OUlBTt2bNHr732mux2u6/L8oqysjItXbpUjzzyiEpLSy0VtI4fP645c+boyJEjGjRokDZu3Ki33nrL12V51aOPPuoKyidOnND69etVU1Pj67K8Jjs7W0ePHlVubq5KS0t9XY7XPfTQQzp48KB++ctfas6cOb4ux6v279+vkpISpaWlafr06erUqZOvS/Ka48eP6ze/+Y0+//xzDR8+XEOHDtXQoUN9XZZXrV69WtnZ2erfv79KSkr02muv6dSpU74uy2vWrVunQ4cOqV+/fsrKytKaNWv0/fff+7SmJh+2XnnlFXXt2lXx8fEaNWqUvvzyS+3evdvXZXnFkSNHNHr0aF1++eX69NNPJfl+KtWbxo4dq2HDhikpKUk9evRQTk6Or0vyqlGjRmn48OHq1q2bOnbsKIfDoWbN/P8je/o9mJGRoT59+shmsyk/P1+SLBUmR40apYEDB+rkyZP697//rdzcXF+X5DWvvfaanE6n8vPztW3bNkv1FhERoQULFuiJJ57Q4MGD5XQ6VVRU5OuyvGrLli3q0qWLunXrpssuu0ySFBwcbIm/Dw6HQzt37lRSUpLi4+N13XXXKTMzU59//rlP6/L/b24PVFdXq3v37vrqq68kSQkJCQoLC9MXX3zh48q8IzExUb169VJ0dLR27twpyTphq127dhoyZIiCgoIkSbGxsYqLi/NxVd41evRotW7dWu+//77279+v+Ph4ORwOX5flMZvNpgMHDigyMlK33XabbDabvvjiCxUXF1siTJ7Wvn17paenKzIyUjU1NZo9e7YOHjzo67I8VlNTo06dOmnLli1q3769YmJitGbNGm3atMnXpXlFUFCQevbsKUkqLy9XRESEoqOjfVyVd40cOVJbtmzRypUrlZ+fr5qaGhUVFVni14/KykrFx8dr+/btkqQOHTqooKBABw4c8Gld1vlmuwg2m00dOnRw/a8sIiJCrVu3dv0B93fNmjXTJZdcol69emn//v2uZVZw5pdCTk6O8vLyNHbsWJWXl/uwKu+rqalRTEyMHnroIX3wwQdavny5r0vyiu+++065ubnKzs5Wfn6+tmzZooyMDF+X5VWDBw/WpEmTlJiYqOuvv15JSUl6//33fV2Wx05/9nJychQXF6fBgwerX79+2rlzp2X+M3das2bNtHPnTvXu3dvXpXjVuHHjFB8fr7Zt22rixIn67rvvtHDhQku8fiEhIbr++uu1d+9evfvuu/riiy/Ur18/hYSE+LQua/zlvUjNmjVTv379dODAAZ04cUJBQUE6evSoa1rVCpo1a6aePXuqurpaJSUlvi7HiH379mnixIkqKytTenq6KisrfV2S1zgcDiUlJSkpKUl9+vRRZWWlJfb8ys3NVYcOHdSmTRulpqYqJiZGcXFxlviyPy04OFjBwcGSpMDAQFVUVCgyMtLHVXnOZrNp4MCBCg4Olt1uV7NmzVRZWamuXbuqqqrK1+V51SWXXKL27duruLjY16V4VVFRkd544w39/Oc/V3x8vLp3766oqCjL/Gd14MCBmjNnjtq1a6c777xTAQEBPt+Bo8nvjXj55ZcrJSVFa9asUXh4uEJDQ9WlSxdfl+VVVVVVKi0t1fTp0zVt2jT16tXL1yV5zQcffKDVq1frww8/1MGDBzVkyBBVVVXpkksu8XVpHisrK9OWLVtUUVGh0NBQ7d69WyNHjvT5XjXecMcdd7hmSN59913t3btXW7ZsUZs2bdS2bVsfV+cd5eXleuONN1RdXa3w8HCdOnXK9fOUv0tOTlbv3r21atUqtWvXTrm5uRo1apQlPndneu+99xQdHa3IyEhL7c3dvHlzXXnllXruuecUExOj3bt3a9iwYZbaI7GgoECHDh1SYWGhoqOjfb6Zic1ppf9KXiSHw6GcnBxVV1erR48eCggIsMwHy+Fw6J///Ke+/vprXXnllUpJSbFEX6etWrVKBQUFuuWWW5SUlGS5L/sPPvhAX3/9tQYPHqyYmBhLBK0z2e12FRUVKSYmRoGB1vu/30cffaTDhw/r6quvVufOnS31+pWXlysnJ0dBQUFKSEiw1Pfmabm5uXI6nYqPj/d1KV6Xm5urzz77TD179tRll11mqfemJO3cudMVIuPj432+CQ1hCwAAwKAmvc0WAACAaYQtAAAAgwhbAAAABhG2AAAADCJsAQAAGETYAgAAMIiwBQAAYND/B3waQPOjlPYaAAAAAElFTkSuQmCC\n", - "text/plain": [ - "
                  " - ] - }, - "metadata": {}, - "output_type": "display_data" - } - ], - "source": [ - "df.columns = ['First', 'Second', 'Third', 'Fourth', 'Fifth']\n", - "df.index = np.arange(10)\n", - "\n", - "display(df)\n", - "print(df['Second'].mean() )\n", - "print(df.info())\n", - "print(df.describe())\n", - "\n", - "from pylab import plt, mpl\n", - "plt.style.use('seaborn')\n", - "mpl.rcParams['font.family'] = 'serif'\n", - "\n", - "df.cumsum().plot(lw=2.0, figsize=(10,6))\n", - "plt.show()\n", - "\n", - "\n", - "df.plot.bar(figsize=(10,6), rot=15)\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We can produce a $4\\times 4$ matrix" - ] - }, - { - "cell_type": "code", - "execution_count": 27, - "metadata": {}, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "[[ 0 1 2 3]\n", - " [ 4 5 6 7]\n", - " [ 8 9 10 11]\n", - " [12 13 14 15]]\n", - " 0 1 2 3\n", - "0 0 1 2 3\n", - "1 4 5 6 7\n", - "2 8 9 10 11\n", - "3 12 13 14 15\n" - ] - } - ], - "source": [ - "b = np.arange(16).reshape((4,4))\n", - "print(b)\n", - "df1 = pd.DataFrame(b)\n", - "print(df1)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "and many other operations. \n", - "\n", - "The **Series** class is another important class included in\n", - "**pandas**. You can view it as a specialization of **DataFrame** but where\n", - "we have just a single column of data. It shares many of the same features as _DataFrame. As with **DataFrame**,\n", - "most operations are vectorized, achieving thereby a high performance when dealing with computations of arrays, in particular labeled arrays.\n", - "As we will see below it leads also to a very concice code close to the mathematical operations we may be interested in.\n", - "For multidimensional arrays, we recommend strongly [xarray](http://xarray.pydata.org/en/stable/). **xarray** has much of the same flexibility as **pandas**, but allows for the extension to higher dimensions than two. We will see examples later of the usage of both **pandas** and **xarray**. \n", - "\n", - "\n", - "\n", - "## Reading Data and fitting\n", - "\n", - "In order to study various Machine Learning algorithms, we need to\n", - "access data. Acccessing data is an essential step in all machine\n", - "learning algorithms. In particular, setting up the so-called **design\n", - "matrix** (to be defined below) is often the first element we need in\n", - "order to perform our calculations. To set up the design matrix means\n", - "reading (and later, when the calculations are done, writing) data\n", - "in various formats, The formats span from reading files from disk,\n", - "loading data from databases and interacting with online sources\n", - "like web application programming interfaces (APIs).\n", - "\n", - "In handling various input formats, as discussed above, we will mainly stay with **pandas**,\n", - "a Python package which allows us, in a seamless and painless way, to\n", - "deal with a multitude of formats, from standard **csv** (comma separated\n", - "values) files, via **excel**, **html** to **hdf5** formats. With **pandas**\n", - "and the **DataFrame** and **Series** functionalities we are able to convert text data\n", - "into the calculational formats we need for a specific algorithm. And our code is going to be \n", - "pretty close the basic mathematical expressions.\n", - "\n", - "Our first data set is going to be a classic from nuclear physics, namely all\n", - "available data on binding energies. Don't be intimidated if you are not familiar with nuclear physics. It serves simply as an example here of a data set. \n", - "\n", - "We will show some of the\n", - "strengths of packages like **Scikit-Learn** in fitting nuclear binding energies to\n", - "specific functions using linear regression first. Then, as a teaser, we will show you how \n", - "you can easily implement other algorithms like decision trees and random forests and neural networks.\n", - "\n", - "But before we really start with nuclear physics data, let's just look at some simpler polynomial fitting cases, such as,\n", - "(don't be offended) fitting straight lines!\n", - "\n", - "\n", - "### Simple linear regression model using **scikit-learn**\n", - "\n", - "We start with perhaps our simplest possible example, using **Scikit-Learn** to perform linear regression analysis on a data set 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 $\\hat{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 $(\\hat{x},\\hat{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.\n", - "\n", - "The Python code follows here." - ] - }, - { - "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": [ - "# 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+0.01*np.random.randn(100,1)\n", - "linreg = LinearRegression()\n", - "linreg.fit(x,y)\n", - "#ynew = linreg.predict(x)\n", - "#xnew = np.array([[0],[1]])\n", - "ypredict = linreg.predict(x)\n", - "\n", - "plt.plot(x, 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 \\hat{y} -\\hat{\\tilde{y}}\\vert}{\\vert \\hat{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": 30, - "metadata": {}, - "outputs": [ - { - "data": { - "image/png": "iVBORw0KGgoAAAANSUhEUgAAAfsAAAFnCAYAAAChL+DqAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAALEgAACxIB0t1+/AAAADh0RVh0U29mdHdhcmUAbWF0cGxvdGxpYiB2ZXJzaW9uMy4yLjIsIGh0dHA6Ly9tYXRwbG90bGliLm9yZy+WH4yJAAAgAElEQVR4nO3deXRU5f3H8c8kITEmQWBIgRhorUfDJiC1HFOrcHBBPIpgtRZUqtgGZVFUUOlPJVrqEhUtuCJK0VZR0Vg0WlBqRA2KbcRqRKpokL2QGEIWsj6/PzAjgdkzN5l5eL/O4ejMPHPvd557cz9zn7uMyxhjBAAArBXX0QUAAABnEfYAAFiOsAcAwHKEPQAAliPsAQCwHGEPAIDlCHsgSrz//vs6//zzlZWVpUsvvVSXXHKJzjrrLM2aNUs1NTUB3//8889r5MiRuvnmm8Ou4bzzztOmTZvCfj+A6OTiOnsgenz44YeaOHGiSkpKlJCQoD179mj06NEaP368pk+fHvD9CxYs0NatW3X33XcHbHvzzTfr6KOPbjXdyspKde7cuU2fAUD0Yc8eiGJHHXWUTjrpJH322WftMj+CHrBTQkcXAMC/xsZG9ejRw/P422+/VW5ururr69Xc3KyZM2dq6NChXt/78MMPa/Xq1UpKSlJycrLuuOMO9ejRQ0uWLNG7776rpKQkrV27VmPGjNHGjRu1bNky/eEPf9BRRx2lW265RcnJyZo5c6bOOeccXXbZZfr666911113KTs7W/PmzdPHH38sl8ulU045RVOnTpXL5TqkhoaGBq9tGxoadOWVV2rt2rW67bbb9Pbbb+vDDz/UNddco9dee0179+7VhAkT9NZbb+njjz/Whg0bVFpaqj/+8Y/at2+fmpqaNGXKFJ122mn6z3/+o1tvvdXrewBIMgCixgcffGCOP/5409DQYIwxZuvWreaqq64yO3bsMMYY09jYaM4++2zz4osvGmOMWb9+vRk2bJjZu3evMcaY+fPnm5tuuskzvaeffto0NzcbY4x56aWXzMyZMz2v3XTTTWb+/Pmt5n/ppZeal156yRhjzJIlS8wVV1zhee3NN980zz//vDHGmEceecRcdtllprGx0dTX15uLL77YvPLKK14/U6C2xx9/vFmwYIExxpjly5ebzz77zHzwwQdmwIAB5v333zfGGHP33XebhoYGM2rUKE99mzZtMieeeKLZtGmTp+8Ofg+A/RjGB6LQ5ZdfrjFjxmj06NE65ZRTPHv269at0+bNm3X++edLkvr27asePXqosLDQ63R69eqliRMn6pJLLtGSJUtUUlISdA3nnnuuPvroI+3cuVOS9I9//EOjR4+WJOXn52vcuHGKj49Xp06ddPbZZ2v58uVepxNM2zPOOEPS/hMEBwwYIElKTk7WL37xC0nSTTfdpE8++URbtmzRmDFjJEl9+vTR4MGDW03r4PcA2I9hfCAK/eUvf1FcXJzuu+8+5eXlafTo0XK73Z7gnTRpkqdtfX299u7de8g0SktLNWPGDD377LMaNGiQPvzwQ82ePTvoGrp166ZTTjlFf//733XxxRcrPj5eaWlpkqQdO3Zo8eLFevnllyVJ1dXVPo/3B9M2NTX1kPe1zKvFzp071blzZyUk/LDZ6tatm6dPvL0HwH6EPRCl4uLiNH36dOXn52vp0qWaOnWqevbsqU6dOumZZ57xtKupqVFc3KGDdJ9//rlSUlI0aNAgSfuP/Ydq7Nixmj9/vtLS0jx79dL+EYOrr77a81xzc7MqKyu9TiOUtv707NlTlZWVamxs9AR+eXm5jjnmmJCnBRxuGMYHolhycrImTpyo5557Tg0NDRo8eLB69eqllStXStof4FOnTlVpaekh7/3xj3+syspKffPNN5Kkd999t9XrKSkpqq2tVU1NjW644Qav8x85cqR2796tF154Qb/85S89z48bN06vvfaampqaJO0fqn/ssce8TiOUtv4MHjxYffr00WuvvSZJ2rx5sz755BPPsD4A3+Jzc3NzO7oIAPtvqnP33Xdr9+7d+uijjzRo0CB169ZNffv21aJFi/Tmm2/quOOO08UXX6yHH35YL774ol5++WWdf/75Ou200/T888/rr3/9q77++mvV19frnHPOUWNjo+6991598MEHSkxM1L///W+VlpbqzDPPVOfOnbVo0SIVFBRo7Nixys/P1+rVq7V+/XplZmbqJz/5ieLj47Vlyxb16dNHw4cP99Q6ePBgbdiwQfPnz9fy5ctVUVGh2bNnq1OnTod8Ln9tJ02a5AntzMxM9e7dW1999ZVuvfVWbd26VWvWrNHIkSN1xBFHKC4uTqeeeqqeeOIJPf/881qxYoVuueUWDR482Od7AOzHTXUA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\n", - "text/plain": [ - "
                  " - ] - }, - "metadata": {}, - "output_type": "display_data" - } - ], - "source": [ - "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 = 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": 31, - "metadata": {}, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "The intercept alpha: \n", - " [1.92115887]\n", - "Coefficient beta : \n", - " [[5.06920615]]\n", - "Mean squared error: 0.26\n", - "Variance score: 0.89\n", - "Mean squared log error: 0.01\n", - "Mean absolute error: 0.39\n" - ] - }, - { - "data": { - "image/png": "iVBORw0KGgoAAAANSUhEUgAAAfIAAAFnCAYAAABdOssgAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAALEgAACxIB0t1+/AAAADh0RVh0U29mdHdhcmUAbWF0cGxvdGxpYiB2ZXJzaW9uMy4yLjIsIGh0dHA6Ly9tYXRwbG90bGliLm9yZy+WH4yJAAAgAElEQVR4nO3de3hU1bk/8O8kQ4IhGQlkgiBHRVrAAEGqrYJwCCoigkJyQImIP7RKDgiCoGJBxCNWA1ZExAuXYq0/D1iioSAFqcUoJaJQJUC4q4AhXHJlEoYkZLLOH2lGktlz39fZ38/z9HmaPZe9ZiXyzlrrXe+yCCEEiIiIyJCitG4AERERhY6BnIiIyMAYyImIiAyMgZyIiMjAGMiJiIgMjIGciIjIwBjIiQBs374dI0eORPfu3fHAAw+gsrLS4zl33303jh8/rkHrmisvL8f48ePRvXt33HPPPRg/fjyGDx+O8ePH48cff9S6eQFbtmwZ3nzzTUXe++zZsxg3bhzGjh2LjIwMbNiwAXPmzFHkXkRas3AfOVGjr7/+Gg8++CAKCwthtVo9Hnc4HLDZbBq0TFr37t3x7rvvon///mhoaMDEiRNRW1uL999/X+umBaSurg5CCMTGxsr+3osXL0ZZWRnmz5+P3NxcDB06FEIItGnTBgDwzDPP4Morr8TUqVNlvzeR2jgiJwqQnoJ4S1FRUUhLS8O+ffu0bkrAYmJiFAniAHDmzBkkJycDANLT0xEXF+cO4kSRxnPYQUQesrOzkZOTg9mzZyMjIwNTpkzBF198galTp2L37t04cuQIJkyYgHHjxgEALl68iEWLFuG7776DxWLBLbfcgsceewwWiwVHjhzBggULUFNTg4sXLyIjIwP33XcfALjfd9q0adi1axe++eYbPPvss8jIyPDbxvr6enTo0MH98/nz5/Hiiy/i2LFjEEJg5MiRyMzMBAA4nU7MnTsX33//PZKTk3HttdciJycHI0aMwMCBA/HKK68gKSkJvXv3xldffQWHw4GtW7di3759ePnll2GxWBAdHY3nnnsOXbt2RUNDA/7nf/4Hhw8fRnR0NK6++mrMmTMHcXFxWLp0KbZt24aYmBi0b98es2fPxpEjRzB//nzY7Xb3DMKxY8cwf/581NTUwOVyYfLkyfjP//xP7NmzB3PnzkVVVRXuv/9+5OXl4dy5c1iyZAm6dOni0Q9Lly7Fl19+idjYWHzzzTeYM2cOZs2ahaqqKmzduhXvvfcetm3b5n78nnvuwZgxY8L+GyHSjCAiIYQQO3bsEN26dRMXL16UfPyBBx4QH330kfvnwYMHi3nz5gkhhCgoKBDXX3+9+7VvvfWWGD9+vKivrxd1dXXivvvuE+vWrRNCCLF7926xe/duIYQQdXV14s477xQ//vhjs/d95plnhBBCfPXVV+Lzzz+XbE+3bt3E9u3bhRBCOJ1O8fTTT4uvv/7a/ficOXPEU089JYQQoqqqStx6661i586dQgghFixYIH77298Kl8slamtrxb333iseeOAB92s/+ugjkZqaKo4ePSqEECI7O1s4HA5x0003ifz8fCGEEJ9//rm44447hMvlEnl5eeK3v/2t+/WTJ08WP/30kzhy5IgYNmyYaGhoEEII8fvf/17s2LHDfY+me168eFEMHTrU3b/Hjx8Xffv2FcePH3f/bnr27Olu/7x588TcuXMl+0UIIWbNmiWWLFni/nnHjh1i8ODBXh8nMjJOrROFYeDAgQAa16udTifKysoAALm5uUhPT0d0dDRatWqFO++8E+vXrwcAXH311cjJycHYsWPx8MMPo6SkBPv372/2vrfddhsA4Oabb0ZaWprX+2dnZ+O+++7DzTffjPr6evz6178GADQ0NOCvf/0rRo8eDQCIj4/H4MGD3W3YvHkzRowYgaioKMTExODOO+/0eO8uXbqga9euAIBZs2bh888/R1xcHPr16wcASEtLQ2lpKQoKCmCz2XD48GFs374dDQ0NWLRoETp16oQ2bdqgtLQUW7ZswcWLF/Hkk0/ihhtu8LhXQUEBioqKcM899wAArrrqKvTp08fdXgCIi4vDjTfe6O7voqIir/1CZCacWicKQ3x8PAC413ovXrwIADh9+jTeffddfPzxxwAap7mb1tizs7PhcDjwwQcfIDo6GuPHj0dNTU2z901ISAjo/s888wz69++PrVu3YtKkSRg+fDhuvfVWlJeXo66uDq+88gpat24NoDFZ77rrrgMAlJSUIDEx0f0+l19+ucd7t2zD6dOnce7cOYwfP959rV27dqisrMTgwYMxf/58rFixArNnz8Z9992HrKwsdOzYEcuWLcOKFSvwwgsv4O6778a0adM8kgnPnDkDm83W7Hq7du1w5swZ989NfQ009ndTXxOZHQM5kQ9VVVX417/+5XNULKVjx46YNGkShg0bBqBxhOxwOAAAe/bswf3334/o6GgAkCUg3XrrrUhLS8N7772HW2+9Fe3atUNMTAzmzp2L1NRU932avjDY7XZUVFS4Xy+13U7qM11xxRXNsuKrq6sRExODqqoq/OY3v8GgQYNw4sQJPPLII+jQoQPuuusu/OIXv8Bbb72FkpISTJ06FStWrMDjjz/e7L2vuOIKOBwO1NfXu4N5eXm55Bo4ETXHqXUiH86dO4fNmzcH/br09HR88skncLlcABqn2t955x0AjdPGBQUFABr3Ox86dEiWtk6cOBE7duzAoUOHEBUVhVGjRjWbmn777bexbt06AMCwYcOwYcMGNDQ0oK6uDp999pnf9x88eDAqKyuxZ88eAI0Jcw8++CCqq6vx97//HR9++KH783Xo0AENDQ3Ys2cPlixZAqDxy0OXLl3cfXKpPn364KqrrsInn3wCAPjpp59QUFDgnmqXW5s2bXDhwgU4nU7MnDlTkXsQqSX6+eeff17rRhBpbdeuXViyZAmKi4tx9OhRbN68GZs2bcJnn32GuLg47Nq1C19++SUOHDiAzp0746233kJBQQH27duHAQMGYM6cOfjhhx9QUFCAIUOG4KabbsKhQ4ewZMkSrF+/HpWVlfjd736HVq1a4brrrsOHH36Ijz/+GIcOHUJNTQ127tyJrl274o033nC/b3x8PLp37+7R1vLyckycOBEnT57EwYMH3c/r1KkTvv76a6xduxZRUVF49NFH8fnnn2PFihVYt24dbDYbJk2ahKioKPTt2xdfffUV3n77bfzzn/9EamoqTp06hYyMDHz11VdYtGgRTpw4gR07dmDkyJEAGreL3XTTTVi4cCE+/vhjrF+/HpMmTUJKSgpiY2OxevVqrF27Fh988AG6du2KrKwsxMXFYdOmTfjggw/wl7/8BVarFU899RR27dqF1157DSdOnMCZM2eQlpaGgQMHYsWKFfjwww/x6aef4tlnn0WfPn1w9OhRzJ07FydPnsTp06fRvn17ZGdn48SJE6isrMQtt9zSrH+WLl2KjRs34siRI9izZw+uueYaPPfcc+7+GjZsGGw2G1auXImNGzdi1KhRkv1MZBQsCENkQufPn0erVq0QExMDAFi5ciX27duHxYsXa9wyIgoWp9aJ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VdtqVIH08TPPPIMxY8ZgxIgRKC8vxx133IHPPvsMbdu2Vbu5ESvUuKfJiPz6669HcXEx6urqAADffvst0tLSUFlZ6Z5GSEtLw3fffQcAOHToEHr06IH4+HgtmmtYgfRzTU0N5s2bh4ceegi9evXCp59+qmWTDcdfH3fs2BHZ2dmYOHEiJk6cCKBxZMMgHrhA/o779euHn376CUDjP34ulwt2u12zNhtNIH186tQpd5/abDZERUWhoaFBszZHCjninma11rdv345PP/0UiYmJaNWqFaZMmYKFCxeibdu2mDhxImpqarBgwQLY7XacOHECWVlZzFoPgb9+njJlCo4cOYLk5GQAgNPplMymJO/89THQuKa4Zs0avP7665g8eTLGjh2LDh06aNxy4/DXx1VVVXjllVfQqVMnnDhxAkOHDsWgQYO0brah+OvjXbt24c9//jNSUlJQVFSEnj17IjMzU+tmG8o333yDdevWYdu2bcjMzMTDDz+MJUuWhB33eGgKERGRgbEgDBERkYExkBMRERkYAzkREZGBMZATEREZGAM5ERGRgTGQExERGRgDORERkYExkBOZ3O9+9zssXboUAHDs2DEMHToUhYWFGreKiALFgjBEJnfmzBlkZGRgxYoVePLJJ/HCCy/gxhtv1LpZRBQgTQ5NISL96NChA0aNGoVx48ZhyZIlDOJEBsOpdSKTKysrw5dffonLLrsMHTt21Lo5RBQkTq0TmZjD4cCECROQlZWF8vJyfPHFF3jnnXe0bhYRBYEjciKTunDhArKyspCZmYmhQ4dizJgxOHbsGHbs2KF104goCByRExERGRhH5ERERAbGQE5ERGRgDOREREQGxkBORERkYAzkREREBsZATkREZGAM5ERERAbGQE5ERGRg/wfemR2en+GFBQAAAABJRU5ErkJggg==\n", - "text/plain": [ - "
                  " - ] - }, - "metadata": {}, - "output_type": "display_data" - } - ], - "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(\\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": [ - "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 $\\hat{y}$,\n", - "disregarding the input features, would get a $R^2$ score of $0.0$.\n", - "\n", - "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" - ] - }, - { - "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": [ - "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}(\\hat{y}, \\hat{\\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}(\\hat{y}, \\hat{\\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}(a)={\\begin{cases}{\\frac {1}{2}}{a^{2}}&{\\text{for }}|a|\\leq \\delta ,\\\\\\delta (|a|-{\\frac {1}{2}}\\delta ),&{\\text{otherwise.}}\\end{cases}}}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Here $a=\\boldsymbol{y} - \\boldsymbol{\\tilde{y}}$.\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": 27, - "metadata": {}, - "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": [ - "### To our real data: nuclear binding energies. Brief reminder on masses and binding energies\n", - "\n", - "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": 1, - "metadata": {}, - "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": 2, - "metadata": {}, - "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": 30, - "metadata": {}, - "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": 3, - "metadata": {}, - "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": 4, - "metadata": {}, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "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", - "... ... ... ... ... ...\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", - "\n", - "[267 rows x 5 columns]\n" - ] - } - ], - "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 $p\\times n$, 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": 5, - "metadata": {}, - "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": [ - "With **scikitlearn** we are now ready to use linear regression and fit our data." - ] - }, - { - "cell_type": "code", - "execution_count": 6, - "metadata": {}, - "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": 7, - "metadata": {}, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Mean squared error: 0.04\n", - "Variance score: 0.95\n", - "Mean absolute error: 0.05\n", - "[ 0.00000000e+00 7.06492086e-03 -1.73091052e-01 -1.66020213e+01\n", - " 1.17385778e+00] 15.212327334149508\n" - ] - }, - { - "data": { - "image/png": "iVBORw0KGgoAAAANSUhEUgAAAesAAAFZCAYAAAC48QffAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAALEgAACxIB0t1+/AAAADh0RVh0U29mdHdhcmUAbWF0cGxvdGxpYiB2ZXJzaW9uMy4yLjIsIGh0dHA6Ly9tYXRwbG90bGliLm9yZy+WH4yJAAAgAElEQVR4nO3deZhcZZ3//fdZau/qvTvpzr6xxBBWcQHZEVFElNFn1MHRmXHUEZxHh3F+Az91Zhx4dBwdhJ+oGUZxQMcVkZGfEgYERRbBEARCyEL2XtJJ713rOed+/qjuTkIS0iHd1VV9Pq/r4kpVdfU5d91XkU++59yLZYwxiIiISMWyp7sBIiIi8soU1iIiIhVOYS0iIlLhFNYiIiIVTmEtIiJS4RTWIiIiFc6d7gYcTk/P0KQdq6EhSV9fZtKON9OpvyZOfTVx6qujo/6auJnUVy0t6UO+HorK2nWd6W5CVVF/TZz6auLUV0dH/TVxYeirUIS1iIhINVNYi4iIVDiFtYiISIVTWIuIiFQ4hbWIiEiFU1iLiIhUOIW1iIhIhavYRVFEREQOZWRkmCuuuJRbblnFCSeceMzHe+yxR/jVrx5g4cLFbN68kfPOu4A3vek8ADZufJG77voRbW3t9PX18fGP/zWuW4rOBx64n29+8//w1399LWed9abx4z333LM89dQTWJbFmjW/57rrPsusWbOPqY0KaxERqSqrV/+Ss88+l3vuuYsTTrj+mI/X3d3Nn//5R5g1aza9vXt573vfxS9+8Sssy+Kf/ukz3HTTrTQ1NXPLLf/GL3/5cy677Ao6OnbR0NBAa+usA441MjLMf/3Xf3LDDV8C4KKLLqG2tu6Y26iwFhGRo/azR7awtXNwUo+5sK2Wd5y96Ijv27lzO5/4xKf4kz95N1df/UmefnoT//t/f5aTTz4F3/fZuHED73vfVaxZ8xTr17/AJz/5t5xwwnJGRob56le/zLx589m9ezdnn30Or3vdG7jiiivHjx0Ehng8gW3b7Nq1k3w+T1NTMwArV57Mfff9gssuu4L29jm0t8/hW99adUDbHnvstyQSSb7//TvJZrMsXLiI88+/6Jj7RvesZUKKno8xhmze44WtvXT3ZhgYKbB24x469oxgjGFwpIDnBwxnizz2fBfbu0vru/tBgDFmmj+BiMwEzz//HCtXnkpDQyOve90buf/+X3LqqafypjedS01Nmmuv/XsuvPBifv3rX/HJT36a973vA/ziFz8H4I47bmfu3HlcddWHuPrqv+Zf/uUGPM874Pjf+953+OQn/xaAvr5eksnU+M+SyRR9fb2v2L6urk7WrXuOP/qjP+ZP//TP+clPfsiaNU8d8+dWZS3jil7Axp39LPINa9d384f1PdRZEWJFm97ODMnAgWxAkA+wi2D5YHuwyQMXm8ALcCwLgMA3dBl4IeqQLfjE4y5NDXFwLGrrotTXxegbyZOujVGTjmDHbayYjRW3sRMWVswuvRYffZywsWIW1ujxRWR6TaQCngoPPriaeDzBpk0biEQi/Oxnd/EXf/GnAMyZMxeAmpo07e2lx+l0mkymtMnH5s0bqa2t4447bgdgyZKlDA0N0tDQCMD3vncHixcv5bzzLgSgoaGRTGZk/NyZzMj4ew8nlaph2bLjx+9rv+Y1J/H007/ntNPOOKbPrbAOKeMbvN1Fcp15tqzrJ56B7esHyO0u0JHZjjMccLwHUASgAYAAgHjUoegFBMaQiLnkCj5B4GPbFkFQek8i5pAr+BjjEaN0nJHRY40AnaPt6LYgFY8A4DoWjmOTL/hEIzbJmEu24OM6NsmYQ2CDm3ZwahxyriFS55Ksj2ASNk7axk27mISFU+cQqXPpt4pE6lwa0nGyeY980Wc4U2Tdtj4c22LZ3Drqa2KkEi6OrYtMIpVuZGSYmpo0H/rQh8dfe8973sFzzz03od9fuvQ4GhubePe7/xiAX/7y3vH7ybfffhvz5s3nwgvfzJo1T7FkyVLa2+cQi8XYu3cPTU3N/OEPz/DGN571iuc47bQz+OUv7x1/3tXVyVlnnXO0H/UgCusQ8Ac8Ci/lKWzJU9hZwOsoUOwsEngB3b1ZsvnSZSAXqHcsXNfG2BaNrXFI2QRxi7pZMbwoWAmbVF0UEwErauHGHXwXiiYgkXTJ5jwCoCYVIVf0Gc4WqU/H2N2XYaA/Dx7s7B4il/GpT0QZHCxgeR52kdJ/HjhFM/o8jw04WYgMW5iCwbYtHNui6JX+URCN2BSKAbZtEXFLQb//e4wNVtomGw3wElBMWHhJ8BKwM7kHLwlWnUPb0jTxlEtjbZwT5jcQi878XXxEqkmhUOBLX/r/iEQi469t27aV2to6/uVf/oVi0eellzaxYsVKfvvbXzM0NMT27du4777/y+bNG1m37jmuuuqD3Hrrzdx++22MjIzQ3j4Hx3H40Y++z49//AMWLlzET3/6Y/bs6eHf/u1r1NXV89nPfp5Vq25l9uw2giDgLW+5DABjDN/5zn/Q3d3Fgw+uxnVdXve6N7BgwUIuueSt3HrrV3Ecl+bmZi666M3H/PktU6E3EydzP+uWlvSkHq+SGWMo7iiQez5LfmOOwuYc3l4P3zcMZwskYi5FL6B/OE+hBoZTAabeIdIaIdLkcuqZs1l4UjP9fq50CXoKLjsbYwiMwbFtdvdn2bV7mFjUoW8oz0jOo6U+zsYdA/QMZJk/K83uvgzDmSIRY2EyAW4OUsbBH/axswa3YOHkDE4O3Dw4WUMkA7G8hZ0zBAYsCxy79HlSiQgYQzbv4wUBvl/6X8CPQTEFXo2F3eCSbI3SuqgGU2sTb40y//ha3Br3gD4J03frWKmvjo76a+JmUl8dbj9rVdYzgDfo0fNoP+5mj/zzWfxBHyiFYq7gE006bI3n2NPmkW8qkq2HfAMEEYuIG+Fd5y5hdmNy/Hixlhh2T2HK2mtZ1vi97db6BK31iYPec+qylvHHfhAwkvWoSUYYzhQZzBRoa0qSK/jsHcgxqyFJvujTN5RndmPpcf9wnvbmFEHep7czS23gYg0b/H4ff9DDH/Dx+32CAY+R3QUy3XlMISAz4pHt9WF7ESiym333q3bZFlbEwm50aJibxGpw6FxUQ2p2BLc5QqTZxW2KYLm6ry4ik0thXUX8oHTZenZjEpMJGHxiiOzjw+x4tJds1qMmESGdjDAU8Ym9JsH2mjw74nny9YBtkYhHyRdKQX72yjbam1LUpqIkYpX9NXBsm9pUFIDaVHT8cSpuj9/vjkWd8df3f0zSZvaSyMEHfRljDMFIgL/XI7u7wEhXjt3bRhjYmSU6Avk9BbxeHztv8DsDdncOANBj94ExGMC2LdKpKE6Dg93kUj8/gal3iLZGqJ2bwGmJ4Da6WBGFuYgcncr+W1rGGWP45WPb2P3oAIu3R0htCxgeLg3YMjYMz4NdCzyG5vqlcLZK96FjURfbC4hHHd59/lJcxyYIzL4wE2C02q8pDV6LLohRR5p29lX3xhiGs0UKwz47Ngywa9MgiREo9PqM7MwRHTJEhwz+UB4GgW3Qs2bfHNSxe+CWBalZMZwmF6fFpWlhCtPk4LRGqJ2fwKl3NOJdRA6isK5A2bzHls5BlsypIxYp3Ztd992dRO/tY9EwGPIMWzA8z6J/qYVzcoJTTm7lwTU7CQLDysVN9A7miLo2F54+D9exsCyIuBo09WpZlkU6GYUkNLUmOOXs0tKBzc01bN/ZRzTi0Lk3w4atfbgDASNdeQZ25EhlbdjrYQ/6xAYhMgK57RnYXjpuJ/vmbMaiDrgWQaNNak6MoNHBNNo0L6khaLCxmlzmttXgOhq5LhI2CusK4wcB9/x2C117M6x5qpvlW2PkHh6iMOITARoWJdmx2CezMsJF586nviaGZZXCZG5LafJ+OqmquVwsyyI5eil+XmsN81prDnpP0fPZtWeEqOvQ159j+8YB3AFDobvIyM4cqYyF0xfg9/s4GSAD/Tv3jRkYGgt0CzalLYr1Fl69RdOiFLG2GHazw7zl9aQbYziOpTAXmYEU1hWi6AXs2D3M1q5BdneO0Pa0oeUPWQa9LACZBTatVzSx8vK5rIRDXipVSFemiOuwcHYtAO3NKV6ztGn8Z8YYLMui6Pns7BnBzhmynXl2bxomOmBgr09mV57YIFgDPgwGuIMGtkPhD4OMRfoAXfhxKNRbxNqjBM0OXoNF+wm1JOfGcZIOsxuTxMcvx+tSu0g1UVhXiF8/08Fzm/bQtM6w/ClDeyJJIeGTO96l7vIGlry+SZexZ6Cx0Iy4DovaSoHOIjjhja0Hvdd4hoGdWdjjMbQzR/eGIdjr4/cUyXcWsAvgdBnoKs1Pd4FeRuilNK98XT3k6yy8BpuaBQmcVgev0WbenDTpZBTHtpjVkNQcc6lY69Y9x6233oznebz2ta8DSvOvHcfwxBNPsmrV7TiOw69//RDLlh1HW1v7NLd48iisK0Am5/HS070se8DQMuiQikdoWFlDw/uaiS2NT3fzpEJYrkX9wiQshPozapnHvkA3pjQtbWR7thTiPT5eV5GBbRns3gBTNES6fFKdBvDhsWEAYkB3qo/tdaUgLzRYFBtKl9pr5yeIpyI4tsXclhqa6uIkog4N6Zgqc5kWy5ev4NRTTyebzfLnf/4RAPL5PBs3PsuHP3zN+PfyN795iJqaGoW1TB7jG1749x0svccjFXFpW5ym8QMtJF6b0l+IMmGWZeE2uNQ1pKk7+cBFFYwx+Hs8Cl0FvK4i2Z15el8agT0+QY9HNlsk6IVgjyFf9BlfJskaolAD+TrYUNdLoQ5yDRapeXEWnFhHc0OSebNqiEVUiYfR7i91kH0mM6nHTJycpPVvJx6wnufxjW/8H84//028+92Xc8st36Svr5eNGzcAP+f550urls0ECutp9PzaHnZ+ZRfxXQGWgaa3N9D+5+3YKf3lJ5PHsizclghuSwROglpgbAde4xu8PR7eaJAXugoUOosUOgpkO/OloB82ZEdXwSt6AX6QIetk2FQH6xosIm1R7Fkus0+oZc7yWmqb40QV4DKF1qx5iq9+9cvjYz4uvPBCVq26DShV38uWHcell152zJtnVBKF9TQZfnqYns/uIjYSUEhB5o9SnPuBuaqmpawsxyIyK0JkVgROPvBnxjN4PUW8riLFziLFzgKFjgL9WzLk9xTIDfvken3YnAfy9DFCH514CYjNiVK7IEl8bozW42uoWZAgaAim5TPK1DiaCniynXbaGVx99f+LMYYdO7ZPWzvKSWFdZh17Rnjxvzqovz8PIwH+sgiv+6dl1LToPqBUFsstVc2RtiiJU/e93gYEmYBiV4GR7TmGtmUZ2Zajf8sIQbeHlQvwNxXo21Qaq95JNxHXJhJziLS6pObFcWZHaFyaIjE3TqQ9ip229f2Xo2ZZFvPnLzjodXt0F72dO3fQ2NhEMpk86D3VRmFdRsYY/nDzVuKP5BkAus6wOOXjc6idpUFkUl3spE1scZzY4jiN1I+/boxhpDPPS8/0MrQ1S25XnuyOPNH+gHjGkNlSZGBLaTriTgsiro1tWbg1Du7o5fTaBQnqFieJz4kRa49iRzVvXErWr1/HM888TbFY5MEH/4cLLrgIgIceeoju7i7uvvsnfOxj13DGGWfy3/99N0EQ8Pd//9lpbvXk0K5bZWI8w85bOtj8393gwPZzLMxrE/zJm4+ruL2UK6G/qoX66sjyBZ+RXBEbh6d/s4v8rgJmt0duV55YnyHWD85h9o2JRuzS/fbZERLzYiTnxYm2R2lcmiLaFJnR1bi+WxM3k/pKu25NIxMY9n6zm76H+wkiYP60jssum0M86lZcUItMtljUIRZ1aGlJU1+7b1OVbN5jKFskmyuyZ2eW/K4cfmeRoe052O3h9gYwEFDoyENHnsE1w+O/a1ngJByCFpvYnBg1C+Ik5sZpXJKidmFC1bjMOArrKWaMofdbPYw8OsSQ57H57TYXntdCY60ufUu4JWLu6I5vCRbMroWXDdz1/IDO3SP0b82Q3ZFneFsWv7uIvSeA3R4m48M2n+y2ItlHS0G+HbBs8Ots3LYIqflxYnOj1C1K0bQ0RbwpMn4/U6SaKKynkDGGvjv3MPBAPz0jOV642ODPc5k/6+D1o0XkQK5jM68tzby2NLzhwJ/lCz79u7NkduTYu3GE7I48fmcRr6uA22ew+wKCvjxD6/IMAXvoYTNg4hZWq0ukPYIzO0LtwiSzTkxTvyCJo2pcKlhZw/q2225j165dNDQ0sG3bNm644Qbi8ZlbYQ6tHmDovgF2D+VYd0GAt9DlwtPnaqMFkWMUizrMmlsDc2tY9Ibm8deNMeSzPiM7s+zeMMzQtizFjgKFXQXY7WPlDGwvUtxepAjkGGA3nWCB3eyWRqbPdqmZH6dhaYrUvDjp1piqcZl2ZQvrnp4eVq1axeOPP45t23zsYx9j9erVXH755eVqQlmtva+Doa90U5eI8uIbA3KLHD7w5uOpSUSO/Msi8qpYlkU86RI/Lk3TcQcO1AmCgGxvkT0vDjO8PUt+V4Hh7Tm8jkKpEu/xyPd48AxkGaRn9PdMwsKZHcGZ7ZKYF6d2YYLEvBiNi1Ikkvr/WcqjbGGdSCSIRCIMDw9TW1tLJpNh2bJl5Tr9lMkXfPqH88xq3DePz9vrMfyNPfhFw/rXFOhfZnPakiYFtcg0sm2bVHOMVHMMzjrwZ4WsR9eGIQa3ZsjvLJDZkaPYWcTZ40PWEGwpEGwpUHwsw+D4AYEmB2a5xNqj1CxIEJ8Xo3FJisbZiRk9Ul3Kr6xTt+6++27++7//m5aWFowxfPaznyWVSh3yvZ7n41bBLlN3P7yJP2zaw5++bTkLZtcSFAM2/e1mnnuok6F5Ftsud3Fcm0/8P6dqC0uRKmOMoXdnht3rBxnckmFwS4bcjhxBt4e/p4g5zKJsQcKi2FQa5JZemCTSHqV2cZJZy9LEExHqUlHiMQ0ZkokrW1i/8MILfPrTn+anP/0pruvyhS98Adu2+fSnP33I91fLPOv/uHcdw5kiZ544izesmE3ff+2h5+69bM2N0PGBOG3zamhrSrJySfORD1YhZtKcxammvpq4mdZXxaxH7+YRRrbnGRgdsR50Fwm6igS5Q/+1ahwopEsbotDqUGy0cdsj1C9MEKmNkIy51KaiOI7F/DkN+PkirmOpSj+CmfTdmvZ51t3d3dTX1+O67miDWujs7CzX6adENu8xnCkC0Nk7Qu6FLEP/t59C0WfbxTbz5tZwyZnzp7mVIjIVIgmXWSvqYMWBrxtjyPcUyHUU6Ns0Uppy1uVR2FXA7/WIDRviAwFmizf6GwVghGwC+uvhpXqLfD38ptVlOOVTSEMiGaGptrRBSjLmUpeKkoi5xKPO6H+lkI+4Ggg3U5UtrN/0pjfx8MMP84UvfIF0Os3GjRu57rrrynX6KbF3IDf+uLt7hL13d2MMDLwhQmZWkVkNiWlsnYhMB8uyiLfGiLfGqD/lZYPc8gHe6K5mQ9uy+J1FMttz5DvyBHmDPxjg9RmMAYMhXwgIbMjX5cnXF8jUQ99ooOfqIYjtq7gjrs3SOXUsmJ1mTkuNxsjMMGULa8dx+NznPleu05VFz0B2/HHTEz6ZXXlqFiXYtjILg9CisBaR/dgxm+jCGNGFMWreuC/IjTH4vT7FjgJeZ4FiR5HooMXApmG8vUU831DsDzB9Bi8weH6AHxi8ROmSeqbW0B/32PlSL5vreynUQENdnLmtNcxvTbNgdg2RKhgDJIenEQ7HYE9/qbJO9EPLWkMu7RO/soa92/uxLIvWeoW1iByZZVm4TS5ukwsnlWaWjN2HDXKlarzYWaDYUQpyr6tAsbOIKRrIABkoegGZXJFs3ifre+TqMgzWZ/l9fQ+PN9ok5sZoXFbD0sX1zG5M6pJ5lVFYH4OegSwYw4o/xCgEWTbMybNz6w4AmupK95dERI6FHbeJLooRXRQ74HVjDP4ej2JncbwaT48GutfnUSj6ZHf7ZHZ45As+Y6m+PrWbZ+ot3LYI9YuT1CyM07A4xeylae1VUMEU1q9SEBh6B/Okt0Nzt83OGHSeadGQjjGnpYaTljRNdxNFZAazLKu0I1lLBFYeuF/z2H7jXkepIs/uyDG8LcfwjhzZkSKRXQHsKpB7qkAO2ANsipaWYo22R6lfnKRucZK6RaWtSu24Qny6KawnaE9/ll17Rli5pAnLsugdzOEXfRY+ZRGLOhz3oTmc8pY6bdAhItNu//3GgfEdx01g8Ho88rvy7N4wRO+mEbyOAvmOAmYwwOwskttZpOt3I3RR2t0sGnGwG5zSXPGFCdILE6QXJIjOieE0OppWViYK6wn6rwc2EgQGA5yytJkdu4ep3wy1QzbuEpf2d7ZiRfSlFZHKZdkWkVkRIrMi1JxWw+LR140xDOzJ0/9Shj2bhujfnMHvKkK3TzDoY3X7ZLsLDD5d2t3MsiAWcXATDs7s0u5myXkxkvPj1CxI4M6OYMdUjU8mhfUEBUFpkYPNuwY4ZWkzW3YNMvupgEQsRt0VDQpqEalalmVR3xKnviXOwtc1jr+eL/h0780wtCtL/0sZBl/K4ncVsXo8iv0+7oAPAwUGXhwZ/52Ia+E6DnaTQ3xOjPjcGIl5MRqWpojNieHUqxp/NRTWR2nvYI6i5zPyxBCN/ZA+KU7qnNrpbpaIyKSLRR3mt6WhLX3AfuPZvMfuvixDPTn6t2YZ2pYh6PIwXR6R3oDooIfV4THSkYcnS79jWeDYFnbCIdIeIT4nRmJenJoFceoWJYi1x7C1TelhKayPUjbnsXnXAM1rAmJRh4Z3NGK5+leiiIRHIuayYHYaZqfhpH2v+0FA32CeoeEC/dsz9G/O4nUV8DpLy7DG+w3OsEdhg8fIhuwBx3RdG6fZxW2LEG2PUrcoSf2SJDXz4zj1buircYX1BPjBgav1P/vLTlr2QHx2hNTZh17HVUQkbBzbprk+QXN9AubWwRv3/azo+WRyHn1dWfZsGiGzPUehI4/X6WH3+DAQ4HUVyHcVGHl6hD76ALAtsFMOVqtLpD1Cal7pvnh6YYL6hcnQVOMK6wkozVHcJ/5YHoCWyxpD80URETkWEdehrsahbmmMhUvrD/iZHwT09+fp2TRMZmeOzPYcmR15gtHL6s6wD8M+xZfyZBge32vccSysZpfE/DhWi0NiXozaRUmal9UQnWHVuMJ6AnL7hXV0wJDeDq0tCdoub5nGVomIzAyObdPUmKDpzAScue91Ywy5gsdAd47Bl7IMbcsysi2H310k6PagL4DuIiM9HkFgGAS6gU0W2Ckbq9UlMTdOzcIEtQsT1C9JEm+LVeWtS4X1BOSLpbCe1ZhkyTabdGOR5vMbcGq0QpmIyFSxLItELEJifoTZ8w+85WiMYXCgQN/WEYKegJ4XBih0lJZhpdvDDAcwXGDopQJDvx5kbI/HSNQmMitCcl6cluPSpObHibRHcNujFf13usJ6AsYq67ht07bJxo+7pC+qm+ZWiYiEl2VZ1NXHqDsldtB+1oWix0Bnnr7NI/RuHia7I18K8d0eDAUUd+TJ7MjT98Qg7U0pCp6PY1skG6O4bVEi7VEibZHRxxHc1giWM73VuMJ6AsbCunaLwR/2ic6PEl0SO8JviYjIdIhGXFrmu7TMT8H5reOve37A7t0ZujcMseO5fjI7cuwdGCHWa4j1Q3qkQH1fjOjG3AHHsxwLt9UdDfEobnuEyGiQ26nyVOMK6wkYG2CWet4DXFLn1M6ogQsiImHgOjbtbTW0t9Ww/A2t/PihzWwbyJKMuxQKPtZgQGwgS3sQZ4GVINpvMN0ewd4isY6gVJ2zbwEYy7FoubaNxEnJw590sto+5WeYAXJFDydriL3kY6VdUm+ome4miYjIMYhFHa48bzHbu4dZ1JYmW/D5/Ys9vLC1lw1eng3kYS6wAqyiITVss8BO0B7Eacg6sNsnGPGxY+Up3BTWE5Av+NRvNtgG4iuSOHXqNhGRahePuhw3rzSNLOI6nH/qHN64Yjbrt/WxpXOQQjEAq7RX+J5IlufJ8DwZ7CaL5BIXLLi0MaC9DG1V6kxAvuDTsNHg2JYWQRERmcFiEYeTlzZz8tLmA14fyhTY3DHI5l0D7OoZYThbxHFsPD84zJEml8J6Agp7i9R0g91ikzgtNd3NERGRMksno5yytJlTljaTL/jkiz6JmEvELc/CWArrCbBfKICByPK4NmEXEQm5WNQhFi3vnGwlzwRE1xcBSJyuqlpERMovtGG9Y/cwv3uhG2PMAa8XPZ/ewX1z7IIRn9g2HyxIv1b3q0VEpPxCG9a/fbaTx57rYu/ggZPfVz+5gztXb6B/uLRZR/bZLIFnGG6DRGN0OpoqIiIhF9qwHhvBVygeOJJvYLiAMYa+oVJYZ54ZxhgYXmDjTvNycyIiEk6hDetg9Or3y4fde6M/yOQ9jDGMPJMBoLDE0aplIiIyLUIb1mP3qv3gwHvWY+GdzXl4HUWKe4t4CbDaI2Vvo4iICIR46tZ4WPuHDutM3iO7JUMQGIbmWcRioe0qERGZZqGtrMcK6uLLL4OPhnc275F7NoMfGIbmQU1ClbWIiEyP0Ib1vsvgB4a1P3YZPFskvyGH5wcMt1ukFdYiIjJNQhzWpT+9/S6DB4EhGC25vZ1FglxAodaiWGORTmraloiITI/QhnUwfs96X2W9/8hwa0tp1bLhttII8HRKlbWIiEyP0Ib1oSrr/R9HtntgDAOtpQBXZS0iItMlxGF98D3r8craGJIdhsDAnsbRsNY9axERmSahDevgkJV1KZijg+BmwE/AcMon4trEy7zDioiIyJjQhrU51D3r0QRPdY9O32qzwCoNLtPqZSIiMl1CHNalPw+orL1ScCd6Ss/7G0o/Syd1CVxERKZPiMN6dIrWIe5ZJ3tKP+up8QANLhMRkekV4rAu/bl/Ze0HBgJDYk/peUeitPOWKmsREZlOoQxrY8yh71n7AbEBsItQrAE/MTrHWpW1iIhMo1CG9diCKHDwPOtkj8GyINOyb0BZY22srO0TERHZXyjDer+sPmiedaIHIo5NtqX02lkntTGrIVnmFoqIiOwTyn0fzf6VtXfgPOtkjyEei7DyvGZa31BHcyqXWbEAABw5SURBVF1iOpooIiIyLpRhHRymsva9gHgvWBE47nXNuHWh7B4REakwIb0Mfuh71sUBHycPVsLGqdeKZSIiUhlCGtb7Hu8/z9p0lnbaYrarFctERKRihDSsD11Z01VaBMWercvfIiJSOUIZ1gfcs95vnrUZC+s2LYIiIiKVI5RhvX9lHQRmfN61vdsv/dmusBYRkcoR0rA+8LnvBxhjxsM6MkcrlomISOUI5c3Z4GVp7fkGe9iHjMGPgdOgkeAiIlI5QhnWL6+sPT/A2uVhjCHXCBFXYS0iIpWjrGH90ksvce+99xKLxXjyySe55pprWLlyZTmbABx4zxpGd9vqLmKAfJ2F62jaloiIVI6yhbXv+3zhC1/gG9/4BrZtc8UVV+C601PYH3wZPMDsLmKMoVAHrhPKW/kiIlKhypaWzz77LMYY7rjjDnK5HPX19bznPe8p1+kPEBw0wMxguosYA/laS2EtIiIVpWxh3dHRwdq1a/nKV75COp3m2muvJRKJ8K53veuQ729oSOJO4r3jlpb0+OOiZRGN7fvo6boEhaFBLMvCNNvMak1TVxPubTH37y95ZeqriVNfHR3118TN9L4qW1inUikWL15MOl3q0NNPP53f/e53hw3rvr7MpJ27pSVNT8/Q+PO9vRkKeW/8eU/PEPbWDL4fMBw39PdlKGQLk3b+avPy/pLDU19NnPrq6Ki/Jm4m9dXh/tFRtuu9J598Mv39/fh+aS5zR0cHCxcuLNfpD/DyAWbFAY8gF+BFwI9DxNUAMxERqRxlq6zr6+u59tprufHGG2loaKC3t5ePf/zj5Tr9AQ66Z73bI2IM+TRgWTi6Zy0iIhWkrMOxL774Yi6++OJynvKQDpq6tbs0bStXB7ZtYWvHLRERqSChLCEPWm50j4cxUKjVtC0REak8oUyml1fWQU9p9bJCGi2IIiIiFSeUYf3yRVFMj1+aY12n+9UiIlJ5QplML78Mbvr98co6orAWEZEKE8pkOqCyNgYGAwIDxRQ4ugwuIiIVJpRhvX9Wu1nAM5C0MK6WGhURkcoTymTaf4BZZGS00q4rLW2qsBYRkUoTymTav7KODJee5xKlF9PJyDS1SkRE5NBCGtalYLYsi8iIwWAYjpaWQW2pS0xn00RERA4SyrAORtcbjUbs0mXwAAbc0bCuj09n00RERA4SzrAe/XNWQ5LICOQKHr12EYBmVdYiIlJhyro2eKUYuwxek4xgey7GFMknDLWpGLHo5O2hLSIiMhlCWVmPDTCzLYuGoPTvlWIKWupVVYuISOUJaViPDTCDmkKpki6moFn3q0VEpAKFMqyD0ZvWVh6igQURCz+mylpERCpTqO9ZO0MBlmVRPzfB7GaHuS0109wyERGRg4UyrEdnbuEMlR60LU5zygVzprFFIiIihxfKy+BjlbU9XLoe7tRpBLiIiFSucIb16J92djS0axXWIiJSucIZ1mOVdWb03nVaYS0iIpUrlGE9tp+1NRrWtsJaREQqWCjDenxRFFXWIiJSBUIa1qOV9UhpgJnuWYuISCU7Ylg/9dRT5WhHWY0timKPjFbWCmsREalgR5xn/Xd/93e4rsuVV17JFVdcQWtraznaNaXM/vesbd2zFhGRynbEyvqBBx7gH//xH9m8eTOXXnopH/nIR1i9ejWe55WjfVPCQGlllKzBssCuCeXdABERqRITSqnXv/71fPGLX+Thhx/moosu4tvf/jbnnHMOX/jCF6a6fVMiMAYnDxYGO2Vj2dZ0N0lEROSwjqqkrKmp4corr+QjH/kIbW1tfP/735+qdk0pExjcLIClS+AiIlLxJrw2+ObNm7nrrru45557aGlp4corr+Ttb3/7VLZtygQG3CxYaHCZiIhUviOG9Q9/+EN+8pOfsH37dt72trfx7//+75xwwgnlaNuUMcbg5kqPVVmLiEilO2JYr169mg9+8INcdNFF5PN5tm3bVo52TSljwB0bXKawFhGRCnfEe9a33XYbl156KY8++ihve9vbuOaaawB49tln+ehHPzrlDZwK+1fWWr1MREQq3YQHmN188838+Mc/pra2FoCTTjqJ7du3T1nDplJgGA1rS6uXiYhIxTuq0eAtLS0HPI9Go5PamHIxlEaDW5YqaxERqXwTDutUKsWePXuwrNKc5CeeeIJ0Oj1lDZtKxoCb017WIiJSHSY8devaa6/lwx/+MDt37uSqq65i69atfP3rX5/Ktk0ZYwxObnTqVo3CWkREKtuEw3rlypX853/+J2vWrAHg1FNPHb9/XW2CwBDJAxGwklpqVEREKtuEwxognU5z7rnnTlVbysYYcApAxMJOKaxFRKSyHTGsv/vd777iz9///vdPWmPKJQiCUlinwI4rrEVEpLIdMaw///nPs2LFCpYtW1aO9pSFKQAGrIiF5WoTDxERqWxHDOsbbriBu+++m02bNnHFFVdw2WWXUVdXV462TZ1cAICVVFCLiEjlO2JYX3nllVx55ZXs3LmTn/70p7z3ve/luOOO42Mf+xjHH398Odo46azR1cssXQIXEZEqMOG0mjt3Lh/84Ae56qqreOKJJ/jDH/4wle2aUlZ+tLJOKKxFRKTyHbGyNsbwm9/8hrvuuosNGzZw6aWX8sMf/pB58+aVo31TYqyytjVtS0REqsARw/qcc86hpaWFd73rXXz84x/Hsizy+TybNm0CYOnSpVPeyEmXU2UtIiLV44hhHYlE6O/v51vf+hbf/va3McaM/8yyLB544IEpbeBUsAqlP22FtYiIVIEjhvWDDz5YjnaUlaXR4CIiUkWOWFp+6Utf4umnny5HW8rGHrtnndC64CIiUvmOGNbHH3883/72t7n44ou5/vrrefDBB8nn8+Vo29TJly7lWwlV1iIiUvmOeBn88ssv5/LLL6dQKPDYY4/xwAMPcOONN3L88cdz4YUXct5559HY2FiOtk4aezSsnaQqaxERqXwT3sgjGo1y7rnnjm/ksXbtWv7nf/6Hb33rW/z85z+fsgZOBWu8stYAMxERqXyvOq1OOeUUrr322qMK6lwux9vf/na++MUvvtrTTgprvLJWWIuISOUra1rddNNNLF++vJynPKSxy+AaYCYiItXgqPazBujo6Djotfb29iP+3t13381pp53Giy++SCaTOdrTTqrxedbay1pERKrAUYf1rbfeyoYNG2hoaCAajbJr1y7uuuuuV/ydTZs28dJLL/GpT32KF198cULnaWhI4rqTV/m2tKTHH0eKFtgWLXPTNLSkJu0cM8n+/SWvTH01ceqro6P+mriZ3ldHHdb//M//zFe+8hU+9alPAfCd73zniL9z//33E41GWbVqFb///e8pFovcfvvtfPCDHzzs7/T1TV713dKSpqdnaPy5yQaYwNCfzeH1BJN2npni5f0lh6e+mjj11dFRf03cTOqrw/2j46jDGmDLli2sW7eOSCQyvkb4K/nYxz42/jifz5PJZF4xqKeS8QyWB8YCO6551iIiUvleVVj/3d/9Hd/73vcA+Mu//MsJ/959993Hk08+SbFY5Oc//zmXXXbZqzn9MQmypUraj4Jj6561iIhUvlcV1q2trVxyySXk83m6uromvF3mJZdcwiWXXPJqTjlpgkwAxuBHwVJhLSIiVeBVV9ZLlizBcRwsy+K1r33tZLdryphMgIHRsFZai4hI5XtVYb1y5Uo+9KEPTXZbyiLI+AD4MVXWIiJSHV5VWD/yyCP09/eTSCQA+OhHPzqpjZpKQc5gDAQRC1tpLSIiVeBVhfVHPvKR8cfVdik5yJUq6yCiylpERKrDUYf1j370I/bu3QuAMabq7lkHxdJSo8atvn9oiIhIOB11WJ944onTvlzosTC50tQt86quKYiIiJTfUU80XrFiBSeeeCIbN25k06ZNnHDCCVPRrikTjG7iEURUVYuISHV4VauCfOYzn6GlpYXm5mY+97nPTXabplRQGF1eVJW1iIhUiVcVWfPmzePNb34zAOvWrZvUBk21oDB6z1qVtYiIVImjDuuvf/3rPPvss9xwww0AbNy4cdIbNZWC/Og968g0N0RERGSCjhjW11xzDbfccgsAhUKB008/ndNPP3385xdffPHUtW4KjIU1qqxFRKRKHPGe9Y4dO8Yf//Ef/zFnnnnm+H/r1q3jzDPPnNIGTjYzfhl8mhsiIiIyQUc1wCwIDtz7+Wc/+9mkNqYc9g0wU2UtIiLV4Yhhvf/CIS9fRMQYM/ktmmJGA8xERKTKHPGe9bZt27juuus46aSTyGazFItFIpHSNeRqXAHMjA8wq762i4hIOB0xrFetWsXzzz/P2rVriUQinH766cyZM4dly5bR3d1djjZOqrGpW5bCWkREqsQRw/qMM87gjDPOGH+ez+dZv349zz//PHV1dVPauKkwdhkcDTATEZEqcdTzrGOxGCeffDInn3zyVLRnypmCpm6JiEh1eVXLjVYzDTATEZFqE9qwVmUtIiLVIoRhPXoZPDq97RAREZmoUIW1CQzGGx0NrkVRRESkSoQrrMfuV7tg26H66CIiUsVClVimYDAGAheqcD0XEREJqZCFdel+dSmsldYiIlIdwhXWRYMBAkeVtYiIVI9whXXegCnds1ZlLSIi1SJcYV0ISpW1C7ayWkREqkTIwro0GrwU1kprERGpDqEK69KOW4bAtXTPWkREqkaownr/qVu2roOLiEiVCFlYBxgDxgFHi6KIiEiVCFVimYLBYAhccBxV1iIiUh3CF9ajl8FdXQYXEZEqEbKwDjDGYFxwnFB9dBERqWKhSqz9K2tHlbWIiFSJ8IU1peVGdc9aRESqRajCOsiXLoOX7lmH6qOLiEgVC1VimeJ+l8FVWYuISJUIV1gXzOgAM0vzrEVEpGqEKrH238jDVWUtIiJVImRhbcCY0gAzjQYXEZEqEa6wzhsCA0FE86xFRKR6hCqxTHH/tcFVWYuISHUIWViPbZEJriprERGpEuFKrACMASxV1iIiUj1CFdbGNwTGYGzNsxYRkeoRrrD2DBgwtlYwExGR6hGuxPLBoMpaRESqS6jC2gSlqVvG1j1rERGpHqEKa/a/DK7R4CIiUiVClVjGp7Q2uCprERGpIm65TrR9+3Zuuukmli9fTldXF/X19Vx99dXlOn2Jv99lcN2zFhGRKlG2sO7v7+etb30rF110EQBvfetbOe+881ixYkVZzm+MwQQGAMu2sC2FtYiIVIeyhfXKlSsPeB4EAYlEolynL40EH6+qbSyFtYiIVImyhfX+7r//fs4++2yWLFly2Pc0NCRxXWfSztnUkKIj6mC5FqlklJaW9KQdeyZS/0yc+mri1FdHR/01cTO9r8oe1o8//jhPPPEE11133Su+r68vM2nnbGlJs6driHzew8dQLPr09AxN2vFnmpaWtPpngtRXE6e+Ojrqr4mbSX11uH90lHU0+EMPPcQjjzzC9ddfT09PD08//XTZzm3G1gXX4DIREakyZQvr5557jk9+8pM888wzfOADH+Cv/uqv2LJlS7lOj/FMaZCZBa6mbYmISBUp22XwFStWlLWSPohvMIzuZa0FUUREpIqEJrX2XxDF1WVwERGpIqEJawKzb+qWdtwSEZEqEprUKt2zBmNpqVEREakuoQlrbY8pIiLVKjRhbfzRytrRjlsiIlJdwpNa/r6pW7oMLiIi1SQ0YW38/RZFUViLiEgVCU9Ye6PzrG1dBhcRkeoSntQKzPg8a1XWIiJSTUIT1mZ8i0xLo8FFRKSqhCas8cx+K5iF52OLiEj1C01qmWDfPWtdBhcRkWoSmrDGQ8uNiohIVQpNapn9B5jpnrWIiFSR0IQ1o2uDo/2sRUSkyoQmrE0wuja49rMWEZEqE5rUGt91S5fBRUSkyoQmrPH3hbWrAWYiIlJFQpNaJkArmImISFUKTVgztja4pcvgIiJSXUIT1mZsi0wNMBMRkSoTntQaWxvcgojCWkREqkhoUsv4hmC0so64ofnYIiIyA4QmtYy/b1EUVdYiIlJNQpNaxjMEQWk0uCprERGpJqFJrcA3AFgRG1tTt0REpIqEJqy9fACA4yqoRUSkuoQmrH1vNKwjofnIIiIyQ4QmufzCaFhHQ/ORRURkhghNcvle6Z61LoOLiEi1CU9YF1VZi4hIdQpNco2FtaZtiYhItQlNcgXF0cvgqqxFRKTKhCa5xuZZuwprERGpMqFJrrHR4AprERGpNqFJrvHKWvOsRUSkyoQmuYLRAWYKaxERqTahSa7xyjrmTHNLREREjk54wrqoAWYiIlKdQpNcZrSyjkZVWYuISHUJTVjvq6y13KiIiFSX0IS1Gb9n7U5zS0RERI5OaMI6GN3IIxILzUcWEZEZIjTJte+edWg+soiIzBChSS7jjd2z1gAzERGpLuEJ69HKOqbKWkREqkwokssYA37psRtXZS0iItUlFGFdKPpgwLLBcULxkUVEZAYJRXLlc6Wy2nI0x1pERKpPKMK6oLAWEZEqFoqwLuZHw9pVWIuISPUp63Jejz76KKtXr6apqQnLsrj66qvLcl5dBhcRkWpWtrDOZrN87nOf49577yUajXLNNdfw2GOP8YY3vGHKz13IeYDCWkREqlPZLoOvXbuW9vZ2otEoAKeddhoPPfRQWc7tFQMAbC0LLiIiVahs8bV3715SqdT485qaGvbu3XvY9zc0JHHdyZkTbQ9abEm4NDWnaGlJT8oxZzr108SpryZOfXV01F8TN9P7qmxh3dTUxMjIyPjz4eFhmpqaDvv+vr7MpJ07HYswqyFJJO7Q0zM0acedqVpa0uqnCVJfTZz66uiovyZuJvXV4f7RUbbL4KeccgodHR0UCgUA1qxZw3nnnVeWc4+tC67R4CIiUo3KVlknEgn+4R/+gX/+53+moaGB448/viyDywAIRv/UADMREalCZR1yddZZZ3HWWWeV85TAfpV1KGaVi4jITBOK+BrbcQtdBhcRkSoUjrAeq6x1GVxERKpQOMJ6rLLW7pgiIlKFQhHWY3tZq7IWEZFqFIqwHrsMrtHgIiJSjcIR1v7YPOtpboiIiMirEIqwjrRESn/Oik5zS0RERI5eKGrN5LIkc25ZiFOvEWYiIlJ9QhHWAG5DaD6qiIjMMKG4DC4iIlLNFNYiIiIVTmEtIiJS4RTWIiIiFU5hLSIiUuEU1iIiIhVOYS0iIlLhFNYiIiIVTmEtIiJS4RTWIiIiFU5hLSIiUuEsY4yZ7kaIiIjI4amyFhERqXAKaxERkQqnsBYREalwCmsREZEKp7AWERGpcAprERGRCudOdwOm2qOPPsrq1atpamrCsiyuvvrq6W5SRXnPe95DLBYDwLZtvvOd79Df38+Xv/xl5s2bx9atW/nUpz5Fc3PzNLd0evT09HDTTTexfv16fvKTnwC8Yv/cdtttDA8PMzg4yFlnncWFF144nc0vq0P11S233MLvfve78fd89KMf5ayzzgLC3Vfbt2/npptuYvny5XR1dVFfX8/VV1+t79YhHK6vQvfdMjNYJpMxF110kcnn88YYY66++mrz6KOPTnOrKsvNN9980Guf+cxnzL333muMMeaBBx4w1157bbmbVTF+8YtfmAceeMC8853vHH/tcP2zdu1a8xd/8RfGGGMKhYK5+OKLzcDAQPkbPU0O1VeH+n4Zo7565plnzP333z/+/NJLLzXPPvusvluHcLi+Ctt3a0ZfBl+7di3t7e1Eo1EATjvtNB566KHpbVSF2bBhA6tWreKWW24Z75uHH36YU089FSj12cMPPzyNLZxeb3nLW0ilUge8drj++dWvfsUpp5wCQCQSYfHixTz55JPlbfA0OlRfAXz961/nP/7jP1i1ahXZbBZQX61cuZKLLrpo/HkQBCQSCX23DuFwfQXh+m7N6Mvge/fuPeAvj5qaGvbu3TuNLao8H/7wh1m5ciW+7/P+97+fVCp1QL/V1NQwMDCA53m47oz+ukzY4fqnt7eXxYsXj7+vpqaG3t7e6WpmRXjLW97CnDlzSCaTfPe73+Xzn/88N954o/pqP/fffz9nn302S5Ys0XfrCPbvq7B9t2Z0Zd3U1MTIyMj48+HhYZqamqaxRZVn5cqVADiOwxlnnMETTzxxQL8NDw9TV1enoN7P4fqnsbHxoO9bY2PjdDWzIixbtoxkMgnA61//eh5//HEA9dWoxx9/nCeeeILrrrsO0Hfrlby8r8L23ZrRYX3KKafQ0dFBoVAAYM2aNZx33nnT26gKsnnzZn70ox+NP9+2bRvz58/n3HPP5emnnwZKfXbuuedOVxMr0uH65/zzz2ft2rUAeJ7H5s2bee1rXztt7awEX/ziF8cfb9u2jQULFgDqK4CHHnqIRx55hOuvv56enh6efvppfbcO41B9Fbbv1ozfyOO3v/0t9913Hw0NDUQiEY0G3093dzf/9E//xPLlyxkeHsbzPP7+7/+ewcFB/vVf/5X29nZ27NjB3/zN34R2NPjvfvc77r77bn7zm9/w3ve+lz/7sz8jl8sdtn9uu+02BgcHGRgY4JxzzpkZo1An6FB99bWvfY1sNktTUxMbNmzgE5/4BIsWLQLC3VfPPfccV111FStWrAAgk8nw/ve/nwsuuEDfrZc5XF9t2bIlVN+tGR/WIiIi1W5GXwYXERGZCRTWIiIiFU5hLSIiUuEU1iIiIhVOYS0iIlLhFNYiIiIVTmEtIiJS4RTWIlXqySef5Pjjj+enP/3ppB3r1ltvHX9tzZo1vPWtbz2m4375y1/mHe94xwH/nXjiifyv//W/jrXJIqGisBapQkEQcMMNN/D617+e9evXH/Pxnn/+eVauXMnq1avHX1u3bh3Lly8/7O9ccMEFRzzu3/zN3/Czn/1s/L83vvGNLF68mE9/+tPH3GaRMFFYi1ShH/zgB8yfP5/3ve99vPDCC8d8vHXr1nH55ZeTzWbZsWMHUArw17zmNcd87DFf/vKXefDBB7n99ttnxMYKIuWkrZREqszg4CDf/OY3ufPOO/E8jxdffPGQ7/vEJz7Btm3bDvmzH/zgB8Tj8fHn69at4z3veQ8XX3wx999/P3/2Z3/GunXruOKKKyalzV/96le57777uOOOO2hpaZmUY4qEicJapMrcfPPNXHHFFcydOxdjDIVCgc7OTtra2g5630Tkcjm2bt3KiSeeSDQa5cYbb+RP/uRP2Lx580GXwT/60Y/S2dkJwO7du3nHO94BlLZYveuuuw55/K997Wvcc8893HnnncyaNetoP66IoLAWqSpj25rW19dzzz33AFAsFlm/fv1BYT3Rynr9+vXMnTuXVCrFSSedRHd3N4888ghtbW2k0+kDfu8b3/jG+OMLLriAn/3sZ6/Y3lWrVvHjH/+YO+6446D2icjEKaxFqsiNN97IZz/7Wa688srx166//npeeOEFzj///APeO9HKev9705ZlccEFF3DzzTe/4uCyifjWt77FnXfeyZ133sncuXOP6VgiYaewFqkSDzzwALt37+ad73znAa8vW7aMNWvWvOrjvvDCCwcE88UXX8ydd955TNO2tmzZwhe/+EVaW1u55pprDvjZxz/+cd785je/6mOLhJH2sxYREalwmrolIiJS4RTWIiIiFU5hLSIiUuEU1iIiIhVOYS0iIlLhFNYiIiIVTmEtIiJS4RTWIiIiFe7/Bz5KZBgjqKu8AAAAAElFTkSuQmCC\n", - "text/plain": [ - "
                  " - ] - }, - "metadata": {}, - "output_type": "display_data" - } - ], - "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", - "print(clf.coef_, clf.intercept_)\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": [ - "### Seeing the wood for the trees\n", - "\n", - "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": 8, - "metadata": {}, - "outputs": [ - { - "data": { - "image/png": "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\n", - "text/plain": [ - "
                  " - ] - }, - "metadata": {}, - "output_type": "display_data" - }, - { - "name": "stdout", - "output_type": "stream", - "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", - "6 14 3 3 6 Li 5.332331 5.332331\n", - "7 19 4 3 7 Li 5.606439 5.606439\n", - "8 24 4 4 8 Be 7.062435 7.062435\n", - "9 29 5 4 9 Be 6.462668 6.462668\n", - "10 34 6 4 10 Be 6.497630 6.497630\n", - "11 40 6 5 11 B 6.927732 6.927732\n", - "12 46 6 6 12 C 7.680144 7.680144\n", - "13 52 7 6 13 C 7.469849 7.469849\n", - "14 57 8 6 14 C 7.520319 7.520319\n", - "15 64 8 7 15 N 7.699460 7.699460\n", - "16 72 8 8 16 O 7.976206 7.976206\n", - "17 78 9 8 17 O 7.750728 7.750728\n", - "18 85 10 8 18 O 7.767097 7.773058\n", - "19 93 10 9 19 F 7.779018 7.773058\n", - "20 102 10 10 20 Ne 8.032240 8.032240\n", - "21 110 11 10 21 Ne 7.971713 7.971713\n", - "22 118 12 10 22 Ne 8.080465 8.080465\n", - "23 128 12 11 23 Na 8.111493 8.111493\n", - "24 137 12 12 24 Mg 8.260709 8.260709\n", - "25 146 13 12 25 Mg 8.223502 8.223502\n", - "26 154 14 12 26 Mg 8.333870 8.333870\n", - "27 164 14 13 27 Al 8.331553 8.331553\n", - "28 174 14 14 28 Si 8.447744 8.447744\n", - "29 183 15 14 29 Si 8.448635 8.448635\n", - "30 192 16 14 30 Si 8.520654 8.520654\n", - "... ... ... ... ... ... ...\n", - "238 3089 146 92 238 U 7.570125 7.573113\n", - "239 3099 146 93 239 Np 7.560567 7.558304\n", - "240 3109 146 94 240 Pu 7.556042 7.558304\n", - "241 3118 147 94 241 Pu 7.546439 7.546439\n", - "242 3127 148 94 242 Pu 7.541327 7.541327\n", - "243 3136 149 94 243 Pu 7.531008 7.527912\n", - "244 3144 150 94 244 Pu 7.524815 7.527912\n", - "245 3154 149 96 245 Cm 7.515767 7.513619\n", - "246 3162 150 96 246 Cm 7.511471 7.513619\n", - "247 3170 151 96 247 Cm 7.501931 7.499329\n", - "248 3177 152 96 248 Cm 7.496728 7.499329\n", - "249 3186 152 97 249 Bk 7.486040 7.482998\n", - "250 3194 152 98 250 Cf 7.479956 7.482998\n", - "251 3201 153 98 251 Cf 7.470500 7.470500\n", - "252 3209 154 98 252 Cf 7.465347 7.465347\n", - "253 3216 155 98 253 Cf 7.454829 7.452027\n", - "254 3224 156 98 254 Cf 7.449225 7.452027\n", - "255 3232 156 99 255 Es 7.437821 7.434800\n", - "256 3241 156 100 256 Fm 7.431780 7.434800\n", - "257 3248 157 100 257 Fm 7.422194 7.422194\n", - "258 3256 157 101 258 Md 7.409675 7.409675\n", - "259 3264 157 102 259 No 7.399974 7.399974\n", - "260 3275 154 106 260 Sg 7.342562 7.342562\n", - "261 3280 157 104 261 Rf 7.371384 7.371384\n", - "262 3289 156 106 262 Sg 7.341185 7.341185\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", - "\n", - "[267 rows x 6 columns]\n", - "0.009883615646716184\n" - ] - } - ], - "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": [ - "### And what about using neural networks?\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": 37, - "metadata": {}, - "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": [ - "## A first summary\n", - "\n", - "The aim behind these introductory words was to present to you various\n", - "Python libraries and their functionalities, in particular libraries like\n", - "**numpy**, **pandas**, **xarray** and **matplotlib** and other that make our life much easier\n", - "in handling various data sets and visualizing data. \n", - "\n", - "Furthermore,\n", - "**Scikit-Learn** allows us with few lines of code to implement popular\n", - "Machine Learning algorithms for supervised learning. Later we will meet **Tensorflow**, a powerful library for deep learning. \n", - "Now it is time to dive more into the details of various methods. We will start with linear regression and try to take a deeper look at what it entails." - ] - } - ], - "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.3" - } - }, - "nbformat": 4, - "nbformat_minor": 2 -} diff --git a/doc/src/LectureNotes/introduction.ipynb b/doc/src/LectureNotes/introduction.ipynb deleted file mode 100644 index cae0616f4..000000000 --- a/doc/src/LectureNotes/introduction.ipynb +++ /dev/null @@ -1,352 +0,0 @@ -{ - "cells": [ - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "# Introduction to Applied Data Analysis and Machine Learning\n", - "\n", - " \n", - "**Morten Hjorth-Jensen**, Department of Physics, University of Oslo and Department of Physics and Astronomy and National Superconducting Cyclotron Laboratory, Michigan State University\n", - "\n", - "Date: **Nov 19, 2019**\n", - "\n", - "Copyright 1999-2019, Morten Hjorth-Jensen. Released under CC Attribution-NonCommercial 4.0 license\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "## Introduction\n", - "\n", - "During the last two decades there has been a swift and amazing\n", - "development of Machine Learning techniques and algorithms that impact\n", - "many areas in not only Science and Technology but also the Humanities,\n", - "Social Sciences, Medicine, Law, indeed, almost all possible\n", - "disciplines. The applications are incredibly many, from self-driving\n", - "cars to solving high-dimensional differential equations or complicated\n", - "quantum mechanical many-body problems. Machine Learning is perceived\n", - "by many as one of the main disruptive techniques nowadays. \n", - "\n", - "Statistics, Data science and Machine Learning form important\n", - "fields of research in modern science. They describe how to learn and\n", - "make predictions from data, as well as allowing us to extract\n", - "important correlations about physical process and the underlying laws\n", - "of motion in large data sets. The latter, big data sets, appear\n", - "frequently in essentially all disciplines, from the traditional\n", - "Science, Technology, Mathematics and Engineering fields to Life\n", - "Science, Law, education research, the Humanities and the Social\n", - "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", - "## Learning outcomes\n", - "\n", - "These sets of lectures aim at giving you an overview of central aspects of\n", - "statistical data analysis as well as some of the central algorithms\n", - "used in machine learning. We will introduce a variety of central\n", - "algorithms and methods essential for studies of data analysis and\n", - "machine learning. \n", - "\n", - "Hands-on projects and experimenting with data and algorithms plays a central role in\n", - "these lectures, and our hope is, through the various\n", - "projects and exercises, to expose you to fundamental\n", - "research problems in these fields, with the aim to reproduce state of\n", - "the art scientific results. You will learn to develop and\n", - "structure codes for studying these systems, get acquainted with\n", - "computing facilities and learn to handle large scientific projects. A\n", - "good scientific and ethical conduct is emphasized throughout the\n", - "course. More specifically, you will\n", - "\n", - "1. Learn about basic data analysis, Bayesian statistics, Monte Carlo methods, data optimization and machine learning;\n", - "\n", - "2. Be capable of extending the acquired knowledge to other systems and cases;\n", - "\n", - "3. Have an understanding of central algorithms used in data analysis and machine learning;\n", - "\n", - "4. Gain knowledge of central aspects of Monte Carlo methods, Markov chains, Gibbs samplers and their possible applications, from numerical integration to simulation of stock markets;\n", - "\n", - "5. Understand methods for regression and classification;\n", - "\n", - "6. Learn about neural network, genetic algorithms and Boltzmann machines;\n", - "\n", - "7. 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++, in addition to a basic knowledge of linear algebra (typically taught during the first one or two years of undergraduate studies).\n", - "\n", - "There are several topics we will cover here, spanning from \n", - "statistical data analysis and its basic concepts such as expectation\n", - "values, variance, covariance, correlation functions and errors, via\n", - "well-known probability distribution functions like the uniform\n", - "distribution, the binomial distribution, the Poisson distribution and\n", - "simple and multivariate normal distributions to central elements of\n", - "Bayesian statistics and modeling. We will also remind the reader about\n", - "central elements from linear algebra and standard methods based on\n", - "linear algebra used to optimize (minimize) functions (the family of gradient descent methods)\n", - "and the Singular-value decomposition and\n", - "least square methods for parameterizing data.\n", - "\n", - "We will also cover Monte Carlo methods, Markov chains, well-known\n", - "algorithms for sampling stochastic events like the Metropolis-Hastings\n", - "and Gibbs sampling methods. An important aspect of all our\n", - "calculations is a proper estimation of errors. Here we will also\n", - "discuss famous resampling techniques like the blocking, the bootstrapping\n", - "and the jackknife methods and the infamous bias-variance tradeoff. \n", - "\n", - "The second part of the material covers several algorithms used in\n", - "machine learning.\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "## Types of Machine Learning\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. The first\n", - "ingredient is normally our data set (which can be subdivided into\n", - "training and test data), the second item is a model which is normally\n", - "a function of some parameters. The model reflects our knowledge of\n", - "the system (or lack thereof). As an example, if we know that our data\n", - "show a behavior similar to what would be predicted by a polynomial,\n", - "fitting our data to a polynomial of some degree would then determin\n", - "our model.\n", - "\n", - "The last ingredient is a so-called **cost**\n", - "function which allows us to present an estimate on how good our model\n", - "is in reproducing the data it is supposed to train. \n", - "\n", - "Here we will build our machine learning approach on elements of the\n", - "statistical foundation discussed above, with elements from data\n", - "analysis, stochastic processes etc. We will discuss the following\n", - "machine learning algorithms\n", - "\n", - "1. Linear regression and its variants\n", - "\n", - "2. Decision tree algorithms, from single trees to random forests\n", - "\n", - "3. Bayesian statistics and regression\n", - "\n", - "4. Support vector machines and finally various variants of\n", - "\n", - "5. Artifical neural networks and deep learning, including convolutional neural networks and Bayesian neural networks\n", - "\n", - "6. Networks for unsupervised learning using for example reduced Boltzmann machines.\n", - "\n", - "## Choice of programming language\n", - "\n", - "Python plays nowadays a central role in the development of machine\n", - "learning techniques and tools for data analysis. In particular, seen\n", - "the wealth of machine learning and data analysis libraries written in\n", - "Python, easy to use libraries with immediate visualization(and not the\n", - "least impressive galleries of existing examples), the popularity of the\n", - "Jupyter notebook framework with the possibility to run **R** codes or\n", - "compiled programs written in C++, and much more made our choice of\n", - "programming language for this series of lectures easy. However,\n", - "since the focus here is not only on using existing Python libraries such\n", - "as **Scikit-Learn** or **Tensorflow**, but also on developing your own\n", - "algorithms and codes, we will as far as possible present many of these\n", - "algorithms either as a Python codes or C++ or Fortran (or other languages) codes. \n", - "\n", - "The reason we also focus on compiled languages like C++ (or\n", - "Fortran), is that Python is still notoriously slow when we do not\n", - "utilize highly streamlined computational libraries like\n", - "[Lapack](http://www.netlib.org/lapack/) or other numerical libraries\n", - "written in compiled languages (many of these libraries are written in\n", - "Fortran). Although a project like [Numba](https://numba.pydata.org/)\n", - "holds great promise for speeding up the unrolling of lengthy loops, C++\n", - "and Fortran are presently still the performance winners. Numba gives\n", - "you potentially the power to speed up your applications with high\n", - "performance functions written directly in Python. In particular,\n", - "array-oriented and math-heavy Python code can achieve similar\n", - "performance to C, C++ and Fortran. However, even with these speed-ups,\n", - "for codes involving heavy Markov Chain Monte Carlo analyses and\n", - "optimizations of cost functions, C++/C or Fortran codes tend to\n", - "outperform Python codes. \n", - "\n", - "Presently thus, the community tends to let\n", - "code written in C++/C or Fortran do the heavy duty numerical\n", - "number crunching and leave the post-analysis of the data to the above\n", - "mentioned Python modules or software packages. However, with the developments taking place in for example the Python community, and seen\n", - "the changes during the last decade, the above situation may change swiftly in the not too distant future. \n", - "\n", - "Many of the examples we discuss in this series of lectures come with\n", - "existing data files or provide code examples which produce the data to\n", - "be analyzed. Most of the applications we will discuss deal with\n", - "small data sets (less than a terabyte of information) and can easily\n", - "be analyzed and tested on standard off the shelf laptops you find in general \n", - "stores.\n", - "\n", - "## Data handling, machine learning and ethical aspects\n", - "\n", - "In most of the cases we will study, we will either generate the data\n", - "to analyze ourselves (both for supervised learning and unsupervised\n", - "learning) or we will recur again and again to data present in say\n", - "**Scikit-Learn** or **Tensorflow**. Many of the examples we end up\n", - "dealing with are from a privacy and data protection point of view,\n", - "rather inoccuous and boring results of numerical\n", - "calculations. However, this does not hinder us from developing a sound\n", - "ethical attitude to the data we use, how we analyze the data and how\n", - "we handle the data.\n", - "\n", - "The most immediate and simplest possible ethical aspects deal with our\n", - "approach to the scientific process. Nowadays, with version control\n", - "software like [Git](https://git-scm.com/) and various online\n", - "repositories like [Github](https://github.com/),\n", - "[Gitlab](https://about.gitlab.com/) etc, we can easily make our codes\n", - "and data sets we have used, freely and easily accessible to a wider\n", - "community. This helps us almost automagically in making our science\n", - "reproducible. The large open-source development communities involved\n", - "in say [Scikit-Learn](http://scikit-learn.org/stable/),\n", - "[Tensorflow](https://www.tensorflow.org/),\n", - "[PyTorch](http://pytorch.org/) and [Keras](https://keras.io/), are\n", - "all excellent examples of this. The codes can be tested and improved\n", - "upon continuosly, helping thereby our scientific community at large in\n", - "developing data analysis and machine learning tools. It is much\n", - "easier today to gain traction and acceptance for making your science\n", - "reproducible. From a societal stand, this is an important element\n", - "since many of the developers are employees of large public institutions like\n", - "universities and research labs. Our fellow taxpayers do deserve to get\n", - "something back for their bucks.\n", - "\n", - "However, this more mechanical aspect of the ethics of science (in\n", - "particular the reproducibility of scientific results) is something\n", - "which is obvious and everybody should do so as part of the dialectics of\n", - "science. The fact that many scientists are not willing to share their codes or \n", - "data is detrimental to the scientific discourse.\n", - "\n", - "Before we proceed, we should add a disclaimer. Even though\n", - "we may dream of computers developing some kind of higher learning\n", - "capabilities, at the end (even if the artificial intelligence\n", - "community keeps touting our ears full of fancy futuristic avenues), it is we, yes you reading these lines,\n", - "who end up constructing and instructing, via various algorithms, the\n", - "machine learning approaches. Self-driving cars for example, rely on sofisticated\n", - "programs which take into account all possible situations a car can\n", - "encounter. In addition, extensive usage of training data from GPS\n", - "information, maps etc, are typically fed into the software for\n", - "self-driving cars. Adding to this various sensors and cameras that\n", - "feed information to the programs, there are zillions of ethical issues\n", - "which arise from this.\n", - "\n", - "For self-driving cars, where basically many of the standard machine\n", - "learning algorithms discussed here enter into the codes, at a certain\n", - "stage we have to make choices. Yes, we , the lads and lasses who wrote\n", - "a program for a specific brand of a self-driving car. As an example,\n", - "all carmakers have as their utmost priority the security of the\n", - "driver and the accompanying passengers. A famous European carmaker, which is\n", - "one of the leaders in the market of self-driving cars, had **if**\n", - "statements of the following type: suppose there are two obstacles in\n", - "front of you and you cannot avoid to collide with one of them. One of\n", - "the obstacles is a monstertruck while the other one is a kindergarten\n", - "class trying to cross the road. The self-driving car algo would then\n", - "opt for the hitting the small folks instead of the monstertruck, since\n", - "the likelihood of surving a collision with our future citizens, is\n", - "much higher.\n", - "\n", - "This leads to serious ethical aspects. Why should we opt for such an\n", - "option? Who decides and who is entitled to make such choices? Keep in\n", - "mind that many of the algorithms you will encounter in this series of\n", - "lectures or hear about later, are indeed based on simple programming\n", - "instructions. And you are very likely to be one of the people who may\n", - "end up writing such a code. Thus, developing a sound ethical attitude\n", - "to what we do, an approach well beyond the simple mechanistic one of\n", - "making our science available and reproducible, is much needed. The\n", - "example of the self-driving cars is just one of infinitely many cases\n", - "where we have to make choices. When you analyze data on economic\n", - "inequalities, who guarantees that you are not weighting some data in a\n", - "particular way, perhaps because you dearly want a specific conclusion\n", - "which may support your political views? Or what about the recent\n", - "claims that a famous IT company like Apple has a sexist bias on the\n", - "their recently [launched credit card](https://qz.com/1748321/the-role-of-goldman-sachs-algorithms-in-the-apple-credit-card-scandal/)?\n", - "\n", - "We do not have the answers here, nor will we venture into a deeper\n", - "discussions of these aspects, but we want you think over these topics\n", - "in a more overarching way. A statistical data analysis with its dry\n", - "numbers and graphs meant to guide the eye, does not necessarily\n", - "reflect the truth, whatever that is. As a scientist, and after a\n", - "university education, you are supposedly a better citizen, with an\n", - "improved critical view and understanding of the scientific method, and\n", - "perhaps some deeper understanding of the ethics of science at\n", - "large. Use these insights. Be a critical citizen. You owe it to our\n", - "society." - ] - } - ], - "metadata": {}, - "nbformat": 4, - "nbformat_minor": 2 -} diff --git a/doc/src/LectureNotes/logistic.ipynb b/doc/src/LectureNotes/logistic.ipynb deleted file mode 100644 index 4da84cb3d..000000000 --- a/doc/src/LectureNotes/logistic.ipynb +++ /dev/null @@ -1,813 +0,0 @@ -{ - "cells": [ - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "# Data Analysis and Machine Learning: Logistic Regression\n", - "\n", - " \n", - "**Morten Hjorth-Jensen**, Department of Physics, University of Oslo and Department of Physics and Astronomy and National Superconducting Cyclotron Laboratory, Michigan State University\n", - "\n", - "Date: **Oct 17, 2019**\n", - "\n", - "Copyright 1999-2019, Morten Hjorth-Jensen. Released under CC Attribution-NonCommercial 4.0 license\n", - "\n", - "\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 $\\hat{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", - "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", - "## Optimization and Deep learning\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 $\\hat{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": [ - "## Linear classifier\n", - "\n", - "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", - "\\hat{y} = \\hat{X}^T\\hat{\\beta} + \\hat{\\epsilon},\n", - "\\label{_auto1} \\tag{1}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $\\hat{y}$ is a vector representing the possible outcomes, $\\hat{X}$ is our\n", - "$n\\times p$ design matrix and $\\hat{\\beta}$ represents our estimators/predictors.\n", - "\n", - "## Some selected properties\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 logistic function\n", - "\n", - "The perceptron 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, 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": 1, - "metadata": {}, - "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", - "\"\"\"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": [ - "## Two parameters\n", - "\n", - "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,\\hat{\\beta}) &= \\frac{\\exp{(\\beta_0+\\beta_1x_i)}}{1+\\exp{(\\beta_0+\\beta_1x_i)}},\\nonumber\\\\\n", - "p(y_i=0|x_i,\\hat{\\beta}) &= 1 - p(y_i=1|x_i,\\hat{\\beta}),\n", - "\\end{align*}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "where $\\hat{\\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, \\hat{\\beta}) = 1-p(y_i=1\\vert x_i, \\hat{\\beta}).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "## Maximum likelihood\n", - "\n", - "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}|\\hat{\\beta})& = \\prod_{i=1}^n \\left[p(y_i=1|x_i,\\hat{\\beta})\\right]^{y_i}\\left[1-p(y_i=1|x_i,\\hat{\\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}(\\hat{\\beta}) = \\sum_{i=1}^n \\left( y_i\\log{p(y_i=1|x_i,\\hat{\\beta})} + (1-y_i)\\log\\left[1-p(y_i=1|x_i,\\hat{\\beta}))\\right]\\right).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## The cost function rewritten\n", - "\n", - "Reordering the logarithms, we can rewrite the **cost/loss** function as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\mathcal{C}(\\hat{\\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}(\\hat{\\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", - "## Minimizing the cross entropy\n", - "\n", - "The cross entropy is a convex function of the weights $\\hat{\\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}(\\hat{\\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}(\\hat{\\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": [ - "## A more compact expression\n", - "\n", - "Let us now define a vector $\\hat{y}$ with $n$ elements $y_i$, an\n", - "$n\\times p$ matrix $\\hat{X}$ which contains the $x_i$ values and a\n", - "vector $\\hat{p}$ of fitted probabilities $p(y_i\\vert x_i,\\hat{\\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}(\\hat{\\beta})}{\\partial \\hat{\\beta}} = -\\hat{X}^T\\left(\\hat{y}-\\hat{p}\\right).\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "If we in addition define a diagonal matrix $\\hat{W}$ with elements \n", - "$p(y_i\\vert x_i,\\hat{\\beta})(1-p(y_i\\vert x_i,\\hat{\\beta})$, we can obtain a compact expression of the second derivative as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\frac{\\partial^2 \\mathcal{C}(\\hat{\\beta})}{\\partial \\hat{\\beta}\\partial \\hat{\\beta}^T} = \\hat{X}^T\\hat{W}\\hat{X}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Extending to more predictors\n", - "\n", - "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(\\hat{\\beta}\\hat{x})}{1-p(\\hat{\\beta}\\hat{x})}} = \\beta_0+\\beta_1x_1+\\beta_2x_2+\\dots+\\beta_px_p.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "Here we defined $\\hat{x}=[1,x_1,x_2,\\dots,x_p]$ and $\\hat{\\beta}=[\\beta_0, \\beta_1, \\dots, \\beta_p]$ leading to" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "p(\\hat{\\beta}\\hat{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": [ - "## Including more classes\n", - "\n", - "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\n", - "following model" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "1\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", - "\\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", - "## More classes\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 $\\hat{x}$ and a weighting vector $\\hat{\\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", - "\n", - "\n", - "\n", - "## A simple classification problem" - ] - }, - { - "cell_type": "code", - "execution_count": 2, - "metadata": {}, - "outputs": [], - "source": [ - "import numpy as np\n", - "from sklearn import datasets, linear_model\n", - "import matplotlib.pyplot as plt\n", - "\n", - "\n", - "def generate_data():\n", - " np.random.seed(0)\n", - " X, y = datasets.make_moons(200, noise=0.20)\n", - " return X, y\n", - "\n", - "\n", - "def visualize(X, y, clf):\n", - " plot_decision_boundary(lambda x: clf.predict(x), X, y)\n", - "\n", - "def plot_decision_boundary(pred_func, X, y):\n", - " # Set min and max values and give it some padding\n", - " x_min, x_max = X[:, 0].min() - .5, X[:, 0].max() + .5\n", - " y_min, y_max = X[:, 1].min() - .5, X[:, 1].max() + .5\n", - " h = 0.01\n", - " # Generate a grid of points with distance h between them\n", - " xx, yy = np.meshgrid(np.arange(x_min, x_max, h), np.arange(y_min, y_max, h))\n", - " # Predict the function value for the whole gid\n", - " Z = pred_func(np.c_[xx.ravel(), yy.ravel()])\n", - " Z = Z.reshape(xx.shape)\n", - " # Plot the contour and training examples\n", - " plt.contourf(xx, yy, Z, cmap=plt.cm.Spectral)\n", - " plt.scatter(X[:, 0], X[:, 1], c=y, cmap=plt.cm.Spectral)\n", - " plt.show()\n", - "\n", - "\n", - "def classify(X, y):\n", - " clf = linear_model.LogisticRegressionCV()\n", - " clf.fit(X, y)\n", - " return clf\n", - "\n", - "\n", - "def main():\n", - " X, y = generate_data()\n", - " # visualize(X, y)\n", - " clf = classify(X, y)\n", - " visualize(X, y, clf)\n", - "\n", - "if __name__ == \"__main__\":\n", - " main()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## The Credit Card example\n", - "Here we use the the [credit card data](https://archive.ics.uci.edu/ml/datasets/default+of+credit+card+clients). \n", - "The data are from an extensive database from Taiwan and include more than ten predictors.\n", - "\n", - "For categorical data -Scikit-Learn- provides a so-called **one-hot encoder**.\n", - "This is called one-hot\n", - "encoding, because only one attribute will be equal to 1 (hot), while the others will be 0 (cold).\n", - "**Scikit-Learn** provides a OneHotEncoder encoder to convert integer categorical values into one-hot" - ] - }, - { - "cell_type": "code", - "execution_count": 3, - "metadata": {}, - "outputs": [], - "source": [ - "from sklearn.preprocessing import OneHotEncoder\n", - "encoder = OneHotEncoder()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## How to read the Credit Card data" - ] - }, - { - "cell_type": "code", - "execution_count": 4, - "metadata": {}, - "outputs": [], - "source": [ - "import pandas as pd\n", - "import os\n", - "import numpy as np\n", - "\n", - "\n", - "from sklearn.model_selection import train_test_split\n", - "from sklearn.preprocessing import OneHotEncoder\n", - "from sklearn.compose import ColumnTransformer\n", - "from sklearn.preprocessing import StandardScaler, OneHotEncoder\n", - "from sklearn.metrics import confusion_matrix, accuracy_score, roc_auc_score\n", - "\n", - "# Trying to set the seed\n", - "np.random.seed(0)\n", - "import random\n", - "random.seed(0)\n", - "\n", - "# Reading file into data frame\n", - "cwd = os.getcwd()\n", - "filename = cwd + '/default of credit card clients.xls'\n", - "nanDict = {}\n", - "df = pd.read_excel(filename, header=1, skiprows=0, index_col=0, na_values=nanDict)\n", - "\n", - "df.rename(index=str, columns={\"default payment next month\": \"defaultPaymentNextMonth\"}, inplace=True)\n", - "\n", - "# Features and targets \n", - "X = df.loc[:, df.columns != 'defaultPaymentNextMonth'].values\n", - "y = df.loc[:, df.columns == 'defaultPaymentNextMonth'].values\n", - "\n", - "# Categorical variables to one-hot's\n", - "onehotencoder = OneHotEncoder(categories=\"auto\")\n", - "\n", - "X = ColumnTransformer(\n", - " [(\"\", onehotencoder, [3]),],\n", - " remainder=\"passthrough\"\n", - ").fit_transform(X)\n", - "\n", - "y.shape\n", - "\n", - "# Train-test split\n", - "trainingShare = 0.5 \n", - "seed = 1\n", - "XTrain, XTest, yTrain, yTest=train_test_split(X, y, train_size=trainingShare, \\\n", - " test_size = 1-trainingShare,\n", - " random_state=seed)\n", - "\n", - "# Input Scaling\n", - "sc = StandardScaler()\n", - "XTrain = sc.fit_transform(XTrain)\n", - "XTest = sc.transform(XTest)\n", - "\n", - "# One-hot's of the target vector\n", - "Y_train_onehot, Y_test_onehot = onehotencoder.fit_transform(yTrain), onehotencoder.fit_transform(yTest)\n", - "\n", - "# Remove instances with zeros only for past bill statements or paid amounts\n", - "'''\n", - "df = df.drop(df[(df.BILL_AMT1 == 0) &\n", - " (df.BILL_AMT2 == 0) &\n", - " (df.BILL_AMT3 == 0) &\n", - " (df.BILL_AMT4 == 0) &\n", - " (df.BILL_AMT5 == 0) &\n", - " (df.BILL_AMT6 == 0) &\n", - " (df.PAY_AMT1 == 0) &\n", - " (df.PAY_AMT2 == 0) &\n", - " (df.PAY_AMT3 == 0) &\n", - " (df.PAY_AMT4 == 0) &\n", - " (df.PAY_AMT5 == 0) &\n", - " (df.PAY_AMT6 == 0)].index)\n", - "'''\n", - "df = df.drop(df[(df.BILL_AMT1 == 0) &\n", - " (df.BILL_AMT2 == 0) &\n", - " (df.BILL_AMT3 == 0) &\n", - " (df.BILL_AMT4 == 0) &\n", - " (df.BILL_AMT5 == 0) &\n", - " (df.BILL_AMT6 == 0)].index)\n", - "\n", - "df = df.drop(df[(df.PAY_AMT1 == 0) &\n", - " (df.PAY_AMT2 == 0) &\n", - " (df.PAY_AMT3 == 0) &\n", - " (df.PAY_AMT4 == 0) &\n", - " (df.PAY_AMT5 == 0) &\n", - " (df.PAY_AMT6 == 0)].index)\n", - "\n", - "from sklearn.linear_model import LogisticRegression\n", - "from sklearn.model_selection import GridSearchCV\n", - "\n", - "lambdas=np.logspace(-5,7,13)\n", - "parameters = [{'C': 1./lambdas, \"solver\":[\"lbfgs\"]}]#*len(parameters)}]\n", - "scoring = ['accuracy', 'roc_auc']\n", - "logReg = LogisticRegression()\n", - "gridSearch = GridSearchCV(logReg, parameters, cv=5, scoring=scoring, refit='roc_auc')" - ] - } - ], - "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.7.4" - } - }, - "nbformat": 4, - "nbformat_minor": 2 -} diff --git a/doc/src/LectureNotes/regression.ipynb b/doc/src/LectureNotes/regression.ipynb deleted file mode 100644 index 5264eb4fb..000000000 --- a/doc/src/LectureNotes/regression.ipynb +++ /dev/null @@ -1,6395 +0,0 @@ -{ - "cells": [ - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "# Data Analysis and Machine Learning: Linear Regression and more Advanced Regression Analysis\n", - "\n", - " \n", - "**Morten Hjorth-Jensen**, Department of Physics, University of Oslo and Department of Physics and Astronomy and National Superconducting Cyclotron Laboratory, Michigan State University\n", - "\n", - "Date: **Sep 11, 2020**\n", - "\n", - "Copyright 1999-2020, Morten Hjorth-Jensen. Released under CC Attribution-NonCommercial 4.0 license\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "## Why Linear Regression (aka Ordinary Least Squares and family)\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", - "## Regression analysis, overarching aims\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", - "\n", - "## Regression analysis, overarching aims II\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", - "\n", - "\n", - "\n", - "## Examples\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", - "\n", - "\n", - "\n", - "\n", - "\n", - "## General linear models\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", - "\n", - "\n", - "## Rewriting the fitting procedure as a linear algebra problem\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": [ - "## Rewriting the fitting procedure as a linear algebra problem, more details\n", - "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", - "\n", - "\n", - "\n", - "## Generalizing the fitting procedure as a linear algebra problem\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", - "\n", - "\n", - "\n", - "## Generalizing the fitting procedure as a linear algebra problem\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", - "\n", - "\n", - "\n", - "## Optimizing our parameters\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", - "\n", - "\n", - "\n", - "## Our model for the nuclear binding energies\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": 1, - "metadata": {}, - "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", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - " \n", - "
                  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
                  \n", - "

                  267 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", - ".. ... ... ... ... ...\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", - "266 1.0 266.0 41.360688 0.155491 0.003759\n", - "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]" - ] - }, - "metadata": {}, - "output_type": "display_data" - } - ], - "source": [ - "%matplotlib inline\n", - "\n", - "# 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", - "\n", - "## Optimizing our parameters, more details\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", - "\n", - "\n", - "\n", - "## Interpretations and optimizing our parameters\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": [ - "## Interpretations and optimizing our parameters\n", - "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", - "\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", - "\n", - "## Some useful matrix and vector expressions\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": [ - "2\n", - "6\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": [ - "2\n", - "7\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": [ - "2\n", - "8\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": [ - "## Interpretations and optimizing our parameters\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", - "\n", - "\n", - "Let us now return to our nuclear binding energies and simply code the above equations. \n", - "\n", - "## Own code for Ordinary Least Squares\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": 2, - "metadata": {}, - "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": 3, - "metadata": {}, - "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": 4, - "metadata": {}, - "outputs": [ - { - "data": { - "image/png": "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J5KBP37iVSodye6JLFo9PT00NDTQ1dWllWwvgrszMDBAT08Pa9eunfLzIjkEHg/8jGr4IgtKLpejra1NYX+RzIy2trYL/qYUyUQMS+OzdDTCF1loFPYzYzr/jtEM/KJG+CIip4pkIoaV9fDTquGLyBl8+9vfxsx48cUXZ+T1vva1r7F582Y2b97Mddddx7PPPjux7Qc/+AGXXnop69ev59577524/+tf/zqXX345sViM7du3n/R6O3fu5K1vfSuXX345V1555Ywd5I5c4Ls7XqnhpzXCF5Ez2LZtG29729t48MEHZ+T11q5dy2OPPQs7MJkAAAu/SURBVMbOnTv57Gc/y9133w1AEAT8zu/8Dg899BC7du1i27Zt7Nq1C4ArrriCb33rW7zjHe846bVKpRIf+9jH+NKXvsQLL7zAo48+ekEzcc4lckNgD5zAHTeoUQ1fZMH6l19+alZe94E7rz3n9pGREX7605/yyCOPcOutt/L5z3+eRx99lM997nMsXbqUHTt2cNttt3HllVdy3333kc1m+c53vsMll1xCf38/n/jEJ9i/fz8Af/VXf8X111/PddddN/H6b3nLW+jp6QHgySefZP369axbtw6A22+/ne9+97ts2rSJyy677Izte/jhh9m8eTNXXXUVAG1tbRf9bzIuekPgAMIQwjiktXiaiJziO9/5DjfddBMbN26ktbWVZ555BoBnn32W++67j+eee46vfOUr7NmzhyeffJK77rqLv/7rvwbgU5/6FPfccw9PPfUU3/zmN7nrrrtOe/0HHniA9773vQD09vayatWqiW2dnZ309vaes3179uzBzLjxxhu5+uqr+bM/+7OZ6noER/glJ3TH45BJ6kxbkYXqfCPx2bJt2zY+/elPA+UR97Zt27jlllu49tprWb58OQCXXHIJ73nPewC48soreeSRRwD44Q9/OFGSARgeHubEiRM0NDQA8Mgjj/DAAw/w+OOPA+US86nON7umVCrx+OOP89RTT1FbW8sNN9zANddcww033HCRPY9i4AeVwI9BRiN8EZlkYGCAH//4xzz//POYGUEQYGbcfPPNpNPpicfFYrGJv2OxGKVSCYAwDPn5z39OTU3Naa+9c+dO7rrrLh566KGJMkxnZycHDhyYeExPTw8rVqw4Zxs7Ozt55zvfSXt7OwA333wzzzzzzIwEfuQSsZgP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\n", - "text/plain": [ - "
                  " - ] - }, - "metadata": { - "needs_background": "light" - }, - "output_type": "display_data" - } - ], - "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": [ - "## Adding error analysis and training set up\n", - "\n", - "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": 5, - "metadata": {}, - "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": 6, - "metadata": {}, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "0.9547578478889096\n" - ] - } - ], - "source": [ - "print(R2(Energies,ytilde))" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We can easily add our **MSE** score as" - ] - }, - { - "cell_type": "code", - "execution_count": 7, - "metadata": {}, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "0.037875961483052376\n" - ] - } - ], - "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": 8, - "metadata": {}, - "outputs": [ - { - "name": "stdout", - "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", - " ... \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" - ] - } - ], - "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", - "\n", - "## The $\\chi^2$ function\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", - "\n", - "\n", - "## The $\\chi^2$ function\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": [ - "## The $\\chi^2$ function\n", - "\n", - "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 $\\chi^2$ function\n", - "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": [ - "## The $\\chi^2$ function\n", - "\n", - "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", - "\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. Furthermore, we\n", - "sneak in **Ridge** regression (to be discussed below) which includes a\n", - "hyperparameter $\\lambda$, also to be explained below.\n", - "\n", - "## The code" - ] - }, - { - "cell_type": "code", - "execution_count": 9, - "metadata": {}, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "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.057088709963296\n", - "Mean squared error: 197.93\n", - "Variance score: 1.00\n", - "Mean absolute error: 11.69\n", - "[ 0. 28.18220995 282.79902342 842.30879705] 12.946893955209475\n" - ] - }, - { - "data": { - "image/png": "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\n", - "text/plain": [ - "
                  " - ] - }, - "metadata": { - "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", - "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", - "# The Ridge regression with a hyperparameter lambda = 0.1\n", - "_lambda = 0.1\n", - "clf_ridge = skl.Ridge(alpha=_lambda).fit(X, Energies)\n", - "yridge = clf_ridge.predict(X)\n", - "EoS['Eridge'] = yridge\n", - "# The mean squared error \n", - "print(\"Mean squared error: %.2f\" % mean_squared_error(Energies, yridge))\n", - "# Explained variance score: 1 is perfect prediction \n", - "print('Variance score: %.2f' % r2_score(Energies, yridge))\n", - "# Mean absolute error \n", - "print('Mean absolute error: %.2f' % mean_absolute_error(Energies, yridge))\n", - "print(clf_ridge.coef_, clf_ridge.intercept_)\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.plot(EoS['Density'], EoS['Eridge'], alpha=0.7, lw=2, c='g',\n", - " label='Ridge $\\lambda = 0.1$')\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", - "We note also that there is a small deviation between the\n", - "standard OLS and the Ridge regression at higher densities. We discuss this in more detail\n", - "below.\n", - "\n", - "\n", - "## Splitting our Data in Training and Test 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 (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." - ] - }, - { - "cell_type": "code", - "execution_count": 10, - "metadata": {}, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Training R2\n", - "0.9999848494015684\n", - "Training MSE\n", - "6.636161909712815\n", - "Test R2\n", - "0.9999887201912121\n", - "Test MSE\n", - "5.338085330411524\n" - ] - } - ], - "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": [ - "\n", - "## 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": 11, - "metadata": {}, - "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": 12, - "metadata": {}, - "outputs": [ - { - "data": { - "text/plain": [ - "dict_keys(['data', 'target', 'feature_names', 'DESCR', 'filename'])" - ] - }, - "execution_count": 12, - "metadata": {}, - "output_type": "execute_result" - } - ], - "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": 13, - "metadata": {}, - "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": 14, - "metadata": {}, - "outputs": [ - { - "data": { - "text/plain": [ - "CRIM 0\n", - "ZN 0\n", - "INDUS 0\n", - "CHAS 0\n", - "NOX 0\n", - "RM 0\n", - "AGE 0\n", - "DIS 0\n", - "RAD 0\n", - "TAX 0\n", - "PTRATIO 0\n", - "B 0\n", - "LSTAT 0\n", - "MEDV 0\n", - "dtype: int64" - ] - }, - "execution_count": 14, - "metadata": {}, - "output_type": "execute_result" - } - ], - "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": 15, - "metadata": {}, - "outputs": [ - { - "data": { - "image/png": "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\n", - "text/plain": [ - "
                  " - ] - }, - "metadata": {}, - "output_type": "display_data" - } - ], - "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": 16, - "metadata": {}, - "outputs": [ - { - "data": { - "text/plain": [ - "" - ] - }, - "execution_count": 16, - "metadata": {}, - "output_type": "execute_result" - }, - { - "data": { - "image/png": "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\n", - "text/plain": [ - "
                  " - ] - }, - "metadata": {}, - "output_type": "display_data" - } - ], - "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": 17, - "metadata": {}, - "outputs": [ - { - "data": { - "image/png": "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RkREREREREREQsw4KjBOVSMiIiIiIqJSwTEsMXBUQLHeeFZV+cGhBLbsPAQA/OERERERERGRr3AMSwCnqhXU9u7+rKUIAWA0mcb27v4itYiIiIiIiIhIjGNYAhg4KqjBoYStx4mIiIiIiIiKhWNYAjhVLW925ns21EeFP7CG+qjXzSQiIiIiIiKyRBnn6uEYNliYcZQHZb6nEgxS5nvGeuPC5y9rb0ZlJPuQV0ZCWNbe7HlbiYiIiIiIiMxox7laHMMGDwNHebA737OttQkrO1oy0dmG+ihWdrSwqBgRERERERH5gmicq+AYNpg4VS0PduZ7aqe03dE5hz82IiIiIiIi8hWj+kXrV883fb2dci5UGphxlAe9eZ3ax+1OaSMiIiIiIiIqBqvjXBGOfcsTA0d5sFqziEsYEhERERERUSnIpzYvx77liVPV8qCk25ml4RlNaVuzoYcpfEREREREROQLVse5InbKuRQDp9E5w8BRntpam0y/aA31UdMfkJLCp7wnERERERERUTFYGeeK6I19rUxz85oyjU7JiOIY3DpOVSsAUaqfCFP4iIiIiIiIqFTlM83Na5xG5xwzjgpAlOrn9xQ+IiIiIiIiIjvymebmNY7BnWPgqEC0qX5KbSMtP6TwERERERERETnhdJqb1/w8jc7vGDhyid0iW8vam7PmVwL+SeEjIiIiIiKi0sQC0GIcgzvHwJEL9IpsHT12Cvv7B4U/WD+n8BEREREREVHp8UMBaL8GrjgGd46BIxfoFdl6ft/xzP9FP1i/pvARERERERFR6TEqAF2IsacfAldGOAZ3hququcBqMS1WbCciIiIiIiKvFLsANFcuK08MHLmgpips+bms2E5EREREREReMCr0HOuNe779YgeuyBucquYCSZIsP7dUKrb7dV4qERERERERiS1rb8bGHX3Cv23bc8TzMR5XLitPDBy54Mxw0tLzwhJKomK73+elEhERERERUa621ibdwNGZ4WRm7OrVGM/vK5cxQcIZTlVzgdXoqRSynplUTJyXSkREREREVJqsjk+9GOO1tTZhZUdLpg0N9VGs7GjxRXBGSZBQMqKU4FkhpvCVOmYcuUAUVRVJpuSCVbPPB+elEhERERERlSar41PAmzGeX1cuK/aKc6WMgSMXtLU24eixU+h+/TjSMhCSgLQsfm4pBF84L5WIiIiIiKg0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OfPa2uoIhkeSSKlWP6uMhDD/iibs7x8UrqpmNuXt7EgKD3613XbbreyzqJBbTVUYt11nXribiIiIiIhIjxslMfSee3YkhYXzpmXGWLXVEciyjI07+rC9u99WgEa74rXeOElLG6gyWl16/er5pvvKch/kNQaO8mBUkd/K0vLaH7iVQE5jYx2eeeG3mecZMUqRzGdFNL1UyqrK3DRNIiIiIiIiO6yMpZy+BwD0HIhjZUcLANgaE2nHb42NdRgYOJ35v944qbY6gmhFWHecl+/q0m7UgyIywsBRHoxSKPWWVxwcSuAL39krnDamPhEpP0rOgP0AACAASURBVH71ko1trU144dV3HEWx1e+pnromarvZScaLothEREREREQAMLe5Iaesh92SGEbL3Y8m09i4oy+vMZGI3njozHASD3zlmqwxnjq7yc50M22QaG5zA3oOxB0lBBBZxcBRHowCKNofv5pyctL7URtlAz310puOotja99SeIM32Sc2NOwBERERERERasd44eg7kFsGef4W96VjKczfu6NN9Tj5jIhGjcZLZjA8r081E7yGqm5tP8ItIhKuq5cFsVbG21iasXz3fMKCi/KjVHtt9WDeT6f2Tw8L3OTOcxPrV87Fp7aLMso5qVir1G+2TmqhyP4tiExERERFRvvTGLfv7B22/V1trk6Ob2zVVYduvAYzHSUazVayyOqYDOBuE3MXAUR6sBlDMfrTqv8d64zg7Iq7CPziUgE5Q3PSEaOXEYTX409bahJUdLZltNtRHsbKjxbcR7VhvHGs29GDVur1Ys6HH1jKeRERERERUOG6XxdBbrt5IYiztaMxgNE7Kd79ivXFbx4CzQchNnKqWB6tzUc1WP6utjmDNhp5M7SG7rAR89NqgzOu1W0StVCr351MEnIiIiIiICsto3LJq3V5H4xZgfFaH3g16rWRKdjzVS2+clE+5D2VMYxVng5DbGDjKk5UAilFhtkhYwvBIEmeGkwD059nqsXri1KvU7+dMITcYpYT6eb9FKyMsXVBX7GYREREREXlKb+xkVifWSFtrE7Z391sOHCnbMRLrjeOpl2IYODlsaUyWz8ppRlPUKiMhzL+iCfv7B7mqGnmGgaMC0GYmqbN8RkaTtk5gWutXz3fUhqCcUEpxBTi9LKn6uiq0Xjy5yK0jIiIiIvKO3thJzcqNYO2NWLv9f6NM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b6KwMA/NzW1xf3d7GxARkXMZ3cekcjw96y+5oX8nIndi4oiISAdxGLj4RE+c5gXANYkLt68hlA5tQEREzmR0H2Nln+X2/p2InItT1YiIdEiHYeBuX0MoHdqAiIicyeg+xso+y+39OxE5F0ccERHpkA7DwMUnnG6d6pUObUBERM5kdB9jZZ+V2L9zVzUiMgoTR0REOqTLMHA9ayY4Tbq0AREROY/RfYzVfZbaGoFERMngVDUiIh04DNx+bAMiIjKL0X0M+ywiSgcccUREpIPbp3mlA7YBERGZxeg+hn0WEaUDJo6IiHRy8zSvdME2ICIisxjdx7DPIiK341Q1IiIiIiIiIiKSxMQRERERERERERFJYuKIiIiIiIiIiIgkMXFERERERERERESSmDgiIiIiIiIiIiJJTBwREREREREREZEkv90FSEZGhs/uItjKy+fv5XMHvH3+Xj53gOfv5fP30rl76VzdyKvt49Xztgrr11ysX/Oxjs3F+jWXWL9q9ewTBEGwokBEREREREREROQunKpGRERERERERESSmDgiIiIiIiIiIiJJTBwREREREREREZEkJo6IiIiIiIiIiEgSE0dERERERERERCSJiSMiIiIiIiIiIpLExBEREREREREREUli4oiIiIiIiIiIiCQxcURERERERERERJJckziqq6vDjBkzUFlZiT/+8Y92F8dyCxYsQHV1NWbNmoVZs2bh0KFDdhfJdO3t7aipqcGpU6cAAAcOHEBtbS0qKyuxevVqm0tnvsTzv++++1BZWRm9Bnbv3m1zCc3z+OOPo7q6GtXV1Xj00UcBeKf9pc7dS23/m9/8BjNmzEB1dTU2bNgAwDttD0ifv5fan8hpHnnkEdx77712FyPteDGutVp9fT3mzJmDqqoqPPTQQ3YXJ608//zz0Wt31qxZGDt2LH72s5/ZXay0sm3btmg8/Mgjj9hdnLT05JNPYtq0aaitrcVvf/tb9RcILtDU1CRMnjxZOHv2rHD+/HmhtrZWeP/99+0ulmUikYhQUVEh9PT02F0Uy7z99ttCTU2NUFZWJnz66adCMBgUJk6cKHzyySdCT0+PsHjxYuG1116zu5imSTx/QRCEmpoa4cyZMzaXzHwNDQ3CTTfdJHR1dQnd3d3CwoULhbq6Ok+0v9S5v/rqq55p+9dff12YN2+e0NPTIwSDQWHy5MnC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tw7bt2+HIAiIRCKYMGECli1bhs7OTixYsAAA0NHRgTNnzmDo0KEAgOuuuw733HMPenp6MHnyZJSWluL3v/89AODJJ5/EX/7yFwDAJ598gvz8fOTl5QEAHnvsMQwZMsSKUyYiIiJyvCuvvBLDhw9HRkYGfD4fgsEgcnNzsXz5cowcORIvvvgi7rvvPtx5551YunRp9HWCIGDq1KkIBALYvn27jWdARFZi4oiILLdz507s2bMHW7ZsQU5ODrq6urB06VI8/vjj+OEPf4ht27YBAF5//XX8/Oc/j/4s2r17N0pLS/HOO+/gxIkTGDZsGJYsWYIlS5YAABYsWIDvfve7mD59uuXnRkREROQGGzduxKBBg6I/r1+/Hg899BC2bNkCALjkkkvw8ssvxyWO3njjDXR2diIQCFheXiKyD6eqEZHlmpubEQ6H0dnZCQDIzs7GAw88gKlTp2p6/ebNm/Htb38bM2bMwMaNG80sKhEREVHaC4VCOH36NAYMGBD93fDhw9G3b1+8+eab0d+99NJLmDlzph1FJCIbMXFERJa74YYb0L9/f1RUVOCmm27CypUrcfr0aYwaNUr1tR988AHeeustTJ8+HbNnz8a2bdtw9uxZC0pNRERElD4WLVqE2tpaVFRUYNq0aQCAX/ziF3H/R4y1ACAYDOLgwYOYMGGC5WUlInsxcURElsvLy8NTTz2FnTt3Yu7cuWhpacGSJUuwatUq1ddu3rwZkydPRn5+PkaNGoVLL70UW7dutaDUREREROlj48aNqKurw+9+9zt0dnbimmuuQUFBQdz/qa2txe7du9Hd3Y3du3djypQpyMzMtKnERGQXJo6IyHLr1q3Dm2++iZKSEnznO9/BqlWrsG7dOmzatEnxdR0dHdi2bRsOHjyIKVOmYMqUKWhubsazzz6Lnp4ei0pPRERElD7Kyspw33334d5778WpU6fi/lZYWIgRI0bg73//O/785z/jhhtusKmURGQnJo6IyHKdnZ341a9+hXPnzkV/995772HEiBGKr6urq8PAgQOxb98+1NfXo76+Hnv27EFHRwd27dpldrGJiIiI0lJNTQ1GjRrVa6oacGG62oYNG9DW1obhw4fbUDoisht3VSMiU3V0dGDMmDFxv9u8eTN8Ph/mzZsHn8+HSCSCr33ta/j1r3+teKzNmzfj1ltvjRsi3b9/fyxYsABPP/00amtrTTkHIiIionT3wAMPYObMmdi3b1/c76dOnYoHH3wQy5Yts6lkRGQ3nyAIgt2FICIiIiIiIiIi5+FUNSIiIiIiIiIiksTEERERERERERERSWLiiIiIiIiIiIiIJDFxREREREREREREkpg4IiIiIiIiIiIiSUwcERERERERERGRJCaOiIiIiIiIiIhIEhNHREREREREREQk6f8DB/JCQBlla9IAAAAASUVORK5CYII=\n", - "text/plain": [ - "
                  " - ] - }, - "metadata": {}, - "output_type": "display_data" - } - ], - "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": 18, - "metadata": {}, - "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": 19, - "metadata": {}, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "(404, 2)\n", - "(102, 2)\n", - "(404,)\n", - "(102,)\n" - ] - } - ], - "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": 20, - "metadata": {}, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "The model performance for training set\n", - "--------------------------------------\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.137400784702911\n", - "R2 score is 0.6628996975186953\n" - ] - } - ], - "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": 21, - "metadata": {}, - "outputs": [ - { - "data": { - "image/png": "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\n", - "text/plain": [ - "
                  " - ] - }, - "metadata": {}, - "output_type": "display_data" - } - ], - "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", - "\n", - "## Preprocessing our data\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", - "**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", - "## More preprocessing\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", - "\n", - "## Simple preprocessing examples, Franke function and regression" - ] - }, - { - "cell_type": "code", - "execution_count": 22, - "metadata": {}, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "MSE before scaling: 0.00\n", - "R2 score before scaling 0.99\n", - "Feature min values before scaling:\n", - " [1.00000000e+00 5.70647611e-04 2.86109530e-05 3.25638696e-07\n", - " 1.63267720e-08 8.18586633e-10 1.85824944e-10 9.31683343e-12\n", - " 4.67124506e-13 2.34205437e-14 1.06040560e-13 5.31662874e-15\n", - " 2.66563483e-16 1.33648773e-17 6.70084075e-19 6.05117923e-17\n", - " 3.03392149e-18 1.52113815e-19 7.62663530e-21 3.82381876e-22\n", - " 1.91717440e-23]\n", - "Feature max values before scaling:\n", - " [1. 0.99888596 0.99975377 0.99777316 0.99864 0.99950759\n", - " 0.9966616 0.99752748 0.9983941 0.99926148 0.99555128 0.99641619\n", - " 0.99728185 0.99814827 0.99901543 0.9944422 0.99530615 0.99617084\n", - " 0.99703629 0.99790249 0.99876944]\n", - "Feature min values after scaling:\n", - " [ 0. -1.75397908 -1.83893651 -1.13595195 -1.1563748 -1.17802223\n", - " -0.89555231 -0.9052364 -0.91523154 -0.92555908 -0.76154161 -0.76696392\n", - " -0.77251583 -0.77820271 -0.78403036 -0.6735038 -0.67668971 -0.67993767\n", - " -0.68324996 -0.68662897 -0.69007714]\n", - "Feature max values after scaling:\n", - " [0. 1.70542138 1.71231136 2.1970696 2.20495992 2.2124631\n", - " 2.59210628 2.60447702 2.61644742 2.6280031 2.9321519 2.94723175\n", - " 2.96200187 2.97645003 2.99056362 3.23417362 3.25065381 3.26687534\n", - " 3.28282987 3.2985088 3.3139033 ]\n", - "MSE after scaling: 0.00\n", - "R2 score for scaled data: 0.99\n" - ] - } - ], - "source": [ - "# Common imports\n", - "import os\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.metrics import mean_squared_error\n", - "from sklearn.model_selection import train_test_split\n", - "from sklearn.preprocessing import MinMaxScaler, StandardScaler, Normalizer\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", - "\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 = 5\n", - "N = 1000\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", - "# split in training and test data\n", - "X_train, X_test, y_train, y_test = train_test_split(X,z,test_size=0.2)\n", - "\n", - "\n", - "clf = skl.LinearRegression().fit(X_train, y_train)\n", - "\n", - "# The mean squared error and R2 score\n", - "print(\"MSE before scaling: {:.2f}\".format(mean_squared_error(clf.predict(X_test), y_test)))\n", - "print(\"R2 score before scaling {:.2f}\".format(clf.score(X_test,y_test)))\n", - "\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", - "print(\"Feature min values before scaling:\\n {}\".format(X_train.min(axis=0)))\n", - "print(\"Feature max values before scaling:\\n {}\".format(X_train.max(axis=0)))\n", - "\n", - "print(\"Feature min values after scaling:\\n {}\".format(X_train_scaled.min(axis=0)))\n", - "print(\"Feature max values after scaling:\\n {}\".format(X_train_scaled.max(axis=0)))\n", - "\n", - "clf = skl.LinearRegression().fit(X_train_scaled, y_train)\n", - "\n", - "\n", - "print(\"MSE after scaling: {:.2f}\".format(mean_squared_error(clf.predict(X_test_scaled), y_test)))\n", - "print(\"R2 score for scaled data: {:.2f}\".format(clf.score(X_test_scaled,y_test)))" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## 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 as we\n", - "did both for the masses and the fitting of the equation of state,\n", - "leads to row vectors of the design matrix which are essentially\n", - "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. \n", - "\n", - "\n", - "\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 partially circumvent this problem and also gain some insights about the ordinary least squares approach, and later shrinkage methods like Ridge and Lasso regressions. \n", - "\n", - "This is given by the **Singular Value Decomposition** algorithm, perhaps\n", - "the most powerful linear algebra algorithm. Let us look at a\n", - "different example where we may have problems with the standard matrix\n", - "inversion algorithm. Thereafter we dive into the math of the SVD.\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "## Linear Regression Problems\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", - "## Fixing the singularity\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", - "## 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", - "## The SVD, a Fantastic Algorithm\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", - "## Economy-size SVD\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": 23, - "metadata": {}, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "[[ 1. -1. 2.]\n", - " [ 1. 0. 1.]\n", - " [ 1. 2. -1.]\n", - " [ 1. 1. 0.]]\n", - "[[ 4. 2. 2.]\n", - " [ 2. 6. -4.]\n", - " [ 2. -4. 6.]]\n", - "[[-1.96889890e-16 8.16496581e-01 -5.77350269e-01]\n", - " [-7.07106781e-01 4.08248290e-01 5.77350269e-01]\n", - " [ 7.07106781e-01 4.08248290e-01 5.77350269e-01]]\n", - "[1.00000000e+01 6.00000000e+00 2.38805416e-31]\n", - "[[-5.76324444e-17 -7.07106781e-01 7.07106781e-01]\n", - " [ 8.16496581e-01 4.08248290e-01 4.08248290e-01]\n", - " [-5.77350269e-01 5.77350269e-01 5.77350269e-01]]\n", - "[[ 1.39583657e+30 -1.39583657e+30 -1.39583657e+30]\n", - " [-1.39583657e+30 1.39583657e+30 1.39583657e+30]\n", - " [-1.39583657e+30 1.39583657e+30 1.39583657e+30]]\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", - " 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", - " 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", - "print(X)\n", - "A = np.transpose(X) @ X\n", - "print(A)\n", - "# Brute force inversion of super-collinear matrix\n", - "#B = np.linalg.inv(A)\n", - "#print(B)\n", - "C = SVDinv(A)\n", - "print(C)" - ] - }, - { - "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", - "## Mathematical Properties\n", - "\n", - "There are several interesting mathematical properties which will be\n", - "relevant when we are going to discuss the differences between say\n", - "ordinary least squares (OLS) and **Ridge** regression.\n", - "\n", - "We have from OLS that the parameters of the linear approximation are given by" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{\\tilde{y}} = \\boldsymbol{X}\\boldsymbol{\\beta} = \\boldsymbol{X}\\left(\\boldsymbol{X}^T\\boldsymbol{X}\\right)^{-1}\\boldsymbol{X}^T\\boldsymbol{y}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "The matrix to invert can be rewritten in terms of our SVD decomposition 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": [ - "Using the orthogonality properties of $\\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 = \\boldsymbol{V}\\boldsymbol{D}\\boldsymbol{V}^T,\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with $\\boldsymbol{D}$ being a diagonal matrix with values along the diagonal given by the singular values squared. \n", - "\n", - "This means that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "(\\boldsymbol{X}^T\\boldsymbol{X})\\boldsymbol{V} = \\boldsymbol{V}\\boldsymbol{D},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "that is the eigenvectors of $(\\boldsymbol{X}^T\\boldsymbol{X})$ are given by the columns of the right singular matrix of $\\boldsymbol{X}$ and the eigenvalues are the squared singular values. It is easy to show (show this) that" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "(\\boldsymbol{X}\\boldsymbol{X}^T)\\boldsymbol{U} = \\boldsymbol{U}\\boldsymbol{D},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "that is, the eigenvectors of $(\\boldsymbol{X}\\boldsymbol{X})^T$ are the columns of the left singular matrix and the eigenvalues are the same. \n", - "\n", - "Going back to our OLS equation we have" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}\\boldsymbol{\\beta} = \\boldsymbol{X}\\left(\\boldsymbol{V}\\boldsymbol{D}\\boldsymbol{V}^T \\right)^{-1}\\boldsymbol{X}^T\\boldsymbol{y}=\\boldsymbol{U\\Sigma V^T}\\left(\\boldsymbol{V}\\boldsymbol{D}\\boldsymbol{V}^T \\right)^{-1}(\\boldsymbol{U\\Sigma V^T})^T\\boldsymbol{y}=\\boldsymbol{U}\\boldsymbol{U}^T\\boldsymbol{y}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We will come back to this expression when we discuss Ridge regression. \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": [ - "## More on Ridge Regression\n", - "\n", - "Using the matrix-vector expression for Ridge regression," - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "C(\\boldsymbol{X},\\boldsymbol{\\beta})=\\frac{1}{n}\\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": [ - "by 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" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\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", - "We see that Ridge regression is nothing but the standard\n", - "OLS with a modified diagonal term added to $\\boldsymbol{X}^T\\boldsymbol{X}$. The\n", - "consequences, in particular for our discussion of the bias-variance tradeoff \n", - "are rather interesting.\n", - "\n", - "Furthermore, if we use the result above in terms of the SVD decomposition (our analysis was done for the OLS method), we had" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "(\\boldsymbol{X}\\boldsymbol{X}^T)\\boldsymbol{U} = \\boldsymbol{U}\\boldsymbol{D}.\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We can analyse 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", - "\\boldsymbol{X}\\boldsymbol{\\beta} = \\boldsymbol{X}\\left(\\boldsymbol{V}\\boldsymbol{D}\\boldsymbol{V}^T \\right)^{-1}\\boldsymbol{X}^T\\boldsymbol{y}=\\boldsymbol{U\\Sigma V^T}\\left(\\boldsymbol{V}\\boldsymbol{D}\\boldsymbol{V}^T \\right)^{-1}(\\boldsymbol{U\\Sigma V^T})^T\\boldsymbol{y}=\\boldsymbol{U}\\boldsymbol{U}^T\\boldsymbol{y}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "For Ridge regression this becomes" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X}\\boldsymbol{\\beta}^{\\mathrm{Ridge}} = \\boldsymbol{U\\Sigma V^T}\\left(\\boldsymbol{V}\\boldsymbol{D}\\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}$. \n", - "\n", - "## Interpreting the Ridge results\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.\n", - "Actually, calculating the variance of $\\boldsymbol{X}\\boldsymbol{v}_j$ shows that this quantity is equal to $\\sigma_j^2/n$.\n", - "With a parameter $\\lambda$ we can thus shrink the role of specific parameters. \n", - "\n", - "\n", - "## More interpretations\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", - "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", - "## A better understanding of regularization\n", - "\n", - "The parameter $\\lambda$ that we have introduced in the Ridge (and\n", - "Lasso as well) regression is often called a regularization parameter\n", - "or shrinkage parameter. It is common to call it a hyperparameter. What does it mean mathemtically?\n", - "\n", - "Here we will first look at how to analyze the difference between the\n", - "standard OLS equations and the Ridge expressions in terms of a linear\n", - "algebra analysis using the SVD algorithm. Thereafter, we will link\n", - "(see the material on the bias-variance tradeoff below) these\n", - "observation to the statisical analysis of the results. In particular\n", - "we consider how the variance of the parameters $\\boldsymbol{\\beta}$ is\n", - "affected by changing the parameter $\\lambda$.\n", - "\n", - "## Decomposing the OLS and Ridge expressions\n", - "\n", - "We have our design matrix\n", - " $\\boldsymbol{X}\\in {\\mathbb{R}}^{n\\times p}$. With the SVD we decompose it as" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "$$\n", - "\\boldsymbol{X} = \\boldsymbol{U\\Sigma V^T},\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "with $\\boldsymbol{U}\\in {\\mathbb{R}}^{n\\times n}$, $\\boldsymbol{\\Sigma}\\in {\\mathbb{R}}^{n\\times p}$\n", - "and $\\boldsymbol{V}\\in {\\mathbb{R}}^{p\\times p}$.\n", - "\n", - "The matrices $\\boldsymbol{U}$ and $\\boldsymbol{V}$ are unitary/orthonormal matrices, that is in case the matrices are real we have $\\boldsymbol{U}^T\\boldsymbol{U}=\\boldsymbol{U}\\boldsymbol{U}^T=\\boldsymbol{I}$ and $\\boldsymbol{V}^T\\boldsymbol{V}=\\boldsymbol{V}\\boldsymbol{V}^T=\\boldsymbol{I}$.\n", - "\n", - "\n", - "\n", - "## Introducing the Covariance and Correlation functions\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 \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", - "## Correlation Function and Design/Feature Matrix\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": [ - "## Covariance Matrix Examples\n", - "\n", - "\n", - "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": 24, - "metadata": {}, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "-0.0735582043568682\n", - "3.7149125577492423\n", - "[[0.83993344 2.70399972]\n", - " [2.70399972 9.43403589]]\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": 25, - "metadata": {}, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "0.07408034549174136\n", - "1.227878920600447\n", - "[[1. 0.56471431]\n", - " [0.56471431 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", - "## Correlation Matrix with Pandas\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": 26, - "metadata": {}, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "[[ 1.07759721 4.53322612]\n", - " [-0.00649067 -1.36010021]\n", - " [-0.85832442 -3.75508933]\n", - " [-0.37345884 -1.18878828]\n", - " [ 0.57144364 1.84634906]\n", - " [-1.38212043 -4.65301078]\n", - " [-0.65245525 -1.6006181 ]\n", - " [ 1.83103728 6.43606823]\n", - " [-0.7874819 -1.38076019]\n", - " [ 0.58025338 1.12272347]]\n", - " 0 1\n", - "0 1.077597 4.533226\n", - "1 -0.006491 -1.360100\n", - "2 -0.858324 -3.755089\n", - "3 -0.373459 -1.188788\n", - "4 0.571444 1.846349\n", - "5 -1.382120 -4.653011\n", - "6 -0.652455 -1.600618\n", - "7 1.831037 6.436068\n", - "8 -0.787482 -1.380760\n", - "9 0.580253 1.122723\n", - " 0 1\n", - "0 1.000000 0.971936\n", - "1 0.971936 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.\n", - "\n", - "## Correlation Matrix with Pandas and the Franke function" - ] - }, - { - "cell_type": "code", - "execution_count": 27, - "metadata": {}, - "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.084667 0.085622 0.084600 0.084265 0.083876 0.075986 0.075499 \n", - "2 0.0 0.085622 0.088547 0.088431 0.089114 0.089546 0.081167 0.081248 \n", - "3 0.0 0.084600 0.088431 0.089974 0.091151 0.092025 0.084268 0.084657 \n", - "4 0.0 0.084265 0.089114 0.091151 0.092931 0.094306 0.086374 0.087133 \n", - "5 0.0 0.083876 0.089546 0.092025 0.094306 0.096103 0.088060 0.089134 \n", - "6 0.0 0.075986 0.081167 0.084268 0.086374 0.088060 0.081340 0.082355 \n", - "7 0.0 0.075499 0.081248 0.084657 0.087133 0.089134 0.082355 0.083612 \n", - "8 0.0 0.075062 0.081279 0.084969 0.087758 0.090029 0.083217 0.084683 \n", - "9 0.0 0.074679 0.081285 0.085233 0.088289 0.090794 0.083968 0.085617 \n", - "10 0.0 0.067442 0.073098 0.077082 0.079656 0.081772 0.076102 0.077480 \n", - "11 0.0 0.067096 0.073089 0.077282 0.080091 0.082412 0.076723 0.078263 \n", - "12 0.0 0.066811 0.073089 0.077476 0.080488 0.082988 0.077292 0.078974 \n", - "13 0.0 0.066586 0.073106 0.077674 0.080864 0.083521 0.077826 0.079634 \n", - "14 0.0 0.066416 0.073146 0.077885 0.081231 0.084028 0.078339 0.080260 \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.075062 0.074679 0.067442 0.067096 0.066811 0.066586 0.066416 \n", - "2 0.081279 0.081285 0.073098 0.073089 0.073089 0.073106 0.073146 \n", - "3 0.084969 0.085233 0.077082 0.077282 0.077476 0.077674 0.077885 \n", - "4 0.087758 0.088289 0.079656 0.080091 0.080488 0.080864 0.081231 \n", - "5 0.090029 0.090794 0.081772 0.082412 0.082988 0.083521 0.084028 \n", - "6 0.083217 0.083968 0.076102 0.076723 0.077292 0.077826 0.078339 \n", - "7 0.084683 0.085617 0.077480 0.078263 0.078974 0.079634 0.080260 \n", - "8 0.085937 0.087033 0.078670 0.079596 0.080434 0.081207 0.081935 \n", - "9 0.087033 0.088272 0.079721 0.080773 0.081724 0.082600 0.083420 \n", - "10 0.078670 0.079721 0.072443 0.073326 0.074132 0.074882 0.075591 \n", - "11 0.079596 0.080773 0.073326 0.074322 0.075229 0.076069 0.076860 \n", - "12 0.080434 0.081724 0.074132 0.075229 0.076226 0.077148 0.078014 \n", - "13 0.081207 0.082600 0.074882 0.076069 0.077148 0.078145 0.079080 \n", - "14 0.081935 0.083420 0.075591 0.076860 0.078014 0.079080 0.080079 \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", - "## Rewriting the Covariance and/or Correlation Matrix\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", - "## Linking with SVD\n", - "\n", - "See lecture september 11. More text to be added here soon.\n", - "\n", - "\n", - "\n", - "\n", - "## Where are we going?\n", - "\n", - "Before we proceed, we need to rethink what we have been doing. In our\n", - "eager to fit the data, we have omitted several important elements in\n", - "our regression analysis. In what follows we will\n", - "1. look at statistical properties, including a discussion of mean values, variance and the so-called bias-variance tradeoff\n", - "\n", - "2. introduce resampling techniques like cross-validation, bootstrapping and jackknife and more\n", - "\n", - "This will allow us to link the standard linear algebra methods we have discussed above to a statistical interpretation of the methods. \n", - "\n", - "\n", - "\n", - "\n", - "\n", - "## Resampling methods\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", - "\n", - "\n", - "## Resampling approaches can be computationally expensive\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", - "\n", - "## Why resampling methods ?\n", - "**Statistical analysis.**\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", - " \n", - "\n", - "## Statistical analysis\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", - " \n", - "\n", - "\n", - "\n", - "\n", - "\n", - "## Linking the regression analysis with a statistical interpretation\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", - "## Assumptions made\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": [ - "## Expectation value and variance\n", - "\n", - "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", - "## Expectation value and variance for $\\boldsymbol{\\beta}$\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 \\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", - "## 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", - "\n", - "## Resampling methods: Jackknife and Bootstrap\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", - "## Resampling methods: Jackknife\n", - "\n", - "The Jackknife works by making many replicas of the estimator $\\widehat{\\theta}$. \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{\\theta}_i$ to be the estimator\n", - "$\\widehat{\\theta}$ computed using $\\vec{X}_i$. \n", - "\n", - "\n", - "## Jackknife code example" - ] - }, - { - "cell_type": "code", - "execution_count": 28, - "metadata": {}, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Runtime: 0.233321 sec\n", - "Jackknife Statistics :\n", - "original bias std. error\n", - " 99.6932 99.6833 0.149184\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": [ - "## Resampling methods: Bootstrap\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", - "\n", - "\n", - "\n", - "## Resampling methods: Bootstrap background\n", - "\n", - "Since $\\widehat{\\theta} = \\widehat{\\theta}(\\boldsymbol{X})$ is a function of random variables,\n", - "$\\widehat{\\theta}$ 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{\\theta}$. 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", - "## Resampling methods: More Bootstrap background\n", - "\n", - "In the case that $\\widehat{\\theta}$ 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{\\theta}$ called $\\widehat{\\theta}^*$. \n", - "\n", - "By repeated use of (1) and (2), many\n", - "estimates of $\\widehat{\\theta}$ could have been obtained. The\n", - "idea is to use the relative frequency of $\\widehat{\\theta}^*$\n", - "(think of a histogram) as an estimate of $p(\\boldsymbol{t})$.\n", - "\n", - "## Resampling methods: Bootstrap approach\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", - "## Resampling methods: Bootstrap steps\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{\\theta}^*$ by evaluating $\\widehat \\theta$ 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 \\theta^*$. 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{\\theta}^*$. 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", - "\\theta$, apply the etsimator $\\widehat \\sigma^2$ to the values\n", - "$\\widehat \\theta ^*$.\n", - "\n", - "\n", - "## Code example for the Bootstrap method\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": 29, - "metadata": {}, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Runtime: 2.03116 sec\n", - "Bootstrap Statistics :\n", - "original bias std. error\n", - " 99.8535 14.9035 99.8557 0.149538\n" - ] - }, - { - "ename": "AttributeError", - "evalue": "'Rectangle' object has no property 'normed'", - "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 29\u001b[0m \u001b[0mt\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mbootstrap\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mx\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mstat\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mdatapoints\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m 30\u001b[0m \u001b[0;31m# the histogram of the bootstrapped data\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0;32m---> 31\u001b[0;31m \u001b[0mn\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mbinsboot\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mpatches\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mplt\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mhist\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mt\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0;36m50\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mnormed\u001b[0m\u001b[0;34m=\u001b[0m\u001b[0;36m1\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mfacecolor\u001b[0m\u001b[0;34m=\u001b[0m\u001b[0;34m'red'\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0malpha\u001b[0m\u001b[0;34m=\u001b[0m\u001b[0;36m0.75\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 32\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m 33\u001b[0m \u001b[0;31m# add a 'best fit' line\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n", - "\u001b[0;32m~/anaconda3/lib/python3.6/site-packages/matplotlib/pyplot.py\u001b[0m in \u001b[0;36mhist\u001b[0;34m(x, bins, range, density, weights, cumulative, bottom, histtype, align, orientation, rwidth, log, color, label, stacked, data, **kwargs)\u001b[0m\n\u001b[1;32m 2608\u001b[0m \u001b[0malign\u001b[0m\u001b[0;34m=\u001b[0m\u001b[0malign\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0morientation\u001b[0m\u001b[0;34m=\u001b[0m\u001b[0morientation\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mrwidth\u001b[0m\u001b[0;34m=\u001b[0m\u001b[0mrwidth\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mlog\u001b[0m\u001b[0;34m=\u001b[0m\u001b[0mlog\u001b[0m\u001b[0;34m,\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m 2609\u001b[0m color=color, label=label, stacked=stacked, **({\"data\": data}\n\u001b[0;32m-> 2610\u001b[0;31m if data is not None else {}), **kwargs)\n\u001b[0m\u001b[1;32m 2611\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m 2612\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n", - "\u001b[0;32m~/anaconda3/lib/python3.6/site-packages/matplotlib/__init__.py\u001b[0m in \u001b[0;36minner\u001b[0;34m(ax, data, *args, **kwargs)\u001b[0m\n\u001b[1;32m 1563\u001b[0m \u001b[0;32mdef\u001b[0m \u001b[0minner\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0max\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0;34m*\u001b[0m\u001b[0margs\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mdata\u001b[0m\u001b[0;34m=\u001b[0m\u001b[0;32mNone\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[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m 1564\u001b[0m \u001b[0;32mif\u001b[0m \u001b[0mdata\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[0;32m-> 1565\u001b[0;31m \u001b[0;32mreturn\u001b[0m \u001b[0mfunc\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0max\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0;34m*\u001b[0m\u001b[0mmap\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0msanitize_sequence\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0margs\u001b[0m\u001b[0;34m)\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 1566\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m 1567\u001b[0m \u001b[0mbound\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mnew_sig\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mbind\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0max\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0;34m*\u001b[0m\u001b[0margs\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0;34m**\u001b[0m\u001b[0mkwargs\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n", - "\u001b[0;32m~/anaconda3/lib/python3.6/site-packages/matplotlib/axes/_axes.py\u001b[0m in \u001b[0;36mhist\u001b[0;34m(self, x, bins, range, density, weights, cumulative, bottom, histtype, align, orientation, rwidth, log, color, label, stacked, **kwargs)\u001b[0m\n\u001b[1;32m 6806\u001b[0m \u001b[0;32mif\u001b[0m \u001b[0mpatch\u001b[0m\u001b[0;34m:\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m 6807\u001b[0m \u001b[0mp\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0mpatch\u001b[0m\u001b[0;34m[\u001b[0m\u001b[0;36m0\u001b[0m\u001b[0;34m]\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0;32m-> 6808\u001b[0;31m \u001b[0mp\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mupdate\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 6809\u001b[0m \u001b[0;32mif\u001b[0m \u001b[0mlbl\u001b[0m \u001b[0;32mis\u001b[0m \u001b[0;32mnot\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 6810\u001b[0m \u001b[0mp\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mset_label\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mlbl\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n", - "\u001b[0;32m~/anaconda3/lib/python3.6/site-packages/matplotlib/artist.py\u001b[0m in \u001b[0;36mupdate\u001b[0;34m(self, props)\u001b[0m\n\u001b[1;32m 1004\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m 1005\u001b[0m \u001b[0;32mwith\u001b[0m \u001b[0mcbook\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0m_setattr_cm\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mself\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0meventson\u001b[0m\u001b[0;34m=\u001b[0m\u001b[0;32mFalse\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-> 1006\u001b[0;31m \u001b[0mret\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0;34m[\u001b[0m\u001b[0m_update_property\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mself\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mk\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mv\u001b[0m\u001b[0;34m)\u001b[0m \u001b[0;32mfor\u001b[0m \u001b[0mk\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mv\u001b[0m \u001b[0;32min\u001b[0m \u001b[0mprops\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mitems\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m]\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0m\u001b[1;32m 1007\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m 1008\u001b[0m \u001b[0;32mif\u001b[0m \u001b[0mlen\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mret\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~/anaconda3/lib/python3.6/site-packages/matplotlib/artist.py\u001b[0m in \u001b[0;36m\u001b[0;34m(.0)\u001b[0m\n\u001b[1;32m 1004\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m 1005\u001b[0m \u001b[0;32mwith\u001b[0m \u001b[0mcbook\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0m_setattr_cm\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mself\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0meventson\u001b[0m\u001b[0;34m=\u001b[0m\u001b[0;32mFalse\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-> 1006\u001b[0;31m \u001b[0mret\u001b[0m \u001b[0;34m=\u001b[0m \u001b[0;34m[\u001b[0m\u001b[0m_update_property\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mself\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mk\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mv\u001b[0m\u001b[0;34m)\u001b[0m \u001b[0;32mfor\u001b[0m \u001b[0mk\u001b[0m\u001b[0;34m,\u001b[0m \u001b[0mv\u001b[0m \u001b[0;32min\u001b[0m \u001b[0mprops\u001b[0m\u001b[0;34m.\u001b[0m\u001b[0mitems\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m]\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[0m\u001b[1;32m 1007\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m 1008\u001b[0m \u001b[0;32mif\u001b[0m \u001b[0mlen\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mret\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~/anaconda3/lib/python3.6/site-packages/matplotlib/artist.py\u001b[0m in \u001b[0;36m_update_property\u001b[0;34m(self, k, v)\u001b[0m\n\u001b[1;32m 1000\u001b[0m \u001b[0;32mif\u001b[0m \u001b[0;32mnot\u001b[0m \u001b[0mcallable\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mfunc\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 1001\u001b[0m raise AttributeError('{!r} object has no property {!r}'\n\u001b[0;32m-> 1002\u001b[0;31m .format(type(self).__name__, k))\n\u001b[0m\u001b[1;32m 1003\u001b[0m \u001b[0;32mreturn\u001b[0m \u001b[0mfunc\u001b[0m\u001b[0;34m(\u001b[0m\u001b[0mv\u001b[0m\u001b[0;34m)\u001b[0m\u001b[0;34m\u001b[0m\u001b[0;34m\u001b[0m\u001b[0m\n\u001b[1;32m 1004\u001b[0m \u001b[0;34m\u001b[0m\u001b[0m\n", - "\u001b[0;31mAttributeError\u001b[0m: 'Rectangle' object has no property 'normed'" - ] - }, - { - "data": { - "image/png": "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Y8eOtLS0ZNasWWlqasqePXuSJO3t7WlpaRn1gQEA4JWM+JXbpqambNiwIatWrUpfX18WLlyYJUuWJEk2btyYdevWpaenJ/PmzcvKlStHfWAAAHglw47bhx56aOifFyxYkG3btp2wZu7cudm6devoTAYAACPkE8oAACiGuAUAoBjiFgCAYohbAACKIW4BACiGuAUAoBjiFgCAYvigezhFzedOz7QmdyGgDMeOD6RSaR72+t6+/nQfOVrHieDUeGaGUzStqTGtq9uHvX77ncvrOA3A6Zk6ZfKIH9O66zgPnCqXJQAAUAxxCwBAMcQtAADFELcAABRD3AIAUAxxCwBAMcQtAADFELcAABRD3AIAUAxxCwBAMcQtAADFELcAABRD3AIAUAxxCwBAMRrHegAAYOI5dnwglUrzsNf39vWn+8jROk4EvyJuAYARmzplclpXtw97/fY7l6e7jvPAb7gsAQCAYohbAACKIW4BACiGa27h15rPnZ5pTe4SADCReSaHX5vW1DjiX44AAMYXlyUAAFAMcQsAQDHELQAAxXDNLQBQdy/3iWav9AlnPs2M0yFuAYC6G8knmvk0M06HyxIAACiGuAUAoBjiFgCAYohbAACK4RfKKJaP0wWAs49nforl43QB4OzjsgQAAIohbgEAKIa4BQCgGOIWAIBiiFsAAIrh3RIYUyN9u66+YwNpmjq5jhMBABOZuGVMncrbdQ13vbf2AoCzj7gFAMaVY8cHUqk0D3t9b19/uo8creNETCTiFgAYV6ZOmTzin+p113EeJha/UAYAQDG8cgsATGguY+CFxC0AMKG5jIEXEre8Kv83DABMJOKWV+X/hgFgZEb6Hu5eGBpd4hYAOKvU+6eSp/Ie7l4YGj3illE10gcMADjT/FSybOL2LDPSH5WM1Kk8YADAeOaFm4mlLpWzffv23H333env78/73ve+XHPNNfX4NpyCU/lRCQCczbxwM7GMetx2dnZm06ZNuf/++zN16tSsWLEif/RHf5Tf//3fH+1vVSQXoQPA2WU8vTPReJrlVI163O7evTtvfetb85rXvCZJsnjx4nR0dOQjH/nIsG4/aVLDaI80pmbMmJamEV4G8P/u+Kdhr737428f8Y9KqudNP2vWj6dZzrb142mWs239eJploq8fT7OcbevH0yz1Xj91yuS6Pvf39fWnp6e3LrN8ed2iPH+G2+1krdhQq9Vqo/kNv/SlL+WXv/xlbrnlliTJt771rezduzef/vSnR/PbAADACSaN9l84ODiYhob/v6hrtdqLvgYAgHoZ9bidOXNmurq6hr7u6upKtVod7W8DAAAnGPW4fdvb3pYf//jHefbZZ3P06NH80z/9U1paWkb72wAAwAlG/RfKLrjggtxyyy1ZuXJljh8/nquuuipvetObRvvbAADACUb9F8oAAGCsjPplCQAAMFbELQAAxRC3AAAUQ9wCAFAMcXsWu+eee7J48eK0trbm7rvvTpLcf//9ueKKK9La2po77rgj/f39r3j7xx57LH/4h394psY9a5zqvhw8eDAf+tCH8q53vSsrVqzI008/faZHL9qp7svTTz+da665JsuXL8+1116bAwcOnOnRi9PT05Nly5YN/Te+e/futLa2ZtGiRdm0adPQun379qWtrS2LFy/O2rVrX3Z/jhw5kg996EO5/PLLc80117zofdoZmdHcl5///OdD95v3vOc92bdv3xk7j9KM5r78xv/+7//mLW95y/h9nqlxVvrXf/3X2rJly2rd3d21/v7+2vXXX1/70pe+VLv00ktrnZ2dtVqtVrv99ttr995778ve/pe//GVtxYoVtT/4gz84k2MX73T25X3ve1/tG9/4Rq1Wq9W+8Y1v1G666aYzOnvJTmdfPvaxj9W+/vWv12q1Wu2rX/1qbfXq1Wd09tL8x3/8R23ZsmW1efPm1Z566qna0aNHawsXLqz9z//8T+348eO1D3zgA7Uf/OAHtVqtVlu6dGnt3//932u1Wq32N3/zN0P78ELr16+vfelLX6rVarXaAw884H5zikZ7X1asWFH7/ve/X6vVarXdu3fXWltbz9i5lGS096VWq9UGBgZqH/jAB2rz58+vPfXUU2fsXEbCK7dnqcceeyx/8id/khkzZmTy5Mm59NJL88UvfjHz588f+kS5yy67LN/97ndf9vYbNmzI+973vjM58lnhVPfl2Wefzc9+9rOsWLEiSXLllVfm5ptvPuPzl+p07i+Dg4Pp6elJkhw9ejTTpk07o7OXZsuWLbn99tuH/r3v3bs3c+bMyezZs9PY2JjW1tZ0dHTkwIED6e3tzfz585MkbW1t6ejoOOHv+8EPfpDW1tYkybJly/Iv//IvOX78+Jk7oUKM9r68+93vzqWXXpokeeMb35hnnnnmzJ1MQUZ7X5Lk7//+7/O2t70t55133hk7j5ESt2epefPm5Uc/+lGee+659PX15aGHHsr8+fPzyCOP5JlnnsnAwEA6Ojpy6NChE277ve99L729vVmyZMkYTF62U92Xp556Kr/zO7+TDRs25Morr8xHP/rRTJkyZYzOojync3+56aab8g//8A+59NJLc++99+aDH/zgGJxBOT7zmc/kkksuGfr64MGDqVQqQ19Xq9V0dnaecLxSqaSzs/OEv++F6xobGzNjxow8++yzdTyDMo32vrS1tWXy5MlJkrvuuivveMc76jh9uUZ7Xx599LNj6HQAAAPTSURBVNH85Cc/yV/+5V/Wd/DTJG7PUgsWLEhbW1uuvfbaXHfddbn44oszffr0rF69OjfeeGOuueaavPGNbzwhkLq6unL33Xfnk5/85BhNXrZT3Zf+/v489thjeetb35pvf/vbefvb355PfOITY3QW5TnVfUmSj3/84/nUpz6VH/7wh1m/fn0+8pGPpOazc0bN4OBgGhoahr6u1WppaGh4xeMnU6vVMmmSp8bTNRr7UqvV8rnPfS6PPPJI1qxZU/eZzwansy9Hjx7N+vXrc8cdd4z7+8j4no666enpyaJFi7J9+/bcd999mTp1ai644IK86U1vyne+851885vfzAUXXJDZs2e/6HY/+MEP8txzzw1d6J8ky5cvH/qxK6fnVPelUqnknHPOyWWXXZbkVz9e3bt371icQpFOdV+effbZPP7440OvOi1evDhdXV35xS9+MRanUaSZM2e+6JfAurq6Uq1WTzh+6NChoR/NvlC1Wh16xb2/vz/PP/98XvOa19R/8MKd7r709/fnYx/7WP7zP/8zX/3qV9Pc3HxG5i7d6ezLww8/nMOHD+fGG2/M8uXLh36J+fHHHz9j8w+XuD1LPf300/mrv/qr9Pf3p7u7O1u3bs3y5cvz/ve/Pz09PTl27Fi+9rWv5YorrnjR7d797nfnu9/9btrb29Pe3p4kaW9vz4wZM8biNIpzqvvyu7/7u5k5c2Z27dqVJPn+97+fefPmjcUpFOlU9+W8885LU1NTHn744STJnj17cs455+S1r33tWJxGkS666KI88cQT2b9/fwYGBrJjx460tLRk1qxZaWpqyp49e5L86nGqpaXlhNsvXLgw3/nOd5IkO3fuzCWXXOKSnlFwuvvyuc99Lj09Pbn33nuF7Sg6nX259NJL89BDDw09/1er1dxzzz15/etfPxan8qoax3oAxsbcuXOzaNGivPOd78zAwEDe//735+KLL86HP/zhvOc970l/f3+WLVs29IsWa9euzZ/92Z/l7W9/+xhPXrbT2ZcvfOELuf322/N3f/d3mTFjRjZs2DDGZ1OO09mXL37xi/n0pz+d3t7enHPOOfnCF74wxmdTlqampmzYsCGrVq1KX19fFi5cOPT7ABs3bsy6devS09OTefPmZeXKlUmSz3/+86lWq3nve9+bm266KZ/4xCeydOnSNDc3Z+PGjWN5OsU4nX1ZvHhxvv71r+fCCy/Mu9/97qG/8zcvqHDqTvf+MlE01Fz8BQBAIVyWAABAMcQtAADFELcAABRD3AIAUAxxCwBAMcQtAADFELcAABRD3AIAUIz/D/YNsOLkFOpDAAAAAElFTkSuQmCC\n", - "text/plain": [ - "
                  " - ] - }, - "metadata": {}, - "output_type": "display_data" - } - ], - "source": [ - "from numpy import *\n", - "from numpy.random import randint, randn\n", - "from time import time\n", - "import matplotlib.mlab as mlab\n", - "import matplotlib.pyplot as plt\n", - "\n", - "# Returns mean of bootstrap samples \n", - "def stat(data):\n", - " return mean(data)\n", - "\n", - "# Bootstrap algorithm\n", - "def bootstrap(data, statistic, R):\n", - " t = zeros(R); n = len(data); inds = arange(n); t0 = time()\n", - " # non-parametric bootstrap \n", - " for i in range(R):\n", - " t[i] = statistic(data[randint(0,n,n)])\n", - "\n", - " # analysis \n", - " print(\"Runtime: %g sec\" % (time()-t0)); print(\"Bootstrap Statistics :\")\n", - " print(\"original bias std. error\")\n", - " print(\"%8g %8g %14g %15g\" % (statistic(data), std(data),mean(t),std(t)))\n", - " return t\n", - "\n", - "\n", - "mu, sigma = 100, 15\n", - "datapoints = 10000\n", - "x = mu + sigma*random.randn(datapoints)\n", - "# bootstrap returns the data sample \n", - "t = bootstrap(x, stat, datapoints)\n", - "# the histogram of the bootstrapped data \n", - "n, binsboot, patches = plt.hist(t, 50, normed=1, facecolor='red', alpha=0.75)\n", - "\n", - "# add a 'best fit' line \n", - "y = mlab.normpdf( binsboot, mean(t), std(t))\n", - "lt = plt.plot(binsboot, y, 'r--', linewidth=1)\n", - "plt.xlabel('Smarts')\n", - "plt.ylabel('Probability')\n", - "plt.axis([99.5, 100.6, 0, 3.0])\n", - "plt.grid(True)\n", - "\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "\n", - "## Various steps in 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", - "## How to set up the cross-validation for Ridge and/or Lasso\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": [ - "## Cross-validation in brief\n", - "\n", - "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", - "## Code Example for Cross-validation and $k$-fold Cross-validation\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": {}, - "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": [ - "## 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}$.\n", - "\n", - "\n", - "\n", - "\n", - "\n", - "## Example code for Bias-Variance tradeoff" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": {}, - "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": "markdown", - "metadata": {}, - "source": [ - "## Understanding what happens" - ] - }, - { - "cell_type": "code", - "execution_count": 32, - "metadata": {}, - "outputs": [ - { - "name": "stdout", - "output_type": "stream", - "text": [ - "Polynomial degree: 0\n", - "Error: 0.2937910450030775\n", - "Bias^2: 0.2929212799917661\n", - "Var: 0.0008697650113114119\n", - "0.2937910450030775 >= 0.2929212799917661 + 0.0008697650113114119 = 0.2937910450030775\n", - "Polynomial degree: 1\n", - "Error: 0.06894146856540674\n", - "Bias^2: 0.06832043024896824\n", - "Var: 0.0006210383164384989\n", - "0.06894146856540674 >= 0.06832043024896824 + 0.0006210383164384989 = 0.06894146856540674\n", - "Polynomial degree: 2\n", - "Error: 0.06106765054837855\n", - "Bias^2: 0.060547654220995305\n", - "Var: 0.0005199963273832372\n", - "0.06106765054837855 >= 0.060547654220995305 + 0.0005199963273832372 = 0.061067650548378545\n", - "Polynomial degree: 3\n", - "Error: 0.03346202229536659\n", - "Bias^2: 0.0331409564680546\n", - "Var: 0.00032106582731199456\n", - "0.03346202229536659 >= 0.0331409564680546 + 0.00032106582731199456 = 0.03346202229536659\n", - "Polynomial degree: 4\n", - "Error: 0.0335277871704832\n", - "Bias^2: 0.03311607538577367\n", - "Var: 0.0004117117847095335\n", - "0.0335277871704832 >= 0.03311607538577367 + 0.0004117117847095335 = 0.03352778717048321\n", - "Polynomial degree: 5\n", - "Error: 0.025517151530854786\n", - "Bias^2: 0.024968890209256463\n", - "Var: 0.0005482613215983259\n", - "0.025517151530854786 >= 0.024968890209256463 + 0.0005482613215983259 = 0.02551715153085479\n", - "Polynomial degree: 6\n", - "Error: 0.01994607606842793\n", - "Bias^2: 0.019502076889868637\n", - "Var: 0.00044399917855929527\n", - "0.01994607606842793 >= 0.019502076889868637 + 0.00044399917855929527 = 0.019946076068427934\n", - "Polynomial degree: 7\n", - "Error: 0.018695928655417676\n", - "Bias^2: 0.01797984009000237\n", - "Var: 0.0007160885654153078\n", - "0.018695928655417676 >= 0.01797984009000237 + 0.0007160885654153078 = 0.01869592865541768\n", - "Polynomial degree: 8\n", - "Error: 0.010736105188369479\n", - "Bias^2: 0.010376602508045063\n", - "Var: 0.00035950268032441344\n", - "0.010736105188369479 >= 0.010376602508045063 + 0.00035950268032441344 = 0.010736105188369477\n", - "Polynomial degree: 9\n", - "Error: 0.01101329065273084\n", - "Bias^2: 0.010539027867197629\n", - "Var: 0.0004742627855332104\n", - "0.01101329065273084 >= 0.010539027867197629 + 0.0004742627855332104 = 0.01101329065273084\n", - "Polynomial degree: 10\n", - "Error: 0.010972468815261078\n", - "Bias^2: 0.010593565969983903\n", - "Var: 0.00037890284527716995\n", - "0.010972468815261078 >= 0.010593565969983903 + 0.00037890284527716995 = 0.010972468815261073\n", - "Polynomial degree: 11\n", - "Error: 0.01084055593776807\n", - "Bias^2: 0.010348475861989281\n", - "Var: 0.0004920800757787882\n", - "0.01084055593776807 >= 0.010348475861989281 + 0.0004920800757787882 = 0.01084055593776807\n", - "Polynomial degree: 12\n", - "Error: 0.010192472149429362\n", - "Bias^2: 0.009610568640072627\n", - "Var: 0.0005819035093567355\n", - "0.010192472149429362 >= 0.009610568640072627 + 0.0005819035093567355 = 0.010192472149429362\n", - "Polynomial degree: 13\n", - "Error: 0.010312285920590011\n", - "Bias^2: 0.009802534263801815\n", - "Var: 0.0005097516567881938\n", - "0.010312285920590011 >= 0.009802534263801815 + 0.0005097516567881938 = 0.01031228592059001\n", - "Polynomial degree: 14\n", - "Error: 0.010722455299595876\n", - "Bias^2: 0.01008891676024437\n", - "Var: 0.0006335385393515036\n", - "0.010722455299595876 >= 0.01008891676024437 + 0.0006335385393515036 = 0.010722455299595875\n", - "Polynomial degree: 15\n", - "Error: 0.011155437503231998\n", - "Bias^2: 0.010311761228670724\n", - "Var: 0.0008436762745612778\n", - "0.011155437503231998 >= 0.010311761228670724 + 0.0008436762745612778 = 0.011155437503232002\n", - "Polynomial degree: 16\n", - "Error: 0.011028026782676708\n", - "Bias^2: 0.010223572382311492\n", - "Var: 0.0008044544003652116\n", - "0.011028026782676708 >= 0.010223572382311492 + 0.0008044544003652116 = 0.011028026782676703\n", - "Polynomial degree: 17\n", - "Error: 0.011628743129658555\n", - "Bias^2: 0.010533948734129592\n", - "Var: 0.001094794395528961\n", - "0.011628743129658555 >= 0.010533948734129592 + 0.001094794395528961 = 0.011628743129658553\n", - "Polynomial degree: 18\n", - "Error: 0.014371682171531027\n", - "Bias^2: 0.010922362242870073\n", - "Var: 0.0034493199286609573\n", - "0.014371682171531027 >= 0.010922362242870073 + 0.0034493199286609573 = 0.01437168217153103\n", - "Polynomial degree: 19\n", - "Error: 0.026986306199342624\n", - "Bias^2: 0.01214176442858653\n", - "Var: 0.014844541770756087\n", - "0.026986306199342624 >= 0.01214176442858653 + 0.014844541770756087 = 0.026986306199342617\n", - "Polynomial degree: 20\n", - "Error: 0.012249244024160728\n", - "Bias^2: 0.01006785246285396\n", - "Var: 0.002181391561306766\n", - "0.012249244024160728 >= 0.01006785246285396 + 0.002181391561306766 = 0.012249244024160727\n", - "Polynomial degree: 21\n", - "Error: 0.014973172820830053\n", - "Bias^2: 0.010154371176360328\n", - "Var: 0.00481880164446972\n", - "0.014973172820830053 >= 0.010154371176360328 + 0.00481880164446972 = 0.014973172820830048\n", - "Polynomial degree: 22\n", - "Error: 0.014186606932681737\n", - "Bias^2: 0.009594131981212376\n", - "Var: 0.0045924749514693625\n", - "0.014186606932681737 >= 0.009594131981212376 + 0.0045924749514693625 = 0.014186606932681738\n", - "Polynomial degree: 23\n", - "Error: 0.025574552577788824\n", - "Bias^2: 0.009477519033249752\n", - "Var: 0.016097033544539077\n", - "0.025574552577788824 >= 0.009477519033249752 + 0.016097033544539077 = 0.02557455257778883\n", - "Polynomial degree: 24\n", - "Error: 0.03147298632679604\n", - "Bias^2: 0.009565267585507206\n", - "Var: 0.021907718741288846\n", - "0.03147298632679604 >= 0.009565267585507206 + 0.021907718741288846 = 0.03147298632679605\n", - "Polynomial degree: 25\n", - "Error: 0.03929027799369515\n", - "Bias^2: 0.009776269005896726\n", - "Var: 0.029514008987798424\n", - "0.03929027799369515 >= 0.009776269005896726 + 0.029514008987798424 = 0.03929027799369515\n", - "Polynomial degree: 26\n", - "Error: 0.15813256009613183\n", - "Bias^2: 0.013239726753028333\n", - "Var: 0.14489283334310352\n", - "0.15813256009613183 >= 0.013239726753028333 + 0.14489283334310352 = 0.15813256009613186\n", - "Polynomial degree: 27\n", - "Error: 0.1360840943498259\n", - "Bias^2: 0.01326608592145169\n", - "Var: 0.12281800842837416\n", - "0.1360840943498259 >= 0.01326608592145169 + 0.12281800842837416 = 0.13608409434982585\n", - "Polynomial degree: 28\n", - "Error: 0.7210723692205014\n", - "Bias^2: 0.04436186918146108\n", - "Var: 0.6767105000390408\n", - "0.7210723692205014 >= 0.04436186918146108 + 0.6767105000390408 = 0.7210723692205019\n", - "Polynomial degree: 29\n", - "Error: 0.48454430745837984\n", - "Bias^2: 0.011809368338879722\n", - "Var: 0.4727349391195001\n", - "0.48454430745837984 >= 0.011809368338879722 + 0.4727349391195001 = 0.48454430745837984\n" - ] - }, - { - "data": { - "image/png": "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AIAS53qekpmkJBFoJ0CgBQAAKHFJOyP505IItBMh0AIAAJQ4y07LMLOBlh7aoxFoAQAASlx2ZJcjiR3aiRBoAQAASlzCdsZ2aAm0RyPQAgAAlLjRGbQSLQcTIdACAACUOCvpyDBpOZgMgRYAAKDEje7QBnwBmT6OEXglAi0AAECJSySzPbTszk6MQAsAAFDiLNuRP+AoTP/shAi0AAAAJS4baDn2djIEWgAAgBI32nJQSaCdEIEWAACgxI3eFEbLwcQItAAAACXOSjryfNwUNhkCLQAAQIkbtlNyCbSTItACAACUuISTlMQpYZMh0AIAAJQwz/PGAi07tBMj0AIAAJQwO52R50tJItBOhkALAABQwqyRkV2SGNs1CQItAABACcuO7HIkibFdkyDQAgAAlLCEfXiHlpaDiRFoAQAASpiVdGT4aTk4FgItAABACbNsRzLT8smnCn+w2OWUJAItAABACcvu0DqqNCtlGEaxyylJeQXa7du3a+3atVq9erW2bt161PM/+9nP1NbWpiuuuEI33XSTUqnUtBcKAAAwFyVGdmi5IWxyOQNtZ2enNm/erG3btunee+/VXXfdpb179449b1mWbrvtNn3nO9/RT37yE9m2rR/+8IcFLRoAAGCusGxHvoBDoD2GnIF2165dWrFiherq6hQOh7VmzRrt2LFj7PlwOKwHH3xQ8+bNUyKRUE9Pj2pqagpaNAAAwFxhJR35TYcJB8eQM9B2dXUpGo2OPW5qalJnZ+e4awKBgH75y1/qL//yL9XX16fXvva1018pAADAHGTZjgwC7TGZuS5wXXdcA7LneRM2JL/uda/Tww8/rC996Uu69dZb9cUvfjHvIhobI3lfO52i0eqifC6OjXUpTaxL6WJtShPrUprKcV0c15PMtBqqa8qy/nydyHfLGWhjsZj27Nkz9jgej6upqWnscX9/v5588smxXdm2tjZt2rRpSkX09AzJdb0pveZERaPViscHZ/QzkRvrUppYl9LF2pQm1qU0leu69A8m5damZDhmWdafj1xr4/MZx9wAzdlysHLlSu3evVu9vb1KJBLauXOnVq1aNfa853n68Ic/rPb2dknSjh07dN55503lO8y4rj5LqXSm2GUAAADkZKVsyfBoOTiGnDu0zc3N2rRpk9avX690Oq1169Zp2bJl2rBhgzZu3KilS5fqk5/8pK6/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t90mdaYAOBwOnnnmGbZs2cKtt946Lb8zcyqhtSwLpVRmXGudMy7yY+3atTz55JOUlZVRXV3NfffdxxtvvJHvsESK1JvCNW/ePJ577jn8fj8ej4eHHnpI6k6eHDt2jEceeYQ///M/Z968eVJnCkh22SxcuFDqTIH44he/yK5du+ju7qajo2PKdWZOJbT19fX09/dnxvv7+zOH7kT+vP/+++zatSszrrXGbrfnMSKRTepN4Tpy5AivvPJKZlzqTn588MEH/P7v/z5/9md/xqc//WmpMwVkYtlIncm/48ePc+jQIQA8Hg+bN29m9+7dU64zcyqh3bBhA7t27WJoaIhwOMzOnTv55Cc/me+w5ryxsTGefPJJotEogUCAn/70p9x+++35DkukrF69mpMnT3Lq1CkSiQS/+MUvpN4UCK01TzzxBCMjI8TjcX784x9L3bnGuru7+eM//mOeeuoptmzZAkidKRSTlY3Umfw7e/YsX/va14jFYsRiMX71q1+xY8eOKdeZObVbUldXx2OPPcbDDz9MPB7nvvvuY9WqVfkOa87btGkT+/btY/v27ViWxQMPPMDatWvzHZZIcblcfOc73+ELX/gC0WiUjRs3cuedd+Y7LAFcd911fP7zn+f+++/HNE02b97M1q1b8x3WnPL973+faDTKd77zncy0HTt2SJ0pABcqG6kz+bVx40b279/P9u3bsdlsbN68mS1btlBdXT2lOqO01nqGYhZCCCGEEGLGzakuB0IIIYQQYvaRhFYIIYQQQhQ1SWiFEEIIIURRk4RWCCGEEEIUNUlohRBCCCFEUZOEVgghhBBCFDVJaIUQQgghRFGThFYIIYQQQhS1/w/t6SApUuQsvQAAAABJRU5ErkJggg==\n", - "text/plain": [ - "
                  " - ] - }, - "metadata": {}, - "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 = 400\n", - "n_boostraps = 100\n", - "maxdegree = 30\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": [ - "\n", - "## Summing up\n", - "\n", - "\n", - "\n", - "\n", - "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.\n", - "\n", - "## Another Example from Scikit-Learn's Repository" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": {}, - "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": "markdown", - "metadata": {}, - "source": [ - "## More examples on bootstrap and cross-validation and errors" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": {}, - "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=True).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": [ - "\n", - "## The same example but now with cross-validation" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": {}, - "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()\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": [ - "## Cross-validation with Ridge" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": {}, - "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", - "np.random.seed(3155)\n", - "# Generate the data.\n", - "n = 100\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", - "# Decide degree on polynomial to fit\n", - "poly = PolynomialFeatures(degree = 10)\n", - "\n", - "# Decide which values of lambda to use\n", - "nlambdas = 500\n", - "lambdas = np.logspace(-3, 5, nlambdas)\n", - "# Initialize a KFold instance\n", - "k = 5\n", - "kfold = KFold(n_splits = k)\n", - "estimated_mse_sklearn = np.zeros(nlambdas)\n", - "i = 0\n", - "for lmb in lambdas:\n", - " ridge = Ridge(alpha = lmb)\n", - " estimated_mse_folds = cross_val_score(ridge, x, y, scoring='neg_mean_squared_error', cv=kfold)\n", - " estimated_mse_sklearn[i] = np.mean(-estimated_mse_folds)\n", - " i += 1\n", - "plt.figure()\n", - "plt.plot(np.log10(lambdas), estimated_mse_sklearn, label = 'cross_val_score')\n", - "plt.xlabel('log10(lambda)')\n", - "plt.ylabel('MSE')\n", - "plt.legend()\n", - "plt.show()" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## 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{_auto2} \\tag{2}\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": {}, - "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", - "## Reformulating the problem to suit regression\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{_auto3} \\tag{3}\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{_auto4} \\tag{4}\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{_auto5} \\tag{5}\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": {}, - "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": [ - "## Linear regression\n", - "\n", - "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{_auto6} \\tag{6}\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": {}, - "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": "code", - "execution_count": null, - "metadata": {}, - "outputs": [], - "source": [ - "def ols_inv(x: np.ndarray, y: np.ndarray) -> np.ndarray:\n", - " return scl.inv(x.T @ x) @ (x.T @ y)\n", - "beta = ols_inv(X_train_own, y_train)" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "## Singular Value decomposition\n", - "\n", - "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{_auto7} \\tag{7}\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": {}, - "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": {}, - "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": {}, - "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": {}, - "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", - "## The one-dimensional Ising model\n", - "\n", - "Let us bring back the Ising model again, but now with an additional\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{_auto8} \\tag{8}\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": {}, - "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{_auto9} \\tag{9}\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{_auto10} \\tag{10}\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{_auto11} \\tag{11}\n", - "\\end{equation}\n", - "$$" - ] - }, - { - "cell_type": "markdown", - "metadata": {}, - "source": [ - "We organize the data as we did above" - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": {}, - "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": {}, - "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": {}, - "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": {}, - "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 perfectly with our previous discussion where we used our own code.\n", - "\n", - "## Ridge regression\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": [ - "1\n", - "3\n", - "6\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": {}, - "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": [ - "## LASSO regression\n", - "\n", - "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{_auto13} \\tag{13}\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": {}, - "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", - "## Performance as function of the regularization parameter\n", - "\n", - "We see how the different models perform for a different set of values for $\\lambda$." - ] - }, - { - "cell_type": "code", - "execution_count": null, - "metadata": {}, - "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", - "## Finding the optimal value of $\\lambda$\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": {}, - "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$." - ] - } - ], - "metadata": { - "kernelspec": { - "display_name": "Python 3", - "language": "python", - "name": "python3" - }, - "language_info": { - "codemirror_mode": { - "name": "ipython", - "version": 3 - }, - "file_extension": ".py", - "mimetype": "text/x-python", - "name": "python", - "nbconvert_exporter": "python", - "pygments_lexer": "ipython3", - "version": "3.6.8" - } - }, - "nbformat": 4, - "nbformat_minor": 2 -} diff --git a/doc/src/Statistics/make.sh b/doc/src/Statistics/make.sh index edfed7c87..d908b90b9 100755 --- a/doc/src/Statistics/make.sh +++ b/doc/src/Statistics/make.sh @@ -49,29 +49,6 @@ system doconce split_html $html.html --method=split --pagination --nav_button=bo # IPython notebook system doconce format ipynb $name $opt -# LaTeX Beamer slides -beamertheme=red_plain -system doconce format pdflatex $name --latex_title_layout=beamer --latex_table_format=footnotesize $opt -system doconce ptex2tex $name envir=minted -# Add special packages -doconce subst "% Add user's preamble" "\g<1>\n\\usepackage{simplewick}" $name.tex -system doconce slides_beamer $name --beamer_slide_theme=$beamertheme -system pdflatex -shell-escape ${name} -system pdflatex -shell-escape ${name} -cp $name.pdf ${name}-beamer.pdf -cp $name.tex ${name}-beamer.tex - -# Handouts -system doconce format pdflatex $name --latex_title_layout=beamer --latex_table_format=footnotesize $opt -system doconce ptex2tex $name envir=minted -# Add special packages -doconce subst "% Add user's preamble" "\g<1>\n\\usepackage{simplewick}" $name.tex -system doconce slides_beamer $name --beamer_slide_theme=red_shadow --handout -system pdflatex -shell-escape $name -pdflatex -shell-escape $name -pdflatex -shell-escape $name -pdfnup --nup 2x3 --frame true --delta "1cm 1cm" --scale 0.9 --outfile ${name}-beamer-handouts2x3.pdf ${name}.pdf -rm -f ${name}.pdf # Ordinary plain LaTeX document rm -f *.aux # important after beamer