From 6eb5acf151bbe81a1192f1628275de78230e28f0 Mon Sep 17 00:00:00 2001 From: mhjensen Date: Sat, 27 Jan 2018 10:10:34 -0500 Subject: [PATCH] Building the textbook --- .../.ipynb_checkpoints/book-checkpoint.ipynb | 7919 +++++++++++++++++ doc/LectureNotes/book.do.txt | 4662 ++++++++++ doc/LectureNotes/book.ipynb | 7919 +++++++++++++++++ doc/LectureNotes/fig/Hudson_Bay_data.pdf | Bin 0 -> 15045 bytes doc/LectureNotes/fig/Hudson_Bay_data.png | Bin 0 -> 53586 bytes doc/LectureNotes/fig/Hudson_Bay_sim.pdf | Bin 0 -> 18298 bytes doc/LectureNotes/fig/Hudson_Bay_sim.png | Bin 0 -> 65901 bytes doc/LectureNotes/gaussian.pdf | Bin 0 -> 229831 bytes doc/LectureNotes/ipynb-book-src.tar.gz | Bin 0 -> 113364 bytes doc/LectureNotes/src/Hudson_Bay.csv | 22 + doc/LectureNotes/src/Hudson_Bay.py | 43 + doc/LectureNotes/src/Hudson_Bay_sim.pdf | Bin 0 -> 17919 bytes doc/LectureNotes/src/Hudson_Bay_sim.png | Bin 0 -> 67454 bytes doc/LectureNotes/src/diffeq.py | 12 + doc/LectureNotes/src/ecoli.csv | 11 + doc/LectureNotes/src/ecoli.py | 27 + doc/LectureNotes/src/ecoli_inverse.py | 27 + doc/LectureNotes/src/plot_Hudson.py | 19 + 18 files changed, 20661 insertions(+) create mode 100644 doc/LectureNotes/.ipynb_checkpoints/book-checkpoint.ipynb create mode 100644 doc/LectureNotes/book.do.txt create mode 100644 doc/LectureNotes/book.ipynb create mode 100644 doc/LectureNotes/fig/Hudson_Bay_data.pdf create mode 100644 doc/LectureNotes/fig/Hudson_Bay_data.png create mode 100644 doc/LectureNotes/fig/Hudson_Bay_sim.pdf create mode 100644 doc/LectureNotes/fig/Hudson_Bay_sim.png create mode 100644 doc/LectureNotes/gaussian.pdf create mode 100644 doc/LectureNotes/ipynb-book-src.tar.gz create mode 100644 doc/LectureNotes/src/Hudson_Bay.csv create mode 100644 doc/LectureNotes/src/Hudson_Bay.py create mode 100644 doc/LectureNotes/src/Hudson_Bay_sim.pdf create mode 100644 doc/LectureNotes/src/Hudson_Bay_sim.png create mode 100644 doc/LectureNotes/src/diffeq.py create mode 100644 doc/LectureNotes/src/ecoli.csv create mode 100644 doc/LectureNotes/src/ecoli.py create mode 100644 doc/LectureNotes/src/ecoli_inverse.py create mode 100644 doc/LectureNotes/src/plot_Hudson.py diff --git a/doc/LectureNotes/.ipynb_checkpoints/book-checkpoint.ipynb b/doc/LectureNotes/.ipynb_checkpoints/book-checkpoint.ipynb new file mode 100644 index 000000000..f4c3ff2aa --- /dev/null +++ b/doc/LectureNotes/.ipynb_checkpoints/book-checkpoint.ipynb @@ -0,0 +1,7919 @@ +{ + "cells": [ + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "\n", + "# 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: **Jan 27, 2018**\n", + "\n", + "Copyright 1999-2018, Morten Hjorth-Jensen. Released under CC Attribution-NonCommercial 4.0 license\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "# What is Machine Learning?\n", + "\n", + "Machine learning is the science of giving computers the ability to\n", + "learn without being explicitly programmed. The idea is that there\n", + "exist generic algorithms which can be used to find patterns in a broad\n", + "class of data sets without having to write code specifically for each\n", + "problem. The algorithm will build its own logic based on the data.\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. It has also, especially in later\n", + "years, found applications in a wide variety of other areas, including\n", + "bioinformatics, economy, physics, finance and marketing.\n", + "\n", + "\n", + "## Types of Machine Learning\n", + "\n", + "\n", + "The approaches to machine learning are many, but are often split into two main categories. \n", + "In *supervised learning* we know the answer to a problem,\n", + "and let the computer deduce the logic behind it. On the other hand, *unsupervised learning*\n", + "is a method for finding patterns and relationship in data sets without any prior knowledge of the system.\n", + "Some authours also operate with a third category, namely *reinforcement learning*. This is a paradigm \n", + "of learning inspired by behavioural 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 desired output of a system.\n", + "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", + "## Different algorithms\n", + "In this course we will build our machine learning approach on a statistical foundation, with elements \n", + "from data analysis, stochastic processes etc before we proceed with the following machine learning algorithms\n", + "\n", + "1. Linear regression and its variants\n", + "\n", + "2. Decision tree algorithms, from simpler to more complex ones\n", + "\n", + "3. Nearest neighbors models\n", + "\n", + "4. Bayesian statistics \n", + "\n", + "5. Support vector machines and finally various variants of\n", + "\n", + "6. Artifical neural networks\n", + "\n", + "Before we proceed however, there are several practicalities with data analysis and software tools we would \n", + "like to present. These tools will help us in our understanding of various machine learning algorithms. \n", + "\n", + "Our emphasis here is on understanding the mathematical aspects of different algorithms, however, where possible \n", + "we will emphasize the importance of using available software. \n", + "\n", + "\n", + "\n", + "## Software and needed installations\n", + "We will make intensive use of python as programming language and the myriad of available libraries. \n", + "Furthermore, you will find IPython/Jupyter notebooks invaluable in your work. \n", + "You can run **R** codes in the Jupyter/IPython notebooks, with the immediate benefit of visualizing your data.\n", + "\n", + "\n", + "If you have Python installed (we recommend Python3) and you feel pretty familiar with installing different packages, \n", + "we recommend that you install the following Python packages via **pip** as\n", + "1. pip install numpy scipy matplotlib ipython scikit-learn mglearn sympy pandas pillow\n", + "\n", + "For Python3, replace **pip** with **pip3**.\n", + "\n", + "For OSX users we recommend also, after having installed Xcode, to install **brew**. Brew allows \n", + "for a seamless installation of additional software via for example\n", + "1. brew install python3\n", + "\n", + "For Linux users, with its variety of distributions like for example the widely popular Ubuntu distribution\n", + "you can use **pip** as well and simply install Python as \n", + "1. sudo apt-get install python3 (or python for pyhton2.7)\n", + "\n", + "etc etc. \n", + "\n", + "\n", + "## Python installers\n", + "If you don't want to perform these operations separately, we recommend two widely used distrubutions which set up \n", + "all relevant dependencies for Python, namely\n", + "1. [Anaconda](https://docs.anaconda.com/) Anaconda is an open source distribution of the Python and R programming languages for large-scale data processing, predictive analytics, and scientific computing, that aims to simplify package management and deployment. Package versions are managed by the package management system **conda**\n", + "\n", + "2. [Enthought canopy](https://www.enthought.com/product/canopy/) is a Python distribution for scientific and analytic computing distribution and analysis environment, available for free and under a commercial license.\n", + "\n", + "## Installing R, C++, cython or Julia\n", + "\n", + "You will also find it convenient to utilize R. \n", + "Jupyter/Ipython notebook allows you run **R** code interactively in your browser. The software library **R** is \n", + "tuned to statistically analysis and allows for an easy usage of the tools we will discuss in these texts.\n", + "\n", + "To install **R** with Jupyter notebook [following the link here](https://mpacer.org/maths/r-kernel-for-ipython-notebook)\n", + "\n", + "\n", + "\n", + "\n", + "## Installing R, C++, cython or Julia\n", + "\n", + "\n", + "For the C++ affecianodas, Jupyter/IPython notebook allows you also to install C++ and run codes written in this language \n", + "interactively in the browser. Since we will emphasize writing many of the algorithms yourself, you can thus opt for\n", + "either Python or C++ as programming languages. \n", + "\n", + "To add more entropy, **cython** can also be used when running your notebooks. It means that Python with the Jupyter/IPython notebook \n", + "setup allows you to integrate widely popular softwares and tools for scientific computing. With its versatility, \n", + "including symbolic operations, Python offers a unique computational environment. Your Jupyter/IPython notebook \n", + "can easily be converted into a nicely rendered **PDF** file or a Latex file for further processing. For example, convert to latex as" + ] + }, + { + "cell_type": "code", + "execution_count": 1, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "jupyter nbconvert filename.ipynb --to latex" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "If you use the light mark-up language **doconce** you can convert a standard ascii text file into various HTML \n", + "formats, ipython notebooks, latex files, pdf files etc. \n", + "\n", + "\n", + "\n", + "\n", + "## Introduction to Jupyter notebook and available tools" + ] + }, + { + "cell_type": "code", + "execution_count": 2, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "%matplotlib inline\n", + "\n", + "import numpy as np\n", + "import matplotlib.pyplot as plt\n", + "from scipy import sparse\n", + "import pandas as pd\n", + "from IPython.display import display\n", + "eye = np.eye(4)\n", + "print(eye)\n", + "sparse_mtx = sparse.csr_matrix(eye)\n", + "print(sparse_mtx)\n", + "x = np.linspace(-10,10,100)\n", + "y = np.sin(x)\n", + "plt.plot(x,y,marker='x')\n", + "plt.show()\n", + "data = {'Name': [\"John\", \"Anna\", \"Peter\", \"Linda\"], 'Location': [\"Nairobi\", \"Napoli\", \"London\", \"Buenos Aires\"], 'Age':[51, 21, 34, 45]}\n", + "data_pandas = pd.DataFrame(data)\n", + "display(data_pandas)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Representing data, more examples" + ] + }, + { + "cell_type": "code", + "execution_count": 3, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "import numpy as np\n", + "import matplotlib.pyplot as plt\n", + "from scipy import sparse\n", + "import pandas as pd\n", + "from IPython.display import display\n", + "import mglearn\n", + "import sklearn\n", + "from sklearn.linear_model import LinearRegression\n", + "from sklearn.tree import DecisionTreeRegressor\n", + "x, y = mglearn.datasets.make_wave(n_samples=100)\n", + "line = np.linspace(-3,3,1000,endpoint=False).reshape(-1,1)\n", + "reg = DecisionTreeRegressor(min_samples_split=3).fit(x,y)\n", + "plt.plot(line, reg.predict(line), label=\"decision tree\")\n", + "regline = LinearRegression().fit(x,y)\n", + "plt.plot(line, regline.predict(line), label= \"Linear Rgression\")\n", + "plt.show()" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Predator-Prey model from ecology\n", + "\n", + "\n", + "The population dynamics of a simple predator-prey system is a\n", + "classical example shown in many biology textbooks when ecological\n", + "systems are discussed. The system contains all elements of the\n", + "scientific method:\n", + "\n", + " * The set up of a specific hypothesis combined with\n", + "\n", + " * the experimental methods needed (one can study existing data or perform experiments)\n", + "\n", + " * analyzing and interpreting the data and performing further experiments if needed\n", + "\n", + " * trying to extract general behaviors and extract eventual laws or patterns\n", + "\n", + " * develop mathematical relations for the uncovered regularities/laws and test these by per forming new experiments\n", + "\n", + "## Case study from Hudson bay\n", + "\n", + "\n", + "Lots of data about populations of hares and lynx collected from furs in Hudson Bay, Canada, are available. It is known that the populations oscillate. Why?\n", + "Here we start by\n", + "\n", + "1. plotting the data\n", + "\n", + "2. derive a simple model for the population dynamics\n", + "\n", + "3. (fitting parameters in the model to the data)\n", + "\n", + "4. using the model predict the evolution other predator-pray systems\n", + "\n", + "## Hudson bay data\n", + "\n", + "\n", + "\n", + "\n", + "Most mammalian predators rely on a variety of prey, which complicates mathematical modeling; however, a few predators have become highly specialized and seek almost exclusively a single prey species. An example of this simplified predator-prey interaction is seen in Canadian northern forests, where the populations of the lynx and the snowshoe hare are intertwined in a life and death struggle.\n", + "\n", + "One reason that this particular system has been so extensively studied is that the Hudson Bay company kept careful records of all furs from the early 1800s into the 1900s. The records for the furs collected by the Hudson Bay company showed distinct oscillations (approximately 12 year periods), suggesting that these species caused almost periodic fluctuations of each other's populations. The table here shows data from 1900 to 1920.\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "
Year Hares (x1000) Lynx (x1000)
1900 30.0 4.0
1901 47.2 6.1
1902 70.2 9.8
1903 77.4 35.2
1904 36.3 59.4
1905 20.6 41.7
1906 18.1 19.0
1907 21.4 13.0
1908 22.0 8.3
1909 25.4 9.1
1910 27.1 7.4
1911 40.3 8.0
1912 57 12.3
1913 76.6 19.5
1914 52.3 45.7
1915 19.5 51.1
1916 11.2 29.7
1917 7.6 15.8
1918 14.6 9.7
1919 16.2 10.1
1920 24.7 8.6
\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "## Plotting the data" + ] + }, + { + "cell_type": "code", + "execution_count": 4, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "import numpy as np\n", + "from matplotlib import pyplot as plt\n", + "\n", + "# Load in data file\n", + "data = np.loadtxt('src/Hudson_Bay.csv', delimiter=',', skiprows=1)\n", + "# Make arrays containing x-axis and hares and lynx populations\n", + "year = data[:,0]\n", + "hares = data[:,1]\n", + "lynx = data[:,2]\n", + "\n", + "plt.plot(year, hares ,'b-+', year, lynx, 'r-o')\n", + "plt.axis([1900,1920,0, 100.0])\n", + "plt.xlabel(r'Year')\n", + "plt.ylabel(r'Numbers of hares and lynx ')\n", + "plt.legend(('Hares','Lynx'), loc='upper right')\n", + "plt.title(r'Population of hares and lynx from 1900-1920 (x1000)}')\n", + "plt.savefig('Hudson_Bay_data.pdf')\n", + "plt.savefig('Hudson_Bay_data.png')\n", + "plt.show()" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Hares and lynx in Hudson bay from 1900 to 1920\n", + "\n", + "\n", + "\n", + "\n", + "

\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "## Why now create a computer model for the hare and lynx populations?\n", + "\n", + "We see from the plot that there are indeed fluctuations.\n", + "We would like to create a mathematical model that explains these\n", + "population fluctuations. Ecologists have predicted that in a simple\n", + "predator-prey system that a rise in prey population is followed (with\n", + "a lag) by a rise in the predator population. When the predator\n", + "population is sufficiently high, then the prey population begins\n", + "dropping. After the prey population falls, then the predator\n", + "population falls, which allows the prey population to recover and\n", + "complete one cycle of this interaction. Thus, we see that\n", + "qualitatively oscillations occur. Can a mathematical model predict\n", + "this? What causes cycles to slow or speed up? What affects the\n", + "amplitude of the oscillation or do you expect to see the oscillations\n", + "damp to a stable equilibrium? The models tend to ignore factors like\n", + "climate and other complicating factors. How significant are these?\n", + "\n", + " * We see oscillations in the data\n", + "\n", + " * What causes cycles to slow or speed up?\n", + "\n", + " * What affects the amplitude of the oscillation or do you expect to see the oscillations damp to a stable equilibrium?\n", + "\n", + " * With a model we can better *understand the data*\n", + "\n", + " * More important: we can understand the ecology dynamics of\n", + " predator-pray populations\n", + "\n", + "## The traditional (top-down) approach\n", + "\n", + "\n", + "The classical way (in all books) is to present the Lotka-Volterra equations:" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\begin{align*}\n", + "\\frac{dH}{dt} &= H(a - b L)\\\\\n", + "\\frac{dL}{dt} &= - L(d - c H)\n", + "\\end{align*}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Here,\n", + "\n", + " * $H$ is the number of preys\n", + "\n", + " * $L$ the number of predators\n", + "\n", + " * $a$, $b$, $d$, $c$ are parameters\n", + "\n", + "Most books quickly establish the model and then use considerable space on\n", + "discussing the qualitative properties of this *nonlinear system of\n", + "ODEs* (which cannot be solved)\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "## Basic mathematics notation\n", + "\n", + " * Time points: $t_0,t_1,\\ldots,t_m$\n", + "\n", + " * Uniform distribution of time points: $t_n=n\\Delta t$\n", + "\n", + " * $H^n$: population of hares at time $t_n$\n", + "\n", + " * $L^n$: population of lynx at time $t_n$\n", + "\n", + " * We want to model the changes in populations, $\\Delta H=H^{n+1}-H^n$\n", + " and $\\Delta L=L^{n+1}-L^n$ during a general time interval $[t_{n+1},t_n]$\n", + " of length $\\Delta t=t_{n+1}-t_n$\n", + "\n", + "## Basic dynamics of the population of hares\n", + "\n", + "\n", + "The population of hares evolves due to births and deaths exactly as a bacteria population:" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\Delta H = a \\Delta t H^n\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "However, hares have an additional loss in the population because\n", + "they are eaten by lynx.\n", + "All the hares and lynx can form\n", + "$H\\cdot L$ pairs in total. When such pairs meet during a time\n", + "interval $\\Delta t$, there is some\n", + "small probablity that the lynx will eat the hare.\n", + "So in fraction $b\\Delta t HL$, the lynx eat hares. This\n", + "loss of hares must be accounted for. Subtracted in the equation for hares:" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\Delta H = a\\Delta t H^n - b \\Delta t H^nL^n\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Basic dynamics of the population of lynx\n", + "\n", + "\n", + "We assume that the primary growth for the lynx population depends on sufficient food for raising lynx kittens, which implies an adequate source of nutrients from predation on hares. Thus, the growth of the lynx population does not only depend of how many lynx there are, but on how many hares they can eat.\n", + "In a time interval $\\Delta t HL$ hares and lynx can meet, and in a\n", + "fraction $b\\Delta t HL$ the lynx eats the hare. All of this does not\n", + "contribute to the growth of lynx, again just a fraction of\n", + "$b\\Delta t HL$ that we write as\n", + "$d\\Delta t HL$. In addition, lynx die just as in the population\n", + "dynamics with one isolated animal population, leading to a loss\n", + "$-c\\Delta t L$.\n", + "\n", + "\n", + "\n", + "The accounting of lynx then looks like" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\Delta L = d\\Delta t H^nL^n - c\\Delta t L^n\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Evolution equations\n", + "\n", + "\n", + "By writing up the definition of $\\Delta H$ and $\\Delta L$, and putting\n", + "all assumed known terms $H^n$ and $L^n$ on the right-hand side, we have" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "H^{n+1} = H^n + a\\Delta t H^n - b\\Delta t H^n L^n\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "L^{n+1} = L^n + d\\Delta t H^nL^n - c\\Delta t L^n\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Note:\n", + "\n", + " * These equations are ready to be implemented!\n", + "\n", + " * But to start, we need $H^0$ and $L^0$ \n", + " (which we can get from the data)\n", + "\n", + " * We also need values for $a$, $b$, $d$, $c$\n", + "\n", + "## Adapt the model to the Hudson Bay case\n", + "\n", + "\n", + " * As always, models tend to be general - as here, applicable\n", + " to \"all\" predator-pray systems\n", + "\n", + " * The critical issue is whether the *interaction* between hares and lynx\n", + " is sufficiently well modeled by $\\hbox{const}HL$\n", + "\n", + " * The parameters $a$, $b$, $d$, and $c$ must be\n", + " estimated from data\n", + "\n", + " * Measure time in years\n", + "\n", + " * $t_0=1900$, $t_m=1920$\n", + "\n", + "## The program" + ] + }, + { + "cell_type": "code", + "execution_count": 5, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "import numpy as np\n", + "import matplotlib.pyplot as plt\n", + "\n", + "def solver(m, H0, L0, dt, a, b, c, d, t0):\n", + " \"\"\"Solve the difference equations for H and L over m years\n", + " with time step dt (measured in years.\"\"\"\n", + "\n", + " num_intervals = int(m/float(dt))\n", + " t = np.linspace(t0, t0 + m, num_intervals+1)\n", + " H = np.zeros(t.size)\n", + " L = np.zeros(t.size)\n", + "\n", + " print('Init:', H0, L0, dt)\n", + " H[0] = H0\n", + " L[0] = L0\n", + "\n", + " for n in range(0, len(t)-1):\n", + " H[n+1] = H[n] + a*dt*H[n] - b*dt*H[n]*L[n]\n", + " L[n+1] = L[n] + d*dt*H[n]*L[n] - c*dt*L[n]\n", + " return H, L, t\n", + "\n", + "# Load in data file\n", + "data = np.loadtxt('src/Hudson_Bay.csv', delimiter=',', skiprows=1)\n", + "# Make arrays containing x-axis and hares and lynx populations\n", + "t_e = data[:,0]\n", + "H_e = data[:,1]\n", + "L_e = data[:,2]\n", + "\n", + "# Simulate using the model\n", + "H, L, t = solver(m=20, H0=34.91, L0=3.857, dt=0.1,\n", + " a=0.4807, b=0.02482, c=0.9272, d=0.02756,\n", + " t0=1900)\n", + "\n", + "# Visualize simulations and data\n", + "plt.plot(t_e, H_e, 'b-+', t_e, L_e, 'r-o', t, H, 'm--', t, L, 'k--')\n", + "plt.xlabel('Year')\n", + "plt.ylabel('Numbers of hares and lynx')\n", + "plt.axis([1900, 1920, 0, 140])\n", + "plt.title(r'Population of hares and lynx 1900-1920 (x1000)')\n", + "plt.legend(('H_e', 'L_e', 'H', 'L'), loc='upper left')\n", + "plt.savefig('Hudson_Bay_sim.pdf')\n", + "plt.savefig('Hudson_Bay_sim.png')\n", + "plt.show()" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## The plot\n", + "\n", + "\n", + "\n", + "\n", + "

\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "If we perform a least-square fitting, we can find optimal values for the parameters $a$, $b$, $d$, $c$. The optimal parameters are $a=0.4807$, $b=0.02482$, $d=0.9272$ and $c=0.02756$. These parameters result in a slightly modified initial conditions, namely $H(0) = 34.91$ and $L(0)=3.857$. With these parameters we are now ready to solve the equations and plot these data together with the experimental values.\n", + "\n", + "\n", + "\n", + "## Linear regression in Python" + ] + }, + { + "cell_type": "code", + "execution_count": 6, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "import numpy as np\n", + "import matplotlib.pyplot as plt\n", + "from IPython.display import display\n", + "import sklearn\n", + "from sklearn.linear_model import LinearRegression\n", + "from sklearn.tree import DecisionTreeRegressor\n", + "\n", + "\n", + "data = np.loadtxt('src/Hudson_Bay.csv', delimiter=',', skiprows=1)\n", + "x = data[:,0]\n", + "y = data[:,1]\n", + "line = np.linspace(1900,1920,1000,endpoint=False).reshape(-1,1)\n", + "reg = DecisionTreeRegressor(min_samples_split=3).fit(x.reshape(-1,1),y.reshape(-1,1))\n", + "plt.plot(line, reg.predict(line), label=\"decision tree\")\n", + "regline = LinearRegression().fit(x.reshape(-1,1),y.reshape(-1,1))\n", + "plt.plot(line, regline.predict(line), label= \"Linear Regression\")\n", + "plt.plot(x, y, label= \"Linear Regression\")\n", + "plt.show()" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Linear Least squares in R" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + " HudsonBay = read.csv(\"src/Hudson_Bay.csv\",header=T)\n", + " fix(HudsonBay)\n", + " dim(HudsonBay)\n", + " names(HudsonBay)\n", + " plot(HudsonBay$Year, HudsonBay$Hares..x1000.)\n", + " attach(HudsonBay)\n", + " plot(Year, Hares..x1000.)\n", + " plot(Year, Hares..x1000., col=\"red\", varwidth=T, xlab=\"Years\", ylab=\"Haresx 1000\")\n", + " summary(HudsonBay)\n", + " summary(Hares..x1000.)\n", + " library(MASS)\n", + " library(ISLR)\n", + " scatter.smooth(x=Year, y = Hares..x1000.)\n", + " linearMod = lm(Hares..x1000. ~ Year)\n", + " print(linearMod)\n", + " summary(linearMod)\n", + " plot(linearMod)\n", + " confint(linearMod)\n", + " predict(linearMod,data.frame(Year=c(1910,1914,1920)),interval=\"confidence\")\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Non-Linear Least squares in R" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + " set.seed(1485)\n", + " len = 24\n", + " x = runif(len)\n", + " y = x^3+rnorm(len, 0,0.06)\n", + " ds = data.frame(x = x, y = y)\n", + " str(ds)\n", + " plot( y ~ x, main =\"Known cubic with noise\")\n", + " s = seq(0,1,length =100)\n", + " lines(s, s^3, lty =2, col =\"green\")\n", + " m = nls(y ~ I(x^power), data = ds, start = list(power=1), trace = T)\n", + " class(m)\n", + " summary(m)\n", + " power = round(summary(m)$coefficients[1], 3)\n", + " power.se = round(summary(m)$coefficients[2], 3)\n", + " plot(y ~ x, main = \"Fitted power model\", sub = \"Blue: fit; green: known\")\n", + " s = seq(0, 1, length = 100)\n", + " lines(s, s^3, lty = 2, col = \"green\")\n", + " lines(s, predict(m, list(x = s)), lty = 1, col = \"blue\")\n", + " text(0, 0.5, paste(\"y =x^ (\", power, \" +/- \", power.se, \")\", sep = \"\"), pos = 4)\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# Important Matrix and vector handling packages\n", + "\n", + "The Numerical Recipes codes have been rewritten in Fortran 90/95 and\n", + "C/C++ by us. The original source codes are taken from the widely used\n", + "software package LAPACK, which follows two other popular packages\n", + "developed in the 1970s, namely EISPACK and LINPACK.\n", + "\n", + " * LINPACK: package for linear equations and least square problems.\n", + "\n", + " * LAPACK:package for solving symmetric, unsymmetric and generalized eigenvalue problems. From LAPACK's website it is possible to download for free all source codes from this library. Both C/C++ and Fortran versions are available.\n", + "\n", + " * BLAS (I, II and III): (Basic Linear Algebra Subprograms) are routines that provide standard building blocks for performing basic vector and matrix operations. Blas I is vector operations, II vector-matrix operations and III matrix-matrix operations. Highly parallelized and efficient codes, all available for download from .\n", + "\n", + "**Add python material on linear algebra and array handling, text on numpy etc**\n", + "\n", + "\n", + "## Basic Matrix Features\n", + "\n", + " Matrix properties reminder" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathbf{A} =\n", + " \\begin{bmatrix} a_{11} & a_{12} & a_{13} & a_{14} \\\\\n", + " a_{21} & a_{22} & a_{23} & a_{24} \\\\\n", + " a_{31} & a_{32} & a_{33} & a_{34} \\\\\n", + " a_{41} & a_{42} & a_{43} & a_{44}\n", + " \\end{bmatrix}\\qquad\n", + "\\mathbf{I} =\n", + " \\begin{bmatrix} 1 & 0 & 0 & 0 \\\\\n", + " 0 & 1 & 0 & 0 \\\\\n", + " 0 & 0 & 1 & 0 \\\\\n", + " 0 & 0 & 0 & 1\n", + " \\end{bmatrix}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Basic Matrix Features\n", + "\n", + "The inverse of a matrix is defined by" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathbf{A}^{-1} \\cdot \\mathbf{A} = I\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Basic Matrix Features\n", + "\n", + " Matrix Properties Reminder\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "
Relations Name matrix elements
$A = A^{T}$ symmetric $a_{ij} = a_{ji}$
$A = \\left (A^{T} \\right )^{-1}$ real orthogonal $\\sum_k a_{ik} a_{jk} = \\sum_k a_{ki} a_{kj} = \\delta_{ij}$
$A = A^{ * }$ real matrix $a_{ij} = a_{ij}^{ * }$
$A = A^{\\dagger}$ hermitian $a_{ij} = a_{ji}^{ * }$
$A = \\left (A^{\\dagger} \\right )^{-1}$ unitary $\\sum_k a_{ik} a_{jk}^{ * } = \\sum_k a_{ki}^{ * } a_{kj} = \\delta_{ij}$
\n", + "\n", + "\n", + "\n", + "## Some famous Matrices\n", + "\n", + " * Diagonal if $a_{ij}=0$ for $i\\ne j$\n", + "\n", + " * Upper triangular if $a_{ij}=0$ for $i > j$\n", + "\n", + " * Lower triangular if $a_{ij}=0$ for $i < j$\n", + "\n", + " * Upper Hessenberg if $a_{ij}=0$ for $i > j+1$\n", + "\n", + " * Lower Hessenberg if $a_{ij}=0$ for $i < j+1$\n", + "\n", + " * Tridiagonal if $a_{ij}=0$ for $|i -j| > 1$\n", + "\n", + " * Lower banded with bandwidth $p$: $a_{ij}=0$ for $i > j+p$\n", + "\n", + " * Upper banded with bandwidth $p$: $a_{ij}=0$ for $i < j+p$\n", + "\n", + " * Banded, block upper triangular, block lower triangular....\n", + "\n", + "## Basic Matrix Features\n", + "\n", + " Some Equivalent Statements\n", + "For an $N\\times N$ matrix $\\mathbf{A}$ the following properties are all equivalent\n", + "\n", + " * If the inverse of $\\mathbf{A}$ exists, $\\mathbf{A}$ is nonsingular.\n", + "\n", + " * The equation $\\mathbf{Ax}=0$ implies $\\mathbf{x}=0$.\n", + "\n", + " * The rows of $\\mathbf{A}$ form a basis of $R^N$.\n", + "\n", + " * The columns of $\\mathbf{A}$ form a basis of $R^N$.\n", + "\n", + " * $\\mathbf{A}$ is a product of elementary matrices.\n", + "\n", + " * $0$ is not eigenvalue of $\\mathbf{A}$.\n", + "\n", + "## Matrix Handling in C/C++, Static and Dynamical allocation\n", + "\n", + " Static\n", + "We have an $N\\times N$ matrix A with $N=100$\n", + "In C/C++ this would be defined as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + " int N = 100;\n", + " double A[100][100];\n", + " // initialize all elements to zero\n", + " for(i=0 ; i < N ; i++) {\n", + " for(j=0 ; j < N ; j++) {\n", + " A[i][j] = 0.0;\n", + " \n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Note the way the matrix is organized, row-major order.\n", + "\n", + "\n", + "\n", + "## Matrix Handling in C/C++\n", + "\n", + " Row Major Order, Addition\n", + "We have $N\\times N$ matrices A, B and C and we wish to\n", + "evaluate $A=B+C$." + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathbf{A}= \\mathbf{B}\\pm\\mathbf{C} \\Longrightarrow a_{ij} = b_{ij}\\pm c_{ij},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "In C/C++ this would be coded like" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + " for(i=0 ; i < N ; i++) {\n", + " for(j=0 ; j < N ; j++) {\n", + " a[i][j] = b[i][j]+c[i][j]\n", + " \n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Matrix Handling in C/C++\n", + "\n", + " Row Major Order, Multiplication\n", + "We have $N\\times N$ matrices A, B and C and we wish to\n", + "evaluate $A=BC$." + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathbf{A}=\\mathbf{BC} \\Longrightarrow a_{ij} = \\sum_{k=1}^{n} b_{ik}c_{kj},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "In C/C++ this would be coded like" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + " for(i=0 ; i < N ; i++) {\n", + " for(j=0 ; j < N ; j++) {\n", + " for(k=0 ; k < N ; k++) {\n", + " a[i][j]+=b[i][k]*c[k][j];\n", + " \n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Dynamic memory allocation in C/C++\n", + "\n", + "At least three possibilities in this course\n", + "\n", + " * Do it yourself\n", + "\n", + " * Use the functions provided in the library package lib.cpp\n", + "\n", + " * Use Armadillo (a C++ linear algebra library, discussion both here and at lab). \n", + "\n", + "## Matrix Handling in C/C++, Dynamic Allocation\n", + "\n", + " Do it yourself" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + " int N;\n", + " double ** A;\n", + " A = new double*[N]\n", + " for ( i = 0; i < N; i++)\n", + " A[i] = new double[N];\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Always free space when you don't need an array anymore." + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + " for ( i = 0; i < N; i++)\n", + " delete[] A[i];\n", + " delete[] A;\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Armadillo, recommended!!\n", + "\n", + " * Armadillo is a C++ linear algebra library (matrix maths) aiming towards a good balance between speed and ease of use. The syntax is deliberately similar to Matlab.\n", + "\n", + " * Integer, floating point and complex numbers are supported, as well as a subset of trigonometric and statistics functions. Various matrix decompositions are provided through optional integration with LAPACK, or one of its high performance drop-in replacements (such as the multi-threaded MKL or ACML libraries).\n", + "\n", + " * A delayed evaluation approach is employed (at compile-time) to combine several operations into one and reduce (or eliminate) the need for temporaries. This is accomplished through recursive templates and template meta-programming.\n", + "\n", + " * Useful for conversion of research code into production environments, or if C++ has been decided as the language of choice, due to speed and/or integration capabilities.\n", + "\n", + " * The library is open-source software, and is distributed under a license that is useful in both open-source and commercial/proprietary contexts.\n", + "\n", + "## Armadillo, simple examples" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + " #include \n", + " #include \n", + " \n", + " using namespace std;\n", + " using namespace arma;\n", + " \n", + " int main(int argc, char** argv)\n", + " {\n", + " mat A = randu(5,5);\n", + " mat B = randu(5,5);\n", + " \n", + " cout << A*B << endl;\n", + " \n", + " return 0;\n", + " \n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Armadillo, how to compile and install\n", + "\n", + "For people using Ubuntu, Debian, Linux Mint, simply go to the synaptic package manager and install\n", + "armadillo from there.\n", + "You may have to install Lapack as well.\n", + "For Mac and Windows users, follow the instructions from the webpage\n", + ".\n", + "To compile, use for example (linux/ubuntu)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + " c++ -O2 -o program.x program.cpp -larmadillo -llapack -lblas\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "where the `-l` option indicates the library you wish to link to.\n", + "\n", + "For OS X users you may have to declare the paths to the include files and the libraries as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + " c++ -O2 -o program.x program.cpp -L/usr/local/lib -I/usr/local/include -larmadillo -llapack -lblas\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Armadillo, simple examples" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + " #include \n", + " #include \"armadillo\"\n", + " using namespace arma;\n", + " using namespace std;\n", + " \n", + " int main(int argc, char** argv)\n", + " {\n", + " // directly specify the matrix size (elements are uninitialised)\n", + " mat A(2,3);\n", + " // .n_rows = number of rows (read only)\n", + " // .n_cols = number of columns (read only)\n", + " cout << \"A.n_rows = \" << A.n_rows << endl;\n", + " cout << \"A.n_cols = \" << A.n_cols << endl;\n", + " // directly access an element (indexing starts at 0)\n", + " A(1,2) = 456.0;\n", + " A.print(\"A:\");\n", + " // scalars are treated as a 1x1 matrix,\n", + " // hence the code below will set A to have a size of 1x1\n", + " A = 5.0;\n", + " A.print(\"A:\");\n", + " // if you want a matrix with all elements set to a particular value\n", + " // the .fill() member function can be used\n", + " A.set_size(3,3);\n", + " A.fill(5.0); A.print(\"A:\");\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Armadillo, simple examples" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + " mat B;\n", + " \n", + " // endr indicates \"end of row\"\n", + " B << 0.555950 << 0.274690 << 0.540605 << 0.798938 << endr\n", + " << 0.108929 << 0.830123 << 0.891726 << 0.895283 << endr\n", + " << 0.948014 << 0.973234 << 0.216504 << 0.883152 << endr\n", + " << 0.023787 << 0.675382 << 0.231751 << 0.450332 << endr;\n", + " \n", + " // print to the cout stream\n", + " // with an optional string before the contents of the matrix\n", + " B.print(\"B:\");\n", + " \n", + " // the << operator can also be used to print the matrix\n", + " // to an arbitrary stream (cout in this case)\n", + " cout << \"B:\" << endl << B << endl;\n", + " // save to disk\n", + " B.save(\"B.txt\", raw_ascii);\n", + " // load from disk\n", + " mat C;\n", + " C.load(\"B.txt\");\n", + " C += 2.0 * B;\n", + " C.print(\"C:\");\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Armadillo, simple examples" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + " // submatrix types:\n", + " //\n", + " // .submat(first_row, first_column, last_row, last_column)\n", + " // .row(row_number)\n", + " // .col(column_number)\n", + " // .cols(first_column, last_column)\n", + " // .rows(first_row, last_row)\n", + " \n", + " cout << \"C.submat(0,0,3,1) =\" << endl;\n", + " cout << C.submat(0,0,3,1) << endl;\n", + " \n", + " // generate the identity matrix\n", + " mat D = eye(4,4);\n", + " \n", + " D.submat(0,0,3,1) = C.cols(1,2);\n", + " D.print(\"D:\");\n", + " \n", + " // transpose\n", + " cout << \"trans(B) =\" << endl;\n", + " cout << trans(B) << endl;\n", + " \n", + " // maximum from each column (traverse along rows)\n", + " cout << \"max(B) =\" << endl;\n", + " cout << max(B) << endl;\n", + " \n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Armadillo, simple examples" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + " // maximum from each row (traverse along columns)\n", + " cout << \"max(B,1) =\" << endl;\n", + " cout << max(B,1) << endl;\n", + " // maximum value in B\n", + " cout << \"max(max(B)) = \" << max(max(B)) << endl;\n", + " // sum of each column (traverse along rows)\n", + " cout << \"sum(B) =\" << endl;\n", + " cout << sum(B) << endl;\n", + " // sum of each row (traverse along columns)\n", + " cout << \"sum(B,1) =\" << endl;\n", + " cout << sum(B,1) << endl;\n", + " // sum of all elements\n", + " cout << \"sum(sum(B)) = \" << sum(sum(B)) << endl;\n", + " cout << \"accu(B) = \" << accu(B) << endl;\n", + " // trace = sum along diagonal\n", + " cout << \"trace(B) = \" << trace(B) << endl;\n", + " // random matrix -- values are uniformly distributed in the [0,1] interval\n", + " mat E = randu(4,4);\n", + " E.print(\"E:\");\n", + " \n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Armadillo, simple examples" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + " // row vectors are treated like a matrix with one row\n", + " rowvec r;\n", + " r << 0.59499 << 0.88807 << 0.88532 << 0.19968;\n", + " r.print(\"r:\");\n", + " \n", + " // column vectors are treated like a matrix with one column\n", + " colvec q;\n", + " q << 0.81114 << 0.06256 << 0.95989 << 0.73628;\n", + " q.print(\"q:\");\n", + " \n", + " // dot or inner product\n", + " cout << \"as_scalar(r*q) = \" << as_scalar(r*q) << endl;\n", + " \n", + " // outer product\n", + " cout << \"q*r =\" << endl;\n", + " cout << q*r << endl;\n", + " \n", + " \n", + " // sum of three matrices (no temporary matrices are created)\n", + " mat F = B + C + D;\n", + " F.print(\"F:\");\n", + " \n", + " return 0;\n", + " \n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Armadillo, simple examples" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + " #include \n", + " #include \"armadillo\"\n", + " using namespace arma;\n", + " using namespace std;\n", + " \n", + " int main(int argc, char** argv)\n", + " {\n", + " cout << \"Armadillo version: \" << arma_version::as_string() << endl;\n", + " \n", + " mat A;\n", + " \n", + " A << 0.165300 << 0.454037 << 0.995795 << 0.124098 << 0.047084 << endr\n", + " << 0.688782 << 0.036549 << 0.552848 << 0.937664 << 0.866401 << endr\n", + " << 0.348740 << 0.479388 << 0.506228 << 0.145673 << 0.491547 << endr\n", + " << 0.148678 << 0.682258 << 0.571154 << 0.874724 << 0.444632 << endr\n", + " << 0.245726 << 0.595218 << 0.409327 << 0.367827 << 0.385736 << endr;\n", + " \n", + " A.print(\"A =\");\n", + " \n", + " // determinant\n", + " cout << \"det(A) = \" << det(A) << endl;\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Armadillo, simple examples" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + " // inverse\n", + " cout << \"inv(A) = \" << endl << inv(A) << endl;\n", + " double k = 1.23;\n", + " \n", + " mat B = randu(5,5);\n", + " mat C = randu(5,5);\n", + " \n", + " rowvec r = randu(5);\n", + " colvec q = randu(5);\n", + " \n", + " \n", + " // examples of some expressions\n", + " // for which optimised implementations exist\n", + " // optimised implementation of a trinary expression\n", + " // that results in a scalar\n", + " cout << \"as_scalar( r*inv(diagmat(B))*q ) = \";\n", + " cout << as_scalar( r*inv(diagmat(B))*q ) << endl;\n", + " \n", + " // example of an expression which is optimised\n", + " // as a call to the dgemm() function in BLAS:\n", + " cout << \"k*trans(B)*C = \" << endl << k*trans(B)*C;\n", + " \n", + " return 0;\n", + " \n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Gaussian Elimination\n", + "\n", + "We start with the linear set of equations" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathbf{A}\\mathbf{x} = \\mathbf{w}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We assume also that the matrix $\\mathbf{A}$ is non-singular and that the\n", + "matrix elements along the diagonal satisfy $a_{ii} \\ne 0$. Simple $4\\times 4 $ example" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\begin{bmatrix}\n", + " a_{11}& a_{12} &a_{13}& a_{14}\\\\\n", + " a_{21}& a_{22} &a_{23}& a_{24}\\\\\n", + " a_{31}& a_{32} &a_{33}& a_{34}\\\\\n", + " a_{41}& a_{42} &a_{43}& a_{44}\\\\\n", + " \\end{bmatrix} \\begin{bmatrix}\n", + " x_1\\\\\n", + " x_2\\\\\n", + " x_3 \\\\\n", + " x_4 \\\\\n", + " \\end{bmatrix}\n", + " =\\begin{bmatrix}\n", + " w_1\\\\\n", + " w_2\\\\\n", + " w_3 \\\\\n", + " w_4\\\\\n", + " \\end{bmatrix}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Gaussian Elimination\n", + "or" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "a_{11}x_1 +a_{12}x_2 +a_{13}x_3 + a_{14}x_4=w_1 \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "a_{21}x_1 + a_{22}x_2 + a_{23}x_3 + a_{24}x_4=w_2 \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "a_{31}x_1 + a_{32}x_2 + a_{33}x_3 + a_{34}x_4=w_3 \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "a_{41}x_1 + a_{42}x_2 + a_{43}x_3 + a_{44}x_4=w_4. \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Gaussian Elimination\n", + "\n", + "The basic idea of Gaussian elimination is to use the first equation to eliminate the first unknown $x_1$\n", + "from the remaining $n-1$ equations. Then we use the new second equation to eliminate the second unknown\n", + "$x_2$ from the remaining $n-2$ equations. With $n-1$ such eliminations\n", + "we obtain a so-called upper triangular set of equations of the form" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "b_{11}x_1 +b_{12}x_2 +b_{13}x_3 + b_{14}x_4=y_1 \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "b_{22}x_2 + b_{23}x_3 + b_{24}x_4=y_2 \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "b_{33}x_3 + b_{34}x_4=y_3 \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "\n", + "
\n", + "\n", + "$$\n", + "b_{44}x_4=y_4. \\nonumber\n", + "\\label{eq:gaussbacksub} \\tag{1}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We can solve this system of equations recursively starting from $x_n$ (in our case $x_4$) and proceed with\n", + "what is called a backward substitution. \n", + "\n", + "\n", + "## Gaussian Elimination\n", + "This process can be expressed mathematically as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "\n", + "
\n", + "\n", + "$$\n", + "\\begin{equation}\n", + " x_m = \\frac{1}{b_{mm}}\\left(y_m-\\sum_{k=m+1}^nb_{mk}x_k\\right)\\quad m=n-1,n-2,\\dots,1.\n", + "\\label{_auto1} \\tag{2}\n", + "\\end{equation}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "To arrive at such an upper triangular system of equations, we start by eliminating\n", + "the unknown $x_1$ for $j=2,n$. We achieve this by multiplying the first equation by $a_{j1}/a_{11}$ and then subtract\n", + "the result from the $j$th equation. We assume obviously that $a_{11}\\ne 0$ and that\n", + "$\\mathbf{A}$ is not singular.\n", + "\n", + "\n", + "## Gaussian Elimination\n", + "\n", + "Our actual $4\\times 4$ example reads after the first operation" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\begin{bmatrix}\n", + " a_{11}& a_{12} &a_{13}& a_{14}\\\\\n", + " 0& (a_{22}-\\frac{a_{21}a_{12}}{a_{11}}) &(a_{23}-\\frac{a_{21}a_{13}}{a_{11}}) & (a_{24}-\\frac{a_{21}a_{14}}{a_{11}})\\\\\n", + "0& (a_{32}-\\frac{a_{31}a_{12}}{a_{11}})& (a_{33}-\\frac{a_{31}a_{13}}{a_{11}})& (a_{34}-\\frac{a_{31}a_{14}}{a_{11}})\\\\\n", + "0&(a_{42}-\\frac{a_{41}a_{12}}{a_{11}}) &(a_{43}-\\frac{a_{41}a_{13}}{a_{11}}) & (a_{44}-\\frac{a_{41}a_{14}}{a_{11}}) \\\\\n", + " \\end{bmatrix} \\begin{bmatrix}\n", + " x_1\\\\\n", + " x_2\\\\\n", + " x_3 \\\\\n", + " x_4 \\\\\n", + " \\end{bmatrix} \n", + " =\\begin{bmatrix}\n", + " y_1\\\\\n", + " w_2^{(2)}\\\\\n", + " w_3^{(2)} \\\\\n", + " w_4^{(2)}\\\\\n", + " \\end{bmatrix},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "or" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "b_{11}x_1 +b_{12}x_2 +b_{13}x_3 + b_{14}x_4=y_1 \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "a^{(2)}_{22}x_2 + a^{(2)}_{23}x_3 + a^{(2)}_{24}x_4=w^{(2)}_2 \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "a^{(2)}_{32}x_2 + a^{(2)}_{33}x_3 + a^{(2)}_{34}x_4=w^{(2)}_3 \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "a^{(2)}_{42}x_2 + a^{(2)}_{43}x_3 + a^{(2)}_{44}x_4=w^{(2)}_4, \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "\n", + "
\n", + "\n", + "$$\n", + "\\begin{equation} \n", + "\\label{_auto2} \\tag{3}\n", + "\\end{equation}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Gaussian Elimination\n", + "\n", + "The new coefficients are" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "\n", + "
\n", + "\n", + "$$\n", + "\\begin{equation}\n", + " b_{1k} = a_{1k}^{(1)} \\quad k=1,\\dots,n,\n", + "\\label{_auto3} \\tag{4}\n", + "\\end{equation}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "where each $a_{1k}^{(1)}$ is equal to the original $a_{1k}$ element. The other coefficients are" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "\n", + "
\n", + "\n", + "$$\n", + "\\begin{equation}\n", + "a_{jk}^{(2)} = a_{jk}^{(1)}-\\frac{a_{j1}^{(1)}a_{1k}^{(1)}}{a_{11}^{(1)}} \\quad j,k=2,\\dots,n,\n", + "\\label{_auto4} \\tag{5}\n", + "\\end{equation}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "with a new right-hand side given by" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "\n", + "
\n", + "\n", + "$$\n", + "\\begin{equation}\n", + "y_{1}=w_1^{(1)}, \\quad w_j^{(2)} =w_j^{(1)}-\\frac{a_{j1}^{(1)}w_1^{(1)}}{a_{11}^{(1)}} \\quad j=2,\\dots,n.\n", + "\\label{_auto5} \\tag{6}\n", + "\\end{equation}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We have also set $w_1^{(1)}=w_1$, the original vector element.\n", + "We see that the system of unknowns $x_1,\\dots,x_n$ is transformed into an $(n-1)\\times (n-1)$ problem.\n", + "\n", + "\n", + "## Gaussian Elimination\n", + "\n", + "This step is called forward substitution.\n", + "Proceeding with these substitutions, we obtain the\n", + "general expressions for the new coefficients" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "\n", + "
\n", + "\n", + "$$\n", + "\\begin{equation}\n", + " a_{jk}^{(m+1)} = a_{jk}^{(m)}-\\frac{a_{jm}^{(m)}a_{mk}^{(m)}}{a_{mm}^{(m)}} \\quad j,k=m+1,\\dots,n,\n", + "\\label{_auto6} \\tag{7}\n", + "\\end{equation}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "with $m=1,\\dots,n-1$ and a\n", + "right-hand side given by" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "\n", + "
\n", + "\n", + "$$\n", + "\\begin{equation}\n", + " w_j^{(m+1)} =w_j^{(m)}-\\frac{a_{jm}^{(m)}w_m^{(m)}}{a_{mm}^{(m)}}\\quad j=m+1,\\dots,n.\n", + "\\label{_auto7} \\tag{8}\n", + "\\end{equation}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "This set of $n-1$ elimations leads us to an equations which is solved by back substitution.\n", + "If the arithmetics is exact and the matrix $\\mathbf{A}$ is not singular, then the computed answer will be exact.\n", + "\n", + "Even though the matrix elements along the diagonal are not zero,\n", + "numerically small numbers may appear and subsequent divisions may lead to large numbers, which, if added\n", + "to a small number may yield losses of precision. Suppose for example that our first division in $(a_{22}-a_{21}a_{12}/a_{11})$\n", + "results in $-10^{-7}$ and that $a_{22}$ is one.\n", + "one. We are then\n", + "adding $10^7+1$. With single precision this results in $10^7$.\n", + "\n", + "\n", + "\n", + "\n", + "## Linear Algebra Methods\n", + "\n", + " * Gaussian elimination, $O(2/3n^3)$ flops, general matrix\n", + "\n", + " * LU decomposition, upper triangular and lower tridiagonal matrices, $O(2/3n^3)$ flops, general matrix. Get easily the inverse, determinant and can solve linear equations with back-substitution only, $O(n^2)$ flops\n", + "\n", + " * Cholesky decomposition. Real symmetric or hermitian positive definite matrix, $O(1/3n^3)$ flops.\n", + "\n", + " * Tridiagonal linear systems, important for differential equations. Normally positive definite and non-singular. $O(8n)$ flops for symmetric. Special case of banded matrices.\n", + "\n", + " * Singular value decomposition\n", + "\n", + " * the QR method will be discussed in chapter 7 in connection with eigenvalue systems. $O(4/3n^3)$ flops.\n", + "\n", + "## LU Decomposition\n", + "\n", + "The LU decomposition method means that we can rewrite\n", + "this matrix as the product of two matrices $\\mathbf{L}$ and $\\mathbf{U}$\n", + "where" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\begin{bmatrix}\n", + " a_{11} & a_{12} & a_{13} & a_{14} \\\\\n", + " a_{21} & a_{22} & a_{23} & a_{24} \\\\\n", + " a_{31} & a_{32} & a_{33} & a_{34} \\\\\n", + " a_{41} & a_{42} & a_{43} & a_{44}\n", + " \\end{bmatrix}\n", + " = \\begin{bmatrix}\n", + " 1 & 0 & 0 & 0 \\\\\n", + " l_{21} & 1 & 0 & 0 \\\\\n", + " l_{31} & l_{32} & 1 & 0 \\\\\n", + " l_{41} & l_{42} & l_{43} & 1\n", + " \\end{bmatrix}\n", + " \\begin{bmatrix}\n", + " u_{11} & u_{12} & u_{13} & u_{14} \\\\\n", + " 0 & u_{22} & u_{23} & u_{24} \\\\\n", + " 0 & 0 & u_{33} & u_{34} \\\\\n", + " 0 & 0 & 0 & u_{44}\n", + " \\end{bmatrix}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## LU Decomposition\n", + "\n", + "LU decomposition forms the backbone of other algorithms in linear algebra, such as the\n", + "solution of linear equations given by" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "a_{11}x_1 +a_{12}x_2 +a_{13}x_3 + a_{14}x_4=w_1 \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "a_{21}x_1 + a_{22}x_2 + a_{23}x_3 + a_{24}x_4=w_2 \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "a_{31}x_1 + a_{32}x_2 + a_{33}x_3 + a_{34}x_4=w_3 \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "a_{41}x_1 + a_{42}x_2 + a_{43}x_3 + a_{44}x_4=w_4. \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "The above set of equations is conveniently solved by using LU decomposition as an intermediate step.\n", + "\n", + "The matrix $\\mathbf{A}\\in \\mathbb{R}^{n\\times n}$ has an LU factorization if the determinant\n", + "is different from zero. If the LU factorization exists and $\\mathbf{A}$ is non-singular, then the LU factorization\n", + "is unique and the determinant is given by" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "det\\{\\mathbf{A}\\}=det\\{\\mathbf{LU}\\}= det\\{\\mathbf{L}\\}det\\{\\mathbf{U}\\}=u_{11}u_{22}\\dots u_{nn}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## LU Decomposition, why?\n", + "\n", + "There are at least three main advantages with LU decomposition compared with standard Gaussian elimination:\n", + "\n", + " * It is straightforward to compute the determinant of a matrix\n", + "\n", + " * If we have to solve sets of linear equations with the same matrix but with different vectors $\\mathbf{y}$, the number of FLOPS is of the order $n^3$.\n", + "\n", + " * The inverse is such an operation \n", + "\n", + "## LU Decomposition, linear equations\n", + "\n", + "With the LU decomposition it is rather\n", + "simple to solve a system of linear equations" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "a_{11}x_1 +a_{12}x_2 +a_{13}x_3 + a_{14}x_4=w_1 \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "a_{21}x_1 + a_{22}x_2 + a_{23}x_3 + a_{24}x_4=w_2 \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "a_{31}x_1 + a_{32}x_2 + a_{33}x_3 + a_{34}x_4=w_3 \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "a_{41}x_1 + a_{42}x_2 + a_{43}x_3 + a_{44}x_4=w_4. \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "This can be written in matrix form as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathbf{Ax}=\\mathbf{w}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "where $\\mathbf{A}$ and $\\mathbf{w}$ are known and we have to solve for\n", + "$\\mathbf{x}$. Using the LU dcomposition we write" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathbf{A} \\mathbf{x} \\equiv \\mathbf{L} \\mathbf{U} \\mathbf{x} =\\mathbf{w}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## LU Decomposition, linear equations\n", + "\n", + "The previous equation can be calculated in two steps" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathbf{L} \\mathbf{y} = \\mathbf{w};\\qquad \\mathbf{Ux}=\\mathbf{y}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "To show that this is correct we use to the LU decomposition\n", + "to rewrite our system of linear equations as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathbf{LUx}=\\mathbf{w},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and since the determinat of $\\mathbf{L}$ is equal to 1 (by construction\n", + "since the diagonals of $\\mathbf{L}$ equal 1) we can use the inverse of\n", + "$\\mathbf{L}$ to obtain" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathbf{Ux}=\\mathbf{L^{-1}w}=\\mathbf{y},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "which yields the intermediate step" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathbf{L^{-1}w}=\\mathbf{y}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and as soon as we have $\\mathbf{y}$ we can obtain $\\mathbf{x}$\n", + "through $\\mathbf{Ux}=\\mathbf{y}$.\n", + "\n", + "\n", + "## LU Decomposition, why?\n", + "\n", + "For our four-dimentional example this takes the form" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "y_1=w_1 \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "l_{21}y_1 + y_2=w_2\\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "l_{31}y_1 + l_{32}y_2 + y_3 =w_3\\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "l_{41}y_1 + l_{42}y_2 + l_{43}y_3 + y_4=w_4. \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "u_{11}x_1 +u_{12}x_2 +u_{13}x_3 + u_{14}x_4=y_1 \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "u_{22}x_2 + u_{23}x_3 + u_{24}x_4=y_2\\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "u_{33}x_3 + u_{34}x_4=y_3\\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "u_{44}x_4=y_4 \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "This example shows the basis for the algorithm\n", + "needed to solve the set of $n$ linear equations.\n", + "\n", + "\n", + "## LU Decomposition, linear equations\n", + "\n", + "The algorithm goes as follows\n", + "\n", + " * Set up the matrix $\\bf A$ and the vector $\\bf w$ with their correct dimensions. This determines the dimensionality of the unknown vector $\\bf x$.\n", + "\n", + " * Then LU decompose the matrix $\\bf A$ through a call to the function `ludcmp(double a, int n, int indx, double &d)`. This functions returns the LU decomposed matrix $\\bf A$, its determinant and the vector indx which keeps track of the number of interchanges of rows. If the determinant is zero, the solution is malconditioned.\n", + "\n", + " * Thereafter you call the function `lubksb(double a, int n, int indx, double w)` which uses the LU decomposed matrix $\\bf A$ and the vector $\\bf w$ and returns $\\bf x$ in the same place as $\\bf w$. Upon exit the original content in $\\bf w$ is destroyed. If you wish to keep this information, you should make a backup of it in your calling function.\n", + "\n", + "## LU Decomposition, the inverse of a matrix\n", + "\n", + "If the inverse exists then" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathbf{A}^{-1}\\mathbf{A}=\\mathbf{I},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "the identity matrix. With an LU decomposed matrix we can rewrite the last equation as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathbf{LU}\\mathbf{A}^{-1}=\\mathbf{I}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## LU Decomposition, the inverse of a matrix\n", + "\n", + "If we assume that the first column (that is column 1) of the inverse matrix\n", + "can be written as a vector with unknown entries" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathbf{A}_1^{-1}= \\begin{bmatrix}\n", + " a_{11}^{-1} \\\\\n", + " a_{21}^{-1} \\\\\n", + " \\dots \\\\\n", + " a_{n1}^{-1} \\\\\n", + " \\end{bmatrix},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "then we have a linear set of equations" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathbf{LU}\\begin{bmatrix}\n", + " a_{11}^{-1} \\\\\n", + " a_{21}^{-1} \\\\\n", + " \\dots \\\\\n", + " a_{n1}^{-1} \\\\\n", + " \\end{bmatrix} =\\begin{bmatrix}\n", + " 1 \\\\\n", + " 0 \\\\\n", + " \\dots \\\\\n", + " 0 \\\\\n", + " \\end{bmatrix}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## LU Decomposition, the inverse\n", + "\n", + "In a similar way we can compute the unknow entries of the second column," + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathbf{LU}\\begin{bmatrix}\n", + " a_{12}^{-1} \\\\\n", + " a_{22}^{-1} \\\\\n", + " \\dots \\\\\n", + " a_{n2}^{-1} \\\\\n", + " \\end{bmatrix}=\\begin{bmatrix}\n", + " 0 \\\\\n", + " 1 \\\\\n", + " \\dots \\\\\n", + " 0 \\\\\n", + " \\end{bmatrix},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and continue till we have solved all $n$ sets of linear equations.\n", + "\n", + "\n", + "\n", + "## [Using Armadillo to perform an LU decomposition](https://github.com/CompPhysics/ComputationalPhysicsMSU/blob/master/doc/Programs/CppQtCodesLectures/MatrixTest/main.cpp)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + " #include \n", + " #include \"armadillo\"\n", + " using namespace arma;\n", + " using namespace std;\n", + " \n", + " int main()\n", + " {\n", + " mat A = randu(5,5);\n", + " vec b = randu(5);\n", + " \n", + " A.print(\"A =\");\n", + " b.print(\"b=\");\n", + " // solve Ax = b\n", + " vec x = solve(A,b);\n", + " // print x\n", + " x.print(\"x=\");\n", + " // find LU decomp of A, if needed, P is the permutation matrix\n", + " mat L, U;\n", + " lu(L,U,A);\n", + " // print l\n", + " L.print(\" L= \");\n", + " // print U\n", + " U.print(\" U= \");\n", + " //Check that A = LU\n", + " (A-L*U).print(\"Test of LU decomposition\");\n", + " return 0;\n", + " }\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Iterative methods, Chapter 6\n", + "\n", + " * Direct solvers such as Gauss elimination and LU decomposition discussed in connection with project 1.\n", + "\n", + " * Iterative solvers such as Basic iterative solvers, Jacobi, Gauss-Seidel, Successive over-relaxation. These methods are easy to parallelize, as we will se later. Much used in solutions of partial differential equations.\n", + "\n", + " * Other iterative methods such as Krylov subspace methods with Generalized minimum residual (GMRES) and Conjugate gradient etc will not be discussed.\n", + "\n", + "## Iterative methods, Jacobi's method\n", + "\n", + "It is a simple method for solving" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathbf{A}\\mathbf{x}=\\mathbf{b},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "where $\\mathbf{A}$ is a matrix and $\\mathbf{x}$ and $\\mathbf{b}$ are vectors. The vector $\\mathbf{x}$ is \n", + "the unknown.\n", + "\n", + "It is an iterative scheme where we start with a guess for the unknown, and \n", + "after $k+1$ iterations we have" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathbf{x}^{(k+1)}= \\mathbf{D}^{-1}(\\mathbf{b}-(\\mathbf{L}+\\mathbf{U})\\mathbf{x}^{(k)}),\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "with $\\mathbf{A}=\\mathbf{D}+\\mathbf{U}+\\mathbf{L}$ and\n", + "$\\mathbf{D}$ being a diagonal matrix, $\\mathbf{U}$ an upper triangular matrix and $\\mathbf{L}$ a lower triangular\n", + "matrix.\n", + "\n", + "If the matrix $\\mathbf{A}$ is positive definite or diagonally dominant, one can show that this method will always converge to the exact solution. \n", + "\n", + "\n", + "\n", + "\n", + "## Iterative methods, Jacobi's method\n", + "\n", + "We can demonstrate Jacobi's method by this $4\\times 4$ matrix problem. We assume a guess\n", + "for the vector elements $x_i^{(0)}$, a guess which represents our first iteration. The new\n", + "values are obtained by substitution" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "x_1^{(1)} =(b_1-a_{12}x_2^{(0)} -a_{13}x_3^{(0)} - a_{14}x_4^{(0)})/a_{11} \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "x_2^{(1)} =(b_2-a_{21}x_1^{(0)} - a_{23}x_3^{(0)} - a_{24}x_4^{(0)})/a_{22} \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "x_3^{(1)} =(b_3- a_{31}x_1^{(0)} -a_{32}x_2^{(0)} -a_{34}x_4^{(0)})/a_{33} \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "x_4^{(1)}=(b_4-a_{41}x_1^{(0)} -a_{42}x_2^{(0)} - a_{43}x_3^{(0)})/a_{44}, \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "which after $k+1$ iterations reads" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "x_1^{(k+1)} =(b_1-a_{12}x_2^{(k)} -a_{13}x_3^{(k)} - a_{14}x_4^{(k)})/a_{11} \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "x_2^{(k+1)} =(b_2-a_{21}x_1^{(k)} - a_{23}x_3^{(k)} - a_{24}x_4^{(k)})/a_{22} \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "x_3^{(k+1)} =(b_3- a_{31}x_1^{(k)} -a_{32}x_2^{(k)} -a_{34}x_4^{(k)})/a_{33} \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "x_4^{(k+1)}=(b_4-a_{41}x_1^{(k)} -a_{42}x_2^{(k)} - a_{43}x_3^{(k)})/a_{44}, \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Iterative methods, Jacobi's method\n", + "\n", + "We can generalize the above equations to" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "x_i^{(k+1)}=(b_i-\\sum_{j=1, j\\ne i}^{n}a_{ij}x_j^{(k)})/a_{ii}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "or in an even more compact form as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathbf{x}^{(k+1)}= \\mathbf{D}^{-1}(\\mathbf{b}-(\\mathbf{L}+\\mathbf{U})\\mathbf{x}^{(k)}),\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "with $\\mathbf{A}=\\mathbf{D}+\\mathbf{U}+\\mathbf{L}$ and\n", + "$\\mathbf{D}$ being a diagonal matrix, $\\mathbf{U}$ an upper triangular matrix and $\\mathbf{L}$ a lower triangular\n", + "matrix.\n", + "\n", + "\n", + "\n", + "## Iterative methods, Gauss-Seidel's method\n", + "\n", + "Our $4\\times 4$ matrix problem" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "x_1^{(k+1)} =(b_1-a_{12}x_2^{(k)} -a_{13}x_3^{(k)} - a_{14}x_4^{(k)})/a_{11} \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "x_2^{(k+1)} =(b_2-a_{21}x_1^{(k)} - a_{23}x_3^{(k)} - a_{24}x_4^{(k)})/a_{22} \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "x_3^{(k+1)} =(b_3- a_{31}x_1^{(k)} -a_{32}x_2^{(k)} -a_{34}x_4^{(k)})/a_{33} \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "x_4^{(k+1)}=(b_4-a_{41}x_1^{(k)} -a_{42}x_2^{(k)} - a_{43}x_3^{(k)})/a_{44}, \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "can be rewritten as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "x_1^{(k+1)} =(b_1-a_{12}x_2^{(k)} -a_{13}x_3^{(k)} - a_{14}x_4^{(k)})/a_{11} \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "x_2^{(k+1)} =(b_2-a_{21}x_1^{(k+1)} - a_{23}x_3^{(k)} - a_{24}x_4^{(k)})/a_{22} \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "x_3^{(k+1)} =(b_3- a_{31}x_1^{(k+1)} -a_{32}x_2^{(k+1)} -a_{34}x_4^{(k)})/a_{33} \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "x_4^{(k+1)}=(b_4-a_{41}x_1^{(k+1)} -a_{42}x_2^{(k+1)} - a_{43}x_3^{(k+1)})/a_{44}, \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "which allows us to utilize the preceding solution (forward substitution). This improves normally the convergence\n", + "behavior and leads to the Gauss-Seidel method!\n", + "\n", + "\n", + "\n", + "## Iterative methods, Gauss-Seidel's method\n", + "\n", + "We can generalize" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "x_1^{(k+1)} =(b_1-a_{12}x_2^{(k)} -a_{13}x_3^{(k)} - a_{14}x_4^{(k)})/a_{11} \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "x_2^{(k+1)} =(b_2-a_{21}x_1^{(k+1)} - a_{23}x_3^{(k)} - a_{24}x_4^{(k)})/a_{22} \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "x_3^{(k+1)} =(b_3- a_{31}x_1^{(k+1)} -a_{32}x_2^{(k+1)} -a_{34}x_4^{(k)})/a_{33} \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "x_4^{(k+1)}=(b_4-a_{41}x_1^{(k+1)} -a_{42}x_2^{(k+1)} - a_{43}x_3^{(k+1)})/a_{44}, \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "to the following form" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "x^{(k+1)}_i = \\frac{1}{a_{ii}} \\left(b_i - \\sum_{j > i}a_{ij}x^{(k)}_j - \\sum_{j < i}a_{ij}x^{(k+1)}_j \\right),\\quad i=1,2,\\ldots,n.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "The procedure is generally continued until the changes made by an iteration are below some tolerance.\n", + "\n", + "The convergence properties of the Jacobi method and the \n", + "Gauss-Seidel method are dependent on the matrix $\\mathbf{A}$. These methods converge when\n", + "the matrix is symmetric positive-definite, or is strictly or irreducibly diagonally dominant.\n", + "Both methods sometimes converge even if these conditions are not satisfied.\n", + "\n", + "\n", + "\n", + "## Iterative methods, Successive over-relaxation\n", + "\n", + "Given a square system of n linear equations with unknown $\\mathbf x$:" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathbf{A}\\mathbf x = \\mathbf b\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "where" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathbf{A}=\\begin{bmatrix} a_{11} & a_{12} & \\cdots & a_{1n} \\\\ a_{21} & a_{22} & \\cdots & a_{2n} \\\\ \\vdots & \\vdots & \\ddots & \\vdots \\\\a_{n1} & a_{n2} & \\cdots & a_{nn} \\end{bmatrix}, \\qquad \\mathbf{x} = \\begin{bmatrix} x_{1} \\\\ x_2 \\\\ \\vdots \\\\ x_n \\end{bmatrix} , \\qquad \\mathbf{b} = \\begin{bmatrix} b_{1} \\\\ b_2 \\\\ \\vdots \\\\ b_n \\end{bmatrix}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Iterative methods, Successive over-relaxation\n", + "\n", + "Then A can be decomposed into a diagonal component D, and strictly lower and upper triangular components L and U:" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathbf{A} =\\mathbf{D} + \\mathbf{L} + \\mathbf{U},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "where" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "D = \\begin{bmatrix} a_{11} & 0 & \\cdots & 0 \\\\ 0 & a_{22} & \\cdots & 0 \\\\ \\vdots & \\vdots & \\ddots & \\vdots \\\\0 & 0 & \\cdots & a_{nn} \\end{bmatrix}, \\quad L = \\begin{bmatrix} 0 & 0 & \\cdots & 0 \\\\ a_{21} & 0 & \\cdots & 0 \\\\ \\vdots & \\vdots & \\ddots & \\vdots \\\\a_{n1} & a_{n2} & \\cdots & 0 \\end{bmatrix}, \\quad U = \\begin{bmatrix} 0 & a_{12} & \\cdots & a_{1n} \\\\ 0 & 0 & \\cdots & a_{2n} \\\\ \\vdots & \\vdots & \\ddots & \\vdots \\\\0 & 0 & \\cdots & 0 \\end{bmatrix}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "The system of linear equations may be rewritten as:" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "(D+\\omega L) \\mathbf{x} = \\omega \\mathbf{b} - [\\omega U + (\\omega-1) D ] \\mathbf{x}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "for a constant $\\omega > 1$.\n", + "\n", + "\n", + "\n", + "\n", + "## Iterative methods, Successive over-relaxation\n", + "\n", + "The method of successive over-relaxation is an iterative technique that solves the left hand side of this expression for $x$, using previous value for $x$ on the right hand side. Analytically, this may be written as:" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathbf{x}^{(k+1)} = (D+\\omega L)^{-1} \\big(\\omega \\mathbf{b} - [\\omega U + (\\omega-1) D ] \\mathbf{x}^{(k)}\\big).\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "However, by taking advantage of the triangular form of $(D+\\omega L)$, the elements of $x^{(k+1)}$ can be computed sequentially using forward substitution:" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "x^{(k+1)}_i = (1-\\omega)x^{(k)}_i + \\frac{\\omega}{a_{ii}} \\left(b_i - \\sum_{j > i} a_{ij}x^{(k)}_j - \\sum_{j < i} a_{ij}x^{(k+1)}_j \\right),\\quad i=1,2,\\ldots,n.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "The choice of relaxation factor is not necessarily easy, and depends upon the properties of the coefficient matrix. For symmetric, positive-definite matrices it can be proven that $0 < \\omega < 2$ will lead to convergence, but we are generally interested in faster convergence rather than just convergence.\n", + "\n", + "\n", + "\n", + "# Cubic Splines\n", + "\n", + "Cubic spline interpolation is among one of the most used \n", + "methods for interpolating between data points where the arguments\n", + "are organized as ascending series. In the library program we supply\n", + "such a function, based on the so-called cubic spline method to be \n", + "described below. \n", + "\n", + "A spline function consists of polynomial pieces defined on\n", + "subintervals. The different subintervals are connected via\n", + "various continuity relations.\n", + "\n", + "Assume we have at our disposal $n+1$ points $x_0, x_1, \\dots x_n$ \n", + "arranged so that $x_0 < x_1 < x_2 < \\dots x_{n-1} < x_n$ (such points are called\n", + "knots). A spline function $s$ of degree $k$ with $n+1$ knots is defined\n", + "as follows\n", + " * On every subinterval $[x_{i-1},x_i)$ *s* is a polynomial of degree $\\le k$.\n", + "\n", + " * $s$ has $k-1$ continuous derivatives in the whole interval $[x_0,x_n]$.\n", + "\n", + "## Splines\n", + "\n", + "As an example, consider a spline function of degree $k=1$ defined as follows" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "s(x)=\\begin{bmatrix} s_0(x)=a_0x+b_0 & x\\in [x_0, x_1) \\\\ \n", + " s_1(x)=a_1x+b_1 & x\\in [x_1, x_2) \\\\ \n", + " \\dots & \\dots \\\\\n", + " s_{n-1}(x)=a_{n-1}x+b_{n-1} & x\\in \n", + " [x_{n-1}, x_n] \\end{bmatrix}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "In this case the polynomial consists of series of straight lines \n", + "connected to each other at every endpoint. The number of continuous\n", + "derivatives is then $k-1=0$, as expected when we deal with straight lines.\n", + "Such a polynomial is quite easy to construct given\n", + "$n+1$ points $x_0, x_1, \\dots x_n$ and their corresponding \n", + "function values. \n", + "\n", + "\n", + "\n", + "\n", + "## Splines\n", + "\n", + "The most commonly used spline function is the one with $k=3$, the so-called\n", + "cubic spline function. \n", + "Assume that we have in adddition to the $n+1$ knots a series of\n", + "functions values $y_0=f(x_0), y_1=f(x_1), \\dots y_n=f(x_n)$.\n", + "By definition, the polynomials $s_{i-1}$ and $s_i$ \n", + "are thence supposed to interpolate the same point $i$, that is" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "s_{i-1}(x_i)= y_i = s_i(x_i),\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "with $1 \\le i \\le n-1$. In total we have $n$ polynomials of the \n", + "type" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "s_i(x)=a_{i0}+a_{i1}x+a_{i2}x^2+a_{i2}x^3,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "yielding $4n$ coefficients to determine.\n", + "\n", + "\n", + "\n", + "\n", + "## Splines\n", + "\n", + "Every subinterval provides in addition the $2n$ conditions" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "y_i = s(x_i),\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "s(x_{i+1})= y_{i+1},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "to be fulfilled. If we also assume that $s'$ and $s''$ are continuous,\n", + "then" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "s'_{i-1}(x_i)= s'_i(x_i),\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "yields $n-1$ conditions. Similarly," + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "s''_{i-1}(x_i)= s''_i(x_i),\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "results in additional $n-1$ conditions. In total we have $4n$ coefficients\n", + "and $4n-2$ equations to determine them, leaving us with $2$ degrees of \n", + "freedom to be determined. \n", + "\n", + "\n", + "\n", + "## Splines\n", + "\n", + "Using the last equation we define two values for the second derivative, namely" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "s''_{i}(x_i)= f_i,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "s''_{i}(x_{i+1})= f_{i+1},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and setting up a straight line between $f_i$ and $f_{i+1}$ we have" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "s_i''(x) = \\frac{f_i}{x_{i+1}-x_i}(x_{i+1}-x)+\n", + " \\frac{f_{i+1}}{x_{i+1}-x_i}(x-x_i),\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and integrating twice one obtains" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "s_i(x) = \\frac{f_i}{6(x_{i+1}-x_i)}(x_{i+1}-x)^3+\n", + " \\frac{f_{i+1}}{6(x_{i+1}-x_i)}(x-x_i)^3\n", + " +c(x-x_i)+d(x_{i+1}-x).\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Splines\n", + "\n", + "Using the conditions $s_i(x_i)=y_i$ and $s_i(x_{i+1})=y_{i+1}$ \n", + "we can in turn determine the constants $c$ and $d$ resulting in" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "s_i(x) =\\frac{f_i}{6(x_{i+1}-x_i)}(x_{i+1}-x)^3+\n", + " \\frac{f_{i+1}}{6(x_{i+1}-x_i)}(x-x_i)^3 \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "\n", + "
\n", + "\n", + "$$\n", + "\\begin{equation} \n", + " +(\\frac{y_{i+1}}{x_{i+1}-x_i}-\\frac{f_{i+1}(x_{i+1}-x_i)}{6})\n", + " (x-x_i)+\n", + " (\\frac{y_{i}}{x_{i+1}-x_i}-\\frac{f_{i}(x_{i+1}-x_i)}{6})\n", + " (x_{i+1}-x).\n", + "\\label{_auto8} \\tag{9}\n", + "\\end{equation}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Splines\n", + "\n", + "How to determine the values of the second\n", + "derivatives $f_{i}$ and $f_{i+1}$? We use the continuity assumption \n", + "of the first derivatives" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "s'_{i-1}(x_i)= s'_i(x_i),\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and set $x=x_i$. Defining $h_i=x_{i+1}-x_i$ we obtain finally\n", + "the following expression" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "h_{i-1}f_{i-1}+2(h_{i}+h_{i-1})f_i+h_if_{i+1}=\n", + " \\frac{6}{h_i}(y_{i+1}-y_i)-\\frac{6}{h_{i-1}}(y_{i}-y_{i-1}),\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and introducing the shorthands $u_i=2(h_{i}+h_{i-1})$, \n", + "$v_i=\\frac{6}{h_i}(y_{i+1}-y_i)-\\frac{6}{h_{i-1}}(y_{i}-y_{i-1})$,\n", + "we can reformulate the problem as a set of linear equations to be \n", + "solved through e.g., Gaussian elemination\n", + "\n", + "\n", + "\n", + "\n", + "## Splines\n", + "\n", + "Gaussian elimination" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\begin{bmatrix} u_1 & h_1 &0 &\\dots & & & & \\\\\n", + " h_1 & u_2 & h_2 &0 &\\dots & & & \\\\\n", + " 0 & h_2 & u_3 & h_3 &0 &\\dots & & \\\\\n", + " \\dots& & \\dots &\\dots &\\dots &\\dots &\\dots & \\\\\n", + " &\\dots & & &0 &h_{n-3} &u_{n-2} &h_{n-2} \\\\\n", + " & && & &0 &h_{n-2} &u_{n-1} \\end{bmatrix}\n", + " \\begin{bmatrix} f_1 \\\\ \n", + " f_2 \\\\\n", + " f_3\\\\\n", + " \\dots \\\\\n", + " f_{n-2} \\\\ \n", + " f_{n-1} \\end{bmatrix} =\n", + " \\begin{bmatrix} v_1 \\\\ \n", + " v_2 \\\\\n", + " v_3\\\\\n", + " \\dots \\\\\n", + " v_{n-2}\\\\\n", + " v_{n-1} \\end{bmatrix}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Note that this is a set of tridiagonal equations and can be solved \n", + "through only $O(n)$ operations.\n", + "\n", + "\n", + "\n", + "## Splines\n", + "\n", + "The functions supplied in the program library are *spline* and *splint*.\n", + "In order to use cubic spline interpolation you need first to call" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + " spline(double x[], double y[], int n, double yp1, double yp2, double y2[])\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "This function takes as\n", + "input $x[0,..,n - 1]$ and $y[0,..,n - 1]$ containing a tabulation\n", + "$y_i = f(x_i)$ with $x_0 < x_1 < .. < x_{n - 1}$ \n", + "together with the \n", + "first derivatives of $f(x)$ at $x_0$ and $x_{n-1}$, respectively. Then the\n", + "function returns $y2[0,..,n-1]$ which contains the second derivatives of\n", + "$f(x_i)$ at each point $x_i$. $n$ is the number of points.\n", + "This function provides the cubic spline interpolation for all subintervals\n", + "and is called only once.\n", + "\n", + "\n", + "\n", + "\n", + "## Splines\n", + "\n", + "Thereafter, if you wish to make various interpolations, you need to call the function" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + " splint(double x[], double y[], double y2a[], int n, double x, double *y)\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "which takes as input\n", + "the tabulated values $x[0,..,n - 1]$ and $y[0,..,n - 1]$ and the output \n", + "y2a[0,..,n - 1] from *spline*. It returns the value $y$ corresponding\n", + "to the point $x$.\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "## Conjugate gradient (CG) method\n", + "\n", + "The success of the CG method for finding solutions of non-linear problems is based\n", + "on the theory of conjugate gradients for linear systems of equations. It belongs\n", + "to the class of iterative methods for solving problems from linear algebra of the type" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{A}\\hat{x} = \\hat{b}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "In the iterative process we end up with a problem like" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{r}= \\hat{b}-\\hat{A}\\hat{x},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "where $\\hat{r}$ is the so-called residual or error in the iterative process.\n", + "\n", + "When we have found the exact solution, $\\hat{r}=0$.\n", + "\n", + "\n", + "\n", + "\n", + "## Conjugate gradient method\n", + "\n", + "\n", + "The residual is zero when we reach the minimum of the quadratic equation" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "P(\\hat{x})=\\frac{1}{2}\\hat{x}^T\\hat{A}\\hat{x} - \\hat{x}^T\\hat{b},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "with the constraint that the matrix $\\hat{A}$ is positive definite and symmetric.\n", + "If we search for a minimum of the quantum mechanical variance, then the matrix \n", + "$\\hat{A}$, which is called the Hessian, is given by the second-derivative of the function we want to minimize. This quantity is always positive definite. In our case this corresponds normally to the second derivative of the energy. \n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "## Conjugate gradient method, Newton's method first\n", + "\n", + "We seek the minimum of the energy or the variance as function of various variational parameters. \n", + "In our case we have thus a function $f$ whose minimum we are seeking.\n", + "In Newton's method we set $\\nabla f = 0$ and we can thus compute the next iteration point" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{x}-\\hat{x}_i=\\hat{A}^{-1}\\nabla f(\\hat{x}_i).\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Subtracting this equation from that of $\\hat{x}_{i+1}$ we have" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{x}_{i+1}-\\hat{x}_i=\\hat{A}^{-1}(\\nabla f(\\hat{x}_{i+1})-\\nabla f(\\hat{x}_i)).\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Simple example and demonstration\n", + "\n", + "The function $f$ can be either the energy or the variance. If we choose the energy then we have" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{\\alpha}_{i+1}-\\hat{\\alpha}_i=\\hat{A}^{-1}(\\nabla E(\\hat{\\alpha}_{i+1})-\\nabla E(\\hat{\\alpha}_i)).\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "In the simple harmonic oscillator model, the gradient and the Hessian $\\hat{A}$ are" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{d\\langle E_L[\\alpha]\\rangle}{d\\alpha} = \\alpha-\\frac{1}{4\\alpha^3}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and a second derivative which is always positive (meaning that we find a minimum)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{A}= \\frac{d^2\\langle E_L[\\alpha]\\rangle}{d\\alpha^2} = 1+\\frac{3}{4\\alpha^4}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Simple example and demonstration\n", + "\n", + "We get then" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\alpha_{i+1}=\\frac{4}{3}\\alpha_i-\\frac{\\alpha_i^4}{3\\alpha_{i+1}^3},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "which can be rewritten as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\alpha_{i+1}^4-\\frac{4}{3}\\alpha_i\\alpha_{i+1}^4+\\frac{1}{3}\\alpha_i^4.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Conjugate gradient method\n", + "\n", + "In the CG method we define so-called conjugate directions and two vectors \n", + "$\\hat{s}$ and $\\hat{t}$\n", + "are said to be\n", + "conjugate if" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{s}^T\\hat{A}\\hat{t}= 0.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "The philosophy of the CG method is to perform searches in various conjugate directions\n", + "of our vectors $\\hat{x}_i$ obeying the above criterion, namely" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{x}_i^T\\hat{A}\\hat{x}_j= 0.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Two vectors are conjugate if they are orthogonal with respect to \n", + "this inner product. Being conjugate is a symmetric relation: if $\\hat{s}$ is conjugate to $\\hat{t}$, then $\\hat{t}$ is conjugate to $\\hat{s}$.\n", + "\n", + "\n", + "\n", + "## Conjugate gradient method\n", + "\n", + "An example is given by the eigenvectors of the matrix" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{v}_i^T\\hat{A}\\hat{v}_j= \\lambda\\hat{v}_i^T\\hat{v}_j,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "which is zero unless $i=j$. \n", + "\n", + "\n", + "\n", + "\n", + "## Conjugate gradient method\n", + "\n", + "Assume now that we have a symmetric positive-definite matrix $\\hat{A}$ of size\n", + "$n\\times n$. At each iteration $i+1$ we obtain the conjugate direction of a vector" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{x}_{i+1}=\\hat{x}_{i}+\\alpha_i\\hat{p}_{i}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We assume that $\\hat{p}_{i}$ is a sequence of $n$ mutually conjugate directions. \n", + "Then the $\\hat{p}_{i}$ form a basis of $R^n$ and we can expand the solution \n", + "$ \\hat{A}\\hat{x} = \\hat{b}$ in this basis, namely" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{x} = \\sum^{n}_{i=1} \\alpha_i \\hat{p}_i.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Conjugate gradient method\n", + "\n", + "The coefficients are given by" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathbf{A}\\mathbf{x} = \\sum^{n}_{i=1} \\alpha_i \\mathbf{A} \\mathbf{p}_i = \\mathbf{b}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Multiplying with $\\hat{p}_k^T$ from the left gives" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{p}_k^T \\hat{A}\\hat{x} = \\sum^{n}_{i=1} \\alpha_i\\hat{p}_k^T \\hat{A}\\hat{p}_i= \\hat{p}_k^T \\hat{b},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and we can define the coefficients $\\alpha_k$ as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\alpha_k = \\frac{\\hat{p}_k^T \\hat{b}}{\\hat{p}_k^T \\hat{A} \\hat{p}_k}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Conjugate gradient method and iterations\n", + "\n", + "\n", + "If we choose the conjugate vectors $\\hat{p}_k$ carefully, \n", + "then we may not need all of them to obtain a good approximation to the solution \n", + "$\\hat{x}$. \n", + "We want to regard the conjugate gradient method as an iterative method. \n", + "This will us to solve systems where $n$ is so large that the direct \n", + "method would take too much time.\n", + "\n", + "We denote the initial guess for $\\hat{x}$ as $\\hat{x}_0$. \n", + "We can assume without loss of generality that" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{x}_0=0,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "or consider the system" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{A}\\hat{z} = \\hat{b}-\\hat{A}\\hat{x}_0,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "instead.\n", + "\n", + "\n", + "\n", + "\n", + "## Conjugate gradient method\n", + "\n", + "One can show that the solution $\\hat{x}$ is also the unique minimizer of the quadratic form" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "f(\\hat{x}) = \\frac{1}{2}\\hat{x}^T\\hat{A}\\hat{x} - \\hat{x}^T \\hat{x} , \\quad \\hat{x}\\in\\mathbf{R}^n.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "This suggests taking the first basis vector $\\hat{p}_1$ \n", + "to be the gradient of $f$ at $\\hat{x}=\\hat{x}_0$, \n", + "which equals" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{A}\\hat{x}_0-\\hat{b},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and \n", + "$\\hat{x}_0=0$ it is equal $-\\hat{b}$.\n", + "The other vectors in the basis will be conjugate to the gradient, \n", + "hence the name conjugate gradient method.\n", + "\n", + "\n", + "\n", + "\n", + "## Conjugate gradient method\n", + "\n", + "Let $\\hat{r}_k$ be the residual at the $k$-th step:" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{r}_k=\\hat{b}-\\hat{A}\\hat{x}_k.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Note that $\\hat{r}_k$ is the negative gradient of $f$ at \n", + "$\\hat{x}=\\hat{x}_k$, \n", + "so the gradient descent method would be to move in the direction $\\hat{r}_k$. \n", + "Here, we insist that the directions $\\hat{p}_k$ are conjugate to each other, \n", + "so we take the direction closest to the gradient $\\hat{r}_k$ \n", + "under the conjugacy constraint. \n", + "This gives the following expression" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{p}_{k+1}=\\hat{r}_k-\\frac{\\hat{p}_k^T \\hat{A}\\hat{r}_k}{\\hat{p}_k^T\\hat{A}\\hat{p}_k} \\hat{p}_k.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Conjugate gradient method\n", + "\n", + "We can also compute the residual iteratively as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{r}_{k+1}=\\hat{b}-\\hat{A}\\hat{x}_{k+1},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "which equals" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{b}-\\hat{A}(\\hat{x}_k+\\alpha_k\\hat{p}_k),\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "or" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "(\\hat{b}-\\hat{A}\\hat{x}_k)-\\alpha_k\\hat{A}\\hat{p}_k,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "which gives" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{r}_{k+1}=\\hat{r}_k-\\hat{A}\\hat{p}_{k},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# Review of probability theory\n", + "\n", + "## Domains and probabilities\n", + "\n", + "Consider the following simple example, namely the tossing of a 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 a dice\n", + "\n", + "The numbers in the domain are the outcomes of the physical process tossing the 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", + "\n", + "**Random variables are characterized by a domain which contains all possible values that the random value may take. This domain has a corresponding PDF**.\n", + "\n", + "\n", + "\n", + "## Stochastic variables and the main concepts, the discrete case\n", + "\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", + "\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", + "\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", + "\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", + "\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{10}\n", + "\\end{equation}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "with" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\begin{array}{ll}\n", + "\\theta(x)=0 & x<0 \\\\\n", + "\\theta(x)=\\frac{1}{b-a} & \\in [a,b].\n", + "\\end{array}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "The normal distribution with $b=1$ and $a=0$ is used to generate random numbers. \n", + "\n", + "\n", + "\n", + "## Gaussian distribution\n", + "\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": [ + { + "data": { + "image/png": "iVBORw0KGgoAAAANSUhEUgAAAYYAAAEhCAYAAAB7mQezAAAABHNCSVQICAgIfAhkiAAAAAlwSFlz\nAAALEgAACxIB0t1+/AAAADl0RVh0U29mdHdhcmUAbWF0cGxvdGxpYiB2ZXJzaW9uIDIuMS4wLCBo\ndHRwOi8vbWF0cGxvdGxpYi5vcmcvpW3flQAAIABJREFUeJztnXt8VNW5978r3MI1kwDGe3BAUVHQ\nSUDrBa1OoNZ6aU2I1lsvkrQ9R89pXyVie86r55y+NLG2PW3Pqwm1F22rkFjf1lqBTBBUvJBkFKso\naEZjRYmQsIOK4ZKs94+99zAzmftMMpPwfPkMk733Wms/s2fP+u31POuitNYIgiAIgk1Opg0QBEEQ\nsgsRBkEQBCEIEQZBEAQhCBEGQRAEIQgRBkEQBCEIEYZhjlKqTCnVoJRqV0pp671JKbXMOu5USrVl\n2s5kUEo5lFJt1suRaXsiYdmpA15lIccy+hnC2aCUcofY7MwW24TMI8IwTLEq/HagAegGSrXWSms9\nU2tdChiWILQBGfnRpwE34LJe7gzbEhGttaG1VoAvzOGUP4Ml/qlUmgNs0Fp7LJsHnRj2D4vv+EhD\nyTiG4YdSyoVZ4QNUaa3rY6QztNb5Q2VfOlFKNQBorcszbUsslFJNmJVbuda6MWB/Sp/BEvilWmtv\nCraFtUEptQdwADO11uGELWVi2T+cvuMjhdGZNkBIigbr3RtJFAC01l6lVC1QOTRmpZ+RUFmk8hks\ncXdl0oZUiMf+kfAdjzTElTTMsPzXtmtoRRxZ6gbRHGEQUUq5geZM25Esw93+IxlpMQw/SgP+jtn0\n11r7lFInhTumlKrDFBkfUGD9XRfYCrGCku0B2fyuK6VUoB+yXmtdFZCnJuCY7V9u0lrXxpPG8knv\nCTge6p5JxvZiK12Fdb4SYIVtU7xYttVY+e3vwLYjNF3YzxDH518GVAXsb1ZKddufQ2ttWBVvU0AZ\n+cBK6zN2A/aTeMTrGIBLKWXb43/wCLE37vsgTvtjfcf2dXYChlWWAVTbbq9kv+N47tEjGq21vIbR\nC7Mi0NbLkUI5lVYZTQH7lln76sKkb7eOVUawpy5g3x7AHSZdTSJpQs5bloztmD/4PdaxmkD7A8p2\nh37eKNfNaZXXHnj9gbKA76Usjs8Q7+e3y3RFsMcRkKbO2ra/k3CfNdQ2+9o0hXwe+3pG+j5i3gfx\n2B/l+rhCv2Nrf02YtAl/x/Fe/yP1Ja6kIxf76S0wIGg/bYeLSRgRyglqtVg+ZQcD/crVQEu8aWKc\nN27btdZGgI1OHRyTsfMHtsJi0YBpe41Vtn2eRiK34II+Q4KfPyqWDXb57dZ2DdAIrI5kQxhCP0+t\nlWeZZW+sclIJXIcr046jVQfu1Frb2w12T6dEv+N0Xv+RigjD8CPwBzigG6pSapk1lqFdKbUn4NWu\nlPJXmlZFlh/wQyOwYki2X7s2e54YQI3VP77NclEY1jnjShPjHMnaHvqjtwUmrq6gVkVkVyaeePKE\nI9XPHwWPVb5Ha10eeE2SxL7XhrQbqfX9OcF/rUKJZlfM73gQr/+IQYRh+BHoUx5QAWqta7U5lmEm\n0Ir1g7D2DejBZPUxr7MGyaUrUF3M4YrThemWaA8c+BVnmqgkYXuqFWU6x4Ok/PnDkOrnC8WuVOen\nudxYxNsLK5xd8V6Dwbj+IwYRhmFGiMtiebLlWK2HPVYZddYTZlUaTARAa12qzQFUxYAdzFuZaJpM\n2B6FtPbzT+bzWyOWh+oJ3g6mp829Eqf9sa6zbVd71FQxSPb+OxIQYRie2L1NXIHuoTAUhNtp+Vjt\nJ+xLIzTX46UkpOygnjJaa6/l8vH3UIknTSTSbHtCWK4Z+3xJjy1I5fNb5x2qkeyJuM1KYifxlxnV\n/gBXj/19+7HcefY1Ssqdl+L1PyIQYRiGWD+cYswnK9uVEvoDqiTyTR7Y3PaLh5XHfloLzWv/CGcG\npHcHpAv8sTut7oqBzMQMiCaSJl22pxNblAO7Otrnt69BPBV3vJ/fvu52xVuK6SJMN0EtroCuq9Uh\n4pvIfRCYPlH77esc+gRv21WlUxupnez9d2SQ6W5R8krthdlNsoHD3fXaMafBqOFwz4u2MPnsp6Z2\n673B2lcWUFZoV8E6K32D9arkcPdBf7dEq7xlAeU2EdydNZ40Dg53NdSWTcsSsR2zkgoto84qoy0g\n7Z5w1yjKNXdY5wy8FmUh52qK9Bni+fwh52qybbSvQcB1DCy/Pcx3FvE6Wsf3WNfOGfBZmqxX2G68\n8dwHcdofyzbbpjarjDZr2xWSJqHvOJHrf6S+ZK4kQRAEIQhxJQmCIAhBiDAIgiAIQYgwCIIgCEGI\nMAiCIAhBiDAIgiAIQYgwCIIgCEGM+PUYpk2bpmfMmJFpMwRBEDJOW1vbbq319FjpRrwwzJgxg9bW\nwRgoKgiCMLxQSnXEk05cSYIgCEIQIgyCIAhCECIMgiAIQhAiDIIgCEIQIgyCIAhCECIMgiAIQhAj\nvruqIGSCAwfg448H7lcKCsKuqycI2YO0GARhEDjjDJg2beBr6lS4775MWycI0ZEWgyCkmUOH4K23\n4PLLYfHi4GP//u/w5puZsUsQ4kWEQRDSzN695vuiRXDrrcHHHngADGNgHkHIJsSVJAhpxq74HY6B\nxxwOEQYh+xFhEIQ0I8IgDHdEGAQhzYgwCMOdjAuDUqpMKeVWSi2LcNxtvWoC9tVY75VDZacgxIsI\ngzDcyagwKKVcAFprD2DY2wHH3UC5ddwVcLxSKdUO+IbUYEGIg3iEQeuhtUkQEiHTLYYKwH5+8gHu\nwINaa4/WusradGqtvdbfS7XWMy3BEISsIpYwHDoE+/YNrU2CkAiZFgYH0B2wPTVcIsvNVBWwyxnN\n/SQImcQwICcHJk0aeMwWC3EnCdlMpoUhLrTWtUCVUsphb1uthamWuykIpVSlUqpVKdW6a9euoTZX\nOMIxDMjLM8UhFFsY9uwZWpsEIREyLQwGYM8c4wC6Ag8qpQLjCj7M2EKlUqrM2tcFOEML1VrXa61L\ntNYl06fHXN5UENKKYYR3I4G0GIThQaaFYRWHK3Yn4AGwWwaYMYdA4fABrXY6YKa1LQhZgwiDMNzJ\nqDDYwWTLHWQEBJebrfd6zHhCpZW+0UqzxGo1tAfkEYSsQIRBGO5kfK4krXV9mH3F1ruBKQ4x8whC\ntmAYMGtW+GMiDMJwINOuJEEYcURrMeTlHU4jCNmKCIMgpJlowjB2LEyYIMIgZDciDIKQRg4dMldu\niyQMINNiCNmPCIMgpBF7LQYRBmE4I8IgCGkk2nQYNiIMQrYjwiAIaUSEQRgJiDAIQhoRYRBGAiIM\ngpBGRBiEkYAIgyCkkUSEQdZkELIVEQZBSCPxCkNfH3z66dDYJAiJIsIgCGkk2loMNjIthpDtZHyu\npOGK4fOxpa6OltpaCl0uZldUAPBZVxc9Ph/nLF9OocsVoxQhm9lcW0ue00lvt7mW1LzK2EuMR1uL\nwSZQGI4/Ph2WhmdbYyM7W1q4qKYmdmJBCECEIUkcTicX1dSwvbGR2RUVLFh2eDE5w+fjVzNncmNb\n27AThy319XFVgCOdjdXVHD1/PrPLyvzb2xob/duRiDYdhs1gtxg6PB46vV46mprIcw5YrkQQYiKu\npEHA4XRS6HLx0ooVmTYlYTrb2jJtQlbwan19kAjMKC3l1bq6mPmyQRiK3G4WLFvGUcPsoUTIHkQY\nBolewyC3oCB2wiyh1zBYV1Xld5scyXR6By7xkVtQQIfHEyZ1MNkgDIKQKuJKGgTsCmSh5dvt9Hox\nfD7zWFMT86qq/C6mDo+HZ6qrKSwpoai0lG2rVlFUWsq8ysq48uU5ncyrqvKfB+CUsjI6vV56u7vp\naGriyoYGv229hsFLK1Zw9Pz57GxpYUZpKUVuNx0eD73d3XR6vWyurWWcw+F3KUXLE8n2zVbspdcw\n2NnSwqkVFRS6XGypr2d7QwPlTU1xXUvD56Opqioo/cPFxZQ3N5MbqwZOkt7u7gGiPs46V69hRD1v\n6FoMhs/HM9XVdHq99Ph8jHM4GJNXwDW4MYzYLRBByAQiDGlgZ0sLW+rNtYP2GwbjHA6Wtrf7j69b\nupQFy5czu6yMQpeLh4uLudVaDb7I7WZuVRWba2pYWFODI8AnHCvfguXL/eLgcDopLCnhl/n55Dmd\nfjfI9oaGIN/4w8XFlDc14bDSrLRiIYFuk8B4SbQ8kWzfUl9PntNJkdsNEFSRFrndCbWktjc2BvnJ\nDZ8Pw+eLWjmvs4QyFgtrasKW02sYA1pOts293d0xhcHfIvD5eKK8nCsaGnA4nWypr6ejqYkv/KGB\nb4+DsyK0GFK1XxBSJePCYC3RaQAurXVtmONu689SrXV1PHmGmqPnz48asA18urUrT8Pn8/+dW1CA\nw+kk1+EgN8AvHDNfyDF7OzDgHdirZltjY1B6O22HxxMxqBorTzjbe7u7/W6pIrfbLxB2OY4EAqId\nTU3MDagoOzyeoPLCsSiOWEA0woqFdQ1jiVqgMDxRXs6ilSv9n7fI7WZzTU3MNRlStV8QUiWjwqCU\ncgForT1KKadSyhW4hrMlCuVa6yqlVLWdPlqebCTX4aDD4zGfdCNULOPCVEbx5AtXiUVK22M9aQf6\nyo+ePz/qU2c8eUJtL3K7WVRXx5a6Opos91eyrp8Oj4crAlxhHU1NFJWWJlxOIuQWFLA/pNa2t6N9\nhsC1GGwXYKBI9/h8/m2ZFkPIZjLdYqgAbOexD3AD/kpea+0B7BrJqbX2KqVqouXJRhpKSzmlvNzf\nqli3dOmg5otEXsCTq02kp2/D52O/YSSUx8Z+qrfTbayu5tX6+gEuqlh0er3kWa2RwLIX1tQEtZxC\nSdUVU+hyDRA7u/UTjcC1GDq9XgpLSoKOb6mr8493iSYM4koSMk2mhcEBBDpzp4ZLpJRaBti/lrjy\nZAudXi8dHk9Q8NR++ozWLz7ZfNGYXVbG5hUrgirVXsPwP8k6nE56rCfdHp+PIrebQpcrap5ItsNh\nATm1osLf4jB8Pjq93rjs7/B4BojCfsPA4XSyrbExojCkwxUzt7Iy6Dq/G+LSMnw+/zXy7wuYDqPQ\n5Qrq3mpfE7u8aMIgriQh02RaGOJCa12rlGpQSrVm2hYbw+dje2MjPdYIaBgYtAWzgphr9dKxn35L\n6+rYXFPD7PJyOr1eXq2rY2drK5tra5lbWUmuwxFXvs01Nf5eRHMrK/3jJp6prmZBdTUdHg/bVq+m\ns7UVhxUMLm9u9vcwsrErq0KXi8KSEn+vpCLreKQ8kWwf53Bg+Hz0WvGJHp/Pf206PB62NzTEJQzb\nVq0it6CALfX1ZhyjoMBfYScSp0iGi2pq2FxbyzbrO3bMnBlk8/bGRl5ascLfGQCChcHhdHJKeTlb\n6uvJLSigt7s7qHeYwwGdnYNju/1Qsb2xkd7ubhwzZ/pFXhDiQekMTvFou4WseEEZpruoNuC4HYOw\nXUhdmC2EiHmsfJVAJcCJJ55Y3NHRMUSfSEgnP1aK27N4CtLQQPj69XDppbBxIyxcGD3v9dfDSy/B\n228PspGCEIBSqk1rXRIrXaYHuK0C7Ec/J1Y8QSll+w/cgB1JdWDGFMLmCURrXa+1LtFal0yfPn2Q\nTBcGkw6PJ+ufcHtDfEHxzKxqI8FnIZvJqDDYvYms3kdGQO+iZuu9HnBaLQC01o1R8ggjCMPnC/Lp\nZxvhgt/JCEMWN4iEI5iMxxi01vVh9hVb7wamOMTMI4wssn0iv3AxjkSFwV6TIdoU3YKQCTLtShKE\nEUM8azHYyHxJQjYjwiAIaSKetRhsRBiEbEaEQRDSRDwzq9qIMAjZjAiDIKQJEQZhpCDCIAhpQoRB\nGCmIMAhCmhBhEEYKIgyCkCYSEYa8vMN5BCHbEGEQhDSRiDDEWpNBEDKJCIMgpAF7LQa7JRAPMi2G\nkK2IMAhCGghciyFeRBiEbEWEQRDSQCLTYdiIMAjZigiDIKQBEQZhJCHCIAhpQIRBGEmIMAhCGhBh\nEEYSIgyCkAZSEQZZk0HINiKux6CUWpvG8yhgj9a6Io1lCkLWkKwwyJoMQjYSbaEepbVelK4TKaXW\npassQcg2DAOUgsmT488TOC2GCIOQTURzJaV7yUxZglMYsSSyFoONzJckZCsRb2Ot9Z0ASqlL0nEi\nu7xQlFJlSim3UmpZhOOV1qsmYF+NfSwdtglCqiQyHYaNCIOQrcTzfFMTO0lyKKVcAFprD2DY2wHH\n3YDHWuPZaW0DVCql2gHfYNkmCIkgwiCMJOIRhmKl1P1KqVuUUlPSfP4KwP5Z+AB3yHFnwD6ftQ2w\nVGs90xIUQcg4IgzCSCJa8NmmSmu9UimVB1RY716t9fo0nN8BdAdsTw08aLUUbFzAKutvu/Xg0lrX\npsEOQUgJw4CZMxPLI8IgZCsxhUFrvdJ67wFWAiilTlJK3QFooFFr/e5gGmm5mLxaa69lS621v1Qp\n5ZaWg5BpkmkxyJoMQrYST4thAFrrd4B7AZRSlyqlyoE9wGqt9d4EijKAAutvB9AVIZ1ba11tna8S\n6NZaN1rpnaGJrTSVACeeeGIC5ghCciQjDLImg5CtpDzyWWvdrLW+F2jADAqvUkqdFWf2VRyu2J2A\nB0Ap5f+JKaUqA1oIbqDVTgfMtLZDbarXWpdorUumT5+ezMcShLix12JIVBhApsUQspO0TIlhdWmt\nB2qBUgYGkcNiu4asCt+wt4HmgP01Sql2pdSegDxLlFJlQHtAHkHICMmsxWAjwiBkI0m5kgCUUjOA\nKkyXjQN4DCjVWjcnUk5IgNneV2y9e4D8ePIIQqZIZjoMGxEGIRuJKQxKqRl2cNnqrroEUxBcwDvA\nj4B6KzgtCEccqQpDZ2d67RGEVIlrgJtS6hKl1CrMAHMt0AaUaK1naa3vFVEQjmSkxSCMNOJxJZUD\nZZh+/yVa68cG1yRBGF6IMAgjjXiEwQcUS6tAEMKTDmHQ2pydVRCygbhcSSIKghCZVIXBXpNBELKF\nmMJgj3wORSk1Qym1Qil1S8C+SwdhPiVByGqSWYvBRqbFELKRpMYxKKXOxhxkpjC7qgLmYDdgvtWV\nVRCOCJJZi8FGhEHIRpIdx7BEaz0LQCl1TeABrXWzUuorwLsp2iYIw4JkpsOwEWEQspFkRz4HTkMR\nbinzgjD7BGFEIsIgjDSSFYZAMQjXl2JWkuUKwrBDhEEYaSQrDCog6KwDdp6llFoLrEvZMkEYJogw\nCCONpITBGuSWr5TqBlYqpd5SSnVhDoJrSNMiPoIwLEhFGGRNBiEbSXoSPa31vUqpeqAEc8psH9Aq\nYx6EI41UhEHWZBCykaSFAfyrujVbL0E44khlLQYbmRZDyDZiupICB7DFSzJ5BGE4kspaDDYiDEK2\nEU+LoUop1UL43kcR8wC/Ss4kQRg+pDIdho0Ig5BtxCMMxYC9Slq84hBubIMgjDjSJQyyJoOQTcQj\nDKWY014Y8a7OppRanZJVgjBMSJcwbNuWHnsEIR3EFAZbDJRSedZUFwA+rfUrUbLVxWuAtXazAbi0\n1rVhjldaf87UWlfHk0cQhgpxJQkjkbjHMWite7TWf9Ja/wnoUUpdo5T6SrgJ8xJoWbis9B7AsLcD\njrsBj7XGs1Mp5Y6VRxCGknQKgxYHrJAlJDvA7R2t9WOWSORbInFJElNuV2A++YM5DsIdctwZsM9n\nbcfKIwhDRrqEQdZkELKJlMYxAGitXwZeBrBaEBXAKks0YuEAugO2p4aUXR+w6QJWYQbDI+YRhKEk\nlbUYbAKnxZg0KT12CUIqJDtXkh+l1BSl1C1Wl9ZGID91swacwwV4tdbemIkFYQhJZS0GG4cDJvIJ\nRldf+gwThBRIusVgBaKrMF05XqAeWJ3glBgGh6fodgBdEdK57cBzPHmsgHUlwIknnpiAOfFj+Hxs\nqaujpbaWQpeL2RUVAHzW1UWPz8c5y5dT6JLwx3BnW2MjO1tauKimJuzxVKbDAKCvj7nrf0En36fn\nP74Bj/0ihcIOs7nW7JOxs6WFo+fPZ8GyZWkpVzhC0FrH/QIuwXTn9AFvAT8CTkqkjJDyXECl9fcy\nzF5GAI6ANJUBf7sj5Yn0Ki4u1oNJvdOpX6qpCdq3p71d3wt6Z1vboJ57MHilri7TJmQF7zY16Zdq\navRqt1uvrayMmO6KK7Q+66wkT7J1q9af+5zWoDuZrg+NHqv1Bx8kWdhhQu19yOUacI8KRyaY89nF\nrJvjmRLjLKXU/dZMqo3AHqBEa32y1vpOrfU7YfJ8ZUBB4UXJa6V3Y46TsF1FzQH7a5RS7UqpPTHy\nZA0Op5NCl4uXVqzItCkJ09nWlmkTsoIit5sFy5ZxVIxWX1IthoMH4f/8HzjrLNi2jZ0//j3n8Tyq\n7xD8938nbzTQaxiMCzFoblXVsLwXhcwRj2fUi+m6KddaF2itv6XNgHNYlFInAcvjNUBrXa+1truk\n2vuKrXeP1jpfaz3TevdEypNt9BoGuQXDZyG7XsNgXVUVvd3dsRMLfhIWhldegQUL4Pvfh6uugq1b\nGXXT9bQzi/azroH774ee5Cco7u3upqW2FsPnC9q/XwZKCAkQT4zBh+k+coS0BOzpMUJ7X8/E7FZ6\nxNLh8QCw0PJLd3q9/h9qR1MT86qq/PGHDo+HZ6qrKSwpoai0lG2rVlFUWsq8ysq48uU5ncyrqvKf\nB+CUsjI6vV56u7vpaGriyoYGv229hsFLK1Zw9Pz57GxpYUZpKUVuNx0eD73d3XR6vWyurWWcw8G8\nysqYeSLZvtmKvfQaBjtbWji1ooJCl4st9fVsb2igvKkprmtp+Hw0VVUFpX+4uJjy5mZyU3Lup4dY\nwmD4fDxTXU2n10uPz8c4pcjNyaGotJRFq80JAvIOmGk3nlPNyS83QF0dJBkTcDid3NjWhsN5+CfY\n0dREkVt6dQvxE48wNOr4up76UUodUV1Id7a0sKXebLzst5ryS9vb/cfXLV3KguXLmV1WRqHLxcPF\nxdy6Zw9guizmVlWxuaaGhTU1QT/oWPkWLF/uFweH00lhSQm/zM8nz+lkdlkZANsbGtjW2Ojffri4\nmPKmJhxWmpUzZ3JjW5v/ODAgUBkpTyTbt9TXk+d0+iujwAq8yO1OqCW1vbGRvIBrYvh8GD5fVFFY\nZwllLBbW1KQsLnavpLDHfD6eKC/nioYGHE4nW269lY5f/pIrn3gCLrvMn85ek+GNCcVw6aWsu+ce\n2L4dRo1Kyv7ATg+9hkGHx8ON4iIUEiCeKTHuTLTQZPIMZ46eP9//dB2OwKdbu/I0fD7/37kFBTic\nTnIdDnIDftQx84Ucs7cDK4Y8p9PvHtrW2BiU3k7b4fEECUMgsfKEs723u9vvlipyu4OeVh2WiMVL\nR1MTcwMq+g6PJ+bT76K6uGdkSYn9+821GKZNC3/8ifJyFq1c6f+8RR99xGal4JJLBqSdOhW6uoDq\nahYtWgTnngu3pD57/RPl5Sxpbk7omgtCRGFQSt2utf5xuk6U7vKGE7kOBx0ej/mkG+FpOTRgGG++\ncE+MkdL2WE/atqsLTFGL9tQcT55Q24vcbhbV1bGlro4my/2VrOunw+PhigBXWEdTE0WlpQmXMxh0\nWR2lwwmD7QL0i3RfHz1r11J4/PEwbtyA9NOmwe7dgNsNZ58N994LX/96zFZDNDZWV7Ogulq6TQsJ\nE63FUAqksyJPd3nDhobSUk4pL/e3KtYtXTqo+SJhu2QCn7gjPX0bPh/7DSOhPDb2U72dbmN1Na/W\n1yfcl77T6yXPao0Elr2wpiao5RTKULmSdu0y36dPH3is0+ulsKTk8I7nn2dLTw+zv/GNsGVNn26V\npxTrCgrg5ZdNd9NJJyVl/7bGRn8syG+PCIQQJ9GEQSml1qbpPIks8jOi6PR66fB4goKndg+RQN9/\nuvJFY3ZZGZtXrAiqVHsNgx6fj0KXC4fTSY/1pNvj81HkdlPockXNE8l2OCwgp1ZU+Fschs9Hp9cb\nl/0dHs8AUdhvGDicTrY1NkYUhqFwJRk+H7615lRd4YSh0OXi1QA7Oh94AHJymH3PPWHLmz4d3n7b\n/HvRmjUwe7bZO+mBB8w5NxLA7khQ5HbTaxj0dnfz5qpVIgxC3EQUBq31oqE0ZLhh+Hxsb2ykxxoB\nDQODtmBWEHOtXjr2029pXR2ba2qYXV5Op9fLq3V17GxtZXNtLXMrK8l1OOLKt7mmxt+LaG5lpb+v\n+jOWC6HD42Hb6tV0trbisILB5c3N/h5GNnYlXehyUVhS4u+VVGQdj5Qnku3jHA4Mn49eKz7R4/P5\nr02Hx8P2hoa4hGHbqlXkFhSwpb7ejGMUFDC3sjKqKKQLW5i3NzbS292NY+ZMv1CCGRT3/ccKYE9Y\nV5LD6eSU8nK21NeTm59P79q1XHnZZREnVZo27XALhNGj4fbb4TvfgY0b4eKL47a71zBosFxtTQEt\np1OSeJAQjlyUHuFz/ZaUlOjW1tZMmyEkwY+V4vYsvj//+589/Ov/uPnoo/DuJD8vvwwuF/zqV/DN\nb4ZN8sMfwg9+AL29Vgjis89gxgwz31NPDYb5whGIUqpNa10SK13Kk+gJwmDQ4fFkvetjb6eBUhCz\n9+3jj5uz7F15ZcQkdqtj925rx/jxcNttsGYNbNmSFnsFIV5EGISsxPD5grqpZhuGz0cXTgoK4ug4\n9PjjcOGFUZsV9iG/OwlMV9LEiWacQRCGkJTXYxCEwSDauJBswOF08oGK4UICM6L82mvws59FTWaX\n428xAOTnw+c/D08/nZKtgpAo0mIQhCTZtSvy4DY/jz9uvl99ddRkdjlBLQYwA8/btsGHHyZjoiAk\nhQiDICTJrl1xtBgef9wMIBcVRU0W1pUEh3skbdyYjImCkBQiDIKQJLt3x2gxfPghvPACfPnLMcvK\nzzeHKwS5ksCcmnvKFHEnCUOKCIMgJEF/v1mJR20x/PnP5nscwjBqlDlf0oAWw6hRsHAhbNiQrKmC\nkDApCYO13vNZSqkZSqkp6TJKELKdnh7o64vRYnj8cTj5ZDj99LjK9M+XFMrFF5uzrX7wQTKmCkLC\nJCQMSqmlSql1SqlupVQX5kprtZjrPXuVUl1KqRal1O1KqRnpN1cQsoNo8yQB5nzc69ebrYU4p7Tw\nz5cUisQZhCEmnqU9pyilfmS9v8C9AAAgAElEQVTNm6Q5vJLbVK31fK31Ius1y94HvAzcqZRapZQa\nOMdwcPllSim3UiriDGtKKVfIdo31nt19GoURS0xhePJJOHQoLjeSzfTpEVoMdpxB3EnCEBFVGJRS\nZwM1QJ3WerHW+lda65jrDmqtm60lQCuAmUqp2yOU77LSewAjVACsNG6gIWR3pVKqHXN1OUEYcuwK\nPKIr6fHH4ZhjzGU84yRovqRAJM4gDDERhcFau9mptf621vqdZE+gtV4JrAxZFtSmArAXozWnqhyY\n38NAAVhqrQPtCU0vCENB1BbDwYPmVBZXXWVOhREn06ebazz094c5KHEGYQiJeNdqrd/RWj+WjpNo\nrXsiLA/qAAJXn493SVBnLPeTIAwmUVsMW7bAp5+ao5YTYNo0M6BtGGEOSpxBGEKS7pWUyV5IWuta\nq7Uw1XI1CcKQsmuXuU7zhAlhDj73nPl+/vkJlRlxkBtInEEYUpISBqXUamBPaM+jWIHmMBiAPTel\nA+iK49yVSil7cvkuQBazFYacqKOeN20yp8w+7riEygw7X5KNxBmEISTZFkMTsERr/W7I/jarq2q8\nrYlVHK7YnYAHQCkVbb3FVjsdMNPaDsISj1alVOuusI9fgpAaEUc9a20KQ4KtBYgyX5KNxBmEISJZ\nYXBgikMQVizhx8CSeArRWnvB3/PIsLcxx0dgHSsDSuxWgpVmibXdHpAnsNx6rXWJ1rpkeszJbAQh\ncSK2GN5915wKIwlhiOpKgsMxC4kzCINMUtNua63vVUqtVUp5gXVa66QnctFa14fZVxzwdyPQGCuP\nIAwlu3fDqaeGOZBkfAHCLNYTyrx5kJdnupOuuy7h8gUhXpISBqXUA4ACSoFqpZQGvJhuHQOzRfGr\ndBkpCNlGxBbDpk1m5T1nTsJljh9vrssTscUgcQZhiEjWldRujXYu0VrnAIsx3T/zMcciVKfLQEHI\nNj77zOyNGlEYPve5OJZ1C0/E0c82EmcQhoBkhSGop7XW2qO1vtNaZLqSOGMMgjAciTiGYc8ec7W2\nJNxINhFHP9vIeAZhCEhWGDxKqVsiHNuTrDGCMByIOOr5hRfM9xSEIWaLwY4zyPoMwiCSlDBYU2Q0\nKKVuCeyaak2j4QOKI2YWhGFOxBbDpk2mCymB+ZFCidlikDiDMAQkPfLZ6pr6K6313oB972AGpGvT\nYZwgZCMRWwzPPWcu4zlxYtJlR5x6O5CLL4a33oIdO5I+jyBEI+0ruFkzqyY96Z4gZDthheHAAdi8\nOSU3kl3mvn3mKyISZxAGmaizq0aYETVhrDUdIsUkBGFYsXu36dFxBI7Pf/ll6O1NWRhijmWA4PEM\ngjAIRJ1dFXhHKXV/KquxKaWWAsu11jKuQRgR7Nplrs8cNKP2pk3mexpaDBBDGEaNMs9jn1MQ0kxU\nV5LW+mXgTuBb1kjnW+KZB8laB/oBa9W3dq318jTZKwgZJ+w8Sc89B06nuThPCsScL8nm/PNh61bo\n7o6RUBASJ+bIZ2vFtjsBlFLXAL+yVlrTmOMZ7DtzJpCP2SupFXPVt5cHw2hByCQDRj3bE+ctXpxy\n2THnS7K54ALz/fnn4UtfSvm8ghBIQlNiWAv3+BfvUUrlYc6KagDd8Sz7KQjDnV27Qma8aG+Hjz5K\n2Y0EccYYAObPhzFjzJaKCIOQZpKaK8nGEgJpFQhHFLt3h7QYUpg4LxSHwwwhxGwxjB8PxcUSZxAG\nhVRWcJthxRxuV0oltoahIAxT+vrMdZmDhGHTJrNGP/30lMvPyTFbDTFbDGAKUUsL7N+f8nkFIZBk\nV3C7BnM21TsxB7M1K6W6lFLfTKdxgpBt7NljhhSCgs+bNsF554V0U0qemKOfbS64wBSFtra0nFcQ\nbJK9k0u01gVa61nW7KozgRpguVJqVfrME4TsYsDgtq4ueOONtLiRbGLOl2Rz3nnmu+3KEoQ0kaww\n+AI3tNbvaK1rtdazgFYZzCaMVGxh8LcYnn/efE+jMMTdYjjqKDjlFIkzCGknWWHojjToTWt9b9LW\nCEKWYz/J+1sMmzaZvYPmz0/bOeKaL8nGHujW35+28wtCsrOrPgbUKaW+HGHAW368ZSmlypRSbqXU\nsihpXInmEYTBYIAradMmc+K8CRPSdo7p081xa319cSS+4ALTnbVtW9rOLwjJBp9XA1OBB4E9Sqm3\nrKkzvqKUuh1oC0l/VoRyXGAu9AMYoQJgpXEDDYnkEYTBImjK7d5es1dQGt1Idtlaxzmo2T63uJOE\nNJKsK6nJWtazADgZs2fSVMx1nmsxWxP3K6W+abmcIk2JUcHh1eB8mMuCBmEJgC+RPIIwWOzaBZMn\nw7hxwEsvmb2C7NlO00Rc8yXZnHKKqSQSgBbSSNLBZ2v8wllaa5/WeqXWeoklFDM5LBTLMSvvsgjl\nODg8pQZWnlgkk0cQ0sKuXQGB5w0bQCm48MK0niPu+ZLAPL9MqCekmWRjDM1a6x8DA6bAsHoo2UIx\nC5iFjI4WRghBo543bICzzw6Zfzt1AudLMnoNDvQdiJ7hggvg7behszOtdghHLqlOiRFzQR6ttU8p\ntSLCYQMosP52AF1xnDZmHqVUJVAJcOKJJ8ZRpCDEx65dcOyxmPGFF16Af/qntJS7d/9etuzcwuu7\nXqfl3a1w0+t8Y+vr7H2tk7GjxjKvcB4lx5ZQcmwJxccUc/r00xkzaoyZOTDO8JW0LKEiHOGkJAzx\nYvViCscqoMT62wl4AJRSDq21kUiekPPVA/UAJSUlOkmzo2L4fGypq6OltpZCl4vZFRUAfNbVRY/P\nxznLl1Pokrj4cGZzrblC7c6WFo6eP58Fy5axezfMnUva4gtd+7q49/l7+cXmX7DvoLls26Sxk2Ds\n6czUl3Gt+zR279tN6wet/OHvf+D+1vsByB2dS9npZfzX5/+LIpcLcnPNOEMYYVhXVcWiurqU7BSO\nLIZEGCKhtfYqpUqsnkeG1tprHWoGisHsmgqUKKXKtNaNUfIMKQ6nk4tqatje2MjsigoWLDvcc9bw\n+fjVzJnc2NY27MRhS3098yorM21GxgmtTB8uLkZr2LVrmenqSTG+YPQa/PSFn/LTF3/KJwc+4boz\nr+OGM29gzlFzOGHKCTgcioVfh2UBHZ76dT9vd79N2wdtPPves/zmld+w+vXV3LrgVu763FkUhIkz\nbKyuprO1NSkbhSOXjAoD+J/uQ/cVB/zdCDTGypNNOJxOCl0uXlqxgisbGmJnyCI6Zd4deg2DcSFx\ng7lVVWysrqa3d5kZHF6zIan4wicHPuHnL/2ce5+/F6PX4JrTruGei+9hzlFzgtKFG/2co3I4Zeop\nnDL1FK478zruuvAu/v3pf+cnL/yEBxeO4/vNB/jnni5y88z+GIbPhyAkQ3pm/RIG0GsY5BYUxE6Y\nJfQaBuuqquiVFcHo7e6mpbZ2QMV6wDC9m0c7rPhCgm6kF99/kdm/nM3313+fC068AG+ll8YljQNE\nAeKbL+n4Kcfz66t+zZZvbeE8xxnc4e5n9v2n89ftfwWgw+NhRmlpQjYKAmRBi2Ek0uExwx4La2oA\n6PR6/ZVMR1MT86qq/C6mDo+HZ6qrKSwpoai0lG2rVlFUWsq8ysq48uU5ncyrqvKfB+CUsjI6vV56\nu7vpaGoKarX0GgYvrVjB0fPns7OlhRmlpRS53XR4PPR2d9Pp9bK5tpZxDoffpRQtTyTbN1uxl17D\nYGdLC6dWVFDocrGlvp7tDQ2UNzXFdS0Nn4+mqqqg9A8XF1Pe3ExumnsD2TicTm5sa8PhdPr3dTQ1\n4Vjghs0wqyv++ILh8/FMdTVvv7CR/h27+Pb4HPKmH8vsLxzL2dedHTHftGnwwQfx2Xtm4Zk8efM6\n1hcX8N2bFVc+ciU/nPI1/vVr9/GRtACFJBBhSAM7W1rYUm96t/Zbboil7e3+4+uWLmXB8uXMLiuj\n0OXi4eJibt2zB4Ait5u5VVVsrqlhYU1NUGUUK9+C5cv94uBwOiksKeGX+fnkOZ3MLjOHjmxvaGBb\nY6N/++HiYsqbmnBYaVZasRD7OBAUL4mWJ5LtW+rryXM6KXKbYw8DK/AitzuhltT2xkbyAq6J4fNh\n+HxRRWGdJZSxWFhTE7GcwNhQr2HQ4fFw4n1tsBlO9G2IK75g+Hz8ubyM1m+fxi/P2MXXO07ni8Ys\nyv7056j51lVVMfctmLoD1kX5KEH25+dzycQzePGlo7nllqN45NHf8PcTe7l74vVRzyUI4RBhSANH\nz58fNWAb+HRrV56Gz+f/O7egAIfTSa7DQW5AhRQzX8gxezuwUstzOv3uoW2NjUHp7bQdHk+QMAQS\nK08423u7u/1uqSK32y8QdjmBZcWio6mJuQEVfYfHE1ReONLdA+eJ8nKWNDez9jXT7qmvbYgrvvCn\na66m8UrFUzv+yLLzlrHs+lv40+IvxDzforo6PMtg9S/gtw+YGhQX55/P+Ece4d9vrufx287krua7\n2Gu08eW+cXEWIAgmIgxDQK7DQYfHYz7pRnhaDg12xpsv3BNvpLQ91pO27eoCU9SiPX3HkyfU9iK3\nm0V1dWypq6PJcn8l6/rp8Hi4IsAV1tHURNEQ+s03VlezoLqaQpeLXU/DOHoZ/0rs8QsbNj3GG7vf\nZOO4MTx65aNUnFFBh8cTdy+1adPMoRKffgqTJsVp7AUXYNTVkWsY3FlxJ6dPP50f1Fbw5u5DbN6x\nmQXHLYizIOFIR4RhCGgoLeWU8nJ/q2Ld0qWDmi8Stksm8Ik70tO34fOx3zASymNjP9Xb6TZWV/Nq\nff0AF1UsOr1e8qzWSGDZC2tqglpOoaTDlQRma8mOpwDsec3LeaM+RsWILzS1N7H8l9dx5gm5PP+N\nZ5l39DwAttTV+ce7RGNdVRXjt8E1wNpKc26muOw//3w6gZ41a+js6eFo4I6PLmR779Pc9Y3z+MZ3\nf8ZXv/DPMc8vCCIMg0yn10uHxxMUPN1v9W4J9P2nK180ZpeVsXnFiqBKtdcw6PH5KHS5cDid9FjB\n7h6fjyK3m0KXK2qeSLbDYQE5taLC3+IwfD46vd647O/weAaIwn7DwOF0sq2xMaIwpMOVZAfji9xu\neg2D3u5u+tpWcdn4CfCpwjjhBHrCuLWa2pu48tErOft0J+7OQr8o2Nckns+9qK6O/U/AbRuh+rsJ\nLPUwYwazjzsORo8GS4THORwcfL+Tpysmc9Pmf2XMCYWUzymP/0IIRySj7r777kzbMKjU19ffXTkI\nA7YMn49XV65ke0MDhs9H3/79HBdm+uVJxxzDJx9+SNcbb/DJhx/y6QcfcNwFF7C9oYGji4vZbxhs\n/tGP2PHcc6icHKbOmcPo3Ny48j1/993s2LSJ0RMmMHXOHDb97//NB5s20btnD1PnzGFbQwPe//5v\nenw+HDNnmsHjigrafvYz9vf00LV1qykAl17qt7XT66XrjTc49NlnHF1sDieJlKfT6w1r++7XX6d3\nzx563nmHrq1b6Wxr87cWtjU0sPWhh5hz000xr/H6224jt6CAQ7297N+zx+8iO7R/Pw6nk0nHHJOu\nrzOIXsPgt3Pm4PvrX9lcU8Pmmhq8P/85+0Yfw2W9WznujAJeHT+e9bfdxjl33unPt659HVc9ehWn\nTD2FNd/eyPj+MXS2tdHzzjsY7e1cZPVSi4c9e+DBB+Hqq+Hkk+PMpBRs3QpPPAG3386WBx9ke0MD\ne7a+wQ3zbsSXv4+ftP2cOdPncPr00xO8KsJI4J577vnw7rvvjj0OTGs9ol/FxcVaGJ7cC5k2IYiL\nz/1M788Zp/X3vqe11vrdpib/sbVvr9W5/5Wr594/V+/6dFfK53r7ba1B69/9LsGMf/qTmXH9+gGH\n9vbu1ec9eJ4e/R+j9Z+2/illG4XhB9Cq46g3ZYCbkJUkEqgdKo57/yXG9h+OL/Rarr117eu48pEr\nmT11Ns03NTNtwrQopcRHQlNvB+J2m0uNPvnkgEOTx03mqeufouTYEpY0LuEv2/6Ssp3CyESEQchK\nDJ8vqJtqNnDG7g30Y45fsGMutiicOu3UtIkCwJQpZv0e12I9gUyeDBddFFYYAKaMm8Ka69fgOsZF\n2eoy/yhpQQhEhEHISuZVVmbVZH4HD8KC3o3sPMYcv+BwOtk+9VOuevQqvyhMnZC+NaOUCj9fUlxc\nfjm8+SZEmCspLzePtTesZd7R87hm9TU89dZTqRkrjDhEGAQhDro/6OVzvMBHp10MwKudr3LFI1dQ\nlFeE5yZPWkXBJp75ksJy+eXme4RWA4Aj18G6G9YxZ/ocrll9Dc//4/nkjBRGJCIMghAHnz69mfH0\n8nHJxfj2+Fj8+8VMGjuJdTeuS5v7KJTp05NsMZx8svmKIgwA+ePzWXPDGo6fcjxf+uOXeP2j15Mz\nVBhxiDAIQhyojWZ8oWvBbBY9vIgDfQdYd+M6TswbvBUCk3Ylgdlq2LDBHDodhaMmHsXaG9aSOzqX\nxb9fzHs97yV5QmEkIcIgCHEwsWUDz46by/J/VPDhJx/y5FefHPSxAEm7ksAUhv37obk5ZtKT8k9i\nzQ1r+OTAJyx6eBG79yV7UmGkIMIgCLH4+GMmvL2Jb17bxdt7X+OxJY9x7vHnDvppp00zB7odPJhE\n5oULzUmW/va3uJLPLZzLE9c9QUdPB1/8wxf55MAnSZxUGCmIMAhCDA49/hg3XX2A9pPe58Erf8cX\nZsWeITUdTJ9uvie1dtLYsVBaasYZdHzLnl9YdCGrylbh/dDLNauv4UDfgSROLIwERBgEIQpaa771\n0r/x+Gkw/umfcdNZXx2yc9vCkFKc4f334e9/jzvLlbOvZOUVK1nXvo6b/9/N9Ov+JE8uDGcyLgxK\nqTKllFspFXbqzXDHlVI11nv2dHQXRiR3PfEvPHjU+5S/fh7H7fiXIT130qOfbb74RfM9Ru+kUL5+\n9tepcdfw6GuPcttTt6HjbHEII4eMCoNSygWgtfYAhr0dx/FKpVQ7IKudC4PGfc/fx49e/gXfaoHJ\n7z3gf4IfKuzzJR2APuYYcLkSFgaAZecv447z7uB/Wv6Hezbek6QBwnAl0y2GCsCw/vYBoRP9Rzq+\nVGs90xIMQUg7v3vld9zedDtLdk7ll++dQetnZ/qf4IeKlFsMYLqTXngBuroSzlrjruEbZ32Dezbe\nwy9e+kUKRgjDjUwLgwMIDK2FDh+NdNwZzf0kCKnwxLYn+OZfvon7mPN5aGUXo756Pbt3M+QthqnW\n3Z50iwFMYejvh7VrE86qlKLuijquPvVqbltzG3949Q8pGCIMJzItDEmhta61WgtTlVIDlhNTSlUq\npVqVUq27UnrcEo40nul4hiWNS3Ad4+LxXZcyrg/2f+U6du2Co44aWlvGjDHF4f33Uyhk/nxT0ZJw\nJwGMzhnNI9c8wsUzLuZrf/4aT25PrhxheJFpYTAAe4FiBxDa3h1w3Kr07WWwuoABy3hpreu11iVa\n65LpQ/2YJwxbNu/YzBWPXMEMxwz+9tUnmfTHRrjgAl78sIiDB+HcwR+6MIBzzoFnnkmhgJwcuOwy\nWLMG+vqSKiJ3dC5/vvbPzCucR1lDGc+991wKBgnDgUwLwyoOV+xOwAOglHJEOd5qpwNmWtuCkBIt\nO1pY9PAipk2Yxrob1jGt/UNzNbSvfpX168369aKLht6uSy+Fbdtgx44UCrn8cnMwxIsvJl3ElHFT\neOr6pyjKK+KyP1zGpvc2pWCQkO1kVBi01l4Ayx1k2NtAc6Tj1r4lVquhPSCPICRF6wetlD5cSsH4\nAp6++WlOyDsB/vhHc+3k8nKam6G4GAKWnx4yLrnEfF+/PoVCFi2CUaPgL6ktzDN94nTW37yeYycf\nyxf+8AVpOYxg1Ejvo1xSUqJbW6VRIYTH+6GXSx+6FEeugw03b6DIUWQGa086Cc44g09WPUl+Ptx+\nO6xYMfT29febsY0rroDf/CaFgq6+Gp59Ft57DyZOTMmmDz7+gM//7vPs2LuDNTes4YITL0ipPGHo\nUEq1aa1LYqXLtCtJEDKG90Mv7ofc5I3L4+mbnzZFAeD5580K9Ktf5dln4dChw0/uQ01ODnz+8+Zc\neCk9w1VXm+6kX/0qZZuOnXwsG27ewPFTjucLv/8Cz3Y8m3KZQnYhwiAckbz84cu4H3Izedxknr75\naWY4Zhw++Mc/wvjxcNVVrF9vTjt0/vkZM5VLL4V//APa21Mo5HOfgwsvhPvuS3JWvmCOmXyM3+12\n2R8u45mOVCLkQrYhwiAccTz33nNc+tClTBo7iadvfpqT8k86fPDgQVi9Gq66CiZNYv16s06dMCFz\n9tqtlThm0I7OnXeaCvPIIynbBAPF4el3nk5LuULmEWEQjihWvbYK90Nupk+czoavbcCZH9LbuanJ\nHCX81a/S3Q0vv2w+sWeSk0+G445LMQANZrfVM8+EmhozeJEGjp50NBtu3sAMxwwW/34xv3/192kp\nV8gsIgzCEYHWmtpNtVz72LXMP24+z3/j+YGiAKYbKT8fFi9mwwbTr5+p+IKNUqY4rV+fYn2ulBlr\n2Lo16QFv4SicVMhzX3+O8088nxsfv5G7N9wtE+8Nc0QYhBHPof5DfOfJ71DtqWbJnCU03djE1Amh\ns69gDhZ4/HEoL4exY2luNjvwLFgw9DaHcskl5tQYr72WYkEVFTBjhtnFKo2Vd/74fNbesJavnfU1\n7tl4Dzf9v5vYf2h/2soXhhYRBmFE88mBT7j60at5oO0Blp23jEeueYTc0bnhE//rv5qjg++4AzCf\n0BcuNKemyDRpizOMHm32vX3hBXguveMQxo4ay6+v/DU/vOSH/P7V31P6cCld+xKfvE/IPCIMwojl\nra63WPibhTz19lPcf/n91JTWkKMi3PJ/+xs0NsIPfgCzZrFjB7z5ZubjCzYnnGDGGlKOMwB8/evm\n1K01NWkoLBilFHddeBePXPMIm3ds5twHz2Xb7m1pP48wuIgwCCMOrTUPeh/k7Lqzedd4l79c+xe+\nVfKtyBn27YN//mc49VR/a+Fpq4NNpuMLgVx6KWzcaI6rSIkJE+Bf/sWMM7z6alpsC+XaM65l/c3r\nMXoNiuuLqW+rl7jDMEKEQRhRdO3roqyhjFueuIVzjj+HV7/9Kpefcnn0TD/8IbzzDtx/P4wbB5gu\nm4ICmDdvCIyOk0sugY8/hrQM5P+nf4JJk6C2Ng2Fhee8E87j5aqXOe+E86j6axVXPHIFOz/ZOWjn\nE9KHCIMwYmj2NTP3gbk8se0J7i29l6Ybmzh+yvHRM23dCvfeCzfdBBdfDJgx2fXrzRHHOVn0C/n8\n5833lOMMYPa8qqqCRx+Fd99NQ4HhOX7K8ay5YQ0//8LPaX6nmTP+7xk8/sbjg3Y+IT1k0W0vCMmx\nd/9e/tfa/0Xpw6VMGTeFl255idvPuz1yPMFGa/jWt8wn53vv9e9ubzdnxMiW+ILNtGlmCyYtwgDw\n3e+aynfHHWkb1xCOHJXDrefcirfSywzHDL6y+it8/c9fZ+/+vYN2TiE1RBiEYcvBvoP8z+b/YdbP\nZ/GTF39CVXEVbZVtnH3M2fEV8LvfmRPL1dYGrcJjB3izKb5gc8kl5lROn32WhsKOOw7+8z/NoPt3\nv5vW7qvhOG36abzwzRf4t4X/xkNbHuLkX5zML176BQf6DgzqeYUk0FqP6FdxcbEWRhb9/f36sa2P\n6ZN/frLmbvTFv71Yt+xoSayQ3bu1njpV6/PO07qvL+jQkiVaH3ec1v39aTQ6Tfz1r1qD1h5Pmgrs\n79f6u981C/3P/0xTobFp2dGiL/7txZq70TN+NkM/vOVh3dffFzujkBJAq46j3pQWgzBs0Frz3HvP\nccFvLuCa1dcwZtQY/nrdX1l/03pKjo05k3BgQWZf/p4eeOCBoEBCf7/ZI+mSS8yBwtnGhReaSyuk\npdsqmB/yxz+GG2+Ef/s383oMASXHlrD+pvWsuX4N+bn53Pj4jZxddzZPbn9Sei9lASIMQtazd/9e\nHmh9AFe9iwt/cyHv7HmHlVesZMu3tnD5KZejEqnB9+6F666D3/7WFIczzww6/NprsGtX9sUXbKZM\nMUdipy3OAKYwPvggfOlL8J3vmJMIDgFKKRbPWkxrZSuPXvMo+w7u40uPfImSlSXc33I/Rq8xJHYI\nAxFhELKW1g9aWfqXpRx737F8+8lvo7Xm/37x//LWrW9xi+sWRueMTqzAV14xl2JrbDSnhPjhDwck\nyeb4gs0ll0BLi9ngSRtjxpiCcP75cMMN5mSCQ0SOyqHijAq2fmcrdV+qM6cw+dt3OOa+Y7jx8RvZ\n+O5GaUUMMbKCm5A1HOw7yAvvv8Dat9fy17f+yqudrzJhzASunXMtVSVVzD92fmKtAxutob7eHNQ1\ndarZRfPCC8MmveIKc43l7dtT/DCDiO3q+stfTHvTimGYi1u3t8Njj5nLgg6xT01rTduHbTzofZA/\nvvZH9u7fy6yCWVw751pKZ5Zy7vHnMnbU2CG1aaQQ7wpuGRcGa+1mA3BprQeMtgl3PFaeQEQYshet\nNb49Pjw+D2va19Dsa+bjAx8zSo3icyd8juvOuI7rz7yevNy85E/y8cdmf/1HHoHFi+Hhh2H69AHJ\nDhwwx7fdeSfcfPOQudqTorfXHIZw6qmmneeck+YTfPihOUnU22+bfqs77oAvf9kMbgwx+w7uo3Fr\nI79++dc8+96z9Ot+Jo6ZyMUzLqbUWYrb6eb06acn98BwBDIshEEp5QKcWutGpVQlZsTcG+24dShi\nnlBEGLKDzw5+xuu7XmfLzi1s6dzCKztf4dXOV+nZb/pDivKKWDxzMYtnLebSky5NTQz274dnnjHn\nP3rsMXPW1P/4D1i+fMCINa3NJ+877oC33gK321xb+fgY4+IyTUMD3HordHaaIZMVK6CoKI0n2LfP\n7M77k5+YAuF0wve+B1/7WsprRieL0Wvw9DtP4/F5aPI18Vb3WwA4ch3MLZzLmUedyZlHncncwrmc\ncdQZTB43OSN2ZjPDRdemH/kAAAkhSURBVBhqgCattUcp5SakBRDuODA1Wp5QRBgGD601nx78lO7P\nuv2vrn1d7Ph4B+/1vBf06vy0059v4piJzDt6HvMKzddFMy5i9tTZyT/17dsH779v+lj+9jczMvvp\np+b0FhdfDHfdZT4Bh+D1mnXdxo1w2mlm55zLLsvO3kjh+PhjcwjGj39sCtz3vme2eKZMSeNJ+vrg\nz382BwC++KI5T8iXvmResNNOM5stTmdGpqDtMDrw+Dy0fNDC3z/6O3/v/DsfH/jYf/yYScdw/JTj\nOSHvBI6ffLz/78KJheSPzyc/N5/88flMHjv5iGlxDBdhqAPqtNZeq5Iv1VpXRzsOOKLlCSUZYXi9\n9TV+8+sVyXykuEn0quuAHDokt1baX6YO+V8rjUbTb+XpR9Ov+umnnz7rvV9p+unnkOrjkOrjoDrE\nIfqs7UP05hxgvzpAb84BegPePxm1j0OqL6y9uf1jOepgAYWHCjjqUD5HHcznpAPHMHP/8Rx3YCo5\ndr8HrVFo8133B2z3k9N3kFGHDpDTd4BRB/czqu8AOYf2k/vJbibs3cmEnp2M/7iTsb2HK4OPC4ro\nOONyOuZ8kQ9mf56DYybQ22tqx759pl7s2wc7d5pzyE2dajYmli41Z6QejvzjH/D975tesqOOMj1m\nEyeac+XZ7xMmBNfdgfVgvHViYfvznNn8U45uf56JPR/49/eNGsPe6bPYl3cMB8dNMl+5kzg0diIH\nx02ib/Q4dM4otMox33NG0Z8zCqyR6RoVZIiOaFB0QzWanaO78I37AN+4HXwwZhe7Rht8NLqbj8bs\n4bOc8OtDjNI5TOofz4S+8eTqsYzTY8jtH8tYPdZ6H81oPYpRjGKM9be5nUOOziHHeh+FIkfnoPz/\nQOkc893aDv4LlB74mVTA51RhPnP+5KP4Qc1Po16LSMQrDMP0pxAdy8VUCXDiiScmnP+VzS9yX+Ef\n021WVjKq33ppGNMHY/tgTL/5PvaQuW/CQZhyEI4+CBMPmtsTDkL+Z1AQ5nXcx5D/2QEUO4HUJ03r\nI4f9jOMAY9nPOLqYynsUspMSOilkJ0fTSSEvci5vdp8KzygIszb9mDGHK8uJE0330V13QV4KXqts\n4IQT4KGH4LbbzFnDn302WATT9+x3nvWCyezlVN7kVN7ktL43OHXnm0zfuYtJdDGJT8jnUybxCZP5\nJF0nT5m94+AfU+CjibBnPOzJtd/72TP+Uz4e+yn7xsBnY2Cf9do9BvaPhoM5cHAUHBh1+O9DOdCn\noH+I+3ae8tE4fkBywhAvmRYGAyiw/nYAoat6RDoeLQ9a63qgHswWQ6JGXXX9tWx5I4EBU0kS7mkg\n7vQq+KlC+Xcffl7JUTn+d1DkWMdGqVGMUqNizyWUJAeBj8J+gAiPqUqhVY65TykzDqAUevQY0x0U\nEvTMt16nxll8bu7AJ+aRSEkJrFkTvE9rM1j96aemV8jeF3g8OaYAC6xXeD4BPunvN+cJ7+9H9feZ\nRlgvu6UYZEgkg9KkbtOsVzrR2mxx9+k++nU/fbofsEYRYx6z/7Zb++a2lZ/wX0ioZ8BmzLjB75GV\naWFYBdg1sBPwACilHFprI9LxCPvSxqS8Scw996x0FysIQ45SMH68+coMOYB0LR1uZHSAm92byIoV\nGAG9i5ojHY+SRxAEQUgDmW4x2G6f0H3FMY4P2CcIgiCkB5kSQxAEQQhChEEQBEEIQoRBEARBCEKE\nQRAEQQhChEEQBEEIIuOzqw42SqldQEeS2acBu9NoTqpkmz0gNsWL2BSbbLMHRp5NRVrrgdMLhzDi\nhSEVlFKt8cwrMlRkmz0gNsWL2BSbbLMHjlybxJUkCIIgBCHCIAiCIAQhwhCdbBthnW32gNgUL2JT\nbLLNHjhCbZIYgyAIGUMp5QpZtTHuZXuH0KYarXW1UqrySJmOR1oMwwxrudPA7RrrvTIzFoW1qUwp\n5VZKLcuUTdlCNl6LbLhnrPO7gYaAbReA1toDGKH3VSZssqhUSrUDvqG2B8zvyXrVBOwb1PtKhCEK\nmfhCYtiTjTdt1v24A8lkJZht1yKAjN4zNtZ1CbShArO1gLXfnQU2ASzVWs+0jg0p1u/LY7VUnFbd\nM+j3lQhDBDL1hUQj227aCDZl/McdQiYrwWy7FjYZvWei4AC6A7anZsqQEJyZehjEXHPGvm981vag\n31ciDJHJyBeSBJm8acORbT/uTFaC2XYtbLLtnslqtNa11v0z1XpgHMpz1wfENVxAK0NwX4kwRCBT\nX0iiZPKmHSZIJRhCFt8zsZb6HXIsV3KZtdmF+YCYCTtcgFcP0cJkGV+oJ9sJ/EKUSmyN5iTOFc4P\n7ov0tGul79ZaNzJIN22iNpFlP267Z4tSqlQp5R7ilkNWXQsYmnsmBSIt5ZtJWjnshpwJ1GXIDrfW\nutr6e9DvqyNaGOKs9IbsC0miK9yg37RJ2DSkP+5o32EWVIJS0UXBehIvUUqVaa0brYevkkwu2xvB\npkqlVDfQniGbKgMecNwMwX0l4xiiENhv2fpCuoESrXW95ZrwDOWNYt20KzH95o22jZZdzkz0+45i\nk8+yKWP9vq3Wnk9rbSil6oC6of5hZ8u1CCTT94wQPwG9/roxH0rLAx56Bu2+EmGIQKa+ECG9SCUo\nCIkjwiAIgiAEIb2SBEEQhCBEGARBEIQgRBgEQRCEIEQYBEEQhCBEGARBEIQgRBgEQRCEIEQYBEEQ\nhCBEGARBEIQgRBgEQRCEII7oSfQEYbBQStnreTiAmVrrKmt+LQMo1VqXZ9RAQYiCTIkhCGlGKeUA\nlgRMwNhkHSrHFIsGIF9rbUQoQhAyiriSBCH9LAmZYLEAc00Pw5qBdqaIgpDNSItBENKMUsoRWPEr\npTSm+ygb1mMQhJiIMAjCIGJN396ktR7c5f8EIY2IK0kQBpdSYMhX/RKEVBBhEIQ0Y/VIsnFjLqdp\nH3NYrQhByFpEGAQhjViVfrtSymktLQpmF1WbSok1CNmOxBgEIY1YrYVqoM3atRqoCdyWHklCtiPC\nIAiCIAQhriRBEAQhCBEGQRAEIQgRBkEQBCEIEQZBEAQhCBEGQRAEIQgRBkEQBCEIEQZBEAQhCBEG\nQRAEIQgRBkEQBCEIEQZBEAQhiP8PJl0WhHyBYiMAAAAASUVORK5CYII=\n", + "text/plain": [ + "" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "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", + "\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", + "\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{11}\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", + "\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 \\frac{1}{N}\\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", + "\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\\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", + "\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", + "\n", + "With a PDF we can compute expectation values of selected quantities such as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\langle x^k\\rangle=\\frac{1}{N}\\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", + "\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", + "\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", + "\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{_auto9} \\tag{12}\n", + "\\end{equation}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Probability Distribution Functions, the cumulative distribution\n", + "\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", + "\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", + "## Probability Distribution Functions, the binomial distribution\n", + "\n", + "\n", + "In order to compute the mean and variance we need to recall Newton's binomial\n", + "formula" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "(a+b)^m=\\sum_{n=0}^m \\left(\\begin{array}{c} m \\\\ n\\end{array}\\right)a^nb^{m-n},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "which can be used to show that" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\sum_{x=0}^n\\left(\\begin{array}{c} n \\\\ x\\end{array}\\right)y^x(1-y)^{n-x} = (y+1-y)^n = 1,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "the PDF is normalized to one. \n", + "The mean value is" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mu = \\sum_{x=0}^n x\\left(\\begin{array}{c} n \\\\ x\\end{array}\\right)y^x(1-y)^{n-x} =\n", + "\\sum_{x=0}^n x\\frac{n!}{x!(n-x)!}y^x(1-y)^{n-x},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "resulting in" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mu = \n", + "\\sum_{x=0}^n x\\frac{(n-1)!}{(x-1)!(n-1-(x-1))!}y^{x-1}(1-y)^{n-1-(x-1)},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "which we rewrite as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mu=ny\\sum_{\\nu=0}^n\\left(\\begin{array}{c} n-1 \\\\ \\nu\\end{array}\\right)y^{\\nu}(1-y)^{n-1-\\nu} =ny(y+1-y)^{n-1}=ny.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "The variance is slightly trickier to get. It reads $\\sigma^2=ny(1-y)$. \n", + "\n", + "\n", + "## Probability Distribution Functions, Poisson's distribution\n", + "\n", + "\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", + "\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", + "\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{_auto10} \\tag{13}\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{14}\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", + "\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", + "## Meet the covariance, uncorrelated events\n", + "\n", + "\n", + "This is easy to show, keeping in mind the linearity of\n", + "the expectation value. Consider the stochastic variables $X_i$ and\n", + "$X_j$, ($i\\neq j$)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\begin{align*}\n", + "\\mathrm{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, we get" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\langle x_i x_j\\rangle =\n", + "\\langle x_i\\rangle\\langle x_j\\rangle=\\mathrm{Cov}(X_i, X_j) = 0\\ \\ (i\\neq j).\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Numerical experiments and the covariance\n", + "\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", + "\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", + "\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", + "\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{15}\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{16}\n", + "\\end{equation}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Numerical experiments and the covariance, the sample variance\n", + "\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{17}\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", + "\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", + "\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. ([eq:exptvariance](#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{18}\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", + "\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{19}\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{20}\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", + "\n", + "From the point of view of\n", + "Eq. ([eq:error_estimate_corr_time](#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", + "# Random Numbers\n", + "\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", + "\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", + "# Random number generator RNG\n", + "\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", + "\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", + "\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", + "\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{21}\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{22}\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", + "\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", + "\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", + "\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{23}\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", + "\n", + "We can now rewrite Eq. ([eq:rntrick1](#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{24}\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{25}\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{26}\n", + "\\end{equation}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# Random number generator RNG, RAN0\n", + "\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", + "\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", + "\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", + "\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", + "\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": 8, + "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", + "\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. ([eq:autocorrelformal](#eq:autocorrelformal)).\n", + "We rewrite it here as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "C_k=\\frac{f_d}\n", + " {\\sigma^2},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "with $C_0=1$. Recall that \n", + "$\\sigma^2=\\langle x_i^2\\rangle-\\langle x_i\\rangle^2$ and that" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "f_d = \\frac{1}{nm}\\sum_{\\alpha=1}^m\\sum_{k=1}^{n-d}(x_{\\alpha,k}-\\langle X_m \\rangle)(x_{\\alpha,k+d}-\\langle X_m \\rangle),\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "The non-vanishing of $C_k$ for $k\\ne 0$ means that the random\n", + "numbers are not independent. The independence of the random numbers is crucial \n", + "in the evaluation of other expectation values. If they are not independent, our\n", + "assumption for approximating $\\sigma_N$ is no longer valid.\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "## Correlation function and which random number generators should I use\n", + "\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": [ + "## Correlation function and which random number generators should I use\n", + "\n", + "The following Python code plots the results for the correlation function from the above program." + ] + }, + { + "cell_type": "code", + "execution_count": 9, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "import numpy as np\n", + "from matplotlib import pyplot as plt\n", + "# Load in data file\n", + "data = np.loadtxt(\"datafiles/autocor.dat\")\n", + "# Make arrays containing x-axis and binding energies as function of A\n", + "x = data[:,0]\n", + "corr = data[:,1]\n", + "plt.plot(x, corr ,'ro')\n", + "plt.axis([0,1000,-0.2, 1.1])\n", + "plt.xlabel(r'$d$')\n", + "plt.ylabel(r'$C_d$')\n", + "plt.title(r'autocorrelation function for RNG')\n", + "plt.savefig('autocorr.pdf')\n", + "plt.show()" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# Which RNG should I use?\n", + "\n", + "* In the library files lib.cpp and lib.h we have included four popular RNGs taken from the widely used textbook [Numerical Recipes](http://numerical.recipes/). These are called ran0, ran1, ran2 and ran3.\n", + "\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", + "## How to use the Mersenne generator\n", + "\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", + " * Monte Carlo simulations can be treated as *computer experiments*\n", + "\n", + " * The results can be analysed with the same statistical tools as we would use analysing experimental data.\n", + "\n", + " * As in all experiments, we are looking for expectation values and an estimate of how accurate they are, i.e., possible sources for errors.\n", + "\n", + "A very good article which explains blocking is H. Flyvbjerg and H. G. Petersen, *Error estimates on averages of correlated data*, [Journal of Chemical Physics 91, 461-466 (1989)](http://scitation.aip.org/content/aip/journal/jcp/91/1/10.1063/1.457480).\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "## Why blocking?\n", + " Statistical analysis\n", + " * 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", + "## 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", + " * 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", + " * 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", + "## What is blocking?\n", + " Blocking\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", + "## Implementation\n", + "\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", + "## 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": 10, + "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": [ + "## 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" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# Regression analysis, overarching aims\n", + "\n", + "\n", + "Regression modeling deals with the description of the sampling distribution of a given random variable $y$ varies as function of another variable or a set of such variables $\\hat{x} =[x_0, x_1,\\dots, x_p]^T$. \n", + "The first variable is called the **dependent**, the **outcome** or the **response** variable while the set of variables $\\hat{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(y\\vert \\hat{x})$, that is the conditional distribution for $y$ with a given $\\hat{x}$. The estimation of $p(y\\vert \\hat{x})$ is made using a data set with \n", + "* $n$ cases $i = 0, 1, 2, \\dots, n-1$ \n", + "\n", + "* Response (dependent or outcome) variable $y_i$ with $i = 0, 1, 2, \\dots, n-1$ \n", + "\n", + "* $p$ Explanatory (independent or predictor) variables $\\hat{x}_i=[x_{i0}, x_{i1}, \\dots, x_{ip}]$ with $i = 0, 1, 2, \\dots, n-1$ \n", + "\n", + " The goal of the regression analysis is to extract/exploit relationship between $y_i$ and $\\hat{x}_i$ in or to infer causal dependencies, approximations to the likelihood functions, functional relationships and to make predictions .\n", + "\n", + "\n", + "\n", + "\n", + "## General linear models\n", + "\n", + "Before we proceed let us study a case from linear algebra where we aim at fitting a set of data $\\hat{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 $\\hat{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_i 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", + "\n", + "## Rewriting the fitting procedure as a linear algebra problem\n", + "\n", + "For every set of values $y_i,x_i$ we have thus the corresponding set of equations" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\begin{align*}\n", + "y_0&=\\beta_0+\\beta_1x_0^1+\\beta_2x_0^2+\\dots+\\beta_{n-1}x_0^{n-1}+\\epsilon_0\\\\\n", + "y_1&=\\beta_0+\\beta_1x_1^1+\\beta_2x_1^2+\\dots+\\beta_{n-1}x_1^{n-1}+\\epsilon_1\\\\\n", + "y_2&=\\beta_0+\\beta_1x_2^1+\\beta_2x_2^2+\\dots+\\beta_{n-1}x_2^{n-1}+\\epsilon_2\\\\\n", + "\\dots & \\dots \\\\\n", + "y_{n-1}&=\\beta_0+\\beta_1x_{n-1}^1+\\beta_2x_{n-1}^2+\\dots+\\beta_1x_{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, follows\n", + "\n", + "Defining the vectors" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "2\n", + "2\n", + "9\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", + "3\n", + "0\n", + " \n", + "<\n", + "<\n", + "<\n", + "!\n", + "!\n", + "M\n", + "A\n", + "T\n", + "H\n", + "_\n", + "B\n", + "L\n", + "O\n", + "C\n", + "K" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{\\epsilon} = [\\epsilon_0,\\epsilon_1, \\epsilon_2,\\dots, \\epsilon_{n-1}]^T,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and the matrix" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{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", + "\\hat{y} = \\hat{X}\\hat{\\beta}+\\hat{\\epsilon}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Generalizing the fitting procedure as a linear algebra problem\n", + "\n", + "We are obviously not limited to the above polynomial. We could replace the various powers of $x$ with elements of Fourier series, that is, instead of $x_i^j$ we could have $\\cos{(j x_i)}$ or $\\sin{(j x_i)}$, or time series or other orthogonal functions.\n", + "For every set 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_1x_{n-1,n-1}+\\epsilon_{n-1}.\\\\\n", + "\\end{align*}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Generalizing the fitting procedure as a linear algebra problem\n", + "\n", + "We redefine in turn the matrix $\\hat{X}$ as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{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", + "\\hat{y} = \\hat{X}\\hat{\\beta}+\\hat{\\epsilon}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "The left-hand side of this equation forms know. Our error vector $\\hat{\\epsilon}$ and the parameter vector $\\hat{\\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", + "\n", + "We have defined the matrix $\\hat{X}$" + ] + }, + { + "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_1x_{n-1,n-1}+\\epsilon_{n-1}.\\\\\n", + "\\end{align*}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Optimizing our parameters, more details\n", + "\n", + "We well use this matrix to define the approximation $\\hat{\\tilde{y}}$ via the unknown quantity $\\hat{\\beta}$ as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{\\tilde{y}}= \\hat{X}\\hat{\\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 parametrized values $\\tilde{y}_i$, namely" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "Q(\\hat{\\beta})=\\sum_{i=0}^{n-1}\\left(y_i-\\tilde{y}_i\\right)^2=\\left(\\hat{y}-\\hat{\\tilde{y}}\\right)^T\\left(\\hat{y}-\\hat{\\tilde{y}}\\right),\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "or using the matrix $\\hat{X}$ as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "Q(\\hat{\\beta})=\\left(\\hat{y}-\\hat{X}\\hat{\\beta}\\right)^T\\left(\\hat{y}-\\hat{X}\\hat{\\beta}\\right).\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Interpretations and optimizing our parameters\n", + "\n", + "The function" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "Q(\\hat{\\beta})=\\left(\\hat{y}-\\hat{X}\\hat{\\beta}\\right)^T\\left(\\hat{y}-\\hat{X}\\hat{\\beta}\\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 of for example a numerical experiment. When linking 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 till now we have treated $y_i$ as the exact value. Normally, the response (dependent or outcome) variable $y_i$ the outcome of a numerical experiment or another type of experiment and is thus only an approximation to the true value. It is then always accompanied by an error estimate, often limited to a statistical error estimate given by the standard deviation discussed earlier. In the discussion here we will treat $y_i$ as our exact value for the response variable.\n", + "\n", + "In order to find the parameters $\\beta_i$ we will then minimize the spread of $Q(\\hat{\\beta})$ by requiring" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{\\partial Q(\\hat{\\beta})}{\\partial \\beta_j} = \\frac{\\partial }{\\partial \\beta_j}\\left[ \\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 Q(\\hat{\\beta})}{\\partial \\beta_j} = -2\\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 Q(\\hat{\\beta})}{\\partial \\hat{\\beta}} = 0 = \\hat{X}^T\\left( \\hat{y}-\\hat{X}\\hat{\\beta}\\right).\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Interpretations and optimizing our parameters\n", + "\n", + "We can rewrite" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{\\partial Q(\\hat{\\beta})}{\\partial \\hat{\\beta}} = 0 = \\hat{X}^T\\left( \\hat{y}-\\hat{X}\\hat{\\beta}\\right),\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{X}^T\\hat{y} = \\hat{X}^T\\hat{X}\\hat{\\beta},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and if the matrix $\\hat{X}^T\\hat{X}$ is invertible we have the solution" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{\\beta} =\\left(\\hat{X}^T\\hat{X}\\right)^{-1}\\hat{X}^T\\hat{y}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Interpretations and optimizing our parameters\n", + "\n", + "The residuals $\\hat{\\epsilon}$ are in turn given by" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{\\epsilon} = \\hat{y}-\\hat{\\tilde{y}} = \\hat{y}-\\hat{X}\\hat{\\beta},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and with" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{X}^T\\left( \\hat{y}-\\hat{X}\\hat{\\beta}\\right)= 0,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "we have" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{X}^T\\hat{\\epsilon}=\\hat{X}^T\\left( \\hat{y}-\\hat{X}\\hat{\\beta}\\right)= 0,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "meaning that the solution for $\\hat{\\beta}$ is the one which minimizes the residuals. Later we will link this with the maximum likelihood approach.\n", + "\n", + "\n", + "\n", + "\n", + "## The $\\chi^2$ function\n", + "\n", + "\n", + "Normally, the response (dependent or outcome) variable $y_i$ the outcome of a numerical experiment or another type of experiment and is thus only an approximation to the true value. It is then always accompanied by an error estimate, often limited to a statistical error estimate given by the standard deviation discussed earlier. In the discussion here we will treat $y_i$ as our exact value for the response variable.\n", + "\n", + "Introducing the standard deviation $\\sigma_i$ for each measurement $y_i$, we define now the $\\chi^2$ function as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\chi^2(\\hat{\\beta})=\\sum_{i=0}^{n-1}\\frac{\\left(y_i-\\tilde{y}_i\\right)^2}{\\sigma_i^2}=\\left(\\hat{y}-\\hat{\\tilde{y}}\\right)^T\\frac{1}{\\hat{\\Sigma^2}}\\left(\\hat{y}-\\hat{\\tilde{y}}\\right),\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "where the matrix $\\hat{\\Sigma}$ is a diagonal matrix with $\\sigma_i$ as matrix elements. \n", + "\n", + "\n", + "\n", + "\n", + "## The $\\chi^2$ function\n", + "\n", + "\n", + "In order to find the parameters $\\beta_i$ we will then minimize the spread of $\\chi^2(\\hat{\\beta})$ by requiring" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{\\partial \\chi^2(\\hat{\\beta})}{\\partial \\beta_j} = \\frac{\\partial }{\\partial \\beta_j}\\left[ \\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(\\hat{\\beta})}{\\partial \\beta_j} = -2\\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(\\hat{\\beta})}{\\partial \\hat{\\beta}} = 0 = \\hat{A}^T\\left( \\hat{b}-\\hat{A}\\hat{\\beta}\\right).\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "where we have defined the matrix $\\hat{A} =\\hat{X}/\\hat{\\Sigma}$ with matrix elements $a_{ij} = x_{ij}/\\sigma_i$ and the vector $\\hat{b}$ with elements $b_i = y_i/\\sigma_i$. \n", + "\n", + "\n", + "\n", + "## The $\\chi^2$ function\n", + "\n", + "\n", + "We can rewrite" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{\\partial \\chi^2(\\hat{\\beta})}{\\partial \\hat{\\beta}} = 0 = \\hat{A}^T\\left( \\hat{b}-\\hat{A}\\hat{\\beta}\\right),\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{A}^T\\hat{b} = \\hat{A}^T\\hat{A}\\hat{\\beta},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and if the matrix $\\hat{A}^T\\hat{A}$ is invertible we have the solution" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{\\beta} =\\left(\\hat{A}^T\\hat{A}\\right)^{-1}\\hat{A}^T\\hat{b}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## The $\\chi^2$ function\n", + "\n", + "\n", + "If we then introduce the matrix" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{H} = \\hat{A}^T\\hat{A},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "we have then the following expression for the parameters $\\beta_j$ (the matrix elements of $\\hat{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" + ] + }, + { + "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", + "\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(\\hat{\\beta})}{\\partial \\beta_0} = -2\\left[ \\sum_{i=0}^{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(\\hat{\\beta})}{\\partial \\beta_0} = -2\\left[ \\sum_{i=0}^{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", + "\n", + "We define then" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\gamma = \\sum_{i=0}^{1}\\frac{1}{\\sigma_i^2},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "2\n", + "6\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", + "6\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": [ + "2\n", + "6\n", + "9\n", + " \n", + "<\n", + "<\n", + "<\n", + "!\n", + "!\n", + "M\n", + "A\n", + "T\n", + "H\n", + "_\n", + "B\n", + "L\n", + "O\n", + "C\n", + "K" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\gamma_{xy} = \\sum_{i=0}^{1}\\frac{y_ix_{i}}{\\sigma_i^2},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and show that" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "2\n", + "7\n", + "1\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", + "\\beta_1 = \\frac{\\gamma_{xy}\\gamma-\\gamma_x\\gamma_y}{\\gamma\\gamma_{xx}-\\gamma_x^2}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "The LSM suffers often from both being underdetermined and overdetermined in the unknown coefficients $\\beta_i$. A better approach is to use the Singular Value Decomposition (SVD) method discussed below. \n", + "\n", + "\n", + "\n", + "\n", + "\n", + "## The singular value decompostion\n", + "\n", + "How can we use the singular value decomposition to find the parameters $\\beta_j$? More details will come. We first note that a general $m\\times n$ matrix $\\hat{A}$ can be written in terms of a diagonal matrix $\\hat{\\Sigma}$ of dimensionality $n\\times n$ and two orthognal matrices $\\hat{U}$ and $\\hat{V}$, where the first has dimensionality $m \\times n$ and the last dimensionality $n\\times n$. We have then" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{A} = \\hat{U}\\hat{\\Sigma}\\hat{V}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# Neural Networks\n", + "\n", + "## Artificial neurons\n", + "The field of artificial neural networks has a long history of development, and is closely connected with \n", + "the advancement of computer science and computers in general. A model of artificial neurons \n", + "was first developed by McCulloch and Pitts in 1943 to study signal processing in the brain and \n", + "has later been refined by others. The general idea is to mimic neural networks in the human brain, which\n", + "is composed of billions of neurons that communicate with each other by sending electrical signals. \n", + "Each neuron accumulates its incoming signals, \n", + "which must exceed an activation threshold to yield an output. If the threshold is not overcome, the neuron\n", + "remains inactive, i.e. has zero output. \n", + "\n", + "This behaviour has inspired a simple mathematical model for an artificial neuron." + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "\n", + "
\n", + "\n", + "$$\n", + "\\begin{equation}\n", + " y = f\\left(\\sum_{i=1}^n w_ix_i\\right) = f(u)\n", + "\\label{artificialNeuron} \\tag{27}\n", + "\\end{equation}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Here, the output $y$ of the neuron is the value of its activation function, which have as input\n", + "a weighted sum of signals $x_i, \\dots ,x_n$ received by $n$ other neurons.\n", + "\n", + "\n", + "## Neural network types\n", + "\n", + "An artificial neural network (NN), is a computational model that consists of layers of connected neurons, or *nodes*. \n", + "It is supposed to mimic a biological nervous system by letting each neuron interact with other neurons\n", + "by sending signals in the form of mathematical functions between layers. \n", + "A wide variety of different NNs have\n", + "been developed, but most of them consist of an input layer, an output layer and eventual layers in-between, called\n", + "*hidden layers*. All layers can contain an arbitrary number of nodes, and each connection between two nodes\n", + "is associated with a weight variable. \n", + "\n", + "\n", + "\n", + "\n", + "## Feed-forward neural networks\n", + "The feed-forward neural network (FFNN) was the first and simplest type of NN devised. In this network, \n", + "the information moves in only one direction: forward through the layers.\n", + "\n", + "Nodes are represented by circles, while the arrows display the connections between the nodes, including the \n", + "direction of information flow. Additionally, each arrow corresponds to a weight variable, not displayed here. \n", + "We observe that each node in a layer is connected to *all* nodes in the subsequent layer, \n", + "making this a so-called *fully-connected* FFNN. \n", + "\n", + "\n", + "\n", + "A different variant of FFNNs are *convolutional neural networks* (CNNs), which have a connectivity pattern\n", + "inspired by the animal visual cortex. Individual neurons in the visual cortex only respond to stimuli from\n", + "small sub-regions of the visual field, called a receptive field. This makes the neurons well-suited to exploit the strong\n", + "spatially local correlation present in natural images. The response of each neuron can be approximated mathematically \n", + "as a convolution operation. \n", + "\n", + "CNNs emulate the behaviour of neurons in the visual cortex by enforcing a *local* connectivity pattern\n", + "between nodes of adjacent layers: Each node\n", + "in a convolutional layer is connected only to a subset of the nodes in the previous layer, \n", + "in contrast to the fully-connected FFNN.\n", + "Often, CNNs \n", + "consist of several convolutional layers that learn local features of the input, with a fully-connected layer at the end, \n", + "which gathers all the local data and produces the outputs. They have wide applications in image and video recognition\n", + "\n", + "\n", + "## Recurrent neural networks\n", + "\n", + "So far we have only mentioned NNs where information flows in one direction: forward. *Recurrent neural networks* on\n", + "the other hand, have connections between nodes that form directed *cycles*. This creates a form of \n", + "internal memory which are able to capture information on what has been calculated before; the output is dependent \n", + "on the previous computations. Recurrent NNs make use of sequential information by performing the same task for \n", + "every element in a sequence, where each element depends on previous elements. An example of such information is \n", + "sentences, making recurrent NNs especially well-suited for handwriting and speech recognition.\n", + "\n", + "\n", + "## Other types of networks\n", + "\n", + "There are many other kinds of NNs that have been developed. One type that is specifically designed for interpolation\n", + "in multidimensional space is the radial basis function (RBF) network. RBFs are typically made up of three layers: \n", + "an input layer, a hidden layer with non-linear radial symmetric activation functions and a linear output layer (''linear'' here\n", + "means that each node in the output layer has a linear activation function). The layers are normally fully-connected and \n", + "there are no cycles, thus RBFs can be viewed as a type of fully-connected FFNN. They are however usually treated as\n", + "a separate type of NN due the unusual activation functions.\n", + "\n", + "\n", + "Other types of NNs could also be mentioned, but are outside the scope of this work. We will now move on to a detailed description\n", + "of how a fully-connected FFNN works, and how it can be used to interpolate data sets. \n", + "\n", + "\n", + "## Multilayer perceptrons\n", + "\n", + "One use often so-called fully-connected feed-forward neural networks with three\n", + "or more layers (an input layer, one or more hidden layers and an output layer)\n", + "consisting of neurons that have non-linear activation functions.\n", + "\n", + "Such networks are often called *multilayer perceptrons* (MLPs)\n", + "\n", + "\n", + "## Why multilayer perceptrons?\n", + "\n", + "According to the *Universal approximation theorem*, a feed-forward neural network with just a single hidden layer containing \n", + "a finite number of neurons can approximate a continuous multidimensional function to arbitrary accuracy, \n", + "assuming the activation function for the hidden layer is a **non-constant, bounded and monotonically-increasing continuous function**.\n", + "Note that the requirements on the activation function only applies to the hidden layer, the output nodes are always\n", + "assumed to be linear, so as to not restrict the range of output values. \n", + "\n", + "We note that this theorem is only applicable to a NN with *one* hidden layer. \n", + "Therefore, we can easily construct an NN \n", + "that employs activation functions which do not satisfy the above requirements, as long as we have at least one layer\n", + "with activation functions that *do*. Furthermore, although the universal approximation theorem\n", + "lays the theoretical foundation for regression with neural networks, it does not say anything about how things work in practice: \n", + "A neural network can still be able to approximate a given function reasonably well without having the flexibility to fit *all other*\n", + "functions. \n", + "\n", + "\n", + "\n", + "\n", + "## Mathematical model" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "\n", + "
\n", + "\n", + "$$\n", + "\\begin{equation}\n", + " y = f\\left(\\sum_{i=1}^n w_ix_i + b_i\\right) = f(u)\n", + "\\label{artificialNeuron2} \\tag{28}\n", + "\\end{equation}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "In an FFNN of such neurons, the *inputs* $x_i$\n", + "are the *outputs* of the neurons in the preceding layer. Furthermore, an MLP is fully-connected, \n", + "which means that each neuron receives a weighted sum of the outputs of *all* neurons in the previous layer. \n", + "\n", + "\n", + "## Mathematical model\n", + "\n", + "First, for each node $i$ in the first hidden layer, we calculate a weighted sum $u_i^1$ of the input coordinates $x_j$," + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "\n", + "
\n", + "\n", + "$$\n", + "\\begin{equation}\n", + " u_i^1 = \\sum_{j=1}^2 w_{ij}^1 x_j + b_i^1 \n", + "\\label{_auto11} \\tag{29}\n", + "\\end{equation}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "This value is the argument to the activation function $f_1$ of each neuron $i$,\n", + "producing the output $y_i^1$ of all neurons in layer 1," + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "\n", + "
\n", + "\n", + "$$\n", + "\\begin{equation}\n", + " y_i^1 = f_1(u_i^1) = f_1\\left(\\sum_{j=1}^2 w_{ij}^1 x_j + b_i^1\\right)\n", + "\\label{outputLayer1} \\tag{30}\n", + "\\end{equation}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "where we assume that all nodes in the same layer have identical activation functions, hence the notation $f_l$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "\n", + "
\n", + "\n", + "$$\n", + "\\begin{equation}\n", + " y_i^l = f_l(u_i^l) = f_l\\left(\\sum_{j=1}^{N_{l-1}} w_{ij}^l y_j^{l-1} + b_i^l\\right)\n", + "\\label{generalLayer} \\tag{31}\n", + "\\end{equation}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "where $N_l$ is the number of nodes in layer $l$. When the output of all the nodes in the first hidden layer are computed,\n", + "the values of the subsequent layer can be calculated and so forth until the output is obtained. \n", + "\n", + "\n", + "\n", + "\n", + "## Mathematical model\n", + "\n", + "The output of neuron $i$ in layer 2 is thus," + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "\n", + "
\n", + "\n", + "$$\n", + "\\begin{equation}\n", + " y_i^2 = f_2\\left(\\sum_{j=1}^3 w_{ij}^2 y_j^1 + b_i^2\\right) \n", + "\\label{_auto12} \\tag{32}\n", + "\\end{equation}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "\n", + "
\n", + "\n", + "$$\n", + "\\begin{equation} \n", + " = f_2\\left[\\sum_{j=1}^3 w_{ij}^2f_1\\left(\\sum_{k=1}^2 w_{jk}^1 x_k + b_j^1\\right) + b_i^2\\right]\n", + "\\label{outputLayer2} \\tag{33}\n", + "\\end{equation}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "where we have substituted $y_m^1$ with. Finally, the NN output yields," + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "\n", + "
\n", + "\n", + "$$\n", + "\\begin{equation}\n", + " y_1^3 = f_3\\left(\\sum_{j=1}^3 w_{1m}^3 y_j^2 + b_1^3\\right) \n", + "\\label{_auto13} \\tag{34}\n", + "\\end{equation}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "\n", + "
\n", + "\n", + "$$\n", + "\\begin{equation} \n", + " = f_3\\left[\\sum_{j=1}^3 w_{1j}^3 f_2\\left(\\sum_{k=1}^3 w_{jk}^2 f_1\\left(\\sum_{m=1}^2 w_{km}^1 x_m + b_k^1\\right) + b_j^2\\right)\n", + " + b_1^3\\right]\n", + "\\label{_auto14} \\tag{35}\n", + "\\end{equation}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Mathematical model\n", + "\n", + "We can generalize this expression to an MLP with $l$ hidden layers. The complete functional form\n", + "is," + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "\n", + "
\n", + "\n", + "$$\n", + "\\begin{equation}\n", + "y^{l+1}_1\\! = \\!f_{l+1}\\!\\left[\\!\\sum_{j=1}^{N_l}\\! w_{1j}^3 f_l\\!\\left(\\!\\sum_{k=1}^{N_{l-1}}\\! w_{jk}^2 f_{l-1}\\!\\left(\\!\n", + " \\dots \\!f_1\\!\\left(\\!\\sum_{n=1}^{N_0} \\!w_{mn}^1 x_n\\! + \\!b_m^1\\!\\right)\n", + " \\!\\dots \\!\\right) \\!+ \\!b_k^2\\!\\right)\n", + " \\!+ \\!b_1^3\\!\\right] \n", + "\\label{completeNN} \\tag{36}\n", + "\\end{equation}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "which illustrates a basic property of MLPs: The only independent variables are the input values $x_n$. \n", + "\n", + "\n", + "## Mathematical model\n", + "\n", + "This confirms that an MLP,\n", + "despite its quite convoluted mathematical form, is nothing more than an analytic function, specifically a \n", + "mapping of real-valued vectors $\\vec{x} \\in \\mathbb{R}^n \\rightarrow \\vec{y} \\in \\mathbb{R}^m$. \n", + "In our example, $n=2$ and $m=1$. Consequentially, \n", + "the number of input and output values of the function we want to fit must be equal to the number of inputs and outputs of our MLP. \n", + "\n", + "Furthermore, the flexibility and universality of a MLP can be illustrated by realizing that \n", + "the expression is essentially a nested sum of scaled activation functions of the form" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "\n", + "
\n", + "\n", + "$$\n", + "\\begin{equation}\n", + " h(x) = c_1 f(c_2 x + c_3) + c_4\n", + "\\label{_auto15} \\tag{37}\n", + "\\end{equation}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "where the parameters $c_i$ are weights and biases. By adjusting these parameters, the activation functions\n", + "can be shifted up and down or left and right, change slope or be rescaled \n", + "which is the key to the flexibility of a neural network. \n", + "\n", + "\n", + "### Matrix-vector notation\n", + "\n", + "We can introduce a more convenient notation for the activations in a NN. \n", + "\n", + "Additionally, we can represent the biases and activations\n", + "as layer-wise column vectors $\\vec{b}_l$ and $\\vec{y}_l$, so that the $i$-th element of each vector \n", + "is the bias $b_i^l$ and activation $y_i^l$ of node $i$ in layer $l$ respectively. \n", + "\n", + "We have that $\\mathrm{W}_l$ is a $N_{l-1} \\times N_l$ matrix, while $\\vec{b}_l$ and $\\vec{y}_l$ are $N_l \\times 1$ column vectors. \n", + "With this notation, the sum in becomes a matrix-vector multiplication, and we can write\n", + "the equation for the activations of hidden layer 2 in" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "\n", + "
\n", + "\n", + "$$\n", + "\\begin{equation}\n", + " \\vec{y}_2 = f_2(\\mathrm{W}_2 \\vec{y}_{1} + \\vec{b}_{2}) = \n", + " f_2\\left(\\left[\\begin{array}{ccc}\n", + " w^2_{11} &w^2_{12} &w^2_{13} \\\\\n", + " w^2_{21} &w^2_{22} &w^2_{23} \\\\\n", + " w^2_{31} &w^2_{32} &w^2_{33} \\\\\n", + " \\end{array} \\right] \\cdot\n", + " \\left[\\begin{array}{c}\n", + " y^1_1 \\\\\n", + " y^1_2 \\\\\n", + " y^1_3 \\\\\n", + " \\end{array}\\right] + \n", + " \\left[\\begin{array}{c}\n", + " b^2_1 \\\\\n", + " b^2_2 \\\\\n", + " b^2_3 \\\\\n", + " \\end{array}\\right]\\right).\n", + "\\label{_auto16} \\tag{38}\n", + "\\end{equation}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### Matrix-vector notation and activation\n", + "\n", + "The activation of node $i$ in layer 2 is" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "\n", + "
\n", + "\n", + "$$\n", + "\\begin{equation}\n", + " y^2_i = f_2\\Bigr(w^2_{i1}y^1_1 + w^2_{i2}y^1_2 + w^2_{i3}y^1_3 + b^2_i\\Bigr) = \n", + " f_2\\left(\\sum_{j=1}^3 w^2_{ij} y_j^1 + b^2_i\\right).\n", + "\\label{_auto17} \\tag{39}\n", + "\\end{equation}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "This is not just a convenient and compact notation, but also \n", + "a useful and intuitive way to think about MLPs: The output is calculated by a series of matrix-vector multiplications\n", + "and vector additions that are used as input to the activation functions. For each operation \n", + "$\\mathrm{W}_l \\vec{y}_{l-1}$ we move forward one layer. \n", + "\n", + "\n", + "\n", + "### Activation functions\n", + "\n", + "A property that characterizes a neural network, other than its connectivity, is the choice of activation function(s). \n", + "As described in, the following restrictions are imposed on an activation function for a FFNN\n", + "to fulfill the universal approximation theorem\n", + "\n", + " * Non-constant\n", + "\n", + " * Bounded\n", + "\n", + " * Monotonically-increasing\n", + "\n", + " * Continuous\n", + "\n", + "### Activation functions, Logistic and Hyperbolic ones\n", + "\n", + "The second requirement excludes all linear functions. Furthermore, in a MLP with only linear activation functions, each \n", + "layer simply performs a linear transformation of its inputs.\n", + "\n", + "Regardless of the number of layers, \n", + "the output of the NN will be nothing but a linear function of the inputs. Thus we need to introduce some kind of \n", + "non-linearity to the NN to be able to fit non-linear functions\n", + "Typical examples are the logistic *Sigmoid*" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "\n", + "
\n", + "\n", + "$$\n", + "\\begin{equation}\n", + " f(x) = \\frac{1}{1 + e^{-x}},\n", + "\\label{sigmoidActivationFunction} \\tag{40}\n", + "\\end{equation}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and the *hyperbolic tangent* function" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "\n", + "
\n", + "\n", + "$$\n", + "\\begin{equation}\n", + " f(x) = \\tanh(x)\n", + "\\label{tanhActivationFunction} \\tag{41}\n", + "\\end{equation}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### Relevance\n", + "\n", + "The *sigmoid* function are more biologically plausible because \n", + "the output of inactive neurons are zero. Such activation function are called *one-sided*. However,\n", + "it has been shown that the hyperbolic tangent \n", + "performs better than the sigmoid for training MLPs. \n", + "has become the most popular for *deep neural networks*" + ] + } + ], + "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.4" + } + }, + "nbformat": 4, + "nbformat_minor": 2 +} diff --git a/doc/LectureNotes/book.do.txt b/doc/LectureNotes/book.do.txt new file mode 100644 index 000000000..e1638a97e --- /dev/null +++ b/doc/LectureNotes/book.do.txt @@ -0,0 +1,4662 @@ +TITLE: Data Analysis and Machine Learning +AUTHOR: Morten Hjorth-Jensen {copyright, 1999-present|CC BY-NC} at Department of Physics, University of Oslo & Department of Physics and Astronomy and National Superconducting Cyclotron Laboratory, Michigan State University +DATE: today + +TOC: on + +======= What is Machine Learning? ======= + +Machine learning is the science of giving computers the ability to +learn without being explicitly programmed. The idea is that there +exist generic algorithms which can be used to find patterns in a broad +class of data sets without having to write code specifically for each +problem. The algorithm will build its own logic based on the data. + +Machine learning is a subfield of computer science, and is closely +related to computational statistics. It evolved from the study of +pattern recognition in artificial intelligence (AI) research, and has +made contributions to AI tasks like computer vision, natural language +processing and speech recognition. It has also, especially in later +years, found applications in a wide variety of other areas, including +bioinformatics, economy, physics, finance and marketing. + + +===== Types of Machine Learning ===== + + +The approaches to machine learning are many, but are often split into two main categories. +In *supervised learning* we know the answer to a problem, +and let the computer deduce the logic behind it. On the other hand, *unsupervised learning* +is a method for finding patterns and relationship in data sets without any prior knowledge of the system. +Some authours also operate with a third category, namely *reinforcement learning*. This is a paradigm +of learning inspired by behavioural psychology, where learning is achieved by trial-and-error, +solely from rewards and punishment. + +Another way to categorize machine learning tasks is to consider the desired output of a system. +Some of the most common tasks are: + + * Classification: Outputs are divided into two or more classes. The goal is to produce a model that assigns inputs into one of these classes. An example is to identify digits based on pictures of hand-written ones. Classification is typically supervised learning. + + * Regression: Finding a functional relationship between an input data set and a reference data set. The goal is to construct a function that maps input data to continuous output values. + + * Clustering: Data are divided into groups with certain common traits, without knowing the different groups beforehand. It is thus a form of unsupervised learning. + + + +===== Different algorithms ===== +In this course we will build our machine learning approach on a statistical foundation, with elements +from data analysis, stochastic processes etc before we proceed with the following machine learning algorithms + +o Linear regression and its variants +o Decision tree algorithms, from simpler to more complex ones +o Nearest neighbors models +o Bayesian statistics +o Support vector machines and finally various variants of +o Artifical neural networks + +Before we proceed however, there are several practicalities with data analysis and software tools we would +like to present. These tools will help us in our understanding of various machine learning algorithms. + +Our emphasis here is on understanding the mathematical aspects of different algorithms, however, where possible +we will emphasize the importance of using available software. + + + +===== Software and needed installations ===== +We will make intensive use of python as programming language and the myriad of available libraries. +Furthermore, you will find IPython/Jupyter notebooks invaluable in your work. +You can run _R_ codes in the Jupyter/IPython notebooks, with the immediate benefit of visualizing your data. + + +If you have Python installed (we recommend Python3) and you feel pretty familiar with installing different packages, +we recommend that you install the following Python packages via _pip_ as +o pip install numpy scipy matplotlib ipython scikit-learn mglearn sympy pandas pillow +For Python3, replace _pip_ with _pip3_. + +For OSX users we recommend also, after having installed Xcode, to install _brew_. Brew allows +for a seamless installation of additional software via for example +o brew install python3 + +For Linux users, with its variety of distributions like for example the widely popular Ubuntu distribution +you can use _pip_ as well and simply install Python as +o sudo apt-get install python3 (or python for pyhton2.7) +etc etc. + + +===== Python installers ===== +If you don't want to perform these operations separately, we recommend two widely used distrubutions which set up +all relevant dependencies for Python, namely +o "Anaconda":"https://docs.anaconda.com/" Anaconda is an open source distribution of the Python and R programming languages for large-scale data processing, predictive analytics, and scientific computing, that aims to simplify package management and deployment. Package versions are managed by the package management system _conda_ +o "Enthought canopy":"https://www.enthought.com/product/canopy/" is a Python distribution for scientific and analytic computing distribution and analysis environment, available for free and under a commercial license. + + + +===== Installing R, C++, cython or Julia ===== + +You will also find it convenient to utilize R. +Jupyter/Ipython notebook allows you run _R_ code interactively in your browser. The software library _R_ is +tuned to statistically analysis and allows for an easy usage of the tools we will discuss in these texts. + +To install _R_ with Jupyter notebook "following the link here":"https://mpacer.org/maths/r-kernel-for-ipython-notebook" + + + + +===== Installing R, C++, cython or Julia ===== + + +For the C++ affecianodas, Jupyter/IPython notebook allows you also to install C++ and run codes written in this language +interactively in the browser. Since we will emphasize writing many of the algorithms yourself, you can thus opt for +either Python or C++ as programming languages. + +To add more entropy, _cython_ can also be used when running your notebooks. It means that Python with the Jupyter/IPython notebook +setup allows you to integrate widely popular softwares and tools for scientific computing. With its versatility, +including symbolic operations, Python offers a unique computational environment. Your Jupyter/IPython notebook +can easily be converted into a nicely rendered _PDF_ file or a Latex file for further processing. For example, convert to latex as +!bc pycod +jupyter nbconvert filename.ipynb --to latex +!ec + +If you use the light mark-up language _doconce_ you can convert a standard ascii text file into various HTML +formats, ipython notebooks, latex files, pdf files etc. + + + + +===== Introduction to Jupyter notebook and available tools ===== + + +!bc pycod +import numpy as np +import matplotlib.pyplot as plt +from scipy import sparse +import pandas as pd +from IPython.display import display +eye = np.eye(4) +print(eye) +sparse_mtx = sparse.csr_matrix(eye) +print(sparse_mtx) +x = np.linspace(-10,10,100) +y = np.sin(x) +plt.plot(x,y,marker='x') +plt.show() +data = {'Name': ["John", "Anna", "Peter", "Linda"], 'Location': ["Nairobi", "Napoli", "London", "Buenos Aires"], 'Age':[51, 21, 34, 45]} +data_pandas = pd.DataFrame(data) +display(data_pandas) +!ec + + + +===== Representing data, more examples ===== + +!bc pycod +import numpy as np +import matplotlib.pyplot as plt +from scipy import sparse +import pandas as pd +from IPython.display import display +import mglearn +import sklearn +from sklearn.linear_model import LinearRegression +from sklearn.tree import DecisionTreeRegressor +x, y = mglearn.datasets.make_wave(n_samples=100) +line = np.linspace(-3,3,1000,endpoint=False).reshape(-1,1) +reg = DecisionTreeRegressor(min_samples_split=3).fit(x,y) +plt.plot(line, reg.predict(line), label="decision tree") +regline = LinearRegression().fit(x,y) +plt.plot(line, regline.predict(line), label= "Linear Rgression") +plt.show() +!ec + + + +===== Predator-Prey model from ecology ===== + + +The population dynamics of a simple predator-prey system is a +classical example shown in many biology textbooks when ecological +systems are discussed. The system contains all elements of the +scientific method: + + * The set up of a specific hypothesis combined with + * the experimental methods needed (one can study existing data or perform experiments) + * analyzing and interpreting the data and performing further experiments if needed + * trying to extract general behaviors and extract eventual laws or patterns + * develop mathematical relations for the uncovered regularities/laws and test these by per forming new experiments + + + + +===== Case study from Hudson bay ===== + + +Lots of data about populations of hares and lynx collected from furs in Hudson Bay, Canada, are available. It is known that the populations oscillate. Why? +Here we start by + + o plotting the data + o derive a simple model for the population dynamics + o (fitting parameters in the model to the data) + o using the model predict the evolution other predator-pray systems + + + +===== Hudson bay data ===== + + + + +Most mammalian predators rely on a variety of prey, which complicates mathematical modeling; however, a few predators have become highly specialized and seek almost exclusively a single prey species. An example of this simplified predator-prey interaction is seen in Canadian northern forests, where the populations of the lynx and the snowshoe hare are intertwined in a life and death struggle. + +One reason that this particular system has been so extensively studied is that the Hudson Bay company kept careful records of all furs from the early 1800s into the 1900s. The records for the furs collected by the Hudson Bay company showed distinct oscillations (approximately 12 year periods), suggesting that these species caused almost periodic fluctuations of each other's populations. The table here shows data from 1900 to 1920. + + +|------------------------------------------------------| +| Year | Hares (x1000) | Lynx (x1000)| +|---------l-----------------------r--------------r------| +| 1900 | 30.0 | 4.0 | +| 1901 | 47.2 | 6.1 | +| 1902 | 70.2 | 9.8 | +| 1903 | 77.4 | 35.2 | +| 1904 | 36.3 | 59.4 | +| 1905 | 20.6 | 41.7 | +| 1906 | 18.1 | 19.0 | +| 1907 | 21.4 | 13.0 | +| 1908 | 22.0 | 8.3 | +| 1909 | 25.4 | 9.1 | +| 1910 | 27.1 | 7.4 | +| 1911 | 40.3 | 8.0 | +| 1912 | 57 | 12.3 | +| 1913 | 76.6 | 19.5 | +| 1914 | 52.3 | 45.7 | +| 1915 | 19.5 | 51.1 | +| 1916 | 11.2 | 29.7 | +| 1917 | 7.6 | 15.8 | +| 1918 | 14.6 | 9.7 | +| 1919 | 16.2 | 10.1 | +| 1920 | 24.7 | 8.6 | +|------------------------------------------------------| + + + + + + +===== Plotting the data ===== + + +@@@CODE src/plot_Hudson.py + + + +===== Hares and lynx in Hudson bay from 1900 to 1920 ===== + +FIGURE: [fig/Hudson_Bay_data, width=700 frac=0.9] + + + + +===== Why now create a computer model for the hare and lynx populations? ===== + +We see from the plot that there are indeed fluctuations. +We would like to create a mathematical model that explains these +population fluctuations. Ecologists have predicted that in a simple +predator-prey system that a rise in prey population is followed (with +a lag) by a rise in the predator population. When the predator +population is sufficiently high, then the prey population begins +dropping. After the prey population falls, then the predator +population falls, which allows the prey population to recover and +complete one cycle of this interaction. Thus, we see that +qualitatively oscillations occur. Can a mathematical model predict +this? What causes cycles to slow or speed up? What affects the +amplitude of the oscillation or do you expect to see the oscillations +damp to a stable equilibrium? The models tend to ignore factors like +climate and other complicating factors. How significant are these? + + * We see oscillations in the data + * What causes cycles to slow or speed up? + * What affects the amplitude of the oscillation or do you expect to see the oscillations damp to a stable equilibrium? + * With a model we can better *understand the data* + * More important: we can understand the ecology dynamics of + predator-pray populations + + + + +===== The traditional (top-down) approach ===== + + +The classical way (in all books) is to present the Lotka-Volterra equations: + +!bt +\begin{align*} +\frac{dH}{dt} &= H(a - b L)\\ +\frac{dL}{dt} &= - L(d - c H) +\end{align*} +!et + +Here, + + * $H$ is the number of preys + * $L$ the number of predators + * $a$, $b$, $d$, $c$ are parameters + +Most books quickly establish the model and then use considerable space on +discussing the qualitative properties of this *nonlinear system of +ODEs* (which cannot be solved) + + + + + +===== Basic mathematics notation ===== + + * Time points: $t_0,t_1,\ldots,t_m$ + * Uniform distribution of time points: $t_n=n\Delta t$ + * $H^n$: population of hares at time $t_n$ + * $L^n$: population of lynx at time $t_n$ + * We want to model the changes in populations, $\Delta H=H^{n+1}-H^n$ + and $\Delta L=L^{n+1}-L^n$ during a general time interval $[t_{n+1},t_n]$ + of length $\Delta t=t_{n+1}-t_n$ + + + +===== Basic dynamics of the population of hares ===== + + +The population of hares evolves due to births and deaths exactly as a bacteria population: + +!bt +\[ +\Delta H = a \Delta t H^n +\] +!et +However, hares have an additional loss in the population because +they are eaten by lynx. +All the hares and lynx can form +$H\cdot L$ pairs in total. When such pairs meet during a time +interval $\Delta t$, there is some +small probablity that the lynx will eat the hare. +So in fraction $b\Delta t HL$, the lynx eat hares. This +loss of hares must be accounted for. Subtracted in the equation for hares: + +!bt +\[ \Delta H = a\Delta t H^n - b \Delta t H^nL^n\] +!et + + + +===== Basic dynamics of the population of lynx ===== + + +We assume that the primary growth for the lynx population depends on sufficient food for raising lynx kittens, which implies an adequate source of nutrients from predation on hares. Thus, the growth of the lynx population does not only depend of how many lynx there are, but on how many hares they can eat. +In a time interval $\Delta t HL$ hares and lynx can meet, and in a +fraction $b\Delta t HL$ the lynx eats the hare. All of this does not +contribute to the growth of lynx, again just a fraction of +$b\Delta t HL$ that we write as +$d\Delta t HL$. In addition, lynx die just as in the population +dynamics with one isolated animal population, leading to a loss +$-c\Delta t L$. + + + +The accounting of lynx then looks like +!bt +\[ \Delta L = d\Delta t H^nL^n - c\Delta t L^n\] +!et + + + +===== Evolution equations ===== + + +By writing up the definition of $\Delta H$ and $\Delta L$, and putting +all assumed known terms $H^n$ and $L^n$ on the right-hand side, we have + +!bt +\[ H^{n+1} = H^n + a\Delta t H^n - b\Delta t H^n L^n \] +!et + +!bt +\[ L^{n+1} = L^n + d\Delta t H^nL^n - c\Delta t L^n \] +!et + +Note: + + * These equations are ready to be implemented! + * But to start, we need $H^0$ and $L^0$ + (which we can get from the data) + * We also need values for $a$, $b$, $d$, $c$ + + + +===== Adapt the model to the Hudson Bay case ===== + + + * As always, models tend to be general - as here, applicable + to ``all'' predator-pray systems + * The critical issue is whether the *interaction* between hares and lynx + is sufficiently well modeled by $\hbox{const}HL$ + * The parameters $a$, $b$, $d$, and $c$ must be + estimated from data + * Measure time in years + * $t_0=1900$, $t_m=1920$ + + + +===== The program ===== + + +@@@CODE src/Hudson_Bay.py + + + +===== The plot ===== + +FIGURE: [fig/Hudson_Bay_sim, width=700 frac=0.9] + +If we perform a least-square fitting, we can find optimal values for the parameters $a$, $b$, $d$, $c$. The optimal parameters are $a=0.4807$, $b=0.02482$, $d=0.9272$ and $c=0.02756$. These parameters result in a slightly modified initial conditions, namely $H(0) = 34.91$ and $L(0)=3.857$. With these parameters we are now ready to solve the equations and plot these data together with the experimental values. + + + +===== Linear regression in Python ===== + +!bc pycod +import numpy as np +import matplotlib.pyplot as plt +from IPython.display import display +import sklearn +from sklearn.linear_model import LinearRegression +from sklearn.tree import DecisionTreeRegressor + + +data = np.loadtxt('src/Hudson_Bay.csv', delimiter=',', skiprows=1) +x = data[:,0] +y = data[:,1] +line = np.linspace(1900,1920,1000,endpoint=False).reshape(-1,1) +reg = DecisionTreeRegressor(min_samples_split=3).fit(x.reshape(-1,1),y.reshape(-1,1)) +plt.plot(line, reg.predict(line), label="decision tree") +regline = LinearRegression().fit(x.reshape(-1,1),y.reshape(-1,1)) +plt.plot(line, regline.predict(line), label= "Linear Regression") +plt.plot(x, y, label= "Linear Regression") +plt.show() +!ec + + + + + +===== Linear Least squares in R ===== + +!bc r +HudsonBay = read.csv("src/Hudson_Bay.csv",header=T) +fix(HudsonBay) +dim(HudsonBay) +names(HudsonBay) +plot(HudsonBay$Year, HudsonBay$Hares..x1000.) +attach(HudsonBay) +plot(Year, Hares..x1000.) +plot(Year, Hares..x1000., col="red", varwidth=T, xlab="Years", ylab="Haresx 1000") +summary(HudsonBay) +summary(Hares..x1000.) +library(MASS) +library(ISLR) +scatter.smooth(x=Year, y = Hares..x1000.) +linearMod = lm(Hares..x1000. ~ Year) +print(linearMod) +summary(linearMod) +plot(linearMod) +confint(linearMod) +predict(linearMod,data.frame(Year=c(1910,1914,1920)),interval="confidence") +!ec + + + +===== Non-Linear Least squares in R ===== + +!bc r +set.seed(1485) +len = 24 +x = runif(len) +y = x^3+rnorm(len, 0,0.06) +ds = data.frame(x = x, y = y) +str(ds) +plot( y ~ x, main ="Known cubic with noise") +s = seq(0,1,length =100) +lines(s, s^3, lty =2, col ="green") +m = nls(y ~ I(x^power), data = ds, start = list(power=1), trace = T) +class(m) +summary(m) +power = round(summary(m)$coefficients[1], 3) +power.se = round(summary(m)$coefficients[2], 3) +plot(y ~ x, main = "Fitted power model", sub = "Blue: fit; green: known") +s = seq(0, 1, length = 100) +lines(s, s^3, lty = 2, col = "green") +lines(s, predict(m, list(x = s)), lty = 1, col = "blue") +text(0, 0.5, paste("y =x^ (", power, " +/- ", power.se, ")", sep = ""), pos = 4) +!ec + + + + +======= Important Matrix and vector handling packages ======= + +The Numerical Recipes codes have been rewritten in Fortran 90/95 and +C/C++ by us. The original source codes are taken from the widely used +software package LAPACK, which follows two other popular packages +developed in the 1970s, namely EISPACK and LINPACK. + + * LINPACK: package for linear equations and least square problems. + * LAPACK:package for solving symmetric, unsymmetric and generalized eigenvalue problems. From LAPACK's website URL: "http://www.netlib.org" it is possible to download for free all source codes from this library. Both C/C++ and Fortran versions are available. + * BLAS (I, II and III): (Basic Linear Algebra Subprograms) are routines that provide standard building blocks for performing basic vector and matrix operations. Blas I is vector operations, II vector-matrix operations and III matrix-matrix operations. Highly parallelized and efficient codes, all available for download from URL: "http://www.netlib.org". + +_Add python material on linear algebra and array handling, text on numpy etc_ + + +===== Basic Matrix Features ===== + + Matrix properties reminder +!bt +\[ + \mathbf{A} = + \begin{bmatrix} a_{11} & a_{12} & a_{13} & a_{14} \\ + a_{21} & a_{22} & a_{23} & a_{24} \\ + a_{31} & a_{32} & a_{33} & a_{34} \\ + a_{41} & a_{42} & a_{43} & a_{44} + \end{bmatrix}\qquad +\mathbf{I} = + \begin{bmatrix} 1 & 0 & 0 & 0 \\ + 0 & 1 & 0 & 0 \\ + 0 & 0 & 1 & 0 \\ + 0 & 0 & 0 & 1 + \end{bmatrix} +\] +!et + + +===== Basic Matrix Features ===== + +The inverse of a matrix is defined by + +!bt +\[ +\mathbf{A}^{-1} \cdot \mathbf{A} = I +\] +!et + + + +===== Basic Matrix Features ===== + + Matrix Properties Reminder + +|----------------------------------------------------------------------| +| Relations | Name | matrix elements | +|----------------------------------------------------------------------| +| $A = A^{T}$ | symmetric | $a_{ij} = a_{ji}$ | +| $A = \left (A^{T} \right )^{-1}$ | real orthogonal | $\sum_k a_{ik} a_{jk} = \sum_k a_{ki} a_{kj} = \delta_{ij}$ | +| $A = A^{ * }$ | real matrix | $a_{ij} = a_{ij}^{ * }$ | +| $A = A^{\dagger}$ | hermitian | $a_{ij} = a_{ji}^{ * }$ | +| $A = \left (A^{\dagger} \right )^{-1}$ | unitary | $\sum_k a_{ik} a_{jk}^{ * } = \sum_k a_{ki}^{ * } a_{kj} = \delta_{ij}$ | +|----------------------------------------------------------------------| + + + + +===== Some famous Matrices ===== + + * Diagonal if $a_{ij}=0$ for $i\ne j$ + * Upper triangular if $a_{ij}=0$ for $i > j$ + * Lower triangular if $a_{ij}=0$ for $i < j$ + * Upper Hessenberg if $a_{ij}=0$ for $i > j+1$ + * Lower Hessenberg if $a_{ij}=0$ for $i < j+1$ + * Tridiagonal if $a_{ij}=0$ for $|i -j| > 1$ + * Lower banded with bandwidth $p$: $a_{ij}=0$ for $i > j+p$ + * Upper banded with bandwidth $p$: $a_{ij}=0$ for $i < j+p$ + * Banded, block upper triangular, block lower triangular.... + + +===== Basic Matrix Features ===== + + Some Equivalent Statements +For an $N\times N$ matrix $\mathbf{A}$ the following properties are all equivalent + + * If the inverse of $\mathbf{A}$ exists, $\mathbf{A}$ is nonsingular. + * The equation $\mathbf{Ax}=0$ implies $\mathbf{x}=0$. + * The rows of $\mathbf{A}$ form a basis of $R^N$. + * The columns of $\mathbf{A}$ form a basis of $R^N$. + * $\mathbf{A}$ is a product of elementary matrices. + * $0$ is not eigenvalue of $\mathbf{A}$. + + + + +===== Matrix Handling in C/C++, Static and Dynamical allocation ===== + + Static +We have an $N\times N$ matrix A with $N=100$ +In C/C++ this would be defined as + +!bc cppcod + int N = 100; + double A[100][100]; + // initialize all elements to zero + for(i=0 ; i < N ; i++) { + for(j=0 ; j < N ; j++) { + A[i][j] = 0.0; + +!ec +Note the way the matrix is organized, row-major order. + + + +===== Matrix Handling in C/C++ ===== + + Row Major Order, Addition +We have $N\times N$ matrices A, B and C and we wish to +evaluate $A=B+C$. + +!bt +\[ +\mathbf{A}= \mathbf{B}\pm\mathbf{C} \Longrightarrow a_{ij} = b_{ij}\pm c_{ij}, +\] +!et +In C/C++ this would be coded like + +!bc cppcod + for(i=0 ; i < N ; i++) { + for(j=0 ; j < N ; j++) { + a[i][j] = b[i][j]+c[i][j] + +!ec + + + +===== Matrix Handling in C/C++ ===== + + Row Major Order, Multiplication +We have $N\times N$ matrices A, B and C and we wish to +evaluate $A=BC$. + +!bt +\[ +\mathbf{A}=\mathbf{BC} \Longrightarrow a_{ij} = \sum_{k=1}^{n} b_{ik}c_{kj}, +\] +!et +In C/C++ this would be coded like + +!bc cppcod + for(i=0 ; i < N ; i++) { + for(j=0 ; j < N ; j++) { + for(k=0 ; k < N ; k++) { + a[i][j]+=b[i][k]*c[k][j]; + +!ec + + + + +===== Dynamic memory allocation in C/C++ ===== + +At least three possibilities in this course + + * Do it yourself + * Use the functions provided in the library package lib.cpp + * Use Armadillo URL: "http://arma.sourceforgenet" (a C++ linear algebra library, discussion both here and at lab). + + +===== Matrix Handling in C/C++, Dynamic Allocation ===== + + Do it yourself +!bc cppcod +int N; +double ** A; +A = new double*[N] +for ( i = 0; i < N; i++) + A[i] = new double[N]; +!ec +Always free space when you don't need an array anymore. + +!bc cppcod +for ( i = 0; i < N; i++) + delete[] A[i]; +delete[] A; +!ec + + + +===== Armadillo, recommended!! ===== + + * Armadillo is a C++ linear algebra library (matrix maths) aiming towards a good balance between speed and ease of use. The syntax is deliberately similar to Matlab. + * Integer, floating point and complex numbers are supported, as well as a subset of trigonometric and statistics functions. Various matrix decompositions are provided through optional integration with LAPACK, or one of its high performance drop-in replacements (such as the multi-threaded MKL or ACML libraries). + * A delayed evaluation approach is employed (at compile-time) to combine several operations into one and reduce (or eliminate) the need for temporaries. This is accomplished through recursive templates and template meta-programming. + * Useful for conversion of research code into production environments, or if C++ has been decided as the language of choice, due to speed and/or integration capabilities. + * The library is open-source software, and is distributed under a license that is useful in both open-source and commercial/proprietary contexts. + + +===== Armadillo, simple examples ===== + +!bc cppcod +#include +#include + +using namespace std; +using namespace arma; + +int main(int argc, char** argv) + { + mat A = randu(5,5); + mat B = randu(5,5); + + cout << A*B << endl; + + return 0; + +!ec + + +===== Armadillo, how to compile and install ===== + +For people using Ubuntu, Debian, Linux Mint, simply go to the synaptic package manager and install +armadillo from there. +You may have to install Lapack as well. +For Mac and Windows users, follow the instructions from the webpage +URL: "http://arma.sourceforge.net". +To compile, use for example (linux/ubuntu) + +!bc cppcod +c++ -O2 -o program.x program.cpp -larmadillo -llapack -lblas +!ec +where the `-l` option indicates the library you wish to link to. + +For OS X users you may have to declare the paths to the include files and the libraries as +!bc cppcod +c++ -O2 -o program.x program.cpp -L/usr/local/lib -I/usr/local/include -larmadillo -llapack -lblas +!ec + + +===== Armadillo, simple examples ===== + +!bc cppcod +#include +#include "armadillo" +using namespace arma; +using namespace std; + +int main(int argc, char** argv) + { + // directly specify the matrix size (elements are uninitialised) + mat A(2,3); + // .n_rows = number of rows (read only) + // .n_cols = number of columns (read only) + cout << "A.n_rows = " << A.n_rows << endl; + cout << "A.n_cols = " << A.n_cols << endl; + // directly access an element (indexing starts at 0) + A(1,2) = 456.0; + A.print("A:"); + // scalars are treated as a 1x1 matrix, + // hence the code below will set A to have a size of 1x1 + A = 5.0; + A.print("A:"); + // if you want a matrix with all elements set to a particular value + // the .fill() member function can be used + A.set_size(3,3); + A.fill(5.0); A.print("A:"); +!ec + + +===== Armadillo, simple examples ===== + +!bc cppcod + mat B; + + // endr indicates "end of row" + B << 0.555950 << 0.274690 << 0.540605 << 0.798938 << endr + << 0.108929 << 0.830123 << 0.891726 << 0.895283 << endr + << 0.948014 << 0.973234 << 0.216504 << 0.883152 << endr + << 0.023787 << 0.675382 << 0.231751 << 0.450332 << endr; + + // print to the cout stream + // with an optional string before the contents of the matrix + B.print("B:"); + + // the << operator can also be used to print the matrix + // to an arbitrary stream (cout in this case) + cout << "B:" << endl << B << endl; + // save to disk + B.save("B.txt", raw_ascii); + // load from disk + mat C; + C.load("B.txt"); + C += 2.0 * B; + C.print("C:"); +!ec + + +===== Armadillo, simple examples ===== + +!bc cppcod + // submatrix types: + // + // .submat(first_row, first_column, last_row, last_column) + // .row(row_number) + // .col(column_number) + // .cols(first_column, last_column) + // .rows(first_row, last_row) + + cout << "C.submat(0,0,3,1) =" << endl; + cout << C.submat(0,0,3,1) << endl; + + // generate the identity matrix + mat D = eye(4,4); + + D.submat(0,0,3,1) = C.cols(1,2); + D.print("D:"); + + // transpose + cout << "trans(B) =" << endl; + cout << trans(B) << endl; + + // maximum from each column (traverse along rows) + cout << "max(B) =" << endl; + cout << max(B) << endl; + +!ec + + +===== Armadillo, simple examples ===== + +!bc cppcod + // maximum from each row (traverse along columns) + cout << "max(B,1) =" << endl; + cout << max(B,1) << endl; + // maximum value in B + cout << "max(max(B)) = " << max(max(B)) << endl; + // sum of each column (traverse along rows) + cout << "sum(B) =" << endl; + cout << sum(B) << endl; + // sum of each row (traverse along columns) + cout << "sum(B,1) =" << endl; + cout << sum(B,1) << endl; + // sum of all elements + cout << "sum(sum(B)) = " << sum(sum(B)) << endl; + cout << "accu(B) = " << accu(B) << endl; + // trace = sum along diagonal + cout << "trace(B) = " << trace(B) << endl; + // random matrix -- values are uniformly distributed in the [0,1] interval + mat E = randu(4,4); + E.print("E:"); + +!ec + + +===== Armadillo, simple examples ===== + +!bc cppcod + // row vectors are treated like a matrix with one row + rowvec r; + r << 0.59499 << 0.88807 << 0.88532 << 0.19968; + r.print("r:"); + + // column vectors are treated like a matrix with one column + colvec q; + q << 0.81114 << 0.06256 << 0.95989 << 0.73628; + q.print("q:"); + + // dot or inner product + cout << "as_scalar(r*q) = " << as_scalar(r*q) << endl; + + // outer product + cout << "q*r =" << endl; + cout << q*r << endl; + + + // sum of three matrices (no temporary matrices are created) + mat F = B + C + D; + F.print("F:"); + + return 0; + +!ec + + +===== Armadillo, simple examples ===== + +!bc cppcod +#include +#include "armadillo" +using namespace arma; +using namespace std; + +int main(int argc, char** argv) + { + cout << "Armadillo version: " << arma_version::as_string() << endl; + + mat A; + + A << 0.165300 << 0.454037 << 0.995795 << 0.124098 << 0.047084 << endr + << 0.688782 << 0.036549 << 0.552848 << 0.937664 << 0.866401 << endr + << 0.348740 << 0.479388 << 0.506228 << 0.145673 << 0.491547 << endr + << 0.148678 << 0.682258 << 0.571154 << 0.874724 << 0.444632 << endr + << 0.245726 << 0.595218 << 0.409327 << 0.367827 << 0.385736 << endr; + + A.print("A ="); + + // determinant + cout << "det(A) = " << det(A) << endl; +!ec + + +===== Armadillo, simple examples ===== + +!bc cppcod + // inverse + cout << "inv(A) = " << endl << inv(A) << endl; + double k = 1.23; + + mat B = randu(5,5); + mat C = randu(5,5); + + rowvec r = randu(5); + colvec q = randu(5); + + + // examples of some expressions + // for which optimised implementations exist + // optimised implementation of a trinary expression + // that results in a scalar + cout << "as_scalar( r*inv(diagmat(B))*q ) = "; + cout << as_scalar( r*inv(diagmat(B))*q ) << endl; + + // example of an expression which is optimised + // as a call to the dgemm() function in BLAS: + cout << "k*trans(B)*C = " << endl << k*trans(B)*C; + + return 0; + +!ec + + +===== Gaussian Elimination ===== + +We start with the linear set of equations + +!bt +\[ + \mathbf{A}\mathbf{x} = \mathbf{w}. +\] +!et +We assume also that the matrix $\mathbf{A}$ is non-singular and that the +matrix elements along the diagonal satisfy $a_{ii} \ne 0$. Simple $4\times 4 $ example + +!bt +\[ +\begin{bmatrix} + a_{11}& a_{12} &a_{13}& a_{14}\\ + a_{21}& a_{22} &a_{23}& a_{24}\\ + a_{31}& a_{32} &a_{33}& a_{34}\\ + a_{41}& a_{42} &a_{43}& a_{44}\\ + \end{bmatrix} \begin{bmatrix} + x_1\\ + x_2\\ + x_3 \\ + x_4 \\ + \end{bmatrix} + =\begin{bmatrix} + w_1\\ + w_2\\ + w_3 \\ + w_4\\ + \end{bmatrix}. +\] +!et + + +===== Gaussian Elimination ===== +or + +!bt +\begin{align} + a_{11}x_1 +a_{12}x_2 +a_{13}x_3 + a_{14}x_4=&w_1 \nonumber \\ +a_{21}x_1 + a_{22}x_2 + a_{23}x_3 + a_{24}x_4=&w_2 \nonumber \\ +a_{31}x_1 + a_{32}x_2 + a_{33}x_3 + a_{34}x_4=&w_3 \nonumber \\ +a_{41}x_1 + a_{42}x_2 + a_{43}x_3 + a_{44}x_4=&w_4. \nonumber +\end{align} +!et + + +===== Gaussian Elimination ===== + +The basic idea of Gaussian elimination is to use the first equation to eliminate the first unknown $x_1$ +from the remaining $n-1$ equations. Then we use the new second equation to eliminate the second unknown +$x_2$ from the remaining $n-2$ equations. With $n-1$ such eliminations +we obtain a so-called upper triangular set of equations of the form + +!bt +\begin{align} + b_{11}x_1 +b_{12}x_2 +b_{13}x_3 + b_{14}x_4=&y_1 \nonumber \\ + b_{22}x_2 + b_{23}x_3 + b_{24}x_4=&y_2 \nonumber \\ +b_{33}x_3 + b_{34}x_4=&y_3 \nonumber \\ +b_{44}x_4=&y_4. \nonumber +label{eq:gaussbacksub} +\end{align} +!et +We can solve this system of equations recursively starting from $x_n$ (in our case $x_4$) and proceed with +what is called a backward substitution. + + +===== Gaussian Elimination ===== +This process can be expressed mathematically as + +!bt +\begin{equation} + x_m = \frac{1}{b_{mm}}\left(y_m-\sum_{k=m+1}^nb_{mk}x_k\right)\quad m=n-1,n-2,\dots,1. +\end{equation} +!et +To arrive at such an upper triangular system of equations, we start by eliminating +the unknown $x_1$ for $j=2,n$. We achieve this by multiplying the first equation by $a_{j1}/a_{11}$ and then subtract +the result from the $j$th equation. We assume obviously that $a_{11}\ne 0$ and that +$\mathbf{A}$ is not singular. + + +===== Gaussian Elimination ===== + +Our actual $4\times 4$ example reads after the first operation + +!bt +\[ +\begin{bmatrix} + a_{11}& a_{12} &a_{13}& a_{14}\\ + 0& (a_{22}-\frac{a_{21}a_{12}}{a_{11}}) &(a_{23}-\frac{a_{21}a_{13}}{a_{11}}) & (a_{24}-\frac{a_{21}a_{14}}{a_{11}})\\ +0& (a_{32}-\frac{a_{31}a_{12}}{a_{11}})& (a_{33}-\frac{a_{31}a_{13}}{a_{11}})& (a_{34}-\frac{a_{31}a_{14}}{a_{11}})\\ +0&(a_{42}-\frac{a_{41}a_{12}}{a_{11}}) &(a_{43}-\frac{a_{41}a_{13}}{a_{11}}) & (a_{44}-\frac{a_{41}a_{14}}{a_{11}}) \\ + \end{bmatrix} \begin{bmatrix} + x_1\\ + x_2\\ + x_3 \\ + x_4 \\ + \end{bmatrix} + =\begin{bmatrix} + y_1\\ + w_2^{(2)}\\ + w_3^{(2)} \\ + w_4^{(2)}\\ + \end{bmatrix}, +\] +!et +or + +!bt +\begin{align} + b_{11}x_1 +b_{12}x_2 +b_{13}x_3 + b_{14}x_4=&y_1 \nonumber \\ + a^{(2)}_{22}x_2 + a^{(2)}_{23}x_3 + a^{(2)}_{24}x_4=&w^{(2)}_2 \nonumber \\ + a^{(2)}_{32}x_2 + a^{(2)}_{33}x_3 + a^{(2)}_{34}x_4=&w^{(2)}_3 \nonumber \\ + a^{(2)}_{42}x_2 + a^{(2)}_{43}x_3 + a^{(2)}_{44}x_4=&w^{(2)}_4, \nonumber \\ +\end{align} +!et + + +===== Gaussian Elimination ===== + +The new coefficients are + +!bt +\begin{equation} + b_{1k} = a_{1k}^{(1)} \quad k=1,\dots,n, +\end{equation} +!et +where each $a_{1k}^{(1)}$ is equal to the original $a_{1k}$ element. The other coefficients are + +!bt +\begin{equation} +a_{jk}^{(2)} = a_{jk}^{(1)}-\frac{a_{j1}^{(1)}a_{1k}^{(1)}}{a_{11}^{(1)}} \quad j,k=2,\dots,n, +\end{equation} +!et +with a new right-hand side given by + +!bt +\begin{equation} +y_{1}=w_1^{(1)}, \quad w_j^{(2)} =w_j^{(1)}-\frac{a_{j1}^{(1)}w_1^{(1)}}{a_{11}^{(1)}} \quad j=2,\dots,n. +\end{equation} +!et +We have also set $w_1^{(1)}=w_1$, the original vector element. +We see that the system of unknowns $x_1,\dots,x_n$ is transformed into an $(n-1)\times (n-1)$ problem. + + +===== Gaussian Elimination ===== + +This step is called forward substitution. +Proceeding with these substitutions, we obtain the +general expressions for the new coefficients + +!bt +\begin{equation} + a_{jk}^{(m+1)} = a_{jk}^{(m)}-\frac{a_{jm}^{(m)}a_{mk}^{(m)}}{a_{mm}^{(m)}} \quad j,k=m+1,\dots,n, +\end{equation} +!et +with $m=1,\dots,n-1$ and a +right-hand side given by + +!bt +\begin{equation} + w_j^{(m+1)} =w_j^{(m)}-\frac{a_{jm}^{(m)}w_m^{(m)}}{a_{mm}^{(m)}}\quad j=m+1,\dots,n. +\end{equation} +!et +This set of $n-1$ elimations leads us to an equations which is solved by back substitution. +If the arithmetics is exact and the matrix $\mathbf{A}$ is not singular, then the computed answer will be exact. + +Even though the matrix elements along the diagonal are not zero, +numerically small numbers may appear and subsequent divisions may lead to large numbers, which, if added +to a small number may yield losses of precision. Suppose for example that our first division in $(a_{22}-a_{21}a_{12}/a_{11})$ +results in $-10^{-7}$ and that $a_{22}$ is one. +one. We are then +adding $10^7+1$. With single precision this results in $10^7$. + + + + +===== Linear Algebra Methods ===== + + * Gaussian elimination, $O(2/3n^3)$ flops, general matrix + * LU decomposition, upper triangular and lower tridiagonal matrices, $O(2/3n^3)$ flops, general matrix. Get easily the inverse, determinant and can solve linear equations with back-substitution only, $O(n^2)$ flops + * Cholesky decomposition. Real symmetric or hermitian positive definite matrix, $O(1/3n^3)$ flops. + * Tridiagonal linear systems, important for differential equations. Normally positive definite and non-singular. $O(8n)$ flops for symmetric. Special case of banded matrices. + * Singular value decomposition + * the QR method will be discussed in chapter 7 in connection with eigenvalue systems. $O(4/3n^3)$ flops. + + +===== LU Decomposition ===== + +The LU decomposition method means that we can rewrite +this matrix as the product of two matrices $\mathbf{L}$ and $\mathbf{U}$ +where + +!bt +\[ + \begin{bmatrix} + a_{11} & a_{12} & a_{13} & a_{14} \\ + a_{21} & a_{22} & a_{23} & a_{24} \\ + a_{31} & a_{32} & a_{33} & a_{34} \\ + a_{41} & a_{42} & a_{43} & a_{44} + \end{bmatrix} + = \begin{bmatrix} + 1 & 0 & 0 & 0 \\ + l_{21} & 1 & 0 & 0 \\ + l_{31} & l_{32} & 1 & 0 \\ + l_{41} & l_{42} & l_{43} & 1 + \end{bmatrix} + \begin{bmatrix} + u_{11} & u_{12} & u_{13} & u_{14} \\ + 0 & u_{22} & u_{23} & u_{24} \\ + 0 & 0 & u_{33} & u_{34} \\ + 0 & 0 & 0 & u_{44} + \end{bmatrix}. +\] +!et + + +===== LU Decomposition ===== + +LU decomposition forms the backbone of other algorithms in linear algebra, such as the +solution of linear equations given by + +!bt +\begin{align} + a_{11}x_1 +a_{12}x_2 +a_{13}x_3 + a_{14}x_4=&w_1 \nonumber \\ +a_{21}x_1 + a_{22}x_2 + a_{23}x_3 + a_{24}x_4=&w_2 \nonumber \\ +a_{31}x_1 + a_{32}x_2 + a_{33}x_3 + a_{34}x_4=&w_3 \nonumber \\ +a_{41}x_1 + a_{42}x_2 + a_{43}x_3 + a_{44}x_4=&w_4. \nonumber +\end{align} +!et +The above set of equations is conveniently solved by using LU decomposition as an intermediate step. + +The matrix $\mathbf{A}\in \mathbb{R}^{n\times n}$ has an LU factorization if the determinant +is different from zero. If the LU factorization exists and $\mathbf{A}$ is non-singular, then the LU factorization +is unique and the determinant is given by + +!bt +\[ +det\{\mathbf{A}\}=det\{\mathbf{LU}\}= det\{\mathbf{L}\}det\{\mathbf{U}\}=u_{11}u_{22}\dots u_{nn}. +\] +!et + + +===== LU Decomposition, why? ===== + +There are at least three main advantages with LU decomposition compared with standard Gaussian elimination: + + * It is straightforward to compute the determinant of a matrix + * If we have to solve sets of linear equations with the same matrix but with different vectors $\mathbf{y}$, the number of FLOPS is of the order $n^3$. + * The inverse is such an operation + + +===== LU Decomposition, linear equations ===== + +With the LU decomposition it is rather +simple to solve a system of linear equations + +!bt +\begin{align} + a_{11}x_1 +a_{12}x_2 +a_{13}x_3 + a_{14}x_4=&w_1 \nonumber \\ +a_{21}x_1 + a_{22}x_2 + a_{23}x_3 + a_{24}x_4=&w_2 \nonumber \\ +a_{31}x_1 + a_{32}x_2 + a_{33}x_3 + a_{34}x_4=&w_3 \nonumber \\ +a_{41}x_1 + a_{42}x_2 + a_{43}x_3 + a_{44}x_4=&w_4. \nonumber +\end{align} +!et + +This can be written in matrix form as + +!bt +\[ \mathbf{Ax}=\mathbf{w}. \] +!et + +where $\mathbf{A}$ and $\mathbf{w}$ are known and we have to solve for +$\mathbf{x}$. Using the LU dcomposition we write + +!bt +\[ \mathbf{A} \mathbf{x} \equiv \mathbf{L} \mathbf{U} \mathbf{x} =\mathbf{w}. \] +!et + + +===== LU Decomposition, linear equations ===== + +The previous equation can be calculated in two steps + +!bt +\[ \mathbf{L} \mathbf{y} = \mathbf{w};\qquad \mathbf{Ux}=\mathbf{y}. \] +!et + +To show that this is correct we use to the LU decomposition +to rewrite our system of linear equations as + +!bt +\[ \mathbf{LUx}=\mathbf{w}, \] +!et +and since the determinat of $\mathbf{L}$ is equal to 1 (by construction +since the diagonals of $\mathbf{L}$ equal 1) we can use the inverse of +$\mathbf{L}$ to obtain + +!bt +\[ + \mathbf{Ux}=\mathbf{L^{-1}w}=\mathbf{y}, +\] +!et +which yields the intermediate step + +!bt +\[ + \mathbf{L^{-1}w}=\mathbf{y} +\] +!et +and as soon as we have $\mathbf{y}$ we can obtain $\mathbf{x}$ +through $\mathbf{Ux}=\mathbf{y}$. + + +===== LU Decomposition, why? ===== + +For our four-dimentional example this takes the form + +!bt +\begin{align} + y_1=&w_1 \nonumber\\ +l_{21}y_1 + y_2=&w_2\nonumber \\ +l_{31}y_1 + l_{32}y_2 + y_3 =&w_3\nonumber \\ +l_{41}y_1 + l_{42}y_2 + l_{43}y_3 + y_4=&w_4. \nonumber +\end{align} +!et + +and + +!bt +\begin{align} + u_{11}x_1 +u_{12}x_2 +u_{13}x_3 + u_{14}x_4=&y_1 \nonumber\\ +u_{22}x_2 + u_{23}x_3 + u_{24}x_4=&y_2\nonumber \\ +u_{33}x_3 + u_{34}x_4=&y_3\nonumber \\ +u_{44}x_4=&y_4 \nonumber +\end{align} +!et + +This example shows the basis for the algorithm +needed to solve the set of $n$ linear equations. + + +===== LU Decomposition, linear equations ===== + +The algorithm goes as follows + + * Set up the matrix $\bf A$ and the vector $\bf w$ with their correct dimensions. This determines the dimensionality of the unknown vector $\bf x$. + * Then LU decompose the matrix $\bf A$ through a call to the function `ludcmp(double a, int n, int indx, double &d)`. This functions returns the LU decomposed matrix $\bf A$, its determinant and the vector indx which keeps track of the number of interchanges of rows. If the determinant is zero, the solution is malconditioned. + * Thereafter you call the function `lubksb(double a, int n, int indx, double w)` which uses the LU decomposed matrix $\bf A$ and the vector $\bf w$ and returns $\bf x$ in the same place as $\bf w$. Upon exit the original content in $\bf w$ is destroyed. If you wish to keep this information, you should make a backup of it in your calling function. + + +===== LU Decomposition, the inverse of a matrix ===== + +If the inverse exists then + +!bt +\[ + \mathbf{A}^{-1}\mathbf{A}=\mathbf{I}, +\] +!et +the identity matrix. With an LU decomposed matrix we can rewrite the last equation as + +!bt +\[ + \mathbf{LU}\mathbf{A}^{-1}=\mathbf{I}. +\] +!et + + +===== LU Decomposition, the inverse of a matrix ===== + +If we assume that the first column (that is column 1) of the inverse matrix +can be written as a vector with unknown entries + +!bt +\[ + \mathbf{A}_1^{-1}= \begin{bmatrix} + + a_{11}^{-1} \\ + a_{21}^{-1} \\ + \dots \\ + a_{n1}^{-1} \\ + \end{bmatrix}, +\] +!et +then we have a linear set of equations + +!bt +\[ + \mathbf{LU}\begin{bmatrix} + + a_{11}^{-1} \\ + a_{21}^{-1} \\ + \dots \\ + a_{n1}^{-1} \\ + \end{bmatrix} =\begin{bmatrix} + 1 \\ + 0 \\ + \dots \\ + 0 \\ + \end{bmatrix}. +\] +!et + + +===== LU Decomposition, the inverse ===== + +In a similar way we can compute the unknow entries of the second column, + +!bt +\[ + \mathbf{LU}\begin{bmatrix} + + a_{12}^{-1} \\ + a_{22}^{-1} \\ + \dots \\ + a_{n2}^{-1} \\ + \end{bmatrix}=\begin{bmatrix} + 0 \\ + 1 \\ + \dots \\ + 0 \\ + \end{bmatrix}, +\] +!et +and continue till we have solved all $n$ sets of linear equations. + + + +===== "Using Armadillo to perform an LU decomposition":"https://github.com/CompPhysics/ComputationalPhysicsMSU/blob/master/doc/Programs/CppQtCodesLectures/MatrixTest/main.cpp" ===== +!bc cppcod +#include +#include "armadillo" +using namespace arma; +using namespace std; + +int main() + { + mat A = randu(5,5); + vec b = randu(5); + + A.print("A ="); + b.print("b="); + // solve Ax = b + vec x = solve(A,b); + // print x + x.print("x="); + // find LU decomp of A, if needed, P is the permutation matrix + mat L, U; + lu(L,U,A); + // print l + L.print(" L= "); + // print U + U.print(" U= "); + //Check that A = LU + (A-L*U).print("Test of LU decomposition"); + return 0; + } +!ec + + +===== Iterative methods, Chapter 6 ===== + + * Direct solvers such as Gauss elimination and LU decomposition discussed in connection with project 1. + * Iterative solvers such as Basic iterative solvers, Jacobi, Gauss-Seidel, Successive over-relaxation. These methods are easy to parallelize, as we will se later. Much used in solutions of partial differential equations. + * Other iterative methods such as Krylov subspace methods with Generalized minimum residual (GMRES) and Conjugate gradient etc will not be discussed. + + + + +===== Iterative methods, Jacobi's method ===== + +It is a simple method for solving +!bt +\[ +\mathbf{A}\mathbf{x}=\mathbf{b}, +\] +!et +where $\mathbf{A}$ is a matrix and $\mathbf{x}$ and $\mathbf{b}$ are vectors. The vector $\mathbf{x}$ is +the unknown. + +It is an iterative scheme where we start with a guess for the unknown, and +after $k+1$ iterations we have +!bt +\[ +\mathbf{x}^{(k+1)}= \mathbf{D}^{-1}(\mathbf{b}-(\mathbf{L}+\mathbf{U})\mathbf{x}^{(k)}), +\] +!et +with $\mathbf{A}=\mathbf{D}+\mathbf{U}+\mathbf{L}$ and +$\mathbf{D}$ being a diagonal matrix, $\mathbf{U}$ an upper triangular matrix and $\mathbf{L}$ a lower triangular +matrix. + +If the matrix $\mathbf{A}$ is positive definite or diagonally dominant, one can show that this method will always converge to the exact solution. + + + + +===== Iterative methods, Jacobi's method ===== + +We can demonstrate Jacobi's method by this $4\times 4$ matrix problem. We assume a guess +for the vector elements $x_i^{(0)}$, a guess which represents our first iteration. The new +values are obtained by substitution +!bt +\begin{align} + x_1^{(1)} =&(b_1-a_{12}x_2^{(0)} -a_{13}x_3^{(0)} - a_{14}x_4^{(0)})/a_{11} \nonumber \\ + x_2^{(1)} =&(b_2-a_{21}x_1^{(0)} - a_{23}x_3^{(0)} - a_{24}x_4^{(0)})/a_{22} \nonumber \\ + x_3^{(1)} =&(b_3- a_{31}x_1^{(0)} -a_{32}x_2^{(0)} -a_{34}x_4^{(0)})/a_{33} \nonumber \\ + x_4^{(1)}=&(b_4-a_{41}x_1^{(0)} -a_{42}x_2^{(0)} - a_{43}x_3^{(0)})/a_{44}, \nonumber +\end{align} +!et +which after $k+1$ iterations reads +!bt +\begin{align} + x_1^{(k+1)} =&(b_1-a_{12}x_2^{(k)} -a_{13}x_3^{(k)} - a_{14}x_4^{(k)})/a_{11} \nonumber \\ + x_2^{(k+1)} =&(b_2-a_{21}x_1^{(k)} - a_{23}x_3^{(k)} - a_{24}x_4^{(k)})/a_{22} \nonumber \\ + x_3^{(k+1)} =&(b_3- a_{31}x_1^{(k)} -a_{32}x_2^{(k)} -a_{34}x_4^{(k)})/a_{33} \nonumber \\ + x_4^{(k+1)}=&(b_4-a_{41}x_1^{(k)} -a_{42}x_2^{(k)} - a_{43}x_3^{(k)})/a_{44}, \nonumber +\end{align} +!et + + + + +===== Iterative methods, Jacobi's method ===== + +We can generalize the above equations to +!bt +\[ + x_i^{(k+1)}=(b_i-\sum_{j=1, j\ne i}^{n}a_{ij}x_j^{(k)})/a_{ii} +\] +!et +or in an even more compact form as +!bt +\[ \mathbf{x}^{(k+1)}= \mathbf{D}^{-1}(\mathbf{b}-(\mathbf{L}+\mathbf{U})\mathbf{x}^{(k)}), +\] +!et +with $\mathbf{A}=\mathbf{D}+\mathbf{U}+\mathbf{L}$ and +$\mathbf{D}$ being a diagonal matrix, $\mathbf{U}$ an upper triangular matrix and $\mathbf{L}$ a lower triangular +matrix. + + + +===== Iterative methods, Gauss-Seidel's method ===== + +Our $4\times 4$ matrix problem +!bt +\begin{align} + x_1^{(k+1)} =&(b_1-a_{12}x_2^{(k)} -a_{13}x_3^{(k)} - a_{14}x_4^{(k)})/a_{11} \nonumber \\ + x_2^{(k+1)} =&(b_2-a_{21}x_1^{(k)} - a_{23}x_3^{(k)} - a_{24}x_4^{(k)})/a_{22} \nonumber \\ + x_3^{(k+1)} =&(b_3- a_{31}x_1^{(k)} -a_{32}x_2^{(k)} -a_{34}x_4^{(k)})/a_{33} \nonumber \\ + x_4^{(k+1)}=&(b_4-a_{41}x_1^{(k)} -a_{42}x_2^{(k)} - a_{43}x_3^{(k)})/a_{44}, \nonumber +\end{align} +!et +can be rewritten as +!bt +\begin{align} + x_1^{(k+1)} =&(b_1-a_{12}x_2^{(k)} -a_{13}x_3^{(k)} - a_{14}x_4^{(k)})/a_{11} \nonumber \\ + x_2^{(k+1)} =&(b_2-a_{21}x_1^{(k+1)} - a_{23}x_3^{(k)} - a_{24}x_4^{(k)})/a_{22} \nonumber \\ + x_3^{(k+1)} =&(b_3- a_{31}x_1^{(k+1)} -a_{32}x_2^{(k+1)} -a_{34}x_4^{(k)})/a_{33} \nonumber \\ + x_4^{(k+1)}=&(b_4-a_{41}x_1^{(k+1)} -a_{42}x_2^{(k+1)} - a_{43}x_3^{(k+1)})/a_{44}, \nonumber +\end{align} +!et +which allows us to utilize the preceding solution (forward substitution). This improves normally the convergence +behavior and leads to the Gauss-Seidel method! + + + +===== Iterative methods, Gauss-Seidel's method ===== + +We can generalize +!bt +\begin{align} + x_1^{(k+1)} =&(b_1-a_{12}x_2^{(k)} -a_{13}x_3^{(k)} - a_{14}x_4^{(k)})/a_{11} \nonumber \\ + x_2^{(k+1)} =&(b_2-a_{21}x_1^{(k+1)} - a_{23}x_3^{(k)} - a_{24}x_4^{(k)})/a_{22} \nonumber \\ + x_3^{(k+1)} =&(b_3- a_{31}x_1^{(k+1)} -a_{32}x_2^{(k+1)} -a_{34}x_4^{(k)})/a_{33} \nonumber \\ + x_4^{(k+1)}=&(b_4-a_{41}x_1^{(k+1)} -a_{42}x_2^{(k+1)} - a_{43}x_3^{(k+1)})/a_{44}, \nonumber +\end{align} +!et +to the following form +!bt +\[ + x^{(k+1)}_i = \frac{1}{a_{ii}} \left(b_i - \sum_{j > i}a_{ij}x^{(k)}_j - \sum_{j < i}a_{ij}x^{(k+1)}_j \right),\quad i=1,2,\ldots,n. +\] +!et +The procedure is generally continued until the changes made by an iteration are below some tolerance. + +The convergence properties of the Jacobi method and the +Gauss-Seidel method are dependent on the matrix $\mathbf{A}$. These methods converge when +the matrix is symmetric positive-definite, or is strictly or irreducibly diagonally dominant. +Both methods sometimes converge even if these conditions are not satisfied. + + + +===== Iterative methods, Successive over-relaxation ===== + +Given a square system of n linear equations with unknown $\mathbf x$: +!bt +\[ + \mathbf{A}\mathbf x = \mathbf b +\] +!et +where +!bt +\[ + \mathbf{A}=\begin{bmatrix} a_{11} & a_{12} & \cdots & a_{1n} \\ a_{21} & a_{22} & \cdots & a_{2n} \\ \vdots & \vdots & \ddots & \vdots \\a_{n1} & a_{n2} & \cdots & a_{nn} \end{bmatrix}, \qquad \mathbf{x} = \begin{bmatrix} x_{1} \\ x_2 \\ \vdots \\ x_n \end{bmatrix} , \qquad \mathbf{b} = \begin{bmatrix} b_{1} \\ b_2 \\ \vdots \\ b_n \end{bmatrix}. +\] +!et + + + + +===== Iterative methods, Successive over-relaxation ===== + +Then A can be decomposed into a diagonal component D, and strictly lower and upper triangular components L and U: +!bt +\[ + \mathbf{A} =\mathbf{D} + \mathbf{L} + \mathbf{U}, +\] +!et +where +!bt +\[ + D = \begin{bmatrix} a_{11} & 0 & \cdots & 0 \\ 0 & a_{22} & \cdots & 0 \\ \vdots & \vdots & \ddots & \vdots \\0 & 0 & \cdots & a_{nn} \end{bmatrix}, \quad L = \begin{bmatrix} 0 & 0 & \cdots & 0 \\ a_{21} & 0 & \cdots & 0 \\ \vdots & \vdots & \ddots & \vdots \\a_{n1} & a_{n2} & \cdots & 0 \end{bmatrix}, \quad U = \begin{bmatrix} 0 & a_{12} & \cdots & a_{1n} \\ 0 & 0 & \cdots & a_{2n} \\ \vdots & \vdots & \ddots & \vdots \\0 & 0 & \cdots & 0 \end{bmatrix}. +\] +!et +The system of linear equations may be rewritten as: +!bt +\[ + (D+\omega L) \mathbf{x} = \omega \mathbf{b} - [\omega U + (\omega-1) D ] \mathbf{x} +\] +!et +for a constant $\omega > 1$. + + + + +===== Iterative methods, Successive over-relaxation ===== + +The method of successive over-relaxation is an iterative technique that solves the left hand side of this expression for $x$, using previous value for $x$ on the right hand side. Analytically, this may be written as: +!bt +\[ + \mathbf{x}^{(k+1)} = (D+\omega L)^{-1} \big(\omega \mathbf{b} - [\omega U + (\omega-1) D ] \mathbf{x}^{(k)}\big). +\] +!et +However, by taking advantage of the triangular form of $(D+\omega L)$, the elements of $x^{(k+1)}$ can be computed sequentially using forward substitution: +!bt +\[ + x^{(k+1)}_i = (1-\omega)x^{(k)}_i + \frac{\omega}{a_{ii}} \left(b_i - \sum_{j > i} a_{ij}x^{(k)}_j - \sum_{j < i} a_{ij}x^{(k+1)}_j \right),\quad i=1,2,\ldots,n. +\] +!et +The choice of relaxation factor is not necessarily easy, and depends upon the properties of the coefficient matrix. For symmetric, positive-definite matrices it can be proven that $0 < \omega < 2$ will lead to convergence, but we are generally interested in faster convergence rather than just convergence. + + + +======= Cubic Splines ======= + +Cubic spline interpolation is among one of the most used +methods for interpolating between data points where the arguments +are organized as ascending series. In the library program we supply +such a function, based on the so-called cubic spline method to be +described below. + +A spline function consists of polynomial pieces defined on +subintervals. The different subintervals are connected via +various continuity relations. + +Assume we have at our disposal $n+1$ points $x_0, x_1, \dots x_n$ +arranged so that $x_0 < x_1 < x_2 < \dots x_{n-1} < x_n$ (such points are called +knots). A spline function $s$ of degree $k$ with $n+1$ knots is defined +as follows + * On every subinterval $[x_{i-1},x_i)$ *s* is a polynomial of degree $\le k$. + * $s$ has $k-1$ continuous derivatives in the whole interval $[x_0,x_n]$. + + + + + +===== Splines ===== + +As an example, consider a spline function of degree $k=1$ defined as follows +!bt +\[ + s(x)=\begin{bmatrix} s_0(x)=a_0x+b_0 & x\in [x_0, x_1) \\ + s_1(x)=a_1x+b_1 & x\in [x_1, x_2) \\ + \dots & \dots \\ + s_{n-1}(x)=a_{n-1}x+b_{n-1} & x\in + [x_{n-1}, x_n] \end{bmatrix}. +\] +!et +In this case the polynomial consists of series of straight lines +connected to each other at every endpoint. The number of continuous +derivatives is then $k-1=0$, as expected when we deal with straight lines. +Such a polynomial is quite easy to construct given +$n+1$ points $x_0, x_1, \dots x_n$ and their corresponding +function values. + + + + +===== Splines ===== + +The most commonly used spline function is the one with $k=3$, the so-called +cubic spline function. +Assume that we have in adddition to the $n+1$ knots a series of +functions values $y_0=f(x_0), y_1=f(x_1), \dots y_n=f(x_n)$. +By definition, the polynomials $s_{i-1}$ and $s_i$ +are thence supposed to interpolate the same point $i$, that is +!bt +\[ + s_{i-1}(x_i)= y_i = s_i(x_i), +\] +!et +with $1 \le i \le n-1$. In total we have $n$ polynomials of the +type +!bt +\[ + s_i(x)=a_{i0}+a_{i1}x+a_{i2}x^2+a_{i2}x^3, +\] +!et +yielding $4n$ coefficients to determine. + + + + +===== Splines ===== + +Every subinterval provides in addition the $2n$ conditions +!bt +\[ + y_i = s(x_i), +\] +!et +and +!bt +\[ + s(x_{i+1})= y_{i+1}, +\] +!et +to be fulfilled. If we also assume that $s'$ and $s''$ are continuous, +then +!bt +\[ + s'_{i-1}(x_i)= s'_i(x_i), +\] +!et +yields $n-1$ conditions. Similarly, +!bt +\[ + s''_{i-1}(x_i)= s''_i(x_i), +\] +!et +results in additional $n-1$ conditions. In total we have $4n$ coefficients +and $4n-2$ equations to determine them, leaving us with $2$ degrees of +freedom to be determined. + + + +===== Splines ===== + +Using the last equation we define two values for the second derivative, namely +!bt +\[ + s''_{i}(x_i)= f_i, +\] +!et +and +!bt +\[ + s''_{i}(x_{i+1})= f_{i+1}, +\] +!et +and setting up a straight line between $f_i$ and $f_{i+1}$ we have +!bt +\[ + s_i''(x) = \frac{f_i}{x_{i+1}-x_i}(x_{i+1}-x)+ + \frac{f_{i+1}}{x_{i+1}-x_i}(x-x_i), +\] +!et +and integrating twice one obtains +!bt +\[ + s_i(x) = \frac{f_i}{6(x_{i+1}-x_i)}(x_{i+1}-x)^3+ + \frac{f_{i+1}}{6(x_{i+1}-x_i)}(x-x_i)^3 + +c(x-x_i)+d(x_{i+1}-x). +\] +!et + + + + + +===== Splines ===== + +Using the conditions $s_i(x_i)=y_i$ and $s_i(x_{i+1})=y_{i+1}$ +we can in turn determine the constants $c$ and $d$ resulting in +!bt +\begin{align} + s_i(x) =&\frac{f_i}{6(x_{i+1}-x_i)}(x_{i+1}-x)^3+ + \frac{f_{i+1}}{6(x_{i+1}-x_i)}(x-x_i)^3 \nonumber \\ + +&(\frac{y_{i+1}}{x_{i+1}-x_i}-\frac{f_{i+1}(x_{i+1}-x_i)}{6}) + (x-x_i)+ + (\frac{y_{i}}{x_{i+1}-x_i}-\frac{f_{i}(x_{i+1}-x_i)}{6}) + (x_{i+1}-x). +\end{align} +!et + + + + +===== Splines ===== + +How to determine the values of the second +derivatives $f_{i}$ and $f_{i+1}$? We use the continuity assumption +of the first derivatives +!bt +\[ + s'_{i-1}(x_i)= s'_i(x_i), +\] +!et +and set $x=x_i$. Defining $h_i=x_{i+1}-x_i$ we obtain finally +the following expression +!bt +\[ + h_{i-1}f_{i-1}+2(h_{i}+h_{i-1})f_i+h_if_{i+1}= + \frac{6}{h_i}(y_{i+1}-y_i)-\frac{6}{h_{i-1}}(y_{i}-y_{i-1}), +\] +!et +and introducing the shorthands $u_i=2(h_{i}+h_{i-1})$, +$v_i=\frac{6}{h_i}(y_{i+1}-y_i)-\frac{6}{h_{i-1}}(y_{i}-y_{i-1})$, +we can reformulate the problem as a set of linear equations to be +solved through e.g., Gaussian elemination + + + + +===== Splines ===== + +Gaussian elimination +!bt +\[ + \begin{bmatrix} u_1 & h_1 &0 &\dots & & & & \\ + h_1 & u_2 & h_2 &0 &\dots & & & \\ + 0 & h_2 & u_3 & h_3 &0 &\dots & & \\ + \dots& & \dots &\dots &\dots &\dots &\dots & \\ + &\dots & & &0 &h_{n-3} &u_{n-2} &h_{n-2} \\ + & && & &0 &h_{n-2} &u_{n-1} \end{bmatrix} + \begin{bmatrix} f_1 \\ + f_2 \\ + f_3\\ + \dots \\ + f_{n-2} \\ + f_{n-1} \end{bmatrix} = + \begin{bmatrix} v_1 \\ + v_2 \\ + v_3\\ + \dots \\ + v_{n-2}\\ + v_{n-1} \end{bmatrix}. +\] +!et +Note that this is a set of tridiagonal equations and can be solved +through only $O(n)$ operations. + + + +===== Splines ===== + +The functions supplied in the program library are *spline* and *splint*. +In order to use cubic spline interpolation you need first to call +!bc cppcod +spline(double x[], double y[], int n, double yp1, double yp2, double y2[]) +!ec +This function takes as +input $x[0,..,n - 1]$ and $y[0,..,n - 1]$ containing a tabulation +$y_i = f(x_i)$ with $x_0 < x_1 < .. < x_{n - 1}$ +together with the +first derivatives of $f(x)$ at $x_0$ and $x_{n-1}$, respectively. Then the +function returns $y2[0,..,n-1]$ which contains the second derivatives of +$f(x_i)$ at each point $x_i$. $n$ is the number of points. +This function provides the cubic spline interpolation for all subintervals +and is called only once. + + + + +===== Splines ===== + +Thereafter, if you wish to make various interpolations, you need to call the function +!bc cppcod +splint(double x[], double y[], double y2a[], int n, double x, double *y) +!ec +which takes as input +the tabulated values $x[0,..,n - 1]$ and $y[0,..,n - 1]$ and the output +y2a[0,..,n - 1] from *spline*. It returns the value $y$ corresponding +to the point $x$. + + + + + +===== Conjugate gradient (CG) method ===== + +The success of the CG method for finding solutions of non-linear problems is based +on the theory of conjugate gradients for linear systems of equations. It belongs +to the class of iterative methods for solving problems from linear algebra of the type +!bt +\begin{equation*} + \hat{A}\hat{x} = \hat{b}. +\end{equation*} +!et +In the iterative process we end up with a problem like + +!bt +\begin{equation*} + \hat{r}= \hat{b}-\hat{A}\hat{x}, +\end{equation*} +!et +where $\hat{r}$ is the so-called residual or error in the iterative process. + +When we have found the exact solution, $\hat{r}=0$. + + + + +===== Conjugate gradient method ===== + + +The residual is zero when we reach the minimum of the quadratic equation +!bt +\begin{equation*} + P(\hat{x})=\frac{1}{2}\hat{x}^T\hat{A}\hat{x} - \hat{x}^T\hat{b}, +\end{equation*} +!et +with the constraint that the matrix $\hat{A}$ is positive definite and symmetric. +If we search for a minimum of the quantum mechanical variance, then the matrix +$\hat{A}$, which is called the Hessian, is given by the second-derivative of the function we want to minimize. This quantity is always positive definite. In our case this corresponds normally to the second derivative of the energy. + + + + + + + +===== Conjugate gradient method, Newton's method first ===== + +We seek the minimum of the energy or the variance as function of various variational parameters. +In our case we have thus a function $f$ whose minimum we are seeking. +In Newton's method we set $\nabla f = 0$ and we can thus compute the next iteration point +!bt +\begin{equation*} +\hat{x}-\hat{x}_i=\hat{A}^{-1}\nabla f(\hat{x}_i). +\end{equation*} +!et +Subtracting this equation from that of $\hat{x}_{i+1}$ we have +!bt +\begin{equation*} +\hat{x}_{i+1}-\hat{x}_i=\hat{A}^{-1}(\nabla f(\hat{x}_{i+1})-\nabla f(\hat{x}_i)). +\end{equation*} +!et + + + +===== Simple example and demonstration ===== + +The function $f$ can be either the energy or the variance. If we choose the energy then we have +!bt +\begin{equation*} +\hat{\alpha}_{i+1}-\hat{\alpha}_i=\hat{A}^{-1}(\nabla E(\hat{\alpha}_{i+1})-\nabla E(\hat{\alpha}_i)). +\end{equation*} +!et +In the simple harmonic oscillator model, the gradient and the Hessian $\hat{A}$ are +!bt +\begin{equation*} +\frac{d\langle E_L[\alpha]\rangle}{d\alpha} = \alpha-\frac{1}{4\alpha^3} +\end{equation*} +!et +and a second derivative which is always positive (meaning that we find a minimum) +!bt +\begin{equation*} +\hat{A}= \frac{d^2\langle E_L[\alpha]\rangle}{d\alpha^2} = 1+\frac{3}{4\alpha^4} +\end{equation*} +!et + + + +===== Simple example and demonstration ===== + +We get then +!bt +\begin{equation*} +\alpha_{i+1}=\frac{4}{3}\alpha_i-\frac{\alpha_i^4}{3\alpha_{i+1}^3}, +\end{equation*} +!et +which can be rewritten as +!bt +\begin{equation*} +\alpha_{i+1}^4-\frac{4}{3}\alpha_i\alpha_{i+1}^4+\frac{1}{3}\alpha_i^4. +\end{equation*} +!et + + + +===== Conjugate gradient method ===== + +In the CG method we define so-called conjugate directions and two vectors +$\hat{s}$ and $\hat{t}$ +are said to be +conjugate if +!bt +\begin{equation*} +\hat{s}^T\hat{A}\hat{t}= 0. +\end{equation*} +!et +The philosophy of the CG method is to perform searches in various conjugate directions +of our vectors $\hat{x}_i$ obeying the above criterion, namely +!bt +\begin{equation*} +\hat{x}_i^T\hat{A}\hat{x}_j= 0. +\end{equation*} +!et +Two vectors are conjugate if they are orthogonal with respect to +this inner product. Being conjugate is a symmetric relation: if $\hat{s}$ is conjugate to $\hat{t}$, then $\hat{t}$ is conjugate to $\hat{s}$. + + + +===== Conjugate gradient method ===== + +An example is given by the eigenvectors of the matrix +!bt +\begin{equation*} +\hat{v}_i^T\hat{A}\hat{v}_j= \lambda\hat{v}_i^T\hat{v}_j, +\end{equation*} +!et +which is zero unless $i=j$. + + + + +===== Conjugate gradient method ===== + +Assume now that we have a symmetric positive-definite matrix $\hat{A}$ of size +$n\times n$. At each iteration $i+1$ we obtain the conjugate direction of a vector +!bt +\begin{equation*} +\hat{x}_{i+1}=\hat{x}_{i}+\alpha_i\hat{p}_{i}. +\end{equation*} +!et +We assume that $\hat{p}_{i}$ is a sequence of $n$ mutually conjugate directions. +Then the $\hat{p}_{i}$ form a basis of $R^n$ and we can expand the solution +$ \hat{A}\hat{x} = \hat{b}$ in this basis, namely + +!bt +\begin{equation*} + \hat{x} = \sum^{n}_{i=1} \alpha_i \hat{p}_i. +\end{equation*} +!et + + + +===== Conjugate gradient method ===== + +The coefficients are given by +!bt +\begin{equation*} + \mathbf{A}\mathbf{x} = \sum^{n}_{i=1} \alpha_i \mathbf{A} \mathbf{p}_i = \mathbf{b}. +\end{equation*} +!et +Multiplying with $\hat{p}_k^T$ from the left gives + +!bt +\begin{equation*} + \hat{p}_k^T \hat{A}\hat{x} = \sum^{n}_{i=1} \alpha_i\hat{p}_k^T \hat{A}\hat{p}_i= \hat{p}_k^T \hat{b}, +\end{equation*} +!et +and we can define the coefficients $\alpha_k$ as + +!bt +\begin{equation*} + \alpha_k = \frac{\hat{p}_k^T \hat{b}}{\hat{p}_k^T \hat{A} \hat{p}_k} +\end{equation*} +!et + + + +===== Conjugate gradient method and iterations ===== + + +If we choose the conjugate vectors $\hat{p}_k$ carefully, +then we may not need all of them to obtain a good approximation to the solution +$\hat{x}$. +We want to regard the conjugate gradient method as an iterative method. +This will us to solve systems where $n$ is so large that the direct +method would take too much time. + +We denote the initial guess for $\hat{x}$ as $\hat{x}_0$. +We can assume without loss of generality that +!bt +\begin{equation*} +\hat{x}_0=0, +\end{equation*} +!et +or consider the system +!bt +\begin{equation*} +\hat{A}\hat{z} = \hat{b}-\hat{A}\hat{x}_0, +\end{equation*} +!et +instead. + + + + +===== Conjugate gradient method ===== + +One can show that the solution $\hat{x}$ is also the unique minimizer of the quadratic form +!bt +\begin{equation*} + f(\hat{x}) = \frac{1}{2}\hat{x}^T\hat{A}\hat{x} - \hat{x}^T \hat{x} , \quad \hat{x}\in\mathbf{R}^n. +\end{equation*} +!et +This suggests taking the first basis vector $\hat{p}_1$ +to be the gradient of $f$ at $\hat{x}=\hat{x}_0$, +which equals +!bt +\begin{equation*} +\hat{A}\hat{x}_0-\hat{b}, +\end{equation*} +!et +and +$\hat{x}_0=0$ it is equal $-\hat{b}$. +The other vectors in the basis will be conjugate to the gradient, +hence the name conjugate gradient method. + + + + +===== Conjugate gradient method ===== + +Let $\hat{r}_k$ be the residual at the $k$-th step: +!bt +\begin{equation*} +\hat{r}_k=\hat{b}-\hat{A}\hat{x}_k. +\end{equation*} +!et +Note that $\hat{r}_k$ is the negative gradient of $f$ at +$\hat{x}=\hat{x}_k$, +so the gradient descent method would be to move in the direction $\hat{r}_k$. +Here, we insist that the directions $\hat{p}_k$ are conjugate to each other, +so we take the direction closest to the gradient $\hat{r}_k$ +under the conjugacy constraint. +This gives the following expression +!bt +\begin{equation*} +\hat{p}_{k+1}=\hat{r}_k-\frac{\hat{p}_k^T \hat{A}\hat{r}_k}{\hat{p}_k^T\hat{A}\hat{p}_k} \hat{p}_k. +\end{equation*} +!et + + + +===== Conjugate gradient method ===== + +We can also compute the residual iteratively as +!bt +\begin{equation*} +\hat{r}_{k+1}=\hat{b}-\hat{A}\hat{x}_{k+1}, + \end{equation*} +!et +which equals +!bt +\begin{equation*} +\hat{b}-\hat{A}(\hat{x}_k+\alpha_k\hat{p}_k), + \end{equation*} +!et +or +!bt +\begin{equation*} +(\hat{b}-\hat{A}\hat{x}_k)-\alpha_k\hat{A}\hat{p}_k, + \end{equation*} +!et +which gives + +!bt +\begin{equation*} +\hat{r}_{k+1}=\hat{r}_k-\hat{A}\hat{p}_{k}, + \end{equation*} +!et + + + + +======= Review of probability theory ======= + +===== Domains and probabilities ===== + +Consider the following simple example, namely the tossing of a dice, resulting in the following possible values +!bt +\begin{equation*} +\{2,3,4,5,6,7,8,9,10,11,12\}. +\end{equation*} +!et +These values are called the *domain*. +To this domain we have the corresponding *probabilities* +!bt +\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*} +!et + + + +===== Tossing a dice ===== + +The numbers in the domain are the outcomes of the physical process tossing the 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 +!bt +\begin{equation*} +\{2,3,4,5,6,7,8,9,10,11,12\}, +\end{equation*} +!et +appear in a random order. After 11 throws the results may look like + +!bt +\begin{equation*} +\{10,8,6,3,6,9,11,8,12,4,5\}. +\end{equation*} +!et + + + +===== 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 PDF_. + + + +===== Stochastic variables and the main concepts, the discrete case ===== + +There are two main concepts associated with a stochastic variable. The +*domain* is the set $\mathbb D = \{x\}$ of all accessible values +the variable can assume, so that $X \in \mathbb D$. An example of a +discrete domain is the set of six different numbers that we may get by +throwing of a dice, $x\in\{1,\,2,\,3,\,4,\,5,\,6\}$. + +The *probability distribution function (PDF)* is a function +$p(x)$ on the domain which, in the discrete case, gives us the +probability or relative frequency with which these values of $X$ +occur +!bt +\begin{equation*} +p(x) = \mathrm{Prob}(X=x). +\end{equation*} +!et + + + + +===== 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 + +!bt +\begin{equation*} +\mathrm{Prob}(a\leq X\leq b) = \int_a^b p(x)dx. +\end{equation*} +!et +Qualitatively speaking, a stochastic variable represents the values of +numbers chosen as if by chance from some specified PDF so that the +selection of a large set of these numbers reproduces this PDF. + + + +===== The cumulative probability ===== + +Of interest to us is the *cumulative probability +distribution function* (_CDF_), $P(x)$, which is just the probability +for a stochastic variable $X$ to assume any value less than $x$ +!bt +\begin{equation*} +P(x)=\mathrm{Prob(}X\leq x\mathrm{)} = +\int_{-\infty}^x p(x^{\prime})dx^{\prime}. +\end{equation*} +!et +The relation between a CDF and its corresponding PDF is then + +!bt +\begin{equation*} +p(x) = \frac{d}{dx}P(x). +\end{equation*} +!et + + + +===== Properties of PDFs ===== + + +There are two properties that all PDFs must satisfy. The first one is +positivity (assuming that the PDF is normalized) + +!bt +\begin{equation*} +0 \leq p(x) \leq 1. +\end{equation*} +!et +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 +!bt +\begin{align*} +\sum_{x_i\in\mathbb D} p(x_i) & = 1,\\ +\int_{x\in\mathbb D} p(x)\,dx & = 1. +\end{align*} +!et + + + +===== Important distributions, the uniform distribution ===== + +The first one +is the most basic PDF; namely the uniform distribution +!bt +\begin{equation} +p(x) = \frac{1}{b-a}\theta(x-a)\theta(b-x), +label{eq:unifromPDF} +\end{equation} +!et +with +!bt +\begin{equation*} +\begin{array}{ll} +\theta(x)=0 & x<0 \\ +\theta(x)=\frac{1}{b-a} & \in [a,b]. +\end{array} +\end{equation*} +!et +The normal distribution with $b=1$ and $a=0$ is used to generate random numbers. + + + +===== Gaussian distribution ===== + +The second one is the Gaussian Distribution +!bt +\begin{equation*} +p(x) = \frac{1}{\sigma\sqrt{2\pi}} \exp{(-\frac{(x-\mu)^2}{2\sigma^2})}, +\end{equation*} +!et +with mean value $\mu$ and standard deviation $\sigma$. If $\mu=0$ and $\sigma=1$, it is normally called the _standard normal distribution_ +!bt +\begin{equation*} +p(x) = \frac{1}{\sqrt{2\pi}} \exp{(-\frac{x^2}{2})}, +\end{equation*} +!et + +The following simple Python code plots the above distribution for different values of $\mu$ and $\sigma$. +!bc pyscpro +import numpy as np +from math import acos, exp, sqrt +from matplotlib import pyplot as plt +from matplotlib import rc, rcParams +import matplotlib.units as units +import matplotlib.ticker as ticker +rc('text',usetex=True) +rc('font',**{'family':'serif','serif':['Gaussian distribution']}) +font = {'family' : 'serif', + 'color' : 'darkred', + 'weight' : 'normal', + 'size' : 16, + } +pi = acos(-1.0) +mu0 = 0.0 +sigma0 = 1.0 +mu1= 1.0 +sigma1 = 2.0 +mu2 = 2.0 +sigma2 = 4.0 + +x = np.linspace(-20.0, 20.0) +v0 = np.exp(-(x*x-2*x*mu0+mu0*mu0)/(2*sigma0*sigma0))/sqrt(2*pi*sigma0*sigma0) +v1 = np.exp(-(x*x-2*x*mu1+mu1*mu1)/(2*sigma1*sigma1))/sqrt(2*pi*sigma1*sigma1) +v2 = np.exp(-(x*x-2*x*mu2+mu2*mu2)/(2*sigma2*sigma2))/sqrt(2*pi*sigma2*sigma2) +plt.plot(x, v0, 'b-', x, v1, 'r-', x, v2, 'g-') +plt.title(r'{\bf Gaussian distributions}', fontsize=20) +plt.text(-19, 0.3, r'Parameters: $\mu = 0$, $\sigma = 1$', fontdict=font) +plt.text(-19, 0.18, r'Parameters: $\mu = 1$, $\sigma = 2$', fontdict=font) +plt.text(-19, 0.08, r'Parameters: $\mu = 2$, $\sigma = 4$', fontdict=font) +plt.xlabel(r'$x$',fontsize=20) +plt.ylabel(r'$p(x)$ [MeV]',fontsize=20) + +# Tweak spacing to prevent clipping of ylabel +plt.subplots_adjust(left=0.15) +plt.savefig('gaussian.pdf', format='pdf') +plt.show() +!ec + + + + +===== Exponential distribution ===== + +Another important distribution in science is the exponential distribution +!bt +\begin{equation*} +p(x) = \alpha\exp{-(\alpha x)}. +\end{equation*} +!et + + + +===== 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 + +!bt +\begin{equation} +\langle h \rangle_X \equiv \int\! h(x)p(x)\,dx +label{eq:expectation_value_of_h_wrt_p} +\end{equation} +!et +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 +!bt +\begin{equation*} +\langle x^n \rangle \equiv \int\! x^n p(x)\,dx +\end{equation*} +!et + + + +===== 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$ +!bt +\begin{equation*} +\langle x\rangle = \mu \equiv \int x p(x)dx, +\end{equation*} +!et +for a continuous distribution and +!bt +\begin{equation*} +\langle x\rangle = \mu \equiv \frac{1}{N}\sum_{i=1}^N x_i p(x_i), +\end{equation*} +!et +for a discrete distribution. +Qualitatively it represents the centroid or the average value of the +PDF and is therefore simply called the expectation value of $p(x)$. + + + +===== Stochastic variables and the main concepts, central moments, the variance ===== + + +A special version of the moments is the set of *central moments*, the n-th central moment defined as +!bt +\begin{equation*} +\langle (x-\langle x\rangle )^n\rangle \equiv \int\! (x-\langle x\rangle)^n p(x)\,dx +\end{equation*} +!et +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)$ +!bt +\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\rangle - 2 \langle x\rangle\langle x\rangle + \langle x\rangle^2\\ +& = \langle x^2 \rangle - \langle x\rangle^2 +\end{align*} +!et +The square root of the variance, $\sigma =\sqrt{\langle (x-\langle x\rangle)^2\rangle}$ is called the +_standard deviation_ of $p$. It is the RMS (root-mean-square) +value of the deviation of the PDF from its mean value, interpreted +qualitatively as the ``spread'' of $p$ around its mean. + + + + + +===== Probability Distribution Functions ===== + + +The following table collects properties of probability distribution functions. +In our notation we reserve the label $p(x)$ for the probability of a certain event, +while $P(x)$ is the cumulative probability. + + +|--------------------------------------------------------------------------------------------------------------------------------------| +| | Discrete PDF | Continuous PDF | +|---------------------l-------------------------------------------c-------------------------------------------c------------------------| +| Domain | $\left\{x_1, x_2, x_3, \dots, x_N\right\}$ | $[a,b]$ | +| Probability | $p(x_i)$ | $p(x)dx$ | +| Cumulative | $P_i=\sum_{l=1}^ip(x_l)$ | $P(x)=\int_a^xp(t)dt$ | +| Positivity | $ 0\le p(x_i)\le 1$ | $ p(x) \ge 0$ | +| Positivity | $ 0\le P_i\le 1$ | $ 0\le P(x)\le 1$ | +| Monotonic | $P_i\ge P_j$ if $x_i\ge x_j$ | $P(x_i)\ge P(x_j)$ if $x_i\ge x_j$ | +| Normalization | $P_N=1$ | $P(b)=1$ | +|--------------------------------------------------------------------------------------------------------------------------------------| + + + + + +===== Probability Distribution Functions ===== + +With a PDF we can compute expectation values of selected quantities such as + +!bt +\begin{equation*} + \langle x^k\rangle=\frac{1}{N}\sum_{i=1}^{N}x_i^kp(x_i), +\end{equation*} +!et +if we have a discrete PDF or + +!bt +\begin{equation*} + \langle x^k\rangle=\int_a^b x^kp(x)dx, +\end{equation*} +!et +in the case of a continuous PDF. We have already defined the mean value $\mu$ +and the variance $\sigma^2$. + + + +===== The three famous Probability Distribution Functions ===== + + +There are at least three PDFs which one may encounter. These are the + +_Uniform distribution_ +!bt +\begin{equation*} +p(x)=\frac{1}{b-a}\Theta(x-a)\Theta(b-x), +\end{equation*} +!et +yielding probabilities different from zero in the interval $[a,b]$. + +_The exponential distribution_ +!bt +\begin{equation*} +p(x)=\alpha \exp{(-\alpha x)}, +\end{equation*} +!et +yielding probabilities different from zero in the interval $[0,\infty)$ and with mean value +!bt +\begin{equation*} +\mu = \int_0^{\infty}xp(x)dx=\int_0^{\infty}x\alpha \exp{(-\alpha x)}dx=\frac{1}{\alpha}, +\end{equation*} +!et + +with variance +!bt +\begin{equation*} +\sigma^2=\int_0^{\infty}x^2p(x)dx-\mu^2 = \frac{1}{\alpha^2}. +\end{equation*} +!et + + +===== Probability Distribution Functions, the normal distribution ===== + +Finally, we have the so-called univariate normal distribution, or just the _normal distribution_ +!bt +\begin{equation*} +p(x)=\frac{1}{b\sqrt{2\pi}}\exp{\left(-\frac{(x-a)^2}{2b^2}\right)} +\end{equation*} +!et +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 +!bt +\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*} +!et +which becomes with a suitable change of variables +!bt +\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*} +!et + + + +===== Probability Distribution Functions, the normal distribution ===== + +Similarly, the variance becomes +!bt +\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*} +!et +and inserting the mean value and performing a variable change we obtain + +!bt +\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*} +!et +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 + +!bt +\begin{equation} + p(x)=\frac{1}{\sqrt{2\pi}}\exp{\left(-\frac{x^2}{2}\right)}. +\end{equation} +!et + + + +===== 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 + +!bt +\begin{equation*} +P(x) = \frac{1}{\sqrt{2\pi}}\int_{-\infty}^x\exp{\left(-\frac{t^2}{2}\right)}dt, +\end{equation*} +!et +which is difficult to evaluate in a quick way. + + + + +===== Probability Distribution Functions, other important distribution ===== + + +Some other PDFs which one encounters often in the natural sciences are the binomial distribution +!bt +\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*} +!et +where $y$ is the probability for a specific event, such as the tossing of a coin or moving left or right +in case of a random walker. Note that $x$ is a discrete stochastic variable. + +The sequence of binomial trials is characterized by the following definitions + + * Every experiment is thought to consist of $N$ independent trials. + + * In every independent trial one registers if a specific situation happens or not, such as the jump to the left or right of a random walker. + + * The probability for every outcome in a single trial has the same value, for example the outcome of tossing (either heads or tails) a coin is always $1/2$. + + + +===== Probability Distribution Functions, the binomial distribution ===== + + +In order to compute the mean and variance we need to recall Newton's binomial +formula +!bt +\begin{equation*} + (a+b)^m=\sum_{n=0}^m \left(\begin{array}{c} m \\ n\end{array}\right)a^nb^{m-n}, +\end{equation*} +!et +which can be used to show that + +!bt +\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*} +!et +the PDF is normalized to one. +The mean value is +!bt +\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*} +!et +resulting in +!bt +\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*} +!et +which we rewrite as + +!bt +\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*} +!et + +The variance is slightly trickier to get. It reads $\sigma^2=ny(1-y)$. + + +===== Probability Distribution Functions, Poisson's distribution ===== + + +Another important distribution with discrete stochastic variables $x$ is +the Poisson model, which resembles the exponential distribution and reads +!bt +\begin{equation*} + p(x) = \frac{\lambda^x}{x!} e^{-\lambda} \hspace{0.5cm}x=0,1,\dots,;\lambda > 0. +\end{equation*} +!et +In this case both the mean value and the variance are easier to calculate, + +!bt +\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*} +!et +and the variance is $\sigma^2=\lambda$. + + + + + +===== Probability Distribution Functions, Poisson's distribution ===== + +An example of applications of the Poisson distribution could be the counting +of the number of $\alpha$-particles emitted from a radioactive source in a given time interval. +In the limit of $n\rightarrow \infty$ and for small probabilities $y$, the binomial distribution +approaches the Poisson distribution. Setting $\lambda = ny$, with $y$ the probability for an event in +the binomial distribution we can show that + +!bt +\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*} +!et + + + +===== 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 + +!bt +\begin{align} +\mathrm{Cov}(X_i,\,X_j) & = \langle (x_i-\langle x_i\rangle)(x_j-\langle x_j\rangle)\rangle \\ +&=\int\cdots\int (x_i-\langle x_i\rangle)(x_j-\langle x_j\rangle)P(x_1,\dots,x_n)\,dx_1\dots dx_n, +label{eq:def_covariance} +\end{align} +!et +with +!bt +\begin{equation*} +\langle x_i\rangle = +\int\cdots\int x_i P(x_1,\dots,x_n)\,dx_1\dots dx_n. +\end{equation*} +!et + + + + + +===== Meet the covariance in matrix disguise ===== + +If we consider the above covariance as a matrix +!bt +\[ +C_{ij} =\mathrm{Cov}(X_i,\,X_j), +\] +!et +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. + + + +===== Meet the covariance, uncorrelated events ===== + + +This is easy to show, keeping in mind the linearity of +the expectation value. Consider the stochastic variables $X_i$ and +$X_j$, ($i\neq j$) +!bt +\begin{align*} +\mathrm{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*} +!et +If $X_i$ and $X_j$ are independent, we get +!bt +\[ +\langle x_i x_j\rangle = +\langle x_i\rangle\langle x_j\rangle=\mathrm{Cov}(X_i, X_j) = 0\ \ (i\neq j). +\] +!et + + + + +===== 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 +!bt +\begin{equation*} +\{x_1, x_2,\dots\,x_k,\dots\}. +\end{equation*} +!et + + + + +===== Numerical experiments and the covariance ===== + +We will call these +values our *measurements* and the entire set as our measured +*sample*. The action of measuring all the elements of a sample +we will call a stochastic *experiment* (since, operationally, +they are often associated with results of empirical observation of +some physical or mathematical phenomena; precisely an experiment). We +assume that these values are distributed according to some +PDF $p_X^{\phantom X}(x)$, where $X$ is just the formal symbol for the +stochastic variable whose PDF is $p_X^{\phantom X}(x)$. Instead of +trying to determine the full distribution $p$ we are often only +interested in finding the few lowest moments, like the mean +$\mu_X^{\phantom X}$ and the variance $\sigma_X^{\phantom X}$. + + + + +===== Numerical experiments and the covariance, actual situations ===== + +In practical situations however, a sample is always of finite size. Let that +size be $n$. The expectation value of a sample $\alpha$, the _sample mean_, is then defined as follows +!bt +\begin{equation*} +\langle x_{\alpha} \rangle \equiv \frac{1}{n}\sum_{k=1}^n x_{\alpha,k}. +\end{equation*} +!et +The *sample variance* is: +!bt +\begin{equation*} +\mathrm{Var}(x) \equiv \frac{1}{n}\sum_{k=1}^n (x_{\alpha,k} - \langle x_{\alpha} \rangle)^2, +\end{equation*} +!et +with its square root being the *standard deviation of the sample*. + + + + +===== Numerical experiments and the covariance, our observables ===== + +You can think of the above observables as a set of quantities which define +a given experiment. This experiment is then repeated several times, say $m$ times. +The total average is then +!bt +\begin{equation} +\langle X_m \rangle= \frac{1}{m}\sum_{\alpha=1}^mx_{\alpha}=\frac{1}{mn}\sum_{\alpha, k} x_{\alpha,k}, +label{eq:exptmean} +\end{equation} +!et +where the last sums end at $m$ and $n$. +The total variance is +!bt +\begin{equation*} +\sigma^2_m= \frac{1}{mn^2}\sum_{\alpha=1}^m(\langle x_{\alpha} \rangle-\langle X_m \rangle)^2, +\end{equation*} +!et +which we rewrite as +!bt +\begin{equation} +\sigma^2_m=\frac{1}{m}\sum_{\alpha=1}^m\sum_{kl=1}^n (x_{\alpha,k}-\langle X_m \rangle)(x_{\alpha,l}-\langle X_m \rangle). +label{eq:exptvariance} +\end{equation} +!et + + + +===== Numerical experiments and the covariance, the sample variance ===== + + +We define also the sample variance $\sigma^2$ of all $mn$ individual experiments as +!bt +\begin{equation} +\sigma^2=\frac{1}{mn}\sum_{\alpha=1}^m\sum_{k=1}^n (x_{\alpha,k}-\langle X_m \rangle)^2. +label{eq:sampleexptvariance} +\end{equation} +!et + + + +These quantities, being known experimental values or the results from our calculations, +may differ, in some cases +significantly, from the similarly named +exact values for the mean value $\mu_X$, the variance $\mathrm{Var}(X)$ +and the covariance $\mathrm{Cov}(X,Y)$. + + + +===== Numerical experiments and the covariance, central limit theorem ===== + + +The central limit theorem states that the PDF $\tilde{p}(z)$ of +the average of $m$ random values corresponding to a PDF $p(x)$ +is a normal distribution whose mean is the +mean value of the PDF $p(x)$ and whose variance is the variance +of the PDF $p(x)$ divided by $m$, the number of values used to compute $z$. + +The central limit theorem leads then to the well-known expression for the +standard deviation, given by +!bt +\begin{equation*} + \sigma_m= +\frac{\sigma}{\sqrt{m}}. +\end{equation*} +!et + +In many cases the above estimate for the standard deviation, in particular if correlations are strong, may be too simplistic. We need therefore a more precise defintion of the error and the variance in our results. + + + +===== Definition of Correlation Functions and Standard Deviation ===== + +Our estimate of the true average $\mu_{X}$ is the sample mean $\langle X_m \rangle$ + +!bt +\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*} +!et + + +We can then use Eq. (ref{eq:exptvariance}) +!bt +\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*} +!et +and rewrite it as +!bt +\begin{equation*} +\sigma^2_m=\frac{\sigma^2}{n}+\frac{2}{mn^2}\sum_{\alpha=1}^m\sum_{k +#include +#include +#include +using namespace std; +// output file as global variable +ofstream ofile; + +// Main function begins here +int main(int argc, char* argv[]) +{ + int n; + char *outfilename; + + cin >> n; + double MCint = 0.; double MCintsqr2=0.; + double invers_period = 1./RAND_MAX; // initialise the random number generator + srand(time(NULL)); // This produces the so-called seed in MC jargon + // Compute the variance and the mean value of the uniform distribution + // Compute also the specific values x for each cycle in order to be able to + // the covariance and the correlation function + // Read in output file, abort if there are too few command-line arguments + if( argc <= 2 ){ + cout << "Bad Usage: " << argv[0] << + " read also output file and number of cycles on same line" << endl; + exit(1); + } + else{ + outfilename=argv[1]; + } + ofile.open(outfilename); + // Get the number of Monte-Carlo samples + n = atoi(argv[2]); + double *X; + X = new double[n]; + for (int i = 0; i < n; i++){ + double x = double(rand())*invers_period; + X[i] = x; + MCint += x; + MCintsqr2 += x*x; + } + double Mean = MCint/((double) n ); + MCintsqr2 = MCintsqr2/((double) n ); + double STDev = sqrt(MCintsqr2-Mean*Mean); + double Variance = MCintsqr2-Mean*Mean; +// Write mean value and standard deviation + cout << " Standard deviation= " << STDev << " Integral = " << Mean << endl; + + // Now we compute the autocorrelation function + double *autocor; autocor = new double[n]; + for (int j = 0; j < n; j++){ + double sum = 0.0; + for (int k = 0; k < (n-j); k++){ + sum += (X[k]-Mean)*(X[k+j]-Mean); + } + autocor[j] = sum/Variance/((double) n ); + ofile << setiosflags(ios::showpoint | ios::uppercase); + ofile << setw(15) << setprecision(8) << j; + ofile << setw(15) << setprecision(8) << autocor[j] << endl; + } + ofile.close(); // close output file + return 0; +} // end of main program +!ec + + + + +===== Correlation function and which random number generators should I use ===== + +The following Python code plots the results for the correlation function from the above program. +!bc pyscpro +import numpy as np +from matplotlib import pyplot as plt +# Load in data file +data = np.loadtxt("datafiles/autocor.dat") +# Make arrays containing x-axis and binding energies as function of A +x = data[:,0] +corr = data[:,1] +plt.plot(x, corr ,'ro') +plt.axis([0,1000,-0.2, 1.1]) +plt.xlabel(r'$d$') +plt.ylabel(r'$C_d$') +plt.title(r'autocorrelation function for RNG') +plt.savefig('autocorr.pdf') +plt.show() + +!ec + + + + + +======= Which RNG should I use? ======= + +* In the library files lib.cpp and lib.h we have included four popular RNGs taken from the widely used textbook "Numerical Recipes":"http://numerical.recipes/". These are called ran0, ran1, ran2 and ran3. +* 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}$. + + + + + +===== 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]$. +!bc cppcod +/* + +// You need this +#include + +// Initialize the seed and call the Mersienne algo +std::random_device rd; +std::mt19937_64 gen(rd()); +// Set up the uniform distribution for x \in [[0, 1] +std::uniform_real_distribution RandomNumberGenerator(0.0,1.0); + +// Now use the RNG +int ix = (int) (RandomNumberGenerator(gen)*NSpins); +!ec + + + + + + +===== Why blocking? ===== + Statistical analysis + * Monte Carlo simulations can be treated as *computer experiments* + * The results can be analysed with the same statistical tools as we would use analysing experimental data. + * As in all experiments, we are looking for expectation values and an estimate of how accurate they are, i.e., possible sources for errors. + +A very good article which explains blocking is H. Flyvbjerg and H. G. Petersen, *Error estimates on averages of correlated data*, "Journal of Chemical Physics 91, 461-466 (1989)":"http://scitation.aip.org/content/aip/journal/jcp/91/1/10.1063/1.457480". + + + + + + +===== Why blocking? ===== + Statistical analysis + * As in other experiments, Monte Carlo experiments have two classes of errors: + * Statistical errors + * Systematical errors + * Statistical errors can be estimated using standard tools from statistics + * Systematical errors are method specific and must be treated differently from case to case. (In VMC a common source is the step length or time step in importance sampling) + + + + +===== Code to demonstrate the calculation of the autocorrelation function ===== +The following code computes the autocorrelation function, the covariance and the standard deviation +for standard RNG. +The "following file":"https://github.com/CompPhysics/ComputationalPhysics2/tree/gh-pages/doc/Programs/LecturePrograms/programs/Blocking/autocorrelation.cpp" gives the code. +!bc cppcod +// This function computes the autocorrelation function for +// the Mersenne random number generator with a uniform distribution +#include +#include +#include +#include +#include +#include +#include +#include +using namespace std; +using namespace arma; +// output file +ofstream ofile; + +// Main function begins here +int main(int argc, char* argv[]) +{ + int MonteCarloCycles; + string filename; + if (argc > 1) { + filename=argv[1]; + MonteCarloCycles = atoi(argv[2]); + string fileout = filename; + string argument = to_string(MonteCarloCycles); + fileout.append(argument); + ofile.open(fileout); + } + + // Compute the variance and the mean value of the uniform distribution + // Compute also the specific values x for each cycle in order to be able to + // compute the covariance and the correlation function + + vec X = zeros(MonteCarloCycles); + double MCint = 0.; double MCintsqr2=0.; + std::random_device rd; + std::mt19937_64 gen(rd()); + // Set up the uniform distribution for x \in [[0, 1] + std::uniform_real_distribution RandomNumberGenerator(0.0,1.0); + for (int i = 0; i < MonteCarloCycles; i++){ + double x = RandomNumberGenerator(gen); + X(i) = x; + MCint += x; + MCintsqr2 += x*x; + } + double Mean = MCint/((double) MonteCarloCycles ); + MCintsqr2 = MCintsqr2/((double) MonteCarloCycles ); + double STDev = sqrt(MCintsqr2-Mean*Mean); + double Variance = MCintsqr2-Mean*Mean; + // Write mean value and variance + cout << " Sample variance= " << Variance << " Mean value = " << Mean << endl; + // Now we compute the autocorrelation function + vec autocorrelation = zeros(MonteCarloCycles); + for (int j = 0; j < MonteCarloCycles; j++){ + double sum = 0.0; + for (int k = 0; k < (MonteCarloCycles-j); k++){ + sum += (X(k)-Mean)*(X(k+j)-Mean); + } + autocorrelation(j) = sum/Variance/((double) MonteCarloCycles ); + ofile << setiosflags(ios::showpoint | ios::uppercase); + ofile << setw(15) << setprecision(8) << j; + ofile << setw(15) << setprecision(8) << autocorrelation(j) << endl; + } + // Now compute the exact covariance using the autocorrelation function + double Covariance = 0.0; + for (int j = 0; j < MonteCarloCycles; j++){ + Covariance += autocorrelation(j); + } + Covariance *= 2.0/((double) MonteCarloCycles); + // Compute now the total variance, including the covariance, and obtain the standard deviation + double TotalVariance = (Variance/((double) MonteCarloCycles ))+Covariance; + cout << "Covariance =" << Covariance << "Totalvariance= " << TotalVariance << "Sample Variance/n= " << (Variance/((double) MonteCarloCycles )) << endl; + cout << " STD from sample variance= " << sqrt(Variance/((double) MonteCarloCycles )) << " STD with covariance = " << sqrt(TotalVariance) << endl; + + ofile.close(); // close output file + return 0; +} // end of main program + + +!ec + + + +===== What is blocking? ===== + Blocking + * Say that we have a set of samples from a Monte Carlo experiment + * Assuming (wrongly) that our samples are uncorrelated our best estimate of the standard deviation of the mean $\langle \mathbf{M}\rangle$ is given by +!bt +\[ +\sigma=\sqrt{\frac{1}{n}\left(\langle \mathbf{M}^2\rangle-\langle \mathbf{M}\rangle^2\right)} +\] +!et + * If the samples are correlated we can rewrite our results to show that +!bt +\[ +\sigma=\sqrt{\frac{1+2\tau/\Delta t}{n}\left(\langle \mathbf{M}^2\rangle-\langle \mathbf{M}\rangle^2\right)} +\] +!et + where $\tau$ is the correlation time (the time between a sample and the next uncorrelated sample) and $\Delta t$ is time between each sample + + + +===== What is blocking? ===== + Blocking + * If $\Delta t\gg\tau$ our first estimate of $\sigma$ still holds + * Much more common that $\Delta t<\tau$ + * In the method of data blocking we divide the sequence of samples into blocks + * We then take the mean $\langle \mathbf{M}_i\rangle$ of block $i=1\ldots n_{blocks}$ to calculate the total mean and variance + * The size of each block must be so large that sample $j$ of block $i$ is not correlated with sample $j$ of block $i+1$ + * The correlation time $\tau$ would be a good choice + + + +===== What is blocking? ===== + Blocking + * Problem: We don't know $\tau$ or it is too expensive to compute + * Solution: Make a plot of std. dev. as a function of blocksize + * The estimate of std. dev. of correlated data is too low $\to$ the error will increase with increasing block size until the blocks are uncorrelated, where we reach a plateau + * When the std. dev. stops increasing the blocks are uncorrelated + + + +===== Implementation ===== + + * Do a Monte Carlo simulation, storing all samples to file + * Do the statistical analysis on this file, independently of your Monte Carlo program + * Read the file into an array + * Loop over various block sizes + * For each block size $n_b$, loop over the array in steps of $n_b$ taking the mean of elements $i n_b,\ldots,(i+1) n_b$ + * Take the mean and variance of the resulting array + * Write the results for each block size to file for later + analysis + + + + + + + +===== Actual implementation with code, main function ===== +When the file gets large, it can be useful to write your data in binary mode instead of ascii characters. +The "following python file":"https://github.com/CompPhysics/MachineLearning/blob/master/doc/Programs/Sampling/analysis.py" reads data from file with the output from every Monte Carlo cycle. +!bc pycod +# 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) + +!ec + + + + + +===== The Bootstrap method ===== + +The Bootstrap resampling method is also very popular. It is very simple: + +o Start with your sample of measurements and compute the sample variance and the mean values +o Then start again but pick in a random way the numbers in the sample and recalculate the mean and the sample variance. +o Repeat this $K$ times. + +It can be shown, see the article by "Efron":"https://projecteuclid.org/download/pdf_1/euclid.aos/1176344552" +that it produces the correct standard deviation. + +This method is very useful for small ensembles of data points. + + +===== Bootstrapping ===== +Given a set of $N$ data, assume that we are interested in some +observable $\theta$ which may be estimated from that set. This observable can also be for example the result of a fit based on all $N$ raw data. +Let us call the value of the observable obtained from the original +data set $\hat{\theta}$. One recreates from the sample repeatedly +other samples by choosing randomly $N$ data out of the original set. +This costs essentially nothing, since we just recycle the original data set for the building of new sets. + + +===== Bootstrapping, recipe ===== +Let us assume we have done this $K$ times and thus have $K$ sets of $N$ +data values each. +Of course some values will enter more than once in the new sets. For each of these sets one computes the observable $\theta$ resulting in values $\theta_k$ with $k = 1,...,K$. Then one determines +!bt +\[ +\tilde{\theta} = \frac{1}{K} \sum_{k=1}^K \theta_k, +\] +!et +and +!bt +\[ +sigma^2_{\tilde{\theta}} = \frac{1}{K} \sum_{k=1}^K \left(\theta_k-\tilde{\theta}\right)^2. +\] +!et + +These are estimators for $\angle\theta\rangle$ and its variance. They are not unbiased and therefore +$\tilde{\theta}\neq\hat{\theta}$ for finite K. + +The difference is called bias and gives an idea on how far away the result may be from +the true $\angle\theta\rangle$. As final result for the observable one quotes $\angle\theta\rangle = \tilde{\theta} \pm \sigma_{\tilde{\theta}}$ . + + + +===== Bootstrapping, "code":"https://github.com/CompPhysics/MachineLearning/blob/master/doc/Programs/Sampling/analysis.py" ===== +!bc +# 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) +!ec + + +===== Jackknife, "code":"https://github.com/CompPhysics/MachineLearning/blob/master/doc/Programs/Sampling/analysis.py" ===== +!bc +# 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) +!ec + + + + + +======= Regression analysis, overarching aims ======= + + +Regression modeling deals with the description of the sampling distribution of a given random variable $y$ varies as function of another variable or a set of such variables $\hat{x} =[x_0, x_1,\dots, x_p]^T$. +The first variable is called the _dependent_, the _outcome_ or the _response_ variable while the set of variables $\hat{x}$ is called the independent variable, or the predictor variable or the explanatory variable. + +A regression model aims at finding a likelihood function $p(y\vert \hat{x})$, that is the conditional distribution for $y$ with a given $\hat{x}$. The estimation of $p(y\vert \hat{x})$ is made using a data set with +* $n$ cases $i = 0, 1, 2, \dots, n-1$ +* Response (dependent or outcome) variable $y_i$ with $i = 0, 1, 2, \dots, n-1$ +* $p$ Explanatory (independent or predictor) variables $\hat{x}_i=[x_{i0}, x_{i1}, \dots, x_{ip}]$ with $i = 0, 1, 2, \dots, n-1$ + The goal of the regression analysis is to extract/exploit relationship between $y_i$ and $\hat{x}_i$ in or to infer causal dependencies, approximations to the likelihood functions, functional relationships and to make predictions . + + + + +===== General linear models ===== + +Before we proceed let us study a case from linear algebra where we aim at fitting a set of data $\hat{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 $\hat{x}=[x_0,x_1,\dots,x_{n-1}]$, that is $y_i = y(x_i)$ with $i=0,1,2,\dots,n-1$. The variables $x_i$ could represent physical quantities like time, temperature, position etc. We assume that $y(x)$ is a smooth function. + +Since obtaining these data points may not be trivial, we want to use these data to fit a function which can allow us to make predictions for values of $y$ which are not in the present set. The perhaps simplest approach is to assume we can parametrize our function in terms of a polynomial of degree $n-1$ with $n$ points, that is +!bt +\[ +y=y(x) \rightarrow y(x_i)=\tilde{y}_i+\epsilon_i=\sum_{j=0}^{n-1} \beta_i x_i^j+\epsilon_i, +\] +!et +where $\epsilon_i$ is the error in our approximation. + + + + + +===== Rewriting the fitting procedure as a linear algebra problem ===== + +For every set of values $y_i,x_i$ we have thus the corresponding set of equations +!bt +\begin{align*} +y_0&=\beta_0+\beta_1x_0^1+\beta_2x_0^2+\dots+\beta_{n-1}x_0^{n-1}+\epsilon_0\\ +y_1&=\beta_0+\beta_1x_1^1+\beta_2x_1^2+\dots+\beta_{n-1}x_1^{n-1}+\epsilon_1\\ +y_2&=\beta_0+\beta_1x_2^1+\beta_2x_2^2+\dots+\beta_{n-1}x_2^{n-1}+\epsilon_2\\ +\dots & \dots \\ +y_{n-1}&=\beta_0+\beta_1x_{n-1}^1+\beta_2x_{n-1}^2+\dots+\beta_1x_{n-1}^{n-1}+\epsilon_{n-1}.\\ +\end{align*} +!et + + + + +===== Rewriting the fitting procedure as a linear algebra problem, follows ===== + +Defining the vectors +!bt +\[ +\hat{y} = [y_0,y_1, y_2,\dots, y_{n-1}]^T, +\] +!et +!bt +\[ +\hat{\beta} = [\beta_0,\beta_1, \beta_2,\dots, \beta_{n-1}]^T, +\] +!et +!bt +\[ +\hat{\epsilon} = [\epsilon_0,\epsilon_1, \epsilon_2,\dots, \epsilon_{n-1}]^T, +\] +!et +and the matrix +!bt +\[ +\hat{X}= +\begin{bmatrix} +1& x_{0}^1 &x_{0}^2& \dots & \dots &x_{0}^{n-1}\\ +1& x_{1}^1 &x_{1}^2& \dots & \dots &x_{1}^{n-1}\\ +1& x_{2}^1 &x_{2}^2& \dots & \dots &x_{2}^{n-1}\\ +\dots& \dots &\dots& \dots & \dots &\dots\\ +1& x_{n-1}^1 &x_{n-1}^2& \dots & \dots &x_{n-1}^{n-1}\\ +\end{bmatrix} +\] +!et +we can rewrite our equations as +!bt +\[ +\hat{y} = \hat{X}\hat{\beta}+\hat{\epsilon}. +\] +!et + + + + +===== Generalizing the fitting procedure as a linear algebra problem ===== + +We are obviously not limited to the above polynomial. We could replace the various powers of $x$ with elements of Fourier series, that is, instead of $x_i^j$ we could have $\cos{(j x_i)}$ or $\sin{(j x_i)}$, or time series or other orthogonal functions. +For every set of values $y_i,x_i$ we can then generalize the equations to +!bt +\begin{align*} +y_0&=\beta_0x_{00}+\beta_1x_{01}+\beta_2x_{02}+\dots+\beta_{n-1}x_{0n-1}+\epsilon_0\\ +y_1&=\beta_0x_{10}+\beta_1x_{11}+\beta_2x_{12}+\dots+\beta_{n-1}x_{1n-1}+\epsilon_1\\ +y_2&=\beta_0x_{20}+\beta_1x_{21}+\beta_2x_{22}+\dots+\beta_{n-1}x_{2n-1}+\epsilon_2\\ +\dots & \dots \\ +y_{i}&=\beta_0x_{i0}+\beta_1x_{i1}+\beta_2x_{i2}+\dots+\beta_{n-1}x_{in-1}+\epsilon_i\\ +\dots & \dots \\ +y_{n-1}&=\beta_0x_{n-1,0}+\beta_1x_{n-1,2}+\beta_2x_{n-1,2}+\dots+\beta_1x_{n-1,n-1}+\epsilon_{n-1}.\\ +\end{align*} +!et + + + + +===== Generalizing the fitting procedure as a linear algebra problem ===== + +We redefine in turn the matrix $\hat{X}$ as +!bt +\[ +\hat{X}= +\begin{bmatrix} +x_{00}& x_{01} &x_{02}& \dots & \dots &x_{0,n-1}\\ +x_{10}& x_{11} &x_{12}& \dots & \dots &x_{1,n-1}\\ +x_{20}& x_{21} &x_{22}& \dots & \dots &x_{2,n-1}\\ +\dots& \dots &\dots& \dots & \dots &\dots\\ +x_{n-1,0}& x_{n-1,1} &x_{n-1,2}& \dots & \dots &x_{n-1,n-1}\\ +\end{bmatrix} +\] +!et +and without loss of generality we rewrite again our equations as +!bt +\[ +\hat{y} = \hat{X}\hat{\beta}+\hat{\epsilon}. +\] +!et +The left-hand side of this equation forms know. Our error vector $\hat{\epsilon}$ and the parameter vector $\hat{\beta}$ are our unknow quantities. How can we obtain the optimal set of $\beta_i$ values? + + + + +===== Optimizing our parameters ===== + +We have defined the matrix $\hat{X}$ +!bt +\begin{align*} +y_0&=\beta_0x_{00}+\beta_1x_{01}+\beta_2x_{02}+\dots+\beta_{n-1}x_{0n-1}+\epsilon_0\\ +y_1&=\beta_0x_{10}+\beta_1x_{11}+\beta_2x_{12}+\dots+\beta_{n-1}x_{1n-1}+\epsilon_1\\ +y_2&=\beta_0x_{20}+\beta_1x_{21}+\beta_2x_{22}+\dots+\beta_{n-1}x_{2n-1}+\epsilon_1\\ +\dots & \dots \\ +y_{i}&=\beta_0x_{i0}+\beta_1x_{i1}+\beta_2x_{i2}+\dots+\beta_{n-1}x_{in-1}+\epsilon_1\\ +\dots & \dots \\ +y_{n-1}&=\beta_0x_{n-1,0}+\beta_1x_{n-1,2}+\beta_2x_{n-1,2}+\dots+\beta_1x_{n-1,n-1}+\epsilon_{n-1}.\\ +\end{align*} +!et + + + + +===== Optimizing our parameters, more details ===== + +We well use this matrix to define the approximation $\hat{\tilde{y}}$ via the unknown quantity $\hat{\beta}$ as +!bt +\[ +\hat{\tilde{y}}= \hat{X}\hat{\beta}, +\] +!et +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 parametrized values $\tilde{y}_i$, namely +!bt +\[ +Q(\hat{\beta})=\sum_{i=0}^{n-1}\left(y_i-\tilde{y}_i\right)^2=\left(\hat{y}-\hat{\tilde{y}}\right)^T\left(\hat{y}-\hat{\tilde{y}}\right), +\] +!et +or using the matrix $\hat{X}$ as +!bt +\[ +Q(\hat{\beta})=\left(\hat{y}-\hat{X}\hat{\beta}\right)^T\left(\hat{y}-\hat{X}\hat{\beta}\right). +\] +!et + + + + +===== Interpretations and optimizing our parameters ===== + +The function +!bt +\[ +Q(\hat{\beta})=\left(\hat{y}-\hat{X}\hat{\beta}\right)^T\left(\hat{y}-\hat{X}\hat{\beta}\right), +\] +!et +can be linked to the variance of the quantity $y_i$ if we interpret the latter as the mean value of for example a numerical experiment. When linking below with the maximum likelihood approach below, we will indeed interpret $y_i$ as a mean value +!bt +\[ +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, +\] +!et +where $\langle y_i \rangle$ is the mean value. Keep in mind also that till now we have treated $y_i$ as the exact value. Normally, the response (dependent or outcome) variable $y_i$ the outcome of a numerical experiment or another type of experiment and is thus only an approximation to the true value. It is then always accompanied by an error estimate, often limited to a statistical error estimate given by the standard deviation discussed earlier. In the discussion here we will treat $y_i$ as our exact value for the response variable. + +In order to find the parameters $\beta_i$ we will then minimize the spread of $Q(\hat{\beta})$ by requiring +!bt +\[ +\frac{\partial Q(\hat{\beta})}{\partial \beta_j} = \frac{\partial }{\partial \beta_j}\left[ \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, +\] +!et +which results in +!bt +\[ +\frac{\partial Q(\hat{\beta})}{\partial \beta_j} = -2\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, +\] +!et +or in a matrix-vector form as +!bt +\[ +\frac{\partial Q(\hat{\beta})}{\partial \hat{\beta}} = 0 = \hat{X}^T\left( \hat{y}-\hat{X}\hat{\beta}\right). +\] +!et + + + + + + +===== Interpretations and optimizing our parameters ===== + +We can rewrite +!bt +\[ +\frac{\partial Q(\hat{\beta})}{\partial \hat{\beta}} = 0 = \hat{X}^T\left( \hat{y}-\hat{X}\hat{\beta}\right), +\] +!et +as +!bt +\[ +\hat{X}^T\hat{y} = \hat{X}^T\hat{X}\hat{\beta}, +\] +!et +and if the matrix $\hat{X}^T\hat{X}$ is invertible we have the solution +!bt +\[ +\hat{\beta} =\left(\hat{X}^T\hat{X}\right)^{-1}\hat{X}^T\hat{y}. +\] +!et + + + + +===== Interpretations and optimizing our parameters ===== + +The residuals $\hat{\epsilon}$ are in turn given by +!bt +\[ +\hat{\epsilon} = \hat{y}-\hat{\tilde{y}} = \hat{y}-\hat{X}\hat{\beta}, +\] +!et +and with +!bt +\[ +\hat{X}^T\left( \hat{y}-\hat{X}\hat{\beta}\right)= 0, +\] +!et +we have +!bt +\[ +\hat{X}^T\hat{\epsilon}=\hat{X}^T\left( \hat{y}-\hat{X}\hat{\beta}\right)= 0, +\] +!et +meaning that the solution for $\hat{\beta}$ is the one which minimizes the residuals. Later we will link this with the maximum likelihood approach. + + + + +===== The $\chi^2$ function ===== + + +Normally, the response (dependent or outcome) variable $y_i$ the outcome of a numerical experiment or another type of experiment and is thus only an approximation to the true value. It is then always accompanied by an error estimate, often limited to a statistical error estimate given by the standard deviation discussed earlier. In the discussion here we will treat $y_i$ as our exact value for the response variable. + +Introducing the standard deviation $\sigma_i$ for each measurement $y_i$, we define now the $\chi^2$ function as +!bt +\[ +\chi^2(\hat{\beta})=\sum_{i=0}^{n-1}\frac{\left(y_i-\tilde{y}_i\right)^2}{\sigma_i^2}=\left(\hat{y}-\hat{\tilde{y}}\right)^T\frac{1}{\hat{\Sigma^2}}\left(\hat{y}-\hat{\tilde{y}}\right), +\] +!et +where the matrix $\hat{\Sigma}$ is a diagonal matrix with $\sigma_i$ as matrix elements. + + + + +===== The $\chi^2$ function ===== + + +In order to find the parameters $\beta_i$ we will then minimize the spread of $\chi^2(\hat{\beta})$ by requiring +!bt +\[ +\frac{\partial \chi^2(\hat{\beta})}{\partial \beta_j} = \frac{\partial }{\partial \beta_j}\left[ \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, +\] +!et +which results in +!bt +\[ +\frac{\partial \chi^2(\hat{\beta})}{\partial \beta_j} = -2\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, +\] +!et +or in a matrix-vector form as +!bt +\[ +\frac{\partial \chi^2(\hat{\beta})}{\partial \hat{\beta}} = 0 = \hat{A}^T\left( \hat{b}-\hat{A}\hat{\beta}\right). +\] +!et +where we have defined the matrix $\hat{A} =\hat{X}/\hat{\Sigma}$ with matrix elements $a_{ij} = x_{ij}/\sigma_i$ and the vector $\hat{b}$ with elements $b_i = y_i/\sigma_i$. + + + +===== The $\chi^2$ function ===== + + +We can rewrite +!bt +\[ +\frac{\partial \chi^2(\hat{\beta})}{\partial \hat{\beta}} = 0 = \hat{A}^T\left( \hat{b}-\hat{A}\hat{\beta}\right), +\] +!et +as +!bt +\[ +\hat{A}^T\hat{b} = \hat{A}^T\hat{A}\hat{\beta}, +\] +!et +and if the matrix $\hat{A}^T\hat{A}$ is invertible we have the solution +!bt +\[ +\hat{\beta} =\left(\hat{A}^T\hat{A}\right)^{-1}\hat{A}^T\hat{b}. +\] +!et + + + +===== The $\chi^2$ function ===== + + +If we then introduce the matrix +!bt +\[ +\hat{H} = \hat{A}^T\hat{A}, +\] +!et +we have then the following expression for the parameters $\beta_j$ (the matrix elements of $\hat{H}$ are $h_{ij}$) +!bt +\[ +\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} +\] +!et +We state without proof the expression for the uncertainty in the parameters $\beta_j$ as +!bt +\[ +\sigma^2(\beta_j) = \sum_{i=0}^{n-1}\sigma_i^2\left( \frac{\partial \beta_j}{\partial y_i}\right)^2, +\] +!et +resulting in +!bt +\[ +\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}! +\] +!et + + + +===== The $\chi^2$ function ===== + +The first step here is to approximate the function $y$ with a first-order polynomial, that is we write +!bt +\[ +y=y(x) \rightarrow y(x_i) \approx \beta_0+\beta_1 x_i. +\] +!et +By computing the derivatives of $\chi^2$ with respect to $\beta_0$ and $\beta_1$ show that these are given by +!bt +\[ +\frac{\partial \chi^2(\hat{\beta})}{\partial \beta_0} = -2\left[ \sum_{i=0}^{1}\left(\frac{y_i-\beta_0-\beta_1x_{i}}{\sigma_i^2}\right)\right]=0, +\] +!et +and +!bt +\[ +\frac{\partial \chi^2(\hat{\beta})}{\partial \beta_0} = -2\left[ \sum_{i=0}^{1}x_i\left(\frac{y_i-\beta_0-\beta_1x_{i}}{\sigma_i^2}\right)\right]=0. +\] +!et + + + +===== The $\chi^2$ function ===== + + +We define then +!bt +\[ +\gamma = \sum_{i=0}^{1}\frac{1}{\sigma_i^2}, +\] +!et + +!bt +\[ +\gamma_x = \sum_{i=0}^{1}\frac{x_{i}}{\sigma_i^2}, +\] +!et +!bt +\[ +\gamma_y = \sum_{i=0}^{1}\left(\frac{y_i}{\sigma_i^2}\right), +\] +!et +!bt +\[ +\gamma_{xx} = \sum_{i=0}^{1}\frac{x_ix_{i}}{\sigma_i^2}, +\] +!et +!bt +\[ +\gamma_{xy} = \sum_{i=0}^{1}\frac{y_ix_{i}}{\sigma_i^2}, +\] +!et +and show that +!bt +\[ +\beta_0 = \frac{\gamma_{xx}\gamma_y-\gamma_x\gamma_y}{\gamma\gamma_{xx}-\gamma_x^2}, +\] +!et +!bt +\[ +\beta_1 = \frac{\gamma_{xy}\gamma-\gamma_x\gamma_y}{\gamma\gamma_{xx}-\gamma_x^2}. +\] +!et + +The LSM suffers often from both being underdetermined and overdetermined in the unknown coefficients $\beta_i$. A better approach is to use the Singular Value Decomposition (SVD) method discussed below. + + + + + +===== The singular value decompostion ===== + +How can we use the singular value decomposition to find the parameters $\beta_j$? More details will come. We first note that a general $m\times n$ matrix $\hat{A}$ can be written in terms of a diagonal matrix $\hat{\Sigma}$ of dimensionality $n\times n$ and two orthognal matrices $\hat{U}$ and $\hat{V}$, where the first has dimensionality $m \times n$ and the last dimensionality $n\times n$. We have then +!bt +\[ +\hat{A} = \hat{U}\hat{\Sigma}\hat{V} +\] +!et + + +======= Neural Networks ======= + +===== Artificial neurons ===== +The field of artificial neural networks has a long history of development, and is closely connected with +the advancement of computer science and computers in general. A model of artificial neurons +was first developed by McCulloch and Pitts in 1943 to study signal processing in the brain and +has later been refined by others. The general idea is to mimic neural networks in the human brain, which +is composed of billions of neurons that communicate with each other by sending electrical signals. +Each neuron accumulates its incoming signals, +which must exceed an activation threshold to yield an output. If the threshold is not overcome, the neuron +remains inactive, i.e. has zero output. + +This behaviour has inspired a simple mathematical model for an artificial neuron. + +!bt +\begin{equation} + y = f\left(\sum_{i=1}^n w_ix_i\right) = f(u) + label{artificialNeuron} +\end{equation} +!et +Here, the output $y$ of the neuron is the value of its activation function, which have as input +a weighted sum of signals $x_i, \dots ,x_n$ received by $n$ other neurons. + + +===== Neural network types ===== + +An artificial neural network (NN), is a computational model that consists of layers of connected neurons, or *nodes*. +It is supposed to mimic a biological nervous system by letting each neuron interact with other neurons +by sending signals in the form of mathematical functions between layers. +A wide variety of different NNs have +been developed, but most of them consist of an input layer, an output layer and eventual layers in-between, called +*hidden layers*. All layers can contain an arbitrary number of nodes, and each connection between two nodes +is associated with a weight variable. + + + + +===== Feed-forward neural networks ===== +The feed-forward neural network (FFNN) was the first and simplest type of NN devised. In this network, +the information moves in only one direction: forward through the layers. + +Nodes are represented by circles, while the arrows display the connections between the nodes, including the +direction of information flow. Additionally, each arrow corresponds to a weight variable, not displayed here. +We observe that each node in a layer is connected to *all* nodes in the subsequent layer, +making this a so-called *fully-connected* FFNN. + + + +A different variant of FFNNs are *convolutional neural networks* (CNNs), which have a connectivity pattern +inspired by the animal visual cortex. Individual neurons in the visual cortex only respond to stimuli from +small sub-regions of the visual field, called a receptive field. This makes the neurons well-suited to exploit the strong +spatially local correlation present in natural images. The response of each neuron can be approximated mathematically +as a convolution operation. + +CNNs emulate the behaviour of neurons in the visual cortex by enforcing a *local* connectivity pattern +between nodes of adjacent layers: Each node +in a convolutional layer is connected only to a subset of the nodes in the previous layer, +in contrast to the fully-connected FFNN. +Often, CNNs +consist of several convolutional layers that learn local features of the input, with a fully-connected layer at the end, +which gathers all the local data and produces the outputs. They have wide applications in image and video recognition + + +===== Recurrent neural networks ===== + +So far we have only mentioned NNs where information flows in one direction: forward. *Recurrent neural networks* on +the other hand, have connections between nodes that form directed *cycles*. This creates a form of +internal memory which are able to capture information on what has been calculated before; the output is dependent +on the previous computations. Recurrent NNs make use of sequential information by performing the same task for +every element in a sequence, where each element depends on previous elements. An example of such information is +sentences, making recurrent NNs especially well-suited for handwriting and speech recognition. + + +===== Other types of networks ===== + +There are many other kinds of NNs that have been developed. One type that is specifically designed for interpolation +in multidimensional space is the radial basis function (RBF) network. RBFs are typically made up of three layers: +an input layer, a hidden layer with non-linear radial symmetric activation functions and a linear output layer (''linear'' here +means that each node in the output layer has a linear activation function). The layers are normally fully-connected and +there are no cycles, thus RBFs can be viewed as a type of fully-connected FFNN. They are however usually treated as +a separate type of NN due the unusual activation functions. + + +Other types of NNs could also be mentioned, but are outside the scope of this work. We will now move on to a detailed description +of how a fully-connected FFNN works, and how it can be used to interpolate data sets. + + +===== Multilayer perceptrons ===== + +One use often so-called fully-connected feed-forward neural networks with three +or more layers (an input layer, one or more hidden layers and an output layer) +consisting of neurons that have non-linear activation functions. + +Such networks are often called *multilayer perceptrons* (MLPs) + + +===== Why multilayer perceptrons? ===== + +According to the *Universal approximation theorem*, a feed-forward neural network with just a single hidden layer containing +a finite number of neurons can approximate a continuous multidimensional function to arbitrary accuracy, +assuming the activation function for the hidden layer is a _non-constant, bounded and monotonically-increasing continuous function_. +Note that the requirements on the activation function only applies to the hidden layer, the output nodes are always +assumed to be linear, so as to not restrict the range of output values. + +We note that this theorem is only applicable to a NN with *one* hidden layer. +Therefore, we can easily construct an NN +that employs activation functions which do not satisfy the above requirements, as long as we have at least one layer +with activation functions that *do*. Furthermore, although the universal approximation theorem +lays the theoretical foundation for regression with neural networks, it does not say anything about how things work in practice: +A neural network can still be able to approximate a given function reasonably well without having the flexibility to fit *all other* +functions. + + + + +===== Mathematical model ===== + +!bt +\begin{equation} + y = f\left(\sum_{i=1}^n w_ix_i + b_i\right) = f(u) + label{artificialNeuron2} +\end{equation} +!et +In an FFNN of such neurons, the *inputs* $x_i$ +are the *outputs* of the neurons in the preceding layer. Furthermore, an MLP is fully-connected, +which means that each neuron receives a weighted sum of the outputs of *all* neurons in the previous layer. + + +===== Mathematical model ===== + +First, for each node $i$ in the first hidden layer, we calculate a weighted sum $u_i^1$ of the input coordinates $x_j$, + +!bt +\begin{equation} + u_i^1 = \sum_{j=1}^2 w_{ij}^1 x_j + b_i^1 +\end{equation} +!et +This value is the argument to the activation function $f_1$ of each neuron $i$, +producing the output $y_i^1$ of all neurons in layer 1, + +!bt +\begin{equation} + y_i^1 = f_1(u_i^1) = f_1\left(\sum_{j=1}^2 w_{ij}^1 x_j + b_i^1\right) + label{outputLayer1} +\end{equation} +!et +where we assume that all nodes in the same layer have identical activation functions, hence the notation $f_l$ + +!bt +\begin{equation} + y_i^l = f_l(u_i^l) = f_l\left(\sum_{j=1}^{N_{l-1}} w_{ij}^l y_j^{l-1} + b_i^l\right) + label{generalLayer} +\end{equation} +!et +where $N_l$ is the number of nodes in layer $l$. When the output of all the nodes in the first hidden layer are computed, +the values of the subsequent layer can be calculated and so forth until the output is obtained. + + + + +===== Mathematical model ===== + +The output of neuron $i$ in layer 2 is thus, + +!bt +\begin{align} + y_i^2 &= f_2\left(\sum_{j=1}^3 w_{ij}^2 y_j^1 + b_i^2\right) \\ + &= f_2\left[\sum_{j=1}^3 w_{ij}^2f_1\left(\sum_{k=1}^2 w_{jk}^1 x_k + b_j^1\right) + b_i^2\right] + label{outputLayer2} +\end{align} +!et +where we have substituted $y_m^1$ with. Finally, the NN output yields, + +!bt +\begin{align} + y_1^3 &= f_3\left(\sum_{j=1}^3 w_{1m}^3 y_j^2 + b_1^3\right) \\ + &= f_3\left[\sum_{j=1}^3 w_{1j}^3 f_2\left(\sum_{k=1}^3 w_{jk}^2 f_1\left(\sum_{m=1}^2 w_{km}^1 x_m + b_k^1\right) + b_j^2\right) + + b_1^3\right] +\end{align} +!et + + +===== Mathematical model ===== + +We can generalize this expression to an MLP with $l$ hidden layers. The complete functional form +is, +!bt +\begin{align} +&y^{l+1}_1\! = \!f_{l+1}\!\left[\!\sum_{j=1}^{N_l}\! w_{1j}^3 f_l\!\left(\!\sum_{k=1}^{N_{l-1}}\! w_{jk}^2 f_{l-1}\!\left(\! + \dots \!f_1\!\left(\!\sum_{n=1}^{N_0} \!w_{mn}^1 x_n\! + \!b_m^1\!\right) + \!\dots \!\right) \!+ \!b_k^2\!\right) + \!+ \!b_1^3\!\right] && + label{completeNN} +\end{align} +!et +which illustrates a basic property of MLPs: The only independent variables are the input values $x_n$. + + +===== Mathematical model ===== + +This confirms that an MLP, +despite its quite convoluted mathematical form, is nothing more than an analytic function, specifically a +mapping of real-valued vectors $\vec{x} \in \mathbb{R}^n \rightarrow \vec{y} \in \mathbb{R}^m$. +In our example, $n=2$ and $m=1$. Consequentially, +the number of input and output values of the function we want to fit must be equal to the number of inputs and outputs of our MLP. + +Furthermore, the flexibility and universality of a MLP can be illustrated by realizing that +the expression is essentially a nested sum of scaled activation functions of the form + +!bt +\begin{equation} + h(x) = c_1 f(c_2 x + c_3) + c_4 +\end{equation} +!et +where the parameters $c_i$ are weights and biases. By adjusting these parameters, the activation functions +can be shifted up and down or left and right, change slope or be rescaled +which is the key to the flexibility of a neural network. + + +=== Matrix-vector notation === +We can introduce a more convenient notation for the activations in a NN. + +Additionally, we can represent the biases and activations +as layer-wise column vectors $\vec{b}_l$ and $\vec{y}_l$, so that the $i$-th element of each vector +is the bias $b_i^l$ and activation $y_i^l$ of node $i$ in layer $l$ respectively. + +We have that $\mathrm{W}_l$ is a $N_{l-1} \times N_l$ matrix, while $\vec{b}_l$ and $\vec{y}_l$ are $N_l \times 1$ column vectors. +With this notation, the sum in becomes a matrix-vector multiplication, and we can write +the equation for the activations of hidden layer 2 in +!bt +\begin{equation} + \vec{y}_2 = f_2(\mathrm{W}_2 \vec{y}_{1} + \vec{b}_{2}) = + f_2\left(\left[\begin{array}{ccc} + w^2_{11} &w^2_{12} &w^2_{13} \\ + w^2_{21} &w^2_{22} &w^2_{23} \\ + w^2_{31} &w^2_{32} &w^2_{33} \\ + \end{array} \right] \cdot + \left[\begin{array}{c} + y^1_1 \\ + y^1_2 \\ + y^1_3 \\ + \end{array}\right] + + \left[\begin{array}{c} + b^2_1 \\ + b^2_2 \\ + b^2_3 \\ + \end{array}\right]\right). +\end{equation} +!et + + +=== Matrix-vector notation and activation === +The activation of node $i$ in layer 2 is + +!bt +\begin{equation} + y^2_i = f_2\Bigr(w^2_{i1}y^1_1 + w^2_{i2}y^1_2 + w^2_{i3}y^1_3 + b^2_i\Bigr) = + f_2\left(\sum_{j=1}^3 w^2_{ij} y_j^1 + b^2_i\right). +\end{equation} +!et +This is not just a convenient and compact notation, but also +a useful and intuitive way to think about MLPs: The output is calculated by a series of matrix-vector multiplications +and vector additions that are used as input to the activation functions. For each operation +$\mathrm{W}_l \vec{y}_{l-1}$ we move forward one layer. + + + +=== Activation functions === + + +A property that characterizes a neural network, other than its connectivity, is the choice of activation function(s). +As described in, the following restrictions are imposed on an activation function for a FFNN +to fulfill the universal approximation theorem + + * Non-constant + + * Bounded + + * Monotonically-increasing + + * Continuous + + +=== Activation functions, Logistic and Hyperbolic ones === + +The second requirement excludes all linear functions. Furthermore, in a MLP with only linear activation functions, each +layer simply performs a linear transformation of its inputs. + +Regardless of the number of layers, +the output of the NN will be nothing but a linear function of the inputs. Thus we need to introduce some kind of +non-linearity to the NN to be able to fit non-linear functions +Typical examples are the logistic *Sigmoid* +!bt +\begin{equation} + f(x) = \frac{1}{1 + e^{-x}}, + label{sigmoidActivationFunction} +\end{equation} +!et +and the *hyperbolic tangent* function +!bt +\begin{equation} + f(x) = \tanh(x) + label{tanhActivationFunction} +\end{equation} +!et + + +=== Relevance === +The *sigmoid* function are more biologically plausible because +the output of inactive neurons are zero. Such activation function are called *one-sided*. However, +it has been shown that the hyperbolic tangent +performs better than the sigmoid for training MLPs. +has become the most popular for *deep neural networks* + + + + + + + + + + + + + + + + + + + + + diff --git a/doc/LectureNotes/book.ipynb b/doc/LectureNotes/book.ipynb new file mode 100644 index 000000000..f4c3ff2aa --- /dev/null +++ b/doc/LectureNotes/book.ipynb @@ -0,0 +1,7919 @@ +{ + "cells": [ + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "\n", + "# 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: **Jan 27, 2018**\n", + "\n", + "Copyright 1999-2018, Morten Hjorth-Jensen. Released under CC Attribution-NonCommercial 4.0 license\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "# What is Machine Learning?\n", + "\n", + "Machine learning is the science of giving computers the ability to\n", + "learn without being explicitly programmed. The idea is that there\n", + "exist generic algorithms which can be used to find patterns in a broad\n", + "class of data sets without having to write code specifically for each\n", + "problem. The algorithm will build its own logic based on the data.\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. It has also, especially in later\n", + "years, found applications in a wide variety of other areas, including\n", + "bioinformatics, economy, physics, finance and marketing.\n", + "\n", + "\n", + "## Types of Machine Learning\n", + "\n", + "\n", + "The approaches to machine learning are many, but are often split into two main categories. \n", + "In *supervised learning* we know the answer to a problem,\n", + "and let the computer deduce the logic behind it. On the other hand, *unsupervised learning*\n", + "is a method for finding patterns and relationship in data sets without any prior knowledge of the system.\n", + "Some authours also operate with a third category, namely *reinforcement learning*. This is a paradigm \n", + "of learning inspired by behavioural 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 desired output of a system.\n", + "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", + "## Different algorithms\n", + "In this course we will build our machine learning approach on a statistical foundation, with elements \n", + "from data analysis, stochastic processes etc before we proceed with the following machine learning algorithms\n", + "\n", + "1. Linear regression and its variants\n", + "\n", + "2. Decision tree algorithms, from simpler to more complex ones\n", + "\n", + "3. Nearest neighbors models\n", + "\n", + "4. Bayesian statistics \n", + "\n", + "5. Support vector machines and finally various variants of\n", + "\n", + "6. Artifical neural networks\n", + "\n", + "Before we proceed however, there are several practicalities with data analysis and software tools we would \n", + "like to present. These tools will help us in our understanding of various machine learning algorithms. \n", + "\n", + "Our emphasis here is on understanding the mathematical aspects of different algorithms, however, where possible \n", + "we will emphasize the importance of using available software. \n", + "\n", + "\n", + "\n", + "## Software and needed installations\n", + "We will make intensive use of python as programming language and the myriad of available libraries. \n", + "Furthermore, you will find IPython/Jupyter notebooks invaluable in your work. \n", + "You can run **R** codes in the Jupyter/IPython notebooks, with the immediate benefit of visualizing your data.\n", + "\n", + "\n", + "If you have Python installed (we recommend Python3) and you feel pretty familiar with installing different packages, \n", + "we recommend that you install the following Python packages via **pip** as\n", + "1. pip install numpy scipy matplotlib ipython scikit-learn mglearn sympy pandas pillow\n", + "\n", + "For Python3, replace **pip** with **pip3**.\n", + "\n", + "For OSX users we recommend also, after having installed Xcode, to install **brew**. Brew allows \n", + "for a seamless installation of additional software via for example\n", + "1. brew install python3\n", + "\n", + "For Linux users, with its variety of distributions like for example the widely popular Ubuntu distribution\n", + "you can use **pip** as well and simply install Python as \n", + "1. sudo apt-get install python3 (or python for pyhton2.7)\n", + "\n", + "etc etc. \n", + "\n", + "\n", + "## Python installers\n", + "If you don't want to perform these operations separately, we recommend two widely used distrubutions which set up \n", + "all relevant dependencies for Python, namely\n", + "1. [Anaconda](https://docs.anaconda.com/) Anaconda is an open source distribution of the Python and R programming languages for large-scale data processing, predictive analytics, and scientific computing, that aims to simplify package management and deployment. Package versions are managed by the package management system **conda**\n", + "\n", + "2. [Enthought canopy](https://www.enthought.com/product/canopy/) is a Python distribution for scientific and analytic computing distribution and analysis environment, available for free and under a commercial license.\n", + "\n", + "## Installing R, C++, cython or Julia\n", + "\n", + "You will also find it convenient to utilize R. \n", + "Jupyter/Ipython notebook allows you run **R** code interactively in your browser. The software library **R** is \n", + "tuned to statistically analysis and allows for an easy usage of the tools we will discuss in these texts.\n", + "\n", + "To install **R** with Jupyter notebook [following the link here](https://mpacer.org/maths/r-kernel-for-ipython-notebook)\n", + "\n", + "\n", + "\n", + "\n", + "## Installing R, C++, cython or Julia\n", + "\n", + "\n", + "For the C++ affecianodas, Jupyter/IPython notebook allows you also to install C++ and run codes written in this language \n", + "interactively in the browser. Since we will emphasize writing many of the algorithms yourself, you can thus opt for\n", + "either Python or C++ as programming languages. \n", + "\n", + "To add more entropy, **cython** can also be used when running your notebooks. It means that Python with the Jupyter/IPython notebook \n", + "setup allows you to integrate widely popular softwares and tools for scientific computing. With its versatility, \n", + "including symbolic operations, Python offers a unique computational environment. Your Jupyter/IPython notebook \n", + "can easily be converted into a nicely rendered **PDF** file or a Latex file for further processing. For example, convert to latex as" + ] + }, + { + "cell_type": "code", + "execution_count": 1, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "jupyter nbconvert filename.ipynb --to latex" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "If you use the light mark-up language **doconce** you can convert a standard ascii text file into various HTML \n", + "formats, ipython notebooks, latex files, pdf files etc. \n", + "\n", + "\n", + "\n", + "\n", + "## Introduction to Jupyter notebook and available tools" + ] + }, + { + "cell_type": "code", + "execution_count": 2, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "%matplotlib inline\n", + "\n", + "import numpy as np\n", + "import matplotlib.pyplot as plt\n", + "from scipy import sparse\n", + "import pandas as pd\n", + "from IPython.display import display\n", + "eye = np.eye(4)\n", + "print(eye)\n", + "sparse_mtx = sparse.csr_matrix(eye)\n", + "print(sparse_mtx)\n", + "x = np.linspace(-10,10,100)\n", + "y = np.sin(x)\n", + "plt.plot(x,y,marker='x')\n", + "plt.show()\n", + "data = {'Name': [\"John\", \"Anna\", \"Peter\", \"Linda\"], 'Location': [\"Nairobi\", \"Napoli\", \"London\", \"Buenos Aires\"], 'Age':[51, 21, 34, 45]}\n", + "data_pandas = pd.DataFrame(data)\n", + "display(data_pandas)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Representing data, more examples" + ] + }, + { + "cell_type": "code", + "execution_count": 3, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "import numpy as np\n", + "import matplotlib.pyplot as plt\n", + "from scipy import sparse\n", + "import pandas as pd\n", + "from IPython.display import display\n", + "import mglearn\n", + "import sklearn\n", + "from sklearn.linear_model import LinearRegression\n", + "from sklearn.tree import DecisionTreeRegressor\n", + "x, y = mglearn.datasets.make_wave(n_samples=100)\n", + "line = np.linspace(-3,3,1000,endpoint=False).reshape(-1,1)\n", + "reg = DecisionTreeRegressor(min_samples_split=3).fit(x,y)\n", + "plt.plot(line, reg.predict(line), label=\"decision tree\")\n", + "regline = LinearRegression().fit(x,y)\n", + "plt.plot(line, regline.predict(line), label= \"Linear Rgression\")\n", + "plt.show()" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Predator-Prey model from ecology\n", + "\n", + "\n", + "The population dynamics of a simple predator-prey system is a\n", + "classical example shown in many biology textbooks when ecological\n", + "systems are discussed. The system contains all elements of the\n", + "scientific method:\n", + "\n", + " * The set up of a specific hypothesis combined with\n", + "\n", + " * the experimental methods needed (one can study existing data or perform experiments)\n", + "\n", + " * analyzing and interpreting the data and performing further experiments if needed\n", + "\n", + " * trying to extract general behaviors and extract eventual laws or patterns\n", + "\n", + " * develop mathematical relations for the uncovered regularities/laws and test these by per forming new experiments\n", + "\n", + "## Case study from Hudson bay\n", + "\n", + "\n", + "Lots of data about populations of hares and lynx collected from furs in Hudson Bay, Canada, are available. It is known that the populations oscillate. Why?\n", + "Here we start by\n", + "\n", + "1. plotting the data\n", + "\n", + "2. derive a simple model for the population dynamics\n", + "\n", + "3. (fitting parameters in the model to the data)\n", + "\n", + "4. using the model predict the evolution other predator-pray systems\n", + "\n", + "## Hudson bay data\n", + "\n", + "\n", + "\n", + "\n", + "Most mammalian predators rely on a variety of prey, which complicates mathematical modeling; however, a few predators have become highly specialized and seek almost exclusively a single prey species. An example of this simplified predator-prey interaction is seen in Canadian northern forests, where the populations of the lynx and the snowshoe hare are intertwined in a life and death struggle.\n", + "\n", + "One reason that this particular system has been so extensively studied is that the Hudson Bay company kept careful records of all furs from the early 1800s into the 1900s. The records for the furs collected by the Hudson Bay company showed distinct oscillations (approximately 12 year periods), suggesting that these species caused almost periodic fluctuations of each other's populations. The table here shows data from 1900 to 1920.\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "
Year Hares (x1000) Lynx (x1000)
1900 30.0 4.0
1901 47.2 6.1
1902 70.2 9.8
1903 77.4 35.2
1904 36.3 59.4
1905 20.6 41.7
1906 18.1 19.0
1907 21.4 13.0
1908 22.0 8.3
1909 25.4 9.1
1910 27.1 7.4
1911 40.3 8.0
1912 57 12.3
1913 76.6 19.5
1914 52.3 45.7
1915 19.5 51.1
1916 11.2 29.7
1917 7.6 15.8
1918 14.6 9.7
1919 16.2 10.1
1920 24.7 8.6
\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "## Plotting the data" + ] + }, + { + "cell_type": "code", + "execution_count": 4, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "import numpy as np\n", + "from matplotlib import pyplot as plt\n", + "\n", + "# Load in data file\n", + "data = np.loadtxt('src/Hudson_Bay.csv', delimiter=',', skiprows=1)\n", + "# Make arrays containing x-axis and hares and lynx populations\n", + "year = data[:,0]\n", + "hares = data[:,1]\n", + "lynx = data[:,2]\n", + "\n", + "plt.plot(year, hares ,'b-+', year, lynx, 'r-o')\n", + "plt.axis([1900,1920,0, 100.0])\n", + "plt.xlabel(r'Year')\n", + "plt.ylabel(r'Numbers of hares and lynx ')\n", + "plt.legend(('Hares','Lynx'), loc='upper right')\n", + "plt.title(r'Population of hares and lynx from 1900-1920 (x1000)}')\n", + "plt.savefig('Hudson_Bay_data.pdf')\n", + "plt.savefig('Hudson_Bay_data.png')\n", + "plt.show()" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Hares and lynx in Hudson bay from 1900 to 1920\n", + "\n", + "\n", + "\n", + "\n", + "

\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "## Why now create a computer model for the hare and lynx populations?\n", + "\n", + "We see from the plot that there are indeed fluctuations.\n", + "We would like to create a mathematical model that explains these\n", + "population fluctuations. Ecologists have predicted that in a simple\n", + "predator-prey system that a rise in prey population is followed (with\n", + "a lag) by a rise in the predator population. When the predator\n", + "population is sufficiently high, then the prey population begins\n", + "dropping. After the prey population falls, then the predator\n", + "population falls, which allows the prey population to recover and\n", + "complete one cycle of this interaction. Thus, we see that\n", + "qualitatively oscillations occur. Can a mathematical model predict\n", + "this? What causes cycles to slow or speed up? What affects the\n", + "amplitude of the oscillation or do you expect to see the oscillations\n", + "damp to a stable equilibrium? The models tend to ignore factors like\n", + "climate and other complicating factors. How significant are these?\n", + "\n", + " * We see oscillations in the data\n", + "\n", + " * What causes cycles to slow or speed up?\n", + "\n", + " * What affects the amplitude of the oscillation or do you expect to see the oscillations damp to a stable equilibrium?\n", + "\n", + " * With a model we can better *understand the data*\n", + "\n", + " * More important: we can understand the ecology dynamics of\n", + " predator-pray populations\n", + "\n", + "## The traditional (top-down) approach\n", + "\n", + "\n", + "The classical way (in all books) is to present the Lotka-Volterra equations:" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\begin{align*}\n", + "\\frac{dH}{dt} &= H(a - b L)\\\\\n", + "\\frac{dL}{dt} &= - L(d - c H)\n", + "\\end{align*}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Here,\n", + "\n", + " * $H$ is the number of preys\n", + "\n", + " * $L$ the number of predators\n", + "\n", + " * $a$, $b$, $d$, $c$ are parameters\n", + "\n", + "Most books quickly establish the model and then use considerable space on\n", + "discussing the qualitative properties of this *nonlinear system of\n", + "ODEs* (which cannot be solved)\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "## Basic mathematics notation\n", + "\n", + " * Time points: $t_0,t_1,\\ldots,t_m$\n", + "\n", + " * Uniform distribution of time points: $t_n=n\\Delta t$\n", + "\n", + " * $H^n$: population of hares at time $t_n$\n", + "\n", + " * $L^n$: population of lynx at time $t_n$\n", + "\n", + " * We want to model the changes in populations, $\\Delta H=H^{n+1}-H^n$\n", + " and $\\Delta L=L^{n+1}-L^n$ during a general time interval $[t_{n+1},t_n]$\n", + " of length $\\Delta t=t_{n+1}-t_n$\n", + "\n", + "## Basic dynamics of the population of hares\n", + "\n", + "\n", + "The population of hares evolves due to births and deaths exactly as a bacteria population:" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\Delta H = a \\Delta t H^n\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "However, hares have an additional loss in the population because\n", + "they are eaten by lynx.\n", + "All the hares and lynx can form\n", + "$H\\cdot L$ pairs in total. When such pairs meet during a time\n", + "interval $\\Delta t$, there is some\n", + "small probablity that the lynx will eat the hare.\n", + "So in fraction $b\\Delta t HL$, the lynx eat hares. This\n", + "loss of hares must be accounted for. Subtracted in the equation for hares:" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\Delta H = a\\Delta t H^n - b \\Delta t H^nL^n\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Basic dynamics of the population of lynx\n", + "\n", + "\n", + "We assume that the primary growth for the lynx population depends on sufficient food for raising lynx kittens, which implies an adequate source of nutrients from predation on hares. Thus, the growth of the lynx population does not only depend of how many lynx there are, but on how many hares they can eat.\n", + "In a time interval $\\Delta t HL$ hares and lynx can meet, and in a\n", + "fraction $b\\Delta t HL$ the lynx eats the hare. All of this does not\n", + "contribute to the growth of lynx, again just a fraction of\n", + "$b\\Delta t HL$ that we write as\n", + "$d\\Delta t HL$. In addition, lynx die just as in the population\n", + "dynamics with one isolated animal population, leading to a loss\n", + "$-c\\Delta t L$.\n", + "\n", + "\n", + "\n", + "The accounting of lynx then looks like" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\Delta L = d\\Delta t H^nL^n - c\\Delta t L^n\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Evolution equations\n", + "\n", + "\n", + "By writing up the definition of $\\Delta H$ and $\\Delta L$, and putting\n", + "all assumed known terms $H^n$ and $L^n$ on the right-hand side, we have" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "H^{n+1} = H^n + a\\Delta t H^n - b\\Delta t H^n L^n\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "L^{n+1} = L^n + d\\Delta t H^nL^n - c\\Delta t L^n\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Note:\n", + "\n", + " * These equations are ready to be implemented!\n", + "\n", + " * But to start, we need $H^0$ and $L^0$ \n", + " (which we can get from the data)\n", + "\n", + " * We also need values for $a$, $b$, $d$, $c$\n", + "\n", + "## Adapt the model to the Hudson Bay case\n", + "\n", + "\n", + " * As always, models tend to be general - as here, applicable\n", + " to \"all\" predator-pray systems\n", + "\n", + " * The critical issue is whether the *interaction* between hares and lynx\n", + " is sufficiently well modeled by $\\hbox{const}HL$\n", + "\n", + " * The parameters $a$, $b$, $d$, and $c$ must be\n", + " estimated from data\n", + "\n", + " * Measure time in years\n", + "\n", + " * $t_0=1900$, $t_m=1920$\n", + "\n", + "## The program" + ] + }, + { + "cell_type": "code", + "execution_count": 5, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "import numpy as np\n", + "import matplotlib.pyplot as plt\n", + "\n", + "def solver(m, H0, L0, dt, a, b, c, d, t0):\n", + " \"\"\"Solve the difference equations for H and L over m years\n", + " with time step dt (measured in years.\"\"\"\n", + "\n", + " num_intervals = int(m/float(dt))\n", + " t = np.linspace(t0, t0 + m, num_intervals+1)\n", + " H = np.zeros(t.size)\n", + " L = np.zeros(t.size)\n", + "\n", + " print('Init:', H0, L0, dt)\n", + " H[0] = H0\n", + " L[0] = L0\n", + "\n", + " for n in range(0, len(t)-1):\n", + " H[n+1] = H[n] + a*dt*H[n] - b*dt*H[n]*L[n]\n", + " L[n+1] = L[n] + d*dt*H[n]*L[n] - c*dt*L[n]\n", + " return H, L, t\n", + "\n", + "# Load in data file\n", + "data = np.loadtxt('src/Hudson_Bay.csv', delimiter=',', skiprows=1)\n", + "# Make arrays containing x-axis and hares and lynx populations\n", + "t_e = data[:,0]\n", + "H_e = data[:,1]\n", + "L_e = data[:,2]\n", + "\n", + "# Simulate using the model\n", + "H, L, t = solver(m=20, H0=34.91, L0=3.857, dt=0.1,\n", + " a=0.4807, b=0.02482, c=0.9272, d=0.02756,\n", + " t0=1900)\n", + "\n", + "# Visualize simulations and data\n", + "plt.plot(t_e, H_e, 'b-+', t_e, L_e, 'r-o', t, H, 'm--', t, L, 'k--')\n", + "plt.xlabel('Year')\n", + "plt.ylabel('Numbers of hares and lynx')\n", + "plt.axis([1900, 1920, 0, 140])\n", + "plt.title(r'Population of hares and lynx 1900-1920 (x1000)')\n", + "plt.legend(('H_e', 'L_e', 'H', 'L'), loc='upper left')\n", + "plt.savefig('Hudson_Bay_sim.pdf')\n", + "plt.savefig('Hudson_Bay_sim.png')\n", + "plt.show()" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## The plot\n", + "\n", + "\n", + "\n", + "\n", + "

\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "If we perform a least-square fitting, we can find optimal values for the parameters $a$, $b$, $d$, $c$. The optimal parameters are $a=0.4807$, $b=0.02482$, $d=0.9272$ and $c=0.02756$. These parameters result in a slightly modified initial conditions, namely $H(0) = 34.91$ and $L(0)=3.857$. With these parameters we are now ready to solve the equations and plot these data together with the experimental values.\n", + "\n", + "\n", + "\n", + "## Linear regression in Python" + ] + }, + { + "cell_type": "code", + "execution_count": 6, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "import numpy as np\n", + "import matplotlib.pyplot as plt\n", + "from IPython.display import display\n", + "import sklearn\n", + "from sklearn.linear_model import LinearRegression\n", + "from sklearn.tree import DecisionTreeRegressor\n", + "\n", + "\n", + "data = np.loadtxt('src/Hudson_Bay.csv', delimiter=',', skiprows=1)\n", + "x = data[:,0]\n", + "y = data[:,1]\n", + "line = np.linspace(1900,1920,1000,endpoint=False).reshape(-1,1)\n", + "reg = DecisionTreeRegressor(min_samples_split=3).fit(x.reshape(-1,1),y.reshape(-1,1))\n", + "plt.plot(line, reg.predict(line), label=\"decision tree\")\n", + "regline = LinearRegression().fit(x.reshape(-1,1),y.reshape(-1,1))\n", + "plt.plot(line, regline.predict(line), label= \"Linear Regression\")\n", + "plt.plot(x, y, label= \"Linear Regression\")\n", + "plt.show()" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Linear Least squares in R" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + " HudsonBay = read.csv(\"src/Hudson_Bay.csv\",header=T)\n", + " fix(HudsonBay)\n", + " dim(HudsonBay)\n", + " names(HudsonBay)\n", + " plot(HudsonBay$Year, HudsonBay$Hares..x1000.)\n", + " attach(HudsonBay)\n", + " plot(Year, Hares..x1000.)\n", + " plot(Year, Hares..x1000., col=\"red\", varwidth=T, xlab=\"Years\", ylab=\"Haresx 1000\")\n", + " summary(HudsonBay)\n", + " summary(Hares..x1000.)\n", + " library(MASS)\n", + " library(ISLR)\n", + " scatter.smooth(x=Year, y = Hares..x1000.)\n", + " linearMod = lm(Hares..x1000. ~ Year)\n", + " print(linearMod)\n", + " summary(linearMod)\n", + " plot(linearMod)\n", + " confint(linearMod)\n", + " predict(linearMod,data.frame(Year=c(1910,1914,1920)),interval=\"confidence\")\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Non-Linear Least squares in R" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + " set.seed(1485)\n", + " len = 24\n", + " x = runif(len)\n", + " y = x^3+rnorm(len, 0,0.06)\n", + " ds = data.frame(x = x, y = y)\n", + " str(ds)\n", + " plot( y ~ x, main =\"Known cubic with noise\")\n", + " s = seq(0,1,length =100)\n", + " lines(s, s^3, lty =2, col =\"green\")\n", + " m = nls(y ~ I(x^power), data = ds, start = list(power=1), trace = T)\n", + " class(m)\n", + " summary(m)\n", + " power = round(summary(m)$coefficients[1], 3)\n", + " power.se = round(summary(m)$coefficients[2], 3)\n", + " plot(y ~ x, main = \"Fitted power model\", sub = \"Blue: fit; green: known\")\n", + " s = seq(0, 1, length = 100)\n", + " lines(s, s^3, lty = 2, col = \"green\")\n", + " lines(s, predict(m, list(x = s)), lty = 1, col = \"blue\")\n", + " text(0, 0.5, paste(\"y =x^ (\", power, \" +/- \", power.se, \")\", sep = \"\"), pos = 4)\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# Important Matrix and vector handling packages\n", + "\n", + "The Numerical Recipes codes have been rewritten in Fortran 90/95 and\n", + "C/C++ by us. The original source codes are taken from the widely used\n", + "software package LAPACK, which follows two other popular packages\n", + "developed in the 1970s, namely EISPACK and LINPACK.\n", + "\n", + " * LINPACK: package for linear equations and least square problems.\n", + "\n", + " * LAPACK:package for solving symmetric, unsymmetric and generalized eigenvalue problems. From LAPACK's website it is possible to download for free all source codes from this library. Both C/C++ and Fortran versions are available.\n", + "\n", + " * BLAS (I, II and III): (Basic Linear Algebra Subprograms) are routines that provide standard building blocks for performing basic vector and matrix operations. Blas I is vector operations, II vector-matrix operations and III matrix-matrix operations. Highly parallelized and efficient codes, all available for download from .\n", + "\n", + "**Add python material on linear algebra and array handling, text on numpy etc**\n", + "\n", + "\n", + "## Basic Matrix Features\n", + "\n", + " Matrix properties reminder" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathbf{A} =\n", + " \\begin{bmatrix} a_{11} & a_{12} & a_{13} & a_{14} \\\\\n", + " a_{21} & a_{22} & a_{23} & a_{24} \\\\\n", + " a_{31} & a_{32} & a_{33} & a_{34} \\\\\n", + " a_{41} & a_{42} & a_{43} & a_{44}\n", + " \\end{bmatrix}\\qquad\n", + "\\mathbf{I} =\n", + " \\begin{bmatrix} 1 & 0 & 0 & 0 \\\\\n", + " 0 & 1 & 0 & 0 \\\\\n", + " 0 & 0 & 1 & 0 \\\\\n", + " 0 & 0 & 0 & 1\n", + " \\end{bmatrix}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Basic Matrix Features\n", + "\n", + "The inverse of a matrix is defined by" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathbf{A}^{-1} \\cdot \\mathbf{A} = I\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Basic Matrix Features\n", + "\n", + " Matrix Properties Reminder\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "
Relations Name matrix elements
$A = A^{T}$ symmetric $a_{ij} = a_{ji}$
$A = \\left (A^{T} \\right )^{-1}$ real orthogonal $\\sum_k a_{ik} a_{jk} = \\sum_k a_{ki} a_{kj} = \\delta_{ij}$
$A = A^{ * }$ real matrix $a_{ij} = a_{ij}^{ * }$
$A = A^{\\dagger}$ hermitian $a_{ij} = a_{ji}^{ * }$
$A = \\left (A^{\\dagger} \\right )^{-1}$ unitary $\\sum_k a_{ik} a_{jk}^{ * } = \\sum_k a_{ki}^{ * } a_{kj} = \\delta_{ij}$
\n", + "\n", + "\n", + "\n", + "## Some famous Matrices\n", + "\n", + " * Diagonal if $a_{ij}=0$ for $i\\ne j$\n", + "\n", + " * Upper triangular if $a_{ij}=0$ for $i > j$\n", + "\n", + " * Lower triangular if $a_{ij}=0$ for $i < j$\n", + "\n", + " * Upper Hessenberg if $a_{ij}=0$ for $i > j+1$\n", + "\n", + " * Lower Hessenberg if $a_{ij}=0$ for $i < j+1$\n", + "\n", + " * Tridiagonal if $a_{ij}=0$ for $|i -j| > 1$\n", + "\n", + " * Lower banded with bandwidth $p$: $a_{ij}=0$ for $i > j+p$\n", + "\n", + " * Upper banded with bandwidth $p$: $a_{ij}=0$ for $i < j+p$\n", + "\n", + " * Banded, block upper triangular, block lower triangular....\n", + "\n", + "## Basic Matrix Features\n", + "\n", + " Some Equivalent Statements\n", + "For an $N\\times N$ matrix $\\mathbf{A}$ the following properties are all equivalent\n", + "\n", + " * If the inverse of $\\mathbf{A}$ exists, $\\mathbf{A}$ is nonsingular.\n", + "\n", + " * The equation $\\mathbf{Ax}=0$ implies $\\mathbf{x}=0$.\n", + "\n", + " * The rows of $\\mathbf{A}$ form a basis of $R^N$.\n", + "\n", + " * The columns of $\\mathbf{A}$ form a basis of $R^N$.\n", + "\n", + " * $\\mathbf{A}$ is a product of elementary matrices.\n", + "\n", + " * $0$ is not eigenvalue of $\\mathbf{A}$.\n", + "\n", + "## Matrix Handling in C/C++, Static and Dynamical allocation\n", + "\n", + " Static\n", + "We have an $N\\times N$ matrix A with $N=100$\n", + "In C/C++ this would be defined as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + " int N = 100;\n", + " double A[100][100];\n", + " // initialize all elements to zero\n", + " for(i=0 ; i < N ; i++) {\n", + " for(j=0 ; j < N ; j++) {\n", + " A[i][j] = 0.0;\n", + " \n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Note the way the matrix is organized, row-major order.\n", + "\n", + "\n", + "\n", + "## Matrix Handling in C/C++\n", + "\n", + " Row Major Order, Addition\n", + "We have $N\\times N$ matrices A, B and C and we wish to\n", + "evaluate $A=B+C$." + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathbf{A}= \\mathbf{B}\\pm\\mathbf{C} \\Longrightarrow a_{ij} = b_{ij}\\pm c_{ij},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "In C/C++ this would be coded like" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + " for(i=0 ; i < N ; i++) {\n", + " for(j=0 ; j < N ; j++) {\n", + " a[i][j] = b[i][j]+c[i][j]\n", + " \n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Matrix Handling in C/C++\n", + "\n", + " Row Major Order, Multiplication\n", + "We have $N\\times N$ matrices A, B and C and we wish to\n", + "evaluate $A=BC$." + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathbf{A}=\\mathbf{BC} \\Longrightarrow a_{ij} = \\sum_{k=1}^{n} b_{ik}c_{kj},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "In C/C++ this would be coded like" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + " for(i=0 ; i < N ; i++) {\n", + " for(j=0 ; j < N ; j++) {\n", + " for(k=0 ; k < N ; k++) {\n", + " a[i][j]+=b[i][k]*c[k][j];\n", + " \n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Dynamic memory allocation in C/C++\n", + "\n", + "At least three possibilities in this course\n", + "\n", + " * Do it yourself\n", + "\n", + " * Use the functions provided in the library package lib.cpp\n", + "\n", + " * Use Armadillo (a C++ linear algebra library, discussion both here and at lab). \n", + "\n", + "## Matrix Handling in C/C++, Dynamic Allocation\n", + "\n", + " Do it yourself" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + " int N;\n", + " double ** A;\n", + " A = new double*[N]\n", + " for ( i = 0; i < N; i++)\n", + " A[i] = new double[N];\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Always free space when you don't need an array anymore." + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + " for ( i = 0; i < N; i++)\n", + " delete[] A[i];\n", + " delete[] A;\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Armadillo, recommended!!\n", + "\n", + " * Armadillo is a C++ linear algebra library (matrix maths) aiming towards a good balance between speed and ease of use. The syntax is deliberately similar to Matlab.\n", + "\n", + " * Integer, floating point and complex numbers are supported, as well as a subset of trigonometric and statistics functions. Various matrix decompositions are provided through optional integration with LAPACK, or one of its high performance drop-in replacements (such as the multi-threaded MKL or ACML libraries).\n", + "\n", + " * A delayed evaluation approach is employed (at compile-time) to combine several operations into one and reduce (or eliminate) the need for temporaries. This is accomplished through recursive templates and template meta-programming.\n", + "\n", + " * Useful for conversion of research code into production environments, or if C++ has been decided as the language of choice, due to speed and/or integration capabilities.\n", + "\n", + " * The library is open-source software, and is distributed under a license that is useful in both open-source and commercial/proprietary contexts.\n", + "\n", + "## Armadillo, simple examples" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + " #include \n", + " #include \n", + " \n", + " using namespace std;\n", + " using namespace arma;\n", + " \n", + " int main(int argc, char** argv)\n", + " {\n", + " mat A = randu(5,5);\n", + " mat B = randu(5,5);\n", + " \n", + " cout << A*B << endl;\n", + " \n", + " return 0;\n", + " \n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Armadillo, how to compile and install\n", + "\n", + "For people using Ubuntu, Debian, Linux Mint, simply go to the synaptic package manager and install\n", + "armadillo from there.\n", + "You may have to install Lapack as well.\n", + "For Mac and Windows users, follow the instructions from the webpage\n", + ".\n", + "To compile, use for example (linux/ubuntu)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + " c++ -O2 -o program.x program.cpp -larmadillo -llapack -lblas\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "where the `-l` option indicates the library you wish to link to.\n", + "\n", + "For OS X users you may have to declare the paths to the include files and the libraries as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + " c++ -O2 -o program.x program.cpp -L/usr/local/lib -I/usr/local/include -larmadillo -llapack -lblas\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Armadillo, simple examples" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + " #include \n", + " #include \"armadillo\"\n", + " using namespace arma;\n", + " using namespace std;\n", + " \n", + " int main(int argc, char** argv)\n", + " {\n", + " // directly specify the matrix size (elements are uninitialised)\n", + " mat A(2,3);\n", + " // .n_rows = number of rows (read only)\n", + " // .n_cols = number of columns (read only)\n", + " cout << \"A.n_rows = \" << A.n_rows << endl;\n", + " cout << \"A.n_cols = \" << A.n_cols << endl;\n", + " // directly access an element (indexing starts at 0)\n", + " A(1,2) = 456.0;\n", + " A.print(\"A:\");\n", + " // scalars are treated as a 1x1 matrix,\n", + " // hence the code below will set A to have a size of 1x1\n", + " A = 5.0;\n", + " A.print(\"A:\");\n", + " // if you want a matrix with all elements set to a particular value\n", + " // the .fill() member function can be used\n", + " A.set_size(3,3);\n", + " A.fill(5.0); A.print(\"A:\");\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Armadillo, simple examples" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + " mat B;\n", + " \n", + " // endr indicates \"end of row\"\n", + " B << 0.555950 << 0.274690 << 0.540605 << 0.798938 << endr\n", + " << 0.108929 << 0.830123 << 0.891726 << 0.895283 << endr\n", + " << 0.948014 << 0.973234 << 0.216504 << 0.883152 << endr\n", + " << 0.023787 << 0.675382 << 0.231751 << 0.450332 << endr;\n", + " \n", + " // print to the cout stream\n", + " // with an optional string before the contents of the matrix\n", + " B.print(\"B:\");\n", + " \n", + " // the << operator can also be used to print the matrix\n", + " // to an arbitrary stream (cout in this case)\n", + " cout << \"B:\" << endl << B << endl;\n", + " // save to disk\n", + " B.save(\"B.txt\", raw_ascii);\n", + " // load from disk\n", + " mat C;\n", + " C.load(\"B.txt\");\n", + " C += 2.0 * B;\n", + " C.print(\"C:\");\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Armadillo, simple examples" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + " // submatrix types:\n", + " //\n", + " // .submat(first_row, first_column, last_row, last_column)\n", + " // .row(row_number)\n", + " // .col(column_number)\n", + " // .cols(first_column, last_column)\n", + " // .rows(first_row, last_row)\n", + " \n", + " cout << \"C.submat(0,0,3,1) =\" << endl;\n", + " cout << C.submat(0,0,3,1) << endl;\n", + " \n", + " // generate the identity matrix\n", + " mat D = eye(4,4);\n", + " \n", + " D.submat(0,0,3,1) = C.cols(1,2);\n", + " D.print(\"D:\");\n", + " \n", + " // transpose\n", + " cout << \"trans(B) =\" << endl;\n", + " cout << trans(B) << endl;\n", + " \n", + " // maximum from each column (traverse along rows)\n", + " cout << \"max(B) =\" << endl;\n", + " cout << max(B) << endl;\n", + " \n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Armadillo, simple examples" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + " // maximum from each row (traverse along columns)\n", + " cout << \"max(B,1) =\" << endl;\n", + " cout << max(B,1) << endl;\n", + " // maximum value in B\n", + " cout << \"max(max(B)) = \" << max(max(B)) << endl;\n", + " // sum of each column (traverse along rows)\n", + " cout << \"sum(B) =\" << endl;\n", + " cout << sum(B) << endl;\n", + " // sum of each row (traverse along columns)\n", + " cout << \"sum(B,1) =\" << endl;\n", + " cout << sum(B,1) << endl;\n", + " // sum of all elements\n", + " cout << \"sum(sum(B)) = \" << sum(sum(B)) << endl;\n", + " cout << \"accu(B) = \" << accu(B) << endl;\n", + " // trace = sum along diagonal\n", + " cout << \"trace(B) = \" << trace(B) << endl;\n", + " // random matrix -- values are uniformly distributed in the [0,1] interval\n", + " mat E = randu(4,4);\n", + " E.print(\"E:\");\n", + " \n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Armadillo, simple examples" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + " // row vectors are treated like a matrix with one row\n", + " rowvec r;\n", + " r << 0.59499 << 0.88807 << 0.88532 << 0.19968;\n", + " r.print(\"r:\");\n", + " \n", + " // column vectors are treated like a matrix with one column\n", + " colvec q;\n", + " q << 0.81114 << 0.06256 << 0.95989 << 0.73628;\n", + " q.print(\"q:\");\n", + " \n", + " // dot or inner product\n", + " cout << \"as_scalar(r*q) = \" << as_scalar(r*q) << endl;\n", + " \n", + " // outer product\n", + " cout << \"q*r =\" << endl;\n", + " cout << q*r << endl;\n", + " \n", + " \n", + " // sum of three matrices (no temporary matrices are created)\n", + " mat F = B + C + D;\n", + " F.print(\"F:\");\n", + " \n", + " return 0;\n", + " \n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Armadillo, simple examples" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + " #include \n", + " #include \"armadillo\"\n", + " using namespace arma;\n", + " using namespace std;\n", + " \n", + " int main(int argc, char** argv)\n", + " {\n", + " cout << \"Armadillo version: \" << arma_version::as_string() << endl;\n", + " \n", + " mat A;\n", + " \n", + " A << 0.165300 << 0.454037 << 0.995795 << 0.124098 << 0.047084 << endr\n", + " << 0.688782 << 0.036549 << 0.552848 << 0.937664 << 0.866401 << endr\n", + " << 0.348740 << 0.479388 << 0.506228 << 0.145673 << 0.491547 << endr\n", + " << 0.148678 << 0.682258 << 0.571154 << 0.874724 << 0.444632 << endr\n", + " << 0.245726 << 0.595218 << 0.409327 << 0.367827 << 0.385736 << endr;\n", + " \n", + " A.print(\"A =\");\n", + " \n", + " // determinant\n", + " cout << \"det(A) = \" << det(A) << endl;\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Armadillo, simple examples" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + " // inverse\n", + " cout << \"inv(A) = \" << endl << inv(A) << endl;\n", + " double k = 1.23;\n", + " \n", + " mat B = randu(5,5);\n", + " mat C = randu(5,5);\n", + " \n", + " rowvec r = randu(5);\n", + " colvec q = randu(5);\n", + " \n", + " \n", + " // examples of some expressions\n", + " // for which optimised implementations exist\n", + " // optimised implementation of a trinary expression\n", + " // that results in a scalar\n", + " cout << \"as_scalar( r*inv(diagmat(B))*q ) = \";\n", + " cout << as_scalar( r*inv(diagmat(B))*q ) << endl;\n", + " \n", + " // example of an expression which is optimised\n", + " // as a call to the dgemm() function in BLAS:\n", + " cout << \"k*trans(B)*C = \" << endl << k*trans(B)*C;\n", + " \n", + " return 0;\n", + " \n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Gaussian Elimination\n", + "\n", + "We start with the linear set of equations" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathbf{A}\\mathbf{x} = \\mathbf{w}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We assume also that the matrix $\\mathbf{A}$ is non-singular and that the\n", + "matrix elements along the diagonal satisfy $a_{ii} \\ne 0$. Simple $4\\times 4 $ example" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\begin{bmatrix}\n", + " a_{11}& a_{12} &a_{13}& a_{14}\\\\\n", + " a_{21}& a_{22} &a_{23}& a_{24}\\\\\n", + " a_{31}& a_{32} &a_{33}& a_{34}\\\\\n", + " a_{41}& a_{42} &a_{43}& a_{44}\\\\\n", + " \\end{bmatrix} \\begin{bmatrix}\n", + " x_1\\\\\n", + " x_2\\\\\n", + " x_3 \\\\\n", + " x_4 \\\\\n", + " \\end{bmatrix}\n", + " =\\begin{bmatrix}\n", + " w_1\\\\\n", + " w_2\\\\\n", + " w_3 \\\\\n", + " w_4\\\\\n", + " \\end{bmatrix}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Gaussian Elimination\n", + "or" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "a_{11}x_1 +a_{12}x_2 +a_{13}x_3 + a_{14}x_4=w_1 \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "a_{21}x_1 + a_{22}x_2 + a_{23}x_3 + a_{24}x_4=w_2 \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "a_{31}x_1 + a_{32}x_2 + a_{33}x_3 + a_{34}x_4=w_3 \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "a_{41}x_1 + a_{42}x_2 + a_{43}x_3 + a_{44}x_4=w_4. \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Gaussian Elimination\n", + "\n", + "The basic idea of Gaussian elimination is to use the first equation to eliminate the first unknown $x_1$\n", + "from the remaining $n-1$ equations. Then we use the new second equation to eliminate the second unknown\n", + "$x_2$ from the remaining $n-2$ equations. With $n-1$ such eliminations\n", + "we obtain a so-called upper triangular set of equations of the form" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "b_{11}x_1 +b_{12}x_2 +b_{13}x_3 + b_{14}x_4=y_1 \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "b_{22}x_2 + b_{23}x_3 + b_{24}x_4=y_2 \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "b_{33}x_3 + b_{34}x_4=y_3 \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "\n", + "
\n", + "\n", + "$$\n", + "b_{44}x_4=y_4. \\nonumber\n", + "\\label{eq:gaussbacksub} \\tag{1}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We can solve this system of equations recursively starting from $x_n$ (in our case $x_4$) and proceed with\n", + "what is called a backward substitution. \n", + "\n", + "\n", + "## Gaussian Elimination\n", + "This process can be expressed mathematically as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "\n", + "
\n", + "\n", + "$$\n", + "\\begin{equation}\n", + " x_m = \\frac{1}{b_{mm}}\\left(y_m-\\sum_{k=m+1}^nb_{mk}x_k\\right)\\quad m=n-1,n-2,\\dots,1.\n", + "\\label{_auto1} \\tag{2}\n", + "\\end{equation}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "To arrive at such an upper triangular system of equations, we start by eliminating\n", + "the unknown $x_1$ for $j=2,n$. We achieve this by multiplying the first equation by $a_{j1}/a_{11}$ and then subtract\n", + "the result from the $j$th equation. We assume obviously that $a_{11}\\ne 0$ and that\n", + "$\\mathbf{A}$ is not singular.\n", + "\n", + "\n", + "## Gaussian Elimination\n", + "\n", + "Our actual $4\\times 4$ example reads after the first operation" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\begin{bmatrix}\n", + " a_{11}& a_{12} &a_{13}& a_{14}\\\\\n", + " 0& (a_{22}-\\frac{a_{21}a_{12}}{a_{11}}) &(a_{23}-\\frac{a_{21}a_{13}}{a_{11}}) & (a_{24}-\\frac{a_{21}a_{14}}{a_{11}})\\\\\n", + "0& (a_{32}-\\frac{a_{31}a_{12}}{a_{11}})& (a_{33}-\\frac{a_{31}a_{13}}{a_{11}})& (a_{34}-\\frac{a_{31}a_{14}}{a_{11}})\\\\\n", + "0&(a_{42}-\\frac{a_{41}a_{12}}{a_{11}}) &(a_{43}-\\frac{a_{41}a_{13}}{a_{11}}) & (a_{44}-\\frac{a_{41}a_{14}}{a_{11}}) \\\\\n", + " \\end{bmatrix} \\begin{bmatrix}\n", + " x_1\\\\\n", + " x_2\\\\\n", + " x_3 \\\\\n", + " x_4 \\\\\n", + " \\end{bmatrix} \n", + " =\\begin{bmatrix}\n", + " y_1\\\\\n", + " w_2^{(2)}\\\\\n", + " w_3^{(2)} \\\\\n", + " w_4^{(2)}\\\\\n", + " \\end{bmatrix},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "or" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "b_{11}x_1 +b_{12}x_2 +b_{13}x_3 + b_{14}x_4=y_1 \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "a^{(2)}_{22}x_2 + a^{(2)}_{23}x_3 + a^{(2)}_{24}x_4=w^{(2)}_2 \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "a^{(2)}_{32}x_2 + a^{(2)}_{33}x_3 + a^{(2)}_{34}x_4=w^{(2)}_3 \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "a^{(2)}_{42}x_2 + a^{(2)}_{43}x_3 + a^{(2)}_{44}x_4=w^{(2)}_4, \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "\n", + "
\n", + "\n", + "$$\n", + "\\begin{equation} \n", + "\\label{_auto2} \\tag{3}\n", + "\\end{equation}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Gaussian Elimination\n", + "\n", + "The new coefficients are" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "\n", + "
\n", + "\n", + "$$\n", + "\\begin{equation}\n", + " b_{1k} = a_{1k}^{(1)} \\quad k=1,\\dots,n,\n", + "\\label{_auto3} \\tag{4}\n", + "\\end{equation}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "where each $a_{1k}^{(1)}$ is equal to the original $a_{1k}$ element. The other coefficients are" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "\n", + "
\n", + "\n", + "$$\n", + "\\begin{equation}\n", + "a_{jk}^{(2)} = a_{jk}^{(1)}-\\frac{a_{j1}^{(1)}a_{1k}^{(1)}}{a_{11}^{(1)}} \\quad j,k=2,\\dots,n,\n", + "\\label{_auto4} \\tag{5}\n", + "\\end{equation}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "with a new right-hand side given by" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "\n", + "
\n", + "\n", + "$$\n", + "\\begin{equation}\n", + "y_{1}=w_1^{(1)}, \\quad w_j^{(2)} =w_j^{(1)}-\\frac{a_{j1}^{(1)}w_1^{(1)}}{a_{11}^{(1)}} \\quad j=2,\\dots,n.\n", + "\\label{_auto5} \\tag{6}\n", + "\\end{equation}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We have also set $w_1^{(1)}=w_1$, the original vector element.\n", + "We see that the system of unknowns $x_1,\\dots,x_n$ is transformed into an $(n-1)\\times (n-1)$ problem.\n", + "\n", + "\n", + "## Gaussian Elimination\n", + "\n", + "This step is called forward substitution.\n", + "Proceeding with these substitutions, we obtain the\n", + "general expressions for the new coefficients" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "\n", + "
\n", + "\n", + "$$\n", + "\\begin{equation}\n", + " a_{jk}^{(m+1)} = a_{jk}^{(m)}-\\frac{a_{jm}^{(m)}a_{mk}^{(m)}}{a_{mm}^{(m)}} \\quad j,k=m+1,\\dots,n,\n", + "\\label{_auto6} \\tag{7}\n", + "\\end{equation}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "with $m=1,\\dots,n-1$ and a\n", + "right-hand side given by" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "\n", + "
\n", + "\n", + "$$\n", + "\\begin{equation}\n", + " w_j^{(m+1)} =w_j^{(m)}-\\frac{a_{jm}^{(m)}w_m^{(m)}}{a_{mm}^{(m)}}\\quad j=m+1,\\dots,n.\n", + "\\label{_auto7} \\tag{8}\n", + "\\end{equation}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "This set of $n-1$ elimations leads us to an equations which is solved by back substitution.\n", + "If the arithmetics is exact and the matrix $\\mathbf{A}$ is not singular, then the computed answer will be exact.\n", + "\n", + "Even though the matrix elements along the diagonal are not zero,\n", + "numerically small numbers may appear and subsequent divisions may lead to large numbers, which, if added\n", + "to a small number may yield losses of precision. Suppose for example that our first division in $(a_{22}-a_{21}a_{12}/a_{11})$\n", + "results in $-10^{-7}$ and that $a_{22}$ is one.\n", + "one. We are then\n", + "adding $10^7+1$. With single precision this results in $10^7$.\n", + "\n", + "\n", + "\n", + "\n", + "## Linear Algebra Methods\n", + "\n", + " * Gaussian elimination, $O(2/3n^3)$ flops, general matrix\n", + "\n", + " * LU decomposition, upper triangular and lower tridiagonal matrices, $O(2/3n^3)$ flops, general matrix. Get easily the inverse, determinant and can solve linear equations with back-substitution only, $O(n^2)$ flops\n", + "\n", + " * Cholesky decomposition. Real symmetric or hermitian positive definite matrix, $O(1/3n^3)$ flops.\n", + "\n", + " * Tridiagonal linear systems, important for differential equations. Normally positive definite and non-singular. $O(8n)$ flops for symmetric. Special case of banded matrices.\n", + "\n", + " * Singular value decomposition\n", + "\n", + " * the QR method will be discussed in chapter 7 in connection with eigenvalue systems. $O(4/3n^3)$ flops.\n", + "\n", + "## LU Decomposition\n", + "\n", + "The LU decomposition method means that we can rewrite\n", + "this matrix as the product of two matrices $\\mathbf{L}$ and $\\mathbf{U}$\n", + "where" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\begin{bmatrix}\n", + " a_{11} & a_{12} & a_{13} & a_{14} \\\\\n", + " a_{21} & a_{22} & a_{23} & a_{24} \\\\\n", + " a_{31} & a_{32} & a_{33} & a_{34} \\\\\n", + " a_{41} & a_{42} & a_{43} & a_{44}\n", + " \\end{bmatrix}\n", + " = \\begin{bmatrix}\n", + " 1 & 0 & 0 & 0 \\\\\n", + " l_{21} & 1 & 0 & 0 \\\\\n", + " l_{31} & l_{32} & 1 & 0 \\\\\n", + " l_{41} & l_{42} & l_{43} & 1\n", + " \\end{bmatrix}\n", + " \\begin{bmatrix}\n", + " u_{11} & u_{12} & u_{13} & u_{14} \\\\\n", + " 0 & u_{22} & u_{23} & u_{24} \\\\\n", + " 0 & 0 & u_{33} & u_{34} \\\\\n", + " 0 & 0 & 0 & u_{44}\n", + " \\end{bmatrix}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## LU Decomposition\n", + "\n", + "LU decomposition forms the backbone of other algorithms in linear algebra, such as the\n", + "solution of linear equations given by" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "a_{11}x_1 +a_{12}x_2 +a_{13}x_3 + a_{14}x_4=w_1 \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "a_{21}x_1 + a_{22}x_2 + a_{23}x_3 + a_{24}x_4=w_2 \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "a_{31}x_1 + a_{32}x_2 + a_{33}x_3 + a_{34}x_4=w_3 \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "a_{41}x_1 + a_{42}x_2 + a_{43}x_3 + a_{44}x_4=w_4. \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "The above set of equations is conveniently solved by using LU decomposition as an intermediate step.\n", + "\n", + "The matrix $\\mathbf{A}\\in \\mathbb{R}^{n\\times n}$ has an LU factorization if the determinant\n", + "is different from zero. If the LU factorization exists and $\\mathbf{A}$ is non-singular, then the LU factorization\n", + "is unique and the determinant is given by" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "det\\{\\mathbf{A}\\}=det\\{\\mathbf{LU}\\}= det\\{\\mathbf{L}\\}det\\{\\mathbf{U}\\}=u_{11}u_{22}\\dots u_{nn}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## LU Decomposition, why?\n", + "\n", + "There are at least three main advantages with LU decomposition compared with standard Gaussian elimination:\n", + "\n", + " * It is straightforward to compute the determinant of a matrix\n", + "\n", + " * If we have to solve sets of linear equations with the same matrix but with different vectors $\\mathbf{y}$, the number of FLOPS is of the order $n^3$.\n", + "\n", + " * The inverse is such an operation \n", + "\n", + "## LU Decomposition, linear equations\n", + "\n", + "With the LU decomposition it is rather\n", + "simple to solve a system of linear equations" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "a_{11}x_1 +a_{12}x_2 +a_{13}x_3 + a_{14}x_4=w_1 \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "a_{21}x_1 + a_{22}x_2 + a_{23}x_3 + a_{24}x_4=w_2 \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "a_{31}x_1 + a_{32}x_2 + a_{33}x_3 + a_{34}x_4=w_3 \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "a_{41}x_1 + a_{42}x_2 + a_{43}x_3 + a_{44}x_4=w_4. \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "This can be written in matrix form as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathbf{Ax}=\\mathbf{w}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "where $\\mathbf{A}$ and $\\mathbf{w}$ are known and we have to solve for\n", + "$\\mathbf{x}$. Using the LU dcomposition we write" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathbf{A} \\mathbf{x} \\equiv \\mathbf{L} \\mathbf{U} \\mathbf{x} =\\mathbf{w}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## LU Decomposition, linear equations\n", + "\n", + "The previous equation can be calculated in two steps" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathbf{L} \\mathbf{y} = \\mathbf{w};\\qquad \\mathbf{Ux}=\\mathbf{y}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "To show that this is correct we use to the LU decomposition\n", + "to rewrite our system of linear equations as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathbf{LUx}=\\mathbf{w},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and since the determinat of $\\mathbf{L}$ is equal to 1 (by construction\n", + "since the diagonals of $\\mathbf{L}$ equal 1) we can use the inverse of\n", + "$\\mathbf{L}$ to obtain" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathbf{Ux}=\\mathbf{L^{-1}w}=\\mathbf{y},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "which yields the intermediate step" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathbf{L^{-1}w}=\\mathbf{y}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and as soon as we have $\\mathbf{y}$ we can obtain $\\mathbf{x}$\n", + "through $\\mathbf{Ux}=\\mathbf{y}$.\n", + "\n", + "\n", + "## LU Decomposition, why?\n", + "\n", + "For our four-dimentional example this takes the form" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "y_1=w_1 \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "l_{21}y_1 + y_2=w_2\\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "l_{31}y_1 + l_{32}y_2 + y_3 =w_3\\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "l_{41}y_1 + l_{42}y_2 + l_{43}y_3 + y_4=w_4. \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "u_{11}x_1 +u_{12}x_2 +u_{13}x_3 + u_{14}x_4=y_1 \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "u_{22}x_2 + u_{23}x_3 + u_{24}x_4=y_2\\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "u_{33}x_3 + u_{34}x_4=y_3\\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "u_{44}x_4=y_4 \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "This example shows the basis for the algorithm\n", + "needed to solve the set of $n$ linear equations.\n", + "\n", + "\n", + "## LU Decomposition, linear equations\n", + "\n", + "The algorithm goes as follows\n", + "\n", + " * Set up the matrix $\\bf A$ and the vector $\\bf w$ with their correct dimensions. This determines the dimensionality of the unknown vector $\\bf x$.\n", + "\n", + " * Then LU decompose the matrix $\\bf A$ through a call to the function `ludcmp(double a, int n, int indx, double &d)`. This functions returns the LU decomposed matrix $\\bf A$, its determinant and the vector indx which keeps track of the number of interchanges of rows. If the determinant is zero, the solution is malconditioned.\n", + "\n", + " * Thereafter you call the function `lubksb(double a, int n, int indx, double w)` which uses the LU decomposed matrix $\\bf A$ and the vector $\\bf w$ and returns $\\bf x$ in the same place as $\\bf w$. Upon exit the original content in $\\bf w$ is destroyed. If you wish to keep this information, you should make a backup of it in your calling function.\n", + "\n", + "## LU Decomposition, the inverse of a matrix\n", + "\n", + "If the inverse exists then" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathbf{A}^{-1}\\mathbf{A}=\\mathbf{I},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "the identity matrix. With an LU decomposed matrix we can rewrite the last equation as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathbf{LU}\\mathbf{A}^{-1}=\\mathbf{I}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## LU Decomposition, the inverse of a matrix\n", + "\n", + "If we assume that the first column (that is column 1) of the inverse matrix\n", + "can be written as a vector with unknown entries" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathbf{A}_1^{-1}= \\begin{bmatrix}\n", + " a_{11}^{-1} \\\\\n", + " a_{21}^{-1} \\\\\n", + " \\dots \\\\\n", + " a_{n1}^{-1} \\\\\n", + " \\end{bmatrix},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "then we have a linear set of equations" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathbf{LU}\\begin{bmatrix}\n", + " a_{11}^{-1} \\\\\n", + " a_{21}^{-1} \\\\\n", + " \\dots \\\\\n", + " a_{n1}^{-1} \\\\\n", + " \\end{bmatrix} =\\begin{bmatrix}\n", + " 1 \\\\\n", + " 0 \\\\\n", + " \\dots \\\\\n", + " 0 \\\\\n", + " \\end{bmatrix}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## LU Decomposition, the inverse\n", + "\n", + "In a similar way we can compute the unknow entries of the second column," + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathbf{LU}\\begin{bmatrix}\n", + " a_{12}^{-1} \\\\\n", + " a_{22}^{-1} \\\\\n", + " \\dots \\\\\n", + " a_{n2}^{-1} \\\\\n", + " \\end{bmatrix}=\\begin{bmatrix}\n", + " 0 \\\\\n", + " 1 \\\\\n", + " \\dots \\\\\n", + " 0 \\\\\n", + " \\end{bmatrix},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and continue till we have solved all $n$ sets of linear equations.\n", + "\n", + "\n", + "\n", + "## [Using Armadillo to perform an LU decomposition](https://github.com/CompPhysics/ComputationalPhysicsMSU/blob/master/doc/Programs/CppQtCodesLectures/MatrixTest/main.cpp)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + " #include \n", + " #include \"armadillo\"\n", + " using namespace arma;\n", + " using namespace std;\n", + " \n", + " int main()\n", + " {\n", + " mat A = randu(5,5);\n", + " vec b = randu(5);\n", + " \n", + " A.print(\"A =\");\n", + " b.print(\"b=\");\n", + " // solve Ax = b\n", + " vec x = solve(A,b);\n", + " // print x\n", + " x.print(\"x=\");\n", + " // find LU decomp of A, if needed, P is the permutation matrix\n", + " mat L, U;\n", + " lu(L,U,A);\n", + " // print l\n", + " L.print(\" L= \");\n", + " // print U\n", + " U.print(\" U= \");\n", + " //Check that A = LU\n", + " (A-L*U).print(\"Test of LU decomposition\");\n", + " return 0;\n", + " }\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Iterative methods, Chapter 6\n", + "\n", + " * Direct solvers such as Gauss elimination and LU decomposition discussed in connection with project 1.\n", + "\n", + " * Iterative solvers such as Basic iterative solvers, Jacobi, Gauss-Seidel, Successive over-relaxation. These methods are easy to parallelize, as we will se later. Much used in solutions of partial differential equations.\n", + "\n", + " * Other iterative methods such as Krylov subspace methods with Generalized minimum residual (GMRES) and Conjugate gradient etc will not be discussed.\n", + "\n", + "## Iterative methods, Jacobi's method\n", + "\n", + "It is a simple method for solving" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathbf{A}\\mathbf{x}=\\mathbf{b},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "where $\\mathbf{A}$ is a matrix and $\\mathbf{x}$ and $\\mathbf{b}$ are vectors. The vector $\\mathbf{x}$ is \n", + "the unknown.\n", + "\n", + "It is an iterative scheme where we start with a guess for the unknown, and \n", + "after $k+1$ iterations we have" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathbf{x}^{(k+1)}= \\mathbf{D}^{-1}(\\mathbf{b}-(\\mathbf{L}+\\mathbf{U})\\mathbf{x}^{(k)}),\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "with $\\mathbf{A}=\\mathbf{D}+\\mathbf{U}+\\mathbf{L}$ and\n", + "$\\mathbf{D}$ being a diagonal matrix, $\\mathbf{U}$ an upper triangular matrix and $\\mathbf{L}$ a lower triangular\n", + "matrix.\n", + "\n", + "If the matrix $\\mathbf{A}$ is positive definite or diagonally dominant, one can show that this method will always converge to the exact solution. \n", + "\n", + "\n", + "\n", + "\n", + "## Iterative methods, Jacobi's method\n", + "\n", + "We can demonstrate Jacobi's method by this $4\\times 4$ matrix problem. We assume a guess\n", + "for the vector elements $x_i^{(0)}$, a guess which represents our first iteration. The new\n", + "values are obtained by substitution" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "x_1^{(1)} =(b_1-a_{12}x_2^{(0)} -a_{13}x_3^{(0)} - a_{14}x_4^{(0)})/a_{11} \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "x_2^{(1)} =(b_2-a_{21}x_1^{(0)} - a_{23}x_3^{(0)} - a_{24}x_4^{(0)})/a_{22} \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "x_3^{(1)} =(b_3- a_{31}x_1^{(0)} -a_{32}x_2^{(0)} -a_{34}x_4^{(0)})/a_{33} \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "x_4^{(1)}=(b_4-a_{41}x_1^{(0)} -a_{42}x_2^{(0)} - a_{43}x_3^{(0)})/a_{44}, \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "which after $k+1$ iterations reads" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "x_1^{(k+1)} =(b_1-a_{12}x_2^{(k)} -a_{13}x_3^{(k)} - a_{14}x_4^{(k)})/a_{11} \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "x_2^{(k+1)} =(b_2-a_{21}x_1^{(k)} - a_{23}x_3^{(k)} - a_{24}x_4^{(k)})/a_{22} \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "x_3^{(k+1)} =(b_3- a_{31}x_1^{(k)} -a_{32}x_2^{(k)} -a_{34}x_4^{(k)})/a_{33} \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "x_4^{(k+1)}=(b_4-a_{41}x_1^{(k)} -a_{42}x_2^{(k)} - a_{43}x_3^{(k)})/a_{44}, \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Iterative methods, Jacobi's method\n", + "\n", + "We can generalize the above equations to" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "x_i^{(k+1)}=(b_i-\\sum_{j=1, j\\ne i}^{n}a_{ij}x_j^{(k)})/a_{ii}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "or in an even more compact form as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathbf{x}^{(k+1)}= \\mathbf{D}^{-1}(\\mathbf{b}-(\\mathbf{L}+\\mathbf{U})\\mathbf{x}^{(k)}),\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "with $\\mathbf{A}=\\mathbf{D}+\\mathbf{U}+\\mathbf{L}$ and\n", + "$\\mathbf{D}$ being a diagonal matrix, $\\mathbf{U}$ an upper triangular matrix and $\\mathbf{L}$ a lower triangular\n", + "matrix.\n", + "\n", + "\n", + "\n", + "## Iterative methods, Gauss-Seidel's method\n", + "\n", + "Our $4\\times 4$ matrix problem" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "x_1^{(k+1)} =(b_1-a_{12}x_2^{(k)} -a_{13}x_3^{(k)} - a_{14}x_4^{(k)})/a_{11} \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "x_2^{(k+1)} =(b_2-a_{21}x_1^{(k)} - a_{23}x_3^{(k)} - a_{24}x_4^{(k)})/a_{22} \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "x_3^{(k+1)} =(b_3- a_{31}x_1^{(k)} -a_{32}x_2^{(k)} -a_{34}x_4^{(k)})/a_{33} \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "x_4^{(k+1)}=(b_4-a_{41}x_1^{(k)} -a_{42}x_2^{(k)} - a_{43}x_3^{(k)})/a_{44}, \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "can be rewritten as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "x_1^{(k+1)} =(b_1-a_{12}x_2^{(k)} -a_{13}x_3^{(k)} - a_{14}x_4^{(k)})/a_{11} \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "x_2^{(k+1)} =(b_2-a_{21}x_1^{(k+1)} - a_{23}x_3^{(k)} - a_{24}x_4^{(k)})/a_{22} \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "x_3^{(k+1)} =(b_3- a_{31}x_1^{(k+1)} -a_{32}x_2^{(k+1)} -a_{34}x_4^{(k)})/a_{33} \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "x_4^{(k+1)}=(b_4-a_{41}x_1^{(k+1)} -a_{42}x_2^{(k+1)} - a_{43}x_3^{(k+1)})/a_{44}, \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "which allows us to utilize the preceding solution (forward substitution). This improves normally the convergence\n", + "behavior and leads to the Gauss-Seidel method!\n", + "\n", + "\n", + "\n", + "## Iterative methods, Gauss-Seidel's method\n", + "\n", + "We can generalize" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "x_1^{(k+1)} =(b_1-a_{12}x_2^{(k)} -a_{13}x_3^{(k)} - a_{14}x_4^{(k)})/a_{11} \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "x_2^{(k+1)} =(b_2-a_{21}x_1^{(k+1)} - a_{23}x_3^{(k)} - a_{24}x_4^{(k)})/a_{22} \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "x_3^{(k+1)} =(b_3- a_{31}x_1^{(k+1)} -a_{32}x_2^{(k+1)} -a_{34}x_4^{(k)})/a_{33} \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "x_4^{(k+1)}=(b_4-a_{41}x_1^{(k+1)} -a_{42}x_2^{(k+1)} - a_{43}x_3^{(k+1)})/a_{44}, \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "to the following form" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "x^{(k+1)}_i = \\frac{1}{a_{ii}} \\left(b_i - \\sum_{j > i}a_{ij}x^{(k)}_j - \\sum_{j < i}a_{ij}x^{(k+1)}_j \\right),\\quad i=1,2,\\ldots,n.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "The procedure is generally continued until the changes made by an iteration are below some tolerance.\n", + "\n", + "The convergence properties of the Jacobi method and the \n", + "Gauss-Seidel method are dependent on the matrix $\\mathbf{A}$. These methods converge when\n", + "the matrix is symmetric positive-definite, or is strictly or irreducibly diagonally dominant.\n", + "Both methods sometimes converge even if these conditions are not satisfied.\n", + "\n", + "\n", + "\n", + "## Iterative methods, Successive over-relaxation\n", + "\n", + "Given a square system of n linear equations with unknown $\\mathbf x$:" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathbf{A}\\mathbf x = \\mathbf b\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "where" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathbf{A}=\\begin{bmatrix} a_{11} & a_{12} & \\cdots & a_{1n} \\\\ a_{21} & a_{22} & \\cdots & a_{2n} \\\\ \\vdots & \\vdots & \\ddots & \\vdots \\\\a_{n1} & a_{n2} & \\cdots & a_{nn} \\end{bmatrix}, \\qquad \\mathbf{x} = \\begin{bmatrix} x_{1} \\\\ x_2 \\\\ \\vdots \\\\ x_n \\end{bmatrix} , \\qquad \\mathbf{b} = \\begin{bmatrix} b_{1} \\\\ b_2 \\\\ \\vdots \\\\ b_n \\end{bmatrix}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Iterative methods, Successive over-relaxation\n", + "\n", + "Then A can be decomposed into a diagonal component D, and strictly lower and upper triangular components L and U:" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathbf{A} =\\mathbf{D} + \\mathbf{L} + \\mathbf{U},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "where" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "D = \\begin{bmatrix} a_{11} & 0 & \\cdots & 0 \\\\ 0 & a_{22} & \\cdots & 0 \\\\ \\vdots & \\vdots & \\ddots & \\vdots \\\\0 & 0 & \\cdots & a_{nn} \\end{bmatrix}, \\quad L = \\begin{bmatrix} 0 & 0 & \\cdots & 0 \\\\ a_{21} & 0 & \\cdots & 0 \\\\ \\vdots & \\vdots & \\ddots & \\vdots \\\\a_{n1} & a_{n2} & \\cdots & 0 \\end{bmatrix}, \\quad U = \\begin{bmatrix} 0 & a_{12} & \\cdots & a_{1n} \\\\ 0 & 0 & \\cdots & a_{2n} \\\\ \\vdots & \\vdots & \\ddots & \\vdots \\\\0 & 0 & \\cdots & 0 \\end{bmatrix}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "The system of linear equations may be rewritten as:" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "(D+\\omega L) \\mathbf{x} = \\omega \\mathbf{b} - [\\omega U + (\\omega-1) D ] \\mathbf{x}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "for a constant $\\omega > 1$.\n", + "\n", + "\n", + "\n", + "\n", + "## Iterative methods, Successive over-relaxation\n", + "\n", + "The method of successive over-relaxation is an iterative technique that solves the left hand side of this expression for $x$, using previous value for $x$ on the right hand side. Analytically, this may be written as:" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathbf{x}^{(k+1)} = (D+\\omega L)^{-1} \\big(\\omega \\mathbf{b} - [\\omega U + (\\omega-1) D ] \\mathbf{x}^{(k)}\\big).\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "However, by taking advantage of the triangular form of $(D+\\omega L)$, the elements of $x^{(k+1)}$ can be computed sequentially using forward substitution:" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "x^{(k+1)}_i = (1-\\omega)x^{(k)}_i + \\frac{\\omega}{a_{ii}} \\left(b_i - \\sum_{j > i} a_{ij}x^{(k)}_j - \\sum_{j < i} a_{ij}x^{(k+1)}_j \\right),\\quad i=1,2,\\ldots,n.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "The choice of relaxation factor is not necessarily easy, and depends upon the properties of the coefficient matrix. For symmetric, positive-definite matrices it can be proven that $0 < \\omega < 2$ will lead to convergence, but we are generally interested in faster convergence rather than just convergence.\n", + "\n", + "\n", + "\n", + "# Cubic Splines\n", + "\n", + "Cubic spline interpolation is among one of the most used \n", + "methods for interpolating between data points where the arguments\n", + "are organized as ascending series. In the library program we supply\n", + "such a function, based on the so-called cubic spline method to be \n", + "described below. \n", + "\n", + "A spline function consists of polynomial pieces defined on\n", + "subintervals. The different subintervals are connected via\n", + "various continuity relations.\n", + "\n", + "Assume we have at our disposal $n+1$ points $x_0, x_1, \\dots x_n$ \n", + "arranged so that $x_0 < x_1 < x_2 < \\dots x_{n-1} < x_n$ (such points are called\n", + "knots). A spline function $s$ of degree $k$ with $n+1$ knots is defined\n", + "as follows\n", + " * On every subinterval $[x_{i-1},x_i)$ *s* is a polynomial of degree $\\le k$.\n", + "\n", + " * $s$ has $k-1$ continuous derivatives in the whole interval $[x_0,x_n]$.\n", + "\n", + "## Splines\n", + "\n", + "As an example, consider a spline function of degree $k=1$ defined as follows" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "s(x)=\\begin{bmatrix} s_0(x)=a_0x+b_0 & x\\in [x_0, x_1) \\\\ \n", + " s_1(x)=a_1x+b_1 & x\\in [x_1, x_2) \\\\ \n", + " \\dots & \\dots \\\\\n", + " s_{n-1}(x)=a_{n-1}x+b_{n-1} & x\\in \n", + " [x_{n-1}, x_n] \\end{bmatrix}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "In this case the polynomial consists of series of straight lines \n", + "connected to each other at every endpoint. The number of continuous\n", + "derivatives is then $k-1=0$, as expected when we deal with straight lines.\n", + "Such a polynomial is quite easy to construct given\n", + "$n+1$ points $x_0, x_1, \\dots x_n$ and their corresponding \n", + "function values. \n", + "\n", + "\n", + "\n", + "\n", + "## Splines\n", + "\n", + "The most commonly used spline function is the one with $k=3$, the so-called\n", + "cubic spline function. \n", + "Assume that we have in adddition to the $n+1$ knots a series of\n", + "functions values $y_0=f(x_0), y_1=f(x_1), \\dots y_n=f(x_n)$.\n", + "By definition, the polynomials $s_{i-1}$ and $s_i$ \n", + "are thence supposed to interpolate the same point $i$, that is" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "s_{i-1}(x_i)= y_i = s_i(x_i),\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "with $1 \\le i \\le n-1$. In total we have $n$ polynomials of the \n", + "type" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "s_i(x)=a_{i0}+a_{i1}x+a_{i2}x^2+a_{i2}x^3,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "yielding $4n$ coefficients to determine.\n", + "\n", + "\n", + "\n", + "\n", + "## Splines\n", + "\n", + "Every subinterval provides in addition the $2n$ conditions" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "y_i = s(x_i),\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "s(x_{i+1})= y_{i+1},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "to be fulfilled. If we also assume that $s'$ and $s''$ are continuous,\n", + "then" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "s'_{i-1}(x_i)= s'_i(x_i),\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "yields $n-1$ conditions. Similarly," + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "s''_{i-1}(x_i)= s''_i(x_i),\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "results in additional $n-1$ conditions. In total we have $4n$ coefficients\n", + "and $4n-2$ equations to determine them, leaving us with $2$ degrees of \n", + "freedom to be determined. \n", + "\n", + "\n", + "\n", + "## Splines\n", + "\n", + "Using the last equation we define two values for the second derivative, namely" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "s''_{i}(x_i)= f_i,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "s''_{i}(x_{i+1})= f_{i+1},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and setting up a straight line between $f_i$ and $f_{i+1}$ we have" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "s_i''(x) = \\frac{f_i}{x_{i+1}-x_i}(x_{i+1}-x)+\n", + " \\frac{f_{i+1}}{x_{i+1}-x_i}(x-x_i),\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and integrating twice one obtains" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "s_i(x) = \\frac{f_i}{6(x_{i+1}-x_i)}(x_{i+1}-x)^3+\n", + " \\frac{f_{i+1}}{6(x_{i+1}-x_i)}(x-x_i)^3\n", + " +c(x-x_i)+d(x_{i+1}-x).\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Splines\n", + "\n", + "Using the conditions $s_i(x_i)=y_i$ and $s_i(x_{i+1})=y_{i+1}$ \n", + "we can in turn determine the constants $c$ and $d$ resulting in" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "s_i(x) =\\frac{f_i}{6(x_{i+1}-x_i)}(x_{i+1}-x)^3+\n", + " \\frac{f_{i+1}}{6(x_{i+1}-x_i)}(x-x_i)^3 \\nonumber\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "\n", + "
\n", + "\n", + "$$\n", + "\\begin{equation} \n", + " +(\\frac{y_{i+1}}{x_{i+1}-x_i}-\\frac{f_{i+1}(x_{i+1}-x_i)}{6})\n", + " (x-x_i)+\n", + " (\\frac{y_{i}}{x_{i+1}-x_i}-\\frac{f_{i}(x_{i+1}-x_i)}{6})\n", + " (x_{i+1}-x).\n", + "\\label{_auto8} \\tag{9}\n", + "\\end{equation}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Splines\n", + "\n", + "How to determine the values of the second\n", + "derivatives $f_{i}$ and $f_{i+1}$? We use the continuity assumption \n", + "of the first derivatives" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "s'_{i-1}(x_i)= s'_i(x_i),\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and set $x=x_i$. Defining $h_i=x_{i+1}-x_i$ we obtain finally\n", + "the following expression" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "h_{i-1}f_{i-1}+2(h_{i}+h_{i-1})f_i+h_if_{i+1}=\n", + " \\frac{6}{h_i}(y_{i+1}-y_i)-\\frac{6}{h_{i-1}}(y_{i}-y_{i-1}),\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and introducing the shorthands $u_i=2(h_{i}+h_{i-1})$, \n", + "$v_i=\\frac{6}{h_i}(y_{i+1}-y_i)-\\frac{6}{h_{i-1}}(y_{i}-y_{i-1})$,\n", + "we can reformulate the problem as a set of linear equations to be \n", + "solved through e.g., Gaussian elemination\n", + "\n", + "\n", + "\n", + "\n", + "## Splines\n", + "\n", + "Gaussian elimination" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\begin{bmatrix} u_1 & h_1 &0 &\\dots & & & & \\\\\n", + " h_1 & u_2 & h_2 &0 &\\dots & & & \\\\\n", + " 0 & h_2 & u_3 & h_3 &0 &\\dots & & \\\\\n", + " \\dots& & \\dots &\\dots &\\dots &\\dots &\\dots & \\\\\n", + " &\\dots & & &0 &h_{n-3} &u_{n-2} &h_{n-2} \\\\\n", + " & && & &0 &h_{n-2} &u_{n-1} \\end{bmatrix}\n", + " \\begin{bmatrix} f_1 \\\\ \n", + " f_2 \\\\\n", + " f_3\\\\\n", + " \\dots \\\\\n", + " f_{n-2} \\\\ \n", + " f_{n-1} \\end{bmatrix} =\n", + " \\begin{bmatrix} v_1 \\\\ \n", + " v_2 \\\\\n", + " v_3\\\\\n", + " \\dots \\\\\n", + " v_{n-2}\\\\\n", + " v_{n-1} \\end{bmatrix}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Note that this is a set of tridiagonal equations and can be solved \n", + "through only $O(n)$ operations.\n", + "\n", + "\n", + "\n", + "## Splines\n", + "\n", + "The functions supplied in the program library are *spline* and *splint*.\n", + "In order to use cubic spline interpolation you need first to call" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + " spline(double x[], double y[], int n, double yp1, double yp2, double y2[])\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "This function takes as\n", + "input $x[0,..,n - 1]$ and $y[0,..,n - 1]$ containing a tabulation\n", + "$y_i = f(x_i)$ with $x_0 < x_1 < .. < x_{n - 1}$ \n", + "together with the \n", + "first derivatives of $f(x)$ at $x_0$ and $x_{n-1}$, respectively. Then the\n", + "function returns $y2[0,..,n-1]$ which contains the second derivatives of\n", + "$f(x_i)$ at each point $x_i$. $n$ is the number of points.\n", + "This function provides the cubic spline interpolation for all subintervals\n", + "and is called only once.\n", + "\n", + "\n", + "\n", + "\n", + "## Splines\n", + "\n", + "Thereafter, if you wish to make various interpolations, you need to call the function" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + " splint(double x[], double y[], double y2a[], int n, double x, double *y)\n" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "which takes as input\n", + "the tabulated values $x[0,..,n - 1]$ and $y[0,..,n - 1]$ and the output \n", + "y2a[0,..,n - 1] from *spline*. It returns the value $y$ corresponding\n", + "to the point $x$.\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "## Conjugate gradient (CG) method\n", + "\n", + "The success of the CG method for finding solutions of non-linear problems is based\n", + "on the theory of conjugate gradients for linear systems of equations. It belongs\n", + "to the class of iterative methods for solving problems from linear algebra of the type" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{A}\\hat{x} = \\hat{b}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "In the iterative process we end up with a problem like" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{r}= \\hat{b}-\\hat{A}\\hat{x},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "where $\\hat{r}$ is the so-called residual or error in the iterative process.\n", + "\n", + "When we have found the exact solution, $\\hat{r}=0$.\n", + "\n", + "\n", + "\n", + "\n", + "## Conjugate gradient method\n", + "\n", + "\n", + "The residual is zero when we reach the minimum of the quadratic equation" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "P(\\hat{x})=\\frac{1}{2}\\hat{x}^T\\hat{A}\\hat{x} - \\hat{x}^T\\hat{b},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "with the constraint that the matrix $\\hat{A}$ is positive definite and symmetric.\n", + "If we search for a minimum of the quantum mechanical variance, then the matrix \n", + "$\\hat{A}$, which is called the Hessian, is given by the second-derivative of the function we want to minimize. This quantity is always positive definite. In our case this corresponds normally to the second derivative of the energy. \n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "## Conjugate gradient method, Newton's method first\n", + "\n", + "We seek the minimum of the energy or the variance as function of various variational parameters. \n", + "In our case we have thus a function $f$ whose minimum we are seeking.\n", + "In Newton's method we set $\\nabla f = 0$ and we can thus compute the next iteration point" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{x}-\\hat{x}_i=\\hat{A}^{-1}\\nabla f(\\hat{x}_i).\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Subtracting this equation from that of $\\hat{x}_{i+1}$ we have" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{x}_{i+1}-\\hat{x}_i=\\hat{A}^{-1}(\\nabla f(\\hat{x}_{i+1})-\\nabla f(\\hat{x}_i)).\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Simple example and demonstration\n", + "\n", + "The function $f$ can be either the energy or the variance. If we choose the energy then we have" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{\\alpha}_{i+1}-\\hat{\\alpha}_i=\\hat{A}^{-1}(\\nabla E(\\hat{\\alpha}_{i+1})-\\nabla E(\\hat{\\alpha}_i)).\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "In the simple harmonic oscillator model, the gradient and the Hessian $\\hat{A}$ are" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{d\\langle E_L[\\alpha]\\rangle}{d\\alpha} = \\alpha-\\frac{1}{4\\alpha^3}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and a second derivative which is always positive (meaning that we find a minimum)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{A}= \\frac{d^2\\langle E_L[\\alpha]\\rangle}{d\\alpha^2} = 1+\\frac{3}{4\\alpha^4}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Simple example and demonstration\n", + "\n", + "We get then" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\alpha_{i+1}=\\frac{4}{3}\\alpha_i-\\frac{\\alpha_i^4}{3\\alpha_{i+1}^3},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "which can be rewritten as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\alpha_{i+1}^4-\\frac{4}{3}\\alpha_i\\alpha_{i+1}^4+\\frac{1}{3}\\alpha_i^4.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Conjugate gradient method\n", + "\n", + "In the CG method we define so-called conjugate directions and two vectors \n", + "$\\hat{s}$ and $\\hat{t}$\n", + "are said to be\n", + "conjugate if" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{s}^T\\hat{A}\\hat{t}= 0.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "The philosophy of the CG method is to perform searches in various conjugate directions\n", + "of our vectors $\\hat{x}_i$ obeying the above criterion, namely" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{x}_i^T\\hat{A}\\hat{x}_j= 0.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Two vectors are conjugate if they are orthogonal with respect to \n", + "this inner product. Being conjugate is a symmetric relation: if $\\hat{s}$ is conjugate to $\\hat{t}$, then $\\hat{t}$ is conjugate to $\\hat{s}$.\n", + "\n", + "\n", + "\n", + "## Conjugate gradient method\n", + "\n", + "An example is given by the eigenvectors of the matrix" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{v}_i^T\\hat{A}\\hat{v}_j= \\lambda\\hat{v}_i^T\\hat{v}_j,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "which is zero unless $i=j$. \n", + "\n", + "\n", + "\n", + "\n", + "## Conjugate gradient method\n", + "\n", + "Assume now that we have a symmetric positive-definite matrix $\\hat{A}$ of size\n", + "$n\\times n$. At each iteration $i+1$ we obtain the conjugate direction of a vector" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{x}_{i+1}=\\hat{x}_{i}+\\alpha_i\\hat{p}_{i}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "We assume that $\\hat{p}_{i}$ is a sequence of $n$ mutually conjugate directions. \n", + "Then the $\\hat{p}_{i}$ form a basis of $R^n$ and we can expand the solution \n", + "$ \\hat{A}\\hat{x} = \\hat{b}$ in this basis, namely" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{x} = \\sum^{n}_{i=1} \\alpha_i \\hat{p}_i.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Conjugate gradient method\n", + "\n", + "The coefficients are given by" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mathbf{A}\\mathbf{x} = \\sum^{n}_{i=1} \\alpha_i \\mathbf{A} \\mathbf{p}_i = \\mathbf{b}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Multiplying with $\\hat{p}_k^T$ from the left gives" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{p}_k^T \\hat{A}\\hat{x} = \\sum^{n}_{i=1} \\alpha_i\\hat{p}_k^T \\hat{A}\\hat{p}_i= \\hat{p}_k^T \\hat{b},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and we can define the coefficients $\\alpha_k$ as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\alpha_k = \\frac{\\hat{p}_k^T \\hat{b}}{\\hat{p}_k^T \\hat{A} \\hat{p}_k}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Conjugate gradient method and iterations\n", + "\n", + "\n", + "If we choose the conjugate vectors $\\hat{p}_k$ carefully, \n", + "then we may not need all of them to obtain a good approximation to the solution \n", + "$\\hat{x}$. \n", + "We want to regard the conjugate gradient method as an iterative method. \n", + "This will us to solve systems where $n$ is so large that the direct \n", + "method would take too much time.\n", + "\n", + "We denote the initial guess for $\\hat{x}$ as $\\hat{x}_0$. \n", + "We can assume without loss of generality that" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{x}_0=0,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "or consider the system" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{A}\\hat{z} = \\hat{b}-\\hat{A}\\hat{x}_0,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "instead.\n", + "\n", + "\n", + "\n", + "\n", + "## Conjugate gradient method\n", + "\n", + "One can show that the solution $\\hat{x}$ is also the unique minimizer of the quadratic form" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "f(\\hat{x}) = \\frac{1}{2}\\hat{x}^T\\hat{A}\\hat{x} - \\hat{x}^T \\hat{x} , \\quad \\hat{x}\\in\\mathbf{R}^n.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "This suggests taking the first basis vector $\\hat{p}_1$ \n", + "to be the gradient of $f$ at $\\hat{x}=\\hat{x}_0$, \n", + "which equals" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{A}\\hat{x}_0-\\hat{b},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and \n", + "$\\hat{x}_0=0$ it is equal $-\\hat{b}$.\n", + "The other vectors in the basis will be conjugate to the gradient, \n", + "hence the name conjugate gradient method.\n", + "\n", + "\n", + "\n", + "\n", + "## Conjugate gradient method\n", + "\n", + "Let $\\hat{r}_k$ be the residual at the $k$-th step:" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{r}_k=\\hat{b}-\\hat{A}\\hat{x}_k.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Note that $\\hat{r}_k$ is the negative gradient of $f$ at \n", + "$\\hat{x}=\\hat{x}_k$, \n", + "so the gradient descent method would be to move in the direction $\\hat{r}_k$. \n", + "Here, we insist that the directions $\\hat{p}_k$ are conjugate to each other, \n", + "so we take the direction closest to the gradient $\\hat{r}_k$ \n", + "under the conjugacy constraint. \n", + "This gives the following expression" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{p}_{k+1}=\\hat{r}_k-\\frac{\\hat{p}_k^T \\hat{A}\\hat{r}_k}{\\hat{p}_k^T\\hat{A}\\hat{p}_k} \\hat{p}_k.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Conjugate gradient method\n", + "\n", + "We can also compute the residual iteratively as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{r}_{k+1}=\\hat{b}-\\hat{A}\\hat{x}_{k+1},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "which equals" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{b}-\\hat{A}(\\hat{x}_k+\\alpha_k\\hat{p}_k),\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "or" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "(\\hat{b}-\\hat{A}\\hat{x}_k)-\\alpha_k\\hat{A}\\hat{p}_k,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "which gives" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{r}_{k+1}=\\hat{r}_k-\\hat{A}\\hat{p}_{k},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# Review of probability theory\n", + "\n", + "## Domains and probabilities\n", + "\n", + "Consider the following simple example, namely the tossing of a 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 a dice\n", + "\n", + "The numbers in the domain are the outcomes of the physical process tossing the 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", + "\n", + "**Random variables are characterized by a domain which contains all possible values that the random value may take. This domain has a corresponding PDF**.\n", + "\n", + "\n", + "\n", + "## Stochastic variables and the main concepts, the discrete case\n", + "\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", + "\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", + "\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", + "\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", + "\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{10}\n", + "\\end{equation}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "with" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\begin{array}{ll}\n", + "\\theta(x)=0 & x<0 \\\\\n", + "\\theta(x)=\\frac{1}{b-a} & \\in [a,b].\n", + "\\end{array}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "The normal distribution with $b=1$ and $a=0$ is used to generate random numbers. \n", + "\n", + "\n", + "\n", + "## Gaussian distribution\n", + "\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": [ + { + "data": { + "image/png": "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\n", + "text/plain": [ + "" + ] + }, + "metadata": {}, + "output_type": "display_data" + } + ], + "source": [ + "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", + "\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", + "\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{11}\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", + "\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 \\frac{1}{N}\\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", + "\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\\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", + "\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", + "\n", + "With a PDF we can compute expectation values of selected quantities such as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\langle x^k\\rangle=\\frac{1}{N}\\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", + "\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", + "\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", + "\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{_auto9} \\tag{12}\n", + "\\end{equation}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Probability Distribution Functions, the cumulative distribution\n", + "\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", + "\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", + "## Probability Distribution Functions, the binomial distribution\n", + "\n", + "\n", + "In order to compute the mean and variance we need to recall Newton's binomial\n", + "formula" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "(a+b)^m=\\sum_{n=0}^m \\left(\\begin{array}{c} m \\\\ n\\end{array}\\right)a^nb^{m-n},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "which can be used to show that" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\sum_{x=0}^n\\left(\\begin{array}{c} n \\\\ x\\end{array}\\right)y^x(1-y)^{n-x} = (y+1-y)^n = 1,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "the PDF is normalized to one. \n", + "The mean value is" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mu = \\sum_{x=0}^n x\\left(\\begin{array}{c} n \\\\ x\\end{array}\\right)y^x(1-y)^{n-x} =\n", + "\\sum_{x=0}^n x\\frac{n!}{x!(n-x)!}y^x(1-y)^{n-x},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "resulting in" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mu = \n", + "\\sum_{x=0}^n x\\frac{(n-1)!}{(x-1)!(n-1-(x-1))!}y^{x-1}(1-y)^{n-1-(x-1)},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "which we rewrite as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\mu=ny\\sum_{\\nu=0}^n\\left(\\begin{array}{c} n-1 \\\\ \\nu\\end{array}\\right)y^{\\nu}(1-y)^{n-1-\\nu} =ny(y+1-y)^{n-1}=ny.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "The variance is slightly trickier to get. It reads $\\sigma^2=ny(1-y)$. \n", + "\n", + "\n", + "## Probability Distribution Functions, Poisson's distribution\n", + "\n", + "\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", + "\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", + "\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{_auto10} \\tag{13}\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{14}\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", + "\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", + "## Meet the covariance, uncorrelated events\n", + "\n", + "\n", + "This is easy to show, keeping in mind the linearity of\n", + "the expectation value. Consider the stochastic variables $X_i$ and\n", + "$X_j$, ($i\\neq j$)" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\begin{align*}\n", + "\\mathrm{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, we get" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\langle x_i x_j\\rangle =\n", + "\\langle x_i\\rangle\\langle x_j\\rangle=\\mathrm{Cov}(X_i, X_j) = 0\\ \\ (i\\neq j).\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Numerical experiments and the covariance\n", + "\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", + "\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", + "\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", + "\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{15}\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{16}\n", + "\\end{equation}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Numerical experiments and the covariance, the sample variance\n", + "\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{17}\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", + "\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", + "\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. ([eq:exptvariance](#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{18}\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", + "\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{19}\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{20}\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", + "\n", + "From the point of view of\n", + "Eq. ([eq:error_estimate_corr_time](#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", + "# Random Numbers\n", + "\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", + "\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", + "# Random number generator RNG\n", + "\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", + "\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", + "\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", + "\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{21}\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{22}\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", + "\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", + "\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", + "\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{23}\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", + "\n", + "We can now rewrite Eq. ([eq:rntrick1](#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{24}\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{25}\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{26}\n", + "\\end{equation}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# Random number generator RNG, RAN0\n", + "\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", + "\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", + "\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", + "\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", + "\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": 8, + "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", + "\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. ([eq:autocorrelformal](#eq:autocorrelformal)).\n", + "We rewrite it here as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "C_k=\\frac{f_d}\n", + " {\\sigma^2},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "with $C_0=1$. Recall that \n", + "$\\sigma^2=\\langle x_i^2\\rangle-\\langle x_i\\rangle^2$ and that" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "f_d = \\frac{1}{nm}\\sum_{\\alpha=1}^m\\sum_{k=1}^{n-d}(x_{\\alpha,k}-\\langle X_m \\rangle)(x_{\\alpha,k+d}-\\langle X_m \\rangle),\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "The non-vanishing of $C_k$ for $k\\ne 0$ means that the random\n", + "numbers are not independent. The independence of the random numbers is crucial \n", + "in the evaluation of other expectation values. If they are not independent, our\n", + "assumption for approximating $\\sigma_N$ is no longer valid.\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "## Correlation function and which random number generators should I use\n", + "\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": [ + "## Correlation function and which random number generators should I use\n", + "\n", + "The following Python code plots the results for the correlation function from the above program." + ] + }, + { + "cell_type": "code", + "execution_count": 9, + "metadata": { + "collapsed": false + }, + "outputs": [], + "source": [ + "import numpy as np\n", + "from matplotlib import pyplot as plt\n", + "# Load in data file\n", + "data = np.loadtxt(\"datafiles/autocor.dat\")\n", + "# Make arrays containing x-axis and binding energies as function of A\n", + "x = data[:,0]\n", + "corr = data[:,1]\n", + "plt.plot(x, corr ,'ro')\n", + "plt.axis([0,1000,-0.2, 1.1])\n", + "plt.xlabel(r'$d$')\n", + "plt.ylabel(r'$C_d$')\n", + "plt.title(r'autocorrelation function for RNG')\n", + "plt.savefig('autocorr.pdf')\n", + "plt.show()" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# Which RNG should I use?\n", + "\n", + "* In the library files lib.cpp and lib.h we have included four popular RNGs taken from the widely used textbook [Numerical Recipes](http://numerical.recipes/). These are called ran0, ran1, ran2 and ran3.\n", + "\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", + "## How to use the Mersenne generator\n", + "\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", + " * Monte Carlo simulations can be treated as *computer experiments*\n", + "\n", + " * The results can be analysed with the same statistical tools as we would use analysing experimental data.\n", + "\n", + " * As in all experiments, we are looking for expectation values and an estimate of how accurate they are, i.e., possible sources for errors.\n", + "\n", + "A very good article which explains blocking is H. Flyvbjerg and H. G. Petersen, *Error estimates on averages of correlated data*, [Journal of Chemical Physics 91, 461-466 (1989)](http://scitation.aip.org/content/aip/journal/jcp/91/1/10.1063/1.457480).\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "\n", + "## Why blocking?\n", + " Statistical analysis\n", + " * 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", + "## 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", + " * 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", + " * 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", + "## What is blocking?\n", + " Blocking\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", + "## Implementation\n", + "\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", + "## 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": 10, + "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": [ + "## 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" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# Regression analysis, overarching aims\n", + "\n", + "\n", + "Regression modeling deals with the description of the sampling distribution of a given random variable $y$ varies as function of another variable or a set of such variables $\\hat{x} =[x_0, x_1,\\dots, x_p]^T$. \n", + "The first variable is called the **dependent**, the **outcome** or the **response** variable while the set of variables $\\hat{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(y\\vert \\hat{x})$, that is the conditional distribution for $y$ with a given $\\hat{x}$. The estimation of $p(y\\vert \\hat{x})$ is made using a data set with \n", + "* $n$ cases $i = 0, 1, 2, \\dots, n-1$ \n", + "\n", + "* Response (dependent or outcome) variable $y_i$ with $i = 0, 1, 2, \\dots, n-1$ \n", + "\n", + "* $p$ Explanatory (independent or predictor) variables $\\hat{x}_i=[x_{i0}, x_{i1}, \\dots, x_{ip}]$ with $i = 0, 1, 2, \\dots, n-1$ \n", + "\n", + " The goal of the regression analysis is to extract/exploit relationship between $y_i$ and $\\hat{x}_i$ in or to infer causal dependencies, approximations to the likelihood functions, functional relationships and to make predictions .\n", + "\n", + "\n", + "\n", + "\n", + "## General linear models\n", + "\n", + "Before we proceed let us study a case from linear algebra where we aim at fitting a set of data $\\hat{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 $\\hat{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_i 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", + "\n", + "## Rewriting the fitting procedure as a linear algebra problem\n", + "\n", + "For every set of values $y_i,x_i$ we have thus the corresponding set of equations" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\begin{align*}\n", + "y_0&=\\beta_0+\\beta_1x_0^1+\\beta_2x_0^2+\\dots+\\beta_{n-1}x_0^{n-1}+\\epsilon_0\\\\\n", + "y_1&=\\beta_0+\\beta_1x_1^1+\\beta_2x_1^2+\\dots+\\beta_{n-1}x_1^{n-1}+\\epsilon_1\\\\\n", + "y_2&=\\beta_0+\\beta_1x_2^1+\\beta_2x_2^2+\\dots+\\beta_{n-1}x_2^{n-1}+\\epsilon_2\\\\\n", + "\\dots & \\dots \\\\\n", + "y_{n-1}&=\\beta_0+\\beta_1x_{n-1}^1+\\beta_2x_{n-1}^2+\\dots+\\beta_1x_{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, follows\n", + "\n", + "Defining the vectors" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "2\n", + "2\n", + "9\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", + "3\n", + "0\n", + " \n", + "<\n", + "<\n", + "<\n", + "!\n", + "!\n", + "M\n", + "A\n", + "T\n", + "H\n", + "_\n", + "B\n", + "L\n", + "O\n", + "C\n", + "K" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{\\epsilon} = [\\epsilon_0,\\epsilon_1, \\epsilon_2,\\dots, \\epsilon_{n-1}]^T,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and the matrix" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{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", + "\\hat{y} = \\hat{X}\\hat{\\beta}+\\hat{\\epsilon}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Generalizing the fitting procedure as a linear algebra problem\n", + "\n", + "We are obviously not limited to the above polynomial. We could replace the various powers of $x$ with elements of Fourier series, that is, instead of $x_i^j$ we could have $\\cos{(j x_i)}$ or $\\sin{(j x_i)}$, or time series or other orthogonal functions.\n", + "For every set 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_1x_{n-1,n-1}+\\epsilon_{n-1}.\\\\\n", + "\\end{align*}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Generalizing the fitting procedure as a linear algebra problem\n", + "\n", + "We redefine in turn the matrix $\\hat{X}$ as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{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", + "\\hat{y} = \\hat{X}\\hat{\\beta}+\\hat{\\epsilon}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "The left-hand side of this equation forms know. Our error vector $\\hat{\\epsilon}$ and the parameter vector $\\hat{\\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", + "\n", + "We have defined the matrix $\\hat{X}$" + ] + }, + { + "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_1x_{n-1,n-1}+\\epsilon_{n-1}.\\\\\n", + "\\end{align*}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Optimizing our parameters, more details\n", + "\n", + "We well use this matrix to define the approximation $\\hat{\\tilde{y}}$ via the unknown quantity $\\hat{\\beta}$ as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{\\tilde{y}}= \\hat{X}\\hat{\\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 parametrized values $\\tilde{y}_i$, namely" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "Q(\\hat{\\beta})=\\sum_{i=0}^{n-1}\\left(y_i-\\tilde{y}_i\\right)^2=\\left(\\hat{y}-\\hat{\\tilde{y}}\\right)^T\\left(\\hat{y}-\\hat{\\tilde{y}}\\right),\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "or using the matrix $\\hat{X}$ as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "Q(\\hat{\\beta})=\\left(\\hat{y}-\\hat{X}\\hat{\\beta}\\right)^T\\left(\\hat{y}-\\hat{X}\\hat{\\beta}\\right).\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Interpretations and optimizing our parameters\n", + "\n", + "The function" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "Q(\\hat{\\beta})=\\left(\\hat{y}-\\hat{X}\\hat{\\beta}\\right)^T\\left(\\hat{y}-\\hat{X}\\hat{\\beta}\\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 of for example a numerical experiment. When linking 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 till now we have treated $y_i$ as the exact value. Normally, the response (dependent or outcome) variable $y_i$ the outcome of a numerical experiment or another type of experiment and is thus only an approximation to the true value. It is then always accompanied by an error estimate, often limited to a statistical error estimate given by the standard deviation discussed earlier. In the discussion here we will treat $y_i$ as our exact value for the response variable.\n", + "\n", + "In order to find the parameters $\\beta_i$ we will then minimize the spread of $Q(\\hat{\\beta})$ by requiring" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{\\partial Q(\\hat{\\beta})}{\\partial \\beta_j} = \\frac{\\partial }{\\partial \\beta_j}\\left[ \\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 Q(\\hat{\\beta})}{\\partial \\beta_j} = -2\\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 Q(\\hat{\\beta})}{\\partial \\hat{\\beta}} = 0 = \\hat{X}^T\\left( \\hat{y}-\\hat{X}\\hat{\\beta}\\right).\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Interpretations and optimizing our parameters\n", + "\n", + "We can rewrite" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{\\partial Q(\\hat{\\beta})}{\\partial \\hat{\\beta}} = 0 = \\hat{X}^T\\left( \\hat{y}-\\hat{X}\\hat{\\beta}\\right),\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{X}^T\\hat{y} = \\hat{X}^T\\hat{X}\\hat{\\beta},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and if the matrix $\\hat{X}^T\\hat{X}$ is invertible we have the solution" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{\\beta} =\\left(\\hat{X}^T\\hat{X}\\right)^{-1}\\hat{X}^T\\hat{y}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Interpretations and optimizing our parameters\n", + "\n", + "The residuals $\\hat{\\epsilon}$ are in turn given by" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{\\epsilon} = \\hat{y}-\\hat{\\tilde{y}} = \\hat{y}-\\hat{X}\\hat{\\beta},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and with" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{X}^T\\left( \\hat{y}-\\hat{X}\\hat{\\beta}\\right)= 0,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "we have" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{X}^T\\hat{\\epsilon}=\\hat{X}^T\\left( \\hat{y}-\\hat{X}\\hat{\\beta}\\right)= 0,\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "meaning that the solution for $\\hat{\\beta}$ is the one which minimizes the residuals. Later we will link this with the maximum likelihood approach.\n", + "\n", + "\n", + "\n", + "\n", + "## The $\\chi^2$ function\n", + "\n", + "\n", + "Normally, the response (dependent or outcome) variable $y_i$ the outcome of a numerical experiment or another type of experiment and is thus only an approximation to the true value. It is then always accompanied by an error estimate, often limited to a statistical error estimate given by the standard deviation discussed earlier. In the discussion here we will treat $y_i$ as our exact value for the response variable.\n", + "\n", + "Introducing the standard deviation $\\sigma_i$ for each measurement $y_i$, we define now the $\\chi^2$ function as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\chi^2(\\hat{\\beta})=\\sum_{i=0}^{n-1}\\frac{\\left(y_i-\\tilde{y}_i\\right)^2}{\\sigma_i^2}=\\left(\\hat{y}-\\hat{\\tilde{y}}\\right)^T\\frac{1}{\\hat{\\Sigma^2}}\\left(\\hat{y}-\\hat{\\tilde{y}}\\right),\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "where the matrix $\\hat{\\Sigma}$ is a diagonal matrix with $\\sigma_i$ as matrix elements. \n", + "\n", + "\n", + "\n", + "\n", + "## The $\\chi^2$ function\n", + "\n", + "\n", + "In order to find the parameters $\\beta_i$ we will then minimize the spread of $\\chi^2(\\hat{\\beta})$ by requiring" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{\\partial \\chi^2(\\hat{\\beta})}{\\partial \\beta_j} = \\frac{\\partial }{\\partial \\beta_j}\\left[ \\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(\\hat{\\beta})}{\\partial \\beta_j} = -2\\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(\\hat{\\beta})}{\\partial \\hat{\\beta}} = 0 = \\hat{A}^T\\left( \\hat{b}-\\hat{A}\\hat{\\beta}\\right).\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "where we have defined the matrix $\\hat{A} =\\hat{X}/\\hat{\\Sigma}$ with matrix elements $a_{ij} = x_{ij}/\\sigma_i$ and the vector $\\hat{b}$ with elements $b_i = y_i/\\sigma_i$. \n", + "\n", + "\n", + "\n", + "## The $\\chi^2$ function\n", + "\n", + "\n", + "We can rewrite" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\frac{\\partial \\chi^2(\\hat{\\beta})}{\\partial \\hat{\\beta}} = 0 = \\hat{A}^T\\left( \\hat{b}-\\hat{A}\\hat{\\beta}\\right),\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "as" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{A}^T\\hat{b} = \\hat{A}^T\\hat{A}\\hat{\\beta},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and if the matrix $\\hat{A}^T\\hat{A}$ is invertible we have the solution" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{\\beta} =\\left(\\hat{A}^T\\hat{A}\\right)^{-1}\\hat{A}^T\\hat{b}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## The $\\chi^2$ function\n", + "\n", + "\n", + "If we then introduce the matrix" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{H} = \\hat{A}^T\\hat{A},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "we have then the following expression for the parameters $\\beta_j$ (the matrix elements of $\\hat{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" + ] + }, + { + "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", + "\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(\\hat{\\beta})}{\\partial \\beta_0} = -2\\left[ \\sum_{i=0}^{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(\\hat{\\beta})}{\\partial \\beta_0} = -2\\left[ \\sum_{i=0}^{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", + "\n", + "We define then" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\gamma = \\sum_{i=0}^{1}\\frac{1}{\\sigma_i^2},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "2\n", + "6\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", + "6\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": [ + "2\n", + "6\n", + "9\n", + " \n", + "<\n", + "<\n", + "<\n", + "!\n", + "!\n", + "M\n", + "A\n", + "T\n", + "H\n", + "_\n", + "B\n", + "L\n", + "O\n", + "C\n", + "K" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\gamma_{xy} = \\sum_{i=0}^{1}\\frac{y_ix_{i}}{\\sigma_i^2},\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and show that" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "2\n", + "7\n", + "1\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", + "\\beta_1 = \\frac{\\gamma_{xy}\\gamma-\\gamma_x\\gamma_y}{\\gamma\\gamma_{xx}-\\gamma_x^2}.\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "The LSM suffers often from both being underdetermined and overdetermined in the unknown coefficients $\\beta_i$. A better approach is to use the Singular Value Decomposition (SVD) method discussed below. \n", + "\n", + "\n", + "\n", + "\n", + "\n", + "## The singular value decompostion\n", + "\n", + "How can we use the singular value decomposition to find the parameters $\\beta_j$? More details will come. We first note that a general $m\\times n$ matrix $\\hat{A}$ can be written in terms of a diagonal matrix $\\hat{\\Sigma}$ of dimensionality $n\\times n$ and two orthognal matrices $\\hat{U}$ and $\\hat{V}$, where the first has dimensionality $m \\times n$ and the last dimensionality $n\\times n$. We have then" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "$$\n", + "\\hat{A} = \\hat{U}\\hat{\\Sigma}\\hat{V}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "# Neural Networks\n", + "\n", + "## Artificial neurons\n", + "The field of artificial neural networks has a long history of development, and is closely connected with \n", + "the advancement of computer science and computers in general. A model of artificial neurons \n", + "was first developed by McCulloch and Pitts in 1943 to study signal processing in the brain and \n", + "has later been refined by others. The general idea is to mimic neural networks in the human brain, which\n", + "is composed of billions of neurons that communicate with each other by sending electrical signals. \n", + "Each neuron accumulates its incoming signals, \n", + "which must exceed an activation threshold to yield an output. If the threshold is not overcome, the neuron\n", + "remains inactive, i.e. has zero output. \n", + "\n", + "This behaviour has inspired a simple mathematical model for an artificial neuron." + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "\n", + "
\n", + "\n", + "$$\n", + "\\begin{equation}\n", + " y = f\\left(\\sum_{i=1}^n w_ix_i\\right) = f(u)\n", + "\\label{artificialNeuron} \\tag{27}\n", + "\\end{equation}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "Here, the output $y$ of the neuron is the value of its activation function, which have as input\n", + "a weighted sum of signals $x_i, \\dots ,x_n$ received by $n$ other neurons.\n", + "\n", + "\n", + "## Neural network types\n", + "\n", + "An artificial neural network (NN), is a computational model that consists of layers of connected neurons, or *nodes*. \n", + "It is supposed to mimic a biological nervous system by letting each neuron interact with other neurons\n", + "by sending signals in the form of mathematical functions between layers. \n", + "A wide variety of different NNs have\n", + "been developed, but most of them consist of an input layer, an output layer and eventual layers in-between, called\n", + "*hidden layers*. All layers can contain an arbitrary number of nodes, and each connection between two nodes\n", + "is associated with a weight variable. \n", + "\n", + "\n", + "\n", + "\n", + "## Feed-forward neural networks\n", + "The feed-forward neural network (FFNN) was the first and simplest type of NN devised. In this network, \n", + "the information moves in only one direction: forward through the layers.\n", + "\n", + "Nodes are represented by circles, while the arrows display the connections between the nodes, including the \n", + "direction of information flow. Additionally, each arrow corresponds to a weight variable, not displayed here. \n", + "We observe that each node in a layer is connected to *all* nodes in the subsequent layer, \n", + "making this a so-called *fully-connected* FFNN. \n", + "\n", + "\n", + "\n", + "A different variant of FFNNs are *convolutional neural networks* (CNNs), which have a connectivity pattern\n", + "inspired by the animal visual cortex. Individual neurons in the visual cortex only respond to stimuli from\n", + "small sub-regions of the visual field, called a receptive field. This makes the neurons well-suited to exploit the strong\n", + "spatially local correlation present in natural images. The response of each neuron can be approximated mathematically \n", + "as a convolution operation. \n", + "\n", + "CNNs emulate the behaviour of neurons in the visual cortex by enforcing a *local* connectivity pattern\n", + "between nodes of adjacent layers: Each node\n", + "in a convolutional layer is connected only to a subset of the nodes in the previous layer, \n", + "in contrast to the fully-connected FFNN.\n", + "Often, CNNs \n", + "consist of several convolutional layers that learn local features of the input, with a fully-connected layer at the end, \n", + "which gathers all the local data and produces the outputs. They have wide applications in image and video recognition\n", + "\n", + "\n", + "## Recurrent neural networks\n", + "\n", + "So far we have only mentioned NNs where information flows in one direction: forward. *Recurrent neural networks* on\n", + "the other hand, have connections between nodes that form directed *cycles*. This creates a form of \n", + "internal memory which are able to capture information on what has been calculated before; the output is dependent \n", + "on the previous computations. Recurrent NNs make use of sequential information by performing the same task for \n", + "every element in a sequence, where each element depends on previous elements. An example of such information is \n", + "sentences, making recurrent NNs especially well-suited for handwriting and speech recognition.\n", + "\n", + "\n", + "## Other types of networks\n", + "\n", + "There are many other kinds of NNs that have been developed. One type that is specifically designed for interpolation\n", + "in multidimensional space is the radial basis function (RBF) network. RBFs are typically made up of three layers: \n", + "an input layer, a hidden layer with non-linear radial symmetric activation functions and a linear output layer (''linear'' here\n", + "means that each node in the output layer has a linear activation function). The layers are normally fully-connected and \n", + "there are no cycles, thus RBFs can be viewed as a type of fully-connected FFNN. They are however usually treated as\n", + "a separate type of NN due the unusual activation functions.\n", + "\n", + "\n", + "Other types of NNs could also be mentioned, but are outside the scope of this work. We will now move on to a detailed description\n", + "of how a fully-connected FFNN works, and how it can be used to interpolate data sets. \n", + "\n", + "\n", + "## Multilayer perceptrons\n", + "\n", + "One use often so-called fully-connected feed-forward neural networks with three\n", + "or more layers (an input layer, one or more hidden layers and an output layer)\n", + "consisting of neurons that have non-linear activation functions.\n", + "\n", + "Such networks are often called *multilayer perceptrons* (MLPs)\n", + "\n", + "\n", + "## Why multilayer perceptrons?\n", + "\n", + "According to the *Universal approximation theorem*, a feed-forward neural network with just a single hidden layer containing \n", + "a finite number of neurons can approximate a continuous multidimensional function to arbitrary accuracy, \n", + "assuming the activation function for the hidden layer is a **non-constant, bounded and monotonically-increasing continuous function**.\n", + "Note that the requirements on the activation function only applies to the hidden layer, the output nodes are always\n", + "assumed to be linear, so as to not restrict the range of output values. \n", + "\n", + "We note that this theorem is only applicable to a NN with *one* hidden layer. \n", + "Therefore, we can easily construct an NN \n", + "that employs activation functions which do not satisfy the above requirements, as long as we have at least one layer\n", + "with activation functions that *do*. Furthermore, although the universal approximation theorem\n", + "lays the theoretical foundation for regression with neural networks, it does not say anything about how things work in practice: \n", + "A neural network can still be able to approximate a given function reasonably well without having the flexibility to fit *all other*\n", + "functions. \n", + "\n", + "\n", + "\n", + "\n", + "## Mathematical model" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "\n", + "
\n", + "\n", + "$$\n", + "\\begin{equation}\n", + " y = f\\left(\\sum_{i=1}^n w_ix_i + b_i\\right) = f(u)\n", + "\\label{artificialNeuron2} \\tag{28}\n", + "\\end{equation}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "In an FFNN of such neurons, the *inputs* $x_i$\n", + "are the *outputs* of the neurons in the preceding layer. Furthermore, an MLP is fully-connected, \n", + "which means that each neuron receives a weighted sum of the outputs of *all* neurons in the previous layer. \n", + "\n", + "\n", + "## Mathematical model\n", + "\n", + "First, for each node $i$ in the first hidden layer, we calculate a weighted sum $u_i^1$ of the input coordinates $x_j$," + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "\n", + "
\n", + "\n", + "$$\n", + "\\begin{equation}\n", + " u_i^1 = \\sum_{j=1}^2 w_{ij}^1 x_j + b_i^1 \n", + "\\label{_auto11} \\tag{29}\n", + "\\end{equation}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "This value is the argument to the activation function $f_1$ of each neuron $i$,\n", + "producing the output $y_i^1$ of all neurons in layer 1," + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "\n", + "
\n", + "\n", + "$$\n", + "\\begin{equation}\n", + " y_i^1 = f_1(u_i^1) = f_1\\left(\\sum_{j=1}^2 w_{ij}^1 x_j + b_i^1\\right)\n", + "\\label{outputLayer1} \\tag{30}\n", + "\\end{equation}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "where we assume that all nodes in the same layer have identical activation functions, hence the notation $f_l$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "\n", + "
\n", + "\n", + "$$\n", + "\\begin{equation}\n", + " y_i^l = f_l(u_i^l) = f_l\\left(\\sum_{j=1}^{N_{l-1}} w_{ij}^l y_j^{l-1} + b_i^l\\right)\n", + "\\label{generalLayer} \\tag{31}\n", + "\\end{equation}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "where $N_l$ is the number of nodes in layer $l$. When the output of all the nodes in the first hidden layer are computed,\n", + "the values of the subsequent layer can be calculated and so forth until the output is obtained. \n", + "\n", + "\n", + "\n", + "\n", + "## Mathematical model\n", + "\n", + "The output of neuron $i$ in layer 2 is thus," + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "\n", + "
\n", + "\n", + "$$\n", + "\\begin{equation}\n", + " y_i^2 = f_2\\left(\\sum_{j=1}^3 w_{ij}^2 y_j^1 + b_i^2\\right) \n", + "\\label{_auto12} \\tag{32}\n", + "\\end{equation}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "\n", + "
\n", + "\n", + "$$\n", + "\\begin{equation} \n", + " = f_2\\left[\\sum_{j=1}^3 w_{ij}^2f_1\\left(\\sum_{k=1}^2 w_{jk}^1 x_k + b_j^1\\right) + b_i^2\\right]\n", + "\\label{outputLayer2} \\tag{33}\n", + "\\end{equation}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "where we have substituted $y_m^1$ with. Finally, the NN output yields," + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "\n", + "
\n", + "\n", + "$$\n", + "\\begin{equation}\n", + " y_1^3 = f_3\\left(\\sum_{j=1}^3 w_{1m}^3 y_j^2 + b_1^3\\right) \n", + "\\label{_auto13} \\tag{34}\n", + "\\end{equation}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "\n", + "
\n", + "\n", + "$$\n", + "\\begin{equation} \n", + " = f_3\\left[\\sum_{j=1}^3 w_{1j}^3 f_2\\left(\\sum_{k=1}^3 w_{jk}^2 f_1\\left(\\sum_{m=1}^2 w_{km}^1 x_m + b_k^1\\right) + b_j^2\\right)\n", + " + b_1^3\\right]\n", + "\\label{_auto14} \\tag{35}\n", + "\\end{equation}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "## Mathematical model\n", + "\n", + "We can generalize this expression to an MLP with $l$ hidden layers. The complete functional form\n", + "is," + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "\n", + "
\n", + "\n", + "$$\n", + "\\begin{equation}\n", + "y^{l+1}_1\\! = \\!f_{l+1}\\!\\left[\\!\\sum_{j=1}^{N_l}\\! w_{1j}^3 f_l\\!\\left(\\!\\sum_{k=1}^{N_{l-1}}\\! w_{jk}^2 f_{l-1}\\!\\left(\\!\n", + " \\dots \\!f_1\\!\\left(\\!\\sum_{n=1}^{N_0} \\!w_{mn}^1 x_n\\! + \\!b_m^1\\!\\right)\n", + " \\!\\dots \\!\\right) \\!+ \\!b_k^2\\!\\right)\n", + " \\!+ \\!b_1^3\\!\\right] \n", + "\\label{completeNN} \\tag{36}\n", + "\\end{equation}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "which illustrates a basic property of MLPs: The only independent variables are the input values $x_n$. \n", + "\n", + "\n", + "## Mathematical model\n", + "\n", + "This confirms that an MLP,\n", + "despite its quite convoluted mathematical form, is nothing more than an analytic function, specifically a \n", + "mapping of real-valued vectors $\\vec{x} \\in \\mathbb{R}^n \\rightarrow \\vec{y} \\in \\mathbb{R}^m$. \n", + "In our example, $n=2$ and $m=1$. Consequentially, \n", + "the number of input and output values of the function we want to fit must be equal to the number of inputs and outputs of our MLP. \n", + "\n", + "Furthermore, the flexibility and universality of a MLP can be illustrated by realizing that \n", + "the expression is essentially a nested sum of scaled activation functions of the form" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "\n", + "
\n", + "\n", + "$$\n", + "\\begin{equation}\n", + " h(x) = c_1 f(c_2 x + c_3) + c_4\n", + "\\label{_auto15} \\tag{37}\n", + "\\end{equation}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "where the parameters $c_i$ are weights and biases. By adjusting these parameters, the activation functions\n", + "can be shifted up and down or left and right, change slope or be rescaled \n", + "which is the key to the flexibility of a neural network. \n", + "\n", + "\n", + "### Matrix-vector notation\n", + "\n", + "We can introduce a more convenient notation for the activations in a NN. \n", + "\n", + "Additionally, we can represent the biases and activations\n", + "as layer-wise column vectors $\\vec{b}_l$ and $\\vec{y}_l$, so that the $i$-th element of each vector \n", + "is the bias $b_i^l$ and activation $y_i^l$ of node $i$ in layer $l$ respectively. \n", + "\n", + "We have that $\\mathrm{W}_l$ is a $N_{l-1} \\times N_l$ matrix, while $\\vec{b}_l$ and $\\vec{y}_l$ are $N_l \\times 1$ column vectors. \n", + "With this notation, the sum in becomes a matrix-vector multiplication, and we can write\n", + "the equation for the activations of hidden layer 2 in" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "\n", + "
\n", + "\n", + "$$\n", + "\\begin{equation}\n", + " \\vec{y}_2 = f_2(\\mathrm{W}_2 \\vec{y}_{1} + \\vec{b}_{2}) = \n", + " f_2\\left(\\left[\\begin{array}{ccc}\n", + " w^2_{11} &w^2_{12} &w^2_{13} \\\\\n", + " w^2_{21} &w^2_{22} &w^2_{23} \\\\\n", + " w^2_{31} &w^2_{32} &w^2_{33} \\\\\n", + " \\end{array} \\right] \\cdot\n", + " \\left[\\begin{array}{c}\n", + " y^1_1 \\\\\n", + " y^1_2 \\\\\n", + " y^1_3 \\\\\n", + " \\end{array}\\right] + \n", + " \\left[\\begin{array}{c}\n", + " b^2_1 \\\\\n", + " b^2_2 \\\\\n", + " b^2_3 \\\\\n", + " \\end{array}\\right]\\right).\n", + "\\label{_auto16} \\tag{38}\n", + "\\end{equation}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### Matrix-vector notation and activation\n", + "\n", + "The activation of node $i$ in layer 2 is" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "\n", + "
\n", + "\n", + "$$\n", + "\\begin{equation}\n", + " y^2_i = f_2\\Bigr(w^2_{i1}y^1_1 + w^2_{i2}y^1_2 + w^2_{i3}y^1_3 + b^2_i\\Bigr) = \n", + " f_2\\left(\\sum_{j=1}^3 w^2_{ij} y_j^1 + b^2_i\\right).\n", + "\\label{_auto17} \\tag{39}\n", + "\\end{equation}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "This is not just a convenient and compact notation, but also \n", + "a useful and intuitive way to think about MLPs: The output is calculated by a series of matrix-vector multiplications\n", + "and vector additions that are used as input to the activation functions. For each operation \n", + "$\\mathrm{W}_l \\vec{y}_{l-1}$ we move forward one layer. \n", + "\n", + "\n", + "\n", + "### Activation functions\n", + "\n", + "A property that characterizes a neural network, other than its connectivity, is the choice of activation function(s). \n", + "As described in, the following restrictions are imposed on an activation function for a FFNN\n", + "to fulfill the universal approximation theorem\n", + "\n", + " * Non-constant\n", + "\n", + " * Bounded\n", + "\n", + " * Monotonically-increasing\n", + "\n", + " * Continuous\n", + "\n", + "### Activation functions, Logistic and Hyperbolic ones\n", + "\n", + "The second requirement excludes all linear functions. Furthermore, in a MLP with only linear activation functions, each \n", + "layer simply performs a linear transformation of its inputs.\n", + "\n", + "Regardless of the number of layers, \n", + "the output of the NN will be nothing but a linear function of the inputs. Thus we need to introduce some kind of \n", + "non-linearity to the NN to be able to fit non-linear functions\n", + "Typical examples are the logistic *Sigmoid*" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "\n", + "
\n", + "\n", + "$$\n", + "\\begin{equation}\n", + " f(x) = \\frac{1}{1 + e^{-x}},\n", + "\\label{sigmoidActivationFunction} \\tag{40}\n", + "\\end{equation}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "and the *hyperbolic tangent* function" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "\n", + "
\n", + "\n", + "$$\n", + "\\begin{equation}\n", + " f(x) = \\tanh(x)\n", + "\\label{tanhActivationFunction} \\tag{41}\n", + "\\end{equation}\n", + "$$" + ] + }, + { + "cell_type": "markdown", + "metadata": {}, + "source": [ + "### Relevance\n", + "\n", + "The *sigmoid* function are more biologically plausible because \n", + "the output of inactive neurons are zero. Such activation function are called *one-sided*. However,\n", + "it has been shown that the hyperbolic tangent \n", + "performs better than the sigmoid for training MLPs. \n", + "has become the most popular for *deep neural networks*" + ] + } + ], + "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.4" + } + }, + "nbformat": 4, + "nbformat_minor": 2 +} diff --git a/doc/LectureNotes/fig/Hudson_Bay_data.pdf b/doc/LectureNotes/fig/Hudson_Bay_data.pdf new file mode 100644 index 0000000000000000000000000000000000000000..6a81e9928655c0cf601697d11a7d199dcfce26aa GIT binary patch literal 15045 zcmb`u2|QKZ7dI|LxMUuZhHK7{JKt;0JkLWEm21j8T$jutk|Hui88d4#N24J!6b)1& zMKTkq=xOlobLDv=|KG>w|Gw8}JNxXj_u6Z%z0O+Sea<=}#_F2;P|{eK$khS(m0K_r z90~WbbA>4=z!Bzw-i~mD8j(zN_c{hg7!!{<`ohtmgDG4|3FheO0Ckl4V}O;BovWig z8BU<|0RzZnN0KKT2c5zY#w0I$Ge6K&r~^L?M`#3) zwamywvLhV3Lcq+K=-}dc431wRuj%DUhGQu8|JXqxLBpy5S|l$&Z#X21ni(9S?&$Ag z?`Wz8CIe^YB%-IUH<9G%X&<;M>PmklB}i6qfxIFt3}N8t;6haO3IMD_b!*`8`k0b`*#6xyPGwr?~^TRE^ z^+MVGJw;O!!*tkLyn1)N|J7aoLO+Hl9<*)6NIqJ_VUo4=f3V4ep=g-!$ z^CGYxueG=})bldOJTU5GBl^W5Q?JtUTvG@`?-fMc<(8A*QShz-MIo zFg7G*(4|%NX@fMozh0}os-zg_^gFRSbbfvhk6WZLZy^6n3OP(rxAN5s6^sO0x2R+x zY2+P0U+#ycUEzY-F&QO=+p-P#lO3v)YjsVB568Vs3b&+#YabLp_VMu=KLFaU4;HtI=RAKAYuvcS-n5 z+_YFqGnerdNw~4v5?6tjr=Q0QERU(?6TaG=#_zT_; zlSRukl|c`?6kem+rf{HLcyGI`v$>#hsET85v~E$f*pB4ANe(by2hpeR%1bJ5M(cW4 zn`B3iFUnR zxvzg0N_QVJ*`xjZ88-TU-=?_!7jFd~ayge%{jw$;%1zB=%oo$jo5(=QGri06D!x{H z-znw#tsNN;XL#?v9{d%TApa?<`n3wRG3OvFN4eTTk$Z;-yzc_UF^6&){j_O#3;9y1 zsI`yv^D31VgIpRMvLm{adg6^7r)TkMz48 zoO$W3Sf}#P?&%igZd3ppX5b1+{KhU%p>o3`zovRWlrjZaT&W4-DXHT3pY5YpZj5N> zi#&MG&90@-h>LJKrQ4#``aW-GRr#wU?S$qBKLdRZiIg5n|6Kbsz5kuv{g4~e1Y*to zHu|r`^knsrmlLjUJzw8A9#nhuKJRxh=xDpvuiNfNeH;5+-+H|!)V&Oq`Z~2(rhSQW z>FZN2pRYa^d`D*4o0zS!hnHIk6P-V`h>p=6Rzfrt^7kR^6RIF_sf=L)bl@r!pP;Xobb@;;@SPd2=qq zHjr^_cKqiwRSb=E!Cr$>oPth8+?M5l?_*=lAC8_F7$hT)=6I@nuaouH=O3P_LYzJq z^!-Q9DD#oYWQ`=V2id2!PKP9I7etwKV`A_pY0k?x6`8eWDK4S*A2aMu(EQw+*7wMM z-$iqeO8Iw==C@uPOXj~}a79h)O?pf+RUh+EU)7-uF|m_fcK9gkNY;cf+71Qk8n|MA zjlR-=U$2Pq4Eyeao}iA}47qL;Mi#Xi0#Sd) z!2jvbv9eI){MVV|67*PT1enzpWup;D)37M--DTH{7T@BDhZq@|`VoyhC(p;}>Dx}H z+YgDD8(mWp7D~9KBgzvFV8(~;(< zW?isLzd8qmT^%(uXwXyUH#sXSZRtkoY7`bRvn4j;Q88H^<>Q8^%L7iDJHnRxKmVc* zMkDPv5P7rF3Wr`J90rduM;aq5%#mok2@;Q`w&RTEQj^YQIGx%_$Jx21O1X?wm)qfM z3l7hyCK$Ih{5?1N&uIR?G%JH#Gq*%;vXd@|n)}uRcLkSAGUfc_RC=s#RMGLttrpm-vL9lAJzk zt@Qm0L8fbdBGVlg;n|WO^D-(cp1vBk_1+%Lwrc z9=~VA7vRcA@~352Yqw=|y~Sf-RjrVdXt-r~Ijnhh-$-84LPs|LH~!3-Ir%EjAu(5f z!KWl{bWaub;dTa2jok`?8b#j2RWFYBVmW%8m<-dlTsPbw$3kT*c;sOC^mTPvy=UhN zbG+_6Tx3gwsmlbZX%X^FQ=F=;g^B>$Dq%5z_eek+YvsLeb!>(E7)H^G?n*0 z$Jku;E_pd8`1N-tDlf#;2C_j=c~i2j6%B*0Hb#awgZqR-_pNQ&c$?9{hiOR= zQYnoO_X=-`F|-$kJu44qkC44ve&+5dlPpieX~(RKQp_ICBDaIiMK?UjtSTh7zRZ5P z@QYrf1w!@E~N0yCS``LDLgObB{cHgD<-|0lXP=J#<$u~u_ z-yTK?@(Ivy?VIuA!_fx6bTe`?MoaSgv_GIT^Ly2n(QH%{$24Qpy{)aD{e|Q9f=j8b zaZy4B0;bw|lcJ>K&?@rL81YRssP)`#mvjR$h-xbgav1tiJv$9=e`X` ze%2FED{iLQr8TUnb*gJTpu8Q$a)${mdL(`!CvHmk9OERnN8_z(`Ps)(C^0EcAzQbU zflFFkOGD{QDv{Hlnt8XY7r3Q+;d1<3?$vWemI02g zj~7Mnn~U>Zl1X7T=RIH9#~58wXm`QP!Z~jEfa1rqM`pflY5XexeFK>{3r`4Z?_3N4 zXNoi~ucqQ~DiVc_YNo-&PuVCdf$;6sIBo(o%5_CPAj>OvJ_!+vQ0APpk4)ZN5w*RYBuL zU)vxET$B#69r~LE%x1v_0k_5!aPbxF09?>O;G%O2=hybartdcymz)cDceag;HfC3n z%MHfpKaUj{EU20!mLZ>zokD$_M_3N9@E&p2y>Vu|Tje8t#w70sTET1I3^Emg~n+YEawUBa3v@=HXnT;V@7&zJR! z@9rP?tQfw*0&E(itP8{jCbvD*K_Gt1W%G_|$}KRP$@K77FST}t#3pziLcCan=WDAT z^ANo?>%Ecl7HTJU??+8zq!imndiIajx0`d_<1V|DZp>>p^wXL44i6b2DA_^(Ho=kE zw`=iTKHCLbQLOD%FC9_d-a8nFrr5l5%_^77w;wm)lDf|Q7}GX$fKVw{1$Pe+;T&$I zQm5_XO?+&dA6Jo@*h1P}0!yMhWczZ0-{fqhWXcOh^5qu~ZasQ;W$ddzK@IWgUCFJ0 zQ06JU@}}{^V5yMns(T)N)|Wr7BXoDJh?CukmCiIH>wK!5qFv}s<>eel$))e@-3vdN zxcAyfY@ol*0vVaLH#W|o9x~vmj7auJ`LCvv^*&6$-8x;TA{Poz;ddL^5;>IRC9qV4 z;EVEOFp{_}BIllWstT4AJ7kFuu(*EaYfVz@w0jZiRj%VdPrGjFbki3O@~3aW-e$4L zdcT9gf{nuyI(Da1t?TY^TWY5d-hBM&;_2ZBi?)s$qtaP&ua=fZ0 zdG?e+^2IR;J-(Yv+08YvV`-reSP9q?dcSzRrfqL}oe#nud;2ZR-_`0nj#J>hWIox$ zo4{+rJ^D?+=yJ@2?r@00UICk6q$Ur?h}l!+b5%CiJ{?j0%5rl@Ws{1l&RCV0!YjWZ zBWX|G$84+)_2x^4Cet%dF!!c)85KEdhpc8pFjD1Ot>1+&&#HB59!v;xex7bQPOlr~AuWg9*&U08OL!sr1_Wh7i#Gb8>yVy^ZRm2QG9*9&1W#ur$AL{4U~fpLXc+ zn6fY@hu|vh$BC(_a$i)jqOSzl6@|beO8K5F5Wi;n;oe^BaOug^T0{Bxq+B7cA+Hpn zp$TqXe*^a&S9;`f^B6j7rBBOc2w(Om`nb-g2?*x++2bBAoi!BnfB62_RpgY3aMH75 z^lyAb^9|At)5z8bmX#lnkUgz*c1WxqE`xCPT2lW{owxA zSsTF(w6|RKiWIM5 zElm|gru)3n!AiIb(~Z8_v!^gQFM&8v}2 zdNH;xkCgd1)mu8|+&<3SP?Rq+LxzOT!=Fh?NX`cjZ`ty1xEJaK*;(Ln|>lBvba^`>0oXb5(c_Xp* zX$@wx$OnyHYjZdw`AQH@r(~n06ZzsiY`d#6%n^%TIS!TEIDTn=`mC-cdStYX;cDM} zEf3#mz9k;B`5THe%~6wzbukPdhE>yv!kM_Kx=Y3HTkaqJfO*k)d)qy`G+x?TWb&8P zmW)pSMynlSK8BV2_Ak}l?GH~)aJ^vH-%BHqHG>ps+sQ2+TA3dwD`z+oJ7!nbB7OfO zF|@G=b-8J$C7sa|2jeuwkD|G|ct5}Gjeo0yJ$r;2ecqOsB|O@7&~T~OP3xh_SwWOo z0pAFk{aNO9J6IlLi<~@6f}8Hbq;JO?rDf;C)&?6`+GYV63WHhW7!49sIGO<*`WP0S z9bU0zA)6ee`|HHMMEoq>OkDW+Q%D8{JLV~*$ep0?Lly;k-uQFhMEEom7+jeKc+Kgw z?9XH^y?T>3T{t|!WpH+i-S>HQ0hwST;c+*sZK)wNXK;^2t#DT4ZtKY?>8HY9CuIbhvf?>bzbO4V*!JF*{Ny{Ktqw#zhO#@(eazAMbym5PdKMIUuT3%U`q-XfPkJ7zHfB@a`9`Iv z`^TQCMONc8PNz4pnax7Gb#8w{`%PmzAkC{UMgNHUX__}oFncRiPAGHD29s_Uu%S`w zu#xd?cJPb`JQ!md=?a-4baxhZ{_+scEKtR(a->|;Z%>Jl>qxpPZnR5D&o1Up%m+^g zyoiJbBDq{-@d<1`GMxu;=*K+&_yqUpd##hqT4Pp6RQu7CURxwCuU9Ye)) z>bLHGJLBe4BnMOX)^z=JhD>a!Y*Q=frNt@IxYbZy9}N0NaMmL8g->(FzQ-2sR9k*g z_i&0P=8WkE4}F2EH~H)UzxLUIMxq`^GaNkT&s5c#)7l!6O}?f3@%}XdgR1c23gxZG z#b`@w=s2I!Aw2YMF)3LycC`kK<2`X4BeZ_u2MXRhrv^gRF!%eOv3aK>EU=|Z zt=D4gSARvb`HaM=?I*NZCn_y=Pnp^I#ZG@JG`P@#4&*NRVAQ{C!c6VC{G?5#`es~~ z-6+S4mL_3^4_G07v6oVN66B5eouXSG#J|sy=CjS=*@Cl9eHSOw3>CED%7f#D&m)Pna7p+O;w^8cNqwzU(7gle7HreaJ&VzXk#3%YbFOF_` zQPN&{unn$rN}ww=KR5*zU(yjM$=$@7oX7sv}WwMS1 z9bK7wr@{!SSzRPdDzV?hZTO|8Q*P7TjVq6$KWg{4$(?p<)39kzYdWSbHG+De@F4PI z{}SKsZ&x3+SJAg3`WE>POqVitsYt3l1Lu`5CW_X;##D?0U8TeGIQXr*$cot$y$>KxIVlCpgG{u{h+kXv5W)iV4t z@_1{Y^f|PLqq-aM*vW#{man6)5(;S#kGDD&$WVXFkZ7XOz4*xeGW=KDgg`Nxt?2rM zuGmcz?&Fi~HdXa^vUJeaiyCJhb9GHMWqdiFj=u6(J}`~5&`@KEFSwR=Th{x@KDUf$ z&6~1~k|H5^{~*$*yB80#wwG#ab3eZYGt6(}(tDM*bn(o^XFZ*BZ!awJomk$284lU9 z!J=#y0itkg5g>@YkV{kdwNPQ?C})_gc=+`Aaw+dO-D)qYeK9vg%*ytN2^I~!bpDJC zWXUlQIUw~)v^IGMiJwPB7nL4hh`N%0GcO~iXR5BGtj^CV^|?!DN6U!?XG=`7ViRss zY|dbODMz8Yblf`k22)C?a*a%ujxj3qhFwH{rvC}S%ssH_z1czt+(63BVmAzUq4uZg;Y@D(v>=(MaCE$LSxc$d1m7DS{r9&i%X1TV&?=YR zanP-|nM|^%Y#PyundCC~res_6gXK%&`|;g<0=LXwqy=wh=zO41c+ScoEx3*@0>Nw$ zTOYl!$S^LsH6O_tajWI+e&s4*q>J~QS)$vuLw2z&3Q{~)Rg#ac?GQI_vj~yL*VEIH ze5#%l@4U!$b0Big@w9`MYsHODNAXX$zc6l(;vPM1#1$Jo7Qx~qI4?$H7yPx)&e9T5 z#?JRbCx+gX_L;jU2NJ7MIeC)*mE}X+ej}~E#&(taXBwCAG8qV+z@v0|Yze%-Si1Y# zDw5QMxju!~G@KT44`gV> z#F#suxQ$(qCJ&+y>hDq`cBOZ;rJ--~57io+yy~86e(j{c!dBMWV#g~CVWl3#NvV0} zCW|9=54Y`4)Vp^4uEo6*s%FRwe;XBU)36n6v;LGtF+qie1_d?*fzkWf#QjyR2CFQ9 zk3Xt+@y(GZ3~?wPRW+{?SC&hW+a8`R)GK*0Cw?YYm!&PkmZh-Z*{);fgY0Cs5A3ey z?;5U{_=o*=(t*$?qnfuwoFlcS&0Gf3d^jJ_;OHjBCvEcYu+`_3TE4<2y{WEDa+4`~ zdv~mKYWcav;L)RRrQwd^?9##6Hz%wwJu)wY zA!uq*DHoVaMfOi7oyO>geIXqlHu-ed-Syb0z^pXBXvvCn^wz0Yq^B3{DvWlvBigFX zt?~}M$yb|?-pk2KweMX7-O#lTvgc}a9@*~nwlpg7dsnu_rkC{P#zdtimF;>qA6GDE-FP^bXl!lWPaEL$ zgspGzd^|g5<|&`gL3X$OiWB)J=o%9~R)b?9^Ka0m3r_*rXKimf)Q)wlirET}>ZFf( z3k_xWt1zKH``kz~a$igrKX87IPQGIc&E21aN%7sm@1){v`lt29=AOC~@8rC8Z@1mg zll$HEF4;VkjM3mKxwDrc?4=5)Pl#2^qC>v=@#-xvggAShMc9}*n!09?p8{F~K@6!L z{jBbsufDtI9J}J)%9anA+~vhTu0F2VnawI1>{XqR^5{`X6nBq*P)TjK{jQ$l+28;9 zu|=9Hk8gto-7HK-gOt5BHfpMOZXC(bKgMMPH(e4{G}5Y?yuJLjulgc4kFC9ShhADq zq5i&P^VGw7VPx_w`WpdzL$ka5%jhGuQJo4I^vw=M=8+8Rt54j#daf{0RcO!laP*6` zrs=gLImBF@VLR^dWT-`=@6pohCKiI*IW1FOi6h1Ibl>8TbB2#X@5MR_U@iGPZZ@c} z@|4ghBAGbr1>e7M<5Y|fV9LG9nsNWMG@-{P!CgPxtnM|_U}?$=6f1Y^<(<=-JMQM> zkILjV_bb}TekCz#Z5#@1^;^;{&=efa>p@l`g?D_9|1VlYK{#Gt(4GILgjOvcQ_9Pc? zvKI-CqU3bK5r#w$kglli=t?}`X9f}~VF)NI(||}OxlpntrIAR;jex&@YanY{9BphMs;y`xxg@e5XC0*3a&yGwYS;Rs5KsJo*RNL8g&NiN5n$#Ae2KsX0_J3D&9!JAe@kR!tZ(B0OC{M*^5d8xG78p${hj5{7V)!-6n| z%gDkJ2jQ{=ID!aA*uhaqAddqW3TS~7ESMIKZ~-+i#2t?CfFnG?#DF&-8Mp|h^aVV? z5q@wKi1mm7I3f_#a4>`&2}rcUJP?0Hb^j^>+!_dd;%^0_SGMM>8Bc%idLRpc@?!U) zF@SMM^Z!%LAkmiW=y3q7CzRfL%onH@hOp9JQ3GiFZvp=>EehH7b_GWm5CbR%0!Lx6 zfQlN?`#(B5AVb;3Ud8j6yCXE0$_kURXv(X@RXJ8Sx7Khx68Zn4!2bWz!GMG@EVwVQ zcqCi~1W!B$50eGZfdDK34PG{4K-LgcaDY$fI@BKn_LP((csdUH|E~gDy^aBWp#srZ zEjR!?fK34f$Y4PMgk)vl1Ohk*W{(4t6QBZ8xzMsW7$|T&FkBn}$1->foB(W{0A42H zk)RG8q3ak>Kw2CDjE88-0t3d&th7N#iZB=g3_3zgKte$UkHS#K;(*{QG(cZ4FQtyb z0!7GB3XUL4Im!|Mzn~qDLIVL;=EZ_}ap3lb!Zmaa2aYm8S`-MG4RmnxC?0 zkOBb@K%p>bP8=9RQOYWF&=ImT3O88j1PQ4KVjB_-I)Xx34`{lT0>k}YvwumgQ~-l3 zB+x)&FboHA1vrO>LuRnLT&qX0WUy66C={?D7XgS(VIQ)Cf9XTLAekt}1Smo0|5AaN z0?vbS?Kc5gyexdRK!&hl1CSl8Efie?yMS!sk3z8r$R<_`#a4dX1Y{3?7Kks(IiLaA z#%h5i$0KoI4FRu^4Qx|#9aEGnb?0`dAsX4-dhoD?_fP*EY)SSQ_wNi5d zwguH-Anag&6Ze2qp7MeT-N9!NEB(CS*xz%2fcSe3Z{XlouKL2k3w#O{5)>{ebNGR~ zdZk7NcDhmv1h>*kEdboJE44r37H*{p1gqc62A!|2nkKj}R;K&!`l`!^z5r1{t$YZg z0>-R{zkfe4LD&=Flnog|1-;r0_5a-sf|9>k_#-<0*9h_Po3H;GA!%2cH2}>1md^k< zmzCB1uPdctweN=MrT>B>O)nC_0KdN%0W0}iwBKLiz!0nP86yo$Z6D?TfBz1z!NeHz zwqdmK-0(Bp0i9zbR z_ar7$LyvKXp(9&Ig%4t@cs#!P30RG%kJ!|H_ov~ifiHi^E?%DM(3enq)#cDg6c&X<$)NBU z6k0|Si55d5#l$I}S2_3rhzH;6K_q*-dy(B;?BL!GPH;P-y&JGr(1k(@p!Yv}prkR< zC@Huznd~ixK>RmU+KY5d{0~D9AUQh0K=8uB0DAcS1KiA*3ly%|K^2&{(BAr1jN^m#RI^yzD@Qo8v>RAMHcAy-x|r_AWX8ZO%{s3 zYujX@r{L?`Hn2%q0_36Ajg|dN2VlDjL6bH8P#6LPwpQE7B%+JEBZ>04sg9=;*g8Y5 o4?qi3FE7YrQtDY$kL=mLByFm#-K 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 literal 0 HcmV?d00001 diff --git a/doc/LectureNotes/fig/Hudson_Bay_sim.pdf b/doc/LectureNotes/fig/Hudson_Bay_sim.pdf new file mode 100644 index 0000000000000000000000000000000000000000..b0e391469c4861a2a2206a3fafc7cd402454185c GIT binary patch literal 18298 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

>pCi-z{R-7 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 BK34z$ literal 0 HcmV?d00001 diff --git a/doc/LectureNotes/gaussian.pdf b/doc/LectureNotes/gaussian.pdf new file mode 100644 index 0000000000000000000000000000000000000000..45124938ad1a1d3cda319c704f1f53b32318c0c5 GIT binary patch literal 229831 zcmaI6Ra9lmvIU5{yR(79-QC@_@WS2Q-3r&j-QBftcXtXX+}#}-&b{aL>-W(gIWjYH zM#Rjy)>tEA>`kg5B1X$d#{xrIu?8q_g<%9R0Bj8`V0d@{^a}c>#*P4{Pm2KYYO1wgE6)-`T}zNF9%UKCvjybeJ5i8%YU52Y;BwX%>P*{=sP(XJJw+n55_{^PDL zZ(w0;=mcQ@C;0zMhmqma@b3i#ZES3v96wWh`U`(jF}C^KasDTOxPz^;9pLMl!pZ=8 z5n~r~Lt`cJ&(xng6$gDAM>~B7V;e*Fe{cRD{AVJ1Sz{w}eIZ-7&$wU7SeTgrOdK3v zITXHJoc>iz$=K1>*}?Er!Y_^fN5U^v|CfGWbpGWlW^VN<5rAII>Qh4zV?$e`PswGB zZA_ia0E}NxM(NAZ(aFJB-x|g(<19_q7H1#%z{9i}Kg)?qjMqS?d5wb=A0Tr!A0Xc&|}XW>d!OqEBgg&0dGzL^*E;1%t= z50-B9#`evf#17|sCpK|a6(suL0peMLbdRn5`|A*c7eCJjs7=QJ{z0HQMLt$1Nuf;F zJHyAQWB?W2D(_3VJ9w6=8)#(>7(1R-PwP9qa21jLK21Wv0O`-5#1PCjXR}v^_7WO46Spf5j+cr0t8LoOk)aJZ4QbVp3hevG z3B1*H-_~XB%@9Np43UH)7LC?+z8;luPP0;t++VXpf27P;RZl@vH%*(I?Y+Y*%LEOo zv^6Z>&9p8;Eqh#HxBhDv4T#&*t{4?xZN*nLSw-)CJ;{V1u++cTQ$^o2F83{Z4Qa$b0du9o z$KE@@qn`(eQYMaMiT2LbEt|Fflp}3{zDi!vmbG6>DL2zh_|2cg8XOy1+HM=g{-?}{ zu-%%{LP^N!eH~g;|MyiGe(OIQDHW8zW~Dwn1W<;BE(Km#dpF~yMpMmI5Jss;l?PFN z_ItnoCh(o3*7#;moKAgG&pj3^+*DC(hLL6)y=p%5I*JD)n%jPJ0&x4KyZlWOt&$;` z{K1lYBTcsv0<3AV?ms6Bu`isKqE~z5_b1UzHa^Iq=EJQWx{y8juf$2+ir@2c(A_PD z&Q}=twUwg`8Xiso?irSp5GcKbrPuRS>oeyvRf$+Ad!aWL2Y&>wIhGs{kh`{#gfMSE z59=*Yy;HKE>Kv_!+<#f(f!|Zz7MIAMrmoeS)0nZ;2s0QQtbF=ReG3V; z<%T7J`QbvdPP2INqV=dgx z5MizCUl9itTwM$U&tx%`rA`c(NDdIWC}?4T6CCg05X>KlR}CpR1vRIo7H)T?2YMMr zY9I)qT}&L!5Q+}9pr=J+!gg_^r<08w-?VC7^+U;=Rso+7zFM>YB)Yo(SJ|v`7?~B1 zm80UdWE(0bGo#;AgUOhGJ4H9#@o%!IJ7EvQtGVj!=K zi>VzABYK=xxeGEj3Az}XhP~jDL_e>(+m@+VKUe6 zcBIwL{{9-7wh)%?ncVAp<%Z|2a_%;bbOTC$%81>11S81z>PtS-cD-^Hj!u*V1xETk zpPS&ES%$vKg6R}S%)5JNVG=qA+fX3NMk*HrQaYjlsyZeS#_P@YWfjL& z2go^9dNw#74is560}2+0Xy@&|$OU*RU;Iuy`E5+rfVXU2*XwetYw8h|vw>PO?wx$ou!^cl(8(;^j*-vd(iEO@(6iulwGN)Ip{CPSw+D<1cf z@}6SRyJ}oHOA#gTyP$@JhNtsyUx~32W;T-Bw=pXi!y1E)d+0Y3@WM>0&Vcvb^+YL? zv-AX@w8O`Fd%Q%9u_}0b6kNhjV_S*UEvYOfczYZGw+@umP$86xwX}PodJE~vPBIKZ zapr+~WKy_bbITAnBms@Fc&JvIJ1KfkzM*=Xn0$o&H6mJY)VNS%gSb%T%HFO}bMrPo zNZ_y&*^oleN`|1yQ~wk!lZk+U3#h9qk4v8g&-F*D{<#^00Dy8M# zge@wP`fa@upwps-!|Lg#Z|#Mq)u_9WZC;QB59`un)t_9*poB%u`f%tl;isgLOYM$A)H$0Ei(7hGmf9?k%pV%&xbs^;4I1XXq0=#p4l63d zO7KVCSWUiOd)0KX5o@V)6rHV(bKX75kKq#aVmjwAx{W=TKevY<;o|hy9xV7e==bzswf*nwTX)avMDO-D=sR+J8!dMohiv|KBY`A| zT63<<9d-qKCxdsqeirn&uby+lka(8_8U@+JBFCWaz`_<8z6del%SDivDP14eR!00< z(pA6OeWrBQ+gm%meBB*iR(JxMhakkM^TQdowFH-b?URFcWoE-!VFi4nQE8v9<$l@v zcu0BckQ2bZ#C>hJqIo~(Yuw&bMuiHkOJDGD==yVNoPbp8xiGus-q#lph6+OWeYd;| z`KeJX!6()1x^zYaXu1~qg($-#wTLHEi@`RW6^n(xQe+XDZ_I>Edb=PTT?^&ItA`S#yJ;=hI5 zKLy5DCBnqW$nbA<$M{wKeHpa?Z0xK6PG)uh$LGw>!46<&W%yik0ysV~U$*}}v$3)P z*qB)V8DBnMgZUH3%)$)A%Ekovzk`E?6Tr&A0AOWj`JXsn7)Az0j?c=6h54Th|B3MF z&B6E;@t;WlGWt4W`ONY)zC6De{e%DS{C_k4pZ))b)jxj!u>DUQR%S-P*ZAj_pG?^~ z|9k7tJnYOI0Ct8?RX9GGf2zU4$N}@kkAs8ZAH^6M*uEtDbYNitu(NUeGjlL={v!=L z$7cezPsh)ojErBbKNnwv?Ni@R7XL*0V)MoJUskLv|IzkKuP=>R8JWLy{Ri{4{|EQA z=lryP`hF?&Y5(Vj|KLCEEUceQKQUiw{cHPreqTQSjIU?$nUj(6E5YaD-|^#rUW~5_ z|KGY*(9!U#?)`crK05?E31f3pGpEmo_Zj80vi{E@EfXu_Kb5ViBY*{l{;M+(`cDx} z%gPM+=aiB0QfR`X%Q7Y9hYE|9iRr zzoMLplbMy}-x8e>!1B5OclX&8uro0+!Th&=|7wE%ckLe846cATdd(XN<_eAS4OTFa z?))5O?FWXd>(88?fVMVIfIuvuhqOgFpiQ{f_xD97?C%S;J8x0+w&G&b{acxbR2>Ht zcTz4vLoMOhl*%Yn{Mf8GSO5)m0fG?-0~6C6GZPb0d;)bkw}$__rT8~Ba88c2)jxK; zH%Kl(*c|@W#1L|N;u>1Ge!uF`frjCL>g<76eq&(+%S1+Id^k5aZ-RtkwWQ#J8XW;E zHL(H2MI7|CxLqL~m6^#e`99uYa+vZUfH*l<%s zfTWtl_5tJ%{7FCxS1F%Bdq#$q*49~Eb?(_!u9R!VIS}oM%yFP_fOu>m>@e0P7V~DN zKkMPe@*(mF@Tkdt^ar*=9jmnEu*#IG-ssLg63BPjliIYG&a+8aDh&z@KVPO*_183Kl zMAg<*HnI*6jvymn#pQ(l1|5d-x;}^V)vYd!sw|H>@Qn-m9aTGGh&MRt0!PKRe?JM3 zjO+65ChI3pryPdv9vvPYo*aY*S^*WX5i@~{!KG+h^?%0!<4fxibo2bP@&{O^+upBz zLRMfCQAA!G6ced?qz8NV?8$3WJ_rg7Byu7u11JQb?1nTd$Sa5nqxHMtKkXU1cLf82NbX7qIKGI_g?Oz6_uI;(!Z|ETioDtgs*|7aQgFg^Z2BxN+EF7LuCdEdF}LV#G@S3UP_^Q&K3 zf!4;ZYubFSc_P$ho%V&%99|rK^o1bJgzH8pHZ!!i+vo#hNZ}4oZS#-Zo5+kDe@_tc zMJ(aL$VvPSFY$MA=2g)V$VotK&=)aaY;qWdh9-Jb`o$6stg4K^`uqIg@Zw|bYl`{` z5Cj4O#ChoEy1(8q%q5s_05!<&y_ydw)}ggkW_JS6CRPV9SrbBNO!63%9uj*^6PsJZ zyD<<5mWY6=oIC^>P+%SQVX8lNH^5NO+U(UxADE#e{UcBv817m=6uvvh$mZD!)Wt5y zWm5_g@=X^N(k*0V4o!~1$tysBL7dYv_J}!JFP@A{9!X|qH<~gr4h(nGbpFuMw)4T4NCBmoe@NIj5LQPA9hdNiUuct@aVN0cGFaO5I9~;YFj4u zAteSzQ&(vEDj%Z}@X+;vWSt+$6%gk#A9lB(U;5ADZQy!W2X7omY4X5?RM5lJA;YFs zF8)lc6T{AQ{xN!0h9BaWeb{To2Y6v>I{DG98jtZ-*ImaL^ucxeRK*dGGfNm z(?86O4PR|>umU$$$eB~vhySi@mQF6G5LCnNK2o^)wleX<^I(78h-bzS^e5mksQWfJ z3n``b5*6eI!(B*kQoeKoVV~+gs2gn{8!08L9~Hzg-b+Z2Nl6}RT=W^*|MxHt5d-E5 zIoSU7`PYuuoFFCQ^%JG&CZtCf{)IaFv{UeZq7pw*dCx)J+Vh_&BA!1%Gj1r_444z- zx5;|gSQ-Ht?-WFGMa9SOj($(s(7vje2Zrk@+*q7i>FWMj*KrAV^!DJ*F;fv431=63 zAKJKh{mLu$0f7u&LYsidEMC-2ipcDqAviAx!m)j9Fh@3Th#r}VEJ23814N{hKlP@5 z$m1i|*kB1B_ZfcNcp>DHV0@iAY*T=g#4~0n6XORszNFsI#oi?x-{RHR;ubF8^Wg>R zsnUIcPUSMw>jR#R{|IJC5|Irw+( zA4ND*wXpfyVunmdm+`=Sl*Y3MZXY$@rldi==CQ=NLGw-L2=DfEqsH>PUsqaz2n+Y7 z_Q4-1Xg(}-{bG))^nIiKicCfqpS* zCYSB(hOha^AbiJvy10lo^NV;bgZ*NZ$R6yna=GOw5QsJ(FaAn9WCJ;CFZY zoYUs$EBtaY_8nf{hw|2|(O&!BsY5gJL}Wkw2r;Ph zR_D%>Mdlx~Rt#RGGk8kvl1tZc&uTu*_#jI`?2hb{KP4rjt&s0q~ZF zu>;5Hjv+vl8aE4`YCPzv8HKdE$jYMeDA2F<%!ez-NU15#DhIeAA%L~~V0kO6bEfL3 zA?Ud}M=ynMQ}#ai6%i@6G-GOcU5Q2`qwoV4mQzef>z?LG+Ni(mEIOMu%vMP|bx7)B zYVw#)fmH^Sfnvut|L|{Iwt!_N?(s!^eW8XS(#hej`SxTd`-6`^4iA-0)E|G|qag_n zliomjTiJ)i2@A0*o2mst8l7hKp(S}qQv4k?1!U=94;5{o+hRf>O92GQLbWhF5s2UxW$|y&kE6)7 z=g<*Zddx`tNo)}AQoPDvc&O~iJ_i>S0;6sStyC0XHWupggMx~TPz`!Lm=yEu5xi}V zHMO`^WrNv%OtMl^&;?k<6DVr&#orFLdz*E!BjowxmYw@-Uf2jm!bE*p`tGs65s#ud z<@{ZA;GjU5Q>EYtisaE_>?Xmo28_l9;Gn*vOu3Dxj#rabMWl3Y-v4&#R6>&ULx%s> z1InO+EbGWIwCmGG0L)$?>(8HQkyWxMPuHs7duFg5FAl!fI91O)E-vNmN=a!Q!p$Av zzSd%C%U?z*eaNFH!1+wXG6`jxH91(@YFtOQ&a)7XxNp`wRl4rTe>+MGbfW#DIj^aO zhJOHC)+Kx2(usK^+IIm!h;+$reVxMN{Mp|x&Okw7My5b2_v@6t%*l6}hO-|hWr1i= zm4V_c2S0~hYd}K@52*(NVf3xQRQIuRN`~yf>KMEclyo|kQPD`rcPvblv!~7AsuxA` z5-GTqvq2fjk&GK2mZ)fy)%I`E0h0c5k#U);3~wH_?2GtKao(Wa-1~&{&q}sk%dU2c zWMfFkI@{%jU{A0o9}69cvh1?y{BR`cH#Hs;`^q>rza@)n$(D@Dngr4PuD0DKAVjMO zI};H9ja+G!7W6l)R&fbiHMOR-%iRuW^!R!b{zbYhVkQW&gRPbo-MM=So_=0H1rCuW zrGpJ+oe7QPYt^9Y(9LB#i)kXDDnaTf_V0Kyyjyn>%ham2FRhWj)HQw%a}DrzKoAa@ zvDX5;Zc`|57i&HCguu~3s^+Bb>Ei2LSiPtrx*>MfCMj;$k?+B^dN@DyC(a? zkFXw?IgcA=6sUM-;9bP<1#f6CK#zI~Tz9UD0(R*qg*PfAv-)&1s>>@- z5()3U+*-w-WyE5gS@=yPk~i)8@tEzQz)_?)jHhxyNp!x^!#Xe(!hEbT#`t;;3Yph@ zXr$mvqxP|xIljNo4Q!F0&Bn{ua?4=;87@KHU2Hgm92#$vxM;c(q7wRsn;NrFN@n#J z*V1Qwj@h6EWx285f$H_Io+#mIwF6kSJY{$dHAzWE(%3m>1)sffUBe8it2Gwv_Xe+H zmPN^6I6%kJ+wn_N`<}&Pd+9`YTB^M|QePb)QlD7Rm-Bnu+&YudRvnZ*Z0^Up$V z^NLXo>#UF(&_(0*x{3*8Js&g$-=HSB2a&HVO z2(t>0P^%Admu=*M&B{UM2!MB;&IQdiq2e>6&Si|I%W!9_p*L%`6bxIwgKEZaD**op z%fR&?)R*~Cs~R7&t$J>^BK%&Z$U0#D*qFxq3i7*}*TlZUVr<|nb}=*NFL$@sH}8Y@ zKO;@rMX;JH#7BP@T>##k9^31Hm0~-^jK@(!?#_lV*>AAPu%3!N5u%tov4_yBG$&xM zLVq-Ats^qL^ISnuya8+(0&>KGQ;egf&GaVF6_`$L94sLlY#nQ+0`Rq53rgj@jrsXS zSVRkG-cMpyY$5%QqJlLJB3Q?h3GzeGS{?N>kXeE-#ZCU&!@z}6>E;H+XR&(6Y}i1) zQp*bC66_>6sdsE8+z;_S&i=GbDDR+eqr>8^V$u?*#++TmE3t+IRzdwGfv)^1>_e$; z-UK0VRzvb7s$mPGE37y)oLIWTNXO1V6hZ~kMdp+@Z6vY}#uoh>FxaZ?Otpz)Id|tj zd<$`-C-Ibcau~Hx6B+#xWm$+xue0_ctCxkjE1Rj3H{*3U_vD9G;DvF(6AIR~$D6il z(3$xsr+M>xgQB}F{YUa1f?n3Bsio>*;LIE|@xU>VJiZUrrV1UqVkSyRP_p7FJ7#ma zY-9)fmh*ASYDD$_HIHlT6kuzBl`Db9Ct9!z_A0(_MQ%y+(8||usl0iyCRtx7YA6^E zcDHVYg~(lHXOhEVB#v?z8W?|QT~g0b(8!iAC-P@g$UpBoVOKMu7#;5=f1YXRq9+fI zp}(VnnH`lJAkC@o@D6X-{xl3@vGmP3`L#8-nB2M7V;gJ2&0hofo+==|FtUQLX?;j@VbXxcrE;2~sLOdv zC%{e6JX&@^ZEI7!MzKQeR4Oj9O>H(SM)NjlD09;+L!vgb?!A7aBMSA@2R>MW8vTYs9 zgd=>mdAwkqn44B;V&Q4`u-6F4h{6npFBU;LMZ%8yNV_@8Hw#rCFGE{FZTX_X=kl2a z*vw^hvk@qG^j+hKp);e@vXIT5k=1~vRW0PIzkYTe5e6Tk%?bT@cO&Fqt>F$9vL3n+4*SFuCyx^Am)GKCA z4L6C9c6FpHRCnP+I6(kM5y_A_9d1;{A%w}cKmZ}C2l|{#x)h{er{iq+O|AAewaS3hMW5E zG8eI3Eu|ns`E%U&ENiW)pjBY`C)xE%3gI#|8GTHBp*C}WK?rGqtjCaIabZ~&`iRbW zND92#1EXNKpy7=dO+C@JkjvSU_@jk?$2Ff~J?PLB0WWy<;oDydPonBn=!z~Pws0TC z8p-V8qz$18i*L`8-2>@f{`RCLxMMg$xlQ*kpGqtEWWf*Z(ESlxWQ_Arp9i_g`Kbyg!F5qr*Fldwzw?o zpPQ+zzZc;-Qt@MNz~MJtI;Amo^J6ao(&}`h&hd8mA@HK8TM_}_wCQll-xacEBr3b*Gb_9FYsCO3b9WWBLaI$G zcO|JfMpwNvbzj5U=_NWp^SRXsDt=|QBOKVIMIj}Bipu@@4C-LD^d6Zokni>wD#0+| z?#e`1@%UR?STfz=x$aslrEj-azns8)+q1-@C9efyx*eKq*OO9}&6!fr-o8na24G`^3CI4|?(+bH3*{`0Xa7T+Orj{PLXcQ6oN-3rEJ_1+N1BWIs&`v4DJ>)PKGs+3j`rk#oP=ew zi!tl-gNsA~Mv<>s{pKsRKMAyzvLyi!NrOn04aUE55wc^TA?}X)Oj9L$OV9k&IYf$; z*#2(heuTEOi)u^{O3A830F2{ndoPPgClqa&v&%8Ke|qdxKTBJBp(n05HIb!s`UHvF zs!`75o_HG!3|wU@cQ3MO(A%3Gg^`WG+&<3SsaHGDH@E}|9u(L3cnuALidO%o|3Ma| zjeR6M+Dbdh8LfkX$3S}(Em!pG9&VYSjm=bp(8w=!G)|Qx-<+8CmxMS?K zAjl>{fbr-#U_qa?!n=XDoYS_5j?pV7(%ZE>Qa_2#JSrm*f}zIH2tP^zT98nUdSvC=K<enP*#_T zP|fHQ@sHV}pE`Zh!-LUCm zt@W=eGE`dr=pOV(zvL*JJXRyliq1^16N)4dXy8l^thwJWxXuA8D12>lhQ`9?sMn$( zM?V1$zi4|fd)=ud%YJFn8M+SY6DOcT$FAh|3;$whz$M5|^8({L;Q%{j+{=>g6n!WQ zhq&sI9Gu!7`Pg3ch*cA&o{Ex(qX!W(yBdILlA6>nD9Lwmf@kkIwcb!eMm9)K^QU}| zGHsOkkXB;$%EZH@9dalJ*0G5ciq-qjT6Y^f@kb4z)fyxAY19|&j6nS%d?4aFoO$BD zyyUj)cPN75$~IlTcaDq!fuqC{9sJxv$vNrWH2l0-t8hi-!wZDI@tEWIaz%NHAkoXn z9eQUB4C`tjvOKnWyA5J5n-w&?DM|jLSam~Ll*#uIl8Akzy|dfKD+ zi}wDiAz?qU@MAewG*WHV`j%C5p~ll<1Lb11Sb^y8-#$7vhPWbcFEzEy;fL;_6&hyK zUQC}#%chhR994yCVwrh;j?8Z{gAml?CBdF+ZQ7zSu80(_jBrp_FF_Sd_o_^r$_SA( zci=;4a(eL#%4Ie+&)o;?$0ew-FMV}9RH0GZk`d-t^02OJ>xgRulP5yR8cNWK`yDrkQz@j z@l%BG=Z3PSIH2Z6nP~SQvh$lQ?r(&2BVZXzJm9+hrg1s0Z@692P`(byLfv?^LZ^xu zLJo;j56+d7SP?!lk$0ZV0k|A2M8V~%`(|adD9C<_=vJ>!(RBhc=$tAC-SKI z&W4Ar3uFF1@5n}ztJE8b2Db`r!xKb!$(#EYk}-uVQ(rDCg5VozYwo&F`3~)@4hSFf zd^>Y!_BfCCM+NL2*yk&u`|H<*L(~N2^f10tqqnaceB)%#(-S%KeFK zdMYWgqIQAj;Ddq`4$s_l^S65C8+!!qJ=!6oh7PH!hyp~Zt#L2mSRjxE zN?UnU=hB-T@_|*=hvEyv$pqir1M*81n-rRPsD6d_g7@~(O_pn_&JIOcHMb)r>{9*E z;LaGh@8wp%H|z-h68)&q^*_C-OY)8p&sX?S>iKv1b;1Y9Hrr+Pyx9lfuALFSobqT+ zeZ{o0)2)*TDG8};+qRqnH}szL|T|_m+wuG zzysnVO%6uvoR<}5!8J92r!g|$7YG^qc86^o3LIyS3o%?^8AmHE-`U$cL*$=M7uD=u{!i@=a(rly2a`rvFAx>I+XHR`Bu~SqjWEBUh!=DxfO0L{om_O+QksLF ziKL=**qJdqe?I+ahr%9Wc2n^(>0N9r`LD6R;Ygnf*F_vuhKd+ z@8v$>bKQglK~wVAx5yg7eNNyjX+B zf0Qg@q^QtV;Wa>mQ|Du5Nb!dNT&T9x3H!Qb(32F^8GA>(%mG`;E-PHD+nil;2cODR{y!g?$DV*;(X z;we}2@5*(yE3VA33?i+8&g_n$eN?T|=Ah!nj>H9<5DSy%JAwfASL3Vmrp6AWJ8=|+ zt$Wp(FjH&$RoT$C7PV19FeQmon!4ZtY0n^c3K3o_BAch-D|U&4?8wrp2c!XRxOQ`m z$mXrp`QDV#UFlq+nyaXw!yVBQT$biBiD_k8%HcjqBwd#ahsiw^f=qrdL}SXr!hT-a zmI});B+#ez-xaF;A{2iNVJ|A^ay{qp)lKmC2~Kr93w!9|(9Vpds~qA`eD(osg!@kc zt5|mob?@-^co7f>aMHZk2LVCeF8HDh2D_f4IfACf;!O&S~#n z-=)a51{GRp52ArYt>GmR>CJ}Jp?akWK=y;EgL|$NW0w_g500{AW(J`50~4?oASU&i zG;K#`>NQ>On#|PTzWq=%CFeNojLLPU-r<XuiU}gnOHr(ZK&~Z{uXplT|Gff)m=pz*C%GKy}ye=DEq`@PWv42 z4AF|@=W)o+<-fVdgXV{ua0{+B{wxrFh(>RWxm5|Mq(6Si0YtRSzpc*%tjx1X;8{C4 z8cYm7)a`Phgbsa=6XfjOlZBgi#Iq?W<@)?fU_McsJl6J#2bI)#!}$&8Y}kRShyD1< z!cjcB#1h^l-^6|qbER%=+@_GWfLb^eu07INz~X`pztt`;J#KqAjN%%S6hlm z9*HCBjA=eKPpt$M)xw=J2VT9R7w;Nfc?5e7zpI_ICbYlTv4tqiEs3U^b+tP*^Q-hV zrld$4_JD_*bZK%h&{YIt346Uz3v$jQ)4Q`|*dZ|yHW!EyjWHWB=im5zR5n`>qk5x5 zGI!UQV4Rg#goSc-X)i~WNei%A)-WkHs^v$#TgM&|08IANEiP%E*4dT#JZB)c2+XQu zXSORqvBvO+ACLGTMDrB$DV~L7Z(Sz>5?0!}T%HX$JJ5&zSj<8o=+uy2TAVlOjKM8J z{h*x6gq{2a=g>&8V9aD0BjruQ5=AtTC}w8+`An(QTBX`(c`fsIV0X1RgRjR))%{HAx zYf(sV`1VcAzyM%u4)J_EdCh4KH~C^-kBD+F`Zp%4m<&@q+k%D&&L!jcdIylwu<>+J zLfvbL1p<1x^R;){0 zVe=p);~+iS2b5tTgFbtpXnmQnOtIv1`6gPm!yj$YImb-tz8%zQt^#&q#l*3 zLpl71(X?S*(**nT*@e0F_JqWy$I`^V@Yf@;>YEUF#dpKe@U&$6nhMNB8YkEaln~_? zWXDYDe>9$6{TAiSV^13mMeC%@la5utm4lN8pLjFk+Jcn|IpU!9BFe}0?3M57a}8s3 z6E7p@C+wW9#DR-h9*qvp+tFj5fBYqvX|y0Di#z@ibOGy)3I7%d4uYe~eUAB{uywNH ztvKzRzvYD6_dTI}S#Zbck4iajOeMMYdtQBv7)qv6>@C*@S?aHdRGI-Yv{s~_TMZD! zhiA9HbgeL=5&V26qhLS(HJ#&=(uGdPkg#@}%z#bPyXG3+ksYENjlXM)#ktqmo_S?D zR{Iy~>May6A^7Tmar2zinZ$818{LbD!#naBKfEnf{I&!68fw%jn1F<vC9#{jyNNRve;d>{)d3GW9j}nw>)!yC?9*hHEF;R1Io=Rdh#gmBaXkAyE*Tj zM90y=4L|HUv08HUGT<#OZt20Y!9|ZSmdwwfLvNEp^sMy-{L>1`QhAJK{AeE}%Habv z#!7xT^Ku(R3s~a&zL7E(SeskoXBaz9txjH1LZSvik`-a8EVe!&p)LtAm zrmoRXyXs;9(m0^{@gi&aHti1cF{xl+jwQJI zgP@qoKgzcIXGNpb_If2bkMn7Ke6fLfc$P$G;cRAm;Ple5J`+SwJmBz;hhvCQX}GQc z+8T}VWuWf7>9(?Op_X26QqdOVmf(Fu{Hghf>mUggm5%3=rclVvp391*ZDWYG!DBeQ z1KfqQMY{=h<@A{~jEydCgw6#w{P;!l%6gN;9zD^cf#gF89LsczH!6?5l@z8+>V+!& zMX?y^_Haf!rm}0m@HVRc7#UX?dh~3+97Z4`;BH5M@0P%};vMt7=?U~XlSP^?c~o=vK2vXu=qE2Bk&0H;V34b;uzApo7JL2 zpdv)@st0ds^H`vu{n28_>cS_Z!H9k9SqHMNY&>~~BXI>Ey{{hBUe?UUFB6iC^;%KP=b4#`~pncNPhIwt1!L9%2Md{VMCO^A%Vn_%B*(t<6vY%@c+UYfN zSG6AvWFczb@yheT7^hXCN<3QimtFveKeI<)NII$FS3FB7YdSNoSJFD++QJ>4YRK!d z8OaWi=GJt1U*-t8c>at^aT35NVpW>2x73(NH#%nfY04U21}h`4Kt*xV=|sAbhB1*($f%-1OCqJd++}UM-Ps5VhFrIt4w0;w zpC?-S`%>lljU1>@e?k9SHrcx<2Ct9`qE}#kWAFEne|p?JgKKL9s1?Z)NIdbe z;)F@Dd>s5W(+;lks0Nu1p0jm#8a($vR!yH3(<7Fj=swU-tto{+X>D;%CU&mQmSGHY zr8(RJGj4(SsF*I;#Pc8wS=qnycm5@*HpH@E?(iT6^AUH3w^VwvbpE~F?B~KQ0|IVC zj_~O3{AjDz$uqZ|7ST=-ZC|`9G~E^ylr4dIf6Up=DAsqKa6W{qn`C!WPCZ4Mzr#GF z4jQhQ-g5Q?wLeXAWhu`D@?$M;w*rnZ1sgu^H~rKVjUmIDV_X6Yo8Flg9b800dKqaV>EH?xgo!nBUx|YQEUNYZT}M^>2&byBH|G8pZ2l3PU zbxwHy7ODlH!>+O^n%A8*c!3F=vzS7hxpky$a}ta={8oo6Qs2CIQY*8ag# zSpkrBQ5X!9gn_L+yhxSYy}Y}WxajKO7S_cj{Tes@ZKj`t^M69y@y?T8Tb#0YlIA?< z9ECVDUVJf^3PuVyNNAVZL?&vbW$^+}Ju=Epa1}QLnIvry7fx@@D6rRN9)~ilraysE;Y&_l#{71nYU3}ZD`Z(Q+l+Ou5@8(XI2(XyK0=OmF*q-ZyDH=kjCuLk6;*9y&f zqC|?dDj&@XQIE1{R2J~Ru^GaK{1kB{9j`~KftGAtJXCa{Qsjs6SIo4ZtO}R~cWa*I zh@?UN*gdf@S*(&2YG?hJ;52vJSxB&&NQe3k)0NYooY%Bbi`4S)=FB7lwSS>?%nCTh zQZkxJoPZcg--wRIG=B;KmSer+Y>H;(e3?JlTRUZ`?@2mTGk*$x@o2xOlJd3$!-_&a zFCFeD=0#51b&46Z&&ZT5rpvEfQR*xi4cksYv?TfnU7U;8_dXhxw_7r(=#bDJ+7qxb zQSm3+yX5RmFm`PbGa?L|f6phse`q04TP(jN1_yl)qeEORmn0RG@+5w_eQeI}KaOpy z#8Nf0KeiXI$3|otuj+SYDtNG0FXXqvm4osN(S&Lp_yOIw;qaz%Mh{#1;*b~2y;tJf zfL?5nBhDJVOr$r$7x^>AH!T|Hv0rGz%(DIpV7)x?BoHau0_rO?3|c4E0?!_qC*W%xX`1 z##l3^IAp^x<;$7&S+Eh_tZ;qhrIq1lOKZezzP~#=-6MWCy%m9^y?7T|15vJsOP@uam)07jR-ZnRRgs+>XIe+3|9TLhg z8mbKp58V%g3}X<~fi%x^#sJK}uAZ|X=+wrWHC3nH6da60$s%jX$flD_pPJ-8M%(!p z{ODJ*!&yo(vN@oG!|8OkzS^Ou_e+JAJc0TaS$$W?#c%ISr%b!OjR{;aAN>b_?7_dD zo*g$XZmgsI*4Fcg$e={Odg~BVBy+rn6C}F}!5?&QiRNoDh{q$-H`Ra}a}az)y z5~PjQ?1oEQsD%y~K!e(3?NklrnHdyHw3agZ4axV^m?CYH9WAK7H283DUlDV>9!`v| zizvRxX*wi0&cMyka$1kj)3@|eD1wsSksa_DOU}t%fTSuZtb!nI9-ifqw&~Uh%jYOY?lFF&N(PF8j43*C^A-aR?Ht`s?IeAs*SBX@+U7r)3 zs^oFEoGa($K~S9-JWhG*T;Id}eQA|LzlArqE?|jfoF&cMq1cnWot%tIt<|W7JvR1G zD*wJy9AE3%D)b}Q?O0-d=^$}#b3FdfOzQ}B3Q%tdIdjh}1|0 z$Bx9}TNpR%0x1W1sSCem_>~{P^~|N$9dvN~$T{_B&WlZRWUSSK<`u_^aKa zwzAjGIho}_`%g}S4T(F4wTzL)Mq0Uvev?hz#<4vaXP8Qz7|!OOBUCplzK|juK<*S8=Gbi*7~)Cx6 z`K`@%tHnom6gl}Vj$NQ*hGH;aV0RTuIrWX^Rk-fwfPdkhH&W+&)!OUHr3sP{p>RX@ zv~C1?GZZ!J^9YU3f`slH?=PtuKEdKIQ3OwFftR=Bg%1i0k7;{Ia{llMsy&ry%33|V zi#uY=0x=6CYQ2Dx0=CE(<2(Bk+c-hL(cC#S7PPZ46Xp$n5I5hHx{y)1(-ZfHBJwWh zEj%yj|KaSOgCu$Sh0%{~+qONkW81cE+xE8 zA63=Wm6?_Kt?cOTjLP~5yT?3WB||B9fd|x)8g&bm%yZLmNV@@D5bTWj)y>0REHxMd zxs1{sy@M#Rm=!@hlcnhhr5`q}%8Z=K@i{^?Jv*dr*a!)S{*Ey?A3_2L0?dnqU z2o_OLon1;kaln~OL283c+F8L5A1y*>{FKarAMHvNUXJg1jRZYj9(_z_Zg9`H2;|C~ zJ=C;CxG9ZZghI7)hRKLXmvPVxxr+onmC#qj>VbXu1kLt>(At>S!F(TTr#IqsKW3@* zYYx5n#Gb>KHYEn=_^=$blIg_5`+#)JBN8&27`3z`W*rvF^D`bRcL5yAj_G{D(A-1< zgALhZ;Rz~(J{`&7@Q;kZi8Bwj)*LZOp3NbVOT141`q7NMf)z&i)dOWZgoy%^q!sZ7$up zPm`51HL5@9O=HTjji832JT7|IJfl2aXpJ}-XmiHkjRQ30uZpaf0i(*Ku!Mz`^c3D* zKS2I|AtgFbbg}R-9TnVBD$PNxOx?Gvun|4OQT0Tdxg>tg2Q7Ww4Uy{7DHbh$i%@F; zy`0!;Steo|ON!!8hF2{=pSXwPkwPzv_CmhJf0=XS*i?iW`j^P{i2IELBgG9FcgyOx7ClHiEwByncHm?>3T)tEi5Fm7pP!% zKX;>V$LwPuxX7A%u;x`CirPj_8TuK`n$#0(ZMwkj3tre>n${vWU@nl}YkY^Uj!=wX zb{tNrLr0lq-9I~AkE{4tkQTp%IilOj^9g~69ytQ57NWuW%CtE?y9W^oe9W*`t* zs)%i%Z(B@4RZ43I-MxuFSVk>Aq(vB#cNg?krB@zGD5xtn4q@sd&QpVBr}L4yu_+Wx zFJ^I?pMOl{wnB+QyOw;D_Ze7&n^Dd1*XB~4jJe=!nMQru2jZ1>w9hH#*KAcH0_E+w z@+-{fVQpOacq8ZC&o|`CWZ#&5$6M#j31w*BtHiqKQ|tuB|)7YSbs z9zwISH%A9w=QQZdm0s#*jkHq4IwB?_5BM~BJor#ZMmVch`-`f4TEuzH$5hii$URl> zPb81ffeFIwC*`i-#9*llgb5rZ>95%ka(O+UBO=JMJuIlyMns$@#7nVStIJGg^^M8> z#XI<{$7E6?ITd%uYq_Vqn~v&;i_Nw%@CRuCvvt@Dj3<3_0v_^^Vspem3w_R;5QpF$W5rS@sVh#WHs=KH*txhajPND&;BjIR2F{XCr5rQWjd35 z47P@>Jg$Re^}I#a>x5e>FAHLYObFFMFDj1RTw+eRarJUzEyVtbkc}>%)gp7ER*>tl zWw^n=79k&pug!-%wywUKTGN8L=V0o9P%)n}MQ_QmO+$o~MWxSaDJND69m`M=zdD>r z$36*GZDiLEA9L)1z!U{DJAow>SFL~2 zI@*1}IQxu7L0-+dO=d};R^ZL=Ae6O{B6CwPzJx_)7bdyI?}DJPpQQDgDeGM$8P`iX zA{nB@>>E=Rf9^fs!wYW?EK%Kn9AU?@QotAe7ly!F3%5nN4hx?S;C>2C3lA*#tExeo zHZsonea4stF5jdI;V^Q8wB3CfUw133g)~7@gl!n&9ZF%m=BwiYL3MkBbc)t0FVsHP z*1X^?*v^*8m*dB0YY`ae{v}&6OuX-y zPmt*iQDyBh&z>rl3bR!nHTu(AFw1qE>e^ifuJn(KV%qTbtw}cd5ZUIsSeK{er8~i2 z8Wq6g^-Mo!pE>c0!u=-WMgQ1qEZ+$X7Y}}iE-vP^`P<(jZRkZCl`KjN`=y5^hHUMZ z8E6#(;U*@24wA+^Q#in17?-gAa!cqe^f(@+DDedic3S8pv^!10acTjD_z6#1_JXHl z&7^v)mc;&1L$i@0Nq-Z&C00*$X;3`o&sfpqc(@Enw=v%T*r_A*XKc%*2aX(p=P`U8 zpQ);lfXr$Dw+RhS?DHvYrE3-P{+Rb~J}G05z!a8SpzE-U5}X0YK*3^@FQQmhSH0;W zb!Yrf5h=bE)d*t!NU_E=-nZA4K*w_Os4Q+&;UO=zk*puOGsM1MqVs!G)-G}fpHe~o z%z1Q_quMAF5ncO%)O4Ne8anxIUercui-YDZ0!u~tv7(bK-#PNLnr26$8J1!99J#C9 zJm78QS?fEWTtA_>i+1=Jrh?ud+Z0FSRJ0dfGp# zoUNwXga@SDC-BTNPrdh%+bB|_PK;HH}_*VTG-uyO1! zqCVtk?w)^6FvqNI81GXrpn*<&_`tx0)?IA)chMOXH9fU(Mqowr$~U*;|z! z-HtxxOVPrXHf_nlbiYc>^y^*R;0%ru15durWFcgy#vgm8Pbt!8s0{l=GJw{ab;;NM z@$P-9`Qo^^0&3!e#STlpbVmPtLgjB&W9uT?pWtRnr#W?R=Q5rjue{fgq5W(QPO?XUX+j{i$PTQ`RB2}4GLP)*u9nj98 zzBb9qVD6n|j5zl++Ekjg`CHuNgA52T>`jlsjjO^97UcW@%T30|?CVObSH_au6Sr_9 z_M^-J?YZOzNk6P&KKZ5a@NQ0=#DbA&|K&ZdkdlxKC99EZ!n>Z+dMmKehNkuW8HQ0; zPAQ!oI<#`!RUMs|Y;7q#dm|R(`bI;^$2-}>dvw>S0;7T^y7k^MJ%!SDwB(L3G21iU?)l zWCNrPUk})}LL^d*XwLm2xS74M3$2KnJ6k`RT?%F83-|4)v>`EtVoxn-T43T>YsM{- z;)wlRc$$0Axq`(ChWKz5vW$Y*4y9|CR{uu@Zz{;bAF+v}!JmR9}tro1tG-L;syoYFrP89N~bp0os=#Lyh9xSywgv19N+gMwK& zvRLK#UhxRt$qI^EIan9oLKc4@21A_?qckNs{3^Rnp{gI>%4690Vc%>BZdV?leP@CE zXhNGn{7$@vR5AQ%Uu}iE_B%yzr|(*alKaqqQbkN9SnRjWR36=elq>ms7(1$IfJR2YLuBW=gnq=f7d8#ff|SkA zq4__Uy|$Ln7j}m6p+_2QQsgKvb!h|cBhoZl;eUS#)nXnUvj2kTzTCB7H6B=W?Kp$h zuM*LMXfaM|U9sNw0F}aUi)tEeG79#T5B@;{9^(=A@-qeIDV!7l-gS zW}B4RFHQnOTsI+5KrT|lJ3fkDo-CV>afuYQMBl^WDFS6>bwCworH*6=P=v)hQ^6zLx+(8&+-wWb9 zJPur{oHloSHJ3|B4reXb-$w-N@g6)$5xa6UJNTz1i#lk~pz26P!vb?k4&%EHQTwt) z^+0xWCKg)0YF|{zz>}Bk@5m=Ca;;iPdqABpf4Pv4Snh9h28UkDXN3MbbGfZp{YG&= zq&y3HOReu40_l0UTq7B!(cDrU5xi;X6lLAMTrcYhI6dkKUqwph{laGPkpF_+4!`vc zs7E1MLoLS3=_D;xNj@|@b!xZSRto0^QqD^f9M9oj1TlT>BO1c$|L`IxH^ny<9!G^F zd_?S4?Dv3}dtndAboij-83 zgLC}Wm3axswLn@u>Cj`+swY&bCLSaYElMC{!&_C6KAK+|rc}h{G zAnA0pKj5t{5Uo!W#jZ`W&By?aWHvTj(UaGZ040YY7>!rEPEC>r1&hOqO&Uk8R9&3N zvh88_qc*}zxD0 zXV)=?Xwa<$vN*wlcZ=7o&=&^R?=3B&V|r|-?{;70*o5P971oCDO)OH8(&o%CH9?6L zIr2p~m+g=2r}52LWh!(lPXFR;loMwd18en1-o=Zw8#kefC{@kRV)wX#pXYStS%2tq z=B}pZ$xYUTH&0cBc(lDKjz+-ismqL3T{m$LJ;7&jTwwxQm}Zd{rl(c92AfT7brB?B zq79|CqtfIV4ix$6pviIkaK{batw9~FL04-Q_Glzd?)bfRoIu6=Niek zf#bX2#wqqduu;-)*d4mrsDKU7>S_bMhDxjOs9GfciaaQ%V%uFM^c1iLfpeRgLG2Mq&zd$?FA=Tr04d}4!Ap0 z^r$aw6=W2)e|!JoEPky3Xxw>;4zHz{CB#UvikeanG2gpWslErZeC?9W?* zB(vqfGDt5n`heQwxBL5@ZR{tlxh5TfQsd?nw_@o-83-%o{!=J186uF4bL?S+n<42f zSA?9+NKERbF#)j(Nfl^A6%N{ytmRL5`p4Fq&PMw+-H3ARbW5@3`bKJJsneYe);q`- zNT*Rj20}Z;3a{IrPpe$m&I`PA*-bBYLSXPJ5pkRFS!ehMSWQTE&Az`Mtnqw50=r;} zm2P146D4^Hz}DyseXt2@x|rJYfh1cr96M2_vjpwrrux!asv@SDbGVA!iL6^16NQZ# zUhH4Da+#(J&zC2Y+q-;m<{+9v+lgNym=R=y)>pZABf+Lvfi0P3ML^~9nkJ&{^dY|8 zPV%mG-IUcqOsnK;B!w-f-Wq*H&<;Xzw|=O#PiO~3AU#bz)_!ly=&JTt$jDt^T022E z6h$oF3_q8O!uOz*`gW*u=z%aeNui;HGVJgAuMwBP+<6z=Ka_yArdY{t3l%4*LoU8^ z`zKFiXU=b@BpgXmMmElsFsWf@VQfU9hm@)L7`u?Y-qP;0j?nQ#nI7*3zQtIv5mEQO zs?c$MN_VkyT#O;@!e<%_>^YWKPw)#Oy+Eko^YL&DGd-Yfr-4gSV~;I%O>guZ$SvV~ z9H`;EAIy0hn}9!=h8ei3H~`IRF8b;hkD*?PlF)#NMBdAL%?-hsh@Js!Uj`@FU&5&Z zlj7=-nnsLFySEUH*X6uffoL_01T*`;9zE!)5IROLrfGZTx5Mm;LQ&(Egc{6LJvl<; zL_+pG6q@+A1iOmA8{`KB^bJ$AUQHMZv<^@rcNC6pLL`RZlFYe$m!?bnN%R=o(Wul3 zV%!!4nzZtE9~ZRU^SU|;b^j3?Cd@AI-sM}$Xt>9lLuSeyBzer;q;2^rpL zExlP5D4ool_|Fz9_-tv-m~j7Q^kP_->Hb9=LoV0P$AI|`(AZ7MdOb&S5xRTO=4AEQ zpE`JmVBs8wYHqy6UFB&OaJY=7obrO9R~1zpl=}`uWdz~x3)F=fMaTqbMj^7AmK((v z%pRk}MSV&9Do}!P@n5SAb}R%+hhVfNri z`i`esET8{rz08BZP5P*#i&y%|-NQuP%!HDO&EdTLQ*i+3Ri=S!i&I$mv|%b8r~jx*jU4*2KS>m! zTCNO9pG(&|lQ?K`J6@J>5jiGpgN=Q;BDoXP9)WxINeOnBNTtEY^JD&~V;%$u{Haq{ z{0>BBdSVC|kN&s}R&7#*+;$UHyD0b;G|x60oZ{PkgXkjySXOMjgTDQ>nk?z|8=yjp z(lZij^Xl+~Ym6Hb3U#qiTVKDo5}=5oIXKzQw*&_S?F2Y{k4FNfUT>ftF8;Pdw4z2; zCxaB%sS>q4DaNiCFr;Ng!H(tLcfNVv!>j%EUzGqMOtkk3A-#-3^+lF&ku9f={)5iC z!QYv0vKo~TyNmx#TVtQ9QYyvlfwA5OnAT5APz;NfU?lOt2fc9VRk5pOXcAu~2U`JF zZQ8>sHWMz}#G{G_^zyxPY~ne>susWu7Bz=TK1BsApu-Hrs0h8CSq*KvFvst!RST|2 z1TM@^hg{7B<@ScD9W71Zq!ZAlfEn;I66g)B>O?<~C1d6p?TLUZ|IDnrF(%0dQHX(V zIyB&hTWMT|8w2x*5fXd!`-IE{e?ES)Ljg-H;Ecb8FVN8MOBz}_)85u|%+hby17us2 zZNbyb_u)j5dggese*wwXr&vgTqnjE29dk06u=q7_5&tayFKJ0-nTnHrU(>W<-*@A0i4 z$J`9e1&0T*$8tbT zm{u>Ym`#B{Y=v411^Ls?FF4H)zA4Z^4Cgv$CN?orK}RX` zFO2Do*aY3UcIiRP{om5y#0tbaCtxY6={_9zsP%Suwdn`voQ}Ds_Pa!T0rr85irLeP%e*bJBUxTZtJtL%Eg_IGAz@_^b#fxdx-~6K|My= zU`&VLzz@CZ!Rh0z1ubnH3FK2~K}nR)b#3BCOIb*HCDt%GKyDU(ZxA zFY2BycFB0hXM;td+f!q~+yxS-GfprRIX~au>Nn6?4uGO8n?MCd1Tb0u@{A)z@Nmv> zw1uebHs5I9^JfWj6}*lpx%cbr`t|z<#Gr-w#xT0KQEg>=2sIYBSne?8?!qEvUOU`3 zL&;6+YlIn)*f%Z*g@m=n)!hwq6UxMSE9@7~ORRR_V>ch2(l^-Saok5y=<>~@Y4gUM zrMgp-!k^V&t4av72z@;5tinVgRZbtX!gmCpU9fCJ4p_05XVVtHC!--}dHFm{HqT)@ zfkv}`7#1B*=1)!t7=TOy#V}FixU=r@o!QMM`!ruTFU>uw2Q5@A^GXKFC}?g=ni3Ha z$nQf`b^>+5lefSuS%}bm)v+wr@h|1-yeT$sHX2U2VL9e6_g34XgbI(fknGW~0M+B~ zr&QAr;w}cKR%i`8amU=LEOZZTK=O_&eOKymg@5k7QMTmsqC1X_x23~4!J^|-vUjfa zSHp7n`huf)j}NhFJpXNfim7~9IG0MI4*rPySoWZA!HXs7H`&b0H7?V_22*HXFb)4Gi8HX=TFMf?8koRy zJ;HJw0m4~W-Mz1fZ{iP=BxX%-t04@qaXTxhQE-`2*$+Dd<`A=2+k(T7CwUadO(V*g zvspzPDhnNST%Of;{*Q?E8RR2w5733jX@iGv$i7bf&QWO%b~;Ex&wSlb=tb8qpYoX2y@73_JKaQtH?) zZWFEIK%E+_qg$_8pCPn|jJbv9>eO57P16DS5H0}zkgv3uFVm2<3*%9u zGHV-^BvE;%$JwT22C3r^HVr=eX1bGJhQVc3K&eJBY1}eeR zM?v1R*FEsNup!BGMj+x2q-{ilFyVqRnUPwYt2(Ok#fX27+Mn~a&qnAhx5%=9c`)WL zfw%pEV-rqvC_DR%-S%|JgI@P`EL4v~OKRkUKG;jb(nId7OAWlMP}e$z?+1^vUZ=3C_ zFr^V1n;LiML>ruj`_Wgrv=mcKbztSR^=AoN6}*9|Lsd1m*i_gwBIdlDP3MU-NzA>5 z7Og54*~7k&4K->`jZMs-ISYuM%O;G95pRCJ{I3e-AlZi%85Y$gKsTfB{qAtn^=}L zNYp5@>Zj*zxnND1VK9dg;o$)0L7CLPO`I}PZ~oMgMNgP_!i-piH zGfU)3MFu&e;(Y<*4~#!E?yBfxd4!3R}{1{9JN^qy!7jQ3yV>i|{>^#rwJ$7?3k$r~=Z`pI8jG$*vv?F?g{zN+& z(CqANQO-WCRl=ujt>4xxJsNsu1okj4?o>~Ae@f)IV6SJDPC$3pE<{3i1@nhk$Uo~Q z=VV_6sWh454ehvlFy+O}r&+&Rxx7JgaA>1(V)&=~;a&09W%95otitloC(J4 zl(%}09955;-P!DuP?9s+kwxiR_@5O)%wrOaUOutV(>l#diC6#BV=F$?h4$~exYSGi zvkV66AG+TIF0P!B{Ku$6_Q*OB%$Eo$CH&ab19pTDy0qI&s)WXx_-XqXE46hKMYQ<{ z!(g+ru$z3V!@&-&WJvOq%emvIm*e2fA=7jIslIWkEeY0o4O~HAf2l;K@fcO~i^ftLcYoyb_oTW2zr+u#F7xpn{xP(-aJpu;lAn zQp9iu2dz`fNQ=JXp%KtAPdk&fnu*r&7TQ*TDWE72ZR=lgN4pStnUJ^pkg>?#3ED-M zY~>o`?qTF`&nXwHUn=>&;RGmRu1LR5%VB9ZBxmdkN9IRj~Tg=*npybJm1`%?vN^Zwn?SnU@Kh8Jk7oqtlR`ck}P?qwJ`k6LUCT*!8?y*^ng^!csivLu4mJe zP(@tT$D27NT_5fn<6WZxKA9fZgm`U-+s~M+VTmf}V~V#3M(ANallH}1jO%JR#XbNb z5>03sHOCpCz=(q-50d-(tKan7z4!DWx^fmQ+WJi9xdRln5e;3BnIZu#K1%tJtcE(HS{(tJz9mA zI(24l=R<$SdF=!pEBlG5Xa5SS6i@YhJNvopqiS9RO)J46V?mP>LoOzHLyIA(UcqWB za(8QZU^y0>fl7f{zASHJ3F`Ap9f|`3K`8^;RNRn=vm%+JzIfy&JE~A6=r0t1Mel=i z8h#j1f7oA@nlC(9^Cq5Wl^;l37O{3K6&jeth!jU1ur_ zA#gv}E@NHJ5w@||5IiK%X8oG;-Sq7yv8M2YG9DjziR6Ro*j|;+(27}^$0B3BEr^d< zVz?q$wMi){+9ke;;!yVpy6Pt0i)^|r@qhL-c^>Ni(OM!1odw_gBa?1ibVnPlER`6s znFv^;Puth3oiE!f;8y(Qs4r!H`2&bAN!(kI@)GQJi69EOfu*zOh_S}U-4?`lqq*8jZ9|mBffFmPhMRnW{3>gy`gP& zsM5&w-@6xE)9AsGwvX&q8>rsve5^3&h!f$GM()F|@fXKZze|?Tb zp`N6F$HI(t!lfI8^iP33uh((!Y@28|d6_05e~n-+Il<4atIoi*mzU*-Y-`N&koRPF z((g}DP*C$V)j?R;d|du~lnV>=(a3Ho7<=YtO>=m3e)u7YdJNI|GU0C<;Az}ADLEf6ObyzvfnxV%d&JRJ1sh|hbWymcV2J6J>@y(fx9O>O z7y8M8S2kpFo%Xh`!YY2tYr&=RwRLicT9A4zh4A&m1UIGLPg68ZSrv}e*z8Y7jeU(T z9$-W2&0WB%KSj@8_n_fR#6q<47*3@RMWWAwCcV)aibA83bG$Xld+Ch+#HfBFU`wzP zYc|;yS!YxwkGSIx9DkDg(tIPmz^ZXtp#m{#^?((F;wj~!YX{LGFeF@ToghN8b}WYD zY(x!j9MWPEpn;cL65#!9EnlfdS@r*Ak?kU*k*bjNG~52HE{|xqPL{V_{HVZ}8f<|e z5w*QlWf>P5Ge`$IM@T#=Weqi0bMUL)zf;8euLs2MUSS(OXwvTld~4yfT|@a+jCL~N z3N0|UNdr}P_~|%%>a_%BtdjPg3|v!3&?iWU{LK@0+ZhjEp4Jkw7YR)CqeA0GZSkuP zw$-l?5}4`nsx&s}ENbL#z80*5!<5S7%zG}31biCTtZhD1sf?*CYp(OqTfCNWuc~H$ zzl--#vI=0lK10^SUtA3Xe1XDGqVJqQGD^27A!@TBkoEV=E#8Du`-Z0!WjI=d4^yk z=;D9as#`$O^)-(wI~Z?d?C}OrDqzE;0#yzc*x=!Z1Xbfy<%O52<(ve{f~?z(;$zGS zbtqHF;wtqQf;BB^9m2=exEPT9 zif7F}v8WK2q^30!c!|>*AW3*-Ww%>SQe)X+$#aL$9?fM2T=}A=gh42dCOV%(K$+ zJlU+n_&~&}I7LnSB4p|i@*KTY=lfu33=^bA-Z_V$eLL>wu~D$FG4SIlLG2AIXDW-J zXyE2gB>oeyGSCzS0@aA?NWSWD-3RkD>50xdNWr+oo*}`rk`m(&cBO2y^L~co)wC#) zCFGZ%8It@_n017N+h+HT-?6nB@c#1nd*Q}nG#X~nS9c3nqY_V8hHJ%pn~=bq_=aXN zj&7s+-mo*ND z!c-VyS?(yl+ZUBC_|_|S(xUn=l;3U0_0L=>(sP7s;I`p3C(O2RTu6T-(V zhbx_TcD~UuvdJOvLhF|f;8_#6U_HbincDJ-ZQ#T@sVrki)Q`Yy)HREVaVpqOLI`)Be3j)X zmg@KH6Kv9IV&>*mwcX@^m&nn`Cy5O!W$1NcPVLCJkz8chcxuH32|^si7aoM&(5tPi zzleFvFG0)k`zmRLrPm=x!Du#{UHi=^Qx~T~9HXdhL&-t4G56KXc)H=X$q|%D}uxA-i>%^6Xl@c!QKK89z-R8#vHCact#7W4z;P#>>F@&g{tU%!C>e2QKA@ zkH%$&7A-iA4(}(6rQZcQENOaN?8>IXbMAtq@%P21c&mBbv6rC~k5`pqrwqlndBMoY z9)bF*U@tF@PC7Ojs<@7v3T}3wx7habU7jP$H$)h|9PoU&nmc1+TuJ69-XI~u-ZnRT zYGTZLG^F|NxqU25)xh6^3p*SFedM=pFAny;BcEUc4BPm#%mqOQa0M&heNWV=df{le6@X`;BKKlm@F)_RF8-)v zZ>iGe_*Bagu>V%VH;}ecGu&|*(&O*jJY1818(w?RI?ANcpJ`II5MpRMT!nz;Y%hKj zEj!T=Z=jI@4DgQ!2qx@c{=V1N6IUw-`EWlQi-%V2r6QtrLI+vaAKxkbkYboxN4#zt z$iOid0J{0bqvx5$gCY%f%&8qI5<7?7ro0`0wEM`+dHAb&1N0Bj8*0}d1(FbLdb;9j z@akIE7?g?TKYOZ8QSnsFeRK97ZjqU6ECHLcdAi%nW(JQa-&3R^W?XsPe!>^w2AG2GL8{IdxO9Nk!^)<;u;|w z)v$YX7Yk2Mpv%9c7ZmR7?CU50P@-Q&mPFzMKSfdnqNL4!Q_c{FeX?i z)id|*f<8Tl;4BAb&U7~#+x1Kl;NO(?-SFB5ohZ3c>Jshvdu$KH|dQ*J1R z5Z^j~r#DB%4>(Y|NfZD)F+0|HOl4Q2rxiHB3kYt6T7q^q71L41qR!zKWV1(as0W{d zuLUN`jo*4pXJ36y7j`1`xnUES>kBTgrH*w;h(CHmSr-^AVH{`L^##dzEtK`$Lx-|` z6__-PW)BC&ok$4;mspytv_@7Ym3Y@cr;J=;bi~O}m%ysnMLE}y zzcCeX2c`>Pl0a`B$ueS%COSSxg-az#i#Y^i_FlN|yNDX>OH}j=oQzf}fhsAZ#M%v; zOb+P`=7985X|Qn2l1>>$h&j-h8lM1H^+A8YER1`L#oP7 zT-r=C$9KypY0x_7a6O=0Pm}`7-x~^H*v2yfK_j8wd@x>|cCkkJfY}YYnV&&ha1h9` z@{l39@f|1wAS_sDi_af#^mRK%9(DrU7#6Ow#^_qS!$KkYu)HF!Dm3+2-9RTubE6)C zX$l)?%Mk3;eoSCBv~Yi4)S2do+~QI8+QpGpsbcx8B7(Pxb`mQnNLx$`mA-zt$Vya= z_24`q{QX&lMEc1axLL_152PGXeNb{+ zKv6-XICyhW@}QJ({{Z|1=n;Q6bQL`z*hc%_+ zr!L{WCHBh`wZt#9;(a|`XWI2=m@)+I917f{+<5mGEA%_Q3Lc!KEV!QxY3AH0q}5s{ zZ`y5Xf1pdLGJd|uQE)-?djBXa-KIW^0dq#k;w*df`lI7oXA`E;VlE61T>v-hhvdfBaV&S9y`krI~q7ONB&{`cE_? z+>baU{0@aIhj5Hj>9#h4TDp%BlT&^?s@wcz#PqquKoX@8t}yPFpW(l@rM>&scy`DN z#Gl|1`FPnXFC0_^Wrju~l8hnNq(hsm#{$fMTq*mFmtl1BM-VW8+NG8~BG~yCNoXPY zsVfZTt$H6^&41xLRFV(Z*gGvO-u-cBg(2??ovMaK0%i1Su%E4JijxoY&mENPw&>|P z*{3@1vhiBcmxG~@NKLbVoo;PEHm{_uHMvPEaiby>Z|sP*2qy8hE_0~$QjYzV$1IW& zTm{3JaZYRM4A<@O1JN~hP_OdKmBjNZ$3bB7?C&BSb*hwDvrYU|d7rk&*p${;qx>&- z(Vi+=Rioink`t-oc-^DEC)v=8yNUO#j_qf6*W{=DG6H>3aNB+#rN>rGO~~~# zO-dE?Dm$N}dj$P_YOm2{JX{yH9Nhi>NSL&!}4&2SjQFjopDN(?fZm zN;{LZzR%?4>)*HKHQQqH0`CSvA{B@`T@x#3vw^>F5NDV}WNUSYoF(;GD79N*+g1N; zASGw{-j!(=OfzeyTetBKBNePoAK5s@ZtqOahBi#P<0@O=t$tQUiq0B+LtO`Srz`o$ zyr0nKiQ{c*@IkLNT}jD3v=(#YJ+}h&XNl+M+uN^cbJQfZRE9lkB#T}IQU3%b^o&PJ z?%P;4t(yjw{=4Lxh~qKWtoLNiYRRP8q5Y6e>Z`JteMw-T5@)XIdZM{U!*%o>PLOA*A=Z17~BY>|NCmyt`Yz^E%PXaV=LzUQg8u2D6O@+a#G7~`_@ZkAx3aVs!jtdlq(cSgq42T-V%XZf7@?ewfY^;`6I@fZm8PEP_B!+5K zjC?7Z$uK!`dIsc65h1YGJbQ5gnaz)b6}-Jbpkwxv$AbQwW7-bec`=td8ti~d>pVL578W}Xcsj55Dc;4|Ias7{-!kxki_Ki9@F0TCDJO z@?l}GQz*4G1xoDIODnkg+LcR=7kpX0W3^M2Tf5Oa;kcs_5|x165H1NGqbX{Kbk1j( z3vL_AGJsbNFzIhqvbe%d(uRt~Uo*2%a-n@}SSs5EmbF-OQ^Wle@1L2X)vRsf+ug*P zcl3)Ekx-iIyjJLpq(ZUR6GtTiL1Ag3xmyOOi+i6R`y^e%r5_=iI`CHTDpS+8QvSkt zt`!pUWGJh+lxg!f98%EkmHZqLPb##c>uFzMCkfBl5ABWHPA-vMM8fmTht5 zZ?S&n?YJIR-2pXs{ekfFcG%;TnwuL+ zyxGY-qdI>a2zN+z<|^U0BAgc3b=O{ZWRW8)t`p!#x$c7zJHv*PVCPB+M4J!*Q*(D-A6sA zY(azW#hE=6{nD^-)>WCk^~K@v^f)Y|!m=EC&#(xIhPYL(UeE;b=}wh58&7CXnKNDQ z%&r=&17n&nVBRrK1W5KW=*L(lM%^B1??QxlWKZFowODD&(suGQc7mR}-ysB-c`Glm zaXV;&2>k;kgkEr5Yf={yk2>;RhD_XQx=w%pxU=f-a%|x3+G@Th!Bi)ry*+Y zvOsfsxI2BUurSwB-<+0cTF8X{wnuUBW~8$`IR5DRI>UUR3VQC4UN$fiCc@Rfgeaen zXOU(+7VIW>@8PqJJTRebW+W<{c`J045sr#pvc%^Vl!aytVc!_}dgMMt-aJ0C7^k*f z&90*0Nr#g9!?qS~qR_?7rnmys1d=u-rMAtfN@0f0l^M!s5Do;%zhgHRilGj^?JbwH zLL0%^R|9lFyJ2}i?VS12?Q>K9RGoTh7S4RvUuB#Lr{iXe0SEIw-g9=!hji zKSD7>*IYweVN7FbY1qzSyccw3hs|qe7`g-hcBZ_XzI1wStYRTq@G44{o=8*WeyD^q z#dD(DFj|K~=x=B6GtF%n(GFG~&h&)qy>kr?(dDtrMax-i>4vAgyj5-cK&0mMut-je z=`x8^1%4DXG6{I5=*7euk-LkMc;+vZ=Sx6T{R=8(*F%fywY{8BP>L#bglbqgu=7!) zCL032cYmp%9?g#g`k9AT?2-ti@e)u8B3qXXeAg)5ie$8v1ub!>XFa}*K`|-mNSd0q zwehFSm6r(&gI$sYA`4~o2ohjsdT1K77$MC4hF!otDHOq7>QbY1ysST~DRBCm^%zQu zu^Bms69*+^7|aN*c9XYmMDe4{*KW8c?>d3nSpO>CQj8P*q!H~{67CDZlQ{=s-nRr| zaN4F8IrvR`cfV|Y^!cYDkyz5V)B87xVDo7U6*0ly;f~f7xbkXT=MeHuH)K?{+cs>0 z3O^Db8byDFXwnUrO&0QU?#D5LNc`e!N#M}EO(qK9>-u>~T#USV@s-!Im@K$ztpq=W zJ23uwO4p3FDbbMe9C(|b;s?WqC3L7=L8=e=4dYlY%=mui^NHC}m%!t_In$o#qIGy3 zN118Kx9UE6wAS#F?G2N{ds+WBuuk&h*sgtag9aK~(CP&kbE!T;0kKd6>cb4CjxA_{ z0Wg+J6Uzag&upALsYtp9rdcZSqi~{U{_J3Heb)v#Oz=q$0WDn^u6fwt=YSi__+mX* z8I&rCxPGdp5vRZi|t)6y0h7boRB_&YRq|pd*UTI_p{l4tH;vyC&;hkbu1w8UK6?3q#q(kX4?!S zU5Peq7G|02ne-fVg^oF&)Ypz6$adtENLi^#KRzBbTdj*S$T&dHy{`V&Z|Y^(ls*26 zjrtSgXJ#L)VB>qG`~g3|r#ME`f5k&`=#7$!>dI`GAQ;7l2pT)l0zm}LtTW&N^ys7; ztpv)v`T>}~nvS^Izs|O?0ZReYJ@YA>XYr2Wv9?w)?@-$f!H-%SitezugvHbkx!PDh znFGX)YVEd|V7_I!T)~Tf_B-Z4%{IdFqo<{oyZQ>Ve02}FM&<%p^))Mai~7^X{tWqU z=Hrr8m;09Huq|f)g8 z{8uFaE-e59060J_S~#Y)7%0q{}*1#of#jst*Ec8-6{ zRDcu<09o0X*#E7@a&y42ac~o{0w_{;PL6-)V*-e>0MGMZqAVxCLj~kv=L8_1{|K{e zfPL6*oZ4IJy5R17ObrJXv;tX3GJVg)0SoIt5eG2C{~TlC22i-1fEqF}!LR|& z#tx_n8$h;Y14NSzz~r)W0MY@j*gwZO0ay56kq6Z9pE3coDWC>`8nOb)1w`+ksQfof z%k^J9gO87h@&6-C`%h1`H3Go299;ifrUf(vAk#7d+Q|k8?Eguom6Kv-`d>0F_dh-L z-=+LVru`?)|CVX#nb{ba*#3X>wEvvrKcB$=8&Av1%Fe{~ACUH+p3Cw-cv@Cwz_s|l z@U*JSn=1mck{*(y5M-j(i`(1V%|UV=9#R0I))h)pD$3QPNO_?ondXD@G|#8sWrw-P zfh+vVVg`LS$EL<&nvgxL0jDT3GXz?5p?@b0d2DC^7D+`h5x4%h9T0BslzvwP)Vd0obF$Oxw?27MFHaRm(kFW&^I?nL`0-W%!N$}X$;$wfe4I9 zt0WghzXEZ0hs*{hFovKCzUm7Y9SN0%S8Q!^eoGLU?%!GlJ%WP}glkbRHT1z8L*w*e ztz!jh;1`q=Cnz|AYWbcueEWto1p3Iu2TFu~?LGd=`>ab$`!q-qDlJ8Dk0;8~h@Z-i)v%^T@BJhw!eh`kreT#>NoAhO2Y>OB1Jjn7{qHIGzy*o&~!2hr|K)voZ%m{vi9ffZV|VS7$e{pU+drp9mQU1ejTwx&lnV z7FPDikE=t>VDtZANCh}sc>?rUAO#2nusr0?|LctZ8|(k9qM{C- z03Sv+RsbU_2MYkm!p;rgg8cCNbAkVb{@<|wvMPhD{-*V0MHzc@2f)J?5A-2<`#S^x zv-{swLHGBac?tMq4*;{G1EiY40J_KG*Jt5iF@^jG{QrFg{+jZC75>92|DU!0FG`Yb zwzhu_p!?5=e-8lJS=oC1Jp@wDZmy84q2K_yAol+ns|EhgjaC4gS-IK$%Pr#yf?N_2 zdkaXRGXmL}SlIt|Sh+}Ad4kQ9tz1nl|5HqVJ2W0HqOFxZSlPkF>Op%T^H^B^>4aQA zQyYlDxIhl?Zy(47av5F!I_L)j7;@eIJZ}kmQwOt$d&$bd2>>}egS?O-XAFcu4uB8j zFXXC#J^w0v05g-lgDYeb01~?&z}&$Z`Qgx60L)S#J3G*W^)CYuz$^~7b$v9j0+`h; z!A}fq0A_iRor&3_g&n}GZS_CI0bo{sM4SL-H7koJ8*o8Fc7#X(Bn$sFaYJTUK2G6* zK$k}dsZnMnJFvwQju4U{TSv<$76?m|rz9bI&TR2#U=WsOe?$g^Fa`gI3h>bgA?*Ff zN)W<-U*$t>KvXgWU0I~#W^yXkdr1g;cnMhb`FL)ztxV`nKke zPT&)#iG%B(PS(Gje~Hz30VIA2T3nFn4fs z{OG!?Ae&+YSlc1?&#C|F;Jc`Csb!Zx1ALd#nE|5J=>XkTf}%J(?gf zLwb%U<;)3**7iXf|7U=N>0%3Vv3#^Z!n1g2*&xFHKN}=67gx{|10*6xkh7~5$kxot z{PCDMArXl@B1jaXj|jqC>=8leia#OId_)i~N{^Zf;iCMAAY4=)5rm8CBZ6>IdqfZ}>W>J*MdJ}c zxM)5i2p6qK1mU9nh#*{a9t9o3MfVXwxR~359&4WmLdPED>gEh-5B_I+I5|s@v*V-X zp%`u5oK3*C4jzwIj{jIeCJye8HN^uVYWtsd^U(&O`&dvs5V|Ih=%L`AJU9@(W=|l5 zF!%|4xJOUm!%Oo7LTFk(fe?OApE3wB>n9Mx$>s@!kg|OOA*}44JbDmT_D>*$mBSPG zAl6SHgq7112w~;?1U_W#34GA2ClJEQ?Fodia(@CLtRC|Ze0b|TpFjvJuO|?~%KHg~ zurhOSeYnX_lJfA@{cU}cn};XQ18fCpMqQmjPi{W&;qi0->jUA5?Lk+qo*dG{`}g$i z0zN2+izCSN$(RQX`A75fAR>RZKfnhK`Lh86KB&k)S|H$qf@nY8kMoZ<2>75Pe>OtE z2PyeyD+GK{l&8%Q@Ih4mXonuO;~)LdgMj>_A$m}eKRcoaCHY57^dKky=!qUQ<=;)w zgSPzH6+P(7p9bK+`l1J&`J*ucK4{IKoe}UsaQ@L60Uu=NNpA#v5FY!dnCp-32>2jA zj!!YqpZyW=L4p2kkbn;|^t3|)KFH8NTO{Cv4n6IWfDbZc`iFtzAC>kXKL4%7Ke}~O zH)m%^JO9@Q7o?T{FaGP38VvRXn<6hSIGFNbdob=y@WY*ETx+v3PLvoT zy7o)V7;Pk}<>su&RZ1@R0VNHsyA?&9uJb-Ee)rjKByaL!zhoqr+_NAzNm#hQgq}_LNDF3BYu+M(FhQ(vAV zk4M6zd909%#Mu$*MCzhm6NQ#RO%51R1a)+GczS;BRJZOWyBt#uI4KZs8TuN= z>7Rt5r8^(W?V^4EgLstUC8ZaM56W!U;=t1P<#|R70+P9Dvt4bKDJ3(O+#qDM12SqK zG-EOqLA zx%jn-57g@FM}pp5!b-MK#T}EO#7VhIUv2E-r+bE=S=8~6-0}%d5jv*XJV*NqmdetK zv_y>uDpW^YmJjvmI2`m7rb}}NBivuz7dD@PWVEN!ReDybkc1s<#3Qlwfc@*7dd#?} z@3!F?ERm>)V=Pc=xnOFsjnV_l;E%gHwU2$jO3JRclX1hjyk+b9$(>Xn3Z=e<$^{A~ zBHGQhRm9ihq3`E&UuhZPI2O)rL@iQ5`*l7a?Sd|Wq9z2t22{(v%ED~*m-?bO@OF|! z@=AlqbeD6}dy}$nb+-G6e;#|3^b1V+{MW|9>HN{U%81ni8Lx=2Y&91(roquk*6&N2 zy8cdYpSx|Olme?pa0P<1yb1iqv{ug8*rLV{nfllgfp#a4sbHs^;#t#=aQQ?DtE2w) zD{_+f(zAJn-jb|46KRT9GrU;%D{KCI`kr~z8_2&C8x1>$^eWTu%q?Q?SP<$`zq#0} zcLO~e7$(S(g;Qs99Uaew(-6meLDiKQ{0LKsdpS7ea zgp%PMlhA$mG`nvMwdoYo)hK1hf?+WsnDxEj4J~ZZF#grVsXun2l8E2WL!oz=oyj^b zZ+}tB*B*U%rWFIKlG3I4a<&yhzvosz58VOf_iF;_gQZaCo$Wd!LC2?U{JS9@VOO!M zy3RA5P5Kvf94}42#bIYE08gPw#VxGO=KQ%;TwVr+Nh^pO%XAss08*unoN%X6?=A#p z5MtoyX4VffR|DB!gy^+7wIMLI^fmR82w|r1Cbn-Q0fKMJU(^c?bUDdX{pyl6{s?t^ z_q!2R#tO-&3F4~ZVujSlUnhq5s1^+@}3F2Yzfu6QWw_Q+QkxCeRrif zLn~a_eS0{dUrNx2T0fVvCB$4-#?H5O-76q=WhbZacEc+ta|B<(_6;wJ?`t?L(NdZ! ze+?f>5fTwzd=}ErPn)c;4E8gZ(-vD~CQS|0Q3`e0po)_!q7)@Edxr^P_^+4!NB${( znO%uGOw$XZF{X>uZaej>Xs`PhqRQqXOp}?LObA6Nak~|jT@jCL@ipIXlit2$=hV)J zrK6D0dmqZ|)%tE?lvRzX?b5_}ySYi_y+|9@F1mJw_HL6ut zB-8Gr1^nixv(+Z+^m))PloGFQ;mH!RO+-4?z}VvLMTMSnUwq*5`?5Bq%Wkzr`d_?G zXsl|b)(cKL7;?*K{-rS^!g;eIO|9A)&!8sZX1PwzDgc9Zx)0Q>fguZ{yh{2;1`cCf zEj{i?DYX{`gXaR;v@N8Iu~s#L9GDJX9wSimiK8wcF}m=CVzAzHnnddy*_^ImiwP7Bsbk%t#3Vg^0OIc-*VbXu@!h=h z`N(zYg83`CFthNeu&sKPs^-dEgx;i&hb}RvfpV0-)nuk_{MYAK&ku7-k%CHXvcnT& zjqhPQMmy$hq%TB=UxOEoEiNlcO51t5f!-1Afa7s#@gHVM1iOc@+?3 z)yPVWBc|O+U1rpdNRyO}x5mnP(;8(ZA%{Np0hRuRdS9s8-ObLGK#Q|SCC|(ZKGjMY zl}PAph926@_Df}rg(GokzwKoYly{`UJj+@Ye#W~$>xBpmik5>j9Xrpefjy<$uzsbf z0|7r&T=(TlqZZR?ENbR>1CO~z1GAd0vyLa3Wm9!BHMjHEz~L~83cto#e%L7V!eNrZ z*mV8+(fb{R9&Tk;Lk7Je?Yi@Q$U?&z2VpJ_^~R2P#(KuIy{WLY9lh2S+WlB|Qg%XzvucXADOzwu{C zbh8r1L%!b0N7se3m|?{NuWoL($Kl_SV-Whs_2SU?^0FVdm6Uv) zo~#t1dBi0BiYllMu0QHq_2(~(+N;%^LIn7*D4jIFFM`t8hJ*cS->x_DYOW|lPy6V+ zX&{)HV3z7<3Fa6;FNl8O0&)lVH>Sv=zCva;ct_T-PFCcvuB)({x?v3ZDJ^5>?CGxn zzxtBa5%stJtFQ5&v0>xk@4}=+!Y-xi6sJ2#qQz}>b1t|mf&_bU>C=PCV^x)+VH@mT z@f(?UX{O_kj#V1dx%(M-%blV2Wzd$HfAzJ`P^X7)@>&AA$?le?UQW;&3Bm52W$D$W zz_!7{tFYO{%L&Dz^`0nCgeK1vgTYkBu)Gs?;@KlK-J1!o#oyaW*7_G)mr&cIz1uk< z`)d9X<_y)75vI3DrLA)RbK(h^b_f0&>yrUpxAIPGkH*Fq0a_JxX1rs)Ri=_mEF29R z;=#?-Z!+0k<&Z0aaBc{()g*`12Zj7!U<*3_yz!}WL(j{qjVwMQhUU)Crx*aG=hI6RpNPQRIR3L$NG}N_`Pv18rm{VSCra67 zD~jGU`KM=}4fdwF-cNpY!EM7%uFA`GGve+{ORK6c85}ZYHpC4y>+3$JNpbLpIm85d zA4jvRMcXz^*Ki1hg5}483#||;cR6S?zo{Td-qHC?V5ZkqGw3&Ln40=)(zsm{ZF5Tf zWUd39Y0 zm(~#-^5VswD^RVz&ABr;tMa9FpK4VB3rcz3nXCR+6`0Of`mUq(X#%e|PUZONwU^)w zt?X)2!boeCsT9EA$(EXzQqF$v(v0J}l`6&&zuwe7pB|a93CrK3|1BDejNr>4gGPhw z*8W<~m96+q#@*E@={PMFBRe6FaQ=Gy$(T70!Cn8T<*qbwPI?9EB7z)KI%D|c2?qbG zoT1 zkOfG-a$od=tJy=(q&sfrLQff;XR=U#0pBJ%v3L(85Hm5;8d)K1wyph=!eV=abICNz zI3bH`Kj9hI&pzK1B8&K;duV)%GWW2x4_glnvrrtP7^j}g(Y0VH;jlDej1uAF{5ADB zYKS$l)L!Vp=23?>SB9Icnd7Stepp6X>HOue(STy#zGk+eA^8c-6YCtcS@w|CkswKEpCM(ZPZ16pc5`L5r92G17F+#qnj=@ z`i3fMuh*MPZ;tRECG0#OQaUe}m$g_%U6n%okKP6riA*=HaOJJc_3?Rf8|?u(e;^SJ z0|kY@Z)FLd_m8Jec5uL2eZ3IV`)L1>Yp-S?=T+hHiA3|Bc8fLUEv{ZZO#asDfK}-Y z(S-j3^Dgpl#fEW9LFIRyK1>Jj(?#D7gs71wV+;u?Qs8O=?rTvfuekd{6e3R?6DamC zJ3Z?pe_^9?)qVVy1vCmIwPE5Am!3ZvJH2EOE5Q351f_~8e^XD$9opT(5`@_hdZUr~ zZq$V#)YkDUI1HUU;@}*sVGGw#KfC=$zkp}H-$dAwBMP}IDLaFG4E|m=JL{p;B#i); zwDs2alM=6SyK+0SscB(B6`r2)qyC88rtBA|W?vlA2vw=Hxs2vzPp&d#ePlA=VyWuE zT@%T^Y20nxsIpBcYn%QUNYlpHq&p1W0ZTWlKm0t4uk(vM;>*D!pa~|k62Mn;fThx)L)bkI&M#v!3 zAaVCA6|1Yi_U&7qHJDvYsKYW$i*R8sQsM11gd(SM16LqKds1YilZR&Z^0mJms_DtF zjMf3=Agnduc&~gcxaR#~?~^Br>bT6L5s_h#vhGJZX9`+T+HD;Da2<}tOg1&&UDZT_ z7%e>7WWYd*48rYQz^NcEI-fW&!l;~{`$)exReQR`Dc7$Y)8-@1P(!>OS)WaUkbHsorD+d` z2@XACRm?l|Wqc|0S`09_Q`raR2>xy~UTv)&Pvy|-L{fNfBSW8Q;@RxTKFC5%!-$N1 z*YLa9ZL$+-8=|ihpS9K4ag<8vg#v5ljT-UQL7z`SulH(qLP@HAhAsDf+{%T{1WRhS zx0UX+r_`%{$6WOBgu#BUl1qas>!3YfSAK+6q31X7b@ge`r4s?4ObS2>D+=Q_oDt8vShDV_5&(!c0mu ziCIJSZJgl@mda4@IYCj0ZR%kE!ED-8M(*aC1KB6UnOYKe0cyG*d5r@*Rkt^taK+30 zCCE zD=TVw@7mPS5a$Hi4*N8_&7$qTmI|3w>4L8`Yb;N*b)j3U^VCiJr{8>zxeH(EA$(KJ z2|EQh(3E7H95@^C%kr67>dq!^B!?UBM#%$l+uz-dQbVF z^e)QP#8WJ!3FwNqBCqIqB$+YT&nC8$#?Vmv#up8ngm`|KEs%KqeSN+%yR!&2>h0u< zmrMf1`N*}AMcuRrMFnj)S^lzDfY6A7l^8?qjjpU@C2+P-ky7-aiMThm%t-$WPh@i1 z6D6S@p3W_m^^OCm!?}V>qpwvk^t-&^X*`D1zBsEPI@#Ay6viCqk&}F~aAX2ywKyUY z!@RkiolX&c$84w>rZMn_XPWRtce1zHG3u0W*Mjda^`dDV_IHfi@w8Y|uN-_MXy7Td z13oxh&PCs}&S-A{K7M$|tz*)>_De$Gv?BMi#SSTajf%pvz;ig~<9dJfzHWF}#{4x` zQir*Pr=$*{Fe=4_6d--Qx;WUZ>697yHZmrNOIT5^Fy3~D{Pf0HYzkU;fYjZo1R3X- zKW6pKuII6tZXtoM>%$r5+ zdd|HSTUgyC&^J81vEhi#TxH`Rp(0<>jF9&j#fRYOTl6^tHC&!cs7n&u7yhO%kq$g3 zBrJ=~s8v3HS0d_Pam(of2Iz|a#Af4RG->a_Hs;in<@#pYK_r31Mk_64N{6rQ?1NQO zUUH;(7+ON`bqcXzEtwEU@)`Xiu995#Wg3wL0;a|-OrF{&M&^oTCh*|yw4$430c?3J zbwRqLgx#E$WJVfhtYYaU<6E!cBe*3u^Qn8Ys%e#H&tKHojG(U;+xE7ZKG&kA8(_!l ziYsXffeBG?RfE+hmE5Cn!>DV|`S5J&%dX>X;HxiF*_!>DvkVigmQ(g?Icena>~Dg_ zvS{8iAlNbA*Jm6+TJ%OhSnC>c-*KsgVvQOV*Zht-d`gff~~A^F?#gcVbkm zK001|mOE6?Lnvl=u~RSFEXQSoM};^?c6`r#arL2rB|ARscT+%u?lZM}#xC^lW*^4- zxQma10wvF!uuu4V37$`!TYJA<=-M#R*ZK+c>h{rso@(+h?l@IjXwvvjK`mdJZrk`? zZ7Zmb&^>q4tx|k^tK(Y8m(5=XE{aK)Tscz7^H7q6Yk2D`zt?v%_xF}%7IkTdNZzr@ zXvG|sb1pBMe1j&?>bm&O5c-V{F;06Jbd3hN&Y^5+7H#{rQ%EP=tSFoay8E}?M_-^fOKCKbs z+nqMuLs`d&>EoSA;l=7ZS@z&UaF!O5)3{FhbynjHx(842b51#J+`AI^qq#0zixT4D zv7)&+Zf0>GZtEQxL-DYBIwxW45jR;L+IwWvkrN@dNmKU1YC&dKR#)Gn`O=SB*!0!x8}S{oAN=RO;ee2+w(&BrP=GH8vS|c%YR;;5M`&u1bP$6Q-q|uge)Fm>XzB zQV(x2Zn~*;vpx8a)AAFXN3*PcQ6VvLz=Z$QxM;s>pmRn_N5D1VjR1uQ{wRffOj$!^ z(M3uKQ?AKHU=trKeSk?q93A~3aNXcN?_OK;F2YBj1?%R-Ex<8&hz=R;@^pbgOZqJN z?6?qbDpBuPeaKlWjZ|j2EP7VO?s#>AFm>ruHwhHQw`1zphP%HfO}Ow}GT{^4mXfyk zN`}aG)%?#W5{{qYl8#cWeceuv3Tu-?Y3zy4X>i;@LRt*0*Ra0z5YEAi25m32l8QM^ zoBLXbml}4P1gVQySK8m5_@UGY8I@GBauFmir@mST9CHgU@jMGACSdP68?8ivIw1CP z&V&z>3b3UTps&m=5717LEYF`E;*=`CwtjmG*xDCUb8TM|#Nm!@s=1iK!ZCBj%>H~p z_MW261Lg#%Q{t45myNnrC^8}qv|o1_s+)ITED1LEC_Dzqe+J=6dVN>AwcJL2=04sd z$!Q_`(YlC&lFJ$uiRcIz92PxPEtfn#>g!Xlzi+RJ)^GJHm42fc+$TF`-s@NJqQO1~pTP~qh=2RM- zi{RToQtMwV#IMe^<|IY>;d92d%DbZUh?3va79$J@x6}5WNczvVzk~VG)%vS71)MyH z8b$Gb-Nxe^>8b4gH#H2EeS@;rauxQ=)Yi9l-!{-kTEyRf7V7>n-d2$4?(3Tq%c)sd zZAj~)_DMBTtmafzR>a({e;UU9$FrXEb7R~4s|+DkF?(J1lfi}rAqbwVfSj`gaI&61SdNm2bMj5+F zB?{N?t=0w#xL^G@;^9B2UB{keCDw43C4Xz2#^oHXa|$Bn5*_OIB(i#ec^>^!*NwPr z-=o-@7CQWA`hobdWYm-(lydR-$yR!!#}U;e;Dp(^`prA+9Bai9eII@KEZ8pfR2$Q1 z3O|)Oyv6*+DXWYuSkvE^5x)dLs@aIJHpG0N)SGY|L>BZ{I}u;H!Dg z3+HC=O?wzsp7um14;~+w-5>hxVHzP<=7*S0jUP7pRmjMT5)jevdR}pRSi>ArI4*E% zzY1BY2uQ4&_=)5i9cJ9rpG)wIW8uKRYG$RxR*LhL!x{U=Mpip4I=o1b^v|JqHlkvY zIVnP6aeKK+L~V;6fK>`KG(64iO!QlJ#RIl@7o;lD5Hw@6SfZVew<`7uX*7IISQn#$ z$_}Qv{5-j~o1;+c_8Ph(0s_dYG`j69wgn$dKjm8!?9xkWvU69Me8;acK#|J z_4mJ|1Y4qjl{M$MR_R@W6bhLYdaSfcbUBFr)+g!WyuZ&RZ>ZpNucu9lnkq&o&nsd- zL!I+DbH%$)jwq9t6IkrlJ+l>>zK<56KI1m<{3Puw__pM<=d6=Fg`&Q3Hb%O?Umjjb zM&!akvcM)*%u1A;WEGnq7s#@pK$MSWwKVGSp5T{7tiGa1pu(s|jXy99B~&vlA&OF? zWDeR6McvnX3MQ|l^(;#Les>bP0G0>Q8;3zRwyb(C^YF*4zsv0G<#%;c>58dq(X$t6 zt{KdC2sj%P>##UG2pysDxsJEj*F{?nS!q=)V!tSH&)n zeV-}dQq*RPj0RAhM|z4gfh$a|6W{DZn_j`WQrQ(;a8_Ok)4+AvA=nP0&m`*|+I|{v z)*q<3SQ%tdJwZbdMA%oW%s=pt(2mP^o2sg8M^4SXAx|3k)9-uB=hctWa}IR6&&6a2 z=<1!X=9sRT@&+{~;fj)qES@(pYkKfqgH3)AZA8JNEq?3JP87*6EXEPmckj`xc|}f?3wvs@)n>q7F`R zi}!MlUoy7r=4x#`v5~IU0hxQrDG7W9O~1anf?>F{;FL(GLkLdJ~Xjbm}YS^&N>w!kkhp zH@@Yl2~% z0Ny?qrTFxmRu}P4%w$2DsO^C_!YNwe-`z|>j+=$1&-YYq=IECWk%^&hr8@a8&4EFX!3i^{CoPskIcP@hU`EJbS%bAwS+@Y@&?2uOqc<}uq8Yw~LO_Ce zRzT%EJ%z^?Z_3D)qKbt3LfI}mX_^3ffr-^0SGpxowrg#n@E*>i%H=^4o$+4z>Us{v zvb!#uhSDRpp{(eAp~eL&&2i}P=Po#cbY7fEfjtz?3EEz3$8jS^O9>8v)rFt4FKI4R z;8Md#BL;#r<-)?ec2sG>sn?ARC)*YVnat{5VZtHom;7f#-=mJ1j?uRbHL7m{z3F}^w z0_9qM&ZW?UzFi^I`Au?sm+K9w#8~-(6k!4M*7o}6C^0``D#)`7U7-YUCh|p)b&r5A zt??A?KqR5G9p!6IMYURei^HE=4NF(d{3q(_M0_x;F&ytbh=6ydmyr(DBWY4IA^C#F z7A*0|G=(ZFffzZNFj9uL`-7~wEn0cL-q7h8g!+-r%)bH^D~TtN@IRFeNRs(mv&^`^ zghtt|-(2!Qk@?Z1fN=+R|EzzgrY`jaHOx%i~!$oKOi+1+6nf5Lhp*h z=fY#S!r?PKO~E9CL*CZtR7x10@X_5;!V*vH7(&6Ntc#>r>qJ!E!pN||8)~z>^7Hbz zroLsJ54L4iZ0xxjj8I+`K)|~!gTgB-l5u*G`AaoBDR#h~J6386{mSD#>OdyAq;HYy z!wq4sg_~*{QO?!x)*fz^`at+FvPR>~@RSLZRDHY&a)&+ZDk-Q*`&S3zH}oTlHXbSJ zJNd^5mKUDCEH&$*8(?0ovbNq!xuxE9&jydwOvziRuol5DM4{exM+}t(nl`K?H!h-e zdt4#^JokE!j*{6L%c*{Kw>3iW<^?|m`Ag4?3BrX6GgF95t?2?WG21OlGL`+?AH_pq;q%!?juEiF4)^^P=t} zZFG;n`(&Sz4THz2yih&2LA~7h9g{Og>0n?ALu#gUF9>!T`RBaDKEB;@K zZdMmoMYfGem7lSb0Qt1lyHFvxjHi?6uV_d~V%%jfUYR<{%4AKxVTMM29p|w=PrXVa z4?8QML4=a5VczKJ+SZ~M)meAh97-^zP0l*Fx%qu|o$u<%btYEI^p0!?5ocLMi(M0C z^j#@^FhAMv==asD)$E&yAX7G9#%_*b%+FhzHiAe0r7tvc} zi)n(oIvsJsryjL$bah%h;z}yjfv=<@{MoRwzi)Jf%8LfyI#D_!wCL`dUeB+-MMff7 zMJeACZT)!zh=x%pm2!Vv^=zD|I@H)gWq2fNhpm==izGV_Op@4^x>5 z2Eo}iXh*M6xXqB9632F=Lw6075EI8?$27hTki$0#2#g5Cg26|@5hJd6yIQVXrle>< zZdGyndM1`;yI*3fL-K%`X?6*p@eeKpXxhygSs$T3LP%F(Gi;33^954kLd=EzDl9#vt zVuY0ZJ51@aOQ7r4qmiRv1 zg1G7jUA-z(=tpP-&E^g&eFSmAINB*#%8yBF&XTlrA|jihvDZ~H&3d6Ygv>r_C0FRO zBA@ok%&A=14|r?Z1_@{{~vr)J6CL)ca+ z`==Kv?&vjb;Vawd?tX=#MC%ObpB36wG`&A~eUkh?mCJ;FG*Q|=IYgWi4JDiuwUqjN z*77XxvXb3(s+^3dA7KwJaAwR(C_ z)bLV4mBWUa{mhWcxi1UY7XiMD3@j1{rpwLJi_HEPK89)G6&wnZ(eXAMDyV8TvAG-2 zVIxEnCej!-{Q<)>cCX3uvM`NX4O6bw-*~TfPC!k!Z@hX2mJu%)iXv`qGjzd4S1Q63 zyQpp;w#L(m^w5aHRD1QA&sdTxkUS?q?AiI{U=N8H>5z=>EMj;p%Fqc2k(Bt|c{4gj z1Cm8p$OzW^S6X|}z!J<-@+6aU>k0Pq{WPWouFP3i&TP^hU!ncso*W;xAGHE79waSk zLANqtCEQq&1=L7OZfY++(jk8AZNkD&%a&u?%vGbdOYTJppzFHxjG;xM%;{ft@J$DS z8SCmbA|-#@sH}Z)b^XDVQ2DK`x+@$9ZR|8&ffg`EANi}%uj5ng;15|c7b>)zY0?he zB<`>{XMsi>(4Nfc%&;dkmrz4ch!<};<0f+jtFqj@_VAp8gvw3Dau0TIF^mc!ogV(; zS@+vA(u`OvnGa^9_U<1-^1pBOPwP<@f2p5eOiSP!wkAZtRb-_RQVH!~K1#l32r&IZ zg&IRhdk}Xjj^d6f92`95K+<}gbN)v2^~VvWa6Ovr{j6v7*~vCpJI4VH-;YS3`_WbC zv>o$io{NO`PEu;?p>T=~Hj9>32S&%su-v~xh6~q&b@L2swl*Lg&T15wg$I6I@6GoT zgL1Jxsyp$MytP`~%D$AzrjTlZ=FQ}at_%`W92 zui9iL(P@V7h&lfh&!z(m%hz4n0}y%aCMr90J;rsTR_yVp6d391C? z{V?8?G@(B8&OQs7m3|&$JLd(LQ5C7khK8@Lqu=`@i6Qs7`QER~a!F*CbieA1K#F1f zO^rKra({Fa;n%Sk3c;8bN&bBnYQw7IlOqa671>|JYF+bSUGab-#-|tOIxb06*VIU>jvk;36Zw6`-D0q?BvJ&` zq})#UZQ5gd?9eLYOnT_Xi)IsHm4Ws7GenOo0s8LUydVK|QiHO_s^PknV&~t zyMt#vLrS6*gBcwh3qMWsGLy1&dOMHBuSNw6iTC2MjIh^NaF|)n>ffu2u^e!l%z1F@ z3ewJTNtKPk66hNZZWXo#f!RJB?na_kdw!JD>#_&j%Q0GHV!6t}5rS&(M?*Xoh_vy~ z$fN?fJx`*kHAa^GUj#ag8{XSH3bH!%SvQbPSbRmTh|GP{a8z3=Xw#nlBlJ3D3~^=l zxV0zltJ)C2{SpRT%O3Xv7t8VGjPkt(A0GwQFh&0l%jB1-NP(&V+xF@+^qM9DJIl7U zTalfd0s?wRmG~aX94?;M$&C83E(BEA(|l(_AuNZVfMJZHg<4#U8`p*xhI*N@rKo5k z!6qAJ^JPaiQK^m@I?8FHi-DLvMp)BIe;FKHK?CL~f(7LeVw^R|M!%Z=+fsOc;Z@bw=dVXD`&Jru~j$(D-S` zn&^My2vt-^+q4nf%Pax)?^-^j3(itzOInNeoJBGOooU$0W zH~rDXbOkVo2^z1wf?d9MA#&P>wns{IEOD%S2-PMM!Ah@usgQ{~(-^>)k93~r%Nrj3 zL15SF9dY{+ZI<5Zgy~KYZ)n*n1_Q0(3nm+Oc&fOl!{RzT)Y&?W8I|x5LRLl-uEqi~ z{4%=$sQFXz>9=@x{_`Y(=qo(;S{y?{AvRprRkmog%FtaFd?mJP-F%4|_Q{4>C*vir zH(TuZP4f^py?f+`r!H?IWEpN${B}2{JFlHLLQvFQ+vU>br@!~e%D${GsiE00XCa!U z;D{Vj-ye$|@pF?X_ruoCrvR?c`~=yMT)PFH?+ zBW&az_NdoNj+O^AaLMkeaFdZF;{qJy+%5qC#diA|k5O0+J4H=zoP-*)Ya@!bnrjY~ zcx|zQ69<&%l?f#w&_M+Q?jD3r@NaIIp=L0orWN!l_@WG0zeJB@()wgYXfKJt*U+ES zeBo5(Qht; z1>&EhJxoi{VcPd)4YQou3xzVJ5@UpZe*9 zl7_vwnqw&a+?T&T zh{|l=!OR{(@@)8JUuKWdo7)C4#W=^HO;P{Mspb`nirht{f%hG?{T{2!UDk00giOey z&YuzY2mDIMx|P1i@Yrh5q3oAkQ40moa=vVn<@;ti2KSa}VKqCi_2Y;M4Feo%5_j6W z#dl5FJ6q(AgGO+&Ex?!5xwtLb`}}+hDnmv9*j`@y11WZC9^3&@ie7P`9NE`Ib-&li z;^1JOuo5tA*#c3>{e%hCZp@#SXS7l_G0r;P|L)u-0Gz%uHhEICU^ zCpyoIvGMQ&5#fbUz1;U$IT7cv>VPd~AHX}u{K!E=mUDAWi;8*TWZoGoc#^UG71h*A zfG0kIH;{C_ow;%|Py%7ki&QXxA_Y?qIlZJv`kRyUDPEcW3`>t(bZHTJrGd9ggPUgBX7-T`&yA@0=RB z9`C<6P4l@J6L}?Kq_>gWrjcQuMH-H8%X`eub%Hez7Di0wkQ9k$d>7jssF6HPV&vJ9 zcA0bS6tk-#-k(K@0Q-_4b4)bVK)l*Pweyn-56!2UkQ%EA9fzw`nioOmIj(+w$Gdn2 z-)M0|^e~K8H#}CBIK<>9q*;nyJ7Z%{7+xVRa^%_=xKXHd3$JW?0e%fwE~BL}OdQJk7DK2N2Oik)iOG2NI`u8^UZYbpn38vn`J#G`iNwDA%7JLIio_#Wn|iXl zQA)MNYsZFRWR`^)ukv2OrL6J28vHRWS$rF2n*o{etxZZ< z0;cEUQ(80()gBj+1)biSLWWKOh_M%ZlC_rRCiUW->r#+=vr#edEuIAF`v5yY#J|9* z%zT8ldf7L|z=MvC?fWT?>q$a_cw2Zug%P;A=Q}RskxXRX!!LHNP|2$9ymeL0m!du2 z(2RZRtuEUq%bOHc9~+6J9;kn|F+UDxY$}qUmy4-O#usKsK#D7d8E_8E(bN}e?S7x~ zy2+DVc0mYQ7t4=w)ijY>yWz+ETJ+)1$=v@J^gj#0MA{=mi5 zON1`RFYX%P#WbJ2W4HJSn(JS}t)eEwS0gh~VTZpu^kDwm>|lOYM;mGTVPi8CHW1G1 z@&pdHlQ&R7T&NC(koAKchdPolPVrh8`9Y50R7t#E-9twJ=b1iVDH&3v*mmYd1(l?% z-ckPh7JQJXKS|1WmKI~Lm0s|EtsuprG59Wtz}np&3anR`xV4$E%@*uhJz;kLZVtaDZ*d(UIq)YNA<`Y=UaK9Y^$OeiwdVor=Ns`9L zaD@lm0B0p~+fz}#qi6K$GBpwW>e3Jz+)%}7WnX9*Hx>6YN`LJjRJ+y%XCBO9c5-{js58rjX33X6jSHb@@=$4_v@PYpu0AYesbY0?73o%$l)=zRiJ>MS(xC*0bocnph~^9xR_jc9Uh? z&0CG_b%F@qb4M3Flk4W=xD5rGBabZu+5Oplj8nx99Fvomvxo1! zTsNJ^fA8O}$%NWQLjY1ZKd&h`v2dYKHZo9&6b8hHAtYvUc7@4-1SlWeN@0{WHYk^F z^ZA;umKFjoRW_%_dtwz{>bfM@LnJNY{Cg3PDzr2Pt!Ab+=j-rOLW9O>e06&RM%eFKPTwfd~6pqoh?05ujE< z%Bb}hB^ELJFWg3$EEvtF*%0tJOq>Rq)FjvhG~&>f>GZf)gYJCg`YmHg&IILaj#Shr zB=OyBJ{GcCL9@SuQzAD#M>aLC*`>9Ne+b7eZk#-4<-3pI%n`meg2N+#1LM8<%2i_rA>!c*Z#NbP^(z?BpPlJf(3O%~IN z1k7M41p1sG;W0YO4=FdN(+n{(Azd=M!XQbz-@-a=7~yPkNE$ykFJ#mMR#CFr5a@(I zX)kA*RP#Gy|JxmS6(KhvMheb`RAyX!)%%IZ{NXkW_NE?5U@jca?3AI3B?Z!547ptr z!bi{2E=G2EX)L<13$a}zRmLq3c{;NyI%TNMlQHnBc}uO>#Uji15whj_XfOF0NH%=6Ku!&re;R`Q8mBFX2P$g{ z;ua^UEW}7}bw7mkz#rIj(VGL*+fSW-KZw>BBFqf;=mkm zmEav1Y4%8eP*F19;sx!T1PYptRTuZcL)a>r0+PvV<(*xjB4*-bkXp~5srm;&@bp4b zkke`6H3rX;-{wBWSAmdu-knobKjX`5uUY5fDX_J03*kes@)aY2Y5!FqN)_$kCet5y zKjU3m?HE$k`QsLeF`hOZ)u6JWd5A_@ zQt2ZyD@B-%GhdPSy-FAyPw$|l%yJEcfUiyh^U_BeSk^;Yw0qJhq zAiWhRBA1MC<|LwUDBw1zWi>9v7*s@hahggN1LWOTS6*4GrGh(>9sHQrBq%ZGyc;4VAzx5nI4&e z^Fq9_;P{#iSb;^J8~$tK`eiHi_0%%W5x{3kBll0Qzh9R?s2`PbusEnMS^dy>LsPyN z!)k;+g&Kho4w7p_Rt|2Bf#zVanxeLFno}#iK$b?@v*)?GE z9$OjCkZ@ATvneW}@=9*Z`^cZJtl0dn*@MM=HXVV)AOk{G>|rwdWL?649#D1FHLEk{ zD>Qs>qV=ZX?W~Q9KtpW@r!v0pZxWv5reOWa1v;=^uPH0V2WDbh3i>-j)#j!d(&N{o zH%-1e`y0=ZBFj`#VP(?gkC@pxIjICWX zRi!T2ZyTu!ju^Twz?aGjb~K_DO_Z^`$wxfXH@rb0DRWI43@<5%B6P_nS%gj(LKRRR zb_a$^df!T_u_9$b#~l3lTI!cXfJfYj7p|D>QAVtAJ4nx}R<^2)ecZ!AWRu+WpSYuP zEO4<$QS5DlbTAwgmN%d*&%x=kk3?9@sNc;#u00#Ty^1>eLu4q!sx7-SPGOPijY?Wa zQ~VzlVhj>NEIGJeePbMVO!lNB*O`g>tZB4sOd^%LjN%FfaqB6gC9S1#cA#66Q2u;h%3E{gCGSPyl&hwTaJm3i&Dom{hc&LxRNu2$xE@ z2(s?|Lz>2(XtAU#Y5eb(=_?{~zOg#*C)JMX0>9{JebTBOrG%UZdP=-gsr?PPv&G>{ zb4gho)rks1*7qeR=9#t%)i+M;QSJ_fI)K%;6t$a_g6CMaR8=zSq&iGF_(tUz)zIJ5kj)scqJTYdRXA6Nm=nm-Df+}_xgGaEf(roQi1o~! zsX3ziV^dtu9uu&&t?B6|p{#jjB|B~SSXUh4`ql+?Oq)ik^}vk-u7d?i;Ime^pEpY| zan;GHV&sRllVi1$PYF}|n;;&gB@l_CR2P)a69MvpfAu<5M4GTHyMegTy6j=-P*Cv; zrvI)Qj3Z?G#!@b@F&)&u@}sp|z4WPZ_YcVGYTl&NU?St*H9Pxqa%f}bi+sE|33TRn z1VZaeVG`u~W|{>4HndzG1a5fb91IKuzjI7*AI;}0%k;cqjuD&5cZhq-P<Z4`vKFt20J6F4}?*}T?J7o)sOItT=ZBGHA(9&@#&HB z3+oU6`F7wWwHA1}TKCS7NZBj_4(pKDyy&u2G#tF-dkTB3V$aOsZiuYsD4HY=b5#)Pm%*^gNEjPmg6-0U5?EOeZhq~+Sq(Xbe zRO&(!1hvbZ{#f^|TUAt*f$&Z%R~V$$W0q)f2$LfVH0t+i?`?miezqXKLL zuQEe;8v%{v_HuYp8p1>DEhV~vOFtwcliGJi!O+bKFmR6U8v)=_5rOK!9LB73?CY`I z!ZBnGS7v08DT%KSdQqx}O+Ti_c-J6J{ph3W8keO|V>`^&$XSRn4%T0IO%nu0*cooz zCI^tRlyhM;on(L>_1l2sbKesLRo9N_p-Dgdl1EAXn~%$7a&QMNh28*W13h1#iaC{W ztt~h3G}hhA8{%@ZH|<@YH9hK)f5qEaQF{&Mk4AF?iZwF|CnTNJ^-Szsq!>HkZo8n7rz!KC8G>tpaH_sg)gLToZCr+a zfre~vXy^5HF(|a`Bp#(@(}x7)9j#*O%Q4`1-aEkH;X)D8aL3GMMC;IpwQ6M9aU4G- zVxi>4s`GJxxL%fnbl0}9S;N)a03T<*BqWNNV$3Tm`~JzF^kQe)Tcv-S<-LgH7MFUH zXxDBKcB%VVCO}EeY}8VfdzqVa2!K+dLWSpl$0-a$sM2rMM<(=>r93(=iO3f7jifU zbIb^D67B0BraF%OuUyWqC#kSSywNSQgb_@dIb5gTXuG%ESPik*jA0*eSSNq;U|k@_ z9{4>Lt{KdGU_C>aAyWta$TWcSE!3)e`P633igq5%(b^2a4P3M!L{6*NRa}cCB^3-@ zz*0FHzP)D*nry)Eh5HAVHfSD;c80*@oyNQvJNzHuzYPR_!;+1tY3>i7>Z`O37$R=Z z&^?$d;hGAa+8N@!3cC9shnc*RXxVhG(z;h;1R`i;)w}LBaJ^WytX9`Ktd{gCB@bi` z+9-XlTrIoGb8~N*8~!XrdVc%XO>*Y_ux)&p_d~OAa|JGQK&d_qZTp*xn{^Aw&inO5 zT<|4Y+8x+W30VVNdWx5ED5ffga_HW*lPaW`qcvCkW19J}b44u3$7==$TN3NxXl4`{ zwRmUa`z9Sp#P;d-bt1^KhbT^ZxwAN1RL3oqd+^rW%FGdXHDv?g%&@ah5vfSRj zEn`8RCS2DEXb3&p^x_Lk9a*bMsz26p$)kp6CU-1n*5IW|Vy^9>qmO#;?j~DM2MOE_Yn;Iwzhd8o0>i!r$4J^M9j% zmbKl+)C2J#&9G>LIbDG3BREpes_Lq>Sd0Q2q48oqS>}t7;&7Z7viJQS$2(wVRG~%T z3|u-+X?;?lahG9N?HM%!Sln_JCtNf%jsOZ~O3yl7Kop&VgDQhMqs%kuyTAL%6WY6V zx8k5Cx&UZ;-M+rf&gbOSrYyJ`NWm&AhV3v)F3t?BrI`TKMEGr+16h_MPrL9bJa_at zABrdH_gw&@nsp$rce@Nl6NNz)pKQ8AeBw7C+a4~Lz972JzZ}aK ztapbtP7|?C#HSsyP|L$A39ByAD4)1*7wEs3@kSiRGUj$8&=W z4JKy%slu+$JRHznp1OWlMb`xcQNyP*&(*fwHJ38z)aPjk$}?pw3#CHMYR<3e1{=q6 z2A0hkavv*a7&fA+P$8_gnr5$$SPGr3HTp3GYWA-)ARd24qlpg>kL5&#wdfkReaI@= z4W|+bNm-B0kD(p3E7JcA**h6>2k@@p|D>D+^uLj;Pt(fKSHj1T_Ld5nu=|y(V|Xc&{=X{2(U97cr4lo zdpXs%lc3N}>fuNMy9}Wk$5@$uee%u>2SD=Dqr80w{TC)QalL!-!&k!Ww3i7k5YFJLD4Ce)a#tY-Iz_W0s!aCb(c*50Bva=k1fL1 zjI}>ri`W;(1z(P|{vw)GXaQD?>>KC5|3Ckdty>TMQRVHBb_QjH0Qc4b!iHM3GBM>I zW&PlFwv*seOQv|W52KRkDPL}wB(jwEq=yhIK+VVF0 z4pyUAx3dBmONF%~QC`7Vi131+MtToaAC6hTWV=BeUU!v`eJvmvKVJ(v0k9iTm8)!2 z(Cl{NLjsDXQ>XYzAH}>|b5eRj$LnRjUq%>ZqP*19nb%PVp@_E5MpkzCgFi{PUG12cg{G#FjoC-h2-psYtNQRp;&8oGK z05usa3*?n}MK5%MieBn{+u(2btZ{+eP+L;)byT7a>5ly$lUtsVzO2D4OTH<MtW8S(@RZa{e8VGan!%?h65TA4B;kRqKl^Eh$#KpuwJaMCM?#l(^RkS1r98x3G z$#BEx-jeizghTF>n*#l;6{=W0G|JvfYm41+pjyxIydb28x_*@`11Y783Mo1L{`96fBu= zfY2=z!81Vn^afxKTDB}2@q}va1Br24LYJEJzO4_43bcAjGNlkkgr|@~+pDnX>Rh){k0q z27b7*OC{QO=>?||s(8aOwL8NE#HgMCvT%L)J@A0l)M4ik^_cw8Furg67oZ|v1HhGy zSo=u9B7c|9s4#b^3w^RIj}sx_BO|i2TFh{l3$kQAUP5_asgF^Ac4cx>h_Qve(dLPL zfkejEh|5`U@(05)oRJ>AsEn1ZHrLQ+rSb^J5Tsd1!1;iq^9V(6Gv7b} z5psbLdd0DT%|Z;?Q#cN>;&ZBcV=zP{xVcL8TPlf%w90f8v%3rTL`4y0vn43MG6`io z23LcRc1IXAgGqn#%hFv-Ge^pPDcvdU<5mBv-yfpo=dFd}@^v1rRj#gasYwSS_EcAL z-uMpY5Wo|9-X-czDcql>xy+N4)D2O841(i4-ep_z5iA9Q>Dr|&v_eq?DR?o7`F4-d zeQUDyt({0^Jq%BxO?_g#iz&rUU}YKhh`_}CtSpl*%ymj(OH8W&2KIx82T^=M6VYXP zdvYq}7!HL7N+O23VCuz04n3>(=b$EJ8ci?krnaFaT+ zi!LKfNrz!mkr!~Z4PVRx=v;XBd3lwr$wT@fSqAIhP67$F)I-!A700j{qn)8 zT?^$BJ`waY?~-F)4evoEL$%fc8lQ4a_UL0~%z!nUP0f8dJITpgi67s~Qzh!yk5FIi znAukZU2f=Ko6F}tYS=p63#!+0{HwmFHH%z=rI(#r%!?nQZzs~*rpSYM8^rc=9yJ8? z2$G%i70V9!oo-7EADamCv1^Lzi(D1lUV6Mjmk6eaaC?dG^>;iFuE!svz;kd`CMFrt zfg)>~3s9PK;l~eE0Et0^4RMo#Ni{-dSo~2pdOPhv(h#pfCJbw?KZY^86z|tN-uxi} ziu-{M#OGd=YBm;u^wdMm@s65=ivx2(JApTmA=;)G#NJ?Hmrd@}hIhc6dJ5mG7(5My zNcLzqEBkUIH_ss8@tn}gq&HGY=e+d{vr&;0fxL5}$AH+afRr`<^aB1dw`!Z|C+TFH0>F2zDvIMhRDKMk_RYp4C2o5M_V2Ug8R=fbwK>ow9OW9{o zg63vX&Cx#uPSch|9ZQNkF^QhbG z-4?xy?_I3BUWn98Hd(bt@r*@JHM))0sp@59{c>%b3wyaV3Pdqh1&powH^GpXAi}A5 z$n-JcUh*kcaXI-Si;*rR@*#|@SxN}c>J=9qa`|}hI!UzSu6Sm-mJfNq9dET@k5MUw zIR94p;PeB@WQ}kY${*`YRs=%+HR$Ej9As+-H~H_s%O!0rbQ&W-J&5VxNNlz&`3mX^ z!cL{-QJ>VPYeDFe#Yr*B1{zG0f)r7LS9Z)Mvp}7TF)+q0hbl;>bzr^(PahVS@N5fO z5rB-lF_QP*CaY2n@B^IuSiVlb8Y=9_g3T#Ahj$YOqd}!FwOYva0Y{PL6imvN)6$unJ!m~CD!6aO(9WGzc0HZjU)Dm4QbIcXBCh;@ zU*Vy+c%XHR)a9Sc37z))mGYjXThH)A*9X;bx$_p1k|w?yRI)!PNLro9$O){V2WVvh zouVO{sr+zafjRiNy=1&8!5Qn#BSAfNlM-V7Q)W)w**&uz%O#?$2@3?N>Wue;J~Yw& z!fQVMWx$3bIvN@rAJussA2om(_t2Q?a_%Prbxy9URCB)*G)R^b~Z6YKg3 zpwU%h4zDVtAWwI!#H)kC1>FT%-L!A8yyjaLSBNmZ^Lsy4iOT0N`f3sG=;pf95?@*V z?!uL&^59%9J8a=+SfGH#wugsP#~2_`;+C`h)JEIk51;uSgNsW`paV`5NGJJ0>^VHV zR1p>@xiuZ6VA7`5*cxwPMBG|dIPGv36_k}~gN9)veFxXt>fYrV(D0XW+kzsQCR)Oh zulK~APSirCg%EEgd5rUq#Eo9DKY|)@R>)AI4xHE*mjcNfoAf2~aP>!=>2NUfY2z&^ zFlCH>PHs*3dQRHRW~`&L=1?!3(1zKe4VuTfY=L@qLw%ZEWj$qewENqzWf19>pxy62 zFcRtcNTg)V!iqI7nVrtO*gJFsl`-^cdqeN30W2Wx4eGUN^N?HJ=@+`o{@>`1=IMhk z1Pz4u%8KIU8Kpj{h@-s>v28jslEQwa8_qw3&r@-y%n(s6#m+C?zjRYJvZq@GZ@;%= zSrmc3U2D&uzWEgK-5L~g_{gUwm;6fBYSxp$qQ$u{WN#1e}^i^*8)-{r~zkRPyAun1yhAg*p??}x~<)u%gynvU@mmK%w$ zDsjfp;Yt)5QV{tNtNR>&gUgEZvh>R8H&jS8^NjAb=~ZMA{7I|OHuxBl@uPG#aopY zLtTYxz3swn_ger?cu62J%TyNs>CNP?Fb~S0j*S0nyRHoP;@&_m^#i+X%jf;235N)T zV6jk_CU&a)#m1Aj)0jG7`!HaX6ET;ykCAR&zB?-J8~axZqsqH$L=`^ht&wr|u0Z;V z_<|Z?e;i`oIF=nu@TzKH6z1=yT~&tYJAcb;Ia5XTYma zQ-2a}yj~}6_Ek?YxSUNXFTLzlt}s6;V&EcWMDFx}+BM!h#s=JRc$<|t!3vrhhwt41 zC*ni%2Hz#~Q>rzgNvf=IwjI@5Fw6ZbSj5ROFm`O5!=ACMzbl4LPo9;muvcqkt)zvCybBTjgLM*Hu^kdHOk`e-U6l7Pi z#Y@A#h)V!>$#RFWL!hMnp274gCtWS=AcXtX0&NR*W+D*eEG1G--I(8xH$isqO4r08 zk5ZfUcP|lBg!i(SVI6PB5wE^O7-lf;gHbB(onh!oB{#s#$YSKTr|dNbl02sj`yx*UWcs29b;STz%4G6tgGbBvza87LF6tPqR@;8!&xL38SS6wxlG z5quoy@8f6Pb+?taiX%07e(WylDWqkDl&nNJ54^=|o(9Z1mBK_L&qdZ(V3E3I?AyjoGOzHZ2@p8OA(! z@*FHbL}K<2=9E)6SNJKm^?d+%L(3u|e81`WDbz9HkLzL{MGCGB$qW#q#bc|8!2&<3 zi^@3;C6^gaDc@8H8QC}^hw=dR9YXn;D9HtSV|RN!r!OYS7X?a|PUc*J)h-DXr{KSJ zdpifYKg;yFqnzOvXgCL!TcP=l=^~;g)nv%gok*h99e(U!bY!N{^;aarJ~hb&_Z9`X zBgdxGS-;z=#)pW`ySjIz8dAXkHpUKUKaB$x*vR94B=qP6V7<|AI3PBAXd|mdxnS43csK;gd+MSmK?7T<|)<5)w_5boIOQs-OTp5ei z<53~yEvd@iReMeE+V5;-eMJM()hE{I{%+d{O=oadE!7%zSy@*xk*687_OpFs@`DcK zS-JBg?`>Zy_%Q6Zw^5>dYRVDVml|_aG_l+(6@V0s7`>X(Wz(Eeke=A3b}`Y{lAG6} zWvMCF=UpYaI@=G1H+4OE=!W!B^dH8Q(W0R(*CW715(r4ct&TUn9Q!!#n~GK%I2W@G z>)1ZJ5WnT%d4Tvb{6Hs|Une$2>1-Lnr%uqTz*SsY-$=8ON7paflnkiSv}R|n&l|hm z`H3&z-#R$V9H0HDJ)1PX|pBH%7UA_I!qhOBnHIm-1%o1H-tn z(2w`J){7Esxqz|I;gw(5`h_X)Pp2*jG(b7(UZfv&Ez`zptrff?0FlM+f@t>Yo^EJL z#in)4XCG^;FvV@v#f!xz0udwVJ4;&AHk3g^ko4-> zW$c7r`3%RqcuKNWNy3Zc6bdMt(PN;ELLrx(XPPH9qfXEHANQo?jfxGzW=j&{7DCue z2GzW;wZ8Doquo?Pa!E2#jQQAA&*xGBpKCMVzV%LI_ic!;C4`zr>}B3Pr~rOV>C#1_ z4TD*SH?U_114sYRS3(is>jhHHzgO%=ievfduPk%>-bE3=yk@X;u8=noca)Dn_M-ru zWD!|+$_4Q%1Uf;gX`je@&`$y@v$~swY`qe?Js1G|tuiGY1LrWt@P{lY5RZNsqdKPR zNe}XW(H1S3QV~nd;x5=*OJ|2I>RTDKY`=L+kZ6@Zw@!7r`1UITLOA}7Ju2B!*5J!q zWycR^t0ETt*(OfY;r1xk_F^XxQ$!3A)pkMY%^+&fG(u|paSS41@+6zZKdo*-e4n(^ z&uQ+Miy5&f#s!N+04IDiG_&<@k}jXTdEjRXp7%N*eyt~h^98(&R1?cY?`w*$?Werj z@wLBnoI9U+p4GyJ_KuAJkNK*L>Hl`)t##9>)mJDvhyiPf1TVi~EsFc1R94ky4Wk^5 z@>`VBvhB8O>+>Kdo-nmYKbf&q(7I79AZhZbe~>RIHWhPyX-k^jWxUf4^I-de>AL2G zWL6pTuOgQ1F)SR!31GjuF5+NK(7`^&9~nXY;wN5NhHEsKNXem%10olIfBphy;d+J5LyG6E5{eEF863Rl(;}?2DVWdY!jyG&R8x%Yi4+3ckiNkRp?Oy)^iCl)mjGj zNi+-TVJIbIT(%9BG!hzGW<*b=97+kJ48jTUpY}Ql9t=vBVPNW*VgL8a z6SR0*Wlj|`%eN7aqjKxi9+o_lu3w!-QT1gA!RVi(MM(E7lxt2nPMQd-{JJ~76(A*C z)+6euW4oA-V_V&oL$(K#KCQs&)!`YT5=70%M+G_k4w7#J%`(~4{>uG3ZvKKhI|aE+ z^I5OiI9FXRb2k>m=`z4ZQ40o8`ohS3q+x$3&{gOQ$-T9 z{>01U2T6=~IwdrL5LW;pYFp#X*q z3Kk~*+}AkG_E0^WT!(7vF)50ohXq`GB=QW-QNOWE0St35grPf19jsR!p_GPb+n#u8 zsr22T-6c|ucw4~lGtJ)ofOLF*@ap3WO=x<^?u+9ksN^;$qJ(VY`x&2EJjgyW3yL%) zO^^J`MbJ!5LH_$?uOfobHm{3eMpo|X5Z;st&!DsBDPS<5#F3OL7tBLpN?k+lF6%EX z{UKHm3`H*&CEGiEWS`Al9OwuO6oi-P<#dwY0V2L{AMLrg?~48}5uc)Vew{@ey<>c- zzF3M2hi>}0E?pyzslZ;Q*&!9a#9>Ya_&v^EaL%di6_acrCtuG-fAgxWUF;n0RoQ@A zH?9lY(eI3J*QRYV;+QDwoD0?me}*Ck#-YbFk!TU3(TS~ENaeo1H+}#KQMz=wdC$ig zpg;PhT1A0IAzCxMSfnd$Q(jLMu~J)$DN;d*%o#6|J=yrW)6xUJhA#n=GfdJ{V}-?A zURhc9<$Ek=ofl{$zNn9e>z^;RSW1EuDeQA7tVQk&nIJXLqVH^Rm~NHe?%A|C3pu0d z>Pmfi=P5Rzy+un|7jvU-DFK31kHjn>h|nmhIL4x6e01gd+p}&e zw_XQz3RdusVrv?FLHJ}Y?*!{#3tGPlRy;Jux=@Gwfa6 zn8WoU4|LytYMZU6&k`K}>tI=^uLYp|+>0_aBv#YXriG#z*9+2n~_%Gz9tt z1S(iZWl}tCv=7N+m#Tz6^u7zv>MqkOCu1nR(dySm9$(IlI-|Se7&>cDR-@5sh9Ch9 zi0Cb~4nKj~ghwX~$3?dY1zN+buV-eM!KlaZ~A<44I_8(IxZ!Q9n8wNov#K ze)c1mo4gR-(=IWbc28a5(b{3b(FH!lf+Up*I@~k;o7%9byQ^j3qE9fsonQou{3)n1 zfo!(bL;J{35KChs!A27PCflPYrZz{rJaN+WtjoK3j;%BVysOXHQHbbumVIY=3A=fH z_99hXd|u8Sj9I02a#x^=XanQQbO(k0Tn{|fK;cZ-VxO(hl_Jg^^?SFc<-rXVrbAVj z(eTj{xp+-YsDULMBwy{J5KXqzrrKICt|>hf(?u0-{gxITKJ%#RoGOT{*( zRZSwaMylN?@2Eb6Y1`3OHkHSLurTcW^HDxPDf{-p3CEh9vbD!!YP!XwqJpvM4S)fy(i>cCpijKW+l{j|!2k$GNuSLlHvS zb!I%8#s<|@6nmr?=gTWBH3G1<}sHbsix#L=yKbwIyBVAZZ46%^+E5X$Kof*SLf}T`T}? z!u`}n97?m`vC(Z7#G-I^TB-xv(US`k9IDBe^c(xB!y*fpFV(jsST4HFmBq%pFN0Ux zj?+`n5bVdrhVs%~uOrywjjSLJ9XBP^4SEstUbp>MD*p#gXT!jzAo+4_O!re)LHU44 zg-~x@0}a}Pv|ONkBsH;L+J+&WmIl{S3&kutG(=5sg+)tce{Vd>-@%f$H4h{bBxq|Rc_Tr#-Fi!D ziIJ+KVjkdr(Y8Wk)R0^eDh!fT9u|jRawN6SNHTxAWdH43+V7K9ubcG(7S;!M52u|o z{*bzvcz*zQ(Vo!d8GK(ogPnAcJx9q{rHeM{BSq*%mDzC>M2WLHSV2g%;P01eX6aS< zb}&-4L_v4yVCrsdI0E0q0^H{G1xur;uA)Et5O0DgT^qV$B(9oYGwc}w`8IRb%2dA( z32b7Dk_=6k^0$lu1XJ><7nq=WoC@xpsAL38Z?uv~JWvqs6FV z*ZZy%XWXZGDlS&qW&7CkUS|-V(JllAnld(yp3h|*Q8b`t76V+HcuSB9dux{d;!}JV zl$%V{alT}GP@%fykD`rz&G?6lHX?4^__Lo$sx`bCumNf#%IL_w@5h7BHRL~b1uU+# zbr&*bQm{YANb9cqRQfAk4D;sDdYbFQ0Z!uIk!8PQB|pAB5Av7q@eXTZV6V2Yn{4$W zz26YPcdi!frL!l@Xm;PQkx0a@OK@;N3 zIRv{=wd<4o31H@>%4&_n_vipBa&kdNcCt6pB)ZD{ilQ(++_a4K59b@||5X?pKOGp?t{k1F|A2LTiq^w*G#^Nrixm{AAzUwVRxU zL+ks@DOzbof?L9)XdD(E5g#UP;aGQW`v`nzqLXvSzTCn>a^$j$VhPQ7`pnlUsHN}5 zjl44SSDD3u{>-U((oKGavM)Qal4_ovMq2>Y&MVF0Za1kKAujB8_t(Ta{=#d7`w|2D zp7sRGJi91IpqwrQ_Tc$L2w=KsH^GWTpP!bc9;-sJlWd1#2&Nvvez_}C%K_mcYUyiy z^?J(PO)YjcZp0u~8ce8cB=YX#j5lxE5U6m0F z$i1B<$KNv$lRcItzIIy_(W_80?w@^cvQMI`S5_L~`&LbjCk5X8pZf1}1F4lG+r>+q zd7=$p0I6+SA=0$s(fjji)I<$odG+V!a_7HAw*MRlhY%7Y=^PY|qONe8ew=StZ55f_ z$$jqAm@$(KaLw#XN9dWul?|O9qsdI~v4DWayPZa_|KU7K5Bv8T$6R@blsDooV@3jZ zZQ(u_U7p4I^$4x>)I;m1NxMr>q40o<;8C5Ie^mlP62xE|hQgOymdk-7K`Jx%Vwo0X zih!4*#fs4-g&^67%vbjkzIO}pp%}GoxU7kz1rB1#k8M&3!lr2Gzf>Laed16Fl&}7n zl)F~n#tn>hd6hD0flPqxr1{4QHXLMVXfZd9u`9_*%-Q?OJOQs0qp7 zXLFL3sx9!T|KOhoS3*+%$o$(m-?mFBU~o9jO>Yf*gsSx@A9NI%gP8ufpWj)I^|IHd z7qfHMza6A{f1b=)Qlpx2vE8oPq+PUwoi?YY07s%8+dscHin41BKV z`)JQm>f)M-n$c7crjoBrzs|%vLQ0apDyOag%;`F)!H8sbv8O6dlZ3Lho29K7gJni? z#i=~PLTOpC;ma?A3PAuWOT<^#okr0Xm(L3QYkDKGsqs&45oXn&nPFliJNcNg#!S=R zV}XYWe>2y?(m#09IV_r;CIW#3UM5U5F6RjThDL91d>)QUy+u+cr8OgBR`LaHTyFW< zA2bD5{J(>f%a|&J@z0*Y?z3UOLHg(^q-aH+TA5w7;QboO>ZXVCYtTX#=fA7ZudU0g zI*Z!BySKbY&Ys%Gp-AD*H3EH#T~|93+Hd~;DM0F!$xBHC_Nm_91MU|i1$@{%=z~f; ziYcK*g3HM;nGMbQ(U@qJ^GE|`R{S$T&TrHpd>7TC5UaFSw!ucOeX5!_cx^q+bqcmoRIR>Owj`-O_TJ$Yg(LrgL^D<#$>LW@PTrGTX0J|*Rmx}*&(ZpNDjKU zqlxeCR+N)Xf9f*}eVE*5@iPdgIyuLw$b8;ehj!&0+XKkvP}_!dp6D`5_H7h3?o+Y1 zP$e^%E=Ntd_MpG^Km@IsP-O@@c!XL`@^w}w&-Bu5eLa8Wzua2nAlsf{R1q<2#jGD$ zhTYyrg9n|^ZM4bK;*L^01y6Joh0K}hBa0q6y3Ar<*-FZ5RA5{(bHPG@T??$AIjNIb z+nLz5ZJQHkVosb)Y}>}!^Sez+RBcsiH@7*v42O#i+7R~5jZZfW9T;S6A6|BoU+|NjQT%=kY+ zXam?8*#VqPYyb{c;B!b0E&vBJCveOJ;9zG1uyHT}*x8r?Y+RfG4mJ(|J2SBVZ_LO6 zU}a$euyC;fSeb!+P8L{JHg*6DD?5OVo#j7zY@A&G=>Orfu>ox{0vk|aYQQ zu`{s%*jd_1r+HdX*TD-(bVDEI$1W?)SJ8tZ@T|MT(x+hG5f z|G#=1?ElsM-zyss91a#%;QUzt9E^;>xibSX0Qv^bkAs8xKUlD`Fag+DnP54AG?EkQ31h8=a-v;}?b7BSF zbv7UltiU)}fd{9sF>(U20FF7C0jxm1e|WM0<754Y9}p*IE+zmc5Jxtke^#JPRxT!3 z)_;5;R;<9eu>f`1fcJ{^UmRRq|HT}LD=QFB7GNwaz&<2ZM*d^cG5_O=+ZdWV1K2rX|C6o4!uB2j zZ2%n*l>e}q7@2|a0_Al7o08&&ww5-Y0LuTQJ2Tb)5G`#?0l<)e$^Bm|@`kp+eEzQt zfI-T|(8khO$j%%nMaRTS&&Ud3_~Bw|s|Lj5|4sM*Z>7L8X#7vaY`}p3pS1tyBH}M39M-jRp39hW{)A z9sJK4_sEX^1*w9j^~5hLEgk0H57>Z52y}6GXJLik*ie?1;*gYfr`gzu3HE1|qcXGF)=v=g`OCf2GazYoUD$X zoTME^L!-u!U&{YlO`uv3M2y8S(9WeG3C0%;l}FABFF-ZPr(MPX9M~X$G=ll#@e0Zl zn3;jVv9LV(eGA0*03i;g#~=sM6!%A4#@G*+C4z5tcCTk-aSuGd+o}VxGR6Uk&&o>r ztUCb_!i^6KX(*r*T$&lfGXY%&zUAaM?W-}`|5!H`Iy`KE z%Oj%g4yVoHUlGCv4PYQ2INm=LMPh7b^Te{SxPT6wXr>iD3GWn?im1wS{jcQmQgD|=@hJyVPkRKibK8ls->0a6!_jerQ z-0JK_-^9w$+UONIETRcNsj?=dn?+K2|B4A2^|t5_{62(%`Qfg~!7hmZIVga`*ts+e zL1q0y(2pws$xIS?GuO?4$DfK6G5%Kw74&Vu`H96b7#JrPXHXYk9`~o{s373?VE;0V z0R(eXy_l~Kz7bT$=Qk1R-+lcE`G4T41OfgpJ6C>NE<|i*V681~et4gMvA;N$zBEIE zf7^j5K&b)z1444JK}^hcKpcd7Jigk0e+hrtFZ*et!_$414!yS(7S~W=HBR{*i`+iC zLxYf~^;QMGUh#;4KN}-~B;jEx{{etJ7~h;RHnHG}e1d-Y=?Cv41(qaAOP8 zN95OF7tdh(+eA;=`0>!<4biR(lEY%i4%!9B4N(1_G1)-xHWss5RCGg9r|$- z{heNhC1#9`A9!0cKZb6PmiNQI4+4c~xAV*WRbIoiyuYK@Snmu1kBfcpD?Ozz}k%n*w4Wx-iQ7 zh){jw2SZRC`(y9jUHT8T*l&*tj7R$Sd01_qhhKw(ADHbD;JCqb#r=J?OMo8~6pZ`# zHFAVGzbWKN>gV(1Q+sp#A{Ki~8~GnTt?Adc^qd)&PYrJ*kls+I{YVO67u=g4nHWmAsW=TL=+|Qh-!Ww`R{|yxxG&yCP0u={Pl|qvtT6sK+OL#h9X5M zH82nJ;{jkZwm7^9nAP*)MXmK-#LwUh(F4}}yZ{MbCAnXZg2caCo_oOpMD4ywp)T*w zLPTKCIrCDPBT64SKrxXCvQzRgE3SYwkItxIf zQLjMd*?&Trae;_Cg%3cwYz+dTbsnzp2=K3R1$2(!efrVC=`a-0EiN_8sM*bp5lk~k zm$2sis{scmK$pNe5?6TPRp8>V2toL%A-|2tC5B*Dq>sN8*o$V~Y_g*H66 zhTu23fbpKGqCoB+e}M_Eck%=yswTKY^7c4e2b!mO`p4JF{IU7bM^at;KmyNuhS?3 zm&3SWpnWz!H}T)!`d%cgA-v;rD7sOug*yTgiw!uDyu=y@4qm&Atsf|q^C!L!zi-&VAD8M6@-C4dDA+bCO6qN1qGU)f@3fcRQt9?<5PX5@Q zK`6PV1}g%O*czOBS($hde+u2> z9i~bKF8dXDuh?mqOtOq8-JdnL7`!vB*oGyZ8Q?p%hf|s0-ej5IOH7{OsHMkQJ!!-? z&K%K$zU1Lhcp|7{hb5dSRUtp+tp*5)k0k1!)uJ z;cDoDmDRE_AtHlQ^_6-G|H2kpq`2}pa$fq%kT_&)Zl)#0l!CV&^xLGMGPS(dkJU>$ z{bGp-cO?QJ)I6@l;LmbSD0h*rI#`b=hi2GU^6z1l#3g*{?nB-@5~h@xZRU-NredBi zQY8l=jDRX3)1mLqUp#vz>eowG|HZ$aTj*L_ORg^HULx9!l#9%zYI5Yk-|nZFOh9<8 zH>hn1-*l}mI*57OWz|GTRQ{?LrQJ8I96aE=#oGt}T795(AI=FV)v;HZFu`PCqdmAS zU$?1rA?klfTb^`?QhA@yZ#aN5=`iH)5yvQ7SvL%&L&WVPQ|dj{<0FmUcFe>dEJ%9# z4VxxTSX4`ay$JvFfxS@}4ZD4qWr;_Ry~j%^2EK?RC>m{G_;lbRy-Ux>f{M2bmz4(yv(R@SUaJk`VnEt?*hftM8=iJ{FH_G8@FKbY%94R@|NaQh)(r) z78MulOa_fQq}ia7sFV6_DMPWJ!jBWt{Cev!8h)R$a(j9?y6ux?V!?kQa`bgwgye|# zVjDfz#@g?me{ajZ8pV&HMTVOH7?64(`(mSTOd;v4_@u}tW!^=2Bh|NZ>)piZu=Z1i z!V8j`KV5Bj4V*B%J!L3VW#Sk~DU&1=QMAJ1tF1uB zK8}GIAcgb}pTZDjvUZXfapsd?wHCEGZ$oVKS(RTEBI|mA%wHq}*O) zZ_(R22l#v{d5ulrVf!LFSKX`37&#-}b#6-K6k*;?k-q5-<~MPNo#fPAj9m#CAHl?y z^{Fsr{t>ZOS!)gZo24f>T( z-AB*XSLyj+)8ZdbLE1gD73q}Tqu)AeYFhLu*kqC^5{bY1Oj)Vt9e;nRc3!76pcGgw-I?HVsEmHM5lM__3eIKu$F=5X{_7W(AJ!VF$Xm>x>|*+c{fmw) zO{S`p;ZNo4CB2QpPWg z+6s-lTEfhlI88B z?`CisB&Bc)q-ge6=&kgPJERV8r<@|icq^B-lT{VrNt(ETRr_oP9EthpFvm@^UfIkQ6_t-|n_n66MFE7m&{$tO|pdy5A>0{SiI$8try|eQ$9e96$jcXlR z2%9$+g|bO~O!8=&k7_j`ji)RYe?qv}>>KvCYfu(w8bZzfu$Oo3ocY*F-&%QZwQkHT zs2QXpN^w;|v5U&#t3X{p$7YpFBxf;MZ(P=-FU92~>N;O9>k8jx{6wWLDQ&cV;47jR#WHxhRXJK{soRk$0PdbPUqDa zrK@j*hLJHR)x;csV{8?iTY^zSBKpU|xxenQQ?>1_Uu-?kn|_%peA3G^Q*%})+z&d(994>Fm3xDKvjJj#Yz z<+O@8yg0Kw`%oMRR2Jp++n$8hAK-gYWGG_6?S_`F6`)09V@QgnA1zodzuJ z-IhNb{BAKVr3&=$U}*SYxCf#&14|V@R%`Z%W}jsB87_T`orjN+E&RZl=TO;|d!zWO zS8|QqRR+yPoEnLhJN3?|>=(*7vC361!?VAXOGdjh3QM zN8&vh4Z7)4>qK-6vG46<)=UUTgS+!b3Y_wS`X9ut-zA^QMY$SHOLYtx&9w*Y1W z{1XNb^Dzv^?My*VRwA3(ZZavQ#uJFG4kUY94hdO#G7<_T)-;*>OcFkV=8pWC82=quIvtV(_1=WvMI$oDot$;Q9 z!#cy3-)v9eP(MKYsb}4^t4w)Nck&%dgq?U;#_QU7Ul~0s2xgU_v}l}A zQy|%-T0_JBAlyWplp%1HcS7@RUA`hACHkE@QI@%($}Tdl%yoVox)T(QVs;ZQj7#Ib6SbO4%%OGT%?tNfY(Y+$FY-VbP?l9>UsvvR z(fwo;JjZK}pilpNT4lE4!|qJw*T8IA1+B}NdlZ#_KeYfx(c$7~-^HK+){$yI7XO{% zl6FMiy(N|iJs%%}G0djpV-Cj(07I7(} zX`sAlT>-@QHxrR zB9m9HGl6k((Qvl{bd3u6bp1ykr$N_R>lq_;mdSq7XI4|D(NPjncg4U+k1nh=30(39 zj1R-z4yh#@m{&x9w8isqXR-0p#zC}knM;>#JiTNzR&5`__MMNia40&ofCXzvSw=~1z&bR^uZgA>~M^k3F;+V|DSuEheyB=kH<#vDS8d^{1E~OgGmD0w2 z8(Xf*y!=C9{>*qBBe@EMR)(U|L0dNy?HoN|OHUyGZwDh>AQ>Ei67^Io6__H2Z;fBqAoEwZBnfz4* zWPsgMJsTgE$`VvpN3YX~6SGRYF2~#9=ml+(%}|u5MO5jzr^+C$F3J;woi+o}oLK3i zC8Dnn#UdC5wccyCgd*)+e?*%eV)HQTe?u{z2vu2?$&SxJivw;yZF%t6Jn1zJ<=0

o3x18xJ7H#gbt_%G-hkI_);TpR3Qb`Sa^7CFhZTVoM0EgR`zNt~~F|2ILyktJma*x;}-p+%IGr``exi zM-Z1*AukKc-@Ip?aqdb3VZ`{a||;k z9Iz|wy?pqDNP~8kA)9&zv&ZFYBV*inK(nRf62l&rKf~QI6#28{@2_E3XAcoQ$YBn7 zJ{zcq`z=Cap{_o_$#J1Y>9t!|ExpB5jH!}+y6bq9E5;P{u^a-G!n(Q%SJWnY%RgZP z?>0%5xbg^E^P+*m&q76o&e#L%r;pZ)x5YPYs8arVs-;=E+?!81l&dfs?$1c&?^<+u zUL?UF6BVfFRF#_|qhtk^-+WV`_?RYT+z+25G}CxQFf6i;aBz;JO&?U;MRz0wzIQ~= zQFoKXj3ANMt5ggtvUJHtUL-dS3YbDYv&cRAsP2?aE?=niSRkqAGG||jz9%;Otse6s zu%Z`c6#K2+jT<>r{NN%HA!)knrxA&MA17wm#;#HR^2`DGPCas0RicUfJN8kX=yq$DE_~{2rPT|fgyiKIZKykg7_jA*4%LSV=P1!l)exJ=# z)=gN8-BY@^Y!j-fSG=dO_P?&yA{ke0+u^tYkrg99q6r+s#MfRdT`ol7m(F06$iOHB z)?eq*^gdgm6aGk8$L$#tP_3b~5KKh6;I?HP(QPo2-0W!UNv{6DHQ>0B$Xqpp4E;DB z5E#glk!9$}(8ti-$V{=*qDvul-F9a!$o}Ll?({T<>XcvQXVwbxVkR@9JrEpD>2Hzd zA%Ui|3;OC3BKyXOJg8N;7J?_*Y`#&5XW2zAd}akkhdb%4x=A(dpVy5=9bbleZj_q$ zB2UCWh-*FBxhj0-(Qi?-;7W7J7h zQ20)5IhMwUd~XU-k+TekRVF=$l?!J|p@yNRUDEKzHdEzhUrQn#dmhF_%KHu8;-r{V ze2ryeh)0$;OvWjba{l)KvEFl#w7g69(PF*w7@4UC*j3p$d$kCYh!6AdqSVe+1CmA3gxKG!0eaq~BL%&e zSh`{rG@;5{Ym&rg8oy7oAH{gd+(wUY2`REVN@;smpekFBNum~s+9NJj2!Uq|5rn8e zJmVksU8ry9i=aHuH_nUtZJ=3_S54=Mo$bmg9kS~s7Hoc+hT&IyM7Pzh{#aLZciD#P zY3)H3Mw0Nf6U@CYiQ7_*il*EZv;)Pk~K`RPgL;=l4cI)rq@0|iN!d;CNj%6q=v4OMcg$}FrGt|Q zxMnm)gDyo-I;1D~g)xY1o$i6{VTT<} zef`_)=EEOOB0ll4^M!0Fx-jZp)Uteou)xi;_a663tFsqvBFlWAB2WvgHm(ozTP3j_ z2^X&xVt>n=%_y3SwB`7pRV)S3KI4eCAc?^3bZb#cux*A!qOxdSk&v>1TgR)Yd}=b^`{=$`HG}LWwGFAketCwk=}KIiH~Y@HZXf5L|0-P! zLaJ~HwId|WT?Aa|saNrUkGyqmY^k|bJoe6)AR%HLSM*j2@l!hYq7H~to0mN~%g$%A znXF5T4nZ_hGbUQ-U5D{F+&aLxy>faqt6%OXr{sK78JuT8{>UY{F?cOJh&hz;WBp6~ zzS`yTGD!?Czo>S4DKhGYeJWKV>D!k+nL0rg-h!BPmtr3ua%lP4N!O0iT;2G<@a$#3 zRZ-{3il&(6AjWI`AdiD_!rV)1j2Wt(>Br)5>3g%-#EOym3K$!*QMW2^ld0zK_Sp;AnQi7u9v;pzO4$6(DO+4zCdPl3d?Zoh6Gv>e6%K(KFPCS z${gG=T4abIm)I6dK>C(^sSIq@)(>3c;P$ zL*fD0$aeFn%I%6JDk`K3EbPrFCGHvMhZK>oPnQpz)8mCrJfTmy3N4!(%%F+t5;fEH z+Mnh2w&rah%J`(d_v%ISdwn|UKb{~W_@o=}5KS4(|4M<){gkW%Z&$+ZhM_HLo?F!} z@-M_KA1U0USODJ@p_*aBJrRCh;i$Zl+D#R{jtJ2;`FX^}r`M6(=W%xZb-j(FiK>w= z9+<%kGnl$3wancg(QLmMZC}byNdcfIvktM8o8>Su+Ho9t>oj~{0woXYRz#^#p14;x((KWbypCB9t^=Cz)V zvkH?9RWJx3*Pc8gj}}bQyUfH}TvR)}3#r=R*<&Ll$%N8-<_Kb6Nvz(lm5ND(OrrOW zr=~JDT=}+^`-oh)VD+jDyD%dZm#n_=Qen78D$2%J>$&tGsPq3F*{fhcCv24ika^kV zG8@>H5b(fBp07T}XiGnEibjvOWK!|nGkx7ud7E=Tms!)?1Un0Rn|#bbDKV8ft@~4E zta~vnVeb+=*qsJ7c#)ANRsEc57($B?!&6*7VDjmHnnL@uh-*EbfloS91n6H_`~C4Q z+02NXsG%b>8s9wQy?TNw5Ak1wwu}r77dmra}z((k$U6hWIbm7BN3qyCM zJ@HVj53$>d>&{*RwXS=(Os0@fnsD^I6#Ai+u^oI3QjlzC zR5iwK`#4vHxkF*fDBtu8EJWeYa8^d2C?!RWbJl_455uH>6faj#sGuG8f%V%&jqW#U zj1lf#PI~;zx~(%g^d9K>N4bqAedyAS%G;h1P6`oSC+Wo_&pNsFzkc6XncddX7NnKz z?mS;;712vNXpOaeRNU0L+P$vSxZ8SY3 zN;y(e33l4sdVk4$4J5zkvAw{**J>yyW&HGa??1_sL^cX65lQ}KMn|H z8os`Vi*rE`l?fCnLJ6*sneU(!o=VSHRHYTJlT-q}3qHdmKK*p90SoJAWFsZR8 z0C~#mvnQRpnO`bRd)zU%E$LK~Hx&8hI8B-Pn+amzweiDSz*}`c5mR&CUM6hRJbkD- zc-fV%n`!?EWRLiG&ZZMUv*V1u+4b&bx<7>aC&5>=O*=ot^6r(<; zMu@9~vmEhJdaGKn=Z+D8bJ%ca&ArO}M#jHE27fo8A6Ne(L5P}@41uJgtl=8JNHvE} zr7ZKoDOE+Fw`i%9KV%b!AIjUMUMCjNW%_OF3)dM|duggT04&E9TyV;0WcBxYz`eqc zP0#VB+c%IVs#}wczN!eXCO5t$yuUa9$LxqV(^2J$h1*?dz>!tz=-&dk`SOZ-NC7le z!Jx7k%3Er;DaBdQo<;-H7V;kBH-yZo5t)&~;0i={cW%LPBSIp95W9j)YQbMD#B8+6 zX5}zEGwDs{ztddxmnRu$2hrnRU6C7vI>hD*|gN^+^I7eF=NHzyKroZBMdeS>&% zOmnM*cGS#-u&Yxo$ z$r=+k>4pqHZqub!adeX2KKb3)TdT70r|pwQlVHl6#Oa%r$CjvnEx}w~xEnV{`8u{U zss`4nkX*~dykWxMO-j+{DYTEqif(}fvdV3QT+MC20dr0@rN$0|ANgso0i}5&0U_z6 zYgd7jRvkiu10qp7%l{HhEq11^4ZKNPd2rQ6amDI2tf)(GC0!RMbOn9y)vrOwP(uvg z5k_2^MR@?F4~29xdnAE&vYMf`$5U6Pc&s+K}~#mRT_ zW3tcbUlh(4CiTK2Ck66~&%rXvS!S&JD}z-OlYh$WU-(2G6bD5$iw#yxVsVx5Nt);P zF53H2B&`@mJ;K-VUHp!E_OV`Hf0~3pk})*mV4+JKgt%mx9kwti%w3IZ;zs6;+0>y6 zy!_}*qO;;pL$UrUkn4VOB~5W$qXlI8&Q z4@E|g%Z6@fl^wpzFXc=Hyx9Koks}0+I{f?D0ysSyxRJ*%Ncw1K*X^Q9y33|06@v3Q z%U=1KQM@2|pPT*-6IO?46u!Yp+4;%<&6iU(7X-I$Vh=y=WIzdxRFTI9#{M?!U+K{{ z-9J62{9UW~&z+9v8z=WO)f+06vqV}QPfgWap>Qrg+988zTnydtI=Zju-p1F5uafzV zH6?t-<#Msim`|n?dSV8&eD(Iyn^={DnC-4mlS5!!)kS_bgsun)7Op?txcDHfZSIQe zT^IjtGuE&;Uwhj2@F6AOk(k)v@>`&Nd>#&Xo>ltKzUDHSL#vzAVqMElXG;$K-N~!q61>ys#q)GnTVv{yx*D9bF`Y9GnVb>(IC9>A>nwm>$|vg(ctdA48Nmgpkc< z!@6A}8sr7|0MI`nz{fWXv;AI6Xudz!L`Wr<@<@ZEMz|>nJrJx%m6nZI3LBE3{Yvf| zGr>m!6oUfnhxIVapJje&(Rl3|G%6(6cMcJIjvhjiJUN}bWfkqe(7YZwMu8W# z{|%L1d>MYJfX>IVludfP#NzBj)Z;1Go7EL5l2xUNi=#hZa1F$w2c@hlm@h-;OkGYn zV@r5>h&{+>x{9R7nxwLzjaw|opfkw((o$@zEU}I;DmU;SUo(eP{cXDGwYrgGDVDDa zU5IMu7`QAl!XYwYn112xiiOOh{UR@NuZ(;NiHLyD-*al?`Awi7MHxz@k7d&Row{t@4?M7A81FKOU)jwe>GD$ftIbx#Z746n{6oOb7* z{)d)kU#35~G=`9~Du}BpcebH~N(}3I*Y?c8R6+qL0UQhD#w3LEkw zuC7d@t0=GevD^e#!*A@c>si1G`OTB~yU$>qe^u$x5lvzQPIH@9Oascz=!L5e3Lb3( znJkx+ayjw#CEcM|sOa;#82P?;rE(SSGM`HuoA*9^+0&s;Tfg@%{5f=cv02kAz9|3( z-!$dBKwAhXTC0M)7tf%*>_j=!A`fOC`Mg8LdB}`0qd`Dx7Abal=x~+KwClwq z3cHbU?GGh%!Xp#8&7`i+ z<^%id^pFm%tPZ%xT)cGX5fw0%m|UN&JP&r6czK( zq?|zxi8eMhmCDd<=MxOwr$gpq3~kfM(Rty}BC#BuvSL1CJ7#+#1veU8=-4hg(U!uc zeTRC&;n?Y#6-bPTF@(?&bA>&)0<;K7b^Y^7^4j!O;xFrKEpYdDH;+f+cPIF?K68X2;n zAFRDYTUEo!dDW{>>?V1d`c$+0ed_fp>89aG1iz%l{gM+vy^K@it(l;IyEv2%;^o1l zgT-$L!>kDD4KXm}&Fh0@-SCH|X~$Spoi(JLdYyxt)bs7MRVKt{1qFH_f@s;_l#9R6 zqiQCyaE*D4@{Pvxa^~9Zr%D4z$K)$uE*h-ippcIn|D%MVLJy$ zV!%-V=9YDR%tPe`*0sLw>dZO<0ZJXW-4rLbaE}{ibU2c@As1}BQ6+(pS*X~eFSb;x zeisQmG9bT&SphDvhYT8P^|e955s{X}&yoFx!~P*Dw&r#jRRFmsmjYuzF-p?!NnEW_ zP4eBCFEr-3*naip4DPP!5A03Ee$E{ne@hVvWCsV~i_txn`EN?Fw%!vB{+v0-)%wJ|)EGu5Bq$HPO`LTIkA_$GHsdnOAY;a&`0iN6tV zgZm~Ph#|@@s+YCxlLv+3db|kR&apA>tb!f~PTbeouD!NFbxlSgOHkET{r%`E`bxyj z8NDk)gP;E`-e)ioF83ilx1mtj%pyD@Kc{$8P+3zisc+p#Uh$ z+?FYEeVtL(z_P9(EpC9^Iqhg@Gf0r_bL%5_Ma%ZTGk|SB-LT3SB}`ojA?1ARCIh#o z)(`Z7GuiBqD$ldqA;YU2El&KM#D4gE>M>Bw{;qMY*O+o$W8E!I9d?sU?~BmVx!bdT zoI9)?HfL9^GBt0m{k>H&Tzj22>0MUu4@BD4c!9G`WK@Oe90K>9au7@#av_E|`FKI$ z?QW>Y{ZD+Vd)q$^We>hx3aMh6$M?0?mCo__8%k)H^Uk3{E0@oAOELEmYX+UxB(^tXdDv;jYPIcAF)YE?y<;z7iaW?s)UGz_#y zmM>?mZAC7x*(Md!VOaoQ{1}1s#=;t?u?r%`3L%cPDrERB%PRbl)vu3}-U?w?+gq?% zj7XvcM~C7X-?^SD2PP)_4Xi;ZQ=6W@gD*B?;1vb$r~OY(b><;VIo=t>%`UwyWJ{wf zwx(ak%VTx)J>*ZPGCCf7SS%f%9XU<}uoE@Q0}r(pP=5ifsP$Z2r{$V~g{q@mqLl;2 zbkvFoXy?xF_)urs?DJ2yb|Y$-*DkVWn6?%Vzw9+CoyKl28o-gP5?F)hJsT@3F>{PeTGPEK$FXjLn{{cxa&YR z9q>qTU2*ytH+YwBkgrMT#>W;-0V`@1$s@gMAcUPB-_5?}`U2$>sF-m$eO|)>g~6QQ zk8|IBL0{Y8P~~B)7qmX&m_w|I@`6Hj@Zd$iC~h9YnYXUn#MD%@AgIQEZP((7lc6on zH0_S3=sy1{nfKJ!2Eh$|tZrcU8EHDq;T4y9z@A%b3V!IfB8kNGUK@UWI0O?Q?tX-P zKCx;FO{?1Bb+is^jdJLn){tiF@s>e2sB`x1jC9+{_0l~x?k(%xRf_vAq^7@SWo=ch zx#JpxQ$s|Sq_0$fiGfW+?nSoeT<0R2V}7JOA4Vv#|K5eWgFg@UdKg7R`%CtFw%z!( z`B?Hy`psn`bf30~Ya~zSE1|*zKQtqH&GnGqma*F5L6TJV!FX#L#MQO(bxmUE{Yw)h zW0T=B#Ad?g1&{AyZCICf$90u)(=XsLW;*!6AqP{47nCSTW@9RHy@4)#y`5iLRl;hs z1g8RF=#qcrI8qIO#Xw}BF$Q-Xn_M!dXn)#u%Uu?%j$C5Lm}ToMRCt^0ZBGRKa^({p z&*sDAf=Nltpm1@-9oLu|!g`lC6%v1?SkPuAu}nWK#D`TiU2=vh_bjAz6yr7JQD0ei z-?FBh$ar#mS3DWz7es&+?;{C1Q)qWDKqP5Mz;A>_mY~4`^J1Q))_L*bccD^~`psk! zkTFb$W>*8ouUc|zjP#^MiC%)%5NFouS3Y|2Dt5CwA5!^U&_$%i0Ni@j=DUzoqFV)X zSQ$gH6R}{}uMMfP9B=V?qgIDY|95cjX7Q@u)8`6H7jjpN4?ZwCT63lBn>o_btz*Sj z(LYP>PCx5s$Rai+>udrl@94{fzo87`KVj>9?wc$f&LY^{=9a5;5e=*e)Z9&%Vgcyj zjqjt0TT4GJJxfHG$r-fNGFh}#CGb~gOYvNwSUTfst*`MSh#b;VYYv+vB;RbXb(J~Y zCGZbM^fFv%53ypO7Vy_9C}%0lF;G~)hl*ZNFr z^+g+__x+vhkf~If{)?~>kFnDINfxLtk8-;%oV>A}xQ^pFxiR5zo`HB?04y*^a4UL~ zNoK3x1A{^2vleHk#f^WWKIzGEFY zY6bS{Sgq-AU^Jx*o2uUm>Yv_UQ?SH#D%&joRx}Tw(R+8cs@(O8I9nJCK)IthrBm>TaVvf_BvI-*F@*ta6LWFg`GQ? zL@ZkCu*CY!G2H^`-a5)~M-XB;l`rmdL55EtE9_u^U9+9;xggx~0p-#7lEckqRV*a% z2h+;6y|smOz^&43PON7EHOp zwve2K+oMF1oBX54#^rTbebPXJ9OTJ8!t`gMJraY6sq?ax$}x70Ih|vTU*CB3d+Gd{ zJxIv?-Td&d} zT8-1e$c0Fnc!U_`JMRaNAQ zoyQraG=v<6F$psRZ^AyTnF?IkfXA?)ELbeyqdy> z0JEs8rMAV4@?@Uf)E-IX%d1mFLtbCFJOKla%%!=A_8V7|bFaVn6cc8@vB}vcM@i!p z)q3LN)HL+pK%Uoy;;luo$JDNleZp~?jemCzz^`ciKL9pB$-hKeq2SVI*^KHX2@;!* zom4do-FnTs*Hk0h#+Z!6H#h9XElbIGXI!~yzmz}$X}-GlrR^K~jL&q5V%<53iDZDy zO+fBn?7YG1XQ@XKL4$!!rzEHx-(iE%(@aJKbaiI?g60fz#RU*AY@K4&PyDtuNT)=m zM@s2fC&^j+yNdIM`jYnxF`boc(wHJ@T)c7-h5YQ{!8co>$Vueqp+Nq@TnoT+EGeG6 ztIHSg;wNF6-fAsdZNEX%StraIww|j(kc=KU zr?!ZGbvy2|yI#ipl`BWBs#C9EGm%MDQ2NIO-N-w^1eaUaq_>JKOEa3bvu?k2Jfi!g zY!@deQEg6KISyW(YQS4tTijY9b<%8&UE^B{*%^GG3AtxXbW2~T(j&0|L5Yp~F%T;> zoX%z13#^LicfVCQNiIky4hrPfy4nOlxAK=sf?;`vhzqHuzvi)-Y_+{pL{Cfol5YuC zm`_giZ`7x2U79ZWw9M9ixp%&DC}oV1b=3P6MMI94zj0~i>I6!*ZtU&vb0490eif9m zdoGHWlED~ll9)5U{ug9vT#4-E-HxWea}}Wp5*=sU*QHIQ-NkM*!M0Ktr))j&z{$z(t$*oy$y7MAY@W@@446_a9H>R>?<4e2Y ztRR#m{es5h=z&};Q>*rf_SSd3k;KiTjrcnuk{gE_dt>Cd8h7Wv%wFFn>B9wYU=Frm z^xVE1jLNtBJb52E(uN9i%b={^kAoocKBGcZb)>XT{I|g_4N7i=P&CKhHP(k3XugzP3Dcy%&=skBx@{yP*i5`WznFJDLF*!L$I zGh1EB?S7={^@-cofhPSxdLe&3Vd^3@O$i=+zyOf}!eh@4+!EFmtf_eSj{cJn6B-Kax5v5 zsntqaR}K3(p7Cq?hAo~k9+5YW--gfO-|R|+ydMEP*Ua*)X5#5FW06-x$@w7-qXH0A zcBRcTV5;ZFtRd_|GLIVzJ<)rOd^_1-voo}%BQ^Q0{rUGItRS0jXv~59A$OlWvvL~4 z4a5Vd-JnRkQ)7L-=nKE%bSAmE;m0s8lGlnUGuBvO6Dylcb}jmjy!BWPN`*l)MGEU` zRz(i)5wlJ>3iDIy*!kL$nF@eY!A;bDZW(<|M2i@w`1PpUX5@0H{X;3?0+ywicxFZG z>^RBYfDDTbvk5H+#of1k%boU};cxDl8hzQ)0)47>$J&Tya;KDPPOqE6saxm&4-`P_ zzcfknPb%1c?>Hej#^9EqD1gZ9X3d~U z20MBhlPA1svvKv&A@jgFOV^BRD(>F~h&uD=mh3Oe?7aC7qe}XaTEgP}+Aj0z9#D5f zUj1x(hJz^VWQTwjui^vai?As!OHYzE@#_Ie?%vILIgl2FQREHLFY6uTq(=WKZORsc z4q8|dZJnTBU*XI#y5Hk={y@&&_rnvz?`|&4zp<6Z4{D&_x z^$5AdZ0hM8@&N@$q9y0Fwfhh$!Efk_PE1XX2Cm%bqr6sO%(PsZOhbejlq=s))VL_w znMJjpi>6bJJhdLQzkj1)C$Qs7dt$%>K+ML!pvwI#n{Ab=>rP}A4D`!!Qz4n&<~-Iq z(xn}BgJzY zcpzgOA4_&CVI~IYj=2@5s{okUtrK2-bNl}Onrb5kMBjCt$IA)^9b?gSZonZ6=KF;U zHR5jCBhrY?J*{OD@J;j2Esd*>?etJ?yHts=i0Y&2nJfq+jErGEHVo@H3r6-NunTTg zZAPD==N=Bo)}x~<@1W?*XIYjVP4S<%iRrT8Qg(_{HO*O2nM z^5@8w&CpuD_@9NLWQ#az@Q8Ch+FSzBW*t^5=w)3*;xl+@ZNN7lU|nAch+(n#Q^L6FZ8wk!>@QDp0I|TEFD;+)Hu-fd zfPV3}iMOc*%D+^Gz4_27#JnBp`>E^6n1{k{f(4g<*zk%e0klAy1+K1T;D( zY|1D4G-*+s_WoZ6iD%xYG1oGZzJ`^hTZM1HNA&|N<(UAoJUpL(EPks!m<-mlkoe2E zkN~QJ8~?pA%l>5&;Y?;N=f+w$pWFKWMh1WQCwlgJ883_88J+)UNOu?>R7;RKhO3Q3 zXo{gnqUVH*a0VRziZ_82%nr-}7b^po`o!mDA}FEM!Rammze_&@H&qA#u#R zj)AbbgGbc%`m#XIvuequ6X#r^@3MleobiK!5$gC<=62$zLpGBZ9}>W&)Pw&C=0pz) z$!W%Ej}|N0yCxHIQ*cD8NTKNZMGnF>wb@{E>Q|GLM~@bF-{ua0;)Trxr#1Iy*9Tj` z87@AH-OtGnrQm3Xq9C z<=&a2-gvUBKh2uc=Ci8|><*@5>YEt#h!2e(9Yx}m!L?`LFp=0DUhzqoZ`O&vU^)o( z`fZ+{R04t@>u+G&=O`54hIYCk)=ySK>vhZpCK%4n;Vh66o*i_Uf^bb(Tj1QQ{lRE3 zj$F)areL(KQ2-!p5VhzY$c=l_^Ak*%-8g@qL3vJuKDjIrbX3_EgeRP>W^AXXbB32u zfjaV(%f>Dmlt4{#yc5-_*Yli$<{8=#tKAv;3!e<|%SkDdTmsK{1x<-g-#~2=pZJU) z@_skOdpDLP%%u+Bjq^~o9ohz&{v!ffTtM)0?R__)NF=|}OQRC^i zGLj|ug#!i!$%I4q-6^|89V4mKF3te`go&?@*Th;|I;|=$@4Qutf@A@?OHb8ancql? zn!(O8pb9GMGEvFHU?05T1YD04b(q0DO~Q&}wf>$v7lJqs$?(r9Dybs{Nk%hQdo3q$^DdQxUq5<3^TYmA`MsLyHwzr}Q-url+DJM@(I*}nT zzUpIKUkx?Tx?AY|m||jQqB=~XMl5OaKLK>9@xQTjwH0Eu*{xO|46#+hdTC35?jW4T zZ+11Iw~U2$XVmS^0E2rQ)RdgUimAFF7M|}#68rAP_dLJghbj3fFB`^ovM&IjyrGtPk8EI6O@z*M z`&-c@QlNJKGZqX1I2mBd0{cH(xv38{^`DXn^sNoWJU=lfFCKZ6k(r>*r%E`|6MMMkio_BP(Q^TYP za_{QqlAS{oMg?E+_-=hH-CnB@uy>%6YB~eDFoxZXIPg&0aQJT<@dr%~krp7Kd<}zkrgxObj-h+58=1P2$>Kbx3!R%%i@?&ya(n2tkGud zj)%tD*zxmnMt5^Z{QS2WNrqp6%bhMRKkWQvdhyEnc<41URd> zNpMSPLZGuc)fteYoBzVCqwNti^m$&|VQg7B$FStdIyE@H22v}@yI#SB9l{Zoa%XDL3oIrbwPu4m@1@yb0)Z0aA zTOnpY))$zF`Ait8G6NtRgi5N{4IP?eHB7uuqo~>0RPndMb==^lYnRmovpHEd1MgI4 z{iN{p{~}W6yz+a4&w=*xu+5LgSlI{Q%zPmFKbo!WoC6MY>zNSv`A`xtHoR?@+ zQJc)R4Z6jpl!x}^fqttW^_8(7JUn<+Xonb_I@I%GGqiXPbo#letFw(9{fg`!w{u=v z=U0Bw2ktNuokk8C8!vY>-9FIEXw|nD-x@wrr)ttG_yxdqHF=9z+@zx5Ga>c6^xjjJ z)0c+lAnLs`t`XtCTVBAy-M~JrGa74{sIM2ADQp@Pi+eO7g7a&lIYi_Sf$trPoi_;- z7l_hjjyiD9I67AY;zqgH%0xNJOaYEzYRpWPmw2uZ!_yW4eO9gc`HN__?xh4fL^R+9 zD{uD!cL2U!jw&C6gPe3JrI!Jz;9uiQj+>a-S#3;jR#v1N&y;>> zDR!h5!#b#KOwIoyi#p-N^Q5Pt&)v} zOTMC-;$XV4&xoZHJdo6+C6|cAKU{-ZC~$C@#cq*V_0a5mGzvYQj-C#A7cEsMkeS+& zsgOVS8|USL-4`QwqG#R zd5vBHa=zD<)MKQ11~KDcs%^R+>WX0Pm1dS!M(-tY5}8h}p0vs8d{ANF+p%s@&p5rP zsr}F^NEl`}JKL(MNeTeYCjO$2n8);N`l6aMrXHZk>p=rN3-G>=u8q`yI~XrRlT3xD zp|Y<%HOO_8b#m zJp!Od1)=gMm!`wl@7}7!GuOaG%!+#a3LH3}s=rHhE)M|mv?=d~YoAhu-`uBn&U5rp z+0TW0t;M_BlE(xrf=d$UJVO3Y0yQ(LP^m%1n&${ykxK{%kVMsKCI z3dEoz*KM3%$tPOGt0I13`_?C|`fkP2hqd}nvXbJq3arBaCK4tLmg@#276wj;pahu# z|EkjO;=y#$w?WQuq)-QY3kIjT_~3^9&XAYm-zR(gSAZXyBYPWD69vFAH#6Qb5xA7_{?Ib?TGHCJ2qPkB#cF1EJ7td>S3 zq9GTx@971Qq1ZSxa%|4-O=#nLed&e?)=S`b%D%lLe^JYxz}7o1sg%;my8Kbnk1AoGs)yE%cRUmuR} z(~?@>HSizeskaZ`I~ggs97oadY~DRHknp|{d(R9VXy`h70W|(WOPMsVu0SCgI0beb zQNkhlcnSIcLWKjXM57mx}MedY~_n`#oI%NJ9RiVMRe#CX9*%o)b8RA`Me=-7s1r0$; z2yo#&`fpVIl2{`FxopEvz06WKPlp0W1=T#pOJv4}WZU9KNZ(4ynyZ(H}^ z7b7wVJ~078<@midU5!g{kw0t#FIoAF$jf(Vq32-&#^oNIQgfz|X2809(6 z4*|VQ+#1VGhrlC;CY(+%Z0;I;K!MtZw=D4vTdi|KWV59yj&noF9#g)fb#=oJgSXyd zI)uRLnCOUlS%Qf1U|j2T0`fP1u3W68(I0l>YVQYfED#=K*4jb%f5m5-uJh|CjEa!R zg_0zeWSP=lqWGMvi|S*iYO%|JCT!SO;S+(>abFjwrES2Jm<1Y#{}T=4bBy!-w0nQN zC}lYpr>PcOka-RVbO)Gj3p&e551Y`01DpG4vm!h6ln0hdQC22Ao41Lz~125jni2nhSa(KiWG#o-*6^9-NI@&f$zxAl)=V{h=d-!}LJWlg38FadB z^iuCBF`!nXeaIZlrevCH+^=9jBasO0qc3Tl${A({_MONj#2bq`j2s@82x z9P@VfSu6NTN$F#3TXl1(sE?iNNdSG%gj44Z)&R(IYbxGZ!nf_B$<7?0`e8D>!>82u}2hB2Z~Zc&nPoy)Io^ zo)4f*1vv{lYS%C|r8HVht9ReU=hXJ~`E0@W7GZ8v&Za9~n z)ZW2Rx7~g2d~=sajHEthY*)5kKQU8h!aY=2v_cTgt0Et}4uLGWhg4x2jHT}+GZCD9 zeAl@M3I^#*YmI2)fLT>jH(r0(u7_`NR|aq6#W4tfZ;kl{soNl+dCXmWLI&;4c&yDLi5JTm_Pv%zhuBC;$7ceYTRrNtb_T@3TXj zVrmTXs49ioJzW*Z3(!khj&V?4mR7N|Cvv-K4^)WE1kmI(tR-q-QD#=l!a~=#2b20X zmr@J+simkk9jmjDy&ZeIuFbJ5ZW(r}e@ z1(N6iY=vI7r?a+Ryz?yQU9MA}Z=L$taf@JNb75t)%9bu59GFKjb?AO|z#(%cREvEk zY}ei0nD}Rs)6qdAcCaO6EQ2%j)_tIdg4g0;hS8C5%y96>pgen+ntXCtzgLKgOVW%C zo70l#lQ))ie1SLM2ETXbXdtN%Qc*n`A>0N#jzTjOAg7<6%~`rsZ{}COA^(* zl$Y4565;*z*8kO67j~hZAyM^`Fd6p5GW|6{2wromb_mw$G=&U$8Myv=N}z$&2VFAQ zlagc>Qj{wc1hL4OIt$n?Y7^(23m{_`^CbhWQbJ)ho4+}apKvJQN^Y8)5tEHLh9Q_?sZ~6H0Aa3rkXm907Ukjd7VVLT4)u>QPVUnNG`H(Ux0C~J z;%NV=g2A)auR=nqE^okQw|yj}w?iu*(GY!$Z%fwZIkqQJZJvW+`GpZDJ1cdNmPMQh ziLO1N$Bvk**Za!$eZFk3E-mZ47))t#3ubr~f;<~k>}dKL(X{mP(Z-43+7j4QzbLfM zIIjJi{4UXtLyR7!H&DdX6mj?YZrc;p^(CANlV8w`i%0?BMVZ}c4MqjiH!0TEnb#%T zMhJV8UQ67JRuvtv1*Q0kb(ZL~M*svOc1u)HvkxJjvpX4Q|Kce=!~^n`obxGkS|_E@ zRu5qFhnRk!X>OW5Dnpa6_N627$1(?jW^w1Sj4Or+&^8iJzN?@6nX;Y6?jEOUj(a_O zI_b3qc?D$HzQ@6(v{pDrlkUNF3{2!31FLsy8r@gW+AT2&jpdrb;#Diyhb~=vU3QnH z$(FMwmNI&3!GF&_Gh&okoZ)ZDhX?CPQJjp&hy0lqIRE)z&|z1lvP47WCxDbcS*dPU znH{ID>dxSEYcoAxpwm}F&z#;CKM|)^b;^jvp+Qe9vOW0oM15D!{Fg+%%LTxq*-+|8 zR3t_n>jZvt`r;6c+7-7ardgHtxx0&(P;_K#6VBbPLj53b3S2X+&>;Rf$`(ijb7K3 zyPCiQ_8$G>-VE%xw0KQ&x2;V)-nU-u0!ikbywGMjk6DKVdd{GXJ@Vv`n3pPrcHsn5 zSu>1wkFfkhkn2_k;Z%#@UE$l!wDR}7Oa_G99gH$d4K&{&$`=r9zX|9}mdEG4Y7@mG zVEPt#WyQ29#`cK|>~7Sj>41IcQ)AyAi0wS^$uHm7R+15*yGTwK(DH*FKV)i)zrdwK zYZv+fjzBK@p^yl+o%<{GaCS!0~9a-L5co5 zf36>+*a2C^?g`&}#au9sPhOyHa5UhBhiA|A=lN3CGZ>G zk{eTr8+1hjpY0#D?j~ew?LrAwAa+DGpVUV!aIr4t&k{tbR~sxo9@95h^kR|HSes6N|0chmoD=5Q_Ksx&_dNG@{RlWQMi=a^HMQU zPGcs=-y`67IcLgI)w1@U6Y zi*p~?z|D@=`vCgZ9d08IFq+00lR+TIwu=XOYNCqAy0MiOzfvzIDm0Faly!)lneyt! zK*4WVJZ#!=9*lFGll&SB(f-lJi&wmQjv?4niCdV3l9L%9p9QwgaDjjf`)u^Kl9J6n zPPoUaYy=T6pwjl)=GuZ(WY5M@v=IiFh-QC1BgH1030MmJcKn&S7SM85Pk=n!wv09A zXt7f~ihVo}#u*+T5GT;_F3vOYw;rR%$A?szllIlZYP<$Pq`i9z_l}9MP*K+$P$!}{*!)Uq+9oz{=36jzSc=W`$ zc57hFbD)<-gM|u-P3OkLyxvjcwhRP&umqh};B6ZLjm$!EiE17wtTBO3lIYap12$-a zglzhuIs=HWi0f7~VrHS!JU)67<6Hc)Aa_~cH@rbR&{75m!d|J&u*>p4-LF`OL9%d$ zY9J(gNzOqDzse@@@1Xlb;~CQ9Wxzhl_gKL%Xmcp{FqM{03A5`$)rq^sQBjhITpN9^R6q#-A6l3acVMlI(kgd1uVpQbaEc;&`TXtcA&XLS%S-`1Uwrahjt@=YBr7{(jK?tCbJZ zp6{dKGN$5TWg>yeRkxTv1onnc3_i`S7yZg83q>roa`&ihW$x8_4$?ZHc0U5b1c1?WW`KRove?;3hz!Y0O&Y@y6WUj$(6qK;9@hdY}6UcjW zMlHnElxU$cB5oX|mthd-Y?ZD9uLdi!ZM1=5$pWX-Nazj?KNL%a(hi$QCHYZ$412Va$Rl|+u*y*FA~BNownv2_=slYy4>_rBx57J%Fc6K-YL5*M{rp|1Mj?KF zRC6Gl`H1=1Z3(H|?lhLK%n*59+RV$7JnshOA*bZ*uu|fx6r48@o84zves^u0SCQQRHk~+=>aTdQgJ+0a|>)Oqx1PeC5FO7cqUN1@k z1(ztSvs7E91}>fFFJ;ICLpbTB_^wR^|4~H+pe#+jLxD!^2tgisMBMH&Kk!;7K}gEw zQj%KrlS|;*D-5>fU*cOv6bt`#5AXTDh}GoVVAcT`^w`0m-Z>S@__22)LWsL$sQ|R6CE(&md4uK{9Ge{bX5H(*&iQ zyN{S{O@E^T9h=dOg0h(VSq77L=1Z{C36wX(>mm{^WfM|&K(cAV8ZuAxwWa_Xfr0kD zb15Cps3YfFLf{8z4NDXg>ko$B~#m+E>QVU!~kTyXY#8yRwcvrk2yOf&M zqQt$&6sGZUX=J-=poy%xkLh~yFjIQLv%M;VI>P5d;COK?FGYdf z_Vy9(a^G}_plyr_61}UG57oN{?$N)d_W>lMYPIV#o{z40f42;|xAKmo`L*i6TX7E8 zE61CRs@Du^G#Vp&I$C~~sNA^U1t;pAdLyE*ar>{S3> z4f#ZqsVkj0M*o*6@OS`BU#FxJt&)uC$GaW++U&O-s>!ot^svkpNTqAnAi0tRecX0b z51!Q8oMKVn!MXGe%0GoxM*?KbN<3_V@(-E0QlC?$IeKsWcf_rpq;0VAb{SvD;|xO$IIu47S>}PQ@oe=!v`3*-J9kLjLTGmivE}>h}>e_QI zf%CXIVX$Yu8v6vne@u9LeC`~FysdyL3d{!SOXWYEZ$Oubmbg8`R`&tV?04W?8A>o9 zxHcSIE5L$?9BqyM!!Dt#F~RY)LZXfrtI2S2${+JVVU!|5?#2ov%4*Mnp2%_t4G) zW<=G1l+}Ls%fRyiUo;d z&uR-tt~3(n=q_F!!U^S5yCPf-MU1|UO%7YD59_yk0u7hzd4huL`ta1-SDM9RHif+a zTHn@5;5HlB|K(yAGWCu7w#+{}_EF^XsxyoE)X^7|yjfW>vg|3zYI1qt&nz8S6%vaa z72_nQZNnbHw6_lfGN4}Dz5)5H7f-R+7AJd?G-JAMTA8k0`WLj z2a-~xUcW8!3Zz81;*Dd7q&fC^(@9)FEK8V!yV_R+m3`?s#|4(nGL390Sx=C*f!cbR zT$qF_EtQfxIQ*b9TYUImnEJ+K|0v|ZzDBbS7h6F0(BSKFojN3gYq=0V*SN)57NLW< zW8}ni4;tF6WH@--fXXNzQ7Oin_N&@w-OE=4>7+EwCw^Xc7HMyG>_HPus9BYv;!(JU zrtb_6#^dqekD!z`sgB@ zTpEe@j}r?L0*@k6@=lwoh)i~UA(KmLWm$5{o%wR51LIc~y?WH7UyiD{wd&5N(}}xJ zn{~gSIT4-|vlTi^(4fmx-g+!oD;hx|{@Oa_kDRNUF@VL7q}YI>((QkbFdwln_AyTu zerAIkIcdet0Bzv&p>?Dg5V69c&Ip#mEi}+73!yWqEW!J6g-OP(vkf!l1?UZ^ZO$G@G_Gcs)mKh6{z|JfzL5b+3#;EZvNl(wxx|ayNSeEbfIkTYMzIa3 zD^9-7VZYD$&p%SC1hApXEm`2lfGDb%@r4>k^@=!~ourO$4xrcLYHk*dpXZBOMep;`QGG5*(|L(Z#xpynmDh54m6h(6jAb|BBWNR5mWl7(rGXMO zaITOsx<9b^e$K*Wu&5sd%3+YVyFVi0>bn`yCu;=|*sJ&JHBU(Tm8M9o=9bzPrf|`AVCygr{D{(u1}Xd?q-Esv^>dV?}eNZxTD?% zoPFhUImdyd3EwZ@9(u;!o7%erf3?CO5YZ75zypZ9&kP|su?oKG$|lAN-{27??!I@{ z23G14InElx1zU+VeHI zsal&IxC8jm5wKgm9LtlgKUTE9N#0U26_wjB#9+RM(6*$=9#B&lqp`Fc(*B1@!v<iLgNx^$-Q;&S<#d8tUyUR9Lbeu{$dm_f5L@_X{WVGs>8M}xOoj8elXEZh*>-}Q|U zSMT7;rUWwkg$o5p`VttO)a9h6VmW5NPg+bw&uw+>L}U!jK^eN*can?*mUz93$^pF@ z7ji7w`J2t<`v5Z93H)Oism+d67W(?0P|p&XKVwIJyAugf7>$F8uzu3+l~J^mog7!^ z4`p_uvS|#G21wjCqYNOCnTyuJza{z*!Yt6^!hYTOJvdHL{vu%)!CUiYQR zORu@qZ{32nnv{yUfBYd>^S(id`9#RuGjVLOX5=fwXjyQesF#`AQk0&d$FjP-%0VTp*DB&r31g2uh=~ zRN9(!+-~1o+7$PV(DD!4UKP3$vZCUe=@%t_W3s-h_N`*;5IM{Kt~eJ^{9wVt0RKV{ z7*>7iSq_&$t9uoa$h#+BI*}x1%NO=T_muxx^G8pDHA&PBX~wTlX~JMvOBZpZe#5ih zofYkHSX4HDw&>Hh2zi_eI$-kTQS4QN6_Yq4SaG^RM%XI!+zs!|twYx?HylC?Hv{YF zlsfeLbjv}d%80QQe(^?+lfAmo0a;&P^ceR8g*_W8Lm#_)_NJ*GV8AraN&I%_6}$WV z0D8p|j^y}r7VWBwHjo2;O^wCi_}E_6Gu-5*X0~f?%uG6FM#?|DP)b?M`b_ZRsMj?Y z)$kJKM(-CBZEmc)i;#FKsp^>4O2I%GqEBM&)O4X02Q z!rr93ia%Ijmf6?jif|bvh@KWGU|iI!Q8wGz8WUigf_jO-+#gD7SIMJfdb0fZR&jCb z(Hm7z3H_O|3+8M1CDL16V!n*5ZYcz`gRM9wdm%jiG*c(ksrZwisXfoo;(TOQ1zBX) zxj;~Dxmnp_5q1?|w3HfI;S$ac7>gkf*+un%P%;Mxl#nv`XHFbFy)0fCWw72g#hEcs zFqMz|8L1~3j)RHriMa0Jwzc^#JXg8c6*)&zwpdR;IfZ3P9H7!2#aoPRpWuKyCfF&* zZ!qglKZ_V1UVWnzxDc>Am9C)DjcN}hd_0^IP_r-V)fNoF-5tt{X{yS`-TGPQed z?RV$Nb;^Aksf`wH{FZ`}jv*hHmVDv)zxDsM8&XyfV!_e{w*`4EtoqDa4H0gPw8U*b z_717Dk{%J0q?FAHD^Kv&ORrceGW?}drZ%tsdq75rUx4Fs?6>Xa$5ngDto_}H8R~IO~Jf9}*X>;%1Ns93~Q1+Xtl{t=c@%Kpps1yBuUecbTlns7T*rcnM>{IGNow z{lo{V60GP}&JKnYbhH9SSHzcCk(C|)aSe45`mVOR);`1YU_t*?79cxo zELy+o0GUeU0E85e@n}DI3|8Bqo*UsO5idk&#;r80a41{O)rOaGbn!m{EVej8)Bm8W zOxx_4!45N_@m(CRerdUB7k}wZ6d0Q@YEP}xbt1fzK*M#)B9?~yXaL7p??eB_cat~9 zC_^*XI~l2Yu_!fo8UWE)l^*wD6P;N*xvd*%G=1y^17Nq`_GVK-ZSQe3JvYjs|1`g) zd(ai2%bSElgXKw(=m+*DNwaSCK+YmpE7C5X=wZgXOD4lPv+Ba4f`xNr3nEa;4Ch0d zi}3oPDyUgxt!`_)U_PLg+)uQO@OS@XkcLVdj%+%>_#!-0Mx>D7&-qeF+@mrBdkj|o z)(ryLX8pImoN^?Z+ZiEq+z-f>Jf6!pIQI|Je^Mq(qNo)F3GG-HdKM^i3pUGuf)@!NP$LrGnr<6K2U1ddW~I;? zq3PSci#`)rk!tGNAhi_H4Lo>YH)6KI_q#_>{e=~2lF%8{Sqk_QcWsec6U3MF8KSf+ zbi1rhc5aO%^}1-6I`~&HutNRrM)Xx$R%_=;L(O?YUVHorw0=)QL<6)3s`yBNWdLAm z|J`3KvL46R%7Oomo8hTdfUMJZ7@wNRa|M97=3us`#mpH{|Kq@$%=bM(9#qAe@b^1!?;p9UNu?@77VU;ei} za_)Xk!PPaNp5=R+Ze6e%rb2j=w>a=qZwh)3qkU}R+HnkIcja%a6lxi?{ow%0WWu2wcx)Dqvm$>iwV3x6!U z6_*IGO^VmaX#U@Yk>PPl-nKZ~M%>GJRg5+hk>cfgr(F;Xa!z6)NaAVeg-vh{$eXXg z+zb|~g{A@>zUnQUIO7c)Klmz&eJ*mY!NQ`WEE*;3ea7yx5bbV}nuGzJHl28R3^1TS zJjzHIc(kWPJTA595?FLV%Bxz`Zmy&%(a2+izk?_jt`7Kf$j>U{U9WB$;R!TIfLhn4 z6Icyx-5WD&FeHaNfNrgHm_SpF{F@kNixsDD8G^R;i{vhwG%tpp`7Q7Gk7IAENe(j; zbzCDpjU+Sw0z(-1afCJ;NS^)nxPh>x#=|6X;x>&z4`xGah>%6tk zmiSFg@#qo_g?|ad`82PoBkE3$JEYf&$pQVN2ajcMWzkcESPZ#t7}ouO^3n?%#p%Mx zot#OYyn=!WM_)B&%ONz;ZIydOIaJs~$aQ7zMmct8Jp5u)3gLbZ{$+8-E$^gA_n*9> zdp7Rr=?oW2`_T>~88-Q;%<1*|p zBcaQ%e+8)PoNFWPbl51lkK9TRUfUA#-n%v$aPN0Rz{Ro0aKGCJs8q)Yg9umIBzpzU zi4!$~Xl}Uo8y4?_Ox)IHR=hR4=ESxx|vSzY0obFiuJ7Hf3qou5r!=N z(5+$)YVQZ-0ofzyXSNmqcMdGnL&FP^RKxR<3)Rh+U+I6yl_-hgNbV@L+jO5B0lHZk zn!ySOX5wI5AP6d~-DV|7@YuCfiI3&_=X%lax8Xw1Ef-X5j+O&EPpK}H=ti^Wm-u%B z^>u8I;P;%2<-wOhC=oUPTz0Gt>osZn$>~M%ytN`t1O@^^c&>!vj^R$2!IAd^1btSvvP+ulczCCp zq$Pet%B8$GgN-;g?HdK8CaelGf#)z*TcKQGI#H_*IhYVD$5}_4@iSrp>bFQye8(FQ zYzaOswU*7z#1F(ypi!ROuFJ^5A5wn5J;%^UR26aJdQv}E2~L#^mb0mpM&lgT7i(!R z3D_z`FTSn+xLiOJ#-*57ey@>%c2a1n0*%PUvme%==%~bxYR7ow;)RIC$eVI$TKKM_ zzjv44wJX`Fha^$Ty&7=^cK}48w zs}+9)XRV=WjeXg&WJ!a=awdhU5ms_~AAF%XUBx4K2t8Ur#BpI>L6bJQLasru{0{(k zpuijZKESb_!6^CDYEjr$HwDBM)*Ge|6L5~3Uie`&2o9{HIeU|N=IaKOWeZR%3qoBo zq_pXg5x4rbu^5ujA3|HiS#u)xQ*D&LIFOK7UG8t*vTyqAdT$-{c=pJPkEp#)PrO=?WcHM z(w!vx3ifw4J$}~FjnSNSTcIV2IUcngNFm(=AzDPFJv5<<35fy%sVjiXY4G+;m%qsJ zVgKIg4_cua@|Oy390AsQ%4IsgZSte-dN9exOBUgUL^xZO7H-WpwEz8c_ub7j-yX-m z&ng)Pj-Lud_{x19IElyH=6a4x%CA9c;Xf&5qqi$V6yCcj8aBm+6x#5U{XVP8CZh=z z<^rgV-z+O{i+d^UYE80JY;_Z#(Q)~Vhqq#|mm{o|F2K3D2n?^i{M2U5LmU2F?SAMi zg}Q=VB4zvhR9nU>#`Zp%r6!ugj4DM)qGP=0q1m=p%l+@mD7cZ1rYC2|+%zABU2XadQo7D9Q6Q4OwR_5pzg z08~*SV$@3rVgwGVIKFvDn9Lm;M!oj^!rHlfo{1Ig;LzLHCyzqy$_ud}6}A7Z2lO;1 zmaQcUibJ2Rt^eW2JL^LArmz7zK2jy%H-6JHz|5+U_A|V6LPDf$m#0+B!`adF*vc~V z`E|nwAecdB^BS*MFy0r=as_L2htJ||QtO`mm%bwiv<2oq&N3OskB|9w{*h{>58;EH z*xsPE3HIRmt`aM!j{)0Vk8?Kz$bKp>h`$msAOE1w* zR=2N7wSMy%ek^y^ZQf@fHzONJSlR=o%u^8TqC-f}|H{W7vEv&2kZCoyi?%?wF;Huw zBCss(t-j2SF8o1b@;UcJqL7Eg7rkLVob$z$g9I?Zy#lsH#5v zn|~ZR^8;m?8(N~HYpSR^85>H$?>???k3=U)x1t7yzw?i9j6~+GjTfj&B4;`V1z{D` z^$c`PXqW&e6E!-qnwu%qHix5t{;!)IM{phjxG@P!;_y0)79mcc2rn9OwjzCd&viFB zV%LkaF^d5G%vFi{+nFAddDtH0fV44DCpC=1DudB76^u0JO<|T5r9o(=KVfH^sy9S1 zhbSE+>J3@8IVu^pBvbx!0~O8ma`Y#zXgw^ao>m}Ldg5$T({tWweB;D1AIn$W6QShH z$+}Ev)3Rd%DJOqT{9EnYR1j)eDP+w4Jp4#!h|^~5!jp%?MPx>df;Icu15mMClYecP zV)ZRAk0YTV`)_RDA0^|b9@s)BWECba{`^9oO8SayU5eO)1D2COVTOx@^=>j#TUohZ zqi?*Yu4C!Gl4-5~vM!qUr@47q?L#vruAQdqk37DluCU_cdrkMJMuEF*>{6no@3&V0 zB~F>IO-NqGoODeUawt1DZY`?5hi=F`P{ynzwDzF2xdf1T+fs_;rksc@x1NCgbzKq< zu&t{SYa<^1YK1}<{}HZ=73Wl}Si^zf^4m1BNq!~2lqRtsBknPTk-rQ;D^?w8zk!>_#`%8WOD(VlA`7)qTzykuV9l~_ zlF7ujZQHhO+qP}n6WbHpwrx*r<7WQ-?|aWZ54Bczb#>L(wQ9XIs%sxb_kx&P8Hpyh zP-9+*QA$3}s@z%SC-N(BFtGD3j-x%)&1h|$-v_wDhgdBH(8GfC1LyOns{oB#*#~ti zW4UtKcIW5-fE&1xaY}}zxD#txB{()vgWKr0W`Gs4WQ*?!dnr0ATfxqwqG!;>=ErdHDJQj zAmC0}xWC5^j;9#w_FbpDR?ptZD&-4CHR7D{oAYlgrdv)K6C((urDnI|)bQ|EewuErA%4;R({~yXY%2J=cccBbTWoJYZxI;+Q!F%e@*An+^#li|cT`!H zkZ$LxY&llBIuec)Pm9i`Isv*J&KtL0ak6@Yp9aY>t=( zGI>OGMVFN%*iS_*->uw-GEaVJe7C)nv^ zh{-UwcX}Vy!;~EQ5y6<|nJ=z{2{CicO#e-|dSq9U;}9NQ6lPvLKc2@aeo@I@3De zc2igq(D(z)E6xMq^#PV$fNv{KGBq={XxPBGZM-6ka0MZVevtT*smiN6L6v9KI00(V z@`ZlU8@ju}PwT3}?`VeK@C%hB)D?;hOcB!l@{_IcC6uQRX3!&M4=ORZC6+7+J9hQi zag^=6joBETl|%S_wt@x%btO_-Tqw9s{XmOrJ}r?K4PEwW*0OXey8G&1ZNsRNao`c= zGjFpGy-9skW@Tc+c#h~wChC>?J|4|>*MFLcdyG7f9I_F+w4t1_M;GPYe<_Z-=XR!oJlr3S(7Fu;=qL#}J#;(+)qw+$ZT= zDqIxqnKQ-oU64UK`xk>*^vP$%68(m6i%wl=C6JEFK(N(bMh2*ce*KNL!k;&*b5FB{ z1VAdrE1ORFp&@m;k_|4*eI3^oZj$4J*uXu)*LuwKhG1IR>!z}*JvF?VsKJn&4YtqV z;qI*pngsGFa{cpwCKX%x!S}PBT=50bZ?m|e46qEZ)5DMWZ{1Pfd)^pchh7n%ATLpm0vZiuw z#PB^ex*>GfQg6a@rK(&O)6xyW=e;WaRISD(xNP=K|7wcA^a>Ke$%{$t6v@Z@!2tg! z7293K(8d=6<}18Hfq!L)j<5ZBh7jhoMW@a3t_rTm?}lAeBY|6Tol7@Zw~MAc!Mudf8~9x_h~0<_gjwYyWlD)huc2N zt@F;^&SnaTRT3TYOmhx1~2cB1Dzm$s@l@1}z6!umB>Vgt6fw7Xou*#;ihQ zJ?1FfMhU{Ly{S7fGWdw`vNwxjS^THK+Rdg&xgDJ!AMbmaR3kHxNm(beByPG9XSwyz z+`7=&uZ^bqBfl+2`{+_b2d-{W`7l}NEtxLP^aE@@xs9{4MLV>cRvlz*5do0jLUjYQ z6XUURjdulytzKu~eEMxulfNJVHl^PrMDe}lCkXn|{VwR}+HU598EvG#?{b79fy1)$ z@^SMrj|pK+BH360zE>r2At|bdi~5|lQaf1_k-WrFxI#JTe3B}K;Nrrg70`Dy7O}N)!lMbffa&Q(b>Ss-Od<~R_Xgm|DV@?y5iBQnj1NpIpQ(U{nL?$=l_CW z`WJ*I9t#6A9vdSg9xE#=9t%4Y9t#T#9xF2)9_zQYzr6qXW@cl=V`gUlhyM2YOAOyK zjC9Np%ye{k|C|2mVPazXhyPzae`VO|81U%n=>KE%uY$kyx8YmiKZ^bf=pW^5YMm!caIy@HUZwIh3 z{o@Qq7J3NgfARix7(4yHPWsmKSN0zrj4b~+=AVK7)%Q*GbPV6d{;jak)Bgqk52(K& z{(}84sDFTed-fl1{rmp*>OV4nJ^okjpZd4HzvaIU`sV*2bqe`Ay1(a`uiGXJ8d71XyAGd4FhbNU|9cW2ta zLHW0ln&EG&h?TynBOVjPKk+IcVC#mbiAT*u_n+494($IZ(f&_Ris)OLTe;(r2}&!_ z(~2|L-S( zpjG=9>E99lkBI-P{lCARh`E)MvBN*Wos5Ny4Q-9Stw|Z%m^zu^F*4FIu>H42kH^Ho z#`@nH!}lj(r=$B`TmDCs@mu4!fq#E*x2&k$}?yhneaCuuojpbMym38OOLXF@Te+w`cLQE-=f?!~jyxk?u#J7WdZ* z5MRIT;pyqf_{90;<&=@Zao@p?6}i|rfE{SN2A~o@4c_rGo?}noFn};3=ZvqGp+G)x zsiwd7r=hB2t(`NgJqREkh-NMN$kxxgzR4}D11P^N7`eoFP%`#_^DjpAPhLbc0AF1g zfDzz#)AnvvUMt|HFU#NI>FI&L3c@={SGExJ0GoaSCJ`N`YjJC#1CTr(!6HgqX=CA? zN$X_#SxZadBYqm#0L3B61E%qDy{~hlGMd&FR6r&|t~~Y%AB9@uEmP^+(j4iTg4Ve@ z^9y+3k-@ltr1R5kCBE?5S{h#M*j#hUmlHA>chG?{1^@U;{ItM;L)HS zpaqCUMMb5>Wd#t22ymcpGWcHG*;Yb$Qp3L!h`tw4(_9cp*aNipa|G22Fu)7Xy*;f1 z1W@bOCSTWSKiHeWpD%lF$FIIzUp33V>dDeQ zzV#k;1yP;BKm3k)5Ad5Gn|}ZtE&GZBPj3GafPCHu1E|mcK@`UikTKk{Y`UvQANc;` z^DE}FJLO%M{;PKUOLgT7mQb8kbG>`W{4?Xad!NKbPjkB4ln-ci5;*}00w!*u_A94V zBloMY4rm1H+~kS3pP`y0?jG)UbHm4#F;H4BO@bb5Tr0!M;>0O0{r!{Qkl^ELzy<#p z49yN`Cm@{w&gFJsToz-!e^>d1K>gHT;O&9Z7JE`;VRi!CPQb(+!{)!3?FCiT zxM_C%`BFu}!d*;=IpYoyW8e}{P-5W(X7@(D!1y88MMpmAUPkGLfA}!K=$l;vltI$S zP9MAun|+uCT{k%Sh<*A}!IhJk#Fe^tP=l#6A|8`Y{T3L>;0VmFGzh+KWTbyHL*xG5^s8kF6#70apP1@L*9^?Q&Tlljuyi;JW#4l!dI@(5Ba0W*5Exk%9=TWm-lrk7 zcf*Z)`2-$xt^Dc;h#6EHnORV9CrI^a7$g@0oKh9OSpY7uHagjh47~e<3;1jbEU>vX zId#u3K!v+$@^*HK&%?o+fp?G1KNTl%XT&@JipUwZc$ioEZg}|e*1#JZK!#sWSh%se z9zd0?=I^Wd#f-j}9zNcWLc7sGM>an?)b?yg7OmgeeB%LQyuQOuMEMwmn0`1cI)fG zkk`kWfZ4_+W{w(W+t=}Mp^hB#Uw&qdJ+fV!1wHHCip3)C1&j~|%%FM;!JQh!g7s;> z!}GK8hOnRpRU8lo$R&9Q!FkMm^Tm(g`A0^02*6NVMS*t-zQXXdkZ|CGBKHUb?BqQb zxWG^kzxnyM-+U$9Z~od}zON7*4aRq8;X8Q#7BlYe&KG}$?#No;Xxd^=XnPsx>j7Io z;{~`XV^=?p0lv4meooM2hjsvRX11=XuLR)i$A|9I+6Ujq$R=im-d$aMZD8&V7_Qy$ zWzl^jCY{Jm0uMtylHCym=JAI$zXKLv)8z4oD^~fAh241|;Jn8|s9HX@RW5%x1=%t1 z!hU_9B%vL_hdN&%{7S5BJ}}B*(rbL=zlG!PLTt`=VVM-JZ|nj*sMg~HSU|0nw=4}# z1?O8|@-ZTq{^0{K4_RmDiz4<9o(0ml&2B5${1X#f^SyHuQ_H=_pmo7;ho9>iyza4~ z48|}Z{1On);j*xcr@j=>*ZhWBSke>ORK7E*zRWbRKzF8RKwfbvyqTywfwk`y-he!% zT{nP@wK6YuTO-|WeG5s+s*Hs1yY*o=LH-Pf8qKrc94&w1b0=Uo1; zQ_q%_FDoyc!V`1LJ3J9t%}h}C*McW^xkBEI98me!?aO2Stk2j-&}ZI{=|F{#?-K>M z2dC38V9&YgzD;~Rpu4ZCu)tn%HQ(XB6BzW-4hh6Vw)!;-0*K2rd0=ikbSp{->^0Nq z>nzX%D(yK30f<{D^@rT#E5`)v8Bg~MvjFz?L6qxjwluSqUC;w|x!XsPU*S*pbB*o< zUL5EMl)1}TZxrpwtE1e$aS>P^=l*M458GkelBkBrmHIJBv!zmy&{{-;pYX9`{6Lq> zeXBBf2IDSnVe?k|!y;H7^p$eg$73sfgd(=~R|pehz&v+WGv#ejbLECl6bX8(( zaW}LSw^JmQaY`a4Yq0eqt;7&o0dxNS2P7$3z4Sck zjZSYn0|MckK8{DObk?s}Llc0WyXMT4adt+bMVtA57xoWV zlGUZKqvA|G5{uCp+09H-l5y|SUn3Y1jU%zXtm`Dg(S%`(D3cNn zhTzuu+L+9oVzBW!C95khyL})GSaTmS`3M~`i`<%C&%~Qt{KbU~sf+MYHo5YC?@?y< zbSGcjLk|S4rpbTEOkmi*9}&6IGHsULQcwFRoh8Ag*tOkWQ$6YNoglk>BR9lzsj7wE zi0ybENaN<{F{d@H`{PD@|C|iQ-@~7_-mK95e5a6pqGE%cZjMq*z$nGbOA4COdTS9= zHo2WekTFppLpO=mSCsHT-OcoC-Az8i>lLkn{~UZ-&IPHPN5Y9|pfbnA)2)@s;9?X& zAn)zYl|z}VyAKS+EAMv+JC`_#;O2X>_Mi9>N`vFnMvlfAcaqkn^pnFK#yASId1FV% z3rG7Qiv?~=a{&)4aDj`B2HP}Be)N^5ZL*gDDxca^TNQFnA=mY7`-xt%3`?4M z6xc-P?|eZRC{!NosmbHaN7eWSfEgXFQHn@i9++8>3fWy1ntsh_51qdbe+hjZQqN(9 zlh6+P5qAAyUO$%HImf-oa6*fE;#|-2QhrjLb_VRjb#JX`AayU5 z=s#fudeArkSH~#G=?ZFVI>x1TjG9@_>uGv%9?oJy~Kv(xlhD=PkZ;N49Xk{SX6oABzjei36$6-CIT5#fDX{`^FeK{OSzH_S=e*^`;| zB`Xz)xHVmT7OU5C2hiG7R$j)n&ua;laeLZe;em%D^yFv{Z{Yz82WpgHK9yV?S89Q1 zyVPY#S2K3Kz#DgX2~t^(BGOHTo*pUz$^d9cG^qC~?8z%s9U+6TRQFCXjt=N5i;ko6 zkN}Tev}+E^TRLEfEE?H+Qgm{*qa$xiQ!XOHxJ1t5f%(RY)Y%6Tw3|+eu=<*4@%`hY zCR@grqyuJs#~a(W+tN>UITM|WxAN6!yFa$rPJ>^-XB3<@V;}~@p?7+{#YguQ^)*;5 zzYN;_%SKAF=jM&U|M_C?E1soCI$L8b;LnYv?~IG)-g>^RRYYqCFV*)lFB4Vt$^_6gx@X8 zircHU-KXfb;_4k;otfbHvT{SrC5m){2QLzy?vVQ-NeU@tx-G`*xU)8az~ z&`F)fmvuXL{jH^6sF?Be8je{kQdaCW%Kv<_!}8U6eo*3MmZsq{Y`VSUswqTimL?N9 zgKiF0F{hBzU2N5lcwyE^cUv@ zD2?SEd0>21Jkq zc9#PCv~|Cg?FHn|%dr+I!JmrbX_7}iPSap!)fZ1xQp$@Z>mS#vr!%f6tjq8^ekwQ= zsf?`a-OtMTSrp{g`K^jGqUWbL$CmNRWbU;(49gGkAI1u3sJ=5B>RqzKcgF0zri)?| z$C<-5>R2JLNY(jSv<^C;dDSy`q1M>_ElZjEC2Kg!-Qh6>RC7Znovj?q6MC_f*$3B$ zQKqZ&rjn`ObWGR)U z9FZto?sUk%YB|`jxMpO<1FJVysB)eawtOFyjyL6HVQ1f=7W;+{!AUa1ymM9P(Ch|1tx zD!8;yi(M$CrJBZf&A1)^*;3af*4RXkggra|@NAQB)<)Bx_0;M>Y#bz(cfMA{m83v$ z3>V(RA`XQ$77F80sNNXgHvd$PW%}BFxuE*?h;S7?^gb*O{YPmNJ!rA=y#r0xr|X(E z0(k9ftD!@O!4b~3+(N2|W_2RVHaJ|*ya*P3HD&<))}wyWidt?oV?nvB!h!aIt6Jsr zmYZ|CgG#V$12aQb0cTN)lnBRMImavlrh-m2vBbT#AebYZX5Cl1#^yY+kq`BEJUKms zyyy@ILUBj^Sn|V(90mB68;Qi!S0^QxasNsBCW}8pHbQwBvHCII)#mcW`KbcDk*{U? z`=S_pwQ}Y_vgZPAtF(cZT8y~m_5FOoJB8Nst!5kT?>8DXgeOcF4KwphL%_;#_M()V z0y?2c3GtU%&^_llUBRbgVRs0h{YY5g z?o1ZYP{+wdEMr}Sj$}k=SIUlainFM0j9%r7!*Zr!n*?(Vhur37WdMpkQzP{~$)H7CmPJ}8c(+;jnyCw2U& z+I=a+4lP zr36U{$pe*3Xr1YG4vKLyBa>C`966fu+fn%ChXqs_6LJ~(6@fTik1EbbmOHMN++eUM zDt9Ts>DIL-1-y5x7Rus+q}gaNOPVukdE{7VSoJ%%fcUAmYguWvLu1j_nwKIhW@`&l z*X|FXw;}oUv3^y={?O-TuedYF3jVcv1GDsSYZ2BcyX3t@G|PoZ;UazJ4R3`0{3tb8 zr3#I8dt03n>%yw$2&+OJ=}MU==j@~8lJV+HepU)FQzi4RWhLaYv3Aryet++uzE;4< z_E7htos@(vt|JG&(%MOAR;n%4!RlR4E+bIP=E@dhs#zx5td>i88K@gN_V&F4ASG_i zkR{mxb555lGflifKP-kYIvLAbb(^9qegUF6dZ+Fv%v zZbU;{$odzWis$Aj^>OAr=UILwY%Rj_c$&M}?c9Swf~pp2TeqqgnGj$fj4fJbyV|-< zqUG-f`QaM`@$G1%qk4n(0Xu7o?@J;` z=5@O&JL);J!L;l*lc2B;6d0!_+=dFo)ut~@(H@A5IymV~xaU(3!g>zSfLKg3fF8rh zU{q#U28xdGH(h1RXW>s zF}`LqAy*RR3bSBk`gJ^5JfzE*w~3AOAOko#0hZ;E0Gwb~Qz_3g_AVt1HoX|ob)jhZa^*fX+oy98eYd@O0Hv`-~4eUIy4AQ%~(bnr0R zBgK!-#H6d!IAceuCCWY<)}_18w6uhEbq+4`nETsZBm%?*ZhR~DLG(KzgyF0GNKFZG zDynYr=u$_HXLX50gnQ&{4cki~b=iR>wC zav1^5Yv4I(rvZY2V?zvZE<`qs!2@a^7zWhumL5r|>)~hI`=pwLrwUV71KHD(z>4Lq z$#q<*(>B(@ahb-@cCyOcKS5~T%L$-XpyHWh!lw+>5fLZFiNM{zzE?}j72xnOv8e0A4~b93 zt%bkF_-26MrD9IbgP>kiFo>Iw7*(RP^^@}VlQ(WAM`i7cJUtRSRCH^cKTR-0_Xw@7 zC%gdWtqIaAen?2ZvnOt)ZdoL~sC&k>%Ed#XO6`i0OIBKCM`JYEwVOMr|=t=&{ zp$_Uj-stNvK-0=gez8>5PYc*=uQ4>%j`pE2{;*V9H;uk7C< z8|9ZWbUbY|e|V2!qF4h2`!{C^rcbn}bcd2GBeDVbLY&O0CQio? zJ2$w`QeVot-P&$;Z1c)}sQEMfiB*i^eefm~QJCuW0Gv<>GE^z51!!di3gy1coF({2 zRPBeqa+WF^R6eN6l3{CM-?d(K8P%Y_<5Izk_u70aZ#7X$H7fXsz4FyY?$QT^YN^g9 z4rA-8H7V(HCXGi4j9AbZk-oPvp?}#2-=`Lcj+1}cT>uQNy}nop{Qjh?#YVy+EAs?e zins_e#SHSjHMY?HT?>a^HA-q3tSLE~oLT1+xP4U7oSFky22M*oK|0}nj(F-5m# zVDF|PY=(5)+jK{I;(v78%?~D@uy)w zZd6Vd%yUxC%bCgH=zd^~(*~Vw9ubd5Wlu;oHXsM?6JgiWmxC4Z&xyBwL@V?_E_&y5 zgd?f4e&2m|SN6j>rI8q-_~k*!yI^vWFNa}Q*9k^g)mA)Fuu#lmE6xG-8sq?^1%V>w zxZRnAJ=m&*@!Ak!Z1_QjKoQ!@Os4GfQNpGgMN*hR2ByoF-$SMfuPTFBfP3nDXXCv# z`Ql5RK%@kDxz%aR3-VMvJFSP}26c&iVSBzQd~>d!zlZ_-FH(|I8cvcWR1F-=$mtt-8U8$o_36bgX-vSLb%4G|>Y}Y2=!UDH*UaibhD6Mn*#zpU z<8)eY#*Q6-u`k+U`%RQ~?kldDUdV|(k44SkrPVZT?RuB;eGfzlK10$}^H=MOfNP#m z8`*p8qAq~bj%+a%#`_J+kn?)yO480qz*zg+aUr0NBC7~mc5SkwIx%0WWxCDl`}=1O z*6|$93<}wk0AkGtzH3HpBH8t*2LHZA$ARh{yxg!NJY#;Hh~>y8K#GfX{^N3(c(?Lc zLIn*E8Ay}&Ozy(M6*az$jv%Dt!3~T$+Y~WlG;d|%a{NSd2n7}m9*JqR-3@hng9UA~ z*2!iqZL3@qt%Dl*kdGI`pXQg&pX747w`#}yY$}?81^reAMG_38;hFhNE0y%tN5agC zRl+5Dv%M&@c(+o~6u$M-4!d^|K<2(Ry-EAAAxt3kkd*F{+*@kfPE-Agm@#_!&b!gw zW`Y$jzWe|YCn)h~i6H5ZT3tPM7_Duabt^?YV>R<2Oa32H-06Gx%$5rQduQrarOv#Va@s5h0lt zDM~I%!8b%QinQsCWw_P7W~l6K5~X&#_F1CfNo2=Z(waj|S6@>&XOlXq=Ytb(hx93Z zs(-fL$CpL z(O+onD%Ub_Z%l_%VI@1z$rRA|{83%NN5>~zd`khT$?M|_ud>CgA*)B^tmqZ8_!0EF zftB3jS2hh@6KqN;qyutKX(L=zgR{05IQ`~Y)PLGA%(m@WMZnpWD&um_8A?-3$4=kj#Dr+u;_Fi8LmluZ8x>icr}WO<(27n6M9I`MnF_D8Q*2Sjbo9I< zMyzr6G(Q;gqg8vhGGbFYnmFhQvE$QOfytFBWShX8+bbDAErFErx#R=2t60rT;I^Uy z%|wE9GK07A%4@viSad<7gIg&J?=?ZFEYTxaM~xoJm+=?S=!Z00eKu<@(=|jMs)mmt zZ!|lk_Z}D|pd_jxT?F`Kmzv(=H9#o4=?v9N{@UzYu?qrx)!qy@u5@Ar@nWHyPplhb!_vA z%w~>@UZ5AG1Rt2-h*vAnWs%P7lVhw{Hxw(1wokz*s} z4YNGUpIvl>g19@(ZW`cpZ8OSNJ(WBp%=bd=WfWgROhOmY<9cI!-yji9q= zs+D3ATA@fQGHv@`!PAzVT1UbJDt*<$%asWX=h%A;(MzriVZ*9W%^PjVQ7eAeN?!a< z`bo1!UambzU;go$Y^KjOt^ZN!v--y z{JNU~PqjX-kb{T=FAno!YODOm4ivc+>f#}m%vaDOB-vY&BZ#>aLN!@dIKqgo=%ejw*7|; z;%knYBdWt=cF9CTaCyJ1XJQ0D9mJnS6jC1=*2Wk*H|5%P6;FH~-3t=GWpQ^TSoJo2 z;qwX#`=5?bU?kNyM@zc}#+Z6Jaj^UB0(K=_G+uq*of>G4U~@!8gK zxUK=1-)xOtmbjy$dNB_2psptke_3LyQPZq!O@+})*-c8kZ>tNRq&&F%p3qsW#Bo)Q z{6j@y*}qi;BxaFNXw??0+Y+)v^~sxaVFzCt=1E${XmLpaHgzGV_*_j!(R!7+&^#b_ z{C+-m?#HU)5_DsDDy9pBi}*M{+GK{mr^GM~*jig(`#6H4d2YS!zC7Sn!Acg41d zWWz0-hPOq?d~>6j4MAg*{nAi-A-XYc-XRRLai23d|u#zLwILx2=5m`}+?hm5X>(P^F&XwxcFHhEH z^OLhN%YvjC(s%Ji9Yz)g&*R}rzsrzqnpj)5VGw42tnzlW9=DIi4HOBtFp+=h`U!Ri@k!sUufRf+Dh$SFEn84+a?(&2VgK`$QbjXKwGx~=nE^;QZ>FhI|0H+ z?Rm-1Aq8|@^EYsLyJ01Lu0i)*~kjSKQ3z&boH326y=lS`%FjgnnhV%;C|kBSzq7o9dFFcFrz zQY%2Rl#r>gUoGEr0GsO4w~|On!C-5`eC{9-o?9d6ldedYMHf-khpC9E60W{of}Mv9 zVj_aBGN;JIUX+rXc9ag>NEz?|#B@+8xv=2lv|At*Zb4bMhqcG~U+_2EgGt_K$vK50 z@;u0iNS56;-u;~GjC$<6W7HWn25W5@(+5>5E69K|~mmW9=ZlOV+F*9os!)Gp(Ej0^KLxwu_)e zi5k^9OdW()OlUs1BwXG&JCIkleU@HXcPYqKbf;}Zfly97MuPQ01NRs9alR#SaosEE z;{TlMA+;s{mGsyat@EMgGz(5tuFZxev}UM$f23PBMiyR>#cNEYz-Br%DD*5zMFBzn z+95ohY^Q_WwOKyb2Hc&A++Y2c(nbYRGNqaqEAi5<=u0j}xyY$ti=OtRPulF<0Xc(A zn_n9qUDt!e&|Ku`gfY7|>K~n#oT^5nf#{CFMI)0pKz84b$up^}Ua-oz7W>+Yr!Uzp z2c2ErV*V=eDxLnFWV8YRo&C%vy(UbVSthk|3G3W+AYsrD1dwfwEAmq7K3}($Up0xT zoq3!QM*IX=;Nh53S(-IQuFAoCWmBM9GTEZmUJ*~H`RN(|AVU9AS9Ry^{bK2@P=~-- z1f}~z*J5~)7S>Uy;N_e+@xs7~1r1$XP|)U)rj|kPOI4`I6qB=+I?|h$#orVNd6vmm zPVO$>SF1nD#aZjnC4divijud~P{lfHTIw>r?MVJtd*1ws=6Ok-jc`1san5@~8; z4tBR}3J7b1pb>xTJ&>+UvWDR?59oryfPjOCB z-1`)mmoI}OG}l6$)6!pnG^beJZ&HT&0rdlB95B&XA>Ndw;b zs9d>nF#EzTTp$D;#~+INxn3xG~)&Ut^b2SO@~cQJri|?RzV%nEbRkS6V@gv zN&bB2XCQ0l;fyVM((o}s+X0MgC0}{%45t5&%9t8-gj&OKy5b9OdRwlpT~@-+m;_At zBcvGpJDyf+c3RQJjQFr^N=6Heg3PNbnpGYWStEYN@R`MYE&qfu4Y%atO@}4yhz^pQ zl$aucr6xYwuhkd%f-IqX2Wo=>O_Fro!SeVnv-XSuRfa0|5Shi5M7-m(&a{YrsZj~q z8(4S+)J7E_w$B1Ojq)hEy_NAt=@-Z!8gt>FQz7C5W1@hYy>9}^TFOluWhwNwnsZjA z-QD}3Dbk#PL<42m`ENIrGnx=*I)oT+6=Xzfu=k z7m{Dv*z!`Q>Bqxb&90a0WTkg}C=OS?E|ElbLgj{NBrlrz6~R?3w0m=jHHdVy zX4MpuK7_|`Nx<50$cNSHkBO8?Vs3i^O3hpE zBKz^+cE!&><*35A*wY zt#B8KzBf)sPd1ZLoU7~h&@jfAh>%q@uY4~0ller+T+2g66|@xmP->dUzA)u4!3@?cZec@Jvb(`N}k-9 z$`1lp@-}$VvbXGlT)Q_i#C}xJ$dgFSqekv|Q9f%SXdpHdM_mG0q(YqB>a>fOrUscp ziFakU@>(hX^xOonhAeTeGpZ2budJOgMYHy@u$h)?WY!AslY7wJip8O`1-CG0f~x-F zDkQBl-3$5yQbLS2>2O4#0}VV_>86dpcR$j13GpY}nx}hzmtmsmm7SCMa?a<(^*(+2 zNLeIc^BFuec8Yas5jX4ySH~p;MIh0j{1UwYXrO&&hkV0$CCbcL4ag{Azux7QKul|+ zei3?a>x5*O(nBG;v4S<1v7=jd@pj%*Ndr~R59Ovspmrn|kg`P{EqXx{cZJM-cgXPUqW=9k}VA zpJyD!S_aDT9h<=^Cg>(7KcZ`r0`e6MD3)2rQNzl9821&UfKhm0hl31gQ%X%tzRxL=XI^p5fZHKk`)y;nOsHY@fVOkRe!4r03eW zKXmvJQ4bbMW+5s@Tt)6O(=Dfs(<8YILliCR8$v*Az$fHNvTZNFY=CN%gI} z8%YLzqZiYNR|X1NK}lVUYHQ;6oUsy3?JbKB%UrkXq-}`B0~8xa4O%}oIsa<;d|aOT zLPTdgRq^MXQo6XvGL(!BeWgZL3ZW=33LMJK{Fa*vuUaEQ{jL_Go0Y&x12EJ{dfG|R zU`4f?aQ7i$z|MA?L*AStPwmFF+By?A1+gdO!<2`0fGm-DQrwfv*d z5z9(yiD59&fkmR{om~2~VWuuJmcKwZeL4?bkTR(^)s+2)ND%k5;X`-2h=VPC%2;TJ zhFD*DytHe{bJZ26_CqX`7&WP`?9d_9n92=ek41C2UlrTfZl;FBVyR#NRpJwpfEStm zU_jdKFO?@UX}3&apIwpqzEu$WrP<<1hFKl{^em-M9*=ARw#tD~)K{szV!P|tQlEp;3eQOLWf&QS4}=2 z&k;h6fH`iR{8ipbK9JZ}#y{bWmRP|eBO%j)mkU4&pO=h#k=v&IyCH@B9ah_c2s3l{qU)Xa|^%`1^u};y~&sd9RWEfO3&t6q74MXZXbQXzTbgXQj>c}q zgmW5AJBv?8!YX+bvu5lhoJCe|QiH>jp_-YCJ6N5PP3vHV`kGsyovf> z_*hxh)Mq`VQcSu$3)VjnUrex_$)ox*i(GZ&CQscl_CQcoWU6>l9pPx zo~7%V&B-$l>v4z6 z9yRq0&an`$&zLqsoMvX4br@vpH`MgbiMPSko4|C*TSJ5aO*;PR3r@1P3)oD}oe1K7 z1&;4F$nBZPU>R2P)<VX%T-rwho+{ecjpJ07D-`FhS% zduasWw5Kr>+XIJ1;*EBflPc)7BuDTnGvY!e&{c7p^rWDtX3Z<{*WWcAaN5b@%um zVqR%TEI{*L0dHj>3taf_#?()X=qito41kO$t)9I zUXPsl#F7hY2GMfc=k`P6zb;nHbFrfGu%;sKT(p+DHHjq!p%{t)OUZehGWu=i}VfNM*$xze8pN(*IQws0b?VuxUtJjQd;-2?1?=OTnVoYtk&^S6J5KjT2gGp08 zUFI(2wKu^Q^ZE0hpQGAx`E}J90@Wwi8hUc(Q5OGTZWTL^)N}8u zY%C$Ay!eYU^6W?TD^%nxh2IPaq04z>T=J9PgX0BV*wBvgS7B`fOBFv)>Fl%8Uj~$2 zhBph%3NU6x5bc~y5IISyXglTSHx3ICzmN4mMwh*S^|QMj)5R_Be)Lh*Z-WQ3$QSft z*3I$WF=o$_U2Gxq+^Z1Ym3;={ zV0Zh)i5BOukY$!-bn;7OYNFB1X#@Fe^qE**59=4o-{!`;4|Zy1zQ~mr!;Wpm$M^#^ zAk6_GMq#0H73AMdx%Zo}(oQTy(a2PL`3yURmM#hGk4>ceSCl=%;W>=8I}wSvT`@+; zBobgDD0s+G%pVu%EPG8zAF#HdlP$uG8#4oH6r(KRbeN)~b9zh*IdSKK#-WmIo6$8( zvt<*z`;g3Z7#Zw4E^oZ3%;Ht}0gd19^40AJ%v?ZfH7?G09I?J)8KuAB55zx~x~VmR zq%Ood5}IcQ`s5%3kq?}8gTw*(DpbgNu^rzv{`o^sW)h77runve$F2|~#Yfwu>%uvx z7YD+_u{?hQhK-5*syG>8!TY1`k~G4#NQO38n!Pfq6S-R9e4st6UEudGPy^cEhn%Op zt%GOJG&aD=5vhHqOOtB+=GI*!{mSbqLT@p|hRfp{XYVS9XN`7OPJg%cc zg`6`}mz5o4`^{5*^88k1W078&vrE$*@_w{^#MA!=MnJj0JnH>D^Gq?_ZaijV6F5NKNsu@^kj7*Rzdfw4Bu$)B064YkyA%xV4iz^lp zDS8)4>1O-yZ*#o1kDU;|{)WWLJt{ksyhO;4#`!@4O|2Cy8I|qWFH?wHyMH>MBv@UBlb@Vp+(o3lL9Pk6p56M)vEy zYRB3bLp?6!qy(W$g~o0oc&Pkv9L`Ztx;rU?%J8*E9PcN?d`t54t^zq>zCfRh>Cn!3!(D4~CUsI2T~_GC}S}eE0GUGOKWU z-w*RnZgGuOr;rj#zM%3>%1d>Z~gBn@(2$N6mXfp=I)s$28{S|GKEnY8C zE@W2RBHQvme_49h$@x_|-a*=ud2Ed2^W}cGLbYCWlyz>2Vw#A%`-f>6r*|v0FBKFs z`+LnYrscg^$OC`oT$@`4p!20Pv;<$G#Vl!E9TPy2VSia6;L{v^(PDXY085;abfvns zq3Yi;`ixrWWDI)qwKx0Pt^C=tFoSW#w`hz?Cy%nZnS~TGnxDH@E6rV@OVbSmR;IwB zL4)K3KSfCrpXazQaR_85X$2%y?B8POvl}C2#>DT#&)T z=J_~UlEb+ua42+txOl8cv{fOWc^BnHpZFE7pCiL-5{2}$q?OP`l3hlVSQ4qP(T4E; zT*#X|cDTh6hN^LrV9b(sUwMZ*zn=2OgPE~QGUOIh)`>{`>-Z0!@(Kx-+5@EHYz5s# zpmFj$D=Dy*^kQDW0BO`pL1Ta!vYaF?E}ZuBv{=bx*|)USxI+VX8dxsklvSWIAB9mB zjTxaG)6j9#Of~(=c$fNrF2ikP~LfX4VjQwj5MW+ zpnDn8H-4d*dH>DWwmPP51s*z`B4a}HxMzvTkaO3yROR~JYyrB#& zA`8d-ght3@SK{VORLPFmvAPe&mPAPgxSA5nCnM5TMndvN`Wf1K3a*2NOzPUo&s}0u zS%x%~$hIeRbv35$?pFMK)S|icJP*V$iU^?XUoxm2v4zXrNed=e zX3WjWn)$n{k6?Omi7{zkI;3X zz$M>A@6t@#P}$@%75&>j-XKdorwXt$#~c3lg~jM)5{Tz*E5#!F%R!?AD zJ6}^{8n1$!60W8M`hvFP1J;%ErIXy_8fQ^0kUm7DpR#|s6BbXB#*&zI;fpGV>VQA& zKXIKkLr0)YQ%R6lRi|!`^?v;nZS4Z7xMtw zSuQgprm|r6H%!AEjfq46i+ncHt;*1%Ek5PSScH77$iim3v>cVioy^1!wIn_W5z?tW zcq^Z+A937_Qa(h={|Z;H|?=ieU>ZFyM~D&B367GS5Slg5(nIrln4b zT&a5^R-GP+@!q-+dqe}Tffw;9&vla2f`qa4#Y4U?d=R+AEYbehZs8GSBO8lO+!&VDl6 zouKf1Uj@5mVw7QI>*PQbTNi7tHs}jswGGQ4Pzzfx9zTXbBV8zX<`b)-FONA_7vvnW1~la+PH` zRMb(A;;%W=`}-E&R-kUnOb>f$zXpbyZ~V6sMhPbX^;^&-y&*p z<(UvZe{I(%{hk~jtBBdm1Iw<}3q>yAKn6X?o~C(UZHX`i1F58rh<`Ovou>G7gl%Ko z^xkb9%ChQo*s%LWaU?L-ccrJ?u&4tmwIPs9Xf^wmr#qJ70)J!P$b)s^!AlDDGOFp!x`tmE8qqDlw-}|2btUNAt*i z;@kR~k5M&csG}qp5m0YuoSuKLkR*$FBaS4*it<6m0YxDq(+n7@_66Qg_|p*{YZJb z-c4P!J!7{imY9#8FWY}6ye2Xgxq#>H((TY~B>RKrqLTsR%XXtjGok3jWaf(=URbA+ zsA^AAq%h)uo}V!t^bBPkLP9^?m-1`pxsr!g-~`h)D9qE=+>_my={s|TU^y4^#_{uO3XY|K5I7&3Q;It5Vqtrkt*jakKrP-2Tt zG4Jv^T=jR)UHASj+2BxHTO7Y+WHgL&x!^~ObmgiZVkMfOcj6_H%vqEM@5y_{wrmUXxU>Lg+ zftTk%*52*<@kxwLE=T+) zt*YHKgKRtlyu<&SPql^rVLiK)*hHz;xvxYM8jVw04sJFrmx;!hZ?-7 z^czpZydJ=ylfJqDe~?vjdbf^XQ+IqqE(eZa*URmLH%*xM>JV%|DLDnAWUMRPD`#)L zV+Ok&c(m&b0Ngj&sA344>1h)!8{IAS?-J>P<<|s%0Lu-goNP00`1)RA6tsQPT7?mRSGb- zx?qgJ_-rc*0b;iCh#p6f2{mm|&>l9lWKkRx!OgxJZ+HR$lB+e2foF%87r|d5=+}n< zN#)B6=*K%3!C;&1%y8!09@?Zfo8t<^UnNz3pxDz9AeEicn<^qr!E?!zdMUw)A#-K4 z2he`DDpETiwl5CIU`zv&ntpe%FTKyRa2VKy^+fyrvB9Pdz!N*EAhD+mnnulQx4vAk zz0}ao=3cem@;rN`Pm86^kW24BP8apGFd%CyOjsBj@;XpBE0X+G7O25g>5>8Xeh*As zU&_5mxc9FQXlUZ3WRz6P(phW(K?dwx0-ir|Gyh8BmH`DR_oTZw=7R^Q^s+gaaGAMW z9^6$7N^r$clBdn=FBdugWfRcxdiZYFgp$J?OS)8Xgqewu2rKCI-^-Mj}R!iXHx)txjCsK zv{Ov3drV=7Wdsg88y0^+)@BsRE=p8r!Tw{5K)9qarT2$;Qn)P~5r86Z;Ah>7?3nc; zXlo%Mc11-*IKOV0wtpolfEMp6f+I)wDuF44 zrd#(6OSc7Ox#^W%cYuTf>I&P>K{N^Te~0PogUWaG=BiMxeu<6B%a@(%*}X!BsC zVF-K%i(TBX>*k3@NxU#p6xqltmyu`t2NXQ52AyCcNl$`fOWew~y$nYIoZv~Kl$r-T zWFqlI1}3Q3@_y23xrS^7-n&?K{Fn=K@;A!-X}&s3Mr4JBQZv#F`lV<8=*{(jU@d~K zOyk;9gkpElXS^+UlYN@~*!DNe zbiR>zJudU4i!u$1&B_;m1M=UOyY`R>r&Y;f(;{<{>~I@r!Q~KPlde+V3J;h}D5rVU zHz7@1$SQril&%NPn{0WXm#{cW$ACG&ifrwyK_VU=&PFJ<*CpU`2?NGXcJk`btG26E?pIc2L~J`*Hogqj_GP26Rbml@iatvLjRFd`p$SPtN;b) z+Jv(wP9pPq!~QA^gvi*ySox~FL?>(0!SG|+Mh#Yp--VZVKe23Du%lf@pyy{8C6?Kd zSy`>0cA4R59tVB|G1&R2-c4mGz>z=C}H`ra1*$#qhOI%mneqW4=6ZZ!u4;h?T?-Ax7V8oMH=dgLA{Msl)kT&Q; zNQ;DdnM7aBgLx?*Q2cHeZ)a{KU@V)EzvQqriI>sxsbw!>kRlieVS8O;u5 zKJs<)WprMzzIuI1U2N@Sj*JRx&tw(NeaoA==t`3O;y0iP{dG3ni{s%G<+~}RxxM03 zOGi??Z5o5eyWGZCj_pjS1n!+#{{f4akRb_^oSLh2PeR7}4Sq+qY?S!|pV0Co;Q8sn z3Rwu}+>pB=IP`XviVV`DSa&n5UcCDkCy+nX>V%r31@5%qVZdySmO2F|2|d@@t0N^w z`S^>43{WKLKnmx2D@#>D}|?oi5J zj~Sdegd~0;x6ME$29h=^gr+bQvpIuW&3VR*mnV-%)`c@ej9G?HiL%ZNlgw0~Pfiwu zoNa@`a<3fTzt&lGvKtbf1W+>tXWdcYiD>==LOoCWeH~AbD!L)`z#k*IfgD1#n2$)l z;AAGxe2y4R1808A8YgY}tl3O4>08e|gGZuI+tCb;s~5GGypf zmYyVz027^u0X_IJHfj;K=Z=X4$-iMDREw2r{@}|>KQ9jBgYp-0{x%yfy2cX8?#nZ| zaZ13R_*Z2205HJ1GQTEve8Ssz-x*=lOkq3+^RpRVkHyk8Hw(0ty&e5m^`8vLfk^*M zCId>TwICLs%qqWFK zhov+hF_$NyM$;>H6-^x^uj?@JAoqv^2GM^~sVYlW?cT8XZ`w6wBKt-3#dwf+41oNTmdrw>(_t$&hFWlG8qL_epmW-{c5|1AvKTGq+X+Vx&jTKw{hl|d3A zy95;>XC&M56{A0`GFE4xx7Cla+y+ot9acP0^2Gs$?=OB$A$(F&nEQI8_Cv>dr6#TQ zJ5xSN$+R0b0(`?{=T9)47&6M2c08h>e?x=Nb3Cq>O>L1o0A(7j!h_TW70i-H^zK*(n1m#+bdG?Vdmgl@kU!S8W-b+?(qG5IR*+a~;_l{r?%k*n#J~s?r6PGEi=X8U;9k68vrwmd-T< zMAC!ADTP)EjDEM@A)Q%1Wjukc=Gh=gz6%Y#v{Z$3>;{l{*_0X7YI4OrGtesXUA*U% z^=Z4zU|LUn*!ec7>00OXL;U7+*4VWR1{Y$!Ekcw zY@br(p7#3@{EmRf-8$tx8lZ*%*V`0b*LlbMsQu9|{n;})J3AubH;q(lG3^!_1P|~^ zpxXt!kfb0AJ&4uQGnuXHdqL_`&|p#@{zRHc$i(Nk5^1hTftO#L`g&L^0TC=lmiEh$r$qC$C5mHNArOFy}_;hl@#d zm^23TddR-#HMHe9SraUklSvu!OU%68rKHO+B@n`$RhiErXf4sStG+Z;i=i#@8P}f^ zu)JcY$$#W8CL>DBu5X>MUz+m0EhkcGEVpZ^mq4JZ%Q0eQcxrhUuvha=9WB^*;U;8B zzZ!V}0o(-GbngQ?=z9iXXzO)z3ke8zsNuK&BGG{11(l#qpH~zPh-TsP_}r#-Fu4gp z^iUwZhWdMMs8vE@TC_FL9DaR9U4RHxji#(_|zQ!nM=?My^!o5!EyZzJ<=J$z18B{v$W#whu|#VbGvC&C3I-JzOGW@&5vaHI{Ue9Nu z<4@9wIN5dUhBu))Y8bfBg&20x7!(W#VZ-@4wtirN7 zp}l$Xg>HaHrE!(dLU{5!a3!A(S|Z_N6A3BC5-Qs!NbT0&6}q~1BOh$2TQ%#$2$WDn zz5GlYWJqU4N7?ADp0Ww*)AG}92;M6Cc5d^GQh*nG%}{6}9*{$7|GP0__VP~?UQ{j2 z`&O-9@8lpz?Yc2w4g>9l?^@{^^!4gPh^b<1lS3ix71C$YuXUVX=`vKN2v&EDwI`fn z-W`qg`%QPe$D4&=b#1=)NTC0a(f4jrAQoD7F(*k-Z&zn)Sdg0_mG1zhB^C2Z9-*HL zaTEPeVdGZTu0BB%6HXTmgA-`qEzL4|)G>9Ts%86bk~=0RzcQtrB(+X)fryBzU_3zsyRB=O4$PF>TgcxFEeFpX6gMX)tlyhf`5jg89*zn5_rQ!ThJ{ z|0hI*6lTB@jCFSgeyofxg~D;X*vMD|j>JX#uN&Q!O9sx|O!5ij`xX4M!liCWpK+ID zx@!{6ytIg0gF0@$B6hs{=OwjWPwZR^QDe&~3@D&K1+MvJgWj|!*Y$p73 zmY7XU_oOyEf^MiHg%vWbQc;k~XdNxsHBKXRsxKTv_T8u*n(UC1`xJp{=NvDrZwkIl zSyX}Uj+;x_-q@BC3#5pTjn`Kn*tu~kI*HUc0mG}S78RE4K}=tUo&dbwO($QK69ufo zqShTfd!*TTHky{M*?IaX`-EOf&jkfVf>qFG`IQq%x$oG)urhQJxV8TSL%qX)mnr9W zIUo^rUdW9VF@YVf;XMxW#xC#O%T25ZUASjD$FsQb%`Y8rqg;X;ePIQoy|^)G4Ab#} zlfhzmPe-vo8d*L4SRmda_6Do*L7upsQgXy~#K8(qFa_-M(cN($_=-zc+&Qlp_X;e^ z&=J;9H@}gBvN~^!RrAkHHb%|2z_1uOgDQn2jO@S%fhRLjvEd#Onv%b7q%y}D!(J*% z)^JM4rP18`1<2oFkROSpF%=;7d*Uw){DS8RWPjGye8+9CjxgByUG-Wy;ntuPmHHTUBQRVM;$hLq`NtNmi#Ga? zk@#hFnTW-9V>og7ybVAygwRW+SbY)m#!p5sRFRpyT3$Btc2=|^>XjW4eAXftLf`v~ zoS$nJRwNPktSw?1FSh;g(Nmot&xr%xfG2{npw_*yKg|LSZU=|!gE&B)`U}#Vx-N@r zBH+{x(n!B;cvZNBlregqO`?GYFKU+JJm&4sC1*t){B&-stSk4y5 z`n)I)hom7>)t>%!dp#}#;-3PxNKwCJALzU6y^kls9d7?t#ScMoy_C}1e$?Q6Frc3v zP`eCwxlsa)?cy@kJpAY&N^aPdG7nPtali9WKX?QdhyoY;pOg6O`qy}p{{%HYX(GSiT`+I5sd6*em!vzz3QxD5Cf!jQNi{{Hw0D<#K&hDo&N>L zVSZK$aZS7|8|qL}npTfyr*kFTaty9vtl^_}m?8@&ulxQtRSPRnZf*OTSicx0Uw=xn z8$V#ymNagtKazs@1g>hY+XHM^I(ca0m>9o${WumTa@UV|bsYmLYA(=(Bzg;Rv`)*_ zt^wA*O@$K6%^x$az#p)WeU**;T?^~;^X^mI0O>q&#gF?at?|zOlq{~%DVr-BRv_Pc zFb;jXW7RTMdwKy*NizeHXcLrro-1c^k4>igDWJ!7{BKDZ6H@t;H7XPiBW(ig(kRI* zZeph`lVU_14DS~d`SjU|H=Xsn10>c?23=IA5B`oYuQ!@;nZu%o;=0TOaKU_XOfEx# zI-@BzLm9D!TkKdK2ObvSiu4J23{WCrHdWZz@>fP^1K;wj_+LGsjvDh>FpOnKvjZQ9 zzv-ST`-fp1tNCCJAS>ApVNIQQD{7N7FQI$Em^n6VCn2~r`Yv|TQ=bp&o{VV<_@UW3 z3j3Gd^9jxhJTNPbT`2qJT(d)91*qBh1#0o~Kf_4Mp+>C3dxuI!W7SEd0qKkU0o7s! z+~-p(5Qz@d%OI0Krg{}o;R9i?Y0g!XAbe6EJ1e)B$iE%^&J2Vre24;j}EaH-aK?tUSgt5t}jTGI%u|N4POM}Lj6d5xZpRVYYIh0Vg;E_T-BSO6jTSOyl7 z6(yYMGP%({I-l1mX*LtqpBa_$)-Z{vdB8XiuXLLMYplvZA57a+E+!H6z+k{o_cmAk zlSr-fJ1R8okmrQ-9KSYA?#&W9Cc7O02einPCC|d#>aPI`zdRMYa#Y+C>O}9M0lY;e zO?D8zS}F)EWU1fOAVpQZOhs7?*L)`nBvI;lcl_zWXXcT_l2#3gc!S7rch18h+v{s! z$m3uwP%$7(@iL5@LMO`C0H1|?##OFt)TuT9W&o#af@v{FzwWHQEpZ=Cvgy(7=Fa6$ zpa0yo0)vh=}UBCtiaYFd$gF_}^Nya9f`>q`->}W@xe4=(WsC zu>3(h!fL9TM#j{|v4y?vbkCxM;!ewYpZ zs3tUuO47B?T_b|m`=HYd*?2NC7$u^9t3E=;5%V4CMifn23r25&(ujh<5-Wj_xhKhC zkBDxneA>$CP%_nSZNUhz+}nnITBLT9L38Bij{_W-CVQAoPw`XBW^exraWl-`)PJ4v zj@s3?17Txi3^QgTErfmq@Wb?sF?+0v@uIjZXhuSpbdF%lQzoIiYnlM>fCJzK2S}pv;Z~~R7fWajiAyq7l zu1P+%s;H(N7nPFH{?S&s{r$Ol>2bB(h3lg$M2kB^69(iZ?N}3y?$=X3DPG}C*5Wj! za5Fd6Pjis0K(h)yXj#<@9t}JfUv@_o?_Tl7VnS+yI(<7&q^F+G@!>gC8y{zFOx+{A zB|OZny|jFQhSz0%$S6dJ6ijR?VQeIx6IJLt@TPKy_ao+5JR3-y))L-;xColIGhV5& zKjjFP69@U!Rw5$9Zn$F8&fd?}v#T~%nDTKhmWXQ889^An8Ewm&AM{ieARfldNt?%g zeSys2mG@)4Tu5KiYYB~C#MegFx>9K1WMp%~M>%2^F#@y9V@jv@Ic$s13pkqzTj%^M z`F{Oo8>v&^UA)#QyG@S-Xdc5w6xJjhr;ZYyxpu?v=_*9B&hPz5FonyHgL>dN{*1?Au?RHJhC%4_B{{wH_%o0mSEU!V-gPM=oL6g!1E!pdGCp4W!a7R*;co z*m+1c!|fI8J(ne?(L=$x9;4_K{T4V>LZc9#>My{@^Sf#a(D0^kae6TZk7`_4oMLjI z1y#V?p=AI2Ljb$sFFuyVsk*CaDL%Z>OXX|x zu}LT4yVW!pbpBkV?P(GMF4v_6Fn#W!MBt+W{8;6T?Fc5y;`I*ohW-InjG-%#n}t-G z!4`=j){f~0CowvdZEkndR>&NC1Ve97b~!XI?6xobP%vJJ($z!|4f8!2q+*?ztUHeQBue5#yCVEUHuq81IVlQ`b+6k_d!}-c~JP>UpvBrrC+mV~97MB?Bc0~Kh1jRdEX%@fsvO#_C zyZ%O@t&R~ogQj)e##XAoGP)c9I!#(&na|mqS&7YenMU!J?U!n^nr3McqYy+a*XCU9 zgz*O~*9K-44nj!>g_dz`@hgU=WK+H3a(e&NZ*X$>$pz*9`iwUNG<+0N^KFw!7fxLZ z^u~y)V)hr%!V@MGljJvl2q=#SAUlmRW%rhdyg#P!|BN$t-l8LPRl6#0= zALy!_#&*ItL{753i5c9&v{4^Qm2*%!Q*8uytM3d2&?r4Sx?O9pLEc48` z9iww3po1l!Vm3zD09tqBqg#IE{8Icj_ve|bUgK+B`pvP+pv#uk`b$&c_UWgYN$LCz%(TE1d>6#H^Q|UQO|1E*q4#Zm-%EiB+H{I_dBu7Ywf#{) zw`n%yIX{K*-XUldsAeZJ2sEC>5|7TS#XXbWgk)WH0j}3Q5Rqi?7OS*ekmk|H=j;>1 zt0Mb9KK9`mtFOo^<>AwD;*XRXl9=?z_IbR^!)cSa?$PyJ-IJSyWc-*egx9#LORYy} zmjhtw$&i!z$@TIhYOhfQ@IyJg`_U=xbclssp6&b)$dSG&=R#9m%J5yj78uiR+g*=9 z`&v|f+(rLCL^fGaQF@RWevgDNnXL2Zvqc9CRp}Y}yEyEO+PjGGC-w8#cTc9=6q-#x#ZB6^xl(!PW5B1RWt59fBp+1zhb1b;8CT0Rx($UWww*qTjV zS)|ni@L|&<57xfYda((5sTe+T0_smE?yZ3Wd%{ zl{cG;eOYjd9obFbDoXx7Ti_ONu51ri27!AVvfbC_ibt8g;Uvhf=-tQHulLiGzqd=1 zl=W1HUT=fxkxNa87SV2Estj2@0S9@Ex*Wijv}5duj#Cd^B|nr>WLF4$`RsO(4WAKX zeo8~n{qqMt6pwA#Dhk!4mM*e4ZFICg*GF|LpXM*0;tJL(F6J1Q)ny%RVbi8f&RN(? zKQ@Az9ti#?$%eK`gw%2XjqxRfVt3btPff2L_poNrNrI1Nj%OTqKr2){G@M67XMQoF zPuF4jYd)lMA6MCc#6tNE$t#!=a}s?99YH=f`i%(C^m7OR1-p<38JUnYKEhMpgFwrI zK|l-iKE8weFMR`_z4?qf<*$}{dCoB%9;LAz0ms#U8qRGd7+ptZY!gDArHe>YaV2q^ zKe->n_bGZ?*(AeEhyD!!elfskan<|{9P0>-Odniw8Fg8E5Nv`Nua;10#Wv1Fq*%rE z?-r%QECZgACY{{Y7baHUl=C_61WO*zx;Pp7mt*`M1kZLK8Llw;pQ>{X0^mqB25_@)`S4#13h9b|MJ}@~|ZAu1Ew25Tn{Sy+_ zHJWJn-pmf3Q2NxZP9+{LlsEDeP1YGpqZ}ht)9s_sVN$zk#eTi<_TGuYH!+!o|o{B9-K51|w zX8X^Q*6g+hbaduKr0+VjAHDx9)_&Zne*>udfH0{E$jE>xo76zNnu8c>nl}(p8j(cl zjp&pMOxHp|#ToV*Wry55AR&=GY@P0(_V}%q zrs#fOrMdesG+S{FS{x+ON7D~6ruPB$ry|KKuSsmWZN9MjIXZ{4X+$|e6|xl;ufc$L z;rz$%wm$MU;EcO&bXy=GS}?dQrS|at{OWQtO_Bo>HuS;%tF}-l-chCjYY%IHg+o>$=7UVTILc(eTfU zIK=q>s*Yg#^5tS!GHsMrajBdW5)4?Qui0)eYP%e6k`PTE%nqq}Dy0L3FwM|I866kt zaKpi7VhT`d$ni$FZo`IMi>^OljBXTSsQxO6p$(T>5%%YIWhoB&`y7Md{9D*iN|i2Y zVyv{9j#K7VRns*PUbu{b!0#;9$eVlWg|XO?v;zga)IJthED#}^08q%REJ(A@Zj89rU6;T)N$|NV-8#HLX^|1ILS9NeS(U~d*=YD zh-W0Jh~JHr2>C?6ee%DGj~SEnf?j><;|Ct{d4~(gp=__^SY*Lf!_t4iTjJR29$R!* z7+m93&yITavWGgUb!}3Rnu^(3X`a#lRyoOTx@adqSO3PcJ!@U`7Nc|yoGD& zn86-*(Accc<_Pk8)1^meER@?9y3V7XQZRkmcmJ1uH$g8O*3?Mp;k7EHSCj0B0md3o zEvRWB9eo5Nx)aH1pIwb((R%qFRR8 z3}jV^H*1A=yo9-CiK)YS>}-KzBtT3gMYJ7F$ulHx*yZ<0#@ie1;?jkl%P0`$p%*c= zDct@#TlCzL66md-=I6I-04bFA+IpTFYzMZ*3+y6yK*gL~RoQG(Bhf>s)YnaqE?ZSz zy74uE4s?Do^BFL9@y3eG%IPbvyJ|$(NFbDskwGC&{q~1VSP$|bEoRc z?{CfntiGJj2Lmufz$Y*~IE=s&PPdd(5U!9$#D6;_fXsHGYSr~_#2olzJp>whMkYen@{M`eYwkIH- zVwBaP$A9d2g$01sbyT;C5*dA6c_)VxE_?BnkW>U{iCNVPK6`_?G9?={tmS1GxA~2X zhw5JW-#ugRuCJLDXCRk-PnHKvg}~pkv^x#wUb)j4HM~dVhqwlUV>_jSaeZ%(wWlv?q~`G$K+St~J&Cyyn2xnc*|lOrhj#H; zk~<=8Jq$~cJqjC?wym+aO=hUEWk#U8_~6@{Y8TZCET-mu3WYSzPPS>O^Jg|$CSzNv zhA_e-ELIKA$Qv+faIc%sbyvKAY!gnhMP$YckDg8cB?|OqDVnu-O*8vDrE8=#Y+e~V z5xVh%bl&NWWa)iVa>`AEi(iLFMU`PzphnWDq7iJ(;7~;Xhw%KrngkfN`hae1On?*xA2iz!?0oGr zsON>A%j}0(2*o`i`=(DfHrL7%`20;2n0}5!l@P|%Z~PCcVS_Q<0bmr>?ix`T3}w4# zbQLS3ChHtmjV0IYMkQ1ZY31+4IXG{_f$oj4Oz|Pb_)ppD@cpR|;}cWQ?&VVx zHaa*iK@4f^a6$9a1C*UlO3m#{@u9l5K)wwTv_KL>ZEskvc|cQi;LTqJzhX-mT>Ckc zc(w&i79`%}bLqt_Dp>Ika%Y|p2z%c6GU&)u9|W{#i3h-$w8&wziRvwIEb5j>3{!6P zMOja2a8t=vAN-uvV^Y7h&CD1v;K3Knwc)OL|@ON8ELam6sVon4z?Xqksi_u&OO;MSU`BpR&+ z*8{T0F+8FkPY*GVB`2QY^ow1$9+k{PV3QTq!>;!2+E9iF4qq|(CQd&n=+*jho%v~t zu7~rIP|QaP!3H*=pmOj50}Pk%w1L7L7aqGVdp)`r)R`_o@ElC$g15cG-BvXX;;9(! z7;BIuK)*^O)kvz;G23kAl*24fiu#tkr_0=W_Ou=vHxKb{DL>K@A`77+=_zt1_SFM zN6^f%QZ$nX_T65unN~f96wiJBi?YK(GqIw3A=SA9myF6bj3cb?Ely(uU}9<~3KEHo zj3Fr((lmrMtbT(+7;+Pt<#&?EwMwjJO?A)d>J{vq?rk837oMjs#w%^@7pgvxo2LqC z=5K~Y+hS?eZ)JIDJhu0N*dBTF{s?iuXk(DrVS(wH3w*k&`X!m=b{Nh2z2o8>L-Tmw z)E4R>KCfLTfrDV9uU_*^72`MOP1I^vcv8k=F@y$G%j1w8p=B7huO1*R%xHT5_2gLk zhqxG_Y%#ssK#^SzAP9!GQ)7z~QSe-tngn#d*aa?L9lGTLH*qE9Us2446=Z@K88&fEC4 zHelB31$Q1Xgx%9_u#wzXo#a?YRjX z+)(!}JA75(bNY`#l|!U^I)!Wr`bzh#wMcYn#F(m=nIlOPK2yC5o1Z8h>K%-tQ!oL} z<#iAv#l5l#k30`KWf*g0({rU;MIOuX#LtCKKk9ylttea>br_9f|~7aZfCgk_zG3!BQb+zQ?!Z zK#(D@{#DrfnsKT+6$ZPPb``6RHPKA1s>*pAi?1W0hO$Ys+&NlaT}*Nj&&zLIE@HSz z+;UTGo~DN&>-(wMi?x70fL7*QN3k!G&V>5+KPm|EMcXEocdbzFQKFK*WM;-s^QA~g z7!6{`B!8v@C^YjR9hU~(5s-49n(qus};$WP!&_z66{UcE!EUIr|( zk24WAWc|C|N@{VnwII_rTvzR^71hp5%7-Q+P@gQLaltf`umYnlXwTLbT`k(5JZ4ev z_O?*vnTnp%0TQb3C<+sC0hB;p8jcY}IdBl%fy64mnmo^s_-iWXcYfw;ma#}t`LobY z4NR;~DDN}&7%vM%+x`!eF@crw2k#OS`Crl(*PrBUUF~SYEy?G-*mfctr*ECXCEL3v zoJl(-U@{aE6diCbU_ zOB($<6bVx>1@ObvY1<6Lq%HBZ;Y=j>{f8~?K3taiqN9>mm`$x%0bYpTN0*o$_!`Go zPrclh@;wxrhS?lcYX?1|Si^d%wQMj=LO<|Nd8gT4I7zy&eJH)DMzFO@H^N3J?#?<> z4uQnI8oxrq#QQ@u-I}T@RK#{HH4;@UCo&QFOQE`wz7GJ+Q})w>bQjDeh(MJ=Z3g7g z_sKq$#VBfeDjiSvw}~fEPyg_~jw9SUFkmO(;$wSt$&z?KSk0N@1Y+UmJNP%C1lX#9 zNL2)=h2v*-iIDUn(se8x2I<+x2LR~$W@fjDXqOB@*iA+d9Ua^RPXla;tE0WJdTGti9m z+djlJ}QmBUaIj_lBk%cmbfY0=;@)CFUy z&MBqV8E+Bv6qB>V|Zmv({8K@Czv=pwr$&(*tRFe#7-u*ZQHhO+jep?&-*^#`L6Tl{HWdC zcU4zcRoA-KwbtIdE07X|qIS%V>QXQ4h?MQO)F4B%{>FEkKgia6z{6IBZW!wOz*-xV z%b6#o5gNkUo+hq^-(L8Gmbsqr{Yhy{E|;rL;1Ja+XRO8L>Q|rN-D%OCXg%oS#->DK z&+~ow6O7ramM0F`7SV5{4{10Btv-u>46xg;RR3xzs$xZj2g$d0jhAdfl}WoQ;BegV zXy$*IssPryEDRt=h1wKlCZbwNh}PjSnX~%=eA+cJlAS8@;ul{4wWlC@0Dacb4&N?t zLXE&6GJ%fok%Bb{bd8uF?%p%s`Tf04sMwDozN6yT%lOdG4JE8oW3PZGWY8%eoiLx}I`?fbP`zz4 zfZ7T=DMmRR+KrpDR&gk?%6Atdx{+-um^@P-xIrc29$&i8Q{|V;PiqkzAo^=y)yEX! z4>j0W7bAL>Akmr)fw|1IzF4v=Tfe!I+r?EK_g`0ka+Cdd4 z<+1IBC!LB!Ic6IfWa~#0SbhGmK@Hbp_sn!WMTHd*dL%FX5Evuz<57txh_U;xPNji- z)2j$kttUl4$MTx8p{aj~pT#7fFpxZrl;mgDR}fri_58Fms@2wc<_do!48i=hH=Gtp0~GZ75NBCIyZ}&)m?iNer*0A7x_W;OHPjlQ+KwnK87u48K*xX=RkM;=3F1Cds@vW=msdH@ zbG+sgJv6(LjvdHEo47);{HGiNvxSopXFjd|8_tMV)g+Sn@Wy&@N>`Boo z;<+OlRfc)L{a(+{Gpj!KYLkev*Fut4gZf0WOmD5g$?^K%XwNi4hhg^ft`=>|_%)Aj z9pi+ilDr5SBo6jGy+*B7vSN@@MTtb^;^(J_Yh54~z`AL(V|1buR2wtTW_!Jw8U4NT znvI`yCpbaq!TFSCIp&EBhA$T4GkQSA>%Hgne^A&`*hH^35S6?~Pf(y5@syh-%c*VJ zD#FKNP*G1bpOsP*s{t7es+qqn{_^LlaAMNo2ZNs2Klz*|@cc|Z_j^B&1vV66kf(>Z zfYVQ}E=1UTFvR~XdQB9#eVl})_y5TN>7w6ZsaYl%P%KK~b%m9;$|vAKj0IMhiaOph z-3PoW6?c>J8Xi$W`(gX@phIQLT3tw4cqqgNzSRJe0GtdJOp&jSI@_6lZ3KuVd0Phr zSx3b*=4#png%S&1=BajcvazM`8#T#7NSp%{!;>J%wq3qfnRhd3Y2Xi=bWpTd70&S+ zsR|_gy(tXzVzw#FxtrC+OJ5O}-n8m%Fdrk;)R_IjBhUme7al0VT#(5WHwxr$d>hdl zf?mbhnmorx->T0NpfGFV7dpg3+CKq9klMY0nbz61&TR;@eB%|c1ZBdsm!Xho)!g&= zis%wO(!wUT31gqjcb6KqA0t772;#mnz(^U9cV!2^lgazq_V$)RPdRgcT5-$u0tb2e zH1>}Os~7lG+8dlJ$=3-J0`I;}%?Rg}vth#?zJm7VMo!j5LKDAB61XsQ z=CsJP`DCM3y-e5x*T--|*_w<=zBs~xia6YJ zoVXY6tgx)j@}Ko!*BUk-{LF&h1y~<;GROTss&2<&Tm6iUF14CYJjHVSUSj{;ZDLI7 zy}0Y8*d}RGL%JV5B=0t9v&)k12aJpO z)$@O}P0LdDH}=~XA71?QC4*M86x`$5cGRPWm|DbXldFMjzMN+k-qAk?Ma(j%ayvdX zfHVQENr!ve0`2|b2AKP{QPU4!>*PBYA2`CQD`1Se9n}!8+Cn^TAY zSSQeHR^O)j?`#AiZtNUCc&Bq=9b>XCU!cv=sV(7mn=5Yndbi~OAxY1dGIhp;TvzQR z5<$~HF`@Y3ks)D>tPLF;?Tz%T{`PG2&0!dr0d#=B9WE{at$?0`k%*18BY;*=T7jMp zKr3Qq@8BqCs%QTtMEjQ`WaMCAZ)WRgV-H|p`2rOHv{HKi6`^Nfg`rjarSIr!YXqQG z`ue2*PxGIt09q9@Lq}5w00YxM6M1<4#|F0l+Moeop{ED1(K7>BS?B>Qtn2_5W(EK& zBNKp?j`bhxf49u6^Z;fi#((JVoWI2Ig)y+R!!WV21O8w7tA~k^`5*jWJ%44`*cbuq z>|g7At@+RVFCG8jU;4gUn1Aj0%VT7t`-lGW|CML_io{>uU+n)w|6|v`>-=s1>S1DG z_=o=X|JupI&iEgnnOFfVEGz&PMz$}xFZ$v!GJp9@#|ZOR_MdpMf5ql+jQ)tt`fb4IwGm!rmGqW@TFw+0c(EsR=(X;x>=6^&0wBn9>mSzV0 z)+S#)%jQ z%VSUgNrXQ&)e!7mvENpgT9#9jlQ?{%o-b8^^6^oBhlGXsJyh-k@l*b3PsX3Z1blO3 z0$1~qWdc(NiL-(o=Zm!Vwgk@FWB%n>w{NU#YiE}Ysm?yNx|Dh)KMkTehAj;&0f79| z&Nu{hbwtkxZwmerWpQ`42ZXA~81%UmZxxQC_4@$;w4`fh3{~R%J|p{n69NUG{{ic z@DyhY#|+5t1(7IZp9FZ8t$RL`tYqRTAg*oN1HRu$Sp+~(4_7vi*s$m0mN+;^IAc_J zT81ub5FX<>3nD!%%E|x>QAn33QC|Y%2Y}#Je=Gglp%rzRm1Y_D2gHE!g2+IWHahz< zLy>ywGP@6v@J9v+OE>Sb6kj9|i-?E_JdHBY5Im4QGn0|ans)y<+T9{xHW%Z}H!-L@ zg1QU+418#G3?1y__oFQkhaXVngA9N+>JZeMz=ee5cXV<#VHc30zA@Zq9p@4(!v_Kc zZ)bZlC0{BMwx<-(z+k6$M>`~BQglRp{_5;qC+?Gt$|pSx^l}pj*O96!u;ZAe6cCM! z3=kw1Vb|&8{wLdqPT^+_1t#zgYjIzg$Ys(w5&0K*!?>l;@9 z2*DXe1!q6~r#3-LqJ~Y(jNufj?C9L%uz+xo33odoyU9&VffrC9uX5j+AwW##GAAj_ ztxOH>lHA5D&w#Spxu@W8JvfljYk;}BGPgW{nmWbTyXm(H`>NSbW;LzvEcwF?G4SV{W|5M+~sr_)iDmZ%I{tvE}9O22>vgV2Tis3B*$; z!(b#F1b*~M<+>I@c@AfE8cMX=f zCci6J@fKJ&6l9U=s4jmJSR3E={Xsn&&14;hdFaD2w7E3|;sn0H%7}p++nC-r!=_4y zjVyS`GGWBcT^~3;9$3QNT|ZOvsP;ML_&qwpi!QYQjQv|yvs=F#=w+8+sY|JRJOg># zbsz>|O1T|fq6Qp*)G$SsSmE;1ogkS6Bo!Ys zLK#1`0r?bjQ-X%;%AkE=bG7y$7q;jbMA669Zfd-Ky2>nHX#6?jQxeSI&ihwq@NZ}L zYwrFXtgjmTUm==F3X-Jw)4$lm7uL+{7bRh1b*DL)gnNoSbfVKBD(_gs0=&YhrUsIp zVdqXIA8DK*GP$u^ErpTn(?#5WmMj}Jf8tF6H=8@awgdu~N$owC=*>(M1#)Y0+H*%n z?ae|f71eW7`4Dg{ua&_}Cl&RQbA|2j)*7Pc7MJYZNG}y-e%ltU=Z2ETtDY=6Zb#?z zrgE(7hJt6|=iU5N#Q%BX&Zhcl>4BSnyc<31H8P2#iP`&}2pN0UGBs#cLDkjv*F-e-Jq-`9o4F*Wy+WQcV>w&;k<_*^5+ zI$CeHcx2`+@thWX7m`E%$AU09E!aV@m+Kj;QZEFnmx5)>ZQEj){7b_!7%yYwGG{_N zt?Ins6-=g#uVtQdpCb$x)VJeDiK{_&NP0x>Ti$rU?#gdGk=k2Uw>HcyCCo})o zo=Zohl5Gwz*VsKZh-2O=aczznq%Qefyw)5kZB3ahlkj(vn9yvWM~-0K;p-`Ny~wub z?GDwlp0lY)!NA-AX`o-gg!jdfa=?z zyyXsUQ?$7Jh6=Z*472o(%c?ax3$1f$RU83}hC7}{zP!j25;PcTm;QAKtS!^~Tu?|o zGCz&&rbuCS=4t)cbRGCA-8(KwxB9bzHF0;UPW~`Zs&HCALsS|-e_!*sEWMQ%{+XfT{PV_oq?qIAB$wNQVd@jBFLc1>))y&sFPG(fpIxYm~2(j-pOP>Y^)EJ#9Uj;wRG(f7R{izRgW&c2}tn}NH{*Dr`sFX0 zNGAR07SeA{lT+)g(dbRvfk5-0mZS?0Z5#*cIuU#4Jj#=mSymzpT>Cxg_fw=$q0tFr zeME~bxb?}fA++Mm5NdFQ(!jQC(^CoZ$xPrpo>o7gu(MIw?BRxldR^qOP{#?BK@ZEJ z9Cz%Gqyv!Em7UU>&eUUsXgly9xnIcaWQ&$1JdaJt74*tK)C9OqRQl1xuqPBZ+NTvV zL^A0gpIM)ErBn4oxOk2h`0}euym}O=5yHh;?uA*e`Vt6c^VT{7c(y7os4m{#*Z*X+ zXuwd1Rc<2b3saml)Cp~7w@TG-qwZ#J4Mc@kzTF*0O37Sitw5|urJ$J}D1JtIfn<^V? z?5{J?Fp51yv^i(_Tbe{)Y&)Hr77I7BMI11$KJpgW(m%S=Mg4}B(7O6svNe0iqK%q* zBku(*LNe=ZGc}nqhyq&JE?HbwZv$Aq3Ze9C&rQ@Xvd(eOU#@9iISAqW0ipYoi*#Xh zNrxliYH(_f3?VPy0B&*3BI+W=e;Dn9I=3`DMpz!dEdQbI<(wG3jx&yXa<$)nC91)N zN7eZ!hw9GaVa0Dsz$Og;+Si3FO>9h>rE>xP3RwXawnsavZseRPfliQoL206EhX~bt z1Tu{(DNA8~YH& z2}#dIX7z4|&u9x2-c%7hZ+gv`V!z49EMlYVXCQ^io!>=i^J&YGJgmCO9Jb2VoWfb7 zCab|*&y-VanD0izz{$WI30dcRDRTO9>krdX=?_A=2gCETI!$0vip}_{=pQxIyeKpF zXP7FC&K)mFx|ZMugKTzgc{=h>NN!68W2W<{_3m^dGBS+_rxJsb_#3_zi_N=~>MkiM z1U-g&(8{4Jx;mn;Q)e$J zuA&C6giE?&($L`l1uk_F0TaNA%_-j|dR+v?rNYV)wpue4yh-RVcdkdzPiv<^uk5vb zIhm*zvvnqtjt4VhD!>M2)N6PP&f+2bZq@{EC;i|$Kt{*BX>{-{emFo=zz8RLyX}B^ znV6f?0;dE(z~0d*po!GCtdiHn99_C*F5{1~dn53xJ-1&gie(jA&zs(CUM0e;rW$vV z!s}RwV6h5Y%(K*~Td|D6!Ip=%om=!rhp3L{vQJ5w*e&~OLg}^w%AQNZQ~>JNQ>!q3 z2(~a+BMpBSr>vpTorQp>4-!aiX`>-ZnDifJn0~iNZRxHR@^mB{Coi7$_xe80JWNF0 zcD)2$lLUptO~NVm-3-C#V!_E#9TTTZqhW6T+k5%&4&Q8pOr~{<%&{n3{M>z%h@64f zF!#z57s-18=6Hf|jR?1np&{!zB_@fFg_Om~@@%z{Jh>b?LsT)|_`y*Waz&z~jj^No zn?%@09k|u}Hb0O3Dg!A&PUX$TSmT+oj&YO(3}wbMA`aV9sZpitfl%M`yuDH#eZ3(n zg>S?w+^1nty$atnxLqavMBH#Ms;3_~7)atUronLS$`)uvcOhGNi7N%Q`l1B7p~)0} zH3RERWYgw%7Bf&l5vj_NPskd2G#g1o^N}v}Mw_y6fi9lqOL=oooJArQLCRO&Ceap! zJyhO0OgL~%DOd^lyhha za=sKFWU|1_&!acuI+!yin40T}?lH}DGG3osD4&~>06{JD3)`j*;~IdgM=tw4U{Er);4^9EV~5k6bcEGiiG6}RWR^5D=_f_e-qQx5xp9IO7Lj<83s22E z43hA??LS#muGk#Nkg{BQ5*387WO+3OHrKd(7-aMe>mNpbI*k`mYZm-^M5T+oz${a;QXeZH^#uyYrmBGe`;?}H%|y3g45i{&i?Epv zK{v~Q0hb=cR|d6LxdL&!y_!6U#^8&(JH3f4X0V|}1r@S0OTnGB6NVt=^;%coH7zmc zOkx&{(0t6-5rhj2u(w37^&Oa!<>xTblflf$;Lbp`Usa?izDq9b4k6caw6g@v8w?Iw z8J<#oN$XvL@;bX6-Uebb*{~&sYm5uX+i(c(M(tPw+(O)McH{?diJ01o39yJA<@P3n zcaFiVHq&<2WlQ$4dvO742!;>9_X0bqfKcUkX%2^A*n=X9fmG8H-=Qi*mQw2vatsN7 z0X1qv;0JT&&%9S`ab?ug=tmp<(2ie|^$YeCrwxsl2gY~Sa-nMu^rSIh!x^$<19PjG zPU#Th(knPd_$J|W2s@l2Yu#ik(d|$(#>iL-F~iQ8$-PAoY4T{wkj$i&qJ%_&@WVFk zMbc;9Q}+b{Yz@j2Ip@RY3CH;~xdhZMyz8_3&cMrpkL$Aj0dHlU+(Edn<4#59^rx2$ z^n74J;fO+%H|LX~S4}jnfpTX{NGloKd&RG`IVa$jYeqlRr`?qO-wyY&URAippmiWH z-JvieeBpha3+(G%5<&oC;)7bm>Aas8k#7V{chP)%JZBvxsLBF0ceBUwg7@2k`=C3N zxn^sD{l;zudFQuvI7evW7ku^rAc_afx;scJsJ6Kk=t4I)d2E^48rT%pZbW5Fq* zd+x#Jq`vQqb9(3eo9JM6Rsk#EwP`sd2HWH`@}N(>4i9AHW39@h^xivi>%d+Svq|i2 z>>iXV{O?;wICVYxsNs$H&1^$Xx2hG zv)Cm#pOZ{n;!E-ny$=rufLMP<fvfO(aGd>%6H4UKLaY}iXle%Hmj;CL?R(%dp6~SUj98&(-#$691g=kPko7QSdb7baz5%>da-nTik+cxsuJ6p#AT{v7ptr!L=92}B6WmXD*j*()ClY{G$gx{OX0c(a z%Go2{!)QpxgRa&?)!3W=nr7*1TM^Yk9cQcmO&+|RRyM^ScJnTPvdY=sIhhHs8uIn1 z;Es`MJm-RGeor5_L|b(4@VASEHFio#pB0vHa9fucS`5 z@iq-zrjxi!xW!vZ@mF0JAS~0X?*|0bC4Ex9Dkl2`JME{OY(oQYMAXJJ5@OTkG;5E| z@Z;Qza*5(W&7D(1^6iSR_eKkHNq(HUwN8b)%fJnFd^H&xzjvNiHp!E;Iyq3M%$7(` zNFaJ|kQal-Tw-u;38FBi_F2reBV~)NcCKuccCS+|!5JZp`=Gy@tjk0-s^lZ&kaBtu zfC?CQiO>?fARt~@I9k!~(i|M~FN=0OS!yt&+yY}x_@`cf)e5FAv{fl1oYxdHIbW&K zE*dSIquViumJiDU7A%W-7*C<{AXbQ^T$YR0gt)j^IX&x#c(xvWy-gF>ldV3xY=3e~ zu$ZyIWrELjVN&cdIG%gie;HI;&2u&rw%DMuCo**jZ5XZJ7$%1?fD#+@+~}8%jw)JL zSA1}xHDlF(kq=Gv(;2S4AJG+L&ga0bdDB{|3l4qhT99|3s3L0_7hRmpa;CR<|9ExaG! zoK=Uz^=6nYQUB1Z9-=^paP_6!w`g7par67s$7zNPKEm_gU5D$&ywJ$kEU#`zdZJfd zpw(vSe*uv=3c@^b0qa%JJ*Zl^q~!t8IV}o(qIivx>g2Kccc9_FY3}wogQO z`3Niu-Yy_6a4IoXE$&GnTP25Ad?canPc@;hIwRjl+y?I+gWOgC7)J>pFKFTWiW(SG z(N@cT%HV?h%gr?X)w=|iwdUr*9rA0M!2r=3y+lH7dgmZ1RV@UPtY(tb>qB}k7S7FT z^{V(iS{9$AJDyqASZ)!6^5Mcaj)S%L;0Xvi%*c7680vRr%{Mm|n?!YddUzjC2JLQ! zgZpjBZ2soH?HBdy6ntQsKnObESwc!k6p5LQJ?pJv^?COw_{W*bxALb|kg?~QnesMH z5Z?P4nbi}deXX*nBXrxM50;;2h__`MrMCERxTV54GnPh}tOom3xi&jziciXPV;g-f zMK8(tkrK`I{GP&HI@hsj{i01WK}4BnFU(CZqkLHz!|2K06BZfmiwh1UgjaVW0AxZl zm&g?M?2Yp2@bN(T?(kjYpKqq7nt(KWsAQsqIvGZ0;lvz;`H3IKeZV((?clj+r%>G1 z_=K3h1XS$MBWz%n4FiX`md3W>yBIR{jImSJRweY*r*r6G9qNoJ}E>1Va~ z_>3#WL+<%Kvy`ozK(!W{JB@cyrWmqCy5d)&Hef-nQ0O12!q)nn4abriSM+$&BoRvx zka$^fIgxXEpj%0;vMoA9;ojIJKLsE!ZJ5o=D@2g@Wwkx5edP;vt z>KS*zhMvy)LZqG5S7l2g%h})qHBo~GZ98)9AuY`X${hxZGGV&+g*U6Gj5VGYvh(DC ztstD^8@$Lk8q2&%JOUV8lu$w2G7wN z#;^$khA5Hi9F;0xlewC2`GJ1kWCw~xH38z&GYH5-6|ed<@DTRN^&@|h?6fSGu`T8cq>#mrJFN0iD83#1c*X0jGAE; z6wRT5NJk%Sz-M@~!d)#(7_(XY^ruZ(jVhp<)?v4}WMG}h}Yw0B~r(Yo_?`WURzVVZx@yI z2|tLV9+$}R9b)dfgbsR?WHYha zWC;+jn^a9N2`dUcpG;A5qye<;B2NJx@8Ee1{ZnF3Y`hzjV&X-~_F^AY6glW~B&3Rw zJ5$tT9}3iw3Xzb3e=n{pwIFJobesd}S(QKxsMdR?^qh6qmam1x0C73=Oz z8_;LbaV>WFX9;Z1nAF-tJ#m&^+9Mze??j1t6K-Kzk{UCLjZg^#h0XtI0@GoT^q28@ zn#A6L=Zf~Stbz=iaKjBu;t=;dEO6=h0he1EsEYXuCt}N>J()#7j>}L7A(9oxglqo* zUS&jv7_t23_q}?x099{3o9x?T%4r;s_{j|~LgM2Ga1N6#n=|0EQWvZvp%hOJ#5)@N z_R`Uqy9)Ve8T~@@brP&QGuI-UD_etde#^KFSkQw=Ml7jr#CpJ2;jKmN`O!24ZW{#Z zI-AJ!KOETN#H5F_8=rebzm>5du4+W2Zok{Q$)aLE>19JXCZth6BN1LRh)Xfsm+bY_ zaz>p9flj9|MK;f?V5@=QKb#SMmyB29SHymXJ+N>=bLm$dW|TL*__{Z`>X%7pEm%t- z!PYZ|8AFakFw_cZo^8bqT$0M*aru0{)9pTEamn zu$UzSMBI2baU-edf~TNu7}`OvcqJ|Md(uc{y-V6zNDSfBEHzm^V0bRE=9`B$@-Bd5 z7ZVK<>BQ|@C(`Ki|m$Nv;rCAF!LHG60UOb2LC|HfGzUi35 zj{!S9b=C;e_5>p*oVRf^@hCTJ>C>U!?3?@1WsX~?WaA@j?2jP}sFxob`V2Y>Lw zoi)4Y=L}x`{-d)Cj_&tXIUFdQD`E~)ng-LyPfMq-Dw6yD!{?M7ZFcb40kc)Ty&jrs zsXU&Li~I)0S#9&qII5wQSiPz(4+C{SXjHBqc}EJU&dN&O8Jhgl2V&yEX}o-^Mlas% z%(-sF;%&zVYl>_EZT3HY%)b^&7Ul3I%$aZF7wl!8x8kF0NLJl;Xw`7gVoU7cmeOJ{ z^idT3S&#AJ-xmEz1-<>=TxRLNi1&?go@gYUf+XH;zi-E9I97{Tv0JTC;R4Z)P4$Fu z##3hF5~bz!KF2Y>KI-;LHMsO!+1=PLL^$!~f_l#&oO>F&T%D(IOw4{&xrh=hKl_r_ zAMo|{La5fU04|LBYDwRe7v6ckUINP-b14@Ji`0~;a)t`k?~5bTikZ?gH#f&6{&;AK z{Bdg4?msDm&5x@CQZoU1p&TvW>jz0$;o#rMh{V&vMen#x&8vBl6gMB0I2rTTIpvr% z;q|Z{*(na{kZWo>kHtKL&bleea;t5I8UG+9<8WMrPjZFfhlyWR&DcM6urrCCUG?c8 zVZ572;G1u-3QOfwZfGPlCT*||II7bdmeal-xRlAzJ)+V23hrpjP36AN zC{*^PS_3QZy>pJq<6${`KoJA{BBb;xSucK&HM{S#`Sc+mx-atg zYnbE((ey0h5Q(k!pl)TciLJj12cQHMY|D}{X90_9{2Z@?G~v%~)LAiToE;yK9awV@ z+rBq*FWMOB*lqr{yIOKM@*>uKa5{978(UhI(swdp9vF#beh6|;IN9Y=$~hg4M-W-P z>%(syj#cqmR%%pFS}V?a;;_jL^*48=d(~sk&EVReY`4f}m?$0VnZ1Ct2Y=K)6Db-%kQ%0NVij z4L9h=yhEmbP)BD~4kXF9YTdY$tTnK#_lO> z$j1!X8>%{n-#Kr%BT4t$ndhV&E%LY@@xlw|ffFO-2>!c)q!o?efba1tg}-c5;as(P zl9e1TjVc|!b@Ah3^6ETlg26Pj?FVOXhMh+*F#wx>Ye5OnE;fcHVK0<4mhEtMd{}De zF9nt)=aCNSS6a?ANIX~{BndUNb^l|8R;hofrSLmRq>r6E7H>mPRn@Os9B(MB$SbD$ zhf4TPN;%Z_w)*(fTWZH**q4*!v9OhAwZot((wMYrp2Ol&5L|`{TOW9jK5ublX06? z%piA|7_Naz)6_sWn4ZuCQef}(Wi7)BGSq7ficyR089OSb1hOIC_wT&C-%ApIE@V5m@5dMBuUap_K-@Vy>ZMJ3w~-~_WQjv)eB=1 z-c zt-(y4=mvk$IcWB76RQ11c!YM37MYAjlcaw3y#d>tTv2}C%t~}LtGTQMUyX>Y zd4r8ijA>j+ktjKVK!S`IrK9svo0Z6z1r|wYipqw8)i6!sfA5uY-C2M+30ePqOKW_ z?C1uurMshI=Yv(|$K2oJ<3}3zM8TY`_o~7~^E7+4IbFP?Jd?BPK}@YWIY3n2;$KJG zq`}7LX}Z?CP8~>1#|ZOl!ExF$S?X|w>q+_=d2GAC5dfKEJvyW9ma z3dbhpadK9Q=@G+-YTa?SHK1Yx+?~kkq+(db1bk_7`J1ljCNgVb(K}QC#9FDQRt#b!ZT4 zSDdLbHg6(@TQN!*gu553>vS0k+0qN4F7u{y1|J7Q8un`#HmLbZ1rk5Jve@oNRBUyj zf1Bgjj$OSHw*;ld=1(cyOiC8bafEHQQX$;nl1t)y0SDL8cgHV@3wNvF+=J!4e8A4w zm6(~~1~UM6R`fZ+!6V@Wy4NC13H$Jy8hyvL{Z_x(u~22a)+I{$<|Pk$8%EeZ32}Mf z{_grtnGf`50;s?`JkuC9IJCcRte}N*F_|x?o?k6_rS4+TG+P4Pj(fzq^j#K4kb#-v zTOdMv?n}SzJ4T=}zMJCpzS{+l-3UH=&jhRbHoKKnwYA&XqBiLBw!x*MbK~PA?l8y{~t4rWz zy|u=%Tk-DEK{J;4IdxWX9Py-U8y8Z%!!F~<1`KRZ5fDUOed{9e5V|b(keog8-_4t%S0}&hU z_Rv;lV@4k>vDAev{Yr{d+wGV{U#MPucogEzuoSNYLRZUiGL4&4&Q)CZU6fN)2_>9k z>>z?*k)9;XxfU-_efc!xrp;Hev%Dy`)%d5Aa%ACjgb5P{XW?uuobAOR*)={#G}D-oFNi{{TFfk5B%I%Ng>2e}#2xG>GD zk?%yYcOxG#6xJO@^1DkNt3rEDqJSosdwtRCpt2(%lNLJlBN|q|_V6fo4lZFr6N#^dEf#v@vUZ)Y z@#2=VYKXpchSyhrG~bDXckN=u7Q06;@Y=}HDr}Ke0dqC>S_>FC>23-sKK-Wpx75O&@Cob zeG^YebB_S9*GgB=QL4?{=A<5TlJ?ELgrlk{28$VM@N0-U7k;n**$UI%ZLUPg+lb&= zcquDs6%IE2Oj}?gWIvym;=aUqFNFEHX{);RY(IAGgVmc1`+SLAb3~|g=wQ(_I#&#+ z-Rz9&@_am(*%lZm1Ug(DTrGk=!sHIw0Sy57PV!g~r_Q2UL6UgO}+e8q2D z{H&uUs}|A9j5W|!DF1fp+T{#6i;`nm&%i9sv^>jc>^ttEY~qudj@Eb`b^-&6A@qTB zub4iN=x}&Uk=&jd75Hd=z-e1KCSrUyZg<2`gd`7_QvHfr8SXH+vo~yC0$!OXx!$2& zJt~kEbA+hCgspo0pjaP*Cr8i6;*PDHUi!JgX|jPbpU$XM42+H z#`?H5NzRNwEWxP`p<`65jCc?|ykJ7k`WPwkt>j~V-zrzGQrUWLY}KloO95wzBIE1QAZ`+%w;V86T5DGh+1YxQ`D|bRAI1eo^_C&N#hgm|~f}7K?lQ_m6 zwULUVHX$L^KoGCkK#lr;SHfjMymR@XcJc*?`k^g%zQ+trx`kxtB^bXc>&QVUWU*ts z2*TCl$BBhjkeJo#x}wE?H@V$8!)5lCxBsR4{DUN}u^1Yi*6Xnnngfv7d`&Rd%(r|y zNPCuV3O*&8M(~stTu&4#l<8!QlOY5~OooS37=WUcfENs=*?Dq$Sz3gH#}dD@B%&(9 zNKx}3v8F^+4-Ag(WHCJc^C^jGn-M&mKDXa(I3Pmp{t@|SzO<6{ep(&V8%n>TE(=Cm zH+o%j21;6OPaI)==DzrtAfO0<1n3LO9e*_wLm>FjGAdeKI;dxGB+awuZU8EmR=hH> z-0>al*=Rbe{dk8Z8b(Q0S zdAkVWL=hMv7}OlyBpmwJnJ_8TQRgp4QGt2oDpi+%Sf7EkHdagm zLH)LIg6O-Fz*V{sM8uqV7(mHUYPH$wz> zh+i>rj`6h|Qn@iGr*bx5_365OKXzS(!=J+3=g&^LRsAFN9Z#R&(Yn!9p7}KW*d-$K-;2DfLax{?bt{1;)lAT_(uhhzg|Hc$&&9cbY07Q@^#vvM8y|02Lt@9fhFyQeD>$L=$!H; zGcI2qDWqdMv~S?=ic@NTtu;UqFPc%L6i24J-1M$=Wt1;noU)Xwlq#t*6Ws-IQU?eX zp6&r7$&ab@CJd>l5a_ujRH`m9Pm_IpnVWQbw!w{(PR)V-U_H1}AhAe9?Fn=H9WY~f zJqr*^!O5_;MvLU0uF>LMdb_|z;i8IMrAm%)<1&D(7im2y&+}I*Zg}&u0=4Y`{oN-P zS>W~A<6xZL_3O;^ZLV$>bCDZ*Vcl!EDbB;Y{;H7=8dd(RI$&ZBr&>R$?2buLvriw- z>|x{kgpaxHFrWaKLr@0>L%#7LRfPo#`~sQsPbmdtT`esWaQFPC70LYgRF-QMbLz#|<|GT+tJYA*ddC_cla?rV{9)wP0FtB8~EsyjB zvgFD!TLG~fJSx!sLa_+gdo}``H3*BDgD&IXy;6L^m{WQtY(*{Xppp2Xd_L7+S?|_k z6*}{_8rvGu!8xXe`ASJ<_M2YN+je)^wr$&WtKYrWz5Cp=$NF%_`7lRh24?(YW{&Y>J`s^WD`S^NY<5Sc zEojE%T#2wo3~rTy(C1ZDd!sIvf;F1%+FQU6_K$|C5bT@)Rmk_6*_PV;?}=03d=T>| z`xP2*#{nXa4f4SE%f&M&>;*r)?HfOg1IX8^!8P*Y&#YcDmaPtcSrwIALb_=~e4&jg zQ*3CwP0yo_ba&wNvndG!1A*h2nM{!vrjv}&pofAj`w17a7Q_WZKm$mS)v*~sT3gkG?G_Zp7^pTenJK(^hmlGw3ogw zsFj2`#0)_#zoK94Np3X4RkG#DIIYyEE9cn;#W$e_Ur_qXkL4j5bX{2eD#bM^JXt#e%jKTXR=<5;rMOg_Z8_PJgk!ZX^ z`R!}6?5f$9#4km@KT_fpIt&#iNTJ(1Ut3dVg7NRTKI-4lgL>5~X1h%w;Gc@_6%HEAJzAQrskEU3%@s7iT7~SHVLoby3=@Kx)-NTH(-z3cktAu z-R{l&V36NW(~tW0<|CM!c5pq^%f`Qs`jfTdtxCdKfJ5?T`6|g({mq-Uct=Ogo)Y-Q z+8>3ny2#AF>N&rxhPc!nQn&YDx66~w)b=If#uDs_=Kx%k;-I~?esPVr&3BI4SDdkH zebz_gf3FLS2HO?s;jTO-u9n0wdEv<;fZ|_Bwy6m9EW}|NN%oSN_^?N5ypxjGshWKqJz>zv34%inmdUEgqzrK&7kX)VF+Ir3aA2j3rIeH-;l7Pf9y zcyOsn-%|?Ah_`4tHJSur5w~iuSs`bMuCjy5djm-sBoxcAan*mJL#Yjk`{`!uN{;<- z5Pip$5hQqWQBiF&d)sRUqQ3rl+XCFf>Pid-$0 zc27B?g3-GGj8dVZy3}b~UYUiw7u$sq6A8umxVjTjfgj;(!ZRlwa;peFKwlI(g9Pt| zSB1tE4g=zqMY9oThc#L~Cbr6OY5=kR=lo)z8v&JaIr3O6Wzx^v3LONm_fpgH3l@fU zPQIt1*TO^XL$Ayi`5=v^n$~;Q>snaGj0p5U@=IBf(qmn*3>mkxP3GSi&=IQU3x!{A znoW9p6#jS2P4*|{8~z0`y}nfG_RO#Ill$&?{g)b5e=4@U^XRTX=Zcp$*-aBC>C70U z;Gl32GP}opVY%MedmOJv>VODGo~Tx}$`nhTh1e!!Vh%IA0%vGH&gSqe$?B7jq6Ln5 zJ>i#3=pI1=4wIiSlUis3TAG7#q=}VzBP*pAP8`G@wq`c@ui03c9G0H0J2ke{h7T>D zIcA0p`}cV-{F|jFM-vtD`%QXMNL4OVF^uXG&njDrZO5-(pH&T5>1l^bF*c$52=%dz2jlD7Jl(p8v7pKJgK?Zu z@Fw0L+2ZzSXvF1?4^fQyK$#i+VN}8Th9gtvLSYECzC2PCF1+6Dpcx}vQtW4ch`8?A zM7Me}Y*ii8<-A5z7I>{5(LYSvtjkxk1^H_;IS7+s@(+0<3x9t{AhY>E8#ObxbM9hV z_8Cl{?Z<1lRBISv**3R%R~RGsGQ?2;!!~Ivy&2idTetKy-4<9kF{x(`XKvs2Q)P50 z<1bt`)!>X9a2kJ+vp_#wQ{4m}*lB}J#8dG&ah3}WEo)LZc|&oFH>J@xwd8D6_`?p( zpIyuGxjMfl>?B{}Ce*R2QPQCimk_S%x)*sSRma$ihr4ei?q=o2Q#5v5yMK;+JWx%= zxyGzH#bU%%#HxX=i>n%R$MD%Di?`gWxY!%!=VfN}?hL@MYA(ht5BctCMQxK1gl%Fj;n4OA5E{t_A|B5MdJ&$3^eSv)l~Uknsw$$&rZCVWFO^T&CFw zn2HDr!s|Miv>8ghuyRd{bWhxP^a^nDTXAt=HGl%8-~iewoX8dK9+m{|?+w=XfWP0x zz;Bfz8!+fe|8y4#2raoeOo*6&VvxV;AD4?Uw2;*hID1S*sfwwzqy$)I%J{r+=A*^2en->JzU0K*Cf z6`}UgAo_^~ON4vZtJ_9!@0=TbIxoYyXnB(5pf>IFg3`K0@(CJ+=Nfs#==Xa?BS!nOSQ0NPQ|lMgp-j|Ag(k$5G)}DnH^_!Ra}dowE8d=3 zV-+?~h(n3V9C5AdYHVUTt((Og{6XD}g|60{XJSY>3%sYR967qa4@^h{)ps&})TGoU zrI%EqdxTlnX)4#QzH%rH^$rOOgz^ip8FtXCt)<)W8PF7Z(Lg~fKxX*Z!*b{9OTget zKe_1~TZ@U@Ep%ljmu6{aMtCLl4mJJ=1R;yw)upi`j8Ie}X&%qWXwhR6Y>*m`^mTtS zbD!Q5fw2Y9>8VGhjvuY}YhhQhQVXFpMLou@8P}GpKNHiPOXOmNvka`F9-JY64mIUC_|} z8|iKMuhH(~>8mWMrVR7~2VHD6_7+&@3Th0E# zUSxxCTE#8N_*jw%@Mg)q$tEVp@X4q6(wT?etzjveOIzr*Eu?KnX z;g7iHNbe2?Ec6KGLV$3k(e|TnYCXCjY~1p|@sETolo65oNTt$P7wjG>GkjfSGNVGD zc+KsTHGWTfr$$$~@G{34B!=s4SS3rm6M4v>q^(7lMPLq0#!aY{{6o(eK+q$pH{K{{Ye1 zzS8~F+96lfEacfZa`ldma2vRdY84;rouAM0_ogDBl>)u6oCt$9-dI*wDmHttz*Ug* znYcNFOWP3fITQkR<1?^k!<{CMZkI<7{9E~wxNrebqFQLcR1{}=&Hx53)T@r#{G0cK zS+05$ID=Z5xFlgLxewe2OT4Aff(vCr6-X@}jRqB+6j8z3*Y0JaR=7CwU6atH zzdvvCFoV5DIb*xG=jZZbGQ57J=3e(HGx?JKxo|b`==e$F9PJ)~ZK<$2U>FmH3dfSe z)_;TR+_vvv1jtW3Z9jI^b^+q|Ih!0_@=m6plFJ_#xu3;nF_{;O)IQIl^s8DlaHb}f zkhg+IN38+zx8t~8>?^T50H8}31L^Cgn6m1q)F3@vZ+o9OC^>}pK%8b!LiXEZVMzuX zqd)E;)BKz(TinX;1=4QGP_PMJ-}b@XW^FsF3Djifa~Va_(wI8yoip`NU?XUj{D72; zlMK+$BO9p!xgdNeRK2Ikpda+6%}^A{@c>`H_18fG4g>h}7juLH%;G$0(YL#O!sa&= z_zp`-f32LGF86hZ7r31Hj1QcprsfOf8VjF1;@s*_g7q_BOSRHgA}qc<#RwgeKXtgC zJLbe6bJuz<_}8Ya0h0nIUkXNO&T;@1%QsAbBXIm4T&){+T(dPb!?i=+-(3%hc0^r#Vt8K# z{i%kHGkP#PXM=^1A(l$&r#X%`3_@@Qin9WI%JWz_Nwm3u&`zoIl|{* zCf>(Q85T_`E8oq4)9eMvx}93^$4v_Gk;04Nuw(73UhaTMjP0G@Pi|;p-CfcTmp4a_p@1Dh1D z^X#Jn@6{O^P0ZGoU(;dUX~rINnu(9OF~NTE2=7CiDx+V~Lib&X^7~Bk?>SedqZH4p z0SUMnIwsr>KnvAmF)CmSI|W?rL(s=gJ#oXaQwQssB@KZ{YB!{`65oJixu5s&u2l7Z zWigN>7o@4aOhw?A|3)geij)Pcxg=+DO!Ma;hi)bx5FlH;$ayUPHDX+YOD7;rl2^#% z@>S)J=~a8W`qXEfpsVTV6-{&GSo$c zj~FPcqtdOFv@CKa_iPpUhwkhI9p@pO}5Sk%e`-z z+shA;wl#C&CL!P@`uj@s!;n;`O=KLG)gl8~*ZR*>uow?2CnNF~%d^LlU)reb(icg> zp@UZZb(emijSd?`9v6#FKzzXTFg&S>)461Yf@P4XvT?N_o%FT>~!JR%;s6NpYpgY#OUBd3Ga`} zQwbtZcaO|i!kRJ}{o z1MIm2mhT#BRJGN5!J7?sOwXZSPMA=fdwq_MOF#G@u@_7v@;;n=olU-sl~}VEKgQ^T zXnvdeP+vySTR-fQM1**OT}yeJCDzS|+avMf^$-mC6$_q>1;V`g%u#5#U)1G)tX+Zn zDGZ>sDQxp%dg$iZjv6WoaF&zZ{9rdYZAhffv-SIFjBu5!hM)7Zc7S?gOPu-Q7)pz; z+L?S<^~RE5cRItF2g8`D(Gy1l0*lhMrVUj|OY@*Iq-*S!VLNrK^yKos1q9Jfvm&+K zIuRW$Dis=Hz}OYN1Y9(n>q`pE_f-ILPJ7D>Qfavm|6rwjDm+`7t^xveML1EotfM0+Q#uO^Q$!;z0>~rP^GL8t|j5G5|Fk=x2lmydU~GXQi#Cy%vUj zHIVNqOuGxjJgED0O9h#h$GDAPPO&oC*CD1Z4Ki{|EHaYjWnH@$ns~JiR@9vBpyN7) zVfmx#u<||7+hE&Y&x8gz(_c~>ObiMFeS&Rq!Y0dlwl9G-YUz}R_)~-EN^~BF@t$ts zoQV-1Jw9n6@T>?Sgp;3vb$#~PAXGpnc2ZTc7Gq+Z+QIh>{eCC>B(g~?X6Q2Ei7Zdl z@6UiL#Mkn7kk->=Yvx|W!dy& zt#kX26?ci?Fx@A@Pg!Oo#h5sGNliBL6IkqaVS84nNRJe?Jd!Nra@2ay_bC?=bS@r! zHo;aJ%gZ&KUIhXfD(d9M@P_yiosH?vHKlVpIlKck@=aPTWcvw#({hrN~su7*0pnG zBu=Z21%gAGF-ta?*fU;Z8+YZ9Ks&kw6<;TMbGe&T-O1J{l{WD=A>JUy`oNL5BV1RE z71<{S6rsWaX709Q?OoK-Jo^6I#9qC^x4qVEHz(#$uwqA3}=1= zPt^dBv!d`nBY@S*Bf-`?v9svV+q4-WDY-7gm{>^%V0V@C7CYEzYy?Wf+N6G0I|MUb z$XS3`CGpi#5;}};vaqC*pH>mQJ!8Zd{}O0p z_N>(y*DL1sL?D~n-Yr{Kw-L_=5>d*45-TQ9o5ZOSh3WT`)yr+$*6mR)Y%}86i#)Wq z3e5uyJ)icvFJ}80=XY{eT?2W7i>R-O3hu z(LjT1L$R|ESj;D+(+_@1@o{eXbRxXX`auDano<4!ejdb~5Imq}!!u{5UoVYB_r^qW z1^`!{i;KF^r51740@8;HY;T0aA2VC_z!MoWlz7r!8?=!=>W->d3u};Th5Xx^_`b{) z*!~W7AUEWt$wAL$yfrD>tRH9V1|{BZT`X;9U?@3JQ@tld^|4lNMV3WPGii%0P zc{sbDoD8ctW4XKYXf8K+&>~U11$(xfdR{DwP60Z|-adiFqvS#XhYRN#&^=m(VtQY? zk}95ptyh|92%nR0bS2lIwQj%MLID00Mo0too!@w8Km&=32PL2rMw^(K(9pJI@fwsJ9Rr-SzJNg0L-@d5_wQVG?qj0CaJdcQB7b&^E$BbG@$lBUiHN zEz*QsRH$2$gKshy0Dy_|)vJLvz5=3&G5}JP{r&hvxlYNv+SXm|+BJDJ*WOFz7XPCLN?Zu*3ttCdxX*ta*dy!y1Px|j#SCi zUa&FMu$rw#Qa|9@a*-uK+%*;>`XH0YZ!p2cL_|m?28sE`Xjpvgw+z60y_D@Q$Y9uH zZo|M2abmpe;V>fGjX#Y}Ge&qvL8pcSz@9@yHo|#PE~EL8!@4hC8p9Z6zgIw{K@Pw} z|JGOl+`Y&N#Z1Wdm#|&Sr}F~M=BclBS`^@)#kDl~%@>n@?Al$}nKr3MLI^{d^J=Yh zpu8`(AP=6;bfc1rGpL&mwFk&P%Aj)OZjr~+*=O=lGD|QracI@+-(Srp|CWTsorrX` z{dC`p_~%HA^TYi*()H5S7ynUs9s#{LM;1}!h7l5l(Z(;m7$j>?O4t)hPSEWA#JxKJ zMz2c^p3SmO+B|Rp?{!PDTPDJYZI?JTf*aF-6fp1|lOmDX@HVOf;L`{WSSOo|4b7%2 z1NtTUk7BOj4I#x8+pEC$YTaJTxJUZi(INT>V+-m@=Ubmy3u}6g@0Vc;pQg+J0h6fD zydp3E*=EIi1k>{Jiy4G1La7tVjbb*T5pmL|*{vwuigt*&totpEAA3UURvsdx3(TuN zXAX6P*;(;bFw-04O7^T3=hrXU=z+U0dB{Q6#df5(0pIgw7(&ulcP}V42Q>3B*?rrw zsw=K~mA#qO#3meBN0noeYJeOv(PQMi&9y~U1O3P*_IM<@Oz!emZJ<@O)YP3?G((2x zc!AQ*=TVjUE1+)okKt4(59J1e3;FLXmRK~3?>2$ni;@&}bq9Sd3L(XgQ)$9V*A$ds z9PZR?9wBkllb52;DGG0*HSwBkHuyMANUm)ijMvao!Ty1AYEKmfuVuX6PdV`D*Mr*( zam21S7I17~x~lcas0(!hl<&UONqdYwy19%82yTfvS0IpY4b9A##9=?9ls21vZ=uOn z809>KEVM0^%{|T@_KSVCi`6iUQs0wB%CljoRk%HMBKlTF&g(TsseeLcfheA|4)jdm zh8A{<9g>uYY#hUb&*1J#*x-1E1EqE9hWIgA$k_;wX;qMp=}O}Um`qU=9=m4=I1XONz_ClD14E|{X6*f-`O~*J zEW*v}`aYRLK4@ogb0l8}^{tO%nWQG0RejZ|G=k8tnBUFA6S92pitawcR^$^YlfKq0 zY`y6#oc^OYM#nOSj(5`vdjNJJBS!feY>72r|B@c_gLiHP&B$FYtA~1@A#yVwaE|A3 zh9Lmve5&WQ{*`yB(r$M37SC-PkSCsYA~3dXL>RH*QC9{mq8$e%gaCihxy<06heoW~ zEwa!rJf)@#H%eu36G#ip(75kj7ZQUn86Rquw5rYJyr2T{$V1FGN# zzN495J~?WcrA(Z0MyG+;xVW<#{4MX}Y8n=t&b{|eCBW! z8!yNM)=Zy+G5e6@+-~#I>qLbGf_S$;x2Pk6f#C|w59f>XI*l#3tUO@`$Y80yvhD(e z4TWB1vQh)_Q<}$koWL+xi*e$^QzunB);pN{4oPn_`AS^6_j}u2QV1T%DnGDdWz$=J z%LJBFK6eHUP_x++U$%E~(*y0iEu7b{XGL(C7f~73SGSJ8I$(%Q({*~i@UshHd8rB^ zGkL)G*NMJU%8jQFzO;|!R1F$|3s`bIFYc5VMst7OSpgAw_&eM4P#}Am#DO~=l|y^W zSVKu(un$cx^Nrf4RG>^aSxOby57XhJW(I(8cnTUygOgIlZ;5_9ObKmm0y6mi(kF2) zVTiaGt88?JY>B`SWJq-hX$4?jnBp7m@5*g*T^3Rgu|mBZgJ+ZEVUwL4b0s7UgnT$Q zFFnfO13gWOpyl4KkZtebc8hzXq9YM*J!_EYRYFnR)D_bSjqg3>vJa~wmu*M!nb1I5JzY1r$$I3U#?1DXTs+ir_5l=Vy! zgJm$Bw8JhV3kNx&byM&?NjXnk`!z$y?PDp~e+4PlKj%m=g0qYl-6zE*#pi+(k-mv~ z#gG%Wkup2JPTg@;^xky)sN>?O2Do5HLEN}Jk3ZNV<4L$DCvXTOhZsVDbI@VFN_ma` zyZy{QNJQQXagaHcYi9&YyFq*x+4{28X>buLas>;YC(+dd-mkU1YnYfA#D=^s2v_L- zvm?dqLQZe!tKiKZ6Py4U+Ft5~12|s8C1$eRPkxQQ84@!aSPhTx_ndJ;b3WSj04g*E z_N|-Gh98wdkFmyDDysA(hrYqOZ@5*lO1#xJRd%P$a zty<>w`SUu1ruD~rs`mlg2`^0(G<Ct)(p|#UYJr9Dy~MuUE($ z-Gp#fk_@#v3@V~a)hgu?mmUq}u(yluo3=iIDq|2L;dO;lP#sY*p3WdlXoi!`chn+u z8YMV8<{oJyd@^TPP=N!|w>9QJ=WtZW+C;<==>UBKw`Av3k*M-&RCB}BN!%yVIHGkp z^==5H&{#aoWg-I~07kY_<$=kjwyKUzwa?VyT!N&aEzn;s-gOl7q(3dnyqww;S{|VB zPLo$`YWQO@oRDxs9I;;;0O0ZU=RncV`LJ|& z_*@K36+Z6H+0`MMSd#mIiASJW$T^`MUiJ-zaKio`A(0t=`-XZK`L?vPA1XSRpjV3E zeqt#j=fpK>ne4+1RZUmX%)H_Evmw2Abu5LOas|T3{0HujD$YsBc2?0VA&9cm+-g-4 zKWmKKQwR*hLmp0W`sMCc4~GiNraafX`teBDnCEk(DaOd$Zf!0TvPhXDb?I1Px9VZi z?m7a!WkBGDAqc~9g=2ct26UUvL&pf zsAm~4qB6x2UWi4nG{MnNL)=^iOcI|D3b2#9UFd>1rUJkIOMZ7e$DVzVgN_3|9-73# zJSGr07GI&tP7f$=^AAK#uq^`Gfa8@7|C{;!B(;riHQAh|z+;CnR2Z&B2Jf`8R0O8K zPgK_~{EXD={2CKZ_mty;zyc`V?;10eg)aDdx8v6E8E}085+*rLhmq}U&sHZoN|M<< z#IE_-8sGgPvREFPn4fhVr2F)xNpl&)eL7`I)BJQ7Jynnhh9lFgIna~(ve2I+3t#)P zk#5)*n3h#!v0}^gkZz3#J|>6J=(Q?;*w8-N^wh^!wLDn8BPYdvGbDqMhJG~WzSJAp z@u@3{c`T}<4cxOD3o=}7@*w?y)$B0d9ijr@n-;6>+r&vY{SD-Q;kSXJ*O@>0?QuJ zNBVC~>Q==RXSuZ2$e~39eENLKX);g*&T5NW%QF#mi7=hwxd~e=l31cc)pBspFf@EmJQHG30E3$9pf680EWc#A?Xe-nic-4$QgN%@E-2EBjaeZ5h@hsflC*heOy@Ly+j>7(g7h(tovF@K0iI-aH^)8;Z!4+pdS_Z$|0=S)6|O zbF$_KfGLA8dH5+P5G7HV3xe$)5zxuPI}!9;!OSji%(C8q!tBwkMi*u(3`(_UqOjM8o|t z5-dLRq?3+#xBd_2EVhqxLW<7A_%N|u13;Papr@#jt@Gi2lbXfXs5KmB97Iuma<0zY zz}lNjhM9^PkkM^JhZ2Txo&_hOPx2er`HAa%8k{|#AE|81 zY9Pmr$#QMRBrj%qVhBo)lC z;fYw8kz4A;1;h)MM@ZvJ>QsvXkP54Xj`I-KELH8l2H>!H&^kBKMoh}*+S05D(7X;; zFEfZBLa^C^*Sf(rA2u+7tUf&^OL%Rk_X#HeM%Jc5@o(K^ND6}Hz!a9`3>>Ts@dheb z2P7ANCEycK%=pbhARxvF<($1@!EFmOgcmDnZvn@=76~=9V|kblcNe#lIVU!PO-cV5 zfFdf1EQ6P)V~2zAnKv4fxlF_KNANZ52UGaq35U#m7+4rbPeNz(g}j&QyDlz4=k%H9 zWW`xU)+JT>;3#BSobC7UL_2f|xlDu`;Zs_1P=|6>t6yR$Gmcz_WP+nLKq&w%;7i7O z?Aq@lYmr!myr1`Hu#`lm7-po*IXjp757z-|%ayej*{fwSr$%89Gb*6Ge4&*Y6Vln%?Y# z{wk|rBm`{W(a>DtHhDJTRN|HiWg`I z`Sh1dDrIzUFWaI2!6QlpM%C1pWiz&ifH_oa!|jaNqyXsM$`x-5(zaO|!+HMn6`TIF zLQoN+gY45mIV|rfVUWT=SMNK~&2szRFCOiuk;t^9>CFuQ1%& z7+Ixcm;~sx)YQ#>wI>z6h)mTnIoZu~WO0!_VenlCVA&nObQ6&9W50DB&1Cko6)A!n zQDc&tG@bNlz}&3!%smxk>tFG}bA}aqWYIr*XLvaNak{Pkc>!N9@Y)`7dpUkT%{Ge% zbiC!IjxxdjseYsgY;D&@6#>iL0LFLPTFzf;v~WMJ@>T!KFp_m@_f6>5B!a0cJPz)MHo`#wuj)|@FJ8^P; z5q?Br(VH&B!TH0u@~})^&ooSWKwEDutd(FyYskh8w#)P1XMDshiq(YOR!Czpesl<` zIxwB6XN$r{A$^9num%iGqU%L;IteiSkK>9UMvBl^UbMZf7u`X3{@w%RHMq;whSlry z6!&3R9}Ejv^F+DyB$8~u%L)ke?KB>d05y&~8{YVtc2sdsMc~g-XU2A>PqvUV<@Ivec1XIhOfe=8%BT=)gP|7-9wtTEl9B|c zANrXc1wAWG6fPkuvuK66rWG(Tv;y_^W&4HphSr}*rEG&`1vQhc0+(dDH%S1vXL#l?!UYseog_u zaMt1>Wi+Beh0FQE=MnPqDDO4ynI7nCG`cf8f^QqfntYE z>IA;0@!4*T`KKwg>0LVwI#t!qPweziBc_7u|8ZU{a0(^qlRGW;{N#A3$I;$&+xS85 zjrf9wvWwd1ya_p+uaXJ3`_UPFJAJx7)6-eNmCe&9!)~3u3_6idrKVZ?r%GNpbJ2wP zfFBPVUP_96FTMGU;MGbKcJxv852d)7iHyBY)XZW*A>|YSIv1IJ3zj@^^byYuPa+!D zUfmzhh8_GZut{3XU)aFW9On{f`XI(G`IM~%8M;xVxw941Kk`Du1;{JIfylehL?($g zGl;F~huc4M&#*wT&~xeK07&w+Uq4$d*uJ-YUMZe4)FP5br^VZ2o2kJWWyKx7)0Jv|jT*Ym2PXwhibhJd z;c!olLR?StH=&e|Mt)#DL=7t`8DdgtWhI5eb*3^{CU|v8p67_!?3ak!&g-ec9;PvN4?xi=$qNO$`ju92- z%U|+|ESJqo!=blLEYDW>WLJx@f2>&EUhkr;R2IU1>FmBiTUU3}7HST^G)QIaK6bQp zTq};CTW&xM2JYVwhGrIOM0iK8S5o=~3W4?-!i-!=Q3(p_ z^^+rHW2@6j=nQ|8V;7kPN{}bnJ;80^nh@}4vRlhy{U$f!qX1JcIxOB!OhB<6w$x!KbrgH0~a5yg^j#l)A30XULc0dL! znlQ!B`8CPI9PxH9IX+!AkvUpgs^xm_J9?>Sq|Aver8+m2O3NLqsFLpqVjzJxJ%TPi z$YO&l1ftGKJLII>@NFLQELkKaza6I5n5z? zn6_m%%vPyK)()?@3WYe1+5B(MmKAIzUmVDPxDOek{Z?jisGG4R`QaFM_obI4hn2GJ zRCZT4?lVY>D^DHH7`0@iz^*60kiHirX4}}kdGjVBi=hipzcw^Irr&)UD8Du^_$dLJ zJ%~YAJ>uo9rpYMq=TcDa@zTfOAX7Px091W#SgD{~?i1HuUt0`(;E9j|N$I6GCi?dAZQegT$cRPq`ar0+&Or7m_mg;*X+0xG)#k=6Q9Y*jc)(`gfB2s z(#|0_3yV~*g9gUTY)t;vJA)s}7M!D<*oKfy@0WzvjZQ*l%Q^mlBFAu@$Wta?%5K|1 zQ}*_Qt9Er8)!)vaqu{aZi@v4q$c&>qDE{E)ErfdjMI0nO?Dp)BFhzAS2V`25s;tjv zTRd0ENnT_Eb@=Xc+h{w`KaZ_oO72$>9AJ(#K23W3TVp?0X%$_jcDka_h+oAGhpD@Z zlCk~lS^YS55A-w|T69_c3efsF4WaE`cg3VjT?jOH`aE@%gq{2D~YmWw_*6SAEH<`tj<7d?{^CdWk3VBBX+7DDQxE)PUpxEVR z63my3irn1C;+$qDqar(k!3q4jUxDS&q@8rwXm<><51X~#P-g<&nA)~JO9FP}DQQ*7 z9f?9KFUjOc^}ZTyEEHRdGbD=xS??}3?S?@$1{;vE=VoC5SuAG?0f^QZ-G2QXBoJi& zDV2jy-FD916nzGIJ;@Jm8L`v8(NAJf1(GFtc0k$3o=~Go_nv5}WdrCUxSj4(hsvR7 zpW+f*a8J*VmS?j3HK~;WrgqdMPfk}DUqR=@*}%=`MngYti4}+j5@U7trDfV0E`DR# z33cT)RY}Chyx)SG<9d5WLGRx}baQEIqWr#|@WXsC|EHx!cr~hxPJ1LC+_?U98K?>Z z){zX5^&^R@b~P)8&j9Th7k3x}I6Y$=eo5?cf{?tQ`Xl2K?GXo%53^-4R4^af#ZdYctc2jj-0r~ zoT3+0>6m1#q>ldZiyuk}!|Lc}1jpl204>bSkavSG9rqfS^J=+ z&jh`$AwRJ}%(KVqu;ytplZ5BzLnfs(nRIscYN-#tzf>322mJXsY~WT39OQt9!GFsx z_#Uj?6O&6Ik^w8e?%M0_S&5Ei(PX=s9^7^@AA`?qtHY%oV*FrzExJog?~gvwbojP1NlrfL8^lyw!ahkUilq65IIJ3tiAt#t;55Hw@$9ghdtK=qe-26n) zipIJ}{G&;z2uM(>{Ze~a$80Ordeo9BLf~XGxnvl-RGDSWTpzVfzzJUh8FFm4A4EIF z#PRLQlJX?5lQi=DIq3(!@|u__{)jg2JY@^W5H7t5U9J9|6AxzKf@fuQ{}!ri^?Bhf z7jTWPs9;=!_f%nUiIMnZlSJ>yFlvGv3o0)S>Dug2PEY<|ecRU_Ms(1AX6FP!Lu;G8aVyw(VcUKF z)kvH$6q0!=-&5Mm&GIddA7hh0HU=v=MM*UJd~dw%9ALpWJ^=Xkc6Ur}UJAq-f#P5{ zO_6FkBV~ZO=Jo7GbVmDqpR;e+oAWgBGva^+cxN#(=PqDZ1>oS>Vj>(Ed)+bmre!xJ zOO%MdIOvBm9vvFmAxHfe^`!;leK)>;k~S#&1@eA}-t@6ZDet)w7}~jQBZS zTuFO#fU9Oj_mGCDhO+cchYCGO3i_nEC|gJhjo9UgmG8?z5iO09os;um=t}%((3Jua z(yjoQZD}4`CMMF@vRo$wG)_x9FwDaIX2au;fKQsLr)&{`19BQ_YJxH%sCoWC|J~=9 zx(ks-&Mb#!JyP!f4t)`wLSacxxqfoG8V!0X8ILu;hbqTX z5=0r;+Fr;Fs9->30>&J{BXg&YMCtS(C!ZtZlYEdUz_J~SaB^eXJ(H>chNh&e*PFip z$hW8-nA?g6!}F$^#A*`lbWfDFvkSH-FL8~Pyd2vwA1rzazBT`4#I6KAq3}Vx!Msr2 z79wht*9Qd8-QUFVmE`Apm58VcwNtqc7Z_f|4kUn3?B#Z|7G?@PSvH)Uas1W_uZ&YJR#}lM(gg)^_yZAxHoRylUpwAkP7IMhsG+J?x+Z zHT3s$eIaNknocQIp44#hwCF(1=8*2$ZvYdZ89MXwC9%~LEr}2UF*cBULl5rLe%3R{&&V{5o{S?R#SXcBCX^?TSiju0K#rkk9gBI+r!N&-9&lmLIDS1f4V#F(a!Zf zu`}UPsGPnSEDxrVRk~_EACsRw{|Ni!v78nK1g=WJ_asQT0xKbkx4d!Y_f_0EyHn zTWg2jjYt2Il%=#zE0&Z5n|+a1RQ5y+pxFYcfX$rvDlNFxoWE2XsCPBR#`IQFegRJo1L9vYg(x8dY!uHKXX8UFoGki0VnZG%|-^ks+j9^yQZ}#usy#JQ6d^4Sy z|KfVTjg9%6c>8UP%pBjuSQaQ|7Iysqzy0;Y{EY_woBwY=e~;Oj*zh^N`}*tupZ4EA z{^tMH@ts2bThHGzCYHZk;%~n4-|~OeXQKb+DgUd@-~9hz|F5op_wzUX>xY@?yRUEi zXN-Tx``yPs8o%|jGJfm*2IR7R^OygQfr*g~pZS}K`?v1jc(H$jdH>-kf1m%Y`;U)r zelyEA+4`@Kf8zJuj^nS-zrMeXh4mY6{4dSl=|8&ut?94+zit1<>fh;iO#d0z-}8U! z{XJ)A{^$5_eEzBTU+uox&;J!8CYJw-*FR<7d4IM1E&Ip*bsabuzVrTD%>F+t@?UuN zzwgU`W0AiF|0gW+H=p=_#v(KQ#Uj&xU*zwb>)XfwfJJ8eU$Dr3S>gX17Mbn;78d!x zlgR%Q7MYQQ^&9B?FY@vKjzwl+_)l15rG>RcUg|8MSuv~jj<`g)llaZw#Vd|%vm4|D z1Y%+>g^i8@zK$+L@m~|)Smf(0xU$lD>dZ=hpNzONW%S1-Y^4XZNVT%WGXRR zJ9h^QGjk`%G5`G+Kx<3~VB_QCVf<@3K-320U||dd1Kt3g%t1Dg6ODn^099LK3y_oh zA6o!u1>KlZS~wYe!qi zdY}u?!Ww7EliI}a84G8Sy zh>ZL|P~5@+WDL1@cb5OWtrghT73}#pFtq@im_B%6;%vvF4z{p&2FZy3Jq2Pyezci^ zoB&*`tgJkITmXjv;-;@|)!Qa zwD_A8>*IzpU{hNF-+#D6F70pr02Y_O1A_MNY@q}EaRh)x!4?w7AOP)S*z2-#u^K~u zvHkxJ{=b&|Um^dn%l}u@{|_TcXKU-f#%ceW@W10g8w+dqzh^+=*x3n^6K`xGnF0Qv zxtgH=Wbzx3iG{Px{|w7G0U_BT3O2L;?_~m5EF2{*+(0Hu7EZ?I{|TYL2h<;u&)NbE zQnGclc#s%v9AxeE zXkZ7hsF{PF7&rhd@<1CSlSd0DfJMvVAH)SaAWI4p?|C)Fq zE6g94@Ij#CBV>bcRI~w^J>du;X=?fiArwuY%!d#(wSI)050jq^b3NcE;}C`>wve*m z`1DMke~gxoMhH(chlkw%#{!`WG=@aY<84968Ur1kIL8hlYvcfWvWgwT*9K_($0P`6 zhlh9k#{gk%42d*r>nAS(VQvO;uz{$Ok+tKa8R7u&$?g#9wof30w5_8x(9!(S1Ys>I z@%Ww(_xl7w_$vOnfCEC<(b>+<;UO0PF+wOq0?Qg`^Js#Qws*F50zvrwM*#jAflvoK z+Za7ah}omt9Dm(C#7Bom6NJ7U$N^Gko~(xW0JMQv9Up4SKUTiKPy6#IPKY~pkZK3E z2AMvwvi)uS*JOxiK*xtI9IYOW5YOzaogZE0e0U7or&$6KSr&75J9E&ZFPz+e5x1~? zWXK8e<E|*AAEkArCfXu+t^tAY2{}9Zy1UMhEEF+gxZrb zzzX4H^#nplJt-%U4u|DY64@TA7x)Q;u(EvuA*}44z=u?L0wJs%p1_AZegYw^oSr}k zE9WN=!ph|dgs^gbQZXT{+@3%PEB7Z5!ph?bd{BC@$x|I;d#Fz!n}69JM9~>+26S+? zu?9Ln;r39XoGh$Op1j9HnKH2eK}w3n6Q3Tc)&Eo)wg-)Iv;!JHS^l6e|7u(w1m@4y zh3!FF{%l^@9)#sz?F-w3x;$xM*dFvn=_%&Tav@#Ex z<7n#iuhPNxAU*9eX>0Q!Mo(Lt2RZtq_jypHKboHhQTpHR z=RutQkM@V{fBK&XrTVi0VtbIQKRY0{2hIAk1!8*;u7CAFY!CAFM-#;MAYuRRg4iCE z?Eh$k*d8VtbG>#iy9_f0`k-2l@Kn7=4hhKjQh1 zM%~!i0n&Ro{q;=+Nu~edzdo2jAUBXP^30U2@vA_~%D|?}a#2E8ru8AgajJFA_jF92 zGY-wpS7-=HbY(wfEBSw}SZ!)hbJsW$(<3rj&zq>DnpfR@GHBHxN9vuDnsk zEr)VbG{zLA9;xe}KS7mklrf1<4)4T7j7X1p68-SHa%C4n|RG0ZufY(gE066kV^mu3lSkOeQ>}WEO%&_lg~4LOtGZBqn;aovLKZMFI&T=Yf(TL7p>WIv~W?p9SxT_ zeXh7t4V4j?g9|tO+?SyN%h061^=+*yvZD@sq2(}K4q~+WfQ>N6ejwz$l}sF_Mn|3) z87q`suDiQQ_KfaToUgJvN-ar%*K86E+BVl`*)((WNQ&E_?glnNH#pSf=%#IMJ|mwm z=^7KGWDJSPA77Wx)NlhP%s)?xDx+b=d?p>|{aB@7P}v zo+;xN$A%*o{bW_-_^b-s0OQn07F(Y4qV;{>^qONtTGqD^6*b8yRStbGJH9_sS$TY>uAWP4HTz#=D+v05iA2pf&w!Fw^7zfU5pb( ztv~(N@q4ioIV}6ZHV~A#P2h%@YO3r=RGv8)8sRUI$aNgEfstGYgX7#D&(@UR+S9i8 z<+$FgfNv*d!4$QB`GP^^XkY}__!s^&14Jv_TMrEHQ*DxBk3jK4ClR!G-uw^Nioel` zwG+Gd1roHnzL>riji+_ERr{#$3kHVQ?4xd41xu5whJ3ed%=Oq7ky_F33`LXiERk{s ztn1fC7;T*d1B62sO)^t{CVJOX1tsef*KPCn;f^mfR2a;|DSmKlRJ_nL3|JUC5zPtL z47%noHFi`jb4k2t-FFHcZ z(i6{t^Ih_>yNBCmE?8r<@V?tvB!_sTk$T8389!e(G}vB>F;0I|lM7@@o%)TH-`qUz z6|7xiAv43JmOmK~k|@0=*D`zSMHLL6cGf3H1=2amTDEYK&-v6tnH(#n1ww%N%v=U) zxg@AbJ~PAZB>*y+9GZ$7!u6*Grj(ncN1boD{47Geo#vpq2LDKX*84%aGVo;W{>H_= z^&DVW%Z-2`lF$-<*HW_2a-1}5J64m)@cQ@Ra}p3z*&CP7F(pT+A|K`f&cGz}ujabJ zNOajSC7L~$H1r!bA#bz*Y3}67ao4g?hm=Zt7bXqURD*Gu56l@y{p*8GYq_64$MpV znvB6Wxm^)}NSe``-O!6M%~rEs=Ba7)CrR&hvFl?7Uud1^o?J? z@wUCP1=d6g-Zh4fHD*+A4D=NBubEuAF_mIy;20p{(>VPxq*N@&?3`U{fH&82 z$ORSyVY$2TLr351eq1?Ag!%jU!`Um=U=g>EKO#rlVT-9GNsWTJ0t#Lkn~=ah=S`9gaa^|6%!Nf(D2 zPxQ6XLQ_S9Wd|<@hJ^HQEY2*3_WjEQMdRoKzu3JRr(}^&>{{0_<^`x;eQ`y?zIEJk z&FpAE*7Lni{-b-0g5$4E{@CLdW4k_*z;Kh}!HAhuiL^$rbsiDea?5!&IdRm1rZ-x~ z-3^g5?>mJ5hE*Z>AT;BEEev?`lTN3`GC@g+F51IK7}@6iipi-f0PkgjjzFBE z_qiAm%SC4-1sa9-^h@Qs`5zaSGKvCa7W}Vs{JOf&E;J9qTYq{G^}ioB3!mIDGW+S) z{gcqfjR1oah3Nb6*COUA>i3#g)$x0+j=KGquvuA?A5U$?NmCY{BW1tjB;T={p%IID z1@&D0TBpa8FRJ6p1*CMaN)|vwn7wPgY`KuuG8HXCo*T0XqonI$aOprHts+2)f-^m_ z{?&Bg_TAAe(vf=tePqMIk9~_770RWlIYZAnD)V&31h(SnP^KyK@8P)@@5JTF;Gy5! z`iIBl5Nw2}pkj;_wBrCbOG4w8QEzN)su@uGa@9(Dk!kz=%axz2lLpEzen(bkC3=VP zdlaTKtQT4QQc>mh<@IUyo9A}EN~D8ceW9RADJsU=SZwJp0pH3# ztKa0Wh3Z~LzEuGWIxcBW(Im6ZZ^c@!ublk+4E9sq_jvrG%o`GYr@hWlU1cwLnwkj13hoQ#wuu14Lc%cHat3(AK&tr7$!EsC3{UG*63Zx5z2XZ4t6D zcKv=y8qaf(P80Q_2A|_X#c;J57Q-R~86^_PrlJ{B{9cLnpz9bdBJI{3wY*Waew%;f zir*={ouZk`nBbbw8r+dGMlO96M$%S`7P$33n2cq)npl^?SYo1qLWC83wL0AUX*Y+z2bELEkO!s1; zYtcp197RsHvmCuMJ-xTzVyi1dY}ZV5QR>NuL?-=vj0`@0ThQyyGEKzXwx>eC%Ip9! za;flN-9wEx8)vV4&wKT8Nlmy5E|xiFsa@FN2j#YMC$h=A!EnsH%1kf!1f)^N;5av6 zal01)xrno$9^*{|!tR?zeUT5Vnp0GKQnWwcEl-o54!qoa8-x2XJ(ZEfLCIdPG}y58 zMMg9oyKw1etZ(B)sKg?0C#?fa?pT*u%TdIiVpopGSE9i4Bk2hv1XGA{gk_#X?&_Xc zDJlBA+wiqXwWUPlWw72&#NLQbiuerV#>=wK^IQ63<=j zGX+NNVDFQL=A~E;94A}u~e+t(qhf|@MvGr{s-t{ycH}o>5Pc5fMAV6`W8`8I(+i(4r8=G zA?xfIV@=zyu^iZS-2g(qkn3hu_5hEsE1Mr$acbCI+!CwFnj-J-;7%5}I zDaH2EV25@m2kY;FrrjA)Wyf{aH??|#1G4^F^#!~`J}3iYt zqyu+J_tHS@;mFh@-}i6Xv3TXUeZRb?%gqiDBIg(WBBHPSmgm{k{A(^U@#9+QR?m4d zdxt(TcrZ2l{HbdmSNRY1Qhz|94{EHtSqC`u>#TaRnRQy*U7}2LY4p@S22no3`?9ZJ z4+yz@n-L|;0OMyHveWKdP+8}US@zG>L%-+8qGxL1zKK?L%EfX~7^yUd3;LFB`k9%( z%V^1#%HcZ4@$%$?LFwe04E8zZ1;QNcGZ&o9oOij5Aa3lwE_9ptbQ_Dh1`bk&QnHE_ zT{@l`5k=cyVReFas3TzZb5K5$e(w7U#CGCP&63StEe^HqVABD|^ zs(0N|P-EV}a<=O@XY3Ziq=Ld@=rDoVBwCWtQq9OPW= zwMDH8Uxv6jo zNs$`C7ZUq;P*!O~58rcAXS4}_9k362mM|C8^7(u0{;Rx8aujD=F8;Jsk7dHzG@bw- zLvBL`RZIWZ6DqQIo=GpL+9(ADLM1+hUwbxay(WE{TumlkHNeZEK$ z8^4cJm+KhCc&U*jp>B#xSr%7ZUoGAc04+zBXR&HEb@UU{4sg#1BDa`+HP>XVi@qEv zn3lgH^{qUrOjEVY4itFBi{7!#_&A=I4BA%oler)}9AFCKP1=5?zNAjVkX-h?w z+QhiC7t1*yF=6^#rUB2YOAl#1Q@2gwyfCFS%M)uV$jzWD@~;#TSz-uV179|_XS$$G zGs8N8d(4w2Ca0sAk?Mp{tVRzTVsY+Uz5pXSjF+Emq%4W1~*~ea1ylu&Gq2wY*sSXsv@EZ*4N$2d> z?lEfrCY*7bLvp0hp}(MEiMk0_^73x7_Y*hRG3T?v=Jmd8pj3nWp)l17+8)-qc+?jL zJo6Upoa4LL7k2IoTA}>Go6f1iAr!GBcKa@iv$b>dR4J!}`_Rjx(Hw^?UAw^u429n1 z)dij>SZcd5pZ%H08%Fn{G~z4hVPe;nRvg5WBn!275Y&0OGAN&@M)->MzKEE0$*8c?UFPv|Q>Juev0s8{Y8&`2Y`{ehQ862I& zx`nThr?8NC_S@UW#OH~OVk#(RhO=X1V0Cjtg|bkZaJScNdhiV2>nKLkxF+M+O*+^F z%`d}A;RR6%^_1zXy=dLKvT(agY8@`HqjLkRxlCLWW6^Hd1U_HKj^k=1wIzz9+iN*j z_=$ zd&M)<2AdK5GSHXfxarYUK5MZNhrCf(BS?UcS#7=UZ55K{$o zQJb*&Y)fN$KO!RglQW`4w=S6Cy@BT)3fy<-Bifm>Lh(}spP*fmByNo(&oy*IbUYe< zEr7{(q-*WIqD*=4%9c>HcT42VES{VU9zJ;=*4~eO>yi@Db*oZrMxO$rO;|#_A*#L3 z&3f+7WABJRL)UMLN%^B~N)DeurM4%x@vOc9xJ?a)jnZIW`DwI2qm%O%`|NhmS)Ts< zdbc+$#ki7`_9ab}teG8geTJK5U-Oo%TcL@sc^@fpGKFWJ3^)*#29>Fo9o~HRU9ddo z^De;50;#nj*Wm~aCw%ss28WS}z~N`M>gg{;0L58NAMwc#7xxf?EwGYoP=2H8peNV1 zxqiSAdTS_LjniMuU!sn=pRc+QonL*wjinuFCu;uTymr(@2d21~G$sY*WQM2Is^8*G zv*6JjgX+y~{lQ|BXFas!FT7W53EythYT8aZstSt;6|zm)sSW1?BW1|16c1<^vP(@` z4l2^WJ6D?9)89uaQtGlGk}N0y6Ua_QEAa@TJv^=WYO;9|`csfc*j;a%Tj?lt4bcDt z6B9W6l2DYPbeEb+DR|_Jj7eNedbY96~Xo%If&+co}OOQA)UlZ{N9)tvz=0uuMK|VvziT zS7nd&9WiipffwiVXiU?n0qsG)_BzT)CC^qrqFrCte4AiiR5Sc@wuGDbjn1Ldrd$6Z zD{lAJt{~0i!K-lUDSl8Y%dhPGRs8&4wwGvumP{tzyjwK)WopgZ@ni?pxVg?dtqMmX zX+(M2K}3`~zW^S2z+w914BKOg?}4KHA~^2)VY!K?Om1d!iEn%EZh3KEap^VbN!=Y! z6~!f@sIabi9LBFx&o{|3;<`|aULEhBKZ^&vf~)vQjpSxWQIk1db`NHc(=CaIhj!&_ zpU;WGZyGA2A4?A~g@)mv(Mt7!_ZQ%fKx)&Y`xQ7mcQ8`eQ0u?6S!pFLqdtmbJ$*D~ zKl)a-7pL0n5NF3uOm)51mM##qR8eD_wL{5rezhGjgGs7Fle%hHudww@Mb)8sh3=Ts za}mVBXG4R$6pKBtpQltrK{7|JjitLrh@u-pVxZJ_4ND=&)9N=h-?!Khih6F?@jRw( zBcE~3YM_zM;S64$C-b-H+5C4Wp^~3>V4M--MaTa91ulH&`9VeI zKe2kQd&lwv8efuu)TZ5y)ZUlP=c=F)P4rpw=#o(+ti5KrcG?J6=BAs_laeAb4W^>* z)16L1`01DO?h9ML{DMJV`!J>(`)f`**sw;v*l=;bJwTXp+}Vp37O%N6eyiaq)_FlU zH0zoo`(2J>{(VuYt);jabswf0*sAxe=2E59PB4y{WX2>Y?hCxS`O=Iqx8Y2OwLI8b z4!F;V**GxwT$HKwuEK8njA90ktwj)RZ#ntD)lP6jO)GxGlZGKeKZF9&aB0ppq*m3J z%X@0pIbVi-9ZHXHjdjuKyZ92LlN2*?4*0#^;Bg9tJ+lN`hq(Gti9+8Pw^$jR;p%M- z68Nl6*QuweF`&}-ael*xdxG}@wPlssui?f|ENbya*BZ4X8@ec|VWdwFfWd`ys`b@C z&mhN_T-_^DgzL3q`r=;XXqL8kOqvQ>p3dd8^r#8+Di1xqR?$uYWpDN-GLu@IuAHo% z7b5A{TV~4e#67wWa#^ZMwQVV7TY;VNsUF@=;?VkG!t4~c^mJa6+Cs1gx2+WPlpljW zmrq9}pzzS`G!+0d6M3Whi-fuC(hh3zH=GygQq~*FFK@d7YHOi4vi z{Cz{65g0iUM``gkx9gJh7dTArf;i^uWF5}@`~x+{9u-|>eOvoTI+yP~t{Z2{wW_k2 z99P+6NA-xrao_Epl%0?l#n5XS!+toD%Rs75SYt>L-SU$rzUuv1b-Tx*fR-|*5tw8u z1zldaz|2CGdngr9xG#kt-Ecxv;O~LV`6-vd+VEOaSAbnA8xch>V z_?J0nN+#KYa=-6Rr0Y`hF4z@D`HBW2nK)ElvCFwpcE1>zqle6Gccu<>F*h3e?x5zQ zOND;w#2c~tU!TH(4XRXkD3R~@e-@Q-%kWv35?S z1vMK+bv05Z!qdp8%xkYm!Sb`{nEDqOh-m&Sc&Mj>!+=9yyspS6tLt)d^0Y1$lRwh3 z<_uxHfv?l^@|*v+4~RF*4M(O736)63>P{u9{6>)>(iY7odaDSl;|)GIV^f_UORC_$ zTeR@2>SkAhe;)Js#5me370&a$0QN;`-vWlUf6u@7Ozxh5`m!{@u}<(EiW+aB96wIX z2N-YGO95`pGS}2E)GDu0dd&`UyoGZ)U9N1iZd4Z>qDJNI$F87I2DtA)5j1SJ5qR+G3 zX&A)NQ+#)OCBu|O0(|2*f1h-2vg?t5?|O+iy-DPNa-{nE8MX;Z^q47&YMPut%6!>MvR*|yO=A6W`A0c^EFSR52@5$?GSDbV^%)#7neZ& zd? zgQv?xf-YTnBVHH-bfxLQ9#Bg)?n*t$f|zpt?FSNpc!<2rlhR`A5syUY&7$j4la9>_ zc(7r+<457b$~Cx~x_K2sHN+*4Qp41W_pMofSG#^usHdqATKy&lSU}hWU?51}inR)u zCdRuWB?M&U(3rexkJOjm-@JyMHGAD3?jb}8JXRs)WCXWg_8h_`2r(Kxu_H-^ zaM~-Tg`l90(_}V%U0x31Bw>^t;%a$nNm}M{*Wi7?3;V)zqklJ2E}0)C1(k7!6kIiv zidn#2LmJ9n%T_d@W#TGkl=PC?b83`{%8$Ssah4J!kn}s>2M{sFBjH7XuK4X+RKKe? z^CkHPzF*&`zK{~e5f!Xe;`yE7zRS%(ft%!_Z4{?LVz59ZwVvaWlYu%HDX#BA?V%Ar zT|rm%XX$>gOc~AG#A>I8_?;NW1~n+;j7u*!TY>^A!ep+qkgN(ty<3^i&4|zUitd?- zy}GMBpmV>C)}$5~9Kij6|C~I#zLzq-N?TBMXuW-AjscSr{s``1=r3@%ot!r#^BVPY zgEE7SCU9)@hZ2;t0*i>{OyI`-S|@K+v#?v7udcUSqd5`(s?(AqbdefXO^T6Ca8!%T zKFaFWCnb8{vAL8v;^7>N$qo+=sIkKBgIY`&p==|SE4NR{RBgwr;MEp$KfgTPAsFc~ zb+dG=!X4^@V>deV#~LhMO`UE6lg53k1yMlsB1>$OtrJ z`SiWXFV}xfl^HPrlZX=CJA#$OOrhF7ThKdMPoOMuMma+h;hJAGhsH&Rbogonx?d#~ zp@$1l*+8F!83OOdEpon)h-posy1xnC?ud)BhRLZIS|F+tA2|hThTa972i+ z?0)-;sCtHE=VYl#=WfbfA!Z5ftKbGY!xPizIZ}KzP6uB;I+er;;CwiL<18gWq*0$e ztEMV8>BeWQ%Bw7A+EW94C>xsU(nyk(r1piJMmtoEnVu&_ ztZsIu^)jiOj#OAl88wonXAQffZQo3GfBGUpi5JmdJFVAP?#Q=J!%DZFj7DN4yl4b> zCxI>5x%pOkjE*Y5N){Q|{@N^6k;wN{G`4CV=%^vUAa9?k3h&W#71@rLu0Gz#_3kjf zz0y##?TZB%`j6u%=xtPe4HTtAvdAkqUL#vm!*ifPYSYn{e2t!VwR8~JY%%`v=yt#2 zKG>IEuqY{r7#MxL<_(II1Z!HtyuVQ##&a`6k$wl+>gp zX!Y#mCD5_O^PsS0XF9)!X1GQpn_X~o@-BpTLpjWQLoeo3xCt5P7-Qe{8w>@&M$+6` zmFfsrXXG*oj1LIQ`dr_`j3IoAc$LcEzZgs0Z8~A~o#GZu@#TXklE{93q++gfXgDkU zD!(y&+(;^eB(gpBvM@Pj#hD?j8S;1*DG$XwrVW;q_s7F7c{sxktBzPQI(R@ghxtdC zJZ;Q5r$Ii0rb?eCyogfUQo`a4sG@hVNH0%-D4d+OeT`_c!#qW*ox<9Y=uF=#H%X zbyVCB%V$m{-1#CoDa!5wUXkOcA-_&(J~XhId>tO+il$87<{h3lrp}w>nJWwX$ofOq zl27Z^t34|V*wWU zioUmtz-2p08ZU-ORRnGhOXpx|;?>AdCna>3z_(}Ro-Nf(28aa0YD>ED@x>DtdI}>7 z{KSJo&$q58;s$1rO7Gi0hSOx$k26?)WsH)KAm$7xyU3sV^u> zk7&8t3E^AO_6sE5E7$~X$faa;1QCuS(8%RyYp7U77MK6pZv&VbsojC?Uc2}tQRATi z4qbAI*rYz8A7(qyQiNIEC9F@PV!02yydbQ}#nuDr#I_l~@Gxy>_>^C_rufNFA!hmb zp5a^!5&mxfC)vfR2-nq3yf=V?;{~-uAssq4HN8Pq&O54p2_pxZK@;7veBnkE3}1sZ zeX!S$Z;M|7Kfk1V70B3Dbu}1SnSLqt-Z4Ylu+3qWW+J4e$}JE$QV{}oy z*#~*&i)A@?o^2dhTutcn>;c`IReHQhMAPI~Uo-TWJ?eGw3C<&eoWmVbu3`~f~L2M&tt%?FP9?4w0% z=GQJSbtshPQ(!_Bu*Wt7ovv?fJ$NO&)|#*565f7*Tg$}2l0Im8U1R7N#W;2T%hIQ(#H7)EL2E8yc^C5BH;PH-|` zG>l9ksZNuopP9}oM4F~yOOcqN{Mx>dq_HsRr8*bCWhY>2Jf)$1tvow%$v*_t+)lf% zL+ayn*Ehs9$+K6Y(}wauY%nsSdp^5}Yc+6>M4II^jFDo!n4bA73YCj@kS;cdzxn>{a@o)Yd?$dz z37;>jP1#r@Z_|l)wCD|7xcz>O0Wz^@PQ4oITgpcJE9Ymo{W#4Xpwl>;XdxU@KS0}$mx$rV$WFx97 zs5T;@r)%>862e9Zf0_b0l5(yhUZxFr#ZB7e&ac$XT=IaZ>CIG8SR4=hNcqCi`Xm)> z27e5k_L)co=4q!meWoOCJ|pS+34F>= z#&WUO_TKJZc`}2vP-C(T@T^(&bS1vLAwS9<2i;IL=ts>0h6z^_73Yu`2o0Xms+o2`5o&Fk;Fgad&DW zu!k^u_U1?b2fDc9M2|1BZqM&6{PA($)-v+!ZGt-@t`fY-smCVGBcg29p|9O+2N-ZX z2^v|idz^2Dr4GrTicw|U(}JC^)R|Q*>h@W0t}rNiXuX&N&8|B*s%Y50WZ+laRz$yK zZWMi&T1izbs9YS(8){9+sO8S2m^v80uN{QSI7K%lIeMcDb4`?GHTgZcfDUX7B8*acFT+=Dr8&Y`m)YyDNEvCUXD{sdvx$^qhC*F za>vef%>G#MXH?F+5ocv;S~m)iw)DFM&-Z^{UP?kXqj=feBu)^2kXpOq~b?I|K-d!l%8js-4&7UGDYU|J2wl^D;MnwLM$?L_>^y`=h%ax z;_hXFEv|a1+w>JnvP9hUaI6cx02BFOf7sG@5rhsW>K$|C-_bX9ek3r6i5$A-@NI~7 z?JqZw6l_78n!G9DJZlVU5sA+6x}*wVXwu-0O)ZLo4w4QaQ!`0s^fk5oWE!t%B+6M$m2eM5emJ3C#`anF@g3R}xe0lSN@e zVP|ive9SgjJpEVH^8$>YH%@B{G3Gaiy?heGsRv%F$;v$eR3jq5-E#vi@|(<5Cd|E` z2sLu_5zqay{nP``tb618a&RKR{sS!VWZ#oqH^0azyv&u~QP$xk?q{Z0NI>jD=}x0r zWubhRtX{kM{@^*(Je&>tkPpQ`&@Xmml{*%VO0A=%0XY z7wY-JCBX-ulGZvcEvI+I-C<{i22XM76OS1!VD$^0qoJqmm$#FTxEoC8(T(ivPM77} zWWW7h?vDlt2^Hz>L|&6v*>|s{K|$~C&XpXQlZbT+#^AO^Xy>9(1Tiw%UD^aZ$8J10 z7Dmevm#ef;cze7Nmnl7irto}~@?zI!J<5>cq_H5WTDPCVtb7mqc`!|Ah_+{ZW%C)Y ze5Oep7WKLJ%e#`4z$)9f=T3!F4r921I&;TB`~78JS?J_Ykzay@F$}*4-#p{S zLJdIYIz5}^TlB{?IJcgDE`Z}7Q<++G{QA6FQ!7o?TOECMd=3_x>q{%=+D&wT2@CC) zAA|Itb6fM(;j_$G=_6#vFG7)B3dcq(8Do0`WVyDv<9GYM#k0^TH%&Ipe*SzN&6lmg z(l&Mw&HsD_zcgA16@$ul;yUH#2WZ?`gour}!cJJIA`@E-4yvliuaf;VF79P^hr>8h zE;i=)_~msa^THttlaEKiv$;5aV`dJRoJKSSonivo{&Ds=M@~iRjvdhVR%p`f|iRS{Xf&c2(QXn9L&1+Up*)C^V_RusUTcs6 zBa!03C(D-!#g+TmxM=*G+Af5P1__3W8B`pKueU;j6L&pO^_AqC3Tiw*7Dbu2g^9oB zr-l+ZgDqxuU0-!Wbj=_Y$qorL9Pzj^4jadI4@i)&JkjRuYC%V$7W$IS-$70x2(7UG zOa}4|*n{*7kF>u5roZU&8W4##lR|3JdMBVUj3q4?nw&lMI>vN)lKAHMXV*u^R2^7q zR$a;Z58&51@eP}*_&4^==V-$}(mSLhaVix& zJJguc=suB4pdrhELYrPxbWE&9jYAcEjul_OZYZ}3q}aI`?etxd3^FbdNIgE9BQ=Ti z7;K6%j5VBmx6&F;ebN8T%f{H*QZ{ouO9%FcSkM3WF1~b1>tV=(HM8?N>;nz}U zr*l`BT9oj@kR}7Y?*oDE91dIdX6vpx`lvKscvs~X{E87GWmWuQw&_aJrj{|8e8U(Y z`^dqnBQ@}spG3w7_OeX{RwG@z%c{XDA;OE7&0ldBxZzv7V5Uliu#*h}5pJd4%EDfP z^B00#9mIyeUFGH~fS4|FRejr47?82AyjU-$GQc4X-bYo5Qdt6p?t7>hAnUmLZTbGi zIX}7;UFy+wkE>|m=ej`)7gs9s5^#ohHnf)a`XJQeNo=KCJ?Eg~9uLXMz1xk=2^agl z_ng?QYS6;k2=q=gr!V^yytcgd$Td^#bw#{0nK9o#gHpDSek1r(D%$q8ArO6$BmOhv z@#*L8mGiA}-6>>s(f$r6vkRJ@k+9QE=tA)`+r@yu4}RseogK5Q@BBJ+MzD9NE@Z3K zB=+pY>@L3K=IRDjT78Rn)y5U~Y;yE{*>nvqXDbvuT91ATmu1rmTv|tCppWZmu02$9 z7hdh%`}L~=L`JprcS9GV)trwTSL zc7q17{#n3uYER6VZvZ>5NbXHh_P`n&!r5qq2muqF))ZElsuqYS+4n~khfzE_6^R0i zW5#o$coU7g+2!_IrL&}xZf2CJpup^z)@{&H-g60BAw`(0VA@-~;2}0Li&q~Uo|#k( z8uEmZeitMmck!e>`XEw|juFmX_|BO?%yurgx!R|}@Kv>B;u;VS7!1QL?urIeuEj=o z{m$d=72J_I}*{c*xp(gol9@};}-cR9d3jsOQ7#U*1jfm0)SRX8#! zAS0IlZ8==+h+okC6yPZMTM5e|*LBwv86U}si8L#jY4I}eNb>t1Iy%=97@sR6g^_sU z#jMS4Oz}elUS+0)y)U-9sPvO5UHSBNFBNvQg{wvlX;rjN{MSs5Y|^(wA>Y^YRtF<6 zVeo-HB_*r7JX3mz=81f#(f$@3UhJ;5o-?_GUpWc|626{`+u z$|=>EHw9C|Y~#Tzg#ll;M!Wgqj?ds8@gZ02^O9uT9=` z4Z)F(e{Fu%H|dps!8qB+|XQO!6zPMNJ3Et>F@Z>UuBH_lzNU#H$Nnggjt37+a%oc z4czIM%w>TEQqqyY_r>8oCOovhXep}Qc(6IetMBn&b$vZmgJqV`U}{WB$y4=^@!;*N z=-$4RSQ|Nk-T-&b!F5}e(Tt0|8qc><9&XAfBSi~6dyyQ9OG;cMtb@LsOk3!^k$akt z_(oIUoMVJ;*yjA(_Pr?M%ls~p44K^-3NpdD>vapwCB+w<65%gr9pQ*Y-0&xL&wqFK z+SaD=@T|m9VHN8qYNVBM>%M2Uvr6E;vYH=d|9o-UDBo#KL@G8~u#z(*wXGgJIA$Fz zd*}l6FINeMtjoAynn_{CS@@QkAIKCvUf;CTNm zHb-lr&BQ)UcF`dIUJ ztWhTvyxey4O~L^eJdXw2u#Vy-ZZ8eOSS(1LG#lPh@q#9HJ9?jl+<40bU3? zl8L$9m-B_FP;ShY`?`AY({BlDjxJc{WwE4s&hmlolxBW0&8hAWVsMX+^2dk?NZgsU zs$@TXU^YceOYGNY14*^}T2#*|>fz<*BQ>Juw79IaSlx2ezC-F+6ET74g9Kloz!V$-hFWPEOp5Gx5MXOhKI~`$^OG}{Kv^_V&1DUA0dyNp+P`Oackwz)Oxb|LFC&-bRu5QnAM_~5r(yzYh z?)wp&bmWZy=%*MMrXJr=W`or0XxA5W*Bh2-ttE2)h<@83h?V+6=kS5tU#9oKw^@}S z^v#RWzQbZATiPs@k)?;+?TOWV?;6L4ZX7c|kAr|tqBW9vf9z)S6(iB)6Gf4J{1lkn zN4;nM#=CVriQWq77_qyf7CaYD?NZm$bZg|vg%VvzW+^^c^h0lmediP+^z}Yo%iow- z_Sm-VMgwE!!V=jG9QoyXsiK)?42#Xp+iIfzXNTDN2vev_2%0%splbPK*sA|B2r6`v z5IB*ZgFp~c{laL=lbR_m3Yu~?!!yj+FH`S4N|wk}{!ll10^Sj9V5X3Q=%ZSTrSk&@ zhc?wyMQ%+=!l7<4x^ra?v)A}X=Xhx4eMwBQdD%&bAdewBrzJ#Y_N-VbNXDklqcPB# z$y*cW)6{j#!LxQ^!!o{>kU#2WV!KQ>nvM@y5M`-U z<&V8RbxLoUabGXTdg&tU5QZOrcaiQput+A74lr%D3w~E$Kl{!OJ)y()>^9@S0l!6M z3VWhI+UfTSn!VAs9Eh!z5g#Nm8<@;;@UroyK}IolQyK42rS#x$#?~aa&Yt#*lh(KO z1(B-ZQ0e0L)8kMUIlFoUH<`?e;yCWu699a9)Z6H3T`5}9DZ!ovate>tYoxl&cTbZ~ z(lNAK@QN(h)o1yTcnp@qIX^ql7*wQ*_08DdUkUyN$>s2=jCUx>GZ=Yx-t$XJjGx~n z<5H%86ob_)1gW*c3*luAy(bB}8qUQA({^pKSS!~+ZPdPSz!YyqV(G<+($`^R{0Bsj zeb#gN)((@-$O;b1g>h&Zapff4Ae7sUB_j*)KVSWK5Y8E_crFXFB*Jd)ea zTc0||+SbZ`>(~=EBC^==xp55ZT|=xhFQpVo74I>zg^((yvD+{U1QP#n_0A=)&u@@@ zRyq~GjYB>Bt=TrYhM>`KBmbKW1hZL(+h?pp_>DxNKOBTiB<)GL@I@N9WK*lQMwh|k zPlfq)fQ}-et=tIJ4zkJG{MH9=weKay&~CFW2uv>xgZFp3nGm?I(aVp)7uckouxQUO zP3PhsR8J8HGA&D!`CZ-#z1R&~R;HZO%n-Zd^SYYFI0hgyZRn@H+AbyxIT9L7RCIPA z!`{CUep#aY4bL>z+%+^h-j0Wi=sHvP+)G`-+17#Y@rwX5JV} zzuAGcY`kg=QkM>JhsQeNZm7~X9{Wkd?R)MND-41Gj4UW3hPK@u1t*;yE`B^@GPHcOR!SlB64ZvxO*TvXyvQV>Y(R9C~?r${J!%qBe! ziX0a&(*`2w`bn&5Qo87e(z~Z-AnMl62y^+u5Cq%rpQc{1eD}s_vj@-ItDcC4u zg5~8+t-Gz>1*O>CKze&R6rUXw0EKwb**;DS!^Mgi)C{PzjN8RizMS6&5dPk6;5=+_ zWrqyK`-Z|??_z7hfm37syxsFl?JEz>9XZ8nIAy`&T!|hPZ!`&hhH3x^pKMB&F#VBd zDc$t$Wp9Sh4q)8dxa)rWFEMg2al47z{{mZfic%qGhE7L=BlG18TU4+?8#(71i&5ao3zm6kwv=>=t4DjDo>~NR{LYRfGo^dn! z?-wvC?~t6Fd&NI5Z-C6Y9~q|P5`y5DVZz*;u(tHsWD`zlxfl~>Z%b#!2Nqpz7)V6@ zxjn_bk#9M&!|>kwRg}YE3*C5?8#bDWKa5uD%F0+d78ITnv~|Q?+%TS(g^w$9yvGI^ z=huz)arMEPbY}Ce^>XkegSzzFRY~|zh@9yg-t9n@-%XyEcTIeG9Yuck~YQ*31<6!k*L=`GZcHZh_F{4k5&mch|*x2$ji9Tbu| z|4F;t^LpBe-j@KXFL1Aq)l-v!cT^~L?9cVLy_uDe2QQigOwuqD^5UoAM8|2jMwV@0 zgY!uq0lJ8jfxl-OLmN<}Dlxc_6^FU}D6z$5TmW<#4wi#it+-=&Axl2W)dv@4s#Mdn z7W;(Ht2e(ySN!F57bn98yZtr>J)8gGi`14k&A3)a6o1m1ZE8gs@(2W_~rM@x&*kFb8 zMwtG_&*b2+iV(bozxD=AVr3?2QYjrq0hGl9ZZN=5AY{4MQV=z0m z%;w^AbCwLicpUB%lOfUCjB;ceM;$qt7mR#9LwDGMAq{nn7v$6p4C^b$X>*r+MhShN zgl5L-a%-mkL&sdQhh}y)FsVO;z(5K({Lb6^|y8$N~OhoY=0+Y<2PZzgC{pq_A8JzS`)Lg$mrQ!F(B4gaoGsqG;aWGZj zW8~O524W_7syOd^o1wDZ@&RTRVmcL17iM>cgRZtvIkpmJ1=_@3tS4;b23R}4(MK5_ z9iZUKYY5dW%{b4n@%~H*3!yQA))f?=mlC(ZZuHkv+M&&#$-v;g`m6`}X-b%ZpTiH+ zi_?NFFUytC{P^`-xjcCtQ>3`vVs2k&B)7LVb{91i1V_N{L#<7YK;C!N_yTnGMy2T)2z6 zSNuspLm&hEaoX7TGdWvgZuaAQ8*Y>+`=<+=7+7GcAB1w^JoxBYvW`4Bj09z&DhH>={>=Oks#$Zsfdpl_@t~Xco!Jg!V;-Ep#bmyi zt0XQ<(7aG}iH_&+@NV-R;I`Df3L1ixYh!Eva`A9&y4e|C6)b{caC%d z!Li8I&;0?{zeMrs z#2O1voFryPyellYSI=;ZZ99GOFqCY^(9;>>GyQbb@*4#O4mK9@{6WU|q}CKpD`~K3 z&yDL@vRz_)0kRP;3STf~%*Grl(SfhfxYk`o(JB7ExqyfK)W&H^7jSy`j7Uzi3v`~% zg!fzWFKRx{Ka?|`F4~fIXSHLsVj(E0cGdC}!bPjkHps8Epf)rF`DMx7e>ZJ`*2Fh- zP~Z<>P|D@6TGf_oy-(K0FpOs9lE7?ItslJ<#jBm`rE)$>K!hQporq@bc@smS7>dXpI3sa z+YE7vZ?V9*XA5wXIRRH1bVW3Y6HC{Gt`?o;+hqRG*6d7ycb@%Wq#h6Zo|Ye!PforD zKh_PQCt{m9{0JR;q>rvfxqStsX%^V4+}H_~UYPDTcYRX9#eX-HKG=q2xO)5||7*$_ za#*pe78pk`Fpd1%_kKyv#Zk>7uRS1rj{(p?dv{`k4To zF#oy2v6lPM}H)s^igU%ju%1^`&+pDn7Ebi13 zWlA^$$JJr?$)vo8{Cg{Qm1ibQ%L>4jLQdFaH!~ex-&Dvo3wXOa0OT#bmM`mQf-cND zE2E>jV9G6bMdBg8#`72;ETOy8uv<19Ia*>*Rm)6vST{6>=CS7Ze0Pb=yA0oOMiwsIX?YD?p<)iw8Evm4aV(?wC@*jCxUU^S0c;7OG|8 z<^yN3*Lv3CJ>ZKw>S)h~ZNl!T8m(iZRV+++2Av9Hw>1skW#mURO&=rj<;{zU38XUKHpI=>-iUPM0ogfC^>X{wP4oc3yQ>vAFVk-9c+~EVFx0iTU0V3h{)X zHa4I{E5GNJLy`#EWhfg1=tP7i2HahnRLatKhR9h7iCi=wB90>noR1L_@jIQ4GfVWc z_mY9J{Mug{NUY6*ROrI8f$8y14LsLx zze^@ND7xF-L$5bWi+UR{(lBrg1@nNnIvTV1g@Mzp_|rc#6(N}MZW4cYURfPdc%E5G zxr0)D#sV_jSmj_oY`FC~9aw0$;uC4%SFg-D?$SYxgRwyOBig|qP96M|-{qF5^~h2J z+(#pn`99x;??jizkOle4srK!+IeG7c@K#;e=c#PTDOjqTyKYu$uF46i0I=a-BNy}(hyJePy%5x4Ce<^!$JU0R?-AA9X9$(qGd>^e$YT#YSWhb# z4PtD%01eLBnN@xl3>1r_TvT_a4WX1jWQS&@#24GWVD`A2hzg{`H7}}hV)XX2_UuiI z{1wgW5sqOAY*TIQbhVdO6Fig{nn{Lvbs$;n+FO}iO+S{}OV|8=C^kn@D7cyl`q^0e zU{84-akpC8-)}G8ngp64Mx&y%+(E33YYk~rCqD;uAKNceSTpYfnu$mv=<@N$5}F|C zA0b{#3fya=a(-vZdt$csqUrGzX*`Mem9${}y6v#ds?824UCJ?h0(l1|!Dz!%``nNH zT>kkb!xteE8=d7ygrBYw8Uh8)zE<*#QPA8k{-UxN#u3A68^b1$gxdEfoKpd-?Wgu$ zBIqg`>C~6j&qOd0&QII5ro7|EeCY)=&T}iPKf!bnsNxf9S^~kFB9QVQ+<0>@gVu2! zWXh>H2;%|0LkKNP=TUxa43p3H{nubiyj4mtzmI5|G-*iw;0dj9m?MO>^>u~hxE9X0 zbh^D_iyPQXB1`*!{_Gij=Mly3(}ZK^Wg<(L-jSxQM_Px3h;{Cj=ELE}R)>NkI^CT< zkh5tyB0Z%QM&ymi5BbIsA7_8FJJe+6ZQrxDmB^cCYy0)!D}h`_(7pf2(A{a-`la_7 zR*vq%tvxD#_m|d*S~`lEn{hHmV%t5ZT0#Zh;-pF(r3&otJnJu>8cfO%x$y$o?S4() z4gw^ux6tqhywIe`rsHTpk#ed$*uM>KceDYrwKkIWODDf=iqAK7_xsD>bDjxyTrLH2 zmpU_0DB9qP-X2q4(*BuOHT+$1CmjRwnHx^qAh2WwZIWoA}`QPYi} z2U#-khc>KZ7-U%_8eTd#rm_}efq=AZ`AvYn zZZ-qq%n%vhq?Cxp;(L3h#T_(14+w(@o{u(@Ku!_yNPPMi(kzX_J#=NM+l5R{cVWFv z&SX%|AA3ro<$m;SLnYZsb|~F72;o*gGq8P&8Vjl*hS+dcsRDShUU#>)NXWY^<~-z& z>4o9cLyzssj_Gi3xyS%HZouU)JSDLueJE#gW*sPk|TXioP%V@M(0Q-&B#mZS2 z-9+K*&iV~_9ZoTW%-1pMJpFk^PRn*dzZlM@*YOcH12&odGRJYHE8B%C`T{?O0RwWX z7gxoaQ$ItE5#XP*Hya?kFhv=wPq&K@I>j8FI`T>QCs2R9GNT-Pcm1hx7OIMpP`lX= zDKt^+5aLmxBl)G_bl~KxVLuX*c;$PMr>5)e4KmC%f~;%FG2<0kKxL0YweP9PK-=W+ zXURL)xq-D0ymv*)xeQ{agzrgkNNZ^^&MT)}~PuleXKH!-O3 zmN1FGew`}TLFwfjfMl2jZ@9Vvm)p~*W$4bFLL7zXF*2hgU{>gwn!Zqvmmh8t(&mJfBEqvkkNkzz$XBOrHoybV}NHqN`W~aU#(<&^5rntJ!Bx=cQLCiN+}*215#*x@8nPPx-?cmd76C$1CY)s7|dc8d;| z-r=;Fb(72EJ1LbnFP2a+69=f%cszHY(Z*`ti{qkd@fUHX`a@R?vm%=h@AI>1sEK?x zqVvN$nHBk>7#3g}nJM_Xj7Xpa8HmZ)VGp`Hg_nwu@_^u8>Z2HWknbMS4=FO^BF&UA zt_E)W&8^BehYoSBs)pG+m3>=o34_$u@a&x*q(H}f+m&?!W3KY3rN|_^8TidfMQf|& zfYRGHrVuB>9)W5`W$iID)M&7Aw2JFcF2_5zl2SsF0 z*Ak~kS8=Pb9OYb+#|r0kMI1V)CxeJ#kz!YcAv?b6c^C4y&>xvikJs*t?e+U*@+}P& z`cM*;`H$oJ*Dx`8o;=L7;SP(5<8x zaS)U)Km_}}dFKc&691H7>nIX8G4pyZ^^!-H@GGL!I>#omrzFlo6c-DXPNQxnyIp{M zSszl-RcUqjk%198q-|!*%3v$1UP?v;5o0>eoTEurY@ImCPwV1zDw$%OH*dF5wXa2- zQzo=>|90`aGSx=eMIOor6rTHcic?#$Y1x}U;XBDOSpzQ(HfMBZWCkHKmB_tY;zQgG zg-P*6YVHgH7mL}lu0L<&)4u66ccyL?DlPhS2?*Jg07BD~(XG3z;3$c}cdA6N~NnlMlr$j=~Gi719*KzX&vQCW&Yfb<8GaGlvJx)cOV}wd;bQCgjJ&p(@ zW6MqnL1+9Vsy7jt^a@*Tn4_ussgs2rK>Tus>=A(mBYvq(aO4_IFyx{4P+i7keznA4 zQGLsY41xsvPAhnL-fg7hg|`t<_*r1G@0n^*grpiF{7JDE)0zfff$ae{+)~VN0p&_)zDVFhU33dvb)N!fJ%re1tK= z?3$C0+0>Zg2lGd))OiRvUU&%-)$^^n;5=sE^cnajpY)OpUU69Q)ZEH3Ss7JuM4xft zHLt<}6bAM$S#E6tZ*1v!1H(0)O%fDG2Y~ux#M(m*YeXCGWl8!1qKb&u&$A3?iK71=lCSeDDecCe_n2}IpNqVdIXw|uWl5$(To6HHKim=&!UY6&R;|xS!$Us$_v0^Uu72~>@b~*)H#^;E5fP?*LB6fZN{BjyWOWPP-LiwO$p#9k6kyr2gTQHY5CCH z!4@5m!ju0{waX<;F#ZNT_bR}B8Sa_%`2tRooUJSdcd~Oa$Eify=zpkJ!BAz%t#}o; z5V=IG$`8Lb_~|+P#RrX)^TA}N>w0-J4psE>hKA&o_v*0(yRj!^Z;F$J#vK`%b-ESV ziXCA%x0o9L*%AK@^3J8iwMtaR7)52ZqA3esnbTDkq#cPQ22BiOA^K-*b|6V!P?CXo zZQPV=7I|RuX<^uMpQe1lX_{@?g~IR`?HTC;1}Bpp<#uw@PzL@PRD6enNgQ^rT>IN1 zO?1uDG2%A`@WuhNxG%#6$d9uoo9HK}5>>``ZEqNa?m^KQ=JQKaFS``q<=2naX zxutG~iMsKek&?|qvc7h(71t~!2_THXkqq?9H5$C>)*C41*6XzLMq+b2aV&cRd@25lTiiT{&JEqO%yJp@f0f#ALmt-`!%_YYp4oY=$)PD< zBKz^iPv5gm3~!)YH@blZH)-T%=gKWgf<8@;IK4%+?Bedti|Qe8aS`6`d6q|8%39@z z(`FAlxY2IctY6W-#{rwe;__M@sKCbE_4qjnTc39q$NliSGN?O@A3IT5{R_RQ%~b5d z0iCAu6CAUP{+>1iOniG1y>TSXYu|yUr5CatkD|Y z@KH7ouaOlUwUceSleMC>oM3}XOuRpR;h?&NZVpEXSVJc?562m{0?LotYw4l->ihP7 z1LVslIo5vY)1RYz%dpG60n&w_d9hOX99&TFy-F)`Zi3cda~KIsm^!DRDbvJILu|4K zy?-pz9znAUa;ko^)l`ziKyZ%gv5s`|jmMs@tTtTZDCVGQYm^f`Y{G}E>zqDvbk_>d z5;IpODAXC3eUn927TO4iy!-`oY1^b0jz`o6xAwbvHv#U_&rnI2PzX_Pg^vaRfQ*sD z4cX7j*xVjK6v=gC2})GYrZXS&>`Xi`K0Bfp*-%IN5oy1S>Nrpq-h+v_QCh`@T&Q>$ z(CUb*75vgqCk7js%yH2@MV?}|RkukjFz;unFy$@h`1Nh3^lRke8YawiBBoo;1G&Sc zqxFbg0t4nprWlIYgx-qS&dBr9nG)Yb!Rkmvu8lkD^Y5%I3<9BQZ+8h5M?bP9&vhMk zb(v0WA{jWfZHpnVAnpbFc?Ml|URhd$l2DNiIftM*cNs6RBZqy+y8hg$`vYpNkrBifsA+Jxc_tf`LUTfsR| zKeB94#r+HqsziBKl+`w*xFsjvX6&`8FX1;QwyhJ0*UXst_4()Wd+(tM=#dx-X(VWI zx7y6wQ#H+P({DTq1j$OXZ{EQmk58%A%c@cw?n0iCKw(eeQM=0HO?iD8RokMk8 zx!q1|3&R{x>Ji)Rut@3#ZHg;Oq)Un|d6zxsF#W83hoIA_76$La65?v5?n#2DrUoxn zP1M<`3Je-!D>#e%ohuG2tmggs@#xbhoBUaReF~=^sF!|while5&K%_++%>paRZUo; zL&-P|3n|{=H}OV`2JH|?w-dr#ujcgxSvko;jYog8;VH3$7dr2+o zh)Trk@&o6Rl6#^%x3p=ey$K3Fj8+xqM0%k?XiW8uE|_xSAW{7zB>u{oLRB=8KDF)5 zEvpol88D`l)^~%0K`jx>gArSgq`tOD(|^ig*%H@gV~G`~l7p@q#r~aH14Feu2zR`e zMBe~m9Bl*vEX8nh^@gX`Tv#Kl41^kCwmrHb{G`8rJcE^4s4T z0)K)Vv_Zj3Em?DJm)fEs!MvO+^6TA=D}aO!2wTU9B0e5e3a?l`9IDe-4W2aub2QsH zc)LElMbf|C;CR&_Gl(KNrdD&Kc%;&7S+Cc#x$b-$1& zrC;7vNJi*jk~j9lB>$xJ_)U0OD0Pm_apK_(V)>Er>qOWwll;$Bf(Y@W=2fM@!q4X* z&0eSd)tI*K*}P)|CXB12A%}qD_T^5NEB#DhxoA{v(d>ILs_gSumod6N$|Jhtt)uI9 zy`#9f)ja~MwQr4#t`HjB>E?vFaKAH2aWv(IAl&|LXDKwA>r1KlU|A+vZoiR6@<~y3 zBCvyj0KfOS>hH6cHhy8$Sl1og=25?gyUegWh)_>B{YfXBob*}7C92vsfW^y6Q>w(c zmro#~6RjnG9X8a!ty$O+MgM$xOmIm^EEe%+5HFjM-><)fSbwv`r}dmAbnjv#`yHwG zP_gkyNwofgIu3AgZ>s4Xd(Q&7*0X8<3AT2y>uh7pLGJ(YyCL4KEWf;lVEI0pp20b^ z9iJ6>NzgUrPq-ZOMda~$hVIW}K^U$$jR?}c@xX>c`B}UIHLZ&KqWUK497Q>Z{(y$nO#e=_7pe_Y`U0#K_VDZ*yjTS8bZh7jqg zS=KU*HFmrI{M4Qf68qV?0T)R#Rtq5!B)QK*ek0+>ADKK?I@|5+P!LtM&xH6UJB+7P zA6;?+A#Uq}yAkD%r^`N2kul`c1NUinp82}Q88V}nD7_2ajCdxxqjOMTNA*+{^wombc&OgdAV)dJ2#&H-eF0Rxj{{9h9s?fhB2!&18M$=!Ml8pO>PE zOYW&*Qk$b}8Q!#uWg;C7lAq8ZRmpQ!6AhS*?tg^WC5IDr_|OiOR!lu;lcj`bb6xcH zj$tLe>X@~$M&GOdlS%!e|I>~xsArT{)wCQ%?AoGKdo&#@Y2jw}SMrF=OafsNz2@m_ z4d~(1K?E4+nQT}ZE0N7)A9N;CbCkMWqvKZh8QCF^Dy;X9(i!K5^XC^m>^Dl1O4;e} z;|hWY#FRl*V3ctS0X3clva_Eh67ZdwUp!I^5;W~snf7$CY`p5jJj^->JPr2<=b973yIp$B=@(wM2dyM9RyEpA*)q6h+C4KjTCP@ zC{q)-Yz>#-(q+DO5V2C7S=!O@bt@5W!;y;1c_whz7kNAPobTfW-_Xb(K8=RT z;mAXNt-BRBIubpnKO)kE;*q2-m!()ksY!IlPJw<|gZu6W5ZsasIDGOzkzP7N%>xUo zX@Em}w1MNBgQs*B%6H(J1JkW-SD;OnvWu)4g$ql^I=nwt?7hwR-Yy{M@e3}yJBcH; zwR-!VncJkdn*B%#xgso#(!$43y_Qo88JSRJ`k}Ff1xHU}uiw%0W-}Or=|`!eU$=m5 zI)9K?3s<;_W@I!fkKXXS)Po`Y>cwkKy_UPoP_N(hh>7M@vdWWZ2EALJG$2YeHz5+7 zd|_56zV2I*XQHHhcO%>0O22C6UsOo!3k6|vF&agEc@zIAx3pD%cOgY~XfZ@o+;}jz zi7&j|u%PlzH&&FgmWBsfl-`1>mwc~|yLg_{2>ojnNV}Yt7kVv_9Pl>Lz}h^B)bLn&|!Vb@7*d&M4vfA3^NlooXL3P@N`c`>)Mu!lG|gL&G#9pWGiME51E! zP66KbEws4BJ+keJ)LN3`tAnekZ-8M#*PFX?GZZ2D#o&Zib&Ox@kMj^8Gop^LU_M+3 zfkR=rW@L!)==8kAQIbu#Bc;O8(m~NI*#zzNLMM2}0S796oI&N_KD9{IyZlm9F+N%e%Tb3tv@Q+AwtONtb5x}p*8D1LV?jrQqyPy`UB6i4+V=pv@ z2|t;Q$0^KH+>F40_zHlmnHeNRftBq);$f;v8;GH}dX>pSf;eeh$Zl(}{_q_O#XS3v zT=m@I5U4&)CS<}DbD1$T@P?*dGW<&n@6MZL#h zZBf!s6rYX*FE$D}`JlVY87<8Ms2*=E_+H(xN}M}1t6M~_;%J-_1WVJ+j7?Wmvs4vy z%?qAeg!s=hM~^{HnpID`1WEyhWCV{`OVhe7DtQhQ1Izu~b&R*2+h8`CDB-H&t;fW# z%`!9^uZ}^qdU7I*y|i?;6$f|GHZBf$d|3KrV-H!1+^w-kf{{a{B>3ND^>m$n+AGmS zhdYMKf$9X{f7{ZS<>N=|UZfd11K&#+o2b@9DnOxdev@4NrHGMbQ!;0R(r=%r`l2PM zZKn_zq2CR!@GZGe1!RWjqzbW?FaXc~;XnyzDzK1A+rhsuFskH665fGt`x#pAob4}JkFYTO^%}~P{@i2^ z3k`-F2SOo94t|XkbcKpLDR{~~BzXk+!)U!NN+bIv4ci1()QNl0m0506WD$Wb!e@LKvvSLp+D zX4_{y+qR4KR}VHy{i{kJX(?BtC5G)Q7`v2m=6bUkwKRJkUl7tnS!A+7eECmT4so?m z7iz4Gl3#V471DxEA~Vm8jB3l5Zs|JkAT%T5ad?(>45Q8IK=_{{mpBSeT%=st7WAqX=J# zFk__`&uF)(#%N@+xM`HAGBDOS4N6cBis9sMn939OWTuN1GI_6k(UYrJKx}b}%g-Vy ze2*0g@QZur+ndPJDnfPi+#EI7O(De(pmf)!v@pQ-m}kz%mw}O4^5)L_qVP&=Ovp3e zFT!3O(3938RAZ4(e9`DiJZU4y7Ow<(aj9=FnjjKKrhHd#B2 zH3nxcbxd9D2g2)jfxQ16)62~K-*Bk^iRlG$N&lai-oGH#|38>sAdU8aV0zj9IR`Bu z8kZf2*##nbfyT~PivP6(Py}S_{-4GFv;7}C|KsUjJ^ya`=a_K+ zZuu|aznjU4Um_-UmjADrjSUFcWn+Wm-~d8_fyMxQu(GoL!~XXDW8zGI zLA*fw=fwYx$<7G`^s)l`fq-6ic1GY9=oBLmqRYtw$HBrv#0oUFzj`*{95{d_)tP`% z;9vrVjq@+j7fA4BWFz8W0g`$dfCu|429k~07@3GTIsOjxmwpVS5HtNH=>B7Z|GE9A zV=Tb^{=5Av(#$|d{@UNu^{+_%o%G+=f7>{KA1!tu9QW^*1vrm?9phgP{`WEe;p{&h z|7Snkzlptn1NJ|Oy+BOx|DD*&$@X8wUZ8{YVzxF;LPEA~L|Q;xFDDW0-)=@m;FQ>b zqx^5oUS$nNhW~)}{sme84`}aS&3{sRX&G7Q7=Tb+WhY~6RbUK==vCb9jDc4W@Yo{8 zj)o5Ac22eqaP;aD#^$DGPXCA!AK%~W@vmph{~eb7|3>#RGXp)BF}5*vG6SM}IoX;2 z^^OS`bq41DJG!?SQa$P92~x^6KnYA7)||shBH77x2oz}padu+^AIzVKikz5=cq1y2 zMFMWU@7)9{BNfo`bmN}b@#x)UTXnTj6MNg@&lC_FR)H$9zBm{LIy^iMjuQ7{5rPRk zB~=4EHC01_lIlmdoN9KL9hwwtYyj!s|lKD9o0kh?P-euG~3(wa^GmEuYdpabkxl3 zV%Y3VZ%|$s*$$FB6+BTOng|**7Ixc@SzvM+=l&bJ7@CxCIOp<>50dd;cCRor3J93G zUz8wQbS&v48wC+G$o>O}u_U%{JO1#YPY)9SJ{$V|#Ti6EY&sW~=>A`*C>FLoK42R9>0Te4^GYHscQfFb`=2(($ z6rme=Zy>x^kNcarn0WO9xOid6kU(c$N>o^AMFZ>b;0P+@0kNQBHTW>r?ZHOsXZufS zTrD-+sV*Aj>Zq_2aOAJ1+!Q}>t2>w_l(Cl)7A&~&_X!OhGrF7GA^=HbH!3y=Yr3R8E3odT9W z+auk*h$2@5pa3&B76mFEse*C7@ixtd%CA*8XwXjPat#z={oQo-W(xzjnEiL&!E1> z*&h!~px6Uk#u{IN;4%ff+X%7I-o;A*0OAWm!9C2nk|vNwa4Shf_(qQmPd2|Y3Tp-J z{-TTZ-FIXf^$V0sec*c0%N7T&?+64!YFu^~>LYaj^y=c^ev<&w@L72}z7G)8Hbw9IHYU z#i;qS0$trGxqv_-GQr15JxpP7S4-}q5EJ)%`_F?quoWyoJVIb4`0za3{^7CJ{_|O1 zGa-I##OuNU7_l`Z73T0A(XR(~xE;&K>Sm(kmp1U;B_t*_L5gf20zW&phKAZ&=Z_-r z-W5~?b3EY?aRi~|>B-5S#S6k3WVJKBx7fWa1a%HVe1K8+13%Q_NBFL zvG+It72-4Fl@y8??gUXw?R)IWUYoiGKm@>E^BKJI8A!|zh^hgEr3$c(l8)YdvoLy- z7OZpl3|n315-7yW=O)n6_G!hl&H$Y3e!lg6exk3W06ZGv7Hm)IKnd}?nDq?Z@85;| zqaIK{qo8ru^7h!Nt>)qm>2ZguRJ>h3+&f~KV|yOIqgO&hFTd6duMm~@u*F^= zx_F$+50@K)3BF=5c@r?gXh`5>50x5*#0JtR_VEW_ZV{c4!Zg~u_Y)&n3z+zX@`!&I z9ug0aWgIcGHaj{tdV>)x=3Mh7{Jlv(QpbN^f{Vp;W|iLEwTp~y2@K_km3J!6If@C9 zL{%F=b0d~^BH!p#&+L5vT_O-%NcL8jC@>=_XRc4xx%OAP5Yi%lFtgFIfJ^;dmF)11 zT}bTA^O#-`!&i@bqWnNYS{Up&ad;uY`x$>Dx<`&MVyXy!%~)-60$PdqDneQboA?+E zGQtvZ`1pwXJjfBz!x{g5k~cF!hd9rAqLyKPIuHpuIG_Y`;ICx%ujBP+Q{)eFt@#1&=A*xbj^HLgpR`s%=T=bqFu2=Dzbx(o@$Q1;o0`*evO0Slq2eYQuOpEM}qZ@L1LTVp5egn_33w(`7>t2XfG zZ1m678h`^|agdMdw`)O~6s)w=4<>UzWUd{bW!tQ0L9%6RE-ay0fbls9A(?+oQr!&w zaNhkJWZ-mQdAIJvd;pzYJ@dP4oc+hrArv2ilEi+M!-;<6r!W{F!VExo6pWDKq$_EM zQ2D-VpC&foL)RbUnL!yKJqt!Sc-AFKd#ykDskI2k*$hx#2IEWxAe)bky!u$Kg|xhF z?LO*50YX}TVGROkZ3&_7d`{LvP(SD+-vFXJeB&2@-_6|s={>&4JAm*$7-8^R*AKdD z{ZT;CI3%CUJ7BS;JLCqCC4~804fk2%`p{tnySX20SlLqT5d(zBagH(qC)A&6?ohf6%;Q?#S|(; zf{a^|Lf&RPm${SSdo3yNj6DeQ#SS{J{@5iS=T&_u64n}WCfpqvSgj$xNM*7fmg(R* z@6>F*2jviRj@c+eLr zrs$Fjaat)bcK1Pc(qubHZ>=s)tKGW>x+e0jaA%U8PD`HA;dB*A;b4r;@zMJ7m3Dn$hDUd8 z4b}Qc@4NI<`#R&8H=D0QT2ixKJmEFNcK$5u^_L@3m=@#9!FTwrCnDIxS>5@rGr9c4 z_(&Qy?7lVr&YR$GL{iFKr+(l%F{xOmTZgsc!;(2J??h4y=m*2wd^ zah;acRcs156AQBvxpxf{jpP|x6B-x9dD$orbu9ewpn8fb2_2AaTH=c|<@d9oe7# z=?9ji1q)mic^&T8MORUF-w$AJm+QNls}!qF*jlR3OC$1j%qKW0jr|y0SM!Yz_j%3q zFXIa!nP^3kmdf;QPM`%#e)Y_jK=VMZia<8?!Q;Oe+(m14mS2XZVPSX|9qFm_iwcCs zBtzlnVM|ul%ph&(i`Xtz*c32{DHeoyAY(7x8EI8@vf4Nvad3Lbmp{0&41Z6SL+SoW`V#_j{W&72^(vngBO;#@#F)~<&B5nP1aO%)#VPy*g} z+|=!#Hbvn^cE%w|`LuG;E)%Py&@D`~KZy^Z@UM=F@b<7+yW!FUAF;1`r>?uY!oP zOtPQN%xV&@c=tr&Lk{t~wsIjIdkr`l)2x!S#ax(#3yZ=1NCuZj>R!d%ZG>B){9amIOj_0|usT=rW=c z^>GlogH1sV@OaNXoHK<;T+&&Arj=Q7Y>SfDG9|`=|2t zZ)1Z>azSGL{{>AzvcCv;iRHaxS@sgW9SmN(zl13m*1QuUCdA;E{Dj9Q)R?VQ4wDaD z76wcAxWHL^vXr5)~={n(9c-qdQQ0TP9~GT(=Z$4xm8d!yD2Q)WKa-Y6Gpi)fa~XN;WJp z&!>r8t9TlPru?WqA|p7kVNLM-wrqUZwJkMHS~Io5css_bt(ts?et|@-%a*Am*ajYc z8G=yfey5a8m_OJFrMoB3?`BFApg&_JaM>*-7BaPAh^>O~N0*$w=Ex5SpK`v2!w8mY zKx{RlZo;2j0eEoUq}g#eKd;fMB)MyFA!|z5ZLvo%(wECJLI*Ds`yzs0m3>9QEA5V3 zd9sPgeqGIiiWLxcfWx&u1wy;bukN|yEe;+LT=Y~Yt;_@8hY0KDVvBrm$hvA9(r3P_=ie`7wkh!NO>?@2`)p-|yYCzL4 zenAU(M}p9fiBx!}T7irYHrJ6*Oy$CLULeaARrQgMDCnLFFG>ALqMw+}+++NFNs3{( z-0RA1i984A^oUW*)8pWy`{v5@)|c*L8O#88c86Zm`E@1G%HFi9vS1gy#f!_X@-*V- z6{LdB)+CzRjpgWiXV~jSp0tay|%guc|J^P_y|OlU;k; za}p%qeI+7Q&=Gz{$!&b=qPIr&H71DI%D}-qi^rFh?Sgf0hh;`C)EX%%NfSdOwynn@GlmirOK;re-1N|Hd#CyG=h^hR0LKLZmh*Ir?LpR;JnD5VH7{@N z5?L4Z_vxTI79-Ay* z^Rw^{!=wkd(~;VbnqY4%zL3A^^rfQGatA$AEBb-u8TnetJ2Le3>Y103j29H&29b{P z+DwHn9VLnBs=(WF6yR_~hZHS>(oQOY;fK0lH zIPfx3({$u&KwEBVpD8xb9YOclbO0`|5Jv} zew>-rj1Q-+1;<`4L5!~sQHL^aYFgam8I%Y+hDP!a{H3K1BQ}rp?=D-*6n_*kb?`_% z3HE~SG!hJX#`)o1Nm(=<=5E%v4m3q?g^t=GS)c|j-K3E6a+u_t_Ut5x{l^zO;?IJPm!|L~iEtQ^wzzz7w%-h!DbX z&xIl9LH8~u94wuaz+=%;{DRt+T|Zo))J%lJbjgABA)QD2?Tw>@@H`hmCNerA^@s5tSNrxMB$iQhTrxMO7{ zjA!|sJ=SV_ooA!Tn^O7N(`adE;Zi`Nd*bxPYTx!a5280LkGraB`*D`xE1$3rf&`(e zEQk7aGcENwE^oszYKUMu8;zGf#q77JPhRm+!Lg7P8`zD??;D7cBBy1<7Twq@OK9-0 z14aB)1%WLan_E2NKbsBr(Pf}DjIlFG67^DvPERBKzVoo7*cJ0v84@Pz#7=)N2D9gU zS$^v!`w?(?I-BX3yX=EC{uv8wZI=0|GJupn?e4st>m1x2Ow#-r#N=zi&SC6)uCMXvk-;?z^UrCA0*m)jL-k#6lW)??Ob~^SjA%D$6DtKCm!_WMgfTzqhu=ZU! zGA8RFJ&?efBpimIM2;|I#xj!wrin&oEazZYC`9Si5A0h+wfO3G-=h2%eobX^CD7CA zd`SFEHcJH)IlK4tpHfp`x4Eb{d)Fyc!*3kdxnfW;EK>IOwUU$$gVvWA8J(K`_8CR|l`>=bt)cX=E5%90mTmH z8!Qj<*#oM~C&dzRwrX9JA{F|6vuJ^h%zD~)$EP)F!{4>vsgyx2WZJ^kz8~=@949p4 zbfzpeylD^_PcxBt|H-BAIz;+QjZ+o9a(E9Flw9BH4lKIC=iHQ`_Z=dRObsGfNF&tc zdtx+a<|%-QLk$F%fgt_6#U4v9k|XcN?43yT`s*T9q9s`~X~m88YiWvtdBx^u_Ubwm|7&>}=LRh8{`z&)3JoK)P=wq{<>FO%~&~ZnsE6B_%M_sMEFKW=&K>+7#!oS zkTjcAFTq`94H7ex8e+S-QUTh9+Ze}Q>;P7Rj8V>HYAn8y$^2DEWetx3^~XcxD$6ef z3`Nm{Wpa#U&A7plsl)X+M z(VP+WxgZK9@mR+8>}-tnroeP(?=6645(Dt3+>l0E{gQabsW}T7n>S)yr)omh9D?*z z-i)T^BVsW!S-+?kQ zSD&0pHTinaiekNwQKlf^V!XUa#dwlh>R}jf>6haDAkK z0a=Dst1WoYy9!ic?y)1tSI#iz@BJ9V=2S^Lq{ZAghPb}9+q)MWptSM?^(4G|OH;HF ze=ARX{E|{dzQyl4A4(!{p2I#6sAJx?b5lJP6W9MWmbijO@2*83ad)*0D(wLf7g%g84>KERmEe;{itKh9^3W()GeWfjTfT8w%v? z7lx&aZ5I`*<=fuC_krO`L9GGQ`~2aw20^iN*va8<+h?F*X-Zce$~t?$A`s*4S6~a@ zwel@sj6so)AT;Ay3TPDPr7Y%sp=ABQaed;i7jAAxZ`eW7_#qO->w408I;*CPQHt-zysyD}E zp9)iCI^J{On#0cf`PI%eq{Pp$)HG6NlKU`*OaRol`{Hw)SKGaJWopUB1=^Z6J zP)XO0`TR)INe^REnE<(6YE04h<2S!KbE5xvxx5g zC|tUnPcQ$_CRptUn`it zLu|)3;@dIdTjCBxC34JQ-RJLx@8G*3#B)fs)BFZ)2Q%jOG(ySunvtq!@>#KQP2i7_ zvtn{4ee=~Ia?)M$G&o>30cPA>YB4X@sts-w!9HVJ;yhty`{>d zNO)DfB2}&&&+}t;F@=)jbF9=;7&v&b(h5nq8MBVB<+0w5{0oG8$gFX^7&|sWZc1;) zM*&ilsZ{KPxkMRQM1cZUoIIcV*0Z^raVsq_^6cu;LS6^@jfWyk(ConYl4Y*x?SD7G z8O&}%X6c|FB=ER5-P5KIUK?}j|~rA^WT)OMzh z#1F^zlH(z?Au7oLw%&0Mo-;A8xA3ACPHbW+QIUL&H6 zy5%eK=T=x`GiTTxqCC?rKXxz|Eyq&R`fO_U`lwm%oQtw+uEDlc$%P7Q3Q`h4^0#A> zYUPJob3baD)$fZqgz?^CWK-yjh>+Zbdnm%Src8drk}1tqcl!FXbPrCW)gjDX{y66= z1_L~jF-I&V-j5MKA!aXFA6-V~dWL7=S}y)Ai9{-5GkI^+>{O*DDk;7vDam|4(ah3? zs$5#DQ+^YiF8&FbCAs%a@V=Tx*CNlyP7MVkDdlr@9>v~@9Fgwmp_9)Njk^(k5_GOnu@aa(K^7Hn_(|bC^oD}BX0)v`h7%F6C5uB zdI1^6d!A%InVBmnitj(GEjNjHiXqKAw!SE#>Zp#Xw~AG%J@8602^WD3z|dgxr4DHO z{75KCI{V&P$|!n}&K%Ke3X$Fz?PKEeCO&kMe3|x)DBx5lRqIs&Oh$60_*?}3 z@z~k7n?X;Z*>-?e6r&1V)$30N`)p}DvtYi?Mtu)h?p4O7UMW|tyBIYrlwElu!L@{- zW-5vyJ}dM2-Sf{(91JgLb-v5*T(^hOHs!|f@HAMw7;#(|X`0gsW7qP3W>!qqer+2f zj31F?q{4xCZ4#5yo`TQzFE=)^_W6T=>Ou za(sK9kT7P3l>k%^Zl4E%LsFDS$OWG$Z3HA>1a+A2aha z+r=N&8&J3-Ezm4-HWQ!UH0-}TGmCIx+V*7V58qba8p)*1E0E_?gL&N@f}lJl=BVMC zrX&_{q_H)*kmbA80-JknYDcTJF__({HzC3+;)!@8%L#4HhgRhsyOt5*fmwdRfTXmy z{UhSGOQ(d6<4X@Jm!YKrs1kAG@UE zx025HFXis5xl=6B;;y+8V_uQ@aI1{_+tLwsxu*nna4%G6(vyzq7%lnsxg0ItvbyCO zUefSX#k;1QiSb@kzD|5f zV+E87JS4Ba>Oh$Wy~R&#TqU2z7(r;30O6?@AY1z+ z%*H)ssQe@mqWOT1lmXbYV^k{VoqMNm;%THTbSS%Amx2f;YS=`~vbE_*?^gEEI$+3D zBpCYz3w2uG&rkGYq~sMV<$sH235)Huk)y6w7lD;&c4v-q;y@JhJ&Bys<+G3cmZ*4u zfBBOe#7mF{?aB@wFm0F?LybaMN=kV_7*3~9hKX8~5bkdibsc)_c&Po|8GhXD+S-k; z&wcsBZYBo4Ts{fn=jrAG^;_rF5F0*hvxrRPajTbRPr7_Nc%-UQ*+V`@l?I-<8BnO; z2atTY#9Y@MELRQlOdtwqM@Z8~EQS!r zK94>cd(|-VuE?=s$5R{V3%_Q3OsIh)-wxk*{_@RPog%!dh{tYsqfcbHE!$R6?7P)k z^y!&d>&O6V(QhzLOfIxb5{ADN3M?R>p#~unrjWk~J$`L5qSx;7 zvwsctqZ!^RdPoawI-Zd3r)eyD^-w$ps)itWS5MZogHa|x@fl0lTyx}0x5}*AfWW8E z`6meT(WYH}(tqHXe{aM70^5H(vUJBcb3hsnCp*Z-$Ax6a(sDSp)rIYY+9dmp=TdP1 z2BFqk=Pk9RV}QYr803S4&MVG{8!oJ)PGr}!j%_a~9p+4jPt%)8i}In==wmOl_E=(` zPxmhBO#FlG zRvJHuR$Y%b`MmCAV}?1>prCl=&7t~?w(4y1@GiA6C$DN9p2#gRF!$AL$Bbr;c#tpH z_p{Sa>YJzC;MH4tRB1UIInJscb01TXzQmIENg;37%&y~{1k24;Im^o}T)ioMqVlZs<-lUxm{Mau zB&vSEk+eYVP(E5Wv_eaN5Ik=Jc-BLoBM(_`fVb%mH^`+s%^>9hV>Z2yj`1& zPpolGbsx%_cwG)}lC?`KdsxGgyMYSoqMn-3#j$5+sbx@#{quRR@J;yPQmd}dQ`2BN z)ZXwJFypBW)67^9C{WI}dVjC5ed)pwjT9f3`lBw-V!dgARkJNGc=w6PoVu-ZM0a(z zxv_Cv;Nf`Mov*sx(Sj#fE^duPzrva>7e=XHb_Ml)sO_go%(?E#3Lftex)Buw4ECcX z6TX)}FKS%p)p%4)UK@IaK|2B~&!3NBN3Y!HmL+T29u$0ynO*z*t~WA;{F(7Ap2Ak$ zS%9rdH8slYGW~mI)Rtu{YbUy77ykBr%lJE~KC43#4*uq}8NLl@*(ET?dp$b%ys-~u^AdZMK{p<~bVgN5Ns zO?Uk_-^(T5qw6}Q$)jQP0SmK=$}(Y(;^uE(+Lx>8bJEPZTlu?3$krY%!HSf;)8Bha zns@;yE!0lZ_(byz(Cfs!s)y>U|KMk_7NVuZ+W?D@MmpnfJJ3C4$!kzm zVX{BWU-R)1bd1{b*@QTpeSeKfqC6YR)9SgIEmI$b=a1~S#CZ`A9fA=nptu)k=wN>!!S>uc%qZOi5l>;r9UrGEHj+B z5vUorvr6SjUOmfZp-}Pd$4eIB44<;EKeFGit`7r53rq3wb$VjEbKKqm;#34FCaQtZ3=_F}ecLi-;0zQ%4U^AoE!ySE3ZAd;{#kOtsS zSvF8QG+}Q+lhQS5@i`5Xvv}{(0j@@*)Qe{>$38v`=60Vi8X+HA&B|f~_7dRDyrWmz zIbfnT$?i6N%a2l=6X5ykV==1pc1+@^M{UGt%*pdy58;ZKCw2}b+Ok)ASbR@32h^eU z_O8X$g_RbGZKs-E6}F*GS-#NDe*P(m)G7hRI!Jswn^(iiL@X-d06x5mt=5AaI6%er zW6NrYVZ=6phBBvnBK1P9Ea3?-6&)uGqKC&W7rAZ?I$8D%%s=1d?I6W$#uni z$<=2*$!3WsuS-#!3t90<1dYoqbgY0s=JxTJHr>%Rhni`V3o)a%z;&pR6mGBj91a;M z)l-$!%_o7gvu_IGg_SW~_tH(edH6&#a!MqECc?|H-Q69U)QPcuj5Q#KJ= z^HBy&QyPQoCWvOTDfrSflrriibC8fdFj>!|jL3OjN6$v{O@Sn0#uDXdOD#y2H^2M0 z4nK9|!)4XW;`BW)=W-1ZHI;fAJH1+BPPD$$;dKn-?`x6B1hPCe)inS3Mh>G0`>k3R zfm-t=h5{)Y?knUR2I4nbvARoX^`Gewue-dZtC`Kk!hM|WGjJ=p8723F4ps-hg4f}W zqNAGO15TCzBF&}O;i^*53D6$}+XS0`cx+8P1q8jqC&RJni`pqqyo>mraqkmo3*~9& zDrQB%z-cVFn^w7IZ<;;edMZlHGlzcg+3s0ll&0-rfF&$>JW<}}6jkb1k97Yw+T!WX zRKI6w@$i8ajmE|r>G*) zpDKE<27^jDCwohtzWuEFG~x?3xfkdvb5D0wiK4VRD$r%gH3Ub?pps8yMLceI)z*ne zJ{EsV;?(2Gj<k#5jItWaf+2np2#Ug8ubIR}tUAC`U8A0#%3U$?3Y}U1nh$34Jw+ z#%hz(6@=k}(&@EruKRv2V-cMs0w1ZLsDPR4aLe!|0jLT~#V=zqI`82)L-uW6da#vF zvko_wH1njt<$WoaaFh6R#Z#2|^B$GZCO>qmHFb#IX2<9$&QKW5XPNFPLkvF`Ly_6K z=PB3(6J_^lOL|eLnw(~z>e&Z5OqJ-D6EC_1b?QdBmEa4U&WW;M7BRrHVWy&_s<60Wc&sfc)9@6FWA z{_)k|j!p6~-%HQnFKHmV6+WF%R&8aw43M5hV!PK$A)~lxLmGxs*<{o0wD zzVIqr12_#27Lnol1I7Ba!*nE+3 z$z~#Bh)v+Cj@4T|xY`V~`w6_itgWe8;^l4D;(Y2-S5>)lFPt^G)S&X#$cEEF6&+0+ zL#oGiRx)qUA93l2j-tkjVTi(~ zQagesqHK0@T-{SE_*Osz&g`znmm=_5xU%PJ7xGt|C_0^_IN9Dxy-3Q+w^Y}pvglKx ztXf3JL0fyiiD#WJSy3D@fxLTe$%yfs%87V{yxM2Wa)Xv9l`_bDztz_s)(1~$qvu{S zCkuyh5`GMRR8Ib*Ehd=o!fgv3G^}i%lLFiQVwiPoxBY9++*{9nW0pkQeBS}P{qBTK zztR8(fg89SeDbd>b~m}hQB>uF^2kc5<=fu^>pHokq6F_@wQ7(Tk<;vidT?&}uyC5;N$4bB$f5Vg8VxbY&Bi&CiH4eBs@ffy zCLUsYbEhBCdK3)C?GqVtPzXTJNXRnE2s*>X&mA zDrP+rh`_N#ZBc1`e|MgI>D3_)Br?lYA1hm_DSKE8r< z@;I5J;J&vuG|UUnV+Ebj!um@CkXsqio%@+1M28P+kU)$VQbcX-wD)6#XResBa5*%6 z!7yBXX~H1SLN=NH=8^^F7h&Gb(G$>k&pGm5`cNj<31p7iw+d}vUFoj8PnlkhJP}7^ zSdMY88ke~<_8GLyx;D+CaZEY@vzG-x2OcHGNwmKi^iuimG>;B?|8CvEUXnFAiu*~W zz=8YV$#A`8lM5#pQ3q~kH^S9)4|Iu!vxMbGZh4b;tpw}^XQR#Dx^y%K1wg`nyMtQE6mq>*jnMiX z)kL{U44)&!8n|Hb2aVJ;+^uDhN;l1@(WXHc4&}I^F|qu#LVwYzZ%Kpt_)~jr1sV&&k^OT zm^FwmtSuq$68e;KSKxMMBu%uhl@ATw71*ut#gUsISxhutdB2Fd5HuoR#tVaj!47}_ zL^26rg^oe>A$=c5B!L0th{Dm-XU0-3M9(iga(T-v5Y#eq;6`Ai<8c+zDuOZBbt>&P z-8MXT)Fxe+E5tykp+Na%Kt3q|G!(TxUxk#g7BX6mUg+5{6z#Tm3Kr}GA!qQh^{p6x z&3dsEHOg4af3gZJSDKYAJMv0=Sm1!F&r~2>1)JY-Gr)(x^*(>H1wEb*St$58B##e9k{#g_0TXv|CGa_XVY%TS#?$^{efqGIS za3xqZdF+u;?9%O(lGqc8Xu2*~(x2L=d=YC`w}x3h1f(cj6rI-JvBi8kC1x<=I85IB(WyFM zpLMl8V#6Av6^=Mbe~Fj$3J!BG@LBkv^!mKO>AQU{r{{78Yh6vBjoN*u7DER)||DI35v=ip2q-oLwbe2*CEo zXmaqqo^RC)duPi)<{w>><7?fgF(CY%{aeq5NS6@g)hCy*7Sp zHdC*LK)}i?r()TYHWs1{#vQRwK29H>GR1|*V2{s|7Y>Yx6<&qA%>AAhu?~v*mW5Ez$PV=h46~Y#&+a5RwG4<`(0eG?^^lb@`n604oMr zvMQKWIprqcKF{EcFCCWc7*Y93`o4o+2|-JvLJ}rP)9qJjlhG(!MlmQ`2!C0m2OmB;E>PCaNG8JrsViQf?D^N=>s@VPYO$&(1-Vbc%UimF>3#c8C&uTK!+JDkM&i)y0&CVLbCc;+;b16Z13N_;ROj>n*>w;YliXmuW7H6WYi4Nv` z2I%CeE8+woK-rfr7M0%nkReLYzhg9WLrkG zIMsR*r{Yo1bYLyQ6Sh!z{<)e64(H(r_;zO2XDLD^NWnB~rHyU~9DzYRoF}OFB{M)o za3QBt9m#R)J$Esn+ilc+9LG;kj0bhA%;kav%gRE-go()J7WUhBoCY}p`Dd8JxKg23 zCVJ{d&90wwd5_9G6SiGUu~USMPRnEBIJdU*d~8Z|oX0kAd>PKO_Y%4{HSTu-y4QE1 zl=JS^a?#|BP&f?gCCEi9Dtyp;q?9lAnGau!uy(#k%7{p{$4rXOq*bpK<`j0qV#y@Z zyB}X&?VxauZ?b6rT!D4JU4^Nl3nx$XNqP zHgf{$u;E^(o6D@`XYyuQBH^9vY3`F;ek%brSYg6#z2qrkr9!JB2ay{sX9 zxo`g48mH=AK|HU+kVAtq0Q8-2N6fS@YuZJ`Qws}ZqiQrZXt`b>IbHg`Sn7QL(QHHl zZ3CHb=P1u7mH=Ur)8N`Kl~2xG0#EQ$6!FoUVV)1Z>pzRi(Qh-FolaAf5;B~p=tYYC z(gnqZ!cGcvaB9Ysz>Py>x95>A@BI9qT^F05taVO0qG19^rm+~0Ob^Zg>>3EwFNZAQ ztGZ1D9fr~m=gHyJ z5)aeNQ*OFd0dDA#tZ}q8SjC%6K}kAM$!>h}+%B2ca(w--o@LFblKt#$bi<&R?<(tE zmnZq}l-t!8W8{t4XZhwvo4?8Gxv?N*G3JbHm+L6v{4g;^dK$oT9#;;}CiteNVBGo@ zA^%ImTUZ(MjB%Y_R;?KW40kms0k!?}!|QsMxDIyaz{7TXZeLJFKAW8wEkI`qml7soWWz zr?G_?G)7k5M4ohx8UGk-p+!VT=2+0dG*U>9*HHiK~q2j5+YX;L28h)>z3SrPKlQ*m(>K})YYqE26CaBAiRqlOB z)rMKWHIl!B_1y$^8Kvs(h{9s#;0k+;>v@LQ>1`Rda$Ck1Ewo#!Q87qrCWgTf9OHMv zNcp`=SKo|&}tl*D`Rom=3BZY{WA>BVO?@{ z&`1+^1KyqF?l0muUqg!uceF44)$|LVfPf@3O1l? z;|Z*C!(;7lCCW`r1MUOZvxHZxQ45&EDl9s>cG4!;^0J6oxM|e zttqtu4*ok#dd9}O9i*S_?(S0xd@hw^!*;M(VMX561ow)(A)|&8F;FvcFSwk zYtfO0ikUY*5I0qg|Z`kA{D0=#)l%;f!waA)HL& zuxiD!ax5{rvJY!*^x3tOVl!+0b?o&4p$gKofrNt95Xq4u6eefoGGizdTEe^d3N&;{ zr+X(pRv`lYu&2ENg{GZ$Jz-p#DQ46eL{OtRROS4nu{+4lp(`D7GyBaK_y9&7-O4l| z9Vypqw~hKV60C(CO4^7RR3?U{$}8Fsnhd(}oYB|e>O;M6RwZDQ=Fnxmx7X6KrgPmS zdt;z@1ZcuW_piN5P%*=1;ffZ9T4?B2bH5enFxhI)l^*7Lb8UucE}`f^-(l!qv|fwX zj_Si>3>!Ebw<*z62{;BK(6yZF$+>Y~nVS;iIm(h82*WQJBjTRHS2@dd-_GNqx!Z#$3vE*ISP%CS5I};Dk6{O=mTREIV7~nBs@= z;aSOsR~MWrP?Y+|cc{!bwfy9~m&uj=igopG*YZNgPrKXsSMe;!5|^V*$$}{A2}StU z-=$XbwQ=KWH;J?d(1_m5V_734k6_DQf0fgnt}p3khzrD%bS0D?lR0qyIo!VzEQMO~WR7{e2ZTF>d$)L3}+XM;o zxmvdhT~HRST2B5J?Lj@4ismb+gWbn(IJoe|e{%M)GcECjD=_03Fs`}H^`bo8PagW# z{H}>Mg`CM=5H&*PRz{S7RqXVsj%=Xa`xInftB`jgBO{j8!^WoP{AebIhTjf%*an~L zuJSUbC-^dTb(ED)Y0#p5xG8|U(Nj>Aj$-$DWWspLB>fFKx7y1uw3BdR#V}vb zJ6D@=_fENrV1shSd*W zWMsU@XEF+x9KZx0+6wL@krP`gwkr;itBMy*c+1UEWk9eTiatF39(2Qa8sYs7UmqcJ zEjbkH>n3}VdyVthP*||8UET{MBG;xEcdtG@?wRs4!uKI85{xG)&p9hu5Zvq~RZ)L# zbMsOW)4q2Ua&oLS6PF(h44`S@FB-U)a5MVJKCXTEEeKlKkuS8lh+*_#YHr(uv^~{T zNZkeGB(g{^Ce0V#Z12K^ZVWbltJ+5SMQN)3d3*NrLT~ha${i*pPW0WlK{)~JNF;^> zV-*n%diCii#0gS$DLPrfabNGKi4JBulB;apyr*@}bEVIDUS)(97{XRZ4lT5Nz&)|s zpr+>)-1m+!(zJ)z; zJJwM;c;DBM55Uw&(u|Q!lL0V%3v> zWWjM99VS{Vklj|S_Seia$74OSd;LRyTs?S~K4GF)!+H7;m4J15?j;ni6|Y+~8$*aM zKjD%#rJj;y9>z&w<}OeBdXIn$i#$?Zag2U`*)E`b1pn#&T%cLf`vtjJ0Po05I(%z^ zZGsXd`>E68n#ct$pErVn7@{GdG2N@|V!s1m5rgK8gXq3-IxJb~Fm8`R7z)3l?}NWB z=Lh^Xv~RYi?Q)A&oWOh5fXXFi9xtERlqkK9Ctz=ICITg7gMql5BgNd$ch|hT>+`E?V*k2Myi%dN;3&zF# zK_HRy#Y~?XYvFlwz$Ns9Le*x;Vj$*imCFQ2d<92YqsHE|`n9w6P^`w>8dvQLm|4js zY-{w89B4Q%+a;>aN8X+FlV&4qJWIY^P)1$4@j3MLo-J-%x}QhYSh~P%`;ZqT)`5xmwp$#rjxFt4q;QDUTxk5G`rX{h1v_&!z>Nqmjhy?a?a z<3tQb0)GWzv4{6xoI4DHnIka+ROP7y`j|$+nWP1l3czy_h{$8KV6`8-60`^P4L~NU z>%r0#bfA%1v@14>^1Aj|kS#kX;X}rH7` z<438cIG(3-Z8bd(Qdy^HYfy-IgR{x3BP$KMJ?dO*S=BImAYU4NUfCDVv!dzdV1U2n zvumId&|Gu&hD;t=&|IK)6n(AtgzxoJkhBu?x=QB8~zz07IU#Q|G1 zVzM&;MuLNx0-s`es1T4eve>1s%<-_#AUBFZ7-JNT{+;)=x?&mrpds0;5VAu2Rj4Vj zQ0_p-$RRuzUx+OBkB;A{46&xZ1v@jEaIwsi866eE)8TH-UldyE{kS~Nh)Gb2aKrtg zD3p+J=@2@I7MJ|bDz9mx6SjblCuu}8tIV%ZDvJwm2VZnq-t4RUf`4`lf_abP)JC-PC?~8dk;jnikGuZ$cY@9R{<@Z+!^fwZ(6rajLxj#cy{p4$F@=OVmo zD=bggmLmc@j^nLpEwomagEG(O6kKzX_6e}&wcAfVR+96$4hIFyUU4M{*0^3Xa-~TT zGiuxyvV&f<S}yS5>hqSed<5KKLFZ{lPzm*TO87~Q{BY?%U+He7HcK^y z-zWYSTqS6njQH5B^Seg{v|_&hC0V58J9-fq<`K+fyP!`h$aw>Z50B|fD$;x%xryoX zY1(tY+Bz%N=DJ?cJQF1a;wydZ`gZ_O)}ovV<0?O43vuPfYL-Dy;easroMkOmQG{|g zal`lKbzmpPi@5MMAS1#nkg=w>Leth#mxx;DB5!)CU@)Jc;ED4GG2;(RHg(jZ$*L91 zKaW(e#P7zvs~r8)`fOswjvYqu_(@TCrzTpqxo+q0QP1(BPQ@ZIW+R`8E9-kMSV*16>HZ7hGyivK(ai@di6s_sPsNxa} z*@T}`hb(2J>;F_vEu->uccC;_Nnb)O%Ds$2xK2JTD9)RT&QL{c4QJQ8M*^iC5;~HQ z*Hab|?bpyE_K-bmKb3UDQ*3LmwMzhSFP*{b)V^FUixEGP2pl?pF8MA5@TERy!JywK z-DSOufbsw)3aXuFr;2262AELAZRsoG{7?MpZwf(@=jgxjbQAI5z#q9T`EW;jMDP={ zz^&bdZuaNd-TNwtX(wRbeB?W(1t{)J6l@KsT?z)qg<|il3R_ak##lkwgS(JU27PEP$9BFx|U)#mZZsKVH)=MwC9j%=5py#Y`N|vL<_14Rk_l=<*+4+q& zzDQ|4t}x9T{yg8rf3#}4=hkv(-QNl^p7>mmkIMGuS4&nQA&mt77-aWU;w`Qq0PYi8 zmtHn720(bH-{6Prfw*H=0FMcC5Y%6M5TaA54RJbo4{HlO*80z>nxRoTzt6BA(_`_0 zLUjr=|0p#>H-2-`zy{d9ukRb`PRPY;M(bbDYlZ3~PUXvlM`gk(@PyxuJIY{;G;}M* zs5UQJd6cUW*j50=y0UVciQnMkw0ggd0ycY7oG1KuC^*;#$&tpeJDh6q26rECbXfMU zq@&x)y?>rX{=zC~A3g(`M-$3@o1x&5&vHcY+AdS-6C>a-Q05$R-T1~)^us{2U!y^| zf_A4tkPMyt!1w=#Z2L5itG>Le7<)g8t{@^;PbhOF&yiZVvM?A(n4W-jXU4vwoodUR z*bQq`l8=m}Fg$Bfoqj%-?vm`E{7V1i*h0y9+>$hTvJp0|64=@jeESjwJ_{*2HP96; z2O;W~*M}>l&O~{5z8u`L{j3cV|0X$V;3jQH!WRleMS$9Cjxy z=V2CnMsaxY3)#6zq(v&xzAky9DGW7g%)JFxqvnc;>a0TXX2N6hdM8POdkOb^Tidu3 z$L?bGCAN$E^YUe}(H(vn${rmty=>vj5;q(yVDk9YZ4441G{WMEmHiB`M?cLdlZhf3 zyvLcMGu{{p?#3tm=UQgRM_a{s4SzcmFyxj8SrfBq%8XEvhc>)186u67;=(a%#6gPF zD|8lR_#ftH(P@2;Sy@PeLQerADBD$iZ`;Y2n7x6-4T;5rx`5tM-a18%H4Fc~HAgEI zarcc`0v5;;?#d`!YP1EKHa55;(D1x1lOBGM;0aR1X@|vagMYjaebbCHYrA|QQTzJ z88$KKjB0SZcwlOqe#y=?PP7oEh7txBn`JT)COovAQ7a(tBYVx@yN`*Ton=@YO%twx z;O+$X0Kpa(SX=@u?rybXuqc}!cWj>DG)DoD4h`#Rv>vXUC_Kt80Tf)9elh^53 ztW&mfGR|{by#J6&I=tADwN@5Q$*s-c!JLwin8B?(pnSgD?_8oMI?0AaEScElTF6pU zdNI*!S*E8j7r-}dhavJ6)invfZHT;pUOGF4UlkVsmz>~Zu9%dtK|{bYeESP6&8Y1i z9j67mhFlW4CHnFGNwpi1PJgbm|96@qonHQzR$KWM47=C{_=Z5?(7BOC=#UCCslePQb#4IM6+D z=psHoEO-l5ERLPGN}bOx#qrJ^4;jW^UeyfcK@6toNtgytD+bq|(C!CD+?2pW&|R=J zWBfdB=W+ap_EGY1EI%C3i2G=+w;t%~a(GgAr{9GC9DytCQTJ9dC5C{Xu0i~Wb0vJT zUHn!faC@65lM1JM(WGKA#+gpRtJFVl!4dAh#y7NBQ7YpjZBi!br5G=i&>Q^XK+_*z z@gaopx`R7P;WqQH#YW>n`cz&n z@VdZ~rKR;_1uG&L=JxCSkc+}$tdR5@A;~xVbm)DAyZmTm@$REHJZ8vhBUa@7hs@1% zN!16GoMMvDpm3vB@~ziVBrxv62L;)pL~_8hMN^Hlg@}n!wt>z*sRC=#(z=*5KKX(g zgm=oU)!XzrBu+L~#Y;&CgV9sk>-WMcA|$^m^j%|wC^pub(g^tUP{?~e?R$sL&FUx- z7iLhE|9ljkKY(jtbOX`fO>`+Bj}q_pDm^krj?qTeOU|b-67t-|c^PtcVAf1O+~0JD zxM3}8IuF3A%45%HMFO_oOtot-1fE3}mBeVD`!aOb1Q%sZJVif-^U*Wd9g}6^f~ZZs zKXX_(q3sFLndUZK+tdCM*?}q;Rc#%!@jRH<@h?8r>6&`kM)y1Vq;$_EL(eGfL(59g z-S?!}LFBU+)0dsdb=%5#+=u{gK7y=PtyImD-W=WIpZ&x)bT91YuX;3MyEVNR_u88S zjjE*mvuV@#LvBASF`JfY8iP#!>X*Ujv5yV43s17mm{MJ#CBH~YbuNY-6@v#m-j2&G zn6yZAA>0YXwss-Ih~5ppZV8RHYCX%{+>$*#e;H*nGxT5oBn!ibaqzb$p{B1Ig93)E*h zd~Oq6ll_$Ablm#lMO+>q&n!?T2$n8?$_48Ecx8`QK|rbJgADUo(wg6EKNTNxW5r9u zNu=!_6Q19*!3>)*$a79tU&5GtS}u@{|C>B974VK_Ppo(eI%PMdjB9utRkM||i~C3K ztw=!Gi5ZP;fSwGerklDn!i{_s4f@Nh#)^c@$yA@EfZ|Y5)1ton(RrSmX??6-%C3-2vNtYM~NhiI?XJOHz>1tCgw8H%t5_7}^Z8MhOy{ zuIl{nb$qew7Arxll`%hd+D;UH`a*-VdCI}P^`pc02Fq#)t}V`yMVf>f=X1gEkh>8G zar;a8ok3xb3GA*mvAc|4GuS_f2LP1oqKQ)!j3_y5hz)ww-Shb}Pf)^?sesQKx+GFp zrv^5zGB6GM;jKL}H%;?aA_p5bJ2HB$7L^xmOijG7Runz?gXAty!P_jL|iy!HyptZRGySdkjANGKf`*hy^}NkqQsEvuWXr~y|ukx@fz z&&D74Jxj?5n)Iu)0pU2?(Z|FMsP%)lj@#)PKjt-Mz-f56=MR-};;o&hE>^|?Zf2G> zg(U=onM2}oEO=cuxPkoCV_v^R^3y`ceTSO@5q0t zLW7C4z84~JW!KzDmYir<=y7=vid<5^luu_$T^vr}jV>g|x$~79CWU{xOZ%qPZW39+ z7!5Epf9J|T+M26YvQcazDn(fVb&iGWl?R@U8dyVPAyn_uPWmi2SZvc*!aKMc7!>k! zHU#T!N&2C@S3_0vUgI7&Z{?sVdF6eB!@0-qba`tn}gj@UL!U%`K`oIws}&_N!l z-hVYkV5*S%oucl(Lu)xC$j49BUsgL;ddR(-+?YG{6DI|_2KB*4BRSDC2qZI3Pul3) z%0295cbTLZHc#5P4M$hOIT5jf8OoPg&H6fDM#_^V$SYwzdWaz=sYnIyZDMZj!du9T zjCOT-FIkzndy=dy^Hh2Mx}GL5U5BV^D?alAS+7u+aA{ouh*wV9)sr1xJMvC!4c7vc z__fq-!c5S(iQvYX;U^v>*kqDf9K5;dSEfw(mKV5IH*koGU4q(^W)U67ri99x zDWZgn2-P!W-TCOkf+GOSWxb}o5x|Sqvc#|Ry-s5|7y(h$$9E@Ilt1AXNY;5+V;QE^ zUWH8D1UG8H9R=ncxtxGi`~-lu@z45s!F<6SuT~QLO8ti`&=0F$k;3hse;WHB{cHr( zWC!HVv2D=nU=9hHhxQ&_wImJ+ynfyFTrdD4`Q702&KVX--PhqAr=DqZ9fG2|~D{ zS&bDHoLwh3e6SIGXa+__rKiv79~=Z|TnO@HKEUTXhvmoQCK`p9dTp^!i6jxSqL$Mb zY*WR;I2mQ6yv|KluQc~ULGmEP^{jzK4iDU3H886l**-!$*TVgDN_v24!}vhM8u(UT zB9dRzYav@m`E}~pGJv87H7$j*aAWzie$isApTnsWXdu*nz8N?n~Q;?@G=B12feXUpux37BH zwNQxf(Bq%yKQi3}xmO8CE8;leN%Tq{%rG8T_Aq`SNN&UF&IcgU_1+LnRjAaHUaSX7 zkM~X)N9V5K*3MV9Eewhe!zkd=F|FHry;FR3K-=XnG%7r=M`yGsQ%Jusb?bZ@L$AF0t89X0skyY2=s>Op3KKpt*G-q* z+->t~@GB>#4=8~zJQ4&aQ^Bv)knN$$0t>eq_)bYM8Vhb*Z12G=_wd_>B}{$~H1#Wc zkQHP70Kl|j=1Q*x4zyhu9k|!h^>Jig(<*);Xv}j{_@ZW<8jgiH!6QXpSQ(-WDpmC? z(t=;y3cPCZ@aPX|HQ8k0PK;CDc*=H=b0owkEt4Pa?2T`?JuQloy&A&lN>m9Te+ZaT zm>3R7^Ajx1h(+J@2qjzpF&=8R^VXM(e>ur2#=ERN#6t#8zW2Cn@~OpO!;!#W^zw88 zU#Rlo?R~~R^;cWIMDsIk7&uC!ro_{Qzv zO7VzwuTO$cYHYzg#ChYA0Y|d{LP@=FbYjfJU5a{ir9%~yJ!`H}MmU=OV7G6xWK3{- zHQXO7DnE8TnF7BMy)NQk`W!k@vPz7C$!^6HLlJYdDA?hzWDx)04L-R&jrm@}JXi2o z;g*`z1*WPM;fQigYG(|E?D$14=#amPT~kuoV*9QCyHn^xoHd65K=fGtxuU5NvwETM zEM7u|k@C~ZcuI!Dz&NcIx_d7Hld?zn%8D5W8Nh^l*fPi-3kR){xzy|HJFK5!*8y6% z<-*Y?S~=*pV~g%8l~qZzJHvshZ*dbzDEv|q2dLzuAE!80 zj>trJzcpJ|+uu}~0pTKK4v>MR!rxOS-^n2PV4C#$WL6Y%k+AO167pG}bmd{Zsapjo zsm&K8=yJiqb!Q4Ahp(#KSlNWN3e!>uca!KW*e}cCD}X zC38xsZ>pf2rBdM9Ua-SZaQNw3#yf+dCh|a&d4cv$4Bv;#Pb;MvhVz4=x01Wl%Tegh zStND6P792jZWiv69YTkw%-x=}G@Tk;_XFN9$!D|c2-Q1uKfJpWRzG1Leed<*3fI1?0&k&3!bJ6^Wl%-Yc|BgmM#?9zo$J$_Pd70`TPc!BangTGd&RQG#LQ@& z7DpXwMR8Jl1tLo_8_7-g(F4=Kxl87yo!vVIYkpYqwn;?&Oj~-sa%>a#`U1Lhls5qM z){p8yxol;O0MM5#CI(rpc1Y z?2EI|=EiL&q|~C{UxD(cgXgU8pzcDu4{(xE{M({&1X#d<(Abq}lu|i^_ykMApQ{dq z1(wRgK?fH3vf;wcphr9t&Qgxaw8GMCv!NVk=;k2-1JO_4qSe?w;S9G z{!BWbNZH?if%3~!lfJXrDG2;|H!Q4TUJrvbcUc{xfqz;OxAy9hC#0@+@`V^`|Ol>|&h z-8F~ghI7_OVYDPXP)bnPDy@rAkkIa~^)lQ-&lBkUwJ2|8Cd+c%(*?MNPW3780AH*> zMW3kKVOC#^9<$3hzkx2GiLsh$f@s!9=YPVkhjmmR71^+_1Okqgz4fk+@b zDL8kF275wwMtNeam}vcev7+0>AC_C?HT5P=&_$<9C6il8R#;z*@dIziFCTBdh*btk zc|*RyU*^@YTeRhNszZLc2Zn7 zyelzn*5RU)_0yte32n~kmBMZ`3-=3ESeG%;Gk|yAMfHpgsAO%SgPshIA(a{GAG_Qn zs7jkT=Ku+lLERL-=PS)aT>w=Si94KGDwKT%=Qvd0Bu%=C{0b@skNT{|RLAe1HK4YX z?Jri^IGUy1p!me30R}M)8h&Zd%I(Qyo(`2ZxO!tZGKRg+NghV-1<@Me4sh`%wjq&! z+xwzlk%K2OkRQWv3qA^`R6%Zth|XC>)|`gl=x?>Z7Vc=Ktd!zoRh1re(v-dLFw+ya zx6QsDjTs5`CT+@gLq~_g0PKJb!ASv&JPVnlDM6t+*Wl4*jrY^rHIo;qrg{jrc^S9< zJ)*RHk)ijrNFS#33K!rkM?kZJ1M|K7=!PT73sKhCZM=MK!pkyA9%Q2VMqfJucA(!N zSbK7$KbFTcp`r1C9IECObjncDJ~WB*{b;2BEb5Oy!(F^v;VnGfTg`&N()^(w|aENYU(y+dWHtnSvin5_jR;1Qx-p0KNo=!X;I(L2Fp;RY*Iess)A zLxk$C8|*cjA^BiKqQ-21z`8O%4We@)I4Ki1&A=aIZ?2pB67(i|sqqw9NOU>*I(U^5 z(=4H!6bd7K=6%R0aXi>pK+OK?3!KRHCn`&_p)veNHkv z^mL4F)Gl=Uc^?+ZLD2PV_wEm9HYJN7?45}h$eOuxE}?Ht+1f9JXlvFh=<1{!xVbVI z^FusJOhd9;o-W-WZq&Vvu)Ml2T=kgwefQ4g!oh{Fh2;8Sd44EDOw@7C^K=dpsBnjw z7!g=9++~74Qa5s@SczEel0^13_S`EuRT6eXYa83ShL^vLq|z>ZsjKp-uBwtM&sf2OYqKz$b*`a_0& zkV5T3v7Z2RcmJ4|zA@qs34%?I&+s+ujB-_xjh>>XoTEEi(KC(sza<9wkrrR4V4SaYcwY*men6v6JP<~7FZ zGSF7*2fIV>PTVtLhwkgc={HSK72|h88M9lsb%1?SKx2r_FOGui35|&8q(oXMpS0p) zwYG!j;94%)zFoE}9?!XEyfmF#eB+k6D~OaI_ZG6n+_KSH4X~tsDw3op%3^}>QEU&* zuxq(*^GXFj0w)!H;)PqY!TiL@s}y=Zm`SgoNqQ}=c38!}`jCw0mp9Y_7L@k6>_SL%v_G6vK)zF?0lS1C^L6Z(Nk_XTCH z_OE+R>@j|}-*8tGv&hod7U8xL7JSxT>GB89DkgOAXZ=96Nu4;P9fskg=ZFz zXRt`R`Xv=u>U@l(>?FBKcB?>1rJxVTcB>j%;&;^62gj4|c}+N2PQ77~qN$vL=k3S% z*#(=IMEm?Ao#8vNuUjQb%{T)b^zf;gT9T#!?3To?B2K)nc%u0pC`QK+T&b#5@$DDP ze*aOJPwq~K=21k)C2try37$UU?I=U)m&EP4u)MVrMBT1D3LDUy&sdVb0Crq5 zj?y>NZ}=)+&{KSPGKVw|P55ugv9%%&1J0?Wxws|lvn^ZnPfp-K_@rDTtmIs{LTEF! zJQ-}?SRN1NEI5-4+IPGt_4}hP5UK($vOGAzJr`xH0b69U(tUL3V*EDiCH?ulH(6)cPQLwvVEFX>wM32lmVtR`!_BMlzCu>ww;EAgG^?S)wv*#yl1UaAI{?Y-ug{kf*)_L95q1OQ$7$eJFly*xE)kT=p*r{P0M z_2EacDA!U!|CNhmLYdhS80Q`i1M1Z@z?-m9BMDgd0HxdK*#t1(QW*BW^MZ#1TJ?Ll zEF#CwO&eQM^RSSGD%q~>8GHxeMu+NWbss~i3V59C+8em;c#YeuVo{Rq1}EoE^R8)Q zr)CFSN0zEoR^L=mFY}X5yEzV4ZDVANI~;OyJ8pq9J%%cQyIZWQ3bS91UjeyDm2SYN zDX8q2^N>3`u(^jPGFKV1wLNTkb~H$~{BkgD%+cSoDZls()Rb4dl$WN&eaU_nB^gbz z)twwD=!i`TeIzuRr9Eyf9Z!@*rggr4*hp;2lq$CE5Xw@4R1(MFakpb%t}U^J=~vxj zg+kk}gPEBc?B|Y^j3x++Sho5lin4p_O85e|k4n+(w53W&(Z|?Z2u?6hRXI(0;MfEC zqL zTk3ZgD`a{Hhy8f$>+tRHRVj;(dl#HPo{Tw5T0Z!2H?zsmJHL&#ezJb$fiozC+2jQc z?DLKX42H44T$r9jOkR0Y@zW0(y&X^&2RJnA!bjtfrIIbSbQC*HwRrgE>fF2EJao?D zaSBx^Lc!@Ym80v2QzhaUQt4o2D^Q#v7Us`7Q*?IDEqd~^!0}7bcAk4buAEcv3XCzU zT^|L3;>(>&vi8R9@~*e78`kM%$Y^j^nm)sz$j?=Yb=vN10r%db8B)(VEY-@@_<`AW za)|6Vmpl!(IKF{n%VD?)*gNW4G>bnE)sysc_z{|y8vnE=Ffu@@mFT&da8&@`Cc3_& zee;Au8ZH%3jn-`+P2}y>s2Z~nH{0hm&qr&?HIFtF=9FTji~&@4<{&2mq5bDO{! zI3+4=`7{t6MBKWUgXzn7eZJROkK2tgXNpmTeoEXgnTib?8#zbUii*r)EUGIRy`Sg4 z+@vSx+K76mhp-ZI+h)B2CtO|SuGKbn?!oX8 z=A_;tEoQxAxx=7C<+l)f5>M?PmwxAmSn(`esyXd&H9~pNrBQM9? zOi=aL_=gB8V3Qc!uFadn2EM=PKH7@g2*jFuCF}TRoIbCGn8KJ`QAxBM4^;19pT6kh zj%^%_FU2d((nh!NGX#2%%WZb>5N`J|YJr*H;p@2F(|3DLiO4e7 zv+#*N0;@ExZV|u1Xrpd zy=BPr{&Oo7L$fb~gNTPUU-yK~>*UGy!xXlI@-Ui4-fI%XQ>)Us%c2vXMQO@hodb~{ zDZ6b`JI?^BMr(UdFyp-AXuwyb1_@$7O`w0_#}pHbuE17f+tkUNG}FZpfMy3w`Hx@j zKe{jVV$n)euSn{}rD=zb0~JP60>|8%f0_l`)$@0F`+ZpF-45GAvT;k9#)Y0ls*^95L>Nv>wTI(=~ql0L_DxQuz(;1{k=Qfp4POe-#C*8SAG+W7luDO zoamJDu0}qbtZI?7-9U+#CcQq|>bsbu zaU?+l=r-HxY?;eGrFv^Y6X|XqT0r|LDj|Qgcun{`vfURMO}#VaxJP$5nvzA^jS)Dm zL<_#`(d!zN?K7<*)`=~W9^^7@yeVLZ71U6=#Ef}kZ3t7IG*?;_b1L-e|{OYBA#jUC*7xB1*YlKjfb z@;jSB$ncQk?z8eNd$WMaWsDwm$=^>{NniaMOopj)~0o zhDKQpNmh|U-t0DB(M-?>Uv0wFG`@~=e4#3ee=xSQtEVMM$CF%oEi@q8ks!0_QRJ4h zQMr<3!t5@Lx@6{iI{Ym%q_bL)s;vx8X6#E=;c}CA+4aPLr---{spK3LVz#++!0HXw zMy27q=(c<&o2rQfar7*!5vZn|o&y-yAWr6ze5k}&__{>fcehL7k5p3vR9nj4vZ&wj zcyz8P83Lo|7MRp%Vt{EeYaVsC5hqt9WmA?p43(s*?5A##HqSbR@=B^sl>fn_1^of` z`9~h@KardNPay4YPU!y^koGr!R+-`tIL<%B0A`~A{*DRKFc^Z^2^D8U zX9z&l*pPzlcWA64?Ef}n`@ft0A&K9S{;P}sX7+E=E~LZ%ihmgL|BAmMz5k9-)Xv4$ z84?DojKv2h2t^eFKmDB!1fBX%$f=^CnTgXM8szwW{y)x+CWg)ycD7=_)1epRWe2cv z1K8L>5KJyNCnqz2gAM?oV?bsV{cUIGNI`F7=xlFo=WK0ZM8VF&#sXlXFn4yg=VfL6 z?+F$=M>B|vqNCjh7h{t@``CXlr7$uywt}El|LM>0hsfL=O-zvi5FRZu1RDIW1A^G) zgg{kIDgL8D(6IkFM`8O(H4uDku@8jS70s!osAjoz2tHuK<+dpYQc5Vn#_|F=IBg_7G4afnh z=)d^#aQ?MDE)eiH&i2oCKn@6=_^;aE#uUH>;s8Mk?~lH00CwQ-di$dW;Nk{AV7q_S zAclX|Aif+Ne;Io=AQ$j=eg3gMh#e2;FZr@T#()PhGyY@;_2Oe+6DftUmk8Qj=$6{8xJ=( z1Sb5a_I}qr=nru0gU{A0B?<7q5uE@ literal 0 HcmV?d00001 diff --git a/doc/LectureNotes/ipynb-book-src.tar.gz b/doc/LectureNotes/ipynb-book-src.tar.gz new file mode 100644 index 0000000000000000000000000000000000000000..689ccaf1dc65facdcd05cefce95a6212064393b5 GIT binary patch literal 113364 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

5K));B>3LlxL6ZsxCf@w5%zIUeEX8oG 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 literal 0 HcmV?d00001 diff --git a/doc/LectureNotes/src/Hudson_Bay.csv b/doc/LectureNotes/src/Hudson_Bay.csv new file mode 100644 index 000000000..fd9d4767f --- /dev/null +++ b/doc/LectureNotes/src/Hudson_Bay.csv @@ -0,0 +1,22 @@ +Year,Hares (x1000),Lynx (x1000) +1900,30.0,4.0 +1901,47.2,6.1 +1902,70.2,9.8 +1903,77.4,35.2 +1904,36.3,59.4 +1905,20.6,41.7 +1906,18.1,19.0 +1907,21.4,13.0 +1908,22.0,8.3 +1909,25.4,9.1 +1910,27.1,7.4 +1911,40.3,8.0 +1912,57,12.3 +1913,76.6,19.5 +1914,52.3,45.7 +1915,19.5,51.1 +1916,11.2,29.7 +1917,7.6,15.8 +1918,14.6,9.7 +1919,16.2,10.1 +1920,24.7,8.6 diff --git a/doc/LectureNotes/src/Hudson_Bay.py b/doc/LectureNotes/src/Hudson_Bay.py new file mode 100644 index 000000000..bff849971 --- /dev/null +++ b/doc/LectureNotes/src/Hudson_Bay.py @@ -0,0 +1,43 @@ +import numpy as np +import matplotlib.pyplot as plt + +def solver(m, H0, L0, dt, a, b, c, d, t0): + """Solve the difference equations for H and L over m years + with time step dt (measured in years.""" + + num_intervals = int(m/float(dt)) + t = np.linspace(t0, t0 + m, num_intervals+1) + H = np.zeros(t.size) + L = np.zeros(t.size) + + print('Init:', H0, L0, dt) + H[0] = H0 + L[0] = L0 + + for n in range(0, len(t)-1): + H[n+1] = H[n] + a*dt*H[n] - b*dt*H[n]*L[n] + L[n+1] = L[n] + d*dt*H[n]*L[n] - c*dt*L[n] + return H, L, t + +# Load in data file +data = np.loadtxt('src/Hudson_Bay.csv', delimiter=',', skiprows=1) +# Make arrays containing x-axis and hares and lynx populations +t_e = data[:,0] +H_e = data[:,1] +L_e = data[:,2] + +# Simulate using the model +H, L, t = solver(m=20, H0=34.91, L0=3.857, dt=0.1, + a=0.4807, b=0.02482, c=0.9272, d=0.02756, + t0=1900) + +# Visualize simulations and data +plt.plot(t_e, H_e, 'b-+', t_e, L_e, 'r-o', t, H, 'm--', t, L, 'k--') +plt.xlabel('Year') +plt.ylabel('Numbers of hares and lynx') +plt.axis([1900, 1920, 0, 140]) +plt.title(r'Population of hares and lynx 1900-1920 (x1000)') +plt.legend(('H_e', 'L_e', 'H', 'L'), loc='upper left') +plt.savefig('Hudson_Bay_sim.pdf') +plt.savefig('Hudson_Bay_sim.png') +plt.show() diff --git a/doc/LectureNotes/src/Hudson_Bay_sim.pdf b/doc/LectureNotes/src/Hudson_Bay_sim.pdf new file mode 100644 index 0000000000000000000000000000000000000000..59eabb8719fa62936d401e21a930b6fb501ebe4f GIT binary patch literal 17919 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 ZnyzRQ7c_Qxf+G2#0wk=gGHS9U{|o8$>yZEe literal 0 HcmV?d00001 diff --git a/doc/LectureNotes/src/Hudson_Bay_sim.png b/doc/LectureNotes/src/Hudson_Bay_sim.png new file mode 100644 index 0000000000000000000000000000000000000000..41af1e52e2b54fe47dc43a9c6c1938618e706436 GIT binary patch literal 67454 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⪚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