lars/FYS-STK4155
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
918b257206cf799e8d241da317da38bf68db2f4c
FYS-STK4155/doc/pub/How2ReadData/ipynb/How2ReadData.ipynb
T
mhjensen 918b257206 update on intro
2020-08-19 11:44:46 +02:00

3091 lines
309 KiB
Plaintext
Raw Blame History

{
"cells": [
{
"cell_type": "markdown",
"metadata": {},
"source": [
"<!-- dom:TITLE: Data Analysis and Machine Learning: Getting started, our first data and Machine Learning encounters -->\n",
"# Data Analysis and Machine Learning: Getting started, our first data and Machine Learning encounters\n",
"<!-- dom:AUTHOR: Morten Hjorth-Jensen at Department of Physics, University of Oslo & Department of Physics and Astronomy and National Superconducting Cyclotron Laboratory, Michigan State University -->\n",
"<!-- Author: --> \n",
"**Morten Hjorth-Jensen**, Department of Physics, University of Oslo and Department of Physics and Astronomy and National Superconducting Cyclotron Laboratory, Michigan State University\n",
"\n",
"Date: **Dec 25, 2019**\n",
"\n",
"Copyright 1999-2019, Morten Hjorth-Jensen. Released under CC Attribution-NonCommercial 4.0 license\n",
"\n",
"\n",
"\n",
"\n",
"\n",
"\n",
"## Introduction\n",
"\n",
"Our emphasis throughout this series of lectures \n",
"is on understanding the mathematical aspects of\n",
"different algorithms used in the fields of data analysis and machine learning. \n",
"\n",
"However, where possible we will emphasize the\n",
"importance of using available software. We start thus with a hands-on\n",
"and top-down approach to machine learning. The aim is thus to start with\n",
"relevant data or data we have produced \n",
"and use these to introduce statistical data analysis\n",
"concepts and machine learning algorithms before we delve into the\n",
"algorithms themselves. The examples we will use in the beginning, start with simple\n",
"polynomials with random noise added. We will use the Python\n",
"software package [Scikit-Learn](http://scikit-learn.org/stable/) and\n",
"introduce various machine learning algorithms to make fits of\n",
"the data and predictions. We move thereafter to more interesting\n",
"cases such as data from say experiments (below we will look at experimental nuclear binding energies as an example).\n",
"These are examples where we can easily set up the data and\n",
"then use machine learning algorithms included in for example\n",
"**Scikit-Learn**. \n",
"\n",
"These examples will serve us the purpose of getting\n",
"started. Furthermore, they allow us to catch more than two birds with\n",
"a stone. They will allow us to bring in some programming specific\n",
"topics and tools as well as showing the power of various Python \n",
"libraries for machine learning and statistical data analysis. \n",
"\n",
"Here, we will mainly focus on two\n",
"specific Python packages for Machine Learning, Scikit-Learn and\n",
"Tensorflow (see below for links etc). Moreover, the examples we\n",
"introduce will serve as inputs to many of our discussions later, as\n",
"well as allowing you to set up models and produce your own data and\n",
"get started with programming.\n",
"\n",
"\n",
"\n",
"## What is Machine Learning?\n",
"\n",
"Statistics, data science and machine learning form important fields of\n",
"research in modern science. They describe how to learn and make\n",
"predictions from data, as well as allowing us to extract important\n",
"correlations about physical process and the underlying laws of motion\n",
"in large data sets. The latter, big data sets, appear frequently in\n",
"essentially all disciplines, from the traditional Science, Technology,\n",
"Mathematics and Engineering fields to Life Science, Law, education\n",
"research, the Humanities and the Social Sciences. \n",
"\n",
"It has become more\n",
"and more common to see research projects on big data in for example\n",
"the Social Sciences where extracting patterns from complicated survey\n",
"data is one of many research directions. Having a solid grasp of data\n",
"analysis and machine learning is thus becoming central to scientific\n",
"computing in many fields, and competences and skills within the fields\n",
"of machine learning and scientific computing are nowadays strongly\n",
"requested by many potential employers. The latter cannot be\n",
"overstated, familiarity with machine learning has almost become a\n",
"prerequisite for many of the most exciting employment opportunities,\n",
"whether they are in bioinformatics, life science, physics or finance,\n",
"in the private or the public sector. This author has had several\n",
"students or met students who have been hired recently based on their\n",
"skills and competences in scientific computing and data science, often\n",
"with marginal knowledge of machine learning.\n",
"\n",
"Machine learning is a subfield of computer science, and is closely\n",
"related to computational statistics. It evolved from the study of\n",
"pattern recognition in artificial intelligence (AI) research, and has\n",
"made contributions to AI tasks like computer vision, natural language\n",
"processing and speech recognition. Many of the methods we will study are also \n",
"strongly rooted in basic mathematics and physics research. \n",
"\n",
"Ideally, machine learning represents the science of giving computers\n",
"the ability to learn without being explicitly programmed. The idea is\n",
"that there exist generic algorithms which can be used to find patterns\n",
"in a broad class of data sets without having to write code\n",
"specifically for each problem. The algorithm will build its own logic\n",
"based on the data. You should however always keep in mind that\n",
"machines and algorithms are to a large extent developed by humans. The\n",
"insights and knowledge we have about a specific system, play a central\n",
"role when we develop a specific machine learning algorithm. \n",
"\n",
"Machine learning is an extremely rich field, in spite of its young\n",
"age. The increases we have seen during the last three decades in\n",
"computational capabilities have been followed by developments of\n",
"methods and techniques for analyzing and handling large date sets,\n",
"relying heavily on statistics, computer science and mathematics. The\n",
"field is rather new and developing rapidly. Popular software packages\n",
"written in Python for machine learning like\n",
"[Scikit-learn](http://scikit-learn.org/stable/),\n",
"[Tensorflow](https://www.tensorflow.org/),\n",
"[PyTorch](http://pytorch.org/) and [Keras](https://keras.io/), all\n",
"freely available at their respective GitHub sites, encompass\n",
"communities of developers in the thousands or more. And the number of\n",
"code developers and contributors keeps increasing. Not all the\n",
"algorithms and methods can be given a rigorous mathematical\n",
"justification, opening up thereby large rooms for experimenting and\n",
"trial and error and thereby exciting new developments. However, a\n",
"solid command of linear algebra, multivariate theory, probability\n",
"theory, statistical data analysis, understanding errors and Monte\n",
"Carlo methods are central elements in a proper understanding of many\n",
"of algorithms and methods we will discuss.\n",
"\n",
"\n",
"\n",
"## Types of Machine Learning\n",
"\n",
"\n",
"The approaches to machine learning are many, but are often split into\n",
"two main categories. In *supervised learning* we know the answer to a\n",
"problem, and let the computer deduce the logic behind it. On the other\n",
"hand, *unsupervised learning* is a method for finding patterns and\n",
"relationship in data sets without any prior knowledge of the system.\n",
"Some authours also operate with a third category, namely\n",
"*reinforcement learning*. This is a paradigm of learning inspired by\n",
"behavioral psychology, where learning is achieved by trial-and-error,\n",
"solely from rewards and punishment.\n",
"\n",
"Another way to categorize machine learning tasks is to consider the\n",
"desired output of a system. Some of the most common tasks are:\n",
"\n",
" * Classification: Outputs are divided into two or more classes. The goal is to produce a model that assigns inputs into one of these classes. An example is to identify digits based on pictures of hand-written ones. Classification is typically supervised learning.\n",
"\n",
" * Regression: Finding a functional relationship between an input data set and a reference data set. The goal is to construct a function that maps input data to continuous output values.\n",
"\n",
" * Clustering: Data are divided into groups with certain common traits, without knowing the different groups beforehand. It is thus a form of unsupervised learning.\n",
"\n",
"The methods we cover have three main topics in common, irrespective of\n",
"whether we deal with supervised or unsupervised learning. The first\n",
"ingredient is normally our data set (which can be subdivided into\n",
"training and test data), the second item is a model which is normally a\n",
"function of some parameters. The model reflects our knowledge of the system (or lack thereof). As an example, if we know that our data show a behavior similar to what would be predicted by a polynomial, fitting our data to a polynomial of some degree would then determin our model. \n",
"\n",
"The last ingredient is a so-called **cost**\n",
"function which allows us to present an estimate on how good our model\n",
"is in reproducing the data it is supposed to train. \n",
"At the heart of basically all ML algorithms there are so-called minimization algorithms, often we end up with various variants of **gradient** methods.\n",
"\n",
"\n",
"\n",
"\n",
"\n",
"\n",
"\n",
"## Software and needed installations\n",
"\n",
"We will make extensive use of Python as programming language and its\n",
"myriad of available libraries. You will find\n",
"Jupyter notebooks invaluable in your work. You can run **R**\n",
"codes in the Jupyter/IPython notebooks, with the immediate benefit of\n",
"visualizing your data. You can also use compiled languages like C++,\n",
"Rust, Julia, Fortran etc if you prefer. The focus in these lectures will be\n",
"on Python.\n",
"\n",
"\n",
"If you have Python installed (we strongly recommend Python3) and you feel\n",
"pretty familiar with installing different packages, we recommend that\n",
"you install the following Python packages via **pip** as \n",
"\n",
"1. pip install numpy scipy matplotlib ipython scikit-learn mglearn sympy pandas pillow \n",
"\n",
"For Python3, replace **pip** with **pip3**.\n",
"\n",
"For OSX users we recommend, after having installed Xcode, to\n",
"install **brew**. Brew allows for a seamless installation of additional\n",
"software via for example \n",
"\n",
"1. brew install python3\n",
"\n",
"For Linux users, with its variety of distributions like for example the widely popular Ubuntu distribution,\n",
"you can use **pip** as well and simply install Python as \n",
"\n",
"1. sudo apt-get install python3 (or python for pyhton2.7)\n",
"\n",
"etc etc. \n",
"\n",
"\n",
"\n",
"## Python installers\n",
"\n",
"If you don't want to perform these operations separately and venture\n",
"into the hassle of exploring how to set up dependencies and paths, we\n",
"recommend two widely used distrubutions which set up all relevant\n",
"dependencies for Python, namely \n",
"\n",
"* [Anaconda](https://docs.anaconda.com/), \n",
"\n",
"which is an open source\n",
"distribution of the Python and R programming languages for large-scale\n",
"data processing, predictive analytics, and scientific computing, that\n",
"aims to simplify package management and deployment. Package versions\n",
"are managed by the package management system **conda**. \n",
"\n",
"* [Enthought canopy](https://www.enthought.com/product/canopy/) \n",
"\n",
"is a Python\n",
"distribution for scientific and analytic computing distribution and\n",
"analysis environment, available for free and under a commercial\n",
"license.\n",
"\n",
"Furthermore, [Google's Colab](https://colab.research.google.com/notebooks/welcome.ipynb) is a free Jupyter notebook environment that requires \n",
"no setup and runs entirely in the cloud. Try it out!\n",
"\n",
"## Useful Python libraries\n",
"Here we list several useful Python libraries we strongly recommend (if you use anaconda many of these are already there)\n",
"\n",
"* [NumPy](https://www.numpy.org/) is a highly popular library for large, multi-dimensional arrays and matrices, along with a large collection of high-level mathematical functions to operate on these arrays\n",
"\n",
"* [The pandas](https://pandas.pydata.org/) library provides high-performance, easy-to-use data structures and data analysis tools \n",
"\n",
"* [Xarray](http://xarray.pydata.org/en/stable/) is a Python package that makes working with labelled multi-dimensional arrays simple, efficient, and fun!\n",
"\n",
"* [Scipy](https://www.scipy.org/) (pronounced “Sigh Pie”) is a Python-based ecosystem of open-source software for mathematics, science, and engineering. \n",
"\n",
"* [Matplotlib](https://matplotlib.org/) is a Python 2D plotting library which produces publication quality figures in a variety of hardcopy formats and interactive environments across platforms.\n",
"\n",
"* [Autograd](https://github.com/HIPS/autograd) can automatically differentiate native Python and Numpy code. It can handle a large subset of Python's features, including loops, ifs, recursion and closures, and it can even take derivatives of derivatives of derivatives\n",
"\n",
"* [SymPy](https://www.sympy.org/en/index.html) is a Python library for symbolic mathematics. \n",
"\n",
"* [scikit-learn](https://scikit-learn.org/stable/) has simple and efficient tools for machine learning, data mining and data analysis\n",
"\n",
"* [TensorFlow](https://www.tensorflow.org/) is a Python library for fast numerical computing created and released by Google\n",
"\n",
"* [Keras](https://keras.io/) is a high-level neural networks API, written in Python and capable of running on top of TensorFlow, CNTK, or Theano\n",
"\n",
"* And many more such as [pytorch](https://pytorch.org/), [Theano](https://pypi.org/project/Theano/) etc \n",
"\n",
"## Installing R, C++, cython or Julia\n",
"\n",
"You will also find it convenient to utilize **R**. We will mainly\n",
"use Python during our lectures and in various projects and exercises.\n",
"Those of you\n",
"already familiar with **R** should feel free to continue using **R**, keeping\n",
"however an eye on the parallel Python set ups. Similarly, if you are a\n",
"Python afecionado, feel free to explore **R** as well. Jupyter/Ipython\n",
"notebook allows you to run **R** codes interactively in your\n",
"browser. The software library **R** is really tailored for statistical data analysis\n",
"and allows for an easy usage of the tools and algorithms we will discuss in these\n",
"lectures.\n",
"\n",
"To install **R** with Jupyter notebook \n",
"[follow the link here](https://mpacer.org/maths/r-kernel-for-ipython-notebook)\n",
"\n",
"\n",
"\n",
"\n",
"## Installing R, C++, cython, Numba etc\n",
"\n",
"\n",
"For the C++ aficionados, Jupyter/IPython notebook allows you also to\n",
"install C++ and run codes written in this language interactively in\n",
"the browser. Since we will emphasize writing many of the algorithms\n",
"yourself, you can thus opt for either Python or C++ (or Fortran or other compiled languages) as programming\n",
"languages.\n",
"\n",
"To add more entropy, **cython** can also be used when running your\n",
"notebooks. It means that Python with the jupyter notebook\n",
"setup allows you to integrate widely popular softwares and tools for\n",
"scientific computing. Similarly, the \n",
"[Numba Python package](https://numba.pydata.org/) delivers increased performance\n",
"capabilities with minimal rewrites of your codes. With its\n",
"versatility, including symbolic operations, Python offers a unique\n",
"computational environment. Your jupyter notebook can easily be\n",
"converted into a nicely rendered **PDF** file or a Latex file for\n",
"further processing. For example, convert to latex as"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
" pycod jupyter nbconvert filename.ipynb --to latex \n"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"And to add more versatility, the Python package [SymPy](http://www.sympy.org/en/index.html) is a Python library for symbolic mathematics. It aims to become a full-featured computer algebra system (CAS) and is entirely written in Python. \n",
"\n",
"Finally, if you wish to use the light mark-up language \n",
"[doconce](https://github.com/hplgit/doconce) you can convert a standard ascii text file into various HTML \n",
"formats, ipython notebooks, latex files, pdf files etc with minimal edits. These lectures were generated using **doconce**.\n",
"\n",
"\n",
"\n",
"## Numpy examples and Important Matrix and vector handling packages\n",
"\n",
"There are several central software libraries for linear algebra and eigenvalue problems. Several of the more\n",
"popular ones have been wrapped into ofter software packages like those from the widely used text **Numerical Recipes**. The original source codes in many of the available packages are often taken from the widely used\n",
"software package LAPACK, which follows two other popular packages\n",
"developed in the 1970s, namely EISPACK and LINPACK. We describe them shortly here.\n",
"\n",
" * LINPACK: package for linear equations and least square problems.\n",
"\n",
" * LAPACK:package for solving symmetric, unsymmetric and generalized eigenvalue problems. From LAPACK's website <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.\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 <http://www.netlib.org>.\n",
"\n",
"## Basic Matrix Features\n",
"\n",
"**Matrix properties reminder.**"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"$$\n",
"\\mathbf{A} =\n",
" \\begin{bmatrix} a_{11} & a_{12} & a_{13} & a_{14} \\\\\n",
" a_{21} & a_{22} & a_{23} & a_{24} \\\\\n",
" a_{31} & a_{32} & a_{33} & a_{34} \\\\\n",
" a_{41} & a_{42} & a_{43} & a_{44}\n",
" \\end{bmatrix}\\qquad\n",
"\\mathbf{I} =\n",
" \\begin{bmatrix} 1 & 0 & 0 & 0 \\\\\n",
" 0 & 1 & 0 & 0 \\\\\n",
" 0 & 0 & 1 & 0 \\\\\n",
" 0 & 0 & 0 & 1\n",
" \\end{bmatrix}\n",
"$$"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"The inverse of a matrix is defined by"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"$$\n",
"\\mathbf{A}^{-1} \\cdot \\mathbf{A} = I\n",
"$$"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"<table border=\"1\">\n",
"<thead>\n",
"<tr><th align=\"center\"> Relations </th> <th align=\"center\"> Name </th> <th align=\"center\"> matrix elements </th> </tr>\n",
"</thead>\n",
"<tbody>\n",
"<tr><td align=\"center\"> $A = A^{T}$ </td> <td align=\"center\"> symmetric </td> <td align=\"center\"> $a_{ij} = a_{ji}$ </td> </tr>\n",
"<tr><td align=\"center\"> $A = \\left (A^{T} \\right )^{-1}$ </td> <td align=\"center\"> real orthogonal </td> <td align=\"center\"> $\\sum_k a_{ik} a_{jk} = \\sum_k a_{ki} a_{kj} = \\delta_{ij}$ </td> </tr>\n",
"<tr><td align=\"center\"> $A = A^{ * }$ </td> <td align=\"center\"> real matrix </td> <td align=\"center\"> $a_{ij} = a_{ij}^{ * }$ </td> </tr>\n",
"<tr><td align=\"center\"> $A = A^{\\dagger}$ </td> <td align=\"center\"> hermitian </td> <td align=\"center\"> $a_{ij} = a_{ji}^{ * }$ </td> </tr>\n",
"<tr><td align=\"center\"> $A = \\left (A^{\\dagger} \\right )^{-1}$ </td> <td align=\"center\"> unitary </td> <td align=\"center\"> $\\sum_k a_{ik} a_{jk}^{ * } = \\sum_k a_{ki}^{ * } a_{kj} = \\delta_{ij}$ </td> </tr>\n",
"</tbody>\n",
"</table>\n",
"\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",
"### More Basic Matrix Features\n",
"\n",
"**Some Equivalent Statements.**\n",
"\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",
"\n",
"\n",
"\n",
"## Numpy and arrays\n",
"[Numpy](http://www.numpy.org/) provides an easy way to handle arrays in Python. The standard way to import this library is as"
]
},
{
"cell_type": "code",
"execution_count": 1,
"metadata": {},
"outputs": [],
"source": [
"import nump\n",
"y as np"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Here follows a simple example where we set up an array of ten elements, all determined by random numbers drawn according to the normal distribution,"
]
},
{
"cell_type": "code",
"execution_count": 39,
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"[ 0.62788768 0.95270524 -0.82962774 1.16046637 -0.31152511 -0.53939102\n",
" 0.54043276 0.14069506 1.23826241 -1.28557386]\n",
"0.9527052435093047\n"
]
}
],
"source": [
"n = 10\n",
"x = np.random.normal(size=n)\n",
"print(x)\n",
"print(x[1])"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"We defined a vector $x$ with $n=10$ elements with its values given by the Normal distribution $N(0,1)$.\n",
"Another alternative is to declare a vector as follows"
]
},
{
"cell_type": "code",
"execution_count": 3,
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"[1 2 3]\n"
]
}
],
"source": [
"import numpy as np\n",
"x = np.array([1, 2, 3])\n",
"print(x)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Here we have defined a vector with three elements, with $x_0=1$, $x_1=2$ and $x_2=3$. Note that both Python and C++\n",
"start numbering array elements from $0$ and on. This means that a vector with $n$ elements has a sequence of entities $x_0, x_1, x_2, \\dots, x_{n-1}$. We could also let (recommended) Numpy to compute the logarithms of a specific array as"
]
},
{
"cell_type": "code",
"execution_count": 4,
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"[1.38629436 1.94591015 2.07944154]\n"
]
}
],
"source": [
"import numpy as np\n",
"x = np.log(np.array([4, 7, 8]))\n",
"print(x)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"In the last example we used Numpy's unary function $np.log$. This function is\n",
"highly tuned to compute array elements since the code is vectorized\n",
"and does not require looping. We normaly recommend that you use the\n",
"Numpy intrinsic functions instead of the corresponding **log** function\n",
"from Python's **math** module. The looping is done explicitely by the\n",
"**np.log** function. The alternative, and slower way to compute the\n",
"logarithms of a vector would be to write"
]
},
{
"cell_type": "code",
"execution_count": 5,
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"[1 1 2]\n"
]
}
],
"source": [
"import numpy as np\n",
"from math import log\n",
"x = np.array([4, 7, 8])\n",
"for i in range(0, len(x)):\n",
" x[i] = log(x[i])\n",
"print(x)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"We note that our code is much longer already and we need to import the **log** function from the **math** module. \n",
"The attentive reader will also notice that the output is $[1, 1, 2]$. Python interprets automagically our numbers as integers (like the **automatic** keyword in C++). To change this we could define our array elements to be double precision numbers as"
]
},
{
"cell_type": "code",
"execution_count": 6,
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"[1.38629436 1.94591015 2.07944154]\n"
]
}
],
"source": [
"import numpy as np\n",
"x = np.log(np.array([4, 7, 8], dtype = np.float64))\n",
"print(x)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"or simply write them as double precision numbers (Python uses 64 bits as default for floating point type variables), that is"
]
},
{
"cell_type": "code",
"execution_count": 8,
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"[1.38629436 1.94591015 2.07944154]\n"
]
}
],
"source": [
"import numpy as np\n",
"x = np.log(np.array([4.0, 7.0, 8.0]))\n",
"print(x)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"To check the number of bytes (remember that one byte contains eight bits for double precision variables), you can use simple use the **itemsize** functionality (the array $x$ is actually an object which inherits the functionalities defined in Numpy) as"
]
},
{
"cell_type": "code",
"execution_count": 10,
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"8\n"
]
}
],
"source": [
"import numpy as np\n",
"x = np.log(np.array([4.0, 7.0, 8.0]))\n",
"print(x.itemsize)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## Matrices in Python\n",
"\n",
"Having defined vectors, we are now ready to try out matrices. We can\n",
"define a $3 \\times 3 $ real matrix $\\hat{A}$ as (recall that we user\n",
"lowercase letters for vectors and uppercase letters for matrices)"
]
},
{
"cell_type": "code",
"execution_count": 11,
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"[[1.38629436 1.94591015 2.07944154]\n",
" [1.09861229 2.30258509 2.39789527]\n",
" [1.38629436 1.60943791 1.94591015]]\n"
]
}
],
"source": [
"import numpy as np\n",
"A = np.log(np.array([ [4.0, 7.0, 8.0], [3.0, 10.0, 11.0], [4.0, 5.0, 7.0] ]))\n",
"print(A)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"If we use the **shape** function we would get $(3, 3)$ as output, that is verifying that our matrix is a $3\\times 3$ matrix. We can slice the matrix and print for example the first column (Python organized matrix elements in a row-major order, see below) as"
]
},
{
"cell_type": "code",
"execution_count": 12,
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"[1.38629436 1.09861229 1.38629436]\n"
]
}
],
"source": [
"import numpy as np\n",
"A = np.log(np.array([ [4.0, 7.0, 8.0], [3.0, 10.0, 11.0], [4.0, 5.0, 7.0] ]))\n",
"# print the first column, row-major order and elements start with 0\n",
"print(A[:,0])"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"We can continue this was by printing out other columns or rows. The example here prints out the second column"
]
},
{
"cell_type": "code",
"execution_count": 13,
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"[1.09861229 2.30258509 2.39789527]\n"
]
}
],
"source": [
"import numpy as np\n",
"A = np.log(np.array([ [4.0, 7.0, 8.0], [3.0, 10.0, 11.0], [4.0, 5.0, 7.0] ]))\n",
"# print the first column, row-major order and elements start with 0\n",
"print(A[1,:])"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Numpy contains many other functionalities that allow us to slice, subdivide etc etc arrays. We strongly recommend that you look up the [Numpy website for more details](http://www.numpy.org/). Useful functions when defining a matrix are the **np.zeros** function which declares a matrix of a given dimension and sets all elements to zero"
]
},
{
"cell_type": "code",
"execution_count": 14,
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"[[0. 0. 0. 0. 0. 0. 0. 0. 0. 0.]\n",
" [0. 0. 0. 0. 0. 0. 0. 0. 0. 0.]\n",
" [0. 0. 0. 0. 0. 0. 0. 0. 0. 0.]\n",
" [0. 0. 0. 0. 0. 0. 0. 0. 0. 0.]\n",
" [0. 0. 0. 0. 0. 0. 0. 0. 0. 0.]\n",
" [0. 0. 0. 0. 0. 0. 0. 0. 0. 0.]\n",
" [0. 0. 0. 0. 0. 0. 0. 0. 0. 0.]\n",
" [0. 0. 0. 0. 0. 0. 0. 0. 0. 0.]\n",
" [0. 0. 0. 0. 0. 0. 0. 0. 0. 0.]\n",
" [0. 0. 0. 0. 0. 0. 0. 0. 0. 0.]]\n"
]
}
],
"source": [
"import numpy as np\n",
"n = 10\n",
"# define a matrix of dimension 10 x 10 and set all elements to zero\n",
"A = np.zeros( (n, n) )\n",
"print(A)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"or initializing all elements to"
]
},
{
"cell_type": "code",
"execution_count": 41,
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"[[1. 0. 0. 0. 0. 0. 0. 0. 0. 0.]\n",
" [0. 1. 0. 0. 0. 0. 0. 0. 0. 0.]\n",
" [0. 0. 1. 0. 0. 0. 0. 0. 0. 0.]\n",
" [0. 0. 0. 1. 0. 0. 0. 0. 0. 0.]\n",
" [0. 0. 0. 0. 1. 0. 0. 0. 0. 0.]\n",
" [0. 0. 0. 0. 0. 1. 0. 0. 0. 0.]\n",
" [0. 0. 0. 0. 0. 0. 1. 0. 0. 0.]\n",
" [0. 0. 0. 0. 0. 0. 0. 1. 0. 0.]\n",
" [0. 0. 0. 0. 0. 0. 0. 0. 1. 0.]\n",
" [0. 0. 0. 0. 0. 0. 0. 0. 0. 1.]]\n"
]
}
],
"source": [
"import numpy as np\n",
"n = 10\n",
"# define a matrix of dimension 10 x 10 and set all elements to one\n",
"A = np.eye( n )\n",
"print(A)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"or as unitarily distributed random numbers (see the material on random number generators in the statistics part)"
]
},
{
"cell_type": "code",
"execution_count": 16,
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"[[0.13883235 0.16578794 0.83591324 0.53093229 0.43828658 0.44147294\n",
" 0.81058042 0.90471242 0.75985306 0.65015412]\n",
" [0.5367777 0.62064869 0.5730995 0.44783891 0.55254031 0.22916951\n",
" 0.62502415 0.72544464 0.28186865 0.24079007]\n",
" [0.87309444 0.39639182 0.48916514 0.37108014 0.70819769 0.30059633\n",
" 0.50624688 0.97434081 0.08628836 0.07529887]\n",
" [0.93778677 0.80013962 0.75663638 0.52493405 0.91289002 0.62967827\n",
" 0.18833956 0.69572614 0.63064934 0.58702011]\n",
" [0.38917221 0.40771118 0.52341532 0.086439 0.41964853 0.82852196\n",
" 0.75017796 0.72808162 0.80634896 0.85284583]\n",
" [0.50492119 0.70610108 0.6424576 0.99407265 0.37489802 0.06411849\n",
" 0.49740309 0.64476141 0.80370131 0.20204962]\n",
" [0.99276881 0.97391374 0.10766979 0.76043228 0.38014282 0.33403001\n",
" 0.33157174 0.44297261 0.35781497 0.1575419 ]\n",
" [0.98529248 0.56354013 0.72044581 0.26099864 0.20825739 0.90771836\n",
" 0.54856735 0.31785249 0.7272262 0.38895366]\n",
" [0.74084311 0.31846284 0.34420921 0.43345144 0.05781962 0.35254955\n",
" 0.4309125 0.84639667 0.63585381 0.89812415]\n",
" [0.64935106 0.15417975 0.0916722 0.85895396 0.39864154 0.1850318\n",
" 0.76465137 0.4577945 0.075374 0.93877457]]\n"
]
}
],
"source": [
"import numpy as np\n",
"n = 10\n",
"# define a matrix of dimension 10 x 10 and set all elements to random numbers with x \\in [0, 1]\n",
"A = np.random.rand(n, n)\n",
"print(A)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"As we will see throughout these lectures, there are several extremely useful functionalities in Numpy.\n",
"As an example, consider the discussion of the covariance matrix. Suppose we have defined three vectors\n",
"$\\hat{x}, \\hat{y}, \\hat{z}$ with $n$ elements each. The covariance matrix is defined as"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"$$\n",
"\\hat{\\Sigma} = \\begin{bmatrix} \\sigma_{xx} & \\sigma_{xy} & \\sigma_{xz} \\\\\n",
" \\sigma_{yx} & \\sigma_{yy} & \\sigma_{yz} \\\\\n",
" \\sigma_{zx} & \\sigma_{zy} & \\sigma_{zz} \n",
" \\end{bmatrix},\n",
"$$"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"where for example"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"$$\n",
"\\sigma_{xy} =\\frac{1}{n} \\sum_{i=0}^{n-1}(x_i- \\overline{x})(y_i- \\overline{y}).\n",
"$$"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"The Numpy function **np.cov** calculates the covariance elements using the factor $1/(n-1)$ instead of $1/n$ since it assumes we do not have the exact mean values. \n",
"The following simple function uses the **np.vstack** function which takes each vector of dimension $1\\times n$ and produces a $3\\times n$ matrix $\\hat{W}$"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"$$\n",
"\\hat{W} = \\begin{bmatrix} x_0 & y_0 & z_0 \\\\\n",
" x_1 & y_1 & z_1 \\\\\n",
" x_2 & y_2 & z_2 \\\\\n",
" \\dots & \\dots & \\dots \\\\\n",
" x_{n-2} & y_{n-2} & z_{n-2} \\\\\n",
" x_{n-1} & y_{n-1} & z_{n-1}\n",
" \\end{bmatrix},\n",
"$$"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"which in turn is converted into into the $3\\times 3$ covariance matrix\n",
"$\\hat{\\Sigma}$ via the Numpy function **np.cov()**. We note that we can also calculate\n",
"the mean value of each set of samples $\\hat{x}$ etc using the Numpy\n",
"function **np.mean(x)**. We can also extract the eigenvalues of the\n",
"covariance matrix through the **np.linalg.eig()** function."
]
},
{
"cell_type": "code",
"execution_count": 17,
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"0.20381774252138393\n",
"4.6822329078411125\n",
"0.4103425751132706\n",
"[[ 0.94483537 2.78661332 2.62703645]\n",
" [ 2.78661332 8.9863123 7.90574506]\n",
" [ 2.62703645 7.90574506 11.15801875]]\n",
"[18.86323713 0.06809913 2.15783016]\n"
]
}
],
"source": [
"# Importing various packages\n",
"import numpy as np\n",
"\n",
"n = 100\n",
"x = np.random.normal(size=n)\n",
"print(np.mean(x))\n",
"y = 4+3*x+np.random.normal(size=n)\n",
"print(np.mean(y))\n",
"z = x**3+np.random.normal(size=n)\n",
"print(np.mean(z))\n",
"W = np.vstack((x, y, z))\n",
"Sigma = np.cov(W)\n",
"print(Sigma)\n",
"Eigvals, Eigvecs = np.linalg.eig(Sigma)\n",
"print(Eigvals)"
]
},
{
"cell_type": "code",
"execution_count": 19,
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"[[1. 0. 0. 0.]\n",
" [0. 1. 0. 0.]\n",
" [0. 0. 1. 0.]\n",
" [0. 0. 0. 1.]]\n",
" (0, 0)\t1.0\n",
" (1, 1)\t1.0\n",
" (2, 2)\t1.0\n",
" (3, 3)\t1.0\n"
]
},
{
"data": {
"image/png": "iVBORw0KGgoAAAANSUhEUgAAAYIAAAD4CAYAAADhNOGaAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAALEgAACxIB0t1+/AAAADh0RVh0U29mdHdhcmUAbWF0cGxvdGxpYiB2ZXJzaW9uMy4yLjIsIGh0dHA6Ly9tYXRwbG90bGliLm9yZy+WH4yJAAAgAElEQVR4nOy9eXxbV533/z6SLS+SvMqyHTuJY9nZ4yxN09Rd0p0WKGlhoBul83uY6WRoYVjmmekzC8M8DAyzUBimBVOWZ1gCZSu0QAq0hbqLm5Dd2W3LiRPHji15l3dJ5/fH1VWU1E7saLtXuu/Xyy9b0r3Syc3V+Xy/57scIaXEwMDAwCB9MSV7AAYGBgYGycUQAgMDA4M0xxACAwMDgzTHEAIDAwODNMcQAgMDA4M0JyPZA7gSHA6HrKqqSvYwDAwMDHTF3r17vVLKkouf16UQVFVVsWfPnmQPw8DAwEBXCCE6ZnreWBoyMDAwSHMMITAwMDBIcwwhMDAwMEhzDCEwMDAwSHMMITAwMDBIc2IiBEKIbwsheoUQh2d5XQghviKEaBNCNAshNkS8dqcQ4kTotSdiMR6D2NLQ6KbJ7b3guSa3l4ZGd5JGlD4Y1z65pMv1j5VH8D/AnZd4/S6gNvTzKPA1ACGEGXg69PpK4AEhxMoYjckgRtRV5vP4D/aHvxBNbi+P/2A/dZX5SR5Z6hN57Rsa3XzjdfcF1z4VJyUtkS7XPyZ1BFLK14QQVZc4ZCvwXan0vN4phCgQQpQDVUCblLIdQAjxbOjYo7EYl0FsqHc5eOrB9Wz73l6c9izODU/wzIc2Uu9yAMqXoblziG1bXEkeaeqhXvvHtu9jaamdP57s5+/etZx6lyMsyE89uD7Zw0xZ1Ov/l9/fx8bFhfz+eG9KXv9EFZRVAGciHneGnpvp+WtmegMhxKMo3gSLFi2KzygNwjQ0uqmrzA9P9r3Dk4xM+Bme8APw/bc6WFSUy+n+sZT5MmiFi699XWUBQsCuk/0A/OuO4/z2cA9uj4+nH9oQPs4gPgyNTTM0Ps0rx3sB5fofOD3EW+19PPXg+pS4/okKFosZnpOXeP7tT0r5jJRyo5RyY0nJ2yqkDWJM2CVu8/L0H9r4+I8OIIHrXMVkmAQ7Dp/j1i828pHt+1Lmy6AVIpcjxqb83PXl1+gfnWbdwnxyLWaKrRb2dAxQ7bAZ1z0ORMYF9nYM8LEf7sckoNZpIzvThDXLzK8PdfOeteUpc/0TJQSdwMKIx5VA1yWeN0gyqkv8v76zm//47QkAnrhrGdv/fDPf/fAmLGbBpD9IZWFOynwZtELkctCN//Z7zgyMc+/6Bfzisev5xO21eH1TLC7KYe/pAZ794+lkDzflUIX4uX2dPPLtXfilJMdi5p+3ruJTdyzFNxFAAN99q4M3W88HkvUcL0iUELwAfCiUPbQZGJJSdgO7gVohxBIhhAW4P3SsgQaocdqY8gcBuHfdArZtqQm/lpVppjw/m8Nnh/nBrhnblxhEQb3LQa3Thnd0mo1VhXzpvvU0ub187dV2/u5dy7lnfSVZGSb+7ueHeCNFJiOtUO9y8OT71/LXPznIxHSQ3Ewz3/jQRoDw9b+6qpCghP/1nd00ub26T6CIVfroD4G3gGVCiE4hxIeFENuEENtCh+wA2oE24BvARwCklH7gceC3wDHgx1LKI7EYk0H0fO5XxwhKeHjzYhpbvRfc8F9/+Cruu3ohOZkmPv38EZrazmcUGRNR9Lx6opfdpwZY4rDS7hkNB+SfenA9f36Di0/cvpQ/u34JQQlferkFMLK5Ysm54QmCEvxByYevX0K9y3HB9f/RX1zL+oUFTPqD/MdvToTjZHr1jmOVNfTAZV6XwGOzvLYDRSgMNMQrx3p44WAX1ywp5LP3rOauNWU8/oP9vGNV6QU3/DOvteMPBvnR7jMgMALHMaDJ7eWx7fuQwOfvXYNEzjjR/PU7lvFaq4e9HQP8318e4RcHunQ9GWkFKSVfe9WNWQg+crOL7+86zWZX8QVZcUIIvv6hq7jh3/7A/jODfOyWGl1fd6Oy2GBGvr+zAwn8/buUsg513XpxsTV8w9e7HDzz8EbMJsErx3t4zAgcx4SDZwYptGayojyPzdVF4Wvf3Dl0wXFCCL7ygFKb+e03T/HBaxYZ1z4GfOetDjr6x/jT6xbzqTuW8dSD6y+oo1Fp6/UhAJOA7+7seNvresIQAoMwarbEpD/A0e5h6l3F+Cb94aWeepfjbbUC19c6eMeqUnyTAbYsLTEmoiskMlNlTUUBnQMTbFlawtdfawdmvvYA3UPjZJgEhbmZfH/XaV1PRlrhJ7tPk5Np4pO3LwOYUYjVZbjPvGcVQQn3rKuYUSz0giEEBmHUbIkv/raFnuFJblxactk15ya3l7fcfWSaBC8ePqfbL0KyiUwZ/fabJ8nLzuRHu09f9to//oP9PFJfxcDYNH99x1JdT0bJRBVir2+S1t5R7rt6EQc7B2c1gtR4wf2bFrGiPI99pwdm9Nr0giEEBmFUy+dbb57EYbPwzGvtl1zqUSeipx/awLvXLiDDJHhs+z5jIroCIitYf3+8l+lA8LLFYupk9NFbasg0C056R3U9GSUTVYj/4zcnmAoEWb0g75JG0LYtrvD/zfs2VNDcOUSJLUu31fWGEBhcwOJiK4GgxOubuuyaszoR1bscvLuunNGpAH9+Q7UxEV0h9S4HrhIrAA/NYb1fnYwKci3ctMwZCu4X63YySib1LgdfuX89P9l7hsrCHD7/4vE5x7u2rqvAbBL8dF9nAkYaHwwhMLiAb4bWpD94zaLLrjlHWkU31JaQl51Bm8dnTERXSJPby8Ezg1QW5vDc/rPz8qy2rltAz/Aku9r74jjC1MZsEgQldA6Mzyvw/rN9ndRV5POL/WcJBJXGCHpLozaEwCBMk9vL93d1UJqXxWfvWT1rtsRMWDJMvGNVGS8d6WFiOpCA0aYWTW4vH/n+PgIS/rS+al7XHuCUd5TsTBO/OHD2gvfU02SUbH6wS6nS3ralel6B97rKfFp7ffQMT/JGmz6LywwhMAiz99QAUsK71ixACDFr2uJMNDS6cTltjEz6aWzxAMZENB+aO4d474YKAG5e7pzXtQfYsFipdP3lwS4mpgO6nIySSZPby47D3awsz+OJu1bMS4jrXQ6efmg9Avj8jmO6LC4zhMAgzNIyO/6g5LYVzvBzs6UtXkxdZT5fb3RjyzLzq+ZuYyKaJ9u2uOjoG2NRUS7VDiVOMNdrrx77qduXMj4d5JM/PqjLySiZNLX1EQhK7l67AJg5ZfRSbFnqpLbUxolzI3OK72gNQwgMwrxyrAd7dgZXLyma97mKVbSB6YDkxUPdRnHZPJmYDvCm28vNy0oQYqamvJfnw9cvIdMk2HGo2ygumyeLi3MB2LL0fGfj+Qhxk9vL2YFxQGlGp7fMOUMIDAAIBiW/P+5hy9ISMs1XdlvUuxzcsaoUf1By0zKnMRHNg10n+5mYDnLTcuflD56FP57qB4FRXHYFNLZ4KLFnsaLcPu9zVe/38/euAeA9axforp7DEII0Ry2kaT47hNc3ya0rnFe8tt/k9oY7Yf7GKC6bF3843kt2polrq4uv6Hx1Mnr/VZUMjE3zL1tX6W4yShaBoOT1Vi9bll6ZN6amUW9dX8Gioly6h8Z1V89hCEGaoxbSfKfpJCYBVkvGFa3tRxaXra7IY3FxrjERXQZVhKWU/OFEL/UuB/tOD1yRCEdWugJMB6XuJqNkcbBzkKHx6QuWheZDZBr1dTXF7GrvZ1NVka7SqA0hSHPUoNgLB7spy8vmiecOXdHafmRx2eYlxbR7R3nyA2uNiegSRG6A0tE3xuKi3CsOsKuT0aoF+dizM9jZ3jevNe50I7K3U+MJDyYBWRmmqLPc6l0ORib9NJ/V131vCIEBqyvyCQQlXUMTVxxkjLSKrqkuZsofJDvTbExEl0AV4X98XtmC47n9Z6MOsJtNgmuWFNHkNgrLLkVkb6fGFg9LHFaeeO5Q1Flu9S5lae8tnV1/QwgMwoU096yriEmQcVNVkbLZent/LIaX0tS7HJTmZQPwyLWLYxJg31xdTEffGF2D41G/V6qiivBHtu/jwJlBugYnYpLlVmzLYnmZnTfb9LUkGqsdyu4UQpwQQrQJIZ6Y4fX/LYQ4EPo5LIQICCGKQq+dEkIcCr22JxbjMZg7TW4vX365FQH8y73zqyaejfzcTFaU5bHrpL6somTQ1ObllHeU5WX2mGX6XKtTqzTR1LscYQv+XXVlMctyu67GwZ6OAV1V2EctBEIIM/A0cBewEnhACLEy8hgp5X9IKddJKdcB/wdolFJGmos3h17fGO14DOZHc+cQNSVWVpTnYcvKmHchzWxcU13E3o4BJv36+TIkmia3l78M7UT2wc2LYyLCACvK8ijIzeQto+/QJWlye/n98V5MAl451hsTEW5odFNkzWTKH2Rvx0D4c7ReYR8Lj2AT0CalbJdSTgHPAlsvcfwDwA9j8LkGMeDPrl/CSe8oVy0uDD8XiyDj5upiJv1BI1h8CZo7h/jgNUqWz4ZFhTET4Wdeb6fGabvAI9DDZJRI1Cy3qiIrdZUFPP3QhpiIcF1lPt98XcnAe1NHfYdiIQQVwJmIx52h596GECIXuBP4WcTTEvidEGKvEOLR2T5ECPGoEGKPEGKPx+OJwbANAE70jDA6FWBjVeHlD54jDY1u1GzsnaHJyJiI3s62LS5GJv1YLWaWlSmFTLEQ4brKfI52DXN2cJwz/WO6mYwSSXPnEP91/zpO9Y+yflFBzERYrbA3CcFz+zp10+ojFkIwUwWGnOXYu4E3L1oWuk5KuQFlaekxIcSNM50opXxGSrlRSrmxpOTK8n0N3o7qvm5YFDshqKvM54nnDrGwMIddJ/uNiegS7Ds9wNqFBZhNV9ZWYibqXQ7+6e5VAHzmhSO6mYwSybYtLgpzLUxMB1kfuvdjlW5b73KwpiKfc8OTPLBpoS6ueyyEoBNYGPG4Euia5dj7uWhZSErZFfrdC/wcZanJIEHs7RjAac+isjAnZu+pWle9I5PsbO8z+g7NwtiUn2PdIxcsy8WKD2ysxGIWvHK81+g7NAv7zwwCsH5hQUzft8ntpaXXB8D3dNJ3KBZCsBuoFUIsEUJYUCb7Fy4+SAiRD2wBno94ziqEsKt/A3cAh2MwJoM5srdjgI1VhVfc6Gw26l0OblnuxB+U3L6y1JiIZuDgmSECQRlTb0zlrfY+ghJK7Baj79As7D89gMMWWyNI9X7/5R7FI3v/xoW6qLCPWgiklH7gceC3wDHgx1LKI0KIbUKIbRGH3gv8Tko5GvFcKfCGEOIg8Efg11LK30Q7JoO50TM8QefAeFwmoia3N1zUpLalNriQfaeVZbn1i2JvkT7+g/28c005g2PTPPmBtbqYjBLNgdODrF9UEFMjSK2wv2ddBQW5mfgm/Lpo9RGTOgIp5Q4p5VIppUtK+bnQcw1SyoaIY/5HSnn/Ree1SynXhn5WqecaxBe1vF6ND2ysKoppMFediL720AYKczPZVFVkTEQzsP/0ANUlVgpyLTF9X3Uyumt1GdMBSUGuRReTUSIZGJ2i3TsacxFWK+yFENRVFnCwc1AXrT6MyuI0RC2v/+XBLrIyTAyPT8c0mBvuO1TjYHVFPj0jk8ZEdBFSSvadHoyLN6ZORmtC/5+HdDIZJZIDnUp8YF2M4wORrA1tYTk25Y/bZ8QKQwjSEDWY+7ujPRRbLXz8RwdiGsyN7DtUV5lPa88IGxYVGhMR572xjr4x+ken2LCoMG6ptRUFORRbLYYAz8D+04OYBNRVxlMICggEJUe6huP2GbHCEII0ZePiIqSMrtHcXFhTkY8/KDl+biQu7683VG/sR3uU0huzibil1gohWFOZbwhBiMiOo/tPD7C01E5z52Dc6lvqFir/pwdD2UlaxhCCNOWne88QlHDnqrK4ZpWsCVlchzq1/2VIBKo39u03TpJpFvzbiyfimlpbV1lAa++ILpYn4o0qwm+2ejlwZpAFBTlxrW9x2rMpz8/WhRAbQpCGNLm9fO7XxwD4mzuXxazHzUwsyM+myGrhkM76s8eTepeDgtxMpgOSD26Ob45/XUU+QQlHdbA8EW/CHUd/sI+RCT+72vviXt+yNhQw1jqGEKQhzZ1DXF/rINdipqrYGrPy+pkQQrC6wlieiOSNVi89w5OsqyyIe46/au0eNK4/oIjBpqoiAO5ZXxH3+pa6hfl09I0xODYV18+JFkMI0pBtW1z0j06xojwPU6i1QTyzSuoqlOwJPbXljRdNbi+P/WAfAB+8NnYdR2fDmZdNWV62sTQXosnt5fVWD2YBOw7Ft76lodFNRuj7pRpCWu25ZQhBGhIMSo51j7BqQV5CPk/dAe1Yt7E80dw5xMPXLgZgZXleXL0xlTWV+brbOjEeqPUt1SU2Vlfkx6zj6GzUVebztVeVSb+5c1DTPbcMIUhDTveP4Zv0s7I8MUKg3vhGnEDxxvwBSaZZUOO0AfH1xhoa3RTkZNLuGWV4YhrQrlUab5o7h3jqgfV0DY2zIgEifL4TKfxs31lNN/8zhCANUfOaVy1IjGVSnp9NsdXCIWOdGoCj3cPUOu1YMuL/9aurzOc3R84BcPjskKat0nizbYuLJSVWBsemWREyguJdaFfvclDrtHHSO6rp5n+GEKQhR7qGyDAJlpbZ4v5ZDY1u3mrvY01lftgjSFeLVOVo1zArE7QsV+9y8J/vXwvAU79v07RVmgjU7KlEXf8mt5fT/cre0d/bqd1OpGkhBJGFJCrpPBkd7R6mxmkjK8Mc989Sc7cLczNp7fXx6vHetLVIAXpHJvD6JhO2LAfwjlVl2LLMNLn7NG2VJgI1TrU8tBFQPFG9r7+6rRaAx2+p0WzPrbQQAnUyUv8D0tk9BmVpKJEW6VMPruelo70EgpKPPWtYpJA4ixSU+33SH6TYarSkPtY9wsKiHOzZmXH/LLXn1nvXKxs2moXQbM+ttBACdTL6i+/t5eFv7Upr97h3ZALPyGTC4gOgXP/3bVC+DBuritLyuqscDVmkKxLkEahGz12ryxkan+bL963TrFWaCI52DyfMG1N7bpXYsyjMzeT4uRHNNv9LCyEAZTJyOWy83urloU3p6x4fDQeKE2uR/vJgN5kmEd7QO1052jVMZWEO+Tnxt0jhvFV66wplkyBnXpZmrdJ4Mzbl51TfaMJEWEUIwfKyPE3324qJEAgh7hRCnBBCtAkhnpjh9ZuEEENCiAOhn0/P9dxY0eT20tqr/Ed8V8NBm3ihxknUjKEV5XkJiZOoFulTD61ndWU+1SVWwyJN4ESkWqXLy5TPPKFhqzTeHD83gpSJ88YiWV5u58S5EYLB2bZzTy5RC4EQwgw8jbL5/ErgASHEyhkOfV1KuS7083/neW5UqJPRE3ctB+DD1y9Ju8lIjZO81uJhYVEOR7qGEhInCe9N4HKwrNTOuaEJnnogfS3Sk97RhMYHVKpLrGSaBce6tWuVxptwfCYJQrCiLI/x6QCn+8cS/tlzIRYewSagLbTb2BTwLLA1AefOmXDQZkMlAALSzj1W4yS7T/VjMZsSFieJ3JtgWZmdgbFpapy2tLJIVW9MtUhXJsgbiyTTbMJVYuPEufSt7j7WPYw9OyOmexTPleXlSpbScY1e/1gIQQVwJuJxZ+i5i7lWCHFQCPGiEGLVPM+NCnUysmZlsKgolxM96eker60sICjB7UlOccuyMvXLkF5WqeqN/epgFwAT04GkZK0tL1OWJ9KVY93DrCjLi+kexXOl1mnHJNCsRxYLIZjpql68ELYPWCylXAv8N/CLeZyrHCjEo0KIPUKIPR6P54oHu7Q0fb8Mz+3rBOCda8qTkkaorlO39KTX9Ve9se27TmMxCz7zy6NJyVpbVpZH19AEQ2PTCf3cZKJ6Y8HQ5kgrFyTeGwPIsZipclhT2iPoBBZGPK4EuiIPkFIOSyl9ob93AJlCCMdczo14j2eklBullBtLSkqueLDLy+yc9I4y6U+vTphNbi9fePE4AP/7HfHdg2A2iqwWSuxZaecRgCIGhbmZTAVk0oq61CKqE2kkxKo39osDZxmbCmAxi6TVEK3QcOZQLIRgN1ArhFgihLAA9wMvRB4ghCgTIX9MCLEp9Ll9czk31iwts+MPSk56R+P5MZqjuXOIm5aVkJVhYlFRbkK6Xs7EsjT1yJralD0I1lTkJ62oS+vr1PFAvc8//fwRAJ7dfSZpNUTLy+x09I0xOqm93eKiFgIppR94HPgtcAz4sZTyiBBimxBiW+iwPwEOCyEOAl8B7pcKM54b7ZguxbLSkFWUZpPRti0uRiYDuEpsmBOwB8FsLCuz09IzQkCjaXTxoMnt5SPb9yGBD2ysTIo3BlCWl01edoZmrdJ4Ue9yhDOFPrh5cdJqiJaHxqBFjywmdQRSyh1SyqVSSpeU8nOh5xqklA2hv5+SUq6SUq6VUm6WUjZd6tx4ssShpNGlmxAAtPaMhAO2yWJZmZ1Jf5COvvTxyJo7h9h2kyK4taX2pHljamFTut37TW4vB84MkJ+TwbO7zyTFG2todDMW8gSOhwLGWup3ljaVxSqWDBPVDlvafRmGJ6bpHpqgtjT+HUcvRXidOo2u/7YtrvBOVUtDHmmystbUwiYp08MjU2uIHPYsrq4qTpo3VleZzz//6ijZmSZOnBvWXL+ztBMCUOIEWnTP4klr6N+71Jlcj6DWaUeI9EshbekZwWGzUGS1JG0MDY1uMs0C36SfzgGlNbKWrNJ40Nw5xJfvW0fv8CRLS21J88bUz/UHJC8d69Fcv7O0FILlZXY6B8bxaTBoEy9aenwASV8ayrGYqSq2pl0KaUuPL7wjWbKoq8znJ3uUFOIT50Y0Z5XGg21bXJTlZ+MPyrA3nCxvrN7lYHm5na7BCR7SWDvwtBQC1T1Pp8mopWeEnEwzFQWJr6qMpKHRTbHNcsHSUKpbpVJK2np94fsuWdS7HHzpvnUAfPONds1ZpfGiNWQE1SbZG25ye2n3KLExrW1Sk5ZCoK5Tt6TR8kRLzwi1pTZMpsRXVUZSV5nP4bPDnPSOMjEdSAurtHtoAt+kn9okCwHArStKsWdnsLO9P202qWnpGUEIkuqRqff5x0Ob1Dx2k0tT/c7STggaGt2c7hsj12IOxwlS3SIFZWki2RYpKFbpX9xYjQT+6YUjaWGVtoTjM8ldGgLlXp+YDuCwpc8mNW29PhYV5ZKdGf8d+WZD7Xd2zzqlg44lw6ypfmdpJwR1lfl89Nn9lOdnp8066cDoFJ4RJVimBe5euwCAH+0+kxZWqbo0kWwhVu/1O1aWMjzh5yv3JyeDJtG09IwkfVkocpOavOwMWnu11e8s7YRAjd53Doyz//RAWlmkWliaAOgeUjJWrlpcmBZWqZIxlEVhEjOG4LxVeuPSEqb8QRYW5WjKKo0HU/4gJ72jSU+bVhFCUOO00dbrS/ZQLiDthAAUMbi6qojx6SDv21CR0iIA0BK66ZZpQAia3F7+6tkDLCjIpshqSVpedyJp6fVpwhtTrdKakHXc1uvTlFUaDzr6RvEHpSauv0qt024IgRZocns5eGYQIGmVhomktWcEe1YG5fnZyR5K2CpdW1kQnohS2SqVUtLWM5L0ZaFI1KBpq8Ymo3jQopGMoUhqS214fVP0j04leyhh0k4I1HXSf7lnNQAf2LgwZS1StQXviXMj1JTaEEIkPTB+3iq10dGndIFNZav07OA4o1OBpNcQRJKfk4nTnqU5qzQetPYqGUOuEu1cf1foXtDS9U87IVAt0rvXLiAn04yUqbtbmdqC92j3MMtK7ZoKjNc4bQQlnPJqc+u+WKFa3VryCEC5/ungEbT2KBlDOZbkZQxdTG3YI9NO+nraCYFqkZpMguoSK22e1F0nrXc5+Py9qxmZ8HN2cFxTgXHVQtOSVRRLVG8s3Nqj1JZ0byySWqcNd68v5XsOtfaOhCderbAgP4dci1lT937aCUEkNaEvQypTkKtkqrze6tVUqqarxIYQqSsEqjf2RpuXEnsWR7uHNeONgXLv+yb9nBueSPZQ4sZ0QM0Y0pY3ZjJpL3MovYWgxKas4aZwz6GXjp4D4E/rqzSVqpljMVNZmKMp9ziWqEHwN9v6yMowacobAy7IHEo1VG+so2+U6YCk1qktbwyUuUetL9EC6S0EIZdR7f+RajS5vXx/52ksZhOffvdKzaVq1pRoyyqKNddWF2MS0DkwrilvDCIyhzQ0GcUK1Rv75cFuACamA5ryxgBqSm2cG55geEIb+0fHRAiEEHcKIU4IIdqEEE/M8PpDQojm0E+TEGJtxGunhBCHhBAHhBB7YjGeuaJ+Gdo8qWmVNncOsazMztIypceQ1lI1a5w22r2jKbtb2Y5D3UwHJFuWlmjKGwNw2CwU5GbS5kk9IVDv82deawfgP357QlPeGJxPZ9WKIRS1EAghzMDTwF3ASuABIcTKiw47CWyRUtYBnwWeuej1m6WU66SUG6Mdz3xYXGzFbBKa+c+INdu2uOjzTV2QOqelwHiN08aUP0jnQOplDjW5vTzx3CEA/uLGas15Y0IIxSNLQY8AlPt8YZHSaffhJG5PORu1GkshjYVHsAlok1K2SymngGeBrZEHSCmbpJQDoYc7gcoYfG7UWDJMLC7O1cx/RqwZm1KyhWo0lEMdSSqvUzd3DvG+Dcpt7nImb0OUS1FbaktJjwAUIXZ7RllUlKs5b6yh0U3nwDiWDFP43k92DCMWQlABnIl43Bl6bjY+DLwY8VgCvxNC7BVCPDrbSUKIR4UQe4QQezweT1QDjiSV16nV2IdLY+lzKqlc4bptiwspJbasDJz2LEBb3hgomVv9o1P0+SaTPZSY0uT28vj2/ZiF4LYVpZrzxuoq8/nYs/sptWfR2qONxpexEIKZGtzPuOgrhLgZRQj+NuLp66SUG1CWlh4TQtw407lSymeklBullBtLSkqiHXMYpcJ1jOlAMGbvqRXcIWtPS1WVkeTnZFKSwhWubR4fLqdS0a01Ghrd+EOxGa1YpbGiuXOIz2xdxVQgSI0GvTF1PD3Dk+zp0Ebjy1gIQSewMOJxJdB18UFCiDrgm4e2hPgAACAASURBVMBWKWWf+ryUsiv0uxf4OcpSU8KocdrwByUdfamXOeTu9WESUOXITfZQZiWVPTJ37yiuEmuyhzEjdZX5NLyqTPptHp8mrNJYsW2Li4KcTIDw9deaN1bvcrB+UQEjE37u27gw6TGMWAjBbqBWCLFECGEB7gdeiDxACLEIeA54WErZEvG8VQhhV/8G7gAOx2BMc6ZGY0GbWNLmUcrrszK0U14fSUOjG3t2xgUVrqlilarFWlr1xupdDr760AYAfrz7jCas0lgS9oY1uiza5PZypGsYgO27kr9tZdRCIKX0A48DvwWOAT+WUh4RQmwTQmwLHfZpoBj46kVpoqXAG0KIg8AfgV9LKX8T7ZjmQ3UKtzpw945qqtnZxdRV5vNGm5eRST+9I5MpZZWqFetaFQKA+hoHTnsWBzuHNFfnEC1tvT7yczIpTvIeEDOh3uf/8K4VAHyovirpMYyY1BFIKXdIKZdKKV1Sys+FnmuQUjaE/v4zKWVhKEU0nCYayjRaG/pZpZ6bKBoa3TR3DlKen51y66T+UHm9picil4NPhPZw/cKLx1PKKlUtUi0LcZPby+D4NPasDM1l1kSL2+PDVWLVZHwmvG3l+gqEgAyTSHoMI60ri9UKRIfNknLrpJ0D40wFgpoWAoCtoT1cf77/bEpZpW6PjwyTYHGxNuMz6r2+de0CRib9fPH9dUm3SmOJ26NdI0htfJmdqbRZcXtGkx7DSGshUKP3LT0+jneP8Pj21LNItbpGqtLW60MAdRX5KWWVtvX6WFScS6ZZm18x1Sq9ebkTgBJ7dtKt0lgxND6NZ2RS8/c+QLVDG40vtXmXJpB6l4NrXcX4g5L3rFuQEiIA52MeWi0mg5BV+sP9VDus5OVkai7fOxrcnlFNX3vVKlWt5nZv8q3SWNGu8bTpSFwlNtq9PoJJbrOS9kLQ5Payt0Mpev7Zvs6UmIRA8QgctizyczOTPZRZCW9bubAAtyd1tq2cDgTp6BvVhUW6uDgXIdCEVRor3KFCSi3HZ1RcTisT00G6hsaTOo60FgJ1nfTf3rsGgPeur9C9Raq24G3r9YVzqLUaAA9bpU4b3UMTjE76U8IqPd0/xnRA6sIizc40s7AwN7yUmAq4PT4yzYKFhTnJHsplCXtkSe6AnNZCoFqkd60px56VQTAFtq1UA+Anzo3gCvVh13oAvNqhCNZJb2oU9Z1PHdVmMdnFuEqsSZ+IYom710dVsZUMjcZnIlGFINlCrP0rFUdUi1QIZdvKdq/+t62sdzn43D2rGZ0KcKZ/TBcpmeoSSrK/DNGiemPuiB5PWvXGItHKOnWsUFJHte+NgdIO3J6dkfR7P62FIBJXiQ13b2pYRYVWbW5PORuLi3MxifNru3pF9cbeavfitGdx+OyQ5r0xUIoqtbBOHQuU+MwYLqc+vDEhhCbmHkMIQricyo5BvhTYtvKloz0APHLtYl2kZGZlmFlYpP916sjtKTPN2tuecjbUJSw9C/H57SnH8AeV+IwevDEIGaGGR6ANwuvUOv4ygBIY3r6zg0yT4J/uXqWblExXiS0l1qmvrS7GLODsoPa2p5wNV3jLVv0KseqN7TikbE85OunXhTcGSuZQ78gkI0ncttIQghDhL4NXv18GUALgy8vtuJza3J5yNqodVto9+l+n/s3hc0wFJDfWOnThjQEUWy3kaWCdOhrU+/xroY6qT77UogtvDLSROWQIQYjwOrXO86m3bXExMDZ9QQ67HgLgLqeNSX+Qs4P6Xaducnv5m581A/DhG7S3PeVsCCFwOZO/Th0t9S5HuKWHFrennA0tZA4ZQhAivE6t8xTGSb+SLeRy6CNYphJZ4apXmjuH+MBGZWsOV4lVN94YnM8c0jNq/UxlYY5uvDGARUW5mE3CEAKtUO2w6t4j6OgbIyi132PoYqrVgKWOr7/qdWVnmliQrxQz6cEbA0UIeoaTu04dDWq9jMUsuGlZiW68sYZGN3s6+llclBv2yJIR5DaEIAJXiY2T3lFdr1OrE2m1Q19CUGy1kJ+Tqet1alACrlXFVkwm7bU/vhSqEOs1YN/cOcTn713N2LTScVcv3pga5C7ItdDuTV4HZEMIIqgu0f86tbq0Uq2TqlYVJZ9a/xWubo8+egxF0tDoZmRc8QTU5SG9pF6qbNviojBXqZ9RN5vSgzemCtbR7iHaen08tn1fUoLcMRECIcSdQogTQog2IcQTM7wuhBBfCb3eLITYMNdzE8n5fGr9WqXuXh9ledlYszKSPZR5U62BfOpomPQH6BzQX3ymrjKfz+04FkqWGNVFW5KZUI0gvbT2UKl3ObjO5SAo4e665HRAjloIhBBm4GngLmAl8IAQYuVFh90F1IZ+HgW+No9zE8b5fGr9WqVu76huqiojaWh0k2ESF+RT680q1Wt8pt7l4OnQ/sUvHu7WTSHcxbh7fRfEZ/RCk9vL7lP9ADy3/2xS4hqx8Ag2AW2hbSengGeBrRcdsxX4rlTYCRQIIcrneG7C0Hs+tZSS9l6f7uIDoFilv2pWioHaPfq0SvUanwE19dKK2zOqm0K4i2n3jrLEYdNVfEa9z//z/WsB2LpuQVKC3LEQggrgTMTjztBzczlmLucCIIR4VAixRwixx+PxRD3oi2lodPNWex8u5/kKV71ZpB7fJCOTft25xqBMRJ+5W3EGn/pDmy6tUr3GZ0C517uHxjEJ+P5O/aReRuL2+HR37dUOyHesKqPIaiEQlEkJcsdCCGaS34vTbmY7Zi7nKk9K+YyUcqOUcmNJSck8h3h51Oi9LUvxCPRpkaoTkf4sUoCt6ysQKL2S9GiV6jU+o97rH9pcRVDCP969Qhepl5HotX5G7YAM59uBJyPIHQsh6AQWRjyuBLrmeMxczk0IavR+z6kBekcmkxa9jwY140NvVpHK7lP9CKF8IfRUEKSi1/iMapW+Y3UpAAU5Fl2kXkai1/hMJNWO5CVLxEIIdgO1QoglQggLcD/wwkXHvAB8KJQ9tBkYklJ2z/HchFHvcnBLaDPv21eW6koEQPEI9Bgsg/NW6bqFhZhNQjcFQSp6js+oVqk6dnXbUK2nXkaiNszT4/VXcTmt9I1OMTg2lfDPjloIpJR+4HHgt8Ax4MdSyiNCiG1CiG2hw3YA7UAb8A3gI5c6N9oxXSlNbi9vtCkTz68PdetmElJp9/p0FyxTUa3Sq5cUcso7xjVLinVlleo5PqNSaLVQZLXoMllCbaGtV28YiBDixGctxmQxU0q5A2Wyj3yuIeJvCTw213OTgWqR/vcD6/n//mc3t68o1U3AsqHRTV1lPu2e0XBMo8ntpblzSDdWnTrOzoFxpgJBOgfGqHc5NH/tVfQen1FxlVh1uS+B26PP+Ewkke3Ar1pcmNDPNiqLQ6gW6Y1LS1hclMukP6gbi7SuMp/Htu/jdP8Y1SX62Kd4NvRa1Kf3+IxKtcOmy30J2j36jM9EsrAwh0yzSIoQG0IQIjJ6r1a46mWdtN7l4Im7VgBw4tywbjyZmQi7xzppiRzepzgiPqO3tONIXE4rXt8UQ2P6aT4npVRSR3UcHwDIMJtYXGxNihAbQjADLqeVU94x/IFgsocyZ+zZikv82yP6TL1UKbRaKLZadNMSWU073nu6nyUOGztP9unWG4OI3vg6uf4AXt8UIxP6js+oVDusSfGGDSGYAVeJLbROrZ/mc3843gvAX26p1mXqZSTVJVbdeARq2vGhziH8gaCuvTE4H+PQQzvwsDemZgzpaJ/i2XA5bXT0jTGdYCPUEIIZ0MKOQfOhye3l+QNdOKwW/vauFbpLvbwYLWzmPR82LCokKKG116drbwzOr1PrYYMg1Rt76WgPAIPj07r2xkDxCPxByZn+sYR+riEEM+DSWW/25s4hKgpzWLEgD0A3vdhnw1ViS1o+9ZXw/IGzALxjVZnuvTF1nVoPHoF6n2/f2YHZBJ95/oiuvTE4nzmU6ICxIQQzUJCrrFPrxSp99IZqeoYnwp4M6KMX+2yo2R96SGNscnv57K+OAfCxW2t0742BmkKqj3u/3uWgND+bQBA+uFnf3hiAy3E+hTSRGEIwC3panjg3PMHYVEDX5fWRRFa4ap3mziHuXFWGEMq49e6NgXLvn+5P/Dr1ldDk9nKmf4zaUpvuvTGA/NxMHLbEG6GGEMyCy6mfwhr1pqnReTGTSmVhDhazSRdLc9u2uJgKBKkoyCHHYgb07Y2BEnSdDiR+nXq+NLm9PLZ9H0EJ716zQPfemBr8ri5JfAdkQwhmwVVio390ioFR7a9Tq+u5ei+oUckwm6hy5OrCIwBFiF0pIsIQWdSnbSFu7hzib96xHFDufb17Y+c7IJsT3gHZEIJZUL/Yeshnd3tGsWdnUGLLSvZQYkYyOzHOh2BQppQQNDS68foU40ddp9ZqSua2LS6sofqZGqd+9imeDVXIdrb3MzA2zUcS2AHZEIJZUFsF6CGfXZ2IhNBfs7nZcDmtnE5CPvV86RoaZ2I6GJ6I9E5dZT5/+7Nm8rIzdbEvh7vXh0lAVXFqeMP1Lge3rVDagd+6wpmw4LchBLNQWZiLxWzShVWaShYpKFZpUII/KDkdWqfWqlWqLp+kQlUrnLdKx6b8vN7q1XyBnNvjY2FRLtmZ5mQPJSY0ub00tig7MP7m0LmExTsMIZgFs0mwJEnl3vNhZGKanuHJlIkPgGKVbt/ZASgWn5at0vPxmdQR4nqXg+XldrqHJnhI4wVybb2pYwSp9/lXH9xAdqaJG5eWJCz4bQjBDKjR+8jMIa1bpKmSMQTKRPTkfesA+J+mU5q2Sts8PvJzMim2WpI9lJjR5PaGs1a+t7NDs1k4gaDkpHc0ZbwxtQPydbXKJkFjU4GEBb8NIZgBNXqflWHidP8Yr7V4DIs0wdy2opRci5kmd5+m2za4e33UOFMnPqNapR+7tRaAx2+u0WxK5tmBcSb9qROfieyAXOO00dabuA7IUQmBEKJICPGSEKI19PttuykIIRYKIf4ghDgmhDgihPiriNc+I4Q4K4Q4EPp5ZzTjiRXqOunvjvYQCEo++kPtWqRuj48Mk2BRUW6yhxJTmtxepvxBSvOyNF0o5PakjkUK563S96xdAEBWplmzKZnqsm2qLA1FUuO0cXZwnLEpf0I+L1qP4AngFSllLfBK6PHF+IFPSSlXAJuBx4QQKyNe/5KUcl3oJ+k7lanUuxy8u075MlxXU6xJEQDly7C4OJdMc+o4d6pVestyJ6OTAZ56QJuFQkNj03h9kyk1EalWaXl+NlaLGXcCrdL50tab2kIAiet3Fu3ssRX4Tujv7wD3XHyAlLJbSrkv9PcIyt7EFVF+btxpcnv53ZFzAPzhuEdzk5CKYpGm1hdBtUpvWFqCb9LPkhKrJq3SNrWiO0WWJiIRQlDjtNHaO5LsocyK2+Oj2GqhMIXiMyrqPdWWoOZ/0QpBqZSyG5QJH3Be6mAhRBWwHtgV8fTjQohmIcS3Z1paijj3USHEHiHEHo/HE+WwL41qkT790AYqC3NYv6hAUxapGsyeDgTp6BvF5dR/H/ZIVKtUDYC39mjTKk3lpQlQ4k6JmoiuhLZeX8rFxlSqiq2YTUI7QiCEeFkIcXiGn63z+SAhhA34GfBxKeVw6OmvAS5gHdANfHG286WUz0gpN0opN5aUlMzno+eNapHWuxzUOm0MjE1ryiJVg9kvHDjLdECCRLPB7GioLU2sVTRf3B4fFrOJysKcZA8lLtQ4bfQMTzI8oc1tK1OtfiYSS4aJxUW5Cbv3My53gJTyttleE0L0CCHKpZTdQohyoHeW4zJRRGC7lPK5iPfuiTjmG8Cv5jP4eBFpedY4bbzp7uOaJdqJE6jB7Ee/uxeA7bs6aHj4Ks2ML1YUWy0U5GbSqjEhaGh0U1eZj7t3lCpHLhlmE01uL82dQ5rzWqKhJmK3svWLZnXWk0Kfb5KBsemUXJZTcTkT12Yl2qWhF4BHQn8/Ajx/8QFCyav7FnBMSvnkRa+VRzy8Fzgc5XhiTq3TzpQ/SOeAtjox1rscrKlQPIAHNmk3vTIahBDUOm2a2yRF9ciOnB2iJrQsl5oemR3QpkeWahXdM1HjtHGqbzQhe6dHKwRfAG4XQrQCt4ceI4RYIIRQM4CuAx4GbpkhTfTfhRCHhBDNwM3AJ6IcT8ypKT2/Tq0lmtxe9nYMYMsy85O9nZqJX8QaLQYs610OvnTfWrqHJ/AMT2q64C0aFobagWtJCNT4WGTGUCrFxyKpCbUD70hAO/CohEBK2SelvFVKWRv63R96vktK+c7Q329IKYWUsu7iNFEp5cNSyjWh196jBp61hOp6aml5QrVAFxRkc9XiIt33Yb8UNU47A2PT9Pkmkz2UCyjNywZgd8eApgveoiHDbGKJw6opIVC9sddbPWRnmjjdN5aS3hgkNnModZLP40RedialeVmaskqbO4f4yv3r6R6aoNaZGrtizYYWhRjgV82KzfLApoWaLniLlhqnLZwmqwXUe/3lYz3YsjL46LOp6Y3B+W4BhhBohFqnXVNW0bYtLhYW5TDpD7I0tI6rxfTKWFCb4HzqudDk9vLN19sxCfjMe1altEfmcto40z/GxHQg2UMJU+9ykJVhwuubSllvDMCWlUF5fnZCYmSGEMwBte+HlDLZQwnTEopZqDGMVEWtcNWSEDR3DrG6Ip8qh5WsDHNKe2S1ThtBmbgK17nw8rEefJMBrq0uTllvTI2FRHpk8YyFGEIwB2pLlU6AXUMTyR5KGHWpqjaF0+dAyRzSWmHTti0u+n1TLHXaw8+lqkcWXqfWyPJQk9vLJ390AIAPX78kZb0xNRaSG2rz0dQW38w0QwjmwPkKV+3ECVp7fJTnZ2PPzkz2UOKO1jKHJqYDnOobZWmKe2MNjW56hicwifNLc8nO0GnuHOK+qxcCsLTUnrLemPrver3Vy+hUIO7bVhpCMAe0mE/d2jsSHleqo7UK13bPKEFJyl//usp8Pvnjg5TYszSzQdC2LS78QUlOpjlc0Z2q3li9y8Fdq8sAuHFpSVxjIYYQzIEiq4Viq0UztQTBoKSt15fyy0KgWKWBoBKb0YpVGl6WS3GPQLVK+0eneKtdO9tWtvb4qC21YTKlxh4Qs9Hk9vL740qzhpeO9cR1+csQgjmipTS6zgFlw/RUX5oAxSr95usnAUUItGCVtvSMhLcyTXXqXQ7qKgroH53mgU0Lky4CoFz/Wmdqe2ORjS9L87LYuLgwrrEQQwjmQEOjG1tWBq09I+HMoWRapS2hWEVNin8Z4LxVCvDsH09rwipt6fFRVZxLVkZqbJh+KZrcXo73KD0iv78z+Rk6g2NT9I5MprwRFNn4cmmpncE4N740hGAO1FXm81Z7H8MTfjwjk0m3StXiqlRfmlC5obYEh83CvtODmsgbb+v1hes3Uhn1Pv/Hdyn7SD28eVHSM3TUtOmlZal9/SO3rVxWaqelZ4RrlhTHLRZiCMEcqHc5+Phtyh6un99xPOlWaWvPCGV52eSlQcYQKBPS8IQfq8Wc9LzxiekAHX2jKR8ohvNW6b0bKjCbBEFJ0jN0VG84HYRYZVmZnUl/kNNx7DlkCMEcuXd9JQC/OHA26VZpa68vbbwB1Sr9kw0VjE4F+Lf3rkmqVer2+AhKUn5pAs5bpVkZZqodVlp6RpKeodPSM4ItK4MF+dlJG0OiWRbyfk6ci18KtSEEc6S1dwQBrCi3J8UqVSsNz2cM2ZOePZMIVKv0jlVKGp09JzOpVqmaOZZOFikok9HxOE5Ec6WlZ4TaUhtKd/v0oNZpRwhDCJKOapWuWpBHhsmUlGpGtdLwlwe7GJ8OYDal5q5kF6NapcvL8gDly5BMq7SlZ4QMk6CqOPUzhiJZXmanc2Ac36Q/qeNo7fFdUNGdDuRYzCwuyg0vi8UDQwjmgGqVbq4upqVnhE1VRQm3StXsmb//hbJ3z492n0l69kwiKc3LoiA3k+Pnhi9/cBxQPbKWHh9LHFYsGaa08MhUlkUIcbLw+ibpG51Km2XRSJaW2uN670clBEKIIiHES0KI1tDvGfezE0KcCm1Ac0AIsWe+5yebsFVansekP8ipvrGkWKXpsCvZbAghWFaavOUJ1SM7dHaQpaX2pGeOJZrlCVinvhyqRbwsxTOGZmJZmZ1TffHrAhutR/AE8IqUshZ4JfR4Nm4ObUqz8QrPTzrJ/jKou5LZszNSeley2VhRnkfLuRGCwcR3ga13OXjy/WvpGZ7E60vdXclmo6IgB6vFzIkkeGSqNxYZn0knbwwUIQgEZdy6wEYrBFuB74T+/g5wT4LPTyg1Thtmk0jK8oRqgRbbLFxbXZyyXRcvxbIyO6NTAToHxpPy+YVWCwC7TvYnPXMs0ZhMgtokeWSqN/Zai4e87Azcvb608sZAqSUAONETn7knWiEoVbeXDP12znKcBH4nhNgrhHj0Cs7XBNmZShrdse7EfxmaO4f44vvrODc8wYryvJTtungp1CWBZMUJftncBcAj1y5Oej1DMlheZudERHV9olDv9cYWD9asDB7/YXp5YwBVDiuZZsGJc/Fpc3NZIRBCvCyEODzDz9Z5fM51UsoNwF3AY0KIG+c7UCHEo0KIPUKIPR6PZ76nx4zl5XlJmYi2bXFRkGtBSmWJBFK36+JshK2iJFilTW4v33urg5xMU8rvSjYby8qUVgeekcTvH715STFCQPfQRNp5YwCZZhOuElvcluYuKwRSytuklKtn+Hke6BFClAOEfvfO8h5dod+9wM+BTaGX5nR+6NxnpJQbpZQbS0pK5vNvjClqGl0yWiKrnsiqBXkJ/2wtYM3KYFFRblKWJ5o7h1hcnMuaygKEEGnukSX++j9/4CzTAckty51p6Y01NLopslrCLTYgtv3Ool0aegF4JPT3I8DzFx8ghLAKIezq38AdwOG5nq811IBxSxK+DMe6h7FnZYT7sKcjSmFT4j2yR2+opnNgnJXl50U43Tyy5UlKIW1ye/nH548A8InblqalN1ZXmc/+04OcHRxnZGI65llr0QrBF4DbhRCtwO2hxwghFgghdoSOKQXeEEIcBP4I/FpK+ZtLna9llocmgmNJEIKj3cMsL7enVVXlxawos3PSO5rwzdQ7+scYmwqwMk29sYZGN8fPDVNizwp7BInK3GnuHOLWFU4yTILaUltaemP1LgeP36wYHf/8yyMxz1qLSgiklH1SylullLWh3/2h57uklO8M/d0upVwb+lklpfzc5c7XMgvys7FnZyQ8jS4YlBzvHr7AIk03GhrdCKE0P0v0JjVHu5T/73S9/mrmTlleFid6hhNaR7Fti4uh8WlqnDayM5XW3+nmjQG896pKlpba+One2Pc7MyqL54kQghVleRxPcObQmYExRqcC4UBxOlJXmc//NJ0ClHXqRE5GR7uHwhZpOqJa4a09Po51DfNYnPfQvZgjXcNp642pnPSO4vVN8bFbamIeJzGEYJ40NLpDrQ4Su0mNapGmsxDUuxw8/eAGALbv7EhoUdfRrmFqnLa02IxmNupdDm5cWkJAwl1ryhImAr0jE3hGJlm1IH3qBi5GNXqeenA9n7xjWczjJIYQzJO6ynzeaPPim/TTOTCeMKv0WPcwJpGe5fWRXF/rwGnPYv+ZxG5Sc7TbsEib3F52nVRWb5/f35WwYK1qBKVrthxcuGMZEPM4iSEE86Te5eBv71oOwBdeTNwmNUe7h6kuOb9Gmq40ub0MjU9jMYuEbZ3o9U3SMzyZtvEBOG+RfvXBDVgtZq6rcSQsc+eI4Q1fsGOZSizjJIYQXAHvv0rZpObXh7oTZpUe6x5J64kIzk9Gj1y7mKmA5B/evSIhk9Gx7lCg2LBIua7WwaqKfHpHJhOWuXO0a5iFRTnk56THjnzJwBCCK+DAmUHMQrCoKDeuxS1qs62hsWnODo6zojwv7ZptRaJORveEdoszm0RCJqN0zxiCCy3Suop8jnUPs6mqKCGZO0e7h1lVnr7xgURgCME8Ua3SG2qLGZmY5qkH4lfcoqbs/WTvmdAzMu2abUWiTkZLS21kZZho7hyKaxqhKsRHu4epKMihINeS1kKssqYyn0l/kNbe+PS9icQ36eekdzStvbFEYAjBPFGt0ttXlTEwNk1lYW7crFI1IPTkSy0AfL2xPe2abc1EhtnEqgV5HIqzJ6AK8Z5T/WFvLJ2FWEXdEyPe1x/OL8ulc6A4ERhCME9Uq3RtZQEABzsH42qV1rsc4ZYSH7p2cdqLgEpdZQGHu4YIxHFvgnqXgyc/sJazgxMMj0+n3R4Es1FVbMWWlcGhs/ETAtUbOxL6jFUL8g1vLI4YQnCFLCuzY8kw0dw5GNfPaXJ7aev14SqxpmWzrdmoq8xnbCqA2xPf5Ql7thKg/OOp9NuDYDZMJsHqijya4ygEqjf26oleiq0W2j3ptwdBIjGE4ArJNJtYWZ7HwTi6x01uLx/Zvo+ghPuuXpiWzbZmQ50Q4h0o/vm+TgA+fF2VIcQRrAkFjKcDwbi8v7os+npbH7lZ5rTcgyCRGEIQBesWFnD4bPyWJ5o7h/jw9UsAWL+oMC2bbc3GEocNq8UcV4+sye3lx3vO4LBZ+Me703MPgtlYU1nAlD8Y3kc4HqxbWEAwKDnTP254Y3HGEIIoUJcn2uKUPbFti4vxqQAZJsHqUHl9OjbbmgmzSbC6Ij+uotjcOYQ1KyNu1Zx6Rg0YH47j8tD2XR1I4D1rFxjeWJwxhCAK6iICxvHiwJlBVpTnkWNJ74rimairzOdo9zBT/vgsT7xn7QIGxqbZsKgg/JwhxEogt2tgHHv2+YBxrAO5TW4vT/6uFYDPbl1teGNxxhCCKKh2WLFnZXDwTHyEIBCUHDwzyPqIichAoaHRTVam+YLliVhPRvtODwCwYXFhzN4zFairzOejz+5nYWEuhzqH4pJW29w5xLIyG7VOG/m5mYY3FmcMIYgCk0mwpjJ+yxOtvSOMTgUMQS6BmwAAE7FJREFUIZiBusp8vvdWBwCHzsZnMtrXMUh2pimte9zMhDopt3t9HDo7FJeW1I/eUE27Z5SrIkTY8MbiR1RCIIQoEkK8JIRoDf1+m+kkhFgmhDgQ8TMshPh46LXPCCHORrz2zmjGk2gaGt0UW7M4fm44vGNWLK3S/acVT2P9QsMivZh6l4OvPbQBAXw/Ti2p950eoK6igEyzYS9dTL3LwS3LSwlKuHWFM+aBXLfHx/CE/wIhMIgf0d7hTwCvSClrgVdCjy9ASnlCSrlOSrkOuAoYQ9nAXuVL6utSyh0Xn69l6irz+cOJXqYDkmPdsd+1af/pAQpzM1lcnBuT90s16mscVBblcKRrOOZZJRPTAY50DbF+seGNzUST2xter/9187mYr93v6VCW5QwhSAzRCsFW4Duhv78D3HOZ428F3FLKjig/VxPUuxz863vXAPCll1pibpXuPz3I+kWFab1H8aVocnvxjkwB8N2dHTGdjA6fHWI6INmwyJiILibckvqhDSwrtVPjtMY8kLu3Y4Aiq4UlDmvM3tNgdqIVglIpZTdA6LfzMsffD/zwouceF0I0CyG+PdPSkooQ4lEhxB4hxB6PxxPdqGPI3WsXYM/O4LVWb0ys0nDH0fFpWnt9rF9YYJTWz4A6GT3xTmVviA9duzimk1E4UGwIwduI3CRlc3URbs8o/3X/upjGyvZ1DLDBMIISxmWFQAjxshDi8Aw/W+fzQUIIC/Ae4CcRT38NcAHrgG7gi7OdL6V8Rkq5UUq5saSkZD4fHVea3F6m/MGYbZSiltY/+8fTAFgyTEZp/Qyok9GDmxZhtZjp803FJKtEFeJ9HYMsKsqlxJ5lCPFFRLakvqa6mLGpANasjJgFcvt8k7R7R41loQRyWSGQUt4mpVw9w8/zQI8Qohwg9Lv3Em91F7BPStkT8d49UsqAlDIIfAPYFN0/J7GoVumf37CEqYDkE7fXRm2VqhkZX35ZyaFuaHQbpfUzoE5GmWYTVy8p4q32vphklahCvLO9jw2LCoyOo5dh05IiAHa190f9XmERDiVJbKwqNEQ4QUS7NPQC8Ejo70eA5y9x7ANctCykikiIe4HDUY4noahW6SP1ShuIkUl/TKzSepeDwlyl2dnDm42Oo5fj2upi2j2j9AxPRP1e9S4Hn7l7JYPj0wyMGR1HL4fDlkWt08auk31Rv5cqws8fOEumWTA66TdEOEFEKwRfAG4XQrQCt4ceI4RYIIQIZwAJIXJDrz930fn/LoQ4JIRoBm4GPhHleBKKapWW2LNYVmqnqS02VunLx3roGppg4+JCo7R+DqiT9M726CcjgIlppVK5scVj9LiZA9dUF7H7ZD/+KBvQqd7wbw6fo8hq4ZM/PmiIcIKISgiklH1SylullLWh3/2h57uklO+MOG5MSlkspRy66PyHpZRrpJR1Usr3qIFnPVJfU8zuU/3heoIrpcnt5ePPHgDgb+5cbpTWz4GVC/LIy87gLXdshOCne89gEvDRW2oMIZ4Dm6uLGZ0KhDeZj4a1lQUEpaRneNIQ4QRiVMrEiOtcDib9wXC2yZXS3DnEpiWF2LMyWL+owCitnwNmk2DTkmLeioFH8Hqrhz+eGuCmZU4+dccyQ4gvQ0OjG1MosUddHopmXf+br58kKOHe9RWGCCcQQwhixDXVRZhNgqa26Cajv7ixmuPdI1xX4whXtBql9ZemodFNeX42HX1jdA2OA1c+Ge04dA6A+69eCBgdRy9HXWU+//CLI5TnZ7OzvT+q4HqT28tXX20jJ9PEv/9JnSHCCcQQghixfddpljhyeTPipr2Sycjt8dE1NMGWZdpJkdU6dZX5PH/gLABvufuimozs2RlkmgXX1ZxfkjCEeHZUoewfneKNVg+Pb7/y4PrBM4NkZZi5dUUpmWaTIcIJxBCCGFFXmU/nwDgHzwwyMjF9xZPRqyeUYrkblxpCMFeUvkNXIYBvvtEeVabPH473cs2SYqxZGbEfaIpS73Jw83InUwHJzctLrnhdf3N1McMT09y2ovSC9zZEOP4YQhAj6l0OPnXHUoIS/s9zh654Mmps8VDjtFFRkBOnkaYm19U6cDltHOse4cFNVxZkPNM/Rmuvj5sMb2xeNLm97Grvw2yCXzV3X/FSzivHejEJjOufBAwhiCEPb64iwyT4VXP3vDIe1EKa8akAu072s2VpiVFIM0+a3F7ODSl1BN9569QVTUavtije2C3LL9cpxUBF9XyffmgD71hVRlaGmce3X9m6/ivHe9m4uIiCXEscRmpwKQwhiCH7Tg9gEgKLWfC9eTRBUwtp/l/TSab8QUrsWUYhzTxQJ6OnHlwfzraaa5BRFWFQloUWF+dybmjCEOE5Etl36N11CxiemOYvb6qe97r+2cFxjnUPc+sKQ4STgSEEMUKdjD51x1KmApKH59EETQ2K/dfLrZgFfN1oKzEv1MnopmVO7lxdxr6OQZ78wNo5TUaqCL96opcmt5flZXYe/6EhwnMlsu/Qzcuc5FrMtHtH57yurwrx748pnWduXVFqeMNJwBCCGKFORn92QzVledkcCj2eq2W0bmEBUkoC0mgrMV8iJ6Ot6yrwTfoZnQzMaTJSRfjxH+xnYjpIU1ufIcJXSI7FzG0rSnnx8Dmm51hlrArxT/d1UlWcS+/whOENJwFDCGKEOhmZTYJ7N1TwWquXGqdtzpbRl15qYSoged9VRiFNNFzrKsZpz+IXoXTSuVDvclBoVXo7fehaQ4SvlIZGNzVOG4Nj07zZpty/l7Pu610OPn/vag6eGaIgx8LjPzR6OyUDQwjiwPs2VBIISl440DWn45vavHz7zVMsLMzhP/9krVFIEwXfeL2dqxYX8uqJXobGpoHLT0Y/2n2GM/3jXFtdzA93nzGu+xVSV5nP/3vzJDmZpnD20Fys+6PdIwAc6Bw02kokCUMI4sDLx3pwlVj56d7O8HOXmoxePNxNICjZdpMLIYRRSBMFdZX5vNnmZTog2XH48pNRk9vLp58/TKZJ8NWHNhgiHAX1LgdPP7SBgIQXDpyd06b2Y1N+vvVGO5lmwceM3k5JwxCCOFBXmU/30ATHz41wpGtoxskoMltlZMKPPSuD8vzssFgYhTRXRr3LQcMHr8Ik4L9fab1sPcdOdx+BoORPNi6k0GoxRDhK6l0O3rm6jKmApK6y4LLW/b/uOM7oZIC/f9dKPmn0dkoahhDEgXqXgy/ftw6Av/7JwRknIzVI9pvD3ew4dI76mmL++ifNRpAsBtTXOLiuxkHX0ASblxS9bTKKFOFMswl/ULJhUYEhwjGgye3ltVYvlYU5vNbi4XdHzr3tGPX6TweCPH/gLMtL7SwttdHQ6DaEOEkYQhAn7lhVxlWLCjnWPcL1NY63TUbqDf+JHx1kKhBkZ3u/ESSLEU1uL4fPDuGwWXjxyDlePtZzweuqCL/W4uG7Ozuoq8znX188bohwlETWc3zrkasRAj76w7db9+r1f/KlFoYn/Ny9rvwCj9kQ4sRjCEGcaHJ7aff6yM0088LBrgsso8h4waRf2b/gESNbJSZEVrq+a005UsJj2/eFJ6Mmtzec6vvo9/biGZnkpGfUEOEYEFlctqzMzvqFBUz6g7x09LwQq9f/y/et45nGdoqtFr71xinj+ieZqIRACPF+IcQRIURQCLHxEsfdKYQ4IYRoE0I8EfF8kfj/2zv3GKmqO45/vuzyELuCPBQQLQ+NYhujSCk+sERIkdUoNrHR/lGs+IqhrUmbKtIYG9PWR2uaNi0WKJU2tNpWrY9KfFWwKfGx0GWVsgusYlmhu8sSlKpVYH/9457dXoY7zCw7d2aW+X2Sydx7zrlzfvd77j2/ex5zj/S8pC3h+6hYrTpeGX33skkA3LJyPQsfa2Dp35pZ8Lt/MOzYAcx/6HUAPj9umA+SFYh4ZTT7s6MYWN2Pj/d38qNnm7q1P2vsEOq37+leROjaC8Z5JVQA4v/n6NoX0RthF6/e2q3/qSdE3UAHzOj44BOfKVQGyMyO/GBpEtAJ/BL4tpnVJaSpAjYTLVXZArwOXGNm/5R0H7DbzO4JDuJ4M7stV75TpkyxurpDsiobHlzTzFljh3Rf3Lf9qYFH6rYz/Nj+dHywj6+dP46nNuyg44NPGDygiqXzIh/q6+MWnr82tnL9ijoGVvfjo32dzL9wHCNrBnHPqkYA5p59Ei9vaXfdU+J7T23k13/fxtBj+rPno33cMmMiL25qY3PrXoxoAZo1m13/YiFpnZkd8tDeK0cQ+/HVZHcE5wF3mdnssL8QwMx+KKkJmGFmO8NC9qvN7PRc+ZW7I8hk/4FOZj6whnc6PuwO6ycYVN2PZdd+rvsG6Go2e/9oYfnWH+t5dN2hfzBbOOcMbvrCxIP6tr0yKiydncb8FXW81NTWHVbVDzo74Y5Lz+CG6a5/McnmCIoxRnASsD223xLCAE7sWqc4fGd945SkGyXVSaprb29Pzdg0eG3bbvb+dz83XTSB4wZVc+4px9NpcP30CQdd+D5IVnjWNu/ipcZ2vnHxqQwd3J9zT4l6H+eePYabgtY+UyU9Xnm7gw0te/j6xadSM6iaccMHc6AT5p4zhhumu/7lQs7VNyS9AIxKiFpkZk/kkYcSwnrcDDGzJcASiFoEPT2+VGQ+7YyoGcAP/tLYvSbrtInD/SkoJTK1rzmmulv7NZvbWdu8q1v78yceOrPL6R2Z+h/n+pctOR2Bmc3qZR4twMmx/bFA17sXWiWNjnUNtR1ydB8nPni5tnkXi1e/xR2XnsGBTrhqylhvEqeIa19aXP++QzHGCKqJBotnAu8SDRZ/xcw2Srof6IgNFg8zs+/kyq+vjRF0kTmIDD4uUCxc+9Li+pcHqQwWS7oS+BkwEtgD1JvZbEljgGVmVhvS1QI/AaqA5Wb2/RA+HPgDcArwL+AqM9udK9++6ggcx3FKSaqzhoqNOwLHcZyeU8pZQ47jOE4Z447AcRynwnFH4DiOU+G4I3Acx6lw+uRgsaR24J0jPHwEUI5vd3O7eobb1TPcrp5RrnZB72z7tJmNzAzsk46gN0iqSxo1LzVuV89wu3qG29UzytUuSMc27xpyHMepcNwROI7jVDiV6AiWlNqALLhdPcPt6hluV88oV7sgBdsqbozAcRzHOZhKbBE4juM4MdwROI7jVDhHpSOQdJWkjZI6JU3JiFsoaaukJkmzsxw/TNLzkraE7+NTsPERSfXhs01SfZZ02yS9EdKl/qY9SXdJejdmW22WdJcEDbeGV4inbdf9kholNUh6XNLQLOmKoleu81fET0N8g6TJadkSy/NkSS9J2hSu/28mpJkh6b1Y+d6Ztl0h38OWS4n0Oj2mQ72k9yXdmpGmKHpJWi6pTdKbsbC86qGC3ItmdtR9gEnA6cBqYEos/ExgAzAQGA80A1UJx98H3B62bwfuTdneHwN3ZonbBowoonZ3Ea0tcbg0VUG7CcCAoOmZKdv1RaA6bN+brUyKoVc+5w/UAquIVuibBrxahLIbDUwO2zVE64Bk2jUDeLpY11O+5VIKvRLK9N9Ef7gqul7ARcBk4M1YWM56qFD34lHZIjCzTWbWlBB1BfCwmX1sZm8DW4GpWdKtCNsrgLnpWBo9CQFfBn6fVh4pMBXYamZvmdknwMNEmqWGmT1nZvvD7itEK92VinzO/wrgNxbxCjA0rMKXGma208zWh+29wCb+vz54uVN0vTKYCTSb2ZG+saBXmNnLQOZaLPnUQwW5F49KR3AYTgK2x/ZbSL5RTjSznRDdXMAJKdo0HWg1sy1Z4g14TtI6STemaEecBaF5vjxLczRfHdPiOqKnxySKoVc+519SjSSNA84BXk2IPk/SBkmrJH2mSCblKpdSX1NXk/1hrBR6QX71UEF0y7lmcbki6QVgVELUIjN7ItthCWGpzZ/N08ZrOHxr4AIz2yHpBOB5SY3h6SEVu4DFwN1EutxN1G11XeZPJBzbax3z0UvSImA/sDLLzxRcryRTE8Iyz7+o19pBGUufAh4FbjWz9zOi1xN1f/wnjP/8GTitCGblKpdS6jUAuBxYmBBdKr3ypSC69VlHYGazjuCwFuDk2P5YYEdCulZJo81sZ2ietqVho6L1nL8EnHuY39gRvtskPU7UFOxVxZavdpKWAk8nROWrY0HtkjQPuAyYaaGDNOE3Cq5XAvmcfyoa5UJSfyInsNLMHsuMjzsGM3tG0i8kjTCzVF+wlke5lESvwBxgvZm1ZkaUSq9APvVQQXSrtK6hJ4GrJQ2UNJ7Is7+WJd28sD0PyNbC6C2zgEYza0mKlHSspJqubaIB0zeT0haKjH7ZK7Pk9zpwmqTx4WnqaiLN0rTrEuA24HIz+zBLmmLplc/5Pwl8NcyGmQa819XMT4sw3vQrYJOZPZAlzaiQDklTieqAjpTtyqdciq5XjKyt8lLoFSOfeqgw92Lao+Gl+BBVYC3Ax0Ar8GwsbhHRKHsTMCcWvowwwwgYDrwIbAnfw1Ky8yHg5oywMcAzYXsC0SyADcBGoi6StLX7LfAG0BAuqNGZdoX9WqJZKc1FsmsrUV9offg8WEq9ks4fuLmrPIma7D8P8W8Qm72Wok0XEnULNMR0qs2wa0HQZgPRoPv5RbArsVxKrVfIdzBRxT4kFlZ0vYgc0U5gX6i75merh9K4F/0VE47jOBVOpXUNOY7jOBm4I3Acx6lw3BE4juNUOO4IHMdxKhx3BI7jOBWOOwLHcZwKxx2B4zhOhfM/a6jcSN2YLM4AAAAASUVORK5CYII=\n",
"text/plain": [
"<Figure size 432x288 with 1 Axes>"
]
},
"metadata": {
"needs_background": "light"
},
"output_type": "display_data"
}
],
"source": [
"%matplotlib inline\n",
"\n",
"import numpy as np\n",
"import matplotlib.pyplot as plt\n",
"from scipy import sparse\n",
"eye = np.eye(4)\n",
"print(eye)\n",
"sparse_mtx = sparse.csr_matrix(eye)\n",
"print(sparse_mtx)\n",
"x = np.linspace(-10,10,100)\n",
"y = np.sin(x)\n",
"plt.plot(x,y,marker='x')\n",
"plt.show()"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## Meet the Pandas\n",
"\n",
"\n",
"<!-- dom:FIGURE: [fig/pandas.jpg, width=600 frac=0.8] -->\n",
"<!-- begin figure -->\n",
"\n",
"<p></p>\n",
"<img src=\"fig/pandas.jpg\" width=600>\n",
"\n",
"<!-- end figure -->\n",
"\n",
"\n",
"Another useful Python package is\n",
"[pandas](https://pandas.pydata.org/), which is an open source library\n",
"providing high-performance, easy-to-use data structures and data\n",
"analysis tools for Python. **pandas** stands for panel data, a term borrowed from econometrics and is an efficient library for data analysis with an emphasis on tabular data.\n",
"**pandas** has two major classes, the **DataFrame** class with two-dimensional data objects and tabular data organized in columns and the class **Series** with a focus on one-dimensional data objects. Both classes allow you to index data easily as we will see in the examples below. \n",
"**pandas** allows you also to perform mathematical operations on the data, spanning from simple reshapings of vectors and matrices to statistical operations. \n",
"\n",
"The following simple example shows how we can, in an easy way make tables of our data. Here we define a data set which includes names, place of birth and date of birth, and displays the data in an easy to read way. We will see repeated use of **pandas**, in particular in connection with classification of data."
]
},
{
"cell_type": "code",
"execution_count": 21,
"metadata": {},
"outputs": [
{
"data": {
"text/html": [
"<div>\n",
"<style scoped>\n",
" .dataframe tbody tr th:only-of-type {\n",
" vertical-align: middle;\n",
" }\n",
"\n",
" .dataframe tbody tr th {\n",
" vertical-align: top;\n",
" }\n",
"\n",
" .dataframe thead th {\n",
" text-align: right;\n",
" }\n",
"</style>\n",
"<table border=\"1\" class=\"dataframe\">\n",
" <thead>\n",
" <tr style=\"text-align: right;\">\n",
" <th></th>\n",
" <th>First Name</th>\n",
" <th>Last Name</th>\n",
" <th>Place of birth</th>\n",
" <th>Date of Birth T.A.</th>\n",
" </tr>\n",
" </thead>\n",
" <tbody>\n",
" <tr>\n",
" <th>0</th>\n",
" <td>Frodo</td>\n",
" <td>Baggins</td>\n",
" <td>Shire</td>\n",
" <td>2968</td>\n",
" </tr>\n",
" <tr>\n",
" <th>1</th>\n",
" <td>Bilbo</td>\n",
" <td>Baggins</td>\n",
" <td>Shire</td>\n",
" <td>2890</td>\n",
" </tr>\n",
" <tr>\n",
" <th>2</th>\n",
" <td>Aragorn II</td>\n",
" <td>Elessar</td>\n",
" <td>Eriador</td>\n",
" <td>2931</td>\n",
" </tr>\n",
" <tr>\n",
" <th>3</th>\n",
" <td>Samwise</td>\n",
" <td>Gamgee</td>\n",
" <td>Shire</td>\n",
" <td>2980</td>\n",
" </tr>\n",
" </tbody>\n",
"</table>\n",
"</div>"
],
"text/plain": [
" First Name Last Name Place of birth Date of Birth T.A.\n",
"0 Frodo Baggins Shire 2968\n",
"1 Bilbo Baggins Shire 2890\n",
"2 Aragorn II Elessar Eriador 2931\n",
"3 Samwise Gamgee Shire 2980"
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"import pandas as pd\n",
"from IPython.display import display\n",
"data = {'First Name': [\"Frodo\", \"Bilbo\", \"Aragorn II\", \"Samwise\"],\n",
" 'Last Name': [\"Baggins\", \"Baggins\",\"Elessar\",\"Gamgee\"],\n",
" 'Place of birth': [\"Shire\", \"Shire\", \"Eriador\", \"Shire\"],\n",
" 'Date of Birth T.A.': [2968, 2890, 2931, 2980]\n",
" }\n",
"data_pandas = pd.DataFrame(data)\n",
"display(data_pandas)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"In the above we have imported **pandas** with the shorthand **pd**, the latter has become the standard way we import **pandas**. We make then a list of various variables\n",
"and reorganize the aboves lists into a **DataFrame** and then print out a neat table with specific column labels as *Name*, *place of birth* and *date of birth*.\n",
"Displaying these results, we see that the indices are given by the default numbers from zero to three.\n",
"**pandas** is extremely flexible and we can easily change the above indices by defining a new type of indexing as"
]
},
{
"cell_type": "code",
"execution_count": 22,
"metadata": {},
"outputs": [
{
"data": {
"text/html": [
"<div>\n",
"<style scoped>\n",
" .dataframe tbody tr th:only-of-type {\n",
" vertical-align: middle;\n",
" }\n",
"\n",
" .dataframe tbody tr th {\n",
" vertical-align: top;\n",
" }\n",
"\n",
" .dataframe thead th {\n",
" text-align: right;\n",
" }\n",
"</style>\n",
"<table border=\"1\" class=\"dataframe\">\n",
" <thead>\n",
" <tr style=\"text-align: right;\">\n",
" <th></th>\n",
" <th>First Name</th>\n",
" <th>Last Name</th>\n",
" <th>Place of birth</th>\n",
" <th>Date of Birth T.A.</th>\n",
" </tr>\n",
" </thead>\n",
" <tbody>\n",
" <tr>\n",
" <th>Frodo</th>\n",
" <td>Frodo</td>\n",
" <td>Baggins</td>\n",
" <td>Shire</td>\n",
" <td>2968</td>\n",
" </tr>\n",
" <tr>\n",
" <th>Bilbo</th>\n",
" <td>Bilbo</td>\n",
" <td>Baggins</td>\n",
" <td>Shire</td>\n",
" <td>2890</td>\n",
" </tr>\n",
" <tr>\n",
" <th>Aragorn</th>\n",
" <td>Aragorn II</td>\n",
" <td>Elessar</td>\n",
" <td>Eriador</td>\n",
" <td>2931</td>\n",
" </tr>\n",
" <tr>\n",
" <th>Sam</th>\n",
" <td>Samwise</td>\n",
" <td>Gamgee</td>\n",
" <td>Shire</td>\n",
" <td>2980</td>\n",
" </tr>\n",
" </tbody>\n",
"</table>\n",
"</div>"
],
"text/plain": [
" First Name Last Name Place of birth Date of Birth T.A.\n",
"Frodo Frodo Baggins Shire 2968\n",
"Bilbo Bilbo Baggins Shire 2890\n",
"Aragorn Aragorn II Elessar Eriador 2931\n",
"Sam Samwise Gamgee Shire 2980"
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"data_pandas = pd.DataFrame(data,index=['Frodo','Bilbo','Aragorn','Sam'])\n",
"display(data_pandas)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Thereafter we display the content of the row which begins with the index **Aragorn**"
]
},
{
"cell_type": "code",
"execution_count": 23,
"metadata": {},
"outputs": [
{
"data": {
"text/plain": [
"First Name Aragorn II\n",
"Last Name Elessar\n",
"Place of birth Eriador\n",
"Date of Birth T.A. 2931\n",
"Name: Aragorn, dtype: object"
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"display(data_pandas.loc['Aragorn'])"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"We can easily append data to this, for example"
]
},
{
"cell_type": "code",
"execution_count": 24,
"metadata": {},
"outputs": [
{
"data": {
"text/html": [
"<div>\n",
"<style scoped>\n",
" .dataframe tbody tr th:only-of-type {\n",
" vertical-align: middle;\n",
" }\n",
"\n",
" .dataframe tbody tr th {\n",
" vertical-align: top;\n",
" }\n",
"\n",
" .dataframe thead th {\n",
" text-align: right;\n",
" }\n",
"</style>\n",
"<table border=\"1\" class=\"dataframe\">\n",
" <thead>\n",
" <tr style=\"text-align: right;\">\n",
" <th></th>\n",
" <th>First Name</th>\n",
" <th>Last Name</th>\n",
" <th>Place of birth</th>\n",
" <th>Date of Birth T.A.</th>\n",
" </tr>\n",
" </thead>\n",
" <tbody>\n",
" <tr>\n",
" <th>Frodo</th>\n",
" <td>Frodo</td>\n",
" <td>Baggins</td>\n",
" <td>Shire</td>\n",
" <td>2968</td>\n",
" </tr>\n",
" <tr>\n",
" <th>Bilbo</th>\n",
" <td>Bilbo</td>\n",
" <td>Baggins</td>\n",
" <td>Shire</td>\n",
" <td>2890</td>\n",
" </tr>\n",
" <tr>\n",
" <th>Aragorn</th>\n",
" <td>Aragorn II</td>\n",
" <td>Elessar</td>\n",
" <td>Eriador</td>\n",
" <td>2931</td>\n",
" </tr>\n",
" <tr>\n",
" <th>Sam</th>\n",
" <td>Samwise</td>\n",
" <td>Gamgee</td>\n",
" <td>Shire</td>\n",
" <td>2980</td>\n",
" </tr>\n",
" <tr>\n",
" <th>Pippin</th>\n",
" <td>Peregrin</td>\n",
" <td>Took</td>\n",
" <td>Shire</td>\n",
" <td>2990</td>\n",
" </tr>\n",
" </tbody>\n",
"</table>\n",
"</div>"
],
"text/plain": [
" First Name Last Name Place of birth Date of Birth T.A.\n",
"Frodo Frodo Baggins Shire 2968\n",
"Bilbo Bilbo Baggins Shire 2890\n",
"Aragorn Aragorn II Elessar Eriador 2931\n",
"Sam Samwise Gamgee Shire 2980\n",
"Pippin Peregrin Took Shire 2990"
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"new_hobbit = {'First Name': [\"Peregrin\"],\n",
" 'Last Name': [\"Took\"],\n",
" 'Place of birth': [\"Shire\"],\n",
" 'Date of Birth T.A.': [2990]\n",
" }\n",
"data_pandas=data_pandas.append(pd.DataFrame(new_hobbit, index=['Pippin']))\n",
"display(data_pandas)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Here are other examples where we use the **DataFrame** functionality to handle arrays, now with more interesting features for us, namely numbers. We set up a matrix \n",
"of dimensionality $10\\times 5$ and compute the mean value and standard deviation of each column. Similarly, we can perform mathematial operations like squaring the matrix elements and many other operations."
]
},
{
"cell_type": "code",
"execution_count": 25,
"metadata": {},
"outputs": [
{
"data": {
"text/html": [
"<div>\n",
"<style scoped>\n",
" .dataframe tbody tr th:only-of-type {\n",
" vertical-align: middle;\n",
" }\n",
"\n",
" .dataframe tbody tr th {\n",
" vertical-align: top;\n",
" }\n",
"\n",
" .dataframe thead th {\n",
" text-align: right;\n",
" }\n",
"</style>\n",
"<table border=\"1\" class=\"dataframe\">\n",
" <thead>\n",
" <tr style=\"text-align: right;\">\n",
" <th></th>\n",
" <th>0</th>\n",
" <th>1</th>\n",
" <th>2</th>\n",
" <th>3</th>\n",
" <th>4</th>\n",
" </tr>\n",
" </thead>\n",
" <tbody>\n",
" <tr>\n",
" <th>0</th>\n",
" <td>-1.749765</td>\n",
" <td>0.342680</td>\n",
" <td>1.153036</td>\n",
" <td>-0.252436</td>\n",
" <td>0.981321</td>\n",
" </tr>\n",
" <tr>\n",
" <th>1</th>\n",
" <td>0.514219</td>\n",
" <td>0.221180</td>\n",
" <td>-1.070043</td>\n",
" <td>-0.189496</td>\n",
" <td>0.255001</td>\n",
" </tr>\n",
" <tr>\n",
" <th>2</th>\n",
" <td>-0.458027</td>\n",
" <td>0.435163</td>\n",
" <td>-0.583595</td>\n",
" <td>0.816847</td>\n",
" <td>0.672721</td>\n",
" </tr>\n",
" <tr>\n",
" <th>3</th>\n",
" <td>-0.104411</td>\n",
" <td>-0.531280</td>\n",
" <td>1.029733</td>\n",
" <td>-0.438136</td>\n",
" <td>-1.118318</td>\n",
" </tr>\n",
" <tr>\n",
" <th>4</th>\n",
" <td>1.618982</td>\n",
" <td>1.541605</td>\n",
" <td>-0.251879</td>\n",
" <td>-0.842436</td>\n",
" <td>0.184519</td>\n",
" </tr>\n",
" <tr>\n",
" <th>5</th>\n",
" <td>0.937082</td>\n",
" <td>0.731000</td>\n",
" <td>1.361556</td>\n",
" <td>-0.326238</td>\n",
" <td>0.055676</td>\n",
" </tr>\n",
" <tr>\n",
" <th>6</th>\n",
" <td>0.222400</td>\n",
" <td>-1.443217</td>\n",
" <td>-0.756352</td>\n",
" <td>0.816454</td>\n",
" <td>0.750445</td>\n",
" </tr>\n",
" <tr>\n",
" <th>7</th>\n",
" <td>-0.455947</td>\n",
" <td>1.189622</td>\n",
" <td>-1.690617</td>\n",
" <td>-1.356399</td>\n",
" <td>-1.232435</td>\n",
" </tr>\n",
" <tr>\n",
" <th>8</th>\n",
" <td>-0.544439</td>\n",
" <td>-0.668172</td>\n",
" <td>0.007315</td>\n",
" <td>-0.612939</td>\n",
" <td>1.299748</td>\n",
" </tr>\n",
" <tr>\n",
" <th>9</th>\n",
" <td>-1.733096</td>\n",
" <td>-0.983310</td>\n",
" <td>0.357508</td>\n",
" <td>-1.613579</td>\n",
" <td>1.470714</td>\n",
" </tr>\n",
" </tbody>\n",
"</table>\n",
"</div>"
],
"text/plain": [
" 0 1 2 3 4\n",
"0 -1.749765 0.342680 1.153036 -0.252436 0.981321\n",
"1 0.514219 0.221180 -1.070043 -0.189496 0.255001\n",
"2 -0.458027 0.435163 -0.583595 0.816847 0.672721\n",
"3 -0.104411 -0.531280 1.029733 -0.438136 -1.118318\n",
"4 1.618982 1.541605 -0.251879 -0.842436 0.184519\n",
"5 0.937082 0.731000 1.361556 -0.326238 0.055676\n",
"6 0.222400 -1.443217 -0.756352 0.816454 0.750445\n",
"7 -0.455947 1.189622 -1.690617 -1.356399 -1.232435\n",
"8 -0.544439 -0.668172 0.007315 -0.612939 1.299748\n",
"9 -1.733096 -0.983310 0.357508 -1.613579 1.470714"
]
},
"metadata": {},
"output_type": "display_data"
},
{
"name": "stdout",
"output_type": "stream",
"text": [
"0 -0.175300\n",
"1 0.083527\n",
"2 -0.044334\n",
"3 -0.399836\n",
"4 0.331939\n",
"dtype: float64\n",
"0 1.069584\n",
"1 0.965548\n",
"2 1.018232\n",
"3 0.793167\n",
"4 0.918992\n",
"dtype: float64\n"
]
},
{
"data": {
"text/html": [
"<div>\n",
"<style scoped>\n",
" .dataframe tbody tr th:only-of-type {\n",
" vertical-align: middle;\n",
" }\n",
"\n",
" .dataframe tbody tr th {\n",
" vertical-align: top;\n",
" }\n",
"\n",
" .dataframe thead th {\n",
" text-align: right;\n",
" }\n",
"</style>\n",
"<table border=\"1\" class=\"dataframe\">\n",
" <thead>\n",
" <tr style=\"text-align: right;\">\n",
" <th></th>\n",
" <th>0</th>\n",
" <th>1</th>\n",
" <th>2</th>\n",
" <th>3</th>\n",
" <th>4</th>\n",
" </tr>\n",
" </thead>\n",
" <tbody>\n",
" <tr>\n",
" <th>0</th>\n",
" <td>3.061679</td>\n",
" <td>0.117430</td>\n",
" <td>1.329492</td>\n",
" <td>0.063724</td>\n",
" <td>0.962990</td>\n",
" </tr>\n",
" <tr>\n",
" <th>1</th>\n",
" <td>0.264421</td>\n",
" <td>0.048920</td>\n",
" <td>1.144993</td>\n",
" <td>0.035909</td>\n",
" <td>0.065026</td>\n",
" </tr>\n",
" <tr>\n",
" <th>2</th>\n",
" <td>0.209789</td>\n",
" <td>0.189367</td>\n",
" <td>0.340583</td>\n",
" <td>0.667239</td>\n",
" <td>0.452553</td>\n",
" </tr>\n",
" <tr>\n",
" <th>3</th>\n",
" <td>0.010902</td>\n",
" <td>0.282259</td>\n",
" <td>1.060349</td>\n",
" <td>0.191963</td>\n",
" <td>1.250636</td>\n",
" </tr>\n",
" <tr>\n",
" <th>4</th>\n",
" <td>2.621102</td>\n",
" <td>2.376547</td>\n",
" <td>0.063443</td>\n",
" <td>0.709698</td>\n",
" <td>0.034047</td>\n",
" </tr>\n",
" <tr>\n",
" <th>5</th>\n",
" <td>0.878123</td>\n",
" <td>0.534362</td>\n",
" <td>1.853835</td>\n",
" <td>0.106431</td>\n",
" <td>0.003100</td>\n",
" </tr>\n",
" <tr>\n",
" <th>6</th>\n",
" <td>0.049462</td>\n",
" <td>2.082875</td>\n",
" <td>0.572069</td>\n",
" <td>0.666597</td>\n",
" <td>0.563167</td>\n",
" </tr>\n",
" <tr>\n",
" <th>7</th>\n",
" <td>0.207888</td>\n",
" <td>1.415201</td>\n",
" <td>2.858185</td>\n",
" <td>1.839818</td>\n",
" <td>1.518895</td>\n",
" </tr>\n",
" <tr>\n",
" <th>8</th>\n",
" <td>0.296414</td>\n",
" <td>0.446453</td>\n",
" <td>0.000054</td>\n",
" <td>0.375694</td>\n",
" <td>1.689345</td>\n",
" </tr>\n",
" <tr>\n",
" <th>9</th>\n",
" <td>3.003620</td>\n",
" <td>0.966899</td>\n",
" <td>0.127812</td>\n",
" <td>2.603636</td>\n",
" <td>2.162999</td>\n",
" </tr>\n",
" </tbody>\n",
"</table>\n",
"</div>"
],
"text/plain": [
" 0 1 2 3 4\n",
"0 3.061679 0.117430 1.329492 0.063724 0.962990\n",
"1 0.264421 0.048920 1.144993 0.035909 0.065026\n",
"2 0.209789 0.189367 0.340583 0.667239 0.452553\n",
"3 0.010902 0.282259 1.060349 0.191963 1.250636\n",
"4 2.621102 2.376547 0.063443 0.709698 0.034047\n",
"5 0.878123 0.534362 1.853835 0.106431 0.003100\n",
"6 0.049462 2.082875 0.572069 0.666597 0.563167\n",
"7 0.207888 1.415201 2.858185 1.839818 1.518895\n",
"8 0.296414 0.446453 0.000054 0.375694 1.689345\n",
"9 3.003620 0.966899 0.127812 2.603636 2.162999"
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"import numpy as np\n",
"import pandas as pd\n",
"from IPython.display import display\n",
"np.random.seed(100)\n",
"# setting up a 10 x 5 matrix\n",
"rows = 10\n",
"cols = 5\n",
"a = np.random.randn(rows,cols)\n",
"df = pd.DataFrame(a)\n",
"display(df)\n",
"print(df.mean())\n",
"print(df.std())\n",
"display(df**2)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Thereafter we can select specific columns only and plot final results"
]
},
{
"cell_type": "code",
"execution_count": 26,
"metadata": {},
"outputs": [
{
"data": {
"text/html": [
"<div>\n",
"<style scoped>\n",
" .dataframe tbody tr th:only-of-type {\n",
" vertical-align: middle;\n",
" }\n",
"\n",
" .dataframe tbody tr th {\n",
" vertical-align: top;\n",
" }\n",
"\n",
" .dataframe thead th {\n",
" text-align: right;\n",
" }\n",
"</style>\n",
"<table border=\"1\" class=\"dataframe\">\n",
" <thead>\n",
" <tr style=\"text-align: right;\">\n",
" <th></th>\n",
" <th>First</th>\n",
" <th>Second</th>\n",
" <th>Third</th>\n",
" <th>Fourth</th>\n",
" <th>Fifth</th>\n",
" </tr>\n",
" </thead>\n",
" <tbody>\n",
" <tr>\n",
" <th>0</th>\n",
" <td>-1.749765</td>\n",
" <td>0.342680</td>\n",
" <td>1.153036</td>\n",
" <td>-0.252436</td>\n",
" <td>0.981321</td>\n",
" </tr>\n",
" <tr>\n",
" <th>1</th>\n",
" <td>0.514219</td>\n",
" <td>0.221180</td>\n",
" <td>-1.070043</td>\n",
" <td>-0.189496</td>\n",
" <td>0.255001</td>\n",
" </tr>\n",
" <tr>\n",
" <th>2</th>\n",
" <td>-0.458027</td>\n",
" <td>0.435163</td>\n",
" <td>-0.583595</td>\n",
" <td>0.816847</td>\n",
" <td>0.672721</td>\n",
" </tr>\n",
" <tr>\n",
" <th>3</th>\n",
" <td>-0.104411</td>\n",
" <td>-0.531280</td>\n",
" <td>1.029733</td>\n",
" <td>-0.438136</td>\n",
" <td>-1.118318</td>\n",
" </tr>\n",
" <tr>\n",
" <th>4</th>\n",
" <td>1.618982</td>\n",
" <td>1.541605</td>\n",
" <td>-0.251879</td>\n",
" <td>-0.842436</td>\n",
" <td>0.184519</td>\n",
" </tr>\n",
" <tr>\n",
" <th>5</th>\n",
" <td>0.937082</td>\n",
" <td>0.731000</td>\n",
" <td>1.361556</td>\n",
" <td>-0.326238</td>\n",
" <td>0.055676</td>\n",
" </tr>\n",
" <tr>\n",
" <th>6</th>\n",
" <td>0.222400</td>\n",
" <td>-1.443217</td>\n",
" <td>-0.756352</td>\n",
" <td>0.816454</td>\n",
" <td>0.750445</td>\n",
" </tr>\n",
" <tr>\n",
" <th>7</th>\n",
" <td>-0.455947</td>\n",
" <td>1.189622</td>\n",
" <td>-1.690617</td>\n",
" <td>-1.356399</td>\n",
" <td>-1.232435</td>\n",
" </tr>\n",
" <tr>\n",
" <th>8</th>\n",
" <td>-0.544439</td>\n",
" <td>-0.668172</td>\n",
" <td>0.007315</td>\n",
" <td>-0.612939</td>\n",
" <td>1.299748</td>\n",
" </tr>\n",
" <tr>\n",
" <th>9</th>\n",
" <td>-1.733096</td>\n",
" <td>-0.983310</td>\n",
" <td>0.357508</td>\n",
" <td>-1.613579</td>\n",
" <td>1.470714</td>\n",
" </tr>\n",
" </tbody>\n",
"</table>\n",
"</div>"
],
"text/plain": [
" First Second Third Fourth Fifth\n",
"0 -1.749765 0.342680 1.153036 -0.252436 0.981321\n",
"1 0.514219 0.221180 -1.070043 -0.189496 0.255001\n",
"2 -0.458027 0.435163 -0.583595 0.816847 0.672721\n",
"3 -0.104411 -0.531280 1.029733 -0.438136 -1.118318\n",
"4 1.618982 1.541605 -0.251879 -0.842436 0.184519\n",
"5 0.937082 0.731000 1.361556 -0.326238 0.055676\n",
"6 0.222400 -1.443217 -0.756352 0.816454 0.750445\n",
"7 -0.455947 1.189622 -1.690617 -1.356399 -1.232435\n",
"8 -0.544439 -0.668172 0.007315 -0.612939 1.299748\n",
"9 -1.733096 -0.983310 0.357508 -1.613579 1.470714"
]
},
"metadata": {},
"output_type": "display_data"
},
{
"name": "stdout",
"output_type": "stream",
"text": [
"0.08352721390288316\n",
"<class 'pandas.core.frame.DataFrame'>\n",
"Int64Index: 10 entries, 0 to 9\n",
"Data columns (total 5 columns):\n",
" # Column Non-Null Count Dtype \n",
"--- ------ -------------- ----- \n",
" 0 First 10 non-null float64\n",
" 1 Second 10 non-null float64\n",
" 2 Third 10 non-null float64\n",
" 3 Fourth 10 non-null float64\n",
" 4 Fifth 10 non-null float64\n",
"dtypes: float64(5)\n",
"memory usage: 480.0 bytes\n",
"None\n",
" First Second Third Fourth Fifth\n",
"count 10.000000 10.000000 10.000000 10.000000 10.000000\n",
"mean -0.175300 0.083527 -0.044334 -0.399836 0.331939\n",
"std 1.069584 0.965548 1.018232 0.793167 0.918992\n",
"min -1.749765 -1.443217 -1.690617 -1.613579 -1.232435\n",
"25% -0.522836 -0.633949 -0.713163 -0.785061 0.087887\n",
"50% -0.280179 0.281930 -0.122282 -0.382187 0.463861\n",
"75% 0.441264 0.657041 0.861676 -0.205231 0.923602\n",
"max 1.618982 1.541605 1.361556 0.816847 1.470714\n"
]
},
{
"data": {
"image/png": "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\n",
"text/plain": [
"<Figure size 720x432 with 1 Axes>"
]
},
"metadata": {},
"output_type": "display_data"
},
{
"data": {
"image/png": "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TXV1tT755BPl5eVpx44dmjJlihISEnxdltec/l7ZtWuXvvrqK/Xr108PP/ywr8vyGrvdrk8//VRHjhzRoUOHLPfdYrfbtXfvXhUUFKi8vFzjxo1TQECAT2tq8jNb//rXv5STk6OUlBTt2bNHr732mux2u6/L8oqysjItXbpUjzzyiEpLSy0VtI4fP645c+boyJEjGjRokDZu3Ki33nrL12V51aOPPuoKyidOnND69etVU1Pj67K8Jjs7W0ePHlVubq5KS0t9XY7XPfTQQzp48KB++ctfas6cOb4ux6v279+vkpISpaWlafr06erUqZOvS/Ka48eP6ze/+Y0+//xzDR8+XEOHDtXQoUN9XZZXrV69WtnZ2erfv79KSkr02muv6dSpU74uy2vWrVunQ4cOqV+/fsrKytKaNWv0/fff+7SmJh+2XnnlFXXt2lXx8fEaNWqUvvzyS+3evdvXZXnFkSNHNHr0aF1++eX69NNPJfl+KtWbxo4dq2HDhikpKUk9evRQTk6Or0vyqlGjRmn48OHq1q2bOnbsKIfDoWbN/P8je/o9mJGRoT59+shmsyk/P1+SLBUmR40apYEDB+rkyZP697//rdzcXF+X5DWvvfaanE6n8vPztW3bNkv1FhERoQULFuiJJ57Q4MGD5XQ6VVRU5OuyvGrLli3q0qWLunXrpssuu0ySFBwcbIm/Dw6HQzt37lRSUpLi4+N13XXXKTMzU59//rlP6/L/b24PVFdXq3v37vrqq68kSQkJCQoLC9MXX3zh48q8IzExUb169VJ0dLR27twpyTphq127dhoyZIiCgoIkSbGxsYqLi/NxVd41evRotW7dWu+//77279+v+Ph4ORwOX5flMZvNpgMHDigyMlK33XabbDabvvjiCxUXF1siTJ7Wvn17paenKzIyUjU1NZo9e7YOHjzo67I8VlNTo06dOmnLli1q3769YmJitGbNGm3atMnXpXlFUFCQevbsKUkqLy9XRESEoqOjfVyVd40cOVJbtmzRypUrlZ+fr5qaGhUVFVni14/KykrFx8dr+/btkqQOHTqooKBABw4c8Gld1vlmuwg2m00dOnRw/a8sIiJCrVu3dv0B93fNmjXTJZdcol69emn//v2uZVZw5pdCTk6O8vLyNHbsWJWXl/uwKu+rqalRTEyMHnroIX3wwQdavny5r0vyiu+++065ubnKzs5Wfn6+tmzZooyMDF+X5VWDBw/WpEmTlJiYqOuvv15JSUl6//33fV2Wx05/9nJychQXF6fBgwerX79+2rlzp2X+M3das2bNtHPnTvXu3dvXpXjVuHHjFB8fr7Zt22rixIn67rvvtHDhQku8fiEhIbr++uu1d+9evfvuu/riiy/Ur18/hYSE+LQua/zlvUjNmjVTv379dODAAZ04cUJBQUE6evSoa1rVCpo1a6aePXuqurpaJSUlvi7HiH379mnixIkqKytTenq6KisrfV2S1zgcDiUlJSkpKUl9+vRRZWWlJfb8ys3NVYcOHdSmTRulpqYqJiZGcXFxlviyPy04OFjBwcGSpMDAQFVUVCgyMtLHVXnOZrNp4MCBCg4Olt1uV7NmzVRZWamuXbuqqqrK1+V51SWXXKL27duruLjY16V4VVFRkd544w39/Oc/V3x8vLp3766oqCjL/Gd14MCBmjNnjtq1a6c777xTAQEBPt+Bo8nvjXj55ZcrJSVFa9asUXh4uEJDQ9WlSxdfl+VVVVVVKi0t1fTp0zVt2jT16tXL1yV5zQcffKDVq1frww8/1MGDBzVkyBBVVVXpkksu8XVpHisrK9OWLVtUUVGh0NBQ7d69WyNHjvT5XjXecMcdd7hmSN59913t3btXW7ZsUZs2bdS2bVsfV+cd5eXleuONN1RdXa3w8HCdOnXK9fOUv0tOTlbv3r21atUqtWvXTrm5uRo1apQlPndneu+99xQdHa3IyEhL7c3dvHlzXXnllXruuecUExOj3bt3a9iwYZbaI7GgoECHDh1SYWGhoqOjfb6Zic1ppf9KXiSHw6GcnBxVV1erR48eCggIsMwHy+Fw6J///Ke+/vprXXnllUpJSbFEX6etWrVKBQUFuuWWW5SUlGS5L/sPPvhAX3/9tQYPHqyYmBhLBK0z2e12FRUVKSYmRoGB1vu/30cffaTDhw/r6quvVufOnS31+pWXlysnJ0dBQUFKSEiw1Pfmabm5uXI6nYqPj/d1KV6Xm5urzz77TD179tRll11mqfemJO3cudMVIuPj432+CQ1hCwAAwKAmvc0WAACAaYQtAAAAgwhbAAAABhG2AAAADCJsAQAAGETYAgAAMIiwBQAAYND/B3waQPOjlPYaAAAAAElFTkSuQmCC\n",
"text/plain": [
"<Figure size 720x432 with 1 Axes>"
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"df.columns = ['First', 'Second', 'Third', 'Fourth', 'Fifth']\n",
"df.index = np.arange(10)\n",
"\n",
"display(df)\n",
"print(df['Second'].mean() )\n",
"print(df.info())\n",
"print(df.describe())\n",
"\n",
"from pylab import plt, mpl\n",
"plt.style.use('seaborn')\n",
"mpl.rcParams['font.family'] = 'serif'\n",
"\n",
"df.cumsum().plot(lw=2.0, figsize=(10,6))\n",
"plt.show()\n",
"\n",
"\n",
"df.plot.bar(figsize=(10,6), rot=15)\n",
"plt.show()"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"We can produce a $4\\times 4$ matrix"
]
},
{
"cell_type": "code",
"execution_count": 27,
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"[[ 0 1 2 3]\n",
" [ 4 5 6 7]\n",
" [ 8 9 10 11]\n",
" [12 13 14 15]]\n",
" 0 1 2 3\n",
"0 0 1 2 3\n",
"1 4 5 6 7\n",
"2 8 9 10 11\n",
"3 12 13 14 15\n"
]
}
],
"source": [
"b = np.arange(16).reshape((4,4))\n",
"print(b)\n",
"df1 = pd.DataFrame(b)\n",
"print(df1)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"and many other operations. \n",
"\n",
"The **Series** class is another important class included in\n",
"**pandas**. You can view it as a specialization of **DataFrame** but where\n",
"we have just a single column of data. It shares many of the same features as _DataFrame. As with **DataFrame**,\n",
"most operations are vectorized, achieving thereby a high performance when dealing with computations of arrays, in particular labeled arrays.\n",
"As we will see below it leads also to a very concice code close to the mathematical operations we may be interested in.\n",
"For multidimensional arrays, we recommend strongly [xarray](http://xarray.pydata.org/en/stable/). **xarray** has much of the same flexibility as **pandas**, but allows for the extension to higher dimensions than two. We will see examples later of the usage of both **pandas** and **xarray**. \n",
"\n",
"\n",
"\n",
"## Reading Data and fitting\n",
"\n",
"In order to study various Machine Learning algorithms, we need to\n",
"access data. Acccessing data is an essential step in all machine\n",
"learning algorithms. In particular, setting up the so-called **design\n",
"matrix** (to be defined below) is often the first element we need in\n",
"order to perform our calculations. To set up the design matrix means\n",
"reading (and later, when the calculations are done, writing) data\n",
"in various formats, The formats span from reading files from disk,\n",
"loading data from databases and interacting with online sources\n",
"like web application programming interfaces (APIs).\n",
"\n",
"In handling various input formats, as discussed above, we will mainly stay with **pandas**,\n",
"a Python package which allows us, in a seamless and painless way, to\n",
"deal with a multitude of formats, from standard **csv** (comma separated\n",
"values) files, via **excel**, **html** to **hdf5** formats. With **pandas**\n",
"and the **DataFrame** and **Series** functionalities we are able to convert text data\n",
"into the calculational formats we need for a specific algorithm. And our code is going to be \n",
"pretty close the basic mathematical expressions.\n",
"\n",
"Our first data set is going to be a classic from nuclear physics, namely all\n",
"available data on binding energies. Don't be intimidated if you are not familiar with nuclear physics. It serves simply as an example here of a data set. \n",
"\n",
"We will show some of the\n",
"strengths of packages like **Scikit-Learn** in fitting nuclear binding energies to\n",
"specific functions using linear regression first. Then, as a teaser, we will show you how \n",
"you can easily implement other algorithms like decision trees and random forests and neural networks.\n",
"\n",
"But before we really start with nuclear physics data, let's just look at some simpler polynomial fitting cases, such as,\n",
"(don't be offended) fitting straight lines!\n",
"\n",
"\n",
"### Simple linear regression model using **scikit-learn**\n",
"\n",
"We start with perhaps our simplest possible example, using **Scikit-Learn** to perform linear regression analysis on a data set produced by us. \n",
"\n",
"What follows is a simple Python code where we have defined a function\n",
"$y$ in terms of the variable $x$. Both are defined as vectors with $100$ entries. \n",
"The numbers in the vector $\\hat{x}$ are given\n",
"by random numbers generated with a uniform distribution with entries\n",
"$x_i \\in [0,1]$ (more about probability distribution functions\n",
"later). These values are then used to define a function $y(x)$\n",
"(tabulated again as a vector) with a linear dependence on $x$ plus a\n",
"random noise added via the normal distribution.\n",
"\n",
"\n",
"The Numpy functions are imported used the **import numpy as np**\n",
"statement and the random number generator for the uniform distribution\n",
"is called using the function **np.random.rand()**, where we specificy\n",
"that we want $100$ random variables. Using Numpy we define\n",
"automatically an array with the specified number of elements, $100$ in\n",
"our case. With the Numpy function **randn()** we can compute random\n",
"numbers with the normal distribution (mean value $\\mu$ equal to zero and\n",
"variance $\\sigma^2$ set to one) and produce the values of $y$ assuming a linear\n",
"dependence as function of $x$"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"$$\n",
"y = 2x+N(0,1),\n",
"$$"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"where $N(0,1)$ represents random numbers generated by the normal\n",
"distribution. From **Scikit-Learn** we import then the\n",
"**LinearRegression** functionality and make a prediction $\\tilde{y} =\n",
"\\alpha + \\beta x$ using the function **fit(x,y)**. We call the set of\n",
"data $(\\hat{x},\\hat{y})$ for our training data. The Python package\n",
"**scikit-learn** has also a functionality which extracts the above\n",
"fitting parameters $\\alpha$ and $\\beta$ (see below). Later we will\n",
"distinguish between training data and test data.\n",
"\n",
"For plotting we use the Python package\n",
"[matplotlib](https://matplotlib.org/) which produces publication\n",
"quality figures. Feel free to explore the extensive\n",
"[gallery](https://matplotlib.org/gallery/index.html) of examples. In\n",
"this example we plot our original values of $x$ and $y$ as well as the\n",
"prediction **ypredict** ($\\tilde{y}$), which attempts at fitting our\n",
"data with a straight line.\n",
"\n",
"The Python code follows here."
]
},
{
"cell_type": "code",
"execution_count": 29,
"metadata": {},
"outputs": [
{
"data": {
"image/png": "iVBORw0KGgoAAAANSUhEUgAAAfIAAAFnCAYAAABdOssgAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAALEgAACxIB0t1+/AAAADh0RVh0U29mdHdhcmUAbWF0cGxvdGxpYiB2ZXJzaW9uMy4yLjIsIGh0dHA6Ly9tYXRwbG90bGliLm9yZy+WH4yJAAAgAElEQVR4nO3deXRUVbo28KdmCEkggRAZhAY0QAgzgpEhZEC4omIQFC7XAURobVScGmwV29Z2wG4aEa+CXm2nT2zBoEjbYEgCyBAmQcIUBRGQwQyEEJLUuL8/KhymqqSS1Kk6u+r5reVaVp2kzlubk3pr7/3ufXRCCAEiIiKSkj7YARAREVHDMZETERFJjImciIhIYkzkREREEmMiJyIikhgTORERkcSYyCkk/frrr3jggQcwadIk3HPPPbjrrrvwySefKMfnzJmD5cuX+/28CxcuxODBg/HGG2/U+3eXL1+OUaNGISkpCVOmTLniuNVqRUpKCqqqqvwRaqMcOHAAd9xxB7p27Yrx48fjrrvuwsiRI/H73/8excXFwQ7PZ2pdB0SBpOM6cgpFd911F0aNGoVJkyYBAPLz8/Hiiy9ixYoVAIBz587BYrHAaDT6/dyzZ89Gu3bt8NBDD9X7d7/44gvMnz8f69at83i8vLwc0dHRjQ3RL44dO4b09HSsXr0aHTt2hNVqxbhx49CjRw+88sorwQ7PJ2peB0SBwh45haTdu3dj0KBByuNBgwbhlltuUR43a9ZMyg9vrSRxTywWC4YMGYKCgoJgh+IzWa8DoovxCqaQ1LZtW7z77ruYM2cOIiIiAADTpk0D4B7CXrBgAQYOHIhXXnkFCxcuxKeffoqRI0eivLwcu3fvRkZGBkaOHIm3334bhYWFmD17NjIyMrBmzRq89tpriImJwbXXXovCwkLYbDa88MIL6NGjh8dYCgoK8PLLL0On08FgMGDOnDno0qVLvd/T448/jtWrV+Pdd99F3759cd9992HLli2YM2cO8vLy8PPPP2PWrFkYMWIEAHdv88UXX8Thw4chhMCYMWMwceJEAMC2bduwYMECCCFgt9sxdepUZGRkwGazXfK6ubm5yM/Px7vvvnvJFyNvHA4H4uPjlcclJSV47rnncPr0aTidTuU8AFBaWopZs2bh9OnTiI+PR4sWLZCXl4eJEyciLi4OixYtQu/evdGsWTNs374drVq1wkcffYT169dj4cKFMJvNaNasGZ5//nnEx8ejqqoKs2fPRklJCZxOJ3r16oWnnnoKLpcLzz//PAoLC2EwGNCxY0c8/fTTWL169SXXAQD88MMPmDt3LoQQ0Ol0+OMf/4hevXop/+6tWrVC7969sXXrVuj1erz55pto2bJlvf8tifxKEIWgjRs3ioEDB4r+/fuL2bNni/z8/EuOL1iwQMyaNUt5PGvWLJGZmSmsVqsoKSkRPXr0EG+++aYQQohVq1aJkSNHKj+7bNky0b17d7F//34hhBBfffWVSE1NFTabTXmtBQsWCCGEKC8vF4MGDRIbN24UQgiRm5srbrzxRuF0Oj3GvWzZMjF06FCv7ys1NVVs3rxZeZyQkCAWL14shBBi5cqV4sYbb1SOPf300+LJJ58UQghx9uxZkZaWJrZu3SqEECIvL08cPnxYOTZkyBBRXl5+yeu+8cYbyvsrKCi4IpajR4+KhIQE5XVKS0vFQw89JAoLC5WfmTx5spg/f74QQohTp06JgQMHiqNHjwohhHj44YfFs88+e0l8F/+bLFiwQNxwww2ipKREOBwOMXfuXHHkyBHRp08fcfDgQSGEEB9//LG45557lP+fM2eOEEIIh8Mhxo4dq7zX++67T3ndBx98UInh4uugvLxcDBw4UGnfrVu3ioEDB4ozZ84IIdz/Nr179xZHjhwRQggxdepU8fbbb1/5j0QUYBxap5CUnJyM3NxczJo1C8eOHcPdd9+NOXPm1Po7AwcOhNlsRmxsLGJjY9GtWzcAQNeuXXHs2LFLfvaaa65B165dAQA33XQTfvvtN+zcufOK18zNzUVERASSk5MBAMOHD0dxcTF27drlj7cJABg6dKgS56+//goAcLlc+PLLLzFu3DgAQGRkJFJTU/HVV18BAK699lq8/vrrmDBhAh544AGUlZXh559/vuR1z/ecb7nlFq+jDQDwxBNPYOzYsRg2bBg6duyIa6+9FgBw6tQpbNiwQYmhdevW6NevH1auXAmn04ns7Gzceuutl8R3uT59+iA2NhYGgwFPPvkkvv76ayQlJaFz584AgJtvvhmbNm3Cb7/9hhYtWmD79u3YuXMnDAYDPv74YwDu6YjCwkJs2LABLpcL8+bNQ9u2ba84V25uLiIjI5WRhwEDBqB58+bIyclRfqZTp064+uqrlfa+/LogCgYOrVPIioiIwPjx4zF+/Hhs2bIF99xzD6ZOnYoOHTp4/PlmzZop/280GpXHBoMBdrv9kp9t3ry58v8GgwFRUVEoKiq64jVPnjyJM2fO4K677lKei42NRVlZWaPe28UiIyMBuOeoz8dZWloKm82G1157DU2aNAHgLpTr3r07AGDWrFlISEjAvHnzAABpaWlXVMOff926/O1vf0PHjh3x8ccf44UXXsDo0aPRrVs3nDx5UjmXTqcDAJw+fRoJCQkoLS2Fw+FATEyM8jrNmzdHRUXFJa8dFRV1yeOTJ0/i4MGDl7Rnu3btUFJSgtGjR8PhcOCll15CWVkZ7r33Xvz3f/83+vbtixdeeAHvvPMO/vSnP+HOO+/E9OnTr3gfJ0+eRGxs7CXPxcbGKu/j8ja5uL2JgomJnELSc889h+eff155PHDgQLRo0eKKRNFQFydih8OBs2fPIi4u7oqfa9OmDa666ip89NFHynMVFRUwm80+n+v48eM4fvw4BgwY4PPvxMbGwmw249lnn0WvXr0AAHa7HdXV1QDcc8EXL3HzR0KaNGkSPvvsM3z44Yd46aWXcNVVVwEAFixYoCRIq9UKh8OBJk2awGg0orS0VKkX8OXLTZs2bZCUlITFixcrz505cwaRkZEoLS3FTTfdhDFjxmDv3r2YPHkyOnfujB49emDgwIFISUnBkSNHMHXqVMTHx+P222+/4rVLS0svea60tFR5H0RaxaF1CkmbNm3CDz/8oDzesmULdDqdMiTbWIcPH8aBAwcAACtXrkTr1q3Rp0+fK34uNTUVZWVlSiyVlZW4++676/WF4ujRo9i0aVO94tPr9bjtttuUoXQAeOutt5Q10x06dFCG9/fv3+9xNKG+dDod7r//fnz99dcoLS1FfHw8hgwZgi+//FL5meeeew75+fkwGAwYMWKEcqyiogLr16+v8xyjR4/Grl27lCmEkpIS/M///A9cLhc++eQTrF27FgCQkJCA5s2bw+Vy4dtvv8Vnn32mvO/4+Hi4XK4rXjs1NRXnzp3D1q1bAQA7duzAmTNnkJaW1riGIVKZ4c9//vOfgx0Ekb9ZLBa89957yMrKwrJly7B161b89a9/Rfv27bF8+XJ88MEHOHToEGw2GwoKCrB8+XL8+OOPaNu2LT766CNs27YNBQUFGDRoEJ588kmcOnUK33//PcaMGYN9+/bh9OnTKCoqwltvvYXt27dj7ty5aNOmDRYuXIiVK1fixx9/REREBPr27YtBgwZh7ty5+OKLL/DVV1/hgQceQGJi4hUxr1q1Cv/85z9x4sQJ7Nu3D9988w2++eYbrF27Fu3bt8e//vUv7N69GwUFBejZsydmz56No0ePYteuXRg1ahT+8Ic/XBLnoEGDkJubi3feeQfLly9HdHQ0HnjgAej1enTt2hXvvPMOVq1ahd9++w3Hjx/H9u3bcd111+GJJ55QXrd9+/bKnPDFDhw4gNmzZ+PUqVPYtWsXrr76alx99dW45pprkJWVhRUrViA2Nhb33nsvlixZgo8++gjLli1D7969MX78eADuUZLz/xZbt25FQkICnE4nMjIysGLFCrz//vs4dOgQDhw4oFTiN2/eHN27d8eLL76IL7/8EqtWrcLTTz+Ndu3awWKxYNGiRcjKysInn3yC1NRU3HnnnbBYLPj000/x+eef45NPPkGXLl0wffp0rFix4pLrYPDgwbj++usxb948LFu2DJs3b8arr76KDh06YNOmTZg3bx6OHDmC6upqVFRUYPHixTh06BD0ej369u2r7gVNVAtuCENUT1988QWysrIuGS6n+isvL0dkZCT0evfA4PPPP4+IiAg8+eSTQY6MSC4cWieioPi///s/bNiwAYA7qefl5WHIkCFBjopIPuyRE9XD+Y1BiouLMWbMGDz77LPBDklaGzZswOuvvw6LxYJz585hzJgxuOeee4IdFpF0ApLI77jjDlgsFgDuIpwPPvhA7VMSERGFhYAsPxs6dGiDbiBBREREtQtIIi8sLMTixYthtVrRs2dPDB8+PBCnJSIiCnkBSeT3338/evXqBafTiUmTJqFZs2a47rrrvP68qLlhAREREdUuIIn8/M5SBoMBAwYMQH5+fq2JXKfToajobCBCC1txcVFsY5WxjdXHNg4MtrP64uKi6v4hL1Rffnbw4EF8/vnnyuNffvnF617XREREVD+q98gjIyORl5eH3377DRUVFbjqqqtw8803q31aIiKisKB6Io+Pj8ebb76p9mmIiIjCEnd2IyIikhgTORERkcSYyImIiCTGRE5ERCQxJnIiIiKJMZETERFJjImciIhIYkzkREREEmMiJyIikhgTORERkcSYyImIiCTGRE5ERCQxJnIiIiKJMZETERFJjImciIhIYkzkREREEmMiJyIikhgTORERkcSYyImIiCTGRE5ERCQxJnIiIiKJMZETERFJjImciIhIYkzkREREEmMiJyIikhgTORERkcSYyImIiCTGRE5ERCQxJnIiIiKJMZETERFJjImciIhIYkzkREREEmMiJyIikhgTORERkcSYyImIiCTGRE5ERCQxJnIiIiKJMZETERFJjImciIhIYkzkREREEmMiJyIikhgTORERkcSYyImIiCTGRE5ERCQxJnIiIiKJMZETERFJjImciIhIYkzkREREEmMiJyIikhgTORERAEvWUsSkJKNVmxjEpCTDkrU02CER+cQY7ACIiILNkrUU0dOnKI+N+/YgevoUlAOwZo4LXmBEPghYj7y6uhq33HILXn311UCdkojIJxHz/+75+dfnBTgSovoLWCKfP38+EhMTA3U6IiKfGQr31+t5Ii0JSCJfvnw5+vXrh/bt2wfidERE9eJM6Fav54m0RPVE/tNPP+HQoUO48cYb1T4VEVGDVM583PPzjzwW4EiI6k8nhBBqnuCtt96C0+mE2WzGxo0bYbfbMWLECNx7771qnpaIqH6WLAFefhnYuxdITASeegqYMCHYURHVSfVEfrE33ngDlZWVmDVrVp0/W1R0NgARha+4uCi2scrYxupjGwcG21l9cXFRDf7dgBW7rVq1Clu3bsXOnTvx9ddfB+q0REREIS1g68hHjhyJkSNHBup0REREYYE7uxEREUmMiZyIiEhiTOREREQSYyInIiKSGBM5EamCdxMjCgze/YyI/I53EyMKHPbIicjveDcxosBhIiciv+PdxIgCh4mciPyOdxMjChwmciLyO95NjChwmMiJyO+smeNQvug9OBKTIIxGOBKTUL7oPRa6aRhXGciLVetEpApr5jgmbklwlYHc2CMnIgpzXGUgNyZyIqIwx1UGcmMiJyIKc1xlIDcmciKiMMdVBnJjIiciCnNcZSA3Vq0TERFXGUiMPXIiIiKJMZETERFJjImciIhIYkzkREREEmMiJyIikhgTORERkcSYyImIiCTGRE5ERCQxJnIiIiKJMZETERFJjImciIhIYkzkREREEmMiJyIikhgTORERkcSYyImIiCTGRE5ERCQxJnIiIiKJMZETERFJjImciIhIYkzkREREEmMiJyIikhgTORERkcSYyImIiCTGRE5ERCQxJnIi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\n",
"text/plain": [
"<Figure size 576x396 with 1 Axes>"
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"# Importing various packages\n",
"import numpy as np\n",
"import matplotlib.pyplot as plt\n",
"from sklearn.linear_model import LinearRegression\n",
"\n",
"x = np.random.rand(100,1)\n",
"y = 2*x+np.random.randn(100,1)\n",
"linreg = LinearRegression()\n",
"linreg.fit(x,y)\n",
"xnew = np.array([[0],[1]])\n",
"ypredict = linreg.predict(xnew)\n",
"\n",
"plt.plot(xnew, ypredict, \"r-\")\n",
"plt.plot(x, y ,'ro')\n",
"plt.axis([0,1.0,0, 5.0])\n",
"plt.xlabel(r'$x$')\n",
"plt.ylabel(r'$y$')\n",
"plt.title(r'Simple Linear Regression')\n",
"plt.show()"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"This example serves several aims. It allows us to demonstrate several\n",
"aspects of data analysis and later machine learning algorithms. The\n",
"immediate visualization shows that our linear fit is not\n",
"impressive. It goes through the data points, but there are many\n",
"outliers which are not reproduced by our linear regression. We could\n",
"now play around with this small program and change for example the\n",
"factor in front of $x$ and the normal distribution. Try to change the\n",
"function $y$ to"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"$$\n",
"y = 10x+0.01 \\times N(0,1),\n",
"$$"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"where $x$ is defined as before. Does the fit look better? Indeed, by\n",
"reducing the role of the noise given by the normal distribution we see immediately that\n",
"our linear prediction seemingly reproduces better the training\n",
"set. However, this testing 'by the eye' is obviouly not satisfactory in the\n",
"long run. Here we have only defined the training data and our model, and \n",
"have not discussed a more rigorous approach to the **cost** function.\n",
"\n",
"We need more rigorous criteria in defining whether we have succeeded or\n",
"not in modeling our training data. You will be surprised to see that\n",
"many scientists seldomly venture beyond this 'by the eye' approach. A\n",
"standard approach for the *cost* function is the so-called $\\chi^2$\n",
"function (a variant of the mean-squared error (MSE))"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"$$\n",
"\\chi^2 = \\frac{1}{n}\n",
"\\sum_{i=0}^{n-1}\\frac{(y_i-\\tilde{y}_i)^2}{\\sigma_i^2},\n",
"$$"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"where $\\sigma_i^2$ is the variance (to be defined later) of the entry\n",
"$y_i$. We may not know the explicit value of $\\sigma_i^2$, it serves\n",
"however the aim of scaling the equations and make the cost function\n",
"dimensionless. \n",
"\n",
"Minimizing the cost function is a central aspect of\n",
"our discussions to come. Finding its minima as function of the model\n",
"parameters ($\\alpha$ and $\\beta$ in our case) will be a recurring\n",
"theme in these series of lectures. Essentially all machine learning\n",
"algorithms we will discuss center around the minimization of the\n",
"chosen cost function. This depends in turn on our specific\n",
"model for describing the data, a typical situation in supervised\n",
"learning. Automatizing the search for the minima of the cost function is a\n",
"central ingredient in all algorithms. Typical methods which are\n",
"employed are various variants of **gradient** methods. These will be\n",
"discussed in more detail later. Again, you'll be surprised to hear that\n",
"many practitioners minimize the above function ''by the eye', popularly dubbed as \n",
"'chi by the eye'. That is, change a parameter and see (visually and numerically) that \n",
"the $\\chi^2$ function becomes smaller. \n",
"\n",
"There are many ways to define the cost function. A simpler approach is to look at the relative difference between the training data and the predicted data, that is we define \n",
"the relative error (why would we prefer the MSE instead of the relative error?) as"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"$$\n",
"\\epsilon_{\\mathrm{relative}}= \\frac{\\vert \\hat{y} -\\hat{\\tilde{y}}\\vert}{\\vert \\hat{y}\\vert}.\n",
"$$"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"The squared cost function results in an arithmetic mean-unbiased\n",
"estimator, and the absolute-value cost function results in a\n",
"median-unbiased estimator (in the one-dimensional case, and a\n",
"geometric median-unbiased estimator for the multi-dimensional\n",
"case). The squared cost function has the disadvantage that it has the tendency\n",
"to be dominated by outliers.\n",
"\n",
"We can modify easily the above Python code and plot the relative error instead"
]
},
{
"cell_type": "code",
"execution_count": 30,
"metadata": {},
"outputs": [
{
"data": {
"image/png": "iVBORw0KGgoAAAANSUhEUgAAAfsAAAFnCAYAAAChL+DqAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAALEgAACxIB0t1+/AAAADh0RVh0U29mdHdhcmUAbWF0cGxvdGxpYiB2ZXJzaW9uMy4yLjIsIGh0dHA6Ly9tYXRwbG90bGliLm9yZy+WH4yJAAAgAElEQVR4nO3deXRU5f3H8c8kITEmQWBIgRhorUfDJiC1HFOrcHBBPIpgtRZUqtgGZVFUUOlPJVrqEhUtuCJK0VZR0Vg0WlBqRA2KbcRqRKpokL2QGEIWsj6/PzAjgdkzN5l5eL/O4ejMPHPvd557cz9zn7uMyxhjBAAArBXX0QUAAABnEfYAAFiOsAcAwHKEPQAAliPsAQCwHGEPAIDlCHsgSrz//vs6//zzlZWVpUsvvVSXXHKJzjrrLM2aNUs1NTUB3//8889r5MiRuvnmm8Ou4bzzztOmTZvCfj+A6OTiOnsgenz44YeaOHGiSkpKlJCQoD179mj06NEaP368pk+fHvD9CxYs0NatW3X33XcHbHvzzTfr6KOPbjXdyspKde7cuU2fAUD0Yc8eiGJHHXWUTjrpJH322WftMj+CHrBTQkcXAMC/xsZG9ejRw/P422+/VW5ururr69Xc3KyZM2dq6NChXt/78MMPa/Xq1UpKSlJycrLuuOMO9ejRQ0uWLNG7776rpKQkrV27VmPGjNHGjRu1bNky/eEPf9BRRx2lW265RcnJyZo5c6bOOeccXXbZZfr666911113KTs7W/PmzdPHH38sl8ulU045RVOnTpXL5TqkhoaGBq9tGxoadOWVV2rt2rW67bbb9Pbbb+vDDz/UNddco9dee0179+7VhAkT9NZbb+njjz/Whg0bVFpaqj/+8Y/at2+fmpqaNGXKFJ122mn6z3/+o1tvvdXrewBIMgCixgcffGCOP/5409DQYIwxZuvWreaqq64yO3bsMMYY09jYaM4++2zz4osvGmOMWb9+vRk2bJjZu3evMcaY+fPnm5tuuskzvaeffto0NzcbY4x56aWXzMyZMz2v3XTTTWb+/Pmt5n/ppZeal156yRhjzJIlS8wVV1zhee3NN980zz//vDHGmEceecRcdtllprGx0dTX15uLL77YvPLKK14/U6C2xx9/vFmwYIExxpjly5ebzz77zHzwwQdmwIAB5v333zfGGHP33XebhoYGM2rUKE99mzZtMieeeKLZtGmTp+8Ofg+A/RjGB6LQ5ZdfrjFjxmj06NE65ZRTPHv269at0+bNm3X++edLkvr27asePXqosLDQ63R69eqliRMn6pJLLtGSJUtUUlISdA3nnnuuPvroI+3cuVOS9I9//EOjR4+WJOXn52vcuHGKj49Xp06ddPbZZ2v58uVepxNM2zPOOEPS/hMEBwwYIElKTk7WL37xC0nSTTfdpE8++URbtmzRmDFjJEl9+vTR4MGDW03r4PcA2I9hfCAK/eUvf1FcXJzuu+8+5eXlafTo0XK73Z7gnTRpkqdtfX299u7de8g0SktLNWPGDD377LMaNGiQPvzwQ82ePTvoGrp166ZTTjlFf//733XxxRcrPj5eaWlpkqQdO3Zo8eLFevnllyVJ1dXVPo/3B9M2NTX1kPe1zKvFzp071blzZyUk/LDZ6tatm6dPvL0HwH6EPRCl4uLiNH36dOXn52vp0qWaOnWqevbsqU6dOumZZ57xtKupqVFc3KGDdJ9//rlSUlI0aNAgSfuP/Ydq7Nixmj9/vtLS0jx79dL+EYOrr77a81xzc7MqKyu9TiOUtv707NlTlZWVamxs9AR+eXm5jjnmmJCnBRxuGMYHolhycrImTpyo5557Tg0NDRo8eLB69eqllStXStof4FOnTlVpaekh7/3xj3+syspKffPNN5Kkd999t9XrKSkpqq2tVU1NjW644Qav8x85cqR2796tF154Qb/85S89z48bN06vvfaampqaJO0fqn/ssce8TiOUtv4MHjxYffr00WuvvSZJ2rx5sz755BPPsD4A3+Jzc3NzO7oIAPtvqnP33Xdr9+7d+uijjzRo0CB169ZNffv21aJFi/Tmm2/quOOO08UXX6yHH35YL774ol5++WWdf/75Ou200/T888/rr3/9q77++mvV19frnHPOUWNjo+6991598MEHSkxM1L///W+VlpbqzDPPVOfOnbVo0SIVFBRo7Nixys/P1+rVq7V+/XplZmbqJz/5ieLj47Vlyxb16dNHw4cP99Q6ePBgbdiwQfPnz9fy5ctVUVGh2bNnq1OnTod8Ln9tJ02a5AntzMxM9e7dW1999ZVuvfVWbd26VWvWrNHIkSN1xBFHKC4uTqeeeqqeeOIJPf/881qxYoVuueUWDR482Od7AOzHTXUA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\n",
"text/plain": [
"<Figure size 576x396 with 1 Axes>"
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"import numpy as np\n",
"import matplotlib.pyplot as plt\n",
"from sklearn.linear_model import LinearRegression\n",
"\n",
"x = np.random.rand(100,1)\n",
"y = 5*x+0.01*np.random.randn(100,1)\n",
"linreg = LinearRegression()\n",
"linreg.fit(x,y)\n",
"ypredict = linreg.predict(x)\n",
"\n",
"plt.plot(x, np.abs(ypredict-y)/abs(y), \"ro\")\n",
"plt.axis([0,1.0,0.0, 0.5])\n",
"plt.xlabel(r'$x$')\n",
"plt.ylabel(r'$\\epsilon_{\\mathrm{relative}}$')\n",
"plt.title(r'Relative error')\n",
"plt.show()"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Depending on the parameter in front of the normal distribution, we may\n",
"have a small or larger relative error. Try to play around with\n",
"different training data sets and study (graphically) the value of the\n",
"relative error.\n",
"\n",
"As mentioned above, **Scikit-Learn** has an impressive functionality.\n",
"We can for example extract the values of $\\alpha$ and $\\beta$ and\n",
"their error estimates, or the variance and standard deviation and many\n",
"other properties from the statistical data analysis. \n",
"\n",
"Here we show an\n",
"example of the functionality of **Scikit-Learn**."
]
},
{
"cell_type": "code",
"execution_count": 31,
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"The intercept alpha: \n",
" [1.92115887]\n",
"Coefficient beta : \n",
" [[5.06920615]]\n",
"Mean squared error: 0.26\n",
"Variance score: 0.89\n",
"Mean squared log error: 0.01\n",
"Mean absolute error: 0.39\n"
]
},
{
"data": {
"image/png": "iVBORw0KGgoAAAANSUhEUgAAAfIAAAFnCAYAAABdOssgAAAABHNCSVQICAgIfAhkiAAAAAlwSFlzAAALEgAACxIB0t1+/AAAADh0RVh0U29mdHdhcmUAbWF0cGxvdGxpYiB2ZXJzaW9uMy4yLjIsIGh0dHA6Ly9tYXRwbG90bGliLm9yZy+WH4yJAAAgAElEQVR4nO3de3hU1bk/8O8kQ4IhGQlkgiBHRVrAAEGqrYJwCCoigkJyQImIP7RKDgiCoGJBxCNWA1ZExAuXYq0/D1iioSAFqcUoJaJQJUC4q4AhXHJlEoYkZLLOH2lGktlz39fZ38/z9HmaPZe9ZiXyzlrrXe+yCCEEiIiIyJCitG4AERERhY6BnIiIyMAYyImIiAyMgZyIiMjAGMiJiIgMjIGciIjIwBjIiQBs374dI0eORPfu3fHAAw+gsrLS4zl33303jh8/rkHrmisvL8f48ePRvXt33HPPPRg/fjyGDx+O8ePH48cff9S6eQFbtmwZ3nzzTUXe++zZsxg3bhzGjh2LjIwMbNiwAXPmzFHkXkRas3AfOVGjr7/+Gg8++CAKCwthtVo9Hnc4HLDZbBq0TFr37t3x7rvvon///mhoaMDEiRNRW1uL999/X+umBaSurg5CCMTGxsr+3osXL0ZZWRnmz5+P3NxcDB06FEIItGnTBgDwzDPP4Morr8TUqVNlvzeR2jgiJwqQnoJ4S1FRUUhLS8O+ffu0bkrAYmJiFAniAHDmzBkkJycDANLT0xEXF+cO4kSRxnPYQUQesrOzkZOTg9mzZyMjIwNTpkzBF198galTp2L37t04cuQIJkyYgHHjxgEALl68iEWLFuG7776DxWLBLbfcgsceewwWiwVHjhzBggULUFNTg4sXLyIjIwP33XcfALjfd9q0adi1axe++eYbPPvss8jIyPDbxvr6enTo0MH98/nz5/Hiiy/i2LFjEEJg5MiRyMzMBAA4nU7MnTsX33//PZKTk3HttdciJycHI0aMwMCBA/HKK68gKSkJvXv3xldffQWHw4GtW7di3759ePnll2GxWBAdHY3nnnsOXbt2RUNDA/7nf/4Hhw8fRnR0NK6++mrMmTMHcXFxWLp0KbZt24aYmBi0b98es2fPxpEjRzB//nzY7Xb3DMKxY8cwf/581NTUwOVyYfLkyfjP//xP7NmzB3PnzkVVVRXuv/9+5OXl4dy5c1iyZAm6dOni0Q9Lly7Fl19+idjYWHzzzTeYM2cOZs2ahaqqKmzduhXvvfcetm3b5n78nnvuwZgxY8L+GyHSjCAiIYQQO3bsEN26dRMXL16UfPyBBx4QH330kfvnwYMHi3nz5gkhhCgoKBDXX3+9+7VvvfWWGD9+vKivrxd1dXXivvvuE+vWrRNCCLF7926xe/duIYQQdXV14s477xQ//vhjs/d95plnhBBCfPXVV+Lzzz+XbE+3bt3E9u3bhRBCOJ1O8fTTT4uvv/7a/ficOXPEU089JYQQoqqqStx6661i586dQgghFixYIH77298Kl8slamtrxb333iseeOAB92s/+ugjkZqaKo4ePSqEECI7O1s4HA5x0003ifz8fCGEEJ9//rm44447hMvlEnl5eeK3v/2t+/WTJ08WP/30kzhy5IgYNmyYaGhoEEII8fvf/17s2LHDfY+me168eFEMHTrU3b/Hjx8Xffv2FcePH3f/bnr27Olu/7x588TcuXMl+0UIIWbNmiWWLFni/nnHjh1i8ODBXh8nMjJOrROFYeDAgQAa16udTifKysoAALm5uUhPT0d0dDRatWqFO++8E+vXrwcAXH311cjJycHYsWPx8MMPo6SkBPv372/2vrfddhsA4Oabb0ZaWprX+2dnZ+O+++7DzTffjPr6evz6178GADQ0NOCvf/0rRo8eDQCIj4/H4MGD3W3YvHkzRowYgaioKMTExODOO+/0eO8uXbqga9euAIBZs2bh888/R1xcHPr16wcASEtLQ2lpKQoKCmCz2XD48GFs374dDQ0NWLRoETp16oQ2bdqgtLQUW7ZswcWLF/Hkk0/ihhtu8LhXQUEBioqKcM899wAArrrqKvTp08fdXgCIi4vDjTfe6O7voqIir/1CZCacWicKQ3x8PAC413ovXrwIADh9+jTeffddfPzxxwAap7mb1tizs7PhcDjwwQcfIDo6GuPHj0dNTU2z901ISAjo/s888wz69++PrVu3YtKkSRg+fDhuvfVWlJeXo66uDq+88gpat24NoDFZ77rrrgMAlJSUIDEx0f0+l19+ucd7t2zD6dOnce7cOYwfP959rV27dqisrMTgwYMxf/58rFixArNnz8Z9992HrKwsdOzYEcuWLcOKFSvwwgsv4O6778a0adM8kgnPnDkDm83W7Hq7du1w5swZ989NfQ009ndTXxOZHQM5kQ9VVVX417/+5XNULKVjx46YNGkShg0bBqBxhOxwOAAAe/bswf3334/o6GgAkCUg3XrrrUhLS8N7772HW2+9Fe3atUNMTAzmzp2L1NRU932avjDY7XZUVFS4Xy+13U7qM11xxRXNsuKrq6sRExODqqoq/OY3v8GgQYNw4sQJPPLII+jQoQPuuusu/OIXv8Bbb72FkpISTJ06FStWrMDjjz/e7L2vuOIKOBwO1NfXu4N5eXm55Bo4ETXHqXUiH86dO4fNmzcH/br09HR88skncLlcABqn2t955x0AjdPGBQUFABr3Ox86dEiWtk6cOBE7duzAoUOHEBUVhVGjRjWbmn777bexbt06AMCwYcOwYcMGNDQ0oK6uDp999pnf9x88eDAqKyuxZ88eAI0Jcw8++CCqq6vx97//HR9++KH783Xo0AENDQ3Ys2cPlixZAqDxy0OXLl3cfXKpPn364KqrrsInn3wCAPjpp59QUFDgnmqXW5s2bXDhwgU4nU7MnDlTkXsQqSX6+eeff17rRhBpbdeuXViyZAmKi4tx9OhRbN68GZs2bcJnn32GuLg47Nq1C19++SUOHDiAzp0746233kJBQQH27duHAQMGYM6cOfjhhx9QUFCAIUOG4KabbsKhQ4ewZMkSrF+/HpWVlfjd736HVq1a4brrrsOHH36Ijz/+GIcOHUJNTQ127tyJrl274o033nC/b3x8PLp37+7R1vLyckycOBEnT57EwYMH3c/r1KkTvv76a6xduxZRUVF49NFH8fnnn2PFihVYt24dbDYbJk2ahKioKPTt2xdfffUV3n77bfzzn/9EamoqTp06hYyMDHz11VdYtGgRTpw4gR07dmDkyJEAGreL3XTTTVi4cCE+/vhjrF+/HpMmTUJKSgpiY2OxevVqrF27Fh988AG6du2KrKwsxMXFYdOmTfjggw/wl7/8BVarFU899RR27dqF1157DSdOnMCZM2eQlpaGgQMHYsWKFfjwww/x6aef4tlnn0WfPn1w9OhRzJ07FydPnsTp06fRvn17ZGdn48SJE6isrMQtt9zSrH+WLl2KjRs34siRI9izZw+uueYaPPfcc+7+GjZsGGw2G1auXImNGzdi1KhRkv1MZBQsCENkQufPn0erVq0QExMDAFi5ciX27duHxYsXa9wyIgoWp9aJ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VdtqVIH08TPPPIMxY8ZgxIgRKC8vxx133IHPPvsMbdu2Vbu5ESvUuKfJiPz6669HcXEx6urqAADffvst0tLSUFlZ6Z5GSEtLw3fffQcAOHToEHr06IH4+HgtmmtYgfRzTU0N5s2bh4ceegi9evXCp59+qmWTDcdfH3fs2BHZ2dmYOHEiJk6cCKBxZMMgHrhA/o779euHn376CUDjP34ulwt2u12zNhtNIH186tQpd5/abDZERUWhoaFBszZHCjninma11rdv345PP/0UiYmJaNWqFaZMmYKFCxeibdu2mDhxImpqarBgwQLY7XacOHECWVlZzFoPgb9+njJlCo4cOYLk5GQAgNPplMymJO/89THQuKa4Zs0avP7665g8eTLGjh2LDh06aNxy4/DXx1VVVXjllVfQqVMnnDhxAkOHDsWgQYO0brah+OvjXbt24c9//jNSUlJQVFSEnj17IjMzU+tmG8o333yDdevWYdu2bcjMzMTDDz+MJUuWhB33eGgKERGRgbEgDBERkYExkBMRERkYAzkREZGBMZATEREZGAM5ERGRgTGQExERGRgDORERkYExkBOZ3O9+9zssXboUAHDs2DEMHToUhYWFGreKiALFgjBEJnfmzBlkZGRgxYoVePLJJ/HCCy/gxhtv1LpZRBQgTQ5NISL96NChA0aNGoVx48ZhyZIlDOJEBsOpdSKTKysrw5dffonLLrsMHTt21Lo5RBQkTq0TmZjD4cCECROQlZWF8vJyfPHFF3jnnXe0bhYRBYEjciKTunDhArKyspCZmYmhQ4dizJgxOHbsGHbs2KF104goCByRExERGRhH5ERERAbGQE5ERGRgDOREREQGxkBORERkYAzkREREBsZATkREZGAM5ERERAbGQE5ERGRg/wfemR2en+GFBQAAAABJRU5ErkJggg==\n",
"text/plain": [
"<Figure size 576x396 with 1 Axes>"
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"import numpy as np \n",
"import matplotlib.pyplot as plt \n",
"from sklearn.linear_model import LinearRegression \n",
"from sklearn.metrics import mean_squared_error, r2_score, mean_squared_log_error, mean_absolute_error\n",
"\n",
"x = np.random.rand(100,1)\n",
"y = 2.0+ 5*x+0.5*np.random.randn(100,1)\n",
"linreg = LinearRegression()\n",
"linreg.fit(x,y)\n",
"ypredict = linreg.predict(x)\n",
"print('The intercept alpha: \\n', linreg.intercept_)\n",
"print('Coefficient beta : \\n', linreg.coef_)\n",
"# The mean squared error \n",
"print(\"Mean squared error: %.2f\" % mean_squared_error(y, ypredict))\n",
"# Explained variance score: 1 is perfect prediction \n",
"print('Variance score: %.2f' % r2_score(y, ypredict))\n",
"# Mean squared log error \n",
"print('Mean squared log error: %.2f' % mean_squared_log_error(y, ypredict) )\n",
"# Mean absolute error \n",
"print('Mean absolute error: %.2f' % mean_absolute_error(y, ypredict))\n",
"plt.plot(x, ypredict, \"r-\")\n",
"plt.plot(x, y ,'ro')\n",
"plt.axis([0.0,1.0,1.5, 7.0])\n",
"plt.xlabel(r'$x$')\n",
"plt.ylabel(r'$y$')\n",
"plt.title(r'Linear Regression fit ')\n",
"plt.show()"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"The function **coef** gives us the parameter $\\beta$ of our fit while **intercept** yields \n",
"$\\alpha$. Depending on the constant in front of the normal distribution, we get values near or far from $alpha =2$ and $\\beta =5$. Try to play around with different parameters in front of the normal distribution. The function **meansquarederror** gives us the mean square error, a risk metric corresponding to the expected value of the squared (quadratic) error or loss defined as"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"$$\n",
"MSE(\\hat{y},\\hat{\\tilde{y}}) = \\frac{1}{n}\n",
"\\sum_{i=0}^{n-1}(y_i-\\tilde{y}_i)^2,\n",
"$$"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"The smaller the value, the better the fit. Ideally we would like to\n",
"have an MSE equal zero. The attentive reader has probably recognized\n",
"this function as being similar to the $\\chi^2$ function defined above.\n",
"\n",
"The **r2score** function computes $R^2$, the coefficient of\n",
"determination. It provides a measure of how well future samples are\n",
"likely to be predicted by the model. Best possible score is 1.0 and it\n",
"can be negative (because the model can be arbitrarily worse). A\n",
"constant model that always predicts the expected value of $\\hat{y}$,\n",
"disregarding the input features, would get a $R^2$ score of $0.0$.\n",
"\n",
"If $\\tilde{\\hat{y}}_i$ is the predicted value of the $i-th$ sample and $y_i$ is the corresponding true value, then the score $R^2$ is defined as"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"$$\n",
"R^2(\\hat{y}, \\tilde{\\hat{y}}) = 1 - \\frac{\\sum_{i=0}^{n - 1} (y_i - \\tilde{y}_i)^2}{\\sum_{i=0}^{n - 1} (y_i - \\bar{y})^2},\n",
"$$"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"where we have defined the mean value of $\\hat{y}$ as"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"$$\n",
"\\bar{y} = \\frac{1}{n} \\sum_{i=0}^{n - 1} y_i.\n",
"$$"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Another quantity taht we will meet again in our discussions of regression analysis is \n",
" the mean absolute error (MAE), a risk metric corresponding to the expected value of the absolute error loss or what we call the $l1$-norm loss. In our discussion above we presented the relative error.\n",
"The MAE is defined as follows"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"$$\n",
"\\text{MAE}(\\hat{y}, \\hat{\\tilde{y}}) = \\frac{1}{n} \\sum_{i=0}^{n-1} \\left| y_i - \\tilde{y}_i \\right|.\n",
"$$"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"We present the \n",
"squared logarithmic (quadratic) error"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"$$\n",
"\\text{MSLE}(\\hat{y}, \\hat{\\tilde{y}}) = \\frac{1}{n} \\sum_{i=0}^{n - 1} (\\log_e (1 + y_i) - \\log_e (1 + \\tilde{y}_i) )^2,\n",
"$$"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"where $\\log_e (x)$ stands for the natural logarithm of $x$. This error\n",
"estimate is best to use when targets having exponential growth, such\n",
"as population counts, average sales of a commodity over a span of\n",
"years etc. \n",
"\n",
"\n",
"Finally, another cost function is the Huber cost function used in robust regression.\n",
"\n",
"The rationale behind this possible cost function is its reduced\n",
"sensitivity to outliers in the data set. In our discussions on\n",
"dimensionality reduction and normalization of data we will meet other\n",
"ways of dealing with outliers.\n",
"\n",
"The Huber cost function is defined as"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"$$\n",
"H_{\\delta}(a)={\\begin{cases}{\\frac {1}{2}}{a^{2}}&{\\text{for }}|a|\\leq \\delta ,\\\\\\delta (|a|-{\\frac {1}{2}}\\delta ),&{\\text{otherwise.}}\\end{cases}}}.\n",
"$$"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Here $a=\\boldsymbol{y} - \\boldsymbol{\\tilde{y}}$.\n",
"We will discuss in more\n",
"detail these and other functions in the various lectures. We conclude this part with another example. Instead of \n",
"a linear $x$-dependence we study now a cubic polynomial and use the polynomial regression analysis tools of scikit-learn."
]
},
{
"cell_type": "code",
"execution_count": 27,
"metadata": {},
"outputs": [],
"source": [
"import matplotlib.pyplot as plt\n",
"import numpy as np\n",
"import random\n",
"from sklearn.linear_model import Ridge\n",
"from sklearn.preprocessing import PolynomialFeatures\n",
"from sklearn.pipeline import make_pipeline\n",
"from sklearn.linear_model import LinearRegression\n",
"\n",
"x=np.linspace(0.02,0.98,200)\n",
"noise = np.asarray(random.sample((range(200)),200))\n",
"y=x**3*noise\n",
"yn=x**3*100\n",
"poly3 = PolynomialFeatures(degree=3)\n",
"X = poly3.fit_transform(x[:,np.newaxis])\n",
"clf3 = LinearRegression()\n",
"clf3.fit(X,y)\n",
"\n",
"Xplot=poly3.fit_transform(x[:,np.newaxis])\n",
"poly3_plot=plt.plot(x, clf3.predict(Xplot), label='Cubic Fit')\n",
"plt.plot(x,yn, color='red', label=\"True Cubic\")\n",
"plt.scatter(x, y, label='Data', color='orange', s=15)\n",
"plt.legend()\n",
"plt.show()\n",
"\n",
"def error(a):\n",
" for i in y:\n",
" err=(y-yn)/yn\n",
" return abs(np.sum(err))/len(err)\n",
"\n",
"print (error(y))"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### To our real data: nuclear binding energies. Brief reminder on masses and binding energies\n",
"\n",
"Let us now dive into nuclear physics and remind ourselves briefly about some basic features about binding\n",
"energies. A basic quantity which can be measured for the ground\n",
"states of nuclei is the atomic mass $M(N, Z)$ of the neutral atom with\n",
"atomic mass number $A$ and charge $Z$. The number of neutrons is $N$. There are indeed several sophisticated experiments worldwide which allow us to measure this quantity to high precision (parts per million even). \n",
"\n",
"Atomic masses are usually tabulated in terms of the mass excess defined by"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"$$\n",
"\\Delta M(N, Z) = M(N, Z) - uA,\n",
"$$"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"where $u$ is the Atomic Mass Unit"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"$$\n",
"u = M(^{12}\\mathrm{C})/12 = 931.4940954(57) \\hspace{0.1cm} \\mathrm{MeV}/c^2.\n",
"$$"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"The nucleon masses are"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"$$\n",
"m_p = 1.00727646693(9)u,\n",
"$$"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"and"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"$$\n",
"m_n = 939.56536(8)\\hspace{0.1cm} \\mathrm{MeV}/c^2 = 1.0086649156(6)u.\n",
"$$"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"In the [2016 mass evaluation of by W.J.Huang, G.Audi, M.Wang, F.G.Kondev, S.Naimi and X.Xu](http://nuclearmasses.org/resources_folder/Wang_2017_Chinese_Phys_C_41_030003.pdf)\n",
"there are data on masses and decays of 3437 nuclei.\n",
"\n",
"The nuclear binding energy is defined as the energy required to break\n",
"up a given nucleus into its constituent parts of $N$ neutrons and $Z$\n",
"protons. In terms of the atomic masses $M(N, Z)$ the binding energy is\n",
"defined by"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"$$\n",
"BE(N, Z) = ZM_H c^2 + Nm_n c^2 - M(N, Z)c^2 ,\n",
"$$"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"where $M_H$ is the mass of the hydrogen atom and $m_n$ is the mass of the neutron.\n",
"In terms of the mass excess the binding energy is given by"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"$$\n",
"BE(N, Z) = Z\\Delta_H c^2 + N\\Delta_n c^2 -\\Delta(N, Z)c^2 ,\n",
"$$"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"where $\\Delta_H c^2 = 7.2890$ MeV and $\\Delta_n c^2 = 8.0713$ MeV.\n",
"\n",
"\n",
"A popular and physically intuitive model which can be used to parametrize \n",
"the experimental binding energies as function of $A$, is the so-called \n",
"**liquid drop model**. The ansatz is based on the following expression"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"$$\n",
"BE(N,Z) = a_1A-a_2A^{2/3}-a_3\\frac{Z^2}{A^{1/3}}-a_4\\frac{(N-Z)^2}{A},\n",
"$$"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"where $A$ stands for the number of nucleons and the $a_i$s are parameters which are determined by a fit \n",
"to the experimental data. \n",
"\n",
"\n",
"\n",
"\n",
"To arrive at the above expression we have assumed that we can make the following assumptions:\n",
"\n",
" * There is a volume term $a_1A$ proportional with the number of nucleons (the energy is also an extensive quantity). When an assembly of nucleons of the same size is packed together into the smallest volume, each interior nucleon has a certain number of other nucleons in contact with it. This contribution is proportional to the volume.\n",
"\n",
" * There is a surface energy term $a_2A^{2/3}$. The assumption here is that a nucleon at the surface of a nucleus interacts with fewer other nucleons than one in the interior of the nucleus and hence its binding energy is less. This surface energy term takes that into account and is therefore negative and is proportional to the surface area.\n",
"\n",
" * There is a Coulomb energy term $a_3\\frac{Z^2}{A^{1/3}}$. The electric repulsion between each pair of protons in a nucleus yields less binding. \n",
"\n",
" * There is an asymmetry term $a_4\\frac{(N-Z)^2}{A}$. This term is associated with the Pauli exclusion principle and reflects the fact that the proton-neutron interaction is more attractive on the average than the neutron-neutron and proton-proton interactions.\n",
"\n",
"We could also add a so-called pairing term, which is a correction term that\n",
"arises from the tendency of proton pairs and neutron pairs to\n",
"occur. An even number of particles is more stable than an odd number. \n",
"\n",
"\n",
"### Organizing our data\n",
"\n",
"Let us start with reading and organizing our data. \n",
"We start with the compilation of masses and binding energies from 2016.\n",
"After having downloaded this file to our own computer, we are now ready to read the file and start structuring our data.\n",
"\n",
"\n",
"We start with preparing folders for storing our calculations and the data file over masses and binding energies. We import also various modules that we will find useful in order to present various Machine Learning methods. Here we focus mainly on the functionality of **scikit-learn**."
]
},
{
"cell_type": "code",
"execution_count": 32,
"metadata": {},
"outputs": [],
"source": [
"# Common imports\n",
"import numpy as np\n",
"import pandas as pd\n",
"import matplotlib.pyplot as plt\n",
"import sklearn.linear_model as skl\n",
"from sklearn.model_selection import train_test_split\n",
"from sklearn.metrics import mean_squared_error, r2_score, mean_absolute_error\n",
"import os\n",
"\n",
"# Where to save the figures and data files\n",
"PROJECT_ROOT_DIR = \"Results\"\n",
"FIGURE_ID = \"Results/FigureFiles\"\n",
"DATA_ID = \"DataFiles/\"\n",
"\n",
"if not os.path.exists(PROJECT_ROOT_DIR):\n",
" os.mkdir(PROJECT_ROOT_DIR)\n",
"\n",
"if not os.path.exists(FIGURE_ID):\n",
" os.makedirs(FIGURE_ID)\n",
"\n",
"if not os.path.exists(DATA_ID):\n",
" os.makedirs(DATA_ID)\n",
"\n",
"def image_path(fig_id):\n",
" return os.path.join(FIGURE_ID, fig_id)\n",
"\n",
"def data_path(dat_id):\n",
" return os.path.join(DATA_ID, dat_id)\n",
"\n",
"def save_fig(fig_id):\n",
" plt.savefig(image_path(fig_id) + \".png\", format='png')\n",
"\n",
"infile = open(data_path(\"MassEval2016.dat\"),'r')"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Before we proceed, we define also a function for making our plots. You can obviously avoid this and simply set up various **matplotlib** commands every time you need them. You may however find it convenient to collect all such commands in one function and simply call this function."
]
},
{
"cell_type": "code",
"execution_count": 33,
"metadata": {},
"outputs": [],
"source": [
"from pylab import plt, mpl\n",
"plt.style.use('seaborn')\n",
"mpl.rcParams['font.family'] = 'serif'\n",
"\n",
"def MakePlot(x,y, styles, labels, axlabels):\n",
" plt.figure(figsize=(10,6))\n",
" for i in range(len(x)):\n",
" plt.plot(x[i], y[i], styles[i], label = labels[i])\n",
" plt.xlabel(axlabels[0])\n",
" plt.ylabel(axlabels[1])\n",
" plt.legend(loc=0)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Our next step is to read the data on experimental binding energies and\n",
"reorganize them as functions of the mass number $A$, the number of\n",
"protons $Z$ and neutrons $N$ using **pandas**. Before we do this it is\n",
"always useful (unless you have a binary file or other types of compressed\n",
"data) to actually open the file and simply take a look at it!\n",
"\n",
"\n",
"In particular, the program that outputs the final nuclear masses is written in Fortran with a specific format. It means that we need to figure out the format and which columns contain the data we are interested in. Pandas comes with a function that reads formatted output. After having admired the file, we are now ready to start massaging it with **pandas**. The file begins with some basic format information."
]
},
{
"cell_type": "code",
"execution_count": 30,
"metadata": {},
"outputs": [],
"source": [
"\"\"\" \n",
"This is taken from the data file of the mass 2016 evaluation. \n",
"All files are 3436 lines long with 124 character per line. \n",
" Headers are 39 lines long. \n",
" col 1 : Fortran character control: 1 = page feed 0 = line feed \n",
" format : a1,i3,i5,i5,i5,1x,a3,a4,1x,f13.5,f11.5,f11.3,f9.3,1x,a2,f11.3,f9.3,1x,i3,1x,f12.5,f11.5 \n",
" These formats are reflected in the pandas widths variable below, see the statement \n",
" widths=(1,3,5,5,5,1,3,4,1,13,11,11,9,1,2,11,9,1,3,1,12,11,1), \n",
" Pandas has also a variable header, with length 39 in this case. \n",
"\"\"\""
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"The data we are interested in are in columns 2, 3, 4 and 11, giving us\n",
"the number of neutrons, protons, mass numbers and binding energies,\n",
"respectively. We add also for the sake of completeness the element name. The data are in fixed-width formatted lines and we will\n",
"covert them into the **pandas** DataFrame structure."
]
},
{
"cell_type": "code",
"execution_count": 34,
"metadata": {},
"outputs": [],
"source": [
"# Read the experimental data with Pandas\n",
"Masses = pd.read_fwf(infile, usecols=(2,3,4,6,11),\n",
" names=('N', 'Z', 'A', 'Element', 'Ebinding'),\n",
" widths=(1,3,5,5,5,1,3,4,1,13,11,11,9,1,2,11,9,1,3,1,12,11,1),\n",
" header=39,\n",
" index_col=False)\n",
"\n",
"# Extrapolated values are indicated by '#' in place of the decimal place, so\n",
"# the Ebinding column won't be numeric. Coerce to float and drop these entries.\n",
"Masses['Ebinding'] = pd.to_numeric(Masses['Ebinding'], errors='coerce')\n",
"Masses = Masses.dropna()\n",
"# Convert from keV to MeV.\n",
"Masses['Ebinding'] /= 1000\n",
"\n",
"# Group the DataFrame by nucleon number, A.\n",
"Masses = Masses.groupby('A')\n",
"# Find the rows of the grouped DataFrame with the maximum binding energy.\n",
"Masses = Masses.apply(lambda t: t[t.Ebinding==t.Ebinding.max()])"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"We have now read in the data, grouped them according to the variables we are interested in. \n",
"We see how easy it is to reorganize the data using **pandas**. If we\n",
"were to do these operations in C/C++ or Fortran, we would have had to\n",
"write various functions/subroutines which perform the above\n",
"reorganizations for us. Having reorganized the data, we can now start\n",
"to make some simple fits using both the functionalities in **numpy** and\n",
"**Scikit-Learn** afterwards. \n",
"\n",
"Now we define five variables which contain\n",
"the number of nucleons $A$, the number of protons $Z$ and the number of neutrons $N$, the element name and finally the energies themselves."
]
},
{
"cell_type": "code",
"execution_count": 35,
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
" N Z A Element Ebinding\n",
"A \n",
"1 0 0 1 1 H 0.000000\n",
"2 1 1 1 2 H 1.112283\n",
"3 2 2 1 3 H 2.827265\n",
"4 6 2 2 4 He 7.073915\n",
"5 9 3 2 5 He 5.512132\n",
"... ... ... ... ... ...\n",
"264 3304 156 108 264 Hs 7.298375\n",
"265 3310 157 108 265 Hs 7.296247\n",
"266 3317 158 108 266 Hs 7.298273\n",
"269 3338 159 110 269 Ds 7.250154\n",
"270 3344 160 110 270 Ds 7.253775\n",
"\n",
"[267 rows x 5 columns]\n"
]
}
],
"source": [
"A = Masses['A']\n",
"Z = Masses['Z']\n",
"N = Masses['N']\n",
"Element = Masses['Element']\n",
"Energies = Masses['Ebinding']\n",
"print(Masses)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"The next step, and we will define this mathematically later, is to set up the so-called **design matrix**. We will throughout call this matrix $\\boldsymbol{X}$.\n",
"It has dimensionality $p\\times n$, where $n$ is the number of data points and $p$ are the so-called predictors. In our case here they are given by the number of polynomials in $A$ we wish to include in the fit."
]
},
{
"cell_type": "code",
"execution_count": 36,
"metadata": {},
"outputs": [],
"source": [
"# Now we set up the design matrix X\n",
"X = np.zeros((len(A),5))\n",
"X[:,0] = 1\n",
"X[:,1] = A\n",
"X[:,2] = A**(2.0/3.0)\n",
"X[:,3] = A**(-1.0/3.0)\n",
"X[:,4] = A**(-1.0)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"With **scikitlearn** we are now ready to use linear regression and fit our data."
]
},
{
"cell_type": "code",
"execution_count": 37,
"metadata": {},
"outputs": [],
"source": [
"clf = skl.LinearRegression().fit(X, Energies)\n",
"fity = clf.predict(X)"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"Pretty simple! \n",
"Now we can print measures of how our fit is doing, the coefficients from the fits and plot the final fit together with our data."
]
},
{
"cell_type": "code",
"execution_count": 38,
"metadata": {},
"outputs": [
{
"name": "stdout",
"output_type": "stream",
"text": [
"Mean squared error: 0.04\n",
"Variance score: 0.95\n",
"Mean absolute error: 0.05\n",
"[ 0.00000000e+00 7.06492086e-03 -1.73091052e-01 -1.66020213e+01\n",
" 1.17385778e+00] 15.212327334149508\n"
]
},
{
"data": {
"image/png": "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7du3T1nDplJgGA1rS6uXiYhIxTuq0eAtLS0HPI9Go5PamHIxlEaDW5YqaxERqXwTDutUKsWePXuwrNKc5CeeeIJ0Oj1lDZtKxoCb017WIiJSHSY8devaa6/lwx/+MDt37uSqq65i69atfP3rX5/Ktk0ZYwxObnTqVo3CWkREKtuEw3rlypX853/+J2vWrAHg1FNPHb9/XW2CwBDJAxGwklpqVEREKtuEwxognU5z7rnnTlVbysYYcApAxMJOKaxFRKSyHTGsv/vd777iz9///vdPWmPKJQiCUlinwI4rrEVEpLIdMaw///nPs2LFCpYtW1aO9pSFKQAGrIiF5WoTDxERqWxHDOsbbriBu+++m02bNnHFFVdw2WWXUVdXV462TZ1cAICVVFCLiEjlO2JYX3nllVx55ZXs3LmTn/70p7z3ve/luOOO42Mf+xjHH398Odo46azR1cssXQIXEZEqMOG0mjt3Lh/84Ae56qqreOKJJ/jDH/4wle2aUlZ+tLJOKKxFRKTyHbGyNsbwm9/8hrvuuosNGzZw6aWX8sMf/pB58+aVo31TYqyytjVtS0REqsARw/qcc86hpaWFd73rXXz84x/Hsizy+TybNm0CYOnSpVPeyEmXU2UtIiLV44hhHYlE6O/v51vf+hbf/va3McaM/8yyLB544IEpbeBUsAqlP22FtYiIVIEjhvWDDz5YjnaUlaXR4CIiUkWOWFp+6Utf4umnny5HW8rGHrtnndC64CIiUvmOGNbHH3883/72t7n44ou5/vrrefDBB8nn8+Vo29TJly7lWwlV1iIiUvmOeBn88ssv5/LLL6dQKPDYY4/xwAMPcOONN3L88cdz4YUXct5559HY2FiOtk4aezSsnaQqaxERqXwT3sgjGo1y7rnnjm/ksXbtWv7nf/6Hb33rW/z85z+fsgZOBWu8stYAMxERqXyvOq1OOeUUrr322qMK6lwux9vf/na++MUvvtrTTgprvLJWWIuISOUra1rddNNNLF++vJynPKSxy+AaYCYiItXgqPazBujo6Djotfb29iP+3t13381pp53Giy++SCaTOdrTTqrxedbay1pERKrAUYf1rbfeyoYNG2hoaCAajbJr1y7uuuuuV/ydTZs28dJLL/GpT32KF198cULnaWhI4rqTV/m2tKTHH0eKFtgWLXPTNLSkJu0cM8n+/SWvTH01ceqro6P+mriZ3ldHHdb//M//zFe+8hU+9alPAfCd73zniL9z//33E41GWbVqFb///e8pFovcfvvtfPCDHzzs7/T1TV713dKSpqdnaPy5yQaYwNCfzeH1BJN2npni5f0lh6e+mjj11dFRf03cTOqrw/2j46jDGmDLli2sW7eOSCQyvkb4K/nYxz42/jifz5PJZF4xqKeS8QyWB8YCO6551iIiUvleVVj/3d/9Hd/73vcA+Mu//MsJ/959993Hk08+SbFY5Oc//zmXXXbZqzn9MQmypUraj4Jj6561iIhUvlcV1q2trVxyySXk83m6uromvF3mJZdcwiWXXPJqTjlpgkwAxuBHwVJhLSIiVeBVV9ZLlizBcRwsy+K1r33tZLdryphMgIHRsFZai4hI5XtVYb1y5Uo+9KEPTXZbyiLI+AD4MVXWIiJSHV5VWD/yyCP09/eTSCQA+OhHPzqpjZpKQc5gDAQRC1tpLSIiVeBVhfVHPvKR8cfVdik5yJUq6yCiylpERKrDUYf1j370I/bu3QuAMabq7lkHxdJSo8atvn9oiIhIOB11WJ944onTvlzosTC50tQt86quKYiIiJTfUU80XrFiBSeeeCIbN25k06ZNnHDCCVPRrikTjG7iEURUVYuISHV4VauCfOYzn6GlpYXm5mY+97nPTXabplRQGF1eVJW1iIhUiVcVWfPmzePNb34zAOvWrZvUBk21oDB6z1qVtYiIVImjDuuvf/3rPPvss9xwww0AbNy4cdIbNZWC/Og968g0N0RERGSCjhjW11xzDbfccgsAhUKB008/ndNPP3385xdffPHUtW4KjIU1qqxFRKRKHPGe9Y4dO8Yf//Ef/zFnnnnm+H/r1q3jzDPPnNIGTjYzfhl8mhsiIiIyQUc1wCwIDtz7+Wc/+9mkNqYc9g0wU2UtIiLV4Yhhvf/CIS9fRMQYM/ktmmJGA8xERKTKHPGe9bZt27juuus46aSTyGazFItFIpHSNeRqXAHMjA8wq762i4hIOB0xrFetWsXzzz/P2rVriUQinH766cyZM4dly5bR3d1djjZOqrGpW5bCWkREqsQRw/qMM87gjDPOGH+ez+dZv349zz//PHV1dVPauKkwdhkcDTATEZEqcdTzrGOxGCeffDInn3zyVLRnypmCpm6JiEh1eVXLjVYzDTATEZFqE9qwVmUtIiLVIoRhPXoZPDq97RAREZmoUIW1CQzGGx0NrkVRRESkSoQrrMfuV7tg26H66CIiUsVClVimYDAGAheqcD0XEREJqZCFdel+dSmsldYiIlIdwhXWRYMBAkeVtYiIVI9whXXegCnds1ZlLSIi1SJcYV0ISpW1C7ayWkREqkTIwro0GrwU1kprERGpDqEK69KOW4bAtXTPWkREqkaownr/qVu2roOLiEiVCFlYBxgDxgFHi6KIiEiVCFVimYLBYAhccBxV1iIiUh3CF9ajl8FdXQYXEZEqEbKwDjDGYFxwnFB9dBERqWKhSqz9K2tHlbWIiFSJ8IU1peVGdc9aRESqRajCOsiXLoOX7lmH6qOLiEgVC1VimeJ+l8FVWYuISJUIV1gXzOgAM0vzrEVEpGqEKrH238jDVWUtIiJVImRhbcCY0gAzjQYXEZEqEa6wzhsCA0FE86xFRKR6hCqxTHH/tcFVWYuISHUIWViPbZEJriprERGpEuFKrACMASxV1iIiUj1CFdbGNwTGYGzNsxYRkeoRrrD2DBgwtlYwExGR6hGuxPLBoMpaRESqS6jC2gSlqVvG1j1rERGpHqEKa/a/DK7R4CIiUiVClVjGp7Q2uCprERGpIm65TrR9+3Zuuukmli9fTldXF/X19Vx99dXlOn2Jv99lcN2zFhGRKlG2sO7v7+etb30rF110EQBvfetbOe+881ixYkVZzm+MwQQGAMu2sC2FtYiIVIeyhfXKlSsPeB4EAYlEolynL40EH6+qbSyFtYiIVImyhfX+7r//fs4++2yWLFly2Pc0NCRxXWfSztnUkKIj6mC5FqlklJaW9KQdeyZS/0yc+mri1FdHR/01cTO9r8oe1o8//jhPPPEE11133Su+r68vM2nnbGlJs6driHzew8dQLPr09AxN2vFnmpaWtPpngtRXE6e+Ojrqr4mbSX11uH90lHU0+EMPPcQjjzzC9ddfT09PD08//XTZzm3G1gXX4DIREakyZQvr5557jk9+8pM888wzfOADH+Cv/uqv2LJlS7lOj/FMaZCZBa6mbYmISBUp22XwFStWlLWSPohvMIzuZa0FUUREpIqEJrX2XxDF1WVwERGpIqEJawKzb+qWdtwSEZEqEprUKt2zBmNpqVEREakuoQlrbY8pIiLVKjRhbfzRytrRjlsiIlJdwpNa/r6pW7oMLiIi1SQ0YW38/RZFUViLiEgVCU9Ye6PzrG1dBhcRkeoSntQKzPg8a1XWIiJSTUIT1mZ8i0xLo8FFRKSqhCas8cx+K5iF52OLiEj1C01qmWDfPWtdBhcRkWoSmrDGQ8uNiohIVQpNapn9B5jpnrWIiFSR0IQ1o2uDo/2sRUSkyoQmrE0wuja49rMWEZEqE5rUGt91S5fBRUSkyoQmrPH3hbWrAWYiIlJFQpNaJkArmImISFUKTVgztja4pcvgIiJSXUIT1mZsi0wNMBMRkSoTntQaWxvcgojCWkREqkhoUsv4hmC0so64ofnYIiIyA4QmtYy/b1EUVdYiIlJNQpNaxjMEQWk0uCprERGpJqFJrcA3AFgRG1tTt0REpIqEJqy9fACA4yqoRUSkuoQmrH1vNKwjofnIIiIyQ4QmufzCaFhHQ/ORRURkhghNcvle6Z61LoOLiEi1CU9YF1VZi4hIdQpNco2FtaZtiYhItQlNcgXF0cvgqqxFRKTKhCa5xuZZuwprERGpMqFJrrHR4AprERGpNqFJrvHKWvOsRUSkyoQmuYLRAWYKaxERqTahSa7xyjrmTHNLREREjk54wrqoAWYiIlKdQpNcZrSyjkZVWYuISHUJTVjvq6y13KiIiFSX0IS1Gb9n7U5zS0RERI5OaMI6GN3IIxILzUcWEZEZIjTJte+edWg+soiIzBChSS7jjd2z1gAzERGpLuEJ69HKOqbKWkREqkwokssYA37psRtXZS0iItUlFGFdKPpgwLLBcULxkUVEZAYJRXLlc6Wy2nI0x1pERKpPKMK6oLAWEZEqFoqwLuZHw9pVWIuISPUp63Jejz76KKtXr6apqQnLsrj66qvLcl5dBhcRkWpWtrDOZrN87nOf49577yUajXLNNdfw2GOP8YY3vGHKz13IeYDCWkREqlPZLoOvXbuW9vZ2otEoAKeddhoPPfRQWc7tFQMAbC0LLiIiVahs8bV3715SqdT485qaGvbu3XvY9zc0JHHdyZkTbQ9abEm4NDWnaGlJT8oxZzr108SpryZOfXV01F8TN9P7qmxh3dTUxMjIyPjz4eFhmpqaDvv+vr7MpJ07HYswqyFJJO7Q0zM0acedqVpa0uqnCVJfTZz66uiovyZuJvXV4f7RUbbL4KeccgodHR0UCgUA1qxZw3nnnVeWc4+tC67R4CIiUo3KVlknEgn+4R/+gX/+53+moaGB448/viyDywAIRv/UADMREalCZR1yddZZZ3HWWWeV85TAfpV1KGaVi4jITBOK+BrbcQtdBhcRkSoUjrAeq6x1GVxERKpQOMJ6rLLW7pgiIlKFQhHWY3tZq7IWEZFqFIqwHrsMrtHgIiJSjcIR1v7YPOtpboiIiMirEIqwjrRESn/Oik5zS0RERI5eKGrN5LIkc25ZiFOvEWYiIlJ9QhHWAG5DaD6qiIjMMKG4DC4iIlLNFNYiIiIVTmEtIiJS4RTWIiIiFU5hLSIiUuEU1iIiIhVOYS0iIlLhFNYiIiIVTmEtIiJS4RTWIiIiFU5hLSIiUuEsY4yZ7kaIiIjI4amyFhERqXAKaxERkQqnsBYREalwCmsREZEKp7AWERGpcAprERGRCudOdwOm2qOPPsrq1atpamrCsiyuvvrq6W5SRXnPe95DLBYDwLZtvvOd79Df38+Xv/xl5s2bx9atW/nUpz5Fc3PzNLd0evT09HDTTTexfv16fvKTnwC8Yv/cdtttDA8PMzg4yFlnncWFF144nc0vq0P11S233MLvfve78fd89KMf5ayzzgLC3Vfbt2/npptuYvny5XR1dVFfX8/VV1+t79YhHK6vQvfdMjNYJpMxF110kcnn88YYY66++mrz6KOPTnOrKsvNN9980Guf+cxnzL333muMMeaBBx4w1157bbmbVTF+8YtfmAceeMC8853vHH/tcP2zdu1a8xd/8RfGGGMKhYK5+OKLzcDAQPkbPU0O1VeH+n4Zo7565plnzP333z/+/NJLLzXPPvusvluHcLi+Ctt3a0ZfBl+7di3t7e1Eo1EATjvtNB566KHpbVSF2bBhA6tWreKWW24Z75uHH36YU089FSj12cMPPzyNLZxeb3nLW0ilUge8drj++dWvfsUpp5wCQCQSYfHixTz55JPlbfA0OlRfAXz961/nP/7jP1i1ahXZbBZQX61cuZKLLrpo/HkQBCQSCX23DuFwfQXh+m7N6Mvge/fuPeAvj5qaGvbu3TuNLao8H/7wh1m5ciW+7/P+97+fVCp1QL/V1NQwMDCA53m47oz+ukzY4fqnt7eXxYsXj7+vpqaG3t7e6WpmRXjLW97CnDlzSCaTfPe73+Xzn/88N954o/pqP/fffz9nn302S5Ys0XfrCPbvq7B9t2Z0Zd3U1MTIyMj48+HhYZqamqaxRZVn5cqVADiOwxlnnMETTzxxQL8NDw9TV1enoN7P4fqnsbHxoO9bY2PjdDWzIixbtoxkMgnA61//eh5//HEA9dWoxx9/nCeeeILrrrsO0Hfrlby8r8L23ZrRYX3KKafQ0dFBoVAAYM2aNZx33nnT26gKsnnzZn70ox+NP9+2bRvz58/n3HPP5emnnwZKfXbuuedOVxMr0uH65/zzz2ft2rUAeJ7H5s2bee1rXztt7awEX/ziF8cfb9u2jQULFgDqK4CHHnqIRx55hOuvv56enh6efvppfbcO41B9Fbbv1ozfyOO3v/0t9913Hw0NDUQiEY0G3093dzf/9E//xPLlyxkeHsbzPP7+7/+ewcFB/vVf/5X29nZ27NjB3/zN34R2NPjvfvc77r77bn7zm9/w3ve+lz/7sz8jl8sdtn9uu+02BgcHGRgY4JxzzpkZo1An6FB99bWvfY1sNktTUxMbNmzgE5/4BIsWLQLC3VfPPfccV111FStWrAAgk8nw/ve/nwsuuEDfrZc5XF9t2bIlVN+tGR/WIiIi1W5GXwYXERGZCRTWIiIiFU5hLSIiUuEU1iIiIhVOYS0iIlLhFNYiIiIVTmEtIiJS4RTWIlXqySef5Pjjj+enP/3ppB3r1ltvHX9tzZo1vPWtbz2m4375y1/mHe94xwH/nXjiifyv//W/jrXJIqGisBapQkEQcMMNN/D617+e9evXH/Pxnn/+eVauXMnq1avHX1u3bh3Lly8/7O9ccMEFRzzu3/zN3/Czn/1s/L83vvGNLF68mE9/+tPH3GaRMFFYi1ShH/zgB8yfP5/3ve99vPDCC8d8vHXr1nH55ZeTzWbZsWMHUArw17zmNcd87DFf/vKXefDBB7n99ttnxMYKIuWkrZREqszg4CDf/OY3ufPOO/E8jxdffPGQ7/vEJz7Btm3bDvmzH/zgB8Tj8fHn69at4z3veQ8XX3wx999/P3/2Z3/GunXruOKKKyalzV/96le57777uOOOO2hpaZmUY4qEicJapMrcfPPNXHHFFcydOxdjDIVCgc7OTtra2g5630Tkcjm2bt3KiSeeSDQa5cYbb+RP/uRP2Lx580GXwT/60Y/S2dkJwO7du3nHO94BlLZYveuuuw55/K997Wvcc8893HnnncyaNetoP66IoLAWqSpj25rW19dzzz33AFAsFlm/fv1BYT3Rynr9+vXMnTuXVCrFSSedRHd3N4888ghtbW2k0+kDfu8b3/jG+OMLLriAn/3sZ6/Y3lWrVvHjH/+YO+6446D2icjEKaxFqsiNN97IZz/7Wa688srx166//npeeOEFzj///APeO9HKev9705ZlccEFF3DzzTe/4uCyifjWt77FnXfeyZ133sncuXOP6VgiYaewFqkSDzzwALt37+ad73znAa8vW7aMNWvWvOrjvvDCCwcE88UXX8ydd955TNO2tmzZwhe/+EVaW1u55pprDvjZxz/+cd785je/6mOLhJH2sxYREalwmrolIiJS4RTWIiIiFU5hLSIiUuEU1iIiIhVOYS0iIlLhFNYiIiIVTmEtIiJS4RTWIiIiFe7/Bz5KZBgjqKu8AAAAAElFTkSuQmCC\n",
"text/plain": [
"<Figure size 576x396 with 1 Axes>"
]
},
"metadata": {},
"output_type": "display_data"
}
],
"source": [
"# The mean squared error \n",
"print(\"Mean squared error: %.2f\" % mean_squared_error(Energies, fity))\n",
"# Explained variance score: 1 is perfect prediction \n",
"print('Variance score: %.2f' % r2_score(Energies, fity))\n",
"# Mean absolute error \n",
"print('Mean absolute error: %.2f' % mean_absolute_error(Energies, fity))\n",
"print(clf.coef_, clf.intercept_)\n",
"\n",
"Masses['Eapprox'] = fity\n",
"# Generate a plot comparing the experimental with the fitted values values.\n",
"fig, ax = plt.subplots()\n",
"ax.set_xlabel(r'$A = N + Z$')\n",
"ax.set_ylabel(r'$E_\\mathrm{bind}\\,/\\mathrm{MeV}$')\n",
"ax.plot(Masses['A'], Masses['Ebinding'], alpha=0.7, lw=2,\n",
" label='Ame2016')\n",
"ax.plot(Masses['A'], Masses['Eapprox'], alpha=0.7, lw=2, c='m',\n",
" label='Fit')\n",
"ax.legend()\n",
"save_fig(\"Masses2016\")\n",
"plt.show()"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### Seeing the wood for the trees\n",
"\n",
"As a teaser, let us now see how we can do this with decision trees using **scikit-learn**. Later we will switch to so-called **random forests**!"
]
},
{
"cell_type": "code",
"execution_count": 8,
"metadata": {},
"outputs": [
{
"data": {
"image/png": "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\n",
"text/plain": [
"<Figure size 576x396 with 1 Axes>"
]
},
"metadata": {},
"output_type": "display_data"
},
{
"name": "stdout",
"output_type": "stream",
"text": [
" N Z A Element Ebinding Eapprox\n",
"A \n",
"1 0 0 1 1 H 0.000000 0.000000\n",
"2 1 1 1 2 H 1.112283 1.112283\n",
"3 2 2 1 3 H 2.827265 2.827265\n",
"4 6 2 2 4 He 7.073915 7.073915\n",
"5 9 3 2 5 He 5.512132 5.512132\n",
"6 14 3 3 6 Li 5.332331 5.332331\n",
"7 19 4 3 7 Li 5.606439 5.606439\n",
"8 24 4 4 8 Be 7.062435 7.062435\n",
"9 29 5 4 9 Be 6.462668 6.462668\n",
"10 34 6 4 10 Be 6.497630 6.497630\n",
"11 40 6 5 11 B 6.927732 6.927732\n",
"12 46 6 6 12 C 7.680144 7.680144\n",
"13 52 7 6 13 C 7.469849 7.469849\n",
"14 57 8 6 14 C 7.520319 7.520319\n",
"15 64 8 7 15 N 7.699460 7.699460\n",
"16 72 8 8 16 O 7.976206 7.976206\n",
"17 78 9 8 17 O 7.750728 7.750728\n",
"18 85 10 8 18 O 7.767097 7.773058\n",
"19 93 10 9 19 F 7.779018 7.773058\n",
"20 102 10 10 20 Ne 8.032240 8.032240\n",
"21 110 11 10 21 Ne 7.971713 7.971713\n",
"22 118 12 10 22 Ne 8.080465 8.080465\n",
"23 128 12 11 23 Na 8.111493 8.111493\n",
"24 137 12 12 24 Mg 8.260709 8.260709\n",
"25 146 13 12 25 Mg 8.223502 8.223502\n",
"26 154 14 12 26 Mg 8.333870 8.333870\n",
"27 164 14 13 27 Al 8.331553 8.331553\n",
"28 174 14 14 28 Si 8.447744 8.447744\n",
"29 183 15 14 29 Si 8.448635 8.448635\n",
"30 192 16 14 30 Si 8.520654 8.520654\n",
"... ... ... ... ... ... ...\n",
"238 3089 146 92 238 U 7.570125 7.573113\n",
"239 3099 146 93 239 Np 7.560567 7.558304\n",
"240 3109 146 94 240 Pu 7.556042 7.558304\n",
"241 3118 147 94 241 Pu 7.546439 7.546439\n",
"242 3127 148 94 242 Pu 7.541327 7.541327\n",
"243 3136 149 94 243 Pu 7.531008 7.527912\n",
"244 3144 150 94 244 Pu 7.524815 7.527912\n",
"245 3154 149 96 245 Cm 7.515767 7.513619\n",
"246 3162 150 96 246 Cm 7.511471 7.513619\n",
"247 3170 151 96 247 Cm 7.501931 7.499329\n",
"248 3177 152 96 248 Cm 7.496728 7.499329\n",
"249 3186 152 97 249 Bk 7.486040 7.482998\n",
"250 3194 152 98 250 Cf 7.479956 7.482998\n",
"251 3201 153 98 251 Cf 7.470500 7.470500\n",
"252 3209 154 98 252 Cf 7.465347 7.465347\n",
"253 3216 155 98 253 Cf 7.454829 7.452027\n",
"254 3224 156 98 254 Cf 7.449225 7.452027\n",
"255 3232 156 99 255 Es 7.437821 7.434800\n",
"256 3241 156 100 256 Fm 7.431780 7.434800\n",
"257 3248 157 100 257 Fm 7.422194 7.422194\n",
"258 3256 157 101 258 Md 7.409675 7.409675\n",
"259 3264 157 102 259 No 7.399974 7.399974\n",
"260 3275 154 106 260 Sg 7.342562 7.342562\n",
"261 3280 157 104 261 Rf 7.371384 7.371384\n",
"262 3289 156 106 262 Sg 7.341185 7.341185\n",
"264 3304 156 108 264 Hs 7.298375 7.298375\n",
"265 3310 157 108 265 Hs 7.296247 7.297260\n",
"266 3317 158 108 266 Hs 7.298273 7.297260\n",
"269 3338 159 110 269 Ds 7.250154 7.250154\n",
"270 3344 160 110 270 Ds 7.253775 7.253775\n",
"\n",
"[267 rows x 6 columns]\n",
"0.009883615646716184\n"
]
}
],
"source": [
"\n",
"#Decision Tree Regression\n",
"from sklearn.tree import DecisionTreeRegressor\n",
"regr_1=DecisionTreeRegressor(max_depth=5)\n",
"regr_2=DecisionTreeRegressor(max_depth=7)\n",
"regr_3=DecisionTreeRegressor(max_depth=9)\n",
"regr_1.fit(X, Energies)\n",
"regr_2.fit(X, Energies)\n",
"regr_3.fit(X, Energies)\n",
"\n",
"\n",
"y_1 = regr_1.predict(X)\n",
"y_2 = regr_2.predict(X)\n",
"y_3=regr_3.predict(X)\n",
"Masses['Eapprox'] = y_3\n",
"# Plot the results\n",
"plt.figure()\n",
"plt.plot(A, Energies, color=\"blue\", label=\"Data\", linewidth=2)\n",
"plt.plot(A, y_1, color=\"red\", label=\"max_depth=5\", linewidth=2)\n",
"plt.plot(A, y_2, color=\"green\", label=\"max_depth=7\", linewidth=2)\n",
"plt.plot(A, y_3, color=\"m\", label=\"max_depth=9\", linewidth=2)\n",
"\n",
"plt.xlabel(\"$A$\")\n",
"plt.ylabel(\"$E$[MeV]\")\n",
"plt.title(\"Decision Tree Regression\")\n",
"plt.legend()\n",
"save_fig(\"Masses2016Trees\")\n",
"plt.show()\n",
"print(Masses)\n",
"print(np.mean( (Energies-y_1)**2))"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"### And what about using neural networks?\n",
"\n",
"The **seaborn** package allows us to visualize data in an efficient way. Note that we use **scikit-learn**'s multi-layer perceptron (or feed forward neural network) \n",
"functionality."
]
},
{
"cell_type": "code",
"execution_count": 37,
"metadata": {},
"outputs": [],
"source": [
"from sklearn.neural_network import MLPRegressor\n",
"from sklearn.metrics import accuracy_score\n",
"import seaborn as sns\n",
"\n",
"X_train = X\n",
"Y_train = Energies\n",
"n_hidden_neurons = 100\n",
"epochs = 100\n",
"# store models for later use\n",
"eta_vals = np.logspace(-5, 1, 7)\n",
"lmbd_vals = np.logspace(-5, 1, 7)\n",
"# store the models for later use\n",
"DNN_scikit = np.zeros((len(eta_vals), len(lmbd_vals)), dtype=object)\n",
"train_accuracy = np.zeros((len(eta_vals), len(lmbd_vals)))\n",
"sns.set()\n",
"for i, eta in enumerate(eta_vals):\n",
" for j, lmbd in enumerate(lmbd_vals):\n",
" dnn = MLPRegressor(hidden_layer_sizes=(n_hidden_neurons), activation='logistic',\n",
" alpha=lmbd, learning_rate_init=eta, max_iter=epochs)\n",
" dnn.fit(X_train, Y_train)\n",
" DNN_scikit[i][j] = dnn\n",
" train_accuracy[i][j] = dnn.score(X_train, Y_train)\n",
"\n",
"fig, ax = plt.subplots(figsize = (10, 10))\n",
"sns.heatmap(train_accuracy, annot=True, ax=ax, cmap=\"viridis\")\n",
"ax.set_title(\"Training Accuracy\")\n",
"ax.set_ylabel(\"$\\eta$\")\n",
"ax.set_xlabel(\"$\\lambda$\")\n",
"plt.show()"
]
},
{
"cell_type": "markdown",
"metadata": {},
"source": [
"## A first summary\n",
"\n",
"The aim behind these introductory words was to present to you various\n",
"Python libraries and their functionalities, in particular libraries like\n",
"**numpy**, **pandas**, **xarray** and **matplotlib** and other that make our life much easier\n",
"in handling various data sets and visualizing data. \n",
"\n",
"Furthermore,\n",
"**Scikit-Learn** allows us with few lines of code to implement popular\n",
"Machine Learning algorithms for supervised learning. Later we will meet **Tensorflow**, a powerful library for deep learning. \n",
"Now it is time to dive more into the details of various methods. We will start with linear regression and try to take a deeper look at what it entails."
]
}
],
"metadata": {
"kernelspec": {
"display_name": "Python 3",
"language": "python",
"name": "python3"
},
"language_info": {
"codemirror_mode": {
"name": "ipython",
"version": 3
},
"file_extension": ".py",
"mimetype": "text/x-python",
"name": "python",
"nbconvert_exporter": "python",
"pygments_lexer": "ipython3",
"version": "3.8.3"
}
},
"nbformat": 4,
"nbformat_minor": 2
}
Reference in New Issue View Git Blame Copy Permalink